@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
package/src/tui/run.ts CHANGED
@@ -1,8 +1,4 @@
1
- /**
2
- * TUI renderer for supi_review_run — renderCall + renderResult.
3
- *
4
- * Dual-surface rendering: chrome built from details, markdown body excluded.
5
- */
1
+ /** TUI renderer for supi_review_run. */
6
2
 
7
3
  import type { Theme } from "@earendil-works/pi-coding-agent";
8
4
  import { Container, Spacer, Text } from "@earendil-works/pi-tui";
@@ -10,11 +6,12 @@ import type {
10
6
  ReviewExecutionPartialTaskState,
11
7
  ReviewExecutionProgressDetails,
12
8
  } from "../tool/review-execution.ts";
9
+ import { REVIEW_TOOL_SPECS } from "../tool/tool-specs.ts";
13
10
  import { formatReviewUsage } from "../tool/usage-format.ts";
14
11
  import type {
15
- EffectiveFindingScope,
16
12
  ReviewBatchDetails,
17
13
  ReviewProgress,
14
+ ReviewScope,
18
15
  ReviewTaskResult,
19
16
  } from "../types.ts";
20
17
  import {
@@ -26,69 +23,80 @@ import {
26
23
  renderReviewToolCall,
27
24
  } from "./common.ts";
28
25
 
29
- // ── Helpers ──────────────────────────────────────────────────────
30
-
31
- function findingScope(details: ReviewBatchDetails, taskId: string): EffectiveFindingScope {
32
- if (details.snapshot.target.kind === "current-state") return "criteria-only";
33
- return details.review.tasks.find((task) => task.id === taskId)?.findingScope ?? "change-only";
34
- }
35
-
36
- /** Format one task without collapsing independent verdicts into a batch verdict. */
37
- function formatTaskCollapsed(
38
- result: ReviewTaskResult,
39
- scope: EffectiveFindingScope,
40
- theme: Theme,
41
- ): string {
26
+ function formatTaskCollapsed(result: ReviewTaskResult, theme: Theme): string {
42
27
  const warnings = result.capabilityWarnings?.length ?? 0;
43
28
  const warningLabel =
44
29
  warnings > 0 ? ` · ${warnings} capability warning${warnings === 1 ? "" : "s"}` : "";
45
30
  if (result.status === "completed") {
46
31
  const findings = result.findings.length;
47
32
  const findingLabel = findings > 0 ? ` · ${findings} finding${findings === 1 ? "" : "s"}` : "";
48
- return `${result.taskId}: ${formatVerdictBadge(result.verdict, theme)}${theme.fg("dim", ` · ${scope}${findingLabel}${warningLabel}`)}`;
33
+ return `${result.taskId}: ${formatVerdictBadge(result.verdict, theme)}${theme.fg("dim", ` · ${result.mode}${findingLabel}${warningLabel}`)}`;
49
34
  }
50
35
  const label = formatStatusLabel(
51
36
  result.status,
52
37
  result.status === "failed" ? result.failureCode : undefined,
53
38
  result.status === "timeout" ? result.timeoutMs : undefined,
54
39
  );
55
- return `${result.taskId}: ${theme.fg("warning", label)}${theme.fg("dim", ` · ${scope}${warningLabel}`)}`;
40
+ return `${result.taskId}: ${theme.fg("warning", label)}${theme.fg("dim", ` · ${result.mode}${warningLabel}`)}`;
56
41
  }
57
42
 
58
- // ── renderCall ───────────────────────────────────────────────────
43
+ function formatScopeCount(scope: ReviewScope | undefined): string {
44
+ const count = scope?.paths?.length ?? 0;
45
+ if (count === 0) return "repository-wide";
46
+ return `path focus: ${count} ${count === 1 ? "path" : "paths"}`;
47
+ }
59
48
 
60
- export function renderRunCall(args: unknown, theme: Theme): Text {
61
- const params = (args ?? {}) as {
62
- direct?: {
63
- target?: {
64
- workingTree?: unknown;
65
- comparison?: unknown;
66
- commit?: unknown;
67
- currentState?: unknown;
68
- };
69
- };
70
- prepared?: unknown;
71
- };
72
- const target = params.direct?.target;
73
- const targetKind = target?.workingTree
74
- ? "working-tree"
75
- : target?.comparison
76
- ? "comparison"
77
- : target?.commit
78
- ? "commit"
79
- : target?.currentState
80
- ? "current-state"
81
- : "working-tree";
49
+ function isRecord(value: unknown): value is Record<string, unknown> {
50
+ return typeof value === "object" && value !== null && !Array.isArray(value);
51
+ }
52
+
53
+ function quotedEndpoint(value: unknown): string | undefined {
54
+ return typeof value === "string" ? JSON.stringify(value) : undefined;
55
+ }
82
56
 
83
- return renderReviewToolCall(
84
- "supi_review_run",
85
- params.prepared ? "prepared" : "direct",
86
- theme,
87
- params.prepared ? "from plan" : targetKind,
57
+ function formatRequestedTarget(target: unknown): string {
58
+ if (!isRecord(target)) return "requested target: current filesystem";
59
+ const from = quotedEndpoint(target.from);
60
+ const to = quotedEndpoint(target.to);
61
+ const includeUncommittedChanges = target.includeUncommittedChanges !== false;
62
+ if (!from && !to && includeUncommittedChanges) return "requested target: current filesystem";
63
+
64
+ const endpoints = [
65
+ ...(from ? [`from ${from}`] : []),
66
+ ...(to ? [`to ${to}`] : []),
67
+ ...(!to && !includeUncommittedChanges ? ['default to "HEAD"'] : []),
68
+ ];
69
+ return `requested target: ${endpoints.join(" · ")} · ${includeUncommittedChanges ? "uncommitted changes included" : "uncommitted changes excluded"}`;
70
+ }
71
+
72
+ function formatTaskModes(tasks: unknown): string {
73
+ if (!Array.isArray(tasks)) return "task modes: unspecified";
74
+ const modes = new Set(
75
+ tasks.flatMap((task) =>
76
+ isRecord(task) && (task.mode === "change" || task.mode === "state") ? [task.mode] : [],
77
+ ),
88
78
  );
79
+ const orderedModes = ["change", "state"].filter((mode) => modes.has(mode));
80
+ return orderedModes.length > 0
81
+ ? `task modes: ${orderedModes.join(", ")}`
82
+ : "task modes: unspecified";
89
83
  }
90
84
 
91
- // ── renderResult ─────────────────────────────────────────────────
85
+ /** Render requested Review Target facts, task-owned Review Modes, and Review Scope. */
86
+ export function renderRunCall(args: unknown, theme: Theme): Text {
87
+ const params = isRecord(args) ? args : {};
88
+ const paths = params.paths;
89
+ const scope =
90
+ Array.isArray(paths) && paths.every((path): path is string => typeof path === "string")
91
+ ? { paths }
92
+ : undefined;
93
+ const detail = [
94
+ formatRequestedTarget(params.target),
95
+ formatTaskModes(params.tasks),
96
+ formatScopeCount(scope),
97
+ ].join(" · ");
98
+ return renderReviewToolCall(REVIEW_TOOL_SPECS.run.name, "review", theme, detail);
99
+ }
92
100
 
93
101
  type PartialReviewDetails = ReviewExecutionProgressDetails;
94
102
 
@@ -119,6 +127,7 @@ function addPartialPreamble(
119
127
  if (details.sharedContext) {
120
128
  container.addChild(new Text(theme.fg("dim", `context: ${details.sharedContext}`), 1, 0));
121
129
  }
130
+ container.addChild(new Text(theme.fg("dim", `focus: ${formatScopeCount(details.scope)}`), 1, 0));
122
131
  }
123
132
 
124
133
  function formatPartialTask(
@@ -149,8 +158,10 @@ function addPartialTasks(container: Container, details: PartialReviewDetails, th
149
158
  container.addChild(
150
159
  new Text(formatPartialTask(taskId, details.taskStates?.[taskId], theme), 1, 0),
151
160
  );
152
- const instructions = details.tasks?.find((task) => task.id === taskId)?.instructions;
153
- if (instructions) container.addChild(new Text(theme.fg("dim", instructions), 1, 0));
161
+ const task = details.tasks?.find((candidate) => candidate.id === taskId);
162
+ if (task) {
163
+ container.addChild(new Text(theme.fg("dim", `${task.mode}: ${task.instructions}`), 1, 0));
164
+ }
154
165
  }
155
166
  }
156
167
 
@@ -161,10 +172,8 @@ function partialLabel(completed: number, total: number): string {
161
172
  function buildExpandedPartial(details: PartialReviewDetails, theme: Theme): Container {
162
173
  const completed = details.completedCount ?? 0;
163
174
  const total = details.totalCount ?? 0;
164
- const label = partialLabel(completed, total);
165
175
  const container = new Container();
166
- container.addChild(renderPartial(label, theme));
167
-
176
+ container.addChild(renderPartial(partialLabel(completed, total), theme));
168
177
  if (
169
178
  !details.targetTitle &&
170
179
  !details.workspacePath &&
@@ -173,69 +182,55 @@ function buildExpandedPartial(details: PartialReviewDetails, theme: Theme): Cont
173
182
  ) {
174
183
  return container;
175
184
  }
176
-
177
185
  container.addChild(new Spacer(1));
178
186
  addPartialPreamble(container, details, theme);
179
187
  addPartialTasks(container, details, theme);
180
188
  return container;
181
189
  }
182
190
 
191
+ /** Render either progressing or completed review state. */
183
192
  export function renderRunResult(
184
193
  result: {
185
194
  content?: Array<{ type: string; text?: string }>;
186
195
  details?: unknown;
187
- isError?: boolean;
188
196
  },
189
197
  options: { expanded: boolean; isPartial: boolean },
190
198
  theme: Theme,
199
+ context: { isError: boolean } = { isError: false },
191
200
  ): Container | Text {
192
201
  if (options.isPartial) {
193
202
  const details = result.details as PartialReviewDetails | undefined;
194
203
  if (options.expanded) return buildExpandedPartial(details ?? {}, theme);
195
- const completed = details?.completedCount ?? 0;
196
- const total = details?.totalCount ?? 0;
197
- return renderPartial(partialLabel(completed, total), theme);
204
+ return renderPartial(
205
+ partialLabel(details?.completedCount ?? 0, details?.totalCount ?? 0),
206
+ theme,
207
+ );
198
208
  }
199
-
200
209
  const details = result.details as ReviewBatchDetails | undefined;
201
-
202
- if (result.isError || !details) {
203
- return renderError("supi_review_run failed", theme);
210
+ if (context.isError || !details) {
211
+ return renderError(`${REVIEW_TOOL_SPECS.run.name} failed`, theme);
204
212
  }
205
-
206
- if (!options.expanded) {
207
- return buildCollapsed(details, theme);
208
- }
209
-
210
- return buildExpanded(details, theme);
213
+ return options.expanded ? buildExpanded(details, theme) : buildCollapsed(details, theme);
211
214
  }
212
215
 
213
- // ── Collapsed ────────────────────────────────────────────────────
214
-
215
216
  function buildCollapsed(details: ReviewBatchDetails, theme: Theme): Text {
216
217
  const tasks = details.results
217
- .map((result) => formatTaskCollapsed(result, findingScope(details, result.taskId), theme))
218
+ .map((result) => formatTaskCollapsed(result, theme))
218
219
  .join(` ${theme.fg("dim", "·")} `);
219
- const currentStateTarget =
220
- details.snapshot.requestedTarget.kind === "current-state"
221
- ? details.snapshot.requestedTarget
222
- : undefined;
220
+ const anyChange = details.results.some((result) => result.mode === "change");
223
221
  const { additions, deletions, files } = details.snapshot.stats;
224
- const targetDetail = currentStateTarget
225
- ? currentStateTarget.paths?.length
226
- ? `${currentStateTarget.paths.length} focus path${currentStateTarget.paths.length === 1 ? "" : "s"}`
227
- : "repository-wide"
228
- : `${files} file${files !== 1 ? "s" : ""} · +${additions.toLocaleString("en-US")} / -${deletions.toLocaleString("en-US")}`;
229
- const target = theme.fg("dim", `${details.snapshot.title} (${targetDetail})`);
230
- return new Text(`${tasks}\n${target}`, 0, 0);
222
+ const targetDetail = anyChange
223
+ ? `${files} file${files !== 1 ? "s" : ""} · +${additions.toLocaleString("en-US")} / -${deletions.toLocaleString("en-US")}`
224
+ : "frozen after state";
225
+ return new Text(
226
+ `${tasks}\n${theme.fg("dim", `${details.snapshot.title} · ${formatScopeCount(details.scope)} (${targetDetail})`)}`,
227
+ 0,
228
+ 0,
229
+ );
231
230
  }
232
231
 
233
- // ── Expanded ─────────────────────────────────────────────────────
234
-
235
232
  function buildExpanded(details: ReviewBatchDetails, theme: Theme): Container {
236
233
  const container = new Container();
237
-
238
- // Header
239
234
  const provenanceLabel =
240
235
  details.provenance === "planner-assisted"
241
236
  ? theme.fg("muted", "(planner-assisted)")
@@ -244,44 +239,21 @@ function buildExpanded(details: ReviewBatchDetails, theme: Theme): Container {
244
239
  new Text(`${theme.fg("accent", theme.bold("Review Finished"))} ${provenanceLabel}`, 1, 0),
245
240
  );
246
241
  container.addChild(new Spacer(1));
247
-
248
- // Preamble: mode + target
249
- container.addChild(
250
- new Text(`${theme.fg("dim", "mode:")} ${theme.fg("muted", details.mode)}`, 1, 0),
251
- );
252
242
  container.addChild(
253
243
  new Text(`${theme.fg("dim", "target:")} ${theme.fg("muted", details.snapshot.title)}`, 1, 0),
254
244
  );
255
- const currentStateTarget =
256
- details.snapshot.requestedTarget.kind === "current-state"
257
- ? details.snapshot.requestedTarget
258
- : undefined;
259
- const fileCount = details.snapshot.changes.length;
260
- container.addChild(
261
- new Text(
262
- theme.fg(
263
- "dim",
264
- currentStateTarget
265
- ? `review scope: ${currentStateTarget.paths?.map((path) => JSON.stringify(path)).join(", ") ?? "repository-wide discovery"}`
266
- : `${fileCount} file${fileCount !== 1 ? "s" : ""} changed · +${details.snapshot.stats.additions} / -${details.snapshot.stats.deletions}`,
267
- ),
268
- 1,
269
- 0,
270
- ),
271
- );
245
+ container.addChild(new Text(theme.fg("dim", `focus: ${formatScopeCount(details.scope)}`), 1, 0));
246
+ const receipt = details.workspaceReceipt;
272
247
  container.addChild(
273
248
  new Text(
274
249
  theme.fg(
275
250
  "dim",
276
- currentStateTarget
277
- ? `workspace: ${details.workspaceReceipt.status} · current-state · frozen filesystem`
278
- : `workspace: ${details.workspaceReceipt.status} · ${details.workspaceReceipt.targetKind} · ${details.workspaceReceipt.changedPathCount} paths`,
251
+ `workspace: ${receipt.status} · from ${receipt.fromCommit ?? "none"} · to ${receipt.toCommit} · ${receipt.includeUncommittedChanges ? "filesystem frozen" : "committed state"}`,
279
252
  ),
280
253
  1,
281
254
  0,
282
255
  ),
283
256
  );
284
-
285
257
  if (details.cleanupWarning) {
286
258
  container.addChild(new Spacer(1));
287
259
  container.addChild(
@@ -289,13 +261,11 @@ function buildExpanded(details: ReviewBatchDetails, theme: Theme): Container {
289
261
  );
290
262
  container.addChild(new Text(theme.fg("dim", details.cleanupWarning.workspacePath), 1, 0));
291
263
  }
292
-
293
- // Planning info
294
264
  if (details.planning) {
295
265
  container.addChild(new Spacer(1));
296
266
  container.addChild(
297
267
  new Text(
298
- `${theme.fg("dim", "planner:")} ${theme.fg("muted", details.planning.modelId)} · ${theme.fg("dim", "decision:")} ${theme.fg("muted", details.planning.decision)}`,
268
+ `${theme.fg("dim", "planner:")} ${theme.fg("muted", details.planning.modelId)} · ${theme.fg("dim", `protocol ${details.planning.promptVersion}`)}`,
299
269
  1,
300
270
  0,
301
271
  ),
@@ -310,15 +280,13 @@ function buildExpanded(details: ReviewBatchDetails, theme: Theme): Container {
310
280
  );
311
281
  }
312
282
  }
313
-
314
- // Per-task sections
315
283
  for (const result of details.results) {
316
284
  container.addChild(new Spacer(1));
317
- const taskLabel = `${result.taskId} (${findingScope(details, result.taskId)})`;
318
- container.addChild(new Text(theme.fg("accent", theme.bold(taskLabel)), 1, 0));
285
+ container.addChild(
286
+ new Text(theme.fg("accent", theme.bold(`${result.taskId} (${result.mode})`)), 1, 0),
287
+ );
319
288
  container.addChild(new Text(theme.fg("dim", "─".repeat(40)), 1, 0));
320
289
  buildTaskSection(container, result, theme);
321
290
  }
322
-
323
291
  return container;
324
292
  }
package/src/types.ts CHANGED
@@ -1,40 +1,33 @@
1
1
  import type { Model, Usage } from "@earendil-works/pi-ai";
2
+ import type {
3
+ AgentRunDiagnostics,
4
+ AgentRunProviderAuthority,
5
+ } from "@mrclrchtr/supi-agent-runtime/api";
2
6
  import type { LocalReviewAuditStore } from "./audit/local-review-audit-store.ts";
3
- import type { ChildLifecycleTrace } from "./tool/child-lifecycle-trace.ts";
4
7
  import type { ReviewWorkspaceCleanupWarning } from "./workspace/review-workspace.ts";
5
8
 
6
- /** A 7-64 character hexadecimal Git commit id, pinned to its full object id during resolution. */
9
+ /** A full Git commit id after target resolution. */
7
10
  export type CommitId = string;
8
11
 
9
- /**
10
- * The item selected for review: a Git change, a single commit, or a one-state
11
- * Current-State Audit of the complete filesystem. A working-tree target may
12
- * use an optional base commit to include committed branch work and current
13
- * filesystem changes; a current-state target may optionally focus inspection
14
- * with advisory workspace-relative paths.
15
- */
16
- export type ReviewTargetSpec =
17
- | { kind: "working-tree"; baseCommit?: CommitId }
18
- | { kind: "comparison"; baseCommit: CommitId }
19
- | { kind: "commit"; commit: CommitId }
20
- | { kind: "current-state"; paths?: string[] };
21
-
22
- /** Resolved identity of a selected review target. */
23
- export type ResolvedReviewTarget =
24
- | {
25
- kind: "working-tree";
26
- headCommit: CommitId;
27
- requestedBaseCommit?: CommitId;
28
- mergeBaseCommit?: CommitId;
29
- }
30
- | {
31
- kind: "comparison";
32
- requestedBaseCommit: CommitId;
33
- mergeBaseCommit: CommitId;
34
- headCommit: CommitId;
35
- }
36
- | { kind: "commit"; commit: CommitId; parentCommit?: CommitId }
37
- | { kind: "current-state"; headCommit: CommitId };
12
+ /** Public Review Target input. Omitted fields use the current filesystem target. */
13
+ export interface ReviewTargetSpec {
14
+ /** Optional before commit syntax. The Review Engine resolves it once. */
15
+ from?: string;
16
+ /** Optional after commit syntax. It is valid only when uncommitted changes are excluded. */
17
+ to?: string;
18
+ /** Include the current filesystem and non-ignored untracked files. Defaults to true. */
19
+ includeUncommittedChanges?: boolean;
20
+ }
21
+
22
+ /** Exact target state used by the Review Engine after endpoint resolution. */
23
+ export interface ResolvedReviewTarget {
24
+ /** Exact before commit or the filesystem freeze base. */
25
+ fromCommit?: CommitId;
26
+ /** Exact captured HEAD for a filesystem target, or exact committed after state. */
27
+ toCommit: CommitId;
28
+ /** True when the after state is the frozen current filesystem. */
29
+ includeUncommittedChanges: boolean;
30
+ }
38
31
 
39
32
  export interface DiffStats {
40
33
  files: number;
@@ -74,8 +67,9 @@ export type ReviewSnapshotSummary = Omit<ReviewSnapshot, "repositoryRoot">;
74
67
  /** Post-materialization proof that a Review Workspace matches its pinned target. */
75
68
  export interface ReviewWorkspaceReceipt {
76
69
  status: "verified";
77
- targetKind: ReviewTargetSpec["kind"];
78
- baselineRevision: string;
70
+ fromCommit?: CommitId;
71
+ toCommit: CommitId;
72
+ includeUncommittedChanges: boolean;
79
73
  expectedWorkspaceHead: CommitId;
80
74
  observedWorkspaceHead: CommitId;
81
75
  expectedDiffHash: string;
@@ -89,14 +83,8 @@ export interface ReviewAuditReference {
89
83
  expiresAt: string;
90
84
  }
91
85
 
92
- /** Eligibility policy for findings produced by one Review Task. */
93
- export type FindingScope = "change-only" | "boy-scout";
94
-
95
- /**
96
- * Effective finding scope rendered for one task. Current-State Audit fixes
97
- * `criteria-only`; Git change reviews use the task's caller-selected scope.
98
- */
99
- export type EffectiveFindingScope = FindingScope | "criteria-only";
86
+ /** Required evidence view and finding policy for one Review Task. */
87
+ export type ReviewMode = "change" | "state";
100
88
 
101
89
  /** Caller-identified authoritative issue or repository document for Review Criteria. */
102
90
  export interface CriteriaSource {
@@ -110,11 +98,17 @@ export interface CriteriaSource {
110
98
  export interface ReviewTask {
111
99
  id: string;
112
100
  instructions: string;
113
- /** Defaults to change-only when omitted; fixed criteria-only for Current-State Audit. */
114
- findingScope?: FindingScope;
101
+ /** Required evidence view and finding policy. */
102
+ mode: ReviewMode;
115
103
  criteriaSources?: CriteriaSource[];
116
104
  }
117
105
 
106
+ /** Optional batch-level path focus that remains separate from the Review Target. */
107
+ export interface ReviewScope {
108
+ /** Repository-relative paths that focus every task without restricting inspection. */
109
+ paths?: string[];
110
+ }
111
+
118
112
  /** Semantic input shared with the reviewer tasks in one run. */
119
113
  export interface ReviewInput {
120
114
  sharedContext?: string;
@@ -168,36 +162,38 @@ export interface NormalizedReviewSubmission extends ReviewSubmission {
168
162
  findingCounts: FindingCounts;
169
163
  }
170
164
 
165
+ /** Provenance for one finite same-session Submission Recovery chain. */
166
+ export interface SubmissionRecovery {
167
+ readonly status: "succeeded" | "declined" | "exhausted";
168
+ readonly attempts: readonly SubmissionRecoveryAttempt[];
169
+ readonly declineReason?: string;
170
+ }
171
+
172
+ /** One model's bounded Submission Recovery Turn. */
173
+ export interface SubmissionRecoveryAttempt {
174
+ readonly modelId: string;
175
+ readonly outcome:
176
+ | "submitted"
177
+ | "declined"
178
+ | "no-terminal-output"
179
+ | "model-switch-failed"
180
+ | "provider-failed";
181
+ readonly usage?: Usage;
182
+ }
183
+
171
184
  export type ReviewModelSelection = import("@mrclrchtr/supi-core/model-selection").ModelSelection;
172
185
 
173
186
  export type ChildStage = "planner" | "reviewer";
174
187
 
188
+ /** Runtime diagnostics retained under review's existing failure vocabulary. */
189
+ export type ChildFailureDiagnostics = AgentRunDiagnostics;
190
+
175
191
  export type ChildFailureCode =
176
192
  | "session-creation-failed"
177
193
  | "prompt-rejected"
178
194
  | "missing-structured-output"
179
195
  | "unexpected-runner-failure";
180
196
 
181
- export interface ChildFailureDiagnostics {
182
- lifecycleTrace: ChildLifecycleTrace;
183
- turns: number;
184
- toolUses: number;
185
- tokens?: {
186
- input: number;
187
- output: number;
188
- total: number;
189
- cacheRead?: number;
190
- cacheWrite?: number;
191
- };
192
- recentActivity?: string[];
193
- lastAssistantStopReason?: string;
194
- lastAssistantToolCalls?: string[];
195
- /** Bounded, redacted canonical provider error from the last errored assistant message. */
196
- lastAssistantErrorText?: string;
197
- /** Bounded, redacted provider error from the most recent recovery lifecycle event. */
198
- lastLifecycleErrorText?: string;
199
- }
200
-
201
197
  export type ChildFailedResult =
202
198
  | { failureCode: "session-creation-failed"; diagnostics?: never }
203
199
  | {
@@ -205,14 +201,7 @@ export type ChildFailedResult =
205
201
  diagnostics: ChildFailureDiagnostics;
206
202
  };
207
203
 
208
- /**
209
- * Typed result of running one isolated child session (planner or reviewer).
210
- *
211
- * Substrate-level: it carries the structured `value` on success, aggregate
212
- * `usage`, and bounded failure diagnostics — but no modelId, capability
213
- * warnings, or audit. Adapters attach those domain facts. `session-creation-failed`
214
- * stays a diagnostics-free `failed` via {@link ChildFailedResult}.
215
- */
204
+ /** Typed result of running one isolated child session. */
216
205
  export type ChildRunOutcome<T> =
217
206
  | { kind: "success"; value: T; usage?: Usage }
218
207
  | ({ kind: "failed"; usage?: Usage } & ChildFailedResult)
@@ -234,6 +223,7 @@ export interface ReviewProgress {
234
223
 
235
224
  export interface PlannerInvocation {
236
225
  prompt: string;
226
+ providerAuthority?: AgentRunProviderAuthority;
237
227
  // biome-ignore lint/suspicious/noExplicitAny: Model<any> is Pi's canonical type
238
228
  model: Model<any>;
239
229
  cwd: string;
@@ -255,9 +245,14 @@ export interface ReviewerAuditRequest {
255
245
 
256
246
  export interface ReviewerInvocation {
257
247
  prompt: string;
248
+ providerAuthority?: AgentRunProviderAuthority;
258
249
  packetHash: string;
259
250
  task: ReviewTask;
260
251
  model: ReviewModelSelection;
252
+ /** Optional explicit second model for Submission Recovery. */
253
+ recoveryModel?: ReviewModelSelection;
254
+ /** Requested recovery model id when configuration did not resolve. */
255
+ recoveryModelId?: string;
261
256
  cwd: string;
262
257
  snapshot: ReviewSnapshot;
263
258
  audit?: ReviewerAuditRequest;
@@ -275,10 +270,12 @@ export type ReviewerRunResult = ChildRunOutcome<ReviewSubmission> & {
275
270
  reviewerExtensionSetStatus: ReviewerExtensionSetStatus;
276
271
  capabilityWarnings?: ReviewerCapabilityWarning[];
277
272
  audit?: ReviewAuditReference;
273
+ submissionRecovery?: SubmissionRecovery;
278
274
  };
279
275
 
280
276
  interface ReviewTaskResultIdentity {
281
277
  taskId: string;
278
+ mode: ReviewMode;
282
279
  modelId: string;
283
280
  /** SHA-256 of the exact reviewer packet bytes. */
284
281
  packetHash: string;
@@ -286,6 +283,8 @@ interface ReviewTaskResultIdentity {
286
283
  usage?: Usage;
287
284
  /** Reviewer Extension Set capability degradation, kept separate from findings. */
288
285
  capabilityWarnings?: ReviewerCapabilityWarning[];
286
+ /** Provenance for a Submission Recovery chain, when one started. */
287
+ submissionRecovery?: SubmissionRecovery;
289
288
  /** Local-only opt-in reviewer replay, never included inline in review output. */
290
289
  audit?: ReviewAuditReference;
291
290
  }
@@ -316,14 +315,13 @@ export type ReviewTaskResult = ReviewTaskResultIdentity &
316
315
  }
317
316
  );
318
317
 
318
+ /** Metadata for a transient Planner Draft offered by an interactive Review. */
319
319
  export interface PlanningRecord {
320
320
  promptVersion: string;
321
321
  modelId: string;
322
- /** Planner usage is informational here and is not charged again by the run tool. */
322
+ /** Planner usage is included with the final interactive Review result. */
323
323
  usage?: Usage;
324
324
  draft: PlannerDraft;
325
- effectiveReview: ReviewInput;
326
- decision: "accept-draft" | "use-review";
327
325
  }
328
326
 
329
327
  /** Retrieval metadata for a bounded parent-facing review output page. */
@@ -336,10 +334,11 @@ export interface ReviewOutputReference {
336
334
 
337
335
  export interface ReviewBatchDetails {
338
336
  kind: "review-batch";
339
- mode: "direct" | "prepared";
340
337
  provenance: "caller-supplied" | "planner-assisted";
341
338
  snapshot: ReviewSnapshotSummary;
342
339
  review: ReviewInput;
340
+ /** Optional path focus validated against the frozen after state. */
341
+ scope?: ReviewScope;
343
342
  /** Verification receipt for the shared frozen Review Workspace. */
344
343
  workspaceReceipt: ReviewWorkspaceReceipt;
345
344
  planning?: PlanningRecord;
@@ -348,19 +347,6 @@ export interface ReviewBatchDetails {
348
347
  output?: ReviewOutputReference;
349
348
  }
350
349
 
351
- export interface PreparedReviewDetails {
352
- kind: "review-prepared";
353
- planId: string;
354
- snapshot: ReviewSnapshotSummary;
355
- reviewerModelId: string;
356
- plannerDraft?: PlannerDraft;
357
- plannerModelId?: string;
358
- plannerPromptVersion?: string;
359
- plannerUsage?: Usage;
360
- plannerFailure?: Exclude<PlannerRunResult, { kind: "success" }>;
361
- output?: ReviewOutputReference;
362
- }
363
-
364
350
  export interface ReviewPacket {
365
351
  prompt: string;
366
352
  /** SHA-256 of prompt encoded as UTF-8, used to verify adapter parity. */