@empire-builder-kit/nx 1.0.0-beta.9 → 1.0.0-rc.2

package/src/local-dev/fleet-state.js

@@ -0,0 +1,297 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FLEET_OPERATION_STATES = exports.FLEET_CLEANUP_STATES = exports.FLEET_ROUTE_STATES = exports.FLEET_STATE_FILE = exports.FLEET_STATE_SCHEMA_VERSION = void 0;
+exports.validateFleetStateRecord = validateFleetStateRecord;
+exports.transitionFleetSliceState = transitionFleetSliceState;
+exports.fleetStatePath = fleetStatePath;
+exports.readFleetState = readFleetState;
+exports.writeFleetState = writeFleetState;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const contract_validation_js_1 = require("./contract-validation.js");
+const errors_js_1 = require("./errors.js");
+const control_contract_js_1 = require("./control-contract.js");
+const fleet_lock_js_1 = require("./fleet-lock.js");
+const private_state_js_1 = require("./private-state.js");
+const personal_stage_js_1 = require("./personal-stage.js");
+exports.FLEET_STATE_SCHEMA_VERSION = 1;
+exports.FLEET_STATE_FILE = 'control-state.json';
+exports.FLEET_ROUTE_STATES = [
+    'remote',
+    'starting',
+    'ready',
+    'unavailable',
+];
+exports.FLEET_CLEANUP_STATES = [
+    'not-declared',
+    'pending',
+    'succeeded',
+    'failed',
+];
+exports.FLEET_OPERATION_STATES = [
+    'accepted',
+    'running',
+    'succeeded',
+    'failed',
+];
+const ALLOWED_ROUTE_TRANSITIONS = {
+    ready: ['unavailable'],
+    remote: ['starting'],
+    starting: ['ready', 'unavailable'],
+    unavailable: ['ready', 'remote', 'starting'],
+};
+function stateError(message) {
+    throw new errors_js_1.LocalDevContractError('invalid-state', message);
+}
+function validateProcessIdentity(value) {
+    (0, contract_validation_js_1.assertRecord)(value, 'Fleet state supervisor');
+    (0, contract_validation_js_1.assertExactProperties)(value, ['pid', 'processIdentity', 'startedAt'], [], 'Fleet state supervisor');
+    return {
+        pid: (0, contract_validation_js_1.requireInteger)(value.pid, 'Fleet state supervisor pid', 1, 2_147_483_647),
+        processIdentity: (0, contract_validation_js_1.requireBoundedString)(value.processIdentity, 'Fleet state supervisor processIdentity', { maximumLength: 128, pattern: contract_validation_js_1.LOCAL_DEV_TOKEN_PATTERN }),
+        startedAt: (0, contract_validation_js_1.requireIsoTimestamp)(value.startedAt, 'Fleet state supervisor startedAt'),
+    };
+}
+function validateSliceState(value) {
+    (0, contract_validation_js_1.assertRecord)(value, 'Fleet Slice state');
+    (0, contract_validation_js_1.assertExactProperties)(value, [
+        'adapterVersion',
+        'cleanup',
+        'lastTransitionAt',
+        'logSequence',
+        'name',
+        'port',
+        'restartAttempts',
+        'routeState',
+        'selected',
+    ], ['runnerGeneration'], 'Fleet Slice state');
+    if (value.adapterVersion !== 1 && value.adapterVersion !== 2) {
+        return stateError('Fleet Slice adapterVersion must be 1 or 2.');
+    }
+    if (!exports.FLEET_CLEANUP_STATES.includes(value.cleanup)) {
+        return stateError('Fleet Slice cleanup state is invalid.');
+    }
+    if (!exports.FLEET_ROUTE_STATES.includes(value.routeState)) {
+        return stateError('Fleet Slice route state is invalid.');
+    }
+    if (typeof value.selected !== 'boolean') {
+        return stateError('Fleet Slice selected must be boolean.');
+    }
+    const routeState = value.routeState;
+    if ((routeState === 'remote') === value.selected) {
+        return stateError('Fleet Slice remote state must be unselected and every local state must remain selected.');
+    }
+    const result = {
+        adapterVersion: value.adapterVersion,
+        cleanup: value.cleanup,
+        lastTransitionAt: (0, contract_validation_js_1.requireIsoTimestamp)(value.lastTransitionAt, 'Fleet Slice lastTransitionAt'),
+        logSequence: (0, contract_validation_js_1.requireInteger)(value.logSequence, 'Fleet Slice logSequence', 0, Number.MAX_SAFE_INTEGER),
+        name: (0, fleet_lock_js_1.validateFleetIdentitySlug)(value.name, 'Fleet Slice name'),
+        port: (0, contract_validation_js_1.requireInteger)(value.port, 'Fleet Slice port', 1, 65_535),
+        restartAttempts: (0, contract_validation_js_1.requireInteger)(value.restartAttempts, 'Fleet Slice restartAttempts', 0, 10_000),
+        routeState,
+        selected: value.selected,
+    };
+    if (value.runnerGeneration !== undefined) {
+        result.runnerGeneration = (0, contract_validation_js_1.requireBoundedString)(value.runnerGeneration, 'Fleet Slice runnerGeneration', { maximumLength: 128, pattern: contract_validation_js_1.LOCAL_DEV_TOKEN_PATTERN });
+    }
+    return result;
+}
+function validateOperation(value) {
+    (0, contract_validation_js_1.assertRecord)(value, 'Fleet operation state');
+    (0, contract_validation_js_1.assertExactProperties)(value, ['acceptedAt', 'command', 'id', 'idempotencyKey', 'slices', 'state'], ['completedAt', 'failureClassification'], 'Fleet operation state');
+    if (value.command !== 'up' &&
+        value.command !== 'down' &&
+        value.command !== 'restart') {
+        return stateError('Fleet operation command is invalid.');
+    }
+    if (!exports.FLEET_OPERATION_STATES.includes(value.state)) {
+        return stateError('Fleet operation state is invalid.');
+    }
+    if (!Array.isArray(value.slices) || value.slices.length > 64) {
+        return stateError('Fleet operation slices must be a bounded array.');
+    }
+    const slices = value.slices.map((slice) => (0, fleet_lock_js_1.validateFleetIdentitySlug)(slice, 'Fleet operation Slice'));
+    if (new Set(slices).size !== slices.length) {
+        return stateError('Fleet operation slices must not contain duplicates.');
+    }
+    const result = {
+        acceptedAt: (0, contract_validation_js_1.requireIsoTimestamp)(value.acceptedAt, 'Fleet operation acceptedAt'),
+        command: value.command,
+        id: (0, contract_validation_js_1.requireBoundedString)(value.id, 'Fleet operation id', {
+            maximumLength: 128,
+            pattern: contract_validation_js_1.LOCAL_DEV_TOKEN_PATTERN,
+        }),
+        idempotencyKey: (0, contract_validation_js_1.requireBoundedString)(value.idempotencyKey, 'Fleet operation idempotencyKey', { maximumLength: 128, pattern: contract_validation_js_1.LOCAL_DEV_TOKEN_PATTERN }),
+        slices,
+        state: value.state,
+    };
+    if (value.completedAt !== undefined) {
+        result.completedAt = (0, contract_validation_js_1.requireIsoTimestamp)(value.completedAt, 'Fleet operation completedAt');
+    }
+    if (value.failureClassification !== undefined) {
+        const classification = (0, fleet_lock_js_1.validateFleetIdentitySlug)(value.failureClassification, 'Fleet operation failureClassification');
+        if (!errors_js_1.LOCAL_DEV_FAILURE_CLASSIFICATIONS.includes(classification)) {
+            return stateError('Fleet operation failureClassification is unsupported.');
+        }
+        result.failureClassification = classification;
+    }
+    const terminal = result.state === 'succeeded' || result.state === 'failed';
+    if (terminal !== (result.completedAt !== undefined)) {
+        return stateError('Fleet operation terminal state and completedAt must agree.');
+    }
+    if ((result.state === 'failed') !==
+        (result.failureClassification !== undefined)) {
+        return stateError('Fleet operation failure state and classification must agree.');
+    }
+    if (result.completedAt !== undefined &&
+        Date.parse(result.completedAt) < Date.parse(result.acceptedAt)) {
+        return stateError('Fleet operation completedAt must not precede acceptedAt.');
+    }
+    return result;
+}
+function requireAbsolutePath(value, label) {
+    const path = (0, contract_validation_js_1.requireBoundedString)(value, label, { maximumLength: 4096 });
+    if (!(0, node_path_1.isAbsolute)(path))
+        return stateError(`${label} must be absolute.`);
+    return path;
+}
+function requireHttpsOrigin(value, label) {
+    const raw = (0, contract_validation_js_1.requireBoundedString)(value, label, { maximumLength: 2_048 });
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        return stateError(`${label} must be an exact credential-free HTTPS origin.`);
+    }
+    if (url.protocol !== 'https:' ||
+        url.origin !== raw ||
+        url.username ||
+        url.password) {
+        return stateError(`${label} must be an exact credential-free HTTPS origin.`);
+    }
+    return raw;
+}
+function validateFleetStateRecord(value) {
+    (0, contract_validation_js_1.assertRecord)(value, 'Fleet state');
+    (0, contract_validation_js_1.assertExactProperties)(value, [
+        'configurationFingerprint',
+        'contextDigest',
+        'controlProtocolVersion',
+        'createdAt',
+        'fleetId',
+        'frameworkVersion',
+        'gitCommonDirectory',
+        'heartbeatAt',
+        'identitySource',
+        'nxVersion',
+        'operations',
+        'origin',
+        'resolvedStage',
+        'routerOrigin',
+        'routerSource',
+        'schemaVersion',
+        'sessionGeneration',
+        'slices',
+        'supervisor',
+        'workspaceRealpath',
+    ], [], 'Fleet state');
+    if (value.schemaVersion !== exports.FLEET_STATE_SCHEMA_VERSION ||
+        value.controlProtocolVersion !== control_contract_js_1.FLEET_CONTROL_PROTOCOL_VERSION ||
+        value.identitySource !== 'os-account') {
+        return stateError('Fleet state schema, control protocol, or identity source is unsupported.');
+    }
+    if (!Array.isArray(value.slices) || value.slices.length > 128) {
+        return stateError('Fleet state slices must be a bounded array.');
+    }
+    if (!Array.isArray(value.operations) || value.operations.length > 128) {
+        return stateError('Fleet state operations must be a bounded array.');
+    }
+    const slices = value.slices.map(validateSliceState);
+    const operations = value.operations.map((operation) => validateOperation(operation));
+    if (new Set(slices.map(({ name }) => name)).size !== slices.length) {
+        return stateError('Fleet state contains duplicate Slices.');
+    }
+    if (new Set(operations.map(({ id }) => id)).size !== operations.length) {
+        return stateError('Fleet state contains duplicate operation ids.');
+    }
+    if (new Set(operations.map(({ idempotencyKey }) => idempotencyKey)).size !==
+        operations.length) {
+        return stateError('Fleet state contains duplicate operation idempotency keys.');
+    }
+    const createdAt = (0, contract_validation_js_1.requireIsoTimestamp)(value.createdAt, 'Fleet createdAt');
+    const heartbeatAt = (0, contract_validation_js_1.requireIsoTimestamp)(value.heartbeatAt, 'Fleet heartbeatAt');
+    if (Date.parse(heartbeatAt) < Date.parse(createdAt)) {
+        return stateError('Fleet heartbeatAt must not precede createdAt.');
+    }
+    return {
+        configurationFingerprint: (0, contract_validation_js_1.requireBoundedString)(value.configurationFingerprint, 'Fleet configurationFingerprint', { pattern: contract_validation_js_1.LOCAL_DEV_SHA256_PATTERN }),
+        contextDigest: (0, contract_validation_js_1.requireBoundedString)(value.contextDigest, 'Fleet contextDigest', { pattern: contract_validation_js_1.LOCAL_DEV_SHA256_PATTERN }),
+        controlProtocolVersion: control_contract_js_1.FLEET_CONTROL_PROTOCOL_VERSION,
+        createdAt,
+        fleetId: (0, contract_validation_js_1.requireBoundedString)(value.fleetId, 'Fleet fleetId', {
+            maximumLength: 63,
+            pattern: /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/,
+        }),
+        frameworkVersion: (0, contract_validation_js_1.requireBoundedString)(value.frameworkVersion, 'Fleet frameworkVersion', { maximumLength: 128 }),
+        gitCommonDirectory: requireAbsolutePath(value.gitCommonDirectory, 'Fleet gitCommonDirectory'),
+        heartbeatAt,
+        identitySource: 'os-account',
+        nxVersion: (0, contract_validation_js_1.requireBoundedString)(value.nxVersion, 'Fleet nxVersion', {
+            maximumLength: 128,
+            pattern: /^[0-9A-Za-z][0-9A-Za-z.+-]{0,127}$/,
+        }),
+        operations,
+        origin: requireHttpsOrigin(value.origin, 'Fleet origin'),
+        resolvedStage: (() => {
+            const stage = (0, fleet_lock_js_1.validateFleetIdentitySlug)(value.resolvedStage, 'Fleet resolvedStage');
+            if (!(0, personal_stage_js_1.isFrameworkPersonalStage)(stage)) {
+                return stateError('Fleet resolvedStage must be a framework-derived personal stage.');
+            }
+            return stage;
+        })(),
+        routerOrigin: requireHttpsOrigin(value.routerOrigin, 'Fleet Router origin'),
+        routerSource: value.routerSource === 'context-override' ||
+            value.routerSource === 'foundation-discovery'
+            ? value.routerSource
+            : stateError('Fleet Router source is invalid.'),
+        schemaVersion: exports.FLEET_STATE_SCHEMA_VERSION,
+        sessionGeneration: (0, contract_validation_js_1.requireBoundedString)(value.sessionGeneration, 'Fleet sessionGeneration', { maximumLength: 128, pattern: contract_validation_js_1.LOCAL_DEV_TOKEN_PATTERN }),
+        slices,
+        supervisor: validateProcessIdentity(value.supervisor),
+        workspaceRealpath: requireAbsolutePath(value.workspaceRealpath, 'Fleet workspaceRealpath'),
+    };
+}
+function transitionFleetSliceState(value, next, transitionedAt = new Date().toISOString()) {
+    const current = validateSliceState(value);
+    if (current.routeState === next)
+        return current;
+    if (!ALLOWED_ROUTE_TRANSITIONS[current.routeState].includes(next)) {
+        return stateError(`Fleet Slice route cannot transition directly from ${current.routeState} to ${next}.`);
+    }
+    return validateSliceState({
+        ...current,
+        lastTransitionAt: transitionedAt,
+        routeState: next,
+        selected: next !== 'remote',
+    });
+}
+function fleetStatePath(sessionDirectory) {
+    if (!(0, node_path_1.isAbsolute)(sessionDirectory)) {
+        return stateError('Fleet session directory must be absolute.');
+    }
+    return (0, node_path_1.join)(sessionDirectory, exports.FLEET_STATE_FILE);
+}
+function readFleetState(sessionDirectory, security = {}) {
+    const path = fleetStatePath(sessionDirectory);
+    if (!(0, node_fs_1.existsSync)(path))
+        return undefined;
+    return validateFleetStateRecord(JSON.parse((0, private_state_js_1.readPrivateFile)(path, security).toString('utf8')));
+}
+function writeFleetState(sessionDirectory, value, security = {}) {
+    const state = validateFleetStateRecord(value);
+    (0, private_state_js_1.atomicWritePrivateFile)(fleetStatePath(sessionDirectory), `${JSON.stringify(state, null, 2)}\n`, security);
+    return state;
+}
+//# sourceMappingURL=fleet-state.js.map

