@mrclrchtr/supi-review 5.0.0 → 6.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (201) hide show
  1. package/README.md +15 -15
  2. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/package.json +2 -2
  3. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/api.ts +1 -1
  4. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +0 -3
  5. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/debug.ts +9 -0
  6. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/index.ts +1 -1
  7. package/node_modules/@mrclrchtr/supi-agent-runtime/package.json +2 -2
  8. package/node_modules/@mrclrchtr/supi-code-intelligence/README.md +2 -2
  9. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  10. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/package.json +2 -2
  11. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/api.ts +1 -1
  12. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +0 -3
  13. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/debug.ts +9 -0
  14. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/index.ts +1 -1
  15. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/README.md +34 -3
  16. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  17. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +2 -2
  18. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/api.ts +1 -1
  19. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +0 -3
  20. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/debug.ts +9 -0
  21. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/index.ts +1 -1
  22. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/package.json +3 -3
  23. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/api.ts +12 -1
  24. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-cache.ts +67 -28
  25. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-collection.ts +63 -6
  26. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-evidence.ts +46 -5
  27. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-host.ts +1 -0
  28. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-publication.ts +214 -0
  29. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-refresh.ts +278 -79
  30. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-timing.ts +29 -8
  31. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostics.ts +101 -19
  32. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-state.ts +19 -1
  33. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-sync.ts +49 -3
  34. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client.ts +73 -15
  35. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/transport.ts +1 -1
  36. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/capabilities.ts +2 -2
  37. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/config.ts +5 -5
  38. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/server-config.ts +3 -0
  39. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-extends.ts +68 -0
  40. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-path.ts +8 -0
  41. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-scope.ts +176 -24
  42. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/evidence.ts +4 -0
  43. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/workspace-sentinels.ts +46 -10
  44. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-diagnostics.ts +4 -3
  45. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-workspace-recovery.ts +65 -17
  46. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +143 -21
  47. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostic-surface.ts +2 -0
  48. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostics.ts +43 -1
  49. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +31 -0
  50. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  51. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +2 -2
  52. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/api.ts +1 -1
  53. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +0 -3
  54. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug.ts +9 -0
  55. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/index.ts +1 -1
  56. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/package.json +3 -3
  57. package/node_modules/@mrclrchtr/supi-code-intelligence/package.json +5 -5
  58. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/diagnostics.ts +58 -126
  59. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/file-scope.ts +184 -0
  60. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/recovery.ts +8 -1
  61. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/readiness.ts +4 -0
  62. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/ast-scan.ts +4 -1
  63. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern-analysis.ts +10 -3
  64. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern.ts +6 -1
  65. package/node_modules/@mrclrchtr/supi-code-intelligence/src/config.ts +35 -1
  66. package/node_modules/@mrclrchtr/supi-code-intelligence/src/extension.ts +57 -14
  67. package/node_modules/@mrclrchtr/supi-code-intelligence/src/overview/overview-data.ts +9 -2
  68. package/node_modules/@mrclrchtr/supi-code-intelligence/src/overview/overview.ts +49 -30
  69. package/node_modules/@mrclrchtr/supi-code-intelligence/src/overview/types.ts +2 -0
  70. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/find-types.ts +2 -2
  71. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/find-workflow.ts +3 -2
  72. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-refresh.ts +76 -49
  73. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-types.ts +7 -1
  74. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-workflow.ts +35 -18
  75. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/input/workflows.ts +2 -2
  76. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect-workflow.ts +2 -1
  77. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/collect.ts +2 -2
  78. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-types.ts +2 -0
  79. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-workflow.ts +8 -2
  80. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-workflow.ts +2 -1
  81. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/session.ts +25 -1
  82. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/maintenance.ts +105 -23
  83. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/recovery.ts +11 -5
  84. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/execute.ts +23 -0
  85. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/guidance.ts +8 -0
  86. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{find → code_find}/render.ts +1 -1
  87. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{result/find.ts → code_find/result.ts} +36 -11
  88. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/spec.ts +37 -0
  89. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/execute.ts +24 -0
  90. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/guidance.ts +6 -0
  91. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{graph → code_graph}/markdown.ts +1 -1
  92. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{result/graph.ts → code_graph/result.ts} +69 -4
  93. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/spec.ts +39 -0
  94. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{health → code_health}/execute.ts +2 -18
  95. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/guidance.ts +8 -0
  96. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{health → code_health}/markdown.ts +68 -18
  97. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{result/health.ts → code_health/result.ts} +29 -4
  98. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/spec.ts +41 -0
  99. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/execute.ts +20 -0
  100. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/guidance.ts +6 -0
  101. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{inspect → code_inspect}/markdown.ts +1 -1
  102. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{result/inspect.ts → code_inspect/result.ts} +32 -3
  103. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/spec.ts +25 -0
  104. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/execute.ts +25 -0
  105. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/guidance.ts +9 -0
  106. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{orientation → code_orientation}/markdown.ts +1 -1
  107. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{result/orientation.ts → code_orientation/result.ts} +67 -3
  108. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/spec.ts +25 -0
  109. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_apply/execute.ts +17 -0
  110. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_apply/guidance.ts +5 -0
  111. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{refactor-apply/execute.ts → code_refactor_apply/result.ts} +5 -11
  112. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_apply/spec.ts +26 -0
  113. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_plan/execute.ts +27 -0
  114. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_plan/guidance.ts +8 -0
  115. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{refactor-plan/execute.ts → code_refactor_plan/result.ts} +9 -22
  116. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_plan/spec.ts +25 -0
  117. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/execute.ts +19 -0
  118. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/guidance.ts +8 -0
  119. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{resolve → code_resolve}/markdown.ts +1 -1
  120. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{result/resolve.ts → code_resolve/result.ts} +37 -24
  121. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/spec.ts +25 -0
  122. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/guidance.ts +71 -52
  123. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/infra/truncate.ts +40 -0
  124. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{refactor-plan/markdown.ts → refactor-markdown.ts} +4 -7
  125. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/register.ts +9 -97
  126. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/refactor.ts +1 -4
  127. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/schemas.ts +26 -157
  128. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/specs.ts +40 -126
  129. package/node_modules/@mrclrchtr/supi-core/package.json +2 -2
  130. package/node_modules/@mrclrchtr/supi-core/src/api.ts +1 -1
  131. package/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +0 -3
  132. package/node_modules/@mrclrchtr/supi-core/src/debug.ts +9 -0
  133. package/node_modules/@mrclrchtr/supi-core/src/index.ts +1 -1
  134. package/package.json +4 -4
  135. package/src/config.ts +2 -2
  136. package/src/review.ts +5 -5
  137. package/src/target/input.ts +90 -0
  138. package/src/target/resolve.ts +9 -39
  139. package/src/tool/output-page.ts +45 -8
  140. package/src/tool/page-render.ts +37 -0
  141. package/src/tool/page-schemas.ts +29 -0
  142. package/src/tool/review_audit/execute.ts +56 -0
  143. package/src/tool/review_audit/guidance.ts +10 -0
  144. package/src/tool/review_audit/register.ts +19 -0
  145. package/src/{tui/paged-output.ts → tool/review_audit/render.ts} +9 -72
  146. package/src/tool/review_audit/result.ts +144 -0
  147. package/src/tool/review_audit/spec.ts +44 -0
  148. package/src/tool/review_output/execute.ts +19 -0
  149. package/src/tool/review_output/guidance.ts +7 -0
  150. package/src/tool/review_output/register.ts +23 -0
  151. package/src/tool/review_output/render.ts +37 -0
  152. package/src/tool/review_output/result.ts +33 -0
  153. package/src/tool/review_output/spec.ts +29 -0
  154. package/src/tool/{child-failure-diagnostics.ts → review_run/child-failures.ts} +1 -1
  155. package/src/tool/{child-session-runner.ts → review_run/child-session.ts} +2 -2
  156. package/src/tool/{review-tools.ts → review_run/child-tools.ts} +43 -6
  157. package/src/tool/{review-debug-summary.ts → review_run/debug-summary.ts} +1 -1
  158. package/src/tool/{agent-review-tools.ts → review_run/execute.ts} +10 -59
  159. package/src/tool/{review-execution.ts → review_run/execution.ts} +6 -6
  160. package/src/tool/{review-format.ts → review_run/format.ts} +9 -11
  161. package/src/tool/review_run/guidance.ts +11 -0
  162. package/src/tool/{agent-review-schemas.ts → review_run/input-schema.ts} +61 -62
  163. package/src/tool/{planner-input.ts → review_run/planner-input.ts} +3 -3
  164. package/src/tool/{planner-runner.ts → review_run/planner.ts} +7 -7
  165. package/src/tool/{post-review-policy.ts → review_run/post-policy.ts} +4 -4
  166. package/src/tool/{review-recovery.ts → review_run/recovery.ts} +4 -4
  167. package/src/tool/review_run/register.ts +24 -0
  168. package/src/{tui/run.ts → tool/review_run/render.ts} +30 -23
  169. package/src/tool/review_run/result.ts +51 -0
  170. package/src/tool/{review-runner.ts → review_run/runner.ts} +7 -7
  171. package/src/tool/{schemas.ts → review_run/schemas.ts} +4 -4
  172. package/src/tool/review_run/spec.ts +11 -0
  173. package/src/{review-result.ts → tool/review_run/submission.ts} +7 -5
  174. package/src/tool/{review-system-prompt.ts → review_run/system-prompt.ts} +3 -3
  175. package/src/tool/{review-workflow.ts → review_run/workflow.ts} +19 -15
  176. package/src/tui/common.ts +2 -2
  177. package/src/tui/review-command.ts +4 -4
  178. package/src/tui/review-target-picker.ts +11 -11
  179. package/src/types.ts +15 -5
  180. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/find/execute.ts +0 -43
  181. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/graph/execute.ts +0 -82
  182. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/inspect/execute.ts +0 -40
  183. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/orientation/execute.ts +0 -80
  184. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/resolve/execute.ts +0 -53
  185. package/src/tool/review-audit-tool.ts +0 -181
  186. package/src/tool/review-output-tool.ts +0 -74
  187. package/src/tool/tool-specs.ts +0 -137
  188. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{find → code_find}/ast-kinds.ts +0 -0
  189. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{find → code_find}/markdown.ts +0 -0
  190. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{find → code_find}/modes.ts +0 -0
  191. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{find → code_find}/tui.ts +0 -0
  192. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{graph → code_graph}/tui.ts +0 -0
  193. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{health → code_health}/refresh-status.ts +0 -0
  194. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{health → code_health}/semantic-state.ts +0 -0
  195. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{health → code_health}/tui.ts +0 -0
  196. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{inspect → code_inspect}/tui.ts +0 -0
  197. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{orientation → code_orientation}/tui.ts +0 -0
  198. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{refactor-apply → code_refactor_apply}/tui.ts +0 -0
  199. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{refactor-plan → code_refactor_plan}/tui.ts +0 -0
  200. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{resolve → code_resolve}/tui.ts +0 -0
  201. /package/src/tool/{child-resource-loader.ts → review_run/child-resources.ts} +0 -0
