@12ui/design 0.2.58 → 0.2.60

package/dist/redesign-branch-stage.js

@@ -0,0 +1,218 @@
+import { stat } from 'node:fs/promises';
+import { TwelveUiBranchClient } from './branch-client.js';
+import { createConcurrencyLimiter } from './bounded-concurrency.js';
+import { executeBranchRun } from './branch-execution.js';
+import { branchAttemptPath, readBranchAttempt } from './branch-run-record.js';
+import { imageWinner } from './branch-winner.js';
+import { CliRefusal } from './cli-refusal.js';
+import { prepareOutputDirectory } from './cli-output-paths.js';
+import { BRANCH_PAGE_CONCURRENCY_DEFAULT } from './cli-progress.js';
+import { readConceptValue } from './concept-input.js';
+import { TwelveUiConversionPackageClient } from './package-client.js';
+import { TwelveUiPrototypeLabelClient } from './prototype-label-client.js';
+import { runPrototypePoststep } from './prototype-poststep.js';
+import { InvalidRedesignBranchArtifactError, } from './redesign-branch-adoption.js';
+import { redesignBranchIdempotencyKey, redesignBranchPageDirectory, } from './redesign-branch-identity.js';
+import { InvalidRedesignBranchAttemptError, InvalidRedesignBranchRecordError, verifyResumableRedesignBranchAttempt, verifyRedesignBranchPages, } from './redesign-branch-record-verification.js';
+import { InvalidRedesignPageOwnershipError } from './redesign-page-ownership.js';
+import { writeRedesignRecord, } from './redesign-workspace.js';
+const branchConcept = (direction, page) => readConceptValue({
+    value: `${direction} Rebuild the page at ${page.url}.`,
+    flag: '--direction',
+    trimHint: 'Shorten the direction; each page URL is appended automatically.',
+});
+const branchRefusal = (error) => {
+    if (error instanceof InvalidRedesignPageOwnershipError) {
+        throw new CliRefusal(`${error.message} Refusing branch dispatch.`, 'redesign_page_ownership_invalid', { cause: error });
+    }
+    if (error instanceof InvalidRedesignBranchArtifactError
+        || error instanceof InvalidRedesignBranchRecordError
+        || error instanceof InvalidRedesignBranchAttemptError) {
+        throw new CliRefusal(`${error.message} Refusing branch dispatch.`, 'redesign_branch_artifact_invalid', { cause: error });
+    }
+    throw error;
+};
+const recordAdoptedPages = async (args) => {
+    const added = new Map(args.entries
+        .filter((entry) => !entry.recorded && entry.adopted)
+        .map((entry) => [entry.input.page.id, entry.adopted.page]));
+    if (added.size === 0)
+        return args.record;
+    const existing = new Map((args.record.branch?.pages ?? []).map((page) => [page.pageId, page]));
+    for (const [pageId, page] of added)
+        existing.set(pageId, page);
+    const pages = args.record.capture.pages.flatMap((page) => {
+        const settled = existing.get(page.id);
+        return settled ? [settled] : [];
+    });
+    const record = { ...args.record, branch: { pages } };
+    await writeRedesignRecord(args.paths.record, record);
+    return record;
+};
+/** Execute or adopt one exact child per captured page, never a shared winner. */
+export const runRedesignBranchStage = async (args) => {
+    if (!args.record.capture)
+        throw new Error('Cannot branch before capture has run');
+    if (!args.record.pick)
+        throw new Error('Cannot branch before pick has run');
+    const capture = args.record.capture;
+    let preflight;
+    try {
+        preflight = await verifyRedesignBranchPages({
+            record: args.record,
+            pages: capture.pages,
+            branchDirectory: (page) => redesignBranchPageDirectory({
+                paths: args.paths,
+                record: args.record,
+                pageId: page.id,
+            }),
+            branchConcept: (page) => branchConcept(args.direction, page),
+        });
+    }
+    catch (error) {
+        return branchRefusal(error);
+    }
+    // A completed child failed under native branch semantics. Persist a newly
+    // found child for truthful resume/spend evidence, then stop before either a
+    // sibling dispatch or polish can hide that failure.
+    const adoptedFailure = preflight.find((entry) => entry.adopted?.failure)?.adopted?.failure;
+    if (adoptedFailure) {
+        await recordAdoptedPages({ record: args.record, paths: args.paths, entries: preflight });
+        throw adoptedFailure;
+    }
+    const remaining = preflight.filter((entry) => !entry.recorded);
+    if (remaining.length === 0)
+        return args.record;
+    // Prove every resume target before the first sibling can dispatch. A
+    // redesign key is intentionally page/generation-scoped, so an old attempt
+    // with that key can still name a different picked candidate.
+    const prepared = await Promise.all(remaining.map(async (entry) => {
+        const branchDir = redesignBranchPageDirectory({
+            paths: args.paths,
+            record: args.record,
+            pageId: entry.input.page.id,
+        });
+        const winner = await imageWinner(entry.input.winner.path, `The picked candidate for ${entry.input.page.id}`);
+        if (winner.kind !== 'image'
+            || winner.sha256 !== entry.input.winner.sha256
+            || winner.bytes.byteLength !== entry.input.winner.bytes) {
+            throw new CliRefusal(`The picked candidate for ${entry.input.page.id} no longer matches its durable materialized digest.`, 'redesign_page_pick_changed');
+        }
+        const runKey = redesignBranchIdempotencyKey({
+            createdAt: args.record.createdAt,
+            ...(args.record.redrawGeneration ? { redrawGeneration: args.record.redrawGeneration } : {}),
+            pageId: entry.input.page.id,
+        });
+        const attemptPath = branchAttemptPath(branchDir);
+        const attempt = await readBranchAttempt(attemptPath);
+        if (!attempt && !entry.adopted) {
+            const exists = await stat(attemptPath)
+                .then(() => true)
+                .catch((error) => {
+                if (error.code === 'ENOENT')
+                    return false;
+                throw error;
+            });
+            if (exists) {
+                return branchRefusal(new InvalidRedesignBranchAttemptError(branchDir, 'branch.attempt.json is not a readable native attempt record'));
+            }
+        }
+        if (attempt && !entry.adopted) {
+            try {
+                verifyResumableRedesignBranchAttempt({
+                    attempt,
+                    attemptPath,
+                    branchDir,
+                    input: entry.input,
+                    winner,
+                    runKey,
+                    concept: branchConcept(args.direction, entry.input.page),
+                    origin: args.config.origin,
+                    maxScreens: args.maxScreens,
+                    conversionModel: args.conversionModel,
+                });
+            }
+            catch (error) {
+                return branchRefusal(error);
+            }
+        }
+        return { entry, branchDir, winner, attempt };
+    }));
+    const branchClient = (args.dependencies.createBranchClient
+        ?? args.dependencies.createHostedClient
+        ?? ((value) => new TwelveUiBranchClient(value)))(args.config);
+    const packageClient = (args.dependencies.createPackageClient
+        ?? ((value) => new TwelveUiConversionPackageClient(value)))(args.config);
+    const limiter = createConcurrencyLimiter(BRANCH_PAGE_CONCURRENCY_DEFAULT);
+    const completed = await Promise.all(prepared.map(({ entry, branchDir, winner, attempt }) => limiter(async () => {
+        const labelClient = (args.dependencies.createPrototypeLabelClient
+            ?? ((value) => new TwelveUiPrototypeLabelClient(value)))(args.config);
+        if (entry.adopted) {
+            await (args.dependencies.runPrototype ?? runPrototypePoststep)({
+                branchDir,
+                resume: true,
+                labelClient,
+            });
+            return { page: entry.adopted.page, failure: entry.adopted.failure };
+        }
+        await prepareOutputDirectory(branchDir);
+        const result = await (args.dependencies.executeBranch ?? executeBranchRun)({
+            branchClient,
+            packageClient,
+            inputs: {
+                outDir: branchDir,
+                scope: 'page',
+                concept: branchConcept(args.direction, entry.input.page),
+                idempotencyKey: redesignBranchIdempotencyKey({
+                    createdAt: args.record.createdAt,
+                    ...(args.record.redrawGeneration ? { redrawGeneration: args.record.redrawGeneration } : {}),
+                    pageId: entry.input.page.id,
+                }),
+                winner,
+                maxScreens: args.maxScreens,
+                convert: { output: 'html', model: args.conversionModel },
+            },
+            origin: args.config.origin,
+            resume: Boolean(attempt),
+            // The outer limiter owns redesign page fan-out. Each child has one page.
+            pageConcurrency: 1,
+        });
+        await (args.dependencies.runPrototype ?? runPrototypePoststep)({ branchDir, labelClient });
+        return {
+            page: {
+                pageId: entry.input.page.id,
+                branchDir,
+                runId: result.completion.runId,
+                status: result.completion.status,
+                completionPath: result.completionPath,
+            },
+            failure: result.failure,
+        };
+    })));
+    // Child work is parallel; redesign.json remains one capture-order writer.
+    const settled = new Map((args.record.branch?.pages ?? []).map((page) => [page.pageId, page]));
+    const completedByPageId = new Map(completed.map((entry) => [entry.page.pageId, entry]));
+    let record = args.record;
+    let failure = null;
+    for (const page of capture.pages) {
+        const completedPage = completedByPageId.get(page.id);
+        if (!completedPage)
+            continue;
+        settled.set(page.id, completedPage.page);
+        record = {
+            ...record,
+            branch: {
+                pages: capture.pages.flatMap((capturedPage) => {
+                    const child = settled.get(capturedPage.id);
+                    return child ? [child] : [];
+                }),
+            },
+        };
+        await writeRedesignRecord(args.paths.record, record);
+        failure ??= completedPage.failure;
+    }
+    if (failure)
+        throw failure;
+    return record;
+};
+//# sourceMappingURL=redesign-branch-stage.js.map

