@hagicode/hagiscript 0.1.5 → 0.1.6-dev.37.1.2e654a6

package/dist/runtime/runtime-manifest.js

@@ -0,0 +1,231 @@
+import { access, readFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parse } from "yaml";
+export class RuntimeManifestValidationError extends Error {
+    errors;
+    constructor(errors) {
+        super(`Runtime manifest validation failed: ${errors.join("; ")}`);
+        this.name = "RuntimeManifestValidationError";
+        this.errors = errors;
+    }
+}
+const supportedComponentTypes = new Set([
+    "runtime",
+    "package",
+    "bundled-runtime"
+]);
+export function getPackageRoot(moduleUrl = import.meta.url) {
+    return resolve(dirname(fileURLToPath(moduleUrl)), "..", "..");
+}
+export function getDefaultRuntimeManifestPath(moduleUrl = import.meta.url) {
+    return join(getPackageRoot(moduleUrl), "runtime", "manifest.yaml");
+}
+export async function loadRuntimeManifest(options = {}) {
+    const manifestPath = resolve(options.manifestPath ?? getDefaultRuntimeManifestPath());
+    let parsed;
+    try {
+        parsed = parse(await readFile(manifestPath, "utf8"));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new RuntimeManifestValidationError([
+            `Failed to read runtime manifest ${manifestPath}: ${message}`
+        ]);
+    }
+    const manifest = validateRuntimeManifest(parsed, manifestPath);
+    for (const component of manifest.components) {
+        await validateRuntimeAssetExists(component.scripts.install);
+        for (const candidate of [
+            component.scripts.verify,
+            component.scripts.configure,
+            component.scripts.update,
+            component.scripts.remove
+        ]) {
+            if (!candidate) {
+                continue;
+            }
+            await validateRuntimeAssetExists(candidate);
+        }
+    }
+    return manifest;
+}
+export async function validateRuntimeAssetExists(pathValue) {
+    await access(pathValue);
+}
+function validateRuntimeManifest(value, manifestPath) {
+    const manifestDir = dirname(manifestPath);
+    const errors = [];
+    if (!isRecord(value)) {
+        throw new RuntimeManifestValidationError(["manifest must be a YAML object"]);
+    }
+    const runtimeObject = toRecord(value.runtime, "runtime", errors);
+    const pathsObject = toRecord(value.paths, "paths", errors);
+    const phasesObject = toRecord(value.phases, "phases", errors);
+    const componentValues = Array.isArray(value.components) ? value.components : null;
+    if (!componentValues) {
+        errors.push("components must be an array");
+    }
+    const runtime = {
+        name: readRequiredString(runtimeObject.name, "runtime.name", errors),
+        version: readRequiredString(runtimeObject.version, "runtime.version", errors)
+    };
+    const paths = {
+        runtimeRoot: readRequiredString(pathsObject.runtimeRoot, "paths.runtimeRoot", errors),
+        bin: readRequiredString(pathsObject.bin, "paths.bin", errors),
+        config: readRequiredString(pathsObject.config, "paths.config", errors),
+        logs: readRequiredString(pathsObject.logs, "paths.logs", errors),
+        data: readRequiredString(pathsObject.data, "paths.data", errors),
+        stateFile: readRequiredString(pathsObject.stateFile, "paths.stateFile", errors),
+        componentsRoot: readRequiredString(pathsObject.componentsRoot, "paths.componentsRoot", errors),
+        npmPrefix: readRequiredString(pathsObject.npmPrefix, "paths.npmPrefix", errors),
+        nodeRuntime: readRequiredString(pathsObject.nodeRuntime, "paths.nodeRuntime", errors),
+        dotnetRuntime: readRequiredString(pathsObject.dotnetRuntime, "paths.dotnetRuntime", errors),
+        vendoredRoot: readRequiredString(pathsObject.vendoredRoot, "paths.vendoredRoot", errors)
+    };
+    const phases = validateRuntimePhases(phasesObject, errors);
+    const components = validateRuntimeComponents(componentValues ?? [], manifestDir, errors);
+    const componentMap = new Map();
+    for (const component of components) {
+        if (componentMap.has(component.name)) {
+            errors.push(`components contains duplicate name ${component.name}`);
+            continue;
+        }
+        componentMap.set(component.name, component);
+    }
+    for (const [phaseName, definition] of Object.entries(phases)) {
+        for (const componentName of definition.order) {
+            if (!componentMap.has(componentName)) {
+                errors.push(`phases.${phaseName}.order references unknown component ${componentName}`);
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new RuntimeManifestValidationError(errors);
+    }
+    return {
+        manifestPath,
+        manifestDir,
+        runtime,
+        components,
+        componentMap,
+        phases,
+        paths
+    };
+}
+function validateRuntimePhases(value, errors) {
+    return {
+        install: validateRuntimePhase(value.install, "install", errors),
+        remove: validateRuntimePhase(value.remove, "remove", errors),
+        update: validateRuntimePhase(value.update, "update", errors)
+    };
+}
+function validateRuntimePhase(value, phaseName, errors) {
+    const phaseObject = toRecord(value, `phases.${phaseName}`, errors);
+    const orderValue = phaseObject.order;
+    const order = Array.isArray(orderValue)
+        ? orderValue.filter((item) => typeof item === "string")
+        : [];
+    if (!Array.isArray(orderValue) || order.length !== orderValue.length || order.length === 0) {
+        errors.push(`phases.${phaseName}.order must be a non-empty string array`);
+    }
+    const reverseValue = phaseObject.reverse;
+    if (reverseValue !== undefined && typeof reverseValue !== "boolean") {
+        errors.push(`phases.${phaseName}.reverse must be a boolean when provided`);
+    }
+    return {
+        order,
+        reverse: reverseValue === true
+    };
+}
+function validateRuntimeComponents(values, manifestDir, errors) {
+    const components = [];
+    for (const [index, value] of values.entries()) {
+        const componentObject = toRecord(value, `components[${index}]`, errors);
+        const name = readRequiredString(componentObject.name, `components[${index}].name`, errors);
+        const rawType = readRequiredString(componentObject.type, `components[${index}].type`, errors);
+        if (!supportedComponentTypes.has(rawType)) {
+            errors.push(`components[${index}].type must be one of runtime, package, bundled-runtime`);
+        }
+        const installScript = readResolvedScript(componentObject.installScript, manifestDir, `components[${index}].installScript`, errors);
+        const verifyScript = readOptionalResolvedScript(componentObject.verifyScript, manifestDir, `components[${index}].verifyScript`, errors);
+        const configureScript = readOptionalResolvedScript(componentObject.configureScript, manifestDir, `components[${index}].configureScript`, errors);
+        const updateScript = readOptionalResolvedScript(componentObject.updateScript, manifestDir, `components[${index}].updateScript`, errors);
+        const removeScript = readOptionalResolvedScript(componentObject.removeScript, manifestDir, `components[${index}].removeScript`, errors);
+        const packageCatalogValue = componentObject.packageCatalog;
+        const packageCatalog = Array.isArray(packageCatalogValue)
+            ? packageCatalogValue.flatMap((entry, packageIndex) => validateRuntimePackageCatalogEntry(entry, `components[${index}].packageCatalog[${packageIndex}]`, errors))
+            : [];
+        if (packageCatalogValue !== undefined && !Array.isArray(packageCatalogValue)) {
+            errors.push(`components[${index}].packageCatalog must be an array when provided`);
+        }
+        components.push({
+            name,
+            type: rawType,
+            source: readOptionalString(componentObject.source, `components[${index}].source`, errors),
+            version: readOptionalString(componentObject.version, `components[${index}].version`, errors),
+            channelVersion: readOptionalString(componentObject.channelVersion, `components[${index}].channelVersion`, errors),
+            packageCatalog,
+            scripts: {
+                install: installScript,
+                verify: verifyScript,
+                configure: configureScript,
+                update: updateScript,
+                remove: removeScript
+            }
+        });
+    }
+    return components;
+}
+function validateRuntimePackageCatalogEntry(value, label, errors) {
+    const entryObject = toRecord(value, label, errors);
+    const packageName = readRequiredString(entryObject, `${label}.packageName`, errors);
+    const installSpec = readRequiredString(entryObject, `${label}.installSpec`, errors);
+    return [
+        {
+            id: readOptionalString(entryObject.id, `${label}.id`, errors),
+            packageName,
+            installSpec,
+            binName: readOptionalString(entryObject.binName, `${label}.binName`, errors)
+        }
+    ];
+}
+function toRecord(value, label, errors) {
+    if (!isRecord(value)) {
+        errors.push(`${label} must be an object`);
+        return {};
+    }
+    return value;
+}
+function readRequiredString(value, label, errors) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        errors.push(`${label} must be a non-empty string`);
+        return "";
+    }
+    return value.trim();
+}
+function readOptionalString(value, label, errors) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "string" || value.trim().length === 0) {
+        errors.push(`${label} must be a non-empty string when provided`);
+        return undefined;
+    }
+    return value.trim();
+}
+function readResolvedScript(value, manifestDir, label, errors) {
+    const scriptPath = readRequiredString(value, label, errors);
+    return scriptPath ? resolveManifestRelativePath(manifestDir, scriptPath) : "";
+}
+function readOptionalResolvedScript(value, manifestDir, label, errors) {
+    const scriptPath = readOptionalString(value, label, errors);
+    return scriptPath ? resolveManifestRelativePath(manifestDir, scriptPath) : undefined;
+}
+function resolveManifestRelativePath(manifestDir, scriptPath) {
+    return resolve(manifestDir, scriptPath);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=runtime-manifest.js.map

package/dist/runtime/runtime-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-manifest.js","sourceRoot":"","sources":["../../src/runtime/runtime-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAA;AAgE5B,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IAC9C,MAAM,CAAU;IAEzB,YAAY,MAAgB;QAC1B,KAAK,CAAC,uCAAuC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACjE,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAA;QAC5C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAuB;IAC5D,SAAS;IACT,SAAS;IACT,iBAAiB;CAClB,CAAC,CAAA;AAEF,MAAM,UAAU,cAAc,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG;IACxD,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AAC/D,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG;IACvE,OAAO,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,CAAA;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAsC,EAAE;IAExC,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,IAAI,6BAA6B,EAAE,CAAC,CAAA;IACrF,IAAI,MAAe,CAAA;IAEnB,IAAI,CAAC;QACH,MAAM,GAAG,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAA;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtE,MAAM,IAAI,8BAA8B,CAAC;YACvC,mCAAmC,YAAY,KAAK,OAAO,EAAE;SAC9D,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAE9D,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,0BAA0B,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAE3D,KAAK,MAAM,SAAS,IAAI;YACtB,SAAS,CAAC,OAAO,CAAC,MAAM;YACxB,SAAS,CAAC,OAAO,CAAC,SAAS;YAC3B,SAAS,CAAC,OAAO,CAAC,MAAM;YACxB,SAAS,CAAC,OAAO,CAAC,MAAM;SACzB,EAAE,CAAC;YACF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,SAAQ;YACV,CAAC;YAED,MAAM,0BAA0B,CAAC,SAAS,CAAC,CAAA;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,SAAiB;IAChE,MAAM,MAAM,CAAC,SAAS,CAAC,CAAA;AACzB,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAc,EACd,YAAoB;IAEpB,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACzC,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,8BAA8B,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAA;IAC9E,CAAC;IAED,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;IAChE,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IAC1D,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC7D,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAA;IAEjF,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAA;IAC5C,CAAC;IAED,MAAM,OAAO,GAAG;QACd,IAAI,EAAE,kBAAkB,CAAC,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC;QACpE,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC;KAC9E,CAAA;IACD,MAAM,KAAK,GAAG;QACZ,WAAW,EAAE,kBAAkB,CAAC,WAAW,CAAC,WAAW,EAAE,mBAAmB,EAAE,MAAM,CAAC;QACrF,GAAG,EAAE,kBAAkB,CAAC,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC;QAC7D,MAAM,EAAE,kBAAkB,CAAC,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC;QACtE,IAAI,EAAE,kBAAkB,CAAC,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC;QAChE,IAAI,EAAE,kBAAkB,CAAC,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC;QAChE,SAAS,EAAE,kBAAkB,CAAC,WAAW,CAAC,SAAS,EAAE,iBAAiB,EAAE,MAAM,CAAC;QAC/E,cAAc,EAAE,kBAAkB,CAAC,WAAW,CAAC,cAAc,EAAE,sBAAsB,EAAE,MAAM,CAAC;QAC9F,SAAS,EAAE,kBAAkB,CAAC,WAAW,CAAC,SAAS,EAAE,iBAAiB,EAAE,MAAM,CAAC;QAC/E,WAAW,EAAE,kBAAkB,CAAC,WAAW,CAAC,WAAW,EAAE,mBAAmB,EAAE,MAAM,CAAC;QACrF,aAAa,EAAE,kBAAkB,CAAC,WAAW,CAAC,aAAa,EAAE,qBAAqB,EAAE,MAAM,CAAC;QAC3F,YAAY,EAAE,kBAAkB,CAAC,WAAW,CAAC,YAAY,EAAE,oBAAoB,EAAE,MAAM,CAAC;KACzF,CAAA;IACD,MAAM,MAAM,GAAG,qBAAqB,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;IAC1D,MAAM,UAAU,GAAG,yBAAyB,CAAC,eAAe,IAAI,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,CAAA;IACxF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAsC,CAAA;IAElE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,sCAAsC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAA;YACnE,SAAQ;QACV,CAAC;QAED,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;IAC7C,CAAC;IAED,KAAK,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAE1D,EAAE,CAAC;QACF,KAAK,MAAM,aAAa,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YAC7C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;gBACrC,MAAM,CAAC,IAAI,CACT,UAAU,SAAS,uCAAuC,aAAa,EAAE,CAC1E,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,8BAA8B,CAAC,MAAM,CAAC,CAAA;IAClD,CAAC;IAED,OAAO;QACL,YAAY;QACZ,WAAW;QACX,OAAO;QACP,UAAU;QACV,YAAY;QACZ,MAAM;QACN,KAAK;KACN,CAAA;AACH,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAA8B,EAC9B,MAAgB;IAEhB,OAAO;QACL,OAAO,EAAE,oBAAoB,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;QAC/D,MAAM,EAAE,oBAAoB,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC;QAC5D,MAAM,EAAE,oBAAoB,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC;KAC7D,CAAA;AACH,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAAc,EACd,SAAgC,EAChC,MAAgB;IAEhB,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,EAAE,UAAU,SAAS,EAAE,EAAE,MAAM,CAAC,CAAA;IAClE,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAA;IACpC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QACrC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;QACvE,CAAC,CAAC,EAAE,CAAA;IAEN,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3F,MAAM,CAAC,IAAI,CAAC,UAAU,SAAS,yCAAyC,CAAC,CAAA;IAC3E,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,CAAA;IACxC,IAAI,YAAY,KAAK,SAAS,IAAI,OAAO,YAAY,KAAK,SAAS,EAAE,CAAC;QACpE,MAAM,CAAC,IAAI,CAAC,UAAU,SAAS,0CAA0C,CAAC,CAAA;IAC5E,CAAC;IAED,OAAO;QACL,KAAK;QACL,OAAO,EAAE,YAAY,KAAK,IAAI;KAC/B,CAAA;AACH,CAAC;AAED,SAAS,yBAAyB,CAChC,MAAiB,EACjB,WAAmB,EACnB,MAAgB;IAEhB,MAAM,UAAU,GAAiC,EAAE,CAAA;IAEnD,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,MAAM,eAAe,GAAG,QAAQ,CAAC,KAAK,EAAE,cAAc,KAAK,GAAG,EAAE,MAAM,CAAC,CAAA;QACvE,MAAM,IAAI,GAAG,kBAAkB,CAAC,eAAe,CAAC,IAAI,EAAE,cAAc,KAAK,QAAQ,EAAE,MAAM,CAAC,CAAA;QAC1F,MAAM,OAAO,GAAG,kBAAkB,CAAC,eAAe,CAAC,IAAI,EAAE,cAAc,KAAK,QAAQ,EAAE,MAAM,CAAC,CAAA;QAE7F,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,OAA+B,CAAC,EAAE,CAAC;YAClE,MAAM,CAAC,IAAI,CAAC,cAAc,KAAK,yDAAyD,CAAC,CAAA;QAC3F,CAAC;QAED,MAAM,aAAa,GAAG,kBAAkB,CACtC,eAAe,CAAC,aAAa,EAC7B,WAAW,EACX,cAAc,KAAK,iBAAiB,EACpC,MAAM,CACP,CAAA;QACD,MAAM,YAAY,GAAG,0BAA0B,CAC7C,eAAe,CAAC,YAAY,EAC5B,WAAW,EACX,cAAc,KAAK,gBAAgB,EACnC,MAAM,CACP,CAAA;QACD,MAAM,eAAe,GAAG,0BAA0B,CAChD,eAAe,CAAC,eAAe,EAC/B,WAAW,EACX,cAAc,KAAK,mBAAmB,EACtC,MAAM,CACP,CAAA;QACD,MAAM,YAAY,GAAG,0BAA0B,CAC7C,eAAe,CAAC,YAAY,EAC5B,WAAW,EACX,cAAc,KAAK,gBAAgB,EACnC,MAAM,CACP,CAAA;QACD,MAAM,YAAY,GAAG,0BAA0B,CAC7C,eAAe,CAAC,YAAY,EAC5B,WAAW,EACX,cAAc,KAAK,gBAAgB,EACnC,MAAM,CACP,CAAA;QAED,MAAM,mBAAmB,GAAG,eAAe,CAAC,cAAc,CAAA;QAC1D,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC;YACvD,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,CAClD,kCAAkC,CAChC,KAAK,EACL,cAAc,KAAK,oBAAoB,YAAY,GAAG,EACtD,MAAM,CACP,CACF;YACH,CAAC,CAAC,EAAE,CAAA;QAEN,IAAI,mBAAmB,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAC7E,MAAM,CAAC,IAAI,CAAC,cAAc,KAAK,iDAAiD,CAAC,CAAA;QACnF,CAAC;QAED,UAAU,CAAC,IAAI,CAAC;YACd,IAAI;YACJ,IAAI,EAAE,OAA+B;YACrC,MAAM,EAAE,kBAAkB,CAAC,eAAe,CAAC,MAAM,EAAE,cAAc,KAAK,UAAU,EAAE,MAAM,CAAC;YACzF,OAAO,EAAE,kBAAkB,CAAC,eAAe,CAAC,OAAO,EAAE,cAAc,KAAK,WAAW,EAAE,MAAM,CAAC;YAC5F,cAAc,EAAE,kBAAkB,CAChC,eAAe,CAAC,cAAc,EAC9B,cAAc,KAAK,kBAAkB,EACrC,MAAM,CACP;YACD,cAAc;YACd,OAAO,EAAE;gBACP,OAAO,EAAE,aAAa;gBACtB,MAAM,EAAE,YAAY;gBACpB,SAAS,EAAE,eAAe;gBAC1B,MAAM,EAAE,YAAY;gBACpB,MAAM,EAAE,YAAY;aACrB;SACF,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,SAAS,kCAAkC,CACzC,KAAc,EACd,KAAa,EACb,MAAgB;IAEhB,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IAClD,MAAM,WAAW,GAAG,kBAAkB,CAAC,WAAW,EAAE,GAAG,KAAK,cAAc,EAAE,MAAM,CAAC,CAAA;IACnF,MAAM,WAAW,GAAG,kBAAkB,CAAC,WAAW,EAAE,GAAG,KAAK,cAAc,EAAE,MAAM,CAAC,CAAA;IAEnF,OAAO;QACL;YACE,EAAE,EAAE,kBAAkB,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,KAAK,KAAK,EAAE,MAAM,CAAC;YAC7D,WAAW;YACX,WAAW;YACX,OAAO,EAAE,kBAAkB,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,KAAK,UAAU,EAAE,MAAM,CAAC;SAC7E;KACF,CAAA;AACH,CAAC;AAED,SAAS,QAAQ,CACf,KAAc,EACd,KAAa,EACb,MAAgB;IAEhB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAA;QACzC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAc,EACd,KAAa,EACb,MAAgB;IAEhB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAA;QAClD,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,EAAE,CAAA;AACrB,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAc,EACd,KAAa,EACb,MAAgB;IAEhB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,2CAA2C,CAAC,CAAA;QAChE,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,EAAE,CAAA;AACrB,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAc,EACd,WAAmB,EACnB,KAAa,EACb,MAAgB;IAEhB,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IAC3D,OAAO,UAAU,CAAC,CAAC,CAAC,2BAA2B,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC/E,CAAC;AAED,SAAS,0BAA0B,CACjC,KAAc,EACd,WAAmB,EACnB,KAAa,EACb,MAAgB;IAEhB,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;IAC3D,OAAO,UAAU,CAAC,CAAC,CAAC,2BAA2B,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACtF,CAAC;AAED,SAAS,2BAA2B,CAAC,WAAmB,EAAE,UAAkB;IAC1E,OAAO,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAA;AACzC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC"}

package/dist/runtime/runtime-paths.d.ts

@@ -0,0 +1,24 @@
+import type { LoadedRuntimeManifest } from "./runtime-manifest.js";
+export declare const defaultRuntimeRoot = "~/.hagicode/runtime";
+export interface ResolvedRuntimePaths {
+    root: string;
+    bin: string;
+    config: string;
+    logs: string;
+    data: string;
+    stateFile: string;
+    componentsRoot: string;
+    npmPrefix: string;
+    nodeRuntime: string;
+    dotnetRuntime: string;
+    vendoredRoot: string;
+}
+export interface ResolveRuntimePathsOptions {
+    runtimeRoot?: string;
+}
+export declare function resolveRuntimePaths(manifest: LoadedRuntimeManifest, options?: ResolveRuntimePathsOptions): ResolvedRuntimePaths;
+export declare function normalizeManagedRoot(value: string): string;
+export declare function resolveManagedPath(pathValue: string, runtimeRoot: string): string;
+export declare function getComponentManagedRoot(paths: ResolvedRuntimePaths, componentName: string): string;
+export declare function getComponentConfigDirectory(paths: ResolvedRuntimePaths, componentName: string): string;
+export declare function isPathInsideRuntimeRoot(runtimeRoot: string, targetPath: string): boolean;

package/dist/runtime/runtime-paths.js

@@ -0,0 +1,62 @@
+import { homedir } from "node:os";
+import { isAbsolute, join, relative, resolve } from "node:path";
+export const defaultRuntimeRoot = "~/.hagicode/runtime";
+export function resolveRuntimePaths(manifest, options = {}) {
+    const root = normalizeManagedRoot(options.runtimeRoot ?? manifest.paths.runtimeRoot ?? defaultRuntimeRoot);
+    return {
+        root,
+        bin: resolveManagedPath(manifest.paths.bin, root),
+        config: resolveManagedPath(manifest.paths.config, root),
+        logs: resolveManagedPath(manifest.paths.logs, root),
+        data: resolveManagedPath(manifest.paths.data, root),
+        stateFile: resolveManagedPath(manifest.paths.stateFile, root),
+        componentsRoot: resolveManagedPath(manifest.paths.componentsRoot, root),
+        npmPrefix: resolveManagedPath(manifest.paths.npmPrefix, root),
+        nodeRuntime: resolveManagedPath(manifest.paths.nodeRuntime, root),
+        dotnetRuntime: resolveManagedPath(manifest.paths.dotnetRuntime, root),
+        vendoredRoot: resolveManagedPath(manifest.paths.vendoredRoot, root)
+    };
+}
+export function normalizeManagedRoot(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new Error("Managed runtime root must be a non-empty path.");
+    }
+    return resolve(expandHomeDirectory(trimmed));
+}
+export function resolveManagedPath(pathValue, runtimeRoot) {
+    const expanded = expandHomeDirectory(pathValue.trim());
+    return isAbsolute(expanded) ? resolve(expanded) : resolve(runtimeRoot, expanded);
+}
+export function getComponentManagedRoot(paths, componentName) {
+    switch (componentName) {
+        case "node":
+            return paths.nodeRuntime;
+        case "dotnet":
+            return paths.dotnetRuntime;
+        case "npm-packages":
+            return paths.npmPrefix;
+        case "omniroute":
+        case "code-server":
+            return join(paths.vendoredRoot, componentName);
+        default:
+            return join(paths.componentsRoot, componentName);
+    }
+}
+export function getComponentConfigDirectory(paths, componentName) {
+    return join(paths.config, componentName);
+}
+export function isPathInsideRuntimeRoot(runtimeRoot, targetPath) {
+    const relativePath = relative(resolve(runtimeRoot), resolve(targetPath));
+    return relativePath === "" || (!relativePath.startsWith("..") && !relativePath.startsWith("../"));
+}
+function expandHomeDirectory(value) {
+    if (value === "~") {
+        return homedir();
+    }
+    if (value.startsWith("~/")) {
+        return join(homedir(), value.slice(2));
+    }
+    return value;
+}
+//# sourceMappingURL=runtime-paths.js.map

