@aiwg/cli 2026.10.15 → 2026.10.18

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 (286) hide show
  1. package/agentic/code/providers/pi/aiwg-bridge.ts +45 -7
  2. package/dist/src/artifacts/citation-parser.js +7 -6
  3. package/dist/src/artifacts/corpus-tools/citation-densify.js +4 -2
  4. package/dist/src/artifacts/corpus-tools/cli.js +8 -3
  5. package/dist/src/artifacts/corpus-tools/discovery-log.js +26 -24
  6. package/dist/src/artifacts/corpus-tools/expand-cli.js +3 -2
  7. package/dist/src/artifacts/corpus-tools/expand-dates.js +107 -0
  8. package/dist/src/artifacts/corpus-tools/expand-queue.js +4 -1
  9. package/dist/src/artifacts/corpus-tools/expand-review.js +104 -0
  10. package/dist/src/artifacts/corpus-tools/expand-state.js +17 -1
  11. package/dist/src/artifacts/corpus-tools/expand.js +16 -17
  12. package/dist/src/artifacts/corpus-tools/induction-audit.js +7 -6
  13. package/dist/src/artifacts/corpus-tools/integrity-scan.js +3 -3
  14. package/dist/src/artifacts/corpus-tools/radar-shared.js +7 -9
  15. package/dist/src/artifacts/corpus-tools/ref-files.js +11 -0
  16. package/dist/src/artifacts/corpus-tools/resolve-cli.js +11 -3
  17. package/dist/src/artifacts/corpus-tools/resolve.js +42 -11
  18. package/dist/src/artifacts/corpus-tools/retrieval-lab.js +2 -1
  19. package/dist/src/artifacts/corpus-tools/sidecar-lint.js +4 -4
  20. package/dist/src/artifacts/corpus-tools/sidecar-repair.js +2 -1
  21. package/dist/src/artifacts/corpus-views/ref-parser.js +3 -17
  22. package/dist/src/artifacts/graph-query.js +5 -3
  23. package/dist/src/artifacts/hybrid-query.js +11 -2
  24. package/dist/src/artifacts/index-refresh.js +2 -0
  25. package/dist/src/artifacts/query-engine-corpus.js +217 -0
  26. package/dist/src/artifacts/query-engine-discover-output.js +229 -0
  27. package/dist/src/artifacts/query-engine-discover.js +285 -0
  28. package/dist/src/artifacts/query-engine-entries.js +188 -0
  29. package/dist/src/artifacts/query-engine-index.js +249 -0
  30. package/dist/src/artifacts/query-engine-matching.js +143 -0
  31. package/dist/src/artifacts/query-engine-options.js +2 -0
  32. package/dist/src/artifacts/query-engine-rules.js +202 -0
  33. package/dist/src/artifacts/query-engine-scoring.js +436 -0
  34. package/dist/src/artifacts/query-engine-show-card.js +194 -0
  35. package/dist/src/artifacts/query-engine-show-load.js +211 -0
  36. package/dist/src/artifacts/query-engine-show.js +300 -0
  37. package/dist/src/artifacts/query-engine.js +7 -2576
  38. package/dist/src/cli/handlers/daemon.js +17 -1
  39. package/dist/src/cli/handlers/doctor-args.js +10 -5
  40. package/dist/src/cli/handlers/doctor-help.js +4 -1
  41. package/dist/src/cli/handlers/index.js +2 -2
  42. package/dist/src/cli/handlers/mc-agents.js +111 -0
  43. package/dist/src/cli/handlers/mc-args.js +54 -0
  44. package/dist/src/cli/handlers/mc-control.js +227 -0
  45. package/dist/src/cli/handlers/mc-dispatch.js +203 -0
  46. package/dist/src/cli/handlers/mc-help.js +171 -0
  47. package/dist/src/cli/handlers/mc-run.js +343 -0
  48. package/dist/src/cli/handlers/mc-session.js +138 -0
  49. package/dist/src/cli/handlers/mc-status.js +258 -0
  50. package/dist/src/cli/handlers/mc-summary.js +43 -0
  51. package/dist/src/cli/handlers/mc-types.js +3 -0
  52. package/dist/src/cli/handlers/mc-worker.js +205 -0
  53. package/dist/src/cli/handlers/mc.js +12 -1665
  54. package/dist/src/cli/handlers/models-refusal.js +13 -0
  55. package/dist/src/cli/handlers/models-resource-sample.js +10 -0
  56. package/dist/src/cli/handlers/models.js +5 -3
  57. package/dist/src/cli/handlers/regenerate.js +8 -16
  58. package/dist/src/cli/handlers/remove-bundled.js +133 -0
  59. package/dist/src/cli/handlers/remove-options.js +31 -0
  60. package/dist/src/cli/handlers/remove-user.js +174 -0
  61. package/dist/src/cli/handlers/remove.js +201 -0
  62. package/dist/src/cli/handlers/sessions.js +7 -7
  63. package/dist/src/cli/handlers/subcommands-bundles.js +257 -0
  64. package/dist/src/cli/handlers/subcommands-discovery.js +165 -0
  65. package/dist/src/cli/handlers/subcommands-list-format.js +129 -0
  66. package/dist/src/cli/handlers/subcommands-list.js +250 -0
  67. package/dist/src/cli/handlers/subcommands-plugins.js +213 -0
  68. package/dist/src/cli/handlers/subcommands-quickref.js +58 -0
  69. package/dist/src/cli/handlers/subcommands-rlm.js +113 -0
  70. package/dist/src/cli/handlers/subcommands-services.js +66 -0
  71. package/dist/src/cli/handlers/subcommands-storage.js +259 -0
  72. package/dist/src/cli/handlers/subcommands.js +18 -1976
  73. package/dist/src/cli/handlers/update.js +157 -0
  74. package/dist/src/cli/handlers/use.js +14 -4
  75. package/dist/src/cli/handlers/utilities.js +3 -560
  76. package/dist/src/cli/handlers/utility-doctor.js +412 -0
  77. package/dist/src/cli/scope-resolver.js +1 -142
  78. package/dist/src/cli/services/deployment-verification.js +0 -1
  79. package/dist/src/cli/user-scope-mirror.js +173 -0
  80. package/dist/src/config/aiwg-config.js +2 -1
  81. package/dist/src/config/authorization-cli.js +7 -3
  82. package/dist/src/config/dispatch-host-thresholds.js +2 -0
  83. package/dist/src/config/dispatch-thresholds-runtime.d.mts +3 -2
  84. package/dist/src/config/dispatch-thresholds-runtime.mjs +21 -7
  85. package/dist/src/config/framework-aliases.js +12 -0
  86. package/dist/src/config/host-resource-report.d.mts +24 -0
  87. package/dist/src/config/host-resource-report.mjs +110 -0
  88. package/dist/src/config/host-resource-runtime.d.mts +37 -0
  89. package/dist/src/config/host-resource-runtime.mjs +296 -0
  90. package/dist/src/config/installed-selection.js +22 -0
  91. package/dist/src/config/worker-invocation-marker.d.mts +1 -0
  92. package/dist/src/config/worker-invocation-marker.mjs +2 -0
  93. package/dist/src/decision/ensemble-study/artifacts.js +7 -0
  94. package/dist/src/decision/ensemble-study/gate-policy.js +58 -0
  95. package/dist/src/decision/ensemble-study/gates.js +78 -0
  96. package/dist/src/decision/ensemble-study/protocol.js +18 -21
  97. package/dist/src/decision/ensemble-study/score.js +3 -2
  98. package/dist/src/decision/ensemble-study/statistics.js +7 -26
  99. package/dist/src/decision/heldout/access.js +74 -0
  100. package/dist/src/decision/heldout/calibration.js +1 -0
  101. package/dist/src/decision/heldout/collector.js +8 -1
  102. package/dist/src/decision/sensitivity/comparative-gates.js +135 -0
  103. package/dist/src/decision/sensitivity/comparative.js +18 -41
  104. package/dist/src/effects/verifiers/file.js +22 -5
  105. package/dist/src/extensions/claude-attribution.js +82 -0
  106. package/dist/src/extensions/claude-hooks-installer.js +133 -69
  107. package/dist/src/extensions/commands/daemon.js +109 -0
  108. package/dist/src/extensions/commands/definitions.js +5 -89
  109. package/dist/src/gates/evaluate.js +2 -358
  110. package/dist/src/gates/heldout.js +17 -7
  111. package/dist/src/gates/observations.js +363 -0
  112. package/dist/src/gates/pack-composition.js +270 -0
  113. package/dist/src/gates/pack-tightening.js +197 -0
  114. package/dist/src/gates/pack-validation.js +262 -0
  115. package/dist/src/gates/registry-error.js +5 -0
  116. package/dist/src/gates/registry.js +13 -685
  117. package/dist/src/lint/check-patterns.js +163 -0
  118. package/dist/src/lint/checks.js +268 -0
  119. package/dist/src/lint/reference-resolution.js +54 -0
  120. package/dist/src/lint/runner.js +3 -465
  121. package/dist/src/mcp/helpers.mjs +11 -1
  122. package/dist/src/mcp/json-document.mjs +29 -0
  123. package/dist/src/mcp/muse-native-config.mjs +1 -28
  124. package/dist/src/memory/project-registry.js +44 -4
  125. package/dist/src/mission-protocol/worker-review-gate.js +7 -0
  126. package/dist/src/models/worker-plan.js +36 -5
  127. package/dist/src/models/wrapper-deployment.js +25 -12
  128. package/dist/src/models/wrapper-enforcement.js +47 -7
  129. package/dist/src/network-analysis/research.js +2 -1
  130. package/dist/src/plugin/command-ownership.js +34 -0
  131. package/dist/src/plugin/skill-command-frontmatter.js +197 -0
  132. package/dist/src/plugin/skill-command-translator.js +6 -232
  133. package/dist/src/policy/hitl-check.js +14 -4
  134. package/dist/src/policy/hitl-consume.js +54 -0
  135. package/dist/src/policy/hitl-receipt.js +2 -0
  136. package/dist/src/policy/hitl.js +11 -3
  137. package/dist/src/providers/context-output-ownership.js +26 -0
  138. package/dist/src/providers/deployment-ownership.d.mts +19 -0
  139. package/dist/src/providers/deployment-ownership.mjs +226 -0
  140. package/dist/src/providers/deployment-removal.js +200 -0
  141. package/dist/src/providers/provider-context-contracts.js +162 -0
  142. package/dist/src/providers/provider-definition-schema.js +136 -0
  143. package/dist/src/providers/provider-definitions.js +8 -1298
  144. package/dist/src/providers/provider-seeds-1.js +360 -0
  145. package/dist/src/providers/provider-seeds-2.js +387 -0
  146. package/dist/src/providers/provider-seeds-3.js +262 -0
  147. package/dist/src/providers/removal-transaction.js +86 -0
  148. package/dist/src/providers/settings-document.d.mts +3 -0
  149. package/dist/src/providers/settings-document.mjs +47 -0
  150. package/dist/src/providers/settings-removal.js +190 -0
  151. package/dist/src/providers/skill-ownership.d.mts +19 -2
  152. package/dist/src/providers/skill-ownership.mjs +12 -4
  153. package/dist/src/providers/transformation-receipt-integration.js +15 -271
  154. package/dist/src/providers/transformation-receipt-outputs.js +99 -0
  155. package/dist/src/providers/transformation-receipt-source.js +194 -0
  156. package/dist/src/research/clients/arxiv.js +4 -30
  157. package/dist/src/research/clients/base.js +48 -22
  158. package/dist/src/research/identity.js +42 -4
  159. package/dist/src/research/query-cli.js +3 -87
  160. package/dist/src/research/query-options.js +87 -0
  161. package/dist/src/research/reference-match.js +105 -24
  162. package/dist/src/research/services/acquisition.js +9 -7
  163. package/dist/src/research/services/citation.js +5 -2
  164. package/dist/src/research/types.js +2 -0
  165. package/dist/src/rules/activation.mjs +15 -6
  166. package/dist/src/rules/core-startup.mjs +2 -2
  167. package/dist/src/serve/mission-conductor.js +52 -4
  168. package/dist/src/serve/mission-summary.js +56 -0
  169. package/dist/src/sessions/adapters/grok-build-native.js +23 -0
  170. package/dist/src/sessions/adapters/grok-build.js +14 -7
  171. package/dist/src/sessions/workspace-discovery.js +5 -5
  172. package/dist/src/smiths/context-pipeline/aiwg-md.js +39 -46
  173. package/dist/src/smiths/context-pipeline/claude-hook.js +1 -1
  174. package/dist/src/smiths/context-pipeline/code-regions.js +28 -0
  175. package/dist/src/smiths/context-pipeline/context-file-safety.js +3 -0
  176. package/dist/src/smiths/context-pipeline/finalization.js +81 -51
  177. package/dist/src/smiths/context-pipeline/generator.js +10 -11
  178. package/dist/src/smiths/context-pipeline/managed-hook.js +1 -1
  179. package/dist/src/smiths/context-pipeline/muse-bridge.js +2 -2
  180. package/dist/src/smiths/context-pipeline/provider-policy.js +6 -12
  181. package/dist/src/smiths/context-pipeline/workspace-audit.js +299 -0
  182. package/dist/src/smiths/context-pipeline/workspace-bootstrap.js +148 -0
  183. package/dist/src/smiths/context-pipeline/workspace-context-shared.js +111 -0
  184. package/dist/src/smiths/context-pipeline/workspace-context.js +8 -1373
  185. package/dist/src/smiths/context-pipeline/workspace-doctor.js +192 -0
  186. package/dist/src/smiths/context-pipeline/workspace-document.js +201 -0
  187. package/dist/src/smiths/context-pipeline/workspace-extraction.js +205 -0
  188. package/dist/src/smiths/context-pipeline/workspace-migration.js +250 -0
  189. package/dist/src/smiths/hook-bridge/index.js +9 -0
  190. package/package.json +13 -1
  191. package/schemas/decision/D17StudyProtocol.v1.schema.json +39 -67
  192. package/schemas/decision/D29Study.v10.schema.json +65 -0
  193. package/tools/agents/deploy-agents.mjs +24 -675
  194. package/tools/agents/deploy-command-mirrors.mjs +229 -0
  195. package/tools/agents/deploy-options.mjs +258 -0
  196. package/tools/agents/deploy-support.mjs +165 -0
  197. package/tools/agents/providers/base-addon-discovery.mjs +139 -0
  198. package/tools/agents/providers/base-behaviors.mjs +168 -0
  199. package/tools/agents/providers/base-context.mjs +205 -0
  200. package/tools/agents/providers/base-contract.mjs +116 -0
  201. package/tools/agents/providers/base-files.mjs +252 -0
  202. package/tools/agents/providers/base-flat-artifacts.mjs +233 -0
  203. package/tools/agents/providers/base-framework-discovery.mjs +309 -0
  204. package/tools/agents/providers/base-frontmatter.mjs +196 -0
  205. package/tools/agents/providers/base-inventory.mjs +269 -0
  206. package/tools/agents/providers/base-kernel-skills.mjs +354 -0
  207. package/tools/agents/providers/base-migrations.mjs +258 -0
  208. package/tools/agents/providers/base-models-platforms.mjs +273 -0
  209. package/tools/agents/providers/base-rule-index.mjs +450 -0
  210. package/tools/agents/providers/base-runtime.mjs +60 -0
  211. package/tools/agents/providers/base-skill-copy.mjs +273 -0
  212. package/tools/agents/providers/base.mjs +16 -3364
  213. package/tools/agents/providers/claude-post-deploy.mjs +20 -1
  214. package/tools/agents/providers/context-write.mjs +4 -0
  215. package/tools/agents/providers/hermes-startup.mjs +0 -5
  216. package/tools/agents/providers/muse.mjs +7 -2
  217. package/tools/agents/providers/pi.mjs +3 -1
  218. package/tools/agents/providers/rule-delivery-surface.mjs +359 -0
  219. package/tools/agents/providers/rule-delivery.mjs +20 -1144
  220. package/tools/agents/providers/rule-deployment-commit.mjs +148 -0
  221. package/tools/agents/providers/rule-deployment-prepare.mjs +461 -0
  222. package/tools/agents/providers/rule-deployment-state.mjs +300 -0
  223. package/tools/agents/providers/rule-projection.mjs +3 -0
  224. package/tools/daemon/README.md +511 -0
  225. package/tools/daemon/adapters/base-adapter.mjs +84 -0
  226. package/tools/daemon/adapters/webhook-adapter.mjs +107 -0
  227. package/tools/daemon/agent-supervisor.mjs +299 -0
  228. package/tools/daemon/automation-engine.mjs +310 -0
  229. package/tools/daemon/autonomous-engine.mjs +346 -0
  230. package/tools/daemon/behavior-loader.mjs +316 -0
  231. package/tools/daemon/behavior.mjs +174 -0
  232. package/tools/daemon/concierge/intent-router.mjs +401 -0
  233. package/tools/daemon/concierge/orchestrator.mjs +272 -0
  234. package/tools/daemon/concierge/response-translator.mjs +462 -0
  235. package/tools/daemon/config.mjs +377 -0
  236. package/tools/daemon/cron-scheduler.mjs +178 -0
  237. package/tools/daemon/daemon-main.mjs +1169 -0
  238. package/tools/daemon/event-router.mjs +84 -0
  239. package/tools/daemon/file-watcher.mjs +383 -0
  240. package/tools/daemon/index.mjs +1181 -0
  241. package/tools/daemon/init-profile.mjs +124 -0
  242. package/tools/daemon/ipc-client.mjs +197 -0
  243. package/tools/daemon/ipc-ops-handlers.mjs +236 -0
  244. package/tools/daemon/ipc-server.mjs +275 -0
  245. package/tools/daemon/maintenance-owner.mjs +79 -0
  246. package/tools/daemon/memory-manager.mjs +386 -0
  247. package/tools/daemon/message-router.mjs +194 -0
  248. package/tools/daemon/provider-watcher.mjs +585 -0
  249. package/tools/daemon/pty-adapter.mjs +420 -0
  250. package/tools/daemon/repl-chat.mjs +359 -0
  251. package/tools/daemon/resource-bounds.mjs +88 -0
  252. package/tools/daemon/sandbox-transport.mjs +295 -0
  253. package/tools/daemon/scheduled-task-runner.mjs +535 -0
  254. package/tools/daemon/task-store.mjs +450 -0
  255. package/tools/daemon/tmux-manager.mjs +324 -0
  256. package/tools/daemon/update-policy.mjs +517 -0
  257. package/tools/daemon/web-server.mjs +399 -0
  258. package/tools/daemon/web-ui/index.html +585 -0
  259. package/tools/daemon/web-ui/styles.css +156 -0
  260. package/tools/docker/Dockerfile.daemon +35 -0
  261. package/tools/docker/container-manager.mjs +291 -0
  262. package/tools/messaging/adapter-registry.mjs +230 -0
  263. package/tools/messaging/adapters/base.mjs +326 -0
  264. package/tools/messaging/adapters/discord.mjs +462 -0
  265. package/tools/messaging/adapters/slack.mjs +402 -0
  266. package/tools/messaging/adapters/telegram.mjs +552 -0
  267. package/tools/messaging/chat-handler.mjs +297 -0
  268. package/tools/messaging/command-router.mjs +269 -0
  269. package/tools/messaging/event-bus.mjs +199 -0
  270. package/tools/messaging/index.mjs +456 -0
  271. package/tools/messaging/message-formatter.mjs +320 -0
  272. package/tools/messaging/room-manager.mjs +277 -0
  273. package/tools/messaging/types.mjs +94 -0
  274. package/tools/providers/pi-bridge-policy.mjs +4 -0
  275. package/tools/ralph-external/daemon-supervisor.mjs +394 -0
  276. package/tools/ralph-external/lib/behavior-registry.mjs +270 -0
  277. package/tools/ralph-external/lib/worker-invocation-processes.mjs +7 -4
  278. package/tools/ralph-external/lib/worker-isolation-args.mjs +217 -0
  279. package/tools/ralph-external/lib/worker-isolation-status.mjs +19 -0
  280. package/tools/ralph-external/lib/worker-isolation.mjs +11 -237
  281. package/tools/ralph-external/lib/worker-overflow.mjs +10 -2
  282. package/tools/ralph-external/lib/worker-termination.mjs +15 -8
  283. package/tools/ralph-external/lib/worker-unit-cleanup.mjs +72 -0
  284. package/tools/ralph-external/session-launcher.mjs +7 -7
  285. package/tools/scripts/resource-preflight.mjs +3 -242
  286. package/vscode-extension/schemas/aiwg.config.v1.json +2 -4
