@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
@@ -11,9 +11,11 @@
11
11
  * @implements .aiwg/architecture/adr-skills-canonical-extension-type.md
12
12
  * @issue #550
13
13
  */
14
- import { createHash } from 'node:crypto';
15
14
  import fs from 'fs/promises';
16
15
  import path from 'path';
16
+ export { parseFrontmatter, providerNeedsCommands, providerUsesSkillsNatively } from './skill-command-frontmatter.js';
17
+ import { recordManagedCommands } from './command-ownership.js';
18
+ import { parseFrontmatter, providerNeedsCommands } from './skill-command-frontmatter.js';
17
19
  /**
18
20
  * Ownership signal for generated command files (#2507).
19
21
  *
@@ -24,7 +26,6 @@ import path from 'path';
24
26
  * same signals as any other deployed artifact, tagged `skill-command` so the
25
27
  * flat-command prune leaves them to the skills prune that governs their source.
26
28
  */
27
- const MANAGED_SIDECAR = '.aiwg-manifest.json';
28
29
  const MANAGED_MARKER_PATTERN = /^(?:<!--\s*aiwg:managed\s|#\s*aiwg:managed\s)/m;
29
30
  function addManagedMarker(content, version, source) {
30
31
  if (MANAGED_MARKER_PATTERN.test(content))
@@ -35,235 +36,8 @@ function addManagedMarker(content, version, source) {
35
36
  return `<!-- aiwg:managed v${version} ${source} -->\n${content}`;
36
37
  }
37
38
  /**
38
- * Merge generated command entries into a directory's managed sidecar.
39
- *
40
- * Best-effort: a translation that cannot record ownership still produced a
41
- * usable command file, so a sidecar failure must not fail the deploy.
42
- */
43
- async function recordManagedCommands(targetDir, entries, version, source) {
44
- if (entries.length === 0)
45
- return;
46
- const sidecarPath = path.join(targetDir, MANAGED_SIDECAR);
47
- let sidecar = { managed: {} };
48
- try {
49
- const parsed = JSON.parse(await fs.readFile(sidecarPath, 'utf-8'));
50
- if (parsed && typeof parsed === 'object' && parsed.managed)
51
- sidecar = parsed;
52
- }
53
- catch {
54
- // No sidecar yet, or unreadable — start a fresh managed map.
55
- }
56
- for (const entry of entries) {
57
- sidecar.managed[entry.filename] = {
58
- hash: `sha256:${createHash('sha256').update(entry.content).digest('hex')}`,
59
- source,
60
- version,
61
- kind: 'skill-command',
62
- };
63
- }
64
- try {
65
- await fs.writeFile(sidecarPath, `${JSON.stringify(sidecar, null, 2)}\n`, 'utf-8');
66
- }
67
- catch {
68
- // Non-fatal — the command files themselves are already written.
69
- }
70
- }
71
- // ============================================
72
- // Provider Configuration
73
- // ============================================
74
- /**
75
- * Providers that need command files generated from skills.
76
- *
77
- * Providers not listed here get skills deployed natively (no translation needed).
78
- */
79
- const PROVIDERS_NEEDING_COMMANDS = new Set([
80
- 'factory',
81
- 'opencode', // OpenCode scans .opencode/command/**/*.md via ConfigCommand.load() (PUW-006 #1107)
82
- 'warp',
83
- 'windsurf',
84
- 'copilot',
85
- 'codex',
86
- 'openclaw',
87
- ]);
88
- /**
89
- * Providers where skills are deployed natively (no command generation needed).
90
- */
91
- const SKILLS_ONLY_PROVIDERS = new Set([
92
- 'antigravity',
93
- 'claude',
94
- 'cursor',
95
- 'grokbot',
96
- 'hermes',
97
- 'muse', // #236: skills deploy natively; no command translation (indexed-only agents/commands/rules)
98
- 'openhuman',
99
- 'pi',
100
- 'omp',
101
- ]);
102
- /**
103
- * Check if a provider needs command files generated from skills.
104
- */
105
- export function providerNeedsCommands(provider) {
106
- return PROVIDERS_NEEDING_COMMANDS.has(provider);
107
- }
108
- /**
109
- * Check if a provider uses skills natively (no command translation).
39
+ * Parsed SKILL.md frontmatter fields relevant to command translation
110
40
  */
111
- export function providerUsesSkillsNatively(provider) {
112
- return SKILLS_ONLY_PROVIDERS.has(provider);
113
- }
114
- // ============================================
115
- // Frontmatter Parsing
116
- // ============================================
117
- /**
118
- * Parse YAML-like frontmatter from a SKILL.md file.
119
- *
120
- * This is a lightweight parser that handles the subset of YAML used in
121
- * SKILL.md frontmatter. For full YAML support, a library like js-yaml
122
- * would be needed, but the frontmatter format is simple enough for this.
123
- */
124
- export function parseFrontmatter(content) {
125
- const fmMatch = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
126
- if (!fmMatch) {
127
- return { frontmatter: {}, body: content };
128
- }
129
- const fmRaw = fmMatch[1];
130
- const body = fmMatch[2];
131
- const frontmatter = {};
132
- // Parse top-level keys
133
- const lines = fmRaw.split('\n');
134
- let i = 0;
135
- while (i < lines.length) {
136
- const line = lines[i];
137
- // description: ...
138
- const descMatch = line.match(/^description:\s*(.+)/);
139
- if (descMatch) {
140
- frontmatter.description = descMatch[1].trim();
141
- i++;
142
- continue;
143
- }
144
- // userInvocable: false
145
- const uiMatch = line.match(/^userInvocable:\s*(true|false)/i);
146
- if (uiMatch) {
147
- frontmatter.userInvocable = uiMatch[1].toLowerCase() === 'true';
148
- i++;
149
- continue;
150
- }
151
- // user-invocable: false (kebab-case variant)
152
- const uiKebabMatch = line.match(/^user-invocable:\s*(true|false)/i);
153
- if (uiKebabMatch) {
154
- frontmatter.userInvocable = uiKebabMatch[1].toLowerCase() === 'true';
155
- i++;
156
- continue;
157
- }
158
- // effort: N
159
- const effortMatch = line.match(/^effort:\s*(\d+)/);
160
- if (effortMatch) {
161
- frontmatter.effort = parseInt(effortMatch[1], 10);
162
- i++;
163
- continue;
164
- }
165
- // context: fork|inherit
166
- const ctxMatch = line.match(/^context:\s*(\w+)/);
167
- if (ctxMatch) {
168
- frontmatter.context = ctxMatch[1];
169
- i++;
170
- continue;
171
- }
172
- // disableModelInvocation: true
173
- const dmiMatch = line.match(/^(?:disableModelInvocation|disable-model-invocation):\s*(true|false)/i);
174
- if (dmiMatch) {
175
- frontmatter.disableModelInvocation = dmiMatch[1].toLowerCase() === 'true';
176
- i++;
177
- continue;
178
- }
179
- // allowed-tools: (top-level, for the skill itself)
180
- const atMatch = line.match(/^allowed-tools:\s*(.+)/);
181
- if (atMatch) {
182
- frontmatter.allowedTools = atMatch[1].trim();
183
- i++;
184
- continue;
185
- }
186
- // commandHint: block
187
- if (line.match(/^commandHint:\s*$/)) {
188
- const hint = {};
189
- i++;
190
- while (i < lines.length && lines[i].match(/^\s+/)) {
191
- const hintLine = lines[i].trim();
192
- const ahMatch = hintLine.match(/^argumentHint:\s*(.+)/);
193
- if (ahMatch) {
194
- hint.argumentHint = ahMatch[1].trim();
195
- i++;
196
- continue;
197
- }
198
- const hatMatch = hintLine.match(/^allowedTools:\s*(.+)/);
199
- if (hatMatch) {
200
- hint.allowedTools = hatMatch[1].trim();
201
- i++;
202
- continue;
203
- }
204
- const tmplMatch = hintLine.match(/^template:\s*(.+)/);
205
- if (tmplMatch) {
206
- hint.template = tmplMatch[1].trim();
207
- i++;
208
- continue;
209
- }
210
- const modMatch = hintLine.match(/^model:\s*(.+)/);
211
- if (modMatch) {
212
- hint.model = modMatch[1].trim();
213
- i++;
214
- continue;
215
- }
216
- const roleMatch = hintLine.match(/^modelRole:\s*(reasoning|coding|efficiency)\s*$/);
217
- if (roleMatch) {
218
- hint.modelRole = roleMatch[1];
219
- i++;
220
- continue;
221
- }
222
- const tierMatch = hintLine.match(/^modelTier:\s*(economy|standard|premium)\s*$/);
223
- if (tierMatch) {
224
- hint.modelTier = tierMatch[1];
225
- i++;
226
- continue;
227
- }
228
- const effortMatch = hintLine.match(/^modelEffort:\s*(minimal|low|medium|high|xhigh)\s*$/);
229
- if (effortMatch) {
230
- hint.modelEffort = effortMatch[1];
231
- i++;
232
- continue;
233
- }
234
- const rationaleMatch = hintLine.match(/^modelRationale:\s*(.+)$/);
235
- if (rationaleMatch) {
236
- hint.modelRationale = rationaleMatch[1].trim();
237
- i++;
238
- continue;
239
- }
240
- const catMatch = hintLine.match(/^category:\s*(.+)/);
241
- if (catMatch) {
242
- hint.category = catMatch[1].trim();
243
- i++;
244
- continue;
245
- }
246
- const orchMatch = hintLine.match(/^orchestration:\s*(true|false)/i);
247
- if (orchMatch) {
248
- hint.orchestration = orchMatch[1].toLowerCase() === 'true';
249
- i++;
250
- continue;
251
- }
252
- const cliMatch = hintLine.match(/^cliDisabled:\s*(true|false)/i);
253
- if (cliMatch) {
254
- hint.cliDisabled = cliMatch[1].toLowerCase() === 'true';
255
- i++;
256
- continue;
257
- }
258
- i++;
259
- }
260
- frontmatter.commandHint = hint;
261
- continue;
262
- }
263
- i++;
264
- }
265
- return { frontmatter, body };
266
- }
267
41
  // ============================================
268
42
  // Command Generation
269
43
  // ============================================
@@ -413,9 +187,9 @@ export async function translateSkillsToCommands(skillsDir, options) {
413
187
  const promptPath = path.join(promptsDir, `${skillName}.prompt.md`);
414
188
  await fs.mkdir(promptsDir, { recursive: true });
415
189
  await fs.writeFile(promptPath, commandContent, 'utf-8');
416
- promptEntries.push({ filename: `${skillName}.prompt.md`, content: commandContent });
190
+ promptEntries.push({ filename: `${skillName}.prompt.md`, content: commandContent, sourcePath: skillMdPath });
417
191
  }
418
- managedEntries.push({ filename: commandFilename, content: commandContent });
192
+ managedEntries.push({ filename: commandFilename, content: commandContent, sourcePath: skillMdPath });
419
193
  }
420
194
  result.translated.push(translated);
421
195
  if (options.verbose) {
@@ -4,6 +4,7 @@ import { basename, dirname, isAbsolute, relative, resolve } from 'node:path';
4
4
  import { effectSession, openLedger } from '../effects/host.js';
5
5
  import { loadHitlLayers } from './hitl-config.js';
6
6
  import { recordHitlAuthorization } from './hitl-receipt.js';
7
+ import { consumeHitlAuthorization } from './hitl-consume.js';
7
8
  import { resolveHitlAuthorization, validHitlAction } from './hitl.js';
8
9
  /** Resolve existing ancestors as well as new leaves; dangling links fail closed. */
9
10
  async function canonical(path) {
@@ -54,24 +55,33 @@ export async function canonicalHitlAction(projectDir, input) {
54
55
  }
55
56
  /** No receipt, no automatic action. Errors retain the caller's existing review path. */
56
57
  export async function checkHitlAuthorization(projectDir, input, options = {}) {
57
- let context = { now: new Date().toISOString(), layers: [], ...options };
58
+ let context = { ...options, now: options.now ?? new Date().toISOString(), layers: [] };
58
59
  try {
59
60
  const loaded = await loadHitlLayers(projectDir);
60
61
  context = { ...context, layers: loaded.layers };
61
62
  const action = await canonicalHitlAction(loaded.projectDir, input);
63
+ if (options.receipt) {
64
+ const ledger = openLedger(await effectSession(loaded.projectDir, 'custom', { clock: () => Date.parse(context.now) }));
65
+ const consumed = await consumeHitlAuthorization(ledger, action, context, options.receipt);
66
+ return consumed.decision === 'auto-authorized' ? { ...consumed, receipt: options.receipt } : consumed;
67
+ }
62
68
  const decision = resolveHitlAuthorization(action, context);
63
69
  if (decision.decision !== 'auto-authorized')
64
70
  return decision;
65
71
  // Reload policies and the clock at consumption time, including expiry and revocation.
66
- context = { ...context, now: new Date().toISOString(), layers: (await loadHitlLayers(projectDir)).layers,
72
+ context = { ...context, now: options.now ?? new Date().toISOString(), layers: (await loadHitlLayers(projectDir)).layers,
67
73
  expectedPolicyVersion: options.expectedPolicyVersion ?? decision.policyVersion };
68
- const ledger = openLedger(await effectSession(loaded.projectDir, 'custom'));
74
+ const ledger = openLedger(await effectSession(loaded.projectDir, 'custom', { clock: () => Date.parse(context.now) }));
69
75
  const recorded = await recordHitlAuthorization(ledger, action, context);
70
76
  if (recorded.resolution.decision !== 'auto-authorized')
71
77
  return recorded.resolution;
72
78
  if (recorded.reconciled.result.verification.result !== 'present')
73
79
  throw new Error('Unverified HITL receipt');
74
- return { ...recorded.resolution, receipt: { file: recorded.file, effectId: recorded.intent.effectId } };
80
+ const receipt = { file: recorded.file, effectId: recorded.intent.effectId };
81
+ context = { ...context, now: options.now ?? new Date().toISOString(), layers: (await loadHitlLayers(projectDir)).layers,
82
+ expectedPolicyVersion: options.expectedPolicyVersion };
83
+ const consumed = await consumeHitlAuthorization(ledger, action, context, receipt);
84
+ return consumed.decision === 'auto-authorized' ? { ...consumed, receipt } : consumed;
75
85
  }
76
86
  catch {
77
87
  return { ...resolveHitlAuthorization(null, context), decision: 'escalate', reason: 'authorization-check-unavailable' };
@@ -0,0 +1,54 @@
1
+ // Verifies a persisted HITL receipt against the exact host effect and current authority.
2
+ import { readFile } from 'node:fs/promises';
3
+ import { resolve } from 'node:path';
4
+ import { resolveProjectAiwgDirForWrite } from '../config/project-artifacts.js';
5
+ import { lookupEffect } from '../effects/ledger.js';
6
+ import { payloadDigest } from '../effects/identity.js';
7
+ import { fileDigestVerifier } from '../effects/verifiers/file.js';
8
+ import { runVerifier } from '../effects/verifiers/registry.js';
9
+ import { hitlDigest, resolveHitlAuthorization, validHitlAction } from './hitl.js';
10
+ /** Receipt existence is historical evidence; only this fresh comparison authorizes dispatch. */
11
+ export async function consumeHitlAuthorization(ledger, action, context, reference) {
12
+ const resolution = resolveHitlAuthorization(action, context);
13
+ const refuse = (reason) => ({ ...resolution, decision: 'escalate', reason });
14
+ if (!validHitlAction(action))
15
+ return refuse('invalid-action-descriptor');
16
+ const effect = await lookupEffect(ledger, reference.effectId);
17
+ const intent = effect.records.find(record => record.phase === 'intent');
18
+ if (effect.kind !== 'file.digest' || effect.tombstoned || effect.result !== 'present' || !intent
19
+ || effect.target !== `file:${resolve(reference.file)}@${intent.payloadDigest}`)
20
+ return refuse('approval-unverified');
21
+ const verification = await runVerifier(fileDigestVerifier({ root: resolveProjectAiwgDirForWrite(ledger.projectDir) }), {
22
+ effectId: reference.effectId, scope: ledger.scope, kind: effect.kind, target: effect.target,
23
+ context: {}, payloadDigest: intent.payloadDigest, intentRecordedAt: intent.recordedAt, expected: { digest: intent.payloadDigest },
24
+ });
25
+ if (verification.observation.result !== 'present')
26
+ return refuse('approval-unverified');
27
+ const bytes = await readFile(reference.file, 'utf8');
28
+ if (payloadDigest(bytes) !== intent.payloadDigest)
29
+ return refuse('approval-unverified');
30
+ const receipt = JSON.parse(bytes);
31
+ if (receipt.kind !== 'hitl-authorization' || receipt.decision !== 'auto-authorized')
32
+ return refuse('approval-not-authorized');
33
+ if (action.category === 'repo.edit' && (!receipt.action?.actorDigest || !receipt.action?.inputDigest || !receipt.expiresAt)) {
34
+ return refuse('approval-missing-bindings');
35
+ }
36
+ if (receipt.action?.actorDigest !== (action.actor === undefined ? undefined : hitlDigest(action.actor)))
37
+ return refuse('approval-actor-mismatch');
38
+ if (receipt.action?.inputDigest !== action.inputDigest)
39
+ return refuse('approval-input-mismatch');
40
+ if (receipt.action?.descriptorDigest !== hitlDigest(action))
41
+ return refuse('approval-descriptor-mismatch');
42
+ const now = Date.parse(context.now);
43
+ if (!Number.isFinite(now))
44
+ return refuse('invalid-clock');
45
+ if (!Number.isFinite(Date.parse(receipt.expiresAt)) || now >= Date.parse(receipt.expiresAt))
46
+ return refuse('approval-expired');
47
+ if (resolution.decision !== 'auto-authorized')
48
+ return resolution;
49
+ if (receipt.policyVersion !== resolution.policyVersion || receipt.sessionGrantDigest !== hitlDigest(context.sessionAuthorization ?? null)) {
50
+ return refuse('stale-policy-version');
51
+ }
52
+ return resolution;
53
+ }
54
+ //# sourceMappingURL=hitl-consume.js.map
@@ -20,6 +20,8 @@ export async function recordHitlAuthorization(ledger, action, context) {
20
20
  action: validHitlAction(action) ? {
21
21
  category: HITL_CATEGORIES.find(category => category === action.category) ?? 'restricted',
22
22
  descriptorDigest: hitlDigest(action), categoryDigest: hitlDigest(action.category),
23
+ ...(action.actor === undefined ? {} : { actorDigest: hitlDigest(action.actor) }),
24
+ ...(action.inputDigest === undefined ? {} : { inputDigest: action.inputDigest }),
23
25
  reversible: action.reversible, impact: action.impact,
24
26
  } : { descriptorDigest: hitlDigest(action) },
25
27
  scope: validHitlAction(action) ? {
@@ -19,7 +19,11 @@ export function validHitlAction(value) {
19
19
  }
20
20
  function actionFieldsValid(a) {
21
21
  const keys = ['category', 'repo', 'environment', 'resources', 'reversible', 'impact'];
22
- return Object.keys(a).length === keys.length && keys.every(k => Object.hasOwn(a, k))
22
+ const binding = ['actor', 'inputDigest'];
23
+ return Object.keys(a).every(k => [...keys, ...binding].includes(k)) && keys.every(k => Object.hasOwn(a, k))
24
+ && (a.category !== 'repo.edit' || (binding.every(k => Object.hasOwn(a, k)) && typeof a.actor === 'string' && typeof a.inputDigest === 'string'))
25
+ && (a.actor === undefined || (typeof a.actor === 'string' && identifier.test(a.actor)))
26
+ && (a.inputDigest === undefined || (typeof a.inputDigest === 'string' && /^sha256:[a-f0-9]{64}$/.test(a.inputDigest)))
23
27
  && [a.category, a.repo, a.environment].every(x => typeof x === 'string' && identifier.test(x))
24
28
  && Array.isArray(a.resources) && a.resources.length > 0 && a.resources.every(p => typeof p === 'string' && pathValid(p))
25
29
  && typeof a.reversible === 'boolean' && ['low', 'medium', 'high'].includes(a.impact);
@@ -89,13 +93,16 @@ export function resolveHitlAuthorization(action, context) {
89
93
  const probe = { version: '1', enabled: true, reviewedAt: context.now, maxAgeSeconds: 1,
90
94
  expiresAt: session.profile.expiresAt, profiles: { session: session.profile }, deny: [], requireReview: [] };
91
95
  if (!validateHitlPolicy(probe).length && grant(session.profile, action, now))
92
- return result('auto-authorized', 'session-user-authorization', 'session-user', 'session');
96
+ return {
97
+ ...result('auto-authorized', 'session-user-authorization', 'session-user', 'session'), expiresAt: session.profile.expiresAt,
98
+ };
93
99
  }
94
100
  if (context.expectedPolicyVersion && policyVersion !== context.expectedPolicyVersion)
95
101
  return result('escalate', 'stale-policy-version', 'project-policy');
96
102
  if (!context.layers.length)
97
103
  return result('escalate', 'no-project-policy', 'default');
98
104
  let matched = null;
105
+ let expires = Infinity;
99
106
  for (const layer of context.layers) {
100
107
  const p = layer.policy;
101
108
  if (!p?.enabled)
@@ -111,7 +118,8 @@ export function resolveHitlAuthorization(action, context) {
111
118
  if (!entry)
112
119
  return result('escalate', 'outside-profile-or-expired', 'project-policy');
113
120
  matched = entry[0];
121
+ expires = Math.min(expires, Date.parse(p.expiresAt), reviewed + p.maxAgeSeconds * 1000, Date.parse(entry[1].expiresAt));
114
122
  }
115
- return result('auto-authorized', 'bounded-project-policy', 'project-policy', matched);
123
+ return { ...result('auto-authorized', 'bounded-project-policy', 'project-policy', matched), expiresAt: new Date(expires).toISOString() };
116
124
  }
117
125
  //# sourceMappingURL=hitl.js.map
@@ -0,0 +1,26 @@
1
+ // Refresh recorded context digests through the same rollback-safe writer.
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ export function refreshRecordedContextOutput(file, previousHash, currentHash, write) {
5
+ if (!previousHash || previousHash === currentHash || path.basename(file) === '.aiwg-manifest.json')
6
+ return;
7
+ const sidecar = path.join(path.dirname(file), '.aiwg', '.aiwg-manifest.json');
8
+ let receipt;
9
+ try {
10
+ if (!fs.lstatSync(path.dirname(sidecar)).isDirectory() || fs.lstatSync(path.dirname(sidecar)).isSymbolicLink()
11
+ || !fs.lstatSync(sidecar).isFile() || fs.lstatSync(sidecar).isSymbolicLink())
12
+ return;
13
+ receipt = JSON.parse(fs.readFileSync(sidecar, 'utf8'));
14
+ }
15
+ catch (error) {
16
+ if (['ENOENT', 'ENOTDIR'].includes(error.code || '') || error instanceof SyntaxError)
17
+ return;
18
+ throw error;
19
+ }
20
+ const entry = receipt.scope === 'project' && receipt.managed?.[path.basename(file)];
21
+ if (!entry?.owners?.length || entry.hash !== `sha256:${previousHash}`)
22
+ return;
23
+ entry.hash = `sha256:${currentHash}`;
24
+ write(sidecar, `${JSON.stringify(receipt, null, 2)}\n`);
25
+ }
26
+ //# sourceMappingURL=context-output-ownership.js.map
@@ -0,0 +1,19 @@
1
+ import type { PathLike } from 'node:fs';
2
+ export interface DeploymentOwnershipOptions {
3
+ dryRun?: boolean;
4
+ claimUnchangedSettings?: boolean;
5
+ onlyDeclared?: boolean;
6
+ srcRoot?: string;
7
+ target?: string;
8
+ writeReceipt?: (file: string, content: string) => void;
9
+ mode?: string;
10
+ frameworkSlug?: string;
11
+ writtenFiles?: string[];
12
+ logicalInputPath?: (file: string) => string;
13
+ }
14
+ export function deploymentOutputRoots(provider: { name: string; paths?: Record<string, string>; kernelSkillsPath?: string }, target: string): string[];
15
+ export function captureDeploymentOutputs(roots: PathLike[]): Map<string, Buffer>;
16
+ export function recordDeploymentOutputs(before: Map<string, Buffer>, roots: PathLike[], opts?: DeploymentOwnershipOptions): void;
17
+ export function refreshSettingsDigests(record: { settings?: Record<string, unknown> }): void;
18
+
19
+ export function deploymentOwner(opts: DeploymentOwnershipOptions): string | undefined;