@automaton-labs/aib 0.0.7 → 0.0.8

package/dist/commands/doctor.js

@@ -1,3 +1,137 @@
-"use strict";var O=exports&&exports.__createBinding||(Object.create?(function(e,t,n,r){r===void 0&&(r=n);var o=Object.getOwnPropertyDescriptor(t,n);(!o||("get"in o?!t.__esModule:o.writable||o.configurable))&&(o={enumerable:!0,get:function(){return t[n]}}),Object.defineProperty(e,r,o)}):(function(e,t,n,r){r===void 0&&(r=n),e[r]=t[n]})),j=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),P=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(n){var r=[];for(var o in n)Object.prototype.hasOwnProperty.call(n,o)&&(r[r.length]=o);return r},e(t)};return function(t){if(t&&t.__esModule)return t;var n={};if(t!=null)for(var r=e(t),o=0;o<r.length;o++)r[o]!=="default"&&O(n,t,r[o]);return j(n,t),n}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.runDoctor=H;const i=P(require("node:fs")),a=P(require("node:path")),A=require("node:crypto"),w=require("node:child_process"),d=require("../config/env-vars"),_=require("../shared/diagnostic-catalog"),l=require("../shared/hints"),M=require("../managed-host/extension-vsix-resolver"),x=require("../managed-host/serve-web-autostart"),L=require("./ping"),V=require("../shared/agent-text"),D=require("../shared/errors"),R=require("../diagnostics/readiness-text"),C=require("../runtime/bundled-node"),v=require("../runtime/managed-runtime-provisioning"),q=["code.cmd","code.exe","code"],T=["code"];function f(e,t){return e.ok||!t?e:{...e,code:t.code,...t.hints&&t.hints.length>0?{hints:t.hints}:{}}}async function H(e){const t=[],n=a.resolve(__dirname,"..",".."),r=ae(),o=e.runtime===!0,s=K(e.progress===!0);if(o){s("checking runtime files");const c=(0,v.isManagedRuntimeComplete)(n);s(c?"runtime files: ok":"provisioning runtime"),(0,v.ensureManagedRuntimeProvisioned)(n),c||s((0,v.isManagedRuntimeComplete)(n)?"runtime ready":"runtime files: missing")}t.push(p(s,"node version",Z)),t.push(p(s,"package layout",()=>Q(n))),t.push(p(s,"managed host assets",()=>Y(n,r))),t.push(p(s,"extension VSIX",()=>ee(n,r))),t.push(p(s,"bundled node",()=>ne(n))),t.push(p(s,"code-server",()=>te(n))),t.push(p(s,"browser",()=>oe(n))),t.push(p(s,"platform",()=>ie(o))),o&&t.every(c=>c.severity!=="required"||c.ok)&&t.push(...await F(n,e.cwd,s));const u=t.filter(c=>c.severity==="required"&&!c.ok),g=t.filter(c=>c.severity==="optional"&&!c.ok),m={ok:u.length===0,command:"doctor",mode:o?"runtime-install-gate":"static",cwd:a.resolve(e.cwd),generatedAt:new Date().toISOString(),platform:{node:process.version,platform:process.platform,arch:process.arch},packageRoot:n,repoRoot:r,summary:{checkCount:t.length,passedCount:t.filter(c=>c.ok).length,failedRequiredCount:u.length,failedOptionalCount:g.length},checks:t};return e.progress===!0&&(u.length===0?(s("all checks passed"),s("you are good to go 👍")):s("checks failed")),e.json===!0?m:(0,V.attachAgentText)(m,(0,R.formatDoctorText)(m,{verbose:e.verbose===!0}))}function K(e){return e?t=>{process.stderr.write(`${t}
-`)}:()=>{}}function p(e,t,n){e(`checking ${t}`);const r=n();return e(`${t}: ${r.ok?"ok":"failed"}`),r}async function B(e,t){const n=[];let r=!1;try{t("starting managed runtime; please wait");const o=await(0,x.startManagedServeWebForCwd)(e);r=!0,t("managed runtime: started"),n.push({id:"managed-runtime-start",ok:!0,severity:"required",message:"Managed IDE runtime starts and activates the bridge.",details:J(o)})}catch(o){return t("managed runtime: failed"),n.push(S("managed-runtime-start","Managed IDE runtime failed to start or activate the bridge.",o)),n}try{t("pinging runtime");const o=await(0,L.runPing)(e);t("runtime ping: ok"),n.push({id:"bridge-ping",ok:!0,severity:"required",message:"Bridge ping succeeds through the managed runtime.",details:z(o)})}catch(o){t("runtime ping: failed"),n.push(S("bridge-ping","Bridge ping failed through the managed runtime.",o))}if(r)try{t("stopping managed runtime");const o=await(0,x.stopManagedServeWebForCwd)(e);t(o.stopped===!0?"managed runtime: stopped":"managed runtime: stop incomplete"),n.push({id:"managed-runtime-stop",ok:o.stopped===!0,severity:"required",message:o.stopped===!0?"Managed IDE runtime stops cleanly.":"Managed IDE runtime stop did not report a stopped runtime.",details:o})}catch(o){t("managed runtime stop: failed"),n.push(S("managed-runtime-stop","Managed IDE runtime stop failed.",o))}return n}async function F(e,t,n){let r=null;try{return r=await W(e,t),r.waitedMs>500&&n(`managed runtime lock: waited ${r.waitedMs}ms`),await B(t,n)}catch(o){return[S("managed-runtime-lock","Managed IDE runtime lifecycle lock failed.",o)]}finally{r?.release()}}async function W(e,t,n=18e4,r=3e5){const o=a.join(e,".tmp","doctor-runtime-locks"),s=(0,A.createHash)("sha256").update(a.resolve(t)).digest("hex").slice(0,16),u=a.join(o,s),g=Date.now();for(i.mkdirSync(o,{recursive:!0});Date.now()-g<=n;)try{return i.mkdirSync(u),i.writeFileSync(a.join(u,"owner.json"),`${JSON.stringify({pid:process.pid,cwd:a.resolve(t),acquiredAt:new Date().toISOString()},null,2)}
-`,"utf8"),{waitedMs:Date.now()-g,release(){i.rmSync(u,{recursive:!0,force:!0})}}}catch(m){if(!U(m))throw m;if(X(u,r)){i.rmSync(u,{recursive:!0,force:!0});continue}await $(250)}throw new D.CliError("DOCTOR_RUNTIME_LOCK_TIMEOUT","Timed out waiting for managed runtime doctor lifecycle lock.",{lockDir:u,timeoutMs:n})}function X(e,t){try{const n=a.join(e,"owner.json"),r=i.existsSync(n)?JSON.parse(i.readFileSync(n,"utf8")):{},o=typeof r.pid=="number"?r.pid:null;return o!==null&&!G(o)?!0:Date.now()-i.statSync(e).mtimeMs>t}catch{return!0}}function G(e){try{return process.kill(e,0),!0}catch{return!1}}function U(e){return!!e&&typeof e=="object"&&e.code==="EEXIST"}function $(e){return new Promise(t=>setTimeout(t,e))}function S(e,t,n){const r=n instanceof D.CliError?n:null;return{id:e,ok:!1,severity:"required",message:t,code:r?.code??"DOCTOR_RUNTIME_CHECK_FAILED",details:{error:n instanceof Error?n.message:String(n),...r?.details&&typeof r.details=="object"&&!Array.isArray(r.details)?{details:r.details}:{}},hints:r?.details&&typeof r.details=="object"&&!Array.isArray(r.details)&&Array.isArray(r.details.hints)?r.details.hints:(0,_.buildAutoStartHints)()}}function J(e){const t=e.metadata&&typeof e.metadata=="object"&&!Array.isArray(e.metadata)?e.metadata:{},n=e.artifacts&&typeof e.artifacts=="object"&&!Array.isArray(e.artifacts)?e.artifacts:{};return{hostId:typeof e.hostId=="string"?e.hostId:null,hostKind:typeof e.hostKind=="string"?e.hostKind:t.hostKind??null,reused:e.reused===!0,codeCommand:typeof e.codeCommand=="string"?e.codeCommand:t.codeCommand??null,codeCommandSource:typeof e.codeCommandSource=="string"?e.codeCommandSource:t.codeCommandSource??null,runDir:typeof e.runDir=="string"?e.runDir:t.runDir??null,logsDir:typeof n.logsDir=="string"?n.logsDir:t.logsDir??null,instanceId:typeof t.instanceId=="string"?t.instanceId:null,serveWebPid:typeof t.serveWebPid=="number"?t.serveWebPid:null,browserPid:typeof t.browserPid=="number"?t.browserPid:null}}function z(e){const t=e.selectedInstance&&typeof e.selectedInstance=="object"&&!Array.isArray(e.selectedInstance)?e.selectedInstance:{},n=e.response&&typeof e.response=="object"&&!Array.isArray(e.response)?e.response:{};return{instanceId:typeof t.instanceId=="string"?t.instanceId:n.instanceId??null,reason:typeof t.reason=="string"?t.reason:null,matchedWorkspace:typeof t.matchedWorkspace=="string"?t.matchedWorkspace:null,pid:typeof n.pid=="number"?n.pid:null,protocolVersion:typeof n.protocolVersion=="number"?n.protocolVersion:null,extensionVersion:typeof n.extensionVersion=="string"?n.extensionVersion:null}}function Z(){const e=Number(process.versions.node.split(".")[0]??"0"),t=Number.isInteger(e)&&e>=20;return f({id:"node-version",ok:t,severity:"required",message:t?"Node.js version is supported.":"Node.js 20 or newer is required.",details:{node:process.version,required:">=20"}},{code:"DOCTOR_NODE_VERSION_UNSUPPORTED",hints:[(0,l.actionHint)("Install Node.js 20 or newer, then retry the CLI command.")]})}function Q(e){const t=a.join(e,"package.json"),n=a.join(e,"dist","bin","aib.js"),r=i.existsSync(t)&&i.existsSync(n);return f({id:"cli-package-root",ok:r,severity:"required",message:r?"CLI package root looks complete.":"CLI package root is missing package metadata or the built bin.",details:{packageRoot:e,packageJsonPath:t,packageJsonExists:i.existsSync(t),binPath:n,binExists:i.existsSync(n)}},{code:"DOCTOR_CLI_PACKAGE_INCOMPLETE",hints:[(0,l.commandHint)("npm run cli:build","Build the local CLI package."),(0,l.actionHint)("For an installed package, reinstall the CLI package.")]})}function Y(e,t){const n=a.join(e,"dist","managed-host","manage-serve-web-host.cjs"),r=t?a.join(t,"scripts","managed-host","manage-serve-web-host.cjs"):null,o=k(d.CLI_ENV.managedHostScript),s=!!(o&&i.existsSync(o)||i.existsSync(n)||r&&i.existsSync(r));return f({id:"managed-host-assets",ok:s,severity:"required",message:s?"Managed host assets are available.":"Managed host assets were not found.",details:{env:d.CLI_ENV.managedHostScript,envScriptPath:o,envScriptExists:o?i.existsSync(o):!1,packagedScriptPath:n,packagedScriptExists:i.existsSync(n),repoScriptPath:r,repoScriptExists:r?i.existsSync(r):!1}},{code:"DOCTOR_MANAGED_HOST_ASSETS_MISSING",hints:(0,_.buildAutoStartHints)()})}function ee(e,t){try{const n=(0,M.resolveExtensionVsixPath)({packageRoot:e,repoRoot:t}),r=i.existsSync(n.path);return f({id:"extension-vsix",ok:r,severity:"required",message:r?"Extension VSIX is available.":"Extension VSIX path resolved but the file does not exist.",details:{...n,exists:r}},{code:"DOCTOR_EXTENSION_VSIX_MISSING",hints:[(0,l.configHint)(d.CLI_ENV.extensionVsix,"Point to an existing packaged VSIX artifact."),(0,l.commandHint)("npm --prefix packages/extension run package:vsix","Build a local VSIX artifact.")]})}catch(n){return{id:"extension-vsix",ok:!1,severity:"required",message:"Extension VSIX resolution failed.",code:"DOCTOR_EXTENSION_VSIX_RESOLUTION_FAILED",details:{error:n instanceof Error?n.message:String(n),code:typeof n=="object"&&n!==null&&"code"in n?String(n.code):null},hints:(0,_.buildAutoStartHints)()}}}function te(e){const t=process.env[d.CLI_ENV.ideCommand]?.trim(),n=process.env[d.CLI_ENV.managedHostKind]?.trim()||re(e),r=k(d.CLI_ENV.codeServerPath),o=a.join(e,"runtimes","code-server","node_modules","code-server","out","node","entry.js"),s=(0,v.managedRuntimePlatformStatus)(e),u=(0,C.resolveNodeRuntime)(e),g=i.existsSync(o)&&s.ok?`${u.command} ${o}`:null,m=a.join(e,"runtimes","code-server","bin",process.platform==="win32"?"code-server.cmd":"code-server"),c=[r,g,m,"code-server"].filter(h=>!!h),E=t?[t]:n==="code-server"?c:process.platform==="win32"?q:T,y=E.map(h=>({candidate:h,result:h===g?{ok:!0,path:o}:I(h)})).find(h=>h.result.ok),b=!!y;return f({id:"ide-command",ok:b,severity:"required",message:b?"VS Code CLI command is available.":"VS Code CLI command was not found.",details:{env:d.CLI_ENV.ideCommand,codeServerEnv:d.CLI_ENV.codeServerPath,hostKindEnv:d.CLI_ENV.managedHostKind,hostKind:n,explicitIdeCommand:t||null,nodeRuntimeCommand:u.command,nodeRuntimeSource:u.source,platformMarker:{ok:s.ok,reason:s.reason,expectedPlatformKey:s.expectedPlatformKey,actualPlatformKey:s.actualPlatformKey,markerPath:s.markerPath},candidates:E,resolvedCommand:y?.candidate??null,resolvedPath:y?.result.path??null}},{code:"DOCTOR_IDE_COMMAND_MISSING",hints:[(0,l.configHint)(d.CLI_ENV.ideCommand,"Set an explicit VS Code-compatible CLI command path."),(0,l.configHint)(d.CLI_ENV.codeServerPath,"Set an explicit Coder code-server executable path when using the code-server managed host."),(0,l.actionHint)("Install VS Code, install Coder code-server, or include a packaged code-server runtime.")]})}function ne(e){const t=(0,C.findPackagedNodeRuntime)(e),n=(0,C.resolveNodeRuntime)(e),r=(0,v.managedRuntimePlatformStatus)(e),o=i.existsSync(a.join(e,"runtimes","code-server","node_modules","code-server","out","node","entry.js"))&&r.ok;return f({id:"managed-runtime-node",ok:!!t||!o,severity:o?"required":"optional",message:t?"Bundled Node runtime is available for managed runtime.":o?"Bundled Node runtime is missing for package-local code-server.":"Bundled Node runtime is not needed because package-local code-server is not present.",details:{env:d.CLI_ENV.nodePath,packagedNodePath:t,resolvedCommand:n.command,resolvedSource:n.source,packagedCodeServerPresent:o,platformMarker:{ok:r.ok,reason:r.reason,expectedPlatformKey:r.expectedPlatformKey,actualPlatformKey:r.actualPlatformKey,markerPath:r.markerPath}}},{code:"DOCTOR_MANAGED_RUNTIME_NODE_MISSING",hints:[(0,l.commandHint)("node scripts/runtime/provision-managed-runtimes.cjs --node","Provision the bundled Node runtime."),(0,l.actionHint)("For installed packages, reprovision or reinstall the managed runtime bundle.")]})}function re(e){const t=a.join(e,"runtimes","code-server","node_modules","code-server","out","node","entry.js");return i.existsSync(t)&&(0,v.managedRuntimePlatformStatus)(e).ok?"code-server":null}function oe(e){const t=k(d.CLI_ENV.chromePath),r=[t,se(e),"C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe","C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe","C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe","C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe","google-chrome","chromium","chromium-browser","microsoft-edge"].filter(s=>!!s).map(s=>({candidate:s,result:I(s)})).find(s=>s.result.ok),o=!!r;return f({id:"headless-browser",ok:o,severity:"required",message:o?"Headless browser command is available.":"Chrome or Edge was not found for managed serve-web activation.",details:{env:d.CLI_ENV.chromePath,explicitChromePath:t,resolvedCommand:r?.candidate??null}},{code:"DOCTOR_HEADLESS_BROWSER_MISSING",hints:[(0,l.configHint)(d.CLI_ENV.chromePath,"Set an explicit Chrome or Edge executable path."),(0,l.actionHint)("Install Chrome, Edge, Chromium, or another compatible headless browser.")]})}function se(e){const t=[a.join(e,"runtimes","browser"),a.join(e,"runtimes","chrome"),a.join(e,"runtimes","chromium")],n=process.platform==="win32"?new Set(["chrome.exe","chromium.exe","msedge.exe"]):new Set(["chrome","chromium"]);for(const r of t){const o=N(r,n,5);if(o)return o}return null}function N(e,t,n){if(!i.existsSync(e)||n<0)return null;let r;try{r=i.readdirSync(e,{withFileTypes:!0})}catch{return null}for(const o of r){const s=a.join(e,o.name);if(o.isFile()&&t.has(o.name)&&I(s).ok)return s}for(const o of r){if(!o.isDirectory())continue;const s=N(a.join(e,o.name),t,n-1);if(s)return s}return null}function ie(e){const t=process.platform==="win32"||process.platform==="linux";return f({id:"managed-runtime-platform",ok:t||e!==!0,severity:e?"required":"optional",message:t?"Managed serve-web auto-start is supported on this platform.":"Managed serve-web auto-start is currently supported on Windows and Linux.",details:{platform:process.platform,runtimeRequested:e}},{code:"DOCTOR_MANAGED_RUNTIME_PLATFORM_UNSUPPORTED",hints:[(0,l.actionHint)("Run static doctor checks only, or use a Windows/Linux environment for managed runtime.")]})}function ae(){const e=[a.resolve(__dirname),process.cwd()];for(const t of e){let n=t;for(;;){const r=a.join(n,"scripts","managed-host","manage-serve-web-host.cjs"),o=a.join(n,"package.json");if(i.existsSync(r)&&i.existsSync(o))return n;const s=a.dirname(n);if(s===n)break;n=s}}return null}function k(e){const t=process.env[e];return t&&t.trim()?a.resolve(t.trim()):null}function I(e){if(ce(e))return{ok:i.existsSync(e),status:i.existsSync(e)?0:1,error:null};const t=process.platform==="win32"?(0,w.spawnSync)("where.exe",[e],{encoding:"utf8",windowsHide:!0,stdio:["ignore","pipe","pipe"]}):(0,w.spawnSync)("sh",["-lc",`command -v "${e.replace(/"/g,'\\"')}"`],{encoding:"utf8",stdio:["ignore","pipe","pipe"]});return{ok:t.status===0,status:t.status,error:t.error?t.error.message:null}}function ce(e){return e.includes("\\")||e.includes("/")||/^[A-Za-z]:/.test(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.runDoctor = runDoctor;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const agent_text_1 = require("../shared/agent-text");
+const readiness_text_1 = require("../diagnostics/readiness-text");
+const bundled_node_1 = require("../runtime/bundled-node");
+async function runDoctor(options) {
+    const progress = options.progress === true
+        ? (line) => process.stderr.write(`${line}\n`)
+        : (_line) => { };
+    const packageRoot = path.resolve(__dirname, "..", "..");
+    const checks = [
+        runCheck(progress, "node version", checkNodeVersion),
+        runCheck(progress, "package layout", () => checkPackageRoot(packageRoot)),
+        runCheck(progress, "bundled node", () => checkBundledNode(packageRoot))
+    ];
+    const failedRequired = checks.filter((check) => check.severity === "required" && !check.ok);
+    const failedOptional = checks.filter((check) => check.severity === "optional" && !check.ok);
+    const response = {
+        ok: failedRequired.length === 0,
+        command: "doctor",
+        mode: "static",
+        cwd: path.resolve(options.cwd),
+        generatedAt: new Date().toISOString(),
+        platform: {
+            node: process.version,
+            platform: process.platform,
+            arch: process.arch
+        },
+        packageRoot,
+        summary: {
+            checkCount: checks.length,
+            passedCount: checks.filter((check) => check.ok).length,
+            failedRequiredCount: failedRequired.length,
+            failedOptionalCount: failedOptional.length
+        },
+        checks
+    };
+    if (options.progress === true) {
+        progress(failedRequired.length === 0 ? "all checks passed" : "checks failed");
+        if (failedRequired.length === 0) {
+            progress("you are good to go \u{1F44D}");
+        }
+    }
+    return options.json === true
+        ? response
+        : (0, agent_text_1.attachAgentText)(response, (0, readiness_text_1.formatDoctorText)(response, { verbose: options.verbose === true }));
+}
+function runCheck(progress, label, check) {
+    progress(`checking ${label}`);
+    const result = check();
+    progress(`${label}: ${result.ok ? "ok" : "failed"}`);
+    return result;
+}
+function checkNodeVersion() {
+    const major = Number(process.versions.node.split(".")[0] ?? "0");
+    const ok = Number.isInteger(major) && major >= 20;
+    return {
+        id: "node-version",
+        ok,
+        severity: "required",
+        message: ok ? "Node.js version is supported." : "Node.js 20 or newer is required.",
+        ...(ok ? {} : { code: "DOCTOR_NODE_VERSION_UNSUPPORTED" }),
+        details: { node: process.version, required: ">=20" }
+    };
+}
+function checkPackageRoot(packageRoot) {
+    const packageJsonPath = path.join(packageRoot, "package.json");
+    const binPath = path.join(packageRoot, "dist", "bin", "aib.js");
+    const ok = fs.existsSync(packageJsonPath) && fs.existsSync(binPath);
+    return {
+        id: "cli-package-root",
+        ok,
+        severity: "required",
+        message: ok ? "CLI package root looks complete." : "CLI package root is missing package metadata or the built bin.",
+        ...(ok ? {} : { code: "DOCTOR_CLI_PACKAGE_INCOMPLETE" }),
+        details: {
+            packageRoot,
+            packageJsonPath,
+            packageJsonExists: fs.existsSync(packageJsonPath),
+            binPath,
+            binExists: fs.existsSync(binPath)
+        }
+    };
+}
+function checkBundledNode(packageRoot) {
+    const packagedNodePath = (0, bundled_node_1.findPackagedNodeRuntime)(packageRoot);
+    const nodeRuntime = (0, bundled_node_1.resolveNodeRuntime)(packageRoot);
+    return {
+        id: "bundled-node",
+        ok: true,
+        severity: "optional",
+        message: packagedNodePath
+            ? "Bundled Node runtime is available."
+            : "Bundled Node runtime is absent; the current Node runtime will be used.",
+        details: {
+            packagedNodePath,
+            resolvedCommand: nodeRuntime.command,
+            resolvedSource: nodeRuntime.source
+        }
+    };
+}

package/dist/commands/execution-command.js

@@ -1 +1,117 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.runExecutionCommand=P;const E=require("./apply-module-plan"),m=require("./file-refactor-batch"),R=require("./file-refactor-batch-execution-cache"),o=require("./declaration-command"),p=require("./file-rename"),x=require("./file-rename-execution-cache"),C=require("./file-move-to-dir"),D=require("./file-move-to-dir-execution-cache"),N=require("./module-plan-cache"),A=require("./refactor-batch"),y=require("./refactor-batch-execution-cache"),B=require("./rename-entities"),F=require("./rename-execution-cache"),q=require("../shared/errors");function P(e,t){const[r="status",...a]=t;if(r==="status"){const u=b(a,"--execution")??U(a)??"last";return O(e,u)}throw new q.CliError("UNKNOWN_EXECUTION_COMMAND",`Unknown execution command: ${r}`,{availableCommands:["execution status"]})}function O(e,t){if(t==="last"){const i=M(e,"last"),c=(0,y.tryReadRefactorBatchExecutionStatus)(e,"last"),l=(0,F.tryReadRenameExecutionStatus)(e,"last"),s=(0,D.tryReadFileMoveToDirExecutionStatus)(e,"last"),d=(0,x.tryReadFileRenameExecutionStatus)(e,"last"),f=(0,R.tryReadFileRefactorBatchExecutionStatus)(e,"last"),_=(0,o.tryReadDeclarationExecutionStatus)(e,"last"),h=[i?{updatedAt:Date.parse(i.updatedAt),read:()=>(0,E.readCachedModulePlanExecution)(e,"last")}:null,c?{updatedAt:Date.parse(c.updatedAt),read:()=>(0,A.readCachedRefactorBatchExecution)(e,"last")}:null,l?{updatedAt:Date.parse(l.updatedAt),read:()=>(0,B.readCachedRenameExecution)(e,"last")}:null,s?{updatedAt:Date.parse(s.updatedAt),read:()=>(0,C.readCachedFileMoveToDirExecution)(e,"last")}:null,d?{updatedAt:Date.parse(d.updatedAt),read:()=>(0,p.readCachedFileRenameExecution)(e,"last")}:null,f?{updatedAt:Date.parse(f.updatedAt),read:()=>(0,m.readCachedFileRefactorBatchExecution)(e,"last")}:null,_?{updatedAt:Date.parse(_.updatedAt),read:()=>(0,o.readCachedDeclarationExecution)(e,"last")}:null].filter(n=>!!n);if(h.length>0){const n=h.sort((v,T)=>T.updatedAt-v.updatedAt)[0];if(n)return n.read()}S(t)}if((0,D.tryReadFileMoveToDirExecutionStatus)(e,t))return(0,C.readCachedFileMoveToDirExecution)(e,t);if((0,x.tryReadFileRenameExecutionStatus)(e,t))return(0,p.readCachedFileRenameExecution)(e,t);if((0,R.tryReadFileRefactorBatchExecutionStatus)(e,t))return(0,m.readCachedFileRefactorBatchExecution)(e,t);if((0,F.tryReadRenameExecutionStatus)(e,t))return(0,B.readCachedRenameExecution)(e,t);if((0,y.tryReadRefactorBatchExecutionStatus)(e,t))return(0,A.readCachedRefactorBatchExecution)(e,t);if(M(e,t))return(0,E.readCachedModulePlanExecution)(e,t);if((0,o.tryReadDeclarationExecutionStatus)(e,t))return(0,o.readCachedDeclarationExecution)(e,t);S(t)}function M(e,t){try{return(0,N.readModulePlanExecutionStatus)(e,t)}catch{return null}}function S(e){throw new q.CliError("EXECUTION_NOT_FOUND",`Execution status not found: ${e}`,{executionId:e})}function b(e,t){const r=e.indexOf(t);if(r<0)return null;const a=e[r+1];return a&&!a.startsWith("--")?a:null}function U(e){return e.find(t=>!t.startsWith("--"))??null}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runExecutionCommand = runExecutionCommand;
+const apply_module_plan_1 = require("./apply-module-plan");
+const file_refactor_batch_1 = require("./file-refactor-batch");
+const file_refactor_batch_execution_cache_1 = require("./file-refactor-batch-execution-cache");
+const declaration_command_1 = require("./declaration-command");
+const file_rename_1 = require("./file-rename");
+const file_rename_execution_cache_1 = require("./file-rename-execution-cache");
+const file_move_to_dir_1 = require("./file-move-to-dir");
+const file_move_to_dir_execution_cache_1 = require("./file-move-to-dir-execution-cache");
+const module_plan_cache_1 = require("./module-plan-cache");
+const refactor_batch_1 = require("./refactor-batch");
+const refactor_batch_execution_cache_1 = require("./refactor-batch-execution-cache");
+const mutate_execution_status_1 = require("./mutate-execution-status");
+const mutate_execution_cache_1 = require("./mutate-execution-cache");
+const rename_entities_1 = require("./rename-entities");
+const rename_execution_cache_1 = require("./rename-execution-cache");
+const errors_1 = require("../shared/errors");
+function runExecutionCommand(cwd, restArgs) {
+    const [action = "status", ...actionArgs] = restArgs;
+    if (action === "status") {
+        const executionId = readFlagValue(actionArgs, "--execution") ?? firstPositional(actionArgs) ?? "last";
+        return readCachedExecution(cwd, executionId);
+    }
+    throw new errors_1.CliError("UNKNOWN_EXECUTION_COMMAND", `Unknown execution command: ${action}`, {
+        availableCommands: [
+            "execution status"
+        ]
+    });
+}
+function readCachedExecution(cwd, executionId) {
+    if (executionId === "last") {
+        const mutate = (0, mutate_execution_cache_1.tryReadMutateExecutionStatus)(cwd, "last");
+        const modulePlan = tryReadModulePlanExecutionStatus(cwd, "last");
+        const refactorBatch = (0, refactor_batch_execution_cache_1.tryReadRefactorBatchExecutionStatus)(cwd, "last");
+        const rename = (0, rename_execution_cache_1.tryReadRenameExecutionStatus)(cwd, "last");
+        const fileMoveToDir = (0, file_move_to_dir_execution_cache_1.tryReadFileMoveToDirExecutionStatus)(cwd, "last");
+        const fileRename = (0, file_rename_execution_cache_1.tryReadFileRenameExecutionStatus)(cwd, "last");
+        const fileRefactorBatch = (0, file_refactor_batch_execution_cache_1.tryReadFileRefactorBatchExecutionStatus)(cwd, "last");
+        const declaration = (0, declaration_command_1.tryReadDeclarationExecutionStatus)(cwd, "last");
+        const candidates = [
+            mutate ? { updatedAt: Date.parse(mutate.updatedAt), read: () => (0, mutate_execution_status_1.readCachedMutateExecution)(cwd, "last", { includeOperationHeader: true }) } : null,
+            modulePlan ? { updatedAt: Date.parse(modulePlan.updatedAt), read: () => (0, apply_module_plan_1.readCachedModulePlanExecution)(cwd, "last") } : null,
+            refactorBatch ? { updatedAt: Date.parse(refactorBatch.updatedAt), read: () => (0, refactor_batch_1.readCachedRefactorBatchExecution)(cwd, "last") } : null,
+            rename ? { updatedAt: Date.parse(rename.updatedAt), read: () => (0, rename_entities_1.readCachedRenameExecution)(cwd, "last") } : null,
+            fileMoveToDir ? { updatedAt: Date.parse(fileMoveToDir.updatedAt), read: () => (0, file_move_to_dir_1.readCachedFileMoveToDirExecution)(cwd, "last") } : null,
+            fileRename ? { updatedAt: Date.parse(fileRename.updatedAt), read: () => (0, file_rename_1.readCachedFileRenameExecution)(cwd, "last") } : null,
+            fileRefactorBatch ? { updatedAt: Date.parse(fileRefactorBatch.updatedAt), read: () => (0, file_refactor_batch_1.readCachedFileRefactorBatchExecution)(cwd, "last") } : null,
+            declaration ? { updatedAt: Date.parse(declaration.updatedAt), read: () => (0, declaration_command_1.readCachedDeclarationExecution)(cwd, "last") } : null
+        ].filter((candidate) => Boolean(candidate));
+        if (candidates.length > 0) {
+            const latest = candidates.sort((left, right) => right.updatedAt - left.updatedAt)[0];
+            if (latest) {
+                return latest.read();
+            }
+        }
+        throwExecutionNotFound(executionId);
+    }
+    const mutate = (0, mutate_execution_cache_1.tryReadMutateExecutionStatus)(cwd, executionId);
+    if (mutate) {
+        return (0, mutate_execution_status_1.readCachedMutateExecution)(cwd, executionId);
+    }
+    const fileMoveToDir = (0, file_move_to_dir_execution_cache_1.tryReadFileMoveToDirExecutionStatus)(cwd, executionId);
+    if (fileMoveToDir) {
+        return (0, file_move_to_dir_1.readCachedFileMoveToDirExecution)(cwd, executionId);
+    }
+    const fileRename = (0, file_rename_execution_cache_1.tryReadFileRenameExecutionStatus)(cwd, executionId);
+    if (fileRename) {
+        return (0, file_rename_1.readCachedFileRenameExecution)(cwd, executionId);
+    }
+    const fileRefactorBatch = (0, file_refactor_batch_execution_cache_1.tryReadFileRefactorBatchExecutionStatus)(cwd, executionId);
+    if (fileRefactorBatch) {
+        return (0, file_refactor_batch_1.readCachedFileRefactorBatchExecution)(cwd, executionId);
+    }
+    const rename = (0, rename_execution_cache_1.tryReadRenameExecutionStatus)(cwd, executionId);
+    if (rename) {
+        return (0, rename_entities_1.readCachedRenameExecution)(cwd, executionId);
+    }
+    const refactorBatch = (0, refactor_batch_execution_cache_1.tryReadRefactorBatchExecutionStatus)(cwd, executionId);
+    if (refactorBatch) {
+        return (0, refactor_batch_1.readCachedRefactorBatchExecution)(cwd, executionId);
+    }
+    const modulePlan = tryReadModulePlanExecutionStatus(cwd, executionId);
+    if (modulePlan) {
+        return (0, apply_module_plan_1.readCachedModulePlanExecution)(cwd, executionId);
+    }
+    const declaration = (0, declaration_command_1.tryReadDeclarationExecutionStatus)(cwd, executionId);
+    if (declaration) {
+        return (0, declaration_command_1.readCachedDeclarationExecution)(cwd, executionId);
+    }
+    throwExecutionNotFound(executionId);
+}
+function tryReadModulePlanExecutionStatus(cwd, executionId) {
+    try {
+        return (0, module_plan_cache_1.readModulePlanExecutionStatus)(cwd, executionId);
+    }
+    catch {
+        return null;
+    }
+}
+function throwExecutionNotFound(executionId) {
+    throw new errors_1.CliError("EXECUTION_NOT_FOUND", `Execution status not found: ${executionId}`, {
+        executionId
+    });
+}
+function readFlagValue(args, flag) {
+    const index = args.indexOf(flag);
+    if (index < 0) {
+        return null;
+    }
+    const value = args[index + 1];
+    return value && !value.startsWith("--") ? value : null;
+}
+function firstPositional(args) {
+    return args.find((arg) => !arg.startsWith("--")) ?? null;
+}

package/dist/commands/exports-star-collapse-command.js

@@ -0,0 +1,178 @@
+"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.runExportsStarCollapseSegment = runExportsStarCollapseSegment;
+exports.runExportsStarCollapsePreviewBatch = runExportsStarCollapsePreviewBatch;
+exports.formatExportsStarCollapseBatchText = formatExportsStarCollapseBatchText;
+exports.formatExportsStarCollapseWriteText = formatExportsStarCollapseWriteText;
+exports.attachExportsStarCollapseWriteView = attachExportsStarCollapseWriteView;
+const crypto = __importStar(require("node:crypto"));
+const exports_star_collapse_preview_1 = require("../mutation/exports-star-collapse-preview");
+const agent_text_1 = require("../shared/agent-text");
+const session_workspace_1 = require("./session-workspace");
+const exports_star_expand_apply_1 = require("../mutation/exports-star-expand-apply");
+async function runExportsStarCollapseSegment(cwd, segment, action) {
+    if (action === "execute") {
+        const response = (0, exports_star_expand_apply_1.executeCurrentExportsStarCollapseBatch)(cwd, [intentFromSegment(segment)]);
+        const withView = attachExportsStarCollapseWriteView(cwd, response);
+        return (0, agent_text_1.attachAgentText)(withView, formatExportsStarCollapseWriteText("execute", withView));
+    }
+    return (await runExportsStarCollapsePreviewBatch(cwd, [segment]))[0];
+}
+async function runExportsStarCollapsePreviewBatch(cwd, segments, semanticContextPool, persistApplyPlan = false) {
+    const session = new exports_star_collapse_preview_1.ExportsStarCollapsePreviewSession(cwd, semanticContextPool);
+    try {
+        const results = segments.map((segment) => session.plan({
+            sourceFile: readString(segment.sourceFile) ?? "",
+            selectors: readStringArray(segment.selectors)
+        }));
+        const intents = segments.map(intentFromSegment);
+        const previewId = persistApplyPlan ? (0, exports_star_expand_apply_1.persistExportsStarCollapsePreview)(cwd, intents, results) : null;
+        const applyAvailable = Boolean(previewId);
+        const saved = (0, session_workspace_1.saveSessionResultViewJson)(cwd, `res_${crypto.randomBytes(4).toString("hex")}`, {
+            kind: "exportsStarCollapseBatch",
+            operation: "exports.star.collapse.preview",
+            applyAvailable,
+            ...(previewId ? { previewId } : {}),
+            barrelCount: results.length,
+            resources: session.resources,
+            barrels: results
+        });
+        return results.map((result) => {
+            const response = {
+                ...result,
+                applyAvailable,
+                ...(previewId ? { previewId, next: `aib mutate apply ${previewId}` } : {}),
+                ...(saved ? { view: saved.saved } : {})
+            };
+            return (0, agent_text_1.attachAgentText)(response, formatExportsStarCollapseAgentText(result, readString(response.view), previewId ?? undefined));
+        });
+    }
+    finally {
+        session.dispose();
+    }
+}
+function formatExportsStarCollapseBatchText(responses, action = "preview") {
+    const planned = responses.reduce((count, response) => count + (readNumber(response.plannedCount) ?? 0), 0);
+    const retained = responses.flatMap((response) => readObjectArray(response.retained));
+    const files = [...new Set(responses.flatMap((response) => readStringArray(response.filesTouched)))];
+    const view = responses.map((response) => readString(response.view)).find(Boolean);
+    const lines = [
+        `mutate.${action}${planned > 0 && retained.length > 0 ? " partial" : ""}: ${planned} ${noun(planned, "edge")} ${action === "preview" ? "planned" : "collapsed"} in ${files.length} ${noun(files.length, "file")}; ${retained.length} retained`
+    ];
+    if (files.length)
+        lines.push(`files: ${bounded(files, 4)}`);
+    appendRetained(lines, retained);
+    if (view)
+        lines.push(`view: ${view}`);
+    const previewId = responses.map((response) => readString(response.previewId)).find(Boolean);
+    lines.push(action === "preview" && previewId
+        ? `next: aib mutate apply ${previewId}`
+        : retained.length
+            ? "next: Review retained exports.star.collapse evidence and fix remaining edges manually or rerun with adjusted intent."
+            : action === "preview"
+                ? "next: Review retained exports.star.collapse evidence; no safe edits are available to apply."
+                : "next: Continue with the refactor or run focused checks.");
+    return lines.join("\n");
+}
+function formatExportsStarCollapseWriteText(action, response) {
+    if (response.ok === false) {
+        const code = readString(response.code) ?? "EXPORTS_STAR_COLLAPSE_FAILED";
+        const error = readString(response.error) ?? "exports.star.collapse could not be committed.";
+        const view = readString(response.view);
+        return [
+            `mutate.${action} failed`,
+            `${code}: ${error}`,
+            ...(view ? [`view: ${view}`] : []),
+            code.endsWith("ALREADY_APPLIED")
+                ? "next: Continue from the already-applied workspace state or run focused checks."
+                : "next: Rerun exports.star.collapse preview against the current workspace state."
+        ].join("\n");
+    }
+    return formatExportsStarCollapseBatchText([response], action);
+}
+function attachExportsStarCollapseWriteView(cwd, response) {
+    const saved = (0, session_workspace_1.saveSessionResultViewJson)(cwd, `res_${crypto.randomBytes(4).toString("hex")}`, {
+        kind: "exportsStarCollapseWrite",
+        ...response
+    });
+    return saved ? { ...response, view: saved.saved } : response;
+}
+function formatExportsStarCollapseAgentText(result, view, previewId) {
+    const lines = [
+        `exports.star.collapse preview${result.partial ? " partial" : ""}: ${result.plannedCount} ${noun(result.plannedCount, "edge")} planned in ${result.filesTouched.length} ${noun(result.filesTouched.length, "file")}; ${result.retainedCount} retained`
+    ];
+    if (result.filesTouched.length)
+        lines.push(`files: ${bounded(result.filesTouched, 4)}`);
+    appendRetained(lines, result.retained);
+    if (view)
+        lines.push(`view: ${view}`);
+    lines.push(`next: ${previewId ? `aib mutate apply ${previewId}` : result.next}`);
+    return lines.join("\n");
+}
+function intentFromSegment(segment) {
+    return { sourceFile: readString(segment.sourceFile) ?? "", selectors: readStringArray(segment.selectors) };
+}
+function appendRetained(lines, retained) {
+    if (!retained.length)
+        return;
+    lines.push("retained:");
+    for (const item of retained.slice(0, 4)) {
+        const selector = readString(item.selector) ?? "edge";
+        const reason = readString(item.reason) ?? readString(item.code) ?? "retained";
+        const candidates = readStringArray(item.candidates);
+        lines.push(`${selector}: ${reason}${candidates.length ? ` (${candidates.join(", ")})` : ""}`);
+    }
+    if (retained.length > 4)
+        lines.push(`+${retained.length - 4} retained`);
+}
+function readString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function readStringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.length > 0) : [];
+}
+function readObjectArray(value) {
+    return Array.isArray(value) ? value.filter((item) => Boolean(item) && typeof item === "object" && !Array.isArray(item)) : [];
+}
+function readNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function bounded(values, limit) {
+    return values.length <= limit ? values.join(", ") : `${values.slice(0, limit).join(", ")} +${values.length - limit}`;
+}
+function noun(count, word) {
+    return count === 1 ? word : `${word}s`;
+}