@12ui/design 0.2.27 → 0.2.28

package/dist/cli-help/meta.js

@@ -0,0 +1,30 @@
+export const META_HELP = {
+    capabilities: {
+        summary: 'Print the machine-readable 12ui capability contract as JSON.',
+        sections: [{
+                heading: 'Includes',
+                items: [
+                    '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.',
+                ],
+            }],
+    },
+    mcp: {
+        summary: 'Start the 12ui Model Context Protocol server over stdin and stdout.',
+        sections: [{
+                heading: 'Behavior',
+                items: [
+                    '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.',
+                ],
+            }],
+    },
+    version: {
+        summary: 'Print the installed 12ui package version.',
+        sections: [{
+                heading: 'Notes',
+                items: ['Reads the running package identity locally; it does not contact the service or check for updates.'],
+            }],
+    },
+};
+//# sourceMappingURL=meta.js.map

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

@@ -0,0 +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,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"}

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

@@ -0,0 +1,4 @@
+import type { CliHelpContext } from './types.js';
+/** Render contextual prose for a terminal without wrapping invocation syntax. */
+export declare const renderHelpContext: (context: CliHelpContext) => string;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/cli-help/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAqBjD,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,GAAI,SAAS,cAAc,KAAG,MAS3D,CAAC"}

package/dist/cli-help/render.js

@@ -0,0 +1,28 @@
+const HELP_WIDTH = 100;
+const wrap = (text, firstPrefix = '', continuationPrefix = firstPrefix) => {
+    const words = text.trim().split(/\s+/u);
+    const lines = [];
+    let line = firstPrefix;
+    for (const word of words) {
+        const separator = line === firstPrefix ? '' : ' ';
+        if (line.length > firstPrefix.length && line.length + separator.length + word.length > HELP_WIDTH) {
+            lines.push(line);
+            line = `${continuationPrefix}${word}`;
+        }
+        else {
+            line += `${separator}${word}`;
+        }
+    }
+    lines.push(line);
+    return lines;
+};
+/** Render contextual prose for a terminal without wrapping invocation syntax. */
+export const renderHelpContext = (context) => ([
+    ...wrap(context.summary),
+    ...(context.sections ?? []).flatMap((section) => [
+        '',
+        `${section.heading}:`,
+        ...section.items.flatMap((item) => wrap(item, '  - ', '    ')),
+    ]),
+].join('\n'));
+//# sourceMappingURL=render.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/cli-help/render.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,WAAW,GAAG,EAAE,EAAE,kBAAkB,GAAG,WAAW,EAAY,EAAE;IAC1F,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,GAAG,WAAW,CAAC;IACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAClD,IAAI,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YAClG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,GAAG,GAAG,kBAAkB,GAAG,IAAI,EAAE,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,IAAI,IAAI,GAAG,SAAS,GAAG,IAAI,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,iFAAiF;AACjF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAuB,EAAU,EAAE,CAAC,CACpE;IACE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;IACxB,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,EAAE;QACF,GAAG,OAAO,CAAC,OAAO,GAAG;QACrB,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/D,CAAC;CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC"}

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

@@ -0,0 +1,93 @@
+export declare const SETUP_HELP: {
+    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."];
+        }];
+    };
+};
+//# sourceMappingURL=setup.d.ts.map

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

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

package/dist/cli-help/setup.js

