@automaton-labs/aib 0.0.7 → 0.0.9

package/dist/commands/shared.js

@@ -1 +1,2 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.extensionRequestOptions=u,exports.resolveTargetInstance=p,exports.resolveCompatibleTargetInstance=g,exports.fetchRuntimeInfo=_,exports.fetchEffectiveConfig=v,exports.assertInstanceCompatible=h;const i=require("../discovery/registry"),c=require("../discovery/select-instance"),f=require("../client/http-client"),b=require("../config/resolve"),o=require("../shared/errors"),y=require("../shared/diagnostics"),I=require("../shared/routes"),l=require("../compatibility/policy"),C=require("../managed-host/serve-web-autostart");function u(e){const t={};return e.transport!==void 0&&(t.transport=e.transport),e.metricsEnabled!==void 0&&(t.metricsEnabled=e.metricsEnabled),t}async function p(e,t={}){if(t.explicitInstanceId)return(0,c.selectInstanceById)((0,i.readRegistryEntries)(),t.explicitInstanceId);const n=t.autoStartIde?.mode!=="serve-web";if(t.autoStartIde?.mode==="serve-web")return await(0,C.startManagedServeWebForCwd)(e),(0,c.selectInstanceForCwd)(m((0,i.readRegistryEntries)()),e,{allowSingleInstanceFallback:!1});const a=(0,i.readRegistryEntries)();try{return(0,c.selectInstanceForCwd)(a,e,{allowSingleInstanceFallback:n})}catch(r){throw!(r instanceof o.CliError)||r.code!=="NO_MATCHING_INSTANCE"?r:E(r)}}function m(e){return e.filter(t=>t.appHost==="server-distro")}async function g(e,t,n={}){const a=await p(e,n),r={command:t,instance:a.entry};n.transport!==void 0&&(r.requestedTransport=n.transport);const s=(0,l.checkCommandCompatibility)(r);if(s.ok)return a;if(n.autoStartIde?.mode==="serve-web"&&n.explicitInstanceId===void 0)return await(0,C.startManagedServeWebForCwd)(e),w(e,t,n,s.error);throw s.error}function w(e,t,n,a){const r=(0,i.readRegistryEntries)().filter(s=>{const d={command:t,instance:s};return n.transport!==void 0&&(d.requestedTransport=n.transport),(0,l.checkCommandCompatibility)(d).ok});try{return(0,c.selectInstanceForCwd)(r,e,{allowSingleInstanceFallback:!1})}catch(s){throw s instanceof o.CliError&&s.code==="NO_MATCHING_INSTANCE"?a:s}}function E(e){const t=e.details&&typeof e.details=="object"&&!Array.isArray(e.details)?{...e.details}:{};return new o.CliError(e.code,e.message,{...t,hints:(0,y.buildAutoStartIdeHints)()})}async function _(e,t={}){return await(0,f.postJson)(e,I.EXTENSION_ROUTES.runtimeInfo,{},u(t))}async function v(e,t={}){const a=(await(0,f.postJson)(e,I.EXTENSION_ROUTES.effectiveConfig,{},u(t))).config;return(0,b.resolveCliConfig)(a??null)}function h(e,t){(0,l.assertCapabilityCompatible)(e,t)}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/commands/skills-command.js

