@mrclrchtr/supi-code-intelligence 11.4.0 → 13.0.0

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 (330) hide show
  1. package/CHANGELOG.md +39 -0
  2. package/README.md +17 -9
  3. package/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  4. package/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +1 -0
  5. package/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +51 -23
  6. package/node_modules/@mrclrchtr/supi-core/package.json +3 -1
  7. package/node_modules/@mrclrchtr/supi-core/src/api.ts +4 -0
  8. package/node_modules/@mrclrchtr/supi-core/src/context/context-tag.ts +1 -1
  9. package/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +22 -3
  10. package/node_modules/@mrclrchtr/supi-core/src/retired-packages.ts +152 -0
  11. package/node_modules/@mrclrchtr/supi-core/src/session.ts +1 -0
  12. package/node_modules/@mrclrchtr/supi-core/src/shell-hints.ts +46 -0
  13. package/node_modules/@mrclrchtr/supi-core/src/spill.ts +93 -0
  14. package/node_modules/@mrclrchtr/supi-lsp/README.md +21 -16
  15. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  16. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +1 -0
  17. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +51 -23
  18. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +3 -1
  19. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/api.ts +4 -0
  20. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/context/context-tag.ts +1 -1
  21. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +22 -3
  22. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/retired-packages.ts +152 -0
  23. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/session.ts +1 -0
  24. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/shell-hints.ts +46 -0
  25. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/spill.ts +93 -0
  26. package/node_modules/@mrclrchtr/supi-lsp/package.json +8 -8
  27. package/node_modules/@mrclrchtr/supi-lsp/src/api.ts +3 -2
  28. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-cache.ts +102 -47
  29. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-capabilities.ts +13 -3
  30. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-host.ts +8 -0
  31. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-refresh.ts +15 -1
  32. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-request.ts +1 -1
  33. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostics.ts +71 -13
  34. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-disk-stamp.ts +60 -0
  35. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-state.ts +3 -0
  36. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-sync.ts +28 -6
  37. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-edit-capture.ts +258 -0
  38. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-file-state.ts +17 -3
  39. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-semantic-input-barrier.ts +53 -4
  40. package/node_modules/@mrclrchtr/supi-lsp/src/client/client.ts +75 -14
  41. package/node_modules/@mrclrchtr/supi-lsp/src/config/capabilities.ts +8 -0
  42. package/node_modules/@mrclrchtr/supi-lsp/src/config/operation-support.ts +48 -79
  43. package/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-extends.ts +2 -1
  44. package/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-path.ts +2 -2
  45. package/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-scope.ts +14 -5
  46. package/node_modules/@mrclrchtr/supi-lsp/src/config/typescript-module.ts +17 -0
  47. package/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/evidence.ts +42 -0
  48. package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-client-state.ts +2 -17
  49. package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-removal-ledger.ts +52 -0
  50. package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +43 -21
  51. package/node_modules/@mrclrchtr/supi-lsp/src/manager/typescript-file-local.ts +6 -1
  52. package/node_modules/@mrclrchtr/supi-lsp/src/provider/lsp-refactor-provider.ts +21 -35
  53. package/node_modules/@mrclrchtr/supi-lsp/src/provider/lsp-semantic-provider.ts +6 -1
  54. package/node_modules/@mrclrchtr/supi-lsp/src/provider/refactor-command-capture.ts +139 -0
  55. package/node_modules/@mrclrchtr/supi-lsp/src/provider/refactor-planning.ts +202 -47
  56. package/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-symbol-mapper.ts +13 -3
  57. package/node_modules/@mrclrchtr/supi-lsp/src/session/route-boundary.ts +26 -0
  58. package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostic-surface.ts +11 -0
  59. package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostics.ts +1 -0
  60. package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +74 -14
  61. package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-rename.ts +3 -0
  62. package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-transition-debug.ts +11 -1
  63. package/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +24 -1
  64. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  65. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +1 -0
  66. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +51 -23
  67. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +3 -1
  68. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/api.ts +4 -0
  69. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/context/context-tag.ts +1 -1
  70. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +22 -3
  71. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/retired-packages.ts +152 -0
  72. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/session.ts +1 -0
  73. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/shell-hints.ts +46 -0
  74. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/spill.ts +93 -0
  75. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.cjs +50 -75
  76. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.cjs.map +2 -2
  77. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.js +50 -75
  78. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.js.map +2 -2
  79. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.wasm +0 -0
  80. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.wasm.map +6 -6
  81. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/package.json +1 -1
  82. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.cjs +50 -75
  83. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.cjs.map +2 -2
  84. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.cts +7 -7
  85. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.cts.map +1 -1
  86. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.ts +7 -7
  87. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.ts.map +1 -1
  88. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.js +50 -75
  89. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.js.map +2 -2
  90. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.wasm +0 -0
  91. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.wasm.map +5 -5
  92. package/node_modules/@mrclrchtr/supi-tree-sitter/package.json +5 -5
  93. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/kotlin/tree-sitter-kotlin.wasm.json +1 -1
  94. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/latex/tree-sitter-latex.wasm.json +1 -1
  95. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/sql/tree-sitter-sql.wasm.json +1 -1
  96. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/tsx/tree-sitter-tsx.wasm.json +1 -1
  97. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/typescript/tree-sitter-typescript.wasm.json +1 -1
  98. package/node_modules/@mrclrchtr/supi-tree-sitter/src/coordinates.ts +16 -2
  99. package/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-client.ts +4 -3
  100. package/node_modules/@mrclrchtr/supi-tree-sitter/src/syntax-errors.ts +2 -0
  101. package/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/call-range.ts +94 -0
  102. package/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/call-sites.ts +26 -6
  103. package/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/callees.ts +6 -3
  104. package/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/exports.ts +13 -4
  105. package/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime.ts +1 -9
  106. package/node_modules/fast-xml-parser/CHANGELOG.md +886 -0
  107. package/node_modules/fast-xml-parser/LICENSE +21 -0
  108. package/node_modules/fast-xml-parser/README.md +204 -0
  109. package/node_modules/fast-xml-parser/lib/fxbuilder.min.js +2 -0
  110. package/node_modules/fast-xml-parser/lib/fxbuilder.min.js.map +1 -0
  111. package/node_modules/fast-xml-parser/lib/fxp.cjs +1 -0
  112. package/node_modules/fast-xml-parser/lib/fxp.d.cts +774 -0
  113. package/node_modules/fast-xml-parser/lib/fxp.min.js +2 -0
  114. package/node_modules/fast-xml-parser/lib/fxp.min.js.map +1 -0
  115. package/node_modules/fast-xml-parser/lib/fxparser.min.js +2 -0
  116. package/node_modules/fast-xml-parser/lib/fxparser.min.js.map +1 -0
  117. package/node_modules/fast-xml-parser/lib/fxvalidator.min.js +2 -0
  118. package/node_modules/fast-xml-parser/lib/fxvalidator.min.js.map +1 -0
  119. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/README.md +92 -0
  120. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/package.json +57 -0
  121. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/EntityDecoder.js +644 -0
  122. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/EntityEncoder.js +239 -0
  123. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/all-entities.js +53 -0
  124. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/entities.js +1139 -0
  125. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/entityTries.js +60 -0
  126. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/index.d.ts +358 -0
  127. package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/index.js +29 -0
  128. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/CHANGELOG.md +52 -0
  129. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/LICENSE +21 -0
  130. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/README.md +77 -0
  131. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/lib/fxb.cjs +1 -0
  132. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/lib/fxb.d.cts +270 -0
  133. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/lib/fxb.min.js +2 -0
  134. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/lib/fxb.min.js.map +1 -0
  135. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/package.json +77 -0
  136. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/fxb.d.ts +270 -0
  137. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/fxb.js +609 -0
  138. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/ignoreAttributes.js +18 -0
  139. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/orderedJs2Xml.js +360 -0
  140. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/prettifyJs2Xml.js +0 -0
  141. package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/util.js +23 -0
  142. package/node_modules/fast-xml-parser/node_modules/is-unsafe/LICENSE +21 -0
  143. package/node_modules/fast-xml-parser/node_modules/is-unsafe/README.md +632 -0
  144. package/node_modules/fast-xml-parser/node_modules/is-unsafe/package.json +56 -0
  145. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/html.js +102 -0
  146. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/log.js +98 -0
  147. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/nosql.js +114 -0
  148. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/redos.js +60 -0
  149. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/shell.js +105 -0
  150. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/sql-strict.js +47 -0
  151. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/sql.js +95 -0
  152. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/svg.js +81 -0
  153. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/xml.js +79 -0
  154. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/index.cjs +27 -0
  155. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/index.d.ts +103 -0
  156. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/index.js +292 -0
  157. package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/util/decode-entities.js +48 -0
  158. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/LICENSE +21 -0
  159. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/README.md +947 -0
  160. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/lib/pem.cjs +1 -0
  161. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/lib/pem.d.cts +725 -0
  162. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/lib/pem.min.js +2 -0
  163. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/lib/pem.min.js.map +1 -0
  164. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/package.json +79 -0
  165. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/Expression.js +232 -0
  166. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/ExpressionSet.js +225 -0
  167. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/Matcher.js +663 -0
  168. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/index.d.ts +589 -0
  169. package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/index.js +30 -0
  170. package/node_modules/fast-xml-parser/node_modules/strnum/CHANGELOG.md +63 -0
  171. package/node_modules/fast-xml-parser/node_modules/strnum/LICENSE +21 -0
  172. package/node_modules/fast-xml-parser/node_modules/strnum/README.md +113 -0
  173. package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/LICENSE +21 -0
  174. package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/README.md +142 -0
  175. package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/anynum.js +135 -0
  176. package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/digitTable.js +116 -0
  177. package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/package.json +42 -0
  178. package/node_modules/fast-xml-parser/node_modules/strnum/package.json +36 -0
  179. package/node_modules/fast-xml-parser/node_modules/strnum/strnum.js +176 -0
  180. package/node_modules/fast-xml-parser/node_modules/xml-naming/LICENSE +21 -0
  181. package/node_modules/fast-xml-parser/node_modules/xml-naming/README.md +287 -0
  182. package/node_modules/fast-xml-parser/node_modules/xml-naming/package.json +56 -0
  183. package/node_modules/fast-xml-parser/node_modules/xml-naming/src/index.d.ts +108 -0
  184. package/node_modules/fast-xml-parser/node_modules/xml-naming/src/index.js +382 -0
  185. package/node_modules/fast-xml-parser/package.json +93 -0
  186. package/node_modules/fast-xml-parser/src/cli/cli.js +97 -0
  187. package/node_modules/fast-xml-parser/src/cli/man.js +17 -0
  188. package/node_modules/fast-xml-parser/src/cli/read.js +43 -0
  189. package/node_modules/fast-xml-parser/src/fxp.d.ts +754 -0
  190. package/node_modules/fast-xml-parser/src/fxp.js +14 -0
  191. package/node_modules/fast-xml-parser/src/ignoreAttributes.js +18 -0
  192. package/node_modules/fast-xml-parser/src/util.js +61 -0
  193. package/node_modules/fast-xml-parser/src/v6/CharsSymbol.js +16 -0
  194. package/node_modules/fast-xml-parser/src/v6/EntitiesParser.js +106 -0
  195. package/node_modules/fast-xml-parser/src/v6/OptionsBuilder.js +61 -0
  196. package/node_modules/fast-xml-parser/src/v6/OutputBuilders/BaseOutputBuilder.js +69 -0
  197. package/node_modules/fast-xml-parser/src/v6/OutputBuilders/JsArrBuilder.js +103 -0
  198. package/node_modules/fast-xml-parser/src/v6/OutputBuilders/JsMinArrBuilder.js +100 -0
  199. package/node_modules/fast-xml-parser/src/v6/OutputBuilders/JsObjBuilder.js +154 -0
  200. package/node_modules/fast-xml-parser/src/v6/OutputBuilders/ParserOptionsBuilder.js +94 -0
  201. package/node_modules/fast-xml-parser/src/v6/Report.js +0 -0
  202. package/node_modules/fast-xml-parser/src/v6/TagPath.js +81 -0
  203. package/node_modules/fast-xml-parser/src/v6/TagPathMatcher.js +13 -0
  204. package/node_modules/fast-xml-parser/src/v6/XMLParser.js +83 -0
  205. package/node_modules/fast-xml-parser/src/v6/Xml2JsParser.js +235 -0
  206. package/node_modules/fast-xml-parser/src/v6/XmlPartReader.js +210 -0
  207. package/node_modules/fast-xml-parser/src/v6/XmlSpecialTagsReader.js +111 -0
  208. package/node_modules/fast-xml-parser/src/v6/inputSource/BufferSource.js +116 -0
  209. package/node_modules/fast-xml-parser/src/v6/inputSource/StringSource.js +121 -0
  210. package/node_modules/fast-xml-parser/src/v6/valueParsers/EntitiesParser.js +105 -0
  211. package/node_modules/fast-xml-parser/src/v6/valueParsers/booleanParser.js +22 -0
  212. package/node_modules/fast-xml-parser/src/v6/valueParsers/booleanParserExt.js +19 -0
  213. package/node_modules/fast-xml-parser/src/v6/valueParsers/currency.js +38 -0
  214. package/node_modules/fast-xml-parser/src/v6/valueParsers/join.js +13 -0
  215. package/node_modules/fast-xml-parser/src/v6/valueParsers/number.js +14 -0
  216. package/node_modules/fast-xml-parser/src/v6/valueParsers/trim.js +6 -0
  217. package/node_modules/fast-xml-parser/src/validator.js +518 -0
  218. package/node_modules/fast-xml-parser/src/xmlbuilder/json2xml.js +6 -0
  219. package/node_modules/fast-xml-parser/src/xmlparser/DocTypeReader.js +426 -0
  220. package/node_modules/fast-xml-parser/src/xmlparser/OptionsBuilder.js +164 -0
  221. package/node_modules/fast-xml-parser/src/xmlparser/OrderedObjParser.js +907 -0
  222. package/node_modules/fast-xml-parser/src/xmlparser/XMLParser.js +77 -0
  223. package/node_modules/fast-xml-parser/src/xmlparser/node2json.js +177 -0
  224. package/node_modules/fast-xml-parser/src/xmlparser/xmlNode.js +54 -0
  225. package/package.json +10 -8
  226. package/src/analysis/evidence.ts +331 -73
  227. package/src/analysis/health/diagnostics.ts +66 -18
  228. package/src/analysis/health/evidence-reason.ts +44 -0
  229. package/src/analysis/health/server-status.ts +41 -12
  230. package/src/analysis/search/pattern.ts +3 -3
  231. package/src/analysis/target/anchored-structural.ts +4 -1
  232. package/src/analysis/target/anchored.ts +3 -6
  233. package/src/analysis/target/symbol.ts +42 -48
  234. package/src/analysis/target/types.ts +4 -9
  235. package/src/analysis/workspace/cmake-parser.ts +207 -0
  236. package/src/analysis/workspace/cmake.ts +141 -0
  237. package/src/analysis/workspace/maven.ts +310 -0
  238. package/src/analysis/workspace/membership.ts +100 -26
  239. package/src/analysis/workspace/metadata.ts +6 -1
  240. package/src/analysis/workspace/observe.ts +6 -0
  241. package/src/analysis/workspace/types.ts +11 -3
  242. package/src/diagnostics/coverage.ts +49 -0
  243. package/src/diagnostics/evidence.ts +10 -2
  244. package/src/session/find-types.ts +8 -4
  245. package/src/session/find-workflow.ts +11 -16
  246. package/src/session/health-workflow.ts +6 -0
  247. package/src/session/input/common.ts +1 -1
  248. package/src/session/input/health-refactor.ts +48 -34
  249. package/src/session/input/workflows.ts +45 -46
  250. package/src/session/inspect/file-point.ts +2 -2
  251. package/src/session/inspect-types.ts +1 -1
  252. package/src/session/inspect-workflow.ts +3 -3
  253. package/src/session/orientation/collect.ts +42 -7
  254. package/src/session/orientation/context-facts.ts +3 -3
  255. package/src/session/orientation/context-sections.ts +13 -15
  256. package/src/session/orientation/facts.ts +5 -8
  257. package/src/session/orientation-workflow.ts +4 -19
  258. package/src/session/refactor-file-actions.ts +122 -0
  259. package/src/session/refactor-plan-pipeline.ts +152 -0
  260. package/src/session/refactor-plans.ts +18 -15
  261. package/src/session/refactor-types.ts +24 -12
  262. package/src/session/refactor-workflow.ts +68 -243
  263. package/src/session/target-workflow.ts +25 -18
  264. package/src/tool/code_find/execute.ts +6 -7
  265. package/src/tool/code_find/result.ts +5 -7
  266. package/src/tool/code_find/spec.ts +9 -16
  267. package/src/tool/code_find/tui.ts +12 -6
  268. package/src/tool/code_graph/display.ts +5 -6
  269. package/src/tool/code_graph/format.ts +8 -24
  270. package/src/tool/code_graph/result.ts +16 -75
  271. package/src/tool/code_graph/section.ts +21 -33
  272. package/src/tool/code_graph/spec.ts +6 -0
  273. package/src/tool/code_graph/tui.ts +10 -5
  274. package/src/tool/code_health/diagnostic-tui.ts +49 -0
  275. package/src/tool/code_health/guidance.ts +27 -0
  276. package/src/tool/code_health/markdown.ts +60 -8
  277. package/src/tool/code_health/result.ts +20 -9
  278. package/src/tool/code_health/spec.ts +6 -0
  279. package/src/tool/code_health/structured-schema.ts +18 -4
  280. package/src/tool/code_health/structured.ts +22 -18
  281. package/src/tool/code_health/tui.ts +33 -40
  282. package/src/tool/code_inspect/execute.ts +1 -1
  283. package/src/tool/code_inspect/markdown.ts +33 -6
  284. package/src/tool/code_inspect/result.ts +24 -19
  285. package/src/tool/code_inspect/spec.ts +14 -6
  286. package/src/tool/code_inspect/structured.ts +4 -21
  287. package/src/tool/code_inspect/tui.ts +2 -2
  288. package/src/tool/code_orientation/result.ts +53 -100
  289. package/src/tool/code_orientation/spec.ts +8 -0
  290. package/src/tool/code_orientation/structured-schema.ts +16 -12
  291. package/src/tool/code_orientation/structured-workspace.ts +13 -7
  292. package/src/tool/code_orientation/structured.ts +31 -39
  293. package/src/tool/code_orientation/workspace-format.ts +4 -10
  294. package/src/tool/code_orientation/workspace-instructions.ts +4 -5
  295. package/src/tool/code_orientation/workspace-observations.ts +2 -2
  296. package/src/tool/code_orientation/workspace-output.ts +16 -7
  297. package/src/tool/code_orientation/workspace-projects.ts +7 -10
  298. package/src/tool/code_orientation/workspace-sections.ts +13 -19
  299. package/src/tool/code_refactor_apply/result.ts +2 -1
  300. package/src/tool/code_refactor_apply/spec.ts +7 -0
  301. package/src/tool/code_refactor_plan/execute.ts +0 -2
  302. package/src/tool/code_refactor_plan/result.ts +23 -13
  303. package/src/tool/code_refactor_plan/spec.ts +8 -2
  304. package/src/tool/code_refactor_plan/structured.ts +59 -12
  305. package/src/tool/code_refactor_plan/tui.ts +14 -17
  306. package/src/tool/code_resolve/markdown.ts +5 -47
  307. package/src/tool/code_resolve/result.ts +43 -72
  308. package/src/tool/code_resolve/spec.ts +6 -0
  309. package/src/tool/infra/truncate.ts +2 -16
  310. package/src/tool/namespace.ts +14 -0
  311. package/src/tool/refactor-markdown.ts +55 -15
  312. package/src/tool/register.ts +3 -0
  313. package/src/tool/result/candidate-selection.ts +141 -0
  314. package/src/tool/result/display.ts +41 -45
  315. package/src/tool/result/errors.ts +1 -0
  316. package/src/tool/result/model-budget.ts +26 -1
  317. package/src/tool/result/refactor-preview.ts +118 -0
  318. package/src/tool/result/refactor-unavailable.ts +16 -0
  319. package/src/tool/result/refactor.ts +19 -10
  320. package/src/tool/result/structured.ts +2 -1
  321. package/src/tool/result/types.ts +9 -8
  322. package/src/tool/schemas.ts +76 -38
  323. package/src/tool/specs.ts +3 -0
  324. package/src/ui/footer.ts +2 -4
  325. package/src/ui/status-overlay.ts +1 -1
  326. package/src/ui/status-presentation.ts +4 -7
  327. package/src/ui/tui/candidate-selection.ts +40 -95
  328. package/src/ui/tui/common.ts +16 -70
  329. package/src/ui/tui/display.ts +6 -24
  330. package/src/tool/result/candidate-row.ts +0 -49
