@automaton-labs/aib 0.0.7 → 0.0.9

package/dist/commands/object-pack-command.js

@@ -0,0 +1,546 @@
+"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.runObjectPackSegment = runObjectPackSegment;
+exports.applyObjectPackPreview = applyObjectPackPreview;
+exports.formatObjectPackMutateText = formatObjectPackMutateText;
+exports.buildObjectPackViewResponse = buildObjectPackViewResponse;
+const crypto = __importStar(require("node:crypto"));
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const agent_text_1 = require("../shared/agent-text");
+const errors_1 = require("../shared/errors");
+const object_pack_semantic_preview_1 = require("../mutation/object-pack-semantic-preview");
+const object_unpack_semantic_preview_1 = require("../mutation/object-unpack-semantic-preview");
+const object_pack_semantic_apply_1 = require("../mutation/object-pack-semantic-apply");
+const object_pack_preview_cache_1 = require("./object-pack-preview-cache");
+const session_workspace_1 = require("./session-workspace");
+async function runObjectPackSegment(cwd, segment, action, writeOptions = {}) {
+    const normalized = normalizeObjectPackPayload(cwd, segment);
+    if (normalized.operation === "unpack") {
+        if (action === "execute") {
+            const outcome = (0, object_pack_semantic_apply_1.executeCurrentObjectUnpackSemanticPlan)(cwd, {
+                sourceFile: normalized.sourceFile,
+                rows: normalized.packs.map((pack) => ({ objectName: pack.objectName, selectors: pack.selectors }))
+            }, writeOptions);
+            if (outcome.plan && outcome.response.ok !== false) {
+                attachSemanticObjectView(cwd, outcome.response, outcome.plan, true);
+            }
+            return (0, agent_text_1.attachAgentText)(outcome.response, formatObjectPackAgentText(cwd, outcome.response, action));
+        }
+        const result = (0, object_unpack_semantic_preview_1.planObjectUnpackSemanticPreview)(cwd, {
+            sourceFile: normalized.sourceFile,
+            rows: normalized.packs.map((pack) => ({ objectName: pack.objectName, selectors: pack.selectors }))
+        });
+        const response = result;
+        if (!result.ok) {
+            return (0, agent_text_1.attachAgentText)(response, formatObjectPackAgentText(cwd, response, "preview"));
+        }
+        const fileHashes = Object.fromEntries(result.beforeHashes.map((item) => [item.file, item.beforeHash]));
+        const normalizedPayload = normalizedPayloadForCache(normalized);
+        const previewId = (0, object_pack_preview_cache_1.buildObjectPackPreviewId)(normalizedPayload, fileHashes);
+        response.previewId = previewId;
+        response.next = "Use the mutate preview id to apply this exact semantic plan.";
+        attachSemanticObjectView(cwd, response, result);
+        const previewHash = (0, object_pack_preview_cache_1.buildObjectPackPreviewHash)(normalizedPayload, fileHashes, response);
+        (0, object_pack_preview_cache_1.writeObjectPackPreviewRecord)(cwd, {
+            schemaVersion: 1,
+            kind: "semantic-object-pack-preview",
+            plannerVersion: 1,
+            previewId,
+            previewHash,
+            createdAt: new Date().toISOString(),
+            cwd: path.resolve(cwd),
+            normalizedPayload,
+            fileHashes,
+            previewResult: response
+        });
+        return (0, agent_text_1.attachAgentText)(response, formatObjectPackAgentText(cwd, response, "preview"));
+    }
+    if (action === "execute") {
+        const outcome = (0, object_pack_semantic_apply_1.executeCurrentObjectPackSemanticPlan)(cwd, {
+            sourceFile: normalized.sourceFile,
+            rows: normalized.packs.map((pack) => ({ objectName: pack.objectName, selectors: pack.selectors }))
+        }, writeOptions);
+        if (outcome.plan && outcome.response.ok !== false) {
+            attachSemanticObjectView(cwd, outcome.response, outcome.plan, true);
+        }
+        return (0, agent_text_1.attachAgentText)(outcome.response, formatObjectPackAgentText(cwd, outcome.response, action));
+    }
+    const result = (0, object_pack_semantic_preview_1.planObjectPackSemanticPreview)(cwd, {
+        sourceFile: normalized.sourceFile,
+        rows: normalized.packs.map((pack) => ({ objectName: pack.objectName, selectors: pack.selectors }))
+    });
+    const response = result;
+    if (!result.ok) {
+        return (0, agent_text_1.attachAgentText)(response, formatObjectPackAgentText(cwd, response, "preview"));
+    }
+    const fileHashes = Object.fromEntries(result.beforeHashes.map((item) => [item.file, item.beforeHash]));
+    const normalizedPayload = normalizedPayloadForCache(normalized);
+    const previewId = (0, object_pack_preview_cache_1.buildObjectPackPreviewId)(normalizedPayload, fileHashes);
+    response.previewId = previewId;
+    response.next = "Use the mutate preview id to apply this exact semantic plan.";
+    attachSemanticObjectView(cwd, response, result);
+    const previewHash = (0, object_pack_preview_cache_1.buildObjectPackPreviewHash)(normalizedPayload, fileHashes, response);
+    (0, object_pack_preview_cache_1.writeObjectPackPreviewRecord)(cwd, {
+        schemaVersion: 1,
+        kind: "semantic-object-pack-preview",
+        plannerVersion: 1,
+        previewId,
+        previewHash,
+        createdAt: new Date().toISOString(),
+        cwd: path.resolve(cwd),
+        normalizedPayload,
+        fileHashes,
+        previewResult: response
+    });
+    return (0, agent_text_1.attachAgentText)(response, formatObjectPackAgentText(cwd, response, "preview"));
+}
+async function applyObjectPackPreview(cwd, previewId, writeOptions = {}) {
+    const outcome = (0, object_pack_semantic_apply_1.applyPersistedObjectPackSemanticPreview)(cwd, previewId, writeOptions);
+    const response = outcome.response;
+    if (outcome.plan && response.ok !== false) {
+        attachSemanticObjectView(cwd, response, outcome.plan, true);
+    }
+    return (0, agent_text_1.attachAgentText)(response, formatObjectPackAgentText(cwd, response, "apply"));
+}
+function formatObjectPackMutateText(cwd, action, previewId, response, childPreviewId) {
+    const text = formatObjectPackAgentText(cwd, response, action);
+    if (!text) {
+        return null;
+    }
+    if (action === "preview") {
+        if (!previewId) {
+            return null;
+        }
+        const next = childPreviewId
+            ? text.replace(/aib exports object (pack|unpack) apply \S+/, `aib mutate apply ${previewId}`)
+            : text;
+        return replaceFirstLine(next, `mutate.preview ${previewId}`);
+    }
+    if (action === "apply") {
+        return replaceFirstLine(text, previewId ? `mutate.apply ${previewId}` : "mutate.apply");
+    }
+    return replaceFirstLine(text, "mutate.execute");
+}
+function buildObjectPackViewResponse(cwd, artifact, handle) {
+    const operation = objectOperationFromName(readString(artifact.operation) ?? "") ?? "pack";
+    const lines = [`object.${operation} ${handle}`];
+    const sourceFile = readString(artifact.sourceFile);
+    if (sourceFile) {
+        lines.push(`source: ${formatPath(cwd, sourceFile)}`);
+    }
+    const packs = readObjectArray(artifact.packs);
+    if (packs.length > 0) {
+        lines.push("objects:");
+        for (const pack of packs) {
+            const objectName = readString(pack.objectName) ?? "object";
+            const selectors = readStringArray(pack.selectors);
+            lines.push(`${objectName}: ${selectors.join(", ")}`);
+        }
+    }
+    const sourceEdits = readObjectArray(artifact.sourceEdits);
+    if (sourceEdits.length > 0) {
+        lines.push("source rewrite:");
+        for (const item of sourceEdits) {
+            lines.push(`${readString(item.objectName) ?? "object"}: ${operation === "unpack" ? "selected members exported; object members removed" : "export object added; selected exports made local"}`);
+        }
+    }
+    const importers = readObjectArray(artifact.importers);
+    if (importers.length > 0) {
+        lines.push("importers:");
+        for (const importer of importers) {
+            const file = readString(importer.file) ?? "";
+            const objectNames = readStringArray(importer.objectNames);
+            const objectName = objectNames.length > 0 ? objectNames.join(", ") : readString(importer.objectName) ?? "object";
+            const selectors = readStringArray(importer.selectors);
+            const referenceCount = readNumber(importer.referenceCount) ?? 0;
+            lines.push(`${formatPath(cwd, file)}: ${objectName} for ${selectors.join(", ")}; ${referenceCount} ${referenceCount === 1 ? "reference" : "references"}`);
+        }
+    }
+    const unsupported = readObjectArray(artifact.unsupported);
+    if (unsupported.length > 0) {
+        lines.push("unsupported:");
+        for (const item of unsupported) {
+            const selector = readString(item.selector);
+            const file = readString(item.file);
+            const message = readString(item.message) ?? readString(item.code) ?? "unsupported";
+            lines.push(`${selector ? `${selector}: ` : ""}${message}${file ? ` (${formatPath(cwd, file)})` : ""}`);
+            const candidates = readStringArray(item.candidates);
+            if (candidates.length > 0) {
+                lines.push(`  candidates: ${candidates.join(", ")}`);
+            }
+        }
+    }
+    const retained = readObjectArray(artifact.retained);
+    if (retained.length > 0) {
+        lines.push("retained:");
+        for (const item of retained) {
+            const objectName = readString(item.objectName) ?? "object";
+            const selector = readString(item.selector) ?? "member";
+            const issues = readObjectArray(item.issues);
+            const reason = readString(issues[0]?.message) ?? readString(issues[0]?.code) ?? "unsupported";
+            lines.push(`${objectName}.${selector}: ${reason}`);
+        }
+    }
+    const notRun = readObjectArray(artifact.notRun);
+    if (notRun.length > 0) {
+        lines.push("notRun:");
+        for (const item of notRun) {
+            const objectName = readString(item.objectName) ?? "object";
+            lines.push(`${objectName}: ${readStringArray(item.selectors).join(", ")}`);
+        }
+    }
+    const semanticFingerprint = readString(artifact.semanticFingerprint);
+    const edits = readObjectArray(artifact.edits);
+    const beforeHashes = readObjectArray(artifact.beforeHashes);
+    const cycleEvidence = isObject(artifact.cycleEvidence) ? artifact.cycleEvidence : undefined;
+    const diagnostics = isObject(artifact.diagnostics) ? artifact.diagnostics : undefined;
+    if (semanticFingerprint) {
+        lines.push("planner evidence:");
+        lines.push(`semantic fingerprint: ${semanticFingerprint}`);
+        lines.push(`exact edits: ${edits.length}; before hashes: ${beforeHashes.length}`);
+        const cycles = cycleEvidence ? readObjectArray(cycleEvidence.cycles).length : 0;
+        const addedDiagnostics = diagnostics ? readObjectArray(diagnostics.added).length : 0;
+        lines.push(`runtime cycles: ${cycles}; new diagnostics: ${addedDiagnostics}`);
+    }
+    return (0, agent_text_1.attachAgentText)(compactObject({
+        ok: true,
+        op: "view",
+        handle,
+        kind: "objectPack",
+        operation,
+        sourceFile,
+        packs,
+        importers,
+        unsupported,
+        retained,
+        notRun,
+        partial: artifact.partial === true,
+        requestedObjectCount: readNumber(artifact.requestedObjectCount),
+        requestedMemberCount: readNumber(artifact.requestedMemberCount),
+        retainedCount: readNumber(artifact.retainedCount),
+        ...(semanticFingerprint ? { semanticFingerprint } : {}),
+        edits,
+        beforeHashes,
+        ...(isObject(artifact.coverage) ? { coverage: artifact.coverage } : {}),
+        symbols: readObjectArray(artifact.symbols),
+        usages: readObjectArray(artifact.usages),
+        moduleEdges: readObjectArray(artifact.moduleEdges),
+        ...(cycleEvidence ? { cycleEvidence } : {}),
+        ...(diagnostics ? { diagnostics } : {})
+    }), lines.join("\n"));
+}
+function attachSemanticObjectView(cwd, response, result, executed = false) {
+    const saved = (0, session_workspace_1.saveSessionResultViewJson)(cwd, `res_${crypto.randomBytes(4).toString("hex")}`, {
+        kind: "objectPack",
+        operation: result.operation,
+        previewId: readString(response.previewId),
+        executed,
+        sourceFile: result.sourceFile,
+        packs: result.objects,
+        sourceEdits: result.objects,
+        importers: result.importers,
+        unsupported: result.unsupported,
+        partial: result.partial === true,
+        requestedObjectCount: result.requestedObjectCount,
+        requestedMemberCount: result.requestedMemberCount,
+        retainedCount: result.retainedCount,
+        retained: result.retained ?? [],
+        notRun: result.notRun ?? [],
+        filesTouched: result.filesTouched,
+        filesWritten: [],
+        semanticFingerprint: result.semanticFingerprint,
+        rowFingerprints: result.rowFingerprints,
+        edits: result.edits,
+        beforeHashes: result.beforeHashes,
+        coverage: result.coverage,
+        symbols: result.symbols,
+        usages: result.usages,
+        moduleEdges: result.moduleEdges,
+        cycleEvidence: result.cycleEvidence,
+        diagnostics: result.diagnostics
+    });
+    if (saved) {
+        response.view = saved.saved;
+    }
+}
+function normalizeObjectPackPayload(cwd, segment) {
+    const sourceFile = resolveFile(cwd, readString(segment.sourceFile) ?? "");
+    const packs = readObjectArray(segment.packs).map((pack) => ({
+        operation: readObjectOperation(pack.operation),
+        objectName: readRequiredIdentifier(pack.objectName, `${objectOperationName(readObjectOperation(pack.operation))} object name`),
+        selectors: readStringArray(pack.selectors),
+        exportMode: readExportMode(pack.exportMode),
+        usageMode: readUsageMode(pack.usageMode)
+    }));
+    const operations = uniqueStrings(packs.map((pack) => pack.operation));
+    const operation = (operations[0] ?? "pack");
+    const label = objectOperationName(operation);
+    if (operations.length > 1) {
+        throw new errors_1.CliError("OBJECT_PACK_MIXED_OPERATIONS_UNSUPPORTED", "object.pack and object.unpack cannot be mixed in one exports.object segment yet.", {
+            operations
+        });
+    }
+    if (!sourceFile || !fs.existsSync(sourceFile)) {
+        throw new errors_1.CliError("OBJECT_PACK_SOURCE_NOT_FOUND", `${label} source file not found: ${sourceFile || readString(segment.sourceFile) || ""}`);
+    }
+    if (packs.length === 0) {
+        throw new errors_1.CliError("OBJECT_PACK_ROWS_REQUIRED", `${label} expects at least one row.`);
+    }
+    for (const pack of packs) {
+        if (pack.selectors.length === 0) {
+            throw new errors_1.CliError("OBJECT_PACK_SELECTORS_REQUIRED", `${label} ${pack.objectName} expects at least one selector.`);
+        }
+    }
+    return { operation, sourceFile, packs };
+}
+function formatObjectPackAgentText(cwd, response, action) {
+    const lines = [];
+    const operation = readString(response.operation) ?? "exports.object.pack";
+    const objectOperation = objectOperationFromName(operation) ?? "pack";
+    const label = objectOperationName(objectOperation);
+    const previewId = readString(response.previewId);
+    lines.push(previewId && operation.endsWith(".preview") ? `${operation} ${previewId}` : operation);
+    if (response.ok === false) {
+        lines.push(`failed: ${readNumber(response.unsupportedCount) ?? 0} unsupported ${label} issue(s)`);
+    }
+    else {
+        const memberCount = readNumber(response.memberCount) ?? 0;
+        const retainedCount = readNumber(response.retainedCount) ?? 0;
+        const objectCount = readNumber(response.objectCount) ?? 0;
+        const importerCount = readNumber(response.importerCount) ?? 0;
+        const referenceCount = readNumber(response.referenceCount) ?? 0;
+        const members = formatCount(memberCount, "export");
+        const objects = formatCount(objectCount, "object");
+        const importers = formatCount(importerCount, "importer");
+        const references = formatCount(referenceCount, "reference");
+        if (action === "preview") {
+            const summary = objectOperation === "unpack"
+                ? `${members} will be unpacked from ${objects}; ${importers} will be updated; ${references}`
+                : `${members} will be packed into ${objects}; ${importers} will be updated; ${references}`;
+            lines.push(retainedCount > 0
+                ? `preview partial: ${summary}; ${formatCount(retainedCount, "member")} retained`
+                : `preview ok: ${summary}`);
+        }
+        else {
+            const summary = objectOperation === "unpack"
+                ? `${members} unpacked from ${objects}; ${importers} updated; ${references}`
+                : `${members} packed into ${objects}; ${importers} updated; ${references}`;
+            lines.push(retainedCount > 0
+                ? `completed partial: ${summary}; ${formatCount(retainedCount, "member")} retained`
+                : `completed: ${summary}`);
+        }
+    }
+    const sourceFile = readString(response.sourceFile);
+    if (sourceFile) {
+        lines.push(`source: ${sourceFile}`);
+    }
+    const objects = readObjectArray(response.objects);
+    if (objects.length > 0) {
+        lines.push("objects:");
+        for (const object of objects) {
+            const objectName = readString(object.objectName) ?? "object";
+            const selectors = readStringArray(object.selectors);
+            lines.push(`${objectName}: ${selectors.join(", ")}`);
+        }
+    }
+    const importers = readObjectArray(response.importers);
+    if (importers.length > 0) {
+        lines.push("imports:");
+        for (const importer of importers.slice(0, 8)) {
+            const file = readString(importer.file) ?? "";
+            const objectNames = readStringArray(importer.objectNames);
+            const objectName = objectNames.length > 0 ? objectNames.join(", ") : readString(importer.objectName) ?? "object";
+            const selectors = readStringArray(importer.selectors);
+            const refs = readNumber(importer.referenceCount) ?? 0;
+            lines.push(`${file}: ${objectName} for ${selectors.join(", ")}; ${formatCount(refs, "reference")}`);
+        }
+        if (importers.length > 8) {
+            lines.push(`+${importers.length - 8} more importers`);
+        }
+    }
+    const unsupported = readObjectArray(response.unsupported);
+    if (unsupported.length > 0) {
+        lines.push("unsupported:");
+        for (const item of unsupported.slice(0, 12)) {
+            const selector = readString(item.selector);
+            const objectName = readString(item.objectName);
+            const file = readString(item.file);
+            const message = readString(item.message) ?? readString(item.code) ?? "unsupported";
+            lines.push(`${selector ?? objectName ?? label}: ${message}${file ? ` (${file})` : ""}`);
+            const candidates = readStringArray(item.candidates);
+            if (candidates.length > 0) {
+                lines.push(`  candidates: ${candidates.join(", ")}`);
+            }
+        }
+        if (unsupported.length > 12) {
+            lines.push(`+${unsupported.length - 12} more unsupported issues`);
+        }
+    }
+    const retained = readObjectArray(response.retained);
+    if (retained.length > 0) {
+        lines.push("retained:");
+        for (const item of retained.slice(0, 12)) {
+            const objectName = readString(item.objectName) ?? "object";
+            const selector = readString(item.selector) ?? "member";
+            const issues = readObjectArray(item.issues);
+            const reason = readString(issues[0]?.message) ?? readString(issues[0]?.code) ?? "unsupported";
+            lines.push(`${objectName}.${selector}: ${reason}`);
+        }
+    }
+    const notRun = readObjectArray(response.notRun);
+    if (notRun.length > 0) {
+        lines.push("notRun:");
+        for (const item of notRun.slice(0, 12)) {
+            lines.push(`${readString(item.objectName) ?? "object"}: ${readStringArray(item.selectors).join(", ")}`);
+        }
+    }
+    const files = readStringArray(action === "preview" ? response.filesTouched : response.filesWritten);
+    if (files.length > 0) {
+        lines.push(action === "preview" ? "files:" : "filesWritten:");
+        lines.push(...files.slice(0, 10));
+        if (files.length > 10) {
+            lines.push(`+${files.length - 10} more files`);
+        }
+    }
+    const view = readString(response.view);
+    if (view) {
+        lines.push(`view: ${view}`);
+    }
+    const next = readString(response.next);
+    if (next) {
+        lines.push(`next: ${next}`);
+    }
+    return lines.join("\n");
+}
+function normalizedPayloadForCache(normalized) {
+    return {
+        operation: normalized.operation,
+        sourceFile: normalized.sourceFile,
+        packs: normalized.packs
+    };
+}
+function readObjectOperation(value) {
+    const operation = readString(value) ?? "pack";
+    if (operation !== "pack" && operation !== "unpack") {
+        throw new errors_1.CliError("OBJECT_PACK_OPERATION_UNSUPPORTED", `exports.object supports operation=pack or operation=unpack.`, { operation });
+    }
+    return operation;
+}
+function objectOperationFromName(value) {
+    if (value.includes(".unpack.")) {
+        return "unpack";
+    }
+    if (value.includes(".pack.")) {
+        return "pack";
+    }
+    return null;
+}
+function objectOperationName(operation) {
+    return `object.${operation}`;
+}
+function readExportMode(value) {
+    const mode = readString(value) ?? "replace";
+    if (mode !== "replace") {
+        throw new errors_1.CliError("OBJECT_PACK_EXPORT_MODE_UNSUPPORTED", `object.pack supports export=replace only for now.`, { mode });
+    }
+    return "replace";
+}
+function readUsageMode(value) {
+    const mode = readString(value) ?? "property";
+    if (mode !== "property") {
+        throw new errors_1.CliError("OBJECT_PACK_USAGE_MODE_UNSUPPORTED", `object.pack supports usage=property only for now.`, { mode });
+    }
+    return "property";
+}
+function readRequiredIdentifier(value, label) {
+    const text = readString(value);
+    if (!text || !/^[A-Za-z_$][\w$]*$/.test(text)) {
+        throw new errors_1.CliError("OBJECT_PACK_INVALID_IDENTIFIER", `${label} expects a valid identifier.`, { value: text ?? String(value) });
+    }
+    return text;
+}
+function resolveFile(cwd, value) {
+    return path.normalize(path.isAbsolute(value) ? value : path.resolve(cwd, value));
+}
+function formatPath(cwd, value) {
+    if (!value) {
+        return value;
+    }
+    const relative = path.relative(cwd, value);
+    return relative && !relative.startsWith("..") && !path.isAbsolute(relative)
+        ? relative.replace(/\\/g, "/")
+        : value.replace(/\\/g, "/");
+}
+function uniqueStrings(values) {
+    return [...new Set(values.filter(Boolean))];
+}
+function compactObject(input) {
+    return Object.fromEntries(Object.entries(input).filter(([, value]) => {
+        if (value === null || value === undefined) {
+            return false;
+        }
+        if (Array.isArray(value) && value.length === 0) {
+            return false;
+        }
+        if (isObject(value) && Object.keys(value).length === 0) {
+            return false;
+        }
+        return true;
+    }));
+}
+function readString(value) {
+    return typeof value === "string" && value.trim() !== "" ? value.trim() : null;
+}
+function readNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function formatCount(count, singular) {
+    return `${count} ${count === 1 ? singular : `${singular}s`}`;
+}
+function readStringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.trim() !== "") : [];
+}
+function readObjectArray(value) {
+    return Array.isArray(value) ? value.filter(isObject) : [];
+}
+function isObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function replaceFirstLine(text, firstLine) {
+    const newline = text.indexOf("\n");
+    return newline < 0 ? firstLine : `${firstLine}${text.slice(newline)}`;
+}

