@automaton-labs/aib 0.0.7 → 0.0.8

package/dist/commands/declaration-execution-cache.js

@@ -1 +1,79 @@
-"use strict";var o=exports&&exports.__createBinding||(Object.create?(function(e,t,u,n){n===void 0&&(n=u);var r=Object.getOwnPropertyDescriptor(t,u);(!r||("get"in r?!t.__esModule:r.writable||r.configurable))&&(r={enumerable:!0,get:function(){return t[u]}}),Object.defineProperty(e,n,r)}):(function(e,t,u,n){n===void 0&&(n=u),e[n]=t[u]})),c=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),l=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(u){var n=[];for(var r in u)Object.prototype.hasOwnProperty.call(u,r)&&(n[n.length]=r);return n},e(t)};return function(t){if(t&&t.__esModule)return t;var u={};if(t!=null)for(var n=e(t),r=0;r<n.length;r++)n[r]!=="default"&&o(u,t,n[r]);return c(u,t),u}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.buildDeclarationExecutionId=f,exports.createDeclarationExecutionStatus=_,exports.readDeclarationExecutionStatus=E,exports.tryReadDeclarationExecutionStatus=D,exports.writeDeclarationExecutionStatus=O;const s=l(require("node:path")),d=require("../config/product-storage"),a=require("./mutation-execution-cache");function f(){return(0,a.buildMutationExecutionId)()}function _(e,t,u,n){const r=new Date().toISOString();return{executionId:t,operation:u,cwd:s.resolve(e),status:"running",phase:"running",startedAt:r,updatedAt:r,rowCount:Math.max(1,n),completedRows:0,failedRows:0,notRunRows:0,filesWritten:[],rows:[],productStorageDir:(0,d.productStorageRoot)()}}function E(e,t){return(0,a.readMutationExecutionStatus)(e,t,i)}function D(e,t){return(0,a.tryReadMutationExecutionStatus)(e,t,i)}function O(e,t){(0,a.writeMutationExecutionStatus)(e,t,i)}const i={namespace:"declaration-executions",notFoundCode:"DECLARATION_EXECUTION_NOT_FOUND",notFoundLabel:"declaration"};
+"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.buildDeclarationExecutionId = buildDeclarationExecutionId;
+exports.createDeclarationExecutionStatus = createDeclarationExecutionStatus;
+exports.readDeclarationExecutionStatus = readDeclarationExecutionStatus;
+exports.tryReadDeclarationExecutionStatus = tryReadDeclarationExecutionStatus;
+exports.writeDeclarationExecutionStatus = writeDeclarationExecutionStatus;
+const path = __importStar(require("node:path"));
+const product_storage_1 = require("../config/product-storage");
+const mutation_execution_cache_1 = require("./mutation-execution-cache");
+function buildDeclarationExecutionId() {
+    return (0, mutation_execution_cache_1.buildMutationExecutionId)();
+}
+function createDeclarationExecutionStatus(cwd, executionId, operation, rowCount) {
+    const now = new Date().toISOString();
+    return {
+        executionId,
+        operation,
+        cwd: path.resolve(cwd),
+        status: "running",
+        phase: "running",
+        startedAt: now,
+        updatedAt: now,
+        rowCount: Math.max(1, rowCount),
+        completedRows: 0,
+        failedRows: 0,
+        notRunRows: 0,
+        filesWritten: [],
+        rows: [],
+        productStorageDir: (0, product_storage_1.productStorageRoot)()
+    };
+}
+function readDeclarationExecutionStatus(cwd, executionId) {
+    return (0, mutation_execution_cache_1.readMutationExecutionStatus)(cwd, executionId, DECLARATION_EXECUTION_CACHE);
+}
+function tryReadDeclarationExecutionStatus(cwd, executionId) {
+    return (0, mutation_execution_cache_1.tryReadMutationExecutionStatus)(cwd, executionId, DECLARATION_EXECUTION_CACHE);
+}
+function writeDeclarationExecutionStatus(cwd, status) {
+    (0, mutation_execution_cache_1.writeMutationExecutionStatus)(cwd, status, DECLARATION_EXECUTION_CACHE);
+}
+const DECLARATION_EXECUTION_CACHE = {
+    namespace: "declaration-executions",
+    notFoundCode: "DECLARATION_EXECUTION_NOT_FOUND",
+    notFoundLabel: "declaration"
+};

