@mrclrchtr/supi-code-intelligence 2.0.6 → 2.2.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 (169) hide show
  1. package/README.md +88 -4
  2. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/README.md +32 -23
  3. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/package.json +2 -1
  4. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/config/config.ts +22 -8
  5. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/config/prompt-surface.ts +357 -0
  6. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -3
  7. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +0 -5
  8. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/prompt-surface.ts +4 -0
  9. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/scoped-settings-list.ts +372 -0
  10. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-action-menu.ts +101 -0
  11. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-command.ts +1 -1
  12. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +55 -27
  13. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts +464 -0
  14. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-submenus.ts +124 -0
  15. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-ui.ts +72 -285
  16. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings-ui.ts +2 -5
  17. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings.ts +27 -5
  18. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/tool-framework.ts +10 -0
  19. package/node_modules/@mrclrchtr/supi-code-runtime/package.json +2 -2
  20. package/node_modules/@mrclrchtr/supi-core/README.md +32 -23
  21. package/node_modules/@mrclrchtr/supi-core/package.json +2 -1
  22. package/node_modules/@mrclrchtr/supi-core/src/config/config.ts +22 -8
  23. package/node_modules/@mrclrchtr/supi-core/src/config/prompt-surface.ts +357 -0
  24. package/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -3
  25. package/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +0 -5
  26. package/node_modules/@mrclrchtr/supi-core/src/prompt-surface.ts +4 -0
  27. package/node_modules/@mrclrchtr/supi-core/src/settings/scoped-settings-list.ts +372 -0
  28. package/node_modules/@mrclrchtr/supi-core/src/settings/settings-action-menu.ts +101 -0
  29. package/node_modules/@mrclrchtr/supi-core/src/settings/settings-command.ts +1 -1
  30. package/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +55 -27
  31. package/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts +464 -0
  32. package/node_modules/@mrclrchtr/supi-core/src/settings/settings-submenus.ts +124 -0
  33. package/node_modules/@mrclrchtr/supi-core/src/settings/settings-ui.ts +72 -285
  34. package/node_modules/@mrclrchtr/supi-core/src/settings-ui.ts +2 -5
  35. package/node_modules/@mrclrchtr/supi-core/src/settings.ts +27 -5
  36. package/node_modules/@mrclrchtr/supi-core/src/tool-framework.ts +10 -0
  37. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/README.md +32 -23
  38. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/package.json +2 -1
  39. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/config/config.ts +22 -8
  40. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/config/prompt-surface.ts +357 -0
  41. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -3
  42. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +0 -5
  43. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/prompt-surface.ts +4 -0
  44. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/scoped-settings-list.ts +372 -0
  45. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-action-menu.ts +101 -0
  46. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-command.ts +1 -1
  47. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +55 -27
  48. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts +464 -0
  49. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-submenus.ts +124 -0
  50. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-ui.ts +72 -285
  51. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings-ui.ts +2 -5
  52. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings.ts +27 -5
  53. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/tool-framework.ts +10 -0
  54. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json +2 -2
  55. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/README.md +32 -23
  56. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json +2 -1
  57. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/config/config.ts +22 -8
  58. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/config/prompt-surface.ts +357 -0
  59. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -3
  60. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +0 -5
  61. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/prompt-surface.ts +4 -0
  62. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings/scoped-settings-list.ts +372 -0
  63. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings/settings-action-menu.ts +101 -0
  64. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings/settings-command.ts +1 -1
  65. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +55 -27
  66. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts +464 -0
  67. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings/settings-submenus.ts +124 -0
  68. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings/settings-ui.ts +72 -285
  69. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings-ui.ts +2 -5
  70. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings.ts +27 -5
  71. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/tool-framework.ts +10 -0
  72. package/node_modules/@mrclrchtr/supi-lsp/package.json +3 -3
  73. package/node_modules/@mrclrchtr/supi-lsp/src/config/lsp-settings.ts +1 -1
  74. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/README.md +32 -23
  75. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/package.json +2 -1
  76. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/config/config.ts +22 -8
  77. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/config/prompt-surface.ts +357 -0
  78. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -3
  79. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +0 -5
  80. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/prompt-surface.ts +4 -0
  81. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/scoped-settings-list.ts +372 -0
  82. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-action-menu.ts +101 -0
  83. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-command.ts +1 -1
  84. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +55 -27
  85. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts +464 -0
  86. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-submenus.ts +124 -0
  87. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-ui.ts +72 -285
  88. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings-ui.ts +2 -5
  89. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings.ts +27 -5
  90. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/tool-framework.ts +10 -0
  91. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json +2 -2
  92. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/README.md +32 -23
  93. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json +2 -1
  94. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/config/config.ts +22 -8
  95. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/config/prompt-surface.ts +357 -0
  96. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/config.ts +2 -3
  97. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts +0 -5
  98. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/prompt-surface.ts +4 -0
  99. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/settings/scoped-settings-list.ts +372 -0
  100. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/settings/settings-action-menu.ts +101 -0
  101. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/settings/settings-command.ts +1 -1
  102. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/settings/settings-registry.ts +55 -27
  103. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts +464 -0
  104. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/settings/settings-submenus.ts +124 -0
  105. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/settings/settings-ui.ts +72 -285
  106. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/settings-ui.ts +2 -5
  107. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/settings.ts +27 -5
  108. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/tool-framework.ts +10 -0
  109. package/node_modules/@mrclrchtr/supi-tree-sitter/package.json +3 -3
  110. package/package.json +5 -5
  111. package/src/analysis/evidence.ts +13 -0
  112. package/src/analysis/instruction-files.ts +194 -0
  113. package/src/analysis/search/pattern.ts +24 -13
  114. package/src/analysis/search/ripgrep.ts +92 -7
  115. package/src/app/app.ts +6 -1
  116. package/src/config.ts +42 -0
  117. package/src/extension.ts +9 -1
  118. package/src/session/capability-adapter.ts +218 -0
  119. package/src/session/session.ts +106 -1
  120. package/src/session/target-workflow.ts +430 -0
  121. package/src/substrate/lsp/diagnostic-injection.ts +0 -15
  122. package/src/substrate/lsp/settings.ts +101 -175
  123. package/src/tool/find/execute.ts +23 -10
  124. package/src/tool/find/orchestrate.ts +67 -54
  125. package/src/tool/find/semantic-search.ts +30 -16
  126. package/src/tool/graph/collect-relation.ts +2 -1
  127. package/src/tool/graph/execute.ts +40 -12
  128. package/src/tool/graph/markdown-base.ts +5 -37
  129. package/src/tool/graph/orchestrate.ts +9 -35
  130. package/src/tool/graph/tui.ts +2 -0
  131. package/src/tool/guidance.ts +27 -38
  132. package/src/tool/health/markdown.ts +12 -70
  133. package/src/tool/health/orchestrate.ts +5 -13
  134. package/src/tool/impact/analysis.ts +0 -27
  135. package/src/tool/impact/change-set-impact.ts +3 -2
  136. package/src/tool/impact/execute.ts +27 -0
  137. package/src/tool/impact/file-level-impact.ts +3 -2
  138. package/src/tool/impact/result.ts +2 -21
  139. package/src/tool/impact/single-impact.ts +3 -2
  140. package/src/tool/infra/error-results.ts +18 -196
  141. package/src/tool/infra/pipeline.ts +24 -1
  142. package/src/tool/inspect/markdown.ts +4 -41
  143. package/src/tool/inspect/orchestrate.ts +27 -28
  144. package/src/tool/orientation/mode.ts +53 -2
  145. package/src/tool/orientation/orchestrate.ts +5 -8
  146. package/src/tool/orientation/precise-target.ts +65 -69
  147. package/src/tool/refactor-apply/orchestrate.ts +2 -7
  148. package/src/tool/refactor-plan/orchestrate.ts +31 -39
  149. package/src/tool/resolve/markdown.ts +5 -6
  150. package/src/tool/resolve/orchestrate.ts +7 -103
  151. package/src/tool/result/errors.ts +199 -0
  152. package/src/tool/result/find.ts +29 -0
  153. package/src/tool/result/graph.ts +93 -0
  154. package/src/tool/result/health.ts +94 -0
  155. package/src/tool/result/impact.ts +50 -0
  156. package/src/tool/result/inspect.ts +60 -0
  157. package/src/tool/result/orientation.ts +30 -0
  158. package/src/tool/result/refactor.ts +35 -0
  159. package/src/tool/result/resolve.ts +114 -0
  160. package/src/tool/result/types.ts +191 -0
  161. package/src/tool/schemas.ts +39 -28
  162. package/src/types/details.ts +17 -185
  163. package/src/ui/tui/common.ts +45 -1
  164. package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/config/config-settings.ts +0 -188
  165. package/node_modules/@mrclrchtr/supi-core/src/config/config-settings.ts +0 -188
  166. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/config/config-settings.ts +0 -188
  167. package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/config/config-settings.ts +0 -188
  168. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/config/config-settings.ts +0 -188
  169. package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/config/config-settings.ts +0 -188
