@task-mcp/cli 1.0.4 → 1.0.5

package/src/commands/inbox.ts

@@ -0,0 +1,269 @@
+/**
+ * CLI Inbox Commands
+ * Quick capture and management of ideas
+ */
+
+import { c } from "../ansi.js";
+import { InboxStore } from "../../../mcp-server/src/storage/inbox-store.js";
+import { TaskStore } from "../../../mcp-server/src/storage/task-store.js";
+import { ProjectStore } from "../../../mcp-server/src/storage/project-store.js";
+import { parseInboxInput } from "../../../shared/src/utils/natural-language.js";
+
+const inboxStore = new InboxStore();
+const taskStore = new TaskStore();
+const projectStore = new ProjectStore();
+
+export interface InboxAddOptions {
+  content: string;
+  source?: string;
+}
+
+export interface InboxListOptions {
+  all?: boolean;
+  status?: "pending" | "promoted" | "discarded";
+}
+
+export interface InboxPromoteOptions {
+  itemId: string;
+  projectId?: string;
+  title?: string;
+  priority?: "critical" | "high" | "medium" | "low";
+}
+
+/**
+ * Add item to inbox with natural language parsing
+ */
+export async function inboxAddCmd(options: InboxAddOptions): Promise<void> {
+  const parsed = parseInboxInput(options.content);
+
+  const item = await inboxStore.add({
+    content: parsed.content,
+    source: options.source ?? "cli",
+    tags: parsed.tags,
+  });
+
+  console.log();
+  console.log(c.green("✓") + " Captured to inbox");
+  console.log();
+  console.log("  " + c.dim("ID:") + " " + c.cyan(item.id));
+  console.log("  " + c.dim("Content:") + " " + item.content);
+  if (parsed.tags?.length) {
+    console.log("  " + c.dim("Tags:") + " " + parsed.tags.map((t) => c.yellow("#" + t)).join(" "));
+  }
+  console.log();
+  console.log(c.dim("Use 'task inbox promote " + item.id + "' to convert to task"));
+  console.log();
+}
+
+/**
+ * List inbox items
+ */
+export async function inboxListCmd(options: InboxListOptions): Promise<void> {
+  const status = options.all ? undefined : (options.status ?? "pending");
+  const items = await inboxStore.list({ status });
+
+  console.log();
+
+  if (items.length === 0) {
+    console.log(c.dim(status ? `No ${status} items in inbox.` : "Inbox is empty."));
+    console.log();
+    return;
+  }
+
+  // Header
+  const title = status ? `Inbox (${status})` : "Inbox (all)";
+  console.log(c.bold(c.cyan(title)) + c.dim(` - ${items.length} items`));
+  console.log(c.dim("─".repeat(50)));
+  console.log();
+
+  for (const item of items) {
+    const statusIcon =
+      item.status === "pending" ? c.yellow("○") :
+      item.status === "promoted" ? c.green("✓") :
+      c.dim("×");
+
+    const date = new Date(item.capturedAt).toLocaleDateString();
+    const tags = item.tags?.length
+      ? " " + item.tags.map((t) => c.dim("#" + t)).join(" ")
+      : "";
+
+    console.log(`${statusIcon} ${c.cyan(item.id)} ${c.dim("(" + date + ")")}`);
+    console.log(`  ${item.content}${tags}`);
+
+    if (item.promotedToTaskId) {
+      console.log(`  ${c.dim("→ Task:")} ${c.green(item.promotedToTaskId)}`);
+    }
+    console.log();
+  }
+}
+
+/**
+ * Show inbox item details
+ */
+export async function inboxGetCmd(itemId: string): Promise<void> {
+  const item = await inboxStore.get(itemId);
+
+  if (!item) {
+    console.log();
+    console.log(c.error(`Inbox item not found: ${itemId}`));
+    console.log();
+    return;
+  }
+
+  console.log();
+  console.log(c.bold(c.cyan("Inbox Item")));
+  console.log(c.dim("─".repeat(40)));
+  console.log();
+  console.log("  " + c.dim("ID:") + " " + item.id);
+  console.log("  " + c.dim("Status:") + " " + formatStatus(item.status));
+  console.log("  " + c.dim("Captured:") + " " + new Date(item.capturedAt).toLocaleString());
+  if (item.source) {
+    console.log("  " + c.dim("Source:") + " " + item.source);
+  }
+  if (item.tags?.length) {
+    console.log("  " + c.dim("Tags:") + " " + item.tags.map((t) => c.yellow("#" + t)).join(" "));
+  }
+  console.log();
+  console.log(c.bold("Content:"));
+  console.log("  " + item.content);
+
+  if (item.promotedToTaskId) {
+    console.log();
+    console.log(c.green("→ Promoted to: " + item.promotedToTaskId));
+  }
+  console.log();
+}
+
+/**
+ * Promote inbox item to task
+ */
+export async function inboxPromoteCmd(options: InboxPromoteOptions): Promise<void> {
+  const item = await inboxStore.get(options.itemId);
+
+  if (!item) {
+    console.log();
+    console.log(c.error(`Inbox item not found: ${options.itemId}`));
+    console.log();
+    return;
+  }
+
+  if (item.status === "promoted") {
+    console.log();
+    console.log(c.warning(`Item already promoted to: ${item.promotedToTaskId}`));
+    console.log();
+    return;
+  }
+
+  // Get project
+  let projectId = options.projectId;
+  if (!projectId) {
+    const projects = await projectStore.list();
+    if (projects.length === 0) {
+      console.log();
+      console.log(c.error("No projects found. Create a project first."));
+      console.log();
+      return;
+    }
+    // Use first project if not specified
+    projectId = projects[0]!.id;
+  }
+
+  const project = await projectStore.get(projectId);
+  if (!project) {
+    console.log();
+    console.log(c.error(`Project not found: ${projectId}`));
+    console.log();
+    return;
+  }
+
+  // Create task
+  const task = await taskStore.create(projectId, {
+    title: options.title ?? item.content.slice(0, 100),
+    description: item.content,
+    priority: options.priority ?? "medium",
+    tags: item.tags,
+  });
+
+  // Mark as promoted
+  await inboxStore.promote(options.itemId, task.id);
+
+  console.log();
+  console.log(c.green("✓") + " Promoted to task");
+  console.log();
+  console.log("  " + c.dim("Task ID:") + " " + c.cyan(task.id));
+  console.log("  " + c.dim("Title:") + " " + task.title);
+  console.log("  " + c.dim("Project:") + " " + project.name);
+  console.log("  " + c.dim("Priority:") + " " + formatPriority(task.priority));
+  console.log();
+}
+
+/**
+ * Discard inbox item
+ */
+export async function inboxDiscardCmd(itemId: string): Promise<void> {
+  const item = await inboxStore.discard(itemId);
+
+  if (!item) {
+    console.log();
+    console.log(c.error(`Inbox item not found: ${itemId}`));
+    console.log();
+    return;
+  }
+
+  console.log();
+  console.log(c.dim("×") + " Discarded: " + item.content.slice(0, 50) + "...");
+  console.log();
+}
+
+/**
+ * Delete inbox item permanently
+ */
+export async function inboxDeleteCmd(itemId: string): Promise<void> {
+  const deleted = await inboxStore.delete(itemId);
+
+  if (!deleted) {
+    console.log();
+    console.log(c.error(`Inbox item not found: ${itemId}`));
+    console.log();
+    return;
+  }
+
+  console.log();
+  console.log(c.green("✓") + " Deleted: " + itemId);
+  console.log();
+}
+
+/**
+ * Show inbox count
+ */
+export async function inboxCountCmd(): Promise<void> {
+  const count = await inboxStore.getPendingCount();
+
+  console.log();
+  if (count > 0) {
+    console.log(c.yellow("📥") + ` ${count} pending item${count === 1 ? "" : "s"} in inbox`);
+  } else {
+    console.log(c.dim("Inbox is empty"));
+  }
+  console.log();
+}
+
+// Helper functions
+function formatStatus(status: string): string {
+  switch (status) {
+    case "pending": return c.yellow("pending");
+    case "promoted": return c.green("promoted");
+    case "discarded": return c.dim("discarded");
+    default: return status;
+  }
+}
+
+function formatPriority(priority: string): string {
+  switch (priority) {
+    case "critical": return c.red("critical");
+    case "high": return c.yellow("high");
+    case "medium": return c.blue("medium");
+    case "low": return c.dim("low");
+    default: return priority;
+  }
+}

