@aexol/spectral 0.9.46 → 0.9.48

package/dist/relay/auto-optimizer.js

@@ -0,0 +1,488 @@
+/**
+ * Auto-Optimizer (CLI side)
+ *
+ * Two-phase pipeline for project file optimization, modeled after auto-research.
+ *
+ * Phase 1 — Analyze (action: "analyze"):
+ *   1. Scan project filesystem for optimization candidates (size, duplication, complexity).
+ *   2. Build an analysis prompt for the agent.
+ *   3. Send prompt to the agent session via manager.prompt() with skipPersistence.
+ *   4. Parse the agent's response into structured AutoOptimizeRecommendation[].
+ *   5. Emit auto_optimize_analysis_complete via relay with recommendations.
+ *
+ * Phase 2 — Execute (action: "execute"):
+ *   1. Receive approvedItemIds from the frame.
+ *   2. Apply each approved recommendation via the agent session.
+ *   3. Run quality gates (type-check, lint, tests) on modified files.
+ *   4. Emit auto_optimize_execution_complete with per-item results and gate status.
+ *
+ * All errors are surfaced as auto_optimize_error events on the wire.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { execSync } from "node:child_process";
+const activeAutoOptimizeSessions = new Set();
+const OPTIMIZER_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function sendEvent(relay, sessionId, event) {
+    relay.send({ kind: "ws_event", sessionId, event });
+}
+function makeRelaySubscriber(sessionId, relay) {
+    return {
+        send(event) {
+            relay.send({ kind: "ws_event", sessionId, event });
+        },
+        isOpen() {
+            return true;
+        },
+    };
+}
+/**
+ * Walk the project directory and collect file statistics.
+ * Skips node_modules, .git, .next, dist, build, .spectral, coverage.
+ * Respects MAX_FILES_SCAN limit.
+ */
+const MAX_FILES_SCAN = 2000;
+function scanProjectFiles(projectPath) {
+    const stats = [];
+    const skipDirs = new Set([
+        "node_modules",
+        ".git",
+        ".next",
+        "dist",
+        "build",
+        ".spectral",
+        "coverage",
+        "__pycache__",
+        ".turbo",
+    ]);
+    const stack = [projectPath];
+    while (stack.length > 0 && stats.length < MAX_FILES_SCAN) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                if (!skipDirs.has(entry.name) && !entry.name.startsWith(".")) {
+                    stack.push(path.join(dir, entry.name));
+                }
+            }
+            else if (entry.isFile()) {
+                const ext = path.extname(entry.name).toLowerCase();
+                // Only collect source files
+                if ([".ts", ".tsx", ".js", ".jsx", ".css", ".scss", ".less"].includes(ext)) {
+                    const fullPath = path.join(dir, entry.name);
+                    try {
+                        const content = fs.readFileSync(fullPath, "utf-8");
+                        const lines = content.split("\n").length;
+                        stats.push({
+                            path: path.relative(projectPath, fullPath),
+                            lines,
+                            ext,
+                        });
+                    }
+                    catch {
+                        // skip unreadable files
+                    }
+                }
+            }
+            if (stats.length >= MAX_FILES_SCAN)
+                break;
+        }
+    }
+    return stats;
+}
+/**
+ * Build the analyze-phase prompt sent to the agent.
+ * Uses adaptive heuristics: top N% by line count, growth signals,
+ * and DRY hints. No hard line limits — the agent decides.
+ */
+function buildAnalyzePrompt(fileStats, projectName) {
+    const sorted = [...fileStats].sort((a, b) => b.lines - a.lines);
+    const topFiles = sorted.slice(0, 20);
+    const topList = topFiles
+        .map((f, i) => `${i + 1}. \`${f.path}\` — ${f.lines} lines (${f.ext})`)
+        .join("\n");
+    const totalLines = fileStats.reduce((s, f) => s + f.lines, 0);
+    const fileCount = fileStats.length;
+    const avgLines = fileCount > 0 ? Math.round(totalLines / fileCount) : 0;
+    const medianLines = fileCount > 0
+        ? sorted[Math.floor(fileCount / 2)]?.lines ?? 0
+        : 0;
+    return [
+        `You are the Auto-Optimizer for the project "${projectName}".`,
+        ``,
+        `## Project File Stats`,
+        `- Total source files scanned: ${fileCount}`,
+        `- Total lines of code: ${totalLines}`,
+        `- Average lines per file: ${avgLines}`,
+        `- Median lines per file: ${medianLines}`,
+        ``,
+        `## Top Files by Line Count`,
+        topList,
+        ``,
+        `## Instructions`,
+        `Analyze the top files above and identify optimization opportunities.`,
+        `For each opportunity, provide a recommendation with:`,
+        `- **filePath**: relative path to the file`,
+        `- **issue**: what's wrong (too long, duplicated logic, mixed concerns, etc.)`,
+        `- **suggestion**: concrete refactoring to apply (extract hook/component, split file, deduplicate, etc.)`,
+        `- **severity**: "low", "medium", or "high"`,
+        `- **estimatedLineReduction** (optional): how many lines could be saved`,
+        ``,
+        `### Rules`,
+        `1. DO NOT use hard line limits. Use adaptive thresholds: files significantly above the project median or average.`,
+        `2. Focus on structural issues: component decomposition, hook extraction, DRY violations, mixed concerns.`,
+        `3. Avoid cosmetic-only changes (renames, formatting). Each recommendation must have a functional benefit.`,
+        `4. Be conservative — only recommend changes you are confident are correct and safe.`,
+        `5. NEVER recommend deleting functionality or changing public APIs without strong justification.`,
+        ``,
+        `Output your analysis as a JSON array of recommendation objects. Do NOT include markdown code fences — output raw JSON only.`,
+    ].join("\n");
+}
+/**
+ * Build the execute-phase prompt — applies approved recommendations.
+ */
+function buildExecutePrompt(approvedIds) {
+    return [
+        `You are the Auto-Optimizer. Execute the approved optimization recommendations.`,
+        ``,
+        `## Approved Recommendation IDs`,
+        approvedIds.map((id) => `- ${id}`).join("\n"),
+        ``,
+        `## Instructions`,
+        `Read each recommendation from the previous analysis, then:`,
+        `1. Apply the suggested refactoring to the target file(s).`,
+        `2. Ensure all imports, exports, and type references remain correct.`,
+        `3. After all changes: run type-check, lint, and tests on modified files.`,
+        `4. Report results per recommendation: success/fail, before/after line counts, and any errors.`,
+        ``,
+        `Output a JSON object with \`results\` (array) and \`gates\` (object with passed: boolean and results array).`,
+        `Do NOT include markdown code fences — output raw JSON only.`,
+    ].join("\n");
+}
+/**
+ * Parse the agent's response into structured recommendations.
+ * Handles both raw JSON and JSON-in-markdown-fences.
+ */
+function parseRecommendations(text) {
+    // Try extracting JSON from code fences first
+    const fenceMatch = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+    const jsonText = fenceMatch ? fenceMatch[1].trim() : text.trim();
+    try {
+        const parsed = JSON.parse(jsonText);
+        if (Array.isArray(parsed))
+            return parsed;
+        // Some models wrap in an object
+        if (parsed.recommendations && Array.isArray(parsed.recommendations)) {
+            return parsed.recommendations;
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
+function parseExecuteResults(text) {
+    const fenceMatch = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+    const jsonText = fenceMatch ? fenceMatch[1].trim() : text.trim();
+    try {
+        const parsed = JSON.parse(jsonText);
+        if (parsed.results && Array.isArray(parsed.results)) {
+            return { results: parsed.results };
+        }
+        if (Array.isArray(parsed)) {
+            return { results: parsed };
+        }
+        return { results: [] };
+    }
+    catch {
+        return { results: [] };
+    }
+}
+async function runQualityGates(projectPath) {
+    const gates = [];
+    // Gate 1: TypeScript type-check
+    const hasTsConfig = fs.existsSync(path.join(projectPath, "tsconfig.json"));
+    if (hasTsConfig) {
+        try {
+            execSync("npx tsc --noEmit", {
+                cwd: projectPath,
+                timeout: 60_000,
+                stdio: "pipe",
+            });
+            gates.push({ gate: "tsc", passed: true, message: "TypeScript type-check passed." });
+        }
+        catch (err) {
+            const e = err;
+            const raw = e.stderr?.toString() || e.message || "Unknown error";
+            const short = raw.length > 500 ? raw.slice(0, 500) + "..." : raw;
+            gates.push({ gate: "tsc", passed: false, message: `TypeScript errors:\n${short}` });
+        }
+    }
+    // Gate 2: Next.js lint (if Next.js project)
+    const hasNextConfig = fs.existsSync(path.join(projectPath, "next.config.ts")) ||
+        fs.existsSync(path.join(projectPath, "next.config.js")) ||
+        fs.existsSync(path.join(projectPath, "next.config.mjs"));
+    if (hasNextConfig) {
+        try {
+            execSync("npx next lint --no-cache", {
+                cwd: projectPath,
+                timeout: 120_000,
+                stdio: "pipe",
+            });
+            gates.push({ gate: "next lint", passed: true, message: "Next.js lint passed." });
+        }
+        catch (err) {
+            const e = err;
+            const raw = e.stderr?.toString() || e.message || "Unknown error";
+            const short = raw.length > 500 ? raw.slice(0, 500) + "..." : raw;
+            gates.push({ gate: "next lint", passed: false, message: `Lint errors:\n${short}` });
+        }
+    }
+    // Gate 3: Deno lint (if Deno project and not already Next.js)
+    const hasDenoJson = fs.existsSync(path.join(projectPath, "deno.json"));
+    if (hasDenoJson && !hasNextConfig) {
+        try {
+            execSync("deno lint", {
+                cwd: projectPath,
+                timeout: 60_000,
+                stdio: "pipe",
+            });
+            gates.push({ gate: "deno lint", passed: true, message: "Deno lint passed." });
+        }
+        catch (err) {
+            const e = err;
+            const raw = e.stderr?.toString() || e.message || "Unknown error";
+            const short = raw.length > 500 ? raw.slice(0, 500) + "..." : raw;
+            gates.push({ gate: "deno lint", passed: false, message: `Lint errors:\n${short}` });
+        }
+    }
+    // If no gates ran, return informational note
+    if (gates.length === 0) {
+        gates.push({
+            gate: "info",
+            passed: true,
+            message: "No quality gates configured for this project type.",
+        });
+    }
+    return gates;
+}
+// ---------------------------------------------------------------------------
+// Main handler
+// ---------------------------------------------------------------------------
+export function handleAutoOptimize(input, deps) {
+    const { projectId, sessionId, action, approvedItemIds } = input;
+    const { store, manager, relay, subscribers } = deps;
+    const logger = deps.logger ?? console;
+    if (activeAutoOptimizeSessions.has(sessionId)) {
+        sendEvent(relay, sessionId, {
+            type: "auto_optimize_error",
+            projectId,
+            message: "Auto-optimizer is already running for this session.",
+        });
+        return;
+    }
+    const project = store.getProject(projectId);
+    if (!project) {
+        sendEvent(relay, sessionId, {
+            type: "auto_optimize_error",
+            projectId,
+            message: `Project not found: ${projectId}`,
+        });
+        return;
+    }
+    // Validate action-specific requirements
+    if (action === "execute" && (!approvedItemIds || approvedItemIds.length === 0)) {
+        sendEvent(relay, sessionId, {
+            type: "auto_optimize_error",
+            projectId,
+            message: "Execute action requires approvedItemIds.",
+        });
+        return;
+    }
+    sendEvent(relay, sessionId, {
+        type: "auto_optimize_start",
+        projectId,
+        action,
+    });
+    // Ensure a subscriber exists for this session
+    let subscriber = subscribers.get(sessionId);
+    if (!subscriber) {
+        subscriber = makeRelaySubscriber(sessionId, relay);
+        try {
+            manager.attach(sessionId, subscriber);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            sendEvent(relay, sessionId, {
+                type: "auto_optimize_error",
+                projectId,
+                message: `Failed to attach session subscriber: ${msg}`,
+            });
+            return;
+        }
+        subscribers.set(sessionId, subscriber);
+    }
+    // Build task content based on phase
+    let taskContent;
+    if (action === "analyze") {
+        const projectPath = project.path;
+        const fileStats = scanProjectFiles(projectPath);
+        if (fileStats.length === 0) {
+            sendEvent(relay, sessionId, {
+                type: "auto_optimize_error",
+                projectId,
+                message: "No source files found in project.",
+            });
+            return;
+        }
+        taskContent = buildAnalyzePrompt(fileStats, project.name);
+    }
+    else {
+        taskContent = buildExecutePrompt(approvedItemIds);
+    }
+    const storedModelId = store.getSessionModel(sessionId) ?? undefined;
+    activeAutoOptimizeSessions.add(sessionId);
+    // Phase 3: buffer text_delta events to parse the agent's structured output
+    let textBuffer = "";
+    let watcherFired = false;
+    const doCleanupAndSend = (event) => {
+        activeAutoOptimizeSessions.delete(sessionId);
+        try {
+            manager.detach(sessionId, watcher);
+        }
+        catch {
+            // already detached
+        }
+        sendEvent(relay, sessionId, event);
+    };
+    let retryCount = 0;
+    const MAX_PROMPT_RETRIES = 3;
+    const isCompactingError = (msg) => /compacting|compacted|wait.*moment|try again/i.test(msg);
+    const sendPrompt = () => {
+        manager
+            .prompt(sessionId, taskContent, storedModelId, undefined, undefined, {
+            skipPersistence: true,
+        })
+            .catch((err) => {
+            if (watcherFired)
+                return;
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error?.(`[auto-optimizer] manager.prompt failed for ${sessionId}:`, msg);
+            clearTimeout(timeout);
+            watcherFired = true;
+            doCleanupAndSend({
+                type: "auto_optimize_error",
+                projectId,
+                message: `Auto-optimizer prompt failed: ${msg}`,
+            });
+        });
+    };
+    const watcher = {
+        send(event) {
+            if (watcherFired)
+                return;
+            if (event.type === "text_delta") {
+                textBuffer += event.delta;
+                return;
+            }
+            if (event.type === "agent_end") {
+                watcherFired = true;
+                clearTimeout(timeout);
+                if (action === "analyze") {
+                    const recommendations = parseRecommendations(textBuffer);
+                    logger.error?.(`[auto-optimizer] analyze complete: ${recommendations.length} recommendations from ${textBuffer.length} chars`);
+                    doCleanupAndSend({
+                        type: "auto_optimize_analysis_complete",
+                        projectId,
+                        recommendations,
+                    });
+                }
+                else {
+                    // execute — parse results then run quality gates (Phase 5)
+                    const { results } = parseExecuteResults(textBuffer);
+                    logger.error?.(`[auto-optimizer] execute complete: ${results.length} results, running quality gates...`);
+                    runQualityGates(project.path)
+                        .then((gateResults) => {
+                        const gatesPassed = gateResults.every((g) => g.passed);
+                        doCleanupAndSend({
+                            type: "auto_optimize_execution_complete",
+                            projectId,
+                            results,
+                            gatesPassed,
+                            gateResults,
+                        });
+                    })
+                        .catch((err) => {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        logger.error?.("[auto-optimizer] quality gates crashed:", msg);
+                        doCleanupAndSend({
+                            type: "auto_optimize_error",
+                            projectId,
+                            message: `Quality gates failed: ${msg}`,
+                        });
+                    });
+                }
+            }
+            else if (event.type === "error") {
+                const errorMsg = typeof event.message === "string" ? event.message : "";
+                // If the session is compacting, retry prompt with backoff
+                // instead of immediately failing
+                if (isCompactingError(errorMsg) &&
+                    retryCount < MAX_PROMPT_RETRIES) {
+                    retryCount++;
+                    const delay = 2000 * Math.pow(2, retryCount - 1); // 2s, 4s, 8s
+                    logger.error?.(`[auto-optimizer] session compacting, retrying prompt ${retryCount}/${MAX_PROMPT_RETRIES} in ${delay}ms`);
+                    setTimeout(() => {
+                        if (watcherFired)
+                            return;
+                        sendPrompt();
+                    }, delay);
+                    return;
+                }
+                watcherFired = true;
+                clearTimeout(timeout);
+                doCleanupAndSend({
+                    type: "auto_optimize_error",
+                    projectId,
+                    message: event.message,
+                });
+            }
+        },
+        isOpen() {
+            return true;
+        },
+    };
+    try {
+        manager.attach(sessionId, watcher);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        watcherFired = true;
+        doCleanupAndSend({
+            type: "auto_optimize_error",
+            projectId,
+            message: `Failed to attach auto-optimizer watcher: ${msg}`,
+        });
+        return;
+    }
+    const timeout = setTimeout(() => {
+        if (watcherFired)
+            return;
+        watcherFired = true;
+        doCleanupAndSend({
+            type: "auto_optimize_error",
+            projectId,
+            message: "Auto-optimizer timed out after 10 minutes.",
+        });
+    }, OPTIMIZER_TIMEOUT_MS);
+    sendPrompt();
+}

package/dist/relay/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/relay/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,SAAS,MAAM,IAAI,CAAC;AAqB3B,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,SAAS,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACjD;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAmB;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAE/C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,SAAS,CAAgB;IACjC,iFAAiF;IACjF,OAAO,CAAC,UAAU,CAAS;IAE3B,qEAAqE;IACrE,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,aAAa,CAA+B;gBAExC,IAAI,EAAE,kBAAkB;IAWpC,kEAAkE;IAClE,OAAO,IAAI,IAAI;IAMf;;;;;;;OAOG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO;IAqBzC;;;OAGG;IACH,OAAO,IAAI,IAAI;IA2Bf,OAAO,CAAC,UAAU;IAsIlB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,YAAY;IAOpB;;;;;OAKG;YACW,WAAW;YA8BX,iBAAiB;CAmDhC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/relay/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,SAAS,MAAM,IAAI,CAAC;AAqB3B,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,SAAS,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACjD;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAmB;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAE/C,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,SAAS,CAAgB;IACjC,iFAAiF;IACjF,OAAO,CAAC,UAAU,CAAS;IAE3B,qEAAqE;IACrE,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,aAAa,CAA+B;gBAExC,IAAI,EAAE,kBAAkB;IAWpC,kEAAkE;IAClE,OAAO,IAAI,IAAI;IAMf;;;;;;;OAOG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO;IAqBzC;;;OAGG;IACH,OAAO,IAAI,IAAI;IA2Bf,OAAO,CAAC,UAAU;IAgJlB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,YAAY;IAOpB;;;;;OAKG;YACW,WAAW;YA8BX,iBAAiB;CAmDhC"}

package/dist/relay/client.js

@@ -258,6 +258,16 @@ export class RelayClient extends EventEmitter {
                 this.exit(1);
                 return;
             }
+            if (reasonStr === "team-changed") {
+                // Team was changed via Studio — the machine_team_changed frame handler
+                // in serve.ts already saved the new JWT. Just reconnect normally.
+                if (this.authFailed) {
+                    this.emit("auth-failed");
+                    return;
+                }
+                this.scheduleReconnect();
+                return;
+            }
             // Auth failure at the transport layer (HTTP 401/403 on WS upgrade).
             // The machine JWT is invalid (expired, malformed, or revoked by key
             // rotation) but the backend didn't send a structured close reason.

package/dist/relay/dispatcher.d.ts

@@ -38,7 +38,7 @@
  *    or `code:"machine_offline"` (CLI socket dropped). Both are
  *    transparent to this layer — we just respond when we can.
  */
-import type { AutoResearchFrame, CancelTurnFrame, ClientMessageFrame, MetaEvent, RestRequestFrame, RestResponseFrame, SubscribeFrame } from "@aexol/relay-protocol";
+import type { AutoOptimizeFrame, AutoResearchFrame, CancelTurnFrame, ClientMessageFrame, MetaEvent, RestRequestFrame, RestResponseFrame, SubscribeFrame } from "@aexol/relay-protocol";
 import type { McpExtensionState } from "../mcp/state.js";
 import type { SessionStreamManager, Subscriber } from "../server/session-stream.js";
 import type { SessionStore } from "../server/storage.js";
@@ -48,7 +48,7 @@ import type { RelayClient } from "./client.js";
  * `id` is populated when the route had an `:id` placeholder.
  */
 interface RouteMatch {
-    route: "list_projects" | "create_project" | "update_project" | "delete_project" | "bind_studio" | "unbind_studio" | "get_project_observations" | "list_project_sessions" | "cleanup_project_sessions" | "create_session" | "get_session" | "get_session_messages" | "update_session" | "delete_session" | "get_session_memory" | "get_session_memory_details" | "compact_session" | "remember_and_delete_session" | "fork_session" | "list_path_autocomplete" | "pick_directory" | "search_project_files" | "enqueue_prompt" | "get_prompt_queue" | "remove_prompt" | "clear_prompt_queue" | "list_mcp_status" | "reload_mcp_config" | "refresh_native_extensions" | "get_settings" | "put_settings" | "get_agent_settings" | "put_agent_settings" | "list_agents";
+    route: "list_projects" | "create_project" | "update_project" | "delete_project" | "bind_studio" | "unbind_studio" | "get_project_observations" | "list_project_sessions" | "cleanup_project_sessions" | "create_session" | "get_session" | "get_session_messages" | "update_session" | "delete_session" | "get_session_memory" | "get_session_memory_details" | "compact_session" | "remember_and_delete_session" | "fork_session" | "list_path_autocomplete" | "pick_directory" | "search_project_files" | "enqueue_prompt" | "get_prompt_queue" | "remove_prompt" | "clear_prompt_queue" | "list_mcp_status" | "reload_mcp_config" | "refresh_native_extensions" | "get_settings" | "put_settings" | "get_agent_settings" | "put_agent_settings" | "get_prompt_mutation_settings" | "put_prompt_mutation_settings" | "list_agents";
     id?: string;
     /** Parsed query params, if the path carried a `?...` suffix. */
     query?: URLSearchParams;
@@ -215,5 +215,23 @@ export interface AutoResearchDeps {
  * Errors are surfaced as `auto_research_error` events.
  */
 export declare function handleAutoResearchFrame(frame: AutoResearchFrame, deps: AutoResearchDeps): void;
+/** Dependencies for auto-optimizer — mirror of AutoResearchDeps. */
+export interface AutoOptimizeDeps {
+    store: SessionStore;
+    manager: SessionStreamManager;
+    relay: Pick<RelayClient, "send">;
+    subscribers: Map<string, Subscriber>;
+    cwd: string;
+    logger?: {
+        error: (...args: unknown[]) => void;
+    };
+}
+/**
+ * Dispatch an `auto_optimize` frame. Two-phase flow controlled by `action`:
+ * - "analyze" scans the project and streams back `auto_optimize_analysis_complete`.
+ * - "execute" applies approved recommendations and runs gate checks.
+ * Progress/results are streamed as `auto_optimize_*` ws_events on `sessionId`.
+ */
+export declare function handleAutoOptimizeFrame(frame: AutoOptimizeFrame, deps: AutoOptimizeDeps): void;
 export {};
 //# sourceMappingURL=dispatcher.d.ts.map

package/dist/relay/dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/relay/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAIH,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACf,MAAM,uBAAuB,CAAC;AAK/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AA0CzD,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACX,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/C;;;GAGG;AACH,UAAU,UAAU;IAClB,KAAK,EACD,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,aAAa,GACb,eAAe,GACf,0BAA0B,GAC1B,uBAAuB,GACvB,0BAA0B,GAC1B,gBAAgB,GAChB,aAAa,GACb,sBAAsB,GACtB,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,GACpB,4BAA4B,GAC5B,iBAAiB,GACjB,6BAA6B,GAC7B,cAAc,GACd,wBAAwB,GACxB,gBAAgB,GAChB,sBAAsB,GACtB,gBAAgB,GAChB,kBAAkB,GAClB,eAAe,GACf,oBAAoB,GACpB,iBAAiB,GACjB,mBAAmB,GACnB,2BAA2B,GAC3B,cAAc,GACd,cAAc,GACd,oBAAoB,GACpB,oBAAoB,GACpB,aAAa,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,UAAU,GAAG,IAAI,CAgLnB;AAMD;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,6FAA6F;IAC7F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uGAAuG;IACvG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,uBAAuB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAiD5B;AAwXD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,2DAA2D;IAC3D,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;;;;;OASG;IACH,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,yEAAyE;IACzE,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;CAClD;AA8BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,iBAAiB,GACtB,IAAI,CAyIN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,iBAAiB,GACtB,IAAI,CA0DN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE;IAAE,OAAO,EAAE,oBAAoB,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAA;CAAE,GACxF,IAAI,CAEN;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,oBAAoB,EAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GACnC,IAAI,CASN;AAMD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACjC,sDAAsD;IACtD,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;CAClD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,gBAAgB,GACrB,IAAI,CAQN"}
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/relay/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAIH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACf,MAAM,uBAAuB,CAAC;AAK/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AA8CzD,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACX,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ/C;;;GAGG;AACH,UAAU,UAAU;IAClB,KAAK,EACD,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,aAAa,GACb,eAAe,GACf,0BAA0B,GAC1B,uBAAuB,GACvB,0BAA0B,GAC1B,gBAAgB,GAChB,aAAa,GACb,sBAAsB,GACtB,gBAAgB,GAChB,gBAAgB,GAChB,oBAAoB,GACpB,4BAA4B,GAC5B,iBAAiB,GACjB,6BAA6B,GAC7B,cAAc,GACd,wBAAwB,GACxB,gBAAgB,GAChB,sBAAsB,GACtB,gBAAgB,GAChB,kBAAkB,GAClB,eAAe,GACf,oBAAoB,GACpB,iBAAiB,GACjB,mBAAmB,GACnB,2BAA2B,GAC3B,cAAc,GACd,cAAc,GACd,oBAAoB,GACpB,oBAAoB,GACpB,8BAA8B,GAC9B,8BAA8B,GAC9B,aAAa,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,UAAU,GAAG,IAAI,CAqLnB;AAMD;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,6FAA6F;IAC7F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uGAAuG;IACvG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,uBAAuB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAiD5B;AAoYD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,2DAA2D;IAC3D,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;;;;;OASG;IACH,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,yEAAyE;IACzE,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;CAClD;AA8BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,iBAAiB,GACtB,IAAI,CAyIN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,iBAAiB,GACtB,IAAI,CA0DN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE;IAAE,OAAO,EAAE,oBAAoB,CAAC;IAAC,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAA;CAAE,GACxF,IAAI,CAEN;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,oBAAoB,EAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GACnC,IAAI,CASN;AAMD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACjC,sDAAsD;IACtD,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;CAClD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,gBAAgB,GACrB,IAAI,CAQN;AAED,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;CAClD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,gBAAgB,GACrB,IAAI,CAUN"}

package/dist/relay/dispatcher.js

@@ -50,8 +50,10 @@ import { handleCompactSession, handleCreateSession, handleDeleteSession, handleF
 import { handleClearPromptQueue, handleEnqueuePrompt, handleGetPromptQueue, handleRemovePrompt, } from "../server/handlers/queue.js";
 import { handleGetAgentSettings, handleListAgents, handlePutAgentSettings, } from "../server/handlers/agent-settings.js";
 import { handleGetSettings, handlePutSettings, } from "../server/handlers/settings.js";
+import { handleGetPromptMutationSettings, handlePutPromptMutationSettings, } from "../server/handlers/prompt-mutation-settings.js";
 import { shutdownState } from "../server/shutdown.js";
 import { handleAutoResearch } from "./auto-research.js";
+import { handleAutoOptimize } from "./auto-optimizer.js";
 /**
  * Inline path matcher. Returns `null` for any path/method combination we
  * don't recognise; the caller turns that into a `404 Unknown route`.
@@ -96,6 +98,13 @@ export function matchRoute(method, path) {
             return { route: "put_agent_settings" };
         return null;
     }
+    if (cleanPath === "/api/prompt-mutation-settings") {
+        if (method === "GET")
+            return { route: "get_prompt_mutation_settings" };
+        if (method === "PUT")
+            return { route: "put_prompt_mutation_settings" };
+        return null;
+    }
     // /api/agents
     if (cleanPath === "/api/agents") {
         if (method === "GET")
@@ -554,6 +563,10 @@ async function dispatchRoute(match, body, deps) {
             return handleGetAgentSettings(deps.cwd ?? homedir(), deps.agentDir);
         case "put_agent_settings":
             return handlePutAgentSettings(deps.cwd ?? homedir(), asObject(body), deps.agentDir);
+        case "get_prompt_mutation_settings":
+            return handleGetPromptMutationSettings(deps.cwd ?? homedir(), deps.agentDir);
+        case "put_prompt_mutation_settings":
+            return handlePutPromptMutationSettings(deps.cwd ?? homedir(), asObject(body), deps.agentDir);
         case "list_agents": {
             const agentCwd = match.query?.get("cwd") || deps.cwd || homedir();
             return handleListAgents(agentCwd, deps.agentDir);
@@ -899,3 +912,17 @@ export function handleAutoResearchFrame(frame, deps) {
         sessionId: frame.sessionId,
     }, deps);
 }
+/**
+ * Dispatch an `auto_optimize` frame. Two-phase flow controlled by `action`:
+ * - "analyze" scans the project and streams back `auto_optimize_analysis_complete`.
+ * - "execute" applies approved recommendations and runs gate checks.
+ * Progress/results are streamed as `auto_optimize_*` ws_events on `sessionId`.
+ */
+export function handleAutoOptimizeFrame(frame, deps) {
+    handleAutoOptimize({
+        projectId: frame.projectId,
+        sessionId: frame.sessionId,
+        action: frame.action,
+        approvedItemIds: frame.approvedItemIds,
+    }, deps);
+}

package/dist/sdk/coding-agent/core/agent-session.d.ts

@@ -78,6 +78,10 @@ export type AgentSessionEvent = Exclude<AgentEvent, {
     type: "compaction_delta";
     delta: string;
     content: string;
+} | {
+    type: "prompt_mutation_status";
+    phase: "mutating" | "done";
+    message?: string;
 };
 /** Listener function for agent session events */
 export type AgentSessionEventListener = (event: AgentSessionEvent) => void;
@@ -198,6 +202,7 @@ export declare class AgentSession {
     private _extensionCommandContextActions?;
     private _extensionAbortHandler?;
     private _extensionShutdownHandler?;
+    private _promptMutationApplied;
     private _extensionErrorListener?;
     private _extensionErrorUnsubscriber?;
     private _modelRegistry;
@@ -316,6 +321,7 @@ export declare class AgentSession {
     private _normalizePromptGuidelines;
     private _rebuildSystemPrompt;
     private _runAgentPrompt;
+    private _applyPromptMutationIfNeeded;
     private _handlePostAgentRun;
     /**
      * Send a prompt to the agent.