@automaton-labs/aib 0.0.6 → 0.0.8

package/dist/commands/execution-command.js

@@ -1 +1,117 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.runExecutionCommand=R;const d=require("./apply-module-plan"),p=require("./module-plan-cache"),f=require("./refactor-batch"),h=require("./refactor-batch-execution-cache"),m=require("./rename-entities"),_=require("./rename-execution-cache"),E=require("../shared/errors");function R(t,e){const[n="status",...a]=e;if(n==="status"){const c=N(a,"--execution")??y(a)??"last";return P(t,c)}throw new E.CliError("UNKNOWN_EXECUTION_COMMAND",`Unknown execution command: ${n}`,{availableCommands:["execution status"]})}function P(t,e){if(e==="last"){const r=x(t,"last"),o=(0,h.tryReadRefactorBatchExecutionStatus)(t,"last"),u=(0,_.tryReadRenameExecutionStatus)(t,"last");if(r||o||u){const s=r?Date.parse(r.updatedAt):0,i=o?Date.parse(o.updatedAt):0,l=u?Date.parse(u.updatedAt):0;return l>s&&l>i?(0,m.readCachedRenameExecution)(t,"last"):i>s?(0,f.readCachedRefactorBatchExecution)(t,"last"):(0,d.readCachedModulePlanExecution)(t,"last")}C(e)}if((0,_.tryReadRenameExecutionStatus)(t,e))return(0,m.readCachedRenameExecution)(t,e);if((0,h.tryReadRefactorBatchExecutionStatus)(t,e))return(0,f.readCachedRefactorBatchExecution)(t,e);if(x(t,e))return(0,d.readCachedModulePlanExecution)(t,e);C(e)}function x(t,e){try{return(0,p.readModulePlanExecutionStatus)(t,e)}catch{return null}}function C(t){throw new E.CliError("EXECUTION_NOT_FOUND",`Execution status not found: ${t}`,{executionId:t})}function N(t,e){const n=t.indexOf(e);if(n<0)return null;const a=t[n+1];return a&&!a.startsWith("--")?a:null}function y(t){return t.find(e=>!e.startsWith("--"))??null}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runExecutionCommand = runExecutionCommand;
+const apply_module_plan_1 = require("./apply-module-plan");
+const file_refactor_batch_1 = require("./file-refactor-batch");
+const file_refactor_batch_execution_cache_1 = require("./file-refactor-batch-execution-cache");
+const declaration_command_1 = require("./declaration-command");
+const file_rename_1 = require("./file-rename");
+const file_rename_execution_cache_1 = require("./file-rename-execution-cache");
+const file_move_to_dir_1 = require("./file-move-to-dir");
+const file_move_to_dir_execution_cache_1 = require("./file-move-to-dir-execution-cache");
+const module_plan_cache_1 = require("./module-plan-cache");
+const refactor_batch_1 = require("./refactor-batch");
+const refactor_batch_execution_cache_1 = require("./refactor-batch-execution-cache");
+const mutate_execution_status_1 = require("./mutate-execution-status");
+const mutate_execution_cache_1 = require("./mutate-execution-cache");
+const rename_entities_1 = require("./rename-entities");
+const rename_execution_cache_1 = require("./rename-execution-cache");
+const errors_1 = require("../shared/errors");
+function runExecutionCommand(cwd, restArgs) {
+    const [action = "status", ...actionArgs] = restArgs;
+    if (action === "status") {
+        const executionId = readFlagValue(actionArgs, "--execution") ?? firstPositional(actionArgs) ?? "last";
+        return readCachedExecution(cwd, executionId);
+    }
+    throw new errors_1.CliError("UNKNOWN_EXECUTION_COMMAND", `Unknown execution command: ${action}`, {
+        availableCommands: [
+            "execution status"
+        ]
+    });
+}
+function readCachedExecution(cwd, executionId) {
+    if (executionId === "last") {
+        const mutate = (0, mutate_execution_cache_1.tryReadMutateExecutionStatus)(cwd, "last");
+        const modulePlan = tryReadModulePlanExecutionStatus(cwd, "last");
+        const refactorBatch = (0, refactor_batch_execution_cache_1.tryReadRefactorBatchExecutionStatus)(cwd, "last");
+        const rename = (0, rename_execution_cache_1.tryReadRenameExecutionStatus)(cwd, "last");
+        const fileMoveToDir = (0, file_move_to_dir_execution_cache_1.tryReadFileMoveToDirExecutionStatus)(cwd, "last");
+        const fileRename = (0, file_rename_execution_cache_1.tryReadFileRenameExecutionStatus)(cwd, "last");
+        const fileRefactorBatch = (0, file_refactor_batch_execution_cache_1.tryReadFileRefactorBatchExecutionStatus)(cwd, "last");
+        const declaration = (0, declaration_command_1.tryReadDeclarationExecutionStatus)(cwd, "last");
+        const candidates = [
+            mutate ? { updatedAt: Date.parse(mutate.updatedAt), read: () => (0, mutate_execution_status_1.readCachedMutateExecution)(cwd, "last", { includeOperationHeader: true }) } : null,
+            modulePlan ? { updatedAt: Date.parse(modulePlan.updatedAt), read: () => (0, apply_module_plan_1.readCachedModulePlanExecution)(cwd, "last") } : null,
+            refactorBatch ? { updatedAt: Date.parse(refactorBatch.updatedAt), read: () => (0, refactor_batch_1.readCachedRefactorBatchExecution)(cwd, "last") } : null,
+            rename ? { updatedAt: Date.parse(rename.updatedAt), read: () => (0, rename_entities_1.readCachedRenameExecution)(cwd, "last") } : null,
+            fileMoveToDir ? { updatedAt: Date.parse(fileMoveToDir.updatedAt), read: () => (0, file_move_to_dir_1.readCachedFileMoveToDirExecution)(cwd, "last") } : null,
+            fileRename ? { updatedAt: Date.parse(fileRename.updatedAt), read: () => (0, file_rename_1.readCachedFileRenameExecution)(cwd, "last") } : null,
+            fileRefactorBatch ? { updatedAt: Date.parse(fileRefactorBatch.updatedAt), read: () => (0, file_refactor_batch_1.readCachedFileRefactorBatchExecution)(cwd, "last") } : null,
+            declaration ? { updatedAt: Date.parse(declaration.updatedAt), read: () => (0, declaration_command_1.readCachedDeclarationExecution)(cwd, "last") } : null
+        ].filter((candidate) => Boolean(candidate));
+        if (candidates.length > 0) {
+            const latest = candidates.sort((left, right) => right.updatedAt - left.updatedAt)[0];
+            if (latest) {
+                return latest.read();
+            }
+        }
+        throwExecutionNotFound(executionId);
+    }
+    const mutate = (0, mutate_execution_cache_1.tryReadMutateExecutionStatus)(cwd, executionId);
+    if (mutate) {
+        return (0, mutate_execution_status_1.readCachedMutateExecution)(cwd, executionId);
+    }
+    const fileMoveToDir = (0, file_move_to_dir_execution_cache_1.tryReadFileMoveToDirExecutionStatus)(cwd, executionId);
+    if (fileMoveToDir) {
+        return (0, file_move_to_dir_1.readCachedFileMoveToDirExecution)(cwd, executionId);
+    }
+    const fileRename = (0, file_rename_execution_cache_1.tryReadFileRenameExecutionStatus)(cwd, executionId);
+    if (fileRename) {
+        return (0, file_rename_1.readCachedFileRenameExecution)(cwd, executionId);
+    }
+    const fileRefactorBatch = (0, file_refactor_batch_execution_cache_1.tryReadFileRefactorBatchExecutionStatus)(cwd, executionId);
+    if (fileRefactorBatch) {
+        return (0, file_refactor_batch_1.readCachedFileRefactorBatchExecution)(cwd, executionId);
+    }
+    const rename = (0, rename_execution_cache_1.tryReadRenameExecutionStatus)(cwd, executionId);
+    if (rename) {
+        return (0, rename_entities_1.readCachedRenameExecution)(cwd, executionId);
+    }
+    const refactorBatch = (0, refactor_batch_execution_cache_1.tryReadRefactorBatchExecutionStatus)(cwd, executionId);
+    if (refactorBatch) {
+        return (0, refactor_batch_1.readCachedRefactorBatchExecution)(cwd, executionId);
+    }
+    const modulePlan = tryReadModulePlanExecutionStatus(cwd, executionId);
+    if (modulePlan) {
+        return (0, apply_module_plan_1.readCachedModulePlanExecution)(cwd, executionId);
+    }
+    const declaration = (0, declaration_command_1.tryReadDeclarationExecutionStatus)(cwd, executionId);
+    if (declaration) {
+        return (0, declaration_command_1.readCachedDeclarationExecution)(cwd, executionId);
+    }
+    throwExecutionNotFound(executionId);
+}
+function tryReadModulePlanExecutionStatus(cwd, executionId) {
+    try {
+        return (0, module_plan_cache_1.readModulePlanExecutionStatus)(cwd, executionId);
+    }
+    catch {
+        return null;
+    }
+}
+function throwExecutionNotFound(executionId) {
+    throw new errors_1.CliError("EXECUTION_NOT_FOUND", `Execution status not found: ${executionId}`, {
+        executionId
+    });
+}
+function readFlagValue(args, flag) {
+    const index = args.indexOf(flag);
+    if (index < 0) {
+        return null;
+    }
+    const value = args[index + 1];
+    return value && !value.startsWith("--") ? value : null;
+}
+function firstPositional(args) {
+    return args.find((arg) => !arg.startsWith("--")) ?? null;
+}

