@superdesign/cli 0.1.12 → 0.2.0

package/dist/api/drafts.d.ts

@@ -1,16 +1,22 @@
 /**
  * Drafts API endpoints
  */
+export interface ContextFile {
+    filename: string;
+    content: string;
+}
 export interface CreateDraftRequest {
     title: string;
     prompt: string;
     deviceMode?: 'mobile' | 'tablet' | 'desktop';
+    contextFiles?: ContextFile[];
 }
 export interface IterateDraftRequest {
     prompts?: string[];
     prompt?: string;
     count?: 1 | 2 | 3 | 4;
     mode: 'replace' | 'branch';
+    contextFiles?: ContextFile[];
 }
 export interface PlanFlowRequest {
     flowContext?: string;
@@ -22,6 +28,7 @@ export interface FlowPage {
 export interface ExecuteFlowRequest {
     flowContext?: string;
     pages: FlowPage[];
+    contextFiles?: ContextFile[];
 }
 export interface JobCreatedResponse {
     jobId: string;

package/dist/config/constants.d.ts

@@ -12,7 +12,7 @@ export declare const POLL_TIMEOUT_MS: number;
 export declare const AUTH_POLL_INTERVAL_MS = 2000;
 export declare const AUTH_POLL_TIMEOUT_MS: number;
 /** CLI version - should match package.json */
-export declare const CLI_VERSION = "0.1.12";
+export declare const CLI_VERSION = "0.2.0";
 /** PostHog analytics configuration */
 export declare const POSTHOG_KEY: string;
 export declare const POSTHOG_HOST: string;

package/dist/index.cjs

@@ -316,7 +316,7 @@ var __webpack_exports__ = {};
         try {
             startSpinner('Creating auth session...');
             const session = await createSession({
-                cliVersion: "0.1.12",
+                cliVersion: "0.2.0",
                 os: `${external_os_namespaceObject.platform()} ${external_os_namespaceObject.release()}`,
                 hostname: external_os_namespaceObject.hostname()
             });
@@ -799,11 +799,30 @@ superdesign --help
         const response = await client.post(`/external/drafts/${draftId}/flow/execute`, data);
         return response.data;
     }
+    function readContextFiles(filePaths) {
+        const cwd = process.cwd();
+        return filePaths.map((filePath)=>{
+            const absolutePath = (0, external_path_namespaceObject.resolve)(cwd, filePath);
+            try {
+                const content = (0, external_fs_namespaceObject.readFileSync)(absolutePath, 'utf-8');
+                const filename = (0, external_path_namespaceObject.relative)(cwd, absolutePath);
+                return {
+                    filename,
+                    content
+                };
+            } catch (err) {
+                const msg = err instanceof Error ? err.message : 'Unknown error';
+                output_error(`Failed to read context file "${filePath}": ${msg}`);
+                process.exit(EXIT_CODES.VALIDATION_ERROR);
+            }
+        });
+    }
     function createCreateDesignDraftCommand() {
-        const command = new external_commander_namespaceObject.Command('create-design-draft').description('Create a design draft from scratch without any reference, Default dont use this, use iterate-design-draft instead').requiredOption('--project-id <id>', 'Project ID').requiredOption('--title <title>', 'Draft title').requiredOption('-p, --prompt <prompt>', 'Design prompt for AI generation').option('--device <mode>', 'Device mode (mobile, tablet, desktop)', 'desktop').option('--json', 'Output in JSON format').action(async (options)=>{
+        const command = new external_commander_namespaceObject.Command('create-design-draft').description('Create a design draft from scratch without any reference, Default dont use this, use iterate-design-draft instead').requiredOption('--project-id <id>', 'Project ID').requiredOption('--title <title>', 'Draft title').requiredOption('-p, --prompt <prompt>', 'Design prompt for AI generation').option('--device <mode>', 'Device mode (mobile, tablet, desktop)', 'desktop').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--json', 'Output in JSON format').action(async (options)=>{
             if (options.json) setJsonMode(true);
             job_runner_requireAuth(manager_isAuthenticated);
             validateDeviceMode(options.device);
+            const contextFiles = options.contextFile ? readContextFiles(options.contextFile) : void 0;
             await runJob({
                 startLabel: 'Creating design draft...',
                 pollingLabel: 'Generating design with AI...',
@@ -813,7 +832,8 @@ superdesign --help
                 startJob: ()=>createDraft(options.projectId, {
                         title: options.title,
                         prompt: options.prompt,
-                        deviceMode: options.device
+                        deviceMode: options.device,
+                        contextFiles
                     }),
                 transformResult: (job)=>({
                         draftId: job.result.draftId,
@@ -885,17 +905,20 @@ Usage Examples:
   superdesign iterate-design-draft --draft-id <id> -p "dark theme" -p "minimal" -p "bold" --mode branch --json
 
   # Iterate: Auto explore (only give exploration direction, and let Superdesign fill in details, e.g. explore different styles; Default do NOT use auto explore mode)
-  superdesign iterate-design-draft --draft-id <id> -p "..." --mode branch --count 3 --json`).requiredOption('--draft-id <id>', 'Draft ID to iterate on').requiredOption('-p, --prompt <prompt...>', 'Iteration prompt(s). Use multiple -p for specific prompts per variation.').requiredOption('--mode <mode>', 'Iteration mode (replace or branch)').option('--count <count>', 'Number of variations (1-4). Only used when single prompt provided.').option('--json', 'Output in JSON format').addOption(new external_commander_namespaceObject.Option('--project-id <id>').hideHelp()).action(async (options)=>{
+  superdesign iterate-design-draft --draft-id <id> -p "..." --mode branch --count 3 --json`).requiredOption('--draft-id <id>', 'Draft ID to iterate on').requiredOption('-p, --prompt <prompt...>', 'Iteration prompt(s). Use multiple -p for specific prompts per variation.').requiredOption('--mode <mode>', 'Iteration mode (replace or branch)').option('--count <count>', 'Number of variations (1-4). Only used when single prompt provided.').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--json', 'Output in JSON format').addOption(new external_commander_namespaceObject.Option('--project-id <id>').hideHelp()).action(async (options)=>{
             if (options.json) setJsonMode(true);
             job_runner_requireAuth(manager_isAuthenticated);
             const { prompts, count, mode } = validateOptions(options);
+            const contextFiles = options.contextFile ? readContextFiles(options.contextFile) : void 0;
             const requestData = prompts.length > 1 ? {
                 prompts,
-                mode
+                mode,
+                contextFiles
             } : {
                 prompt: prompts[0],
                 count: count,
-                mode
+                mode,
+                contextFiles
             };
             await runJob({
                 startLabel: 'Starting iteration...',
@@ -966,7 +989,7 @@ Usage Examples:
         return parsed;
     }
     function createExecuteFlowPagesCommand() {
-        const command = new external_commander_namespaceObject.Command('execute-flow-pages').description('Generate flow pages using AI').requiredOption('--draft-id <id>', 'Source draft ID').requiredOption('--pages <json>', 'JSON array of pages to generate [{title, prompt}]').option('--context <context>', 'Additional context for flow generation').option('--json', 'Output in JSON format').action(async (options)=>{
+        const command = new external_commander_namespaceObject.Command('execute-flow-pages').description('Generate flow pages using AI').requiredOption('--draft-id <id>', 'Source draft ID').requiredOption('--pages <json>', 'JSON array of pages to generate [{title, prompt}]').option('--context <context>', 'Additional context for flow generation').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--json', 'Output in JSON format').action(async (options)=>{
             if (options.json) setJsonMode(true);
             job_runner_requireAuth(manager_isAuthenticated);
             let pages;
@@ -986,6 +1009,7 @@ Usage Examples:
                 output_error('Maximum 10 pages allowed');
                 process.exit(EXIT_CODES.VALIDATION_ERROR);
             }
+            const contextFiles = options.contextFile ? readContextFiles(options.contextFile) : void 0;
             const timeoutMs = Math.max(300000, 2 * pages.length * 60000);
             await runJob({
                 startLabel: `Generating ${pages.length} flow page(s)...`,
@@ -996,7 +1020,8 @@ Usage Examples:
                 timeoutMs,
                 startJob: ()=>executeFlowPages(options.draftId, {
                         flowContext: options.context,
-                        pages
+                        pages,
+                        contextFiles
                     }),
                 transformResult: (job)=>({
                         drafts: job.result.drafts,
@@ -1311,7 +1336,7 @@ Usage Examples:
             durationMs: opts.durationMs,
             errorCode: opts.errorCode,
             options: opts.options,
-            cliVersion: "0.1.12",
+            cliVersion: "0.2.0",
             os: `${external_os_default().platform()} ${external_os_default().release()}`
         };
         const posthog = getPostHog();
@@ -1346,9 +1371,46 @@ Usage Examples:
         path: (0, external_path_namespaceObject.resolve)(src_dirname, '../.env')
     });
     (0, external_dotenv_namespaceObject.config)();
+    function getFailedCommandUsage(program) {
+        const failedCommand = findFailedCommand(program);
+        if (!failedCommand) return {
+            message: 'Run with --help for usage information'
+        };
+        return {
+            command: failedCommand.name(),
+            description: failedCommand.description(),
+            requiredOptions: failedCommand.options.filter((opt)=>opt.mandatory).map((opt)=>({
+                    flags: opt.flags,
+                    description: opt.description
+                })),
+            allOptions: failedCommand.options.map((opt)=>({
+                    flags: opt.flags,
+                    description: opt.description,
+                    required: opt.mandatory
+                }))
+        };
+    }
+    function getFailedCommandHelp(program) {
+        const failedCommand = findFailedCommand(program);
+        if (!failedCommand) return '\nRun with --help for usage information\n';
+        return '\n' + failedCommand.helpInformation();
+    }
+    function findFailedCommand(program) {
+        const args = process.argv;
+        const commandName = args[2];
+        if (!commandName || commandName.startsWith('-')) return program;
+        const subcommand = program.commands.find((cmd)=>cmd.name() === commandName);
+        return subcommand || program;
+    }
     function createProgram() {
         const program = new external_commander_namespaceObject.Command();
-        program.name('superdesign').description('SuperDesign CLI - AI product designer for coding agents').version("0.1.12");
+        program.name('superdesign').description('SuperDesign CLI - AI product designer for coding agents').version("0.2.0");
+        program.configureOutput({
+            writeErr: (str)=>{
+                if (!process.argv.includes('--json')) process.stderr.write(str);
+            }
+        });
+        program.exitOverride();
         let startTime = 0;
         program.hook('preAction', ()=>{
             startTime = Date.now();
@@ -1362,26 +1424,58 @@ Usage Examples:
             });
             await shutdownAnalytics();
         });
-        program.addCommand(createLoginCommand());
-        program.addCommand(createLogoutCommand());
-        program.addCommand(createInitCommand());
-        program.addCommand(createCreateProjectCommand());
-        program.addCommand(createIterateDesignDraftCommand());
-        program.addCommand(createPlanFlowPagesCommand(), {
+        const addCommandWithOverride = (cmd, opts)=>{
+            cmd.exitOverride();
+            cmd.configureOutput({
+                writeErr: (str)=>{
+                    if (!process.argv.includes('--json')) process.stderr.write(str);
+                }
+            });
+            program.addCommand(cmd, opts);
+        };
+        addCommandWithOverride(createLoginCommand());
+        addCommandWithOverride(createLogoutCommand());
+        addCommandWithOverride(createInitCommand());
+        addCommandWithOverride(createCreateProjectCommand());
+        addCommandWithOverride(createIterateDesignDraftCommand());
+        addCommandWithOverride(createPlanFlowPagesCommand(), {
             hidden: true
         });
-        program.addCommand(createExecuteFlowPagesCommand());
-        program.addCommand(createExtractBrandGuideCommand());
-        program.addCommand(createSearchPromptsCommand());
-        program.addCommand(createGetPromptsCommand());
-        program.addCommand(createFetchDesignNodesCommand());
-        program.addCommand(createGetDesignCommand());
-        program.addCommand(createCreateDesignDraftCommand());
+        addCommandWithOverride(createExecuteFlowPagesCommand());
+        addCommandWithOverride(createExtractBrandGuideCommand());
+        addCommandWithOverride(createSearchPromptsCommand());
+        addCommandWithOverride(createGetPromptsCommand());
+        addCommandWithOverride(createFetchDesignNodesCommand());
+        addCommandWithOverride(createGetDesignCommand());
+        addCommandWithOverride(createCreateDesignDraftCommand());
         return program;
     }
     async function run() {
         const program = createProgram();
-        await program.parseAsync(process.argv);
+        try {
+            await program.parseAsync(process.argv);
+        } catch (err) {
+            if (err && 'object' == typeof err && 'code' in err) {
+                const commanderError = err;
+                if ('commander.helpDisplayed' === commanderError.code || 'commander.version' === commanderError.code) process.exit(0);
+                if ('commander.missingMandatoryOptionValue' === commanderError.code) {
+                    const hasJsonFlag = process.argv.includes('--json');
+                    if (hasJsonFlag) {
+                        const errorOutput = {
+                            error: commanderError.message,
+                            usage: getFailedCommandUsage(program)
+                        };
+                        process.stderr.write(JSON.stringify(errorOutput, null, 2) + '\n');
+                    } else {
+                        process.stderr.write('\n');
+                        const helpInfo = getFailedCommandHelp(program);
+                        if (helpInfo) process.stderr.write(helpInfo);
+                    }
+                    process.exit(1);
+                }
+            }
+            throw err;
+        }
     }
 })();
 exports.ApiClientError = __webpack_exports__.ApiClientError;

package/dist/index.js

@@ -1,6 +1,6 @@
 import { config as external_dotenv_config } from "dotenv";
 import { fileURLToPath } from "url";
-import { dirname, join, resolve as external_path_resolve } from "path";
+import { dirname, join, relative, resolve as external_path_resolve } from "path";
 import { Command, Option } from "commander";
 import { appendFileSync, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "fs";
 import os, { homedir, hostname, platform, release } from "os";
@@ -226,7 +226,7 @@ async function runAuthFlow(options = {}) {
     try {
         startSpinner('Creating auth session...');
         const session = await createSession({
-            cliVersion: "0.1.12",
+            cliVersion: "0.2.0",
             os: `${platform()} ${release()}`,
             hostname: hostname()
         });
@@ -709,11 +709,30 @@ async function executeFlowPages(draftId, data) {
     const response = await client.post(`/external/drafts/${draftId}/flow/execute`, data);
     return response.data;
 }
+function readContextFiles(filePaths) {
+    const cwd = process.cwd();
+    return filePaths.map((filePath)=>{
+        const absolutePath = external_path_resolve(cwd, filePath);
+        try {
+            const content = readFileSync(absolutePath, 'utf-8');
+            const filename = relative(cwd, absolutePath);
+            return {
+                filename,
+                content
+            };
+        } catch (err) {
+            const msg = err instanceof Error ? err.message : 'Unknown error';
+            output_error(`Failed to read context file "${filePath}": ${msg}`);
+            process.exit(EXIT_CODES.VALIDATION_ERROR);
+        }
+    });
+}
 function createCreateDesignDraftCommand() {
-    const command = new Command('create-design-draft').description('Create a design draft from scratch without any reference, Default dont use this, use iterate-design-draft instead').requiredOption('--project-id <id>', 'Project ID').requiredOption('--title <title>', 'Draft title').requiredOption('-p, --prompt <prompt>', 'Design prompt for AI generation').option('--device <mode>', 'Device mode (mobile, tablet, desktop)', 'desktop').option('--json', 'Output in JSON format').action(async (options)=>{
+    const command = new Command('create-design-draft').description('Create a design draft from scratch without any reference, Default dont use this, use iterate-design-draft instead').requiredOption('--project-id <id>', 'Project ID').requiredOption('--title <title>', 'Draft title').requiredOption('-p, --prompt <prompt>', 'Design prompt for AI generation').option('--device <mode>', 'Device mode (mobile, tablet, desktop)', 'desktop').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--json', 'Output in JSON format').action(async (options)=>{
         if (options.json) setJsonMode(true);
         job_runner_requireAuth(manager_isAuthenticated);
         validateDeviceMode(options.device);
+        const contextFiles = options.contextFile ? readContextFiles(options.contextFile) : void 0;
         await runJob({
             startLabel: 'Creating design draft...',
             pollingLabel: 'Generating design with AI...',
@@ -723,7 +742,8 @@ function createCreateDesignDraftCommand() {
             startJob: ()=>createDraft(options.projectId, {
                     title: options.title,
                     prompt: options.prompt,
-                    deviceMode: options.device
+                    deviceMode: options.device,
+                    contextFiles
                 }),
             transformResult: (job)=>({
                     draftId: job.result.draftId,
@@ -795,17 +815,20 @@ Usage Examples:
   superdesign iterate-design-draft --draft-id <id> -p "dark theme" -p "minimal" -p "bold" --mode branch --json
 
   # Iterate: Auto explore (only give exploration direction, and let Superdesign fill in details, e.g. explore different styles; Default do NOT use auto explore mode)
-  superdesign iterate-design-draft --draft-id <id> -p "..." --mode branch --count 3 --json`).requiredOption('--draft-id <id>', 'Draft ID to iterate on').requiredOption('-p, --prompt <prompt...>', 'Iteration prompt(s). Use multiple -p for specific prompts per variation.').requiredOption('--mode <mode>', 'Iteration mode (replace or branch)').option('--count <count>', 'Number of variations (1-4). Only used when single prompt provided.').option('--json', 'Output in JSON format').addOption(new Option('--project-id <id>').hideHelp()).action(async (options)=>{
+  superdesign iterate-design-draft --draft-id <id> -p "..." --mode branch --count 3 --json`).requiredOption('--draft-id <id>', 'Draft ID to iterate on').requiredOption('-p, --prompt <prompt...>', 'Iteration prompt(s). Use multiple -p for specific prompts per variation.').requiredOption('--mode <mode>', 'Iteration mode (replace or branch)').option('--count <count>', 'Number of variations (1-4). Only used when single prompt provided.').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--json', 'Output in JSON format').addOption(new Option('--project-id <id>').hideHelp()).action(async (options)=>{
         if (options.json) setJsonMode(true);
         job_runner_requireAuth(manager_isAuthenticated);
         const { prompts, count, mode } = validateOptions(options);
+        const contextFiles = options.contextFile ? readContextFiles(options.contextFile) : void 0;
         const requestData = prompts.length > 1 ? {
             prompts,
-            mode
+            mode,
+            contextFiles
         } : {
             prompt: prompts[0],
             count: count,
-            mode
+            mode,
+            contextFiles
         };
         await runJob({
             startLabel: 'Starting iteration...',
@@ -876,7 +899,7 @@ function parsePages(pagesJson) {
     return parsed;
 }
 function createExecuteFlowPagesCommand() {
-    const command = new Command('execute-flow-pages').description('Generate flow pages using AI').requiredOption('--draft-id <id>', 'Source draft ID').requiredOption('--pages <json>', 'JSON array of pages to generate [{title, prompt}]').option('--context <context>', 'Additional context for flow generation').option('--json', 'Output in JSON format').action(async (options)=>{
+    const command = new Command('execute-flow-pages').description('Generate flow pages using AI').requiredOption('--draft-id <id>', 'Source draft ID').requiredOption('--pages <json>', 'JSON array of pages to generate [{title, prompt}]').option('--context <context>', 'Additional context for flow generation').option('--context-file <paths...>', 'UI source files to include as context for AI generation').option('--json', 'Output in JSON format').action(async (options)=>{
         if (options.json) setJsonMode(true);
         job_runner_requireAuth(manager_isAuthenticated);
         let pages;
@@ -896,6 +919,7 @@ function createExecuteFlowPagesCommand() {
             output_error('Maximum 10 pages allowed');
             process.exit(EXIT_CODES.VALIDATION_ERROR);
         }
+        const contextFiles = options.contextFile ? readContextFiles(options.contextFile) : void 0;
         const timeoutMs = Math.max(300000, 2 * pages.length * 60000);
         await runJob({
             startLabel: `Generating ${pages.length} flow page(s)...`,
@@ -906,7 +930,8 @@ function createExecuteFlowPagesCommand() {
             timeoutMs,
             startJob: ()=>executeFlowPages(options.draftId, {
                     flowContext: options.context,
-                    pages
+                    pages,
+                    contextFiles
                 }),
             transformResult: (job)=>({
                     drafts: job.result.drafts,
@@ -1219,7 +1244,7 @@ async function trackCommand(opts) {
         durationMs: opts.durationMs,
         errorCode: opts.errorCode,
         options: opts.options,
-        cliVersion: "0.1.12",
+        cliVersion: "0.2.0",
         os: `${os.platform()} ${os.release()}`
     };
     const posthog = getPostHog();
@@ -1254,9 +1279,46 @@ external_dotenv_config({
     path: external_path_resolve(src_dirname, '../.env')
 });
 external_dotenv_config();
+function getFailedCommandUsage(program) {
+    const failedCommand = findFailedCommand(program);
+    if (!failedCommand) return {
+        message: 'Run with --help for usage information'
+    };
+    return {
+        command: failedCommand.name(),
+        description: failedCommand.description(),
+        requiredOptions: failedCommand.options.filter((opt)=>opt.mandatory).map((opt)=>({
+                flags: opt.flags,
+                description: opt.description
+            })),
+        allOptions: failedCommand.options.map((opt)=>({
+                flags: opt.flags,
+                description: opt.description,
+                required: opt.mandatory
+            }))
+    };
+}
+function getFailedCommandHelp(program) {
+    const failedCommand = findFailedCommand(program);
+    if (!failedCommand) return '\nRun with --help for usage information\n';
+    return '\n' + failedCommand.helpInformation();
+}
+function findFailedCommand(program) {
+    const args = process.argv;
+    const commandName = args[2];
+    if (!commandName || commandName.startsWith('-')) return program;
+    const subcommand = program.commands.find((cmd)=>cmd.name() === commandName);
+    return subcommand || program;
+}
 function createProgram() {
     const program = new Command();
-    program.name('superdesign').description('SuperDesign CLI - AI product designer for coding agents').version("0.1.12");
+    program.name('superdesign').description('SuperDesign CLI - AI product designer for coding agents').version("0.2.0");
+    program.configureOutput({
+        writeErr: (str)=>{
+            if (!process.argv.includes('--json')) process.stderr.write(str);
+        }
+    });
+    program.exitOverride();
     let startTime = 0;
     program.hook('preAction', ()=>{
         startTime = Date.now();
@@ -1270,25 +1332,57 @@ function createProgram() {
         });
         await shutdownAnalytics();
     });
-    program.addCommand(createLoginCommand());
-    program.addCommand(createLogoutCommand());
-    program.addCommand(createInitCommand());
-    program.addCommand(createCreateProjectCommand());
-    program.addCommand(createIterateDesignDraftCommand());
-    program.addCommand(createPlanFlowPagesCommand(), {
+    const addCommandWithOverride = (cmd, opts)=>{
+        cmd.exitOverride();
+        cmd.configureOutput({
+            writeErr: (str)=>{
+                if (!process.argv.includes('--json')) process.stderr.write(str);
+            }
+        });
+        program.addCommand(cmd, opts);
+    };
+    addCommandWithOverride(createLoginCommand());
+    addCommandWithOverride(createLogoutCommand());
+    addCommandWithOverride(createInitCommand());
+    addCommandWithOverride(createCreateProjectCommand());
+    addCommandWithOverride(createIterateDesignDraftCommand());
+    addCommandWithOverride(createPlanFlowPagesCommand(), {
         hidden: true
     });
-    program.addCommand(createExecuteFlowPagesCommand());
-    program.addCommand(createExtractBrandGuideCommand());
-    program.addCommand(createSearchPromptsCommand());
-    program.addCommand(createGetPromptsCommand());
-    program.addCommand(createFetchDesignNodesCommand());
-    program.addCommand(createGetDesignCommand());
-    program.addCommand(createCreateDesignDraftCommand());
+    addCommandWithOverride(createExecuteFlowPagesCommand());
+    addCommandWithOverride(createExtractBrandGuideCommand());
+    addCommandWithOverride(createSearchPromptsCommand());
+    addCommandWithOverride(createGetPromptsCommand());
+    addCommandWithOverride(createFetchDesignNodesCommand());
+    addCommandWithOverride(createGetDesignCommand());
+    addCommandWithOverride(createCreateDesignDraftCommand());
     return program;
 }
 async function run() {
     const program = createProgram();
-    await program.parseAsync(process.argv);
+    try {
+        await program.parseAsync(process.argv);
+    } catch (err) {
+        if (err && 'object' == typeof err && 'code' in err) {
+            const commanderError = err;
+            if ('commander.helpDisplayed' === commanderError.code || 'commander.version' === commanderError.code) process.exit(0);
+            if ('commander.missingMandatoryOptionValue' === commanderError.code) {
+                const hasJsonFlag = process.argv.includes('--json');
+                if (hasJsonFlag) {
+                    const errorOutput = {
+                        error: commanderError.message,
+                        usage: getFailedCommandUsage(program)
+                    };
+                    process.stderr.write(JSON.stringify(errorOutput, null, 2) + '\n');
+                } else {
+                    process.stderr.write('\n');
+                    const helpInfo = getFailedCommandHelp(program);
+                    if (helpInfo) process.stderr.write(helpInfo);
+                }
+                process.exit(1);
+            }
+        }
+        throw err;
+    }
 }
 export { ApiClientError, addDraft, claimSession, clearConfig, createApiClient, createDraft, createProgram, createProject, createPublicApiClient, createSession, executeFlowPages, extractBrandGuide, fetchDesignNodes, getApiClient, getApiKey, getApiUrl, getConfigDir, getConfigPath, getDesignHtml, getJobStatus, getPrompts, manager_isAuthenticated as isAuthenticated, isJobCompleted, isJobDone, isJobFailed, iterateDraft, loadConfig, planFlowPages, pollSession, run, saveConfig, searchPrompts, updateConfig };

package/dist/utils/context-files.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Utilities for reading context files from disk
+ */
+import type { ContextFile } from '../api/drafts';
+/**
+ * Read context files from disk and return as ContextFile array.
+ * Exits the process if any file cannot be read.
+ */
+export declare function readContextFiles(filePaths: string[]): ContextFile[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdesign/cli",
-  "version": "0.1.12",
+  "version": "0.2.0",
   "description": "CLI for SuperDesign Platform - agent skills for Claude Code",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -53,4 +53,4 @@
     "directory": "packages/cli"
   },
   "license": "MIT"
-}
+}