@automaton-labs/aib 0.0.7 → 0.0.9

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 (477) hide show
  1. package/README.md +21 -578
  2. package/config/agent-dx-policy.default.json +31 -0
  3. package/config/control-plane-client.default.json +3 -0
  4. package/dist/agent-dx/agent-dx.js +805 -0
  5. package/dist/agent-dx/presentation.js +32 -0
  6. package/dist/alias-advisor/analyze.js +982 -0
  7. package/dist/alias-advisor/exact-text-cost.js +74 -0
  8. package/dist/alias-advisor/lexical.js +240 -0
  9. package/dist/alias-advisor/model.js +2 -0
  10. package/dist/alias-advisor/path-identity.js +49 -0
  11. package/dist/alias-advisor/ranking.js +171 -0
  12. package/dist/alias-advisor/token-estimator.js +85 -0
  13. package/dist/bin/aib.js +5 -1
  14. package/dist/bin/cli.js +811 -4
  15. package/dist/commands/add-missing-imports-preview-cache.js +99 -2
  16. package/dist/commands/add-missing-imports.js +241 -2
  17. package/dist/commands/apply-module-plan.js +1319 -3
  18. package/dist/commands/background-command.js +378 -2
  19. package/dist/commands/captured-input.js +74 -1
  20. package/dist/commands/config-command.js +314 -2
  21. package/dist/commands/config-output.js +357 -10
  22. package/dist/commands/control-plane-command.js +183 -1
  23. package/dist/commands/declaration-command.js +1209 -7
  24. package/dist/commands/declaration-execution-cache.js +79 -1
  25. package/dist/commands/declaration-format.js +221 -1
  26. package/dist/commands/declaration-preview-cache.js +114 -2
  27. package/dist/commands/diagnostics-command.js +70 -3
  28. package/dist/commands/doctor.js +137 -3
  29. package/dist/commands/execution-command.js +117 -1
  30. package/dist/commands/exports-star-collapse-command.js +178 -0
  31. package/dist/commands/exports-star-command.js +252 -0
  32. package/dist/commands/exports-star-preview-cache.js +84 -0
  33. package/dist/commands/feedback-command.js +176 -3
  34. package/dist/commands/file-move-to-dir-execution-cache.js +92 -1
  35. package/dist/commands/file-move-to-dir-preview-cache.js +125 -2
  36. package/dist/commands/file-move-to-dir-worker.js +54 -0
  37. package/dist/commands/file-move-to-dir.js +1073 -5
  38. package/dist/commands/file-mutation-runtime.js +102 -1
  39. package/dist/commands/file-mutation-worker-apply.js +180 -0
  40. package/dist/commands/file-refactor-batch-execution-cache.js +90 -1
  41. package/dist/commands/file-refactor-batch-preview-cache.js +125 -2
  42. package/dist/commands/file-refactor-batch-worker.js +54 -0
  43. package/dist/commands/file-refactor-batch.js +1154 -5
  44. package/dist/commands/file-rename-execution-cache.js +92 -1
  45. package/dist/commands/file-rename-preview-cache.js +125 -2
  46. package/dist/commands/file-rename-worker.js +54 -0
  47. package/dist/commands/file-rename.js +1053 -5
  48. package/dist/commands/file-text-edit-executor.js +205 -0
  49. package/dist/commands/find-importers.js +52 -1
  50. package/dist/commands/find-unused-imports.js +55 -1
  51. package/dist/commands/generate-docs-command.js +244 -6
  52. package/dist/commands/help-command.js +460 -7
  53. package/dist/commands/import-specifier-policy.js +391 -0
  54. package/dist/commands/imports-command.js +68 -1
  55. package/dist/commands/imports-rebase.js +1138 -0
  56. package/dist/commands/init-skill-usage.js +92 -3
  57. package/dist/commands/init-workspace.js +30 -1
  58. package/dist/commands/inspect-alias-candidates.js +413 -0
  59. package/dist/commands/inspect-cycles.js +811 -5
  60. package/dist/commands/inspect-direct-usages.js +98 -0
  61. package/dist/commands/inspect-duplicates-format.js +229 -0
  62. package/dist/commands/inspect-format-primitives.js +127 -0
  63. package/dist/commands/inspect-format.js +1590 -18
  64. package/dist/commands/inspect-graph.js +1553 -9
  65. package/dist/commands/inspect-imports.js +339 -2
  66. package/dist/commands/inspect-mixed-format.js +524 -0
  67. package/dist/commands/inspect-module-plan-format.js +216 -0
  68. package/dist/commands/inspect-module-plan-serialization.js +402 -0
  69. package/dist/commands/inspect-reference-path-format.js +157 -0
  70. package/dist/commands/inspect-request-values.js +599 -0
  71. package/dist/commands/inspect-selector-kind.js +21 -0
  72. package/dist/commands/inspect-selector.js +50 -0
  73. package/dist/commands/inspect-symbol-format.js +90 -0
  74. package/dist/commands/inspect-topology.js +435 -0
  75. package/dist/commands/inspect-tree.js +827 -5
  76. package/dist/commands/inspect-usages-detail.js +793 -0
  77. package/dist/commands/inspect-usages-evidence.js +31 -0
  78. package/dist/commands/inspect-usages-format.js +367 -0
  79. package/dist/commands/inspect.js +1450 -16
  80. package/dist/commands/internal-command.js +64 -0
  81. package/dist/commands/json-file-input.js +60 -1
  82. package/dist/commands/module-plan-cache.js +156 -2
  83. package/dist/commands/module-plan-standalone.js +208 -0
  84. package/dist/commands/module-plan-timeout.js +77 -1
  85. package/dist/commands/move-preview-cache.js +101 -2
  86. package/dist/commands/mutate-aggregate-output.js +996 -0
  87. package/dist/commands/mutate-child-execution.js +374 -0
  88. package/dist/commands/mutate-command.js +1394 -0
  89. package/dist/commands/mutate-declaration-output.js +313 -0
  90. package/dist/commands/mutate-domain-adapters.js +638 -0
  91. package/dist/commands/mutate-execution-cache.js +114 -0
  92. package/dist/commands/mutate-execution-status.js +598 -0
  93. package/dist/commands/mutate-failure-output.js +531 -0
  94. package/dist/commands/mutate-file-view.js +151 -0
  95. package/dist/commands/mutate-object-output.js +91 -0
  96. package/dist/commands/mutate-output-values.js +97 -0
  97. package/dist/commands/mutate-preview-cache.js +86 -0
  98. package/dist/commands/mutate-response-replay.js +153 -0
  99. package/dist/commands/mutate-result-projection.js +818 -0
  100. package/dist/commands/mutation-eta.js +28 -0
  101. package/dist/commands/mutation-execution-cache.js +140 -3
  102. package/dist/commands/mutation-recovery-journal.js +195 -0
  103. package/dist/commands/normalize-imports.js +1120 -4
  104. package/dist/commands/object-pack-command.js +546 -0
  105. package/dist/commands/object-pack-preview-cache.js +88 -0
  106. package/dist/commands/observability-command.js +47 -3
  107. package/dist/commands/ota-command.js +403 -2
  108. package/dist/commands/print-config.js +10 -1
  109. package/dist/commands/quick-read.js +1113 -11
  110. package/dist/commands/refactor-batch-builder.js +265 -1
  111. package/dist/commands/refactor-batch-execution-cache.js +85 -1
  112. package/dist/commands/refactor-batch-preview-cache.js +96 -2
  113. package/dist/commands/refactor-batch.js +461 -4
  114. package/dist/commands/rename-entities.js +794 -4
  115. package/dist/commands/rename-execution-cache.js +49 -1
  116. package/dist/commands/rename-input.js +22 -1
  117. package/dist/commands/rename-polling-policy.js +68 -0
  118. package/dist/commands/rename-preview-cache.js +96 -2
  119. package/dist/commands/result-view.js +993 -7
  120. package/dist/commands/reveal-command.js +445 -5
  121. package/dist/commands/selector-suggestions.js +93 -0
  122. package/dist/commands/session-workspace.js +1836 -31
  123. package/dist/commands/shared.js +2 -1
  124. package/dist/commands/skills-command.js +315 -0
  125. package/dist/commands/sync-command.js +59 -2
  126. package/dist/commands/worker-command.js +173 -1
  127. package/dist/commands/workspace-cache.js +55 -1
  128. package/dist/config/defaults.js +26 -1
  129. package/dist/config/env-vars.js +77 -1
  130. package/dist/config/glob-match.js +44 -1
  131. package/dist/config/import-rules.js +165 -1
  132. package/dist/config/local-config.js +293 -3
  133. package/dist/config/mutation-comments.js +51 -1
  134. package/dist/config/path-aliases.js +165 -1
  135. package/dist/config/path-display.js +84 -1
  136. package/dist/config/product-storage.js +37 -1
  137. package/dist/config/request-env.js +21 -0
  138. package/dist/config/request-routing-context.js +23 -0
  139. package/dist/config/resolve-command-alias.js +74 -1
  140. package/dist/config/resolve.js +24 -1
  141. package/dist/config/tsconfig-discovery.js +113 -1
  142. package/dist/config/typescript-preferences.js +131 -0
  143. package/dist/config/workspace-root.js +310 -3
  144. package/dist/config/workspace-state.js +254 -1
  145. package/dist/content/content-bundle.js +88 -1
  146. package/dist/diagnostics/module-plan-timeline.js +75 -2
  147. package/dist/diagnostics/readiness-text.js +45 -8
  148. package/dist/dsl/aib-dsl.js +838 -1
  149. package/dist/dsl/declaration-dsl.js +264 -1
  150. package/dist/dsl/file-move-to-dir-dsl.js +123 -1
  151. package/dist/dsl/file-refactor-batch-dsl.js +203 -1
  152. package/dist/dsl/file-rename-dsl.js +135 -1
  153. package/dist/dsl/mutate-dsl.js +746 -0
  154. package/dist/help/bootstrap.bash.md +176 -341
  155. package/dist/help/bootstrap.md +175 -340
  156. package/dist/help/bootstrap.pwsh.md +176 -341
  157. package/dist/help/docs/basics.md +1 -1
  158. package/dist/help/docs/config-setup.import-normalize.md +65 -65
  159. package/dist/help/docs/config-setup.import-rules.md +6 -5
  160. package/dist/help/docs/first-setup.md +6 -5
  161. package/dist/help/docs/help-protocol.md +4 -3
  162. package/dist/help/docs/import.base.md +38 -0
  163. package/dist/help/docs/import.rebase.md +85 -0
  164. package/dist/help/docs/inspect.aliasCandidates.md +39 -0
  165. package/dist/help/docs/inspect.code.md +1 -7
  166. package/dist/help/docs/inspect.file.md +10 -19
  167. package/dist/help/docs/inspect.graph.md +3 -17
  168. package/dist/help/{dsl/docs/inspect.md → docs/inspect.shared.md} +13 -12
  169. package/dist/help/docs/modulePlan.md +24 -28
  170. package/dist/help/docs/move.md +19 -22
  171. package/dist/help/{dsl/topics/file.move.md → docs/moveToDir.md} +36 -34
  172. package/dist/help/docs/mutate.mixed.md +34 -0
  173. package/dist/help/docs/mutation.shared.md +55 -0
  174. package/dist/help/docs/patterns.md +3 -12
  175. package/dist/help/docs/qr.md +12 -6
  176. package/dist/help/docs/quick-map.md +36 -24
  177. package/dist/help/docs/recipe.file-layout.md +10 -10
  178. package/dist/help/docs/recipe.import-boundary.md +92 -0
  179. package/dist/help/docs/recipe.safe-artifact-probing.md +68 -0
  180. package/dist/help/docs/recipe.unfamiliar-area.md +64 -0
  181. package/dist/help/docs/recipes.md +20 -0
  182. package/dist/help/docs/rename.md +19 -27
  183. package/dist/help/docs/renameFile.md +36 -0
  184. package/dist/help/docs/rules.md +26 -0
  185. package/dist/help/dsl/bootstrap.bash.md +176 -341
  186. package/dist/help/dsl/bootstrap.md +175 -340
  187. package/dist/help/dsl/bootstrap.pwsh.md +176 -341
  188. package/dist/help/dsl/docs/basics.md +1 -1
  189. package/dist/help/dsl/docs/config-setup.import-normalize.md +65 -65
  190. package/dist/help/dsl/docs/config-setup.import-rules.md +6 -5
  191. package/dist/help/dsl/docs/first-setup.md +6 -5
  192. package/dist/help/dsl/docs/help-protocol.md +4 -3
  193. package/dist/help/dsl/docs/import.base.md +38 -0
  194. package/dist/help/dsl/docs/import.rebase.md +85 -0
  195. package/dist/help/dsl/docs/inspect.aliasCandidates.md +39 -0
  196. package/dist/help/dsl/docs/inspect.code.md +1 -7
  197. package/dist/help/dsl/docs/inspect.file.md +10 -19
  198. package/dist/help/dsl/docs/inspect.graph.md +3 -17
  199. package/dist/help/{docs/inspect.md → dsl/docs/inspect.shared.md} +13 -12
  200. package/dist/help/dsl/docs/modulePlan.md +24 -28
  201. package/dist/help/dsl/docs/move.md +19 -22
  202. package/dist/help/{topics/file.move.md → dsl/docs/moveToDir.md} +36 -34
  203. package/dist/help/dsl/docs/mutate.mixed.md +34 -0
  204. package/dist/help/dsl/docs/mutation.shared.md +55 -0
  205. package/dist/help/dsl/docs/patterns.md +3 -12
  206. package/dist/help/dsl/docs/qr.md +12 -6
  207. package/dist/help/dsl/docs/quick-map.md +36 -24
  208. package/dist/help/dsl/docs/recipe.file-layout.md +10 -10
  209. package/dist/help/dsl/docs/recipe.import-boundary.md +92 -0
  210. package/dist/help/dsl/docs/recipe.safe-artifact-probing.md +68 -0
  211. package/dist/help/dsl/docs/recipe.unfamiliar-area.md +64 -0
  212. package/dist/help/dsl/docs/recipes.md +20 -0
  213. package/dist/help/dsl/docs/rename.md +19 -27
  214. package/dist/help/dsl/docs/renameFile.md +36 -0
  215. package/dist/help/dsl/docs/rules.md +26 -0
  216. package/dist/help/dsl/full.md +175 -340
  217. package/dist/help/dsl/help-index.md +48 -43
  218. package/dist/help/dsl/snippets/agents.md +2 -2
  219. package/dist/help/dsl/tokens/qr.inline.examples.md +1 -1
  220. package/dist/help/dsl/topics/basics.md +1 -1
  221. package/dist/help/dsl/topics/config-setup.import-normalize.md +65 -65
  222. package/dist/help/dsl/topics/config-setup.import-rules.md +6 -5
  223. package/dist/help/dsl/topics/first-setup.md +6 -5
  224. package/dist/help/dsl/topics/help-protocol.md +4 -3
  225. package/dist/help/dsl/topics/import.base.md +36 -0
  226. package/dist/help/dsl/topics/import.rebase.md +83 -0
  227. package/dist/help/dsl/topics/inspect.aliasCandidates.md +37 -0
  228. package/dist/help/dsl/topics/inspect.code.md +1 -7
  229. package/dist/help/dsl/topics/inspect.file.md +10 -19
  230. package/dist/help/dsl/topics/inspect.graph.md +3 -17
  231. package/dist/help/dsl/topics/{inspect.md → inspect.shared.md} +13 -12
  232. package/dist/help/dsl/topics/modulePlan.md +21 -26
  233. package/dist/help/dsl/topics/move.md +17 -18
  234. package/dist/help/{docs/file.move.md → dsl/topics/moveToDir.md} +33 -35
  235. package/dist/help/dsl/topics/mutate.mixed.md +32 -0
  236. package/dist/help/dsl/topics/mutation.shared.md +53 -0
  237. package/dist/help/dsl/topics/patterns.md +3 -12
  238. package/dist/help/dsl/topics/qr.md +12 -6
  239. package/dist/help/dsl/topics/quick-map.md +36 -24
  240. package/dist/help/dsl/topics/recipe.file-layout.md +10 -10
  241. package/dist/help/dsl/topics/recipe.import-boundary.md +90 -0
  242. package/dist/help/dsl/topics/recipe.safe-artifact-probing.md +66 -0
  243. package/dist/help/dsl/topics/recipe.unfamiliar-area.md +62 -0
  244. package/dist/help/dsl/topics/recipes.md +18 -0
  245. package/dist/help/dsl/topics/rename.md +15 -15
  246. package/dist/help/dsl/topics/renameFile.md +34 -0
  247. package/dist/help/dsl/topics/rules.md +24 -0
  248. package/dist/help/full.md +175 -340
  249. package/dist/help/help-index.md +48 -43
  250. package/dist/help/help-meta.json +98 -48
  251. package/dist/help/index.md +52 -20
  252. package/dist/help/snippets/agents.md +2 -2
  253. package/dist/help/tokens/qr.inline.examples.md +1 -1
  254. package/dist/help/topics/basics.md +1 -1
  255. package/dist/help/topics/config-setup.import-normalize.md +65 -65
  256. package/dist/help/topics/config-setup.import-rules.md +6 -5
  257. package/dist/help/topics/first-setup.md +6 -5
  258. package/dist/help/topics/help-protocol.md +4 -3
  259. package/dist/help/topics/import.base.md +36 -0
  260. package/dist/help/topics/import.rebase.md +83 -0
  261. package/dist/help/topics/inspect.aliasCandidates.md +37 -0
  262. package/dist/help/topics/inspect.code.md +1 -7
  263. package/dist/help/topics/inspect.file.md +10 -19
  264. package/dist/help/topics/inspect.graph.md +3 -17
  265. package/dist/help/topics/{inspect.md → inspect.shared.md} +13 -12
  266. package/dist/help/topics/modulePlan.md +21 -26
  267. package/dist/help/topics/move.md +17 -18
  268. package/dist/help/{dsl/docs/file.move.md → topics/moveToDir.md} +33 -35
  269. package/dist/help/topics/mutate.mixed.md +32 -0
  270. package/dist/help/topics/mutation.shared.md +53 -0
  271. package/dist/help/topics/patterns.md +3 -12
  272. package/dist/help/topics/qr.md +12 -6
  273. package/dist/help/topics/quick-map.md +36 -24
  274. package/dist/help/topics/recipe.file-layout.md +10 -10
  275. package/dist/help/topics/recipe.import-boundary.md +90 -0
  276. package/dist/help/topics/recipe.safe-artifact-probing.md +66 -0
  277. package/dist/help/topics/recipe.unfamiliar-area.md +62 -0
  278. package/dist/help/topics/recipes.md +18 -0
  279. package/dist/help/topics/rename.md +15 -15
  280. package/dist/help/topics/renameFile.md +34 -0
  281. package/dist/help/topics/rules.md +24 -0
  282. package/dist/host/capabilities.js +56 -1
  283. package/dist/imports/standalone-import-analysis.js +602 -0
  284. package/dist/imports/standalone-import-model.js +2 -0
  285. package/dist/imports/standalone-import-process.js +66 -0
  286. package/dist/imports/standalone-import-worker.js +27 -0
  287. package/dist/imports/standalone-ts-project.js +147 -0
  288. package/dist/inspect/inspect-duplicates-service.js +526 -0
  289. package/dist/inspect/inspect-reverse-module-closure.js +338 -0
  290. package/dist/inspect/inspect-source-ranges.js +82 -0
  291. package/dist/inspect/inspect-source-shape.js +649 -0
  292. package/dist/inspect/standalone-inspect-analysis.js +319 -0
  293. package/dist/inspect/standalone-inspect-model.js +9 -0
  294. package/dist/inspect/standalone-inspect-process.js +55 -0
  295. package/dist/inspect/standalone-inspect-usages.js +274 -0
  296. package/dist/inspect/standalone-inspect-worker.js +13 -0
  297. package/dist/metrics/central-metrics.js +101 -2
  298. package/dist/mutation/concrete-edit-plan.js +157 -0
  299. package/dist/mutation/exports-star-collapse-preview.js +361 -0
  300. package/dist/mutation/exports-star-expand-apply.js +373 -0
  301. package/dist/mutation/exports-star-expand-preview.js +807 -0
  302. package/dist/mutation/file-impact-scan.js +182 -0
  303. package/dist/mutation/file-mutation-discovery.js +674 -0
  304. package/dist/mutation/file-mutation-eta.js +99 -0
  305. package/dist/mutation/file-mutation-standalone-apply.js +584 -0
  306. package/dist/mutation/file-mutation-standalone-planner.js +500 -0
  307. package/dist/mutation/file-mutation-tsserver-session.js +473 -0
  308. package/dist/mutation/mutation-estimate.js +45 -0
  309. package/dist/mutation/mutation-plan.js +467 -0
  310. package/dist/mutation/object-mutation-foundation.js +2 -0
  311. package/dist/mutation/object-mutation-partition.js +148 -0
  312. package/dist/mutation/object-pack-semantic-apply.js +507 -0
  313. package/dist/mutation/object-pack-semantic-preview.js +984 -0
  314. package/dist/mutation/object-unpack-semantic-preview.js +993 -0
  315. package/dist/mutation/package-manifest-impact.js +176 -0
  316. package/dist/mutation/rename-owner-worker-child.js +37 -0
  317. package/dist/mutation/rename-owner-worker.js +122 -0
  318. package/dist/mutation/runtime-cycle-query.js +66 -0
  319. package/dist/mutation/semantic-execution-progress.js +63 -0
  320. package/dist/mutation/semantic-export-index.js +474 -0
  321. package/dist/mutation/semantic-impact-scan.js +434 -0
  322. package/dist/mutation/semantic-model.js +2 -0
  323. package/dist/mutation/semantic-move-best-effort-planner.js +209 -0
  324. package/dist/mutation/semantic-move-config-worker-child.js +61 -0
  325. package/dist/mutation/semantic-move-config-worker.js +449 -0
  326. package/dist/mutation/semantic-move-declarations.js +94 -0
  327. package/dist/mutation/semantic-move-metrics.js +119 -0
  328. package/dist/mutation/semantic-move-model.js +2 -0
  329. package/dist/mutation/semantic-move-owner-authority.js +122 -0
  330. package/dist/mutation/semantic-move-owner-candidates.js +300 -0
  331. package/dist/mutation/semantic-move-owner-divergence-harness.js +474 -0
  332. package/dist/mutation/semantic-move-owner-divergence-runner.js +162 -0
  333. package/dist/mutation/semantic-move-plan-hash.js +56 -0
  334. package/dist/mutation/semantic-move-policy.js +360 -0
  335. package/dist/mutation/semantic-move-process.js +218 -0
  336. package/dist/mutation/semantic-move-provider-diagnostics.js +27 -0
  337. package/dist/mutation/semantic-move-standalone-engine.js +919 -0
  338. package/dist/mutation/semantic-move-standalone-planner.js +1553 -0
  339. package/dist/mutation/semantic-move-transaction.js +639 -0
  340. package/dist/mutation/semantic-mutation-engine.js +478 -0
  341. package/dist/mutation/semantic-mutation-runtime.js +521 -0
  342. package/dist/mutation/semantic-planner-retry.js +26 -0
  343. package/dist/mutation/semantic-program-roots.js +69 -0
  344. package/dist/mutation/semantic-rename-commonjs.js +229 -0
  345. package/dist/mutation/semantic-rename-config-worker-child.js +46 -0
  346. package/dist/mutation/semantic-rename-config-worker.js +498 -0
  347. package/dist/mutation/semantic-rename-locations.js +192 -0
  348. package/dist/mutation/semantic-rename-model.js +2 -0
  349. package/dist/mutation/semantic-rename-process.js +217 -0
  350. package/dist/mutation/semantic-rename-standalone-engine.js +302 -0
  351. package/dist/mutation/semantic-rename-standalone-planner.js +567 -0
  352. package/dist/mutation/semantic-rename-transaction.js +333 -0
  353. package/dist/mutation/semantic-unused-import-cleanup.js +248 -0
  354. package/dist/mutation/semantic-worker-retry.js +40 -0
  355. package/dist/mutation/semantic-workspace.js +804 -0
  356. package/dist/mutation/targeted-import-canonicalizer.js +359 -0
  357. package/dist/observability/config.js +206 -1
  358. package/dist/observability/context.js +59 -1
  359. package/dist/observability/failure-snapshot.js +124 -2
  360. package/dist/observability/recent.js +63 -2
  361. package/dist/payloads/read-stdin-json.js +212 -1
  362. package/dist/rg-wrapper/core.js +714 -6
  363. package/dist/rg-wrapper/options.js +125 -1
  364. package/dist/rtk-wrapper/core.js +144 -2
  365. package/dist/rtk-wrapper/git-safety.js +203 -0
  366. package/dist/rtk-wrapper/output-adapter.js +106 -0
  367. package/dist/runtime/buffered-process.js +114 -0
  368. package/dist/runtime/bundled-node.js +97 -1
  369. package/dist/runtime/command-lifecycle.js +2 -0
  370. package/dist/runtime/input-source.js +238 -1
  371. package/dist/runtime/node-cli-identity.js +37 -0
  372. package/dist/runtime/run-command.js +191 -1
  373. package/dist/selectors/parse-entities.js +84 -1
  374. package/dist/semantic/semantic-context-pool.js +830 -0
  375. package/dist/semantic/semantic-context-provider.js +416 -0
  376. package/dist/semantic/semantic-resident-admission.js +38 -0
  377. package/dist/semantic/semantic-worker-child.js +40 -0
  378. package/dist/semantic/semantic-worker-manager.js +460 -0
  379. package/dist/semantic/semantic-worker-protocol.js +2 -0
  380. package/dist/semantic/semantic-worker-runtime.js +38 -0
  381. package/dist/semantic/workspace-semantic-context-pools.js +136 -0
  382. package/dist/session/client.js +359 -1
  383. package/dist/session/daemon-state.js +185 -2
  384. package/dist/session/external-tool-coordinator.js +88 -0
  385. package/dist/session/external-tool-request.js +52 -0
  386. package/dist/session/lane-owner.js +116 -0
  387. package/dist/session/paths.js +71 -1
  388. package/dist/session/runtime-lifecycle.js +225 -0
  389. package/dist/session/runtime-shutdown.js +95 -0
  390. package/dist/session/server.js +1194 -7
  391. package/dist/session/session-health.js +27 -0
  392. package/dist/shared/agent-text.js +29 -1
  393. package/dist/shared/errors.js +496 -30
  394. package/dist/shared/event-loop.js +6 -1
  395. package/dist/shared/hints.js +37 -1
  396. package/dist/shared/metrics.js +43 -1
  397. package/dist/shared/presentation.js +69 -4
  398. package/dist/shared/stdin-examples.js +77 -1
  399. package/dist/shared/stdout.js +6 -2
  400. package/dist/shared/types.js +23 -1
  401. package/dist/tool-runtime/runtime-tools.js +120 -1
  402. package/dist/topology/availability.js +663 -0
  403. package/dist/topology/cache.js +130 -0
  404. package/dist/topology/candidates.js +372 -0
  405. package/dist/topology/core.js +903 -0
  406. package/dist/topology/dependency-snapshot.js +189 -0
  407. package/dist/topology/model.js +2 -0
  408. package/dist/topology/scope.js +100 -0
  409. package/dist/topology/ts-oracle-batch.js +529 -0
  410. package/dist/topology/ts-oracle-host.js +69 -0
  411. package/dist/topology/ts-oracle-model.js +2 -0
  412. package/dist/topology/ts-oracle.js +224 -0
  413. package/dist/topology/tsconfig-loader.js +105 -0
  414. package/dist/topology/workspace-project-index.js +542 -0
  415. package/dist/tracing/config.js +192 -2
  416. package/dist/tracing/failure-summary.js +100 -0
  417. package/dist/tracing/trace.js +318 -5
  418. package/dist/tsc-wrapper/core.js +697 -0
  419. package/dist/workers/control-plane/aib-control-plane-worker.cjs +32 -32
  420. package/dist/workers/control-plane/client-config.default.json +3 -3
  421. package/dist/workers/lexical-worker-child.js +27 -0
  422. package/dist/workers/lexical-worker-manager.js +394 -0
  423. package/dist/workers/lexical-worker-protocol.js +2 -0
  424. package/dist/workers/lexical-worker-runtime.js +25 -0
  425. package/dist/workers/owned-one-shot-process.js +115 -0
  426. package/dist/workers/product-storage.js +23 -1
  427. package/dist/workers/registry.js +241 -1
  428. package/package.json +8 -13
  429. package/scripts/postinstall.cjs +29 -29
  430. package/scripts/provision-runtime.cjs +411 -459
  431. package/dist/client/http-client.js +0 -1
  432. package/dist/client/transport-options.js +0 -1
  433. package/dist/client/websocket-client.js +0 -1
  434. package/dist/commands/entity-resolution.js +0 -1
  435. package/dist/commands/file-command.js +0 -1
  436. package/dist/commands/host-command.js +0 -1
  437. package/dist/commands/inspect-symbol-query.js +0 -1
  438. package/dist/commands/list-instances.js +0 -1
  439. package/dist/commands/module-plan-command.js +0 -1
  440. package/dist/commands/move-command.js +0 -1
  441. package/dist/commands/move-to-file.js +0 -2
  442. package/dist/commands/ping.js +0 -1
  443. package/dist/commands/refactor-command.js +0 -1
  444. package/dist/commands/rename-command.js +0 -1
  445. package/dist/commands/runtime-command.js +0 -4
  446. package/dist/commands/runtime-info.js +0 -1
  447. package/dist/commands/validate-module-plan.js +0 -2
  448. package/dist/compatibility/policy.js +0 -1
  449. package/dist/config/auto-start-ide.js +0 -1
  450. package/dist/discovery/registry.js +0 -1
  451. package/dist/discovery/select-instance.js +0 -1
  452. package/dist/help/docs/file.rename.md +0 -35
  453. package/dist/help/docs/mutation.md +0 -60
  454. package/dist/help/docs/refactor.batch.md +0 -44
  455. package/dist/help/dsl/docs/file.rename.md +0 -35
  456. package/dist/help/dsl/docs/mutation.md +0 -60
  457. package/dist/help/dsl/docs/refactor.batch.md +0 -44
  458. package/dist/help/dsl/topics/file.rename.md +0 -33
  459. package/dist/help/dsl/topics/mutation.md +0 -58
  460. package/dist/help/dsl/topics/refactor.batch.md +0 -33
  461. package/dist/help/topics/file.rename.md +0 -33
  462. package/dist/help/topics/mutation.md +0 -58
  463. package/dist/help/topics/refactor.batch.md +0 -33
  464. package/dist/ide-launch/common.cjs +0 -162
  465. package/dist/managed-host/extension-vsix-resolver.js +0 -1
  466. package/dist/managed-host/manage-serve-web-host.cjs +0 -141
  467. package/dist/managed-host/serve-web-autostart.js +0 -1
  468. package/dist/managed-host/serve-web-host.cjs +0 -2115
  469. package/dist/runtime/managed-runtime-provisioning.js +0 -1
  470. package/dist/shared/diagnostic-catalog.js +0 -1
  471. package/dist/shared/diagnostics.js +0 -1
  472. package/dist/shared/operations.js +0 -1
  473. package/dist/shared/protocol.js +0 -1
  474. package/dist/shared/routes.js +0 -1
  475. package/extension/vscode-refactor-bridge-extension.vsix +0 -0
  476. package/runtimes/launcher/linux-x64/aib +0 -0
  477. package/runtimes/launcher/win-x64/aib.exe +0 -0