package/dist/commands/exports-star-collapse-command.js

@@ -0,0 +1,178 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runExportsStarCollapseSegment = runExportsStarCollapseSegment;
+exports.runExportsStarCollapsePreviewBatch = runExportsStarCollapsePreviewBatch;
+exports.formatExportsStarCollapseBatchText = formatExportsStarCollapseBatchText;
+exports.formatExportsStarCollapseWriteText = formatExportsStarCollapseWriteText;
+exports.attachExportsStarCollapseWriteView = attachExportsStarCollapseWriteView;
+const crypto = __importStar(require("node:crypto"));
+const exports_star_collapse_preview_1 = require("../mutation/exports-star-collapse-preview");
+const agent_text_1 = require("../shared/agent-text");
+const session_workspace_1 = require("./session-workspace");
+const exports_star_expand_apply_1 = require("../mutation/exports-star-expand-apply");
+async function runExportsStarCollapseSegment(cwd, segment, action) {
+    if (action === "execute") {
+        const response = (0, exports_star_expand_apply_1.executeCurrentExportsStarCollapseBatch)(cwd, [intentFromSegment(segment)]);
+        const withView = attachExportsStarCollapseWriteView(cwd, response);
+        return (0, agent_text_1.attachAgentText)(withView, formatExportsStarCollapseWriteText("execute", withView));
+    }
+    return (await runExportsStarCollapsePreviewBatch(cwd, [segment]))[0];
+}
+async function runExportsStarCollapsePreviewBatch(cwd, segments, semanticContextPool, persistApplyPlan = false) {
+    const session = new exports_star_collapse_preview_1.ExportsStarCollapsePreviewSession(cwd, semanticContextPool);
+    try {
+        const results = segments.map((segment) => session.plan({
+            sourceFile: readString(segment.sourceFile) ?? "",
+            selectors: readStringArray(segment.selectors)
+        }));
+        const intents = segments.map(intentFromSegment);
+        const previewId = persistApplyPlan ? (0, exports_star_expand_apply_1.persistExportsStarCollapsePreview)(cwd, intents, results) : null;
+        const applyAvailable = Boolean(previewId);
+        const saved = (0, session_workspace_1.saveSessionResultViewJson)(cwd, `res_${crypto.randomBytes(4).toString("hex")}`, {
+            kind: "exportsStarCollapseBatch",
+            operation: "exports.star.collapse.preview",
+            applyAvailable,
+            ...(previewId ? { previewId } : {}),
+            barrelCount: results.length,
+            resources: session.resources,
+            barrels: results
+        });
+        return results.map((result) => {
+            const response = {
+                ...result,
+                applyAvailable,
+                ...(previewId ? { previewId, next: `aib mutate apply ${previewId}` } : {}),
+                ...(saved ? { view: saved.saved } : {})
+            };
+            return (0, agent_text_1.attachAgentText)(response, formatExportsStarCollapseAgentText(result, readString(response.view), previewId ?? undefined));
+        });
+    }
+    finally {
+        session.dispose();
+    }
+}
+function formatExportsStarCollapseBatchText(responses, action = "preview") {
+    const planned = responses.reduce((count, response) => count + (readNumber(response.plannedCount) ?? 0), 0);
+    const retained = responses.flatMap((response) => readObjectArray(response.retained));
+    const files = [...new Set(responses.flatMap((response) => readStringArray(response.filesTouched)))];
+    const view = responses.map((response) => readString(response.view)).find(Boolean);
+    const lines = [
+        `mutate.${action}${planned > 0 && retained.length > 0 ? " partial" : ""}: ${planned} ${noun(planned, "edge")} ${action === "preview" ? "planned" : "collapsed"} in ${files.length} ${noun(files.length, "file")}; ${retained.length} retained`
+    ];
+    if (files.length)
+        lines.push(`files: ${bounded(files, 4)}`);
+    appendRetained(lines, retained);
+    if (view)
+        lines.push(`view: ${view}`);
+    const previewId = responses.map((response) => readString(response.previewId)).find(Boolean);
+    lines.push(action === "preview" && previewId
+        ? `next: aib mutate apply ${previewId}`
+        : retained.length
+            ? "next: Review retained exports.star.collapse evidence and fix remaining edges manually or rerun with adjusted intent."
+            : action === "preview"
+                ? "next: Review retained exports.star.collapse evidence; no safe edits are available to apply."
+                : "next: Continue with the refactor or run focused checks.");
+    return lines.join("\n");
+}
+function formatExportsStarCollapseWriteText(action, response) {
+    if (response.ok === false) {
+        const code = readString(response.code) ?? "EXPORTS_STAR_COLLAPSE_FAILED";
+        const error = readString(response.error) ?? "exports.star.collapse could not be committed.";
+        const view = readString(response.view);
+        return [
+            `mutate.${action} failed`,
+            `${code}: ${error}`,
+            ...(view ? [`view: ${view}`] : []),
+            code.endsWith("ALREADY_APPLIED")
+                ? "next: Continue from the already-applied workspace state or run focused checks."
+                : "next: Rerun exports.star.collapse preview against the current workspace state."
+        ].join("\n");
+    }
+    return formatExportsStarCollapseBatchText([response], action);
+}
+function attachExportsStarCollapseWriteView(cwd, response) {
+    const saved = (0, session_workspace_1.saveSessionResultViewJson)(cwd, `res_${crypto.randomBytes(4).toString("hex")}`, {
+        kind: "exportsStarCollapseWrite",
+        ...response
+    });
+    return saved ? { ...response, view: saved.saved } : response;
+}
+function formatExportsStarCollapseAgentText(result, view, previewId) {
+    const lines = [
+        `exports.star.collapse preview${result.partial ? " partial" : ""}: ${result.plannedCount} ${noun(result.plannedCount, "edge")} planned in ${result.filesTouched.length} ${noun(result.filesTouched.length, "file")}; ${result.retainedCount} retained`
+    ];
+    if (result.filesTouched.length)
+        lines.push(`files: ${bounded(result.filesTouched, 4)}`);
+    appendRetained(lines, result.retained);
+    if (view)
+        lines.push(`view: ${view}`);
+    lines.push(`next: ${previewId ? `aib mutate apply ${previewId}` : result.next}`);
+    return lines.join("\n");
+}
+function intentFromSegment(segment) {
+    return { sourceFile: readString(segment.sourceFile) ?? "", selectors: readStringArray(segment.selectors) };
+}
+function appendRetained(lines, retained) {
+    if (!retained.length)
+        return;
+    lines.push("retained:");
+    for (const item of retained.slice(0, 4)) {
+        const selector = readString(item.selector) ?? "edge";
+        const reason = readString(item.reason) ?? readString(item.code) ?? "retained";
+        const candidates = readStringArray(item.candidates);
+        lines.push(`${selector}: ${reason}${candidates.length ? ` (${candidates.join(", ")})` : ""}`);
+    }
+    if (retained.length > 4)
+        lines.push(`+${retained.length - 4} retained`);
+}
+function readString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function readStringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.length > 0) : [];
+}
+function readObjectArray(value) {
+    return Array.isArray(value) ? value.filter((item) => Boolean(item) && typeof item === "object" && !Array.isArray(item)) : [];
+}
+function readNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function bounded(values, limit) {
+    return values.length <= limit ? values.join(", ") : `${values.slice(0, limit).join(", ")} +${values.length - limit}`;
+}
+function noun(count, word) {
+    return count === 1 ? word : `${word}s`;
+}

