@aexol/spectral 0.8.5 → 0.8.7

package/dist/mcp/utils.js

@@ -1,25 +1,25 @@
 import { homedir, platform } from "node:os";
 import { join } from "node:path";
-async function execOpen(pi, target, browser) {
+async function execOpen(ext, target, browser) {
     const os = platform();
     if (os === "darwin") {
-        return browser ? pi.exec("open", ["-a", browser, target]) : pi.exec("open", [target]);
+        return browser ? ext.exec("open", ["-a", browser, target]) : ext.exec("open", [target]);
     }
     if (os === "win32") {
         return browser
-            ? pi.exec("cmd", ["/c", "start", "", browser, target])
-            : pi.exec("cmd", ["/c", "start", "", target]);
+            ? ext.exec("cmd", ["/c", "start", "", browser, target])
+            : ext.exec("cmd", ["/c", "start", "", target]);
     }
-    return browser ? pi.exec(browser, [target]) : pi.exec("xdg-open", [target]);
+    return browser ? ext.exec(browser, [target]) : ext.exec("xdg-open", [target]);
 }
-export async function openUrl(pi, url, browser) {
-    const result = await execOpen(pi, url, browser);
+export async function openUrl(ext, url, browser) {
+    const result = await execOpen(ext, url, browser);
     if (result.code !== 0) {
         throw new Error(result.stderr || `Failed to open browser (exit code ${result.code})`);
     }
 }
-export async function openPath(pi, targetPath) {
-    const result = await execOpen(pi, targetPath);
+export async function openPath(ext, targetPath) {
+    const result = await execOpen(ext, targetPath);
     if (result.code !== 0) {
         throw new Error(result.stderr || `Failed to open path (exit code ${result.code})`);
     }
@@ -96,7 +96,7 @@ export function extractToolUiStreamMode(toolMeta) {
     const uiMeta = toolMeta?.ui;
     if (!uiMeta || typeof uiMeta !== "object")
         return undefined;
-    const streamMode = uiMeta["pi-mcp-adapter.streamMode"];
+    const streamMode = uiMeta["spectral-mcp-adapter.streamMode"];
     if (streamMode === "eager" || streamMode === "stream-first") {
         return streamMode;
     }

package/dist/mcp-client.d.ts

@@ -51,7 +51,7 @@ export declare class AexolMcpClient {
     listTools(): Promise<McpTool[]>;
     /**
      * Invoke a single tool. Returns the raw `{ content, isError? }` envelope —
-     * the caller (the pi extension) decides how to surface it back to the model.
+     * the caller (the spectral extension) decides how to surface it back to the model.
      */
     callTool(name: string, args: unknown): Promise<McpToolCallResult>;
 }

package/dist/mcp-client.js

@@ -101,7 +101,7 @@ export class AexolMcpClient {
     }
     /**
      * Invoke a single tool. Returns the raw `{ content, isError? }` envelope —
-     * the caller (the pi extension) decides how to surface it back to the model.
+     * the caller (the spectral extension) decides how to surface it back to the model.
      */
     async callTool(name, args) {
         const result = await this.call("tools/call", {

package/dist/memory/commands/status.d.ts

@@ -1,4 +1,4 @@
 import type { ExtensionAPI } from "../../sdk/coding-agent/index.js";
 import type { Runtime } from "../runtime.js";
-export declare function registerStatusCommand(pi: ExtensionAPI, runtime: Runtime): void;
+export declare function registerStatusCommand(ext: ExtensionAPI, runtime: Runtime): void;
 //# sourceMappingURL=status.d.ts.map

package/dist/memory/commands/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AASpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA6F9E"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AASpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA6F/E"}

package/dist/memory/commands/status.js

@@ -4,8 +4,8 @@ import { observationPoolTokens as estimateObservationPoolTokens } from "../compa
 import { countByRelevance, formatRelevanceHistogram } from "../relevance.js";
 import { estimateStringTokens } from "../tokens.js";
 import { reflectionContent } from "../types.js";
-export function registerStatusCommand(pi, runtime) {
-    pi.registerCommand("om-status", {
+export function registerStatusCommand(ext, runtime) {
+    ext.registerCommand("om-status", {
         description: "Show observational memory status",
         handler: async (_args, ctx) => {
             runtime.ensureConfig(ctx.cwd);

package/dist/memory/commands/view.d.ts

@@ -1,4 +1,4 @@
 import type { ExtensionAPI } from "../../sdk/coding-agent/index.js";
 import type { Runtime } from "../runtime.js";
-export declare function registerViewCommand(pi: ExtensionAPI, runtime: Runtime): void;
+export declare function registerViewCommand(ext: ExtensionAPI, runtime: Runtime): void;
 //# sourceMappingURL=view.d.ts.map

package/dist/memory/commands/view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAUpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA0E5E"}
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/view.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAUpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA0E7E"}

package/dist/memory/commands/view.js

@@ -3,8 +3,8 @@ import { observationPoolTokens as estimateObservationPoolTokens, observationsToM
 import { countByRelevance, formatRelevanceHistogram } from "../relevance.js";
 import { estimateStringTokens } from "../tokens.js";
 import { reflectionContent } from "../types.js";
-export function registerViewCommand(pi, runtime) {
-    pi.registerCommand("om-view", {
+export function registerViewCommand(ext, runtime) {
+    ext.registerCommand("om-view", {
         description: "Print observational memory details (reflections + observations)",
         handler: async (_args, ctx) => {
             runtime.ensureConfig(ctx.cwd);

package/dist/memory/hooks/compaction-hook.d.ts

@@ -1,4 +1,4 @@
 import type { ExtensionAPI } from "../../sdk/coding-agent/index.js";
 import type { Runtime } from "../runtime.js";
-export declare function registerCompactionHook(pi: ExtensionAPI, runtime: Runtime): void;
+export declare function registerCompactionHook(ext: ExtensionAPI, runtime: Runtime): void;
 //# sourceMappingURL=compaction-hook.d.ts.map

package/dist/memory/hooks/compaction-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction-hook.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/compaction-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AAsBtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AA6B7C,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA2V/E"}
+{"version":3,"file":"compaction-hook.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/compaction-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AAsBtF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AA6B7C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA2VhF"}

package/dist/memory/hooks/compaction-hook.js

@@ -20,8 +20,8 @@ function formatReflectorStats(stats) {
 function formatPrunerStats(result) {
     return `pruner dropped ${plural(result.droppedIds.length, "observation")} in ${plural(result.passes.length, "pass", "passes")}, stop: ${result.stopReason}`;
 }
-export function registerCompactionHook(pi, runtime) {
-    pi.on("session_before_compact", async (event, ctx) => {
+export function registerCompactionHook(ext, runtime) {
+    ext.on("session_before_compact", async (event, ctx) => {
         if (runtime.compactHookInFlight) {
             if (ctx.hasUI)
                 ctx.ui.notify("Observational memory: another compaction is already in progress; cancelling duplicate", "warning");
@@ -124,7 +124,7 @@ export function registerCompactionHook(pi, runtime) {
                                     coversUpToId: gapUpToId,
                                     records,
                                 });
-                                pi.appendEntry(OBSERVATION_CUSTOM_TYPE, gapObservationData);
+                                ext.appendEntry(OBSERVATION_CUSTOM_TYPE, gapObservationData);
                                 if (hasUI && ui)
                                     ui.notify(`Observational memory: sync catch-up recorded ${records.length} observation${records.length === 1 ? "" : "s"} (~${observationTokens.toLocaleString()} tokens)`, "info");
                             }
@@ -161,7 +161,7 @@ export function registerCompactionHook(pi, runtime) {
                 });
                 if (deltaObservationData.length === 0) {
                     // No new observations since last compaction. If we have existing memory,
-                    // carry it forward in a no-op compaction so it survives Pi's compaction.
+                    // carry it forward in a no-op compaction so it survives spectral's compaction.
                     // If there is truly nothing (no prior memory either), cancel.
                     if (memoryState.committedObs.length === 0 && memoryState.reflections.length === 0) {
                         debugLog("compaction.no_delta_cancel", {
@@ -296,7 +296,7 @@ export function registerCompactionHook(pi, runtime) {
     function persistProjectObservations(ctx, reflections) {
         const store = getProjectObsStore();
         if (!store)
-            return; // Not available in standalone pi mode.
+            return; // Not available in standalone spectral mode.
         const projectId = store.getProjectByCwd(ctx.cwd);
         if (!projectId)
             return; // No project registered for this cwd.

package/dist/memory/hooks/compaction-trigger.d.ts

@@ -1,4 +1,4 @@
 import type { ExtensionAPI } from "../../sdk/coding-agent/index.js";
 import type { Runtime } from "../runtime.js";
-export declare function registerCompactionTrigger(pi: ExtensionAPI, runtime: Runtime): void;
+export declare function registerCompactionTrigger(ext: ExtensionAPI, runtime: Runtime): void;
 //# sourceMappingURL=compaction-trigger.d.ts.map

package/dist/memory/hooks/compaction-trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction-trigger.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/compaction-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAU7C,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAsFlF"}
+{"version":3,"file":"compaction-trigger.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/compaction-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAU7C,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAsFnF"}

package/dist/memory/hooks/compaction-trigger.js

@@ -1,12 +1,12 @@
 import { rawTokensSinceLastCompaction } from "../branch.js";
 /**
- * Regex matching Pi's internal retryable error detection.
+ * Regex matching spectral's internal retryable error detection.
  * When the last assistant message in agent_end has stopReason "error" matching this pattern,
  * Pi will auto-retry — we must not trigger compaction between attempts.
  */
 const RETRYABLE_ERROR_RE = /overloaded|provider.?returned.?error|rate.?limit|too many requests|429|500|502|503|504|service.?unavailable|server.?error|internal.?error|network.?error|connection.?error|connection.?refused|connection.?lost|websocket.?closed|websocket.?error|other side closed|fetch failed|upstream.?connect|reset before headers|socket hang up|ended without|http2 request did not get a response|timed? out|timeout|terminated|retry delay/i;
-export function registerCompactionTrigger(pi, runtime) {
-    pi.on("agent_end", (event, ctx) => {
+export function registerCompactionTrigger(ext, runtime) {
+    ext.on("agent_end", (event, ctx) => {
         runtime.ensureConfig(ctx.cwd);
         if (runtime.config.passive === true)
             return;

package/dist/memory/hooks/observer-trigger.d.ts

@@ -1,4 +1,4 @@
 import type { ExtensionAPI } from "../../sdk/coding-agent/index.js";
 import type { Runtime } from "../runtime.js";
-export declare function registerObserverTrigger(pi: ExtensionAPI, runtime: Runtime): void;
+export declare function registerObserverTrigger(ext: ExtensionAPI, runtime: Runtime): void;
 //# sourceMappingURL=observer-trigger.d.ts.map

package/dist/memory/hooks/observer-trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observer-trigger.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/observer-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAWpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAK7C,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAyKhF"}
+{"version":3,"file":"observer-trigger.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/observer-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAWpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAK7C,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAyKjF"}

package/dist/memory/hooks/observer-trigger.js

@@ -5,8 +5,8 @@ import { observationsToPromptLines, runObserver } from "../observer.js";
 import { serializeSourceAddressedBranchEntries } from "../serialize.js";
 import { estimateEntryTokens, estimateStringTokens } from "../tokens.js";
 import { OBSERVATION_CUSTOM_TYPE, reflectionToPromptLine } from "../types.js";
-export function registerObserverTrigger(pi, runtime) {
-    pi.on("turn_end", (_event, ctx) => {
+export function registerObserverTrigger(ext, runtime) {
+    ext.on("turn_end", (_event, ctx) => {
         process.stderr.write("[obs-mem] turn_end fired\n");
         runtime.ensureConfig(ctx.cwd);
         if (runtime.config.passive === true) {
@@ -125,7 +125,7 @@ export function registerObserverTrigger(pi, runtime) {
                         coversUpToId: effectiveCoversUpToId,
                         tokenCount: 0,
                     };
-                    pi.appendEntry(OBSERVATION_CUSTOM_TYPE, placeholderData);
+                    ext.appendEntry(OBSERVATION_CUSTOM_TYPE, placeholderData);
                     debugLog("observer.empty_placeholder", { coversFromId, coversUpToId: effectiveCoversUpToId });
                     if (hasUI && ui)
                         ui.notify("Observational memory: observer returned no observations; bound advanced to prevent re-processing", "warning");
@@ -145,7 +145,7 @@ export function registerObserverTrigger(pi, runtime) {
                     coversUpToId: effectiveCoversUpToId,
                     records,
                 });
-                pi.appendEntry(OBSERVATION_CUSTOM_TYPE, data);
+                ext.appendEntry(OBSERVATION_CUSTOM_TYPE, data);
                 debugLog("observer.appended", { count: records.length, tokenCount: observationTokens, coversFromId, coversUpToId: effectiveCoversUpToId });
                 if (hasUI && ui)
                     ui.notify(`Observational memory: ${records.length} observation${records.length === 1 ? "" : "s"} recorded (~${observationTokens.toLocaleString()} tokens)`, "info");

package/dist/memory/index.d.ts

@@ -1,3 +1,3 @@
 import type { ExtensionAPI } from "../sdk/coding-agent/index.js";
-export default function observationalMemory(pi: ExtensionAPI): void;
+export default function observationalMemory(ext: ExtensionAPI): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAWjE,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,EAAE,EAAE,YAAY,QAe3D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAWjE,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,GAAG,EAAE,YAAY,QAe5D"}

package/dist/memory/index.js

@@ -7,16 +7,16 @@ import { Runtime } from "./runtime.js";
 import { registerRecallTool } from "./tools/recall-observation.js";
 import { registerReadProjectObservationsTool } from "./tools/read-project-observations.js";
 import { registerWriteProjectObservationTool } from "./tools/write-project-observation.js";
-export default function observationalMemory(pi) {
+export default function observationalMemory(ext) {
     const runtime = new Runtime();
     // Log extension load so we can confirm it's running in serve mode.
     process.stderr.write("[obs-mem] extension loaded\n");
-    registerObserverTrigger(pi, runtime);
-    registerCompactionTrigger(pi, runtime);
-    registerCompactionHook(pi, runtime);
-    registerStatusCommand(pi, runtime);
-    registerViewCommand(pi, runtime);
-    registerRecallTool(pi);
-    registerReadProjectObservationsTool(pi);
-    registerWriteProjectObservationTool(pi);
+    registerObserverTrigger(ext, runtime);
+    registerCompactionTrigger(ext, runtime);
+    registerCompactionHook(ext, runtime);
+    registerStatusCommand(ext, runtime);
+    registerViewCommand(ext, runtime);
+    registerRecallTool(ext);
+    registerReadProjectObservationsTool(ext);
+    registerWriteProjectObservationTool(ext);
 }

package/dist/memory/tools/read-project-observations.d.ts

@@ -4,5 +4,5 @@ export declare const READ_PROJECT_OBSERVATIONS_TOOL_NAME = "read_project_observa
 export declare const readProjectObservationsTool: import("../../sdk/coding-agent/index.js").ToolDefinition<Type.TObject<{
     query: Type.TString;
 }>, unknown> & import("../../sdk/coding-agent/index.js").ToolDefinition<any, any>;
-export declare function registerReadProjectObservationsTool(pi: ExtensionAPI): void;
+export declare function registerReadProjectObservationsTool(ext: ExtensionAPI): void;
 //# sourceMappingURL=read-project-observations.d.ts.map

package/dist/memory/tools/read-project-observations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-project-observations.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/read-project-observations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,eAAO,MAAM,2BAA2B;;iFAqFtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAE1E"}
+{"version":3,"file":"read-project-observations.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/read-project-observations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,eAAO,MAAM,2BAA2B;;iFAqFtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE3E"}

package/dist/memory/tools/read-project-observations.js

@@ -77,6 +77,6 @@ export const readProjectObservationsTool = defineTool({
         };
     },
 });
-export function registerReadProjectObservationsTool(pi) {
-    pi.registerTool(readProjectObservationsTool);
+export function registerReadProjectObservationsTool(ext) {
+    ext.registerTool(readProjectObservationsTool);
 }

package/dist/memory/tools/recall-observation.d.ts

@@ -58,6 +58,6 @@ export type RecallObservationToolDetails = {
 export declare const recallObservationTool: import("../../sdk/coding-agent/index.js").ToolDefinition<Type.TObject<{
     id: Type.TString;
 }>, unknown> & import("../../sdk/coding-agent/index.js").ToolDefinition<any, any>;
-export declare function registerRecallTool(pi: ExtensionAPI): void;
+export declare function registerRecallTool(ext: ExtensionAPI): void;
 export {};
 //# sourceMappingURL=recall-observation.d.ts.map

package/dist/memory/tools/recall-observation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recall-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/recall-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEhF,OAAO,EAGN,KAAK,uBAAuB,EAE5B,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvE,eAAO,MAAM,4BAA4B,WAAW,CAAC;AAIrD,KAAK,2BAA2B,GAC7B,IAAI,GACJ,SAAS,GACT,YAAY,GACZ,WAAW,GACX,WAAW,GACX,oBAAoB,GACpB,eAAe,CAAC;AAEnB,KAAK,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;AAChG,KAAK,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,SAAS,GAAG,0BAA0B,GAAG,QAAQ,CAAC,GAAG;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAExI,MAAM,MAAM,wBAAwB,GAAG;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,6BAA6B,GAAG;IACpC,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,kBAAkB,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAC3C,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,KAAK,6CAA6C,GAAG;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,4CAA4C,GAAG;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IAC1C,MAAM,EAAE,2BAA2B,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,wBAAwB,EAAE,6BAA6B,EAAE,CAAC;IAC1D,YAAY,EAAE,6BAA6B,EAAE,CAAC;IAC9C,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACzC,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C,iCAAiC,EAAE,6CAA6C,EAAE,CAAC;IACnF,+BAA+B,EAAE,4CAA4C,EAAE,CAAC;IAChF,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAuUF,eAAO,MAAM,qBAAqB;;iFAuChC,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAEzD"}
+{"version":3,"file":"recall-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/recall-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEhF,OAAO,EAGN,KAAK,uBAAuB,EAE5B,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvE,eAAO,MAAM,4BAA4B,WAAW,CAAC;AAIrD,KAAK,2BAA2B,GAC7B,IAAI,GACJ,SAAS,GACT,YAAY,GACZ,WAAW,GACX,WAAW,GACX,oBAAoB,GACpB,eAAe,CAAC;AAEnB,KAAK,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;AAChG,KAAK,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,SAAS,GAAG,0BAA0B,GAAG,QAAQ,CAAC,GAAG;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAExI,MAAM,MAAM,wBAAwB,GAAG;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,6BAA6B,GAAG;IACpC,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,kBAAkB,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAC3C,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,KAAK,6CAA6C,GAAG;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,4CAA4C,GAAG;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IAC1C,MAAM,EAAE,2BAA2B,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,wBAAwB,EAAE,6BAA6B,EAAE,CAAC;IAC1D,YAAY,EAAE,6BAA6B,EAAE,CAAC;IAC9C,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACzC,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C,iCAAiC,EAAE,6CAA6C,EAAE,CAAC;IACnF,+BAA+B,EAAE,4CAA4C,EAAE,CAAC;IAChF,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAuUF,eAAO,MAAM,qBAAqB;;iFAuChC,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE1D"}

package/dist/memory/tools/recall-observation.js

@@ -348,6 +348,6 @@ export const recallObservationTool = defineTool({
         return renderFoundResult(result);
     },
 });
-export function registerRecallTool(pi) {
-    pi.registerTool(recallObservationTool);
+export function registerRecallTool(ext) {
+    ext.registerTool(recallObservationTool);
 }

package/dist/memory/tools/write-project-observation.d.ts

@@ -5,5 +5,5 @@ export declare const writeProjectObservationTool: import("../../sdk/coding-agent
     content: Type.TString;
     relevance: Type.TUnion<[Type.TLiteral<"low">, Type.TLiteral<"medium">, Type.TLiteral<"high">, Type.TLiteral<"critical">]>;
 }>, unknown> & import("../../sdk/coding-agent/index.js").ToolDefinition<any, any>;
-export declare function registerWriteProjectObservationTool(pi: ExtensionAPI): void;
+export declare function registerWriteProjectObservationTool(ext: ExtensionAPI): void;
 //# sourceMappingURL=write-project-observation.d.ts.map

package/dist/memory/tools/write-project-observation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-project-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/write-project-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,eAAO,MAAM,2BAA2B;;;iFA6DtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAE1E"}
+{"version":3,"file":"write-project-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/write-project-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,eAAO,MAAM,2BAA2B;;;iFA6DtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE3E"}

package/dist/memory/tools/write-project-observation.js

@@ -55,6 +55,6 @@ export const writeProjectObservationTool = defineTool({
         };
     },
 });
-export function registerWriteProjectObservationTool(pi) {
-    pi.registerTool(writeProjectObservationTool);
+export function registerWriteProjectObservationTool(ext) {
+    ext.registerTool(writeProjectObservationTool);
 }

package/dist/preflight.d.ts

@@ -1,6 +1,6 @@
 /**
  * Shared pre-flight check: every authenticated `spectral` subcommand (and the
- * fall-through to pi) must verify that credentials exist in
+ * fall-through to spectral) must verify that credentials exist in
  * `~/.spectral/config.json` before proceeding.
  *
  * Extracted from `cli.ts` so `serve` (and any future subcommand) reuses the

package/dist/preflight.js

@@ -1,6 +1,6 @@
 /**
  * Shared pre-flight check: every authenticated `spectral` subcommand (and the
- * fall-through to pi) must verify that credentials exist in
+ * fall-through to spectral) must verify that credentials exist in
  * `~/.spectral/config.json` before proceeding.
  *
  * Extracted from `cli.ts` so `serve` (and any future subcommand) reuses the

package/dist/relay/auto-research.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-research handler — sends an auto-research task through the existing
- * AgentBridge (backend proxy) instead of spawning a separate pi process.
+ * AgentBridge (backend proxy) instead of spawning a separate spectral process.
  *
  * This ensures auto-research uses the same model and API keys as the active
  * session — no separate subprocess, no missing API key errors.
@@ -56,7 +56,7 @@ export interface AutoResearchExtension {
  * rather than thrown.
  *
  * This replaces the old subprocess-spawning approach. Instead of launching
- * a separate pi process (which lacks backend proxy credentials), we send
+ * a separate spectral process (which lacks backend proxy credentials), we send
  * the auto-research task through the session's existing AgentBridge. The agent
  * uses the session's model, backend proxy, and all available tools.
  */

package/dist/relay/auto-research.js

@@ -1,6 +1,6 @@
 /**
  * Auto-research handler — sends an auto-research task through the existing
- * AgentBridge (backend proxy) instead of spawning a separate pi process.
+ * AgentBridge (backend proxy) instead of spawning a separate spectral process.
  *
  * This ensures auto-research uses the same model and API keys as the active
  * session — no separate subprocess, no missing API key errors.
@@ -283,7 +283,7 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "## Pi Extension API Reference (HARD-CODED — DO NOT RESEARCH)",
         "",
         "This section is the canonical extension API. Use it directly — do NOT research",
-        "pi internals. For the full guide, see `cli-node/docs/extensions.md` in the pi repo.",
+        "spectral internals. For the full guide, see `cli-node/docs/extensions.md` in the spectral repo.",
         "",
         "### Extension Entry Point",
         "",
@@ -291,7 +291,7 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "",
         "```typescript",
         "import type { ExtensionAPI, ToolDefinition } from \"@aexol/spectral\";",
-        "export default function activate(pi: ExtensionAPI): void {",
+        "export default function activate(ext: ExtensionAPI): void {",
         "  // Register tools, commands, event handlers here",
         "}",
         "```",
@@ -299,14 +299,14 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "Extensions live in: `.spectral/extensions/` (project-local) or `~/.spectral/agent/extensions/` (user-global).",
         "Auto-research generates extensions into `.spectral/extensions/auto-research/<name>/`.",
         "",
-        "### Tools: pi.registerTool(tool)",
+        "### Tools: ext.registerTool(tool)",
         "",
         "The primary extension mechanism. Tools become callable by the LLM.",
         "",
         "```typescript",
         "import { Type } from \"typebox\";  // Built-in, zero-dependency schema validation",
         "",
-        "pi.registerTool({",
+        "ext.registerTool({",
         "  name: \"tool_name\",                // snake_case, globally unique",
         "  label: \"Tool Name\",                // Human-readable label for UI",
         "  description: \"What this tool does\", // Used by the LLM to decide when to call",
@@ -364,21 +364,21 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "}",
         "```",
         "",
-        "### Commands: pi.registerCommand(name, options)",
+        "### Commands: ext.registerCommand(name, options)",
         "",
         "Register slash-commands invoked as `/command-name`:",
         "",
         "```typescript",
-        "pi.registerCommand({",
+        "ext.registerCommand({",
         "  name: \"my-command\",",
         "  description: \"What /my-command does\",",
-        "  async execute(args: string[], ctx: ExtensionContext) {",
+        "  async execute(args: string, ctx: ExtensionContext) {",
         "    return { content: [{ type: \"text\", text: \"Done\" }] };",
         "  },",
         "});",
         "```",
         "",
-        "### Events: pi.on(eventType, handler)",
+        "### Events: ext.on(eventType, handler)",
         "",
         "Hook into the agent lifecycle. Handlers can observe, modify (return result), or block.",
         "",
@@ -414,27 +414,27 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "| `after_provider_response` | After provider API response | — |",
         "",
         "```typescript",
-        "pi.on(\"before_agent_start\", (event, ctx) => {",
+        "ext.on(\"before_agent_start\", (event, ctx) => {",
         "  // Inject extra instructions into every turn:",
         "  return { systemPrompt: event.systemPrompt + \"\\nExtra rules...\" };",
         "});",
         "",
-        "pi.on(\"tool_call\", (event, ctx) => {",
+        "ext.on(\"tool_call\", (event, ctx) => {",
         "  // event.name, event.params, event.toolCallId",
         "  // Return { blocked: true, reason: \"...\" } to block",
         "  // Return { params: {...} } to mutate input",
         "});",
         "```",
         "",
-        "### Actions: pi.sendMessage / pi.sendUserMessage / pi.exec",
+        "### Actions: ext.sendMessage / ext.sendUserMessage / ext.exec",
         "",
         "```typescript",
         "// Send custom messages into the session stream:",
-        "pi.sendMessage({ customType: \"my-event\", content: \"Something happened!\", display: \"Notification\", details: {} });",
-        "pi.sendUserMessage(\"Continue with the task.\");",
+        "ext.sendMessage({ customType: \"my-event\", content: \"Something happened!\", display: \"Notification\", details: {} });",
+        "ext.sendUserMessage(\"Continue with the task.\");",
         "",
         "// Run a shell command:",
-        "const result = await pi.exec(\"npm\", [\"test\"], { cwd: \"/path\" });",
+        "const result = await ext.exec(\"npm\", [\"test\"], { cwd: \"/path\" });",
         "// result.exitCode, result.stdout, result.stderr",
         "```",
         "",
@@ -442,26 +442,26 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "",
         "```typescript",
         "// Get/set thinking level (off | minimal | low | medium | high)",
-        "pi.getThinkingLevel();",
-        "pi.setThinkingLevel(\"high\");",
+        "ext.getThinkingLevel();",
+        "ext.setThinkingLevel(\"high\");",
         "",
         "// Tool visibility management",
-        "pi.getActiveTools();    // string[] — currently enabled tool names",
-        "pi.getAllTools();       // ToolInfo[] — all registered tools",
-        "pi.setActiveTools([\"bash\", \"read\", \"write\", \"edit\", \"my_tool\"]);",
+        "ext.getActiveTools();    // string[] — currently enabled tool names",
+        "ext.getAllTools();       // ToolInfo[] — all registered tools",
+        "ext.setActiveTools([\"bash\", \"read\", \"write\", \"edit\", \"my_tool\"]);",
         "```",
         "",
-        "### CLI Flags: pi.registerFlag",
+        "### CLI Flags: ext.registerFlag",
         "",
         "```typescript",
-        "pi.registerFlag(\"api-endpoint\", { description: \"Override API endpoint\", type: \"string\" });",
-        "const endpoint = pi.getFlag(\"api-endpoint\") as string;",
+        "ext.registerFlag(\"api-endpoint\", { description: \"Override API endpoint\", type: \"string\" });",
+        "const endpoint = ext.getFlag(\"api-endpoint\") as string;",
         "```",
         "",
-        "### Provider Registration: pi.registerProvider",
+        "### Provider Registration: ext.registerProvider",
         "",
         "```typescript",
-        "pi.registerProvider(\"my-proxy\", {",
+        "ext.registerProvider(\"my-proxy\", {",
         "  baseUrl: \"https://proxy.example.com\",",
         "  apiKey: \"sk-...\",",
         "  api: \"anthropic-messages\",",
@@ -471,10 +471,10 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "});",
         "```",
         "",
-        "### Keyboard Shortcuts: pi.registerShortcut",
+        "### Keyboard Shortcuts: ext.registerShortcut",
         "",
         "```typescript",
-        "pi.registerShortcut(\"ctrl+shift+k\", { description: \"Run custom action\", handler(ctx) { /* ... */ } });",
+        "ext.registerShortcut(\"ctrl+shift+k\", { description: \"Run custom action\", handler(ctx) { /* ... */ } });",
         "```",
         "",
         "### The ExtensionContext (ctx)",
@@ -506,7 +506,7 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "- All `node:*` built-ins: `fs`, `path`, `child_process`, `os`, `crypto`, etc.",
         "- Any npm package already in the project's node_modules",
         "",
-        "### Pi's Built-in Tools (what the agent already has — DO NOT reimplement)",
+        "### spectral's Built-in Tools (what the agent already has — DO NOT reimplement)",
         "",
         "- `read` — Read file contents",
         "- `write` — Create/overwrite files",
@@ -525,7 +525,7 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "```",
         ".spectral/extensions/auto-research/",
         "  <extension-name>/",
-        "    index.ts          # Entry point — default export activate(pi)",
+        "    index.ts          # Entry point — default export activate(ext)",
         "    utils.ts          # [optional] Helper functions",
         "    state.json        # [optional] Persisted state (for stateful extensions)",
         "```",
@@ -534,8 +534,8 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "",
         "1. **Shell wrapper** — Use `execSync` from \"node:child_process\" to run project commands",
         "2. **File processor** — Use `node:fs` to read/write project files",
-        "3. **LLM-powered** — Use `pi.modelRegistry` to call AI models for smart processing",
-        "4. **Event listener** — Use `pi.on()` to react to agent lifecycle events",
+        "3. **LLM-powered** — Use `ext.modelRegistry` to call AI models for smart processing",
+        "4. **Event listener** — Use `ext.on()` to react to agent lifecycle events",
         "5. **Stateful** — Use `node:fs` to persist state as JSON between calls",
         "6. **Subagent** — Use the `subagent` tool for isolated analysis tasks",
         "",
@@ -556,8 +556,8 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "   - Could LLM-powered extensions improve developer workflows?",
         "",
         "3. **Extension Generation** — Create extension .ts files:",
-        "   - Use `pi.registerTool()` for simple tools with TypeBox validation",
-        "   - Use `pi.registerCommand()` for custom slash commands",
+        "   - Use `ext.registerTool()` for simple tools with TypeBox validation",
+        "   - Use `ext.registerCommand()` for custom slash commands",
         "   - For LLM-powered extensions, use `ctx.modelRegistry` to call models",
         "   - Create files under `.spectral/extensions/auto-research/<name>/`",
         "   - Each extension needs an `index.ts` that registers its tools/commands",
@@ -685,7 +685,7 @@ const AR_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes — generous for LLM-based a
  * rather than thrown.
  *
  * This replaces the old subprocess-spawning approach. Instead of launching
- * a separate pi process (which lacks backend proxy credentials), we send
+ * a separate spectral process (which lacks backend proxy credentials), we send
  * the auto-research task through the session's existing AgentBridge. The agent
  * uses the session's model, backend proxy, and all available tools.
  */