Align publish flows with KA lifecycle

[Jurij89]

Summary

• Align app-facing write/publish flows with the named Knowledge Asset lifecycle by adding POST /api/knowledge-assets/:name/vm/publish-async as the async VM publish entrypoint.
• Remove product-facing loose SWM write/enqueue surfaces and migrate source-worker, clients, adapters, benchmarks, node-ui, docs, and devnet scripts to lifecycle routes.
• Harden async publisher intent/recovery semantics so named KA jobs bind to current full-share state, reject stale/unsealed intent, and avoid protected stranded recovery states.
• Keep SWM receive/gossip/ACK/catchup substrate internals intact while moving batch-rejection reporting to lifecycle-shaped KA persistence.

Related

• Refs Consolidate daemon-level loose SWM writes onto the named-KA lifecycle (post agent-tooling cleanup) #1260.
• Targets PR Consolidate the agent publish/share surface onto the canonical KA lifecycle (#1087) #1265 branch: feat/api-agent-tooling-cleanup.

Files changed

File	What
packages/cli/src/daemon/routes/knowledge-assets.ts	Adds named KA vm/publish-async and lifecycle-shaped batch rejection route.
packages/cli/src/daemon/routes/memory.ts	Removes app-facing loose SWM write/conditional-write/report-batch-rejection behavior from the old URL surface.
packages/cli/src/daemon/routes/publisher.ts	Removes raw public enqueue behavior while preserving job management/control-plane reads.
packages/agent/src/dkg-agent-publish.ts / packages/agent/src/dkg-agent.ts	Resolves current finalized full-share publish intent and exposes stable share operation metadata.
packages/publisher/src/*	Adds named KA job typing, intent/idempotency checks, lifecycle executor handling, and recovery hardening.
packages/cli/src/api-client.ts, source-worker runners, OpenClaw adapter, node-ui, network sim, benchmarks	Migrates product callers to named KA lifecycle APIs.
scripts/*.sh and devnet helpers	Migrates executable devnet flows off deleted legacy routes and preserves full-batch verification semantics.
packages/*/test/*	Adds/updates route deletion, async publish, metadata, source-worker, adapter, node-ui, and devnet-helper regression coverage.
README.md, ARCHITECTURE.md, docs/**, agent-docs/**	Updates product docs and includes the reviewed plan, decisions, implementation log, and lessons.

Test plan

• pnpm --filter @origintrail-official/dkg-publisher run build
• pnpm --filter @origintrail-official/dkg-agent run build
• pnpm --filter @origintrail-official/dkg run build
• pnpm --filter @origintrail-official/dkg-node-ui run build
• pnpm --filter @origintrail-official/dkg-publisher test -- test/async-lift-publisher.test.ts test/metadata.test.ts --reporter verbose
• pnpm --filter @origintrail-official/dkg test -- test/api-client.test.ts test/source-worker-daemon-client.test.ts test/source-worker-runner.test.ts --reporter verbose
• pnpm --filter @origintrail-official/dkg test -- test/daemon-http-behavior-extra.test.ts --reporter verbose
• pnpm --filter @origintrail-official/dkg test -- test/daemon-http-behavior-extra.test.ts test/issue-306-787-write-quad-validation.test.ts test/assertion-cli-smoke.test.ts test/memory-graph-events.test.ts --reporter verbose
• pnpm --filter @origintrail-official/dkg-agent test -- test/e2e-memory-layers.test.ts -t 'skipSeal share stays unsealed' --reporter verbose
• pnpm --filter @origintrail-official/dkg-node-ui test -- test/chat-memory.test.ts test/chat-memory-persistence-regression.test.ts --reporter verbose
• bash -n scripts/*.sh
• node --check scripts/testnet-publish-stress/publish-loop.mjs; node --check scripts/dkg-v10-implementation-time-accounting.mjs; node --check scripts/dkg-v10-decisions.mjs; node --check scripts/dkg-v10-decision-time-accounting.mjs
• git diff --check
• Post-rebase: pnpm --filter @origintrail-official/dkg run build
• Post-rebase: pnpm --filter @origintrail-official/dkg-publisher test -- test/async-lift-publisher.test.ts test/metadata.test.ts --reporter verbose
• Post-rebase: pnpm --filter @origintrail-official/dkg test -- test/api-client.test.ts test/daemon-http-behavior-extra.test.ts --reporter verbose
• Post-rebase: targeted legacy-surface scan for active /api/shared-memory/* write/publish and raw /api/publisher/enqueue callers.

[otReviewAgent]

Operational Notice: Review Agent could not complete this review.

Verification reviewer failed: 2026-06-21T21:19:13.063828Z ERROR rmcp::transport::worker: worker quit with fatal: Transport channel closed, when UnexpectedServerResponse("HTTP 401: {\n "error": {\n "message": "Your authentication token has been invalidated. Please try signing in again.",\n "type": "invalid_request_error",\n "code": "token_invalidated",\n "param": null\n },\n "status": 401\n}")

Details omitted because the failure output was 1469 characters. Check the local Review Agent logs for the reviewer event and output files.

[otReviewAgent]

Operational Notice: Review Agent could not complete this review.

Business logic reviewer failed: 2026-06-21T21:19:37.183386Z ERROR rmcp::transport::worker: worker quit with fatal: Transport channel closed, when UnexpectedServerResponse("HTTP 401: {\n "error": {\n "message": "Your authentication token has been invalidated. Please try signing in again.",\n "type": "invalid_request_error",\n "code": "token_invalidated",\n "param": null\n },\n "status": 401\n}")

Details omitted because the failure output was 1471 characters. Check the local Review Agent logs for the reviewer event and output files.

[otReviewAgent]

Operational Notice: Review Agent could not complete this review.

Verification reviewer failed: retry_exhausted

[otReviewAgent]

Operational Notice: Review Agent could not complete this review.

Business logic reviewer failed: retry_exhausted

[otReviewAgent]

Operational Notice: Review Agent could not complete this review.

Business logic reviewer failed: retry_exhausted

[otReviewAgent]

Operational Notice: Review Agent could not complete this review.

Business logic reviewer failed: retry_exhausted