package/CHANGELOG.md CHANGED
@@ -1,5 +1,44 @@
1
1
  # Changelog
2
2
 
3
+ ## [13.0.0]
4
+
5
+ - **Breaking:** every `code_*` evidence list in structured details now carries `completeness`: `complete`, `capped`, `partial`, or `unbounded`. Scripts can read it directly instead of inferring completeness from a null `totalCount`. `code_orientation` source lists and context definitions replace `collectedCount`/`omittedCount` with one `evidence` list. Expanded TUI sections report rows hidden by the 20-row view separately (for example `25 of 30; 5 omitted; 5 rows hidden in view`), instead of adding them to the evidence omission count. Structured TUI chrome from sessions saved before this change falls back to the markdown output on resume.
6
+ - `code_graph`, `code_resolve`, and `code_orientation` report ambiguous targets and symbol-kind mismatches the same way: a `# Multiple targets match` or ``# No target matched provider kind `X` `` heading, one handle-first row per candidate with its container (``- `handle` — **name** (`kind`) in `Container` at `file`:line:col``), and a closing recovery sentence. All three set `details.status` to `disambiguation`, so the TUI shows "Choose a target". Previously `code_graph` reported a kind mismatch as invalid input, and `code_orientation` reported both cases as completed. Structured output schemas are unchanged.
7
+ - Workspace Overview and workspace/directory `code_orientation` now list Maven projects from `pom.xml` (model versions 4.0.0 and 4.1.0) as `maven-project`, identified by `project.artifactId`, and show `modules`/`subprojects` aggregation as `maven-modules` memberships. Parent inheritance is never treated as membership. The POM is read statically: Maven is not run, and properties, parents, and profiles are not resolved. Interpolated, profile-scoped, out-of-root, and unmatched module paths are reported as limitations ([#534](https://github.com/mrclrchtr/supi/issues/534)).
8
+ - Workspace Overview and workspace/directory `code_orientation` now list CMake projects (`cmake-project`) from `CMakeLists.txt` files that contain exactly one top-level `project()` call with a literal name. Repeated calls, calls inside conditions, functions, or macros, and variable-based names are disclosed instead of guessed. Targets and `add_subdirectory()` are not reported, and CMake is never run ([#535](https://github.com/mrclrchtr/supi/issues/535)).
9
+ - `code_health` no longer reports a clean result when no source diagnostics were checked. With zero requested files it says `No source diagnostics checked (0 tracked files).` and suggests an exact-file `refresh: true` check or the project's own typecheck. A clean result now names the confirmed file count and scope, and a snapshot with removed files is reported as incomplete. Removed files also make the diagnostic observation `partial` instead of `completed`, with a limitation that names them and suggests another `refresh: true` run, so `kind: "completed"` never appears beside `coverage: "incomplete"` ([#602](https://github.com/mrclrchtr/supi/issues/602)). A tracked-file snapshot read without `refresh: true` notes that it reflects the last LSP synchronization and may miss edits made outside Pi. Structured output adds `diagnostics.coverage` (`unavailable`, `none`, `incomplete`, or `confirmed`), using the same classification as the `/supi-ci-status` inspector ([#465](https://github.com/mrclrchtr/supi/issues/465)).
10
+ - `code_health` now reports a deleted tracked file as `removed` regardless of when the deletion happened. Previously the removal was lost if a passive read or a server-requested background diagnostic refresh ran first, typically within about half a second, and the next `refresh: true` call reported a clean result. A passive call (without `refresh`) also shows the removal but keeps it, and the next `refresh: true` call reports it once. Recreated files are no longer reported as removed ([#606](https://github.com/mrclrchtr/supi/issues/606)).
11
+ - A passive `code_health` tracked-file snapshot (without `refresh: true`) no longer reports a file as `confirmed` after it changed on disk outside Pi, for example through bash, an editor, or git. The snapshot compares each file's disk metadata with its last diagnosed read; a changed file is `unconfirmed`, the observation is `partial`, and the limitation names the file and suggests `refresh: true`. Its earlier diagnostics stay listed as possibly stale. A refresh or any later semantic request re-reads the file and restores `confirmed`, without a document change when only the metadata changed. Structured evidence documents add an optional `reason: "disk-changed"`. Edits that affect other files through imports are still not detected passively ([#599](https://github.com/mrclrchtr/supi/issues/599)).
12
+ - The collapsed `code_health` line no longer emits an empty styled span after section counts, so `tui_render` `marked` output reads `[success][bold]3[/bold][/success]` without a trailing `[muted][/muted]`.
13
+ - Truncation wording is the same in markdown, candidate lists, graph summaries, and TUI headers. For example, provider-limited candidate searches now read `1 candidate; 1 collected omitted; more may exist — provider-limited; <reason>` instead of a separate "Search completeness is unknown" sentence.
14
+ - `code_orientation` snapshots and truncated `code_*` output files are now written to one private per-user directory, `$TMPDIR/supi-<uid>/`, instead of a new `supi-*` directory per call. Identical content reuses one file, so repeated Workspace Overviews of an unchanged workspace share one snapshot; captures no longer record the per-call collection deadline. SuPi never deletes these files; the OS temp purge does ([#597](https://github.com/mrclrchtr/supi/issues/597)).
15
+ - Symbol name anchors from document symbols are computed against the text synchronized to the language server instead of the file on disk, so `code_resolve` and file outlines no longer point at the wrong column after unsaved or concurrent edits ([#594](https://github.com/mrclrchtr/supi/issues/594)).
16
+ - `code_graph` no longer drops TUI sections and evidence lines when a provider-limited relation list also excluded invalid provider locations.
17
+ - Starting Code Intelligence is about 100 ms faster: the TypeScript compiler API is loaded only when a tsconfig question is asked.
18
+ - `code_*` tool schemas are shorter (repeated position and default descriptions removed), so every request sends less prompt text. Call shapes and validation are unchanged.
19
+
20
+ ## [12.0.0]
21
+
22
+ - **Breaking:** `code_find` takes one `search` selector instead of flat `query`, `mode`, and `kind`: `search: { ast: { kind, query } }` or `search: { semantic: { query } }`. A semantic search can no longer carry an AST kind. `scope` is renamed to `scopes`, because it takes a list; `code_resolve` and `code_health` keep the single-path `scope`. Migration: `{ query, mode: "ast", kind, scope }` becomes `{ search: { ast: { kind, query } }, scopes }`.
23
+ - **Breaking:** `code_inspect` takes `anchor` instead of `point`, the same `{ file, line, character }` name the other `code_*` tools use. The result reports the inspected location as `anchor` too, so `inspect.anchor` can be passed straight to another tool's `target.anchor`.
24
+ - `code_inspect` no longer sends a stray `~optional` keyword in its `maxResults` schema.
25
+ - `code_inspect` shows at most the first 12 lines (1,200 characters) of the syntax node's text and names the line range to read for the rest. Previously an anchor on a blank line or leading whitespace selected the file's root node and printed the whole file. Codemode results still carry the full text.
26
+ - Codemode now lists the `code_*` tools under a `code` namespace heading, so scripts can find them with `describeNamespace("code")` or `searchTools(query, { namespace: "code" })`. `describeNamespace` also returns the recommended call order. Every `code_*` tool now declares audited `readOnlyHint`, `destructiveHint`, `idempotentHint`, and `openWorldHint` annotations, which permission extensions can read from `pi.getAllTools()`. Only `code_refactor_apply` is marked destructive. `code_orientation` is marked open-world because consented Gradle observation can reach the network ([#582](https://github.com/mrclrchtr/supi/issues/582)).
27
+ - `code_refactor_plan` now previews code actions that only run a server command, such as kotlin-lsp extract variable and organize imports. SuPi runs the one selected command, captures the edit the server pushes, refuses it so no file changes, and stores it as the plan; the plan shows where its edit came from. This also works with clangd tweaks such as "Extract subexpression to variable", which report an error after their edit is refused. When a command pushes no edit, the reason notes there may be nothing to change. Only refactor, organize-imports, and fix-all commands run ([#584](https://github.com/mrclrchtr/supi/issues/584)).
28
+ - **Breaking:** `code_refactor_plan` takes only `operation`, and each operation names its own scope: `rename_symbol: { target, newName }`, `code_action: { file, range, kind, title? }` for server refactors such as `refactor.extract` (a range whose start equals its end marks a cursor position; positions outside the file are rejected before the server is asked), and `source_action: { file, kind, title? }` for whole-file actions such as `source.organizeImports`. Files outside the routed language server's project root are refused before the server is asked. Import cleanup and unused-code removal no longer need a symbol anchor. Extraction now works where the server returns exact edits (for example gopls, rust-analyzer, and jdtls); the preview shows the server's generated name, which `rename_symbol` can change afterwards. When several matching actions produce different edits, the result lists each action's kind and title to pass back as `title`. Migration: move `target` into `rename_symbol`, replace `update_imports` with `source_action` kind `source.organizeImports`, `delete_dead_code` with kind `source.removeUnused` or `source.removeUnusedImports`, and `extract_function`/`extract_variable` with `code_action` kind `refactor.extract` ([#583](https://github.com/mrclrchtr/supi/issues/583)).
29
+ - Kotlin local variables and parameters can be targeted by anchor (for example for `rename_symbol` after an extraction) when kotlin-lsp lists no document symbol for them. Previously the structural fallback recognized only `identifier` name tokens, not Kotlin's `simple_identifier`, and reported "No symbol target resolved".
30
+ - `code_refactor_plan` previews combine several edits on one line into one before/after entry, such as `- total` / `+ sumDoubled`, instead of showing the fragments a server like kotlin-lsp returns (`sumD`, `ub`, `ed`). The stored plan and the reported edit counts are unchanged, and the shown edits never stop in the middle of such a line.
31
+ - When a refactor plan or apply fails because a file changed while it ran (for example a plan running in parallel with an apply), the error now ends with "Retry after concurrent edits finish."
32
+ - `code_health` operation support lists `code_action` and `source_action` with the `refactor*` and `source*` kinds each server advertises, instead of fixed import, dead-code, and extraction entries. Servers that advertise the empty kind or no kind list, such as rust-analyzer, are marked as possibly returning unlisted kinds.
33
+ - An explicit `code_health` refresh that runs while a crashed language server is being replaced no longer makes the replacement fail. Previously, the request waiting on that replacement got no server and the recovery was recorded as cancelled, even though the new server was running.
34
+ - C and C++ headers mapped to another language by `code-intelligence.fileAssociations` (for example `**/*.h` as `cpp`) now use the language server's own diagnostics when the server registers them for that language. Previously, these headers were matched against the default C language, so the server's diagnostics for C++ never applied to them, and C-only diagnostics could be requested for files opened as C++.
35
+ - `code_health` server details are shorter. Operations with the same limit are listed together, so the extraction explanation appears once instead of once per operation, and operations a server does not support show only "server unsupported". Previously, every server, including bash and html, repeated a long typescript-language-server explanation twice.
36
+ - Cancelling a structural request, or reaching its deadline, no longer restarts the structural Worker. Previously every cancellation waited for the hard-stop timeout and discarded cached parse trees, so the next AST request parsed again from scratch.
37
+ - AST results for large files are much faster: converting node positions re-split the whole file for every node, which made extraction slow down quadratically with file size. On an 8,000-line TypeScript file, call-site extraction dropped from about 10 s to 0.3 s, and outline and export extraction from several seconds to under 0.2 s, so these requests no longer hit their deadlines on large files.
38
+ - Export extraction for JavaScript and TypeScript is more accurate: `export default "foo"` is reported as a default export instead of `export * from "foo"`, every name in `export var a, b` is listed, and `export import X = Y.Z` is listed as an `alias` export.
39
+ - In files containing a carriage return that is not part of a CRLF line ending (for example inside a template literal), AST positions after that character are correct again. Previously later lines were shifted, so ranges were truncated and some valid `code_inspect` positions were rejected as beyond the end of the line.
40
+ - Call ranges for Java, Kotlin, and Ruby now cover only the called expression (such as `a.b` in `a.b(1)`), as in other languages, instead of the whole call with its arguments and block. A Kotlin call with a trailing lambda, such as `bar(1) { it }`, is now reported once instead of twice in call search and `code_graph` callees.
41
+
3
42
  ## [11.4.0]
4
43
 
5
44
  - `code_orientation` with a directory focus no longer embeds an instruction file (such as `CLAUDE.md`) that the agent already read in full with `read` since the latest compaction. Reads with `offset` or `limit`, truncated reads, and failed reads do not count. In observed sessions, about a quarter of embedded instruction text repeated a file the agent had just read.
package/README.md CHANGED
@@ -59,7 +59,7 @@ The full extension registers all eight tools at startup; it does not load them o
59
59
  | `code_resolve` | Resolve a real symbol anchor or semantic query to target handles, or list a file's declarations |
60
60
  | `code_inspect` | Inspect syntax, the enclosing declaration, hover information, definitions, and nearby diagnostics at one point |
61
61
  | `code_graph` | Find semantic references and implementations, or structural calls from the enclosing scope |
62
- | `code_find` | Search with an explicit `ast` or `semantic` mode |
62
+ | `code_find` | Search with exactly one `search` mode: `ast: { kind, query }` or `semantic: { query }` |
63
63
  | `code_health` | Report diagnostic observations and language-server health |
64
64
  | `code_refactor_plan` | Store a semantic refactor preview without changing files |
65
65
  | `code_refactor_apply` | Apply a fresh stored plan after file and edit checks |
@@ -70,7 +70,7 @@ Example tool calls:
70
70
 
71
71
  ```javascript
72
72
  code_orientation({ focus: { path: "packages/api" } })
73
- code_find({ query: "PaymentProvider", mode: "semantic", scope: ["packages/api"] })
73
+ code_find({ search: { semantic: { query: "PaymentProvider" } }, scopes: ["packages/api"] })
74
74
  code_health({ scope: "packages/api/src/index.ts", refresh: true })
75
75
  ```
76
76
 
@@ -90,12 +90,12 @@ All eight tools declare native output schemas and return JSON-serializable `stru
90
90
  | Tool | Native data |
91
91
  |---|---|
92
92
  | Resolve | `targets` with reusable `handle` values, candidate selection, and evidence counts |
93
- | Inspect | `point`, independently completed/partial/unavailable `sections` with `data`, recovery, bounded definitions/diagnostics, provenance, and next queries |
93
+ | Inspect | `anchor`, independently completed/partial/unavailable `sections` with `data`, recovery, bounded definitions/diagnostics, provenance, and next queries |
94
94
  | Orientation | `focusKind`, named section `facts`, selected `workspace` inventories/declarations/relationships and Gradle observations when applicable, instructions, limitations, and optional captured `snapshot` |
95
95
  | Graph | Per-relation `sections` with bounded `items` and evidence |
96
96
  | Find | Bounded `matches`; AST scan policy, exclusions, limitations, and failures |
97
97
  | Health | Requested `includedSections` and `level`, actual `diagnostics` with scope and confirmation evidence, all collected `servers`, workspace inventory scope, capability state, warnings, and separate `refresh` outcomes |
98
- | Refactor Plan | `planId`, operation, safe target facts, every exact edit in `edits`, file/edit counts, provenance, and `nextAction` |
98
+ | Refactor Plan | `planId`, operation, `file`, rename `target` or action `range`, the selected `action` kind and title, every exact edit in `edits`, file/edit counts, provenance, and `nextAction`; ambiguous results list candidate kinds and titles |
99
99
  | Refactor Apply | Explicit `kind: "applied"`, changed `files` with per-file counts, and total file/edit counts |
100
100
 
101
101
  Check `kind` before consuming evidence. Invalid input and candidate selection remain corrective returned outcomes; real execution/capability failures and cancellation throw. Internal providers, target records, fingerprints, mutation authority, and session state are not exposed. Apply recovery consumes original document identities in `details.data.recoveryFiles`, independently of display paths and script data.
@@ -110,7 +110,7 @@ Semantic exclusion examples distinguish the original `observedPath` rejected by
110
110
 
111
111
  Orientation groups equivalent syntax-recovery warnings by source, reason, and error ranges, listing all affected operations once. Native recovery facts retain every per-operation observation; distinct warnings remain separate.
112
112
 
113
- Source points, target positions, Inspect source coordinates, and Orientation source-item coordinates use one-based lines and UTF-16 columns. Refactor edit ranges and Orientation provider ranges (hover, definitions, diagnostics), like syntax-recovery ranges, use zero-based lines and UTF-16 columns; range ends are exclusive. Health messages use one-based lines.
113
+ Source points, target positions, `code_action` ranges, Inspect source coordinates, and Orientation source-item coordinates use one-based lines and UTF-16 columns. Refactor edit ranges and Orientation provider ranges (hover, definitions, diagnostics), like syntax-recovery ranges, use zero-based lines and UTF-16 columns; range ends are exclusive. Health messages use one-based lines.
114
114
 
115
115
  Registered-tool tests validate results against the registered output schemas and JSON round-tripping; Pi does not validate output schemas at runtime. Separate deterministic integration tests execute all five migrated tools through Pi's real default codemode route, including fixture mutation by Apply. These tests use controlled providers, not live language-server qualification.
116
116
 
@@ -134,8 +134,10 @@ Automatic collection stays within the session working directory. Ancestor Git ro
134
134
  - Git inventories contain tracked and non-ignored untracked files. Tracked files remain eligible when ignore rules match them. Configured exclusions still apply.
135
135
  - Without Git, collection uses accessible files and configured exclusions. Directory names do not determine project roles or generated-file status.
136
136
  - Symbolic links are recorded, not followed. An explicit ignored or excluded directory can be observed separately. This does not change automatic inclusion elsewhere.
137
- - Metadata readers cover Node `package.json` and workspace declarations, Python `[project]` in `pyproject.toml`, Rust `Cargo.toml`, and Go `go.mod` / `go.work`. They do not run build tools or project code.
138
- - Unsupported, dynamic, inherited, malformed, and unresolved declarations are disclosed. Go replacement directives and unsupported quoted-string escapes are not interpreted. Native project kinds remain separate; nearby Python or Rust projects do not become Node workspace members.
137
+ - Metadata readers cover Node `package.json` and workspace declarations, Python `[project]` in `pyproject.toml`, Rust `Cargo.toml`, Go `go.mod` / `go.work`, Maven `pom.xml`, and CMake `project()` in `CMakeLists.txt`. They do not run build tools or project code.
138
+ - Maven `pom.xml` reading is static and supports model versions 4.0.0 and 4.1.0. Identity is the literal `project.artifactId`; groupId/version coordinates, the display `<name>`, dependencies, and plugins are not reported. Aggregation comes only from `project.modules.module` (4.0.0) or `project.subprojects.subproject` (4.1.0), matched as exact paths relative to the aggregator directory; a trailing `pom.xml` names its directory. `<parent>` inheritance never establishes membership. Property interpolation (`${…}`), custom XML entities, profile-scoped modules, out-of-root paths, and unmatched modules are disclosed, not resolved. Parent resolution, profile activation, and Maven 4 implicit subproject discovery are not modeled.
139
+ - A CMake project is reported only for exactly one top-level `project()` call with a literal name; its literal `DESCRIPTION` is kept. Repeated calls, calls inside control blocks, functions, or macros, and names that use variables or generator expressions are disclosed instead of selected. `CMakeLists.txt` files without `project()`, targets, `add_subdirectory()`, included files, presets, and configured build trees are not observed. The CMake File API and configure/build steps are not used.
140
+ - Unsupported, dynamic, inherited, malformed, and unresolved declarations are disclosed. Go replacement directives and unsupported quoted-string escapes are not interpreted. Native project kinds remain separate; nearby Python, Rust, Maven, or CMake projects do not become Node workspace members, and Maven modules match only `pom.xml` projects.
139
141
  - Project declaration groups share their observed kind and project-relative identity source. Identical membership declarations share their native kind, source field, and value. List limits and omission counts still apply to individual declarations and memberships, not groups. A membership group refers to listed projects only when their identities match exactly; otherwise it lists member paths.
140
142
  - Explicit directory results keep project identity, direct directories/files, the focused project's declared paths (manifest entry points), applicable instructions, and collection problems inline. Without `maxResults`, direct files are listed in full as one compact line, until the navigation budget applies the default cap. Complete ancillary sections (extension counts, nested declarations, memberships, and dependency topology) move to captured details, named in one note. Incomplete ancillary observations remain inline. Root-focused Orientation also keeps project declarations and memberships inline for workspace navigation.
141
143
  - Captured directory diagrams retain separate dependency categories and declared values. Unique declared-name matches do not prove installed dependency resolution or runtime architecture.
@@ -166,9 +168,15 @@ Candidate selection for Graph, Resolve, and Orientation uses one structured tran
166
168
 
167
169
  ### Refactor checks
168
170
 
169
- The planner accepts one target handle or anchor and one operation: `rename_symbol`, `extract_function`, `extract_variable`, `update_imports`, or `delete_dead_code`. Rename, import updates, and dead-code removal depend on the language server and validated edits. Function and variable extraction are currently unavailable for all languages: standard LSP code actions do not provide a safe exact extraction-name contract. Unsupported operations do not fall back to text edits.
171
+ The planner accepts exactly one operation, each with its own scope:
170
172
 
171
- `delete_dead_code` accepts precise `source.removeUnused` or `source.removeUnusedImports` actions (including dotted descendants), not title-based guesses or `source.fixAll`. Native TypeScript 7 is qualified for unused-import removal only; it does not imply removal of arbitrary unused declarations or TLS/native parity. An imports-only advertisement appears as limited SuPi support with the reason in `code_health`. Different matching edit plans remain ambiguous rather than selecting an action automatically.
173
+ | Operation | Input | Server request |
174
+ |---|---|---|
175
+ | `rename_symbol` | `target` (handle or name anchor) and `newName` | `textDocument/rename` |
176
+ | `code_action` | `file`, one-based `range` (equal `start` and `end` mark a cursor position), `kind` under `refactor` (for example `refactor.extract`), optional `title` | Code actions for the range |
177
+ | `source_action` | `file`, `kind` under `source` (for example `source.organizeImports`), optional `title` | Code actions for the whole file |
178
+
179
+ Files outside the routed language server's project root are refused before any request, and `code_action` ranges must lie inside the file. `kind` matches the action kind and its dotted sub-kinds, never the title; `quickfix` and other kinds are rejected. Disabled actions never match. When matching actions produce different edits, the result is ambiguous and lists each candidate's kind and exact title; repeat the call with `title`. For an action that only runs a server command (for example on kotlin-lsp or clangd), SuPi runs that one command, captures the single edit the server pushes, refuses it so no file changes, and stores it as the plan; the plan shows `**Source:** edit captured from the server command`. Only `refactor*`, `source.organizeImports`, and `source.fixAll` commands run, never other `source.*` commands, and only commands the server lists when it lists any. Several matching command actions are reported as ambiguous without running any. Running a command may still change server-side state such as caches. Code actions choose their own names (such as `newVar` or `var_name`); the preview shows them, and `rename_symbol` can rename them after apply. Which kinds work depends on the server: `code_health` lists the advertised `refactor*` and `source*` kinds per server and marks servers, such as rust-analyzer, that may also return kinds they do not list. Unsupported operations do not fall back to text edits.
172
180
 
173
181
  Rename can discover affected files and repeat the request once after validated same-route enrollment, with a limit of 64 files. A null server document version for an open file is accepted only with a verified request snapshot of synchronized content. Plans retain its content fingerprint and client version; unknown or mismatched state remains unavailable.
174
182
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-code-runtime",
3
- "version": "11.4.0",
3
+ "version": "13.0.0",
4
4
  "description": "Shared workspace context and capability contracts for code intelligence",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -60,6 +60,7 @@ export type {
60
60
  ImportData,
61
61
  NodeAtData,
62
62
  OutlineData,
63
+ RefactorActionIdentity,
63
64
  RefactorOperation,
64
65
  RefactorRequest,
65
66
  RefactorResult,
@@ -193,31 +193,53 @@ export interface WorkspaceEdit {
193
193
  }
194
194
 
195
195
  /**
196
- * Supported refactor operation names for the current semantic planning path.
197
- */
198
- export type RefactorOperation =
199
- | "rename_symbol"
200
- | "extract_function"
201
- | "extract_variable"
202
- | "rename_file"
203
- | "move_file"
204
- | "update_imports"
205
- | "delete_dead_code";
206
-
207
- /**
208
- * Operation-aware refactor planning request.
196
+ * Operation-aware refactor planning request. Each operation carries only the
197
+ * scope it needs:
209
198
  *
210
- * Consumers provide a target file/position plus operation-specific options.
211
- * File/resource operations remain requestable so providers can reject them
212
- * explicitly and honestly until shared workspace-edit resource ops exist.
199
+ * - `rename_symbol`: one symbol position and the new name.
200
+ * - `code_action`: one file range and a CodeActionKind prefix under `refactor`.
201
+ * - `source_action`: one whole file and a CodeActionKind prefix under `source`.
202
+ *
203
+ * `kind` matches the requested kind and its dotted sub-kinds. `title`, when
204
+ * present, selects one action by its exact title.
213
205
  */
214
- export interface RefactorRequest {
215
- operation: RefactorOperation;
216
- file: string;
217
- position: CodePosition;
218
- range?: SourceRange;
219
- newName?: string;
220
- destination?: string;
206
+ export type RefactorRequest =
207
+ | {
208
+ operation: "rename_symbol";
209
+ file: string;
210
+ position: CodePosition;
211
+ newName: string;
212
+ }
213
+ | {
214
+ operation: "code_action";
215
+ file: string;
216
+ range: SourceRange;
217
+ kind: string;
218
+ title?: string;
219
+ }
220
+ | {
221
+ operation: "source_action";
222
+ file: string;
223
+ kind: string;
224
+ title?: string;
225
+ };
226
+
227
+ /** Supported refactor operation names. */
228
+ export type RefactorOperation = RefactorRequest["operation"];
229
+
230
+ /** The code action selected for a precise code- or source-action plan. */
231
+ export interface RefactorActionIdentity {
232
+ /** Server-reported CodeActionKind. */
233
+ kind: string;
234
+ /** Server-reported action title. */
235
+ title: string;
236
+ /**
237
+ * How the edits were obtained: `edit` from the action itself (after
238
+ * `codeAction/resolve` when needed), or `captured-command` from the single
239
+ * `workspace/applyEdit` the server pushed while running the action's command.
240
+ * Captured edits were refused, never applied.
241
+ */
242
+ provenance?: "edit" | "captured-command";
221
243
  }
222
244
 
223
245
  /**
@@ -228,6 +250,10 @@ export interface DisambiguationCandidate {
228
250
  file?: string;
229
251
  line?: number;
230
252
  character?: number;
253
+ /** Server-reported CodeActionKind, for code-action candidates. */
254
+ kind?: string;
255
+ /** Exact action title to pass back as `title`, for code-action candidates. */
256
+ title?: string;
231
257
  }
232
258
 
233
259
  /**
@@ -241,6 +267,8 @@ export type RefactorResult =
241
267
  | {
242
268
  kind: "precise";
243
269
  edits: WorkspaceEdit;
270
+ /** The selected code action, for code- and source-action plans. */
271
+ action?: RefactorActionIdentity;
244
272
  /** Provider roots authorized by the semantic route. Consumers canonicalize before storage. */
245
273
  authorizedMutationRoots: string[];
246
274
  }
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-core",
3
- "version": "11.4.0",
3
+ "version": "13.0.0",
4
4
  "description": "Shared settings, configuration, reporting, and session infrastructure",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -63,8 +63,10 @@
63
63
  "./project": "./src/project.ts",
64
64
  "./prompt-surface": "./src/prompt-surface.ts",
65
65
  "./report": "./src/report.ts",
66
+ "./retired-packages": "./src/retired-packages.ts",
66
67
  "./session": "./src/session.ts",
67
68
  "./settings": "./src/settings.ts",
69
+ "./spill": "./src/spill.ts",
68
70
  "./spinner-frames": "./src/spinner-frames.ts",
69
71
  "./status-spinner": "./src/status-spinner.ts",
70
72
  "./terminal": "./src/terminal.ts",
@@ -29,10 +29,14 @@ export * from "./prompt-surface.ts";
29
29
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
30
30
  export * from "./report.ts";
31
31
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
32
+ export * from "./retired-packages.ts";
33
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
32
34
  export * from "./session.ts";
33
35
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
34
36
  export * from "./settings.ts";
35
37
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
38
+ export * from "./spill.ts";
39
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
36
40
  export * from "./spinner-frames.ts";
37
41
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
38
42
  export * from "./status-spinner.ts";
@@ -8,7 +8,7 @@
8
8
  /**
9
9
  * Wrap content in an `<extension-context>` XML tag.
10
10
  *
11
- * @param source - Extension identifier (e.g. "supi-claude-md", "supi-lsp")
11
+ * @param source - Extension identifier (e.g. "supi-lsp")
12
12
  * @param content - The text content to wrap
13
13
  * @param attrs - Optional additional attributes (rendered as key="value")
14
14
  * @returns Formatted XML string
@@ -18,6 +18,12 @@ export interface DebugRegistryConfig {
18
18
  agentRunRetrospectivesEnabled: boolean;
19
19
  /** Maximum number of session-local events to keep in memory. */
20
20
  maxEvents: number;
21
+ /**
22
+ * Minimum level forwarded to persistence sinks. Lower-level events stay in the
23
+ * live retained buffer only, so high-volume `debug` telemetry does not grow
24
+ * session files.
25
+ */
26
+ persistLevel: DebugLevel;
21
27
  }
22
28
 
23
29
  export const DEBUG_REGISTRY_DEFAULTS: DebugRegistryConfig = {
@@ -25,8 +31,11 @@ export const DEBUG_REGISTRY_DEFAULTS: DebugRegistryConfig = {
25
31
  agentAccess: "sanitized",
26
32
  agentRunRetrospectivesEnabled: false,
27
33
  maxEvents: 100,
34
+ persistLevel: "info",
28
35
  };
29
36
 
37
+ const DEBUG_LEVEL_RANK: Record<DebugLevel, number> = { debug: 0, info: 1, warning: 2, error: 3 };
38
+
30
39
  export interface DebugEventInput {
31
40
  /** Opaque identity for events directly owned by one public Tool call. */
32
41
  operationId?: string;
@@ -150,6 +159,10 @@ export function isDebugLevel(value: unknown): value is DebugLevel {
150
159
  return value === "debug" || value === "info" || value === "warning" || value === "error";
151
160
  }
152
161
 
162
+ function shouldPersist(state: DebugRegistryState, level: DebugLevel): boolean {
163
+ return DEBUG_LEVEL_RANK[level] >= DEBUG_LEVEL_RANK[state.config.persistLevel];
164
+ }
165
+
153
166
  /** Return whether a value has the exact 16-byte base64url Debug Operation ID form. */
154
167
  export function isDebugOperationId(value: unknown): value is string {
155
168
  return typeof value === "string" && DEBUG_OPERATION_ID_RE.test(value);
@@ -194,6 +207,9 @@ export function configureDebugRegistry(config: Partial<DebugRegistryConfig>): De
194
207
  ...state.config,
195
208
  ...config,
196
209
  maxEvents: normalizeMaxEvents(config.maxEvents ?? state.config.maxEvents),
210
+ persistLevel: isDebugLevel(config.persistLevel)
211
+ ? config.persistLevel
212
+ : state.config.persistLevel,
197
213
  };
198
214
  trimToMaxEvents(state);
199
215
  return getDebugRegistryConfig();
@@ -211,14 +227,16 @@ export function isDebugRegistryEnabled(): boolean {
211
227
 
212
228
  /**
213
229
  * Return whether a retrospective can be captured: Debug and its explicit opt-in
214
- * must be enabled, and at least one persistence sink must be registered.
230
+ * must be enabled, at least one persistence sink must be registered, and the
231
+ * persistence threshold must admit `info` events.
215
232
  */
216
233
  export function canRecordAgentRunRetrospective(): boolean {
217
234
  const state = getState();
218
235
  return (
219
236
  state.config.enabled &&
220
237
  state.config.agentRunRetrospectivesEnabled &&
221
- state.persistenceSinks.size > 0
238
+ state.persistenceSinks.size > 0 &&
239
+ shouldPersist(state, "info")
222
240
  );
223
241
  }
224
242
 
@@ -283,7 +301,8 @@ export function recordDebugEvent(input: DebugEventInput): DebugEvent | null {
283
301
  // Debug-event consumers must not alter producer behavior.
284
302
  }
285
303
  }
286
- for (const sink of state.persistenceSinks) {
304
+ const sinks = shouldPersist(state, event.level) ? state.persistenceSinks : [];
305
+ for (const sink of sinks) {
287
306
  try {
288
307
  sink(toSanitizedView(event));
289
308
  } catch {
@@ -0,0 +1,152 @@
1
+ // supi-core retired-packages domain — warn when a retired SuPi package is still declared.
2
+ //
3
+ // Retired packages keep loading after an upgrade until the user removes them, and their
4
+ // surfaces can shadow the package that absorbed them. Detection reads the declared Pi
5
+ // packages per scope, the same view `pi remove` acts on, and never infers identity from paths.
6
+
7
+ import type {
8
+ ExtensionAPI,
9
+ ExtensionContext,
10
+ PackageSource,
11
+ } from "@earendil-works/pi-coding-agent";
12
+ import { SettingsManager } from "@earendil-works/pi-coding-agent";
13
+ import { recordDebugEvent } from "./debug-registry.ts";
14
+
15
+ /** A retired npm package and the package that now ships its features. */
16
+ export interface RetiredPackage {
17
+ /** npm package name, e.g. `"@mrclrchtr/supi-cache"`. */
18
+ name: string;
19
+ /** npm package name that absorbed it, e.g. `"@mrclrchtr/supi-debug"`. */
20
+ replacement: string;
21
+ }
22
+
23
+ /** Pi settings scope of a package declaration. */
24
+ export type PackageDeclarationScope = "user" | "project";
25
+
26
+ /** One declaration of a retired package found in Pi settings. */
27
+ export interface RetiredPackageDeclaration {
28
+ package: RetiredPackage;
29
+ scope: PackageDeclarationScope;
30
+ /** Exact command that removes this declaration. */
31
+ removeCommand: string;
32
+ }
33
+
34
+ /** Declared Pi packages per scope. Omit `project` when the project is not trusted. */
35
+ export interface DeclaredPackages {
36
+ user: readonly PackageSource[];
37
+ project?: readonly PackageSource[];
38
+ }
39
+
40
+ /** Options for {@link warnRetiredPackages}. */
41
+ export interface WarnRetiredPackagesOptions {
42
+ /** Debug event source, e.g. `"supi-debug"`. */
43
+ source: string;
44
+ /** Override Pi's agent directory (tests). */
45
+ agentDir?: string;
46
+ }
47
+
48
+ const WARNED_KEY = Symbol.for("@mrclrchtr/supi-core/retired-packages-warned");
49
+ const NPM_PREFIX = "npm:";
50
+ const NPM_NAME_RE = /^(@[^/\s]+\/[^@\s]+|[^@\s]+)(?:@.+)?$/;
51
+
52
+ /** npm package name of a Pi package source, ignoring version pins; `undefined` for non-npm sources. */
53
+ export function npmPackageName(source: PackageSource): string | undefined {
54
+ const value = (typeof source === "string" ? source : source.source).trim();
55
+ if (!value.startsWith(NPM_PREFIX)) return undefined;
56
+ return NPM_NAME_RE.exec(value.slice(NPM_PREFIX.length).trim())?.[1];
57
+ }
58
+
59
+ /** Find declarations of retired packages, project scope first (Pi's load precedence). */
60
+ export function findRetiredPackageDeclarations(
61
+ declared: DeclaredPackages,
62
+ retired: readonly RetiredPackage[],
63
+ ): RetiredPackageDeclaration[] {
64
+ const scopes: Array<[PackageDeclarationScope, readonly PackageSource[] | undefined]> = [
65
+ ["project", declared.project],
66
+ ["user", declared.user],
67
+ ];
68
+ const found: RetiredPackageDeclaration[] = [];
69
+ for (const [scope, sources] of scopes) {
70
+ const names = new Set((sources ?? []).map(npmPackageName));
71
+ for (const pkg of retired) {
72
+ if (!names.has(pkg.name)) continue;
73
+ const local = scope === "project" ? " --local" : "";
74
+ found.push({ package: pkg, scope, removeCommand: `pi remove npm:${pkg.name}${local}` });
75
+ }
76
+ }
77
+ return found;
78
+ }
79
+
80
+ /** Format one bounded, actionable warning for one retired package. */
81
+ export function formatRetiredPackageWarning(
82
+ pkg: RetiredPackage,
83
+ declarations: readonly RetiredPackageDeclaration[],
84
+ ): string {
85
+ const commands = declarations.map((declaration) => ` ${declaration.removeCommand}`);
86
+ return [
87
+ `${pkg.name} is retired; ${pkg.replacement} now ships its features, and the old package can override them. Remove it:`,
88
+ ...commands,
89
+ ].join("\n");
90
+ }
91
+
92
+ function warnedNames(): Set<string> {
93
+ const store = globalThis as Record<symbol, Set<string> | undefined>;
94
+ store[WARNED_KEY] ??= new Set();
95
+ return store[WARNED_KEY];
96
+ }
97
+
98
+ function readDeclaredPackages(
99
+ ctx: Pick<ExtensionContext, "cwd" | "isProjectTrusted">,
100
+ agentDir: string | undefined,
101
+ ): DeclaredPackages {
102
+ const projectTrusted = ctx.isProjectTrusted();
103
+ const settings = SettingsManager.create(ctx.cwd, agentDir, { projectTrusted });
104
+ return {
105
+ user: settings.getGlobalSettings().packages ?? [],
106
+ ...(projectTrusted ? { project: settings.getProjectSettings().packages ?? [] } : {}),
107
+ };
108
+ }
109
+
110
+ /**
111
+ * Warn once per Pi process for each retired package that is still declared in user or
112
+ * trusted project settings. Shows a UI warning, or writes to stderr without UI, and records
113
+ * a `retired-package` Debug event. Never throws; unreadable settings skip the check.
114
+ */
115
+ export function warnRetiredPackages(
116
+ pi: ExtensionAPI,
117
+ retired: readonly RetiredPackage[],
118
+ options: WarnRetiredPackagesOptions,
119
+ ): void {
120
+ pi.on("session_start", (_event, ctx) => {
121
+ const warned = warnedNames();
122
+ const pending = retired.filter((pkg) => !warned.has(pkg.name));
123
+ if (pending.length === 0) return;
124
+
125
+ let declarations: RetiredPackageDeclaration[];
126
+ try {
127
+ declarations = findRetiredPackageDeclarations(
128
+ readDeclaredPackages(ctx, options.agentDir),
129
+ pending,
130
+ );
131
+ } catch {
132
+ return;
133
+ }
134
+
135
+ for (const pkg of pending) {
136
+ const matches = declarations.filter((declaration) => declaration.package === pkg);
137
+ if (matches.length === 0) continue;
138
+ warned.add(pkg.name);
139
+ const message = formatRetiredPackageWarning(pkg, matches);
140
+ if (ctx.hasUI) ctx.ui.notify(message, "warning");
141
+ else process.stderr.write(`${message}\n`);
142
+ recordDebugEvent({
143
+ source: options.source,
144
+ level: "warning",
145
+ category: "retired-package",
146
+ message: `${pkg.name} is retired but still declared`,
147
+ cwd: ctx.cwd,
148
+ data: { name: pkg.name, replacement: pkg.replacement, scopes: matches.map((m) => m.scope) },
149
+ });
150
+ }
151
+ });
152
+ }
@@ -56,3 +56,4 @@ export {
56
56
  createSessionNameTracker,
57
57
  getActiveBranchEntries,
58
58
  } from "./session-utils.ts";
59
+ export { BSD_SED_HINT, BSD_SED_HINT_MARKER, registerShellHints } from "./shell-hints.ts";
@@ -0,0 +1,46 @@
1
+ // Shell hints — explain BSD sed script errors once per session.
2
+ //
3
+ // On macOS, `sed` is BSD sed: `-i` requires a backup-suffix argument and script errors read
4
+ // `sed: 1: "...": ...`. Agents trained on GNU sed retry the same shape repeatedly. This hook adds
5
+ // one hint to the first matching bash result in a session. It costs no context until it fires.
6
+
7
+ import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
8
+
9
+ /** Marker that identifies the hint in tool results and on the session branch. */
10
+ export const BSD_SED_HINT_MARKER = "[supi shell hint]";
11
+
12
+ /** Text appended to the first BSD sed script error in a session. */
13
+ export const BSD_SED_HINT = `${BSD_SED_HINT_MARKER} This is BSD sed (macOS): \`sed -i\` needs a suffix argument (\`sed -i '' ...\`), and the substitute delimiter must not occur in the pattern. Prefer the edit tool for file changes when it is available, or \`gsed\` if installed.`;
14
+
15
+ const BSD_SED_ERROR = /^sed: (?:\d+: |-i may not be used|-I or -i may not be used)/m;
16
+
17
+ function resultText(content: readonly { type: string; text?: string }[]): string {
18
+ return content.map((part) => (part.type === "text" ? (part.text ?? "") : "")).join("\n");
19
+ }
20
+
21
+ function hintAlreadyShown(ctx: ExtensionContext): boolean {
22
+ return ctx.sessionManager
23
+ .getBranch()
24
+ .some(
25
+ (entry) =>
26
+ entry.type === "message" &&
27
+ entry.message.role === "toolResult" &&
28
+ JSON.stringify(entry.message.content).includes(BSD_SED_HINT_MARKER),
29
+ );
30
+ }
31
+
32
+ /**
33
+ * Register a `tool_result` hook that appends {@link BSD_SED_HINT} to the first bash result in a
34
+ * session that contains a BSD sed script error. Safe to register from several extensions: the hook
35
+ * skips results that already carry the hint and sessions whose branch already shows it.
36
+ * Usable directly as a child-session extension factory.
37
+ */
38
+ export function registerShellHints(pi: ExtensionAPI): void {
39
+ pi.on("tool_result", (event, ctx) => {
40
+ if (event.toolName !== "bash") return;
41
+ const text = resultText(event.content);
42
+ if (!BSD_SED_ERROR.test(text) || text.includes(BSD_SED_HINT_MARKER)) return;
43
+ if (hintAlreadyShown(ctx)) return;
44
+ return { content: [...event.content, { type: "text", text: BSD_SED_HINT }] };
45
+ });
46
+ }