@mrclrchtr/supi-code-intelligence 11.0.1 → 11.2.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/README.md +68 -6
- package/gradle-helper/README.md +48 -0
- package/gradle-helper/build.sh +73 -0
- package/gradle-helper/lib/gradle-tooling-api-9.4.0.jar +0 -0
- package/gradle-helper/lib/slf4j-api-2.0.17.jar +0 -0
- package/gradle-helper/lib/slf4j-simple-2.0.17.jar +0 -0
- package/gradle-helper/lib/supi-gradle-observation.jar +0 -0
- package/gradle-helper/licenses/DEPENDENCIES.md +11 -0
- package/gradle-helper/licenses/LICENSE-gradle-tooling-api.txt +422 -0
- package/gradle-helper/licenses/LICENSE-slf4j.txt +21 -0
- package/gradle-helper/licenses/NOTICE-gradle.txt +21 -0
- package/gradle-helper/src/GradleObservation.java +597 -0
- package/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-core/package.json +1 -1
- package/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +41 -1
- package/node_modules/@mrclrchtr/supi-lsp/README.md +43 -6
- 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 +1 -1
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +41 -1
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/LICENSE +15 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/README.md +680 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/bin/semver.js +195 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/classes/comparator.js +143 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/classes/index.js +7 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/classes/range.js +577 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/classes/semver.js +350 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/clean.js +8 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/cmp.js +54 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/coerce.js +62 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/compare-build.js +9 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/compare-loose.js +5 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/compare.js +7 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/diff.js +60 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/eq.js +5 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/gt.js +5 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/gte.js +5 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/inc.js +21 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/lt.js +5 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/lte.js +5 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/major.js +5 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/minor.js +5 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/neq.js +5 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/parse.js +18 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/patch.js +5 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/prerelease.js +8 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/rcompare.js +5 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/rsort.js +5 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/satisfies.js +12 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/sort.js +5 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/truncate.js +48 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/valid.js +8 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/index.js +93 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/internal/constants.js +37 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/internal/debug.js +11 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/internal/identifiers.js +29 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/internal/lrucache.js +42 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/internal/parse-options.js +17 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/internal/re.js +223 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/package.json +78 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/preload.js +4 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/range.bnf +17 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/gtr.js +6 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/intersects.js +9 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/ltr.js +6 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/max-satisfying.js +27 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/min-satisfying.js +26 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/min-version.js +63 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/outside.js +82 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/simplify.js +49 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/subset.js +249 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/to-comparators.js +10 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/valid.js +13 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/vscode-jsonrpc/README.md +5 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/vscode-jsonrpc/lib/browser/ril.js +8 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/vscode-jsonrpc/lib/common/connection.js +7 -2
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/vscode-jsonrpc/lib/common/ral.d.ts +8 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/vscode-jsonrpc/lib/node/main.d.ts +14 -0
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/vscode-jsonrpc/lib/node/main.js +6 -4
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/vscode-jsonrpc/lib/node/ril.js +5 -1
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/vscode-jsonrpc/package.json +4 -2
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/vscode-languageserver-protocol/package.json +4 -3
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/vscode-languageserver-types/lib/esm/main.js +2 -2
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/vscode-languageserver-types/lib/umd/main.js +2 -2
- package/node_modules/@mrclrchtr/supi-lsp/node_modules/vscode-languageserver-types/package.json +2 -1
- package/node_modules/@mrclrchtr/supi-lsp/package.json +8 -6
- package/node_modules/@mrclrchtr/supi-lsp/src/client/client.ts +44 -5
- package/node_modules/@mrclrchtr/supi-lsp/src/config/config.ts +53 -2
- package/node_modules/@mrclrchtr/supi-lsp/src/config/operation-support.ts +19 -4
- package/node_modules/@mrclrchtr/supi-lsp/src/config/server-config.ts +22 -0
- package/node_modules/@mrclrchtr/supi-lsp/src/config/typescript-launch.ts +276 -0
- package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-project-info.ts +22 -10
- package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +53 -20
- package/node_modules/@mrclrchtr/supi-lsp/src/provider/refactor-planning.ts +4 -3
- package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-controller.ts +2 -2
- package/node_modules/@mrclrchtr/supi-lsp/src/session/scanner.ts +27 -15
- package/node_modules/@mrclrchtr/supi-tree-sitter/README.md +1 -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 +1 -1
- package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +41 -1
- package/node_modules/@mrclrchtr/supi-tree-sitter/package.json +5 -3
- package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/tsx/LICENSE +21 -0
- package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/tsx/tree-sitter-tsx.wasm +0 -0
- package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/tsx/tree-sitter-tsx.wasm.json +19 -2
- package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/typescript/LICENSE +21 -0
- package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/typescript/tree-sitter-typescript.wasm +0 -0
- package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/typescript/tree-sitter-typescript.wasm.json +19 -2
- package/node_modules/ignore/README.md +36 -10
- package/node_modules/ignore/index.d.ts +3 -2
- package/node_modules/ignore/index.js +57 -53
- package/node_modules/ignore/legacy.js +50 -46
- package/node_modules/ignore/package.json +1 -1
- package/package.json +11 -6
- package/src/analysis/capability/capability-warnings.ts +18 -12
- package/src/analysis/gradle/query.ts +273 -0
- package/src/analysis/gradle/runtime.ts +173 -0
- package/src/analysis/gradle/types.ts +65 -0
- package/src/analysis/health/check.ts +115 -0
- package/src/analysis/health/diagnostics.ts +3 -0
- package/src/analysis/health/file-scope.ts +2 -3
- package/src/analysis/health/semantic-state.ts +38 -0
- package/src/analysis/health/server-status.ts +8 -0
- package/src/analysis/health/signals.ts +2 -0
- package/src/analysis/health/status.ts +82 -0
- package/src/analysis/read-next.ts +1 -4
- package/src/analysis/refactor/apply.ts +19 -10
- package/src/analysis/refactor/mutation-authority.ts +4 -1
- package/src/analysis/search/ast-scan.ts +143 -18
- package/src/analysis/workspace/safe-path.ts +14 -2
- package/src/analysis/workspace/types.ts +2 -0
- package/src/extension.ts +10 -1
- package/src/gradle/consent.ts +279 -0
- package/src/headless.ts +3 -0
- package/src/overview/collect.ts +11 -3
- package/src/session/health-types.ts +7 -0
- package/src/session/health-workflow.ts +8 -43
- package/src/session/orientation/collect.ts +138 -12
- package/src/session/orientation/context-facts.ts +27 -2
- package/src/session/orientation/context-sections.ts +47 -0
- package/src/session/orientation/facts.ts +124 -0
- package/src/session/orientation/gather.ts +98 -11
- package/src/session/orientation/workspace-context.ts +59 -28
- package/src/session/orientation-types.ts +16 -1
- package/src/session/orientation-workflow.ts +5 -2
- package/src/session/refactor-plans.ts +5 -2
- package/src/session/refactor-workflow.ts +4 -3
- package/src/session/session.ts +8 -0
- package/src/tool/code_find/execute.ts +1 -1
- package/src/tool/code_find/guidance.ts +1 -1
- package/src/tool/code_find/markdown.ts +24 -17
- package/src/tool/code_find/result.ts +18 -5
- package/src/tool/code_find/spec.ts +2 -0
- package/src/tool/code_find/structured.ts +161 -0
- package/src/tool/code_graph/result.ts +32 -15
- package/src/tool/code_graph/spec.ts +2 -0
- package/src/tool/code_graph/structured.ts +142 -0
- package/src/tool/code_health/markdown.ts +17 -17
- package/src/tool/code_health/result.ts +15 -2
- package/src/tool/code_health/spec.ts +2 -0
- package/src/tool/code_health/structured-schema.ts +250 -0
- package/src/tool/code_health/structured.ts +256 -0
- package/src/tool/code_inspect/markdown.ts +19 -11
- package/src/tool/code_inspect/result.ts +12 -5
- package/src/tool/code_inspect/spec.ts +2 -0
- package/src/tool/code_inspect/structured.ts +232 -0
- package/src/tool/code_orientation/directory-navigation.ts +66 -0
- package/src/tool/code_orientation/gradle-sections.ts +68 -0
- package/src/tool/code_orientation/markdown.ts +19 -8
- package/src/tool/code_orientation/result.ts +95 -11
- package/src/tool/code_orientation/spec.ts +2 -0
- package/src/tool/code_orientation/structured-schema.ts +607 -0
- package/src/tool/code_orientation/structured-workspace.ts +193 -0
- package/src/tool/code_orientation/structured.ts +195 -0
- package/src/tool/code_orientation/workspace-format.ts +2 -1
- package/src/tool/code_orientation/workspace-observations.ts +81 -0
- package/src/tool/code_orientation/workspace-output.ts +45 -13
- package/src/tool/code_orientation/workspace-projects.ts +180 -75
- package/src/tool/code_orientation/workspace-sections.ts +46 -31
- package/src/tool/code_refactor_apply/execute.ts +1 -1
- package/src/tool/code_refactor_apply/result.ts +13 -5
- package/src/tool/code_refactor_apply/spec.ts +2 -0
- package/src/tool/code_refactor_apply/structured.ts +49 -0
- package/src/tool/code_refactor_plan/result.ts +16 -8
- package/src/tool/code_refactor_plan/spec.ts +2 -0
- package/src/tool/code_refactor_plan/structured.ts +128 -0
- package/src/tool/code_resolve/markdown.ts +4 -10
- package/src/tool/code_resolve/result.ts +2 -0
- package/src/tool/code_resolve/spec.ts +2 -0
- package/src/tool/code_resolve/structured.ts +103 -0
- package/src/tool/infra/truncate.ts +12 -4
- package/src/tool/register.ts +10 -6
- package/src/tool/result/display.ts +17 -0
- package/src/tool/result/model-budget.ts +195 -0
- package/src/tool/result/structured.ts +62 -0
- package/src/tool/result/types.ts +10 -2
- package/src/tool/schemas.ts +7 -1
- package/src/tool/specs.ts +2 -0
- package/src/types/execution.ts +5 -1
- package/src/ui/status-command.ts +110 -321
- package/src/ui/status-overlay.ts +564 -420
- package/src/ui/tui/display.ts +10 -4
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import { StringEnum } from "@earendil-works/pi-ai";
|
|
2
|
+
import { type Static, Type } from "typebox";
|
|
3
|
+
import { toDisplayPath } from "../../analysis/search/paths.ts";
|
|
4
|
+
import {
|
|
5
|
+
PUBLIC_REFACTOR_OPERATION_NAMES,
|
|
6
|
+
type RefactorPlanWorkflowOutcome,
|
|
7
|
+
} from "../../session/refactor-types.ts";
|
|
8
|
+
|
|
9
|
+
const Position = Type.Object(
|
|
10
|
+
{ line: Type.Integer({ minimum: 0 }), character: Type.Integer({ minimum: 0 }) },
|
|
11
|
+
{ additionalProperties: false },
|
|
12
|
+
);
|
|
13
|
+
const Edit = Type.Object(
|
|
14
|
+
{
|
|
15
|
+
file: Type.String(),
|
|
16
|
+
range: Type.Object(
|
|
17
|
+
{ start: Position, end: Position },
|
|
18
|
+
{
|
|
19
|
+
additionalProperties: false,
|
|
20
|
+
description: "Zero-based UTF-16 positions; end is exclusive.",
|
|
21
|
+
},
|
|
22
|
+
),
|
|
23
|
+
newText: Type.String(),
|
|
24
|
+
},
|
|
25
|
+
{ additionalProperties: false },
|
|
26
|
+
);
|
|
27
|
+
const Candidate = Type.Object(
|
|
28
|
+
{
|
|
29
|
+
description: Type.String(),
|
|
30
|
+
file: Type.Optional(Type.String()),
|
|
31
|
+
line: Type.Optional(Type.Integer()),
|
|
32
|
+
character: Type.Optional(Type.Integer()),
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
additionalProperties: false,
|
|
36
|
+
description:
|
|
37
|
+
"Provider-reported candidate location, when available; one-based line and UTF-16 character.",
|
|
38
|
+
},
|
|
39
|
+
);
|
|
40
|
+
|
|
41
|
+
/** Native plan data, including all edits rather than the bounded text preview. */
|
|
42
|
+
export const RefactorPlanOutputSchema = Type.Union([
|
|
43
|
+
Type.Object(
|
|
44
|
+
{
|
|
45
|
+
kind: Type.Literal("completed"),
|
|
46
|
+
planId: Type.String(),
|
|
47
|
+
operation: StringEnum([...PUBLIC_REFACTOR_OPERATION_NAMES]),
|
|
48
|
+
target: Type.Object(
|
|
49
|
+
{ file: Type.String(), line: Type.Integer(), character: Type.Integer() },
|
|
50
|
+
{ additionalProperties: false, description: "One-based line and UTF-16 character." },
|
|
51
|
+
),
|
|
52
|
+
newName: Type.Optional(Type.String()),
|
|
53
|
+
destination: Type.Optional(Type.String()),
|
|
54
|
+
edits: Type.Array(Edit),
|
|
55
|
+
fileCount: Type.Integer({ minimum: 0 }),
|
|
56
|
+
editCount: Type.Integer({ minimum: 0 }),
|
|
57
|
+
provenance: StringEnum(["semantic", "structural"]),
|
|
58
|
+
nextAction: Type.Object(
|
|
59
|
+
{ tool: Type.Literal("code_refactor_apply"), planId: Type.String() },
|
|
60
|
+
{ additionalProperties: false },
|
|
61
|
+
),
|
|
62
|
+
},
|
|
63
|
+
{ additionalProperties: false },
|
|
64
|
+
),
|
|
65
|
+
Type.Object(
|
|
66
|
+
{
|
|
67
|
+
kind: Type.Literal("ambiguous"),
|
|
68
|
+
candidates: Type.Array(Candidate),
|
|
69
|
+
nextAction: Type.String(),
|
|
70
|
+
},
|
|
71
|
+
{ additionalProperties: false },
|
|
72
|
+
),
|
|
73
|
+
Type.Object(
|
|
74
|
+
{ kind: Type.Literal("invalid-input"), message: Type.String(), nextAction: Type.String() },
|
|
75
|
+
{ additionalProperties: false },
|
|
76
|
+
),
|
|
77
|
+
]);
|
|
78
|
+
|
|
79
|
+
/** Project public facts without plan authority, fingerprints, or document preconditions. */
|
|
80
|
+
export function structuredRefactorPlan(
|
|
81
|
+
outcome: Exclude<RefactorPlanWorkflowOutcome, { kind: "unavailable" }>,
|
|
82
|
+
cwd: string,
|
|
83
|
+
): Static<typeof RefactorPlanOutputSchema> {
|
|
84
|
+
if (outcome.kind === "invalid-input")
|
|
85
|
+
return {
|
|
86
|
+
kind: outcome.kind,
|
|
87
|
+
message: outcome.message,
|
|
88
|
+
nextAction: "Fix the target or operation and retry",
|
|
89
|
+
};
|
|
90
|
+
if (outcome.kind === "ambiguous")
|
|
91
|
+
return {
|
|
92
|
+
kind: outcome.kind,
|
|
93
|
+
candidates: outcome.candidates.map((candidate) => ({
|
|
94
|
+
description: candidate.description,
|
|
95
|
+
...(candidate.file === undefined ? {} : { file: toDisplayPath(cwd, candidate.file) }),
|
|
96
|
+
...(candidate.line === undefined ? {} : { line: candidate.line }),
|
|
97
|
+
...(candidate.character === undefined ? {} : { character: candidate.character }),
|
|
98
|
+
})),
|
|
99
|
+
nextAction: "Use a precise target handle or anchor",
|
|
100
|
+
};
|
|
101
|
+
const plan = outcome.plan;
|
|
102
|
+
const operation = PUBLIC_REFACTOR_OPERATION_NAMES.find((name) => name === plan.operation);
|
|
103
|
+
if (operation === undefined) throw new Error(`Unsupported refactor operation: ${plan.operation}`);
|
|
104
|
+
return {
|
|
105
|
+
kind: "completed",
|
|
106
|
+
planId: plan.id,
|
|
107
|
+
operation,
|
|
108
|
+
target: {
|
|
109
|
+
file: toDisplayPath(cwd, plan.targetFile),
|
|
110
|
+
line: plan.targetLine,
|
|
111
|
+
character: plan.targetCharacter,
|
|
112
|
+
},
|
|
113
|
+
...(plan.newName === undefined ? {} : { newName: plan.newName }),
|
|
114
|
+
...(plan.destination === undefined ? {} : { destination: plan.destination }),
|
|
115
|
+
edits: plan.edits.edits.map((edit) => ({
|
|
116
|
+
file: toDisplayPath(cwd, edit.file),
|
|
117
|
+
range: {
|
|
118
|
+
start: { line: edit.range.start.line, character: edit.range.start.character },
|
|
119
|
+
end: { line: edit.range.end.line, character: edit.range.end.character },
|
|
120
|
+
},
|
|
121
|
+
newText: edit.newText,
|
|
122
|
+
})),
|
|
123
|
+
fileCount: new Set(plan.edits.edits.map((edit) => edit.file)).size,
|
|
124
|
+
editCount: plan.edits.edits.length,
|
|
125
|
+
provenance: plan.evidenceSource ?? "semantic",
|
|
126
|
+
nextAction: { tool: "code_refactor_apply", planId: plan.id },
|
|
127
|
+
};
|
|
128
|
+
}
|
|
@@ -36,14 +36,9 @@ function renderResolved(
|
|
|
36
36
|
const kind = displayKind ? ` \`${displayKind}\`` : "";
|
|
37
37
|
const name = target.name ? ` **${target.name}**${kind}` : "";
|
|
38
38
|
const lines = [
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
`- Line: ${target.displayLine}, Column: ${target.displayCharacter}`,
|
|
43
|
-
`- Target ID: \`${target.targetId}\``,
|
|
44
|
-
`- Span ID: \`${target.spanId}\``,
|
|
45
|
-
`- Confidence: \`${target.confidence}\``,
|
|
46
|
-
`- Provenance: \`${target.provenance.join("+")}\``,
|
|
39
|
+
`${name.trim() || "Resolved target"} — \`${relFile}:${target.displayLine}:${target.displayCharacter}\``,
|
|
40
|
+
`Handle: \`${target.targetId}\``,
|
|
41
|
+
`confidence: ${target.confidence}; provenance: ${target.provenance.join("+")}`,
|
|
47
42
|
];
|
|
48
43
|
|
|
49
44
|
const resolutionNote = renderAnchoredResolutionNote(target);
|
|
@@ -93,8 +88,7 @@ function appendTargetGroupItems(lines: string[], details: ResolveDetails): void
|
|
|
93
88
|
const kind = displayKind ? ` (\`${displayKind}\`)` : "";
|
|
94
89
|
const container = target.container ? ` in \`${target.container}\`` : "";
|
|
95
90
|
lines.push(
|
|
96
|
-
`- **${target.name ?? "anonymous"}**${kind}${container} — \`${target.
|
|
97
|
-
` Target ID: \`${target.targetId}\` (${target.anchorKind} anchor, ${target.confidence}, provenance: ${target.provenance.join("+")})`,
|
|
91
|
+
`- \`${target.targetId}\` **${target.name ?? "anonymous"}**${kind}${container} — \`${target.displayLine}:${target.displayCharacter}\` (${target.anchorKind} anchor, ${target.confidence}, provenance: ${target.provenance.join("+")})`,
|
|
98
92
|
);
|
|
99
93
|
}
|
|
100
94
|
}
|
|
@@ -302,6 +302,7 @@ function resolveProvenance(outcome: TargetWorkflowOutcome): ResultProvenance[] {
|
|
|
302
302
|
|
|
303
303
|
import type { CodeIntelResult, CodeIntelToolExecCtx } from "../../types/index.ts";
|
|
304
304
|
import { renderResolveResult } from "./markdown.ts";
|
|
305
|
+
import { structuredResolveResult } from "./structured.ts";
|
|
305
306
|
|
|
306
307
|
type ResolveOutcome = Awaited<ReturnType<CodeIntelToolExecCtx["session"]["resolve"]>>;
|
|
307
308
|
|
|
@@ -324,6 +325,7 @@ export function finishResolveResult(
|
|
|
324
325
|
|
|
325
326
|
return {
|
|
326
327
|
content,
|
|
328
|
+
structuredContent: structuredResolveResult(assembly.details, outcome),
|
|
327
329
|
details: {
|
|
328
330
|
type: "resolve",
|
|
329
331
|
data: assembly.details,
|
|
@@ -2,6 +2,7 @@ import { Type } from "typebox";
|
|
|
2
2
|
import type { CodeIntelToolExecCtx } from "../../types/index.ts";
|
|
3
3
|
import { MaxResultsParam, ResolveTargetParam } from "../schemas.ts";
|
|
4
4
|
import { executeResolveTool } from "./execute.ts";
|
|
5
|
+
import { ResolveOutputSchema } from "./structured.ts";
|
|
5
6
|
import { renderResolveCall, renderResolveResult } from "./tui.ts";
|
|
6
7
|
|
|
7
8
|
export const CODE_RESOLVE_TOOL_NAME = "code_resolve";
|
|
@@ -11,6 +12,7 @@ export const CODE_RESOLVE_TOOL_LABEL = "Code Resolve";
|
|
|
11
12
|
export const codeResolveSpec = {
|
|
12
13
|
name: CODE_RESOLVE_TOOL_NAME,
|
|
13
14
|
label: CODE_RESOLVE_TOOL_LABEL,
|
|
15
|
+
outputSchema: ResolveOutputSchema,
|
|
14
16
|
parameters: Type.Object(
|
|
15
17
|
{
|
|
16
18
|
target: ResolveTargetParam,
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
import { StringEnum } from "@earendil-works/pi-ai";
|
|
2
|
+
import { type Static, Type } from "typebox";
|
|
3
|
+
import type { TargetWorkflowOutcome } from "../../session/target-workflow.ts";
|
|
4
|
+
import {
|
|
5
|
+
ConfidenceSchema,
|
|
6
|
+
EvidenceListSchema,
|
|
7
|
+
NavigationTargetSchema,
|
|
8
|
+
RecoveryRangeSchema,
|
|
9
|
+
} from "../result/structured.ts";
|
|
10
|
+
import type { ResolveDetails } from "../result/types.ts";
|
|
11
|
+
|
|
12
|
+
/** Codemode contract for resolution, including candidate selection and invalid input. */
|
|
13
|
+
export const ResolveOutputSchema = Type.Object(
|
|
14
|
+
{
|
|
15
|
+
kind: StringEnum([
|
|
16
|
+
"resolved",
|
|
17
|
+
"target-group",
|
|
18
|
+
"disambiguation",
|
|
19
|
+
"kind-mismatch",
|
|
20
|
+
"invalid-input",
|
|
21
|
+
]),
|
|
22
|
+
confidence: ConfidenceSchema,
|
|
23
|
+
targets: Type.Array(NavigationTargetSchema),
|
|
24
|
+
evidenceLists: Type.Array(EvidenceListSchema),
|
|
25
|
+
nextQueries: Type.Array(Type.String()),
|
|
26
|
+
notes: Type.Array(Type.String()),
|
|
27
|
+
message: Type.Optional(Type.String()),
|
|
28
|
+
file: Type.Optional(Type.String()),
|
|
29
|
+
requestedKind: Type.Optional(Type.String()),
|
|
30
|
+
unknownNestingCount: Type.Optional(Type.Integer()),
|
|
31
|
+
discoveryProvenance: Type.Optional(Type.Array(StringEnum(["semantic", "structural"]))),
|
|
32
|
+
partialReason: Type.Optional(Type.Union([Type.String(), Type.Null()])),
|
|
33
|
+
errorRanges: Type.Optional(Type.Array(RecoveryRangeSchema)),
|
|
34
|
+
},
|
|
35
|
+
{ additionalProperties: false },
|
|
36
|
+
);
|
|
37
|
+
|
|
38
|
+
/** Project caller-visible targets without internal store identity or fingerprints. */
|
|
39
|
+
export function structuredResolveResult(
|
|
40
|
+
data: ResolveDetails,
|
|
41
|
+
outcome: Exclude<TargetWorkflowOutcome, { kind: "unavailable" }>,
|
|
42
|
+
): Static<typeof ResolveOutputSchema> {
|
|
43
|
+
return {
|
|
44
|
+
kind: outcome.kind,
|
|
45
|
+
confidence: data.confidence,
|
|
46
|
+
targets: [
|
|
47
|
+
...data.targets.map((entry) => ({
|
|
48
|
+
handle: entry.targetId,
|
|
49
|
+
name: entry.name,
|
|
50
|
+
kind: entry.kind,
|
|
51
|
+
...(entry.nativeKind === undefined ? {} : { nativeKind: entry.nativeKind }),
|
|
52
|
+
file: entry.file,
|
|
53
|
+
line: entry.displayLine,
|
|
54
|
+
character: entry.displayCharacter,
|
|
55
|
+
anchorKind: entry.anchorKind,
|
|
56
|
+
container: entry.container,
|
|
57
|
+
confidence: entry.confidence,
|
|
58
|
+
provenance: [...entry.provenance],
|
|
59
|
+
...(entry.resolution
|
|
60
|
+
? {
|
|
61
|
+
resolution: {
|
|
62
|
+
requested: { ...entry.resolution.requested },
|
|
63
|
+
resolved: { ...entry.resolution.resolved },
|
|
64
|
+
snapped: entry.resolution.snapped,
|
|
65
|
+
source: entry.resolution.source,
|
|
66
|
+
},
|
|
67
|
+
}
|
|
68
|
+
: {}),
|
|
69
|
+
})),
|
|
70
|
+
...(data.candidates ?? []).map((candidate) => ({
|
|
71
|
+
handle: candidate.targetId,
|
|
72
|
+
name: candidate.name,
|
|
73
|
+
kind: candidate.kind,
|
|
74
|
+
file: candidate.file,
|
|
75
|
+
line: candidate.line,
|
|
76
|
+
character: candidate.character,
|
|
77
|
+
anchorKind: candidate.anchorKind,
|
|
78
|
+
container: candidate.container,
|
|
79
|
+
})),
|
|
80
|
+
],
|
|
81
|
+
evidenceLists: (data.evidenceLists ?? []).map((evidence) => ({ ...evidence })),
|
|
82
|
+
nextQueries: data.nextQueries,
|
|
83
|
+
notes: outcome.kind === "resolved" ? [...outcome.notes] : [],
|
|
84
|
+
...(data.message === undefined ? {} : { message: data.message }),
|
|
85
|
+
...(data.groupFile === undefined ? {} : { file: data.groupFile }),
|
|
86
|
+
...(data.requestedKind === undefined ? {} : { requestedKind: data.requestedKind }),
|
|
87
|
+
...(data.groupUnknownNestingCount === undefined
|
|
88
|
+
? {}
|
|
89
|
+
: { unknownNestingCount: data.groupUnknownNestingCount }),
|
|
90
|
+
...(data.groupDiscoveryProvenance === undefined
|
|
91
|
+
? {}
|
|
92
|
+
: { discoveryProvenance: [...data.groupDiscoveryProvenance] }),
|
|
93
|
+
...(data.groupPartialReason === undefined ? {} : { partialReason: data.groupPartialReason }),
|
|
94
|
+
...(data.groupErrorRanges === undefined
|
|
95
|
+
? {}
|
|
96
|
+
: {
|
|
97
|
+
errorRanges: data.groupErrorRanges.map((range) => ({
|
|
98
|
+
start: { ...range.start },
|
|
99
|
+
end: { ...range.end },
|
|
100
|
+
})),
|
|
101
|
+
}),
|
|
102
|
+
};
|
|
103
|
+
}
|
|
@@ -52,12 +52,13 @@ import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
|
|
|
52
52
|
import { tmpdir } from "node:os";
|
|
53
53
|
import { join } from "node:path";
|
|
54
54
|
import type { CodeIntelResult } from "../../types/index.ts";
|
|
55
|
+
import { boundModelContent } from "../result/model-budget.ts";
|
|
55
56
|
import type { ToolOutputTruncationDetails } from "../result/types.ts";
|
|
56
57
|
|
|
57
58
|
/**
|
|
58
59
|
* Apply the canonical output bound to one assembled code-tool result:
|
|
59
|
-
*
|
|
60
|
-
*
|
|
60
|
+
* bound the inline preview before applying PI safety limits, and spill the
|
|
61
|
+
* original content when either bound or the human display omits evidence. A display-only
|
|
61
62
|
* continuation does not add text to model content. File failure is fatal only
|
|
62
63
|
* when model content would otherwise be lost.
|
|
63
64
|
*/
|
|
@@ -69,10 +70,13 @@ export function boundCodeToolResult(
|
|
|
69
70
|
const withTruncation = (truncation: ToolOutputTruncationDetails) =>
|
|
70
71
|
details ? { ...details, truncation } : details;
|
|
71
72
|
|
|
72
|
-
const
|
|
73
|
+
const preview = boundModelContent(content, details);
|
|
74
|
+
const safety = truncateToolContent(preview.text, {
|
|
73
75
|
maxLines: options.maxLines,
|
|
74
76
|
maxBytes: options.maxBytes,
|
|
75
77
|
});
|
|
78
|
+
const { text } = safety;
|
|
79
|
+
const truncated = preview.truncated || safety.truncated;
|
|
76
80
|
const displayTruncated = details?.truncation?.displayTruncated === true;
|
|
77
81
|
const truncation = { truncated, ...(displayTruncated ? { displayTruncated } : {}) };
|
|
78
82
|
if ((truncated || displayTruncated) && content.length > 0) {
|
|
@@ -82,7 +86,11 @@ export function boundCodeToolResult(
|
|
|
82
86
|
content: [
|
|
83
87
|
{
|
|
84
88
|
type: "text" as const,
|
|
85
|
-
text: truncated
|
|
89
|
+
text: preview.truncated
|
|
90
|
+
? `_Full output saved to: \`${spillPath}\`_\n\n${text}`
|
|
91
|
+
: truncated
|
|
92
|
+
? `${text}\n_Full output saved to: \`${spillPath}\`_`
|
|
93
|
+
: text,
|
|
86
94
|
},
|
|
87
95
|
],
|
|
88
96
|
details: withTruncation({ ...truncation, fullOutputPath: spillPath }),
|
package/src/tool/register.ts
CHANGED
|
@@ -105,6 +105,7 @@ export function registerCodeIntelligenceTools(
|
|
|
105
105
|
promptSnippet: surface.promptSnippet,
|
|
106
106
|
promptGuidelines: surface.promptGuidelines,
|
|
107
107
|
parameters: spec.parameters,
|
|
108
|
+
outputSchema: spec.outputSchema,
|
|
108
109
|
// biome-ignore lint/complexity/useMaxParams: pi ToolDefinition.execute signature
|
|
109
110
|
execute: async (toolCallId, params, signal, onUpdate, ctx: ExtensionContext) => {
|
|
110
111
|
const operationId = createDebugOperationId(operationSecret, toolCallId);
|
|
@@ -115,7 +116,7 @@ export function registerCodeIntelligenceTools(
|
|
|
115
116
|
try {
|
|
116
117
|
const session = getOrCreateSession(ctx.cwd);
|
|
117
118
|
session.setProjectTrusted(ctx.isProjectTrusted());
|
|
118
|
-
const { content, details } = await spec.run(params, {
|
|
119
|
+
const { content, details, structuredContent } = await spec.run(params, {
|
|
119
120
|
cwd: ctx.cwd,
|
|
120
121
|
operationId,
|
|
121
122
|
signal,
|
|
@@ -131,11 +132,14 @@ export function registerCodeIntelligenceTools(
|
|
|
131
132
|
outcome: "completed",
|
|
132
133
|
});
|
|
133
134
|
reportWorkspaceBudget(ctx, details?.budgetWarning, operationId);
|
|
134
|
-
return
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
135
|
+
return {
|
|
136
|
+
...boundCodeToolResult(content, details, {
|
|
137
|
+
toolName: spec.name,
|
|
138
|
+
maxLines: spec.maxLines,
|
|
139
|
+
maxBytes: spec.maxBytes,
|
|
140
|
+
}),
|
|
141
|
+
...(structuredContent === undefined ? {} : { structuredContent }),
|
|
142
|
+
};
|
|
139
143
|
} catch (error) {
|
|
140
144
|
const outcome = terminalCodeOperationOutcome(error, signal);
|
|
141
145
|
recordCodeWorkflowTiming(workflowTimer, operationId, spec.name, {
|
|
@@ -18,6 +18,8 @@ export interface ToolDisplaySectionInput<T> {
|
|
|
18
18
|
/** Provider explanation for incomplete collection, when available. */
|
|
19
19
|
partialMessage?: string;
|
|
20
20
|
maxItems?: number;
|
|
21
|
+
/** Explicit content-count meaning when display rows are not individual Evidence atoms. */
|
|
22
|
+
preview?: ToolDisplaySection["preview"];
|
|
21
23
|
}
|
|
22
24
|
|
|
23
25
|
/** Build a bounded, serializable TUI section from collected facts. */
|
|
@@ -45,6 +47,7 @@ export function createToolDisplaySection<T>(input: ToolDisplaySectionInput<T>):
|
|
|
45
47
|
omittedCount,
|
|
46
48
|
partialReason: input.partialReason ?? null,
|
|
47
49
|
...(input.partialMessage === undefined ? {} : { partialMessage: input.partialMessage }),
|
|
50
|
+
...(input.preview ? { preview: { ...input.preview } } : {}),
|
|
48
51
|
};
|
|
49
52
|
}
|
|
50
53
|
|
|
@@ -81,6 +84,7 @@ export function readToolDisplaySections(value: unknown): ToolDisplaySection[] {
|
|
|
81
84
|
) {
|
|
82
85
|
return [];
|
|
83
86
|
}
|
|
87
|
+
const preview = readPreview(record.preview);
|
|
84
88
|
return [
|
|
85
89
|
{
|
|
86
90
|
key: record.key,
|
|
@@ -95,11 +99,24 @@ export function readToolDisplaySections(value: unknown): ToolDisplaySection[] {
|
|
|
95
99
|
...(typeof record.partialMessage === "string"
|
|
96
100
|
? { partialMessage: record.partialMessage }
|
|
97
101
|
: {}),
|
|
102
|
+
...(preview ? { preview } : {}),
|
|
98
103
|
},
|
|
99
104
|
];
|
|
100
105
|
});
|
|
101
106
|
}
|
|
102
107
|
|
|
108
|
+
function readPreview(value: unknown): ToolDisplaySection["preview"] {
|
|
109
|
+
if (typeof value !== "object" || value === null || Array.isArray(value)) return undefined;
|
|
110
|
+
const record = value as Record<string, unknown>;
|
|
111
|
+
if (record.unit !== "group" && record.unit !== "block") return undefined;
|
|
112
|
+
return {
|
|
113
|
+
unit: record.unit,
|
|
114
|
+
...(typeof record.evidenceSummary === "string"
|
|
115
|
+
? { evidenceSummary: truncateDisplayText(record.evidenceSummary) }
|
|
116
|
+
: {}),
|
|
117
|
+
};
|
|
118
|
+
}
|
|
119
|
+
|
|
103
120
|
function isCount(value: unknown): value is number {
|
|
104
121
|
return typeof value === "number" && Number.isInteger(value) && value >= 0;
|
|
105
122
|
}
|
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
import type { CodeIntelResult } from "../../types/index.ts";
|
|
2
|
+
import { formatSemanticHealthState } from "../code_health/semantic-state.ts";
|
|
3
|
+
import type { HealthDetails, SearchDetails } from "./types.ts";
|
|
4
|
+
|
|
5
|
+
/** Economic inline bound (approximately 2,000 tokens), independent of Pi's safety limit. */
|
|
6
|
+
export const MODEL_OUTPUT_MAX_CHARACTERS = 8_000;
|
|
7
|
+
const NOTICE_RESERVE = 1_024;
|
|
8
|
+
const MAX_FACT_CHARACTERS = 4_000;
|
|
9
|
+
|
|
10
|
+
type Details = NonNullable<CodeIntelResult["details"]>;
|
|
11
|
+
|
|
12
|
+
/** Preserve collection state and diagnostic snippets before a bounded, explicitly incomplete excerpt. */
|
|
13
|
+
export function boundModelContent(
|
|
14
|
+
content: string,
|
|
15
|
+
details: CodeIntelResult["details"],
|
|
16
|
+
): {
|
|
17
|
+
text: string;
|
|
18
|
+
truncated: boolean;
|
|
19
|
+
} {
|
|
20
|
+
if (details?.modelBudgetManaged || content.length <= MODEL_OUTPUT_MAX_CHARACTERS) {
|
|
21
|
+
return { text: content, truncated: false };
|
|
22
|
+
}
|
|
23
|
+
const lines = [
|
|
24
|
+
"[truncated: model preview; read the saved output for full returned evidence.]",
|
|
25
|
+
"Counts describe the returned result, not this shortened preview.",
|
|
26
|
+
];
|
|
27
|
+
// Reserve diagnostic space before verbose limitations can exhaust the summary.
|
|
28
|
+
// Single-line facts also keep Pi's later line bound from discarding late sections.
|
|
29
|
+
if (details) lines.push(...diagnosticFacts(details).map((fact) => shortFact(fact, 320)));
|
|
30
|
+
const facts = details ? summary(details) : [];
|
|
31
|
+
for (let index = 0; index < facts.length; index++) {
|
|
32
|
+
const fact = shortFact(facts[index], 256);
|
|
33
|
+
if (lines.join("\n").length + fact.length > MAX_FACT_CHARACTERS) {
|
|
34
|
+
lines.push(`Additional summary lines omitted: ${facts.length - index}.`);
|
|
35
|
+
break;
|
|
36
|
+
}
|
|
37
|
+
lines.push(fact);
|
|
38
|
+
}
|
|
39
|
+
const header = `${lines.join("\n")}\n\n## Incomplete text excerpt\n`;
|
|
40
|
+
const remaining = MODEL_OUTPUT_MAX_CHARACTERS - NOTICE_RESERVE - header.length;
|
|
41
|
+
return { text: `${header}${shorten(content, remaining)}`, truncated: true };
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
function shorten(value: string, limit: number): string {
|
|
45
|
+
if (value.length <= limit) return value;
|
|
46
|
+
let end = Math.max(0, limit - 15);
|
|
47
|
+
const unit = value.charCodeAt(end - 1);
|
|
48
|
+
if (unit >= 0xd800 && unit <= 0xdbff) end--;
|
|
49
|
+
return `${value.slice(0, end)}… [shortened]`;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
function shortFact(value: string, limit: number): string {
|
|
53
|
+
return shorten(value.replace(/\s+/gu, " "), limit);
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
function diagnosticFacts(details: Details): string[] {
|
|
57
|
+
if (details.type === "inspect") {
|
|
58
|
+
return (details.data.diagnostics ?? [])
|
|
59
|
+
.slice(0, 3)
|
|
60
|
+
.map(
|
|
61
|
+
(diagnostic) =>
|
|
62
|
+
`Diagnostic L${diagnostic.line}:${diagnostic.character} (severity=${diagnostic.severity}): ${diagnostic.message}`,
|
|
63
|
+
);
|
|
64
|
+
}
|
|
65
|
+
if (details.type === "health") {
|
|
66
|
+
const snippets: string[] = [];
|
|
67
|
+
for (const entry of details.data.diagnosticObservation.entries) {
|
|
68
|
+
for (const message of entry.messages ?? []) {
|
|
69
|
+
snippets.push(`${entry.file}:${message.line} ${message.severity}: ${message.message}`);
|
|
70
|
+
if (snippets.length === 3) return snippets;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
return snippets;
|
|
74
|
+
}
|
|
75
|
+
return [];
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
function summary(details: Details): string[] {
|
|
79
|
+
const data = details.data;
|
|
80
|
+
return [
|
|
81
|
+
`Result status: ${details.status ?? "completed"}.`,
|
|
82
|
+
...(details.message ? [details.message] : []),
|
|
83
|
+
...("confidence" in data ? [`Confidence: ${data.confidence}.`] : []),
|
|
84
|
+
...(data.evidenceLists ?? []).map(
|
|
85
|
+
(list) =>
|
|
86
|
+
`${list.key}: returned=${list.shownCount}, total=${list.totalCount ?? "unknown"}, cap-omitted=${list.omittedCount ?? "unknown"}; partial=${list.partialReason ?? "none"}${list.invalidLocationCount ? `; invalid locations=${list.invalidLocationCount}` : ""}${list.partialMessage ? `; ${list.partialMessage}` : ""}`,
|
|
87
|
+
),
|
|
88
|
+
...sectionFacts(details),
|
|
89
|
+
];
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
function sectionFacts(details: Details): string[] {
|
|
93
|
+
switch (details.type) {
|
|
94
|
+
case "inspect": {
|
|
95
|
+
const data = details.data;
|
|
96
|
+
return [
|
|
97
|
+
`Focus: ${data.focusTarget}; diagnostics window: ${data.diagnosticWindow ? `L${data.diagnosticWindow.startLine}–L${data.diagnosticWindow.endLine}` : "unavailable"}.`,
|
|
98
|
+
...data.sections.map(
|
|
99
|
+
(section) =>
|
|
100
|
+
`${section.key}: ${section.status}${section.reason ? ` — ${section.reason}` : ""}${section.recovery ? `; recovered syntax in ${section.recovery.file}` : ""}`,
|
|
101
|
+
),
|
|
102
|
+
];
|
|
103
|
+
}
|
|
104
|
+
case "graph":
|
|
105
|
+
return [
|
|
106
|
+
`Target: ${details.data.targetName} — ${details.data.targetFile}.`,
|
|
107
|
+
...details.data.sections.map(
|
|
108
|
+
(section) =>
|
|
109
|
+
`${section.rel} (${section.source}): ${section.status}; external=${section.externalCount}${section.depth ? `; depth=${section.depth}` : ""}${section.message ? `; ${section.message}` : ""}${section.recovery ? `; syntax recovery: ${section.recovery.reason}` : ""}`,
|
|
110
|
+
),
|
|
111
|
+
"Callees are written source expressions, not resolved symbol identities; direct depth excludes nested scopes.",
|
|
112
|
+
];
|
|
113
|
+
case "resolve":
|
|
114
|
+
return [
|
|
115
|
+
`${details.data.resultKind}: ${details.data.targetCount} targets; ${details.data.omittedCount} cap omissions.`,
|
|
116
|
+
...(details.data.groupPartialReason
|
|
117
|
+
? [`Partial discovery: ${details.data.groupPartialReason}`]
|
|
118
|
+
: []),
|
|
119
|
+
...details.data.targets
|
|
120
|
+
.slice(0, 3)
|
|
121
|
+
.map(
|
|
122
|
+
(target) =>
|
|
123
|
+
`${target.targetId}: ${target.name ?? "anonymous"} ${target.file}:${target.displayLine}:${target.displayCharacter}; ${target.anchorKind} anchor; confidence=${target.confidence}; provenance=${target.provenance.join("+")}`,
|
|
124
|
+
),
|
|
125
|
+
];
|
|
126
|
+
case "search":
|
|
127
|
+
return searchFacts(details.data);
|
|
128
|
+
case "health":
|
|
129
|
+
return healthFacts(details.data);
|
|
130
|
+
case "context":
|
|
131
|
+
return [
|
|
132
|
+
`Focus: ${details.data.focusTarget ?? "workspace"}.`,
|
|
133
|
+
...(details.data.sections ?? []).map(
|
|
134
|
+
(section) =>
|
|
135
|
+
`${section.title}: ${section.status}${section.reason ? ` — ${section.reason}` : ""}`,
|
|
136
|
+
),
|
|
137
|
+
];
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
function searchFacts(data: SearchDetails): string[] {
|
|
142
|
+
const scan = data.scan;
|
|
143
|
+
const lines = [`Search scope: ${data.scope ?? "workspace"}.`];
|
|
144
|
+
if (scan) {
|
|
145
|
+
lines.push(
|
|
146
|
+
`AST universe: ${scan.universe}; complete=${scan.complete}; eligible=${scan.eligibleFileCount ?? "unknown"}; analyzed=${scan.analyzedFileCount}.`,
|
|
147
|
+
...scan.limitations.map(
|
|
148
|
+
(limit) =>
|
|
149
|
+
`Scan limitation: ${limit.reason}; paths=${limit.pathCount ?? "unknown"}${limit.reason === "unreadable-path" && limit.examples.length ? `; examples=${limit.examples.join(", ")}` : ""}.`,
|
|
150
|
+
),
|
|
151
|
+
...(scan.exclusions.length
|
|
152
|
+
? ["Policy skips are traversal decisions; other explicit scopes may include these paths."]
|
|
153
|
+
: []),
|
|
154
|
+
...scan.exclusions.map(
|
|
155
|
+
(exclusion) =>
|
|
156
|
+
`Policy skip: ${exclusion.reason}; paths=${exclusion.pathCount}; scope=${exclusion.scopeRoot}.`,
|
|
157
|
+
),
|
|
158
|
+
);
|
|
159
|
+
}
|
|
160
|
+
if (data.automaticPathExclusion)
|
|
161
|
+
lines.push(`Automatic path exclusions: ${data.automaticPathExclusion.excludedCount}.`);
|
|
162
|
+
if (data.structuralFailures?.length) {
|
|
163
|
+
lines.push(
|
|
164
|
+
`Structural failures: ${data.structuralFailures.length}.`,
|
|
165
|
+
...data.structuralFailures.slice(0, 3).map((failure) => `${failure.file}: ${failure.reason}`),
|
|
166
|
+
);
|
|
167
|
+
}
|
|
168
|
+
return lines;
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
function healthFacts(data: HealthDetails): string[] {
|
|
172
|
+
const observation = data.diagnosticObservation;
|
|
173
|
+
const lines = [
|
|
174
|
+
`LSP: ${formatSemanticHealthState(data.semanticState)}; structural: ${data.structuralStatus ?? String(data.structuralAvailable)}.`,
|
|
175
|
+
`Server inventory is workspace-wide: ${data.serverCount}; routes: ${JSON.stringify(data.serverRouteStatusCounts)}.`,
|
|
176
|
+
`Refresh: ${data.refresh.kind}. Maintenance recovery is separate from diagnostic confirmation.`,
|
|
177
|
+
];
|
|
178
|
+
if ("reason" in data.refresh) lines.push(`Refresh reason: ${data.refresh.reason}`);
|
|
179
|
+
if (observation.kind !== "not-requested") {
|
|
180
|
+
const scope = observation.scope;
|
|
181
|
+
lines.push(
|
|
182
|
+
`Diagnostics: ${observation.kind}; ${scope.kind === "file" ? `file=${scope.path}` : `tracked-file snapshot; filter=${scope.filter ?? "none"}; not workspace-wide verification`}.`,
|
|
183
|
+
`Diagnostic coverage: requested=${observation.evidence.requested}, confirmed=${observation.evidence.confirmed}, unconfirmed=${observation.evidence.unconfirmed}, failed=${observation.evidence.failed}, removed=${observation.evidence.removed}.`,
|
|
184
|
+
);
|
|
185
|
+
if ("reason" in observation) lines.push(`Diagnostic limitation: ${observation.reason}`);
|
|
186
|
+
if (observation.scopeStatus)
|
|
187
|
+
lines.push(`File scope status: ${JSON.stringify(observation.scopeStatus)}`);
|
|
188
|
+
}
|
|
189
|
+
if (data.capabilityWarnings?.hasWarnings)
|
|
190
|
+
lines.push(
|
|
191
|
+
`Capability warnings: ${data.capabilityWarnings.warnings.length}.`,
|
|
192
|
+
...data.capabilityWarnings.warnings.slice(0, 3).map((warning) => warning.message),
|
|
193
|
+
);
|
|
194
|
+
return lines;
|
|
195
|
+
}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import { StringEnum } from "@earendil-works/pi-ai";
|
|
2
|
+
import { Type } from "typebox";
|
|
3
|
+
|
|
4
|
+
/** Collection confidence, independent of result completeness. */
|
|
5
|
+
export const ConfidenceSchema = StringEnum(["semantic", "structural", "heuristic", "unavailable"]);
|
|
6
|
+
|
|
7
|
+
/** Canonical evidence counts; null totals mean collection could not establish completeness. */
|
|
8
|
+
export const EvidenceListSchema = Type.Object(
|
|
9
|
+
{
|
|
10
|
+
key: Type.String(),
|
|
11
|
+
totalCount: Type.Union([Type.Integer(), Type.Null()]),
|
|
12
|
+
shownCount: Type.Integer(),
|
|
13
|
+
omittedCount: Type.Union([Type.Integer(), Type.Null()]),
|
|
14
|
+
partialReason: Type.Union([Type.String(), Type.Null()]),
|
|
15
|
+
partialMessage: Type.Optional(Type.String()),
|
|
16
|
+
invalidLocationCount: Type.Optional(Type.Integer()),
|
|
17
|
+
},
|
|
18
|
+
{ additionalProperties: false },
|
|
19
|
+
);
|
|
20
|
+
|
|
21
|
+
/** Provider recovery ranges use zero-based UTF-16 positions. */
|
|
22
|
+
export const RecoveryRangeSchema = Type.Object({
|
|
23
|
+
start: Type.Object({ line: Type.Integer(), character: Type.Integer() }),
|
|
24
|
+
end: Type.Object({ line: Type.Integer(), character: Type.Integer() }),
|
|
25
|
+
});
|
|
26
|
+
|
|
27
|
+
/** Reusable target handle with one-based UTF-16 coordinates, never a mutable store entry. */
|
|
28
|
+
export const NavigationTargetSchema = Type.Object(
|
|
29
|
+
{
|
|
30
|
+
handle: Type.String(),
|
|
31
|
+
name: Type.Union([Type.String(), Type.Null()]),
|
|
32
|
+
kind: Type.Union([Type.String(), Type.Null()]),
|
|
33
|
+
nativeKind: Type.Optional(Type.String()),
|
|
34
|
+
file: Type.String(),
|
|
35
|
+
line: Type.Integer(),
|
|
36
|
+
character: Type.Integer(),
|
|
37
|
+
anchorKind: StringEnum(["name", "declaration"]),
|
|
38
|
+
container: Type.Optional(Type.Union([Type.String(), Type.Null()])),
|
|
39
|
+
confidence: Type.Optional(ConfidenceSchema),
|
|
40
|
+
provenance: Type.Optional(Type.Array(StringEnum(["semantic", "structural"]))),
|
|
41
|
+
resolution: Type.Optional(
|
|
42
|
+
Type.Object({
|
|
43
|
+
requested: Type.Object({ line: Type.Integer(), character: Type.Integer() }),
|
|
44
|
+
resolved: Type.Object({ line: Type.Integer(), character: Type.Integer() }),
|
|
45
|
+
snapped: Type.Boolean(),
|
|
46
|
+
source: StringEnum(["semantic", "structural", "structural-identifier"]),
|
|
47
|
+
}),
|
|
48
|
+
),
|
|
49
|
+
},
|
|
50
|
+
{ additionalProperties: false },
|
|
51
|
+
);
|
|
52
|
+
|
|
53
|
+
/** Source ranges suggested for a subsequent read, not additional code evidence. */
|
|
54
|
+
export const ReadNextSchema = Type.Object(
|
|
55
|
+
{
|
|
56
|
+
file: Type.String(),
|
|
57
|
+
startLine: Type.Integer(),
|
|
58
|
+
endLine: Type.Integer(),
|
|
59
|
+
reason: Type.String(),
|
|
60
|
+
},
|
|
61
|
+
{ additionalProperties: false },
|
|
62
|
+
);
|