@mrclrchtr/supi-code-intelligence 4.0.0 → 4.1.0

package/README.md

@@ -251,6 +251,8 @@ The old global `lsp.enabled` and `lsp.active` keys are deprecated and ignored. M
 - `supi-code-runtime` owns canonical provider contracts and workspace capability state.
 - `supi-lsp` owns semantic lifecycle and the Workspace LSP runtime.
 - `supi-tree-sitter` owns structural parser reuse.
+- The process-shared Workspace provider host starts LSP and Tree-sitter once per canonical workspace and releases them after the final session lease. Target and refactor handles remain session-local.
+- The Headless inspection profile is for managed child sessions and registers only the six non-mutating inspection tools; it omits refactors, settings, UI, commands, and overview injection.
 
 Markdown and TUI are adapters over assembled typed results. Providers, clients, mutable targets, and the LSP manager do not cross the workflow seam.
 
@@ -264,4 +266,5 @@ See:
 ## Package exports
 
 - `@mrclrchtr/supi-code-intelligence/api` — reusable type contracts
-- `@mrclrchtr/supi-code-intelligence/extension` — PI extension entrypoint
+- `@mrclrchtr/supi-code-intelligence/extension` — full interactive PI extension entrypoint
+- `@mrclrchtr/supi-code-intelligence/headless` — managed-child inspection profile

