Merge commit 'a1934a1498ec91688b6245d5b05b1cdf66d5c98a' into gsta-96-preamble-hoist

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>

scripts/host-config.ts

@@ -140,6 +140,17 @@ export interface HostConfig {
   learningsMode?: 'full' | 'basic';
   /** Anti-prompt-injection boundary instruction for cross-model invocations. */
   boundaryInstruction?: string;
+
+  // --- Session transcripts ---
+  /**
+   * Where this host keeps its own chat transcripts on disk, read by
+   * /context-restore's no-checkpoint fallback (sections/transcripts.md).
+   * `root` is the path pattern shown to the user; `layout` says how the
+   * current workspace's files are told apart from another project's. Absent:
+   * the host declares no transcript store, and the skill says so and falls
+   * back to the shared record and git.
+   */
+  transcripts?: { root: string; layout: string };
 }
 
 // --- Validation ---

scripts/resolvers/index.ts

@@ -56,6 +56,7 @@ import { generateCoordinatorContract } from './coordinator-contract';
 import { generateAutoplanDriverCodes, generateAutoplanDriverCommands, generateAutoplanDriverFiles, generateAutoplanDriverGate, generateAutoplanDriverPhases, generateAutoplanDriverResultFormat } from './autoplan-driver';
 import { generateQAScope, generateQAExploratory, generateQAFunctional, generateQAResource, generateQAReview, generateQAReviewPreflight, generateQAMethodReads } from './qa';
 import { generateVoiceTriggerRouting } from './voice-triggers';
