@xemahq/xema 0.1.5 → 0.2.1

package/dist/runtime/lock-loader.d.ts

@@ -0,0 +1,26 @@
+import { type DistributionLock } from '@xemahq/kernel-contracts/distribution';
+import { type ArtifactResolution } from './paths';
+export interface LoadedDistributionLock {
+    readonly lock: DistributionLock;
+    readonly resolution: ArtifactResolution;
+}
+export interface LoadLockOptions {
+    readonly edition: string;
+    readonly explicit?: string | undefined;
+    readonly envVar?: string | undefined;
+}
+export declare function loadDistributionLock(opts: LoadLockOptions): LoadedDistributionLock;
+export interface ImageEntry {
+    readonly biomeId: string;
+    readonly target: string;
+    readonly imageRef: string;
+    readonly contentHash: string;
+    readonly repo: string;
+    readonly path: string;
+}
+export interface LoadedImageLock {
+    readonly imagesByBiome: ReadonlyMap<string, ImageEntry>;
+    readonly resolution: ArtifactResolution;
+}
+export declare function loadImageLock(opts: LoadLockOptions): LoadedImageLock;
+//# sourceMappingURL=lock-loader.d.ts.map

package/dist/runtime/lock-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-loader.d.ts","sourceRoot":"","sources":["../../src/runtime/lock-loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAErG,OAAO,EAAqD,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAOrG,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACzC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,sBAAsB,CASlF;AAOD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAE9B,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxD,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;CACzC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,CA6BpE"}

package/dist/runtime/lock-loader.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadDistributionLock = loadDistributionLock;
+exports.loadImageLock = loadImageLock;
+const node_fs_1 = require("node:fs");
+const distribution_1 = require("@xemahq/kernel-contracts/distribution");
+const paths_1 = require("./paths");
+function loadDistributionLock(opts) {
+    const resolution = (0, paths_1.resolveDistributionLockPath)({
+        edition: opts.edition,
+        explicit: opts.explicit,
+        envVar: opts.envVar,
+    });
+    const raw = readJson(resolution.path);
+    const lock = (0, distribution_1.parseDistributionLock)(raw);
+    return { lock, resolution };
+}
+function loadImageLock(opts) {
+    const resolution = (0, paths_1.resolveImageLockPath)({ edition: opts.edition, explicit: opts.explicit });
+    const raw = readJson(resolution.path);
+    if (!Array.isArray(raw.images)) {
+        throw new Error(`Invalid images.lock.json at ${resolution.path}: missing images[] array.`);
+    }
+    const imagesByBiome = new Map();
+    for (const entry of raw.images) {
+        if (typeof entry.biomeId !== 'string' ||
+            typeof entry.imageRef !== 'string' ||
+            typeof entry.contentHash !== 'string') {
+            throw new Error(`Invalid images.lock.json at ${resolution.path}: an images[] entry is missing biomeId/imageRef/contentHash.`);
+        }
+        if (entry.target === 'server') {
+            imagesByBiome.set(entry.biomeId, {
+                biomeId: entry.biomeId,
+                target: entry.target,
+                imageRef: entry.imageRef,
+                contentHash: entry.contentHash,
+                repo: typeof entry.repo === 'string' ? entry.repo : '',
+                path: typeof entry.path === 'string' ? entry.path : '',
+            });
+        }
+    }
+    return { imagesByBiome, resolution };
+}
+function readJson(path) {
+    let text;
+    try {
+        text = (0, node_fs_1.readFileSync)(path, 'utf8');
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to read ${path}: ${message}`);
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to parse ${path} as JSON: ${message}`);
+    }
+}
+//# sourceMappingURL=lock-loader.js.map

package/dist/runtime/lock-loader.js.map

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

package/dist/runtime/paths.d.ts