@@ -0,0 +1,201 @@
1
+ import { createScriptRunner } from "./script-runner.js";
2
+ import { getFrameworkRoot } from "../../channel/manager.mjs";
3
+ import * as path from "node:path";
4
+ import { pathToFileURL } from "node:url";
5
+ import { getProjectDir } from "../../config/aiwg-config.js";
6
+ import { removeClaudeAttribution } from "../../extensions/claude-hooks-installer.js";
7
+ import { isScopeUser } from "./subcommands-list-format.js";
8
+ import { firstRemovePositional, parseRemoveProvider } from "./remove-options.js";
9
+ import { removeUserScopeDeploy } from "./remove-user.js";
10
+ /**
11
+ * Remove framework handler
12
+ *
13
+ * Delegates to tools/plugin/plugin-uninstaller-cli.mjs
14
+ */
15
+ export const removeHandler = {
16
+ id: "remove",
17
+ name: "Remove Framework",
18
+ description: "Remove installed framework, plugin, or project-local bundle",
19
+ category: "framework",
20
+ aliases: [],
21
+ async help() {
22
+ return { exitCode: 0, rawOutput: true, message: [
23
+ 'Usage: aiwg remove <id> [options]',
24
+ '',
25
+ 'Remove an installed framework, plugin, or project-local bundle by id (for example all or sdlc).',
26
+ 'Project scope is the default; without --provider, process all recorded provider deployments.',
27
+ '"all" is an installed bundle id, not a wildcard for every installed entry.',
28
+ 'Bundled deployments use ownership receipts to remove unchanged agents, commands, rules and skills.',
29
+ 'Project-local removal reverts deployed artifacts using recorded hashes; bundle source is preserved.',
30
+ '',
31
+ 'Options:',
32
+ ' --dry-run List planned removals and preserved paths with reasons; write nothing.',
33
+ ' --provider <p> Select one recorded provider deployment.',
34
+ ' --keep-registry Keep project installed/deployedTo records after removal. By default,',
35
+ ' remove selected deployment records and drop the id when none remain.',
36
+ ' Project-local partial reverts retain their registry records.',
37
+ ' --force Override project-local mutation refusal or legacy plugin dependency checks;',
38
+ ' does not override bundled file hash/ownership preservation.',
39
+ ' --scope user Remove the user-scope mirror using ~/.aiwg/installed.json instead.',
40
+ ' --user Alias for --scope user; user mirror removal updates its own registry.',
41
+ ' --target <d> Target a project directory (alias: --prefix; default: cwd).',
42
+ ' --help, -h Show this help.',
43
+ '',
44
+ 'Bundled file removal preserves modified files, unrecorded operator files, foreign skills,',
45
+ 'and symlinks inside skill directories. Project-local bundle source is never deleted.',
46
+ 'Legacy outputs without receipts are unverifiable and preserved.',
47
+ 'Recorded settings and hooks restore pre-deploy values; operator edits are kept and reported.',
48
+ 'User-scope legacy records without artifact manifests require manual file cleanup.',
49
+ 'Unregistered ids fall back to the legacy plugin uninstaller (also supports --keep-data).',
50
+ '',
51
+ 'Examples:',
52
+ ' aiwg remove all --dry-run',
53
+ ' aiwg remove sdlc --provider claude --dry-run',
54
+ ' aiwg remove my-bundle --keep-registry',
55
+ ' aiwg remove sdlc --scope user --provider codex --dry-run',
56
+ ].join('\n') };
57
+ },
58
+ async execute(ctx) {
59
+ // Explicit provider removal is separate from framework removal. The native
60
+ // adapter validates receipt hashes and preserves operator modifications.
61
+ const nativeRemovalProvider = parseRemoveProvider(ctx.args);
62
+ if (firstRemovePositional(ctx.args) === 'omp' && nativeRemovalProvider.provider === 'omp') {
63
+ // Loaded from the package root, not by a path relative to this file: the
64
+ // compiled handler sits one directory deeper than its source.
65
+ const { uninstall } = (await import(pathToFileURL(path.join(await getFrameworkRoot(), 'tools/agents/providers/omp.mjs')).href));
66
+ const { getProjectDir } = await import('../../config/aiwg-config.js');
67
+ const dryRun = ctx.args.includes('--dry-run');
68
+ const scope = ctx.args.includes('--user') || isScopeUser(ctx.args) ? 'user' : 'project';
69
+ const count = uninstall(getProjectDir({ cwd: ctx.cwd }, ctx.args), { dryRun, scope });
70
+ return { exitCode: 0, message: `${dryRun ? 'Would remove' : 'Removed'} ${count} unchanged OMP-owned files; operator files preserved.` };
71
+ }
72
+ // #1156 Phase 1 — `--scope user` / `--user`: revert the user-scope mirror
73
+ // for the given framework. Independent of any project; reads the per-user
74
+ // registry at ~/.aiwg/installed.json to find what was deployed, deletes
75
+ // the mirrored artifacts under the provider's USER_SCOPE_PATHS, and
76
+ // updates the registry.
77
+ if (ctx.args.includes('--user') || isScopeUser(ctx.args)) {
78
+ return await removeUserScopeDeploy(ctx.args);
79
+ }
80
+ if (firstRemovePositional(ctx.args) === 'grok-build') {
81
+ const providerParse = parseRemoveProvider(ctx.args);
82
+ if (providerParse.provider !== 'grok-build' || providerParse.error) {
83
+ return { exitCode: 1, message: 'Use aiwg remove grok-build --provider grok-build [--dry-run] for reviewed project-scope removal.' };
84
+ }
85
+ const frameworkRoot = await getFrameworkRoot();
86
+ const { uninstall } = (await import(pathToFileURL(path.join(frameworkRoot, 'tools/agents/providers/grok-build.mjs')).href));
87
+ const { readAiwgConfig, writeAiwgConfig } = await import('../../config/aiwg-config.js');
88
+ const target = getProjectDir({ cwd: ctx.cwd }, ctx.args);
89
+ const dryRun = ctx.args.includes('--dry-run');
90
+ const report = uninstall(target, { dryRun, srcRoot: frameworkRoot });
91
+ if (!dryRun && report.skipped.length === 0) {
92
+ const config = await readAiwgConfig(target);
93
+ if (config) {
94
+ for (const [name, entry] of Object.entries(config.installed ?? {})) {
95
+ delete entry.deployedTo?.['grok-build'];
96
+ if (Object.keys(entry.deployedTo ?? {}).length === 0)
97
+ delete config.installed[name];
98
+ }
99
+ await writeAiwgConfig(target, config);
100
+ }
101
+ }
102
+ const lines = [
103
+ `${dryRun ? 'Would remove' : 'Removed'} ${dryRun ? report.planned.length : report.removed.length} unchanged AIWG-owned Grok Build artifact(s).`,
104
+ ...report.planned.map(relative => ` ${relative}`),
105
+ ...report.skipped.map(relative => ` Preserved modified or unverifiable: ${relative}`),
106
+ 'Operator-owned Grok content and shared context files are preserved.',
107
+ ];
108
+ return { exitCode: report.skipped.length ? 1 : 0, message: lines.join('\n') };
109
+ }
110
+ // #1037 — Project-local-aware remove. If the first positional arg matches
111
+ // a project-local entry in `installed`, route to the new handler.
112
+ // Otherwise fall through to the existing plugin-uninstaller flow.
113
+ const positionalArg = firstRemovePositional(ctx.args);
114
+ const providerParse = parseRemoveProvider(ctx.args);
115
+ if (providerParse.error) {
116
+ return {
117
+ exitCode: 1,
118
+ message: `${providerParse.error}\n\nUsage: aiwg remove <id> [--force] [--dry-run] [--provider <p>] [--keep-registry]`,
119
+ };
120
+ }
121
+ if (!positionalArg) {
122
+ return {
123
+ exitCode: 1,
124
+ message: 'Error: framework or bundle id required\n\nUsage: aiwg remove <id> [--force] [--dry-run] [--provider <p>] [--keep-registry]',
125
+ };
126
+ }
127
+ if (positionalArg) {
128
+ try {
129
+ const { readAiwgConfig, writeAiwgConfig, getProjectDir } = await import('../../config/aiwg-config.js');
130
+ const { removeProjectLocalBundle } = await import('../../extensions/project-local-remove.js');
131
+ const projectDir = getProjectDir({ cwd: ctx.cwd }, ctx.args);
132
+ const config = await readAiwgConfig(projectDir);
133
+ const entry = config?.installed?.[positionalArg];
134
+ if (config && entry && entry.source !== 'project-local') {
135
+ const { resolveFrameworkDir } = await import('./use.js');
136
+ const { removeBundledDeployment } = await import('./remove-bundled.js');
137
+ const providers = Object.keys(entry.deployedTo).filter(p => !providerParse.provider || p === providerParse.provider);
138
+ if (providerParse.provider && providers.length === 0) {
139
+ return { exitCode: 1, message: `Error: '${positionalArg}' is not deployed for provider '${providerParse.provider}'.` };
140
+ }
141
+ return removeBundledDeployment(projectDir, positionalArg, resolveFrameworkDir(positionalArg) ?? positionalArg, config, providers, {
142
+ dryRun: ctx.args.includes('--dry-run'), keepRegistry: ctx.args.includes('--keep-registry'),
143
+ });
144
+ }
145
+ if (config && entry?.source === 'project-local') {
146
+ const force = ctx.args.includes('--force');
147
+ const dryRun = ctx.args.includes('--dry-run');
148
+ const keepRegistry = ctx.args.includes('--keep-registry');
149
+ const provider = providerParse.provider;
150
+ const result = await removeProjectLocalBundle(config, projectDir, positionalArg, { force, dryRun, keepRegistry, provider });
151
+ // Print outcome summary
152
+ const lines = [];
153
+ if (dryRun)
154
+ lines.push(`[dry-run] Plan for project-local '${positionalArg}':`);
155
+ for (const o of result.outcomes) {
156
+ const marker = o.reverted ? '✓' : '⚠';
157
+ lines.push(` ${marker} ${o.provider} :: ${o.artifactPath} [${o.case}] ${o.message}`);
158
+ }
159
+ if (result.revertedProviders.length > 0) {
160
+ lines.push(`Fully reverted: ${result.revertedProviders.join(', ')}`);
161
+ }
162
+ if (result.partialProviders.length > 0) {
163
+ lines.push(`Partial (registry preserved): ${result.partialProviders.join(', ')}`);
164
+ }
165
+ if (lines.length > 0)
166
+ console.log(lines.join('\n'));
167
+ if (!dryRun) {
168
+ await writeAiwgConfig(projectDir, config);
169
+ if (result.revertedProviders.includes('claude') && !Object.values(config.installed).some(item => item.deployedTo.claude))
170
+ await removeClaudeAttribution(projectDir);
171
+ }
172
+ // Note: source under .aiwg/<type>/<name>/ is intentionally NOT
173
+ // deleted (load-bearing invariant from #1048 design).
174
+ return {
175
+ exitCode: result.partialProviders.length > 0 ? 1 : 0,
176
+ message: result.partialProviders.length > 0
177
+ ? `Some artifacts skipped (see above). Use --force to override mutation refusal.`
178
+ : '',
179
+ };
180
+ }
181
+ }
182
+ catch (err) {
183
+ // A failed receipt/config read must never trigger a second, legacy deletion path.
184
+ const msg = err instanceof Error ? err.message : String(err);
185
+ return { exitCode: 1, message: `Framework removal pre-check failed: ${msg}` };
186
+ }
187
+ }
188
+ if (providerParse.provider) {
189
+ return {
190
+ exitCode: 1,
191
+ message: `Error: --provider is only supported for project-local or user-scope remove. '${positionalArg}' is not a project-local bundle.\n\nUse 'aiwg remove ${positionalArg}' without --provider, or 'aiwg remove ${positionalArg} --scope user --provider ${providerParse.provider}' for a user-scope mirror. Refs #1610.`,
192
+ };
193
+ }
194
+ const frameworkRoot = await getFrameworkRoot();
195
+ const runner = createScriptRunner(frameworkRoot);
196
+ return runner.run("tools/plugin/plugin-uninstaller-cli.mjs", ctx.args, {
197
+ cwd: ctx.cwd,
198
+ });
199
+ },
200
+ };
201
+ //# sourceMappingURL=remove.js.map
@@ -3,7 +3,7 @@ import { randomUUID } from 'node:crypto';
3
3
  import { basename, dirname, isAbsolute, join, resolve, } from 'node:path';
