@12ui/design 0.2.65 → 0.2.67

package/dist/cli-help/conversion.d.ts

@@ -3,7 +3,7 @@ export declare const CONVERSION_HELP: {
         readonly summary: "Convert one visual file, or compose ordered viewport images into complete pages.";
         readonly sections: readonly [{
             readonly heading: "Single-file conversion";
-            readonly items: readonly ["Accepts PNG, JPEG, WebP, public LayerDoc v2 JSON, or a finished conversion ID.", "Image input waits, streams progress, and downloads results. --output html writes both the LayerDoc and responsive HTML through the fused path.", "Conversion-id input requires --out-dir and derives comma-separated formats concurrently without another image conversion.", "Image inputs support --model and proportional --width. Responsive HTML supports --responsive-quality."];
+            readonly items: readonly ["Accepts PNG, JPEG, WebP, public LayerDoc v2 JSON, or a finished conversion ID.", "--engine auto|codex|api defaults to auto (TWELVE_UI_ENGINE overrides the default). Auto selects local Codex when available; hosted-specific options select API. Explicit codex refuses unsupported hosted options.", "Conversion-id input requires --out-dir and derives comma-separated formats concurrently without another image conversion.", "Local HTML is editable HTML/CSS and assets without LayerDoc. --image-backend external|native is independent of the engine. New runs choose external when OPENAI_API_KEY is nonblank, otherwise native. Explicit choices and saved runs remain fixed; explicit external requires the key before planner execution. --clean-assets accepts crop|enhance. API image inputs support --model and proportional --width; API responsive HTML supports --responsive-quality."];
         }, {
             readonly heading: "Package conversion";
             readonly items: readonly ["`12ui convert package` preserves ordered viewport slices and composes them into scrolling pages.", "`12ui convert package --template` prints a valid starter manifest without authentication or network access."];
@@ -19,11 +19,18 @@ export declare const CONVERSION_HELP: {
             readonly items: readonly ["--template prints starter JSON to stdout and guidance to stderr, then exits before reading credentials or contacting the service."];
         }];
     };
+    readonly export: {
+        readonly summary: "Derive assets, browser renders, PDF, or whole-page React from local HTML.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly ["Accepts a completed local run directory or an HTML output directory. Requires --output assets|png|jpg|webp|pdf|react and --out-dir.", "Raster and PDF exports require Chromium. React exports whole-page JSX, CSS, and assets, not a functional application or native LayerDoc."];
+        }];
+    };
     readonly resume: {
-        readonly summary: "Recover every artifact in an original conversion purchase.";
+        readonly summary: "Resume a recorded local run or recover an original hosted conversion purchase.";
         readonly sections: readonly [{
             readonly heading: "Behavior";
-            readonly items: readonly ["With only a conversion ID, restores the conversion and any linked fused export to their original filenames and directories.", "--out-dir keeps the original basenames but writes the recovered purchase into another directory.", "The optional --output plus --out power form collects one named operation from an older or externally-created purchase.", "Collects existing work only: it never retries, reconfigures, changes format, or creates a conversion."];
+            readonly items: readonly ["A local run directory uses its recorded engine and inputs; it never silently changes to API after failure. Local resume does not accept --out-dir, --timeout-ms, --output, --out, or hosted authentication flags.", "With only a conversion ID, restores the conversion and any linked fused export to their original filenames and directories.", "For hosted conversion IDs, --out-dir keeps the original basenames but writes the recovered purchase into another directory.", "For hosted conversion IDs, the optional --output plus --out power form collects one named operation from an older or externally-created purchase.", "Hosted recovery collects existing work only: it never retries, reconfigures, changes format, or creates a conversion."];
         }];
     };
 };

package/dist/cli-help/conversion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversion.d.ts","sourceRoot":"","sources":["../../src/cli-help/conversion.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqDO,CAAC"}
+{"version":3,"file":"conversion.d.ts","sourceRoot":"","sources":["../../src/cli-help/conversion.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6DO,CAAC"}

package/dist/cli-help/conversion.js

@@ -6,9 +6,9 @@ export const CONVERSION_HELP = {
                 heading: 'Single-file conversion',
                 items: [
                     'Accepts PNG, JPEG, WebP, public LayerDoc v2 JSON, or a finished conversion ID.',
-                    'Image input waits, streams progress, and downloads results. --output html writes both the LayerDoc and responsive HTML through the fused path.',
+                    '--engine auto|codex|api defaults to auto (TWELVE_UI_ENGINE overrides the default). Auto selects local Codex when available; hosted-specific options select API. Explicit codex refuses unsupported hosted options.',
                     'Conversion-id input requires --out-dir and derives comma-separated formats concurrently without another image conversion.',
-                    'Image inputs support --model and proportional --width. Responsive HTML supports --responsive-quality.',
+                    'Local HTML is editable HTML/CSS and assets without LayerDoc. --image-backend external|native is independent of the engine. New runs choose external when OPENAI_API_KEY is nonblank, otherwise native. Explicit choices and saved runs remain fixed; explicit external requires the key before planner execution. --clean-assets accepts crop|enhance. API image inputs support --model and proportional --width; API responsive HTML supports --responsive-quality.',
                 ],
             },
             {
@@ -39,15 +39,23 @@ export const CONVERSION_HELP = {
             },
         ],
     },
+    export: {
+        summary: 'Derive assets, browser renders, PDF, or whole-page React from local HTML.',
+        sections: [{ heading: 'Behavior', items: [
+                    'Accepts a completed local run directory or an HTML output directory. Requires --output assets|png|jpg|webp|pdf|react and --out-dir.',
+                    'Raster and PDF exports require Chromium. React exports whole-page JSX, CSS, and assets, not a functional application or native LayerDoc.',
+                ] }],
+    },
     resume: {
-        summary: 'Recover every artifact in an original conversion purchase.',
+        summary: 'Resume a recorded local run or recover an original hosted conversion purchase.',
         sections: [{
                 heading: 'Behavior',
                 items: [
+                    'A local run directory uses its recorded engine and inputs; it never silently changes to API after failure. Local resume does not accept --out-dir, --timeout-ms, --output, --out, or hosted authentication flags.',
                     'With only a conversion ID, restores the conversion and any linked fused export to their original filenames and directories.',
-                    '--out-dir keeps the original basenames but writes the recovered purchase into another directory.',
-                    'The optional --output plus --out power form collects one named operation from an older or externally-created purchase.',
-                    'Collects existing work only: it never retries, reconfigures, changes format, or creates a conversion.',
+                    'For hosted conversion IDs, --out-dir keeps the original basenames but writes the recovered purchase into another directory.',
+                    'For hosted conversion IDs, the optional --output plus --out power form collects one named operation from an older or externally-created purchase.',
+                    'Hosted recovery collects existing work only: it never retries, reconfigures, changes format, or creates a conversion.',
                 ],
             }],
     },

