9b8fccc6f9
Seven ADRs capturing the why behind decisions already made: vendoring Cordis as source with a guarded manifest; the microkernel event taxonomy with one swappable concrete loop; event-sourced sessions with derived history and the append-before-emit ordering contract; the provider-neutral content-block vocabulary (and why not OpenAI/Anthropic shapes); the custom tool-schema DSL over schemastery; tool schemas living in the prompt assembly; and mechanical quality gates over prose guidelines (the agents-write-the-code rationale).
35 lines
1.5 KiB
Markdown
35 lines
1.5 KiB
Markdown
# ADR 0001: Vendor Cordis as source, not npm dependencies
|
|
|
|
Status: accepted (2026-06-11)
|
|
|
|
## Context
|
|
|
|
DeepSeek Code is built on the Cordis framework. Cordis core was at 4.0.0-rc.6
|
|
(a release candidate) when this repo started; the harness depends on framework
|
|
internals (fiber lifecycle, effect disposal, waterfall dispatch) whose exact
|
|
behavior matters to the agent loop's correctness guarantees.
|
|
|
|
## Decision
|
|
|
|
Copy the needed Cordis packages (core, loader, include, group, timer, hmr,
|
|
logger-console) and the cordiverse foundation libraries (cosmokit,
|
|
schemastery) into `vendor/` as source, flattened, keeping their original npm
|
|
names so workspace resolution is transparent. Truly third-party dependencies
|
|
(js-yaml, chokidar, @standard-schema/spec, …) stay on npm.
|
|
|
|
`vendor/README.md` is the manifest: upstream repo + commit SHA per package and
|
|
an exhaustive local-modification log. A pre-commit guard
|
|
(`scripts/check-vendor-manifest.sh`) rejects vendored-source changes that
|
|
don't update the manifest in the same commit.
|
|
|
|
## Consequences
|
|
|
|
- The harness fully owns its framework layer: auditable, patchable, pinned —
|
|
an RC upstream can't break us, and we can fix framework bugs in-tree.
|
|
- Upstream sync is manual (documented procedure in the manifest). The
|
|
modification log keeps the diff surface known.
|
|
- Vendored packages keep upstream code style; lint/strictness gates exclude
|
|
them (their tsconfigs relax our newer compiler flags locally).
|
|
- One local patch exists from day one: hmr's locale-YAML imports removed (the
|
|
runtime YAML import hook isn't vendored).
|