@aiwg/cli 2026.11.4 → 2026.11.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (192) hide show
  1. package/agentic/code/providers/capability-matrix.yaml +75 -5
  2. package/agentic/code/providers/model-capabilities.v1.json +44 -36
  3. package/bin/aiwg.mjs +6 -4
  4. package/dist/src/activity-log/cli.js +1 -1
  5. package/dist/src/agents/agent-deployer.js +1 -1
  6. package/dist/src/artifacts/audit/types.js +1 -1
  7. package/dist/src/artifacts/discover-facets.js +1 -1
  8. package/dist/src/artifacts/enrichment/prompt.js +1 -1
  9. package/dist/src/artifacts/enrichment/types.js +1 -1
  10. package/dist/src/artifacts/index-builder.js +4 -2
  11. package/dist/src/artifacts/query-engine-rules.js +2 -2
  12. package/dist/src/artifacts/types.js +1 -1
  13. package/dist/src/artifacts/views/definition.js +1 -1
  14. package/dist/src/artifacts/views/types.js +1 -1
  15. package/dist/src/catalog/cli.js +1 -1
  16. package/dist/src/catalog/cli.mjs +1 -1
  17. package/dist/src/catalog/loader.js +1 -1
  18. package/dist/src/catalog/loader.mjs +1 -1
  19. package/dist/src/catalog/types.js +1 -1
  20. package/dist/src/cli/cli-extension-loader.js +19 -5
  21. package/dist/src/cli/cli-extension-paths.js +65 -0
  22. package/dist/src/cli/handlers/best-practices-audit.js +1 -1
  23. package/dist/src/cli/handlers/help.js +3 -4
  24. package/dist/src/cli/handlers/index.js +1 -1
  25. package/dist/src/cli/handlers/marketplace-plugin-search.js +37 -0
  26. package/dist/src/cli/handlers/marketplace.js +3 -1
  27. package/dist/src/cli/handlers/models.js +1 -1
  28. package/dist/src/cli/handlers/ralph-launcher.js +8 -2
  29. package/dist/src/cli/handlers/ralph.js +1 -1
  30. package/dist/src/cli/handlers/runtime-info.js +1 -1
  31. package/dist/src/cli/handlers/scaffolding.js +2 -2
  32. package/dist/src/cli/handlers/script-runner.js +8 -5
  33. package/dist/src/cli/handlers/sdlc-accelerate.js +1 -1
  34. package/dist/src/cli/handlers/steward-format.js +12 -0
  35. package/dist/src/cli/handlers/subcommands-bundles.js +1 -1
  36. package/dist/src/cli/handlers/subcommands-list-format.js +19 -1
  37. package/dist/src/cli/handlers/types.js +1 -1
  38. package/dist/src/cli/handlers/use.js +15 -6
  39. package/dist/src/cli/handlers/utilities.js +1 -1
  40. package/dist/src/cli/handlers/utility-doctor.js +4 -0
  41. package/dist/src/cli/handlers/version.js +1 -1
  42. package/dist/src/cli/handlers/workspace.js +1 -1
  43. package/dist/src/cli/help-generator.js +9 -11
  44. package/dist/src/cli/hooks/builtin/activity-log-hook.js +1 -1
  45. package/dist/src/cli/router.js +1 -1
  46. package/dist/src/cli/workflow-orchestrator.js +1 -1
  47. package/dist/src/config/worker-context.js +37 -7
  48. package/dist/src/config/worker-parallelism.js +11 -0
  49. package/dist/src/contributors/detect.js +1 -1
  50. package/dist/src/contributors/discover.js +1 -1
  51. package/dist/src/contributors/heuristic.js +1 -1
  52. package/dist/src/contributors/index.js +1 -1
  53. package/dist/src/contributors/types.js +1 -1
  54. package/dist/src/contributors/validation.js +1 -1
  55. package/dist/src/effects/worker-delivery.js +83 -0
  56. package/dist/src/extensions/capability-index.js +1 -1
  57. package/dist/src/extensions/commands/definitions.js +2 -2
  58. package/dist/src/extensions/deployment-registration.js +1 -1
  59. package/dist/src/extensions/index.js +1 -1
  60. package/dist/src/extensions/loader.js +1 -1
  61. package/dist/src/extensions/manifest.js +10 -2
  62. package/dist/src/extensions/project-local-activity.js +1 -1
  63. package/dist/src/extensions/project-local-discovery.js +23 -3
  64. package/dist/src/extensions/project-local-doctor.js +7 -3
  65. package/dist/src/extensions/project-local-promote.js +3 -3
  66. package/dist/src/extensions/project-local-remove.js +3 -3
  67. package/dist/src/extensions/project-local-scaffold.js +20 -8
  68. package/dist/src/extensions/registry.js +1 -1
  69. package/dist/src/extensions/shadow-resolver.js +1 -1
  70. package/dist/src/extensions/types.js +1 -1
  71. package/dist/src/extensions/upstream-registry.js +1 -1
  72. package/dist/src/extensions/validation.js +1 -1
  73. package/dist/src/intake/git-history-analyzer.js +1 -1
  74. package/dist/src/kb/cli.js +1 -1
  75. package/dist/src/marketplace/plugin-directory.js +36 -0
  76. package/dist/src/marketplace/plugin-search.js +180 -0
  77. package/dist/src/mcp/cli.mjs +2 -2
  78. package/dist/src/mcp/helpers.mjs +1 -1
  79. package/dist/src/mcp/http-tools.mjs +8 -6
  80. package/dist/src/mcp/http-transport.mjs +3 -1
  81. package/dist/src/mcp/server.mjs +1 -1
  82. package/dist/src/mcp/tools/command-run.mjs +1 -1
  83. package/dist/src/mcp/tools/discovery.mjs +1 -1
  84. package/dist/src/mcp/tools/subsystems.mjs +1 -1
  85. package/dist/src/mcp/tools/worker-invoke.mjs +68 -22
  86. package/dist/src/mcp/tools/worker-local-only-preflight.mjs +79 -0
  87. package/dist/src/mcp/tools/worker-recorded-launch.mjs +26 -0
  88. package/dist/src/mcp/tools/worker-stdin-runtime.mjs +33 -6
  89. package/dist/src/mcp/tools/worker-verify-deliver-schema.mjs +33 -0
  90. package/dist/src/mcp/tools/worker-verify-deliver.mjs +27 -0
  91. package/dist/src/models/catalog-policy.js +2 -2
  92. package/dist/src/models/conductor-data-policy.mjs +83 -14
  93. package/dist/src/models/config-loader.js +2 -2
  94. package/dist/src/models/factory-models.js +144 -0
  95. package/dist/src/models/index.js +2 -2
  96. package/dist/src/models/local-endpoint-models.js +155 -0
  97. package/dist/src/models/model-capabilities.v1.json +44 -36
  98. package/dist/src/models/model-discovery.js +16 -8
  99. package/dist/src/models/opencode-worker-model.mjs +16 -0
  100. package/dist/src/models/resolver.js +2 -2
  101. package/dist/src/models/worker-installation.d.mts +2 -0
  102. package/dist/src/models/worker-installation.mjs +16 -5
  103. package/dist/src/models/worker-invocation-policy.js +25 -1
  104. package/dist/src/models/worker-plan.js +1 -1
  105. package/dist/src/models/wrapper-enforcement.js +1 -1
  106. package/dist/src/plugin/plugin-installer.js +2 -2
  107. package/dist/src/plugin/registry-validator.js +2 -2
  108. package/dist/src/plugin/skill-command-translator.js +1 -1
  109. package/dist/src/policy/repo-access.js +3 -1
  110. package/dist/src/providers/capability-matrix.yaml +75 -5
  111. package/dist/src/providers/deployment-ownership.mjs +8 -1
  112. package/dist/src/providers/deployment-preservation.mjs +44 -3
  113. package/dist/src/providers/grok-build-acp.js +13 -5
  114. package/dist/src/providers/grok-build-dispatch.js +35 -2
  115. package/dist/src/providers/grok-build-headless.js +2 -1
  116. package/dist/src/rlm/cache/hash.js +1 -1
  117. package/dist/src/rlm/cache/store.js +1 -1
  118. package/dist/src/rlm/cache/types.js +1 -1
  119. package/dist/src/serve/worker-invocation-preparation.js +13 -0
  120. package/dist/src/serve/worker-invocation.js +21 -6
  121. package/dist/src/serve/worker-stdin-frame.mjs +1 -1
  122. package/dist/src/sessions/adapters/grok-build-native-records.js +77 -7
  123. package/dist/src/sessions/adapters/grok-build-native.js +148 -1
  124. package/dist/src/sessions/adapters/grok-build.js +36 -14
  125. package/dist/src/sessions/normalization.js +1 -1
  126. package/dist/src/skills/run.js +0 -11
  127. package/dist/src/smiths/agentsmith/generator.js +1 -1
  128. package/dist/src/smiths/context-pipeline/index.js +1 -1
  129. package/dist/src/smiths/context-pipeline/provider-policy.js +1 -1
  130. package/dist/src/smiths/context-pipeline/types.js +1 -1
  131. package/dist/src/smiths/context-pipeline/workspace-doctor.js +4 -0
  132. package/dist/src/smiths/hook-bridge/factory-trust.js +2 -2
  133. package/dist/src/smiths/hook-bridge/hermes-prompt-discovery.js +10 -7
  134. package/dist/src/smiths/hook-bridge/hermes-trust.js +65 -0
  135. package/dist/src/smiths/mcpsmith/analyzers/cli-analyzer.js +2 -2
  136. package/dist/src/smiths/mcpsmith/generator.js +2 -2
  137. package/dist/src/smiths/mcpsmith/index.js +2 -2
  138. package/dist/src/smiths/mcpsmith/types.js +2 -2
  139. package/dist/src/smiths/skillsmith/collision-detector.js +1 -1
  140. package/dist/src/smiths/skillsmith/namespace-adapter.js +1 -1
  141. package/dist/src/smiths/toolsmith/runtime-discovery.mjs +2 -2
  142. package/dist/src/smiths/toolsmith/types.js +2 -2
  143. package/dist/src/storage/backends/fortemi.js +1 -1
  144. package/dist/src/storage/backends/fs.js +1 -1
  145. package/dist/src/storage/backends/logseq.js +1 -1
  146. package/dist/src/storage/backends/obsidian.js +1 -1
  147. package/dist/src/storage/cli.js +2 -2
  148. package/dist/src/storage/config.js +1 -1
  149. package/dist/src/storage/index.js +1 -1
  150. package/dist/src/storage/subsystem-cli.js +1 -1
  151. package/dist/src/storage/types.js +1 -1
  152. package/dist/src/testing/generators/test-case-generator.js +1 -1
  153. package/dist/src/writing/validation-engine.js +1 -1
  154. package/package.json +11 -1
  155. package/schemas/models/model-catalog.v1.schema.json +6 -3
  156. package/tools/agents/deploy-agents.mjs +4 -2
  157. package/tools/agents/deploy-options.mjs +2 -0
  158. package/tools/agents/providers/base-inventory.mjs +3 -1
  159. package/tools/agents/providers/base-kernel-skills.mjs +11 -5
  160. package/tools/agents/providers/conductor-data-guard.mjs +1 -1
  161. package/tools/agents/providers/grok-build.mjs +31 -40
  162. package/tools/agents/providers/model-wrapper.mjs +2 -5
  163. package/tools/agents/providers/rule-deployment-commit.mjs +3 -0
  164. package/tools/agents/providers/rule-deployment-prepare.mjs +2 -2
  165. package/tools/agents/providers/rule-projection.mjs +39 -4
  166. package/tools/agents/providers/skill-copy-prune.mjs +12 -0
  167. package/tools/agents/providers/stale-artifact-prune.mjs +24 -10
  168. package/tools/ralph-external/lib/claude-adapter.mjs +2 -0
  169. package/tools/ralph-external/lib/factory-adapter.mjs +6 -2
  170. package/tools/ralph-external/lib/mcp-worker-launch.mjs +67 -0
  171. package/tools/ralph-external/lib/opencode-adapter.mjs +9 -7
  172. package/tools/ralph-external/lib/trusted-verification.mjs +1021 -0
  173. package/tools/ralph-external/lib/typed-stop-delivery.mjs +46 -0
  174. package/tools/ralph-external/lib/verification-isolation.mjs +509 -0
  175. package/tools/ralph-external/lib/worker-context.mjs +3 -3
  176. package/tools/ralph-external/lib/worker-delivery-guards.mjs +95 -0
  177. package/tools/ralph-external/lib/worker-delivery-record.mjs +15 -0
  178. package/tools/ralph-external/lib/worker-final.mjs +4 -1
  179. package/tools/ralph-external/lib/worker-inputs.mjs +20 -1
  180. package/tools/ralph-external/lib/worker-isolation-status.mjs +3 -0
  181. package/tools/ralph-external/lib/worker-isolation.mjs +1 -0
  182. package/tools/ralph-external/lib/worker-launch-cli.mjs +8 -0
  183. package/tools/ralph-external/lib/worker-local-only-paths.mjs +45 -0
  184. package/tools/ralph-external/lib/worker-prompt.mjs +4 -1
  185. package/tools/ralph-external/lib/worker-retry-evidence.mjs +2 -1
  186. package/tools/ralph-external/lib/worker-run-directory.mjs +45 -0
  187. package/tools/ralph-external/lib/worker-termination.mjs +21 -12
  188. package/tools/ralph-external/lib/worker-unit-cleanup.mjs +10 -2
  189. package/tools/ralph-external/lib/worker-verification-cli.mjs +164 -0
  190. package/tools/ralph-external/lib/worktree-preparation.mjs +417 -0
  191. package/tools/ralph-external/session-launcher.mjs +30 -32
  192. package/vscode-extension/schemas/aiwg.config.v1.json +27 -0
