@kaban-board/cli 0.2.4 → 0.2.6

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { createRequire } from "node:module";
+import { createRequire as createRequire2 } from "node:module";
 import { Command as Command12 } from "commander";
 
 // src/commands/add.ts
@@ -802,6 +802,25 @@ import {
   ReadResourceRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
 import { Command as Command6 } from "commander";
+var mcpHelpers = {
+  getParam(args, primary, alias) {
+    if (!args)
+      return;
+    const primaryVal = args[primary];
+    if (typeof primaryVal === "string" && primaryVal.trim())
+      return primaryVal;
+    const aliasVal = args[alias];
+    if (typeof aliasVal === "string" && aliasVal.trim())
+      return aliasVal;
+    return;
+  },
+  errorResponse(message) {
+    return { content: [{ type: "text", text: JSON.stringify({ error: message }) }], isError: true };
+  },
+  jsonResponse(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  }
+};
 function getKabanPaths2(basePath) {
   const base = basePath ?? process.cwd();
   const kabanDir = join4(base, ".kaban");
@@ -867,8 +886,10 @@ async function startMcpServer(workingDirectory) {
         description: "Get a task by its ID",
         inputSchema: {
           type: "object",
-          properties: { id: { type: "string", description: "Task ID (ULID)" } },
-          required: ["id"]
+          properties: {
+            id: { type: "string", description: "Task ID (ULID)" },
+            taskId: { type: "string", description: "Task ID (ULID) - alias for 'id'" }
+          }
         }
       },
       {
@@ -890,10 +911,11 @@ async function startMcpServer(workingDirectory) {
           type: "object",
           properties: {
             id: { type: "string", description: "Task ID (ULID)" },
+            taskId: { type: "string", description: "Task ID (ULID) - alias for 'id'" },
             columnId: { type: "string", description: "Target column ID" },
+            column: { type: "string", description: "Target column ID - alias for 'columnId'" },
             force: { type: "boolean", description: "Force move even if WIP limit exceeded" }
-          },
-          required: ["id", "columnId"]
+          }
         }
       },
       {
@@ -903,6 +925,7 @@ async function startMcpServer(workingDirectory) {
           type: "object",
           properties: {
             id: { type: "string", description: "Task ID (ULID)" },
+            taskId: { type: "string", description: "Task ID (ULID) - alias for 'id'" },
             title: { type: "string", description: "New task title" },
             description: { type: ["string", "null"], description: "New task description" },
             assignedTo: { type: ["string", "null"], description: "Assigned agent name" },
@@ -916,8 +939,7 @@ async function startMcpServer(workingDirectory) {
               type: "number",
               description: "Expected version for optimistic locking"
             }
-          },
-          required: ["id"]
+          }
         }
       },
       {
@@ -925,8 +947,10 @@ async function startMcpServer(workingDirectory) {
         description: "Delete a task",
         inputSchema: {
           type: "object",
-          properties: { id: { type: "string", description: "Task ID (ULID)" } },
-          required: ["id"]
+          properties: {
+            id: { type: "string", description: "Task ID (ULID)" },
+            taskId: { type: "string", description: "Task ID (ULID) - alias for 'id'" }
+          }
         }
       },
       {
@@ -934,8 +958,13 @@ async function startMcpServer(workingDirectory) {
         description: "Mark a task as completed (move to terminal column)",
         inputSchema: {
           type: "object",
-          properties: { id: { type: "string", description: "Task ID (ULID) or partial ID" } },
-          required: ["id"]
+          properties: {
+            id: { type: "string", description: "Task ID (ULID) or partial ID" },
+            taskId: {
+              type: "string",
+              description: "Task ID (ULID) or partial ID - alias for 'id'"
+            }
+          }
         }
       },
       {
@@ -945,6 +974,7 @@ async function startMcpServer(workingDirectory) {
       }
     ]
   }));
