@mrclrchtr/supi-review 4.10.0 → 5.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 (311) hide show
  1. package/README.md +92 -103
  2. package/node_modules/@mrclrchtr/supi-agent-runtime/README.md +38 -0
  3. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/README.md +116 -0
  4. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/package.json +72 -0
  5. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/api.ts +40 -0
  6. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/config/config.ts +232 -0
  7. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/config/prompt-surface.ts +363 -0
  8. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/config.ts +12 -0
  9. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/context/context-provider-registry.ts +36 -0
  10. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/context/context-tag.ts +31 -0
  11. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/context.ts +8 -0
  12. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +311 -0
  13. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/debug-timing.ts +120 -0
  14. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/evidence-badge.ts +41 -0
  15. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts +57 -0
  16. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/index.ts +34 -0
  17. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/llm.ts +201 -0
  18. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/model-selection.ts +134 -0
  19. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/path-utils.ts +44 -0
  20. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/path.ts +2 -0
  21. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/project-roots.ts +170 -0
  22. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/project.ts +15 -0
  23. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/prompt-surface.ts +4 -0
  24. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/registry-utils.ts +93 -0
  25. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/report.ts +121 -0
  26. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/session-utils.ts +71 -0
  27. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/session.ts +8 -0
  28. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +105 -0
  29. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts +453 -0
  30. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/settings.ts +36 -0
  31. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/spinner-frames.ts +11 -0
  32. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/status-spinner.ts +68 -0
  33. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/terminal.ts +60 -0
  34. package/node_modules/@mrclrchtr/supi-agent-runtime/package.json +50 -0
  35. package/node_modules/@mrclrchtr/supi-agent-runtime/src/api.ts +42 -0
  36. package/node_modules/@mrclrchtr/supi-agent-runtime/src/diagnostic-sanitizer.ts +72 -0
  37. package/node_modules/@mrclrchtr/supi-agent-runtime/src/diagnostics.ts +203 -0
  38. package/node_modules/@mrclrchtr/supi-agent-runtime/src/lifecycle-trace.ts +275 -0
  39. package/node_modules/@mrclrchtr/supi-agent-runtime/src/provider-authority.ts +232 -0
  40. package/node_modules/@mrclrchtr/supi-agent-runtime/src/run.ts +1034 -0
  41. package/node_modules/@mrclrchtr/supi-agent-runtime/src/session-view.ts +120 -0
  42. package/node_modules/@mrclrchtr/supi-agent-runtime/src/types.ts +289 -0
  43. package/node_modules/@mrclrchtr/supi-agent-runtime/src/usage.ts +172 -0
  44. package/node_modules/@mrclrchtr/supi-code-intelligence/README.md +2 -1
  45. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/README.md +2 -0
  46. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  47. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +9 -0
  48. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/capability/types.ts +53 -13
  49. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/request-control.ts +47 -0
  50. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +13 -1
  51. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/README.md +2 -0
  52. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  53. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
  54. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
  55. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -3
  56. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +3 -0
  57. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/README.md +80 -5
  58. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/README.md +2 -0
  59. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  60. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +9 -0
  61. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/capability/types.ts +53 -13
  62. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/request-control.ts +47 -0
  63. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +13 -1
  64. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/README.md +2 -0
  65. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  66. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
  67. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
  68. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -3
  69. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +3 -0
  70. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/package.json +7 -6
  71. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/api.ts +10 -0
  72. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-cache.ts +206 -0
  73. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-capabilities.ts +78 -0
  74. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-collection.ts +114 -0
  75. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-evidence.ts +372 -0
  76. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-host.ts +14 -0
  77. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-pull.ts +62 -0
  78. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-refresh.ts +491 -0
  79. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-request.ts +9 -0
  80. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-timing.ts +71 -11
  81. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-waiters.ts +206 -0
  82. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostics.ts +365 -297
  83. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-state.ts +52 -0
  84. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-sync.ts +185 -0
  85. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-file-state.ts +25 -0
  86. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client.ts +467 -115
  87. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/transport.ts +161 -33
  88. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/capabilities.ts +10 -1
  89. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/defaults.json +1 -1
  90. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/debug-telemetry.ts +45 -0
  91. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/evidence.ts +38 -0
  92. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-client-state.ts +79 -9
  93. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-diagnostics.ts +13 -4
  94. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-workspace-recovery.ts +300 -24
  95. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-workspace-symbol.ts +5 -2
  96. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +464 -96
  97. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/lsp-refactor-provider.ts +130 -0
  98. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/lsp-semantic-provider.ts +45 -329
  99. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/refactor-planning.ts +57 -120
  100. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-edit-normalizer.ts +320 -0
  101. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-symbol-mapper.ts +207 -0
  102. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/readiness.ts +72 -2
  103. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-controller.ts +151 -26
  104. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostic-surface.ts +40 -0
  105. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostics.ts +50 -0
  106. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +136 -120
  107. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-transition-debug.ts +49 -0
  108. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +102 -0
  109. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/README.md +17 -7
  110. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/README.md +2 -0
  111. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  112. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +9 -0
  113. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/capability/types.ts +53 -13
  114. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/request-control.ts +47 -0
  115. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +13 -1
  116. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/README.md +2 -0
  117. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  118. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
  119. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
  120. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -3
  121. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +3 -0
  122. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/LICENSE +21 -0
  123. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/README.md +258 -0
  124. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/dist/babel.cjs +257 -0
  125. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/dist/jiti.cjs +1 -0
  126. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-cli.mjs +34 -0
  127. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-hooks.mjs +124 -0
  128. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-native.mjs +121 -0
  129. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-register.d.mts +1 -0
  130. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-register.mjs +4 -0
  131. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-static.mjs +23 -0
  132. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.cjs +30 -0
  133. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.d.cts +8 -0
  134. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.d.mts +8 -0
  135. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.mjs +29 -0
  136. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/types.d.ts +420 -0
  137. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/package.json +146 -0
  138. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/package.json +6 -3
  139. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/api.ts +0 -9
  140. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/index.ts +0 -8
  141. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/provider/tree-sitter-provider.ts +16 -12
  142. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/runtime-controller.ts +65 -87
  143. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/session.ts +47 -95
  144. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-timing.ts +147 -0
  145. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-client-lifecycle.ts +39 -0
  146. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-client.ts +561 -0
  147. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-message-size.ts +24 -0
  148. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-protocol.ts +452 -0
  149. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/call-sites.ts +4 -2
  150. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/callees.ts +12 -4
  151. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/exports.ts +4 -2
  152. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/imports.ts +4 -2
  153. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/node-at.ts +5 -3
  154. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/types.ts +33 -12
  155. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/blocking-test-bootstrap.mjs +34 -0
  156. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/bootstrap.mjs +8 -0
  157. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/parsed-file-store-helpers.ts +23 -0
  158. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/parsed-file-store.ts +400 -0
  159. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/request-control.ts +48 -0
  160. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime-parser-helpers.ts +24 -0
  161. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime-query-helpers.ts +43 -0
  162. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime.ts +421 -0
  163. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/service.ts +116 -0
  164. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/worker-main.ts +201 -0
  165. package/node_modules/@mrclrchtr/supi-code-intelligence/package.json +5 -5
  166. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/diagnostics.ts +236 -24
  167. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/recovery.ts +6 -2
  168. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/provider.ts +58 -0
  169. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/readiness.ts +30 -9
  170. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/refactor/apply.ts +45 -1
  171. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/refactor/mutation-authority.ts +143 -0
  172. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/callees.ts +9 -1
  173. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/types.ts +5 -2
  174. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/ast-scan-timing.ts +9 -2
  175. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/ast-scan.ts +1 -1
  176. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/deadline.ts +2 -2
  177. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern-analysis.ts +46 -32
  178. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern.ts +12 -2
  179. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/anchored.ts +20 -11
  180. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/file.ts +18 -11
  181. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/identity.ts +19 -3
  182. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/symbol.ts +36 -15
  183. package/node_modules/@mrclrchtr/supi-code-intelligence/src/api.ts +4 -0
  184. package/node_modules/@mrclrchtr/supi-code-intelligence/src/diagnostics/evidence.ts +51 -0
  185. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/capability-adapter.ts +12 -3
  186. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/find-workflow.ts +17 -7
  187. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph/collect.ts +18 -2
  188. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph-workflow.ts +19 -12
  189. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-refresh.ts +148 -0
  190. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-types.ts +37 -15
  191. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-workflow.ts +37 -39
  192. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect/collect.ts +20 -3
  193. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect-workflow.ts +10 -5
  194. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/collect.ts +10 -1
  195. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/context-facts.ts +3 -1
  196. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/context-sections.ts +20 -7
  197. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/gather.ts +17 -11
  198. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-types.ts +2 -1
  199. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-workflow.ts +15 -8
  200. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-plans.ts +2 -0
  201. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-workflow.ts +59 -14
  202. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/session.ts +4 -1
  203. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/target-workflow.ts +54 -23
  204. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/workflow-control.ts +7 -3
  205. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/lifecycle.ts +26 -46
  206. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/maintenance.ts +199 -25
  207. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/state.ts +2 -2
  208. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/workspace-provider-host.ts +25 -3
  209. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/find/execute.ts +7 -1
  210. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/find/render.ts +20 -3
  211. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/find/tui.ts +23 -21
  212. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/graph/execute.ts +23 -3
  213. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/graph/tui.ts +59 -46
  214. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/health/execute.ts +7 -2
  215. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/health/markdown.ts +56 -14
  216. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/health/refresh-status.ts +105 -0
  217. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/health/tui.ts +95 -98
  218. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/infra/workflow-control.ts +8 -0
  219. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/inspect/execute.ts +7 -1
  220. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/inspect/tui.ts +26 -18
  221. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/orientation/execute.ts +21 -3
  222. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/orientation/tui.ts +51 -35
  223. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/refactor-apply/execute.ts +3 -0
  224. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/refactor-apply/tui.ts +43 -25
  225. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/refactor-plan/execute.ts +4 -0
  226. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/refactor-plan/tui.ts +33 -20
  227. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/register.ts +127 -22
  228. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/resolve/execute.ts +18 -1
  229. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/resolve/tui.ts +42 -24
  230. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/display.ts +107 -0
  231. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/errors.ts +20 -17
  232. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/find.ts +52 -8
  233. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/graph.ts +44 -1
  234. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/health.ts +53 -1
  235. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/inspect.ts +113 -1
  236. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/orientation.ts +66 -14
  237. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/refactor.ts +36 -4
  238. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/resolve.ts +44 -7
  239. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/types.ts +20 -0
  240. package/node_modules/@mrclrchtr/supi-code-intelligence/src/types/execution.ts +18 -5
  241. package/node_modules/@mrclrchtr/supi-code-intelligence/src/types/index.ts +8 -1
  242. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/status-command.ts +5 -3
  243. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/status-overlay.ts +4 -0
  244. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/common.ts +108 -10
  245. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/display.ts +48 -0
  246. package/node_modules/@mrclrchtr/supi-core/README.md +2 -0
  247. package/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  248. package/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
  249. package/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
  250. package/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -3
  251. package/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +3 -0
  252. package/package.json +6 -4
  253. package/src/audit/local-review-audit-store.ts +30 -6
  254. package/src/audit/replay-outline.ts +89 -0
  255. package/src/audit/review-audit-record.ts +40 -0
  256. package/src/audit/review-audit.ts +16 -4
  257. package/src/config.ts +44 -3
  258. package/src/git-command.ts +179 -23
  259. package/src/git.ts +71 -74
  260. package/src/history/collect.ts +13 -1
  261. package/src/model.ts +14 -0
  262. package/src/review-input.ts +72 -39
  263. package/src/review-limits.ts +1 -0
  264. package/src/review-path.ts +11 -63
  265. package/src/review-result.ts +7 -5
  266. package/src/review-scope.ts +164 -0
  267. package/src/review.ts +18 -342
  268. package/src/session/review-artifact-store.ts +2 -2
  269. package/src/target/change-metadata.ts +10 -9
  270. package/src/target/diff.ts +19 -16
  271. package/src/target/file-manifest.ts +1 -0
  272. package/src/target/packet.ts +78 -97
  273. package/src/target/resolve.ts +207 -227
  274. package/src/target/snapshot-match.ts +4 -23
  275. package/src/tool/agent-review-schemas.ts +135 -219
  276. package/src/tool/agent-review-tools.ts +65 -238
  277. package/src/tool/child-failure-diagnostics.ts +14 -156
  278. package/src/tool/child-session-runner.ts +119 -123
  279. package/src/tool/output-page.ts +33 -9
  280. package/src/tool/planner-input.ts +37 -0
  281. package/src/tool/planner-runner.ts +14 -13
  282. package/src/tool/post-review-policy.ts +9 -4
  283. package/src/tool/review-audit-tool.ts +159 -75
  284. package/src/tool/review-debug-summary.ts +8 -3
  285. package/src/tool/review-execution.ts +23 -7
  286. package/src/tool/review-format.ts +36 -27
  287. package/src/tool/review-output-tool.ts +20 -41
  288. package/src/tool/review-recovery.ts +191 -0
  289. package/src/tool/review-runner.ts +55 -14
  290. package/src/tool/review-system-prompt.ts +6 -6
  291. package/src/tool/review-tools.ts +45 -6
  292. package/src/tool/review-workflow.ts +250 -245
  293. package/src/tool/schemas.ts +32 -10
  294. package/src/tool/tool-specs.ts +137 -0
  295. package/src/tui/common.ts +18 -0
  296. package/src/tui/paged-output.ts +37 -14
  297. package/src/tui/review-command.ts +407 -0
  298. package/src/tui/review-scope-picker.ts +38 -0
  299. package/src/tui/review-target-picker.ts +106 -0
  300. package/src/tui/run.ts +90 -122
  301. package/src/types.ts +74 -88
  302. package/src/workspace/review-workspace.ts +59 -79
  303. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/runtime.ts +0 -351
  304. package/src/session/review-plan-store.ts +0 -124
  305. package/src/tool/child-lifecycle-trace.ts +0 -345
  306. package/src/tool/child-usage.ts +0 -73
  307. package/src/tool/criteria-only-scope.ts +0 -31
  308. package/src/tool/diagnostic-sanitizer.ts +0 -35
  309. package/src/tool/runner-helpers.ts +0 -52
  310. package/src/tool/session-lifecycle.ts +0 -281
  311. package/src/tui/prepare.ts +0 -187