@@ -93,6 +93,14 @@ providers:
93
93
 
94
94
  codex:
95
95
  display_name: OpenAI Codex
96
+ byok:
97
+ status: documented
98
+ settings:
99
+ - 'Harness config.toml: model_provider and model select a model_providers entry with base_url, env_key and wire_api = "responses".'
100
+ - 'env_key names an environment variable; inject its value from the environment or a secret-store command only.'
101
+ verification: 'After approval, send "Reply with exactly: byok-ok" and check the Codex session log for the resolved model and provider.'
102
+ notes: 'Custom providers require the Responses API; OpenRouter compatibility with the requested model is unverified. Do not copy a Chat Completions configuration.'
103
+ docs: docs/agents/providers/codex.md#wire-protocol
96
104
  route_feasibility:
97
105
  scope: in
98
106
  identity: runtime-configured-only
@@ -176,6 +184,16 @@ providers:
176
184
 
177
185
  copilot:
178
186
  display_name: GitHub Copilot
187
+ byok:
188
+ status: verified
189
+ settings:
190
+ - 'COPILOT_PROVIDER_BASE_URL=https://openrouter.ai/api/v1'
191
+ - 'COPILOT_PROVIDER_TYPE=openai'
192
+ - 'COPILOT_MODEL=qwen/qwen3.8-27b'
193
+ - 'Key: COPILOT_PROVIDER_API_KEY environment variable or COPILOT_PROVIDER_API_KEY_COMMAND secret-store command.'
194
+ verification: 'After approval, send "Reply with exactly: byok-ok" and check the Copilot harness log/session for the resolved model qwen/qwen3.8-27b.'
195
+ notes: 'Operator live run, 2026-11-09 (#4054); harness BYOK settings do not qualify the AIWG direct-worker parser or its cleared-environment profile.'
196
+ docs: docs/providers/copilot-direct.md#bring-your-own-key
179
197
  aliases:
