@xemahq/composed-process-host 0.0.0-stage → 0.2.0

package/dist/seed-processes.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SeedProcessNameClaimedError = void 0;
+exports.seedProcessesOf = seedProcessesOf;
+exports.seedProcessNamed = seedProcessNamed;
+exports.seedPlatformServicesOf = seedPlatformServicesOf;
+const process_topology_1 = require("@xemahq/contracts/process-topology");
+const xema_service_nest_1 = require("@xemahq/xema-service-nest");
+const SEED_PROCESS_PREFIX = xema_service_nest_1.SEED_SUPERVISOR_DEFAULTS.processName;
+class SeedProcessNameClaimedError extends Error {
+    serviceName;
+    constructor(serviceName) {
+        super(`The seed closure member service "${serviceName}" is in the seed's process-name namespace ("${SEED_PROCESS_PREFIX}" or "${SEED_PROCESS_PREFIX}-..."), which only the seed's own processes may use.`);
+        this.serviceName = serviceName;
+        this.name = 'SeedProcessNameClaimedError';
+    }
+}
+exports.SeedProcessNameClaimedError = SeedProcessNameClaimedError;
+function partitionKeyOf(facts) {
+    return {
+        trustDomain: (0, process_topology_1.resolveTrustDomain)(facts.biomeId, facts.origin, undefined, facts.trustCeiling),
+        credentialCustody: facts.processFacts?.credentialCustody === true,
+        ...(facts.processFacts?.exclusive === undefined ? {} : { exclusiveMember: facts.componentKey }),
+    };
+}
+function partition(closure) {
+    const byName = new Map();
+    for (const facts of closure.memberFacts) {
+        const key = partitionKeyOf(facts);
+        const name = (0, xema_service_nest_1.seedProcessName)(key);
+        const held = byName.get(name) ?? { name, key, memberKeys: [] };
+        held.memberKeys.push((0, process_topology_1.processMemberKey)(facts));
+        byName.set(name, held);
+    }
+    return [...byName.values()];
+}
+function bootOrder(names, after) {
+    const order = [];
+    const remaining = new Set(names);
+    while (remaining.size > 0) {
+        const ready = [...remaining].filter((name) => [...(after.get(name) ?? [])].every((dependency) => !remaining.has(dependency))).sort();
+        const next = ready[0];
+        if (next === undefined) {
+            throw new Error(`The seed's processes require each other at startup, so none can start first: ${[...remaining].sort().join(', ')}. ` +
+                'A startupRequires edge between two seed processes must point one way.');
+        }
+        order.push(next);
+        remaining.delete(next);
+    }
+    return order;
+}
+function seedProcessesOf(closure) {
+    const claimed = closure.members.find((entry) => (0, xema_service_nest_1.isSeedProcessName)(entry.serviceName));
+    if (claimed !== undefined) {
+        throw new SeedProcessNameClaimedError(claimed.serviceName);
+    }
+    const entries = new Map(closure.members.map((entry) => [(0, process_topology_1.processMemberKey)(entry.member), entry]));
+    const factKeys = new Set(closure.memberFacts.map((facts) => (0, process_topology_1.processMemberKey)(facts)));
+    const unpaired = [
+        ...[...entries.keys()].filter((key) => !factKeys.has(key)),
+        ...[...factKeys].filter((key) => !entries.has(key)),
+    ];
+    if (unpaired.length > 0) {
+        throw new Error(`The seed closure pairs no entry with facts (or no facts with an entry) for ${unpaired.sort().join(', ')}.`);
+    }
+    const partitions = partition(closure);
+    const processOfService = new Map();
+    for (const held of partitions) {
+        for (const key of held.memberKeys) {
+            processOfService.set(entries.get(key).serviceName, held.name);
+        }
+    }
+    const after = new Map(partitions.map((held) => [
+        held.name,
+        new Set(held.memberKeys
+            .flatMap((key) => entries.get(key).startupRequires)
+            .map((service) => processOfService.get(service))
+            .filter((process) => process !== undefined && process !== held.name)),
+    ]));
+    const order = bootOrder(partitions.map((held) => held.name), after);
+    const definitions = partitions.map((held) => ({
+        name: held.name,
+        members: held.memberKeys.map((key) => entries.get(key).member),
+        replicas: { min: 1, max: 1 },
+        listen: { port: xema_service_nest_1.SEED_SUPERVISOR_DEFAULTS.probePort },
+    }));
+    (0, process_topology_1.assertProcessTopology)({
+        topology: { schemaVersion: 1, distributionId: SEED_PROCESS_PREFIX, processes: definitions },
+        memberFacts: closure.memberFacts,
+    });
+    const byName = new Map(partitions.map((held) => [held.name, held]));
+    return order.map((name) => {
+        const held = byName.get(name);
+        const members = held.memberKeys.map((key) => entries.get(key));
+        return {
+            name,
+            trustDomain: held.key.trustDomain,
+            credentialCustody: held.key.credentialCustody,
+            seedPartition: held.key,
+            members: members.map((entry) => entry.member),
+            serviceNames: members.map((entry) => entry.serviceName),
+            requiredEnvVars: Object.fromEntries(members.map((entry) => [(0, process_topology_1.processMemberKey)(entry.member), entry.requiredEnvVars])),
+            startsAfter: [...(after.get(name) ?? [])].sort(),
+            hostsRoot: members.some((entry) => entry.member.biomeId === closure.root),
+        };
+    });
+}
+function seedProcessNamed(processes, name) {
+    const found = processes.find((process) => process.name === name);
+    if (found === undefined) {
+        throw new Error(`The seed closure derives no process "${name}"; its processes are ${processes.map((process) => process.name).join(', ')}.`);
+    }
+    return found;
+}
+function seedPlatformServicesOf(closure) {
+    const served = new Set(closure.members.map((entry) => entry.serviceName));
+    return [
+        ...new Set(closure.members
+            .flatMap((entry) => entry.startupRequires)
+            .filter((service) => !served.has(service))),
+    ].sort();
+}
+//# sourceMappingURL=seed-processes.js.map

