@automaton-labs/aib 0.0.6 → 0.0.8

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 (586) hide show
  1. package/README.md +36 -257
  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 -2
  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 -0
  19. package/dist/commands/captured-input.js +74 -2
  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 -0
  23. package/dist/commands/declaration-command.js +1209 -0
  24. package/dist/commands/declaration-execution-cache.js +79 -0
  25. package/dist/commands/declaration-format.js +221 -0
  26. package/dist/commands/declaration-preview-cache.js +114 -0
  27. package/dist/commands/diagnostics-command.js +70 -3
  28. package/dist/commands/doctor.js +137 -2
  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 -0
  35. package/dist/commands/file-move-to-dir-preview-cache.js +125 -0
  36. package/dist/commands/file-move-to-dir-worker.js +54 -0
  37. package/dist/commands/file-move-to-dir.js +1073 -0
  38. package/dist/commands/file-mutation-runtime.js +102 -0
  39. package/dist/commands/file-mutation-worker-apply.js +180 -0
  40. package/dist/commands/file-refactor-batch-execution-cache.js +90 -0
  41. package/dist/commands/file-refactor-batch-preview-cache.js +125 -0
  42. package/dist/commands/file-refactor-batch-worker.js +54 -0
  43. package/dist/commands/file-refactor-batch.js +1154 -0
  44. package/dist/commands/file-rename-execution-cache.js +92 -0
  45. package/dist/commands/file-rename-preview-cache.js +125 -0
  46. package/dist/commands/file-rename-worker.js +54 -0
  47. package/dist/commands/file-rename.js +1053 -0
  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 -0
  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 -6
  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 -0
  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 -0
  150. package/dist/dsl/file-move-to-dir-dsl.js +123 -0
  151. package/dist/dsl/file-refactor-batch-dsl.js +203 -0
  152. package/dist/dsl/file-rename-dsl.js +135 -0
  153. package/dist/dsl/mutate-dsl.js +746 -0
  154. package/dist/help/bootstrap.bash.md +742 -0
  155. package/dist/help/bootstrap.md +236 -437
  156. package/dist/help/bootstrap.pwsh.md +742 -0
  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/dsl.md +4 -3
  161. package/dist/help/docs/first-setup.md +6 -5
  162. package/dist/help/docs/help-protocol.md +4 -3
  163. package/dist/help/docs/import.base.md +38 -0
  164. package/dist/help/docs/import.rebase.md +85 -0
  165. package/dist/help/docs/inspect.aliasCandidates.md +39 -0
  166. package/dist/help/docs/inspect.code.md +5 -11
  167. package/dist/help/docs/inspect.deps.md +7 -7
  168. package/dist/help/docs/inspect.file.md +10 -18
  169. package/dist/help/docs/inspect.graph.md +6 -20
  170. package/dist/help/docs/{inspect.md → inspect.shared.md} +18 -17
  171. package/dist/help/docs/modulePlan.md +24 -28
  172. package/dist/help/docs/move.md +19 -22
  173. package/dist/help/docs/moveToDir.md +46 -0
  174. package/dist/help/docs/mutate.mixed.md +34 -0
  175. package/dist/help/docs/mutation.shared.md +55 -0
  176. package/dist/help/docs/patterns.md +3 -16
  177. package/dist/help/docs/qr.md +13 -22
  178. package/dist/help/docs/quick-map.md +36 -23
  179. package/dist/help/docs/recipe.file-layout.md +15 -0
  180. package/dist/help/docs/recipe.import-boundary.md +92 -0
  181. package/dist/help/docs/recipe.safe-artifact-probing.md +68 -0
  182. package/dist/help/docs/recipe.unfamiliar-area.md +64 -0
  183. package/dist/help/docs/recipes.md +20 -0
  184. package/dist/help/docs/rename.md +19 -27
  185. package/dist/help/docs/renameFile.md +36 -0
  186. package/dist/help/docs/rg.md +22 -0
  187. package/dist/help/docs/rules.md +26 -0
  188. package/dist/help/docs/selectors.md +3 -2
  189. package/dist/help/docs/session.md +1 -1
  190. package/dist/help/dsl/bootstrap.bash.md +742 -0
  191. package/dist/help/dsl/bootstrap.md +236 -437
  192. package/dist/help/dsl/bootstrap.pwsh.md +742 -0
  193. package/dist/help/dsl/docs/basics.md +1 -1
  194. package/dist/help/dsl/docs/config-setup.import-normalize.md +65 -65
  195. package/dist/help/dsl/docs/config-setup.import-rules.md +6 -5
  196. package/dist/help/dsl/docs/dsl.md +4 -3
  197. package/dist/help/dsl/docs/first-setup.md +6 -5
  198. package/dist/help/dsl/docs/help-protocol.md +4 -3
  199. package/dist/help/dsl/docs/import.base.md +38 -0
  200. package/dist/help/dsl/docs/import.rebase.md +85 -0
  201. package/dist/help/dsl/docs/inspect.aliasCandidates.md +39 -0
  202. package/dist/help/dsl/docs/inspect.code.md +5 -11
  203. package/dist/help/dsl/docs/inspect.deps.md +7 -7
  204. package/dist/help/dsl/docs/inspect.file.md +10 -18
  205. package/dist/help/dsl/docs/inspect.graph.md +6 -20
  206. package/dist/help/dsl/docs/{inspect.md → inspect.shared.md} +18 -17
  207. package/dist/help/dsl/docs/modulePlan.md +24 -28
  208. package/dist/help/dsl/docs/move.md +19 -22
  209. package/dist/help/dsl/docs/moveToDir.md +46 -0
  210. package/dist/help/dsl/docs/mutate.mixed.md +34 -0
  211. package/dist/help/dsl/docs/mutation.shared.md +55 -0
  212. package/dist/help/dsl/docs/patterns.md +3 -16
  213. package/dist/help/dsl/docs/qr.md +13 -22
  214. package/dist/help/dsl/docs/quick-map.md +36 -23
  215. package/dist/help/dsl/docs/recipe.file-layout.md +15 -0
  216. package/dist/help/dsl/docs/recipe.import-boundary.md +92 -0
  217. package/dist/help/dsl/docs/recipe.safe-artifact-probing.md +68 -0
  218. package/dist/help/dsl/docs/recipe.unfamiliar-area.md +64 -0
  219. package/dist/help/dsl/docs/recipes.md +20 -0
  220. package/dist/help/dsl/docs/rename.md +19 -27
  221. package/dist/help/dsl/docs/renameFile.md +36 -0
  222. package/dist/help/dsl/docs/rg.md +22 -0
  223. package/dist/help/dsl/docs/rules.md +26 -0
  224. package/dist/help/dsl/docs/selectors.md +3 -2
  225. package/dist/help/dsl/docs/session.md +1 -1
  226. package/dist/help/dsl/full.md +236 -437
  227. package/dist/help/dsl/help-index.md +49 -0
  228. package/dist/help/dsl/snippets/agents.md +2 -2
  229. package/dist/help/dsl/tokens/qr.inline.examples.md +2 -0
  230. package/dist/help/dsl/tokens/stdin.examples.bash.md +8 -0
  231. package/dist/help/dsl/tokens/stdin.examples.pwsh.md +8 -0
  232. package/dist/help/dsl/tokens/stdin.examples.with-qr.bash.md +12 -0
  233. package/dist/help/dsl/tokens/stdin.examples.with-qr.pwsh.md +12 -0
  234. package/dist/help/dsl/topics/basics.md +1 -1
  235. package/dist/help/dsl/topics/config-setup.import-normalize.md +65 -65
  236. package/dist/help/dsl/topics/config-setup.import-rules.md +6 -5
  237. package/dist/help/dsl/topics/dsl.md +4 -3
  238. package/dist/help/dsl/topics/first-setup.md +6 -5
  239. package/dist/help/dsl/topics/help-protocol.md +4 -3
  240. package/dist/help/dsl/topics/import.base.md +36 -0
  241. package/dist/help/dsl/topics/import.rebase.md +83 -0
  242. package/dist/help/dsl/topics/inspect.aliasCandidates.md +37 -0
  243. package/dist/help/dsl/topics/inspect.code.md +5 -11
  244. package/dist/help/dsl/topics/inspect.deps.md +7 -7
  245. package/dist/help/dsl/topics/inspect.file.md +10 -18
  246. package/dist/help/dsl/topics/inspect.graph.md +6 -20
  247. package/dist/help/dsl/topics/{inspect.md → inspect.shared.md} +18 -17
  248. package/dist/help/dsl/topics/modulePlan.md +21 -26
  249. package/dist/help/dsl/topics/move.md +17 -18
  250. package/dist/help/dsl/topics/moveToDir.md +44 -0
  251. package/dist/help/dsl/topics/mutate.mixed.md +32 -0
  252. package/dist/help/dsl/topics/mutation.shared.md +53 -0
  253. package/dist/help/dsl/topics/patterns.md +3 -16
  254. package/dist/help/dsl/topics/qr.md +13 -22
  255. package/dist/help/dsl/topics/quick-map.md +36 -23
  256. package/dist/help/dsl/topics/recipe.file-layout.md +13 -0
  257. package/dist/help/dsl/topics/recipe.import-boundary.md +90 -0
  258. package/dist/help/dsl/topics/recipe.safe-artifact-probing.md +66 -0
  259. package/dist/help/dsl/topics/recipe.unfamiliar-area.md +62 -0
  260. package/dist/help/dsl/topics/recipes.md +18 -0
  261. package/dist/help/dsl/topics/rename.md +15 -15
  262. package/dist/help/dsl/topics/renameFile.md +34 -0
  263. package/dist/help/dsl/topics/rg.md +20 -0
  264. package/dist/help/dsl/topics/rules.md +24 -0
  265. package/dist/help/dsl/topics/selectors.md +3 -2
  266. package/dist/help/dsl/topics/session.md +1 -1
  267. package/dist/help/full.md +236 -437
  268. package/dist/help/help-index.md +49 -0
  269. package/dist/help/help-meta.json +114 -48
  270. package/dist/help/index.md +76 -87
  271. package/dist/help/snippets/agents.md +2 -2
  272. package/dist/help/tokens/qr.inline.examples.md +2 -0
  273. package/dist/help/tokens/stdin.examples.bash.md +8 -0
  274. package/dist/help/tokens/stdin.examples.pwsh.md +8 -0
  275. package/dist/help/tokens/stdin.examples.with-qr.bash.md +12 -0
  276. package/dist/help/tokens/stdin.examples.with-qr.pwsh.md +12 -0
  277. package/dist/help/topics/basics.md +1 -1
  278. package/dist/help/topics/config-setup.import-normalize.md +65 -65
  279. package/dist/help/topics/config-setup.import-rules.md +6 -5
  280. package/dist/help/topics/dsl.md +4 -3
  281. package/dist/help/topics/first-setup.md +6 -5
  282. package/dist/help/topics/help-protocol.md +4 -3
  283. package/dist/help/topics/import.base.md +36 -0
  284. package/dist/help/topics/import.rebase.md +83 -0
  285. package/dist/help/topics/inspect.aliasCandidates.md +37 -0
  286. package/dist/help/topics/inspect.code.md +5 -11
  287. package/dist/help/topics/inspect.deps.md +7 -7
  288. package/dist/help/topics/inspect.file.md +10 -18
  289. package/dist/help/topics/inspect.graph.md +6 -20
  290. package/dist/help/topics/{inspect.md → inspect.shared.md} +18 -17
  291. package/dist/help/topics/modulePlan.md +21 -26
  292. package/dist/help/topics/move.md +17 -18
  293. package/dist/help/topics/moveToDir.md +44 -0
  294. package/dist/help/topics/mutate.mixed.md +32 -0
  295. package/dist/help/topics/mutation.shared.md +53 -0
  296. package/dist/help/topics/patterns.md +3 -16
  297. package/dist/help/topics/qr.md +13 -22
  298. package/dist/help/topics/quick-map.md +36 -23
  299. package/dist/help/topics/recipe.file-layout.md +13 -0
  300. package/dist/help/topics/recipe.import-boundary.md +90 -0
  301. package/dist/help/topics/recipe.safe-artifact-probing.md +66 -0
  302. package/dist/help/topics/recipe.unfamiliar-area.md +62 -0
  303. package/dist/help/topics/recipes.md +18 -0
  304. package/dist/help/topics/rename.md +15 -15
  305. package/dist/help/topics/renameFile.md +34 -0
  306. package/dist/help/topics/rg.md +20 -0
  307. package/dist/help/topics/rules.md +24 -0
  308. package/dist/help/topics/selectors.md +3 -2
  309. package/dist/help/topics/session.md +1 -1
  310. package/dist/host/capabilities.js +56 -0
  311. package/dist/imports/standalone-import-analysis.js +602 -0
  312. package/dist/imports/standalone-import-model.js +2 -0
  313. package/dist/imports/standalone-import-process.js +66 -0
  314. package/dist/imports/standalone-import-worker.js +27 -0
  315. package/dist/imports/standalone-ts-project.js +147 -0
  316. package/dist/inspect/inspect-duplicates-service.js +526 -0
  317. package/dist/inspect/inspect-reverse-module-closure.js +338 -0
  318. package/dist/inspect/inspect-source-ranges.js +82 -0
  319. package/dist/inspect/inspect-source-shape.js +649 -0
  320. package/dist/inspect/standalone-inspect-analysis.js +319 -0
  321. package/dist/inspect/standalone-inspect-model.js +9 -0
  322. package/dist/inspect/standalone-inspect-process.js +55 -0
  323. package/dist/inspect/standalone-inspect-usages.js +274 -0
  324. package/dist/inspect/standalone-inspect-worker.js +13 -0
  325. package/dist/metrics/central-metrics.js +101 -2
  326. package/dist/mutation/concrete-edit-plan.js +157 -0
  327. package/dist/mutation/exports-star-collapse-preview.js +361 -0
  328. package/dist/mutation/exports-star-expand-apply.js +373 -0
  329. package/dist/mutation/exports-star-expand-preview.js +807 -0
  330. package/dist/mutation/file-impact-scan.js +182 -0
  331. package/dist/mutation/file-mutation-discovery.js +674 -0
  332. package/dist/mutation/file-mutation-eta.js +99 -0
  333. package/dist/mutation/file-mutation-standalone-apply.js +584 -0
  334. package/dist/mutation/file-mutation-standalone-planner.js +500 -0
  335. package/dist/mutation/file-mutation-tsserver-session.js +473 -0
  336. package/dist/mutation/mutation-estimate.js +45 -0
  337. package/dist/mutation/mutation-plan.js +467 -0
  338. package/dist/mutation/object-mutation-foundation.js +2 -0
  339. package/dist/mutation/object-mutation-partition.js +148 -0
  340. package/dist/mutation/object-pack-semantic-apply.js +507 -0
  341. package/dist/mutation/object-pack-semantic-preview.js +984 -0
  342. package/dist/mutation/object-unpack-semantic-preview.js +993 -0
  343. package/dist/mutation/package-manifest-impact.js +176 -0
  344. package/dist/mutation/rename-owner-worker-child.js +37 -0
  345. package/dist/mutation/rename-owner-worker.js +122 -0
  346. package/dist/mutation/runtime-cycle-query.js +66 -0
  347. package/dist/mutation/semantic-execution-progress.js +63 -0
  348. package/dist/mutation/semantic-export-index.js +474 -0
  349. package/dist/mutation/semantic-impact-scan.js +434 -0
  350. package/dist/mutation/semantic-model.js +2 -0
  351. package/dist/mutation/semantic-move-best-effort-planner.js +209 -0
  352. package/dist/mutation/semantic-move-config-worker-child.js +61 -0
  353. package/dist/mutation/semantic-move-config-worker.js +449 -0
  354. package/dist/mutation/semantic-move-declarations.js +94 -0
  355. package/dist/mutation/semantic-move-metrics.js +119 -0
  356. package/dist/mutation/semantic-move-model.js +2 -0
  357. package/dist/mutation/semantic-move-owner-authority.js +122 -0
  358. package/dist/mutation/semantic-move-owner-candidates.js +300 -0
  359. package/dist/mutation/semantic-move-owner-divergence-harness.js +474 -0
  360. package/dist/mutation/semantic-move-owner-divergence-runner.js +162 -0
  361. package/dist/mutation/semantic-move-plan-hash.js +56 -0
  362. package/dist/mutation/semantic-move-policy.js +360 -0
  363. package/dist/mutation/semantic-move-process.js +218 -0
  364. package/dist/mutation/semantic-move-provider-diagnostics.js +27 -0
  365. package/dist/mutation/semantic-move-standalone-engine.js +919 -0
  366. package/dist/mutation/semantic-move-standalone-planner.js +1553 -0
  367. package/dist/mutation/semantic-move-transaction.js +639 -0
  368. package/dist/mutation/semantic-mutation-engine.js +478 -0
  369. package/dist/mutation/semantic-mutation-runtime.js +521 -0
  370. package/dist/mutation/semantic-planner-retry.js +26 -0
  371. package/dist/mutation/semantic-program-roots.js +69 -0
  372. package/dist/mutation/semantic-rename-commonjs.js +229 -0
  373. package/dist/mutation/semantic-rename-config-worker-child.js +46 -0
  374. package/dist/mutation/semantic-rename-config-worker.js +498 -0
  375. package/dist/mutation/semantic-rename-locations.js +192 -0
  376. package/dist/mutation/semantic-rename-model.js +2 -0
  377. package/dist/mutation/semantic-rename-process.js +210 -0
  378. package/dist/mutation/semantic-rename-standalone-engine.js +302 -0
  379. package/dist/mutation/semantic-rename-standalone-planner.js +567 -0
  380. package/dist/mutation/semantic-rename-transaction.js +333 -0
  381. package/dist/mutation/semantic-unused-import-cleanup.js +248 -0
  382. package/dist/mutation/semantic-worker-retry.js +40 -0
  383. package/dist/mutation/semantic-workspace.js +804 -0
  384. package/dist/mutation/targeted-import-canonicalizer.js +359 -0
  385. package/dist/observability/config.js +206 -1
  386. package/dist/observability/context.js +59 -1
  387. package/dist/observability/failure-snapshot.js +124 -2
  388. package/dist/observability/recent.js +63 -2
  389. package/dist/payloads/read-stdin-json.js +212 -1
  390. package/dist/rg-wrapper/core.js +714 -0
  391. package/dist/rg-wrapper/options.js +125 -0
  392. package/dist/rtk-wrapper/core.js +144 -0
  393. package/dist/rtk-wrapper/git-safety.js +203 -0
  394. package/dist/rtk-wrapper/output-adapter.js +106 -0
  395. package/dist/runtime/buffered-process.js +114 -0
  396. package/dist/runtime/bundled-node.js +97 -1
  397. package/dist/runtime/command-lifecycle.js +2 -0
  398. package/dist/runtime/input-source.js +238 -1
  399. package/dist/runtime/node-cli-identity.js +37 -0
  400. package/dist/runtime/run-command.js +191 -1
  401. package/dist/selectors/parse-entities.js +84 -1
  402. package/dist/semantic/semantic-context-pool.js +830 -0
  403. package/dist/semantic/semantic-context-provider.js +416 -0
  404. package/dist/semantic/semantic-resident-admission.js +38 -0
  405. package/dist/semantic/semantic-worker-child.js +40 -0
  406. package/dist/semantic/semantic-worker-manager.js +460 -0
  407. package/dist/semantic/semantic-worker-protocol.js +2 -0
  408. package/dist/semantic/semantic-worker-runtime.js +38 -0
  409. package/dist/semantic/workspace-semantic-context-pools.js +136 -0
  410. package/dist/session/client.js +359 -1
  411. package/dist/session/daemon-state.js +185 -0
  412. package/dist/session/external-tool-coordinator.js +88 -0
  413. package/dist/session/external-tool-request.js +52 -0
  414. package/dist/session/lane-owner.js +116 -0
  415. package/dist/session/paths.js +71 -1
  416. package/dist/session/runtime-lifecycle.js +225 -0
  417. package/dist/session/runtime-shutdown.js +95 -0
  418. package/dist/session/server.js +1194 -8
  419. package/dist/session/session-health.js +27 -0
  420. package/dist/shared/agent-text.js +29 -1
  421. package/dist/shared/errors.js +496 -30
  422. package/dist/shared/event-loop.js +6 -1
  423. package/dist/shared/hints.js +37 -1
  424. package/dist/shared/metrics.js +43 -1
  425. package/dist/shared/presentation.js +69 -4
  426. package/dist/shared/stdin-examples.js +77 -3
  427. package/dist/shared/stdout.js +6 -2
  428. package/dist/shared/types.js +23 -1
  429. package/dist/tool-runtime/runtime-tools.js +120 -0
  430. package/dist/topology/availability.js +663 -0
  431. package/dist/topology/cache.js +130 -0
  432. package/dist/topology/candidates.js +372 -0
  433. package/dist/topology/core.js +903 -0
  434. package/dist/topology/dependency-snapshot.js +189 -0
  435. package/dist/topology/model.js +2 -0
  436. package/dist/topology/scope.js +100 -0
  437. package/dist/topology/ts-oracle-batch.js +529 -0
  438. package/dist/topology/ts-oracle-host.js +69 -0
  439. package/dist/topology/ts-oracle-model.js +2 -0
  440. package/dist/topology/ts-oracle.js +224 -0
  441. package/dist/topology/tsconfig-loader.js +105 -0
  442. package/dist/topology/workspace-project-index.js +542 -0
  443. package/dist/tracing/config.js +192 -2
  444. package/dist/tracing/failure-summary.js +100 -0
  445. package/dist/tracing/trace.js +318 -5
  446. package/dist/tsc-wrapper/core.js +697 -0
  447. package/dist/workers/control-plane/aib-control-plane-worker.cjs +80 -0
  448. package/dist/workers/control-plane/client-config.default.json +3 -0
  449. package/dist/workers/lexical-worker-child.js +27 -0
  450. package/dist/workers/lexical-worker-manager.js +394 -0
  451. package/dist/workers/lexical-worker-protocol.js +2 -0
  452. package/dist/workers/lexical-worker-runtime.js +25 -0
  453. package/dist/workers/owned-one-shot-process.js +115 -0
  454. package/dist/workers/product-storage.js +23 -0
  455. package/dist/workers/registry.js +241 -0
  456. package/package.json +8 -11
  457. package/runtimes/tools/rg/darwin-arm64/rg +0 -0
  458. package/runtimes/tools/rg/darwin-x64/rg +0 -0
  459. package/runtimes/tools/rg/linux-arm64/rg +0 -0
  460. package/runtimes/tools/rg/linux-x64/rg +0 -0
  461. package/runtimes/tools/rg/manifest.json +36 -0
  462. package/runtimes/tools/rg/win32-x64/rg.exe +0 -0
  463. package/runtimes/tools/rtk/darwin-arm64/rtk +0 -0
  464. package/runtimes/tools/rtk/darwin-x64/rtk +0 -0
  465. package/runtimes/tools/rtk/linux-arm64/rtk +0 -0
  466. package/runtimes/tools/rtk/linux-x64/rtk +0 -0
  467. package/runtimes/tools/rtk/manifest.json +36 -0
  468. package/runtimes/tools/rtk/win32-x64/rtk.exe +0 -0
  469. package/scripts/postinstall.cjs +29 -29
  470. package/scripts/provision-runtime.cjs +411 -459
  471. package/dist/client/http-client.js +0 -1
  472. package/dist/client/transport-options.js +0 -1
  473. package/dist/client/websocket-client.js +0 -1
  474. package/dist/commands/entity-resolution.js +0 -1
  475. package/dist/commands/inspect-symbol-query.js +0 -1
  476. package/dist/commands/list-instances.js +0 -1
  477. package/dist/commands/module-plan-command.js +0 -1
  478. package/dist/commands/move-command.js +0 -1
  479. package/dist/commands/move-to-file.js +0 -2
  480. package/dist/commands/ping.js +0 -1
  481. package/dist/commands/refactor-command.js +0 -1
  482. package/dist/commands/rename-command.js +0 -1
  483. package/dist/commands/runtime-command.js +0 -4
  484. package/dist/commands/runtime-info.js +0 -1
  485. package/dist/commands/validate-module-plan.js +0 -2
  486. package/dist/compatibility/policy.js +0 -1
  487. package/dist/config/auto-start-ide.js +0 -1
  488. package/dist/discovery/registry.js +0 -1
  489. package/dist/discovery/select-instance.js +0 -1
  490. package/dist/help/docs/mutation.md +0 -50
  491. package/dist/help/docs/refactor.batch.md +0 -44
  492. package/dist/help/dsl/docs/mutation.md +0 -50
  493. package/dist/help/dsl/docs/refactor.batch.md +0 -44
  494. package/dist/help/dsl/topics/mutation.md +0 -48
  495. package/dist/help/dsl/topics/refactor.batch.md +0 -33
  496. package/dist/help/json/bootstrap.md +0 -1085
  497. package/dist/help/json/docs/basics.md +0 -15
  498. package/dist/help/json/docs/config-setup.aliases.md +0 -56
  499. package/dist/help/json/docs/config-setup.excludes.md +0 -45
  500. package/dist/help/json/docs/config-setup.import-normalize.md +0 -86
  501. package/dist/help/json/docs/config-setup.import-rules.md +0 -96
  502. package/dist/help/json/docs/config-setup.tsconfigs.md +0 -33
  503. package/dist/help/json/docs/dsl.md +0 -25
  504. package/dist/help/json/docs/first-setup.md +0 -292
  505. package/dist/help/json/docs/help-format.md +0 -9
  506. package/dist/help/json/docs/help-protocol.md +0 -26
  507. package/dist/help/json/docs/imports.normalize.md +0 -47
  508. package/dist/help/json/docs/inspect.code.md +0 -41
  509. package/dist/help/json/docs/inspect.cycles.md +0 -38
  510. package/dist/help/json/docs/inspect.deps.md +0 -46
  511. package/dist/help/json/docs/inspect.duplicates.md +0 -65
  512. package/dist/help/json/docs/inspect.exports.md +0 -40
  513. package/dist/help/json/docs/inspect.file.md +0 -38
  514. package/dist/help/json/docs/inspect.graph.md +0 -139
  515. package/dist/help/json/docs/inspect.imports.md +0 -15
  516. package/dist/help/json/docs/inspect.md +0 -88
  517. package/dist/help/json/docs/inspect.members.md +0 -32
  518. package/dist/help/json/docs/inspect.tree.md +0 -32
  519. package/dist/help/json/docs/inspect.usages.md +0 -61
  520. package/dist/help/json/docs/modulePlan.md +0 -73
  521. package/dist/help/json/docs/move.md +0 -56
  522. package/dist/help/json/docs/mutation.md +0 -65
  523. package/dist/help/json/docs/patterns.md +0 -76
  524. package/dist/help/json/docs/prefs.md +0 -40
  525. package/dist/help/json/docs/qr.md +0 -37
  526. package/dist/help/json/docs/quick-map.md +0 -30
  527. package/dist/help/json/docs/refactor.batch.md +0 -72
  528. package/dist/help/json/docs/rename.md +0 -47
  529. package/dist/help/json/docs/reveal.md +0 -30
  530. package/dist/help/json/docs/selectors.md +0 -23
  531. package/dist/help/json/docs/session.md +0 -77
  532. package/dist/help/json/docs/view.md +0 -30
  533. package/dist/help/json/full.md +0 -1085
  534. package/dist/help/json/snippets/agents.md +0 -14
  535. package/dist/help/json/topics/basics.md +0 -13
  536. package/dist/help/json/topics/config-setup.aliases.md +0 -54
  537. package/dist/help/json/topics/config-setup.excludes.md +0 -43
  538. package/dist/help/json/topics/config-setup.import-normalize.md +0 -84
  539. package/dist/help/json/topics/config-setup.import-rules.md +0 -94
  540. package/dist/help/json/topics/config-setup.tsconfigs.md +0 -31
  541. package/dist/help/json/topics/dsl.md +0 -23
  542. package/dist/help/json/topics/first-setup.md +0 -290
  543. package/dist/help/json/topics/help-format.md +0 -7
  544. package/dist/help/json/topics/help-protocol.md +0 -24
  545. package/dist/help/json/topics/imports.normalize.md +0 -45
  546. package/dist/help/json/topics/inspect.code.md +0 -39
  547. package/dist/help/json/topics/inspect.cycles.md +0 -36
  548. package/dist/help/json/topics/inspect.deps.md +0 -44
  549. package/dist/help/json/topics/inspect.duplicates.md +0 -37
  550. package/dist/help/json/topics/inspect.exports.md +0 -38
  551. package/dist/help/json/topics/inspect.file.md +0 -36
  552. package/dist/help/json/topics/inspect.graph.md +0 -137
  553. package/dist/help/json/topics/inspect.imports.md +0 -13
  554. package/dist/help/json/topics/inspect.md +0 -86
  555. package/dist/help/json/topics/inspect.members.md +0 -30
  556. package/dist/help/json/topics/inspect.tree.md +0 -22
  557. package/dist/help/json/topics/inspect.usages.md +0 -59
  558. package/dist/help/json/topics/modulePlan.md +0 -60
  559. package/dist/help/json/topics/move.md +0 -46
  560. package/dist/help/json/topics/mutation.md +0 -63
  561. package/dist/help/json/topics/patterns.md +0 -74
  562. package/dist/help/json/topics/prefs.md +0 -38
  563. package/dist/help/json/topics/qr.md +0 -35
  564. package/dist/help/json/topics/quick-map.md +0 -28
  565. package/dist/help/json/topics/refactor.batch.md +0 -61
  566. package/dist/help/json/topics/rename.md +0 -42
  567. package/dist/help/json/topics/reveal.md +0 -28
  568. package/dist/help/json/topics/selectors.md +0 -21
  569. package/dist/help/json/topics/session.md +0 -59
  570. package/dist/help/json/topics/view.md +0 -28
  571. package/dist/help/topics/mutation.md +0 -48
  572. package/dist/help/topics/refactor.batch.md +0 -33
  573. package/dist/ide-launch/common.cjs +0 -162
  574. package/dist/managed-host/extension-vsix-resolver.js +0 -1
  575. package/dist/managed-host/manage-serve-web-host.cjs +0 -141
  576. package/dist/managed-host/serve-web-autostart.js +0 -1
  577. package/dist/managed-host/serve-web-host.cjs +0 -1904
  578. package/dist/runtime/managed-runtime-provisioning.js +0 -1
  579. package/dist/shared/diagnostic-catalog.js +0 -1
  580. package/dist/shared/diagnostics.js +0 -1
  581. package/dist/shared/operations.js +0 -1
  582. package/dist/shared/protocol.js +0 -1
  583. package/dist/shared/routes.js +0 -1
  584. package/extension/vscode-refactor-bridge-extension.vsix +0 -0
  585. package/runtimes/launcher/linux-x64/aib +0 -0
  586. 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
+ }
@@ -0,0 +1,403 @@
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
+ }