oh-my-super-agent 0.1.0

package/dist/src/team/projection.js

@@ -0,0 +1,79 @@
+import { join } from "node:path";
+import { assertOpaqueId, assertRecordId } from "../domain/records.js";
+import { findPackageRoot } from "../package-root.js";
+import { assertSchema, loadJsonSchema } from "../runtime/schema.js";
+const TEAM_PROJECTIONS = new WeakSet();
+export function projectReadOnlyTeamState(value, packageRoot = findPackageRoot()) {
+    const detached = cloneJson(value);
+    const schema = loadJsonSchema(join(packageRoot, "schemas", "team-checkpoint.schema.json"));
+    assertSchema(detached, schema, "Team state projection");
+    const candidate = detached;
+    validateTeamCheckpointSemantics(candidate);
+    const normalized = {
+        ...candidate,
+        delivery_wave: {
+            ...candidate.delivery_wave,
+            workers: [...candidate.delivery_wave.workers].sort((left, right) => compareText(left.worker_id, right.worker_id)),
+        },
+    };
+    const projection = deepFreeze(normalized);
+    TEAM_PROJECTIONS.add(projection);
+    return projection;
+}
+export function validateTeamCheckpointSemantics(candidate) {
+    assertRecordId(candidate.goal_id, "Team goal id");
+    assertOpaqueId(candidate.delivery_wave.wave_id, "delivery wave id");
+    timestampEpoch(candidate.delivery_wave.completed_at, "delivery wave completed_at");
+    const workerIds = new Set();
+    const worktreeIds = new Set();
+    const evidenceHashes = new Set();
+    for (const worker of candidate.delivery_wave.workers) {
+        assertOpaqueId(worker.worker_id, "Team worker id");
+        assertOpaqueId(worker.worktree_id, "Team worktree id");
+        if (workerIds.has(worker.worker_id))
+            throw new Error(`duplicate Team worker evidence: ${worker.worker_id}`);
+        if (worktreeIds.has(worker.worktree_id))
+            throw new Error(`Team workers must use isolated worktrees: ${worker.worktree_id}`);
+        if (evidenceHashes.has(worker.evidence_sha256))
+            throw new Error("duplicate Team worker evidence digest");
+        if (worker.test_sha256 !== candidate.test_sha256)
+            throw new Error("conflicting Team worker test hashes");
+        workerIds.add(worker.worker_id);
+        worktreeIds.add(worker.worktree_id);
+        evidenceHashes.add(worker.evidence_sha256);
+    }
+}
+export function assertTeamCheckpointProjection(value) {
+    if (typeof value !== "object" || value === null || !TEAM_PROJECTIONS.has(value)) {
+        throw new Error("Team checkpoint was not created by the read-only projection boundary");
+    }
+}
+function timestampEpoch(value, label) {
+    const epoch = Date.parse(value);
+    const normalized = value.includes(".") ? value : value.replace("Z", ".000Z");
+    if (!Number.isFinite(epoch) || new Date(epoch).toISOString() !== normalized)
+        throw new Error(`${label} is invalid`);
+    return epoch;
+}
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function cloneJson(value) {
+    try {
+        const raw = JSON.stringify(value);
+        if (raw === undefined)
+            throw new Error("not JSON serializable");
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        throw new Error("Team state must be JSON serializable", { cause: error });
+    }
+}
+function deepFreeze(value) {
+    if (typeof value !== "object" || value === null || Object.isFrozen(value))
+        return value;
+    for (const child of Object.values(value))
+        deepFreeze(child);
+    return Object.freeze(value);
+}
+//# sourceMappingURL=projection.js.map

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

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

package/dist/src/tickets/admission.d.ts

@@ -0,0 +1,34 @@
+import type { EvidenceReference } from "../evidence/store.js";
+import { type ProcessRunner } from "../providers/process.js";
+import type { createRuntimeTicketAuthorities } from "./runtime-authority.js";
+type TicketAuthorities = ReturnType<typeof createRuntimeTicketAuthorities>;
+export interface TicketAdmission {
+    readonly ticket_id: string;
+    readonly ticket_version: number;
+    readonly attempt: number;
+    readonly worker_id: string;
+    readonly session_id: string;
+    readonly lease_token: string;
+    readonly worktree_id: string;
+    readonly worktree_path: string;
+    readonly worktree_branch: string;
+    readonly worktree_base_commit: string;
+    readonly verification_plan: EvidenceReference;
+}
+/**
+ * Deterministically prepares and leases ready GitHub tickets. The conductor still
+ * chooses role, model, task, and which admitted ticket to dispatch.
+ */
+export declare function admitReadyGithubTickets(options: {
+    readonly packageRoot: string;
+    readonly configRoot?: string;
+    readonly workspaceRoot: string;
+    readonly stateRoot: string;
+    readonly tickets: TicketAuthorities;
+    readonly ticketIds: readonly string[];
+    readonly at: string;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly runner?: ProcessRunner;
+    readonly limit?: number;
+}): readonly TicketAdmission[];
+export {};

