@automaton-labs/aib 0.0.6 → 0.0.8

package/dist/commands/internal-command.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInternalCommand = runInternalCommand;
+const agent_text_1 = require("../shared/agent-text");
+const errors_1 = require("../shared/errors");
+const inspect_topology_1 = require("./inspect-topology");
+const inspect_alias_candidates_1 = require("./inspect-alias-candidates");
+const mutate_response_replay_1 = require("./mutate-response-replay");
+function runInternalCommand(cwd, restArgs, rawPayload) {
+    const [action = "help"] = restArgs;
+    if (action === "help" || action === "--help") {
+        return internalHelp();
+    }
+    if (action !== "format-response") {
+        throw new errors_1.CliError("UNKNOWN_INTERNAL_COMMAND", `Unknown internal command: ${action}`, {
+            availableCommands: ["format-response"]
+        });
+    }
+    if (!isObject(rawPayload)) {
+        throw new errors_1.CliError("INTERNAL_FORMAT_RESPONSE_PAYLOAD_REQUIRED", "internal format-response expects a JSON payload.");
+    }
+    const text = formatResponseForReplay(cwd, rawPayload);
+    return text ? (0, agent_text_1.attachAgentText)(rawPayload, text) : rawPayload;
+}
+function formatResponseForReplay(cwd, payload) {
+    const operation = typeof payload.operation === "string" ? payload.operation : "";
+    if (operation.startsWith("mutate.") || operation === "execution.status") {
+        return (0, mutate_response_replay_1.formatMutateResponseForReplay)(cwd, payload);
+    }
+    if (operation === "inspect.boundaries") {
+        return (0, inspect_topology_1.formatTopologyBoundariesText)(payload, { timings: readTopologyTimingsFormatOption(payload) });
+    }
+    if (isAliasCandidatesPayload(payload)) {
+        return (0, inspect_alias_candidates_1.formatAliasCandidatesResponse)(payload);
+    }
+    return null;
+}
+function readTopologyTimingsFormatOption(payload) {
+    const options = payload.formatOptions;
+    return Boolean(options &&
+        typeof options === "object" &&
+        !Array.isArray(options) &&
+        options.timings === true);
+}
+function isAliasCandidatesPayload(payload) {
+    if (payload.op === "aliasCandidates" || payload.op === "alias-candidates") {
+        return true;
+    }
+    return Array.isArray(payload.results) && payload.results.every((item) => isObject(item) && (item.op === "aliasCandidates" || item.op === "alias-candidates"));
+}
+function internalHelp() {
+    return {
+        ok: true,
+        command: "internal",
+        usage: "aib internal format-response --stdin",
+        notes: [
+            "Formats saved canonical JSON payloads without rerunning the original command.",
+            "This command is for gallery/tooling replay, not agent-facing workflows."
+        ]
+    };
+}
+function isObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}

package/dist/commands/json-file-input.js