package/dist/runtime/runtime-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-paths.js","sourceRoot":"","sources":["../../src/runtime/runtime-paths.ts"],"names":[],"mappings":"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"}

package/dist/runtime/runtime-state.d.ts

@@ -0,0 +1,43 @@
+import type { LoadedRuntimeManifest } from "./runtime-manifest.js";
+import type { ResolvedRuntimePaths } from "./runtime-paths.js";
+export type RuntimeComponentStatus = "not-installed" | "installed" | "removed" | "failed";
+export interface RuntimeComponentState {
+    name: string;
+    type: string;
+    status: RuntimeComponentStatus;
+    version: string | null;
+    managedPaths: string[];
+    lastAction: "install" | "remove" | "update" | null;
+    lastUpdatedAt: string | null;
+    logFile: string | null;
+    details?: Record<string, unknown>;
+}
+export interface RuntimeOperationState {
+    phase: "install" | "remove" | "update";
+    status: "success" | "failed";
+    selectedComponents: string[];
+    completedComponents: string[];
+    startedAt: string;
+    finishedAt: string;
+    logFile: string | null;
+    message?: string;
+}
+export interface RuntimeState {
+    schemaVersion: 1;
+    runtime: {
+        name: string;
+        version: string;
+        manifestPath: string;
+    };
+    managedRoot: string;
+    managedPaths: ResolvedRuntimePaths;
+    components: Record<string, RuntimeComponentState>;
+    lastOperation: RuntimeOperationState | null;
+}
+export declare class RuntimeStateError extends Error {
+    constructor(message: string);
+}
+export declare function createInitialRuntimeState(manifest: LoadedRuntimeManifest, paths: ResolvedRuntimePaths): RuntimeState;
+export declare function readRuntimeState(statePath: string): Promise<RuntimeState | null>;
+export declare function writeRuntimeState(statePath: string, state: RuntimeState): Promise<void>;
+export declare function mergeRuntimeState(manifest: LoadedRuntimeManifest, paths: ResolvedRuntimePaths, state: RuntimeState | null): RuntimeState;