package/dist/redesign-branch-stage.js.map

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

package/dist/redesign-page-candidates.d.ts

@@ -0,0 +1,40 @@
+import type { RedesignCapturedPageRecord, RedesignDraftPageRecord, RedesignPickPageRecord, RedesignRecord } from './redesign-workspace.js';
+/**
+ * Per-page candidate ownership for `12ui redesign`.
+ *
+ * Capture already knows each page's route and screenshot. Draft and pick must
+ * use those facts: a shared homepage winner is not a design for a later
+ * captured page. This module is the one place that decides which pages still
+ * need their own draw, how that draw is identified, and that a missing pick
+ * is a failure rather than a silent reuse of another page's candidate.
+ */
+export declare const redesignPrimaryPage: (pages: readonly RedesignCapturedPageRecord[]) => RedesignCapturedPageRecord;
+export declare const isRedesignPrimaryPage: (pages: readonly RedesignCapturedPageRecord[], pageId: string) => boolean;
+/**
+ * Primary pages keep the hosted plan concept so an ordinary one-page redesign
+ * claims the same draft it always did. Every other page appends its captured
+ * route so the image prompt, and therefore the purchase, is page-specific.
+ */
+export declare const redesignPageDraftConcept: (args: {
+    planConcept: string;
+    page: RedesignCapturedPageRecord;
+    primary: RedesignCapturedPageRecord;
+}) => string;
+/**
+ * Paid-identity extra for a non-primary page. Omitted on the primary so keys
+ * claimed before per-page drafts existed still replay (CLAUDE.md item 3).
+ */
+export declare const redesignPageDraftRoute: (args: {
+    page: RedesignCapturedPageRecord;
+    primary: RedesignCapturedPageRecord;
+}) => string | undefined;
+export declare const recordedDraftPages: (record: RedesignRecord) => RedesignDraftPageRecord[];
+export declare const recordedPickPages: (record: RedesignRecord) => RedesignPickPageRecord[];
+export declare const recordedDraftRunIds: (record: RedesignRecord) => string[];
+export declare const pagesNeedingDraft: (record: RedesignRecord) => RedesignCapturedPageRecord[];
+export declare const pagesNeedingPick: (record: RedesignRecord) => RedesignCapturedPageRecord[];
+export declare const draftForPage: (record: RedesignRecord, pageId: string) => RedesignDraftPageRecord;
+export declare const pickForPage: (record: RedesignRecord, pageId: string) => RedesignPickPageRecord;
+export declare const withDraftPages: (pages: readonly RedesignDraftPageRecord[], primaryPageId: string) => NonNullable<RedesignRecord["draft"]>;
+export declare const withPickPages: (pages: readonly RedesignPickPageRecord[], primaryPageId: string) => NonNullable<RedesignRecord["pick"]>;
+//# sourceMappingURL=redesign-page-candidates.d.ts.map