package/dist/src/tickets/admission.js

@@ -0,0 +1,169 @@
+import { join } from "node:path";
+import { deriveWorktreeId } from "../dispatch/authority.js";
+import { runProcess } from "../providers/process.js";
+import { createStableId } from "../runtime/stable-id.js";
+import { validateExistingDirectory } from "../utils/fs.js";
+import { freezeTrackedVerificationPlan } from "../verification/plan.js";
+import { createTicketWorktree } from "../worktrees/manager.js";
+const MAX_ADMISSIONS = 20;
+const LEASE_DURATION_MS = 24 * 60 * 60 * 1_000;
+/**
+ * Deterministically prepares and leases ready GitHub tickets. The conductor still
+ * chooses role, model, task, and which admitted ticket to dispatch.
+ */
+export function admitReadyGithubTickets(options) {
+    const packageRoot = validateExistingDirectory(options.packageRoot, "package root");
+    const configRoot = validateExistingDirectory(options.configRoot ?? packageRoot, "configuration root");
+    const workspaceRoot = validateExistingDirectory(options.workspaceRoot, "ticket admission workspace root");
+    const stateRoot = validateExistingDirectory(options.stateRoot, "OMS state root");
+    const limit = options.limit ?? MAX_ADMISSIONS;
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > MAX_ADMISSIONS) {
+        throw new Error(`ticket admission limit must be between 1 and ${MAX_ADMISSIONS}`);
+    }
+    const runner = options.runner ?? runProcess;
+    const plan = freezeTrackedVerificationPlan(configRoot);
+    const ticketIds = new Set(options.ticketIds.map(String));
+    if (ticketIds.size !== options.ticketIds.length)
+        throw new Error("ticket admission input contains duplicate ticket IDs");
+    const candidates = options.tickets.queue.list()
+        .filter((ticket) => ticketIds.has(String(ticket.record_id)) && ticket.payload.source === "github" && (ticket.state === "pending"
+        || ticket.state === "retryable"
+        || ticket.state === "leased"))
+        .sort((left, right) => {
+        const stateOrder = Number(left.state === "leased") - Number(right.state === "leased");
+        return stateOrder || String(left.record_id).localeCompare(String(right.record_id));
+    })
+        .slice(0, limit);
+    return Object.freeze(candidates.map((candidate) => admitOne({
+        candidate,
+        workspaceRoot,
+        stateRoot,
+        tickets: options.tickets,
+        at: options.at,
+        plan,
+        env: options.env,
+        runner,
+    })));
+}
+function admitOne(options) {
+    let ticket = options.tickets.lifecycle.read(options.candidate.record_id);
+    if (ticket.version !== options.candidate.version || ticket.state !== options.candidate.state) {
+        throw new Error("ticket admission candidate changed before preparation");
+    }
+    if (options.tickets.lifecycle.authorityStatus(ticket.record_id) !== "current") {
+        throw new Error("ticket admission requires current policy and verification authority");
+    }
+    const planRef = ensurePlan(options.tickets, ticket, options.plan, options.at);
+    const worktree = createTicketWorktree({
+        repositoryRoot: options.workspaceRoot,
+        worktreesRoot: join(options.stateRoot, "worktrees"),
+        recordsRoot: join(options.stateRoot, "worktree-records"),
+        locksRoot: join(options.stateRoot, "locks"),
+        ticketId: ticket.record_id,
+        actorId: "oms-system",
+        transitionNonce: createStableId("admit-worktree", ticket.record_id),
+        baseRef: "main",
+        env: options.env,
+        runner: options.runner,
+    }).record;
+    if (ticket.state === "pending" && ticket.payload.verification_plan_ref === null) {
+        ticket = options.tickets.lifecycle.prepare({
+            ticketId: ticket.record_id,
+            operationId: createStableId("admit-prepare", ticket.record_id, options.plan.digest),
+            ownerId: "oms-system",
+            expectedVersion: ticket.version,
+            expectedAttempt: ticket.attempt,
+            expectedActor: ticket.actor,
+            expectedLeaseToken: ticket.lease_token,
+            at: nextTimestamp(ticket.payload.lifecycle_updated_at, options.at),
+            verificationPlanRef: planRef,
+            worktree: { branch: worktree.branch, base_commit: worktree.base_commit },
+        }).record;
+    }
+    else {
+        assertPrepared(ticket, planRef, worktree.branch, worktree.base_commit);
+    }
+    const leaseAttempt = ticket.state === "retryable" ? ticket.attempt + 1 : ticket.attempt;
+    const workerId = createStableId("worker", ticket.record_id, String(leaseAttempt));
+    const sessionId = createStableId("session", ticket.record_id, String(leaseAttempt));
+    if (ticket.state === "pending" || ticket.state === "retryable") {
+        const leaseAt = nextTimestamp(ticket.payload.lifecycle_updated_at, options.at);
+        ticket = options.tickets.lifecycle.lease({
+            ticketId: ticket.record_id,
+            operationId: createStableId("admit-lease", ticket.record_id, String(leaseAttempt)),
+            ownerId: "oms-system",
+            expectedVersion: ticket.version,
+            expectedAttempt: ticket.attempt,
+            expectedActor: ticket.actor,
+            expectedLeaseToken: ticket.lease_token,
+            at: leaseAt,
+            workerId,
+            sessionId,
+            leaseExpiresAt: new Date(Date.parse(leaseAt) + LEASE_DURATION_MS).toISOString(),
+        }).record;
+    }
+    else if (ticket.actor !== workerId
+        || ticket.payload.session_id !== sessionId
+        || ticket.payload.worktree?.branch !== worktree.branch
+        || ticket.payload.worktree.base_commit !== worktree.base_commit) {
+        throw new Error("ticket admission found a conflicting existing lease");
+    }
+    if (ticket.lease_token === null)
+        throw new Error("ticket admission did not create a lease token");
+    if (ticket.payload.lease_expires_at === null || Date.parse(ticket.payload.lease_expires_at) <= Date.parse(options.at)) {
+        throw new Error("ticket admission found an expired lease");
+    }
+    return Object.freeze({
+        ticket_id: ticket.record_id,
+        ticket_version: ticket.version,
+        attempt: ticket.attempt,
+        worker_id: workerId,
+        session_id: sessionId,
+        lease_token: ticket.lease_token,
+        worktree_id: deriveWorktreeId(worktree),
+        worktree_path: worktree.worktree_root,
+        worktree_branch: worktree.branch,
+        worktree_base_commit: worktree.base_commit,
+        verification_plan: planRef,
+    });
+}
+function ensurePlan(tickets, ticket, plan, at) {
+    const evidenceId = createStableId("ticket-plan", ticket.record_id, plan.digest);
+    const existing = tickets.evidenceStore.references("verification-plan")
+        .find((reference) => reference.evidence_id === evidenceId);
+    if (existing) {
+        const stored = tickets.evidenceStore.read(existing);
+        if (stored.ticket_id !== ticket.record_id || stored.payload.digest !== plan.digest) {
+            throw new Error("stored ticket admission verification plan conflicts with the current ticket");
+        }
+        return existing;
+    }
+    return tickets.evidenceStore.write({
+        schema_version: 1,
+        evidence_id: evidenceId,
+        evidence_kind: "verification-plan",
+        ticket_id: ticket.record_id,
+        producer_role: "oms.system",
+        created_at: nextTimestamp(ticket.payload.lifecycle_updated_at, at),
+        payload: { plan: plan.plan, digest: plan.digest },
+    }).ref;
+}
+function assertPrepared(ticket, plan, branch, baseCommit) {
+    const actual = ticket.payload.verification_plan_ref;
+    if (actual === null
+        || actual.evidence_id !== plan.evidence_id
+        || actual.sha256 !== plan.sha256
+        || actual.file_name !== plan.file_name
+        || ticket.payload.gate_digest === null
+        || ticket.payload.worktree?.branch !== branch
+        || ticket.payload.worktree.base_commit !== baseCommit)
+        throw new Error("ticket admission found conflicting prepared authority");
+}
+function nextTimestamp(previous, proposed) {
+    const previousMs = Date.parse(previous);
+    const proposedMs = Date.parse(proposed);
+    if (!Number.isFinite(previousMs) || !Number.isFinite(proposedMs))
+        throw new Error("ticket admission timestamp is invalid");
+    return new Date(Math.max(proposedMs, previousMs + 1)).toISOString();
+}
+//# sourceMappingURL=admission.js.map

