@mrclrchtr/supi-code-intelligence 1.7.0 → 1.9.0

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

@@ -0,0 +1,31 @@
+/**
+ * Package-root re-export surface for @mrclrchtr/supi-code-runtime.
+ *
+ * Prefer importing from `@mrclrchtr/supi-code-runtime/api` for explicit
+ * access to the shared contracts and workspace primitives.
+ */
+
+export type {
+  CalleesData,
+  CapabilityState,
+  CodeLocation,
+  CodePosition,
+  CodeResult,
+  CodeSymbol,
+  ConfidenceMode,
+  ExportData,
+  ImportData,
+  NodeAtData,
+  OutlineData,
+  SemanticProvider,
+  SourceRange,
+  StructuralProvider,
+  StructuralResult,
+  WorkspaceCapabilities,
+  WorkspaceContext,
+} from "./api.ts";
+export {
+  createWorkspaceContext,
+  getDefaultWorkspaceRuntime,
+  WorkspaceRuntime,
+} from "./api.ts";

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

@@ -0,0 +1,110 @@
+/**
+ * Canonical shared types for the SuPi code-understanding stack.
+ *
+ * These types are package-agnostic and used across supi-lsp, supi-tree-sitter,
+ * and supi-code-intelligence for communicating code analysis results,
+ * capability availability, and structural data shapes.
+ */
+
+// ── Position and location types ────────────────────────────────────────
+
+/** 0-based LSP position. */
+export interface CodePosition {
+  line: number;
+  character: number;
+}
+
+/** A source range spanning two CodePositions. */
+export interface SourceRange {
+  start: CodePosition;
+  end: CodePosition;
+}
+
+/** A code location (file URI + range). */
+export interface CodeLocation {
+  uri: string;
+  range: SourceRange;
+}
+
+// ── Symbol types ───────────────────────────────────────────────────────
+
+/** A discovered symbol / declaration. */
+export interface CodeSymbol {
+  name: string;
+  kind: string;
+  file: string;
+  line: number;
+  character: number;
+  container?: string | null;
+}
+
+// ── Result types ───────────────────────────────────────────────────────
+
+/**
+ * Discriminated result union for provider operations.
+ *
+ * Used primarily by structural (tree-sitter-backed) operations that
+ * have explicit error and unsupported-language states. Semantic operations
+ * use `null` to signal absence.
+ */
+export type CodeResult<T> =
+  | { kind: "success"; data: T }
+  | { kind: "unsupported-language"; file: string; message: string }
+  | { kind: "file-access-error"; file: string; message: string }
+  | { kind: "validation-error"; message: string }
+  | { kind: "runtime-error"; message: string }
+  | { kind: "unavailable"; message: string };
+
+/** Result confidence classification. */
+export type ConfidenceMode = "semantic" | "structural" | "heuristic" | "unavailable";
+
+// ── Structural data shapes (value types, range-flattened) ──────────────
+
+export interface OutlineData {
+  name: string;
+  kind: string;
+  startLine: number;
+  startCharacter: number;
+  endLine: number;
+  endCharacter: number;
+  children?: OutlineData[];
+}
+
+export interface ExportData {
+  name: string;
+  kind: string;
+  startLine: number;
+  startCharacter: number;
+  endLine: number;
+  endCharacter: number;
+  moduleSpecifier?: string;
+}
+
+export interface ImportData {
+  moduleSpecifier: string;
+  startLine: number;
+  startCharacter: number;
+  endLine: number;
+  endCharacter: number;
+}
+
+export interface NodeAtData {
+  type: string;
+  startLine: number;
+  startCharacter: number;
+  endLine: number;
+  endCharacter: number;
+  text: string;
+  ancestry: Array<{
+    type: string;
+    startLine: number;
+    startCharacter: number;
+    endLine: number;
+    endCharacter: number;
+  }>;
+}
+
+export interface CalleesData {
+  enclosingScope: { name: string; startLine: number; endLine: number };
+  callees: Array<{ name: string; startLine: number }>;
+}

