@12ui/design 0.2.57 → 0.2.59

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":"AAAA,OAAO,EACL,+BAA+B,EAC/B,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAI3B;;;;;;;;;;GAUG;AAEH,MAAM,yBAAyB,GAAG,MAAM,CAAC;AACzC,0EAA0E;AAC1E,MAAM,mCAAmC,GAAG,IAAI,CAAC;AACjD,iFAAiF;AACjF,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAC1C,MAAM,yBAAyB,GAAG,IAAI,CAAC;AACvC,0EAA0E;AAC1E,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AACrC,MAAM,oBAAoB,GAAoC;IAC5D,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,IAAI;IACd,GAAG,EAAE,GAAG;CACT,CAAC;AACF,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEzC,MAAM,GAAG,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAuBhE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAOjC,EAAgB,EAAE;IACjB,MAAM,cAAc,GAAG,wBAAwB,CAAC;QAC9C,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,+BAA+B;QAC5C,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IACH,MAAM,MAAM,GAAwB;QAClC;YACE,KAAK,EAAE,SAAS;YAChB,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,mBAAmB,IAAI,CAAC,SAAS,iDAAiD;YAC5F,cAAc,EAAE,IAAI,CAAC,SAAS,GAAG,CAAC;YAClC,cAAc,EAAE,CAAC;SAClB;QACD;YACE,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,0EAA0E;YACpF,cAAc,EAAE,wBAAwB,CAAC,qBAAqB;YAC9D,cAAc,EAAE,mCAAmC;SACpD;QACD;YACE,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,GAAG,IAAI,CAAC,cAAc,uEAAuE;YACvG,cAAc,EAAE,wBAAwB,CAAC,oBAAoB;YAC7D,cAAc,EAAE,GAAG,CACjB,yBAAyB;kBACvB,4BAA4B;kBAC5B,IAAI,CAAC,cAAc,GAAG,yBAAyB,CAClD;SACF;QACD;YACE,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,6DAA6D;YACvE,cAAc,EAAE,CAAC;YACjB,cAAc,EAAE,CAAC;SAClB;QACD;YACE,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,IAAI;YACV,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,kEAAkE;kBACzF,cAAc,IAAI,CAAC,UAAU,qDAAqD;YACtF,cAAc,EAAE,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS;YACvD,cAAc,EAAE,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,CACnC,uBAAuB;kBACrB,IAAI,CAAC,UAAU,GAAG,wBAAwB;kBAC1C,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,eAAe,CAAC;kBAClE,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,2BAA2B,CACtD,CAAC;SACH;QACD;YACE,KAAK,EAAE,QAAQ;YACf,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,gEAAgE,IAAI,CAAC,SAAS,EAAE;kBACtF,6BAA6B;YACjC,cAAc,EAAE,IAAI,CAAC,SAAS,GAAG,EAAE;YACnC,cAAc,EAAE,CAAC;SAClB;KACF,CAAC;IACF,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,MAAM;QACN,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC;QACrF,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;QAC1F,YAAY,EAAE,2DAA2D;KAC1E,CAAC;AACJ,CAAC,CAAC"}
+{"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"}

package/dist/redesign-record-validation.js