package/dist/commands/object-pack-preview-cache.js

@@ -0,0 +1,88 @@
+"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.buildObjectPackPreviewId = buildObjectPackPreviewId;
+exports.buildObjectPackPreviewHash = buildObjectPackPreviewHash;
+exports.readObjectPackPreviewRecord = readObjectPackPreviewRecord;
+exports.writeObjectPackPreviewRecord = writeObjectPackPreviewRecord;
+const crypto = __importStar(require("node:crypto"));
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const errors_1 = require("../shared/errors");
+const workspace_cache_1 = require("./workspace-cache");
+function buildObjectPackPreviewId(normalizedPayload, fileHashes) {
+    return `object_pack_${sha256(stableStringify({ normalizedPayload, fileHashes })).slice(0, 10)}`;
+}
+function buildObjectPackPreviewHash(normalizedPayload, fileHashes, response) {
+    return `sha256:${sha256(stableStringify({ normalizedPayload, fileHashes, response }))}`;
+}
+function readObjectPackPreviewRecord(cwd, previewId) {
+    const filePath = objectPackPreviewRecordPath(cwd, previewId);
+    if (!fs.existsSync(filePath)) {
+        throw new errors_1.CliError("OBJECT_PACK_PREVIEW_NOT_FOUND", `Object pack preview not found: ${previewId}`, {
+            previewId,
+            expectedPath: filePath
+        });
+    }
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+function writeObjectPackPreviewRecord(cwd, record) {
+    const filePath = objectPackPreviewRecordPath(cwd, record.previewId);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const tmpPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+    fs.writeFileSync(tmpPath, `${JSON.stringify(record, null, 2)}\n`);
+    fs.renameSync(tmpPath, filePath);
+}
+function objectPackPreviewRecordPath(cwd, previewId) {
+    return (0, workspace_cache_1.workspaceCachePath)(cwd, "object-pack-previews", `${sanitizeId(previewId)}.json`);
+}
+function sha256(value) {
+    return crypto.createHash("sha256").update(value).digest("hex");
+}
+function stableStringify(value) {
+    if (value === null || typeof value !== "object") {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+    }
+    return `{${Object.entries(value)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, item]) => `${JSON.stringify(key)}:${stableStringify(item)}`)
+        .join(",")}}`;
+}
+function sanitizeId(value) {
+    return value.replace(/[^a-z0-9_-]+/gi, "-");
+}