@@ -0,0 +1,142 @@
+export const SETUP_HELP = {
+    auth: {
+        summary: 'Manage the personal 12ui credential saved on this machine.',
+        sections: [{
+                heading: 'Actions',
+                items: [
+                    '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.',
+                ],
+            }],
+    },
+    'auth login': {
+        summary: 'Connect this machine to a personal 12ui account.',
+        sections: [
+            {
+                heading: 'What it does',
+                items: [
+                    '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.',
+                ],
+            },
+            {
+                heading: 'Key options',
+                items: [
+                    '--login-origin selects the authentication service; --origin selects the 12ui API saved with the key.',
+                    '--key-name sets the human-readable credential label.',
+                ],
+            },
+        ],
+    },
+    'auth status': {
+        summary: 'Verify the saved credential and report the account it belongs to.',
+        sections: [{
+                heading: 'Reports',
+                items: [
+                    '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.',
+                ],
+            }],
+    },
+    'auth logout': {
+        summary: 'Disconnect the saved personal 12ui credential.',
+        sections: [{
+                heading: 'What it does',
+                items: [
+                    '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.',
+                ],
+            }],
+    },
+    cli: {
+        summary: 'Manage the durable pinned 12ui launcher.',
+        sections: [{
+                heading: 'Actions',
+                items: [
+                    '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.',
+                ],
+            }],
+    },
+    'cli install': {
+        summary: 'Make the exact CLI release currently running available as the durable `12ui` command.',
+        sections: [{
+                heading: 'What it changes',
+                items: [
+                    '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.',
+                ],
+            }],
+    },
+    'cli status': {
+        summary: 'Inspect the managed 12ui installation on this machine.',
+        sections: [{
+                heading: 'Reports',
+                items: [
+                    '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.',
+                ],
+            }],
+    },
+    skill: {
+        summary: 'Manage the bundled design skill for supported coding agents.',
+        sections: [
+            {
+                heading: 'Actions',
+                items: [
+                    '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.',
+                ],
+            },
+            {
+                heading: 'Targets',
+                items: [
+                    '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.',
+                ],
+            },
+        ],
+    },
+    'skill install': {
+        summary: 'Install the bundled design skill into selected or detected coding-agent clients.',
+        sections: [{
+                heading: 'What it does',
+                items: [
+                    'Installs the skill transactionally, pins the CLI, enables Codex installations, and authenticates required scopes.',
+                    '--skip-auth leaves authentication untouched. --force replaces a conflicting unrecognized or locally modified skill.',
+                ],
+            }],
+    },
+    'skill status': {
+        summary: 'Inspect installed design skills without changing them.',
+        sections: [{
+                heading: 'Reports',
+                items: [
+                    '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.',
+                ],
+            }],
+    },
+    'skill print': {
+        summary: 'Write the exact bundled design SKILL.md to stdout.',
+        sections: [{
+                heading: 'Notes',
+                items: ['This performs no client discovery, installation, authentication, or network request.'],
+            }],
+    },
+    'skill remove': {
+        summary: 'Remove the design skill from selected or detected coding-agent clients.',
+        sections: [{
+                heading: 'Important',
+                items: [
+                    '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.',
+                ],
+            }],
+    },
+};
+//# sourceMappingURL=setup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/cli-help/setup.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE;QACJ,OAAO,EAAE,4DAA4D;QACrE,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,SAAS;gBAClB,KAAK,EAAE;oBACL,uEAAuE;oBACvE,gFAAgF;oBAChF,0DAA0D;iBAC3D;aACF,CAAC;KACH;IACD,YAAY,EAAE;QACZ,OAAO,EAAE,kDAAkD;QAC3D,QAAQ,EAAE;YACR;gBACE,OAAO,EAAE,cAAc;gBACvB,KAAK,EAAE;oBACL,oGAAoG;oBACpG,oFAAoF;iBACrF;aACF;YACD;gBACE,OAAO,EAAE,aAAa;gBACtB,KAAK,EAAE;oBACL,sGAAsG;oBACtG,sDAAsD;iBACvD;aACF;SACF;KACF;IACD,aAAa,EAAE;QACb,OAAO,EAAE,mEAAmE;QAC5E,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,SAAS;gBAClB,KAAK,EAAE;oBACL,wGAAwG;oBACxG,iHAAiH;iBAClH;aACF,CAAC;KACH;IACD,aAAa,EAAE;QACb,OAAO,EAAE,gDAAgD;QACzD,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,cAAc;gBACvB,KAAK,EAAE;oBACL,0EAA0E;oBAC1E,qGAAqG;iBACtG;aACF,CAAC;KACH;IACD,GAAG,EAAE;QACH,OAAO,EAAE,0CAA0C;QACnD,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,SAAS;gBAClB,KAAK,EAAE;oBACL,oEAAoE;oBACpE,yEAAyE;oBACzE,sEAAsE;iBACvE;aACF,CAAC;KACH;IACD,aAAa,EAAE;QACb,OAAO,EAAE,uFAAuF;QAChG,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,iBAAiB;gBAC1B,KAAK,EAAE;oBACL,kHAAkH;oBAClH,+EAA+E;iBAChF;aACF,CAAC;KACH;IACD,YAAY,EAAE;QACZ,OAAO,EAAE,wDAAwD;QACjE,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,SAAS;gBAClB,KAAK,EAAE;oBACL,mEAAmE;oBACnE,iHAAiH;iBAClH;aACF,CAAC;KACH;IACD,KAAK,EAAE;QACL,OAAO,EAAE,8DAA8D;QACvE,QAAQ,EAAE;YACR;gBACE,OAAO,EAAE,SAAS;gBAClB,KAAK,EAAE;oBACL,8EAA8E;oBAC9E,gEAAgE;oBAChE,+CAA+C;oBAC/C,oEAAoE;iBACrE;aACF;YACD;gBACE,OAAO,EAAE,SAAS;gBAClB,KAAK,EAAE;oBACL,uHAAuH;oBACvH,sEAAsE;iBACvE;aACF;SACF;KACF;IACD,eAAe,EAAE;QACf,OAAO,EAAE,kFAAkF;QAC3F,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,cAAc;gBACvB,KAAK,EAAE;oBACL,mHAAmH;oBACnH,qHAAqH;iBACtH;aACF,CAAC;KACH;IACD,cAAc,EAAE;QACd,OAAO,EAAE,wDAAwD;QACjE,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,SAAS;gBAClB,KAAK,EAAE;oBACL,8GAA8G;oBAC9G,0GAA0G;iBAC3G;aACF,CAAC;KACH;IACD,aAAa,EAAE;QACb,OAAO,EAAE,oDAAoD;QAC7D,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,CAAC,sFAAsF,CAAC;aAChG,CAAC;KACH;IACD,cAAc,EAAE;QACd,OAAO,EAAE,yEAAyE;QAClF,QAAQ,EAAE,CAAC;gBACT,OAAO,EAAE,WAAW;gBACpB,KAAK,EAAE;oBACL,oDAAoD;oBACpD,4HAA4H;iBAC7H;aACF,CAAC;KACH;CACgC,CAAC"}

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

