@codetreker/daynight 0.0.0-stage → 0.2.3

package/dist/processes.js.map

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

package/dist/repositories.d.ts

@@ -0,0 +1,15 @@
+import type { RepositoryConfiguration } from "./config.js";
+import type { RuntimePaths } from "./paths.js";
+export type AddRepositoryInput = {
+    remote: string;
+    path?: string;
+};
+export type AddRepositoryOptions = {
+    workingDirectory: string;
+    homeDirectory: string;
+};
+export type AddRepositoryResult = {
+    repository: RepositoryConfiguration;
+    added: boolean;
+};
+export declare const addRepository: (input: AddRepositoryInput, runtimePaths: RuntimePaths, options: AddRepositoryOptions) => Promise<AddRepositoryResult>;

package/dist/repositories.js

@@ -0,0 +1,159 @@
+import { randomUUID } from "node:crypto";
+import { lstat, mkdir, open, readFile, rename, unlink } from "node:fs/promises";
+import path from "node:path";
+import { Document } from "yaml";
+import { defaultRepositoryRoot, parseConfigurationDocument, remoteIdentity, resolveRepositoryRoot, validateConfigurationSource } from "./config.js";
+import { missingPathsReferToSameDirectory, resolvePhysicalDirectory } from "./paths.js";
+const hasCode = (error, code) => error instanceof Error && "code" in error && error.code === code;
+const repositoryPathComponent = (component) => {
+    let escaped = component.replace(/[<>:"/\\|?*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`)
+        .replace(/\.+$/, (dots) => "%2E".repeat(dots.length));
+    if (/^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\.|$)/i.test(escaped)) {
+        escaped = `%${escaped.charCodeAt(0).toString(16).toUpperCase()}${escaped.slice(1)}`;
+    }
+    return escaped;
+};
+const sameDirectory = async (first, second) => {
+    const [left, right] = await Promise.all([resolvePhysicalDirectory(first), resolvePhysicalDirectory(second)]);
+    if (left.ancestorIdentity !== right.ancestorIdentity || left.missingComponents.length !== right.missingComponents.length) {
+        return false;
+    }
+    return left.missingComponents.every((component, index) => component === right.missingComponents[index]) ||
+        missingPathsReferToSameDirectory(left.ancestorPath, left.missingComponents, right.missingComponents);
+};
+const updateConfiguration = async (input, runtimePaths, options) => {
+    let existingEntry;
+    try {
+        existingEntry = await lstat(runtimePaths.configFile);
+    }
+    catch (cause) {
+        if (!hasCode(cause, "ENOENT")) {
+            throw new Error(`Cannot inspect configuration file ${runtimePaths.configFile}.`, { cause });
+        }
+    }
+    if (existingEntry !== undefined && !existingEntry.isFile()) {
+        throw new Error(`Configuration file ${runtimePaths.configFile} must be a regular file; symbolic-link writes are not supported.`);
+    }
+    const source = existingEntry === undefined ? undefined : await readFile(runtimePaths.configFile, "utf8");
+    const existing = source === undefined ? undefined : await validateConfigurationSource(source, runtimePaths);
+    const document = source === undefined ? new Document({ repositoryRoot: defaultRepositoryRoot, repositories: [] }) : parseConfigurationDocument(source, runtimePaths);
+    const decoded = document.toJS();
+    const root = document.has("repositoryRoot") ? decoded.repositoryRoot : defaultRepositoryRoot;
+    const identity = remoteIdentity(input.remote, "remote");
+    const previous = existing?.repositories.find((repository) => repository.coordinate === identity.coordinate);
+    if (previous !== undefined && input.path === undefined) {
+        return { repository: previous, added: false };
+    }
+    let repositoryPath;
+    if (input.path === undefined) {
+        repositoryPath = path.join(resolveRepositoryRoot(root, runtimePaths, options.homeDirectory), ...[identity.host, identity.owner, identity.name].map(repositoryPathComponent));
+    }
+    else {
+        if (input.path.trim() === "" || input.path.includes("\0") || input.path.startsWith("~")) {
+            throw new Error("path must be a nonempty absolute path or working-directory-relative path without NUL characters; expand ~ before passing --path.");
+        }
+        if (path.sep === "\\" && /^[a-z]:(?![\\/])/i.test(input.path)) {
+            throw new Error("path must not use a drive-relative Windows path.");
+        }
+        repositoryPath = path.resolve(options.workingDirectory, input.path);
+    }
+    if (previous !== undefined) {
+        if (await sameDirectory(previous.path, repositoryPath)) {
+            return { repository: previous, added: false };
+        }
+        throw new Error(`Repository ${identity.coordinate} is already configured at ${previous.path}; the requested path ${repositoryPath} differs.`);
+    }
+    if (!document.has("repositoryRoot")) {
+        document.set("repositoryRoot", defaultRepositoryRoot);
+    }
+    document.addIn(["repositories"], { remote: input.remote, path: repositoryPath });
+    const updatedSource = document.toString();
+    const configuration = await validateConfigurationSource(updatedSource, runtimePaths);
+    const repository = configuration.repositories.at(-1);
+    const temporaryFile = path.join(path.dirname(runtimePaths.configFile), `.config-${randomUUID()}.tmp`);
+    const handle = await open(temporaryFile, "wx", 0o600);
+    let failure;
+    let renamed = false;
+    let closed = false;
+    try {
+        await handle.writeFile(updatedSource, "utf8");
+        if (existingEntry !== undefined) {
+            await handle.chmod(existingEntry.mode & 0o777);
+        }
+        await handle.sync();
+        await handle.close();
+        closed = true;
+        await rename(temporaryFile, runtimePaths.configFile);
+        renamed = true;
+        return { repository, added: true };
+    }
+    catch (cause) {
+        failure = cause;
+        throw cause;
+    }
+    finally {
+        const cleanup = [];
+        if (!closed) {
+            try {
+                await handle.close();
+            }
+            catch (cause) {
+                cleanup.push(cause);
+            }
+        }
+        if (!renamed) {
+            try {
+                await unlink(temporaryFile);
+            }
+            catch (cause) {
+                cleanup.push(cause);
+            }
+        }
+        if (cleanup.length !== 0) {
+            throw new AggregateError(failure === undefined ? cleanup : [failure, ...cleanup], "Configuration write or temporary-file cleanup failed.");
+        }
+    }
+};
+export const addRepository = async (input, runtimePaths, options) => {
+    if (!path.isAbsolute(options.workingDirectory) || !path.isAbsolute(options.homeDirectory)) {
+        throw new Error("The working directory and home directory must be absolute paths.");
+    }
+    await mkdir(path.dirname(runtimePaths.configFile), { recursive: true });
+    const lockFile = `${runtimePaths.configFile}.lock`;
+    let lock;
+    try {
+        lock = await open(lockFile, "wx", 0o600);
+    }
+    catch (cause) {
+        throw new Error(hasCode(cause, "EEXIST")
+            ? `Configuration is locked by another writer at ${lockFile}; retry when that writer exits. Remove the lock only after confirming no writer is running.`
+            : `Cannot acquire configuration lock ${lockFile}.`, { cause });
+    }
+    let failure;
+    try {
+        return await updateConfiguration(input, runtimePaths, options);
+    }
+    catch (cause) {
+        failure = cause;
+        throw cause;
+    }
+    finally {
+        const cleanup = [];
+        try {
+            await lock.close();
+        }
+        catch (cause) {
+            cleanup.push(cause);
+        }
+        try {
+            await unlink(lockFile);
+        }
+        catch (cause) {
+            cleanup.push(cause);
+        }
+        if (cleanup.length !== 0) {
+            throw new AggregateError(failure === undefined ? cleanup : [failure, ...cleanup], "Configuration update or lock cleanup failed.");
+        }
+    }
+};
+//# sourceMappingURL=repositories.js.map

package/dist/repositories.js.map

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

package/dist/review-list.d.ts

@@ -0,0 +1,5 @@
+import type { Configuration } from "./config.js";
+import type { RuntimePaths } from "./paths.js";
+import type { ReviewListingSnapshot } from "./store.js";
+export declare const formatReviewListing: (configuration: Configuration, snapshot: ReviewListingSnapshot | null) => string;
+export declare const listReviews: (paths: RuntimePaths) => Promise<string>;

package/dist/review-list.js

@@ -0,0 +1,122 @@
+import { readFile } from "node:fs/promises";
+import { parseConfiguration, remoteIdentity } from "./config.js";
+import { readReviewListingSnapshot } from "./store.js";
+const reviewNames = {
+    preparing: "Preparing",
+    running: "Running",
+    retry_wait: "Retry waiting",
+    completed: "Completed",
+    failed: "Failed",
+    interrupted: "Interrupted",
+    superseded: "Pending",
+};
+const activeStatuses = new Set(["preparing", "running", "retry_wait", "interrupted"]);
+const repositoryKey = ({ host, githubId }) => JSON.stringify([host.toLowerCase(), githubId]);
+const pullRequestKey = (pullRequest) => JSON.stringify([pullRequest.host.toLowerCase(), pullRequest.githubId, pullRequest.number]);
+const terminalSafe = (text) => text.replace(/[\u0000-\u001f\u007f-\u009f\u2028\u2029\u202a-\u202e\u2066-\u2069]/g, (character) => `\\u${character.charCodeAt(0).toString(16).padStart(4, "0")}`);
+const timestamp = (value) => new Date(value).toISOString();
+const reviewDetails = (review, prefix = "") => {
+    const lines = [];
+    if (review.retryAt !== null)
+        lines.push(`${prefix}Retry at: ${timestamp(review.retryAt)}`);
+    if (review.lastError !== null)
+        lines.push(`${prefix}Error: ${terminalSafe(review.lastError)}`);
+    return lines;
+};
+const rowFor = (pullRequest, reviews) => {
+    const ordered = [...reviews].sort((first, second) => first.createdAt - second.createdAt || first.updatedAt - second.updatedAt || first.id.localeCompare(second.id));
+    const isCurrent = (review) => review.revision === pullRequest.desiredRevision &&
+        review.headSha === pullRequest.headSha && review.baseRef === pullRequest.baseRef;
+    const current = ordered.filter(isCurrent).at(-1);
+    const previousActive = ordered.filter((review) => !isCurrent(review) && activeStatuses.has(review.status));
+    let status = current === undefined ? "Pending" : reviewNames[current.status];
+    if (pullRequest.draft)
+        status = "Paused";
+    else if (current === undefined && pullRequest.cleanupPending)
+        status = "Pending (cleanup blocked)";
+    else if (current === undefined && previousActive.length > 0) {
+        status = `Pending (previous revision ${reviewNames[previousActive.at(-1).status].toLowerCase()})`;
+    }
+    const details = current === undefined ? [] : reviewDetails(current);
+    if (pullRequest.draft && current !== undefined)
+        details.unshift(`Recorded review: ${reviewNames[current.status]}`);
+    if (pullRequest.cleanupPending) {
+        details.push("Worktree cleanup: Pending");
+        if (pullRequest.cleanupError !== null)
+            details.push(`Cleanup error: ${terminalSafe(pullRequest.cleanupError)}`);
+    }
+    for (const previous of previousActive) {
+        details.push(`Previous revision ${previous.revision}: ${reviewNames[previous.status]}; attempts: ${previous.attemptCount}/${previous.maxAttempts}`);
+        details.push(...reviewDetails(previous, "Previous revision "));
+    }
+    return {
+        columns: [`#${pullRequest.number}`, pullRequest.draft ? "Draft" : "Open", status, current === undefined ? "-" : String(current.attemptCount)],
+        details,
+    };
+};
+const renderRows = (rows) => {
+    const headings = ["PR", "PR STATE", "REVIEW", "ATTEMPTS"];
+    const widths = headings.map((heading, index) => Math.max(heading.length, ...rows.map(({ columns }) => columns[index].length)));
+    const line = (columns) => columns.map((value, index) => index === columns.length - 1 ? value : value.padEnd(widths[index])).join("   ");
+    return [line(headings), ...rows.flatMap((row) => [line(row.columns), ...row.details.map((detail) => `  ${detail}`)])];
+};
+export const formatReviewListing = (configuration, snapshot) => {
+    const configuredCoordinates = new Set(configuration.repositories.map(({ coordinate }) => coordinate));
+    const storedByCoordinate = new Map();
+    for (const repository of snapshot?.repositories ?? []) {
+        const { coordinate } = remoteIdentity(repository.remote, "Stored repository remote");
+        if (!configuredCoordinates.has(coordinate))
+            continue;
+        const previous = storedByCoordinate.get(coordinate);
+        if (previous !== undefined && repositoryKey(previous) !== repositoryKey(repository)) {
+            throw new Error(`Ambiguous persisted repository identity for ${coordinate}; multiple GitHub repository IDs match the configured remote.`);
+        }
+        storedByCoordinate.set(coordinate, repository);
+    }
+    const reviewsByPullRequest = new Map();
+    for (const review of snapshot?.reviews ?? []) {
+        const key = pullRequestKey(review);
+        const reviews = reviewsByPullRequest.get(key);
+        if (reviews === undefined)
+            reviewsByPullRequest.set(key, [review]);
+        else
+            reviews.push(review);
+    }
+    const groups = configuration.repositories.map(({ coordinate }) => {
+        const repository = storedByCoordinate.get(coordinate);
+        const lines = [coordinate, `Last observed: ${repository?.lastPollAt === null || repository === undefined ? "never" : timestamp(repository.lastPollAt)}`];
+        if (repository?.lastPollError !== null && repository?.lastPollError !== undefined) {
+            lines.push(`Last poll error: ${terminalSafe(repository.lastPollError)}`);
+        }
+        if (repository === undefined || repository.startPrNumber === null || repository.initializedAt === null) {
+            lines.push("Not initialized.");
+            return lines.join("\n");
+        }
+        const pullRequests = (snapshot?.pullRequests ?? []).filter((pullRequest) => repositoryKey(pullRequest) === repositoryKey(repository) && pullRequest.state === "open" && pullRequest.number > repository.startPrNumber)
+            .sort((first, second) => first.number - second.number);
+        if (pullRequests.length === 0)
+            lines.push("No tracked ongoing PRs.");
+        else
+            lines.push("", ...renderRows(pullRequests.map((pullRequest) => rowFor(pullRequest, reviewsByPullRequest.get(pullRequestKey(pullRequest)) ?? []))));
+        return lines.join("\n");
+    });
+    return `Local persisted snapshot (Running means recorded state, not proof of process liveness).\n\n${groups.join("\n\n")}\n`;
+};
+export const listReviews = async (paths) => {
+    let source;
+    try {
+        source = await readFile(paths.configFile, "utf8");
+    }
+    catch (cause) {
+        throw new Error(`Cannot read configuration file ${paths.configFile}.`, { cause });
+    }
+    let configuration;
+    try {
+        configuration = parseConfiguration(source, paths);
+    }
+    catch (cause) {
+        throw new Error(`Invalid configuration file ${paths.configFile}: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+    }
+    return formatReviewListing(configuration, readReviewListingSnapshot(paths.databaseFile));
+};
+//# sourceMappingURL=review-list.js.map

package/dist/review-list.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,24 @@
+import { createCopilotRunner } from "./copilot.js";
+import { runCoordinator } from "./coordinator.js";
+import { createGitManager } from "./git.js";
+import { createGitHubClient } from "./github.js";
+import { createProcessSupervisor } from "./processes.js";
+import { openStore } from "./store.js";
+import type { Configuration } from "./config.js";
+import type { CoordinatorEvent } from "./coordinator.js";
+import type { RuntimePaths } from "./paths.js";
+export { acquireInstanceLock } from "./instance-lock.js";
+export type RuntimeDependencies = {
+    openStore: typeof openStore;
+    createClient: typeof createGitHubClient;
+    createGit: typeof createGitManager;
+    createRunner: typeof createCopilotRunner;
+    createProcesses: typeof createProcessSupervisor;
+    coordinate: typeof runCoordinator;
+};
+export declare const formatCoordinatorEvent: (event: CoordinatorEvent) => string;
+export declare const runForegroundReview: (configuration: Configuration, paths: RuntimePaths, options?: {
+    signal?: AbortSignal;
+    log?: (event: CoordinatorEvent) => void;
+    dependencies?: RuntimeDependencies;
+}) => Promise<void>;

package/dist/runtime.js

@@ -0,0 +1,77 @@
+import { mkdir } from "node:fs/promises";
+import { formatError } from "./diagnostics.js";
+import { createCopilotRunner } from "./copilot.js";
+import { runCoordinator } from "./coordinator.js";
+import { createGitManager } from "./git.js";
+import { createGitHubClient } from "./github.js";
+import { acquireInstanceLock } from "./instance-lock.js";
+import { createProcessSupervisor } from "./processes.js";
+import { openStore } from "./store.js";
+export { acquireInstanceLock } from "./instance-lock.js";
+const defaultDependencies = {
+    openStore, createClient: createGitHubClient, createGit: createGitManager,
+    createRunner: createCopilotRunner, createProcesses: createProcessSupervisor, coordinate: runCoordinator,
+};
+export const formatCoordinatorEvent = (event) => {
+    const identity = [event.repository, event.number === undefined ? undefined : `PR ${event.number}`,
+        event.reviewId === undefined ? undefined : `review=${event.reviewId}`,
+        event.revision === undefined ? undefined : `revision=${event.revision}`,
+        event.attempt === undefined ? undefined : `attempt=${event.attempt}`].filter((value) => value !== undefined).join(" ");
+    return `${identity === "" ? "" : `${identity} `}${event.phase}: ${event.message}${event.retryAt === undefined ? "" : ` retryAt=${new Date(event.retryAt).toISOString()}`}${event.error === undefined ? "" : `\n${formatError(event.error)}`}`;
+};
+export const runForegroundReview = async (configuration, paths, options = {}) => {
+    const dependencies = options.dependencies === undefined ? defaultDependencies : options.dependencies;
+    const log = options.log === undefined ? (event) => { process.stderr.write(`${formatCoordinatorEvent(event)}\n`); } : options.log;
+    const controller = new AbortController();
+    const stop = () => { controller.abort(); };
+    const signals = process.platform === "win32" ? ["SIGINT", "SIGTERM", "SIGBREAK"] : ["SIGINT", "SIGTERM"];
+    if (options.signal === undefined)
+        for (const signal of signals)
+            process.on(signal, stop);
+    const signal = options.signal === undefined ? controller.signal : options.signal;
+    let lock;
+    let store;
+    let safe = true;
+    let failure;
+    try {
+        await mkdir(paths.stateDirectory, { recursive: true });
+        lock = await acquireInstanceLock(paths.lockFile);
+        safe = lock.previousProcessesExcluded;
+        signal.throwIfAborted();
+        store = dependencies.openStore(paths.databaseFile);
+        const client = dependencies.createClient();
+        const git = dependencies.createGit({ temporaryDirectory: paths.temporaryDirectory, client });
+        const processes = dependencies.createProcesses(lock.previousProcessesExcluded ? { previousProcessesExcluded: true } : {});
+        const runner = dependencies.createRunner({ paths, processOwner: lock.owner, timeoutMs: configuration.agentTimeoutMs });
+        log({ level: "info", phase: "startup", message: `Foreground review started; state=${paths.stateDirectory}.` });
+        safe = false;
+        const result = await dependencies.coordinate({ configuration, store, client, git, runner, processes, signal, log });
+        safe = result.safeToReleaseLock && processes.safeToReleaseLock;
+        if (!safe)
+            throw new Error(`Review execution could not be confirmed stopped. Instance lock ${paths.lockFile} and interrupted state were retained; confirm the CLI and all review agents have stopped before manually removing the lock.`);
+    }
+    catch (error) {
+        failure = error;
+    }
+    try {
+        store?.close();
+    }
+    catch (error) {
+        safe = false;
+        failure = failure === undefined ? error : new AggregateError([failure, error], "Review execution and database shutdown failed.");
+    }
+    if (lock !== undefined && safe) {
+        try {
+            await lock.release();
+        }
+        catch (error) {
+            failure = failure === undefined ? error : new AggregateError([failure, error], "Review execution and instance-lock release failed.");
+        }
+    }
+    if (options.signal === undefined)
+        for (const signal of signals)
+            process.off(signal, stop);
+    if (failure !== undefined)
+        throw failure;
+};
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,136 @@
+export type RepositoryIdentity = {
+    host: string;
+    githubId: string;
+};
+export type PullRequestIdentity = RepositoryIdentity & {
+    number: number;
+};
+export type RepositoryState = RepositoryIdentity & {
+    remote: string;
+    localPath: string;
+    startPrNumber: number | null;
+    initializedAt: number | null;
+    lastPollAt: number | null;
+    lastPollError: string | null;
+};
+export type PullRequestObservation = {
+    number: number;
+    state: "open" | "closed" | "merged";
+    draft: boolean;
+    headSha: string;
+    baseRef: string;
+    baseSha: string;
+};
+export type RepositoryPollUpdate = {
+    kind: "initialize";
+    startPrNumber: number;
+} | {
+    kind: "snapshot";
+    observations: readonly PullRequestObservation[];
+};
+export type PullRequestState = PullRequestIdentity & Omit<PullRequestObservation, "number"> & {
+    desiredRevision: number;
+    completedRevision: number;
+    sessionId: string | null;
+    sessionEstablished: boolean;
+    worktreePath: string | null;
+    cleanupPending: boolean;
+    cleanupError: string | null;
+    observedAt: number;
+};
+export type ReviewStatus = "preparing" | "running" | "retry_wait" | "completed" | "failed" | "interrupted" | "superseded";
+export type ReviewState = PullRequestIdentity & {
+    id: string;
+    revision: number;
+    headSha: string;
+    baseRef: string;
+    baseSha: string | null;
+    status: ReviewStatus;
+    attemptCount: number;
+    maxAttempts: number;
+    retryAt: number | null;
+    processOwner: string | null;
+    processId: number | null;
+    processIdentity: string | null;
+    stdoutLogPath: string | null;
+    stderrLogPath: string | null;
+    lastError: string | null;
+    createdAt: number;
+    updatedAt: number;
+};
+export type ReviewCandidate = {
+    pullRequest: PullRequestState;
+    review: ReviewState | null;
+};
+export type ReviewListingSnapshot = {
+    repositories: RepositoryState[];
+    pullRequests: PullRequestState[];
+    reviews: ReviewState[];
+};
+export type AttemptIdentity = {
+    reviewId: string;
+    attempt: number;
+};
+export type OperationsStopped = {
+    operationsStopped: true;
+};
+export type ProcessesExcluded = {
+    processesExcluded: true;
+};
+export declare const readReviewListingSnapshot: (databaseFile: string) => ReviewListingSnapshot | null;
+export declare const openStore: (databaseFile: string, options?: {
+    busyTimeoutMs?: number;
+}) => {
+    close: () => void;
+    getRepository: (identity: RepositoryIdentity) => RepositoryState | null;
+    getPullRequest: (identity: PullRequestIdentity) => PullRequestState | null;
+    getReview: (reviewId: string) => ReviewState | null;
+    listRepositories: () => RepositoryState[];
+    listPullRequests: (identity: RepositoryIdentity) => PullRequestState[];
+    listActiveReviews: () => ReviewState[];
+    listCleanupCandidates: () => PullRequestState[];
+    listReviews: (identity: PullRequestIdentity) => ReviewState[];
+    registerRepository: (input: RepositoryIdentity & {
+        remote: string;
+        localPath: string;
+    }) => RepositoryState;
+    initializeRepository: (identity: RepositoryIdentity, startPrNumber: number, now: number) => RepositoryState;
+    recordPollSuccess: (identity: RepositoryIdentity, now: number) => RepositoryState;
+    recordPollError: (identity: RepositoryIdentity, error: string) => RepositoryState;
+    observePullRequest: (identity: RepositoryIdentity, observation: PullRequestObservation, now: number) => PullRequestState | null;
+    listCandidates: (now: number) => ReviewCandidate[];
+    reserveReview: (identity: PullRequestIdentity, input: {
+        reviewId: string;
+        sessionId: string;
+        maxAttempts: number;
+    }, now: number) => ReviewState | null;
+    pinReviewBase: (reviewId: string, baseSha: string, now: number) => ReviewState;
+    startAttempt: (reviewId: string, input: {
+        processOwner: string;
+        stdoutLogPath: string;
+        stderrLogPath: string;
+    }, now: number) => ReviewState;
+    recordProcess: (identity: AttemptIdentity, input: {
+        pid: number;
+        identity: string;
+    }) => ReviewState;
+    markSessionEstablished: (identity: PullRequestIdentity) => PullRequestState;
+    completeReview: (identity: AttemptIdentity, proof: ProcessesExcluded, now: number) => ReviewState;
+    retryReview: (identity: AttemptIdentity, proof: ProcessesExcluded, input: {
+        error: string;
+        retryAt: number;
+    }, now: number) => ReviewState;
+    deferPreparation: (reviewId: string, proof: OperationsStopped, input: {
+        error: string;
+        retryAt: number;
+    }, now: number) => ReviewState;
+    markInterrupted: (reviewId: string, error: string, now: number) => ReviewState;
+    resolveInterrupted: (reviewId: string, proof: ProcessesExcluded & OperationsStopped, retryAt: number, now: number) => ReviewState;
+    supersedeReview: (reviewId: string, proof: OperationsStopped, now: number) => ReviewState;
+    registerWorktree: (identity: PullRequestIdentity, worktreePath: string) => PullRequestState;
+    recordCleanupError: (identity: PullRequestIdentity, worktreePath: string, error: string) => PullRequestState;
+    cancelCleanup: (identity: PullRequestIdentity, worktreePath: string, proof: OperationsStopped & ProcessesExcluded) => PullRequestState;
+    completeCleanup: (identity: PullRequestIdentity, worktreePath: string, proof: OperationsStopped & ProcessesExcluded) => PullRequestState;
+    applyRepositoryPoll: (identity: RepositoryIdentity, update: RepositoryPollUpdate, now: number) => RepositoryState;
+};
+export type Store = ReturnType<typeof openStore>;