@automaton-labs/aib 0.0.6 → 0.0.8

package/dist/commands/mutate-failure-output.js

@@ -0,0 +1,531 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appendNestedMutateManualExtractionRequiredLines = appendNestedMutateManualExtractionRequiredLines;
+exports.hasNestedManualExtraction = hasNestedManualExtraction;
+exports.appendManualExtractionAppliedMoveLines = appendManualExtractionAppliedMoveLines;
+exports.hasNestedHardSemanticFailure = hasNestedHardSemanticFailure;
+exports.readNestedFailedSegments = readNestedFailedSegments;
+exports.appendGroupedRenameLines = appendGroupedRenameLines;
+exports.readCompletedAggregateGroups = readCompletedAggregateGroups;
+exports.formatMutateGroupOperationSummary = formatMutateGroupOperationSummary;
+exports.formatMutateGroupKind = formatMutateGroupKind;
+exports.appendNestedMutateFailureLines = appendNestedMutateFailureLines;
+exports.appendNestedDeclarationMutationFailureLines = appendNestedDeclarationMutationFailureLines;
+exports.appendNestedSemanticMutationFailureLines = appendNestedSemanticMutationFailureLines;
+exports.isAmbiguousTopLevelSymbolError = isAmbiguousTopLevelSymbolError;
+exports.appendAvailableSelectors = appendAvailableSelectors;
+exports.readAvailableTopLevelSelectors = readAvailableTopLevelSelectors;
+exports.scriptKindForMutateFile = scriptKindForMutateFile;
+exports.appendNestedFileMutationFailureLines = appendNestedFileMutationFailureLines;
+exports.formatPathForMutateOutput = formatPathForMutateOutput;
+exports.formatObjectPackFailureAsMutatePreviewText = formatObjectPackFailureAsMutatePreviewText;
+exports.readObjectOperationFromPacks = readObjectOperationFromPacks;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const typescript_1 = __importDefault(require("typescript"));
+const agent_text_1 = require("../shared/agent-text");
+const mutate_declaration_output_1 = require("./mutate-declaration-output");
+const mutate_object_output_1 = require("./mutate-object-output");
+const mutate_output_values_1 = require("./mutate-output-values");
+function appendNestedMutateManualExtractionRequiredLines(cwd, lines, response) {
+    const failedSegments = readNestedFailedSegments(response);
+    const modulePlanSegments = failedSegments.filter((segment) => {
+        const details = (0, mutate_output_values_1.isObject)(segment.details) ? segment.details : {};
+        return details.kind === "modulePlan";
+    });
+    if (modulePlanSegments.length > 0) {
+        const grouped = new Map();
+        for (const segment of modulePlanSegments) {
+            const details = (0, mutate_output_values_1.isObject)(segment.details) ? segment.details : {};
+            for (const row of (0, mutate_output_values_1.readObjectArray)(details.rows).filter((item) => (0, mutate_output_values_1.readNestedManualExtractionEntities)(item).length > 0)) {
+                const target = (0, mutate_output_values_1.readString)(row.target) ?? "?";
+                grouped.set(target, [...(grouped.get(target) ?? []), ...(0, mutate_output_values_1.readNestedManualExtractionEntities)(row)]);
+            }
+        }
+        if (grouped.size === 0) {
+            return false;
+        }
+        lines.push("manualExtractionRequired:");
+        for (const [target, entities] of grouped) {
+            lines.push(`${formatPathForMutateOutput(cwd, target)}: ${(0, mutate_output_values_1.formatCompactList)(Array.from(new Set(entities)), 15)}`);
+        }
+        lines.push("reason: TypeScript move-to-file provider cannot produce edits for these symbols.");
+        lines.push("next: use manual extraction for listed symbols");
+        return true;
+    }
+    const semanticSegments = failedSegments.filter((segment) => {
+        const details = (0, mutate_output_values_1.isObject)(segment.details) ? segment.details : {};
+        return details.kind === "semantic";
+    });
+    if (semanticSegments.length === 0) {
+        return false;
+    }
+    const rowsByTarget = new Map();
+    for (const segment of semanticSegments) {
+        const details = (0, mutate_output_values_1.isObject)(segment.details) ? segment.details : {};
+        const operations = (0, mutate_output_values_1.readObjectArray)(details.operations);
+        for (const row of (0, mutate_output_values_1.readObjectArray)(details.rows).filter(mutate_output_values_1.isSemanticManualExtractionRow)) {
+            const rowId = (0, mutate_output_values_1.readString)(row.id);
+            const entity = (0, mutate_output_values_1.readString)(row.entity) ?? (0, mutate_output_values_1.readEntityFromRowId)(rowId) ?? "symbol";
+            const operation = operations.find((item) => (0, mutate_output_values_1.readObjectArray)(item.rows).some((operationRow) => (0, mutate_output_values_1.readString)(operationRow.id) === rowId));
+            const targetFile = (0, mutate_output_values_1.readString)(row.targetFile) ?? (0, mutate_output_values_1.readString)(operation?.targetFile) ?? "?";
+            const formattedTarget = targetFile === "?" ? targetFile : formatPathForMutateOutput(cwd, targetFile);
+            rowsByTarget.set(formattedTarget, [...(rowsByTarget.get(formattedTarget) ?? []), entity]);
+        }
+    }
+    if (rowsByTarget.size === 0) {
+        return false;
+    }
+    lines.push("manualExtractionRequired:");
+    for (const [targetFile, entities] of rowsByTarget) {
+        lines.push(`${targetFile}: ${(0, mutate_output_values_1.formatCompactList)(entities, 15)}`);
+    }
+    lines.push("reason: TypeScript move-to-file provider cannot produce edits for these symbols.");
+    lines.push("next: use manual extraction for listed symbols");
+    return true;
+}
+function hasNestedManualExtraction(response) {
+    return readNestedFailedSegments(response).some((segment) => {
+        const details = (0, mutate_output_values_1.isObject)(segment.details) ? segment.details : {};
+        if (details.kind === "semantic") {
+            return (0, mutate_output_values_1.readObjectArray)(details.rows).some(mutate_output_values_1.isSemanticManualExtractionRow);
+        }
+        if (details.kind === "modulePlan") {
+            return (0, mutate_output_values_1.readObjectArray)(details.rows).some((row) => (0, mutate_output_values_1.readNestedManualExtractionEntities)(row).length > 0);
+        }
+        return false;
+    });
+}
+function appendManualExtractionAppliedMoveLines(cwd, lines, response, operation) {
+    if (operation === "mutate.preview" || !hasNestedManualExtraction(response) || hasNestedHardSemanticFailure(response)) {
+        return;
+    }
+    const moves = new Map();
+    for (const segment of (0, mutate_output_values_1.readObjectArray)(response.segments).filter((item) => item.status !== "notRun")) {
+        const details = (0, mutate_output_values_1.isObject)(segment.details) ? segment.details : {};
+        if (details.kind === "modulePlan") {
+            for (const row of (0, mutate_output_values_1.readObjectArray)(details.rows)) {
+                const target = (0, mutate_output_values_1.readString)(row.target);
+                const entities = row.ok === false
+                    ? (0, mutate_output_values_1.readStringArray)(row.appliedEntities)
+                    : (0, mutate_output_values_1.readStringArray)(row.entities);
+                if (target && entities.length > 0) {
+                    moves.set(target, [...(moves.get(target) ?? []), ...entities]);
+                }
+            }
+        }
+        if (details.kind === "semantic") {
+            for (const operation of (0, mutate_output_values_1.readObjectArray)(details.operations).filter((item) => item.op === "move")) {
+                const target = (0, mutate_output_values_1.readString)(operation.targetFile);
+                const entities = (0, mutate_output_values_1.readObjectArray)(operation.rows)
+                    .filter((row) => row.ok === true || row.applied === true)
+                    .map((row) => (0, mutate_output_values_1.readString)(row.entity))
+                    .filter((entity) => Boolean(entity));
+                if (target && entities.length > 0) {
+                    moves.set(target, [...(moves.get(target) ?? []), ...entities]);
+                }
+            }
+        }
+    }
+    if (moves.size === 0) {
+        return;
+    }
+    lines.push("moves:");
+    for (const [target, entities] of moves) {
+        lines.push(`${formatPathForMutateOutput(cwd, target)}: ${(0, mutate_output_values_1.formatCompactList)(Array.from(new Set(entities)), 5)}`);
+    }
+}
+function hasNestedHardSemanticFailure(response) {
+    const failedSegments = readNestedFailedSegments(response);
+    if (failedSegments.length === 0) {
+        return true;
+    }
+    return failedSegments.some((segment) => {
+        const details = (0, mutate_output_values_1.isObject)(segment.details) ? segment.details : {};
+        if (details.kind === "modulePlan") {
+            const failedRows = (0, mutate_output_values_1.readObjectArray)(details.rows).filter((row) => row.ok === false);
+            if (failedRows.length === 0) {
+                return true;
+            }
+            return failedRows.some((row) => (0, mutate_output_values_1.readNestedManualExtractionEntities)(row).length === 0);
+        }
+        if (details.kind !== "semantic") {
+            return true;
+        }
+        const failedRows = (0, mutate_output_values_1.readObjectArray)(details.rows).filter((row) => row.ok === false);
+        return failedRows.length === 0 || failedRows.some((row) => !(0, mutate_output_values_1.isSemanticManualExtractionRow)(row));
+    });
+}
+function readNestedFailedSegments(response) {
+    const failedSegmentIndex = (0, mutate_output_values_1.readNumber)(response.failedSegment);
+    const segments = (0, mutate_output_values_1.readObjectArray)(response.segments);
+    const failed = segments.filter((segment) => segment.status === "failed");
+    if (failed.length > 0) {
+        return failed;
+    }
+    return segments.filter((segment) => (0, mutate_output_values_1.readNumber)(segment.index) === failedSegmentIndex);
+}
+function appendGroupedRenameLines(cwd, lines, renames) {
+    const bySourceFile = new Map();
+    const withoutSource = [];
+    for (const rename of renames) {
+        const sourceFile = (0, mutate_output_values_1.readString)(rename.sourceFile);
+        const entity = (0, mutate_output_values_1.readString)(rename.entity) ?? "?";
+        const newName = (0, mutate_output_values_1.readString)(rename.newName) ?? "?";
+        const pair = `${entity} -> ${newName}`;
+        if (sourceFile) {
+            const formattedSource = formatPathForMutateOutput(cwd, sourceFile);
+            bySourceFile.set(formattedSource, [...(bySourceFile.get(formattedSource) ?? []), pair]);
+        }
+        else {
+            withoutSource.push(pair);
+        }
+    }
+    for (const [sourceFile, pairs] of bySourceFile) {
+        lines.push(`${sourceFile}: ${(0, mutate_output_values_1.formatCompactList)(pairs, 5)}`);
+    }
+    for (const pair of withoutSource) {
+        lines.push(pair);
+    }
+}
+function readCompletedAggregateGroups(response) {
+    return (0, mutate_output_values_1.readObjectArray)(response.segments).filter((segment) => segment.status === "completed");
+}
+function formatMutateGroupOperationSummary(group) {
+    const details = (0, mutate_output_values_1.isObject)(group.details) ? group.details : {};
+    if (details.kind === "semantic") {
+        const operations = (0, mutate_output_values_1.readObjectArray)(details.operations);
+        const renameCount = operations
+            .filter((operation) => operation.op === "rename")
+            .reduce((count, operation) => count + (0, mutate_output_values_1.readObjectArray)(operation.renames).length, 0);
+        const moveSymbols = operations
+            .filter((operation) => operation.op === "move")
+            .reduce((count, operation) => count + (0, mutate_output_values_1.readStringArray)(operation.entities).length, 0);
+        const parts = [];
+        if (renameCount > 0) {
+            parts.push(`${renameCount} ${renameCount === 1 ? "rename" : "renames"}`);
+        }
+        if (moveSymbols > 0) {
+            parts.push(`${moveSymbols} ${moveSymbols === 1 ? "move" : "moves"}`);
+        }
+        return parts.length > 0 ? parts.join(", ") : (0, mutate_output_values_1.readString)(group.summary) ?? "planned";
+    }
+    if (details.kind === "file") {
+        const moveCount = (0, mutate_output_values_1.readObjectArray)(details.moves).reduce((count, move) => count + (0, mutate_output_values_1.readStringArray)(move.files).length, 0);
+        const renameCount = (0, mutate_output_values_1.readObjectArray)(details.renames).length;
+        const changeCount = (0, mutate_output_values_1.readObjectArray)(details.changes).length;
+        const parts = [];
+        if (moveCount > 0) {
+            parts.push(`${moveCount} ${moveCount === 1 ? "move" : "moves"}`);
+        }
+        if (renameCount > 0) {
+            parts.push(`${renameCount} ${renameCount === 1 ? "rename" : "renames"}`);
+        }
+        if (changeCount > 0) {
+            parts.push(`${changeCount} ${changeCount === 1 ? "change" : "changes"}`);
+        }
+        return parts.length > 0 ? parts.join(", ") : (0, mutate_output_values_1.readString)(group.summary) ?? "planned";
+    }
+    if (details.kind === "declaration") {
+        const op = (0, mutate_declaration_output_1.formatDeclarationCleanupOperationLabel)((0, mutate_output_values_1.readString)(details.operation));
+        const removed = (0, mutate_output_values_1.readNumber)(details.declarationsRemoved) ?? 0;
+        const added = (0, mutate_output_values_1.readNumber)(details.importsAdded) ?? 0;
+        const notFound = (0, mutate_output_values_1.readNumber)(details.notFoundCount) ?? 0;
+        const sourceIssues = (0, mutate_output_values_1.readNumber)(details.sourceFailureCount) ?? 0;
+        const skipped = (0, mutate_output_values_1.readNumber)(details.skippedCount) ?? 0;
+        const parts = [
+            removed > 0 ? `${removed} removed` : null,
+            added > 0 ? `${added} imports added` : null,
+            notFound > 0 ? `${notFound} not found` : null,
+            sourceIssues > 0 ? `${sourceIssues} source ${sourceIssues === 1 ? "issue" : "issues"}` : null,
+            skipped > 0 ? `${skipped} skipped` : null
+        ].filter((value) => Boolean(value));
+        return `${op}${parts.length > 0 ? `: ${parts.join(", ")}` : ""}`;
+    }
+    return (0, mutate_output_values_1.readString)(group.summary) ?? "planned";
+}
+function formatMutateGroupKind(kind) {
+    if (kind === "file") {
+        return "file mutation";
+    }
+    if (kind === "semantic") {
+        return "semantic mutation";
+    }
+    return kind;
+}
+function appendNestedMutateFailureLines(cwd, lines, response) {
+    if (!(0, mutate_output_values_1.isObject)(response.response)) {
+        return;
+    }
+    if (appendNestedSemanticMutationFailureLines(cwd, lines, response)) {
+        return;
+    }
+    if (appendNestedFileMutationFailureLines(cwd, lines, response.response)) {
+        return;
+    }
+    if (appendNestedDeclarationMutationFailureLines(lines, response.response)) {
+        return;
+    }
+    const nestedText = (0, agent_text_1.readAgentText)(response.response);
+    if (nestedText) {
+        const nestedLines = nestedText.split("\n");
+        let skipFailureHeading = false;
+        for (const line of nestedLines) {
+            if (/^[A-Za-z.]+\.preview failed$/.test(line)) {
+                continue;
+            }
+            if (line === "failed:") {
+                skipFailureHeading = true;
+                continue;
+            }
+            if (skipFailureHeading && line.trim().length === 0) {
+                continue;
+            }
+            lines.push(line);
+        }
+        return;
+    }
+    const code = (0, mutate_output_values_1.readString)(response.response.code);
+    const error = (0, mutate_output_values_1.readString)(response.response.error);
+    if (error) {
+        lines.push(error);
+    }
+    else if (code) {
+        lines.push(code);
+    }
+}
+function appendNestedDeclarationMutationFailureLines(lines, response) {
+    const operation = (0, mutate_output_values_1.readString)(response.operation);
+    if (!operation?.startsWith("declaration.")) {
+        return false;
+    }
+    if ((0, mutate_output_values_1.readString)(response.code) === "DECLARATION_REMOVE_NOT_FOUND") {
+        lines.push("No requested declarations were found.");
+        (0, mutate_declaration_output_1.appendDeclarationNotFoundAggregateLines)(lines, [response]);
+        return true;
+    }
+    const failed = (0, mutate_output_values_1.isObject)(response.failed) ? response.failed : null;
+    const error = (0, mutate_output_values_1.readString)(failed?.error);
+    if (error) {
+        lines.push(error);
+        return true;
+    }
+    return false;
+}
+function appendNestedSemanticMutationFailureLines(cwd, lines, response) {
+    const failedSegmentIndex = (0, mutate_output_values_1.readNumber)(response.failedSegment);
+    const failedSegment = (0, mutate_output_values_1.readObjectArray)(response.segments)
+        .find((segment) => (0, mutate_output_values_1.readNumber)(segment.index) === failedSegmentIndex);
+    const details = (0, mutate_output_values_1.isObject)(failedSegment?.details) ? failedSegment.details : {};
+    if (details.kind !== "semantic") {
+        return false;
+    }
+    const failedRow = (0, mutate_output_values_1.readObjectArray)(details.rows).find((row) => row.ok === false);
+    if (!failedRow) {
+        return false;
+    }
+    const operations = (0, mutate_output_values_1.readObjectArray)(details.operations);
+    const kind = (0, mutate_output_values_1.readString)(failedRow.kind);
+    const entity = (0, mutate_output_values_1.readString)(failedRow.entity) ?? (0, mutate_output_values_1.readEntityFromRowId)((0, mutate_output_values_1.readString)(failedRow.id)) ?? "symbol";
+    const error = (0, mutate_output_values_1.readString)(failedRow.error);
+    const failedRowId = (0, mutate_output_values_1.readString)(failedRow.id);
+    const failedOperation = operations.find((item) => (0, mutate_output_values_1.readObjectArray)(item.rows).some((row) => (0, mutate_output_values_1.readString)(row.id) === failedRowId));
+    let failedSourceFile = null;
+    if (kind === "renameSymbol") {
+        const operation = failedOperation?.op === "rename" ? failedOperation :
+            operations.find((item) => item.op === "rename");
+        const sourceFile = (0, mutate_output_values_1.readString)(failedRow.sourceFile) ?? (0, mutate_output_values_1.readString)(operation?.sourceFile);
+        failedSourceFile = sourceFile;
+        const rename = (0, mutate_output_values_1.readObjectArray)(operation?.renames).find((item) => (0, mutate_output_values_1.readString)(item.entity) === entity);
+        const newName = (0, mutate_output_values_1.readString)(failedRow.newName) ?? (0, mutate_output_values_1.readString)(rename?.newName) ?? "?";
+        lines.push("rename failed");
+        lines.push(sourceFile ? `${formatPathForMutateOutput(cwd, sourceFile)}: ${entity} -> ${newName}` : `${entity} -> ${newName}`);
+    }
+    else if (kind === "moveRefactor") {
+        const operation = failedOperation?.op === "move" ? failedOperation :
+            operations.find((item) => item.op === "move");
+        const sourceFile = (0, mutate_output_values_1.readString)(operation?.sourceFile);
+        failedSourceFile = sourceFile;
+        const targetFile = (0, mutate_output_values_1.readString)(failedRow.targetFile) ?? (0, mutate_output_values_1.readString)(operation?.targetFile);
+        lines.push("move failed");
+        if (sourceFile && targetFile) {
+            lines.push(`${formatPathForMutateOutput(cwd, sourceFile)} -> ${formatPathForMutateOutput(cwd, targetFile)}: ${entity}`);
+        }
+        else if (targetFile) {
+            lines.push(`${formatPathForMutateOutput(cwd, targetFile)}: ${entity}`);
+        }
+        else {
+            lines.push(entity);
+        }
+    }
+    else {
+        lines.push(`${kind ?? "semantic"} failed`);
+        lines.push(entity);
+    }
+    if (error) {
+        if (isAmbiguousTopLevelSymbolError(error)) {
+            lines.push(`\`${entity}\` is ambiguous.`);
+            const available = failedSourceFile ? readAvailableTopLevelSelectors(cwd, failedSourceFile, entity) : [];
+            appendAvailableSelectors(lines, available);
+        }
+        else {
+            lines.push(error);
+        }
+    }
+    return true;
+}
+function isAmbiguousTopLevelSymbolError(error) {
+    return error.startsWith("Ambiguous top-level symbol:");
+}
+function appendAvailableSelectors(lines, selectors) {
+    if (selectors.length === 0) {
+        return;
+    }
+    lines.push("Available selectors:");
+    for (const selector of selectors) {
+        lines.push(selector);
+    }
+}
+function readAvailableTopLevelSelectors(cwd, sourceFile, entity) {
+    const filePath = path.isAbsolute(sourceFile) ? sourceFile : path.resolve(cwd, sourceFile);
+    if (!fs.existsSync(filePath)) {
+        return [];
+    }
+    const text = fs.readFileSync(filePath, "utf8");
+    const parsed = typescript_1.default.createSourceFile(filePath, text, typescript_1.default.ScriptTarget.Latest, true, scriptKindForMutateFile(filePath));
+    const selectors = [];
+    for (const statement of parsed.statements) {
+        if (typescript_1.default.isFunctionDeclaration(statement) && statement.name?.text === entity) {
+            selectors.push(`f-${entity}`);
+        }
+        else if (typescript_1.default.isClassDeclaration(statement) && statement.name?.text === entity) {
+            selectors.push(`c-${entity}`);
+        }
+        else if (typescript_1.default.isInterfaceDeclaration(statement) && statement.name?.text === entity) {
+            selectors.push(`i-${entity}`);
+        }
+        else if (typescript_1.default.isTypeAliasDeclaration(statement) && statement.name.text === entity) {
+            selectors.push(`t-${entity}`);
+        }
+        else if (typescript_1.default.isEnumDeclaration(statement) && statement.name.text === entity) {
+            selectors.push(`e-${entity}`);
+        }
+        else if (typescript_1.default.isVariableStatement(statement)) {
+            for (const declaration of statement.declarationList.declarations) {
+                if (typescript_1.default.isIdentifier(declaration.name) && declaration.name.text === entity) {
+                    selectors.push(`v-${entity}`);
+                }
+            }
+        }
+    }
+    return Array.from(new Set(selectors));
+}
+function scriptKindForMutateFile(file) {
+    if (file.endsWith(".tsx"))
+        return typescript_1.default.ScriptKind.TSX;
+    if (file.endsWith(".jsx"))
+        return typescript_1.default.ScriptKind.JSX;
+    if (file.endsWith(".js") || file.endsWith(".mjs") || file.endsWith(".cjs"))
+        return typescript_1.default.ScriptKind.JS;
+    return typescript_1.default.ScriptKind.TS;
+}
+function appendNestedFileMutationFailureLines(cwd, lines, response) {
+    const operation = (0, mutate_output_values_1.readString)(response.operation);
+    if (!operation || (!operation.startsWith("move.toDir.") && !operation.startsWith("file.rename.") && !operation.startsWith("file.refactor.batch."))) {
+        return false;
+    }
+    const rows = (0, mutate_output_values_1.readObjectArray)(response.rows);
+    const failed = rows.find((row) => row.ok === false);
+    if (!failed) {
+        return false;
+    }
+    const summary = (0, mutate_output_values_1.readString)(response.summary);
+    const validation = summary?.match(/(?:^|,\s)(validation blocked at row \d+)/)?.[1];
+    if (validation) {
+        lines.push("validation blocked");
+    }
+    const source = (0, mutate_output_values_1.readString)(failed.source);
+    const target = (0, mutate_output_values_1.readString)(failed.target);
+    const code = (0, mutate_output_values_1.readString)(failed.code);
+    const error = (0, mutate_output_values_1.readString)(failed.error);
+    if ((code === "FILE_MOVE_SOURCE_NOT_FOUND" || code === "FILE_RENAME_SOURCE_NOT_FOUND" || code === "FILE_REFACTOR_BATCH_SOURCE_NOT_FOUND") && source) {
+        lines.push(`${formatPathForMutateOutput(cwd, source)} file does not exist.`);
+        return true;
+    }
+    if (source && target) {
+        lines.push(`${formatPathForMutateOutput(cwd, source)} -> ${formatPathForMutateOutput(cwd, target)}`);
+    }
+    else if (source) {
+        lines.push(formatPathForMutateOutput(cwd, source));
+    }
+    if (code) {
+        lines.push(`code: ${code}`);
+    }
+    if (error) {
+        lines.push(error);
+    }
+    return true;
+}
+function formatPathForMutateOutput(cwd, value) {
+    const normalized = value.replace(/\\/g, "/");
+    if (!path.isAbsolute(value)) {
+        return normalized;
+    }
+    const relative = path.relative(cwd, value).replace(/\\/g, "/");
+    if (relative && relative !== ".." && !relative.startsWith("../") && !path.isAbsolute(relative)) {
+        return relative;
+    }
+    return normalized;
+}
+function formatObjectPackFailureAsMutatePreviewText(response) {
+    const nestedText = (0, agent_text_1.readAgentText)(response);
+    const label = (0, mutate_object_output_1.objectOperationFromString)((0, mutate_output_values_1.readString)(response.operation)) === "unpack" ? "object.unpack" : "object.pack";
+    if (!nestedText) {
+        return `mutate.preview failed\nnext: Fix unsupported ${label} selectors/usages and rerun mutate preview.`;
+    }
+    const lines = nestedText.split(/\r?\n/);
+    lines[0] = "mutate.preview failed";
+    const withoutChildNext = lines.filter((line) => !line.startsWith("next: Fix unsupported object."));
+    withoutChildNext.push(`next: Fix unsupported ${label} selectors/usages and rerun mutate preview.`);
+    return withoutChildNext.join("\n");
+}
+function readObjectOperationFromPacks(packs) {
+    const operation = (0, mutate_output_values_1.readString)(packs[0]?.operation);
+    return operation === "unpack" ? "unpack" : "pack";
+}