@@ -0,0 +1,210 @@
+import { isConversionModel } from './conversion-models.js';
+const invalid = (field) => {
+    throw new Error(`Invalid redesign record field: ${field}`);
+};
+const objectAt = (value, field) => {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        invalid(field);
+    return value;
+};
+const stringAt = (value, field) => {
+    if (typeof value !== 'string' || value.length === 0)
+        invalid(field);
+    return value;
+};
+const numberAt = (value, field, integer = false) => {
+    if (typeof value !== 'number' || !Number.isFinite(value) || (integer && !Number.isInteger(value))) {
+        invalid(field);
+    }
+    return value;
+};
+const booleanAt = (value, field) => {
+    if (typeof value !== 'boolean')
+        invalid(field);
+    return value;
+};
+const arrayAt = (value, field) => {
+    if (!Array.isArray(value))
+        invalid(field);
+    return value;
+};
+const stringArrayAt = (value, field) => (arrayAt(value, field).map((entry, index) => stringAt(entry, `${field}[${index}]`)));
+const optionalString = (record, field) => {
+    if (record[field] !== undefined)
+        stringAt(record[field], field);
+};
+const uniquePageIds = (entries, field, capturedIds) => {
+    const seen = new Set();
+    for (const [index, entry] of entries.entries()) {
+        const pageId = stringAt(entry.pageId, `${field}[${index}].pageId`);
+        if (seen.has(pageId))
+            invalid(`${field}[${index}].pageId (duplicate ${pageId})`);
+        if (!capturedIds.has(pageId))
+            invalid(`${field}[${index}].pageId (unknown ${pageId})`);
+        seen.add(pageId);
+    }
+};
+const validateCapture = (value) => {
+    const capture = objectAt(value, 'capture');
+    const pages = arrayAt(capture.pages, 'capture.pages').map((entry, index) => {
+        const page = objectAt(entry, `capture.pages[${index}]`);
+        stringAt(page.id, `capture.pages[${index}].id`);
+        stringAt(page.url, `capture.pages[${index}].url`);
+        stringAt(page.path, `capture.pages[${index}].path`);
+        stringAt(page.sha256, `capture.pages[${index}].sha256`);
+        numberAt(page.bytes, `capture.pages[${index}].bytes`, true);
+        numberAt(page.width, `capture.pages[${index}].width`, true);
+        numberAt(page.height, `capture.pages[${index}].height`, true);
+        return page;
+    });
+    const ids = pages.map((page) => page.id);
+    if (new Set(ids).size !== ids.length)
+        invalid('capture.pages[].id (duplicate)');
+    if (capture.discovery !== undefined) {
+        const discovery = objectAt(capture.discovery, 'capture.discovery');
+        numberAt(discovery.count, 'capture.discovery.count', true);
+        numberAt(discovery.cap, 'capture.discovery.cap', true);
+        stringAt(discovery.rootUrl, 'capture.discovery.rootUrl');
+        if (discovery.context !== 'public' && discovery.context !== 'authenticated') {
+            invalid('capture.discovery.context');
+        }
+    }
+    return pages;
+};
+const validatePlan = (value) => {
+    const plan = objectAt(value, 'plan');
+    stringAt(plan.concept, 'plan.concept');
+    stringAt(plan.corpusQuery, 'plan.corpusQuery');
+    stringAt(plan.effectIdentity, 'plan.effectIdentity');
+    booleanAt(plan.replayed, 'plan.replayed');
+    const retain = objectAt(plan.retain, 'plan.retain');
+    stringArrayAt(retain.include, 'plan.retain.include');
+    stringArrayAt(retain.exclude, 'plan.retain.exclude');
+    optionalString(retain, 'notes');
+    if (retain.source !== undefined && retain.source !== 'inspiration' && retain.source !== 'subject') {
+        invalid('plan.retain.source');
+    }
+    if (plan.degradation !== undefined) {
+        const degradation = objectAt(plan.degradation, 'plan.degradation');
+        stringArrayAt(degradation.reasons, 'plan.degradation.reasons');
+    }
+};
+const requireCapturedStage = (record, capturedPages, field) => {
+    if (record.capture === undefined || capturedPages.length === 0)
+        invalid(`${field} without captured pages`);
+    const capturedIds = new Set(capturedPages.map((page) => page.id));
+    return { capturedIds, primaryId: capturedPages[0].id };
+};
+const validateDraft = (record, capturedPages) => {
+    const draft = objectAt(record.draft, 'draft');
+    const runDir = stringAt(draft.runDir, 'draft.runDir');
+    const runId = stringAt(draft.runId, 'draft.runId');
+    const { capturedIds, primaryId } = requireCapturedStage(record, capturedPages, 'draft');
+    if (record.plan === undefined)
+        invalid('draft without plan');
+    if (draft.pages === undefined)
+        return;
+    const pages = arrayAt(draft.pages, 'draft.pages').map((entry, index) => {
+        const page = objectAt(entry, `draft.pages[${index}]`);
+        stringAt(page.runDir, `draft.pages[${index}].runDir`);
+        stringAt(page.runId, `draft.pages[${index}].runId`);
+        return page;
+    });
+    if (pages.length === 0)
+        invalid('draft.pages');
+    uniquePageIds(pages, 'draft.pages', capturedIds);
+    const primary = pages.find((page) => page.pageId === primaryId);
+    if (!primary || primary.runDir !== runDir || primary.runId !== runId) {
+        invalid('draft primary page does not match draft.runDir/runId');
+    }
+};
+const validatePick = (record, capturedPages) => {
+    const pick = objectAt(record.pick, 'pick');
+    const slot = stringAt(pick.slot, 'pick.slot');
+    const imagePath = stringAt(pick.imagePath, 'pick.imagePath');
+    const sha256 = stringAt(pick.sha256, 'pick.sha256');
+    const { capturedIds, primaryId } = requireCapturedStage(record, capturedPages, 'pick');
+    if (record.draft === undefined)
+        invalid('pick without draft');
+    if (pick.pages === undefined)
+        return;
+    const pages = arrayAt(pick.pages, 'pick.pages').map((entry, index) => {
+        const page = objectAt(entry, `pick.pages[${index}]`);
+        stringAt(page.slot, `pick.pages[${index}].slot`);
+        stringAt(page.imagePath, `pick.pages[${index}].imagePath`);
+        stringAt(page.sha256, `pick.pages[${index}].sha256`);
+        return page;
+    });
+    if (pages.length === 0)
+        invalid('pick.pages');
+    uniquePageIds(pages, 'pick.pages', capturedIds);
+    if (pages.some((page) => page.slot !== slot))
+        invalid('pick.pages[].slot');
+    const primary = pages.find((page) => page.pageId === primaryId);
+    if (!primary || primary.imagePath !== imagePath || primary.sha256 !== sha256) {
+        invalid('pick primary page does not match pick.imagePath/sha256');
+    }
+};
+const validatePageStage = (record, capturedPages, field) => {
+    const stage = objectAt(record[field], field);
+    const pages = arrayAt(stage.pages, `${field}.pages`).map((entry, index) => {
+        const page = objectAt(entry, `${field}.pages[${index}]`);
+        stringAt(page.branchDir, `${field}.pages[${index}].branchDir`);
+        if (field === 'branch') {
+            optionalString(page, 'runId');
+            stringAt(page.status, `${field}.pages[${index}].status`);
+            stringAt(page.completionPath, `${field}.pages[${index}].completionPath`);
+        }
+        else {
+            booleanAt(page.enabled, `${field}.pages[${index}].enabled`);
+        }
+        return page;
+    });
+    const { capturedIds } = requireCapturedStage(record, capturedPages, field);
+    uniquePageIds(pages, `${field}.pages`, capturedIds);
+};
+/** Validate every field used to resume or attribute spend before projecting it. */
+export const assertValidRedesignRecord = (value) => {
+    const record = objectAt(value, 'root');
+    if (record.version !== 1)
+        invalid('version');
+    stringAt(record.createdAt, 'createdAt');
+    if (record.redrawGeneration !== undefined) {
+        const redrawGeneration = numberAt(record.redrawGeneration, 'redrawGeneration', true);
+        if (redrawGeneration < 1)
+            invalid('redrawGeneration');
+    }
+    stringAt(record.runDir, 'runDir');
+    stringAt(record.url, 'url');
+    if (typeof record.direction !== 'string')
+        invalid('direction');
+    const requestedPages = numberAt(record.requestedPages, 'requestedPages', true);
+    if (requestedPages < 1)
+        invalid('requestedPages');
+    if (record.requestedCandidateCount !== undefined) {
+        numberAt(record.requestedCandidateCount, 'requestedCandidateCount', true);
+    }
+    if (record.requestedMaxScreens !== undefined) {
+        numberAt(record.requestedMaxScreens, 'requestedMaxScreens', true);
+    }
+    if (record.requestedConversionModel !== undefined
+        && !isConversionModel(record.requestedConversionModel)) {
+        invalid('requestedConversionModel');
+    }
+    const capturedPages = record.capture === undefined ? [] : validateCapture(record.capture);
+    if (record.plan !== undefined) {
+        requireCapturedStage(record, capturedPages, 'plan');
+        validatePlan(record.plan);
+    }
+    if (record.draft !== undefined)
+        validateDraft(record, capturedPages);
+    if (record.pick !== undefined)
+        validatePick(record, capturedPages);
+    if (record.branch !== undefined) {
+        validatePageStage(record, capturedPages, 'branch');
+    }
+    if (record.polish !== undefined) {
+        validatePageStage(record, capturedPages, 'polish');
+    }
+};
+//# sourceMappingURL=redesign-record-validation.js.map

