@12ui/design 0.2.58 → 0.2.59

package/dist/redesign-branch-identity.d.ts

@@ -0,0 +1,23 @@
+import type { RedesignPaths, RedesignRecord } from './redesign-workspace.js';
+/** Generation zero retains the directory and key layout claimed before redraw. */
+export declare const redesignBranchGeneration: (record: Pick<RedesignRecord, "redrawGeneration">) => number;
+/**
+ * A redraw never enters an old child directory: it may contain either a
+ * terminal completion or a pre-spend attempt record that must remain evidence
+ * for the generation that created it.
+ */
+export declare const redesignBranchPageDirectory: (args: {
+    paths: RedesignPaths;
+    record: Pick<RedesignRecord, "redrawGeneration">;
+    pageId: string;
+}) => string;
+/**
+ * The omitted generation term gives old primary branch keys byte-for-byte
+ * continuity. A positive generation is a new paid branch identity.
+ */
+export declare const redesignBranchIdempotencyKey: (args: {
+    createdAt: string;
+    redrawGeneration?: number;
+    pageId: string;
+}) => string;
+//# sourceMappingURL=redesign-branch-identity.d.ts.map

package/dist/redesign-branch-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redesign-branch-identity.d.ts","sourceRoot":"","sources":["../src/redesign-branch-identity.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE7E,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,GAAI,QAAQ,IAAI,CAAC,cAAc,EAAE,kBAAkB,CAAC,KAAG,MAE3F,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,GAAI,MAAM;IAChD,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB,KAAG,MAKH,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GAAI,MAAM;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,KAAG,MAMH,CAAC"}

package/dist/redesign-branch-identity.js

@@ -0,0 +1,27 @@
+import { createHash } from 'node:crypto';
+import path from 'node:path';
+/** Generation zero retains the directory and key layout claimed before redraw. */
+export const redesignBranchGeneration = (record) => (record.redrawGeneration ?? 0);
+/**
+ * A redraw never enters an old child directory: it may contain either a
+ * terminal completion or a pre-spend attempt record that must remain evidence
+ * for the generation that created it.
+ */
+export const redesignBranchPageDirectory = (args) => {
+    const generation = redesignBranchGeneration(args.record);
+    return generation === 0
+        ? path.join(args.paths.branchDir, args.pageId)
+        : path.join(args.paths.branchDir, `redraw-${generation}`, args.pageId);
+};
+/**
+ * The omitted generation term gives old primary branch keys byte-for-byte
+ * continuity. A positive generation is a new paid branch identity.
+ */
+export const redesignBranchIdempotencyKey = (args) => {
+    const generation = args.redrawGeneration ?? 0;
+    const source = generation === 0
+        ? `${args.createdAt}\u0000${args.pageId}`
+        : `${args.createdAt}\u0000${args.pageId}\u0000redraw-generation:${generation}`;
+    return `redesign-branch:v2:${createHash('sha256').update(source).digest('hex')}`;
+};
+//# sourceMappingURL=redesign-branch-identity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redesign-branch-identity.js","sourceRoot":"","sources":["../src/redesign-branch-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,kFAAkF;AAClF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAgD,EAAU,EAAE,CAAC,CACpG,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAC7B,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,IAI3C,EAAU,EAAE;IACX,MAAM,UAAU,GAAG,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,OAAO,UAAU,KAAK,CAAC;QACrB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;QAC9C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,UAAU,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3E,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,IAI5C,EAAU,EAAE;IACX,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,UAAU,KAAK,CAAC;QAC7B,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,SAAS,IAAI,CAAC,MAAM,EAAE;QACzC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,SAAS,IAAI,CAAC,MAAM,2BAA2B,UAAU,EAAE,CAAC;IACjF,OAAO,sBAAsB,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACnF,CAAC,CAAC"}

package/dist/redesign-branch-record-verification.d.ts

