@mrclrchtr/supi-code-intelligence 11.1.0 → 11.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (199) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/README.md +41 -6
  3. package/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  4. package/node_modules/@mrclrchtr/supi-code-runtime/src/capability/types.ts +3 -1
  5. package/node_modules/@mrclrchtr/supi-code-runtime/src/query-result.ts +9 -0
  6. package/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  7. package/node_modules/@mrclrchtr/supi-core/src/child-web-tools.ts +110 -0
  8. package/node_modules/@mrclrchtr/supi-core/src/session.ts +11 -0
  9. package/node_modules/@mrclrchtr/supi-lsp/README.md +81 -7
  10. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  11. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/capability/types.ts +3 -1
  12. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/query-result.ts +9 -0
  13. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  14. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/child-web-tools.ts +110 -0
  15. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/session.ts +11 -0
  16. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/LICENSE +15 -0
  17. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/README.md +680 -0
  18. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/bin/semver.js +195 -0
  19. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/classes/comparator.js +143 -0
  20. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/classes/index.js +7 -0
  21. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/classes/range.js +577 -0
  22. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/classes/semver.js +350 -0
  23. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/clean.js +8 -0
  24. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/cmp.js +54 -0
  25. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/coerce.js +62 -0
  26. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/compare-build.js +9 -0
  27. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/compare-loose.js +5 -0
  28. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/compare.js +7 -0
  29. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/diff.js +60 -0
  30. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/eq.js +5 -0
  31. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/gt.js +5 -0
  32. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/gte.js +5 -0
  33. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/inc.js +21 -0
  34. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/lt.js +5 -0
  35. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/lte.js +5 -0
  36. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/major.js +5 -0
  37. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/minor.js +5 -0
  38. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/neq.js +5 -0
  39. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/parse.js +18 -0
  40. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/patch.js +5 -0
  41. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/prerelease.js +8 -0
  42. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/rcompare.js +5 -0
  43. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/rsort.js +5 -0
  44. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/satisfies.js +12 -0
  45. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/sort.js +5 -0
  46. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/truncate.js +48 -0
  47. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/functions/valid.js +8 -0
  48. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/index.js +93 -0
  49. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/internal/constants.js +37 -0
  50. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/internal/debug.js +11 -0
  51. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/internal/identifiers.js +29 -0
  52. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/internal/lrucache.js +42 -0
  53. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/internal/parse-options.js +17 -0
  54. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/internal/re.js +223 -0
  55. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/package.json +78 -0
  56. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/preload.js +4 -0
  57. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/range.bnf +17 -0
  58. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/gtr.js +6 -0
  59. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/intersects.js +9 -0
  60. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/ltr.js +6 -0
  61. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/max-satisfying.js +27 -0
  62. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/min-satisfying.js +26 -0
  63. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/min-version.js +63 -0
  64. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/outside.js +82 -0
  65. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/simplify.js +49 -0
  66. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/subset.js +249 -0
  67. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/to-comparators.js +10 -0
  68. package/node_modules/@mrclrchtr/supi-lsp/node_modules/semver/ranges/valid.js +13 -0
  69. package/node_modules/@mrclrchtr/supi-lsp/package.json +5 -3
  70. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-collection.ts +11 -4
  71. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostics.ts +77 -6
  72. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-input-admission.ts +149 -0
  73. package/node_modules/@mrclrchtr/supi-lsp/src/client/client-typescript-project.ts +40 -0
  74. package/node_modules/@mrclrchtr/supi-lsp/src/client/client.ts +174 -49
  75. package/node_modules/@mrclrchtr/supi-lsp/src/config/config.ts +53 -2
  76. package/node_modules/@mrclrchtr/supi-lsp/src/config/operation-support.ts +19 -4
  77. package/node_modules/@mrclrchtr/supi-lsp/src/config/server-config.ts +22 -0
  78. package/node_modules/@mrclrchtr/supi-lsp/src/config/typescript-launch.ts +276 -0
  79. package/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/evidence.ts +2 -2
  80. package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-project-info.ts +22 -10
  81. package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-workspace-symbol.ts +157 -23
  82. package/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +306 -75
  83. package/node_modules/@mrclrchtr/supi-lsp/src/provider/refactor-planning.ts +4 -3
  84. package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-controller.ts +2 -2
  85. package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +19 -2
  86. package/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-rename.ts +1 -0
  87. package/node_modules/@mrclrchtr/supi-lsp/src/session/scanner.ts +27 -15
  88. package/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +5 -1
  89. package/node_modules/@mrclrchtr/supi-tree-sitter/README.md +2 -2
  90. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  91. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/capability/types.ts +3 -1
  92. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/query-result.ts +9 -0
  93. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  94. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/child-web-tools.ts +110 -0
  95. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/session.ts +11 -0
  96. package/node_modules/@mrclrchtr/supi-tree-sitter/package.json +3 -3
  97. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/tsx/tree-sitter-tsx.wasm +0 -0
  98. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/tsx/tree-sitter-tsx.wasm.json +5 -1
  99. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/typescript/tree-sitter-typescript.wasm +0 -0
  100. package/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/typescript/tree-sitter-typescript.wasm.json +5 -1
  101. package/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/call-sites.ts +40 -25
  102. package/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/callees.ts +2 -0
  103. package/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/call-context.ts +44 -0
  104. package/package.json +6 -5
  105. package/src/analysis/capability/capability-warnings.ts +18 -12
  106. package/src/analysis/health/check.ts +115 -0
  107. package/src/analysis/health/diagnostics.ts +3 -0
  108. package/src/analysis/health/file-scope.ts +2 -3
  109. package/src/analysis/health/semantic-state.ts +38 -0
  110. package/src/analysis/health/server-status.ts +14 -2
  111. package/src/analysis/health/signals.ts +2 -0
  112. package/src/analysis/health/status.ts +82 -0
  113. package/src/analysis/refactor/apply.ts +17 -8
  114. package/src/analysis/search/exclusions.ts +47 -0
  115. package/src/analysis/search/paths.ts +32 -9
  116. package/src/analysis/target/anchored-structural.ts +3 -8
  117. package/src/analysis/target/anchored.ts +4 -20
  118. package/src/analysis/target/identity.ts +1 -1
  119. package/src/analysis/target/latex-label-container.ts +6 -6
  120. package/src/analysis/target/latex-section-anchor.ts +6 -6
  121. package/src/analysis/target/resolution.ts +18 -0
  122. package/src/analysis/target/symbol.ts +39 -11
  123. package/src/analysis/target/types.ts +6 -1
  124. package/src/extension.ts +17 -11
  125. package/src/session/graph/collect.ts +1 -10
  126. package/src/session/graph-types.ts +2 -0
  127. package/src/session/graph-workflow.ts +1 -0
  128. package/src/session/health-types.ts +7 -0
  129. package/src/session/health-workflow.ts +8 -43
  130. package/src/session/inspect/collect.ts +8 -2
  131. package/src/session/inspect/file-point.ts +2 -3
  132. package/src/session/inspect-workflow.ts +1 -1
  133. package/src/session/orientation/collect.ts +184 -20
  134. package/src/session/orientation/context-facts.ts +27 -2
  135. package/src/session/orientation/context-sections.ts +49 -3
  136. package/src/session/orientation/facts.ts +132 -0
  137. package/src/session/orientation/gather.ts +98 -11
  138. package/src/session/orientation/workspace-context.ts +16 -6
  139. package/src/session/orientation-types.ts +8 -0
  140. package/src/session/orientation-workflow.ts +20 -6
  141. package/src/session/refactor-identity.ts +76 -0
  142. package/src/session/refactor-plans.ts +5 -2
  143. package/src/session/refactor-workflow.ts +15 -17
  144. package/src/session/target-store.ts +3 -18
  145. package/src/session/target-workflow.ts +33 -16
  146. package/src/substrate/lsp/recovery.ts +5 -5
  147. package/src/tool/code_find/guidance.ts +1 -1
  148. package/src/tool/code_find/render.ts +8 -4
  149. package/src/tool/code_find/result.ts +78 -6
  150. package/src/tool/code_find/spec.ts +4 -3
  151. package/src/tool/code_find/structured.ts +25 -9
  152. package/src/tool/code_graph/details.ts +1 -0
  153. package/src/tool/code_graph/display.ts +1 -1
  154. package/src/tool/code_graph/guidance.ts +1 -1
  155. package/src/tool/code_graph/markdown.ts +11 -6
  156. package/src/tool/code_graph/read-next.ts +38 -9
  157. package/src/tool/code_graph/reference-selection.ts +30 -0
  158. package/src/tool/code_graph/result.ts +25 -118
  159. package/src/tool/code_graph/section.ts +133 -0
  160. package/src/tool/code_graph/spec.ts +3 -3
  161. package/src/tool/code_graph/structured.ts +17 -6
  162. package/src/tool/code_health/display-paths.ts +92 -0
  163. package/src/tool/code_health/file-scope-markdown.ts +3 -2
  164. package/src/tool/code_health/markdown.ts +12 -2
  165. package/src/tool/code_health/result.ts +18 -3
  166. package/src/tool/code_health/spec.ts +5 -3
  167. package/src/tool/code_health/structured-schema.ts +250 -0
  168. package/src/tool/code_health/structured.ts +256 -0
  169. package/src/tool/code_inspect/result.ts +11 -5
  170. package/src/tool/code_inspect/spec.ts +7 -1
  171. package/src/tool/code_inspect/structured.ts +231 -0
  172. package/src/tool/code_orientation/execute.ts +1 -1
  173. package/src/tool/code_orientation/result.ts +31 -8
  174. package/src/tool/code_orientation/spec.ts +2 -0
  175. package/src/tool/code_orientation/structured-schema.ts +617 -0
  176. package/src/tool/code_orientation/structured-workspace.ts +194 -0
  177. package/src/tool/code_orientation/structured.ts +189 -0
  178. package/src/tool/code_orientation/workspace-format.ts +2 -5
  179. package/src/tool/code_orientation/workspace-observations.ts +81 -0
  180. package/src/tool/code_orientation/workspace-output.ts +5 -0
  181. package/src/tool/code_orientation/workspace-projects.ts +16 -31
  182. package/src/tool/code_orientation/workspace-sections.ts +46 -32
  183. package/src/tool/code_refactor_apply/execute.ts +1 -1
  184. package/src/tool/code_refactor_apply/result.ts +14 -6
  185. package/src/tool/code_refactor_apply/spec.ts +2 -0
  186. package/src/tool/code_refactor_apply/structured.ts +49 -0
  187. package/src/tool/code_refactor_plan/result.ts +18 -9
  188. package/src/tool/code_refactor_plan/spec.ts +2 -0
  189. package/src/tool/code_refactor_plan/structured.ts +127 -0
  190. package/src/tool/code_resolve/markdown.ts +6 -30
  191. package/src/tool/code_resolve/result.ts +24 -11
  192. package/src/tool/code_resolve/structured.ts +7 -9
  193. package/src/tool/result/refactor.ts +8 -5
  194. package/src/tool/result/structured.ts +8 -5
  195. package/src/tool/result/types.ts +18 -14
  196. package/src/tool/schemas.ts +12 -6
  197. package/src/ui/status-command.ts +147 -322
  198. package/src/ui/status-overlay.ts +584 -421
  199. package/src/ui/status-presentation.ts +108 -0
