@hearsay-tools/squawk 0.0.0-stage → 0.17.0-dev.5685

package/dist/runs/project-run-connection.js

@@ -0,0 +1,287 @@
+import { RUN_DATABASE_READABLE_FROM, RUN_DATABASE_SCHEMA_VERSION } from './run-database-version.js';
+import { claimOwnerLive } from './run-claims.js';
+import { warnFallbackRunSource } from './project-run-sources.js';
+import { cpSync, lstatSync, mkdirSync, readFileSync, readdirSync, rmSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { pathPresent } from '../project-paths.js';
+import { RunConflictError } from './run-database.js';
+import { toRunBindings, toRunRow } from './run-database-row.js';
+/** A write reached a run that is still read only under `.ai/squawk/`. The store refuses such
+ *  writes first, so this error means a caller bypassed it. */
+export class FallbackWriteRefusedError extends Error {
+    runId;
+    constructor(runId, source) {
+        super(`Refused an automatic write to read-only run ${runId} from ${dirname(source)}. Use the binary that migrated the project.`);
+        this.runId = runId;
+        this.name = 'FallbackWriteRefusedError';
+    }
+}
+/** A read projection over two stores. All writes still address main's real tables.
+ * Prepared handles follow a deferred connection when an explicit write opens disk.
+ * Normal one-directory connections never use this adapter. */
+export class ProjectRunConnection {
+    target;
+    source;
+    openDisk;
+    jsonRows;
+    connection;
+    current;
+    deferred;
+    copied = [];
+    attached = false;
+    sourceTable = 'project_json';
+    constructor(initial, target, source, openDisk, jsonRows, deferred) {
+        this.target = target;
+        this.source = source;
+        this.openDisk = openDisk;
+        this.jsonRows = jsonRows;
+        this.current = initial;
+        this.deferred = deferred;
+        this.configure(initial);
+        this.connection = new Proxy(initial, { get: (_target, key) => {
+                if (key === 'prepare')
+                    return (sql) => this.prepare(sql);
+                const value = Reflect.get(this.current, key, this.current);
+                return typeof value === 'function' ? value.bind(this.current) : value;
+            } });
+    }
+    /** Called only before a run write or a family claim, never a query/cache read. */
+    writable() {
+        if (this.deferred) {
+            mkdirSync(dirname(this.target), { recursive: true });
+            this.switchToDisk();
+            // A legacy database this process just created has nothing to import; an existing one keeps its marker.
+            this.current.prepare("INSERT OR IGNORE INTO meta (key, value) VALUES ('import-complete', 'project-write')").run();
+        }
+        mkdirSync(join(dirname(this.target), 'runs'), { recursive: true });
+    }
+    switchToDisk() {
+        const disk = this.openDisk();
+        try {
+            this.configure(disk);
+        }
+        catch (error) {
+            disk.close();
+            throw error;
+        }
+        this.current.close();
+        this.current = disk;
+        this.deferred = false;
+    }
+    refresh() {
+        if (this.deferred && !this.current.isTransaction && pathPresent(this.target))
+            this.switchToDisk();
+    }
+    isFallback(id) {
+        this.refresh();
+        return !this.current.prepare('SELECT 1 FROM main.runs WHERE id = ?').get(id) &&
+            Boolean(this.current.prepare('SELECT 1 FROM project_runs WHERE id = ?').get(id));
+    }
+    hasFallback(id) {
+        this.refresh();
+        return Boolean(this.current.prepare(`SELECT 1 FROM ${this.sourceTable} WHERE id = ?`).get(id));
+    }
+    /** A family is read only while any member's winning row is a fallback row. */
+    familyHasFallback(family) {
+        this.refresh();
+        return Boolean(this.current.prepare(`SELECT 1 FROM ${this.sourceTable} source WHERE (source.id = ? OR source.parent_run_id = ?)
+      AND NOT EXISTS (SELECT 1 FROM main.runs legacy WHERE legacy.id = source.id) LIMIT 1`).get(family, family));
+    }
+    /**
+     * The database half of the fallback rule: no upsert of a row whose winning copy is a fallback row,
+     * and no delete of an ID that has any fallback copy (rule A), unless the transaction adopts its
+     * family. Family policy (mixed families, claims, held runs) stays in the store; this guard only
+     * catches a store bypass. Checked here only while no legacy database exists, so a refused write
+     * cannot create one; otherwise inside the transaction, after the fence (`preserveFamilies`).
+     */
+    beforeWrite(changes) {
+        const adopted = new Set(changes.adoptFallback ?? []);
+        this.assertAdoptable(adopted, changes.fence?.owner.session);
+        if (this.deferred)
+            this.assertWritable(changes, adopted);
+        if (changes.upserts.length || changes.deletes.length || adopted.size)
+            this.writable();
+        return adopted;
+    }
+    /** A family with a fallback member is never claimed here; adoption copies it first. */
+    /**
+     * The claim rows of both physical databases, unmerged. `project_claims` lets the legacy row win
+     * a family, so a stale claim there would hide a live one in the fallback database; a check that
+     * asks whether any owner is live reads both.
+     */
+    physicalClaims(columns) {
+        const main = this.current.prepare(`SELECT ${columns} FROM main.run_claims`).all();
+        return this.attached ? [...main, ...this.current.prepare(`SELECT ${columns} FROM project_fallback.run_claims`).all()] : main;
+    }
+    claimable(take) {
+        const kept = take.filter(({ family }) => !this.familyHasFallback(family));
+        if (kept.length)
+            this.writable();
+        return kept;
+    }
+    assertWritable(changes, adopted) {
+        const refused = this.refusedRows(changes, adopted);
+        if (refused.length)
+            throw new FallbackWriteRefusedError(refused[0], this.source);
+    }
+    /** Every row the guard refuses: an upsert of a fallback-selected row, a delete of an ID with any fallback copy. */
+    refusedRows(changes, adopted) {
+        return [...changes.upserts.filter(row => !adopted.has(row.parentRunId ?? row.id) && this.isFallback(row.id)).map(row => row.id),
+            ...changes.deletes.filter(id => this.hasFallback(id))];
+    }
+    configure(db) {
+        let table;
+        let attached = false;
+        try {
+            table = this.jsonRows ? this.jsonTable(db) : this.attach(db);
+            attached = !this.jsonRows;
+        }
+        catch (error) {
+            try {
+                db.exec('DETACH DATABASE project_fallback');
+            }
+            catch { /* attach may have failed before publication */ }
+            warnFallbackRunSource(this.source, error);
+            table = this.jsonTable(db);
+        }
+        const columns = db.prepare('PRAGMA main.table_info(runs)').all();
+        const sourceNames = new Set(db.prepare(`PRAGMA ${attached ? 'project_fallback' : 'temp'}.table_info(${attached ? 'runs' : 'project_json'})`).all().map(row => row.name));
+        // Negative source sequences preserve insertion order and never collide with main's rowids.
+        const sourceColumns = columns.map(({ name, dflt_value }) => name === 'seq' ? 'seq - 9007199254740991 AS seq' :
+            sourceNames.has(name) ? String(name) : `${dflt_value ?? 'NULL'} AS ${name}`).join(', ');
+        db.exec(`CREATE TEMP VIEW project_runs AS SELECT * FROM main.runs UNION ALL
+      SELECT ${sourceColumns} FROM ${table} source WHERE NOT EXISTS (SELECT 1 FROM main.runs legacy WHERE legacy.id = source.id)`);
+        this.attached = attached;
+        this.sourceTable = table;
+        const claims = attached ? 'SELECT * FROM project_fallback.run_claims' : 'SELECT * FROM main.run_claims WHERE 0';
+        db.exec(`CREATE TEMP VIEW project_claims AS SELECT * FROM main.run_claims UNION ALL
+      SELECT * FROM (${claims}) source WHERE NOT EXISTS (SELECT 1 FROM main.run_claims legacy WHERE legacy.family = source.family)`);
+    }
+    attach(db) {
+        const url = pathToFileURL(this.source);
+        url.searchParams.set('mode', 'ro');
+        db.prepare('ATTACH DATABASE ? AS project_fallback').run(url.href);
+        const version = Number(db.prepare('PRAGMA project_fallback.user_version').get().user_version);
+        if (version < RUN_DATABASE_READABLE_FROM || version > RUN_DATABASE_SCHEMA_VERSION)
+            throw new Error(`Unsupported fallback run schema: ${version}`);
+        db.prepare('SELECT 1 FROM project_fallback.run_claims LIMIT 1').get();
+        return 'project_fallback.runs';
+    }
+    jsonTable(db) {
+        db.exec('CREATE TEMP TABLE project_json AS SELECT * FROM main.runs WHERE 0');
+        const insert = db.prepare(`INSERT INTO project_json
+      (seq, id, created_at, finished_at, status, archived, live, parent_run_id, client_request_id,
+       group_id, worktree_path, branch, base_branch, revision, data, summary)
+      VALUES (:seq, :id, :createdAt, :finishedAt, :status, :archived, :live, :parentRunId,
+       :clientRequestId, :groupId, :worktreePath, :branch, :baseBranch, :revision, :data, :summary)`);
+        this.jsonRows?.forEach((row, index) => insert.run({ ...toRunBindings(row, 1), seq: index + 1 }));
+        return 'project_json';
+    }
+    prepare(sql) {
+        const projected = projectReadTables(sql);
+        let owner = this.current;
+        let statement = owner.prepare(projected);
+        return new Proxy(statement, { get: (_target, key) => {
+                this.refresh();
+                if (owner !== this.current) {
+                    owner = this.current;
+                    statement = owner.prepare(projected);
+                }
+                const value = Reflect.get(statement, key, statement);
+                return typeof value === 'function' ? value.bind(statement) : value;
+            } });
+    }
+    /** A live process still owns the family, under either directory: adoption must wait for it.
+     *  `session` is the adopter's own claim session, which may already hold the legacy claim. */
+    assertAdoptable(families, session) {
+        for (const family of families) {
+            const legacy = this.current.prepare('SELECT session, pid, start_token AS startToken FROM main.run_claims WHERE family = ?').get(family);
+            if (legacy && legacy.session !== session && claimOwnerLive({ session: String(legacy.session), pid: Number(legacy.pid), startToken: legacy.startToken === null ? null : String(legacy.startToken) })) {
+                throw new Error(`Run family ${family} is in use by another process: ${dirname(this.target)}`);
+            }
+            const sourceClaim = this.attached ? this.current.prepare('SELECT session, pid, start_token AS startToken FROM project_fallback.run_claims WHERE family = ?').get(family) : undefined;
+            if (sourceClaim && claimOwnerLive({ session: String(sourceClaim.session), pid: Number(sourceClaim.pid), startToken: sourceClaim.startToken === null ? null : String(sourceClaim.startToken) })) {
+                throw new Error(`Fallback family is in use by another process: ${dirname(this.source)}`);
+            }
+        }
+    }
+    /** Explicit adoption only: inside the primary transaction, after its ownership and row fences passed. */
+    preserveFamilies(families, changes) {
+        this.assertAdoptable(families, changes.fence?.owner.session);
+        for (const family of families) {
+            const rows = this.current.prepare(`SELECT * FROM project_runs WHERE id = ? OR parent_run_id = ?`).all(family, family);
+            for (const row of rows) {
+                const id = row.id;
+                if (!this.isFallback(id))
+                    continue;
+                this.copyRunFiles(id);
+                this.current.prepare(`INSERT INTO main.meta (key, value) VALUES ('commit-seq', ?)
+          ON CONFLICT(key) DO UPDATE SET value = CAST(MAX(CAST(value AS INTEGER), CAST(excluded.value AS INTEGER)) AS TEXT)`)
+                    .run(String(row.revision));
+                const columns = Object.keys(row).filter(key => key !== 'seq');
+                this.current.prepare(`INSERT INTO main.runs (${columns.join(', ')}) VALUES (${columns.map(() => '?').join(', ')})`)
+                    .run(...columns.map(key => row[key]));
+            }
+        }
+        // Inside the transaction, after the fence: another process may have added a fallback copy since the
+        // writer queued this change. Each refused row is a conflict, so the store settles it per row and
+        // commits the rest of its batch instead of retrying the refused change forever.
+        const refused = this.refusedRows(changes, new Set());
+        if (refused.length)
+            throw new RunConflictError(refused.map(id => {
+                const row = this.current.prepare('SELECT * FROM project_runs WHERE id = ?').get(id);
+                return { id, reason: 'fallback', current: row ? toRunRow(row) : undefined };
+            }));
+    }
+    commitFiles() { this.copied = []; }
+    rollbackFiles() {
+        for (const path of this.copied)
+            rmSync(path, { recursive: true, force: true });
+        this.copied = [];
+    }
+    copyRunFiles(id) {
+        const source = join(dirname(this.source), 'runs');
+        if (!pathPresent(source))
+            return;
+        const target = join(dirname(this.target), 'runs');
+        mkdirSync(target, { recursive: true });
+        for (const name of readdirSync(source)) {
+            if (!name.startsWith(`${id}.`) && !name.startsWith(`${id}-`))
+                continue;
+            const path = join(source, name);
+            if (lstatSync(path).isSymbolicLink())
+                throw new Error(`Cannot preserve redirected fallback run file: ${path}`);
+            const destination = join(target, name);
+            if (pathPresent(destination)) {
+                if (sameRunFiles(path, destination))
+                    continue;
+                throw new Error(`Legacy run sidecar already exists without its record: ${destination}`);
+            }
+            this.copied.push(destination);
+            cpSync(path, destination, { recursive: true, force: false, errorOnExist: true, dereference: false });
+        }
+    }
+}
+/** Match only table references. Quoted text and comments are opaque to the projection. */
+function projectReadTables(sql) {
+    return sql.replace(/('(?:''|[^'])*'|"(?:""|[^"])*"|`[^`]*`|\[[^\]]*\]|--[^\n]*|\/\*[\s\S]*?\*\/)|\b(FROM|JOIN)(\s+)(runs|run_claims)\b/gi, (match, quoted, keyword, space, table, offset) => {
+        // A DELETE target stays the primary table; every other reference, nested reads in writes included, is a read.
+        if (quoted || /\bDELETE\s*$/i.test(sql.slice(0, offset)))
+            return match;
+        const next = /^\s+(?:AS\s+)?([a-z_]\w*|"|`|\[)/i.exec(sql.slice(offset + match.length))?.[1];
+        const aliased = next && !/^(WHERE|JOIN|LEFT|RIGHT|INNER|OUTER|CROSS|GROUP|ORDER|LIMIT|UNION|INTERSECT|EXCEPT|ON|USING|NOT|INDEXED)$/i.test(next);
+        return `${keyword}${space}${table.toLowerCase() === 'runs' ? 'project_runs' : 'project_claims'}${aliased ? '' : ` AS ${table}`}`;
+    });
+}
+/** A previous process may have copied a sidecar before its SQLite transaction committed. */
+function sameRunFiles(source, target) {
+    const from = lstatSync(source), to = lstatSync(target);
+    if (from.isFile() && to.isFile())
+        return readFileSync(source).equals(readFileSync(target));
+    if (!from.isDirectory() || !to.isDirectory())
+        return false;
+    const names = readdirSync(source).sort(), existing = readdirSync(target).sort();
+    return names.length === existing.length && names.every((name, index) => name === existing[index] && sameRunFiles(join(source, name), join(target, name)));
+}
+//# sourceMappingURL=project-run-connection.js.map

