@legdev/tkxr 1.1.11

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andrew Hein
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,477 @@
+# tkxr - In-Repo Ticket Management System
+
+tkxr is a lightweight, file-based ticket management system with a modern web UI for human users, and CLI/MCP server interfaces for AI and automation. It uses chunked NDJSON for tickets/comments and JSON for sprints/users, ensuring scalable, fast, and version-controlled workflows. Ideal for small teams wanting Jira-like functionality without external dependencies.
+
+## Features
+
+- 📁 **File-based Storage** - Tickets and comments stored as NDJSON chunks, sprints/users as JSON
+- 🌐 **Web Dashboard** - The primary interface for humans to view, manage, and interact with tickets, sprints, users, and comments
+- 🚀 **CLI Interface** - Designed for automation, scripting, and AI agents to manage tickets
+- 🤖 **AI Integration** - MCP server enables AI assistants to interact with tickets, sprints, users, and comments
+- 🔄 **Real-time Updates** - WebSocket-powered live updates
+- 🏃 **Sprint Management** - Complete sprint lifecycle management
+- 👥 **User Management** - Assign tickets to team members
+- 💬 **Comment Support** - Add, list, and manage comments for tickets
+- ⚡ **Zero Dependencies** - No external databases required
+
+## Installation
+
+### Run tkxr instantly with npx or pnpm dlx
+
+You do not need to install tkxr globally. Run any command directly using pnpm dlx or npx:
+
+```bash
+# Using pnpm dlx
+pnpm dlx tkxr serve         # Start the web interface
+pnpm dlx tkxr mcp           # Start the MCP server
+pnpm dlx tkxr list          # List tickets
+pnpm dlx tkxr create task "Title"  # Create a task
+pnpm dlx tkxr comments <ticket-id>  # Manage comments
+
+# Using npx
+npx tkxr serve              # Start the web interface
+npx tkxr mcp                # Start the MCP server
+npx tkxr list               # List tickets
+npx tkxr create task "Title"       # Create a task
+npx tkxr comments <ticket-id>      # Manage comments
+```
+
+Global install is optional:
+
+```bash
+pnpm install -g tkxr
+```
+
+## Quick Start
+> **Human users:** Use the web UI for all ticket management, sprint planning, and user interactions. Open http://localhost:8080 after running `pnpm dlx tkxr serve`.
+> **AI/automation:** Use the CLI or MCP server for programmatic access, scripting, and integration with AI tools.
+
+### 1. Create your first tickets and comments
+
+```bash
+tkxr create task "Implement user login"
+tkxr create bug "Fix navigation menu"
+tkxr sprint create "Sprint 1 - Authentication"
+tkxr user create johndoe "John Doe" --email john@example.com
+# Add a comment to a ticket
+tkxr comments tas-AbCdEfGh --add --author johndoe --content "This is a comment"
+```
+
+### 2. List and manage entities
+
+```bash
+tkxr list
+tkxr users
+tkxr sprints
+tkxr sprint status spr-abc123 active
+tkxr comments tas-AbCdEfGh           # List comments for a ticket
+```
+
+### 3. Update ticket status
+
+```bash
+# Mark ticket as in progress
+tkxr status tas-AbCdEfGh progress
+
+# Mark ticket as done
+tkxr status tas-AbCdEfGh done
+```
+
+### 4. Start interfaces
+
+```bash
+# Web interface (human-friendly)
+tkxr serve
+
+# MCP server (AI integration)
+tkxr mcp
+```
+
+Open http://localhost:8080 in your browser to access the web dashboard.
+
+## CLI Commands
+
+### Ticket & Comment Commands
+
+```bash
+# Create tickets with options
+tkxr create task "Task title" \
+  --description "Detailed description" \
+  --assignee usr-12345678 \
+  --sprint spr-12345678 \
+  --priority high \
+  --estimate 5
+
+tkxr create bug "Bug title" \
+  --description "Bug description" \
+  --priority critical
+
+# List tickets
+tkxr list                    # All tickets
+tkxr list tasks              # Only tasks
+tkxr list bugs               # Only bugs
+
+# Update status
+tkxr status <ticket-id> <status>
+# Valid statuses: todo, progress, done
+
+tkxr delete <ticket-id>
+
+# Comment management
+tkxr comments <ticket-id>             # List comments
+tkxr comments <ticket-id> --add --author <user-id> --content "Comment text"   # Add comment
+```
+
+### User Management
+
+```bash
+# List all users
+tkxr users
+
+# Create a new user
+tkxr user create <username> <displayName> [--email <email>]
+
+# Examples
+tkxr user create johndoe "John Doe"
+tkxr user create alice "Alice Smith" --email alice@example.com
+```
+
+### Sprint Management
+
+```bash
+# List all sprints
+tkxr sprints
+
+# List sprints by status
+tkxr sprints --status active
+
+# Create a new sprint
+tkxr sprint create <name> [options]
+
+# Sprint creation options
+tkxr sprint create "Sprint 2" \
+  --description "Feature development sprint" \
+  --goal "Complete user authentication"
+
+# Update sprint status
+tkxr sprint status <sprint-id> <status>
+# Valid statuses: planning, active, completed
+
+# Examples
+tkxr sprint status spr-abc123 active
+tkxr sprint status spr-def456 completed
+```
+
+### Server Commands
+
+```bash
+# Web interface server
+tkxr serve                   # Start on localhost:8080
+tkxr serve --port 3000       # Custom port
+tkxr serve --host 0.0.0.0    # Custom host
+
+# MCP server for AI integration
+tkxr mcp                     # Start MCP server
+```
+
+## AI Integration (MCP Server)
+
+tkxr includes a Model Context Protocol (MCP) server that enables AI assistants to manage tickets through standardized tool calls.
+
+### Starting the MCP Server
+
+```bash
+npx tkxr mcp           # If not installed globally
+pnpm dlx tkxr mcp      # Or use pnpm dlx
+tkxr mcp               # Only if installed globally
+```
+
+### Available MCP Tools
+
+The MCP server provides these tools for AI assistants:
+
+- `list_tickets` - List all tickets with optional filtering
+- `create_ticket` - Create new tasks or bugs
+- `update_ticket_status` - Change ticket status
+- `delete_ticket` - Remove tickets
+- `list_users` / `create_user` - User management
+- `list_sprints` / `create_sprint` / `update_sprint_status` - Sprint management
+- `list_comments` / `add_comment` - Comment management
+
+### AI Usage Examples
+
+With the MCP server running, AI assistants can:
+
+```
+"Show me all open tasks in the current sprint"
+"Create a new bug for the login issue and assign it to John"
+"Move all completed tickets from Sprint 1 to done status"
+"Start Sprint 2 and create initial planning tasks"
+```
+
+### MCP Configuration
+
+Configure your AI assistant to connect to the MCP server:
+
+```json
+{
+  "mcpServers": {
+    "tkxr": {
+      "command": "tkxr-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+## Web Interface Features
+
+### Dashboard
+- 📊 Overview statistics (sprint-aware)
+- 🎯 **Sprint dropdown filter** - Filter by specific sprint or "No Sprint"
+- 📋 Ticket cards with status indicators
+- 💬 Comment modal for ticket conversations
+- 🔄 Real-time updates via WebSocket
+- 📈 Dynamic stats that update based on sprint selection
+
+### Sprint Filtering
+- **All Tickets** - Show everything
+- **No Sprint** - Show unassigned tickets  
+- **Active Sprints** - Filter by specific sprint (completed sprints hidden)
+- Stats and tab counts update automatically based on selected sprint
+
+### Ticket Management
+- ✅ Quick status updates
+- 📝 Create new tickets with rich forms
+- 🏷️ Priority and label management
+- 👤 User assignment
+- 🏃 Sprint assignment (only active/planning sprints shown)
+
+### Sprint Management
+- 🏃 **Complete sprint lifecycle**: planning → active → completed
+- 🎯 Sprint status buttons (Start, Complete, Reopen)
+- 📋 Sprint creation with description and goals
+- 🚫 Smart filtering (completed sprints hidden from ticket creation)
+
+### Visual Indicators
+- 🟦 Tasks (blue)
+- 🔴 Bugs (red)
+- 🟡 In Progress (yellow)
+- 🟢 Done (green)
+- ⚪ Todo (gray)
+
+## File Structure
+
+tkxr organizes tickets, comments, sprints, and users in your repository:
+
+```
+tkxr/
+├── tickets/
+│   ├── tickets-0001.ndjson
+│   └── tickets-0002.ndjson
+├── comments/
+│   ├── comments-0001.ndjson
+│   └── comments-0002.ndjson
+├── sprints.json
+├── users.json
+```
+
+### Example Files
+
+#### Ticket (NDJSON)
+Each line is a JSON object:
+{"id":"tas-12AbCdEfGh","type":"task","title":"Implement user authentication","description":"Add user authentication system...","status":"progress","assignee":"usr-98XyZaBc","sprint":"spr-45FgHiJk","estimate":8,"priority":"high","createdAt":"2026-02-19T10:30:00.000Z","updatedAt":"2026-02-19T14:15:00.000Z"}
+
+#### Sprint (JSON)
+{
+  "id": "spr-45FgHiJk",
+  "name": "Sprint 1 - Authentication",
+  "description": "Implement core authentication features",
+  "status": "active",
+  "goal": "Complete user login and registration",
+  "createdAt": "2026-02-19T09:00:00.000Z",
+  "updatedAt": "2026-02-19T11:00:00.000Z"
+}
+
+#### User (JSON)
+{
+  "id": "usr-98XyZaBc",
+  "username": "johndoe",
+  "displayName": "John Doe",
+  "email": "john@example.com",
+  "createdAt": "2026-02-19T08:00:00.000Z",
+  "updatedAt": "2026-02-19T08:00:00.000Z"
+}
+#### Comment (NDJSON)
+Each line is a JSON object:
+{"id":"com-1a2b3c4d","ticketId":"tas-12AbCdEfGh","author":"usr-98XyZaBc","content":"This is a comment","createdAt":"2026-02-19T12:00:00.000Z"}
+
+## Advanced Usage
+# Comment workflows
+tkxr comments tas-12AbCdEf --add --author johndoe --content "Ready for review"
+tkxr comments tas-12AbCdEf           # List all comments for ticket
+
+### Sprint Workflow
+
+```bash
+# Complete sprint lifecycle
+tkxr sprint create "Sprint 1" --goal "Complete MVP"
+tkxr sprint status spr-abc123 active
+tkxr create task "Add login" --sprint spr-abc123
+tkxr create task "Add dashboard" --sprint spr-abc123
+# ... work on tickets ...
+tkxr sprint status spr-abc123 completed
+
+# Planning next sprint
+tkxr sprint create "Sprint 2" --goal "User management"
+# Only active/planning sprints appear in ticket creation
+```
+
+### Integration with Git
+
+Since tickets are files, they integrate naturally with Git:
+
+```bash
+# Track ticket changes
+git add tickets/
+git commit -m "Add feature tickets for sprint 1"
+
+# Branch-specific tickets
+git checkout feature/auth
+tkxr create task "Add OAuth integration"
+
+# Review ticket history
+git log --follow tickets/tasks/tas-12345678.yaml
+```
+
+### AI-Powered Workflows
+
+```bash
+# Start MCP server for AI integration
+tkxr mcp
+
+# AI can now:
+# - Analyze ticket backlogs
+# - Create tickets from requirements
+# - Update sprint progress
+# - Generate reports
+# - Manage assignments
+```
+
+## API Reference
+# Comments
+GET  /api/comments/:ticketId         # List comments for ticket
+POST /api/comments/:ticketId         # Add comment to ticket
+
+### REST API
+
+When running `tkxr serve`, the following API endpoints are available:
+
+```
+# Tickets
+GET  /api/tickets                    # All tickets
+GET  /api/tickets/:type              # Tickets by type (task/bug)
+POST /api/tickets                    # Create ticket
+PUT  /api/tickets/:id/status         # Update ticket status
+DELETE /api/tickets/:id              # Delete ticket
+
+# Users
+GET  /api/users                      # All users
+POST /api/users                      # Create user
+DELETE /api/users/:id               # Delete user
+
+# Sprints
+GET  /api/sprints                    # All sprints
+POST /api/sprints                    # Create sprint
+PUT  /api/sprints/:id/status         # Update sprint status
+DELETE /api/sprints/:id              # Delete sprint
+```
+
+### WebSocket Events
+
+```javascript
+// Connect to WebSocket
+const ws = new WebSocket('ws://localhost:8080/ws');
+
+// Listen for updates
+ws.onmessage = (event) => {
+  const message = JSON.parse(event.data);
+  console.log('Update:', message.type, message.data);
+};
+```
+
+## Configuration
+# Server Configuration
+
+The `.env.tkxr` file is dynamically created by the web UI server. It stores the host, port, and URL for the web interface (default: http://localhost:8080) in standard dotenv format:
+
+```
+TKXR_HOST=localhost
+TKXR_PORT=8080
+```
+
+You can override the web UI port by editing `.env.tkxr`, using CLI flags:
+
+```bash
+pnpm dlx tkxr serve --port 3000
+```
+### Development
+
+```bash
+# Clone and develop
+git clone <repo>
+cd tkxr
+npm install
+
+# Build CLI and web interface
+npm run build
+
+# Develop web interface
+cd src/web
+npm install
+npm run dev
+
+# Test MCP server
+npm run build
+tkxr mcp
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch: `git checkout -b feature/amazing-feature`
+3. Commit your changes: `git commit -m 'Add amazing feature'`
+4. Push to the branch: `git push origin feature/amazing-feature`
+5. Open a Pull Request
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for a detailed history of all notable changes.
+
+### Recent Highlights
+- Automated patch version bump and sync for root and web package.json on each build
+- Version badge in web UI now reflects actual package version
+- CLI command added for manual version bump and sync
+- Changelog is updated automatically with each build
+- Complete Sprint button bug fixed
+
+## Version Management
+
+### Automatic Patch Bump
+Every build automatically bumps the patch version and syncs both root and web package.json files. This is handled by the `scripts/bump-version.js` script, which also updates the changelog.
+
+### Manual Version Control
+You can manually bump the patch, minor, or major version using the CLI:
+
+```bash
+node dist/cli/index.js version --bump patch   # Patch bump
+node dist/cli/index.js version --bump minor   # Minor bump
+node dist/cli/index.js version --bump major   # Major bump
+node dist/cli/index.js version                # Show current version
+```
+
+Both methods keep the root and web package.json files in sync.