@@ -0,0 +1,14 @@
+export declare function findMonorepoRoot(startDir?: string): string | null;
+export interface ArtifactResolution {
+    readonly path: string;
+    readonly source: 'flag' | 'env' | 'vendored' | 'monorepo';
+}
+export interface ResolveArtifactOptions {
+    readonly explicit?: string | undefined;
+    readonly envVar?: string | undefined;
+    readonly edition: string;
+}
+export declare function resolveDistributionLockPath(opts: ResolveArtifactOptions): ArtifactResolution;
+export declare function resolveImageLockPath(opts: ResolveArtifactOptions): ArtifactResolution;
+export declare function resolveBootGraphPath(opts: Omit<ResolveArtifactOptions, 'edition'>): ArtifactResolution;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/runtime/paths.ts"],"names":[],"mappings":"AAqBA,wBAAgB,gBAAgB,CAAC,QAAQ,GAAE,MAAkB,GAAG,MAAM,GAAG,IAAI,CAY5E;AAQD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,CAAC;CAC3D;AAED,MAAM,WAAW,sBAAsB;IAErC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAErC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAcD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,sBAAsB,GAAG,kBAAkB,CA2B5F;AAGD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,sBAAsB,GAAG,kBAAkB,CAwBrF;AAGD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,CAAC,GAAG,kBAAkB,CAwBtG"}

package/dist/runtime/paths.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findMonorepoRoot = findMonorepoRoot;
+exports.resolveDistributionLockPath = resolveDistributionLockPath;
+exports.resolveImageLockPath = resolveImageLockPath;
+exports.resolveBootGraphPath = resolveBootGraphPath;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const MONOREPO_ROOT_MARKERS = ['pnpm-workspace.yaml', 'repos-infra/xema-distributions'];
+function findMonorepoRoot(startDir = __dirname) {
+    let dir = startDir;
+    for (;;) {
+        if (MONOREPO_ROOT_MARKERS.every((m) => (0, node_fs_1.existsSync)((0, node_path_1.join)(dir, m)))) {
+            return dir;
+        }
+        const parent = (0, node_path_1.dirname)(dir);
+        if (parent === dir) {
+            return null;
+        }
+        dir = parent;
+    }
+}
+function vendoredAssetsDir() {
+    return (0, node_path_1.resolve)(__dirname, '..', 'assets');
+}
+function firstExisting(candidates) {
+    for (const c of candidates) {
+        if ((0, node_fs_1.existsSync)(c.path)) {
+            return { path: c.path, source: c.source };
+        }
+    }
+    return null;
+}
+function resolveDistributionLockPath(opts) {
+    const monorepo = findMonorepoRoot();
+    const candidates = [];
+    if (opts.explicit) {
+        candidates.push({ path: absolutize(opts.explicit), source: 'flag' });
+    }
+    if (opts.envVar) {
+        candidates.push({ path: absolutize(opts.envVar), source: 'env' });
+    }
+    if (monorepo) {
+        candidates.push({
+            path: (0, node_path_1.join)(monorepo, 'repos-infra/xema-distributions', opts.edition, 'distribution.lock.json'),
+            source: 'monorepo',
+        });
+    }
+    candidates.push({
+        path: (0, node_path_1.join)(vendoredAssetsDir(), opts.edition, 'distribution.lock.json'),
+        source: 'vendored',
+    });
+    const found = firstExisting(candidates);
+    if (!found) {
+        throw new Error(`Could not locate distribution.lock.json for edition "${opts.edition}". Tried:\n` +
+            candidates.map((c) => `  - ${c.path} (${c.source})`).join('\n'));
+    }
+    return found;
+}
+function resolveImageLockPath(opts) {
+    const monorepo = findMonorepoRoot();
+    const candidates = [];
+    if (opts.explicit) {
+        candidates.push({ path: absolutize(opts.explicit), source: 'flag' });
+    }
+    if (monorepo) {
+        candidates.push({
+            path: (0, node_path_1.join)(monorepo, 'repos-infra/xema-distributions', opts.edition, 'images.lock.json'),
+            source: 'monorepo',
+        });
+    }
+    candidates.push({
+        path: (0, node_path_1.join)(vendoredAssetsDir(), opts.edition, 'images.lock.json'),
+        source: 'vendored',
+    });
+    const found = firstExisting(candidates);
+    if (!found) {
+        throw new Error(`Could not locate images.lock.json for edition "${opts.edition}". Tried:\n` +
+            candidates.map((c) => `  - ${c.path} (${c.source})`).join('\n'));
+    }
+    return found;
+}
+function resolveBootGraphPath(opts) {
+    const monorepo = findMonorepoRoot();
+    const candidates = [];
+    if (opts.explicit) {
+        candidates.push({ path: absolutize(opts.explicit), source: 'flag' });
+    }
+    if (opts.envVar) {
+        candidates.push({ path: absolutize(opts.envVar), source: 'env' });
+    }
+    if (monorepo) {
+        candidates.push({
+            path: (0, node_path_1.join)(monorepo, 'tooling/boundaries/boot-graph.json'),
+            source: 'monorepo',
+        });
+    }
+    candidates.push({ path: (0, node_path_1.join)(vendoredAssetsDir(), 'boot-graph.json'), source: 'vendored' });
+    const found = firstExisting(candidates);
+    if (!found) {
+        throw new Error(`Could not locate boot-graph.json. Tried:\n` +
+            candidates.map((c) => `  - ${c.path} (${c.source})`).join('\n'));
+    }
+    return found;
+}
+function absolutize(p) {
+    return (0, node_path_1.isAbsolute)(p) ? p : (0, node_path_1.resolve)(process.cwd(), p);
+}
+//# sourceMappingURL=paths.js.map