@@ -29,9 +29,18 @@ export interface CapabilityWarningReport {
29
29
  warnings: CapabilityWarning[];
30
30
  }
31
31
 
32
+ /** Narrow launch-failure evidence accepted from a controller, before extension normalization. */
33
+ interface MissingServerEvidence {
34
+ name: string;
35
+ command: string;
36
+ foundExtensions?: string[];
37
+ failureMessage?: string;
38
+ }
39
+ type NormalizedMissingServerEvidence = MissingServerEvidence & { foundExtensions: string[] };
40
+
32
41
  /** Minimal LSP-controller surface needed to discover missing servers. */
33
42
  export interface CapabilityWarningMissingServerSource {
34
- getMissingServers(): Array<{ name: string; command: string; foundExtensions?: string[] }>;
43
+ getMissingServers(): MissingServerEvidence[];
35
44
  /** Explicit disablement captured with the active LSP configuration snapshot. */
36
45
  getExplicitlyDisabledLanguages?(): readonly string[];
37
46
  /** Configuration validation failure that prevented automatic startup. */
@@ -41,7 +50,7 @@ export interface CapabilityWarningMissingServerSource {
41
50
  /** Current runtime/config facts needed to evaluate Capability Warnings. */
42
51
  export interface CapabilityWarningInput {
43
52
  explicitlyDisabledLanguages: string[];
44
- missingServers: Array<{ name: string; command: string; foundExtensions: string[] }>;
53
+ missingServers: NormalizedMissingServerEvidence[];
45
54
  structuralState: { kind: string; reason?: string };
46
55
  /** Configuration could not be validated for automatic capability work. */
47
56
  configurationError?: string;
@@ -68,9 +77,11 @@ export function evaluateCapabilityWarnings(input: CapabilityWarningInput): Capab
68
77
 
69
78
  for (const server of input.missingServers) {
70
79
  warnings.push({
71
- type: "missing-server",
80
+ type: server.failureMessage ? "configuration-error" : "missing-server",
72
81
  language: server.name,
73
- message: `Cannot start "${server.name}" server — "${server.command}" not found on PATH`,
82
+ message:
83
+ server.failureMessage ??
84
+ `Cannot start "${server.name}" server — "${server.command}" not found on PATH`,
74
85
  detail:
75
86
  server.foundExtensions.length > 0
76
87
  ? `Affected file types: ${server.foundExtensions.join(", ")}`
@@ -157,11 +168,7 @@ export function gatherCapabilityWarningInput(
157
168
  const projectTrusted = options.projectTrusted !== false;
158
169
  const structuralState = getDefaultWorkspaceRuntime().getWorkspace(cwd).structural.state;
159
170
  let explicitlyDisabledLanguages: string[] = [];
160
- let missingServers: Array<{
161
- name: string;
162
- command: string;
163
- foundExtensions: string[];
164
- }> = [];
171
+ let missingServers: NormalizedMissingServerEvidence[] = [];
165
172
  let configurationError: string | undefined;
166
173
 
167
174
  try {
@@ -197,12 +204,11 @@ export function gatherCapabilityWarningInput(
197
204
  };
198
205
  }
199
206
 
200
- function normalizeMissingServers(
201
- raw: Array<{ name: string; command: string; foundExtensions?: string[] }>,
202
- ): Array<{ name: string; command: string; foundExtensions: string[] }> {
207
+ function normalizeMissingServers(raw: MissingServerEvidence[]): NormalizedMissingServerEvidence[] {
203
208
  return raw.map((entry) => ({
204
209
  name: entry.name,
205
210
  command: entry.command,
206
211
  foundExtensions: entry.foundExtensions ?? [],
212
+ ...(entry.failureMessage ? { failureMessage: entry.failureMessage } : {}),
207
213
  }));
208
214
  }
@@ -0,0 +1,115 @@
1
+ import {
2
+ type CodeRequestControl,
3
+ isCodeRequestInterruption,
4
+ throwIfCodeRequestInterrupted,
5
+ } from "@mrclrchtr/supi-code-runtime/api";
6
+ import type {
7
+ BulkTrackFileOutcome,
8
+ DiagnosticEvidenceDocument,
9
+ WorkspaceLspRuntime,
10
+ } from "@mrclrchtr/supi-lsp/api";
11
+ import { collectScopedFileDiagnostics } from "./file-scope.ts";
12
+
13
+ /** Maximum eligible source files selected by one explicit inspector check. */
14
+ export const DIAGNOSTIC_CHECK_BATCH_SIZE = 32;
15
+
16
+ /** One selected source file, including candidates that could not be checked. */
17
+ export interface DiagnosticCheckFile {
18
+ readonly file: string;
19
+ readonly status: DiagnosticEvidenceDocument["status"] | "skipped" | "unavailable";
20
+ readonly reason?: string;
21
+ }
22
+
23
+ /** Bounded check coverage, separate from the runtime's tracked-file snapshot. */
24
+ export interface WorkspaceDiagnosticCheckReport {
25
+ readonly kind: "completed" | "partial";
26
+ readonly files: readonly DiagnosticCheckFile[];
27
+ /** Null when source discovery did not establish a complete inventory. */
28
+ readonly total: number | null;
29
+ readonly startOffset: number;
30
+ /** Continuation within the sorted inventory; zero starts another pass. */
31
+ readonly nextOffset: number;
32
+ readonly remaining: number | null;
33
+ readonly reason?: string;
34
+ }
35
+
36
+ /** Discover policy-eligible sources and request diagnostics for one bounded batch. */
37
+ export async function checkWorkspaceDiagnostics(options: {
38
+ readonly runtime: WorkspaceLspRuntime;
39
+ readonly cwd: string;
40
+ readonly offset: number;
41
+ readonly control: CodeRequestControl;
42
+ }): Promise<WorkspaceDiagnosticCheckReport> {
43
+ const { runtime, cwd, control } = options;
44
+ let total: number | null = null;
45
+ let startOffset = options.offset;
46
+ const files: DiagnosticCheckFile[] = [];
47
+ const report = (
48
+ kind: WorkspaceDiagnosticCheckReport["kind"],
49
+ reason?: string,
50
+ ): WorkspaceDiagnosticCheckReport => {
51
+ const end = startOffset + files.length;
52
+ return {
53
+ kind,
54
+ files,
55
+ total,
56
+ startOffset,
57
+ nextOffset: total !== null && end >= total ? 0 : end,
58
+ remaining: total === null ? null : Math.max(0, total - end),
59
+ ...(reason ? { reason } : {}),
60
+ };
61
+ };
62
+ try {
63
+ throwIfCodeRequestInterrupted(control);
64
+ const inventory = await runtime.scanWorkspaceSources(control);
65
+ throwIfCodeRequestInterrupted(control);
66
+ if (inventory.status !== "complete") {
67
+ return report(
68
+ "partial",
69
+ `Source discovery incomplete: ${inventory.reason} (${inventory.observedFileCount} files observed).`,
70
+ );
71
+ }
72
+ total = inventory.files.length;
73
+ startOffset = options.offset >= 0 && options.offset < total ? options.offset : 0;
74
+ const selected = inventory.files.slice(startOffset, startOffset + DIAGNOSTIC_CHECK_BATCH_SIZE);
75
+ const batch = await runtime.bulkTrackFiles(selected, control);
76
+ for (const outcome of batch.outcomes) {
77
+ throwIfCodeRequestInterrupted(control);
78
+ files.push(await checkFile(outcome, runtime, cwd, control));
79
+ }
80
+ throwIfCodeRequestInterrupted(control);
81
+ return report("completed");
82
+ } catch (error) {
83
+ if (control.signal?.aborted || !isCodeRequestInterruption(error, control)) throw error;
84
+ return report(
85
+ "partial",
86
+ "Check time limit reached; remaining files were not checked. Run Check again to continue.",
87
+ );
88
+ }
89
+ }
90
+
91
+ async function checkFile(
92
+ outcome: BulkTrackFileOutcome,
93
+ runtime: WorkspaceLspRuntime,
94
+ cwd: string,
95
+ control: CodeRequestControl,
96
+ ): Promise<DiagnosticCheckFile> {
97
+ if (outcome.kind === "skipped" || outcome.kind === "unavailable") {
98
+ return { file: outcome.file, status: outcome.kind, reason: outcome.reason };
99
+ }
100
+ const result = await collectScopedFileDiagnostics({
101
+ service: runtime,
102
+ scope: { kind: "file", path: outcome.file },
103
+ cwd,
104
+ requestControl: control,
105
+ });
106
+ if (result.kind === "not-requested")
107
+ throw new Error("Diagnostic check did not request diagnostics.");
108
+ return {
109
+ file: outcome.file,
110
+ status: result.evidence.documents[0]?.status ?? "failed",
111
+ ...(result.kind === "partial" || result.kind === "unavailable"
112
+ ? { reason: result.reason }
113
+ : {}),
114
+ };
115
+ }
@@ -310,6 +310,9 @@ function evidenceIsComplete(
310
310
  }
311
311
 
312
312
  function diagnosticEvidenceReason(evidence: DiagnosticEvidenceSummary): string {
313
+ if (evidence.requested === 0) {
314
+ return "No document-level diagnostic evidence was collected for this scope. An empty result does not establish that the scope is clean. Request diagnostics for an exact file.";
315
+ }
313
316
  let reason = `Diagnostic evidence is partial: ${evidence.requested} requested, ${evidence.confirmed} confirmed, ${evidence.unconfirmed} unconfirmed, ${evidence.failed} failed, ${evidence.removed} removed.`;
314
317
  if (evidence.unconfirmed > 0) {
315
318
  reason += " Unconfirmed documents have no request-based confirmation.";
@@ -26,6 +26,7 @@ import type {
26
26
  HealthDiagnosticObservation,
27
27
  HealthDiagnosticScope,
28
28
  } from "../../session/health-types.ts";
29
+ import { HEALTH_DIAGNOSTIC_MESSAGE_LIMIT } from "../../session/health-types.ts";
29
30
 
30
31
  /** Collect a live per-file diagnostic pull with an applicable config scope decision. */
31
32
  export async function collectScopedFileDiagnostics(options: {
@@ -114,8 +115,6 @@ export function toFileDiagnosticEntries(
114
115
 
115
116
  // ── Message extraction ────────────────────────────────────────────────
116
117
 
117
- const MAX_MESSAGES_PER_FILE = 3;
118
-
119
118
  function extractMessages(
120
119
  diagnostics: ReadonlyArray<Pick<Diagnostic, "severity" | "message" | "source" | "range">>,
121
120
  ): HealthDiagnosticMessage[] {
@@ -125,7 +124,7 @@ function extractMessages(
125
124
  (a, b) => (a.severity ?? 1) - (b.severity ?? 1) || a.range.start.line - b.range.start.line,
126
125
  );
127
126
 
128
- return errorsAndWarnings.slice(0, MAX_MESSAGES_PER_FILE).map((d) => ({
127
+ return errorsAndWarnings.slice(0, HEALTH_DIAGNOSTIC_MESSAGE_LIMIT).map((d) => ({
129
128
  line: d.range.start.line + 1,
130
129
  severity: (d.severity ?? 1) === 1 ? ("error" as const) : ("warning" as const),
131
130
  message: typeof d.message === "string" ? d.message : d.message.value,
@@ -0,0 +1,38 @@
1
+ import type { CapabilityState } from "@mrclrchtr/supi-code-runtime/api";
2
+ import type { ProjectServerInfo, WorkspaceLspRuntimeState } from "@mrclrchtr/supi-lsp/api";
3
+ import type { SemanticHealthState } from "../../session/health-types.ts";
4
+
5
+ /** Derive passive workspace readiness; a runtime owner alone is not a ready server. */
6
+ export function deriveWorkspaceSemanticHealthState(
7
+ lspState: WorkspaceLspRuntimeState,
8
+ capabilityState: CapabilityState,
9
+ servers: readonly Pick<ProjectServerInfo, "status" | "ready">[],
10
+ ): SemanticHealthState {
11
+ if (
12
+ lspState.kind === "ready" &&
13
+ servers.some((server) => server.status === "running" && server.ready)
14
+ ) {
15
+ return { kind: "ready" };
16
+ }
17
+ switch (lspState.kind) {
18
+ case "pending":
19
+ return { kind: "pending", reason: "LSP is starting" };
20
+ case "inactive":
21
+ return { kind: "inactive", reason: "Inactive on the current session branch" };
22
+ case "disabled":
23
+ return { kind: "disabled", reason: "Disabled by configuration" };
24
+ case "unavailable":
25
+ return { kind: "unavailable", reason: lspState.reason };
26
+ case "ready":
27
+ switch (capabilityState.kind) {
28
+ case "inactive":
29
+ return { kind: "inactive", reason: "Inactive on the current session branch" };
30
+ case "disabled":
31
+ return { kind: "disabled", reason: "Disabled by configuration" };
32
+ case "unavailable":
33
+ return { kind: "unavailable", reason: capabilityState.reason };
34
+ default:
35
+ return { kind: "pending", reason: "No active, ready project servers" };
36
+ }
37
+ }
38
+ }
@@ -45,9 +45,13 @@ export function formatProjectServerRouteStatusCounts(
45
45
  return parts.length > 0 ? `workspace routes: ${parts.join(", ")}` : null;
46
46
  }
47
47
 
48
- /** Render an LSP route root relative to its workspace. */
48
+ /** Render observed route roots relatively inside the workspace and absolutely outside, without resolving aliases. */
49
49
  export function formatProjectServerRoot(cwd: string, root: string): string {
50
- const relative = path.relative(cwd, root);
50
+ const absolute = path.resolve(cwd, root);
51
+ const relative = path.relative(cwd, absolute);
52
+ if (relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
53
+ return absolute;
54
+ }
51
55
  return (relative || ".").replaceAll("\\", "/");
52
56
  }
53
57
 
@@ -67,6 +71,14 @@ export function formatProjectServerStatusReason(
67
71
  }
68
72
  }
69
73
 
74
+ /** Render the selected compiler without confusing a wrapper version with its implementation. */
75
+ export function formatProjectServerCompiler(
76
+ selection: ProjectServerInfo["typescript"],
77
+ ): string | null {
78
+ if (!selection) return null;
79
+ return `${selection.backend}: TypeScript ${selection.compilerVersion ?? "(unknown version)"} via ${selection.packageName}${selection.wrapperVersion ? ` (wrapper ${selection.wrapperVersion})` : ""}`;
80
+ }
81
+
70
82
  /** Render operation support without hiding server limits or SuPi limits. */
71
83
  export function formatProjectServerOperationSupport(
72
84
  support: ServerOperationSupportMap | undefined,
@@ -16,6 +16,8 @@ export function collectServers(
16
16
  fileTypes: server.fileTypes,
17
17
  status: server.status,
18
18
  ...(server.statusReason ? { statusReason: server.statusReason } : {}),
19
+ ...(server.typescript ? { typescript: server.typescript } : {}),
20
+ ...(server.failureMessage ? { failureMessage: server.failureMessage } : {}),
19
21
  ready: server.ready,
20
22
  ...(server.operationSupport ? { operationSupport: server.operationSupport } : {}),
21
23
  }));
@@ -0,0 +1,82 @@
1
+ import type { CapabilityState } from "@mrclrchtr/supi-code-runtime/api";
2
+ import type {
3
+ AutomaticLspPathPolicy,
4
+ ProjectServerInfo,
5
+ WorkspaceLspRuntimeState,
6
+ } from "@mrclrchtr/supi-lsp/api";
7
+ import type {
8
+ HealthDiagnosticObservation,
9
+ SemanticHealthState,
10
+ } from "../../session/health-types.ts";
11
+ import {
12
+ type CapabilityWarningMissingServerSource,
13
+ type CapabilityWarningReport,
14
+ evaluateCapabilityWarnings,
15
+ gatherCapabilityWarningInput,
16
+ } from "../capability/capability-warnings.ts";
17
+ import { collectDiagnostics } from "./diagnostics.ts";
18
+ import { deriveWorkspaceSemanticHealthState } from "./semantic-state.ts";
19
+
20
+ /** Passive status facts. No maintenance, recovery, or document tracking is performed. */
21
+ export interface WorkspaceStatusSnapshot {
22
+ readonly workspaceRoot: string;
23
+ readonly servers: readonly ProjectServerInfo[];
24
+ readonly serverInventoryAvailable: boolean;
25
+ readonly diagnostics: HealthDiagnosticObservation;
26
+ readonly capabilities: {
27
+ readonly semantic: SemanticHealthState;
28
+ readonly structural: CapabilityState;
29
+ };
30
+ readonly capabilityWarnings?: CapabilityWarningReport;
31
+ }
32
+
33
+ /** Runtime facts and trusted configuration needed for one passive observation. */
34
+ export interface WorkspaceStatusOptions {
35
+ readonly cwd: string;
36
+ readonly lspState: WorkspaceLspRuntimeState;
37
+ readonly semanticState: CapabilityState;
38
+ readonly structuralState: CapabilityState;
39
+ readonly projectTrusted: boolean;
40
+ readonly homeDir?: string;
41
+ readonly lspController?: CapabilityWarningMissingServerSource | null;
42
+ readonly automaticPathPolicy?: AutomaticLspPathPolicy | null;
43
+ }
44
+
45
+ /** Use the same readiness and diagnostic evidence policy as code_health, without refreshing it. */
46
+ export async function observeWorkspaceStatus(
47
+ options: WorkspaceStatusOptions,
48
+ ): Promise<WorkspaceStatusSnapshot> {
49
+ const { cwd, lspState } = options;
50
+ const runtime = lspState.kind === "ready" ? lspState.runtime : null;
51
+ const servers = runtime?.getProjectServers() ?? [];
52
+ const semantic = deriveWorkspaceSemanticHealthState(lspState, options.semanticState, servers);
53
+ const diagnostics = await collectDiagnostics({
54
+ service: semantic.kind === "ready" ? runtime : null,
55
+ evidenceService:
56
+ lspState.kind === "ready" || lspState.kind === "inactive" ? lspState.runtime : null,
57
+ included: ["diagnostics"],
58
+ scope: { kind: "tracked-files", filter: null },
59
+ cwd,
60
+ unavailableReason: semantic.kind === "ready" ? "Diagnostics unavailable" : semantic.reason,
61
+ });
62
+ const warnings = evaluateCapabilityWarnings(
63
+ gatherCapabilityWarningInput(cwd, options.lspController ?? null, {
64
+ projectTrusted: options.projectTrusted,
65
+ homeDir: options.homeDir,
66
+ automaticPathPolicy: options.automaticPathPolicy ?? undefined,
67
+ }),
68
+ );
69
+ return {
70
+ workspaceRoot: cwd,
71
+ servers,
72
+ serverInventoryAvailable: lspState.kind === "ready" || lspState.kind === "disabled",
73
+ diagnostics: {
74
+ ...diagnostics,
75
+ entries: [...diagnostics.entries].sort(
76
+ (a, b) => b.errors - a.errors || b.warnings - a.warnings || a.file.localeCompare(b.file),
77
+ ),
78
+ },
79
+ capabilities: { semantic, structural: options.structuralState },
80
+ capabilityWarnings: warnings.hasWarnings ? warnings : undefined,
81
+ };
82
+ }
@@ -16,6 +16,7 @@ import { readFileSync, renameSync, rmSync, statSync, writeFileSync } from "node:
16
16
  import { basename, dirname, join } from "node:path";
17
17
  import { withFileMutationQueue } from "@earendil-works/pi-coding-agent";
18
18
  import type { FileEdit, WorkspaceEdit } from "@mrclrchtr/supi-code-runtime/api";
19
+ import { toDisplayPath } from "../search/paths.ts";
19
20
  import { revalidateMutationAuthority } from "./mutation-authority.ts";
20
21
  import { compareCodePositions, createLogicalLineIndex } from "./position.ts";
21
22
  import { validateEditAgainstFiles } from "./safety.ts";
@@ -25,6 +26,8 @@ export type ApplyResult =
25
26
  | { kind: "error"; reason: string };
26
27
 
27
28
  export interface ApplyOptions {
29
+ /** Workspace root for relative error paths; omitted roots retain absolute paths. */
30
+ cwd?: string;
28
31
  /** Canonical roots authorized by the semantic provider that made the plan. */
29
32
  authorizedMutationRoots: readonly string[];
30
33
  /** Expected SHA-256 fingerprints per file, validated after queue acquisition. */
@@ -65,7 +68,7 @@ export async function applyWorkspaceEdit(
65
68
  }
66
69
 
67
70
  if (options.expectedFingerprints) {
68
- const freshness = validateFingerprints(files, options.expectedFingerprints);
71
+ const freshness = validateFingerprints(files, options.expectedFingerprints, options.cwd);
69
72
  if (!freshness.ok) return { kind: "error", reason: freshness.reason };
70
73
  }
71
74
 
@@ -73,6 +76,7 @@ export async function applyWorkspaceEdit(
73
76
  edit,
74
77
  options.getOpenDocumentVersion,
75
78
  options.expectedFingerprints,
79
+ options.cwd,
76
80
  );
77
81
  if (!documentState.ok) return { kind: "error", reason: documentState.reason };
78
82
 
@@ -97,6 +101,7 @@ function validateDocumentPreconditions(
97
101
  edit: WorkspaceEdit,
98
102
  getOpenDocumentVersion: ApplyOptions["getOpenDocumentVersion"],
99
103
  expectedFingerprints: ApplyOptions["expectedFingerprints"],
104
+ cwd: ApplyOptions["cwd"],
100
105
  ): { ok: true } | { ok: false; reason: string } {
101
106
  const preconditions = edit.documentPreconditions ?? [];
102
107
  if (preconditions.length === 0) return { ok: true };
@@ -112,6 +117,7 @@ function validateDocumentPreconditions(
112
117
  precondition,
113
118
  getOpenDocumentVersion,
114
119
  expectedFingerprints,
120
+ cwd,
115
121
  );
116
122
  if (reason) return { ok: false, reason };
117
123
  }
@@ -122,21 +128,23 @@ function validateDocumentPrecondition(
122
128
  precondition: NonNullable<WorkspaceEdit["documentPreconditions"]>[number],
123
129
  getOpenDocumentVersion: NonNullable<ApplyOptions["getOpenDocumentVersion"]>,
124
130
  expectedFingerprints: ApplyOptions["expectedFingerprints"],
131
+ cwd: ApplyOptions["cwd"],
125
132
  ): string | null {
133
+ const file = cwd ? toDisplayPath(cwd, precondition.file) : precondition.file;
126
134
  const currentVersion = getOpenDocumentVersion(precondition.file);
127
135
  if (precondition.kind === "disk-content") {
128
136
  return currentVersion === null
129
137
  ? null
130
- : `File ${precondition.file} is now open and no longer uses disk content as its master.`;
138
+ : `File ${file} is now open and no longer uses disk content as its master.`;
131
139
  }
132
140
  if (currentVersion !== precondition.version) {
133
- return `File ${precondition.file} open document version has changed since the plan was generated.`;
141
+ return `File ${file} open document version has changed since the plan was generated.`;
134
142
  }
135
143
  if (
136
144
  precondition.kind === "open-document-content" &&
137
145
  expectedFingerprints?.get(precondition.file) !== precondition.fingerprint
138
146
  ) {
139
- return `File ${precondition.file} synchronized content fingerprint does not match the stored plan.`;
147
+ return `File ${file} synchronized content fingerprint does not match the stored plan.`;
140
148
  }
141
149
  return null;
142
150
  }
@@ -144,6 +152,7 @@ function validateDocumentPrecondition(
144
152
  function validateFingerprints(
145
153
  files: string[],
146
154
  expected: ReadonlyMap<string, string>,
155
+ cwd: ApplyOptions["cwd"],
147
156
  ): { ok: true } | { ok: false; reason: string } {
148
157
  for (const file of files) {
149
158
  const expectedFingerprint = expected.get(file);
@@ -152,9 +161,9 @@ function validateFingerprints(
152
161
  try {
153
162
  actual = sha256File(file);
154
163
  } catch {
155
- return stalePlanError(file);
164
+ return stalePlanError(file, cwd);
156
165
  }
157
- if (actual !== expectedFingerprint) return stalePlanError(file);
166
+ if (actual !== expectedFingerprint) return stalePlanError(file, cwd);
158
167
  }
159
168
  return { ok: true };
160
169
  }
@@ -163,10 +172,10 @@ function sha256File(file: string): string {
163
172
  return createHash("sha256").update(readFileSync(file, "utf-8")).digest("hex");
164
173
  }
165
174
 
166
- function stalePlanError(file: string): { ok: false; reason: string } {
175
+ function stalePlanError(file: string, cwd: ApplyOptions["cwd"]): { ok: false; reason: string } {
167
176
  return {
168
177
  ok: false,
169
- reason: `File ${file} has changed since the plan was generated. Regenerate with code_refactor_plan.`,
178
+ reason: `File ${cwd ? toDisplayPath(cwd, file) : file} has changed since the plan was generated. Regenerate with code_refactor_plan.`,
170
179
  };
171
180
  }
172
181
 
@@ -0,0 +1,47 @@
1
+ import type { CodeQueryPartialMetadata } from "@mrclrchtr/supi-code-runtime/api";
2
+ import { toDisplayPath } from "./paths.ts";
3
+
4
+ /** Excluded provider observations, distinct from navigable canonical source locations. */
5
+ export interface AutomaticPathExclusionDisplay {
6
+ readonly excludedCount: number;
7
+ readonly examples: readonly {
8
+ /** Original policy observation; intentionally not canonicalized. */
9
+ readonly observedPath: string;
10
+ /** Canonical workspace-relative or external absolute navigation path. */
11
+ readonly canonicalPath: string;
12
+ }[];
13
+ }
14
+
15
+ /** Project typed exclusion evidence without rewriting provider prose or source identities. */
16
+ export function displayAutomaticPathExclusion(
17
+ exclusion: CodeQueryPartialMetadata["automaticPathExclusion"],
18
+ cwd: string,
19
+ ): AutomaticPathExclusionDisplay | undefined {
20
+ return exclusion
21
+ ? {
22
+ excludedCount: exclusion.excludedCount,
23
+ examples: exclusion.examples.map((observedPath) => ({
24
+ observedPath,
25
+ canonicalPath: toDisplayPath(cwd, observedPath),
26
+ })),
27
+ }
28
+ : undefined;
29
+ }
30
+
31
+ /** Explain which observed path was excluded even when a matching canonical source was retained. */
32
+ export function describeExcludedPath(
33
+ example: AutomaticPathExclusionDisplay["examples"][number],
34
+ ): string {
35
+ return `observed \`${example.observedPath}\` → canonical \`${example.canonicalPath}\``;
36
+ }
37
+
38
+ /** Preserve provider failure reasons and append path explanations from typed metadata only. */
39
+ export function describePartialQuery(
40
+ reason: string,
41
+ metadata: CodeQueryPartialMetadata | undefined,
42
+ cwd: string,
43
+ ): string {
44
+ const exclusion = displayAutomaticPathExclusion(metadata?.automaticPathExclusion, cwd);
45
+ if (!exclusion?.examples.length) return reason;
46
+ return `${reason} Excluded path examples: ${exclusion.examples.map(describeExcludedPath).join(", ")}.`;
47
+ }
@@ -1,6 +1,6 @@
1
- import { existsSync } from "node:fs";
1
+ import { existsSync, realpathSync } from "node:fs";
2
2
  import * as path from "node:path";
3
- import { resolveToolPath } from "@mrclrchtr/supi-core/path";
3
+ import { resolveToolPath, uriToFile } from "@mrclrchtr/supi-core/path";
4
4
 
5
5
  /** Check whether a path is within the project rather than a dependency store. */
6
6
  export function isInProjectPath(filePath: string, cwd: string): boolean {
@@ -58,7 +58,7 @@ export function resolveScopeSet(
58
58
  return {
59
59
  kind: "ok",
60
60
  paths,
61
- display: paths.map((resolved) => byPath.get(resolved) ?? resolved).join(", "),
61
+ display: paths.map((resolved) => toDisplayPath(cwd, resolved)).join(", "),
62
62
  };
63
63
  }
64
64
 
@@ -73,16 +73,39 @@ export function normalizePath(input: string, cwd: string): string {
73
73
  return resolveToolPath(cwd, input);
74
74
  }
75
75
 
76
- /** Render a path relative to a base, retaining absolute paths outside it. */
76
+ /** Render filesystem locations canonically; preserve virtual provider URIs without inventing files. */
77
77
  export function relativeDisplayPath(basePath: string, filePath: string, samePath = "."): string {
78
- const relativePath = path.relative(basePath, filePath);
78
+ if (isNonFileUri(filePath)) return filePath;
79
+ const base = canonicalDisplayPath(path.resolve(basePath));
80
+ const file = canonicalDisplayPath(path.resolve(basePath, uriToFile(filePath)));
81
+ const relativePath = path.relative(base, file);
79
82
  if (!relativePath || relativePath === ".") return samePath;
80
- if (relativePath.startsWith(`..${path.sep}`) || relativePath === "..") return filePath;
83
+ if (relativePath.startsWith(`..${path.sep}`) || relativePath === "..") return file;
81
84
  return relativePath.replaceAll("\\", "/");
82
85
  }
83
86
 
84
- /** Render an absolute path relative to cwd when it is inside the workspace. */
87
+ /** Identify provider URIs that cannot be navigated as local filesystem paths. */
88
+ export function isNonFileUri(value: string): boolean {
89
+ return !path.isAbsolute(value) && /^[a-z][a-z\d+.-]*:/iu.test(value) && !/^file:/iu.test(value);
90
+ }
91
+
92
+ /** Display filesystem sources relatively inside the workspace and absolutely outside; preserve other URIs. */
85
93
  export function toDisplayPath(cwd: string, filePath: string): string {
86
- if (!path.isAbsolute(filePath)) return filePath.replaceAll("\\", "/");
87
- return relativeDisplayPath(cwd, filePath, filePath);
94
+ return relativeDisplayPath(cwd, filePath);
95
+ }
96
+
97
+ /** Resolve existing ancestors too, so missing provider files retain the workspace's canonical spelling. */
98
+ function canonicalDisplayPath(absolutePath: string): string {
99
+ let current = absolutePath;
100
+ const suffix: string[] = [];
101
+ while (true) {
102
+ try {
103
+ return path.join(realpathSync(current), ...suffix.reverse());
104
+ } catch {
105
+ const parent = path.dirname(current);
106
+ if (parent === current) return absolutePath;
107
+ suffix.push(path.basename(current));
108
+ current = parent;
109
+ }
110
+ }
88
111
  }
@@ -6,8 +6,8 @@ import {
6
6
  type NodeAtData,
7
7
  type StructuralProvider,
8
8
  } from "@mrclrchtr/supi-code-runtime/api";
9
- import type { AnchoredResolutionMetadata } from "../../types/index.ts";
10
9
  import { resolveLatexTargetAtAnchor } from "./latex-target-anchor.ts";
10
+ import { createAnchoredResolution } from "./resolution.ts";
11
11
  import type { TargetOutcome } from "./types.ts";
12
12
 
13
13
  type Anchor = { line: number; character: number };
@@ -129,12 +129,7 @@ export async function resolveFromStructural(
129
129
  provenance: ["structural"],
130
130
  anchorKind: "name",
131
131
  container: null,
132
- resolution: {
133
- requested: { ...requested },
134
- resolved: anchor,
135
- snapped: anchor.line !== requested.line || anchor.character !== requested.character,
136
- source: "structural-identifier",
137
- } satisfies AnchoredResolutionMetadata,
132
+ resolution: createAnchoredResolution(requested, anchor, "structural-identifier"),
138
133
  },
139
134
  };
140
135
  }
@@ -143,7 +138,7 @@ function coordinateNotOnSymbolMessage(file: string, requested: Anchor, detail: s
143
138
  const at = `${basename(file)}:${requested.line}:${requested.character}`;
144
139
  return (
145
140
  `No symbol target resolved at \`${at}\` (on \`${detail}\`). ` +
146
- "`code_resolve` resolves real symbol targets from provider-backed evidence; " +
141
+ "Target resolution requires a real symbol backed by provider evidence; " +
147
142
  "use `code_inspect` for point-level facts at this coordinate, or pass the identifier coordinate of a declaration."
148
143
  );
149
144
  }