package/dist/commands/exports-star-command.js

@@ -0,0 +1,252 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runExportsStarSegment = runExportsStarSegment;
+exports.runExportsStarPreviewBatch = runExportsStarPreviewBatch;
+exports.applyExportsStarPreview = applyExportsStarPreview;
+exports.consolidateExportsStarWriteViews = consolidateExportsStarWriteViews;
+exports.formatExportsStarMutateText = formatExportsStarMutateText;
+exports.formatExportsStarMutateBatchText = formatExportsStarMutateBatchText;
+exports.formatExportsStarResponseForReplay = formatExportsStarResponseForReplay;
+const crypto = __importStar(require("node:crypto"));
+const agent_text_1 = require("../shared/agent-text");
+const exports_star_expand_preview_1 = require("../mutation/exports-star-expand-preview");
+const session_workspace_1 = require("./session-workspace");
+const exports_star_expand_apply_1 = require("../mutation/exports-star-expand-apply");
+const exports_star_collapse_command_1 = require("./exports-star-collapse-command");
+async function runExportsStarSegment(cwd, segment, action) {
+    if (action === "execute") {
+        const response = (0, exports_star_expand_apply_1.executeCurrentExportsStarBatch)(cwd, [intentFromSegment(segment)]);
+        const withView = attachExportsStarWriteView(cwd, response);
+        return (0, agent_text_1.attachAgentText)(withView, formatExportsStarWriteText("execute", withView));
+    }
+    return (await runExportsStarPreviewBatch(cwd, [segment]))[0];
+}
+async function runExportsStarPreviewBatch(cwd, segments, semanticContextPool, persistApplyPlan = false) {
+    const session = new exports_star_expand_preview_1.ExportsStarPreviewSession(cwd, semanticContextPool);
+    try {
+        const intents = segments.map(intentFromSegment);
+        const results = intents.map((intent) => session.plan(intent));
+        const previewId = persistApplyPlan ? (0, exports_star_expand_apply_1.persistExportsStarPreview)(cwd, intents, results) : null;
+        const applyAvailable = Boolean(previewId);
+        const saved = (0, session_workspace_1.saveSessionResultViewJson)(cwd, `res_${crypto.randomBytes(4).toString("hex")}`, {
+            kind: "exportsStarExpandBatch",
+            operation: "exports.star.expand.preview",
+            applyAvailable,
+            ...(previewId ? { previewId } : {}),
+            barrelCount: results.length,
+            resources: session.resources,
+            barrels: results
+        });
+        return results.map((result) => {
+            const response = {
+                ...result,
+                applyAvailable,
+                ...(previewId ? { previewId } : {}),
+                next: previewId ? `aib mutate apply ${previewId}` : result.next,
+                ...(saved ? { view: saved.saved } : {})
+            };
+            return (0, agent_text_1.attachAgentText)(response, formatExportsStarAgentText(result, readString(response.view), previewId ?? undefined));
+        });
+    }
+    finally {
+        session.dispose();
+    }
+}
+function applyExportsStarPreview(cwd, previewId) {
+    const response = (0, exports_star_expand_apply_1.applyPersistedExportsStarPreview)(cwd, previewId);
+    if (isCollapseWriteResponse(response)) {
+        const withView = (0, exports_star_collapse_command_1.attachExportsStarCollapseWriteView)(cwd, response);
+        return (0, agent_text_1.attachAgentText)(withView, (0, exports_star_collapse_command_1.formatExportsStarCollapseWriteText)("apply", withView));
+    }
+    const withView = attachExportsStarWriteView(cwd, response);
+    return (0, agent_text_1.attachAgentText)(withView, formatExportsStarWriteText("apply", withView));
+}
+function consolidateExportsStarWriteViews(cwd, responses) {
+    if (responses.length === 0)
+        return [];
+    const collapse = responses.some(isCollapseWriteResponse);
+    const saved = (0, session_workspace_1.saveSessionResultViewJson)(cwd, `res_${crypto.randomBytes(4).toString("hex")}`, {
+        kind: collapse ? "exportsStarCollapseWriteBatch" : "exportsStarExpandWriteBatch",
+        operation: "mutate.execute",
+        results: responses
+    });
+    return saved ? responses.map((response) => ({ ...response, view: saved.saved })) : [...responses];
+}
+function isCollapseWriteResponse(response) {
+    return response.exportsStarOperation === "collapse" || readObjectArray(response.results).some((result) => readString(result.operation) === "exports.star.collapse.preview");
+}
+function formatExportsStarMutateText(response) {
+    const text = (0, agent_text_1.readAgentText)(response);
+    return text ? replaceFirstLine(text, "mutate.preview") : null;
+}
+function formatExportsStarMutateBatchText(responses, action = "preview") {
+    const planned = responses.reduce((count, response) => count + (readNumber(response.plannedCount) ?? 0), 0);
+    const retained = responses.flatMap((response) => readObjectArray(response.retained));
+    const files = [...new Set(responses.flatMap((response) => readStringArray(response.filesTouched)))];
+    const views = [...new Set(responses.map((response) => readString(response.view)).filter((item) => Boolean(item)))];
+    const lines = [
+        `mutate.${action}${planned > 0 && retained.length > 0 ? " partial" : ""}: ${planned} ${noun(planned, "edge")} ${action === "preview" ? "planned" : "expanded"} in ${files.length} ${noun(files.length, "file")}; ${retained.length} retained`
+    ];
+    if (files.length > 0)
+        lines.push(`files: ${bounded(files, 4)}`);
+    if (retained.length > 0) {
+        lines.push("retained:");
+        for (const item of retained.slice(0, 4)) {
+            const selector = readString(item.selector) ?? "edge";
+            const reason = readString(item.reason) ?? readString(item.code) ?? "retained";
+            const candidates = readStringArray(item.candidates);
+            lines.push(`${selector}: ${reason}${candidates.length ? ` (${candidates.join(", ")})` : ""}`);
+        }
+        if (retained.length > 4)
+            lines.push(`+${retained.length - 4} retained`);
+    }
+    if (views[0])
+        lines.push(`view: ${views[0]}`);
+    const previewId = responses.map((response) => readString(response.previewId)).find(Boolean);
+    lines.push(action === "preview" && previewId
+        ? `next: aib mutate apply ${previewId}`
+        : action === "preview"
+            ? "next: Review retained exports.star.expand evidence; no safe edits are available to apply."
+            : retained.length > 0
+                ? "next: Review retained exports.star.expand evidence and fix remaining edges manually or rerun with adjusted intent."
+                : "next: Continue with the refactor or run focused checks.");
+    return lines.join("\n");
+}
+function formatExportsStarResponseForReplay(response) {
+    const operation = readString(response.operation);
+    if (operation === "mutate.apply") {
+        const results = readObjectArray(response.results);
+        if (results.some((result) => readString(result.operation) === "exports.star.expand.preview")) {
+            return formatExportsStarWriteText("apply", response);
+        }
+    }
+    if (operation !== "mutate.preview" && operation !== "mutate.execute")
+        return null;
+    const aggregate = response.aggregate && typeof response.aggregate === "object" && !Array.isArray(response.aggregate)
+        ? response.aggregate
+        : {};
+    const operations = aggregate.operations && typeof aggregate.operations === "object" && !Array.isArray(aggregate.operations)
+        ? aggregate.operations
+        : {};
+    const expansions = readObjectArray(operations.exportStarExpansions);
+    if (expansions.length === 0)
+        return null;
+    const previewId = readString(response.previewId);
+    const projected = previewId
+        ? expansions.map((item) => ({ ...item, previewId }))
+        : expansions;
+    return formatExportsStarMutateBatchText(projected, operation === "mutate.preview" ? "preview" : "execute");
+}
+function formatExportsStarAgentText(result, view, previewId) {
+    const status = result.partial ? " partial" : "";
+    const lines = [
+        `exports.star.expand preview${status}: ${result.plannedCount} ${noun(result.plannedCount, "edge")} planned in ${result.filesTouched.length} ${noun(result.filesTouched.length, "file")}; ${result.retainedCount} retained`
+    ];
+    if (result.filesTouched.length > 0) {
+        lines.push(`files: ${bounded(result.filesTouched, 4)}`);
+    }
+    if (result.retained.length > 0) {
+        lines.push("retained:");
+        for (const item of result.retained.slice(0, 4)) {
+            const candidates = item.candidates?.length ? ` (${item.candidates.join(", ")})` : "";
+            lines.push(`${item.selector}: ${item.reason}${candidates}`);
+        }
+        if (result.retained.length > 4) {
+            lines.push(`+${result.retained.length - 4} retained`);
+        }
+    }
+    if (view) {
+        lines.push(`view: ${view}`);
+    }
+    lines.push(`next: ${previewId ? `aib mutate apply ${previewId}` : result.next}`);
+    return lines.join("\n");
+}
+function formatExportsStarWriteText(action, response) {
+    const plannedCount = readNumber(response.plannedCount) ?? 0;
+    const retained = readObjectArray(response.retained);
+    const files = readStringArray(response.filesWritten);
+    const lines = [`mutate.${action}${plannedCount > 0 && retained.length > 0 ? " partial" : ""}: ${plannedCount} ${noun(plannedCount, "edge")} expanded in ${files.length} ${noun(files.length, "file")}; ${retained.length} retained`];
+    if (files.length)
+        lines.push(`files: ${bounded(files, 4)}`);
+    if (retained.length) {
+        lines.push("retained:");
+        for (const item of retained.slice(0, 4))
+            lines.push(`${readString(item.selector) ?? "edge"}: ${readString(item.reason) ?? readString(item.code) ?? "retained"}`);
+        if (retained.length > 4)
+            lines.push(`+${retained.length - 4} retained`);
+    }
+    const view = readString(response.view);
+    if (view)
+        lines.push(`view: ${view}`);
+    lines.push(retained.length ? "next: Review retained exports.star.expand evidence and fix remaining edges manually or rerun with adjusted intent." : "next: Continue with the refactor or run focused checks.");
+    return lines.join("\n");
+}
+function attachExportsStarWriteView(cwd, response) {
+    const saved = (0, session_workspace_1.saveSessionResultViewJson)(cwd, `res_${crypto.randomBytes(4).toString("hex")}`, {
+        kind: "exportsStarExpandWrite",
+        ...response
+    });
+    return saved ? { ...response, view: saved.saved } : response;
+}
+function intentFromSegment(segment) {
+    return {
+        sourceFile: readString(segment.sourceFile) ?? "",
+        selectors: readStringArray(segment.selectors),
+        namespaceShape: readString(segment.namespaceShape) === "allow" ? "allow" : "retain"
+    };
+}
+function readString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function readStringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.length > 0) : [];
+}
+function readNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function readObjectArray(value) {
+    return Array.isArray(value) ? value.filter((item) => Boolean(item) && typeof item === "object" && !Array.isArray(item)) : [];
+}
+function bounded(values, limit) {
+    return values.length <= limit ? values.join(", ") : `${values.slice(0, limit).join(", ")} +${values.length - limit}`;
+}
+function noun(count, word) {
+    return count === 1 ? word : `${word}s`;
+}
+function replaceFirstLine(text, firstLine) {
+    const newline = text.indexOf("\n");
+    return newline < 0 ? firstLine : `${firstLine}${text.slice(newline)}`;
+}