package/dist/commands/declaration-format.js

@@ -1 +1,221 @@
-"use strict";var v=exports&&exports.__createBinding||(Object.create?(function(e,t,o,r){r===void 0&&(r=o);var n=Object.getOwnPropertyDescriptor(t,o);(!n||("get"in n?!t.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return t[o]}}),Object.defineProperty(e,r,n)}):(function(e,t,o,r){r===void 0&&(r=o),e[r]=t[o]})),A=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),O=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(o){var r=[];for(var n in o)Object.prototype.hasOwnProperty.call(o,n)&&(r[r.length]=n);return r},e(t)};return function(t){if(t&&t.__esModule)return t;var o={};if(t!=null)for(var r=e(t),n=0;n<r.length;n++)r[n]!=="default"&&v(o,t,r[n]);return A(o,t),o}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.formatDeclarationMutationDetails=S;const p=O(require("node:path")),M=require("./session-workspace");function S(e,t,o){return t==="addMissing"?$(e,o):j(e,o)}function j(e,t){const o=m(e),r=new Map;for(const s of t){const l=u(s.file);if(!l)continue;const c=b(s.removed).map(i=>u(i.selector)).filter(i=>!!i);if(c.length===0)continue;const f=g(c).join(" ");r.set(f,[...r.get(f)??[],d(e,l,o)])}const n=D(r);return n.push(..._(e,t,o)),n.length>0?n:["removed: none"]}function $(e,t){const o=m(e),r=new Map;for(const s of t){const l=u(s.file);if(!l)continue;const c=new Map;for(const f of b(s.addedImports))for(const i of I(f)){const a=u(i.selector);if(!a)continue;const h=u(i.source)??u(i.moduleSpecifier)??"unknown";c.set(h,[...c.get(h)??[],a])}for(const[f,i]of c.entries()){const a=r.get(f)??new Map,h=g(i).join(" ");a.set(h,[...a.get(h)??[],d(e,l,o)]),r.set(f,a)}}const n=[];for(const[s,l]of r.entries()){n.length>0&&n.push(""),n.push(`from ${d(e,s,o)}:`);for(const[c,f]of l.entries()){n.push(`  ${c}:`);for(const i of g(f))n.push(`    ${i}`)}}return n.push(..._(e,t,o)),n.length>0?n:["added: none"]}function D(e){const t=[];for(const[o,r]of e.entries()){t.push(`${o}:`);for(const n of g(r))t.push(`  ${n}`)}return t}function _(e,t,o){const r=t.filter(s=>s.ok===!1);if(r.length===0)return[];const n=["failed:"];for(const s of r){const l=u(s.file),c=u(s.failedSelector)??w(s.selectors);l&&n.push(`  ${d(e,l,o)}`),c&&u(s.code)==="DECLARATION_REMOVE_AMBIGUOUS"?n.push(`  \`${c}\` is ambiguous.`):c&&n.push(`  ${c}`);const f=Array.isArray(s.availableSelectors)?s.availableSelectors.filter(i=>typeof i=="string"&&i.trim()!==""):[];if(f.length>0){n.push("  Available selectors:");for(const i of f)n.push(`  ${i}`)}else{const i=u(s.code);i&&n.push(`  code: ${i}`);const a=u(s.error);a&&n.push(`  ${a}`)}}return n}function I(e){const t=b(e.items);return t.length>0?t:[e]}function b(e){return Array.isArray(e)?e.filter(E):[]}function w(e){return Array.isArray(e)?e.find(t=>typeof t=="string"&&t.trim()!=="")??null:null}function g(e){return[...new Set(e.filter(t=>t.trim()!==""))]}function m(e){try{return(0,M.readEffectiveSessionPathAliases)(e)}catch{return{}}}function d(e,t,o){if(!p.isAbsolute(t))return y(t);const r=P(e,t,o);if(r)return r;const n=p.relative(e,t);return n&&!n.startsWith("..")&&!p.isAbsolute(n)?y(n):y(t)}function P(e,t,o){let r=null;for(const[n,s]of Object.entries(o)){const l=p.resolve(e,s);if(!B(t,l))continue;const c=p.relative(l,t),f=c?`@${n}/${y(c)}`:`@${n}`;(!r||f.length<r.display.length||f.length===r.display.length&&l.length>r.target.length)&&(r={name:n,target:l,display:f})}return r?r.display:null}function B(e,t){const o=p.relative(t,e);return o===""||!o.startsWith("..")&&!p.isAbsolute(o)}function u(e){return typeof e=="string"&&e.trim()!==""?e.trim():null}function E(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}function y(e){return e.replace(/\\/g,"/")}
+"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.formatDeclarationMutationDetails = formatDeclarationMutationDetails;
+const path = __importStar(require("node:path"));
+const session_workspace_1 = require("./session-workspace");
+function formatDeclarationMutationDetails(cwd, operation, rows) {
+    return operation === "addMissing"
+        ? formatAddMissingDetails(cwd, rows)
+        : formatRemoveDetails(cwd, rows);
+}
+function formatRemoveDetails(cwd, rows) {
+    const aliases = safeAliases(cwd);
+    const groups = new Map();
+    for (const row of rows) {
+        const file = readString(row.file);
+        if (!file) {
+            continue;
+        }
+        const selectors = collectObjects(row.removed)
+            .map((item) => readString(item.selector))
+            .filter((selector) => Boolean(selector));
+        if (selectors.length === 0) {
+            continue;
+        }
+        const key = uniqueInOrder(selectors).join(" ");
+        groups.set(key, [...(groups.get(key) ?? []), formatDisplayPath(cwd, file, aliases)]);
+    }
+    const lines = renderSelectorFileGroups(groups);
+    lines.push(...formatFailedRows(cwd, rows, aliases));
+    return lines.length > 0 ? lines : ["removed: none"];
+}
+function formatAddMissingDetails(cwd, rows) {
+    const aliases = safeAliases(cwd);
+    const bySource = new Map();
+    for (const row of rows) {
+        const file = readString(row.file);
+        if (!file) {
+            continue;
+        }
+        const bySourceForFile = new Map();
+        for (const group of collectObjects(row.addedImports)) {
+            for (const item of collectImportItems(group)) {
+                const selector = readString(item.selector);
+                if (!selector) {
+                    continue;
+                }
+                const source = readString(item.source) ?? readString(item.moduleSpecifier) ?? "unknown";
+                bySourceForFile.set(source, [...(bySourceForFile.get(source) ?? []), selector]);
+            }
+        }
+        for (const [source, selectors] of bySourceForFile.entries()) {
+            const sourceGroups = bySource.get(source) ?? new Map();
+            const key = uniqueInOrder(selectors).join(" ");
+            sourceGroups.set(key, [...(sourceGroups.get(key) ?? []), formatDisplayPath(cwd, file, aliases)]);
+            bySource.set(source, sourceGroups);
+        }
+    }
+    const lines = [];
+    for (const [source, groups] of bySource.entries()) {
+        if (lines.length > 0) {
+            lines.push("");
+        }
+        lines.push(`from ${formatDisplayPath(cwd, source, aliases)}:`);
+        for (const [selectorKey, files] of groups.entries()) {
+            lines.push(`  ${selectorKey}:`);
+            for (const file of uniqueInOrder(files)) {
+                lines.push(`    ${file}`);
+            }
+        }
+    }
+    lines.push(...formatFailedRows(cwd, rows, aliases));
+    return lines.length > 0 ? lines : ["added: none"];
+}
+function renderSelectorFileGroups(groups) {
+    const lines = [];
+    for (const [selectorKey, files] of groups.entries()) {
+        lines.push(`${selectorKey}:`);
+        for (const file of uniqueInOrder(files)) {
+            lines.push(`  ${file}`);
+        }
+    }
+    return lines;
+}
+function formatFailedRows(cwd, rows, aliases) {
+    const failed = rows.filter((row) => row.ok === false);
+    if (failed.length === 0) {
+        return [];
+    }
+    const lines = ["failed:"];
+    for (const row of failed) {
+        const file = readString(row.file);
+        const selector = readString(row.failedSelector) ?? firstString(row.selectors);
+        if (file) {
+            lines.push(`  ${formatDisplayPath(cwd, file, aliases)}`);
+        }
+        if (selector && readString(row.code) === "DECLARATION_REMOVE_AMBIGUOUS") {
+            lines.push(`  \`${selector}\` is ambiguous.`);
+        }
+        else if (selector) {
+            lines.push(`  ${selector}`);
+        }
+        const available = Array.isArray(row.availableSelectors)
+            ? row.availableSelectors.filter((item) => typeof item === "string" && item.trim() !== "")
+            : [];
+        if (available.length > 0) {
+            lines.push("  Available selectors:");
+            for (const item of available) {
+                lines.push(`  ${item}`);
+            }
+        }
+        else {
+            const code = readString(row.code);
+            if (code) {
+                lines.push(`  code: ${code}`);
+            }
+            const error = readString(row.error);
+            if (error) {
+                lines.push(`  ${error}`);
+            }
+        }
+    }
+    return lines;
+}
+function collectImportItems(group) {
+    const nested = collectObjects(group.items);
+    return nested.length > 0 ? nested : [group];
+}
+function collectObjects(value) {
+    return Array.isArray(value) ? value.filter(isObject) : [];
+}
+function firstString(value) {
+    return Array.isArray(value) ? value.find((item) => typeof item === "string" && item.trim() !== "") ?? null : null;
+}
+function uniqueInOrder(values) {
+    return [...new Set(values.filter((value) => value.trim() !== ""))];
+}
+function safeAliases(cwd) {
+    try {
+        return (0, session_workspace_1.readEffectiveSessionPathAliases)(cwd);
+    }
+    catch {
+        return {};
+    }
+}
+function formatDisplayPath(cwd, filePath, aliases) {
+    if (!path.isAbsolute(filePath)) {
+        return toSlash(filePath);
+    }
+    const aliased = formatAliasPath(cwd, filePath, aliases);
+    if (aliased) {
+        return aliased;
+    }
+    const relative = path.relative(cwd, filePath);
+    return relative && !relative.startsWith("..") && !path.isAbsolute(relative)
+        ? toSlash(relative)
+        : toSlash(filePath);
+}
+function formatAliasPath(cwd, filePath, aliases) {
+    let best = null;
+    for (const [name, targetPath] of Object.entries(aliases)) {
+        const target = path.resolve(cwd, targetPath);
+        if (!isPathInside(filePath, target)) {
+            continue;
+        }
+        const suffix = path.relative(target, filePath);
+        const display = suffix ? `@${name}/${toSlash(suffix)}` : `@${name}`;
+        if (!best || display.length < best.display.length || (display.length === best.display.length && target.length > best.target.length)) {
+            best = { name, target, display };
+        }
+    }
+    if (!best) {
+        return null;
+    }
+    return best.display;
+}
+function isPathInside(filePath, parentPath) {
+    const relative = path.relative(parentPath, filePath);
+    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+function readString(value) {
+    return typeof value === "string" && value.trim() !== "" ? value.trim() : null;
+}
+function isObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function toSlash(value) {
+    return value.replace(/\\/g, "/");
+}

package/dist/commands/declaration-preview-cache.js

@@ -1,2 +1,114 @@
-"use strict";var d=exports&&exports.__createBinding||(Object.create?(function(r,e,t,i){i===void 0&&(i=t);var n=Object.getOwnPropertyDescriptor(e,t);(!n||("get"in n?!e.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return e[t]}}),Object.defineProperty(r,i,n)}):(function(r,e,t,i){i===void 0&&(i=t),r[i]=e[t]})),h=exports&&exports.__setModuleDefault||(Object.create?(function(r,e){Object.defineProperty(r,"default",{enumerable:!0,value:e})}):function(r,e){r.default=e}),o=exports&&exports.__importStar||(function(){var r=function(e){return r=Object.getOwnPropertyNames||function(t){var i=[];for(var n in t)Object.prototype.hasOwnProperty.call(t,n)&&(i[i.length]=n);return i},r(e)};return function(e){if(e&&e.__esModule)return e;var t={};if(e!=null)for(var i=r(e),n=0;n<i.length;n++)i[n]!=="default"&&d(t,e,i[n]);return h(t,e),t}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.buildDeclarationPreviewId=y,exports.buildDeclarationPreviewHash=v,exports.readDeclarationPreviewRecord=P,exports.writeDeclarationPreviewRecord=O,exports.hashFiles=b,exports.validateDeclarationPreviewFiles=D;const w=o(require("node:crypto")),a=o(require("node:fs")),_=o(require("node:path")),s=require("../shared/errors"),p=require("./workspace-cache");function y(r){return`apply_${u(c(r)).slice(0,6)}`}function v(r,e,t){return`sha256:${u(c({normalizedPayload:r,fileHashes:e,summary:t.summary,operation:t.operation}))}`}function P(r,e){const t=l(r,e);if(!a.existsSync(t))throw new s.CliError("DECLARATION_PREVIEW_NOT_FOUND",`Declaration preview not found: ${e}`,{previewId:e,expectedPath:t});return JSON.parse(a.readFileSync(t,"utf8"))}function O(r,e){const t=l(r,e.previewId);a.mkdirSync(_.dirname(t),{recursive:!0}),a.writeFileSync(t,`${JSON.stringify(e,null,2)}
-`)}function b(r){const e={};for(const t of r)e[t]=f(t);return e}function D(r){for(const[e,t]of Object.entries(r.fileHashes))if(f(e)!==t)throw new s.CliError("DECLARATION_PREVIEW_FILES_CHANGED","Files changed after declaration preview. Rerun preview.",{previewId:r.previewId,file:e})}function l(r,e){return(0,p.workspaceCachePath)(r,"declaration-previews",`${g(e)}.json`)}function f(r){return a.existsSync(r)?u(a.readFileSync(r)):null}function u(r){return w.createHash("sha256").update(r).digest("hex")}function c(r){return r===null||typeof r!="object"?JSON.stringify(r):Array.isArray(r)?`[${r.map(e=>c(e)).join(",")}]`:`{${Object.entries(r).sort(([e],[t])=>e.localeCompare(t)).map(([e,t])=>`${JSON.stringify(e)}:${c(t)}`).join(",")}}`}function g(r){return r.replace(/[^a-z0-9_-]+/gi,"-")}
+"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.buildDeclarationPreviewId = buildDeclarationPreviewId;
+exports.buildDeclarationPreviewHash = buildDeclarationPreviewHash;
+exports.readDeclarationPreviewRecord = readDeclarationPreviewRecord;
+exports.writeDeclarationPreviewRecord = writeDeclarationPreviewRecord;
+exports.hashFiles = hashFiles;
+exports.validateDeclarationPreviewFiles = validateDeclarationPreviewFiles;
+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 buildDeclarationPreviewId(normalizedPayload) {
+    return `apply_${sha256(stableStringify(normalizedPayload)).slice(0, 6)}`;
+}
+function buildDeclarationPreviewHash(normalizedPayload, fileHashes, previewResult) {
+    return `sha256:${sha256(stableStringify({
+        normalizedPayload,
+        fileHashes,
+        summary: previewResult.summary,
+        operation: previewResult.operation
+    }))}`;
+}
+function readDeclarationPreviewRecord(cwd, previewId) {
+    const filePath = declarationPreviewRecordPath(cwd, previewId);
+    if (!fs.existsSync(filePath)) {
+        throw new errors_1.CliError("DECLARATION_PREVIEW_NOT_FOUND", `Declaration preview not found: ${previewId}`, {
+            previewId,
+            expectedPath: filePath
+        });
+    }
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+function writeDeclarationPreviewRecord(cwd, record) {
+    const filePath = declarationPreviewRecordPath(cwd, record.previewId);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, `${JSON.stringify(record, null, 2)}\n`);
+}
+function hashFiles(files) {
+    const hashes = {};
+    for (const file of files) {
+        hashes[file] = hashFileIfExists(file);
+    }
+    return hashes;
+}
+function validateDeclarationPreviewFiles(record) {
+    for (const [file, expectedHash] of Object.entries(record.fileHashes)) {
+        const actualHash = hashFileIfExists(file);
+        if (actualHash !== expectedHash) {
+            throw new errors_1.CliError("DECLARATION_PREVIEW_FILES_CHANGED", "Files changed after declaration preview. Rerun preview.", {
+                previewId: record.previewId,
+                file
+            });
+        }
+    }
+}
+function declarationPreviewRecordPath(cwd, previewId) {
+    return (0, workspace_cache_1.workspaceCachePath)(cwd, "declaration-previews", `${sanitizeId(previewId)}.json`);
+}
+function hashFileIfExists(filePath) {
+    return fs.existsSync(filePath) ? sha256(fs.readFileSync(filePath)) : null;
+}
+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, "-");
+}

