@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,11 +1,10 @@
1
- import { lstat } from "node:fs/promises";
2
1
  import {
3
2
  runGit as git,
4
3
  runGitAllowExit as gitAllowExit,
4
+ runGitBuffer as gitBuffer,
5
5
  resolveGitRepositoryRoot,
6
6
  withReviewIndex,
7
7
  } from "../git-command.ts";
8
- import { resolveReviewPath } from "../review-path.ts";
9
8
  import type { ReviewSnapshot, ReviewSnapshotSummary, ReviewTargetSpec } from "../types.ts";
10
9
  import {
11
10
  buildReviewChanges,
@@ -14,16 +13,82 @@ import {
14
13
  } from "./change-metadata.ts";
15
14
  import { DIFF_FLAGS, diffUntrackedFile, parseNullList } from "./diff.ts";
16
15
 
17
- async function resolveCommit(cwd: string, value: string): Promise<string | undefined> {
18
- const canonical = (await gitAllowExit(cwd, ["rev-parse", "--verify", value], [1, 128])).trim();
19
- if (!canonical) return undefined;
20
- const type = (await gitAllowExit(cwd, ["cat-file", "-t", canonical], [128])).trim();
21
- if (type !== "commit") return undefined;
22
- return canonical.toLowerCase();
16
+ function validateTargetShape(target: ReviewTargetSpec): void {
17
+ if (!target || typeof target !== "object" || Array.isArray(target)) {
18
+ throw new Error("Review Target must be an object.");
19
+ }
20
+ const allowedFields = new Set(["from", "to", "includeUncommittedChanges"]);
21
+ for (const field of Object.keys(target)) {
22
+ if (!allowedFields.has(field))
23
+ throw new Error(`Review Target field ${field} is not supported.`);
24
+ }
25
+ for (const field of ["from", "to"] as const) {
26
+ if (target[field] !== undefined && typeof target[field] !== "string") {
27
+ throw new Error(`Review Target ${field} must be a Git revision string.`);
28
+ }
29
+ }
30
+ if (
31
+ target.includeUncommittedChanges !== undefined &&
32
+ typeof target.includeUncommittedChanges !== "boolean"
33
+ ) {
34
+ throw new Error("Review Target includeUncommittedChanges must be a boolean.");
35
+ }
23
36
  }
24
37
 
25
- async function headCommit(cwd: string): Promise<string | undefined> {
26
- const value = (
38
+ function normalizedEndpoint(value: string | undefined, name: "from" | "to"): string | undefined {
39
+ if (value === undefined) return undefined;
40
+ const endpoint = value.trim();
41
+ if (!endpoint) throw new Error(`Review Target ${name} must not be blank.`);
42
+ if (/\s/u.test(value)) throw new Error(`Review Target ${name} must not contain whitespace.`);
43
+ if (endpoint.includes("..") || endpoint.startsWith("^") || /\^[@!-]/u.test(endpoint)) {
44
+ throw new Error(`Review Target ${name} must name one commit, not a commit range.`);
45
+ }
46
+ return endpoint;
47
+ }
48
+
49
+ async function describeInvalidEndpoint(
50
+ cwd: string,
51
+ endpoint: string,
52
+ signal?: AbortSignal,
53
+ ): Promise<string | undefined> {
54
+ const object = (
55
+ await gitAllowExit(cwd, ["rev-parse", "--verify", "--end-of-options", endpoint], [1, 128], {
56
+ signal,
57
+ })
58
+ ).trim();
59
+ if (!object) return undefined;
60
+ const type = (await gitAllowExit(cwd, ["cat-file", "-t", object], [128], { signal })).trim();
61
+ return type || undefined;
62
+ }
63
+
64
+ /** Resolve one endpoint syntax string to one exact full commit id. */
65
+ async function resolveEndpoint(
66
+ cwd: string,
67
+ endpoint: string | undefined,
68
+ name: "from" | "to",
69
+ signal?: AbortSignal,
70
+ ): Promise<string | undefined> {
71
+ if (endpoint === undefined) return undefined;
72
+ const commit = (
73
+ await gitAllowExit(
74
+ cwd,
75
+ ["rev-parse", "--verify", "--end-of-options", `${endpoint}^{commit}`],
76
+ [1, 128],
77
+ { signal },
78
+ )
79
+ ).trim();
80
+ // The ^{commit} peel verifies the object type; this check verifies a canonical full object id.
81
+ if (/^(?:[0-9a-fA-F]{40}|[0-9a-fA-F]{64})$/u.test(commit)) return commit.toLowerCase();
82
+
83
+ const type = await describeInvalidEndpoint(cwd, endpoint, signal);
84
+ if (type === "tree" || type === "blob") {
85
+ throw new Error(`Review Target ${name} must resolve to a commit, not a ${type}.`);
86
+ }
87
+ throw new Error(`Review Target ${name} does not resolve to one commit in this repository.`);
88
+ }
89
+
90
+ async function capturedHead(cwd: string, signal?: AbortSignal): Promise<string> {
91
+ const head = (
27
92
  await gitAllowExit(
28
93
  cwd,
29
94
  [
@@ -33,248 +98,163 @@ async function headCommit(cwd: string): Promise<string | undefined> {
33
98
  "HEAD^{commit}",
34
99
  ],
35
100
  [1, 128],
101
+ { signal },
36
102
  )
37
103
  ).trim();
38
- return value || undefined;
39
- }
40
-
41
- async function commitParent(cwd: string, commit: string): Promise<string | undefined> {
42
- const body = await git(cwd, ["cat-file", "-p", commit]);
43
- const parent = body.match(/^parent ([0-9a-f]+)$/m)?.[1];
44
- if (!parent) return undefined;
45
- const type = (await gitAllowExit(cwd, ["cat-file", "-t", parent], [128])).trim();
46
- if (type !== "commit") {
47
- throw new Error(`First parent ${parent} for ${commit} is unavailable.`);
48
- }
49
- return parent;
50
- }
51
-
52
- async function resolveWorkingTreeBase(
53
- cwd: string,
54
- requested: Extract<ReviewTargetSpec, { kind: "working-tree" }>,
55
- head: string,
56
- ): Promise<{
57
- baseline: string;
58
- requestedBaseCommit?: string;
59
- mergeBaseCommit?: string;
60
- }> {
61
- if (!requested.baseCommit) return { baseline: head };
62
- const base = await resolveCommit(cwd, requested.baseCommit);
63
- if (!base) {
64
- throw new Error(`Commit ${requested.baseCommit.slice(0, 7)} not found in this repository.`);
65
- }
66
- const mergeBase = (await gitAllowExit(cwd, ["merge-base", base, head], [1])).trim();
67
- if (!mergeBase) {
68
- throw new Error(`No common ancestor between ${base.slice(0, 7)} and ${head.slice(0, 7)}.`);
69
- }
70
- return { baseline: mergeBase, requestedBaseCommit: base, mergeBaseCommit: mergeBase };
104
+ if (!head) throw new Error("No HEAD commit found in this repository.");
105
+ return head.toLowerCase();
71
106
  }
72
107
 
73
- async function workingTreeSnapshot(
108
+ /** True when this exact commit has no parent. A shallow boundary is not a root. */
109
+ export async function isRootCommit(
74
110
  cwd: string,
75
- requested: Extract<ReviewTargetSpec, { kind: "working-tree" }>,
76
- ): Promise<ReviewSnapshot | undefined> {
77
- const head = await headCommit(cwd);
78
- if (!head) return undefined;
79
- const base = await resolveWorkingTreeBase(cwd, requested, head);
80
- return withReviewIndex(cwd, head, base.baseline, async (indexFile) => {
81
- const [nameStatus, numstat, trackedDiff, untrackedText] = await Promise.all([
82
- git(cwd, ["diff", ...DIFF_FLAGS, "--name-status", "-z", base.baseline], indexFile),
83
- git(cwd, ["diff", ...DIFF_FLAGS, "--numstat", "-z", base.baseline], indexFile),
84
- git(cwd, ["diff", ...DIFF_FLAGS, base.baseline], indexFile),
85
- git(cwd, ["ls-files", "--others", "--exclude-standard", "-z"], indexFile),
86
- ]);
87
- const changes = buildReviewChanges(nameStatus, numstat);
88
- const diff = createDiffAccumulator();
89
- diff.append(trackedDiff);
90
- for (const path of parseNullList(untrackedText)) {
91
- const patch = await diffUntrackedFile(cwd, path);
92
- diff.append(patch);
93
- changes.push(untrackedPatchChange(path, patch));
94
- }
95
- changes.sort((left, right) => left.path.localeCompare(right.path));
96
- if (changes.length === 0) return undefined;
97
-
98
- return {
99
- repositoryRoot: cwd,
100
- requestedTarget: requested,
101
- target: {
102
- kind: "working-tree",
103
- headCommit: head,
104
- ...(base.requestedBaseCommit ? { requestedBaseCommit: base.requestedBaseCommit } : {}),
105
- ...(base.mergeBaseCommit ? { mergeBaseCommit: base.mergeBaseCommit } : {}),
106
- },
107
- title: base.mergeBaseCommit
108
- ? `Working tree changes ${base.mergeBaseCommit.slice(0, 7)}..filesystem`
109
- : "Working tree changes",
110
- changes,
111
- ...diff.finish(changes.length),
112
- };
113
- });
114
- }
115
-
116
- function isMissingPath(error: unknown): boolean {
117
- return (
118
- !!error &&
119
- typeof error === "object" &&
120
- "code" in error &&
121
- ((error as { code?: unknown }).code === "ENOENT" ||
122
- (error as { code?: unknown }).code === "ENOTDIR")
123
- );
111
+ commit: string,
112
+ signal?: AbortSignal,
113
+ ): Promise<boolean> {
114
+ const body = await git(cwd, ["cat-file", "-p", commit], undefined, signal);
115
+ const headerEnd = body.indexOf("\n\n");
116
+ const header = headerEnd < 0 ? body : body.slice(0, headerEnd);
117
+ return !/^parent [0-9a-f]+$/m.test(header);
124
118
  }
125
119
 
126
- /** Validate advisory Review Scope paths against the frozen current filesystem. */
127
- async function validateReviewScopePaths(
128
- root: string,
129
- paths: string[] | undefined,
130
- ): Promise<string[] | undefined> {
131
- if (!paths?.length) return undefined;
132
- const validated: string[] = [];
133
- const seen = new Set<string>();
134
- for (const path of paths) {
135
- const safe = resolveReviewPath(root, path);
136
- if (seen.has(safe.path)) continue;
137
- try {
138
- await lstat(safe.absolute);
139
- } catch (error) {
140
- if (isMissingPath(error)) {
141
- throw new Error(`Review Scope path does not exist in the current state: ${safe.path}`, {
142
- cause: error,
143
- });
120
+ async function filesystemSnapshot(
121
+ repositoryRoot: string,
122
+ target: ReviewSnapshot["target"],
123
+ signal?: AbortSignal,
124
+ ): Promise<Pick<ReviewSnapshot, "changes" | "diffHash" | "stats">> {
125
+ const baseline = target.fromCommit ?? target.toCommit;
126
+ return withReviewIndex(repositoryRoot, target.toCommit, baseline, {
127
+ signal,
128
+ operation: async (indexFile) => {
129
+ const [nameStatus, numstat, trackedDiff, untrackedText] = await Promise.all([
130
+ git(
131
+ repositoryRoot,
132
+ ["diff", ...DIFF_FLAGS, "--name-status", "-z", baseline],
133
+ indexFile,
134
+ signal,
135
+ ),
136
+ git(
137
+ repositoryRoot,
138
+ ["diff", ...DIFF_FLAGS, "--numstat", "-z", baseline],
139
+ indexFile,
140
+ signal,
141
+ ),
142
+ gitBuffer(repositoryRoot, ["diff", ...DIFF_FLAGS, baseline], indexFile, signal),
143
+ git(
144
+ repositoryRoot,
145
+ ["ls-files", "--others", "--exclude-standard", "-z"],
146
+ indexFile,
147
+ signal,
148
+ ),
149
+ ]);
150
+ const changes = buildReviewChanges(nameStatus, numstat);
151
+ const diff = createDiffAccumulator();
152
+ diff.append(trackedDiff);
153
+ for (const path of parseNullList(untrackedText)) {
154
+ signal?.throwIfAborted();
155
+ const patch = await diffUntrackedFile(repositoryRoot, path);
156
+ diff.append(patch);
157
+ changes.push(untrackedPatchChange(path, patch));
144
158
  }
145
- throw error;
146
- }
147
- seen.add(safe.path);
148
- validated.push(safe.path);
149
- }
150
- return validated;
151
- }
152
-
153
- async function currentStateSnapshot(
154
- cwd: string,
155
- requested: Extract<ReviewTargetSpec, { kind: "current-state" }>,
156
- ): Promise<ReviewSnapshot> {
157
- const head = await headCommit(cwd);
158
- if (!head) throw new Error("Current-State Audit requires at least one commit.");
159
- const paths = await validateReviewScopePaths(cwd, requested.paths);
160
- return withReviewIndex(cwd, head, head, async (indexFile) => {
161
- const [nameStatus, numstat, trackedDiff, untrackedText] = await Promise.all([
162
- git(cwd, ["diff", ...DIFF_FLAGS, "--name-status", "-z", head], indexFile),
163
- git(cwd, ["diff", ...DIFF_FLAGS, "--numstat", "-z", head], indexFile),
164
- git(cwd, ["diff", ...DIFF_FLAGS, head], indexFile),
165
- git(cwd, ["ls-files", "--others", "--exclude-standard", "-z"], indexFile),
166
- ]);
167
- const changes = buildReviewChanges(nameStatus, numstat);
168
- const diff = createDiffAccumulator();
169
- diff.append(trackedDiff);
170
- for (const path of parseNullList(untrackedText)) {
171
- const patch = await diffUntrackedFile(cwd, path);
172
- diff.append(patch);
173
- changes.push(untrackedPatchChange(path, patch));
174
- }
175
- changes.sort((left, right) => left.path.localeCompare(right.path));
176
- return {
177
- repositoryRoot: cwd,
178
- requestedTarget: { kind: "current-state", ...(paths ? { paths } : {}) },
179
- target: { kind: "current-state", headCommit: head },
180
- title: "Current state audit",
181
- changes,
182
- ...diff.finish(changes.length),
183
- };
159
+ changes.sort((left, right) => left.path.localeCompare(right.path));
160
+ return { changes, ...diff.finish(changes.length) };
161
+ },
184
162
  });
185
163
  }
186
164
 
187
- async function comparisonSnapshot(
188
- cwd: string,
189
- requested: Extract<ReviewTargetSpec, { kind: "comparison" }>,
190
- ): Promise<ReviewSnapshot | undefined> {
191
- const [base, head] = await Promise.all([
192
- resolveCommit(cwd, requested.baseCommit),
193
- headCommit(cwd),
194
- ]);
195
- if (!base) {
196
- throw new Error(`Commit ${requested.baseCommit.slice(0, 7)} not found in this repository.`);
197
- }
198
- if (!head) throw new Error("No HEAD commit found in this repository.");
199
- const mergeBase = (await gitAllowExit(cwd, ["merge-base", base, head], [1])).trim();
200
- if (!mergeBase) {
201
- throw new Error(`No common ancestor between ${base.slice(0, 7)} and ${head.slice(0, 7)}.`);
165
+ async function committedSnapshot(
166
+ repositoryRoot: string,
167
+ target: ReviewSnapshot["target"],
168
+ signal?: AbortSignal,
169
+ ): Promise<Pick<ReviewSnapshot, "changes" | "diffHash" | "stats">> {
170
+ if (!target.fromCommit) {
171
+ return { changes: [], ...createDiffAccumulator().finish(0) };
202
172
  }
203
173
  const [diffText, nameStatus, numstat] = await Promise.all([
204
- git(cwd, ["diff", ...DIFF_FLAGS, mergeBase, head]),
205
- git(cwd, ["diff", ...DIFF_FLAGS, "--name-status", "-z", mergeBase, head]),
206
- git(cwd, ["diff", ...DIFF_FLAGS, "--numstat", "-z", mergeBase, head]),
174
+ gitBuffer(
175
+ repositoryRoot,
176
+ ["diff", ...DIFF_FLAGS, target.fromCommit, target.toCommit],
177
+ undefined,
178
+ signal,
179
+ ),
180
+ git(
181
+ repositoryRoot,
182
+ ["diff", ...DIFF_FLAGS, "--name-status", "-z", target.fromCommit, target.toCommit],
183
+ undefined,
184
+ signal,
185
+ ),
186
+ git(
187
+ repositoryRoot,
188
+ ["diff", ...DIFF_FLAGS, "--numstat", "-z", target.fromCommit, target.toCommit],
189
+ undefined,
190
+ signal,
191
+ ),
207
192
  ]);
208
193
  const changes = buildReviewChanges(nameStatus, numstat);
209
- if (changes.length === 0) return undefined;
210
194
  const diff = createDiffAccumulator();
211
195
  diff.append(diffText);
212
- return {
213
- repositoryRoot: cwd,
214
- requestedTarget: requested,
215
- target: {
216
- kind: "comparison",
217
- requestedBaseCommit: base,
218
- mergeBaseCommit: mergeBase,
219
- headCommit: head,
220
- },
221
- title: `Changes ${mergeBase.slice(0, 7)}..${head.slice(0, 7)}`,
222
- changes,
223
- ...diff.finish(changes.length),
224
- };
196
+ return { changes, ...diff.finish(changes.length) };
225
197
  }
226
198
 
227
- async function commitSnapshot(
228
- cwd: string,
229
- requested: Extract<ReviewTargetSpec, { kind: "commit" }>,
230
- ): Promise<ReviewSnapshot | undefined> {
231
- const commit = await resolveCommit(cwd, requested.commit);
232
- if (!commit) {
233
- throw new Error(`Commit ${requested.commit.slice(0, 7)} not found in this repository.`);
199
+ function titleFor(target: ReviewSnapshot["target"]): string {
200
+ if (target.includeUncommittedChanges) {
201
+ return target.fromCommit
202
+ ? `Filesystem changes ${target.fromCommit.slice(0, 7)}..filesystem`
203
+ : "Current filesystem";
234
204
  }
235
- const parent = await commitParent(cwd, commit);
236
- const baseArgs = ["diff-tree", ...DIFF_FLAGS, "--root", "--no-commit-id"];
237
- const [diffText, nameStatus, numstat] = await Promise.all([
238
- parent
239
- ? git(cwd, ["diff", ...DIFF_FLAGS, parent, commit])
240
- : git(cwd, ["show", ...DIFF_FLAGS, "--format=", "--root", commit]),
241
- parent
242
- ? git(cwd, ["diff", ...DIFF_FLAGS, "--name-status", "-z", parent, commit])
243
- : git(cwd, [...baseArgs, "--name-status", "-r", "-z", commit]),
244
- parent
245
- ? git(cwd, ["diff", ...DIFF_FLAGS, "--numstat", "-z", parent, commit])
246
- : git(cwd, [...baseArgs, "--numstat", "-r", "-z", commit]),
247
- ]);
248
- const changes = buildReviewChanges(nameStatus, numstat);
249
- if (changes.length === 0) return undefined;
250
- const diff = createDiffAccumulator();
251
- diff.append(diffText);
252
- return {
253
- repositoryRoot: cwd,
254
- requestedTarget: requested,
255
- target: { kind: "commit", commit, ...(parent ? { parentCommit: parent } : {}) },
256
- title: `Commit ${commit.slice(0, 7)}`,
257
- changes,
258
- ...diff.finish(changes.length),
259
- };
205
+ return target.fromCommit
206
+ ? `Changes ${target.fromCommit.slice(0, 7)}..${target.toCommit.slice(0, 7)}`
207
+ : `State ${target.toCommit.slice(0, 7)}`;
260
208
  }
261
209
 
262
- /** Pin target identities and capture the target's changed paths, patch hash, and stats. */
210
+ /**
211
+ * Pin a Review Target to exact commits and capture its canonical patch metadata.
212
+ * This public resolver does not compute a merge base.
213
+ */
263
214
  export async function resolveReviewSnapshot(
264
215
  cwd: string,
265
- target: ReviewTargetSpec,
266
- ): Promise<ReviewSnapshot | undefined> {
267
- const root = await resolveGitRepositoryRoot(cwd);
268
- switch (target.kind) {
269
- case "working-tree":
270
- return workingTreeSnapshot(root, target);
271
- case "comparison":
272
- return comparisonSnapshot(root, target);
273
- case "commit":
274
- return commitSnapshot(root, target);
275
- case "current-state":
276
- return currentStateSnapshot(root, target);
216
+ requested: ReviewTargetSpec = {},
217
+ signal?: AbortSignal,
218
+ ): Promise<ReviewSnapshot> {
219
+ validateTargetShape(requested);
220
+ const repositoryRoot = await resolveGitRepositoryRoot(cwd, signal);
221
+ const from = normalizedEndpoint(requested.from, "from");
222
+ const to = normalizedEndpoint(requested.to, "to");
223
+ const includeUncommittedChanges = requested.includeUncommittedChanges ?? true;
224
+ if (includeUncommittedChanges && to !== undefined) {
225
+ throw new Error("Review Target to is not valid when includeUncommittedChanges is true.");
277
226
  }
227
+
228
+ const head = await capturedHead(repositoryRoot, signal);
229
+ const [fromCommit, explicitToCommit] = await Promise.all([
230
+ resolveEndpoint(repositoryRoot, from, "from", signal),
231
+ resolveEndpoint(repositoryRoot, to, "to", signal),
232
+ ]);
233
+ const toCommit = includeUncommittedChanges ? head : (explicitToCommit ?? head);
234
+ const target = {
235
+ ...(includeUncommittedChanges
236
+ ? { fromCommit: fromCommit ?? head }
237
+ : fromCommit
238
+ ? { fromCommit }
239
+ : {}),
240
+ toCommit,
241
+ includeUncommittedChanges,
242
+ };
243
+ const requestedTarget = {
244
+ ...(from ? { from } : {}),
245
+ ...(to ? { to } : {}),
246
+ includeUncommittedChanges,
247
+ };
248
+ const metadata = includeUncommittedChanges
249
+ ? await filesystemSnapshot(repositoryRoot, target, signal)
250
+ : await committedSnapshot(repositoryRoot, target, signal);
251
+ return {
252
+ repositoryRoot,
253
+ requestedTarget,
254
+ target,
255
+ title: titleFor(target),
256
+ ...metadata,
257
+ };
278
258
  }
279
259
 
280
260
  /** Return the public, patch-free snapshot summary. */
@@ -1,33 +1,14 @@
1
1
  import type { ReviewSnapshot } from "../types.ts";
2
2
 
3
- /** Compare two resolved Review Target identities for drift detection. */
3
+ /** Compare two resolved exact Review Targets for interactive drift detection. */
4
4
  export function targetsMatch(
5
5
  left: ReviewSnapshot["target"],
6
6
  right: ReviewSnapshot["target"],
7
7
  ): boolean {
8
- if (left.kind !== right.kind) return false;
9
- if (left.kind === "working-tree" && right.kind === "working-tree") {
10
- return (
11
- left.headCommit === right.headCommit &&
12
- left.requestedBaseCommit === right.requestedBaseCommit &&
13
- left.mergeBaseCommit === right.mergeBaseCommit
14
- );
15
- }
16
- if (left.kind === "comparison" && right.kind === "comparison") {
17
- return (
18
- left.requestedBaseCommit === right.requestedBaseCommit &&
19
- left.mergeBaseCommit === right.mergeBaseCommit &&
20
- left.headCommit === right.headCommit
21
- );
22
- }
23
- if (left.kind === "current-state" && right.kind === "current-state") {
24
- return left.headCommit === right.headCommit;
25
- }
26
8
  return (
27
- left.kind === "commit" &&
28
- right.kind === "commit" &&
29
- left.commit === right.commit &&
30
- left.parentCommit === right.parentCommit
9
+ left.fromCommit === right.fromCommit &&
10
+ left.toCommit === right.toCommit &&
11
+ left.includeUncommittedChanges === right.includeUncommittedChanges
31
12
  );
32
13
  }
33
14