package/dist/commands/exports-star-preview-cache.js

@@ -0,0 +1,84 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildExportsStarPreviewId = buildExportsStarPreviewId;
+exports.buildExportsStarPreviewHash = buildExportsStarPreviewHash;
+exports.readExportsStarPreviewRecord = readExportsStarPreviewRecord;
+exports.writeExportsStarPreviewRecord = writeExportsStarPreviewRecord;
+exports.stableExportsStarStringify = stableExportsStarStringify;
+const crypto = __importStar(require("node:crypto"));
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const errors_1 = require("../shared/errors");
+const workspace_cache_1 = require("./workspace-cache");
+function buildExportsStarPreviewId(normalizedIntents, fileHashes, evidenceHashes) {
+    return `exports_star_${sha256(stableStringify({ normalizedIntents, fileHashes, evidenceHashes })).slice(0, 10)}`;
+}
+function buildExportsStarPreviewHash(record) {
+    return `sha256:${sha256(stableStringify(record))}`;
+}
+function readExportsStarPreviewRecord(cwd, previewId) {
+    const filePath = recordPath(cwd, previewId);
+    if (!fs.existsSync(filePath)) {
+        throw new errors_1.CliError("EXPORTS_STAR_PREVIEW_NOT_FOUND", `Exports star preview not found: ${previewId}`, { previewId, expectedPath: filePath });
+    }
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+function writeExportsStarPreviewRecord(cwd, record) {
+    const filePath = recordPath(cwd, record.previewId);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const temporary = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+    fs.writeFileSync(temporary, `${JSON.stringify(record, null, 2)}\n`);
+    fs.renameSync(temporary, filePath);
+}
+function stableExportsStarStringify(value) {
+    return stableStringify(value);
+}
+function recordPath(cwd, previewId) {
+    return (0, workspace_cache_1.workspaceCachePath)(cwd, "exports-star-previews", `${previewId.replace(/[^a-z0-9_-]+/gi, "-")}.json`);
+}
+function sha256(value) {
+    return crypto.createHash("sha256").update(value).digest("hex");
+}
+function stableStringify(value) {
+    if (value === null || typeof value !== "object")
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(",")}]`;
+    return `{${Object.entries(value)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, item]) => `${JSON.stringify(key)}:${stableStringify(item)}`)
+        .join(",")}}`;
+}