@mrclrchtr/supi-code-intelligence 4.5.1 → 4.7.0

package/README.md

@@ -1,8 +1,6 @@
 <div align="center">
   <a href="https://github.com/mrclrchtr/supi/tree/main/packages/supi-code-intelligence">
-    <picture>
-      <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-code-intelligence/assets/social-preview.png" alt="SuPi Code Intelligence" width="100%">
-    </picture>
+    <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-code-intelligence/assets/social-preview.png" alt="SuPi Code Intelligence" width="100%">
   </a>
 </div>
 

package/node_modules/@mrclrchtr/supi-code-runtime/README.md

@@ -8,7 +8,7 @@
 
 Shared workspace context, capability contracts, and canonical types for the SuPi code-understanding stack.
 
-This is a **library-only package** — it has no pi extension surface, no user-facing tools, and no UI. It provides the shared abstractions that `supi-lsp`, `supi-tree-sitter`, and `supi-code-intelligence` use to communicate capability availability.
+This is a **library-only package** — it has no pi extension surface, no user-facing tools, and no UI. It is not installed directly — `supi-lsp`, `supi-tree-sitter`, and `supi-code-intelligence` bundle it and use its shared abstractions to communicate capability availability.
 
 ## Package surfaces
 

package/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/README.md

@@ -1,8 +1,6 @@
 <div align="center">
   <a href="https://github.com/mrclrchtr/supi/tree/main/packages/supi-core">
-    <picture>
-      <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
-    </picture>
+    <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
   </a>
 </div>
 

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