package/dist/redesign-page-candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redesign-page-candidates.d.ts","sourceRoot":"","sources":["../src/redesign-page-candidates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;GAQG;AAEH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,SAAS,0BAA0B,EAAE,KAC3C,0BAIF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,OAAO,SAAS,0BAA0B,EAAE,EAC5C,QAAQ,MAAM,KACb,OAAkC,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,0BAA0B,CAAC;IACjC,OAAO,EAAE,0BAA0B,CAAC;CACrC,KAAG,MAOH,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM;IAC3C,IAAI,EAAE,0BAA0B,CAAC;IACjC,OAAO,EAAE,0BAA0B,CAAC;CACrC,KAAG,MAAM,GAAG,SAEZ,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,QAAQ,cAAc,KAAG,uBAAuB,EAgBlF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,cAAc,KAAG,sBAAsB,EAmBhF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,QAAQ,cAAc,KAAG,MAAM,EAIlE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,cAAc,KAAG,0BAA0B,EAGpF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,cAAc,KAAG,0BAA0B,EAGnF,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,QAAQ,cAAc,EACtB,QAAQ,MAAM,KACb,uBAQF,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,QAAQ,cAAc,EACtB,QAAQ,MAAM,KACb,sBAQF,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,OAAO,SAAS,uBAAuB,EAAE,EACzC,eAAe,MAAM,KACpB,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAQrC,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,OAAO,SAAS,sBAAsB,EAAE,EACxC,eAAe,MAAM,KACpB,WAAW,CAAC,cAAc,CAAC,MAAM,CAAC,CASpC,CAAC"}