@@ -1 +1,60 @@
-"use strict";var l=exports&&exports.__createBinding||(Object.create?(function(i,e,t,r){r===void 0&&(r=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(i,r,n)}):(function(i,e,t,r){r===void 0&&(r=t),i[r]=e[t]})),f=exports&&exports.__setModuleDefault||(Object.create?(function(i,e){Object.defineProperty(i,"default",{enumerable:!0,value:e})}):function(i,e){i.default=e}),o=exports&&exports.__importStar||(function(){var i=function(e){return i=Object.getOwnPropertyNames||function(t){var r=[];for(var n in t)Object.prototype.hasOwnProperty.call(t,n)&&(r[r.length]=n);return r},i(e)};return function(e){if(e&&e.__esModule)return e;var t={};if(e!=null)for(var r=i(e),n=0;n<r.length;n++)r[n]!=="default"&&l(t,e,r[n]);return f(t,e),t}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.readJsonObjectFile=d;const _=o(require("node:fs")),c=o(require("node:path")),s=require("../shared/errors"),b=require("./session-workspace");function d(i,e,t){const r=(0,b.resolveSessionFileArgument)(i,e),n=c.isAbsolute(r)?r:c.resolve(i,r);let u;try{u=JSON.parse(_.readFileSync(n,"utf8"))}catch(a){throw new s.CliError(t,`Failed to read JSON file: ${e}`,{file:e,error:a instanceof Error?a.message:String(a)})}if(!u||typeof u!="object"||Array.isArray(u))throw new s.CliError(t,`JSON file must contain an object: ${e}`,{file:e});return u}
+"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.readJsonObjectFile = readJsonObjectFile;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const errors_1 = require("../shared/errors");
+const session_workspace_1 = require("./session-workspace");
+function readJsonObjectFile(cwd, filePath, errorCode) {
+    const resolvedFilePath = (0, session_workspace_1.resolveSessionFileArgument)(cwd, filePath);
+    const absolutePath = path.isAbsolute(resolvedFilePath) ? resolvedFilePath : path.resolve(cwd, resolvedFilePath);
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(absolutePath, "utf8"));
+    }
+    catch (error) {
+        throw new errors_1.CliError(errorCode, `Failed to read JSON file: ${filePath}`, {
+            file: filePath,
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new errors_1.CliError(errorCode, `JSON file must contain an object: ${filePath}`, {
+            file: filePath
+        });
+    }
+    return parsed;
+}

package/dist/commands/module-plan-cache.js

@@ -1,2 +1,156 @@
-"use strict";var y=exports&&exports.__createBinding||(Object.create?(function(e,t,n,r){r===void 0&&(r=n);var i=Object.getOwnPropertyDescriptor(t,n);(!i||("get"in i?!t.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return t[n]}}),Object.defineProperty(e,r,i)}):(function(e,t,n,r){r===void 0&&(r=n),e[r]=t[n]})),_=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),s=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(n){var r=[];for(var i in n)Object.prototype.hasOwnProperty.call(n,i)&&(r[r.length]=i);return r},e(t)};return function(t){if(t&&t.__esModule)return t;var n={};if(t!=null)for(var r=e(t),i=0;i<r.length;i++)r[i]!=="default"&&y(n,t,r[i]);return _(n,t),n}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.buildModulePlanId=M,exports.buildModulePlanHash=b,exports.normalizeModulePlanCacheRequest=E,exports.resolveModulePlanPreviewDir=O,exports.readModulePlanRecord=g,exports.writeModulePlanRecord=F,exports.modulePlanRecordPath=d,exports.buildModulePlanExecutionId=S,exports.readModulePlanExecutionStatus=x,exports.writeModulePlanExecutionStatus=j,exports.modulePlanExecutionPath=w,exports.modulePlanExecutionLastPath=C,exports.hashFile=v,exports.formatRelativePath=A,exports.resolveCliFilePath=h;const p=s(require("node:crypto")),o=s(require("node:fs")),a=s(require("node:path")),m=require("../shared/errors"),P=require("./workspace-cache"),u=require("./mutation-execution-cache");function M(e){return`plan_${f(l(e)).slice(0,10)}`}function b(e,t,n){return`sha256:${f(l({normalizedRequest:e,sourceHash:t,moduleCount:n.moduleCount,cycles:n.cycles??[]}))}`}function E(e){return{op:"modulePlan",...typeof e.sourceFile=="string"?{sourceFile:a.normalize(e.sourceFile)}:{},...typeof e.facadeFile=="string"?{facadeFile:a.normalize(e.facadeFile)}:{},...e.expectEmpty===!0?{expectEmpty:!0}:{},modules:Array.isArray(e.modules)?e.modules.filter(L).map(t=>({...typeof t.targetFile=="string"?{targetFile:a.normalize(t.targetFile)}:{},symbols:Array.isArray(t.symbols)?t.symbols:[]})):[]}}function O(e,t,n){return n?h(e,n):(0,P.workspaceCachePath)(e,"previews",t)}function g(e,t){const n=d(e,t);if(!o.existsSync(n))throw new m.CliError("APPLY_MODULE_PLAN_NOT_FOUND",`Module plan not found: ${t}`,{planId:t,expectedPath:n});return JSON.parse(o.readFileSync(n,"utf8"))}function F(e,t){const n=d(e,t.planId);o.mkdirSync(a.dirname(n),{recursive:!0}),o.writeFileSync(n,`${JSON.stringify(t,null,2)}
-`)}function d(e,t){return(0,P.workspaceCachePath)(e,"plans",`${N(t)}.json`)}function S(e){return(0,u.buildMutationExecutionId)()}function x(e,t){return(0,u.readMutationExecutionStatus)(e,t,c)}function j(e,t){(0,u.writeMutationExecutionStatus)(e,t,c)}function w(e,t,n){return(0,u.mutationExecutionPath)(e,c.namespace,t,n)}function C(e,t){return(0,u.mutationExecutionLastPath)(e,c.namespace,t)}function v(e){return f(o.readFileSync(e))}function A(e,t){return a.relative(e,t).replace(/\\/g,"/")}function h(e,t){return a.normalize(a.isAbsolute(t)?t:a.resolve(e,t))}function f(e){return p.createHash("sha256").update(e).digest("hex")}function l(e){return e===null||typeof e!="object"?JSON.stringify(e):Array.isArray(e)?`[${e.map(t=>l(t)).join(",")}]`:`{${Object.entries(e).sort(([t],[n])=>t.localeCompare(n)).map(([t,n])=>`${JSON.stringify(t)}:${l(n)}`).join(",")}}`}function N(e){return e.replace(/[^a-z0-9_-]+/gi,"-")}const c={namespace:"executions",notFoundCode:"MODULE_PLAN_EXECUTION_NOT_FOUND",notFoundLabel:"Module plan"};function L(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}
+"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.buildModulePlanId = buildModulePlanId;
+exports.buildModulePlanHash = buildModulePlanHash;
+exports.normalizeModulePlanCacheRequest = normalizeModulePlanCacheRequest;
+exports.resolveModulePlanPreviewDir = resolveModulePlanPreviewDir;
+exports.readModulePlanRecord = readModulePlanRecord;
+exports.writeModulePlanRecord = writeModulePlanRecord;
+exports.modulePlanRecordPath = modulePlanRecordPath;
+exports.buildModulePlanExecutionId = buildModulePlanExecutionId;
+exports.readModulePlanExecutionStatus = readModulePlanExecutionStatus;
+exports.writeModulePlanExecutionStatus = writeModulePlanExecutionStatus;
+exports.modulePlanExecutionPath = modulePlanExecutionPath;
+exports.modulePlanExecutionLastPath = modulePlanExecutionLastPath;
+exports.hashFile = hashFile;
+exports.formatRelativePath = formatRelativePath;
+exports.resolveCliFilePath = resolveCliFilePath;
+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");
+const mutation_execution_cache_1 = require("./mutation-execution-cache");
+function buildModulePlanId(normalizedRequest) {
+    return `plan_${sha256(stableStringify(normalizedRequest)).slice(0, 10)}`;
+}
+function buildModulePlanHash(normalizedRequest, sourceHash, previewResult) {
+    return `sha256:${sha256(stableStringify({
+        normalizedRequest,
+        sourceHash,
+        moduleCount: previewResult.moduleCount,
+        cycles: previewResult.cycles ?? []
+    }))}`;
+}
+function normalizeModulePlanCacheRequest(request) {
+    return {
+        op: "modulePlan",
+        ...(typeof request.sourceFile === "string" ? { sourceFile: path.normalize(request.sourceFile) } : {}),
+        ...(typeof request.facadeFile === "string" ? { facadeFile: path.normalize(request.facadeFile) } : {}),
+        ...(request.expectEmpty === true ? { expectEmpty: true } : {}),
+        modules: Array.isArray(request.modules)
+            ? request.modules
+                .filter(isJsonObject)
+                .map((module) => ({
+                ...(typeof module.targetFile === "string" ? { targetFile: path.normalize(module.targetFile) } : {}),
+                symbols: Array.isArray(module.symbols) ? module.symbols : []
+            }))
+            : []
+    };
+}
+function resolveModulePlanPreviewDir(cwd, planId, rawPreviewDir) {
+    return rawPreviewDir
+        ? resolveCliFilePath(cwd, rawPreviewDir)
+        : (0, workspace_cache_1.workspaceCachePath)(cwd, "previews", planId);
+}
+function readModulePlanRecord(cwd, planId) {
+    const filePath = modulePlanRecordPath(cwd, planId);
+    if (!fs.existsSync(filePath)) {
+        throw new errors_1.CliError("APPLY_MODULE_PLAN_NOT_FOUND", `Module plan not found: ${planId}`, {
+            planId,
+            expectedPath: filePath
+        });
+    }
+    return JSON.parse(fs.readFileSync(filePath, "utf8"));
+}
+function writeModulePlanRecord(cwd, record) {
+    const filePath = modulePlanRecordPath(cwd, record.planId);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, `${JSON.stringify(record, null, 2)}\n`);
+}
+function modulePlanRecordPath(cwd, planId) {
+    return (0, workspace_cache_1.workspaceCachePath)(cwd, "plans", `${sanitizePlanId(planId)}.json`);
+}
+function buildModulePlanExecutionId(_planId) {
+    return (0, mutation_execution_cache_1.buildMutationExecutionId)();
+}
+function readModulePlanExecutionStatus(cwd, executionId) {
+    return (0, mutation_execution_cache_1.readMutationExecutionStatus)(cwd, executionId, MODULE_PLAN_EXECUTION_CACHE);
+}
+function writeModulePlanExecutionStatus(cwd, status) {
+    (0, mutation_execution_cache_1.writeMutationExecutionStatus)(cwd, status, MODULE_PLAN_EXECUTION_CACHE);
+}
+function modulePlanExecutionPath(cwd, executionId, productStorageDir) {
+    return (0, mutation_execution_cache_1.mutationExecutionPath)(cwd, MODULE_PLAN_EXECUTION_CACHE.namespace, executionId, productStorageDir);
+}
+function modulePlanExecutionLastPath(cwd, productStorageDir) {
+    return (0, mutation_execution_cache_1.mutationExecutionLastPath)(cwd, MODULE_PLAN_EXECUTION_CACHE.namespace, productStorageDir);
+}
+function hashFile(filePath) {
+    return sha256(fs.readFileSync(filePath));
+}
+function formatRelativePath(cwd, filePath) {
+    return path.relative(cwd, filePath).replace(/\\/g, "/");
+}
+function resolveCliFilePath(cwd, filePath) {
+    return path.normalize(path.isAbsolute(filePath) ? filePath : path.resolve(cwd, filePath));
+}
+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 sanitizePlanId(planId) {
+    return planId.replace(/[^a-z0-9_-]+/gi, "-");
+}
+const MODULE_PLAN_EXECUTION_CACHE = {
+    namespace: "executions",
+    notFoundCode: "MODULE_PLAN_EXECUTION_NOT_FOUND",
+    notFoundLabel: "Module plan"
+};
+function isJsonObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}

