@12ui/design 0.2.36 → 0.2.38

package/dist/prototype-branch-contract.js

@@ -0,0 +1,403 @@
+import { createHash } from 'node:crypto';
+import { readdir, readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { BRANCH_COMPLETION_FILENAME, BRANCH_PAGES_DIRECTORY, BRANCH_PLAN_FILENAME, } from './branch-run-record.js';
+import { PROTOTYPE_SOURCES_DIRECTORY } from './prototype-source.js';
+const isRecord = (value) => (typeof value === 'object' && value !== null && !Array.isArray(value));
+const errorCode = (error) => {
+    const code = error.code;
+    return typeof code === 'string' ? code : 'UNKNOWN';
+};
+const readBytes = async (file) => {
+    try {
+        return { bytes: await readFile(file) };
+    }
+    catch (error) {
+        return { error: errorCode(error) };
+    }
+};
+const componentDigest = (value) => ('bytes' in value
+    ? createHash('sha256').update(value.bytes).digest('hex')
+    : `error:${value.error}`);
+const existingSourceDirectory = async (branchDir) => {
+    const overlay = path.join(branchDir, PROTOTYPE_SOURCES_DIRECTORY);
+    try {
+        await stat(path.join(overlay, BRANCH_PLAN_FILENAME));
+        return overlay;
+    }
+    catch (error) {
+        if (errorCode(error) === 'ENOENT')
+            return branchDir;
+        // A present but unreadable overlay is input evidence, not permission to
+        // silently switch back to an older plan in the branch root.
+        return overlay;
+    }
+};
+const readInputSnapshot = async (args) => {
+    const branchDir = path.resolve(args.branchDir);
+    const sourceDir = args.sourceDir
+        ? path.resolve(args.sourceDir)
+        : await existingSourceDirectory(branchDir);
+    const pagesDir = path.join(sourceDir, BRANCH_PAGES_DIRECTORY);
+    const [plan, completion] = await Promise.all([
+        readBytes(path.join(sourceDir, BRANCH_PLAN_FILENAME)),
+        readBytes(path.join(branchDir, BRANCH_COMPLETION_FILENAME)),
+    ]);
+    let pagesError;
+    let entries = [];
+    try {
+        entries = await readdir(pagesDir, { withFileTypes: true });
+    }
+    catch (error) {
+        pagesError = errorCode(error);
+    }
+    const htmlEntries = entries
+        .filter((entry) => entry.name.endsWith('.html'))
+        .sort((left, right) => left.name.localeCompare(right.name));
+    const invalidHtmlEntries = htmlEntries
+        .filter((entry) => !entry.isFile())
+        .map((entry) => entry.name);
+    const html = await Promise.all(htmlEntries
+        .filter((entry) => entry.isFile())
+        .map(async (entry) => ({
+        file: entry.name,
+        read: await readBytes(path.join(pagesDir, entry.name)),
+    })));
+    const digestManifest = {
+        plan: componentDigest(plan),
+        completion: componentDigest(completion),
+        pages: pagesError ? `error:${pagesError}` : 'readable',
+        invalidHtmlEntries,
+        html: html.map((entry) => [entry.file, componentDigest(entry.read)]),
+    };
+    return {
+        plan,
+        completion,
+        html,
+        ...(pagesError ? { pagesError } : {}),
+        invalidHtmlEntries,
+        inputDigest: createHash('sha256')
+            .update(JSON.stringify(digestManifest))
+            .digest('hex'),
+    };
+};
+const parseJson = (input) => {
+    if (!('bytes' in input))
+        return undefined;
+    try {
+        return JSON.parse(input.bytes.toString('utf8'));
+    }
+    catch {
+        return undefined;
+    }
+};
+const recordRunId = (value) => (isRecord(value) && typeof value.runId === 'string' ? value.runId : '');
+const routeIdPattern = /^[a-z0-9][a-z0-9-]*$/u;
+const readPlannedRoutes = (plan, issues) => {
+    if (!Array.isArray(plan.pages)) {
+        issues.push('branch.plan.json pages is not an array');
+        return [];
+    }
+    if (plan.packagePages !== undefined
+        && plan.packagePages !== null
+        && !Array.isArray(plan.packagePages)) {
+        issues.push('branch.plan.json packagePages is not an array');
+        return [];
+    }
+    const selected = Array.isArray(plan.packagePages) && plan.packagePages.length > 0
+        ? plan.packagePages
+        : plan.pages;
+    const routes = [];
+    const ids = new Set();
+    selected.forEach((value, index) => {
+        if (!isRecord(value)) {
+            issues.push(`planned route ${index} is not an object`);
+            return;
+        }
+        const id = typeof value.id === 'string' ? value.id : '';
+        const title = typeof value.title === 'string' ? value.title : '';
+        if (!routeIdPattern.test(id))
+            issues.push(`planned route ${index} has invalid id`);
+        if (!title.trim())
+            issues.push(`planned route ${id || index} has no exact title`);
+        if (typeof value.startsFromWinner !== 'boolean') {
+            issues.push(`planned route ${id || index} has no startsFromWinner fact`);
+        }
+        if (ids.has(id))
+            issues.push(`planned route id is duplicated: ${id}`);
+        ids.add(id);
+        routes.push({
+            id,
+            title,
+            startsFromWinner: value.startsFromWinner === true,
+        });
+    });
+    if (routes.length === 0)
+        issues.push('branch plan has no prototype routes');
+    return routes;
+};
+const readCompletionRoutes = (completion, issues) => {
+    if (!Array.isArray(completion.pages)) {
+        issues.push('branch.complete.json pages is not an array');
+        return [];
+    }
+    const routes = [];
+    const ids = new Set();
+    completion.pages.forEach((value, index) => {
+        if (!isRecord(value)) {
+            issues.push(`completion route ${index} is not an object`);
+            return;
+        }
+        const id = typeof value.id === 'string' ? value.id : '';
+        const title = typeof value.title === 'string' ? value.title : '';
+        if (!routeIdPattern.test(id))
+            issues.push(`completion route ${index} has invalid id`);
+        if (!title.trim())
+            issues.push(`completion route ${id || index} has no exact title`);
+        if (typeof value.startsFromWinner !== 'boolean') {
+            issues.push(`completion route ${id || index} has no startsFromWinner fact`);
+        }
+        if (ids.has(id))
+            issues.push(`completion route id is duplicated: ${id}`);
+        ids.add(id);
+        const conversion = value.conversion;
+        if (conversion !== undefined && !isRecord(conversion)) {
+            issues.push(`completion route ${id || index} conversion is not an object`);
+        }
+        const conversionStatus = isRecord(conversion) && typeof conversion.status === 'string'
+            ? conversion.status
+            : undefined;
+        const outFile = isRecord(conversion) && typeof conversion.outFile === 'string'
+            ? conversion.outFile
+            : undefined;
+        routes.push({
+            id,
+            title,
+            startsFromWinner: value.startsFromWinner === true,
+            ...(conversionStatus ? { conversionStatus } : {}),
+            ...(outFile ? { outFile } : {}),
+        });
+    });
+    return routes;
+};
+const holdingFile = (id) => {
+    const slug = id
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/gu, '-')
+        .replace(/^-+|-+$/gu, '');
+    return `holding-${slug}.html`;
+};
+const skipContract = (args) => ({
+    mode: 'skip',
+    inputDigest: args.snapshot.inputDigest,
+    runId: args.runId,
+    reason: args.noSurvivors
+        ? 'prototype_navigation_no_survivors'
+        : 'prototype_navigation_unreconciled',
+    detail: args.detail,
+});
+/**
+ * Resolve the immutable branch records and exported HTML into the navigation
+ * contract consumed by prototype assembly. This function reads only: it never
+ * repairs, copies, or guesses around contradictory durable evidence.
+ */
+export const resolvePrototypeBranchContract = async (args) => {
+    const snapshot = await readInputSnapshot(args);
+    const planValue = parseJson(snapshot.plan);
+    const completionValue = parseJson(snapshot.completion);
+    const planRunId = recordRunId(planValue);
+    const completionRunId = recordRunId(completionValue);
+    const runId = completionRunId || planRunId;
+    const issues = [];
+    if (!('bytes' in snapshot.plan)) {
+        issues.push(`branch.plan.json is unreadable (${snapshot.plan.error})`);
+    }
+    else if (!isRecord(planValue)) {
+        issues.push('branch.plan.json is not a JSON object');
+    }
+    if (!('bytes' in snapshot.completion)) {
+        issues.push(`branch.complete.json is unreadable (${snapshot.completion.error})`);
+    }
+    else if (!isRecord(completionValue)) {
+        issues.push('branch.complete.json is not a JSON object');
+    }
+    if (snapshot.pagesError)
+        issues.push(`pages directory is unreadable (${snapshot.pagesError})`);
+    snapshot.invalidHtmlEntries.forEach((file) => {
+        issues.push(`HTML input is not a regular file: ${file}`);
+    });
+    snapshot.html.forEach((entry) => {
+        if (!('bytes' in entry.read))
+            issues.push(`HTML input is unreadable: ${entry.file} (${entry.read.error})`);
+    });
+    if (!planRunId)
+        issues.push('branch.plan.json has no runId');
+    if (!completionRunId)
+        issues.push('branch.complete.json has no runId');
+    if (planRunId && completionRunId && planRunId !== completionRunId) {
+        issues.push(`runId differs between plan and completion: ${planRunId} != ${completionRunId}`);
+    }
+    if (!isRecord(planValue) || !isRecord(completionValue)) {
+        return skipContract({ snapshot, runId, detail: issues.join('; ') });
+    }
+    const planned = readPlannedRoutes(planValue, issues);
+    const completed = readCompletionRoutes(completionValue, issues);
+    const completionById = new Map(completed.map((route) => [route.id, route]));
+    const plannedIds = new Set(planned.map((route) => route.id));
+    const htmlById = new Map(snapshot.html.map((entry) => [
+        entry.file.slice(0, -'.html'.length),
+        entry,
+    ]));
+    for (const route of planned) {
+        const completedRoute = completionById.get(route.id);
+        if (!completedRoute) {
+            issues.push(`planned route is absent from completion: ${route.id}`);
+            continue;
+        }
+        if (completedRoute.title !== route.title) {
+            issues.push(`route title differs for ${route.id}`);
+        }
+        if (completedRoute.startsFromWinner !== route.startsFromWinner) {
+            issues.push(`startsFromWinner differs for ${route.id}`);
+        }
+    }
+    for (const route of completed) {
+        if (!plannedIds.has(route.id))
+            issues.push(`completion has unplanned route: ${route.id}`);
+    }
+    for (const id of htmlById.keys()) {
+        if (!plannedIds.has(id))
+            issues.push(`pages directory has unplanned HTML route: ${id}`);
+    }
+    const winnerRoutes = planned.filter((route) => route.startsFromWinner);
+    if (winnerRoutes.length !== 1) {
+        issues.push(`branch plan has ${winnerRoutes.length} startsFromWinner routes; expected 1`);
+    }
+    const realRoutes = [];
+    const missingRoutes = [];
+    const partialRoutes = [];
+    for (const route of planned) {
+        const completedRoute = completionById.get(route.id);
+        if (!completedRoute)
+            continue;
+        const expectedFile = `${route.id}.html`;
+        const actual = htmlById.has(route.id);
+        const status = completedRoute.conversionStatus;
+        const hasOutFile = completedRoute.outFile !== undefined;
+        const partial = status === 'partial' || status === 'accepted-partial';
+        const full = status === 'succeeded';
+        if (hasOutFile && path.basename(completedRoute.outFile) !== expectedFile) {
+            issues.push(`completion outFile does not match route ${route.id}: ${path.basename(completedRoute.outFile)}`);
+        }
+        if (full && !hasOutFile)
+            issues.push(`succeeded route has no outFile: ${route.id}`);
+        if (!full && !partial && hasOutFile) {
+            issues.push(`non-surviving route has an outFile: ${route.id} (${status ?? 'missing status'})`);
+        }
+        if (hasOutFile !== actual) {
+            issues.push(`completion outFile and pages directory disagree for ${route.id}`);
+        }
+        if (actual && !full && !partial) {
+            issues.push(`HTML route has no succeeded or partial completion: ${route.id}`);
+        }
+        if (status !== undefined && !full && !partial && status !== 'failed' && status !== 'skipped') {
+            issues.push(`completion route has unknown status: ${route.id} (${status})`);
+        }
+        if (actual && hasOutFile && (full || partial)) {
+            const real = {
+                id: route.id,
+                title: route.title,
+                file: expectedFile,
+                status: partial ? status : 'succeeded',
+            };
+            realRoutes.push(real);
+            if (partial)
+                partialRoutes.push(real);
+            continue;
+        }
+        const file = holdingFile(route.id);
+        missingRoutes.push({ id: route.id, title: route.title, holding: file, file });
+    }
+    if (issues.length > 0) {
+        return skipContract({ snapshot, runId, detail: issues.join('; ') });
+    }
+    const terminalStatus = completionValue.status;
+    const winner = winnerRoutes[0];
+    const winnerReal = realRoutes.find((route) => route.id === winner.id);
+    const entry = winnerReal
+        ? { kind: 'real', id: winner.id, title: winner.title, file: winnerReal.file }
+        : {
+            kind: 'holding',
+            id: winner.id,
+            title: winner.title,
+            file: holdingFile(winner.id),
+        };
+    if (terminalStatus === 'succeeded') {
+        const allFull = realRoutes.length === planned.length
+            && partialRoutes.length === 0
+            && missingRoutes.length === 0;
+        if (!allFull || entry.kind !== 'real') {
+            return skipContract({
+                snapshot,
+                runId,
+                detail: 'succeeded completion does not contain every planned route as full HTML',
+            });
+        }
+        return {
+            mode: 'complete',
+            inputDigest: snapshot.inputDigest,
+            runId,
+            routes: realRoutes,
+            entry,
+        };
+    }
+    if (terminalStatus !== 'partial' && terminalStatus !== 'failed') {
+        return skipContract({
+            snapshot,
+            runId,
+            detail: `branch completion is not terminal: ${String(terminalStatus)}`,
+        });
+    }
+    if (realRoutes.length === 0) {
+        return skipContract({
+            snapshot,
+            runId,
+            noSurvivors: true,
+            detail: `terminal ${terminalStatus} branch has no surviving HTML route`,
+        });
+    }
+    const terminalClass = completionValue.terminalClass;
+    const winnerPageFailed = completionValue.winnerPageFailed;
+    if (terminalClass !== undefined && typeof terminalClass !== 'string') {
+        return skipContract({
+            snapshot,
+            runId,
+            detail: 'branch completion terminalClass is not a string',
+        });
+    }
+    if (winnerPageFailed !== undefined && typeof winnerPageFailed !== 'boolean') {
+        return skipContract({
+            snapshot,
+            runId,
+            detail: 'branch completion winnerPageFailed is not a boolean',
+        });
+    }
+    return {
+        mode: 'review',
+        inputDigest: snapshot.inputDigest,
+        runId,
+        review: {
+            terminalStatus,
+            ...(typeof terminalClass === 'string' ? { terminalClass } : {}),
+            ...(typeof winnerPageFailed === 'boolean' ? { winnerPageFailed } : {}),
+            expectedPageCount: planned.length,
+            availablePageCount: realRoutes.length,
+            expectedRoutes: planned.map((route) => route.id),
+            realRoutes,
+            missingRoutes,
+            partialRoutes,
+            entry,
+        },
+    };
+};
+//# sourceMappingURL=prototype-branch-contract.js.map