180
198
  - github-copilot
181
199
  route_feasibility:
@@ -226,6 +244,14 @@ providers:
226
244
 
227
245
  factory:
228
246
  display_name: Factory AI
247
+ byok:
248
+ status: verified
249
+ settings:
250
+ - 'Harness-owned BYOK custom models: select the exact registered custom: model ID with droid exec -m <custom-model-id>.'
251
+ - 'Use only harness-supported environment or secret-store command injection at point of use; if the installed harness requires a plaintext apiKey in settings.json, stop and choose a secure route with the operator.'
252
+ verification: 'After approval, send "Reply with exactly: byok-ok" on stdin and inspect the Droid session for the resolved model and reasoning_effort none.'
253
+ notes: 'Operator live run, 2026-11-09 (#4054): -r reasoning effort is ignored for custom models. Copy the custom: selector from the harness model listing, not the upstream API ID or display name. #3969: heavy/medium/light aliases are rejected; use full built-in IDs for built-in models.'
254
+ docs: docs/providers/factory-direct.md#bring-your-own-key
229
255
  aliases:
230
256
  - factory-ai
231
257
  route_feasibility:
@@ -327,6 +353,14 @@ providers:
327
353
 
328
354
  opencode:
329
355
  display_name: OpenCode
356
+ byok:
357
+ status: verified
358
+ settings:
359
+ - 'Key: OPENROUTER_API_KEY environment variable; OpenRouter provider is harness-owned.'
360
+ - 'Model: opencode run -m openrouter/qwen/qwen3.8-27b (provider-prefixed model selector).'
361
+ verification: 'After approval, send "Reply with exactly: byok-ok" and inspect the OpenCode log/session for the resolved model qwen/qwen3.8-27b under openrouter.'
362
+ notes: 'Operator live run, 2026-11-09 (#4054); this guidance does not change AIWG worker environment allowlists or qualify direct dispatch.'
363
+ docs: docs/providers/opencode-direct.md#bring-your-own-key
330
364
  route_feasibility:
331
365
  scope: in
332
366
  identity: runtime-configured-only
@@ -549,7 +583,7 @@ providers:
549
583
  scope: in
550
584
  identity: runtime-configured-only
551
585
  evidence: R
552
- channel: "grok -p --output-format streaming-json; 1.0.77 adds --no-auto-update; bounded parser (model/effort pins unverified by captures)"
586
+ channel: "grok -p --output-format streaming-json; 1.0.77 captures: headless/ACP parser contracts, workflow fan-out bypass; combined deny flags rendered (live enforcement and model/effort pins unverified)"
553
587
  fanout: unknown
554
588
  probe_budget: { status: authorized, calls: 3, tokens: 30000, authorized_by: operator, authorized_at: "2026-10-07", hosts: [titan, noodle] }
555
589
  coverage:
@@ -558,17 +592,38 @@ providers:
558
592
  live_qualified: false
559
593
  sources:
560
594
  - "src/providers/grok-build-headless.ts"
595
+ - "test/unit/providers/grok-build-headless.test.ts"
596
+ - "test/unit/providers/grok-build-acp.test.ts"
597
+ - "test/unit/providers/grok-build-dispatch.test.ts"
598
+ - "test/conformance/orchestration-v1/grok-build-direct.test.ts"
561
599
  status: experimental
562
600
  # xAI Grok Build CLI/TUI. Distinct from Grok Bot (`grokbot`).
563
601
  # #2577: every claim and its limits are recorded in
564
602
  # docs/providers/grok-build-native-agents.md (1.0.77 evidence table).
565
603
  # Captured headless shapes: test/unit/providers/grok-build-headless.test.ts.
566
- # Agent compilation, native fan-out/worktrees and ACP remain unverified by
567
- # these captures; pre-existing synthetic tests establish AIWG behavior only.
604
+ # 2026-11-10 1.0.77: captured-20261110 fixtures replayed by the tests above.
605
+ # Default headless cancels spawn_subagent/workflow: "a headless run cannot ask
606
+ # for approval". --allow spawn_subagent did not cover them; permission-mode auto
607
+ # ran them. AIWG permission defaults stay unchanged (no automatic approval).
608
+ # --no-subagents alone still permits workflow-spawned children. All AIWG leaf
609
+ # argv builders also deny workflow with --disallowed-tools workflow; combined
610
+ # live flag enforcement is unverified, so route_feasibility.fanout stays unknown.
611
+ # Native -w is a standalone copy under ~/.grok/worktrees/<slug>/<name>, NOT a
612
+ # git worktree; list --json ownership/recovery metadata parsing is fixture-backed
613
+ # in grok-build-dispatch.test.ts. AIWG isolation still uses its own detached Git
614
+ # worktree and never edits the user's working files (synthetic dispatch test).
615
+ # ACP authMethods, logged-in session/new amid _x.ai/* notifications, end_turn
616
+ # _meta usage, compact/summary notifications and cancelled/MidTurnAbort are
617
+ # fixture-backed in grok-build-acp.test.ts; live ACP dispatch remains deferred.
618
+ # 2026-11-10 set-b: project .grok/agents/*.md discovery and ignored model pins
619
+ # replayed by grok-build-provider.test.ts with captured-20261110/native-agents.json.
620
+ # Only name/description frontmatter is emitted; role/tier intent lives in the
621
+ # body, not model pins. User-scope mirroring is offline-tested in grok-build-use.test.ts.
622
+ # Resident lifecycle remains unverified.
568
623
  daemon_tier: unsupported
569
624
  daemon_pty_adapter: false
570
625
  artifact_paths:
571
- agents: .grok/agents/ # writer path; native frontmatter unverified by captures
626
+ agents: .grok/agents/ # captured project discovery; grok-build-provider.test.ts
572
627
  commands: null
573
628
  skills: .grok/skills/
574
629
  skills_cross_agent: .grok/.aiwg/skills/ # --copy-all opt-in mirror
@@ -581,7 +636,7 @@ providers:
581
636
  mcp: true # fixture-backed config only: grok-build-native-integration.test.ts; live MCP unverified
582
637
  behaviors: false # unverified: needs behavior registration/execution capture
583
638
  mission_control: false # unverified: needs mission lifecycle capture
584
- daemon: false # unverified: ACP is separate and needs agent-stdio capture
639
+ daemon: false # deferred: ACP frame replay is not resident lifecycle qualification (grok-build-acp.test.ts)
585
640
  emulation:
586
641
  cron: null
587
642
  agent_teams: aiwg-mc
@@ -600,6 +655,14 @@ providers:
600
655
 
601
656
  hermes:
602
657
  display_name: Hermes
