@12ui/design 0.2.75 → 0.2.77

package/README.md

@@ -79,15 +79,116 @@ unless `--force` is explicit.
 ## One visual interface skill
 
 `12ui-design` is the single design entrypoint. Every client receives the same
-`skills/12ui-design` bytes. New work inside a capable coding session uses the
-persistent local workflow: prepare a request, claim its execution, use the
-session's native tools, register the actual result, then continue from those
-saved artifacts. The local CLI and MCP share the same operation service.
+`skills/12ui-design` bytes. The skill runs `12ui draft`, `12ui branch execute`,
+`12ui convert` and `12ui improve`; the CLI owns local and hosted engine selection.
+The Design workspace is a view of those runs: the hosted plugin's inline screen,
+the local plugin's `design.slate.show`, or `12ui workspace open --wait` in a browser.
+
+The skill's `scene.md` guide rebuilds a design image as a live Three.js scene.
+It runs `12ui convert --engine auto` (Codex when it is ready, otherwise the 12ui
+API) in the background for the static page while the agent models the scene with
+the local `12ui scene` tools (`12ui scene --help`): camera solve, placement, a
+starter harness with a bundled three.js, `12ui scene merge` to put the converted
+page into the scene, capture with the managed Chromium, and review sheets. The
+`12ui scene` tools need no account and make no network request.
+
+`improve --apply` captures the URL and edits the actual repository. Without a target it drafts candidates, stops for
+an explicit choice, then applies that choice locally. Without `--apply`, the existing hosted implementation-kit behavior
+remains. Inspect the real application after editing.
+
+### Draft, branch, convert and improve
+
+`12ui draft`, `12ui branch`, `12ui convert` and `12ui improve` are the primary
+commands, and the ones the 12ui-design skill runs. Each keeps its own saved-run
+format. `convert --engine auto`, the default, runs on local Codex when it is
+ready and otherwise selects the 12ui API before dispatch; a saved run keeps its
+recorded engine. Local conversion selects external images when `OPENAI_API_KEY`
+is set and native Codex images otherwise. Pass `--engine` or an image backend to
+choose one yourself.
+
+Local HTML does not produce LayerDoc. Native design formats and hosted branch
+assembly remain dedicated conversion workflows. React export is whole-page JSX,
+not a functional application. Preserve existing run directories and their
+recorded engine for recovery; importing an output into a workflow workspace does
+not migrate an in-flight dispatch.
+
+The four stage skills that used to carry these sections separately —
+`design-search`, `design-draft`, `design-branch`, and `design-convert` — were
+retired on 2026-08-16 after a trial measured them buying no routing precision
+over the one broadened description. `skill install` removes any copy still
+present in an agent home.
+
+Corpus-conditioned image generation explores visual directions. The selected
+image then guides editable implementation, with browser inspection against the
+approved target and focused correction of observed mismatches.
+
+```bash
+12ui skill status --json
+12ui corpus inspire \
+  --query "Editorial architecture homepage with warm materiality" \
+  --reference-image ./current-homepage.png \
+  --out-dir ./references \
+  --count 4
+12ui draft \
+  --concept "Editorial architecture homepage with warm materiality" \
+  --reference ./current-homepage.png \
+  --retain style \
+  --candidates 4
+12ui next <run-dir> --wait
+12ui branch execute \
+  --start <run-dir>/candidates/A.png \
+  --concept "Editorial architecture studio site" \
+  --scope site \
+  --convert html \
+  --prototype
+12ui next <branch-run-dir> --wait
+12ui improve https://example.com/dashboard \
+  --direction "Editorial hierarchy, compact controls, quiet blue surfaces" \
+  --repo ./dashboard \
+  --out-dir ./dashboard-improve
+12ui improve https://example.com/dashboard \
+  --target ./approved-dashboard.png \
+  --repo ./dashboard \
+  --out-dir ./dashboard-align
+12ui convert <conversion-id> \
+  --output html_fixed,pdf,psd,pptx,sketch \
+  --out-dir ./exports
+```
+
+`draft` accepts 2-16 candidates and defaults to four. `--reference` accepts a
+local PNG/JPEG/WebP path or HTTP(S) URL, keeps the normal corpus retrieval, and
+sends the original image to every hosted candidate. Its new-page default retains
+style while excluding layout, content, and assets; `--retain layout` is the
+explicit source-geometry opt-in. It records the corpus set,
+hosted run id, stable service slots, output paths, and claim key in `draft.json`
+before dispatch. Every dispatch request stays in the foreground and posts only
+slots whose durable service state is still `pending`; in-flight, succeeded, and
+failed slots are never posted again. `12ui next <run-dir> --wait` repairs only
+never-started slots, then polls and downloads. Successful PNGs are digest-checked and written atomically under
+`<run-dir>/candidates/`, with terminal evidence in `draft.complete.json`.
+
+`12ui draft` never inspects Codex authentication, `OPENAI_API_KEY`, project
+`.env` files, or another caller-side image-provider credential. This describes
+`12ui draft`, not the workflow ledger's `draft` recipe.
+
+`convert <conversion-id>` downloads one successful base LayerDoc once and
+dispatches the chosen formats concurrently. It creates the destination
+directory as needed, but refuses before any API request when a selected output,
+its asset directory, or `export-manifest.json` already exists.
+
+`capabilities --json` reports the CLI's exact inputs and outputs, model and
+responsive-quality choices, duration hints, status commands, and durable
+journal/receipt contracts.
+
+### The local workflow ledger
+
+The CLI also keeps a persistent local workflow ledger, a secondary surface shared
+by the local CLI and MCP for hosts that drive individual operations themselves:
 
 ```sh
 12ui workflow import /absolute/path/reference.png --workspace ./design-work --role reference
 12ui workflow prepare ./request.json --workspace ./design-work --key homepage-direction-a
-12ui workflow execute <operation-id> --workspace ./design-work --providers session --session-capabilities image
+12ui workflow execute <operation-id> --workspace ./design-work --providers session --session-capabilities text
 12ui workflow register <operation-id> --workspace ./design-work --attempt <handoff-attempt-number> --result ./result.json
 12ui workflow status <operation-id> --workspace ./design-work
 ```