+import { generateTranscriptDiscovery, generateTranscriptSources } from './transcripts';
 
 export const RESOLVERS: Record<string, ResolverFn> = {
   AUTOPLAN_PUBLICATION_HOOK: generateAutoplanPublicationHook,
@@ -192,4 +193,6 @@ export const RESOLVERS: Record<string, ResolverFn> = {
   AUTOPLAN_DRIVER_CODES: generateAutoplanDriverCodes,
   SECTION,
   SECTION_INDEX,
+  TRANSCRIPT_SOURCES: generateTranscriptSources,
+  TRANSCRIPT_DISCOVERY: generateTranscriptDiscovery,
 };

scripts/resolvers/transcripts.ts

@@ -0,0 +1,93 @@
+/**
+ * Transcript resolvers for /context-restore's no-checkpoint fallback
+ * (context-restore/sections/transcripts.md.tmpl).
+ *
+ *   {{TRANSCRIPT_SOURCES}}   → the table of transcript stores for THIS host
+ *                              (its `transcripts` row from hosts/<name>.ts, or
+ *                              a none row) plus the Capy row (none; the harness
+ *                              keeps no transcript on the machine). Only the
+ *                              rendering host's paths appear: a Codex render
+ *                              never names ~/.claude/.
+ *   {{TRANSCRIPT_DISCOVERY}} → the bash block that lists THIS host's transcript
+ *                              files for the current workspace only, inside the
+ *                              window, and prints `TRANSCRIPTS: none (...)` on
+ *                              Capy, on a host with no declared store, or when
+ *                              the store is missing.
+ *
+ * hosts/*.ts declares which hosts have a store (`transcripts.root` and
+ * `layout` feed the table); the per-host discovery body lives here, keyed by
+ * host name, and a host with no declaration gets the none branch. The prose
+ * never hand-writes a path. test/context-restore-transcripts.test.ts checks
+ * that the table and the block agree for every host and runs the block
+ * against fixture transcripts.
+ */
+import { getHostConfig } from '../../hosts/index';
+import type { TemplateContext } from './types';
+
+export const CAPY_NO_TRANSCRIPTS = 'TRANSCRIPTS: none (Capy keeps no session transcript on this machine; use the shared record and git)';
+
+export function generateTranscriptSources(ctx: TemplateContext): string {
+  const host = getHostConfig(ctx.host);
+  const row = host.transcripts
+    ? `| ${host.displayName} | \`${host.transcripts.root}\` | ${host.transcripts.layout} |`
+    : `| ${host.displayName} | none | this host declares no transcript store gstack may read; use the shared record and git |`;
+  return [
+    '| Host | Transcripts | How this workspace\'s files are told apart |',
+    '|---|---|---|',
+    row,
+    '| Capy (any model) | none | the harness keeps no transcript on the machine; say so and use the shared record and git |',
+  ].join('\n');
+}
+
+export function generateTranscriptDiscovery(ctx: TemplateContext): string {
+  const host = getHostConfig(ctx.host);
+  const slugBin = `${ctx.paths.binDir}/gstack-slug`;
+  const head = [
+    'TRANSCRIPT_DAYS="${TRANSCRIPT_DAYS:-7}"',
+    `PROJECT_ROOT=$(${slugBin} --get PROJECT_ROOT 2>/dev/null) || PROJECT_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)`,
+    'echo "TRANSCRIPT_WINDOW: last $TRANSCRIPT_DAYS days"',
+    'echo "TRANSCRIPT_PROJECT: $PROJECT_ROOT"',
+    'if [ -n "${GSTACK_CAPY:-}" ]; then',
+    `  echo "${CAPY_NO_TRANSCRIPTS}"`,
+  ];
+  let body: string[];
+  if (!host.transcripts) {
+    body = [
+      'else',
+      `  echo "TRANSCRIPTS: none (${host.displayName} declares no transcript store gstack may read; use the shared record and git)"`,
+      'fi',
+    ];
+  } else if (ctx.host === 'claude') {
+    body = [
+      'else',
+      '  TRANSCRIPT_DIR="$HOME/.claude/projects/$(printf \'%s\' "$PROJECT_ROOT" | sed \'s/[^A-Za-z0-9]/-/g\')"',
+      '  if [ -d "$TRANSCRIPT_DIR" ]; then',
+      '    TRANSCRIPT_COUNT=0',
+      '    while IFS= read -r f; do TRANSCRIPT_COUNT=$((TRANSCRIPT_COUNT + 1)); echo "TRANSCRIPT: $f"; done < <(find "$TRANSCRIPT_DIR" -maxdepth 1 -name \'*.jsonl\' -mtime -"$TRANSCRIPT_DAYS" 2>/dev/null | sort)',
+      '    echo "TRANSCRIPTS: $TRANSCRIPT_DIR ($TRANSCRIPT_COUNT files in the last $TRANSCRIPT_DAYS days)"',
+      '  else',
+      '    echo "TRANSCRIPTS: none ($TRANSCRIPT_DIR is missing; this workspace has no Claude Code transcripts)"',
+      '  fi',
+      'fi',
+    ];
+  } else if (ctx.host === 'codex') {
+    body = [
+      'else',
+      '  TRANSCRIPT_DIR="$HOME/.codex/sessions"',
+      '  if [ -d "$TRANSCRIPT_DIR" ]; then',
+      '    TRANSCRIPT_COUNT=0',
+      '    while IFS= read -r f; do',
+      '      head -c 4096 "$f" 2>/dev/null | grep -qF -- "\\"cwd\\":\\"$PROJECT_ROOT\\"" || continue',
+      '      TRANSCRIPT_COUNT=$((TRANSCRIPT_COUNT + 1)); echo "TRANSCRIPT: $f"',
+      '    done < <(find "$TRANSCRIPT_DIR" -type f -name \'rollout-*.jsonl\' -mtime -"$TRANSCRIPT_DAYS" 2>/dev/null | sort)',
+      '    echo "TRANSCRIPTS: $TRANSCRIPT_DIR ($TRANSCRIPT_COUNT files whose cwd is this workspace, in the last $TRANSCRIPT_DAYS days)"',
+      '  else',
+      '    echo "TRANSCRIPTS: none ($TRANSCRIPT_DIR is missing; this machine has no Codex transcripts)"',
+      '  fi',
+      'fi',
+    ];
+  } else {
+    throw new Error(`hosts/${ctx.host}.ts declares a transcript store but scripts/resolvers/transcripts.ts has no discovery body for it`);
+  }
+  return ['```bash', ...head, ...body, '```'].join('\n');
+}