package/node_modules/@mrclrchtr/supi-code-runtime/src/workspace/context.ts

@@ -0,0 +1,41 @@
+/**
+ * Typed request context helper for consumers that need a convenient view
+ * of the capability state for a workspace cwd.
+ *
+ * This is the primary way that `supi-code-intelligence` reads capability
+ * state from the shared runtime. Substrates register providers through
+ * {@link WorkspaceRuntime} directly.
+ */
+
+import type { CapabilityState, SemanticProvider, StructuralProvider } from "../capability/types.ts";
+import type { WorkspaceRuntime } from "./runtime.ts";
+
+/**
+ * A workspace-scoped request context that provides access to active
+ * semantic and structural capabilities along with their availability
+ * state and the cached project model.
+ */
+export interface WorkspaceContext {
+  /** The working directory this context is scoped to. */
+  cwd: string;
+  /** Semantic analysis capability state and provider. */
+  semantic: { state: CapabilityState; provider: SemanticProvider | null };
+  /** Structural analysis capability state and provider. */
+  structural: { state: CapabilityState; provider: StructuralProvider | null };
+}
+
+/**
+ * Create a typed workspace context from the shared runtime.
+ *
+ * @param cwd - The working directory for this context.
+ * @param runtime - The shared workspace runtime instance.
+ * @returns A snapshot of the capability state for this workspace.
+ */
+export function createWorkspaceContext(cwd: string, runtime: WorkspaceRuntime): WorkspaceContext {
+  const ws = runtime.getWorkspace(cwd);
+  return {
+    cwd,
+    semantic: ws.semantic,
+    structural: ws.structural,
+  };
+}

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