658
+ byok:
659
+ status: verified
660
+ settings:
661
+ - 'Key: OPENROUTER_API_KEY environment variable.'
662
+ - 'Provider/model: hermes chat --provider openrouter -m qwen/qwen3.8-27b; never rely on auto provider selection.'
663
+ verification: 'After approval, send "Reply with exactly: byok-ok" and inspect the Hermes log/session for the resolved model qwen/qwen3.8-27b under openrouter.'
664
+ notes: 'Operator live run, 2026-11-09 (#4054); manual CLI guidance does not change the AIWG direct-worker cleared environment or its dispatch status.'
665
+ docs: docs/providers/hermes-direct.md#bring-your-own-key
603
666
  route_feasibility:
604
667
  scope: in
605
668
  identity: runtime-configured-only
@@ -654,6 +717,13 @@ providers:
654
717
 
655
718
  muse:
656
719
  display_name: Muse Code
720
+ byok:
721
+ status: unverified
722
+ settings:
723
+ - 'Muse --provider / --model and harness settings select catalog models; an OpenRouter key setting is unverified. Do not invent an environment variable or endpoint flag.'
724
+ verification: 'First confirm upstream BYOK support without a paid call; after explicit approval of a supported route, send "Reply with exactly: byok-ok" and check the Muse session log for the resolved model.'
725
+ notes: 'Existing Muse notes cover the Meta model catalog only. Offer a verified Hermes, OpenCode or Copilot route when OpenRouter is required.'
726
+ docs: docs/agents/providers/muse.md
657
727
  route_feasibility:
658
728
  scope: in
659
729
  identity: runtime-configured-only
@@ -700,7 +700,7 @@
700
700
  "id": "copilot",
701
701
  "provider": "copilot",
702
702
  "adapterVersion": "1",
703
- "supportedVersions": "1.0.95",
703
+ "supportedVersions": "1.0.106",
704
704
  "runtimeDriver": "installed:copilot",
