@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,148 @@
1
+ // Validate and promote staged deployment plans through safe writers.
2
+ import fs from 'node:fs';
3
+ import path from 'node:path';
4
+ import { importImpl } from '../../_resolve-impl.mjs';
5
+ const { refreshSettingsDigests } = await importImpl(import.meta.url, 'providers/deployment-ownership.mjs');
6
+ import {
7
+ contentHash,
8
+ deploySkillsWithKernelRouting,
9
+ getAddonSkillDirs,
10
+ getFrameworksForMode,
11
+ isKernelSkill,
12
+ listSkillDirs,
13
+ } from './base.mjs';
14
+ import { writeContextFileSync } from './context-write.mjs';
15
+ import {
16
+ fileDigest,
17
+ PREPARATION_HOOK,
18
+ promoteDirectories,
19
+ put,
20
+ read,
21
+ walk,
22
+ } from './rule-delivery-surface.mjs';
23
+ import { prepareRuleDeployment } from './rule-deployment-prepare.mjs';
24
+ import {
25
+ captureAnchors,
26
+ capturePreimage,
27
+ detachRuleDeploymentPlan,
28
+ disposeRuleDeploymentPlan,
29
+ planOwner,
30
+ RuleDeploymentStaleError,
31
+ snapshotPreimages,
32
+ verifyInputPool,
33
+ within,
34
+ } from './rule-deployment-state.mjs';
35
+
36
+ /** Validate every captured input before applying a staged provider plan. */
37
+ export function commitRuleDeploymentPlan(plan) {
38
+ if (plan.noop) return plan.report;
39
+ try {
40
+ if (plan.version !== 1 || !plan.temp || !plan.stage || !Array.isArray(plan.preimages)) throw new Error('Invalid rule deployment plan');
41
+ const owner = planOwner(plan);
42
+ if (!owner) throw new Error('Unowned or modified rule deployment plan');
43
+ if (owner.pool) { if (plan.poolSeal !== owner.pool.inventorySeal) throw new Error('Shared input pool lease changed'); verifyInputPool(owner.pool); }
44
+ if (JSON.stringify(snapshotPreimages(plan.staged.map(item => item.path))) !== JSON.stringify(plan.staged)) throw new Error('Staged provider output changed');
45
+ if (JSON.stringify(captureAnchors(plan.anchors.map(item => item.path))) !== JSON.stringify(plan.anchors)) {
46
+ throw new RuleDeploymentStaleError('Provider deployment root or ancestor changed', plan.anchors.map(item => item.path));
47
+ }
48
+ const stale = plan.preimages.filter(item => JSON.stringify(capturePreimage(item.path)) !== JSON.stringify(item.state)).map(item => item.path);
49
+ if (stale.length) throw new RuleDeploymentStaleError(`Provider deployment preimage changed: ${stale.join(', ')}`, stale);
50
+ const { target, stage, rootNames } = plan;
51
+ for (const dir of plan.workspaceDirs || []) fs.mkdirSync(path.join(target, dir), { recursive: true });
52
+ const mappings = plan.mappings.map(({ from, to, before }) => ({ from, to, before: new Map(before) }));
53
+ const normalize = content => {
54
+ for (const mapping of [...mappings].sort((a, b) => b.to.length - a.to.length)) content = content.split(mapping.to).join(mapping.from);
55
+ for (const mapping of [...plan.sourceMappings].sort((a, b) => b.to.length - a.to.length)) content = content.split(mapping.to).join(mapping.from);
56
+ return content.split(plan.snapshotRoot).join(plan.corpusRoot).split(stage).join(target);
57
+ };
58
+ const normalizeReceipt = (file, output) => {
59
+ if (path.basename(file) !== '.aiwg-manifest.json') return output;
60
+ const receipt = JSON.parse(output.toString('utf8'));
61
+ for (const [name, record] of Object.entries(receipt.managed || {})) {
62
+ const base = file === path.join(stage, '.aiwg/.aiwg-manifest.json') && receipt.scope === 'project' ? stage : path.dirname(file);
63
+ const recordedFile = path.resolve(base, name);
64
+ if (!within(base, recordedFile) || !fs.existsSync(recordedFile)) continue;
65
+ const recorded = fs.readFileSync(recordedFile);
66
+ if (record.hash !== `sha256:${contentHash(recorded)}`) continue;
67
+ const promoted = recorded.includes(0) ? recorded : Buffer.from(normalize(recorded.toString('utf8')));
68
+ record.hash = `sha256:${contentHash(promoted)}`;
69
+ refreshSettingsDigests(record);
70
+ }
71
+ return Buffer.from(`${JSON.stringify(receipt, null, 2)}\n`);
72
+ };
73
+ const delegated = (from, rel) => mappings.some(mapping => mapping.from !== from
74
+ && mapping.from.startsWith(`${from}${path.sep}`)
75
+ && (path.join(from, rel) === mapping.from || path.join(from, rel).startsWith(`${mapping.from}${path.sep}`)));
76
+ for (const { from, to, before } of mappings) {
77
+ if (!fs.existsSync(to)) {
78
+ if (before.size) fs.rmSync(from, { recursive: true, force: true });
79
+ continue;
80
+ }
81
+ promoteDirectories(to, from, rel => delegated(from, rel));
82
+ const after = new Set(walk(to).map(file => path.relative(to, file)).filter(rel => !delegated(from, rel)));
83
+ for (const rel of before.keys()) if (!delegated(from, rel) && !after.has(rel)) {
84
+ fs.rmSync(path.join(from, rel), { force: true });
85
+ // A pruned managed skill must disappear as a directory too. Remove
86
+ // only empty parents absent from the staged result; preserve siblings.
87
+ let parent = path.dirname(rel);
88
+ while (parent !== '.' && !fs.existsSync(path.join(to, parent))) {
89
+ try { fs.rmdirSync(path.join(from, parent)); } catch { break; }
90
+ parent = path.dirname(parent);
91
+ }
92
+ }
93
+ for (const rel of after) {
94
+ const file = path.join(to, rel);
95
+ if (before.get(rel) === fileDigest(file)) continue;
96
+ const buffer = fs.readFileSync(file);
97
+ // Provider output includes binary skill resources; normalize text only.
98
+ let output = buffer.includes(0) ? buffer : Buffer.from(normalize(buffer.toString('utf8')));
99
+ output = normalizeReceipt(file, output);
100
+ fs.mkdirSync(path.dirname(path.join(from, rel)), { recursive: true });
101
+ if (plan.contextWrites.includes(file)) writeContextFileSync(path.join(from, rel), output);
102
+ else fs.writeFileSync(path.join(from, rel), output);
103
+ }
104
+ }
105
+ for (const name of rootNames) if (fs.existsSync(path.join(stage, name))) {
106
+ const output = normalizeReceipt(path.join(stage, name), Buffer.from(normalize(read(path.join(stage, name))))).toString('utf8');
107
+ if (output === read(path.join(target, name))) continue;
108
+ const write = plan.contextWrites.includes(path.join(stage, name)) ? writeContextFileSync : put;
109
+ write(path.join(target, name), output);
110
+ }
111
+ return plan.report;
112
+ } finally {
113
+ disposeRuleDeploymentPlan(plan);
114
+ }
115
+ }
116
+
117
+ /** Stage and commit serially for existing provider callers. */
118
+ export async function deployWithRuleDelivery(original, provider, deploy) {
119
+ // Kernel source passes share the same selected rule set. Deploy their
120
+ // skills directly; the final source projects rules and bindings across the
121
+ // complete destination. Full passes retain staging for bound flow skills
122
+ // and provider definitions, but defer rule presentation above.
123
+ if (original.kernelOnly && original.deferRuleProjection && !globalThis[PREPARATION_HOOK]) {
124
+ return deploySelectedSurface(original, provider, deploy);
125
+ }
126
+ if (original.ruleDelivery) return deploy(original);
127
+ const hook = globalThis[PREPARATION_HOOK];
128
+ if (hook) {
129
+ const plan = await prepareRuleDeployment({ ...original, inputPool: hook.inputPool, ruleDeploymentScratch: hook.scratch }, provider, deploy);
130
+ const report = plan.report;
131
+ hook.accept(detachRuleDeploymentPlan(plan));
132
+ return report;
133
+ }
134
+ return commitRuleDeploymentPlan(await prepareRuleDeployment(original, provider, deploy));
135
+ }
136
+
137
+ export async function deploySelectedSurface(opts, provider, deploy) {
138
+ if (!opts.kernelOnly || provider.name !== 'warp') return deploy(opts);
139
+ // Warp's aggregate writer emits bulk definitions even in skills-only mode.
140
+ // Both staged and deferred kernel passes use only its shared skill router.
141
+ const skills = [...listSkillDirs(path.join(opts.srcRoot, 'skills')),
142
+ ...getFrameworksForMode(opts.srcRoot, opts.mode).flatMap(bundle => listSkillDirs(path.join(bundle.path, 'skills'))),
143
+ ...getAddonSkillDirs(opts.srcRoot)].filter(isKernelSkill);
144
+ const standard = path.join(opts.target, provider.paths.skills);
145
+ for (const dir of new Set([opts.kernelSkillsPath || provider.kernelSkillsPath, provider.paths.crossAgentSkills])) {
146
+ if (dir) deploySkillsWithKernelRouting(skills, standard, path.isAbsolute(dir) ? dir : path.join(opts.target, dir), opts);
147
+ }
148
+ }
@@ -0,0 +1,461 @@
1
+ // Prepare provider deployment against immutable staged inputs.
2
+ import { createHash, randomUUID } from 'node:crypto';
3
+ import fs from 'node:fs';
4
+ import os from 'node:os';
5
+ import path from 'node:path';
6
+ import { importImpl } from '../../_resolve-impl.mjs';
7
+ import {
8
+ deployEmulatedBehaviors,
9
+ discoverAddons,
10
+ filterAgentFiles,
11
+ getFrameworksForMode,
12
+ replaceBoundRulesBlock,
13
+ resolveAiwgRoot,
14
+ } from './base.mjs';
15
+ import { writeContextFileSync, CONTEXT_STAGE_ENV, GENERATED_CONTEXT_NAMES, OPERATOR_CONTEXT_NAMES } from './context-write.mjs';
16
+ import { captureProviderPathDescriptors, logicalProviderOutputPath, restoreProviderPaths, setStagedProviderPath } from './provider-paths-staging.mjs';
17
+ import {
18
+ collectDeploymentRuleSources,
19
+ fileDigest,
20
+ finishBindings,
21
+ guardRulesInlineBudget,
22
+ managed,
23
+ prepareRuleDelivery,
24
+ projectBoundFlowSkills,
25
+ put,
26
+ read,
27
+ resolveDeployVersion,
28
+ resolveProjectAiwgDir,
29
+ startupFiles,
30
+ trackTemporaryDirectory,
31
+ userConfigFile,
32
+ walk,
33
+ } from './rule-delivery-surface.mjs';
34
+ import { deploySelectedSurface } from './rule-deployment-commit.mjs';
35
+ import {
36
+ captureAnchors,
37
+ capturePreimage,
38
+ inputPools,
39
+ materializedPreimage,
40
+ materializeInput,
41
+ planSeal,
42
+ releaseInputPool,
43
+ snapshotPreimages,
44
+ stagedCleanups,
45
+ verifyInputPool,
46
+ } from './rule-deployment-state.mjs';
47
+ import { inlineStartup, projectRules } from './rule-projection.mjs';
48
+ const { captureDeploymentOutputs, recordDeploymentOutputs } = await importImpl(import.meta.url, 'providers/deployment-ownership.mjs');
49
+ import { retireInlineStartup } from './rule-startup.mjs';
50
+
51
+ /** Stage only provider/context output, never the user's source tree. On failure
52
+ * no staged output (including skills and behaviors) reaches the prior deployment. */
53
+ export async function prepareRuleDeployment(original, provider, deploy) {
54
+ const budgetEnv = { ...process.env };
55
+ const ruleDir = path.isAbsolute(provider.paths.rules || '') ? provider.paths.rules : path.join(original.target, provider.paths.rules || `.${provider.name}/rules`);
56
+ const manifestFile = path.join(ruleDir, '.aiwg-manifest.json');
57
+ const previousText = fs.existsSync(manifestFile) ? read(manifestFile) : '';
58
+ const previous = previousText ? JSON.parse(previousText) : {};
59
+ const corpusRoot = resolveAiwgRoot(original.srcRoot) || original.srcRoot;
60
+ if (!original.deployVersion || /unknown/i.test(original.deployVersion)) {
61
+ original = { ...original, deployVersion: resolveDeployVersion(corpusRoot, original.deployVersion) };
62
+ }
63
+ const sourceTree = fs.existsSync(path.join(corpusRoot, 'agentic', 'code'))
64
+ ? path.join(corpusRoot, 'agentic', 'code') : original.srcRoot;
65
+ const pool = original.inputPool && inputPools.get(original.inputPool);
66
+ if (original.inputPool && (!pool || pool.closed || pool.corpusRoot !== path.resolve(corpusRoot) || pool.sourceTree !== path.resolve(sourceTree))) throw new Error('Invalid or closed rule deployment input pool');
67
+ if (pool) verifyInputPool(pool);
68
+ let projectConfig = original.config;
69
+ if (!projectConfig) {
70
+ try { projectConfig = JSON.parse(read(path.join(original.target, '.aiwg', 'aiwg.config')) || '{}'); } catch { projectConfig = {}; }
71
+ }
72
+ const artifactRoot = resolveProjectAiwgDir(original.target);
73
+ const userIndexRoot = path.join(process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share'), 'aiwg', 'index');
74
+ const projectGraphFiles = ['.index/metadata.json', '.index/project/metadata.json'].map(name => path.join(artifactRoot, name));
75
+ const userGraphFiles = ['user'].map(name => path.join(userIndexRoot, name, 'metadata.json'));
76
+ const localSources = Object.values(projectConfig.installed || {}).filter(entry => entry?.localPath)
77
+ .map(entry => path.resolve(original.target, entry.localPath));
78
+ const selectedRules = collectDeploymentRuleSources({ ...original, previousRuleSources: previous.ruleSources || [] });
79
+ const initialPreimages = [...(pool ? pool.preimages : snapshotPreimages([sourceTree, path.join(corpusRoot, 'prebuilt', 'framework-relations'), path.join(corpusRoot, 'package.json'), path.join(corpusRoot, 'schemas')])), ...snapshotPreimages([path.join(corpusRoot, '.aiwg', '.index'),
80
+ manifestFile, path.join(original.target, '.aiwg', 'aiwg.config'), path.join(original.target, '.aiwg', 'AIWG.md'), path.join(original.target, '.aiwg', 'skills'), path.join(original.target, '.aiwg-location'), ...projectGraphFiles, ...userGraphFiles, ...localSources,
81
+ ...(path.resolve(original.srcRoot) === path.resolve(corpusRoot) ? [] : [original.srcRoot]), ...(original.additionalSources || []), ...selectedRules, ...selectedRules.map(file => path.dirname(file)),
82
+ userConfigFile('aiwg.config'), process.env.AIWG_USER_REGISTRY_PATH || userConfigFile('installed.json'),
83
+ ...(original.ruleSources || []), ...(previous.ruleSources || []), ...(original.bindingEntries || []).map(entry => entry.path)])];
84
+ let manifestState = initialPreimages.find(item => item.path === path.resolve(manifestFile)).state;
85
+ if (manifestState.kind === 'symlink') manifestState = manifestState.resolved;
86
+ const manifestDigest = previousText ? createHash('sha256').update(previousText).digest('hex') : null;
87
+ if ((manifestState.kind === 'missing' ? null : manifestState.digest) !== manifestDigest) throw new Error('Rule manifest changed while preparing snapshot');
88
+ const transferable = Boolean(original.ruleDeploymentScratch);
89
+ const temp = transferable ? path.resolve(original.ruleDeploymentScratch) : fs.mkdtempSync(path.join(os.tmpdir(), 'aiwg-rule-deploy-'));
90
+ if (transferable) {
91
+ const stat = fs.lstatSync(temp);
92
+ if (!stat.isDirectory() || stat.isSymbolicLink() || fs.readdirSync(temp).length) throw new Error('Invalid rule deployment scratch directory');
93
+ }
94
+ const removeStage = transferable
95
+ ? () => fs.rmSync(temp, { recursive: true, force: true })
96
+ : trackTemporaryDirectory(temp);
97
+ if (pool) pool.refs++;
98
+ const removeTemp = () => { removeStage(); if (pool) releaseInputPool(pool); };
99
+ const lease = randomUUID();
100
+ stagedCleanups.set(lease, { temp, cleanup: removeTemp, detach: () => { if (pool) releaseInputPool(pool); }, pool, seal: null, transferable });
101
+ const priorContextStage = process.env[CONTEXT_STAGE_ENV];
102
+ const contextStageLog = path.join(temp, 'context-writes.jsonl');
103
+ fs.writeFileSync(contextStageLog, '');
104
+ process.env[CONTEXT_STAGE_ENV] = contextStageLog;
105
+ const mappings = [];
106
+ const preimages = [...initialPreimages];
107
+ let retained = false;
108
+ const originals = captureProviderPathDescriptors(provider);
109
+ const logicalTarget = original.target;
110
+ const priorAiwgRoot = process.env.AIWG_ROOT;
111
+ const priorRegistry = process.env.AIWG_USER_REGISTRY_PATH;
112
+ const priorArtifacts = process.env.AIWG_ARTIFACTS_PATH;
113
+ const priorXdgData = process.env.XDG_DATA_HOME;
114
+ try {
115
+ const snapshotRoot = pool ? pool.snapshotRoot : path.join(temp, 'input');
116
+ const treeRelative = path.relative(corpusRoot, sourceTree);
117
+ const isCorpusTree = treeRelative === path.join('agentic', 'code');
118
+ const snapshotTree = isCorpusTree ? path.join(snapshotRoot, 'agentic', 'code') : snapshotRoot;
119
+ if (!pool) { fs.mkdirSync(path.dirname(snapshotTree), { recursive: true }); materializeInput(sourceTree, snapshotTree); }
120
+ const expectedTree = initialPreimages.find(item => item.path === path.resolve(sourceTree));
121
+ if (!pool && JSON.stringify(capturePreimage(snapshotTree)) !== JSON.stringify(materializedPreimage(expectedTree.state))) throw new Error('Source changed while preparing immutable snapshot');
122
+ if (isCorpusTree && !pool) {
123
+ for (const rel of ['package.json', 'prebuilt', 'schemas']) {
124
+ const from = path.join(corpusRoot, rel), to = path.join(snapshotRoot, rel);
125
+ if (fs.existsSync(from)) materializeInput(from, to);
126
+ const expected = initialPreimages.find(item => item.path === path.resolve(from));
127
+ if (expected && JSON.stringify(capturePreimage(to)) !== JSON.stringify(materializedPreimage(expected.state))) throw new Error(`Package input changed while preparing snapshot: ${from}`);
128
+ }
129
+ // The projector helpers execute installed code but receive the snapshot as data.
130
+ for (const rel of ['tools', 'dist', 'node_modules', 'src']) {
131
+ const from = path.join(corpusRoot, rel), to = path.join(snapshotRoot, rel);
132
+ if (fs.existsSync(from)) fs.symlinkSync(from, to, 'dir');
133
+ }
134
+ }
135
+ // Keep standalone fixture/bundle snapshots from inheriting the installed
136
+ // package's unrelated prebuilt relations through module-root fallback.
137
+ process.env.AIWG_ROOT = snapshotRoot;
138
+ const frozenConfigDir = path.join(temp, 'config');
139
+ fs.mkdirSync(frozenConfigDir);
140
+ const frozenFile = (from, name, expected) => {
141
+ const to = path.join(frozenConfigDir, name);
142
+ if (fs.existsSync(from)) { fs.copyFileSync(from, to); fs.chmodSync(to, fs.statSync(from).mode & 0o7777); }
143
+ if (JSON.stringify(capturePreimage(to)) !== JSON.stringify(materializedPreimage(expected || { kind: 'missing' }))) throw new Error(`Configuration changed while preparing snapshot: ${from}`);
144
+ return to;
145
+ };
146
+ const projectFile = path.join(logicalTarget, '.aiwg', 'aiwg.config');
147
+ const projectFileState = initialPreimages.find(item => item.path === path.resolve(projectFile))?.state;
148
+ const userFile = userConfigFile('aiwg.config');
149
+ const registryFile = priorRegistry || userConfigFile('installed.json');
150
+ const projectSnapshot = frozenFile(projectFile, 'project.json', projectFileState);
151
+ const userSnapshot = frozenFile(userFile, 'user.json', initialPreimages.find(item => item.path === path.resolve(userFile))?.state);
152
+ const registrySnapshot = frozenFile(registryFile, 'registry.json', initialPreimages.find(item => item.path === path.resolve(registryFile))?.state);
153
+ const readConfig = file => fs.existsSync(file) ? JSON.parse(read(file)) : {};
154
+ const effectiveConfig = structuredClone(original.config || readConfig(projectSnapshot));
155
+ const pinConfigs = structuredClone(original.pinConfigs || { project: effectiveConfig, user: readConfig(userSnapshot) });
156
+ const frozenLocal = Object.values(pinConfigs.project.installed || {}).filter(entry => entry?.localPath)
157
+ .map(entry => path.resolve(logicalTarget, entry.localPath));
158
+ if (JSON.stringify([...new Set(frozenLocal)].sort()) !== JSON.stringify([...new Set(localSources)].sort())) throw new Error('Project-local configuration changed while preparing snapshot');
159
+ const sourceMappings = [{ from: path.resolve(sourceTree), to: snapshotTree }];
160
+ for (const [index, from] of [...new Set(localSources)].entries()) {
161
+ const to = path.join(temp, 'local-input', String(index));
162
+ const expected = initialPreimages.find(item => item.path === from)?.state;
163
+ if (fs.existsSync(from)) { fs.mkdirSync(path.dirname(to), { recursive: true }); materializeInput(from, to); }
164
+ if (JSON.stringify(capturePreimage(to)) !== JSON.stringify(materializedPreimage(expected || { kind: 'missing' }))) throw new Error(`Project-local input changed while preparing snapshot: ${from}`);
165
+ sourceMappings.push({ from, to });
166
+ }
167
+ const externalInputs = [...new Set([...(path.resolve(original.srcRoot) === path.resolve(corpusRoot) ? [] : [original.srcRoot]), ...(original.additionalSources || []), ...(original.ruleSources || []), ...(previous.ruleSources || []),
168
+ ...(original.bindingEntries || []).map(entry => entry.path)].map(file => path.resolve(file)))];
169
+ for (const [index, from] of externalInputs.entries()) {
170
+ if (sourceMappings.some(item => from === item.from || from.startsWith(`${item.from}${path.sep}`))) continue;
171
+ const to = path.join(temp, 'external-input', String(index), path.basename(from));
172
+ const expected = initialPreimages.find(item => item.path === from)?.state;
173
+ if (fs.existsSync(from)) { fs.mkdirSync(path.dirname(to), { recursive: true }); materializeInput(from, to); }
174
+ if (JSON.stringify(capturePreimage(to)) !== JSON.stringify(materializedPreimage(expected || { kind: 'missing' }))) throw new Error(`External input changed while preparing snapshot: ${from}`);
175
+ sourceMappings.push({ from, to });
176
+ }
177
+ for (const entry of Object.values(pinConfigs.project.installed || {})) {
178
+ if (!entry?.localPath) continue;
179
+ const from = path.resolve(logicalTarget, entry.localPath);
180
+ entry.localPath = sourceMappings.find(mapping => mapping.from === from).to;
181
+ }
182
+ process.env.AIWG_USER_REGISTRY_PATH = registrySnapshot;
183
+ let stagedProjectRoot;
184
+ const mapSource = file => {
185
+ let absolute = path.resolve(file);
186
+ if (stagedProjectRoot && absolute.startsWith(`${stagedProjectRoot}${path.sep}`)) {
187
+ const logical = path.join(logicalTarget, path.relative(stagedProjectRoot, absolute));
188
+ if (sourceMappings.some(item => logical === item.from || logical.startsWith(`${item.from}${path.sep}`)) || !fs.existsSync(absolute)) absolute = logical;
189
+ }
190
+ const mapping = [...sourceMappings].sort((a, b) => b.from.length - a.from.length)
191
+ .find(item => absolute === item.from || absolute.startsWith(`${item.from}${path.sep}`));
192
+ if (mapping) return path.join(mapping.to, path.relative(mapping.from, absolute));
193
+ if (isCorpusTree && absolute === path.resolve(corpusRoot)) return snapshotRoot;
194
+ return file;
195
+ };
196
+ const logicalInputPath = file => {
197
+ let result = file;
198
+ for (const mapping of [...sourceMappings].sort((a, b) => b.to.length - a.to.length)) result = result.split(mapping.to).join(mapping.from);
199
+ return result.split(snapshotRoot).join(corpusRoot);
200
+ };
201
+ original = { ...original, config: effectiveConfig, srcRoot: mapSource(original.srcRoot), pinConfigs, mapInputPath: mapSource, logicalInputPath,
202
+ ...(original.additionalSources ? { additionalSources: original.additionalSources.map(mapSource) } : {}),
203
+ ...(original.ruleSources ? { ruleSources: original.ruleSources.map(mapSource) } : {}),
204
+ ...(original.bindingEntries ? { bindingEntries: original.bindingEntries.map(entry => ({ ...entry, path: mapSource(entry.path) })) } : {}) };
205
+ const target = path.resolve(original.target);
206
+ const stage = path.join(temp, 'project');
207
+ stagedProjectRoot = stage;
208
+ fs.mkdirSync(stage);
209
+ const mount = (from, to) => {
210
+ if (mappings.some(mapping => mapping.from === from)) return;
211
+ const mountPreimage = snapshotPreimages([from])[0];
212
+ preimages.push(mountPreimage);
213
+ if (fs.existsSync(from)) materializeInput(from, to);
214
+ const before = new Map(walk(to).map(file => [path.relative(to, file), fileDigest(file)]));
215
+ if (JSON.stringify(capturePreimage(to)) !== JSON.stringify(materializedPreimage(mountPreimage.state))) throw new Error(`Deployment input changed while preparing snapshot: ${from}`);
216
+ mappings.push({ from, to, before });
217
+ };
218
+ // Mount directories independently so only provider-owned surfaces are promoted.
219
+ const relativeRoots = Object.values(provider.paths).filter(dir => dir && !path.isAbsolute(dir))
220
+ .map(dir => dir.split(/[\\/]/)[0]).filter(dir => dir && dir !== '.' && !path.extname(dir));
221
+ for (const dir of new Set([`.${provider.name}`, '.agents', '.aiwg/skills', ...relativeRoots])) mount(path.join(target, dir), path.join(stage, dir));
222
+ fs.mkdirSync(path.join(stage, '.aiwg'), { recursive: true });
223
+ if (fs.existsSync(projectSnapshot)) materializeInput(projectSnapshot, path.join(stage, '.aiwg', 'aiwg.config'));
224
+ const rootNames = ['opencode.json', ...GENERATED_CONTEXT_NAMES, ...OPERATOR_CONTEXT_NAMES, '.aiwg/frameworks/registry.json'];
225
+ if (provider.name === 'windsurf') rootNames.push('.windsurfrules');
226
+ for (const framework of getFrameworksForMode(original.srcRoot, original.mode)) {
227
+ for (const entry of framework.manifest?.memory?.creates || []) {
228
+ if (typeof entry?.path !== 'string' || !entry.path.startsWith('.aiwg/') || !path.extname(entry.path)) continue;
229
+ const safe = path.normalize(entry.path);
230
+ if (!safe.startsWith(`.aiwg${path.sep}`)) throw new Error(`Invalid framework workspace path: ${entry.path}`);
231
+ if (!rootNames.includes(safe)) rootNames.push(safe);
232
+ }
233
+ }
234
+ for (const name of [...rootNames]) {
235
+ const sidecar = path.join(path.dirname(name) === '.' ? '.aiwg' : path.dirname(name), '.aiwg-manifest.json');
236
+ if (!rootNames.includes(sidecar)) rootNames.push(sidecar);
237
+ }
238
+ preimages.push(...snapshotPreimages(rootNames.map(name => path.join(target, name))));
239
+ for (const name of rootNames) {
240
+ const from = path.join(target, name), to = path.join(stage, name);
241
+ if (fs.existsSync(from)) { fs.mkdirSync(path.dirname(to), { recursive: true }); fs.copyFileSync(from, to); fs.chmodSync(to, fs.statSync(from).mode & 0o7777); }
242
+ const expected = preimages.find(item => item.path === path.resolve(from));
243
+ if (JSON.stringify(capturePreimage(to)) !== JSON.stringify(materializedPreimage(expected.state))) throw new Error(`Deployment input changed while preparing snapshot: ${from}`);
244
+ }
245
+ const home = path.join(temp, 'home');
246
+ for (const [key, dir] of Object.entries(provider.paths)) {
247
+ if (!path.isAbsolute(dir)) continue;
248
+ const to = path.join(temp, 'native', key);
249
+ mount(dir, to);
250
+ setStagedProviderPath(provider, key, to);
251
+ }
252
+ let kernel = provider.kernelSkillsPath;
253
+ if (kernel && path.isAbsolute(kernel)) {
254
+ const to = path.join(temp, 'native', 'kernel-skills');
255
+ mount(kernel, to);
256
+ kernel = to;
257
+ }
258
+ // Codex's legacy prompt helper is home-global. Give it an isolated home and
259
+ // promote only its output after validation.
260
+ if (provider.name === 'codex' && (original.deployCommands || original.commandsOnly)) mount(path.join(os.homedir(), '.codex', 'prompts'), path.join(home, '.codex', 'prompts'));
261
+ let hermesLegacySkills;
262
+ let legacyCodexSkills;
263
+ if (provider.name === 'hermes') {
264
+ const source = path.join(path.dirname(provider.kernelSkillsPath), '.aiwg', 'skills');
265
+ hermesLegacySkills = path.join(temp, 'hermes-legacy-skills');
266
+ mount(source, hermesLegacySkills);
267
+ }
268
+ if (provider.name === 'codex' && (original.deploySkills || original.skillsOnly)) {
269
+ legacyCodexSkills = path.join(temp, 'codex-legacy-skills');
270
+ mount(path.join(os.homedir(), '.codex', 'skills'), legacyCodexSkills);
271
+ }
272
+ // Existing receipts carry logical source paths. Projectors operate against
273
+ // the immutable snapshot, so translate those paths before stale cleanup;
274
+ // promotion normalizes them back to their logical paths.
275
+ for (const { to } of mappings) {
276
+ for (const file of walk(to).filter(name => path.basename(name) === '.aiwg-manifest.json')) {
277
+ let receipt; try { receipt = JSON.parse(read(file)); } catch { continue; }
278
+ let changed = false;
279
+ const remap = value => {
280
+ if (!value || typeof value !== 'object') return;
281
+ for (const [key, child] of Object.entries(value)) {
282
+ if (['skillSource', 'flowSource', 'sourcePath'].includes(key) && typeof child === 'string' && path.isAbsolute(child)) {
283
+ const mapped = mapSource(child); if (mapped !== child) { value[key] = mapped; changed = true; }
284
+ }
285
+ else remap(child);
286
+ }
287
+ };
288
+ remap(receipt); if (changed) fs.writeFileSync(file, `${JSON.stringify(receipt, null, 2)}\n`);
289
+ }
290
+ }
291
+ let activeWorkspace;
292
+ if (provider.resolveOpenClawWorkspace) {
293
+ const from = provider.resolveOpenClawWorkspace();
294
+ activeWorkspace = path.join(temp, 'active-workspace');
295
+ mount(from, activeWorkspace);
296
+ }
297
+ // Graph discovery must read the same immutable inputs as projection, including
298
+ // relocated project indexes and shared user indexes.
299
+ const graphRoot = path.join(temp, 'graph-artifacts');
300
+ const xdgRoot = path.join(temp, 'xdg-data');
301
+ const copyGraph = (from, to) => {
302
+ const expected = initialPreimages.find(item => item.path === path.resolve(from)).state;
303
+ materializeInput(from, to);
304
+ if (JSON.stringify(capturePreimage(to)) !== JSON.stringify(materializedPreimage(expected))) throw new Error(`Graph input changed while preparing snapshot: ${from}`);
305
+ };
306
+ for (const from of projectGraphFiles) copyGraph(from, path.join(graphRoot, path.relative(artifactRoot, from)));
307
+ for (const from of userGraphFiles) copyGraph(from, path.join(xdgRoot, 'aiwg', 'index', path.relative(userIndexRoot, from)));
308
+ // Non-index graph targets remain logical until selected, then are copied
309
+ // individually by the discovered-input loop below.
310
+ if (path.resolve(artifactRoot) !== path.resolve(target, '.aiwg')) sourceMappings.push({ from: path.resolve(target, '.aiwg'), to: artifactRoot });
311
+ process.env.AIWG_ARTIFACTS_PATH = graphRoot;
312
+ process.env.XDG_DATA_HOME = xdgRoot;
313
+ const delivery = await prepareRuleDelivery({ ...original, target: stage, sharedProjectGraph: path.resolve(artifactRoot) !== path.resolve(target, '.aiwg'), previousRuleSources: (previous.ruleSources || []).map(mapSource) });
314
+ // Provider writes belong to the staged project control plane, not the
315
+ // read-only graph snapshot used for binding discovery.
316
+ process.env.AIWG_ARTIFACTS_PATH = path.join(stage, '.aiwg');
317
+ // Discovery can select absolute user/project sources not known at entry.
318
+ // Bind the exact copied bytes before any projector consumes them.
319
+ const remappedBindings = new Map();
320
+ for (const entry of delivery.targets) {
321
+ const source = path.resolve(entry.source);
322
+ const alreadyFrozen = source.startsWith(`${temp}${path.sep}`);
323
+ if (!alreadyFrozen) {
324
+ const state = capturePreimage(source);
325
+ const to = path.join(temp, 'discovered-input', String(sourceMappings.length), path.basename(source));
326
+ materializeInput(source, to);
327
+ if (JSON.stringify(capturePreimage(to)) !== JSON.stringify(materializedPreimage(state))) throw new Error(`Discovered input changed while preparing snapshot: ${source}`);
328
+ preimages.push({ path: source, state });
329
+ sourceMappings.push({ from: source, to });
330
+ entry.source = to;
331
+ }
332
+ const rules = delivery.bindings.get(source);
333
+ if (rules) remappedBindings.set(entry.source, rules);
334
+ }
335
+ delivery.bindings = remappedBindings;
336
+ preimages.push(...snapshotPreimages([...delivery.rules.map(rule => rule.file), ...delivery.targets.map(entry => entry.source), path.join(target, '.aiwg', 'aiwg.config')]));
337
+ const opts = { ...original, writeReceipt: writeContextFileSync, writtenFiles: [], target: stage, dryRun: false, ruleDelivery: delivery, logicalOutputPath: file => logicalProviderOutputPath(file, stage, target, mappings),
338
+ kernelSkillsPath: kernel, deploymentHome: home, activeWorkspace, hermesLegacySkills, legacyCodexSkills, staging: true };
339
+ const ownershipRoots = [stage, ...mappings.map(mapping => mapping.to)];
340
+ const ownershipBefore = captureDeploymentOutputs(ownershipRoots);
341
+ if (!opts.deferRuleProjection && (opts.kernelOnly || opts.deployRules || opts.rulesOnly ||
342
+ (!opts.skillsOnly && !opts.commandsOnly && (inlineStartup[provider.name] || ['hermes', 'warp'].includes(provider.name))))) retireInlineStartup(opts, provider);
343
+ await deploySelectedSurface(opts, provider, deploy);
344
+ if (!opts.commandsOnly && !opts.skillsOnly && !opts.rulesOnly && opts.deployBehaviors !== false) {
345
+ deployEmulatedBehaviors(delivery.rules.filter(rule => rule.behavior).map(rule => path.dirname(rule.file)), provider.name, stage, opts);
346
+ }
347
+ const selectedRoots = [original.srcRoot, ...(original.additionalSources || []), ...getFrameworksForMode(original.srcRoot, original.mode).map(framework => framework.path), ...discoverAddons(original.srcRoot).map(addon => addon.path)];
348
+ const selected = entry => selectedRoots.some(root => /^(agents|skills|commands|flows|workflows)[/\\]/.test(path.relative(root, entry.source)));
349
+ opts.definitionRoutes = [];
350
+ if (provider.name === 'hermes' && !opts.kernelOnly && !opts.skillsOnly && !opts.commandsOnly && !opts.rulesOnly) {
351
+ const agents = delivery.targets.filter(target => target.type === 'agent' && selected(target));
352
+ const selectedAgents = new Set(filterAgentFiles(agents.map(target => target.source), opts));
353
+ for (const target of agents.filter(target => selectedAgents.has(target.source))) {
354
+ const source = target.source;
355
+ put(path.join(stage, '.hermes', 'agents', path.basename(source)), managed(replaceBoundRulesBlock(read(source), delivery.bindings.get(source)), opts));
356
+ opts.definitionRoutes.push(`${target.name}: .hermes/agents/${path.basename(source)}`);
357
+ }
358
+ }
359
+ projectBoundFlowSkills(opts, provider, selected);
360
+ if (['warp', 'windsurf'].includes(provider.name)) {
361
+ for (const file of walk(path.join(stage, `.${provider.name}`, 'commands'))) {
362
+ if (/\.md$/.test(file)) opts.definitionRoutes.push(`${path.basename(file, '.md')}: .${provider.name}/commands/${path.basename(file)}`);
363
+ }
364
+ for (const entry of delivery.targets.filter(entry => entry.type === 'agent' && selected(entry))) {
365
+ const dest = path.join(stage, `.${provider.name}`, 'agents', path.basename(entry.source));
366
+ if (fs.existsSync(dest)) opts.definitionRoutes.push(`${entry.name}: .${provider.name}/agents/${path.basename(entry.source)}`);
367
+ }
368
+ }
369
+ if (!opts.deferRuleProjection) {
370
+ if (opts.kernelOnly || opts.deployRules || opts.rulesOnly || (!opts.skillsOnly && !opts.commandsOnly && (inlineStartup[provider.name] || ['hermes', 'warp'].includes(provider.name)))) projectRules(opts, provider);
371
+ finishBindings(opts, provider);
372
+ }
373
+ // Normalize all generated path wrappers before counting or promoting bytes.
374
+ const normalize = content => {
375
+ for (const mapping of [...mappings].sort((a, b) => b.to.length - a.to.length)) content = content.split(mapping.to).join(mapping.from);
376
+ for (const mapping of [...sourceMappings].sort((a, b) => b.to.length - a.to.length)) content = content.split(mapping.to).join(mapping.from);
377
+ return content.split(snapshotRoot).join(corpusRoot).split(stage).join(target);
378
+ };
379
+ const projected = startupFiles(opts, provider).map(file => ({ path: normalize(file.path), content: normalize(file.content) }));
380
+ const config = effectiveConfig;
381
+ const guarded = guardRulesInlineBudget({ provider: provider.name, files: projected, config, env: budgetEnv,
382
+ reportOnly: delivery.pins.length ? original.allowOverBudget === true : original.reportOnly !== false && !original.strict && !budgetEnv.CI });
383
+ guarded.report.pins = delivery.pins.map(rule => ({ id: rule.id, name: rule.name, matches: rule.matches, canonical_activation: rule.canonical_activation, bytes: Buffer.byteLength(rule.body || '') }));
384
+ const pinDetails = delivery.pins.map(rule => `${rule.name}: ${Buffer.byteLength(rule.body || '')} body bytes via ${JSON.stringify(rule.matches)}`).join('; ');
385
+ const budgetFailure = message => new Error(`${provider.name}: ${message}; ${guarded.report.selected_bytes} startup bytes. Pins: ${pinDetails || '(none)'}.${delivery.pins.length ? ' Use --allow-over-budget to retain every pinned body.' : ''}`);
386
+ for (const diagnostic of guarded.diagnostics) console.warn(diagnostic.message);
387
+ if (!guarded.passed) throw budgetFailure(guarded.diagnostics.map(d => d.message).join('\n'));
388
+ const agents = normalize(read(path.join(stage, 'AGENTS.md')));
389
+ if (provider.name === 'codex' && Buffer.byteLength(agents) >= 32_768 && !(delivery.pins.length && original.allowOverBudget)) throw budgetFailure(`Codex AGENTS.md (${Buffer.byteLength(agents)} bytes) exceeds its 32 KB hard cap`);
390
+ if (provider.name === 'hermes') {
391
+ for (const name of ['AGENTS.md', '.hermes.md']) {
392
+ const content = normalize(read(path.join(stage, name)));
393
+ if (!(delivery.pins.length && original.allowOverBudget)) {
394
+ try { provider.assertContextBudget(content, name, delivery.rules); }
395
+ catch (error) { throw budgetFailure(error.message); }
396
+ }
397
+ if (content.length > 15_000) console.warn(`Hermes ${name} above 15000 character soft limit (${content.length})`);
398
+ }
399
+ }
400
+ // Absolute provider roots can nest (Hermes standard skills live beneath
401
+ // its kernel root). A more specific mount owns that subtree exclusively;
402
+ // the parent's older snapshot must not resurrect pruned files/directories.
403
+ const delegated = (from, rel) => mappings.some(mapping => mapping.from !== from
404
+ && mapping.from.startsWith(`${from}${path.sep}`)
405
+ && (path.join(from, rel) === mapping.from || path.join(from, rel).startsWith(`${mapping.from}${path.sep}`)));
406
+ if (original.contextFiles === false) {
407
+ // Keep context inputs in the snapshot for validation, but exclude them
408
+ // from both dry-run output and promotion (including unchanged rewrites).
409
+ for (let i = rootNames.length - 1; i >= 0; i--) {
410
+ if ([...GENERATED_CONTEXT_NAMES, ...OPERATOR_CONTEXT_NAMES].includes(rootNames[i])) rootNames.splice(i, 1);
411
+ }
412
+ }
413
+ if (pool) verifyInputPool(pool);
414
+ if (original.previewReport) return { report: guarded.report, noop: true };
415
+ if (original.dryRun) {
416
+ // A validated plan must describe the operator's final paths, rather than
417
+ // exposing only the temporary paths used to assemble that plan.
418
+ for (const { from, to, before } of mappings) {
419
+ const after = new Set(walk(to).map(file => path.relative(to, file)).filter(rel => !delegated(from, rel)));
420
+ for (const rel of after) {
421
+ const file = path.join(to, rel);
422
+ if (before.get(rel) !== fileDigest(file)) console.log(`[dry-run] Would write ${normalize(file)}`);
423
+ }
424
+ for (const rel of before.keys()) if (!delegated(from, rel) && !after.has(rel)) console.log(`[dry-run] Would remove ${path.join(from, rel)}`);
425
+ }
426
+ for (const name of rootNames) {
427
+ const file = path.join(stage, name);
428
+ if (fs.existsSync(file) && normalize(read(file)) !== read(path.join(target, name))) console.log(`[dry-run] Would write ${path.join(target, name)}`);
429
+ }
430
+ console.log(`[dry-run] Planned ${provider.name} deployment: ${guarded.report.selected_bytes} startup bytes; no output promoted.`);
431
+ return { report: guarded.report, noop: true };
432
+ }
433
+ recordDeploymentOutputs(ownershipBefore, ownershipRoots, opts);
434
+ const workspaceDirs = [];
435
+ const collectDirs = (dir, rel = '') => {
436
+ if (!fs.existsSync(dir)) return;
437
+ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
438
+ if (!entry.isDirectory()) continue;
439
+ const name = path.join(rel, entry.name); workspaceDirs.push(name);
440
+ collectDirs(path.join(dir, entry.name), name);
441
+ }
442
+ };
443
+ collectDirs(path.join(stage, '.aiwg'), '.aiwg');
444
+ const contextWrites = [...new Set(fs.readFileSync(contextStageLog, 'utf8').split('\n').filter(Boolean).map(line => JSON.parse(line)))];
445
+ const plan = { version: 1, lease, temp, target, stage, contextWrites, rootNames, workspaceDirs, preimages, poolSeal: pool?.inventorySeal || null,
446
+ anchors: captureAnchors([target, ...mappings.map(mapping => mapping.from), ...workspaceDirs.map(dir => path.join(target, dir))]),
447
+ snapshotRoot, corpusRoot, sourceMappings, staged: snapshotPreimages([stage, ...mappings.map(mapping => mapping.to)]), report: guarded.report,
448
+ mappings: mappings.map(({ from, to, before }) => ({ from, to, before: [...before] })) };
449
+ stagedCleanups.get(lease).seal = planSeal(plan);
450
+ retained = true;
451
+ return plan;
452
+ } finally {
453
+ if (priorContextStage === undefined) delete process.env[CONTEXT_STAGE_ENV]; else process.env[CONTEXT_STAGE_ENV] = priorContextStage;
454
+ restoreProviderPaths(provider, originals);
455
+ if (priorAiwgRoot === undefined) delete process.env.AIWG_ROOT; else process.env.AIWG_ROOT = priorAiwgRoot;
456
+ if (priorRegistry === undefined) delete process.env.AIWG_USER_REGISTRY_PATH; else process.env.AIWG_USER_REGISTRY_PATH = priorRegistry;
457
+ if (priorArtifacts === undefined) delete process.env.AIWG_ARTIFACTS_PATH; else process.env.AIWG_ARTIFACTS_PATH = priorArtifacts;
458
+ if (priorXdgData === undefined) delete process.env.XDG_DATA_HOME; else process.env.XDG_DATA_HOME = priorXdgData;
459
+ if (!retained) { stagedCleanups.delete(lease); removeTemp(); }
460
+ }
461
+ }