mirror of https://github.com/deepseek-ai/deepseek-harness synced 2026-08-15 21:04:50 +00:00

Files

lintianle 2cde2a9032 Merge origin/master into feat/website-docs

Conflict resolution notes:
- package.json/run-gates: both sides' new doc-sync gates kept (master's
  scoped-events/readme gates + this branch's website-api/website-yaml);
  js-yaml devDeps deduped (master added them independently).
- pnpm-workspace/knip: website AND python/sdk-runtime entries kept.
- doc-typecheck/verify-type-equiv: master's condensed headers kept, website
  glob retained in both scan scopes.
- vendor/cordis/src/fiber.ts: master's lifecycle-hardening code taken; this
  branch's richer FiberState JSDoc reapplied on top. vendor/README.md logs
  both local modifications (hardening = 6, JSDoc enrichment = 7).
- pnpm-lock: regenerated from master's side (pnpm install).

Post-merge sync the gates forced (the system working as designed):
- verify-website-yaml caught 4 stale plugin names from master's package
  reorg (dsh-stdio-agent -> dsh-stdio-demo, dsh-acp-agent -> dsh-acp-demo);
  8 references fixed across guide/ and develop/.
- gen-website-api picked up master's 6 new services automatically
  (ctx.approval/permission/sandbox/sessionQuery/skills/tasks -> 6 new pages
  + sidebar); api/index.md hub updated to list them.
- AGENTS.md budget ceiling 1370 -> 1400: the website rows (layout line + two
  command lines) and master's own growth collided with the old ceiling; all
  three website rows are load-bearing (new top-level dir, new CI command).

2026-07-16 21:36:43 +08:00

cordis

Merge origin/master into feat/website-docs

2026-07-16 21:36:43 +08:00

cosmokit

Use explicit ts specifiers for declarations

2026-06-22 06:11:00 +08:00

group

pkg: update vendor dep

2026-07-15 11:28:45 +08:00

hmr

pkg: update vendor dep

2026-07-15 11:28:45 +08:00

include

pkg: update vendor dep

2026-07-15 11:28:45 +08:00

loader

vendor: update cordis / loader

2026-07-15 10:39:18 +08:00

logger-console

pkg: update vendor dep

2026-07-15 11:28:45 +08:00

schemastery

refactor: rename build typings dir to types

2026-06-20 00:26:02 +08:00

timer

pkg: update vendor dep

2026-07-15 11:28:45 +08:00

AGENTS.md

docs: unwrap hard-wrapped Markdown to one line per paragraph

2026-06-13 20:27:04 +08:00

CLAUDE.md

Document the codebase thoroughly and tighten type safety

2026-06-11 13:01:00 +08:00

README.md

Merge origin/master into feat/website-docs

2026-07-16 21:36:43 +08:00

README.md

Vendored Packages

This directory contains source-vendored copies of the Cordis framework and its foundation libraries. They are copied into this monorepo instead of being depended on via npm, so that the harness fully owns its framework layer (auditable, patchable, pinned).

All vendored packages keep their original npm names (they are resolved through pnpm workspaces) and are marked private: true — they are never published from this repo. Upstream MIT LICENSE files are preserved in each package directory.

This file covers the manifest, the local-modification log, and the procedure for updating an existing vendored package. To add a new one, see the cookbook guide: docs/cookbook/adding-a-vendored-package.md.

Manifest

Upstream workspace: cordis-workspace (local checkout: ~/repos/cordis-workspace).

Directory	npm name	Version	Upstream repo	Commit
`cosmokit/`	`cosmokit`	1.8.1	https://github.com/deepseek-harness/cosmokit	`16f6fc058ade66e8ac5da0033d35a8d0f279f544`
`schemastery/`	`schemastery`	3.18.0	https://github.com/deepseek-harness/schemastery (`packages/core`)	`e67cee00ad725bd1534aee930a979ea3eec6f698`
`cordis/`	`cordis`	4.0.0-rc.7	https://github.com/cordiverse/cordis (`packages/core`)	`56b3d4f725681cf4556c1a8695a709cc3b6eed74`
`loader/`	`@cordisjs/plugin-loader`	1.0.0-rc.5	https://github.com/cordiverse/cordis (`packages/loader`)	`56b3d4f725681cf4556c1a8695a709cc3b6eed74`
`include/`	`@cordisjs/plugin-include`	1.0.4	https://github.com/deepseek-harness/cordis (`packages/include`)	`abb0a307cb1d3b0947f455d590cf5ba922d4caa4`
`group/`	`@cordisjs/plugin-group`	1.0.0	https://github.com/deepseek-harness/cordis (`packages/group`)	`abb0a307cb1d3b0947f455d590cf5ba922d4caa4`
`timer/`	`@cordisjs/plugin-timer`	1.1.2	https://github.com/deepseek-harness/cordis (`packages/timer`)	`abb0a307cb1d3b0947f455d590cf5ba922d4caa4`
`hmr/`	`@cordisjs/plugin-hmr`	1.0.15	https://github.com/deepseek-harness/cordis (`packages/hmr`)	`abb0a307cb1d3b0947f455d590cf5ba922d4caa4`
`logger-console/`	`@cordisjs/plugin-logger-console`	1.0.0	https://github.com/deepseek-harness/cordis (`packages/logger-console`)	`abb0a307cb1d3b0947f455d590cf5ba922d4caa4`

