@12ui/design 0.2.58 → 0.2.59

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

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

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

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

@@ -4,5 +4,7 @@ import type { HostedRedesignPlanRequest } from './redesign-plan-client.js';
  * capture facts it may use, so an interrupted request can replay without
  * deriving a new direction plan or silently moving to changed page evidence.
  */
-export declare const redesignPlanIdempotencyKey: (request: HostedRedesignPlanRequest) => string;
+export declare const redesignPlanIdempotencyKey: (request: HostedRedesignPlanRequest, options?: {
+    redrawGeneration?: number;
+}) => string;
 //# sourceMappingURL=redesign-plan-identity.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"redesign-plan-identity.d.ts","sourceRoot":"","sources":["../src/redesign-plan-identity.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GAAI,SAAS,yBAAyB,KAAG,MAO/E,CAAC"}
+{"version":3,"file":"redesign-plan-identity.d.ts","sourceRoot":"","sources":["../src/redesign-plan-identity.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,yBAAyB,EAClC,UAAS;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAO,KAC1C,MAUF,CAAC"}

package/dist/redesign-plan-identity.js

@@ -4,11 +4,14 @@ import { createHash } from 'node:crypto';
  * capture facts it may use, so an interrupted request can replay without
  * deriving a new direction plan or silently moving to changed page evidence.
  */
-export const redesignPlanIdempotencyKey = (request) => {
+export const redesignPlanIdempotencyKey = (request, options = {}) => {
     const digest = createHash('sha256').update(JSON.stringify({
         direction: request.direction,
         capture: request.capture ?? null,
         referenceImageAttached: request.referenceImageAttached,
+        ...(options.redrawGeneration && options.redrawGeneration > 0
+            ? { redrawGeneration: options.redrawGeneration }
+            : {}),
     })).digest('hex');
     return `redesign-plan:v1:${digest}`;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"redesign-plan-identity.js","sourceRoot":"","sources":["../src/redesign-plan-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,OAAkC,EAAU,EAAE;IACvF,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QACxD,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;KACvD,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,oBAAoB,MAAM,EAAE,CAAC;AACtC,CAAC,CAAC"}
+{"version":3,"file":"redesign-plan-identity.js","sourceRoot":"","sources":["../src/redesign-plan-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,OAAkC,EAClC,UAAyC,EAAE,EACnC,EAAE;IACV,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QACxD,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;QAChC,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;QACtD,GAAG,CAAC,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,GAAG,CAAC;YAC1D,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE;YAChD,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO,oBAAoB,MAAM,EAAE,CAAC;AACtC,CAAC,CAAC"}

package/dist/redesign-plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redesign-plan.d.ts","sourceRoot":"","sources":["../src/redesign-plan.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAgC7D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,MAAM;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;CAClC,KAAG,YAyEH,CAAC"}
+{"version":3,"file":"redesign-plan.d.ts","sourceRoot":"","sources":["../src/redesign-plan.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAgC7D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;IACjC,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,MAAM;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;CAClC,KAAG,YA+EH,CAAC"}

package/dist/redesign-plan.js

@@ -50,16 +50,18 @@ export const buildRedesignPlan = (args) => {
         {
             stage: 'draft',
             paid: true,
-            wouldBuy: `${args.candidateCount} hosted draft candidate(s), generated from 1 captured reference image`,
-            typicalSeconds: OPERATION_DURATION_HINTS.hostedDraftCandidate,
-            plannedCostUsd: usd(CORPUS_SEARCH_CEILING_USD
+            wouldBuy: `${args.pageCount} hosted draft draw(s) of ${args.candidateCount} candidate(s) each,`
+                + ' one captured reference image per page',
+            typicalSeconds: OPERATION_DURATION_HINTS.hostedDraftCandidate
+                * Math.ceil(args.pageCount / BRANCH_PAGE_CONCURRENCY_DEFAULT),
+            plannedCostUsd: usd(args.pageCount * (CORPUS_SEARCH_CEILING_USD
                 + DRAFT_DIRECTIONS_CEILING_USD
-                + args.candidateCount * DRAFT_CANDIDATE_PRICE_USD),
+                + args.candidateCount * DRAFT_CANDIDATE_PRICE_USD)),
         },
         {
             stage: 'pick',
             paid: false,
-            wouldBuy: 'nothing — selects one already-generated candidate by --slot',
+            wouldBuy: 'nothing — selects one already-generated candidate by --slot on every page\'s draw',
             typicalSeconds: 1,
             plannedCostUsd: 0,
         },
@@ -68,7 +70,11 @@ export const buildRedesignPlan = (args) => {
             paid: true,
             wouldBuy: `${args.pageCount} branch execute run(s) (scope page, --convert html --prototype),`
                 + ` capped at ${args.maxScreens} generated continuation screen(s) per captured page`,
-            typicalSeconds: branchEstimate.ceiling * args.pageCount,
+            // Per-page branch children use the same bounded outer concurrency as
+            // draft. Reporting serial wall time here made a three-page dry run look
+            // three times slower than the command can actually execute.
+            typicalSeconds: branchEstimate.ceiling
+                * Math.ceil(args.pageCount / BRANCH_PAGE_CONCURRENCY_DEFAULT),
             plannedCostUsd: usd(args.pageCount * (BRANCH_PLAN_CEILING_USD
                 + args.maxScreens * BRANCH_IMAGE_CEILING_USD
                 + (args.maxScreens + 1) * CONVERSION_PRICE_USD[args.conversionModel]

package/dist/redesign-plan.js.map

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

package/dist/redesign-record-validation.d.ts

@@ -0,0 +1,4 @@
+import type { RedesignRecord } from './redesign-workspace.js';
+/** Validate every field used to resume or attribute spend before projecting it. */
+export declare const assertValidRedesignRecord: (value: unknown) => asserts value is RedesignRecord;
+//# sourceMappingURL=redesign-record-validation.d.ts.map

package/dist/redesign-record-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redesign-record-validation.d.ts","sourceRoot":"","sources":["../src/redesign-record-validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAoL9D,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,EAAE,CACtC,KAAK,EAAE,OAAO,KACX,OAAO,CAAC,KAAK,IAAI,cAqCrB,CAAC"}