cDi; SrSSKrSSKJrJr SSKJr SSKJr SSKrSSK r \ R"5S:Xa \"S5r O\"S5r \ S - S - r \ S - S - r \ S - S - r\ S- S- S- r\ S- S- S- rS3S\S\\S\\S\S\4 SjjrS4S\S\S\4SjjrS\4SjrSr\S:XaSSKr\"\R85S:a\"S 5 \R<"S!5 \R8S!r\S":Xa-\"S#5 \"S$S%S&//S'QS(S)9r \"\RB"\ SS*95 g\S+:Xa'\"S,5 \"S-S.S/9r \"\RB"\ SS*95 g\S0:Xa\"S15 \"5r"\"\"5 g\"S2\35 \R<"S!5 gg)5a Gemini CLI CTM (Commit To Memory) + State Flush Tool ===================================================== Provides explicit memory persistence for Gemini CLI sessions. Since Gemini CLI has no hook system, these functions can be called as MCP tools. Functions: - ctm_flush: Save session state to handoff files - respawn_signal: Signal that a respawn is needed - read_boot_context: Load context for new session startup Author: Genesis Parallel Builder Created: 2026-02-23 N)datetimetimezone)Path)OptionalWindowszE:/genesis-systemz/mnt/e/genesis-systemhiveprogressz.gemini knowledgesession_recoverydata observabilityz events.jsonl context_statezBOOT_CONTEXT.mdsession_summary key_decisions pending_tasks session_idreturnc 8[R"[R5nUR S5nU=(d SU3n[ R SSS9 [R SSS9 SUSUR5SUS3nU(aUH nUS US 3- nM OUS - nUS - nU(a [US 5HupXySU S 3- nM OUS- nUSUR5S[U5S[U5S3- n[ SUS3- n [U SSS9n U RU5 SSS5 [S- n [U SSS9n U RU5 SSS5 [RR SSS9 UR5SU[U5[U5[U5S.n[[SSS9n U R[R "U5S -5 SSS5 S[%U 5[%U 5[U5[U5UR5S.$!,(df  GN =f!,(df  N=f!,(df  Nl=f!["a N{f=f!["anS [%U5S!S".sSnA$SnAff=f)#aY Commit current session state to memory (handoff files). This is Gemini CLI's equivalent of Claude's pre_compact_ctm.py hook. Call this before context gets too large or when ending a session. Args: session_summary: Brief summary of work done this session key_decisions: List of important decisions made (strategic pivots, locked choices) pending_tasks: List of incomplete tasks for next session session_id: Optional session identifier (defaults to timestamp) Returns: dict with status, handoff file path, and task count Example: result = ctm_flush( session_summary="Built Telnyx KB, started voice widget polish", key_decisions=["Use Gemini Flash for voice AI", "Lock pricing at $197/mo"], pending_tasks=["Finish widget UI", "Test George's number", "Deploy to prod"], session_id="gemini-001" ) z %Y%m%d_%H%M%Sgemini_Tparentsexist_okz,# Gemini CLI Session Handoff ## Session ID: z ## Timestamp: z --- ## Session Summary z --- ## Key Decisions Made z-  z$*(No major decisions this session)* z --- ## Pending Tasks z. [ ] z*(No pending tasks)* u| --- ## Recovery Instructions This is a Gemini CLI session handoff. Next Gemini session should: 1. Read this file to understand context 2. Read BOOT_CONTEXT.md for current mission state 3. Continue with highest-priority pending task 4. DO NOT ask user "what should I work on?" — pick up where this left off ## Handoff Metadata - **Session Type**: Gemini CLI - **Flushed At**: z - **Tasks Pending**: z - **Decisions Made**: z( --- *Auto-generated by gemini_ctm.py* gemini_session_z _handoff.mdwutf-8encodingNlatest_handoff.mdgemini_ctm_flush) timestamp event_typer task_countdecision_countsummary_lengthaflushed)status handoff_pathlatest_handoff_path tasks_saveddecisions_savedr"errorr)r)r.r,)rnowrutcstrftime HANDOFF_DIRmkdirGEMINI_KNOWLEDGE isoformat enumeratelenopenwrite EVENTS_FILEparentjsondumps Exceptionstr)rrrrr/r"sidhandoff_contentdecisionitaskr*fr+eventes 8E:\genesis-system\mcp-servers\genesis-core\gemini_ctm.py ctm_flushrI0s:g ll8<<(LL1 1gi[1 $6td;u}}    )Rz#44* F FO  $]A6StfB#777 7 7O ==?#$-()*=)*+ *#yk%MM ,g 6! GGO $7/1DD %sW = GGO $>     $ $TD $ A ]]_0!!-0"%m"4"%o"6 Ek39Q 5)D01:  -#&':#;}-"=1   37 6 > =:9     V   sDI6H20I6 II6'AI&)I/I&7:I62 I<I6 II6 I#I&"I6#I&& I30I62I33I66 JJJJreason context_pctc&[R"[R5n[R SSS9 [S- nSUR 5SUSUS3n[USS S 9nURU5 S S S 5 [S - nUR5(af[US S S 9nUR5nS S S 5 SUR 5SUSUS3n[USS S 9nURUW-5 S S S 5 [RR SSS9 UR 5SUUS.n [[SS S 9nUR[R"U 5S-5 S S S 5 SUU[#U5UR 5S.$!,(df  GN&=f!,(df  N=f!,(df  N=f!,(df  Na=f![ a Npf=f![ an S[#U 5S.sS n A $S n A ff=f)a Signal that a Gemini CLI respawn is needed. This creates a recovery file indicating the session needs to restart. Use this when context is getting too large or when encountering unrecoverable errors. Args: reason: Why respawn is needed (e.g., "context overflow", "API error loop") context_pct: Estimated context usage percentage (0-100) Returns: dict with status and reason Example: respawn_signal("Context at 85%, time to hand off", context_pct=85) TrGEMINI_RESPAWN.mdz-# GEMINI CLI RESPAWN NEEDED **Signaled At**: z **Reason**: z **Context Usage**: a% --- ## What happened The current Gemini CLI session has signaled that it needs to respawn. This is typically due to: - Context window filling up (>80%) - Repeated API errors - Session instability - Manual CTM flush before planned restart ## Recovery Steps 1. Read the latest handoff: `.gemini/knowledge/latest_handoff.md` 2. Read BOOT_CONTEXT.md for mission context 3. Continue with pending tasks from handoff 4. Delete this file after recovery --- *Auto-generated by gemini_ctm.py respawn_signal()* rrrNr ru)# ⚠️ RESPAWN NEEDED ⚠️ **Time**: z **Context**: zZ% full The previous Gemini session requested a respawn. Continue from tasks below. --- gemini_respawn_signal)r"r#rJrKr'rrespawn_signaled)r)rJrK recovery_filer"r.)r)r.)rr/rr0 RECOVERY_DIRr3r5r8r9r4existsreadr:r;r<r=r>r?) rJrKr/ respawn_filerespawn_contentrEr+existing_contentbannerrFrGs rHrespawn_signalrYs$R ll8<<( 4$7$&99 --/"# H=!2,g 6! GGO $7/1DD  % % ' ')3AQ#$668 B ==?  H] F)3AQ!112B     $ $TD $ A ]]_5 * E k39Q 5)D01: )& .   K7 6 BABA:9     V   sA&G.(F:1G.+F+<-G.)F<>G.AG )G 2G:G. F(#G.+ F95G.< G G. GGG.G G+(G.*G++G.. H8 H H Hc/n[R5(a][[SSS9nUR5nSSS5 UR S5 UR W5 UR S5 OUR S5 [ S - nUR5(aY[USSS9nUR5nSSS5 UR S 5 UR W5 UR S5 OUR S 5 [S - nUR5(aX[USSS9nUR5nSSS5 UR S5 UR W5 UR S5 UR S5 UR S5 SRU5$!,(df  GN=f![ a UR S5 GNaf=f!,(df  GN1=f![ a UR S 5 GN f=f!,(df  N=f![ a Nf=f![ anS[U5S3sSnA$SnAff=f)ub Read combined boot context for a new Gemini session. This loads: 1. BOOT_CONTEXT.md — current mission, stack status, priority tasks 2. latest_handoff.md — previous session's final state Returns: Combined string with full boot context Example: context = read_boot_context() # Use this as context when starting a new Gemini CLI session rNrrNz# === GENESIS BOOT CONTEXT === z u&# BOOT_CONTEXT.md — could not read u!# BOOT_CONTEXT.md — not found r z## === PREVIOUS SESSION HANDOFF === u(# latest_handoff.md — could not read u3# latest_handoff.md — no previous session found rMz"# === RESPAWN SIGNAL DETECTED === z# === BOOT INSTRUCTIONS === u. You are a Gemini CLI session starting up in Genesis. IMMEDIATE ACTIONS: 1. Review BOOT_CONTEXT above for current mission and priorities 2. Review PREVIOUS SESSION HANDOFF for continuity 3. Pick up where the last session left off (do NOT ask user what to do) 4. If RESPAWN SIGNAL present, acknowledge and continue from pending tasks REMEMBER: - All work happens on E: drive (never C: drive) - Use ctm_flush() before context fills up - Signal respawn when context > 80% - Genesis is proactive — show findings as they arrive, never wait Ready to execute. z# ERROR reading boot context z: Falling back to minimal context. Check filesystem paths.) BOOT_CONTEXT_FILErSr8rTappendr>r4rRjoinr?)outputrE boot_contentr+rArUrVrGs rHread_boot_contextrasBw  # # % % J+S7Cq#$668LD @A l+ f% MM? @/1DD  % % ' ' L-sWE&'ffhOF DE o. f% MMQ R$&99     ,g>!&'ffhO? CD o. f%  56  $wwvqDC  J HI JFE  L JK L?>   2 w1#a&9uvvwsIGF<;G90I* H5G0;H0I2 H5=H$;H5 2I< G GG-)I,G--I0 G?:HH!I H!!I$ H2.H55 I?III I(I#I(#I(c &UR5S S[S[[S[[S[S[4 Sjj5nUR5S S[S[S[4S jj5nUR5S[4S j5ng )z Register Gemini CTM tools with an MCP server instance. Usage in server.py: from gemini_ctm import register_gemini_tools register_gemini_tools(mcp) Args: mcp_server: FastMCP server instance rrrrrcD[XX#5n[R"USS9$)aiCommit Gemini CLI session state to memory (handoff files). Call this before context fills up or when ending a session. Args: session_summary: Brief summary of work done key_decisions: List of important decisions made pending_tasks: List of incomplete tasks session_id: Optional session identifier Returns: JSON with status and file paths indent)rIr<r=)rrrrresults rHr!/register_gemini_tools..gemini_ctm_flushs!(?=Uzz&++rJrKcB[X5n[R"USS9$)zSignal that Gemini CLI needs to respawn. Use when context is too large or encountering errors. Args: reason: Why respawn is needed context_pct: Estimated context usage (0-100) Returns: JSON with status and recovery file path rdre)rYr<r=)rJrKrgs rHrO4register_gemini_tools..gemini_respawn_signals 4zz&++ric[5$)zvRead combined boot context for new Gemini session. Returns: Combined BOOT_CONTEXT.md + latest_handoff.md content )rarirHgemini_read_boot_context7register_gemini_tools..gemini_read_boot_contexts !""riNr[r)toolr?listint) mcp_serverr!rOrns rHregister_gemini_toolsrvvs__  ,,Cy,Cy, , ,,,__ ,c , ,C , ,__#c##ri__main__rdzCUsage: python gemini_ctm.py [test_flush | test_respawn | test_boot]r test_flushzTesting CTM flush...zTest session for CTM validationzTest decision 1zTest decision 2)z Test task 1z Test task 2z Test task 3test_session_001)rrrrre test_respawnzTesting respawn signal...zManual test of respawn signalK)rK test_bootzTesting boot context read...zUnknown command: rprq)#__doc__r<rrpathlibrtypingrosplatformsystem GENESIS_ROOTr2r4rRr:r\r?rsdictrIrtrYrarv__name__sysr7argvprintexitcommandrgr=contextrmrirHrs  '  ?? !+,L/0LV#j0 )+k9f$'99 V#o5F  6)O;>OO D D 9D 9D  D  D Nd 3d Sd d NQw3Qwp:#B z 388}q ST  hhqkG, $%=,.?@G)   djj*+ N " )* ?RP djj*+ K  ,-#% g !'+,  ?ri