deepseek-harness/docs
imccyu 194828e8b8 build(vendor): add the @deepseek-ai rescope codemod, its mapping doc, and its Agent Note
Every harness package declares cordis as a peer dependency, so publishing the
harness publishes the vendored framework layer too; under the upstream names
that publication would squat them on the registry.

scripts/rescope-vendor.ts owns the rename: the nine-package mapping, a
delimited-token rule that leaves cordis.yml, the Loader's cordis: builtins and
vendor directory names alone, per-file exemptions where a name is a directory
or an upstream runtime identifier, and the exact edits for sites a token rule
cannot express — dot-notation lookups, unquoted manifest keys, a regex literal
whose failure would make every Context-merge scan silently find nothing, the
vendored-manifest table, and the contracts that told readers vendored packages
keep their upstream names.

Markdown follows the rename inside every fence, because a fence is code a
reader copies or configuration they mount, and in `docs/` prose as well, where
a sentence quoting a name teaches something this repository no longer resolves.
Prose elsewhere records what was true when it was written, and the same
spelling can mean something else: the Python SDK's `cordis` option, or the
unvendored `@cordisjs/plugin-http`. `docs/rescope.md` states both names on
purpose and is exempt.

exactEditState() classifies every exact edit as pending, applied, or invalid.
An insertion keeps its anchor and a deletion keeps its remainder, so each side
counts the form that survives: a duplicated insertion, a half-applied
replacement, and a deletion whose remainder moved are all invalid. The run
classifies every edit before writing anything and aborts on the first invalid
one, so a disagreement between the mapping and the tree cannot leave a
half-rescoped checkout; each write re-reads its file, because two edits can
target one. rescope-vendor.spec.ts pins those rejections, and --check asserts
the whole post-state from the hygiene gate, so CI owns the invariant.

--reverse restores the upstream names, verified as a round trip: reverse, then
apply, reproduces this tree byte for byte.

docs/rescope.md is the consumer-facing reference: the old-name/new-name table
with each package's role, what the rename deliberately leaves alone, the sites
callers must change, and the commands to apply, verify, and revert. The Agent
Note carries the decision and its consequences.

The rename itself lands in the next commit, produced by running the script.
2026-08-10 22:04:10 +08:00
..
cookbook docs: rename client manifest field references 2026-08-10 21:11:09 +08:00
cordis-api docs: fix review findings — residual ordinals, hypothetical IPC row, citation-rule amendments 2026-08-09 21:10:59 +08:00
cordis-tutorial docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
i18n docs: make routine translation lightweight 2026-08-10 17:58:09 +08:00
postmortem docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
subsystems refactor: nest client manifest metadata under dsh 2026-08-10 21:11:09 +08:00
user docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
agent-lifecycle.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
agent-lifecycle.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
agent-lifecycle.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
AGENTS.md fix(skill): enforce manual invocation policy 2026-08-10 18:04:26 +08:00
api-gateway.i18n.yaml docs: rename client manifest field references 2026-08-10 21:11:09 +08:00
api-gateway.md docs: rename client manifest field references 2026-08-10 21:11:09 +08:00
api-gateway.zh.md docs: rename client manifest field references 2026-08-10 21:11:09 +08:00
architecture.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
architecture.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
architecture.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
capability-seams.i18n.yaml refactor: nest client manifest metadata under dsh 2026-08-10 21:11:09 +08:00
capability-seams.md docs: rename client manifest field references 2026-08-10 21:11:09 +08:00
capability-seams.zh.md refactor: nest client manifest metadata under dsh 2026-08-10 21:11:09 +08:00
config-catalog.i18n.yaml docs: sync repository removal translations 2026-08-10 21:32:13 +08:00
config-catalog.md docs: refresh MCP config catalog 2026-08-10 21:32:13 +08:00
config-catalog.zh.md docs: sync repository removal translations 2026-08-10 21:32:13 +08:00
cordis-paper.pdf docs: add cordis paper 2026-07-31 15:54:36 +08:00
cordis-primer.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
cordis-primer.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
cordis-primer.zh.md docs(i18n): standardize contract terminology 2026-08-09 11:33:14 +08:00
defensive-patterns.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
defensive-patterns.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
defensive-patterns.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
development.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
development.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
development.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
event-producer-consumer.i18n.yaml Merge remote-tracking branch 'origin/master' into worktree/web-theme-settings-integration-fde706 2026-08-10 17:05:18 +08:00
event-producer-consumer.md Merge remote-tracking branch 'origin/master' into worktree/web-theme-settings-integration-fde706 2026-08-10 17:05:18 +08:00
event-producer-consumer.zh.md Merge remote-tracking branch 'origin/master' into worktree/web-theme-settings-integration-fde706 2026-08-10 17:05:18 +08:00
glossary.i18n.yaml docs: reserve seam for complete capabilities 2026-08-09 17:26:57 +08:00
glossary.md docs: reserve seam for complete capabilities 2026-08-09 17:26:57 +08:00
glossary.zh.md docs: reserve seam for complete capabilities 2026-08-09 17:26:57 +08:00
graph-atlas.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
graph-atlas.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
graph-atlas.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
module-graph.i18n.yaml docs: sync repository removal translations 2026-08-10 21:32:13 +08:00
module-graph.md refactor: remove repository plugin path 2026-08-10 21:32:13 +08:00
module-graph.zh.md docs: sync repository removal translations 2026-08-10 21:32:13 +08:00
persistence-catalog.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
persistence-catalog.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
persistence-catalog.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
rescope.i18n.yaml build(vendor): add the @deepseek-ai rescope codemod, its mapping doc, and its Agent Note 2026-08-10 22:04:10 +08:00
rescope.md build(vendor): add the @deepseek-ai rescope codemod, its mapping doc, and its Agent Note 2026-08-10 22:04:10 +08:00
rescope.zh.md build(vendor): add the @deepseek-ai rescope codemod, its mapping doc, and its Agent Note 2026-08-10 22:04:10 +08:00
testing.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
testing.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
testing.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
tool-catalog.i18n.yaml docs: sync repository removal translations 2026-08-10 21:32:13 +08:00
tool-catalog.md refactor: remove repository plugin path 2026-08-10 21:32:13 +08:00
tool-catalog.zh.md docs: sync repository removal translations 2026-08-10 21:32:13 +08:00
tool-execution-pipeline.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
tool-execution-pipeline.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
tool-execution-pipeline.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
web-styling.i18n.yaml docs: make technical prose concrete 2026-08-10 16:34:20 +08:00
web-styling.md docs: rescan rebased documentation hierarchy 2026-08-05 16:16:57 +08:00
web-styling.zh.md docs: make technical prose concrete 2026-08-10 16:34:20 +08:00