package/README.md CHANGED
@@ -20,22 +20,23 @@ This package is beta software. Its interfaces can change.
20
20
 
21
21
  - `/supi-review` — interactive review with optional Planner Draft help
22
22
  - `/supi-review-cleanup` — remove marked Review Workspaces after an interrupted cleanup
23
- - `supi_review_run` — run one caller-defined Review
24
- - `supi_review_output` — read more parent-facing output
25
- - `supi_review_audit` — navigate local reviewer replays when audit is enabled
23
+ - `review_run` — run one caller-defined Review
24
+ - `review_output` — read more parent-facing output
25
+ - `review_audit` — navigate local reviewer replays when audit is enabled
26
26
 
27
27
  Changes to **Agent tools** apply immediately. Turning this setting off removes the agent start and audit tools from the active tool set. The output tool and the commands stay available.
28
28
 
29
29
  ## Review input
30
30
 
31
- `supi_review_run` has one flat input. It has `target`, optional top-level `paths`, optional `sharedContext`, and one to four `tasks`.
31
+ `review_run` has one flat input. It has `target`, optional top-level `paths`, optional `sharedContext`, and one to four `tasks`.
32
32
 
33
33
  ```json
34
34
  {
35
35
  "target": {
36
- "from": "main",
37
- "to": "HEAD",
38
- "includeUncommittedChanges": false
36
+ "committed": {
37
+ "from": "main",
38
+ "to": "HEAD"
39
+ }
39
40
  },
40
41
  "paths": ["packages/supi-review"],
41
42
  "sharedContext": "The change implements issue #287.",
@@ -54,17 +55,16 @@ Changes to **Agent tools** apply immediately. Turning this setting off removes t
54
55
  }
55
56
  ```
