@12ui/design 0.2.26 → 0.2.28

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

@@ -0,0 +1,30 @@
+export declare const CONVERSION_HELP: {
+    readonly convert: {
+        readonly summary: "Convert one visual file, or compose ordered viewport images into complete pages.";
+        readonly sections: readonly [{
+            readonly heading: "Single-file conversion";
+            readonly items: readonly ["Accepts PNG, JPEG, WebP, public LayerDoc v2 JSON, or a finished conversion ID.", "Image input waits, streams progress, and downloads results. --output html writes both the LayerDoc and responsive HTML through the fused path.", "Conversion-id input requires --out-dir and derives comma-separated formats concurrently without another image conversion.", "Image inputs support --model and proportional --width. Responsive HTML supports --responsive-quality."];
+        }, {
+            readonly heading: "Package conversion";
+            readonly items: readonly ["`12ui convert package` preserves ordered viewport slices and composes them into scrolling pages.", "`12ui convert package --template` prints a valid starter manifest without authentication or network access."];
+        }];
+    };
+    readonly 'convert package': {
+        readonly summary: "Convert ordered viewport images and compose them into complete scrolling pages.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly ["Reads a manifest containing one or more pages, converts each page’s ordered viewports, and writes page outputs plus package.result.json.", "Viewport image paths are relative to the manifest. sourceConversionId reuses an existing conversion of the same bytes.", "Blocks until terminal and refuses an output directory that already contains a package result."];
+        }, {
+            readonly heading: "Template mode";
+            readonly items: readonly ["--template prints starter JSON to stdout and guidance to stderr, then exits before reading credentials or contacting the service."];
+        }];
+    };
+    readonly resume: {
+        readonly summary: "Recover every artifact in an original conversion purchase.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly ["With only a conversion ID, restores the conversion and any linked fused export to their original filenames and directories.", "--out-dir keeps the original basenames but writes the recovered purchase into another directory.", "The optional --output plus --out power form collects one named operation from an older or externally-created purchase.", "Collects existing work only: it never retries, reconfigures, changes format, or creates a conversion."];
+        }];
+    };
+};
+//# sourceMappingURL=conversion.d.ts.map

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

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

package/dist/cli-help/conversion.js

@@ -0,0 +1,55 @@
+export const CONVERSION_HELP = {
+    convert: {
+        summary: 'Convert one visual file, or compose ordered viewport images into complete pages.',
+        sections: [
+            {
+                heading: 'Single-file conversion',
+                items: [
+                    'Accepts PNG, JPEG, WebP, public LayerDoc v2 JSON, or a finished conversion ID.',
+                    'Image input waits, streams progress, and downloads results. --output html writes both the LayerDoc and responsive HTML through the fused path.',
+                    'Conversion-id input requires --out-dir and derives comma-separated formats concurrently without another image conversion.',
+                    'Image inputs support --model and proportional --width. Responsive HTML supports --responsive-quality.',
+                ],
+            },
+            {
+                heading: 'Package conversion',
+                items: [
+                    '`12ui convert package` preserves ordered viewport slices and composes them into scrolling pages.',
+                    '`12ui convert package --template` prints a valid starter manifest without authentication or network access.',
+                ],
+            },
+        ],
+    },
+    'convert package': {
+        summary: 'Convert ordered viewport images and compose them into complete scrolling pages.',
+        sections: [
+            {
+                heading: 'Behavior',
+                items: [
+                    'Reads a manifest containing one or more pages, converts each page’s ordered viewports, and writes page outputs plus package.result.json.',
+                    'Viewport image paths are relative to the manifest. sourceConversionId reuses an existing conversion of the same bytes.',
+                    'Blocks until terminal and refuses an output directory that already contains a package result.',
+                ],
+            },
+            {
+                heading: 'Template mode',
+                items: [
+                    '--template prints starter JSON to stdout and guidance to stderr, then exits before reading credentials or contacting the service.',
+                ],
+            },
+        ],
+    },
+    resume: {
+        summary: 'Recover every artifact in an original conversion purchase.',
+        sections: [{
+                heading: 'Behavior',
+                items: [
+                    'With only a conversion ID, restores the conversion and any linked fused export to their original filenames and directories.',
+                    '--out-dir keeps the original basenames but writes the recovered purchase into another directory.',
+                    'The optional --output plus --out power form collects one named operation from an older or externally-created purchase.',
+                    'Collects existing work only: it never retries, reconfigures, changes format, or creates a conversion.',
+                ],
+            }],
+    },
+};
+//# sourceMappingURL=conversion.js.map

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

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

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