package/dist/src/tickets/admission.js.map

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

package/dist/src/tickets/materializer.d.ts

@@ -0,0 +1 @@
+export { assertTicketMaterializer, assertTicketMaterializerEvidenceStore, createTicketMaterializer, type TicketMaterializer, } from "./store.js";

package/dist/src/tickets/materializer.js

@@ -0,0 +1,2 @@
+export { assertTicketMaterializer, assertTicketMaterializerEvidenceStore, createTicketMaterializer, } from "./store.js";
+//# sourceMappingURL=materializer.js.map

package/dist/src/tickets/materializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materializer.js","sourceRoot":"","sources":["../../../src/tickets/materializer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,qCAAqC,EACrC,wBAAwB,GAEzB,MAAM,YAAY,CAAC"}

package/dist/src/tickets/runtime-authority.d.ts

@@ -0,0 +1,32 @@
+export declare const OMS_SYSTEM_ACTORS: readonly ["oms-system", "github-sync", "oms-scheduler", "oms-watchdog"];
+export type OmsSystemActor = (typeof OMS_SYSTEM_ACTORS)[number];
+export declare function createRuntimeTicketAuthorities(options: {
+    packageRoot: string;
+    configRoot?: string;
+    stateRoot: string;
+    actorId: OmsSystemActor;
+}): Readonly<{
+    evidenceStore: import("../evidence/store.js").EvidenceStore;
+    queue: import("./store.js").TicketQueueStore;
+    materializer: import("./store.js").TicketMaterializer;
+    lifecycle: Readonly<{
+        read: (ticketId: string) => import("./store.js").TicketQueueRecord;
+        authorityStatus(ticketId: string): "current" | "stale-policy" | "stale-gate";
+        prepare(input: import("./store.js").PrepareTicketInput): import("./store.js").QueueMutationResult;
+        lease(input: import("./store.js").LeaseTicketInput): import("./store.js").QueueMutationResult;
+        renew(input: import("./store.js").ExpectedTicketMutation & {
+            leaseExpiresAt: string;
+        }): import("./store.js").QueueMutationResult;
+        start(input: import("./store.js").ExpectedTicketMutation): import("./store.js").QueueMutationResult;
+        beginVerification(input: import("./store.js").BeginVerificationInput): import("./store.js").QueueMutationResult;
+        complete(input: import("./store.js").CompleteTicketInput): import("./store.js").QueueMutationResult;
+        failAttempt(input: import("./store.js").FailAttemptInput): import("./store.js").QueueMutationResult;
+        blockVerification(input: import("./store.js").BlockVerificationInput): import("./store.js").QueueMutationResult;
+        attachRetryReflection(input: import("./store.js").AttachRetryReflectionInput): import("./store.js").QueueMutationResult;
+        park(input: import("./store.js").ParkTicketInput): import("./store.js").QueueMutationResult;
+        resume(input: import("./store.js").ResumeTicketInput): import("./store.js").QueueMutationResult;
+        quarantineStaleAuthority(input: import("./store.js").QuarantineTicketInput): import("./store.js").QueueMutationResult;
+        rebindUnpreparedAuthority(input: import("./store.js").ExpectedTicketMutation): import("./store.js").QueueMutationResult;
+        recoverExpiredLease(input: import("./store.js").ExpectedTicketMutation): import("./store.js").QueueMutationResult;
+    }>;
+}>;