package/dist/runtime/paths.js.map

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

package/dist/runtime/platform-services.d.ts

@@ -0,0 +1,2 @@
+export declare const PLATFORM_SERVICE_PATHS: Readonly<Record<string, string>>;
+//# sourceMappingURL=platform-services.d.ts.map

package/dist/runtime/platform-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-services.d.ts","sourceRoot":"","sources":["../../src/runtime/platform-services.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIlE,CAAC"}

package/dist/runtime/platform-services.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLATFORM_SERVICE_PATHS = void 0;
+exports.PLATFORM_SERVICE_PATHS = Object.freeze({
+    'xema-kernel-server': 'repos/xema-community/kernel/xema-kernel-server',
+    'xema-capability-router': 'repos/xema-community/biomes/xema-capability-router/api/xema-capability-router',
+});
+//# sourceMappingURL=platform-services.js.map

package/dist/runtime/platform-services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-services.js","sourceRoot":"","sources":["../../src/runtime/platform-services.ts"],"names":[],"mappings":";;;AAUa,QAAA,sBAAsB,GAAqC,MAAM,CAAC,MAAM,CAAC;IACpF,oBAAoB,EAAE,gDAAgD;IACtE,wBAAwB,EACtB,+EAA+E;CAClF,CAAC,CAAC"}

package/dist/runtime/port-map.d.ts

@@ -0,0 +1,3 @@
+import type { RosterEntry } from './roster';
+export declare function assignPorts(roster: readonly RosterEntry[]): Map<string, number>;
+//# sourceMappingURL=port-map.d.ts.map

package/dist/runtime/port-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-map.d.ts","sourceRoot":"","sources":["../../src/runtime/port-map.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAW5C,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAmB/E"}

package/dist/runtime/port-map.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assignPorts = assignPorts;
+const env_defaults_1 = require("../dev/env-defaults");
+const FALLBACK_BASE = 7400;
+function assignPorts(roster) {
+    const assigned = new Map();
+    let next = FALLBACK_BASE;
+    const used = new Set(Object.values(env_defaults_1.PORT_MAP));
+    for (const entry of [...roster].sort((a, b) => a.name.localeCompare(b.name))) {
+        const known = env_defaults_1.PORT_MAP[entry.name];
+        if (typeof known === 'number') {
+            assigned.set(entry.name, known);
+            continue;
+        }
+        while (used.has(next)) {
+            next += 1;
+        }
+        assigned.set(entry.name, next);
+        used.add(next);
+        next += 1;
+    }
+    return assigned;
+}
+//# sourceMappingURL=port-map.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"port-map.js","sourceRoot":"","sources":["../../src/runtime/port-map.ts"],"names":[],"mappings":";;AAaA,kCAmBC;AAhCD,sDAA+C;AAW/C,MAAM,aAAa,GAAG,IAAI,CAAC;AAE3B,SAAgB,WAAW,CAAC,MAA8B;IACxD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,IAAI,IAAI,GAAG,aAAa,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,uBAAQ,CAAC,CAAC,CAAC;IAEtD,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,KAAK,GAAG,uBAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAChC,SAAS;QACX,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,CAAC;QACZ,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,IAAI,CAAC,CAAC;IACZ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/runtime/roster.d.ts

