@automaton-labs/aib 0.0.7 → 0.0.8

package/dist/workers/registry.js

@@ -1 +1,241 @@
-"use strict";var w=exports&&exports.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.defaultWorkerRegistryPath=E,exports.readWorkerRegistry=p,exports.resolveWorkerRoute=g,exports.parseWorkerRegistry=h;const d=w(require("node:fs")),c=w(require("node:path")),u=require("../shared/errors"),_=require("./product-storage");function E(){return c.default.join((0,_.productStorageRoot)(),"workers","worker-routes.json")}function p(e=E()){if(!d.default.existsSync(e))throw new u.CliError("WORKER_REGISTRY_NOT_FOUND","Worker registry was not found.",{registryPath:e,hint:"Run the control-plane worker with --manifest to fetch and activate remote worker routes."});let r;try{r=JSON.parse(d.default.readFileSync(e,"utf8"))}catch(t){throw new u.CliError("WORKER_REGISTRY_MALFORMED","Worker registry is not valid JSON.",{registryPath:e,error:t instanceof Error?t.message:String(t)})}return h(r,e)}function g(e){const r=c.default.resolve(e.registryPath??E()),t=p(r),o=t.routes.find(s=>s.route===e.route);if(!o)throw new u.CliError("WORKER_ROUTE_NOT_FOUND",`Worker route was not found: ${e.route}`,{route:e.route,registryPath:r,availableRoutes:t.routes.map(s=>s.route).sort()});if(!o.enabled)throw new u.CliError("WORKER_ROUTE_DISABLED",`Worker route is disabled: ${e.route}`,{route:e.route,registryPath:r});if(o.minCliVersion&&!v(e.cliVersion,o.minCliVersion))throw new u.CliError("WORKER_ROUTE_INCOMPATIBLE",`Worker route requires AIB ${o.minCliVersion}.`,{route:e.route,registryPath:r,cliVersion:e.cliVersion,minCliVersion:o.minCliVersion});const i=(0,_.productStorageRoot)(),n=O(i,o,r);if(!d.default.existsSync(n)||!d.default.statSync(n).isFile())throw new u.CliError("WORKER_ENTRY_NOT_FOUND","Worker entry file was not found.",{route:e.route,registryPath:r,entry:o.entry,script:n});return{registryPath:r,productStorageRoot:i,route:o,script:n}}function O(e,r,t){if(r.entry.startsWith("worker-bundle:")){const i=r.entry.slice(14);if(!i||!/^[a-zA-Z0-9._-]+$/.test(i))throw new u.CliError("WORKER_BUNDLE_ENTRY_INVALID","Worker bundle entry is invalid.",{route:r.route,registryPath:t,entry:r.entry});const n=c.default.join(e,"workers","bundles",i,"activation-status.json"),s=I(n),a=s?.active&&typeof s.active=="object"&&!Array.isArray(s.active)?s.active:null,l=typeof a?.entry=="string"?a.entry:null;if(!l)throw new u.CliError("WORKER_BUNDLE_NOT_ACTIVE","Worker bundle has no active version.",{route:r.route,workerId:i,statusPath:n});const f=m(e,l);if(!f)throw new u.CliError("WORKER_BUNDLE_ENTRY_UNSAFE","Worker bundle active entry must resolve inside product storage.",{route:r.route,workerId:i,statusPath:n,activeEntry:l});return f}const o=m(e,r.entry);if(!o)throw new u.CliError("WORKER_ENTRY_UNSAFE","Worker entry must resolve inside product storage.",{route:r.route,registryPath:t,entry:r.entry,productStorageRoot:e});return o}function h(e,r="<memory>"){const t=W(e,"worker registry");if(t.schemaVersion!==1)throw new u.CliError("WORKER_REGISTRY_INVALID","Worker registry schemaVersion must be 1.",{registryPath:r});const o=t.routes;if(!Array.isArray(o))throw new u.CliError("WORKER_REGISTRY_INVALID","Worker registry routes must be an array.",{registryPath:r});const i=o.map((s,a)=>b(s,a,r)),n=new Set;for(const s of i){if(n.has(s.route))throw new u.CliError("WORKER_REGISTRY_INVALID",`Duplicate worker route: ${s.route}`,{registryPath:r,route:s.route});n.add(s.route)}return{schemaVersion:1,...typeof t.generatedAt=="string"?{generatedAt:t.generatedAt}:{},...typeof t.registryVersion=="string"?{registryVersion:t.registryVersion}:{},routes:i}}function b(e,r,t){const o=W(e,`worker route ${r}`),i=R(o.route,"route",r,t),n=R(o.workerId,"workerId",r,t),s=R(o.version,"version",r,t),a=R(o.entry,"entry",r,t),l=o.argsMode===void 0?"passthrough":o.argsMode,f=o.output===void 0?"json":o.output;if(l!=="passthrough")throw y("argsMode must be passthrough",r,t);if(f!=="json")throw y("output must be json",r,t);return{route:i,workerId:n,version:s,entry:a,argsMode:"passthrough",output:"json",enabled:o.enabled!==!1,...typeof o.minCliVersion=="string"&&o.minCliVersion.trim()?{minCliVersion:o.minCliVersion}:{},capabilities:Array.isArray(o.capabilities)?o.capabilities.filter(k=>typeof k=="string"):[]}}function W(e,r){if(!e||typeof e!="object"||Array.isArray(e))throw new u.CliError("WORKER_REGISTRY_INVALID",`${r} must be an object.`);return e}function R(e,r,t,o){if(typeof e=="string"&&e.trim())return e;throw y(`${r} is required`,t,o)}function y(e,r,t){return new u.CliError("WORKER_REGISTRY_INVALID",`Invalid worker route at index ${r}: ${e}.`,{registryPath:t,index:r})}function m(e,r){const t=r.replace(/\\/g,"/");if(!t||t.startsWith("/")||t.split("/").includes(".."))return null;const o=c.default.resolve(e),i=c.default.resolve(o,t),n=c.default.relative(o,i);return n&&!n.startsWith("..")&&!c.default.isAbsolute(n)?i:null}function I(e){try{const r=JSON.parse(d.default.readFileSync(e,"utf8"));return r&&typeof r=="object"&&!Array.isArray(r)?r:null}catch{return null}}function v(e,r){const t=r.match(/^>=\s*(\d+)\.(\d+)\.(\d+)$/);if(!t)return e===r;const o=N(e),i=t.slice(1).map(n=>Number(n));for(let n=0;n<3;n+=1){const s=o[n]??0,a=i[n]??0;if(s>a)return!0;if(s<a)return!1}return!0}function N(e){const r=e.match(/(\d+)\.(\d+)\.(\d+)/);return r?r.slice(1).map(t=>Number(t)):[0,0,0]}
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultWorkerRegistryPath = defaultWorkerRegistryPath;
+exports.readWorkerRegistry = readWorkerRegistry;
+exports.resolveWorkerRoute = resolveWorkerRoute;
+exports.parseWorkerRegistry = parseWorkerRegistry;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const errors_1 = require("../shared/errors");
+const product_storage_1 = require("./product-storage");
+function defaultWorkerRegistryPath() {
+    return node_path_1.default.join((0, product_storage_1.productStorageRoot)(), "workers", "worker-routes.json");
+}
+function readWorkerRegistry(registryPath = defaultWorkerRegistryPath()) {
+    if (!node_fs_1.default.existsSync(registryPath)) {
+        throw new errors_1.CliError("WORKER_REGISTRY_NOT_FOUND", "Worker registry was not found.", {
+            registryPath,
+            hint: "Run the control-plane worker with --manifest to fetch and activate remote worker routes."
+        });
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(node_fs_1.default.readFileSync(registryPath, "utf8"));
+    }
+    catch (error) {
+        throw new errors_1.CliError("WORKER_REGISTRY_MALFORMED", "Worker registry is not valid JSON.", {
+            registryPath,
+            error: error instanceof Error ? error.message : String(error)
+        });
+    }
+    return parseWorkerRegistry(parsed, registryPath);
+}
+function resolveWorkerRoute(options) {
+    const registryPath = node_path_1.default.resolve(options.registryPath ?? defaultWorkerRegistryPath());
+    const registry = readWorkerRegistry(registryPath);
+    const route = registry.routes.find((item) => item.route === options.route);
+    if (!route) {
+        throw new errors_1.CliError("WORKER_ROUTE_NOT_FOUND", `Worker route was not found: ${options.route}`, {
+            route: options.route,
+            registryPath,
+            availableRoutes: registry.routes.map((item) => item.route).sort()
+        });
+    }
+    if (!route.enabled) {
+        throw new errors_1.CliError("WORKER_ROUTE_DISABLED", `Worker route is disabled: ${options.route}`, {
+            route: options.route,
+            registryPath
+        });
+    }
+    if (route.minCliVersion && !isCliVersionCompatible(options.cliVersion, route.minCliVersion)) {
+        throw new errors_1.CliError("WORKER_ROUTE_INCOMPATIBLE", `Worker route requires AIB ${route.minCliVersion}.`, {
+            route: options.route,
+            registryPath,
+            cliVersion: options.cliVersion,
+            minCliVersion: route.minCliVersion
+        });
+    }
+    const root = (0, product_storage_1.productStorageRoot)();
+    const script = resolveWorkerEntryScript(root, route, registryPath);
+    if (!node_fs_1.default.existsSync(script) || !node_fs_1.default.statSync(script).isFile()) {
+        throw new errors_1.CliError("WORKER_ENTRY_NOT_FOUND", "Worker entry file was not found.", {
+            route: options.route,
+            registryPath,
+            entry: route.entry,
+            script
+        });
+    }
+    return {
+        registryPath,
+        productStorageRoot: root,
+        route,
+        script
+    };
+}
+function resolveWorkerEntryScript(root, route, registryPath) {
+    if (route.entry.startsWith("worker-bundle:")) {
+        const workerId = route.entry.slice("worker-bundle:".length);
+        if (!workerId || !/^[a-zA-Z0-9._-]+$/.test(workerId)) {
+            throw new errors_1.CliError("WORKER_BUNDLE_ENTRY_INVALID", "Worker bundle entry is invalid.", {
+                route: route.route,
+                registryPath,
+                entry: route.entry
+            });
+        }
+        const statusPath = node_path_1.default.join(root, "workers", "bundles", workerId, "activation-status.json");
+        const status = readJsonObject(statusPath);
+        const active = status?.active && typeof status.active === "object" && !Array.isArray(status.active)
+            ? status.active
+            : null;
+        const activeEntry = typeof active?.entry === "string" ? active.entry : null;
+        if (!activeEntry) {
+            throw new errors_1.CliError("WORKER_BUNDLE_NOT_ACTIVE", "Worker bundle has no active version.", {
+                route: route.route,
+                workerId,
+                statusPath
+            });
+        }
+        const script = resolveInside(root, activeEntry);
+        if (!script) {
+            throw new errors_1.CliError("WORKER_BUNDLE_ENTRY_UNSAFE", "Worker bundle active entry must resolve inside product storage.", {
+                route: route.route,
+                workerId,
+                statusPath,
+                activeEntry
+            });
+        }
+        return script;
+    }
+    const script = resolveInside(root, route.entry);
+    if (!script) {
+        throw new errors_1.CliError("WORKER_ENTRY_UNSAFE", "Worker entry must resolve inside product storage.", {
+            route: route.route,
+            registryPath,
+            entry: route.entry,
+            productStorageRoot: root
+        });
+    }
+    return script;
+}
+function parseWorkerRegistry(value, registryPath = "<memory>") {
+    const object = asRecord(value, "worker registry");
+    if (object.schemaVersion !== 1) {
+        throw new errors_1.CliError("WORKER_REGISTRY_INVALID", "Worker registry schemaVersion must be 1.", {
+            registryPath
+        });
+    }
+    const routesValue = object.routes;
+    if (!Array.isArray(routesValue)) {
+        throw new errors_1.CliError("WORKER_REGISTRY_INVALID", "Worker registry routes must be an array.", {
+            registryPath
+        });
+    }
+    const routes = routesValue.map((item, index) => parseRoute(item, index, registryPath));
+    const seen = new Set();
+    for (const route of routes) {
+        if (seen.has(route.route)) {
+            throw new errors_1.CliError("WORKER_REGISTRY_INVALID", `Duplicate worker route: ${route.route}`, {
+                registryPath,
+                route: route.route
+            });
+        }
+        seen.add(route.route);
+    }
+    return {
+        schemaVersion: 1,
+        ...(typeof object.generatedAt === "string" ? { generatedAt: object.generatedAt } : {}),
+        ...(typeof object.registryVersion === "string" ? { registryVersion: object.registryVersion } : {}),
+        routes
+    };
+}
+function parseRoute(value, index, registryPath) {
+    const object = asRecord(value, `worker route ${index}`);
+    const route = readNonEmptyString(object.route, "route", index, registryPath);
+    const workerId = readNonEmptyString(object.workerId, "workerId", index, registryPath);
+    const version = readNonEmptyString(object.version, "version", index, registryPath);
+    const entry = readNonEmptyString(object.entry, "entry", index, registryPath);
+    const argsMode = object.argsMode === undefined ? "passthrough" : object.argsMode;
+    const output = object.output === undefined ? "json" : object.output;
+    if (argsMode !== "passthrough") {
+        throw invalidRoute("argsMode must be passthrough", index, registryPath);
+    }
+    if (output !== "json") {
+        throw invalidRoute("output must be json", index, registryPath);
+    }
+    return {
+        route,
+        workerId,
+        version,
+        entry,
+        argsMode: "passthrough",
+        output: "json",
+        enabled: object.enabled !== false,
+        ...(typeof object.minCliVersion === "string" && object.minCliVersion.trim() ? { minCliVersion: object.minCliVersion } : {}),
+        capabilities: Array.isArray(object.capabilities)
+            ? object.capabilities.filter((item) => typeof item === "string")
+            : []
+    };
+}
+function asRecord(value, label) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new errors_1.CliError("WORKER_REGISTRY_INVALID", `${label} must be an object.`);
+    }
+    return value;
+}
+function readNonEmptyString(value, field, index, registryPath) {
+    if (typeof value === "string" && value.trim()) {
+        return value;
+    }
+    throw invalidRoute(`${field} is required`, index, registryPath);
+}
+function invalidRoute(message, index, registryPath) {
+    return new errors_1.CliError("WORKER_REGISTRY_INVALID", `Invalid worker route at index ${index}: ${message}.`, {
+        registryPath,
+        index
+    });
+}
+function resolveInside(root, relativePath) {
+    const normalized = relativePath.replace(/\\/g, "/");
+    if (!normalized || normalized.startsWith("/") || normalized.split("/").includes("..")) {
+        return null;
+    }
+    const resolvedRoot = node_path_1.default.resolve(root);
+    const resolved = node_path_1.default.resolve(resolvedRoot, normalized);
+    const relative = node_path_1.default.relative(resolvedRoot, resolved);
+    return relative && !relative.startsWith("..") && !node_path_1.default.isAbsolute(relative) ? resolved : null;
+}
+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 isCliVersionCompatible(current, required) {
+    const match = required.match(/^>=\s*(\d+)\.(\d+)\.(\d+)$/);
+    if (!match) {
+        return current === required;
+    }
+    const currentParts = parseVersion(current);
+    const requiredParts = match.slice(1).map((item) => Number(item));
+    for (let index = 0; index < 3; index += 1) {
+        const currentPart = currentParts[index] ?? 0;
+        const requiredPart = requiredParts[index] ?? 0;
+        if (currentPart > requiredPart) {
+            return true;
+        }
+        if (currentPart < requiredPart) {
+            return false;
+        }
+    }
+    return true;
+}
+function parseVersion(value) {
+    const match = value.match(/(\d+)\.(\d+)\.(\d+)/);
+    return match ? match.slice(1).map((item) => Number(item)) : [0, 0, 0];
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@automaton-labs/aib",
-  "version": "0.0.7",
-  "description": "CLI for discovering and calling the local aib IDE extension runtime.",
+  "version": "0.0.8",
+  "description": "Node-native CLI for analyzing and changing TypeScript and JavaScript workspaces.",
   "publishConfig": {
     "access": "public"
   },
@@ -10,33 +10,28 @@
   },
   "files": [
     "dist",
-    "extension",
+    "config",
     "scripts/install-windows-launcher.cjs",
     "scripts/postinstall.cjs",
     "scripts/provision-runtime.cjs",
-    "runtimes/launcher",
     "runtimes/tools",
     "README.md",
     "package.json"
   ],
   "scripts": {
-    "build": "npm --silent --prefix ../control-plane-contracts run build && tsc -p . && node scripts/copy-managed-host-assets.cjs && node scripts/copy-control-plane-worker.cjs",
-    "build:package": "npm --silent --prefix ../control-plane-contracts run build && node ../../scripts/package/clean-paths.cjs dist && tsc -p tsconfig.package.json && node scripts/copy-managed-host-assets.cjs && node scripts/copy-control-plane-worker.cjs --minify && node ../../scripts/package/minify-js.cjs dist",
-    "typecheck": "npm --silent --prefix ../control-plane-contracts run build && tsc -p . --noEmit",
+    "build": "npm --silent --prefix ../tooling run build && tsc -p . && node scripts/copy-help-assets.cjs && node ../tooling/dist/cli.js packaging copy-control-plane-worker",
+    "build:package": "npm --silent --prefix ../tooling run build && node ../tooling/dist/cli.js packaging clean-paths dist && tsc -p tsconfig.package.json && node scripts/copy-help-assets.cjs && node ../tooling/dist/cli.js packaging copy-control-plane-worker --minify && node ../tooling/dist/cli.js packaging minify-js dist",
+    "typecheck": "tsc -p . --noEmit",
     "postinstall": "node scripts/postinstall.cjs",
-    "sync:tool-runtimes": "node ../../scripts/runtime/sync-tool-runtimes.cjs",
-    "prepack": "npm run build:package && node scripts/copy-extension-vsix.cjs",
+    "sync:tool-runtimes": "npm --silent --prefix ../tooling run build && node ../tooling/dist/cli.js runtime sync-tool-runtimes",
+    "prepack": "npm run build:package",
     "pack:local": "npm pack --pack-destination ../../.tmp"
   },
   "dependencies": {
     "typescript": "^6.0.3",
-    "ws": "^8.20.0",
     "zod": "^4.1.12"
   },
   "engines": {
     "node": ">=20"
-  },
-  "devDependencies": {
-    "@types/ws": "^8.18.1"
   }
 }