4
4
  import { pathToFileURL } from 'node:url';
5
5
  import { providerScopeWarnings } from '../../sessions/coverage-preflight.js';
6
- import { CLAUDE_ADAPTER_VERSION, ClaudeSessionAdapter, CODEX_ADAPTER_VERSION, CodexSessionAdapter, COPILOT_ADAPTER_VERSION, CopilotSessionAdapter, CURSOR_ADAPTER_VERSION, CursorSessionAdapter, FACTORY_ADAPTER_VERSION, FactorySessionAdapter, HERMES_ADAPTER_VERSION, HermesSessionAdapter, OPENCODE_ADAPTER_VERSION, OpenCodeSessionAdapter, OPENCLAW_ADAPTER_VERSION, OpenClawSessionAdapter, OPENHUMAN_ADAPTER_VERSION, OpenHumanSessionAdapter, GROKBOT_ADAPTER_VERSION, GROKBOT_NATIVE_REPLICA_LOCATOR_CLASS, GrokbotSessionAdapter, GROK_BUILD_ADAPTER_VERSION, GROK_BUILD_CLI_EXPORT_LOCATOR_CLASS, GROK_BUILD_NATIVE_LOCATOR_CLASS, GrokBuildSessionAdapter, grokBuildList, grokBuildSearch, grokBuildExport, grokHeadlessSessionIdFromFile, MUSE_ADAPTER_VERSION, MuseSessionAdapter, PI_ADAPTER_VERSION, PiSessionAdapter, DEEPSEEK_HARNESS_ADAPTER_VERSION, DeepSeekHarnessSessionAdapter, OmpSessionAdapter, OMP_ADAPTER_VERSION, WARP_ADAPTER_VERSION, WarpSessionAdapter, DEVIN_DESKTOP_ADAPTER_VERSION, DevinDesktopSessionAdapter, CandidateExtractionService, GENERIC_ADAPTER_VERSION, GenericSessionInterchangeAdapter, IncrementalSessionImporter, ImportLeaseContentionError, FilesystemMemoryDestination, FilesystemPromotionDispositionCoordinator, MemoryPromotionGateway, SESSION_CONTRACT_VERSION, SessionContractError, SessionRepository, SessionSourceSchema, StructuralCandidateExtractor, resolveMemoryConsumerManifest, assertSessionProviderId, acquireImportLease, countUniqueSessionsAcrossCatalogs, defaultDiscoveryManifestPath, defaultHostCatalogPath, HOST_CATALOG_WORKSPACE_ID, indexIdentitiesBySessionId, manifestNeedsHostCatalog, mergeCrossCatalogRows, mergeSessionLists, resolveHostReferences, summarizeSessionAnalyticsFacts, discoverWorkspaceHistories, createSessionAdapterRegistry, providerDiscoveryCapability, coveragePreflight, expectedSessionProviders, deriveSessionTimeline, importDiscoveryManifest, previewDiscoveryImport, publicDiscoveryManifest, readDiscoveryManifest, redactSourceLocator, sha256, parseTimelineGap, writeDiscoveryManifest, buildSessionExportPlan, reverifySessionExportPlan, buildSessionAiwgFortemiIndexExport, recoverAiwgFortemiIndexFromFullV1Shard, embedAttachmentsInFullV1Shard, recoverEmbeddedAttachments, SESSION_EXPORT_PLAN_SCHEMA_VERSION, } from '../../sessions/index.js';
6
+ import { CLAUDE_ADAPTER_VERSION, ClaudeSessionAdapter, CODEX_ADAPTER_VERSION, CodexSessionAdapter, COPILOT_ADAPTER_VERSION, CopilotSessionAdapter, CURSOR_ADAPTER_VERSION, CursorSessionAdapter, FACTORY_ADAPTER_VERSION, FactorySessionAdapter, HERMES_ADAPTER_VERSION, HermesSessionAdapter, OPENCODE_ADAPTER_VERSION, OpenCodeSessionAdapter, OPENCLAW_ADAPTER_VERSION, OpenClawSessionAdapter, OPENHUMAN_ADAPTER_VERSION, OpenHumanSessionAdapter, GROKBOT_ADAPTER_VERSION, GROKBOT_NATIVE_REPLICA_LOCATOR_CLASS, GrokbotSessionAdapter, GROK_BUILD_ADAPTER_VERSION, GROK_BUILD_CLI_EXPORT_LOCATOR_CLASS, GROK_BUILD_NATIVE_LOCATOR_CLASS, GrokBuildSessionAdapter, grokBuildNativeAvailability, grokBuildList, grokBuildSearch, grokBuildExport, grokHeadlessSessionIdFromFile, MUSE_ADAPTER_VERSION, MuseSessionAdapter, PI_ADAPTER_VERSION, PiSessionAdapter, DEEPSEEK_HARNESS_ADAPTER_VERSION, DeepSeekHarnessSessionAdapter, OmpSessionAdapter, OMP_ADAPTER_VERSION, WARP_ADAPTER_VERSION, WarpSessionAdapter, DEVIN_DESKTOP_ADAPTER_VERSION, DevinDesktopSessionAdapter, CandidateExtractionService, GENERIC_ADAPTER_VERSION, GenericSessionInterchangeAdapter, IncrementalSessionImporter, ImportLeaseContentionError, FilesystemMemoryDestination, FilesystemPromotionDispositionCoordinator, MemoryPromotionGateway, SESSION_CONTRACT_VERSION, SessionContractError, SessionRepository, SessionSourceSchema, StructuralCandidateExtractor, resolveMemoryConsumerManifest, assertSessionProviderId, acquireImportLease, countUniqueSessionsAcrossCatalogs, defaultDiscoveryManifestPath, defaultHostCatalogPath, HOST_CATALOG_WORKSPACE_ID, indexIdentitiesBySessionId, manifestNeedsHostCatalog, mergeCrossCatalogRows, mergeSessionLists, resolveHostReferences, summarizeSessionAnalyticsFacts, discoverWorkspaceHistories, createSessionAdapterRegistry, providerDiscoveryCapability, coveragePreflight, expectedSessionProviders, deriveSessionTimeline, importDiscoveryManifest, previewDiscoveryImport, publicDiscoveryManifest, readDiscoveryManifest, redactSourceLocator, sha256, parseTimelineGap, writeDiscoveryManifest, buildSessionExportPlan, reverifySessionExportPlan, buildSessionAiwgFortemiIndexExport, recoverAiwgFortemiIndexFromFullV1Shard, embedAttachmentsInFullV1Shard, recoverEmbeddedAttachments, SESSION_EXPORT_PLAN_SCHEMA_VERSION, } from '../../sessions/index.js';
7
7
  import { resolveImportExclusions } from '../../sessions/import-exclusions.js';