package/dist/commands/module-plan-standalone.js

@@ -0,0 +1,208 @@
+"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.buildModulePlanMoveBatch = buildModulePlanMoveBatch;
+exports.summarizeModulePlanMoveBatch = summarizeModulePlanMoveBatch;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const refactor_batch_builder_1 = require("./refactor-batch-builder");
+const import_rules_1 = require("../config/import-rules");
+const mutation_comments_1 = require("../config/mutation-comments");
+function buildModulePlanMoveBatch(input) {
+    const sourceFile = readString(input.request.sourceFile) ?? "";
+    const requests = readModules(input.request).map((module, index) => ({
+        id: `module-${index + 1}`,
+        op: "move",
+        sourceFile,
+        targetFile: readString(module.targetFile) ?? "",
+        entities: readModuleSelectors(module),
+        execute: input.execute
+    }));
+    return (0, refactor_batch_builder_1.buildExtensionRefactorBatchPayload)({ requests }, input.config, {
+        cwd: input.cwd,
+        importRules: (0, import_rules_1.importRulesToJson)([...input.importRules]),
+        mutationComments: (0, mutation_comments_1.mutationCommentsPolicyToJson)(input.mutationComments)
+    });
+}
+function summarizeModulePlanMoveBatch(input) {
+    const engineRows = Array.isArray(input.response.rows) ? input.response.rows.filter(isObject) : [];
+    const rows = [];
+    const targets = [];
+    const blocking = [];
+    const filesWritten = [];
+    const declarationFailures = [];
+    const missingEntities = [];
+    let offset = 0;
+    for (const module of readModules(input.request)) {
+        const targetFile = readString(module.targetFile) ?? "";
+        const selectors = readModuleSelectors(module);
+        const routeRows = engineRows.slice(offset, offset + selectors.length);
+        offset += selectors.length;
+        const appliedEntities = selectors.filter((_, index) => routeRows[index]?.ok === true);
+        const manualExtractionRequired = routeRows.flatMap((row, index) => row.outcome === "manualExtractionRequired"
+            ? [{
+                    entity: selectors[index] ?? readRowEntity(row) ?? "unknown",
+                    code: readNestedCode(row) ?? "TS_MOVE_TO_FILE_UNSUPPORTED_BY_ENGINE",
+                    reason: readManualReason(row),
+                    retryable: false
+                }]
+            : []);
+        const providerLimitations = routeRows.flatMap((row, index) => readNestedCode(row) === "TS_MOVE_TO_FILE_UNSUPPORTED_BY_ENGINE"
+            ? [{
+                    entity: selectors[index] ?? readRowEntity(row) ?? "unknown",
+                    kind: "typescript-move-to-file-unsupported",
+                    code: "TS_MOVE_TO_FILE_UNSUPPORTED_BY_ENGINE",
+                    retryable: false,
+                    continueTail: true
+                }]
+            : []);
+        const skippedEntities = selectors.filter((_, index) => routeRows[index]?.skipped === true);
+        const notRunEntities = selectors.filter((_, index) => routeRows[index]?.attempted === false || routeRows[index]?.skipped === true);
+        const routeDeclarationFailures = routeRows.flatMap((row, index) => {
+            const code = readNestedCode(row);
+            if (!code || !isDeclarationLocalFailureCode(code))
+                return [];
+            const failure = {
+                entity: selectors[index] ?? readRowEntity(row) ?? "unknown",
+                source: relative(input.cwd, readString(input.request.sourceFile) ?? ""),
+                target: relative(input.cwd, targetFile),
+                phase: "planning",
+                code,
+                error: readNestedError(row) ?? readString(row.error) ?? "Move planning failed."
+            };
+            return [failure];
+        });
+        const failedEntities = routeDeclarationFailures.map((failure) => failure.entity);
+        const routeMissingEntities = routeDeclarationFailures
+            .filter((failure) => failure.code === "SEMANTIC_MOVE_ENTITY_NOT_FOUND")
+            .map((failure) => ({ entity: failure.entity, source: failure.source, target: failure.target }));
+        declarationFailures.push(...routeDeclarationFailures);
+        missingEntities.push(...routeMissingEntities);
+        const firstFailure = routeRows.find((row) => row.ok === false && row.skipped !== true) ?? routeRows.find((row) => row.skipped === true);
+        const routeFiles = uniqueStrings(routeRows.flatMap((row) => [
+            ...readStrings(row.savedFiles),
+            ...(isObject(row.response) ? readStrings(row.response.savedFiles) : [])
+        ]));
+        filesWritten.push(...routeFiles);
+        const complete = routeRows.length === selectors.length && routeRows.every((row) => row.ok === true);
+        const skipped = routeRows.length === selectors.length && routeRows.every((row) => row.skipped === true);
+        const summaryParts = [`${appliedEntities.length}/${selectors.length} ${input.execute ? "moved" : "ready"}`];
+        if (!fs.existsSync(targetFile))
+            summaryParts.push("target will be created");
+        if (manualExtractionRequired.length > 0)
+            summaryParts.push(`${manualExtractionRequired.length} manual`);
+        if (skippedEntities.length > 0)
+            summaryParts.push(`${skippedEntities.length} not run`);
+        const row = {
+            target: relative(input.cwd, targetFile),
+            entities: selectors,
+            ok: complete,
+            attempted: !skipped,
+            ...(skipped ? { skipped: true, outcome: "skipped" } : {}),
+            summary: summaryParts.join("; "),
+            appliedEntities,
+            ...(failedEntities.length > 0 ? { failedEntities } : {}),
+            notRunEntities,
+            ...(routeDeclarationFailures.length > 0 ? { declarationFailures: routeDeclarationFailures } : {}),
+            ...(routeMissingEntities.length > 0 ? { missingEntities: routeMissingEntities } : {}),
+            ...(routeFiles.length > 0 ? { filesWritten: routeFiles.map((file) => relative(input.cwd, file)) } : {}),
+            ...(manualExtractionRequired.length > 0 ? { manualExtractionRequired } : {}),
+            ...(providerLimitations.length > 0 ? { providerLimitations } : {}),
+            ...(firstFailure ? {
+                entity: selectors[routeRows.indexOf(firstFailure)] ?? readRowEntity(firstFailure),
+                code: readNestedCode(firstFailure) ?? (firstFailure.skipped === true ? "SEMANTIC_MOVE_NOT_ATTEMPTED" : "SEMANTIC_MOVE_FAILED"),
+                error: readNestedError(firstFailure) ?? readString(firstFailure.error) ?? "Move failed.",
+                source: relative(input.cwd, readString(input.request.sourceFile) ?? "")
+            } : {})
+        };
+        rows.push(row);
+        targets.push({ file: relative(input.cwd, targetFile), entities: selectors, summary: summaryParts.join("; ") });
+        if (!complete && skippedEntities.length < selectors.length)
+            blocking.push(row);
+    }
+    return {
+        rows,
+        targets,
+        blocking,
+        filesWritten: uniqueStrings(filesWritten),
+        declarationFailures,
+        missingEntities
+    };
+}
+function isDeclarationLocalFailureCode(code) {
+    return code === "SEMANTIC_MOVE_ENTITY_NOT_FOUND" || code === "SEMANTIC_MOVE_REQUIRED_EDGE_UNCHANGED";
+}
+function readModules(request) {
+    return Array.isArray(request.modules) ? request.modules.filter(isObject) : [];
+}
+function readModuleSelectors(module) {
+    return Array.isArray(module.symbols)
+        ? module.symbols.map((value) => {
+            if (typeof value === "string")
+                return value;
+            if (!isObject(value))
+                return null;
+            return readString(value.raw) ?? readString(value.selector) ?? readString(value.entity) ?? readString(value.symbolName);
+        }).filter((value) => Boolean(value))
+        : [];
+}
+function readRowEntity(row) {
+    return isObject(row.response) ? readString(row.response.symbolName) : null;
+}
+function readNestedCode(row) {
+    return isObject(row.response) ? readString(row.response.code) : null;
+}
+function readNestedError(row) {
+    return isObject(row.response) ? readString(row.response.error) : null;
+}
+function readManualReason(row) {
+    const code = readNestedCode(row);
+    return code === "TS_MOVE_TO_FILE_REFACTOR_FAILED" ? "changesOverlapAfterDeferredRetry" : "providerUnsupported";
+}
+function relative(cwd, file) {
+    return path.relative(cwd, file).replace(/\\/g, "/");
+}
+function readString(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+function readStrings(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function uniqueStrings(values) {
+    return [...new Set(values.map((value) => path.normalize(value)))];
+}
+function isObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}

package/dist/commands/module-plan-timeout.js

@@ -1 +1,77 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.estimateModulePlanDurationMs=r,exports.estimateModulePlanSuggestedFirstCheckMs=o,exports.estimateModulePlanTimeoutMs=i,exports.estimateModulePlanTimeoutFromRequest=a,exports.buildModulePlanTimeoutHintFromRequest=M,exports.formatModulePlanTimeoutEstimate=c;function r(t,e){return e<=16?s(5e3+e*900+t*800+12e3,8e3,6e4):s(14e3+e*1200+12e3,2e4,18e4)}function o(t){return t<=2e4?1e4:s(t*.35,15e3,3e4)}function i(t,e){const n=r(t,e);return s(n+3e4,3e4,24e4)}function a(t){if(!l(t))return null;const e=Array.isArray(t.modules)?t.modules.filter(l):[];if(e.length===0)return null;const n=e.reduce((m,d)=>m+f(d),0),u=r(e.length,n);return{recommendedTimeoutMs:i(e.length,n),estimatedDurationMs:u,suggestedFirstCheckMs:o(u),rowCount:e.length,symbolCount:n}}function M(t){const e=a(t);return e?{recommendedTimeoutMs:e.recommendedTimeoutMs,estimatedDurationMs:e.estimatedDurationMs,suggestedFirstCheckMs:e.suggestedFirstCheckMs,rowCount:e.rowCount,symbolCount:e.symbolCount,message:"If the calling agent times out, inspect progress with: aib execution status last"}:null}function c(t){const e=Math.max(1,Math.round(t/1e3));return e<90?`~${e} sec`:`~${Math.max(1,Math.round(e/60))} min`}function s(t,e,n){return Math.min(n,Math.max(e,Math.round(t)))}function f(t){return(Array.isArray(t.symbols)?t.symbols:Array.isArray(t.entities)?t.entities:[]).length}function l(t){return!!t&&typeof t=="object"&&!Array.isArray(t)}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.estimateModulePlanDurationMs = estimateModulePlanDurationMs;
+exports.estimateModulePlanSuggestedFirstCheckMs = estimateModulePlanSuggestedFirstCheckMs;
+exports.estimateModulePlanTimeoutMs = estimateModulePlanTimeoutMs;
+exports.estimateModulePlanTimeoutFromRequest = estimateModulePlanTimeoutFromRequest;
+exports.buildModulePlanTimeoutHintFromRequest = buildModulePlanTimeoutHintFromRequest;
+exports.formatModulePlanTimeoutEstimate = formatModulePlanTimeoutEstimate;
+function estimateModulePlanDurationMs(rowCount, symbolCount) {
+    if (symbolCount <= 16) {
+        return clampMs(10_000 + symbolCount * 1_800 + rowCount * 3_000, 12_000, 90_000);
+    }
+    return clampMs(18_000 + symbolCount * 1_800 + rowCount * 3_500, 45_000, 300_000);
+}
+function estimateModulePlanSuggestedFirstCheckMs(estimatedDurationMs) {
+    if (estimatedDurationMs <= 20_000) {
+        return 10_000;
+    }
+    return clampMs(estimatedDurationMs * 0.35, 15_000, 30_000);
+}
+function estimateModulePlanTimeoutMs(rowCount, symbolCount) {
+    const estimatedDurationMs = estimateModulePlanDurationMs(rowCount, symbolCount);
+    return clampMs(estimatedDurationMs + 30_000, 30_000, 420_000);
+}
+function estimateModulePlanTimeoutFromRequest(request) {
+    if (!isJsonObject(request)) {
+        return null;
+    }
+    const modules = Array.isArray(request.modules) ? request.modules.filter(isJsonObject) : [];
+    if (modules.length === 0) {
+        return null;
+    }
+    const symbolCount = modules.reduce((count, module) => count + readModuleEntityCount(module), 0);
+    const estimatedDurationMs = estimateModulePlanDurationMs(modules.length, symbolCount);
+    return {
+        recommendedTimeoutMs: estimateModulePlanTimeoutMs(modules.length, symbolCount),
+        estimatedDurationMs,
+        suggestedFirstCheckMs: estimateModulePlanSuggestedFirstCheckMs(estimatedDurationMs),
+        rowCount: modules.length,
+        symbolCount
+    };
+}
+function buildModulePlanTimeoutHintFromRequest(request) {
+    const estimate = estimateModulePlanTimeoutFromRequest(request);
+    if (!estimate) {
+        return null;
+    }
+    return {
+        recommendedTimeoutMs: estimate.recommendedTimeoutMs,
+        estimatedDurationMs: estimate.estimatedDurationMs,
+        suggestedFirstCheckMs: estimate.suggestedFirstCheckMs,
+        rowCount: estimate.rowCount,
+        symbolCount: estimate.symbolCount,
+        message: "If the calling agent times out, inspect progress with: aib execution status last"
+    };
+}
+function formatModulePlanTimeoutEstimate(estimateMs) {
+    const seconds = Math.max(1, Math.round(estimateMs / 1_000));
+    if (seconds < 90) {
+        return `~${seconds} sec`;
+    }
+    return `~${Math.max(1, Math.round(seconds / 60))} min`;
+}
+function clampMs(value, min, max) {
+    return Math.min(max, Math.max(min, Math.round(value)));
+}
+function readModuleEntityCount(module) {
+    const raw = Array.isArray(module.symbols)
+        ? module.symbols
+        : Array.isArray(module.entities)
+            ? module.entities
+            : [];
+    return raw.length;
+}
+function isJsonObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}