@@ -0,0 +1,32 @@
+import { type RuntimeUnitType } from './unit-type';
+import type { ImageEntry } from './lock-loader';
+import type { DistributionLock } from '@xemahq/kernel-contracts/distribution';
+export interface RosterEntry {
+    readonly name: string;
+    readonly tier: string;
+    readonly unitType: RuntimeUnitType;
+    readonly biomeId?: string;
+    readonly servicePath?: string;
+    readonly requiresServerBiomes: readonly string[];
+    readonly imageRef?: string;
+    readonly imageTag?: string;
+}
+export type RosterInclude = 'all' | {
+    readonly tiers?: readonly string[];
+    readonly services?: readonly string[];
+};
+export interface RosterSelection {
+    readonly include: RosterInclude;
+    readonly exclude?: readonly string[];
+    readonly pruned?: ReadonlySet<string>;
+}
+interface LockIndex {
+    readonly byName: ReadonlyMap<string, RosterEntry>;
+    readonly servicesByBiome: ReadonlyMap<string, readonly string[]>;
+    readonly requiresByBiome: ReadonlyMap<string, readonly string[]>;
+    readonly biomeByService: ReadonlyMap<string, string>;
+}
+export declare function buildLockIndex(lock: DistributionLock, imagesByBiome?: ReadonlyMap<string, ImageEntry>): LockIndex;
+export declare function resolveRoster(lock: DistributionLock, selection: RosterSelection, imagesByBiome?: ReadonlyMap<string, ImageEntry>): RosterEntry[];
+export {};
+//# sourceMappingURL=roster.d.ts.map

package/dist/runtime/roster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roster.d.ts","sourceRoot":"","sources":["../../src/runtime/roster.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,uCAAuC,CAAC;AAO3F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IAEnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IAEjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD,MAAM,MAAM,aAAa,GACrB,KAAK,GACL;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAElF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAErC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACvC;AAED,UAAU,SAAS;IAEjB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAElD,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAEjE,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAEjE,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtD;AAGD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,gBAAgB,EACtB,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GAC9C,SAAS,CAyCX;AAQD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,eAAe,EAC1B,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GAC9C,WAAW,EAAE,CA+Cf"}