56
57
 
57
- A Review Target has only these optional fields:
58
+ A Review Target selects at most one source object:
58
59
 
59
- - `from` — one before endpoint
60
- - `to` — one after endpoint
61
- - `includeUncommittedChanges` — include the current filesystem and non-ignored untracked files; default is `true`
60
+ - `workingTree` — review the frozen current filesystem, including staged, unstaged, and non-ignored untracked files. Its optional `from` field sets the committed before state.
61
+ - `committed` — review exact committed Git state. Its optional `from` and `to` fields select the before and after commits. `to` defaults to `HEAD`.
62
62
 
63
- Omit `target`, or use `{}`, to select the current filesystem. When uncommitted changes are included, `to` is not valid. When they are not included, `to` defaults to `HEAD`. Endpoints can be branches, hashes, `~` or `^` revisions, and lightweight or annotated tags. The Review Engine resolves each endpoint once to a full commit. It rejects endpoints that contain whitespace and rejects blank endpoints, ranges, trees, and blobs.
63
+ Select at most one source object. Omit `target`, or use `{}`, to select the current filesystem. Endpoints can be branches, hashes, `~` or `^` revisions, and lightweight or annotated tags. The Review Engine resolves each endpoint once to a full commit. It rejects endpoints that contain whitespace and rejects blank endpoints, ranges, trees, and blobs.
64
64
 
65
65
  Each task must set `mode` to `change` or `state`.
66
66
 
67
- - `change` needs one non-empty canonical change. A filesystem change defaults its omitted `from` to captured `HEAD`. A committed change needs an explicit `from`.
67
+ - `change` needs one non-empty canonical change. A `workingTree` change defaults its omitted `from` to captured `HEAD`. A `committed` change needs an explicit `from`.
68
68
  - `state` reviews only the frozen after state. A batch of only state tasks must not set `from`. It can review a root commit.
69
69
 
70
70
  A committed change cannot use a root commit as `to`. A root commit is valid as `from`. Every Review requires a repository with `HEAD`.
@@ -133,11 +133,11 @@ Each task result includes its Review Mode, packet SHA-256, verdict, finding coun
133
133
 
134
134
  `blocksAcceptance` keeps its existing meaning. The Review Engine derives `issues` for a blocking finding. It derives `incomplete` for incomplete Criteria Coverage without a blocking finding, `pass_with_findings` for only non-blocking findings, and `pass` for no findings.
135
135
 
136
- Parent-facing output from `supi_review_run` or `/supi-review` is stored as a bounded session artifact. Use `supi_review_output` with its returned `artifactId` and offset to read more output.
136
+ Parent-facing output from `review_run` or `/supi-review` is stored as a bounded session artifact. Use `review_output` with its returned `artifactId` and offset to read more output.
137
137
 
138
138
  ## Local reviewer replay
139
139
 
140
- `review.auditEnabled` is off by default. When **Agent tools** are on, enabling **Local reviewer replay** records a protected local replay for each Reviewer Session and activates `supi_review_audit` immediately. Replays expire after seven days. Normal review output includes only an opaque artifact id.
140
+ `review.auditEnabled` is off by default. When **Agent tools** are on, enabling **Local reviewer replay** records a protected local replay for each Reviewer Session and activates `review_audit` immediately. Replays expire after seven days. Normal review output includes only an opaque artifact id.
141
141
 
142
142
  With an artifact id, the audit tool now returns **Replay Outline** by default. The outline gives one metadata-only row for each stable zero-based position in the persisted captured-message array. It includes role, content kinds and size, tool names, stop reason, and error presence. It does not include message prose, provider error text, tool arguments, tool results, arbitrary message fields, or file paths.