@@ -1,10 +1,9 @@
1
1
  import { createHash, randomUUID } from "node:crypto";
2
- import { lstat, mkdtemp, realpath, rm, writeFile } from "node:fs/promises";
2
+ import { mkdtemp, realpath, rm, writeFile } from "node:fs/promises";
3
3
  import { tmpdir } from "node:os";
4
4
  import { dirname, join } from "node:path";
5
5
  import { readReviewDiff } from "../git.ts";
6
6
  import { runGit, runGitAllowExit } from "../git-command.ts";
7
- import { resolveReviewPath } from "../review-path.ts";
8
7
  import type { ReviewSnapshot, ReviewWorkspaceReceipt } from "../types.ts";
9
8
 
10
9
  const WORKSPACE_MARKER = "supi-review:";
@@ -23,18 +22,17 @@ export interface ReviewWorkspace {
23
22
  cleanup(): Promise<ReviewWorkspaceCleanupWarning | undefined>;
24
23
  }
25
24
 
26
- function sha256(value: string): string {
27
- return createHash("sha256").update(value, "utf8").digest("hex");
25
+ function sha256(value: Buffer): string {
26
+ return createHash("sha256").update(value).digest("hex");
28
27
  }
29
28
 
30
- function afterCommit(snapshot: ReviewSnapshot): string {
31
- if (snapshot.target.kind === "working-tree") {
32
- return snapshot.target.mergeBaseCommit ?? snapshot.target.headCommit;
29
+ function workspaceHead(snapshot: ReviewSnapshot): string {
30
+ if (snapshot.target.includeUncommittedChanges) {
31
+ if (!snapshot.target.fromCommit)
32
+ throw new Error("Filesystem Review Target has no freeze base.");
33
+ return snapshot.target.fromCommit;
33
34
  }
34
- if (snapshot.target.kind === "current-state") return snapshot.target.headCommit;
35
- return snapshot.target.kind === "comparison"
36
- ? snapshot.target.headCommit
37
- : snapshot.target.commit;
35
+ return snapshot.target.toCommit;
38
36
  }
39
37
 
40
38
  function lockReason(): string {
@@ -45,76 +43,48 @@ function shellQuote(value: string): string {
45
43
  return `'${value.replaceAll("'", "'\"'\"")}'`;
46
44
  }
47
45
 
48
- function baselineRevision(snapshot: ReviewSnapshot): string {
49
- if (snapshot.target.kind === "working-tree") {
50
- return snapshot.target.mergeBaseCommit ?? snapshot.target.headCommit;
51
- }
52
- if (snapshot.target.kind === "current-state") return snapshot.target.headCommit;
53
- if (snapshot.target.kind === "comparison") return snapshot.target.mergeBaseCommit;
54
- return snapshot.target.parentCommit ?? "empty-tree";
55
- }
56
-
57
46
  function workspaceSnapshot(snapshot: ReviewSnapshot, cwd: string): ReviewSnapshot {
58
- if (snapshot.target.kind !== "working-tree") return { ...snapshot, repositoryRoot: cwd };
59
- return {
60
- ...snapshot,
61
- repositoryRoot: cwd,
62
- target: { kind: "working-tree", headCommit: afterCommit(snapshot) },
63
- };
64
- }
65
-
66
- async function verifyReviewScope(snapshot: ReviewSnapshot, cwd: string): Promise<void> {
67
- if (snapshot.requestedTarget.kind !== "current-state") return;
68
- for (const path of snapshot.requestedTarget.paths ?? []) {
69
- try {
70
- await lstat(resolveReviewPath(cwd, path).absolute);
71
- } catch (error) {
72
- if (
73
- error &&
74
- typeof error === "object" &&
75
- "code" in error &&
76
- ((error as { code?: unknown }).code === "ENOENT" ||
77
- (error as { code?: unknown }).code === "ENOTDIR")
78
- ) {
79
- throw new Error(`Review Workspace does not contain Review Scope path: ${path}.`, {
80
- cause: error,
81
- });
82
- }
83
- throw error;
84
- }
85
- }
47
+ return { ...snapshot, repositoryRoot: cwd };
86
48
  }
87
49
 
88
50
  /** Re-read the frozen workspace through the canonical patch compiler before children can inspect it. */
89
51
  async function verifyWorkspace(
90
52
  snapshot: ReviewSnapshot,
91
53
  cwd: string,
54
+ signal?: AbortSignal,
92
55
  ): Promise<ReviewWorkspaceReceipt> {
93
- await verifyReviewScope(snapshot, cwd);
94
- const expectedWorkspaceHead = afterCommit(snapshot);
56
+ const expectedWorkspaceHead = workspaceHead(snapshot);
95
57
  const observedWorkspaceHead = (
96
- await runGit(cwd, [
97
- "rev-parse",
98
- "--verify",
99
- // biome-ignore lint/security/noSecrets: Git revision syntax, not a secret
100
- "HEAD^{commit}",
101
- ])
58
+ await runGit(
59
+ cwd,
60
+ [
61
+ "rev-parse",
62
+ "--verify",
63
+ // biome-ignore lint/security/noSecrets: Git revision syntax, not a secret
64
+ "HEAD^{commit}",
65
+ ],
66
+ undefined,
67
+ signal,
68
+ )
102
69
  ).trim();
103
70
  if (observedWorkspaceHead !== expectedWorkspaceHead) {
104
71
  throw new Error("Review Workspace checked out an unexpected commit.");
105
72
  }
106
- if (snapshot.target.kind !== "working-tree" && snapshot.target.kind !== "current-state") {
107
- const status = await runGit(cwd, ["status", "--porcelain"]);
73
+ if (!snapshot.target.includeUncommittedChanges) {
74
+ const status = await runGit(cwd, ["status", "--porcelain"], undefined, signal);
108
75
  if (status) throw new Error("Review Workspace was not clean after checkout.");
109
76
  }
110
- const observedDiffHash = sha256(await readReviewDiff(cwd, workspaceSnapshot(snapshot, cwd)));
77
+ const observedDiffHash = sha256(
78
+ await readReviewDiff(cwd, workspaceSnapshot(snapshot, cwd), undefined, signal),
79
+ );
111
80
  if (observedDiffHash !== snapshot.diffHash) {
112
81
  throw new Error("Review Workspace does not match the pinned target patch.");
113
82
  }
114
83
  return {
115
84
  status: "verified",
116
- targetKind: snapshot.target.kind,
117
- baselineRevision: baselineRevision(snapshot),
85
+ ...(snapshot.target.fromCommit ? { fromCommit: snapshot.target.fromCommit } : {}),
86
+ toCommit: snapshot.target.toCommit,
87
+ includeUncommittedChanges: snapshot.target.includeUncommittedChanges,
118
88
  expectedWorkspaceHead,
119
89
  observedWorkspaceHead,
120
90
  expectedDiffHash: snapshot.diffHash,
@@ -125,12 +95,14 @@ async function verifyWorkspace(
125
95
 
126
96
  /**
127
97
  * Materialize one exact Review Snapshot as a disposable linked worktree.
128
- * Working-tree targets replay the already-hashed canonical patch over their
129
- * pinned baseline and stage it so `git diff HEAD` exposes the full after-state.
98
+ * Filesystem targets replay one already-hashed canonical patch over the exact
99
+ * freeze base and stage it so each Reviewer Session sees the frozen after state.
130
100
  */
131
101
  export async function materializeReviewWorkspace(
132
102
  snapshot: ReviewSnapshot,
103
+ signal?: AbortSignal,
133
104
  ): Promise<ReviewWorkspace> {
105
+ signal?.throwIfAborted();
134
106
  const parent = await mkdtemp(join(tmpdir(), "supi-review-workspace-"));
135
107
  const workspacePath = join(parent, "workspace");
136
108
  let cwd = workspacePath;
@@ -138,30 +110,38 @@ export async function materializeReviewWorkspace(
138
110
  let receipt: ReviewWorkspaceReceipt | undefined;
139
111
 
140
112
  try {
141
- await runGit(snapshot.repositoryRoot, [
142
- "worktree",
143
- "add",
144
- "--detach",
145
- workspacePath,
146
- afterCommit(snapshot),
147
- ]);
113
+ await runGit(
114
+ snapshot.repositoryRoot,
115
+ ["worktree", "add", "--detach", workspacePath, workspaceHead(snapshot)],
116
+ undefined,
117
+ signal,
118
+ );
148
119
  created = true;
149
120
  cwd = await realpath(workspacePath);
150
- await runGit(snapshot.repositoryRoot, ["worktree", "lock", "--reason", lockReason(), cwd]);
151
-
152
- if (snapshot.target.kind === "working-tree" || snapshot.target.kind === "current-state") {
153
- const patch = await readReviewDiff(snapshot.repositoryRoot, snapshot);
121
+ await runGit(
122
+ snapshot.repositoryRoot,
123
+ ["worktree", "lock", "--reason", lockReason(), cwd],
124
+ undefined,
125
+ signal,
126
+ );
127
+
128
+ if (snapshot.target.includeUncommittedChanges) {
129
+ const patch = await readReviewDiff(snapshot.repositoryRoot, snapshot, undefined, signal);
154
130
  if (sha256(patch) !== snapshot.diffHash) {
155
131
  throw new Error("The review target changed before its Review Workspace was frozen.");
156
132
  }
157
- // An unchanged current state freezes to its HEAD checkout without a patch.
158
- if (patch) {
133
+ if (patch.length > 0) {
159
134
  const patchPath = join(parent, "target.patch");
160
- await writeFile(patchPath, patch, "utf8");
161
- await runGit(cwd, ["apply", "--index", "--binary", "--whitespace=nowarn", patchPath]);
135
+ await writeFile(patchPath, patch, { signal });
136
+ await runGit(
137
+ cwd,
138
+ ["apply", "--index", "--binary", "--whitespace=nowarn", patchPath],
139
+ undefined,
140
+ signal,
141
+ );
162
142
  }
163
143
  }
164
- receipt = await verifyWorkspace(snapshot, cwd);
144
+ receipt = await verifyWorkspace(snapshot, cwd, signal);
165
145
  } catch (error) {
166
146
  if (created) {
167
147
  await runGitAllowExit(snapshot.repositoryRoot, ["worktree", "unlock", cwd], [128]).catch(
@@ -1,351 +0,0 @@
1
- // Tree-sitter runtime — parser management, parse, and query services.
2
-
3
- import { createHash } from "node:crypto";
4
- import * as fs from "node:fs";
5
- import * as path from "node:path";
6
- import { startDebugTimer } from "@mrclrchtr/supi-core/debug";
7
- import { resolveToolPath } from "@mrclrchtr/supi-core/path";
8
- import type { Language, Parser, Tree } from "web-tree-sitter";
9
- import { nodeToRange } from "../coordinates.ts";
10
- import { detectGrammar, resolveGrammarWasmPath } from "../language.ts";
11
- import type { GrammarId, QueryCapture, TreeSitterResult } from "../types.ts";
12
-
13
- interface ParserEntry {
14
- parser: Parser;
15
- language: Language;
16
- }
17
-
18
- /**
19
- * Session-scoped Tree-sitter runtime.
20
- *
21
- * A runtime owns the expensive `web-tree-sitter` initialization and parser
22
- * instances for one pi working directory. Call `dispose()` when the session is
23
- * torn down so WASM parser resources are released.
24
- */
25
- export class TreeSitterRuntime {
26
- private parserModule: typeof import("web-tree-sitter") | undefined;
27
- private parsers = new Map<GrammarId, ParserEntry>();
28
- private parserPromises = new Map<GrammarId, Promise<ParserEntry>>();
29
- private initPromise: Promise<typeof import("web-tree-sitter")> | undefined;
30
- private initializing = false;
31
- private disposed = false;
32
-
33
- /** Create a runtime that resolves relative file paths from `cwd`. */
34
- constructor(private cwd: string) {}
35
-
36
- /** Ensure web-tree-sitter Parser is initialized. */
37
- private async ensureParserInit(): Promise<typeof import("web-tree-sitter")> {
38
- this.assertActive();
39
- if (this.parserModule) return this.parserModule;
40
- if (this.initializing && this.initPromise) return this.initPromise;
41
-
42
- this.initializing = true;
43
- this.initPromise = (async () => {
44
- const mod = await import("web-tree-sitter");
45
- await mod.Parser.init();
46
- this.assertActive();
47
- this.parserModule = mod;
48
- return mod;
49
- })();
50
-
51
- try {
52
- return await this.initPromise;
53
- } catch (err: unknown) {
54
- // Allow retry on next call
55
- this.initPromise = undefined;
56
- this.initializing = false;
57
- throw new Error("Failed to initialize web-tree-sitter", { cause: err });
58
- }
59
- }
60
-
61
- /**
62
- * Get or create a parser entry for a grammar.
63
- *
64
- * Concurrent first-use calls for the same grammar share one initialization
65
- * promise. Failed initialization is not cached, so a later request can retry.
66
- */
67
- async ensureGrammarParser(grammarId: GrammarId): Promise<ParserEntry> {
68
- this.assertActive();
69
- const existing = this.parsers.get(grammarId);
70
- if (existing) return existing;
71
-
72
- const pending = this.parserPromises.get(grammarId);
73
- if (pending) return pending;
74
-
75
- const promise = this.createGrammarParser(grammarId);
76
- this.parserPromises.set(grammarId, promise);
77
-
78
- try {
79
- return await promise;
80
- } finally {
81
- if (this.parserPromises.get(grammarId) === promise) {
82
- this.parserPromises.delete(grammarId);
83
- }
84
- }
85
- }
86
-
87
- private async createGrammarParser(grammarId: GrammarId): Promise<ParserEntry> {
88
- const mod = await this.ensureParserInit();
89
- const wasmPath = resolveGrammarWasmPath(grammarId);
90
-
91
- const language = await mod.Language.load(wasmPath);
92
- const parser = new mod.Parser();
93
- try {
94
- parser.setLanguage(language);
95
- } catch (err) {
96
- parser.delete();
97
- throw err;
98
- }
99
-
100
- if (this.disposed) {
101
- parser.delete();
102
- throw new Error("Tree-sitter runtime has been disposed");
103
- }
104
-
105
- const entry = { parser, language };
106
- this.parsers.set(grammarId, entry);
107
- return entry;
108
- }
109
-
110
- /** Read and parse a file. Returns structured result. */
111
- async parseFile(filePath: string): Promise<
112
- TreeSitterResult<{
113
- tree: Tree;
114
- source: string;
115
- resolvedPath: string;
116
- grammarId: GrammarId;
117
- }>
118
- > {
119
- const resolvedPath = resolveToolPath(this.cwd, filePath);
120
-
121
- // Check language support first
122
- const grammarId = detectGrammar(filePath);
123
- if (!grammarId) {
124
- return {
125
- kind: "unsupported-language",
126
- file: filePath,
127
- message: `No Tree-sitter grammar configured for ${path.extname(filePath) || "this file type"}`,
128
- };
129
- }
130
-
131
- const timer = startDebugTimer();
132
- const parserState = this.parsers.has(grammarId)
133
- ? "reused"
134
- : this.parserPromises.has(grammarId)
135
- ? "initializing"
136
- : "cold";
137
-
138
- // Read the file
139
- let source: string;
140
- try {
141
- source = fs.readFileSync(resolvedPath, "utf-8");
142
- } catch (err: unknown) {
143
- finishStructuralTiming(timer, {
144
- operation: "parse",
145
- grammar: grammarId,
146
- parserState,
147
- outcome: "file-access-error",
148
- finalPhase: "file-read",
149
- });
150
- const message = err instanceof Error ? err.message : "File could not be read";
151
- return {
152
- kind: "file-access-error",
153
- file: filePath,
154
- message,
155
- };
156
- }
157
- timer.mark("file-read");
158
-
159
- if (timer.enabled) {
160
- try {
161
- createHash("sha256").update(source).digest();
162
- } catch {
163
- // Timing-only hashing must not change structural behavior.
164
- }
165
- }
166
- timer.mark("content-hash");
167
-
168
- let parserReady = false;
169
- try {
170
- const entry = await this.ensureGrammarParser(grammarId);
171
- timer.mark("parser-setup");
172
- parserReady = true;
173
- const tree = entry.parser.parse(source);
174
- finishStructuralTiming(timer, {
175
- operation: "parse",
176
- grammar: grammarId,
177
- parserState,
178
- outcome: "completed",
179
- finalPhase: "parse",
180
- });
181
- return {
182
- kind: "success",
183
- data: { tree: tree as Tree, source, resolvedPath, grammarId },
184
- };
185
- } catch (err: unknown) {
186
- finishStructuralTiming(timer, {
187
- operation: "parse",
188
- grammar: grammarId,
189
- parserState,
190
- outcome: "runtime-error",
191
- finalPhase: parserReady ? "parse" : "parser-setup",
192
- });
193
- return { kind: "runtime-error", message: formatError(err, "Parser initialization failed") };
194
- }
195
- }
196
-
197
- /** Execute a Tree-sitter query against a file. */
198
- async queryFile(
199
- filePath: string,
200
- queryString: string,
201
- ): Promise<TreeSitterResult<QueryCapture[]>> {
202
- if (!queryString || queryString.trim().length === 0) {
203
- return { kind: "validation-error", message: "query is required and must be non-empty" };
204
- }
205
- if (queryString.length > MAX_QUERY_LENGTH) {
206
- return {
207
- kind: "validation-error",
208
- message: `query exceeds maximum length of ${MAX_QUERY_LENGTH} characters`,
209
- };
210
- }
211
-
212
- const parseResult = await this.parseFile(filePath);
213
- if (parseResult.kind !== "success") return parseResult;
214
-
215
- const { grammarId, tree, source } = parseResult.data;
216
- const timer = startDebugTimer();
217
- let compiled = false;
218
-
219
- try {
220
- const entry = await this.ensureGrammarParser(grammarId);
221
- const mod = await this.ensureParserInit();
222
- let query: InstanceType<typeof mod.Query>;
223
-
224
- try {
225
- query = new mod.Query(entry.language, queryString);
226
- compiled = true;
227
- timer.mark("query-compilation");
228
- } catch (err: unknown) {
229
- finishStructuralTiming(timer, {
230
- operation: "query",
231
- grammar: grammarId,
232
- outcome: "validation-error",
233
- captureCount: 0,
234
- finalPhase: "query-compilation",
235
- });
236
- return { kind: "validation-error", message: `Invalid query: ${formatError(err)}` };
237
- }
238
-
239
- try {
240
- const matches = query.matches(tree.rootNode);
241
- const captures: QueryCapture[] = [];
242
- for (const match of matches) {
243
- for (const { name, node } of match.captures) {
244
- captures.push({
245
- name,
246
- nodeType: node.type,
247
- range: nodeToRange(node, source),
248
- text: node.text,
249
- });
250
- }
251
- }
252
- finishStructuralTiming(timer, {
253
- operation: "query",
254
- grammar: grammarId,
255
- outcome: "completed",
256
- captureCount: captures.length,
257
- finalPhase: "query-execution",
258
- });
259
- return { kind: "success", data: captures };
260
- } finally {
261
- query.delete();
262
- }
263
- } catch (err: unknown) {
264
- finishStructuralTiming(timer, {
265
- operation: "query",
266
- grammar: grammarId,
267
- outcome: "runtime-error",
268
- captureCount: 0,
269
- finalPhase: compiled ? "query-execution" : "query-compilation",
270
- });
271
- return { kind: "runtime-error", message: formatError(err, "Query execution failed") };
272
- } finally {
273
- tree.delete();
274
- }
275
- }
276
-
277
- /** Get the grammar ID for a file, or undefined if unsupported. */
278
- getGrammarId(filePath: string): GrammarId | undefined {
279
- return detectGrammar(filePath);
280
- }
281
-
282
- /** Resolve a file path from cwd. */
283
- resolvePath(filePath: string): string {
284
- return resolveToolPath(this.cwd, filePath);
285
- }
286
-
287
- /** Dispose all held parser resources. */
288
- dispose(): void {
289
- this.disposed = true;
290
- for (const [, entry] of this.parsers) {
291
- entry.parser.delete();
292
- }
293
- this.parsers.clear();
294
- this.parserPromises.clear();
295
- this.parserModule = undefined;
296
- this.initPromise = undefined;
297
- this.initializing = false;
298
- }
299
-
300
- private assertActive(): void {
301
- if (this.disposed) {
302
- throw new Error("Tree-sitter runtime has been disposed");
303
- }
304
- }
305
- }
306
-
307
- /** Max query string length to prevent ReDoS via overly complex Tree-sitter patterns. */
308
- const MAX_QUERY_LENGTH = 10_000;
309
-
310
- type StructuralTimer = ReturnType<typeof startDebugTimer>;
311
- type ParserState = "cold" | "initializing" | "reused";
312
-
313
- type StructuralTimingObservation =
314
- | {
315
- readonly operation: "parse";
316
- readonly grammar: GrammarId;
317
- readonly parserState: ParserState;
318
- readonly outcome: "completed" | "file-access-error" | "runtime-error";
319
- readonly finalPhase: "file-read" | "parse" | "parser-setup";
320
- }
321
- | {
322
- readonly operation: "query";
323
- readonly grammar: GrammarId;
324
- readonly outcome: "completed" | "runtime-error" | "validation-error";
325
- readonly captureCount: number;
326
- readonly finalPhase: "query-compilation" | "query-execution";
327
- };
328
-
329
- function finishStructuralTiming(
330
- timer: StructuralTimer,
331
- observation: StructuralTimingObservation,
332
- ): void {
333
- const { finalPhase, ...data } = observation;
334
- timer.finish(
335
- () => ({
336
- source: "tree-sitter",
337
- level: "debug",
338
- category: `structural.${data.operation}.timing`,
339
- message: `Tree-sitter ${data.operation} ${data.outcome}`,
340
- data: { ...data },
341
- }),
342
- finalPhase,
343
- );
344
- }
345
-
346
- /** Format errors with their cause chain's first message for user-facing tool output. */
347
- function formatError(err: unknown, fallback = "Operation failed"): string {
348
- if (!(err instanceof Error)) return String(err || fallback);
349
- if (err.cause instanceof Error) return `${err.message}: ${err.cause.message}`;
350
- return err.message || fallback;
351
- }
@@ -1,124 +0,0 @@
1
- import { randomUUID } from "node:crypto";
2
- import type { Usage } from "@earendil-works/pi-ai";
3
- import type {
4
- PlannerDraft,
5
- PlannerRunResult,
6
- ReviewModelSelection,
7
- ReviewSnapshot,
8
- } from "../types.ts";
9
-
10
- /** Session-local resolved target and model choices awaiting an execution decision. */
11
- export interface StoredReviewPlan {
12
- id: string;
13
- snapshot: ReviewSnapshot;
14
- reviewerModel: ReviewModelSelection;
15
- plannerDraft?: PlannerDraft;
16
- plannerModelId?: string;
17
- plannerPromptVersion?: string;
18
- plannerUsage?: Usage;
19
- /** Bounded advisory Planner outcome retained when no draft was produced. */
20
- plannerFailure?: Exclude<PlannerRunResult, { kind: "success" }>;
21
- }
22
-
23
- interface PlanEntry {
24
- plan: StoredReviewPlan;
25
- createdAt: number;
26
- leaseToken?: string;
27
- }
28
-
29
- export interface ReviewPlanStoreOptions {
30
- maxPlans?: number;
31
- maxAgeMs?: number;
32
- now?: () => number;
33
- }
34
-
35
- /** Opaque lease that prevents concurrent execution of one Prepared Review Plan. */
36
- export interface ReviewPlanLease {
37
- plan: StoredReviewPlan;
38
- token: string;
39
- }
40
-
41
- /** Session-local plan store with explicit available, running, and consumed transitions. */
42
- export class ReviewPlanStore {
43
- readonly #plans = new Map<string, PlanEntry>();
44
- readonly #maxPlans: number;
45
- readonly #maxAgeMs: number;
46
- readonly #now: () => number;
47
-
48
- constructor(options: ReviewPlanStoreOptions = {}) {
49
- this.#maxPlans = options.maxPlans ?? 32;
50
- this.#maxAgeMs = options.maxAgeMs ?? 30 * 60 * 1_000;
51
- this.#now = options.now ?? Date.now;
52
- }
53
-
54
- create(input: Omit<StoredReviewPlan, "id">): StoredReviewPlan {
55
- this.#pruneExpired();
56
- while (this.#plans.size >= this.#maxPlans) {
57
- if (!this.#evictOldestAvailable()) {
58
- throw new Error("Too many Review Plans are currently running in this session.");
59
- }
60
- }
61
- const plan = { id: `review-plan-${randomUUID()}`, ...input };
62
- this.#plans.set(plan.id, { plan, createdAt: this.#now() });
63
- return plan;
64
- }
65
-
66
- /** Read an available plan without leasing or consuming it. */
67
- peek(id: string): StoredReviewPlan | undefined {
68
- this.#pruneExpired();
69
- const entry = this.#plans.get(id);
70
- return entry && !entry.leaseToken ? entry.plan : undefined;
71
- }
72
-
73
- /** Atomically mark an available plan as running. */
74
- acquire(id: string): ReviewPlanLease | undefined {
75
- this.#pruneExpired();
76
- const entry = this.#plans.get(id);
77
- if (!entry || entry.leaseToken) return undefined;
78
- const token = randomUUID();
79
- entry.leaseToken = token;
80
- return { plan: entry.plan, token };
81
- }
82
-
83
- /** Make a running plan available again when no task produced a structured review. */
84
- release(lease: ReviewPlanLease): boolean {
85
- const entry = this.#plans.get(lease.plan.id);
86
- if (!entry || entry.leaseToken !== lease.token) return false;
87
- entry.leaseToken = undefined;
88
- entry.createdAt = this.#now();
89
- return true;
90
- }
91
-
92
- /** Permanently consume a running plan after at least one task completes. */
93
- consume(lease: ReviewPlanLease): boolean {
94
- return this.invalidate(lease);
95
- }
96
-
97
- /** Remove a leased plan whose pinned Review Snapshot no longer matches the target. */
98
- invalidate(lease: ReviewPlanLease): boolean {
99
- const entry = this.#plans.get(lease.plan.id);
100
- if (!entry || entry.leaseToken !== lease.token) return false;
101
- this.#plans.delete(lease.plan.id);
102
- return true;
103
- }
104
-
105
- clear(): void {
106
- this.#plans.clear();
107
- }
108
-
109
- #pruneExpired(): void {
110
- const cutoff = this.#now() - this.#maxAgeMs;
111
- for (const [id, entry] of this.#plans) {
112
- if (!entry.leaseToken && entry.createdAt <= cutoff) this.#plans.delete(id);
113
- }
114
- }
115
-
116
- #evictOldestAvailable(): boolean {
117
- for (const [id, entry] of this.#plans) {
118
- if (entry.leaseToken) continue;
119
- this.#plans.delete(id);
120
- return true;
121
- }
122
- return false;
123
- }
124
- }