@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
@@ -0,0 +1,617 @@
1
+ // biome-ignore-all lint/style/noExcessiveLinesPerFile: the complete native contract is declared together for auditing
2
+ import { Type } from "typebox";
3
+ import {
4
+ ConfidenceSchema,
5
+ EvidenceListSchema,
6
+ NavigationTargetSchema,
7
+ ReadNextSchema,
8
+ RecoveryRangeSchema,
9
+ } from "../result/structured.ts";
10
+
11
+ const nullableString = Type.Union([Type.String(), Type.Null()]);
12
+ const coordinate = { description: "One-based line and UTF-16 character; end is exclusive." };
13
+ const SourceItem = Type.Object(
14
+ {
15
+ startLine: Type.Integer(),
16
+ startCharacter: Type.Integer(),
17
+ endLine: Type.Integer(),
18
+ endCharacter: Type.Integer(),
19
+ },
20
+ coordinate,
21
+ );
22
+ const Project = Type.Object(
23
+ {
24
+ id: Type.String(),
25
+ manifestPath: Type.String(),
26
+ kind: Type.Enum(["node-package", "python-project", "rust-package", "go-module"], {
27
+ type: "string",
28
+ }),
29
+ directory: Type.String(),
30
+ name: nullableString,
31
+ nameField: nullableString,
32
+ description: nullableString,
33
+ descriptionField: nullableString,
34
+ },
35
+ { additionalProperties: false },
36
+ );
37
+ const Relationship = Type.Object(
38
+ {
39
+ from: Type.String(),
40
+ to: Type.String(),
41
+ manifestPath: Type.String(),
42
+ field: Type.String(),
43
+ value: Type.Unknown(),
44
+ },
45
+ { additionalProperties: false },
46
+ );
47
+ const Provenance = Type.Object(
48
+ {
49
+ source: Type.Enum(
50
+ ["semantic", "structural", "filesystem", "manifest", "configuration", "runtime"],
51
+ { type: "string" },
52
+ ),
53
+ capability: Type.Optional(Type.String()),
54
+ detail: Type.Optional(Type.String()),
55
+ },
56
+ { additionalProperties: false },
57
+ );
58
+ const SourceListFields = {
59
+ status: Type.Enum(["complete", "partial", "unavailable"], { type: "string" }),
60
+ reason: nullableString,
61
+ collectedCount: Type.Integer(),
62
+ omittedCount: Type.Integer(),
63
+ };
64
+ const Observation = Type.Union([
65
+ Type.Object(
66
+ { status: Type.Literal("complete"), reason: Type.Null() },
67
+ { additionalProperties: false },
68
+ ),
69
+ Type.Object(
70
+ {
71
+ status: Type.Enum(["partial", "unavailable", "withheld"], { type: "string" }),
72
+ reason: Type.String(),
73
+ },
74
+ { additionalProperties: false },
75
+ ),
76
+ ]);
77
+ const ContextDefinitionEntries = {
78
+ entries: Type.Array(
79
+ Type.Union([
80
+ Type.Object(
81
+ { file: Type.String(), range: RecoveryRangeSchema },
82
+ { additionalProperties: false },
83
+ ),
84
+ Type.Object(
85
+ {
86
+ uri: Type.String(),
87
+ range: RecoveryRangeSchema,
88
+ navigation: Type.Literal("unavailable"),
89
+ reason: Type.String(),
90
+ },
91
+ {
92
+ additionalProperties: false,
93
+ description:
94
+ "Retained provider observation; this URI is not a local filesystem navigation target.",
95
+ },
96
+ ),
97
+ ]),
98
+ ),
99
+ collectedCount: Type.Integer({
100
+ description: "Collected locations; a partial observation may have an unknown remainder.",
101
+ }),
102
+ omittedCount: Type.Integer({
103
+ description: "Collected locations omitted by the requested selection limit.",
104
+ }),
105
+ };
106
+ const ContextDefinitions = Type.Union([
107
+ Type.Object(
108
+ { status: Type.Literal("complete"), reason: Type.Null(), ...ContextDefinitionEntries },
109
+ { additionalProperties: false },
110
+ ),
111
+ Type.Object(
112
+ { status: Type.Literal("partial"), reason: Type.String(), ...ContextDefinitionEntries },
113
+ { additionalProperties: false },
114
+ ),
115
+ Type.Object(
116
+ { status: Type.Enum(["unavailable", "withheld"], { type: "string" }), reason: Type.String() },
117
+ { additionalProperties: false },
118
+ ),
119
+ ]);
120
+ const Facts = Type.Object(
121
+ {
122
+ fileSizeBytes: Type.Optional(Type.Integer()),
123
+ package: Type.Optional(
124
+ Type.Object(
125
+ {
126
+ name: nullableString,
127
+ description: nullableString,
128
+ manifestPath: Type.String(),
129
+ directory: Type.String(),
130
+ },
131
+ { additionalProperties: false },
132
+ ),
133
+ ),
134
+ manifestFields: Type.Optional(
135
+ Type.Array(
136
+ Type.Object(
137
+ { field: Type.String(), value: Type.Unknown() },
138
+ { additionalProperties: false },
139
+ ),
140
+ ),
141
+ ),
142
+ dependencies: Type.Optional(
143
+ Type.Array(
144
+ Type.Object(
145
+ { field: Type.String(), name: Type.String(), value: Type.Unknown() },
146
+ { additionalProperties: false },
147
+ ),
148
+ ),
149
+ ),
150
+ relationships: Type.Optional(Type.Array(Relationship)),
151
+ outline: Type.Optional(
152
+ Type.Array(
153
+ Type.Object(
154
+ { ...SourceItem.properties, name: Type.String(), kind: Type.String() },
155
+ { additionalProperties: false, ...coordinate },
156
+ ),
157
+ ),
158
+ ),
159
+ imports: Type.Optional(
160
+ Type.Array(
161
+ Type.Object(
162
+ { ...SourceItem.properties, moduleSpecifier: Type.String() },
163
+ { additionalProperties: false, ...coordinate },
164
+ ),
165
+ ),
166
+ ),
167
+ exports: Type.Optional(
168
+ Type.Array(
169
+ Type.Object(
170
+ {
171
+ ...SourceItem.properties,
172
+ name: Type.String(),
173
+ kind: Type.String(),
174
+ moduleSpecifier: Type.Optional(Type.String()),
175
+ },
176
+ { additionalProperties: false, ...coordinate },
177
+ ),
178
+ ),
179
+ ),
180
+ diagnosticSnapshot: Type.Optional(
181
+ Type.Array(
182
+ Type.Object(
183
+ {
184
+ file: Type.String(),
185
+ total: Type.Integer(),
186
+ errors: Type.Integer(),
187
+ warnings: Type.Integer(),
188
+ },
189
+ { additionalProperties: false },
190
+ ),
191
+ ),
192
+ ),
193
+ snapshotCurrent: Type.Optional(Type.Boolean()),
194
+ node: Type.Optional(
195
+ Type.Union([
196
+ Type.Null(),
197
+ Type.Object(
198
+ {
199
+ type: Type.String(),
200
+ text: Type.String(),
201
+ startLine: Type.Integer(),
202
+ startCharacter: Type.Integer(),
203
+ endLine: Type.Integer(),
204
+ endCharacter: Type.Integer(),
205
+ ancestry: Type.Array(
206
+ Type.Object(
207
+ { ...SourceItem.properties, type: Type.String() },
208
+ { additionalProperties: false, ...coordinate },
209
+ ),
210
+ ),
211
+ },
212
+ { additionalProperties: false, ...coordinate },
213
+ ),
214
+ ]),
215
+ ),
216
+ nodeObservation: Type.Optional(Observation),
217
+ hoverObservation: Type.Optional(Observation),
218
+ hover: Type.Optional(
219
+ Type.Union([
220
+ Type.Null(),
221
+ Type.Object(
222
+ { contents: Type.String(), range: Type.Optional(RecoveryRangeSchema) },
223
+ { additionalProperties: false },
224
+ ),
225
+ ]),
226
+ ),
227
+ definitions: Type.Optional(
228
+ Type.Array(
229
+ Type.Object(
230
+ { file: Type.String(), range: RecoveryRangeSchema },
231
+ { additionalProperties: false },
232
+ ),
233
+ ),
234
+ ),
235
+ contextDefinitions: Type.Optional(ContextDefinitions),
236
+ recovery: Type.Optional(
237
+ Type.Array(
238
+ Type.Object(
239
+ {
240
+ operation: Type.String(),
241
+ file: Type.String(),
242
+ reason: Type.String(),
243
+ errorRanges: Type.Array(RecoveryRangeSchema),
244
+ },
245
+ { additionalProperties: false },
246
+ ),
247
+ ),
248
+ ),
249
+ sourceContext: Type.Optional(
250
+ Type.Object(
251
+ {
252
+ outline: Type.Object(
253
+ {
254
+ ...SourceListFields,
255
+ entries: Type.Array(
256
+ Type.Object(
257
+ {
258
+ name: Type.String(),
259
+ kind: Type.String(),
260
+ startLine: Type.Integer(),
261
+ endLine: Type.Integer(),
262
+ },
263
+ { additionalProperties: false },
264
+ ),
265
+ ),
266
+ },
267
+ { additionalProperties: false },
268
+ ),
269
+ imports: Type.Object(
270
+ {
271
+ ...SourceListFields,
272
+ entries: Type.Array(
273
+ Type.Object({ moduleSpecifier: Type.String() }, { additionalProperties: false }),
274
+ ),
275
+ },
276
+ { additionalProperties: false },
277
+ ),
278
+ exports: Type.Object(
279
+ {
280
+ ...SourceListFields,
281
+ entries: Type.Array(
282
+ Type.Object(
283
+ { name: Type.String(), kind: Type.String() },
284
+ { additionalProperties: false },
285
+ ),
286
+ ),
287
+ },
288
+ { additionalProperties: false },
289
+ ),
290
+ },
291
+ {
292
+ additionalProperties: false,
293
+ description:
294
+ "Best-effort source lists; collectedCount is not a completeness claim when status is partial or unavailable.",
295
+ },
296
+ ),
297
+ ),
298
+ documentation: Type.Optional(Type.Array(Type.String())),
299
+ diagnostics: Type.Optional(
300
+ Type.Array(
301
+ Type.Object(
302
+ {
303
+ range: RecoveryRangeSchema,
304
+ severity: Type.Union([Type.Integer(), Type.Null()]),
305
+ message: Type.String(),
306
+ source: nullableString,
307
+ code: Type.Union([Type.String(), Type.Number(), Type.Null()]),
308
+ },
309
+ { additionalProperties: false },
310
+ ),
311
+ ),
312
+ ),
313
+ },
314
+ {
315
+ additionalProperties: false,
316
+ description:
317
+ "Named observations, not rendered text. Ranges use zero-based UTF-16 positions; source-item coordinates are one-based.",
318
+ },
319
+ );
320
+ const Section = Type.Object(
321
+ {
322
+ key: Type.String(),
323
+ status: Type.Enum(["complete", "partial", "unavailable"], { type: "string" }),
324
+ reason: nullableString,
325
+ confidence: ConfidenceSchema,
326
+ provenance: Type.Array(Provenance),
327
+ evidenceLists: Type.Array(EvidenceListSchema),
328
+ errorRanges: Type.Optional(Type.Array(RecoveryRangeSchema)),
329
+ facts: Type.Optional(Facts),
330
+ },
331
+ { additionalProperties: false },
332
+ );
333
+ const Instruction = Type.Object(
334
+ {
335
+ path: Type.String(),
336
+ shownLines: Type.Integer(),
337
+ totalLines: Type.Integer(),
338
+ truncated: Type.Boolean(),
339
+ content: Type.String(),
340
+ },
341
+ { additionalProperties: false },
342
+ );
343
+ const GradleBase = {
344
+ selectedRoot: Type.String(),
345
+ query: Type.Literal("GradleBuild/BasicGradleProject"),
346
+ runtime: Type.Optional(
347
+ Type.Object(
348
+ {
349
+ kind: Type.Enum(["distribution", "installation"], { type: "string" }),
350
+ source: Type.String(),
351
+ version: Type.String(),
352
+ },
353
+ { additionalProperties: false },
354
+ ),
355
+ ),
356
+ };
357
+ const Gradle = Type.Union([
358
+ Type.Object(
359
+ {
360
+ ...GradleBase,
361
+ status: Type.Literal("complete"),
362
+ gradleVersion: Type.String(),
363
+ buildRoot: Type.String(),
364
+ projects: Type.Array(
365
+ Type.Object(
366
+ {
367
+ buildRoot: Type.String(),
368
+ path: Type.String(),
369
+ name: Type.String(),
370
+ directory: Type.String(),
371
+ parentPath: nullableString,
372
+ },
373
+ { additionalProperties: false },
374
+ ),
375
+ ),
376
+ includedBuilds: Type.Array(
377
+ Type.Object({ buildRoot: Type.String() }, { additionalProperties: false }),
378
+ ),
379
+ },
380
+ { additionalProperties: false },
381
+ ),
382
+ Type.Object(
383
+ {
384
+ ...GradleBase,
385
+ status: Type.Enum(
386
+ ["blocked", "unavailable", "unsupported", "failed", "interrupted", "timeout", "oversized"],
387
+ { type: "string" },
388
+ ),
389
+ gradleVersion: Type.Optional(Type.String()),
390
+ stage: Type.Enum(["authorization", "prerequisites", "query", "unknown"], { type: "string" }),
391
+ reason: Type.String(),
392
+ },
393
+ { additionalProperties: false },
394
+ ),
395
+ ]);
396
+ const Workspace = Type.Object(
397
+ {
398
+ root: Type.String(),
399
+ focus: Type.String(),
400
+ directFiles: Type.Array(
401
+ Type.Object(
402
+ { path: Type.String(), kind: Type.Enum(["file", "symlink"], { type: "string" }) },
403
+ { additionalProperties: false },
404
+ ),
405
+ ),
406
+ directories: Type.Array(
407
+ Type.Object(
408
+ { path: Type.String(), entryCount: Type.Integer() },
409
+ { additionalProperties: false },
410
+ ),
411
+ ),
412
+ extensions: Type.Array(
413
+ Type.Object(
414
+ { extension: Type.String(), fileCount: Type.Integer() },
415
+ { additionalProperties: false },
416
+ ),
417
+ ),
418
+ containingProjects: Type.Array(Project),
419
+ projects: Type.Array(Project),
420
+ memberships: Type.Array(
421
+ Type.Object(
422
+ {
423
+ projectId: Type.String(),
424
+ kind: Type.String(),
425
+ manifestPath: Type.String(),
426
+ field: Type.String(),
427
+ value: Type.String(),
428
+ },
429
+ { additionalProperties: false },
430
+ ),
431
+ ),
432
+ declaredPaths: Type.Array(
433
+ Type.Object(
434
+ {
435
+ projectId: Type.String(),
436
+ paths: Type.Array(
437
+ Type.Object(
438
+ { path: Type.String(), fields: Type.Array(Type.String()) },
439
+ { additionalProperties: false },
440
+ ),
441
+ ),
442
+ },
443
+ { additionalProperties: false },
444
+ ),
445
+ ),
446
+ relationships: Type.Array(Relationship),
447
+ dependencies: Type.Array(
448
+ Type.Object(
449
+ {
450
+ projectId: Type.String(),
451
+ field: Type.String(),
452
+ name: Type.String(),
453
+ value: Type.Unknown(),
454
+ },
455
+ { additionalProperties: false },
456
+ ),
457
+ ),
458
+ workspaceDeclarations: Type.Array(
459
+ Type.Object(
460
+ {
461
+ kind: Type.String(),
462
+ manifestPath: Type.String(),
463
+ directory: Type.String(),
464
+ field: Type.String(),
465
+ patterns: Type.Array(Type.String()),
466
+ excludeField: nullableString,
467
+ excludes: Type.Array(Type.String()),
468
+ },
469
+ { additionalProperties: false },
470
+ ),
471
+ ),
472
+ inventory: Type.Object(
473
+ {
474
+ fileCount: Type.Integer(),
475
+ symlinkCount: Type.Integer(),
476
+ source: Type.Enum(["git", "filesystem"], { type: "string" }),
477
+ exclude: Type.Array(Type.String()),
478
+ includeIgnored: Type.Boolean(),
479
+ symlinks: Type.Literal("not-followed"),
480
+ directoryNamesExcluded: Type.Literal(false),
481
+ },
482
+ {
483
+ additionalProperties: false,
484
+ description: "Counts refer to the collected inventory, which may be incomplete.",
485
+ },
486
+ ),
487
+ collection: Type.Object(
488
+ {
489
+ status: Type.Enum(["complete", "partial"], { type: "string" }),
490
+ stopReason: Type.Enum(["complete", "entry-limit", "deadline"], { type: "string" }),
491
+ prioritizedDirectory: nullableString,
492
+ limits: Type.Object(
493
+ { maxEntries: Type.Integer(), deadline: Type.Union([Type.Number(), Type.Null()]) },
494
+ { additionalProperties: false },
495
+ ),
496
+ errors: Type.Array(
497
+ Type.Object(
498
+ { stage: Type.String(), path: nullableString, reason: Type.String() },
499
+ { additionalProperties: false },
500
+ ),
501
+ ),
502
+ },
503
+ { additionalProperties: false },
504
+ ),
505
+ metadata: Type.Object(
506
+ {
507
+ documents: Type.Array(
508
+ Type.Object(
509
+ {
510
+ path: Type.String(),
511
+ kind: Type.String(),
512
+ status: Type.String(),
513
+ reason: nullableString,
514
+ },
515
+ { additionalProperties: false },
516
+ ),
517
+ ),
518
+ issues: Type.Array(
519
+ Type.Object(
520
+ {
521
+ path: Type.String(),
522
+ field: nullableString,
523
+ kind: Type.String(),
524
+ reason: Type.String(),
525
+ },
526
+ { additionalProperties: false },
527
+ ),
528
+ ),
529
+ },
530
+ { additionalProperties: false },
531
+ ),
532
+ gradle: Type.Optional(Gradle),
533
+ selections: Type.Array(EvidenceListSchema),
534
+ },
535
+ {
536
+ additionalProperties: false,
537
+ description:
538
+ "root and focus are absolute. Direct inventory paths are relative to focus; project and metadata paths are relative to root. Selection counts exclude text-budget reductions.",
539
+ },
540
+ );
541
+
542
+ const Common = {
543
+ confidence: ConfidenceSchema,
544
+ sections: Type.Array(Section),
545
+ targets: Type.Array(NavigationTargetSchema),
546
+ candidates: Type.Array(
547
+ Type.Object(
548
+ {
549
+ handle: Type.String(),
550
+ name: Type.String(),
551
+ kind: nullableString,
552
+ container: nullableString,
553
+ file: Type.String(),
554
+ line: Type.Integer(),
555
+ character: Type.Integer(),
556
+ rank: Type.Integer(),
557
+ anchorKind: Type.Optional(Type.Enum(["name", "declaration"], { type: "string" })),
558
+ },
559
+ { additionalProperties: false, description: "One-based line and UTF-16 character." },
560
+ ),
561
+ ),
562
+ evidenceLists: Type.Array(EvidenceListSchema),
563
+ nextQueries: Type.Array(Type.String()),
564
+ readNext: Type.Array(ReadNextSchema),
565
+ instructions: Type.Array(Instruction),
566
+ observationLimitations: Type.Array(Type.String()),
567
+ };
568
+ const Snapshot = Type.Object(
569
+ {
570
+ path: Type.String(),
571
+ limitation: Type.Literal("Reading this snapshot does not refresh the captured observation."),
572
+ },
573
+ { additionalProperties: false },
574
+ );
575
+
576
+ /** Native orientation data. Snapshot paths refer to captured facts, never a fresh observation. */
577
+ export const OrientationOutputSchema = Type.Union([
578
+ Type.Object(
579
+ {
580
+ ...Common,
581
+ kind: Type.Literal("completed"),
582
+ focusKind: Type.Enum(["workspace", "directory", "module"], { type: "string" }),
583
+ focus: Type.Union([Type.String(), Type.Null()]),
584
+ workspace: Workspace,
585
+ snapshot: Type.Optional(Snapshot),
586
+ },
587
+ { additionalProperties: false },
588
+ ),
589
+ Type.Object(
590
+ {
591
+ ...Common,
592
+ kind: Type.Literal("completed"),
593
+ focusKind: Type.Enum(["file", "symbol"], { type: "string" }),
594
+ focus: Type.Union([Type.String(), Type.Null()]),
595
+ },
596
+ { additionalProperties: false },
597
+ ),
598
+ Type.Object({ ...Common, kind: Type.Literal("disambiguation") }, { additionalProperties: false }),
599
+ Type.Object(
600
+ { ...Common, kind: Type.Literal("kind-mismatch"), requestedKind: Type.String() },
601
+ { additionalProperties: false },
602
+ ),
603
+ Type.Object(
604
+ {
605
+ ...Common,
606
+ kind: Type.Literal("invalid-input"),
607
+ message: Type.String(),
608
+ symlinkRejection: Type.Optional(
609
+ Type.Object(
610
+ { requestedPath: Type.String(), blockedPath: Type.String() },
611
+ { additionalProperties: false },
612
+ ),
613
+ ),
614
+ },
615
+ { additionalProperties: false },
616
+ ),
617
+ ]);