@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
@@ -28,6 +28,8 @@
28
28
  */
29
29
  import { promises as fs } from 'node:fs';
30
30
  import * as path from 'node:path';
31
+ import { captureDeploymentOutputs, recordDeploymentOutputs } from '../providers/deployment-ownership.mjs';
32
+ import { mergeClaudeAttribution, undoClaudeAttribution } from './claude-attribution.js';
31
33
  /**
32
34
  * Hook script → Claude Code hook event mapping.
33
35
  *
@@ -110,10 +112,12 @@ async function atomicWrite(filePath, content) {
110
112
  * written.
111
113
  */
112
114
  export async function installAiwgHooks(opts) {
115
+ const ownershipRoots = [path.join(opts.projectPath, '.claude')];
116
+ const ownershipBefore = opts.dryRun ? undefined : captureDeploymentOutputs(ownershipRoots);
113
117
  const sourceHooksDir = path.join(opts.frameworkRoot, 'agentic', 'code', 'addons', 'aiwg-hooks', 'hooks');
114
118
  let sourceFiles;
115
119
  try {
116
- sourceFiles = await fs.readdir(sourceHooksDir);
120
+ sourceFiles = opts.hooks === false ? [] : await fs.readdir(sourceHooksDir);
117
121
  }
118
122
  catch (err) {
119
123
  if (err.code === 'ENOENT')
@@ -128,10 +132,10 @@ export async function installAiwgHooks(opts) {
128
132
  };
129
133
  // 1. Copy hook scripts to .claude/hooks/
130
134
  const claudeHooksDir = path.join(opts.projectPath, '.claude', 'hooks');
131
- if (!opts.dryRun) {
135
+ if (!opts.dryRun && opts.hooks !== false) {
132
136
  await fs.mkdir(claudeHooksDir, { recursive: true });
133
137
  }
134
- for (const { file } of HOOK_SCRIPTS) {
138
+ for (const { file } of opts.hooks === false ? [] : HOOK_SCRIPTS) {
135
139
  if (!sourceFiles.includes(file)) {
136
140
  result.warnings.push(`hook script not found in addon source: ${file}`);
137
141
  continue;
@@ -177,76 +181,80 @@ export async function installAiwgHooks(opts) {
177
181
  }
178
182
  }
179
183
  catch (err) {
180
- result.warnings.push(`Backup failed: ${err instanceof Error ? err.message : String(err)}`);
184
+ throw new Error(`Backup failed; settings.json was not changed: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
181
185
  }
182
186
  }
183
- // 4. Normalize (migrate legacy array shape → object shape) and merge
184
- const [hooksObj, migrated] = normalizeHooks(settings.hooks);
185
- if (migrated) {
186
- result.migratedFromLegacy = true;
187
- result.warnings.push('Migrated legacy array-shaped hooks field to object form (#107).');
188
- }
189
- settings.hooks = hooksObj;
190
- for (const { file, events } of HOOK_SCRIPTS) {
191
- if (!sourceFiles.includes(file))
192
- continue;
193
- // Claude Code parses hook commands as shell command strings. Keep the
194
- // embedded script path POSIX-style on every host: native Windows
195
- // backslashes are interpreted as escapes and collapse into a nonexistent
196
- // path such as `.claudehooksaiwg-session.cjs` (#133).
197
- const script = path.posix.join('.claude', 'hooks', file);
198
- const hookId = file.replace(/\.(cjs|js)$/, '');
199
- for (const [event, argument] of Object.entries(events)) {
200
- const command = `node ${script}${argument ? ` ${argument}` : ''}`;
201
- if (!hooksObj[event])
202
- hooksObj[event] = [];
203
- const groups = hooksObj[event];
204
- // Find any existing AIWG-managed entry for this hookId and refresh
205
- // its `command` to the current script path/extension. Required for
206
- // users upgrading from pre-`.cjs` installs where the registered
207
- // command still references `aiwg-{session,trace,permissions}.js` —
208
- // those files no longer exist on disk after refresh, causing
209
- // `MODULE_NOT_FOUND` at `node:internal/modules/cjs/loader` on every
210
- // hook invocation. (Fixes regression report on Claude Code 2.1.157.)
211
- // Match by `_aiwg_id` first, then by the script path. An entry invoking an
212
- // AIWG-owned hook script without the managed tag is AIWG residue from an
213
- // earlier install; appending a managed entry beside it registers the hook
214
- // twice and runs it twice per event. Adopt it instead. (#2543)
215
- let updated = false;
216
- for (const group of groups) {
217
- if (!Array.isArray(group.hooks))
218
- continue;
219
- for (const h of group.hooks) {
220
- const sameId = h._aiwg_id === hookId;
221
- const sameScript = typeof h.command === 'string' && h.command.includes(script);
222
- if (!sameId && !sameScript)
187
+ if (opts.attribution !== false)
188
+ mergeClaudeAttribution(settings, result.warnings);
189
+ if (opts.hooks !== false) {
190
+ // 4. Normalize (migrate legacy array shape → object shape) and merge
191
+ const [hooksObj, migrated] = normalizeHooks(settings.hooks);
192
+ if (migrated) {
193
+ result.migratedFromLegacy = true;
194
+ result.warnings.push('Migrated legacy array-shaped hooks field to object form (#107).');
195
+ }
196
+ settings.hooks = hooksObj;
197
+ for (const { file, events } of HOOK_SCRIPTS) {
198
+ if (!sourceFiles.includes(file))
199
+ continue;
200
+ // Claude Code parses hook commands as shell command strings. Keep the
201
+ // embedded script path POSIX-style on every host: native Windows
202
+ // backslashes are interpreted as escapes and collapse into a nonexistent
203
+ // path such as `.claudehooksaiwg-session.cjs` (#133).
204
+ const script = path.posix.join('.claude', 'hooks', file);
205
+ const hookId = file.replace(/\.(cjs|js)$/, '');
206
+ for (const [event, argument] of Object.entries(events)) {
207
+ const command = `node ${script}${argument ? ` ${argument}` : ''}`;
208
+ if (!hooksObj[event])
209
+ hooksObj[event] = [];
210
+ const groups = hooksObj[event];
211
+ // Find any existing AIWG-managed entry for this hookId and refresh
212
+ // its `command` to the current script path/extension. Required for
213
+ // users upgrading from pre-`.cjs` installs where the registered
214
+ // command still references `aiwg-{session,trace,permissions}.js` —
215
+ // those files no longer exist on disk after refresh, causing
216
+ // `MODULE_NOT_FOUND` at `node:internal/modules/cjs/loader` on every
217
+ // hook invocation. (Fixes regression report on Claude Code 2.1.157.)
218
+ // Match by `_aiwg_id` first, then by the script path. An entry invoking an
219
+ // AIWG-owned hook script without the managed tag is AIWG residue from an
220
+ // earlier install; appending a managed entry beside it registers the hook
221
+ // twice and runs it twice per event. Adopt it instead. (#2543)
222
+ let updated = false;
223
+ for (const group of groups) {
224
+ if (!Array.isArray(group.hooks))
223
225
  continue;
224
- const adopting = !sameId && sameScript;
225
- if (h.command !== command || h.type !== 'command' || h._aiwg_managed !== true || h._aiwg_id !== hookId) {
226
- h.type = 'command';
227
- h.command = command;
228
- h._aiwg_managed = true;
229
- h._aiwg_id = hookId;
230
- result.warnings.push(adopting
231
- ? `Adopted pre-existing untagged ${event} → ${hookId} entry instead of registering a duplicate`
232
- : `Refreshed stale ${event} → ${hookId} command path`);
226
+ for (const h of group.hooks) {
227
+ const sameId = h._aiwg_id === hookId;
228
+ const sameScript = typeof h.command === 'string' && h.command.includes(script);
229
+ if (!sameId && !sameScript)
230
+ continue;
231
+ const adopting = !sameId && sameScript;
232
+ if (h.command !== command || h.type !== 'command' || h._aiwg_managed !== true || h._aiwg_id !== hookId) {
233
+ h.type = 'command';
234
+ h.command = command;
235
+ h._aiwg_managed = true;
236
+ h._aiwg_id = hookId;
237
+ result.warnings.push(adopting
238
+ ? `Adopted pre-existing untagged ${event} → ${hookId} entry instead of registering a duplicate`
239
+ : `Refreshed stale ${event} → ${hookId} command path`);
240
+ }
241
+ updated = true;
233
242
  }
234
- updated = true;
235
243
  }
244
+ if (updated)
245
+ continue;
246
+ groups.push({
247
+ hooks: [
248
+ {
249
+ type: 'command',
250
+ command,
251
+ _aiwg_managed: true,
252
+ _aiwg_id: hookId,
253
+ },
254
+ ],
255
+ });
256
+ result.registeredEvents.push(`${event} → ${hookId}`);
236
257
  }
237
- if (updated)
238
- continue;
239
- groups.push({
240
- hooks: [
241
- {
242
- type: 'command',
243
- command,
244
- _aiwg_managed: true,
245
- _aiwg_id: hookId,
246
- },
247
- ],
248
- });
249
- result.registeredEvents.push(`${event} → ${hookId}`);
250
258
  }
251
259
  }
252
260
  // 5. Atomic write
@@ -254,6 +262,21 @@ export async function installAiwgHooks(opts) {
254
262
  await fs.mkdir(path.dirname(result.settingsPath), { recursive: true });
255
263
  await atomicWrite(result.settingsPath, JSON.stringify(settings, null, 2) + '\n');
256
264
  }
265
+ if (ownershipBefore) {
266
+ const sidecar = ownershipBefore.get(path.join(opts.projectPath, '.claude/.aiwg-manifest.json'));
267
+ let recordedOwners = [];
268
+ try {
269
+ recordedOwners = JSON.parse(sidecar?.toString() || '{}').managed?.['settings.json']?.owners || [];
270
+ }
271
+ catch { /* Standalone installs retain the addon owner when no receipt verifies users. */ }
272
+ const owners = opts.frameworkSlug ? [opts.frameworkSlug] : recordedOwners;
273
+ let snapshot = ownershipBefore;
274
+ for (const owner of owners.length ? owners : ['aiwg-hooks']) {
275
+ recordDeploymentOutputs(snapshot, ownershipRoots, { frameworkSlug: owner, claimUnchangedSettings: opts.claimUnchangedSettings,
276
+ writtenFiles: [...result.installedScripts, result.settingsPath] });
277
+ snapshot = captureDeploymentOutputs(ownershipRoots);
278
+ }
279
+ }
257
280
  return result;
258
281
  }
259
282
  /**
@@ -278,11 +301,52 @@ export async function restoreSettingsBackup(projectPath) {
278
301
  const backups = entries
279
302
  .filter((e) => e.startsWith('settings.json.bak.'))
280
303
  .sort();
281
- if (backups.length === 0)
304
+ if (backups.length === 0) {
305
+ await removeClaudeAttribution(projectPath);
282
306
  return null;
307
+ }
283
308
  const latest = backups[backups.length - 1];
284
309
  const src = path.join(claudeDir, latest);
285
- await fs.copyFile(src, settingsPath);
310
+ const restored = JSON.parse(await fs.readFile(src, 'utf8'));
311
+ const currentRaw = await fs.readFile(settingsPath, 'utf8').catch((err) => {
312
+ if (err.code === 'ENOENT')
313
+ return null;
314
+ throw err;
315
+ });
316
+ // Attribution rollback is ownership-based; keep later operator edits.
317
+ if (currentRaw !== null) {
318
+ let current;
319
+ try {
320
+ current = JSON.parse(currentRaw);
321
+ }
322
+ catch { /* A corrupt current file must still be recoverable from backup. */ }
323
+ if (current && typeof current === 'object' && !Array.isArray(current)) {
324
+ undoClaudeAttribution(current);
325
+ if ('attribution' in current)
326
+ restored.attribution = current.attribution;
327
+ else
328
+ delete restored.attribution;
329
+ }
330
+ }
331
+ if (restored.aiwg)
332
+ delete restored.aiwg.attributionKeys;
333
+ await atomicWrite(settingsPath, JSON.stringify(restored, null, 2) + '\n');
286
334
  return src;
287
335
  }
336
+ /** Remove only unchanged attribution defaults owned by AIWG. */
337
+ export async function removeClaudeAttribution(projectPath, dryRun = false) {
338
+ const file = path.join(projectPath, '.claude', 'settings.json');
339
+ let settings;
340
+ try {
341
+ settings = JSON.parse(await fs.readFile(file, 'utf8'));
342
+ }
343
+ catch (err) {
344
+ if (err.code === 'ENOENT')
345
+ return;
346
+ throw err;
347
+ }
348
+ if (undoClaudeAttribution(settings) && !dryRun) {
349
+ await atomicWrite(file, JSON.stringify(settings, null, 2) + '\n');
350
+ }
351
+ }
288
352
  //# sourceMappingURL=claude-hooks-installer.js.map
@@ -0,0 +1,109 @@
1
+ export const daemonCommand = {
2
+ id: 'daemon',
3
+ type: 'skill',
4
+ name: 'Daemon',
5
+ description: 'Manage the daemon: start, stop, status, chat, attach and scheduled tasks',
6
+ version: '1.0.0',
7
+ capabilities: ['cli', 'daemon', 'lifecycle'],
8
+ keywords: ['daemon', 'start', 'stop', 'status', 'chat', 'attach'],
9
+ category: 'daemon',
10
+ platforms: { claude: 'full', generic: 'full' },
11
+ deployment: { pathTemplate: '.{platform}/commands/{id}.md', core: false },
12
+ metadata: {
13
+ type: 'skill',
14
+ triggerPhrases: ['daemon', 'daemon start', 'daemon status'],
15
+ commandHint: {
16
+ template: 'utility',
17
+ argumentHint: '<start|stop|status|restart|logs|chat|attach|task|init|rooms|autonomous|schedule|memory|pty> [options]',
18
+ allowedTools: ['Bash', 'Read', 'Write'],
19
+ },
20
+ },
21
+ };
22
+ export const behaviorCommand = {
23
+ id: 'behavior',
24
+ type: 'skill',
25
+ name: 'Behavior',
26
+ description: 'Manage behavior YAML bundles that bind directives and toolsets to agent types',
27
+ version: '1.0.0',
28
+ capabilities: ['cli', 'behavior', 'daemon', 'configuration'],
29
+ keywords: ['behavior', 'directive', 'toolset', 'daemon', 'ops', 'agent-type'],
30
+ category: 'daemon',
31
+ platforms: {
32
+ claude: 'full',
33
+ generic: 'full',
34
+ },
35
+ deployment: {
36
+ pathTemplate: '.{platform}/commands/{id}.md',
37
+ core: false,
38
+ },
39
+ metadata: {
40
+ type: 'skill',
41
+ triggerPhrases: ['behavior', 'list behaviors', 'apply behavior', 'manage behaviors'],
42
+ commandHint: {
43
+ template: 'utility',
44
+ argumentHint: '<list|info|apply|remove> [name] [--to <agent>] [--from <agent>]',
45
+ allowedTools: ['Read', 'Bash', 'Write'],
46
+ },
47
+ },
48
+ };
49
+ export const daemonInitCommand = {
50
+ id: 'daemon-init',
51
+ type: 'skill',
52
+ name: 'Daemon Init',
53
+ description: 'Initialize daemon config from a profile template (default: manager)',
54
+ version: '1.0.0',
55
+ capabilities: ['cli', 'daemon', 'configuration', 'scaffolding'],
56
+ keywords: ['daemon', 'init', 'profile', 'manager', 'orchestrator', 'config'],
57
+ category: 'daemon',
58
+ platforms: {
59
+ claude: 'full',
60
+ generic: 'full',
61
+ },
62
+ deployment: {
63
+ pathTemplate: '.{platform}/commands/{id}.md',
64
+ core: false,
65
+ },
66
+ metadata: {
67
+ type: 'skill',
68
+ triggerPhrases: ['daemon init', 'init daemon', 'initialize daemon', 'daemon setup'],
69
+ commandHint: {
70
+ template: 'utility',
71
+ argumentHint: '[profile-name] [--force]',
72
+ allowedTools: ['Bash', 'Read', 'Write'],
73
+ },
74
+ },
75
+ };
76
+ export const housekeeperCommand = {
77
+ id: 'housekeeper',
78
+ type: 'skill',
79
+ name: 'Housekeeper',
80
+ description: 'Deterministic maintenance daemon: start/stop/status/run-once, jobs, watch roots, autostart units',
81
+ version: '1.0.0',
82
+ capabilities: ['cli', 'daemon', 'maintenance', 'scheduler'],
83
+ keywords: ['housekeeper', 'daemon', 'maintenance', 'schedule', 'run-once', 'autostart'],
84
+ category: 'daemon',
85
+ platforms: {
86
+ claude: 'full',
87
+ generic: 'full',
88
+ },
89
+ deployment: {
90
+ pathTemplate: '.{platform}/commands/{id}.md',
91
+ core: false,
92
+ },
93
+ metadata: {
94
+ type: 'skill',
95
+ triggerPhrases: ['housekeeper', 'housekeeper status', 'housekeeper start', 'maintenance daemon'],
96
+ commandHint: {
97
+ template: 'utility',
98
+ argumentHint: '<start|stop|status|run-once|job|watch|install|uninstall> [options]',
99
+ allowedTools: ['Bash', 'Read', 'Write'],
100
+ executionSteps: [
101
+ 'Parse subcommand and flags',
102
+ 'Start/stop/query the housekeeper-profile daemon or edit its config',
103
+ 'Run one job without a daemon (run-once) or write autostart units (install)',
104
+ 'Display result',
105
+ ],
106
+ },
107
+ },
108
+ };
109
+ //# sourceMappingURL=daemon.js.map
@@ -10,6 +10,8 @@
10
10
  * @tests @test/unit/extensions/commands/definitions.test.ts
11
11
  * @issue #42
12
12
  */
13
+ import { daemonCommand, behaviorCommand, daemonInitCommand, housekeeperCommand } from './daemon.js';
14
+ export { daemonCommand, behaviorCommand, daemonInitCommand, housekeeperCommand } from './daemon.js';
13
15
  // ============================================
14
16
  // Individual Command Definitions
15
17
  // ============================================
@@ -3124,93 +3126,6 @@ export const reproducibilityValidateCommand = {
3124
3126
  },
3125
3127
  },
3126
3128
  };
3127
- export const behaviorCommand = {
3128
- id: 'behavior',
3129
- type: 'skill',
3130
- name: 'Behavior',
3131
- description: 'Manage behavior YAML bundles that bind directives and toolsets to agent types',
3132
- version: '1.0.0',
3133
- capabilities: ['cli', 'behavior', 'daemon', 'configuration'],
3134
- keywords: ['behavior', 'directive', 'toolset', 'daemon', 'ops', 'agent-type'],
3135
- category: 'daemon',
3136
- platforms: {
3137
- claude: 'full',
3138
- generic: 'full',
3139
- },
3140
- deployment: {
3141
- pathTemplate: '.{platform}/commands/{id}.md',
3142
- core: false,
3143
- },
3144
- metadata: {
3145
- type: 'skill',
3146
- triggerPhrases: ['behavior', 'list behaviors', 'apply behavior', 'manage behaviors'],
3147
- commandHint: {
3148
- template: 'utility',
3149
- argumentHint: '<list|info|apply|remove> [name] [--to <agent>] [--from <agent>]',
3150
- allowedTools: ['Read', 'Bash', 'Write'],
3151
- },
3152
- },
3153
- };
3154
- export const daemonInitCommand = {
3155
- id: 'daemon-init',
3156
- type: 'skill',
3157
- name: 'Daemon Init',
3158
- description: 'Initialize daemon config from a profile template (default: manager)',
3159
- version: '1.0.0',
3160
- capabilities: ['cli', 'daemon', 'configuration', 'scaffolding'],
3161
- keywords: ['daemon', 'init', 'profile', 'manager', 'orchestrator', 'config'],
3162
- category: 'daemon',
3163
- platforms: {
3164
- claude: 'full',
3165
- generic: 'full',
3166
- },
3167
- deployment: {
3168
- pathTemplate: '.{platform}/commands/{id}.md',
3169
- core: false,
3170
- },
3171
- metadata: {
3172
- type: 'skill',
3173
- triggerPhrases: ['daemon init', 'init daemon', 'initialize daemon', 'daemon setup'],
3174
- commandHint: {
3175
- template: 'utility',
3176
- argumentHint: '[profile-name] [--force]',
3177
- allowedTools: ['Bash', 'Read', 'Write'],
3178
- },
3179
- },
3180
- };
3181
- export const housekeeperCommand = {
3182
- id: 'housekeeper',
3183
- type: 'skill',
3184
- name: 'Housekeeper',
3185
- description: 'Deterministic maintenance daemon: start/stop/status/run-once, jobs, watch roots, autostart units',
3186
- version: '1.0.0',
3187
- capabilities: ['cli', 'daemon', 'maintenance', 'scheduler'],
3188
- keywords: ['housekeeper', 'daemon', 'maintenance', 'schedule', 'run-once', 'autostart'],
3189
- category: 'daemon',
3190
- platforms: {
3191
- claude: 'full',
3192
- generic: 'full',
3193
- },
3194
- deployment: {
3195
- pathTemplate: '.{platform}/commands/{id}.md',
3196
- core: false,
3197
- },
3198
- metadata: {
3199
- type: 'skill',
3200
- triggerPhrases: ['housekeeper', 'housekeeper status', 'housekeeper start', 'maintenance daemon'],
3201
- commandHint: {
3202
- template: 'utility',
3203
- argumentHint: '<start|stop|status|run-once|job|watch|install|uninstall> [options]',
3204
- allowedTools: ['Bash', 'Read', 'Write'],
3205
- executionSteps: [
3206
- 'Parse subcommand and flags',
3207
- 'Start/stop/query the housekeeper-profile daemon or edit its config',
3208
- 'Run one job without a daemon (run-once) or write autostart units (install)',
3209
- 'Display result',
3210
- ],
3211
- },
3212
- },
3213
- };
3214
3129
  // Config Commands
3215
3130
  export const configCommand = {
3216
3131
  id: 'config',
@@ -3794,7 +3709,7 @@ export const rlmCacheCommand = {
3794
3709
  * - SDLC Orchestration (1): sdlc-accelerate
3795
3710
  * - Index (1): index
3796
3711
  * - Reproducibility (4): execution-mode, snapshot, checkpoint, reproducibility-validate
3797
- * - Daemon (3): behavior, daemon-init, housekeeper
3712
+ * - Daemon (4): daemon, behavior, daemon-init, housekeeper
3798
3713
  * - Config (1): config
3799
3714
  * - Ops (1): ops
3800
3715
  * - Agentic Tools (5): chunk, fanout, rlm-prep, rlm-search, rlm-status
@@ -3925,7 +3840,8 @@ export const commandDefinitions = [
3925
3840
  snapshotCommand,
3926
3841
  checkpointCommand,
3927
3842
  reproducibilityValidateCommand,
3928
- // Daemon (3)
3843
+ // Daemon (4)
3844
+ daemonCommand,
3929
3845
  behaviorCommand,
3930
3846
  daemonInitCommand,
3931
3847
  housekeeperCommand,