package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {

package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-action-menu.ts

@@ -34,6 +34,7 @@ export function buildActionMenu(field: ScopedFieldValue, scope: SettingsScope):
     if (choices.length > 0) {
       for (const choice of choices) menu.push({ value: `set:${choice}`, label: choice });
     } else if (field.field.kind === "number") menu.push({ value: "edit", label: "Edit value…" });
+    else if (field.field.kind === "string") menu.push({ value: "edit", label: "Edit value…" });
     else if (field.field.kind === "stringList") menu.push({ value: "edit", label: "Edit values…" });
     else if (field.field.kind === "modelPicker")
       menu.push({ value: "edit", label: "Choose model…" });

package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts

@@ -86,6 +86,11 @@ export interface NumberField extends BaseField {
   values?: string[];
 }
 
+/** One free-form string. */
+export interface StringField extends BaseField {
+  kind: "string";
+}
+
 /** Comma-separated string list. */
 export interface StringListField extends BaseField {
   kind: "stringList";
@@ -164,6 +169,7 @@ export type SettingsField =
   | BoolField
   | EnumField
   | NumberField
+  | StringField
   | StringListField
   | ModelPickerField
   | CustomField;
@@ -248,6 +254,8 @@ export function formatValue(value: unknown, field: SettingsField): string {
       return value ? "on" : "off";
     case "number":
       return String(value ?? "");
+    case "string":
+      return typeof value === "string" && value ? value : "none";
     case "stringList": {
       const arr = Array.isArray(value) ? value : [];
       return arr.length > 0 ? arr.map(String).join(", ") : "none";
@@ -271,6 +279,7 @@ export function sourceBadge(displayValue: string, source: ValueSource): string {
 
 /** Format the value used to prefill editors and compare concrete choices. */
 export function formatEditValue(value: unknown, field: SettingsField): string {
+  if (field.kind === "string") return typeof value === "string" ? value : "";
   if (field.kind === "stringList") {
     const arr = Array.isArray(value) ? value : [];
     return arr.map(String).join(", ");

package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings.ts

@@ -26,6 +26,7 @@ export type {
   SettingsField,
   SettingsFieldAction,
   SettingsPersistedChange,
+  StringField,
   StringListField,
   ValueSource,
 } from "./settings/settings-schema.ts";

package/node_modules/@mrclrchtr/supi-code-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-code-runtime",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "SuPi code-runtime — shared workspace context, capability contracts, and canonical types for the code-understanding stack",
   "license": "MIT",
   "repository": {
@@ -29,7 +29,7 @@
     "!__tests__"
   ],
   "dependencies": {
-    "@mrclrchtr/supi-core": "4.0.0"
+    "@mrclrchtr/supi-core": "4.1.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"

package/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {

package/node_modules/@mrclrchtr/supi-core/src/settings/settings-action-menu.ts

@@ -34,6 +34,7 @@ export function buildActionMenu(field: ScopedFieldValue, scope: SettingsScope):
     if (choices.length > 0) {
       for (const choice of choices) menu.push({ value: `set:${choice}`, label: choice });
     } else if (field.field.kind === "number") menu.push({ value: "edit", label: "Edit value…" });
+    else if (field.field.kind === "string") menu.push({ value: "edit", label: "Edit value…" });
     else if (field.field.kind === "stringList") menu.push({ value: "edit", label: "Edit values…" });
     else if (field.field.kind === "modelPicker")
       menu.push({ value: "edit", label: "Choose model…" });

package/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts

@@ -86,6 +86,11 @@ export interface NumberField extends BaseField {
   values?: string[];
 }
 
+/** One free-form string. */
+export interface StringField extends BaseField {
+  kind: "string";
+}
+
 /** Comma-separated string list. */
 export interface StringListField extends BaseField {
   kind: "stringList";
@@ -164,6 +169,7 @@ export type SettingsField =
   | BoolField
   | EnumField
   | NumberField
+  | StringField
   | StringListField
   | ModelPickerField
   | CustomField;
@@ -248,6 +254,8 @@ export function formatValue(value: unknown, field: SettingsField): string {
       return value ? "on" : "off";
     case "number":
       return String(value ?? "");
+    case "string":
+      return typeof value === "string" && value ? value : "none";
     case "stringList": {
       const arr = Array.isArray(value) ? value : [];
       return arr.length > 0 ? arr.map(String).join(", ") : "none";
@@ -271,6 +279,7 @@ export function sourceBadge(displayValue: string, source: ValueSource): string {
 
 /** Format the value used to prefill editors and compare concrete choices. */
 export function formatEditValue(value: unknown, field: SettingsField): string {
+  if (field.kind === "string") return typeof value === "string" ? value : "";
   if (field.kind === "stringList") {
     const arr = Array.isArray(value) ? value : [];
     return arr.map(String).join(", ");

package/node_modules/@mrclrchtr/supi-core/src/settings.ts

@@ -26,6 +26,7 @@ export type {
   SettingsField,
   SettingsFieldAction,
   SettingsPersistedChange,
+  StringField,
   StringListField,
   ValueSource,
 } from "./settings/settings-schema.ts";

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {
@@ -48,10 +48,6 @@
       "optional": true
     }
   },
-  "devDependencies": {
-    "@types/node": "25.9.5",
-    "vitest": "4.1.10"
-  },
   "main": "src/api.ts",
   "exports": {
     "./api": "./src/api.ts",

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-action-menu.ts

@@ -34,6 +34,7 @@ export function buildActionMenu(field: ScopedFieldValue, scope: SettingsScope):
     if (choices.length > 0) {
       for (const choice of choices) menu.push({ value: `set:${choice}`, label: choice });
     } else if (field.field.kind === "number") menu.push({ value: "edit", label: "Edit value…" });
+    else if (field.field.kind === "string") menu.push({ value: "edit", label: "Edit value…" });
     else if (field.field.kind === "stringList") menu.push({ value: "edit", label: "Edit values…" });
     else if (field.field.kind === "modelPicker")
       menu.push({ value: "edit", label: "Choose model…" });

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts

@@ -86,6 +86,11 @@ export interface NumberField extends BaseField {
   values?: string[];
 }
 
+/** One free-form string. */
+export interface StringField extends BaseField {
+  kind: "string";
+}
+
 /** Comma-separated string list. */
 export interface StringListField extends BaseField {
   kind: "stringList";
@@ -164,6 +169,7 @@ export type SettingsField =
   | BoolField
   | EnumField
   | NumberField
+  | StringField
   | StringListField
   | ModelPickerField
   | CustomField;
@@ -248,6 +254,8 @@ export function formatValue(value: unknown, field: SettingsField): string {
       return value ? "on" : "off";
     case "number":
       return String(value ?? "");
+    case "string":
+      return typeof value === "string" && value ? value : "none";
     case "stringList": {
       const arr = Array.isArray(value) ? value : [];
       return arr.length > 0 ? arr.map(String).join(", ") : "none";
@@ -271,6 +279,7 @@ export function sourceBadge(displayValue: string, source: ValueSource): string {
 
 /** Format the value used to prefill editors and compare concrete choices. */
 export function formatEditValue(value: unknown, field: SettingsField): string {
+  if (field.kind === "string") return typeof value === "string" ? value : "";
   if (field.kind === "stringList") {
     const arr = Array.isArray(value) ? value : [];
     return arr.map(String).join(", ");

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings.ts

@@ -26,6 +26,7 @@ export type {
   SettingsField,
   SettingsFieldAction,
   SettingsPersistedChange,
+  StringField,
   StringListField,
   ValueSource,
 } from "./settings/settings-schema.ts";

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-code-runtime",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "SuPi code-runtime — shared workspace context, capability contracts, and canonical types for the code-understanding stack",
   "license": "MIT",
   "repository": {
@@ -29,7 +29,7 @@
     "!__tests__"
   ],
   "dependencies": {
-    "@mrclrchtr/supi-core": "4.0.0"
+    "@mrclrchtr/supi-core": "4.1.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings/settings-action-menu.ts

@@ -34,6 +34,7 @@ export function buildActionMenu(field: ScopedFieldValue, scope: SettingsScope):
     if (choices.length > 0) {
       for (const choice of choices) menu.push({ value: `set:${choice}`, label: choice });
     } else if (field.field.kind === "number") menu.push({ value: "edit", label: "Edit value…" });
+    else if (field.field.kind === "string") menu.push({ value: "edit", label: "Edit value…" });
     else if (field.field.kind === "stringList") menu.push({ value: "edit", label: "Edit values…" });
     else if (field.field.kind === "modelPicker")
       menu.push({ value: "edit", label: "Choose model…" });

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts

@@ -86,6 +86,11 @@ export interface NumberField extends BaseField {
   values?: string[];
 }
 
+/** One free-form string. */
+export interface StringField extends BaseField {
+  kind: "string";
+}
+
 /** Comma-separated string list. */
 export interface StringListField extends BaseField {
   kind: "stringList";
@@ -164,6 +169,7 @@ export type SettingsField =
   | BoolField
   | EnumField
   | NumberField
+  | StringField
   | StringListField
   | ModelPickerField
   | CustomField;
@@ -248,6 +254,8 @@ export function formatValue(value: unknown, field: SettingsField): string {
       return value ? "on" : "off";
     case "number":
       return String(value ?? "");
+    case "string":
+      return typeof value === "string" && value ? value : "none";
     case "stringList": {
       const arr = Array.isArray(value) ? value : [];
       return arr.length > 0 ? arr.map(String).join(", ") : "none";
@@ -271,6 +279,7 @@ export function sourceBadge(displayValue: string, source: ValueSource): string {
 
 /** Format the value used to prefill editors and compare concrete choices. */
 export function formatEditValue(value: unknown, field: SettingsField): string {
+  if (field.kind === "string") return typeof value === "string" ? value : "";
   if (field.kind === "stringList") {
     const arr = Array.isArray(value) ? value : [];
     return arr.map(String).join(", ");

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/src/settings.ts

@@ -26,6 +26,7 @@ export type {
   SettingsField,
   SettingsFieldAction,
   SettingsPersistedChange,
+  StringField,
   StringListField,
   ValueSource,
 } from "./settings/settings-schema.ts";

package/node_modules/@mrclrchtr/supi-lsp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-lsp",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "SuPi LSP runtime — Language Server Protocol integration library for pi",
   "license": "MIT",
   "repository": {
@@ -37,8 +37,8 @@
     "vscode-jsonrpc": "^9.0.0",
     "vscode-languageserver-protocol": "^3.17.5",
     "vscode-languageserver-types": "^3.17.5",
-    "@mrclrchtr/supi-code-runtime": "4.0.0",
-    "@mrclrchtr/supi-core": "4.0.0"
+    "@mrclrchtr/supi-code-runtime": "4.1.0",
+    "@mrclrchtr/supi-core": "4.1.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-code-runtime",

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {
@@ -48,10 +48,6 @@
       "optional": true
     }
   },
-  "devDependencies": {
-    "@types/node": "25.9.5",
-    "vitest": "4.1.10"
-  },
   "main": "src/api.ts",
   "exports": {
     "./api": "./src/api.ts",

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-action-menu.ts

@@ -34,6 +34,7 @@ export function buildActionMenu(field: ScopedFieldValue, scope: SettingsScope):
     if (choices.length > 0) {
       for (const choice of choices) menu.push({ value: `set:${choice}`, label: choice });
     } else if (field.field.kind === "number") menu.push({ value: "edit", label: "Edit value…" });
+    else if (field.field.kind === "string") menu.push({ value: "edit", label: "Edit value…" });
     else if (field.field.kind === "stringList") menu.push({ value: "edit", label: "Edit values…" });
     else if (field.field.kind === "modelPicker")
       menu.push({ value: "edit", label: "Choose model…" });

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts

@@ -86,6 +86,11 @@ export interface NumberField extends BaseField {
   values?: string[];
 }
 
+/** One free-form string. */
+export interface StringField extends BaseField {
+  kind: "string";
+}
+
 /** Comma-separated string list. */
 export interface StringListField extends BaseField {
   kind: "stringList";
@@ -164,6 +169,7 @@ export type SettingsField =
   | BoolField
   | EnumField
   | NumberField
+  | StringField
   | StringListField
   | ModelPickerField
   | CustomField;
@@ -248,6 +254,8 @@ export function formatValue(value: unknown, field: SettingsField): string {
       return value ? "on" : "off";
     case "number":
       return String(value ?? "");
+    case "string":
+      return typeof value === "string" && value ? value : "none";
     case "stringList": {
       const arr = Array.isArray(value) ? value : [];
       return arr.length > 0 ? arr.map(String).join(", ") : "none";
@@ -271,6 +279,7 @@ export function sourceBadge(displayValue: string, source: ValueSource): string {
 
 /** Format the value used to prefill editors and compare concrete choices. */
 export function formatEditValue(value: unknown, field: SettingsField): string {
+  if (field.kind === "string") return typeof value === "string" ? value : "";
   if (field.kind === "stringList") {
     const arr = Array.isArray(value) ? value : [];
     return arr.map(String).join(", ");

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/settings.ts

@@ -26,6 +26,7 @@ export type {
   SettingsField,
   SettingsFieldAction,
   SettingsPersistedChange,
+  StringField,
   StringListField,
   ValueSource,
 } from "./settings/settings-schema.ts";

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-code-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-code-runtime",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "SuPi code-runtime — shared workspace context, capability contracts, and canonical types for the code-understanding stack",
   "license": "MIT",
   "repository": {
@@ -29,7 +29,7 @@
     "!__tests__"
   ],
   "dependencies": {
-    "@mrclrchtr/supi-core": "4.0.0"
+    "@mrclrchtr/supi-core": "4.1.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/settings/settings-action-menu.ts

@@ -34,6 +34,7 @@ export function buildActionMenu(field: ScopedFieldValue, scope: SettingsScope):
     if (choices.length > 0) {
       for (const choice of choices) menu.push({ value: `set:${choice}`, label: choice });
     } else if (field.field.kind === "number") menu.push({ value: "edit", label: "Edit value…" });
+    else if (field.field.kind === "string") menu.push({ value: "edit", label: "Edit value…" });
     else if (field.field.kind === "stringList") menu.push({ value: "edit", label: "Edit values…" });
     else if (field.field.kind === "modelPicker")
       menu.push({ value: "edit", label: "Choose model…" });

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/settings/settings-schema.ts

@@ -86,6 +86,11 @@ export interface NumberField extends BaseField {
   values?: string[];
 }
 
+/** One free-form string. */
+export interface StringField extends BaseField {
+  kind: "string";
+}
+
 /** Comma-separated string list. */
 export interface StringListField extends BaseField {
   kind: "stringList";
@@ -164,6 +169,7 @@ export type SettingsField =
   | BoolField
   | EnumField
   | NumberField
+  | StringField
   | StringListField
   | ModelPickerField
   | CustomField;
@@ -248,6 +254,8 @@ export function formatValue(value: unknown, field: SettingsField): string {
       return value ? "on" : "off";
     case "number":
       return String(value ?? "");
+    case "string":
+      return typeof value === "string" && value ? value : "none";
     case "stringList": {
       const arr = Array.isArray(value) ? value : [];
       return arr.length > 0 ? arr.map(String).join(", ") : "none";
@@ -271,6 +279,7 @@ export function sourceBadge(displayValue: string, source: ValueSource): string {
 
 /** Format the value used to prefill editors and compare concrete choices. */
 export function formatEditValue(value: unknown, field: SettingsField): string {
+  if (field.kind === "string") return typeof value === "string" ? value : "";
   if (field.kind === "stringList") {
     const arr = Array.isArray(value) ? value : [];
     return arr.map(String).join(", ");

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/src/settings.ts

@@ -26,6 +26,7 @@ export type {
   SettingsField,
   SettingsFieldAction,
   SettingsPersistedChange,
+  StringField,
   StringListField,
   ValueSource,
 } from "./settings/settings-schema.ts";

package/node_modules/@mrclrchtr/supi-tree-sitter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-tree-sitter",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "SuPi Tree-sitter library — structural AST analysis for pi",
   "license": "MIT",
   "repository": {
@@ -34,8 +34,8 @@
   ],
   "dependencies": {
     "web-tree-sitter": "^0.26.8",
-    "@mrclrchtr/supi-code-runtime": "4.0.0",
-    "@mrclrchtr/supi-core": "4.0.0"
+    "@mrclrchtr/supi-code-runtime": "4.1.0",
+    "@mrclrchtr/supi-core": "4.1.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-code-runtime",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-code-intelligence",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "SuPi Code Intelligence extension — workspace orientation, target resolution and inspection, relationship analysis, code-aware search, live health, and semantic refactoring for pi",
   "license": "MIT",
   "repository": {
@@ -34,10 +34,10 @@
   ],
   "dependencies": {
     "yaml": "^2.9.0",
-    "@mrclrchtr/supi-code-runtime": "4.0.0",
-    "@mrclrchtr/supi-lsp": "4.0.0",
-    "@mrclrchtr/supi-core": "4.0.0",
-    "@mrclrchtr/supi-tree-sitter": "4.0.0"
+    "@mrclrchtr/supi-core": "4.1.0",
+    "@mrclrchtr/supi-tree-sitter": "4.1.0",
+    "@mrclrchtr/supi-lsp": "4.1.0",
+    "@mrclrchtr/supi-code-runtime": "4.1.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-code-runtime",
@@ -77,6 +77,7 @@
     ".": "./src/index.ts",
     "./api": "./src/api.ts",
     "./extension": "./src/extension.ts",
+    "./headless": "./src/headless.ts",
     "./package.json": "./package.json"
   }
 }

package/src/app/app.ts

@@ -61,7 +61,10 @@ export function createSessionCache(): {
   const sessions = new Map<string, WorkspaceCodeIntelligenceSession>();
   return {
     getOrCreate: (cwd) => getOrCreateSession(sessions, cwd),
-    clear: () => sessions.clear(),
+    clear: () => {
+      for (const session of sessions.values()) session.clearStores();
+      sessions.clear();
+    },
   };
 }
 

package/src/extension.ts

@@ -1,5 +1,5 @@
 // Code Intelligence extension entry point — registers the focused code-intelligence tools,
-// LSP diagnostics and settings, and the unified /supi-ci-status command.
+// shared provider lifecycle, settings, UI, and the unified /supi-ci-status command.
 
 import type { BeforeAgentStartEventResult, ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { buildArchitectureModel } from "./analysis/architecture/discovery.ts";
@@ -10,10 +10,6 @@ import { registerLspSessionLifecycle } from "./substrate/lsp/lifecycle.ts";
 import { registerWorkspaceRecoveryHandler } from "./substrate/lsp/recovery.ts";
 import { registerLspSettings } from "./substrate/lsp/settings.ts";
 import { createLspAdapterState } from "./substrate/lsp/state.ts";
-import {
-  createTsAdapterState,
-  registerTsSessionLifecycle,
-} from "./substrate/tree-sitter/lifecycle.ts";
 import { registerCodeIntelligenceTools } from "./tool/register.ts";
 import { registerLspFooterContribution } from "./ui/footer.ts";
 import { estimateTokens, OVERVIEW_TOKEN_BUDGET, renderOverview } from "./ui/markdown/overview.ts";
@@ -21,102 +17,44 @@ import { buildOverviewData } from "./ui/markdown/overview-data.ts";
 import { registerCiStatusCommand } from "./ui/status-command.ts";
 
 const OVERVIEW_CUSTOM_TYPE = "code-intelligence-overview";
-const PROCESS_EXIT_SAFETY_NET = Symbol.for("supi-code-intelligence/process-exit-safety-net");
-
-interface ProcessExitSafetyNet {
-  cleanup: (() => void) | null;
-  handlerRegistered: boolean;
-  handler: () => void;
-}
-
-/**
- * Keep one process-exit listener across `/reload` extension instances.
- * Pi hosts one active extension API per process; replacing its cleanup callback
- * prevents old adapter state from being retained after reload.
- */
-function registerProcessExitSafetyNet(cleanup: () => void): () => void {
-  const host = globalThis as Record<symbol, ProcessExitSafetyNet | undefined>;
-  const safetyNet = host[PROCESS_EXIT_SAFETY_NET] ?? createProcessExitSafetyNet();
-  host[PROCESS_EXIT_SAFETY_NET] = safetyNet;
-
-  safetyNet.cleanup = cleanup;
-  if (!safetyNet.handlerRegistered) {
-    process.once("exit", safetyNet.handler);
-    safetyNet.handlerRegistered = true;
-  }
-
-  return () => {
-    if (safetyNet.cleanup !== cleanup) return;
-    safetyNet.cleanup = null;
-    if (!safetyNet.handlerRegistered) return;
-    process.off("exit", safetyNet.handler);
-    safetyNet.handlerRegistered = false;
-  };
-}
-
-function createProcessExitSafetyNet(): ProcessExitSafetyNet {
-  const safetyNet: ProcessExitSafetyNet = {
-    cleanup: null,
-    handlerRegistered: false,
-    handler: () => {},
-  };
-  safetyNet.handler = () => {
-    safetyNet.handlerRegistered = false;
-    const activeCleanup = safetyNet.cleanup;
-    safetyNet.cleanup = null;
-    activeCleanup?.();
-  };
-  return safetyNet;
-}
 
+/** Register the full interactive Code Intelligence profile. */
 export default function codeIntelligenceExtension(
   pi: ExtensionAPI,
   getOrCreateSession?: (cwd: string) => WorkspaceCodeIntelligenceSession,
 ) {
   const app = createCodeIntelligenceApp(pi);
-
   const lspState = createLspAdapterState();
-  const tsState = createTsAdapterState();
 
-  // ── Substrate wiring ──────────────────────────────────────────────
   registerCodeIntelligenceSettings(pi);
   registerLspSettings(pi);
-  registerLspSessionLifecycle(pi, lspState);
-  registerWorkspaceRecoveryHandler(pi, lspState);
-  registerTsSessionLifecycle(pi, tsState);
-
-  // ── Attach controller refs to sessions on startup (ADR 0008) ──────
-  pi.on("session_start", (_event, ctx) => {
+  registerLspSessionLifecycle(pi, lspState, (ctx) => {
     const session = app.getSession(ctx.cwd);
     if (!session) return;
     session.attachLspController(lspState.controller);
     session.seedSentinelSnapshot(lspState.sentinelSnapshot);
     session.setProjectTrusted(ctx.isProjectTrusted());
   });
+  registerWorkspaceRecoveryHandler(pi, lspState);
 
-  // ── Tool registration ─────────────────────────────────────────────
   registerCodeIntelligenceTools(
     pi,
     getOrCreateSession ?? ((cwd) => app.getSession(cwd) ?? app.createSession(cwd)),
   );
 
-  // ── UI registration ───────────────────────────────────────────────
   registerCiStatusCommand(pi);
   registerLspFooterContribution(lspState);
 
-  // ── Native context path capture for instruction-file dedup ─────────
   pi.on("before_agent_start", (event, ctx) => {
     const session = app.getSession(ctx.cwd) ?? app.createSession(ctx.cwd);
     session.captureNativeInstructionPaths(event.systemPromptOptions.contextFiles ?? []);
   });
 
-  // ── Overview injection — uses the app-managed session state ────────
   pi.on(
     "before_agent_start",
     async (_event, ctx): Promise<BeforeAgentStartEventResult | undefined> => {
       const session = app.getSession(ctx.cwd);
-      if (!session) return;
-      if (!session.claimOverviewInjection()) return;
+      if (!session?.claimOverviewInjection()) return;
 
       const model = await buildArchitectureModel(ctx.cwd);
       if (model.modules.length === 0) return;
@@ -138,24 +76,8 @@ export default function codeIntelligenceExtension(
       }
 
       return {
-        message: {
-          customType: OVERVIEW_CUSTOM_TYPE,
-          display: false,
-          content: overview,
-        },
+        message: { customType: OVERVIEW_CUSTOM_TYPE, display: false, content: overview },
       };
     },
   );
-
-  // ── Process-exit safety net ─────────────────────────────────────────
-  let cleaningUp = false;
-  const unregisterExitSafetyNet = registerProcessExitSafetyNet(() => {
-    if (cleaningUp) return;
-    cleaningUp = true;
-    // Exit handlers cannot await. Controller shutdown begins synchronous
-    // process cleanup before its first await.
-    void lspState.controller?.shutdown();
-    void tsState.controller?.shutdown();
-  });
-  pi.on("session_shutdown", unregisterExitSafetyNet);
 }

package/src/headless.ts

@@ -0,0 +1,41 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { createSessionCache } from "./app/app.ts";
+import { registerLspSessionLifecycle } from "./substrate/lsp/lifecycle.ts";
+import { createLspAdapterState } from "./substrate/lsp/state.ts";
+import { registerCodeIntelligenceTools } from "./tool/register.ts";
+import { CODE_INTELLIGENCE_TOOL_SPECS } from "./tool/specs.ts";
+
+/** Exact Code Intelligence tool surface available to managed Reviewer Sessions. */
+export const HEADLESS_INSPECTION_TOOL_NAMES = [
+  "code_resolve",
+  "code_inspect",
+  "code_orientation",
+  "code_graph",
+  "code_find",
+  "code_health",
+] as const;
+
+const inspectionToolNames = new Set<string>(HEADLESS_INSPECTION_TOOL_NAMES);
+
+/**
+ * Register the managed-child profile: six inspection tools backed by the shared
+ * Workspace provider host, without refactors, settings, UI, or overview state.
+ */
+export default function headlessInspectionProfile(pi: ExtensionAPI): void {
+  const sessions = createSessionCache();
+  const lspState = createLspAdapterState();
+  registerLspSessionLifecycle(pi, lspState, (ctx) => {
+    const session = sessions.getOrCreate(ctx.cwd);
+    session.attachLspController(lspState.controller);
+    session.seedSentinelSnapshot(lspState.sentinelSnapshot);
+    session.setProjectTrusted(ctx.isProjectTrusted());
+  });
+  pi.on("session_shutdown", () => sessions.clear());
+
+  registerCodeIntelligenceTools(
+    pi,
+    sessions.getOrCreate,
+    undefined,
+    CODE_INTELLIGENCE_TOOL_SPECS.filter((spec) => inspectionToolNames.has(spec.name)),
+  );
+}

package/src/substrate/lsp/lifecycle.ts

@@ -1,53 +1,39 @@
-// LSP session lifecycle — uses LspRuntimeController from @mrclrchtr/supi-lsp/api.
-//
-// Registers session_start and session_shutdown handlers that manage
-// the LspRuntimeController lifecycle.
+// LSP lifecycle backed by the process-shared Workspace provider host.
 
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { getDefaultWorkspaceRuntime } from "@mrclrchtr/supi-code-runtime/api";
-import { LspRuntimeController, scanWorkspaceSentinels } from "@mrclrchtr/supi-lsp/api";
 import { unregisterLspFooterContribution } from "../../ui/footer.ts";
+import { acquireWorkspaceProviderHost } from "../workspace-provider-host.ts";
 import type { LspAdapterState } from "./state.ts";
 
-export function registerLspSessionLifecycle(pi: ExtensionAPI, state: LspAdapterState): void {
+/** Acquire providers once per workspace and release them after the final Pi session ends. */
+export function registerLspSessionLifecycle(
+  pi: ExtensionAPI,
+  state: LspAdapterState,
+  onStarted?: (ctx: ExtensionContext) => void | Promise<void>,
+): void {
   pi.on("session_start", async (_event, ctx: ExtensionContext) => {
-    const cwd = ctx.cwd;
-    const runtime = getDefaultWorkspaceRuntime();
-
-    if (state.controller) {
-      await state.controller.shutdown();
-      state.controller = null;
-    }
+    await state.providerLease?.release();
+    state.providerLease = null;
+    state.controller = null;
     state.lspActive = false;
+    state.sentinelSnapshot = new Map();
 
-    // Project-local LSP configuration may define custom commands; defer
-    // until the project is trusted so an untrusted repository cannot control
-    // spawned processes.
-    if (!ctx.isProjectTrusted()) {
-      state.controller = null;
-      state.lspActive = false;
-      return;
-    }
-
-    const controller = new LspRuntimeController(cwd, runtime);
-    const result = await controller.start();
-
-    if (result.kind === "ready") {
-      state.controller = controller;
-      state.lspActive = true;
-      state.sentinelSnapshot = scanWorkspaceSentinels(cwd);
-    } else {
-      state.controller = null;
-      state.lspActive = false;
-    }
+    const lease = await acquireWorkspaceProviderHost(ctx.cwd, {
+      projectTrusted: ctx.isProjectTrusted(),
+    });
+    state.providerLease = lease;
+    state.controller = lease.lspController;
+    state.lspActive = lease.lspController?.kind === "ready";
+    state.sentinelSnapshot = lease.sentinelSnapshot;
+    await onStarted?.(ctx);
   });
 
-  pi.on("session_shutdown", async (_event, _ctx: ExtensionContext) => {
-    if (state.controller) {
-      await state.controller.shutdown();
-      state.controller = null;
-    }
+  pi.on("session_shutdown", async () => {
+    await state.providerLease?.release();
+    state.providerLease = null;
+    state.controller = null;
     state.lspActive = false;
+    state.sentinelSnapshot = new Map();
     unregisterLspFooterContribution();
   });
 }

package/src/substrate/lsp/state.ts

@@ -4,6 +4,7 @@
 // through LspRuntimeController from @mrclrchtr/supi-lsp/api.
 
 import type { LspRuntimeController } from "@mrclrchtr/supi-lsp/api";
+import type { WorkspaceProviderHostLease } from "../workspace-provider-host.ts";
 
 /** LSP status overlay UI state (handle + close). */
 export interface LspInspectorState {
@@ -19,6 +20,7 @@ export interface LspInspectorState {
  */
 export interface LspAdapterState {
   controller: LspRuntimeController | null;
+  providerLease: WorkspaceProviderHostLease | null;
   inspector: LspInspectorState;
   lspActive: boolean;
   /** Snapshot of workspace sentinel files (package.json, tsconfig, lockfiles) for change detection. */
@@ -28,6 +30,7 @@ export interface LspAdapterState {
 export function createLspAdapterState(): LspAdapterState {
   return {
     controller: null,
+    providerLease: null,
     inspector: { handle: null, close: null },
     lspActive: false,
     sentinelSnapshot: new Map(),

package/src/substrate/workspace-provider-host.ts

@@ -0,0 +1,129 @@
+import { realpathSync } from "node:fs";
+import { resolve } from "node:path";
+import { getDefaultWorkspaceRuntime } from "@mrclrchtr/supi-code-runtime/api";
+import { LspRuntimeController, scanWorkspaceSentinels } from "@mrclrchtr/supi-lsp/api";
+import { TreeSitterRuntimeController } from "@mrclrchtr/supi-tree-sitter/api";
+
+const HOSTS = Symbol.for("supi-code-intelligence/workspace-provider-hosts");
+const SHUTDOWN_GRACE_MS = 2_000;
+
+type HostRegistry = Map<string, WorkspaceProviderHost>;
+
+/** One acquired reference to a process-shared Workspace provider host. */
+export interface WorkspaceProviderHostLease {
+  cwd: string;
+  lspController: LspRuntimeController | null;
+  sentinelSnapshot: Map<string, number>;
+  release(): Promise<void>;
+}
+
+function registry(): HostRegistry {
+  const global = globalThis as typeof globalThis & { [HOSTS]?: HostRegistry };
+  global[HOSTS] ??= new Map();
+  return global[HOSTS];
+}
+
+function canonicalWorkspace(cwd: string): string {
+  try {
+    return realpathSync(cwd);
+  } catch {
+    return resolve(cwd);
+  }
+}
+
+function settleWithin(operation: Promise<void>): Promise<void> {
+  return Promise.race([
+    operation.catch(() => undefined),
+    new Promise<void>((resolveGrace) => {
+      const timeout = setTimeout(resolveGrace, SHUTDOWN_GRACE_MS);
+      timeout.unref?.();
+    }),
+  ]);
+}
+
+class WorkspaceProviderHost {
+  readonly cwd: string;
+  #leases = 0;
+  #lsp: LspRuntimeController | null = null;
+  #tree: TreeSitterRuntimeController | null = null;
+  #treeStarted = false;
+  #lspStarted = false;
+  #settledStart = Promise.resolve();
+  #closed = false;
+
+  constructor(cwd: string) {
+    this.cwd = cwd;
+  }
+
+  async acquire(projectTrusted: boolean): Promise<WorkspaceProviderHostLease> {
+    if (this.#closed) throw new Error("Workspace provider host is closed.");
+    // Count this pending acquirer before awaiting startup so the final active lease cannot shut it down.
+    this.#leases++;
+    this.#settledStart = this.#settledStart
+      .then(() => this.#startMissing(projectTrusted))
+      .catch(() => undefined);
+    await this.#settledStart;
+    let released = false;
+    return {
+      cwd: this.cwd,
+      lspController: projectTrusted ? this.#lsp : null,
+      sentinelSnapshot:
+        projectTrusted && this.#lsp?.kind === "ready"
+          ? scanWorkspaceSentinels(this.cwd)
+          : new Map(),
+      release: async () => {
+        if (released) return;
+        released = true;
+        this.#leases--;
+        if (this.#leases === 0) {
+          registry().delete(this.cwd);
+          await this.#shutdown();
+        }
+      },
+    };
+  }
+
+  async #startMissing(projectTrusted: boolean): Promise<void> {
+    const runtime = getDefaultWorkspaceRuntime();
+    if (!this.#treeStarted) {
+      this.#treeStarted = true;
+      this.#tree = new TreeSitterRuntimeController(this.cwd, runtime);
+      await this.#tree.start().catch(() => undefined);
+    }
+    if (!projectTrusted || this.#lspStarted) return;
+    this.#lspStarted = true;
+    this.#lsp = new LspRuntimeController(this.cwd, runtime);
+    await this.#lsp.start().catch(() => undefined);
+  }
+
+  async #shutdown(): Promise<void> {
+    if (this.#closed) return;
+    this.#closed = true;
+    await Promise.all([
+      ...(this.#lsp ? [settleWithin(this.#lsp.shutdown())] : []),
+      ...(this.#tree ? [settleWithin(this.#tree.shutdown())] : []),
+    ]);
+    this.#lsp = null;
+    this.#tree = null;
+  }
+}
+
+/** Acquire shared semantic and structural providers for one canonical workspace. */
+export async function acquireWorkspaceProviderHost(
+  cwd: string,
+  options: { projectTrusted: boolean },
+): Promise<WorkspaceProviderHostLease> {
+  const workspace = canonicalWorkspace(cwd);
+  const hosts = registry();
+  let host = hosts.get(workspace);
+  if (!host) {
+    host = new WorkspaceProviderHost(workspace);
+    hosts.set(workspace, host);
+  }
+  return host.acquire(options.projectTrusted);
+}
+
+/** Clear process-shared hosts between isolated tests. */
+export function resetWorkspaceProviderHostsForTests(): void {
+  registry().clear();
+}

package/src/substrate/tree-sitter/lifecycle.ts

@@ -1,52 +0,0 @@
-// Tree-sitter session lifecycle — uses TreeSitterRuntimeController from @mrclrchtr/supi-tree-sitter/api.
-
-import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { getDefaultWorkspaceRuntime } from "@mrclrchtr/supi-code-runtime/api";
-import { TreeSitterRuntimeController } from "@mrclrchtr/supi-tree-sitter/api";
-
-/**
- * Tree-sitter adapter state for the umbrella extension.
- */
-export interface TsAdapterState {
-  controller: TreeSitterRuntimeController | null;
-}
-
-export function createTsAdapterState(): TsAdapterState {
-  return { controller: null };
-}
-
-/**
- * Register Tree-sitter session lifecycle handlers.
- *
- * - session_start: creates TreeSitterRuntimeController, starts it, registers tools
- * - session_shutdown: shuts down the controller
- */
-export function registerTsSessionLifecycle(pi: ExtensionAPI, state: TsAdapterState): void {
-  pi.on("session_start", async (_event, ctx: ExtensionContext) => {
-    const cwd = ctx.cwd;
-    const runtime = getDefaultWorkspaceRuntime();
-
-    // Shut down any existing controller
-    if (state.controller) {
-      await state.controller.shutdown();
-      state.controller = null;
-    }
-
-    const controller = new TreeSitterRuntimeController(cwd, runtime);
-    const result = await controller.start();
-
-    if (result.kind === "ready") {
-      state.controller = controller;
-    } else {
-      await controller.shutdown();
-      state.controller = null;
-    }
-  });
-
-  pi.on("session_shutdown", async () => {
-    if (state.controller) {
-      await state.controller.shutdown();
-      state.controller = null;
-    }
-  });
-}