@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
@@ -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
 
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Model Catalog Type Definitions
3
3
  *
4
- * @implements @.aiwg/architecture/enhanced-model-selection-design.md#9-model-catalog-system
4
+ * @implements @docs/models/supported-models.md
5
5
  * @module src/catalog/types
6
6
  */
7
7
  export {};
@@ -13,6 +13,7 @@ import fs from 'fs/promises';
13
13
  import path from 'path';
14
14
  import { pathToFileURL } from 'url';
15
15
  import * as ui from './ui.js';
16
+ import { portableCliExtensionSource, resolveCliExtensionSource } from './cli-extension-paths.js';
16
17
  import { projectAiwgPath, resolveProjectAiwgDir } from '../config/project-artifacts.js';
17
18
  /**
18
19
  * Read the cli-extensions registry from the current project
@@ -44,9 +45,7 @@ export async function registerCliCommands(cwd, namespace, description, source, s
44
45
  if (!/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/.test(namespace)) {
45
46
  throw new Error(`Invalid CLI namespace: ${namespace}`);
46
47
  }
47
- if (!source || !path.isAbsolute(source)) {
48
- throw new Error('CLI extension source must be an absolute path.');
49
- }
48
+ const portableSource = await portableCliExtensionSource(cwd, source);
50
49
  if (Object.keys(subcommands).length === 0) {
51
50
  throw new Error(`CLI namespace '${namespace}' declares no subcommands.`);
52
51
  }
@@ -64,7 +63,7 @@ export async function registerCliCommands(cwd, namespace, description, source, s
64
63
  }
65
64
  }
66
65
  const existing = await readRegistry(cwd) ?? {};
67
- existing[namespace] = { source, description, subcommands };
66
+ existing[namespace] = { source: portableSource, description, subcommands };
68
67
  await writeRegistry(cwd, existing);
69
68
  }
70
69
  /**
@@ -144,7 +143,22 @@ export async function tryExecuteCliExtension(rawCommand, commandArgs, cwd, frame
144
143
  return { exitCode: 1 };
145
144
  }
146
145
  // Resolve the mjs file path
147
- const mjsPath = path.resolve(ns.source, path.basename(sub.file));
146
+ let mjsPath;
147
+ try {
148
+ const source = await resolveCliExtensionSource(cwd, ns.source);
149
+ if (!/^[a-zA-Z0-9_-]+\.mjs$/.test(sub.file))
150
+ throw new Error('Expected a local .mjs file.');
151
+ mjsPath = path.resolve(source, sub.file);
152
+ const relative = path.relative(await fs.realpath(source), await fs.realpath(mjsPath));
153
+ if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
154
+ throw new Error('CLI extension module escapes its source directory.');
155
+ }
156
+ }
157
+ catch (error) {
158
+ const message = error.message;
159
+ ui.error(message);
160
+ return { exitCode: 1, message };
161
+ }
148
162
  try {
149
163
  await fs.access(mjsPath);
150
164
  }
@@ -0,0 +1,65 @@
1
+ // Resolve portable CLI namespace sources and diagnose stale registrations.
2
+ import fs from 'node:fs/promises';
3
+ import path from 'node:path';
4
+ import { projectAiwgPath } from '../config/project-artifacts.js';
5
+ function inside(root, candidate) {
6
+ const relative = path.relative(root, candidate);
7
+ return relative !== '..' && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative);
8
+ }
9
+ /** Relative sources are project-root-relative; external sources remain absolute. */
10
+ export async function resolveCliExtensionSource(cwd, source) {
11
+ if (typeof source !== 'string' || !source.trim() || source.split(/[\\/]+/).includes('..')) {
12
+ throw new Error('Unsafe CLI extension source: empty path or parent traversal.');
13
+ }
14
+ const resolved = path.resolve(cwd, source);
15
+ if (path.isAbsolute(source))
16
+ return resolved;
17
+ if (!inside(path.resolve(cwd), resolved))
18
+ throw new Error('CLI extension source escapes project root.');
19
+ // Inspect real paths so an in-project symlink cannot grant an external source.
20
+ try {
21
+ const [rootReal, sourceReal] = await Promise.all([fs.realpath(cwd), fs.realpath(resolved)]);
22
+ if (!inside(rootReal, sourceReal))
23
+ throw new Error('CLI extension source escapes project root via symlink.');
24
+ }
25
+ catch (error) {
26
+ if (error.code !== 'ENOENT')
27
+ throw error;
28
+ // Missing directories are reported at execution and by doctor.
29
+ }
30
+ return resolved;
31
+ }
32
+ export async function portableCliExtensionSource(cwd, source) {
33
+ const resolved = await resolveCliExtensionSource(cwd, source);
34
+ if (!inside(path.resolve(cwd), resolved))
35
+ return resolved;
36
+ const relative = path.relative(path.resolve(cwd), resolved) || '.';
37
+ await resolveCliExtensionSource(cwd, relative);
38
+ return relative.split(path.sep).join('/');
39
+ }
40
+ /** Diagnose every registry, including committed registries in a fresh clone. */
41
+ export async function cliExtensionSourceWarnings(cwd) {
42
+ const file = projectAiwgPath(cwd, 'cli-extensions.json');
43
+ let registry;
44
+ try {
45
+ registry = JSON.parse(await fs.readFile(file, 'utf8'));
46
+ if (!registry || typeof registry !== 'object' || Array.isArray(registry))
47
+ throw new Error('expected namespace object');
48
+ }
49
+ catch (error) {
50
+ return error.code === 'ENOENT' ? [] : [`CLI extensions: invalid ${file}: ${error.message}`];
51
+ }
52
+ const warnings = [];
53
+ for (const [namespace, entry] of Object.entries(registry)) {
54
+ try {
55
+ const source = await resolveCliExtensionSource(cwd, entry?.source);
56
+ if (!(await fs.stat(source)).isDirectory())
57
+ throw new Error('source is not a directory');
58
+ }
59
+ catch (error) {
60
+ warnings.push(`CLI extension '${namespace}' source '${entry?.source}': ${error.message}. Run aiwg use <bundle> to register its current source.`);
61
+ }
62
+ }
63
+ return warnings;
64
+ }
65
+ //# sourceMappingURL=cli-extension-paths.js.map
@@ -12,7 +12,7 @@
12
12
  * Pattern matches src/cli/handlers/sdlc-accelerate.ts — same agent-spawn