package/dist/seed-processes.js.map

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

package/package.json

@@ -1,6 +1,73 @@
 {
   "name": "@xemahq/composed-process-host",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "The one host of a composed process: runs the supervisor and the executor with their real adapters (Biome Host registry, OCI bundle store, event hub, host ABI) and carries the seed's build-derived bootstrap closure.",
+  "license": "LicenseRef-Xema-BSL-1.1",
+  "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
+  "homepage": "https://xema.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xema-dev/xema-base.git",
+    "directory": "packages/sdks/composed-process-host"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "xema-composed-process": "bin/xema-composed-process.cjs"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "scripts"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "xema-source": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@xemahq/event-hub-client": "^11.0.0",
+    "zod": "^4.6.1",
+    "@xemahq/biome-bundle-pack": "^0.2.0",
+    "@xemahq/biome-host-internal-api-client": "^0.8.0",
+    "@xemahq/contracts": "^0.120.0",
+    "@xemahq/installation-tenancy": "^0.2.0",
+    "@xemahq/kernel-state-runtime": "^0.8.3",
+    "@xemahq/oci-closure": "^0.1.0",
+    "@xemahq/service-registry-nest": "^1.4.0",
+    "@xemahq/xema-service-nest": "^20.0.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "25.2.3",
+    "eslint": "^9.39.4",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.9",
+    "typescript": "5.9.3",
+    "@xemahq/eslint-config": "^0.14.3",
+    "authorization-api": "^0.1.1",
+    "biome-fetcher-api": "^0.1.0",
+    "biome-host-api": "^0.1.1",
+    "space-registry-api": "^0.1.0",
+    "xema-capability-router": "^0.1.0",
+    "org-database-pool-api": "^0.1.0",
+    "capability-registry-api": "^0.1.1"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json && node scripts/write-seed-closure.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "test": "jest --config jest.config.ts"
+  },
+  "xemaRelease": {
+    "sourceDigest": "sha256:10969f233abbebd5d5bdc8f43d5cffb542bdc1777f2da256135b29070a0f9017",
+    "sha": "a32f8f5509b7ea239deb38216e4996e6286b10e8"
+  }
+}

package/scripts/write-seed-closure.mjs

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+// The package's build step: writes dist/seed-closure.json, the seed's bootstrap closure (members, their
+// composition facts and built entries), by the aggregator's one derivation. The build commit is the
+// repository's HEAD; the repository is the one this package's manifest names.
+import { execFileSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+const repositoryUrl = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8')).repository.url;
+const repository = /github\.com[/:]([^/]+\/[^/.]+)(?:\.git)?$/.exec(repositoryUrl)?.[1];
+if (repository === undefined) {throw new Error(`cannot read the build-source repository from "${repositoryUrl}"`);}
+const commit = execFileSync('git', ['rev-parse', 'HEAD'], { cwd: packageRoot, encoding: 'utf8' }).trim();
+
+execFileSync(
+  process.execPath,
+  [
+    join(packageRoot, '..', '..', '..', 'tooling', 'codegen', 'derive-bootstrap-closure.mjs'),
+    '--seed-closure', join(packageRoot, 'dist', 'seed-closure.json'),
+    '--build-source', repository,
+    '--commit', commit,
+  ],
+  { stdio: 'inherit' },
+);

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.