143
143
 
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-core",
3
- "version": "5.0.0",
3
+ "version": "6.0.0",
4
4
  "description": "Shared settings, configuration, reporting, and session infrastructure",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -53,7 +53,7 @@
53
53
  "./api": "./src/api.ts",
54
54
  "./config": "./src/config.ts",
55
55
  "./context": "./src/context.ts",
56
- "./debug": "./src/debug-registry.ts",
56
+ "./debug": "./src/debug.ts",
57
57
  "./evidence-badge": "./src/evidence-badge.ts",
58
58
  "./footer-registry": "./src/footer-registry.ts",
59
59
  "./llm": "./src/llm.ts",
@@ -11,7 +11,7 @@ export * from "./config.ts";
11
11
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
12
12
  export * from "./context.ts";
13
13
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
14
- export * from "./debug-registry.ts";
14
+ export * from "./debug.ts";
15
15
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
16
16
  export * from "./evidence-badge.ts";
17
17
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
@@ -4,9 +4,6 @@
4
4
  // supi-debug extension owns policy/configuration and exposes events through a
5
5
  // command/tool while this module stays dependency-free for producers.
6
6
 
7
- // biome-ignore lint/performance/noReExportAll: preserve the stable debug domain entry point
8
- export * from "./debug-timing.ts";
9
-
10
7
  export type DebugLevel = "debug" | "info" | "warning" | "error";
11
8
  export type DebugAgentAccess = "off" | "sanitized" | "raw";
12
9
  export interface DebugRegistryConfig {
@@ -0,0 +1,9 @@
1
+ // Debug domain entry for `@mrclrchtr/supi-core/debug`.
2
+ //
3
+ // Kept separate from debug-registry.ts so debug-timing.ts can import the
4
+ // registry without creating an import cycle through the barrel re-export.
5
+
6
+ // biome-ignore lint/performance/noReExportAll: preserve the stable debug domain entry point
7
+ export * from "./debug-registry.ts";
8
+ // biome-ignore lint/performance/noReExportAll: preserve the stable debug domain entry point
9
+ export * from "./debug-timing.ts";
@@ -11,7 +11,7 @@ export * from "./config.ts";
11
11
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
12
12
  export * from "./context.ts";
13
13
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
14
- export * from "./debug-registry.ts";
14
+ export * from "./debug.ts";
15
15
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
16
16
  export * from "./footer-registry.ts";
17
17
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-agent-runtime",
3
- "version": "5.0.0",
3
+ "version": "6.0.0",
4
4
  "description": "SuPi Agent Run runtime — neutral lifecycle management for in-process pi sessions",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -28,7 +28,7 @@
28
28
  "!__tests__"
29
29
  ],
30
30
  "dependencies": {
31
- "@mrclrchtr/supi-core": "5.0.0"
31
+ "@mrclrchtr/supi-core": "6.0.0"
32
32
  },
