@astrosheep/keiyaku 2.9.13 → 4.0.0

package/build/core/projection/generation/projection-generation-identity.js

@@ -1,21 +0,0 @@
-import { randomBytes } from "node:crypto";
-import * as path from "node:path";
-import { ProjectionStateError } from "../../atomic-publish.js";
-import { createUlid } from "../../ids.js";
-const EXECUTION_ID_PATTERN = /^[0-9A-HJKMNP-TV-Z]{26}$/;
-export const PROJECTION_RUNNER_LEASE_FILE = "leash";
-export function createProjectionExecutionId(nowMs = Date.now()) {
-    return createUlid(nowMs, [...randomBytes(10)]);
-}
-export function assertProjectionExecutionId(executionId) {
-    if (!EXECUTION_ID_PATTERN.test(executionId)) {
-        throw new ProjectionStateError(`invalid projection execution id: ${executionId}`);
-    }
-}
-export function executionStdioLogPath(projectionDirectory, executionId) {
-    assertProjectionExecutionId(executionId);
-    return path.join(projectionDirectory, `${executionId}.stdio.log`);
-}
-export function projectionRunnerLeasePath(projectionDirectory) {
-    return path.join(projectionDirectory, PROJECTION_RUNNER_LEASE_FILE);
-}

package/build/core/projection/generation/projection-generation-launcher.js

