@automaton-labs/aib 0.0.6 → 0.0.8

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

@@ -0,0 +1,996 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatMutateFileLayoutValidationText = formatMutateFileLayoutValidationText;
+exports.formatMutateAggregateText = formatMutateAggregateText;
+exports.defaultDeclarationCleanupPartialNext = defaultDeclarationCleanupPartialNext;
+exports.formatMutateAggregateSummary = formatMutateAggregateSummary;
+exports.formatDeclarationCleanupAggregateSummary = formatDeclarationCleanupAggregateSummary;
+exports.formatMutateCompletedGroupsSummary = formatMutateCompletedGroupsSummary;
+exports.formatMutateManualExtractionOnlySummary = formatMutateManualExtractionOnlySummary;
+exports.mutateCompletedGroupVerb = mutateCompletedGroupVerb;
+exports.appendMutateAggregateOperationSections = appendMutateAggregateOperationSections;
+exports.appendImportNormalizeSampleLines = appendImportNormalizeSampleLines;
+exports.appendImportNormalizePolicyLines = appendImportNormalizePolicyLines;
+exports.groupImportNormalizePolicies = groupImportNormalizePolicies;
+exports.compareImportNormalizePolicyGroups = compareImportNormalizePolicyGroups;
+exports.importNormalizePolicySectionRank = importNormalizePolicySectionRank;
+exports.importNormalizeRelationRank = importNormalizeRelationRank;
+exports.formatImportNormalizePolicyGroupLine = formatImportNormalizePolicyGroupLine;
+exports.groupJsonObjectsBy = groupJsonObjectsBy;
+exports.appendImportRebaseSkippedAggregateLines = appendImportRebaseSkippedAggregateLines;
+exports.formatCommonPathGlobForMutateOutput = formatCommonPathGlobForMutateOutput;
+exports.appendMutateAggregateGroupLines = appendMutateAggregateGroupLines;
+exports.appendMutateFailureSections = appendMutateFailureSections;
+exports.appendMutateCompletedOperationSections = appendMutateCompletedOperationSections;
+const mutate_result_projection_1 = require("./mutate-result-projection");
+const mutate_file_view_1 = require("./mutate-file-view");
+const mutate_declaration_output_1 = require("./mutate-declaration-output");
+const mutate_failure_output_1 = require("./mutate-failure-output");
+const mutate_execution_status_1 = require("./mutate-execution-status");
+const mutate_object_output_1 = require("./mutate-object-output");
+const mutate_output_values_1 = require("./mutate-output-values");
+const MUTATE_OBJECT_OUTPUT_HELPERS = {
+    collectFilesTouched: mutate_execution_status_1.collectFilesTouched,
+    collectFilesWritten: mutate_execution_status_1.collectFilesWritten,
+    compactObject: mutate_output_values_1.compactObject,
+    formatPathForMutateOutput: mutate_failure_output_1.formatPathForMutateOutput,
+    isObject: mutate_output_values_1.isObject,
+    readNumber: mutate_output_values_1.readNumber,
+    readObjectArray: mutate_output_values_1.readObjectArray,
+    readString: mutate_output_values_1.readString,
+    readStringArray: mutate_output_values_1.readStringArray
+};
+function hasDeclarationCleanupIssues(aggregate) {
+    const operations = (0, mutate_output_values_1.isObject)(aggregate.operations) ? aggregate.operations : {};
+    const declarationCleanups = (0, mutate_output_values_1.readObjectArray)(operations.declarationCleanups);
+    return declarationCleanups.some((item) => ((0, mutate_output_values_1.readNumber)(item.notFoundCount) ?? 0) > 0 ||
+        ((0, mutate_output_values_1.readNumber)(item.failedCount) ?? 0) > 0 ||
+        ((0, mutate_output_values_1.readNumber)(item.sourceFailureCount) ?? 0) > 0 ||
+        ((0, mutate_output_values_1.readNumber)(item.skippedCount) ?? 0) > 0);
+}
+function formatMutateFileLayoutValidationText(cwd, response) {
+    const operation = (0, mutate_output_values_1.readString)(response.operation) ?? "mutate";
+    const validation = (0, mutate_output_values_1.isObject)(response.validation) ? response.validation : {};
+    const family = (0, mutate_output_values_1.readString)(validation.family) ?? "file move";
+    const lines = [
+        `${operation} failed`,
+        `${family} validation failed${operation === "mutate.preview" ? "" : " before execution"}`
+    ];
+    const missingSources = (0, mutate_output_values_1.readStringArray)(validation.missingSources);
+    if (missingSources.length > 0) {
+        lines.push("missing sources:");
+        lines.push(...missingSources.map((source) => (0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, source)));
+    }
+    const duplicateTargets = (0, mutate_output_values_1.readStringArray)(validation.duplicateTargets);
+    if (duplicateTargets.length > 0) {
+        lines.push("duplicate targets:");
+        lines.push(...duplicateTargets.map((target) => (0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, target)));
+    }
+    const unsupportedSources = (0, mutate_output_values_1.readStringArray)(validation.unsupportedSources);
+    if (unsupportedSources.length > 0) {
+        lines.push("unsupported sources:");
+        lines.push(...unsupportedSources.map((source) => (0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, source)));
+    }
+    if (operation !== "mutate.preview") {
+        lines.push("filesWritten:");
+        lines.push("none");
+    }
+    const action = operation.replace("mutate.", "");
+    lines.push(`next: fix the mutate request and rerun ${action}`);
+    return lines.join("\n");
+}
+function formatMutateAggregateText(cwd, response) {
+    const operation = (0, mutate_output_values_1.readString)(response.operation);
+    if (operation !== "mutate.preview" && operation !== "mutate.apply" && operation !== "mutate.execute") {
+        return null;
+    }
+    if (response.ok === false && (0, mutate_output_values_1.isObject)(response.validation)) {
+        return formatMutateFileLayoutValidationText(cwd, 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 semanticMovePartialOutcome = formatSemanticMovePartialOutcomeText(cwd, response, aggregate, operation);
+    if (semanticMovePartialOutcome) {
+        return semanticMovePartialOutcome;
+    }
+    const objectPackFailureText = (0, mutate_object_output_1.formatObjectPackAggregateFailureText)(cwd, operation, response, aggregate, MUTATE_OBJECT_OUTPUT_HELPERS);
+    if (objectPackFailureText) {
+        return objectPackFailureText;
+    }
+    const lines = [];
+    const manualExtractionOnly = response.ok === false &&
+        (0, mutate_failure_output_1.hasNestedManualExtraction)(response) &&
+        !(0, mutate_failure_output_1.hasNestedHardSemanticFailure)(response);
+    const declarationPartial = hasDeclarationCleanupIssues(aggregate);
+    const compactSemanticPreview = isCompactSemanticPreview(response, aggregate);
+    if (response.ok === false) {
+        const failedSegment = (0, mutate_output_values_1.readNumber)(response.failedSegment);
+        const groupCount = (0, mutate_output_values_1.readNumber)(aggregate.groupCount);
+        lines.push(response.partialDeclarationCleanup === true
+            ? `${operation}${(0, mutate_output_values_1.readString)(response.previewId) ? ` ${(0, mutate_output_values_1.readString)(response.previewId)}` : ""} partial`
+            : manualExtractionOnly
+                ? `${operation} completed with manual extraction required`
+                : failedSegment && groupCount ? `${operation} failed at group ${failedSegment}/${groupCount}` : `${operation} failed`);
+    }
+    else {
+        const id = (0, mutate_output_values_1.readString)(response.previewId);
+        if (operation === "mutate.preview") {
+            lines.push(`${id ? `${operation} ${id}` : operation}${declarationPartial ? " partial" : ""}`);
+        }
+        else {
+            lines.push(id
+                ? `${operation} ${id}${declarationPartial ? " partial" : " completed"}`
+                : `${operation}${declarationPartial ? " partial" : " completed"}`);
+        }
+    }
+    const summary = compactSemanticPreview
+        ? formatCompactSemanticPreviewSummary(aggregate)
+        : response.ok === false
+            ? response.partialDeclarationCleanup === true
+                ? formatMutateAggregateSummary(aggregate, operation, response)
+                : manualExtractionOnly
+                    ? formatMutateManualExtractionOnlySummary(response) ?? formatMutateCompletedGroupsSummary(response, operation)
+                    : formatMutateCompletedGroupsSummary(response, operation)
+            : formatMutateAggregateSummary(aggregate, operation, response);
+    if (summary) {
+        lines.push(summary);
+    }
+    if (compactSemanticPreview) {
+        const next = typeof response.next === "string" ? response.next : null;
+        if (next) {
+            lines.push(`next: ${next.replace("failed segment", "failed group")}`);
+        }
+        return lines.join("\n");
+    }
+    if (response.ok === false && response.partialDeclarationCleanup !== true) {
+        appendMutateFailureSections(cwd, lines, aggregate, response, operation);
+    }
+    else {
+        appendMutateAggregateOperationSections(cwd, lines, aggregate, operation);
+    }
+    const files = response.ok === false
+        ? operation === "mutate.preview"
+            ? []
+            : (0, mutate_output_values_1.uniqueStrings)([
+                ...(0, mutate_output_values_1.readStringArray)(response.filesWritten),
+                ...(0, mutate_output_values_1.readStringArray)(aggregate.filesWritten)
+            ])
+        : operation === "mutate.preview"
+            ? (0, mutate_output_values_1.readStringArray)(aggregate.filesTouched)
+            : (0, mutate_output_values_1.readStringArray)(aggregate.filesWritten);
+    if (files.length > 0) {
+        const visibleFiles = files.length > mutate_file_view_1.MUTATE_VISIBLE_FILE_LIMIT
+            ? (0, mutate_file_view_1.selectVisibleMutateAggregateFiles)(aggregate, files)
+            : files;
+        lines.push(operation === "mutate.preview" ? "files:" : "filesWritten:");
+        lines.push(...visibleFiles.map((file) => (0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, file)));
+        if (files.length > visibleFiles.length) {
+            lines.push(`+ ${files.length - visibleFiles.length} more files hidden`);
+        }
+    }
+    const views = (0, mutate_output_values_1.readStringArray)(aggregate.views);
+    if (views.length > 0) {
+        lines.push(`view: ${views[views.length - 1]}`);
+    }
+    const next = typeof response.next === "string"
+        ? response.next
+        : declarationPartial && operation !== "mutate.preview"
+            ? defaultDeclarationCleanupPartialNext(aggregate)
+            : null;
+    if (next && !manualExtractionOnly) {
+        lines.push(`next: ${next.replace("failed segment", "failed group")}`);
+    }
+    return lines.join("\n");
+}
+function isCompactSemanticPreview(response, aggregate) {
+    if (response.operation !== "mutate.preview" || response.ok === false) {
+        return false;
+    }
+    const operations = (0, mutate_output_values_1.isObject)(aggregate.operations) ? aggregate.operations : {};
+    const allowed = new Set(["renames", "declarationMoves"]);
+    const hasSemanticIntent = (0, mutate_output_values_1.readObjectArray)(operations.renames).length > 0 ||
+        (0, mutate_output_values_1.readObjectArray)(operations.declarationMoves).length > 0;
+    return hasSemanticIntent && Object.entries(operations).every(([key, value]) => allowed.has(key) || value === null || value === undefined || (Array.isArray(value) && value.length === 0));
+}
+function formatSemanticMoveOutcomeCount(count, singular, plural = singular) {
+    return `${count} ${count === 1 ? singular : plural}`;
+}
+function appendSemanticMoveOutcomeGroup(cwd, lines, heading, items) {
+    if (items.length === 0) {
+        return;
+    }
+    const grouped = new Map();
+    for (const item of items) {
+        const entities = grouped.get(item.path) ?? [];
+        if (!entities.includes(item.entity)) {
+            entities.push(item.entity);
+        }
+        grouped.set(item.path, entities);
+    }
+    lines.push(`${heading}:`);
+    for (const [path, entities] of grouped) {
+        lines.push(`${(0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, path)}: ${entities.join(", ")}`);
+    }
+}
+function appendSemanticMoveAmbiguousGroup(cwd, lines, items) {
+    if (items.length === 0) {
+        return;
+    }
+    const grouped = new Map();
+    for (const item of items) {
+        const entry = grouped.get(item.path) ?? { entities: [], selectors: [] };
+        if (!entry.entities.includes(item.entity)) {
+            entry.entities.push(item.entity);
+        }
+        entry.selectors.push(...(item.availableSelectors ?? []));
+        grouped.set(item.path, entry);
+    }
+    lines.push("ambiguous:");
+    for (const [path, entry] of grouped) {
+        lines.push(`${(0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, path)}: ${entry.entities.join(", ")}`);
+        lines.push(...(0, mutate_output_values_1.uniqueStrings)(entry.selectors));
+    }
+}
+function formatSemanticMovePartialOutcomeText(cwd, response, aggregate, operation) {
+    if (response.ok !== false || (operation !== "mutate.apply" && operation !== "mutate.execute")) {
+        return null;
+    }
+    const resultModel = (0, mutate_output_values_1.isObject)(response.resultModel) ? response.resultModel : (0, mutate_result_projection_1.buildMutateResultModel)(response);
+    if (!resultModel) {
+        return null;
+    }
+    const rows = (0, mutate_output_values_1.readObjectArray)(resultModel.rows);
+    const operations = (0, mutate_output_values_1.isObject)(aggregate.operations) ? aggregate.operations : {};
+    const moves = (0, mutate_output_values_1.readObjectArray)(operations.declarationMoves);
+    const requestedMoves = moves.flatMap((move) => (0, mutate_output_values_1.readStringArray)(move.entities).map((entity) => ({ move, entity })));
+    if (rows.length === 0 || rows.length !== requestedMoves.length || rows.some((row) => (0, mutate_output_values_1.readString)(row.kind) !== "moveRefactor")) {
+        return null;
+    }
+    const categorized = {
+        applied: [],
+        manualExtractionRequired: [],
+        notFound: [],
+        ambiguous: [],
+        blocked: []
+    };
+    for (let index = 0; index < rows.length; index += 1) {
+        const row = rows[index] ?? {};
+        const requested = requestedMoves[index] ?? { move: {}, entity: "" };
+        const move = requested.move;
+        const entity = (0, mutate_output_values_1.readString)(row.entity) ?? requested.entity;
+        const source = (0, mutate_output_values_1.readString)(move.sourceFile);
+        const target = (0, mutate_output_values_1.readString)(move.targetFile);
+        const outcome = (0, mutate_output_values_1.readString)(row.outcome);
+        const code = (0, mutate_output_values_1.readString)(row.code);
+        let kind = null;
+        let path = null;
+        if (outcome === "applied") {
+            kind = "applied";
+            path = target;
+        }
+        else if (outcome === "manualExtractionRequired") {
+            kind = "manualExtractionRequired";
+            path = target;
+        }
+        else if (code === "SEMANTIC_MOVE_ENTITY_NOT_FOUND") {
+            kind = "notFound";
+            path = source;
+        }
+        else if (code === "SEMANTIC_MOVE_ENTITY_AMBIGUOUS") {
+            kind = "ambiguous";
+            path = source;
+        }
+        else if (code === "SEMANTIC_MOVE_REQUIRED_EDGE_UNCHANGED") {
+            kind = "blocked";
+            path = source;
+        }
+        if (!kind || !path || !entity) {
+            return null;
+        }
+        if (kind === "ambiguous") {
+            const availableSelectors = (0, mutate_output_values_1.readStringArray)(row.availableSelectors);
+            if (availableSelectors.length === 0) {
+                return null;
+            }
+            categorized.ambiguous.push({ path, entity, availableSelectors });
+            continue;
+        }
+        categorized[kind].push({ path, entity });
+    }
+    if (categorized.manualExtractionRequired.length === 0 && categorized.notFound.length === 0 &&
+        categorized.ambiguous.length === 0 && categorized.blocked.length === 0) {
+        return null;
+    }
+    const id = (0, mutate_output_values_1.readString)(response.executionId) ?? (0, mutate_output_values_1.readString)(response.previewId);
+    const lines = [
+        `${operation}${id ? ` ${id}` : ""}`,
+        [
+            formatSemanticMoveOutcomeCount(rows.length, "symbol", "symbols"),
+            ...(categorized.applied.length > 0 ? [`${categorized.applied.length} applied`] : []),
+            ...(categorized.manualExtractionRequired.length > 0 ? [`${categorized.manualExtractionRequired.length} manual extraction required`] : []),
+            ...(categorized.notFound.length > 0 ? [`${categorized.notFound.length} not found`] : []),
+            ...(categorized.ambiguous.length > 0 ? [`${categorized.ambiguous.length} ambiguous`] : []),
+            ...(categorized.blocked.length > 0 ? [`${categorized.blocked.length} blocked`] : [])
+        ].join(", ")
+    ];
+    appendSemanticMoveOutcomeGroup(cwd, lines, "moves", categorized.applied);
+    appendSemanticMoveOutcomeGroup(cwd, lines, "manualExtractionRequired", categorized.manualExtractionRequired);
+    if (categorized.manualExtractionRequired.length > 0) {
+        lines.push("reason: TypeScript move-to-file provider cannot produce edits for these symbols.");
+        lines.push("next: use manual extraction for listed symbols");
+    }
+    appendSemanticMoveOutcomeGroup(cwd, lines, "not found", categorized.notFound);
+    appendSemanticMoveAmbiguousGroup(cwd, lines, categorized.ambiguous);
+    appendSemanticMoveOutcomeGroup(cwd, lines, "blocked", categorized.blocked);
+    if (categorized.blocked.length > 0) {
+        lines.push("reason: required dynamic edge remains");
+    }
+    const files = (0, mutate_output_values_1.uniqueStrings)([
+        ...(0, mutate_output_values_1.readStringArray)(response.filesWritten),
+        ...(0, mutate_output_values_1.readStringArray)(resultModel.filesWritten),
+        ...(0, mutate_output_values_1.readStringArray)(aggregate.filesWritten)
+    ]);
+    if (files.length > 0) {
+        lines.push("filesWritten:");
+        lines.push(...files.map((file) => (0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, file)));
+    }
+    return lines.join("\n");
+}
+function formatCompactSemanticPreviewSummary(aggregate) {
+    const operations = (0, mutate_output_values_1.isObject)(aggregate.operations) ? aggregate.operations : {};
+    const renames = (0, mutate_output_values_1.readObjectArray)(operations.renames).length;
+    const moves = (0, mutate_output_values_1.readObjectArray)(operations.declarationMoves);
+    const symbols = moves.reduce((count, move) => count + (0, mutate_output_values_1.readStringArray)(move.entities).length, 0);
+    const parts = [];
+    if (renames > 0) {
+        parts.push(`${renames} ${renames === 1 ? "rename" : "renames"}`);
+    }
+    if (symbols > 0) {
+        parts.push(`${symbols} ${symbols === 1 ? "symbol" : "symbols"}`);
+        parts.push(`${moves.length} ${moves.length === 1 ? "target" : "targets"}`);
+    }
+    return `${parts.join(", ")} ready`;
+}
+function defaultDeclarationCleanupPartialNext(aggregate) {
+    const operations = (0, mutate_output_values_1.isObject)(aggregate.operations) ? aggregate.operations : {};
+    const declarationCleanups = (0, mutate_output_values_1.readObjectArray)(operations.declarationCleanups);
+    const hasNotFound = declarationCleanups.some((item) => ((0, mutate_output_values_1.readNumber)(item.notFoundCount) ?? 0) > 0);
+    return hasNotFound
+        ? "Fix missing selectors and rerun only the remaining declaration cleanup intent."
+        : "Fix failed selectors and rerun only the remaining declaration cleanup intent.";
+}
+function formatMutateAggregateSummary(aggregate, operation = "mutate.preview", response) {
+    const operations = (0, mutate_output_values_1.isObject)(aggregate.operations) ? aggregate.operations : {};
+    const renames = (0, mutate_output_values_1.readObjectArray)(operations.renames).length;
+    const declarationMoveSymbols = (0, mutate_output_values_1.readObjectArray)(operations.declarationMoves)
+        .reduce((count, move) => count + (0, mutate_output_values_1.readStringArray)(move.entities).length, 0);
+    const declarationMoveTargets = (0, mutate_output_values_1.readObjectArray)(operations.declarationMoves).length;
+    const fileMoves = (0, mutate_output_values_1.readObjectArray)(operations.fileMoves)
+        .reduce((count, move) => count + (0, mutate_output_values_1.readStringArray)(move.files).length, 0);
+    const fileRenames = (0, mutate_output_values_1.readObjectArray)(operations.fileRenames).length;
+    const fileChanges = (0, mutate_output_values_1.readObjectArray)(operations.fileChanges).length;
+    const importEdits = (0, mutate_output_values_1.readObjectArray)(operations.importNormalizations)
+        .reduce((count, item) => count + ((0, mutate_output_values_1.readNumber)(item.edits) ?? 0), 0) +
+        (0, mutate_output_values_1.readObjectArray)(operations.importRebases)
+            .reduce((count, item) => count + ((0, mutate_output_values_1.readNumber)(item.edits) ?? 0), 0);
+    const importNormalizations = (0, mutate_output_values_1.readObjectArray)(operations.importNormalizations);
+    const importRebases = (0, mutate_output_values_1.readObjectArray)(operations.importRebases);
+    const objectPacks = (0, mutate_output_values_1.readObjectArray)(operations.objectPacks);
+    const objectPackMembers = objectPacks
+        .reduce((count, item) => count + ((0, mutate_output_values_1.readNumber)(item.memberCount) ?? 0), 0);
+    const objectPackObjects = objectPacks
+        .reduce((count, item) => count + ((0, mutate_output_values_1.readNumber)(item.objectCount) ?? 0), 0);
+    const objectPackImporters = objectPacks
+        .reduce((count, item) => count + ((0, mutate_output_values_1.readNumber)(item.importerCount) ?? 0), 0);
+    const objectPackReferences = objectPacks
+        .reduce((count, item) => count + ((0, mutate_output_values_1.readNumber)(item.referenceCount) ?? 0), 0);
+    const objectRetainedMembers = objectPacks
+        .reduce((count, item) => count + ((0, mutate_output_values_1.readNumber)(item.retainedCount) ?? 0), 0);
+    const declarationCleanups = (0, mutate_output_values_1.readObjectArray)(operations.declarationCleanups);
+    const declarationsRemoved = declarationCleanups
+        .reduce((count, item) => count + ((0, mutate_output_values_1.readNumber)(item.declarationsRemoved) ?? 0), 0);
+    const importsAdded = declarationCleanups
+        .reduce((count, item) => count + ((0, mutate_output_values_1.readNumber)(item.importsAdded) ?? 0), 0);
+    const declarationNotFound = declarationCleanups
+        .reduce((count, item) => count + ((0, mutate_output_values_1.readNumber)(item.notFoundCount) ?? 0), 0);
+    const declarationSourceFailures = declarationCleanups
+        .reduce((count, item) => count + ((0, mutate_output_values_1.readNumber)(item.sourceFailureCount) ?? 0), 0);
+    const declarationSkipped = declarationCleanups
+        .reduce((count, item) => count + ((0, mutate_output_values_1.readNumber)(item.skippedCount) ?? 0), 0);
+    const declarationOnly = declarationCleanups.length > 0 &&
+        renames + declarationMoveSymbols + fileMoves + fileRenames + fileChanges + importEdits + objectPackMembers === 0;
+    if (declarationOnly) {
+        return null;
+    }
+    const parts = [];
+    if (renames > 0) {
+        parts.push(`${renames} ${renames === 1 ? "rename" : "renames"}`);
+    }
+    if (declarationMoveSymbols > 0) {
+        parts.push(`${declarationMoveSymbols} ${declarationMoveSymbols === 1 ? "symbol" : "symbols"} to ${declarationMoveTargets} ${declarationMoveTargets === 1 ? "target" : "targets"}`);
+    }
+    if (fileMoves > 0) {
+        parts.push(`${fileMoves} ${fileMoves === 1 ? "file move" : "file moves"}`);
+    }
+    if (fileRenames > 0) {
+        parts.push(`${fileRenames} ${fileRenames === 1 ? "file rename" : "file renames"}`);
+    }
+    if (fileChanges > 0) {
+        parts.push(`${fileChanges} ${fileChanges === 1 ? "file change" : "file changes"}`);
+    }
+    if (importEdits > 0) {
+        parts.push(`${importEdits} import ${importEdits === 1 ? "edit" : "edits"}`);
+    }
+    else if (importRebases.length > 0) {
+        parts.push("no import boundary changes");
+    }
+    if (objectPackMembers > 0) {
+        const objectUnpackMembers = objectPacks
+            .filter((item) => (0, mutate_object_output_1.objectOperationFromString)((0, mutate_output_values_1.readString)(item.operation)) === "unpack")
+            .reduce((count, item) => count + ((0, mutate_output_values_1.readNumber)(item.memberCount) ?? 0), 0);
+        const objectPackOnlyMembers = objectPackMembers - objectUnpackMembers;
+        if (objectPackOnlyMembers > 0) {
+            parts.push(`${objectPackOnlyMembers} ${objectPackOnlyMembers === 1 ? "export" : "exports"} packed into ${objectPackObjects} ${objectPackObjects === 1 ? "object" : "objects"}`);
+        }
+        if (objectUnpackMembers > 0) {
+            parts.push(`${objectUnpackMembers} ${objectUnpackMembers === 1 ? "export" : "exports"} unpacked from ${objectPackObjects} ${objectPackObjects === 1 ? "object" : "objects"}`);
+        }
+        if (objectPackImporters > 0 || objectPackReferences > 0) {
+            parts.push(`${objectPackImporters} ${objectPackImporters === 1 ? "importer" : "importers"} updated, ${objectPackReferences} ${objectPackReferences === 1 ? "reference" : "references"}`);
+        }
+    }
+    if (declarationsRemoved > 0) {
+        parts.push(`${declarationsRemoved} ${declarationsRemoved === 1 ? "declaration" : "declarations"} removed`);
+    }
+    if (importsAdded > 0) {
+        parts.push(`${importsAdded} ${importsAdded === 1 ? "import" : "imports"} added`);
+    }
+    const filesTouched = (0, mutate_output_values_1.readStringArray)(aggregate.filesTouched).length;
+    const notFoundText = declarationNotFound > 0
+        ? `${declarationNotFound} ${declarationNotFound === 1 ? "selector" : "selectors"} not found`
+        : null;
+    const issueParts = [
+        objectRetainedMembers > 0 ? `${objectRetainedMembers} ${objectRetainedMembers === 1 ? "member" : "members"} retained` : null,
+        notFoundText,
+        declarationSourceFailures > 0 ? `${declarationSourceFailures} source ${declarationSourceFailures === 1 ? "issue" : "issues"}` : null,
+        declarationSkipped > 0 ? `${declarationSkipped} ${declarationSkipped === 1 ? "selector" : "selectors"} skipped` : null
+    ].filter((value) => Boolean(value));
+    if (parts.length === 0 && issueParts.length === 0) {
+        return null;
+    }
+    if (importNormalizations.length > 0 &&
+        renames + declarationMoveSymbols + fileMoves + fileRenames + fileChanges === 0 &&
+        importRebases.length === 0 &&
+        declarationCleanups.length === 0) {
+        const filesChanged = (0, mutate_output_values_1.uniqueStrings)(importNormalizations.flatMap((item) => [
+            ...(0, mutate_output_values_1.readStringArray)(item.filesTouched),
+            ...(0, mutate_output_values_1.readStringArray)(item.filesWritten)
+        ])).length || (0, mutate_output_values_1.readStringArray)(aggregate.filesTouched).length || (0, mutate_output_values_1.readStringArray)(aggregate.filesWritten).length;
+        if (operation === "mutate.preview") {
+            if (importNormalizations.some((item) => item.noPolicy === true)) {
+                return "no import normalization policy matched";
+            }
+            if (importEdits === 0) {
+                return "no import normalization changes planned";
+            }
+            return `preview ok: ${importEdits} import ${importEdits === 1 ? "edit" : "edits"} planned${filesChanged > 0 ? `; ${filesChanged} ${filesChanged === 1 ? "file" : "files"} would change` : ""}`;
+        }
+        const verb = operation === "mutate.apply" ? "applied" : "executed";
+        return `${importEdits} import ${importEdits === 1 ? "edit" : "edits"} ${verb}${filesChanged > 0 ? `; ${filesChanged} ${filesChanged === 1 ? "file" : "files"} written` : ""}`;
+    }
+    if (aggregate.status === "failed" && response?.partialDeclarationCleanup !== true) {
+        return `${parts.length > 0 ? `${parts.join(", ")} before failure` : `${issueParts.join(", ")} before failure`}`;
+    }
+    const verb = operation === "mutate.apply"
+        ? "applied"
+        : operation === "mutate.execute"
+            ? "executed"
+            : "planned";
+    const filesWritten = response ? (0, mutate_output_values_1.readStringArray)(response.filesWritten).length || (0, mutate_output_values_1.readStringArray)(aggregate.filesWritten).length : (0, mutate_output_values_1.readStringArray)(aggregate.filesWritten).length;
+    if (issueParts.length > 0) {
+        const label = operation === "mutate.preview"
+            ? "preview partial"
+            : operation === "mutate.apply"
+                ? "apply partial"
+                : "execute partial";
+        const fileSuffix = operation === "mutate.preview"
+            ? filesTouched > 0 ? `; ${filesTouched} ${filesTouched === 1 ? "file" : "files"} touched` : ""
+            : filesWritten > 0 ? `; ${filesWritten} ${filesWritten === 1 ? "file" : "files"} written` : "";
+        const changeText = parts.length > 0 ? `${parts.join(", ")} ${verb}` : "no changes";
+        return `${label}: ${changeText}; ${issueParts.join(", ")}${fileSuffix}`;
+    }
+    if (operation === "mutate.preview") {
+        return `${parts.join(", ")} ${verb}${filesTouched > 0 ? `; ${filesTouched} ${filesTouched === 1 ? "file" : "files"} touched` : ""}`;
+    }
+    return `${parts.join(", ")} ${verb}${filesWritten > 0 ? `; ${filesWritten} ${filesWritten === 1 ? "file" : "files"} written` : ""}`;
+}
+function formatDeclarationCleanupAggregateSummary(aggregate, operation, response, declarationCleanups) {
+    const removeCleanups = declarationCleanups.filter((item) => (0, mutate_declaration_output_1.formatDeclarationCleanupOperationLabel)((0, mutate_output_values_1.readString)(item.operation)) === "remove");
+    const addMissingCleanups = declarationCleanups.filter((item) => (0, mutate_declaration_output_1.formatDeclarationCleanupOperationLabel)((0, mutate_output_values_1.readString)(item.operation)) === "addMissing");
+    const declarations = (0, mutate_declaration_output_1.sumNumberField)(removeCleanups, "declarationsRemoved");
+    const imports = (0, mutate_declaration_output_1.sumNumberField)(addMissingCleanups, "importsAdded");
+    const sourceIssues = (0, mutate_declaration_output_1.sumNumberField)(addMissingCleanups, "sourceFailureCount");
+    const skipped = (0, mutate_declaration_output_1.sumNumberField)(addMissingCleanups, "skippedCount");
+    const notFound = (0, mutate_declaration_output_1.sumNumberField)(declarationCleanups, "notFoundCount");
+    const filesTouched = (0, mutate_output_values_1.readStringArray)(aggregate.filesTouched).length;
+    const filesWritten = response
+        ? (0, mutate_output_values_1.readStringArray)(response.filesWritten).length || (0, mutate_output_values_1.readStringArray)(aggregate.filesWritten).length
+        : (0, mutate_output_values_1.readStringArray)(aggregate.filesWritten).length;
+    if (operation === "mutate.preview") {
+        const resolvedSources = (0, mutate_declaration_output_1.countDeclarationSourceSelectors)(addMissingCleanups);
+        const issueParts = [
+            sourceIssues > 0 ? `${sourceIssues} source ${sourceIssues === 1 ? "issue" : "issues"}` : null,
+            notFound > 0 ? `${notFound} ${notFound === 1 ? "selector" : "selectors"} not found` : null,
+            skipped > 0 ? `${skipped} ${skipped === 1 ? "selector" : "selectors"} skipped` : null
+        ].filter((value) => Boolean(value));
+        const plannedParts = [
+            declarations > 0 ? `${declarations} ${declarations === 1 ? "declaration" : "declarations"} planned for removal` : null,
+            resolvedSources > 0 ? `${resolvedSources} addMissing ${resolvedSources === 1 ? "source" : "sources"} resolved` : null
+        ].filter((value) => Boolean(value));
+        if (plannedParts.length === 0 && issueParts.length === 0) {
+            return null;
+        }
+        const label = issueParts.length > 0 ? "preview partial" : "preview ok";
+        const fileSuffix = filesTouched > 0 ? `; ${filesTouched} ${filesTouched === 1 ? "file" : "files"} touched` : "";
+        return `${label}: ${[...plannedParts, ...issueParts].join("; ")}${fileSuffix}`;
+    }
+    const issueParts = [
+        sourceIssues > 0 ? `${sourceIssues} source ${sourceIssues === 1 ? "issue" : "issues"}` : null,
+        notFound > 0 ? `${notFound} ${notFound === 1 ? "selector" : "selectors"} not found` : null,
+        skipped > 0 ? `${skipped} ${skipped === 1 ? "selector" : "selectors"} skipped` : null
+    ].filter((value) => Boolean(value));
+    if (issueParts.length === 0) {
+        return null;
+    }
+    const label = operation === "mutate.apply" ? "apply partial" : "execute partial";
+    const changeParts = [
+        declarations > 0 ? `${declarations} ${declarations === 1 ? "declaration" : "declarations"} removed` : null,
+        imports > 0 ? `${imports} ${imports === 1 ? "import" : "imports"} added` : null
+    ].filter((value) => Boolean(value));
+    const fileSuffix = filesWritten > 0 ? `; ${filesWritten} ${filesWritten === 1 ? "file" : "files"} written` : "";
+    return `${label}: ${[...changeParts, ...issueParts].join("; ")}${fileSuffix}`;
+}
+function formatMutateCompletedGroupsSummary(response, operation = "mutate.preview") {
+    const completedGroups = (0, mutate_failure_output_1.readCompletedAggregateGroups)(response);
+    if (completedGroups.length === 0) {
+        return null;
+    }
+    let renames = 0;
+    let declarationMoveSymbols = 0;
+    let fileMoves = 0;
+    let fileRenames = 0;
+    let fileChanges = 0;
+    for (const group of completedGroups) {
+        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);
+            renames += operations
+                .filter((operation) => operation.op === "rename")
+                .reduce((count, operation) => count + (0, mutate_output_values_1.readObjectArray)(operation.renames).length, 0);
+            declarationMoveSymbols += operations
+                .filter((operation) => operation.op === "move")
+                .reduce((count, operation) => count + (0, mutate_output_values_1.readStringArray)(operation.entities).length, 0);
+        }
+        if (details.kind === "file") {
+            fileMoves += (0, mutate_output_values_1.readObjectArray)(details.moves).reduce((count, move) => count + (0, mutate_output_values_1.readStringArray)(move.files).length, 0);
+            fileRenames += (0, mutate_output_values_1.readObjectArray)(details.renames).length;
+            fileChanges += (0, mutate_output_values_1.readObjectArray)(details.changes).length;
+        }
+    }
+    if (renames + declarationMoveSymbols + fileMoves + fileRenames + fileChanges === 0) {
+        return null;
+    }
+    const verb = mutateCompletedGroupVerb(operation);
+    return `${completedGroups.length} ${completedGroups.length === 1 ? "group" : "groups"} ${verb} before failure`;
+}
+function formatMutateManualExtractionOnlySummary(response) {
+    let symbolCount = 0;
+    let appliedCount = 0;
+    let manualExtractionCount = 0;
+    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 entities = (0, mutate_output_values_1.readStringArray)(row.entities);
+                const manual = (0, mutate_output_values_1.readNestedManualExtractionEntities)(row);
+                symbolCount += entities.length;
+                manualExtractionCount += manual.length;
+                appliedCount += row.ok === false
+                    ? (0, mutate_output_values_1.readStringArray)(row.appliedEntities).length
+                    : entities.length;
+            }
+        }
+        if (details.kind === "semantic") {
+            for (const operation of (0, mutate_output_values_1.readObjectArray)(details.operations).filter((item) => item.op === "move")) {
+                for (const row of (0, mutate_output_values_1.readObjectArray)(operation.rows)) {
+                    symbolCount += 1;
+                    appliedCount += row.ok === false ? 0 : 1;
+                }
+            }
+            for (const row of (0, mutate_output_values_1.readObjectArray)(details.rows).filter(mutate_output_values_1.isSemanticManualExtractionRow)) {
+                manualExtractionCount += 1;
+            }
+        }
+    }
+    if (symbolCount === 0 || manualExtractionCount === 0) {
+        return null;
+    }
+    const parts = [`${symbolCount} ${symbolCount === 1 ? "symbol" : "symbols"}`];
+    if (appliedCount > 0) {
+        parts.push(`${appliedCount} applied`);
+    }
+    parts.push(`${manualExtractionCount} manual extraction required`);
+    return parts.join(", ");
+}
+function mutateCompletedGroupVerb(operation) {
+    if (operation === "mutate.preview") {
+        return "checked";
+    }
+    if (operation === "mutate.execute") {
+        return "executed";
+    }
+    return "applied";
+}
+function appendMutateAggregateOperationSections(cwd, lines, aggregate, operation = "mutate.preview") {
+    const operations = (0, mutate_output_values_1.isObject)(aggregate.operations) ? aggregate.operations : {};
+    const renames = (0, mutate_output_values_1.readObjectArray)(operations.renames);
+    if (renames.length > 0) {
+        lines.push("renames:");
+        (0, mutate_failure_output_1.appendGroupedRenameLines)(cwd, lines, renames);
+    }
+    const declarationMoves = (0, mutate_output_values_1.readObjectArray)(operations.declarationMoves);
+    if (declarationMoves.length > 0) {
+        lines.push(operation === "mutate.preview" ? "targets:" : "moves:");
+        for (const move of declarationMoves) {
+            const targetFile = (0, mutate_output_values_1.readString)(move.targetFile) ?? "?";
+            lines.push(`${(0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, targetFile)}: ${(0, mutate_output_values_1.formatCompactList)((0, mutate_output_values_1.readStringArray)(move.entities), 5)}`);
+        }
+    }
+    const fileMoves = (0, mutate_output_values_1.readObjectArray)(operations.fileMoves);
+    if (fileMoves.length > 0) {
+        lines.push("fileMoves:");
+        for (const move of fileMoves) {
+            const targetDir = (0, mutate_output_values_1.readString)(move.targetDir) ?? "?";
+            lines.push(`${(0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, targetDir)}: ${(0, mutate_output_values_1.formatCompactList)((0, mutate_output_values_1.readStringArray)(move.files).map((file) => (0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, file)), 5)}`);
+        }
+    }
+    const fileRenames = (0, mutate_output_values_1.readObjectArray)(operations.fileRenames);
+    if (fileRenames.length > 0) {
+        lines.push("fileRenames:");
+        for (const rename of fileRenames) {
+            lines.push(`${(0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, (0, mutate_output_values_1.readString)(rename.source) ?? "?")} -> ${(0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, (0, mutate_output_values_1.readString)(rename.target) ?? "?")}`);
+        }
+    }
+    const fileChanges = (0, mutate_output_values_1.readObjectArray)(operations.fileChanges);
+    if (fileChanges.length > 0) {
+        lines.push("fileChanges:");
+        for (const change of fileChanges) {
+            lines.push(`${(0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, (0, mutate_output_values_1.readString)(change.source) ?? "?")} -> ${(0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, (0, mutate_output_values_1.readString)(change.target) ?? "?")}`);
+        }
+    }
+    const importNormalizations = (0, mutate_output_values_1.readObjectArray)(operations.importNormalizations);
+    if (importNormalizations.length > 0) {
+        lines.push("imports:");
+        for (const item of importNormalizations) {
+            const target = (0, mutate_output_values_1.readString)(item.target) ?? "imports";
+            const edits = (0, mutate_output_values_1.readNumber)(item.edits) ?? 0;
+            const filesChanged = (0, mutate_output_values_1.readNumber)(item.filesChanged) ?? 0;
+            if (item.noPolicy === true) {
+                lines.push("imports.normalize: no matching config policy; no changes");
+                continue;
+            }
+            const targetText = item.overrideConfig === true ? `${target} overrideConfig` : target;
+            lines.push(`imports.normalize ${targetText}: ${edits} ${edits === 1 ? "edit" : "edits"}, ${filesChanged} ${filesChanged === 1 ? "file" : "files"}`);
+            appendImportNormalizePolicyLines(lines, (0, mutate_output_values_1.readObjectArray)(item.policyGroups));
+            appendImportNormalizeSampleLines(cwd, lines, (0, mutate_output_values_1.readObjectArray)(item.samples));
+        }
+    }
+    const importRebases = (0, mutate_output_values_1.readObjectArray)(operations.importRebases);
+    if (importRebases.length > 0) {
+        lines.push("imports:");
+        for (const item of importRebases) {
+            const importOperation = (0, mutate_output_values_1.readString)(item.operation) ?? "imports.rebase";
+            const edits = (0, mutate_output_values_1.readNumber)(item.edits) ?? 0;
+            const filesChanged = (0, mutate_output_values_1.readNumber)(item.filesChanged) ?? 0;
+            const symbolsUpdated = (0, mutate_output_values_1.readNumber)(item.symbolsUpdated) ?? 0;
+            const barrel = (0, mutate_output_values_1.readString)(item.barrel);
+            const skipped = (0, mutate_output_values_1.readNumber)(item.skippedCount) ?? 0;
+            lines.push(`${importOperation}: ${symbolsUpdated} ${symbolsUpdated === 1 ? "symbol" : "symbols"}, ${edits} ${edits === 1 ? "import" : "imports"}, ${filesChanged} ${filesChanged === 1 ? "file" : "files"}`);
+            if (barrel) {
+                lines.push(`barrel: ${(0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, barrel)}`);
+            }
+            if (skipped > 0) {
+                appendImportRebaseSkippedAggregateLines(cwd, lines, (0, mutate_output_values_1.readObjectArray)(item.skipped));
+            }
+        }
+    }
+    const objectPacks = (0, mutate_output_values_1.readObjectArray)(operations.objectPacks);
+    if (objectPacks.length > 0) {
+        lines.push("objects:");
+        for (const pack of objectPacks) {
+            for (const object of (0, mutate_output_values_1.readObjectArray)(pack.objects)) {
+                const objectName = (0, mutate_output_values_1.readString)(object.objectName) ?? "object";
+                lines.push(`${objectName}: ${(0, mutate_output_values_1.formatCompactList)((0, mutate_output_values_1.readStringArray)(object.selectors), 6)}`);
+            }
+        }
+        const importers = objectPacks.flatMap((pack) => (0, mutate_output_values_1.readObjectArray)(pack.importers));
+        if (importers.length > 0) {
+            lines.push("imports:");
+            for (const importer of importers.slice(0, 8)) {
+                const file = (0, mutate_output_values_1.readString)(importer.file) ?? "?";
+                const objectNames = (0, mutate_output_values_1.readStringArray)(importer.objectNames);
+                const objectName = objectNames.length > 0
+                    ? objectNames.join(", ")
+                    : (0, mutate_output_values_1.readString)(importer.objectName) ?? "object";
+                const selectors = (0, mutate_output_values_1.readStringArray)(importer.selectors);
+                const refs = (0, mutate_output_values_1.readNumber)(importer.referenceCount) ?? 0;
+                lines.push(`${(0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, file)}: ${objectName} for ${(0, mutate_output_values_1.formatCompactList)(selectors, 5)}; ${refs} ${refs === 1 ? "reference" : "references"}`);
+            }
+            if (importers.length > 8) {
+                lines.push(`+${importers.length - 8} more importers`);
+            }
+        }
+        const unsupported = objectPacks.flatMap((pack) => (0, mutate_output_values_1.readObjectArray)(pack.unsupported));
+        if (unsupported.length > 0) {
+            lines.push("unsupported:");
+            for (const item of unsupported.slice(0, 8)) {
+                const selector = (0, mutate_output_values_1.readString)(item.selector) ?? (0, mutate_output_values_1.readString)(item.objectName) ?? "exports.object";
+                const message = (0, mutate_output_values_1.readString)(item.message) ?? (0, mutate_output_values_1.readString)(item.code) ?? "unsupported";
+                const file = (0, mutate_output_values_1.readString)(item.file);
+                lines.push(`${selector}: ${message}${file ? ` (${(0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, file)})` : ""}`);
+            }
+            if (unsupported.length > 8) {
+                lines.push(`+${unsupported.length - 8} more unsupported issues`);
+            }
+        }
+        const retained = objectPacks.flatMap((pack) => (0, mutate_output_values_1.readObjectArray)(pack.retained));
+        if (retained.length > 0) {
+            lines.push("retained:");
+            for (const item of retained.slice(0, 8)) {
+                const objectName = (0, mutate_output_values_1.readString)(item.objectName) ?? "object";
+                const selector = (0, mutate_output_values_1.readString)(item.selector) ?? "member";
+                const issues = (0, mutate_output_values_1.readObjectArray)(item.issues);
+                const message = (0, mutate_output_values_1.readString)(issues[0]?.message) ?? (0, mutate_output_values_1.readString)(issues[0]?.code) ?? "unsupported";
+                lines.push(`${objectName}.${selector}: ${message}`);
+            }
+            if (retained.length > 8) {
+                lines.push(`+${retained.length - 8} more retained members`);
+            }
+        }
+        const notRun = objectPacks.flatMap((pack) => (0, mutate_output_values_1.readObjectArray)(pack.notRun));
+        if (notRun.length > 0) {
+            lines.push("notRun:");
+            for (const item of notRun.slice(0, 8)) {
+                lines.push(`${(0, mutate_output_values_1.readString)(item.objectName) ?? "object"}: ${(0, mutate_output_values_1.formatCompactList)((0, mutate_output_values_1.readStringArray)(item.selectors), 6)}`);
+            }
+        }
+    }
+    const declarationCleanups = (0, mutate_output_values_1.readObjectArray)(operations.declarationCleanups);
+    if (declarationCleanups.length > 0) {
+        (0, mutate_declaration_output_1.appendDeclarationCleanupOperationSummaryLines)(lines, declarationCleanups, operation);
+        (0, mutate_declaration_output_1.appendDeclarationSourcesAggregateLines)(lines, declarationCleanups, operation);
+        (0, mutate_declaration_output_1.appendDeclarationFailuresAggregateLines)(lines, declarationCleanups);
+        (0, mutate_declaration_output_1.appendDeclarationSkippedAggregateLines)(lines, declarationCleanups);
+        (0, mutate_declaration_output_1.appendDeclarationNotFoundAggregateLines)(lines, declarationCleanups);
+    }
+}
+function appendImportNormalizeSampleLines(cwd, lines, samples) {
+    if (samples.length === 0) {
+        return;
+    }
+    lines.push("samples:");
+    for (const [file, edits] of groupJsonObjectsBy(samples, (item) => (0, mutate_output_values_1.readString)(item.file) ?? "")) {
+        if (file) {
+            lines.push((0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, file));
+        }
+        for (const edit of edits) {
+            const from = (0, mutate_output_values_1.readString)(edit.from);
+            const to = (0, mutate_output_values_1.readString)(edit.to);
+            if (from && to) {
+                lines.push(`  ${from} -> ${to}`);
+            }
+        }
+    }
+}
+function appendImportNormalizePolicyLines(lines, policyGroups) {
+    if (policyGroups.length === 0) {
+        return;
+    }
+    lines.push("policies:");
+    for (const section of groupImportNormalizePolicies(policyGroups)) {
+        lines.push(`${section.label}:`);
+        for (const scope of section.scopes) {
+            if (section.ruleKind === "boundary") {
+                lines.push(`  scope=${scope.scope}`);
+                for (const group of scope.groups) {
+                    lines.push(`    ${formatImportNormalizePolicyGroupLine(group)}`);
+                }
+                continue;
+            }
+            for (const group of scope.groups) {
+                lines.push(`  ${formatImportNormalizePolicyGroupLine(group)}`);
+            }
+        }
+    }
+}
+function groupImportNormalizePolicies(policyGroups) {
+    const sorted = [...policyGroups].sort(compareImportNormalizePolicyGroups);
+    const sections = new Map();
+    for (const group of sorted) {
+        const source = (0, mutate_output_values_1.readString)(group.source) ?? "policy";
+        const ruleKind = (0, mutate_output_values_1.readString)(group.ruleKind) ?? "simple";
+        const sectionKey = `${source}\0${ruleKind}`;
+        if (!sections.has(sectionKey)) {
+            sections.set(sectionKey, {
+                label: ruleKind === "explicit" ? source : `${source} ${ruleKind}`,
+                ruleKind,
+                scopes: new Map()
+            });
+        }
+        const section = sections.get(sectionKey);
+        const scope = (0, mutate_output_values_1.readString)(group.ruleScope) ?? "request";
+        section.scopes.set(scope, [...(section.scopes.get(scope) ?? []), group]);
+    }
+    return Array.from(sections.values()).map((section) => ({
+        label: section.label,
+        ruleKind: section.ruleKind,
+        scopes: Array.from(section.scopes.entries()).map(([scope, groups]) => ({ scope, groups }))
+    }));
+}
+function compareImportNormalizePolicyGroups(left, right) {
+    return importNormalizePolicySectionRank(left) - importNormalizePolicySectionRank(right)
+        || ((0, mutate_output_values_1.readString)(left.ruleScope) ?? "").localeCompare((0, mutate_output_values_1.readString)(right.ruleScope) ?? "")
+        || importNormalizeRelationRank(left) - importNormalizeRelationRank(right)
+        || ((0, mutate_output_values_1.readString)(left.target) ?? "").localeCompare((0, mutate_output_values_1.readString)(right.target) ?? "");
+}
+function importNormalizePolicySectionRank(group) {
+    const source = (0, mutate_output_values_1.readString)(group.source) ?? "";
+    const ruleKind = (0, mutate_output_values_1.readString)(group.ruleKind) ?? "";
+    if (source === "config" && ruleKind === "boundary") {
+        return 0;
+    }
+    if (source === "config" && ruleKind === "simple") {
+        return 1;
+    }
+    if (ruleKind === "explicit") {
+        return 2;
+    }
+    return 3;
+}
+function importNormalizeRelationRank(group) {
+    const relation = (0, mutate_output_values_1.readString)(group.relation);
+    if (relation === "outside") {
+        return 0;
+    }
+    if (relation === "inside") {
+        return 1;
+    }
+    return 2;
+}
+function formatImportNormalizePolicyGroupLine(group) {
+    const relation = (0, mutate_output_values_1.readString)(group.relation);
+    const target = (0, mutate_output_values_1.readString)(group.target) ?? "?";
+    const edits = (0, mutate_output_values_1.readNumber)(group.edits) ?? 0;
+    const files = (0, mutate_output_values_1.readNumber)(group.filesChanged) ?? 0;
+    const scope = (0, mutate_output_values_1.readString)(group.ruleScope);
+    const parts = [
+        relation,
+        scope && !relation ? `scope=${scope}` : null,
+        `to=${target}`
+    ].filter((item) => Boolean(item));
+    return `${parts.join(" ")}: ${edits} ${edits === 1 ? "edit" : "edits"}, ${files} ${files === 1 ? "file" : "files"}`;
+}
+function groupJsonObjectsBy(items, keyFn) {
+    const groups = new Map();
+    for (const item of items) {
+        const key = keyFn(item);
+        groups.set(key, [...(groups.get(key) ?? []), item]);
+    }
+    return Array.from(groups.entries());
+}
+function appendImportRebaseSkippedAggregateLines(cwd, lines, skipped) {
+    lines.push(`skipped: ${skipped.length}`);
+    const barrelGraph = skipped.filter((item) => {
+        const reason = (0, mutate_output_values_1.readString)(item.reason);
+        return reason === "barrel file skipped" || reason === "inside barrel export graph";
+    });
+    if (barrelGraph.length > 0) {
+        const files = barrelGraph
+            .map((item) => (0, mutate_output_values_1.readString)(item.file))
+            .filter((file) => file !== null);
+        lines.push(`barrel graph consumers: ${barrelGraph.length} ${barrelGraph.length === 1 ? "file" : "files"}${files.length > 0 ? ` under ${formatCommonPathGlobForMutateOutput(cwd, files)}` : ""}`);
+    }
+    const other = skipped.filter((item) => !barrelGraph.includes(item));
+    for (const skippedItem of other.slice(0, 6)) {
+        const file = (0, mutate_output_values_1.readString)(skippedItem.file);
+        const selector = (0, mutate_output_values_1.readString)(skippedItem.selector);
+        const reason = (0, mutate_output_values_1.readString)(skippedItem.reason) ?? "skipped";
+        const subject = selector ?? (file ? (0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, file) : "item");
+        lines.push(`${subject}: ${reason}`);
+    }
+    if (other.length > 6) {
+        lines.push(`+ ${other.length - 6} more skipped`);
+    }
+}
+function formatCommonPathGlobForMutateOutput(cwd, files) {
+    const normalized = files.map((file) => (0, mutate_failure_output_1.formatPathForMutateOutput)(cwd, file).replace(/\\/g, "/"));
+    if (normalized.length === 0) {
+        return "**";
+    }
+    const parts = normalized.map((file) => file.split("/"));
+    const common = [];
+    for (let index = 0;; index += 1) {
+        const value = parts[0]?.[index];
+        if (!value || parts.some((part) => part[index] !== value)) {
+            break;
+        }
+        common.push(value);
+    }
+    if (common.length === 0) {
+        return "**";
+    }
+    const last = common[common.length - 1] ?? "";
+    const hasExtension = /\.[^/.]+$/.test(last);
+    return `${(hasExtension ? common.slice(0, -1) : common).join("/") || "."}/**`;
+}
+function appendMutateAggregateGroupLines(lines, aggregate) {
+    const completedCount = (0, mutate_output_values_1.readNumber)(aggregate.completedGroupCount) ?? 0;
+    if (completedCount > 0) {
+        lines.push("completed:");
+        lines.push(`${completedCount} ${completedCount === 1 ? "group" : "groups"}`);
+    }
+    if ((0, mutate_output_values_1.isObject)(aggregate.failedGroup)) {
+        const group = aggregate.failedGroup;
+        lines.push("failedGroup:");
+        lines.push(`${(0, mutate_output_values_1.readNumber)(group.index) ?? "?"}. ${(0, mutate_output_values_1.readString)(group.kind) ?? "unknown"} - ${(0, mutate_output_values_1.readString)(group.summary) ?? "failed"}`);
+    }
+    const notRun = (0, mutate_output_values_1.readObjectArray)(aggregate.notRunGroups);
+    if (notRun.length > 0) {
+        lines.push("notRun:");
+        for (const group of notRun) {
+            lines.push(`${(0, mutate_output_values_1.readNumber)(group.index) ?? "?"}. ${(0, mutate_output_values_1.readString)(group.kind) ?? "unknown"}`);
+        }
+    }
+}
++function appendMutatePreviewFailureSections(cwd, lines, aggregate, response) {
+    appendMutateFailureSections(cwd, lines, aggregate, response, "mutate.preview");
+};
+function appendMutateFailureSections(cwd, lines, aggregate, response, operation = "mutate.preview") {
+    const completedGroups = (0, mutate_failure_output_1.readCompletedAggregateGroups)(response);
+    if (completedGroups.length > 0) {
+        lines.push(`${mutateCompletedGroupVerb(operation)}:`);
+        for (const group of completedGroups) {
+            lines.push(`${(0, mutate_output_values_1.readNumber)(group.index) ?? "?"}. ${(0, mutate_output_values_1.readString)(group.kind) ?? "unknown"} - ${(0, mutate_failure_output_1.formatMutateGroupOperationSummary)(group)}`);
+        }
+        appendMutateCompletedOperationSections(cwd, lines, completedGroups);
+    }
+    (0, mutate_failure_output_1.appendManualExtractionAppliedMoveLines)(cwd, lines, response, operation);
+    const appendedManualExtraction = (0, mutate_failure_output_1.appendNestedMutateManualExtractionRequiredLines)(cwd, lines, response);
+    if (appendedManualExtraction && !(0, mutate_failure_output_1.hasNestedHardSemanticFailure)(response)) {
+        return;
+    }
+    lines.push("failed:");
+    const failedGroup = (0, mutate_output_values_1.isObject)(aggregate.failedGroup) ? aggregate.failedGroup : {};
+    const groupIndex = (0, mutate_output_values_1.readNumber)(failedGroup.index);
+    const groupKind = (0, mutate_output_values_1.readString)(failedGroup.kind) ?? "unknown";
+    lines.push(groupIndex ? `${groupIndex}. ${(0, mutate_failure_output_1.formatMutateGroupKind)(groupKind)}` : (0, mutate_failure_output_1.formatMutateGroupKind)(groupKind));
+    (0, mutate_failure_output_1.appendNestedMutateFailureLines)(cwd, lines, response);
+    const notRun = (0, mutate_output_values_1.readObjectArray)(aggregate.notRunGroups);
+    if (notRun.length > 0) {
+        lines.push("notRun:");
+        if (groupIndex) {
+            lines.push(`all groups after ${groupIndex}`);
+        }
+        else {
+            for (const group of notRun) {
+                lines.push(`${(0, mutate_output_values_1.readNumber)(group.index) ?? "?"}. ${(0, mutate_output_values_1.readString)(group.kind) ?? "unknown"}`);
+            }
+        }
+    }
+}
+function appendMutateCompletedOperationSections(cwd, lines, completedGroups) {
+    appendMutateAggregateOperationSections(cwd, lines, {
+        operations: (0, mutate_result_projection_1.buildAggregateOperations)(completedGroups)
+    }, "mutate.execute");
+}