deepseek-harness/docs/core-data-structures
Tianyi Cui c0808d5126 docs: the governing principle — every LLM request is reconstructable from the session log
The reconstructability RFC is the principle's home: model-visible ⟺
logged in both forms, the mechanism (boundary derivation + header
fold), the enforcement (write-time round-trip guard, the dev
invariant), the corollaries ranked (prefix-cache stability first), the
MiniCode lineage with the provenance arrow inverted, and the
alternatives it beat — including the stateful transmission client
whose three-design archaeology lives in PR #162.

Placements per the one-home-per-fact taxonomy: a standing-order line in
root AGENTS.md (with displacement trims to stay inside the 1,575-word
ceiling), the principle statement in architecture.md § Session Log and
its Turn Flow lines (condensed to the ratcheted 1,630 ceiling), the
request-envelope section in core-data-structures/core.md with the
LlmCallConfig paste, both review-requested FIXMEs
(FIXME(call-config-shape) beside the type, FIXME(catalog-verbs) at the
catalog's drift-gate note), cookbook rows redirected off agent/request
(tool filtering → system-prompt/assemble, plan-mode prompt → sections/
inject()), and the llm/stream JSDoc stating the frozen-request
contract. RFC index and all generated catalogs regenerated.
2026-07-06 03:49:35 +08:00
..
bash.md docs(bash): reframe stdin/env — the scrub is the security control, not a trust boundary 2026-07-02 04:08:24 +08:00
compaction.md compact: the summary's provenance records its call envelope 2026-07-06 03:21:29 +08:00
core.md docs: the governing principle — every LLM request is reconstructable from the session log 2026-07-06 03:49:35 +08:00
filesystem.md Split the cordis catalog into separate events and services documents 2026-07-05 00:45:06 +08:00
llm-streaming.md docs: make the service map the front door of architecture.md 2026-07-05 01:22:17 +08:00
persistence.md Add generated persistence log event catalog with freshness + completeness gates 2026-07-04 22:58:28 +08:00
session.md session: cache the derived history — one projection per node, frozen and shared 2026-07-06 02:51:20 +08:00
subagent.md Merge origin/master: adopt the DeepSeek Harness SDK product name 2026-07-05 20:54:48 +08:00
tools.md Merge branch 'worktree-hooks-b-bash-seam' into worktree-hooks-c-interception 2026-07-04 02:44:26 +08:00
web.md Merge remote-tracking branch 'origin/master' into simpl-c-web-observation 2026-07-04 20:54:42 +08:00