package/dist/runtime/runtime-state.js

@@ -0,0 +1,82 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+export class RuntimeStateError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RuntimeStateError";
+    }
+}
+export function createInitialRuntimeState(manifest, paths) {
+    return {
+        schemaVersion: 1,
+        runtime: {
+            name: manifest.runtime.name,
+            version: manifest.runtime.version,
+            manifestPath: manifest.manifestPath
+        },
+        managedRoot: paths.root,
+        managedPaths: paths,
+        components: {},
+        lastOperation: null
+    };
+}
+export async function readRuntimeState(statePath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(statePath, "utf8"));
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            return null;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new RuntimeStateError(`Failed to read runtime state ${statePath}: ${message}`);
+    }
+    return validateRuntimeState(parsed, statePath);
+}
+export async function writeRuntimeState(statePath, state) {
+    await mkdir(dirname(statePath), { recursive: true });
+    await writeFile(statePath, `${JSON.stringify(state, null, 2)}\n`, "utf8");
+}
+export function mergeRuntimeState(manifest, paths, state) {
+    const nextState = state ?? createInitialRuntimeState(manifest, paths);
+    return {
+        ...nextState,
+        runtime: {
+            name: manifest.runtime.name,
+            version: manifest.runtime.version,
+            manifestPath: manifest.manifestPath
+        },
+        managedRoot: paths.root,
+        managedPaths: paths,
+        components: { ...nextState.components }
+    };
+}
+function validateRuntimeState(value, statePath) {
+    if (!isRecord(value)) {
+        throw new RuntimeStateError(`Runtime state ${statePath} must be a JSON object.`);
+    }
+    if (value.schemaVersion !== 1) {
+        throw new RuntimeStateError(`Runtime state ${statePath} has unsupported schemaVersion ${String(value.schemaVersion)}.`);
+    }
+    if (!isRecord(value.runtime) || typeof value.runtime.name !== "string" || typeof value.runtime.version !== "string") {
+        throw new RuntimeStateError(`Runtime state ${statePath} is missing runtime metadata.`);
+    }
+    if (!isRecord(value.managedPaths)) {
+        throw new RuntimeStateError(`Runtime state ${statePath} is missing managedPaths.`);
+    }
+    if (!isRecord(value.components)) {
+        throw new RuntimeStateError(`Runtime state ${statePath} is missing components.`);
+    }
+    return value;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isMissingFileError(error) {
+    return (error instanceof Error &&
+        "code" in error &&
+        typeof error.code === "string" &&
+        error.code === "ENOENT");
+}
+//# sourceMappingURL=runtime-state.js.map

package/dist/runtime/runtime-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-state.js","sourceRoot":"","sources":["../../src/runtime/runtime-state.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@hagicode/hagiscript",
-  "version": "0.1.5",
+  "version": "0.1.6-dev.37.1.2e654a6",
   "description": "Scoped npm package foundation for Hagiscript language tooling.",
+  "license": "MIT",
   "homepage": "https://github.com/HagiCode-org/hagiscript#readme",
   "bugs": {
     "url": "https://github.com/HagiCode-org/hagiscript/issues"
@@ -19,10 +20,13 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "hagiscript": "dist/cli.js"
+    "hagiscript": "dist/cli.js",
+    "hagicode-runtime": "bin/runtime"
   },
   "files": [
     "dist",
+    "bin",
+    "runtime",
     "README.md",
     "README_cn.md"
   ],
@@ -34,6 +38,7 @@
     "format:check": "prettier --check .",
     "lint": "eslint .",
     "integration:installed-runtime": "node scripts/integration-installed-runtime.mjs",
+    "integration:runtime-management": "node scripts/integration-runtime-management.mjs",
     "pack:check": "node scripts/verify-package.mjs",
     "publish:check-prereqs": "node scripts/verify-npm-publish-prereqs.mjs",
     "publish:prepare-dev-version": "node scripts/prepare-dev-version.mjs",
@@ -58,7 +63,8 @@
   "dependencies": {
     "commander": "^14.0.1",
     "execa": "^9.6.1",
-    "semver": "^7.7.4"
+    "semver": "^7.7.4",
+    "yaml": "^2.8.4"
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",

package/runtime/lib/runtime-script-lib.mjs

@@ -0,0 +1,103 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises"
+import path from "node:path"
+import process from "node:process"
+
+export function readRuntimeScriptContext() {
+  return {
+    runtimeRoot: requiredEnv("HAGISCRIPT_RUNTIME_ROOT"),
+    binDir: requiredEnv("HAGISCRIPT_RUNTIME_BIN_DIR"),
+    configDir: requiredEnv("HAGISCRIPT_RUNTIME_CONFIG_DIR"),
+    logsDir: requiredEnv("HAGISCRIPT_RUNTIME_LOGS_DIR"),
+    dataDir: requiredEnv("HAGISCRIPT_RUNTIME_DATA_DIR"),
+    statePath: requiredEnv("HAGISCRIPT_RUNTIME_STATE_PATH"),
+    componentName: requiredEnv("HAGISCRIPT_RUNTIME_COMPONENT_NAME"),
+    componentType: requiredEnv("HAGISCRIPT_RUNTIME_COMPONENT_TYPE"),
+    componentRoot: requiredEnv("HAGISCRIPT_RUNTIME_COMPONENT_ROOT"),
+    componentConfigDir: requiredEnv("HAGISCRIPT_RUNTIME_COMPONENT_CONFIG_DIR"),
+    templateDir: requiredEnv("HAGISCRIPT_RUNTIME_TEMPLATE_DIR"),
+    componentVersion: process.env.HAGISCRIPT_RUNTIME_COMPONENT_VERSION?.trim() || null,
+    phase: process.env.HAGISCRIPT_RUNTIME_PHASE?.trim() || "install",
+    purge: process.env.HAGISCRIPT_RUNTIME_PURGE === "1"
+  }
+}
+
+export async function ensureDirectory(directory) {
+  await mkdir(directory, { recursive: true })
+}
+
+export async function writeJsonFile(filePath, value) {
+  await ensureDirectory(path.dirname(filePath))
+  await writeFile(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf8")
+}
+
+export async function writeComponentMarker(context, extra = {}) {
+  const markerPath = path.join(context.componentRoot, ".hagicode-runtime.json")
+  await writeJsonFile(markerPath, {
+    component: context.componentName,
+    type: context.componentType,
+    version: context.componentVersion,
+    phase: context.phase,
+    runtimeRoot: context.runtimeRoot,
+    generatedAt: new Date().toISOString(),
+    ...extra
+  })
+  return markerPath
+}
+
+export async function materializeTemplate(templateName, destinationPath, variables) {
+  const templatePath = path.join(readRuntimeScriptContext().templateDir, templateName)
+  const template = await readFile(templatePath, "utf8")
+  let rendered = template
+
+  for (const [key, value] of Object.entries(variables)) {
+    rendered = rendered.replaceAll(`{{${key}}}`, String(value))
+  }
+
+  await ensureDirectory(path.dirname(destinationPath))
+  await writeFile(destinationPath, rendered, "utf8")
+  return destinationPath
+}
+
+export async function writeNodeEntrypoint(filePath, message) {
+  await ensureDirectory(path.dirname(filePath))
+  await writeFile(
+    filePath,
+    `#!/usr/bin/env node\nprocess.stdout.write(${JSON.stringify(message)} + "\\n")\n`,
+    "utf8"
+  )
+  return filePath
+}
+
+export async function writeCommandWrapper(binDir, commandName, scriptPath) {
+  await ensureDirectory(binDir)
+
+  if (process.platform === "win32") {
+    const wrapperPath = path.join(binDir, `${commandName}.cmd`)
+    const relativeTarget = path.relative(path.dirname(wrapperPath), scriptPath).replaceAll("/", "\\")
+    await writeFile(
+      wrapperPath,
+      `@echo off\r\nnode "%~dp0\\${relativeTarget}" %*\r\n`,
+      "utf8"
+    )
+    return wrapperPath
+  }
+
+  const wrapperPath = path.join(binDir, commandName)
+  const relativeTarget = path.relative(path.dirname(wrapperPath), scriptPath).replaceAll("\\", "/")
+  await writeFile(
+    wrapperPath,
+    `#!/usr/bin/env sh\nexec node "$(dirname "$0")/${relativeTarget}" "$@"\n`,
+    "utf8"
+  )
+  return wrapperPath
+}
+
+function requiredEnv(name) {
+  const value = process.env[name]?.trim()
+
+  if (!value) {
+    throw new Error(`Missing runtime script environment variable: ${name}`)
+  }
+
+  return value
+}