8
8
  import { resolveImportLimits } from '../../sessions/import-limits.js';
9
9
  import { classifyGrokbotBlobName } from '../../sessions/adapters/grokbot-locator.js';
@@ -87,8 +87,8 @@ Options:
87
87
  --muse-root <path> Explicitly authorize a Muse Code sessions root
88
88
  --dsh-root <path> Explicitly authorize a DeepSeek Harness sessions root
89
89
  --grokbot-root <path> Explicitly authorize a Grok Bot sand-client-persistence root
90
- --grok-root <path> Explicitly authorize a Grok Build sessions root (native chat_history.jsonl discovery)
91
- --grok-active-sessions <path> Explicitly authorize active_sessions.json for Grok Build live detection (read-only; requires --grok-root)
90
+ --grok-root <path> Authorize experimental Grok Build native sessions (requires AIWG_GROK_BUILD_NATIVE_EXPERIMENTAL=1; unqualified)
91
+ --grok-active-sessions <path> Authorize experimental active_sessions.json live detection (same opt-in; requires --grok-root)
92
92
  --hermes-root <path> Explicitly authorize a Hermes home for a read-only state.db backup snapshot
93
93
  --grok-bin <path> Absolute Grok Build CLI path for grok-list/grok-search/grok-export
94
94
  (default: grok on PATH, then $GROK_HOME/bin/grok)