@@ -0,0 +1,74 @@
+export declare const DESIGN_HELP: {
+    readonly corpus: {
+        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 '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 in balanced mode; --count accepts 1–48.", "--reference-image conditions retrieval on an existing PNG, JPEG, or WebP."];
+        }, {
+            readonly heading: "Modes";
+            readonly items: readonly ["direct stays closest to the literal query.", "balanced is the default relevance, quality, and variety trade-off.", "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, changed reference inputs, and incompatible evidence are refused rather than redispatched."];
+        }];
+    };
+    readonly draft: {
+        readonly summary: "Retrieve references and generate first-viewport UI candidates.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly ["Creates a resumable temporary run directory, prints it first, pairs one balanced corpus reference with each candidate, and claims one hosted /api/v1/create run.", "--candidates accepts 2–16 and defaults to four; prefer at least four distinct directions.", "Each service slot is dispatched at most once and its real PNG downloads into <run-dir>/candidates/. Generation continues in the background unless --wait is supplied.", "Defaults to landscape. Authentication is 12ui-only; no Codex session or caller-side image-provider key is read."];
+        }, {
+            readonly heading: "Redesign modes";
+            readonly items: readonly ["Without --redesign-source, creates a new interface.", "exploratory conditions retrieval on the source but uses the returned references as loose generation inspiration.", "reskin uses the source for every candidate and asks the provider to preserve its structure."];
+        }, {
+            readonly heading: "Next";
+            readonly items: readonly ["Run `12ui next <run-dir>` to follow generation. Convert one chosen image, or pass it to `12ui branch execute --start`."];
+        }];
+    };
+    readonly branch: {
+        readonly summary: "Expand one approved first-view design into a complete page or small site.";
+        readonly sections: readonly [{
+            readonly heading: "Actions";
+            readonly items: readonly ["execute — plan and generate screens, optionally converting complete pages to responsive HTML.", "resume — continue an incomplete branch from its durable recorded state."];
+        }];
+    };
+    readonly 'branch execute': {
+        readonly summary: "Plan and generate the rest of an approved page or site.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly ["Starts from the PNG, JPEG, or WebP named by --start and creates a unique run directory when --out-dir is omitted.", "scope page grows one continuous page; scope site also plans sibling pages.", "With --convert html, each complete page is converted as one ordered viewport package while other work continues.", "Runs in the background unless --wait or --dry-run is supplied. Screens and converted pages land beneath the branch directory."];
+        }, {
+            readonly heading: "Controls";
+            readonly items: readonly ["--max-screens keeps the first N planned screens and records what was omitted.", "--page-concurrency allows 1–10 simultaneous page conversions and defaults to 3. --source-conversion-id reuses a proven source conversion.", "--dry-run validates inputs and prints the run identity and estimate without claiming or buying work."];
+        }, {
+            readonly heading: "Next";
+            readonly items: readonly ["Run `12ui next <run-dir>` to inspect durable progress."];
+        }];
+    };
+    readonly 'branch resume': {
+        readonly summary: "Continue an incomplete branch using its original durable inputs.";
+        readonly sections: readonly [{
+            readonly heading: "Safety";
+            readonly items: readonly ["Reloads the recorded winner, concept, scope, screen cap, conversion settings, and run identity.", "Reuses settled screens and verifies that a local winner image has not changed.", "A run that never started or already has a terminal completion record cannot be resumed. Resume detaches unless --wait is supplied."];
+        }];
+    };
+    readonly next: {
+        readonly summary: "Read durable status and report the one useful command to run next.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly ["Recognizes draft and branch directories, hosted run IDs, conversion IDs, and journal-backed workspaces.", "Never starts, retries, or resumes work. Human status is the default; --json writes the machine record to stdout and suppresses the human progress stream.", "--wait 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."];
+        }];
+    };
+};
+//# sourceMappingURL=design.d.ts.map

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

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