@@ -99,33 +200,25 @@ relative to the shell's current directory; file paths inside those results and
 recipe image paths are workspace-relative unless absolute.
 
 `request.json` names a capability, prompt, imported input artifacts and output
-contract. The execute result is a handoff when the session is selected; it is not
-a generated image. Run the native tool once and register its real files or JSON
-value. Preparation, imports and registration do not need a 12ui account. Read
-[the session reference](skills/12ui-design/session.md) for the complete contract,
-provider policy, MCP equivalents and interruption behavior.
-
-The skill's `scene.md` guide rebuilds a design image as a live Three.js scene
-with the local `12ui scene` tools (`12ui scene --help`): camera solve, placement,
-a starter harness with a bundled three.js, capture with the managed Chromium,
-and review sheets. It needs no account and makes no network request.
-
-The explicitly selected legacy `improve --apply` route captures the URL and
-edits the actual repository. Without a target it drafts candidates, stops for
-an explicit choice, then applies that choice locally. Without `--apply`, the existing hosted implementation-kit behavior
-remains. Inspect the real application after editing.
-
-Provider routing considers the declared host session first, then eligible Codex
-and Claude subscription CLI capabilities, then explicitly authorized OpenAI API
-and 12ui providers. Codex text/code subprocess execution requires
+contract. A host session takes only text or code: the execute result is then a
+handoff, and the session registers its real files or JSON value. Image, image-edit
+and convert work never goes to a session; the 12ui CLI runs it through its own
+providers. Preparation, imports and registration do not need a 12ui account.
+`12ui workflow --help` documents the complete contract, provider policy and
+interruption behavior.
+
+Provider routing considers a host session that declared text or code first, then
+eligible Codex and Claude subscription CLI capabilities, then explicitly authorized
+OpenAI API and 12ui providers. Image, image-edit and convert work never routes to
+a session. Codex text/code subprocess execution requires
 `--trust-codex-config`: explicit trust in the existing user's CLI configuration,
 including tools and hooks beyond the command sandbox. This does not authorize
 paid fallback and does not apply to the current session's tools. Claude requires
 supported safe mode, edits code with a fixed file-tool set without shell tests,
 and currently cannot attach images to text requests. Run checks in the parent
 session. Image capability is never inferred from a text CLI's presence.
-Session capabilities must be explicitly
-declared from available tools. Key presence alone does not authorize paid work;
+Session capabilities (text or code) must be
+explicitly declared from available tools. Key presence alone does not authorize paid work;
 `--allow-paid` is required for a funded route. An ambiguous dispatched operation
 requires reconciliation and cannot silently replay on another provider.
 An accepted job with a failed download, or a completed response with malformed
@@ -141,7 +234,7 @@ overrides from the child environment and uses the user's normal CLI configuratio
 
 The recipes `draft`, `branch`, `edit`, `redesign`, `labels`, `review`, `convert` and
 `implement` build requests for this shared ledger. They do not imply that every
-legacy hosted pipeline or native design export has a local implementation.
+hosted pipeline or native design export has a local implementation.
 After registering a recipe plan, `12ui workflow continue <operation-id> --workspace <directory>`
 prepares eligible child operations without inference; execute each
 returned ready ID explicitly, then continue the same plan to unlock dependencies.
@@ -188,90 +281,6 @@ provide an offline editor. Standard hosted `12ui convert <layerdoc.json>` does
 not read the sidecar: it requires hydrated HTTP asset references. Uploading and
 hydrating local assets remains a separate API integration.
 