package/dist/prototype-branch-contract.js.map

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

package/dist/prototype-poststep.d.ts

@@ -0,0 +1,27 @@
+import type { TwelveUiPrototypeLabelClient } from './prototype-label-client.js';
+import { runPrototypePipeline, type PrototypeRunResult } from './prototype-runner.js';
+export type PrototypeSkippedResult = {
+    branchDir: string;
+    skipped: true;
+    statusPath: string;
+    reason: 'prototype_navigation_unreconciled' | 'prototype_navigation_no_survivors';
+    detail: string;
+};
+export type PrototypePoststepResult = PrototypeRunResult | PrototypeSkippedResult;
+export declare const isPrototypeSkippedResult: (value: PrototypePoststepResult) => value is PrototypeSkippedResult;
+/**
+ * Owns the independently resumable derived-artifact step. The core branch
+ * sentinel is never reopened: a completed branch either adopts its settled
+ * prototype fact, retries this step alone, or settles a deterministic skip.
+ */
+export declare const runPrototypePoststep: (args: {
+    branchDir: string;
+    resume?: boolean;
+    environment?: NodeJS.ProcessEnv;
+    homeDirectory?: string;
+    labelClient?: TwelveUiPrototypeLabelClient;
+    platform?: NodeJS.Platform;
+    signal?: AbortSignal;
+    run?: typeof runPrototypePipeline;
+}) => Promise<PrototypePoststepResult>;
+//# sourceMappingURL=prototype-poststep.d.ts.map