package/dist/src/tickets/runtime-authority.js

@@ -0,0 +1,46 @@
+import { join } from "node:path";
+import { assertActorId } from "../domain/records.js";
+import { loadTrackedRolePolicyGate } from "../domain/role-policy.js";
+import { createEvidenceStore } from "../evidence/store.js";
+import { validateExistingDirectory } from "../utils/fs.js";
+import { createTicketContentStore, createTicketLifecycleService, createTicketMaterializer, createTicketQueueStore, } from "./store.js";
+export const OMS_SYSTEM_ACTORS = Object.freeze([
+    "oms-system",
+    "github-sync",
+    "oms-scheduler",
+    "oms-watchdog",
+]);
+export function createRuntimeTicketAuthorities(options) {
+    const suppliedPackageRoot = options.packageRoot;
+    const supplied = {
+        packageRoot: suppliedPackageRoot,
+        configRoot: options.configRoot ?? suppliedPackageRoot,
+        stateRoot: options.stateRoot,
+        actorId: options.actorId,
+    };
+    const packageRoot = validateExistingDirectory(supplied.packageRoot, "package root");
+    const configRoot = validateExistingDirectory(supplied.configRoot, "configuration root");
+    const stateRoot = validateExistingDirectory(supplied.stateRoot, "runtime state root");
+    const actorId = assertActorId(supplied.actorId, "runtime ticket actor");
+    if (!OMS_SYSTEM_ACTORS.includes(supplied.actorId)) {
+        throw new Error("runtime ticket actor is not a shipped OMS system actor");
+    }
+    const evidenceStore = createEvidenceStore({ evidenceRoot: join(stateRoot, "evidence"), packageRoot });
+    const queueStore = createTicketQueueStore({
+        recordsRoot: join(stateRoot, "queue"),
+        locksRoot: join(stateRoot, "locks"),
+        systemActors: OMS_SYSTEM_ACTORS,
+        policyGate: loadTrackedRolePolicyGate(configRoot),
+        packageRoot,
+        policyRoot: configRoot,
+        evidenceStore,
+    });
+    const ticketStore = createTicketContentStore({ ticketsRoot: join(stateRoot, "tickets"), packageRoot });
+    return Object.freeze({
+        evidenceStore,
+        queue: queueStore,
+        materializer: createTicketMaterializer({ queueStore, ticketStore, actorId }),
+        lifecycle: createTicketLifecycleService(queueStore),
+    });
+}
+//# sourceMappingURL=runtime-authority.js.map