-### Existing conversion and hosted commands
-
-The following APIs and legacy CLI commands remain available when explicitly
-selected. They have their own saved-run formats; their automatic engine/backend
-rules are separate from the new workflow provider policy. `convert --engine auto`
-can select hosted API before dispatch when local Codex is unavailable. Existing
-local conversion selects external images when `OPENAI_API_KEY` is set and native
-Codex images otherwise. Use an explicit engine/backend when that legacy boundary
-is intended; a key is not authorization to choose it on the user's behalf.
-
-Local HTML does not produce LayerDoc. Native design formats and hosted branch
-assembly remain dedicated conversion workflows. React export is whole-page JSX,
-not a functional application. Preserve existing legacy run directories and their
-recorded engine for recovery; importing an output into a workflow workspace does
-not migrate an in-flight legacy dispatch.
-
-The four stage skills that used to carry these sections separately —
-`design-search`, `design-draft`, `design-branch`, and `design-convert` — were
-retired on 2026-08-16 after a trial measured them buying no routing precision
-over the one broadened description. `skill install` removes any copy still
-present in an agent home.
-
-For an explicitly authorized legacy hosted run, corpus-conditioned image generation explores visual directions. The selected
-image then guides editable implementation, with browser inspection against the
-approved target and focused correction of observed mismatches.
-
-```bash
-12ui skill status --json
-12ui corpus inspire \
-  --query "Editorial architecture homepage with warm materiality" \
-  --reference-image ./current-homepage.png \
-  --out-dir ./references \
-  --count 4
-12ui draft \
-  --concept "Editorial architecture homepage with warm materiality" \
-  --reference ./current-homepage.png \
-  --retain style \
-  --candidates 4
-12ui next <run-dir> --wait
-12ui branch execute \
-  --start <run-dir>/candidates/A.png \
-  --concept "Editorial architecture studio site" \
-  --scope site \
-  --convert html \
-  --prototype
-12ui next <branch-run-dir> --wait
-12ui improve https://example.com/dashboard \
-  --direction "Editorial hierarchy, compact controls, quiet blue surfaces" \
-  --repo ./dashboard \
-  --out-dir ./dashboard-improve
-12ui improve https://example.com/dashboard \
-  --target ./approved-dashboard.png \
-  --repo ./dashboard \
-  --out-dir ./dashboard-align
-12ui convert <conversion-id> \
-  --output html_fixed,pdf,psd,pptx,sketch \
-  --out-dir ./exports
-```
-
-`draft` accepts 2-16 candidates and defaults to four. `--reference` accepts a
-local PNG/JPEG/WebP path or HTTP(S) URL, keeps the normal corpus retrieval, and
-sends the original image to every hosted candidate. Its new-page default retains
-style while excluding layout, content, and assets; `--retain layout` is the
-explicit source-geometry opt-in. It records the corpus set,
-hosted run id, stable service slots, output paths, and claim key in `draft.json`
-before dispatch. Every dispatch request stays in the foreground and posts only
-slots whose durable service state is still `pending`; in-flight, succeeded, and
-failed slots are never posted again. `12ui next <run-dir> --wait` repairs only
-never-started slots, then polls and downloads. Successful PNGs are digest-checked and written atomically under
-`<run-dir>/candidates/`, with terminal evidence in `draft.complete.json`.
-
-The legacy `draft` command never inspects Codex authentication, `OPENAI_API_KEY`,
-project `.env` files, or another caller-side image-provider credential. This
-boundary describes legacy hosted draft, not the new `workflow draft` recipe.
-
-`convert <conversion-id>` downloads one successful base LayerDoc once and
-dispatches the chosen formats concurrently. It creates the destination
-directory as needed, but refuses before any API request when a selected output,
-its asset directory, or `export-manifest.json` already exists.
-
-`capabilities --json` reports the CLI's exact inputs and outputs, model and
-responsive-quality choices, duration hints, status commands, and durable
-journal/receipt contracts.
-
 ## Design Corpus inspiration
 
 `TwelveUiCorpusClient` supports public status, inspiration and logo searches,
@@ -303,7 +312,7 @@ const image = await corpus.download(first.id, 'ref-hd');
 
 Every inspiration request requires a stable idempotency key. See
 [`docs/corpus-v1.openapi.yaml`](https://github.com/just-every/12ui-plugin/blob/main/docs/corpus-v1.openapi.yaml).
-`download` accepts `thumb`, `thumb-hd`, `ref`, and `ref-hd`; the legacy
+`download` accepts `thumb`, `thumb-hd`, `ref`, and `ref-hd`; the original
 `thumb`/`ref` sizes remain supported.
 
 For agent workflows that need four reference images,
@@ -461,7 +470,7 @@ DOM candidates, known destinations and source HTML/plan/completion before build.
 Generic image `workflow labels` annotations cannot be substituted. Duplicate IDs,
 unknown destinations and contradictory action fields are rejected before immutable
 workflow success. Native local pages permit only navigation to real pages or none.
-Legacy branch resume refuses to replace this pause with hosted labeling.
+`12ui branch resume` refuses to replace this pause with hosted labeling.
 
 The manifest preserves source custody, operation IDs and actual provider/funding/
 usage facts. `labels.costMicros` counts new hosted prototype-label calls only;
@@ -930,8 +939,9 @@ plan, never an API key) and searches the free reference corpus. Twelve tools:
 
 A hand-off records the request durably (Branch: your words, verbatim; Convert: the format and its
 options) with a verified copy of the image, and sends the agent a short message. The agent reads
