@12ui/design 0.2.13 → 0.2.14

package/dist/branch-page-conversion.js

@@ -0,0 +1,206 @@
+import { readFile } from 'node:fs/promises';
+import { branchPackageKey } from './branch-identity.js';
+import { normalizePageViewports, } from './branch-viewport-normalization.js';
+import { submitConversionPackage, } from './package-submission.js';
+export const WINNER_VIEWPORT_ID = 'winner';
+const readScreenBytes = async (screen) => (new Uint8Array(await readFile(screen.path)));
+const orderedViewports = (plan, page) => plan.screens
+    .filter((screen) => page.slots.includes(screen.slot))
+    .sort((left, right) => left.viewportOrdinal - right.viewportOrdinal)
+    .map((screen) => ({ slot: screen.slot, ordinal: screen.viewportOrdinal }));
+export const convertBranchPages = async (args) => {
+    const conversions = new Map();
+    for (const page of args.plan.pages) {
+        const planned = orderedViewports(args.plan, page);
+        const missing = planned.filter((viewport) => !args.screens.has(viewport.slot));
+        if (missing.length > 0) {
+            conversions.set(page.id, {
+                status: 'skipped',
+                reason: `Page ${page.id} is missing screen(s) ${missing.map((entry) => entry.slot).join(', ')},`
+                    + ' so its viewports do not stack into a whole page. The screens that did land are on'
+                    + ' disk; redraw the gap and re-run with --resume before converting this page.',
+            });
+            continue;
+        }
+        // Collect the page's pixels first, tagging which side declares the width.
+        const sources = [];
+        if (page.startsFromWinner) {
+            if (!args.winner) {
+                conversions.set(page.id, {
+                    status: 'skipped',
+                    reason: `Page ${page.id} starts from the approved screen, whose bytes are not available`
+                        + ' locally, so viewport 1 of the page is missing.',
+                });
+                continue;
+            }
+            const bytes = await readScreenBytes(args.winner);
+            sources.push({
+                ordinal: 1,
+                path: args.winner.path,
+                input: {
+                    id: WINNER_VIEWPORT_ID,
+                    bytes,
+                    mediaType: 'image/png',
+                    width: args.winner.width,
+                    height: args.winner.height,
+                    // The winner came from somewhere else; it is the side that moves.
+                    canonical: false,
+                },
+            });
+        }
+        for (const viewport of planned) {
+            const screen = args.screens.get(viewport.slot);
+            sources.push({
+                ordinal: viewport.ordinal,
+                path: screen.path,
+                input: {
+                    id: viewport.slot,
+                    bytes: await readScreenBytes(screen),
+                    mediaType: 'image/png',
+                    width: screen.width,
+                    height: screen.height,
+                    // Drawn by the server on the run's fixed canvas: this is the width.
+                    canonical: true,
+                },
+            });
+        }
+        let normalization;
+        try {
+            normalization = await normalizePageViewports(sources.map((entry) => entry.input));
+        }
+        catch (error) {
+            conversions.set(page.id, {
+                status: 'failed',
+                output: args.settings.output,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            continue;
+        }
+        const normalizedById = new Map(normalization.viewports.map((entry) => [entry.id, entry]));
+        const viewports = sources.map((entry) => {
+            const resolved = normalizedById.get(entry.input.id);
+            // A normalized winner is no longer the bytes any earlier conversion was
+            // admitted with, so the reuse claim would be false. Buy it instead of
+            // asserting a digest the server will disprove.
+            const reuse = entry.input.id === WINNER_VIEWPORT_ID
+                && args.settings.sourceConversionId
+                && !resolved.normalized;
+            return {
+                id: entry.input.id,
+                ordinal: entry.ordinal,
+                imagePath: entry.path,
+                bytes: resolved.bytes,
+                mediaType: resolved.mediaType,
+                ...(reuse ? { sourceConversionId: args.settings.sourceConversionId } : {}),
+            };
+        });
+        if (viewports.length === 0) {
+            conversions.set(page.id, {
+                status: 'skipped',
+                reason: `Page ${page.id} has no viewport to convert.`,
+            });
+            continue;
+        }
+        if (viewports.length === 1 && page.startsFromWinner) {
+            conversions.set(page.id, {
+                status: 'skipped',
+                reason: 'The approved screen already is the whole page — the server planned no'
+                    + ' continuations for it. Convert it on its own with'
+                    + ' `12ui convert <winner> --output layerdoc --export html`.',
+            });
+            continue;
+        }
+        const input = {
+            id: page.id,
+            ordinal: page.index,
+            kind: page.kind,
+            ...(page.title ? { title: page.title } : {}),
+            ...(page.purpose ? { purpose: page.purpose } : {}),
+            viewports,
+        };
+        // Keyed on the bytes actually submitted, so a retry after normalization
+        // replays the same package instead of buying the page again.
+        const idempotencyKey = branchPackageKey({
+            runId: args.plan.runId,
+            pageIndex: page.index,
+            viewportSha256s: viewports.map((viewport) => normalizedById.get(viewport.id).sha256),
+            output: args.settings.output,
+            ...(args.settings.model ? { model: args.settings.model } : {}),
+            ...(args.settings.responsiveQuality
+                ? { responsiveQuality: args.settings.responsiveQuality }
+                : {}),
+        });
+        const normalizedRecord = normalization.viewports
+            .filter((viewport) => viewport.normalized)
+            .map((viewport) => ({
+            id: viewport.id,
+            fromWidth: viewport.original.width,
+            fromHeight: viewport.original.height,
+            fromSha256: viewport.original.sha256,
+            toWidth: viewport.width,
+            toHeight: viewport.height,
+            toSha256: viewport.sha256,
+        }));
+        const normalizationRecord = {
+            ...(normalization.canonicalWidth === null
+                ? {}
+                : { canonicalWidth: normalization.canonicalWidth }),
+            ...(normalizedRecord.length > 0 ? { normalizedViewports: normalizedRecord } : {}),
+        };
+        try {
+            const result = await submitConversionPackage({
+                client: args.client,
+                outDir: args.pagesDirectory,
+                submission: {
+                    output: args.settings.output,
+                    ...(args.settings.model ? { model: args.settings.model } : {}),
+                    ...(args.settings.responsiveQuality
+                        ? { responsiveQuality: args.settings.responsiveQuality }
+                        : {}),
+                    pages: [input],
+                    idempotencyKey,
+                },
+                ...(args.timeoutMs === undefined ? {} : { timeoutMs: args.timeoutMs }),
+                ...(args.onProgress
+                    ? { onProgress: (event) => args.onProgress(page.id, event) }
+                    : {}),
+                ...(args.signal ? { signal: args.signal } : {}),
+            });
+            const converted = result.pages[0];
+            conversions.set(page.id, converted?.status === 'succeeded'
+                ? {
+                    status: 'succeeded',
+                    packageId: result.packageId,
+                    idempotencyKey,
+                    output: args.settings.output,
+                    ...normalizationRecord,
+                    ...(converted.conversionId ? { conversionId: converted.conversionId } : {}),
+                    ...(converted.outFile ? { outFile: converted.outFile } : {}),
+                    ...(converted.sha256 ? { sha256: converted.sha256 } : {}),
+                    ...(converted.bytes === undefined ? {} : { bytes: converted.bytes }),
+                }
+                : {
+                    status: 'failed',
+                    packageId: result.packageId,
+                    idempotencyKey,
+                    output: args.settings.output,
+                    ...normalizationRecord,
+                    error: converted?.error ?? `Package ${result.packageId} produced no page.`,
+                });
+        }
+        catch (error) {
+            // The reconciliation is a fact about what was submitted, so it belongs in
+            // the record whether or not the submission was accepted — a failed page
+            // is exactly when an operator needs to know what the bytes were.
+            conversions.set(page.id, {
+                status: 'failed',
+                idempotencyKey,
+                output: args.settings.output,
+                ...normalizationRecord,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return conversions;
+};
+//# sourceMappingURL=branch-page-conversion.js.map

package/dist/branch-page-conversion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-page-conversion.js","sourceRoot":"","sources":["../src/branch-page-conversion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAI5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAKxD,OAAO,EACL,sBAAsB,GAGvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,uBAAuB,GAIxB,MAAM,yBAAyB,CAAC;AAqBjC,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AAI3C,MAAM,eAAe,GAAG,KAAK,EAAE,MAA8B,EAAuB,EAAE,CAAC,CACrF,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAC5C,CAAC;AAEF,MAAM,gBAAgB,GAAG,CACvB,IAA0B,EAC1B,IAA2C,EACN,EAAE,CAAC,IAAI,CAAC,OAAO;KACnD,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;KACpD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;KACnE,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,IAUxC,EAAwC,EAAE;IACzC,MAAM,WAAW,GAAG,IAAI,GAAG,EAA0B,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;gBACvB,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,QAAQ,IAAI,CAAC,EAAE,yBAAyB,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;sBAC5F,oFAAoF;sBACpF,6EAA6E;aAClF,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,0EAA0E;QAC1E,MAAM,OAAO,GAA8D,EAAE,CAAC;QAC9E,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;oBACvB,MAAM,EAAE,SAAS;oBACjB,MAAM,EAAE,QAAQ,IAAI,CAAC,EAAE,iEAAiE;0BACpF,iDAAiD;iBACtD,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACjD,OAAO,CAAC,IAAI,CAAC;gBACX,OAAO,EAAE,CAAC;gBACV,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;gBACtB,KAAK,EAAE;oBACL,EAAE,EAAE,kBAAkB;oBACtB,KAAK;oBACL,SAAS,EAAE,WAAW;oBACtB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;oBACxB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;oBAC1B,kEAAkE;oBAClE,SAAS,EAAE,KAAK;iBACjB;aACF,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAE,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC;gBACX,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE;oBACL,EAAE,EAAE,QAAQ,CAAC,IAAI;oBACjB,KAAK,EAAE,MAAM,eAAe,CAAC,MAAM,CAAC;oBACpC,SAAS,EAAE,WAAW;oBACtB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,oEAAoE;oBACpE,SAAS,EAAE,IAAI;iBAChB;aACF,CAAC,CAAC;QACL,CAAC;QAED,IAAI,aAAgC,CAAC;QACrC,IAAI,CAAC;YACH,aAAa,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;gBACvB,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;gBAC5B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1F,MAAM,SAAS,GAA2B,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9D,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAE,CAAC;YACrD,wEAAwE;YACxE,sEAAsE;YACtE,+CAA+C;YAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,kBAAkB;mBAC9C,IAAI,CAAC,QAAQ,CAAC,kBAAkB;mBAChC,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC1B,OAAO;gBACL,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,SAAS,EAAE,KAAK,CAAC,IAAI;gBACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,kBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;gBACvB,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,QAAQ,IAAI,CAAC,EAAE,8BAA8B;aACtD,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACpD,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;gBACvB,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,uEAAuE;sBAC3E,mDAAmD;sBACnD,2DAA2D;aAChE,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAqB;YAC9B,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,OAAO,EAAE,IAAI,CAAC,KAAK;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5C,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,SAAS;SACV,CAAC;QACF,wEAAwE;QACxE,6DAA6D;QAC7D,MAAM,cAAc,GAAG,gBAAgB,CAAC;YACtC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;YACtB,SAAS,EAAE,IAAI,CAAC,KAAK;YACrB,eAAe,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAE,CAAC,MAAM,CAAC;YACrF,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;YAC5B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB;gBACjC,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE;gBACxD,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;QACH,MAAM,gBAAgB,GAAG,aAAa,CAAC,SAAS;aAC7C,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;aACzC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAClB,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,SAAS,EAAE,QAAQ,CAAC,QAAS,CAAC,KAAK;YACnC,UAAU,EAAE,QAAQ,CAAC,QAAS,CAAC,MAAM;YACrC,UAAU,EAAE,QAAQ,CAAC,QAAS,CAAC,MAAM;YACrC,OAAO,EAAE,QAAQ,CAAC,KAAK;YACvB,QAAQ,EAAE,QAAQ,CAAC,MAAM;YACzB,QAAQ,EAAE,QAAQ,CAAC,MAAM;SAC1B,CAAC,CAAC,CAAC;QACN,MAAM,mBAAmB,GAAG;YAC1B,GAAG,CAAC,aAAa,CAAC,cAAc,KAAK,IAAI;gBACvC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,cAAc,EAAE,aAAa,CAAC,cAAc,EAAE,CAAC;YACrD,GAAG,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClF,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC;gBAC3C,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,cAAc;gBAC3B,UAAU,EAAE;oBACV,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;oBAC5B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC9D,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB;wBACjC,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAAC,iBAAiB,EAAE;wBACxD,CAAC,CAAC,EAAE,CAAC;oBACP,KAAK,EAAE,CAAC,KAAK,CAAC;oBACd,cAAc;iBACf;gBACD,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACtE,GAAG,CAAC,IAAI,CAAC,UAAU;oBACjB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,KAA2B,EAAE,EAAE,CAAC,IAAI,CAAC,UAAW,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE;oBACnF,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAChD,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAClC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,WAAW;gBACxD,CAAC,CAAC;oBACA,MAAM,EAAE,WAAW;oBACnB,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,cAAc;oBACd,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;oBAC5B,GAAG,mBAAmB;oBACtB,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3E,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5D,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzD,GAAG,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC;iBACrE;gBACD,CAAC,CAAC;oBACA,MAAM,EAAE,QAAQ;oBAChB,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,cAAc;oBACd,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;oBAC5B,GAAG,mBAAmB;oBACtB,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI,WAAW,MAAM,CAAC,SAAS,oBAAoB;iBAC3E,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0EAA0E;YAC1E,wEAAwE;YACxE,iEAAiE;YACjE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;gBACvB,MAAM,EAAE,QAAQ;gBAChB,cAAc;gBACd,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;gBAC5B,GAAG,mBAAmB;gBACtB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC"}

package/dist/branch-plan.d.ts

@@ -0,0 +1,63 @@
+import type { BranchRunEnvelope, BranchScreenStatus } from './branch-client.js';
+import type { BranchScope } from './branch-identity.js';
+/**
+ * Plan normalisation. The wire envelope keeps ordering and per-screen facts in
+ * two different places — `plan.pages[].slots` and `candidates[]` — so this is
+ * the one module that joins them back into the page/viewport structure the
+ * scheduler, the downloads, and the package manifests all read.
+ *
+ * The approved winner is NOT a slot. The server plans continuations of the
+ * source page starting at `viewportOrdinal` 2; ordinal 1 of that page is the
+ * image the run branched from. Additional pages start at ordinal 1 because
+ * every one of their viewports is generated.
+ */
+export type BranchPlannedScreen = {
+    slot: string;
+    pageIndex: number;
+    viewportOrdinal: number;
+    status: BranchScreenStatus;
+    direction: string;
+    header: boolean | null;
+    footer: boolean | null;
+    pageEndsHere: boolean;
+    dependsOnSlot: string | null;
+    width: number;
+    height: number;
+    content?: string;
+    error?: {
+        code: string;
+        message: string;
+    };
+};
+export type BranchPlannedPage = {
+    index: number;
+    id: string;
+    kind: 'source' | 'additional';
+    title: string;
+    pageType: string;
+    surfaceType: string;
+    purpose: string;
+    /** True when viewport 1 of this page is the approved winner, not a slot. */
+    startsFromWinner: boolean;
+    slots: string[];
+};
+export type BranchNormalizedPlan = {
+    runId: string;
+    concept: string;
+    aspect: string;
+    scope: BranchScope;
+    sitePurpose: string;
+    statusUpdate: string;
+    approvedScreenSummary: string;
+    pages: BranchPlannedPage[];
+    screens: BranchPlannedScreen[];
+};
+/** Stable, filesystem-safe, and self-describing: `p0-pricing`, `p2`. */
+export declare const branchPageId: (index: number, title: string) => string;
+export declare const normalizeBranchPlan: (envelope: BranchRunEnvelope, options: {
+    scope: BranchScope;
+    maxScreens?: number;
+}) => BranchNormalizedPlan;
+/** Refresh statuses from a later envelope without re-deriving the structure. */
+export declare const applyBranchEnvelope: (plan: BranchNormalizedPlan, envelope: BranchRunEnvelope) => BranchNormalizedPlan;
+//# sourceMappingURL=branch-plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"branch-plan.d.ts","sourceRoot":"","sources":["../src/branch-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAEjB,kBAAkB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC,CAAC;AASF,wEAAwE;AACxE,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,EAAE,OAAO,MAAM,KAAG,MAQ3D,CAAC;AAqBF,eAAO,MAAM,mBAAmB,GAC9B,UAAU,iBAAiB,EAC3B,SAAS;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,KACnD,oBA0DF,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,GAC9B,MAAM,oBAAoB,EAC1B,UAAU,iBAAiB,KAC1B,oBAWF,CAAC"}

package/dist/branch-plan.js

@@ -0,0 +1,95 @@
+const PAGE_TITLE_LIMIT = 200;
+const PAGE_PURPOSE_LIMIT = 1_000;
+const clamp = (value, limit) => (value.length <= limit ? value : `${value.slice(0, limit - 1)}…`);
+/** Stable, filesystem-safe, and self-describing: `p0-pricing`, `p2`. */
+export const branchPageId = (index, title) => {
+    const slug = title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/gu, '-')
+        .replace(/^-+|-+$/gu, '')
+        .slice(0, 40)
+        .replace(/-+$/u, '');
+    return slug ? `p${index}-${slug}` : `p${index}`;
+};
+const screenFor = (candidate) => {
+    if (candidate.pageIndex === undefined || candidate.viewportOrdinal === undefined)
+        return null;
+    return {
+        slot: candidate.slot,
+        pageIndex: candidate.pageIndex,
+        viewportOrdinal: candidate.viewportOrdinal,
+        status: candidate.status,
+        direction: candidate.direction,
+        header: candidate.header ?? null,
+        footer: candidate.footer ?? null,
+        pageEndsHere: candidate.pageEndsHere ?? false,
+        dependsOnSlot: candidate.dependsOnSlot ?? null,
+        width: candidate.width,
+        height: candidate.height,
+        ...(candidate.content ? { content: candidate.content } : {}),
+        ...(candidate.error ? { error: candidate.error } : {}),
+    };
+};
+export const normalizeBranchPlan = (envelope, options) => {
+    const plan = envelope.plan;
+    if (!plan || !Array.isArray(plan.pages)) {
+        throw new Error(`Run ${envelope.id} carries no build plan. Only a run started with source "build" can be`
+            + ' branched.');
+    }
+    const bySlot = new Map(envelope.candidates.map((candidate) => [candidate.slot, candidate]));
+    // Plan order is page order then viewport order, which is also slot order.
+    // Everything downstream — the footer seed, the dependency chains, the
+    // `--max-screens` trim — depends on keeping exactly that sequence.
+    const orderedSlots = plan.pages.flatMap((page) => ((page.slots ?? []).filter((slot) => bySlot.has(slot))));
+    const scopedPages = options.scope === 'page'
+        ? plan.pages.filter((page) => page.kind === 'source')
+        : plan.pages;
+    const scopedSlots = new Set(scopedPages.flatMap((page) => page.slots ?? []));
+    const trimmed = options.maxScreens === undefined
+        ? null
+        : new Set(orderedSlots.filter((slot) => scopedSlots.has(slot)).slice(0, options.maxScreens));
+    const keeps = (slot) => (scopedSlots.has(slot) && (trimmed === null || trimmed.has(slot)));
+    const pages = scopedPages.map((page) => ({
+        index: page.index,
+        id: branchPageId(page.index, page.title ?? ''),
+        kind: page.kind,
+        title: clamp(page.title ?? `Page ${page.index}`, PAGE_TITLE_LIMIT),
+        pageType: page.pageType ?? 'other',
+        surfaceType: page.surfaceType ?? 'web_page',
+        purpose: clamp(page.purpose ?? '', PAGE_PURPOSE_LIMIT),
+        startsFromWinner: page.kind === 'source',
+        slots: (page.slots ?? []).filter(keeps),
+    }));
+    const screens = orderedSlots
+        .filter(keeps)
+        .flatMap((slot) => {
+        const screen = screenFor(bySlot.get(slot));
+        return screen ? [screen] : [];
+    });
+    return {
+        runId: envelope.id,
+        concept: envelope.concept,
+        aspect: envelope.aspect,
+        scope: options.scope,
+        sitePurpose: plan.sitePurpose ?? '',
+        statusUpdate: plan.statusUpdate ?? '',
+        approvedScreenSummary: plan.approvedScreenSummary ?? '',
+        pages,
+        screens,
+    };
+};
+/** Refresh statuses from a later envelope without re-deriving the structure. */
+export const applyBranchEnvelope = (plan, envelope) => {
+    const bySlot = new Map(envelope.candidates.map((candidate) => [candidate.slot, candidate]));
+    return {
+        ...plan,
+        screens: plan.screens.map((screen) => {
+            const candidate = bySlot.get(screen.slot);
+            if (!candidate)
+                return screen;
+            const next = screenFor(candidate);
+            return next ? { ...screen, ...next } : screen;
+        }),
+    };
+};
+//# sourceMappingURL=branch-plan.js.map

package/dist/branch-plan.js.map

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

package/dist/branch-progress.d.ts

@@ -0,0 +1,75 @@
+import type { BranchNormalizedPlan } from './branch-plan.js';
+import type { BranchCompletion } from './branch-run-record.js';
+/**
+ * The motion surface. A long command that answers a poll with bare absence is
+ * the measured trigger for a caller deciding the process stalled and improvising
+ * around it, so every observation of a branch run — the command's own streamed
+ * lines and `12ui branch status` from another session — reports what changed,
+ * how long each screen has been running against its typical duration, and what
+ * to do next.
+ */
+export declare const BRANCH_PROGRESS_FILENAME = "branch.progress.json";
+export type BranchProgressPhase = 'claiming' | 'dispatching' | 'downloading' | 'converting' | 'terminal';
+export type BranchProgressScreen = {
+    slot: string;
+    status: 'pending' | 'dispatched' | 'succeeded' | 'failed' | 'blocked';
+    pageIndex: number;
+    viewportOrdinal: number;
+    dispatchedAt?: string;
+    waitingOn?: string;
+};
+export type BranchProgressRecord = {
+    version: 1;
+    runId: string;
+    phase: BranchProgressPhase;
+    startedAt: string;
+    updatedAt: string;
+    screens: BranchProgressScreen[];
+};
+export declare const branchProgressPath: (outDir: string) => string;
+export declare const writeBranchProgress: (file: string, record: BranchProgressRecord) => Promise<void>;
+export declare const readBranchProgress: (file: string) => Promise<BranchProgressRecord | undefined>;
+export declare const branchProgressScreens: (plan: BranchNormalizedPlan, dispatchedAt: Readonly<Record<string, string>>) => BranchProgressScreen[];
+export type BranchStatusCounts = {
+    total: number;
+    complete: number;
+    generating: number;
+    waiting: number;
+    blocked: number;
+    failed: number;
+};
+export type BranchStatusReport = {
+    outDir: string;
+    runId?: string;
+    phase: BranchProgressPhase;
+    complete: boolean;
+    counts: BranchStatusCounts;
+    screens: BranchProgressScreen[];
+    /** Always populated: what is moving, and how long it has been moving. */
+    narrative: string;
+    /** Present only while work remains. A finished run has no next action. */
+    nextAction?: string;
+    startedAt?: string;
+    updatedAt?: string;
+    elapsedSeconds?: number;
+    completionPath?: string;
+    planPath?: string;
+    pages?: BranchCompletion['pages'];
+};
+/**
+ * One line of motion plus, while anything remains, one line of instruction.
+ * A terminal report carries neither: there is nothing in flight to narrate and
+ * nothing left to check.
+ */
+export declare const summarizeBranchProgress: (args: {
+    outDir: string;
+    runId?: string;
+    phase: BranchProgressPhase;
+    screens: readonly BranchProgressScreen[];
+    startedAt?: string;
+    updatedAt?: string;
+    completion?: BranchCompletion;
+    statusCommand?: string;
+    now?: number;
+}) => BranchStatusReport;
+//# sourceMappingURL=branch-progress.d.ts.map

package/dist/branch-progress.d.ts.map

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

package/dist/branch-progress.js

@@ -0,0 +1,159 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { OPERATION_DURATION_HINTS, elapsedAgainstTypical, formatDuration, narrateCounts, nextActionLine, secondsSince, } from './cli-progress.js';
+import { branchBlockedSlots } from './branch-schedule.js';
+/**
+ * The motion surface. A long command that answers a poll with bare absence is
+ * the measured trigger for a caller deciding the process stalled and improvising
+ * around it, so every observation of a branch run — the command's own streamed
+ * lines and `12ui branch status` from another session — reports what changed,
+ * how long each screen has been running against its typical duration, and what
+ * to do next.
+ */
+export const BRANCH_PROGRESS_FILENAME = 'branch.progress.json';
+export const branchProgressPath = (outDir) => (path.join(outDir, BRANCH_PROGRESS_FILENAME));
+export const writeBranchProgress = async (file, record) => {
+    await mkdir(path.dirname(file), { recursive: true });
+    const temporary = `${file}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(temporary, `${JSON.stringify(record, null, 2)}\n`, {
+            encoding: 'utf8',
+            flag: 'wx',
+            mode: 0o600,
+        });
+        await rename(temporary, file);
+    }
+    finally {
+        await rm(temporary, { force: true });
+    }
+};
+export const readBranchProgress = async (file) => {
+    try {
+        return JSON.parse(await readFile(file, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+};
+export const branchProgressScreens = (plan, dispatchedAt) => {
+    const blocked = new Map(branchBlockedSlots(plan.screens.map((screen) => ({
+        slot: screen.slot,
+        status: screen.status,
+        footer: screen.footer,
+        dependsOnSlot: screen.dependsOnSlot,
+    }))).map((entry) => [entry.slot, entry]));
+    return plan.screens.map((screen) => {
+        const block = blocked.get(screen.slot);
+        return {
+            slot: screen.slot,
+            status: block ? 'blocked' : screen.status,
+            pageIndex: screen.pageIndex,
+            viewportOrdinal: screen.viewportOrdinal,
+            ...(dispatchedAt[screen.slot] ? { dispatchedAt: dispatchedAt[screen.slot] } : {}),
+            ...(block
+                ? { waitingOn: block.waitingOn }
+                : screen.status === 'pending' && screen.dependsOnSlot
+                    ? { waitingOn: screen.dependsOnSlot }
+                    : {}),
+        };
+    });
+};
+const countScreens = (screens) => ({
+    total: screens.length,
+    complete: screens.filter((screen) => screen.status === 'succeeded').length,
+    generating: screens.filter((screen) => screen.status === 'dispatched').length,
+    waiting: screens.filter((screen) => screen.status === 'pending').length,
+    blocked: screens.filter((screen) => screen.status === 'blocked').length,
+    failed: screens.filter((screen) => screen.status === 'failed').length,
+});
+const generatingDetail = (screens, now) => {
+    const running = screens
+        .filter((screen) => screen.status === 'dispatched')
+        .map((screen) => secondsSince(screen.dispatchedAt, now))
+        .filter((seconds) => seconds !== undefined);
+    if (running.length === 0)
+        return undefined;
+    return elapsedAgainstTypical(Math.max(...running), OPERATION_DURATION_HINTS.branchScreen);
+};
+/**
+ * One line of motion plus, while anything remains, one line of instruction.
+ * A terminal report carries neither: there is nothing in flight to narrate and
+ * nothing left to check.
+ */
+export const summarizeBranchProgress = (args) => {
+    const now = args.now ?? Date.now();
+    const counts = countScreens(args.screens);
+    const complete = args.phase === 'terminal' || Boolean(args.completion);
+    const elapsedSeconds = secondsSince(args.startedAt, now);
+    const statusCommand = args.statusCommand ?? `12ui branch status --out-dir ${args.outDir}`;
+    if (complete) {
+        const settled = args.completion;
+        const narrative = settled
+            ? `Branch run ${settled.runId} finished ${settled.status}:`
+                + ` ${settled.succeededCount} of ${settled.screenCount} screen(s) generated,`
+                + ` ${settled.failedCount} failed, ${settled.blockedCount} blocked.`
+                + ` Screens and pages are on disk under ${settled.outDir}.`
+            : `Branch run ${args.runId ?? '(unclaimed)'} is finished; read the completion sentinel.`;
+        return {
+            outDir: args.outDir,
+            ...(args.runId ? { runId: args.runId } : {}),
+            phase: 'terminal',
+            complete: true,
+            counts,
+            screens: [...args.screens],
+            narrative,
+            ...(args.startedAt ? { startedAt: args.startedAt } : {}),
+            ...(args.updatedAt ? { updatedAt: args.updatedAt } : {}),
+            ...(elapsedSeconds === undefined ? {} : { elapsedSeconds: Math.round(elapsedSeconds) }),
+            ...(settled ? { pages: settled.pages } : {}),
+        };
+    }
+    const phaseNarrative = args.phase === 'claiming'
+        ? `Planning the screens (${elapsedAgainstTypical(elapsedSeconds ?? 0, OPERATION_DURATION_HINTS.branchClaim)}); no image bought yet.`
+        : args.phase === 'downloading'
+            ? `Screens settled; downloading ${counts.complete} image(s).`
+            : args.phase === 'converting'
+                ? `Screens on disk; converting each whole page as one package (${formatDuration(OPERATION_DURATION_HINTS.package)} typical per page).`
+                : `screens: ${narrateCounts([
+                    { label: 'complete', count: counts.complete },
+                    {
+                        label: 'generating',
+                        count: counts.generating,
+                        ...(generatingDetail(args.screens, now) ? { detail: generatingDetail(args.screens, now) } : {}),
+                    },
+                    { label: 'waiting on dependencies', count: counts.waiting },
+                    { label: 'blocked', count: counts.blocked },
+                    { label: 'failed', count: counts.failed },
+                ])}`;
+    const typicalSeconds = args.phase === 'claiming'
+        ? OPERATION_DURATION_HINTS.branchClaim
+        : args.phase === 'converting'
+            ? OPERATION_DURATION_HINTS.package
+            : OPERATION_DURATION_HINTS.branchScreen;
+    return {
+        outDir: args.outDir,
+        ...(args.runId ? { runId: args.runId } : {}),
+        phase: args.phase,
+        complete: false,
+        counts,
+        screens: [...args.screens],
+        narrative: elapsedSeconds === undefined
+            ? phaseNarrative
+            : `${phaseNarrative} — ${formatDuration(elapsedSeconds)} into the run`,
+        nextAction: nextActionLine({
+            what: args.phase === 'converting'
+                ? 'A page conversion'
+                : args.phase === 'claiming'
+                    ? 'The plan call'
+                    : 'Each screen',
+            typicalSeconds,
+            statusCommand,
+            waitHint: 'or leave `12ui branch execute` running, which blocks until the whole run finishes',
+        }),
+        ...(args.startedAt ? { startedAt: args.startedAt } : {}),
+        ...(args.updatedAt ? { updatedAt: args.updatedAt } : {}),
+        ...(elapsedSeconds === undefined ? {} : { elapsedSeconds: Math.round(elapsedSeconds) }),
+    };
+};
+//# sourceMappingURL=branch-progress.js.map

package/dist/branch-progress.js.map

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