package/dist/runtime/roster.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildLockIndex = buildLockIndex;
+exports.resolveRoster = resolveRoster;
+const platform_services_1 = require("./platform-services");
+const unit_type_1 = require("./unit-type");
+function buildLockIndex(lock, imagesByBiome) {
+    const byName = new Map();
+    const servicesByBiome = new Map();
+    const requiresByBiome = new Map();
+    const biomeByService = new Map();
+    for (const biome of lock.biomes) {
+        servicesByBiome.set(biome.id, biome.services);
+        requiresByBiome.set(biome.id, biome.requiresServerBiomes ?? []);
+        const image = imagesByBiome?.get(biome.id);
+        for (const svc of biome.services) {
+            biomeByService.set(svc, biome.id);
+            if (!byName.has(svc)) {
+                const entry = {
+                    name: svc,
+                    tier: biome.tier,
+                    unitType: (0, unit_type_1.classifyService)(svc, biome.tier),
+                    biomeId: biome.id,
+                    servicePath: `${biome.path}/api/${svc}`,
+                    requiresServerBiomes: biome.requiresServerBiomes ?? [],
+                    ...(image !== undefined ? { imageRef: image.imageRef, imageTag: image.contentHash } : {}),
+                };
+                byName.set(svc, entry);
+            }
+        }
+    }
+    for (const ps of lock.platformServices) {
+        if (!byName.has(ps.name)) {
+            const servicePath = platform_services_1.PLATFORM_SERVICE_PATHS[ps.name];
+            byName.set(ps.name, {
+                name: ps.name,
+                tier: ps.tier,
+                unitType: (0, unit_type_1.classifyService)(ps.name, ps.tier),
+                requiresServerBiomes: [],
+                ...(servicePath !== undefined ? { servicePath } : {}),
+            });
+        }
+    }
+    return { byName, servicesByBiome, requiresByBiome, biomeByService };
+}
+function resolveRoster(lock, selection, imagesByBiome) {
+    const index = buildLockIndex(lock, imagesByBiome);
+    let selected;
+    if (selection.include === 'all') {
+        selected = new Set(index.byName.keys());
+    }
+    else {
+        selected = new Set();
+        const tiers = new Set(selection.include.tiers ?? []);
+        if (tiers.size > 0) {
+            for (const e of index.byName.values()) {
+                if (tiers.has(e.tier)) {
+                    selected.add(e.name);
+                }
+            }
+        }
+        for (const s of selection.include.services ?? []) {
+            if (index.byName.has(s)) {
+                selected.add(s);
+            }
+        }
+    }
+    expandDependencyClosure(selected, index);
+    for (const ex of selection.exclude ?? []) {
+        selected.delete(ex);
+    }
+    for (const p of selection.pruned ?? []) {
+        selected.delete(p);
+    }
+    return [...selected]
+        .map((name) => {
+        const entry = index.byName.get(name);
+        if (!entry) {
+            throw new Error(`resolveRoster: selected service "${name}" missing from lock index.`);
+        }
+        return entry;
+    })
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+function expandDependencyClosure(selected, index) {
+    const queue = [...selected];
+    while (queue.length > 0) {
+        const svc = queue.shift();
+        if (svc === undefined) {
+            break;
+        }
+        const biome = index.biomeByService.get(svc);
+        if (biome === undefined) {
+            continue;
+        }
+        for (const requiredBiome of index.requiresByBiome.get(biome) ?? []) {
+            for (const depSvc of index.servicesByBiome.get(requiredBiome) ?? []) {
+                if (!selected.has(depSvc)) {
+                    selected.add(depSvc);
+                    queue.push(depSvc);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=roster.js.map

package/dist/runtime/roster.js.map

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

package/dist/runtime/runner/container-runner.d.ts

@@ -0,0 +1,14 @@
+import { ServiceRunnerKind, type RunningService, type ServiceRunner, type StartServiceInput } from './service-runner';
+export interface ContainerRunnerOptions {
+    readonly bin?: string;
+    readonly network: string;
+    readonly containerPort: number;
+}
+export declare class ContainerRunner implements ServiceRunner {
+    private readonly opts;
+    readonly kind = ServiceRunnerKind.Container;
+    private readonly docker;
+    constructor(opts: ContainerRunnerOptions);
+    start(input: StartServiceInput): Promise<RunningService>;
+}
+//# sourceMappingURL=container-runner.d.ts.map

package/dist/runtime/runner/container-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-runner.d.ts","sourceRoot":"","sources":["../../../src/runtime/runner/container-runner.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAY1B,MAAM,WAAW,sBAAsB;IAErC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,qBAAa,eAAgB,YAAW,aAAa;IAIvC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,QAAQ,CAAC,IAAI,+BAA+B;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;gBAEN,IAAI,EAAE,sBAAsB;IAInD,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;CAiD/D"}

package/dist/runtime/runner/container-runner.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContainerRunner = void 0;
+const docker_cli_1 = require("./docker-cli");
+const health_probe_1 = require("./health-probe");
+const service_runner_1 = require("./service-runner");
+class ContainerRunner {
+    opts;
+    kind = service_runner_1.ServiceRunnerKind.Container;
+    docker;
+    constructor(opts) {
+        this.opts = opts;
+        this.docker = new docker_cli_1.DockerCli(opts.bin ?? 'docker');
+    }
+    async start(input) {
+        const { entry, env, port, readinessTimeoutMs } = input;
+        if (!entry.imageRef) {
+            throw new Error(`${entry.name}: no imageRef in images.lock.json — cannot run in the container substrate. ` +
+                `Re-resolve the edition's images.lock or use the native substrate.`);
+        }
+        const image = entry.imageTag ? `${entry.imageRef}:${entry.imageTag}` : entry.imageRef;
+        const args = [
+            'run',
+            '-d',
+            '--name',
+            entry.name,
+            '--label',
+            `${docker_cli_1.LAUNCHER_LABEL}=service`,
+            '--network',
+            this.opts.network,
+            '--restart',
+            'unless-stopped',
+            '-p',
+            `${String(port)}:${String(this.opts.containerPort)}`,
+        ];
+        for (const [k, v] of Object.entries(env)) {
+            args.push('-e', `${k}=${v}`);
+        }
+        args.push(image);
+        const containerId = (await this.docker.run(args)).trim();
+        const url = `http://127.0.0.1:${String(port)}`;
+        try {
+            await (0, health_probe_1.waitForReady)(url, readinessTimeoutMs);
+        }
+        catch (err) {
+            await this.docker.runQuiet(['rm', '-f', entry.name]);
+            throw err;
+        }
+        return {
+            name: entry.name,
+            url,
+            handle: containerId.slice(0, 12),
+            close: async (graceMs) => {
+                await this.docker.runQuiet(['stop', '-t', String(Math.ceil(graceMs / 1000)), entry.name]);
+                await this.docker.runQuiet(['rm', '-f', entry.name]);
+            },
+        };
+    }
+}
+exports.ContainerRunner = ContainerRunner;
+//# sourceMappingURL=container-runner.js.map

package/dist/runtime/runner/container-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-runner.js","sourceRoot":"","sources":["../../../src/runtime/runner/container-runner.ts"],"names":[],"mappings":";;;AAAA,6CAAyD;AACzD,iDAA8C;AAC9C,qDAK0B;AAqB1B,MAAa,eAAe;IAIG;IAHpB,IAAI,GAAG,kCAAiB,CAAC,SAAS,CAAC;IAC3B,MAAM,CAAY;IAEnC,YAA6B,IAA4B;QAA5B,SAAI,GAAJ,IAAI,CAAwB;QACvD,IAAI,CAAC,MAAM,GAAG,IAAI,sBAAS,CAAC,IAAI,CAAC,GAAG,IAAI,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAwB;QAClC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,KAAK,CAAC;QACvD,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,CAAC,IAAI,6EAA6E;gBACxF,mEAAmE,CACtE,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;QAEtF,MAAM,IAAI,GAAG;YACX,KAAK;YACL,IAAI;YACJ,QAAQ;YACR,KAAK,CAAC,IAAI;YACV,SAAS;YACT,GAAG,2BAAc,UAAU;YAC3B,WAAW;YACX,IAAI,CAAC,IAAI,CAAC,OAAO;YACjB,WAAW;YACX,gBAAgB;YAChB,IAAI;YACJ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE;SACrD,CAAC;QACF,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEjB,MAAM,WAAW,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACzD,MAAM,GAAG,GAAG,oBAAoB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,IAAA,2BAAY,EAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACrD,MAAM,GAAG,CAAC;QACZ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG;YACH,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YAChC,KAAK,EAAE,KAAK,EAAE,OAAe,EAAiB,EAAE;gBAC9C,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC1F,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YACvD,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAzDD,0CAyDC"}

package/dist/runtime/runner/docker-cli.d.ts

@@ -0,0 +1,11 @@
+export declare const LAUNCHER_LABEL = "xema.launcher";
+export declare class DockerCli {
+    private readonly bin;
+    constructor(bin?: string);
+    run(args: readonly string[]): Promise<string>;
+    runQuiet(args: readonly string[]): Promise<string>;
+    available(): Promise<boolean>;
+    ensureNetwork(name: string): Promise<void>;
+    launcherContainers(): Promise<string[]>;
+}
+//# sourceMappingURL=docker-cli.d.ts.map

package/dist/runtime/runner/docker-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-cli.d.ts","sourceRoot":"","sources":["../../../src/runtime/runner/docker-cli.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAE9C,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,GAAE,MAAiB;IAEnD,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAavC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IASlD,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAM7B,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1C,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAW9C"}

package/dist/runtime/runner/docker-cli.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DockerCli = exports.LAUNCHER_LABEL = void 0;
+const node_child_process_1 = require("node:child_process");
+exports.LAUNCHER_LABEL = 'xema.launcher';
+class DockerCli {
+    bin;
+    constructor(bin = 'docker') {
+        this.bin = bin;
+    }
+    run(args) {
+        return new Promise((resolve, reject) => {
+            (0, node_child_process_1.execFile)(this.bin, [...args], { maxBuffer: 32 * 1024 * 1024 }, (err, stdout, stderr) => {
+                if (err) {
+                    reject(new Error(`${this.bin} ${args.join(' ')} failed: ${stderr || err.message}`));
+                    return;
+                }
+                resolve(stdout);
+            });
+        });
+    }
+    async runQuiet(args) {
+        try {
+            return await this.run(args);
+        }
+        catch {
+            return '';
+        }
+    }
+    async available() {
+        const out = await this.runQuiet(['version', '--format', '{{.Server.Version}}']);
+        return out.trim().length > 0;
+    }
+    async ensureNetwork(name) {
+        const existing = await this.runQuiet(['network', 'ls', '--filter', `name=^${name}$`, '--format', '{{.Name}}']);
+        if (!existing.split('\n').map((l) => l.trim()).includes(name)) {
+            await this.runQuiet(['network', 'create', name]);
+        }
+    }
+    async launcherContainers() {
+        const out = await this.runQuiet([
+            'ps',
+            '-a',
+            '--filter',
+            `label=${exports.LAUNCHER_LABEL}`,
+            '--format',
+            '{{.Names}}',
+        ]);
+        return out.split('\n').map((l) => l.trim()).filter((l) => l.length > 0);
+    }
+}
+exports.DockerCli = DockerCli;
+//# sourceMappingURL=docker-cli.js.map

package/dist/runtime/runner/docker-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-cli.js","sourceRoot":"","sources":["../../../src/runtime/runner/docker-cli.ts"],"names":[],"mappings":";;;AAAA,2DAA8C;AAUjC,QAAA,cAAc,GAAG,eAAe,CAAC;AAE9C,MAAa,SAAS;IACS;IAA7B,YAA6B,MAAc,QAAQ;QAAtB,QAAG,GAAH,GAAG,CAAmB;IAAG,CAAC;IAEvD,GAAG,CAAC,IAAuB;QACzB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAA,6BAAQ,EAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBACrF,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;oBACpF,OAAO;gBACT,CAAC;gBACD,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAGD,KAAK,CAAC,QAAQ,CAAC,IAAuB;QACpC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAGD,KAAK,CAAC,SAAS;QACb,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC,CAAC;QAChF,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/B,CAAC;IAGD,KAAK,CAAC,aAAa,CAAC,IAAY;QAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,IAAI,GAAG,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;QAC/G,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAGD,KAAK,CAAC,kBAAkB;QACtB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC;YAC9B,IAAI;YACJ,IAAI;YACJ,UAAU;YACV,SAAS,sBAAc,EAAE;YACzB,UAAU;YACV,YAAY;SACb,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1E,CAAC;CACF;AAlDD,8BAkDC"}

package/dist/runtime/runner/health-probe.d.ts

@@ -0,0 +1,2 @@
+export declare function waitForReady(baseUrl: string, timeoutMs: number, intervalMs?: number, isAlive?: () => boolean): Promise<void>;
+//# sourceMappingURL=health-probe.d.ts.map

package/dist/runtime/runner/health-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-probe.d.ts","sourceRoot":"","sources":["../../../src/runtime/runner/health-probe.ts"],"names":[],"mappings":"AAMA,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,SAAM,EAChB,OAAO,CAAC,EAAE,MAAM,OAAO,GACtB,OAAO,CAAC,IAAI,CAAC,CAcf"}