@task-mcp/cli 1.0.4 → 1.0.5

package/src/interactive.ts

@@ -0,0 +1,400 @@
+/**
+ * Interactive Mode for Task MCP CLI
+ * Zero-dependency implementation using Bun native capabilities
+ */
+
+import { c, banner } from "./ansi.js";
+import { dashboard } from "./commands/dashboard.js";
+import { listTasksCmd, listProjectsCmd } from "./commands/list.js";
+import * as readline from "node:readline";
+
+interface MenuOption {
+  key: string;
+  label: string;
+  description?: string;
+  action: () => Promise<void> | void;
+}
+
+/**
+ * Simple prompt for user input
+ */
+async function prompt(question: string): Promise<string> {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+/**
+ * Display menu and get user selection
+ */
+async function showMenu(title: string, options: MenuOption[]): Promise<void> {
+  console.clear();
+  console.log(banner("TASK MCP"));
+  console.log();
+  console.log(c.bold(c.cyan(title)));
+  console.log(c.dim("─".repeat(40)));
+  console.log();
+
+  for (const opt of options) {
+    const desc = opt.description ? c.dim(` - ${opt.description}`) : "";
+    console.log(`  ${c.yellow(opt.key)}  ${opt.label}${desc}`);
+  }
+
+  console.log();
+  const choice = await prompt(c.cyan("Select option: "));
+
+  const selected = options.find((o) => o.key.toLowerCase() === choice.toLowerCase());
+  if (selected) {
+    await selected.action();
+  } else if (choice !== "") {
+    console.log(c.error(`Invalid option: ${choice}`));
+    await sleep(1000);
+  }
+}
+
+/**
+ * Sleep utility
+ */
+function sleep(ms: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+/**
+ * Wait for any key press
+ */
+async function waitForKey(message: string = "Press Enter to continue..."): Promise<void> {
+  await prompt(c.dim(message));
+}
+
+/**
+ * Main Menu
+ */
+async function mainMenu(): Promise<boolean> {
+  const options: MenuOption[] = [
+    {
+      key: "d",
+      label: "Dashboard",
+      description: "View project dashboard",
+      action: async () => {
+        await dashboardMenu();
+      },
+    },
+    {
+      key: "p",
+      label: "Projects",
+      description: "List and manage projects",
+      action: async () => {
+        await projectsMenu();
+      },
+    },
+    {
+      key: "t",
+      label: "Tasks",
+      description: "List and filter tasks",
+      action: async () => {
+        await tasksMenu();
+      },
+    },
+    {
+      key: "a",
+      label: "Analysis",
+      description: "View analysis tools",
+      action: async () => {
+        await analysisMenu();
+      },
+    },
+    {
+      key: "q",
+      label: "Quick Actions",
+      description: "Common quick actions",
+      action: async () => {
+        await quickActionsMenu();
+      },
+    },
+    {
+      key: "x",
+      label: "Exit",
+      description: "Exit interactive mode",
+      action: () => {
+        console.log(c.dim("Goodbye!"));
+        process.exit(0);
+      },
+    },
+  ];
+
+  await showMenu("Main Menu", options);
+  return true;
+}
+
+/**
+ * Dashboard Menu
+ */
+async function dashboardMenu(): Promise<void> {
+  console.clear();
+  console.log(c.bold(c.cyan("Dashboard")));
+  console.log(c.dim("─".repeat(40)));
+  console.log();
+
+  const projectId = await prompt(c.cyan("Project ID (Enter for all): "));
+
+  console.log();
+  await dashboard(projectId || undefined);
+  console.log();
+  await waitForKey();
+}
+
+/**
+ * Projects Menu
+ */
+async function projectsMenu(): Promise<void> {
+  const options: MenuOption[] = [
+    {
+      key: "l",
+      label: "List Projects",
+      action: async () => {
+        console.clear();
+        await listProjectsCmd({ all: false });
+        console.log();
+        await waitForKey();
+      },
+    },
+    {
+      key: "a",
+      label: "List All (include archived)",
+      action: async () => {
+        console.clear();
+        await listProjectsCmd({ all: true });
+        console.log();
+        await waitForKey();
+      },
+    },
+    {
+      key: "b",
+      label: "Back to Main Menu",
+      action: () => {},
+    },
+  ];
+
+  await showMenu("Projects", options);
+}
+
+/**
+ * Tasks Menu
+ */
+async function tasksMenu(): Promise<void> {
+  const options: MenuOption[] = [
+    {
+      key: "l",
+      label: "List All Tasks",
+      action: async () => {
+        console.clear();
+        await listTasksCmd({ all: false });
+        console.log();
+        await waitForKey();
+      },
+    },
+    {
+      key: "p",
+      label: "Filter by Priority",
+      action: async () => {
+        console.clear();
+        const priority = await prompt(c.cyan("Priority (critical/high/medium/low): "));
+        if (priority) {
+          await listTasksCmd({ priority });
+        }
+        console.log();
+        await waitForKey();
+      },
+    },
+    {
+      key: "s",
+      label: "Filter by Status",
+      action: async () => {
+        console.clear();
+        const status = await prompt(c.cyan("Status (pending/in_progress/blocked/completed): "));
+        if (status) {
+          await listTasksCmd({ status });
+        }
+        console.log();
+        await waitForKey();
+      },
+    },
+    {
+      key: "a",
+      label: "All (include completed)",
+      action: async () => {
+        console.clear();
+        await listTasksCmd({ all: true });
+        console.log();
+        await waitForKey();
+      },
+    },
+    {
+      key: "b",
+      label: "Back to Main Menu",
+      action: () => {},
+    },
+  ];
+
+  await showMenu("Tasks", options);
+}
+
+/**
+ * Analysis Menu
+ */
+async function analysisMenu(): Promise<void> {
+  const options: MenuOption[] = [
+    {
+      key: "c",
+      label: "Complexity Analysis",
+      description: "View task complexity summary",
+      action: async () => {
+        console.clear();
+        console.log(c.yellow("Complexity Analysis"));
+        console.log(c.dim("Use MCP tools: get_complexity_summary, save_complexity_analysis"));
+        console.log();
+        console.log("Features:");
+        console.log("  - Score 1-10 complexity rating");
+        console.log("  - Factors: state_management, cross_cutting, etc.");
+        console.log("  - Suggested subtask count");
+        console.log();
+        await waitForKey();
+      },
+    },
+    {
+      key: "t",
+      label: "Tech Stack Analysis",
+      description: "View tech areas and risk",
+      action: async () => {
+        console.clear();
+        console.log(c.yellow("Tech Stack Analysis"));
+        console.log(c.dim("Use MCP tools: get_tech_stack_summary, save_tech_stack_analysis"));
+        console.log();
+        console.log("Features:");
+        console.log("  - Areas: schema, backend, frontend, infra, devops, test, docs");
+        console.log("  - Risk levels: low, medium, high, critical");
+        console.log("  - Breaking change detection");
+        console.log();
+        await waitForKey();
+      },
+    },
+    {
+      key: "r",
+      label: "Risk Analysis",
+      description: "Find high-risk tasks",
+      action: async () => {
+        console.clear();
+        console.log(c.yellow("Risk Analysis"));
+        console.log(c.dim("Use MCP tools: find_high_risk_tasks, suggest_safe_order"));
+        console.log();
+        console.log("Features:");
+        console.log("  - Identify high/critical risk tasks");
+        console.log("  - Suggest safe execution order");
+        console.log("  - Phase-based task grouping");
+        console.log();
+        await waitForKey();
+      },
+    },
+    {
+      key: "b",
+      label: "Back to Main Menu",
+      action: () => {},
+    },
+  ];
+
+  await showMenu("Analysis Tools", options);
+}
+
+/**
+ * Quick Actions Menu
+ */
+async function quickActionsMenu(): Promise<void> {
+  const options: MenuOption[] = [
+    {
+      key: "t",
+      label: "Today's Tasks",
+      action: async () => {
+        console.clear();
+        console.log(c.bold(c.yellow("Today's Tasks")));
+        console.log(c.dim("Use MCP tool: view_today"));
+        console.log();
+        await waitForKey();
+      },
+    },
+    {
+      key: "w",
+      label: "This Week",
+      action: async () => {
+        console.clear();
+        console.log(c.bold(c.yellow("This Week's Tasks")));
+        console.log(c.dim("Use MCP tool: view_this_week"));
+        console.log();
+        await waitForKey();
+      },
+    },
+    {
+      key: "q",
+      label: "Quick Wins",
+      action: async () => {
+        console.clear();
+        console.log(c.bold(c.yellow("Quick Wins")));
+        console.log(c.dim("Use MCP tool: view_quick_wins"));
+        console.log();
+        await waitForKey();
+      },
+    },
+    {
+      key: "n",
+      label: "Next Task Suggestion",
+      action: async () => {
+        console.clear();
+        console.log(c.bold(c.yellow("Next Task Suggestion")));
+        console.log(c.dim("Use MCP tool: suggest_next_task"));
+        console.log();
+        await waitForKey();
+      },
+    },
+    {
+      key: "b",
+      label: "Back to Main Menu",
+      action: () => {},
+    },
+  ];
+
+  await showMenu("Quick Actions", options);
+}
+
+/**
+ * Start interactive mode
+ */
+export async function startInteractive(): Promise<void> {
+  console.clear();
+  console.log(banner("TASK MCP"));
+  console.log();
+  console.log(c.bold("Welcome to Task MCP Interactive Mode"));
+  console.log(c.dim("Navigate using keyboard shortcuts"));
+  console.log();
+  await sleep(1000);
+
+  while (true) {
+    try {
+      await mainMenu();
+    } catch (error) {
+      if (error instanceof Error && error.message.includes("readline was closed")) {
+        // User pressed Ctrl+C or Ctrl+D
+        console.log();
+        console.log(c.dim("Goodbye!"));
+        process.exit(0);
+      }
+      throw error;
+    }
+  }
+}