package/README.md CHANGED
@@ -24,11 +24,95 @@ pi install ./packages/supi-code-intelligence
24
24
 
25
25
  ![Code brief in action](https://raw.githubusercontent.com/mrclrchtr/supi/main/screenshots/supi-code-intelligence.png)
26
26
 
27
+ ## Quickstart
28
+
29
+ ### 1. Install the extension
30
+
31
+ ```bash
32
+ pi install npm:@mrclrchtr/supi-code-intelligence
33
+ ```
34
+
35
+ ### 2. Install the language server for your project
36
+
37
+ The extension auto-detects your project's language and tries to start the matching LSP server automatically. **You must install the server binary yourself** and ensure it is on your `PATH`.
38
+
39
+ | Language | Binary to install |
40
+ |---|---|
41
+ | TypeScript / JavaScript | `typescript-language-server` (npm) |
42
+ | Python | `pyright-langserver` (npm) |
43
+ | Rust | `rust-analyzer` (rustup) |
44
+ | Go | `gopls` (go install) |
45
+ | C / C++ | `clangd` (system package manager) |
46
+ | Bash | `bash-language-server` (npm) |
47
+ | HTML | `vscode-html-language-server` (npm) |
48
+ | SQL | `sql-language-server` (npm) |
49
+ | Ruby | `ruby-lsp` (gem) |
50
+ | Java | `jdtls` (system package manager) |
51
+ | Kotlin | `kotlin-lsp` (Kotlin tooling) |
52
+ | R | `R` with `languageserver` package installed |
53
+
54
+ If a server binary is missing, the extension emits a warning at session start telling you exactly which command was not found and which file types are affected.
55
+
56
+ ### 3. Verify the stack is healthy
57
+
58
+ You can check status interactively with the overlay command:
59
+
60
+ ```
61
+ /supi-ci-status
62
+ ```
63
+
64
+ This shows which language servers are active, which are missing, and any degraded coverage warnings in a TUI overlay.
65
+
66
+ Alternatively, ask the pi agent to check for you:
67
+
68
+ > *"Check the status of code intelligence servers."*
69
+
70
+ The agent will run `code_health(include=["servers"])` and report back which servers are active. Semantic tools like `code_resolve` and `code_graph` need an active server for your project's language.
71
+
72
+ ### 4. Optional: tune or disable servers
73
+
74
+ By default every detected language server starts concurrently. In polyglot repos this can spike CPU. To disable servers you do not need, run:
75
+
76
+ ```
77
+ /supi-settings
78
+ ```
79
+
80
+ Navigate to **LSP → Disabled Servers** and toggle off any languages you are not using. This writes per-language opt-outs into `.pi/supi/config.json` (project) or `~/.pi/agent/supi/config.json` (global).
81
+
82
+ You can also edit the config file directly:
83
+
84
+ ```json
85
+ {
86
+ "lsp": {
87
+ "servers": {
88
+ "python": { "enabled": false },
89
+ "rust": { "enabled": false }
90
+ }
91
+ }
92
+ }
93
+ ```
94
+
95
+ > **Note:** The global `lsp.enabled` switch and `lsp.active` allowlist are deprecated since v0.7.0 and have no effect.
96
+
97
+ ### 5. Optional: tune instruction-file names
98
+
99
+ Directory `code_orientation` surfaces local instruction files using the `code-intelligence.instructionFileNames` setting. Defaults:
100
+
101
+ ```json
102
+ {
103
+ "code-intelligence": {
104
+ "instructionFileNames": ["CLAUDE.md", "AGENTS.md"]
105
+ }
106
+ }
107
+ ```
108
+
109
+ Edit this through `/supi-settings` → **Code Intelligence**, or directly in `.pi/supi/config.json` / `~/.pi/agent/supi/config.json`.
110
+
27
111
  ## What you get
28
112
 
29
113
  After install, pi gets:
30
114
 
31
- - `code_orientation` — first-pass orientation for projects, discovered modules, directories, files, or precise symbols (`code_brief` and the old `code_context` surface have been replaced)
115
+ - `code_orientation` — first-pass orientation for projects, discovered modules, directories, files, or precise symbols; directory focus also surfaces applicable local instruction files such as `CLAUDE.md`/`AGENTS.md` (`code_brief` and the old `code_context` surface have been replaced)
32
116
  - `code_inspect` — factual point inspection for one precise file position
33
117
  - `code_graph` — unified relation graph (references, callees, imports, exports, implementations, tests) from a resolved target
34
118
  - `code_impact` — preferred workflow-oriented blast radius, downstream impact, and user-supplied change-set analysis
@@ -88,7 +172,7 @@ code_orientation(focus="packages/my-package")
88
172
  code_orientation(focus="packages/my-package/src/tool")
89
173
  code_orientation(focus="packages/my-package/src/tool/health/execute.ts")
90
174
  ```
91
- Orientation briefs are summaries, not source replacement; read the files before editing.
175
+ Directory orientation includes applicable local instruction files, shallowest first and deepest last, so package-local guidance is visible before editing. Orientation briefs are summaries, not source replacement; read the files before editing.
92
176
 
93
177
  ### Estimate impact before a change
94
178
 
@@ -123,7 +207,7 @@ code_orientation(targetId) → orient around the symbol
123
207
 
124
208
  ### Understand a package before editing
125
209
  ```
126
- code_orientation(focus="packages/my-package") → package orientation
210
+ code_orientation(focus="packages/my-package") → package orientation + local instruction files
127
211
  code_orientation(focus="packages/my-package/src/tool") → directory drill-down
128
212
  code_health(scope="packages/my-package", refresh=true) → check diagnostics
129
213
  ```
@@ -331,7 +415,7 @@ Unified ranked search tool with a strict evidence contract.
331
415
  - AST `call` mode matches call-site identifiers by name, not by symbol identity; use `code_graph` with `relations: ["references"]` on a resolved target for identity-aware callers
332
416
  - unsupported mode/kind combinations fail explicitly instead of being broadened into best-effort search
333
417
 
334
- Supports `query` (required), `scope`, `mode`, `kind`, `contextLines`, and `maxResults`.
418
+ Supports `query` (required), `scope` (one path or an array of paths), `mode`, `kind`, `contextLines`, and `maxResults`.
335
419
 
336
420
  ### `code_health`
337
421
  Health/status summary for the current workspace or a scoped path.
@@ -39,15 +39,17 @@ Config file locations:
39
39
 
40
40
  ### Settings helpers
41
41
 
42
- - `registerSettings()` — register an arbitrary settings section
43
- - `registerConfigSettings()` — register a config-backed settings section with scoped persistence helpers
44
- - `registerSettingsCommand()` — register `/supi-settings`
45
- - `openSettingsOverlay()` — open the shared settings UI directly
42
+ - `registerDeclarativeSettings(pi, options)` — contribute a config-backed declarative settings section with source-aware scoped persistence
43
+ - `registerSettingsCommand(pi)` — register `/supi-settings` (used by `@mrclrchtr/supi-settings`)
44
+ - `openSettingsOverlay(pi, ctx)` — open the shared settings UI directly
46
45
  - `createInputSubmenu()` — helper for simple text-entry submenus
46
+ - `createModelPickerSubmenu()` — helper for scoped model selection submenus
47
47
 
48
48
  The built-in settings UI supports:
49
49
 
50
50
  - project/global scope toggle
51
+ - source badges for project, global, and default values
52
+ - Inherit/Reset actions that delete scoped config keys
51
53
  - grouped extension sections
52
54
  - searchable setting lists
53
55
 
@@ -83,25 +85,32 @@ The built-in settings UI supports:
83
85
  ## Example
84
86
 
85
87
  ```ts
86
- import { loadSupiConfig, registerConfigSettings, wrapExtensionContext } from "@mrclrchtr/supi-core/api";
87
-
88
- const config = loadSupiConfig("my-extension", process.cwd(), {
89
- enabled: true,
90
- });
91
-
92
- registerConfigSettings({
93
- id: "my-extension",
94
- label: "My Extension",
95
- section: "my-extension",
96
- defaults: { enabled: true },
97
- buildItems: () => [],
98
- persistChange: () => {},
99
- });
100
-
101
- const message = wrapExtensionContext("my-extension", "hello", {
102
- file: "CLAUDE.md",
103
- turn: 1,
104
- });
88
+ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
89
+ import { loadSupiConfig, registerDeclarativeSettings, wrapExtensionContext } from "@mrclrchtr/supi-core/api";
90
+
91
+ export default function myExtension(pi: ExtensionAPI) {
92
+ const defaults = { enabled: true };
93
+ const config = loadSupiConfig("my-extension", process.cwd(), defaults);
94
+
95
+ registerDeclarativeSettings(pi, {
96
+ id: "my-extension",
97
+ label: "My Extension",
98
+ section: "my-extension",
99
+ defaults,
100
+ fields: [
101
+ {
102
+ kind: "boolean" as const,
103
+ key: "enabled",
104
+ label: "Enabled",
105
+ },
106
+ ],
107
+ });
108
+
109
+ const message = wrapExtensionContext("my-extension", "hello", {
110
+ enabled: config.enabled,
111
+ });
112
+ void message;
113
+ }
105
114
  ```
106
115
 
107
116
  ## Source
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mrclrchtr/supi-core",
3
- "version": "2.0.6",
3
+ "version": "2.2.0",
4
4
  "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -70,6 +70,7 @@
70
70
  "./status-spinner": "./src/status-spinner.ts",
71
71
  "./terminal": "./src/terminal.ts",
72
72
  "./tool-framework": "./src/tool-framework.ts",
73
+ "./prompt-surface": "./src/prompt-surface.ts",
73
74
  "./types": "./src/types.ts"
74
75
  }
75
76
  }
@@ -21,6 +21,15 @@ function getProjectConfigPath(cwd: string): string {
21
21
  return path.join(cwd, PROJECT_CONFIG_DIR, CONFIG_FILE);
22
22
  }
23
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
+
24
33
  export function readJsonFile(filePath: string): Record<string, unknown> | null {
25
34
  let content: string;
26
35
  try {
@@ -95,15 +104,22 @@ export function loadSupiConfigForScope<T>(
95
104
  defaults: T,
96
105
  options: { scope: "global" | "project" } & SupiConfigOptions,
97
106
  ): T {
98
- const config =
99
- options.scope === "global"
100
- ? readJsonFile(getGlobalConfigPath(options.homeDir))
101
- : readJsonFile(getProjectConfigPath(cwd));
107
+ const config = readJsonFile(getSupiConfigPath(options.scope, cwd, { homeDir: options.homeDir }));
102
108
 
103
109
  const scopedSection = extractSection(config, section);
104
110
  return shallowMerge(defaults, scopedSection);
105
111
  }
106
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
+
107
123
  export interface SupiConfigLocation {
108
124
  section: string;
109
125
  scope: "global" | "project";
@@ -118,8 +134,7 @@ export function writeSupiConfig(
118
134
  value: Record<string, unknown>,
119
135
  options?: SupiConfigOptions,
120
136
  ): void {
121
- const configPath =
122
- loc.scope === "global" ? getGlobalConfigPath(options?.homeDir) : getProjectConfigPath(loc.cwd);
137
+ const configPath = getSupiConfigPath(loc.scope, loc.cwd, options);
123
138
 
124
139
  const dir = path.dirname(configPath);
125
140
  fs.mkdirSync(dir, { recursive: true });
@@ -142,8 +157,7 @@ export function removeSupiConfigKey(
142
157
  key: string,
143
158
  options?: SupiConfigOptions,
144
159
  ): void {
145
- const configPath =
146
- loc.scope === "global" ? getGlobalConfigPath(options?.homeDir) : getProjectConfigPath(loc.cwd);
160
+ const configPath = getSupiConfigPath(loc.scope, loc.cwd, options);
147
161
 
148
162
  const existing = readJsonFile(configPath);
149
163
  if (!existing) return;
@@ -0,0 +1,357 @@
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 type { SuiPiToolPromptSurface } from "../tool-framework.ts";
12
+ import { loadSupiConfigSectionForScope, type SupiConfigOptions } from "./config.ts";
13
+
14
+ // ── Public types ───────────────────────────────────────────────────────────
15
+
16
+ export type ToolPromptSurfaceDiagnosticCode =
17
+ | "invalidPromptSurfaceConfig"
18
+ | "invalidPromptSurfaceField"
19
+ | "projectPromptSurfaceIgnored";
20
+
21
+ export interface ToolPromptSurfaceDiagnostic {
22
+ code: ToolPromptSurfaceDiagnosticCode;
23
+ scope: "global" | "project";
24
+ section: string;
25
+ toolName: string;
26
+ message: string;
27
+ }
28
+
29
+ export interface ResolveToolPromptSurfaceOptions extends SupiConfigOptions {
30
+ section: string;
31
+ toolName: string;
32
+ defaults: SuiPiToolPromptSurface;
33
+ ctx: Pick<ExtensionContext, "cwd" | "isProjectTrusted">;
34
+ }
35
+
36
+ export interface ResolveToolPromptSurfaceResult {
37
+ surface: SuiPiToolPromptSurface;
38
+ diagnostics: ToolPromptSurfaceDiagnostic[];
39
+ }
40
+
41
+ // ── Private types ──────────────────────────────────────────────────────────
42
+
43
+ type PromptSurfaceField = keyof SuiPiToolPromptSurface;
44
+ type PromptSurfaceScope = ToolPromptSurfaceDiagnostic["scope"];
45
+
46
+ const PROMPT_SURFACE_FIELDS = new Set<string>(["description", "promptSnippet", "promptGuidelines"]);
47
+
48
+ const PROMPT_SURFACE_DIAGNOSTICS_KEY = Symbol.for(
49
+ "@mrclrchtr/supi-core/tool-prompt-surface/notified-diagnostics",
50
+ );
51
+
52
+ // ── Resolution ─────────────────────────────────────────────────────────────
53
+
54
+ /** Resolve a tool's model-facing prompt surface from defaults + SuPi config overrides. */
55
+ export function resolveToolPromptSurface(
56
+ options: ResolveToolPromptSurfaceOptions,
57
+ ): ResolveToolPromptSurfaceResult {
58
+ const diagnostics: ToolPromptSurfaceDiagnostic[] = [];
59
+ let surface = clonePromptSurface(options.defaults);
60
+
61
+ const globalSection = loadSupiConfigSectionForScope(options.section, options.ctx.cwd, {
62
+ scope: "global",
63
+ homeDir: options.homeDir,
64
+ });
65
+ surface = applyPromptSurfaceScope(surface, options, "global", globalSection, diagnostics);
66
+
67
+ const projectSection = loadSupiConfigSectionForScope(options.section, options.ctx.cwd, {
68
+ scope: "project",
69
+ homeDir: options.homeDir,
70
+ });
71
+ const projectPromptSurface = getPromptSurfaceConfig(projectSection, options.toolName, {
72
+ diagnostics,
73
+ options,
74
+ scope: "project",
75
+ });
76
+
77
+ if (projectPromptSurface) {
78
+ const hasTrustMarker = hasTrustRequiringProjectResources(options.ctx.cwd);
79
+ const projectTrusted = options.ctx.isProjectTrusted();
80
+ if (hasTrustMarker && projectTrusted) {
81
+ surface = applyPromptSurfaceConfig(
82
+ surface,
83
+ options.defaults,
84
+ projectPromptSurface,
85
+ options,
86
+ "project",
87
+ diagnostics,
88
+ );
89
+ } else {
90
+ diagnostics.push({
91
+ code: "projectPromptSurfaceIgnored",
92
+ scope: "project",
93
+ section: options.section,
94
+ toolName: options.toolName,
95
+ message: hasTrustMarker
96
+ ? `Project prompt-surface overrides for ${options.toolName} were ignored because the project is not trusted in PI.`
97
+ : `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.`,
98
+ });
99
+ }
100
+ }
101
+
102
+ return { surface, diagnostics };
103
+ }
104
+
105
+ /** Notify prompt-surface diagnostics once per session/tool/diagnostic code. */
106
+ export function notifyToolPromptSurfaceDiagnostics(
107
+ ctx: Pick<ExtensionContext, "sessionManager" | "ui">,
108
+ diagnostics: readonly ToolPromptSurfaceDiagnostic[],
109
+ ): void {
110
+ const globalRecord = globalThis as Record<symbol, Set<string> | undefined>;
111
+ const notified = globalRecord[PROMPT_SURFACE_DIAGNOSTICS_KEY] ?? new Set<string>();
112
+ globalRecord[PROMPT_SURFACE_DIAGNOSTICS_KEY] = notified;
113
+ const sessionId = ctx.sessionManager.getSessionId();
114
+
115
+ for (const diagnostic of diagnostics) {
116
+ const key = `${sessionId}:${diagnostic.section}:${diagnostic.toolName}:${diagnostic.code}`;
117
+ if (notified.has(key)) continue;
118
+ notified.add(key);
119
+ ctx.ui.notify(diagnostic.message, "warning");
120
+ }
121
+ }
122
+
123
+ // ── Scope helpers ──────────────────────────────────────────────────────────
124
+
125
+ // biome-ignore lint/complexity/useMaxParams: resolver dispatch with diagnostics
126
+ function applyPromptSurfaceScope(
127
+ current: SuiPiToolPromptSurface,
128
+ options: ResolveToolPromptSurfaceOptions,
129
+ scope: PromptSurfaceScope,
130
+ sectionConfig: Record<string, unknown> | null,
131
+ diagnostics: ToolPromptSurfaceDiagnostic[],
132
+ ): SuiPiToolPromptSurface {
133
+ const promptSurface = getPromptSurfaceConfig(sectionConfig, options.toolName, {
134
+ diagnostics,
135
+ options,
136
+ scope,
137
+ });
138
+ if (!promptSurface) return current;
139
+ return applyPromptSurfaceConfig(
140
+ current,
141
+ options.defaults,
142
+ promptSurface,
143
+ options,
144
+ scope,
145
+ diagnostics,
146
+ );
147
+ }
148
+
149
+ // biome-ignore lint/complexity/useMaxParams: per-scope config merger with diagnostics
150
+ function applyPromptSurfaceConfig(
151
+ current: SuiPiToolPromptSurface,
152
+ defaults: SuiPiToolPromptSurface,
153
+ config: Record<string, unknown>,
154
+ options: ResolveToolPromptSurfaceOptions,
155
+ scope: PromptSurfaceScope,
156
+ diagnostics: ToolPromptSurfaceDiagnostic[],
157
+ ): SuiPiToolPromptSurface {
158
+ let next = clonePromptSurface(current);
159
+
160
+ for (const field of getResetFields(config.$reset, options, scope, diagnostics)) {
161
+ next = { ...next, [field]: clonePromptSurfaceField(defaults[field]) };
162
+ }
163
+
164
+ const description = getOptionalNonEmptyString(
165
+ config.description,
166
+ "description",
167
+ options,
168
+ scope,
169
+ diagnostics,
170
+ );
171
+ if (description !== undefined) next.description = description;
172
+
173
+ const promptSnippet = getOptionalNonEmptyString(
174
+ config.promptSnippet,
175
+ "promptSnippet",
176
+ options,
177
+ scope,
178
+ diagnostics,
179
+ );
180
+ if (promptSnippet !== undefined) next.promptSnippet = promptSnippet;
181
+
182
+ const promptGuidelines = getOptionalStringArray(
183
+ config.promptGuidelines,
184
+ "promptGuidelines",
185
+ options,
186
+ scope,
187
+ diagnostics,
188
+ );
189
+ if (promptGuidelines !== undefined) next.promptGuidelines = promptGuidelines;
190
+
191
+ const prepend = getOptionalStringArray(
192
+ config.prependPromptGuidelines,
193
+ "prependPromptGuidelines",
194
+ options,
195
+ scope,
196
+ diagnostics,
197
+ );
198
+ if (prepend !== undefined) next.promptGuidelines = [...prepend, ...next.promptGuidelines];
199
+
200
+ const append = getOptionalStringArray(
201
+ config.appendPromptGuidelines,
202
+ "appendPromptGuidelines",
203
+ options,
204
+ scope,
205
+ diagnostics,
206
+ );
207
+ if (append !== undefined) next.promptGuidelines = [...next.promptGuidelines, ...append];
208
+
209
+ return next;
210
+ }
211
+
212
+ // ── Config extraction ──────────────────────────────────────────────────────
213
+
214
+ function getPromptSurfaceConfig(
215
+ sectionConfig: Record<string, unknown> | null,
216
+ toolName: string,
217
+ deps: {
218
+ diagnostics: ToolPromptSurfaceDiagnostic[];
219
+ options: ResolveToolPromptSurfaceOptions;
220
+ scope: PromptSurfaceScope;
221
+ },
222
+ ): Record<string, unknown> | null {
223
+ if (!sectionConfig) return null;
224
+ if (sectionConfig.tools === undefined) return null;
225
+ if (!isRecord(sectionConfig.tools)) {
226
+ pushInvalidConfig(deps, "tools must be an object.");
227
+ return null;
228
+ }
229
+ const toolConfig = sectionConfig.tools[toolName];
230
+ if (toolConfig === undefined) return null;
231
+ if (!isRecord(toolConfig)) {
232
+ pushInvalidConfig(deps, `tools.${toolName} must be an object.`);
233
+ return null;
234
+ }
235
+ if (toolConfig.promptSurface === undefined) return null;
236
+ if (!isRecord(toolConfig.promptSurface)) {
237
+ pushInvalidConfig(deps, `tools.${toolName}.promptSurface must be an object.`);
238
+ return null;
239
+ }
240
+ return toolConfig.promptSurface;
241
+ }
242
+
243
+ // ── Field validation ───────────────────────────────────────────────────────
244
+
245
+ function getResetFields(
246
+ value: unknown,
247
+ options: ResolveToolPromptSurfaceOptions,
248
+ scope: PromptSurfaceScope,
249
+ diagnostics: ToolPromptSurfaceDiagnostic[],
250
+ ): PromptSurfaceField[] {
251
+ if (value === undefined) return [];
252
+ if (!Array.isArray(value)) {
253
+ pushInvalidField(options, scope, diagnostics, "$reset", "must be an array.");
254
+ return [];
255
+ }
256
+ const fields: PromptSurfaceField[] = [];
257
+ for (const item of value) {
258
+ if (typeof item === "string" && PROMPT_SURFACE_FIELDS.has(item)) {
259
+ fields.push(item as PromptSurfaceField);
260
+ } else {
261
+ pushInvalidField(
262
+ options,
263
+ scope,
264
+ diagnostics,
265
+ "$reset",
266
+ `contains unsupported field ${JSON.stringify(item)}.`,
267
+ );
268
+ }
269
+ }
270
+ return fields;
271
+ }
272
+
273
+ // biome-ignore lint/complexity/useMaxParams: validation helper with diagnostics
274
+ function getOptionalNonEmptyString(
275
+ value: unknown,
276
+ field: string,
277
+ options: ResolveToolPromptSurfaceOptions,
278
+ scope: PromptSurfaceScope,
279
+ diagnostics: ToolPromptSurfaceDiagnostic[],
280
+ ): string | undefined {
281
+ if (value === undefined) return undefined;
282
+ if (typeof value === "string" && value.length > 0) return value;
283
+ pushInvalidField(options, scope, diagnostics, field, "must be a non-empty string.");
284
+ return undefined;
285
+ }
286
+
287
+ // biome-ignore lint/complexity/useMaxParams: validation helper with diagnostics
288
+ function getOptionalStringArray(
289
+ value: unknown,
290
+ field: string,
291
+ options: ResolveToolPromptSurfaceOptions,
292
+ scope: PromptSurfaceScope,
293
+ diagnostics: ToolPromptSurfaceDiagnostic[],
294
+ ): string[] | undefined {
295
+ if (value === undefined) return undefined;
296
+ if (Array.isArray(value) && value.every((item) => typeof item === "string")) {
297
+ return [...value];
298
+ }
299
+ pushInvalidField(options, scope, diagnostics, field, "must be an array of strings.");
300
+ return undefined;
301
+ }
302
+
303
+ // ── Diagnostics ────────────────────────────────────────────────────────────
304
+
305
+ function pushInvalidConfig(
306
+ deps: {
307
+ diagnostics: ToolPromptSurfaceDiagnostic[];
308
+ options: ResolveToolPromptSurfaceOptions;
309
+ scope: PromptSurfaceScope;
310
+ },
311
+ detail: string,
312
+ ): void {
313
+ deps.diagnostics.push({
314
+ // biome-ignore lint/security/noSecrets: false positive on string constant
315
+ code: "invalidPromptSurfaceConfig",
316
+ scope: deps.scope,
317
+ section: deps.options.section,
318
+ toolName: deps.options.toolName,
319
+ message: `Invalid prompt-surface config for ${deps.options.section}.${deps.options.toolName}: ${detail}`,
320
+ });
321
+ }
322
+
323
+ // biome-ignore lint/complexity/useMaxParams: diagnostics utility with many fields
324
+ function pushInvalidField(
325
+ options: ResolveToolPromptSurfaceOptions,
326
+ scope: PromptSurfaceScope,
327
+ diagnostics: ToolPromptSurfaceDiagnostic[],
328
+ field: string,
329
+ detail: string,
330
+ ): void {
331
+ diagnostics.push({
332
+ // biome-ignore lint/security/noSecrets: false positive on string constant
333
+ code: "invalidPromptSurfaceField",
334
+ scope,
335
+ section: options.section,
336
+ toolName: options.toolName,
337
+ message: `Invalid prompt-surface field ${field} for ${options.section}.${options.toolName}: ${detail}`,
338
+ });
339
+ }
340
+
341
+ // ── Cloning ────────────────────────────────────────────────────────────────
342
+
343
+ function clonePromptSurface(surface: SuiPiToolPromptSurface): SuiPiToolPromptSurface {
344
+ return {
345
+ description: surface.description,
346
+ promptSnippet: surface.promptSnippet,
347
+ promptGuidelines: [...surface.promptGuidelines],
348
+ };
349
+ }
350
+
351
+ function clonePromptSurfaceField<T extends string | string[]>(value: T): T {
352
+ return (Array.isArray(value) ? [...value] : value) as T;
353
+ }
354
+
355
+ function isRecord(value: unknown): value is Record<string, unknown> {
356
+ return typeof value === "object" && value !== null && !Array.isArray(value);
357
+ }
@@ -1,12 +1,11 @@
1
- // supi-core config domain — config loading and config-settings helpers.
1
+ // supi-core config domain — config loading.
2
2
  export type { SupiConfigLocation, SupiConfigOptions } from "./config/config.ts";
3
3
  export {
4
4
  loadSectionConfig,
5
5
  loadSupiConfig,
6
6
  loadSupiConfigForScope,
7
+ loadSupiConfigSectionForScope,
7
8
  readJsonFile,
8
9
  removeSupiConfigKey,
9
10
  writeSupiConfig,
10
11
  } from "./config/config.ts";
11
- export type { ConfigSettingsHelpers, ConfigSettingsOptions } from "./config/config-settings.ts";
12
- export { registerConfigSettings } from "./config/config-settings.ts";
@@ -6,8 +6,6 @@
6
6
 
7
7
  export type DebugLevel = "debug" | "info" | "warning" | "error";
8
8
  export type DebugAgentAccess = "off" | "sanitized" | "raw";
9
- export type DebugNotifyLevel = "off" | "warning" | "error";
10
-
11
9
  export interface DebugRegistryConfig {
12
10
  /** Whether producers should retain debug events. */
13
11
  enabled: boolean;
@@ -15,15 +13,12 @@ export interface DebugRegistryConfig {
15
13
  agentAccess: DebugAgentAccess;
16
14
  /** Maximum number of session-local events to keep in memory. */
17
15
  maxEvents: number;
18
- /** Minimum level that should notify the user; interpreted by UI extensions. */
19
- notifyLevel: DebugNotifyLevel;
20
16
  }
21
17
 
22
18
  export const DEBUG_REGISTRY_DEFAULTS: DebugRegistryConfig = {
23
19
  enabled: false,
24
20
  agentAccess: "sanitized",
25
21
  maxEvents: 100,
26
- notifyLevel: "off",
27
22
  };
28
23
 
29
24
  export interface DebugEventInput {
@@ -0,0 +1,4 @@
1
+ // supi-core prompt-surface — configurable tool prompt-surface resolver (package boundary for @mrclrchtr/supi-core/prompt-surface).
2
+
3
+ // biome-ignore lint/performance/noReExportAll: intentional barrel
4
+ export * from "./config/prompt-surface.ts";