@mrclrchtr/supi-code-intelligence 1.8.0 → 1.9.0

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.8.0",
+  "version": "1.9.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {
@@ -40,7 +40,6 @@
     "./config": "./src/config.ts",
     "./context": "./src/context.ts",
     "./debug": "./src/debug-registry.ts",
-    "./extension": "./src/extension.ts",
     "./package.json": "./package.json",
     "./path": "./src/path.ts",
     "./project": "./src/project.ts",
@@ -50,10 +49,5 @@
     "./terminal": "./src/terminal.ts",
     "./tool-framework": "./src/tool-framework.ts",
     "./types": "./src/types.ts"
-  },
-  "pi": {
-    "extensions": [
-      "./src/extension.ts"
-    ]
   }
 }

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

@@ -1,3 +1,5 @@
+![SuPi](assets/logo.png)
+
 # @mrclrchtr/supi-lsp
 
 Adds Language Server Protocol support to the [pi coding agent](https://github.com/earendil-works/pi).
@@ -14,8 +16,6 @@ For local development:
 pi install ./packages/supi-lsp
 ```
 
-After editing the source, run `/reload`.
-
 ## What you get
 
 After install, pi gets **10 focused expert tools** for semantic language-server analysis:
@@ -32,6 +32,10 @@ After install, pi gets **10 focused expert tools** for semantic language-server
 - `lsp_recover` — refresh stale diagnostics after workspace changes
 - `/lsp-status` — inspect detected servers, roots, open files, and diagnostics
 
+![LSP status overlay](https://raw.githubusercontent.com/mrclrchtr/supi/main/screenshots/supi-lsp-status.png)
+
+![LSP hover in action](https://raw.githubusercontent.com/mrclrchtr/supi/main/screenshots/supi-lsp-hover.png)
+
 Coordinates use **1-based** line and character positions.
 
 ## Automatic behavior
@@ -61,10 +65,24 @@ Config lives in the standard SuPi config files:
 - global: `~/.pi/agent/supi/config.json`
 - project: `.pi/supi/config.json`
 
+## Architecture
+
+`@mrclrchtr/supi-lsp` is the **semantic substrate** in SuPi's code-understanding stack.
+It depends on `@mrclrchtr/supi-core` and `@mrclrchtr/supi-code-runtime` for shared
+contracts, and provides a session-scoped LSP service that publishes semantic and
+diagnostic capabilities into the shared workspace runtime.
+
+```text
+supi-code-runtime  ← shared contracts + workspace runtime
+    ↑
+supi-lsp           ← LSP client + session-scoped service + runtime capabilities
+```
+
 ## Package surfaces
 
 - `@mrclrchtr/supi-lsp/api` — reusable session-scoped LSP service and related types
 - `@mrclrchtr/supi-lsp/extension` — pi extension entrypoint
+- `@mrclrchtr/supi-lsp/provider/lsp-semantic-provider` — shared SemanticProvider adapter
 
 Example:
 

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

@@ -0,0 +1,13 @@
+# @mrclrchtr/supi-code-runtime
+
+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.
+
+## Package surfaces
+
+- `@mrclrchtr/supi-code-runtime/api` — shared canonical types, capability interfaces, workspace runtime registry, and typed request context
+
+## License
+
+MIT

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

@@ -0,0 +1,97 @@
+![SuPi](assets/logo.png)
+
+# @mrclrchtr/supi-core
+
+Shared infrastructure for SuPi extensions.
+
+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
+
+```bash
+pnpm add @mrclrchtr/supi-core
+```
+
+## Package surfaces
+
+- `@mrclrchtr/supi-core/api` — reusable helpers for other packages and extensions
+
+## What you get from the API
+
+### Config helpers
+
+- `loadSupiConfig()` — merged config with resolution order `defaults <- global <- project`
+- `loadSupiConfigForScope()` — load one scope at a time for settings UIs
+- `writeSupiConfig()` — persist values
+- `removeSupiConfigKey()` — remove a key or override
+
+Config file locations:
+
+- global: `~/.pi/agent/supi/config.json`
+- project: `.pi/supi/config.json`
+
+### Settings helpers
+
+- `registerSettings()` — register an arbitrary settings section
+- `registerConfigSettings()` — register a config-backed settings section with scoped persistence helpers
+- `registerSettingsCommand()` — register `/supi-settings`
+- `openSettingsOverlay()` — open the shared settings UI directly
+- `createInputSubmenu()` — helper for simple text-entry submenus
+
+The built-in settings UI supports:
+
+- project/global scope toggle
+- grouped extension sections
+- searchable setting lists
+
+### Context helpers
+
+- `wrapExtensionContext()` — wrap injected text in SuPi's `<extension-context>` tag
+- `findLastUserMessageIndex()`
+- `getContextToken()`
+- `getPromptContent()`
+- `pruneAndReorderContextMessages()`
+- `restorePromptContent()`
+
+### Shared registries
+
+- context-provider registry for `/supi-context`
+- debug-event registry for producers that want shared debug capture
+- settings registry used by `/supi-settings`
+
+### Project and session helpers
+
+- project-root detection and directory walking helpers such as `findProjectRoot()` and `walkProject()`
+- active-branch session helper: `getActiveBranchEntries()`
+- terminal helpers such as `formatTitle()`, `signalWaiting()`, and `signalDone()`
+
+## Example
+
+```ts
+import { loadSupiConfig, registerConfigSettings, wrapExtensionContext } from "@mrclrchtr/supi-core/api";
+
+const config = loadSupiConfig("my-extension", process.cwd(), {
+  enabled: true,
+});
+
+registerConfigSettings({
+  id: "my-extension",
+  label: "My Extension",
+  section: "my-extension",
+  defaults: { enabled: true },
+  buildItems: () => [],
+  persistChange: () => {},
+});
+
+const message = wrapExtensionContext("my-extension", "hello", {
+  file: "CLAUDE.md",
+  turn: 1,
+});
+```
+
+## Source
+
+- `src/api.ts` — exported library surface
+- `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-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@mrclrchtr/supi-core",
+  "version": "1.9.0",
+  "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mrclrchtr/supi.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "pi",
+    "pi-coding-agent"
+  ],
+  "files": [
+    "src/**/*.ts",
+    "!__tests__"
+  ],
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    },
+    "typebox": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "25.9.1",
+    "vitest": "4.1.7"
+  },
+  "main": "src/api.ts",
+  "exports": {
+    "./api": "./src/api.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-lsp/node_modules/@mrclrchtr/supi-code-runtime/node_modules/@mrclrchtr/supi-core/src/api.ts

@@ -0,0 +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).
+
+// 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";