kevchess15/deepseek-harness
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
deepseek-harness/docs/rfc
History
Tianyi Cui de73afbe39 docs: resolve self-consistency follow-ups on RFCs 009-010 
- 009: the crash-tail "overwrite" contradicted the append-only contract.
  Name it explicitly as a one-time truncation-repair (ftruncate+fsync to
  the last complete turn/end byte offset) that removes only the
  never-committed crash tail; committed events are never rewritten.
  Qualify the append/impl/ADR wording to match.
- 010: remove the remaining concrete-loop references — the session/new
  and session/load table rows now point at the dsh-agent create/resume
  factory, and the Risks disposal line uses the interface-level settle
  signal (agent/status) instead of LoopAgent-only agent.done.
2026-06-14 21:57:59 +08:00
..
001-property-based-testing.md test: property-based tests for protocol-shaped code (RFC 001) 2026-06-14 00:06:25 +08:00
002-mutation-testing.md docs: unwrap hard-wrapped Markdown to one line per paragraph 2026-06-13 20:27:04 +08:00
003-deterministic-and-stress-testing.md docs: unwrap hard-wrapped Markdown to one line per paragraph 2026-06-13 20:27:04 +08:00
004-architectural-conformance.md docs: unwrap hard-wrapped Markdown to one line per paragraph 2026-06-13 20:27:04 +08:00
005-runtime-validation-and-error-taxonomy.md feat(llm): structured error taxonomy with a shared HarnessError base (RFC 005 pt 2) 2026-06-14 01:07:28 +08:00
006-doc-sync-and-api-reports.md build: doc-sync gates — typecheck doc code blocks + verify event taxonomy (RFC 006 pts 1-2) 2026-06-14 00:47:38 +08:00
007-supply-chain-and-vendor-drift.md docs: unwrap hard-wrapped Markdown to one line per paragraph 2026-06-13 20:27:04 +08:00
008-immutable-public-surfaces.md fix(invariants): address Codex review of dev invariants (PR 2) 2026-06-13 23:50:43 +08:00
009-session-persistence-and-resumability.md docs: resolve self-consistency follow-ups on RFCs 009-010 2026-06-14 21:57:59 +08:00
010-acp-agent-client-protocol.md docs: resolve self-consistency follow-ups on RFCs 009-010 2026-06-14 21:57:59 +08:00
011-acp-multi-session.md docs: address review on RFCs 009-011 2026-06-14 21:43:16 +08:00
README.md docs: add RFCs 009-011 (session persistence + ACP support) 2026-06-14 21:14:51 +08:00

README.md

RFCs

Proposals for substantial future work — reviewed before implementation, unlike ADRs (which record decisions already made). Each RFC groups a related set of ideas from the quality/robustness proposal (2026-06-11); statuses move proposed → accepted → implemented (then usually graduate to an ADR).

# Title Status
001 Property-based testing for protocol-shaped code implemented
002 Mutation testing as the coverage counterweight proposed
003 Deterministic tests + replay invariant fixture + race stress proposed
004 Architectural rules: dependency-cruiser, adapter conformance kit proposed
005 Runtime arg validation, structured error taxonomy, dev-mode invariants implemented
006 Doc-sync enforcement and API extractor reports implemented (pts 1-2; pt 3 deferred)
007 Supply chain checks and vendor drift verification proposed
008 Deep-readonly public surfaces implemented (revised)
009 Durable session persistence — abstract, append-only, event-based store proposed
010 Agent Client Protocol (ACP) support for external editors proposed
011 Multiplex concurrent ACP sessions over one connection proposed