@@ -0,0 +1,51 @@
+import { type BranchAttempt } from './branch-run-record.js';
+import type { BranchWinnerInput } from './branch-execution-types.js';
+import { type AdoptedRedesignBranch } from './redesign-branch-adoption.js';
+import { type VerifiedRedesignPageBranchInput } from './redesign-page-ownership.js';
+import type { RedesignCapturedPageRecord, RedesignRecord } from './redesign-workspace.js';
+/** A parent branch row is a pointer, never proof that its child settled. */
+export declare class InvalidRedesignBranchRecordError extends Error {
+    constructor(pageId: string, detail: string);
+}
+/** A resumable child is durable input, not a hint for the executor to reinterpret. */
+export declare class InvalidRedesignBranchAttemptError extends Error {
+    constructor(branchDir: string, detail: string);
+}
+export type VerifiedRedesignBranchPage = {
+    input: VerifiedRedesignPageBranchInput;
+    /** Present when redesign.json already claimed this page as done. */
+    recorded: boolean;
+    /** Present only when this generation's exact child completion exists. */
+    adopted?: AdoptedRedesignBranch;
+};
+/**
+ * Check a persisted, non-terminal native BranchAttempt against the exact
+ * verified page candidate before the executor gets a chance to resume it.
+ * Redesign's page idempotency key deliberately names the page/generation, not
+ * the candidate bytes, so this comparison must not be deferred to the native
+ * run-key check.
+ */
+export declare const verifyResumableRedesignBranchAttempt: (args: {
+    attempt: BranchAttempt;
+    attemptPath: string;
+    branchDir: string;
+    input: VerifiedRedesignPageBranchInput;
+    winner: BranchWinnerInput;
+    runKey: string;
+    concept: string;
+    origin: string;
+    maxScreens: number;
+    conversionModel: string;
+}) => void;
+/**
+ * Verify every capture input first, then make a persisted parent row earn its
+ * `done` state from the child sentinel it names. This runs before dispatch and
+ * before polish, so shape-valid JSON cannot skip immutable-artifact checks.
+ */
+export declare const verifyRedesignBranchPages: (args: {
+    record: RedesignRecord;
+    pages: readonly RedesignCapturedPageRecord[];
+    branchDirectory: (page: RedesignCapturedPageRecord) => string;
+    branchConcept: (page: RedesignCapturedPageRecord) => string;
+}) => Promise<VerifiedRedesignBranchPage[]>;
+//# sourceMappingURL=redesign-branch-record-verification.d.ts.map

package/dist/redesign-branch-record-verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redesign-branch-record-verification.d.ts","sourceRoot":"","sources":["../src/redesign-branch-record-verification.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,+BAA+B,EACrC,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,0BAA0B,EAC1B,cAAc,EACf,MAAM,yBAAyB,CAAC;AAEjC,4EAA4E;AAC5E,qBAAa,gCAAiC,SAAQ,KAAK;gBAC7C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI3C;AAED,sFAAsF;AACtF,qBAAa,iCAAkC,SAAQ,KAAK;gBAC9C,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI9C;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,EAAE,+BAA+B,CAAC;IACvC,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACjC,CAAC;AAeF;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,GAAI,MAAM;IACzD,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,+BAA+B,CAAC;IACvC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB,KAAG,IA8DH,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GAAU,MAAM;IACpD,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC7C,eAAe,EAAE,CAAC,IAAI,EAAE,0BAA0B,KAAK,MAAM,CAAC;IAC9D,aAAa,EAAE,CAAC,IAAI,EAAE,0BAA0B,KAAK,MAAM,CAAC;CAC7D,KAAG,OAAO,CAAC,0BAA0B,EAAE,CA4CvC,CAAC"}

package/dist/redesign-branch-record-verification.js