13
13
  * conventions, same provider gating, same --params / --dangerous handling.
14
14
  *
15
- * @architecture @.aiwg/architecture/decisions/ADR-023-contributor-discovery-convention.md
15
+ * @architecture @docs/contributing/contributor-quickstart.md
16
16
  * @issue #943
17
17
  */
18
18
  import { spawn } from 'child_process';
@@ -3,13 +3,13 @@
3
3
  *
4
4
  * Displays comprehensive CLI help information.
5
5
  *
6
- * @implements @.aiwg/architecture/decisions/ADR-001-unified-extension-system.md
6
+ * @implements @docs/architecture/cli/adr-001-unified-extension-registry.md
7
7
  * @source @src/cli/router.ts
8
8
  * @issue #33
9
9
  */
10
10
  import * as ui from '../ui.js';
11
11
  import { maybePrintCommunityFooter } from '../../community/footer.js';
12
- import { listProviderDefinitions } from '../../providers/provider-definitions.js';
12
+ import { generateProviderHelp } from '../help-generator.js';
13
13
  import { getCommandIds } from '../../extensions/commands/definitions.js';
14
14
  /**
15
15
  * Help command handler
@@ -159,8 +159,7 @@ function displayHelp() {
159
159
  ]);
160
160
  ui.rule();
161
161
  ui.blank();
162
- const providers = listProviderDefinitions().filter(({ id }) => id !== 'generic');
163
- console.log(` ${ui.dimText('Providers:')} ${providers.length} — ${providers.map(({ id, status }) => status === 'experimental' ? `${id} (experimental)` : id).join(', ')} (default: claude; aliases: agy → antigravity, devin → windsurf, oh-my-pi → omp)`);
162
+ console.log(` ${generateProviderHelp()}`);
164
163
  ui.blank();
165
164
  console.log(` ${ui.dimText('Examples:')}`);
166
165
  console.log(` aiwg use sdlc ${ui.dimText('Install SDLC framework')}`);
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * Aggregates all extracted command handlers for registry-based routing.
5
5
  *
6
- * @implements @.aiwg/architecture/decisions/ADR-001-unified-extension-system.md
6
+ * @implements @docs/architecture/cli/adr-001-unified-extension-registry.md
7
7
  * @tests @test/unit/cli/handlers/index.test.ts
8
8
  * @issue #42
9
9
  */