package/dist/prototype-poststep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prototype-poststep.d.ts","sourceRoot":"","sources":["../src/prototype-poststep.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAEhF,OAAO,EAGL,oBAAoB,EACpB,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAS/B,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,IAAI,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,mCAAmC,GAAG,mCAAmC,CAAC;IAClF,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,GAAG,sBAAsB,CAAC;AAElF,eAAO,MAAM,wBAAwB,GACnC,OAAO,uBAAuB,KAC7B,KAAK,IAAI,sBAAsE,CAAC;AAwCnF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAU,MAAM;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,4BAA4B,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,oBAAoB,CAAC;CACnC,KAAG,OAAO,CAAC,uBAAuB,CAkElC,CAAC"}

package/dist/prototype-poststep.js

@@ -0,0 +1,97 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { resolvePrototypeBranchContract } from './prototype-branch-contract.js';
+import { PROTOTYPE_DIRECTORY, PROTOTYPE_MANIFEST_FILENAME, runPrototypePipeline, } from './prototype-runner.js';
+import { prototypeStatusPath, resolvePrototypeRunRecord, skipPrototypeRunRecord, startPrototypeRunRecord, } from './prototype-run-record.js';
+import { prototypeSourceDirectory } from './prototype-source.js';
+export const isPrototypeSkippedResult = (value) => 'skipped' in value && value.skipped === true;
+const existingPrototypeResult = async (args) => {
+    const manifest = JSON.parse(await readFile(args.manifestPath, 'utf8'));
+    const number = (value) => (typeof value === 'number' && Number.isFinite(value) ? value : 0);
+    return {
+        branchDir: args.branchDir,
+        outputDir: path.dirname(args.manifestPath),
+        manifestPath: args.manifestPath,
+        stages: [],
+        screenCount: number(manifest.input?.semanticViewportSections),
+        labeledScreenCount: number(manifest.labels?.labeledScreens),
+        labelCostMicros: number(manifest.labels?.costMicros),
+        warnings: Array.isArray(manifest.warnings)
+            ? manifest.warnings.filter((warning) => typeof warning === 'string')
+            : [],
+    };
+};
+const skippedResult = (args) => ({
+    branchDir: args.branchDir,
+    skipped: true,
+    statusPath: prototypeStatusPath(args.branchDir),
+    reason: args.reason,
+    detail: args.detail,
+});
+/**
+ * Owns the independently resumable derived-artifact step. The core branch
+ * sentinel is never reopened: a completed branch either adopts its settled
+ * prototype fact, retries this step alone, or settles a deterministic skip.
+ */
+export const runPrototypePoststep = async (args) => {
+    const branchDir = path.resolve(args.branchDir);
+    const sourceDir = await prototypeSourceDirectory(branchDir);
+    const contract = await resolvePrototypeBranchContract({ branchDir, sourceDir });
+    const legacyManifestPath = path.join(branchDir, PROTOTYPE_DIRECTORY, PROTOTYPE_MANIFEST_FILENAME);
+    if (args.resume) {
+        const resolution = await resolvePrototypeRunRecord({
+            branchDir,
+            inputDigest: contract.inputDigest,
+            legacyManifestPath,
+        });
+        if (resolution.action === 'settled') {
+            if (resolution.reason === 'skipped' && resolution.record?.status === 'skipped') {
+                return skippedResult({
+                    branchDir,
+                    reason: resolution.record.reason,
+                    detail: resolution.record.detail ?? 'Prototype generation was deterministically skipped.',
+                });
+            }
+            if (resolution.manifestPath) {
+                try {
+                    return await existingPrototypeResult({
+                        branchDir,
+                        manifestPath: resolution.manifestPath,
+                    });
+                }
+                catch {
+                    // A path alone is not a valid manifest fact. Rebuild only this local
+                    // post-step; the core branch completion remains untouched.
+                }
+            }
+        }
+    }
+    if (contract.mode === 'skip') {
+        const running = await startPrototypeRunRecord({
+            branchDir,
+            runId: contract.runId || 'unresolved',
+            inputDigest: contract.inputDigest,
+        });
+        await skipPrototypeRunRecord({
+            branchDir,
+            running,
+            reason: contract.reason,
+            detail: contract.detail,
+        });
+        return skippedResult({
+            branchDir,
+            reason: contract.reason,
+            detail: contract.detail,
+        });
+    }
+    return (args.run ?? runPrototypePipeline)({
+        branchDir,
+        contract,
+        ...(args.environment ? { environment: args.environment } : {}),
+        ...(args.homeDirectory ? { homeDirectory: args.homeDirectory } : {}),
+        ...(args.labelClient ? { labelClient: args.labelClient } : {}),
+        ...(args.platform ? { platform: args.platform } : {}),
+        ...(args.signal ? { signal: args.signal } : {}),
+    });
+};
+//# sourceMappingURL=prototype-poststep.js.map

