@klarocards/cli 1.0.0

package/README.md

@@ -0,0 +1,125 @@
+# Klaro CLI
+
+Command-line interface for [Klaro Cards](https://klaro.cards).
+
+## Installation
+
+```bash
+npm install -g @klarocards/cli
+```
+
+Requires Node.js 18.0.0 or higher.
+
+## Getting Started
+
+Login with your Klaro Cards credentials:
+
+```bash
+klaro login [--env]
+```
+
+Select the project you want to work with:
+
+```bash
+klaro ls projects          # see available projects
+klaro use my-project       # set the active project
+```
+
+Explore the project structure:
+
+```bash
+klaro ls boards            # list boards in the project
+klaro ls dimensions        # list available dimensions
+klaro describe board backlog       # see a board's filters
+klaro describe dimension status    # see a dimension's values
+```
+
+Start working with cards:
+
+```bash
+klaro ls                          # list cards (default board)
+klaro ls -b backlog               # list cards from a specific board
+klaro ls --dims status,assignee   # show specific dimensions
+klaro read 42                     # read a card's full content
+klaro create "My new card"        # create a card
+klaro update 42 status=done       # update a card's dimension
+klaro edit 42                     # edit a card in your $EDITOR
+```
+
+Run `klaro cheatsheet` for more examples, or `klaro <command> --help` for detailed usage.
+
+## Usage
+
+```
+Usage: klaro [options] [command]
+
+Command-line interface for Klaro Cards
+
+Options:
+  -V, --version                     output the version number
+  --trace                           Enable API request/response tracing
+  --show <dimensions>               Dimensions to display (comma-separated)
+  --board <board>                   Board identifier
+  --save-defaults                   Save --show and --board as project defaults
+  -h, --help                        display help for command
+
+Commands:
+  login                             Login to Klaro Cards
+  logout                            Logout from Klaro Cards
+  whoami                            Show the currently logged in user
+  use <subdomain>                   Set the default Klaro project
+  ls                                List cards, projects, boards, or dimensions
+  create [options] [title]          Create a new card in a board
+  del [options] <identifiers...>    Delete one or more cards by identifier
+  set [options] <identifiers...>    Update one or more cards by identifier
+  read [options] <identifiers...>   Read one or more cards and display as markdown
+  edit [options] <identifiers...>   Edit one or more cards in your default editor
+  config                            Manage project configuration and defaults
+  init [options] [folder]           Initialize Klaro configuration
+  cheatsheet [options]              Display a quick reference guide
+  fetch [options] <identifiers...>  Download cards as markdown files for offline editing
+  sync [options]                    Upload local card changes and delete synced files
+  help [command]                    display help for command
+```
+
+Run `klaro cheatsheet` for common usage examples.
+
+## Development
+
+```bash
+npm install     # Install dependencies
+npm run build   # Build
+npm test        # Run tests
+```
+
+### Running from source
+
+Build and run directly:
+
+```bash
+npm run build
+node dist/index.js
+```
+
+Or use watch mode for development (auto-recompiles on changes):
+
+```bash
+npm run dev
+```
+
+Then in another terminal:
+
+```bash
+node dist/index.js
+```
+
+To make the `klaro` command available globally from your local checkout:
+
+```bash
+npm link
+klaro
+```
+
+## License
+
+MIT

package/dist/commands/cheatsheet.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createCheatsheetCommand(): Command;
+//# sourceMappingURL=cheatsheet.d.ts.map

package/dist/commands/cheatsheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cheatsheet.d.ts","sourceRoot":"","sources":["../../src/commands/cheatsheet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2EpC,wBAAgB,uBAAuB,IAAI,OAAO,CAajD"}

package/dist/commands/cheatsheet.js

@@ -0,0 +1,80 @@
+import { Command } from 'commander';
+import { Bmg } from '@enspirit/bmg-js';
+import { renderMarkdown } from '../utils/markdown.js';
+const INTRO = `Klaro CLI is a command-line interface for managing cards on Klaro Cards.
+It is designed to be AI-agent friendly, enabling seamless integration with
+tools like Claude Code for backlog, task and project management workflows.`;
+const TIPS = `- Use \`--raw\` with \`read\` to get plain markdown without highlighting
+- Cards are identified by their numeric identifier (shown in ls output)
+- Most commands support \`-p <project>\` to override the active project
+
+Run \`klaro --help\` for all available commands and options.
+Run \`klaro <command> --help\` for detailed help on a specific command.`;
+const EXAMPLES = Bmg([
+    { category: 'Setup', example: 'klaro init .', explanation: 'Initialize klaro in current directory' },
+    { category: 'Setup', example: 'klaro login', explanation: 'Authenticate with email/password' },
+    { category: 'Setup', example: 'klaro use <project>', explanation: 'Set active project by subdomain' },
+    { category: 'Listing', example: 'klaro ls', explanation: 'List cards (default board: all)' },
+    { category: 'Listing', example: 'klaro ls -b backlog', explanation: 'List from specific board' },
+    { category: 'Listing', example: 'klaro ls --dims progress', explanation: 'Show specific dimensions' },
+    { category: 'Listing', example: 'klaro ls --filter status=open', explanation: 'Filter by dimension value' },
+    { category: 'Listing', example: 'klaro ls projects', explanation: 'List available projects' },
+    { category: 'Listing', example: 'klaro ls boards', explanation: 'List boards in project' },
+    { category: 'Listing', example: 'klaro ls dimensions', explanation: 'List dimensions in project' },
+    { category: 'Reading', example: 'klaro read 1', explanation: 'Read card as markdown' },
+    { category: 'Reading', example: 'klaro read 1 2 3', explanation: 'Read multiple cards' },
+    { category: 'Reading', example: 'klaro read 1 --dims progress', explanation: 'Include dimensions in output' },
+    { category: 'Editing', example: 'klaro edit 1', explanation: 'Edit card in $EDITOR' },
+    { category: 'Editing', example: 'klaro edit 1 2 3', explanation: 'Edit multiple cards sequentially' },
+    { category: 'Editing', example: 'klaro edit 1 --dims progress', explanation: 'Include dimensions in editor' },
+    { category: 'Creating', example: 'klaro create "Card title"', explanation: 'Create new card with title' },
+    { category: 'Creating', example: 'klaro create @card.md', explanation: 'Create from markdown file' },
+    { category: 'Creating', example: 'cat card.md | klaro create', explanation: 'Create from stdin' },
+    { category: 'Creating', example: 'klaro create "Title" -b backlog', explanation: 'Create in specific board' },
+    { category: 'Duplicating', example: 'klaro read 3 | klaro create', explanation: 'Duplicate card 3' },
+    { category: 'Duplicating', example: 'klaro read 3 | klaro create assignee=Bob', explanation: 'Duplicate and reassign' },
+    { category: 'Updating', example: 'klaro update 1 progress=done', explanation: 'Update a dimension' },
+    { category: 'Updating', example: 'klaro upd 1 2 3 progress=done', explanation: 'Update multiple cards' },
+    { category: 'Updating', example: 'klaro del 1', explanation: 'Delete a card' },
+    { category: 'Offline', example: 'klaro fetch 1 2 3', explanation: 'Download cards as markdown files' },
+    { category: 'Offline', example: 'klaro fetch 1 --dims progress', explanation: 'Include dimensions in downloaded files' },
+    { category: 'Offline', example: 'klaro sync', explanation: 'Upload changes and delete local files' },
+    { category: 'Offline', example: 'klaro sync --keep', explanation: 'Upload changes but keep local files' },
+    { category: 'Defaults', example: 'klaro config set board backlog', explanation: 'Set default board' },
+    { category: 'Defaults', example: 'klaro config set dims progress,assignee', explanation: 'Set default dimensions' },
+    { category: 'Defaults', example: 'klaro --save-defaults ls --dims progress', explanation: 'Save defaults as you go' },
+    { category: 'Defaults', example: 'klaro config list', explanation: 'View saved defaults' },
+]).group(['example', 'explanation'], 'examples', { allbut: true });
+function buildCheatsheet(table) {
+    const lines = ['# Klaro CLI', '', INTRO, ''];
+    if (table) {
+        lines.push(EXAMPLES.toText({ border: 'rounded' }));
+    }
+    else {
+        for (const { category, examples } of EXAMPLES.tuples) {
+            lines.push(`## ${category}`, '');
+            for (const { example, explanation } of examples.tuples) {
+                lines.push(`${example.padEnd(45)} # ${explanation}`);
+            }
+            lines.push('');
+        }
+    }
+    lines.push('## Tips', '', TIPS);
+    return lines.join('\n');
+}
+export function createCheatsheetCommand() {
+    return new Command('cheatsheet')
+        .description('Display a quick reference guide')
+        .option('--table', 'Display in table format (for humans)')
+        .option('--raw', 'Output without syntax highlighting')
+        .action((options) => {
+        const content = buildCheatsheet(options.table ?? false);
+        if (options.raw) {
+            console.log(content);
+        }
+        else {
+            console.log(renderMarkdown(content));
+        }
+    });
+}
+//# sourceMappingURL=cheatsheet.js.map

package/dist/commands/cheatsheet.js.map

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

package/dist/commands/completion.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createCompletionCommand(): Command;
+//# sourceMappingURL=completion.d.ts.map

package/dist/commands/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0LpC,wBAAgB,uBAAuB,IAAI,OAAO,CAuCjD"}

package/dist/commands/completion.js

@@ -0,0 +1,191 @@
+import { Command } from 'commander';
+import { generateBashCompletion } from '../completions/bash.js';
+import { generateZshCompletion } from '../completions/zsh.js';
+import { generateFishCompletion } from '../completions/fish.js';
+import { getCachedProjects, getCachedBoards, setCachedProjects, setCachedBoards, } from '../lib/completion-cache.js';
+import { createClient } from '../lib/api.js';
+import { getToken, getProject } from '../lib/config.js';
+function detectShell() {
+    const shell = process.env.SHELL ?? '';
+    if (shell.includes('zsh'))
+        return 'zsh';
+    if (shell.includes('bash'))
+        return 'bash';
+    if (shell.includes('fish'))
+        return 'fish';
+    return null;
+}
+function generateCompletion(shell) {
+    switch (shell) {
+        case 'bash':
+            return generateBashCompletion();
+        case 'zsh':
+            return generateZshCompletion();
+        case 'fish':
+            return generateFishCompletion();
+    }
+}
+async function refreshCache() {
+    const token = getToken();
+    const project = getProject();
+    if (!token) {
+        console.error('Not logged in. Run "klaro login" first to enable dynamic completions.');
+        return;
+    }
+    // Refresh projects
+    try {
+        const api = createClient(project ?? 'app', token);
+        const projects = await api.listProjects();
+        setCachedProjects(projects.map(p => ({ subdomain: p.subdomain, label: p.label })));
+        console.log(`Cached ${projects.length} project(s)`);
+    }
+    catch (error) {
+        console.error('Failed to refresh projects cache');
+    }
+    // Refresh boards for current project
+    if (project) {
+        try {
+            const api = createClient(project, token);
+            const boards = await api.listBoards();
+            setCachedBoards(project, boards.map(b => ({ identifier: b.identifier, label: b.label })));
+            console.log(`Cached ${boards.length} board(s) for project "${project}"`);
+        }
+        catch (error) {
+            console.error(`Failed to refresh boards cache for project "${project}"`);
+        }
+    }
+}
+async function completionAction(shell, options) {
+    // Handle internal options for shell scripts
+    if (options.listProjects) {
+        const projects = getCachedProjects();
+        if (projects.length > 0) {
+            console.log(projects.join('\n'));
+        }
+        else {
+            // Try to refresh cache silently
+            const token = getToken();
+            if (token) {
+                try {
+                    const api = createClient(getProject() ?? 'app', token);
+                    const freshProjects = await api.listProjects();
+                    setCachedProjects(freshProjects.map(p => ({ subdomain: p.subdomain, label: p.label })));
+                    console.log(freshProjects.map(p => p.subdomain).join('\n'));
+                }
+                catch {
+                    // Silent failure
+                }
+            }
+        }
+        return;
+    }
+    if (options.listBoards) {
+        const project = getProject();
+        if (!project)
+            return;
+        const boards = getCachedBoards(project);
+        if (boards.length > 0) {
+            console.log(boards.join('\n'));
+        }
+        else {
+            // Try to refresh cache silently
+            const token = getToken();
+            if (token) {
+                try {
+                    const api = createClient(project, token);
+                    const freshBoards = await api.listBoards();
+                    setCachedBoards(project, freshBoards.map(b => ({ identifier: b.identifier, label: b.label })));
+                    console.log(freshBoards.map(b => b.identifier).join('\n'));
+                }
+                catch {
+                    // Silent failure
+                }
+            }
+        }
+        return;
+    }
+    // No shell specified, detect or prompt
+    if (!shell) {
+        const detected = detectShell();
+        if (detected) {
+            console.log(generateCompletion(detected));
+        }
+        else {
+            console.error('Could not detect shell. Please specify: klaro completion bash|zsh|fish');
+            process.exit(1);
+        }
+        return;
+    }
+    // Validate shell argument
+    if (!['bash', 'zsh', 'fish'].includes(shell)) {
+        console.error(`Unknown shell: ${shell}. Supported shells: bash, zsh, fish`);
+        process.exit(1);
+        return;
+    }
+    console.log(generateCompletion(shell));
+}
+async function refreshAction() {
+    await refreshCache();
+}
+async function installAction() {
+    const shell = detectShell();
+    if (!shell) {
+        console.error('Could not detect shell. Please add completion manually.');
+        console.error('');
+        console.error('Bash: Add to ~/.bashrc:');
+        console.error('  eval "$(klaro completion bash)"');
+        console.error('');
+        console.error('Zsh: Add to ~/.zshrc:');
+        console.error('  eval "$(klaro completion zsh)"');
+        console.error('');
+        console.error('Fish: Add to ~/.config/fish/config.fish:');
+        console.error('  klaro completion fish | source');
+        process.exit(1);
+        return;
+    }
+    console.log(`Detected shell: ${shell}`);
+    console.log('');
+    console.log('Add the following line to your shell configuration:');
+    console.log('');
+    switch (shell) {
+        case 'bash':
+            console.log('  # Add to ~/.bashrc');
+            console.log('  eval "$(klaro completion bash)"');
+            break;
+        case 'zsh':
+            console.log('  # Add to ~/.zshrc');
+            console.log('  eval "$(klaro completion zsh)"');
+            break;
+        case 'fish':
+            console.log('  # Add to ~/.config/fish/config.fish');
+            console.log('  klaro completion fish | source');
+            break;
+    }
+    console.log('');
+    console.log('Then restart your shell or source the config file.');
+}
+export function createCompletionCommand() {
+    const cmd = new Command('completion')
+        .description('Generate shell completion scripts')
+        .argument('[shell]', 'Shell type (bash, zsh, fish)')
+        .option('--list-projects', 'List cached projects (internal)', false)
+        .option('--list-boards', 'List cached boards (internal)', false)
+        .action(completionAction);
+    cmd.addCommand(new Command('bash')
+        .description('Generate bash completions')
+        .action(() => console.log(generateBashCompletion())));
+    cmd.addCommand(new Command('zsh')
+        .description('Generate zsh completions')
+        .action(() => console.log(generateZshCompletion())));
+    cmd.addCommand(new Command('fish')
+        .description('Generate fish completions')
+        .action(() => console.log(generateFishCompletion())));
+    cmd.addCommand(new Command('install')
+        .description('Show installation instructions')
+        .action(installAction));
+    cmd.addCommand(new Command('refresh')
+        .description('Refresh completion cache')
+        .action(refreshAction));
+    return cmd;
+}
+//# sourceMappingURL=completion.js.map

package/dist/commands/completion.js.map

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

package/dist/commands/config.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createConfigCommand(): Command;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8EpC,wBAAgB,mBAAmB,IAAI,OAAO,CA0B7C"}

package/dist/commands/config.js

@@ -0,0 +1,77 @@
+import { Command } from 'commander';
+import { requireProject } from '../lib/config.js';
+import { setProjectDefault, unsetProjectDefault, listProjectDefaults, getProjectDefaults, } from '../lib/defaults.js';
+function setAction(key, value, _options, command) {
+    try {
+        const globalOpts = command.optsWithGlobals();
+        const project = requireProject(globalOpts.project);
+        if (!isValidKey(key)) {
+            console.error(`Error: Unknown option "${key}". Valid options: board, dims`);
+            process.exit(1);
+            return;
+        }
+        setProjectDefault(project, key, value);
+        console.log(`Set default ${key}="${value}" for project "${project}"`);
+    }
+    catch (error) {
+        console.error(error.message);
+        process.exit(1);
+    }
+}
+function unsetAction(key, _options, command) {
+    try {
+        const globalOpts = command.optsWithGlobals();
+        const project = requireProject(globalOpts.project);
+        if (!isValidKey(key)) {
+            console.error(`Error: Unknown option "${key}". Valid options: board, dims`);
+            process.exit(1);
+            return;
+        }
+        unsetProjectDefault(project, key);
+        console.log(`Removed default for "${key}" from project "${project}"`);
+    }
+    catch (error) {
+        console.error(error.message);
+        process.exit(1);
+    }
+}
+function listAction(_options, command) {
+    try {
+        const globalOpts = command.optsWithGlobals();
+        const project = requireProject(globalOpts.project);
+        const defaults = listProjectDefaults(project);
+        const projectDefaults = getProjectDefaults(project);
+        console.log(`Defaults for project "${project}":\n`);
+        for (const [key, value] of Object.entries(defaults)) {
+            const source = projectDefaults[key] !== undefined
+                ? '(configured)'
+                : '(default)';
+            console.log(`  ${key}: ${value} ${source}`);
+        }
+    }
+    catch (error) {
+        console.error(error.message);
+        process.exit(1);
+    }
+}
+function isValidKey(key) {
+    return key === 'board' || key === 'dims';
+}
+export function createConfigCommand() {
+    const cmd = new Command('config')
+        .description('Manage project configuration and defaults');
+    cmd.addCommand(new Command('set')
+        .description('Set a default option value for the current project')
+        .argument('<key>', 'Option name (board or dims)')
+        .argument('<value>', 'Default value')
+        .action(setAction));
+    cmd.addCommand(new Command('unset')
+        .description('Remove a default option value for the current project')
+        .argument('<key>', 'Option name to remove (board or dims)')
+        .action(unsetAction));
+    cmd.addCommand(new Command('list')
+        .description('List all default option values for the current project')
+        .action(listAction));
+    return cmd;
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

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

package/dist/commands/create.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createCreateCommand(): Command;
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyHpC,wBAAgB,mBAAmB,IAAI,OAAO,CAQ7C"}

package/dist/commands/create.js

@@ -0,0 +1,121 @@
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { createClient, KlaroApiError } from '../lib/api.js';
+import { requireProject, requireToken } from '../lib/config.js';
+import { resolveBoard, resolveDims } from '../lib/defaults.js';
+import { splitArgs, parseDimensions } from '../utils/dimensions.js';
+import { editStoryInEditor } from '../utils/story-editor.js';
+import { printTable } from '../utils/table.js';
+import { parseStoryMarkdown } from '../utils/story-markdown.js';
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString('utf-8');
+}
+function readFromFile(path) {
+    return readFileSync(path, 'utf-8');
+}
+async function createAction(args, options, command) {
+    try {
+        const globalOpts = command.optsWithGlobals();
+        const project = requireProject(globalOpts.project);
+        const token = requireToken();
+        const board = resolveBoard(globalOpts.board ?? options.board, project);
+        // Split args into title/file and key=value dimensions
+        const { regularArgs, dimensionArgs } = splitArgs(args);
+        const titleOrFile = regularArgs[0];
+        const cliDimensions = parseDimensions(dimensionArgs);
+        let title;
+        let specification;
+        let fileDimensions = {};
+        if (!titleOrFile) {
+            // No argument - read from stdin
+            if (process.stdin.isTTY) {
+                console.error('Error: No title provided. Use a title argument, @file.md, or pipe content.');
+                process.exit(1);
+                return;
+            }
+            const content = await readStdin();
+            const parsed = parseStoryMarkdown(content);
+            title = parsed.title;
+            specification = parsed.specification;
+            fileDimensions = parsed.dimensions ?? {};
+        }
+        else if (titleOrFile.startsWith('@')) {
+            // @file.md syntax - read from file
+            const filePath = titleOrFile.slice(1);
+            if (!filePath) {
+                console.error('Error: No file path provided after @');
+                process.exit(1);
+                return;
+            }
+            const content = readFromFile(filePath);
+            const parsed = parseStoryMarkdown(content);
+            title = parsed.title;
+            specification = parsed.specification;
+            fileDimensions = parsed.dimensions ?? {};
+        }
+        else {
+            // Plain title argument
+            title = titleOrFile;
+        }
+        const api = createClient(project, token);
+        const input = {
+            title,
+            specification,
+            ...fileDimensions,
+            ...cliDimensions, // CLI dimensions override file dimensions
+        };
+        let story = await api.createStory(board, input);
+        // If --edit flag is set, open the card in editor immediately
+        if (options.edit) {
+            const dimsOpt = resolveDims(globalOpts.dims ?? options.dims, project);
+            const dimensions = dimsOpt?.split(',').map((d) => d.trim());
+            const result = editStoryInEditor(story, dimensions);
+            if (result.error) {
+                console.error(result.error);
+                process.exit(1);
+                return;
+            }
+            if (result.changed && result.update) {
+                const updated = await api.updateStories(board, [result.update]);
+                story = updated[0];
+                console.log(`Card ${story.identifier} created and updated.`);
+            }
+            else {
+                console.log(`Card ${story.identifier} created (no edits made).`);
+            }
+        }
+        else {
+            // Display created card in table format (like ls does)
+            const dimsOpt = resolveDims(globalOpts.dims ?? options.dims, project);
+            const dimColumns = dimsOpt?.split(',').map((d) => d.trim()) ?? [];
+            const columns = ['identifier', 'title', ...dimColumns];
+            printTable([story], columns);
+        }
+    }
+    catch (error) {
+        if (error instanceof KlaroApiError) {
+            console.error(`Error: ${error.message}`);
+        }
+        else if (error instanceof Error) {
+            console.error(`Error: ${error.message}`);
+        }
+        else {
+            console.error('An unexpected error occurred');
+        }
+        process.exit(1);
+    }
+}
+export function createCreateCommand() {
+    return new Command('create')
+        .description('Create a new card in a board')
+        .argument('[args...]', 'Card title (or @file.md), followed by optional key=value dimensions')
+        .option('-b, --board <board>', 'Board identifier (default: "all")')
+        .option('--dims <dimensions>', 'Dimensions to include (comma-separated)')
+        .option('-e, --edit', 'Open the card in editor immediately after creation')
+        .action(createAction);
+}
+//# sourceMappingURL=create.js.map