@@ -0,0 +1,170 @@
+/**
+ * Workspace-scoped capability registry.
+ *
+ * Substrates (LSP, tree-sitter) register their capabilities per cwd
+ * at session startup. Code-intelligence reads capability state from
+ * this registry instead of maintaining a local provider composition
+ * layer.
+ *
+ * Capabilities are independent: registering a semantic provider does not
+ * affect an already-registered structural provider for the same cwd.
+ */
+
+import type { CapabilityState, SemanticProvider, StructuralProvider } from "../capability/types.ts";
+
+// ── Public types ───────────────────────────────────────────────────────
+
+/**
+ * The combined capability state for a workspace.
+ * Each capability slot includes both the availability state and the
+ * provider instance (null when not ready).
+ */
+export interface WorkspaceCapabilities {
+  semantic: { state: CapabilityState; provider: SemanticProvider | null };
+  structural: { state: CapabilityState; provider: StructuralProvider | null };
+}
+
+// ── Defaults ───────────────────────────────────────────────────────────
+
+const DEFAULT_UNAVAILABLE_REASON = "No provider registered for this workspace";
+
+function createDefaultCapabilities(): WorkspaceCapabilities {
+  return {
+    semantic: {
+      state: { kind: "unavailable", reason: DEFAULT_UNAVAILABLE_REASON },
+      provider: null,
+    },
+    structural: {
+      state: { kind: "unavailable", reason: DEFAULT_UNAVAILABLE_REASON },
+      provider: null,
+    },
+  };
+}
+
+// ── Runtime ────────────────────────────────────────────────────────────
+
+/**
+ * Workspace-scoped capability registry keyed by cwd/project root.
+ *
+ * Each workspace stores independent capability state for semantic
+ * (LSP-backed) and structural (tree-sitter-backed) analysis. Substrates
+ * register their capabilities at session start; consumers read them
+ * as needed.
+ *
+ * The registry is intentionally unopinionated about which capabilities
+ * are required — a workspace may have only semantic, only structural,
+ * both, or neither.
+ */
+export class WorkspaceRuntime {
+  readonly #workspaces = new Map<string, WorkspaceCapabilities>();
+
+  /**
+   * Get the capability state for a workspace cwd.
+   * Returns a default "unavailable" state if the workspace
+   * has never been registered.
+   */
+  getWorkspace(cwd: string): WorkspaceCapabilities {
+    return this.#workspaces.get(cwd) ?? createDefaultCapabilities();
+  }
+
+  /**
+   * Register a semantic provider for a workspace.
+   * Replaces any existing semantic provider for the same cwd
+   * without affecting the structural provider.
+   */
+  registerSemantic(cwd: string, provider: SemanticProvider): void {
+    const existing = this.#workspaces.get(cwd);
+    if (existing) {
+      existing.semantic = { state: { kind: "ready" }, provider };
+    } else {
+      this.#workspaces.set(cwd, {
+        semantic: { state: { kind: "ready" }, provider },
+        structural: createDefaultCapabilities().structural,
+      });
+    }
+  }
+
+  /**
+   * Register a structural provider for a workspace.
+   * Replaces any existing structural provider for the same cwd
+   * without affecting the semantic provider.
+   */
+  registerStructural(cwd: string, provider: StructuralProvider): void {
+    const existing = this.#workspaces.get(cwd);
+    if (existing) {
+      existing.structural = { state: { kind: "ready" }, provider };
+    } else {
+      this.#workspaces.set(cwd, {
+        semantic: createDefaultCapabilities().semantic,
+        structural: { state: { kind: "ready" }, provider },
+      });
+    }
+  }
+
+  /**
+   * Remove all capability state for a single workspace cwd.
+   */
+  clearWorkspace(cwd: string): void {
+    this.#workspaces.delete(cwd);
+  }
+
+  /**
+   * Clear only the semantic capability slot for a workspace.
+   * Leaves the structural slot untouched.
+   */
+  clearSemantic(cwd: string): void {
+    const ws = this.#workspaces.get(cwd);
+    if (!ws) return;
+    ws.semantic = createDefaultCapabilities().semantic;
+    // If both slots are now unavailable, remove the entire entry
+    if (ws.semantic.state.kind === "unavailable" && ws.structural.state.kind === "unavailable") {
+      this.#workspaces.delete(cwd);
+    }
+  }
+
+  /**
+   * Clear only the structural capability slot for a workspace.
+   * Leaves the semantic slot untouched.
+   */
+  clearStructural(cwd: string): void {
+    const ws = this.#workspaces.get(cwd);
+    if (!ws) return;
+    ws.structural = createDefaultCapabilities().structural;
+    // If both slots are now unavailable, remove the entire entry
+    if (ws.semantic.state.kind === "unavailable" && ws.structural.state.kind === "unavailable") {
+      this.#workspaces.delete(cwd);
+    }
+  }
+
+  /**
+   * Remove all capability state for every workspace.
+   */
+  clearAll(): void {
+    this.#workspaces.clear();
+  }
+}
+
+// ── Default singleton ───────────────────────────────────────────────────
+
+const RUNTIME_SYMBOL = Symbol.for("@mrclrchtr/supi-code-runtime/default-runtime");
+
+/**
+ * Get the shared default workspace runtime instance.
+ *
+ * Backed by `globalThis` + `Symbol.for` so that all jiti module instances
+ * (even duplicate loads through separate `node_modules` paths) share the
+ * same WorkspaceRuntime. Without this, standalone installs where
+ * `supi-lsp`, `supi-tree-sitter`, and `supi-code-intelligence` each bundle
+ * their own copy of `@mrclrchtr/supi-code-runtime` would get separate
+ * runtimes — LSP/tree-sitter would register capabilities into one while
+ * code-intelligence reads from another.
+ */
+export function getDefaultWorkspaceRuntime(): WorkspaceRuntime {
+  const g = globalThis as Record<symbol, unknown>;
+  let runtime = g[RUNTIME_SYMBOL] as WorkspaceRuntime | undefined;
+  if (!runtime) {
+    runtime = new WorkspaceRuntime();
+    g[RUNTIME_SYMBOL] = runtime;
+  }
+  return runtime;
+}

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

