@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,421 @@
1
+ // biome-ignore-all lint/style/noExcessiveLinesPerFile: raw parser and query ownership stays in one Worker-only module
2
+ // Tree-sitter runtime — parser management, parse, and query services.
3
+
4
+ import * as path from "node:path";
5
+ import { resolveToolPath } from "@mrclrchtr/supi-core/path";
6
+ import type { Language, Parser, Tree } from "web-tree-sitter";
7
+ import { detectGrammar, resolveGrammarWasmPath } from "../language.ts";
8
+ import {
9
+ finishStructuralTiming,
10
+ type ParseTimingPhase,
11
+ type QueryTimingPhase,
12
+ type StructuralTimingEvent,
13
+ startStructuralTiming,
14
+ } from "../session/structural-timing.ts";
15
+ import type { GrammarId, QueryCapture, TreeSitterResult } from "../types.ts";
16
+ import {
17
+ ParsedFileReadError,
18
+ ParsedFileStore,
19
+ type StructuralCacheObservation,
20
+ } from "./parsed-file-store.ts";
21
+ import {
22
+ isStructuralRequestInterrupted,
23
+ isStructuralRequestInterruption,
24
+ type StructuralRequestControl,
25
+ throwIfStructuralRequestInterrupted,
26
+ } from "./request-control.ts";
27
+ import { resetInterruptedParser } from "./runtime-parser-helpers.ts";
28
+ import {
29
+ collectQueryCaptures,
30
+ formatRuntimeError,
31
+ validateQueryString,
32
+ } from "./runtime-query-helpers.ts";
33
+
34
+ interface ParserEntry {
35
+ parser: Parser;
36
+ language: Language;
37
+ }
38
+
39
+ const QUERY_PARSED_FILE = Symbol("query-parsed-file");
40
+
41
+ interface ParsedQueryInput {
42
+ readonly grammarId: GrammarId;
43
+ readonly tree: Tree;
44
+ readonly source: string;
45
+ readonly queryString: string;
46
+ readonly control?: StructuralRequestControl;
47
+ }
48
+
49
+ /**
50
+ * Session-scoped Tree-sitter runtime.
51
+ *
52
+ * A runtime owns the expensive `web-tree-sitter` initialization and parser
53
+ * instances for one pi working directory. Call `dispose()` when the session is
54
+ * torn down so WASM parser resources are released.
55
+ */
56
+ export class TreeSitterRuntime {
57
+ private parserModule: typeof import("web-tree-sitter") | undefined;
58
+ private parsers = new Map<GrammarId, ParserEntry>();
59
+ private parsedFiles = new ParsedFileStore();
60
+ private parserPromises = new Map<GrammarId, Promise<ParserEntry>>();
61
+ private initPromise: Promise<typeof import("web-tree-sitter")> | undefined;
62
+ private initializing = false;
63
+ private disposed = false;
64
+
65
+ /** Create a runtime that resolves relative file paths from `cwd`. */
66
+ constructor(
67
+ private cwd: string,
68
+ private onTiming?: (event: StructuralTimingEvent) => void,
69
+ ) {}
70
+
71
+ /** Ensure web-tree-sitter Parser is initialized. */
72
+ private async ensureParserInit(): Promise<typeof import("web-tree-sitter")> {
73
+ this.assertActive();
74
+ if (this.parserModule) return this.parserModule;
75
+ if (this.initializing && this.initPromise) return this.initPromise;
76
+
77
+ this.initializing = true;
78
+ this.initPromise = (async () => {
79
+ const mod = await import("web-tree-sitter");
80
+ await mod.Parser.init();
81
+ this.assertActive();
82
+ this.parserModule = mod;
83
+ return mod;
84
+ })();
85
+
86
+ try {
87
+ return await this.initPromise;
88
+ } catch (err: unknown) {
89
+ // Allow retry on next call
90
+ this.initPromise = undefined;
91
+ this.initializing = false;
92
+ throw new Error("Failed to initialize web-tree-sitter", { cause: err });
93
+ }
94
+ }
95
+
96
+ /**
97
+ * Get or create a parser entry for a grammar.
98
+ *
99
+ * Concurrent first-use calls for the same grammar share one initialization
100
+ * promise. Failed initialization is not cached, so a later request can retry.
101
+ */
102
+ async ensureGrammarParser(grammarId: GrammarId): Promise<ParserEntry> {
103
+ this.assertActive();
104
+ const existing = this.parsers.get(grammarId);
105
+ if (existing) return existing;
106
+
107
+ const pending = this.parserPromises.get(grammarId);
108
+ if (pending) return pending;
109
+
110
+ const promise = this.createGrammarParser(grammarId);
111
+ this.parserPromises.set(grammarId, promise);
112
+
113
+ try {
114
+ return await promise;
115
+ } finally {
116
+ if (this.parserPromises.get(grammarId) === promise) {
117
+ this.parserPromises.delete(grammarId);
118
+ }
119
+ }
120
+ }
121
+
122
+ private async createGrammarParser(grammarId: GrammarId): Promise<ParserEntry> {
123
+ const mod = await this.ensureParserInit();
124
+ const wasmPath = resolveGrammarWasmPath(grammarId);
125
+
126
+ const language = await mod.Language.load(wasmPath);
127
+ const parser = new mod.Parser();
128
+ try {
129
+ parser.setLanguage(language);
130
+ } catch (err) {
131
+ deleteWasmResource(parser);
132
+ throw err;
133
+ }
134
+
135
+ if (this.disposed) {
136
+ deleteWasmResource(parser);
137
+ throw new Error("Tree-sitter runtime has been disposed");
138
+ }
139
+
140
+ const entry = { parser, language };
141
+ this.parsers.set(grammarId, entry);
142
+ return entry;
143
+ }
144
+
145
+ /**
146
+ * Read and parse a file.
147
+ *
148
+ * The returned tree is an owned shallow copy. The caller must delete it.
149
+ * Canonical cached trees never leave the parsed-file store.
150
+ */
151
+ async parseFile(
152
+ filePath: string,
153
+ control?: StructuralRequestControl,
154
+ ): Promise<
155
+ TreeSitterResult<{
156
+ tree: Tree;
157
+ source: string;
158
+ resolvedPath: string;
159
+ grammarId: GrammarId;
160
+ }>
161
+ > {
162
+ const resolvedPath = resolveToolPath(this.cwd, filePath);
163
+ const grammarId = detectGrammar(filePath);
164
+ if (!grammarId) {
165
+ return {
166
+ kind: "unsupported-language",
167
+ file: filePath,
168
+ message: `No Tree-sitter grammar configured for ${path.extname(filePath) || "this file type"}`,
169
+ };
170
+ }
171
+
172
+ const timer = startStructuralTiming(control?.operationId, this.onTiming);
173
+ const parserState = this.parsers.has(grammarId)
174
+ ? "reused"
175
+ : this.parserPromises.has(grammarId)
176
+ ? "initializing"
177
+ : "cold";
178
+ let finalPhase: ParseTimingPhase = "file-read";
179
+
180
+ try {
181
+ const parsed = await this.parsedFiles.acquireParsedFile({
182
+ resolvedPath,
183
+ grammarId,
184
+ control,
185
+ onPhase: (phase) => {
186
+ timer.mark(phase);
187
+ finalPhase = phase === "file-read" ? "content-hash" : "cache-lookup";
188
+ },
189
+ parse: async (source) => {
190
+ finalPhase = "parser-setup";
191
+ let entry = await this.ensureGrammarParser(grammarId);
192
+ this.assertActive();
193
+ throwIfStructuralRequestInterrupted(control);
194
+ if (this.parsers.get(grammarId) !== entry) {
195
+ entry = await this.ensureGrammarParser(grammarId);
196
+ this.assertActive();
197
+ throwIfStructuralRequestInterrupted(control);
198
+ }
199
+ timer.mark("parser-setup");
200
+ finalPhase = "parse";
201
+ const tree = entry.parser.parse(source, undefined, {
202
+ progressCallback: () => isStructuralRequestInterrupted(control),
203
+ });
204
+ if (!tree) {
205
+ resetInterruptedParser(this.parsers, grammarId, entry);
206
+ throwIfStructuralRequestInterrupted(control);
207
+ throw new Error("Tree-sitter parser did not produce a tree");
208
+ }
209
+ try {
210
+ throwIfStructuralRequestInterrupted(control);
211
+ return tree;
212
+ } catch (error) {
213
+ tree.delete();
214
+ throw error;
215
+ }
216
+ },
217
+ });
218
+ finishStructuralTiming(timer, {
219
+ operation: "parse",
220
+ grammar: grammarId,
221
+ parserState,
222
+ outcome: "completed",
223
+ cache: parsed.cache,
224
+ finalPhase,
225
+ });
226
+ return {
227
+ kind: "success",
228
+ data: {
229
+ tree: parsed.tree,
230
+ source: parsed.source,
231
+ resolvedPath: parsed.resolvedPath,
232
+ grammarId: parsed.grammarId,
233
+ },
234
+ };
235
+ } catch (err: unknown) {
236
+ if (isStructuralRequestInterruption(err, control)) {
237
+ finishStructuralTiming(timer, {
238
+ operation: "parse",
239
+ grammar: grammarId,
240
+ parserState,
241
+ outcome: control?.signal?.aborted ? "cancelled" : "timeout",
242
+ finalPhase,
243
+ });
244
+ throw err;
245
+ }
246
+ if (err instanceof ParsedFileReadError) {
247
+ finishStructuralTiming(timer, {
248
+ operation: "parse",
249
+ grammar: grammarId,
250
+ parserState,
251
+ outcome: "file-access-error",
252
+ finalPhase: "file-read",
253
+ });
254
+ return { kind: "file-access-error", file: filePath, message: err.message };
255
+ }
256
+ finishStructuralTiming(timer, {
257
+ operation: "parse",
258
+ grammar: grammarId,
259
+ parserState,
260
+ outcome: "runtime-error",
261
+ finalPhase,
262
+ });
263
+ return {
264
+ kind: "runtime-error",
265
+ message: formatRuntimeError(err, "Parser initialization failed"),
266
+ };
267
+ }
268
+ }
269
+
270
+ /** Execute a Tree-sitter query against a file. */
271
+ async queryFile(
272
+ filePath: string,
273
+ queryString: string,
274
+ control?: StructuralRequestControl,
275
+ ): Promise<TreeSitterResult<QueryCapture[]>> {
276
+ const validation = validateQueryString(queryString);
277
+ if (validation) return validation;
278
+
279
+ const parseResult = await this.parseFile(filePath, control);
280
+ if (parseResult.kind !== "success") return parseResult;
281
+
282
+ const { grammarId, tree, source } = parseResult.data;
283
+ try {
284
+ return await this[QUERY_PARSED_FILE]({ grammarId, tree, source, queryString, control });
285
+ } finally {
286
+ tree.delete();
287
+ }
288
+ }
289
+
290
+ /** Execute a query against one caller-owned parsed tree without parsing again. */
291
+ async [QUERY_PARSED_FILE](input: ParsedQueryInput): Promise<TreeSitterResult<QueryCapture[]>> {
292
+ const { grammarId, tree, source, queryString, control } = input;
293
+ const validation = validateQueryString(queryString);
294
+ if (validation) return validation;
295
+
296
+ const timer = startStructuralTiming(control?.operationId, this.onTiming);
297
+ let phase: QueryTimingPhase = "query-compilation";
298
+ let compilationStarted = false;
299
+ let cache: StructuralCacheObservation = {
300
+ state: "miss",
301
+ retained: false,
302
+ evictionCount: 0,
303
+ };
304
+
305
+ try {
306
+ let entry = await this.ensureGrammarParser(grammarId);
307
+ this.assertActive();
308
+ throwIfStructuralRequestInterrupted(control);
309
+ if (this.parsers.get(grammarId) !== entry) {
310
+ entry = await this.ensureGrammarParser(grammarId);
311
+ this.assertActive();
312
+ throwIfStructuralRequestInterrupted(control);
313
+ }
314
+ const mod = await this.ensureParserInit();
315
+ this.assertActive();
316
+ throwIfStructuralRequestInterrupted(control);
317
+ compilationStarted = true;
318
+ const execution = this.parsedFiles.withQuery(grammarId, queryString, {
319
+ control,
320
+ compile: () => {
321
+ const query = new mod.Query(entry.language, queryString);
322
+ timer.mark("query-compilation");
323
+ phase = "query-execution";
324
+ return query;
325
+ },
326
+ execute: (query, observation) => {
327
+ cache = observation;
328
+ if (observation.state === "hit") {
329
+ timer.mark("query-cache");
330
+ phase = "query-execution";
331
+ }
332
+ const matches = query.matches(tree.rootNode, {
333
+ progressCallback: () => isStructuralRequestInterrupted(control),
334
+ });
335
+ throwIfStructuralRequestInterrupted(control);
336
+ return collectQueryCaptures(matches, source);
337
+ },
338
+ });
339
+ finishStructuralTiming(timer, {
340
+ operation: "query",
341
+ grammar: grammarId,
342
+ outcome: "completed",
343
+ captureCount: execution.data.length,
344
+ cache: execution.cache,
345
+ finalPhase: "query-execution",
346
+ });
347
+ return { kind: "success", data: execution.data };
348
+ } catch (err: unknown) {
349
+ if (isStructuralRequestInterruption(err, control)) {
350
+ finishStructuralTiming(timer, {
351
+ operation: "query",
352
+ grammar: grammarId,
353
+ outcome: control?.signal?.aborted ? "cancelled" : "timeout",
354
+ captureCount: 0,
355
+ cache,
356
+ finalPhase: phase,
357
+ });
358
+ throw err;
359
+ }
360
+ const validationError = compilationStarted && phase === "query-compilation";
361
+ finishStructuralTiming(timer, {
362
+ operation: "query",
363
+ grammar: grammarId,
364
+ outcome: validationError ? "validation-error" : "runtime-error",
365
+ captureCount: 0,
366
+ cache,
367
+ finalPhase: phase,
368
+ });
369
+ return validationError
370
+ ? { kind: "validation-error", message: `Invalid query: ${formatRuntimeError(err)}` }
371
+ : { kind: "runtime-error", message: formatRuntimeError(err, "Query execution failed") };
372
+ }
373
+ }
374
+
375
+ /** Get the grammar ID for a file, or undefined if unsupported. */
376
+ getGrammarId(filePath: string): GrammarId | undefined {
377
+ return detectGrammar(filePath);
378
+ }
379
+
380
+ /** Resolve a file path from cwd. */
381
+ resolvePath(filePath: string): string {
382
+ return resolveToolPath(this.cwd, filePath);
383
+ }
384
+
385
+ /** Dispose all held tree, query, and parser resources. */
386
+ dispose(): void {
387
+ if (this.disposed) return;
388
+ this.disposed = true;
389
+ this.parsedFiles.dispose();
390
+ for (const [, entry] of this.parsers) {
391
+ deleteWasmResource(entry.parser);
392
+ }
393
+ this.parsers.clear();
394
+ this.parserPromises.clear();
395
+ this.parserModule = undefined;
396
+ this.initPromise = undefined;
397
+ this.initializing = false;
398
+ }
399
+
400
+ private assertActive(): void {
401
+ if (this.disposed) {
402
+ throw new Error("Tree-sitter runtime has been disposed");
403
+ }
404
+ }
405
+ }
406
+
407
+ /** Package-internal query execution for consumers that already own a parsed tree. */
408
+ export function queryParsedFile(
409
+ runtime: TreeSitterRuntime,
410
+ input: ParsedQueryInput,
411
+ ): Promise<TreeSitterResult<QueryCapture[]>> {
412
+ return runtime[QUERY_PARSED_FILE](input);
413
+ }
414
+
415
+ function deleteWasmResource(resource: { delete(): void }): void {
416
+ try {
417
+ resource.delete();
418
+ } catch {
419
+ // Continue cleanup so one failed release does not retain other resources.
420
+ }
421
+ }
@@ -0,0 +1,116 @@
1
+ import { detectGrammar } from "../language.ts";
2
+ import { supportsGrammarOperation } from "../operation-support.ts";
3
+ import type { StructuralWorkerOperation } from "../session/structural-worker-protocol.ts";
4
+ import {
5
+ extractCallSites,
6
+ extractExports,
7
+ extractImports,
8
+ extractOutline,
9
+ lookupCalleesAt,
10
+ lookupNodeAt,
11
+ } from "../tool/structure.ts";
12
+ import type { TreeSitterResult } from "../types.ts";
13
+ import {
14
+ type StructuralRequestControl,
15
+ throwIfStructuralRequestInterrupted,
16
+ } from "./request-control.ts";
17
+ import type { TreeSitterRuntime } from "./runtime.ts";
18
+
19
+ /** Execute parser-backed operations in the Structural Worker. */
20
+ export class StructuralWorkerService {
21
+ constructor(private readonly runtime: TreeSitterRuntime) {}
22
+
23
+ async execute(
24
+ input: StructuralWorkerOperation,
25
+ control: StructuralRequestControl,
26
+ ): Promise<TreeSitterResult<unknown>> {
27
+ throwIfStructuralRequestInterrupted(control);
28
+ switch (input.operation) {
29
+ case "canParse":
30
+ return this.#canParse(input.file, control);
31
+ case "query":
32
+ return this.runtime.queryFile(input.file, input.query, control);
33
+ case "outline":
34
+ return this.#outline(input.file, control);
35
+ case "imports":
36
+ return this.#imports(input.file, control);
37
+ case "exports":
38
+ return this.#exports(input.file, control);
39
+ case "nodeAt":
40
+ return lookupNodeAt(this.runtime, input.file, input.line, input.character, control);
41
+ case "calleesAt":
42
+ return lookupCalleesAt(
43
+ this.runtime,
44
+ input.file,
45
+ input.line,
46
+ input.character,
47
+ input.depth,
48
+ control,
49
+ );
50
+ case "callSites":
51
+ return extractCallSites(this.runtime, input.file, control);
52
+ }
53
+ }
54
+
55
+ async #canParse(
56
+ file: string,
57
+ control: StructuralRequestControl,
58
+ ): Promise<TreeSitterResult<{ file: string; language: string }>> {
59
+ const result = await this.runtime.parseFile(file, control);
60
+ if (result.kind !== "success") return result;
61
+ const { resolvedPath, grammarId, tree } = result.data;
62
+ try {
63
+ return { kind: "success", data: { file: resolvedPath, language: grammarId } };
64
+ } finally {
65
+ tree.delete();
66
+ }
67
+ }
68
+
69
+ async #outline(
70
+ file: string,
71
+ control: StructuralRequestControl,
72
+ ): Promise<TreeSitterResult<unknown>> {
73
+ const unsupported = unsupportedOperation(file, "outline");
74
+ if (unsupported) return unsupported;
75
+ const result = await this.runtime.parseFile(file, control);
76
+ if (result.kind !== "success") return result;
77
+ try {
78
+ throwIfStructuralRequestInterrupted(control);
79
+ return {
80
+ kind: "success",
81
+ data: extractOutline(result.data.tree.rootNode, result.data.source),
82
+ };
83
+ } finally {
84
+ result.data.tree.delete();
85
+ }
86
+ }
87
+
88
+ async #imports(
89
+ file: string,
90
+ control: StructuralRequestControl,
91
+ ): Promise<TreeSitterResult<unknown>> {
92
+ const unsupported = unsupportedOperation(file, "imports");
93
+ return unsupported ?? extractImports(this.runtime, file, control);
94
+ }
95
+
96
+ async #exports(
97
+ file: string,
98
+ control: StructuralRequestControl,
99
+ ): Promise<TreeSitterResult<unknown>> {
100
+ const unsupported = unsupportedOperation(file, "exports");
101
+ return unsupported ?? extractExports(this.runtime, file, control);
102
+ }
103
+ }
104
+
105
+ function unsupportedOperation(
106
+ file: string,
107
+ operation: "outline" | "imports" | "exports",
108
+ ): TreeSitterResult<never> | null {
109
+ const grammarId = detectGrammar(file);
110
+ if (!grammarId || supportsGrammarOperation(grammarId, operation)) return null;
111
+ return {
112
+ kind: "unsupported-language",
113
+ file,
114
+ message: `${operation} is not supported for ${grammarId} files`,
115
+ };
116
+ }