package/src/local-dev/fleet-state.js.map

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

package/src/local-dev/fleet-supervisor-daemon.d.ts

@@ -0,0 +1 @@
+export declare function runFleetSupervisorDaemon(startupPath: string): Promise<void>;

package/src/local-dev/fleet-supervisor-daemon.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runFleetSupervisorDaemon = runFleetSupervisorDaemon;
+const fleet_runtime_js_1 = require("./fleet-runtime.js");
+async function runFleetSupervisorDaemon(startupPath) {
+    const runtime = await (0, fleet_runtime_js_1.startFleetRuntime)(startupPath);
+    let handlingSignal = false;
+    const stop = async () => {
+        if (handlingSignal)
+            return;
+        handlingSignal = true;
+        try {
+            const selected = runtime.session.selectedSlices();
+            if (selected.length > 0)
+                await runtime.session.down(selected);
+            await runtime.session.closeProxyWhenEmpty();
+            await runtime.supervisor.stopGracefully();
+        }
+        catch (error) {
+            handlingSignal = false;
+            process.stderr.write(`[ebk-supervisor] graceful signal cleanup failed; ownership was retained: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+    };
+    process.on('SIGINT', () => void stop());
+    process.on('SIGTERM', () => void stop());
+    await runtime.supervisor.waitUntilStopped();
+}
+if (require.main === module) {
+    const startupPath = process.env.EBK_FLEET_STARTUP_PATH;
+    if (!startupPath) {
+        process.stderr.write('[ebk-supervisor] EBK_FLEET_STARTUP_PATH is required.\n');
+        process.exitCode = 1;
+    }
+    else {
+        void runFleetSupervisorDaemon(startupPath).catch((error) => {
+            process.stderr.write(`[ebk-supervisor] ${error instanceof Error ? error.message : String(error)}\n`);
+            process.exitCode = 1;
+        });
+    }
+}
+//# sourceMappingURL=fleet-supervisor-daemon.js.map

package/src/local-dev/fleet-supervisor-daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-supervisor-daemon.js","sourceRoot":"","sources":["../../../../../packages/nx/src/local-dev/fleet-supervisor-daemon.ts"],"names":[],"mappings":";;AAEA,4DAyBC;AA3BD,yDAAuD;AAEhD,KAAK,UAAU,wBAAwB,CAC5C,WAAmB;IAEnB,MAAM,OAAO,GAAG,MAAM,IAAA,oCAAiB,EAAC,WAAW,CAAC,CAAC;IACrD,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACtB,IAAI,cAAc;YAAE,OAAO;QAC3B,cAAc,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YAClD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9D,MAAM,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;YAC5C,MAAM,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,cAAc,GAAG,KAAK,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4EACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,IAAI,CACL,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC;AAC9C,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACvD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wDAAwD,CACzD,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,KAAK,wBAAwB,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACzD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oBACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,IAAI,CACL,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/src/local-dev/fleet-supervisor.d.ts

@@ -0,0 +1,52 @@
+import { type FleetControlRequest } from './control-contract.js';
+import { type FleetControlHandler } from './fleet-ipc.js';
+import { type FleetProcessIdentity } from './fleet-lock.js';
+import { type FleetSliceState, type FleetStateRecord } from './fleet-state.js';
+import { type PrivateStateSecurity } from './private-state.js';
+import type { FleetRuntimePaths } from './runtime-paths.js';
+export interface FleetSupervisorTargetResult {
+    changed: boolean;
+    name: string;
+    previousState: string;
+    state: string;
+}
+export interface FleetSupervisorMutationHost {
+    allSlices(): readonly string[];
+    closeProxyWhenEmpty(): Promise<boolean>;
+    down(slices: readonly string[]): Promise<FleetSupervisorTargetResult[]>;
+    restart(slices: readonly string[]): Promise<FleetSupervisorTargetResult[]>;
+    selectedSlices(): readonly string[];
+    sliceStates(): ReadonlyArray<Pick<FleetSliceState, 'cleanup' | 'name' | 'restartAttempts' | 'routeState' | 'runnerGeneration' | 'selected'>>;
+    up(slices: readonly string[]): Promise<FleetSupervisorTargetResult[]>;
+}
+interface ControlServerLike {
+    close(): Promise<void>;
+    listen(): Promise<void>;
+}
+export interface FleetSupervisorEffects {
+    capability?: () => string;
+    controlServer?: (path: string, capabilityDigest: string, handler: FleetControlHandler) => ControlServerLike;
+    generation?: () => string;
+    now?: () => Date;
+    operationId?: () => string;
+    processIdentity?: () => FleetProcessIdentity;
+}
+export interface FleetSupervisorOptions {
+    heartbeatIntervalMs?: number;
+    host: FleetSupervisorMutationHost;
+    initialState: FleetStateRecord;
+    paths: FleetRuntimePaths;
+    security?: PrivateStateSecurity;
+    shutdownGraceMs?: number;
+}
+export declare class FleetSupervisor {
+    #private;
+    constructor(options: FleetSupervisorOptions, effects?: FleetSupervisorEffects);
+    get state(): FleetStateRecord;
+    start(): Promise<void>;
+    handle(request: FleetControlRequest): Promise<unknown>;
+    waitForIdle(): Promise<void>;
+    waitUntilStopped(): Promise<void>;
+    stopGracefully(): Promise<void>;
+}
+export {};