-the record with `design.slate.data`, carries it out through the free local routes, and asks you
-before anything that uses your 12ui credits (a conversion to LayerDoc, fixed HTML, SVG, PDF, PSD and
+the record with `design.slate.data` and runs the filled-in `12ui` command it names (`12ui branch
+execute` for a Branch, `12ui convert` for a Convert), and asks you before anything that uses your
+12ui credits (a conversion to LayerDoc, fixed HTML, SVG, PDF, PSD and
 the other service formats is always that). `12ui slate-runner` is an internal command and is not
 a public surface.
 
@@ -953,7 +963,7 @@ network access (`-c sandbox_workspace_write.network_access=true`) and the 12ui s
 (`--add-dir ~/.local/share/12ui`, which the workspace writes to) runs everything, Design and Edit
 included; full access needs none of it.
 
-Among these tools, only legacy `design.convert` creates metered work; corpus retrieval, including the
+Among these tools, only `design.convert` creates metered work; corpus retrieval, including the
 workspace's own search, is free and subject to abuse limits.
 `design.workflow.execute` can use a funded provider only with its explicit authorization policy.
 Set an `idempotencyKey` for any ambiguous conversion

package/SKILL.md

@@ -7,31 +7,36 @@ description: "Runs the complete 12UI visual-interface workflow inside Open
 
 # 12UI for Open Design
 
-Follow `skills/12ui-design/SKILL.md` and its `session.md` reference. They carry the
-same persistent local workflow used by the other clients: prepare an operation,
-execute through an available session capability, register actual output, then
-continue from saved artifacts. Keep the workspace, operation IDs, selected-image
-rationale and result manifests with the project.
-
-Explore useful distinct directions and show their actual images through Open
-Design's `twelve-ui-direction` choice surface when the user needs to choose.
-Record the selected artifact and rationale, then implement or branch that image.
-Do not substitute generic direction cards for requested design imagery.
-
-Preparation and local registration do not require 12ui authentication or spend
-approval. Before dispatching a separately funded 12ui route, use Open Design's
-`twelve-ui-spend-approval` surface for the concrete work unless the current run
-already carries that authorization. Do not infer funding authorization from a
-configured key. An absent, rejected or timed-out approval does not authorize
-paid work. OpenAI API funding also requires the user's explicit authorization.
-
-Use `12ui` from PATH. Otherwise use the pinned CLI from `open-design.json`:
-
-    npx -y @12ui/design@0.2.75 <command> ...
-
-A session handoff is a claim awaiting the native tool result, not completion.
-Do not repeat an uncertain dispatch or switch providers to work around it.
-Register the actual output and inspect the saved status. Use the returned code
-and assets in the project, then verify the real browser before publishing a
-preview under the user's existing authorization. Never put credentials into
-project files, plugin manifests, tool output or generated artifacts.
+`skills/12ui-design/SKILL.md` is the whole contract: it covers reference search,
+hosted candidate generation, branching an approved direction across a page,
+site, or multi-state app, and converting a finished image into LayerDoc and
+production exports. The four stage skills it replaced were retired on
+2026-08-16.
+
+For a normal interface request, follow `skills/12ui-design/SKILL.md` end to end:
+create four corpus-conditioned candidates, present their actual images through
+Open Design's `twelve-ui-direction` choice surface, record the selected slot and
+rationale in the Open Design choice, then convert or branch exactly that image.
+Do not substitute Open Design's generic direction cards for the generated 12UI
+candidates.
+
+Before the first command that can consume 12UI quota, request the declared
+`twelve-ui-spend-approval` confirmation surface with a concise description of
+the work being authorized. An approval applies only to the current run. Do not
+dispatch paid work when it is absent, rejected, or times out.
+
+Use `12ui` when it is available on `PATH`. Otherwise invoke the pinned CLI that
+the plugin's `open-design.json` MCP entry uses:
+
+    npx -y @12ui/design@0.2.77 <command> ...
+
+Run `12ui auth status --json` (or its pinned `npx` equivalent) before the paid
+preflight. A desktop user can authenticate with `12ui auth login`; a headless
+run supplies `TWELVE_UI_API_KEY`. Never put a credential into project files,
+the plugin manifest, command output, or generated artifacts.
+
+Treat the generated HTML or project export as the implementation, materialize
+it in the Open Design project workspace, and publish it as a live artifact for
+preview and critique. Preserve the 12UI run directory, chosen-image rationale,
+conversion IDs, and export manifests with the project so reruns can resume
+settled work instead of buying it again.

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

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

package/dist/cli-arguments.js

@@ -37,27 +37,41 @@ export const parseCliArguments = (argv) => {
                 command.push(value);
             continue;
         }
-        const name = value.slice(2);
+        // `--name=value` carries its value in the same token, so a value that
+        // starts with "-" (`--orbit=-15,15`) needs no quoting tricks. The run
+        // journal's normalizeArgv already reads this form the same way.
+        const body = value.slice(2);
+        const equals = body.indexOf('=');
+        const name = equals >= 0 ? body.slice(0, equals) : body;
         if (!name)
             throw new Error('Invalid empty flag');
         if (CLI_BOOLEAN_FLAGS.has(name)) {
+            if (equals >= 0)
+                throw new Error(`--${name} takes no value; drop "=${body.slice(equals + 1)}"`);
             flags[name] = true;
             continue;
         }
-        const next = argv[index + 1];
-        if (!next || next.startsWith('--'))
-            throw new Error(`--${name} requires a value`);
+        let flagValue;
+        if (equals >= 0) {
+            flagValue = body.slice(equals + 1);
+        }
+        else {
+            const next = argv[index + 1];
+            if (!next || next.startsWith('--'))
+                throw new Error(`--${name} requires a value`);
+            flagValue = next;
+            index += 1;
+        }
         if ((name === 'bootstrap' || name === 'page') && flags[name] !== undefined) {
             const current = flags[name];
             flags[name] = [
                 ...(Array.isArray(current) ? current : typeof current === 'string' ? [current] : []),
-                next,
+                flagValue,
             ];
         }
         else {
-            flags[name] = next;
+            flags[name] = flagValue;
         }
-        index += 1;
     }
     return { command, flags };
 };

