@mrclrchtr/supi-code-intelligence 1.9.1 → 1.10.0

package/README.md

@@ -1,4 +1,10 @@
-![SuPi](assets/logo.png)
+<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/logo.png" alt="SuPi" width="50%">
+    </picture>
+  </a>
+</div>
 
 # @mrclrchtr/supi-code-intelligence
 
@@ -27,6 +33,7 @@ After install, pi gets:
 - `code_relations` — callers, callees, or implementations for a resolved target
 - `code_affected` — blast radius, downstream impact, and risk for a target
 - `code_pattern` — explicit literal, regex, or structured search
+- `code_refactor` — direct-apply semantic rename with safety gates
 - a lightweight hidden architecture overview injected near the start of a session when a project model can be built
 - **all `lsp_*` expert tools** from `@mrclrchtr/supi-lsp` (hover, definition, references, implementation, diagnostics, rename, code actions, recover, document/workspace symbols)
 - **all `tree_sitter_*` expert tools** from `@mrclrchtr/supi-tree-sitter` (outline, imports, exports, node-at, query, callees)
@@ -109,15 +116,16 @@ Results report confidence such as:
 ## Architecture
 
 `@mrclrchtr/supi-code-intelligence` is the **orchestration layer** that consumes
-semantic and structural providers through shared contracts.
+semantic and structural providers through the shared workspace broker and routes
+user intents through a planner.
 
 ```text
-supi-code-intelligence  ← hub: CodeProvider registry, types, model, tools
-    ↑         ↑
-supi-lsp    supi-tree-sitter
+supi-code-runtime      ← shared broker + canonical provider/result contracts
+        ↑
+supi-lsp / supi-tree-sitter
  (semantic)   (structural)
-    ↑         ↑
-    └──supi-code-intelligence──┘  ← orchestration, presentation, code_* tools
+        ↑
+supi-code-intelligence ← planner, presentation, code_* tools, code_refactor
 ```
 
 ## Package surfaces

package/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-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-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-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-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-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-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-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-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-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-lsp/README.md

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

package/node_modules/@mrclrchtr/supi-lsp/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-lsp/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-lsp/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-lsp/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-lsp/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-lsp/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-lsp/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-lsp/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-lsp/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-lsp/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-lsp/package.json

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