package/dist/commands/diagnostics-command.js

@@ -1,3 +1,70 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.runDiagnosticsCommand=m;const a=require("../shared/errors");async function m(t){const o=t[0]??"status";if(o!=="timeout-stream")throw new a.CliError("UNKNOWN_DIAGNOSTICS_COMMAND",`Unknown diagnostics command: ${o}`,{availableCommands:["timeout-stream"]});await l(t.slice(1))}async function l(t){const o=w(t),e=u(t,"--delay-ms",6e4),s=u(t,"--interval-ms",1e3),n=Math.max(1,Math.min(10,Math.floor(e/Math.max(1,s))));f(),r(o,`diagnostics.timeout-stream started mode=${o} delayMs=${e}`);for(let i=1;i<=n;i+=1)await d(s),r(o,`diagnostics.timeout-stream tick ${i}/${n}`);const c=e-n*s;c>0&&await d(c),r(o,"diagnostics.timeout-stream completed")}function f(){const t=o=>{if(o.code!=="EPIPE")throw o};process.stdout.on("error",t),process.stderr.on("error",t)}function r(t,o){(t==="stdout"||t==="both")&&process.stdout.write(`${o}
-`),(t==="stderr"||t==="both")&&process.stderr.write(`${o}
-`),t==="console"&&(console.log(o),console.error(o))}function w(t){const o=t.indexOf("--mode"),e=o>=0?t[o+1]:"stderr";if(e==="stdout"||e==="stderr"||e==="both"||e==="console")return e;throw new a.CliError("INVALID_DIAGNOSTICS_MODE","diagnostics timeout-stream --mode expects stdout, stderr, both, or console.")}function u(t,o,e){const s=t.indexOf(o);if(s<0)return e;const n=Number(t[s+1]);return Number.isFinite(n)&&n>=0?n:e}function d(t){return new Promise(o=>setTimeout(o,t))}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDiagnosticsCommand = runDiagnosticsCommand;
+const errors_1 = require("../shared/errors");
+async function runDiagnosticsCommand(restArgs) {
+    const subcommand = restArgs[0] ?? "status";
+    if (subcommand !== "timeout-stream") {
+        throw new errors_1.CliError("UNKNOWN_DIAGNOSTICS_COMMAND", `Unknown diagnostics command: ${subcommand}`, {
+            availableCommands: ["timeout-stream"]
+        });
+    }
+    await runTimeoutStream(restArgs.slice(1));
+}
+async function runTimeoutStream(args) {
+    const mode = readMode(args);
+    const delayMs = readNumberFlag(args, "--delay-ms", 60_000);
+    const intervalMs = readNumberFlag(args, "--interval-ms", 1_000);
+    const ticks = Math.max(1, Math.min(10, Math.floor(delayMs / Math.max(1, intervalMs))));
+    ignoreBrokenPipeDuringTimeoutDiagnostics();
+    writeDiagnosticLine(mode, `diagnostics.timeout-stream started mode=${mode} delayMs=${delayMs}`);
+    for (let index = 1; index <= ticks; index += 1) {
+        await sleep(intervalMs);
+        writeDiagnosticLine(mode, `diagnostics.timeout-stream tick ${index}/${ticks}`);
+    }
+    const remainingMs = delayMs - (ticks * intervalMs);
+    if (remainingMs > 0) {
+        await sleep(remainingMs);
+    }
+    writeDiagnosticLine(mode, "diagnostics.timeout-stream completed");
+}
+function ignoreBrokenPipeDuringTimeoutDiagnostics() {
+    const ignore = (error) => {
+        if (error.code !== "EPIPE") {
+            throw error;
+        }
+    };
+    process.stdout.on("error", ignore);
+    process.stderr.on("error", ignore);
+}
+function writeDiagnosticLine(mode, line) {
+    if (mode === "stdout" || mode === "both") {
+        process.stdout.write(`${line}\n`);
+    }
+    if (mode === "stderr" || mode === "both") {
+        process.stderr.write(`${line}\n`);
+    }
+    if (mode === "console") {
+        console.log(line);
+        console.error(line);
+    }
+}
+function readMode(args) {
+    const index = args.indexOf("--mode");
+    const value = index >= 0 ? args[index + 1] : "stderr";
+    if (value === "stdout" || value === "stderr" || value === "both" || value === "console") {
+        return value;
+    }
+    throw new errors_1.CliError("INVALID_DIAGNOSTICS_MODE", "diagnostics timeout-stream --mode expects stdout, stderr, both, or console.");
+}
+function readNumberFlag(args, flag, fallback) {
+    const index = args.indexOf(flag);
+    if (index < 0) {
+        return fallback;
+    }
+    const value = Number(args[index + 1]);
+    return Number.isFinite(value) && value >= 0 ? value : fallback;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}