@@ -0,0 +1,127 @@
+import path from 'node:path';
+import { branchConceptDigest } from './branch-identity.js';
+import { branchAttemptPath, branchCompletionPath, } from './branch-run-record.js';
+import { adoptCompletedRedesignBranch, } from './redesign-branch-adoption.js';
+import { verifyRedesignPageBranchInputs, } from './redesign-page-ownership.js';
+/** A parent branch row is a pointer, never proof that its child settled. */
+export class InvalidRedesignBranchRecordError extends Error {
+    constructor(pageId, detail) {
+        super(`Redesign branch page ${pageId} is invalid: ${detail}`);
+        this.name = 'InvalidRedesignBranchRecordError';
+    }
+}
+/** A resumable child is durable input, not a hint for the executor to reinterpret. */
+export class InvalidRedesignBranchAttemptError extends Error {
+    constructor(branchDir, detail) {
+        super(`Redesign branch attempt in ${branchDir} is invalid: ${detail}`);
+        this.name = 'InvalidRedesignBranchAttemptError';
+    }
+}
+const samePath = (left, right) => path.resolve(left) === path.resolve(right);
+const isResumableAttemptStatus = (value) => (value === 'claiming'
+    || value === 'dispatching'
+    || value === 'downloading'
+    || value === 'converting');
+const isImageWinner = (winner) => winner.kind === 'image';
+/**
+ * Check a persisted, non-terminal native BranchAttempt against the exact
+ * verified page candidate before the executor gets a chance to resume it.
+ * Redesign's page idempotency key deliberately names the page/generation, not
+ * the candidate bytes, so this comparison must not be deferred to the native
+ * run-key check.
+ */
+export const verifyResumableRedesignBranchAttempt = (args) => {
+    const { attempt, winner } = args;
+    if (!isImageWinner(winner)) {
+        throw new InvalidRedesignBranchAttemptError(args.branchDir, 'redesign page branches require an image winner');
+    }
+    const recordedWinner = attempt.winner;
+    const winnerMatches = !!recordedWinner
+        && typeof recordedWinner === 'object'
+        && recordedWinner.kind === 'image'
+        && samePath(recordedWinner.imagePath, args.input.winner.path)
+        && samePath(recordedWinner.imagePath, winner.imagePath)
+        && recordedWinner.sha256 === args.input.winner.sha256
+        && recordedWinner.sha256 === winner.sha256
+        && recordedWinner.mediaType === winner.mediaType
+        && (recordedWinner.width === undefined || recordedWinner.width === winner.width)
+        && (recordedWinner.height === undefined || recordedWinner.height === winner.height);
+    const canvas = attempt.generationCanvas;
+    const canvasMatches = !!canvas && (!!canvas
+        && typeof canvas === 'object'
+        && !!canvas.winner
+        && typeof canvas.winner === 'object'
+        && canvas.provenance === 'inherited-from-winner'
+        && canvas.winner.width === winner.width
+        && canvas.winner.height === winner.height
+        && canvas.declaredAspect === undefined);
+    const convert = attempt.convert;
+    if (!samePath(args.attemptPath, branchAttemptPath(args.branchDir))
+        || attempt.version !== 1
+        || !isResumableAttemptStatus(attempt.status)
+        || typeof attempt.runKey !== 'string'
+        || attempt.runKey !== args.runKey
+        || typeof attempt.origin !== 'string'
+        || attempt.origin !== args.origin
+        || attempt.scope !== 'page'
+        || typeof attempt.concept !== 'string'
+        || attempt.concept !== args.concept
+        || typeof attempt.conceptSha256 !== 'string'
+        || attempt.conceptSha256 !== branchConceptDigest(args.concept)
+        || !winnerMatches
+        || !canvasMatches
+        || attempt.aspect !== undefined
+        || attempt.maxScreens !== args.maxScreens
+        || !convert
+        || convert.output !== 'html'
+        || convert.model !== args.conversionModel
+        || convert.responsiveQuality !== undefined
+        || attempt.sourceConversionId !== undefined
+        || attempt.prototype !== undefined
+        || attempt.polish !== undefined
+        || attempt.completionPath !== undefined
+        || attempt.completedAt !== undefined
+        || typeof attempt.createdAt !== 'string'
+        || attempt.createdAt.length === 0) {
+        throw new InvalidRedesignBranchAttemptError(args.branchDir, 'it does not bind to this page directory, owned selected candidate, and fixed branch inputs');
+    }
+};
+/**
+ * Verify every capture input first, then make a persisted parent row earn its
+ * `done` state from the child sentinel it names. This runs before dispatch and
+ * before polish, so shape-valid JSON cannot skip immutable-artifact checks.
+ */
+export const verifyRedesignBranchPages = async (args) => {
+    const inputs = await verifyRedesignPageBranchInputs({ record: args.record, pages: args.pages });
+    const parentByPageId = new Map((args.record.branch?.pages ?? []).map((page) => [page.pageId, page]));
+    return Promise.all(inputs.map(async (input) => {
+        const branchDir = path.resolve(args.branchDirectory(input.page));
+        const parent = parentByPageId.get(input.page.id);
+        if (parent) {
+            const expectedCompletion = branchCompletionPath(branchDir);
+            if (!samePath(parent.branchDir, branchDir) || !samePath(parent.completionPath, expectedCompletion)) {
+                throw new InvalidRedesignBranchRecordError(input.page.id, 'parent branchDir or completionPath does not name this generation\'s exact child artifacts');
+            }
+        }
+        const adopted = await adoptCompletedRedesignBranch({
+            branchDir,
+            concept: args.branchConcept(input.page),
+            input,
+        });
+        if (!parent)
+            return { input, recorded: false, ...(adopted ? { adopted } : {}) };
+        if (!adopted) {
+            throw new InvalidRedesignBranchRecordError(input.page.id, 'parent says done but its exact branch.complete.json is absent');
+        }
+        const child = adopted.page;
+        if (parent.pageId !== child.pageId
+            || !samePath(parent.branchDir, child.branchDir)
+            || parent.runId !== child.runId
+            || parent.status !== child.status
+            || !samePath(parent.completionPath, child.completionPath)) {
+            throw new InvalidRedesignBranchRecordError(input.page.id, 'parent row contradicts its exact branch.complete.json');
+        }
+        return { input, recorded: true, adopted };
+    }));
+};
+//# sourceMappingURL=redesign-branch-record-verification.js.map

