@mrclrchtr/supi-code-intelligence 1.9.1 → 1.10.0

package/node_modules/@mrclrchtr/supi-lsp/src/provider/lsp-semantic-provider.ts

@@ -5,9 +5,18 @@ import type {
   CodeLocation,
   CodePosition,
   CodeSymbol,
+  RefactorResult,
   SemanticProvider,
 } from "@mrclrchtr/supi-code-runtime/api";
-import type { DocumentSymbol, Location, LocationLink, SymbolInformation } from "../config/types.ts";
+import type {
+  DocumentSymbol,
+  Location,
+  LocationLink,
+  SymbolInformation,
+  TextDocumentEdit,
+  TextEdit,
+  WorkspaceEdit,
+} from "../config/types.ts";
 import type { SessionLspService } from "../session/service-registry.ts";
 
 /**
@@ -50,9 +59,138 @@ export function createLspSemanticProvider(lsp: SessionLspService): SemanticProvi
       if (!results) return null;
       return results.map((sym) => toCodeSymbol(sym as SymbolInformation));
     },
+
+    async rename(file: string, position: CodePosition, newName: string): Promise<RefactorResult> {
+      const edit = await lsp.rename(file, position, newName);
+      return convertLspWorkspaceEdit(edit);
+    },
+
+    async codeActions(file: string, position: CodePosition): Promise<RefactorResult[]> {
+      const actions = await lsp.codeActions(file, position);
+      if (!actions) return [];
+
+      const results: RefactorResult[] = [];
+      for (const action of actions) {
+        const edit = action.edit;
+        if (!edit) {
+          results.push({
+            kind: "unavailable",
+            reason: `Code action "${action.title}" has no edit`,
+          });
+          continue;
+        }
+        const converted = convertLspWorkspaceEdit(edit);
+        if (converted.kind === "precise") {
+          results.push(converted);
+        } else {
+          results.push({
+            kind: "unavailable",
+            reason: `Code action "${action.title}" could not produce precise edits`,
+          });
+        }
+      }
+      return results;
+    },
   };
 }
 
+// ── LSP WorkspaceEdit converter ─────────────────────────────────────
+
+/**
+ * Convert an LSP WorkspaceEdit to the shared RefactorResult type.
+ *
+ * LSP WorkspaceEdit can use:
+ * - `documentChanges` (preferred, with TextDocumentEdit)
+ * - `changes` (legacy, URI → TextEdit[] map)
+ *
+ * Returns `unavailable` when both are missing or both produce zero edits.
+ */
+function resolveFileFromUri(uri: string): string {
+  if (!uri.startsWith("file://")) return uri;
+  try {
+    return decodeURIComponent(uri.slice(7));
+  } catch {
+    return uri;
+  }
+}
+
+function collectDocumentChangeEdits(
+  docChanges: NonNullable<WorkspaceEdit["documentChanges"]>,
+): Array<{
+  file: string;
+  range: { start: { line: number; character: number }; end: { line: number; character: number } };
+  newText: string;
+}> {
+  const out: Array<{
+    file: string;
+    range: { start: { line: number; character: number }; end: { line: number; character: number } };
+    newText: string;
+  }> = [];
+  for (const change of docChanges) {
+    const tdEdit = change as TextDocumentEdit;
+    if (!tdEdit.textDocument || !tdEdit.edits) continue;
+    const file = resolveFileFromUri(tdEdit.textDocument.uri);
+    for (const singleEdit of tdEdit.edits) {
+      const te = singleEdit as TextEdit;
+      out.push({
+        file,
+        range: {
+          start: { line: te.range.start.line, character: te.range.start.character },
+          end: { line: te.range.end.line, character: te.range.end.character },
+        },
+        newText: te.newText,
+      });
+    }
+  }
+  return out;
+}
+
+function collectChangesEdits(changes: NonNullable<WorkspaceEdit["changes"]>): Array<{
+  file: string;
+  range: { start: { line: number; character: number }; end: { line: number; character: number } };
+  newText: string;
+}> {
+  const out: Array<{
+    file: string;
+    range: { start: { line: number; character: number }; end: { line: number; character: number } };
+    newText: string;
+  }> = [];
+  for (const [uri, textEdits] of Object.entries(changes)) {
+    if (!textEdits || textEdits.length === 0) continue;
+    const file = resolveFileFromUri(uri);
+    for (const te of textEdits) {
+      out.push({
+        file,
+        range: {
+          start: { line: te.range.start.line, character: te.range.start.character },
+          end: { line: te.range.end.line, character: te.range.end.character },
+        },
+        newText: te.newText,
+      });
+    }
+  }
+  return out;
+}
+
+function convertLspWorkspaceEdit(edit: WorkspaceEdit | null): RefactorResult {
+  if (!edit) {
+    return { kind: "unavailable", reason: "LSP server returned no edit" };
+  }
+
+  let fileEdits = edit.documentChanges?.length
+    ? collectDocumentChangeEdits(edit.documentChanges)
+    : [];
+  if (fileEdits.length === 0 && edit.changes) {
+    fileEdits = collectChangesEdits(edit.changes);
+  }
+
+  if (fileEdits.length === 0) {
+    return { kind: "unavailable", reason: "Workspace edit contains no file edits" };
+  }
+
+  return { kind: "precise", edits: { edits: fileEdits } };
+}
+
 // ── Type conversion helpers ───────────────────────────────────────────
 
 function toCodeLocation(item: Location | LocationLink): CodeLocation | null {

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

@@ -1,4 +1,10 @@
-![SuPi](assets/logo.png)
+<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/logo.png" alt="SuPi" width="50%">
+    </picture>
+  </a>
+</div>
 
 # @mrclrchtr/supi-tree-sitter
 

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

@@ -1,4 +1,10 @@
-![SuPi](assets/logo.png)
+<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/logo.png" alt="SuPi" width="50%">
+    </picture>
+  </a>
+</div>
 
 # @mrclrchtr/supi-core
 

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": "1.9.1",
+  "version": "1.10.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-code-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-code-runtime",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "SuPi code-runtime — shared workspace context, capability contracts, and canonical types for the code-understanding stack",
   "license": "MIT",
   "repository": {
@@ -19,7 +19,7 @@
     "!__tests__"
   ],
   "dependencies": {
-    "@mrclrchtr/supi-core": "1.9.1"
+    "@mrclrchtr/supi-core": "1.10.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*"

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

@@ -21,11 +21,15 @@ export type {
   CodeResult,
   CodeSymbol,
   ConfidenceMode,
+  DisambiguationCandidate,
   ExportData,
+  FileEdit,
   ImportData,
   NodeAtData,
   OutlineData,
+  RefactorResult,
   SourceRange,
+  WorkspaceEdit,
 } from "./types.ts";
 export type { WorkspaceContext } from "./workspace/context.ts";
 // Workspace context

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

@@ -14,6 +14,7 @@ import type {
   ImportData,
   NodeAtData,
   OutlineData,
+  RefactorResult,
 } from "../types.ts";
 
 // ── Availability state ─────────────────────────────────────────────────
@@ -47,6 +48,18 @@ export interface SemanticProvider {
   implementation(filePath: string, position: CodePosition): Promise<CodeLocation[] | null>;
   documentSymbols(filePath: string): Promise<CodeSymbol[] | null>;
   workspaceSymbols(query: string): Promise<CodeSymbol[] | null>;
+
+  /**
+   * Optional rename capability. When present, the provider supports
+   * precise semantic rename operations.
+   */
+  rename?(file: string, position: CodePosition, newName: string): Promise<RefactorResult>;
+
+  /**
+   * Optional code actions capability. When present, the provider
+   * supports code-action-based refactors.
+   */
+  codeActions?(file: string, position: CodePosition): Promise<RefactorResult[]>;
 }
 
 /**

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

@@ -104,6 +104,51 @@ export interface NodeAtData {
   }>;
 }
 
+// ── Refactor types ───────────────────────────────────────────────────
+
+/**
+ * A single file edit within a workspace edit.
+ */
+export interface FileEdit {
+  /** Absolute file path */
+  file: string;
+  /** The source range to replace */
+  range: SourceRange;
+  /** The new text to insert */
+  newText: string;
+}
+
+/**
+ * A precise workspace edit — one or more file edits to apply atomically.
+ */
+export interface WorkspaceEdit {
+  edits: FileEdit[];
+}
+
+/**
+ * A disambiguation candidate when a refactor target is ambiguous.
+ */
+export interface DisambiguationCandidate {
+  description: string;
+  file?: string;
+  line?: number;
+  character?: number;
+}
+
+/**
+ * Result of a refactor operation.
+ *
+ * - `precise`: exact edits available for safe direct apply
+ * - `ambiguous`: multiple candidates, caller must disambiguate
+ * - `unavailable`: refactoring not possible
+ */
+export type RefactorResult =
+  | { kind: "precise"; edits: WorkspaceEdit }
+  | { kind: "ambiguous"; candidates: DisambiguationCandidate[] }
+  | { kind: "unavailable"; reason: string };
+
+// ── Structural data shapes (value types, range-flattened) ──────────────
+
 export interface CalleesData {
   enclosingScope: { name: string; startLine: number; endLine: number };
   callees: Array<{ name: string; startLine: number }>;

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

@@ -19,7 +19,11 @@ 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 };
+  semantic: {
+    state: CapabilityState;
+    provider: SemanticProvider | null;
+    refactorAvailable: boolean;
+  };
   /** Structural analysis capability state and provider. */
   structural: { state: CapabilityState; provider: StructuralProvider | null };
 }

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

@@ -20,7 +20,12 @@ import type { CapabilityState, SemanticProvider, StructuralProvider } from "../c
  * provider instance (null when not ready).
  */
 export interface WorkspaceCapabilities {
-  semantic: { state: CapabilityState; provider: SemanticProvider | null };
+  semantic: {
+    state: CapabilityState;
+    provider: SemanticProvider | null;
+    /** Whether the semantic provider supports precise refactoring operations */
+    refactorAvailable: boolean;
+  };
   structural: { state: CapabilityState; provider: StructuralProvider | null };
 }
 
@@ -33,6 +38,7 @@ function createDefaultCapabilities(): WorkspaceCapabilities {
     semantic: {
       state: { kind: "unavailable", reason: DEFAULT_UNAVAILABLE_REASON },
       provider: null,
+      refactorAvailable: false,
     },
     structural: {
       state: { kind: "unavailable", reason: DEFAULT_UNAVAILABLE_REASON },
@@ -41,6 +47,10 @@ function createDefaultCapabilities(): WorkspaceCapabilities {
   };
 }
 
+function hasRefactorCapability(provider: SemanticProvider | null): boolean {
+  return !!(provider && (provider.rename !== undefined || provider.codeActions !== undefined));
+}
+
 // ── Runtime ────────────────────────────────────────────────────────────
 
 /**
@@ -73,12 +83,13 @@ export class WorkspaceRuntime {
    * without affecting the structural provider.
    */
   registerSemantic(cwd: string, provider: SemanticProvider): void {
+    const refactorAvailable = hasRefactorCapability(provider);
     const existing = this.#workspaces.get(cwd);
     if (existing) {
-      existing.semantic = { state: { kind: "ready" }, provider };
+      existing.semantic = { state: { kind: "ready" }, provider, refactorAvailable };
     } else {
       this.#workspaces.set(cwd, {
-        semantic: { state: { kind: "ready" }, provider },
+        semantic: { state: { kind: "ready" }, provider, refactorAvailable },
         structural: createDefaultCapabilities().structural,
       });
     }

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

@@ -1,4 +1,10 @@
-![SuPi](assets/logo.png)
+<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/logo.png" alt="SuPi" width="50%">
+    </picture>
+  </a>
+</div>
 
 # @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": "1.9.1",
+  "version": "1.10.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {

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

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-tree-sitter",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "SuPi Tree-sitter extension — structural AST analysis for pi",
   "license": "MIT",
   "repository": {
@@ -24,8 +24,8 @@
   ],
   "dependencies": {
     "web-tree-sitter": "^0.26.8",
-    "@mrclrchtr/supi-code-runtime": "1.9.1",
-    "@mrclrchtr/supi-core": "1.9.1"
+    "@mrclrchtr/supi-core": "1.10.0",
+    "@mrclrchtr/supi-code-runtime": "1.10.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "*",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-code-intelligence",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "SuPi Code Intelligence extension — architecture briefs, caller/callee analysis, impact assessment, and pattern search for pi",
   "license": "MIT",
   "repository": {
@@ -19,10 +19,10 @@
     "src/**/*.ts"
   ],
   "dependencies": {
-    "@mrclrchtr/supi-lsp": "1.9.1",
-    "@mrclrchtr/supi-core": "1.9.1",
-    "@mrclrchtr/supi-code-runtime": "1.9.1",
-    "@mrclrchtr/supi-tree-sitter": "1.9.1"
+    "@mrclrchtr/supi-code-runtime": "1.10.0",
+    "@mrclrchtr/supi-core": "1.10.0",
+    "@mrclrchtr/supi-tree-sitter": "1.10.0",
+    "@mrclrchtr/supi-lsp": "1.10.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-code-runtime",

package/src/intent/types.ts

@@ -0,0 +1,34 @@
+/**
+ * Normalized intent and routing types for the code-intelligence planner.
+ */
+import type { CodeIntelligenceToolName, CodeRelationsKind } from "../tool/tool-specs.ts";
+
+/**
+ * A route describes how the planner recommends handling a tool intent.
+ */
+export interface PlannerRoute {
+  /** Whether a semantic (LSP-backed) provider is available */
+  semanticAvailable: boolean;
+  /** Whether a structural (tree-sitter-backed) provider is available */
+  structuralAvailable: boolean;
+  /** Whether precise refactoring is available */
+  refactorAvailable: boolean;
+  /**
+   * The preferred execution strategy for this intent.
+   * - `semantic`: use LSP first
+   * - `structural`: use tree-sitter first
+   * - `search`: use explicit text/heuristic search
+   * - `unavailable`: no capability can satisfy this intent
+   */
+  preferred: "semantic" | "structural" | "search" | "unavailable";
+}
+
+/**
+ * A resolved intents for a tool execution request.
+ * Provides the normalized target and routing info together.
+ */
+export interface ResolvedIntent {
+  tool: CodeIntelligenceToolName;
+  relationsKind?: CodeRelationsKind;
+  route: PlannerRoute;
+}

package/src/planner/planner.ts

@@ -0,0 +1,82 @@
+/**
+ * Central planner for code-intelligence tool routing.
+ *
+ * Reads capability state from the shared workspace broker and returns
+ * routing decisions for each tool intent. Keeps the execution strategy
+ * explicit and centralized instead of scattering capability checks
+ * across per-tool execute files.
+ */
+
+import { getDefaultWorkspaceRuntime } from "@mrclrchtr/supi-code-runtime/api";
+import type { PlannerRoute } from "../intent/types.ts";
+import type { CodeIntelligenceToolName, CodeRelationsKind } from "../tool/tool-specs.ts";
+
+interface RouteAvailability {
+  semanticAvailable: boolean;
+  structuralAvailable: boolean;
+  refactorAvailable: boolean;
+}
+
+function readAvailability(cwd: string): RouteAvailability {
+  const runtime = getDefaultWorkspaceRuntime();
+  const workspace = runtime.getWorkspace(cwd);
+  return {
+    semanticAvailable:
+      workspace.semantic.state.kind === "ready" && workspace.semantic.provider !== null,
+    structuralAvailable:
+      workspace.structural.state.kind === "ready" && workspace.structural.provider !== null,
+    refactorAvailable: workspace.semantic.refactorAvailable,
+  };
+}
+
+function withPreferred(
+  availability: RouteAvailability,
+  preferred: PlannerRoute["preferred"],
+): PlannerRoute {
+  return { ...availability, preferred };
+}
+
+function semanticOnly(availability: RouteAvailability): PlannerRoute["preferred"] {
+  return availability.semanticAvailable ? "semantic" : "unavailable";
+}
+
+function structuralOnly(availability: RouteAvailability): PlannerRoute["preferred"] {
+  return availability.structuralAvailable ? "structural" : "unavailable";
+}
+
+function briefPreferred(availability: RouteAvailability): PlannerRoute["preferred"] {
+  if (availability.semanticAvailable) return "semantic";
+  if (availability.structuralAvailable) return "structural";
+  return "unavailable";
+}
+
+/**
+ * Get the routing decision for a tool intent in a workspace.
+ */
+export function routeFor(
+  cwd: string,
+  tool: CodeIntelligenceToolName,
+  relationsKind?: CodeRelationsKind,
+): PlannerRoute {
+  const availability = readAvailability(cwd);
+
+  if (tool === "code_pattern") {
+    return withPreferred(availability, "search");
+  }
+
+  if (tool === "code_relations") {
+    const preferred =
+      relationsKind === "callees" ? structuralOnly(availability) : semanticOnly(availability);
+    return withPreferred(availability, preferred);
+  }
+
+  if (tool === "code_affected") {
+    return withPreferred(availability, semanticOnly(availability));
+  }
+
+  if (tool === "code_refactor") {
+    return withPreferred(availability, availability.refactorAvailable ? "semantic" : "unavailable");
+  }
+
+  return withPreferred(availability, briefPreferred(availability));
+}

package/src/presentation/markdown/refactor.ts

@@ -0,0 +1,27 @@
+/**
+ * Markdown renderer for refactor results.
+ */
+import type { ApplyResult } from "../../refactor/apply-workspace-edit.ts";
+
+export interface RefactorRenderInput {
+  result: ApplyResult;
+  operation: string;
+  targetDescription: string;
+}
+
+/**
+ * Render a refactor result as human-readable markdown.
+ */
+export function renderRefactorResult(input: RefactorRenderInput): string {
+  const { result, operation, targetDescription } = input;
+
+  if (result.kind === "error") {
+    return `**Refactor failed:** ${result.reason}`;
+  }
+
+  return [
+    `**Refactor applied:** ${operation} on ${targetDescription}`,
+    `- Files changed: ${result.filesChanged}`,
+    `- Total edits: ${result.totalEdits}`,
+  ].join("\n");
+}