@mrclrchtr/supi-code-intelligence 12.0.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.
- package/CHANGELOG.md +17 -0
- package/README.md +4 -2
- package/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-core/package.json +3 -1
- package/node_modules/@mrclrchtr/supi-core/src/api.ts +4 -0
- package/node_modules/@mrclrchtr/supi-core/src/context/context-tag.ts +1 -1
- package/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +22 -3
- package/node_modules/@mrclrchtr/supi-core/src/retired-packages.ts +152 -0
- package/node_modules/@mrclrchtr/supi-core/src/session.ts +1 -0
- package/node_modules/@mrclrchtr/supi-core/src/shell-hints.ts +46 -0
- package/node_modules/@mrclrchtr/supi-core/src/spill.ts +93 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +3 -1
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/api.ts +4 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/context/context-tag.ts +1 -1
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +22 -3
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/retired-packages.ts +152 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/session.ts +1 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/shell-hints.ts +46 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/spill.ts +93 -0
- package/node_modules/@mrclrchtr/supi-lsp/package.json +8 -8
- package/node_modules/@mrclrchtr/supi-lsp/src/api.ts +1 -0
- package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-cache.ts +102 -47
- package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-host.ts +8 -0
- package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-refresh.ts +15 -1
- package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-request.ts +1 -1
- package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostics.ts +46 -4
- package/node_modules/@mrclrchtr/supi-lsp/src/client/client-disk-stamp.ts +60 -0
- package/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-state.ts +3 -0
- package/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-sync.ts +21 -1
- package/node_modules/@mrclrchtr/supi-lsp/src/client/client-file-state.ts +17 -3
- package/node_modules/@mrclrchtr/supi-lsp/src/client/client-semantic-input-barrier.ts +53 -4
- package/node_modules/@mrclrchtr/supi-lsp/src/client/client.ts +11 -3
- package/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-extends.ts +2 -1
- package/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-path.ts +2 -2
- package/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-scope.ts +14 -5
- package/node_modules/@mrclrchtr/supi-lsp/src/config/typescript-module.ts +17 -0
- package/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/evidence.ts +42 -0
- package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-client-state.ts +2 -17
- package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-removal-ledger.ts +52 -0
- package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +40 -20
- package/node_modules/@mrclrchtr/supi-lsp/src/manager/typescript-file-local.ts +6 -1
- package/node_modules/@mrclrchtr/supi-lsp/src/provider/lsp-semantic-provider.ts +6 -1
- package/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-symbol-mapper.ts +13 -3
- package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostic-surface.ts +11 -0
- package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostics.ts +1 -0
- package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +17 -2
- package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-transition-debug.ts +11 -1
- package/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +2 -0
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +3 -1
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/api.ts +4 -0
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/context/context-tag.ts +1 -1
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +22 -3
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/retired-packages.ts +152 -0
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/session.ts +1 -0
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/shell-hints.ts +46 -0
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/spill.ts +93 -0
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.cjs +50 -75
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.cjs.map +2 -2
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.js +50 -75
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.js.map +2 -2
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.wasm +0 -0
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.wasm.map +6 -6
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.cjs +50 -75
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.cjs.map +2 -2
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.cts +7 -7
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.cts.map +1 -1
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.ts +7 -7
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.d.ts.map +1 -1
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.js +50 -75
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.js.map +2 -2
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.wasm +0 -0
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.wasm.map +5 -5
- package/node_modules/@mrclrchtr/supi-tree-sitter/package.json +5 -5
- package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/kotlin/tree-sitter-kotlin.wasm.json +1 -1
- package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/latex/tree-sitter-latex.wasm.json +1 -1
- package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/sql/tree-sitter-sql.wasm.json +1 -1
- package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/tsx/tree-sitter-tsx.wasm.json +1 -1
- package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/typescript/tree-sitter-typescript.wasm.json +1 -1
- package/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-client.ts +1 -1
- package/node_modules/fast-xml-parser/CHANGELOG.md +886 -0
- package/node_modules/fast-xml-parser/LICENSE +21 -0
- package/node_modules/fast-xml-parser/README.md +204 -0
- package/node_modules/fast-xml-parser/lib/fxbuilder.min.js +2 -0
- package/node_modules/fast-xml-parser/lib/fxbuilder.min.js.map +1 -0
- package/node_modules/fast-xml-parser/lib/fxp.cjs +1 -0
- package/node_modules/fast-xml-parser/lib/fxp.d.cts +774 -0
- package/node_modules/fast-xml-parser/lib/fxp.min.js +2 -0
- package/node_modules/fast-xml-parser/lib/fxp.min.js.map +1 -0
- package/node_modules/fast-xml-parser/lib/fxparser.min.js +2 -0
- package/node_modules/fast-xml-parser/lib/fxparser.min.js.map +1 -0
- package/node_modules/fast-xml-parser/lib/fxvalidator.min.js +2 -0
- package/node_modules/fast-xml-parser/lib/fxvalidator.min.js.map +1 -0
- package/node_modules/fast-xml-parser/node_modules/@nodable/entities/README.md +92 -0
- package/node_modules/fast-xml-parser/node_modules/@nodable/entities/package.json +57 -0
- package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/EntityDecoder.js +644 -0
- package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/EntityEncoder.js +239 -0
- package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/all-entities.js +53 -0
- package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/entities.js +1139 -0
- package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/entityTries.js +60 -0
- package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/index.d.ts +358 -0
- package/node_modules/fast-xml-parser/node_modules/@nodable/entities/src/index.js +29 -0
- package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/CHANGELOG.md +52 -0
- package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/LICENSE +21 -0
- package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/README.md +77 -0
- package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/lib/fxb.cjs +1 -0
- package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/lib/fxb.d.cts +270 -0
- package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/lib/fxb.min.js +2 -0
- package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/lib/fxb.min.js.map +1 -0
- package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/package.json +77 -0
- package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/fxb.d.ts +270 -0
- package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/fxb.js +609 -0
- package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/ignoreAttributes.js +18 -0
- package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/orderedJs2Xml.js +360 -0
- package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/prettifyJs2Xml.js +0 -0
- package/node_modules/fast-xml-parser/node_modules/fast-xml-builder/src/util.js +23 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/LICENSE +21 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/README.md +632 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/package.json +56 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/html.js +102 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/log.js +98 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/nosql.js +114 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/redos.js +60 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/shell.js +105 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/sql-strict.js +47 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/sql.js +95 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/svg.js +81 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/contexts/xml.js +79 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/index.cjs +27 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/index.d.ts +103 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/index.js +292 -0
- package/node_modules/fast-xml-parser/node_modules/is-unsafe/src/util/decode-entities.js +48 -0
- package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/LICENSE +21 -0
- package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/README.md +947 -0
- package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/lib/pem.cjs +1 -0
- package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/lib/pem.d.cts +725 -0
- package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/lib/pem.min.js +2 -0
- package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/lib/pem.min.js.map +1 -0
- package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/package.json +79 -0
- package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/Expression.js +232 -0
- package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/ExpressionSet.js +225 -0
- package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/Matcher.js +663 -0
- package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/index.d.ts +589 -0
- package/node_modules/fast-xml-parser/node_modules/path-expression-matcher/src/index.js +30 -0
- package/node_modules/fast-xml-parser/node_modules/strnum/CHANGELOG.md +63 -0
- package/node_modules/fast-xml-parser/node_modules/strnum/LICENSE +21 -0
- package/node_modules/fast-xml-parser/node_modules/strnum/README.md +113 -0
- package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/LICENSE +21 -0
- package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/README.md +142 -0
- package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/anynum.js +135 -0
- package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/digitTable.js +116 -0
- package/node_modules/fast-xml-parser/node_modules/strnum/node_modules/anynum/package.json +42 -0
- package/node_modules/fast-xml-parser/node_modules/strnum/package.json +36 -0
- package/node_modules/fast-xml-parser/node_modules/strnum/strnum.js +176 -0
- package/node_modules/fast-xml-parser/node_modules/xml-naming/LICENSE +21 -0
- package/node_modules/fast-xml-parser/node_modules/xml-naming/README.md +287 -0
- package/node_modules/fast-xml-parser/node_modules/xml-naming/package.json +56 -0
- package/node_modules/fast-xml-parser/node_modules/xml-naming/src/index.d.ts +108 -0
- package/node_modules/fast-xml-parser/node_modules/xml-naming/src/index.js +382 -0
- package/node_modules/fast-xml-parser/package.json +93 -0
- package/node_modules/fast-xml-parser/src/cli/cli.js +97 -0
- package/node_modules/fast-xml-parser/src/cli/man.js +17 -0
- package/node_modules/fast-xml-parser/src/cli/read.js +43 -0
- package/node_modules/fast-xml-parser/src/fxp.d.ts +754 -0
- package/node_modules/fast-xml-parser/src/fxp.js +14 -0
- package/node_modules/fast-xml-parser/src/ignoreAttributes.js +18 -0
- package/node_modules/fast-xml-parser/src/util.js +61 -0
- package/node_modules/fast-xml-parser/src/v6/CharsSymbol.js +16 -0
- package/node_modules/fast-xml-parser/src/v6/EntitiesParser.js +106 -0
- package/node_modules/fast-xml-parser/src/v6/OptionsBuilder.js +61 -0
- package/node_modules/fast-xml-parser/src/v6/OutputBuilders/BaseOutputBuilder.js +69 -0
- package/node_modules/fast-xml-parser/src/v6/OutputBuilders/JsArrBuilder.js +103 -0
- package/node_modules/fast-xml-parser/src/v6/OutputBuilders/JsMinArrBuilder.js +100 -0
- package/node_modules/fast-xml-parser/src/v6/OutputBuilders/JsObjBuilder.js +154 -0
- package/node_modules/fast-xml-parser/src/v6/OutputBuilders/ParserOptionsBuilder.js +94 -0
- package/node_modules/fast-xml-parser/src/v6/Report.js +0 -0
- package/node_modules/fast-xml-parser/src/v6/TagPath.js +81 -0
- package/node_modules/fast-xml-parser/src/v6/TagPathMatcher.js +13 -0
- package/node_modules/fast-xml-parser/src/v6/XMLParser.js +83 -0
- package/node_modules/fast-xml-parser/src/v6/Xml2JsParser.js +235 -0
- package/node_modules/fast-xml-parser/src/v6/XmlPartReader.js +210 -0
- package/node_modules/fast-xml-parser/src/v6/XmlSpecialTagsReader.js +111 -0
- package/node_modules/fast-xml-parser/src/v6/inputSource/BufferSource.js +116 -0
- package/node_modules/fast-xml-parser/src/v6/inputSource/StringSource.js +121 -0
- package/node_modules/fast-xml-parser/src/v6/valueParsers/EntitiesParser.js +105 -0
- package/node_modules/fast-xml-parser/src/v6/valueParsers/booleanParser.js +22 -0
- package/node_modules/fast-xml-parser/src/v6/valueParsers/booleanParserExt.js +19 -0
- package/node_modules/fast-xml-parser/src/v6/valueParsers/currency.js +38 -0
- package/node_modules/fast-xml-parser/src/v6/valueParsers/join.js +13 -0
- package/node_modules/fast-xml-parser/src/v6/valueParsers/number.js +14 -0
- package/node_modules/fast-xml-parser/src/v6/valueParsers/trim.js +6 -0
- package/node_modules/fast-xml-parser/src/validator.js +518 -0
- package/node_modules/fast-xml-parser/src/xmlbuilder/json2xml.js +6 -0
- package/node_modules/fast-xml-parser/src/xmlparser/DocTypeReader.js +426 -0
- package/node_modules/fast-xml-parser/src/xmlparser/OptionsBuilder.js +164 -0
- package/node_modules/fast-xml-parser/src/xmlparser/OrderedObjParser.js +907 -0
- package/node_modules/fast-xml-parser/src/xmlparser/XMLParser.js +77 -0
- package/node_modules/fast-xml-parser/src/xmlparser/node2json.js +177 -0
- package/node_modules/fast-xml-parser/src/xmlparser/xmlNode.js +54 -0
- package/package.json +10 -8
- package/src/analysis/evidence.ts +331 -73
- package/src/analysis/health/diagnostics.ts +66 -18
- package/src/analysis/health/evidence-reason.ts +44 -0
- package/src/analysis/search/pattern.ts +3 -3
- package/src/analysis/target/anchored.ts +3 -6
- package/src/analysis/target/symbol.ts +41 -47
- package/src/analysis/target/types.ts +4 -9
- package/src/analysis/workspace/cmake-parser.ts +207 -0
- package/src/analysis/workspace/cmake.ts +141 -0
- package/src/analysis/workspace/maven.ts +310 -0
- package/src/analysis/workspace/membership.ts +100 -26
- package/src/analysis/workspace/metadata.ts +6 -1
- package/src/analysis/workspace/observe.ts +6 -0
- package/src/analysis/workspace/types.ts +11 -3
- package/src/diagnostics/coverage.ts +49 -0
- package/src/diagnostics/evidence.ts +10 -2
- package/src/session/health-workflow.ts +6 -0
- package/src/session/input/common.ts +1 -1
- package/src/session/orientation/collect.ts +42 -7
- package/src/session/orientation/context-facts.ts +3 -3
- package/src/session/orientation/context-sections.ts +13 -15
- package/src/session/orientation/facts.ts +5 -8
- package/src/session/orientation-workflow.ts +4 -19
- package/src/session/target-workflow.ts +25 -18
- package/src/tool/code_find/result.ts +5 -7
- package/src/tool/code_graph/display.ts +5 -6
- package/src/tool/code_graph/format.ts +8 -24
- package/src/tool/code_graph/result.ts +16 -75
- package/src/tool/code_graph/section.ts +21 -33
- package/src/tool/code_graph/tui.ts +10 -5
- package/src/tool/code_health/diagnostic-tui.ts +49 -0
- package/src/tool/code_health/guidance.ts +27 -0
- package/src/tool/code_health/markdown.ts +60 -8
- package/src/tool/code_health/result.ts +20 -9
- package/src/tool/code_health/structured-schema.ts +14 -0
- package/src/tool/code_health/structured.ts +7 -1
- package/src/tool/code_health/tui.ts +33 -40
- package/src/tool/code_inspect/result.ts +23 -18
- package/src/tool/code_inspect/structured.ts +2 -19
- package/src/tool/code_orientation/result.ts +53 -100
- package/src/tool/code_orientation/structured-schema.ts +16 -12
- package/src/tool/code_orientation/structured-workspace.ts +13 -7
- package/src/tool/code_orientation/structured.ts +31 -39
- package/src/tool/code_orientation/workspace-format.ts +4 -10
- package/src/tool/code_orientation/workspace-instructions.ts +4 -5
- package/src/tool/code_orientation/workspace-observations.ts +2 -2
- package/src/tool/code_orientation/workspace-output.ts +16 -7
- package/src/tool/code_orientation/workspace-projects.ts +7 -10
- package/src/tool/code_orientation/workspace-sections.ts +13 -19
- package/src/tool/code_resolve/markdown.ts +4 -46
- package/src/tool/code_resolve/result.ts +43 -72
- package/src/tool/infra/truncate.ts +2 -16
- package/src/tool/result/candidate-selection.ts +141 -0
- package/src/tool/result/display.ts +41 -45
- package/src/tool/result/errors.ts +1 -0
- package/src/tool/result/model-budget.ts +26 -1
- package/src/tool/result/refactor.ts +11 -8
- package/src/tool/result/structured.ts +2 -1
- package/src/tool/result/types.ts +9 -8
- package/src/tool/schemas.ts +15 -20
- package/src/ui/footer.ts +2 -4
- package/src/ui/status-presentation.ts +4 -7
- package/src/ui/tui/candidate-selection.ts +40 -95
- package/src/ui/tui/common.ts +16 -70
- package/src/ui/tui/display.ts +6 -24
- package/src/tool/result/candidate-row.ts +0 -49
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,22 @@
|
|
|
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
|
+
|
|
3
20
|
## [12.0.0]
|
|
4
21
|
|
|
5
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 }`.
|
package/README.md
CHANGED
|
@@ -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`,
|
|
138
|
-
-
|
|
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.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mrclrchtr/supi-core",
|
|
3
|
-
"version": "
|
|
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-
|
|
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,
|
|
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
|
-
|
|
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
|
+
}
|
|
@@ -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
|
+
}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
// supi-core spill domain — create-only temp files for full tool output (#597).
|
|
2
|
+
//
|
|
3
|
+
// SuPi never deletes spill files. Instead, it writes few of them: one private base directory per
|
|
4
|
+
// user, content-addressed names, and reuse for identical content. The OS temp purge owns their
|
|
5
|
+
// lifetime, so paths returned to the model stay readable for the session.
|
|
6
|
+
|
|
7
|
+
import { createHash, randomBytes } from "node:crypto";
|
|
8
|
+
import { lstatSync, mkdirSync, mkdtempSync, renameSync, writeFileSync } from "node:fs";
|
|
9
|
+
import { tmpdir } from "node:os";
|
|
10
|
+
import { extname, join } from "node:path";
|
|
11
|
+
|
|
12
|
+
/** Input for {@link writeSpillFile}. */
|
|
13
|
+
export interface SpillFileOptions {
|
|
14
|
+
/** Producer id used as sub-directory, e.g. `"agent"`. Lowercase letters, digits, and dashes. */
|
|
15
|
+
owner: string;
|
|
16
|
+
/** Descriptive file name, e.g. `"snapshot.md"`. The content hash is inserted before the extension. */
|
|
17
|
+
name: string;
|
|
18
|
+
/** Full content to persist. */
|
|
19
|
+
content: string;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
const SEGMENT = /^[a-z0-9][a-z0-9-]*$/;
|
|
23
|
+
const FILE_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* Persist full output that did not fit inline and return its absolute path.
|
|
27
|
+
*
|
|
28
|
+
* Layout: `$TMPDIR/supi-<uid>/<owner>/<stem>-<sha256 prefix><ext>`. Identical content maps to the
|
|
29
|
+
* same file, which is reused. Both directories must be real directories owned by the current
|
|
30
|
+
* user without group/other access; otherwise the file falls back to a fresh `mkdtemp`
|
|
31
|
+
* directory, as before. Files are created with mode `0600` and published atomically by rename.
|
|
32
|
+
*/
|
|
33
|
+
export function writeSpillFile({ owner, name, content }: SpillFileOptions): string {
|
|
34
|
+
if (!SEGMENT.test(owner)) throw new Error(`Invalid spill owner: ${owner}`);
|
|
35
|
+
if (!FILE_NAME.test(name)) throw new Error(`Invalid spill file name: ${name}`);
|
|
36
|
+
const extension = extname(name);
|
|
37
|
+
const stem = name.slice(0, name.length - extension.length);
|
|
38
|
+
const hash = createHash("sha256").update(content).digest("hex").slice(0, 32);
|
|
39
|
+
const fileName = `${stem}-${hash}${extension}`;
|
|
40
|
+
|
|
41
|
+
const directory = privateSpillDirectory(owner);
|
|
42
|
+
if (!directory) {
|
|
43
|
+
const fallback = join(mkdtempSync(join(tmpdir(), `supi-${owner}-`)), fileName);
|
|
44
|
+
writeFileSync(fallback, content, { encoding: "utf8", mode: 0o600, flag: "wx" });
|
|
45
|
+
return fallback;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
const target = join(directory, fileName);
|
|
49
|
+
if (isRegularFile(target)) return target;
|
|
50
|
+
const staging = join(directory, `.${fileName}.${process.pid}.${randomBytes(4).toString("hex")}`);
|
|
51
|
+
writeFileSync(staging, content, { encoding: "utf8", mode: 0o600, flag: "wx" });
|
|
52
|
+
// Atomic publish; a concurrent writer of the same hash replaces it with identical bytes.
|
|
53
|
+
renameSync(staging, target);
|
|
54
|
+
return target;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/** Return the validated private spill directory for `owner`, or undefined when it is unsafe. */
|
|
58
|
+
function privateSpillDirectory(owner: string): string | undefined {
|
|
59
|
+
const uid = process.getuid?.();
|
|
60
|
+
const base = join(tmpdir(), uid === undefined ? "supi" : `supi-${uid}`);
|
|
61
|
+
if (!ensurePrivateDirectory(base, uid)) return undefined;
|
|
62
|
+
const directory = join(base, owner);
|
|
63
|
+
return ensurePrivateDirectory(directory, uid) ? directory : undefined;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* Create `path` with mode `0700` if missing, then accept it only when it is a real directory
|
|
68
|
+
* (not a symlink) owned by `uid` with no group/other permissions. Never modifies or removes an
|
|
69
|
+
* existing entry. Ownership and mode checks are skipped where POSIX ids are unavailable.
|
|
70
|
+
*/
|
|
71
|
+
function ensurePrivateDirectory(path: string, uid: number | undefined): boolean {
|
|
72
|
+
try {
|
|
73
|
+
mkdirSync(path, { mode: 0o700 });
|
|
74
|
+
} catch (error) {
|
|
75
|
+
if ((error as NodeJS.ErrnoException).code !== "EEXIST") return false;
|
|
76
|
+
}
|
|
77
|
+
try {
|
|
78
|
+
const stats = lstatSync(path);
|
|
79
|
+
if (!stats.isDirectory() || stats.isSymbolicLink()) return false;
|
|
80
|
+
if (uid === undefined) return true;
|
|
81
|
+
return stats.uid === uid && (stats.mode & 0o077) === 0;
|
|
82
|
+
} catch {
|
|
83
|
+
return false;
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
function isRegularFile(path: string): boolean {
|
|
88
|
+
try {
|
|
89
|
+
return lstatSync(path).isFile();
|
|
90
|
+
} catch {
|
|
91
|
+
return false;
|
|
92
|
+
}
|
|
93
|
+
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mrclrchtr/supi-core",
|
|
3
|
-
"version": "
|
|
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-
|
|
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
|
package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts
CHANGED
|
@@ -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,
|
|
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
|
-
|
|
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 {
|