Merge origin/master into codex/provider-retry-policy

scripts/cordis-config-files.spec.ts

@@ -0,0 +1,36 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join } from 'node:path'
+import { afterEach, describe, expect, it } from 'vitest'
+import { cordisConfigFiles } from './cordis-config-files.ts'
+
+const roots: string[] = []
+
+afterEach(() => {
+  for (const root of roots.splice(0)) rmSync(root, { recursive: true, force: true })
+})
+
+describe('cordisConfigFiles', () => {
+  it('finds Loader YAML without treating translation records as configs', () => {
+    const root = mkdtempSync(join(tmpdir(), 'dsh-cordis-config-files-'))
+    roots.push(root)
+    for (const directory of ['.claude', 'docs', 'examples', 'node_modules/pkg', 'vendor/pkg']) {
+      mkdirSync(join(root, directory), { recursive: true })
+    }
+    for (const file of [
+      '.claude/hidden.cordis.yml',
+      'docs/cordis-primer.i18n.yaml',
+      'examples/agent.cordis.yaml',
+      'examples/headless.cordis.yml',
+      'node_modules/pkg/hidden.cordis.yml',
+      'vendor/pkg/hidden.cordis.yml',
+    ]) {
+      writeFileSync(join(root, file), '[]\n')
+    }
+
+    expect(cordisConfigFiles(root)).toEqual([
+      join('examples', 'agent.cordis.yaml'),
+      join('examples', 'headless.cordis.yml'),
+    ])
+  })
+})

scripts/cordis-config-files.ts

@@ -0,0 +1,18 @@
+/** Cordis Loader configuration file discovery. */
+
+import { globSync } from 'node:fs'
+
+/**
+ * Return repository-relative Cordis Loader YAML paths under `root`.
+ *
+ * Translation consistency records are YAML sidecars, never Loader inputs.
+ *
+ * @param root Repository root to scan.
+ * @returns Sorted repository-relative Loader configuration paths.
+ */
+export function cordisConfigFiles(root: string): string[] {
+  return globSync(['**/*cordis*.yml', '**/*cordis*.yaml'], {
+    cwd: root,
+    exclude: ['.claude/**', 'node_modules/**', 'vendor/**', '**/*.i18n.yaml'],
+  }).sort()
+}

scripts/gen-cordis-api.ts