package/dist/runs/project-run-connection.js.map

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

package/dist/runs/project-run-sources.d.ts

@@ -0,0 +1,21 @@
+import { RunDatabase, type RunRowInput, type RunWriteFence } from './run-database.ts';
+export interface ProjectRunSource {
+    directory: string;
+    database: string;
+    jsonRows?: readonly RunRowInput[];
+}
+/** Validate before opening a writable primary: corruption must never leave a shadow store. */
+export declare function fallbackRunSource(dataDir: string, parse: (bytes: Buffer) => readonly RunRowInput[] | undefined): ProjectRunSource | undefined;
+export declare function warnFallbackRunSource(path: string, error: unknown): void;
+/** Copy the family of `id` in with the explicit adoption intent. Returns its member IDs, or none.
+ *  The empty fence names the adopter, so a live legacy claim of another process refuses it. */
+export declare function copyFallbackFamily(db: RunDatabase | null, id: string, owner?: RunWriteFence['owner']): string[];
+export declare function addRunSource(db: RunDatabase, dataDir: string, source: ProjectRunSource, readOnly?: boolean): RunDatabase;
+/** Adopted snapshots keep their bytes, so they name their `.ai/squawk/` path. Accept only that exact
+ *  old path, then answer with the path being read. False for any other recorded path. */
+export declare function bindWorkerResultPath(diff: {
+    state: string;
+    path?: string;
+}, dataDir: string, hasFallback: boolean, parentId: string, path: string): boolean;
+export declare function fallbackRunDeleteError(dataDir: string, hasFallback: boolean, worktree?: string): string | undefined;
+export declare function workerResultsDirectory(dataDir: string, parentId: string, write: boolean): string;