@@ -1,29 +1,20 @@
+![SuPi](assets/logo.png)
+
 # @mrclrchtr/supi-core
 
 Shared infrastructure for SuPi extensions.
 
-This package is mainly for extension authors. It gives you a common config system, settings plumbing, context helpers, registries, and a small extension surface that registers `/supi-settings`.
+This is a **pure library** — it does not register any pi commands or tools. The `/supi-settings` command is now available through `@mrclrchtr/supi-settings`.
 
 ## Install
 
-### As a dependency for another extension
-
 ```bash
 pnpm add @mrclrchtr/supi-core
 ```
 
-### As a pi package
-
-```bash
-pi install npm:@mrclrchtr/supi-core
-```
-
-Installing it as a pi package adds the minimal `/supi-settings` extension surface.
-
 ## Package surfaces
 
 - `@mrclrchtr/supi-core/api` — reusable helpers for other packages and extensions
-- `@mrclrchtr/supi-core/extension` — minimal pi extension that registers `/supi-settings`
 
 ## What you get from the API
 
@@ -101,7 +92,6 @@ const message = wrapExtensionContext("my-extension", "hello", {
 ## Source
 
 - `src/api.ts` — exported library surface
-- `src/extension.ts` — minimal `/supi-settings` entrypoint
 - `src/config.ts` — shared config loading and writing
 - `src/config-settings.ts` — config-backed settings registration helper
 - `src/settings-ui.ts` — shared settings overlay

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

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {
@@ -37,12 +37,17 @@
   "main": "src/api.ts",
   "exports": {
     "./api": "./src/api.ts",
-    "./extension": "./src/extension.ts",
-    "./package.json": "./package.json"
-  },
-  "pi": {
-    "extensions": [
-      "./src/extension.ts"
-    ]
+    "./config": "./src/config.ts",
+    "./context": "./src/context.ts",
+    "./debug": "./src/debug-registry.ts",
+    "./package.json": "./package.json",
+    "./path": "./src/path.ts",
+    "./project": "./src/project.ts",
+    "./session": "./src/session.ts",
+    "./settings": "./src/settings.ts",
+    "./settings-ui": "./src/settings-ui.ts",
+    "./terminal": "./src/terminal.ts",
+    "./tool-framework": "./src/tool-framework.ts",
+    "./types": "./src/types.ts"
   }
 }

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

@@ -1,96 +1,30 @@
 // supi-core — shared infrastructure for SuPi extensions.
 // Provides XML context tag wrapping, unified config system, context-message utilities,
 // settings registry for supi-wide TUI settings, and a shared tool-spec/registration framework.
+//
+// Convenience barrel — re-exports all domain entry points.
+// For lighter imports, use one of the domain subpaths directly
+// (e.g. @mrclrchtr/supi-core/config, @mrclrchtr/supi-core/context).
 
-export type { SupiConfigLocation, SupiConfigOptions } from "./config/config.ts";
-export {
-  loadSupiConfig,
-  loadSupiConfigForScope,
-  readJsonFile,
-  removeSupiConfigKey,
-  writeSupiConfig,
-} from "./config/config.ts";
-export type { ConfigSettingsHelpers, ConfigSettingsOptions } from "./config/config-settings.ts";
-export { registerConfigSettings } from "./config/config-settings.ts";
-export type { ContextMessageLike } from "./context/context-messages.ts";
-export {
-  findLastUserMessageIndex,
-  getContextToken,
-  getPromptContent,
-  pruneAndReorderContextMessages,
-  restorePromptContent,
-} from "./context/context-messages.ts";
-export type { ContextProvider } from "./context/context-provider-registry.ts";
-export {
-  clearRegisteredContextProviders,
-  getRegisteredContextProviders,
-  registerContextProvider,
-} from "./context/context-provider-registry.ts";
-export { wrapExtensionContext } from "./context/context-tag.ts";
-export type {
-  DebugAgentAccess,
-  DebugEvent,
-  DebugEventInput,
-  DebugEventQuery,
-  DebugEventQueryResult,
-  DebugEventView,
-  DebugLevel,
-  DebugNotifyLevel,
-  DebugRegistryConfig,
-  DebugSummary,
-} from "./debug-registry.ts";
-export {
-  clearDebugEvents,
-  configureDebugRegistry,
-  DEBUG_REGISTRY_DEFAULTS,
-  getDebugEvents,
-  getDebugRegistryConfig,
-  getDebugSummary,
-  recordDebugEvent,
-  redactDebugData,
-  resetDebugRegistry,
-} from "./debug-registry.ts";
-export { fileToUri, resolveToolPath, stripToolPathPrefix, uriToFile } from "./path-utils.ts";
-export type { KnownRootEntry } from "./project-roots.ts";
-export {
-  buildKnownRootsMap,
-  byPathDepth,
-  dedupeTopmostRoots,
-  findProjectRoot,
-  isWithin,
-  isWithinOrEqual,
-  mergeKnownRoots,
-  resolveKnownRoot,
-  segmentCount,
-  sortRootsBySpecificity,
-  walkProject,
-} from "./project-roots.ts";
-export { createRegistry, createSessionStateRegistry } from "./registry-utils.ts";
-export { getActiveBranchEntries } from "./session-utils.ts";
-export { registerSettingsCommand } from "./settings/settings-command.ts";
-export type { SettingsScope, SettingsSection } from "./settings/settings-registry.ts";
-export {
-  clearRegisteredSettings,
-  getRegisteredSettings,
-  registerSettings,
-} from "./settings/settings-registry.ts";
-export { createInputSubmenu, openSettingsOverlay } from "./settings/settings-ui.ts";
-export type { TitleTarget } from "./terminal.ts";
-export {
-  DONE_SYMBOL,
-  formatTitle,
-  signalBell,
-  signalDone,
-  signalWaiting,
-  WAITING_SYMBOL,
-} from "./terminal.ts";
-export type { SuiPiToolPromptSurface, SuiPiToolSpec, ToolExecuteFn } from "./tool-framework.ts";
-export {
-  CharacterParam,
-  derivePromptSurface,
-  FileParam,
-  LineParam,
-  MaxResultsParam,
-  registerSuiPiTools,
-  SymbolParam,
-} from "./tool-framework.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./config.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./context.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./debug-registry.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./path.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./project.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./session.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./settings.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./settings-ui.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./terminal.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./tool-framework.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./types.ts";

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

@@ -0,0 +1,11 @@
+// supi-core config domain — config loading and config-settings helpers.
+export type { SupiConfigLocation, SupiConfigOptions } from "./config/config.ts";
+export {
+  loadSupiConfig,
+  loadSupiConfigForScope,
+  readJsonFile,
+  removeSupiConfigKey,
+  writeSupiConfig,
+} from "./config/config.ts";
+export type { ConfigSettingsHelpers, ConfigSettingsOptions } from "./config/config-settings.ts";
+export { registerConfigSettings } from "./config/config-settings.ts";

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

@@ -0,0 +1,16 @@
+// supi-core context domain — context messages, providers, and XML tags.
+export type { ContextMessageLike } from "./context/context-messages.ts";
+export {
+  findLastUserMessageIndex,
+  getContextToken,
+  getPromptContent,
+  pruneAndReorderContextMessages,
+  restorePromptContent,
+} from "./context/context-messages.ts";
+export type { ContextProvider } from "./context/context-provider-registry.ts";
+export {
+  clearRegisteredContextProviders,
+  getRegisteredContextProviders,
+  registerContextProvider,
+} from "./context/context-provider-registry.ts";
+export { wrapExtensionContext } from "./context/context-tag.ts";