kevchess15/deepseek-harness
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
2nd dokployH
1385 commits 1 branch 9 tags 143 MiB
Find a file
Tianyi Cui ecb8aa5b8e Add a gated Known Limitations and Deferred Work section to every package README 
Every packages/*/* README now carries a canonical '## Known Limitations and
Deferred Work' section: condensed, evidence-backed bullets for consumer-visible
gaps (unimplemented features, platform caveats, MVP cuts) and consciously
postponed work (TODO/FIXME/XXX markers, RFC deferrals still open). The ten
pre-existing ad-hoc variants ('What is NOT here (TODO)', 'Deferred',
'Limitations (MVP)', 'Known limitations (tracked TODOs)', ...) are normalized
into the canonical heading.

A new doc-sync gate, scripts/verify-readme-limitations.ts, enforces the shape:
exactly one limitations-like heading per package README, byte-equal to the
canonical h2, with at least one bullet; near-miss headings fail so variants
cannot creep back. Packages with genuinely nothing to declare (dsh-brand,
dsh-timeout, dsh-subagent-mock, dsh-app-boot) are whitelisted in the script and
must NOT carry the section; whitelist entries are validated against the scanned
package set so a rename fails loud.

Wired into the doc-sync chain (package.json) and the run-gates doc-sync leaf
set; the standing rule lands in packages/AGENTS.md and the adding-a-package
cookbook; decision record in
docs/rfc/implemented/process/2026-07-10-readme-known-limitations-gate.md
(RFC index regenerated).

Also fixes two stale '(deferred)' markers claiming dsh-compact-basic is
unimplemented (the dsh-compact seam README's package table and the seam's
module doc comment).
2026-07-12 01:46:34 +08:00
.agents/skills make wordcount budget guidance clearer and dedup docs 2026-07-10 00:20:35 +08:00
.claude docs: accuracy sweep, architecture restructure, two ADRs, review skill 2026-06-13 22:05:34 +08:00
.github/workflows feat(example): sandbox-acp-agent — the live composition; RFCs to implemented 2026-07-10 15:44:38 +08:00
docs Add a gated Known Limitations and Deferred Work section to every package README 2026-07-12 01:46:34 +08:00
examples test(e2e): tolerate bounded loader contention 2026-07-12 00:50:50 +08:00
packages Add a gated Known Limitations and Deferred Work section to every package README 2026-07-12 01:46:34 +08:00
scripts Add a gated Known Limitations and Deferred Work section to every package README 2026-07-12 01:46:34 +08:00
vendor Use explicit ts specifiers for declarations 2026-06-22 06:11:00 +08:00
.gitignore feat(approval): the approval seam — one-shot permission decisions over a waterfall of answerers 2026-07-10 15:43:02 +08:00
AGENTS.md Merge remote-tracking branch 'origin/master' into codex/skill-system 2026-07-11 22:31:28 +08:00
CLAUDE.md Initialize repo with README, AGENTS.md, and CLAUDE.md symlink 2026-06-10 22:58:56 +08:00
CONTEXT.md docs: agent-scope RFC, CONTEXT.md glossary, architecture scope section, README sync 2026-07-09 03:01:11 +08:00
eslint.config.mjs chore(lint): one shared project service; ignore harness-local .claude state 2026-07-10 22:13:40 +08:00
knip.json Merge remote-tracking branch 'origin/master' into feat/sandbox-support 2026-07-11 21:43:10 +08:00
lefthook.yml Merge parallel pre-push gates into CI scheduler 2026-07-06 01:47:13 +08:00
LICENSE Initialize repo with README, AGENTS.md, and CLAUDE.md symlink 2026-06-10 22:58:56 +08:00
package.json Add a gated Known Limitations and Deferred Work section to every package README 2026-07-12 01:46:34 +08:00
pnpm-lock.yaml fix(scope): harden merged tool and skill boundaries 2026-07-11 23:41:37 +08:00
pnpm-workspace.yaml feat(sandbox): the confinement seam and the per-platform native runner chains 2026-07-10 15:43:02 +08:00
README.i18n.yaml docs: revise graph docs from review 2026-07-05 01:25:58 +08:00
README.md docs: revise graph docs from review 2026-07-05 01:25:58 +08:00
README.zh.md docs: revise graph docs from review 2026-07-05 01:25:58 +08:00
tsconfig.base.json Merge remote-tracking branch 'origin/master' into codex/skill-system 2026-07-11 22:31:28 +08:00
tsconfig.build.json Merge remote-tracking branch 'origin/master' into codex/pr224-rfc-rewrite 2026-07-11 23:14:09 +08:00
tsconfig.json Merge remote-tracking branch 'origin/master' into codex/pr224-rfc-rewrite 2026-07-11 23:14:09 +08:00
tsdown.config.ts feat(sandbox): the confinement seam and the per-platform native runner chains 2026-07-10 15:43:02 +08:00
vitest.config.ts feat: add the worker-thread code runtime (dsh-code-runtime-worker) 2026-07-08 11:07:14 +08:00
vitest.e2e.config.ts Merge parallel pre-push gates into CI scheduler 2026-07-06 01:47:13 +08:00
vitest.snapshot.config.ts Add keyless snapshot refresh mode 2026-07-10 00:48:27 +08:00

README.md

DeepSeek Harness

English | 中文

The DeepSeek Harness SDK is a plugin-based SDK for building agent harnesses.

Development

This monorepo is built on the Cordis framework (vendored as source under vendor/), microkernel-style: everything is a plugin.

pnpm install
pnpm run test          # vitest
pnpm run demo:repl     # REPL agent demo (needs DEEPSEEK_API_KEY)
pnpm run demo:acp      # ACP server agent demo (needs DEEPSEEK_API_KEY)

For humans, start with the development guide for local setup, hooks, environment variables, and quality gates, then read the architecture design and documentation graph index before package work. Local context lives in packages/ and vendor/.

For agents, follow AGENTS.md.