package/dist/runs/project-run-sources.js

@@ -0,0 +1,86 @@
+import { logPrefix } from '../home/display.js';
+import { z } from 'zod';
+import { lstatSync, mkdirSync, readFileSync, realpathSync } from 'node:fs';
+import { basename, dirname, join, resolve } from 'node:path';
+import { dataReadDirs, fallbackProjectWriteError, isFallbackProjectPath, pathPresent } from '../project-paths.js';
+import { RUNS_DB_FILE, RUNS_IMPORT_COMPLETE_KEY, RunDatabase } from './run-database.js';
+/** Validate before opening a writable primary: corruption must never leave a shadow store. */
+export function fallbackRunSource(dataDir, parse) {
+    const directory = dataReadDirs(dataDir)[1];
+    if (!directory)
+        return undefined;
+    const database = join(directory, RUNS_DB_FILE);
+    try {
+        return readFallbackSource(directory, database, parse);
+    }
+    catch (error) {
+        warnFallbackRunSource(database, error);
+        return { directory, database, jsonRows: [] };
+    }
+}
+const warned = new Set();
+export function warnFallbackRunSource(path, error) {
+    if (warned.has(path))
+        return;
+    warned.add(path);
+    console.warn(`${logPrefix()} Cannot read fallback runs from ${path}; fallback runs are unavailable: ${error instanceof Error ? error.message : String(error)}`);
+}
+function readFallbackSource(directory, database, parse) {
+    const db = RunDatabase.openReadOnly(database);
+    if (!db && pathPresent(database))
+        throw new Error('Unsupported or uninitialized fallback run schema');
+    if (db) {
+        try {
+            if (db.getMeta(RUNS_IMPORT_COMPLETE_KEY) !== undefined)
+                return { directory, database };
+        }
+        finally {
+            db.close();
+        }
+    }
+    const index = join(directory, 'runs.json');
+    if (!pathPresent(index))
+        return pathPresent(database) ? { directory, database, jsonRows: [] } : undefined;
+    const jsonRows = parse(readFileSync(index));
+    if (!jsonRows)
+        throw new Error(`Cannot read fallback run index: ${index}`);
+    return { directory, database, jsonRows };
+}
+/** Copy the family of `id` in with the explicit adoption intent. Returns its member IDs, or none.
+ *  The empty fence names the adopter, so a live legacy claim of another process refuses it. */
+export function copyFallbackFamily(db, id, owner) {
+    const family = db?.familyOf(id);
+    if (!db || family === undefined || !db.familyHasFallback(family))
+        return [];
+    db.transaction({ upserts: [], deletes: [], adoptFallback: [family], ...(owner ? { fence: { owner, claims: new Map(), rows: new Map() } } : {}) });
+    return [family, ...db.listIdsByParent(family)];
+}
+export function addRunSource(db, dataDir, source, readOnly = false) {
+    return RunDatabase.withProjectSource(db, join(dataDir, RUNS_DB_FILE), source.database, source.jsonRows, readOnly);
+}
+/** Adopted snapshots keep their bytes, so they name their `.ai/squawk/` path. Accept only that exact
+ *  old path, then answer with the path being read. False for any other recorded path. */
+export function bindWorkerResultPath(diff, dataDir, hasFallback, parentId, path) {
+    if (diff.state !== 'available' || diff.path === path)
+        return true;
+    const fallback = dataReadDirs(dataDir)[1];
+    if (!fallback || !hasFallback || diff.path !== join(fallback, 'runs', `${parentId}-worker-results`, basename(path)))
+        return false;
+    diff.path = path;
+    return true;
+}
+export function fallbackRunDeleteError(dataDir, hasFallback, worktree) {
+    const source = hasFallback ? dataReadDirs(dataDir)[1] :
+        worktree && isFallbackProjectPath(dirname(dirname(dataDir)), worktree) ? worktree : undefined;
+    return source ? fallbackProjectWriteError(source) : undefined;
+}
+export function workerResultsDirectory(dataDir, parentId, write) {
+    z.uuid().parse(parentId);
+    const dir = join(dataDir, 'runs', `${parentId}-worker-results`);
+    if (write)
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+    if (realpathSync(dir) !== resolve(dir) || !lstatSync(dir).isDirectory())
+        throw new Error('worker result storage redirected');
+    return dir;
+}
+//# sourceMappingURL=project-run-sources.js.map

