@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
@@ -0,0 +1,232 @@
1
+ // Shared config system for SuPi extensions.
2
+ //
3
+ // Global config: ~/.pi/agent/supi/config.json
4
+ // Project config: .pi/supi/config.json (relative to cwd)
5
+ // Resolution: hardcoded defaults ← global ← project
6
+
7
+ import * as fs from "node:fs";
8
+ import * as os from "node:os";
9
+ import * as path from "node:path";
10
+ import { CONFIG_DIR_NAME } from "@earendil-works/pi-coding-agent";
11
+
12
+ const GLOBAL_CONFIG_DIR = `${CONFIG_DIR_NAME}/agent/supi`;
13
+ const PROJECT_CONFIG_DIR = `${CONFIG_DIR_NAME}/supi`;
14
+ const CONFIG_FILE = "config.json";
15
+
16
+ function getGlobalConfigPath(homeDir?: string): string {
17
+ return path.join(homeDir ?? os.homedir(), GLOBAL_CONFIG_DIR, CONFIG_FILE);
18
+ }
19
+
20
+ function getProjectConfigPath(cwd: string): string {
21
+ return path.join(cwd, PROJECT_CONFIG_DIR, CONFIG_FILE);
22
+ }
23
+
24
+ /** Return the SuPi config file path for one scope. */
25
+ export function getSupiConfigPath(
26
+ scope: "global" | "project",
27
+ cwd: string,
28
+ options?: SupiConfigOptions,
29
+ ): string {
30
+ return scope === "global" ? getGlobalConfigPath(options?.homeDir) : getProjectConfigPath(cwd);
31
+ }
32
+
33
+ export function readJsonFile(filePath: string): Record<string, unknown> | null {
34
+ let content: string;
35
+ try {
36
+ content = fs.readFileSync(filePath, "utf-8");
37
+ } catch {
38
+ // ENOENT or permission error — silent, file may not exist
39
+ return null;
40
+ }
41
+
42
+ let parsed: unknown;
43
+ try {
44
+ parsed = JSON.parse(content);
45
+ } catch {
46
+ // biome-ignore lint/suspicious/noConsole: deliberate config parse warning
47
+ console.warn(`[supi-core] Failed to parse config file, ignoring: ${filePath}`);
48
+ return null;
49
+ }
50
+
51
+ if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
52
+ return parsed as Record<string, unknown>;
53
+ }
54
+
55
+ // biome-ignore lint/suspicious/noConsole: deliberate config parse warning
56
+ console.warn(`[supi-core] Config file root is not an object, ignoring: ${filePath}`);
57
+ return null;
58
+ }
59
+
60
+ function shallowMerge<T>(base: T, ...overrides: Array<Record<string, unknown> | null>): T {
61
+ let result = { ...base };
62
+ for (const override of overrides) {
63
+ if (!override) continue;
64
+ result = { ...result, ...override };
65
+ }
66
+ return result;
67
+ }
68
+
69
+ export interface SupiConfigOptions {
70
+ homeDir?: string;
71
+ }
72
+
73
+ /**
74
+ * Load and merge config for a given extension section.
75
+ *
76
+ * Resolution order: defaults ← global ← project
77
+ */
78
+ export function loadSupiConfig<T>(
79
+ section: string,
80
+ cwd: string,
81
+ defaults: T,
82
+ options?: SupiConfigOptions,
83
+ ): T {
84
+ const globalConfig = readJsonFile(getGlobalConfigPath(options?.homeDir));
85
+ const projectConfig = readJsonFile(getProjectConfigPath(cwd));
86
+
87
+ const globalSection = extractSection(globalConfig, section);
88
+ const projectSection = extractSection(projectConfig, section);
89
+
90
+ return shallowMerge(defaults, globalSection, projectSection);
91
+ }
92
+
93
+ /**
94
+ * Load config for a single scope only.
95
+ *
96
+ * Resolution order: defaults ← selected scope
97
+ *
98
+ * This is useful for settings UIs that need to show the raw values stored in
99
+ * one scope, rather than the effective merged config.
100
+ */
101
+ export function loadSupiConfigForScope<T>(
102
+ section: string,
103
+ cwd: string,
104
+ defaults: T,
105
+ options: { scope: "global" | "project" } & SupiConfigOptions,
106
+ ): T {
107
+ const config = readJsonFile(getSupiConfigPath(options.scope, cwd, { homeDir: options.homeDir }));
108
+
109
+ const scopedSection = extractSection(config, section);
110
+ return shallowMerge(defaults, scopedSection);
111
+ }
112
+
113
+ /** Load the raw object for one config section and one scope. */
114
+ export function loadSupiConfigSectionForScope(
115
+ section: string,
116
+ cwd: string,
117
+ options: { scope: "global" | "project" } & SupiConfigOptions,
118
+ ): Record<string, unknown> | null {
119
+ const config = readJsonFile(getSupiConfigPath(options.scope, cwd, { homeDir: options.homeDir }));
120
+ return extractSection(config, section);
121
+ }
122
+
123
+ export interface SupiConfigLocation {
124
+ section: string;
125
+ scope: "global" | "project";
126
+ cwd: string;
127
+ }
128
+
129
+ /**
130
+ * Write config values for a given extension section.
131
+ */
132
+ export function writeSupiConfig(
133
+ loc: SupiConfigLocation,
134
+ value: Record<string, unknown>,
135
+ options?: SupiConfigOptions,
136
+ ): void {
137
+ const configPath = getSupiConfigPath(loc.scope, loc.cwd, options);
138
+
139
+ const dir = path.dirname(configPath);
140
+ fs.mkdirSync(dir, { recursive: true });
141
+
142
+ const existing = readJsonFile(configPath) ?? {};
143
+ existing[loc.section] = {
144
+ ...((existing[loc.section] as Record<string, unknown>) ?? {}),
145
+ ...value,
146
+ };
147
+
148
+ fs.writeFileSync(configPath, `${JSON.stringify(existing, null, 2)}\n`, "utf-8");
149
+ }
150
+
151
+ /**
152
+ * Replace one complete config section while preserving other sections.
153
+ *
154
+ * This is useful for nested settings that must remove stale keys as part of
155
+ * one update. An empty section is removed from the config file.
156
+ */
157
+ export function replaceSupiConfigSection(
158
+ loc: SupiConfigLocation,
159
+ value: Record<string, unknown>,
160
+ options?: SupiConfigOptions,
161
+ ): void {
162
+ const configPath = getSupiConfigPath(loc.scope, loc.cwd, options);
163
+ const existing = readJsonFile(configPath) ?? {};
164
+
165
+ if (Object.keys(value).length > 0) existing[loc.section] = value;
166
+ else delete existing[loc.section];
167
+
168
+ const content = Object.keys(existing).length > 0 ? `${JSON.stringify(existing, null, 2)}\n` : "";
169
+ if (content) {
170
+ fs.mkdirSync(path.dirname(configPath), { recursive: true });
171
+ fs.writeFileSync(configPath, content, "utf-8");
172
+ return;
173
+ }
174
+
175
+ try {
176
+ fs.unlinkSync(configPath);
177
+ } catch {
178
+ // File may not exist.
179
+ }
180
+ }
181
+
182
+ /**
183
+ * Remove a key from a config section.
184
+ * Used by `interval default` to remove the project override.
185
+ */
186
+ export function removeSupiConfigKey(
187
+ loc: SupiConfigLocation,
188
+ key: string,
189
+ options?: SupiConfigOptions,
190
+ ): void {
191
+ const configPath = getSupiConfigPath(loc.scope, loc.cwd, options);
192
+
193
+ const existing = readJsonFile(configPath);
194
+ if (!existing) return;
195
+
196
+ const sectionData = existing[loc.section] as Record<string, unknown> | undefined;
197
+ if (!sectionData) return;
198
+
199
+ delete sectionData[key];
200
+
201
+ if (Object.keys(sectionData).length === 0) {
202
+ delete existing[loc.section];
203
+ }
204
+
205
+ const dir = path.dirname(configPath);
206
+ fs.mkdirSync(dir, { recursive: true });
207
+
208
+ const content = Object.keys(existing).length > 0 ? `${JSON.stringify(existing, null, 2)}\n` : "";
209
+
210
+ if (content) {
211
+ // Directory guaranteed to exist since we just read from it
212
+ fs.writeFileSync(configPath, content, "utf-8");
213
+ } else {
214
+ try {
215
+ fs.unlinkSync(configPath);
216
+ } catch {
217
+ // File may not exist
218
+ }
219
+ }
220
+ }
221
+
222
+ function extractSection(
223
+ config: Record<string, unknown> | null,
224
+ section: string,
225
+ ): Record<string, unknown> | null {
226
+ if (!config) return null;
227
+ const data = config[section];
228
+ if (typeof data === "object" && data !== null && !Array.isArray(data)) {
229
+ return data as Record<string, unknown>;
230
+ }
231
+ return null;
232
+ }
@@ -0,0 +1,363 @@
1
+ // Configurable tool prompt-surface overrides.
2
+ //
3
+ // Resolution order: package defaults ← global SuPi config ← trusted project SuPi config.
4
+ // Project overrides are trust-gated; they require PI project trust and a PI-recognized
5
+ // trust-requiring resource (e.g. .pi/settings.json).
6
+
7
+ import {
8
+ type ExtensionContext,
9
+ hasTrustRequiringProjectResources,
10
+ } from "@earendil-works/pi-coding-agent";
11
+ import { loadSupiConfigSectionForScope, type SupiConfigOptions } from "./config.ts";
12
+
13
+ // ── Public types ───────────────────────────────────────────────────────────
14
+
15
+ /** Model-facing text that PI adds to one registered tool's prompt surface. */
16
+ export interface SuiPiToolPromptSurface {
17
+ description: string;
18
+ promptSnippet: string;
19
+ promptGuidelines: string[];
20
+ }
21
+
22
+ export type ToolPromptSurfaceDiagnosticCode =
23
+ | "invalidPromptSurfaceConfig"
24
+ | "invalidPromptSurfaceField"
25
+ | "projectPromptSurfaceIgnored";
26
+
27
+ export interface ToolPromptSurfaceDiagnostic {
28
+ code: ToolPromptSurfaceDiagnosticCode;
29
+ scope: "global" | "project";
30
+ section: string;
31
+ toolName: string;
32
+ message: string;
33
+ }
34
+
35
+ export interface ResolveToolPromptSurfaceOptions extends SupiConfigOptions {
36
+ section: string;
37
+ toolName: string;
38
+ defaults: SuiPiToolPromptSurface;
39
+ ctx: Pick<ExtensionContext, "cwd" | "isProjectTrusted">;
40
+ }
41
+
42
+ export interface ResolveToolPromptSurfaceResult {
43
+ surface: SuiPiToolPromptSurface;
44
+ diagnostics: ToolPromptSurfaceDiagnostic[];
45
+ }
46
+
47
+ // ── Private types ──────────────────────────────────────────────────────────
48
+
49
+ type PromptSurfaceField = keyof SuiPiToolPromptSurface;
50
+ type PromptSurfaceScope = ToolPromptSurfaceDiagnostic["scope"];
51
+
52
+ const PROMPT_SURFACE_FIELDS = new Set<string>(["description", "promptSnippet", "promptGuidelines"]);
53
+
54
+ const PROMPT_SURFACE_DIAGNOSTICS_KEY = Symbol.for(
55
+ "@mrclrchtr/supi-core/tool-prompt-surface/notified-diagnostics",
56
+ );
57
+
58
+ // ── Resolution ─────────────────────────────────────────────────────────────
59
+
60
+ /** Resolve a tool's model-facing prompt surface from defaults + SuPi config overrides. */
61
+ export function resolveToolPromptSurface(
62
+ options: ResolveToolPromptSurfaceOptions,
63
+ ): ResolveToolPromptSurfaceResult {
64
+ const diagnostics: ToolPromptSurfaceDiagnostic[] = [];
65
+ let surface = clonePromptSurface(options.defaults);
66
+
67
+ const globalSection = loadSupiConfigSectionForScope(options.section, options.ctx.cwd, {
68
+ scope: "global",
69
+ homeDir: options.homeDir,
70
+ });
71
+ surface = applyPromptSurfaceScope(surface, options, "global", globalSection, diagnostics);
72
+
73
+ const projectSection = loadSupiConfigSectionForScope(options.section, options.ctx.cwd, {
74
+ scope: "project",
75
+ homeDir: options.homeDir,
76
+ });
77
+ const projectPromptSurface = getPromptSurfaceConfig(projectSection, options.toolName, {
78
+ diagnostics,
79
+ options,
80
+ scope: "project",
81
+ });
82
+
83
+ if (projectPromptSurface) {
84
+ const hasTrustMarker = hasTrustRequiringProjectResources(options.ctx.cwd);
85
+ const projectTrusted = options.ctx.isProjectTrusted();
86
+ if (hasTrustMarker && projectTrusted) {
87
+ surface = applyPromptSurfaceConfig(
88
+ surface,
89
+ options.defaults,
90
+ projectPromptSurface,
91
+ options,
92
+ "project",
93
+ diagnostics,
94
+ );
95
+ } else {
96
+ diagnostics.push({
97
+ code: "projectPromptSurfaceIgnored",
98
+ scope: "project",
99
+ section: options.section,
100
+ toolName: options.toolName,
101
+ message: hasTrustMarker
102
+ ? `Project prompt-surface overrides for ${options.toolName} were ignored because the project is not trusted in PI.`
103
+ : `Project prompt-surface overrides for ${options.toolName} were ignored because ${options.ctx.cwd}/.pi/supi/config.json is not PI trust-gated. Add .pi/settings.json and trust the project to enable them.`,
104
+ });
105
+ }
106
+ }
107
+
108
+ return { surface, diagnostics };
109
+ }
110
+
111
+ /** Notify prompt-surface diagnostics once per session/tool/diagnostic code. */
112
+ export function notifyToolPromptSurfaceDiagnostics(
113
+ ctx: Pick<ExtensionContext, "sessionManager" | "ui">,
114
+ diagnostics: readonly ToolPromptSurfaceDiagnostic[],
115
+ ): void {
116
+ const globalRecord = globalThis as Record<symbol, Set<string> | undefined>;
117
+ const notified = globalRecord[PROMPT_SURFACE_DIAGNOSTICS_KEY] ?? new Set<string>();
118
+ globalRecord[PROMPT_SURFACE_DIAGNOSTICS_KEY] = notified;
119
+ const sessionId = ctx.sessionManager.getSessionId();
120
+
121
+ for (const diagnostic of diagnostics) {
122
+ const key = `${sessionId}:${diagnostic.section}:${diagnostic.toolName}:${diagnostic.code}`;
123
+ if (notified.has(key)) continue;
124
+ notified.add(key);
125
+ ctx.ui.notify(diagnostic.message, "warning");
126
+ }
127
+ }
128
+
129
+ // ── Scope helpers ──────────────────────────────────────────────────────────
130
+
131
+ // biome-ignore lint/complexity/useMaxParams: resolver dispatch with diagnostics
132
+ function applyPromptSurfaceScope(
133
+ current: SuiPiToolPromptSurface,
134
+ options: ResolveToolPromptSurfaceOptions,
135
+ scope: PromptSurfaceScope,
136
+ sectionConfig: Record<string, unknown> | null,
137
+ diagnostics: ToolPromptSurfaceDiagnostic[],
138
+ ): SuiPiToolPromptSurface {
139
+ const promptSurface = getPromptSurfaceConfig(sectionConfig, options.toolName, {
140
+ diagnostics,
141
+ options,
142
+ scope,
143
+ });
144
+ if (!promptSurface) return current;
145
+ return applyPromptSurfaceConfig(
146
+ current,
147
+ options.defaults,
148
+ promptSurface,
149
+ options,
150
+ scope,
151
+ diagnostics,
152
+ );
153
+ }
154
+
155
+ // biome-ignore lint/complexity/useMaxParams: per-scope config merger with diagnostics
156
+ function applyPromptSurfaceConfig(
157
+ current: SuiPiToolPromptSurface,
158
+ defaults: SuiPiToolPromptSurface,
159
+ config: Record<string, unknown>,
160
+ options: ResolveToolPromptSurfaceOptions,
161
+ scope: PromptSurfaceScope,
162
+ diagnostics: ToolPromptSurfaceDiagnostic[],
163
+ ): SuiPiToolPromptSurface {
164
+ let next = clonePromptSurface(current);
165
+
166
+ for (const field of getResetFields(config.$reset, options, scope, diagnostics)) {
167
+ next = { ...next, [field]: clonePromptSurfaceField(defaults[field]) };
168
+ }
169
+
170
+ const description = getOptionalNonEmptyString(
171
+ config.description,
172
+ "description",
173
+ options,
174
+ scope,
175
+ diagnostics,
176
+ );
177
+ if (description !== undefined) next.description = description;
178
+
179
+ const promptSnippet = getOptionalNonEmptyString(
180
+ config.promptSnippet,
181
+ "promptSnippet",
182
+ options,
183
+ scope,
184
+ diagnostics,
185
+ );
186
+ if (promptSnippet !== undefined) next.promptSnippet = promptSnippet;
187
+
188
+ const promptGuidelines = getOptionalStringArray(
189
+ config.promptGuidelines,
190
+ "promptGuidelines",
191
+ options,
192
+ scope,
193
+ diagnostics,
194
+ );
195
+ if (promptGuidelines !== undefined) next.promptGuidelines = promptGuidelines;
196
+
197
+ const prepend = getOptionalStringArray(
198
+ config.prependPromptGuidelines,
199
+ "prependPromptGuidelines",
200
+ options,
201
+ scope,
202
+ diagnostics,
203
+ );
204
+ if (prepend !== undefined) next.promptGuidelines = [...prepend, ...next.promptGuidelines];
205
+
206
+ const append = getOptionalStringArray(
207
+ config.appendPromptGuidelines,
208
+ "appendPromptGuidelines",
209
+ options,
210
+ scope,
211
+ diagnostics,
212
+ );
213
+ if (append !== undefined) next.promptGuidelines = [...next.promptGuidelines, ...append];
214
+
215
+ return next;
216
+ }
217
+
218
+ // ── Config extraction ──────────────────────────────────────────────────────
219
+
220
+ function getPromptSurfaceConfig(
221
+ sectionConfig: Record<string, unknown> | null,
222
+ toolName: string,
223
+ deps: {
224
+ diagnostics: ToolPromptSurfaceDiagnostic[];
225
+ options: ResolveToolPromptSurfaceOptions;
226
+ scope: PromptSurfaceScope;
227
+ },
228
+ ): Record<string, unknown> | null {
229
+ if (!sectionConfig) return null;
230
+ if (sectionConfig.tools === undefined) return null;
231
+ if (!isRecord(sectionConfig.tools)) {
232
+ pushInvalidConfig(deps, "tools must be an object.");
233
+ return null;
234
+ }
235
+ const toolConfig = sectionConfig.tools[toolName];
236
+ if (toolConfig === undefined) return null;
237
+ if (!isRecord(toolConfig)) {
238
+ pushInvalidConfig(deps, `tools.${toolName} must be an object.`);
239
+ return null;
240
+ }
241
+ if (toolConfig.promptSurface === undefined) return null;
242
+ if (!isRecord(toolConfig.promptSurface)) {
243
+ pushInvalidConfig(deps, `tools.${toolName}.promptSurface must be an object.`);
244
+ return null;
245
+ }
246
+ return toolConfig.promptSurface;
247
+ }
248
+
249
+ // ── Field validation ───────────────────────────────────────────────────────
250
+
251
+ function getResetFields(
252
+ value: unknown,
253
+ options: ResolveToolPromptSurfaceOptions,
254
+ scope: PromptSurfaceScope,
255
+ diagnostics: ToolPromptSurfaceDiagnostic[],
256
+ ): PromptSurfaceField[] {
257
+ if (value === undefined) return [];
258
+ if (!Array.isArray(value)) {
259
+ pushInvalidField(options, scope, diagnostics, "$reset", "must be an array.");
260
+ return [];
261
+ }
262
+ const fields: PromptSurfaceField[] = [];
263
+ for (const item of value) {
264
+ if (typeof item === "string" && PROMPT_SURFACE_FIELDS.has(item)) {
265
+ fields.push(item as PromptSurfaceField);
266
+ } else {
267
+ pushInvalidField(
268
+ options,
269
+ scope,
270
+ diagnostics,
271
+ "$reset",
272
+ `contains unsupported field ${JSON.stringify(item)}.`,
273
+ );
274
+ }
275
+ }
276
+ return fields;
277
+ }
278
+
279
+ // biome-ignore lint/complexity/useMaxParams: validation helper with diagnostics
280
+ function getOptionalNonEmptyString(
281
+ value: unknown,
282
+ field: string,
283
+ options: ResolveToolPromptSurfaceOptions,
284
+ scope: PromptSurfaceScope,
285
+ diagnostics: ToolPromptSurfaceDiagnostic[],
286
+ ): string | undefined {
287
+ if (value === undefined) return undefined;
288
+ if (typeof value === "string" && value.length > 0) return value;
289
+ pushInvalidField(options, scope, diagnostics, field, "must be a non-empty string.");
290
+ return undefined;
291
+ }
292
+
293
+ // biome-ignore lint/complexity/useMaxParams: validation helper with diagnostics
294
+ function getOptionalStringArray(
295
+ value: unknown,
296
+ field: string,
297
+ options: ResolveToolPromptSurfaceOptions,
298
+ scope: PromptSurfaceScope,
299
+ diagnostics: ToolPromptSurfaceDiagnostic[],
300
+ ): string[] | undefined {
301
+ if (value === undefined) return undefined;
302
+ if (Array.isArray(value) && value.every((item) => typeof item === "string")) {
303
+ return [...value];
304
+ }
305
+ pushInvalidField(options, scope, diagnostics, field, "must be an array of strings.");
306
+ return undefined;
307
+ }
308
+
309
+ // ── Diagnostics ────────────────────────────────────────────────────────────
310
+
311
+ function pushInvalidConfig(
312
+ deps: {
313
+ diagnostics: ToolPromptSurfaceDiagnostic[];
314
+ options: ResolveToolPromptSurfaceOptions;
315
+ scope: PromptSurfaceScope;
316
+ },
317
+ detail: string,
318
+ ): void {
319
+ deps.diagnostics.push({
320
+ // biome-ignore lint/security/noSecrets: false positive on string constant
321
+ code: "invalidPromptSurfaceConfig",
322
+ scope: deps.scope,
323
+ section: deps.options.section,
324
+ toolName: deps.options.toolName,
325
+ message: `Invalid prompt-surface config for ${deps.options.section}.${deps.options.toolName}: ${detail}`,
326
+ });
327
+ }
328
+
329
+ // biome-ignore lint/complexity/useMaxParams: diagnostics utility with many fields
330
+ function pushInvalidField(
331
+ options: ResolveToolPromptSurfaceOptions,
332
+ scope: PromptSurfaceScope,
333
+ diagnostics: ToolPromptSurfaceDiagnostic[],
334
+ field: string,
335
+ detail: string,
336
+ ): void {
337
+ diagnostics.push({
338
+ // biome-ignore lint/security/noSecrets: false positive on string constant
339
+ code: "invalidPromptSurfaceField",
340
+ scope,
341
+ section: options.section,
342
+ toolName: options.toolName,
343
+ message: `Invalid prompt-surface field ${field} for ${options.section}.${options.toolName}: ${detail}`,
344
+ });
345
+ }
346
+
347
+ // ── Cloning ────────────────────────────────────────────────────────────────
348
+
349
+ function clonePromptSurface(surface: SuiPiToolPromptSurface): SuiPiToolPromptSurface {
350
+ return {
351
+ description: surface.description,
352
+ promptSnippet: surface.promptSnippet,
353
+ promptGuidelines: [...surface.promptGuidelines],
354
+ };
355
+ }
356
+
357
+ function clonePromptSurfaceField<T extends string | string[]>(value: T): T {
358
+ return (Array.isArray(value) ? [...value] : value) as T;
359
+ }
360
+
361
+ function isRecord(value: unknown): value is Record<string, unknown> {
362
+ return typeof value === "object" && value !== null && !Array.isArray(value);
363
+ }
@@ -0,0 +1,12 @@
1
+ // supi-core config domain — config loading.
2
+ export type { SupiConfigLocation, SupiConfigOptions } from "./config/config.ts";
3
+ export {
4
+ getSupiConfigPath,
5
+ loadSupiConfig,
6
+ loadSupiConfigForScope,
7
+ loadSupiConfigSectionForScope,
8
+ readJsonFile,
9
+ removeSupiConfigKey,
10
+ replaceSupiConfigSection,
11
+ writeSupiConfig,
12
+ } from "./config/config.ts";
@@ -0,0 +1,36 @@
1
+ // Context provider registry for SuPi extensions.
2
+ //
3
+ // Extensions declare context data providers via `registerContextProvider()` during their
4
+ // factory function. The `/supi-context` command reads them via `getRegisteredContextProviders()`.
5
+
6
+ import { createRegistry } from "../registry-utils.ts";
7
+
8
+ export interface ContextProvider {
9
+ /** Unique identifier — e.g. "lsp" */
10
+ id: string;
11
+ /** Human-readable label shown in the report */
12
+ label: string;
13
+ /** Return structured data for display, or null when unavailable. */
14
+ getData: () => Record<string, string | number> | null;
15
+ }
16
+
17
+ const registry = createRegistry<ContextProvider>("context-provider-registry");
18
+
19
+ /**
20
+ * Register a context data provider for an extension.
21
+ * Call during the extension factory function (not async handlers).
22
+ * Duplicate ids replace the previous registration.
23
+ */
24
+ export function registerContextProvider(provider: ContextProvider): void {
25
+ registry.register(provider.id, provider);
26
+ }
27
+
28
+ /** Get all registered context providers in registration order. */
29
+ export function getRegisteredContextProviders(): ContextProvider[] {
30
+ return registry.getAll();
31
+ }
32
+
33
+ /** Clear the registry — used by tests. */
34
+ export function clearRegisteredContextProviders(): void {
35
+ registry.clear();
36
+ }
@@ -0,0 +1,31 @@
1
+ // XML context tag wrapping for SuPi extensions.
2
+ //
3
+ // Produces machine-parseable <extension-context> blocks that:
4
+ // - Are LLM-friendly (structured XML)
5
+ // - Carry metadata via attributes (source, file, turn, etc.)
6
+ // - Can be reconstructed from session history via regex
7
+
8
+ /**
9
+ * Wrap content in an `<extension-context>` XML tag.
10
+ *
11
+ * @param source - Extension identifier (e.g. "supi-claude-md", "supi-lsp")
12
+ * @param content - The text content to wrap
13
+ * @param attrs - Optional additional attributes (rendered as key="value")
14
+ * @returns Formatted XML string
15
+ */
16
+ export function wrapExtensionContext(
17
+ source: string,
18
+ content: string,
19
+ attrs?: Record<string, string | number>,
20
+ ): string {
21
+ const attrParts = [`source="${source}"`];
22
+
23
+ if (attrs) {
24
+ for (const [key, value] of Object.entries(attrs)) {
25
+ attrParts.push(`${key}="${String(value)}"`);
26
+ }
27
+ }
28
+
29
+ const openTag = `<extension-context ${attrParts.join(" ")}>`;
30
+ return `${openTag}\n${content}\n</extension-context>`;
31
+ }
@@ -0,0 +1,8 @@
1
+ // supi-core context domain — context providers and XML tags.
2
+ export type { ContextProvider } from "./context/context-provider-registry.ts";
3
+ export {
4
+ clearRegisteredContextProviders,
5
+ getRegisteredContextProviders,
6
+ registerContextProvider,
7
+ } from "./context/context-provider-registry.ts";
8
+ export { wrapExtensionContext } from "./context/context-tag.ts";