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

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

@@ -0,0 +1,379 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveGitCommonDirectory = resolveGitCommonDirectory;
+exports.prepareFleetLaunch = prepareFleetLaunch;
+exports.verifyAttachedState = verifyAttachedState;
+exports.launchOrAttachFleet = launchOrAttachFleet;
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
+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_client_js_1 = require("./fleet-client.js");
+const fleet_configuration_js_1 = require("./fleet-configuration.js");
+const fleet_runtime_js_1 = require("./fleet-runtime.js");
+const fleet_startup_js_1 = require("./fleet-startup.js");
+const identity_js_1 = require("./identity.js");
+const nx_workspace_js_1 = require("./nx-workspace.js");
+const personal_stage_js_1 = require("./personal-stage.js");
+const runtime_paths_js_1 = require("./runtime-paths.js");
+const fleet_state_js_1 = require("./fleet-state.js");
+const fleet_lock_js_1 = require("./fleet-lock.js");
+const private_state_js_1 = require("./private-state.js");
+const process_identity_js_1 = require("./process-identity.js");
+const fleet_process_js_1 = require("./fleet-process.js");
+function launchError(classification, message) {
+    throw new errors_js_1.LocalDevContractError(classification, message);
+}
+function resolveGitCommonDirectory(workspaceRoot) {
+    try {
+        const value = (0, node_child_process_1.execFileSync)('git', ['rev-parse', '--path-format=absolute', '--git-common-dir'], {
+            cwd: workspaceRoot,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+            timeout: 5_000,
+            windowsHide: true,
+        }).trim();
+        if (!(0, node_path_1.isAbsolute)(value)) {
+            return launchError('invalid-state', 'Git common directory did not resolve to an absolute path.');
+        }
+        return (0, node_fs_1.realpathSync)(value);
+    }
+    catch (error) {
+        if (error instanceof errors_js_1.LocalDevContractError)
+            throw error;
+        return launchError('invalid-state', `Git common directory discovery failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function workspaceName(plan) {
+    const names = Object.entries(plan.projects)
+        .filter(([, project]) => project.tags?.includes('scope:workspace'))
+        .map(([name]) => name);
+    if (names.length !== 1) {
+        return launchError('invalid-state', `Expected one scope:workspace project, found ${names.length}.`);
+    }
+    return names[0];
+}
+async function prepareFleetLaunch(input, dependencies = {}) {
+    const workspaceRealpath = (0, node_fs_1.realpathSync)(input.workspaceRoot);
+    const identity = (dependencies.personalStageResolver ?? (0, personal_stage_js_1.createPersonalStageResolver)()).resolve();
+    const plan = await (dependencies.loadPlan ?? nx_workspace_js_1.loadWorkspaceFleetPlan)();
+    const name = workspaceName(plan);
+    const fleetId = (0, identity_js_1.createFleetId)({
+        checkoutPath: workspaceRealpath,
+        stage: identity.stage,
+        workspaceName: name,
+    });
+    const generation = (dependencies.generation ?? node_crypto_1.randomUUID)();
+    const launcher = (dependencies.launcherIdentity ?? (() => (0, process_identity_js_1.captureProcessIdentity)()))();
+    const request = {
+        appData: (0, node_path_1.resolve)(input.appData),
+        context: input.context,
+        fleetId,
+        frameworkVersion: input.frameworkVersion,
+        gitCommonDirectory: (dependencies.gitCommonDirectory ?? resolveGitCommonDirectory)(workspaceRealpath),
+        identity,
+        launcher,
+        schemaVersion: fleet_startup_js_1.FLEET_STARTUP_SCHEMA_VERSION,
+        sessionGeneration: generation,
+        sstMode: input.sstMode ?? 'mono',
+        workspaceName: name,
+        workspaceRealpath,
+    };
+    const nxRuntime = (dependencies.resolveNxRuntime ?? nx_workspace_js_1.resolveWorkspaceNxRuntime)(workspaceRealpath);
+    const router = await (dependencies.resolveRouter ?? fleet_runtime_js_1.resolveDevelopmentRouter)(request);
+    if (router.protocol !== 'https:' ||
+        router.origin !== router.toString().replace(/\/$/, '') ||
+        router.username ||
+        router.password ||
+        router.pathname !== '/' ||
+        router.search ||
+        router.hash) {
+        return launchError('configuration-mismatch', 'Development Router must be an exact credential-free HTTPS origin.');
+    }
+    const configurationFingerprint = (0, fleet_configuration_js_1.fleetConfigurationFingerprint)({
+        context: request.context,
+        frameworkVersion: request.frameworkVersion,
+        identity,
+        nxVersion: nxRuntime.version,
+        plan,
+        routerOrigin: router.origin,
+    });
+    return {
+        configurationFingerprint,
+        identity,
+        nxVersion: nxRuntime.version,
+        paths: (0, runtime_paths_js_1.fleetRuntimePaths)(fleetId, request.appData),
+        plan,
+        request,
+        routerOrigin: router.origin,
+        routerSource: (0, fleet_configuration_js_1.fleetRouterSource)(request.context),
+    };
+}
+function verifyAttachedState(prepared, client) {
+    return client.status().then((state) => {
+        if (state.fleetId !== prepared.request.fleetId ||
+            state.workspaceRealpath !== prepared.request.workspaceRealpath ||
+            state.resolvedStage !== prepared.request.identity.stage ||
+            state.contextDigest !== (0, contract_validation_js_1.sha256Digest)(prepared.request.context) ||
+            state.frameworkVersion !== prepared.request.frameworkVersion ||
+            state.nxVersion !== prepared.nxVersion ||
+            state.routerOrigin !== prepared.routerOrigin ||
+            state.routerSource !== prepared.routerSource ||
+            state.configurationFingerprint !== prepared.configurationFingerprint) {
+            return launchError('configuration-mismatch', 'Live Fleet identity, framework, Nx, Router, context, or adapter topology differs from this command. Stop the existing Fleet before mutating the new configuration.');
+        }
+    });
+}
+async function waitForSupervisor(prepared, child, security, timeoutMs = 15_000) {
+    const deadline = Date.now() + timeoutMs;
+    let lastError;
+    let exited;
+    child?.once('exit', (code, signal) => {
+        exited = { code, signal };
+    });
+    while (Date.now() < deadline) {
+        if (exited) {
+            return launchError('supervisor-unreachable', `Fleet supervisor exited before readiness (${exited.signal
+                ? `signal ${exited.signal}`
+                : `status ${exited.code ?? 'unknown'}`}).`);
+        }
+        if ((0, node_fs_1.existsSync)(prepared.paths.capability)) {
+            try {
+                const client = new fleet_client_js_1.FleetClient(prepared.paths, security);
+                const ping = await client.ping();
+                if (ping.fleetId === prepared.request.fleetId &&
+                    ping.sessionGeneration === prepared.request.sessionGeneration) {
+                    return client;
+                }
+            }
+            catch (error) {
+                lastError = error;
+            }
+        }
+        await new Promise((resolvePromise) => setTimeout(resolvePromise, 100));
+    }
+    return launchError('supervisor-unreachable', `Fleet supervisor did not become ready within ${timeoutMs}ms${lastError instanceof Error ? `: ${lastError.message}` : ''}.`);
+}
+async function rollbackPreparedFleetLaunch(prepared, security, child) {
+    if (child)
+        await (0, fleet_process_js_1.terminateOwnedChild)(child);
+    const state = (0, fleet_state_js_1.readFleetState)(prepared.paths.sessionDirectory, security);
+    if (state &&
+        (state.fleetId !== prepared.request.fleetId ||
+            state.sessionGeneration !== prepared.request.sessionGeneration ||
+            state.slices.some(({ selected }) => selected))) {
+        return launchError('stale-state-ambiguous', 'Fleet startup rollback found mismatched or selected state; exact authority was retained.');
+    }
+    const lock = (0, fleet_lock_js_1.inspectFleetLock)(prepared.paths.lock, security);
+    if (lock) {
+        if (lock.fleetId !== prepared.request.fleetId ||
+            lock.sessionGeneration !== prepared.request.sessionGeneration ||
+            (0, process_identity_js_1.probeProcessIdentity)(lock.owner) !== 'absent') {
+            return launchError('stale-state-ambiguous', 'Fleet startup rollback could not prove exact supervisor absence.');
+        }
+        (0, fleet_lock_js_1.releaseFleetLock)(prepared.paths.lock, lock, security);
+    }
+    for (const path of [
+        prepared.paths.capability,
+        prepared.paths.controlSocket,
+        prepared.paths.heartbeat,
+        prepared.paths.state,
+        prepared.paths.supervisorPid,
+    ]) {
+        if ((0, node_fs_1.existsSync)(path))
+            (0, node_fs_1.unlinkSync)(path);
+    }
+    if ((0, node_fs_1.existsSync)(prepared.paths.startup)) {
+        const startup = (0, fleet_startup_js_1.readFleetStartupRequest)(prepared.paths.startup, security);
+        if (startup.fleetId !== prepared.request.fleetId ||
+            startup.sessionGeneration !== prepared.request.sessionGeneration) {
+            return launchError('stale-state-ambiguous', 'Fleet startup request changed during generation-owned rollback.');
+        }
+        (0, node_fs_1.unlinkSync)(prepared.paths.startup);
+    }
+    if ((0, node_fs_1.existsSync)(prepared.paths.sessionDirectory) &&
+        (0, node_fs_1.readdirSync)(prepared.paths.sessionDirectory).length === 0) {
+        (0, node_fs_1.rmdirSync)(prepared.paths.sessionDirectory);
+    }
+}
+function restoreStartupRecovery(startupPath, recoveryPath) {
+    if ((0, node_fs_1.existsSync)(recoveryPath) && !(0, node_fs_1.existsSync)(startupPath)) {
+        (0, node_fs_1.renameSync)(recoveryPath, startupPath);
+    }
+}
+/**
+ * Recover the one safe pre-supervisor crash shape: the launcher wrote its
+ * exclusive startup request and exited before any supervisor authority or
+ * runner evidence appeared. Rename is the compare-and-claim step. Any
+ * concurrent evidence causes restoration and a fail-closed refusal.
+ */
+function recoverStartupOnlyRequest(prepared, processProbe, security) {
+    if (!(0, node_fs_1.existsSync)(prepared.paths.startup))
+        return false;
+    let startup;
+    try {
+        (0, private_state_js_1.assertPrivatePath)(prepared.paths.sessionDirectory, 'directory', security);
+        startup = (0, fleet_startup_js_1.readFleetStartupRequest)(prepared.paths.startup, security);
+    }
+    catch {
+        return launchError('stale-state-ambiguous', 'Residual Fleet startup authority is malformed; inspect it manually and do not replace it.');
+    }
+    if (startup.fleetId !== prepared.request.fleetId ||
+        startup.appData !== prepared.request.appData ||
+        startup.workspaceRealpath !== prepared.request.workspaceRealpath ||
+        startup.gitCommonDirectory !== prepared.request.gitCommonDirectory ||
+        startup.identity.stage !== prepared.request.identity.stage) {
+        return launchError('stale-state-ambiguous', 'Residual Fleet startup authority does not match this exact workspace identity.');
+    }
+    const launcherProof = processProbe(startup.launcher);
+    if (launcherProof !== 'absent') {
+        return launchError('stale-state-ambiguous', launcherProof === 'matching'
+            ? 'Residual Fleet startup is owned by a live launcher; do not replace it.'
+            : 'Residual Fleet startup launcher identity cannot be disproved; do not replace it.');
+    }
+    const startupName = (0, node_path_1.basename)(prepared.paths.startup);
+    const initialEntries = (0, node_fs_1.readdirSync)(prepared.paths.sessionDirectory, {
+        withFileTypes: true,
+    });
+    const hasOnlyStartup = initialEntries.length === 1 &&
+        initialEntries[0]?.name === startupName &&
+        initialEntries[0].isFile() &&
+        !initialEntries[0].isSymbolicLink();
+    const evidencePaths = [
+        prepared.paths.capability,
+        prepared.paths.controlSocket,
+        prepared.paths.heartbeat,
+        prepared.paths.lock,
+        prepared.paths.runnersDirectory,
+        prepared.paths.state,
+        prepared.paths.supervisorPid,
+    ];
+    if (!hasOnlyStartup || evidencePaths.some((path) => (0, node_fs_1.existsSync)(path))) {
+        return launchError('stale-state-ambiguous', 'Residual Fleet startup has supervisor, socket, lock, or runner evidence; do not replace it.');
+    }
+    const recoveryPath = `${prepared.paths.startup}.${(0, contract_validation_js_1.sha256Digest)({
+        fleetId: startup.fleetId,
+        sessionGeneration: startup.sessionGeneration,
+    }).slice(0, 16)}.recover`;
+    if ((0, node_fs_1.existsSync)(recoveryPath)) {
+        return launchError('stale-state-ambiguous', 'Residual Fleet startup has a prior recovery artifact; inspect it manually.');
+    }
+    try {
+        (0, node_fs_1.renameSync)(prepared.paths.startup, recoveryPath);
+        const moved = (0, fleet_startup_js_1.readFleetStartupRequest)(recoveryPath, security);
+        const entries = (0, node_fs_1.readdirSync)(prepared.paths.sessionDirectory, {
+            withFileTypes: true,
+        });
+        if ((0, contract_validation_js_1.sha256Digest)(moved) !== (0, contract_validation_js_1.sha256Digest)(startup) ||
+            moved.fleetId !== startup.fleetId ||
+            moved.sessionGeneration !== startup.sessionGeneration ||
+            entries.length !== 1 ||
+            entries[0]?.name !== (0, node_path_1.basename)(recoveryPath) ||
+            !entries[0].isFile() ||
+            entries[0].isSymbolicLink() ||
+            evidencePaths.some((path) => (0, node_fs_1.existsSync)(path))) {
+            restoreStartupRecovery(prepared.paths.startup, recoveryPath);
+            return launchError('stale-state-ambiguous', 'Fleet startup authority changed while proving the pre-supervisor crash shape.');
+        }
+        (0, node_fs_1.unlinkSync)(recoveryPath);
+        if ((0, node_fs_1.existsSync)(prepared.paths.sessionDirectory) &&
+            (0, node_fs_1.readdirSync)(prepared.paths.sessionDirectory).length === 0) {
+            (0, node_fs_1.rmdirSync)(prepared.paths.sessionDirectory);
+        }
+        return true;
+    }
+    catch (error) {
+        try {
+            restoreStartupRecovery(prepared.paths.startup, recoveryPath);
+        }
+        catch {
+            // Preserve both artifacts for manual inspection when exact restoration
+            // itself cannot be proved.
+        }
+        if (error instanceof errors_js_1.LocalDevContractError)
+            throw error;
+        return launchError('stale-state-ambiguous', `Fleet startup-only recovery could not prove exact authority: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+async function launchOrAttachFleet(input, dependencies = {}) {
+    const prepared = await prepareFleetLaunch(input, dependencies);
+    const security = dependencies.security ?? {};
+    const existingState = (0, fleet_state_js_1.readFleetState)(prepared.paths.sessionDirectory, security);
+    if (existingState || (0, node_fs_1.existsSync)(prepared.paths.capability)) {
+        try {
+            const client = new fleet_client_js_1.FleetClient(prepared.paths, security);
+            await client.ping();
+            await verifyAttachedState(prepared, client);
+            return {
+                attached: true,
+                client,
+                fleetId: prepared.request.fleetId,
+            };
+        }
+        catch (error) {
+            if (error instanceof errors_js_1.LocalDevContractError &&
+                error.classification === 'configuration-mismatch') {
+                throw error;
+            }
+            return launchError('stale-state-ambiguous', 'Existing Fleet state is not authentically reachable. Run ebk dev ps and prune only after exact stale proof.');
+        }
+    }
+    recoverStartupOnlyRequest(prepared, dependencies.processProbe ?? process_identity_js_1.probeProcessIdentity, security);
+    if ((0, node_fs_1.existsSync)(prepared.paths.sessionDirectory) &&
+        (0, node_fs_1.readdirSync)(prepared.paths.sessionDirectory).length > 0) {
+        return launchError('stale-state-ambiguous', 'Residual Fleet session evidence is present without authenticated control; do not replace it.');
+    }
+    (0, fleet_startup_js_1.writeFleetStartupRequest)(prepared.paths.startup, prepared.request, security);
+    if (input.foreground) {
+        let runtime;
+        try {
+            runtime = await (dependencies.startRuntime ?? fleet_runtime_js_1.startFleetRuntime)(prepared.paths.startup);
+            const client = await waitForSupervisor(prepared, undefined, security);
+            await verifyAttachedState(prepared, client);
+            return {
+                attached: false,
+                client,
+                fleetId: prepared.request.fleetId,
+                runtime,
+            };
+        }
+        catch (error) {
+            if (runtime) {
+                await runtime.session.closeProxyWhenEmpty().catch(() => undefined);
+                await runtime.supervisor.stopGracefully().catch(() => undefined);
+            }
+            await rollbackPreparedFleetLaunch(prepared, security);
+            throw error;
+        }
+    }
+    const daemonPath = dependencies.daemonPath ?? require.resolve('./fleet-supervisor-daemon.js');
+    let child;
+    try {
+        child = (dependencies.spawn ?? node_child_process_1.spawn)(process.execPath, [daemonPath], {
+            cwd: prepared.request.workspaceRealpath,
+            detached: true,
+            env: (0, personal_stage_js_1.createPersonalDevelopmentEnvironment)(prepared.identity.stage, {
+                ...process.env,
+                EBK_FLEET_STARTUP_PATH: prepared.paths.startup,
+            }),
+            shell: false,
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+        child.unref();
+        const client = await waitForSupervisor(prepared, child, security);
+        await verifyAttachedState(prepared, client);
+        return {
+            attached: false,
+            client,
+            fleetId: prepared.request.fleetId,
+        };
+    }
+    catch (error) {
+        await rollbackPreparedFleetLaunch(prepared, security, child);
+        throw error;
+    }
+}
+//# sourceMappingURL=fleet-launcher.js.map

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

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

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

@@ -0,0 +1,41 @@
+import { type PrivateStateSecurity } from './private-state.js';
+export declare const FLEET_LOCK_SCHEMA_VERSION: 1;
+export interface FleetProcessIdentity {
+    pid: number;
+    processIdentity: string;
+    startedAt: string;
+}
+export interface FleetLockRecord {
+    acquiredAt: string;
+    fleetId: string;
+    owner: FleetProcessIdentity;
+    schemaVersion: typeof FLEET_LOCK_SCHEMA_VERSION;
+    sessionGeneration: string;
+}
+export type FleetLockAcquisition = {
+    kind: 'acquired';
+    record: FleetLockRecord;
+} | {
+    kind: 'already-owned';
+    record: FleetLockRecord;
+} | {
+    kind: 'held';
+    record: FleetLockRecord;
+};
+export type ProcessIdentityProbe = 'absent' | 'ambiguous' | 'matching';
+export type FleetLockClassification = 'active' | 'ambiguous' | 'owned' | 'stale';
+export declare function validateFleetProcessIdentity(value: unknown): FleetProcessIdentity;
+export declare function validateFleetLockRecord(value: unknown): FleetLockRecord;
+export declare function acquireFleetLock(path: string, input: {
+    acquiredAt?: string;
+    fleetId: string;
+    owner: FleetProcessIdentity;
+    sessionGeneration: string;
+}, security?: PrivateStateSecurity): FleetLockAcquisition;
+export declare function inspectFleetLock(path: string, security?: PrivateStateSecurity): FleetLockRecord | undefined;
+export declare function classifyFleetLock(record: FleetLockRecord, input: {
+    expected?: Pick<FleetLockRecord, 'fleetId' | 'owner' | 'sessionGeneration'>;
+    processProbe: ProcessIdentityProbe;
+}): FleetLockClassification;
+export declare function releaseFleetLock(path: string, expected: Pick<FleetLockRecord, 'fleetId' | 'owner' | 'sessionGeneration'>, security?: PrivateStateSecurity): void;
+export declare function validateFleetIdentitySlug(value: unknown, label: string): string;

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

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FLEET_LOCK_SCHEMA_VERSION = void 0;
+exports.validateFleetProcessIdentity = validateFleetProcessIdentity;
+exports.validateFleetLockRecord = validateFleetLockRecord;
+exports.acquireFleetLock = acquireFleetLock;
+exports.inspectFleetLock = inspectFleetLock;
+exports.classifyFleetLock = classifyFleetLock;
+exports.releaseFleetLock = releaseFleetLock;
+exports.validateFleetIdentitySlug = validateFleetIdentitySlug;
+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 private_state_js_1 = require("./private-state.js");
+exports.FLEET_LOCK_SCHEMA_VERSION = 1;
+const FLEET_ID_PATTERN = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
+function requireFleetId(value) {
+    return (0, contract_validation_js_1.requireBoundedString)(value, 'Fleet lock fleetId', {
+        maximumLength: 63,
+        pattern: FLEET_ID_PATTERN,
+    });
+}
+function requireGeneration(value) {
+    return (0, contract_validation_js_1.requireBoundedString)(value, 'Fleet lock sessionGeneration', {
+        maximumLength: 128,
+        pattern: contract_validation_js_1.LOCAL_DEV_TOKEN_PATTERN,
+    });
+}
+function validateFleetProcessIdentity(value) {
+    (0, contract_validation_js_1.assertRecord)(value, 'Fleet lock owner');
+    (0, contract_validation_js_1.assertExactProperties)(value, ['pid', 'processIdentity', 'startedAt'], [], 'Fleet lock owner');
+    return {
+        pid: (0, contract_validation_js_1.requireInteger)(value.pid, 'Fleet lock owner pid', 1, 2_147_483_647),
+        processIdentity: (0, contract_validation_js_1.requireBoundedString)(value.processIdentity, 'Fleet lock owner processIdentity', { maximumLength: 128, pattern: contract_validation_js_1.LOCAL_DEV_TOKEN_PATTERN }),
+        startedAt: (0, contract_validation_js_1.requireIsoTimestamp)(value.startedAt, 'Fleet lock owner startedAt'),
+    };
+}
+function validateFleetLockRecord(value) {
+    (0, contract_validation_js_1.assertRecord)(value, 'Fleet lock');
+    (0, contract_validation_js_1.assertExactProperties)(value, ['acquiredAt', 'fleetId', 'owner', 'schemaVersion', 'sessionGeneration'], [], 'Fleet lock');
+    if (value.schemaVersion !== exports.FLEET_LOCK_SCHEMA_VERSION) {
+        throw new errors_js_1.LocalDevContractError('fleet-ownership-ambiguous', `Fleet lock schemaVersion must be ${exports.FLEET_LOCK_SCHEMA_VERSION}.`);
+    }
+    try {
+        return {
+            acquiredAt: (0, contract_validation_js_1.requireIsoTimestamp)(value.acquiredAt, 'Fleet lock acquiredAt'),
+            fleetId: requireFleetId(value.fleetId),
+            owner: validateFleetProcessIdentity(value.owner),
+            schemaVersion: exports.FLEET_LOCK_SCHEMA_VERSION,
+            sessionGeneration: requireGeneration(value.sessionGeneration),
+        };
+    }
+    catch (error) {
+        throw new errors_js_1.LocalDevContractError('fleet-ownership-ambiguous', `Fleet lock is malformed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function sameOwner(left, right) {
+    return (left.fleetId === right.fleetId &&
+        left.sessionGeneration === right.sessionGeneration &&
+        left.owner.pid === right.owner.pid &&
+        left.owner.processIdentity === right.owner.processIdentity &&
+        left.owner.startedAt === right.owner.startedAt);
+}
+function readFleetLock(path, security) {
+    try {
+        return validateFleetLockRecord(JSON.parse((0, private_state_js_1.readPrivateFile)(path, security).toString('utf8')));
+    }
+    catch (error) {
+        if (error instanceof errors_js_1.LocalDevContractError &&
+            error.classification === 'fleet-ownership-ambiguous') {
+            throw error;
+        }
+        throw new errors_js_1.LocalDevContractError('fleet-ownership-ambiguous', `Fleet lock cannot be trusted: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function acquireFleetLock(path, input, security = {}) {
+    const record = validateFleetLockRecord({
+        acquiredAt: input.acquiredAt ?? new Date().toISOString(),
+        fleetId: input.fleetId,
+        owner: input.owner,
+        schemaVersion: exports.FLEET_LOCK_SCHEMA_VERSION,
+        sessionGeneration: input.sessionGeneration,
+    });
+    if ((0, private_state_js_1.createPrivateFileExclusive)(path, `${JSON.stringify(record, null, 2)}\n`, security)) {
+        return { kind: 'acquired', record };
+    }
+    const existing = readFleetLock(path, security);
+    return {
+        kind: sameOwner(existing, record) ? 'already-owned' : 'held',
+        record: existing,
+    };
+}
+function inspectFleetLock(path, security = {}) {
+    return (0, node_fs_1.existsSync)(path) ? readFleetLock(path, security) : undefined;
+}
+function classifyFleetLock(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';
+}
+function releaseFleetLock(path, expected, security = {}) {
+    const existing = readFleetLock(path, security);
+    if (!sameOwner(existing, expected)) {
+        throw new errors_js_1.LocalDevContractError('fleet-ownership-ambiguous', 'Fleet lock release requires the exact fleet, generation, and process identity.');
+    }
+    const releasePath = (0, node_path_1.join)((0, node_path_1.dirname)(path), `.${(0, node_path_1.basename)(path)}.${(0, contract_validation_js_1.sha256Digest)({
+        fleetId: existing.fleetId,
+        processIdentity: existing.owner.processIdentity,
+        sessionGeneration: existing.sessionGeneration,
+    }).slice(0, 16)}.release`);
+    if ((0, node_fs_1.existsSync)(releasePath)) {
+        throw new errors_js_1.LocalDevContractError('fleet-ownership-ambiguous', 'A prior fleet-lock release artifact is present; ownership is ambiguous.');
+    }
+    (0, node_fs_1.renameSync)(path, releasePath);
+    const moved = readFleetLock(releasePath, security);
+    if (!sameOwner(moved, expected)) {
+        if (!(0, node_fs_1.existsSync)(path))
+            (0, node_fs_1.renameSync)(releasePath, path);
+        throw new errors_js_1.LocalDevContractError('fleet-ownership-ambiguous', 'Fleet lock changed during generation-matched release.');
+    }
+    (0, node_fs_1.unlinkSync)(releasePath);
+}
+function validateFleetIdentitySlug(value, label) {
+    return (0, contract_validation_js_1.requireBoundedString)(value, label, {
+        maximumLength: 63,
+        pattern: contract_validation_js_1.LOCAL_DEV_SLUG_PATTERN,
+    });
+}
+//# sourceMappingURL=fleet-lock.js.map

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

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

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

@@ -0,0 +1,66 @@
+import { type PrivateStateSecurity } from './private-state.js';
+export declare const LOCAL_LOG_SCHEMA_VERSION: 1;
+export declare const LOCAL_LOG_ACTIVE_SEGMENT_BYTES: number;
+export declare const LOCAL_LOG_FLEET_MAX_BYTES: number;
+export declare const LOCAL_LOG_MAX_AGE_MS: number;
+export declare const LOCAL_LOG_MAX_GENERATIONS = 16;
+export declare const LOCAL_LOG_MAX_LINE_BYTES: number;
+export declare const LOCAL_LOG_LEVELS: readonly ["TRACE", "DEBUG", "INFO", "WARN", "ERROR", "FATAL"];
+export type LocalLogLevel = (typeof LOCAL_LOG_LEVELS)[number];
+export type LocalLogStream = 'stderr' | 'stdout';
+export type LocalLogKind = 'gap' | 'plain' | 'structured';
+export interface LocalLogEnvelope {
+    attempt: number;
+    fleetId: string;
+    kind: LocalLogKind;
+    level: LocalLogLevel;
+    message: string;
+    record?: Readonly<Record<string, unknown>>;
+    schemaVersion: typeof LOCAL_LOG_SCHEMA_VERSION;
+    sequence: number;
+    sessionGeneration: string;
+    slice: string;
+    stream: LocalLogStream;
+    timestamp: string;
+    truncated?: boolean;
+}
+export interface LocalLogQuery {
+    attempt?: number;
+    contains?: string;
+    correlationId?: string;
+    level?: Lowercase<LocalLogLevel>;
+    limit: number;
+    since?: string;
+    slices?: readonly string[];
+    stream?: LocalLogStream;
+    until?: string;
+}
+export interface LocalLogQueryResult {
+    records: LocalLogEnvelope[];
+    scannedFiles: number;
+    truncated: boolean;
+}
+export interface FleetLogStoreOptions {
+    activeSegmentBytes?: number;
+    fleetMaxBytes?: number;
+    maxAgeMs?: number;
+    maxGenerations?: number;
+    maxLineBytes?: number;
+    now?: () => Date;
+    security?: PrivateStateSecurity;
+}
+export declare function redactLocalLogText(input: string, exactValues?: readonly string[]): string;
+export declare function validateLocalLogEnvelope(value: unknown): LocalLogEnvelope;
+export declare function searchFleetLogs(fleetLogDirectory: string, query: LocalLogQuery): LocalLogQueryResult;
+export declare class FleetLogStore {
+    #private;
+    readonly generationDirectory: string;
+    constructor(fleetDirectory: string, fleetId: string, sessionGeneration: string, exactValues?: readonly string[], options?: FleetLogStoreOptions);
+    writeLine(slice: string, stream: LocalLogStream, attempt: number, line: string): LocalLogEnvelope;
+    writeChunk(slice: string, stream: LocalLogStream, attempt: number, chunk: Buffer | string): LocalLogEnvelope[];
+    flush(slice?: string, stream?: LocalLogStream, attempt?: number): LocalLogEnvelope[];
+    enforceRetention(): void;
+}
+export declare function followFleetLogs(fleetLogDirectory: string, query: Omit<LocalLogQuery, 'limit'> & {
+    lines: number;
+}, signal: AbortSignal, pollMs?: number): AsyncGenerator<LocalLogEnvelope>;