package/dist/redesign-page-candidates.js

@@ -0,0 +1,131 @@
+import { readConceptValue } from './concept-input.js';
+/**
+ * Per-page candidate ownership for `12ui redesign`.
+ *
+ * Capture already knows each page's route and screenshot. Draft and pick must
+ * use those facts: a shared homepage winner is not a design for a later
+ * captured page. This module is the one place that decides which pages still
+ * need their own draw, how that draw is identified, and that a missing pick
+ * is a failure rather than a silent reuse of another page's candidate.
+ */
+export const redesignPrimaryPage = (pages) => {
+    const homepage = pages[0];
+    if (!homepage)
+        throw new Error('Capture recorded no pages');
+    return homepage;
+};
+export const isRedesignPrimaryPage = (pages, pageId) => pages[0]?.id === pageId;
+/**
+ * Primary pages keep the hosted plan concept so an ordinary one-page redesign
+ * claims the same draft it always did. Every other page appends its captured
+ * route so the image prompt, and therefore the purchase, is page-specific.
+ */
+export const redesignPageDraftConcept = (args) => {
+    if (args.page.id === args.primary.id)
+        return args.planConcept;
+    return readConceptValue({
+        value: `${args.planConcept} Rebuild the captured page at ${args.page.url}.`,
+        flag: '--direction',
+        trimHint: 'Shorten the direction; each page URL is appended automatically.',
+    });
+};
+/**
+ * Paid-identity extra for a non-primary page. Omitted on the primary so keys
+ * claimed before per-page drafts existed still replay (CLAUDE.md item 3).
+ */
+export const redesignPageDraftRoute = (args) => (args.page.id === args.primary.id ? undefined : args.page.url);
+export const recordedDraftPages = (record) => {
+    if (!record.draft)
+        return [];
+    const primaryId = record.capture?.pages[0]?.id;
+    if (!primaryId)
+        return [];
+    const primary = {
+        pageId: primaryId,
+        runDir: record.draft.runDir,
+        runId: record.draft.runId,
+    };
+    if (!record.draft.pages || record.draft.pages.length === 0)
+        return [primary];
+    const recordedPrimary = record.draft.pages.find((page) => page.pageId === primaryId);
+    if (!recordedPrimary)
+        return [primary, ...record.draft.pages];
+    if (recordedPrimary.runDir !== primary.runDir || recordedPrimary.runId !== primary.runId) {
+        throw new Error('Recorded primary draft does not match the durable top-level draft');
+    }
+    return [...record.draft.pages];
+};
+export const recordedPickPages = (record) => {
+    if (!record.pick)
+        return [];
+    const primaryId = record.capture?.pages[0]?.id;
+    if (!primaryId)
+        return [];
+    const primary = {
+        pageId: primaryId,
+        slot: record.pick.slot,
+        imagePath: record.pick.imagePath,
+        sha256: record.pick.sha256,
+    };
+    if (!record.pick.pages || record.pick.pages.length === 0)
+        return [primary];
+    const recordedPrimary = record.pick.pages.find((page) => page.pageId === primaryId);
+    if (!recordedPrimary)
+        return [primary, ...record.pick.pages];
+    if (recordedPrimary.slot !== primary.slot
+        || recordedPrimary.imagePath !== primary.imagePath
+        || recordedPrimary.sha256 !== primary.sha256) {
+        throw new Error('Recorded primary pick does not match the durable top-level pick');
+    }
+    return [...record.pick.pages];
+};
+export const recordedDraftRunIds = (record) => {
+    const pages = recordedDraftPages(record);
+    if (pages.length > 0)
+        return pages.map((page) => page.runId);
+    return record.draft ? [record.draft.runId] : [];
+};
+export const pagesNeedingDraft = (record) => {
+    const done = new Set(recordedDraftPages(record).map((page) => page.pageId));
+    return (record.capture?.pages ?? []).filter((page) => !done.has(page.id));
+};
+export const pagesNeedingPick = (record) => {
+    const done = new Set(recordedPickPages(record).map((page) => page.pageId));
+    return (record.capture?.pages ?? []).filter((page) => !done.has(page.id));
+};
+export const draftForPage = (record, pageId) => {
+    const found = recordedDraftPages(record).find((page) => page.pageId === pageId);
+    if (!found) {
+        throw new Error(`Captured page ${pageId} has no page-specific draft; re-run from draft so it can buy its own candidates.`);
+    }
+    return found;
+};
+export const pickForPage = (record, pageId) => {
+    const found = recordedPickPages(record).find((page) => page.pageId === pageId);
+    if (!found) {
+        throw new Error(`Captured page ${pageId} has no page-specific pick; refusing to reuse another page's winner.`);
+    }
+    return found;
+};
+export const withDraftPages = (pages, primaryPageId) => {
+    const primary = pages.find((page) => page.pageId === primaryPageId) ?? pages[0];
+    if (!primary)
+        throw new Error('Cannot record a draft with no pages');
+    return {
+        runDir: primary.runDir,
+        runId: primary.runId,
+        pages: [...pages],
+    };
+};
+export const withPickPages = (pages, primaryPageId) => {
+    const primary = pages.find((page) => page.pageId === primaryPageId) ?? pages[0];
+    if (!primary)
+        throw new Error('Cannot record a pick with no pages');
+    return {
+        slot: primary.slot,
+        imagePath: primary.imagePath,
+        sha256: primary.sha256,
+        pages: [...pages],
+    };
+};
+//# sourceMappingURL=redesign-page-candidates.js.map