package/dist/runs/project-run-sources.js.map

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

package/dist/runs/pull-requests.d.ts

@@ -0,0 +1,14 @@
+import { type ArchivePullRequestIdentity } from '../contract/index.js';
+import type { RunPullRequest, RunSummary } from '../contract/index.js';
+/** Stable, immutable union. Numeric declarations belong to the project only when it is known. */
+export declare function mergePullRequests(current: readonly RunPullRequest[] | undefined, incoming: readonly RunPullRequest[], repoBase?: string): RunPullRequest[];
+/** Cache invalidation is project-scoped; foreign links never address the local number. */
+export declare function ownPullRequestNumbers(run: Pick<RunSummary, 'pullRequests' | 'pullRequestUrl' | 'referencedPullRequestUrl' | 'prNumber' | 'markerRefs'>, repoBase?: string): number[];
+/** Fail closed over the COMPLETE collection, including unresolved or malformed members. */
+export declare function archivePullRequests(family: readonly {
+    pullRequests?: unknown;
+    pullRequestUrl?: string | undefined;
+    referencedPullRequestUrl?: string | undefined;
+    prNumber?: number | undefined;
+}[], repoBase?: string): ArchivePullRequestIdentity[] | undefined;
+export declare function pullRequestKey(identity: ArchivePullRequestIdentity): string;

