@automaton-labs/aib 0.0.7 → 0.0.8

package/dist/config/workspace-state.js

@@ -1 +1,254 @@
-"use strict";var E=exports&&exports.__createBinding||(Object.create?(function(e,t,r,o){o===void 0&&(o=r);var n=Object.getOwnPropertyDescriptor(t,r);(!n||("get"in n?!t.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,o,n)}):(function(e,t,r,o){o===void 0&&(o=r),e[o]=t[r]})),A=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),b=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(r){var o=[];for(var n in r)Object.prototype.hasOwnProperty.call(r,n)&&(o[o.length]=n);return o},e(t)};return function(t){if(t&&t.__esModule)return t;var r={};if(t!=null)for(var o=e(t),n=0;n<o.length;n++)o[n]!=="default"&&E(r,t,o[n]);return A(r,t),r}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.ensureWorkspaceState=j,exports.syncWorkspaceState=w,exports.workspaceStateStatus=L,exports.workspaceStateSummary=N,exports.formatWorkspaceStateSummary=T;const h=b(require("node:fs")),s=b(require("node:path")),k=require("./env-vars"),C=require("./import-rules"),v=require("./mutation-comments"),M=require("./path-aliases"),q=require("./tsconfig-discovery"),g=require("./workspace-root"),D=require("../shared/errors"),i=new Map,p=new Map;function j(e){const t=O(e),r=i.get(u(t.root));return r?_(r):R(t)}function w(e){const t=(0,g.resolveRequiredWorkspaceRoot)(e);return S(e,t),R(t)}function R(e){const t=s.resolve(e.root),r=u(t),o=i.get(r);try{const n=(0,M.normalizePathAliasMap)(e.config.pathAliases,"aib.json pathAliases"),m=(0,C.normalizeImportRules)(t,e.config.importRules),a=(0,v.normalizeMutationCommentsPolicy)(e.config.mutationComments),d=(0,q.discoverTsconfigFiles)(t),l=d.visible,f=process.env[k.CLI_ENV.disableWatchers]==="1",c={root:t,configPath:e.configPath,config:e.config,pathAliases:n,importRules:m,mutationComments:a,tsconfigs:l,excludedTsconfigCount:d.configExcluded.length,lastSyncAt:new Date().toISOString(),watchersStarted:o?.watchersStarted===!0&&o.watchersDisabled===f,watchersDisabled:f,watchers:o?.watchers??[]};return i.set(r,c),S(t,e),!f&&!c.watchersStarted&&F(c),f&&o&&o.watchers.length>0&&(W(o),c.watchers=[],c.watchersStarted=!1),_(c)}catch(n){throw o&&(o.lastError=P(n)),n}}function L(e){const t=O(e),r=i.get(u(t.root));return r?_(r):null}function N(e){const t=w(e);return T(t)}function T(e){return{root:e.root,config:e.configPath,aliases:e.pathAliases,importRules:(0,C.importRulesToJson)(e.importRules),mutationComments:(0,v.mutationCommentsPolicyToJson)(e.mutationComments),tsconfigCount:e.tsconfigs.length,excludedTsconfigCount:e.excludedTsconfigCount,watchers:e.watchersDisabled?"disabled":e.watchersStarted?"started":"not-started",lastSyncAt:e.lastSyncAt,...e.lastError?{lastError:e.lastError}:{}}}function F(e){W(e);const t=[e.configPath,...e.tsconfigs].filter(r=>h.existsSync(r));e.watchers=t.flatMap(r=>{try{return[h.watch(r,{persistent:!1},()=>I(e.root))]}catch{return[]}}),e.watchersStarted=e.watchers.length>0}function W(e){for(const t of e.watchers)try{t.close()}catch{}e.watchers=[],e.watchersStarted=!1,e.debounceTimer&&(clearTimeout(e.debounceTimer),delete e.debounceTimer)}function I(e){const t=i.get(u(e));t&&(t.debounceTimer&&clearTimeout(t.debounceTimer),t.debounceTimer=setTimeout(()=>{const r=i.get(u(e));if(r)try{w(e)}catch(o){r.lastError=P(o)}},100),t.debounceTimer.unref())}function O(e){const t=y(e),r=p.get(t);if(r&&!K(e,r.configPath))return r;const o=(0,g.resolveRequiredWorkspaceRoot)(e);return S(e,o),o}function K(e,t){const r=s.resolve(t).toLowerCase(),o=s.dirname(r);let n=s.resolve(e);const m=s.parse(n).root;for(;;){const a=s.join(n,g.AIB_CONFIG_FILE_NAME);if(h.existsSync(a)&&h.statSync(a).isFile())return s.resolve(a).toLowerCase()!==r;if(n.toLowerCase()===o||n===m)return!1;const l=s.dirname(n);if(l===n)return!1;n=l}}function S(e,t){p.set(y(e),t),p.set(y(t.root),t)}function u(e){return s.resolve(e).toLowerCase()}function y(e){return s.resolve(e).toLowerCase()}function _(e){return{root:e.root,configPath:e.configPath,config:e.config,pathAliases:e.pathAliases,importRules:[...e.importRules],mutationComments:{...e.mutationComments},tsconfigs:[...e.tsconfigs],excludedTsconfigCount:e.excludedTsconfigCount,lastSyncAt:e.lastSyncAt,watchersStarted:e.watchersStarted,watchersDisabled:e.watchersDisabled,...e.lastError?{lastError:e.lastError}:{}}}function P(e){return e instanceof D.CliError?{code:e.code,message:e.message,...e.details?{details:JSON.parse(JSON.stringify(e.details))}:{}}:{code:"SYNC_ERROR",message:e instanceof Error?e.message:String(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.ensureWorkspaceState = ensureWorkspaceState;
+exports.syncWorkspaceState = syncWorkspaceState;
+exports.workspaceStateStatus = workspaceStateStatus;
+exports.workspaceStateSummary = workspaceStateSummary;
+exports.formatWorkspaceStateSummary = formatWorkspaceStateSummary;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const env_vars_1 = require("./env-vars");
+const request_env_1 = require("./request-env");
+const import_rules_1 = require("./import-rules");
+const mutation_comments_1 = require("./mutation-comments");
+const path_aliases_1 = require("./path-aliases");
+const tsconfig_discovery_1 = require("./tsconfig-discovery");
+const workspace_root_1 = require("./workspace-root");
+const errors_1 = require("../shared/errors");
+const workspaceStates = new Map();
+const workspaceRootResolutions = new Map();
+function ensureWorkspaceState(cwd) {
+    const resolved = resolveCachedWorkspaceRoot(cwd);
+    const existing = workspaceStates.get(normalizeRootKey(resolved.root));
+    if (existing) {
+        return snapshot(existing);
+    }
+    return syncWorkspaceStateFromResolution(resolved);
+}
+function syncWorkspaceState(cwd) {
+    const resolved = (0, workspace_root_1.resolveRequiredWorkspaceRoot)(cwd);
+    rememberWorkspaceRoot(cwd, resolved);
+    return syncWorkspaceStateFromResolution(resolved);
+}
+function syncWorkspaceStateFromResolution(resolved) {
+    const root = path.resolve(resolved.root);
+    const rootKey = normalizeRootKey(root);
+    const previous = workspaceStates.get(rootKey);
+    try {
+        const pathAliases = (0, path_aliases_1.normalizePathAliasMap)(resolved.config.pathAliases, "aib.json pathAliases");
+        const importRules = (0, import_rules_1.normalizeImportRules)(root, resolved.config.importRules);
+        const mutationComments = (0, mutation_comments_1.normalizeMutationCommentsPolicy)(resolved.config.mutationComments);
+        const tsconfigDiscovery = (0, tsconfig_discovery_1.discoverTsconfigFiles)(root);
+        const tsconfigs = tsconfigDiscovery.visible;
+        const watchersDisabled = (0, request_env_1.readRequestEnv)(env_vars_1.CLI_ENV.disableWatchers) === "1";
+        const next = {
+            root,
+            configPath: resolved.configPath,
+            config: resolved.config,
+            pathAliases,
+            importRules,
+            mutationComments,
+            tsconfigs,
+            excludedTsconfigCount: tsconfigDiscovery.configExcluded.length,
+            lastSyncAt: new Date().toISOString(),
+            watchersStarted: previous?.watchersStarted === true && previous.watchersDisabled === watchersDisabled,
+            watchersDisabled,
+            watchers: previous?.watchers ?? []
+        };
+        workspaceStates.set(rootKey, next);
+        rememberWorkspaceRoot(root, resolved);
+        if (!watchersDisabled && !next.watchersStarted) {
+            startWorkspaceWatchers(next);
+        }
+        if (watchersDisabled && previous && previous.watchers.length > 0) {
+            closeWorkspaceWatchers(previous);
+            next.watchers = [];
+            next.watchersStarted = false;
+        }
+        return snapshot(next);
+    }
+    catch (error) {
+        if (previous) {
+            previous.lastError = errorToJson(error);
+        }
+        throw error;
+    }
+}
+function workspaceStateStatus(cwd) {
+    const resolved = resolveCachedWorkspaceRoot(cwd);
+    const state = workspaceStates.get(normalizeRootKey(resolved.root));
+    return state ? snapshot(state) : null;
+}
+function workspaceStateSummary(cwd) {
+    const state = syncWorkspaceState(cwd);
+    return formatWorkspaceStateSummary(state);
+}
+function formatWorkspaceStateSummary(state) {
+    return {
+        root: state.root,
+        config: state.configPath,
+        aliases: state.pathAliases,
+        importRules: (0, import_rules_1.importRulesToJson)(state.importRules),
+        mutationComments: (0, mutation_comments_1.mutationCommentsPolicyToJson)(state.mutationComments),
+        tsconfigCount: state.tsconfigs.length,
+        excludedTsconfigCount: state.excludedTsconfigCount,
+        watchers: state.watchersDisabled ? "disabled" : state.watchersStarted ? "started" : "not-started",
+        lastSyncAt: state.lastSyncAt,
+        ...(state.lastError ? { lastError: state.lastError } : {})
+    };
+}
+function startWorkspaceWatchers(state) {
+    closeWorkspaceWatchers(state);
+    const watchFiles = [state.configPath, ...state.tsconfigs].filter((file) => fs.existsSync(file));
+    state.watchers = watchFiles.flatMap((file) => {
+        try {
+            const watcher = fs.watch(file, { persistent: false }, () => scheduleWorkspaceReload(state.root));
+            return [watcher];
+        }
+        catch {
+            return [];
+        }
+    });
+    state.watchersStarted = state.watchers.length > 0;
+}
+function closeWorkspaceWatchers(state) {
+    for (const watcher of state.watchers) {
+        try {
+            watcher.close();
+        }
+        catch {
+            // ignore watcher close races
+        }
+    }
+    state.watchers = [];
+    state.watchersStarted = false;
+    if (state.debounceTimer) {
+        clearTimeout(state.debounceTimer);
+        delete state.debounceTimer;
+    }
+}
+function scheduleWorkspaceReload(root) {
+    const state = workspaceStates.get(normalizeRootKey(root));
+    if (!state) {
+        return;
+    }
+    if (state.debounceTimer) {
+        clearTimeout(state.debounceTimer);
+    }
+    state.debounceTimer = setTimeout(() => {
+        const current = workspaceStates.get(normalizeRootKey(root));
+        if (!current) {
+            return;
+        }
+        try {
+            syncWorkspaceState(root);
+        }
+        catch (error) {
+            current.lastError = errorToJson(error);
+        }
+    }, 100);
+    state.debounceTimer.unref();
+}
+function resolveCachedWorkspaceRoot(cwd) {
+    const key = normalizeCwdKey(cwd);
+    const cached = workspaceRootResolutions.get(key);
+    if (cached && !hasMoreSpecificWorkspaceConfig(cwd, cached.configPath)) {
+        return cached;
+    }
+    const resolved = (0, workspace_root_1.resolveRequiredWorkspaceRoot)(cwd);
+    rememberWorkspaceRoot(cwd, resolved);
+    return resolved;
+}
+function hasMoreSpecificWorkspaceConfig(cwd, cachedConfigPath) {
+    const cachedConfig = path.resolve(cachedConfigPath).toLowerCase();
+    const cachedConfigDir = path.dirname(cachedConfig);
+    let current = path.resolve(cwd);
+    const parsedRoot = path.parse(current).root;
+    while (true) {
+        const candidate = path.join(current, workspace_root_1.AIB_CONFIG_FILE_NAME);
+        if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
+            return path.resolve(candidate).toLowerCase() !== cachedConfig;
+        }
+        const currentKey = current.toLowerCase();
+        if (currentKey === cachedConfigDir || current === parsedRoot) {
+            return false;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return false;
+        }
+        current = parent;
+    }
+}
+function rememberWorkspaceRoot(cwd, resolved) {
+    workspaceRootResolutions.set(normalizeCwdKey(cwd), resolved);
+    workspaceRootResolutions.set(normalizeCwdKey(resolved.root), resolved);
+}
+function normalizeRootKey(root) {
+    return path.resolve(root).toLowerCase();
+}
+function normalizeCwdKey(cwd) {
+    return path.resolve(cwd).toLowerCase();
+}
+function snapshot(state) {
+    return {
+        root: state.root,
+        configPath: state.configPath,
+        config: state.config,
+        pathAliases: state.pathAliases,
+        importRules: [...state.importRules],
+        mutationComments: { ...state.mutationComments },
+        tsconfigs: [...state.tsconfigs],
+        excludedTsconfigCount: state.excludedTsconfigCount,
+        lastSyncAt: state.lastSyncAt,
+        watchersStarted: state.watchersStarted,
+        watchersDisabled: state.watchersDisabled,
+        ...(state.lastError ? { lastError: state.lastError } : {})
+    };
+}
+function errorToJson(error) {
+    if (error instanceof errors_1.CliError) {
+        return {
+            code: error.code,
+            message: error.message,
+            ...(error.details ? { details: JSON.parse(JSON.stringify(error.details)) } : {})
+        };
+    }
+    return {
+        code: "SYNC_ERROR",
+        message: error instanceof Error ? error.message : String(error)
+    };
+}

package/dist/content/content-bundle.js

@@ -1 +1,88 @@
-"use strict";var f=exports&&exports.__createBinding||(Object.create?(function(e,t,r,n){n===void 0&&(n=r);var i=Object.getOwnPropertyDescriptor(t,r);(!i||("get"in i?!t.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,n,i)}):(function(e,t,r,n){n===void 0&&(n=r),e[n]=t[r]})),d=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),a=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(r){var n=[];for(var i in r)Object.prototype.hasOwnProperty.call(r,i)&&(n[n.length]=i);return n},e(t)};return function(t){if(t&&t.__esModule)return t;var r={};if(t!=null)for(var n=e(t),i=0;i<n.length;i++)n[i]!=="default"&&f(r,t,n[i]);return d(r,t),r}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.resolveContentRoot=v,exports.collectContentCandidates=u,exports.directoryHasHelp=h;const s=a(require("node:fs")),_=a(require("node:os")),o=a(require("node:path")),c=require("../config/env-vars"),p=require("../shared/errors");function v(){for(const e of u())if(e.valid)return{dir:e.dir,source:e.source};throw new p.CliError("HELP_ASSETS_NOT_FOUND","AIB content assets were not found.",{env:c.CLI_ENV.helpDir,checked:u().map(e=>e.dir)})}function u(){const e=process.env[c.CLI_ENV.helpDir],t=b(),r=o.resolve(__dirname,"..","help"),n=[];return e&&n.push(l(c.CLI_ENV.helpDir,o.resolve(e))),n.push(l("cache",t)),n.push(l("bundled",r)),n}function h(e){return s.existsSync(o.join(e,"bootstrap.md"))&&s.existsSync(o.join(e,"topics"))}function l(e,t){return s.existsSync(t)?s.existsSync(o.join(t,"bootstrap.md"))?s.existsSync(o.join(t,"topics"))?{source:e,dir:t,valid:!0}:{source:e,dir:t,valid:!1,reason:"missing topics"}:{source:e,dir:t,valid:!1,reason:"missing bootstrap.md"}:{source:e,dir:t,valid:!1,reason:"missing"}}function b(){if(process.env[c.CLI_ENV.productStorageDir]?.trim())return o.join(o.resolve(process.env[c.CLI_ENV.productStorageDir]),"help","current");const e=process.env.LOCALAPPDATA?o.join(process.env.LOCALAPPDATA,"aib"):process.env.XDG_STATE_HOME?o.join(process.env.XDG_STATE_HOME,"aib"):o.join(_.homedir(),".local","state","aib");return o.join(e,"help","current")}
+"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.resolveContentRoot = resolveContentRoot;
+exports.collectContentCandidates = collectContentCandidates;
+exports.directoryHasHelp = directoryHasHelp;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const env_vars_1 = require("../config/env-vars");
+const product_storage_1 = require("../config/product-storage");
+const request_env_1 = require("../config/request-env");
+const errors_1 = require("../shared/errors");
+function resolveContentRoot() {
+    for (const candidate of collectContentCandidates()) {
+        if (candidate.valid) {
+            return {
+                dir: candidate.dir,
+                source: candidate.source
+            };
+        }
+    }
+    throw new errors_1.CliError("HELP_ASSETS_NOT_FOUND", "AIB content assets were not found.", {
+        env: env_vars_1.CLI_ENV.helpDir,
+        checked: collectContentCandidates().map((candidate) => candidate.dir)
+    });
+}
+function collectContentCandidates() {
+    const envDir = (0, request_env_1.readRequestEnv)(env_vars_1.CLI_ENV.helpDir);
+    const cached = currentHelpCacheDir();
+    const bundled = path.resolve(__dirname, "..", "help");
+    const candidates = [];
+    if (envDir) {
+        candidates.push(buildContentCandidate(env_vars_1.CLI_ENV.helpDir, path.resolve(envDir)));
+    }
+    candidates.push(buildContentCandidate("cache", cached));
+    candidates.push(buildContentCandidate("bundled", bundled));
+    return candidates;
+}
+function directoryHasHelp(dir) {
+    return fs.existsSync(path.join(dir, "bootstrap.md")) && fs.existsSync(path.join(dir, "topics"));
+}
+function buildContentCandidate(source, dir) {
+    if (!fs.existsSync(dir)) {
+        return { source, dir, valid: false, reason: "missing" };
+    }
+    if (!fs.existsSync(path.join(dir, "bootstrap.md"))) {
+        return { source, dir, valid: false, reason: "missing bootstrap.md" };
+    }
+    if (!fs.existsSync(path.join(dir, "topics"))) {
+        return { source, dir, valid: false, reason: "missing topics" };
+    }
+    return { source, dir, valid: true };
+}
+function currentHelpCacheDir() {
+    return path.join((0, product_storage_1.productStorageRoot)(), "help", "current");
+}

package/dist/diagnostics/module-plan-timeline.js

@@ -1,2 +1,75 @@
-"use strict";var b=exports&&exports.__createBinding||(Object.create?(function(n,e,i,r){r===void 0&&(r=i);var t=Object.getOwnPropertyDescriptor(e,i);(!t||("get"in t?!e.__esModule:t.writable||t.configurable))&&(t={enumerable:!0,get:function(){return e[i]}}),Object.defineProperty(n,r,t)}):(function(n,e,i,r){r===void 0&&(r=i),n[r]=e[i]})),g=exports&&exports.__setModuleDefault||(Object.create?(function(n,e){Object.defineProperty(n,"default",{enumerable:!0,value:e})}):function(n,e){n.default=e}),f=exports&&exports.__importStar||(function(){var n=function(e){return n=Object.getOwnPropertyNames||function(i){var r=[];for(var t in i)Object.prototype.hasOwnProperty.call(i,t)&&(r[r.length]=t);return r},n(e)};return function(e){if(e&&e.__esModule)return e;var i={};if(e!=null)for(var r=n(e),t=0;t<r.length;t++)r[t]!=="default"&&b(i,e,r[t]);return g(i,e),i}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.modulePlanTimelineEnabled=_,exports.recordModulePlanTimeline=y;const l=f(require("node:fs")),c=f(require("node:path")),v=require("../config/env-vars"),d=new Map;function _(){const n=process.env[v.CLI_ENV.modulePlanDebugTimeline];return n==="1"||n==="true"||n==="TRUE"}function y(n,e,i,r={}){if(!_())return;const t=e&&e.trim()?e.trim():"unknown",u=Date.now(),o=d.get(t)??u;d.set(t,o);const p={at:new Date(u).toISOString(),elapsedMs:u-o,pid:process.pid,executionId:t,event:i,...r},a=c.join(n,".tmp","aib","debug");try{l.mkdirSync(a,{recursive:!0});const s=`${JSON.stringify(p)}
-`;l.appendFileSync(c.join(a,`module-plan-timeline-${j(t)}.jsonl`),s),l.appendFileSync(c.join(a,"module-plan-timeline-last.jsonl"),s)}catch{}}function j(n){return n.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.modulePlanTimelineEnabled = modulePlanTimelineEnabled;
+exports.recordModulePlanTimeline = recordModulePlanTimeline;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const env_vars_1 = require("../config/env-vars");
+const starts = new Map();
+function modulePlanTimelineEnabled() {
+    const raw = process.env[env_vars_1.CLI_ENV.modulePlanDebugTimeline];
+    return raw === "1" || raw === "true" || raw === "TRUE";
+}
+function recordModulePlanTimeline(cwd, executionId, event, data = {}) {
+    if (!modulePlanTimelineEnabled()) {
+        return;
+    }
+    const id = executionId && executionId.trim() ? executionId.trim() : "unknown";
+    const now = Date.now();
+    const startedAt = starts.get(id) ?? now;
+    starts.set(id, startedAt);
+    const entry = {
+        at: new Date(now).toISOString(),
+        elapsedMs: now - startedAt,
+        pid: process.pid,
+        executionId: id,
+        event,
+        ...data
+    };
+    const dir = path.join(cwd, ".tmp", "aib", "debug");
+    try {
+        fs.mkdirSync(dir, { recursive: true });
+        const line = `${JSON.stringify(entry)}\n`;
+        fs.appendFileSync(path.join(dir, `module-plan-timeline-${sanitizeFilePart(id)}.jsonl`), line);
+        fs.appendFileSync(path.join(dir, "module-plan-timeline-last.jsonl"), line);
+    }
+    catch {
+        // Best-effort diagnostic path only.
+    }
+}
+function sanitizeFilePart(value) {
+    return value.replace(/[^a-z0-9_-]+/gi, "-");
+}

package/dist/diagnostics/readiness-text.js

@@ -1,8 +1,45 @@
-"use strict";var p=exports&&exports.__createBinding||(Object.create?(function(e,t,n,o){o===void 0&&(o=n);var r=Object.getOwnPropertyDescriptor(t,n);(!r||("get"in r?!t.__esModule:r.writable||r.configurable))&&(r={enumerable:!0,get:function(){return t[n]}}),Object.defineProperty(e,o,r)}):(function(e,t,n,o){o===void 0&&(o=n),e[o]=t[n]})),b=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),m=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(n){var o=[];for(var r in n)Object.prototype.hasOwnProperty.call(n,r)&&(o[o.length]=r);return o},e(t)};return function(t){if(t&&t.__esModule)return t;var n={};if(t!=null)for(var o=e(t),r=0;r<o.length;r++)o[r]!=="default"&&p(n,t,o[r]);return b(n,t),n}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.formatDoctorText=_,exports.formatRuntimeStatusText=v,exports.formatRuntimeStopText=j;const h=m(require("node:fs")),y=m(require("node:path")),$=require("../content/content-bundle");let a;function _(e,t={}){const n=D(e.checks),o=n.filter(u=>u.severity==="required"&&!u.ok),r=n.filter(u=>u.severity==="optional"&&!u.ok),i=e.mode==="runtime-install-gate";return o.length===0?S(n,r,i,t.verbose===!0):O(o,r,t.verbose===!0)}function v(e,t={}){if(e.ok===!1){const o=typeof e.code=="string"?e.code:"MANAGED_IDE_STATUS_FAILED",r=f(o);return["runtime status failed","",`${r.component??"managed runtime"}: failed`,`reason: ${r.reason??String(e.error??"status could not be read")}`,`next: ${r.next??"Run aib runtime status --verbose."}`,...t.verbose===!0?["","details:",JSON.stringify(e,null,2)]:[]].join(`
-`)}if(e.running!==!0)return["runtime stopped","","next: aib doctor --runtime"].join(`
-`);const n=[e.healthy===!0?"runtime running":"runtime unhealthy","",`workspace: ${String(e.workspace??".")}`,`host: ${String(e.host??"managed")}`,`bridge: ${e.healthy===!0?"ok":"not ready"}`];return t.verbose===!0&&n.push("","details:",JSON.stringify(e,null,2)),n.join(`
-`)}function j(e,t={}){if(e.ok===!1){const o=typeof e.code=="string"?e.code:"MANAGED_IDE_STOP_FAILED",r=f(o);return["runtime stop failed","",`${r.component??"managed runtime"}: failed`,`reason: ${r.reason??String(e.error??"runtime could not be stopped")}`,`next: ${r.next??"Run aib runtime status --verbose."}`,...t.verbose===!0?["","details:",JSON.stringify(e,null,2)]:[]].join(`
-`)}const n=[e.stopped===!0?"runtime stopped":"runtime already stopped"];return t.verbose===!0&&n.push("","details:",JSON.stringify(e,null,2)),n.join(`
-`)}function S(e,t,n,o){const r=[n?"aib runtime ready":"aib ready","","cli: ok",`managed runtime assets: ${c(e,["managed-host-assets","extension-vsix","ide-command","managed-runtime-node"])?"ok":"optional"}`,`bundled node: ${c(e,["managed-runtime-node"])?"ok":"not required"}`,`browser: ${c(e,["headless-browser"])?"ok":"missing"}`,`platform: ${c(e,["managed-runtime-platform"])?"ok":"static-only"}`];return n&&r.push(`managed runtime: ${c(e,["managed-runtime-start"])?"started":"not checked"}`,`bridge: ${c(e,["bridge-ping"])?"ok":"not checked"}`,`runtime cleanup: ${c(e,["managed-runtime-stop"])?"ok":"not checked"}`),t.length>0&&r.push("","optional:",...t.map(i=>`${d(i)}: ${l(i)}`)),o&&r.push("","checks:",...e.map(i=>g(i))),r.join(`
-`)}function O(e,t,n){const[o]=e,r=o?f(o.code):{},i=["aib not ready","",`${r.component??d(o)}: failed`,`reason: ${r.reason??l(o)}`,`next: ${r.next??"Run aib doctor --verbose."}`],u=e.slice(1);return u.length>0&&i.push("","also:",...u.map(s=>`${d(s)}: ${l(s)}`)),t.length>0&&i.push("","optional:",...t.map(s=>`${d(s)}: ${l(s)}`)),n?i.push("","checks:",...[...e,...t].map(s=>g(s))):i.push("","details: aib doctor --verbose"),i.join(`
-`)}function D(e){return Array.isArray(e)?e.filter(t=>!!t&&typeof t=="object"):[]}function c(e,t){const n=e.filter(o=>t.includes(o.id));return n.length>0&&n.every(o=>o.ok)}function d(e){if(!e)return"aib";const t=f(e.code);return t.component?t.component:e.id.includes("browser")?"browser":e.id.includes("extension")?"extension":e.id.includes("platform")?"platform":e.id.includes("runtime")||e.id.includes("host")||e.id.includes("ide")?"managed runtime":"cli"}function l(e){return e?f(e.code).reason??e.message:"unknown failure"}function g(e){const t=e.ok?"ok":"failed",n=e.code?` ${e.code}`:"";return`${e.id}: ${t}${n}`}function f(e){return e?w()?.codes?.[e]??{}:{}}function w(){if(a!==void 0)return a;try{const e=(0,$.resolveContentRoot)(),t=y.join(e.dir,"diagnostics","doctor.json"),n=JSON.parse(h.readFileSync(t,"utf8"));a=n&&typeof n=="object"?n:null}catch{a=null}return a}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDoctorText = formatDoctorText;
+function formatDoctorText(payload, options = {}) {
+    const checks = Array.isArray(payload.checks)
+        ? payload.checks.filter((item) => Boolean(item) && typeof item === "object" && !Array.isArray(item))
+        : [];
+    const requiredFailures = checks.filter((check) => check.severity === "required" && !check.ok);
+    const optionalFailures = checks.filter((check) => check.severity === "optional" && !check.ok);
+    if (requiredFailures.length === 0) {
+        const lines = [
+            "aib ready",
+            "",
+            "cli: ok",
+            `node: ${checkOk(checks, "node-version") ? "ok" : "unsupported"}`,
+            `bundled node: ${checkOk(checks, "bundled-node") ? "available" : "not required"}`
+        ];
+        if (optionalFailures.length > 0) {
+            lines.push("", "optional:", ...optionalFailures.map((failure) => `${failure.id}: ${failure.message}`));
+        }
+        if (options.verbose === true) {
+            lines.push("", "checks:", ...checks.map(formatVerboseCheck));
+        }
+        return lines.join("\n");
+    }
+    const [primary] = requiredFailures;
+    const lines = [
+        "aib not ready",
+        "",
+        `${primary?.id ?? "aib"}: failed`,
+        `reason: ${primary?.message ?? "unknown failure"}`,
+        "next: Run aib doctor --verbose."
+    ];
+    if (options.verbose === true) {
+        lines.push("", "checks:", ...checks.map(formatVerboseCheck));
+    }
+    return lines.join("\n");
+}
+function checkOk(checks, id) {
+    const check = checks.find((candidate) => candidate.id === id);
+    return check?.ok === true;
+}
+function formatVerboseCheck(check) {
+    return `${check.id}: ${check.ok ? "ok" : "failed"}${check.code ? ` ${check.code}` : ""}`;
+}