@@ -0,0 +1,37 @@
1
+ // Handle the read-only provider-plugin mode separately from remote skill catalogs.
2
+ import { formatPluginSearch, searchProviderPlugins } from '../../marketplace/plugin-search.js';
3
+ export function handlePluginSearch(ctx) {
4
+ try {
5
+ const values = {};
6
+ const query = [];
7
+ for (let index = 1; index < ctx.args.length; index++) {
8
+ const arg = ctx.args[index];
9
+ if (arg === '--plugins' || arg === '--json')
10
+ continue;
11
+ if (arg === '--provider' || arg === '--max-age-days') {
12
+ const value = ctx.args[++index];
13
+ if (!value || value.startsWith('--'))
14
+ throw new Error(`${arg} requires a value`);
15
+ values[arg] = value;
16
+ }
17
+ else if (arg.startsWith('--'))
18
+ throw new Error(`Unsupported plugin search flag: ${arg}`);
19
+ else
20
+ query.push(arg);
21
+ }
22
+ if (!query.join(' ').trim())
23
+ throw new Error('Query required for plugin search');
24
+ const report = searchProviderPlugins(query.join(' '), {
25
+ provider: values['--provider'],
26
+ maxAgeDays: values['--max-age-days'] === undefined ? undefined : Number(values['--max-age-days']),
27
+ });
28
+ for (const warning of report.warnings)
29
+ console.warn(`Warning: ${warning}`);
30
+ console.log(ctx.args.includes('--json') ? JSON.stringify(report, null, 2) : formatPluginSearch(report));
31
+ return { exitCode: 0 };
32
+ }
33
+ catch (error) {
34
+ return { exitCode: 1, message: `Error: ${error instanceof Error ? error.message : String(error)}` };
35
+ }
36
+ }
37
+ //# sourceMappingURL=marketplace-plugin-search.js.map
@@ -7,6 +7,7 @@
7
7
  * @implements #805
8
8
  * @implements #2009
9
9
  */
10
+ import { handlePluginSearch } from './marketplace-plugin-search.js';
10
11
  import fs from 'node:fs';
11
12
  import path from 'node:path';
12
13
  import { sensitiveInputOptions } from '../../auth/sensitive-input.js';