package/dist/cli-arguments.js.map

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

package/dist/cli-capabilities.d.ts

@@ -7,7 +7,8 @@ export declare const CLI_CAPABILITIES: {
         readonly capabilities: readonly ["text", "image", "image-edit", "code", "convert"];
         readonly workspace: "Required persistent local directory except for provider discovery.";
         readonly preparation: "Prepare and recipe commands record work without model dispatch; execute chooses a provider.";
-        readonly session: "Declare session capabilities explicitly; execute returns a handoff and register records its result with the exact --attempt number.";
+        readonly session: "Declare session capabilities explicitly (text or code only); execute returns a handoff and register records its result with the exact --attempt number.";
+        readonly generation: "image, image-edit and convert always run through the 12ui CLI's own providers, never a host session.";
         readonly codexConfiguration: "Codex child execution requires --trust-codex-config, including trust in configured tools and hooks. This does not authorize paid fallbacks.";
         readonly paidProviders: "openai and 12ui require explicit --allow-paid permission; available credentials do not authorize spending.";
         readonly recovery: "Ambiguous dispatched work requires reconciliation and never silently falls through to another provider.";
@@ -52,7 +53,7 @@ export declare const CLI_CAPABILITIES: {
     /** Local helpers for rebuilding a design image as a live Three.js scene (the 12ui-design skill's scene.md). */
     readonly localScene: {
         readonly command: "12ui scene <verb>";
-        readonly verbs: readonly ["init", "solve", "ray", "project", "rect", "serve", "capture", "sheet", "blend", "colors", "rectify"];
+        readonly verbs: readonly ["init", "solve", "ray", "project", "rect", "serve", "capture", "sheet", "blend", "colors", "rectify", "merge"];
         readonly network: "none";
         readonly browser: "managed Chromium for capture";
         readonly skill: "12ui-design";

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

@@ -1 +1 @@
-{"version":3,"file":"cli-capabilities.d.ts","sourceRoot":"","sources":["../src/cli-capabilities.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuD3B,+GAA+G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkD/G;;;;;OAKG;;;;;;;;;;;IAeH;;;;;;OAMG;;;;;;;QAUD,iFAAiF;;;IAGnF;;;;;;OAMG;;;QAGD,yEAAyE;;;;;QASzE,6EAA6E;;QAE7E,6EAA6E;;;;;;;IAO/E,uEAAuE;;;;;;;;;;;;QAYrE;;;WAGG;;;;;;;;;;;;;;;;;;CAkBG,CAAC"}
+{"version":3,"file":"cli-capabilities.d.ts","sourceRoot":"","sources":["../src/cli-capabilities.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwD3B,+GAA+G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkD/G;;;;;OAKG;;;;;;;;;;;IAeH;;;;;;OAMG;;;;;;;QAUD,iFAAiF;;;IAGnF;;;;;;OAMG;;;QAGD,yEAAyE;;;;;QASzE,6EAA6E;;QAE7E,6EAA6E;;;;;;;IAO/E,uEAAuE;;;;;;;;;;;;QAYrE;;;WAGG;;;;;;;;;;;;;;;;;;CAkBG,CAAC"}

package/dist/cli-capabilities.js

@@ -15,7 +15,8 @@ export const CLI_CAPABILITIES = {
         capabilities: ['text', 'image', 'image-edit', 'code', 'convert'],
         workspace: 'Required persistent local directory except for provider discovery.',
         preparation: 'Prepare and recipe commands record work without model dispatch; execute chooses a provider.',
-        session: 'Declare session capabilities explicitly; execute returns a handoff and register records its result with the exact --attempt number.',
+        session: 'Declare session capabilities explicitly (text or code only); execute returns a handoff and register records its result with the exact --attempt number.',
+        generation: 'image, image-edit and convert always run through the 12ui CLI\'s own providers, never a host session.',
         codexConfiguration: 'Codex child execution requires --trust-codex-config, including trust in configured tools and hooks. This does not authorize paid fallbacks.',
         paidProviders: 'openai and 12ui require explicit --allow-paid permission; available credentials do not authorize spending.',
         recovery: 'Ambiguous dispatched work requires reconciliation and never silently falls through to another provider.',

package/dist/cli-capabilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-capabilities.js","sourceRoot":"","sources":["../src/cli-capabilities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-capabilities.js","sourceRoot":"","sources":["../src/cli-capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EACL,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,+BAA+B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE;QACR,MAAM,EAAE,iBAAiB;QACzB,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC;QACrI,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC;QAC5F,SAAS,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC;QAC3D,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC;QAChE,SAAS,EAAE,oEAAoE;QAC/E,WAAW,EAAE,6FAA6F;QAC1G,OAAO,EAAE,yJAAyJ;QAClK,UAAU,EAAE,uGAAuG;QACnH,kBAAkB,EAAE,6IAA6I;QACjK,aAAa,EAAE,4GAA4G;QAC3H,QAAQ,EAAE,yGAAyG;QACnH,cAAc,EAAE,mEAAmE;QACnF,QAAQ,EAAE,iJAAiJ;KAC5J;IACD,MAAM,EAAE;QACN,cAAc,EAAE,kGAAkG;QAClH,KAAK,EAAE,mEAAmE;QAC1E,WAAW,EAAE,UAAU;QACvB,uBAAuB,EAAE,EAAE;QAC3B,WAAW,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC;QACjD,KAAK,EAAE,sFAAsF;QAC7F,UAAU,EAAE,2EAA2E;QACvF,MAAM,EAAE,oBAAoB;KAC7B;IACD,MAAM,EAAE;QACN,WAAW;QACX,YAAY;QACZ,YAAY;QACZ,6BAA6B,CAAC,QAAQ;KACvC;IACD,OAAO,EAAE,sBAAsB;IAC/B,iBAAiB,EACf,sGAAsG;UACpG,sGAAsG;IAC1G,iBAAiB,EAAE;QACjB,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;QAChC,OAAO,EAAE,MAAM;QACf,WAAW,EAAE,kBAAkB;QAC/B,YAAY,EAAE,CAAC,MAAM,CAAC;QACtB,aAAa,EAAE,oFAAoF;KACpG;IACD,eAAe,EAAE;QACf,OAAO,EAAE,mDAAmD;QAC5D,aAAa,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;QACrC,mBAAmB,EAAE,EAAE,wBAAwB,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE;QAClF,kBAAkB,EAAE,8IAA8I;QAClK,cAAc,EAAE,KAAK;KACtB;IACD,YAAY,EAAE;QACZ,OAAO,EAAE,gEAAgE;QACzE,aAAa,EAAE,mFAAmF;QAClG,YAAY,EAAE,0DAA0D;KACzE;IACD,+GAA+G;IAC/G,UAAU,EAAE;QACV,OAAO,EAAE,mBAAmB;QAC5B,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,MAAM;QACf,OAAO,EAAE,8BAA8B;QACvC,KAAK,EAAE,aAAa;QACpB,KAAK,EAAE,UAAU;KAClB;IACD,WAAW,EAAE;QACX,OAAO,EAAE,0EAA0E;QACnF,OAAO,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC;QACzD,KAAK,EAAE,gEAAgE;KACxE;IACD,WAAW,EAAE,iBAAiB;IAC9B,gBAAgB,EAAE;QAChB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,sBAAsB;QAC/B,WAAW,EAAE,uFAAuF;KACrG;IACD,qDAAqD;IACrD,OAAO,EAAE;QACP,KAAK,EAAE,CAAC,WAAW,EAAE,gBAAgB,CAAC;QACtC,QAAQ,EAAE,CAAC,YAAY,EAAE,qBAAqB,CAAC;QAC/C,iBAAiB,EAAE,CAAC;QACpB,OAAO,EAAE,mEAAmE;QAC5E,WAAW,EACT,qGAAqG;KACxG;IACD,gBAAgB,EAAE;QAChB,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,YAAY;QACrB,UAAU,EAAE,OAAO;QACnB,sBAAsB,EAAE,wBAAwB;QAChD,OAAO,EAAE,yEAAyE;QAClF,WAAW,EAAE,kPAAkP;KAChQ;IACD,mBAAmB,EAAE,+BAA+B;IACpD,eAAe,EAAE;QACf,OAAO,EAAE,yBAAyB,CAAC,OAAO;QAC1C,cAAc,EAAE,yBAAyB,CAAC,MAAM;QAChD,SAAS,EAAE,yBAAyB,CAAC,KAAK;QAC1C,oBAAoB,EAAE,wBAAwB,CAAC,oBAAoB;QACnE,WAAW,EAAE,wBAAwB,CAAC,WAAW;QACjD,YAAY,EAAE,wBAAwB,CAAC,YAAY;QACnD,aAAa,EAAE,wBAAwB,CAAC,UAAU;QAClD,aAAa,EAAE,wBAAwB,CAAC,UAAU;QAClD,iBAAiB,EAAE,wBAAwB,CAAC,OAAO;KACpD;IACD;;;;;OAKG;IACH,cAAc,EAAE;QACd,GAAG,EAAE,4BAA4B;QACjC,QAAQ,EAAE,mCAAmC;KAC9C;IACD,MAAM,EAAE;QACN,OAAO,EAAE,6BAA6B;QACtC,OAAO,EAAE,gCAAgC;QACzC,YAAY,EAAE,uBAAuB;QACrC,OAAO,EAAE;YACP,yCAAyC;YACzC,2CAA2C;YAC3C,0EAA0E;SAC3E;KACF;IACD;;;;;;OAMG;IACH,UAAU,EAAE;QACV,IAAI,EAAE,eAAe,oBAAoB,EAAE;QAC3C,aAAa,EAAE,mBAAmB;QAClC,MAAM,EAAE,4DAA4D;QACpE,SAAS,EAAE,+CAA+C;QAC1D,OAAO,EAAE;YACP,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,OAAO;YAClE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK;SAClF;QACD,iFAAiF;QACjF,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;IACD;;;;;;OAMG;IACH,iBAAiB,EAAE;QACjB,KAAK,EAAE,2CAA2C;QAClD,yEAAyE;QACzE,YAAY,EAAE,gBAAgB;QAC9B,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC5B,SAAS,EAAE;YACT,+CAA+C;YAC/C,sBAAsB;YACtB,+BAA+B;SAChC;QACD,MAAM,EAAE,+BAA+B;QACvC,6EAA6E;QAC7E,MAAM,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,CAAC;QACxD,6EAA6E;QAC7E,aAAa,EAAE;YACb,IAAI,EAAE,mCAAmC;YACzC,MAAM,EAAE,iFAAiF;SAC1F;QACD,UAAU,EAAE,IAAI;KACjB;IACD,uEAAuE;IACvE,iBAAiB,EAAE;QACjB,OAAO,EAAE,sEAAsE;QAC/E,QAAQ,EAAE,yBAAyB;QACnC,qBAAqB,EAAE,oBAAoB;QAC3C,eAAe,EAAE,wBAAwB,CAAC,OAAO;KAClD;IACD,MAAM,EAAE;QACN,OAAO,EAAE,qBAAqB;QAC9B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,kBAAkB,EAAE,sBAAsB;QAC1C,QAAQ,EAAE,gBAAgB;QAC1B;;;WAGG;QACH,eAAe,EAAE;YACf,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,+BAA+B;YACxC,OAAO,EAAE,EAAE;SACZ;QACD,sBAAsB,EAAE,wBAAwB,CAAC,aAAa;KAC/D;IACD,SAAS,EAAE;QACT,OAAO,EAAE,0BAA0B;QACnC,UAAU,EAAE,uCAAuC;QACnD,UAAU,EAAE,2DAA2D;QACvE,MAAM,EAAE,4CAA4C;QACpD,WAAW,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;QACtD,UAAU,EAAE,yOAAyO;QACrP,UAAU,EAAE,mGAAmG;QAC/G,SAAS,EAAE,CAAC,kBAAkB,EAAE,+DAA+D,CAAC;KACjG;CACO,CAAC"}

package/dist/cli-codex-readiness.d.ts

@@ -1,3 +1,4 @@
+import type { SlateServerMessageCode } from './slate-view-contract.js';
 /** `codex features list` prints `<name>  <stage>  <true|false>` per feature; image generation must be on. */
 export declare const imageGenerationEnabled: (featuresList: string) => boolean;
 /** Which check decided the probe: `ready`, or the first one that failed. Callers word their own sentence from it. */
@@ -8,6 +9,11 @@ export type CodexReadiness = {
     check: CodexReadinessCheck;
     codexBin: string;
     codexHome: string;
+    /**
+     * The reason as a person reads it on the Design workspace screen (`server.<code>`): `reason` is for the operator and
+     * names flags and files; this names what to do. Absent when ready.
+     */
+    personCode?: SlateServerMessageCode;
     /** What `codex --version` printed, once it ran. */
     version?: string;
 };

package/dist/cli-codex-readiness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-codex-readiness.d.ts","sourceRoot":"","sources":["../src/cli-codex-readiness.ts"],"names":[],"mappings":"AAeA,6GAA6G;AAC7G,eAAO,MAAM,sBAAsB,GAAI,cAAc,MAAM,KAAG,OAE7D,CAAC;AASF,qHAAqH;AACrH,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,QAAQ,GAAG,kBAAkB,CAAC;AAErI,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAChG,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CA0CnJ"}
+{"version":3,"file":"cli-codex-readiness.d.ts","sourceRoot":"","sources":["../src/cli-codex-readiness.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AASvE,6GAA6G;AAC7G,eAAO,MAAM,sBAAsB,GAAI,cAAc,MAAM,KAAG,OAE7D,CAAC;AASF,qHAAqH;AACrH,MAAM,MAAM,mBAAmB,GAC3B,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,QAAQ,GAAG,kBAAkB,CAAC;AAErI,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAChG;;;OAGG;IACH,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CA0CnJ"}

package/dist/cli-codex-readiness.js

@@ -27,10 +27,10 @@ export async function probeCodexReadiness(options = {}) {
     const codexHome = path.resolve(options.codexHome ?? (source.CODEX_HOME?.trim() || path.join(homedir(), '.codex')));
     const located = options.codexBin ?? locateCodexBinary(source)?.binary;
     if (located === undefined)
-        return { ready: false, reason: NO_CODEX_BINARY_REASON, check: 'no_binary', codexBin: '', codexHome };
+        return { ready: false, reason: NO_CODEX_BINARY_REASON, check: 'no_binary', personCode: 'codex_missing', codexBin: '', codexHome };
     const codexBin = located;
     let version;
-    const result = (check, reason) => ({ ready: check === 'ready', reason, check, codexBin, codexHome, ...(version ? { version } : {}) });
+    const result = (check, reason, personCode) => ({ ready: check === 'ready', reason, check, ...(personCode ? { personCode } : {}), codexBin, codexHome, ...(version ? { version } : {}) });
     // Match the runtime's subscription environment: no provider API credentials.
     const env = { CODEX_HOME: codexHome };
     for (const key of ['PATH', 'HOME', 'TMPDIR', 'TEMP', 'TMP', 'LANG', 'LC_ALL', 'SYSTEMROOT']) {
@@ -41,31 +41,31 @@ export async function probeCodexReadiness(options = {}) {
         version = (await inspect(codexBin, ['--version'], env)).trim().replace(/^codex-cli\s+/u, '').split('\n')[0]?.trim() || undefined;
     }
     catch {
-        return result('binary', 'Codex CLI could not run. Install Codex on PATH or pass --codex-bin with a working executable.');
+        return result('binary', 'Codex CLI could not run. Install Codex on PATH or pass --codex-bin with a working executable.', 'codex_broken');
     }
     try {
         await access(path.join(codexHome, 'auth.json'), constants.R_OK);
     }
     catch {
-        return result('auth_file', 'Selected Codex home has no readable auth.json. Run codex login with this CODEX_HOME, or select your authenticated home with --codex-home.');
+        return result('auth_file', 'Selected Codex home has no readable auth.json. Run codex login with this CODEX_HOME, or select your authenticated home with --codex-home.', 'codex_signed_out');
     }
     try {
         const login = await inspect(codexBin, ['login', 'status'], env);
         if (!login.includes('Logged in using ChatGPT')) {
-            return result('chatgpt_login', 'Codex conversion requires ChatGPT authentication. Run codex login with the selected CODEX_HOME; API-key login is not supported.');
+            return result('chatgpt_login', 'Codex conversion requires ChatGPT authentication. Run codex login with the selected CODEX_HOME; API-key login is not supported.', 'codex_api_key');
         }
     }
     catch {
-        return result('login_status', 'Codex login status failed. Run codex login with the selected CODEX_HOME and retry.');
+        return result('login_status', 'Codex login status failed. Run codex login with the selected CODEX_HOME and retry.', 'codex_login_unknown');
     }
     try {
         const help = await inspect(codexBin, ['exec', '--help'], env);
         const missing = requiredExecFlags.filter(flag => !new RegExp(`${flag}(?=[\\s=,]|$)`).test(help));
         if (missing.length)
-            return result('exec_flags', `Codex CLI lacks required conversion flags: ${missing.join(', ')}. Update Codex or select a compatible executable with --codex-bin.`);
+            return result('exec_flags', `Codex CLI lacks required conversion flags: ${missing.join(', ')}. Update Codex or select a compatible executable with --codex-bin.`, 'codex_outdated');
     }
     catch {
-        return result('exec_flags', 'Codex exec --help failed. Update Codex or select a compatible executable with --codex-bin.');
+        return result('exec_flags', 'Codex exec --help failed. Update Codex or select a compatible executable with --codex-bin.', 'codex_outdated');
     }
     try {
         const cache = JSON.parse(await readFile(path.join(codexHome, 'models_cache.json'), 'utf8'));
@@ -74,18 +74,18 @@ export async function probeCodexReadiness(options = {}) {
             && Array.isArray(model.supported_reasoning_levels)
             && model.supported_reasoning_levels.some((level) => level?.effort === 'low'));
         if (!available)
-            return result('models', 'The selected Codex model cache does not list gpt-6-astra with low reasoning. Refresh Codex model availability for this ChatGPT account, then retry.');
+            return result('models', 'The selected Codex model cache does not list gpt-6-astra with low reasoning. Refresh Codex model availability for this ChatGPT account, then retry.', 'codex_model_missing');
     }
     catch {
-        return result('models', 'Selected Codex home has no readable, valid models_cache.json. Open Codex with this CODEX_HOME to refresh its model cache, then retry.');
+        return result('models', 'Selected Codex home has no readable, valid models_cache.json. Open Codex with this CODEX_HOME to refresh its model cache, then retry.', 'codex_model_missing');
     }
     try {
         if (!imageGenerationEnabled(await inspect(codexBin, ['features', 'list'], env))) {
-            return result('image_generation', 'Codex image generation is not enabled for this Codex home (codex features list shows image_generation off).');
+            return result('image_generation', 'Codex image generation is not enabled for this Codex home (codex features list shows image_generation off).', 'codex_images_off');
         }
     }
     catch {
-        return result('image_generation', 'Codex features list failed. Update Codex or select a compatible executable with --codex-bin.');
+        return result('image_generation', 'Codex features list failed. Update Codex or select a compatible executable with --codex-bin.', 'codex_outdated');
     }
     return result('ready', 'Codex CLI, ChatGPT login, required flags, cached gpt-6-astra low availability, and image generation are ready.');
 }