@12ui/design 0.2.15 → 0.2.17

package/dist/branch-run-record.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"branch-status.d.ts","sourceRoot":"","sources":["../src/branch-status.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAmC9B,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB,GACjC,SAAS,SAAS,oBAAoB,EAAE,EACxC,UAAU,iBAAiB,KAC1B,oBAAoB,EAkBtB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,MAAM;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,KAAG,OAAO,CAAC,kBAAkB,CAyE7B,CAAC"}
+{"version":3,"file":"branch-status.d.ts","sourceRoot":"","sources":["../src/branch-status.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAmC9B,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB,GACjC,SAAS,SAAS,oBAAoB,EAAE,EACxC,UAAU,iBAAiB,KAC1B,oBAAoB,EAkBtB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,MAAM;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,KAAG,OAAO,CAAC,kBAAkB,CA0E7B,CAAC"}

package/dist/branch-status.js

@@ -1,5 +1,6 @@
 import path from 'node:path';
 import { branchBlockedSlots } from './branch-schedule.js';
+import { CliRefusal } from './cli-refusal.js';
 import { branchProgressPath, readBranchProgress, summarizeBranchProgress, } from './branch-progress.js';
 import { branchAttemptPath, branchCompletionPath, branchPlanPath, readBranchAttempt, readBranchCompletion, } from './branch-run-record.js';
 /**
@@ -53,11 +54,11 @@ export const readBranchStatus = async (args) => {
     if (!attempt && !completion && !progress) {
         // Never started is not a failure and not a stall. Name the command that
         // starts it rather than reporting an absence the caller has to interpret.
-        throw new Error(`This branch run has never been started — there is nothing to report, and nothing has`
+        throw new CliRefusal(`This branch run has never been started — there is nothing to report, and nothing has`
             + ` failed. ${outDir} holds no branch attempt, progress, or completion record.`
             + ' Start one with `12ui branch execute --winner-run <crt-id> --winner-slot <slot>'
             + ' --concept <text> --scope page|site --out-dir <directory>`, which blocks for the whole'
-            + ' run and streams progress.');
+            + ' run and streams progress.', 'branch_never_started');
     }
     if (completion) {
         return {

package/dist/branch-status.js.map

@@ -1 +1 @@
-{"version":3,"file":"branch-status.js","sourceRoot":"","sources":["../src/branch-status.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"branch-status.js","sourceRoot":"","sources":["../src/branch-status.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GAIxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AAEH,MAAM,QAAQ,GAAG,CACf,aAAiC,EACjC,aAA8C,EACzB,EAAE;IACvB,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IACxC,QAAQ,aAAa,EAAE,CAAC;QACtB,KAAK,aAAa,CAAC,CAAC,OAAO,aAAa,CAAC;QACzC,KAAK,YAAY,CAAC,CAAC,OAAO,YAAY,CAAC;QACvC,KAAK,aAAa,CAAC,CAAC,OAAO,aAAa,CAAC;QACzC,KAAK,WAAW,CAAC;QACjB,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,UAAU,CAAC;QACpB,OAAO,CAAC,CAAC,OAAO,UAAU,CAAC;IAC7B,CAAC;AACH,CAAC,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAAwC,EACxC,QAA2B,EACH,EAAE;IAC1B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1F,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACjF,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,IAAI;QAChC,aAAa,EAAE,SAAS,CAAC,aAAa,IAAI,IAAI;KAC/C,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS;YAAE,OAAO,MAAM,CAAC;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO;YACL,GAAG,MAAM;YACT,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,SAAkB,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM;YACrD,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,IAKtC,EAA+B,EAAE;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,IAAI,CAAC,QAAQ,EAAE,CAAC;QACzC,wEAAwE;QACxE,0EAA0E;QAC1E,MAAM,IAAI,UAAU,CAClB,sFAAsF;cACpF,YAAY,MAAM,2DAA2D;cAC7E,iFAAiF;cACjF,wFAAwF;cACxF,4BAA4B,EAC9B,sBAAsB,CACvB,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,OAAO;YACL,GAAG,uBAAuB,CAAC;gBACzB,MAAM;gBACN,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxD,KAAK,EAAE,UAAU;gBACjB,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,IAAI,EAAE,CAAC;gBAClC,SAAS,EAAE,UAAU,CAAC,SAAS;gBAC/B,SAAS,EAAE,UAAU,CAAC,WAAW;gBACjC,UAAU;gBACV,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE;aAC5B,CAAC;YACF,cAAc,EAAE,oBAAoB,CAAC,MAAM,CAAC;YAC5C,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC;SACjC,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,EAAE,KAAK,IAAI,OAAO,EAAE,KAAK,CAAC;IAChD,IAAI,OAAO,GAAG,QAAQ,EAAE,OAAO,IAAI,EAAE,CAAC;IACtC,IAAI,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC;oBAC1B,CAAC,CAAC,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC;oBAC3C,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;wBACxC,IAAI,EAAE,SAAS,CAAC,IAAI;wBACpB,MAAM,EAAE,SAAS,CAAC,MAAM;wBACxB,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,CAAC;wBACnC,eAAe,EAAE,SAAS,CAAC,eAAe,IAAI,CAAC;wBAC/C,GAAG,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC3E,CAAC,CAAC,CAAC;YACR,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;YACnE,kDAAkD;QACpD,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG,uBAAuB,CAAC;YACzB,MAAM;YACN,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC;YACjD,OAAO;YACP,uEAAuE;YACvE,yDAAyD;YACzD,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,QAAQ,EAAE,SAAS,IAAI,OAAO,EAAE,SAAS;gBAC3C,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,OAAQ,CAAC,SAAS,EAAE;gBAC1D,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE;SAC5B,CAAC;QACF,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC;KACjC,CAAC;AACJ,CAAC,CAAC"}

package/dist/branch-winner.d.ts

@@ -0,0 +1,31 @@
+import type { BranchWinnerInput } from './branch-execution-types.js';
+import { type CliFlags } from './cli-arguments.js';
+export declare const imageWinner: (imagePath: string, label?: string) => Promise<BranchWinnerInput>;
+/**
+ * The winner the run already recorded. Restating a decision is how the two
+ * records drift apart, so a run directory that holds a selection needs no flag.
+ */
+export declare const winnerFromSelection: (runDir: string) => Promise<BranchWinnerInput | null>;
+/**
+ * Both accepted forms and a command the caller can paste. A refusal that only
+ * says a starting design is required costs another round trip to find out how
+ * to give one, and this one already cost a paid run on 2026-08-12.
+ */
+export declare const missingWinnerMessage: (args: {
+    /** The draft run directory this command addressed, when it addressed one. */
+    runDir: string | null;
+    outDir: string;
+}) => string;
+export type BranchWinnerFlags = {
+    flags: CliFlags;
+    /** The draft run directory addressed, when the caller named one. */
+    runDir: string | null;
+    outDir: string;
+};
+/**
+ * Resolve the starting design, or refuse with everything needed to fix it.
+ * Reaches the network never and the filesystem only for a design it was told to
+ * read, so it is safe to run before any client is built.
+ */
+export declare const resolveBranchWinner: (args: BranchWinnerFlags) => Promise<BranchWinnerInput>;
+//# sourceMappingURL=branch-winner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"branch-winner.d.ts","sourceRoot":"","sources":["../src/branch-winner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AA4B/D,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,cAAoB,KACnB,OAAO,CAAC,iBAAiB,CAc3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAM1F,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM;IACzC,6EAA6E;IAC7E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,KAAG,MAmBH,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,QAAQ,CAAC;IAChB,oEAAoE;IACpE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAU,MAAM,iBAAiB,KAAG,OAAO,CAAC,iBAAiB,CAmD5F,CAAC"}

package/dist/branch-winner.js

@@ -0,0 +1,121 @@
+import { createHash } from 'node:crypto';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { stringFlag } from './cli-arguments.js';
+import { CliRefusal } from './cli-refusal.js';
+import { draftPaths } from './draft-workspace.js';
+import { classifyLocalConversionInput } from './local-conversion-input.js';
+import { readSelectionRecord } from './selection-record.js';
+/**
+ * Which design a branch run grows from, resolved and proved before the run
+ * claims anything.
+ *
+ * The claim is not free: the service's build claim spends a metered plan call
+ * on the winning image before a single screen is dispatched. So the winner is
+ * the FIRST input this command settles, ahead of scope and concept, and a run
+ * that cannot name one stops here rather than one round trip later.
+ *
+ * There is exactly one implicit default, and it is a record rather than a
+ * guess: `12ui select` wrote which candidate won, so `branch execute <run-dir>`
+ * reads it instead of making the caller restate a decision. Nothing else is
+ * inferred. Picking a candidate because it happens to be the only file on disk
+ * would spend the plan call on a design nobody approved, which is worse than
+ * asking.
+ */
+const RUN_ID = /^crt-[a-f0-9]{40}$/u;
+const SLOT = /^[a-z]{1,2}$/u;
+const EXAMPLE_RUN_ID = `crt-${'0'.repeat(40)}`;
+export const imageWinner = async (imagePath, label = 'The winner') => {
+    const resolved = path.resolve(imagePath);
+    const classified = classifyLocalConversionInput(resolved);
+    if (classified.kind !== 'image') {
+        throw new CliRefusal(`${label} must be a PNG, JPEG, or WebP`, 'branch_winner_not_an_image');
+    }
+    const bytes = new Uint8Array(await readFile(resolved));
+    return {
+        kind: 'image',
+        imagePath: resolved,
+        bytes,
+        mediaType: classified.mediaType,
+        sha256: createHash('sha256').update(bytes).digest('hex'),
+    };
+};
+/**
+ * The winner the run already recorded. Restating a decision is how the two
+ * records drift apart, so a run directory that holds a selection needs no flag.
+ */
+export const winnerFromSelection = async (runDir) => {
+    const selection = await readSelectionRecord(draftPaths(runDir).selection);
+    if (!selection)
+        return null;
+    const chosen = selection.candidates.find((candidate) => candidate.id === selection.winner);
+    if (!chosen?.path)
+        return null;
+    return imageWinner(chosen.path);
+};
+/**
+ * Both accepted forms and a command the caller can paste. A refusal that only
+ * says a starting design is required costs another round trip to find out how
+ * to give one, and this one already cost a paid run on 2026-08-12.
+ */
+export const missingWinnerMessage = (args) => {
+    const target = args.runDir ?? `--out-dir ${args.outDir}`;
+    const example = args.runDir
+        ? `12ui branch execute ${args.runDir} --scope page --concept "<what the surface must cover>"`
+            + ` --winner-image ${path.join(args.runDir, 'candidates', 'b.png')}`
+        : `12ui branch execute --out-dir ${args.outDir} --scope page`
+            + ' --concept "<what the surface must cover>" --winner-image ./winner.png';
+    return [
+        `A branch run grows from one approved design and ${target} named none.`,
+        args.runDir
+            ? `Record the choice once with \`12ui select ${args.runDir} --winner <id> --reason "<why>"\``
+                + ' and this command reads it, or name the design here:'
+            : 'Name the design, or pass the draft run directory as `12ui branch execute <run-dir>` and'
+                + ' the winner `12ui select` recorded is used:',
+        '  --winner-image <file>                          a PNG, JPEG, or WebP on disk',
+        '  --winner-run <crt-id> --winner-slot <slot>     a candidate from a create run',
+        `Example:\n  ${example}`,
+        'Nothing was claimed and nothing was bought.',
+    ].join('\n');
+};
+/**
+ * Resolve the starting design, or refuse with everything needed to fix it.
+ * Reaches the network never and the filesystem only for a design it was told to
+ * read, so it is safe to run before any client is built.
+ */
+export const resolveBranchWinner = async (args) => {
+    const runId = stringFlag(args.flags, 'winner-run')?.trim();
+    const slot = stringFlag(args.flags, 'winner-slot')?.trim();
+    const image = stringFlag(args.flags, 'winner-image')?.trim();
+    if (image && runId) {
+        throw new CliRefusal('A branch run starts from exactly one design, and both --winner-image and --winner-run were'
+            + ' given. Drop one.', 'branch_winner_ambiguous');
+    }
+    if (image)
+        return imageWinner(image, '--winner-image');
+    if (runId) {
+        if (!RUN_ID.test(runId)) {
+            throw new CliRefusal(`--winner-run must be a crt- run id such as ${EXAMPLE_RUN_ID}, not ${runId}`, 'branch_winner_run_invalid');
+        }
+        if (!slot) {
+            throw new CliRefusal(`--winner-run names the create run and --winner-slot names which candidate in it won;`
+                + ` ${runId} on its own does not say. Add --winner-slot <slot>, for example`
+                + ` \`--winner-run ${runId} --winner-slot a\`. Nothing was claimed and nothing was bought.`, 'branch_winner_slot_missing');
+        }
+        if (!SLOT.test(slot)) {
+            throw new CliRefusal(`--winner-slot must be a candidate slot such as a, not ${slot}`, 'branch_winner_slot_invalid');
+        }
+        return { kind: 'run', runId, slot };
+    }
+    if (slot) {
+        throw new CliRefusal(`--winner-slot ${slot} names a candidate but not the run holding it. Add`
+            + ` \`--winner-run <crt-id>\`, or point at the design directly with \`--winner-image <file>\`.`
+            + ' Nothing was claimed and nothing was bought.', 'branch_winner_run_missing');
+    }
+    // No flag at all. The one recorded decision counts; nothing else is guessed.
+    const recorded = args.runDir ? await winnerFromSelection(args.runDir) : null;
+    if (recorded)
+        return recorded;
+    throw new CliRefusal(missingWinnerMessage({ runDir: args.runDir, outDir: args.outDir }), 'branch_winner_missing');
+};
+//# sourceMappingURL=branch-winner.js.map

package/dist/branch-winner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-winner.js","sourceRoot":"","sources":["../src/branch-winner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,UAAU,EAAiB,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,GAAG,qBAAqB,CAAC;AACrC,MAAM,IAAI,GAAG,eAAe,CAAC;AAE7B,MAAM,cAAc,GAAG,OAAO,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;AAE/C,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAC9B,SAAiB,EACjB,KAAK,GAAG,YAAY,EACQ,EAAE;IAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAC1D,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAChC,MAAM,IAAI,UAAU,CAAC,GAAG,KAAK,+BAA+B,EAAE,4BAA4B,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,SAAS,EAAE,QAAQ;QACnB,KAAK;QACL,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;KACzD,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,MAAc,EAAqC,EAAE;IAC7F,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC;IAC1E,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3F,IAAI,CAAC,MAAM,EAAE,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAIpC,EAAU,EAAE;IACX,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,aAAa,IAAI,CAAC,MAAM,EAAE,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM;QACzB,CAAC,CAAC,uBAAuB,IAAI,CAAC,MAAM,yDAAyD;cACzF,mBAAmB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE;QACtE,CAAC,CAAC,iCAAiC,IAAI,CAAC,MAAM,eAAe;cACzD,wEAAwE,CAAC;IAC/E,OAAO;QACL,mDAAmD,MAAM,cAAc;QACvE,IAAI,CAAC,MAAM;YACT,CAAC,CAAC,6CAA6C,IAAI,CAAC,MAAM,mCAAmC;kBACzF,sDAAsD;YAC1D,CAAC,CAAC,yFAAyF;kBACvF,6CAA6C;QACnD,+EAA+E;QAC/E,gFAAgF;QAChF,eAAe,OAAO,EAAE;QACxB,6CAA6C;KAC9C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC,CAAC;AASF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,IAAuB,EAA8B,EAAE;IAC/F,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC;IAC3D,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC;IAE7D,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,UAAU,CAClB,4FAA4F;cAC1F,mBAAmB,EACrB,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IACD,IAAI,KAAK;QAAE,OAAO,WAAW,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IACvD,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,UAAU,CAClB,8CAA8C,cAAc,SAAS,KAAK,EAAE,EAC5E,2BAA2B,CAC5B,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,UAAU,CAClB,sFAAsF;kBACpF,IAAI,KAAK,iEAAiE;kBAC1E,mBAAmB,KAAK,iEAAiE,EAC3F,4BAA4B,CAC7B,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,UAAU,CAClB,yDAAyD,IAAI,EAAE,EAC/D,4BAA4B,CAC7B,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACtC,CAAC;IACD,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,IAAI,UAAU,CAClB,iBAAiB,IAAI,oDAAoD;cACvE,6FAA6F;cAC7F,8CAA8C,EAChD,2BAA2B,CAC5B,CAAC;IACJ,CAAC;IACD,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7E,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,IAAI,UAAU,CAClB,oBAAoB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,EAClE,uBAAuB,CACxB,CAAC;AACJ,CAAC,CAAC"}

package/dist/cli-arguments.d.ts

@@ -1,4 +1,5 @@
 export type CliFlags = Record<string, string | true>;
+export declare const CLI_BOOLEAN_FLAGS: ReadonlySet<string>;
 export declare const parseCliArguments: (argv: string[]) => {
     command: string[];
     flags: CliFlags;

package/dist/cli-arguments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-arguments.d.ts","sourceRoot":"","sources":["../src/cli-arguments.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAkBrD,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EAAE,KACb;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAqBtC,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,QAAQ,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SAGnE,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,QAAQ,EAAE,MAAM,MAAM,KAAG,OAA+B,CAAC"}
+{"version":3,"file":"cli-arguments.d.ts","sourceRoot":"","sources":["../src/cli-arguments.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAKrD,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAYhD,CAAC;AAEH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EAAE,KACb;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAqBtC,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,QAAQ,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SAGnE,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,QAAQ,EAAE,MAAM,MAAM,KAAG,OAA+B,CAAC"}

package/dist/cli-arguments.js

@@ -1,6 +1,7 @@
 // Every value-less flag must be listed here or the parser swallows the next
-// token as its value.
-const booleanFlags = new Set([
+// token as its value. Exported because the run journal normalizes argv without
+// the parser — a digest must never throw on an argv the parser would reject.
+export const CLI_BOOLEAN_FLAGS = new Set([
     'detach',
     'dry-run',
     'force',
@@ -26,7 +27,7 @@ export const parseCliArguments = (argv) => {
         const name = value.slice(2);
         if (!name)
             throw new Error('Invalid empty flag');
-        if (booleanFlags.has(name)) {
+        if (CLI_BOOLEAN_FLAGS.has(name)) {
             flags[name] = true;
             continue;
         }

package/dist/cli-arguments.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-arguments.js","sourceRoot":"","sources":["../src/cli-arguments.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,sBAAsB;AACtB,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,QAAQ;IACR,SAAS;IACT,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,WAAW;IACX,UAAU;IACV,SAAS;IACT,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAc,EAC0B,EAAE;IAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,IAAI,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACjD,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACnB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,KAAK,IAAI,mBAAmB,CAAC,CAAC;QAClF,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAe,EAAE,IAAY,EAAsB,EAAE;IAC9E,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAe,EAAE,IAAY,EAAW,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC"}
+{"version":3,"file":"cli-arguments.js","sourceRoot":"","sources":["../src/cli-arguments.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAwB,IAAI,GAAG,CAAC;IAC5D,QAAQ;IACR,SAAS;IACT,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,WAAW;IACX,UAAU;IACV,SAAS;IACT,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAc,EAC0B,EAAE;IAC1C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,IAAI,KAAK;gBAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACjD,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACnB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,KAAK,IAAI,mBAAmB,CAAC,CAAC;QAClF,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAe,EAAE,IAAY,EAAsB,EAAE;IAC9E,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAe,EAAE,IAAY,EAAW,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC"}

package/dist/cli-branch-command.d.ts

@@ -1,5 +1,6 @@
 import { type CliFlags } from './cli-arguments.js';
 import { readConversionConfig } from './config.js';
+import type { RunJournalNotes } from './run-journal.js';
 import { TwelveUiBranchClient } from './branch-client.js';
 import { TwelveUiConversionPackageClient } from './package-client.js';
 export declare const BRANCH_USAGE = "Usage:\n  12ui branch execute --winner-run <crt-id> --winner-slot <slot>|--winner-image <file>\n                      --concept <text>|--concept-file <file> --scope page|site\n                      --out-dir <directory> [--convert html] [--convert-model fast|standard|pro]\n                      [--convert-quality standard|pro] [--source-conversion-id <id>]\n                      [--max-screens <n>] [--page-concurrency <n>] [--idempotency-key <key>]\n                      [--resume] [--dry-run] [--wait] [--quiet] [--origin <url>] [--api-key <key>]\n  12ui branch resume  --out-dir <directory> [--quiet] [--origin <url>] [--api-key <key>]\n  12ui branch status  --out-dir <directory> [--json] [--origin <url>] [--api-key <key>]";
@@ -51,5 +52,7 @@ export declare const runBranchCommand: (action: string | undefined, flags: CliFl
     createPackageClient?: (config: ReturnType<typeof readConversionConfig>) => TwelveUiConversionPackageClient;
     /** The positional `<run-dir>` from `12ui branch execute <run-dir>`. */
     runDirArgument?: string;
+    /** Where this command writes down what it did. */
+    journal?: RunJournalNotes;
 }) => Promise<void>;
 //# sourceMappingURL=cli-branch-command.d.ts.map

package/dist/cli-branch-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-branch-command.d.ts","sourceRoot":"","sources":["../src/cli-branch-command.ts"],"names":[],"mappings":"AAIA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAoD,MAAM,oBAAoB,CAAC;AAyB5G,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAMtE,eAAO,MAAM,YAAY,guBAQ+D,CAAC;AAIzF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,IAOnE,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GAAU,MAAM;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,KAAG,OAAO,CAAC,uBAAuB,CAuBlC,CAAC;AA0IF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM;IACxC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,KAAG,MA4BH,CAAC;AAaF,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,MAAM,GAAG,SAAS,EAC1B,OAAO,QAAQ,EACf,eAAc;IACZ,UAAU,CAAC,EAAE,OAAO,oBAAoB,CAAC;IACzC,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,KAAK,oBAAoB,CAAC;IAC/F,mBAAmB,CAAC,EAAE,CACpB,MAAM,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,KAC5C,+BAA+B,CAAC;IACrC,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;CACpB,KACL,OAAO,CAAC,IAAI,CAoOd,CAAC"}
+{"version":3,"file":"cli-branch-command.d.ts","sourceRoot":"","sources":["../src/cli-branch-command.ts"],"names":[],"mappings":"AAIA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAqB,MAAM,oBAAoB,CAAC;AA0B7E,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAMtE,eAAO,MAAM,YAAY,guBAQ+D,CAAC;AAIzF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,IAOnE,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,GAAU,MAAM;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,KAAG,OAAO,CAAC,uBAAuB,CAwBlC,CAAC;AAyFF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM;IACxC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,KAAG,MA4BH,CAAC;AAaF,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,MAAM,GAAG,SAAS,EAC1B,OAAO,QAAQ,EACf,eAAc;IACZ,UAAU,CAAC,EAAE,OAAO,oBAAoB,CAAC;IACzC,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,KAAK,oBAAoB,CAAC;IAC/F,mBAAmB,CAAC,EAAE,CACpB,MAAM,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,KAC5C,+BAA+B,CAAC;IACrC,uEAAuE;IACvE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,OAAO,CAAC,EAAE,eAAe,CAAC;CACtB,KACL,OAAO,CAAC,IAAI,CAiQd,CAAC"}

package/dist/cli-branch-command.js

@@ -2,17 +2,18 @@ import { createHash } from 'node:crypto';
 import { readFile, stat } from 'node:fs/promises';
 import path from 'node:path';
 import { booleanFlag, stringFlag } from './cli-arguments.js';
+import { CliRefusal } from './cli-refusal.js';
 import { readConversionConfig } from './config.js';
-import { TwelveUiBranchClient, BRANCH_MAX_CONCEPT_CHARACTERS } from './branch-client.js';
+import { TwelveUiBranchClient } from './branch-client.js';
 import { deriveBranchRunKey, executeBranchRun } from './branch-execution.js';
+import { resolveBranchWinner } from './branch-winner.js';
+import { readConceptValue } from './concept-input.js';
 import { readBranchStatus } from './branch-status.js';
 import { BRANCH_ATTEMPT_FILENAME, BRANCH_COMPLETION_FILENAME, branchAttemptPath, readBranchAttempt, } from './branch-run-record.js';
 import { BRANCH_PROGRESS_FILENAME } from './branch-progress.js';
-import { DRAFT_BRANCH_DIRECTORY, draftPaths } from './draft-workspace.js';
-import { readSelectionRecord } from './selection-record.js';
+import { DRAFT_BRANCH_DIRECTORY } from './draft-workspace.js';
 import { BRANCH_PAGE_CONCURRENCY_DEFAULT, BRANCH_TYPICAL_SITE_PAGES, OPERATION_DURATION_HINTS, branchRunEstimateSeconds, createPackageProgressReporter, formatDuration, narrateCounts, nextActionLine, } from './cli-progress.js';
 import { isConversionModel } from './conversion-models.js';
-import { classifyLocalConversionInput } from './local-conversion-input.js';
 import { normalizeOptionalIdempotencyKey } from './idempotency-key.js';
 import { TwelveUiConversionPackageClient } from './package-client.js';
 import { isResponsiveConversionQuality, } from './responsive-quality.js';
@@ -56,8 +57,8 @@ export const resolveBranchDirectory = async (args) => {
     if (args.outDirFlag)
         return { branchDir: path.resolve(args.outDirFlag), runDir: null };
     if (!args.runDirArgument) {
-        throw new Error('A run directory is required: `12ui branch execute <run-dir>` (the directory `12ui draft`'
-            + ' printed), or `--out-dir <directory>` to name the branch directory outright.');
+        throw new CliRefusal('A run directory is required: `12ui branch execute <run-dir>` (the directory `12ui draft`'
+            + ' printed), or `--out-dir <directory>` to name the branch directory outright.', 'branch_run_directory_missing');
     }
     const given = path.resolve(args.runDirArgument);
     const holdsBranchRecords = await Promise.all([
@@ -90,74 +91,14 @@ const readConcept = async (flags) => {
     const inline = stringFlag(flags, 'concept')?.trim();
     const file = stringFlag(flags, 'concept-file')?.trim();
     if (Boolean(inline) === Boolean(file)) {
-        throw new Error('Provide exactly one --concept or --concept-file');
+        throw new CliRefusal('Provide exactly one --concept or --concept-file', 'branch_concept_missing');
     }
-    const value = (inline ?? (await readFile(path.resolve(file), 'utf8')))
-        .replace(/\s+/gu, ' ')
-        .trim();
-    if (!value)
-        throw new Error('--concept must not be empty');
-    if ([...value].length > BRANCH_MAX_CONCEPT_CHARACTERS) {
-        throw new Error(`--concept must be at most ${BRANCH_MAX_CONCEPT_CHARACTERS} characters`);
-    }
-    return value;
-};
-const imageWinner = async (imagePath) => {
-    const classified = classifyLocalConversionInput(imagePath);
-    if (classified.kind !== 'image')
-        throw new Error('The winner must be a PNG, JPEG, or WebP');
-    const bytes = new Uint8Array(await readFile(imagePath));
-    return {
-        kind: 'image',
-        imagePath,
-        bytes,
-        mediaType: classified.mediaType,
-        sha256: createHash('sha256').update(bytes).digest('hex'),
-    };
-};
-/**
- * The winner the run already recorded. `12ui select` wrote which candidate was
- * chosen and why, so `branch execute <run-dir>` should not make the caller say
- * it again — restating a decision is how the two records drift apart.
- */
-const winnerFromSelection = async (runDir) => {
-    const paths = draftPaths(runDir);
-    const selection = await readSelectionRecord(paths.selection);
-    if (!selection)
-        return null;
-    const chosen = selection.candidates.find((candidate) => candidate.id === selection.winner);
-    if (!chosen?.path)
-        return null;
-    return imageWinner(chosen.path);
-};
-const readWinner = async (flags) => {
-    const runId = stringFlag(flags, 'winner-run')?.trim();
-    const slot = stringFlag(flags, 'winner-slot')?.trim();
-    const image = stringFlag(flags, 'winner-image')?.trim();
-    if (Boolean(image) === Boolean(runId)) {
-        throw new Error('A branch run starts from exactly one of --winner-run/--winner-slot or --winner-image');
-    }
-    if (runId) {
-        if (!slot)
-            throw new Error('--winner-run requires --winner-slot');
-        if (!/^crt-[a-f0-9]{40}$/u.test(runId))
-            throw new Error('--winner-run must be a crt- run id');
-        if (!/^[a-z]{1,2}$/u.test(slot))
-            throw new Error('--winner-slot must be a candidate slot such as a');
-        return { kind: 'run', runId, slot };
-    }
-    const imagePath = path.resolve(image);
-    const classified = classifyLocalConversionInput(imagePath);
-    if (classified.kind !== 'image')
-        throw new Error('--winner-image must be a PNG, JPEG, or WebP');
-    const bytes = new Uint8Array(await readFile(imagePath));
-    return {
-        kind: 'image',
-        imagePath,
-        bytes,
-        mediaType: classified.mediaType,
-        sha256: createHash('sha256').update(bytes).digest('hex'),
-    };
+    return readConceptValue({
+        value: inline ?? (await readFile(path.resolve(file), 'utf8')),
+        flag: '--concept',
+        trimHint: 'Keep what the rest of the surface must cover; the approved design already carries'
+            + ' the styling.',
+    });
 };
 const readConvert = (flags) => {
     const convert = stringFlag(flags, 'convert')?.trim();
@@ -166,17 +107,17 @@ const readConvert = (flags) => {
     const sourceConversionId = stringFlag(flags, 'source-conversion-id')?.trim();
     if (convert === undefined) {
         if (model || quality || sourceConversionId) {
-            throw new Error('--convert-model, --convert-quality, and --source-conversion-id require --convert html');
+            throw new CliRefusal('--convert-model, --convert-quality, and --source-conversion-id require --convert html', 'branch_convert_flags_without_convert');
         }
         return undefined;
     }
     if (convert !== 'html')
-        throw new Error('--convert must be html');
+        throw new CliRefusal('--convert must be html', 'branch_convert_invalid');
     if (model !== undefined && !isConversionModel(model)) {
-        throw new Error('--convert-model must be fast, standard, or pro');
+        throw new CliRefusal('--convert-model must be fast, standard, or pro', 'branch_convert_model_invalid');
     }
     if (quality !== undefined && !isResponsiveConversionQuality(quality)) {
-        throw new Error('--convert-quality must be standard or pro');
+        throw new CliRefusal('--convert-quality must be standard or pro', 'branch_convert_quality_invalid');
     }
     return {
         output: 'html',
@@ -188,8 +129,8 @@ const readConvert = (flags) => {
 const readScope = (flags) => {
     const scope = stringFlag(flags, 'scope')?.trim();
     if (scope !== 'page' && scope !== 'site') {
-        throw new Error('--scope must be page (grow the approved screen into its whole page) or site (trunk plus'
-            + ' the planned sibling pages)');
+        throw new CliRefusal('--scope must be page (grow the approved screen into its whole page) or site (trunk plus'
+            + ' the planned sibling pages)', 'branch_scope_invalid');
     }
     return scope;
 };
@@ -198,8 +139,9 @@ const readMaxScreens = (flags) => {
     if (value === undefined)
         return undefined;
     const parsed = Number(value);
-    if (!Number.isSafeInteger(parsed) || parsed < 1)
-        throw new Error('--max-screens must be a positive integer');
+    if (!Number.isSafeInteger(parsed) || parsed < 1) {
+        throw new CliRefusal('--max-screens must be a positive integer', 'branch_max_screens_invalid');
+    }
     return parsed;
 };
 const plannedPages = (scope) => (scope === 'page' ? 1 : BRANCH_TYPICAL_SITE_PAGES);
@@ -252,13 +194,13 @@ const readPageConcurrency = (flags) => {
     const parsed = Number(value);
     if (!Number.isSafeInteger(parsed) || parsed < 1 || parsed > 10) {
         // Ten is the account's active-conversion cap, so more than that only queues.
-        throw new Error('--page-concurrency must be an integer between 1 and 10');
+        throw new CliRefusal('--page-concurrency must be an integer between 1 and 10', 'branch_page_concurrency_invalid');
     }
     return parsed;
 };
 export const runBranchCommand = async (action, flags, dependencies = {}) => {
     if (action !== 'execute' && action !== 'resume' && action !== 'status') {
-        throw new Error(BRANCH_USAGE);
+        throw new CliRefusal(BRANCH_USAGE, 'branch_usage');
     }
     const outDirFlag = stringFlag(flags, 'out-dir')?.trim();
     const resolvedDirectory = await resolveBranchDirectory({
@@ -289,6 +231,13 @@ export const runBranchCommand = async (action, flags, dependencies = {}) => {
             outDir,
             ...(client ? { refresh: async (runId) => client.getRun(runId) } : {}),
         });
+        // The one command whose whole answer is the run's state, so it is the one
+        // command whose journal line can settle whether the run is over.
+        dependencies.journal?.note({
+            terminal: report.complete,
+            ...(report.runId ? { runId: report.runId } : {}),
+            ...(report.completionPath ? { artifacts: [report.completionPath] } : {}),
+        });
         console.log(JSON.stringify(report, null, 2));
         return;
     }
@@ -299,10 +248,10 @@ export const runBranchCommand = async (action, flags, dependencies = {}) => {
     if (action === 'resume') {
         const attempt = await readBranchAttempt(branchAttemptPath(outDir));
         if (!attempt) {
-            throw new Error(`This branch run has never been started — there is nothing to resume, and nothing has`
+            throw new CliRefusal(`This branch run has never been started — there is nothing to resume, and nothing has`
                 + ` failed. There is no branch attempt at ${branchAttemptPath(outDir)}. Start it with`
                 + ' `12ui branch execute --winner-run <crt-id> --winner-slot <slot> --concept <text>'
-                + ' --scope page|site --out-dir <directory>`.');
+                + ' --scope page|site --out-dir <directory>`.', 'branch_nothing_to_resume');
         }
         const recorded = attempt.winner;
         let winner;
@@ -313,8 +262,8 @@ export const runBranchCommand = async (action, flags, dependencies = {}) => {
             const bytes = new Uint8Array(await readFile(recorded.imagePath));
             const sha256 = createHash('sha256').update(bytes).digest('hex');
             if (sha256 !== recorded.sha256) {
-                throw new Error(`Refusing to resume: ${recorded.imagePath} no longer holds the starting design this run`
-                    + ` branched from (${recorded.sha256} then, ${sha256} now).`);
+                throw new CliRefusal(`Refusing to resume: ${recorded.imagePath} no longer holds the starting design this run`
+                    + ` branched from (${recorded.sha256} then, ${sha256} now).`, 'branch_winner_changed');
             }
             winner = { kind: 'image', imagePath: recorded.imagePath, bytes, mediaType: recorded.mediaType, sha256 };
         }
@@ -343,22 +292,24 @@ export const runBranchCommand = async (action, flags, dependencies = {}) => {
     else {
         const aspect = stringFlag(flags, 'aspect')?.trim();
         if (aspect !== undefined && !['landscape', 'portrait', 'square'].includes(aspect)) {
-            throw new Error('--aspect must be landscape, portrait, or square');
-        }
-        const named = stringFlag(flags, 'winner-run') ?? stringFlag(flags, 'winner-image');
-        const recorded = named || !resolvedDirectory.runDir
-            ? null
-            : await winnerFromSelection(resolvedDirectory.runDir);
-        if (!named && !recorded && resolvedDirectory.runDir) {
-            throw new Error(`No winner is recorded in ${resolvedDirectory.runDir}. Choose one first with`
-                + ` \`12ui select ${resolvedDirectory.runDir} --winner <id> --reason "<why>"\`, or name a`
-                + ' starting design with --winner-image or --winner-run/--winner-slot.');
+            throw new CliRefusal('--aspect must be landscape, portrait, or square', 'branch_aspect_invalid');
         }
+        /**
+         * The winner is settled first because it is the input a run cannot recover
+         * from getting wrong: the service's claim spends a metered plan call on
+         * this image before any screen is dispatched. Scope and concept are cheap
+         * to re-ask for; a plan call on the wrong design is not.
+         */
+        const winner = await resolveBranchWinner({
+            flags,
+            runDir: resolvedDirectory.runDir,
+            outDir,
+        });
         inputs = {
             outDir,
             scope: readScope(flags),
             concept: await readConcept(flags),
-            winner: recorded ?? await readWinner(flags),
+            winner,
             ...(aspect ? { aspect: aspect } : {}),
             ...(readMaxScreens(flags) === undefined ? {} : { maxScreens: readMaxScreens(flags) }),
             ...(readConvert(flags) ? { convert: readConvert(flags) } : {}),
@@ -371,7 +322,11 @@ export const runBranchCommand = async (action, flags, dependencies = {}) => {
         origin: stringFlag(flags, 'origin'),
         apiKey: stringFlag(flags, 'api-key'),
     });
+    // Known before anything is claimed, and the one value a retry has to reuse.
+    dependencies.journal?.note({ idempotencyKey: deriveBranchRunKey(inputs) });
     if (booleanFlag(flags, 'dry-run')) {
+        // Nothing was claimed, so the run is exactly where it was.
+        dependencies.journal?.note({ terminal: false });
         console.log(JSON.stringify({
             dryRun: true,
             outDir,
@@ -465,6 +420,19 @@ export const runBranchCommand = async (action, flags, dependencies = {}) => {
             write(`[${elapsed()}] stopped: ${event.code} — ${event.message}`);
         },
     });
+    // The completion sentinel names every screen and page; the journal names the
+    // sentinel. A run is terminal here whatever its status: `partial` and
+    // `failed` are settled answers, not states to keep polling.
+    dependencies.journal?.note({
+        runId: result.completion.runId,
+        idempotencyKey: result.completion.runKey,
+        artifacts: [result.completionPath],
+        purchased: [
+            result.completion.runId,
+            ...result.completion.pages.flatMap((page) => (page.conversion?.conversionId ? [page.conversion.conversionId] : [])),
+        ],
+        terminal: true,
+    });
     console.log(JSON.stringify({
         completionPath: result.completionPath,
         ...result.completion,