@@ -0,0 +1,10 @@
+export type CliHelpSection = {
+    heading: string;
+    items: readonly string[];
+};
+export type CliHelpContext = {
+    summary: string;
+    sections?: readonly CliHelpSection[];
+};
+export type CliHelpCatalog = Readonly<Record<string, CliHelpContext>>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli-help/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC"}

package/dist/cli-help/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli-help/types.ts"],"names":[],"mappings":""}

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

@@ -1,17 +1,14 @@
 import { type CliFlags } from './cli-arguments.js';
+import { type LongRunningProgressObservation } from './cli-progress.js';
 import { type NextTarget } from './next-target.js';
 import type { RunJournalNotes } from './run-journal.js';
 /**
  * `12ui next` — one command for "what is happening and what do I do".
  *
- * WHY IT EXISTS AS A MERGE, NOT AN ADDITION. That question had five spellings
- * with three argument shapes: `draft status <run-dir>`, `branch status <run-dir>
- * | --out-dir`, `image batch-status --manifest <file>`, `create status
- * <run-id>`, and a `resume` that needs two more flags. Four of those ignored the
- * `--json` they advertised. A measured wave typed `draft status` eighteen times
- * and `image batch-status` once on one run and still ended with
- * `next_action_offered: false` while paid work was in flight. Adding a sixth
- * spelling would have made that worse; the four are gone and this replaces them.
+ * WHY IT EXISTS AS A MERGE, NOT AN ADDITION. Status used to be split by
+ * subsystem and argument shape, and several spellings ignored the `--json`
+ * they advertised. One positional target now covers draft, branch, hosted, and
+ * conversion work while the retired subsystem spellings stay gone.
  *
  * THREE THINGS IT ALWAYS REPORTS, because each one was a measured failure:
  *   - the state, from the run's own durable records rather than a directory listing;
@@ -51,6 +48,12 @@ export type NextReport = {
     runId?: string;
     /** The underlying status record, unchanged, for anything that parsed it before. */
     detail: unknown;
+    /** The run is incomplete but waiting cannot advance it; execute nextCommand. */
+    recoverable?: boolean;
+    /** Bare --wait never sets this; only an explicit caller deadline can. */
+    deadlineReached?: boolean;
+    /** Structured facts consumed by the one progress renderer. */
+    progress: LongRunningProgressObservation;
 };
 export type NextCommandDependencies = {
     journal?: RunJournalNotes;

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

@@ -1 +1 @@
-{"version":3,"file":"cli-next-command.d.ts","sourceRoot":"","sources":["../src/cli-next-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAyB5E,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,MAAM,UAAU,GAAG;IACvB,mDAAmD;IACnD,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AA0PF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,gBAAgB,MAAM,GAAG,SAAS,EAClC,OAAO,QAAQ,EACf,eAAc,uBAA4B,KACzC,OAAO,CAAC,UAAU,CAsCpB,CAAC"}
+{"version":3,"file":"cli-next-command.d.ts","sourceRoot":"","sources":["../src/cli-next-command.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG5E,OAAO,EAQL,KAAK,8BAA8B,EACpC,MAAM,mBAAmB,CAAC;AAY3B,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAQxD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,UAAU,GAAG;IACvB,mDAAmD;IACnD,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,MAAM,EAAE,OAAO,CAAC;IAChB,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yEAAyE;IACzE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,EAAE,8BAA8B,CAAC;CAC1C,CAAC;AAyYF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,gBAAgB,MAAM,GAAG,SAAS,EAClC,OAAO,QAAQ,EACf,eAAc,uBAA4B,KACzC,OAAO,CAAC,UAAU,CAqHpB,CAAC"}