package/dist/redesign-page-candidates.js.map

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

package/dist/redesign-page-ownership.d.ts

@@ -0,0 +1,36 @@
+import type { RedesignCapturedPageRecord, RedesignDraftPageRecord, RedesignPickPageRecord, RedesignRecord } from './redesign-workspace.js';
+/**
+ * Durable proof that a branch page owns its selected draft. Parent records
+ * name file locations for navigation, but those mutable paths are never the
+ * identity: the route, capture digest, hosted run ID, completion run ID, and
+ * materialized candidate digest must all agree before branch can claim work.
+ */
+export declare class InvalidRedesignPageOwnershipError extends Error {
+    constructor(pageId: string, detail: string);
+}
+export type VerifiedRedesignPageBranchInput = {
+    page: RedesignCapturedPageRecord;
+    draft: RedesignDraftPageRecord;
+    pick: RedesignPickPageRecord;
+    /**
+     * The exact DraftCandidateRecord.outputPath, proven owned and read from disk
+     * in this verification pass. Child branch artifacts must bind to this value,
+     * never merely to a digest that another page could also name.
+     */
+    winner: {
+        path: string;
+        sha256: string;
+        bytes: number;
+    };
+};
+/** Validate one page's draft, completion, and selected materialized candidate. */
+export declare const verifyRedesignPageBranchInput: (args: {
+    record: RedesignRecord;
+    page: RedesignCapturedPageRecord;
+}) => Promise<VerifiedRedesignPageBranchInput>;
+/** Validate every pending branch input before any page is allowed to dispatch. */
+export declare const verifyRedesignPageBranchInputs: (args: {
+    record: RedesignRecord;
+    pages: readonly RedesignCapturedPageRecord[];
+}) => Promise<VerifiedRedesignPageBranchInput[]>;
+//# sourceMappingURL=redesign-page-ownership.d.ts.map