package/dist/src/tickets/runtime-authority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-authority.js","sourceRoot":"","sources":["../../../src/tickets/runtime-authority.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7C,YAAY;IACZ,aAAa;IACb,eAAe;IACf,cAAc;CACN,CAAC,CAAC;AAIZ,MAAM,UAAU,8BAA8B,CAAC,OAK9C;IACC,MAAM,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAChD,MAAM,QAAQ,GAAG;QACf,WAAW,EAAE,mBAAmB;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,mBAAmB;QACrD,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;IACF,MAAM,WAAW,GAAG,yBAAyB,CAAC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACpF,MAAM,UAAU,GAAG,yBAAyB,CAAC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;IACxF,MAAM,SAAS,GAAG,yBAAyB,CAAC,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IACtF,MAAM,OAAO,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;IACxE,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;IACD,MAAM,aAAa,GAAG,mBAAmB,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IACtG,MAAM,UAAU,GAAG,sBAAsB,CAAC;QACxC,WAAW,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;QACrC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;QACnC,YAAY,EAAE,iBAAiB;QAC/B,UAAU,EAAE,yBAAyB,CAAC,UAAU,CAAC;QACjD,WAAW;QACX,UAAU,EAAE,UAAU;QACtB,aAAa;KACd,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,wBAAwB,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IACvG,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa;QACb,KAAK,EAAE,UAAU;QACjB,YAAY,EAAE,wBAAwB,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;QAC5E,SAAS,EAAE,4BAA4B,CAAC,UAAU,CAAC;KACpD,CAAC,CAAC;AACL,CAAC"}

package/dist/src/tickets/store.d.ts

