feat(session-gists): add Gemini support and context-doc reference

- Add ~/.gemini to session backup directories for Gemini CLI sessions
- Extract SessionGistCommand types to dedicated session-gist-domain.ts module
- Add context-doc reference link for extracting session dialogs
- Update restore instructions to include .gemini files

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: konard

.githooks/pre-push

@@ -11,7 +11,7 @@ fi
 
 node scripts/pre-push-knowledge-guard.js "$@"
 
-# CHANGE: backup AI session to private gist on push
+# CHANGE: backup AI session to private gist on push (supports Claude, Codex, Gemini)
 # WHY: allows returning to old AI sessions and provides PR context
 # QUOTE(ТЗ): "когда происходит push мы сразу заливаем текущую сессию с AI агентом в gits приватный"
 # REF: issue-143

packages/lib/src/core/domain.ts

@@ -1,3 +1,5 @@
+import type { SessionGistCommand } from "./session-gist-domain.js"
+
 export type { MenuAction, ParseError } from "./menu.js"
 export { parseMenuSelection } from "./menu.js"
 export { deriveRepoPathParts, deriveRepoSlug, resolveRepoInput } from "./repo.js"
@@ -271,44 +273,13 @@ export interface AuthGeminiLogoutCommand {
   readonly geminiAuthPath: string
 }
 
-// CHANGE: add session gist backup commands for PR-based session history
-// WHY: enables returning to old AI sessions via private gists linked to PRs
-// QUOTE(ТЗ): "иметь возможность возвращаться ко всем старым сессиям с агентами"
-// REF: issue-143
-// PURITY: CORE
-// EFFECT: n/a
-// INVARIANT: gist commands are always tied to a repository context
-// COMPLEXITY: O(1)
-export interface SessionGistBackupCommand {
-  readonly _tag: "SessionGistBackup"
-  readonly projectDir: string
-  readonly prNumber: number | null
-  readonly repo: string | null
-  readonly postComment: boolean
-}
-
-export interface SessionGistListCommand {
-  readonly _tag: "SessionGistList"
-  readonly limit: number
-  readonly repo: string | null
-}
-
-export interface SessionGistViewCommand {
-  readonly _tag: "SessionGistView"
-  readonly gistId: string
-}
-
-export interface SessionGistDownloadCommand {
-  readonly _tag: "SessionGistDownload"
-  readonly gistId: string
-  readonly outputDir: string
-}
-
-export type SessionGistCommand =
-  | SessionGistBackupCommand
-  | SessionGistListCommand
-  | SessionGistViewCommand
-  | SessionGistDownloadCommand
+export type {
+  SessionGistBackupCommand,
+  SessionGistCommand,
+  SessionGistDownloadCommand,
+  SessionGistListCommand,
+  SessionGistViewCommand
+} from "./session-gist-domain.js"
 export type SessionsCommand =
   | SessionsListCommand
   | SessionsKillCommand

packages/lib/src/core/session-gist-domain.ts

@@ -0,0 +1,36 @@
+// CHANGE: session gist backup commands for PR-based session history
+// WHY: enables returning to old AI sessions via private gists linked to PRs
+// QUOTE(ТЗ): "иметь возможность возвращаться ко всем старым сессиям с агентами"
+// REF: issue-143
+// PURITY: CORE
+
+export interface SessionGistBackupCommand {
+  readonly _tag: "SessionGistBackup"
+  readonly projectDir: string
+  readonly prNumber: number | null
+  readonly repo: string | null
+  readonly postComment: boolean
+}
+
+export interface SessionGistListCommand {
+  readonly _tag: "SessionGistList"
+  readonly limit: number
+  readonly repo: string | null
+}
+
+export interface SessionGistViewCommand {
+  readonly _tag: "SessionGistView"
+  readonly gistId: string
+}
+
+export interface SessionGistDownloadCommand {
+  readonly _tag: "SessionGistDownload"
+  readonly gistId: string
+  readonly outputDir: string
+}
+
+export type SessionGistCommand =
+  | SessionGistBackupCommand
+  | SessionGistListCommand
+  | SessionGistViewCommand
+  | SessionGistDownloadCommand

scripts/session-backup-gist.js

@@ -3,14 +3,14 @@
 /**
  * Session Backup to GitHub Gist
  *
- * This script backs up AI agent session files (~/.codex, ~/.claude) to a private GitHub Gist
+ * This script backs up AI agent session files (~/.codex, ~/.claude, ~/.gemini) to a private GitHub Gist
  * and optionally posts a comment to the associated PR with the gist link.
  *
  * Usage:
  *   node scripts/session-backup-gist.js [options]
  *
  * Options:
- *   --session-dir <path>    Path to session directory (default: auto-detect ~/.codex or ~/.claude)
+ *   --session-dir <path>    Path to session directory (default: auto-detect ~/.codex, ~/.claude, or ~/.gemini)
  *   --pr-number <number>    PR number to post comment to (optional, auto-detected from branch)
  *   --repo <owner/repo>     Repository (optional, auto-detected from git remote)
  *   --no-comment            Skip posting PR comment
@@ -31,7 +31,7 @@ const os = require("node:os");
 
 // Configuration
 const MAX_GIST_FILE_SIZE = 10 * 1024 * 1024; // 10MB per file limit for gists
-const SESSION_DIR_NAMES = [".codex", ".claude"];
+const SESSION_DIR_NAMES = [".codex", ".claude", ".gemini"];
 const KNOWLEDGE_DIR_NAME = ".knowledge";
 
 /**
@@ -337,8 +337,13 @@ codex resume <session-id>
 
 # For Claude
 claude --resume <session-id>
+
+# For Gemini
+gemini --resume <session-id>
 \`\`\`
 
+For extracting session dialogs, see: https://github.com/ProverCoderAI/context-doc
+
 ---
 *Backup created at: ${timestamp}*`;
 

scripts/session-list-gists.js

@@ -251,7 +251,9 @@ const downloadGist = (gistId, outputDir, verbose) => {
   console.log("\nTo restore session files, copy them to the appropriate location:");
   console.log("  - .codex/* files -> ~/.codex/");
   console.log("  - .claude/* files -> ~/.claude/");
+  console.log("  - .gemini/* files -> ~/.gemini/");
   console.log("  - .knowledge/* files -> ./.knowledge/");
+  console.log("\nFor extracting session dialogs, see: https://github.com/ProverCoderAI/context-doc");
 };
 
 /**