@mrclrchtr/supi-review 4.10.0 → 6.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 (406) 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 +308 -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/debug.ts +9 -0
  15. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/evidence-badge.ts +41 -0
  16. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts +57 -0
  17. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/index.ts +34 -0
  18. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/llm.ts +201 -0
  19. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/model-selection.ts +134 -0
  20. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/path-utils.ts +44 -0
  21. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/path.ts +2 -0
  22. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/project-roots.ts +170 -0
  23. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/project.ts +15 -0
  24. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/prompt-surface.ts +4 -0
  25. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/registry-utils.ts +93 -0
  26. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/report.ts +121 -0
  27. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/session-utils.ts +71 -0
  28. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/session.ts +8 -0
  29. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +105 -0
  30. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts +453 -0
  31. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/settings.ts +36 -0
  32. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/spinner-frames.ts +11 -0
  33. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/status-spinner.ts +68 -0
  34. package/node_modules/@mrclrchtr/supi-agent-runtime/node_modules/@mrclrchtr/supi-core/src/terminal.ts +60 -0
  35. package/node_modules/@mrclrchtr/supi-agent-runtime/package.json +50 -0
  36. package/node_modules/@mrclrchtr/supi-agent-runtime/src/api.ts +42 -0
  37. package/node_modules/@mrclrchtr/supi-agent-runtime/src/diagnostic-sanitizer.ts +72 -0
  38. package/node_modules/@mrclrchtr/supi-agent-runtime/src/diagnostics.ts +203 -0
  39. package/node_modules/@mrclrchtr/supi-agent-runtime/src/lifecycle-trace.ts +275 -0
  40. package/node_modules/@mrclrchtr/supi-agent-runtime/src/provider-authority.ts +232 -0
  41. package/node_modules/@mrclrchtr/supi-agent-runtime/src/run.ts +1034 -0
  42. package/node_modules/@mrclrchtr/supi-agent-runtime/src/session-view.ts +120 -0
  43. package/node_modules/@mrclrchtr/supi-agent-runtime/src/types.ts +289 -0
  44. package/node_modules/@mrclrchtr/supi-agent-runtime/src/usage.ts +172 -0
  45. package/node_modules/@mrclrchtr/supi-code-intelligence/README.md +4 -3
  46. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/README.md +2 -0
  47. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  48. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +9 -0
  49. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/capability/types.ts +53 -13
  50. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/request-control.ts +47 -0
  51. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +13 -1
  52. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/README.md +2 -0
  53. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/package.json +2 -2
  54. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/api.ts +1 -1
  55. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
  56. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
  57. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -6
  58. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/debug.ts +9 -0
  59. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/index.ts +1 -1
  60. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +3 -0
  61. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/README.md +111 -5
  62. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/README.md +2 -0
  63. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  64. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +9 -0
  65. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/capability/types.ts +53 -13
  66. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/request-control.ts +47 -0
  67. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +13 -1
  68. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/README.md +2 -0
  69. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +2 -2
  70. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/api.ts +1 -1
  71. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
  72. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
  73. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -6
  74. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/debug.ts +9 -0
  75. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/index.ts +1 -1
  76. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +3 -0
  77. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/package.json +7 -6
  78. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/api.ts +22 -1
  79. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-cache.ts +245 -0
  80. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-capabilities.ts +78 -0
  81. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-collection.ts +171 -0
  82. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-evidence.ts +413 -0
  83. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-host.ts +15 -0
  84. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-publication.ts +214 -0
  85. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-pull.ts +62 -0
  86. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-refresh.ts +690 -0
  87. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-request.ts +9 -0
  88. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-timing.ts +97 -16
  89. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostic-waiters.ts +206 -0
  90. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-diagnostics.ts +448 -298
  91. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-state.ts +70 -0
  92. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-document-sync.ts +231 -0
  93. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client-file-state.ts +25 -0
  94. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/client.ts +529 -119
  95. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/client/transport.ts +161 -33
  96. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/capabilities.ts +12 -3
  97. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/config.ts +5 -5
  98. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/defaults.json +1 -1
  99. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/server-config.ts +3 -0
  100. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-extends.ts +68 -0
  101. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-path.ts +8 -0
  102. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/config/tsconfig-scope.ts +176 -24
  103. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/debug-telemetry.ts +45 -0
  104. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/evidence.ts +42 -0
  105. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/diagnostics/workspace-sentinels.ts +46 -10
  106. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-client-state.ts +79 -9
  107. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-diagnostics.ts +17 -7
  108. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-workspace-recovery.ts +350 -26
  109. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager-workspace-symbol.ts +5 -2
  110. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/manager/manager.ts +586 -96
  111. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/lsp-refactor-provider.ts +130 -0
  112. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/lsp-semantic-provider.ts +45 -329
  113. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/refactor-planning.ts +57 -120
  114. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-edit-normalizer.ts +320 -0
  115. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/provider/semantic-symbol-mapper.ts +207 -0
  116. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/readiness.ts +72 -2
  117. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-controller.ts +151 -26
  118. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostic-surface.ts +42 -0
  119. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-diagnostics.ts +92 -0
  120. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-registry.ts +165 -118
  121. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/runtime-transition-debug.ts +49 -0
  122. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-lsp/src/session/workspace-lsp-runtime.ts +102 -0
  123. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/README.md +17 -7
  124. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/README.md +2 -0
  125. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +1 -1
  126. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/api.ts +9 -0
  127. 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
  128. 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
  129. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/src/types.ts +13 -1
  130. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/README.md +2 -0
  131. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +2 -2
  132. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/api.ts +1 -1
  133. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
  134. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
  135. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -6
  136. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug.ts +9 -0
  137. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/index.ts +1 -1
  138. 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
  139. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/LICENSE +21 -0
  140. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/README.md +258 -0
  141. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/dist/babel.cjs +257 -0
  142. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/dist/jiti.cjs +1 -0
  143. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-cli.mjs +34 -0
  144. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-hooks.mjs +124 -0
  145. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-native.mjs +121 -0
  146. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-register.d.mts +1 -0
  147. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-register.mjs +4 -0
  148. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti-static.mjs +23 -0
  149. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.cjs +30 -0
  150. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.d.cts +8 -0
  151. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.d.mts +8 -0
  152. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/jiti.mjs +29 -0
  153. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/lib/types.d.ts +420 -0
  154. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/jiti/package.json +146 -0
  155. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/package.json +6 -3
  156. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/api.ts +0 -9
  157. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/index.ts +0 -8
  158. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/provider/tree-sitter-provider.ts +16 -12
  159. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/runtime-controller.ts +65 -87
  160. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/session.ts +47 -95
  161. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-timing.ts +147 -0
  162. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-client-lifecycle.ts +39 -0
  163. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-client.ts +561 -0
  164. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-message-size.ts +24 -0
  165. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/structural-worker-protocol.ts +452 -0
  166. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/call-sites.ts +4 -2
  167. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/callees.ts +12 -4
  168. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/exports.ts +4 -2
  169. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/imports.ts +4 -2
  170. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/node-at.ts +5 -3
  171. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/types.ts +33 -12
  172. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/blocking-test-bootstrap.mjs +34 -0
  173. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/bootstrap.mjs +8 -0
  174. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/parsed-file-store-helpers.ts +23 -0
  175. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/parsed-file-store.ts +400 -0
  176. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/request-control.ts +48 -0
  177. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime-parser-helpers.ts +24 -0
  178. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime-query-helpers.ts +43 -0
  179. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/runtime.ts +421 -0
  180. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/service.ts +116 -0
  181. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/worker/worker-main.ts +201 -0
  182. package/node_modules/@mrclrchtr/supi-code-intelligence/package.json +5 -5
  183. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/diagnostics.ts +221 -77
  184. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/file-scope.ts +184 -0
  185. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/health/recovery.ts +14 -3
  186. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/provider.ts +58 -0
  187. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/readiness.ts +34 -9
  188. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/refactor/apply.ts +45 -1
  189. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/refactor/mutation-authority.ts +143 -0
  190. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/callees.ts +9 -1
  191. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/relations/types.ts +5 -2
  192. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/ast-scan-timing.ts +9 -2
  193. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/ast-scan.ts +5 -2
  194. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/deadline.ts +2 -2
  195. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern-analysis.ts +54 -33
  196. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/search/pattern.ts +18 -3
  197. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/anchored.ts +20 -11
  198. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/file.ts +18 -11
  199. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/identity.ts +19 -3
  200. package/node_modules/@mrclrchtr/supi-code-intelligence/src/analysis/target/symbol.ts +36 -15
  201. package/node_modules/@mrclrchtr/supi-code-intelligence/src/api.ts +4 -0
  202. package/node_modules/@mrclrchtr/supi-code-intelligence/src/config.ts +35 -1
  203. package/node_modules/@mrclrchtr/supi-code-intelligence/src/diagnostics/evidence.ts +51 -0
  204. package/node_modules/@mrclrchtr/supi-code-intelligence/src/extension.ts +57 -14
  205. package/node_modules/@mrclrchtr/supi-code-intelligence/src/overview/overview-data.ts +9 -2
  206. package/node_modules/@mrclrchtr/supi-code-intelligence/src/overview/overview.ts +49 -30
  207. package/node_modules/@mrclrchtr/supi-code-intelligence/src/overview/types.ts +2 -0
  208. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/capability-adapter.ts +12 -3
  209. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/find-types.ts +2 -2
  210. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/find-workflow.ts +20 -9
  211. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph/collect.ts +18 -2
  212. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/graph-workflow.ts +19 -12
  213. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-refresh.ts +175 -0
  214. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-types.ts +43 -15
  215. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/health-workflow.ts +69 -54
  216. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/input/workflows.ts +2 -2
  217. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect/collect.ts +20 -3
  218. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/inspect-workflow.ts +12 -6
  219. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/collect.ts +12 -3
  220. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/context-facts.ts +3 -1
  221. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/context-sections.ts +20 -7
  222. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation/gather.ts +17 -11
  223. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-types.ts +4 -1
  224. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/orientation-workflow.ts +23 -10
  225. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-plans.ts +2 -0
  226. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/refactor-workflow.ts +61 -15
  227. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/session.ts +29 -2
  228. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/target-workflow.ts +54 -23
  229. package/node_modules/@mrclrchtr/supi-code-intelligence/src/session/workflow-control.ts +7 -3
  230. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/lifecycle.ts +26 -46
  231. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/maintenance.ts +284 -28
  232. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/recovery.ts +11 -5
  233. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/lsp/state.ts +2 -2
  234. package/node_modules/@mrclrchtr/supi-code-intelligence/src/substrate/workspace-provider-host.ts +25 -3
  235. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{find → code_find}/execute.ts +2 -16
  236. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/guidance.ts +8 -0
  237. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{find → code_find}/render.ts +21 -4
  238. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{result/find.ts → code_find/result.ts} +78 -9
  239. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/spec.ts +37 -0
  240. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_find/tui.ts +41 -0
  241. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/execute.ts +24 -0
  242. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/guidance.ts +6 -0
  243. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{graph → code_graph}/markdown.ts +1 -1
  244. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{result/graph.ts → code_graph/result.ts} +111 -3
  245. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/spec.ts +39 -0
  246. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_graph/tui.ts +117 -0
  247. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{health → code_health}/execute.ts +2 -13
  248. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/guidance.ts +8 -0
  249. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{health → code_health}/markdown.ts +119 -27
  250. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/refresh-status.ts +105 -0
  251. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{result/health.ts → code_health/result.ts} +80 -3
  252. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_health/spec.ts +41 -0
  253. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{health → code_health}/tui.ts +95 -98
  254. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{inspect → code_inspect}/execute.ts +2 -16
  255. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/guidance.ts +6 -0
  256. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{inspect → code_inspect}/markdown.ts +1 -1
  257. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{result/inspect.ts → code_inspect/result.ts} +143 -2
  258. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/spec.ts +25 -0
  259. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_inspect/tui.ts +44 -0
  260. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/execute.ts +25 -0
  261. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/guidance.ts +9 -0
  262. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{orientation → code_orientation}/markdown.ts +1 -1
  263. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/result.ts +248 -0
  264. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_orientation/spec.ts +25 -0
  265. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{orientation → code_orientation}/tui.ts +51 -35
  266. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_apply/execute.ts +17 -0
  267. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_apply/guidance.ts +5 -0
  268. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{refactor-apply/execute.ts → code_refactor_apply/result.ts} +8 -11
  269. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_apply/spec.ts +26 -0
  270. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_apply/tui.ts +73 -0
  271. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_plan/execute.ts +27 -0
  272. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_plan/guidance.ts +8 -0
  273. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{refactor-plan/execute.ts → code_refactor_plan/result.ts} +13 -22
  274. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_plan/spec.ts +25 -0
  275. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_refactor_plan/tui.ts +54 -0
  276. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/execute.ts +19 -0
  277. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/guidance.ts +8 -0
  278. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{resolve → code_resolve}/markdown.ts +1 -1
  279. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{result/resolve.ts → code_resolve/result.ts} +79 -29
  280. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/spec.ts +25 -0
  281. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/code_resolve/tui.ts +60 -0
  282. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/guidance.ts +71 -52
  283. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/infra/truncate.ts +40 -0
  284. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/infra/workflow-control.ts +8 -0
  285. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{refactor-plan/markdown.ts → refactor-markdown.ts} +4 -7
  286. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/register.ts +105 -88
  287. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/display.ts +107 -0
  288. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/errors.ts +20 -17
  289. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/refactor.ts +37 -8
  290. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/types.ts +20 -0
  291. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/schemas.ts +26 -157
  292. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/specs.ts +40 -126
  293. package/node_modules/@mrclrchtr/supi-code-intelligence/src/types/execution.ts +18 -5
  294. package/node_modules/@mrclrchtr/supi-code-intelligence/src/types/index.ts +8 -1
  295. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/status-command.ts +5 -3
  296. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/status-overlay.ts +4 -0
  297. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/common.ts +108 -10
  298. package/node_modules/@mrclrchtr/supi-code-intelligence/src/ui/tui/display.ts +48 -0
  299. package/node_modules/@mrclrchtr/supi-core/README.md +2 -0
  300. package/node_modules/@mrclrchtr/supi-core/package.json +2 -2
  301. package/node_modules/@mrclrchtr/supi-core/src/api.ts +1 -1
  302. package/node_modules/@mrclrchtr/supi-core/src/config/config.ts +31 -0
  303. package/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -0
  304. package/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +19 -6
  305. package/node_modules/@mrclrchtr/supi-core/src/debug.ts +9 -0
  306. package/node_modules/@mrclrchtr/supi-core/src/index.ts +1 -1
  307. package/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +3 -0
  308. package/package.json +6 -4
  309. package/src/audit/local-review-audit-store.ts +30 -6
  310. package/src/audit/replay-outline.ts +89 -0
  311. package/src/audit/review-audit-record.ts +40 -0
  312. package/src/audit/review-audit.ts +16 -4
  313. package/src/config.ts +44 -3
  314. package/src/git-command.ts +179 -23
  315. package/src/git.ts +71 -74
  316. package/src/history/collect.ts +13 -1
  317. package/src/model.ts +14 -0
  318. package/src/review-input.ts +72 -39
  319. package/src/review-limits.ts +1 -0
  320. package/src/review-path.ts +11 -63
  321. package/src/review-scope.ts +164 -0
  322. package/src/review.ts +20 -344
  323. package/src/session/review-artifact-store.ts +2 -2
  324. package/src/target/change-metadata.ts +10 -9
  325. package/src/target/diff.ts +19 -16
  326. package/src/target/file-manifest.ts +1 -0
  327. package/src/target/input.ts +90 -0
  328. package/src/target/packet.ts +78 -97
  329. package/src/target/resolve.ts +178 -228
  330. package/src/target/snapshot-match.ts +4 -23
  331. package/src/tool/output-page.ts +75 -14
  332. package/src/tool/page-render.ts +37 -0
  333. package/src/tool/page-schemas.ts +29 -0
  334. package/src/tool/review_audit/execute.ts +56 -0
  335. package/src/tool/review_audit/guidance.ts +10 -0
  336. package/src/tool/review_audit/register.ts +19 -0
  337. package/src/tool/review_audit/render.ts +89 -0
  338. package/src/tool/review_audit/result.ts +144 -0
  339. package/src/tool/review_audit/spec.ts +44 -0
  340. package/src/tool/review_output/execute.ts +19 -0
  341. package/src/tool/review_output/guidance.ts +7 -0
  342. package/src/tool/review_output/register.ts +23 -0
  343. package/src/tool/review_output/render.ts +37 -0
  344. package/src/tool/review_output/result.ts +33 -0
  345. package/src/tool/review_output/spec.ts +29 -0
  346. package/src/tool/review_run/child-failures.ts +38 -0
  347. package/src/tool/review_run/child-session.ts +161 -0
  348. package/src/tool/review_run/child-tools.ts +101 -0
  349. package/src/tool/{review-debug-summary.ts → review_run/debug-summary.ts} +8 -3
  350. package/src/tool/review_run/execute.ts +120 -0
  351. package/src/tool/{review-execution.ts → review_run/execution.ts} +29 -13
  352. package/src/tool/{review-format.ts → review_run/format.ts} +39 -32
  353. package/src/tool/review_run/guidance.ts +11 -0
  354. package/src/tool/review_run/input-schema.ts +188 -0
  355. package/src/tool/review_run/planner-input.ts +37 -0
  356. package/src/tool/{planner-runner.ts → review_run/planner.ts} +17 -16
  357. package/src/tool/{post-review-policy.ts → review_run/post-policy.ts} +11 -6
  358. package/src/tool/review_run/recovery.ts +191 -0
  359. package/src/tool/review_run/register.ts +24 -0
  360. package/src/{tui/run.ts → tool/review_run/render.ts} +108 -133
  361. package/src/tool/review_run/result.ts +51 -0
  362. package/src/tool/{review-runner.ts → review_run/runner.ts} +60 -19
  363. package/src/tool/{schemas.ts → review_run/schemas.ts} +36 -14
  364. package/src/tool/review_run/spec.ts +11 -0
  365. package/src/{review-result.ts → tool/review_run/submission.ts} +13 -9
  366. package/src/tool/{review-system-prompt.ts → review_run/system-prompt.ts} +7 -7
  367. package/src/tool/review_run/workflow.ts +409 -0
  368. package/src/tui/common.ts +20 -2
  369. package/src/tui/review-command.ts +407 -0
  370. package/src/tui/review-scope-picker.ts +38 -0
  371. package/src/tui/review-target-picker.ts +106 -0
  372. package/src/types.ts +82 -86
  373. package/src/workspace/review-workspace.ts +59 -79
  374. package/node_modules/@mrclrchtr/supi-code-intelligence/node_modules/@mrclrchtr/supi-tree-sitter/src/session/runtime.ts +0 -351
  375. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/find/tui.ts +0 -39
  376. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/graph/execute.ts +0 -62
  377. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/graph/tui.ts +0 -104
  378. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/inspect/tui.ts +0 -36
  379. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/orientation/execute.ts +0 -62
  380. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/refactor-apply/tui.ts +0 -55
  381. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/refactor-plan/tui.ts +0 -41
  382. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/resolve/execute.ts +0 -36
  383. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/resolve/tui.ts +0 -42
  384. package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/result/orientation.ts +0 -132
  385. package/src/session/review-plan-store.ts +0 -124
  386. package/src/tool/agent-review-schemas.ts +0 -273
  387. package/src/tool/agent-review-tools.ts +0 -342
  388. package/src/tool/child-failure-diagnostics.ts +0 -180
  389. package/src/tool/child-lifecycle-trace.ts +0 -345
  390. package/src/tool/child-session-runner.ts +0 -165
  391. package/src/tool/child-usage.ts +0 -73
  392. package/src/tool/criteria-only-scope.ts +0 -31
  393. package/src/tool/diagnostic-sanitizer.ts +0 -35
  394. package/src/tool/review-audit-tool.ts +0 -97
  395. package/src/tool/review-output-tool.ts +0 -95
  396. package/src/tool/review-tools.ts +0 -25
  397. package/src/tool/review-workflow.ts +0 -400
  398. package/src/tool/runner-helpers.ts +0 -52
  399. package/src/tool/session-lifecycle.ts +0 -281
  400. package/src/tui/paged-output.ts +0 -129
  401. package/src/tui/prepare.ts +0 -187
  402. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{find → code_find}/ast-kinds.ts +0 -0
  403. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{find → code_find}/markdown.ts +0 -0
  404. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{find → code_find}/modes.ts +0 -0
  405. /package/node_modules/@mrclrchtr/supi-code-intelligence/src/tool/{health → code_health}/semantic-state.ts +0 -0
  406. /package/src/tool/{child-resource-loader.ts → review_run/child-resources.ts} +0 -0
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  # @mrclrchtr/supi-review — Code Review for Pi
8
8
 