package/src/commands/list.ts

@@ -85,7 +85,7 @@ export async function listTasksCmd(options: {
     { header: "Due", key: "dueDate", width: 12, format: (v) => formatDate(v as string) },
   ];
 
-  console.log(table(tasks, columns));
+  console.log(table(tasks as unknown as Record<string, unknown>[], columns));
   console.log();
 }
 

package/src/index.ts

@@ -16,16 +16,26 @@
 import { c, banner } from "./ansi.js";
 import { dashboard } from "./commands/dashboard.js";
 import { listTasksCmd, listProjectsCmd } from "./commands/list.js";
+import { startInteractive } from "./interactive.js";
+import {
+  inboxAddCmd,
+  inboxListCmd,
+  inboxGetCmd,
+  inboxPromoteCmd,
+  inboxDiscardCmd,
+  inboxDeleteCmd,
+  inboxCountCmd,
+} from "./commands/inbox.js";
 
-const VERSION = "1.0.4";
+export const VERSION = "1.0.4";
 
-interface ParsedArgs {
+export interface ParsedArgs {
   command: string;
   args: string[];
   flags: Record<string, string | boolean>;
 }
 
-function parseArgs(argv: string[]): ParsedArgs {
+export function parseArgs(argv: string[]): ParsedArgs {
   const args = argv.slice(2); // Skip bun and script path
   const flags: Record<string, string | boolean> = {};
   const positional: string[] = [];
@@ -75,10 +85,23 @@ ${c.yellow("COMMANDS")}
   ${c.cyan("ls")}                       Alias for list
   ${c.cyan("projects")}                 List all projects
   ${c.cyan("p")}                        Alias for projects
+  ${c.cyan("inbox")} <subcommand>       Manage inbox (add/list/get/promote/discard)
+  ${c.cyan("interactive")}              Start interactive mode
+  ${c.cyan("i")}                        Alias for interactive
   ${c.cyan("help")}                     Show this help message
   ${c.cyan("version")}                  Show version
 
+${c.yellow("INBOX SUBCOMMANDS")}
+  ${c.cyan("inbox")} "content"          Quick capture to inbox
+  ${c.cyan("inbox add")} "content"      Add item with natural language
+  ${c.cyan("inbox list")}               List pending items
+  ${c.cyan("inbox get")} <id>           Show item details
+  ${c.cyan("inbox promote")} <id>       Promote to task
+  ${c.cyan("inbox discard")} <id>       Discard item
+  ${c.cyan("inbox count")}              Show pending count
+
 ${c.yellow("OPTIONS")}
+  ${c.cyan("-i, --interactive")}        Start interactive mode
   ${c.cyan("--status")} <status>        Filter tasks by status (pending,in_progress,blocked,completed,cancelled)
   ${c.cyan("--priority")} <priority>    Filter tasks by priority (critical,high,medium,low)
   ${c.cyan("--all")}                    Include completed/cancelled tasks
@@ -102,9 +125,94 @@ function showVersion(): void {
   console.log(`task-mcp-cli v${VERSION}`);
 }
 
+async function handleInboxCommand(
+  args: string[],
+  flags: Record<string, string | boolean>
+): Promise<void> {
+  const subcommand = args[0];
+
+  // If first arg is not a subcommand, treat it as content for quick capture
+  const subcommands = ["add", "list", "ls", "get", "promote", "discard", "delete", "count"];
+  if (subcommand && !subcommands.includes(subcommand)) {
+    // Quick capture: task inbox "content here"
+    await inboxAddCmd({ content: args.join(" ") });
+    return;
+  }
+
+  switch (subcommand) {
+    case "add":
+      if (!args[1]) {
+        console.log(c.error("Usage: task inbox add \"content\""));
+        return;
+      }
+      await inboxAddCmd({ content: args.slice(1).join(" ") });
+      break;
+
+    case "list":
+    case "ls":
+      await inboxListCmd({
+        all: flags.all === true,
+        status: flags.status as "pending" | "promoted" | "discarded" | undefined,
+      });
+      break;
+
+    case "get":
+      if (!args[1]) {
+        console.log(c.error("Usage: task inbox get <item-id>"));
+        return;
+      }
+      await inboxGetCmd(args[1]);
+      break;
+
+    case "promote":
+      if (!args[1]) {
+        console.log(c.error("Usage: task inbox promote <item-id> [--project <id>] [--priority <p>]"));
+        return;
+      }
+      await inboxPromoteCmd({
+        itemId: args[1],
+        projectId: flags.project as string | undefined,
+        title: flags.title as string | undefined,
+        priority: flags.priority as "critical" | "high" | "medium" | "low" | undefined,
+      });
+      break;
+
+    case "discard":
+      if (!args[1]) {
+        console.log(c.error("Usage: task inbox discard <item-id>"));
+        return;
+      }
+      await inboxDiscardCmd(args[1]);
+      break;
+
+    case "delete":
+      if (!args[1]) {
+        console.log(c.error("Usage: task inbox delete <item-id>"));
+        return;
+      }
+      await inboxDeleteCmd(args[1]);
+      break;
+
+    case "count":
+      await inboxCountCmd();
+      break;
+
+    default:
+      // No subcommand = list pending
+      await inboxListCmd({ all: false });
+      break;
+  }
+}
+
 async function main(): Promise<void> {
   const { command, args, flags } = parseArgs(process.argv);
 
+  // Handle -i flag for interactive mode
+  if (flags.i === true || flags.interactive === true) {
+    await startInteractive();
+    return;
+  }
+
   try {
     switch (command) {
       case "dashboard":
@@ -129,6 +237,15 @@ async function main(): Promise<void> {
         });
         break;
 
+      case "interactive":
+      case "i":
+        await startInteractive();
+        break;
+
+      case "inbox":
+        await handleInboxCommand(args, flags);
+        break;
+
       case "help":
       case "-h":
       case "--help":
@@ -156,4 +273,7 @@ async function main(): Promise<void> {
   }
 }
 
-main();
+// Only run main when directly executed, not when imported
+if (import.meta.main) {
+  main();
+}