package/dist/redesign-record-validation.js.map

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

package/dist/redesign-workspace.d.ts

@@ -1,3 +1,4 @@
+import { type AtomicFileReplaceDependencies } from './atomic-file-replace.js';
 import type { CreateRetainPolicy } from './branch-client.js';
 import type { ConversionModel } from './conversion-models.js';
 /**
@@ -40,10 +41,36 @@ export type RedesignCapturedPageRecord = {
     width: number;
     height: number;
 };
+export type RedesignCaptureDiscoveryRecord = {
+    /** Number actually found; `--pages` is an upper bound, never a fill target. */
+    count: number;
+    cap: number;
+    rootUrl: string;
+    context: 'public' | 'authenticated';
+};
+export type RedesignDraftPageRecord = {
+    pageId: string;
+    runDir: string;
+    runId: string;
+};
+export type RedesignDraftRecord = {
+    runDir: string;
+    runId: string;
+    /** One hosted draw per captured page, primary first. Absent on pre-per-page records. */
+    pages?: RedesignDraftPageRecord[];
+};
+export type RedesignPickPageRecord = {
+    pageId: string;
+    slot: string;
+    imagePath: string;
+    sha256: string;
+};
 export type RedesignPickRecord = {
     slot: string;
     imagePath: string;
     sha256: string;
+    /** One materialized candidate per captured page. Absent on pre-per-page records. */
+    pages?: RedesignPickPageRecord[];
 };
 /**
  * A metered hosted direction plan. This is intentionally distinct from the
@@ -63,6 +90,8 @@ export type RedesignDirectionPlanRecord = {
 export type RedesignBranchPageRecord = {
     pageId: string;
     branchDir: string;
+    /** The hosted branch run, needed to join this local run to the settled ledger. */
+    runId?: string;
     status: string;
     completionPath: string;
 };