package/dist/redesign-branch-record-verification.js.map

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

package/dist/redesign-branch-stage.d.ts

@@ -0,0 +1,17 @@
+import { readConversionConfig } from './config.js';
+import type { ConversionModel } from './conversion-models.js';
+import { type RedesignPaths, type RedesignRecord } from './redesign-workspace.js';
+import type { RedesignCommandDependencies } from './cli-redesign-command.js';
+type BranchStageDependencies = Pick<RedesignCommandDependencies, 'createBranchClient' | 'createHostedClient' | 'createPackageClient' | 'createPrototypeLabelClient' | 'executeBranch' | 'runPrototype'>;
+/** Execute or adopt one exact child per captured page, never a shared winner. */
+export declare const runRedesignBranchStage: (args: {
+    record: RedesignRecord;
+    paths: RedesignPaths;
+    direction: string;
+    maxScreens: number;
+    conversionModel: ConversionModel;
+    config: ReturnType<typeof readConversionConfig>;
+    dependencies: BranchStageDependencies;
+}) => Promise<RedesignRecord>;
+export {};
+//# sourceMappingURL=redesign-branch-stage.d.ts.map

package/dist/redesign-branch-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redesign-branch-stage.d.ts","sourceRoot":"","sources":["../src/redesign-branch-stage.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAmB9D,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAE7E,KAAK,uBAAuB,GAAG,IAAI,CAAC,2BAA2B,EAC3D,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,GACrB,4BAA4B,GAC5B,eAAe,GACf,cAAc,CACjB,CAAC;AAgDF,iFAAiF;AACjF,eAAO,MAAM,sBAAsB,GAAU,MAAM;IACjD,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAChD,YAAY,EAAE,uBAAuB,CAAC;CACvC,KAAG,OAAO,CAAC,cAAc,CA2KzB,CAAC"}

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"}