@aiwg/cli 2026.11.5 → 2026.11.7

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 (201) hide show
  1. package/agentic/code/providers/model-capabilities.v1.json +9 -9
  2. package/bin/aiwg.mjs +6 -4
  3. package/dist/src/activity-log/cli.js +1 -1
  4. package/dist/src/agents/agent-deployer.js +1 -1
  5. package/dist/src/artifacts/audit/types.js +1 -1
  6. package/dist/src/artifacts/browser-export.js +1 -0
  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/fortemi-core-query-adapter.js +2 -0
  11. package/dist/src/artifacts/index-builder.js +1 -0
  12. package/dist/src/artifacts/query-engine-discover-output.js +1 -0
  13. package/dist/src/artifacts/query-engine-discover.js +2 -2
  14. package/dist/src/artifacts/query-engine-scoring.js +7 -0
  15. package/dist/src/artifacts/template-output-kind.js +10 -0
  16. package/dist/src/artifacts/types.js +1 -1
  17. package/dist/src/artifacts/views/definition.js +1 -1
  18. package/dist/src/artifacts/views/types.js +1 -1
  19. package/dist/src/catalog/cli.js +1 -1
  20. package/dist/src/catalog/cli.mjs +1 -1
  21. package/dist/src/catalog/loader.js +1 -1
  22. package/dist/src/catalog/loader.mjs +1 -1
  23. package/dist/src/catalog/types.js +1 -1
  24. package/dist/src/cli/cli-extension-loader.js +19 -5
  25. package/dist/src/cli/cli-extension-paths.js +65 -0
  26. package/dist/src/cli/handlers/best-practices-audit.js +1 -1
  27. package/dist/src/cli/handlers/dataset.js +11 -2
  28. package/dist/src/cli/handlers/help.js +3 -4
  29. package/dist/src/cli/handlers/index.js +1 -1
  30. package/dist/src/cli/handlers/marketplace-plugin-search.js +37 -0
  31. package/dist/src/cli/handlers/marketplace.js +3 -1
  32. package/dist/src/cli/handlers/models.js +1 -1
  33. package/dist/src/cli/handlers/ralph-launcher.js +8 -2
  34. package/dist/src/cli/handlers/ralph.js +1 -1
  35. package/dist/src/cli/handlers/runtime-info.js +1 -1
  36. package/dist/src/cli/handlers/scaffolding.js +2 -2
  37. package/dist/src/cli/handlers/script-runner.js +1 -1
  38. package/dist/src/cli/handlers/sdlc-accelerate.js +1 -1
  39. package/dist/src/cli/handlers/subcommands-bundles.js +1 -1
  40. package/dist/src/cli/handlers/subcommands-list-format.js +19 -1
  41. package/dist/src/cli/handlers/types.js +1 -1
  42. package/dist/src/cli/handlers/update.js +26 -12
  43. package/dist/src/cli/handlers/use.js +6 -5
  44. package/dist/src/cli/handlers/utilities.js +1 -1
  45. package/dist/src/cli/handlers/version.js +1 -1
  46. package/dist/src/cli/handlers/workspace.js +1 -1
  47. package/dist/src/cli/handlers/writing.js +7 -1
  48. package/dist/src/cli/help-generator.js +9 -11
  49. package/dist/src/cli/hooks/builtin/activity-log-hook.js +1 -1
  50. package/dist/src/cli/router.js +1 -1
  51. package/dist/src/cli/workflow-orchestrator.js +1 -1
  52. package/dist/src/config/worker-context.js +37 -7
  53. package/dist/src/config/worker-parallelism.js +11 -0
  54. package/dist/src/contributors/detect.js +1 -1
  55. package/dist/src/contributors/discover.js +1 -1
  56. package/dist/src/contributors/heuristic.js +1 -1
  57. package/dist/src/contributors/index.js +1 -1
  58. package/dist/src/contributors/types.js +1 -1
  59. package/dist/src/contributors/validation.js +1 -1
  60. package/dist/src/dataset/backend-selection.d.ts +3 -0
  61. package/dist/src/dataset/backend-selection.js +11 -0
  62. package/dist/src/dataset/contract-range.d.ts +7 -0
  63. package/dist/src/dataset/contract-range.js +55 -0
  64. package/dist/src/dataset/fortemi-execution-bridge.d.ts +2 -0
  65. package/dist/src/dataset/fortemi-execution-bridge.js +12 -1
  66. package/dist/src/dataset/index.d.ts +2 -0
  67. package/dist/src/dataset/index.js +2 -0
  68. package/dist/src/dataset/orchestration-service.d.ts +1 -1
  69. package/dist/src/dataset/orchestration-service.js +7 -8
  70. package/dist/src/dataset/orchestration-types.d.ts +2 -0
  71. package/dist/src/dataset/service-binding-checkpoints.d.ts +10 -0
  72. package/dist/src/dataset/service-binding-checkpoints.js +26 -0
  73. package/dist/src/dataset/service-binding-contract.d.ts +46 -0
  74. package/dist/src/dataset/service-binding-contract.js +25 -0
  75. package/dist/src/dataset/service-binding-registry.d.ts +12 -0
  76. package/dist/src/dataset/service-binding-registry.js +118 -0
  77. package/dist/src/effects/worker-delivery.js +83 -0
  78. package/dist/src/extensions/capability-index.js +1 -1
  79. package/dist/src/extensions/commands/definitions.js +2 -2
  80. package/dist/src/extensions/deployment-registration.js +1 -1
  81. package/dist/src/extensions/index.js +1 -1
  82. package/dist/src/extensions/loader.js +1 -1
  83. package/dist/src/extensions/manifest.js +27 -9
  84. package/dist/src/extensions/project-local-activity.js +1 -1
  85. package/dist/src/extensions/project-local-discovery.js +2 -2
  86. package/dist/src/extensions/project-local-doctor.js +9 -4
  87. package/dist/src/extensions/project-local-promote.js +3 -3
  88. package/dist/src/extensions/project-local-remove.js +3 -3
  89. package/dist/src/extensions/project-local-scaffold.js +1 -1
  90. package/dist/src/extensions/project-quickref-discovery.js +11 -0
  91. package/dist/src/extensions/project-quickref.js +4 -7
  92. package/dist/src/extensions/registry.js +1 -1
  93. package/dist/src/extensions/shadow-resolver.js +1 -1
  94. package/dist/src/extensions/types.js +1 -1
  95. package/dist/src/extensions/upstream-registry.js +1 -1
  96. package/dist/src/extensions/validation.js +1 -1
  97. package/dist/src/intake/git-history-analyzer.js +1 -1
  98. package/dist/src/kb/cli.js +1 -1
  99. package/dist/src/marketplace/plugin-directory.js +36 -0
  100. package/dist/src/marketplace/plugin-search.js +180 -0
  101. package/dist/src/mcp/cli.mjs +2 -2
  102. package/dist/src/mcp/helpers.mjs +1 -1
  103. package/dist/src/mcp/http-tools.mjs +8 -6
  104. package/dist/src/mcp/http-transport.mjs +3 -1
  105. package/dist/src/mcp/server.mjs +1 -1
  106. package/dist/src/mcp/tools/command-run.mjs +1 -1
  107. package/dist/src/mcp/tools/discovery.mjs +1 -1
  108. package/dist/src/mcp/tools/subsystems.mjs +1 -1
  109. package/dist/src/mcp/tools/worker-invoke.mjs +71 -23
  110. package/dist/src/mcp/tools/worker-launch-ledger.mjs +33 -0
  111. package/dist/src/mcp/tools/worker-local-only-preflight.mjs +79 -0
  112. package/dist/src/mcp/tools/worker-recorded-launch.mjs +26 -0
  113. package/dist/src/mcp/tools/worker-stdin-runtime.mjs +33 -6
  114. package/dist/src/mcp/tools/worker-verify-deliver-schema.mjs +49 -0
  115. package/dist/src/mcp/tools/worker-verify-deliver.mjs +25 -0
  116. package/dist/src/models/catalog-policy.js +2 -2
  117. package/dist/src/models/conductor-data-policy.mjs +83 -14
  118. package/dist/src/models/config-loader.js +2 -2
  119. package/dist/src/models/index.js +2 -2
  120. package/dist/src/models/local-endpoint-models.js +155 -0
  121. package/dist/src/models/model-capabilities.v1.json +9 -9
  122. package/dist/src/models/model-discovery.js +9 -5
  123. package/dist/src/models/opencode-worker-model.mjs +16 -0
  124. package/dist/src/models/resolver.js +2 -2
  125. package/dist/src/models/worker-installation.mjs +5 -3
  126. package/dist/src/models/worker-plan.js +1 -1
  127. package/dist/src/plugin/plugin-installer.js +2 -2
  128. package/dist/src/plugin/registry-validator.js +2 -2
  129. package/dist/src/plugin/skill-command-translator.js +1 -1
  130. package/dist/src/providers/deployment-input-session.d.mts +2 -0
  131. package/dist/src/providers/deployment-input-session.mjs +38 -0
  132. package/dist/src/rlm/cache/hash.js +1 -1
  133. package/dist/src/rlm/cache/store.js +1 -1
  134. package/dist/src/rlm/cache/types.js +1 -1
  135. package/dist/src/serve/worker-invocation-preparation.js +54 -22
  136. package/dist/src/serve/worker-invocation.js +25 -8
  137. package/dist/src/serve/worker-shell-prompt.d.mts +6 -0
  138. package/dist/src/serve/worker-shell-prompt.mjs +78 -0
  139. package/dist/src/skills/run.js +0 -11
  140. package/dist/src/smiths/agentsmith/generator.js +1 -1
  141. package/dist/src/smiths/context-pipeline/index.js +1 -1
  142. package/dist/src/smiths/context-pipeline/provider-policy.js +1 -1
  143. package/dist/src/smiths/context-pipeline/types.js +1 -1
  144. package/dist/src/smiths/mcpsmith/analyzers/cli-analyzer.js +2 -2
  145. package/dist/src/smiths/mcpsmith/generator.js +2 -2
  146. package/dist/src/smiths/mcpsmith/index.js +2 -2
  147. package/dist/src/smiths/mcpsmith/types.js +2 -2
  148. package/dist/src/smiths/skillsmith/collision-detector.js +1 -1
  149. package/dist/src/smiths/skillsmith/namespace-adapter.js +1 -1
  150. package/dist/src/smiths/toolsmith/runtime-discovery.mjs +2 -2
  151. package/dist/src/smiths/toolsmith/types.js +2 -2
  152. package/dist/src/storage/backends/fortemi.js +1 -1
  153. package/dist/src/storage/backends/fs.js +1 -1
  154. package/dist/src/storage/backends/logseq.js +1 -1
  155. package/dist/src/storage/backends/obsidian.js +1 -1
  156. package/dist/src/storage/cli.js +2 -2
  157. package/dist/src/storage/config.js +1 -1
  158. package/dist/src/storage/index.js +1 -1
  159. package/dist/src/storage/subsystem-cli.js +1 -1
  160. package/dist/src/storage/types.js +1 -1
  161. package/dist/src/testing/generators/test-case-generator.js +1 -1
  162. package/dist/src/writing/campaign-patterns.js +96 -0
  163. package/dist/src/writing/campaign-report.js +41 -0
  164. package/dist/src/writing/contextual-diagnostics.js +29 -5
  165. package/dist/src/writing/current-patterns.catalogue.json +87 -0
  166. package/dist/src/writing/current-patterns.js +99 -0
  167. package/dist/src/writing/prose-mask.js +80 -0
  168. package/dist/src/writing/structural-patterns.js +109 -0
  169. package/dist/src/writing/validation-campaign.js +19 -0
  170. package/dist/src/writing/validation-engine.js +18 -11
  171. package/dist/src/writing/validation-rules.js +4 -3
  172. package/package.json +11 -1
  173. package/schemas/dataset/service-binding.v1.schema.json +70 -0
  174. package/schemas/models/model-catalog.v1.schema.json +6 -3
  175. package/tools/agents/providers/base-models-platforms.mjs +87 -48
  176. package/tools/agents/providers/conductor-data-guard.mjs +1 -1
  177. package/tools/agents/providers/rule-deployment-corpus-inputs.mjs +19 -0
  178. package/tools/agents/providers/rule-deployment-input-session.mjs +40 -0
  179. package/tools/agents/providers/rule-deployment-prepare.mjs +15 -6
  180. package/tools/plugin/package-plugins.mjs +2 -0
  181. package/tools/ralph-external/lib/mcp-worker-launch.mjs +67 -0
  182. package/tools/ralph-external/lib/opencode-adapter.mjs +9 -7
  183. package/tools/ralph-external/lib/trusted-verification.mjs +1021 -0
  184. package/tools/ralph-external/lib/typed-stop-delivery.mjs +55 -0
  185. package/tools/ralph-external/lib/verification-isolation.mjs +509 -0
  186. package/tools/ralph-external/lib/worker-context.mjs +3 -3
  187. package/tools/ralph-external/lib/worker-delivery-guards.mjs +141 -0
  188. package/tools/ralph-external/lib/worker-delivery-record.mjs +15 -0
  189. package/tools/ralph-external/lib/worker-final.mjs +4 -1
  190. package/tools/ralph-external/lib/worker-isolation-status.mjs +3 -0
  191. package/tools/ralph-external/lib/worker-launch-cli.mjs +8 -0
  192. package/tools/ralph-external/lib/worker-local-only-paths.mjs +45 -0
  193. package/tools/ralph-external/lib/worker-prompt.mjs +4 -1
  194. package/tools/ralph-external/lib/worker-retry-evidence.mjs +2 -1
  195. package/tools/ralph-external/lib/worker-run-directory-refusal.mjs +2 -1
  196. package/tools/ralph-external/lib/worker-run-directory.mjs +45 -0
  197. package/tools/ralph-external/lib/worker-unit-cleanup.mjs +10 -2
  198. package/tools/ralph-external/lib/worker-verification-cli.mjs +164 -0
  199. package/tools/ralph-external/lib/worktree-preparation.mjs +417 -0
  200. package/tools/ralph-external/session-launcher.mjs +8 -15
  201. package/vscode-extension/schemas/aiwg.config.v1.json +27 -0
