@mrclrchtr/supi-review 4.9.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 (324) 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/debug-timing.ts +34 -21
  57. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +3 -0
  58. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/README.md +80 -5
  59. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/README.md +2 -0
  60. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  61. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +9 -0
  62. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/capability/types.ts +53 -13
  63. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/request-control.ts +47 -0
  64. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +13 -1
  65. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/README.md +2 -0
  66. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  67. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
  68. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
  69. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -3
  70. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/debug-timing.ts +34 -21
  71. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +3 -0
  72. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/package.json +7 -6
  73. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/api.ts +10 -0
  74. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-cache.ts +206 -0
  75. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-capabilities.ts +78 -0
  76. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-collection.ts +114 -0
  77. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-evidence.ts +372 -0
  78. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-host.ts +14 -0
  79. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-pull.ts +62 -0
  80. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-refresh.ts +491 -0
  81. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-request.ts +9 -0
  82. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-timing.ts +215 -0
  83. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-waiters.ts +206 -0
  84. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostics.ts +370 -266
  85. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-state.ts +52 -0
  86. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-sync.ts +185 -0
  87. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-file-state.ts +25 -0
  88. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client.ts +467 -115
  89. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/transport.ts +238 -11
  90. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/capabilities.ts +10 -1
  91. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/defaults.json +1 -1
  92. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/debug-telemetry.ts +45 -0
  93. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/evidence.ts +38 -0
  94. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-client-state.ts +79 -9
  95. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-diagnostics.ts +13 -4
  96. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-workspace-recovery.ts +300 -24
  97. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-workspace-symbol.ts +5 -2
  98. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +464 -96
  99. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/lsp-refactor-provider.ts +130 -0
  100. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/lsp-semantic-provider.ts +45 -329
  101. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/refactor-planning.ts +57 -120
  102. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-edit-normalizer.ts +320 -0
  103. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-symbol-mapper.ts +207 -0
  104. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/readiness.ts +72 -2
  105. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-controller.ts +151 -26
  106. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostic-surface.ts +40 -0
  107. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostics.ts +50 -0
  108. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +136 -120
  109. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-transition-debug.ts +49 -0
  110. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +102 -0
  111. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/README.md +26 -6
  112. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/README.md +2 -0
  113. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  114. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +9 -0
  115. 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
  116. 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
  117. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +13 -1
  118. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/README.md +2 -0
  119. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  120. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
  121. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
  122. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -3
  123. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug-timing.ts +34 -21
  124. 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
  125. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/LICENSE +21 -0
  126. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/README.md +258 -0
  127. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/dist/babel.cjs +257 -0
  128. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/dist/jiti.cjs +1 -0
  129. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-cli.mjs +34 -0
  130. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-hooks.mjs +124 -0
  131. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-native.mjs +121 -0
  132. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-register.d.mts +1 -0
  133. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-register.mjs +4 -0
  134. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-static.mjs +23 -0
  135. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.cjs +30 -0
  136. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.d.cts +8 -0
  137. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.d.mts +8 -0
  138. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.mjs +29 -0
  139. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/types.d.ts +420 -0
  140. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/package.json +146 -0
  141. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.wasm +0 -0
  142. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/debug/web-tree-sitter.wasm.map +4 -4
  143. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/package.json +1 -1
  144. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.wasm +0 -0
  145. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/web-tree-sitter/web-tree-sitter.wasm.map +4 -4
  146. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/package.json +7 -3
  147. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/kotlin/tree-sitter-kotlin.wasm.json +1 -1
  148. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/resources/grammars/sql/tree-sitter-sql.wasm.json +1 -1
  149. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/api.ts +0 -9
  150. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/index.ts +0 -8
  151. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/provider/tree-sitter-provider.ts +16 -12
  152. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/runtime-controller.ts +65 -87
  153. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/session.ts +47 -95
  154. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-timing.ts +147 -0
  155. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-client-lifecycle.ts +39 -0
  156. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-client.ts +561 -0
  157. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-message-size.ts +24 -0
  158. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-protocol.ts +452 -0
  159. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/call-sites.ts +4 -2
  160. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/callees.ts +12 -4
  161. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/exports.ts +4 -2
  162. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/imports.ts +4 -2
  163. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/node-at.ts +5 -3
  164. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/types.ts +33 -12
  165. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/blocking-test-bootstrap.mjs +34 -0
  166. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/bootstrap.mjs +8 -0
  167. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/parsed-file-store-helpers.ts +23 -0
  168. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/parsed-file-store.ts +400 -0
  169. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/request-control.ts +48 -0
  170. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime-parser-helpers.ts +24 -0
  171. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime-query-helpers.ts +43 -0
  172. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime.ts +421 -0
  173. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/service.ts +116 -0
  174. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/worker-main.ts +201 -0
  175. package/node_modules/@mrclrchtr/supi-code-intelligence/package.json +5 -5
  176. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/diagnostics.ts +236 -24
  177. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/recovery.ts +6 -2
  178. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/provider.ts +58 -0
  179. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/readiness.ts +30 -9
  180. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/refactor/apply.ts +59 -20
  181. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/refactor/mutation-authority.ts +143 -0
  182. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/refactor/position.ts +47 -0
  183. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/refactor/safety.ts +18 -10
  184. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/callees.ts +9 -1
  185. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/types.ts +5 -2
  186. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/ast-scan-timing.ts +9 -4
  187. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/ast-scan.ts +1 -1
  188. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/deadline.ts +2 -2
  189. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern-analysis.ts +46 -32
  190. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern.ts +12 -2
  191. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/anchored.ts +20 -11
  192. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/file.ts +18 -11
  193. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/identity.ts +19 -3
  194. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/symbol.ts +36 -15
  195. package/node_modules/@mrclrchtr/supi-code-intelligence/src/api.ts +4 -0
  196. package/node_modules/@mrclrchtr/supi-code-intelligence/src/diagnostics/evidence.ts +51 -0
  197. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/capability-adapter.ts +12 -3
  198. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/find-workflow.ts +17 -7
  199. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph/collect.ts +18 -2
  200. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph-workflow.ts +19 -12
  201. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-refresh.ts +148 -0
  202. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-types.ts +37 -15
  203. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-workflow.ts +37 -39
  204. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect/collect.ts +20 -3
  205. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect-workflow.ts +10 -5
  206. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/collect.ts +10 -1
  207. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/context-facts.ts +3 -1
  208. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/context-sections.ts +20 -7
  209. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/gather.ts +17 -11
  210. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-types.ts +2 -1
  211. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-workflow.ts +15 -8
  212. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-plans.ts +2 -0
  213. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-workflow.ts +59 -14
  214. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/session.ts +4 -1
  215. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/target-workflow.ts +54 -23
  216. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/workflow-control.ts +7 -3
  217. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/lifecycle.ts +26 -46
  218. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/maintenance.ts +199 -25
  219. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/state.ts +2 -2
  220. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/workspace-provider-host.ts +25 -3
  221. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/find/execute.ts +7 -1
  222. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/find/render.ts +20 -3
  223. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/find/tui.ts +23 -21
  224. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/graph/execute.ts +23 -3
  225. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/graph/tui.ts +59 -46
  226. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/health/execute.ts +7 -2
  227. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/health/markdown.ts +56 -14
  228. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/health/refresh-status.ts +105 -0
  229. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/health/tui.ts +95 -98
  230. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/infra/workflow-control.ts +8 -0
  231. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/inspect/execute.ts +7 -1
  232. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/inspect/tui.ts +26 -18
  233. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/orientation/execute.ts +21 -3
  234. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/orientation/tui.ts +51 -35
  235. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/refactor-apply/execute.ts +3 -0
  236. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/refactor-apply/tui.ts +43 -25
  237. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/refactor-plan/execute.ts +4 -0
  238. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/refactor-plan/tui.ts +33 -20
  239. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/register.ts +127 -22
  240. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/resolve/execute.ts +18 -1
  241. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/resolve/tui.ts +42 -24
  242. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/display.ts +107 -0
  243. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/errors.ts +20 -17
  244. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/find.ts +52 -8
  245. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/graph.ts +44 -1
  246. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/health.ts +53 -1
  247. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/inspect.ts +113 -1
  248. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/orientation.ts +66 -14
  249. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/refactor.ts +36 -4
  250. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/resolve.ts +44 -7
  251. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/types.ts +20 -0
  252. package/node_modules/@mrclrchtr/supi-code-intelligence/src/types/execution.ts +18 -5
  253. package/node_modules/@mrclrchtr/supi-code-intelligence/src/types/index.ts +8 -1
  254. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/status-command.ts +5 -3
  255. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/status-overlay.ts +4 -0
  256. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/common.ts +108 -10
  257. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/display.ts +48 -0
  258. package/node_modules/@mrclrchtr/supi-core/README.md +2 -0
  259. package/node_modules/@mrclrchtr/supi-core/package.json +1 -1
  260. package/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
  261. package/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
  262. package/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -3
  263. package/node_modules/@mrclrchtr/supi-core/src/debug-timing.ts +34 -21
  264. package/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +3 -0
  265. package/package.json +6 -4
  266. package/src/audit/local-review-audit-store.ts +30 -6
  267. package/src/audit/replay-outline.ts +89 -0
  268. package/src/audit/review-audit-record.ts +40 -0
  269. package/src/audit/review-audit.ts +16 -4
  270. package/src/config.ts +44 -3
  271. package/src/git-command.ts +179 -23
  272. package/src/git.ts +71 -74
  273. package/src/history/collect.ts +13 -1
  274. package/src/model.ts +14 -0
  275. package/src/review-input.ts +72 -39
  276. package/src/review-limits.ts +1 -0
  277. package/src/review-path.ts +11 -63
  278. package/src/review-result.ts +7 -5
  279. package/src/review-scope.ts +164 -0
  280. package/src/review.ts +18 -342
  281. package/src/session/review-artifact-store.ts +2 -2
  282. package/src/target/change-metadata.ts +10 -9
  283. package/src/target/diff.ts +19 -16
  284. package/src/target/file-manifest.ts +1 -0
  285. package/src/target/packet.ts +78 -97
  286. package/src/target/resolve.ts +207 -227
  287. package/src/target/snapshot-match.ts +4 -23
  288. package/src/tool/agent-review-schemas.ts +135 -219
  289. package/src/tool/agent-review-tools.ts +65 -238
  290. package/src/tool/child-failure-diagnostics.ts +14 -156
  291. package/src/tool/child-session-runner.ts +119 -123
  292. package/src/tool/output-page.ts +33 -9
  293. package/src/tool/planner-input.ts +37 -0
  294. package/src/tool/planner-runner.ts +14 -13
  295. package/src/tool/post-review-policy.ts +9 -4
  296. package/src/tool/review-audit-tool.ts +159 -75
  297. package/src/tool/review-debug-summary.ts +8 -3
  298. package/src/tool/review-execution.ts +23 -7
  299. package/src/tool/review-format.ts +36 -27
  300. package/src/tool/review-output-tool.ts +20 -41
  301. package/src/tool/review-recovery.ts +191 -0
  302. package/src/tool/review-runner.ts +55 -14
  303. package/src/tool/review-system-prompt.ts +6 -6
  304. package/src/tool/review-tools.ts +45 -6
  305. package/src/tool/review-workflow.ts +250 -245
  306. package/src/tool/schemas.ts +32 -10
  307. package/src/tool/tool-specs.ts +137 -0
  308. package/src/tui/common.ts +18 -0
  309. package/src/tui/paged-output.ts +37 -14
  310. package/src/tui/review-command.ts +407 -0
  311. package/src/tui/review-scope-picker.ts +38 -0
  312. package/src/tui/review-target-picker.ts +106 -0
  313. package/src/tui/run.ts +90 -122
  314. package/src/types.ts +74 -88
  315. package/src/workspace/review-workspace.ts +59 -79
  316. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/runtime.ts +0 -247
  317. package/src/session/review-plan-store.ts +0 -124
  318. package/src/tool/child-lifecycle-trace.ts +0 -345
  319. package/src/tool/child-usage.ts +0 -73
  320. package/src/tool/criteria-only-scope.ts +0 -31
  321. package/src/tool/diagnostic-sanitizer.ts +0 -35
  322. package/src/tool/runner-helpers.ts +0 -52
  323. package/src/tool/session-lifecycle.ts +0 -281
  324. package/src/tui/prepare.ts +0 -187