package/dist/redesign-page-ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redesign-page-ownership.d.ts","sourceRoot":"","sources":["../src/redesign-page-ownership.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC;;;;;GAKG;AAEH,qBAAa,iCAAkC,SAAQ,KAAK;gBAC9C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI3C;AAED,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,0BAA0B,CAAC;IACjC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,IAAI,EAAE,sBAAsB,CAAC;IAC7B;;;;OAIG;IACH,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD,CAAC;AAiGF,kFAAkF;AAClF,eAAO,MAAM,6BAA6B,GAAU,MAAM;IACxD,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,0BAA0B,CAAC;CAClC,KAAG,OAAO,CAAC,+BAA+B,CAqG1C,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,8BAA8B,GAAU,MAAM;IACzD,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC9C,KAAG,OAAO,CAAC,+BAA+B,EAAE,CAE5C,CAAC"}

package/dist/redesign-page-ownership.js

@@ -0,0 +1,174 @@
+import { createHash } from 'node:crypto';
+import { readFile, realpath } from 'node:fs/promises';
+import path from 'node:path';
+import { draftForPage, pickForPage, redesignPrimaryPage } from './redesign-page-candidates.js';
+import { draftPaths } from './draft-workspace.js';
+/**
+ * Durable proof that a branch page owns its selected draft. Parent records
+ * name file locations for navigation, but those mutable paths are never the
+ * identity: the route, capture digest, hosted run ID, completion run ID, and
+ * materialized candidate digest must all agree before branch can claim work.
+ */
+export class InvalidRedesignPageOwnershipError extends Error {
+    constructor(pageId, detail) {
+        super(`Redesign page ${pageId} has invalid draft ownership: ${detail}`);
+        this.name = 'InvalidRedesignPageOwnershipError';
+    }
+}
+const samePath = (left, right) => path.resolve(left) === path.resolve(right);
+const insideDirectory = (file, directory) => {
+    const relative = path.relative(path.resolve(directory), path.resolve(file));
+    return relative !== '' && !relative.startsWith(`..${path.sep}`) && relative !== '..' && !path.isAbsolute(relative);
+};
+const isRecord = (value) => (!!value && typeof value === 'object' && !Array.isArray(value));
+const readJson = async (file, pageId, label) => {
+    let raw;
+    try {
+        raw = await readFile(file, 'utf8');
+    }
+    catch (error) {
+        throw new InvalidRedesignPageOwnershipError(pageId, `${label} is unreadable at ${file} (${error.code ?? 'unknown error'})`);
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        throw new InvalidRedesignPageOwnershipError(pageId, `${label} is not JSON at ${file}`);
+    }
+};
+const validDraftRecord = (value) => (isRecord(value)
+    && typeof value.runDir === 'string'
+    && isRecord(value.redesignSource)
+    && typeof value.redesignSource.path === 'string'
+    && typeof value.redesignSource.sha256 === 'string'
+    && isRecord(value.hosted)
+    && typeof value.hosted.runId === 'string'
+    && Array.isArray(value.hosted.candidates));
+const validDraftCompletion = (value) => (isRecord(value)
+    && typeof value.runId === 'string'
+    && Array.isArray(value.candidates));
+const materializedCandidateDigest = async (args) => {
+    let bytes;
+    try {
+        bytes = await readFile(args.file);
+    }
+    catch (error) {
+        throw new InvalidRedesignPageOwnershipError(args.pageId, `selected DraftCandidateRecord.outputPath is unreadable at ${args.file}`
+            + ` (${error.code ?? 'unknown error'})`);
+    }
+    return { sha256: createHash('sha256').update(bytes).digest('hex'), bytes: bytes.byteLength };
+};
+const assertOwnedCandidatePath = async (args) => {
+    if (!insideDirectory(args.candidatePath, args.candidatesDirectory)) {
+        throw new InvalidRedesignPageOwnershipError(args.pageId, 'selected DraftCandidateRecord.outputPath is outside its owning child draft candidates directory');
+    }
+    let resolvedCandidate;
+    let resolvedDirectory;
+    try {
+        [resolvedCandidate, resolvedDirectory] = await Promise.all([
+            realpath(args.candidatePath),
+            realpath(args.candidatesDirectory),
+        ]);
+    }
+    catch (error) {
+        throw new InvalidRedesignPageOwnershipError(args.pageId, `selected DraftCandidateRecord.outputPath cannot resolve inside its owning child draft directory`
+            + ` (${error.code ?? 'unknown error'})`);
+    }
+    if (!insideDirectory(resolvedCandidate, resolvedDirectory)) {
+        throw new InvalidRedesignPageOwnershipError(args.pageId, 'selected DraftCandidateRecord.outputPath resolves outside its owning child draft candidates directory');
+    }
+};
+/** Validate one page's draft, completion, and selected materialized candidate. */
+export const verifyRedesignPageBranchInput = async (args) => {
+    const primary = redesignPrimaryPage(args.record.capture?.pages ?? []);
+    const pageId = args.page.id;
+    let draft;
+    let pick;
+    try {
+        draft = draftForPage(args.record, pageId);
+        pick = pickForPage(args.record, pageId);
+    }
+    catch (error) {
+        throw new InvalidRedesignPageOwnershipError(pageId, error instanceof Error ? error.message : String(error));
+    }
+    const paths = draftPaths(draft.runDir);
+    const draftRecord = await readJson(paths.draftRecord, pageId, 'draft record');
+    if (!validDraftRecord(draftRecord)) {
+        throw new InvalidRedesignPageOwnershipError(pageId, 'draft record has no complete hosted/source identity');
+    }
+    if (!samePath(draftRecord.runDir, draft.runDir)) {
+        throw new InvalidRedesignPageOwnershipError(pageId, 'draft record runDir differs from parent draft entry');
+    }
+    if (draftRecord.hosted.runId !== draft.runId) {
+        throw new InvalidRedesignPageOwnershipError(pageId, 'draft record hosted run ID differs from parent draft entry');
+    }
+    const source = draftRecord.redesignSource;
+    if (!source) {
+        throw new InvalidRedesignPageOwnershipError(pageId, 'draft record has no redesign source');
+    }
+    if (source.sha256 !== args.page.sha256) {
+        throw new InvalidRedesignPageOwnershipError(pageId, 'draft source digest differs from captured page');
+    }
+    if (!samePath(source.path, args.page.path)) {
+        throw new InvalidRedesignPageOwnershipError(pageId, 'draft source path differs from captured page');
+    }
+    if (args.page.id !== primary.id && draftRecord.pageRoute !== args.page.url) {
+        throw new InvalidRedesignPageOwnershipError(pageId, 'non-primary draft route differs from captured page URL');
+    }
+    if (args.page.id === primary.id && draftRecord.pageRoute !== undefined
+        && draftRecord.pageRoute !== args.page.url) {
+        throw new InvalidRedesignPageOwnershipError(pageId, 'primary draft route differs from captured page URL');
+    }
+    const candidate = draftRecord.hosted.candidates.find((entry) => (isRecord(entry)
+        && entry.id === pick.slot
+        && typeof entry.slot === 'string'
+        && typeof entry.outputPath === 'string'));
+    if (!candidate || typeof candidate.slot !== 'string' || typeof candidate.outputPath !== 'string') {
+        throw new InvalidRedesignPageOwnershipError(pageId, 'selected slot is absent from the draft run');
+    }
+    await assertOwnedCandidatePath({
+        pageId,
+        candidatePath: candidate.outputPath,
+        candidatesDirectory: paths.candidatesDir,
+    });
+    const completion = await readJson(paths.completion, pageId, 'draft completion');
+    if (!validDraftCompletion(completion)) {
+        throw new InvalidRedesignPageOwnershipError(pageId, 'draft completion has no run ID or candidates');
+    }
+    if (completion.runId !== draft.runId) {
+        throw new InvalidRedesignPageOwnershipError(pageId, 'draft completion run ID differs from parent draft entry');
+    }
+    const materialized = completion.candidates.find((entry) => (isRecord(entry)
+        && entry.slot === candidate.slot
+        && typeof entry.path === 'string'
+        && typeof entry.sha256 === 'string'
+        && typeof entry.bytes === 'number'
+        && Number.isInteger(entry.bytes)
+        && entry.bytes >= 0));
+    if (!materialized) {
+        throw new InvalidRedesignPageOwnershipError(pageId, 'selected draft candidate is not materialized');
+    }
+    if (!samePath(materialized.path, candidate.outputPath)
+        || !samePath(pick.imagePath, candidate.outputPath)
+        || materialized.sha256 !== pick.sha256) {
+        throw new InvalidRedesignPageOwnershipError(pageId, 'parent pick or completion differs from this draft run\'s selected DraftCandidateRecord.outputPath');
+    }
+    const onDisk = await materializedCandidateDigest({ file: candidate.outputPath, pageId });
+    if (onDisk.sha256 !== materialized.sha256 || onDisk.sha256 !== pick.sha256
+        || onDisk.bytes !== materialized.bytes) {
+        throw new InvalidRedesignPageOwnershipError(pageId, 'selected DraftCandidateRecord.outputPath digest or byte count differs from its completion/pick proof');
+    }
+    return {
+        page: args.page,
+        draft,
+        pick,
+        winner: {
+            path: candidate.outputPath,
+            sha256: onDisk.sha256,
+            bytes: onDisk.bytes,
+        },
+    };
+};
+/** Validate every pending branch input before any page is allowed to dispatch. */
+export const verifyRedesignPageBranchInputs = async (args) => Promise.all(args.pages.map((page) => verifyRedesignPageBranchInput({ record: args.record, page })));
+//# sourceMappingURL=redesign-page-ownership.js.map