0 Fork 0

Files

T

james.maesandClaude Opus 4.7 508cf924d0 docs(packages): per-package README files

Adds README.md to each of the 13 SPM packages (AgentCore, Bus, Config,
DevOverlay, Harness, Keychain, Logging, MCP, Memory, Replay, Shell, Vision,
Voice). Each covers purpose, key public types, deps, consumers, invariants
(pulled from CLAUDE.md + grep-gates + audit findings), test stack, and
notable files. Memory README explicitly marks the package functionally OFF
until vec0.dylib + Ollama models land.

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

2026-05-04 17:13:33 -05:00

1.8 KiB

Raw Permalink Blame History

Replay

Per-turn NDJSON log under ~/Library/Application Support/Jarvis/replay/. Every turn writes a full transcript of LLM events, tool calls (pre- and post-sanitize bytes both, per SEC-07), memory mutations, and stop reason. The replayer is a developer tool, not user-facing.

Key public types

Type	Purpose
`ReplayLog` (actor)	The single writer; rotated per session
`ReplayEvent`	NDJSON event union — `turnStart`, `userInput`, `tokenDelta`, `toolCallRequested`, `toolResult`, `memoryRetrieval`, `memoryFactAdded`, `memoryFactUpdated`, `memoryFactForgotten`, `turnEnd`
`ReplaySession`	Session-level rollup (multiple turns)
`ReplayPaths`	Path resolver

Depends on

AgentCore, Config, Logging. External: swift-log.

Used by

App/AppDelegate, packages/AgentCore (AgentOrchestrator is the primary writer), packages/Memory (writes mutation + retrieval events), App/MCP/ReplayingToolResultObserver.swift (writes pre/post sanitize bytes).

Key invariants / contracts

ReplayLog is the single writer per session file. Multi-writer is undefined.
turnNonce is persisted in replay rows but never on the bus (SEC-06).
Pre- and post-sanitize bytes both go to replay (SEC-07). The model only sees post-sanitize.
replayLog.beginSession is called before any turn. Pre-audit BLOCKER fixed (audit-2026-05-04).
NDJSON format. Each line is one event, JSON-encoded. Newline-delimited; no leading/trailing whitespace within events.

Tests

XCTest. Round-trip serialization tests, session rollover, file-handle leak detection (packages/Harness/FDLeakDetector SEC-08).

Notable files

Sources/Replay/ReplayLog.swift — the writer actor
Sources/Replay/ReplayEvent.swift — event union
Sources/Replay/ReplaySession.swift — session rollup

1.8 KiB Raw Permalink Blame History