@@ -1,54 +1,70 @@
1
+ // biome-ignore lint/style/noExcessiveLinesPerFile: Review Target and Workspace lifecycle remain in one workflow module.
2
+ import type { AgentRunProviderAuthority } from "@mrclrchtr/supi-agent-runtime/api";
3
+ import {
4
+ combineAgentRunUsage,
5
+ createEarlyCancellationDiagnostics,
6
+ createUnobservedAgentRunDiagnostics,
7
+ } from "@mrclrchtr/supi-agent-runtime/api";
1
8
  import type { LocalReviewAuditStore } from "../audit/local-review-audit-store.ts";
2
- import { resolveReviewSnapshot, summarizeReviewSnapshot } from "../git.ts";
9
+ import { isRootCommit, resolveReviewSnapshot, summarizeReviewSnapshot } from "../git.ts";
3
10
  import { normalizeReviewInput } from "../review-input.ts";
4
- import type { ReviewPlanLease, ReviewPlanStore } from "../session/review-plan-store.ts";
5
- import { buildFileManifest } from "../target/file-manifest.ts";
11
+ import { normalizeReviewScope, validateReviewScope } from "../review-scope.ts";
6
12
  import { snapshotsMatch } from "../target/snapshot-match.ts";
7
13
  import type {
8
- PlannerDraft,
9
14
  PlannerRunResult,
10
15
  PlanningRecord,
11
16
  ReviewBatchDetails,
12
17
  ReviewInput,
13
18
  ReviewModelSelection,
19
+ ReviewScope,
14
20
  ReviewSnapshot,
15
21
  ReviewTargetSpec,
22
+ ReviewTask,
16
23
  ReviewTaskResult,
17
24
  } from "../types.ts";