@@ -1,3 +1,47 @@
1
- "use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.runObservabilityCommand=a;const s=require("../shared/agent-text"),o=require("../shared/errors"),c=require("../observability/config");function a(t,n){const e=n[0]??"status";if(e==="status"){const r=(0,c.observabilityStatus)(t);return(0,s.attachAgentText)(r,u(r))}if(e==="cleanup")return(0,s.attachAgentText)({ok:!0,command:"observability",action:"cleanup",dryRun:!0,enforced:!1,note:"Cleanup policy is visible but not enforced yet."},`observability cleanup dry-run
2
- no files deleted`);throw new o.CliError("UNKNOWN_OBSERVABILITY_COMMAND",`Unknown aib observability command: ${e}`,{availableCommands:["status","cleanup"]})}function u(t){const n=i(t.effective)?t.effective:{},e=i(t.storage)?t.storage:{},r=i(t.counters)?t.counters:{};return["observability",`metrics: ${String(n.metrics??"unknown")}`,`mutationImpactMetrics: ${String(n.mutationImpactMetrics??"unknown")}`,`trace: ${String(n.trace??"unknown")}`,`failureSnapshots: ${String(n.failureSnapshots??"unknown")}`,`metricsRows: ${String(r.metricsRows??0)}`,`traceBytes: ${String(r.traceBytes??0)}`,`feedbackRows: ${String(r.feedbackRows??0)}`,`metricsFile: ${String(e.metricsFile??"")}`,`traceDir: ${String(e.traceDir??"")}`,`feedbackFile: ${String(e.feedbackFile??"")}`].join(`
3
- `)}function i(t){return!!t&&typeof t=="object"&&!Array.isArray(t)}
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.runObservabilityCommand = runObservabilityCommand;
4
+ const agent_text_1 = require("../shared/agent-text");
5
+ const errors_1 = require("../shared/errors");
6
+ const config_1 = require("../observability/config");
7
+ function runObservabilityCommand(cwd, args) {
8
+ const subcommand = args[0] ?? "status";
9
+ if (subcommand === "status") {
10
+ const result = (0, config_1.observabilityStatus)(cwd);
11
+ return (0, agent_text_1.attachAgentText)(result, formatStatusText(result));
12
+ }
13
+ if (subcommand === "cleanup") {
14
+ return (0, agent_text_1.attachAgentText)({
15
+ ok: true,
16
+ command: "observability",
17
+ action: "cleanup",
18
+ dryRun: true,
19
+ enforced: false,
20
+ note: "Cleanup policy is visible but not enforced yet."
21
+ }, "observability cleanup dry-run\nno files deleted");
22
+ }
23
+ throw new errors_1.CliError("UNKNOWN_OBSERVABILITY_COMMAND", `Unknown aib observability command: ${subcommand}`, {
24
+ availableCommands: ["status", "cleanup"]
25
+ });
26
+ }
27
+ function formatStatusText(payload) {
28
+ const effective = isObject(payload.effective) ? payload.effective : {};
29
+ const storage = isObject(payload.storage) ? payload.storage : {};
30
+ const counters = isObject(payload.counters) ? payload.counters : {};
31
+ return [
32
+ "observability",
33
+ `metrics: ${String(effective.metrics ?? "unknown")}`,
34
+ `mutationImpactMetrics: ${String(effective.mutationImpactMetrics ?? "unknown")}`,
35
+ `trace: ${String(effective.trace ?? "unknown")}`,
36
+ `failureSnapshots: ${String(effective.failureSnapshots ?? "unknown")}`,
37
+ `metricsRows: ${String(counters.metricsRows ?? 0)}`,
38
+ `traceBytes: ${String(counters.traceBytes ?? 0)}`,
39
+ `feedbackRows: ${String(counters.feedbackRows ?? 0)}`,
40
+ `metricsFile: ${String(storage.metricsFile ?? "")}`,
41
+ `traceDir: ${String(storage.traceDir ?? "")}`,
42
+ `feedbackFile: ${String(storage.feedbackFile ?? "")}`
43
+ ].join("\n");
44
+ }
45
+ function isObject(value) {
46
+ return Boolean(value) && typeof value === "object" && !Array.isArray(value);
47
+ }
@@ -1,2 +1,403 @@
1
- "use strict";var _=exports&&exports.__importDefault||function(t){return t&&t.__esModule?t:{default:t}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.runOtaCommand=H;const d=_(require("node:fs")),l=_(require("node:path")),J=require("node:crypto"),R=require("../session/daemon-state"),W=require("../workers/product-storage"),U=1;async function H(t){const e=At(t);return e.action==="status"?X(e):e.action==="stop"?K(e):e.action==="run-once"?$(e):e.action==="rollback"?Y(e):e.action==="cleanup"?Z(e):e.action==="watch"?Q(e):{ok:!1,command:"ota",error:`Unknown ota action: ${e.action}`,availableActions:["run-once","watch","stop","status","rollback","cleanup"]}}function X(t){const e=yt(t),n=b(t.watchPath);return{ok:!0,command:"ota",action:"status",lanes:e,daemon:wt(t),watch:bt(n,t)}}function K(t){const e=b(t.watchPath),n=e?.status==="running"&&V(e.pid);return k(t.stopPath,{schemaVersion:1,requestedAt:new Date().toISOString(),pid:process.pid,targetPid:n?e.pid:null}),{ok:!0,command:"ota",action:"stop",stopped:n,skipped:!n,reason:n?"stop requested":"no running ota watch"}}async function Q(t){const e=dt(t);if(e)return{ok:!0,command:"ota",action:"watch",skipped:!0,blocked:!0,reason:e};const n=b(t.watchPath);if(n?.status==="running"){if(V(n.pid))return{ok:!0,command:"ota",action:"watch",skipped:!0,reason:"ota watch is already running",pid:n.pid};D(t,{...n,status:"stale",updatedAt:new Date().toISOString(),finishedAt:new Date().toISOString()})}d.default.rmSync(t.stopPath,{force:!0});const a=Date.now();let i=0;for(;i<t.maxAttempts&&Date.now()-a<=t.timeoutMs;){if(i+=1,D(t,{schemaVersion:1,updatedAt:new Date().toISOString(),status:"running",pid:process.pid,startedAt:new Date(a).toISOString(),targetLanes:["cli-package"],intervalMs:t.intervalMs,timeoutMs:t.timeoutMs,maxAttempts:t.maxAttempts,attempts:i,stopPath:t.stopPath}),d.default.existsSync(t.stopPath))return j(t,"stopped",i,{ok:!0,command:"ota",action:"watch",stopped:!0,attempts:i});const r=$(t);if(r.activated===!0||r.skipped===!0)return j(t,r.activated===!0?"activated":"skipped",i,r);await Ct(t.intervalMs)}return j(t,"timeout",i,{ok:!1,command:"ota",action:"watch",status:"timeout",attempts:i,elapsedMs:Date.now()-a,watchPath:t.watchPath})}function $(t){return B(t,()=>{const e=m(t.statusPath),n=C(t.extensionStatusPath),a=ot(t,e,n);if(a.blocked)return{ok:!0,command:"ota",action:"run-once",blocked:!0,reason:a.reason??"OTA activation is blocked",...a.lane?{lane:a.lane}:{},...a.groupId?{activationGroupId:a.groupId}:{},...a.statusPath?{statusPath:a.statusPath}:{}};if(a.items.length===0)return{ok:!0,command:"ota",action:"run-once",skipped:!0,reason:"no pending OTA activation"};const i=new Date().toISOString();let r=e,o=n;for(const s of a.items)s.lane==="cli-package"&&e?.pending&&(r=rt(e,t,i),O(t.statusPath,r)),s.lane==="extension-vsix"&&n?.pending&&(o=st(n,i),G(t.extensionStatusPath,o));for(const s of a.items){if(s.lane==="cli-package"&&r?.activating){const v=it(r,t,i);O(t.statusPath,v),k(t.pointerPath,{schemaVersion:1,updatedAt:v.updatedAt,packageVersion:r.activating.packageVersion,artifactVersion:r.activating.artifactVersion,activeRoot:r.activating.packageRoot,activeCliPath:r.activating.cliPath,entry:r.activating.entry})}s.lane==="extension-vsix"&&o?.activating&&G(t.extensionStatusPath,ct(o,i))}return{ok:!0,command:"ota",action:"run-once",activated:!0,lanes:a.items.map(s=>s.lane),...a.groupId?{activationGroupId:a.groupId}:{}}})}function Y(t){return B(t,()=>{const e=m(t.statusPath),n=C(t.extensionStatusPath),a=ht(t,e,n),i=new Date().toISOString(),r=[];if(e?.previous&&(!a||e.active?.activationGroup?.id===a||e.previous.activationGroup?.id===a)){const o=ut(e,t,i);O(t.statusPath,o),k(t.pointerPath,{schemaVersion:1,updatedAt:o.updatedAt,packageVersion:o.active.packageVersion,artifactVersion:o.active.artifactVersion,activeRoot:o.active.packageRoot,activeCliPath:o.active.cliPath,entry:o.active.entry}),r.push("cli-package")}return n?.previous&&(!a||n.active?.activationGroup?.id===a||n.previous.activationGroup?.id===a)&&(G(t.extensionStatusPath,lt(n,i)),r.push("extension-vsix")),r.length===0?{ok:!0,command:"ota",action:"rollback",skipped:!0,reason:a?`no previous OTA state for activation group ${a}`:"no previous OTA state"}:{ok:!0,command:"ota",action:"rollback",rolledBack:!0,lanes:r,...a?{activationGroupId:a}:{}}})}function Z(t){if(A(t).killSwitches.includes("ota-cleanup"))return{ok:!0,command:"ota",action:"cleanup",skipped:!0,reason:"OTA cleanup is disabled by policy kill-switch ota-cleanup"};const n=tt(t);let a=0,i=0;const r=[];if(!t.dryRun)for(const o of n)try{d.default.rmSync(o.path,{recursive:!0,force:!0}),a+=1}catch(s){i+=1,r.push({lane:o.lane,path:o.path,error:s instanceof Error?s.message:String(s)})}return{ok:i===0,command:"ota",action:"cleanup",dryRun:t.dryRun,candidates:n.length,removed:a,failed:i,byLane:at(n),...r.length>0?{failures:r}:{}}}function tt(t){const e=m(t.statusPath),n=C(t.extensionStatusPath);return[...L({lane:"cli-package",versionsRoot:l.default.join(t.productStorageRoot,"cli-package","versions"),protectedRoots:et(e),keepRecent:t.keepRecent}),...L({lane:"extension-vsix",versionsRoot:l.default.join(t.productStorageRoot,"extension","versions"),protectedRoots:nt(n),keepRecent:t.keepRecent}),...q(l.default.join(t.productStorageRoot,"cli-package"),".package-staging-","cli-package",t.stagingMaxAgeMs),...q(l.default.join(t.productStorageRoot,"extension"),".vsix-staging-","extension-vsix",t.stagingMaxAgeMs)]}function L(t){if(!d.default.existsSync(t.versionsRoot))return[];const e=d.default.readdirSync(t.versionsRoot,{withFileTypes:!0}).filter(n=>n.isDirectory()).map(n=>{const a=l.default.join(t.versionsRoot,n.name);return{lane:t.lane,kind:"version-root",path:a,mtimeMs:d.default.statSync(a).mtimeMs}}).filter(n=>!t.protectedRoots.has(l.default.resolve(n.path)));return e.sort((n,a)=>a.mtimeMs-n.mtimeMs),e.slice(t.keepRecent)}function q(t,e,n,a){if(!d.default.existsSync(t))return[];const i=Date.now();return d.default.readdirSync(t,{withFileTypes:!0}).filter(r=>r.isDirectory()&&r.name.startsWith(e)).map(r=>{const o=l.default.join(t,r.name);return{lane:n,kind:"staging-dir",path:o,mtimeMs:d.default.statSync(o).mtimeMs}}).filter(r=>i-r.mtimeMs>=a)}function et(t){return new Set([t?.active?.packageRoot,t?.previous?.packageRoot,t?.pending?.packageRoot,t?.activating?.packageRoot].filter(e=>typeof e=="string").map(e=>l.default.resolve(e)))}function nt(t){return new Set([t?.active?.vsixPath?l.default.dirname(t.active.vsixPath):void 0,t?.previous?.vsixPath?l.default.dirname(t.previous.vsixPath):void 0,t?.pending?.vsixPath?l.default.dirname(t.pending.vsixPath):void 0,t?.activating?.vsixPath?l.default.dirname(t.activating.vsixPath):void 0].filter(e=>typeof e=="string").map(e=>l.default.resolve(e)))}function at(t){const e={};for(const n of t){const a=e[n.lane]??{candidates:0,versionRoots:0,stagingDirs:0};a.candidates=Number(a.candidates)+1,n.kind==="version-root"?a.versionRoots=Number(a.versionRoots)+1:a.stagingDirs=Number(a.stagingDirs)+1,e[n.lane]=a}return e}function it(t,e,n=new Date().toISOString()){const a=t.activating??t.pending;return{schemaVersion:1,updatedAt:n,statusPath:e.statusPath,activePointerPath:e.pointerPath,activeRoot:a.packageRoot,activeCliPath:a.cliPath,active:{packageVersion:a.packageVersion,artifactVersion:a.artifactVersion,packageRoot:a.packageRoot,cliPath:a.cliPath,entry:a.entry,activatedAt:n,fileCount:a.fileCount,...a.activationGroup?{activationGroup:a.activationGroup}:{}},...t.active?{previous:{packageVersion:t.active.packageVersion,packageRoot:t.active.packageRoot,cliPath:t.active.cliPath,entry:t.active.entry,savedAt:n,...t.active.activationGroup?{activationGroup:t.active.activationGroup}:{}}}:t.previous?{previous:t.previous}:{},...t.staged?{staged:t.staged}:{}}}function rt(t,e,n){if(t.activating)return t;const a=t.pending;return{schemaVersion:1,updatedAt:n,statusPath:e.statusPath,activePointerPath:e.pointerPath,...t.activeRoot?{activeRoot:t.activeRoot}:{},...t.activeCliPath?{activeCliPath:t.activeCliPath}:{},...t.active?{active:t.active}:{},...t.previous?{previous:t.previous}:{},...t.staged?{staged:t.staged}:{},activating:{...a,activatingAt:n},...t.lastError?{lastError:t.lastError}:{}}}function ot(t,e,n){const a=[...e?.activating||e?.pending?[{lane:"cli-package",pending:e.activating??e.pending,status:e,statusPath:t.statusPath}]:[],...n?.activating||n?.pending?[{lane:"extension-vsix",pending:n.activating??n.pending,status:n,statusPath:t.extensionStatusPath}]:[]];if(a.length===0)return{items:[]};const i=I(t);if(i)return{items:[],blocked:!0,reason:i};for(const u of a){const g=M(t,u.lane);if(g)return{items:[],blocked:!0,reason:g,lane:u.lane,statusPath:u.statusPath};if(u.pending.reason)return{items:[],blocked:!0,reason:u.pending.reason,lane:u.lane,statusPath:u.statusPath};if(!(u.lane==="cli-package"?d.default.existsSync(u.pending.cliPath):d.default.existsSync(u.pending.vsixPath)))return{items:[],blocked:!0,reason:`${u.lane} pending artifact is missing`,lane:u.lane,statusPath:u.statusPath};const P=pt(u);if(P)return{items:[],blocked:!0,reason:P,lane:u.lane,statusPath:u.statusPath};const y=vt(t,u);if(y)return{items:[],blocked:!0,reason:y,lane:u.lane,statusPath:u.statusPath};const E=u.lane==="cli-package"?gt(t):null;if(E)return{items:[],blocked:!0,reason:E,lane:u.lane,statusPath:u.statusPath}}const r=a.find(u=>u.pending.activationGroup)?.pending.activationGroup;if(!r)return{items:[{lane:a[0].lane}]};const o=ft(t,r);if(o)return{items:[],blocked:!0,reason:o,groupId:r.id};const s=r.requiredLanes.length>0?r.requiredLanes:[a[0].lane],v=a.filter(u=>u.pending.activationGroup?.id===r.id);for(const u of s)if(!v.some(g=>g.lane===u))return{items:[],blocked:!0,reason:`activation group ${r.id} is missing required lane ${u}`,groupId:r.id};return{items:v.map(u=>({lane:u.lane})),groupId:r.id}}function ct(t,e=new Date().toISOString()){const n=t.activating??t.pending;return{schemaVersion:1,updatedAt:e,statusPath:t.statusPath,activeVsixPath:n.vsixPath,active:{extensionVersion:n.extensionVersion,artifactVersion:n.artifactVersion,vsixPath:n.vsixPath,entry:n.entry,activatedAt:e,sizeBytes:n.sizeBytes,sha256:n.sha256,...n.activationGroup?{activationGroup:n.activationGroup}:{}},...t.active?{previous:{extensionVersion:t.active.extensionVersion,vsixPath:t.active.vsixPath,entry:t.active.entry,savedAt:e,...t.active.activationGroup?{activationGroup:t.active.activationGroup}:{}}}:t.previous?{previous:t.previous}:{},...t.staged?{staged:t.staged}:{}}}function st(t,e){if(t.activating)return t;const n=t.pending;return{schemaVersion:1,updatedAt:e,statusPath:t.statusPath,...t.activeVsixPath?{activeVsixPath:t.activeVsixPath}:{},...t.active?{active:t.active}:{},...t.previous?{previous:t.previous}:{},...t.staged?{staged:t.staged}:{},activating:{...n,activatingAt:e},...t.delayedActivation?{delayedActivation:t.delayedActivation}:{},...t.lastError?{lastError:t.lastError}:{}}}function ut(t,e,n){const a=t.active,i=t.previous;return{schemaVersion:1,updatedAt:n,statusPath:e.statusPath,activePointerPath:e.pointerPath,activeRoot:i.packageRoot,activeCliPath:i.cliPath,active:{packageVersion:i.packageVersion,artifactVersion:`rollback:${i.packageVersion}`,packageRoot:i.packageRoot,cliPath:i.cliPath,entry:i.entry,activatedAt:n,fileCount:0,...i.activationGroup?{activationGroup:i.activationGroup}:{}},...a?{previous:{packageVersion:a.packageVersion,packageRoot:a.packageRoot,cliPath:a.cliPath,entry:a.entry,savedAt:n,...a.activationGroup?{activationGroup:a.activationGroup}:{}}}:{}}}function lt(t,e){const n=t.active,a=t.previous;return{schemaVersion:1,updatedAt:e,statusPath:t.statusPath,activeVsixPath:a.vsixPath,active:{extensionVersion:a.extensionVersion,artifactVersion:`rollback:${a.extensionVersion}`,vsixPath:a.vsixPath,entry:a.entry,activatedAt:e,sizeBytes:d.default.existsSync(a.vsixPath)?d.default.statSync(a.vsixPath).size:0,sha256:d.default.existsSync(a.vsixPath)?jt(a.vsixPath):"",...a.activationGroup?{activationGroup:a.activationGroup}:{}},...n?{previous:{extensionVersion:n.extensionVersion,vsixPath:n.vsixPath,entry:n.entry,savedAt:e,...n.activationGroup?{activationGroup:n.activationGroup}:{}}}:{}}}function I(t){return A(t).killSwitches.includes("ota-activation")?"OTA activation is disabled by policy kill-switch ota-activation":null}function dt(t){const e=A(t);return e.killSwitches.includes("ota-watch")?"OTA watch is disabled by policy kill-switch ota-watch":e.killSwitches.includes("ota-activation")?"OTA watch is disabled because OTA activation is disabled":null}function M(t,e){const n=A(t),a=[`${e}-activation`];e==="cli-package"&&a.push("cli-package-activation"),e==="extension-vsix"&&a.push("extension-vsix-activation");const i=a.find(r=>n.killSwitches.includes(r));return i?`${e} activation is disabled by policy kill-switch ${i}`:null}function vt(t,e){const n=e.pending.activationGroup,a=e.status.active?.activationGroup;if(n?.sequence!==void 0&&a?.sequence!==void 0)return n.sequence<=a.sequence&&n.allowDowngrade!==!0?`${e.lane} activation sequence ${n.sequence} is not newer than active sequence ${a.sequence}`:null;const i=e.lane==="cli-package"?e.pending.packageVersion:e.pending.extensionVersion,r=e.lane==="cli-package"?e.status.active?.packageVersion:e.status.active?.extensionVersion;return r&&Mt(i,r)<=0&&n?.allowDowngrade!==!0?`${e.lane} version ${i} is not newer than active version ${r}`:null}function pt(t){return t.pending.productStorageSchema!==void 0&&t.pending.productStorageSchema>U?`${t.lane} requires unsupported product storage schema ${t.pending.productStorageSchema}`:t.pending.nonReversibleMigration===!0?`${t.lane} requires a non-reversible storage migration`:null}function gt(t){const e=(0,R.readCliDaemonIdentity)(t.productStorageRoot);if(!e)return null;const n=z(e,t);return n.status==="dead"||n.status==="stale"||n.status==="stopped"?null:e.runningExecutions.length>0?`daemon has running executions: ${e.runningExecutions.map(i=>i.executionId).slice(0,3).join(", ")}`:e.activeInvokeCount>0?`daemon has ${e.activeInvokeCount} active invoke${e.activeInvokeCount===1?"":"s"}`:null}function ft(t,e){if(!e.channel)return null;const n=It(t);return n&&n!==e.channel?`activation group ${e.id} is scoped to channel ${e.channel}, but cached channel is ${n}`:null}function ht(t,e,n){return t.lane&&t.lane!=="cli-package"&&t.lane!=="extension-vsix"?t.lane:e?.active?.activationGroup?.id??n?.active?.activationGroup?.id??null}function B(t,e){d.default.mkdirSync(l.default.dirname(t.activationLockPath),{recursive:!0});try{T(t.activationLockPath)}catch(n){if(Ot(n))if(kt(t.activationLockPath))T(t.activationLockPath);else return{ok:!0,command:"ota",action:"run-once",blocked:!0,reason:"ota activation already locked",lockPath:t.activationLockPath};else throw n}try{return e()}finally{d.default.rmSync(t.activationLockPath,{recursive:!0,force:!0})}}function T(t){d.default.mkdirSync(t),k(l.default.join(t,"owner.json"),{schemaVersion:1,pid:process.pid,acquiredAt:new Date().toISOString()})}function kt(t){const e=l.default.join(t,"owner.json"),n=mt(e);return n&&V(n.pid)||!n&&!Pt(t)?!1:(d.default.rmSync(t,{recursive:!0,force:!0}),!0)}function mt(t){try{const e=JSON.parse(d.default.readFileSync(t,"utf8"));return e?.schemaVersion===1&&Number.isInteger(e.pid)?e:null}catch{return null}}function Pt(t){try{const e=d.default.statSync(t);return Date.now()-e.mtimeMs>6e4}catch{return!0}}function j(t,e,n,a){const i=a.ok!==!1&&e!=="timeout";return D(t,{schemaVersion:1,updatedAt:new Date().toISOString(),status:e,pid:process.pid,startedAt:b(t.watchPath)?.startedAt??new Date().toISOString(),finishedAt:new Date().toISOString(),targetLanes:["cli-package"],intervalMs:t.intervalMs,timeoutMs:t.timeoutMs,maxAttempts:t.maxAttempts,attempts:n,stopPath:t.stopPath,lastResult:a}),{ok:i,command:"ota",action:"watch",status:e,attempts:n,result:a,...i?{}:{watchPath:t.watchPath}}}function yt(t){const e=t.lane?[t.lane]:["cli-package","extension-vsix","worker-registry","worker-bundle","launcher-pack","policy-config","background-schedule"],n={};for(const a of e)n[a]=xt(a,t);return n}function xt(t,e){return t==="cli-package"?Vt(m(e.statusPath),e):t==="extension-vsix"?S(t,l.default.join(e.productStorageRoot,"extension","activation-status.json"),e):t==="worker-registry"?S(t,l.default.join(e.productStorageRoot,"workers","activation-status.json"),e):t==="launcher-pack"?S(t,l.default.join(e.productStorageRoot,"launchers","activation-status.json"),e):t==="policy-config"?N(t,l.default.join(e.productStorageRoot,"control-plane","policy-config.json"),"configVersion",e):t==="background-schedule"?N(t,l.default.join(e.productStorageRoot,"background","schedule-config.json"),"configVersion",e):t==="worker-bundle"?St(e):{lane:t,status:"unknown",error:`Unknown OTA lane: ${t}`,availableLanes:["cli-package","extension-vsix","worker-bundle","worker-registry","launcher-pack","policy-config","background-schedule"]}}function Vt(t,e){const n=I(e)??M(e,"cli-package");if(!t){const i={lane:"cli-package",status:n?"policy-disabled":"inactive",...n?{blocker:n}:{}};return e.verbose?{...i,statusPath:e.statusPath,activePointerPath:e.pointerPath}:i}const a={lane:"cli-package",status:t.activating?"activating":n||t.pending?.reason?"pending-blocked":t.pending?"pending-ready":t.active?"active":t.lastError?"error":"inactive",...t.active?.packageVersion?{activeVersion:t.active.packageVersion}:{},...t.activating?.packageVersion?{activatingVersion:t.activating.packageVersion}:{},...t.pending?.packageVersion?{pendingVersion:t.pending.packageVersion}:{},...n||t.pending?.reason?{blocker:n??t.pending.reason,statusPath:e.statusPath}:{},...t.previous?.packageVersion?{previousVersion:t.previous.packageVersion}:{},...t.lastError?{lastError:c(t.lastError.error)??"unknown error",statusPath:e.statusPath}:{}};return e.verbose?{...a,statusPath:e.statusPath,activePointerPath:e.pointerPath,active:t.active??null,pending:t.pending??null,activating:t.activating??null,previous:t.previous??null,staged:t.staged??null,lastError:t.lastError??null}:a}function S(t,e,n){const a=t==="extension-vsix"?I(n)??M(n,t):null,i=w(e);if(!i){const y={lane:t,status:a?"policy-disabled":"inactive",...a?{blocker:a}:{}};return n.verbose?{...y,statusPath:e}:y}const r=h(i.active),o=h(i.staged),s=h(i.pending),v=h(i.activating),u=h(i.delayedActivation),g=h(i.lastError),p=h(i.previous),P={lane:t,status:v?"activating":a||c(s?.reason)?"pending-blocked":s?"pending-ready":u?"pending-blocked":o?"staged":r?"active":g?"error":"inactive",...c(r?.packageVersion)?{activeVersion:c(r?.packageVersion)}:{},...c(r?.extensionVersion)?{activeVersion:c(r?.extensionVersion)}:{},...c(r?.launcherVersion)?{activeVersion:c(r?.launcherVersion)}:{},...c(r?.registryVersion)?{activeVersion:c(r?.registryVersion)}:{},...c(o?.packageVersion)?{stagedVersion:c(o?.packageVersion)}:{},...c(o?.extensionVersion)?{stagedVersion:c(o?.extensionVersion)}:{},...c(o?.launcherVersion)?{stagedVersion:c(o?.launcherVersion)}:{},...c(o?.registryVersion)?{stagedVersion:c(o?.registryVersion)}:{},...c(s?.packageVersion)?{pendingVersion:c(s?.packageVersion)}:{},...c(s?.extensionVersion)?{pendingVersion:c(s?.extensionVersion)}:{},...c(v?.packageVersion)?{activatingVersion:c(v?.packageVersion)}:{},...c(v?.extensionVersion)?{activatingVersion:c(v?.extensionVersion)}:{},...c(p?.packageVersion)?{previousVersion:c(p?.packageVersion)}:{},...c(p?.extensionVersion)?{previousVersion:c(p?.extensionVersion)}:{},...c(p?.launcherVersion)?{previousVersion:c(p?.launcherVersion)}:{},...c(p?.registryVersion)?{previousVersion:c(p?.registryVersion)}:{},...a||c(s?.reason)?{blocker:a??c(s?.reason),statusPath:e}:{},...c(u?.reason)&&!a&&!c(s?.reason)?{blocker:c(u?.reason),statusPath:e}:{},...c(g?.error)?{lastError:c(g?.error),statusPath:e}:{}};return n.verbose?{...P,statusPath:e,active:f(r),staged:f(o),pending:f(s),activating:f(v),previous:f(p),delayedActivation:f(u),lastError:f(g)}:P}function St(t){const e=l.default.join(t.productStorageRoot,"workers","bundles");if(!d.default.existsSync(e))return t.verbose?{lane:"worker-bundle",status:"inactive",root:e}:{lane:"worker-bundle",status:"inactive"};const n=[];for(const a of d.default.readdirSync(e)){const i=l.default.join(e,a,"activation-status.json");d.default.existsSync(i)&&n.push({workerId:a,...S("worker-bundle",i,t)})}return{lane:"worker-bundle",status:n.length>0?"configured":"inactive",count:n.length,bundles:n}}function N(t,e,n,a){const i=w(e);if(!i)return a.verbose?{lane:t,status:"inactive",configPath:e}:{lane:t,status:"inactive"};const r={lane:t,status:"configured",...c(i[n])?{version:c(i[n])}:{},...typeof i.enabled=="boolean"?{enabled:i.enabled}:{},...Array.isArray(i.routes)?{routeCount:i.routes.length}:{}};return a.verbose?{...r,configPath:e}:r}function bt(t,e){if(!t){const i={status:"inactive"};return e.verbose?{...i,statusPath:e.watchPath,stopPath:e.stopPath}:i}const n=t.status==="running"&&V(t.pid),a={status:n?"running":t.status==="running"?"stale":t.status,pid:t.pid,attempts:t.attempts,startedAt:t.startedAt,updatedAt:t.updatedAt,...t.finishedAt?{finishedAt:t.finishedAt}:{},...t.status==="running"&&!n?{statusPath:e.watchPath}:{},...t.lastResult&&(t.lastResult.ok===!1||e.verbose)?{lastResult:t.lastResult}:{}};return e.verbose?{...a,statusPath:e.watchPath,stopPath:e.stopPath}:a}function wt(t){const e=(0,R.readCliDaemonIdentity)(t.productStorageRoot);if(!e){const i={status:"unknown"};return t.verbose?{...i,identityPath:t.daemonIdentityPath}:i}const n=z(e,t),a={status:n.status,pid:e.pid,activeInvokeCount:e.activeInvokeCount,runningExecutionCount:e.runningExecutions.length,packageMismatch:n.packageMismatch,updatedAt:e.updatedAt};return t.verbose?{...a,identityPath:t.daemonIdentityPath,daemonId:e.daemonId,startedAt:e.startedAt,heartbeatAt:e.heartbeatAt,invokeProtocol:e.invokeProtocol,supportedModes:e.supportedModes,runningExecutions:e.runningExecutions,cliPath:e.cliPath,packageRoot:e.packageRoot,expectedCliPath:m(t.statusPath)?.active?.cliPath??null}:a}function z(t,e){const n=Date.parse(t.heartbeatAt),a=!Number.isFinite(n)||Date.now()-n>3e4,i=V(t.pid),r=m(e.statusPath)?.active?.cliPath,o=typeof r=="string"&&l.default.resolve(r)!==l.default.resolve(t.cliPath);return t.status==="stopped"?{status:"stopped",packageMismatch:o}:i?a?{status:"stale",packageMismatch:o}:t.activeInvokeCount>0||t.runningExecutions.length>0?{status:"busy",packageMismatch:o}:{status:"idle",packageMismatch:o}:{status:"dead",packageMismatch:o}}function At(t){const e=(0,W.productStorageRoot)(),n=l.default.join(e,"ota"),a=Rt(t),i={action:a,lane:null,verbose:!1,dryRun:!0,keepRecent:2,stagingMaxAgeMs:1440*60*1e3,intervalMs:1e3,timeoutMs:6e4,maxAttempts:60,productStorageRoot:e,statusPath:l.default.join(e,"cli-package","activation-status.json"),pointerPath:l.default.join(e,"cli-package","active-pointer.json"),extensionStatusPath:l.default.join(e,"extension","activation-status.json"),watchPath:l.default.join(n,"watch-status.json"),stopPath:l.default.join(n,"watch-stop.json"),activationLockPath:l.default.join(n,"activation.lock"),daemonIdentityPath:(0,R.cliDaemonIdentityPath)(e)},r=t[0]==="watch"&&t[1]==="stop"?2:1;for(let o=r;o<t.length;o+=1){const s=t[o],v=t[o+1];if(s==="--verbose"||s==="-v"){i.verbose=!0;continue}if(s==="--apply"){i.dryRun=!1;continue}if(s==="--dry-run"){i.dryRun=!0;continue}if(s==="--keep-recent"&&v){i.keepRecent=x(v,i.keepRecent,0,1e3),o+=1;continue}if(s==="--staging-max-age-ms"&&v){i.stagingMaxAgeMs=x(v,i.stagingMaxAgeMs,0,720*60*60*1e3),o+=1;continue}if(a==="status"&&s&&!s.startsWith("-")&&!i.lane){i.lane=s;continue}if(s==="--interval-ms"&&v){i.intervalMs=x(v,i.intervalMs,50,6e4),o+=1;continue}if(s==="--timeout-ms"&&v){i.timeoutMs=x(v,i.timeoutMs,1,1440*60*1e3),o+=1;continue}if(s==="--max-attempts"&&v){i.maxAttempts=x(v,i.maxAttempts,1,1e5),o+=1;continue}}return i}function Rt(t){const e=t[0]??"status";return e==="watch"&&t[1]==="stop"?"stop":e}function x(t,e,n,a){const i=Number.parseInt(t,10);return Number.isFinite(i)?Math.max(n,Math.min(a,i)):e}function m(t){try{const e=JSON.parse(d.default.readFileSync(t,"utf8"));return e&&e.schemaVersion===1?e:null}catch{return null}}function O(t,e){k(t,e)}function C(t){try{const e=JSON.parse(d.default.readFileSync(t,"utf8"));return e&&e.schemaVersion===1?e:null}catch{return null}}function G(t,e){k(t,e)}function b(t){try{const e=JSON.parse(d.default.readFileSync(t,"utf8"));return e&&e.schemaVersion===1?e:null}catch{return null}}function w(t){try{const e=JSON.parse(d.default.readFileSync(t,"utf8"));return h(e)}catch{return null}}function h(t){return t&&typeof t=="object"&&!Array.isArray(t)?t:null}function c(t){return typeof t=="string"&&t.trim()?t:null}function A(t){const e=w(l.default.join(t.productStorageRoot,"control-plane","policy-config.json"));return{killSwitches:Array.isArray(e?.killSwitches)?e.killSwitches.filter(a=>typeof a=="string"):[]}}function It(t){const e=w(l.default.join(t.productStorageRoot,"control-plane","manifest-cache.json"));return c(e?.channel)}function Mt(t,e){const n=F(t),a=F(e),i=Math.max(n.length,a.length);for(let r=0;r<i;r+=1){const o=n[r]??0,s=a[r]??0;if(o!==s)return o>s?1:-1}return t.localeCompare(e)}function F(t){return t.match(/\d+/g)?.map(e=>Number.parseInt(e,10)).filter(e=>Number.isFinite(e))??[]}function jt(t){return(0,J.createHash)("sha256").update(d.default.readFileSync(t)).digest("hex")}function f(t){return t===null||typeof t=="string"||typeof t=="number"||typeof t=="boolean"?t:Array.isArray(t)?t.map(e=>f(e)):t&&typeof t=="object"?Object.fromEntries(Object.entries(t).map(([e,n])=>[e,f(n)])):null}function D(t,e){k(t.watchPath,e)}function k(t,e){d.default.mkdirSync(l.default.dirname(t),{recursive:!0});const n=`${t}.tmp-${process.pid}-${Date.now()}`;d.default.writeFileSync(n,`${JSON.stringify(e,null,2)}
2
- `,"utf8"),d.default.renameSync(n,t)}function V(t){try{return process.kill(t,0),!0}catch{return!1}}function Ot(t){return!!t&&typeof t=="object"&&t.code==="EEXIST"}function Ct(t){return new Promise(e=>setTimeout(e,t))}
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.runOtaCommand = runOtaCommand;
7
+ const node_fs_1 = __importDefault(require("node:fs"));
8
+ const node_path_1 = __importDefault(require("node:path"));
9
+ const daemon_state_1 = require("../session/daemon-state");
10
+ const product_storage_1 = require("../workers/product-storage");
11
+ const SUPPORTED_PRODUCT_STORAGE_SCHEMA = 1;
12
+ const STATUS_LANES = ["cli-package", "worker-bundle", "worker-registry", "launcher-pack", "policy-config", "background-schedule"];
13
+ async function runOtaCommand(args) {
14
+ const options = parseArgs(args);
15
+ if (options.action === "status") {
16
+ return status(options);
17
+ }
18
+ if (options.action === "stop") {
19
+ return stop(options);
20
+ }
21
+ if (options.action === "run-once") {
22
+ return activate(options);
23
+ }
24
+ if (options.action === "rollback") {
25
+ return rollback(options);
26
+ }
27
+ if (options.action === "cleanup") {
28
+ return cleanup(options);
29
+ }
30
+ if (options.action === "watch") {
31
+ return watch(options);
32
+ }
33
+ return { ok: false, command: "ota", error: `Unknown ota action: ${options.action}`, availableActions: ["status", "run-once", "watch", "stop", "rollback", "cleanup"] };
34
+ }
35
+ function status(options) {
36
+ const requested = options.lane ? [options.lane] : [...STATUS_LANES];
37
+ const lanes = {};
38
+ for (const lane of requested) {
39
+ lanes[lane] = summarizeLane(lane, options);
40
+ }
41
+ return {
42
+ ok: true,
43
+ command: "ota",
44
+ action: "status",
45
+ lanes,
46
+ daemon: summarizeDaemon(options),
47
+ watch: summarizeWatch(readJson(options.watchPath), options)
48
+ };
49
+ }
50
+ function summarizeLane(lane, options) {
51
+ if (lane === "cli-package") {
52
+ const value = readStatus(options);
53
+ const blocker = activationBlocker(value, options);
54
+ const summary = {
55
+ lane,
56
+ status: value?.activating ? "activating" : blocker ? "pending-blocked" : value?.pending ? "pending-ready" : value?.active ? "active" : value?.lastError ? "error" : "inactive",
57
+ ...(value?.active?.packageVersion ? { activeVersion: value.active.packageVersion } : {}),
58
+ ...(value?.pending?.packageVersion ? { pendingVersion: value.pending.packageVersion } : {}),
59
+ ...(value?.activating?.packageVersion ? { activatingVersion: value.activating.packageVersion } : {}),
60
+ ...(value?.previous?.packageVersion ? { previousVersion: value.previous.packageVersion } : {}),
61
+ ...(blocker ? { blocker } : {})
62
+ };
63
+ return options.verbose ? { ...summary, statusPath: options.statusPath, activePointerPath: options.pointerPath, value: value ?? null } : summary;
64
+ }
65
+ const mapping = {
66
+ "worker-registry": node_path_1.default.join(options.root, "workers", "activation-status.json"),
67
+ "launcher-pack": node_path_1.default.join(options.root, "launchers", "activation-status.json"),
68
+ "policy-config": node_path_1.default.join(options.root, "control-plane", "policy-config.json"),
69
+ "background-schedule": node_path_1.default.join(options.root, "background", "schedule-config.json")
70
+ };
71
+ if (lane === "worker-bundle") {
72
+ const bundlesRoot = node_path_1.default.join(options.root, "workers", "bundles");
73
+ const workers = node_fs_1.default.existsSync(bundlesRoot)
74
+ ? node_fs_1.default.readdirSync(bundlesRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).sort()
75
+ : [];
76
+ return { lane, status: workers.length > 0 ? "configured" : "inactive", workerCount: workers.length, ...(options.verbose ? { workers } : {}) };
77
+ }
78
+ const statusPath = mapping[lane];
79
+ if (!statusPath) {
80
+ return { lane, status: "unknown", error: `Unknown OTA lane: ${lane}`, availableLanes: [...STATUS_LANES] };
81
+ }
82
+ const value = readJson(statusPath);
83
+ return {
84
+ lane,
85
+ status: value ? "configured" : "inactive",
86
+ ...(typeof value?.configVersion === "string" ? { version: value.configVersion } : {}),
87
+ ...(typeof value?.enabled === "boolean" ? { enabled: value.enabled } : {}),
88
+ ...(Array.isArray(value?.routes) ? { routeCount: value.routes.length } : {}),
89
+ ...(options.verbose ? { statusPath, value: (value ?? null) } : {})
90
+ };
91
+ }
92
+ function activate(options) {
93
+ return withLock(options, () => {
94
+ const current = readStatus(options);
95
+ const blocker = activationBlocker(current, options);
96
+ if (blocker) {
97
+ return { ok: true, command: "ota", action: "run-once", blocked: true, reason: blocker, lane: "cli-package", statusPath: options.statusPath };
98
+ }
99
+ const pending = current?.pending;
100
+ if (!current || !pending) {
101
+ return { ok: true, command: "ota", action: "run-once", skipped: true, reason: "no pending OTA activation" };
102
+ }
103
+ const updatedAt = new Date().toISOString();
104
+ const active = { ...pending, activatedAt: updatedAt };
105
+ delete active.stagedAt;
106
+ delete active.activatingAt;
107
+ delete active.reason;
108
+ const previous = current.active ? { ...current.active, savedAt: updatedAt } : undefined;
109
+ const { pending: _pending, activating: _activating, lastError: _lastError, ...retained } = current;
110
+ const next = {
111
+ ...retained,
112
+ updatedAt,
113
+ activeRoot: active.packageRoot,
114
+ activeCliPath: active.cliPath,
115
+ active,
116
+ ...(previous ? { previous } : {})
117
+ };
118
+ writeStatus(options, next);
119
+ writeJson(options.pointerPath, {
120
+ schemaVersion: 1,
121
+ updatedAt,
122
+ packageVersion: active.packageVersion,
123
+ artifactVersion: active.artifactVersion,
124
+ activeRoot: active.packageRoot,
125
+ activeCliPath: active.cliPath,
126
+ entry: active.entry
127
+ });
128
+ return { ok: true, command: "ota", action: "run-once", activated: true, lanes: ["cli-package"], ...(active.activationGroup?.id ? { activationGroupId: active.activationGroup.id } : {}) };
129
+ });
130
+ }
131
+ function rollback(options) {
132
+ return withLock(options, () => {
133
+ const current = readStatus(options);
134
+ if (!current?.previous) {
135
+ return { ok: true, command: "ota", action: "rollback", skipped: true, reason: "no previous OTA state" };
136
+ }
137
+ const updatedAt = new Date().toISOString();
138
+ const active = { ...current.previous, activatedAt: updatedAt };
139
+ const previous = current.active ? { ...current.active, savedAt: updatedAt } : undefined;
140
+ const next = { ...current, updatedAt, activeRoot: active.packageRoot, activeCliPath: active.cliPath, active, ...(previous ? { previous } : {}) };
141
+ writeStatus(options, next);
142
+ writeJson(options.pointerPath, { schemaVersion: 1, updatedAt, packageVersion: active.packageVersion, artifactVersion: active.artifactVersion, activeRoot: active.packageRoot, activeCliPath: active.cliPath, entry: active.entry });
143
+ return { ok: true, command: "ota", action: "rollback", rolledBack: true, lanes: ["cli-package"], ...(active.activationGroup?.id ? { activationGroupId: active.activationGroup.id } : {}) };
144
+ });
145
+ }
146
+ function cleanup(options) {
147
+ if (policyKillSwitches(options).includes("ota-cleanup")) {
148
+ return { ok: true, command: "ota", action: "cleanup", skipped: true, reason: "OTA cleanup is disabled by policy kill-switch ota-cleanup" };
149
+ }
150
+ const current = readStatus(options);
151
+ const protectedRoots = new Set([current?.active?.packageRoot, current?.previous?.packageRoot, current?.pending?.packageRoot].filter((value) => typeof value === "string").map((value) => node_path_1.default.resolve(value)));
152
+ const candidates = [];
153
+ const versionsRoot = node_path_1.default.join(options.root, "cli-package", "versions");
154
+ if (node_fs_1.default.existsSync(versionsRoot)) {
155
+ const versions = node_fs_1.default.readdirSync(versionsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => {
156
+ const value = node_path_1.default.join(versionsRoot, entry.name);
157
+ return { value, mtimeMs: node_fs_1.default.statSync(value).mtimeMs };
158
+ }).filter((entry) => !protectedRoots.has(node_path_1.default.resolve(entry.value))).sort((left, right) => right.mtimeMs - left.mtimeMs);
159
+ candidates.push(...versions.slice(options.keepRecent).map((entry) => entry.value));
160
+ }
161
+ const packageRoot = node_path_1.default.join(options.root, "cli-package");
162
+ if (node_fs_1.default.existsSync(packageRoot)) {
163
+ const now = Date.now();
164
+ candidates.push(...node_fs_1.default.readdirSync(packageRoot, { withFileTypes: true })
165
+ .filter((entry) => entry.isDirectory() && entry.name.startsWith(".package-staging-"))
166
+ .map((entry) => node_path_1.default.join(packageRoot, entry.name))
167
+ .filter((entry) => now - node_fs_1.default.statSync(entry).mtimeMs >= options.stagingMaxAgeMs));
168
+ }
169
+ const failures = [];
170
+ let removed = 0;
171
+ if (!options.dryRun) {
172
+ for (const candidate of candidates) {
173
+ try {
174
+ node_fs_1.default.rmSync(candidate, { recursive: true, force: true });
175
+ removed += 1;
176
+ }
177
+ catch (error) {
178
+ failures.push({ path: candidate, error: error instanceof Error ? error.message : String(error) });
179
+ }
180
+ }
181
+ }
182
+ return { ok: failures.length === 0, command: "ota", action: "cleanup", dryRun: options.dryRun, candidates: candidates.length, removed, failed: failures.length, byLane: { "cli-package": candidates.length }, ...(failures.length ? { failures } : {}) };
183
+ }
184
+ async function watch(options) {
185
+ if (policyKillSwitches(options).some((item) => item === "ota-watch" || item === "ota-activation")) {
186
+ return { ok: true, command: "ota", action: "watch", skipped: true, blocked: true, reason: "OTA watch is disabled by policy" };
187
+ }
188
+ const existing = readJson(options.watchPath);
189
+ if (existing?.status === "running" && processIsAlive(existing.pid)) {
190
+ return { ok: true, command: "ota", action: "watch", skipped: true, reason: "ota watch is already running", pid: existing.pid };
191
+ }
192
+ node_fs_1.default.rmSync(options.stopPath, { force: true });
193
+ const startedAt = Date.now();
194
+ for (let attempts = 1; attempts <= options.maxAttempts && Date.now() - startedAt <= options.timeoutMs; attempts += 1) {
195
+ writeWatch(options, { schemaVersion: 1, updatedAt: new Date().toISOString(), status: "running", pid: process.pid, startedAt: new Date(startedAt).toISOString(), attempts });
196
+ if (node_fs_1.default.existsSync(options.stopPath)) {
197
+ return finishWatch(options, "stopped", attempts, { ok: true, command: "ota", action: "watch", stopped: true, attempts });
198
+ }
199
+ const result = activate(options);
200
+ if (result.activated === true || result.skipped === true) {
201
+ return finishWatch(options, result.activated === true ? "activated" : "skipped", attempts, result);
202
+ }
203
+ await new Promise((resolve) => setTimeout(resolve, options.intervalMs));
204
+ }
205
+ return finishWatch(options, "timeout", options.maxAttempts, { ok: false, command: "ota", action: "watch", status: "timeout" });
206
+ }
207
+ function stop(options) {
208
+ const current = readJson(options.watchPath);
209
+ const running = current?.status === "running" && processIsAlive(current.pid);
210
+ writeJson(options.stopPath, { schemaVersion: 1, requestedAt: new Date().toISOString(), pid: process.pid, targetPid: running ? current.pid : null });
211
+ return { ok: true, command: "ota", action: "stop", stopped: running, skipped: !running, reason: running ? "stop requested" : "no running ota watch" };
212
+ }
213
+ function finishWatch(options, state, attempts, result) {
214
+ const previous = readJson(options.watchPath);
215
+ writeWatch(options, { schemaVersion: 1, updatedAt: new Date().toISOString(), status: state, pid: process.pid, startedAt: previous?.startedAt ?? new Date().toISOString(), finishedAt: new Date().toISOString(), attempts });
216
+ return { ok: result.ok !== false && state !== "timeout", command: "ota", action: "watch", status: state, attempts, result };
217
+ }
218
+ function activationBlocker(statusValue, options) {
219
+ const pending = statusValue?.pending;
220
+ if (!pending) {
221
+ return null;
222
+ }
223
+ const killSwitches = policyKillSwitches(options);
224
+ if (killSwitches.includes("ota-activation") || killSwitches.includes("cli-package-activation")) {
225
+ return "cli-package activation is disabled by policy";
226
+ }
227
+ if (pending.reason) {
228
+ return pending.reason;
229
+ }
230
+ if (pending.productStorageSchema !== undefined && pending.productStorageSchema > SUPPORTED_PRODUCT_STORAGE_SCHEMA) {
231
+ return `cli-package requires unsupported product storage schema ${pending.productStorageSchema}`;
232
+ }
233
+ if (pending.nonReversibleMigration === true) {
234
+ return "cli-package requires a non-reversible storage migration";
235
+ }
236
+ if (!node_fs_1.default.existsSync(pending.packageRoot) || !node_fs_1.default.existsSync(pending.cliPath)) {
237
+ return "pending cli-package files are missing";
238
+ }
239
+ const active = statusValue?.active;
240
+ if (active && pending.activationGroup?.allowDowngrade !== true) {
241
+ const pendingSequence = pending.activationGroup?.sequence;
242
+ const activeSequence = active.activationGroup?.sequence;
243
+ if (pendingSequence !== undefined && activeSequence !== undefined && pendingSequence <= activeSequence) {
244
+ return `cli-package activation sequence ${pendingSequence} is not newer than active sequence ${activeSequence}`;
245
+ }
246
+ if (pendingSequence === undefined && activeSequence === undefined && compareVersions(pending.packageVersion, active.packageVersion) <= 0) {
247
+ return `cli-package version ${pending.packageVersion} is not newer than active version ${active.packageVersion}`;
248
+ }
249
+ }
250
+ const daemon = (0, daemon_state_1.readCliDaemonIdentity)(options.root);
251
+ if (daemon && processIsAlive(daemon.pid) && (daemon.runningExecutions.length > 0 || daemon.activeInvokeCount > 0)) {
252
+ return daemon.runningExecutions.length > 0
253
+ ? `daemon has running executions: ${daemon.runningExecutions.slice(0, 3).map((item) => item.executionId).join(", ")}`
254
+ : `daemon has ${daemon.activeInvokeCount} active invoke${daemon.activeInvokeCount === 1 ? "" : "s"}`;
255
+ }
256
+ return null;
257
+ }
258
+ function summarizeDaemon(options) {
259
+ const daemon = (0, daemon_state_1.readCliDaemonIdentity)(options.root);
260
+ if (!daemon) {
261
+ return options.verbose ? { status: "unknown", identityPath: (0, daemon_state_1.cliDaemonIdentityPath)(options.root) } : { status: "unknown" };
262
+ }
263
+ const alive = processIsAlive(daemon.pid);
264
+ const busy = daemon.activeInvokeCount > 0 || daemon.runningExecutions.length > 0;
265
+ return { status: !alive ? "dead" : busy ? "busy" : "idle", pid: daemon.pid, activeInvokeCount: daemon.activeInvokeCount, runningExecutionCount: daemon.runningExecutions.length, updatedAt: daemon.updatedAt, ...(options.verbose ? { identityPath: (0, daemon_state_1.cliDaemonIdentityPath)(options.root), cliPath: daemon.cliPath } : {}) };
266
+ }
267
+ function summarizeWatch(value, options) {
268
+ if (!value) {
269
+ return options.verbose ? { status: "inactive", watchPath: options.watchPath } : { status: "inactive" };
270
+ }
271
+ const state = value.status === "running" && !processIsAlive(value.pid) ? "stale" : value.status;
272
+ return { status: state, attempts: value.attempts, ...(state === "running" ? { pid: value.pid } : {}), ...(options.verbose ? { watchPath: options.watchPath, updatedAt: value.updatedAt } : {}) };
273
+ }
274
+ function withLock(options, fn) {
275
+ node_fs_1.default.mkdirSync(node_path_1.default.dirname(options.lockPath), { recursive: true });
276
+ try {
277
+ node_fs_1.default.mkdirSync(options.lockPath);
278
+ }
279
+ catch (error) {
280
+ if (!isFileExists(error)) {
281
+ throw error;
282
+ }
283
+ return { ok: true, command: "ota", action: options.action, blocked: true, reason: "ota activation already locked", lockPath: options.lockPath };
284
+ }
285
+ try {
286
+ return fn();
287
+ }
288
+ finally {
289
+ node_fs_1.default.rmSync(options.lockPath, { recursive: true, force: true });
290
+ }
291
+ }
292
+ function readStatus(options) {
293
+ return readJson(options.statusPath);
294
+ }
295
+ function writeStatus(options, value) {
296
+ writeJson(options.statusPath, { ...value, schemaVersion: 1, statusPath: options.statusPath, activePointerPath: options.pointerPath });
297
+ }
298
+ function writeWatch(options, value) {
299
+ writeJson(options.watchPath, value);
300
+ }
301
+ function policyKillSwitches(options) {
302
+ const value = readJson(node_path_1.default.join(options.root, "control-plane", "policy-config.json"));
303
+ return Array.isArray(value?.killSwitches) ? value.killSwitches.filter((item) => typeof item === "string") : [];
304
+ }
305
+ function readJson(filePath) {
306
+ try {
307
+ return JSON.parse(node_fs_1.default.readFileSync(filePath, "utf8"));
308
+ }
309
+ catch {
310
+ return null;
311
+ }
312
+ }
313
+ function writeJson(filePath, value) {
314
+ node_fs_1.default.mkdirSync(node_path_1.default.dirname(filePath), { recursive: true });
315
+ const temp = `${filePath}.tmp-${process.pid}-${Date.now()}`;
316
+ node_fs_1.default.writeFileSync(temp, `${JSON.stringify(value, null, 2)}\n`, "utf8");
317
+ node_fs_1.default.renameSync(temp, filePath);
318
+ }
319
+ function processIsAlive(pid) {
320
+ try {
321
+ process.kill(pid, 0);
322
+ return true;
323
+ }
324
+ catch {
325
+ return false;
326
+ }
327
+ }
328
+ function compareVersions(left, right) {
329
+ const a = left.split(/[.-]/u).map((part) => Number.parseInt(part, 10));
330
+ const b = right.split(/[.-]/u).map((part) => Number.parseInt(part, 10));
331
+ for (let index = 0; index < Math.max(a.length, b.length); index += 1) {
332
+ const difference = (Number.isFinite(a[index]) ? a[index] : 0) - (Number.isFinite(b[index]) ? b[index] : 0);
333
+ if (difference !== 0) {
334
+ return difference;
335
+ }
336
+ }
337
+ return left.localeCompare(right);
338
+ }
339
+ function isFileExists(error) {
340
+ return error instanceof Error && "code" in error && error.code === "EEXIST";
341
+ }
342
+ function parseArgs(args) {
343
+ const root = (0, product_storage_1.productStorageRoot)();
344
+ const otaRoot = node_path_1.default.join(root, "ota");
345
+ const action = args[0] === "watch" && args[1] === "stop" ? "stop" : args[0] ?? "status";
346
+ const options = {
347
+ action,
348
+ lane: null,
349
+ verbose: false,
350
+ dryRun: true,
351
+ keepRecent: 2,
352
+ stagingMaxAgeMs: 24 * 60 * 60 * 1000,
353
+ intervalMs: 1000,
354
+ timeoutMs: 60_000,
355
+ maxAttempts: 60,
356
+ root,
357
+ statusPath: node_path_1.default.join(root, "cli-package", "activation-status.json"),
358
+ pointerPath: node_path_1.default.join(root, "cli-package", "active-pointer.json"),
359
+ watchPath: node_path_1.default.join(otaRoot, "watch-status.json"),
360
+ stopPath: node_path_1.default.join(otaRoot, "watch-stop.json"),
361
+ lockPath: node_path_1.default.join(otaRoot, "activation.lock")
362
+ };
363
+ const start = args[0] === "watch" && args[1] === "stop" ? 2 : 1;
364
+ for (let index = start; index < args.length; index += 1) {
365
+ const current = args[index];
366
+ const next = args[index + 1];
367
+ if (current === "--verbose" || current === "-v")
368
+ options.verbose = true;
369
+ else if (current === "--apply")
370
+ options.dryRun = false;
371
+ else if (current === "--dry-run")
372
+ options.dryRun = true;
373
+ else if (current === "--keep-recent" && next) {
374
+ options.keepRecent = boundedInt(next, options.keepRecent, 0, 1000);
375
+ index += 1;
376
+ }
377
+ else if (current === "--staging-max-age-ms" && next) {
378
+ options.stagingMaxAgeMs = boundedInt(next, options.stagingMaxAgeMs, 0, 30 * 24 * 60 * 60 * 1000);
379
+ index += 1;
380
+ }
381
+ else if (current === "--interval-ms" && next) {
382
+ options.intervalMs = boundedInt(next, options.intervalMs, 50, 60_000);
383
+ index += 1;
384
+ }
385
+ else if (current === "--timeout-ms" && next) {
386
+ options.timeoutMs = boundedInt(next, options.timeoutMs, 1, 24 * 60 * 60 * 1000);
387
+ index += 1;
388
+ }
389
+ else if (current === "--max-attempts" && next) {
390
+ options.maxAttempts = boundedInt(next, options.maxAttempts, 1, 100_000);
391
+ index += 1;
392
+ }
393
+ else if (action === "status" && current && !current.startsWith("-") && !options.lane)
394
+ options.lane = current;
395
+ else
396
+ throw new Error(`Unknown ota argument: ${current}`);
397
+ }
398
+ return options;
399
+ }
400
+ function boundedInt(value, fallback, min, max) {
401
+ const parsed = Number.parseInt(value, 10);
402
+ return Number.isFinite(parsed) ? Math.max(min, Math.min(max, parsed)) : fallback;
403
+ }
@@ -1 +1,10 @@
1
- "use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.runPrintConfig=a;const n=require("./shared"),o=require("../shared/protocol");async function a(r,t={}){const e=await(0,n.resolveCompatibleTargetInstance)(r,o.CLI_COMMAND_IDS.printConfig,t),c=await(0,n.fetchEffectiveConfig)(e.entry,t);return{ok:!0,selectedInstance:{instanceId:e.entry.instanceId,reason:e.reason,matchedWorkspace:e.matchedWorkspace,port:e.entry.port},config:c}}
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.runPrintConfig = runPrintConfig;
4
+ const resolve_1 = require("../config/resolve");
5
+ async function runPrintConfig(_cwd, _options = {}) {
6
+ return {
7
+ ok: true,
8
+ config: (0, resolve_1.resolveCliConfig)(null)
9
+ };
10
+ }