@@ -0,0 +1,315 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSkillsCommand = runSkillsCommand;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const workspace_root_1 = require("../config/workspace-root");
+const help_command_1 = require("./help-command");
+const agent_text_1 = require("../shared/agent-text");
+const errors_1 = require("../shared/errors");
+const DEFAULT_TARGET = node_path_1.default.join(".agents", "skills");
+const MARKER_FILE = ".aib-skill.json";
+function runSkillsCommand(cwd, args) {
+    const options = parseSkillsArgs(args);
+    const helpRoot = (0, help_command_1.resolveHelpRoot)();
+    const definitions = readSkillDefinitions(helpRoot.dir);
+    const targetRoot = resolveTargetRoot(cwd, options.target);
+    const states = definitions.map((skill) => resolveSkillState(targetRoot, skill));
+    const summary = summarizeStates(states);
+    const displayTarget = displayPath(cwd, targetRoot);
+    if (options.mode === "preview") {
+        return (0, agent_text_1.attachAgentText)({
+            ok: summary.conflicts.length === 0,
+            operation: "skills.preview",
+            target: targetRoot,
+            helpSource: helpRoot.source,
+            skills: definitions.length,
+            ...summary
+        }, formatSkillsText("preview", displayTarget, states));
+    }
+    if (options.mode === "verify") {
+        if (summary.missing.length > 0 || summary.stale.length > 0 || summary.conflicts.length > 0) {
+            throw new errors_1.CliError("AIB_SKILLS_VERIFY_FAILED", "AIB skills are not current.", {
+                target: targetRoot,
+                ...summary,
+                text: formatSkillsText("verify", displayTarget, states)
+            });
+        }
+        return (0, agent_text_1.attachAgentText)({
+            ok: true,
+            operation: "skills.verify",
+            target: targetRoot,
+            helpSource: helpRoot.source,
+            skills: definitions.length,
+            ...summary
+        }, formatSkillsText("verify", displayTarget, states));
+    }
+    if (summary.conflicts.length > 0) {
+        throw new errors_1.CliError("AIB_SKILLS_INSTALL_CONFLICT", "Refusing to overwrite non-AIB skill folders.", {
+            target: targetRoot,
+            conflicts: summary.conflicts,
+            text: formatSkillsText("install", displayTarget, states)
+        });
+    }
+    const written = installSkills(states);
+    const installedStates = definitions.map((skill) => resolveSkillState(targetRoot, skill));
+    const installedSummary = summarizeStates(installedStates);
+    return (0, agent_text_1.attachAgentText)({
+        ok: true,
+        operation: "skills.install",
+        target: targetRoot,
+        helpSource: helpRoot.source,
+        skills: definitions.length,
+        filesWritten: written,
+        ...installedSummary
+    }, formatSkillsInstallText(displayTarget, states, written));
+}
+function parseSkillsArgs(args) {
+    const mode = readMode(args[0]);
+    let target = null;
+    for (let index = mode.explicit ? 1 : 0; index < args.length; index += 1) {
+        const current = args[index];
+        if (!current) {
+            continue;
+        }
+        if (current === "--target" || current === "-t" || current === "--to") {
+            const next = args[index + 1];
+            if (!next) {
+                throw new errors_1.CliError("MISSING_FLAG_VALUE", `Expected a value after ${current}.`);
+            }
+            target = next;
+            index += 1;
+            continue;
+        }
+        if (current === "help" || current === "--help") {
+            return { mode: "preview", target };
+        }
+        throw new errors_1.CliError("UNKNOWN_SKILLS_FLAG", `Unknown aib skills argument: ${current}`, {
+            usage: "aib skills preview|install|verify [--target <dir>]"
+        });
+    }
+    return { mode: mode.mode, target };
+}
+function readMode(value) {
+    if (!value) {
+        return { mode: "preview", explicit: false };
+    }
+    if (value === "preview" || value === "install" || value === "verify") {
+        return { mode: value, explicit: true };
+    }
+    return { mode: "preview", explicit: false };
+}
+function readSkillDefinitions(helpRoot) {
+    const metaPath = node_path_1.default.join(helpRoot, "help-meta.json");
+    if (!node_fs_1.default.existsSync(metaPath)) {
+        throw new errors_1.CliError("AIB_SKILLS_META_MISSING", "Active help bundle has no help-meta.json.", {
+            helpRoot
+        });
+    }
+    const meta = readJsonObject(metaPath);
+    const rawSkills = meta.skills;
+    if (!rawSkills || typeof rawSkills !== "object" || Array.isArray(rawSkills)) {
+        throw new errors_1.CliError("AIB_SKILLS_UNAVAILABLE", "Active help bundle does not define generated skills.", {
+            helpRoot
+        });
+    }
+    return Object.values(rawSkills)
+        .map(readSkillDefinition)
+        .filter((skill) => skill.target === "codex")
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+function readSkillDefinition(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new errors_1.CliError("AIB_SKILLS_META_INVALID", "Invalid skill metadata in active help bundle.");
+    }
+    const raw = value;
+    const target = readString(raw.target);
+    const name = readString(raw.name);
+    const description = readString(raw.description);
+    const topic = readString(raw.topic);
+    const body = readString(raw.body);
+    const contentHash = readString(raw.contentHash);
+    if (!target || !name || !description || !topic || !body || !contentHash) {
+        throw new errors_1.CliError("AIB_SKILLS_META_INVALID", "Invalid skill metadata in active help bundle.", {
+            skill: raw
+        });
+    }
+    const skillMarkdown = renderSkillMarkdown({ name, description, body });
+    return {
+        target,
+        name,
+        description,
+        topic,
+        body,
+        contentHash: hashText(skillMarkdown),
+        skillMarkdown,
+        marker: {
+            generatedBy: "aib skills",
+            schemaVersion: 1,
+            target,
+            name,
+            topic,
+            contentHash: hashText(skillMarkdown),
+            managedFiles: ["SKILL.md"]
+        }
+    };
+}
+function resolveTargetRoot(cwd, target) {
+    if (target) {
+        return node_path_1.default.resolve(cwd, target);
+    }
+    const workspace = (0, workspace_root_1.resolveWorkspaceRoot)(cwd);
+    return node_path_1.default.join(workspace?.root ?? cwd, DEFAULT_TARGET);
+}
+function resolveSkillState(targetRoot, skill) {
+    const dir = node_path_1.default.join(targetRoot, skill.name);
+    const skillFile = node_path_1.default.join(dir, "SKILL.md");
+    const markerFile = node_path_1.default.join(dir, MARKER_FILE);
+    if (!node_fs_1.default.existsSync(dir)) {
+        return { skill, dir, skillFile, markerFile, status: "missing", reason: "skill folder is missing" };
+    }
+    if (!node_fs_1.default.existsSync(markerFile)) {
+        return { skill, dir, skillFile, markerFile, status: "conflict", reason: `${MARKER_FILE} is missing` };
+    }
+    const marker = readMarker(markerFile);
+    if (!marker || marker.generatedBy !== "aib skills" || marker.name !== skill.name || marker.topic !== skill.topic) {
+        return { skill, dir, skillFile, markerFile, status: "conflict", reason: `${MARKER_FILE} does not match this generated skill` };
+    }
+    if (!node_fs_1.default.existsSync(skillFile)) {
+        return { skill, dir, skillFile, markerFile, status: "stale", reason: "SKILL.md is missing" };
+    }
+    const actualHash = hashText(node_fs_1.default.readFileSync(skillFile, "utf8").trim());
+    if (actualHash !== skill.contentHash || marker.contentHash !== skill.contentHash) {
+        return { skill, dir, skillFile, markerFile, status: "stale", reason: "generated content is stale" };
+    }
+    return { skill, dir, skillFile, markerFile, status: "current", reason: "current" };
+}
+function installSkills(states) {
+    const written = [];
+    for (const state of states) {
+        if (state.status === "current") {
+            continue;
+        }
+        if (state.status === "conflict") {
+            continue;
+        }
+        node_fs_1.default.mkdirSync(state.dir, { recursive: true });
+        node_fs_1.default.writeFileSync(state.skillFile, `${state.skill.skillMarkdown.trim()}\n`, "utf8");
+        node_fs_1.default.writeFileSync(state.markerFile, `${JSON.stringify(state.skill.marker, null, 2)}\n`, "utf8");
+        written.push(state.skillFile, state.markerFile);
+    }
+    return written;
+}
+function summarizeStates(states) {
+    return {
+        current: states.filter((state) => state.status === "current").map(formatState),
+        missing: states.filter((state) => state.status === "missing").map(formatState),
+        stale: states.filter((state) => state.status === "stale").map(formatState),
+        conflicts: states.filter((state) => state.status === "conflict").map(formatState)
+    };
+}
+function formatState(state) {
+    return {
+        name: state.skill.name,
+        topic: state.skill.topic,
+        reason: state.reason,
+        path: toPosix(state.dir)
+    };
+}
+function formatSkillsText(mode, displayTarget, states) {
+    const summary = groupStates(states);
+    const lines = [
+        `aib.skills.${mode}`,
+        `target: ${toPosix(displayTarget)}`,
+        `skills: ${states.length}`
+    ];
+    appendStateSection(lines, mode === "preview" ? "wouldCreate" : "missing", summary.missing, (state) => toPosix(node_path_1.default.join(displayTarget, state.skill.name, "SKILL.md")));
+    appendStateSection(lines, mode === "preview" ? "wouldUpdate" : "stale", summary.stale, (state) => `${state.skill.name}: ${state.reason}`);
+    appendStateSection(lines, "conflicts", summary.conflicts, (state) => `${state.skill.name}: ${state.reason}`);
+    appendStateSection(lines, "current", summary.current, (state) => state.skill.name);
+    if (mode === "preview" && summary.conflicts.length === 0) {
+        lines.push(`next: aib skills install${displayTarget === DEFAULT_TARGET ? "" : ` --target ${toPosix(displayTarget)}`}`);
+    }
+    if (mode === "verify" && summary.missing.length === 0 && summary.stale.length === 0 && summary.conflicts.length === 0) {
+        lines.push("ok: all generated skills are current");
+    }
+    return lines.join("\n");
+}
+function formatSkillsInstallText(displayTarget, beforeStates, written) {
+    const before = groupStates(beforeStates);
+    const lines = [
+        "aib.skills.install",
+        `target: ${toPosix(displayTarget)}`,
+        `created: ${before.missing.length}`,
+        `updated: ${before.stale.length}`,
+        `unchanged: ${before.current.length}`,
+        `filesWritten: ${written.length}`,
+        "next: aib skills verify"
+    ];
+    return lines.join("\n");
+}
+function groupStates(states) {
+    return {
+        current: states.filter((state) => state.status === "current"),
+        missing: states.filter((state) => state.status === "missing"),
+        stale: states.filter((state) => state.status === "stale"),
+        conflicts: states.filter((state) => state.status === "conflict")
+    };
+}
+function appendStateSection(lines, label, states, format) {
+    if (states.length === 0) {
+        return;
+    }
+    lines.push(`${label}:`);
+    for (const state of states) {
+        lines.push(format(state));
+    }
+}
+function renderSkillMarkdown(input) {
+    return [
+        "---",
+        `name: ${input.name}`,
+        `description: ${yamlScalar(input.description)}`,
+        "---",
+        "",
+        input.body.trim()
+    ].join("\n").trim();
+}
+function yamlScalar(value) {
+    if (/^[A-Za-z0-9][A-Za-z0-9 ,./_()'-]*[A-Za-z0-9.)]$/.test(value)) {
+        return value;
+    }
+    return JSON.stringify(value);
+}
+function readMarker(file) {
+    try {
+        const marker = readJsonObject(file);
+        return marker.generatedBy === "aib skills" ? marker : null;
+    }
+    catch {
+        return null;
+    }
+}
+function readJsonObject(file) {
+    return JSON.parse(node_fs_1.default.readFileSync(file, "utf8"));
+}
+function hashText(text) {
+    return `sha256:${node_crypto_1.default.createHash("sha256").update(text.trim()).digest("hex")}`;
+}
+function readString(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function displayPath(cwd, absolutePath) {
+    const relative = node_path_1.default.relative(cwd, absolutePath);
+    if (!relative || relative.startsWith("..") || node_path_1.default.isAbsolute(relative)) {
+        return absolutePath;
+    }
+    return relative || ".";
+}
+function toPosix(value) {
+    return value.replace(/\\/g, "/");
+}

package/dist/commands/sync-command.js

@@ -1,2 +1,59 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.runSyncCommand=f;const l=require("../shared/agent-text"),a=require("../config/workspace-state");function f(e,n){const t=n.includes("--status"),s=t?(0,a.workspaceStateStatus)(e):(0,a.syncWorkspaceState)(e),o=s?{ok:!0,synced:!t,state:(0,a.formatWorkspaceStateSummary)(s)}:{ok:!0,synced:!1,state:null};return(0,l.attachAgentText)(o,y(o))}function y(e){const n=e.state;if(!n||typeof n!="object"||Array.isArray(n))return"sync not initialized";const t=n,s=Object.keys(u(t.aliases)?t.aliases:{}).length,o=Number(t.tsconfigCount??0),c=Number(t.excludedTsconfigCount??0),i=c>0?`${o} visible, ${c} excluded`:String(o),r=e.synced===!1?["sync status",`root: ${String(t.root??"")}`,`config: ${String(t.config??"")}`,`AIB path aliases: ${s}`,`TypeScript configs: ${i}`,`watchers: ${String(t.watchers??"")}`]:["sync ok","config loaded",`AIB path aliases: ${s===0?"none":s}`,`TypeScript configs: ${i}`];return e.synced!==!1&&s===0&&r.push("","If you repeatedly use long paths, add pathAliases to aib.json."),u(t.lastError)&&r.push(`lastError: ${String(t.lastError.code??"SYNC_ERROR")}`),r.join(`
-`)}function u(e){return!!e&&typeof e=="object"&&!Array.isArray(e)}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSyncCommand = runSyncCommand;
+const agent_text_1 = require("../shared/agent-text");
+const workspace_state_1 = require("../config/workspace-state");
+function runSyncCommand(cwd, restArgs) {
+    const statusOnly = restArgs.includes("--status");
+    const state = statusOnly ? (0, workspace_state_1.workspaceStateStatus)(cwd) : (0, workspace_state_1.syncWorkspaceState)(cwd);
+    const response = state
+        ? {
+            ok: true,
+            synced: !statusOnly,
+            state: (0, workspace_state_1.formatWorkspaceStateSummary)(state)
+        }
+        : {
+            ok: true,
+            synced: false,
+            state: null
+        };
+    return (0, agent_text_1.attachAgentText)(response, formatSyncAgentText(response));
+}
+function formatSyncAgentText(response) {
+    const state = response.state;
+    if (!state || typeof state !== "object" || Array.isArray(state)) {
+        return "sync not initialized";
+    }
+    const row = state;
+    const aliasCount = Object.keys(isObject(row.aliases) ? row.aliases : {}).length;
+    const tsconfigCount = Number(row.tsconfigCount ?? 0);
+    const excludedTsconfigCount = Number(row.excludedTsconfigCount ?? 0);
+    const tsconfigText = excludedTsconfigCount > 0
+        ? `${tsconfigCount} visible, ${excludedTsconfigCount} excluded`
+        : String(tsconfigCount);
+    const lines = response.synced === false
+        ? [
+            "sync status",
+            `root: ${String(row.root ?? "")}`,
+            `config: ${String(row.config ?? "")}`,
+            `AIB path aliases: ${aliasCount}`,
+            `TypeScript configs: ${tsconfigText}`,
+            `watchers: ${String(row.watchers ?? "")}`
+        ]
+        : [
+            "sync ok",
+            "config loaded",
+            `AIB path aliases: ${aliasCount === 0 ? "none" : aliasCount}`,
+            `TypeScript configs: ${tsconfigText}`
+        ];
+    if (response.synced !== false && aliasCount === 0) {
+        lines.push("", "If you repeatedly use long paths, add pathAliases to aib.json.");
+    }
+    if (isObject(row.lastError)) {
+        lines.push(`lastError: ${String(row.lastError.code ?? "SYNC_ERROR")}`);
+    }
+    return lines.join("\n");
+}
+function isObject(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}

package/dist/commands/worker-command.js

@@ -1 +1,173 @@
-"use strict";var d=exports&&exports.__importDefault||function(r){return r&&r.__esModule?r:{default:r}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.runWorkerCommand=_;const c=d(require("node:fs")),i=d(require("node:path")),p=require("node:child_process"),y=require("../shared/errors"),k=require("../workers/registry"),g=require("../workers/product-storage");function _(r,e){if((e[0]??"")==="status")return h();const o=w(e),n=S(),t=(0,k.resolveWorkerRoute)({route:o.route,cliVersion:n,...o.registryPath?{registryPath:o.registryPath}:{}}),s=(0,p.spawnSync)(process.execPath,[t.script,...o.workerArgs],{cwd:r,encoding:"utf8",env:{...process.env,AIB_WORKER_ROUTE:t.route.route,AIB_WORKER_ID:t.route.workerId,AIB_WORKER_VERSION:t.route.version,AIB_WORKER_CWD:r}}),u=v(s.stdout),a=s.status===0&&u.ok!==!1;return{ok:a,command:"worker",route:t.route.route,worker:{workerId:t.route.workerId,version:t.route.version,script:t.script,registryPath:t.registryPath,status:s.status??null},payload:u,...a?{}:{error:m(u)??(s.stderr.trim()||"worker failed"),stderr:s.stderr.trim()}}}function h(){const r=(0,g.productStorageRoot)(),e=i.default.join(r,"workers","worker-routes.json"),o=i.default.join(r,"workers","activation-status.json"),n=l(e),t=l(o),s=j(i.default.join(r,"workers","bundles"));return{ok:!0,command:"worker",action:"status",registryPath:e,statusPath:o,registryVersion:f(n?.registryVersion)??f(t?.active?.registryVersion)??null,routeCount:Array.isArray(n?.routes)?n.routes.length:0,active:t?.active??null,previous:t?.previous??null,lastError:t?.lastError??null,workerBundles:s}}function w(r){let e,o;const n=[];let t=!1;for(let s=0;s<r.length;s+=1){const u=r[s],a=r[s+1];if(u!==void 0){if(!t&&u==="--registry"&&a){e=i.default.resolve(a),s+=1;continue}if(!t&&u==="--"){t=!0;continue}if(!o&&!t){o=u;continue}n.push(u)}}if(!o)throw new y.CliError("WORKER_USAGE","Usage: aib worker [--registry <path>] <route> -- <worker args>");return{route:o,...e?{registryPath:e}:{},workerArgs:n}}function v(r){try{const e=JSON.parse(r);return e&&typeof e=="object"&&!Array.isArray(e)?e:{ok:!1,error:"worker produced non-object json stdout"}}catch{return{ok:!1,error:r.trim()?`worker produced non-json stdout: ${r.trim()}`:"worker produced no stdout"}}}function m(r){return typeof r.error=="string"?r.error:null}function S(){const r=i.default.resolve(__dirname,"..","..","package.json");try{const e=JSON.parse(c.default.readFileSync(r,"utf8"));return typeof e.version=="string"?e.version:"0.0.0"}catch{return"0.0.0"}}function l(r){try{const e=JSON.parse(c.default.readFileSync(r,"utf8"));return e&&typeof e=="object"&&!Array.isArray(e)?e:null}catch{return null}}function f(r){return typeof r=="string"&&r.trim()?r:null}function j(r){if(!c.default.existsSync(r))return[];const e=[];for(const o of c.default.readdirSync(r,{withFileTypes:!0})){if(!o.isDirectory())continue;const n=i.default.join(r,o.name,"activation-status.json"),t=l(n);t&&e.push({workerId:o.name,statusPath:n,active:t.active??null,previous:t.previous??null,lastError:t.lastError??null})}return e.sort((o,n)=>String(o.workerId).localeCompare(String(n.workerId)))}
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runWorkerCommand = runWorkerCommand;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const errors_1 = require("../shared/errors");
+const registry_1 = require("../workers/registry");
+const product_storage_1 = require("../workers/product-storage");
+function runWorkerCommand(cwd, args) {
+    if ((args[0] ?? "") === "status") {
+        return runWorkerStatusCommand();
+    }
+    const options = parseWorkerCommandArgs(args);
+    const cliVersion = readCliVersion();
+    const resolved = (0, registry_1.resolveWorkerRoute)({
+        route: options.route,
+        cliVersion,
+        ...(options.registryPath ? { registryPath: options.registryPath } : {})
+    });
+    const result = (0, node_child_process_1.spawnSync)(process.execPath, [resolved.script, ...options.workerArgs], {
+        cwd,
+        encoding: "utf8",
+        env: {
+            ...process.env,
+            AIB_WORKER_ROUTE: resolved.route.route,
+            AIB_WORKER_ID: resolved.route.workerId,
+            AIB_WORKER_VERSION: resolved.route.version,
+            AIB_WORKER_CWD: cwd
+        }
+    });
+    const payload = parseWorkerPayload(result.stdout);
+    const ok = result.status === 0 && payload.ok !== false;
+    return {
+        ok,
+        command: "worker",
+        route: resolved.route.route,
+        worker: {
+            workerId: resolved.route.workerId,
+            version: resolved.route.version,
+            script: resolved.script,
+            registryPath: resolved.registryPath,
+            status: result.status ?? null
+        },
+        payload,
+        ...(ok ? {} : {
+            error: readPayloadError(payload) ?? (result.stderr.trim() || "worker failed"),
+            stderr: result.stderr.trim()
+        })
+    };
+}
+function runWorkerStatusCommand() {
+    const root = (0, product_storage_1.productStorageRoot)();
+    const registryPath = node_path_1.default.join(root, "workers", "worker-routes.json");
+    const statusPath = node_path_1.default.join(root, "workers", "activation-status.json");
+    const registry = readJsonObject(registryPath);
+    const status = readJsonObject(statusPath);
+    const bundles = readWorkerBundleStatuses(node_path_1.default.join(root, "workers", "bundles"));
+    return {
+        ok: true,
+        command: "worker",
+        action: "status",
+        registryPath,
+        statusPath,
+        registryVersion: readString(registry?.registryVersion) ?? readString(status?.active?.registryVersion) ?? null,
+        routeCount: Array.isArray(registry?.routes) ? registry.routes.length : 0,
+        active: status?.active ?? null,
+        previous: status?.previous ?? null,
+        lastError: status?.lastError ?? null,
+        workerBundles: bundles
+    };
+}
+function parseWorkerCommandArgs(args) {
+    let registryPath;
+    let route;
+    const workerArgs = [];
+    let passthrough = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const current = args[index];
+        const next = args[index + 1];
+        if (current === undefined) {
+            continue;
+        }
+        if (!passthrough && current === "--registry" && next) {
+            registryPath = node_path_1.default.resolve(next);
+            index += 1;
+            continue;
+        }
+        if (!passthrough && current === "--") {
+            passthrough = true;
+            continue;
+        }
+        if (!route && !passthrough) {
+            route = current;
+            continue;
+        }
+        workerArgs.push(current);
+    }
+    if (!route) {
+        throw new errors_1.CliError("WORKER_USAGE", "Usage: aib worker [--registry <path>] <route> -- <worker args>");
+    }
+    return {
+        route,
+        ...(registryPath ? { registryPath } : {}),
+        workerArgs
+    };
+}
+function parseWorkerPayload(stdout) {
+    try {
+        const parsed = JSON.parse(stdout);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed)
+            ? parsed
+            : { ok: false, error: "worker produced non-object json stdout" };
+    }
+    catch {
+        return {
+            ok: false,
+            error: stdout.trim() ? `worker produced non-json stdout: ${stdout.trim()}` : "worker produced no stdout"
+        };
+    }
+}
+function readPayloadError(payload) {
+    return typeof payload.error === "string" ? payload.error : null;
+}
+function readCliVersion() {
+    const packageJsonPath = node_path_1.default.resolve(__dirname, "..", "..", "package.json");
+    try {
+        const parsed = JSON.parse(node_fs_1.default.readFileSync(packageJsonPath, "utf8"));
+        return typeof parsed.version === "string" ? parsed.version : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+function readJsonObject(filePath) {
+    try {
+        const parsed = JSON.parse(node_fs_1.default.readFileSync(filePath, "utf8"));
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function readString(value) {
+    return typeof value === "string" && value.trim() ? value : null;
+}
+function readWorkerBundleStatuses(root) {
+    if (!node_fs_1.default.existsSync(root)) {
+        return [];
+    }
+    const result = [];
+    for (const entry of node_fs_1.default.readdirSync(root, { withFileTypes: true })) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const statusPath = node_path_1.default.join(root, entry.name, "activation-status.json");
+        const status = readJsonObject(statusPath);
+        if (!status) {
+            continue;
+        }
+        result.push({
+            workerId: entry.name,
+            statusPath,
+            active: status.active ?? null,
+            previous: status.previous ?? null,
+            lastError: status.lastError ?? null
+        });
+    }
+    return result.sort((left, right) => String(left.workerId).localeCompare(String(right.workerId)));
+}

package/dist/commands/workspace-cache.js

@@ -1 +1,55 @@
-"use strict";var i=exports&&exports.__createBinding||(Object.create?(function(t,e,r,n){n===void 0&&(n=r);var a=Object.getOwnPropertyDescriptor(e,r);(!a||("get"in a?!e.__esModule:a.writable||a.configurable))&&(a={enumerable:!0,get:function(){return e[r]}}),Object.defineProperty(t,n,a)}):(function(t,e,r,n){n===void 0&&(n=r),t[n]=e[r]})),s=exports&&exports.__setModuleDefault||(Object.create?(function(t,e){Object.defineProperty(t,"default",{enumerable:!0,value:e})}):function(t,e){t.default=e}),c=exports&&exports.__importStar||(function(){var t=function(e){return t=Object.getOwnPropertyNames||function(r){var n=[];for(var a in r)Object.prototype.hasOwnProperty.call(r,a)&&(n[n.length]=a);return n},t(e)};return function(e){if(e&&e.__esModule)return e;var r={};if(e!=null)for(var n=t(e),a=0;a<n.length;a++)n[a]!=="default"&&i(r,e,n[a]);return s(r,e),r}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.workspaceCachePath=h,exports.workspaceCachePathInProductStorageRoot=_;const f=c(require("node:crypto")),o=c(require("node:path")),l=require("../config/product-storage");function h(t,...e){return o.join(d(t),...e)}function _(t,e,...r){return o.join(u(e,t),...r)}function d(t){return u(t,(0,l.productStorageRoot)())}function u(t,e){const r=o.resolve(t),n=f.createHash("sha256").update(r.toLowerCase()).digest("hex").slice(0,16),a=o.basename(r).replace(/[^a-z0-9._-]+/gi,"-")||"workspace";return o.join(e,"workspace-cache",`${a}-${n}`)}
+"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.workspaceCachePath = workspaceCachePath;
+exports.workspaceCachePathInProductStorageRoot = workspaceCachePathInProductStorageRoot;
+const crypto = __importStar(require("node:crypto"));
+const path = __importStar(require("node:path"));
+const product_storage_1 = require("../config/product-storage");
+function workspaceCachePath(cwd, ...segments) {
+    return path.join(workspaceCacheRoot(cwd), ...segments);
+}
+function workspaceCachePathInProductStorageRoot(productStorageRootPath, cwd, ...segments) {
+    return path.join(workspaceCacheRootForStorage(cwd, productStorageRootPath), ...segments);
+}
+function workspaceCacheRoot(cwd) {
+    return workspaceCacheRootForStorage(cwd, (0, product_storage_1.productStorageRoot)());
+}
+function workspaceCacheRootForStorage(cwd, storageRoot) {
+    const normalized = path.resolve(cwd);
+    const hash = crypto.createHash("sha256").update(normalized.toLowerCase()).digest("hex").slice(0, 16);
+    const name = path.basename(normalized).replace(/[^a-z0-9._-]+/gi, "-") || "workspace";
+    return path.join(storageRoot, "workspace-cache", `${name}-${hash}`);
+}

package/dist/config/defaults.js

@@ -1 +1,26 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.DEFAULT_EFFECTIVE_CONFIG=void 0,exports.DEFAULT_EFFECTIVE_CONFIG={methodAliases:{ping:"ping",runtimeInfo:"runtimeInfo",printConfig:"printConfig",listInstances:"listInstances",initSkillUsage:"init-skill-usage",help:"help",inspect:"inspect",imports:"imports",move:"move",rename:"rename",refactor:"refactor",execution:"execution",modulePlan:"modulePlan"},entityKindAliases:{class:"c",interface:"i",type:"t",function:"f",variable:"v",enum:"e",namespace:"ns",method:"m",property:"p"},selectorSeparator:"-"};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_EFFECTIVE_CONFIG = void 0;
+exports.DEFAULT_EFFECTIVE_CONFIG = {
+    methodAliases: {
+        printConfig: "printConfig",
+        initSkillUsage: "init-skill-usage",
+        help: "help",
+        inspect: "inspect",
+        imports: "imports",
+        mutate: "mutate",
+        execution: "execution"
+    },
+    entityKindAliases: {
+        class: "c",
+        interface: "i",
+        type: "t",
+        function: "f",
+        variable: "v",
+        enum: "e",
+        namespace: "ns",
+        method: "m",
+        property: "p"
+    },
+    selectorSeparator: "-"
+};