@@ -79,21 +108,26 @@ export type RedesignPolishPageRecord = {
 export type RedesignRecord = {
     version: 1;
     createdAt: string;
+    /**
+     * Monotonic namespace for an explicit redraw. Absent is generation zero so
+     * records written before redraw namespaces keep their original identities.
+     */
+    redrawGeneration?: number;
     runDir: string;
     url: string;
     direction: string;
     requestedPages: number;
+    /** Hosted draft candidate count; retained so a later stage does not drift to a new default. */
+    requestedCandidateCount?: number;
     /** Maximum generated continuation screens for each captured page. */
     requestedMaxScreens?: number;
     requestedConversionModel?: ConversionModel;
     capture?: {
         pages: RedesignCapturedPageRecord[];
+        discovery?: RedesignCaptureDiscoveryRecord;
     };
     plan?: RedesignDirectionPlanRecord;
-    draft?: {
-        runDir: string;
-        runId: string;
-    };
+    draft?: RedesignDraftRecord;
     pick?: RedesignPickRecord;
     branch?: {
         pages: RedesignBranchPageRecord[];
@@ -102,14 +136,18 @@ export type RedesignRecord = {
         pages: RedesignPolishPageRecord[];
     };
 };
+export declare class InvalidRedesignRecordError extends Error {
+    constructor(file: string, cause: unknown);
+}
 export declare const readRedesignRecord: (file: string) => Promise<RedesignRecord | undefined>;
-export declare const writeRedesignRecord: (file: string, record: RedesignRecord) => Promise<void>;
+export declare const writeRedesignRecord: (file: string, record: RedesignRecord, dependencies?: AtomicFileReplaceDependencies) => Promise<void>;
 /** Read the record, or start a fresh one when this is the first stage to run. */
 export declare const loadOrStartRedesignRecord: (args: {
     paths: RedesignPaths;
     url: string;
     direction: string;
     requestedPages: number;
+    requestedCandidateCount?: number;
     requestedMaxScreens?: number;
     requestedConversionModel?: ConversionModel;
 }) => Promise<RedesignRecord>;