9
- Code review extension for the [Pi coding agent](https://github.com/earendil-works/pi) that runs parallel, isolated review tasks against a working tree, branch, commit, or the complete current filesystem state.
9
+ This Pi extension runs parallel, inspection-only code review tasks in one frozen Git workspace.
10
10
 
11
11
  ## Install
12
12
 
@@ -14,154 +14,143 @@ Code review extension for the [Pi coding agent](https://github.com/earendil-work
14
14
  pi install npm:@mrclrchtr/supi-review
15
15
  ```
16
16
 
17
- This is a beta package with intentionally unstable interfaces.
17
+ This package is beta software. Its interfaces can change.
18
18
 
19
19
  ## Surfaces
20
20
 
21
- - `/supi-review` — interactive Direct or Planner-assisted review
22
- - `/supi-review-cleanup` — recover marked Review Workspaces left by interrupted cleanup
23
- - `supi_review_prepare` — optional preparation with `planning: "none" | "suggest"`
24
- - `supi_review_run` — universal Direct or Prepared Review execution
25
- - `supi_review_output` — retrieve continuation pages from review/preparation output
26
- - `supi_review_audit` — disabled-by-default retrieval of locally recorded reviewer replays
21
+ - `/supi-review` — interactive review with optional Planner Draft help
22
+ - `/supi-review-cleanup` — remove marked Review Workspaces after an interrupted cleanup
23
+ - `review_run` — run one caller-defined Review
24
+ - `review_output` — read more parent-facing output
25
+ - `review_audit` — navigate local reviewer replays when audit is enabled
27
26
 
28
- Preparation is optional. Skills and agents that already know how to review should use Direct Review.
27
+ Changes to **Agent tools** apply immediately. Turning this setting off removes the agent start and audit tools from the active tool set. The output tool and the commands stay available.
29
28
 
30
- ## Direct Review
29
+ ## Review input
30
+
31
+ `review_run` has one flat input. It has `target`, optional top-level `paths`, optional `sharedContext`, and one to four `tasks`.
31
32
 
32
33
  ```json
33
34
  {
34
- "direct": {
35
- "target": {
36
- "comparison": { "baseCommit": "9510d68" }
35
+ "target": {
36
+ "committed": {
37
+ "from": "main",
38
+ "to": "HEAD"
39
+ }
40
+ },
41
+ "paths": ["packages/supi-review"],
42
+ "sharedContext": "The change implements issue #287.",
43
+ "tasks": [
44
+ {
45
+ "id": "standards",
46
+ "instructions": "Review against the repository standards.",
47
+ "mode": "change"
37
48
  },
38
- "sharedContext": "The change implements issue #123.",
39
- "tasks": [
40
- {
41
- "id": "standards",
42
- "instructions": "Review against the repository standards.",
43
- "findingScope": "change-only"
44
- },
45
- {
46
- "id": "spec",
47
- "instructions": "Review against issue #123 and cite unmet requirements."
48
- }
49
- ]
50
- }
49
+ {
50
+ "id": "state",
51
+ "instructions": "Review the frozen after state against issue #287.",
52
+ "mode": "state"
53
+ }
54
+ ]
51
55
  }
52
56
  ```
53
57
 
54
- One to four tasks share a reviewer model and one frozen Review Workspace. Direct and Prepared adapters use the same canonical packet compiler; every task result includes the SHA-256 of the exact packet bytes and nested-model usage when reported.
58
+ A Review Target selects at most one source object:
55
59
 
56
- Tasks may identify authoritative Review Criteria Sources whose summaries travel in the packet:
60
+ - `workingTree` — review the frozen current filesystem, including staged, unstaged, and non-ignored untracked files. Its optional `from` field sets the committed before state.
61
+ - `committed` — review exact committed Git state. Its optional `from` and `to` fields select the before and after commits. `to` defaults to `HEAD`.
57
62
 
58
- ```json
59
- {
60
- "direct": {
61
- "target": { "currentState": { "paths": ["packages/supi-review"] } },
62
- "tasks": [
63
- {
64
- "id": "spec",
65
- "instructions": "Review the current state against issue #123.",
66
- "criteriaSources": [
67
- { "reference": "#123", "summary": "Acceptance criteria: A, B, C." },
68
- { "reference": "docs/adr/0012.md", "summary": "Current-State Audit semantics." }
69
- ]
70
- }
71
- ]
72
- }
73
- }
74
- ```
63
+ Select at most one source object. Omit `target`, or use `{}`, to select the current filesystem. Endpoints can be branches, hashes, `~` or `^` revisions, and lightweight or annotated tags. The Review Engine resolves each endpoint once to a full commit. It rejects endpoints that contain whitespace and rejects blank endpoints, ranges, trees, and blobs.
75
64
 
76
- `currentState` audits one frozen filesystem state without Git-change attribution, so tasks must omit `findingScope`; the engine fixes `criteria-only`. `paths` is an optional advisory focus whose entries must exist in the frozen state.
65
+ Each task must set `mode` to `change` or `state`.
77
66
 
78
- ## Prepared Review
67
+ - `change` needs one non-empty canonical change. A `workingTree` change defaults its omitted `from` to captured `HEAD`. A `committed` change needs an explicit `from`.
68
+ - `state` reviews only the frozen after state. A batch of only state tasks must not set `from`. It can review a root commit.
79
69
 
80
- Preparation returns a session-scoped `planId` and optional Planner Draft. Planner failure returns a usable no-draft plan. Before a Prepared Review runs, the engine re-resolves the target and compares its exact Review Snapshot; drift invalidates the plan. A batch with at least one completed task consumes its plan, while an all-non-completed batch releases it for retry.
70
+ A committed change cannot use a root commit as `to`. A root commit is valid as `from`. Every Review requires a repository with `HEAD`.
81
71
 
82
- ```json
83
- {
84
- "prepared": {
85
- "planId": "review-plan-...",
86
- "draftDecision": { "useDraft": {} }
87
- }
88
- }
89
- ```
72
+ Tasks can include `criteriaSources`. Each source has a `reference` and a `summary`. The source remains authoritative when the summary is not sufficient.
90
73
 
91
- Use `draftDecision.replaceDraft` with a complete replacement task set when no draft was returned or it needs editing.
74
+ `paths` is an optional top-level Review Scope. Each path is workspace-relative. The Review Engine validates each path in the frozen after state before it starts Reviewer Sessions. Paths are advisory. They focus every task, but they do not restrict inspection, evidence, or findings.
92
75
 
93
- ## Targets and Review Workspaces
76
+ ## Review Workspaces
94
77
 
95
- The Review Engine resolves the Git worktree root once and pins commit identities before materializing one disposable linked Git worktree for the batch:
78
+ The Review Engine records exact commit state before it starts a Review Workspace.
96
79
 
97
- - `working-tree` — net current filesystem plus non-ignored untracked files against `HEAD`, or `merge-base(baseCommit, HEAD)`; the caller index is not evidence
98
- - `comparison` — merge base of `baseCommit` and captured `HEAD` to captured `HEAD`
99
- - `commit` — first parent (or empty tree) to `commit`
100
- - `currentState` — the complete current filesystem, including uncommitted and untracked work, reviewed as one state against Review Criteria
80
+ For a filesystem target, it checks out exact `from` and stages one canonical patch to the frozen current filesystem. The patch includes non-ignored untracked files. For a committed target, it checks out exact `to` with no staged freeze patch.
101
81
 
102
- A Working-Tree Review Workspace checks out its pinned baseline and stages the exact canonical patch, so `git diff HEAD` shows the complete target. Comparison and Commit workspaces check out their pinned after commit. Before Reviewer Sessions start, the engine re-compiles the target patch from the linked workspace and verifies its hash, expected checkout commit, and changed-path count. Every completed batch includes that compact Workspace receipt, so later caller edits cannot change the in-flight target.
82
+ The engine verifies the linked worktree before it starts Reviewer Sessions. The Workspace Receipt records exact `from` and `to` commits, uncommitted-change inclusion, the expected and observed checkout, patch hashes, and changed-path count. Later caller changes do not change Target Evidence.
103
83
 
104
- Workspaces are marked and locked in Git's worktree inventory. Normal cleanup removes them; an interrupted or failed cleanup can be recovered with `/supi-review-cleanup`. That command lists only SuPi-marked worktrees, requires a second confirmation for apparently active owners, and continues after individual failures.
84
+ Workspaces are marked and locked in the Git worktree list. Normal cleanup removes them. Use `/supi-review-cleanup` if cleanup stops early.
105
85
 
106
- ## Reviewer protocol
86
+ ## Settings
107
87
 
108
- Reviewers receive:
88
+ `review.agentModel` selects the reviewer model for agent-started Reviews. `review.plannerModel` selects the model for the optional Planner Draft in `/supi-review`. Both default to `current`, which uses the active session model.
109
89
 
110
- - Pi built-in `read`, `bash`, and `grep`
111
- - `code_resolve`, `code_inspect`, `code_orientation`, `code_graph`, `code_find`, and `code_health`
112
- - `submit_review`
90
+ `review.recoveryModel` selects one optional explicit model for Submission Recovery. It defaults to `disabled`. `current` is not a valid implicit Recovery Model. If the configured model is unavailable, the original review still runs. Recovery records the failed model switch only if the chain reaches that model.
113
91
 
114
- They use ordinary Git and direct reads in the frozen Review Workspace. Before-side content remains available through the packet's pinned Git revision. Code Intelligence runs in a headless inspection profile; an unavailable profile produces a Reviewer Capability Warning, while the built-in inspection tools remain available.
92
+ `review.bootstrapCommand` defaults to empty. When set, the Review Engine runs the command once in the frozen Review Workspace before Reviewer Sessions start. When empty, a reviewer can run a Dependency Bootstrap command when needed.
115
93
 
116
- Each Git-change Review Task may set `findingScope` to `change-only` (the default) or `boy-scout`. Change-only findings must be attributable to the selected change, including omitted or partial required behavior and acceptance-relevant scope creep. Boy Scout scope may additionally report pre-existing issues in changed files or symbols the reviewer judges directly affected; purely pre-existing findings are advisory unless the change worsens or newly exposes them. Current-State Audit uses fixed `criteria-only` scope: any finding relevant to the Review Criteria may block acceptance, regardless of when it was introduced. Repository standards and specifications requested by a task are Review Criteria, but repository content can never override the fixed Reviewer Protocol or task.
94
+ ## Reviewer Protocol
117
95
 
118
- Before alleging a documented-rule breach, reviewers check that rule's documented exceptions; covered candidates are omitted and submitted breach findings state why no exception applies. Test verification means inspecting test source, coverage, and requirement mapping; runtime checks stay with the containing Agent. When a task lists `criteriaSources`, reviewers use the supplied summaries first and may retrieve an identified source read-only when its summary is insufficient; unavailable required detail produces an incomplete Criteria Coverage statement rather than a false pass.
96
+ Reviewer Sessions have `read`, `bash`, `grep`, headless Code Intelligence tools, and `submit_review` during inspection. They inspect one shared frozen Review Workspace. They do not run tests, builds, linters, services, runtime experiments, nested Pi sessions, or nested reviews. They do not intentionally change Target Evidence or Git history.
119
97
 
120
- Inspection-only is behavioral protocol, not access control. The surrounding Sandboxed Pi Environment is the security boundary and must contain only files and credentials acceptable for reviewer-model access. When `review.bootstrapCommand` is configured, the Review Engine runs its shell command once after workspace verification and before reviewer fan-out; reviewers then receive no Dependency Bootstrap instruction. When it is empty, reviewers may choose a Dependency Bootstrap command when local dependencies limit Code Intelligence. They must not intentionally mutate Target Evidence or Git history, and must not run tests, builds, linters, runtime experiments, services, nested Pi sessions, or nested reviews.
98
+ The Reviewer Protocol owns finding eligibility:
121
99
 
122
- Reviewer Sessions replace Pi's generic coding prompt with the package-owned Reviewer Protocol. Ambient extensions, context files, skills, prompt templates, themes, and discovered system prompts are suppressed. In-memory settings disable compaction and provider retries.
100
+ - `change` permits findings attributable to the selected change. A pre-existing issue is permitted only in a changed file or a directly affected symbol. It stays advisory unless the selected change worsens or newly exposes it.
101
+ - `state` permits findings relevant to the Review Criteria anywhere in the frozen after state. A relevant pre-existing finding can block acceptance.
123
102
 
124
- ## Results and continuation
103
+ A change packet gives exact before and after guidance, a changed-path manifest, and change statistics. A state packet gives only after-state guidance. When it uses a filesystem workspace, staged changes are freeze mechanics and are not Target Evidence.
125
104
 
126
- Each successful task returns a summary, ordered findings, required Criteria Coverage, and structured counts by blocking status and impact. Parent-facing task output identifies the effective Finding Scope. Findings contain `blocksAcceptance`, `impact`, `effort`, `confidence`, and an optional target-relative location. The Review Engine derives `issues` when any finding blocks acceptance, otherwise `incomplete` when Criteria Coverage is incomplete, otherwise `pass_with_findings` for advisory-only findings and `pass` for none; it never aggregates or reranks tasks.
105
+ Repository content is untrusted evidence. It cannot override the Reviewer Protocol or a Review Task. Reviewer Sessions use repository documents as Review Criteria only.
127
106
 
128
- When SuPi debugging is enabled, every finished task records a compact `review-task` Debug Event with trustworthy lifecycle, usage, outcome, and capability metrics (packet bytes, duration, turns, tool calls/errors, cache hit rate, verdict, and Reviewer Extension Set status).
107
+ ## Interactive review
129
108
 
130
- Capability and cleanup warnings are execution provenance, not findings. By default, non-success diagnostics retain only bounded lifecycle metadata and redacted provider-owned error summaries; reviewer conversation, shell commands, tool arguments/results, and repository evidence are never retained.
109
+ `/supi-review` has four exact-target choices:
131
110
 
132
- ### Local reviewer replay
111
+ - **Current work** — the current filesystem; change tasks use captured `HEAD` as `from`.
112
+ - **Current work against a base branch** — the current filesystem; change tasks use the captured merge base as `from`.
113
+ - **Committed work against a base branch** — the captured merge base to captured `HEAD`.
114
+ - **One commit** — the selected commit; change tasks use its first parent as `from`.
133
115
 
134
- `review.auditEnabled` is off by default and requires `/reload` after changing it. When enabled, every task records a protected local replay containing provider-visible messages, tool calls/results, packet and protocol text, lifecycle timing, usage, and the Workspace receipt. Thinking blocks and thought signatures are omitted.
116
+ A root commit permits state tasks only. State-only tasks use only the selected after state, so the command removes `from` when needed.
135
117
 
136
- Replays expire automatically after seven days. They are not included in normal review output: a task reports only an opaque artifact id. Use `supi_review_audit` to list artifacts or page through one by id. Replays can contain raw repository evidence and shell output, so enable this only in environments where seven-day local retention is acceptable.
118
+ After target selection, choose repository-wide review or enter one workspace-relative path per line for an advisory Review Scope. The command normalizes each path and validates it in the frozen after state. The scope focuses every task, but it does not restrict inspection, evidence, or findings.
137
119
 
138
- Parent-facing text is stored as a bounded session artifact. Use `supi_review_output` with its returned opaque `artifactId` and offset to retrieve continuation pages.
120
+ The command captures its snapshot. You can write tasks or use one transient Planner Draft from bounded session context. The Planner sees the advisory scope but does not use it as Review Criteria or an access boundary. Edit the tasks and select each Review Mode, then confirm. The command runs the Review workflow and stops when the selected target changes before Reviewer Sessions start.
139
121
 
140
- ## Post-review behavior
122
+ ## Submission Recovery
123
+
124
+ If Pi accepted the original Reviewer Packet and the settled session retained an assistant message or any tool call or result, a missing structured submission can start a finite same-session recovery chain. Recovery never starts after creation failure, readiness failure, preflight rejection, cancellation, or timeout.
141
125
 
142
- `review.postReviewPolicy` controls what the containing Agent does when a completed review returns findings on either `/supi-review` or `supi_review_run`:
126
+ The first low-thinking turn uses the original reviewer model. One configured Recovery Model can make the final turn in the same session. During each recovery turn, exactly `submit_review` and `decline_review_recovery` are active. Recovery uses only retained history and cannot inspect more Target Evidence.
143
127
 
144
- - `ask` (default) — ask whether to verify, verify and fix, fix all or selected findings, or only report
145
- - `verify` — independently confirm or refute findings, then ask what to fix
146
- - `verify-and-fix` — verify every finding and fix those confirmed
147
- - `fix` — fix every reported finding, re-verifying conflicts or stale live code first
148
- - `report` — present the result without another action; `/supi-review` does not trigger an Agent turn
128
+ A valid recovered submission produces the normal Task Verdict. A decline or exhausted chain keeps the original failure and produces no Task Verdict. The task model and packet hash stay attributed to the original reviewer. `submissionRecovery` records the ordered delivery models, outcomes, decline reason when applicable, and per-turn usage. Task usage remains the one final cumulative session total.
149
129
 
150
- A direct user instruction about the current review's findings overrides this default when the Agent is already running. Reviews without findings do not trigger an extra command-originated turn.
130
+ ## Results and continuation
151
131
 
152
- ## Models
132
+ Each task result includes its Review Mode, packet SHA-256, verdict, finding counts, and reviewer usage when available. Results remain separate. The Review Engine does not make a batch verdict.
153
133
 
154
- `/supi-review` asks for the reviewer model. Agent-triggered runs use `review.agentModel`. Optional planning uses `review.plannerModel` at low thinking effort. Both default to the current session model.
134
+ `blocksAcceptance` keeps its existing meaning. The Review Engine derives `issues` for a blocking finding. It derives `incomplete` for incomplete Criteria Coverage without a blocking finding, `pass_with_findings` for only non-blocking findings, and `pass` for no findings.
155
135
 
156
- Configure post-review behavior and a single dependency setup command:
136
+ Parent-facing output from `review_run` or `/supi-review` is stored as a bounded session artifact. Use `review_output` with its returned `artifactId` and offset to read more output.
157
137
 
158
- ```json
159
- {
160
- "review": {
161
- "postReviewPolicy": "ask",
162
- "bootstrapCommand": "pnpm install --frozen-lockfile"
163
- }
164
- }
165
- ```
138
+ ## Local reviewer replay
139
+
140
+ `review.auditEnabled` is off by default. When **Agent tools** are on, enabling **Local reviewer replay** records a protected local replay for each Reviewer Session and activates `review_audit` immediately. Replays expire after seven days. Normal review output includes only an opaque artifact id.
141
+
142
+ With an artifact id, the audit tool now returns **Replay Outline** by default. The outline gives one metadata-only row for each stable zero-based position in the persisted captured-message array. It includes role, content kinds and size, tool names, stop reason, and error presence. It does not include message prose, provider error text, tool arguments, tool results, arbitrary message fields, or file paths.
143
+
144
+ Use `view: "message"` with `messageIndex` to page one selected persisted message. Use `view: "raw"` to page the exact complete replay JSON. Message and raw views remain private opt-in audit access and can contain repository evidence, provider errors, tool arguments, and tool output.
145
+
146
+ ## Post-review behavior
147
+
148
+ `review.postReviewPolicy` controls the containing Agent response when a completed Review has findings:
149
+
150
+ - `ask` — ask what to verify or fix
151
+ - `verify` — verify findings, then ask what to fix
152
+ - `verify-and-fix` — verify and fix confirmed findings
153
+ - `fix` — fix reported findings
154
+ - `report` — report findings without another action
166
155
 
167
- In `/supi-settings`, enter `pnpm install --frozen-lockfile`. An empty command (the default) leaves dependency bootstrap available to reviewers.
156
+ A direct user instruction for the current findings has priority.
@@ -0,0 +1,38 @@
1
+ # @mrclrchtr/supi-agent-runtime
2
+
3
+ Neutral lifecycle management for one context-isolated, permission-shared in-process pi Agent Run.
4
+
5
+ The package is library-only. Use `@mrclrchtr/supi-agent-runtime/api` to start a run with caller-owned resources, provider authority, completion, readiness, and evidence policy:
6
+
7
+ ```ts
8
+ import {
9
+ createAgentRunProviderAuthority,
10
+ startAgentRun,
11
+ } from "@mrclrchtr/supi-agent-runtime/api";
12
+
13
+ const run = startAgentRun({
14
+ inputs: {
15
+ cwd,
16
+ model,
17
+ providerAuthority: createAgentRunProviderAuthority(ctx.modelRegistry),
18
+ thinkingLevel,
19
+ tools,
20
+ customTools,
21
+ resourceLoader,
22
+ settingsManager,
23
+ },
24
+ prompt,
25
+ readinessCheck: (session) => requiredTools.every((name) => session.getActiveToolNames().includes(name)),
26
+ completionResolver: (session) => session.messages.at(-1)?.role === "assistant" ? session.getLastAssistantText() : undefined,
27
+ });
28
+
29
+ const outcome = await run.result;
30
+ ```
31
+
32
+ Agent Runs share the containing process's permissions and external sandbox; context isolation is not filesystem or security isolation.
33
+
34
+ ## Finite continuation
35
+
36
+ A package can add a bounded same-session continuation for a required structured result. The caller supplies declarative steps through `continuation.resolveNext()`. Each step specifies a prompt, an exact active-tool set, a thinking level, and an optional pre-authorized model. The runtime performs all prompts, model switches, tool changes, usage snapshots, cancellation checks, and final disposal.
37
+
38
+ Continuation can start only after Pi accepts the initial prompt. It can handle `missing-completion` and an accepted `unexpected-runner-failure`. It does not run after creation, readiness, preflight, cancellation, or timeout failures. `AgentRunSessionView` and `AgentRunHandle` remain control-free. The runtime disposes the owned session one time after the final outcome.
@@ -0,0 +1,116 @@
1
+ <div align="center">
2
+ <a href="https://github.com/mrclrchtr/supi/tree/main/packages/supi-core">
3
+ <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
4
+ </a>
5
+ </div>
6
+
7
+ # @mrclrchtr/supi-core
8
+
9
+ Shared infrastructure for SuPi extensions.
10
+
11
+ This is a **pure library** — it does not register any pi commands or tools. The `/supi-settings` command is now available through `@mrclrchtr/supi-settings`.
12
+
13
+ ## Install
14
+
15
+ ```bash
16
+ pnpm add @mrclrchtr/supi-core
17
+ ```
18
+
19
+ ## Package surfaces
20
+
21
+ - `@mrclrchtr/supi-core/api` — reusable helpers for other packages and extensions
22
+ - `@mrclrchtr/supi-core/report` — shared text/report rendering helpers for TUI and plain-text summaries
23
+
24
+ ## What you get from the API
25
+
26
+ ### Config helpers
27
+
28
+ - `loadSupiConfig()` — merged config with resolution order `defaults <- global <- project`
29
+ - `loadSupiConfigForScope()` — load one scope at a time for settings UIs
30
+ - `writeSupiConfig()` — persist values
31
+ - `replaceSupiConfigSection()` — replace one nested section while preserving other sections
32
+ - `removeSupiConfigKey()` — remove a key or override
33
+
34
+ Config file locations:
35
+
36
+ - global: `~/.pi/agent/supi/config.json`
37
+ - project: `.pi/supi/config.json`
38
+
39
+ ### Settings helpers
40
+
41
+ - `registerSettings(pi, module)` — register one canonical asynchronous settings module
42
+ - `defineConfigSettings(options)` — adapt a fixed SuPi config section to that module interface
43
+ - settings registry helpers and types for the `@mrclrchtr/supi-settings` configuration surface
44
+
45
+ ### Context helpers
46
+
47
+ - `wrapExtensionContext()` — wrap injected text in SuPi's `<extension-context>` tag
48
+
49
+ ### Shared registries
50
+
51
+ - context-provider registry for `/supi-context`
52
+ - debug-event registry and monotonic phase timers for producers that want shared debug capture
53
+ - optional Debug Operation IDs for exact, directly owned public Tool-call correlation; ambient events stay uncorrelated
54
+ - settings registry used by `/supi-settings`
55
+
56
+ ### Project and session helpers
57
+
58
+ - project-root detection and directory walking helpers such as `findProjectRoot()` and `walkProject()`
59
+ - active-branch session helper: `getActiveBranchEntries()`
60
+ - terminal helpers such as `formatTitle()`, `signalWaiting()`, and `signalDone()`
61
+
62
+ ### Report helpers
63
+
64
+ - `clampReportWidth()` — enforce a minimum readable report width
65
+ - `formatReportTitle()` / `formatSectionHeader()` — shared themed headers
66
+ - `formatDimLine()` / `formatKeyValueLine()` — common summary rows
67
+ - `formatOverflowHint()` — consistent preview-overflow hints
68
+ - `wrapReportText()` — ANSI-aware wrapped report blocks with optional indentation
69
+
70
+ ## Example
71
+
72
+ ```ts
73
+ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
74
+ import {
75
+ defineConfigSettings,
76
+ loadSupiConfig,
77
+ registerSettings,
78
+ wrapExtensionContext,
79
+ } from "@mrclrchtr/supi-core/api";
80
+
81
+ export default function myExtension(pi: ExtensionAPI) {
82
+ const defaults = { enabled: true };
83
+ const config = loadSupiConfig("my-extension", process.cwd(), defaults);
84
+
85
+ registerSettings(
86
+ pi,
87
+ defineConfigSettings({
88
+ id: "my-extension",
89
+ label: "My Extension",
90
+ section: "my-extension",
91
+ defaults,
92
+ fields: [
93
+ {
94
+ kind: "boolean" as const,
95
+ key: "enabled",
96
+ label: "Enabled",
97
+ },
98
+ ],
99
+ }),
100
+ );
101
+
102
+ const message = wrapExtensionContext("my-extension", "hello", {
103
+ enabled: config.enabled,
104
+ });
105
+ void message;
106
+ }
107
+ ```
108
+
109
+ ## Source
110
+
111
+ - `src/api.ts` — exported library surface
112
+ - `src/config.ts` — shared config loading and writing
113
+ - `src/debug-registry.ts` — Debug domain surface, event state, retention, redaction, listeners, and queries
114
+ - `src/debug-timing.ts` — monotonic total and phase timers for Debug Event Producers
115
+ - `src/settings/` — settings registry, schema, scope resolution, and persistence
116
+ - `src/report.ts` — shared text/report rendering helpers
@@ -0,0 +1,72 @@
1
+ {
2
+ "name": "@mrclrchtr/supi-core",
3
+ "version": "6.0.0",
4
+ "description": "Shared settings, configuration, reporting, and session infrastructure",
5
+ "license": "MIT",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "git+https://github.com/mrclrchtr/supi.git",
9
+ "directory": "packages/supi-core"
10
+ },
11
+ "homepage": "https://github.com/mrclrchtr/supi/tree/main/packages/supi-core#readme",
12
+ "bugs": {
13
+ "url": "https://github.com/mrclrchtr/supi/issues"
14
+ },
15
+ "publishConfig": {
16
+ "access": "public"
17
+ },
18
+ "keywords": [
19
+ "pi",
20
+ "pi-coding-agent",
21
+ "supi",
22
+ "extension-utils",
23
+ "settings",
24
+ "configuration"
25
+ ],
26
+ "type": "module",
27
+ "files": [
28
+ "src/**/*.ts",
29
+ "!__tests__"
30
+ ],
31
+ "peerDependencies": {
32
+ "@earendil-works/pi-ai": "*",
33
+ "@earendil-works/pi-coding-agent": "*",
34
+ "@earendil-works/pi-tui": "*",
35
+ "typebox": "*"
36
+ },
37
+ "peerDependenciesMeta": {
38
+ "@earendil-works/pi-ai": {
39
+ "optional": true
40
+ },
41
+ "@earendil-works/pi-coding-agent": {
42
+ "optional": true
43
+ },
44
+ "@earendil-works/pi-tui": {
45
+ "optional": true
46
+ },
47
+ "typebox": {
48
+ "optional": true
49
+ }
50
+ },
51
+ "main": "src/api.ts",
52
+ "exports": {
53
+ "./api": "./src/api.ts",
54
+ "./config": "./src/config.ts",
55
+ "./context": "./src/context.ts",
56
+ "./debug": "./src/debug.ts",
57
+ "./evidence-badge": "./src/evidence-badge.ts",
58
+ "./footer-registry": "./src/footer-registry.ts",
59
+ "./llm": "./src/llm.ts",
60
+ "./model-selection": "./src/model-selection.ts",
61
+ "./package.json": "./package.json",
62
+ "./path": "./src/path.ts",
63
+ "./project": "./src/project.ts",
64
+ "./prompt-surface": "./src/prompt-surface.ts",
65
+ "./report": "./src/report.ts",
66
+ "./session": "./src/session.ts",
67
+ "./settings": "./src/settings.ts",
68
+ "./spinner-frames": "./src/spinner-frames.ts",
69
+ "./status-spinner": "./src/status-spinner.ts",
70
+ "./terminal": "./src/terminal.ts"
71
+ }
72
+ }
@@ -0,0 +1,40 @@
1
+ // supi-core — shared infrastructure for SuPi extensions.
2
+ // Provides XML context tag wrapping, unified config, prompt-surface resolution,
3
+ // and shared settings, reporting, and session utilities.
4
+ //
5
+ // Convenience barrel — re-exports all domain entry points.
6
+ // For lighter imports, use one of the domain subpaths directly
7
+ // (e.g. @mrclrchtr/supi-core/config, @mrclrchtr/supi-core/context).
8
+
9
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
10
+ export * from "./config.ts";
11
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
12
+ export * from "./context.ts";
13
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
14
+ export * from "./debug.ts";
15
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
16
+ export * from "./evidence-badge.ts";
17
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
18
+ export * from "./footer-registry.ts";
19
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
20
+ export * from "./llm.ts";
21
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
22
+ export * from "./model-selection.ts";
23
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
24
+ export * from "./path.ts";
25
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
26
+ export * from "./project.ts";
27
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
28
+ export * from "./prompt-surface.ts";
29
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
30
+ export * from "./report.ts";
31
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
32
+ export * from "./session.ts";
33
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
34
+ export * from "./settings.ts";
35
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
36
+ export * from "./spinner-frames.ts";
37
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
38
+ export * from "./status-spinner.ts";
39
+ // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
40
+ export * from "./terminal.ts";