package/dist/commands/mutate-file-view.js

@@ -0,0 +1,151 @@
+"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.MUTATE_VISIBLE_FILE_LIMIT = void 0;
+exports.attachMutateAggregateFilesView = attachMutateAggregateFilesView;
+exports.selectVisibleMutateAggregateFiles = selectVisibleMutateAggregateFiles;
+const crypto = __importStar(require("node:crypto"));
+const session_workspace_1 = require("./session-workspace");
+const mutate_result_projection_1 = require("./mutate-result-projection");
+const mutate_output_values_1 = require("./mutate-output-values");
+exports.MUTATE_VISIBLE_FILE_LIMIT = 12;
+function attachMutateAggregateFilesView(cwd, response) {
+    const operation = (0, mutate_output_values_1.readString)(response.operation);
+    if (operation !== "mutate.preview" && operation !== "mutate.execute" && operation !== "mutate.apply") {
+        return response;
+    }
+    const aggregate = (0, mutate_output_values_1.isObject)(response.aggregate)
+        ? response.aggregate
+        : (0, mutate_result_projection_1.buildMutateAggregateModel)((0, mutate_output_values_1.readObjectArray)(response.segments));
+    const operations = (0, mutate_output_values_1.isObject)(aggregate.operations) ? aggregate.operations : {};
+    if ((0, mutate_output_values_1.readObjectArray)(operations.importNormalizations).some((item) => (0, mutate_output_values_1.readString)(item.view))) {
+        return response;
+    }
+    const files = operation === "mutate.preview"
+        ? (0, mutate_output_values_1.readStringArray)(aggregate.filesTouched)
+        : (0, mutate_output_values_1.readStringArray)(response.filesWritten).length > 0
+            ? (0, mutate_output_values_1.readStringArray)(response.filesWritten)
+            : (0, mutate_output_values_1.readStringArray)(aggregate.filesWritten);
+    if (files.length <= exports.MUTATE_VISIBLE_FILE_LIMIT) {
+        return response;
+    }
+    const visibleFiles = selectDiverseMutatePaths(files, exports.MUTATE_VISIBLE_FILE_LIMIT);
+    const visible = new Set(visibleFiles);
+    const hiddenFiles = files.filter((file) => !visible.has(file));
+    const saved = (0, session_workspace_1.saveSessionResultViewJson)(cwd, `res_${crypto.randomBytes(4).toString("hex")}`, (0, mutate_output_values_1.compactObject)({
+        kind: "mutationFiles",
+        operation,
+        label: operation === "mutate.preview" ? "files" : "filesWritten",
+        files: hiddenFiles,
+        fileCount: hiddenFiles.length,
+        hiddenFileCount: hiddenFiles.length,
+        visibleFileCount: visibleFiles.length,
+        totalFileCount: files.length,
+        previewId: (0, mutate_output_values_1.readString)(response.previewId)
+    }));
+    if (!saved) {
+        return response;
+    }
+    const nextAggregate = (0, mutate_output_values_1.compactObject)({
+        ...aggregate,
+        views: (0, mutate_output_values_1.uniqueStrings)([
+            ...(0, mutate_output_values_1.readStringArray)(aggregate.views),
+            saved.saved
+        ])
+    });
+    return (0, mutate_output_values_1.compactObject)({
+        ...response,
+        aggregate: nextAggregate,
+        view: (0, mutate_output_values_1.readString)(response.view) ?? saved.saved
+    });
+}
+function selectVisibleMutateAggregateFiles(aggregate, files) {
+    const operations = (0, mutate_output_values_1.isObject)(aggregate.operations) ? aggregate.operations : {};
+    const importNormalizations = (0, mutate_output_values_1.readObjectArray)(operations.importNormalizations);
+    if (importNormalizations.length === 1) {
+        const visibleFiles = (0, mutate_output_values_1.readStringArray)(importNormalizations[0]?.visibleFiles);
+        if (visibleFiles.length > 0) {
+            return visibleFiles.slice(0, exports.MUTATE_VISIBLE_FILE_LIMIT);
+        }
+    }
+    return selectDiverseMutatePaths(files, exports.MUTATE_VISIBLE_FILE_LIMIT);
+}
+function selectDiverseMutatePaths(files, limit) {
+    const selected = [];
+    const seenBuckets = new Set();
+    const sorted = [...files].sort(compareMutatePathsForDiversity);
+    for (const file of sorted) {
+        if (selected.length >= limit) {
+            break;
+        }
+        const bucket = mutatePathBucket(file);
+        if (seenBuckets.has(bucket)) {
+            continue;
+        }
+        selected.push(file);
+        seenBuckets.add(bucket);
+    }
+    for (const file of sorted) {
+        if (selected.length >= limit) {
+            break;
+        }
+        if (!selected.includes(file)) {
+            selected.push(file);
+        }
+    }
+    return selected;
+}
+function compareMutatePathsForDiversity(left, right) {
+    return mutatePathNoise(left) - mutatePathNoise(right)
+        || mutatePathBucket(left).localeCompare(mutatePathBucket(right))
+        || left.localeCompare(right);
+}
+function mutatePathNoise(file) {
+    const parts = file.replace(/\\/g, "/").split("/").filter(Boolean);
+    return Math.min(parts.length, 12) + Math.min(file.length, 160);
+}
+function mutatePathBucket(file) {
+    const parts = file.replace(/\\/g, "/").split("/").filter(Boolean);
+    if (parts.length <= 2) {
+        return parts.join("/");
+    }
+    if (parts[0] === "packages" && parts.length >= 3) {
+        return parts.slice(0, 3).join("/");
+    }
+    if (parts[0] === "src" && parts.length >= 3) {
+        return parts.slice(0, 3).join("/");
+    }
+    return parts.slice(0, 2).join("/");
+}