@12ui/design 0.2.71 → 0.2.73

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

@@ -1,6 +1,185 @@
 import type { CliHelpContext } from './types.js';
 export { renderHelpContext } from './render.js';
 export declare const CLI_HELP_CONTEXTS: {
+    readonly scene: {
+        readonly summary: "Local tools for rebuilding a design image as a live Three.js scene (scene.md in the 12ui-design skill).";
+        readonly sections: readonly [{
+            readonly heading: "Verbs";
+            readonly items: readonly ["init — copy the starter harness and the bundled three.js r186 into a new scene folder.", "solve — solve the camera from landmarks; ray, project and rect place objects through it.", "serve — serve a scene folder on 127.0.0.1; capture — headless landing, orbit and action shots.", "sheet and blend — contact sheet and source/render overlay; colors — colour and difference sampling.", "rectify — flatten a perspective quad of the source (a screen, a label) into a texture."];
+        }, {
+            readonly heading: "Local only";
+            readonly items: readonly ["Every verb reads and writes only the paths on its command line. No account, no model call, no network.", "capture uses the managed Chromium and blocks every request that would leave the machine."];
+        }];
+    };
+    readonly 'scene init': {
+        readonly summary: "Copy the starter harness and the pinned three.js into a scene folder.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly [string, "Refuses, writing nothing, when any of those files already exists. The folder itself may exist."];
+        }];
+    };
+    readonly 'scene solve': {
+        readonly summary: "Least-squares camera (position, yaw, pitch, roll, vertical fov) from landmarks read off the source.";
+        readonly sections: readonly [{
+            readonly heading: "Spec";
+            readonly items: readonly [string, string, string];
+        }, {
+            readonly heading: "Reading the output";
+            readonly items: readonly [string, string, "camera.js is the line to paste into the starter camera.js; clip is the near/far range.", "cam.json keeps the keys of the Python helper, so existing scene folders keep working."];
+        }];
+    };
+    readonly 'scene ray': {
+        readonly summary: "Cast source pixels through the solved camera onto the plane y = --plane-y.";
+        readonly sections: readonly [{
+            readonly heading: "Notes";
+            readonly items: readonly ["Prints one \"u,v -> x= y= z=\" line per pixel; place an object's base where its ray lands."];
+        }];
+    };
+    readonly 'scene project': {
+        readonly summary: "World points to source pixels through the solved camera.";
+        readonly sections: readonly [{
+            readonly heading: "Notes";
+            readonly items: readonly ["Check every placement against the source with this before modelling further."];
+        }];
+    };
+    readonly 'scene rect': {
+        readonly summary: "Pose of a rectangle from its four source corners, in the order TL;TR;BR;BL.";
+        readonly sections: readonly [{
+            readonly heading: "Forms";
+            readonly items: readonly ["--plane-y: it lies flat on that plane, any size.", string, "Prints position, size and a three.js rotation (order YXZ) for a mesh whose face is local xy facing +z."];
+        }];
+    };
+    readonly 'scene serve': {
+        readonly summary: "Serve a scene folder on 127.0.0.1 for capture and for a browser.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly [string, "Serves nothing outside the folder and never caches."];
+        }];
+    };
+    readonly 'scene capture': {
+        readonly summary: "Headless captures of a served scene: the landing view, orbit angles and every action.";
+        readonly sections: readonly [{
+            readonly heading: "Views";
+            readonly items: readonly ["Default: landing, az-15, az-10, az+10, az+15 (from --orbit) and act-<name> for each action at t = 1.", string, string];
+        }, {
+            readonly heading: "Local only";
+            readonly items: readonly [string, "It reports \"fonts: N loaded, M failed\" and up to 30 console errors.", "It needs the managed Chromium. When that is missing it prints the install command and downloads nothing.", "The page must set window.__ready = true and expose window.__scene, as the starter main.js does."];
+        }];
+    };
+    readonly 'scene sheet': {
+        readonly summary: "Contact sheet: the source first, then each capture, in labelled 640 px tiles.";
+        readonly sections: readonly [{
+            readonly heading: "Notes";
+            readonly items: readonly ["--cols sets the columns (default 3); --note adds text to the source tile label."];
+        }];
+    };
+    readonly 'scene blend': {
+        readonly summary: "Overlay: source and render above, a 50% blend and the difference (x3) below.";
+        readonly sections: readonly [{
+            readonly heading: "Notes";
+            readonly items: readonly ["Look at the blend for silhouette and placement, and at the difference for value and colour."];
+        }];
+    };
+    readonly 'scene colors': {
+        readonly summary: "Sample source colours, or find where a render differs most from its source.";
+        readonly sections: readonly [{
+            readonly heading: "Forms";
+            readonly items: readonly ["--box: the mean source colour of one box, the hex to put in a material.", string, string];
+        }];
+    };
+    readonly 'scene rectify': {
+        readonly summary: "Flatten a perspective quad of the source (a screen, poster or label) into a flat texture.";
+        readonly sections: readonly [{
+            readonly heading: "Notes";
+            readonly items: readonly ["A true homography with bicubic sampling. Map the result onto a face whose aspect is the --size aspect.", "Crop just inside the frame so no bezel bleeds in."];
+        }];
+    };
+    readonly workflow: {
+        readonly summary: "Run design work through one persistent local workflow shared by the CLI, SDK, and MCP.";
+        readonly sections: readonly [{
+            readonly heading: "Flow";
+            readonly items: readonly ["Import local files, prepare a request or recipe, execute the returned operation, then inspect its status. Recipe commands prepare only.", "A declared host session receives a handoff for its own tools; register the resulting JSON or files against that same operation and attempt number.", "Local Codex/Claude execution uses the user’s plan. OpenAI API and 12ui fallbacks require explicit --allow-paid authorization; credentials alone do not enable spending.", "An ambiguous dispatch stops for reconciliation. Repeating execute never silently buys the same work through another provider."];
+        }];
+    };
+    readonly 'workflow prepare': {
+        readonly summary: "Read a WorkflowRequest JSON file and save an idempotent operation without executing it.";
+        readonly sections: readonly [{
+            readonly heading: "Request";
+            readonly items: readonly ["Required fields: capability (text, image, image-edit, code, or convert), prompt, inputs (imported Artifact array), and output with kind json, image, html, or project. Optional output.schema constrains JSON results; parameters carry public workflow settings.", "Use workflow import to create artifact identities. The same key and request replay the saved operation; changing inputs requires a new key."];
+        }];
+    };
+    readonly 'workflow execute': {
+        readonly summary: "Execute an existing operation through eligible providers in the requested preference order.";
+        readonly sections: readonly [{
+            readonly heading: "Routing";
+            readonly items: readonly ["--providers is an ordered comma-separated subset of session,codex,claude,openai,12ui. Declare only capabilities actually available in the calling session with --session-capabilities.", "--allow-paid openai,12ui authorizes those paid fallbacks. Omit a provider to withhold that permission. User-plan execution still consumes the user’s allowance.", "--trust-codex-config permits launching the existing Codex CLI configuration, including configured tools and hooks. Codex child execution is unavailable without it. This does not authorize paid API or 12ui fallbacks.", "Session execution returns a handoff, not completed output. Fulfill it using the calling client, then run workflow register with the result and the exact handoff attemptNumber as --attempt."];
+        }];
+    };
+    readonly 'workflow register': {
+        readonly summary: "Register outputs for a dispatched host-session operation.";
+        readonly sections: readonly [{
+            readonly heading: "Result JSON";
+            readonly items: readonly ["Provide value for a JSON result and/or files as objects with path, mediaType, and optional role and relativePath. Preserve bundle paths with relativePath so HTML can resolve CSS and images after export. Optional providerRequestId and usage preserve provenance.", "The service validates the saved contract and copies verified files into the workspace. Supply --attempt with the original handoff attemptNumber (at least 1); stale results cannot complete a newer attempt."];
+        }];
+    };
+    readonly 'workflow status': {
+        readonly summary: "Read saved operations without provider dispatch or authentication.";
+    };
+    readonly 'workflow continue': {
+        readonly summary: "Prepare the next dependent operations from a saved recipe without executing models.";
+        readonly sections: readonly [{
+            readonly heading: "Next steps";
+            readonly items: readonly ["Reads registered results and returns ready operation ids. Execute each ready operation explicitly."];
+        }];
+    };
+    readonly 'workflow fail': {
+        readonly summary: "Record explicit failure evidence for a dispatched session operation.";
+        readonly sections: readonly [{
+            readonly heading: "Failure JSON";
+            readonly items: readonly ["Requires code, message, and disposition: not-dispatched, terminal-no-output, terminal-stop, or ambiguous.", "Supply --attempt with the exact attempt number being reconciled. Use 0 only before any dispatch; a delayed failure cannot release a newer attempt.", "Refusals and permission denials are terminal-stop; uncertain outcomes are ambiguous. Neither allows automatic fallback."];
+        }];
+    };
+    readonly 'workflow import': {
+        readonly summary: "Copy a local file into the workspace and return its verified artifact identity.";
+    };
+    readonly 'workflow export': {
+        readonly summary: "Export a completed operation and its assets into a new or empty local directory.";
+    };
+    readonly 'workflow layerdoc': {
+        readonly summary: "Read a completed native LayerDoc and its verified local raster assets.";
+        readonly sections: readonly [{
+            readonly heading: "Local document";
+            readonly items: readonly ["Returns the canonical document, document and manifest paths, and an artifactId-to-local-file map with media types and hashes. Raster dimensions are verified against the document references.", "Requires a succeeded native LayerDoc operation. Verifies local assets without HTTP, account authentication or model inference.", "The portable sidecar resolves raster references for local consumers; it is not an upload contract for the existing hosted convert command."];
+        }];
+    };
+    readonly 'workflow capture': {
+        readonly summary: "Capture an HTTP(S) URL with local Chromium into screenshot and DOM artifacts.";
+        readonly sections: readonly [{
+            readonly heading: "Browser";
+            readonly items: readonly ["Uses a fresh unauthenticated browser. Defaults to a 1440×900 viewport; pass --full-page to capture the entire document.", "No model or hosted account is used. Chromium must be available in the local runtime."];
+        }];
+    };
+    readonly 'workflow capabilities': {
+        readonly summary: "Discover eligible providers without inference or authorizing paid calls.";
+        readonly sections: readonly [{
+            readonly heading: "Host session";
+            readonly items: readonly ["Host-session capabilities must be explicitly declared; discovery does not authorize paid calls.", "Pass --trust-codex-config only when the existing Codex CLI configuration, including tools and hooks, is trusted. This enables discovering Codex child execution; host-session tools do not require it."];
+        }];
+    };
+    readonly 'workflow draft': CliHelpContext;
+    readonly 'workflow branch': CliHelpContext;
+    readonly 'workflow edit': CliHelpContext;
+    readonly 'workflow redesign': CliHelpContext;
+    readonly 'workflow labels': CliHelpContext;
+    readonly 'workflow convert': CliHelpContext;
+    readonly 'workflow implement': CliHelpContext;
+    readonly 'workflow review': {
+        readonly summary: "Prepare an evidence-based visual review of an interface screenshot.";
+        readonly sections: readonly [{
+            readonly heading: "Input";
+            readonly items: readonly ["Supply source for the current screenshot, optional target for the approved screenshot, optional context, and optional criteria as an array of strings.", "Review findings describe only visible evidence. They do not establish runtime behavior or trigger automatic repair loops."];
+        }];
+    };
     readonly capabilities: {
         readonly summary: "Print the machine-readable 12ui capability contract as JSON.";
         readonly sections: readonly [{
@@ -22,7 +201,7 @@ export declare const CLI_HELP_CONTEXTS: {
         readonly summary: "Start the 12ui Model Context Protocol server over stdin and stdout.";
         readonly sections: readonly [{
             readonly heading: "Behavior";
-            readonly items: readonly ["Exposes conversion, corpus, draft-status, and branch-status tools to an MCP client.", "Runs until the client disconnects. This is a JSON-RPC transport command, not an interactive terminal interface."];
+            readonly items: readonly ["Exposes shared local workflows plus conversion, corpus, draft-status, and branch-status tools to an MCP client.", "Starts without 12ui credentials. Corpus search, status and downloads also work without authentication. Funded hosted tools resolve credentials only when called; workflow execution follows its explicit provider and spending policy.", "Runs until the client disconnects. This is a JSON-RPC transport command, not an interactive terminal interface."];
         }];
     };
     readonly version: {
@@ -70,24 +249,27 @@ export declare const CLI_HELP_CONTEXTS: {
         readonly summary: "Search the Design Corpus or resume a durable reference-retrieval attempt.";
         readonly sections: readonly [{
             readonly heading: "Actions";
-            readonly items: readonly ["inspire — retrieve and download visual references for a design problem.", "resume — finish an interrupted retrieval from its saved attempt state."];
+            readonly items: readonly ["status — read the corpus release without authentication or a query.", "inspire — retrieve and download visual references for a design problem.", "resume — finish an interrupted retrieval from its saved attempt state."];
         }];
     };
+    readonly 'corpus status': {
+        readonly summary: "Read the public Design Corpus release and retrieval contract without authentication.";
+    };
     readonly 'corpus inspire': {
         readonly summary: "Search the Design Corpus and download validated visual references.";
         readonly sections: readonly [{
             readonly heading: "Behavior";
-            readonly items: readonly ["Runs in the foreground and writes an attempt record before the metered search, then a manifest, evidence, receipts, and downloaded references.", "Defaults to four references; --count accepts 1–48 in every mode.", "--reference-image conditions retrieval on an existing PNG, JPEG, or WebP, and moves the default from hedge to balanced: the corpus refuses a hedge query that carries an image, so --mode hedge with --reference-image is refused before the search."];
+            readonly items: readonly ["Runs in the foreground and writes an attempt record before the free search, then a manifest, evidence, receipts, and downloaded references.", "Free without an account or credits, subject to abuse limits. Defaults to four references; --count accepts 1–24 without credentials and 1–48 with credentials.", "--reference-image conditions retrieval on an existing PNG, JPEG, or WebP, using the same balanced default: the corpus refuses a hedge query that carries an image, so --mode hedge with --reference-image is refused before the search."];
         }, {
             readonly heading: "Modes";
-            readonly items: readonly ["hedge is the default for a text query: it spreads the first references across distinct directions while holding the query, and its returned order is authoritative. It is the one mode a --reference-image search cannot use.", "direct stays closest to the literal query.", "balanced weighs relevance, quality, and variety evenly.", "adventurer keeps a relevant head while exploring less expected directions."];
+            readonly items: readonly ["balanced is the standalone default, with or without credentials. Explicit hedge requires an account for hosted planning; it spreads references across distinct directions and cannot carry --reference-image. For account-free planning, plan locally and retrieve with balanced, direct, or adventurer.", "direct stays closest to the literal query.", "balanced weighs relevance, quality, and variety evenly.", "adventurer keeps a relevant head while exploring less expected directions."];
         }];
     };
     readonly 'corpus resume': {
         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 verify the saved files; missing files resume under the original paid identity. Changed reference inputs and incompatible evidence are refused."];
+            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 retrieval identity. Changed reference inputs and incompatible evidence are refused."];
         }];
     };
     readonly draft: {
@@ -134,7 +316,7 @@ export declare const CLI_HELP_CONTEXTS: {
         readonly summary: "Turn an existing converted branch run into a clickable prototype.";
         readonly sections: readonly [{
             readonly heading: "Behavior";
-            readonly items: readonly ["Splits exported states, canonicalizes shared chrome, binds navigation from branch.plan.json, and creates holding pages for planned gaps.", "Buys one low-effort four-way label call per screen through the authenticated product API; deterministic navigation and dropdown rules take precedence.", "--polish is opt-in; it applies the retained deterministic, harm-guarded rules after build and verifies the polished output at runtime.", "Publishes <branch-dir>/prototype/proto-manifest.json only after input, runtime, action, dropdown, and majority-holding gates pass; holdings, shell skips/residuals, and untested script directions remain measured warnings."];
+            readonly items: readonly ["Splits exported states, canonicalizes shared chrome, binds navigation from branch.plan.json, and creates holding pages for planned gaps.", "Defaults to --labels none: deterministic local navigation and interactions without a hosted account. --labels 12ui explicitly buys one hosted label call per screen; deterministic navigation and dropdown rules take precedence.", "--labels workflow --workspace <directory> prepares exact DOM-candidate label operations without inference. While awaiting_labels, execute/register the returned operation IDs with workflow commands, then repeat the same prototype command. Only matching completed operations are consumed; generic image labels cannot be substituted.", "--polish is opt-in; it applies the retained deterministic, harm-guarded rules after build and verifies the polished output at runtime.", "Publishes <branch-dir>/prototype/proto-manifest.json only after input, runtime, action, dropdown, and majority-holding gates pass; holdings, shell skips/residuals, and untested script directions remain measured warnings."];
         }];
     };
     readonly redesign: {
@@ -151,7 +333,7 @@ export declare const CLI_HELP_CONTEXTS: {
         readonly summary: "Improve an interface with local source edits or a hosted implementation kit.";
         readonly sections: readonly [{
             readonly heading: "Behavior";
-            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 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 retrieved 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 reuses its existing reference retrieval.", "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. Without --apply, the command never applies code."];
@@ -167,6 +349,23 @@ export declare const CLI_HELP_CONTEXTS: {
             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 workspace: {
+        readonly summary: "Open the design workspace as a web page, for an agent without the workspace tools.";
+        readonly sections: readonly [{
+            readonly heading: "Actions";
+            readonly items: readonly ["open — serve the workspace of a finished draft run on 127.0.0.1 and print its address."];
+        }];
+    };
+    readonly 'workspace open': {
+        readonly summary: "Open the design workspace of a draft run as a web page and report what the user decides.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly ["Use it when the design.slate.* tools are not available. It is the same workspace those tools show: the options as one large image and thumbnails, Select, Design (new options and more like this), Edit with a scribble, Branch and Convert, and the Inspiration tab.", "Binds 127.0.0.1 only (a random free port, or --port), protects every page and call with a random token in the printed address, and prints one JSON line first, with the keys workspace (\"ready\"), url, runDir and wait. Open that address in a browser; the system browser is opened too unless --no-open (set BROWSER to choose the program).", "Design and Edit run on this Mac through the local Codex CLI, exactly as under 12ui mcp; no agent is needed to generate, and no 12ui account or credit is used. Work in progress is saved in the run and comes back after a reload.", "The run directory is the argument; with none, or with --latest, the most recently active finished draft run is opened."];
+        }, {
+            readonly heading: "The decision";
+            readonly items: readonly ["With --wait it blocks until the user selects an option, or sends a Branch or Convert request, then prints ONE JSON line and exits 0. Its keys are decision (select, branch or convert), runDir, pick, handoff, messages (what the screen would have sent an agent), text (what to run next) and view (what design.slate.data returns).", "Without --wait it keeps serving until interrupted and prints one such line per decision.", "A Convert request with a service engine uses 12ui credits when carried out: ask the user before running its command."];
+        }];
+    };
     readonly review: {
         readonly summary: "Open a local review page for stored drafts, branches, and conversions.";
         readonly sections: readonly [{

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":"AAMA,OAAO,KAAK,EAAkB,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOK,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/index.js

@@ -1,13 +1,17 @@
 import { CONVERSION_HELP } from './conversion.js';
 import { DESIGN_HELP } from './design.js';
 import { META_HELP } from './meta.js';
+import { SCENE_HELP } from './scene.js';
 import { SETUP_HELP } from './setup.js';
+import { WORKFLOW_HELP } from './workflow.js';
 export { renderHelpContext } from './render.js';
 export const CLI_HELP_CONTEXTS = {
     ...SETUP_HELP,
     ...DESIGN_HELP,
     ...CONVERSION_HELP,
     ...META_HELP,
+    ...WORKFLOW_HELP,
+    ...SCENE_HELP,
 };
 const POSITIONAL_HELP_FAMILIES = new Set(['convert']);
 export const helpTopicsFor = (command) => {

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli-help/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,UAAU;IACb,GAAG,WAAW;IACd,GAAG,eAAe;IAClB,GAAG,SAAS;CACqB,CAAC;AAEpC,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAA0B,EAAqB,EAAE;IAC7E,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9C,IAAI,KAAK,IAAI,iBAAiB,CAAC,KAAuC,CAAC,EAAE,CAAC;QACxE,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAC5C,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,CACjD,CAAC,CAAC;QACH,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,YAAY,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AACxD,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,OAA0B,EACE,EAAE;IAC9B,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,WAAW;QAC3C,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC,CAAC,OAAO,CAAC;IACZ,KAAK,IAAI,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAqC,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,MAAM,qBAAqB,GAAG,KAAK,KAAK,CAAC;eACpC,UAAU,CAAC,MAAM,GAAG,CAAC;eACrB,CAAC,wBAAwB,CAAC,GAAG,CAAC,GAAG,CAAC;eAClC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;QACjF,OAAO,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IACrD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli-help/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,UAAU;IACb,GAAG,WAAW;IACd,GAAG,eAAe;IAClB,GAAG,SAAS;IACZ,GAAG,aAAa;IAChB,GAAG,UAAU;CACoB,CAAC;AAEpC,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAEtD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAA0B,EAAqB,EAAE;IAC7E,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9C,IAAI,KAAK,IAAI,iBAAiB,CAAC,KAAuC,CAAC,EAAE,CAAC;QACxE,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAC5C,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,CACjD,CAAC,CAAC;QACH,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,YAAY,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AACxD,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,OAA0B,EACE,EAAE;IAC9B,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,WAAW;QAC3C,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC,CAAC,OAAO,CAAC;IACZ,KAAK,IAAI,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAqC,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,MAAM,qBAAqB,GAAG,KAAK,KAAK,CAAC;eACpC,UAAU,CAAC,MAAM,GAAG,CAAC;eACrB,CAAC,wBAAwB,CAAC,GAAG,CAAC,GAAG,CAAC;eAClC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;QACjF,OAAO,qBAAqB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IACrD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

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

@@ -20,7 +20,7 @@ export declare const META_HELP: {
         readonly summary: "Start the 12ui Model Context Protocol server over stdin and stdout.";
         readonly sections: readonly [{
             readonly heading: "Behavior";
-            readonly items: readonly ["Exposes conversion, corpus, draft-status, and branch-status tools to an MCP client.", "Runs until the client disconnects. This is a JSON-RPC transport command, not an interactive terminal interface."];
+            readonly items: readonly ["Exposes shared local workflows plus conversion, corpus, draft-status, and branch-status tools to an MCP client.", "Starts without 12ui credentials. Corpus search, status and downloads also work without authentication. Funded hosted tools resolve credentials only when called; workflow execution follows its explicit provider and spending policy.", "Runs until the client disconnects. This is a JSON-RPC transport command, not an interactive terminal interface."];
         }];
     };
     readonly version: {

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

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/cli-help/meta.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDa,CAAC"}
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/cli-help/meta.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDa,CAAC"}

package/dist/cli-help/meta.js

@@ -37,7 +37,8 @@ export const META_HELP = {
         sections: [{
                 heading: 'Behavior',
                 items: [
-                    'Exposes conversion, corpus, draft-status, and branch-status tools to an MCP client.',
+                    'Exposes shared local workflows plus conversion, corpus, draft-status, and branch-status tools to an MCP client.',
+                    'Starts without 12ui credentials. Corpus search, status and downloads also work without authentication. Funded hosted tools resolve credentials only when called; workflow execution follows its explicit provider and spending policy.',
                     'Runs until the client disconnects. This is a JSON-RPC transport command, not an interactive terminal interface.',
                 ],
             }],

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

@@ -1 +1 @@
-{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/cli-help/meta.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,YAAY,EAAE;QACZ,OAAO,EAAE,8DAA8D;QACvE,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE;oBACL,2IAA2I;oBAC3I,sGAAsG;iBACvG;aACF,CAAC;KACH;IACD,KAAK,EAAE;QACL,OAAO,EAAE,gGAAgG;QACzG,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE;oBACL,wFAAwF;0BACtF,kEAAkE;oBACpE,2EAA2E;oBAC3E,0FAA0F;0BACxF,eAAe;iBAClB;aACF,EAAE;gBACD,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE;oBACL,wFAAwF;0BACtF,UAAU;oBACZ,wEAAwE;oBACxE,gGAAgG;0BAC9F,qGAAqG;0BACrG,uGAAuG;iBAC1G;aACF,CAAC;KACH;IACD,GAAG,EAAE;QACH,OAAO,EAAE,qEAAqE;QAC9E,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE;oBACL,qFAAqF;oBACrF,iHAAiH;iBAClH;aACF,CAAC;KACH;IACD,OAAO,EAAE;QACP,OAAO,EAAE,2CAA2C;QACpD,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,CAAC,mGAAmG,CAAC;aAC7G,CAAC;KACH;CACgC,CAAC"}
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/cli-help/meta.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,YAAY,EAAE;QACZ,OAAO,EAAE,8DAA8D;QACvE,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE;oBACL,2IAA2I;oBAC3I,sGAAsG;iBACvG;aACF,CAAC;KACH;IACD,KAAK,EAAE;QACL,OAAO,EAAE,gGAAgG;QACzG,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE;oBACL,wFAAwF;0BACtF,kEAAkE;oBACpE,2EAA2E;oBAC3E,0FAA0F;0BACxF,eAAe;iBAClB;aACF,EAAE;gBACD,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE;oBACL,wFAAwF;0BACtF,UAAU;oBACZ,wEAAwE;oBACxE,gGAAgG;0BAC9F,qGAAqG;0BACrG,uGAAuG;iBAC1G;aACF,CAAC;KACH;IACD,GAAG,EAAE;QACH,OAAO,EAAE,qEAAqE;QAC9E,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE;oBACL,iHAAiH;oBACjH,wOAAwO;oBACxO,iHAAiH;iBAClH;aACF,CAAC;KACH;IACD,OAAO,EAAE;QACP,OAAO,EAAE,2CAA2C;QACpD,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,CAAC,mGAAmG,CAAC;aAC7G,CAAC;KACH;CACgC,CAAC"}

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

@@ -0,0 +1,96 @@
+export declare const SCENE_HELP: {
+    readonly scene: {
+        readonly summary: "Local tools for rebuilding a design image as a live Three.js scene (scene.md in the 12ui-design skill).";
+        readonly sections: readonly [{
+            readonly heading: "Verbs";
+            readonly items: readonly ["init — copy the starter harness and the bundled three.js r186 into a new scene folder.", "solve — solve the camera from landmarks; ray, project and rect place objects through it.", "serve — serve a scene folder on 127.0.0.1; capture — headless landing, orbit and action shots.", "sheet and blend — contact sheet and source/render overlay; colors — colour and difference sampling.", "rectify — flatten a perspective quad of the source (a screen, a label) into a texture."];
+        }, {
+            readonly heading: "Local only";
+            readonly items: readonly ["Every verb reads and writes only the paths on its command line. No account, no model call, no network.", "capture uses the managed Chromium and blocks every request that would leave the machine."];
+        }];
+    };
+    readonly 'scene init': {
+        readonly summary: "Copy the starter harness and the pinned three.js into a scene folder.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly [string, "Refuses, writing nothing, when any of those files already exists. The folder itself may exist."];
+        }];
+    };
+    readonly 'scene solve': {
+        readonly summary: "Least-squares camera (position, yaw, pitch, roll, vertical fov) from landmarks read off the source.";
+        readonly sections: readonly [{
+            readonly heading: "Spec";
+            readonly items: readonly [string, string, string];
+        }, {
+            readonly heading: "Reading the output";
+            readonly items: readonly [string, string, "camera.js is the line to paste into the starter camera.js; clip is the near/far range.", "cam.json keeps the keys of the Python helper, so existing scene folders keep working."];
+        }];
+    };
+    readonly 'scene ray': {
+        readonly summary: "Cast source pixels through the solved camera onto the plane y = --plane-y.";
+        readonly sections: readonly [{
+            readonly heading: "Notes";
+            readonly items: readonly ["Prints one \"u,v -> x= y= z=\" line per pixel; place an object's base where its ray lands."];
+        }];
+    };
+    readonly 'scene project': {
+        readonly summary: "World points to source pixels through the solved camera.";
+        readonly sections: readonly [{
+            readonly heading: "Notes";
+            readonly items: readonly ["Check every placement against the source with this before modelling further."];
+        }];
+    };
+    readonly 'scene rect': {
+        readonly summary: "Pose of a rectangle from its four source corners, in the order TL;TR;BR;BL.";
+        readonly sections: readonly [{
+            readonly heading: "Forms";
+            readonly items: readonly ["--plane-y: it lies flat on that plane, any size.", string, "Prints position, size and a three.js rotation (order YXZ) for a mesh whose face is local xy facing +z."];
+        }];
+    };
+    readonly 'scene serve': {
+        readonly summary: "Serve a scene folder on 127.0.0.1 for capture and for a browser.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly [string, "Serves nothing outside the folder and never caches."];
+        }];
+    };
+    readonly 'scene capture': {
+        readonly summary: "Headless captures of a served scene: the landing view, orbit angles and every action.";
+        readonly sections: readonly [{
+            readonly heading: "Views";
+            readonly items: readonly ["Default: landing, az-15, az-10, az+10, az+15 (from --orbit) and act-<name> for each action at t = 1.", string, string];
+        }, {
+            readonly heading: "Local only";
+            readonly items: readonly [string, "It reports \"fonts: N loaded, M failed\" and up to 30 console errors.", "It needs the managed Chromium. When that is missing it prints the install command and downloads nothing.", "The page must set window.__ready = true and expose window.__scene, as the starter main.js does."];
+        }];
+    };
+    readonly 'scene sheet': {
+        readonly summary: "Contact sheet: the source first, then each capture, in labelled 640 px tiles.";
+        readonly sections: readonly [{
+            readonly heading: "Notes";
+            readonly items: readonly ["--cols sets the columns (default 3); --note adds text to the source tile label."];
+        }];
+    };
+    readonly 'scene blend': {
+        readonly summary: "Overlay: source and render above, a 50% blend and the difference (x3) below.";
+        readonly sections: readonly [{
+            readonly heading: "Notes";
+            readonly items: readonly ["Look at the blend for silhouette and placement, and at the difference for value and colour."];
+        }];
+    };
+    readonly 'scene colors': {
+        readonly summary: "Sample source colours, or find where a render differs most from its source.";
+        readonly sections: readonly [{
+            readonly heading: "Forms";
+            readonly items: readonly ["--box: the mean source colour of one box, the hex to put in a material.", string, string];
+        }];
+    };
+    readonly 'scene rectify': {
+        readonly summary: "Flatten a perspective quad of the source (a screen, poster or label) into a flat texture.";
+        readonly sections: readonly [{
+            readonly heading: "Notes";
+            readonly items: readonly ["A true homography with bicubic sampling. Map the result onto a face whose aspect is the --size aspect.", "Crop just inside the frame so no bezel bleeds in."];
+        }];
+    };
+};
+//# sourceMappingURL=scene.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/cli-help/scene.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgKY,CAAC"}