@@ -20,6 +21,7 @@ const USAGE = [
20
21
  'Usage:',
21
22
  ' aiwg marketplace add <catalog-git-url> [--ref <tag-or-sha>]',
22
23
  ' aiwg marketplace search <query> Search packages and signed catalogs',
24
+ ' aiwg marketplace search <query> --plugins [--provider all|claude|codex] [--max-age-days 30] [--json]',
23
25
  ' aiwg marketplace info <package> Show provenance and catalog observations',
24
26
  ' aiwg marketplace install <url|package> Install and lock direct Git or catalog package',
25
27
  ' aiwg marketplace verify <package|lock> Verify cached content and receipts offline',
@@ -82,7 +84,7 @@ export const marketplaceHandler = {
82
84
  if (subcommand === 'add')
83
85
  return handleAdd(ctx);
84
86
  if (subcommand === 'search')
85
- return handleSearch(ctx);
87
+ return ctx.args.includes('--plugins') ? handlePluginSearch(ctx) : handleSearch(ctx);
86
88
  if (subcommand === 'info')
87
89
  return handleInfo(ctx);
88
90
  if (subcommand === 'install')
@@ -290,7 +290,7 @@ async function effectiveCatalog(ctx, target, allowNetwork, parsed, provider) {
290
290
  } : undefined;
291
291
  return resolveDynamicModelCatalog({
292
292
  aiwgRoot,
293
- inventory,
293
+ inventory, parallelism: (await readAiwgConfig(target))?.parallelism,
294
294
  allowNetwork,
295
295
  forceRefresh: allowNetwork,
296
296
  ...(nativeDiscoverers ? { nativeDiscoverers } : {}),
@@ -28,6 +28,8 @@ import { existsSync, mkdirSync, writeFileSync, readFileSync, rmSync, readdirSync
28
28
  import { getProviderConfig } from '../agent-spawn.js';
29
29
  import { AiwgError, EXIT_CODES } from '../errors.js';
30
30
  import { projectAiwgPath } from '../../config/project-artifacts.js';
31
+ /** Wall budget for capturing a managed Ralph child's stable identity (#4153). */
32
+ export const MANAGED_IDENTITY_BUDGET_MS = 2000;
31
33
  /**
32
34
  * Get the path to the external Ralph orchestrator
33
35
  */
@@ -258,8 +260,12 @@ export async function launchExternalRalph(frameworkRoot, projectRoot, options) {
258
260
  let managedAdmission;
259
261
  if (options.managedAdmission) {
260
262
  const { sampleWorkerIdentity, createWorkerIdentityCapture } = await import(join(frameworkRoot, 'tools', 'ralph-external', 'process-monitor.mjs'));
261
- const capture = createWorkerIdentityCapture({ timeoutMs: 250 });
262
- const identityDeadline = process.hrtime.bigint() + 250000000n;
263
+ // Two stable samples are needed. A loaded host can delay the 10 ms poll by
264
+ // hundreds of milliseconds, so a 250 ms window failed healthy launches
265
+ // (#4153). The child's own exit is checked every pass, so a wider window
266
+ // cannot bind a reused PID.
267
+ const capture = createWorkerIdentityCapture({ timeoutMs: MANAGED_IDENTITY_BUDGET_MS });
268
+ const identityDeadline = process.hrtime.bigint() + BigInt(MANAGED_IDENTITY_BUDGET_MS) * 1000000n;
263
269
  let identity;
264
270
  while (!identity && process.hrtime.bigint() < identityDeadline) {
265
271
  if ((child.exitCode !== null && child.exitCode !== undefined) || child.signalCode)
@@ -5,7 +5,7 @@
5
5
  * Uses external Ralph supervisor for crash-resilient background execution.
6
6
  * Falls back to internal scripts when --internal flag is used.
7
7
  *
8
- * @implements @.aiwg/architecture/decisions/ADR-001-unified-extension-system.md
8
+ * @implements @docs/architecture/cli/adr-001-unified-extension-registry.md
9
9
  * @implements @.aiwg/working/issue-ralph-external-completion.md
10
10
  * @tests @test/unit/cli/handlers/ralph.test.ts
11
11
  * @issue #33, #275
@@ -4,7 +4,7 @@
4
4
  * Runtime environment discovery and tool catalog management.
5
5
  * Provides information about available tools, system resources, and runtime environment.
6
6
  *
7
- * @implements @.aiwg/architecture/decisions/ADR-001-unified-extension-system.md
7
+ * @implements @docs/architecture/cli/adr-001-unified-extension-registry.md
8
8
  * @source @src/cli/router.ts
9
9
  * @issue #33
10
10
  */
@@ -4,7 +4,7 @@
4
4
  * Handlers for code generation and project scaffolding commands.
5
5
  * Each handler delegates to existing scripts in tools/scaffolding/.
6
6
  *
7
- * @implements @.aiwg/architecture/decisions/ADR-001-unified-extension-system.md
7
+ * @implements @docs/architecture/cli/adr-001-unified-extension-registry.md
8
8
  * @tests @test/unit/cli/handlers/scaffolding.test.ts
9
9
  * @issue #33
10
10
  */
@@ -52,7 +52,7 @@ class AddCommandHandler extends ScaffoldingHandler {
52
52
  console.warn('\x1b[33m⚠ DEPRECATED:\x1b[0m `aiwg add-command` is deprecated. ' +
53
53
  'Use `aiwg add-skill` instead.\n' +
54
54
  ' Commands are now generated from skills at deploy time.\n' +
55
- ' See: .aiwg/architecture/adr-skills-canonical-extension-type.md\n');
55
+ ' See: docs/extensions/extension-types.md\n');
56
56
  return super.execute(ctx);
57
57
  }
58
58
  }
@@ -4,7 +4,7 @@
4
4
  * Utility for running framework scripts from handlers.
5
5
  * Script execution utility for CLI handlers.
6
6
  *
7
- * @implements @.aiwg/architecture/decisions/ADR-001-unified-extension-system.md
7
+ * @implements @docs/architecture/cli/adr-001-unified-extension-registry.md
8
8
  * @source @src/cli/router.ts
9
9
  * @issue #33
10
10
  */
@@ -19,10 +19,13 @@ import { providerDeploymentLockEnvironment } from '../../providers/deployment-lo
19
19
  // Embedded deployers use process-wide console/environment APIs. Serialize the
20
20
  // complete invocation (including import), and restore them even after failure.
21
21
  let deploymentQueue = Promise.resolve();
22
- function reportFlueWarnings(message, sink = console) {
23
- for (const line of message.split(/\r?\n/))
22
+ function reportDeploymentWarnings(message, sink = console) {
23
+ for (const line of message.split(/\r?\n/)) {
24
24
  if (line.startsWith('Flue (experimental):'))
25
25
  sink.warn(line);
26
+ else if (/^Removing .+ \((?:critical )?rule retired because /.test(line))
27
+ process.stderr.write(`${line}\n`);
28
+ }
26
29
  }
27
30
  /**
28
31
  * Default script runner implementation
@@ -137,7 +140,7 @@ export class DefaultScriptRunner {
137
140
  }
138
141
  else {
139
142
  if (options.capture && code === 0 && scriptPath === 'tools/agents/deploy-agents.mjs') {
140
- reportFlueWarnings(Buffer.concat(capturedStderr).toString());
143
+ reportDeploymentWarnings(Buffer.concat(capturedStderr).toString());
141
144
  }
142
145
  resolve({
143
146
  exitCode: code ?? 0,
@@ -197,7 +200,7 @@ export class DefaultScriptRunner {
197
200
  const message = Buffer.concat(diagnostics).toString().trim()
198
201
  || (exitCode ? `Deployment script exited with code ${exitCode}: ${path.basename(fullPath)}` : '');
199
202
  if (exitCode === 0 && options.capture)
200
- reportFlueWarnings(message, previousConsole);
203
+ reportDeploymentWarnings(message, previousConsole);
201
204
  return exitCode || message ? { exitCode, message } : { exitCode };
202
205
  }
203
206
  catch (error) {
@@ -9,7 +9,7 @@
9
9
  * provider's unrestricted-mode flag, and --params for arbitrary provider-specific
10
10
  * args. IDE-integrated providers (copilot, cursor, etc.) receive guidance instead.
11
11
  *
12
- * @implements @.aiwg/architecture/decisions/ADR-001-unified-extension-system.md
12
+ * @implements @docs/architecture/cli/adr-001-unified-extension-registry.md
13
13
  * @issue #485
14
14
  */
15
15
  import { spawn } from 'child_process';
@@ -62,6 +62,18 @@ export function formatProvider(id, provider, matrix, meta) {
62
62
  lines.push(` Status: ${provider.status}`);
63
63
  lines.push(` Daemon: ${provider.daemon_tier}${provider.daemon_pty_adapter ? ' (+ pty-adapter)' : ''}`);
64
64
  lines.push(` ${'─'.repeat(60)}`);
65
+ if (provider.byok) {
66
+ const byok = provider.byok;
67
+ lines.push(`\n Bring your own key (BYOK): ${byok.status}`);
68
+ for (const setting of byok.settings)
69
+ lines.push(` ${setting}`);
70
+ lines.push(` Verify: ${byok.verification}`);
71
+ lines.push(` ${byok.notes}`);
72
+ lines.push(' Security: aiwg show rule token-security --body; environment or secret-store command only.');
73
+ lines.push(' Never place keys on argv, in deployed AIWG files, harness config, logs or receipts; never print keys.');
74
+ lines.push(" Spend: BYOK runs bill the user's key; paid runs need explicit operator approval.");
75
+ lines.push(` Docs: ${byok.docs}`);
76
+ }
65
77
  const featureKeys = Object.keys(matrix.features);
66
78
  for (const featureId of featureKeys) {
67
79
  const isNative = provider.native_features?.[featureId] === true;
@@ -2,7 +2,7 @@ import { getFrameworkRoot } from "../../channel/manager.mjs";
2
2
  /**
3
3
  * Promote handler — graduate a project-local bundle to upstream or to a
4
4
  * private corpus path. Implements the design at
5
- * @.aiwg/architecture/design-doctor-log-promote.md (#1049).
5
+ * @docs/customization/project-local-lifecycle.md (#1049).
6
6
  *
7
7
  * Usage:
8
8
  * aiwg promote <name> # default: --to upstream
@@ -1,3 +1,8 @@
1
+ // Focused subcommand handlers preserving the public facade.
2
+ import { readFileSync } from 'node:fs';
3
+ import { basename, extname } from 'node:path';
4
+ import { findArtifactFiles } from '../../artifacts/index-files.js';
5
+ import { parseFlowDoc } from '../../artifacts/index-builder.js';
1
6
  import { buildUpstreamRegistry } from "../../extensions/upstream-registry.js";
2
7
  import { resolveShadows } from "../../extensions/shadow-resolver.js";
3
8
  /**
@@ -20,7 +25,20 @@ export function formatProjectLocalOnly(result) {
20
25
  for (const b of result.bundles) {
21
26
  output += ` ${b.id} [project] [${b.type}] v${b.manifest.version}\n`;
22
27
  output += ` Path: ${b.localPath}\n`;
23
- output += ` Description: ${b.manifest.description.slice(0, 80)}${b.manifest.description.length > 80 ? '...' : ''}\n\n`;
28
+ output += ` Description: ${b.manifest.description.slice(0, 80)}${b.manifest.description.length > 80 ? '...' : ''}\n`;
29
+ // Match project graph classification, including custom flow entry directories.
30
+ const flows = findArtifactFiles(b.artifactPath, ['.yaml', '.yml']).flatMap(file => {
31
+ try {
32
+ const flow = parseFlowDoc(readFileSync(file, 'utf8'), file);
33
+ return flow?.type === 'flow' ? [flow.name ?? basename(file, extname(file))] : [];
34
+ }
35
+ catch {
36
+ return [];
37
+ }
38
+ }).sort();
39
+ if (flows.length)
40
+ output += ` Flows (${flows.length}): ${flows.join(', ')}\n`;
41
+ output += '\n';
24
42
  }
25
43
  if (result.errors.length > 0) {
26
44
  output += '\nValidation errors:\n';
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * Defines the interface for CLI command handlers extracted from the monolithic router.
5
5
  *
6
- * @implements @.aiwg/architecture/decisions/ADR-001-unified-extension-system.md
6
+ * @implements @docs/architecture/cli/adr-001-unified-extension-registry.md
7
7
  * @source @src/cli/router.ts
8
8
  * @issue #33
9
9
  */
@@ -2,13 +2,14 @@ import { ContextWriteJournal } from '../../smiths/context-pipeline/context-file-
2
2
  import { trackTemporaryDirectory } from '../../utils/temporary-directory.js';
3
3
  import { codexHookTrustNextStep, readCodexHookTrust } from '../../smiths/hook-bridge/codex-trust.js';
4
4
  import { factoryHookTrustNextStep, readFactoryHookTrust } from '../../smiths/hook-bridge/factory-trust.js';
5
+ import { hermesHookAcceptanceNextStep, readHermesHookAcceptance } from '../../smiths/hook-bridge/hermes-trust.js';
5
6
  /**
6
7
  * Use Command Handler
7
8
  *
8
9
  * Deploys AIWG frameworks (SDLC, Marketing, Writing) to the current project.
9
10
  * After deployment, registers deployed extensions in the extension registry.
10
11
  *
11
- * @implements @.aiwg/architecture/decisions/ADR-001-unified-extension-system.md
12
+ * @implements @docs/architecture/cli/adr-001-unified-extension-registry.md
12
13
  * @implements #56, #57
13
14
  * @source @src/cli/router.ts
14
15
  * @issue #33
@@ -43,7 +44,7 @@ import { bundleDeploymentScope, recordBundleDeployment, copyCleanupArgs, project
43
44
  import { frameworkAdditiveBundles, getAllAddons, getAllExtensions } from './use-additive-bundles.js';
44
45
  export { getAllAddons, getAllExtensions, USE_ALL_DISALLOW, USE_ALL_EXTENSIONS_DISALLOW } from './use-additive-bundles.js';
45
46
  import { checkCollisions, formatCollisionReport, hasBlockingCollisions, } from '../../smiths/skillsmith/collision-detector.js';
46
- import { discoverProjectLocalBundles, } from '../../extensions/project-local-discovery.js';
47
+ import { discoverProjectLocalBundles, formatProjectLocalTargetErrors, } from '../../extensions/project-local-discovery.js';
47
48
  import { PROJECT_LOCAL_TYPE_TO_DIR } from '../../extensions/project-local-paths.js';
48
49
  import { buildUpstreamRegistry } from '../../extensions/upstream-registry.js';
49
50
  import { resolveShadows, formatShadowReport, } from '../../extensions/shadow-resolver.js';
@@ -68,7 +69,7 @@ let machineReadableUseDepth = 0;
68
69
  // rule-delivery transaction. Other built-ins retain their serial deploy path.
69
70
  const PREPARABLE_BUILTIN_PROVIDERS = new Set(['claude', 'codex', 'cursor', 'hermes', 'pi', 'warp']);
70
71
  // Context-pipeline: emits WORKSPACE.md + AIWG.md + provider adapters last.
71
- // for non-Claude providers per ADR-1 (.aiwg/architecture/adr-agents-md-aggregation.md).
72
+ // for non-Claude providers per ADR-1 (docs/configuration/workspace-context.md).
72
73
  // Distinct from agentsmith (which creates subagent personas).
73
74
  import { generate as generateContextFiles, discoverDeployedArtifacts, } from '../../smiths/context-pipeline/index.js';
74
75
  import { verifyModelWrapperDeployment } from '../../models/wrapper-deployment.js';
@@ -1107,6 +1108,7 @@ async function deployOneProjectLocalBundle(opts) {
1107
1108
  // whose desired set is the packaged framework corpus — deletes every
1108
1109
  // project-local agent in the same run that re-deployed it.
1109
1110
  '--deploy-source', 'project-local',
1111
+ ...(opts.bundleOnly ? ['--bundle-only'] : []),
1110
1112
  '--deploy-version', projectLocalDeployVersion(bundle),
1111
1113
  ...modelArgs,
1112
1114
  ];
@@ -1261,6 +1263,7 @@ async function deployProjectLocalBundles(opts) {
1261
1263
  }
1262
1264
  }
1263
1265
  const result = await deployOneProjectLocalBundle({
1266
+ bundleOnly: Boolean(onlyBundleId),
1264
1267
  bundle, ctx: await projectLocalDeploymentContext(ctx, projectDir, bundle.id, provider, Boolean(onlyBundleId)), frameworkRoot, provider, target, dryRun, verbose, quiet, modelArgs,
1265
1268
  });
1266
1269
  if (result.exitCode !== 0) {
@@ -2603,6 +2606,12 @@ export class UseHandler {
2603
2606
  result.findings.push({
2604
2607
  id: 'factory-hook-trust', provider: 'factory', severity: 'info', message: factoryTrustStep,
2605
2608
  });
2609
+ const hermesAcceptanceStep = !dryRun && result.exitCode === 0 && providers.includes('hermes')
2610
+ ? hermesHookAcceptanceNextStep(await readHermesHookAcceptance()) : '';
2611
+ if (hermesAcceptanceStep)
2612
+ result.findings.push({
2613
+ id: 'hermes-prompt-discovery-acceptance', provider: 'hermes', severity: 'info', message: hermesAcceptanceStep,
2614
+ });
2606
2615
  if (json) {
2607
2616
  return { exitCode: result.exitCode, message: JSON.stringify(result, null, 2), rawOutput: true };
2608
2617
  }
@@ -2627,7 +2636,7 @@ export class UseHandler {
2627
2636
  });
2628
2637
  return {
2629
2638
  exitCode: result.exitCode,
2630
- message: [coreResult.message, rendered, ...(previewActions ? [...previewActions].sort() : []), codexTrustStep, factoryTrustStep].filter(Boolean).join('\n'),
2639
+ message: [coreResult.message, rendered, ...(previewActions ? [...previewActions].sort() : []), codexTrustStep, factoryTrustStep, hermesAcceptanceStep].filter(Boolean).join('\n'),
2631
2640
  };
2632
2641
  }
2633
2642
  async executeCore(ctx, resolvedProviders) {
@@ -3135,7 +3144,7 @@ export class UseHandler {
3135
3144
  }
3136
3145
  return {
3137
3146
  exitCode: 1,
3138
- message: `Error: Unknown target '${framework}'\nFrameworks: ${VALID_FRAMEWORKS.join(', ')}\n\n'all' deploys the kernel surface (kernel skills, kernel and core rules, behaviors).\nFor a single addon, run 'aiwg list' to see available addons.\nFor extensions (sys, net, it, sec, stream, dev), see $AIWG_ROOT/agentic/code/extensions/.\nFor project-local artifacts, run 'aiwg list --project-local'.\nRun 'aiwg help' for usage information.`,
3147
+ message: formatProjectLocalTargetErrors(projectDir, framework, discovery) ?? `Error: Unknown target '${framework}'\nFrameworks: ${VALID_FRAMEWORKS.join(', ')}\n\n'all' deploys the kernel surface (kernel skills, kernel and core rules, behaviors).\nFor a single addon, run 'aiwg list' to see available addons.\nFor extensions (sys, net, it, sec, stream, dev), see $AIWG_ROOT/agentic/code/extensions/.\nFor project-local artifacts, run 'aiwg list --project-local'.\nRun 'aiwg help' for usage information.`,
3139
3148
  };
3140
3149
  }
3141
3150
  // Handle addon-only or extension-only deployment.
@@ -3170,7 +3179,7 @@ export class UseHandler {
3170
3179
  };
3171
3180
  }
3172
3181
  const runner = createUseScriptRunner(frameworkRoot);
3173
- const addonBaseArgs = ['--deploy-commands', '--deploy-skills', '--deploy-rules'];
3182
+ const addonBaseArgs = ['--deploy-commands', '--deploy-skills', '--deploy-rules', '--bundle-only'];
3174
3183
  if (remainingArgs.includes('--allow-over-budget'))
3175
3184
  addonBaseArgs.push('--allow-over-budget');
3176
3185
  if (addonScope === 'user')
@@ -4,7 +4,7 @@
4
4
  * Handlers for utility commands including card prefilling, contribution workflow,
5
5
  * metadata validation, health diagnostics, and update checking.
6
6
  *
7
- * @implements @.aiwg/architecture/decisions/ADR-001-unified-extension-system.md
7
+ * @implements @docs/architecture/cli/adr-001-unified-extension-registry.md
8
8
  * @source @src/cli/router.ts
9
9
  * @tests @test/unit/cli/handlers/utilities.test.ts
10
10
  * @issue #33, #342
@@ -1,6 +1,7 @@
1
1
  // Health diagnostics extracted from the utility handler collection.
2
2
  import fsp from 'fs/promises';
3
3
  import { diagnoseUserHookCommands } from '../../extensions/user-hook-diagnostics.js';
4
+ import { diagnoseHermesHookAcceptance } from '../../smiths/hook-bridge/hermes-trust.js';
4
5
  import path from 'path';
5
6
  import { createScriptRunner } from './script-runner.js';
6
7
  import { getFrameworkRoot } from '../../channel/manager.mjs';
@@ -98,6 +99,9 @@ async function runUserScopeDoctor(verbose) {
98
99
  lines.push('');
99
100
  const hookWarnings = await diagnoseUserHookCommands();
100
101
  lines.push(...hookWarnings.map(warning => `⚠ ${warning.message}`));
102
+ const hermesAcceptance = await diagnoseHermesHookAcceptance();
103
+ if (hermesAcceptance)
104
+ lines.push(`⚠ ${hermesAcceptance.message}`);
101
105
  if (frameworks.length === 0) {
102
106
  lines.push('No frameworks deployed at user scope. Run `aiwg use <fw> --scope user` to install.');
103
107
  return { exitCode: hookWarnings.length ? 1 : 0, message: lines.join('\n') + '\n' };
@@ -4,7 +4,7 @@
4
4
  * Displays version and channel information for the AIWG installation.
5
5
  * Supports --verbose / --json for full environment fingerprint (Phase 4.5 #925).
6
6
  *
7
- * @implements @.aiwg/architecture/decisions/ADR-001-unified-extension-system.md
7
+ * @implements @docs/architecture/cli/adr-001-unified-extension-registry.md
8
8
  * @source @src/cli/router.ts
9
9
  * @issue #33, #925
10
10
  */
@@ -4,7 +4,7 @@
4
4
  * Handlers for workspace health, migration, and rollback operations.
5
5
  * Delegates to existing CLI scripts in tools/cli/.
6
6
  *
7
- * @implements @.aiwg/architecture/decisions/ADR-001-unified-extension-system.md
7
+ * @implements @docs/architecture/cli/adr-001-unified-extension-registry.md
8
8
  * @source @src/cli/router.ts
9
9
  * @issue #33
10
10
  */
@@ -2,12 +2,13 @@
2
2
  * Help Generator
3
3
  *
4
4
  * Dynamically generates CLI help text from the extension registry.
5
- * Replaces hardcoded displayHelp() with registry-driven approach.
5
+ * Shares provider help between the launcher and command handler.
6
6
  *
7
- * @implements @.aiwg/architecture/decisions/ADR-001-unified-extension-system.md
7
+ * @implements @docs/architecture/cli/adr-001-unified-extension-registry.md
8
8
  * @tests @test/unit/cli/help-generator.test.ts
9
9
  * @version 1.0.0
10
10
  */
11
+ import { listProviderDefinitions } from '../providers/provider-definitions.js';
11
12
  /**
12
13
  * Category display order and titles
13
14
  *
@@ -82,15 +83,7 @@ export function generateHelp(registry) {
82
83
  }
83
84
  // Platform options
84
85
  lines.push('Platform Options (--provider):');
85
- lines.push(' claude Claude Code (default)');
86
- lines.push(' copilot GitHub Copilot');
87
- lines.push(' factory Factory AI');
88
- lines.push(' codex / openai OpenAI Codex');
89
- lines.push(' cursor Cursor IDE');
90
- lines.push(' opencode OpenCode');
91
- lines.push(' warp Warp Terminal');
92
- lines.push(' devin Devin Desktop');
93
- lines.push(' windsurf Deprecated alias for devin');
86
+ lines.push(` ${generateProviderHelp()}`);
94
87
  lines.push('');
95
88
  // Examples
96
89
  lines.push('Examples:');
@@ -176,4 +169,9 @@ function formatCommandName(cmd) {
176
169
  // Show command name with first alias
177
170
  return `${cmd.id}, ${aliases[0]}`;
178
171
  }
172
+ /** Provider list shared by both production help paths, including generic. */
173
+ export function generateProviderHelp() {
174
+ const providers = listProviderDefinitions();
175
+ return `Providers: ${providers.length} — ${providers.map(({ id, status }) => status === 'experimental' ? `${id} (experimental)` : id).join(', ')} (default: claude; aliases: agy → antigravity, devin → windsurf, oh-my-pi → omp, openai → codex)`;
176
+ }
179
177
  //# sourceMappingURL=help-generator.js.map