@@ -0,0 +1,221 @@
+import { type RuntimeRecord } from "../domain/records.js";
+import { type EvidenceReference, type EvidenceStore } from "../evidence/store.js";
+import { type TrackedRolePolicyGate } from "../domain/role-policy.js";
+import { type QueueLifecycleFields, type TicketState } from "../queue/model.js";
+import { type ExhaustedQuotaGate, type FreshQuotaGate } from "../runtime/quota.js";
+import { type TransitionResult } from "../runtime/record-store.js";
+declare const TICKET_QUEUE_STORE: unique symbol;
+export type TicketSource = "github" | "local";
+export type { TicketState } from "../queue/model.js";
+export type TicketSyncStatus = "created" | "refreshed" | "unchanged";
+export interface GitHubTicketInput {
+    repository: string;
+    issue_node_id: string;
+    title: string;
+    body: string | null;
+    labels: string[];
+    url: string;
+    updated_at: string;
+}
+export interface LocalTicketInput {
+    ticket_id: string;
+    title: string;
+    body: string | null;
+    labels: string[];
+    url: string | null;
+    updated_at: string;
+}
+export type TicketContent = {
+    schema_version: 1;
+    ticket_id: string;
+    source: TicketSource;
+    repository: string | null;
+    issue_node_id: string | null;
+    title: string;
+    body: string | null;
+    labels: string[];
+    url: string | null;
+    updated_at: string;
+};
+export interface TicketWorktreeRef {
+    branch: string;
+    base_commit: string;
+}
+export interface TicketSyncOutcome {
+    nonce: string;
+    operation_sha256: string;
+    status: TicketSyncStatus;
+    content_sha256: string;
+    content_file: string;
+    record_version: number;
+}
+export type TicketQueuePayload = Record<string, unknown> & QueueLifecycleFields & {
+    ticket_id: string;
+    source: TicketSource;
+    source_ref_sha256: string;
+    content_sha256: string;
+    content_file: string;
+    source_updated_at: string;
+    ready_intent: true;
+    policy_version: number;
+    policy_digest: string;
+    gate_digest: string | null;
+    verification_plan_ref: EvidenceReference | null;
+    worktree: TicketWorktreeRef | null;
+    executor_evidence: EvidenceReference | null;
+    verification_evidence: EvidenceReference | null;
+    grade_evidence: EvidenceReference | null;
+    prior_failure_evidence: EvidenceReference | null;
+    prior_reflection_evidence: EvidenceReference | null;
+    merge_disposition: "human_hold";
+    sync_outcomes: TicketSyncOutcome[];
+};
+export interface TicketContentRef {
+    ticket_id: string;
+    sha256: string;
+    file_name: string;
+}
+export interface PreparedTicketContent {
+    content: TicketContent;
+    ref: TicketContentRef;
+    source_ref_sha256: string;
+    bytes: Buffer;
+}
+export interface TicketContentStore {
+    prepareGitHub(input: GitHubTicketInput): PreparedTicketContent;
+    prepareLocal(input: LocalTicketInput): PreparedTicketContent;
+    write(prepared: PreparedTicketContent): "created" | "replayed";
+    read(ref: TicketContentRef): TicketContent;
+}
+export interface TicketQueueStore {
+    readonly [TICKET_QUEUE_STORE]: true;
+    read(recordId: string): RuntimeRecord<TicketState, TicketQueuePayload>;
+    readIfExists(recordId: string): RuntimeRecord<TicketState, TicketQueuePayload> | undefined;
+    list(): readonly RuntimeRecord<TicketState, TicketQueuePayload>[];
+}
+export declare function assertTicketQueueStore(value: unknown): asserts value is TicketQueueStore;
+export interface TicketMaterializer {
+    syncGitHub(input: GitHubTicketInput): SyncTicketResult;
+    syncLocal(input: LocalTicketInput): SyncTicketResult;
+    readContent(ref: TicketContentRef): TicketContent;
+    read(recordId: string): TicketQueueRecord;
+    readIfExists(recordId: string): TicketQueueRecord | undefined;
+}
+interface SyncTicketOptions {
+    ticketStore: TicketContentStore;
+    queueStore: TicketQueueStore;
+    actorId: string;
+    maxAttempts?: number;
+}
+export interface SyncGitHubTicketOptions extends SyncTicketOptions {
+    input: GitHubTicketInput;
+}
+export interface SyncLocalTicketOptions extends SyncTicketOptions {
+    input: LocalTicketInput;
+}
+export type SyncTicketResult = {
+    status: TicketSyncStatus;
+    ref: TicketContentRef;
+    record: RuntimeRecord<TicketState, TicketQueuePayload>;
+};
+export type TicketQueueRecord = RuntimeRecord<TicketState, TicketQueuePayload>;
+export type QueueMutationResult = TransitionResult<TicketState, TicketQueuePayload>;
+export interface ExpectedTicketMutation {
+    ticketId: string;
+    operationId: string;
+    ownerId: string;
+    expectedVersion: number;
+    expectedAttempt: number;
+    expectedActor: string;
+    expectedLeaseToken: string | null;
+    at: string;
+}
+export interface PrepareTicketInput extends ExpectedTicketMutation {
+    verificationPlanRef: EvidenceReference;
+    worktree: TicketWorktreeRef;
+}
+export interface LeaseTicketInput extends ExpectedTicketMutation {
+    workerId: string;
+    sessionId: string;
+    leaseExpiresAt: string;
+}
+export interface BeginVerificationInput extends ExpectedTicketMutation {
+    executorEvidence: EvidenceReference;
+}
+export interface CompleteTicketInput extends ExpectedTicketMutation {
+    verificationEvidence: EvidenceReference;
+    gradeEvidence: EvidenceReference;
+}
+export interface FailAttemptInput extends ExpectedTicketMutation {
+    error: string;
+    executorEvidence?: EvidenceReference;
+    verificationEvidence?: EvidenceReference;
+    gradeEvidence?: EvidenceReference;
+    failureEvidence?: EvidenceReference;
+    reflectionEvidence?: EvidenceReference;
+}
+export interface BlockVerificationInput extends ExpectedTicketMutation {
+    error: string;
+    verificationEvidence?: EvidenceReference;
+    gradeEvidence?: EvidenceReference;
+}
+export interface AttachRetryReflectionInput extends ExpectedTicketMutation {
+    reflectionEvidence: EvidenceReference;
+}
+export interface ParkTicketInput extends ExpectedTicketMutation {
+    resumeAt: string;
+    reason: string;
+    quotaGate?: ExhaustedQuotaGate;
+}
+export interface ResumeTicketInput extends ExpectedTicketMutation {
+    quotaGate?: FreshQuotaGate;
+}
+export interface QuarantineTicketInput extends ExpectedTicketMutation {
+    reason: string;
+}
+export declare function deriveGitHubTicketIdentity(input: Pick<GitHubTicketInput, "issue_node_id">): {
+    ticket_id: string;
+    source_ref_sha256: string;
+};
+export declare function createTicketQueueStore(options: {
+    recordsRoot: string;
+    locksRoot: string;
+    systemActors: readonly string[];
+    policyGate: TrackedRolePolicyGate;
+    packageRoot?: string;
+    policyRoot?: string;
+    evidenceStore?: EvidenceStore;
+}): TicketQueueStore;
+export declare function createTicketLifecycleService(store: TicketQueueStore): Readonly<{
+    read: (ticketId: string) => TicketQueueRecord;
+    authorityStatus(ticketId: string): "current" | "stale-policy" | "stale-gate";
+    prepare(input: PrepareTicketInput): QueueMutationResult;
+    lease(input: LeaseTicketInput): QueueMutationResult;
+    renew(input: ExpectedTicketMutation & {
+        leaseExpiresAt: string;
+    }): QueueMutationResult;
+    start(input: ExpectedTicketMutation): QueueMutationResult;
+    beginVerification(input: BeginVerificationInput): QueueMutationResult;
+    complete(input: CompleteTicketInput): QueueMutationResult;
+    failAttempt(input: FailAttemptInput): QueueMutationResult;
+    blockVerification(input: BlockVerificationInput): QueueMutationResult;
+    attachRetryReflection(input: AttachRetryReflectionInput): QueueMutationResult;
+    park(input: ParkTicketInput): QueueMutationResult;
+    resume(input: ResumeTicketInput): QueueMutationResult;
+    quarantineStaleAuthority(input: QuarantineTicketInput): QueueMutationResult;
+    rebindUnpreparedAuthority(input: ExpectedTicketMutation): QueueMutationResult;
+    recoverExpiredLease(input: ExpectedTicketMutation): QueueMutationResult;
+}>;
+export declare function createTicketMaterializer(options: {
+    queueStore: TicketQueueStore;
+    ticketStore: TicketContentStore;
+    actorId: string;
+}): TicketMaterializer;
+export declare function assertTicketMaterializer(value: unknown): asserts value is TicketMaterializer;
+export declare function assertTicketMaterializerEvidenceStore(materializer: TicketMaterializer, evidenceStore: EvidenceStore): void;
+export declare function createTicketContentStore(options: {
+    ticketsRoot: string;
+    packageRoot?: string;
+}): TicketContentStore;
+export declare function syncGitHubTicket(options: SyncGitHubTicketOptions): SyncTicketResult;
+export declare function syncLocalTicket(options: SyncLocalTicketOptions): SyncTicketResult;