+  const { getParam, errorResponse, jsonResponse } = mcpHelpers;
   server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
     try {
@@ -953,15 +983,7 @@ async function startMcpServer(workingDirectory) {
         const targetPath = basePath ?? workingDirectory;
         const { kabanDir, dbPath, configPath } = getKabanPaths2(targetPath);
         if (existsSync5(dbPath)) {
-          return {
-            content: [
-              {
-                type: "text",
-                text: JSON.stringify({ error: "Board already exists in this directory" })
-              }
-            ],
-            isError: true
-          };
+          return errorResponse("Board already exists in this directory");
         }
         mkdirSync2(kabanDir, { recursive: true });
         const config = {
@@ -973,70 +995,77 @@ async function startMcpServer(workingDirectory) {
         await initializeSchema2(db);
         const boardService2 = new BoardService3(db);
         await boardService2.initializeBoard(config);
-        return {
-          content: [
-            {
-              type: "text",
-              text: JSON.stringify({
-                success: true,
-                board: boardName,
-                paths: { database: dbPath, config: configPath }
-              }, null, 2)
-            }
-          ]
-        };
+        return jsonResponse({
+          success: true,
+          board: boardName,
+          paths: { database: dbPath, config: configPath }
+        });
       }
       const { taskService, boardService } = await createContext(workingDirectory);
+      const taskArgs = args;
+      const taskId = getParam(taskArgs, "id", "taskId");
       switch (name) {
         case "kaban_add_task": {
+          const addArgs = args;
+          const title = addArgs?.title;
+          if (typeof title !== "string" || !title.trim()) {
+            return errorResponse("Title required (non-empty string)");
+          }
           const task = await taskService.addTask(args);
-          return { content: [{ type: "text", text: JSON.stringify(task, null, 2) }] };
+          return jsonResponse(task);
         }
         case "kaban_get_task": {
-          const task = await taskService.getTask(args.id);
+          if (!taskId)
+            return errorResponse("Task ID required (use 'id' or 'taskId')");
+          const task = await taskService.getTask(taskId);
           if (!task)
-            return {
-              content: [{ type: "text", text: JSON.stringify({ error: "Task not found" }) }]
-            };
-          return { content: [{ type: "text", text: JSON.stringify(task, null, 2) }] };
+            return errorResponse("Task not found");
+          return jsonResponse(task);
         }
         case "kaban_list_tasks": {
           const tasks = await taskService.listTasks(args);
-          return { content: [{ type: "text", text: JSON.stringify(tasks, null, 2) }] };
+          return jsonResponse(tasks);
         }
         case "kaban_move_task": {
-          const { id, columnId, force } = args;
-          const task = await taskService.moveTask(id, columnId, { force });
-          return { content: [{ type: "text", text: JSON.stringify(task, null, 2) }] };
+          if (!taskId)
+            return errorResponse("Task ID required (use 'id' or 'taskId')");
+          const targetColumn = getParam(taskArgs, "columnId", "column");
+          if (!targetColumn)
+            return errorResponse("Column ID required (use 'columnId' or 'column')");
+          const { force } = args ?? {};
+          const task = await taskService.moveTask(taskId, targetColumn, { force });
+          return jsonResponse(task);
         }
         case "kaban_update_task": {
-          const { id, expectedVersion, ...updates } = args;
-          const task = await taskService.updateTask(id, updates, expectedVersion);
-          return { content: [{ type: "text", text: JSON.stringify(task, null, 2) }] };
+          if (!taskId)
+            return errorResponse("Task ID required (use 'id' or 'taskId')");
+          const {
+            taskId: _t,
+            id: _i,
+            expectedVersion,
+            ...updates
+          } = args ?? {};
+          const task = await taskService.updateTask(taskId, updates, expectedVersion);
+          return jsonResponse(task);
         }
         case "kaban_delete_task": {
-          await taskService.deleteTask(args.id);
-          return { content: [{ type: "text", text: JSON.stringify({ success: true }) }] };
+          if (!taskId)
+            return errorResponse("Task ID required (use 'id' or 'taskId')");
+          await taskService.deleteTask(taskId);
+          return jsonResponse({ success: true });
         }
         case "kaban_complete_task": {
-          const { id } = args;
+          if (!taskId)
+            return errorResponse("Task ID required (use 'id' or 'taskId')");
           const tasks = await taskService.listTasks();
-          const task = tasks.find((t) => t.id.startsWith(id));
+          const task = tasks.find((t) => t.id.startsWith(taskId));
           if (!task)
-            return {
-              content: [
-                { type: "text", text: JSON.stringify({ error: `Task '${id}' not found` }) }
-              ]
-            };
+            return errorResponse(`Task '${taskId}' not found`);
           const terminal = await boardService.getTerminalColumn();
           if (!terminal)
-            return {
-              content: [
-                { type: "text", text: JSON.stringify({ error: "No terminal column configured" }) }
-              ]
-            };
+            return errorResponse("No terminal column configured");
           const completed = await taskService.moveTask(task.id, terminal.id);
-          return { content: [{ type: "text", text: JSON.stringify(completed, null, 2) }] };
+          return jsonResponse(completed);
         }
         case "kaban_status": {
           const board = await boardService.getBoard();
@@ -1049,25 +1078,15 @@ async function startMcpServer(workingDirectory) {
             wipLimit: column.wipLimit,
             isTerminal: column.isTerminal
           }));
-          return {
-            content: [
-              {
-                type: "text",
-                text: JSON.stringify({
-                  board: { name: board?.name ?? "Kaban Board" },
-                  columns: columnStats,
-                  blockedCount: tasks.filter((t) => t.blockedReason).length,
-                  totalTasks: tasks.length
-                }, null, 2)
-              }
-            ]
-          };
+          return jsonResponse({
+            board: { name: board?.name ?? "Kaban Board" },
+            columns: columnStats,
+            blockedCount: tasks.filter((t) => t.blockedReason).length,
+            totalTasks: tasks.length
+          });
         }
         default:
-          return {
-            content: [{ type: "text", text: JSON.stringify({ error: `Unknown tool: ${name}` }) }],
-            isError: true
-          };
+          return errorResponse(`Unknown tool: ${name}`);
       }
     } catch (error2) {
       const message = error2 instanceof Error ? error2.message : String(error2);
@@ -1704,63 +1723,67 @@ var syncCommand = new Command10("sync").description("Sync TodoWrite input to Kab
 import { spawn as spawn3, spawnSync } from "node:child_process";
 import { existsSync as existsSync7 } from "node:fs";
 import { dirname as dirname3, join as join5 } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
 import { Command as Command11 } from "commander";
+var __dirname2 = dirname3(fileURLToPath(import.meta.url));
+var require2 = createRequire(import.meta.url);
+function hasBun() {
+  try {
+    const result = spawnSync("bun", ["--version"], { stdio: "ignore" });
+    return result.status === 0;
+  } catch {
+    return false;
+  }
+}
 function findInPath(name) {
   const result = spawnSync("which", [name], { encoding: "utf-8" });
   return result.status === 0 ? result.stdout.trim() : null;
 }
+function resolveTuiPackage() {
+  try {
+    return require2.resolve("@kaban-board/tui");
+  } catch {
+    return null;
+  }
+}
 function runBinary(path, args) {
   const child = spawn3(path, args, { stdio: "inherit", cwd: process.cwd() });
   child.on("exit", (code) => process.exit(code ?? 0));
 }
-function runBunx(bunPath, args) {
-  let started = false;
-  const child = spawn3(bunPath, ["x", "@kaban-board/tui", ...args], {
-    stdio: "inherit",
-    cwd: process.cwd()
-  });
-  child.on("spawn", () => {
-    started = true;
-  });
-  child.on("error", () => {
-    if (!started)
-      showInstallError();
-  });
-  child.on("exit", (code) => process.exit(code ?? 0));
-  return true;
-}
-function showInstallError() {
-  console.error(`
-Error: kaban-tui not found
-
-The TUI requires Bun runtime. Install with one of:
-
-  # Homebrew (recommended)
-  brew install beshkenadze/tap/kaban-tui
-
-  # Or install Bun, then run via bunx
-  curl -fsSL https://bun.sh/install | bash
-  bunx @kaban-board/tui
-`);
-  process.exit(1);
-}
-var tuiCommand = new Command11("tui").description("Start interactive Terminal UI (requires Bun)").action(async () => {
+var tuiCommand = new Command11("tui").description("Start interactive Terminal UI").action(async () => {
+  const cwd = process.cwd();
   const args = process.argv.slice(3);
+  const useBun = hasBun();
   const siblingBinary = join5(dirname3(process.execPath), "kaban-tui");
   if (existsSync7(siblingBinary))
     return runBinary(siblingBinary, args);
   const pathBinary = findInPath("kaban-tui");
   if (pathBinary)
     return runBinary(pathBinary, args);
-  const bunPath = findInPath("bun");
-  if (bunPath)
-    return runBunx(bunPath, args);
-  showInstallError();
+  const tuiDevEntry = join5(__dirname2, "../../../tui/src/index.ts");
+  if (existsSync7(tuiDevEntry) && useBun) {
+    const child2 = spawn3("bun", ["run", tuiDevEntry], { stdio: "inherit", cwd });
+    child2.on("exit", (code) => process.exit(code ?? 0));
+    return;
+  }
+  if (!useBun) {
+    console.error("TUI requires Bun. Install: curl -fsSL https://bun.sh/install | bash");
+    process.exit(1);
+  }
+  const tuiEntry = resolveTuiPackage();
+  if (tuiEntry) {
+    const child2 = spawn3("bun", [tuiEntry, ...args], { stdio: "inherit", cwd });
+    child2.on("exit", (code) => process.exit(code ?? 0));
+    return;
+  }
+  const child = spawn3("bun", ["x", "@kaban-board/tui", ...args], { stdio: "inherit", cwd });
+  child.on("exit", (code) => process.exit(code ?? 0));
 });
 
 // src/index.ts
-var require2 = createRequire(import.meta.url);
-var pkg = require2("../package.json");
+var require3 = createRequire2(import.meta.url);
+var pkg = require3("../package.json");
 var program = new Command12;
 program.name("kaban").description("Terminal Kanban for AI Code Agents").version(pkg.version);
 program.addCommand(initCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaban-board/cli",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Terminal Kanban for AI Code Agents - CLI and MCP server",
   "type": "module",
   "bin": {
@@ -18,7 +18,8 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.11.0",
-    "@kaban-board/core": "0.1.3",
+    "@kaban-board/core": "0.2.4",
+    "@kaban-board/tui": "0.2.4",
     "@modelcontextprotocol/sdk": "^1.25.2",
     "chalk": "^5.6.2",
     "commander": "^12.0.0",