oh-my-super-agent 0.1.0

package/dist/src/state.js

@@ -0,0 +1,235 @@
+import { chmodSync, existsSync, lstatSync, mkdirSync, readdirSync, statSync, unlinkSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { canonicalizePath, isRecord, readJsonFileNoFollow, writeJsonAtomic } from "./utils/fs.js";
+const STATE_DIRECTORIES = [
+    "locks",
+    "queue",
+    "tickets",
+    "worktrees",
+    "worktree-records",
+    "trace-operations",
+    "quota",
+    "sessions",
+    "conductors",
+    "conductor-activity",
+    "conductor-notifications",
+    "conductor-notification-assignments",
+    "conductor-waiters",
+    "live-contacts",
+    "dispatches",
+    "dispatch-preparations",
+    "dispatch-advice",
+    "workers",
+    "github-watermarks",
+    "github-snapshots",
+    "outbox",
+    "outbox/events",
+    "outbox/receipts",
+    "audit",
+    "run-manifests",
+    "run-decisions",
+    "run-start-intents",
+    "run-completion-proofs",
+    "run-aborts",
+    "goals",
+    "goal-artifacts",
+    "service-plans",
+    "schedule-installations",
+    "team-plans",
+    "structured-role-requests",
+    "structured-role-results",
+    "result-gates",
+    "review-deliveries",
+    "review-proofs",
+    "secret-scan",
+    "codex-structured-results",
+    "evidence",
+    "tmp",
+];
+const INITIALIZING_MARKER = ".oms-initializing.json";
+export function resolveStateRoot(options) {
+    const env = options.env ?? process.env;
+    const cwd = options.cwd ?? process.cwd();
+    const candidate = options.override || env.OMS_STATE_ROOT || join(options.workspaceRoot, ".oms");
+    const stateRoot = canonicalizePath(candidate, cwd);
+    const workspaceRoot = canonicalizePath(options.workspaceRoot, cwd);
+    const configuredHome = env.HOME || homedir();
+    const homeRoot = configuredHome ? canonicalizePath(configuredHome, cwd) : undefined;
+    if (stateRoot === "/")
+        throw new Error("refusing to use the filesystem root as runtime state");
+    if (stateRoot === workspaceRoot)
+        throw new Error("refusing to use the workspace root as runtime state");
+    if (homeRoot && stateRoot === homeRoot)
+        throw new Error("refusing to use the home directory as runtime state");
+    if (existsSync(stateRoot) && !statSync(stateRoot).isDirectory()) {
+        throw new Error(`state root is not a directory: ${stateRoot}`);
+    }
+    return stateRoot;
+}
+export function initializeState(options) {
+    const stateRoot = resolveStateRoot(options);
+    const workspaceRoot = canonicalizePath(options.workspaceRoot, options.cwd ?? process.cwd());
+    const statePath = join(stateRoot, "state.json");
+    const initializingPath = join(stateRoot, INITIALIZING_MARKER);
+    let existingState;
+    let legacyState = false;
+    if (existsSync(stateRoot)) {
+        if (!lstatSync(stateRoot).isDirectory())
+            throw new Error(`state root is not a directory: ${stateRoot}`);
+        if (existsSync(statePath)) {
+            if (!lstatSync(statePath).isFile()) {
+                throw new Error(`existing state is not a regular file: ${statePath}`);
+            }
+            const raw = readJsonFileNoFollow(statePath);
+            existingState = parseRuntimeState(raw, stateRoot, workspaceRoot);
+            if (!existingState)
+                throw new Error(`existing state is invalid or belongs to another root or workspace: ${statePath}`);
+            legacyState = isRecord(raw) && raw.workspace_root === undefined;
+        }
+        if (existsSync(initializingPath)) {
+            assertInitializingMarker(readJsonFileNoFollow(initializingPath), stateRoot, workspaceRoot);
+        }
+        if (!existsSync(statePath) && !existsSync(initializingPath) && readdirSync(stateRoot).length > 0) {
+            throw new Error(`refusing to initialize a non-empty directory without a valid OMS state marker: ${stateRoot}`);
+        }
+    }
+    else {
+        mkdirSync(stateRoot, { recursive: true, mode: 0o700 });
+    }
+    if (!existsSync(statePath) && !existsSync(initializingPath)) {
+        writeJsonAtomic(initializingPath, {
+            version: 1,
+            state_root: stateRoot,
+            workspace_root: workspaceRoot,
+            status: "initializing",
+        });
+    }
+    chmodSync(stateRoot, 0o700);
+    for (const directory of STATE_DIRECTORIES)
+        ensurePrivateDirectory(join(stateRoot, directory));
+    if (!existsSync(statePath)) {
+        const state = {
+            version: 1,
+            state_root: stateRoot,
+            workspace_root: workspaceRoot,
+            initialized: true,
+            queue: { pending: 0, leased: 0 },
+        };
+        writeJsonAtomic(statePath, state);
+    }
+    else if (legacyState && existingState) {
+        writeJsonAtomic(statePath, existingState);
+    }
+    if (existsSync(initializingPath))
+        unlinkSync(initializingPath);
+    return stateRoot;
+}
+function assertInitializingMarker(value, stateRoot, workspaceRoot) {
+    const expectedKeys = value && isRecord(value) && value.workspace_root === undefined
+        ? ["state_root", "status", "version"]
+        : ["state_root", "status", "version", "workspace_root"];
+    if (!isRecord(value)
+        || Object.keys(value).sort().join("\0") !== expectedKeys.sort().join("\0")
+        || value.version !== 1
+        || value.state_root !== stateRoot
+        || (value.workspace_root === undefined
+            ? !legacyWorkspaceBindingIsSafe(stateRoot, workspaceRoot)
+            : value.workspace_root !== workspaceRoot)
+        || value.status !== "initializing") {
+        throw new Error(`existing OMS initialization marker is invalid: ${stateRoot}`);
+    }
+}
+export function readStateSummary(options) {
+    const stateRoot = resolveStateRoot(options);
+    const workspaceRoot = canonicalizePath(options.workspaceRoot, options.cwd ?? process.cwd());
+    const statePath = join(stateRoot, "state.json");
+    if (existsSync(statePath)) {
+        if (!lstatSync(statePath).isFile())
+            throw new Error(`existing state is not a regular file: ${statePath}`);
+        const state = parseRuntimeState(readJsonFileNoFollow(statePath), stateRoot, workspaceRoot);
+        if (!state)
+            throw new Error(`existing state is invalid or belongs to another root or workspace: ${statePath}`);
+        return {
+            state_root: stateRoot,
+            initialized: true,
+            queue: readQueueCounts(stateRoot),
+        };
+    }
+    return {
+        state_root: stateRoot,
+        initialized: false,
+        queue: { pending: 0, leased: 0 },
+    };
+}
+function readQueueCounts(stateRoot) {
+    const queueRoot = join(stateRoot, "queue");
+    const counts = { pending: 0, leased: 0 };
+    for (const entry of readdirSync(queueRoot, { withFileTypes: true })) {
+        if (!entry.isFile() || !/^[a-z0-9][a-z0-9.-]{0,127}\.json$/.test(entry.name)) {
+            throw new Error(`unsafe queue state entry: ${entry.name}`);
+        }
+        const record = readJsonFileNoFollow(join(queueRoot, entry.name), 1024 * 1024);
+        if (!isRecord(record) || typeof record.state !== "string")
+            throw new Error(`invalid queue state entry: ${entry.name}`);
+        if (record.state === "pending")
+            counts.pending += 1;
+        if (record.state === "leased")
+            counts.leased += 1;
+    }
+    return counts;
+}
+function parseRuntimeState(value, expectedRoot, expectedWorkspace) {
+    if (!isRecord(value) || value.version !== 1 || value.initialized !== true || typeof value.state_root !== "string") {
+        return undefined;
+    }
+    if (expectedRoot && value.state_root !== expectedRoot)
+        return undefined;
+    const workspaceRoot = typeof value.workspace_root === "string"
+        ? value.workspace_root
+        : expectedRoot && expectedWorkspace && legacyWorkspaceBindingIsSafe(expectedRoot, expectedWorkspace)
+            ? expectedWorkspace
+            : undefined;
+    if (!workspaceRoot || (expectedWorkspace && workspaceRoot !== expectedWorkspace))
+        return undefined;
+    if (!isRecord(value.queue) || !isCount(value.queue.pending) || !isCount(value.queue.leased))
+        return undefined;
+    return {
+        version: 1,
+        state_root: value.state_root,
+        workspace_root: workspaceRoot,
+        initialized: true,
+        queue: {
+            pending: value.queue.pending,
+            leased: value.queue.leased,
+        },
+    };
+}
+function legacyWorkspaceBindingIsSafe(stateRoot, workspaceRoot) {
+    if (stateRoot === join(workspaceRoot, ".oms"))
+        return true;
+    const launchPath = join(stateRoot, "conductors", "conductor.json");
+    if (!existsSync(launchPath))
+        return false;
+    const entry = lstatSync(launchPath);
+    if (entry.isSymbolicLink() || !entry.isFile())
+        return false;
+    const launch = readJsonFileNoFollow(launchPath, 64 * 1024);
+    return isRecord(launch)
+        && launch.workspace_root === workspaceRoot
+        && launch.state_root === stateRoot;
+}
+function isCount(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function ensurePrivateDirectory(path) {
+    if (existsSync(path)) {
+        if (!lstatSync(path).isDirectory())
+            throw new Error(`runtime path is not a regular directory: ${path}`);
+    }
+    else {
+        mkdirSync(path, { mode: 0o700 });
+    }
+    chmodSync(path, 0o700);
+}
+//# sourceMappingURL=state.js.map

package/dist/src/state.js.map

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

package/dist/src/status/hud.d.ts

@@ -0,0 +1,37 @@
+import { type OutboxStore } from "../outbox/store.js";
+import { type QuotaObservationStore, type QuotaStatus } from "../runtime/quota.js";
+import { type SessionRegistry, type SessionState } from "../sessions/registry.js";
+import { type TicketQueueStore } from "../tickets/store.js";
+import type { TicketState } from "../queue/model.js";
+import type { LinuxProcessIdentity } from "../runtime/process-identity.js";
+import { type WorkerActivity, type WorkerHealth, type WorkerRegistry } from "../workers/registry.js";
+import { type ConductorActivity, type ConductorActivityStore, type ConductorHealth } from "../conductor/activity.js";
+export interface HudSnapshot {
+    readonly release: "not_stable";
+    readonly tickets: Readonly<Record<TicketState, number>>;
+    readonly sessions: Readonly<Record<SessionState, number>>;
+    readonly quota: Readonly<Record<QuotaStatus, number>>;
+    readonly workers: {
+        readonly activity: Readonly<Record<WorkerActivity, number>>;
+        readonly health: Readonly<Record<WorkerHealth, number>>;
+    };
+    readonly conductor: {
+        readonly activity: Readonly<Record<ConductorActivity, number>>;
+        readonly health: Readonly<Record<ConductorHealth, number>>;
+    };
+    readonly outbox: {
+        readonly total_events: number;
+        readonly stalled_internal_deliveries: number;
+        readonly pending_slack_requests: number;
+    };
+}
+export declare function createHudSnapshot(options: {
+    queue: TicketQueueStore;
+    sessions: SessionRegistry;
+    quota: QuotaObservationStore;
+    outbox: OutboxStore;
+    workers: WorkerRegistry;
+    conductorActivity: ConductorActivityStore;
+    conductorProcessIsLive: (identity: LinuxProcessIdentity) => boolean;
+}): HudSnapshot;
+export declare function renderHud(snapshot: HudSnapshot): string;

package/dist/src/status/hud.js

@@ -0,0 +1,88 @@
+import { assertOutboxStore } from "../outbox/store.js";
+import { assertQuotaObservationStore } from "../runtime/quota.js";
+import { assertSessionRegistry } from "../sessions/registry.js";
+import { assertTicketQueueStore } from "../tickets/store.js";
+import { assertWorkerRegistry, WORKER_ACTIVITIES, WORKER_HEALTH_STATES, } from "../workers/registry.js";
+import { assertConductorActivityStore, CONDUCTOR_ACTIVITIES, } from "../conductor/activity.js";
+export function createHudSnapshot(options) {
+    const captured = {
+        queue: options.queue,
+        sessions: options.sessions,
+        quota: options.quota,
+        outbox: options.outbox,
+        workers: options.workers,
+        conductorActivity: options.conductorActivity,
+        conductorProcessIsLive: options.conductorProcessIsLive,
+    };
+    assertTicketQueueStore(captured.queue);
+    assertSessionRegistry(captured.sessions);
+    assertQuotaObservationStore(captured.quota);
+    assertOutboxStore(captured.outbox);
+    assertWorkerRegistry(captured.workers);
+    assertConductorActivityStore(captured.conductorActivity);
+    const tickets = countStates(["pending", "leased", "running", "verifying", "retryable", "parked", "blocked", "completed"], captured.queue.list().map((record) => record.state));
+    const sessions = countStates(["running", "parked", "stalled", "stopped"], captured.sessions.list().map((record) => record.state));
+    const quota = countStates(["available", "exhausted", "unknown"], captured.quota.list().map((record) => record.status));
+    const workerRecords = captured.workers.list();
+    const conductorRecords = latestConductorGeneration(captured.conductorActivity.list());
+    const conductorHealth = conductorRecords.map((record) => (record.payload.health === "stopped" || captured.conductorProcessIsLive(record.payload.conductor_process)
+        ? record.payload.health
+        : "stalled"));
+    const events = captured.outbox.listEvents();
+    return deepFreeze({
+        release: "not_stable",
+        tickets,
+        sessions,
+        quota,
+        workers: {
+            activity: countStates(WORKER_ACTIVITIES, workerRecords.map((record) => record.state)),
+            health: countStates(WORKER_HEALTH_STATES, workerRecords.map((record) => record.payload.health)),
+        },
+        conductor: {
+            activity: countStates(CONDUCTOR_ACTIVITIES, conductorRecords.map((record) => record.state)),
+            health: countStates(["healthy", "stalled", "stopped"], conductorHealth),
+        },
+        outbox: {
+            total_events: events.length,
+            stalled_internal_deliveries: events.filter((event) => event.event_kind === "watchdog-outbox-stalled").length,
+            pending_slack_requests: events.filter((event) => event.event_kind === "slack-notification-requested").length,
+        },
+    });
+}
+function latestConductorGeneration(records) {
+    if (records.length === 0)
+        return Object.freeze([]);
+    const latest = [...records].sort((left, right) => (right.payload.launch_generation - left.payload.launch_generation
+        || right.payload.updated_at.localeCompare(left.payload.updated_at)
+        || String(right.record_id).localeCompare(String(left.record_id))))[0];
+    return Object.freeze([latest]);
+}
+export function renderHud(snapshot) {
+    return [
+        `OMS release=${snapshot.release}`,
+        `tickets pending=${snapshot.tickets.pending} active=${snapshot.tickets.leased + snapshot.tickets.running + snapshot.tickets.verifying} retryable=${snapshot.tickets.retryable} parked=${snapshot.tickets.parked} blocked=${snapshot.tickets.blocked} completed=${snapshot.tickets.completed}`,
+        `sessions running=${snapshot.sessions.running} parked=${snapshot.sessions.parked} stalled=${snapshot.sessions.stalled} stopped=${snapshot.sessions.stopped}`,
+        `workers idle=${snapshot.workers.activity.idle} working=${snapshot.workers.activity.working} blocked=${snapshot.workers.activity.blocked} done=${snapshot.workers.activity.done} healthy=${snapshot.workers.health.healthy} parked=${snapshot.workers.health.parked} stalled=${snapshot.workers.health.stalled} stopped=${snapshot.workers.health.stopped}`,
+        `conductor idle=${snapshot.conductor.activity.idle} working=${snapshot.conductor.activity.working} blocked=${snapshot.conductor.activity.blocked} done=${snapshot.conductor.activity.done} healthy=${snapshot.conductor.health.healthy} stalled=${snapshot.conductor.health.stalled} stopped=${snapshot.conductor.health.stopped}`,
+        `quota available=${snapshot.quota.available} exhausted=${snapshot.quota.exhausted} unknown=${snapshot.quota.unknown}`,
+        `outbox events=${snapshot.outbox.total_events} stalled=${snapshot.outbox.stalled_internal_deliveries} slack_requests=${snapshot.outbox.pending_slack_requests}`,
+    ].join("\n");
+}
+function countStates(states, values) {
+    const result = Object.fromEntries(states.map((state) => [state, 0]));
+    for (const value of values) {
+        if (!(value in result))
+            throw new Error(`unknown HUD state: ${value}`);
+        result[value] += 1;
+    }
+    return Object.freeze(result);
+}
+function deepFreeze(value, seen = new Set()) {
+    if (typeof value !== "object" || value === null || seen.has(value))
+        return value;
+    seen.add(value);
+    for (const child of Object.values(value))
+        deepFreeze(child, seen);
+    return Object.freeze(value);
+}
+//# sourceMappingURL=hud.js.map

package/dist/src/status/hud.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hud.js","sourceRoot":"","sources":["../../../src/status/hud.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAoB,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAgD,MAAM,qBAAqB,CAAC;AAChH,OAAO,EAAE,qBAAqB,EAA2C,MAAM,yBAAyB,CAAC;AACzG,OAAO,EAAE,sBAAsB,EAAyB,MAAM,qBAAqB,CAAC;AAGpF,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,GAIrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,4BAA4B,EAC5B,oBAAoB,GAIrB,MAAM,0BAA0B,CAAC;AAsBlC,MAAM,UAAU,iBAAiB,CAAC,OAQjC;IACC,MAAM,QAAQ,GAAG;QACf,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;KACvD,CAAC;IACF,sBAAsB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvC,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,2BAA2B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnC,oBAAoB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvC,4BAA4B,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,WAAW,CACzB,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,EAC5F,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CACpD,CAAC;IACF,MAAM,QAAQ,GAAG,WAAW,CAC1B,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,EAC3C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;IACF,MAAM,KAAK,GAAG,WAAW,CACvB,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,EACrC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CACrD,CAAC;IACF,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;IACtF,MAAM,eAAe,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAmB,EAAE,CAAC,CACxE,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,sBAAsB,CAAC,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC;QACtG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM;QACvB,CAAC,CAAC,SAAS,CACd,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;IAC5C,OAAO,UAAU,CAAC;QAChB,OAAO,EAAE,YAAqB;QAC9B,OAAO;QACP,QAAQ;QACR,KAAK;QACL,OAAO,EAAE;YACP,QAAQ,EAAE,WAAW,CAAC,iBAAiB,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrF,MAAM,EAAE,WAAW,CAAC,oBAAoB,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;SAChG;QACD,SAAS,EAAE;YACT,QAAQ,EAAE,WAAW,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3F,MAAM,EAAE,WAAW,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAU,EAAE,eAAe,CAAC;SACjF;QACD,MAAM,EAAE;YACN,YAAY,EAAE,MAAM,CAAC,MAAM;YAC3B,2BAA2B,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,yBAAyB,CAAC,CAAC,MAAM;YAC5G,sBAAsB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,8BAA8B,CAAC,CAAC,MAAM;SAC7G;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,yBAAyB,CAChC,OAAmD;IAEnD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAChD,KAAK,CAAC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB;WAC7D,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;WAC/D,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CACjE,CAAC,CAAC,CAAC,CAAE,CAAC;IACP,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAqB;IAC7C,OAAO;QACL,eAAe,QAAQ,CAAC,OAAO,EAAE;QACjC,mBAAmB,QAAQ,CAAC,OAAO,CAAC,OAAO,WAAW,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,cAAc,QAAQ,CAAC,OAAO,CAAC,SAAS,WAAW,QAAQ,CAAC,OAAO,CAAC,MAAM,YAAY,QAAQ,CAAC,OAAO,CAAC,OAAO,cAAc,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE;QAC7R,oBAAoB,QAAQ,CAAC,QAAQ,CAAC,OAAO,WAAW,QAAQ,CAAC,QAAQ,CAAC,MAAM,YAAY,QAAQ,CAAC,QAAQ,CAAC,OAAO,YAAY,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE;QAC5J,gBAAgB,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,YAAY,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,YAAY,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,SAAS,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,YAAY,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,YAAY,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,YAAY,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE;QAC3V,kBAAkB,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,YAAY,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,YAAY,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,SAAS,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,YAAY,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,YAAY,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,YAAY,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE;QAClU,mBAAmB,QAAQ,CAAC,KAAK,CAAC,SAAS,cAAc,QAAQ,CAAC,KAAK,CAAC,SAAS,YAAY,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE;QACrH,iBAAiB,QAAQ,CAAC,MAAM,CAAC,YAAY,YAAY,QAAQ,CAAC,MAAM,CAAC,2BAA2B,mBAAmB,QAAQ,CAAC,MAAM,CAAC,sBAAsB,EAAE;KAChK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAuB,MAAwB,EAAE,MAAyB;IAC5F,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAA0B,CAAC;IAC9F,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,EAAE,CAAC,CAAC;QACvE,MAAM,CAAC,KAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,UAAU,CAAI,KAAQ,EAAE,OAAO,IAAI,GAAG,EAAU;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACjF,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/src/team/plan.d.ts

@@ -0,0 +1,31 @@
+import { type DispatchAuthority } from "../dispatch/authority.js";
+export interface ExecutorGroupManifest {
+    readonly schema_version: 1;
+    readonly manifest_id: string;
+    readonly manifest_kind: "executor-group";
+    readonly goal_id: string;
+    readonly goal_version: number;
+    readonly dispatch_ids: readonly string[];
+    readonly manifest_path: string;
+}
+declare const GENERATED_EXECUTOR_GROUP: unique symbol;
+export interface GeneratedExecutorGroupManifest {
+    readonly [GENERATED_EXECUTOR_GROUP]: true;
+    readonly plan: ExecutorGroupManifest;
+    readonly digest: string;
+}
+export interface GenerateExecutorGroupManifestOptions {
+    readonly dispatchIds: readonly string[];
+    readonly dispatchAuthority: DispatchAuthority;
+    readonly teamPlansRoot: string;
+    readonly packageRoot: string;
+}
+export declare function generateExecutorGroupManifest(options: GenerateExecutorGroupManifestOptions): GeneratedExecutorGroupManifest;
+export declare function persistExecutorGroupManifest(options: {
+    readonly generated: GeneratedExecutorGroupManifest;
+}): Readonly<{
+    status: "created" | "replayed";
+    path: string;
+}>;
+export declare function assertGeneratedExecutorGroupManifest(value: unknown): asserts value is GeneratedExecutorGroupManifest;
+export {};

package/dist/src/team/plan.js

@@ -0,0 +1,184 @@
+import { createHash } from "node:crypto";
+import { mkdirSync } from "node:fs";
+import { dirname, isAbsolute, join } from "node:path";
+import { assertDispatchAuthority, } from "../dispatch/authority.js";
+import { assertRecordId } from "../domain/records.js";
+import { assertFileInside, openStableDirectory, writeImmutableFile, } from "../evidence/immutable-file.js";
+import { assertSchema, loadJsonSchema } from "../runtime/schema.js";
+import { createStableId } from "../runtime/stable-id.js";
+import { validateExistingDirectory } from "../utils/fs.js";
+const MAX_EXECUTORS = 20;
+const GENERATED_EXECUTOR_GROUP = Symbol("OMS generated executor group");
+const GENERATED_EXECUTOR_GROUPS = new WeakSet();
+const GENERATED_EXECUTOR_GROUP_METADATA = new WeakMap();
+export function generateExecutorGroupManifest(options) {
+    assertDispatchAuthority(options.dispatchAuthority);
+    const packageRoot = validateExistingDirectory(options.packageRoot, "package root");
+    const teamPlansRoot = validateExistingDirectory(options.teamPlansRoot, "Team plans root");
+    const dispatchIds = canonicalDispatchIds(options.dispatchIds);
+    const dispatches = acceptedDispatches(options.dispatchAuthority, dispatchIds);
+    const goal = commonGoal(dispatches);
+    assertIsolatedBindings(dispatches);
+    const manifestId = createStableId("team", goal.goalId, String(goal.goalVersion), ...dispatchIds);
+    const manifest = deepFreeze({
+        schema_version: 1,
+        manifest_id: manifestId,
+        manifest_kind: "executor-group",
+        goal_id: goal.goalId,
+        goal_version: goal.goalVersion,
+        dispatch_ids: dispatchIds,
+        manifest_path: safeManifestPath(join(teamPlansRoot, manifestId, "manifest.json"), "Team manifest path"),
+    });
+    validateExecutorGroupManifest(manifest, packageRoot, teamPlansRoot, options.dispatchAuthority);
+    const generated = Object.freeze({
+        [GENERATED_EXECUTOR_GROUP]: true,
+        plan: manifest,
+        digest: sha256(canonicalBytes(manifest)),
+    });
+    GENERATED_EXECUTOR_GROUPS.add(generated);
+    GENERATED_EXECUTOR_GROUP_METADATA.set(generated, Object.freeze({
+        packageRoot,
+        teamPlansRoot,
+        dispatchAuthority: options.dispatchAuthority,
+    }));
+    return generated;
+}
+export function persistExecutorGroupManifest(options) {
+    const generated = options.generated;
+    assertGeneratedExecutorGroupManifest(generated);
+    const metadata = GENERATED_EXECUTOR_GROUP_METADATA.get(generated);
+    if (!metadata)
+        throw new Error("generated Team manifest metadata is unavailable");
+    validateExecutorGroupManifest(generated.plan, metadata.packageRoot, metadata.teamPlansRoot, metadata.dispatchAuthority);
+    if (sha256(canonicalBytes(generated.plan)) !== generated.digest) {
+        throw new Error("generated Team manifest digest changed before persistence");
+    }
+    const manifestDirectory = join(metadata.teamPlansRoot, generated.plan.manifest_id);
+    if (dirname(generated.plan.manifest_path) !== manifestDirectory) {
+        throw new Error("Team manifest path escaped its manifest directory");
+    }
+    try {
+        mkdirSync(manifestDirectory, { mode: 0o700 });
+    }
+    catch (error) {
+        if (!isErrorCode(error, "EEXIST"))
+            throw error;
+    }
+    const stable = openStableDirectory(manifestDirectory, "Team manifest directory");
+    try {
+        assertFileInside(stable, generated.plan.manifest_path);
+        const status = writeImmutableFile(generated.plan.manifest_path, canonicalBytes(generated.plan));
+        stable.assertUnchanged();
+        return Object.freeze({ status, path: generated.plan.manifest_path });
+    }
+    finally {
+        stable.close();
+    }
+}
+export function assertGeneratedExecutorGroupManifest(value) {
+    if (typeof value !== "object"
+        || value === null
+        || !GENERATED_EXECUTOR_GROUPS.has(value)) {
+        throw new Error("Team manifest persistence requires a real OMS generated manifest");
+    }
+    if (!Object.isFrozen(value)) {
+        throw new Error("generated Team manifest lost its frozen authority boundary");
+    }
+}
+function validateExecutorGroupManifest(manifest, packageRoot, teamPlansRoot, dispatchAuthority) {
+    assertSchema(manifest, loadJsonSchema(join(packageRoot, "schemas", "team-plan.schema.json")), "executor group manifest");
+    const dispatchIds = canonicalDispatchIds(manifest.dispatch_ids);
+    if (!sameStrings(dispatchIds, manifest.dispatch_ids)) {
+        throw new Error("Team manifest dispatch IDs must be in canonical order");
+    }
+    const dispatches = acceptedDispatches(dispatchAuthority, dispatchIds);
+    const goal = commonGoal(dispatches);
+    assertIsolatedBindings(dispatches);
+    if (manifest.goal_id !== goal.goalId || manifest.goal_version !== goal.goalVersion) {
+        throw new Error("Team manifest goal binding does not match its accepted dispatches");
+    }
+    const expectedId = createStableId("team", goal.goalId, String(goal.goalVersion), ...dispatchIds);
+    if (manifest.manifest_id !== expectedId) {
+        throw new Error("Team manifest identity does not match its accepted dispatches");
+    }
+    if (manifest.manifest_path !== join(teamPlansRoot, expectedId, "manifest.json")) {
+        throw new Error("Team manifest path is invalid");
+    }
+}
+function canonicalDispatchIds(value) {
+    if (!Array.isArray(value) || value.length < 1 || value.length > MAX_EXECUTORS) {
+        throw new Error(`Team executor group requires from 1 to ${MAX_EXECUTORS} dispatch IDs`);
+    }
+    const dispatchIds = value.map((dispatchId) => assertRecordId(dispatchId, "Team dispatch id"));
+    if (new Set(dispatchIds).size !== dispatchIds.length) {
+        throw new Error("Team executor group contains duplicate dispatch IDs");
+    }
+    return Object.freeze([...dispatchIds].sort(compareText));
+}
+function acceptedDispatches(dispatchAuthority, dispatchIds) {
+    assertDispatchAuthority(dispatchAuthority);
+    return dispatchIds.map((dispatchId) => {
+        const dispatch = dispatchAuthority.read(dispatchId);
+        if (dispatch.payload.accepted_at === null || dispatch.payload.delivery_event_id === null) {
+            throw new Error(`Team dispatch was not accepted for delivery: ${dispatchId}`);
+        }
+        return dispatch;
+    });
+}
+function commonGoal(dispatches) {
+    const first = dispatches[0];
+    if (!first)
+        throw new Error("Team executor group requires at least one dispatch");
+    for (const dispatch of dispatches.slice(1)) {
+        if (dispatch.payload.goal_id !== first.payload.goal_id
+            || dispatch.payload.goal_version !== first.payload.goal_version) {
+            throw new Error("Team executor group dispatches must share one goal version");
+        }
+    }
+    return Object.freeze({
+        goalId: first.payload.goal_id,
+        goalVersion: first.payload.goal_version,
+    });
+}
+function assertIsolatedBindings(dispatches) {
+    assertUnique(dispatches.map((dispatch) => dispatch.payload.ticket_id), "ticket IDs");
+    assertUnique(dispatches.map((dispatch) => dispatch.payload.lease_token), "lease tokens");
+    assertUnique(dispatches.map((dispatch) => dispatch.payload.session_id), "session IDs");
+    assertUnique(dispatches.map((dispatch) => dispatch.payload.worktree_id), "worktree IDs");
+    assertUnique(dispatches.map((dispatch) => dispatch.payload.worktree_path), "worktree paths");
+}
+function assertUnique(values, label) {
+    if (new Set(values).size !== values.length) {
+        throw new Error(`Team executor group requires unique ${label}`);
+    }
+}
+function safeManifestPath(value, label) {
+    if (!isAbsolute(value) || /[\0\r\n]/u.test(value)) {
+        throw new Error(`${label} must be an absolute path without control characters`);
+    }
+    return value;
+}
+function canonicalBytes(value) {
+    return Buffer.from(`${JSON.stringify(value, null, 2)}\n`, "utf8");
+}
+function sha256(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+function sameStrings(left, right) {
+    return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function isErrorCode(error, code) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === code;
+}
+function deepFreeze(value, seen = new Set()) {
+    if (typeof value !== "object" || value === null || seen.has(value))
+        return value;
+    seen.add(value);
+    for (const child of Object.values(value))
+        deepFreeze(child, seen);
+    return Object.freeze(value);
+}
+//# sourceMappingURL=plan.js.map

package/dist/src/team/plan.js.map

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

package/dist/src/team/projection.d.ts

@@ -0,0 +1,24 @@
+export interface TeamWorkerEvidence {
+    readonly worker_id: string;
+    readonly role: "delivery";
+    readonly status: "completed";
+    readonly terminal: true;
+    readonly worktree_id: string;
+    readonly test_sha256: string;
+    readonly evidence_sha256: string;
+}
+export interface TeamWave {
+    readonly wave_id: string;
+    readonly kind: "delivery";
+    readonly completed_at: string;
+    readonly workers: readonly TeamWorkerEvidence[];
+}
+export interface TeamCheckpointProjection {
+    readonly schema_version: 1;
+    readonly goal_id: string;
+    readonly test_sha256: string;
+    readonly delivery_wave: TeamWave;
+}
+export declare function projectReadOnlyTeamState(value: unknown, packageRoot?: string): Readonly<TeamCheckpointProjection>;
+export declare function validateTeamCheckpointSemantics(candidate: TeamCheckpointProjection): void;
+export declare function assertTeamCheckpointProjection(value: unknown): asserts value is Readonly<TeamCheckpointProjection>;