@mrclrchtr/supi-code-runtime 1.9.0 → 1.10.0

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.0",
+  "version": "1.10.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-code-runtime",
-  "version": "1.9.0",
+  "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.0"
+    "@mrclrchtr/supi-core": "1.10.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*"

package/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/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/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/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/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,
       });
     }