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

package/src/local-dev/slice-claim.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SLICE_CLAIM_SCHEMA_VERSION = void 0;
+exports.validateSliceClaimRecord = validateSliceClaimRecord;
+exports.sliceClaimPath = sliceClaimPath;
+exports.inspectSliceClaim = inspectSliceClaim;
+exports.acquireSliceClaims = acquireSliceClaims;
+exports.releaseSliceClaims = releaseSliceClaims;
+exports.heartbeatSliceClaim = heartbeatSliceClaim;
+exports.classifySliceClaim = classifySliceClaim;
+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 fleet_lock_js_1 = require("./fleet-lock.js");
+const private_state_js_1 = require("./private-state.js");
+exports.SLICE_CLAIM_SCHEMA_VERSION = 1;
+function requireSlice(value) {
+    return (0, fleet_lock_js_1.validateFleetIdentitySlug)(value, 'Slice claim slice');
+}
+function requireFleetId(value) {
+    return (0, contract_validation_js_1.requireBoundedString)(value, 'Slice claim fleetId', {
+        maximumLength: 63,
+        pattern: /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/,
+    });
+}
+function requireGeneration(value) {
+    return (0, contract_validation_js_1.requireBoundedString)(value, 'Slice claim sessionGeneration', {
+        maximumLength: 128,
+        pattern: contract_validation_js_1.LOCAL_DEV_TOKEN_PATTERN,
+    });
+}
+function validateSliceClaimRecord(value) {
+    try {
+        (0, contract_validation_js_1.assertRecord)(value, 'Slice claim');
+        (0, contract_validation_js_1.assertExactProperties)(value, [
+            'acquiredAt',
+            'fleetId',
+            'heartbeatAt',
+            'owner',
+            'schemaVersion',
+            'sessionGeneration',
+            'slice',
+        ], [], 'Slice claim');
+        if (value.schemaVersion !== exports.SLICE_CLAIM_SCHEMA_VERSION) {
+            throw new Error(`schemaVersion must be ${exports.SLICE_CLAIM_SCHEMA_VERSION}`);
+        }
+        const acquiredAt = (0, contract_validation_js_1.requireIsoTimestamp)(value.acquiredAt, 'Slice claim acquiredAt');
+        const heartbeatAt = (0, contract_validation_js_1.requireIsoTimestamp)(value.heartbeatAt, 'Slice claim heartbeatAt');
+        if (Date.parse(heartbeatAt) < Date.parse(acquiredAt)) {
+            throw new Error('heartbeatAt must not precede acquiredAt');
+        }
+        return {
+            acquiredAt,
+            fleetId: requireFleetId(value.fleetId),
+            heartbeatAt,
+            owner: (0, fleet_lock_js_1.validateFleetProcessIdentity)(value.owner),
+            schemaVersion: exports.SLICE_CLAIM_SCHEMA_VERSION,
+            sessionGeneration: requireGeneration(value.sessionGeneration),
+            slice: requireSlice(value.slice),
+        };
+    }
+    catch (error) {
+        throw new errors_js_1.LocalDevContractError('slice-claim-ambiguous', `Slice claim is malformed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function sameOwner(record, owner) {
+    return (record.fleetId === owner.fleetId &&
+        record.sessionGeneration === owner.sessionGeneration &&
+        record.owner.pid === owner.owner.pid &&
+        record.owner.processIdentity === owner.owner.processIdentity &&
+        record.owner.startedAt === owner.owner.startedAt);
+}
+function sliceClaimPath(directory, slice) {
+    return (0, node_path_1.join)(directory, `${requireSlice(slice)}.json`);
+}
+function inspectSliceClaim(directory, slice, security = {}) {
+    const path = sliceClaimPath(directory, slice);
+    if (!(0, node_fs_1.existsSync)(path))
+        return undefined;
+    try {
+        return validateSliceClaimRecord(JSON.parse((0, private_state_js_1.readPrivateFile)(path, security).toString('utf8')));
+    }
+    catch (error) {
+        if (error instanceof errors_js_1.LocalDevContractError &&
+            error.classification === 'slice-claim-ambiguous') {
+            throw error;
+        }
+        throw new errors_js_1.LocalDevContractError('slice-claim-ambiguous', `Slice claim ${slice} cannot be trusted: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function releaseExactSliceClaim(directory, slice, owner, security) {
+    const path = sliceClaimPath(directory, slice);
+    const existing = inspectSliceClaim(directory, slice, security);
+    if (!existing || !sameOwner(existing, owner)) {
+        throw new errors_js_1.LocalDevContractError('slice-claim-ambiguous', `Slice claim ${slice} is absent or not owned by the exact fleet generation.`);
+    }
+    const releasePath = (0, node_path_1.join)(directory, `.${(0, node_path_1.basename)(path)}.${(0, contract_validation_js_1.sha256Digest)({
+        fleetId: owner.fleetId,
+        processIdentity: owner.owner.processIdentity,
+        sessionGeneration: owner.sessionGeneration,
+    }).slice(0, 16)}.release`);
+    if ((0, node_fs_1.existsSync)(releasePath)) {
+        throw new errors_js_1.LocalDevContractError('slice-claim-ambiguous', `Slice claim ${slice} has an ambiguous prior release artifact.`);
+    }
+    (0, node_fs_1.renameSync)(path, releasePath);
+    const moved = validateSliceClaimRecord(JSON.parse((0, private_state_js_1.readPrivateFile)(releasePath, security).toString('utf8')));
+    if (!sameOwner(moved, owner)) {
+        if (!(0, node_fs_1.existsSync)(path))
+            (0, node_fs_1.renameSync)(releasePath, path);
+        throw new errors_js_1.LocalDevContractError('slice-claim-ambiguous', `Slice claim ${slice} changed during generation-matched release.`);
+    }
+    (0, node_fs_1.unlinkSync)(releasePath);
+}
+function acquireSliceClaims(directory, slices, owner, options = {}) {
+    const security = options.security ?? {};
+    const normalized = slices.map(requireSlice).sort();
+    if (normalized.length === 0 ||
+        new Set(normalized).size !== normalized.length) {
+        throw new errors_js_1.LocalDevContractError('invalid-input', 'Slice claim acquisition requires unique Slice names.');
+    }
+    requireFleetId(owner.fleetId);
+    requireGeneration(owner.sessionGeneration);
+    (0, contract_validation_js_1.requireBoundedString)(owner.owner.processIdentity, 'Slice claim owner processIdentity', { maximumLength: 128, pattern: contract_validation_js_1.LOCAL_DEV_TOKEN_PATTERN });
+    (0, private_state_js_1.ensurePrivateDirectory)(directory, security);
+    const now = (0, contract_validation_js_1.requireIsoTimestamp)(options.now ?? new Date().toISOString(), 'Slice claim acquisition time');
+    const acquired = [];
+    const alreadyOwned = [];
+    const claims = [];
+    try {
+        for (const slice of normalized) {
+            const record = validateSliceClaimRecord({
+                acquiredAt: now,
+                fleetId: owner.fleetId,
+                heartbeatAt: now,
+                owner: owner.owner,
+                schemaVersion: exports.SLICE_CLAIM_SCHEMA_VERSION,
+                sessionGeneration: owner.sessionGeneration,
+                slice,
+            });
+            const created = (0, private_state_js_1.createPrivateFileExclusive)(sliceClaimPath(directory, slice), `${JSON.stringify(record, null, 2)}\n`, security);
+            if (created) {
+                acquired.push(slice);
+                claims.push(record);
+                continue;
+            }
+            const existing = inspectSliceClaim(directory, slice, security);
+            if (!existing) {
+                throw new errors_js_1.LocalDevContractError('slice-claim-ambiguous', `Slice claim ${slice} changed during acquisition.`);
+            }
+            if (!sameOwner(existing, owner)) {
+                throw new errors_js_1.LocalDevContractError('slice-active-elsewhere', `Slice ${slice} is claimed by fleet ${existing.fleetId}.`);
+            }
+            alreadyOwned.push(slice);
+            claims.push(existing);
+        }
+    }
+    catch (error) {
+        for (const slice of [...acquired].reverse()) {
+            try {
+                releaseExactSliceClaim(directory, slice, owner, security);
+            }
+            catch (rollbackError) {
+                throw new errors_js_1.LocalDevContractError('slice-claim-ambiguous', `Slice claim rollback failed for ${slice}: ${rollbackError instanceof Error
+                    ? rollbackError.message
+                    : String(rollbackError)}`);
+            }
+        }
+        throw error;
+    }
+    return { acquired, alreadyOwned, claims };
+}
+function releaseSliceClaims(directory, slices, owner, security = {}) {
+    for (const slice of [...slices].map(requireSlice).sort().reverse()) {
+        releaseExactSliceClaim(directory, slice, owner, security);
+    }
+}
+function heartbeatSliceClaim(directory, slice, owner, heartbeatAt = new Date().toISOString(), security = {}) {
+    const existing = inspectSliceClaim(directory, slice, security);
+    if (!existing || !sameOwner(existing, owner)) {
+        throw new errors_js_1.LocalDevContractError('slice-claim-ambiguous', `Slice claim ${slice} heartbeat requires exact generation ownership.`);
+    }
+    const updated = validateSliceClaimRecord({
+        ...existing,
+        heartbeatAt,
+    });
+    (0, private_state_js_1.atomicWritePrivateFile)(sliceClaimPath(directory, slice), `${JSON.stringify(updated, null, 2)}\n`, security);
+    return updated;
+}
+function classifySliceClaim(record, input) {
+    if (input.expected && sameOwner(record, input.expected))
+        return 'owned';
+    if (input.processProbe === 'matching')
+        return 'active';
+    if (input.processProbe === 'absent')
+        return 'stale';
+    return 'ambiguous';
+}
+//# sourceMappingURL=slice-claim.js.map

package/src/local-dev/slice-claim.js.map

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

package/src/local-dev/slice-runner.d.ts

@@ -0,0 +1,121 @@
+import { spawn, type ChildProcess } from 'node:child_process';
+import type { FleetProcessIdentity, ProcessIdentityProbe } from './fleet-lock.js';
+import { terminateOwnedChild } from './fleet-process.js';
+import type { FleetStateRecord } from './fleet-state.js';
+import { loadWorkspaceFleetPlan, resolveWorkspaceNxRuntime, spawnDeclaredNxTarget } from './nx-workspace.js';
+import { type PrivateStateSecurity } from './private-state.js';
+import { captureProcessIdentity } from './process-identity.js';
+import type { FleetRuntimePaths } from './runtime-paths.js';
+export declare const FLEET_SLICE_RUNNER_SCHEMA_VERSION: 1;
+export declare const FLEET_SLICE_RUNNER_RESTART_SCHEMA_VERSION: 1;
+export declare const DEFAULT_RUNNER_PARENT_GRACE_MS = 15000;
+export interface FleetSliceRunnerRequest {
+    createdAt: string;
+    fleetId: string;
+    heartbeatPath: string;
+    origin: string;
+    parent: FleetProcessIdentity;
+    port: number;
+    runnerGeneration: string;
+    schemaVersion: typeof FLEET_SLICE_RUNNER_SCHEMA_VERSION;
+    sessionGeneration: string;
+    slice: string;
+    startupPath: string;
+    workspaceRealpath: string;
+}
+export interface FleetSliceRunnerState {
+    child?: FleetProcessIdentity;
+    cleanup: 'failed' | 'pending' | 'running' | 'succeeded';
+    failure?: string;
+    fleetId: string;
+    runner: FleetProcessIdentity;
+    runnerGeneration: string;
+    schemaVersion: typeof FLEET_SLICE_RUNNER_SCHEMA_VERSION;
+    sessionGeneration: string;
+    slice: string;
+    updatedAt: string;
+}
+export interface LaunchedFleetSliceRunner {
+    child: ChildProcess;
+    request: FleetSliceRunnerRequest;
+    requestPath: string;
+    restartPath: string;
+    statePath: string;
+}
+export type FleetSliceRunnerExitReason = 'child-exit' | 'explicit-restart' | 'parent-lost' | 'termination';
+export declare function fleetSliceRunnerRequiresCleanup(reason: FleetSliceRunnerExitReason): boolean;
+export declare function validateFleetSliceRunnerRequest(value: unknown): FleetSliceRunnerRequest;
+export declare function validateFleetSliceRunnerState(value: unknown): FleetSliceRunnerState;
+export declare function fleetSliceRunnerPaths(runnersDirectory: string, slice: string, runnerGeneration: string): {
+    request: string;
+    restart: string;
+    state: string;
+};
+export declare function requestFleetSliceRunnerRestart(launched: Pick<LaunchedFleetSliceRunner, 'request' | 'restartPath' | 'statePath'>, effects?: {
+    now?: () => Date;
+    security?: PrivateStateSecurity;
+}): void;
+export declare function writeFleetSliceRunnerState(path: string, state: FleetSliceRunnerState, security?: PrivateStateSecurity): FleetSliceRunnerState;
+export declare function readFleetSliceRunnerState(path: string, security?: PrivateStateSecurity): FleetSliceRunnerState;
+export declare function writeFleetSliceRunnerRequest(path: string, value: unknown, security?: PrivateStateSecurity): FleetSliceRunnerRequest;
+export declare function readFleetSliceRunnerRequest(path: string, security?: PrivateStateSecurity): FleetSliceRunnerRequest;
+export declare function launchFleetSliceRunner(input: {
+    origin: URL;
+    parent: FleetProcessIdentity;
+    port: number;
+    runnerGeneration: string;
+    runtimePaths: FleetRuntimePaths;
+    sessionGeneration: string;
+    slice: string;
+    startupPath: string;
+    workspaceRealpath: string;
+}, effects?: {
+    daemonPath?: string;
+    now?: () => Date;
+    security?: PrivateStateSecurity;
+    spawn?: typeof spawn;
+}): LaunchedFleetSliceRunner;
+export declare function runnerParentStatus(request: FleetSliceRunnerRequest, options?: {
+    graceMs?: number;
+    now?: Date;
+    processProbe?: ProcessIdentityProbe;
+    security?: PrivateStateSecurity;
+}): 'ambiguous' | 'lost' | 'present';
+export declare function runFleetSliceRunner(requestPath: string, options?: {
+    loadPlan?: typeof loadWorkspaceFleetPlan;
+    monitorIntervalMs?: number;
+    now?: () => Date;
+    parentGraceMs?: number;
+    processIdentity?: typeof captureProcessIdentity;
+    processProbe?: (identity: FleetProcessIdentity) => ProcessIdentityProbe;
+    resolveRuntime?: typeof resolveWorkspaceNxRuntime;
+    security?: PrivateStateSecurity;
+    spawnTarget?: typeof spawnDeclaredNxTarget;
+    terminate?: typeof terminateOwnedChild;
+}): Promise<0 | 1>;
+export declare function assertFleetSliceRunnerCleanup(statePath: string, expected: Pick<FleetSliceRunnerRequest, 'fleetId' | 'runnerGeneration' | 'sessionGeneration' | 'slice'>, security?: PrivateStateSecurity): void;
+export declare function retryFleetSliceRunnerCleanup(launched: Pick<LaunchedFleetSliceRunner, 'request' | 'requestPath' | 'statePath'>, effects?: {
+    daemonPath?: string;
+    processProbe?: (identity: FleetProcessIdentity) => ProcessIdentityProbe;
+    security?: PrivateStateSecurity;
+    spawn?: typeof spawn;
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function recoverFleetSliceRunnerCleanups(state: FleetStateRecord, paths: FleetRuntimePaths, effects?: {
+    daemonPath?: string;
+    processProbe?: (identity: FleetProcessIdentity) => ProcessIdentityProbe;
+    security?: PrivateStateSecurity;
+    spawn?: typeof spawn;
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function recoverFleetSliceRunnerCleanupsForSlices(authority: Pick<FleetSliceRunnerRequest, 'fleetId' | 'sessionGeneration'>, selectedSlices: ReadonlySet<string> | readonly string[], paths: FleetRuntimePaths, effects?: {
+    daemonPath?: string;
+    processProbe?: (identity: FleetProcessIdentity) => ProcessIdentityProbe;
+    security?: PrivateStateSecurity;
+    spawn?: typeof spawn;
+    timeoutMs?: number;
+}): Promise<void>;
+export declare function inspectFleetRunnersAbsent(state: FleetStateRecord, paths: FleetRuntimePaths, effects?: {
+    processProbe?: (identity: FleetProcessIdentity) => ProcessIdentityProbe;
+    security?: PrivateStateSecurity;
+}): boolean | 'ambiguous';