705
705
  "catalogAdapter": {
706
706
  "kind": "file",
@@ -711,10 +711,6 @@
711
711
  "kind": "process",
712
712
  "executable": "copilot",
713
713
  "argv": [
714
- "-p",
715
- "Follow the instructions in the attached file exactly.",
716
- "--attachment",
717
- "${brief}",
718
714
  "--model",
719
715
  "${model}",
720
716
  "--reasoning-effort",
@@ -727,9 +723,9 @@
727
723
  "--no-custom-instructions",
728
724
  "--disable-builtin-mcps"
729
725
  ],
730
- "stdin": "closed",
726
+ "stdin": "brief-text",
731
727
  "cwd": "${workspace}",
732
- "envAllowlist": ["PATH"],
728
+ "envAllowlist": ["PATH", "COPILOT_PROVIDER_BASE_URL", "COPILOT_PROVIDER_TYPE", "COPILOT_MODEL", "COPILOT_PROVIDER_API_KEY", "COPILOT_PROVIDER_API_KEY_COMMAND"],
733
729
  "versionArgv": [
734
730
  "--version"
735
731
  ],
@@ -754,7 +750,7 @@
754
750
  "invocationProfiles": {
755
751
  "direct-shell": {
756
752
  "transport": "shell",
757
- "supportedVersions": "1.0.95",
753
+ "supportedVersions": "1.0.106",
758
754
  "controls": {
759
755
  "model": {
760
756
  "support": "unqualified",
@@ -783,18 +779,18 @@
783
779
  },
784
780
  "finalOutput": {
785
781
  "support": "unqualified",
786
- "mapping": "stdout --output-format json (JSONL, one JSON object per line); no output-file flag carries the agent's final answer (--usage-output-file is usage statistics only and is not wired here)",
787
- "evidence": "H: copilot 1.0.95 --help / `copilot help <topic>`, captured 2026-10-10 (.aiwg/working/s1-scratch/cli-help/copilot-1.0.95.txt; never live qualification) ('--output-format <format> Output format: ... 'json' (JSONL, one JSON object per line)'; '--usage-output-file <file> Write final usage statistics as JSON')"
782
+ "mapping": "stdout JSONL: extract the last assistant.message data.content after assistant.turn_end/assistant.idle; reject malformed or error-shaped streams, then validate workerClaims against trusted process termination",
783
+ "evidence": "L: copilot 1.0.106 BYOK OpenRouter qwen/qwen3.8-27b, 2026-11-10 (#4088); sanitized captures test/fixtures/providers/copilot/copilot-stdin-only.jsonl and copilot-stdin.jsonl; model.call_final_result.data.isByok=true; single-turn stdin-only exact reply without tools"
788
784
  },
789
785
  "stdin": {
790
786
  "support": "unqualified",
791
- "mapping": "unavailable for the brief: -p/--prompt <text> only accepts inline argv text; the brief instead rides on --attachment <path> as a file, with -p fixed to a content-free instruction",
792
- "evidence": "H: copilot 1.0.95 --help / `copilot help <topic>`, captured 2026-10-10 (.aiwg/working/s1-scratch/cli-help/copilot-1.0.95.txt; never live qualification) ('-p, --prompt <text> Execute a prompt in non-interactive mode'; '--attachment <path> Attach a file (image or native document) to the initial prompt; only valid in non-interactive mode')"
787
+ "mapping": "brief-text: pipe the brief to EOF with no -p/--prompt or --attachment; 1.0.106 rejects Markdown attachments and ignores stdin when -p is present",
788
+ "evidence": "L: copilot 1.0.106 BYOK OpenRouter qwen/qwen3.8-27b, 2026-11-10 (#4088); sanitized captures test/fixtures/providers/copilot/copilot-stdin-only.jsonl and copilot-stdin.jsonl; model.call_final_result.data.isByok=true; single-turn stdin-only exact reply without tools"
793
789
  },
794
790
  "structuredOutput": {
795
791
  "support": "unqualified",
796
- "mapping": "unavailable: no output-schema flag is evidenced, and the --output-format json JSONL event vocabulary itself is not documented in --help; no event field name is invented",
797
- "evidence": "H: copilot 1.0.95 --help / `copilot help <topic>`, captured 2026-10-10 (.aiwg/working/s1-scratch/cli-help/copilot-1.0.95.txt; never live qualification)"
792
+ "mapping": "No output-schema flag is evidenced; assistant.message data.content is validated by the shared strict workerClaims parser",
793
+ "evidence": "L: copilot 1.0.106 BYOK OpenRouter qwen/qwen3.8-27b, 2026-11-10 (#4088); sanitized captures test/fixtures/providers/copilot/copilot-stdin-only.jsonl and copilot-stdin.jsonl; model.call_final_result.data.isByok=true; single-turn stdin-only exact reply without tools"
798
794
  },
799
795
  "stepCap": {
800
796
  "support": "unqualified",
@@ -817,15 +813,15 @@
817
813
  "evidence": "H: copilot 1.0.95 --help / `copilot help <topic>`, captured 2026-10-10 (.aiwg/working/s1-scratch/cli-help/copilot-1.0.95.txt; never live qualification) ('--auto-tier <preference> Set the Auto routing profile')"
818
814
  }
819
815
  },
820
- "envAllowlist": ["PATH"],
816
+ "envAllowlist": ["PATH", "COPILOT_PROVIDER_BASE_URL", "COPILOT_PROVIDER_TYPE", "COPILOT_MODEL", "COPILOT_PROVIDER_API_KEY", "COPILOT_PROVIDER_API_KEY_COMMAND"],
821
817
  "pitfalls": [
822
818
  "Documentation/help and synthetic observations are not authenticated live qualification.",
823
819
  "Unknown model, effort, permission or required step mappings block dispatch.",
824
820
  "Native MCP/client, MSP/ACP, gateway and conversation capabilities do not establish worker authority.",
825
- "The --output-format json JSONL event-type vocabulary is not documented in --help, and the installed binary is a compiled per-architecture native package with no readable bundled source (unlike e.g. Pi's JS bundle); no event-level health signal is evidenced, so observeHealthEvent always returns null and completion is exit-code gated only, EXCEPT one conservative guard: a line with a top-level 'type: \"error\"' or non-null 'error' field always fails the final, even at exit 0 (defensive synthetic-shape check, not an observed Copilot event).",
821
+ "Captured 1.0.106 assistant.message data.content supplies the final answer after assistant.turn_end/assistant.idle. Health remains process-only with no event-level health signal evidenced for progress; error-shaped lines fail even at exit zero.",
826
822
  "--allow-all-tools/--allow-all/--yolo are never emitted; a tool outside the resolved --allow-tool scope may still require interactive confirmation a non-interactive run cannot answer, and whether that fails closed or hangs is unqualified without a live run.",
827
823
  "--sandbox's OS-level command sandbox depends on host prerequisites (bwrap/slirp4netns/iptables on Linux) not probed here; this profile never emits it and relies on the CLI's default path restriction instead.",
828
- "Live qualification is an open S1 blocker: this profile has been exercised only against --help/--version/subcommand --help; the smoke command in docs/providers/copilot-direct.md is the first live check. Live attempt evidence (host noodle, 2026-10-10): COPILOT_GITHUB_TOKEN set to a classic ghp_ PAT exits 1 with 'Classic Personal Access Tokens (ghp_) are not supported by Copilot' on stderr and EMPTY stdout; a fine-grained PAT or prior copilot/gh login is required and the smoke run remains blocked on that."
824
+ "The 1.0.95 help-only attachment path is superseded by the 1.0.106 stdin-only BYOK capture (#4088). The old GitHub-account run on 2026-10-10 remains recorded as blocked: Classic Personal Access Tokens (ghp_) are not supported by Copilot. Other required controls remain unqualified."
829
825
  ],
830
826
  "health": {
831
827
  "version": 1,
@@ -834,7 +830,7 @@
834
830
  "signalParser": "provider-copilot-health-v1",
835
831
  "sessionLogLocator": null,
836
832
  "progressEvidence": [],
837
- "stopEvidence": "owned process identity and observed exit; the JSONL stream carries no evidenced error-event vocabulary, so completion is exit-code gated only, except a conservative guard that fails any line shaped 'type: \"error\"' or carrying a non-null top-level 'error' field even at exit 0",
833
+ "stopEvidence": "host-observed process exit and termination plus strict workerClaims validation of the settled assistant.message answer; error-shaped streams fail even at exit zero",
838
834
  "fixtureRef": "test/fixtures/providers/copilot/health/manifest.json",
839
835
  "qualifiedAt": null,
840
836
  "statusOperation": null,
@@ -842,7 +838,8 @@
842
838
  "coverage": "degraded",
843
839
  "qualificationTarget": "process-only",
844
840
  "evidenceGrades": [
845
- "H"
841
+ "H",
842
+ "D"
846
843
  ],
847
844
  "provenance": [
848
845
  {
@@ -850,6 +847,12 @@
850
847
  "ref": ".aiwg/working/s1-scratch/cli-help/copilot-1.0.95.txt",
851
848
  "observedAt": "2026-10-10T00:00:00Z",
852
849
  "cliVersion": "1.0.95"
850
+ },
851
+ {
852
+ "kind": "documentation",
853
+ "ref": "docs/providers/copilot-direct.md",
854
+ "observedAt": "2026-11-10T23:12:29Z",
855
+ "cliVersion": "1.0.106"
853
856
  }
854
857
  ],
855
858
  "qualificationOwner": "B-OG-36",
@@ -1157,8 +1160,8 @@
1157
1160
  },
1158
1161
  "effort": {
1159
1162
  "support": "unqualified",
1160
- "mapping": "[-r/--reasoning-effort LEVEL]; valid levels are model-dependent (exec --help 'Model details'); never the per-model default",
1161
- "evidence": "H: droid-cli 1.0.0 exec --help documents -r/--reasoning-effort <level> (defaults per model); unqualified until live evidence"
1163
+ "mapping": "[-r/--reasoning-effort LEVEL]; valid levels are model-dependent (exec --help 'Model details'); never the per-model default. Not enforceable for BYOK custom models: -r is ignored and the session reports reasoning_effort: none",
1164
+ "evidence": "H: droid-cli 1.0.0 exec --help documents -r/--reasoning-effort <level> (defaults per model); BYOK custom models ignore it (reasoning_effort: none), so effort is not enforceable; unqualified until live evidence"
1162
1165
  },
1163
1166
  "sandbox": {
1164
1167
  "support": "unqualified",
@@ -1309,7 +1312,7 @@
1309
1312
  "id": "opencode-direct",
1310
1313
  "provider": "opencode",
1311
1314
  "adapterVersion": "1",
1312
- "supportedVersions": "2.0.26",
1315
+ "supportedVersions": ">=1.18.0 <2.0.0 || >=2.0.26 <3.0.0",
1313
1316
  "runtimeDriver": "installed:opencode",
1314
1317
  "catalogAdapter": {
1315
1318
  "kind": "file",
@@ -1356,27 +1359,27 @@
1356
1359
  "invocationProfiles": {
1357
1360
  "direct-shell": {
1358
1361
  "transport": "shell",
1359
- "supportedVersions": "2.0.26",
1362
+ "supportedVersions": ">=1.18.0 <2.0.0 || >=2.0.26 <3.0.0",
1360
1363
  "controls": {
1361
1364
  "model": {
1362
1365
  "support": "unqualified",
1363
- "mapping": "-m/--model (opencode run --help: '--model, -m string Model to use in the format provider/model#variant')",
1364
- "evidence": "H: opencode 2.0.26 `opencode run --help` (captured 2026-10-10, .aiwg/working/s1-scratch/cli-help/opencode-2.0.26.txt)"
1366
+ "mapping": "1.x: -m/--model provider/model with separate --variant <effort>; 2.x: -m/--model (opencode run --help: '--model, -m string Model to use in the format provider/model#variant')",
1367
+ "evidence": "H: opencode 2.0.26 `opencode run --help` (captured 2026-10-10, .aiwg/working/s1-scratch/cli-help/opencode-2.0.26.txt); H: opencode 1.19.0 `opencode run --help` (titan, 2026-11-15): -m, --model model to use in the format of provider/model; --variant model variant (provider-specific reasoning effort, e.g., high, max, minimal)"
1365
1368
  },
1366
1369
  "effort": {
1367
1370
  "support": "unqualified",
1368
- "mapping": "explicit effort maps to a #<variant> suffix on --model (provider/model#variant); binary disassembly of the installed CLI (the variant-builder, minified as qU(model, manual)) shows variant ids are drawn directly from each model's own capabilities.supports.reasoning_effort list (e.g. low/medium/high), or fixed ids \"max\"/\"high\" for extended-thinking models exposing max_thinking_budget instead; the valid id set is model-specific and not enumerated here, so this adapter appends a syntactically valid id and the real CLI refuses one a given model does not expose",
1369
- "evidence": "R: conductor binary disassembly of the installed opencode 2.0.26 CLI (variant-builder function, host 'noodle', 2026-10-09), confirming H: opencode 2.0.26 `opencode run --help` ('--model, -m string Model to use in the format provider/model#variant')"
1371
+ "mapping": "1.x explicit effort maps to --variant <effort>; 2.x explicit effort maps to a #<variant> suffix on --model (provider/model#variant); binary disassembly of the installed CLI (the variant-builder, minified as qU(model, manual)) shows variant ids are drawn directly from each model's own capabilities.supports.reasoning_effort list (e.g. low/medium/high), or fixed ids \"max\"/\"high\" for extended-thinking models exposing max_thinking_budget instead; the valid id set is model-specific and not enumerated here, so this adapter appends a syntactically valid id and the real CLI refuses one a given model does not expose",
1372
+ "evidence": "R: conductor binary disassembly of the installed opencode 2.0.26 CLI (variant-builder function, host 'noodle', 2026-10-09), confirming H: opencode 2.0.26 `opencode run --help` ('--model, -m string Model to use in the format provider/model#variant'); H: opencode 1.19.0 `opencode run --help` (titan, 2026-11-15): --variant model variant (provider-specific reasoning effort, e.g., high, max, minimal)"
1370
1373
  },
1371
1374
  "sandbox": {
1372
1375
  "support": "unqualified",
1373
1376
  "mapping": "unavailable: no scoped sandbox flag on 'run'; the only permission-adjacent flag is --auto, a blanket approval bypass this profile never emits",
1374
- "evidence": "H: opencode 2.0.26 `opencode run --help` ('--auto Auto-approve permissions that are not explicitly denied')"
1377
+ "evidence": "H: opencode 2.0.26 `opencode run --help` ('--auto Auto-approve permissions that are not explicitly denied'); H: opencode 1.19.0 `opencode run --help` (titan, 2026-11-15): --auto auto-approve permissions that are not explicitly denied"
1375
1378
  },
1376
1379
  "approval": {
1377
1380
  "support": "unqualified",
1378
1381
  "mapping": "--auto ('Auto-approve permissions that are not explicitly denied') is a blanket bypass and is refused by policy; what a permission request does without --auto in non-interactive `run` is not independently confirmed: binary disassembly shows a shared permission.asked/permission.replied protocol where an unanswered request resolves to a \"reject\" outcome (`_===\"once\"||_===\"always\"?_:\"reject\"`, with requestPermission(...).catch(()=>{return}) on no responder), but that path is traced through the ACP/session-protocol layer, not reproduced against plain `run`, so this stays unavailable rather than asserted",
1379
- "evidence": "R: conductor binary disassembly of the installed opencode 2.0.26 CLI (permission.asked/permission.replied reject-on-no-answer pattern, host 'noodle', 2026-10-09), confirming H: opencode 2.0.26 `opencode run --help`"
1382
+ "evidence": "R: conductor binary disassembly of the installed opencode 2.0.26 CLI (permission.asked/permission.replied reject-on-no-answer pattern, host 'noodle', 2026-10-09), confirming H: opencode 2.0.26 `opencode run --help`; H: opencode 1.19.0 `opencode run --help` (titan, 2026-11-15): --auto auto-approve permissions that are not explicitly denied"
1380
1383
  },
1381
1384
  "workdir": {
1382
1385
  "support": "unqualified",
@@ -1386,7 +1389,7 @@
1386
1389
  "finalOutput": {
1387
1390
  "support": "unqualified",
1388
1391
  "mapping": "no --output/-o flag and no positive whole-run terminal event (binary disassembly: the run loop returns silently on session.execution.succeeded, in any mode); the final answer is the captured stdout --format json JSONL stream, accepted only when every line parses, no error event occurs, any present step_finish says \"stop\", and at least one text part has a recorded part.time.end (or a stop step_finish substitutes for that) -- a live 2.0.26 run confirmed a clean single-text-event stream with no step_start/step_finish at all",
1389
- "evidence": "H: opencode 2.0.26 `opencode run --help` ('--format choice Output format (choices: default, json)')"
1392
+ "evidence": "H: opencode 2.0.26 `opencode run --help` ('--format choice Output format (choices: default, json)'); H: opencode 1.19.0 `opencode run --help` (titan, 2026-11-15): --format default|json"
1390
1393
  },
1391
1394
  "stdin": {
1392
1395
  "support": "unqualified",
@@ -2599,7 +2602,7 @@
2599
2602
  "skill": "inherited",
2600
2603
  "globalChild": "native",
2601
2604
  "identifierSyntax": "Provider-local alias from grok inspect and $GROK_HOME config; distinct from API model id",
2602
- "inheritance": "Agent and skill roles resolve through the session model unless a validated Grok Build alias is selected",
2605
+ "inheritance": "Agents inherit the session model: Grok Build 1.0.77 ignores agent frontmatter model. AIWG role/tier intent is informational; select worker models with CLI -m. Fixture-backed test: test/unit/providers/grok-build-provider.test.ts. Skill roles inherit the session model.",
2603
2606
  "invalidPinFallback": "Report the unavailable alias; use the sole discovered model only when exactly one is available",
2604
2607
  "configTarget": "$GROK_HOME/config.toml [models] and [model.<alias>] (read-only discovery)",
2605
2608
  "artifactFormat": "Grok Build model alias",
@@ -2637,9 +2640,13 @@
2637
2640
  "--output-format",
2638
2641
  "streaming-json",
2639
2642
  "--no-subagents",
2643
+ "--disallowed-tools",
2644
+ "workflow",
2640
2645
  "--no-plan",
2641
2646
  "--no-alt-screen",
2642
- "--disable-web-search"
2647
+ "--disable-web-search",
2648
+ "--allow",
2649
+ "Bash(aiwg discover *)"
2643
2650
  ],
2644
2651
  "stdin": "closed",
2645
2652
  "cwd": "${workspace}",
@@ -2702,7 +2709,7 @@
2702
2709
  },
2703
2710
  "finalOutput": {
2704
2711
  "support": "unqualified",
2705
- "mapping": "stdout --output-format streaming-json (NDJSON, one ACP session update per line); the final 'end' event's stopReason plus concatenated 'text' chunks form the answer; no separate output-file flag is evidenced. NOTE: the SEPARATE, pre-existing src/providers/grok-build-headless.ts transport and its shared tools/ralph-external/lib/worker-health.mjs generic branch use a different, older message/result event shape and --output-format json (a single JSON object); this direct-shell profile's own observeHealthEvent/parseDirectFinal handle only the streaming-json/ACP shape and never touch that other path.",
2712
+ "mapping": "stdout --output-format streaming-json (NDJSON, one ACP session update per line); the final 'end' event's stopReason plus concatenated 'text' chunks form the answer; no separate output-file flag is evidenced. The separate src/providers/grok-build-headless.ts transport now defaults to streaming-json with captured 1.0.77 parser contracts; this direct-shell profile retains its own observeHealthEvent/parseDirectFinal.",
2706
2713
  "evidence": "H: grok 1.0.50 (c58f321264ba, stable) --help, captured 2026-10-10 (.aiwg/working/s1-scratch/cli-help/grok-1.0.50.txt); plus the installed binary's own bundled docs (strings-read, never live qualification; full extracts preserved in docs/providers/grok-build-cli-evidence.md) ('--output-format <OUTPUT_FORMAT> ... streaming-json: NDJSON: one ACP session update per line, the agent's native format'; bundled output-format doc gives the full event vocabulary and a worked example, preserved in the evidence file, confirming 'json' is a single object with text/stopReason/sessionId/requestId/usage fields -- NOT the message/result shape -- and 'streaming-json' is the ACP-derived text/thought/tool_call/tool_call_update/usage/plan/available_commands/end/error vocabulary)"
2707
2714
  },
2708
2715
  "stdin": {
@@ -2727,8 +2734,8 @@
2727
2734
  },
2728
2735
  "children": {
2729
2736
  "support": "unqualified",
2730
- "mapping": "--no-subagents (disables subagent spawning; denies hidden fan-out)",
2731
- "evidence": "H: grok 1.0.50 (c58f321264ba, stable) --help, captured 2026-10-10 (.aiwg/working/s1-scratch/cli-help/grok-1.0.50.txt); plus the installed binary's own bundled docs (strings-read, never live qualification; full extracts preserved in docs/providers/grok-build-cli-evidence.md) ('--no-subagents Disable subagent spawning')"
2737
+ "mapping": "--no-subagents --disallowed-tools workflow (1.0.77 capture: workflow can spawn children despite --no-subagents; combined argv tested in grok-build-direct.test.ts; live-verified on 1.0.77 2026-11-10: no spawn_subagent or workflow call and no subagent records)",
2738
+ "evidence": "H: grok 1.0.50 (c58f321264ba, stable) --help, captured 2026-10-10 (.aiwg/working/s1-scratch/cli-help/grok-1.0.50.txt); plus the installed binary's own bundled docs (strings-read, never live qualification; full extracts preserved in docs/providers/grok-build-cli-evidence.md) ('--no-subagents Disable subagent spawning'); 2026-11-10 1.0.77 capture correction: test/fixtures/providers/grok-build/captured-20261110/permissions.json replayed by test/unit/providers/grok-build-headless.test.ts demonstrates workflow bypass; both flags required in rendered argv"
2732
2739
  },
2733
2740
  "fallback": {
2734
2741
  "support": "unqualified",
@@ -2745,10 +2752,11 @@
2745
2752
  "Documentation/help and synthetic observations are not authenticated live qualification.",
2746
2753
  "Unknown model, effort, permission or required step mappings block dispatch.",
2747
2754
  "Native MCP/client, MSP/ACP, gateway and conversation capabilities do not establish worker authority.",
2748
- "The separate, pre-existing src/providers/grok-build-headless.ts transport and the generic grok-build branch in tools/ralph-external/lib/worker-health.mjs use --output-format json and an older message/result event shape; this profile's streaming-json/ACP grammar is independent and does not change that path or its consumers.",
2755
+ "The separate src/providers/grok-build-headless.ts transport defaults to streaming-json and also parses captured json and streaming-messages-json; this direct profile retains its independent streaming-json parser.",
2749
2756
  "No --no-ask-user-equivalent flag is listed in the captured root --help for this version (an internal no-ask-user arg name exists in the compiled binary's own strings but is not printed help text), so it is never emitted; whether an ask_user_question tool call blocks indefinitely under dontAsk in a non-interactive run is unqualified, not invented away.",
2750
2757
  "--always-approve and --permission-mode bypassPermissions are never emitted; a scoped --allow/--deny rule value, or the model/effort value, starting with '-' or containing whitespace/control characters is refused by the driver before argv is built.",
2751
2758
  "Permission-mode and sandbox-profile semantics are quoted directly from the installed binary's own bundled documentation (see docs/providers/grok-build-cli-evidence.md for the full extracts, strings command and binary version/hash); where that documentation does not settle a question (e.g. ask_user_question behavior under dontAsk), the control stays unqualified rather than assumed safe.",
2759
+ "1.0.77 captured permissions (2026-11-10): default headless cancels spawn_subagent and workflow because a headless run cannot ask for approval; --allow spawn_subagent did not cover them. --permission-mode auto ran them, but AIWG keeps its existing permission defaults. Evidence: test/fixtures/providers/grok-build/captured-20261110/permissions.json; test/unit/providers/grok-build-headless.test.ts. ACP authMethods, logged-in session/new, end_turn usage, compact notifications and cancelled/MidTurnAbort are replayed in grok-build-acp.test.ts; live ACP dispatch qualification remains deferred. Native -w creates standalone copies under ~/.grok/worktrees/<slug>/<name>, not git worktrees; ownership/recovery list parsing is tested in grok-build-dispatch.test.ts. The combined flags were verified live on 1.0.77 (2026-11-10: no spawn_subagent or workflow call, no subagent records); compatibility with the older pinned 1.0.50 direct profile remains unverified.",
2752
2760
  "Live qualification is an open S1 blocker: this profile has been exercised only against --help/--version/subcommand --help plus strings-read bundled docs, never a live prompted run. The smoke command in docs/providers/grok-build-direct.md is the first live check and needs an XAI_API_KEY (or cached grok login) from the operator."
2753
2761
  ],
2754
2762
  "health": {
package/bin/aiwg.mjs CHANGED
@@ -214,7 +214,7 @@ const FAST_HELP_TEXT = `
214
214
  --use-stable Switch back to stable npm package
215
215
  ────────────────────────────────────────────────────────
216
216
 
217
- Providers: 12 — claude (default), codex, copilot, cursor, factory, hermes, opencode, openclaw, openhuman, pi, warp, windsurf (alias: devin)
217
+ {{PROVIDERS}}
218
218
 
219
219
  Examples:
220
220
  aiwg use sdlc Install SDLC framework
@@ -227,10 +227,11 @@ const FAST_HELP_TEXT = `
227
227
  aiwg refresh Pull latest + redeploy frameworks
228
228
  `;
229
229
 
230
- function maybeHandleFastHelp(args) {
230
+ async function maybeHandleFastHelp(args) {
231
231
  if (args.length !== 1) return false;
232
232
  if (!['help', '--help', '-help', '-h'].includes(args[0])) return false;
233
- process.stdout.write(`${FAST_HELP_TEXT}\n`);
233
+ const { generateProviderHelp } = await import('../dist/src/cli/help-generator.js');
234
+ process.stdout.write(`${FAST_HELP_TEXT.replace('{{PROVIDERS}}', generateProviderHelp())}\n`);
234
235
  return true;
235
236
  }
236
237
 
@@ -268,6 +269,7 @@ maybeWarnUnbuiltDist();
268
269
  // installation/channel state before the command context exists.
269
270
  function isReadOnlyReport(args) {
270
271
  return (args[0] === 'memory' && (['audit', 'cost', 'recommend', 'plan', 'verify'].includes(args[1]) || args.includes('--preview') || args.includes('--help') || args.includes('-h')))
272
+ || (['marketplace', 'market'].includes(args[0]) && args[1] === 'search' && args.includes('--plugins'))
271
273
  || (args[0] === 'help' && args[1] === 'memory')
272
274
  || (args[0] === 'rules' && ['inventory', 'list'].includes(args[1]))
273
275
  || (['doctor', '-doctor', '--doctor'].includes(args[0]) && args.includes('--decision-offload'))
@@ -381,7 +383,7 @@ if (indexRefresh || readOnlyReport) {
381
383
  if (maybeHandleFastVersion(cliArgs)) {
382
384
  process.exit(0);
383
385
  }
384
- if (maybeHandleFastHelp(cliArgs)) {
386
+ if (await maybeHandleFastHelp(cliArgs)) {
385
387
  process.exit(0);
386
388
  }
387
389
 
@@ -11,7 +11,7 @@
11
11
  * backend, byte-identical to the legacy `echo >> .aiwg/activity.log`
12
12
  * pattern documented in the activity-log skill.
13
13
  *
14
- * @design @.aiwg/architecture/storage-design.md (§4, §8.2)
14
+ * @design @docs/storage/overview.md
15
15
  * @issue #934
16
16
  * @issue #964
17
17
  */
@@ -4,7 +4,7 @@
4
4
  * Core deployment engine for multi-platform agent deployment.
5
5
  *
6
6
  * @implements @.aiwg/requirements/use-cases/UC-002-deploy-sdlc-framework.md
7
- * @architecture @.aiwg/architecture/software-architecture-doc.md - Section 2.1 CLI Entry Point
7
+ * @architecture @docs/architecture/cli/index.md
8
8
  * @nfr @.aiwg/requirements/nfr-modules/performance.md - NFR-PERF-002 (<10s deployment)
9
9
  * @tests @test/unit/agents/agent-deployer.test.ts
10
10
  * @depends @src/agents/agent-validator.ts
@@ -2,7 +2,7 @@
2
2
  * Drift audit — type definitions.
3
3
  *
4
4
  * @implements #1208
5
- * @see .aiwg/architecture/adr-rlm-index-features-impl-plan.md
5
+ * @see docs/architecture/index-and-manifest-loading.md
6
6
  */
7
7
  export const DEFAULT_THRESHOLDS = {
8
8
  keywordOverlapMin: 0.70,
@@ -18,7 +18,7 @@
18
18
  * Design notes:
19
19
  * - Facets are *curated*, not learned — appropriate at this corpus size and
20
20
  * portable across all 10 providers (no embedding store, no fine-tuned
21
- * router). See `.aiwg/architecture/adr-steward-feature-discoverability.md`.
21
+ * router). See `docs/architecture/cli/discovery.md`.
22
22
  * - Mapped capabilities are matched against an entry's canonical `name`
23
23
  * (falling back to the path basename / parent-dir slug), so the table lists
24
24
  * names — not paths — and survives bundle moves.
@@ -7,7 +7,7 @@
7
7
  * previously-enriched artifact.
8
8
  *
9
9
  * @implements #1204
10
- * @see .aiwg/architecture/adr-rlm-index-features-impl-plan.md
10
+ * @see docs/architecture/index-and-manifest-loading.md
11
11
  */
12
12
  export const ENRICHMENT_PROMPT = `Read the artifact below. Return JSON matching this schema exactly:
13
13
 
@@ -6,7 +6,7 @@
6
6
  * `aiwg index query` when enrichment is present.
7
7
  *
8
8
  * @implements #1204
9
- * @see .aiwg/architecture/adr-rlm-index-features-impl-plan.md
9
+ * @see docs/architecture/index-and-manifest-loading.md
10
10
  */
11
11
  export {};
12
12
  //# sourceMappingURL=types.js.map
@@ -162,7 +162,9 @@ function addDependencyEdge(depGraph, entries, sourcePath, targetPath, type) {
162
162
  /**
163
163
  * Extract title from content (first # heading or frontmatter title)
164
164
  */
165
- function extractTitle(data, body) {
165
+ function extractTitle(data, body, type) {
166
+ if (type === 'agent' && typeof data.name === 'string' && data.name.trim())
167
+ return data.name.trim();
166
168
  if (typeof data.title === 'string')
167
169
  return data.title;
168
170
  const headingMatch = body.match(/^#\s+(.+)$/m);
@@ -876,7 +878,7 @@ function extractIndexArtifact(job, bindingOnly, warnings = []) {
876
878
  const physicalType = inferType({ ...data, type: undefined }, relativePath);
877
879
  const runbook = flow || decision || gatePack ? null : parseRunbookDoc(data, body, relativePath);
878
880
  const schemaDoc = inferredType === 'schema' ? parseSchemaDoc(content, relativePath) : null;
879
- const title = flow?.name ?? decision?.name ?? gatePack?.name ?? schemaDoc?.title ?? extractTitle(data, body);
881
+ const title = flow?.name ?? decision?.name ?? gatePack?.name ?? schemaDoc?.title ?? extractTitle(data, body, inferredType);
880
882
  const phase = typeof data.phase === 'string' ? data.phase : inferPhase(relativePath);
881
883
  const type = flow?.type ?? decision?.type ?? gatePack?.type ?? (runbook ? 'runbook' : inferredType);
882
884
  // Binding resolution consumes only identity and title. Keep the same canonical
@@ -86,13 +86,13 @@ export function compoundGoverningRules(entries, target, relations, phrase = '',
86
86
  }
87
87
  if (includeMatches) {
88
88
  const query = phrase.toLowerCase();
89
- const queryPaths = (phrase.replace(/\\/g, '/').match(/[\w@./*?-]+/g) ?? []).map(value => value.replace(/[.,;:!?]+$/, ''));
90
89
  const corpus = relations ? relationMetadata(relations) : [];
91
90
  const rules = new Map([...corpus, ...entries.filter(entry => ['rule', 'behavior'].includes(entry.type))]
92
91
  .map(rule => [`${rule.type}:${rule.path}`, rule]));
93
92
  for (const rule of rules.values()) {
93
+ // Search prose is never path context; only declared governed paths activate path rules.
94
94
  for (const glob of rule.rulePaths ?? [])
95
- for (const candidate of [...queryPaths.filter(value => /[./*?]/.test(value) || value === glob), ...(target.governedPaths ?? [])]) {
95
+ for (const candidate of target.governedPaths ?? []) {
96
96
  if (minimatch(candidate, glob, { dot: true, nonegate: true, nocomment: true })
97
97
  || ((target.governedPaths ?? []).includes(candidate) && minimatch(glob, candidate, { dot: true, nonegate: true, nocomment: true })))
98
98
  add(rule, `path:${candidate}`);
@@ -110,7 +110,7 @@ export const INDEX_VERSION = '1.0.0';
110
110
  * making the serialized index schema incompatible; a mismatch simply forces a
111
111
  * one-time content re-extraction during the next incremental build.
112
112
  */
113
- export const INDEX_EXTRACTOR_VERSION = '2026.11.09.1';
113
+ export const INDEX_EXTRACTOR_VERSION = '2026.11.10.1';
114
114
  /**
115
115
  * Built-in graph definitions
116
116
  */
@@ -2,7 +2,7 @@
2
2
  * View definition parser and validator.
3
3
  *
4
4
  * @implements #1207
5
- * @see .aiwg/architecture/adr-rlm-index-features-impl-plan.md
5
+ * @see docs/architecture/index-and-manifest-loading.md
6
6
  */
7
7
  import { load as loadYaml, dump as dumpYaml } from 'js-yaml';
8
8
  const VALID_AGGREGATES = [
@@ -2,7 +2,7 @@
2
2
  * Materialized index views — type definitions.
3
3
  *
4
4
  * @implements #1207
5
- * @see .aiwg/architecture/adr-rlm-index-features-impl-plan.md
5
+ * @see docs/architecture/index-and-manifest-loading.md
6
6
  */
7
7
  export {};
8
8
  //# sourceMappingURL=types.js.map
@@ -6,7 +6,7 @@
6
6
  * - info: Show detailed model information
7
7
  * - search: Search models by query
8
8
  *
9
- * @implements @.aiwg/architecture/enhanced-model-selection-design.md#9-model-catalog-system
9
+ * @implements @docs/models/supported-models.md
10
10
  * @module src/catalog/cli
11
11
  */
12
12
  import { loadCatalog, getModel, listModels, getProvider, searchModels, } from './loader.js';
@@ -6,7 +6,7 @@
6
6
  * - info: Show detailed model information
7
7
  * - search: Search models by query
8
8
  *
9
- * @implements @.aiwg/architecture/enhanced-model-selection-design.md#9-model-catalog-system
9
+ * @implements @docs/models/supported-models.md
10
10
  * @module src/catalog/cli
11
11
  */
12
12
 
@@ -8,7 +8,7 @@
8
8
  *
9
9
  * Merge priority: custom > discovered > builtin
10
10
  *
11
- * @implements @.aiwg/architecture/enhanced-model-selection-design.md#9-model-catalog-system
11
+ * @implements @docs/models/supported-models.md
12
12
  * @module src/catalog/loader
13
13
  */
14
14
  import { readFile } from 'fs/promises';