package/scripts/postinstall.cjs

@@ -1,29 +1,29 @@
-#!/usr/bin/env node
-
-const path = require("node:path");
-const { spawnSync } = require("node:child_process");
-
-const packageRoot = path.resolve(__dirname, "..");
-
-runBestEffort(path.join(__dirname, "install-windows-launcher.cjs"));
-runBestEffort(path.join(__dirname, "provision-runtime.cjs"), [], { inheritOutput: process.env.AIB_POSTINSTALL_QUIET !== "1" });
-
-function runBestEffort(scriptPath, args = [], options = {}) {
-  const inheritOutput = options.inheritOutput === true;
-  const result = spawnSync(process.execPath, [scriptPath, ...args], {
-    cwd: packageRoot,
-    env: process.env,
-    encoding: "utf8",
-    stdio: inheritOutput ? ["ignore", "inherit", "inherit"] : ["ignore", "pipe", "pipe"],
-    windowsHide: true
-  });
-
-  if (result.status === 0) {
-    return;
-  }
-
-  if (process.env.AIB_POSTINSTALL_STRICT === "1") {
-    process.stderr.write(result?.stderr || result?.stdout || `postinstall helper failed: ${scriptPath}\n`);
-    process.exit(result.status ?? 1);
-  }
-}
+#!/usr/bin/env node
+
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const packageRoot = path.resolve(__dirname, "..");
+
+runBestEffort(path.join(__dirname, "provision-runtime.cjs"), ["--quiet"]);
+runBestEffort(path.join(__dirname, "install-windows-launcher.cjs"));
+
+function runBestEffort(scriptPath, args = [], options = {}) {
+  const inheritOutput = options.inheritOutput === true;
+  const result = spawnSync(process.execPath, [scriptPath, ...args], {
+    cwd: packageRoot,
+    env: process.env,
+    encoding: "utf8",
+    stdio: inheritOutput ? ["ignore", "inherit", "inherit"] : ["ignore", "pipe", "pipe"],
+    windowsHide: true
+  });
+
+  if (result.status === 0) {
+    return;
+  }
+
+  if (process.env.AIB_POSTINSTALL_STRICT === "1") {
+    process.stderr.write(result?.stderr || result?.stdout || `postinstall helper failed: ${scriptPath}\n`);
+    process.exit(result.status ?? 1);
+  }
+}