package/dist/cli-help/conversion.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversion.js","sourceRoot":"","sources":["../../src/cli-help/conversion.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE;QACP,OAAO,EAAE,kFAAkF;QAC3F,QAAQ,EAAE;YACR;gBACE,OAAO,EAAE,wBAAwB;gBACjC,KAAK,EAAE;oBACL,gFAAgF;oBAChF,gJAAgJ;oBAChJ,2HAA2H;oBAC3H,uGAAuG;iBACxG;aACF;YACD;gBACE,OAAO,EAAE,oBAAoB;gBAC7B,KAAK,EAAE;oBACL,kGAAkG;oBAClG,6GAA6G;iBAC9G;aACF;SACF;KACF;IACD,iBAAiB,EAAE;QACjB,OAAO,EAAE,iFAAiF;QAC1F,QAAQ,EAAE;YACR;gBACE,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE;oBACL,0IAA0I;oBAC1I,wHAAwH;oBACxH,+FAA+F;iBAChG;aACF;YACD;gBACE,OAAO,EAAE,eAAe;gBACxB,KAAK,EAAE;oBACL,mIAAmI;iBACpI;aACF;SACF;KACF;IACD,MAAM,EAAE;QACN,OAAO,EAAE,4DAA4D;QACrE,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE;oBACL,6HAA6H;oBAC7H,kGAAkG;oBAClG,wHAAwH;oBACxH,uGAAuG;iBACxG;aACF,CAAC;KACH;CACgC,CAAC"}
+{"version":3,"file":"conversion.js","sourceRoot":"","sources":["../../src/cli-help/conversion.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE;QACP,OAAO,EAAE,kFAAkF;QAC3F,QAAQ,EAAE;YACR;gBACE,OAAO,EAAE,wBAAwB;gBACjC,KAAK,EAAE;oBACL,gFAAgF;oBAChF,oNAAoN;oBACpN,2HAA2H;oBAC3H,scAAsc;iBACvc;aACF;YACD;gBACE,OAAO,EAAE,oBAAoB;gBAC7B,KAAK,EAAE;oBACL,kGAAkG;oBAClG,6GAA6G;iBAC9G;aACF;SACF;KACF;IACD,iBAAiB,EAAE;QACjB,OAAO,EAAE,iFAAiF;QAC1F,QAAQ,EAAE;YACR;gBACE,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE;oBACL,0IAA0I;oBAC1I,wHAAwH;oBACxH,+FAA+F;iBAChG;aACF;YACD;gBACE,OAAO,EAAE,eAAe;gBACxB,KAAK,EAAE;oBACL,mIAAmI;iBACpI;aACF;SACF;KACF;IACD,MAAM,EAAE;QACN,OAAO,EAAE,2EAA2E;QACpF,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE;oBACvC,qIAAqI;oBACrI,0IAA0I;iBAC3I,EAAE,CAAC;KACL;IACD,MAAM,EAAE;QACN,OAAO,EAAE,gFAAgF;QACzF,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE;oBACL,mNAAmN;oBACnN,6HAA6H;oBAC7H,6HAA6H;oBAC7H,mJAAmJ;oBACnJ,uHAAuH;iBACxH;aACF,CAAC;KACH;CACgC,CAAC"}

package/dist/cli-help/design.d.ts

@@ -20,14 +20,14 @@ export declare const DESIGN_HELP: {
         readonly summary: "Continue an incomplete corpus retrieval from its durable output directory.";
         readonly sections: readonly [{
             readonly heading: "Safety";
-            readonly items: readonly ["Reuses the saved request and idempotency key, preserves verified downloads, and fetches only what remains.", "Completed attempts, changed reference inputs, and incompatible evidence are refused rather than redispatched."];
+            readonly items: readonly ["Reuses the saved request and idempotency key, preserves verified downloads, and fetches only what remains.", "Completed attempts verify the saved files; missing files resume under the original paid identity. Changed reference inputs and incompatible evidence are refused."];
         }];
     };
     readonly draft: {
         readonly summary: "Retrieve references and generate first-viewport UI candidates.";
         readonly sections: readonly [{
             readonly heading: "Behavior";
-            readonly items: readonly ["Creates a resumable temporary run directory, prints it first, retrieves a corpus reference set, and claims one hosted /api/v1/create run.", "--candidates accepts 2–16 and defaults to four; prefer at least four distinct directions.", "--profile standard|pro selects the Draft profile. Standard is the default; the selected profile is recorded with the hosted run.", "The reference search runs hedge and needs no flag: one reference per candidate slot, spread across distinct directions while holding the concept. --corpus-mode direct|balanced|adventurer chooses another; those retrieve the wider twelve-reference slate and pair its first candidates. A search conditioned on your own image (--reference, --redesign-source) runs balanced instead: the corpus refuses a hedge query that carries an image. An explicit mode is its own run, so it searches again instead of resuming the default run in the same workspace.", "Every service dispatch request stays in the foreground. The command returns after no slot remains pending; generation stays server-side.", "Run `12ui next <run-dir> --wait` to poll, repair only recorded slots that never started, and download real PNGs into <run-dir>/candidates/.", "Defaults to landscape. Authentication is 12ui-only; no Codex session or caller-side image-provider key is read."];
+            readonly items: readonly ["Creates a resumable temporary run directory, prints it first, retrieves a corpus reference set, and claims one hosted /api/v1/create run.", "--candidates accepts 2–16 and defaults to four; prefer at least four distinct directions.", "--profile standard|pro selects the Draft profile. Standard is the default; the selected profile is recorded with the hosted run.", "Keep full image-generation instructions in --concept. Optionally pass --corpus-query \"<short visual caption>\" or --corpus-query @file: hedge retrieval accepts at most 400 UTF-16 characters after whitespace normalization. Describe the surface and intended layout, typography, imagery, and palette. Longer queries automatically use balanced retrieval with the full text and an explanation. The separate query is recorded and part of the run identity.", "The reference search runs hedge and needs no flag: one reference per candidate slot, spread across distinct directions while holding the concept. --corpus-mode direct|balanced|adventurer chooses another; those retrieve the wider twelve-reference slate and pair its first candidates. A search conditioned on your own image (--reference, --redesign-source) runs balanced instead: the corpus refuses a hedge query that carries an image. An explicit mode is its own run, so it searches again instead of resuming the default run in the same workspace.", "Every service dispatch request stays in the foreground. The command returns after no slot remains pending; generation stays server-side.", "Run `12ui next <run-dir> --wait` to poll, repair only recorded slots that never started, and download real PNGs into <run-dir>/candidates/.", "Defaults to landscape. Authentication is 12ui-only; no Codex session or caller-side image-provider key is read."];
         }, {
             readonly heading: "Redesign modes";
             readonly items: readonly ["Without --reference, creates a new interface and pairs one corpus reference with each candidate.", "--reference accepts a local path or HTTP(S) URL, conditions corpus retrieval, and sends those original bytes to every candidate.", "A reference retains style by default while excluding layout, content, and assets. --retain accepts comma-separated values; layout is the explicit structure-preserving opt-in.", "--retain-source says what the reference IS. inspiration (the default) is a design you like, so an exclusion is a prohibition: do not reuse its words or its logo. subject is your own page, so the same exclusion is a licence: its words may be rewritten, its brand may be replaced. `12ui improve` sends subject. Against a subject, at least one of layout, copy, brand, and style must be left free to change: keeping all four asks for the page back unchanged and is refused.", "--redesign-source remains an alias for local redesign workflows. --mode reskin is the layout-retain shorthand."];
@@ -81,23 +81,23 @@ export declare const DESIGN_HELP: {
         }];
     };
     readonly improve: {
-        readonly summary: "Improve one live interface, site, or screenshot and produce a replayable implementation kit.";
+        readonly summary: "Improve an interface with local source edits or a hosted implementation kit.";
         readonly sections: readonly [{
             readonly heading: "Behavior";
-            readonly items: readonly ["Page scope runs five stages in order: local capture, hosted draft candidates, explicit pick, fused LayerDoc and responsive HTML conversion, then a local implementation plan.", "The pick is explicit and has no default. With no --pick and no pick already recorded, the run stops after the draw, prints where the candidates are and the exact command that continues (--from pick --pick <slot>), and buys no conversion: converting a candidate nobody chose spends money on a guess that cannot be cancelled. --target supplies the design instead and skips draft and pick.", "--retain says what to hold from the live page, in the four-facet vocabulary: layout, content, assets, style. It defaults to assets,content — keep the product's brand and words, rework its layout and visual system. Add layout to hold the geometry, add style to work inside the existing visual language, drop assets to let the brand be replaced. The /improve page exposes the same four as Keep layout, Keep copy, Keep brand, and Keep style. At least one of the four must be left free to change: keeping all four asks for the page back unchanged and is refused before anything is bought.", "Whatever is retained, no setting licenses inventing a product fact: with content held the page says the same things; with content freed the words may be rewritten but every claim, number, offer, and control must still be present and true.", "The draft stage searches references under the same policy as `12ui draft`. Improve always conditions that search on its own capture of the page, and the corpus refuses a hedge query carrying an image, so it searches balanced; --corpus-mode direct|adventurer chooses another. The mode is recorded in improve.json when you name it, so a resume searches what the run searched. A resume must repeat the recorded mode or drop the flag: naming a different one is refused before anything is bought, because the references were bought under the recorded mode and a different mode is a different run — start it with a fresh --out-dir. A resume after the draft settled replays the references it already bought and buys nothing.", "URL input uses one Playwright context for repeated --bootstrap actions, screenshot capture, and selector-verified DOM extraction. Image input normalizes the source locally.", string, "The kit keeps every candidate, winner, target, plan, assets, and improve.json replay record. Repeating a settled stage reuses it; --from pick --pick <slot> invalidates only the old target and plan.", "--responsive-quality selects standard or pro responsive export. If that export fails, is absent, or reaches the improve deadline after LayerDoc materialization, improve continues to plan with a warning and derives fixed HTML free when possible.", "--convert-stall-seconds is a no-progress bound for every hosted convert wait, including the free fixed-layout derivation (default: 960s standard and pro, 300s fast; refused below one typical wall). A newly polled live stage or active lane resets it, so healthy tall work stays attached to its original purchase and no second conversion is dispatched. A true no-progress stall with no LayerDoc writes plan/STALL.md and exits non-zero with free re-attachment commands. With a LayerDoc, improve derives fixed HTML for the plan and plan/STALL.md gives the free resume command that later collects responsive winner.html without changing that plan basis. Stopping the wait does not stop the conversion: there is no cancel, so an open run keeps billing.", "--fresh re-buys ONE conversion of the same settled winner under a new idempotency key: it records the abandoned conversion identity and reuses capture, draft and pick untouched. --redraw is the one that buys new candidates — it discards draft, pick, convert and plan, moves the old draw to candidates.previous, records any conversion it drops, and runs the draft stage again; it is also the one path allowed to change --direction, --candidates or --retain against the record. A temporarily unavailable stage retries once after 30 seconds.", "--target brings your own design image or LayerDoc, skips draft and pick, converts an image when needed, and aligns the plan to the captured URL DOM."];
+            readonly items: readonly ["--apply supports page scope only and capture/draft/pick source stages; branch/site/convert/plan options belong to hosted kits. --apply with a URL and --repo captures the current interface and edits the actual project locally. --target supplies an approved image; without a target, draft candidates and an explicit pick precede application. Omit --apply for the existing hosted kit workflow.", "Hosted page scope runs five stages in order: local capture, hosted draft candidates, explicit pick, fused LayerDoc and responsive HTML conversion, then a local implementation plan.", "The pick is explicit and has no default. With no --pick and no pick already recorded, the run stops after the draw, prints where the candidates are and the exact command that continues (--from pick --pick <slot>), and buys no conversion: converting a candidate nobody chose spends money on a guess that cannot be cancelled. --target supplies the design instead and skips draft and pick.", "--retain says what to hold from the live page, in the four-facet vocabulary: layout, content, assets, style. It defaults to assets,content — keep the product's brand and words, rework its layout and visual system. Add layout to hold the geometry, add style to work inside the existing visual language, drop assets to let the brand be replaced. The /improve page exposes the same four as Keep layout, Keep copy, Keep brand, and Keep style. At least one of the four must be left free to change: keeping all four asks for the page back unchanged and is refused before anything is bought.", "Whatever is retained, no setting licenses inventing a product fact: with content held the page says the same things; with content freed the words may be rewritten but every claim, number, offer, and control must still be present and true.", "The draft stage searches references under the same policy as `12ui draft`. Improve always conditions that search on its own capture of the page, and the corpus refuses a hedge query carrying an image, so it searches balanced; --corpus-mode direct|adventurer chooses another. The mode is recorded in improve.json when you name it, so a resume searches what the run searched. A resume must repeat the recorded mode or drop the flag: naming a different one is refused before anything is bought, because the references were bought under the recorded mode and a different mode is a different run — start it with a fresh --out-dir. A resume after the draft settled replays the references it already bought and buys nothing.", "URL input uses one Playwright context for repeated --bootstrap actions, screenshot capture, and selector-verified DOM extraction. Image input normalizes the source locally.", string, "The kit keeps every candidate, winner, target, plan, assets, and improve.json replay record. Repeating a settled stage reuses it; --from pick --pick <slot> invalidates only the old target and plan.", "--responsive-quality selects standard or pro responsive export. If that export fails, is absent, or reaches the improve deadline after LayerDoc materialization, improve continues to plan with a warning and derives fixed HTML free when possible.", "--convert-stall-seconds is a no-progress bound for every hosted convert wait, including the free fixed-layout derivation (default: 960s standard and pro, 300s fast; refused below one typical wall). A newly polled live stage or active lane resets it, so healthy tall work stays attached to its original purchase and no second conversion is dispatched. A true no-progress stall with no LayerDoc writes plan/STALL.md and exits non-zero with free re-attachment commands. With a LayerDoc, improve derives fixed HTML for the plan and plan/STALL.md gives the free resume command that later collects responsive winner.html without changing that plan basis. Stopping the wait does not stop the conversion: there is no cancel, so an open run keeps billing.", "--fresh re-buys ONE conversion of the same settled winner under a new idempotency key: it records the abandoned conversion identity and reuses capture, draft and pick untouched. --redraw is the one that buys new candidates — it discards draft, pick, convert and plan, moves the old draw to candidates.previous, records any conversion it drops, and runs the draft stage again; it is also the one path allowed to change --direction, --candidates or --retain against the record. A temporarily unavailable stage retries once after 30 seconds.", "--target brings your own design image or LayerDoc, skips draft and pick, converts an image when needed, and aligns the plan to the captured URL DOM."];
         }, {
             readonly heading: "Whole-site polish";
-            readonly items: readonly ["--scope site captures 2–8 same-origin pages including the root, then runs capture, draft, pick, branch, convert, plan, and site. The accepted root is the visual system; each current non-root page is edited against it.", "Root and page conversions share one resilience policy: an unavailable responsive export never discards its LayerDoc or blocks that page plan, and the site kit records fixed-layout or LayerDoc-only delivery honestly.", "--pages caps free one-hop discovery including the root (default 5); repeat --page to supply explicit same-origin pages instead. --page-concurrency defaults to 3, and --reference-order defaults to current-first.", "The site roll-up writes site-plan/tokens.css, shared-shell.md, pages.md, and APPLY.md. It deduplicates tokens and shared shell changes so the implementation plan applies them once before per-page residue.", "Apply APPLY.md, then run `12ui improve <url> --scope site --out-dir <kit> --recheck`. It captures the root and every page once in one browser context, writes numbered recheck evidence, and replans only against kept targets without replaying settled stages. The command never applies code."];
+            readonly items: readonly ["--scope site captures 2–8 same-origin pages including the root, then runs capture, draft, pick, branch, convert, plan, and site. The accepted root is the visual system; each current non-root page is edited against it.", "Root and page conversions share one resilience policy: an unavailable responsive export never discards its LayerDoc or blocks that page plan, and the site kit records fixed-layout or LayerDoc-only delivery honestly.", "--pages caps free one-hop discovery including the root (default 5); repeat --page to supply explicit same-origin pages instead. --page-concurrency defaults to 3, and --reference-order defaults to current-first.", "The site roll-up writes site-plan/tokens.css, shared-shell.md, pages.md, and APPLY.md. It deduplicates tokens and shared shell changes so the implementation plan applies them once before per-page residue.", "Apply APPLY.md, then run `12ui improve <url> --scope site --out-dir <kit> --recheck`. It captures the root and every page once in one browser context, writes numbered recheck evidence, and replans only against kept targets without replaying settled stages. Without --apply, the command never applies code."];
         }, {
             readonly heading: "Planning";
-            readonly items: readonly ["URL plans require at least 60% plausible DOM-side coverage; a blocked gate writes GATE.md while target HTML and LayerDoc remain authoritative sidecars.", "Image plans are target-only by default. --plan-source-convert buys one source LayerDoc conversion for an unanchored LayerDoc comparison.", "--repo adds evidence-ranked src/ TSX, JSX, and CSS file hints to a URL plan. The command never applies code.", "--dry-run prints exact catalog price ceilings for every stage and makes no network request."];
+            readonly items: readonly ["URL plans require at least 60% plausible DOM-side coverage; a blocked gate writes GATE.md while target HTML and LayerDoc remain authoritative sidecars.", "Image plans are target-only by default. --plan-source-convert buys one source LayerDoc conversion for an unanchored LayerDoc comparison.", "--repo adds evidence-ranked src/ TSX, JSX, and CSS file hints to a URL plan. Without --apply, the command never applies code.", "--dry-run prints exact catalog price ceilings for every stage and makes no network request."];
         }];
     };
     readonly next: {
         readonly summary: "Read durable status and report the one useful command to run next.";
         readonly sections: readonly [{
             readonly heading: "Behavior";
-            readonly items: readonly ["Recognizes draft and branch directories, hosted run IDs, conversion IDs, and journal-backed workspaces.", "A bare read never starts, retries, or resumes work. Human status is the default; --json writes the machine record to stdout and suppresses the human progress stream.", "--wait repairs only recorded draft slots that are still pending, dispatching exactly those never-started slots before polling and downloading.", "--wait polls with heartbeats until terminal status. It has no hidden deadline; use --timeout-ms only for a deadline supplied by the user or request, never as an invented polling interval.", "Replaces the retired per-subsystem status commands."];
+            readonly items: readonly ["Recognizes local Codex conversion and project-apply runs, draft and branch directories, hosted run IDs, conversion IDs, and journal-backed workspaces.", "A bare read never starts, retries, or resumes work. Human status is the default; --json writes the machine record to stdout and suppresses the human progress stream.", "For local runs, --wait only observes recorded state; it never dispatches. For hosted drafts, --wait repairs only recorded draft slots that are still pending, dispatching exactly those never-started slots before polling and downloading.", "--wait polls with heartbeats until terminal status. It has no hidden deadline; use --timeout-ms only for a deadline supplied by the user or request, never as an invented polling interval.", "Replaces the retired per-subsystem status commands."];
         }];
     };
     readonly review: {

package/dist/cli-help/design.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"design.d.ts","sourceRoot":"","sources":["../../src/cli-help/design.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0PW,CAAC"}
+{"version":3,"file":"design.d.ts","sourceRoot":"","sources":["../../src/cli-help/design.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4PW,CAAC"}

package/dist/cli-help/design.js

@@ -37,7 +37,7 @@ export const DESIGN_HELP = {
                 heading: 'Safety',
                 items: [
                     'Reuses the saved request and idempotency key, preserves verified downloads, and fetches only what remains.',
-                    'Completed attempts, changed reference inputs, and incompatible evidence are refused rather than redispatched.',
+                    'Completed attempts verify the saved files; missing files resume under the original paid identity. Changed reference inputs and incompatible evidence are refused.',
                 ],
             }],
     },
@@ -50,6 +50,7 @@ export const DESIGN_HELP = {
                     'Creates a resumable temporary run directory, prints it first, retrieves a corpus reference set, and claims one hosted /api/v1/create run.',
                     '--candidates accepts 2–16 and defaults to four; prefer at least four distinct directions.',
                     '--profile standard|pro selects the Draft profile. Standard is the default; the selected profile is recorded with the hosted run.',
+                    'Keep full image-generation instructions in --concept. Optionally pass --corpus-query "<short visual caption>" or --corpus-query @file: hedge retrieval accepts at most 400 UTF-16 characters after whitespace normalization. Describe the surface and intended layout, typography, imagery, and palette. Longer queries automatically use balanced retrieval with the full text and an explanation. The separate query is recorded and part of the run identity.',
                     'The reference search runs hedge and needs no flag: one reference per candidate slot, spread across distinct directions while holding the concept. --corpus-mode direct|balanced|adventurer chooses another; those retrieve the wider twelve-reference slate and pair its first candidates. A search conditioned on your own image (--reference, --redesign-source) runs balanced instead: the corpus refuses a hedge query that carries an image. An explicit mode is its own run, so it searches again instead of resuming the default run in the same workspace.',
                     'Every service dispatch request stays in the foreground. The command returns after no slot remains pending; generation stays server-side.',
                     'Run `12ui next <run-dir> --wait` to poll, repair only recorded slots that never started, and download real PNGs into <run-dir>/candidates/.',
@@ -166,12 +167,13 @@ export const DESIGN_HELP = {
         ],
     },
     improve: {
-        summary: 'Improve one live interface, site, or screenshot and produce a replayable implementation kit.',
+        summary: 'Improve an interface with local source edits or a hosted implementation kit.',
         sections: [
             {
                 heading: 'Behavior',
                 items: [
-                    'Page scope runs five stages in order: local capture, hosted draft candidates, explicit pick, fused LayerDoc and responsive HTML conversion, then a local implementation plan.',
+                    '--apply supports page scope only and capture/draft/pick source stages; branch/site/convert/plan options belong to hosted kits. --apply with a URL and --repo captures the current interface and edits the actual project locally. --target supplies an approved image; without a target, draft candidates and an explicit pick precede application. Omit --apply for the existing hosted kit workflow.',
+                    'Hosted page scope runs five stages in order: local capture, hosted draft candidates, explicit pick, fused LayerDoc and responsive HTML conversion, then a local implementation plan.',
                     'The pick is explicit and has no default. With no --pick and no pick already recorded, the run stops after the draw, prints where the candidates are and the exact command that continues (--from pick --pick <slot>), and buys no conversion: converting a candidate nobody chose spends money on a guess that cannot be cancelled. --target supplies the design instead and skips draft and pick.',
                     '--retain says what to hold from the live page, in the four-facet vocabulary: layout, content, assets, style. It defaults to assets,content — keep the product\'s brand and words, rework its layout and visual system. Add layout to hold the geometry, add style to work inside the existing visual language, drop assets to let the brand be replaced. The /improve page exposes the same four as Keep layout, Keep copy, Keep brand, and Keep style. At least one of the four must be left free to change: keeping all four asks for the page back unchanged and is refused before anything is bought.',
                     'Whatever is retained, no setting licenses inventing a product fact: with content held the page says the same things; with content freed the words may be rewritten but every claim, number, offer, and control must still be present and true.',
@@ -199,7 +201,7 @@ export const DESIGN_HELP = {
                     'Root and page conversions share one resilience policy: an unavailable responsive export never discards its LayerDoc or blocks that page plan, and the site kit records fixed-layout or LayerDoc-only delivery honestly.',
                     '--pages caps free one-hop discovery including the root (default 5); repeat --page to supply explicit same-origin pages instead. --page-concurrency defaults to 3, and --reference-order defaults to current-first.',
                     'The site roll-up writes site-plan/tokens.css, shared-shell.md, pages.md, and APPLY.md. It deduplicates tokens and shared shell changes so the implementation plan applies them once before per-page residue.',
-                    'Apply APPLY.md, then run `12ui improve <url> --scope site --out-dir <kit> --recheck`. It captures the root and every page once in one browser context, writes numbered recheck evidence, and replans only against kept targets without replaying settled stages. The command never applies code.',
+                    'Apply APPLY.md, then run `12ui improve <url> --scope site --out-dir <kit> --recheck`. It captures the root and every page once in one browser context, writes numbered recheck evidence, and replans only against kept targets without replaying settled stages. Without --apply, the command never applies code.',
                 ],
             },
             {
@@ -207,7 +209,7 @@ export const DESIGN_HELP = {
                 items: [
                     'URL plans require at least 60% plausible DOM-side coverage; a blocked gate writes GATE.md while target HTML and LayerDoc remain authoritative sidecars.',
                     'Image plans are target-only by default. --plan-source-convert buys one source LayerDoc conversion for an unanchored LayerDoc comparison.',
-                    '--repo adds evidence-ranked src/ TSX, JSX, and CSS file hints to a URL plan. The command never applies code.',
+                    '--repo adds evidence-ranked src/ TSX, JSX, and CSS file hints to a URL plan. Without --apply, the command never applies code.',
                     '--dry-run prints exact catalog price ceilings for every stage and makes no network request.',
                 ],
             },
@@ -218,9 +220,9 @@ export const DESIGN_HELP = {
         sections: [{
                 heading: 'Behavior',
                 items: [
-                    'Recognizes draft and branch directories, hosted run IDs, conversion IDs, and journal-backed workspaces.',
+                    'Recognizes local Codex conversion and project-apply runs, draft and branch directories, hosted run IDs, conversion IDs, and journal-backed workspaces.',
                     'A bare read never starts, retries, or resumes work. Human status is the default; --json writes the machine record to stdout and suppresses the human progress stream.',
-                    '--wait repairs only recorded draft slots that are still pending, dispatching exactly those never-started slots before polling and downloading.',
+                    'For local runs, --wait only observes recorded state; it never dispatches. For hosted drafts, --wait repairs only recorded draft slots that are still pending, dispatching exactly those never-started slots before polling and downloading.',
                     '--wait polls with heartbeats until terminal status. It has no hidden deadline; use --timeout-ms only for a deadline supplied by the user or request, never as an invented polling interval.',
                     'Replaces the retired per-subsystem status commands.',
                 ],

package/dist/cli-help/design.js.map

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

package/dist/cli-help/index.d.ts

@@ -36,7 +36,7 @@ export declare const CLI_HELP_CONTEXTS: {
         readonly summary: "Convert one visual file, or compose ordered viewport images into complete pages.";
         readonly sections: readonly [{
             readonly heading: "Single-file conversion";
-            readonly items: readonly ["Accepts PNG, JPEG, WebP, public LayerDoc v2 JSON, or a finished conversion ID.", "Image input waits, streams progress, and downloads results. --output html writes both the LayerDoc and responsive HTML through the fused path.", "Conversion-id input requires --out-dir and derives comma-separated formats concurrently without another image conversion.", "Image inputs support --model and proportional --width. Responsive HTML supports --responsive-quality."];
+            readonly items: readonly ["Accepts PNG, JPEG, WebP, public LayerDoc v2 JSON, or a finished conversion ID.", "--engine auto|codex|api defaults to auto (TWELVE_UI_ENGINE overrides the default). Auto selects local Codex when available; hosted-specific options select API. Explicit codex refuses unsupported hosted options.", "Conversion-id input requires --out-dir and derives comma-separated formats concurrently without another image conversion.", "Local HTML is editable HTML/CSS and assets without LayerDoc. --image-backend external|native is independent of the engine. New runs choose external when OPENAI_API_KEY is nonblank, otherwise native. Explicit choices and saved runs remain fixed; explicit external requires the key before planner execution. --clean-assets accepts crop|enhance. API image inputs support --model and proportional --width; API responsive HTML supports --responsive-quality."];
         }, {
             readonly heading: "Package conversion";
             readonly items: readonly ["`12ui convert package` preserves ordered viewport slices and composes them into scrolling pages.", "`12ui convert package --template` prints a valid starter manifest without authentication or network access."];
@@ -52,11 +52,18 @@ export declare const CLI_HELP_CONTEXTS: {
             readonly items: readonly ["--template prints starter JSON to stdout and guidance to stderr, then exits before reading credentials or contacting the service."];
         }];
     };
+    readonly export: {
+        readonly summary: "Derive assets, browser renders, PDF, or whole-page React from local HTML.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly ["Accepts a completed local run directory or an HTML output directory. Requires --output assets|png|jpg|webp|pdf|react and --out-dir.", "Raster and PDF exports require Chromium. React exports whole-page JSX, CSS, and assets, not a functional application or native LayerDoc."];
+        }];
+    };
     readonly resume: {
-        readonly summary: "Recover every artifact in an original conversion purchase.";
+        readonly summary: "Resume a recorded local run or recover an original hosted conversion purchase.";
         readonly sections: readonly [{
             readonly heading: "Behavior";
-            readonly items: readonly ["With only a conversion ID, restores the conversion and any linked fused export to their original filenames and directories.", "--out-dir keeps the original basenames but writes the recovered purchase into another directory.", "The optional --output plus --out power form collects one named operation from an older or externally-created purchase.", "Collects existing work only: it never retries, reconfigures, changes format, or creates a conversion."];
+            readonly items: readonly ["A local run directory uses its recorded engine and inputs; it never silently changes to API after failure. Local resume does not accept --out-dir, --timeout-ms, --output, --out, or hosted authentication flags.", "With only a conversion ID, restores the conversion and any linked fused export to their original filenames and directories.", "For hosted conversion IDs, --out-dir keeps the original basenames but writes the recovered purchase into another directory.", "For hosted conversion IDs, the optional --output plus --out power form collects one named operation from an older or externally-created purchase.", "Hosted recovery collects existing work only: it never retries, reconfigures, changes format, or creates a conversion."];
         }];
     };
     readonly corpus: {
@@ -80,14 +87,14 @@ export declare const CLI_HELP_CONTEXTS: {
         readonly summary: "Continue an incomplete corpus retrieval from its durable output directory.";
         readonly sections: readonly [{
             readonly heading: "Safety";
-            readonly items: readonly ["Reuses the saved request and idempotency key, preserves verified downloads, and fetches only what remains.", "Completed attempts, changed reference inputs, and incompatible evidence are refused rather than redispatched."];
+            readonly items: readonly ["Reuses the saved request and idempotency key, preserves verified downloads, and fetches only what remains.", "Completed attempts verify the saved files; missing files resume under the original paid identity. Changed reference inputs and incompatible evidence are refused."];
         }];
     };
     readonly draft: {
         readonly summary: "Retrieve references and generate first-viewport UI candidates.";
         readonly sections: readonly [{
             readonly heading: "Behavior";
-            readonly items: readonly ["Creates a resumable temporary run directory, prints it first, retrieves a corpus reference set, and claims one hosted /api/v1/create run.", "--candidates accepts 2–16 and defaults to four; prefer at least four distinct directions.", "--profile standard|pro selects the Draft profile. Standard is the default; the selected profile is recorded with the hosted run.", "The reference search runs hedge and needs no flag: one reference per candidate slot, spread across distinct directions while holding the concept. --corpus-mode direct|balanced|adventurer chooses another; those retrieve the wider twelve-reference slate and pair its first candidates. A search conditioned on your own image (--reference, --redesign-source) runs balanced instead: the corpus refuses a hedge query that carries an image. An explicit mode is its own run, so it searches again instead of resuming the default run in the same workspace.", "Every service dispatch request stays in the foreground. The command returns after no slot remains pending; generation stays server-side.", "Run `12ui next <run-dir> --wait` to poll, repair only recorded slots that never started, and download real PNGs into <run-dir>/candidates/.", "Defaults to landscape. Authentication is 12ui-only; no Codex session or caller-side image-provider key is read."];
+            readonly items: readonly ["Creates a resumable temporary run directory, prints it first, retrieves a corpus reference set, and claims one hosted /api/v1/create run.", "--candidates accepts 2–16 and defaults to four; prefer at least four distinct directions.", "--profile standard|pro selects the Draft profile. Standard is the default; the selected profile is recorded with the hosted run.", "Keep full image-generation instructions in --concept. Optionally pass --corpus-query \"<short visual caption>\" or --corpus-query @file: hedge retrieval accepts at most 400 UTF-16 characters after whitespace normalization. Describe the surface and intended layout, typography, imagery, and palette. Longer queries automatically use balanced retrieval with the full text and an explanation. The separate query is recorded and part of the run identity.", "The reference search runs hedge and needs no flag: one reference per candidate slot, spread across distinct directions while holding the concept. --corpus-mode direct|balanced|adventurer chooses another; those retrieve the wider twelve-reference slate and pair its first candidates. A search conditioned on your own image (--reference, --redesign-source) runs balanced instead: the corpus refuses a hedge query that carries an image. An explicit mode is its own run, so it searches again instead of resuming the default run in the same workspace.", "Every service dispatch request stays in the foreground. The command returns after no slot remains pending; generation stays server-side.", "Run `12ui next <run-dir> --wait` to poll, repair only recorded slots that never started, and download real PNGs into <run-dir>/candidates/.", "Defaults to landscape. Authentication is 12ui-only; no Codex session or caller-side image-provider key is read."];
         }, {
             readonly heading: "Redesign modes";
             readonly items: readonly ["Without --reference, creates a new interface and pairs one corpus reference with each candidate.", "--reference accepts a local path or HTTP(S) URL, conditions corpus retrieval, and sends those original bytes to every candidate.", "A reference retains style by default while excluding layout, content, and assets. --retain accepts comma-separated values; layout is the explicit structure-preserving opt-in.", "--retain-source says what the reference IS. inspiration (the default) is a design you like, so an exclusion is a prohibition: do not reuse its words or its logo. subject is your own page, so the same exclusion is a licence: its words may be rewritten, its brand may be replaced. `12ui improve` sends subject. Against a subject, at least one of layout, copy, brand, and style must be left free to change: keeping all four asks for the page back unchanged and is refused.", "--redesign-source remains an alias for local redesign workflows. --mode reskin is the layout-retain shorthand."];
@@ -141,23 +148,23 @@ export declare const CLI_HELP_CONTEXTS: {
         }];
     };
     readonly improve: {
-        readonly summary: "Improve one live interface, site, or screenshot and produce a replayable implementation kit.";
+        readonly summary: "Improve an interface with local source edits or a hosted implementation kit.";
         readonly sections: readonly [{
             readonly heading: "Behavior";
-            readonly items: readonly ["Page scope runs five stages in order: local capture, hosted draft candidates, explicit pick, fused LayerDoc and responsive HTML conversion, then a local implementation plan.", "The pick is explicit and has no default. With no --pick and no pick already recorded, the run stops after the draw, prints where the candidates are and the exact command that continues (--from pick --pick <slot>), and buys no conversion: converting a candidate nobody chose spends money on a guess that cannot be cancelled. --target supplies the design instead and skips draft and pick.", "--retain says what to hold from the live page, in the four-facet vocabulary: layout, content, assets, style. It defaults to assets,content — keep the product's brand and words, rework its layout and visual system. Add layout to hold the geometry, add style to work inside the existing visual language, drop assets to let the brand be replaced. The /improve page exposes the same four as Keep layout, Keep copy, Keep brand, and Keep style. At least one of the four must be left free to change: keeping all four asks for the page back unchanged and is refused before anything is bought.", "Whatever is retained, no setting licenses inventing a product fact: with content held the page says the same things; with content freed the words may be rewritten but every claim, number, offer, and control must still be present and true.", "The draft stage searches references under the same policy as `12ui draft`. Improve always conditions that search on its own capture of the page, and the corpus refuses a hedge query carrying an image, so it searches balanced; --corpus-mode direct|adventurer chooses another. The mode is recorded in improve.json when you name it, so a resume searches what the run searched. A resume must repeat the recorded mode or drop the flag: naming a different one is refused before anything is bought, because the references were bought under the recorded mode and a different mode is a different run — start it with a fresh --out-dir. A resume after the draft settled replays the references it already bought and buys nothing.", "URL input uses one Playwright context for repeated --bootstrap actions, screenshot capture, and selector-verified DOM extraction. Image input normalizes the source locally.", string, "The kit keeps every candidate, winner, target, plan, assets, and improve.json replay record. Repeating a settled stage reuses it; --from pick --pick <slot> invalidates only the old target and plan.", "--responsive-quality selects standard or pro responsive export. If that export fails, is absent, or reaches the improve deadline after LayerDoc materialization, improve continues to plan with a warning and derives fixed HTML free when possible.", "--convert-stall-seconds is a no-progress bound for every hosted convert wait, including the free fixed-layout derivation (default: 960s standard and pro, 300s fast; refused below one typical wall). A newly polled live stage or active lane resets it, so healthy tall work stays attached to its original purchase and no second conversion is dispatched. A true no-progress stall with no LayerDoc writes plan/STALL.md and exits non-zero with free re-attachment commands. With a LayerDoc, improve derives fixed HTML for the plan and plan/STALL.md gives the free resume command that later collects responsive winner.html without changing that plan basis. Stopping the wait does not stop the conversion: there is no cancel, so an open run keeps billing.", "--fresh re-buys ONE conversion of the same settled winner under a new idempotency key: it records the abandoned conversion identity and reuses capture, draft and pick untouched. --redraw is the one that buys new candidates — it discards draft, pick, convert and plan, moves the old draw to candidates.previous, records any conversion it drops, and runs the draft stage again; it is also the one path allowed to change --direction, --candidates or --retain against the record. A temporarily unavailable stage retries once after 30 seconds.", "--target brings your own design image or LayerDoc, skips draft and pick, converts an image when needed, and aligns the plan to the captured URL DOM."];
+            readonly items: readonly ["--apply supports page scope only and capture/draft/pick source stages; branch/site/convert/plan options belong to hosted kits. --apply with a URL and --repo captures the current interface and edits the actual project locally. --target supplies an approved image; without a target, draft candidates and an explicit pick precede application. Omit --apply for the existing hosted kit workflow.", "Hosted page scope runs five stages in order: local capture, hosted draft candidates, explicit pick, fused LayerDoc and responsive HTML conversion, then a local implementation plan.", "The pick is explicit and has no default. With no --pick and no pick already recorded, the run stops after the draw, prints where the candidates are and the exact command that continues (--from pick --pick <slot>), and buys no conversion: converting a candidate nobody chose spends money on a guess that cannot be cancelled. --target supplies the design instead and skips draft and pick.", "--retain says what to hold from the live page, in the four-facet vocabulary: layout, content, assets, style. It defaults to assets,content — keep the product's brand and words, rework its layout and visual system. Add layout to hold the geometry, add style to work inside the existing visual language, drop assets to let the brand be replaced. The /improve page exposes the same four as Keep layout, Keep copy, Keep brand, and Keep style. At least one of the four must be left free to change: keeping all four asks for the page back unchanged and is refused before anything is bought.", "Whatever is retained, no setting licenses inventing a product fact: with content held the page says the same things; with content freed the words may be rewritten but every claim, number, offer, and control must still be present and true.", "The draft stage searches references under the same policy as `12ui draft`. Improve always conditions that search on its own capture of the page, and the corpus refuses a hedge query carrying an image, so it searches balanced; --corpus-mode direct|adventurer chooses another. The mode is recorded in improve.json when you name it, so a resume searches what the run searched. A resume must repeat the recorded mode or drop the flag: naming a different one is refused before anything is bought, because the references were bought under the recorded mode and a different mode is a different run — start it with a fresh --out-dir. A resume after the draft settled replays the references it already bought and buys nothing.", "URL input uses one Playwright context for repeated --bootstrap actions, screenshot capture, and selector-verified DOM extraction. Image input normalizes the source locally.", string, "The kit keeps every candidate, winner, target, plan, assets, and improve.json replay record. Repeating a settled stage reuses it; --from pick --pick <slot> invalidates only the old target and plan.", "--responsive-quality selects standard or pro responsive export. If that export fails, is absent, or reaches the improve deadline after LayerDoc materialization, improve continues to plan with a warning and derives fixed HTML free when possible.", "--convert-stall-seconds is a no-progress bound for every hosted convert wait, including the free fixed-layout derivation (default: 960s standard and pro, 300s fast; refused below one typical wall). A newly polled live stage or active lane resets it, so healthy tall work stays attached to its original purchase and no second conversion is dispatched. A true no-progress stall with no LayerDoc writes plan/STALL.md and exits non-zero with free re-attachment commands. With a LayerDoc, improve derives fixed HTML for the plan and plan/STALL.md gives the free resume command that later collects responsive winner.html without changing that plan basis. Stopping the wait does not stop the conversion: there is no cancel, so an open run keeps billing.", "--fresh re-buys ONE conversion of the same settled winner under a new idempotency key: it records the abandoned conversion identity and reuses capture, draft and pick untouched. --redraw is the one that buys new candidates — it discards draft, pick, convert and plan, moves the old draw to candidates.previous, records any conversion it drops, and runs the draft stage again; it is also the one path allowed to change --direction, --candidates or --retain against the record. A temporarily unavailable stage retries once after 30 seconds.", "--target brings your own design image or LayerDoc, skips draft and pick, converts an image when needed, and aligns the plan to the captured URL DOM."];
         }, {
             readonly heading: "Whole-site polish";
-            readonly items: readonly ["--scope site captures 2–8 same-origin pages including the root, then runs capture, draft, pick, branch, convert, plan, and site. The accepted root is the visual system; each current non-root page is edited against it.", "Root and page conversions share one resilience policy: an unavailable responsive export never discards its LayerDoc or blocks that page plan, and the site kit records fixed-layout or LayerDoc-only delivery honestly.", "--pages caps free one-hop discovery including the root (default 5); repeat --page to supply explicit same-origin pages instead. --page-concurrency defaults to 3, and --reference-order defaults to current-first.", "The site roll-up writes site-plan/tokens.css, shared-shell.md, pages.md, and APPLY.md. It deduplicates tokens and shared shell changes so the implementation plan applies them once before per-page residue.", "Apply APPLY.md, then run `12ui improve <url> --scope site --out-dir <kit> --recheck`. It captures the root and every page once in one browser context, writes numbered recheck evidence, and replans only against kept targets without replaying settled stages. The command never applies code."];
+            readonly items: readonly ["--scope site captures 2–8 same-origin pages including the root, then runs capture, draft, pick, branch, convert, plan, and site. The accepted root is the visual system; each current non-root page is edited against it.", "Root and page conversions share one resilience policy: an unavailable responsive export never discards its LayerDoc or blocks that page plan, and the site kit records fixed-layout or LayerDoc-only delivery honestly.", "--pages caps free one-hop discovery including the root (default 5); repeat --page to supply explicit same-origin pages instead. --page-concurrency defaults to 3, and --reference-order defaults to current-first.", "The site roll-up writes site-plan/tokens.css, shared-shell.md, pages.md, and APPLY.md. It deduplicates tokens and shared shell changes so the implementation plan applies them once before per-page residue.", "Apply APPLY.md, then run `12ui improve <url> --scope site --out-dir <kit> --recheck`. It captures the root and every page once in one browser context, writes numbered recheck evidence, and replans only against kept targets without replaying settled stages. Without --apply, the command never applies code."];
         }, {
             readonly heading: "Planning";
-            readonly items: readonly ["URL plans require at least 60% plausible DOM-side coverage; a blocked gate writes GATE.md while target HTML and LayerDoc remain authoritative sidecars.", "Image plans are target-only by default. --plan-source-convert buys one source LayerDoc conversion for an unanchored LayerDoc comparison.", "--repo adds evidence-ranked src/ TSX, JSX, and CSS file hints to a URL plan. The command never applies code.", "--dry-run prints exact catalog price ceilings for every stage and makes no network request."];
+            readonly items: readonly ["URL plans require at least 60% plausible DOM-side coverage; a blocked gate writes GATE.md while target HTML and LayerDoc remain authoritative sidecars.", "Image plans are target-only by default. --plan-source-convert buys one source LayerDoc conversion for an unanchored LayerDoc comparison.", "--repo adds evidence-ranked src/ TSX, JSX, and CSS file hints to a URL plan. Without --apply, the command never applies code.", "--dry-run prints exact catalog price ceilings for every stage and makes no network request."];
         }];
     };
     readonly next: {
         readonly summary: "Read durable status and report the one useful command to run next.";
         readonly sections: readonly [{
             readonly heading: "Behavior";
-            readonly items: readonly ["Recognizes draft and branch directories, hosted run IDs, conversion IDs, and journal-backed workspaces.", "A bare read never starts, retries, or resumes work. Human status is the default; --json writes the machine record to stdout and suppresses the human progress stream.", "--wait repairs only recorded draft slots that are still pending, dispatching exactly those never-started slots before polling and downloading.", "--wait polls with heartbeats until terminal status. It has no hidden deadline; use --timeout-ms only for a deadline supplied by the user or request, never as an invented polling interval.", "Replaces the retired per-subsystem status commands."];
+            readonly items: readonly ["Recognizes local Codex conversion and project-apply runs, draft and branch directories, hosted run IDs, conversion IDs, and journal-backed workspaces.", "A bare read never starts, retries, or resumes work. Human status is the default; --json writes the machine record to stdout and suppresses the human progress stream.", "For local runs, --wait only observes recorded state; it never dispatches. For hosted drafts, --wait repairs only recorded draft slots that are still pending, dispatching exactly those never-started slots before polling and downloading.", "--wait polls with heartbeats until terminal status. It has no hidden deadline; use --timeout-ms only for a deadline supplied by the user or request, never as an invented polling interval.", "Replaces the retired per-subsystem status commands."];
         }];
     };
     readonly review: {
@@ -233,7 +240,7 @@ export declare const CLI_HELP_CONTEXTS: {
         readonly summary: "Manage the bundled design skill for supported coding agents.";
         readonly sections: readonly [{
             readonly heading: "Actions";
-            readonly items: readonly ["install — install the skill and ensure the CLI and authentication are ready.", "status — inspect skill, enablement, and credential-file state.", "print — write the bundled SKILL.md to stdout.", "remove — remove the skill while retaining the CLI and credentials."];
+            readonly items: readonly ["install — install the shared skill and ensure the CLI is ready.", "status — inspect skill, enablement, and credential-file state.", "print — write the bundled SKILL.md to stdout.", "remove — remove the skill while retaining the CLI and credentials."];
         }, {
             readonly heading: "Targets";
             readonly items: readonly ["Without --client, every detected Codex, Claude Code, Grok, Cursor, Antigravity, and Copilot installation is targeted.", "--home selects a custom client home and therefore requires --client."];
@@ -243,7 +250,7 @@ export declare const CLI_HELP_CONTEXTS: {
         readonly summary: "Install the bundled design skill into selected or detected coding-agent clients.";
         readonly sections: readonly [{
             readonly heading: "What it does";
-            readonly items: readonly ["Installs the skill transactionally, pins the CLI, enables Codex installations, and authenticates required scopes.", "--skip-auth leaves authentication untouched. --force replaces a conflicting unrecognized or locally modified skill."];
+            readonly items: readonly ["Installs the shared skill transactionally, pins the CLI, and enables Codex installations. Authentication is unchanged by default.", "Explicit --api-key, --key-name, or --login-origin requests authentication setup; these conflict with --skip-auth. --force replaces a conflicting unrecognized or locally modified skill."];
         }];
     };
     readonly 'skill status': {

package/dist/cli-help/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli-help/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAkB,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKK,CAAC;AAIpC,eAAO,MAAM,aAAa,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,SAAS,MAAM,EAUzE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,SAAS,SAAS,MAAM,EAAE,KACzB,cAAc,GAAG,SAenB,CAAC;AAEF,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli-help/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAkB,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKK,CAAC;AAIpC,eAAO,MAAM,aAAa,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,SAAS,MAAM,EAUzE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,SAAS,SAAS,MAAM,EAAE,KACzB,cAAc,GAAG,SAenB,CAAC;AAEF,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/cli-help/setup.d.ts

@@ -62,7 +62,7 @@ export declare const SETUP_HELP: {
         readonly summary: "Manage the bundled design skill for supported coding agents.";
         readonly sections: readonly [{
             readonly heading: "Actions";
-            readonly items: readonly ["install — install the skill and ensure the CLI and authentication are ready.", "status — inspect skill, enablement, and credential-file state.", "print — write the bundled SKILL.md to stdout.", "remove — remove the skill while retaining the CLI and credentials."];
+            readonly items: readonly ["install — install the shared skill and ensure the CLI is ready.", "status — inspect skill, enablement, and credential-file state.", "print — write the bundled SKILL.md to stdout.", "remove — remove the skill while retaining the CLI and credentials."];
         }, {
             readonly heading: "Targets";
             readonly items: readonly ["Without --client, every detected Codex, Claude Code, Grok, Cursor, Antigravity, and Copilot installation is targeted.", "--home selects a custom client home and therefore requires --client."];
@@ -72,7 +72,7 @@ export declare const SETUP_HELP: {
         readonly summary: "Install the bundled design skill into selected or detected coding-agent clients.";
         readonly sections: readonly [{
             readonly heading: "What it does";
-            readonly items: readonly ["Installs the skill transactionally, pins the CLI, enables Codex installations, and authenticates required scopes.", "--skip-auth leaves authentication untouched. --force replaces a conflicting unrecognized or locally modified skill."];
+            readonly items: readonly ["Installs the shared skill transactionally, pins the CLI, and enables Codex installations. Authentication is unchanged by default.", "Explicit --api-key, --key-name, or --login-origin requests authentication setup; these conflict with --skip-auth. --force replaces a conflicting unrecognized or locally modified skill."];
         }];
     };
     readonly 'skill status': {

package/dist/cli-help/setup.js

@@ -97,7 +97,7 @@ export const SETUP_HELP = {
             {
                 heading: 'Actions',
                 items: [
-                    'install — install the skill and ensure the CLI and authentication are ready.',
+                    'install — install the shared skill and ensure the CLI is ready.',
                     'status — inspect skill, enablement, and credential-file state.',
                     'print — write the bundled SKILL.md to stdout.',
                     'remove — remove the skill while retaining the CLI and credentials.',
@@ -117,8 +117,8 @@ export const SETUP_HELP = {
         sections: [{
                 heading: 'What it does',
                 items: [
-                    'Installs the skill transactionally, pins the CLI, enables Codex installations, and authenticates required scopes.',
-                    '--skip-auth leaves authentication untouched. --force replaces a conflicting unrecognized or locally modified skill.',
+                    'Installs the shared skill transactionally, pins the CLI, and enables Codex installations. Authentication is unchanged by default.',
+                    'Explicit --api-key, --key-name, or --login-origin requests authentication setup; these conflict with --skip-auth. --force replaces a conflicting unrecognized or locally modified skill.',
                 ],
             }],
     },

package/dist/cli-help/setup.js.map

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

package/dist/cli-image-backend.d.ts

@@ -0,0 +1,3 @@
+/** Resolve the image backend once, before a new conversion can spend planner usage. */
+export declare function selectInitialImageBackend(requested?: string, environment?: NodeJS.ProcessEnv): 'external' | 'native';
+//# sourceMappingURL=cli-image-backend.d.ts.map

package/dist/cli-image-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-image-backend.d.ts","sourceRoot":"","sources":["../src/cli-image-backend.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,wBAAgB,yBAAyB,CACvC,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,GAAE,MAAM,CAAC,UAAwB,GAC3C,UAAU,GAAG,QAAQ,CASvB"}

package/dist/cli-image-backend.js

@@ -0,0 +1,12 @@
+/** Resolve the image backend once, before a new conversion can spend planner usage. */
+export function selectInitialImageBackend(requested, environment = process.env) {
+    if (requested !== undefined && requested !== 'external' && requested !== 'native') {
+        throw new Error('--image-backend must be external or native');
+    }
+    const hasExternalKey = Boolean(environment.OPENAI_API_KEY?.trim());
+    if (requested === 'external' && !hasExternalKey) {
+        throw new Error('External image execution requires OPENAI_API_KEY. Set that key or select --image-backend native before starting this conversion. No planner call was started.');
+    }
+    return requested ?? (hasExternalKey ? 'external' : 'native');
+}
+//# sourceMappingURL=cli-image-backend.js.map

package/dist/cli-image-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-image-backend.js","sourceRoot":"","sources":["../src/cli-image-backend.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,UAAU,yBAAyB,CACvC,SAAkB,EAClB,cAAiC,OAAO,CAAC,GAAG;IAE5C,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,UAAU,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClF,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,IAAI,SAAS,KAAK,UAAU,IAAI,CAAC,cAAc,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,+JAA+J,CAAC,CAAC;IACnL,CAAC;IACD,OAAO,SAAS,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAC/D,CAAC"}

package/dist/cli-local-conversion.d.ts

@@ -0,0 +1,17 @@
+import { type CliFlags } from './cli-arguments.js';
+import type { EngineSelection } from './cli-engine.js';
+import { launchLocalRuntime } from './cli-local-runtime.js';
+import { type LocalConversionReceipt } from './cli-conversion-receipt.js';
+type Input = {
+    source: string;
+    runDir: string;
+    flags: CliFlags;
+    selection: EngineSelection;
+};
+type Dependencies = {
+    launch?: typeof launchLocalRuntime;
+};
+export declare function runLocalConversion(input: Input, dependencies?: Dependencies): Promise<LocalConversionReceipt>;
+export declare function resumeLocalConversion(runDir: string, flags: CliFlags, selection: EngineSelection, dependencies?: Dependencies): Promise<LocalConversionReceipt | undefined>;
+export {};
+//# sourceMappingURL=cli-local-conversion.d.ts.map

package/dist/cli-local-conversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-local-conversion.d.ts","sourceRoot":"","sources":["../src/cli-local-conversion.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAA4E,KAAK,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAIpJ,KAAK,KAAK,GAAC;IAAC,MAAM,EAAC,MAAM,CAAC;IAAA,MAAM,EAAC,MAAM,CAAC;IAAA,KAAK,EAAC,QAAQ,CAAC;IAAA,SAAS,EAAC,eAAe,CAAA;CAAC,CAAC;AAClF,KAAK,YAAY,GAAC;IAAC,MAAM,CAAC,EAAC,OAAO,kBAAkB,CAAA;CAAC,CAAC;AAuBtD,wBAAsB,kBAAkB,CAAC,KAAK,EAAC,KAAK,EAAC,YAAY,GAAC,YAAe,GAAE,OAAO,CAAC,sBAAsB,CAAC,CAKjH;AACD,wBAAsB,qBAAqB,CAAC,MAAM,EAAC,MAAM,EAAC,KAAK,EAAC,QAAQ,EAAC,SAAS,EAAC,eAAe,EAAC,YAAY,GAAC,YAAe,GAAE,OAAO,CAAC,sBAAsB,GAAC,SAAS,CAAC,CAazK"}