Slash commands: PEEK-backed command receipts and continuity

[Hmbown]

Scope

Use the continuity layer to make slash-command results durable, source-linked, and assimilable across session resume, handoff, agents, server/editor surfaces, and compaction.

Command families in scope:

• Continuity and recall: /relay, /context, /memory, /anchor, /recall, /cache, /sessions
• Evidence-bearing state: /status, /tokens, /cost, /system, /diff, /change
• Agent handoff: /agent, /subagents, /rlm, /review receipts that other agents can re-derive

PEEK framing

Treat command receipts as orientation-cache entries. The Distiller extracts transferable facts, the Cartographer places them in session/workspace/global maps, and the Evictor drops stale or low-rederivability entries before useful source links.

Acceptance

• Command receipts have source, scope, freshness, and detail-handle metadata.
• Resume/handoff surfaces can reconstruct important command state without replaying raw scrollback.
• Cache entries prefer re-derivable, source-linked facts over hindsight summaries.
• Compaction preserves command receipts needed for future agents to understand the current work.

Related: #1881, #1120, #1818, #1842, #722.

[Hmbown]

Implementation notes for the next agent:

Primary files to inspect:

• crates/tui/src/compaction.rs, cycle_manager.rs, seam_manager.rs, handoff.rs, memory.rs, rlm.rs, tools/subagent/, and session persistence code.
• docs/SUBAGENTS.md, docs/TOOL_SURFACE.md, and any v0.8.47 design docs created by the milestone agent.

Suggested PEEK-oriented receipt model:

struct OrientationEntry {
    id: String,
    source: SourceRef,
    scope: OrientationScope,
    claim: String,
    evidence: Vec<SourceRef>,
    freshness: Freshness,
    rederivability_score: f32,
    detail_handle: Option<String>,
}

enum OrientationScope { Turn, Session, Workspace, Repo, Global }

trait Distiller {
    fn distill(receipt: &CommandReceipt) -> Vec<OrientationEntry>;
}

trait Cartographer {
    fn place(entry: &OrientationEntry) -> OrientationScope;
}

trait Evictor {
    fn evict(entries: &mut Vec<OrientationEntry>, budget: OrientationBudget);
}

fn assimilate_command_receipt(receipt: CommandReceipt) {
    let entries = CommandDistiller::distill(&receipt);
    for entry in entries {
        let scope = CommandCartographer::place(&entry);
        orientation_cache.write(scope, entry);
    }
    CommandEvictor::evict(&mut orientation_cache, current_budget());
}

Pedagogical filter:

• Prefer entries a future agent can re-derive from local evidence.
• Down-rank claims that only make sense with hindsight or without source links.
• Preserve detail handles before prose summaries when budget is tight.

Acceptance hints:

• Resume/handoff should reconstruct command state without replaying raw scrollback.
• Compaction must keep receipts needed to understand current work, permissions, agent state, and budget pressure.
• Subagent and RLM outputs should enter the cache as source-linked receipts, not opaque success summaries.

[Hmbown]

Related maintenance finding: #2022 now tracks classifying environment/tool failures before blaming the model. The PEEK receipt model should preserve failure source metadata such as network, sandbox/approval, missing dependency, timeout, background wait, and non-zero exit so handoff/resume can explain what actually happened without replaying private raw logs.

[Hmbown]

Related concrete slice: #2023 tracks the RLM/log-workbench path for large local logs and structured payloads. The receipt model here should be able to store "large source analyzed by child/RLM, summary returned, details behind handle" as a first-class orientation entry instead of replaying raw logs into the parent context.