@arcbridge/mcp-server 0.3.1 → 0.3.3

package/README.md

@@ -55,8 +55,8 @@ Restart your AI agent and approve the MCP server when prompted.
 
 | Tool | Description |
 |------|-------------|
-| `arcbridge_get_phase_plan` | All phases with tasks and acceptance criteria |
-| `arcbridge_get_current_tasks` | Tasks for the active phase |
+| `arcbridge_get_phase_plan` | Phase plan with tasks — filterable by phase_id, status, include_completed |
+| `arcbridge_get_current_tasks` | Tasks for the current or a specific phase (via phase_id) |
 | `arcbridge_update_task` | Mark tasks in-progress, done, blocked, or cancelled |
 | `arcbridge_create_task` | Add a task to any phase |
 | `arcbridge_delete_task` | Remove one or more tasks permanently (batch via task_ids array) |

package/dist/index.js

@@ -47,7 +47,7 @@ function registerInitProject(server, ctx) {
       ),
       features: z.array(z.enum(["auth", "database", "api"])).default([]).describe("Features to scaffold"),
       quality_priorities: z.array(QualityCategorySchema).default(["security", "performance", "accessibility", "maintainability"]).describe(QUALITY_PRIORITIES_DESCRIPTION),
-      platforms: z.array(z.string()).default(["claude"]).describe("Target platforms for agent config generation"),
+      platforms: z.array(z.enum(["claude", "copilot", "codex", "gemini"])).default(["claude"]).describe("Target platforms. Generates platform-specific instruction files and agent configs."),
       target_dir: z.string().describe("Absolute path to the target project directory"),
       spec: z.string().optional().describe(
         "Project specification or requirements text. Saved to .arcbridge/spec.md and referenced by agents for context. Can be a description, user stories, or any text that defines what the project should do."
@@ -275,9 +275,13 @@ function registerGetProjectStatus(server, ctx) {
         return notInitialized();
       }
       refreshFromDocs(db, params.target_dir);
-      const projectName = db.prepare(
-        "SELECT value FROM arcbridge_meta WHERE key = 'project_name'"
-      ).get()?.value ?? "Unknown";
+      const metaRows = db.prepare(
+        "SELECT key, value FROM arcbridge_meta WHERE key IN ('project_name', 'project_type', 'platforms')"
+      ).all();
+      const meta = Object.fromEntries(metaRows.map((r) => [r.key, r.value]));
+      const projectName = meta.project_name ?? "Unknown";
+      const projectType = meta.project_type;
+      const platforms = meta.platforms;
       const phases = db.prepare(
         "SELECT id, name, phase_number, status FROM phases ORDER BY phase_number"
       ).all();
@@ -304,7 +308,18 @@ function registerGetProjectStatus(server, ctx) {
       ).get().count;
       const lines = [
         `# Project Status: ${projectName}`,
-        "",
+        ""
+      ];
+      if (projectType) {
+        lines.push(`**Template:** ${projectType}`);
+      }
+      if (platforms) {
+        lines.push(`**Platforms:** ${platforms}`);
+      }
+      if (projectType || platforms) {
+        lines.push("");
+      }
+      lines.push(
         "## Current Phase",
         "",
         currentPhase ? `**${currentPhase.name}** (${currentPhase.status})` : "*No phases defined*",
@@ -331,7 +346,7 @@ function registerGetProjectStatus(server, ctx) {
           (s) => `- ${s.status === "passing" ? "pass" : s.status === "failing" ? "FAIL" : s.status === "partial" ? "partial" : "untested"} ${s.id}: ${s.name} [${s.category}] (${s.priority})`
         ),
         ""
-      ];
+      );
       lines.push("## Code Intelligence", "");
       if (symbolCount > 0) {
         lines.push(
@@ -679,25 +694,49 @@ import { refreshFromDocs as refreshFromDocs2 } from "@arcbridge/core";
 function registerGetPhasePlan(server, ctx) {
   server.tool(
     "arcbridge_get_phase_plan",
-    "Get the complete phase plan with all phases, their tasks, status, and gate requirements.",
+    "Get the phase plan with phases, tasks, status, and gate requirements. Use filters to reduce output for large projects.",
     {
-      target_dir: z6.string().describe("Absolute path to the project directory")
+      target_dir: z6.string().describe("Absolute path to the project directory"),
+      phase_id: z6.string().optional().describe("Show only a specific phase by ID"),
+      status: z6.enum(["planned", "in-progress", "complete", "blocked"]).optional().describe("Filter phases by status"),
+      include_completed: z6.boolean().default(true).describe("Include completed phases (default: true). Set to false to hide completed phases and reduce output.")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
       if (!db) return notInitialized();
       refreshFromDocs2(db, params.target_dir);
-      const phases = db.prepare(
-        "SELECT id, name, phase_number, status, description, gate_status, started_at, completed_at FROM phases ORDER BY phase_number"
-      ).all();
+      let query = "SELECT id, name, phase_number, status, description, gate_status, started_at, completed_at FROM phases";
+      const conditions = [];
+      const queryParams = [];
+      if (params.phase_id) {
+        conditions.push("id = ?");
+        queryParams.push(params.phase_id);
+      }
+      if (params.status) {
+        conditions.push("status = ?");
+        queryParams.push(params.status);
+      }
+      if (!params.include_completed && !params.status && !params.phase_id) {
+        conditions.push("status != 'complete'");
+      }
+      if (conditions.length > 0) {
+        query += " WHERE " + conditions.join(" AND ");
+      }
+      query += " ORDER BY phase_number";
+      const phases = db.prepare(query).all(...queryParams);
       if (phases.length === 0) {
+        const hint = params.phase_id ? `Phase '${params.phase_id}' not found.` : params.status ? `No phases with status '${params.status}'.` : "No phases defined yet.";
         return {
-          content: [
-            { type: "text", text: "No phases defined yet." }
-          ]
+          content: [{ type: "text", text: hint }]
         };
       }
-      const lines = ["# Phase Plan", ""];
+      const lines = [];
+      if (conditions.length > 0) {
+        const totalPhases = db.prepare("SELECT COUNT(*) as count FROM phases").get().count;
+        lines.push(`# Phase Plan (${phases.length} of ${totalPhases} phases)`, "");
+      } else {
+        lines.push("# Phase Plan", "");
+      }
       for (const phase of phases) {
         const icon = phase.status === "complete" ? "[x]" : phase.status === "in-progress" ? "[>]" : phase.status === "blocked" ? "[!]" : "[ ]";
         lines.push(
@@ -758,32 +797,48 @@ import { refreshFromDocs as refreshFromDocs3 } from "@arcbridge/core";
 function registerGetCurrentTasks(server, ctx) {
   server.tool(
     "arcbridge_get_current_tasks",
-    "Get tasks for the current phase (in-progress, or first planned if none is in-progress), with their building blocks, quality scenarios, and acceptance criteria.",
+    "Get tasks for a phase. Defaults to the current phase (in-progress, or first planned). Pass phase_id to get tasks for a specific phase.",
     {
       target_dir: z7.string().describe("Absolute path to the project directory"),
+      phase_id: z7.string().optional().describe("Get tasks for a specific phase by ID (default: current/first planned phase)"),
       status: z7.enum(["todo", "in-progress", "done", "blocked"]).optional().describe("Filter tasks by status")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
       if (!db) return notInitialized();
       refreshFromDocs3(db, params.target_dir);
-      let currentPhase = db.prepare(
-        "SELECT id, name FROM phases WHERE status = 'in-progress' ORDER BY phase_number LIMIT 1"
-      ).get();
-      if (!currentPhase) {
+      let currentPhase;
+      if (params.phase_id) {
+        currentPhase = db.prepare("SELECT id, name FROM phases WHERE id = ?").get(params.phase_id);
+        if (!currentPhase) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Phase '${params.phase_id}' not found. Use \`arcbridge_get_phase_plan\` to see all phases.`
+              }
+            ]
+          };
+        }
+      } else {
         currentPhase = db.prepare(
-          "SELECT id, name FROM phases WHERE status = 'planned' ORDER BY phase_number LIMIT 1"
+          "SELECT id, name FROM phases WHERE status = 'in-progress' ORDER BY phase_number LIMIT 1"
         ).get();
-      }
-      if (!currentPhase) {
-        return {
-          content: [
-            {
-              type: "text",
-              text: "No active or planned phases found. Use `arcbridge_get_phase_plan` to see all phases."
-            }
-          ]
-        };
+        if (!currentPhase) {
+          currentPhase = db.prepare(
+            "SELECT id, name FROM phases WHERE status = 'planned' ORDER BY phase_number LIMIT 1"
+          ).get();
+        }
+        if (!currentPhase) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "No active or planned phases found. Use `arcbridge_get_phase_plan` to see all phases."
+              }
+            ]
+          };
+        }
       }
       let query = "SELECT id, phase_id, title, description, status, building_block, quality_scenarios, acceptance_criteria FROM tasks WHERE phase_id = ?";
       const queryParams = [currentPhase.id];