Third-party dependencies of the vendored packages stay on npm: @standard-schema/spec, js-yaml, chokidar, picomatch, @babel/code-frame, supports-color, node-addon-require-builtin.

Intentionally not vendored (verified unused by this set): reggol, @cordisjs/utils, @cordisjs/element, @cordisjs/unyaml (dev-time YAML import hook only).

Local modifications

Keep this log exhaustive — every divergence from upstream must be listed.

hmr/src/index.ts: removed the ./locales/en-US.yml / ./locales/zh-CN.yml imports, the .i18n({...}) call on the Config schema, and the src/locales/ directory. Rationale: those imports require a runtime YAML loader hook (@cordisjs/unyaml) that we do not vendor; the i18n texts only localize config descriptions.
All package.json files: regenerated — added private: true, added precise files entries for bundled runtime files and lib/types/**/*.d.ts / .d.ts.map, preserved src in files only for packages whose previous file list already shipped it, added a ./src/* export where missing, pointed declaration metadata at lib/types, and removed upstream devDependencies/scripts/repository fields. Dependency and peer-dependency ranges preserved, except hmr declares esbuild as a direct dev dependency because its source imports the BuildFailure type and pnpm's strict workspace resolution requires the owner package to name that dependency.
All tsconfig.json files: regenerated to extend the repo-root tsconfig.base.json, emit TypeScript intermediates to lib/types, and declare project references.
Vendored TypeScript source internal specifiers: changed local relative imports/exports from upstream's specifier shape to explicit .ts specifiers so TypeScript rewrites emitted JS to .js while declarations keep explicit, NodeNext-safe .ts specifiers. This includes loader/src/config/isolate.ts using declare module './entry.ts'.
schemastery/tsdown.config.ts and logger-console/tsdown.config.ts: ours, not upstream files — per-package build-shape overrides (dual ESM+CJS output; separate node/browser entries) for the repo-root tsdown build. They read the JS emitted under lib/types and then write the publish runtime entries under lib/. Like the regenerated tsconfigs, they are not part of the upstream sync surface.
cordis/src/fiber.ts lifecycle hardening: locally closes three reentrant disposal gaps. An effect's owner-list wrapper is registered before its setup body runs, so an unload begun from inside setup awaits setup and every collected cleanup; synchronous setup failure removes the wrapper and rolls back collected cleanup. Async cleanup stays owner-visible until quiescence, and Cordis's internal effect composition joins an already-running cleanup while repeated public disposer calls retain their upstream single-shot result. Effect creation is rejected while the owner is UNLOADING (while PENDING and LOADING remain legal), preventing cleanup-time registrations from escaping the unload snapshot. Child fibers register and receive their parent-owned disposer before internal/plugin publication, resolve dependency declarations added by that notification before activation, drain effects attached while pending, skip plugin execution when reentrant disposal invalidates the load epoch before its first checkpoint, and contain teardown-notification failures per observer so one callback cannot starve peers or interrupt ownership cleanup.
cordis/src/*.ts JSDoc enrichment: added @param/@returns tags and contract documentation (disposal semantics, waterfall veto, bail conditions, error cases) across the public plugin-author surface — Context (class, statics, and the Context interface properties incl. root), EventsService, Fiber, RegistryService, ReflectService, Service, LoggerService and their declare module './context.ts' overloads. Comment-only; no code changes. Motivation: the website API-reference generator renders these docs and hard-errors on undocumented members. Retire this entry when the enrichment is upstreamed to the fork.

Sync procedure

To update a vendored package from upstream:

In the upstream workspace, note git rev-parse HEAD of the relevant submodule.
Copy the package's src/ (and bin.js, README.md, LICENSE if changed) over the vendored directory.
Re-apply the local modifications listed above (or drop them if upstream made them unnecessary — update the log either way).
Update the version and commit hash in the manifest table.
Run pnpm install && pnpm run test && pnpm run build at the repo root.