18
25
  import { runDependencyBootstrap } from "../workspace/dependency-bootstrap.ts";
19
26
  import { materializeReviewWorkspace } from "../workspace/review-workspace.ts";
20
- import {
21
- createEarlyCancellationDiagnostics,
22
- createUnobservedChildFailureDiagnostics,
23
- } from "./child-failure-diagnostics.ts";
24
- import { combineUsage } from "./child-usage.ts";
25
- import { enforceCriteriaOnlyScope } from "./criteria-only-scope.ts";
27
+ import { buildPlannerPrompt } from "./planner-input.ts";
26
28
  import { PLANNER_PROMPT_VERSION, runPlanner } from "./planner-runner.ts";
27
29
  import { executeReviewTasks, type ReviewExecutionUpdate } from "./review-execution.ts";
28
30
 
29
- /** Input required by the prepare workflow: target resolution plus optional Planner run. */
30
- export interface PrepareReviewInput {
31
+ /** Tool update callback signature shared across workflow adapters. */
32
+ type OnUpdate = ReviewExecutionUpdate;
33
+
34
+ /** Input for a transient interactive Planner Draft. */
35
+ export interface DraftReviewTasksInput {
31
36
  cwd: string;
37
+ providerAuthority?: AgentRunProviderAuthority;
32
38
  target: ReviewTargetSpec;
33
- planning: "none" | "suggest";
39
+ /** Optional advisory path focus included in the Planner input. */
40
+ scope?: ReviewScope;
34
41
  plannerContext: string;
35
- reviewerModel: ReviewModelSelection;
36
42
  plannerModel?: ReviewModelSelection;
37
- planStore: ReviewPlanStore;
38
43
  signal?: AbortSignal;
39
44
  onUpdate?: OnUpdate;
40
45
  }
41
46
 
42
- /** Tool update callback signature shared across workflow adapters. */
43
- type OnUpdate = ReviewExecutionUpdate;
44
-
45
- /** Complete Direct Review request: target, full review input, and reviewer model. */
46
- export interface DirectRunInput {
47
- mode: "direct";
47
+ /** Complete caller-defined Review request. */
48
+ export interface RunReviewInput {
48
49
  cwd: string;
50
+ providerAuthority?: AgentRunProviderAuthority;
49
51
  target: ReviewTargetSpec;
50
52
  review: ReviewInput;
53
+ /** Optional batch-level path focus, validated in the frozen after state. */
54
+ scope?: ReviewScope;
51
55
  reviewerModel: ReviewModelSelection;
56
+ /** Optional explicit second model for Submission Recovery. */
57
+ recoveryModel?: ReviewModelSelection;
58
+ /** Requested recovery model id when configuration did not resolve. */
59
+ recoveryModelId?: string;
60
+ /** Snapshot captured when the interactive target was selected. A mismatch stops before workspace creation. */
61
+ expectedSnapshot?: ReviewSnapshot;
62
+ /** Target that produced `expectedSnapshot` when edited modes finalize a different public target. */
63
+ expectedSnapshotTarget?: ReviewTargetSpec;
64
+ /** Planner metadata retained only for the interactive Review result. */
65
+ planning?: PlanningRecord;
66
+ /** The interactive flow marks a valid draft as planner-assisted. */
67
+ provenance?: ReviewBatchDetails["provenance"];
52
68
  /** Shell command run once before reviewer fan-out. */
53
69
  bootstrapCommand?: string;
54
70
  projectTrusted?: boolean;
@@ -58,154 +74,119 @@ export interface DirectRunInput {
58
74
  onUpdate?: OnUpdate;
59
75
  }
60
76
 
61
- /** One-shot Prepared Review request: plan id, explicit decision, and plan store. */
62
- export interface PreparedRunInput {
63
- mode: "prepared";
64
- cwd: string;
65
- planId: string;
66
- decision: { kind: "accept-draft" } | { kind: "use-review"; review: ReviewInput };
67
- planStore: ReviewPlanStore;
68
- /** Shell command run once before reviewer fan-out. */
69
- bootstrapCommand?: string;
70
- projectTrusted?: boolean;
71
- /** Present when local reviewer replay is enabled. */
72
- auditStore?: LocalReviewAuditStore;
73
- signal?: AbortSignal;
74
- onUpdate?: OnUpdate;
75
- }
76
-
77
- /** Discriminated union accepted by `runReview` for both Direct and Prepared paths. */
78
- export type RunReviewInput = DirectRunInput | PreparedRunInput;
79
-
80
- function plannerPrompt(snapshot: ReviewSnapshot, context: string): string {
81
- const conversation = [
82
- "",
83
- "## Bounded session conversation",
84
- context || "No session conversation was available.",
85
- ];
86
- if (snapshot.requestedTarget.kind === "current-state") {
87
- return [
88
- "# Review Planning Input",
89
- "",
90
- `Target: ${snapshot.title}`,
91
- "Finding Scope: criteria-only",
92
- "This is a one-state audit without Git-change attribution.",
93
- "",
94
- "## Review scope",
95
- ...(snapshot.requestedTarget.paths?.length
96
- ? [
97
- "Advisory focus paths; they do not restrict inspection or finding eligibility.",
98
- ...snapshot.requestedTarget.paths.map((path) => `- ${JSON.stringify(path)}`),
99
- ]
100
- : ["Repository-wide discovery; no advisory focus paths were supplied."]),
101
- ...conversation,
102
- ].join("\n");
103
- }
104
- return [
105
- "# Review Planning Input",
106
- "",
107
- `Target: ${snapshot.title}`,
108
- `Changed files: ${snapshot.changes.length}`,
109
- `Diff stats: +${snapshot.stats.additions} / -${snapshot.stats.deletions}`,
110
- "",
111
- "## Changed-path inventory",
112
- ...buildFileManifest(snapshot.changes),
113
- ...conversation,
114
- ].join("\n");
115
- }
116
-
117
77
  /** Translate a resolveReviewSnapshot error to a no-target reason. */
118
78
  function snapshotErrorReason(error: unknown): string {
119
79
  if (error instanceof Error) return error.message;
120
- return "No reviewable changes found.";
80
+ return "Could not resolve the Review Target.";
81
+ }
82
+ /** Capture one selected interactive target before task editing begins. */
83
+ export async function captureReviewTarget(
84
+ cwd: string,
85
+ spec: ReviewTargetSpec,
86
+ signal?: AbortSignal,
87
+ ) {
88
+ try {
89
+ return { kind: "captured" as const, snapshot: await resolveReviewSnapshot(cwd, spec, signal) };
90
+ } catch (error) {
91
+ return { kind: "no-target" as const, reason: snapshotErrorReason(error) };
92
+ }
121
93
  }
94
+ type PlannerFailure = Exclude<PlannerRunResult, { kind: "success" }>;
122
95
 
123
- interface PlannerPreparation {
124
- draft?: PlannerDraft;
125
- failure?: Exclude<PlannerRunResult, { kind: "success" }>;
126
- canceled?: Extract<PlannerRunResult, { kind: "canceled" }>;
127
- usage?: PlannerRunResult["usage"];
128
- modelId?: string;
129
- promptVersion?: string;
96
+ /** Normalize a Planner Draft without changing its required task modes. */
97
+ function normalizePlannerDraft(snapshot: ReviewSnapshot, value: ReviewInput): ReviewInput {
98
+ const draft = normalizeReviewInput(value);
99
+ if (hasChangeTask(draft.tasks) && snapshot.changes.length === 0) {
100
+ throw new Error("Invalid Planner Draft.");
101
+ }
102
+ return draft;
130
103
  }
131
104
 
132
- async function preparePlanner(
133
- input: PrepareReviewInput,
134
- snapshot: ReviewSnapshot,
135
- ): Promise<PlannerPreparation> {
136
- if (input.planning === "none") return {};
105
+ /** Resolve the target and create one transient Planner Draft for `/supi-review`. */
106
+ export async function draftReviewTasks(input: DraftReviewTasksInput) {
107
+ const scope = normalizeReviewScope(input.scope);
108
+ input.onUpdate?.({
109
+ content: [{ type: "text", text: "Resolving target…" }],
110
+ details: {},
111
+ });
112
+ let snapshot: ReviewSnapshot;
113
+ try {
114
+ snapshot = await resolveReviewSnapshot(input.cwd, input.target, input.signal);
115
+ } catch (error) {
116
+ input.signal?.throwIfAborted();
117
+ return { kind: "no-target" as const, reason: snapshotErrorReason(error) };
118
+ }
119
+
120
+ const promptVersion = PLANNER_PROMPT_VERSION;
137
121
  if (!input.plannerModel) {
138
- return { failure: { kind: "failed", failureCode: "session-creation-failed" } };
122
+ return {
123
+ kind: "planner-failed" as const,
124
+ result: { kind: "failed", failureCode: "session-creation-failed" } satisfies PlannerFailure,
125
+ promptVersion,
126
+ };
139
127
  }
128
+ const modelId = input.plannerModel.canonicalId;
129
+
140
130
  input.onUpdate?.({
141
131
  content: [{ type: "text", text: "Running planner…" }],
142
132
  details: {},
143
133
  });
144
- const modelId = input.plannerModel.canonicalId;
145
- const promptVersion = PLANNER_PROMPT_VERSION;
146
134
  let result: PlannerRunResult;
147
135
  try {
148
136
  result = await runPlanner({
149
137
  cwd: snapshot.repositoryRoot,
150
138
  model: input.plannerModel.model,
151
- prompt: plannerPrompt(snapshot, input.plannerContext),
139
+ ...(input.providerAuthority ? { providerAuthority: input.providerAuthority } : {}),
140
+ prompt: buildPlannerPrompt(snapshot, scope, input.plannerContext),
152
141
  signal: input.signal,
153
142
  });
154
143
  } catch {
155
- if (input.signal?.aborted) {
156
- return {
157
- canceled: { kind: "canceled", diagnostics: createEarlyCancellationDiagnostics() },
158
- modelId,
159
- promptVersion,
160
- };
161
- }
144
+ const failure: PlannerFailure = input.signal?.aborted
145
+ ? { kind: "canceled", diagnostics: createEarlyCancellationDiagnostics() }
146
+ : {
147
+ kind: "failed",
148
+ failureCode: "unexpected-runner-failure",
149
+ diagnostics: createUnobservedAgentRunDiagnostics(),
150
+ };
162
151
  return {
163
- failure: {
164
- kind: "failed",
165
- failureCode: "unexpected-runner-failure",
166
- diagnostics: createUnobservedChildFailureDiagnostics(),
167
- },
152
+ kind: "planner-failed" as const,
153
+ result: failure,
168
154
  modelId,
169
155
  promptVersion,
170
156
  };
171
157
  }
172
- const identity = {
173
- ...(result.usage ? { usage: result.usage } : {}),
174
- modelId,
175
- promptVersion,
176
- };
177
- if (result.kind === "canceled") return { canceled: result, ...identity };
178
- if (result.kind === "success") {
179
- return { draft: normalizeReviewInput(result.value), ...identity };
158
+
159
+ if (result.kind !== "success") {
160
+ return {
161
+ kind: "planner-failed" as const,
162
+ result,
163
+ modelId,
164
+ promptVersion,
165
+ };
180
166
  }
181
- return { failure: result, ...identity };
182
- }
183
167
 
184
- /** Resolve and store a one-shot plan, optionally asking the advisory Planner for tasks. */
185
- export async function prepareReview(input: PrepareReviewInput) {
186
- input.onUpdate?.({
187
- content: [{ type: "text", text: "Resolving target…" }],
188
- details: {},
189
- });
190
- let snapshot: Awaited<ReturnType<typeof resolveReviewSnapshot>>;
191
168
  try {
192
- snapshot = await resolveReviewSnapshot(input.cwd, input.target);
193
- } catch (error) {
194
- return { kind: "no-target" as const, reason: snapshotErrorReason(error) };
169
+ const draft = normalizePlannerDraft(snapshot, result.value);
170
+ const planning: PlanningRecord = {
171
+ promptVersion,
172
+ modelId,
173
+ draft,
174
+ ...(result.usage ? { usage: result.usage } : {}),
175
+ };
176
+ return { kind: "planned" as const, snapshot, planning };
177
+ } catch {
178
+ return {
179
+ kind: "planner-failed" as const,
180
+ result: {
181
+ kind: "failed",
182
+ failureCode: "unexpected-runner-failure",
183
+ diagnostics: createUnobservedAgentRunDiagnostics(),
184
+ ...(result.usage ? { usage: result.usage } : {}),
185
+ } satisfies PlannerFailure,
186
+ modelId,
187
+ promptVersion,
188
+ };
195
189
  }
196
- if (!snapshot) return { kind: "no-target" as const, reason: "No reviewable changes found." };
197
- const planning = await preparePlanner(input, snapshot);
198
- if (planning.canceled) return { kind: "canceled" as const, result: planning.canceled };
199
- const plan = input.planStore.create({
200
- snapshot,
201
- reviewerModel: input.reviewerModel,
202
- ...(planning.draft ? { plannerDraft: planning.draft } : {}),
203
- ...(planning.failure ? { plannerFailure: planning.failure } : {}),
204
- ...(planning.usage ? { plannerUsage: planning.usage } : {}),
205
- ...(planning.modelId ? { plannerModelId: planning.modelId } : {}),
206
- ...(planning.promptVersion ? { plannerPromptVersion: planning.promptVersion } : {}),
207
- });
208
- return { kind: "prepared" as const, plan, ...(planning.usage ? { usage: planning.usage } : {}) };
209
190
  }
210
191
 
211
192
  function workspaceFailureReason(error: unknown): string {
@@ -215,6 +196,39 @@ function workspaceFailureReason(error: unknown): string {
215
196
  return "Could not create the Review Workspace.";
216
197
  }
217
198
 
199
+ type MaterializedReviewWorkspace =
200
+ | { kind: "ready"; workspace: Awaited<ReturnType<typeof materializeReviewWorkspace>> }
201
+ | { kind: "invalid"; reason: string };
202
+
203
+ /** Materialize the frozen after state and validate its batch Review Scope before fan-out. */
204
+ async function materializeReviewWorkspaceWithScope(
205
+ snapshot: ReviewSnapshot,
206
+ scope: ReviewScope,
207
+ signal?: AbortSignal,
208
+ ): Promise<MaterializedReviewWorkspace> {
209
+ let workspace: Awaited<ReturnType<typeof materializeReviewWorkspace>>;
210
+ try {
211
+ workspace = await materializeReviewWorkspace(snapshot, signal);
212
+ } catch (error) {
213
+ signal?.throwIfAborted();
214
+ return { kind: "invalid", reason: workspaceFailureReason(error) };
215
+ }
216
+ try {
217
+ await validateReviewScope(snapshot, workspace.cwd, scope, signal);
218
+ } catch (error) {
219
+ const cleanupWarning = await workspace.cleanup();
220
+ signal?.throwIfAborted();
221
+ const reason = error instanceof Error ? error.message : "Could not validate the Review Scope.";
222
+ return {
223
+ kind: "invalid",
224
+ reason: cleanupWarning
225
+ ? `${reason} Review Workspace cleanup warning: ${cleanupWarning.message} Recovery: ${cleanupWarning.recoveryCommand}`
226
+ : reason,
227
+ };
228
+ }
229
+ return { kind: "ready", workspace };
230
+ }
231
+
218
232
  interface DependencyBootstrapInput {
219
233
  cwd: string;
220
234
  command?: string;
@@ -234,115 +248,109 @@ async function bootstrapReviewWorkspace(input: DependencyBootstrapInput): Promis
234
248
  return true;
235
249
  }
236
250
 
237
- /** Execute a Direct Review or atomically consume and execute a Prepared Review. */
238
- // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: direct/prepared orchestration stays at one public seam
239
- // biome-ignore lint/complexity/noExcessiveLinesPerFunction: direct/prepared orchestration stays at one public seam
240
- export async function runReview(input: RunReviewInput) {
241
- let snapshot: ReviewSnapshot;
242
- let review: ReviewInput;
243
- let model: ReviewModelSelection;
244
- let planning: PlanningRecord | undefined;
245
- let lease: ReviewPlanLease | undefined;
246
- let planStore: ReviewPlanStore | undefined;
247
- let provenance: ReviewBatchDetails["provenance"] = "caller-supplied";
251
+ function hasChangeTask(tasks: ReviewTask[]): boolean {
252
+ return tasks.some((task) => task.mode === "change");
253
+ }
248
254
 
249
- if (input.mode === "direct") {
250
- let resolved: Awaited<ReturnType<typeof resolveReviewSnapshot>>;
251
- try {
252
- resolved = await resolveReviewSnapshot(input.cwd, input.target);
253
- } catch (error) {
254
- return { kind: "no-target" as const, reason: snapshotErrorReason(error) };
255
- }
256
- if (!resolved) return { kind: "no-target" as const, reason: "No reviewable changes found." };
257
- snapshot = resolved;
258
- review = normalizeReviewInput(input.review);
259
- model = input.reviewerModel;
260
- const scoped = enforceCriteriaOnlyScope(review, snapshot.target.kind, "caller-supplied");
261
- if ("reason" in scoped) return { kind: "invalid" as const, reason: scoped.reason };
262
- review = scoped.review;
263
- } else {
264
- const plan = input.planStore.peek(input.planId);
265
- if (!plan) {
266
- return {
267
- kind: "invalid" as const,
268
- reason: `Review Plan ${input.planId} was not found, is already running, or was consumed.`,
269
- };
270
- }
271
- if (input.decision.kind === "accept-draft" && !plan.plannerDraft) {
272
- return { kind: "invalid" as const, reason: "This plan has no Planner Draft." };
273
- }
274
- const selectedReview =
275
- input.decision.kind === "accept-draft"
276
- ? plan.plannerDraft
277
- : normalizeReviewInput(input.decision.review);
278
- if (!selectedReview) {
279
- return { kind: "invalid" as const, reason: "This plan has no Planner Draft." };
280
- }
281
- planStore = input.planStore;
282
- lease = planStore.acquire(input.planId);
283
- if (!lease) {
284
- return {
285
- kind: "invalid" as const,
286
- reason: `Review Plan ${input.planId} is already running.`,
287
- };
288
- }
289
- let refreshed: Awaited<ReturnType<typeof resolveReviewSnapshot>>;
290
- try {
291
- refreshed = await resolveReviewSnapshot(input.cwd, lease.plan.snapshot.requestedTarget);
292
- } catch {
293
- input.planStore.invalidate(lease);
294
- return {
295
- kind: "invalid" as const,
296
- reason: "Could not revalidate this Review Plan target. Prepare a new plan.",
297
- };
298
- }
299
- if (!refreshed || !snapshotsMatch(lease.plan.snapshot, refreshed)) {
300
- input.planStore.invalidate(lease);
301
- return {
302
- kind: "invalid" as const,
303
- reason: "This Review Plan is stale because its target changed. Prepare a new plan.",
304
- };
305
- }
306
- snapshot = refreshed;
307
- model = lease.plan.reviewerModel;
308
- provenance = input.decision.kind === "accept-draft" ? "planner-assisted" : "caller-supplied";
309
- const scoped = enforceCriteriaOnlyScope(selectedReview, refreshed.target.kind, provenance);
310
- if ("reason" in scoped) {
311
- input.planStore.release(lease);
312
- return { kind: "invalid" as const, reason: scoped.reason };
313
- }
314
- review = scoped.review;
315
- if (lease.plan.plannerDraft && lease.plan.plannerModelId && lease.plan.plannerPromptVersion) {
316
- planning = {
317
- promptVersion: lease.plan.plannerPromptVersion,
318
- modelId: lease.plan.plannerModelId,
319
- ...(lease.plan.plannerUsage ? { usage: lease.plan.plannerUsage } : {}),
320
- draft: lease.plan.plannerDraft,
321
- effectiveReview: review,
322
- decision: input.decision.kind,
323
- };
255
+ /** Use an after-state title when every task audits the current filesystem state. */
256
+ function reviewModeSnapshot(snapshot: ReviewSnapshot, review: ReviewInput): ReviewSnapshot {
257
+ if (!hasChangeTask(review.tasks) && snapshot.target.includeUncommittedChanges) {
258
+ return { ...snapshot, title: "Current filesystem" };
259
+ }
260
+ return snapshot;
261
+ }
262
+
263
+ async function targetRuleError(
264
+ snapshot: ReviewSnapshot,
265
+ review: ReviewInput,
266
+ signal?: AbortSignal,
267
+ ): Promise<string | undefined> {
268
+ const change = hasChangeTask(review.tasks);
269
+ if (!change && snapshot.requestedTarget.from !== undefined) {
270
+ return "Review Targets for all-state tasks must not set from.";
271
+ }
272
+ if (!snapshot.target.includeUncommittedChanges && change && !snapshot.requestedTarget.from) {
273
+ return "A committed change Review Target requires an explicit from endpoint.";
274
+ }
275
+ if (!snapshot.target.includeUncommittedChanges && change) {
276
+ const root = await isRootCommit(snapshot.repositoryRoot, snapshot.target.toCommit, signal);
277
+ if (root) return "A committed change Review Target cannot use a root commit as to.";
278
+ }
279
+ if (change && snapshot.changes.length === 0) {
280
+ return "Every change Review Task requires a non-empty canonical change.";
281
+ }
282
+ return undefined;
283
+ }
284
+
285
+ type ResolvedReviewInput =
286
+ | { kind: "ready"; snapshot: ReviewSnapshot; review: ReviewInput; scope: ReviewScope }
287
+ | { kind: "no-target"; reason: string }
288
+ | { kind: "invalid"; reason: string };
289
+
290
+ function reviewTargetsMatch(left: ReviewTargetSpec, right: ReviewTargetSpec): boolean {
291
+ return (
292
+ left.from === right.from &&
293
+ left.to === right.to &&
294
+ (left.includeUncommittedChanges ?? true) === (right.includeUncommittedChanges ?? true)
295
+ );
296
+ }
297
+
298
+ /** Resolve Review input and revalidate any target captured before task editing. */
299
+ async function resolveReviewInput(input: RunReviewInput): Promise<ResolvedReviewInput> {
300
+ try {
301
+ const review = normalizeReviewInput(input.review);
302
+ const scope = normalizeReviewScope(input.scope);
303
+ // Resolve the execution target first. Materialization later verifies this exact snapshot.
304
+ const snapshot = await resolveReviewSnapshot(input.cwd, input.target, input.signal);
305
+ if (input.expectedSnapshot) {
306
+ const snapshotTarget = input.expectedSnapshotTarget ?? input.target;
307
+ const revalidatedSnapshot = reviewTargetsMatch(input.target, snapshotTarget)
308
+ ? snapshot
309
+ : await resolveReviewSnapshot(input.cwd, snapshotTarget, input.signal);
310
+ if (!snapshotsMatch(input.expectedSnapshot, revalidatedSnapshot)) {
311
+ return {
312
+ kind: "invalid",
313
+ reason: "The review target changed while tasks were edited. Start a new review.",
314
+ };
315
+ }
324
316
  }
317
+ return { kind: "ready", snapshot, review, scope };
318
+ } catch (error) {
319
+ input.signal?.throwIfAborted();
320
+ return { kind: "no-target", reason: snapshotErrorReason(error) };
325
321
  }
322
+ }
323
+
324
+ /** Execute one caller-defined Review. */
325
+ export async function runReview(input: RunReviewInput) {
326
+ const resolved = await resolveReviewInput(input);
327
+ if (resolved.kind !== "ready") return resolved;
328
+ const { snapshot: resolvedSnapshot, review, scope } = resolved;
329
+ const ruleError = await targetRuleError(resolvedSnapshot, review, input.signal);
330
+ if (ruleError) return { kind: "invalid" as const, reason: ruleError };
331
+ const snapshot = reviewModeSnapshot(resolvedSnapshot, review);
326
332
 
333
+ const provenance = input.provenance ?? "caller-supplied";
327
334
  input.onUpdate?.({
328
335
  content: [{ type: "text", text: "Freezing Review Workspace…" }],
329
336
  details: {
330
337
  completedCount: 0,
331
338
  totalCount: review.tasks.length,
332
339
  targetTitle: snapshot.title,
333
- reviewerModelId: model.canonicalId,
340
+ reviewerModelId: input.reviewerModel.canonicalId,
334
341
  ...(review.sharedContext ? { sharedContext: review.sharedContext } : {}),
342
+ ...(scope.paths?.length ? { scope } : {}),
335
343
  tasks: review.tasks,
336
344
  taskIds: review.tasks.map((task) => task.id),
337
345
  },
338
346
  });
339
- let workspace: Awaited<ReturnType<typeof materializeReviewWorkspace>>;
340
- try {
341
- workspace = await materializeReviewWorkspace(snapshot);
342
- } catch (error) {
343
- if (lease && planStore) planStore.release(lease);
344
- return { kind: "invalid" as const, reason: workspaceFailureReason(error) };
345
- }
347
+ const materializedWorkspace = await materializeReviewWorkspaceWithScope(
348
+ snapshot,
349
+ scope,
350
+ input.signal,
351
+ );
352
+ if (materializedWorkspace.kind === "invalid") return materializedWorkspace;
353
+ const { workspace } = materializedWorkspace;
346
354
 
347
355
  let dependencyBootstrapConfigured: boolean;
348
356
  try {
@@ -353,8 +361,8 @@ export async function runReview(input: RunReviewInput) {
353
361
  onUpdate: input.onUpdate,
354
362
  });
355
363
  } catch {
356
- if (lease && planStore) planStore.release(lease);
357
364
  await workspace.cleanup();
365
+ input.signal?.throwIfAborted();
358
366
  return { kind: "invalid" as const, reason: "Configured Dependency Bootstrap failed." };
359
367
  }
360
368
 
@@ -365,7 +373,8 @@ export async function runReview(input: RunReviewInput) {
365
373
  workspace.cwd,
366
374
  snapshot,
367
375
  review,
368
- model,
376
+ scope,
377
+ input.reviewerModel,
369
378
  input.projectTrusted,
370
379
  input.signal,
371
380
  input.onUpdate,
@@ -373,28 +382,24 @@ export async function runReview(input: RunReviewInput) {
373
382
  ? { store: input.auditStore, workspaceReceipt: workspace.receipt }
374
383
  : undefined,
375
384
  dependencyBootstrapConfigured,
385
+ input.providerAuthority,
386
+ input.recoveryModel,
387
+ input.recoveryModelId,
376
388
  );
377
- } catch (error) {
378
- if (lease && planStore) planStore.release(lease);
379
- throw error;
380
389
  } finally {
381
390
  cleanupWarning = await workspace.cleanup();
382
391
  }
383
- if (lease && planStore) {
384
- if (results.some((result) => result.status === "completed")) planStore.consume(lease);
385
- else planStore.release(lease);
386
- }
387
392
  const details: ReviewBatchDetails = {
388
393
  kind: "review-batch",
389
- mode: input.mode,
390
394
  provenance,
391
395
  snapshot: summarizeReviewSnapshot(snapshot),
392
396
  review,
397
+ ...(scope.paths?.length ? { scope } : {}),
393
398
  workspaceReceipt: workspace.receipt,
394
- ...(planning ? { planning } : {}),
399
+ ...(input.planning ? { planning: input.planning } : {}),
395
400
  ...(cleanupWarning ? { cleanupWarning } : {}),
396
401
  results,
397
402
  };
398
- const usage = combineUsage(results.map((result) => result.usage));
403
+ const usage = combineAgentRunUsage(results.map((result) => result.usage));
399
404
  return { kind: "completed" as const, details, ...(usage ? { usage } : {}) };
400
405
  }