package/dist/runs/pull-requests.js

@@ -0,0 +1,96 @@
+import { runPullRequestSchema } from '../contract/index.js';
+/** Compare repository identities rather than URL formatting or reference numbers alone. */
+function repository(url) {
+    const parsed = new URL(url);
+    return `${parsed.hostname}${parsed.pathname.split('/').slice(0, 3).join('/')}`.toLowerCase();
+}
+/** Stable, immutable union. Numeric declarations belong to the project only when it is known. */
+export function mergePullRequests(current, incoming, repoBase) {
+    const own = repoBase ? repository(repoBase) : undefined;
+    const result = [];
+    const identity = (entry) => `${entry.url ? repository(entry.url) : own ?? 'unscoped'}:${entry.number}`;
+    for (const entry of [...(current ?? []), ...incoming]) {
+        const index = result.findIndex((previous) => identity(previous) === identity(entry));
+        if (index < 0)
+            result.push({ ...entry });
+        else {
+            const previous = result[index];
+            result[index] = {
+                ...previous,
+                ...(previous.url === undefined && entry.url !== undefined ? { url: entry.url } : {}),
+                source: previous.source === 'created' || entry.source === 'created' ? 'created' : 'declared',
+            };
+        }
+    }
+    return result;
+}
+/** Cache invalidation is project-scoped; foreign links never address the local number. */
+export function ownPullRequestNumbers(run, repoBase) {
+    const own = repoBase ? repository(repoBase) : undefined;
+    const legacyUrls = [run.pullRequestUrl, run.referencedPullRequestUrl].filter((url) => url !== undefined);
+    const entries = [...(run.pullRequests ?? [])];
+    for (const url of legacyUrls) {
+        const number = Number(/\/pull\/(\d+)/i.exec(url)?.[1]);
+        if (Number.isInteger(number) && number > 0)
+            entries.push({ number, url, source: 'created' });
+    }
+    for (const number of [run.prNumber, run.markerRefs?.pr]) {
+        if (number === undefined || legacyUrls.some(url => Number(/\/pull\/(\d+)/i.exec(url)?.[1]) === number))
+            continue;
+        entries.push({ number, source: 'declared' });
+    }
+    return [...new Set(entries.filter(entry => {
+            if (!entry.url)
+                return true;
+            try {
+                return own !== undefined && repository(entry.url) === own;
+            }
+            catch {
+                return false;
+            }
+        }).map(entry => entry.number))];
+}
+/** Fail closed over the COMPLETE collection, including unresolved or malformed members. */
+export function archivePullRequests(family, repoBase) {
+    const own = repoBase ? githubIdentity(`${repoBase.replace(/\/$/, '')}/pull/1`) : undefined;
+    const result = new Map();
+    for (const run of family) {
+        if (run.pullRequests !== undefined) {
+            if (!Array.isArray(run.pullRequests))
+                return undefined;
+            for (const raw of run.pullRequests) {
+                const parsed = runPullRequestSchema.safeParse(raw);
+                if (!parsed.success)
+                    return undefined;
+                const entry = parsed.data;
+                const identity = entry.url ? githubIdentity(entry.url) : own ? { ...own, number: entry.number } : undefined;
+                if (!identity || identity.number !== entry.number)
+                    return undefined;
+                result.set(pullRequestKey(identity), identity);
+            }
+        }
+        else if (run.pullRequestUrl !== undefined) {
+            const identity = githubIdentity(run.pullRequestUrl);
+            if (!identity || !own || identity.owner !== own.owner || identity.repo !== own.repo)
+                return undefined;
+            result.set(pullRequestKey(identity), identity);
+        }
+    }
+    return result.size ? [...result].sort(([a], [b]) => a.localeCompare(b)).map(([, identity]) => identity) : undefined;
+}
+export function pullRequestKey(identity) {
+    return `${identity.owner.toLowerCase()}/${identity.repo.toLowerCase()}#${identity.number}`;
+}
+function githubIdentity(value) {
+    try {
+        const url = new URL(value);
+        const match = /^\/([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)\/pull\/([1-9][0-9]*)\/?$/.exec(url.pathname);
+        if (!match || url.hostname.toLowerCase() !== 'github.com' || url.port || url.username || url.password || !['http:', 'https:'].includes(url.protocol))
+            return undefined;
+        return { owner: match[1].toLowerCase(), repo: match[2].toLowerCase(), number: Number(match[3]) };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=pull-requests.js.map

package/dist/runs/pull-requests.js.map

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

package/dist/runs/raw-record.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Preserve JSON fields dropped by runtime parsing. Match array extras by distinct string id, or
+ * by position only while known contents remain unchanged. Known parent deletion removes its
+ * extras.
+ */
+/** What one stored record held beyond its parse. Opaque outside this module. */
+export type RawExtras = ObjectExtras | KeyedArrayExtras | IndexedArrayExtras;
+interface ObjectExtras {
+    kind: 'object';
+    /** Keys the parse dropped, with their stored values. */
+    fields: Map<string, unknown>;
+    /** Keys the parse kept whose values hold dropped fields further down. */
+    children: Map<string, RawExtras>;
+}
+interface KeyedArrayExtras {
+    kind: 'keyed';
+    elements: Map<string, RawExtras>;
+}
+interface IndexedArrayExtras {
+    kind: 'indexed';
+    /** The array's known content when it was read: the extras apply only while it is unchanged. */
+    known: string;
+    elements: Map<number, RawExtras>;
+}
+/**
+ * What `raw` (a record as stored) holds that `parsed` (the same record through the runtime schema)
+ * does not: undefined when the parse kept every stored field, which is the common case and makes
+ * every later write a plain `JSON.stringify`. Defaults the parse added are not extras.
+ */
+export declare function collectRawExtras(raw: unknown, parsed: unknown): RawExtras | undefined;
+/**
+ * The JSON to store for `record`: exactly `JSON.stringify(record)` without extras, else the record
+ * with every extra that still fits put back. `extras` in the result is what the stored JSON now
+ * holds beyond the record, for the next write of the same row.
+ */
+export declare function encodeRawRecord(record: unknown, extras: RawExtras | undefined): {
+    data: string;
+    extras: RawExtras | undefined;
+};
+export {};