package/dist/cli-help/design.js

@@ -0,0 +1,131 @@
+export const DESIGN_HELP = {
+    corpus: {
+        summary: 'Search the Design Corpus or resume a durable reference-retrieval attempt.',
+        sections: [{
+                heading: 'Actions',
+                items: [
+                    'inspire — retrieve and download visual references for a design problem.',
+                    'resume — finish an interrupted retrieval from its saved attempt state.',
+                ],
+            }],
+    },
+    'corpus inspire': {
+        summary: 'Search the Design Corpus and download validated visual references.',
+        sections: [
+            {
+                heading: 'Behavior',
+                items: [
+                    '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 in balanced mode; --count accepts 1–48.',
+                    '--reference-image conditions retrieval on an existing PNG, JPEG, or WebP.',
+                ],
+            },
+            {
+                heading: 'Modes',
+                items: [
+                    'direct stays closest to the literal query.',
+                    'balanced is the default relevance, quality, and variety trade-off.',
+                    'adventurer keeps a relevant head while exploring less expected directions.',
+                ],
+            },
+        ],
+    },
+    'corpus resume': {
+        summary: 'Continue an incomplete corpus retrieval from its durable output directory.',
+        sections: [{
+                heading: 'Safety',
+                items: [
+                    'Reuses the saved request and idempotency key, preserves verified downloads, and fetches only what remains.',
+                    'Completed attempts, changed reference inputs, and incompatible evidence are refused rather than redispatched.',
+                ],
+            }],
+    },
+    draft: {
+        summary: 'Retrieve references and generate first-viewport UI candidates.',
+        sections: [
+            {
+                heading: 'Behavior',
+                items: [
+                    'Creates a resumable temporary run directory, prints it first, pairs one balanced corpus reference with each candidate, and claims one hosted /api/v1/create run.',
+                    '--candidates accepts 2–16 and defaults to four; prefer at least four distinct directions.',
+                    'Each service slot is dispatched at most once and its real PNG downloads into <run-dir>/candidates/. Generation continues in the background unless --wait is supplied.',
+                    'Defaults to landscape. Authentication is 12ui-only; no Codex session or caller-side image-provider key is read.',
+                ],
+            },
+            {
+                heading: 'Redesign modes',
+                items: [
+                    'Without --redesign-source, creates a new interface.',
+                    'exploratory conditions retrieval on the source but uses the returned references as loose generation inspiration.',
+                    'reskin uses the source for every candidate and asks the provider to preserve its structure.',
+                ],
+            },
+            {
+                heading: 'Next',
+                items: [
+                    'Run `12ui next <run-dir>` to follow generation. Convert one chosen image, or pass it to `12ui branch execute --start`.',
+                ],
+            },
+        ],
+    },
+    branch: {
+        summary: 'Expand one approved first-view design into a complete page or small site.',
+        sections: [{
+                heading: 'Actions',
+                items: [
+                    'execute — plan and generate screens, optionally converting complete pages to responsive HTML.',
+                    'resume — continue an incomplete branch from its durable recorded state.',
+                ],
+            }],
+    },
+    'branch execute': {
+        summary: 'Plan and generate the rest of an approved page or site.',
+        sections: [
+            {
+                heading: 'Behavior',
+                items: [
+                    'Starts from the PNG, JPEG, or WebP named by --start and creates a unique run directory when --out-dir is omitted.',
+                    'scope page grows one continuous page; scope site also plans sibling pages.',
+                    'With --convert html, each complete page is converted as one ordered viewport package while other work continues.',
+                    'Runs in the background unless --wait or --dry-run is supplied. Screens and converted pages land beneath the branch directory.',
+                ],
+            },
+            {
+                heading: 'Controls',
+                items: [
+                    '--max-screens keeps the first N planned screens and records what was omitted.',
+                    '--page-concurrency allows 1–10 simultaneous page conversions and defaults to 3. --source-conversion-id reuses a proven source conversion.',
+                    '--dry-run validates inputs and prints the run identity and estimate without claiming or buying work.',
+                ],
+            },
+            {
+                heading: 'Next',
+                items: ['Run `12ui next <run-dir>` to inspect durable progress.'],
+            },
+        ],
+    },
+    'branch resume': {
+        summary: 'Continue an incomplete branch using its original durable inputs.',
+        sections: [{
+                heading: 'Safety',
+                items: [
+                    'Reloads the recorded winner, concept, scope, screen cap, conversion settings, and run identity.',
+                    'Reuses settled screens and verifies that a local winner image has not changed.',
+                    'A run that never started or already has a terminal completion record cannot be resumed. Resume detaches unless --wait is supplied.',
+                ],
+            }],
+    },
+    next: {
+        summary: 'Read durable status and report the one useful command to run next.',
+        sections: [{
+                heading: 'Behavior',
+                items: [
+                    'Recognizes draft and branch directories, hosted run IDs, conversion IDs, and journal-backed workspaces.',
+                    'Never starts, retries, or resumes work. Human status is the default; --json writes the machine record to stdout and suppresses the human progress stream.',
+                    '--wait 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.',
+                ],
+            }],
+    },
+};
+//# sourceMappingURL=design.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"design.js","sourceRoot":"","sources":["../../src/cli-help/design.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE;QACN,OAAO,EAAE,2EAA2E;QACpF,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,SAAS;gBAClB,KAAK,EAAE;oBACL,yEAAyE;oBACzE,wEAAwE;iBACzE;aACF,CAAC;KACH;IACD,gBAAgB,EAAE;QAChB,OAAO,EAAE,oEAAoE;QAC7E,QAAQ,EAAE;YACR;gBACE,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE;oBACL,gJAAgJ;oBAChJ,qEAAqE;oBACrE,2EAA2E;iBAC5E;aACF;YACD;gBACE,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE;oBACL,4CAA4C;oBAC5C,oEAAoE;oBACpE,4EAA4E;iBAC7E;aACF;SACF;KACF;IACD,eAAe,EAAE;QACf,OAAO,EAAE,4EAA4E;QACrF,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,QAAQ;gBACjB,KAAK,EAAE;oBACL,4GAA4G;oBAC5G,+GAA+G;iBAChH;aACF,CAAC;KACH;IACD,KAAK,EAAE;QACL,OAAO,EAAE,gEAAgE;QACzE,QAAQ,EAAE;YACR;gBACE,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE;oBACL,kKAAkK;oBAClK,2FAA2F;oBAC3F,uKAAuK;oBACvK,iHAAiH;iBAClH;aACF;YACD;gBACE,OAAO,EAAE,gBAAgB;gBACzB,KAAK,EAAE;oBACL,qDAAqD;oBACrD,kHAAkH;oBAClH,6FAA6F;iBAC9F;aACF;YACD;gBACE,OAAO,EAAE,MAAM;gBACf,KAAK,EAAE;oBACL,wHAAwH;iBACzH;aACF;SACF;KACF;IACD,MAAM,EAAE;QACN,OAAO,EAAE,2EAA2E;QACpF,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,SAAS;gBAClB,KAAK,EAAE;oBACL,+FAA+F;oBAC/F,yEAAyE;iBAC1E;aACF,CAAC;KACH;IACD,gBAAgB,EAAE;QAChB,OAAO,EAAE,yDAAyD;QAClE,QAAQ,EAAE;YACR;gBACE,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE;oBACL,mHAAmH;oBACnH,4EAA4E;oBAC5E,kHAAkH;oBAClH,+HAA+H;iBAChI;aACF;YACD;gBACE,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE;oBACL,+EAA+E;oBAC/E,2IAA2I;oBAC3I,sGAAsG;iBACvG;aACF;YACD;gBACE,OAAO,EAAE,MAAM;gBACf,KAAK,EAAE,CAAC,wDAAwD,CAAC;aAClE;SACF;KACF;IACD,eAAe,EAAE;QACf,OAAO,EAAE,kEAAkE;QAC3E,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,QAAQ;gBACjB,KAAK,EAAE;oBACL,iGAAiG;oBACjG,gFAAgF;oBAChF,oIAAoI;iBACrI;aACF,CAAC;KACH;IACD,IAAI,EAAE;QACJ,OAAO,EAAE,oEAAoE;QAC7E,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,UAAU;gBACnB,KAAK,EAAE;oBACL,yGAAyG;oBACzG,2JAA2J;oBAC3J,6LAA6L;oBAC7L,qDAAqD;iBACtD;aACF,CAAC;KACH;CACgC,CAAC"}

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