package/dist/cli/commands/comments.d.ts

@@ -0,0 +1,10 @@
+import type minimist from 'minimist';
+interface CommentsArgs extends minimist.ParsedArgs {
+    _: string[];
+    add?: boolean;
+    author?: string;
+    content?: string;
+}
+export declare function manageComments(args: CommentsArgs): Promise<void>;
+export {};
+//# sourceMappingURL=comments.d.ts.map

package/dist/cli/commands/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/comments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAKrC,UAAU,YAAa,SAAQ,QAAQ,CAAC,UAAU;IAChD,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BtE"}

package/dist/cli/commands/comments.js

@@ -0,0 +1,81 @@
+import chalk from 'chalk';
+import { createStorage } from '../../core/storage.js';
+import { notifier } from '../../core/notifier.js';
+export async function manageComments(args) {
+    const [, ticketId] = args._;
+    if (!ticketId) {
+        console.log(chalk.red('Error: Please provide a ticket ID'));
+        console.log(chalk.dim('Usage: tkxr comments <ticket-id> [--add] [--author <author-id>] [--content <content>]'));
+        return;
+    }
+    const storage = await createStorage();
+    try {
+        // Verify ticket exists
+        const result = await storage.findTicket(ticketId);
+        if (!result) {
+            console.log(chalk.red(`Ticket '${ticketId}' not found`));
+            return;
+        }
+        if (args.add) {
+            await addComment(storage, ticketId, args);
+        }
+        else {
+            await listComments(storage, ticketId);
+        }
+    }
+    catch (error) {
+        console.log(chalk.red(`Error: ${error instanceof Error ? error.message : 'Unknown error'}`));
+    }
+}
+async function listComments(storage, ticketId) {
+    const comments = await storage.getComments(ticketId);
+    const users = await storage.getUsers();
+    if (comments.length === 0) {
+        console.log(chalk.yellow(`No comments found for ticket '${ticketId}'`));
+        return;
+    }
+    console.log(chalk.bold(`\n💬 Comments for ticket ${ticketId} (${comments.length})\n`));
+    // Sort comments by creation date
+    const sortedComments = comments.sort((a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime());
+    for (const comment of sortedComments) {
+        const user = users.find((u) => u.id === comment.author);
+        const authorName = user?.displayName || user?.username || comment.author;
+        const createdAt = new Date(comment.createdAt).toLocaleString();
+        console.log(chalk.blue(`📝 ${comment.id}`));
+        console.log(chalk.dim(`   Author: ${authorName}`));
+        console.log(chalk.dim(`   Created: ${createdAt}`));
+        console.log(`   ${comment.content}`);
+        console.log();
+    }
+}
+async function addComment(storage, ticketId, args) {
+    const { author, content } = args;
+    if (!author) {
+        console.log(chalk.red('Error: --author is required when adding a comment'));
+        console.log(chalk.dim('Usage: tkxr comments <ticket-id> --add --author <author-id> --content <content>'));
+        return;
+    }
+    if (!content) {
+        console.log(chalk.red('Error: --content is required when adding a comment'));
+        console.log(chalk.dim('Usage: tkxr comments <ticket-id> --add --author <author-id> --content <content>'));
+        return;
+    }
+    // Verify author exists
+    const users = await storage.getUsers();
+    const user = users.find((u) => u.id === author || u.username === author);
+    if (!user) {
+        console.log(chalk.red(`Error: User '${author}' not found`));
+        console.log(chalk.dim('Use: tkxr users - to see available users'));
+        return;
+    }
+    const comment = await storage.createComment(ticketId, user.id, content);
+    // Ensure the comment is fully saved before sending notification
+    // The createComment method should already call saveProject(), but let's be explicit
+    console.log(chalk.green('✓ Comment added successfully'));
+    console.log(chalk.dim(`  ID: ${comment.id}`));
+    console.log(chalk.dim(`  Author: ${user.displayName || user.username}`));
+    console.log(chalk.dim(`  Content: ${content}`));
+    // Send notification after everything is saved
+    await notifier.notifyCommentCreated(comment);
+}
+//# sourceMappingURL=comments.js.map

package/dist/cli/commands/comments.js.map

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

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

@@ -0,0 +1,11 @@
+import type minimist from 'minimist';
+interface CreateArgs extends minimist.ParsedArgs {
+    assignee?: string;
+    sprint?: string;
+    priority?: string;
+    estimate?: string;
+    description?: string;
+}
+export declare function createTicket(args: CreateArgs): Promise<void>;
+export {};
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAKrC,UAAU,UAAW,SAAQ,QAAQ,CAAC,UAAU;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA6ElE"}

package/dist/cli/commands/create.js

@@ -0,0 +1,74 @@
+import chalk from 'chalk';
+import { createStorage } from '../../core/storage.js';
+import { notifier } from '../../core/notifier.js';
+export async function createTicket(args) {
+    const [, entityType, title] = args._;
+    if (!entityType) {
+        console.log(chalk.red('Error: Entity type is required'));
+        console.log('Usage: tkxr create <type> <title> [options]');
+        console.log('Types: task, bug, sprint, user');
+        return;
+    }
+    if (!title) {
+        console.log(chalk.red('Error: Title is required'));
+        return;
+    }
+    const storage = await createStorage();
+    try {
+        switch (entityType) {
+            case 'task':
+            case 'bug': {
+                const ticket = await storage.createTicket(entityType, title, {
+                    description: args.description,
+                    assignee: args.assignee,
+                    sprint: args.sprint,
+                    priority: args.priority,
+                    estimate: args.estimate ? parseInt(args.estimate) : undefined,
+                });
+                // Notify web UI
+                await notifier.notifyTicketCreated(ticket);
+                console.log(chalk.green(`✓ Created ${entityType}: ${ticket.id}`));
+                console.log(`  Title: ${ticket.title}`);
+                console.log(`  Status: ${ticket.status}`);
+                if (ticket.assignee)
+                    console.log(`  Assignee: ${ticket.assignee}`);
+                if (ticket.sprint)
+                    console.log(`  Sprint: ${ticket.sprint}`);
+                if (ticket.priority)
+                    console.log(`  Priority: ${ticket.priority}`);
+                break;
+            }
+            case 'sprint': {
+                const sprint = await storage.createSprint(title, {
+                    description: args.description,
+                });
+                // Notify web UI
+                await notifier.notifySprintCreated(sprint);
+                console.log(chalk.green(`✓ Created sprint: ${sprint.id}`));
+                console.log(`  Name: ${sprint.name}`);
+                console.log(`  Status: ${sprint.status}`);
+                if (sprint.description)
+                    console.log(`  Description: ${sprint.description}`);
+                break;
+            }
+            case 'user': {
+                // For users, 'title' is the username
+                const displayName = args.description || title;
+                const user = await storage.createUser(title, displayName);
+                // Notify web UI
+                await notifier.notifyUserCreated(user);
+                console.log(chalk.green(`✓ Created user: ${user.id}`));
+                console.log(`  Username: ${user.username}`);
+                console.log(`  Display Name: ${user.displayName}`);
+                break;
+            }
+            default:
+                console.log(chalk.red(`Error: Unknown entity type "${entityType}"`));
+                console.log('Valid types: task, bug, sprint, user');
+        }
+    }
+    catch (error) {
+        console.log(chalk.red(`Error creating ${entityType}: ${error instanceof Error ? error.message : 'Unknown error'}`));
+    }
+}
+//# sourceMappingURL=create.js.map