33
33
  "peerDependencies": {
34
34
  "@earendil-works/pi-ai": "*",
@@ -30,7 +30,7 @@ After installation, keep asking Pi normal coding questions. The agent can:
30
30
  - **Refactor safely** — preview language-aware renames and extractions before applying them. Plans are rejected if the files changed in the meantime.
31
31
  - **See uncertainty clearly** — results distinguish “nothing found” from incomplete or unavailable analysis and disclose omitted matches.
32
32
 
33
- When Pi recognizes a workspace, the agent also receives an architecture overview near the start of the session, so it can orient before spending turns opening files.
33
+ When Pi recognizes a workspace, the agent also receives a compact architecture overview near the start of the session, so it can orient before spending turns opening files. The overview contains manifest facts (module names, one-line descriptions, declared topology, declared entrypoints, and detected languages), is labeled as untrusted repository evidence, and is controlled by the `code-intelligence.overviewEnabled` setting in `/supi-settings`.
34
34
 
35
35
  ## Example requests
36
36
 
@@ -127,7 +127,7 @@ Open the status view to see detected languages, running or missing servers, and
127
127
  /supi-ci-status
128
128
  ```
129
129
 
130
- Use `/supi-settings` to disable language servers you do not need or change the instruction filenames surfaced during directory orientation. The defaults are `CLAUDE.md` and `AGENTS.md`.
130
+ Use `/supi-settings` to disable language servers you do not need, change the instruction filenames surfaced during directory orientation (defaults `CLAUDE.md` and `AGENTS.md`), or disable the first-turn architecture overview with `overviewEnabled`.
131
131
 
132
132
  [workspace-orientation]: https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-code-intelligence/assets/workspace-orientation.png
133
133
  [symbol-inspection]: https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-code-intelligence/assets/symbol-inspection.png
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-code-runtime",
3
- "version": "5.0.0",
3
+ "version": "6.0.0",
4
4
  "description": "Shared workspace context and capability contracts for code intelligence",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-core",
3
- "version": "5.0.0",
3
+ "version": "6.0.0",
4
4
  "description": "Shared settings, configuration, reporting, and session infrastructure",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -53,7 +53,7 @@
53
53
  "./api": "./src/api.ts",
54
54
  "./config": "./src/config.ts",
55
55
  "./context": "./src/context.ts",
56
- "./debug": "./src/debug-registry.ts",
56
+ "./debug": "./src/debug.ts",
57
57
  "./evidence-badge": "./src/evidence-badge.ts",
58
58
  "./footer-registry": "./src/footer-registry.ts",
59
59
  "./llm": "./src/llm.ts",
@@ -11,7 +11,7 @@ export * from "./config.ts";
11
11
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
12
12
  export * from "./context.ts";
13
13
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
14
- export * from "./debug-registry.ts";
14
+ export * from "./debug.ts";
15
15
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
16
16
  export * from "./evidence-badge.ts";
17
17
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
@@ -4,9 +4,6 @@
4
4
  // supi-debug extension owns policy/configuration and exposes events through a
5
5
  // command/tool while this module stays dependency-free for producers.
6
6
 
7
- // biome-ignore lint/performance/noReExportAll: preserve the stable debug domain entry point
8
- export * from "./debug-timing.ts";
9
-
10
7
  export type DebugLevel = "debug" | "info" | "warning" | "error";
11
8
  export type DebugAgentAccess = "off" | "sanitized" | "raw";
12
9
  export interface DebugRegistryConfig {
@@ -0,0 +1,9 @@
1
+ // Debug domain entry for `@mrclrchtr/supi-core/debug`.
2
+ //
3
+ // Kept separate from debug-registry.ts so debug-timing.ts can import the
4
+ // registry without creating an import cycle through the barrel re-export.
5
+
6
+ // biome-ignore lint/performance/noReExportAll: preserve the stable debug domain entry point
7
+ export * from "./debug-registry.ts";
8
+ // biome-ignore lint/performance/noReExportAll: preserve the stable debug domain entry point
9
+ export * from "./debug-timing.ts";
@@ -11,7 +11,7 @@ export * from "./config.ts";
11
11
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
12
12
  export * from "./context.ts";
13
13
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
14
- export * from "./debug-registry.ts";
14
+ export * from "./debug.ts";
15
15
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
16
16
  export * from "./footer-registry.ts";
17
17
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
@@ -37,17 +37,26 @@ The table records an initialize-handshake audit performed on 2026-08-21 against
37
37
  | SQL | `sql-language-server` 1.7.1 | No (confirmed) | Push | No `diagnosticProvider` in the initialize result. |
38
38
  | R | `R` 4.6.1 (languageserver) | No (confirmed) | Push | No `diagnosticProvider` in the initialize result. |
39
39
 
40
- SuPi advertises static and dynamic pull support (`textDocument.diagnostic.dynamicRegistration: true`). A server that declares a valid `diagnosticProvider` in its initialize result gets pull diagnostics; a server that registers `textDocument/diagnostic` after initialization gets pull diagnostics for as long as its registration stays active. Registration parameters are validated and malformed values reject the request without enabling pull. Other registration methods are ignored. Protocol support is separate from the configured mode: a server may support pull yet stay in SuPi's push mode because the built-in configuration does not enable it.
40
+ SuPi advertises static and dynamic pull support. It advertises server-requested refresh support too:
41
+
42
+ - `textDocument.diagnostic.dynamicRegistration: true`
43
+ - `workspace.diagnostics.refreshSupport: true`
44
+
45
+ A server gets pull diagnostics when it declares a valid `diagnosticProvider` during initialization. A server also gets pull diagnostics after it registers `textDocument/diagnostic`. The pull support stays active until the server removes the registration. SuPi validates registration parameters. Invalid parameters do not enable pull support. SuPi ignores other registration methods.
46
+
47
+ When a server sends `workspace/diagnostic/refresh`, SuPi returns `null` immediately. It then refreshes the owning client's tracked documents in the background. The refresh covers open, cached, and failed tracked documents. SuPi does not add workspace-wide `workspace/diagnostic` pulls.
48
+
49
+ Protocol support is separate from the configured mode. A server may support pull diagnostics and still use SuPi's push mode because the built-in configuration does not enable pull mode.
41
50
 
42
51
  The LSP 3.18 specification adds `Diagnostic.message` markup content, guarded by the client capability `textDocument.diagnostic.markupMessageSupport`; SuPi's validator already accepts plaintext and markdown messages but does not advertise the capability. Other 3.18 features (snippet text edits, inline completion, folding-range refresh, multi-range formatting) are outside the diagnostic surface and are not implemented.
43
52
 
44
53
  Pull diagnostics use `textDocument/diagnostic`, so the client can tie a report to the current request. Push diagnostics are asynchronous and can omit a document version. After a workspace change, SuPi may report push-only diagnostics as partial or unavailable when it cannot prove that the result matches the current document. It does not treat missing fresh evidence as a clean file.
45
54
 
46
- Unversioned pushes are accepted for an open document when they arrive after the document's sync moment (the client-side instant the `didChange` or `didOpen` that produced them was sent) and are re-stamped with the current synchronization; unversioned pushes for closed or untracked URIs, and pushes that arrive before a sync moment, stay fail-closed. On push-only routes, a document still unconfirmed after the settle window is closed and reopened over the protocol so the server publishes on `didOpen` (clean files get no push on `didChange` at all). The reopen keeps the cache entry and version history intact and does not restart the server.
55
+ Unversioned pushes are accepted for an open document when they arrive after the document's sync moment (the client-side instant the `didChange` or `didOpen` that produced them was sent) and are re-stamped with the current synchronization; unversioned pushes for closed or untracked URIs, and pushes that arrive before a sync moment, stay fail-closed. On push-only routes, the first valid publication for a synchronization is tentative. A later valid publication for the same synchronization confirms it, and every publication restarts the quiet period. If no publication arrives, the existing bounded reopen path may ask the server to publish on `didOpen`; a tentative timeout does not reopen that document. In a mixed batch, silent documents can still use the reopen path. Non-empty tentative diagnostics are visible as partial evidence, but they do not enter the confirmed path. An empty tentative publication cannot establish a clean file and stays unavailable until a diagnostic republish arrives. Repeated unchanged queries share the tentative publication's wait age instead of starting a new full wait. A late republish promotes the cache without a new refresh.
47
56
 
48
57
  Server readiness follows LSP work-done progress: a created progress token is pending and never blocks readiness; an observed `begin` marks active work and makes the client not ready until its `end` or the bounded per-token timeout.
49
58
 
50
- A workspace diagnostic refresh returns exact coverage counts for requested, confirmed, unconfirmed, failed, and removed tracked documents. `code_health` marks tracked-file diagnostics as complete only when every document in the requested scope has confirmed evidence. It keeps cached diagnostics as partial evidence and shows the same coverage counts in summary and detailed views; a refresh attempt does not prove fresh evidence by itself.
59
+ A workspace diagnostic refresh returns exact coverage counts for requested, confirmed, unconfirmed, failed, and removed tracked documents. `code_health` marks tracked-file diagnostics as complete when each requested document is confirmed or known to be removed. It shows non-empty tentative diagnostics as partial entries, reports the same coverage counts in summary and detailed views, and explains when a diagnostic republish is needed. A refresh attempt does not prove fresh evidence by itself. A removed file is reported by the refresh that finds it and is not retained in later tracked-file snapshots.
51
60
 
52
61
  An explicit recovery pass restarts a push-only client only on a protocol-stall signal (a readiness stall, or repeated JSON-RPC request failures) — never on unconfirmed evidence alone, because the reopen-resync fallback recovers unconfirmed documents without discarding warm server state. It never restarts a pull-capable client because push evidence is absent, and it never restarts a client during passive health display. Each client route restarts at most once per workspace invalidation generation. The replacement process has a fixed startup bound of 5 seconds; exceeding the bound fails closed as start-failed without retry. Recovery telemetry records the outcome, elapsed time, attempted clients, restart count, the bounded server names involved, and the stall signal that triggered a restart, without changing the evidence semantics of the result.
53
62
 
@@ -71,6 +80,28 @@ Configuration overrides merge with the built-in server definitions. Use `.pi/sup
71
80
 
72
81
  Gopls pull diagnostics stay opt-in while golang/go#70199 is open; without the option the built-in Go configuration stays in push mode. Kotlin's `--stdio` argument is already part of the built-in configuration and needs no override.
73
82
 
83
+ ### Custom server configuration
84
+
85
+ A custom server needs a command and at least one file type:
86
+
87
+ ```json
88
+ {
89
+ "lsp": {
90
+ "servers": {
91
+ "custom": {
92
+ "command": "custom-lsp",
93
+ "args": ["--stdio"],
94
+ "fileTypes": ["custom"],
95
+ "env": { "CUSTOM_LSP_LOG": "debug" },
96
+ "initializationOptions": { "mode": "project" }
97
+ }
98
+ }
99
+ }
100
+ }
101
+ ```
102
+
103
+ File types do not include a leading dot. If `rootMarkers` is omitted, the server uses the session root.
104
+
74
105
  The `lsp.enabled` and `lsp.active` settings are deprecated and ignored. Disable one language with `lsp.servers.<language>.enabled: false`. Use `/supi-ci-status` from `@mrclrchtr/supi-code-intelligence` to see detected, running, and missing servers.
75
106
 
76
107
  ## What it provides
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-code-runtime",
3
- "version": "5.0.0",
3
+ "version": "6.0.0",
4
4
  "description": "Shared workspace context and capability contracts for code intelligence",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-core",
3
- "version": "5.0.0",
3
+ "version": "6.0.0",
4
4
  "description": "Shared settings, configuration, reporting, and session infrastructure",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -53,7 +53,7 @@
53
53
  "./api": "./src/api.ts",
54
54
  "./config": "./src/config.ts",
55
55
  "./context": "./src/context.ts",
56
- "./debug": "./src/debug-registry.ts",
56
+ "./debug": "./src/debug.ts",
57
57
  "./evidence-badge": "./src/evidence-badge.ts",
58
58
  "./footer-registry": "./src/footer-registry.ts",
59
59
  "./llm": "./src/llm.ts",
@@ -11,7 +11,7 @@ export * from "./config.ts";
11
11
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
12
12
  export * from "./context.ts";
13
13
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
14
- export * from "./debug-registry.ts";
14
+ export * from "./debug.ts";
15
15
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
16
16
  export * from "./evidence-badge.ts";
17
17
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
@@ -4,9 +4,6 @@
4
4
  // supi-debug extension owns policy/configuration and exposes events through a
5
5
  // command/tool while this module stays dependency-free for producers.
6
6
 
7
- // biome-ignore lint/performance/noReExportAll: preserve the stable debug domain entry point
8
- export * from "./debug-timing.ts";
9
-
10
7
  export type DebugLevel = "debug" | "info" | "warning" | "error";
11
8
  export type DebugAgentAccess = "off" | "sanitized" | "raw";
12
9
  export interface DebugRegistryConfig {
@@ -0,0 +1,9 @@
1
+ // Debug domain entry for `@mrclrchtr/supi-core/debug`.
2
+ //
3
+ // Kept separate from debug-registry.ts so debug-timing.ts can import the
4
+ // registry without creating an import cycle through the barrel re-export.
5
+
6
+ // biome-ignore lint/performance/noReExportAll: preserve the stable debug domain entry point
7
+ export * from "./debug-registry.ts";
8
+ // biome-ignore lint/performance/noReExportAll: preserve the stable debug domain entry point
9
+ export * from "./debug-timing.ts";
@@ -11,7 +11,7 @@ export * from "./config.ts";
11
11
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
12
12
  export * from "./context.ts";
13
13
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
14
- export * from "./debug-registry.ts";
14
+ export * from "./debug.ts";
15
15
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
16
16
  export * from "./footer-registry.ts";
17
17
  // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-lsp",
3
- "version": "5.0.0",
3
+ "version": "6.0.0",
4
4
  "description": "Language Server Protocol runtime for SuPi code intelligence",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -37,8 +37,8 @@
37
37
  "vscode-jsonrpc": "^9.0.0",
38
38
  "vscode-languageserver-protocol": "^3.18.0",
39
39
  "vscode-languageserver-types": "^3.18.0",
40
- "@mrclrchtr/supi-core": "5.0.0",
41
- "@mrclrchtr/supi-code-runtime": "5.0.0"
40
+ "@mrclrchtr/supi-code-runtime": "6.0.0",
41
+ "@mrclrchtr/supi-core": "6.0.0"
42
42
  },
43
43
  "bundledDependencies": [
44
44
  "@mrclrchtr/supi-code-runtime",
@@ -8,7 +8,16 @@ export {
8
8
  hasDeprecatedLspKeys,
9
9
  loadLspSettings,
10
10
  } from "./config/lsp-settings.ts";
11
- export { clearTsconfigCache } from "./config/tsconfig-scope.ts";
11
+ export {
12
+ clearTsconfigCache,
13
+ type FileScopeDecision,
14
+ type FileScopeStatus,
15
+ getFileScopeDecision,
16
+ invalidateTsconfigCacheForConfig,
17
+ invalidateTsconfigCacheForConfigDir,
18
+ isProjectConfigFileName,
19
+ type ScopeDecisionBasis,
20
+ } from "./config/tsconfig-scope.ts";
12
21
  export type {
13
22
  CodeAction,
14
23
  Diagnostic,
@@ -28,6 +37,7 @@ export type {
28
37
  } from "./config/types.ts";
29
38
  export { FileChangeType } from "./config/types.ts";
30
39
  export { toLspPosition, toOneBasedPosition } from "./coordinates.ts";
40
+ export { TENTATIVE_PUSH_UNAVAILABLE_REASON } from "./diagnostics/evidence.ts";
31
41
  export { isLikelyStaleDiagnostic } from "./diagnostics/stale-diagnostics.ts";
32
42
  export {
33
43
  scanWorkspaceSentinels,
@@ -50,6 +60,7 @@ export type {
50
60
  RecoverDiagnosticsResult,
51
61
  RoutedMutationResponse,
52
62
  SemanticReadinessResult,
63
+ WorkspaceDiagnosticReport,
53
64
  WorkspaceDiagnosticSnapshot,
54
65
  WorkspaceDiagnosticSummaryEntry,
55
66
  WorkspaceLspDiagnosticSurface,
@@ -2,6 +2,7 @@ import type { PublishDiagnosticsParams } from "../config/types.ts";
2
2
  import { uriToFile } from "../utils.ts";
3
3
  import {
4
4
  type DiagnosticCacheEntry,
5
+ isTentativePushEntry,
5
6
  isValidPublishDiagnosticsParams,
6
7
  } from "./client-diagnostic-evidence.ts";
7
8
  import type { ClientDiagnosticSnapshot, OpenDocumentState } from "./client-document-state.ts";
@@ -20,27 +21,44 @@ interface ApplyPushOptions {
20
21
  }
21
22
 
22
23
  /**
23
- * Apply one valid push publication and return whether it can release current waiters.
24
+ * Apply one valid push publication.
24
25
  *
25
- * Fail-closed policy (ADR 0020): unversioned pushes are rejected for closed
26
- * and untracked URIs and for arrivals before the URI's sync moment; versioned
27
- * pushes for a URI closed by a lifecycle operation are rejected because their
28
- * version cannot be verified. An unversioned push that arrives after the sync
29
- * moment of an open document is accepted and re-stamped with that document's
30
- * current synchronization state.
26
+ * Returns whether the publication was accepted and whether it promoted a
27
+ * tentative entry to confirmed. Fail-closed policy (ADR 0020): unversioned
28
+ * pushes are rejected for closed and untracked URIs and for arrivals before
29
+ * the URI's sync moment; versioned pushes for a URI closed by a lifecycle
30
+ * operation are rejected because their version cannot be verified. An
31
+ * unversioned push that arrives after the sync moment of an open document
32
+ * is accepted and re-stamped with that document's current synchronization
33
+ * state. The first valid publication for a synchronization is tentative; a
34
+ * later valid publication for the same synchronization ID and evidence
35
+ * revision promotes the cache to confirmed (ADR 0021).
31
36
  */
32
- export function applyPushDiagnostics(options: ApplyPushOptions): boolean {
33
- if (!isValidPublishDiagnosticsParams(options.params)) return false;
37
+ export function applyPushDiagnostics(options: ApplyPushOptions): {
38
+ accepted: boolean;
39
+ promoted: boolean;
40
+ } {
41
+ if (!isValidPublishDiagnosticsParams(options.params)) return { accepted: false, promoted: false };
34
42
  const openDocument = options.openDocuments.get(options.params.uri);
35
43
  if (options.params.version !== undefined) {
36
- if (!Number.isInteger(options.params.version)) return false;
37
- if (openDocument && options.params.version !== openDocument.version) return false;
38
- if (!openDocument && options.closedVersionedBarrier) return false;
44
+ if (!Number.isInteger(options.params.version)) return { accepted: false, promoted: false };
45
+ if (openDocument && options.params.version !== openDocument.version) {
46
+ return { accepted: false, promoted: false };
47
+ }
48
+ if (!openDocument && options.closedVersionedBarrier)
49
+ return { accepted: false, promoted: false };
39
50
  }
40
- if (!Array.isArray(options.params.diagnostics)) return false;
41
- if (!acceptUnversionedPush(options, openDocument)) return false;
42
- options.store.set(options.params.uri, buildPushCacheEntry(options, openDocument));
43
- return true;
51
+ if (!Array.isArray(options.params.diagnostics)) return { accepted: false, promoted: false };
52
+ if (!acceptUnversionedPush(options, openDocument)) return { accepted: false, promoted: false };
53
+ const entry = buildPushCacheEntry(options, openDocument);
54
+ const previous = options.store.get(options.params.uri);
55
+ const promoted =
56
+ entry.source === "push" &&
57
+ entry.publications !== undefined &&
58
+ entry.publications >= 2 &&
59
+ isTentativePushEntry(previous);
60
+ options.store.set(options.params.uri, entry);
61
+ return { accepted: true, promoted };
44
62
  }
45
63
 
46
64
  /** Gate one unversioned push publication against the sync-moment policy. */
@@ -69,13 +87,27 @@ function buildPushCacheEntry(
69
87
  ): DiagnosticCacheEntry {
70
88
  const currentRevision = openDocument?.evidenceRevision === options.evidenceRevision;
71
89
  const unversioned = options.params.version === undefined && openDocument !== undefined;
90
+ const synchronizationId =
91
+ unversioned || currentRevision ? openDocument?.synchronizationId : undefined;
92
+ const evidenceRevision = openDocument?.evidenceRevision;
93
+ const previous = options.store.get(options.params.uri);
94
+ // A later valid publication for the same synchronization ID and evidence
95
+ // revision continues the entry's publication count: a confirmed pull
96
+ // entry keeps the synchronization confirmed, and a tentative push entry
97
+ // is promoted. Any other publication starts a fresh count.
98
+ const sameSynchronization =
99
+ synchronizationId !== undefined &&
100
+ previous?.synchronizationId === synchronizationId &&
101
+ previous.evidenceRevision === evidenceRevision;
102
+ const publications = sameSynchronization ? Math.min((previous.publications ?? 1) + 1, 2) : 1;
72
103
  return {
73
104
  diagnostics: options.params.diagnostics,
74
105
  receivedAt: Date.now(),
75
106
  source: "push",
76
- synchronizationId: unversioned || currentRevision ? openDocument?.synchronizationId : undefined,
77
- evidenceRevision: openDocument?.evidenceRevision,
107
+ synchronizationId,
108
+ evidenceRevision,
78
109
  version: options.params.version,
110
+ publications,
79
111
  };
80
112
  }
81
113
 
@@ -119,17 +151,18 @@ function collectOpenDocumentFreshness(options: {
119
151
  const uris = new Set<string>();
120
152
  for (const [uri, document] of options.openDocuments) {
121
153
  uris.add(uri);
154
+ const entry = options.store.get(uri);
122
155
  const fileState = getDiagnosticFileState(uriToFile(uri));
123
- const current = hasCurrentDiagnosticEvidence(
124
- document,
125
- options.store.get(uri),
126
- options.evidenceRevision,
127
- );
156
+ const current = hasCurrentDiagnosticEvidence(document, entry, options.evidenceRevision);
128
157
  const failed = options.failedDocuments.has(uri);
158
+ // A current tentative push maps to unconfirmed, not to a new public
159
+ // status: it matches the synchronization but cannot confirm it yet, so
160
+ // it must not claim current snapshot or document state (issue #351).
161
+ const tentative = current && isTentativePushEntry(entry);
129
162
  documents.push({
130
163
  uri,
131
- current: fileState === "present" && current && !failed,
132
- status: statusForDocument(fileState, current, failed),
164
+ current: fileState === "present" && current && !failed && !tentative,
165
+ status: statusForDocument(fileState, current, failed, tentative),
133
166
  });
134
167
  }
135
168
  return { documents, uris };
@@ -174,10 +207,12 @@ function statusForDocument(
174
207
  fileState: ReturnType<typeof getDiagnosticFileState>,
175
208
  current: boolean,
176
209
  failed: boolean,
210
+ tentative: boolean,
177
211
  ): "confirmed" | "unconfirmed" | "failed" | "removed" {
178
212
  if (fileState === "removed") return "removed";
179
213
  if (fileState === "unreadable" || failed) return "failed";
180
- return current ? "confirmed" : "unconfirmed";
214
+ if (tentative || !current) return "unconfirmed";
215
+ return "confirmed";
181
216
  }
182
217
 
183
218
  function collectCachedDiagnostics(options: {
@@ -197,9 +232,13 @@ function collectCachedDiagnostics(options: {
197
232
  entry,
198
233
  options.evidenceRevision,
199
234
  );
200
- current &&= entryCurrent;
235
+ // A current tentative error is useful partial evidence. Keep its entry
236
+ // non-current so it cannot establish a clean or settled result (ADR 0021).
237
+ const tentative = entryCurrent && isTentativePushEntry(entry);
238
+ const confirmed = entryCurrent && !tentative;
239
+ current &&= confirmed;
201
240
  if (entry.diagnostics.length > 0) {
202
- entries.push({ uri, diagnostics: entry.diagnostics, current: entryCurrent });
241
+ entries.push({ uri, diagnostics: entry.diagnostics, current: confirmed });
203
242
  }
204
243
  }
205
244
  return { entries, current };