@@ -1,154 +0,0 @@
-import { setTimeout as delay } from "node:timers/promises";
-import { PROJECTION_ADOPTION_TIMEOUT_DEFAULT_MS } from "../../../config/settings/knobs.js";
-import { openProjectionGenerationStore } from "./store.js";
-import { prepareProjectionGenerationRunner, } from "./projection-generation-process.js";
-import { acquireRunnerLease, observeRunnerLease, } from "../../run-control/runner-lease.js";
-import { openDetachedLeaseBootstrap } from "../../run-control/detached-lease-bootstrap.js";
-import { projectionRunnerLeasePath } from "./projection-generation-identity.js";
-const PROJECTION_ADOPTION_POLL_MS = 20;
-function errorDetail(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-function recordDeadStartup(projectionDirectory, executionId, detail, stage, terminalAt) {
-    const store = openProjectionGenerationStore(projectionDirectory);
-    try {
-        return store.settleStartupFailure({
-            executionId,
-            releasedLockEvidence: { stage, detail },
-            diagnostic: { stage, detail },
-            terminalAt,
-        }).status === "committed";
-    }
-    finally {
-        store.close();
-    }
-}
-const ADOPTION_TIMEOUT_DETAIL = "runner did not adopt before projection adoption timeout";
-async function failAdoptionDeadline(projectionDirectory, executionId, child, now, terminateChild, detail = ADOPTION_TIMEOUT_DETAIL) {
-    try {
-        await terminateChild(child);
-    }
-    catch (error) {
-        return { status: "failed", cause: "adoption", detail: `${detail}; runner termination could not be verified: ${errorDetail(error)}` };
-    }
-    const lease = observeRunnerLease(projectionRunnerLeasePath(projectionDirectory));
-    if (lease.state !== "released")
-        return {
-            status: "failed",
-            cause: "adoption",
-            detail: `${detail}; runner lock ${lease.state === "held" ? "remained held" : `could not be verified: ${lease.detail}`}`,
-        };
-    recordDeadStartup(projectionDirectory, executionId, detail, "adoption", new Date(now()).toISOString());
-    return { status: "failed", cause: "adoption", detail };
-}
-/** Spawn one committed launch and return only after its exact adoption row. */
-export async function startProjectionGeneration(projectionDirectory, executionId, dependencies = {}) {
-    const now = dependencies.now ?? Date.now;
-    const sleep = dependencies.sleep ?? ((milliseconds) => delay(milliseconds));
-    const adoptionTimeoutMs = dependencies.adoptionTimeoutMs ?? PROJECTION_ADOPTION_TIMEOUT_DEFAULT_MS;
-    // Bootstrap IPC and durable adoption are one launch operation, not retries
-    // with independent startup allowances.
-    const deadline = now() + adoptionTimeoutMs;
-    let launchOwnership;
-    try {
-        launchOwnership = dependencies.launchOwnership
-            ?? acquireRunnerLease(projectionRunnerLeasePath(projectionDirectory));
-    }
-    catch (error) {
-        if (observeRunnerLease(projectionRunnerLeasePath(projectionDirectory)).state === "held") {
-            return { status: "pending" };
-        }
-        return {
-            status: "failed",
-            cause: "adoption",
-            detail: `runner construction failed: ${errorDetail(error)}`,
-        };
-    }
-    let prepared;
-    try {
-        prepared = prepareProjectionGenerationRunner(projectionDirectory, executionId, dependencies);
-    }
-    catch (error) {
-        const detail = `runner spawn failed: ${errorDetail(error)}`;
-        recordDeadStartup(projectionDirectory, executionId, detail, "spawn", new Date(now()).toISOString());
-        launchOwnership.close();
-        return { status: "failed", cause: "spawn", detail };
-    }
-    const opened = await openDetachedLeaseBootstrap({
-        coordinate: executionId,
-        leasePath: projectionRunnerLeasePath(projectionDirectory),
-        parentLease: launchOwnership,
-        launch: prepared.launch,
-        deadline,
-        now,
-        spawn: dependencies.spawn,
-        terminate: dependencies.terminateChild,
-    });
-    prepared.close();
-    if (opened.status === "failed") {
-        const detail = opened.stage === "spawn" ? `runner spawn failed: ${opened.detail}` : `runner construction failed: ${opened.detail}`;
-        recordDeadStartup(projectionDirectory, executionId, detail, opened.stage === "spawn" ? "spawn" : "adoption", new Date(now()).toISOString());
-        return { status: "failed", cause: opened.stage === "spawn" ? "spawn" : "adoption", detail };
-    }
-    let committed = true;
-    let commitFailure;
-    try {
-        committed = dependencies.commitLaunch?.() ?? true;
-    }
-    catch (error) {
-        committed = false;
-        commitFailure = error;
-    }
-    if (!committed) {
-        const rejected = await opened.bootstrap.reject();
-        return {
-            status: "failed",
-            cause: "adoption",
-            detail: rejected.status === "failed"
-                ? rejected.detail
-                : commitFailure ? `generation launch transaction failed: ${errorDetail(commitFailure)}` : "generation launch transaction was rejected",
-        };
-    }
-    const authorized = await opened.bootstrap.authorize();
-    if (authorized.status === "failed") {
-        const detail = now() >= deadline ? ADOPTION_TIMEOUT_DETAIL : `runner construction failed: ${authorized.detail}`;
-        recordDeadStartup(projectionDirectory, executionId, detail, "adoption", new Date(now()).toISOString());
-        return { status: "failed", cause: "adoption", detail };
-    }
-    const child = authorized.child;
-    for (;;) {
-        const observedAt = now();
-        const store = openProjectionGenerationStore(projectionDirectory);
-        try {
-            const current = store.readCurrentGeneration();
-            if (current?.launch.executionId !== executionId) {
-                return {
-                    status: "failed",
-                    cause: "adoption",
-                    detail: "launch stopped being current before adoption",
-                };
-            }
-            if (current.adoption)
-                return { status: "adopted", child };
-            if (current.verdict) {
-                return {
-                    status: "failed",
-                    cause: "adoption",
-                    detail: typeof current.verdict.facts.detail === "string"
-                        ? current.verdict.facts.detail
-                        : `launch ended as ${String(current.verdict.facts.state)}`,
-                };
-            }
-        }
-        finally {
-            store.close();
-        }
-        if (observeRunnerLease(projectionRunnerLeasePath(projectionDirectory)).state === "held") {
-            return { status: "adopted", child };
-        }
-        if (observedAt >= deadline)
-            break;
-        await sleep(Math.max(0, Math.min(PROJECTION_ADOPTION_POLL_MS, deadline - observedAt)));
-    }
-    return failAdoptionDeadline(projectionDirectory, executionId, child, now, dependencies.terminateChild ?? (await import("../../run-control/process-tree.js")).terminateProcessGroup);
-}

package/build/core/projection/generation/projection-generation-process.js

@@ -1,47 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-import { RUN_CONTROL_BOOTSTRAP_ENV } from "../../run-control/index.js";
-import { executionStdioLogPath } from "./projection-generation-identity.js";
-const MODULE_FILE = fileURLToPath(import.meta.url);
-// Lives at src/core/projection/generation/ — four levels up is the package root.
-const PACKAGE_ROOT = path.resolve(path.dirname(MODULE_FILE), "..", "..", "..", "..");
-const RUNNER_ENTRY = MODULE_FILE.endsWith(".ts")
-    ? [process.execPath, "--import", "tsx", path.join(PACKAGE_ROOT, "src", "index.ts")]
-    : [process.execPath, path.join(PACKAGE_ROOT, "build", "index.js")];
-export function projectionGenerationRunnerArgv(projectionDirectory, executionId) {
-    return [
-        ...RUNNER_ENTRY,
-        "__keiyaku-wake",
-        path.resolve(projectionDirectory),
-        executionId,
-    ];
-}
-export function prepareProjectionGenerationRunner(projectionDirectory, executionId, dependencies = {}) {
-    const openSync = dependencies.openSync ?? fs.openSync;
-    const closeSync = dependencies.closeSync ?? fs.closeSync;
-    const absoluteDirectory = path.resolve(projectionDirectory);
-    const [command, ...args] = projectionGenerationRunnerArgv(absoluteDirectory, executionId);
-    if (!command)
-        throw new Error("projection runner command is empty");
-    const logPath = executionStdioLogPath(absoluteDirectory, executionId);
-    const logFd = openSync(logPath, "a");
-    try {
-        return {
-            launch: {
-                command,
-                args,
-                unref: true,
-                options: {
-                    stdio: ["ignore", logFd, logFd, "ipc"],
-                    env: { ...process.env, [RUN_CONTROL_BOOTSTRAP_ENV]: "1" },
-                },
-            },
-            close: () => closeSync(logFd),
-        };
-    }
-    catch (error) {
-        closeSync(logFd);
-        throw error;
-    }
-}