@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,47 +1,19 @@
1
1
  import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
- import { Type } from "typebox";
2
+ import { Value } from "typebox/value";
3
3
  import type { LocalReviewAuditStore } from "../audit/local-review-audit-store.ts";
4
+ import { formatReplayOutline, projectReplayOutline } from "../audit/replay-outline.ts";
5
+ import { parseReviewAuditRecord, serializeReplayMessage } from "../audit/review-audit-record.ts";
4
6
  import { renderAuditCall, renderAuditResult } from "../tui/paged-output.ts";
5
- import {
6
- DEFAULT_PAGE_CHARACTERS,
7
- MAX_PAGE_CHARACTERS,
8
- modelFacingPage,
9
- pageText,
10
- } from "./output-page.ts";
7
+ import { modelFacingPage, pageText, type TextPage } from "./output-page.ts";
8
+ import { REVIEW_TOOL_SPECS } from "./tool-specs.ts";
11
9
 
12
- const reviewAuditSchema = Type.Object(
13
- {
14
- artifactId: Type.Optional(
15
- Type.String({
16
- minLength: 1,
17
- maxLength: 128,
18
- description:
19
- "Local replay id returned by an audited supi_review_run task; omit to list replays.",
20
- }),
21
- ),
22
- offset: Type.Optional(
23
- Type.Integer({
24
- minimum: 0,
25
- default: 0,
26
- description:
27
- "UTF-16 character offset; use only with artifactId and omit for the first page.",
28
- }),
29
- ),
30
- limit: Type.Optional(
31
- Type.Integer({
32
- minimum: 1,
33
- maximum: MAX_PAGE_CHARACTERS,
34
- default: DEFAULT_PAGE_CHARACTERS,
35
- description: "Maximum characters for this page; use only with artifactId.",
36
- }),
37
- ),
38
- },
39
- {
40
- additionalProperties: false,
41
- description:
42
- "Omit artifactId to list local replays. Supply artifactId to read one replay page.",
43
- },
44
- );
10
+ interface AuditParams {
11
+ artifactId?: string;
12
+ view?: "outline" | "message" | "raw";
13
+ messageIndex?: number;
14
+ offset?: number;
15
+ limit?: number;
16
+ }
45
17
 