@@ -0,0 +1,224 @@
+import type { CliHelpContext } from './types.js';
+export { renderHelpContext } from './render.js';
+export declare const CLI_HELP_CONTEXTS: {
+    readonly capabilities: {
+        readonly summary: "Print the machine-readable 12ui capability contract as JSON.";
+        readonly sections: readonly [{
+            readonly heading: "Includes";
+            readonly items: readonly ["Accepted inputs and outputs, models, limits, responsive qualities, project profiles, duration hints, journals, receipts, and concurrency.", "This is local and read-only; it performs no authentication, generation, conversion, or update check."];
+        }];
+    };
+    readonly mcp: {
+        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 version: {
+        readonly summary: "Print the installed 12ui package version.";
+        readonly sections: readonly [{
+            readonly heading: "Notes";
+            readonly items: readonly ["Reads the running package identity locally; it does not contact the service or check for updates."];
+        }];
+    };
+    readonly convert: {
+        readonly summary: "Convert one visual file, or compose ordered viewport images into complete pages.";
+        readonly sections: readonly [{
+            readonly heading: "Single-file conversion";
+            readonly items: readonly ["Accepts PNG, JPEG, WebP, public LayerDoc v2 JSON, or a finished conversion ID.", "Image input waits, streams progress, and downloads results. --output html writes both the LayerDoc and responsive HTML through the fused path.", "Conversion-id input requires --out-dir and derives comma-separated formats concurrently without another image conversion.", "Image inputs support --model and proportional --width. Responsive HTML supports --responsive-quality."];
+        }, {
+            readonly heading: "Package conversion";
+            readonly items: readonly ["`12ui convert package` preserves ordered viewport slices and composes them into scrolling pages.", "`12ui convert package --template` prints a valid starter manifest without authentication or network access."];
+        }];
+    };
+    readonly 'convert package': {
+        readonly summary: "Convert ordered viewport images and compose them into complete scrolling pages.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly ["Reads a manifest containing one or more pages, converts each page’s ordered viewports, and writes page outputs plus package.result.json.", "Viewport image paths are relative to the manifest. sourceConversionId reuses an existing conversion of the same bytes.", "Blocks until terminal and refuses an output directory that already contains a package result."];
+        }, {
+            readonly heading: "Template mode";
+            readonly items: readonly ["--template prints starter JSON to stdout and guidance to stderr, then exits before reading credentials or contacting the service."];
+        }];
+    };
+    readonly resume: {
+        readonly summary: "Recover every artifact in an original conversion purchase.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly ["With only a conversion ID, restores the conversion and any linked fused export to their original filenames and directories.", "--out-dir keeps the original basenames but writes the recovered purchase into another directory.", "The optional --output plus --out power form collects one named operation from an older or externally-created purchase.", "Collects existing work only: it never retries, reconfigures, changes format, or creates a conversion."];
+        }];
+    };
+    readonly corpus: {
+        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 '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 in balanced mode; --count accepts 1–48.", "--reference-image conditions retrieval on an existing PNG, JPEG, or WebP."];
+        }, {
+            readonly heading: "Modes";
+            readonly items: readonly ["direct stays closest to the literal query.", "balanced is the default relevance, quality, and variety trade-off.", "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, changed reference inputs, and incompatible evidence are refused rather than redispatched."];
+        }];
+    };
+    readonly draft: {
+        readonly summary: "Retrieve references and generate first-viewport UI candidates.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly ["Creates a resumable temporary run directory, prints it first, pairs one balanced corpus reference with each candidate, and claims one hosted /api/v1/create run.", "--candidates accepts 2–16 and defaults to four; prefer at least four distinct directions.", "Each service slot is dispatched at most once and its real PNG downloads into <run-dir>/candidates/. Generation continues in the background unless --wait is supplied.", "Defaults to landscape. Authentication is 12ui-only; no Codex session or caller-side image-provider key is read."];
+        }, {
+            readonly heading: "Redesign modes";
+            readonly items: readonly ["Without --redesign-source, creates a new interface.", "exploratory conditions retrieval on the source but uses the returned references as loose generation inspiration.", "reskin uses the source for every candidate and asks the provider to preserve its structure."];
+        }, {
+            readonly heading: "Next";
+            readonly items: readonly ["Run `12ui next <run-dir>` to follow generation. Convert one chosen image, or pass it to `12ui branch execute --start`."];
+        }];
+    };
+    readonly branch: {
+        readonly summary: "Expand one approved first-view design into a complete page or small site.";
+        readonly sections: readonly [{
+            readonly heading: "Actions";
+            readonly items: readonly ["execute — plan and generate screens, optionally converting complete pages to responsive HTML.", "resume — continue an incomplete branch from its durable recorded state."];
+        }];
+    };
+    readonly 'branch execute': {
+        readonly summary: "Plan and generate the rest of an approved page or site.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly ["Starts from the PNG, JPEG, or WebP named by --start and creates a unique run directory when --out-dir is omitted.", "scope page grows one continuous page; scope site also plans sibling pages.", "With --convert html, each complete page is converted as one ordered viewport package while other work continues.", "Runs in the background unless --wait or --dry-run is supplied. Screens and converted pages land beneath the branch directory."];
+        }, {
+            readonly heading: "Controls";
+            readonly items: readonly ["--max-screens keeps the first N planned screens and records what was omitted.", "--page-concurrency allows 1–10 simultaneous page conversions and defaults to 3. --source-conversion-id reuses a proven source conversion.", "--dry-run validates inputs and prints the run identity and estimate without claiming or buying work."];
+        }, {
+            readonly heading: "Next";
+            readonly items: readonly ["Run `12ui next <run-dir>` to inspect durable progress."];
+        }];
+    };
+    readonly 'branch resume': {
+        readonly summary: "Continue an incomplete branch using its original durable inputs.";
+        readonly sections: readonly [{
+            readonly heading: "Safety";
+            readonly items: readonly ["Reloads the recorded winner, concept, scope, screen cap, conversion settings, and run identity.", "Reuses settled screens and verifies that a local winner image has not changed.", "A run that never started or already has a terminal completion record cannot be resumed. Resume detaches unless --wait is supplied."];
+        }];
+    };
+    readonly next: {
+        readonly summary: "Read durable status and report the one useful command to run next.";
+        readonly sections: readonly [{
+            readonly heading: "Behavior";
+            readonly items: readonly ["Recognizes draft and branch directories, hosted run IDs, conversion IDs, and journal-backed workspaces.", "Never starts, retries, or resumes work. Human status is the default; --json writes the machine record to stdout and suppresses the human progress stream.", "--wait 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 auth: {
+        readonly summary: "Manage the personal 12ui credential saved on this machine.";
+        readonly sections: readonly [{
+            readonly heading: "Actions";
+            readonly items: readonly ["login — approve or import an API key, verify it, and save it locally.", "status — verify the saved key and show its account, scopes, origin, and quota.", "logout — revoke the saved key and remove the local copy."];
+        }];
+    };
+    readonly 'auth login': {
+        readonly summary: "Connect this machine to a personal 12ui account.";
+        readonly sections: readonly [{
+            readonly heading: "What it does";
+            readonly items: readonly ["Opens device approval, waits for authorization, verifies the new credential, and saves it locally.", "With --api-key, imports and verifies that key instead of opening browser approval."];
+        }, {
+            readonly heading: "Key options";
+            readonly items: readonly ["--login-origin selects the authentication service; --origin selects the 12ui API saved with the key.", "--key-name sets the human-readable credential label."];
+        }];
+    };
+    readonly 'auth status': {
+        readonly summary: "Verify the saved credential and report the account it belongs to.";
+        readonly sections: readonly [{
+            readonly heading: "Reports";
+            readonly items: readonly ["Account and credential IDs, granted scopes, the saved API origin, and conversion quota when available.", "--json writes only the structured status object. This command checks the saved key, not an ephemeral --api-key."];
+        }];
+    };
+    readonly 'auth logout': {
+        readonly summary: "Disconnect the saved personal 12ui credential.";
+        readonly sections: readonly [{
+            readonly heading: "What it does";
+            readonly items: readonly ["Revokes the credential remotely, then removes the local credential file.", "If remote revocation fails, the local credential is retained so the failure can be resolved safely."];
+        }];
+    };
+    readonly cli: {
+        readonly summary: "Manage the durable pinned 12ui launcher.";
+        readonly sections: readonly [{
+            readonly heading: "Actions";
+            readonly items: readonly ["install — pin this released CLI version into the managed launcher.", "status — show the pinned version, launcher path, and managed data root.", "These commands do not install agent skills or change authentication."];
+        }];
+    };
+    readonly 'cli install': {
+        readonly summary: "Make the exact CLI release currently running available as the durable `12ui` command.";
+        readonly sections: readonly [{
+            readonly heading: "What it changes";
+            readonly items: readonly ["Installs the running package into the managed version directory, updates the launcher, and verifies its version.", "It does not check for a newer release, install skills, or connect an account."];
+        }];
+    };
+    readonly 'cli status': {
+        readonly summary: "Inspect the managed 12ui installation on this machine.";
+        readonly sections: readonly [{
+            readonly heading: "Reports";
+            readonly items: readonly ["The pinned package version, launcher path, and managed data root.", "--json emits the same local inventory as structured data; this is not a network update or service-health check."];
+        }];
+    };
+    readonly skill: {
+        readonly summary: "Manage the bundled design skill for supported coding agents.";
+        readonly sections: readonly [{
+            readonly heading: "Actions";
+            readonly items: readonly ["install — install the skill and ensure the CLI and authentication are ready.", "status — inspect skill, enablement, and credential-file state.", "print — write the bundled SKILL.md to stdout.", "remove — remove the skill while retaining the CLI and credentials."];
+        }, {
+            readonly heading: "Targets";
+            readonly items: readonly ["Without --client, every detected Codex, Claude Code, Grok, Cursor, Antigravity, and Copilot installation is targeted.", "--home selects a custom client home and therefore requires --client."];
+        }];
+    };
+    readonly 'skill install': {
+        readonly summary: "Install the bundled design skill into selected or detected coding-agent clients.";
+        readonly sections: readonly [{
+            readonly heading: "What it does";
+            readonly items: readonly ["Installs the skill transactionally, pins the CLI, enables Codex installations, and authenticates required scopes.", "--skip-auth leaves authentication untouched. --force replaces a conflicting unrecognized or locally modified skill."];
+        }];
+    };
+    readonly 'skill status': {
+        readonly summary: "Inspect installed design skills without changing them.";
+        readonly sections: readonly [{
+            readonly heading: "Reports";
+            readonly items: readonly ["Each target is current, different, or not installed; Codex targets also report whether the skill is enabled.", "Credential status means a credential file exists. Use `12ui auth status` to verify that credential live."];
+        }];
+    };
+    readonly 'skill print': {
+        readonly summary: "Write the exact bundled design SKILL.md to stdout.";
+        readonly sections: readonly [{
+            readonly heading: "Notes";
+            readonly items: readonly ["This performs no client discovery, installation, authentication, or network request."];
+        }];
+    };
+    readonly 'skill remove': {
+        readonly summary: "Remove the design skill from selected or detected coding-agent clients.";
+        readonly sections: readonly [{
+            readonly heading: "Important";
+            readonly items: readonly ["The pinned CLI and saved credentials are retained.", "The resolved design-skill directory is removed even when its contents differ from the bundled skill; inspect status first."];
+        }];
+    };
+};
+/**
+ * Resolve command context by longest literal prefix.
+ *
+ * The CLI parser keeps positional arguments in `command`, so
+ * `convert hero.png --help` arrives as `["convert", "hero.png"]`. The literal
+ * `convert` context is the right answer; the filename must never become a help
+ * key. The same applies to draft run directories and hosted run ids.
+ */
+export declare const helpContextFor: (command: readonly string[]) => CliHelpContext | undefined;
+export type { CliHelpCatalog, CliHelpContext, CliHelpSection } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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;AAEpC;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GACzB,SAAS,SAAS,MAAM,EAAE,KACzB,cAAc,GAAG,SAUnB,CAAC;AAEF,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/cli-help/index.js

@@ -0,0 +1,32 @@
+import { CONVERSION_HELP } from './conversion.js';
+import { DESIGN_HELP } from './design.js';
+import { META_HELP } from './meta.js';
+import { SETUP_HELP } from './setup.js';
+export { renderHelpContext } from './render.js';
+export const CLI_HELP_CONTEXTS = {
+    ...SETUP_HELP,
+    ...DESIGN_HELP,
+    ...CONVERSION_HELP,
+    ...META_HELP,
+};
+/**
+ * Resolve command context by longest literal prefix.
+ *
+ * The CLI parser keeps positional arguments in `command`, so
+ * `convert hero.png --help` arrives as `["convert", "hero.png"]`. The literal
+ * `convert` context is the right answer; the filename must never become a help
+ * key. The same applies to draft run directories and hosted run ids.
+ */
+export const helpContextFor = (command) => {
+    const normalized = command[0] === '--version'
+        ? ['version', ...command.slice(1)]
+        : command;
+    for (let depth = normalized.length; depth > 0; depth -= 1) {
+        const key = normalized.slice(0, depth).join(' ');
+        const context = CLI_HELP_CONTEXTS[key];
+        if (context)
+            return context;
+    }
+    return undefined;
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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;;;;;;;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,OAAO;YAAE,OAAO,OAAO,CAAC;IAC9B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

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

@@ -0,0 +1,24 @@
+export declare const META_HELP: {
+    readonly capabilities: {
+        readonly summary: "Print the machine-readable 12ui capability contract as JSON.";
+        readonly sections: readonly [{
+            readonly heading: "Includes";
+            readonly items: readonly ["Accepted inputs and outputs, models, limits, responsive qualities, project profiles, duration hints, journals, receipts, and concurrency.", "This is local and read-only; it performs no authentication, generation, conversion, or update check."];
+        }];
+    };
+    readonly mcp: {
+        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 version: {
+        readonly summary: "Print the installed 12ui package version.";
+        readonly sections: readonly [{
+            readonly heading: "Notes";
+            readonly items: readonly ["Reads the running package identity locally; it does not contact the service or check for updates."];
+        }];
+    };
+};
+//# sourceMappingURL=meta.d.ts.map

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

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