title: Session and transcript CLI management

scenario:
  id: session-transcript-cli-management
  surface: runtime
  category: session-memory.cli-session-and-transcript-management
  coverage:
    primary:
      - session-memory.cli-session
      - session-memory.transcript-management
  objective: Prove the real child CLI reads canonical SQLite session state, delegates applied cleanup through a live Gateway, and materializes transcript artifacts from shared SQLite state.
  successCriteria:
    - The JSON sessions command observes a canonically persisted session.
    - Applied missing-transcript cleanup delegates through the live Gateway and removes the targeted session.
    - Transcript list and show commands read a stored transcript session as structured JSON.
    - Transcript path materializes the JSONL artifact and its persisted utterance.
  docsRefs:
    - docs/cli/sessions.md
    - docs/cli/transcripts.md
  codeRefs:
    - src/commands/sessions.ts
    - src/commands/sessions-cleanup.ts
    - src/gateway/server-methods/sessions-read.ts
    - src/cli/program/register.transcripts.ts
    - src/transcripts/store.ts
    - test/e2e/qa-lab/runtime/session-transcript-cli-product-proof.e2e.test.ts
  execution:
    kind: vitest
    path: test/e2e/qa-lab/runtime/session-transcript-cli-product-proof.e2e.test.ts
    summary: Run the real child CLI against isolated canonical SQLite state and a live Gateway cleanup boundary.