Hypatia May b955c7d18d Merge remote-tracking branch 'origin/master' into session-surface 2 months ago
..
invariants 828c3f85c9 fix review findings: skip collided SCHEMA_VERSION 3; reject marker-less surface events 2 months ago
llm-replay b3d40d427e Persist the seed boundary so fork-child replay routes correctly 2 months ago
subagent-mock 8d111161de Merge remote-tracking branch 'origin/master' into worktree-subagent-seam-pr1 2 months ago
ui-stdio 01dea07922 Merge origin/master into codex/fix-stdio-readline-terminal 2 months ago
README.md 5024cd5757 Document the package hierarchy and finalize the RFC 2 months ago

README.md

support/ — dev/test/example infrastructure

Packages that exist to serve development, testing, and the examples rather than to ship as product API. They are real workspace packages (typed, tested, under the coverage gate), but they carry lower compatibility expectations: they may change or be removed when the development need behind them does, without the deprecation care a product package would warrant.

Package Role ctx key
invariants/ Dev-mode event-contract invariants + session-log freeze (listens on session/*, agent/*)
ui-stdio/ Minimal stdio (readline) UI plugin: renders agent/* events, feeds stdin lines to the agent (drives ctx.agents)
llm-replay/ Record/replay adapter: short-circuits llm/stream from a recorded session JSONL (keyless snapshot tests) (listens on llm/stream)

invariants runs only in dev mode (contract checks, not runtime behavior). ui-stdio and llm-replay were extracted from the examples for reuse and to bring them under the per-file coverage gate; they back the demos and the snapshot test tier. A package graduates OUT of support/ into a product group only when it gains documented product consumers.