@@ -1714,12 +1714,12 @@ function providerDisposition(provider) {
1714
1714
  };
1715
1715
  }
1716
1716
  if (provider === 'grok-build') {
1717
+ const adapter = new GrokBuildSessionAdapter();
1717
1718
  return {
1718
1719
  provider, disposition: 'implemented', operationalState: 'available',
1719
- supportedOperations: ['discover', 'inspect', 'stream'],
1720
- acquisitionModes: ['manual-export', 'jsonl'],
1721
- reasonCode: null,
1722
- remediation: 'Pass --grok-root with an explicitly authorized sessions root for native chat_history.jsonl discovery, optionally with --grok-active-sessions for live detection; or run `grok export <session-id> <session-id>.md` and import the explicitly authorized Markdown file.',
1720
+ supportedOperations: adapter.supportedOperations,
1721
+ acquisitionModes: adapter.acquisitionModes,
1722
+ ...grokBuildNativeAvailability(),
1723
1723
  evidence: {
1724
1724
  adapterVersion: GROK_BUILD_ADAPTER_VERSION,
1725
1725
  verifiedAt: '2026-09-21',
@@ -0,0 +1,257 @@
1
+ import { getFrameworkRoot } from "../../channel/manager.mjs";
2
+ /**
3
+ * Promote handler — graduate a project-local bundle to upstream or to a
4
+ * private corpus path. Implements the design at
5
+ * @.aiwg/architecture/design-doctor-log-promote.md (#1049).
6
+ *
7
+ * Usage:
8
+ * aiwg promote <name> # default: --to upstream
9
+ * aiwg promote <name> --to upstream
10
+ * aiwg promote <name> --to corpus <path>
11
+ * aiwg promote <name> --dry-run
12
+ * aiwg promote <name> --cleanup
13
+ * aiwg promote <name> --force
14
+ *
15
+ * @implements #1037
16
+ */
17
+ export const promoteHandler = {
18
+ id: 'promote',
19
+ name: 'Promote',
20
+ description: 'Graduate a project-local bundle to upstream or a corpus path',
21
+ category: 'framework',
22
+ aliases: ['-promote', '--promote', 'graduate'],
23
+ async execute(ctx) {
24
+ const args = ctx.args;
25
+ const positional = args.find(a => !a.startsWith('-'));
26
+ if (!positional) {
27
+ return { exitCode: 1, message: 'Error: bundle name required\n\nUsage: aiwg promote <name> [--to upstream|corpus <path>] [--dry-run] [--cleanup] [--force]' };
28
+ }
29
+ const toIdx = args.findIndex(a => a === '--to');
30
+ const toValue = toIdx >= 0 ? args[toIdx + 1] : 'upstream';
31
+ let corpusPath;
32
+ if (toValue === 'corpus') {
33
+ // The argument *after* "corpus" is the path
34
+ corpusPath = args[toIdx + 2];
35
+ if (!corpusPath || corpusPath.startsWith('-')) {
36
+ return { exitCode: 1, message: 'Error: --to corpus requires a path argument' };
37
+ }
38
+ }
39
+ else if (toValue !== 'upstream') {
40
+ return { exitCode: 1, message: `Error: --to must be 'upstream' or 'corpus' (got '${toValue}')` };
41
+ }
42
+ const dryRun = args.includes('--dry-run');
43
+ const cleanup = args.includes('--cleanup');
44
+ const force = args.includes('--force');
45
+ try {
46
+ const { readAiwgConfig, writeAiwgConfig, getProjectDir } = await import('../../config/aiwg-config.js');
47
+ const { promoteProjectLocalBundle } = await import('../../extensions/project-local-promote.js');
48
+ const projectDir = getProjectDir({ cwd: ctx.cwd }, args);
49
+ const config = await readAiwgConfig(projectDir);
50
+ if (!config) {
51
+ return { exitCode: 1, message: 'Error: no .aiwg/aiwg.config found — run `aiwg init` first' };
52
+ }
53
+ const fr = await getFrameworkRoot();
54
+ const result = await promoteProjectLocalBundle(config, projectDir, positional, {
55
+ to: toValue,
56
+ corpusPath,
57
+ dryRun,
58
+ cleanup,
59
+ force,
60
+ frameworkRoot: fr,
61
+ });
62
+ if (!result.ok) {
63
+ return { exitCode: 1, message: `Error: ${result.message ?? result.failureReason}` };
64
+ }
65
+ if (dryRun && result.plan) {
66
+ console.log('[dry-run] Would copy:');
67
+ console.log(` ${result.plan.source} → ${result.plan.destination}`);
68
+ console.log(` Files: ${result.plan.files.length}, ${result.plan.totalBytes} bytes`);
69
+ console.log(' Pre-flight: ✓ manifest valid ✓ destination clean');
70
+ console.log(' Hash verification: skipped (dry-run)');
71
+ console.log(` Registry update: source: project-local → ${toValue === 'upstream' ? 'bundled' : 'corpus'}`);
72
+ console.log(` Cleanup: ${cleanup ? 'will remove .aiwg source after copy' : 'skipped (--cleanup not set)'}`);
73
+ return { exitCode: 0 };
74
+ }
75
+ await writeAiwgConfig(projectDir, config);
76
+ console.log(`✓ Promoted '${positional}' → ${result.plan?.destination}`);
77
+ if (cleanup) {
78
+ console.log(' Source removed from .aiwg/');
79
+ try {
80
+ const { deployProjectQuickref, generateProjectQuickref, hasProjectQuickref } = await import('../../extensions/project-quickref.js');
81
+ if (await hasProjectQuickref(projectDir)) {
82
+ if (config.providers.length > 0) {
83
+ for (const provider of config.providers)
84
+ await deployProjectQuickref(projectDir, provider);
85
+ console.log(` Managed project quickref refreshed for: ${config.providers.join(', ')}.`);
86
+ }
87
+ else {
88
+ await generateProjectQuickref(projectDir);
89
+ console.log(' Managed project quickref generated; no providers are configured for deployment.');
90
+ }
91
+ }
92
+ else {
93
+ console.log(' Managed project quickref is now empty; run `aiwg doctor --project-local` to inspect deployed stale copies.');
94
+ }
95
+ }
96
+ catch (error) {
97
+ console.log(` Managed project quickref refresh failed: ${error.message}`);
98
+ }
99
+ }
100
+ return { exitCode: 0 };
101
+ }
102
+ catch (err) {
103
+ const msg = err instanceof Error ? err.message : String(err);
104
+ return { exitCode: 1, message: `promote failed: ${msg}` };
105
+ }
106
+ },
107
+ };
108
+ /**
109
+ * New bundle handler — scaffolds a project-local bundle under the configured
110
+ * AIWG artifact root with a valid manifest, starter artifact, and a
111
+ * README that includes the identical-form portability reminder.
112
+ *
113
+ * Usage:
114
+ * aiwg new-bundle <name> # default: --type extension --starter skill
115
+ * aiwg new-bundle <name> --type addon
116
+ * aiwg new-bundle <name> --type framework --starter minimal
117
+ * aiwg new-bundle <name> --starter rule --description "Custom rule"
118
+ *
119
+ * @implements #1050
120
+ */
121
+ export const newBundleHandler = {
122
+ id: 'new-bundle',
123
+ name: 'New Bundle',
124
+ description: 'Scaffold a project-local bundle under the configured AIWG artifact root',
125
+ category: 'scaffolding',
126
+ aliases: ['new-extension', 'new-addon', 'new-framework', 'new-plugin', 'new-provider'],
127
+ async execute(ctx) {
128
+ const args = ctx.args;
129
+ const positional = args.find(a => !a.startsWith('-'));
130
+ if (!positional) {
131
+ return {
132
+ exitCode: 1,
133
+ message: 'Error: bundle name required\n\nUsage: aiwg new-bundle <name> [--type extension|addon|framework|plugin|provider] [--starter skill|rule|agent|minimal] [--description "..."]',
134
+ };
135
+ }
136
+ // Type can be inferred from the alias used to invoke (new-extension etc.)
137
+ const aliasMap = {
138
+ 'new-extension': 'extension',
139
+ 'new-addon': 'addon',
140
+ 'new-framework': 'framework',
141
+ 'new-plugin': 'plugin',
142
+ 'new-provider': 'provider',
143
+ };
144
+ const invoked = ctx.rawArgs[0] ?? '';
145
+ const aliasType = aliasMap[invoked];
146
+ const typeIdx = args.findIndex(a => a === '--type');
147
+ const typeFlag = typeIdx >= 0 ? args[typeIdx + 1] : undefined;
148
+ const type = (typeFlag ?? aliasType ?? 'extension');
149
+ if (!['extension', 'addon', 'framework', 'plugin', 'provider'].includes(type)) {
150
+ return { exitCode: 1, message: `Error: --type must be one of extension|addon|framework|plugin|provider (got '${type}')` };
151
+ }
152
+ const starterIdx = args.findIndex(a => a === '--starter');
153
+ const starter = starterIdx >= 0 ? args[starterIdx + 1] : undefined;
154
+ if (starter && !['skill', 'rule', 'agent', 'minimal'].includes(starter)) {
155
+ return { exitCode: 1, message: `Error: --starter must be one of skill|rule|agent|minimal (got '${starter}')` };
156
+ }
157
+ const descIdx = args.findIndex(a => a === '--description');
158
+ const description = descIdx >= 0 ? args[descIdx + 1] : undefined;
159
+ const dryRun = args.includes('--dry-run');
160
+ const { scaffoldProjectLocalBundle } = await import('../../extensions/project-local-scaffold.js');
161
+ try {
162
+ const result = await scaffoldProjectLocalBundle({
163
+ type,
164
+ name: positional,
165
+ description,
166
+ starter,
167
+ projectDir: ctx.cwd,
168
+ dryRun,
169
+ });
170
+ if (result.alreadyExists) {
171
+ return {
172
+ exitCode: 1,
173
+ message: `Refused: bundle already exists at ${result.bundlePath}. Remove it first or pick a different name.`,
174
+ };
175
+ }
176
+ if (dryRun) {
177
+ console.log(`[DRY RUN] Would scaffold project-local ${type} '${positional}' at ${result.bundlePath}`);
178
+ console.log(' Files that would be created:');
179
+ for (const f of result.filesCreated)
180
+ console.log(` + ${f}`);
181
+ console.log('');
182
+ console.log('No files written. Re-run without --dry-run to create.');
183
+ return { exitCode: 0 };
184
+ }
185
+ console.log(`✓ Scaffolded project-local ${type} '${positional}' at ${result.bundlePath}`);
186
+ console.log(' Files created:');
187
+ for (const f of result.filesCreated)
188
+ console.log(` + ${f}`);
189
+ // #1085 — when the project blanket-ignores .aiwg/, the new bundle's
190
+ // source would be silently dropped from version control. Detect and
191
+ // self-heal idempotently.
192
+ try {
193
+ const { appendAiwgSourceTrackBlock } = await import('../../extensions/project-local-gitignore.js');
194
+ const ig = await appendAiwgSourceTrackBlock(ctx.cwd);
195
+ if (ig.added) {
196
+ console.log('');
197
+ console.log(` → ${ig.reason}`);
198
+ console.log(' .aiwg/{addons,extensions,frameworks,plugins,providers}/ now tracked by git.');
199
+ console.log(' Generated state under .aiwg/ (working/, ralph/, research/, ...) stays ignored.');
200
+ }
201
+ }
202
+ catch {
203
+ // .gitignore management is best-effort; don't fail the scaffold
204
+ }
205
+ try {
206
+ const { generateProjectQuickref } = await import('../../extensions/project-quickref.js');
207
+ await generateProjectQuickref(ctx.cwd);
208
+ console.log(' → Managed project quickref refreshed from discovered capabilities.');
209
+ }
210
+ catch (error) {
211
+ console.log(` → Managed project quickref refresh deferred: ${error.message}`);
212
+ }
213
+ // #1235 / #1758 — auto-rebuild the project graph and refresh the
214
+ // Fortemi Core static cache so the new bundle is immediately
215
+ // discoverable via top-level `aiwg discover` / `aiwg show`.
216
+ // Best-effort: don't fail the scaffold if indexing hiccups.
217
+ let indexedOk = false;
218
+ let fortemiSyncedOk = false;
219
+ try {
220
+ const { buildIndex } = await import('../../artifacts/index-builder.js');
221
+ await buildIndex(ctx.cwd, { graph: 'project', force: false, explicit: true });
222
+ indexedOk = true;
223
+ const { syncFortemiCoreIndex } = await import('../../artifacts/fortemi-core-sync.js');
224
+ syncFortemiCoreIndex(ctx.cwd, { graph: 'project' });
225
+ fortemiSyncedOk = true;
226
+ }
227
+ catch {
228
+ // ignore — surface via next-steps hint instead
229
+ }
230
+ console.log('');
231
+ console.log('Next steps:');
232
+ console.log(` 1. Edit manifest.json (description, version, keywords)`);
233
+ console.log(` 2. Customize the starter artifact under ${result.bundlePath}/`);
234
+ if (indexedOk && fortemiSyncedOk) {
235
+ console.log(` 3. Discoverable now via: aiwg discover "${positional}"`);
236
+ }
237
+ else if (indexedOk) {
238
+ console.log(` 3. Sync project search cache: aiwg index sync --graph project`);
239
+ console.log(` then: aiwg discover "${positional}"`);
240
+ }
241
+ else {
242
+ console.log(` 3. Rebuild project index: aiwg index build --graph project`);
243
+ console.log(` then sync search cache: aiwg index sync --graph project`);
244
+ console.log(` then: aiwg discover "${positional}"`);
245
+ }
246
+ console.log(` 4. Deploy: aiwg use ${positional}`);
247
+ console.log(` 5. Inspect: aiwg doctor --project-local`);
248
+ console.log(` 6. When mature, promote: aiwg promote ${positional}`);
249
+ return { exitCode: 0 };
250
+ }
251
+ catch (err) {
252
+ const msg = err instanceof Error ? err.message : String(err);
253
+ return { exitCode: 1, message: `Error: ${msg}` };
254
+ }
255
+ },
256
+ };
257
+ //# sourceMappingURL=subcommands-bundles.js.map