@@ -6,7 +6,7 @@
6
6
  * order does not affect the resulting hash.
7
7
  *
8
8
  * @implements #1203
9
- * @see .aiwg/architecture/adr-rlm-index-features-impl-plan.md
9
+ * @see docs/architecture/index-and-manifest-loading.md
10
10
  */
11
11
  import { createHash } from 'node:crypto';
12
12
  /** Compute a stable sha256 hex hash for a cache key. */
@@ -8,7 +8,7 @@
8
8
  * └── metadata.json
9
9
  *
10
10
  * @implements #1203
11
- * @see .aiwg/architecture/adr-rlm-index-features-impl-plan.md
11
+ * @see docs/architecture/index-and-manifest-loading.md
12
12
  */
13
13
  import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync, } from 'node:fs';
14
14
  import { join } from 'node:path';
@@ -2,7 +2,7 @@
2
2
  * RLM Result Cache — Type Definitions
3
3
  *
4
4
  * @implements #1203
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
@@ -1,9 +1,13 @@
1
1
  /** Validate and render a prepared invocation against trusted installation controls. */
2
2
  import path from 'node:path';
3
+ import { findPackageRoot } from '../cli/find-package-root.js';
4
+ import { workerOutputPaths } from './worker-invocation-paths.js';
3
5
  import { directWorkerEnvironment } from '../config/worker-attribution.mjs';