46
18
  function formatAuditList(audits: Awaited<ReturnType<LocalReviewAuditStore["list"]>>): string {
47
19
  if (audits.length === 0) return "No non-expired local reviewer replays were found.";
@@ -52,46 +24,158 @@ function formatAuditList(audits: Awaited<ReturnType<LocalReviewAuditStore["list"
52
24
  ].join("\n");
53
25
  }
54
26
 
27
+ function pageDetails(page: TextPage) {
28
+ return {
29
+ offset: page.offset,
30
+ ...(page.nextOffset === undefined ? {} : { nextOffset: page.nextOffset }),
31
+ totalCharacters: page.totalCharacters,
32
+ };
33
+ }
34
+
35
+ function validateAuditCombination(params: AuditParams): void {
36
+ if (params.view && !params.artifactId) {
37
+ throw new Error("view requires artifactId. Omit view to list local replays.");
38
+ }
39
+ if (params.messageIndex !== undefined && params.view !== "message") {
40
+ throw new Error('messageIndex is valid only with view: "message".');
41
+ }
42
+ if (
43
+ params.view === "message" &&
44
+ (!Number.isSafeInteger(params.messageIndex) || (params.messageIndex ?? -1) < 0)
45
+ ) {
46
+ throw new Error('view: "message" requires a non-negative integer messageIndex.');
47
+ }
48
+ }
49
+
50
+ function completeOutlineRowIndexes(text: string, page: TextPage): number[] {
51
+ if (text === "[no messages]") return [];
52
+ const starts: Array<{ index: number; start: number; end: number }> = [];
53
+ let start = 0;
54
+ for (const line of text.split("\n")) {
55
+ const match = /^\[(\d+)\]/.exec(line);
56
+ const end = start + line.length;
57
+ if (match) starts.push({ index: Number(match[1]), start, end });
58
+ start = end + 1;
59
+ }
60
+ const pageEnd = page.nextOffset ?? page.totalCharacters;
61
+ return starts
62
+ .filter((row) => row.start >= page.offset && row.end <= pageEnd)
63
+ .map((row) => row.index);
64
+ }
65
+
66
+ async function listResult(
67
+ spec: typeof REVIEW_TOOL_SPECS.audit,
68
+ store: LocalReviewAuditStore,
69
+ params: AuditParams,
70
+ signal?: AbortSignal,
71
+ ) {
72
+ const audits = await store.list(signal);
73
+ const page = pageText(formatAuditList(audits), params.offset, params.limit);
74
+ const visibleAudits = audits.filter((audit) => {
75
+ signal?.throwIfAborted();
76
+ return page.text.includes(audit.artifactId);
77
+ });
78
+ return {
79
+ content: [{ type: "text" as const, text: modelFacingPage(spec.name, {}, page) }],
80
+ details: {
81
+ kind: "review-audit" as const,
82
+ mode: "list" as const,
83
+ audits: visibleAudits,
84
+ totalAudits: audits.length,
85
+ ...pageDetails(page),
86
+ },
87
+ };
88
+ }
89
+
90
+ async function artifactResult(
91
+ spec: typeof REVIEW_TOOL_SPECS.audit,
92
+ store: LocalReviewAuditStore,
93
+ params: AuditParams & { artifactId: string },
94
+ signal?: AbortSignal,
95
+ ) {
96
+ const raw = await store.read(params.artifactId, signal);
97
+ if (raw === undefined) {
98
+ throw new Error(`Reviewer replay ${params.artifactId} was not found or has expired.`);
99
+ }
100
+ const view = params.view ?? "outline";
101
+ if (view === "raw") {
102
+ const page = pageText(raw, params.offset, params.limit);
103
+ return {
104
+ content: [
105
+ {
106
+ type: "text" as const,
107
+ text: modelFacingPage(spec.name, { artifactId: params.artifactId, view: "raw" }, page),
108
+ },
109
+ ],
110
+ details: {
111
+ kind: "review-audit" as const,
112
+ mode: "raw" as const,
113
+ artifactId: params.artifactId,
114
+ ...pageDetails(page),
115
+ },
116
+ };
117
+ }
118
+
119
+ const record = parseReviewAuditRecord(raw);
120
+ if (view === "message") {
121
+ const messageIndex = params.messageIndex as number;
122
+ const text = serializeReplayMessage(record, messageIndex);
123
+ const page = pageText(text, params.offset, params.limit);
124
+ return {
125
+ content: [
126
+ {
127
+ type: "text" as const,
128
+ text: modelFacingPage(
129
+ spec.name,
130
+ { artifactId: params.artifactId, view: "message", messageIndex },
131
+ page,
132
+ ),
133
+ },
134
+ ],
135
+ details: {
136
+ kind: "review-audit" as const,
137
+ mode: "message" as const,
138
+ artifactId: params.artifactId,
139
+ messageIndex,
140
+ ...pageDetails(page),
141
+ },
142
+ };
143
+ }
144
+
145
+ const rows = projectReplayOutline(record.messages);
146
+ const text = formatReplayOutline(rows);
147
+ const page = pageText(text, params.offset, params.limit);
148
+ return {
149
+ content: [
150
+ {
151
+ type: "text" as const,
152
+ text: modelFacingPage(spec.name, { artifactId: params.artifactId, view: "outline" }, page),
153
+ },
154
+ ],
155
+ details: {
156
+ kind: "review-audit" as const,
157
+ mode: "outline" as const,
158
+ artifactId: params.artifactId,
159
+ totalMessages: rows.length,
160
+ messageIndexes: completeOutlineRowIndexes(text, page),
161
+ ...pageDetails(page),
162
+ },
163
+ };
164
+ }
165
+
55
166
  /** Register explicit retrieval for opt-in, local-only reviewer replay artifacts. */
56
167
  export function registerReviewAuditTool(pi: ExtensionAPI, store: LocalReviewAuditStore): void {
168
+ const spec = REVIEW_TOOL_SPECS.audit;
57
169
  pi.registerTool({
58
- name: "supi_review_audit",
59
- label: "Inspect Review Replay",
60
- description: `List local reviewer replays or read up to ${MAX_PAGE_CHARACTERS} UTF-16 characters from one. Available only when review auditing is enabled; replay content may contain raw repository evidence and tool output.`,
61
- promptSnippet: "List or inspect local reviewer replays",
62
- promptGuidelines: ["Do not repeat raw supi_review_audit replay content unless necessary."],
63
- parameters: reviewAuditSchema,
170
+ ...spec,
171
+ promptGuidelines: [...spec.promptGuidelines],
64
172
  renderCall: renderAuditCall,
65
173
  renderResult: renderAuditResult,
66
- async execute(_id, params) {
67
- if (!params.artifactId) {
68
- const audits = await store.list();
69
- return {
70
- content: [{ type: "text" as const, text: formatAuditList(audits) }],
71
- details: { kind: "review-audit" as const, mode: "list" as const, audits },
72
- };
73
- }
74
- const text = await store.read(params.artifactId);
75
- if (text === undefined) {
76
- throw new Error(`Reviewer replay ${params.artifactId} was not found or has expired.`);
77
- }
78
- const page = pageText(text, params.offset, params.limit);
79
- return {
80
- content: [
81
- {
82
- type: "text" as const,
83
- text: modelFacingPage("supi_review_audit", params.artifactId, page),
84
- },
85
- ],
86
- details: {
87
- kind: "review-audit" as const,
88
- mode: "replay" as const,
89
- artifactId: params.artifactId,
90
- offset: page.offset,
91
- ...(page.nextOffset === undefined ? {} : { nextOffset: page.nextOffset }),
92
- totalCharacters: page.totalCharacters,
93
- },
94
- };
174
+ async execute(_id, params, signal) {
175
+ if (!Value.Check(spec.parameters, params)) throw new Error("Invalid review audit input.");
176
+ validateAuditCombination(params);
177
+ if (!params.artifactId) return listResult(spec, store, params, signal);
178
+ return artifactResult(spec, store, { ...params, artifactId: params.artifactId }, signal);
95
179
  },
96
180
  });
97
181
  }
@@ -1,10 +1,15 @@
1
1
  import { recordDebugEvent } from "@mrclrchtr/supi-core/debug";
2
- import type { ReviewerExtensionSetStatus, ReviewProgress, ReviewTaskResult } from "../types.ts";
2
+ import type {
3
+ ReviewerExtensionSetStatus,
4
+ ReviewMode,
5
+ ReviewProgress,
6
+ ReviewTaskResult,
7
+ } from "../types.ts";
3
8
 
4
9
  /** Lifecycle facts observed for one finished review task. */
5
10
  export interface ReviewTaskDebugSummaryInput {
6
11
  taskId: string;
7
- targetKind: string;
12
+ mode: ReviewMode;
8
13
  targetTitle: string;
9
14
  packetBytes: number;
10
15
  durationMs: number;
@@ -35,7 +40,7 @@ export function recordReviewTaskDebugSummary(input: ReviewTaskDebugSummaryInput)
35
40
  const hitRate = cacheHitRate(tokens);
36
41
  const data = {
37
42
  taskId: input.taskId,
38
- targetKind: input.targetKind,
43
+ mode: input.mode,
39
44
  targetTitle: input.targetTitle,
40
45
  modelId: result.modelId,
41
46
  packetBytes: input.packetBytes,
@@ -1,3 +1,7 @@
1
+ import {
2
+ type AgentRunProviderAuthority,
3
+ createUnobservedAgentRunDiagnostics,
4
+ } from "@mrclrchtr/supi-agent-runtime/api";
1
5
  import { normalizeReviewInput } from "../review-input.ts";
2
6
  import { normalizeReviewSubmission } from "../review-result.ts";
3
7
  import { buildReviewPacket } from "../target/packet.ts";
@@ -7,11 +11,11 @@ import type {
7
11
  ReviewInput,
8
12
  ReviewModelSelection,
9
13
  ReviewProgress,
14
+ ReviewScope,
10
15
  ReviewSnapshot,
11
16
  ReviewTask,
12
17
  ReviewTaskResult,
13
18
  } from "../types.ts";
14
- import { createUnobservedChildFailureDiagnostics } from "./child-failure-diagnostics.ts";
15
19
  import { recordReviewTaskDebugSummary } from "./review-debug-summary.ts";
16
20
  import { runReviewer } from "./review-runner.ts";
17
21
 
@@ -29,6 +33,7 @@ export interface ReviewExecutionProgressDetails extends Record<string, unknown>
29
33
  workspacePath?: string;
30
34
  reviewerModelId?: string;
31
35
  sharedContext?: string;
36
+ scope?: ReviewScope;
32
37
  tasks?: ReviewTask[];
33
38
  taskIds?: string[];
34
39
  taskStates?: Record<string, ReviewExecutionPartialTaskState>;
@@ -41,16 +46,18 @@ export type ReviewExecutionUpdate = (result: {
41
46
  }) => void;
42
47
 
43
48
  function toTaskResult(
44
- taskId: string,
49
+ task: ReviewTask,
45
50
  packetHash: string,
46
51
  result: Awaited<ReturnType<typeof runReviewer>>,
47
52
  ): ReviewTaskResult {
48
53
  const identity = {
49
- taskId,
54
+ taskId: task.id,
55
+ mode: task.mode,
50
56
  packetHash,
51
57
  modelId: result.modelId,
52
58
  ...(result.usage ? { usage: result.usage } : {}),
53
59
  ...(result.capabilityWarnings ? { capabilityWarnings: result.capabilityWarnings } : {}),
60
+ ...(result.submissionRecovery ? { submissionRecovery: result.submissionRecovery } : {}),
54
61
  ...(result.audit ? { audit: result.audit } : {}),
55
62
  };
56
63
  if (result.kind === "success") {
@@ -101,12 +108,16 @@ export async function executeReviewTasks(
101
108
  workspaceCwd: string,
102
109
  snapshot: ReviewSnapshot,
103
110
  reviewInput: ReviewInput,
111
+ scope: ReviewScope,
104
112
  model: ReviewModelSelection,
105
113
  projectTrusted?: boolean,
106
114
  signal?: AbortSignal,
107
115
  onUpdate?: ReviewExecutionUpdate,
108
116
  audit?: ReviewerAuditRequest,
109
117
  dependencyBootstrapConfigured = false,
118
+ providerAuthority?: AgentRunProviderAuthority,
119
+ recoveryModel?: ReviewModelSelection,
120
+ recoveryModelId?: string,
110
121
  ): Promise<ReviewTaskResult[]> {
111
122
  const review = normalizeReviewInput(reviewInput);
112
123
  let completedCount = 0;
@@ -117,6 +128,7 @@ export async function executeReviewTasks(
117
128
  workspacePath: workspaceCwd,
118
129
  reviewerModelId: model.canonicalId,
119
130
  ...(review.sharedContext ? { sharedContext: review.sharedContext } : {}),
131
+ ...(scope.paths?.length ? { scope } : {}),
120
132
  tasks: review.tasks,
121
133
  taskIds: review.tasks.map((task) => task.id),
122
134
  };
@@ -136,7 +148,7 @@ export async function executeReviewTasks(
136
148
 
137
149
  return Promise.all(
138
150
  review.tasks.map(async (task) => {
139
- const packet = buildReviewPacket(snapshot, review, task, model);
151
+ const packet = buildReviewPacket(snapshot, review, scope, task, model);
140
152
  const packetBytes = Buffer.byteLength(packet.prompt, "utf8");
141
153
  const startedAt = Date.now();
142
154
  const debugSummary = (
@@ -145,7 +157,7 @@ export async function executeReviewTasks(
145
157
  ): void => {
146
158
  recordReviewTaskDebugSummary({
147
159
  taskId: task.id,
148
- targetKind: snapshot.target.kind,
160
+ mode: task.mode,
149
161
  targetTitle: snapshot.title,
150
162
  packetBytes,
151
163
  durationMs: Date.now() - startedAt,
@@ -167,6 +179,9 @@ export async function executeReviewTasks(
167
179
  prompt: packet.prompt,
168
180
  packetHash: packet.packetHash,
169
181
  model,
182
+ ...(recoveryModel ? { recoveryModel } : {}),
183
+ ...(recoveryModelId ? { recoveryModelId } : {}),
184
+ providerAuthority,
170
185
  projectTrusted,
171
186
  ...(audit ? { audit } : {}),
172
187
  ...(dependencyBootstrapConfigured ? { dependencyBootstrapConfigured } : {}),
@@ -184,7 +199,7 @@ export async function executeReviewTasks(
184
199
  });
185
200
  },
186
201
  });
187
- const taskResult = toTaskResult(task.id, packet.packetHash, result);
202
+ const taskResult = toTaskResult(task, packet.packetHash, result);
188
203
  debugSummary(taskResult, result.reviewerExtensionSetStatus);
189
204
  taskStates[task.id] = { status: taskResult.status };
190
205
  completedCount++;
@@ -200,10 +215,11 @@ export async function executeReviewTasks(
200
215
  const taskResult: ReviewTaskResult = {
201
216
  status: "failed",
202
217
  taskId: task.id,
218
+ mode: task.mode,
203
219
  packetHash: packet.packetHash,
204
220
  modelId: model.canonicalId,
205
221
  failureCode: "unexpected-runner-failure",
206
- diagnostics: createUnobservedChildFailureDiagnostics(),
222
+ diagnostics: createUnobservedAgentRunDiagnostics(),
207
223
  };
208
224
  debugSummary(taskResult, "unobserved");
209
225
  taskStates[task.id] = { status: "failed" };
@@ -1,9 +1,4 @@
1
- import type {
2
- EffectiveFindingScope,
3
- FindingCounts,
4
- ReviewBatchDetails,
5
- ReviewTaskResult,
6
- } from "../types.ts";
1
+ import type { FindingCounts, ReviewBatchDetails, ReviewScope, ReviewTaskResult } from "../types.ts";
7
2
  import { formatChildFailureDiagnostics } from "./child-failure-diagnostics.ts";
8
3
  import { formatReviewUsage } from "./usage-format.ts";
9
4
 
@@ -17,6 +12,25 @@ function formatFindingCounts(counts: FindingCounts): string {
17
12
  return `Findings: ${counts.total} total · ${counts.blocking} blocking · ${counts.nonBlocking} non-blocking · impact: ${counts.byImpact.high} high, ${counts.byImpact.medium} medium, ${counts.byImpact.low} low`;
18
13
  }
19
14
 
15
+ function formatScopeFocus(scope: ReviewScope | undefined): string {
16
+ const paths = scope?.paths;
17
+ return paths?.length
18
+ ? `path focus\n${paths.map((path) => `- ${JSON.stringify(path)}`).join("\n")}`
19
+ : "repository-wide review";
20
+ }
21
+
22
+ function appendSubmissionRecovery(lines: string[], result: ReviewTaskResult): void {
23
+ const recovery = result.submissionRecovery;
24
+ if (!recovery) return;
25
+ lines.push(`Submission recovery: ${recovery.status}`);
26
+ for (const attempt of recovery.attempts) {
27
+ lines.push(
28
+ `- ${attempt.modelId}: ${attempt.outcome}${attempt.usage ? ` (${formatReviewUsage(attempt.usage)})` : ""}`,
29
+ );
30
+ }
31
+ if (recovery.declineReason) lines.push(`Recovery decline: ${recovery.declineReason}`);
32
+ }
33
+
20
34
  function appendTaskStatus(
21
35
  lines: string[],
22
36
  result: ReviewTaskResult & { status: "failed" | "canceled" | "timeout" },
@@ -31,11 +45,11 @@ function appendTaskStatus(
31
45
  if (result.diagnostics) lines.push("", ...formatChildFailureDiagnostics(result.diagnostics));
32
46
  }
33
47
 
34
- function formatTaskResult(result: ReviewTaskResult, findingScope: EffectiveFindingScope): string[] {
48
+ function formatTaskResult(result: ReviewTaskResult): string[] {
35
49
  const lines = [
36
50
  "",
37
51
  `## ${result.taskId}`,
38
- `Finding Scope: ${findingScope}`,
52
+ `Review Mode: ${result.mode}`,
39
53
  `Model: ${result.modelId}`,
40
54
  `Packet SHA-256: ${result.packetHash}`,
41
55
  ];
@@ -44,16 +58,15 @@ function formatTaskResult(result: ReviewTaskResult, findingScope: EffectiveFindi
44
58
  lines.push(`Local replay: ${result.audit.artifactId} (expires ${result.audit.expiresAt})`);
45
59
  }
46
60
  appendCapabilityWarnings(lines, result);
61
+ appendSubmissionRecovery(lines, result);
47
62
  if (result.status !== "completed") {
48
63
  appendTaskStatus(lines, result);
49
64
  return lines;
50
65
  }
51
66
 
52
67
  lines.push(`Verdict: ${result.verdict.toUpperCase()}`, formatFindingCounts(result.findingCounts));
53
- if (result.criteriaCoverage?.status === "incomplete") {
54
- lines.push(
55
- `Criteria coverage: incomplete — ${result.criteriaCoverage.reason ?? "unspecified"}`,
56
- );
68
+ if (result.criteriaCoverage.status === "incomplete") {
69
+ lines.push(`Criteria coverage: incomplete — ${result.criteriaCoverage.reason}`);
57
70
  }
58
71
  lines.push("", result.summary);
59
72
  for (const finding of result.findings) {
@@ -73,22 +86,26 @@ function formatTaskResult(result: ReviewTaskResult, findingScope: EffectiveFindi
73
86
 
74
87
  /** Format complete Review Engine output for parent-facing Markdown and continuation storage. */
75
88
  export function formatReviewBatch(details: ReviewBatchDetails): string {
76
- const currentState = details.snapshot.target.kind === "current-state";
77
- const workspaceReceipt = currentState
78
- ? `Workspace receipt: ${details.workspaceReceipt.status} · current-state · frozen filesystem verified`
79
- : `Workspace receipt: ${details.workspaceReceipt.status} · ${details.workspaceReceipt.targetKind} · ${details.workspaceReceipt.changedPathCount} changed paths · ${details.workspaceReceipt.observedDiffHash}`;
89
+ const receipt = details.workspaceReceipt;
90
+ const workspaceReceipt = [
91
+ `Workspace receipt: ${receipt.status}`,
92
+ `from ${receipt.fromCommit ?? "none"}`,
93
+ `to ${receipt.toCommit}`,
94
+ receipt.includeUncommittedChanges ? "uncommitted changes included" : "committed state only",
95
+ `${receipt.changedPathCount} changed paths`,
96
+ receipt.observedDiffHash,
97
+ ].join(" · ");
80
98
  const lines = [
81
99
  "# Review Finished",
82
100
  "",
83
- `Mode: ${details.mode}`,
84
101
  `Provenance: ${details.provenance}`,
85
102
  `Target: ${details.snapshot.title}`,
103
+ `Focus: ${formatScopeFocus(details.scope)}`,
86
104
  workspaceReceipt,
87
105
  ];
88
106
  if (details.planning) {
89
107
  lines.push(
90
108
  `Planner: ${details.planning.modelId} (protocol ${details.planning.promptVersion})`,
91
- `Planner decision: ${details.planning.decision}`,
92
109
  ...(details.planning.usage
93
110
  ? [`Planner usage: ${formatReviewUsage(details.planning.usage)}`]
94
111
  : []),
@@ -102,14 +119,6 @@ export function formatReviewBatch(details: ReviewBatchDetails): string {
102
119
  `Recovery: ${details.cleanupWarning.recoveryCommand}`,
103
120
  );
104
121
  }
105
- const findingScopes = new Map<string, EffectiveFindingScope>(
106
- details.review.tasks.map((task) => [
107
- task.id,
108
- currentState ? "criteria-only" : (task.findingScope ?? "change-only"),
109
- ]),
110
- );
111
- for (const result of details.results) {
112
- lines.push(...formatTaskResult(result, findingScopes.get(result.taskId) ?? "change-only"));
113
- }
122
+ for (const result of details.results) lines.push(...formatTaskResult(result));
114
123
  return lines.join("\n");
115
124
  }
@@ -1,51 +1,31 @@
1
1
  import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
- import { Type } from "typebox";
3
2
  import type { ReviewArtifactStore } from "../session/review-artifact-store.ts";
4
3
  import { renderOutputCall, renderOutputResult } from "../tui/paged-output.ts";
5
4
  import type { ReviewOutputReference } from "../types.ts";
6
- import { DEFAULT_PAGE_CHARACTERS, MAX_PAGE_CHARACTERS, modelFacingPage } from "./output-page.ts";
5
+ import { modelFacingPage } from "./output-page.ts";
6
+ import { REVIEW_TOOL_SPECS } from "./tool-specs.ts";
7
7
 
8
- const outputPageSchema = Type.Object(
9
- {
10
- artifactId: Type.String({
11
- minLength: 1,
12
- maxLength: 128,
13
- description:
14
- "Opaque session-scoped id returned by supi_review_prepare or supi_review_run, not a file path.",
15
- }),
16
- offset: Type.Optional(
17
- Type.Integer({
18
- minimum: 0,
19
- default: 0,
20
- description:
21
- "UTF-16 character offset; omit for the first page, then use returned nextOffset.",
22
- }),
23
- ),
24
- limit: Type.Optional(
25
- Type.Integer({
26
- minimum: 1,
27
- maximum: MAX_PAGE_CHARACTERS,
28
- default: DEFAULT_PAGE_CHARACTERS,
29
- description: "Maximum characters for this page; omit for the default.",
30
- }),
31
- ),
32
- },
33
- {
34
- additionalProperties: false,
35
- description: "Read one page of an output artifact returned by a review or preparation call.",
36
- },
37
- );
8
+ interface ReviewOutputOptions {
9
+ firstPageCharacters?: number;
10
+ firstPageLines?: number;
11
+ }
38
12
 
39
13
  /** Store complete output and return its first bounded model-facing page. */
40
14
  export function createReviewOutput(
41
15
  store: ReviewArtifactStore,
42
16
  text: string,
17
+ options: ReviewOutputOptions = {},
43
18
  ): { text: string; reference: ReviewOutputReference } {
44
19
  const artifact = store.create(text);
45
- const page = store.read(artifact.id);
20
+ const page = store.read(
21
+ artifact.id,
22
+ undefined,
23
+ options.firstPageCharacters,
24
+ options.firstPageLines,
25
+ );
46
26
  if (!page) throw new Error("Review output expired before it could be returned.");
47
27
  return {
48
- text: modelFacingPage("supi_review_output", artifact.id, page),
28
+ text: modelFacingPage(REVIEW_TOOL_SPECS.output.name, { artifactId: artifact.id }, page),
49
29
  reference: {
50
30
  artifactId: artifact.id,
51
31
  offset: page.offset,
@@ -55,14 +35,12 @@ export function createReviewOutput(
55
35
  };
56
36
  }
57
37
 
58
- /** Register resumable retrieval for preparation and review output artifacts. */
38
+ /** Register resumable retrieval for agent and interactive Review output artifacts. */
59
39
  export function registerReviewOutputTool(pi: ExtensionAPI, store: ReviewArtifactStore): void {
40
+ const spec = REVIEW_TOOL_SPECS.output;
60
41
  pi.registerTool({
61
- name: "supi_review_output",
62
- label: "Read Review Output",
63
- description: `Read up to ${MAX_PAGE_CHARACTERS} UTF-16 characters from a session-scoped review or preparation output continuation. Use only with an artifact id returned by supi_review_prepare or supi_review_run.`,
64
- promptSnippet: "Continue paged review output",
65
- parameters: outputPageSchema,
42
+ ...spec,
43
+ promptGuidelines: [...spec.promptGuidelines],
66
44
  renderCall: renderOutputCall,
67
45
  renderResult: renderOutputResult,
68
46
  async execute(_id, params) {
@@ -76,7 +54,7 @@ export function registerReviewOutputTool(pi: ExtensionAPI, store: ReviewArtifact
76
54
  content: [
77
55
  {
78
56
  type: "text" as const,
79
- text: modelFacingPage("supi_review_output", params.artifactId, page),
57
+ text: modelFacingPage(spec.name, { artifactId: params.artifactId }, page),
80
58
  },
81
59
  ],
82
60
  details: {
@@ -91,5 +69,6 @@ export function registerReviewOutputTool(pi: ExtensionAPI, store: ReviewArtifact
91
69
  });
92
70
 
93
71
  pi.on("session_start", () => store.clear());
72
+ pi.on("session_tree", () => store.clear());
94
73
  pi.on("session_shutdown", () => store.clear());
95
74
  }