package/dist/prototype-poststep.js.map

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

package/dist/prototype-run-record.d.ts

@@ -0,0 +1,92 @@
+/**
+ * The prototype post-step is deliberately recorded separately from the branch
+ * run. A branch can be settled while this optional derived artifact is still
+ * running, failed, or ready to retry.
+ */
+export declare const PROTOTYPE_STATUS_FILENAME = "prototype.status.json";
+type PrototypeRunRecordBase = {
+    version: 1;
+    runId: string;
+    inputDigest: string;
+    attempt: number;
+    startedAt: string;
+    updatedAt: string;
+};
+export type PrototypeRunError = {
+    name: string;
+    message: string;
+    stack?: string;
+};
+export type PrototypeRunningRunRecord = PrototypeRunRecordBase & {
+    status: 'running';
+};
+export type PrototypeSucceededRunRecord = PrototypeRunRecordBase & {
+    status: 'succeeded';
+    manifestPath: string;
+};
+export type PrototypeFailedRunRecord = PrototypeRunRecordBase & {
+    status: 'failed';
+    error: PrototypeRunError;
+};
+export type PrototypeSkippedRunRecord = PrototypeRunRecordBase & {
+    status: 'skipped';
+    reason: string;
+    detail?: string;
+};
+export type PrototypeRunRecord = PrototypeRunningRunRecord | PrototypeSucceededRunRecord | PrototypeFailedRunRecord | PrototypeSkippedRunRecord;
+export type PrototypeRunResolution = {
+    action: 'retry';
+    reason: 'missing' | 'input-changed' | 'running' | 'failed' | 'manifest-missing';
+    record?: PrototypeRunRecord;
+} | {
+    action: 'settled';
+    reason: 'legacy-manifest' | 'succeeded' | 'skipped';
+    adoptable: boolean;
+    manifestPath?: string;
+    record?: PrototypeRunRecord;
+};
+export declare const prototypeStatusPath: (branchDir: string) => string;
+export declare const readPrototypeRunRecord: (branchDir: string) => Promise<PrototypeRunRecord | undefined>;
+/**
+ * A synced temporary inode is renamed over the destination, then the parent
+ * directory is synced. Readers therefore see the previous whole record or the
+ * next whole record, and the rename survives a process or machine interruption.
+ */
+export declare const writePrototypeRunRecord: (branchDir: string, record: PrototypeRunRecord) => Promise<void>;
+export declare const startPrototypeRunRecord: (args: {
+    branchDir: string;
+    runId: string;
+    inputDigest: string;
+    now?: () => Date;
+}) => Promise<PrototypeRunningRunRecord>;
+export declare const succeedPrototypeRunRecord: (args: {
+    branchDir: string;
+    running: PrototypeRunningRunRecord;
+    manifestPath: string;
+    now?: () => Date;
+}) => Promise<PrototypeSucceededRunRecord>;
+export declare const failPrototypeRunRecord: (args: {
+    branchDir: string;
+    running: PrototypeRunningRunRecord;
+    error: unknown;
+    now?: () => Date;
+}) => Promise<PrototypeFailedRunRecord>;
+export declare const skipPrototypeRunRecord: (args: {
+    branchDir: string;
+    running: PrototypeRunningRunRecord;
+    reason: string;
+    detail?: string;
+    now?: () => Date;
+}) => Promise<PrototypeSkippedRunRecord>;
+/**
+ * Decide whether a caller can adopt a settled prototype or must run it again.
+ * A legacy manifest remains adoptable only while no sidecar exists; once a
+ * sidecar exists, its digest and status are authoritative.
+ */
+export declare const resolvePrototypeRunRecord: (args: {
+    branchDir: string;
+    inputDigest: string;
+    legacyManifestPath: string;
+}) => Promise<PrototypeRunResolution>;
+export {};
+//# sourceMappingURL=prototype-run-record.d.ts.map