@@ -1,7 +1,7 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "4.5.1",
-  "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
+  "version": "4.7.0",
+  "description": "Shared settings, configuration, reporting, and session infrastructure",
   "license": "MIT",
   "repository": {
     "type": "git",

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

@@ -64,6 +64,9 @@ export interface DebugEventQueryResult {
   rawAccessDenied: boolean;
 }
 
+/** Receives a sanitized event whenever the registry records one. */
+export type DebugEventListener = (event: DebugEventView) => void;
+
 export interface DebugSummary {
   total: number;
   byLevel: Partial<Record<DebugLevel, number>>;
@@ -73,6 +76,7 @@ export interface DebugSummary {
 interface DebugRegistryState {
   config: DebugRegistryConfig;
   events: DebugEvent[];
+  listeners: Set<DebugEventListener>;
   nextId: number;
 }
 
@@ -97,10 +101,14 @@ function getState(): DebugRegistryState {
     state = {
       config: cloneConfig(DEBUG_REGISTRY_DEFAULTS),
       events: [],
+      listeners: new Set(),
       nextId: 1,
     };
     (globalThis as Record<symbol, unknown>)[REGISTRY_KEY] = state;
   }
+  // Keep the shared registry compatible with extension reloads that reuse an
+  // instance created before listeners existed.
+  if (!state.listeners) state.listeners = new Set();
   return state;
 }
 
@@ -119,7 +127,16 @@ function trimToMaxEvents(state: DebugRegistryState): void {
   state.events.splice(0, state.events.length - maxEvents);
 }
 
-function matchesQuery(event: DebugEvent, query: DebugEventQuery): boolean {
+/** Return whether a debug level is recognized by the registry. */
+export function isDebugLevel(value: unknown): value is DebugLevel {
+  return value === "debug" || value === "info" || value === "warning" || value === "error";
+}
+
+/** Match a debug event against the supported source, level, and category filters. */
+export function matchesDebugEventQuery(
+  event: Pick<DebugEventView, "source" | "level" | "category">,
+  query: Pick<DebugEventQuery, "source" | "level" | "category">,
+): boolean {
   if (query.source && event.source !== query.source) return false;
   if (query.level && event.level !== query.level) return false;
   if (query.category && event.category !== query.category) return false;
@@ -168,6 +185,26 @@ export function redactDebugData<T>(value: T): T {
   return redactValue(value, 8) as T;
 }
 
+function toSanitizedView(event: DebugEvent): DebugEventView {
+  return {
+    id: event.id,
+    timestamp: event.timestamp,
+    source: event.source,
+    level: event.level,
+    category: event.category,
+    message: event.message,
+    cwd: event.cwd,
+    data: event.data,
+  };
+}
+
+/** Subscribe to sanitized events. Listeners are isolated so diagnostics cannot disrupt producers. */
+export function subscribeDebugEvents(listener: DebugEventListener): () => void {
+  const state = getState();
+  state.listeners.add(listener);
+  return () => state.listeners.delete(listener);
+}
+
 /** Record a session-local debug event if debugging is enabled. */
 export function recordDebugEvent(input: DebugEventInput): DebugEvent | null {
   const state = getState();
@@ -183,6 +220,14 @@ export function recordDebugEvent(input: DebugEventInput): DebugEvent | null {
   };
   state.events.push(event);
   trimToMaxEvents(state);
+  const view = toSanitizedView(event);
+  for (const listener of state.listeners) {
+    try {
+      listener(view);
+    } catch {
+      // Debug-event consumers must not alter producer behavior.
+    }
+  }
   return { ...event };
 }
 
@@ -196,21 +241,12 @@ export function getDebugEvents(query: DebugEventQuery = {}): DebugEventQueryResu
   const limit = query.limit && query.limit > 0 ? Math.floor(query.limit) : state.config.maxEvents;
 
   const events = state.events
-    .filter((event) => matchesQuery(event, query))
+    .filter((event) => matchesDebugEventQuery(event, query))
     .slice()
     .reverse()
     .slice(0, limit)
     .map((event): DebugEventView => {
-      const view: DebugEventView = {
-        id: event.id,
-        timestamp: event.timestamp,
-        source: event.source,
-        level: event.level,
-        category: event.category,
-        message: event.message,
-        cwd: event.cwd,
-        data: event.data,
-      };
+      const view = toSanitizedView(event);
       if (allowRaw && event.rawData !== undefined) {
         view.rawData = event.rawData;
       }
@@ -246,5 +282,6 @@ export function resetDebugRegistry(): void {
   const state = getState();
   state.config = cloneConfig(DEBUG_REGISTRY_DEFAULTS);
   state.events = [];
+  state.listeners.clear();
   state.nextId = 1;
 }

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

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

package/node_modules/@mrclrchtr/supi-core/README.md

@@ -1,8 +1,6 @@
 <div align="center">
   <a href="https://github.com/mrclrchtr/supi/tree/main/packages/supi-core">
-    <picture>
-      <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
-    </picture>
+    <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
   </a>
 </div>
 

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

@@ -1,7 +1,7 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "4.5.1",
-  "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
+  "version": "4.7.0",
+  "description": "Shared settings, configuration, reporting, and session infrastructure",
   "license": "MIT",
   "repository": {
     "type": "git",

package/node_modules/@mrclrchtr/supi-core/src/debug-registry.ts

@@ -64,6 +64,9 @@ export interface DebugEventQueryResult {
   rawAccessDenied: boolean;
 }
 
+/** Receives a sanitized event whenever the registry records one. */
+export type DebugEventListener = (event: DebugEventView) => void;
+
 export interface DebugSummary {
   total: number;
   byLevel: Partial<Record<DebugLevel, number>>;
@@ -73,6 +76,7 @@ export interface DebugSummary {
 interface DebugRegistryState {
   config: DebugRegistryConfig;
   events: DebugEvent[];
+  listeners: Set<DebugEventListener>;
   nextId: number;
 }
 
@@ -97,10 +101,14 @@ function getState(): DebugRegistryState {
     state = {
       config: cloneConfig(DEBUG_REGISTRY_DEFAULTS),
       events: [],
+      listeners: new Set(),
       nextId: 1,
     };
     (globalThis as Record<symbol, unknown>)[REGISTRY_KEY] = state;
   }
+  // Keep the shared registry compatible with extension reloads that reuse an
+  // instance created before listeners existed.
+  if (!state.listeners) state.listeners = new Set();
   return state;
 }
 
@@ -119,7 +127,16 @@ function trimToMaxEvents(state: DebugRegistryState): void {
   state.events.splice(0, state.events.length - maxEvents);
 }
 
-function matchesQuery(event: DebugEvent, query: DebugEventQuery): boolean {
+/** Return whether a debug level is recognized by the registry. */
+export function isDebugLevel(value: unknown): value is DebugLevel {
+  return value === "debug" || value === "info" || value === "warning" || value === "error";
+}
+
+/** Match a debug event against the supported source, level, and category filters. */
+export function matchesDebugEventQuery(
+  event: Pick<DebugEventView, "source" | "level" | "category">,
+  query: Pick<DebugEventQuery, "source" | "level" | "category">,
+): boolean {
   if (query.source && event.source !== query.source) return false;
   if (query.level && event.level !== query.level) return false;
   if (query.category && event.category !== query.category) return false;
@@ -168,6 +185,26 @@ export function redactDebugData<T>(value: T): T {
   return redactValue(value, 8) as T;
 }
 
+function toSanitizedView(event: DebugEvent): DebugEventView {
+  return {
+    id: event.id,
+    timestamp: event.timestamp,
+    source: event.source,
+    level: event.level,
+    category: event.category,
+    message: event.message,
+    cwd: event.cwd,
+    data: event.data,
+  };
+}
+
+/** Subscribe to sanitized events. Listeners are isolated so diagnostics cannot disrupt producers. */
+export function subscribeDebugEvents(listener: DebugEventListener): () => void {
+  const state = getState();
+  state.listeners.add(listener);
+  return () => state.listeners.delete(listener);
+}
+
 /** Record a session-local debug event if debugging is enabled. */
 export function recordDebugEvent(input: DebugEventInput): DebugEvent | null {
   const state = getState();
@@ -183,6 +220,14 @@ export function recordDebugEvent(input: DebugEventInput): DebugEvent | null {
   };
   state.events.push(event);
   trimToMaxEvents(state);
+  const view = toSanitizedView(event);
+  for (const listener of state.listeners) {
+    try {
+      listener(view);
+    } catch {
+      // Debug-event consumers must not alter producer behavior.
+    }
+  }
   return { ...event };
 }
 
@@ -196,21 +241,12 @@ export function getDebugEvents(query: DebugEventQuery = {}): DebugEventQueryResu
   const limit = query.limit && query.limit > 0 ? Math.floor(query.limit) : state.config.maxEvents;
 
   const events = state.events
-    .filter((event) => matchesQuery(event, query))
+    .filter((event) => matchesDebugEventQuery(event, query))
     .slice()
     .reverse()
     .slice(0, limit)
     .map((event): DebugEventView => {
-      const view: DebugEventView = {
-        id: event.id,
-        timestamp: event.timestamp,
-        source: event.source,
-        level: event.level,
-        category: event.category,
-        message: event.message,
-        cwd: event.cwd,
-        data: event.data,
-      };
+      const view = toSanitizedView(event);
       if (allowRaw && event.rawData !== undefined) {
         view.rawData = event.rawData;
       }
@@ -246,5 +282,6 @@ export function resetDebugRegistry(): void {
   const state = getState();
   state.config = cloneConfig(DEBUG_REGISTRY_DEFAULTS);
   state.events = [];
+  state.listeners.clear();
   state.nextId = 1;
 }

package/node_modules/@mrclrchtr/supi-lsp/README.md

@@ -1,8 +1,6 @@
 <div align="center">
   <a href="https://github.com/mrclrchtr/supi/tree/main/packages/supi-lsp">
-    <picture>
-      <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-lsp/assets/social-preview.png" alt="SuPi LSP" width="100%">
-    </picture>
+    <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-lsp/assets/social-preview.png" alt="SuPi LSP" width="100%">
   </a>
 </div>
 

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-code-runtime/README.md

@@ -8,7 +8,7 @@
 
 Shared workspace context, capability contracts, and canonical types for the SuPi code-understanding stack.
 
-This is a **library-only package** — it has no pi extension surface, no user-facing tools, and no UI. It provides the shared abstractions that `supi-lsp`, `supi-tree-sitter`, and `supi-code-intelligence` use to communicate capability availability.
+This is a **library-only package** — it has no pi extension surface, no user-facing tools, and no UI. It is not installed directly — `supi-lsp`, `supi-tree-sitter`, and `supi-code-intelligence` bundle it and use its shared abstractions to communicate capability availability.
 
 ## Package surfaces
 

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

@@ -1,8 +1,6 @@
 <div align="center">
   <a href="https://github.com/mrclrchtr/supi/tree/main/packages/supi-core">
-    <picture>
-      <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
-    </picture>
+    <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
   </a>
 </div>
 

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

@@ -1,7 +1,7 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "4.5.1",
-  "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
+  "version": "4.7.0",
+  "description": "Shared settings, configuration, reporting, and session infrastructure",
   "license": "MIT",
   "repository": {
     "type": "git",

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

@@ -64,6 +64,9 @@ export interface DebugEventQueryResult {
   rawAccessDenied: boolean;
 }
 
+/** Receives a sanitized event whenever the registry records one. */
+export type DebugEventListener = (event: DebugEventView) => void;
+
 export interface DebugSummary {
   total: number;
   byLevel: Partial<Record<DebugLevel, number>>;
@@ -73,6 +76,7 @@ export interface DebugSummary {
 interface DebugRegistryState {
   config: DebugRegistryConfig;
   events: DebugEvent[];
+  listeners: Set<DebugEventListener>;
   nextId: number;
 }
 
@@ -97,10 +101,14 @@ function getState(): DebugRegistryState {
     state = {
       config: cloneConfig(DEBUG_REGISTRY_DEFAULTS),
       events: [],
+      listeners: new Set(),
       nextId: 1,
     };
     (globalThis as Record<symbol, unknown>)[REGISTRY_KEY] = state;
   }
+  // Keep the shared registry compatible with extension reloads that reuse an
+  // instance created before listeners existed.
+  if (!state.listeners) state.listeners = new Set();
   return state;
 }
 
@@ -119,7 +127,16 @@ function trimToMaxEvents(state: DebugRegistryState): void {
   state.events.splice(0, state.events.length - maxEvents);
 }
 
-function matchesQuery(event: DebugEvent, query: DebugEventQuery): boolean {
+/** Return whether a debug level is recognized by the registry. */
+export function isDebugLevel(value: unknown): value is DebugLevel {
+  return value === "debug" || value === "info" || value === "warning" || value === "error";
+}
+
+/** Match a debug event against the supported source, level, and category filters. */
+export function matchesDebugEventQuery(
+  event: Pick<DebugEventView, "source" | "level" | "category">,
+  query: Pick<DebugEventQuery, "source" | "level" | "category">,
+): boolean {
   if (query.source && event.source !== query.source) return false;
   if (query.level && event.level !== query.level) return false;
   if (query.category && event.category !== query.category) return false;
@@ -168,6 +185,26 @@ export function redactDebugData<T>(value: T): T {
   return redactValue(value, 8) as T;
 }
 
+function toSanitizedView(event: DebugEvent): DebugEventView {
+  return {
+    id: event.id,
+    timestamp: event.timestamp,
+    source: event.source,
+    level: event.level,
+    category: event.category,
+    message: event.message,
+    cwd: event.cwd,
+    data: event.data,
+  };
+}
+
+/** Subscribe to sanitized events. Listeners are isolated so diagnostics cannot disrupt producers. */
+export function subscribeDebugEvents(listener: DebugEventListener): () => void {
+  const state = getState();
+  state.listeners.add(listener);
+  return () => state.listeners.delete(listener);
+}
+
 /** Record a session-local debug event if debugging is enabled. */
 export function recordDebugEvent(input: DebugEventInput): DebugEvent | null {
   const state = getState();
@@ -183,6 +220,14 @@ export function recordDebugEvent(input: DebugEventInput): DebugEvent | null {
   };
   state.events.push(event);
   trimToMaxEvents(state);
+  const view = toSanitizedView(event);
+  for (const listener of state.listeners) {
+    try {
+      listener(view);
+    } catch {
+      // Debug-event consumers must not alter producer behavior.
+    }
+  }
   return { ...event };
 }
 
@@ -196,21 +241,12 @@ export function getDebugEvents(query: DebugEventQuery = {}): DebugEventQueryResu
   const limit = query.limit && query.limit > 0 ? Math.floor(query.limit) : state.config.maxEvents;
 
   const events = state.events
-    .filter((event) => matchesQuery(event, query))
+    .filter((event) => matchesDebugEventQuery(event, query))
     .slice()
     .reverse()
     .slice(0, limit)
     .map((event): DebugEventView => {
-      const view: DebugEventView = {
-        id: event.id,
-        timestamp: event.timestamp,
-        source: event.source,
-        level: event.level,
-        category: event.category,
-        message: event.message,
-        cwd: event.cwd,
-        data: event.data,
-      };
+      const view = toSanitizedView(event);
       if (allowRaw && event.rawData !== undefined) {
         view.rawData = event.rawData;
       }
@@ -246,5 +282,6 @@ export function resetDebugRegistry(): void {
   const state = getState();
   state.config = cloneConfig(DEBUG_REGISTRY_DEFAULTS);
   state.events = [];
+  state.listeners.clear();
   state.nextId = 1;
 }

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

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

package/node_modules/@mrclrchtr/supi-lsp/node_modules/@mrclrchtr/supi-core/README.md

@@ -1,8 +1,6 @@
 <div align="center">
   <a href="https://github.com/mrclrchtr/supi/tree/main/packages/supi-core">
-    <picture>
-      <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
-    </picture>
+    <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
   </a>
 </div>
 

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

@@ -1,7 +1,7 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "4.5.1",
-  "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
+  "version": "4.7.0",
+  "description": "Shared settings, configuration, reporting, and session infrastructure",
   "license": "MIT",
   "repository": {
     "type": "git",

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

@@ -64,6 +64,9 @@ export interface DebugEventQueryResult {
   rawAccessDenied: boolean;
 }
 
+/** Receives a sanitized event whenever the registry records one. */
+export type DebugEventListener = (event: DebugEventView) => void;
+
 export interface DebugSummary {
   total: number;
   byLevel: Partial<Record<DebugLevel, number>>;
@@ -73,6 +76,7 @@ export interface DebugSummary {
 interface DebugRegistryState {
   config: DebugRegistryConfig;
   events: DebugEvent[];
+  listeners: Set<DebugEventListener>;
   nextId: number;
 }
 
@@ -97,10 +101,14 @@ function getState(): DebugRegistryState {
     state = {
       config: cloneConfig(DEBUG_REGISTRY_DEFAULTS),
       events: [],
+      listeners: new Set(),
       nextId: 1,
     };
     (globalThis as Record<symbol, unknown>)[REGISTRY_KEY] = state;
   }
+  // Keep the shared registry compatible with extension reloads that reuse an
+  // instance created before listeners existed.
+  if (!state.listeners) state.listeners = new Set();
   return state;
 }
 
@@ -119,7 +127,16 @@ function trimToMaxEvents(state: DebugRegistryState): void {
   state.events.splice(0, state.events.length - maxEvents);
 }
 
-function matchesQuery(event: DebugEvent, query: DebugEventQuery): boolean {
+/** Return whether a debug level is recognized by the registry. */
+export function isDebugLevel(value: unknown): value is DebugLevel {
+  return value === "debug" || value === "info" || value === "warning" || value === "error";
+}
+
+/** Match a debug event against the supported source, level, and category filters. */
+export function matchesDebugEventQuery(
+  event: Pick<DebugEventView, "source" | "level" | "category">,
+  query: Pick<DebugEventQuery, "source" | "level" | "category">,
+): boolean {
   if (query.source && event.source !== query.source) return false;
   if (query.level && event.level !== query.level) return false;
   if (query.category && event.category !== query.category) return false;
@@ -168,6 +185,26 @@ export function redactDebugData<T>(value: T): T {
   return redactValue(value, 8) as T;
 }
 
+function toSanitizedView(event: DebugEvent): DebugEventView {
+  return {
+    id: event.id,
+    timestamp: event.timestamp,
+    source: event.source,
+    level: event.level,
+    category: event.category,
+    message: event.message,
+    cwd: event.cwd,
+    data: event.data,
+  };
+}
+
+/** Subscribe to sanitized events. Listeners are isolated so diagnostics cannot disrupt producers. */
+export function subscribeDebugEvents(listener: DebugEventListener): () => void {
+  const state = getState();
+  state.listeners.add(listener);
+  return () => state.listeners.delete(listener);
+}
+
 /** Record a session-local debug event if debugging is enabled. */
 export function recordDebugEvent(input: DebugEventInput): DebugEvent | null {
   const state = getState();
@@ -183,6 +220,14 @@ export function recordDebugEvent(input: DebugEventInput): DebugEvent | null {
   };
   state.events.push(event);
   trimToMaxEvents(state);
+  const view = toSanitizedView(event);
+  for (const listener of state.listeners) {
+    try {
+      listener(view);
+    } catch {
+      // Debug-event consumers must not alter producer behavior.
+    }
+  }
   return { ...event };
 }
 
@@ -196,21 +241,12 @@ export function getDebugEvents(query: DebugEventQuery = {}): DebugEventQueryResu
   const limit = query.limit && query.limit > 0 ? Math.floor(query.limit) : state.config.maxEvents;
 
   const events = state.events
-    .filter((event) => matchesQuery(event, query))
+    .filter((event) => matchesDebugEventQuery(event, query))
     .slice()
     .reverse()
     .slice(0, limit)
     .map((event): DebugEventView => {
-      const view: DebugEventView = {
-        id: event.id,
-        timestamp: event.timestamp,
-        source: event.source,
-        level: event.level,
-        category: event.category,
-        message: event.message,
-        cwd: event.cwd,
-        data: event.data,
-      };
+      const view = toSanitizedView(event);
       if (allowRaw && event.rawData !== undefined) {
         view.rawData = event.rawData;
       }
@@ -246,5 +282,6 @@ export function resetDebugRegistry(): void {
   const state = getState();
   state.config = cloneConfig(DEBUG_REGISTRY_DEFAULTS);
   state.events = [];
+  state.listeners.clear();
   state.nextId = 1;
 }

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

@@ -1,7 +1,7 @@
 {
   "name": "@mrclrchtr/supi-lsp",
-  "version": "4.5.1",
-  "description": "SuPi LSP runtime — Language Server Protocol integration library for pi",
+  "version": "4.7.0",
+  "description": "Language Server Protocol runtime for SuPi code intelligence",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -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.5.1",
-    "@mrclrchtr/supi-core": "4.5.1"
+    "@mrclrchtr/supi-code-runtime": "4.7.0",
+    "@mrclrchtr/supi-core": "4.7.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-code-runtime",

package/node_modules/@mrclrchtr/supi-tree-sitter/README.md

@@ -1,8 +1,6 @@
 <div align="center">
   <a href="https://github.com/mrclrchtr/supi/tree/main/packages/supi-tree-sitter">
-    <picture>
-      <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-tree-sitter/assets/social-preview.png" alt="SuPi Tree-sitter" width="100%">
-    </picture>
+    <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-tree-sitter/assets/social-preview.png" alt="SuPi Tree-sitter" width="100%">
   </a>
 </div>
 

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

@@ -8,7 +8,7 @@
 
 Shared workspace context, capability contracts, and canonical types for the SuPi code-understanding stack.
 
-This is a **library-only package** — it has no pi extension surface, no user-facing tools, and no UI. It provides the shared abstractions that `supi-lsp`, `supi-tree-sitter`, and `supi-code-intelligence` use to communicate capability availability.
+This is a **library-only package** — it has no pi extension surface, no user-facing tools, and no UI. It is not installed directly — `supi-lsp`, `supi-tree-sitter`, and `supi-code-intelligence` bundle it and use its shared abstractions to communicate capability availability.
 
 ## Package surfaces
 

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

@@ -1,8 +1,6 @@
 <div align="center">
   <a href="https://github.com/mrclrchtr/supi/tree/main/packages/supi-core">
-    <picture>
-      <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
-    </picture>
+    <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
   </a>
 </div>
 

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

@@ -1,7 +1,7 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "4.5.1",
-  "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
+  "version": "4.7.0",
+  "description": "Shared settings, configuration, reporting, and session infrastructure",
   "license": "MIT",
   "repository": {
     "type": "git",

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

@@ -64,6 +64,9 @@ export interface DebugEventQueryResult {
   rawAccessDenied: boolean;
 }
 
+/** Receives a sanitized event whenever the registry records one. */
+export type DebugEventListener = (event: DebugEventView) => void;
+
 export interface DebugSummary {
   total: number;
   byLevel: Partial<Record<DebugLevel, number>>;
@@ -73,6 +76,7 @@ export interface DebugSummary {
 interface DebugRegistryState {
   config: DebugRegistryConfig;
   events: DebugEvent[];
+  listeners: Set<DebugEventListener>;
   nextId: number;
 }
 
@@ -97,10 +101,14 @@ function getState(): DebugRegistryState {
     state = {
       config: cloneConfig(DEBUG_REGISTRY_DEFAULTS),
       events: [],
+      listeners: new Set(),
       nextId: 1,
     };
     (globalThis as Record<symbol, unknown>)[REGISTRY_KEY] = state;
   }
+  // Keep the shared registry compatible with extension reloads that reuse an
+  // instance created before listeners existed.
+  if (!state.listeners) state.listeners = new Set();
   return state;
 }
 
@@ -119,7 +127,16 @@ function trimToMaxEvents(state: DebugRegistryState): void {
   state.events.splice(0, state.events.length - maxEvents);
 }
 
-function matchesQuery(event: DebugEvent, query: DebugEventQuery): boolean {
+/** Return whether a debug level is recognized by the registry. */
+export function isDebugLevel(value: unknown): value is DebugLevel {
+  return value === "debug" || value === "info" || value === "warning" || value === "error";
+}
+
+/** Match a debug event against the supported source, level, and category filters. */
+export function matchesDebugEventQuery(
+  event: Pick<DebugEventView, "source" | "level" | "category">,
+  query: Pick<DebugEventQuery, "source" | "level" | "category">,
+): boolean {
   if (query.source && event.source !== query.source) return false;
   if (query.level && event.level !== query.level) return false;
   if (query.category && event.category !== query.category) return false;
@@ -168,6 +185,26 @@ export function redactDebugData<T>(value: T): T {
   return redactValue(value, 8) as T;
 }
 
+function toSanitizedView(event: DebugEvent): DebugEventView {
+  return {
+    id: event.id,
+    timestamp: event.timestamp,
+    source: event.source,
+    level: event.level,
+    category: event.category,
+    message: event.message,
+    cwd: event.cwd,
+    data: event.data,
+  };
+}
+
+/** Subscribe to sanitized events. Listeners are isolated so diagnostics cannot disrupt producers. */
+export function subscribeDebugEvents(listener: DebugEventListener): () => void {
+  const state = getState();
+  state.listeners.add(listener);
+  return () => state.listeners.delete(listener);
+}
+
 /** Record a session-local debug event if debugging is enabled. */
 export function recordDebugEvent(input: DebugEventInput): DebugEvent | null {
   const state = getState();
@@ -183,6 +220,14 @@ export function recordDebugEvent(input: DebugEventInput): DebugEvent | null {
   };
   state.events.push(event);
   trimToMaxEvents(state);
+  const view = toSanitizedView(event);
+  for (const listener of state.listeners) {
+    try {
+      listener(view);
+    } catch {
+      // Debug-event consumers must not alter producer behavior.
+    }
+  }
   return { ...event };
 }
 
@@ -196,21 +241,12 @@ export function getDebugEvents(query: DebugEventQuery = {}): DebugEventQueryResu
   const limit = query.limit && query.limit > 0 ? Math.floor(query.limit) : state.config.maxEvents;
 
   const events = state.events
-    .filter((event) => matchesQuery(event, query))
+    .filter((event) => matchesDebugEventQuery(event, query))
     .slice()
     .reverse()
     .slice(0, limit)
     .map((event): DebugEventView => {
-      const view: DebugEventView = {
-        id: event.id,
-        timestamp: event.timestamp,
-        source: event.source,
-        level: event.level,
-        category: event.category,
-        message: event.message,
-        cwd: event.cwd,
-        data: event.data,
-      };
+      const view = toSanitizedView(event);
       if (allowRaw && event.rawData !== undefined) {
         view.rawData = event.rawData;
       }
@@ -246,5 +282,6 @@ export function resetDebugRegistry(): void {
   const state = getState();
   state.config = cloneConfig(DEBUG_REGISTRY_DEFAULTS);
   state.events = [];
+  state.listeners.clear();
   state.nextId = 1;
 }

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

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

package/node_modules/@mrclrchtr/supi-tree-sitter/node_modules/@mrclrchtr/supi-core/README.md

@@ -1,8 +1,6 @@
 <div align="center">
   <a href="https://github.com/mrclrchtr/supi/tree/main/packages/supi-core">
-    <picture>
-      <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
-    </picture>
+    <img src="https://raw.githubusercontent.com/mrclrchtr/supi/main/packages/supi-core/assets/social-preview.png" alt="SuPi Core" width="100%">
   </a>
 </div>
 

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

@@ -1,7 +1,7 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "4.5.1",
-  "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
+  "version": "4.7.0",
+  "description": "Shared settings, configuration, reporting, and session infrastructure",
   "license": "MIT",
   "repository": {
     "type": "git",

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

@@ -64,6 +64,9 @@ export interface DebugEventQueryResult {
   rawAccessDenied: boolean;
 }
 
+/** Receives a sanitized event whenever the registry records one. */
+export type DebugEventListener = (event: DebugEventView) => void;
+
 export interface DebugSummary {
   total: number;
   byLevel: Partial<Record<DebugLevel, number>>;
@@ -73,6 +76,7 @@ export interface DebugSummary {
 interface DebugRegistryState {
   config: DebugRegistryConfig;
   events: DebugEvent[];
+  listeners: Set<DebugEventListener>;
   nextId: number;
 }
 
@@ -97,10 +101,14 @@ function getState(): DebugRegistryState {
     state = {
       config: cloneConfig(DEBUG_REGISTRY_DEFAULTS),
       events: [],
+      listeners: new Set(),
       nextId: 1,
     };
     (globalThis as Record<symbol, unknown>)[REGISTRY_KEY] = state;
   }
+  // Keep the shared registry compatible with extension reloads that reuse an
+  // instance created before listeners existed.
+  if (!state.listeners) state.listeners = new Set();
   return state;
 }
 
@@ -119,7 +127,16 @@ function trimToMaxEvents(state: DebugRegistryState): void {
   state.events.splice(0, state.events.length - maxEvents);
 }
 
-function matchesQuery(event: DebugEvent, query: DebugEventQuery): boolean {
+/** Return whether a debug level is recognized by the registry. */
+export function isDebugLevel(value: unknown): value is DebugLevel {
+  return value === "debug" || value === "info" || value === "warning" || value === "error";
+}
+
+/** Match a debug event against the supported source, level, and category filters. */
+export function matchesDebugEventQuery(
+  event: Pick<DebugEventView, "source" | "level" | "category">,
+  query: Pick<DebugEventQuery, "source" | "level" | "category">,
+): boolean {
   if (query.source && event.source !== query.source) return false;
   if (query.level && event.level !== query.level) return false;
   if (query.category && event.category !== query.category) return false;
@@ -168,6 +185,26 @@ export function redactDebugData<T>(value: T): T {
   return redactValue(value, 8) as T;
 }
 
+function toSanitizedView(event: DebugEvent): DebugEventView {
+  return {
+    id: event.id,
+    timestamp: event.timestamp,
+    source: event.source,
+    level: event.level,
+    category: event.category,
+    message: event.message,
+    cwd: event.cwd,
+    data: event.data,
+  };
+}
+
+/** Subscribe to sanitized events. Listeners are isolated so diagnostics cannot disrupt producers. */
+export function subscribeDebugEvents(listener: DebugEventListener): () => void {
+  const state = getState();
+  state.listeners.add(listener);
+  return () => state.listeners.delete(listener);
+}
+
 /** Record a session-local debug event if debugging is enabled. */
 export function recordDebugEvent(input: DebugEventInput): DebugEvent | null {
   const state = getState();
@@ -183,6 +220,14 @@ export function recordDebugEvent(input: DebugEventInput): DebugEvent | null {
   };
   state.events.push(event);
   trimToMaxEvents(state);
+  const view = toSanitizedView(event);
+  for (const listener of state.listeners) {
+    try {
+      listener(view);
+    } catch {
+      // Debug-event consumers must not alter producer behavior.
+    }
+  }
   return { ...event };
 }
 
@@ -196,21 +241,12 @@ export function getDebugEvents(query: DebugEventQuery = {}): DebugEventQueryResu
   const limit = query.limit && query.limit > 0 ? Math.floor(query.limit) : state.config.maxEvents;
 
   const events = state.events
-    .filter((event) => matchesQuery(event, query))
+    .filter((event) => matchesDebugEventQuery(event, query))
     .slice()
     .reverse()
     .slice(0, limit)
     .map((event): DebugEventView => {
-      const view: DebugEventView = {
-        id: event.id,
-        timestamp: event.timestamp,
-        source: event.source,
-        level: event.level,
-        category: event.category,
-        message: event.message,
-        cwd: event.cwd,
-        data: event.data,
-      };
+      const view = toSanitizedView(event);
       if (allowRaw && event.rawData !== undefined) {
         view.rawData = event.rawData;
       }
@@ -246,5 +282,6 @@ export function resetDebugRegistry(): void {
   const state = getState();
   state.config = cloneConfig(DEBUG_REGISTRY_DEFAULTS);
   state.events = [];
+  state.listeners.clear();
   state.nextId = 1;
 }

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

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

package/node_modules/@mrclrchtr/supi-tree-sitter/src/tool/outline-html-sql.ts

@@ -60,7 +60,7 @@ function htmlId(tag: SyntaxNodeLike): string | null {
     if (attribute.type !== "attribute") continue;
     const name = directChild(attribute, "attribute_name");
     if (name?.text.toLowerCase() !== "id") continue;
-    return firstDescendant(attribute, "attribute_value")?.text || null;
+    return firstDescendant(attribute, "attribute_value")?.text ?? null;
   }
   return null;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mrclrchtr/supi-code-intelligence",
-  "version": "4.5.1",
-  "description": "LSP and Tree-sitter AST code intelligence for the Pi coding agent — semantic navigation, structural search, diagnostics, and safe refactoring",
+  "version": "4.7.0",
+  "description": "LSP and AST navigation, search, diagnostics, and refactoring",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -35,10 +35,10 @@
   ],
   "dependencies": {
     "yaml": "^2.9.0",
-    "@mrclrchtr/supi-core": "4.5.1",
-    "@mrclrchtr/supi-lsp": "4.5.1",
-    "@mrclrchtr/supi-code-runtime": "4.5.1",
-    "@mrclrchtr/supi-tree-sitter": "4.5.1"
+    "@mrclrchtr/supi-code-runtime": "4.7.0",
+    "@mrclrchtr/supi-lsp": "4.7.0",
+    "@mrclrchtr/supi-tree-sitter": "4.7.0",
+    "@mrclrchtr/supi-core": "4.7.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-code-runtime",