@@ -30,8 +30,45 @@ function quote(value: string): string {
 }
 
 /**
- * Collect exported interface and type shapes; omit names declared in multiple
- * packages rather than risk serving the wrong package's shape.
+ * Reduce an exported class to its type shape: drop method/constructor bodies
+ * and property initializers so the catalog serves member signatures, not
+ * implementation.
+ */
+function classShape(node: ts.ClassDeclaration): ts.ClassDeclaration {
+  const isNonPublic = (member: ts.ClassElement): boolean =>
+    (ts.canHaveModifiers(member) ? ts.getModifiers(member) : undefined)?.some(m =>
+      m.kind === ts.SyntaxKind.PrivateKeyword || m.kind === ts.SyntaxKind.ProtectedKeyword) ?? false
+  const members = node.members.flatMap((member): ts.ClassElement[] => {
+    if (isNonPublic(member) || (ts.isPropertyDeclaration(member) && ts.isPrivateIdentifier(member.name))) return []
+    if (ts.isMethodDeclaration(member)) {
+      return [ts.factory.updateMethodDeclaration(
+        member, member.modifiers, member.asteriskToken, member.name, member.questionToken,
+        member.typeParameters, member.parameters, member.type, undefined)]
+    }
+    if (ts.isConstructorDeclaration(member)) {
+      return [ts.factory.updateConstructorDeclaration(member, member.modifiers, member.parameters, undefined)]
+    }
+    if (ts.isGetAccessorDeclaration(member)) {
+      return [ts.factory.updateGetAccessorDeclaration(
+        member, member.modifiers, member.name, member.parameters, member.type, undefined)]
+    }
+    if (ts.isSetAccessorDeclaration(member)) {
+      return [ts.factory.updateSetAccessorDeclaration(
+        member, member.modifiers, member.name, member.parameters, undefined)]
+    }
+    if (ts.isPropertyDeclaration(member)) {
+      return [ts.factory.updatePropertyDeclaration(
+        member, member.modifiers, member.name, member.questionToken ?? member.exclamationToken, member.type, undefined)]
+    }
+    return [member]
+  })
+  return ts.factory.updateClassDeclaration(
+    node, node.modifiers, node.name, node.typeParameters, node.heritageClauses, members)
+}
+
+/**
+ * Collect exported interface, type-alias, and body-stripped class shapes; omit
+ * names declared in multiple packages rather than serve the wrong shape.
  */
 function collectTypeDecls(scanRoot: string = root): Map<string, string> {
   const printer = ts.createPrinter({ removeComments: true })
@@ -41,14 +78,16 @@ function collectTypeDecls(scanRoot: string = root): Map<string, string> {
     const abs = resolve(scanRoot, rel)
     const sf = ts.createSourceFile(abs, readFileSync(abs, 'utf8'), ts.ScriptTarget.Latest, true)
     for (const stmt of sf.statements) {
-      if (!ts.isInterfaceDeclaration(stmt) && !ts.isTypeAliasDeclaration(stmt)) continue
+      const named = ts.isInterfaceDeclaration(stmt) || ts.isTypeAliasDeclaration(stmt) || ts.isClassDeclaration(stmt)
+      if (!named || stmt.name === undefined) continue
       if (!(stmt.modifiers?.some(m => m.kind === ts.SyntaxKind.ExportKeyword) ?? false)) continue
       const name = stmt.name.text
       if (decls.has(name)) {
         ambiguous.add(name)
         continue
       }
-      const printed = printer.printNode(ts.EmitHint.Unspecified, stmt, sf).replace(/\r/g, '')
+      const emit = ts.isClassDeclaration(stmt) ? classShape(stmt) : stmt
+      const printed = printer.printNode(ts.EmitHint.Unspecified, emit, sf).replace(/\r/g, '')
       decls.set(name, printed.length > MAX_DECL_CHARS
         ? `${printed.slice(0, MAX_DECL_CHARS)} /* …truncated — full shape in source */`
         : printed)

scripts/gen-cordis-catalog.ts

@@ -35,6 +35,8 @@ export const LINK_MAP: Record<string, string> = {
   ContinuationDecision: 'core.md',
   ContinuationStop: 'core.md',
   GenerateOptions: 'core.md',
+  AgentMessage: 'core.md',
+  AgentMessageId: 'core.md',
   HookContext: 'core.md',
   LlmCallConfig: 'core.md',
   LlmModelContext: 'core.md',

scripts/gen-doc-graphs.ts

@@ -918,8 +918,8 @@ function renderLifecycle(): string {
     '  participant Session',
     '  participant Persistence',
     '  participant SDK as UI or SDK listener',
-    '  User->>Agent: send(content)',
-    `  Agent-->>SDK: ${mermaidCode('agent/queued')}`,
+    '  User->>Agent: followup(content)',
+    `  Agent-->>SDK: ${mermaidCode('agent/inbox/enqueue')}`,
     '  Agent->>Driver: queued work wakes driver',
     `  Driver-->>SDK: ${mermaidCode('agent/status')} running`,
     `  Driver->>Session: ${mermaidCode('turn/start')}`,
@@ -998,7 +998,7 @@ function renderToolPipeline(): string {
     '  normalized["Registry outer normalization<br/>pipeline/result snapshot throws become isError"]',
     '  finalize["ToolDefinition.finalizeContent<br/>last content-only invariant"]',
     `  final["${mermaidCode('tools/result')} synchronous notification<br/>frozen authoritative outcome"]`,
-    '  context["Active-batch additionalContexts FIFO<br/>context/message after recorded tool results"]',
+    '  context["Active-batch additionalContexts FIFO<br/>injected user/message after recorded tool results"]',
     `  toolResult["Session event: ${mermaidCode('tool/result')}<br/>single model-facing outcome"]`,
     '  allResults["Tool batch settled<br/>recorded tool/result events complete"]',
     '  presentResult["UI completed card<br/>presentResult(args, result)"]',

scripts/gen-tool-catalog.ts

@@ -263,7 +263,7 @@ const TOOL_PACKAGES: ToolPackage[] = [
     dir: 'tool-goal',
     source: 'packages/goal/tool-goal/src/index.ts',
     requires: ['ctx.tools', 'ctx.agents', 'ctx.goals', 'ctx.systemPrompt', 'a calling Agent in an authorized open turn'],
-    writes: ['tool/call', 'context/message goal snapshot for mutations', 'tool/result'],
+    writes: ['tool/call', 'user/message goal snapshot for mutations', 'tool/result'],
     async mount(ctx) {
       await ctx.plugin(AgentRegistry)
       await ctx.plugin(GoalService)
@@ -336,7 +336,7 @@ const TOOL_PACKAGES: ToolPackage[] = [
     dir: 'tool-tasks',
     source: 'packages/tasks/tool-tasks/src/index.ts',
     requires: ['ctx.tools', 'ctx.tasks', 'ctx.systemPrompt'],
-    writes: ['tool/call', 'tool/result', 'context/message via agent.inject() for background completion notices'],
+    writes: ['tool/call', 'tool/result', 'user/message via agent.inject() for background completion notices'],
     async mount(ctx) {
       await ctx.plugin(TaskService)
       await ctx.plugin(ToolTasks)

scripts/project-doc-site.spec.ts

@@ -172,13 +172,13 @@ describe('rewriteMarkdown', () => {
 })
 
 describe('docsPages locale routes', () => {
-  it('publishes every route in both locales and selects paired user sources', () => {
+  it('publishes every route in both locales and selects paired sources', () => {
     const byRoute = new Map(docsPages.map(page => [page.route, page]))
     for (const page of docsPages.filter(page => page.locale === 'root')) {
       const counterpart = byRoute.get(`en/${page.route}`)
       expect(counterpart, page.route).toBeDefined()
       expect(counterpart?.locale).toBe('en')
-      if (page.source.startsWith('docs/user/')) {
+      if (page.contentLocale === 'zh-CN') {
         expect(page.source).toMatch(/\.zh\.md$/)
         expect(page.contentLocale).toBe('zh-CN')
         expect(counterpart?.source).toBe(page.source.replace(/\.zh\.md$/, '.md'))
@@ -190,6 +190,22 @@ describe('docsPages locale routes', () => {
     }
   })
 
+  it('projects translated core-data pages while retaining explicit English fallbacks', () => {
+    const rootPages = docsPages.filter(page => (
+      page.locale === 'root' && page.route.startsWith('reference/core-data-structures/')
+    ))
+    const translated = rootPages.filter(page => page.contentLocale === 'zh-CN')
+    const fallbacks = rootPages.filter(page => page.contentLocale === 'en-US')
+
+    expect(translated).toHaveLength(18)
+    expect(translated.every(page => page.source.endsWith('.zh.md'))).toBe(true)
+    expect(fallbacks.map(page => page.source).sort()).toEqual([
+      'docs/core-data-structures/commands.md',
+      'docs/core-data-structures/goal.md',
+      'docs/core-data-structures/pty.md',
+    ])
+  })
+
   it('publishes the Cordis core API under matching locale structures', () => {
     const files = ['context.md', 'events.md', 'fiber.md', 'registry.md', 'service.md']
     for (const file of files) {

scripts/translation-pairing.manifest.json

@@ -1,24 +1,201 @@
 {
   "requiredSince": "2026-07-14",
   "required": [
+    ".agents/notes/README.md",
+    ".agents/notes/implemented/architecture/2026-06-11-content-block-vocabulary.md",
+    ".agents/notes/implemented/architecture/2026-06-11-custom-schema-dsl.md",
+    ".agents/notes/implemented/architecture/2026-06-11-dev-invariants-over-deep-readonly.md",
+    ".agents/notes/implemented/architecture/2026-06-11-event-sourced-sessions.md",
+    ".agents/notes/implemented/architecture/2026-06-11-microkernel-event-taxonomy.md",
+    ".agents/notes/implemented/architecture/2026-06-11-runtime-arg-validation.md",
+    ".agents/notes/implemented/architecture/2026-06-11-structured-error-taxonomy.md",
+    ".agents/notes/implemented/architecture/2026-06-11-tool-schemas-in-prompt-assembly.md",
+    ".agents/notes/implemented/architecture/2026-06-13-capability-seams.md",
+    ".agents/notes/implemented/architecture/2026-06-13-twin-llm-adapters.md",
+    ".agents/notes/implemented/architecture/2026-06-14-session-persistence.md",
+    ".agents/notes/implemented/architecture/2026-06-15-turn-enclosure-invariant.md",
+    ".agents/notes/implemented/architecture/2026-06-17-filesystem-capability-seam.md",
+    ".agents/notes/implemented/architecture/2026-06-18-agent-lifecycle-and-ownership-seams.md",
+    ".agents/notes/implemented/architecture/2026-06-18-session-surface.md",
+    ".agents/notes/implemented/architecture/2026-06-18-shared-persistence-write-coordinator.md",
+    ".agents/notes/implemented/architecture/2026-06-20-branded-ids.md",
+    ".agents/notes/implemented/architecture/2026-06-20-extract-example-app-packages.md",
+    ".agents/notes/implemented/architecture/2026-06-20-generic-long-running-tool-runtime.md",
+    ".agents/notes/implemented/architecture/2026-06-20-package-hierarchy.md",
+    ".agents/notes/implemented/architecture/2026-06-21-mandatory-app-attribution-headers.md",
+    ".agents/notes/implemented/architecture/2026-06-24-web-capability-seam.md",
+    ".agents/notes/implemented/architecture/2026-06-26-file-context-as-event-gate.md",
+    ".agents/notes/implemented/architecture/2026-06-30-bash-stdin-env-trusted-plugin-surface.md",
+    ".agents/notes/implemented/architecture/2026-06-30-event-domain-semantics.md",
+    ".agents/notes/implemented/architecture/2026-07-02-fs-per-session-cwd.md",
+    ".agents/notes/implemented/architecture/2026-07-02-result-time-applied-hunk-diffs.md",
+    ".agents/notes/implemented/architecture/2026-07-02-tool-render-intent-union.md",
+    ".agents/notes/implemented/architecture/2026-07-03-filesystem-directory-listing-seam.md",
+    ".agents/notes/implemented/architecture/2026-07-05-prompt-variables-and-tool-guidance-ownership.md",
+    ".agents/notes/implemented/architecture/2026-07-05-reconstructable-requests.md",
+    ".agents/notes/implemented/architecture/2026-07-05-subagent-provider-lifecycle-events.md",
+    ".agents/notes/implemented/architecture/2026-07-06-timeout-deadline-library.md",
+    ".agents/notes/implemented/architecture/2026-07-07-tool-call-timeout-policy.md",
+    ".agents/notes/implemented/architecture/2026-07-08-agent-scope-contexts.md",
     ".agents/notes/implemented/architecture/2026-07-10-single-file-executable-sdk-runtime-distribution.md",
+    ".agents/notes/implemented/architecture/2026-07-12-agent-scope-runtime-design.md",
     ".agents/notes/implemented/architecture/2026-07-16-explicit-turn-cancellation.md",
     ".agents/notes/implemented/architecture/2026-07-19-gui-layering-and-rpc-protocol.md",
     ".agents/notes/implemented/architecture/2026-07-19-gui-web-client-architecture.md",
     ".agents/notes/implemented/architecture/2026-07-22-slot-type-chain-implementation.md",
     ".agents/notes/implemented/architecture/2026-07-23-client-plugin-loading-model.md",
+    ".agents/notes/implemented/feature/2026-06-14-acp-agent-client-protocol.md",
+    ".agents/notes/implemented/feature/2026-06-14-acp-multi-session.md",
+    ".agents/notes/implemented/feature/2026-06-15-code-mode.md",
+    ".agents/notes/implemented/feature/2026-06-17-filesystem-tool-schemas.md",
+    ".agents/notes/implemented/feature/2026-06-18-acp-terminal-and-tool-rendering.md",
+    ".agents/notes/implemented/feature/2026-06-18-compaction-capability-seam.md",
+    ".agents/notes/implemented/feature/2026-06-21-subagent-capability-seam.md",
+    ".agents/notes/implemented/feature/2026-06-22-acp-subagent-backend.md",
+    ".agents/notes/implemented/feature/2026-06-25-ask-user-question.md",
+    ".agents/notes/implemented/feature/2026-06-29-todo-write-tool.md",
+    ".agents/notes/implemented/feature/2026-06-30-hook-bridges.md",
+    ".agents/notes/implemented/feature/2026-06-30-hook-protocol-lib.md",
+    ".agents/notes/implemented/feature/2026-06-30-interception-seams.md",
+    ".agents/notes/implemented/feature/2026-06-30-session-store-fork-api.md",
+    ".agents/notes/implemented/feature/2026-06-30-subagent-observe-enrich.md",
+    ".agents/notes/implemented/feature/2026-07-05-dynamic-workflows.md",
+    ".agents/notes/implemented/feature/2026-07-05-skill-system.md",
+    ".agents/notes/implemented/feature/2026-07-06-approval-seam.md",
+    ".agents/notes/implemented/feature/2026-07-06-explicit-tool-order.md",
+    ".agents/notes/implemented/feature/2026-07-06-sandbox.md",
+    ".agents/notes/implemented/feature/2026-07-07-mcp-client-plugin.md",
+    ".agents/notes/implemented/feature/2026-07-07-session-prefix.md",
+    ".agents/notes/implemented/feature/2026-07-08-repeat-tool-guard.md",
+    ".agents/notes/implemented/feature/2026-07-08-self-referential-cordis-toolset.md",
+    ".agents/notes/implemented/feature/2026-07-10-session-query-service.md",
+    ".agents/notes/implemented/feature/2026-07-12-subagent-persona-tool-filter-and-depth.md",
+    ".agents/notes/implemented/process/2026-06-11-doc-sync-enforcement.md",
+    ".agents/notes/implemented/process/2026-06-11-quality-gates.md",
+    ".agents/notes/implemented/process/2026-06-11-tsdown-over-dumble.md",
+    ".agents/notes/implemented/process/2026-06-11-vendor-cordis-as-source.md",
+    ".agents/notes/implemented/process/2026-06-16-pnpm-over-yarn.md",
+    ".agents/notes/implemented/process/2026-06-17-ts-build-config.md",
+    ".agents/notes/implemented/process/2026-06-18-markdown-cross-link-lint.md",
+    ".agents/notes/implemented/process/2026-06-20-agent-note-classification.md",
+    ".agents/notes/implemented/process/2026-06-20-core-data-structures-catalog.md",
+    ".agents/notes/implemented/process/2026-06-20-generated-cordis-catalog.md",
     ".agents/notes/implemented/process/2026-07-02-bilingual-docs-and-pairing-gate.md",
+    ".agents/notes/implemented/process/2026-07-02-tool-schema-catalog.md",
+    ".agents/notes/implemented/process/2026-07-03-documentation-graph-atlas.md",
+    ".agents/notes/implemented/process/2026-07-04-cordis-jsdoc-completeness-gate.md",
+    ".agents/notes/implemented/process/2026-07-04-doc-tiers-and-budgets.md",
+    ".agents/notes/implemented/process/2026-07-04-persistence-log-catalog.md",
+    ".agents/notes/implemented/process/2026-07-05-uniform-agent-note-format.md",
+    ".agents/notes/implemented/process/2026-07-06-export-surface-jsdoc-gate.md",
+    ".agents/notes/implemented/process/2026-07-06-generated-config-catalog.md",
+    ".agents/notes/implemented/process/2026-07-06-node-engine-floor.md",
+    ".agents/notes/implemented/process/2026-07-06-parallel-github-ci-gates.md",
+    ".agents/notes/implemented/process/2026-07-06-parallel-pre-push-gates.md",
+    ".agents/notes/implemented/process/2026-07-10-readme-known-limitations-gate.md",
+    ".agents/notes/implemented/process/2026-07-12-package-model-experience-contract.md",
     ".agents/notes/implemented/process/2026-07-19-web-styling-system.md",
+    ".agents/notes/implemented/simplification/2026-06-19-drop-mutable-session-summary.md",
+    ".agents/notes/implemented/simplification/2026-06-20-collapse-trace-only-session-events.md",
+    ".agents/notes/implemented/simplification/2026-06-20-drop-unconsumed-llm-adapter-change-event.md",
+    ".agents/notes/implemented/simplification/2026-06-20-drop-unconsumed-llm-assembled-surfaces.md",
+    ".agents/notes/implemented/simplification/2026-06-20-prune-dead-seam-methods.md",
+    ".agents/notes/implemented/simplification/2026-06-20-public-agent-stop-surface.md",
+    ".agents/notes/implemented/simplification/2026-06-20-remove-agent-boundary-mirror-events.md",
+    ".agents/notes/implemented/simplification/2026-06-20-unify-agent-and-session-id.md",
+    ".agents/notes/implemented/simplification/2026-06-26-fsspec-style-fs-seam.md",
+    ".agents/notes/implemented/simplification/2026-07-02-remove-stream-chunk-mirror.md",
+    ".agents/notes/implemented/simplification/2026-07-04-drop-image-content-block.md",
+    ".agents/notes/implemented/simplification/2026-07-04-drop-inert-request-knobs.md",
+    ".agents/notes/implemented/simplification/2026-07-04-drop-unconsumed-web-observation-surface.md",
+    ".agents/notes/implemented/simplification/2026-07-04-fold-stdio-ui-helper.md",
+    ".agents/notes/implemented/simplification/2026-07-04-prune-producerless-vocabulary-variants.md",
+    ".agents/notes/implemented/simplification/2026-07-04-prune-write-only-fs-surface.md",
+    ".agents/notes/implemented/simplification/2026-07-04-remove-agent-steering-mirror.md",
+    ".agents/notes/implemented/simplification/2026-07-04-share-app-bin-boot-glue.md",
+    ".agents/notes/implemented/simplification/2026-07-04-tighten-hook-protocol-contract.md",
+    ".agents/notes/implemented/simplification/2026-07-04-trim-acp-bridge-unreachable-surface.md",
+    ".agents/notes/implemented/simplification/2026-07-12-drop-unconsumed-skill-provider-events.md",
+    ".agents/notes/implemented/simplification/2026-07-12-prune-unused-web-seam-fields.md",
+    ".agents/notes/implemented/simplification/2026-07-12-simplify-session-log-representation.md",
+    ".agents/notes/implemented/testing/2026-06-11-property-based-testing.md",
+    ".agents/notes/implemented/testing/2026-06-19-acp-snapshot-tests.md",
+    ".agents/notes/implemented/testing/2026-06-19-real-api-e2e-ci.md",
+    ".agents/notes/implemented/testing/2026-06-20-remove-redundant-snapshot-log-expected-output.md",
+    ".agents/notes/implemented/testing/2026-06-22-fork-child-replay-seed-boundary.md",
+    ".agents/notes/implemented/testing/2026-06-22-fork-snapshot-scenarios.md",
+    ".agents/notes/implemented/testing/2026-06-22-subagent-snapshot-replay.md",
+    ".agents/notes/implemented/testing/2026-07-04-hook-snapshot-matrix.md",
+    ".agents/notes/implemented/testing/2026-07-04-single-source-acp-replay-config.md",
+    ".agents/notes/implemented/testing/2026-07-06-pin-request-header-content-in-one-scenario.md",
+    ".agents/notes/implemented/testing/2026-07-08-shared-acp-snapshot-package.md",
+    ".agents/notes/proposed/architecture/2026-06-16-typed-event-schemas.md",
+    ".agents/notes/proposed/feature/2026-06-30-pre-tool-input-rewrite.md",
+    ".agents/notes/proposed/feature/2026-07-07-claude-code-and-codex-subagent-backends.md",
+    ".agents/notes/proposed/feature/2026-07-08-interactive-side-sessions.md",
+    ".agents/notes/implemented/feature/2026-07-10-sqlite-session-query-provider.md",
+    ".agents/notes/proposed/feature/2026-07-13-stream-workflow-progress-through-tool-calls.md",
+    ".agents/notes/proposed/process/2026-06-11-api-extractor-reports.md",
+    ".agents/notes/proposed/process/2026-06-11-architectural-conformance.md",
+    ".agents/notes/proposed/process/2026-06-11-supply-chain-and-vendor-drift.md",
+    ".agents/notes/proposed/process/2026-06-20-discover-package-inventory.md",
+    ".agents/notes/proposed/simplification/2026-07-04-prune-dead-core-spine-surface.md",
+    ".agents/notes/proposed/testing/2026-06-11-deterministic-and-stress-testing.md",
+    ".agents/notes/proposed/testing/2026-06-11-mutation-testing.md",
+    ".agents/notes/rejected/architecture/2026-06-11-immutable-public-surfaces.md",
+    ".agents/notes/rejected/architecture/2026-06-20-providerless-example-base.md",
+    ".agents/notes/rejected/process/2026-07-04-generate-agent-note-index-tables.md",
+    ".agents/notes/rejected/simplification/2026-06-20-assembled-assistant-messages-only.md",
+    ".agents/notes/rejected/simplification/2026-06-20-drop-acp-session-load.md",
+    ".agents/notes/rejected/simplification/2026-06-20-drop-acp-terminal-meta.md",
+    ".agents/notes/rejected/simplification/2026-06-20-drop-bash-output-spill-files.md",
+    ".agents/notes/rejected/simplification/2026-06-20-drop-durable-step-boundaries.md",
+    ".agents/notes/rejected/simplification/2026-06-20-drop-unused-session-lineage.md",
+    ".agents/notes/rejected/simplification/2026-06-20-fold-session-persistence-interface.md",
+    ".agents/notes/rejected/simplification/2026-06-20-generic-tool-rendering.md",
+    ".agents/notes/rejected/simplification/2026-06-20-retire-mid-turn-steering.md",
+    ".agents/notes/rejected/simplification/2026-06-20-single-session-acp-bridge.md",
+    ".agents/notes/rejected/simplification/2026-06-20-truncate-interrupted-turns.md",
+    ".agents/notes/rejected/simplification/2026-07-04-prune-unimplemented-subagent-vocabulary.md",
+    ".agents/notes/rejected/simplification/2026-07-12-collapse-workflow-to-foreground-core.md",
+    ".agents/notes/rejected/simplification/2026-07-12-prune-unused-skill-registry-surface.md",
     "README.md",
+    "docs/architecture.md",
     "docs/cookbook/adding-a-package.md",
     "docs/cookbook/adding-a-tool.md",
     "docs/cookbook/adding-a-vendored-package.md",
     "docs/cookbook/adding-an-llm-adapter.md",
     "docs/cookbook/extension-cookbook.md",
     "docs/cookbook/responding-to-pr-review-on-a-stack.md",
+    "docs/cordis-primer.md",
+    "docs/core-data-structures/approval.md",
+    "docs/core-data-structures/bash.md",
+    "docs/core-data-structures/code-runtime.md",
+    "docs/core-data-structures/compaction.md",
+    "docs/core-data-structures/core.md",
+    "docs/core-data-structures/filesystem.md",
+    "docs/core-data-structures/llm-streaming.md",
+    "docs/core-data-structures/persistence.md",
+    "docs/core-data-structures/sandbox.md",
+    "docs/core-data-structures/scope.md",
+    "docs/core-data-structures/session-query.md",
+    "docs/core-data-structures/session.md",
+    "docs/core-data-structures/skills.md",
+    "docs/core-data-structures/subagent.md",
+    "docs/core-data-structures/system-prompt.md",
+    "docs/core-data-structures/tools.md",
+    "docs/core-data-structures/user-interaction.md",
+    "docs/core-data-structures/web.md",
+    "docs/core-data-structures/workflow.md",
+    "docs/defensive-patterns.md",
     "docs/development.md",
+    "docs/glossary.md",
     "docs/i18n/README.md",
     "docs/i18n/translation-rules.md",
+    "docs/postmortem/0001-acp-default-export-drops-inject.md",
+    "docs/postmortem/0002-js-expression-disabled-filesystem-tools.md",
+    "docs/postmortem/README.md",
+    "docs/testing.md",
     "docs/user/develop/basic/config.md",
     "docs/user/develop/basic/index.md",
     "docs/user/develop/basic/tool.md",
@@ -39,14 +216,19 @@
     ".agents/notes/AGENTS.md",
     ".agents/notes/implemented/AGENTS.md",
     "docs/AGENTS.md",
+    "docs/agent-lifecycle.md",
+    "docs/capability-seams.md",
     "docs/config-catalog.md",
     "docs/cordis-catalog/",
+    "docs/event-producer-consumer.md",
+    "docs/graph-atlas.md",
     "docs/i18n/style-samples.md",
     "docs/i18n/terminology.md",
     "docs/i18n/translation-prompt.md",
     "docs/module-graph.md",
     "docs/persistence-catalog.md",
     "docs/tool-catalog.md",
+    "docs/tool-execution-pipeline.md",
     "python/sdk-runtime/src/deepseek_harness_runtime/runtime/node/"
   ]
 }

scripts/verify-cordis-config.ts

@@ -12,6 +12,7 @@ import { globSync, readFileSync } from 'node:fs'
 import { dirname, relative, resolve } from 'node:path'
 import * as yaml from 'js-yaml'
 import ts from 'typescript'
+import { cordisConfigFiles } from './cordis-config-files.ts'
 
 interface JsExpr {
   __jsExpr: string
@@ -39,10 +40,7 @@ const jsExprType = new yaml.Type('tag:yaml.org,2002:js', {
 })
 const schema = yaml.JSON_SCHEMA.extend(jsExprType)
 
-const files = globSync(['**/*cordis*.yml', '**/*cordis*.yaml'], {
-  cwd: root,
-  exclude: ['.claude/**', 'node_modules/**', 'vendor/**'],
-}).sort()
+const files = cordisConfigFiles(root)
 const errors: string[] = []
 const examplePluginReferences: PluginReference[] = []