4
6
  import { createHash } from 'node:crypto';
7
+ import { existsSync } from 'node:fs';
5
8
  import { fileURLToPath } from 'node:url';
6
9
  import { validateWorkerArtifacts } from './worker-artifacts.mjs';
10
+ import { shellWorkerPromptPath, shellWorkerArtifactsRefusal } from './worker-shell-prompt.mjs';
7
11
  import { assertValidWorkerPayload } from '../mission-protocol/codecs.js';
8
12
  import { qualificationDigest } from '../models/qualification-digest.mjs';
9
13
  import { qualifyWorkerInvocationProfile, assertOperatorWorkerNativeArgv, assertWorkerSelectionAllowed, assertWorkerLaunchMode, requiresWorkerExternalBoundary, assertWorkerHealthQualification, WorkerPolicyError, DEFAULT_WORKER_SELECTION } from '../models/provider-policy.js';
@@ -19,6 +23,11 @@ import { qualifyWorkerInvocationProfile, assertOperatorWorkerNativeArgv, assertW
19
23
  export function mcpToolSchemaDigest(schema) {
20
24
  return `sha256:${createHash('sha256').update(JSON.stringify(schema)).digest('hex')}`;
21
25
  }
26
+ /** JSON plans retain launcher/MCP support; only raw shell artifact delivery is refused. */
27
+ export class WorkerShellArtifactsError extends WorkerPolicyError {
28
+ pointer = '/request/format';
29
+ constructor() { super('OG_ADAPTER_UNQUALIFIED', shellWorkerArtifactsRefusal); }
30
+ }
22
31
  export async function prepareWorkerInvocation(invocation, qualification) {
23
32
  const result = structuredClone(invocation);
24
33
  validateWorkerArtifacts(result);
@@ -108,30 +117,53 @@ export async function prepareWorkerInvocation(invocation, qualification) {
108
117
  const deadline = qualification.ceilings?.wallSeconds === undefined ? ''
109
118
  : `timeout --signal=KILL ${quote(`${Math.min(result.health?.hardTimeoutSeconds ?? Infinity, result.limits.wallSeconds)}s`)} `;
110
119
  const markers = Object.entries(directWorkerEnvironment(result)).map(([name, value]) => `${name}=${quote(value)}`).join(' ');
111
- const worker = `${deadline}env -i${environment ? ` ${environment}` : ''} ${markers} ${result.argv.map(quote).join(' ')}`;
112
- const outputs = `> ${quote(result.stdoutPath)} 2> ${quote(result.stderrPath)}`;
113
- if (result.stdin === 'brief-json') {
114
- const framer = fileURLToPath(new URL('./worker-stdin-frame.mjs', import.meta.url));
115
- const frame = [process.execPath, framer, result.briefPath, result.selected.model, result.cwd].map(quote).join(' ');
116
- result.shellCommand = `cd ${quote(result.cwd)} && env -i ${frame} | ${worker} ${outputs}`;
117
- }
118
- else if (result.stdin === 'adapter-frame') {
119
- const binding = qualification.stdinFramerBinding;
120
- if (!binding || !absolute(binding.storePath) || !/^sha256:[a-f0-9]{64}$/.test(binding.storeDigest)) {
121
- throw new Error('Adapter stdin framer requires a trusted installation binding');
122
- }
123
- const framer = fileURLToPath(new URL('./worker-stdin-frame.mjs', import.meta.url));
124
- const frame = [process.execPath, framer, '--adapter-frame', result.briefPath, result.cwd,
125
- result.selected.cli, qualification.adapterId, result.selected.qualificationDigest, result.briefDigest,
126
- binding.storePath, binding.storeDigest, JSON.stringify(qualification.policy ?? null), result.selected.model].map(quote).join(' ');
127
- result.shellCommand = `cd ${quote(result.cwd)} && env -i${environment ? ` ${environment}` : ''} ${frame} | ${worker} ${outputs}`;
128
- }
129
- else if (result.stdin === 'closed' || result.stdin === 'brief-text') {
130
- const stdin = result.stdin === 'closed' ? '< /dev/null' : `< ${quote(result.briefPath)}`;
131
- result.shellCommand = `cd ${quote(result.cwd)} && ${worker} ${stdin} ${outputs}`;
120
+ const root = findPackageRoot(path.dirname(fileURLToPath(import.meta.url)));
121
+ if (!root)
122
+ throw new Error('Worker shell handoff requires the installed AIWG package root');
123
+ const promptPath = shellWorkerPromptPath(result.finalPath);
124
+ // Saved plans must revalidate identically through source and compiled loaders.
125
+ const promptModule = 'src/serve/worker-shell-prompt.mjs';
126
+ const promptRuntime = path.join(root, existsSync(path.join(root, promptModule)) ? promptModule : `dist/${promptModule}`);
127
+ if (result.artifacts?.length) {
128
+ // Raw execution has no launcher-owned artifact cleanup or workspace lifecycle.
129
+ result.shellCommand = [process.execPath, promptRuntime, '--refuse-artifacts', root].map(quote).join(' ');
132
130
  }
133
131
  else {
134
- throw new Error(`Unsupported worker stdin mode: ${result.stdin}`);
132
+ const argv = result.argv.map(token => token === result.briefPath ? promptPath : token);
133
+ const worker = `${deadline}env -i${environment ? ` ${environment}` : ''} ${markers} ${argv.map(quote).join(' ')}`;
134
+ const outputs = `> ${quote(result.stdoutPath)} 2> ${quote(result.stderrPath)}`;
135
+ if (result.stdin === 'brief-json') {
136
+ const frame = [process.execPath, promptRuntime, '--brief-json', root, result.briefPath, result.briefDigest ?? '', result.finalPath, result.selected.model, result.cwd].map(quote).join(' ');
137
+ result.shellCommand = `cd ${quote(result.cwd)} && env -i ${frame} | ${worker} ${outputs}`;
138
+ }
139
+ else if (result.stdin === 'adapter-frame') {
140
+ const binding = qualification.stdinFramerBinding;
141
+ if (!binding || !absolute(binding.storePath) || !/^sha256:[a-f0-9]{64}$/.test(binding.storeDigest)) {
142
+ throw new Error('Adapter stdin framer requires a trusted installation binding');
143
+ }
144
+ const frame = [process.execPath, promptRuntime, '--adapter-frame', root, result.briefPath, result.cwd,
145
+ result.selected.cli, qualification.adapterId, result.selected.qualificationDigest, result.briefDigest,
146
+ binding.storePath, binding.storeDigest, JSON.stringify(qualification.policy ?? null), result.selected.model, result.finalPath].map(quote).join(' ');
147
+ result.shellCommand = `cd ${quote(result.cwd)} && env -i${environment ? ` ${environment}` : ''} ${frame} | ${worker} ${outputs}`;
148
+ }
149
+ else if (result.stdin === 'closed' || result.stdin === 'brief-text') {
150
+ const stdin = result.stdin === 'closed' ? '< /dev/null' : `< ${quote(promptPath)}`;
151
+ result.shellCommand = `cd ${quote(result.cwd)} && ${worker} ${stdin} ${outputs}`;
152
+ }
153
+ else {
154
+ throw new Error(`Unsupported worker stdin mode: ${result.stdin}`);
155
+ }
156
+ const guard = path.join(root, 'tools/ralph-external/lib/worker-shell-capture.mjs');
157
+ // Closed probes with no task input need neither a brief file nor a derived prompt.
158
+ const needsPrompt = result.stdin !== 'closed' || result.argv.includes(result.briefPath);
159
+ const binding = { request: { role: qualification.role, task: qualification.task ?? null,
160
+ group: result.selected.group, workdir: result.cwd },
161
+ invocation: { cwd: result.cwd, briefPath: result.briefPath, briefDigest: result.briefDigest, stdin: result.stdin, selected: result.selected },
162
+ paths: { ...workerOutputPaths(result), ...(needsPrompt ? { workerBrief: promptPath } : {}) } };
163
+ // Reserve every output before shell redirection or vendor-owned final writes.
164
+ // Noclobber also protects stream files created between reservation and exec.
165
+ const stage = needsPrompt ? [process.execPath, promptRuntime, '--stage', root, result.briefPath, result.briefDigest ?? '', result.finalPath].map(quote).join(' ') + ' && ' : '';
166
+ result.shellCommand = `${[process.execPath, guard, JSON.stringify(binding)].map(quote).join(' ')} && ${stage}(set -C; ${result.shellCommand})`;
135
167
  }
136
168
  }
137
169
  else {
@@ -10,7 +10,7 @@ import { workerConfigDigest, validateWorkerHealthConfig } from '../config/aiwg-c
10
10
  import { intersectWorkerCeilings } from '../models/worker-ceilings.js';
11
11
  import { assertValidWorkerPayload } from '../mission-protocol/codecs.js';
12
12
  import { qualificationDigest } from '../models/qualification-digest.mjs';
13
- import { prepareWorkerInvocation } from './worker-invocation-preparation.js';
13
+ import { prepareWorkerInvocation, WorkerShellArtifactsError } from './worker-invocation-preparation.js';
14
14
  export { prepareWorkerInvocation, mcpToolSchemaDigest } from './worker-invocation-preparation.js';
15
15
  import { isOperatorQualifiedWorkerAdapter, assertOperatorWorkerNativeArgv, assertWorkerLaunchMode, WorkerRoleEffortError, WorkerQualificationPolicyError, requiredWorkerControls, isCanonicalWorkerModelKey, WorkerPolicyError, DEFAULT_WORKER_SELECTION } from '../models/provider-policy.js';
16
16
  /** Frozen per-attempt windows; parent/transport ceilings include time already spent. */
@@ -83,6 +83,8 @@ const invocationChecks = {
83
83
  message: 'Worker invocation preparation failed; check installation evidence, policy, paths and environment, then qualify again.' },
84
84
  installation_recheck_unavailable: { pointer: '/invocation/prepareWorkerInvocation',
85
85
  message: 'The selected profile requires an installation recheck, but the installed driver has no preparation method. Restore the qualified driver and qualify again.' },
86
+ brief_missing: { pointer: '/request/brief',
87
+ message: 'The brief file does not exist, and the selected worker adapter needs its content to build the invocation. Write the brief, then resolve again.' },
86
88
  qualified_workspace_mismatch: { pointer: '/request/workdir',
87
89
  message: 'Worker workdir differs from the qualified workspace. Use the qualified workspace or run aiwg doctor --probe-workers --qualify from the requested workdir.' },
88
90
  };
@@ -99,7 +101,7 @@ export async function buildWorkerInvocationTransport(driver, input) {
99
101
  assertWorkerLaunchMode(driver.qualification.adapter, input.permissions);
100
102
  let transport;
101
103
  try {
102
- transport = await driver.buildInvocation(input);
104
+ transport = await driver.buildInvocation({ ...input, cliVersion: driver.qualification.cliVersion });
103
105
  }
104
106
  catch (error) {
105
107
  throw new WorkerInvocationCheckError(error instanceof WorkerPolicyError ? error.code : 'OG_ADAPTER_UNQUALIFIED', 'invocation_build_failed');
@@ -140,7 +142,10 @@ export async function revalidateWorkerInvocationPlan(saved, snapshot, drivers, n
140
142
  if (!current.invocation || current.status !== 'eligible'
141
143
  || Date.parse(saved.invocation.expiresAt) > Date.parse(current.invocation.expiresAt)
142
144
  || qualificationDigest({ ...current.invocation, expiresAt: saved.invocation.expiresAt }) !== qualificationDigest(saved.invocation)) {
143
- throw new WorkerPolicyError('OG_PIN_MISMATCH', 'Saved invocation differs from current qualified plan; resolve again');
145
+ // Tell the conductor the usual remedy; a plan resolved from another directory (for example the
146
+ // worker tree, whose config and model sources differ) never matches. The refusal is unchanged.
147
+ throw new WorkerPolicyError('OG_PIN_MISMATCH', 'Saved invocation differs from current qualified plan; resolve again'
148
+ + ' from the conductor project directory you launch from (a plan resolved elsewhere, such as in the worker tree, never matches)');
144
149
  }
145
150
  return structuredClone(saved.invocation);
146
151
  }
@@ -278,9 +283,19 @@ export async function resolveWorkerInvocation(snapshot, request, drivers, now =
278
283
  stepEnforcement: controls.includes('stepCap') ? profile.controls.stepCap.support : 'unavailable' };
279
284
  let effectiveHealth = resolveWorkerEffectiveHealth(healthConfig, healthInput);
280
285
  const invocationId = expected?.invocationId ?? randomUUID();
281
- const transport = await buildWorkerInvocationTransport(driver, { invocationId, selected: structuredClone(selected), permissions: structuredClone(tuple.permissions),
282
- cwd: request.workdir, briefPath: request.brief, brief: bytes?.toString('utf8') ?? '', finalPath, limits: structuredClone(limits),
283
- health: structuredClone(effectiveHealth), role: request.role });
286
+ let transport;
287
+ try {
288
+ transport = await buildWorkerInvocationTransport(driver, { invocationId, selected: structuredClone(selected), permissions: structuredClone(tuple.permissions),
289
+ cwd: request.workdir, briefPath: request.brief, brief: bytes?.toString('utf8') ?? '', finalPath, limits: structuredClone(limits),
290
+ health: structuredClone(effectiveHealth), role: request.role });
291
+ }
292
+ catch (error) {
293
+ // A driver that needs the brief cannot build without it; name the missing file, not the adapter (#4161).
294
+ if (bytes !== null || !(error instanceof WorkerInvocationCheckError) || error.reason !== 'invocation_build_failed')
295
+ throw error;
296
+ pointer = '/request/brief';
297
+ throw new WorkerInvocationCheckError('OG_CONFIG_REFERENCE', 'brief_missing');
298
+ }
284
299
  for (const output of Object.values(workerOutputPaths({ ...transport, selected, transport: tuple.transport, finalPath, stdoutPath, stderrPath }))) {
285
300
  await inspectPath(output, 'output');
286
301
  if (path.resolve(request.brief) === output)
@@ -316,7 +331,7 @@ export async function resolveWorkerInvocation(snapshot, request, drivers, now =
316
331
  controlEvidence: isOperatorQualifiedWorkerAdapter(adapter) ? [adapter.qualification.evidenceRef, ...controls.map(name => profile.controls[name].evidence)] : controls.map(name => profile.controls[name].evidence),
317
332
  health: effectiveHealth, };
318
333
  const invocationQualification = { ...qualification, now: Date.parse(now),
319
- ceilings: request.ceilings,
334
+ ceilings: request.ceilings, task: request.task,
320
335
  policy: plan.policy, permissions: tuple.permissions, role: request.role, modelObservation: observation,
321
336
  expectedDigests: { policyDigest, catalogDigest: plan.digests.catalogDigest, profileDigest: plan.digests.profileDigest, briefDigest },
322
337
  requiredControls: controls };
@@ -352,6 +367,8 @@ export async function resolveWorkerInvocation(snapshot, request, drivers, now =
352
367
  };
353
368
  await driver.mcpRegistry.assertWorkerQualified(profile.mcp.serverRef, input);
354
369
  }
370
+ if (request.format === 'shell' && prepared.transport === 'shell' && prepared.artifacts?.length)
371
+ throw new WorkerShellArtifactsError();
355
372
  plan.invocation = prepared;
356
373
  pointer = '/request/brief';
357
374
  const rechecked = await readBrief(request.brief);
@@ -380,7 +397,7 @@ export function workerInvocationDiagnostic(error, pointer, fallback = 'OG_CONFIG
380
397
  return { code: error.code, pointer: error.pointer, message: error.message };
381
398
  if (error instanceof WorkerRoleEffortError)
382
399
  return { code: error.code, pointer: error.pointer, message: error.message };
383
- if (error instanceof WorkerPathScopeError || error instanceof WorkerRequestArgumentError) {
400
+ if (error instanceof WorkerPathScopeError || error instanceof WorkerRequestArgumentError || error instanceof WorkerShellArtifactsError) {
384
401
  return { code: error.code, pointer: error.pointer, message: error.message };
385
402
  }
386
403
  if (error instanceof WorkerInvocationCheckError)
@@ -0,0 +1,6 @@
1
+ /** Private prompt staging shared by shell rendering and its runtime envelope. */
2
+ export function shellWorkerPromptPath(finalPath: string): string;
3
+ export const shellWorkerArtifactsRefusal: string;
4
+ export function stageShellWorkerPrompt(root: string, briefPath: string, briefDigest: string, finalPath: string): Promise<string>;
5
+ export function frameShellWorkerPrompt(root: string, args: string[]): Promise<Buffer>;
6
+ export function frameShellWorkerJson(root: string, args: string[]): Promise<string>;
@@ -0,0 +1,78 @@
1
+ // Stage and frame the shared final-output contract for raw shell handoffs.
2
+ import { createHash } from 'node:crypto';
3
+ import { writeFile } from 'node:fs/promises';
4
+ import path from 'node:path';
5
+ import { pathToFileURL } from 'node:url';
6
+ import { workerStdinBytes, workerStdinDocument } from './worker-stdin-frame.mjs';
7
+
8
+ export const shellWorkerPromptPath = finalPath => `${finalPath}.worker-brief`;
9
+ export const shellWorkerArtifactsRefusal = 'Raw shell rendering does not support worker artifacts; use the launcher with a JSON plan or MCP worker-invoke for workspace materialization and cleanup.';
10
+
11
+ // The renderer supplies its own installed package root, never a task module path.
12
+ async function runtime(root) {
13
+ const loadRalphExternal = relative => import(pathToFileURL(path.join(root, 'tools/ralph-external', relative)).href);
14
+ const { importImpl } = await import(pathToFileURL(path.join(root, 'tools/_resolve-impl.mjs')).href);
15
+ const { inspectWorkerPath } = await importImpl(import.meta.url, 'serve/worker-invocation-paths.js');
16
+ const { boundedPrivateRead, withWorkerPath } = await loadRalphExternal('lib/worker-inputs.mjs');
17
+ const { workerPromptBrief } = await loadRalphExternal('lib/worker-prompt.mjs');
18
+ return { importImpl, withWorkerPath, workerPromptBrief,
19
+ read: (filename, limit) => boundedPrivateRead(filename, limit, inspectWorkerPath) };
20
+ }
21
+
22
+ export async function stageShellWorkerPrompt(root, briefPath, briefDigest, finalPath) {
23
+ const api = await runtime(root);
24
+ const brief = await api.read(briefPath, 262144);
25
+ if (`sha256:${createHash('sha256').update(brief).digest('hex')}` !== briefDigest) {
26
+ throw new Error('Worker prompt digest changed; resolve again');
27
+ }
28
+ const filename = shellWorkerPromptPath(finalPath);
29
+ // Exclusive creation and pinned ancestors preserve existing files and symlinks.
30
+ await api.withWorkerPath(filename, target => writeFile(target, api.workerPromptBrief(brief, finalPath), { flag: 'wx', mode: 0o600 }));
31
+ return filename;
32
+ }
33
+
34
+ export async function frameShellWorkerPrompt(root, args) {
35
+ const [filename, workspace, cli, adapterId, scopeDigest, briefDigest, storePath, storeDigest, policyJson, model, finalPath] = args;
36
+ const api = await runtime(root);
37
+ const brief = await api.read(filename, 262144);
38
+ if (`sha256:${createHash('sha256').update(brief).digest('hex')}` !== briefDigest) throw new Error('Adapter stdin brief changed');
39
+ const prompt = await api.read(shellWorkerPromptPath(finalPath), 1048576);
40
+ if (!prompt.equals(api.workerPromptBrief(brief, finalPath))) throw new Error('Worker shell prompt changed');
41
+ // Reuse the host-bound installation loader and the existing adapter framer.
42
+ const { loadRecordedWorkerInstallations } = await api.importImpl(import.meta.url, 'models/worker-installation.mjs');
43
+ const { loadProviderModelCapabilities } = await api.importImpl(import.meta.url, 'models/provider-policy.js');
44
+ const { drivers } = await loadRecordedWorkerInstallations({ registry: loadProviderModelCapabilities(),
45
+ cwd: workspace, policy: JSON.parse(policyJson) ?? undefined, cli, storePath, storeDigest });
46
+ const driver = drivers[cli];
47
+ if (!driver || driver.qualification.adapterId !== adapterId
48
+ || driver.qualification.adapter.invocation.stdin !== 'adapter-frame'
49
+ || driver.qualification.installation?.evidence?.scopeDigest !== scopeDigest) throw new Error('Adapter stdin binding changed');
50
+ return workerStdinBytes({ stdin: 'adapter-frame', selected: { model } }, prompt, driver);
51
+ }
52
+
53
+ export async function frameShellWorkerJson(root, args) {
54
+ const [filename, briefDigest, finalPath, model, cwd] = args;
55
+ const api = await runtime(root);
56
+ const brief = await api.read(filename, 262144);
57
+ if (`sha256:${createHash('sha256').update(brief).digest('hex')}` !== briefDigest) throw new Error('Worker prompt digest changed');
58
+ const prompt = await api.read(shellWorkerPromptPath(finalPath), 1048576);
59
+ if (!prompt.equals(api.workerPromptBrief(brief, finalPath))) throw new Error('Worker shell prompt changed');
60
+ return workerStdinDocument({ brief: prompt, model, cwd });
61
+ }
62
+
63
+ if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
64
+ const [mode, root, ...args] = process.argv.slice(2);
65
+ try {
66
+ if (mode === '--stage' && args.length === 3) await stageShellWorkerPrompt(root, ...args);
67
+ else if (mode === '--refuse-artifacts' && args.length === 0) {
68
+ const api = await runtime(root);
69
+ const { WorkerPolicyError } = await api.importImpl(import.meta.url, 'models/provider-policy.js');
70
+ throw new WorkerPolicyError('OG_ADAPTER_UNQUALIFIED', shellWorkerArtifactsRefusal);
71
+ } else if (mode === '--brief-json' && args.length === 5) process.stdout.write(await frameShellWorkerJson(root, args));
72
+ else if (mode === '--adapter-frame' && args.length === 11) process.stdout.write(await frameShellWorkerPrompt(root, args));
73
+ else throw new Error('Invalid worker shell prompt request');
74
+ } catch (error) {
75
+ process.stderr.write(`Worker shell prompt refused: ${error.code ? `${error.code}: ` : ''}${error.message}\n`);
76
+ process.exitCode = 1;
77
+ }
78
+ }
@@ -159,17 +159,6 @@ export async function runSkill(opts) {
159
159
  ...(aiwgRoot ? { AIWG_ROOT: aiwgRoot } : {}),
160
160
  ...opts.env,
161
161
  };
162
- // Native source owner shares the same indexed script declaration and project CWD.
163
- if (entry.path.replaceAll('\\', '/').endsWith('agentic/code/frameworks/sdlc-complete/skills/issue-audit/SKILL.md')
164
- && entry.script.entrypoint === 'scripts/audit.mjs') {
165
- const audit = await import('../issues/audit-cli.js');
166
- return audit.main(opts.args, runCwd, { env });
167
- }
168
- if (/agentic\/code\/(addons\/aiwg-utils|plugins\/utils)\/skills\/aiwg-pr\/SKILL\.md$/.test(entry.path.replaceAll('\\', '/'))
169
- && entry.script.entrypoint === 'scripts/deliver.mjs') {
170
- const delivery = await import('../delivery/pr.js');
171
- return delivery.main(opts.args, runCwd);
172
- }
173
162
  const fullArgs = [...invocation.prefixArgs, entrypointPath, ...opts.args];
174
163
  return new Promise((resolve) => {
175
164
  const child = spawn(invocation.command, fullArgs, {
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * Generates agents following the 10 Golden Rules from the Agent Design Bible.
5
5
  *
6
- * @architecture @.aiwg/architecture/software-architecture-doc.md
6
+ * @architecture @docs/architecture/cli/index.md
7
7
  */
8
8
  import { AgentPackager } from '../../agents/agent-packager.js';
9
9
  import { getProviderDefinition } from '../../providers/provider-definitions.js';
@@ -2,7 +2,7 @@
2
2
  * context-pipeline — canonical workspace graph and provider adapter generator.
3
3
  *
4
4
  * Implements the cross-platform context delivery pipeline defined in
5
- * `.aiwg/architecture/adr-workspace-context-graph.md`. Emits a project graph:
5
+ * `docs/configuration/workspace-context.md`. Emits a project graph:
6
6
  *
7
7
  * - WORKSPACE.md — protected provider-neutral project/operator context
8
8
  * - AIWG.md — generated framework/discovery context
@@ -21,7 +21,7 @@ import { getProviderDefinition, listProviderDefinitions } from '../../providers/
21
21
  * Providers that receive AGENTS.md emission at project root.
22
22
  *
23
23
  * Sources kept in sync:
24
- * - ADR-1 §3 default-on rollout (`.aiwg/architecture/adr-agents-md-aggregation.md`)
24
+ * - ADR-1 §3 default-on rollout (`docs/configuration/workspace-context.md`)
25
25
  * - ADR-1 §4 per-provider variants table (file-name + twin-file emission)
26
26
  */
27
27
  export const AGENTS_MD_PROVIDERS = new Set(listProviderDefinitions()
@@ -7,7 +7,7 @@
7
7
  * - AIWG.md — generated framework context
8
8
  * - provider startup files — minimal adapters that load WORKSPACE.md, then AIWG.md
9
9
  *
10
- * Per ADR-1 (.aiwg/architecture/adr-agents-md-aggregation.md). NOT part of agentsmith;
10
+ * Per ADR-1 (docs/configuration/workspace-context.md). NOT part of agentsmith;
11
11
  * agentsmith creates subagent personas, this module assembles cross-platform context.
12
12
  */
13
13
  /**
@@ -3,8 +3,8 @@
3
3
  *
4
4
  * Parses CLI tool help output to extract tool definitions.
5
5
  *
6
- * @architecture @.aiwg/architecture/mcpsmith-architecture.md - Section 5.1
7
- * @implements @.aiwg/architecture/decisions/ADR-014-mcpsmith-mcp-server-generator.md
6
+ * @architecture @docs/smithing/mcpsmith.md
7
+ * @implements @docs/smithing/mcpsmith.md
8
8
  */
9
9
  import { spawn } from 'child_process';
10
10
  /**
@@ -3,8 +3,8 @@
3
3
  *
4
4
  * Generates complete MCP servers from analyzer results.
5
5
  *
6
- * @architecture @.aiwg/architecture/mcpsmith-architecture.md - Section 5.5
7
- * @implements @.aiwg/architecture/decisions/ADR-014-mcpsmith-mcp-server-generator.md
6
+ * @architecture @docs/smithing/mcpsmith.md
7
+ * @implements @docs/smithing/mcpsmith.md
8
8
  */
9
9
  import fs from 'fs/promises';
10
10
  import path from 'path';
@@ -8,8 +8,8 @@
8
8
  * - Natural language descriptions
9
9
  *
10
10
  * @module smiths/mcpsmith
11
- * @architecture @.aiwg/architecture/mcpsmith-architecture.md
12
- * @implements @.aiwg/architecture/decisions/ADR-014-mcpsmith-mcp-server-generator.md
11
+ * @architecture @docs/smithing/mcpsmith.md
12
+ * @implements @docs/smithing/mcpsmith.md
13
13
  */
14
14
  export * from './types.js';
15
15
  export * from './analyzers/cli-analyzer.js';
@@ -3,8 +3,8 @@
3
3
  *
4
4
  * Types for MCP server generation from various sources.
5
5
  *
6
- * @architecture @.aiwg/architecture/mcpsmith-architecture.md
7
- * @implements @.aiwg/architecture/decisions/ADR-014-mcpsmith-mcp-server-generator.md
6
+ * @architecture @docs/smithing/mcpsmith.md
7
+ * @implements @docs/smithing/mcpsmith.md
8
8
  */
9
9
  export {};
10
10
  //# sourceMappingURL=types.js.map
@@ -49,7 +49,7 @@ const PLATFORM_BUILTINS = {
49
49
  // IS the canonical slug for the doctor skill (the bare `doctor` collides with
50
50
  // Claude's built-in). Slash commands and shell CLI commands live on different
51
51
  // surfaces and do not actually conflict at runtime.
52
- // See: docs/migration/skill-namespace-migration.md, .aiwg/architecture/adr-skill-namespace-strategy.md
52
+ // See: docs/migration/skill-namespace-migration.md, docs/migration/skill-namespace-migration.md
53
53
  // ============================================
54
54
  // Ownership Attribution
55
55
  // ============================================
@@ -2,7 +2,7 @@
2
2
  * Namespace-aware Skill Deployment Adapter
3
3
  *
4
4
  * Implements per-platform namespace deployment strategy per ADR:
5
- * .aiwg/architecture/adr-skill-namespace-strategy.md
5
+ * docs/migration/skill-namespace-migration.md
6
6
  *
7
7
  * Platform groups:
8
8
  * Group A (deep-recursion): Claude Code, Cursor, Codex, OpenCode, OpenClaw
@@ -3,8 +3,8 @@
3
3
  *
4
4
  * Discovers installed tools, verifies functionality, and generates runtime catalog.
5
5
  *
6
- * @architecture @.aiwg/architecture/decisions/ADR-014-toolsmith-feature-architecture.md
7
- * @architecture @.aiwg/architecture/toolsmith-implementation-spec.md
6
+ * @architecture @docs/smithing/toolsmith.md
7
+ * @architecture @docs/smithing/toolsmith.md
8
8
  */
9
9
 
10
10
  import { boundedExecFileSync, boundedExecSync } from '../../process/bounded-child-process.mjs';
@@ -1,8 +1,8 @@
1
1
  /**
2
2
  * Type definitions for Toolsmith feature
3
3
  *
4
- * @architecture @.aiwg/architecture/decisions/ADR-014-toolsmith-feature-architecture.md
5
- * @architecture @.aiwg/architecture/toolsmith-implementation-spec.md
4
+ * @architecture @docs/smithing/toolsmith.md
5
+ * @architecture @docs/smithing/toolsmith.md
6
6
  */
7
7
  export {};
8
8
  //# sourceMappingURL=types.js.map
@@ -31,7 +31,7 @@
31
31
  * because Fortemi's MCP surface does not document a direct delete
32
32
  * tool (immutability + versioning is core to the design).
33
33
  *
34
- * @design @.aiwg/architecture/storage-design.md (§5.6)
34
+ * @design @docs/storage/overview.md
35
35
  * @issue #934
36
36
  * @issue #961
37
37
  * @issue #972
@@ -5,7 +5,7 @@
5
5
  * overrides from `storage.config`. Output is byte-identical to the
6
6
  * pre-abstraction direct-fs calls so consumer migrations stay safe.
7
7
  *
8
- * @design @.aiwg/architecture/storage-design.md (§5.1)
8
+ * @design @docs/storage/overview.md
9
9
  * @issue #934
10
10
  * @issue #956
11
11
  */
@@ -27,7 +27,7 @@
27
27
  * journals/YYYY_MM_DD.md journal entries
28
28
  * logseq/* REFUSED (Logseq config)
29
29
  *
30
- * @design @.aiwg/architecture/storage-design.md (§5.3)
30
+ * @design @docs/storage/overview.md
31
31
  * @issue #934
32
32
  * @issue #958
33
33
  */
@@ -24,7 +24,7 @@
24
24
  * - Does NOT implement `query()` — Obsidian's search is not exposed
25
25
  * via the CLI as of research date
26
26
  *
27
- * @design @.aiwg/architecture/storage-design.md (§5.2)
27
+ * @design @docs/storage/overview.md
28
28
  * @issue #934
29
29
  * @issue #957
30
30
  */
@@ -9,7 +9,7 @@
9
9
  * migrate <subsystem> — copy entries from one backend to another
10
10
  * import-corpus — ingest the local research corpus through a storage backend
11
11
  *
12
- * @design @.aiwg/architecture/storage-design.md (§7)
12
+ * @design @docs/storage/overview.md
13
13
  * @issue #934
14
14
  * @issue #954
15
15
  * @issue #955
@@ -276,6 +276,6 @@ Examples:
276
276
  aiwg storage import-corpus --to obsidian:~/vault --dry-run
277
277
  aiwg storage import-corpus --server fortemi-enterprise
278
278
 
279
- See @.aiwg/architecture/storage-design.md for the design.`);
279
+ See @docs/storage/overview.md for the design.`);
280
280
  }
281
281
  //# sourceMappingURL=cli.js.map
@@ -9,7 +9,7 @@
9
9
  * `schemas/storage/storage.config.v1.schema.json`; the lightweight path here
10
10
  * avoids loading the full catalog during storage bootstrap.
11
11
  *
12
- * @design @.aiwg/architecture/storage-design.md
12
+ * @design @docs/storage/overview.md
13
13
  * @issue #934
14
14
  * @issue #953
15
15
  */
@@ -6,7 +6,7 @@
6
6
  * subsystem, and memoizes the adapter instance for the lifetime of the
7
7
  * process.
8
8
  *
9
- * @design @.aiwg/architecture/storage-design.md
9
+ * @design @docs/storage/overview.md
10
10
  * @issue #934
11
11
  * @issue #953
12
12
  */
@@ -13,7 +13,7 @@
13
13
  * await runSubsystemCli('memory', args);
14
14
  * }
15
15
  *
16
- * @design @.aiwg/architecture/storage-design.md (§4)
16
+ * @design @docs/storage/overview.md
17
17
  * @issue #934
18
18
  * @issue #966
19
19
  * @issue #967
@@ -5,7 +5,7 @@
5
5
  * `resolveStorage(subsystem)` to obtain a backend-specific adapter
6
6
  * conforming to `StorageAdapter`.
7
7
  *
8
- * @design @.aiwg/architecture/storage-design.md
8
+ * @design @docs/storage/overview.md
9
9
  * @schema @schemas/storage/storage.config.v1.schema.json
10
10
  * @issue #934
11
11
  * @issue #953
@@ -6,7 +6,7 @@
6
6
  *
7
7
  * @module src/testing/generators/test-case-generator
8
8
  * @implements @.aiwg/requirements/use-cases/UC-009-generate-test-artifacts.md
9
- * @architecture @.aiwg/architecture/software-architecture-doc.md - Section 5.3 TestGenerator
9
+ * @architecture @docs/architecture/cli/index.md
10
10
  * @nfr @.aiwg/requirements/nfr-modules/performance.md - NFR-TEST-01 (<10min for 100 reqs)
11
11
  * @tests @test/unit/testing/test-case-generator.test.ts
12
12
  * @depends @src/testing/generators/use-case-parser.ts