@arcbridge/mcp-server 0.1.4 → 0.1.6

package/dist/index.js

@@ -22,7 +22,7 @@ function createContext() {
 // src/tools/init-project.ts
 import { z } from "zod";
 import { join } from "path";
-import { existsSync } from "fs";
+import { existsSync, writeFileSync } from "fs";
 import {
   generateConfig,
   generateArc42,
@@ -44,9 +44,12 @@ function registerInitProject(server, ctx) {
         "Project template: nextjs-app-router (Next.js with App Router, SSR/SSG), react-vite (React SPA with Vite, client-only), api-service (Node.js API with Express/Fastify/Hono), dotnet-webapi (ASP.NET Core Web API, C#)"
       ),
       features: z.array(z.enum(["auth", "database", "api"])).default([]).describe("Features to scaffold"),
-      quality_priorities: z.array(z.string()).default(["security", "performance", "accessibility"]).describe("Quality priorities in order"),
+      quality_priorities: z.array(z.string()).default(["security", "performance", "accessibility", "maintainability"]).describe("Quality priorities in order"),
       platforms: z.array(z.string()).default(["claude"]).describe("Target platforms for agent config generation"),
-      target_dir: z.string().describe("Absolute path to the target project directory")
+      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."
+      )
     },
     async (params) => {
       const targetDir = params.target_dir;
@@ -83,6 +86,9 @@ function registerInitProject(server, ctx) {
           const { db: recoveredDb } = generateDatabase(targetDir, recoverInput);
           ctx.db = recoveredDb;
           ctx.projectRoot = targetDir;
+          if (params.spec) {
+            writeFileSync(join(targetDir, ".arcbridge", "spec.md"), params.spec, "utf-8");
+          }
           return {
             content: [
               {
@@ -121,6 +127,13 @@ Use \`arcbridge_get_project_status\` to see the current state.`
           platformWarnings.push(`Platform '${platform}': ${msg}`);
         }
       }
+      if (params.spec) {
+        writeFileSync(
+          join(targetDir, ".arcbridge", "spec.md"),
+          params.spec,
+          "utf-8"
+        );
+      }
       let indexResult = null;
       try {
         const result = await indexProject(db, { projectRoot: targetDir });
@@ -143,6 +156,7 @@ Use \`arcbridge_get_project_status\` to see the current state.`
         `**Template:** ${input.template}`,
         `**Features:** ${input.features.length > 0 ? input.features.join(", ") : "none"}`,
         `**Platforms:** ${params.platforms.join(", ")}`,
+        ...params.spec ? [`**Spec:** saved to .arcbridge/spec.md`] : [],
         "",
         "## Created",
         "",
@@ -175,12 +189,15 @@ Use \`arcbridge_get_project_status\` to see the current state.`
           ...allWarnings.map((w) => `- ${w}`)
         ] : [],
         "",
-        "## Next Steps",
+        "## Next Steps \u2014 PLAN FIRST, BUILD SECOND",
+        "",
+        "**Do not start implementing yet.** First plan the full project roadmap:",
         "",
-        "1. **Review the phase plan** \u2014 run `arcbridge_get_phase_plan` to see all phases and their tasks",
-        "2. **Replace example tasks in Phase 2+** \u2014 Phase 0-1 tasks are ready to use, but Phase 2+ tasks are examples only. Replace them with real tasks from the project's requirements.",
-        "3. **Activate the architect role** \u2014 run `arcbridge_activate_role` with role `architect` to get full architectural context",
-        "4. **Start working** \u2014 use `arcbridge_get_current_tasks` to see what to do next",
+        "1. **Activate the architect role** \u2014 run `arcbridge_activate_role` with role `architect`",
+        "2. **Review the spec** \u2014 read `.arcbridge/spec.md` (if provided) and understand the full scope",
+        "3. **Review and adapt the phase plan** \u2014 run `arcbridge_get_phase_plan`. The 4 generated phases are a starting template. For larger projects, add more phases by editing `.arcbridge/plan/phases.yaml` and running `arcbridge_reindex`.",
+        "4. **Plan real tasks for ALL phases** \u2014 Phase 0-1 tasks are ready to use. Phase 2+ tasks are examples only \u2014 replace them with real tasks from the project's requirements using `arcbridge_create_task`.",
+        "5. **Only then start building** \u2014 use `arcbridge_get_current_tasks` to see what to do next",
         "",
         "Use `arcbridge_get_project_status` to see the full project status."
       ];
@@ -803,6 +820,23 @@ function registerGetCurrentTasks(server, ctx) {
           lines.push("");
         }
       }
+      const emptyFuturePhases = db.prepare(`
+          SELECT p.id, p.name, p.phase_number FROM phases p
+          WHERE p.status IN ('planned', 'in-progress')
+            AND p.id != ?
+            AND NOT EXISTS (SELECT 1 FROM tasks t WHERE t.phase_id = p.id)
+          ORDER BY p.phase_number
+        `).all(currentPhase.id);
+      if (emptyFuturePhases.length > 0) {
+        lines.push(
+          "---",
+          "",
+          "**Warning:** The following phases have no tasks yet:",
+          ...emptyFuturePhases.map((p) => `- Phase ${p.phase_number}: ${p.name} (\`${p.id}\`)`),
+          "",
+          "Use `arcbridge_create_task` to plan tasks before reaching these phases."
+        );
+      }
       return {
         content: [{ type: "text", text: lines.join("\n") }]
       };
@@ -856,7 +890,7 @@ function registerUpdateTask(server, ctx) {
     {
       target_dir: z8.string().describe("Absolute path to the project directory"),
       task_id: z8.string().describe("Task ID (e.g., 'task-0.1-init-nextjs')"),
-      status: z8.enum(["in-progress", "done", "blocked"]).describe("New status"),
+      status: z8.enum(["in-progress", "done", "blocked", "cancelled"]).describe("New status. Use 'cancelled' for tasks that are no longer relevant."),
       notes: z8.string().optional().describe("Optional notes about the status change")
     },
     async (params) => {
@@ -881,10 +915,9 @@ function registerUpdateTask(server, ctx) {
           "UPDATE tasks SET status = ?, completed_at = ? WHERE id = ?"
         ).run(params.status, now, params.task_id);
       } else {
-        db.prepare("UPDATE tasks SET status = ? WHERE id = ?").run(
-          params.status,
-          params.task_id
-        );
+        db.prepare(
+          "UPDATE tasks SET status = ?, completed_at = NULL WHERE id = ?"
+        ).run(params.status, params.task_id);
       }
       syncTaskToYaml(
         params.target_dir,
@@ -901,15 +934,15 @@ function registerUpdateTask(server, ctx) {
       if (params.notes) {
         lines.push("", `**Notes:** ${params.notes}`);
       }
-      if (params.status === "done") {
+      if (params.status === "done" || params.status === "cancelled") {
         const phaseStats = db.prepare(
-          "SELECT COUNT(*) as total, SUM(CASE WHEN status = 'done' THEN 1 ELSE 0 END) as done FROM tasks WHERE phase_id = ?"
+          "SELECT SUM(CASE WHEN status != 'cancelled' THEN 1 ELSE 0 END) as total, SUM(CASE WHEN status = 'done' THEN 1 ELSE 0 END) as done FROM tasks WHERE phase_id = ?"
         ).get(task.phase_id);
         lines.push(
           "",
           `**Phase progress:** ${phaseStats.done}/${phaseStats.total} tasks complete`
         );
-        if (phaseStats.done === phaseStats.total) {
+        if (phaseStats.total > 0 && phaseStats.done === phaseStats.total) {
           lines.push(
             "",
             "All tasks in this phase are complete! The phase is ready to advance."
@@ -941,7 +974,9 @@ function registerCreateTask(server, ctx) {
       target_dir: z9.string().describe("Absolute path to the project directory"),
       phase_id: z9.string().describe("Phase ID to add the task to"),
       title: z9.string().min(1).describe("Task title"),
-      building_block: z9.string().optional().describe("Building block this task belongs to"),
+      building_block: z9.string().min(1).optional().describe(
+        "Building block this task belongs to. Use `arcbridge_get_building_blocks` to see available blocks. If no suitable block exists, create one in `.arcbridge/arc42/05-building-blocks.md` and run `arcbridge_reindex` first."
+      ),
       quality_scenarios: z9.array(z9.string()).default([]).describe("Quality scenario IDs this task addresses"),
       acceptance_criteria: z9.array(z9.string()).default([]).describe("Acceptance criteria for this task")
     },
@@ -966,6 +1001,27 @@ function registerCreateTask(server, ctx) {
       const slug = params.title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 30);
       const taskId = `task-${phase.phase_number}.${taskNum}-${slug}`;
       const now = (/* @__PURE__ */ new Date()).toISOString();
+      const blockId = params.building_block ?? null;
+      if (blockId) {
+        const block = db.prepare("SELECT id FROM building_blocks WHERE id = ?").get(blockId);
+        if (!block) {
+          const available = db.prepare("SELECT id, name FROM building_blocks ORDER BY id").all();
+          const blockList = available.length > 0 ? available.map((b) => `  - \`${b.id}\` (${b.name})`).join("\n") : "  (none \u2014 run `arcbridge_reindex` to populate from arc42 docs)";
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Building block \`${blockId}\` not found.
+
+**Available blocks:**
+${blockList}
+
+If you need a new block, add it to \`.arcbridge/arc42/05-building-blocks.md\` and run \`arcbridge_reindex\`, then retry.`
+              }
+            ]
+          };
+        }
+      }
       db.prepare(
         "INSERT INTO tasks (id, phase_id, title, description, status, building_block, quality_scenarios, acceptance_criteria, created_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)"
       ).run(
@@ -974,7 +1030,7 @@ function registerCreateTask(server, ctx) {
         params.title,
         null,
         "todo",
-        params.building_block ?? null,
+        blockId,
         JSON.stringify(params.quality_scenarios),
         JSON.stringify(params.acceptance_criteria),
         now
@@ -1015,16 +1071,113 @@ function registerCreateTask(server, ctx) {
   );
 }
 
-// src/tools/get-relevant-adrs.ts
+// src/tools/delete-task.ts
 import { z as z10 } from "zod";
+import { deleteTaskFromYaml } from "@arcbridge/core";
+function registerDeleteTask(server, ctx) {
+  server.tool(
+    "arcbridge_delete_task",
+    "Delete a task permanently. Use this to remove example/template tasks or duplicates. For tasks that were planned but are no longer relevant, prefer `arcbridge_update_task` with status 'cancelled' instead \u2014 this preserves the decision trail.",
+    {
+      target_dir: z10.string().describe("Absolute path to the project directory"),
+      task_id: z10.string().describe("Task ID to delete")
+    },
+    async (params) => {
+      const db = ensureDb(ctx, params.target_dir);
+      if (!db) return notInitialized();
+      const task = db.prepare("SELECT id, title, phase_id FROM tasks WHERE id = ?").get(params.task_id);
+      if (!task) {
+        return textResult(
+          `Task '${params.task_id}' not found. Use \`arcbridge_get_current_tasks\` to see available tasks.`
+        );
+      }
+      const yamlResult = deleteTaskFromYaml(params.target_dir, task.phase_id, params.task_id);
+      db.prepare("DELETE FROM tasks WHERE id = ?").run(params.task_id);
+      const msg = `Task **${task.id}** deleted: "${task.title}"`;
+      if (yamlResult.warning) {
+        return textResult(`${msg}
+
+**Warning:** ${yamlResult.warning}`);
+      }
+      return textResult(msg);
+    }
+  );
+}
+
+// src/tools/create-phase.ts
+import { z as z11 } from "zod";
+import { addPhaseToYaml, refreshFromDocs as refreshFromDocs4 } from "@arcbridge/core";
+function registerCreatePhase(server, ctx) {
+  server.tool(
+    "arcbridge_create_phase",
+    "Create a new phase in the project plan. Use this to add phases beyond the initial 4-phase template when the project scope requires it.",
+    {
+      target_dir: z11.string().describe("Absolute path to the project directory"),
+      name: z11.string().min(1).describe("Phase name (e.g., 'Integrations', 'Performance Optimization')"),
+      description: z11.string().min(1).describe("What this phase covers"),
+      phase_number: z11.number().int().min(0).optional().describe("Phase number (default: next after highest existing phase)"),
+      gate_requirements: z11.array(z11.string()).default([]).describe("Requirements that must be met to complete this phase")
+    },
+    async (params) => {
+      const db = ensureDb(ctx, params.target_dir);
+      if (!db) return notInitialized();
+      refreshFromDocs4(db, params.target_dir);
+      const maxPhase = db.prepare("SELECT MAX(phase_number) as max FROM phases").get();
+      const phaseNumber = params.phase_number ?? (maxPhase.max ?? -1) + 1;
+      const existing = db.prepare("SELECT id FROM phases WHERE phase_number = ?").get(phaseNumber);
+      if (existing) {
+        return textResult(
+          `Phase number ${phaseNumber} already exists (\`${existing.id}\`). Choose a different number or omit to auto-assign.`
+        );
+      }
+      const slug = params.name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 30) || "unnamed";
+      const phaseId = `phase-${phaseNumber}-${slug}`;
+      const yamlResult = addPhaseToYaml(params.target_dir, {
+        id: phaseId,
+        name: params.name,
+        phase_number: phaseNumber,
+        description: params.description,
+        gate_requirements: params.gate_requirements
+      });
+      if (!yamlResult.success) {
+        return textResult(
+          `Failed to create phase: ${yamlResult.warning ?? "YAML update failed"}`
+        );
+      }
+      refreshFromDocs4(db, params.target_dir);
+      const lines = [
+        `Phase created: **${phaseId}**`,
+        "",
+        `**Name:** ${params.name}`,
+        `**Number:** ${phaseNumber}`,
+        `**Status:** planned`,
+        `**Description:** ${params.description}`
+      ];
+      if (params.gate_requirements.length > 0) {
+        lines.push("", "**Gate requirements:**");
+        for (const r of params.gate_requirements) {
+          lines.push(`- [ ] ${r}`);
+        }
+      }
+      lines.push(
+        "",
+        `Use \`arcbridge_create_task\` with phase ID \`${phaseId}\` to add tasks.`
+      );
+      return textResult(lines.join("\n"));
+    }
+  );
+}
+
+// src/tools/get-relevant-adrs.ts
+import { z as z12 } from "zod";
 function registerGetRelevantAdrs(server, ctx) {
   server.tool(
     "arcbridge_get_relevant_adrs",
     "Get architectural decision records (ADRs) relevant to a specific file path or building block.",
     {
-      target_dir: z10.string().describe("Absolute path to the project directory"),
-      file_path: z10.string().optional().describe("File path to find relevant ADRs for"),
-      building_block: z10.string().optional().describe("Building block ID to find relevant ADRs for")
+      target_dir: z12.string().describe("Absolute path to the project directory"),
+      file_path: z12.string().optional().describe("File path to find relevant ADRs for"),
+      building_block: z12.string().optional().describe("Building block ID to find relevant ADRs for")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
@@ -1108,24 +1261,24 @@ function formatAdrs(adrs, title) {
 }
 
 // src/tools/reindex.ts
-import { z as z11 } from "zod";
-import { indexProject as indexProject2, refreshFromDocs as refreshFromDocs4 } from "@arcbridge/core";
+import { z as z13 } from "zod";
+import { indexProject as indexProject2, refreshFromDocs as refreshFromDocs5 } from "@arcbridge/core";
 function registerReindex(server, ctx) {
   server.tool(
     "arcbridge_reindex",
     "Re-index the project: refreshes architecture docs from arc42/YAML files, then reindexes code symbols (TypeScript & C#/.NET). This is the first step of the sync pipeline \u2014 use it to pick up manual doc edits and code changes.",
     {
-      target_dir: z11.string().describe("Absolute path to the project directory"),
-      tsconfig_path: z11.string().optional().describe("Override tsconfig.json path (default: auto-detect). Only used for TypeScript projects."),
-      service: z11.string().optional().describe("Service name for monorepo projects (default: 'main')"),
-      language: z11.enum(["typescript", "csharp", "auto"]).optional().describe("Project language. 'auto' detects from project files (default: 'auto')")
+      target_dir: z13.string().describe("Absolute path to the project directory"),
+      tsconfig_path: z13.string().optional().describe("Override tsconfig.json path (default: auto-detect). Only used for TypeScript projects."),
+      service: z13.string().optional().describe("Service name for monorepo projects (default: 'main')"),
+      language: z13.enum(["typescript", "csharp", "auto"]).optional().describe("Project language. 'auto' detects from project files (default: 'auto')")
     },
     async (params) => {
       const start = Date.now();
       const db = ensureDb(ctx, params.target_dir);
       if (!db) return notInitialized();
       try {
-        const docWarnings = refreshFromDocs4(db, params.target_dir);
+        const docWarnings = refreshFromDocs5(db, params.target_dir);
         const result = await indexProject2(db, {
           projectRoot: params.target_dir,
           tsconfigPath: params.tsconfig_path,
@@ -1133,9 +1286,13 @@ function registerReindex(server, ctx) {
           language: params.language
         });
         const lines = [
-          "# Indexing Complete",
+          "# Reindex Complete",
+          "",
+          "## Architecture Docs",
+          `- **Refreshed from docs:** building blocks, phases, tasks, quality scenarios, ADRs`,
+          ...docWarnings.length > 0 ? [`- **Warnings:** ${docWarnings.join("; ")}`] : [],
           "",
-          `- **Docs refreshed:** ${docWarnings.length === 0 ? "OK" : docWarnings.join(", ")}`,
+          "## Code Symbols",
           `- **Files processed:** ${result.filesProcessed}`,
           `- **Files skipped (unchanged):** ${result.filesSkipped}`,
           `- **Files removed:** ${result.filesRemoved}`,
@@ -1160,16 +1317,16 @@ function registerReindex(server, ctx) {
 }
 
 // src/tools/search-symbols.ts
-import { z as z12 } from "zod";
+import { z as z14 } from "zod";
 function registerSearchSymbols(server, ctx) {
   server.tool(
     "arcbridge_search_symbols",
     "Search code symbols by name, kind, file path, or building block. Supports TypeScript and C#. Returns matching symbols with type signatures.",
     {
-      target_dir: z12.string().describe("Absolute path to the project directory"),
-      query: z12.string().optional().describe("Search term to match against symbol names"),
-      service: z12.string().optional().describe("Filter by service name (for multi-project solutions). Omit to search all services."),
-      kind: z12.enum([
+      target_dir: z14.string().describe("Absolute path to the project directory"),
+      query: z14.string().optional().describe("Search term to match against symbol names"),
+      service: z14.string().optional().describe("Filter by service name (for multi-project solutions). Omit to search all services."),
+      kind: z14.enum([
         "function",
         "class",
         "type",
@@ -1181,10 +1338,10 @@ function registerSearchSymbols(server, ctx) {
         "hook",
         "context"
       ]).optional().describe("Filter by symbol kind"),
-      file_path: z12.string().optional().describe("Filter by file path (prefix match)"),
-      is_exported: z12.boolean().optional().describe("Filter by export status"),
-      building_block: z12.string().optional().describe("Filter by building block ID (matches against code_paths)"),
-      limit: z12.number().int().min(1).max(200).default(50).describe("Maximum results to return (default: 50)")
+      file_path: z14.string().optional().describe("Filter by file path (prefix match)"),
+      is_exported: z14.boolean().optional().describe("Filter by export status"),
+      building_block: z14.string().optional().describe("Filter by building block ID (matches against code_paths)"),
+      limit: z14.number().int().min(1).max(200).default(50).describe("Maximum results to return (default: 50)")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
@@ -1271,7 +1428,7 @@ function registerSearchSymbols(server, ctx) {
 }
 
 // src/tools/get-symbol.ts
-import { z as z13 } from "zod";
+import { z as z15 } from "zod";
 import { readFileSync, existsSync as existsSync3 } from "fs";
 import { join as join3 } from "path";
 function registerGetSymbol(server, ctx) {
@@ -1279,11 +1436,11 @@ function registerGetSymbol(server, ctx) {
     "arcbridge_get_symbol",
     "Get detailed information about a specific TypeScript symbol including its source code, type signature, and relationships.",
     {
-      target_dir: z13.string().describe("Absolute path to the project directory"),
-      symbol_id: z13.string().describe(
+      target_dir: z15.string().describe("Absolute path to the project directory"),
+      symbol_id: z15.string().describe(
         "Symbol ID (e.g. 'src/utils.ts::formatName#function')"
       ),
-      include_source: z13.boolean().default(true).describe("Include source code snippet (default: true)")
+      include_source: z15.boolean().default(true).describe("Include source code snippet (default: true)")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
@@ -1381,21 +1538,21 @@ Use \`arcbridge_search_symbols\` to find symbols by name.`
 }
 
 // src/tools/get-dependency-graph.ts
-import { z as z14 } from "zod";
+import { z as z16 } from "zod";
 function registerGetDependencyGraph(server, ctx) {
   server.tool(
     "arcbridge_get_dependency_graph",
     "Get the dependency graph for a module or file. Shows imports, calls, type usage, and inheritance relationships between symbols.",
     {
-      target_dir: z14.string().describe("Absolute path to the project directory"),
-      module: z14.string().describe(
+      target_dir: z16.string().describe("Absolute path to the project directory"),
+      module: z16.string().describe(
         "Module path relative to project root (e.g. 'src/lib/auth')"
       ),
-      direction: z14.enum(["dependencies", "dependents", "both"]).default("both").describe(
+      direction: z16.enum(["dependencies", "dependents", "both"]).default("both").describe(
         "Graph direction: 'dependencies' (what this module uses), 'dependents' (what uses this module), or 'both'"
       ),
-      depth: z14.number().int().min(1).max(5).default(1).describe("How many levels to traverse (default: 1, max: 5)"),
-      service: z14.string().optional().describe("Filter by service name (for multi-project solutions). Omit to search all services.")
+      depth: z16.number().int().min(1).max(5).default(1).describe("How many levels to traverse (default: 1, max: 5)"),
+      service: z16.string().optional().describe("Filter by service name (for multi-project solutions). Omit to search all services.")
     },
     async (params) => {
       const maybeDb = ensureDb(ctx, params.target_dir);
@@ -1542,16 +1699,16 @@ function formatEdges(edges, modulePath, direction) {
 }
 
 // src/tools/get-component-graph.ts
-import { z as z15 } from "zod";
+import { z as z17 } from "zod";
 function registerGetComponentGraph(server, ctx) {
   server.tool(
     "arcbridge_get_component_graph",
     "Get the React component graph: component hierarchy, props, state, context usage, and server/client boundaries.",
     {
-      target_dir: z15.string().describe("Absolute path to the project directory"),
-      file_path: z15.string().optional().describe("Filter to components in a specific file or directory prefix"),
-      client_only: z15.boolean().optional().describe("Only show client components ('use client')"),
-      with_state: z15.boolean().optional().describe("Only show components that use state (useState/useReducer)")
+      target_dir: z17.string().describe("Absolute path to the project directory"),
+      file_path: z17.string().optional().describe("Filter to components in a specific file or directory prefix"),
+      client_only: z17.boolean().optional().describe("Only show client components ('use client')"),
+      with_state: z17.boolean().optional().describe("Only show components that use state (useState/useReducer)")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
@@ -1655,16 +1812,16 @@ function registerGetComponentGraph(server, ctx) {
 }
 
 // src/tools/get-route-map.ts
-import { z as z16 } from "zod";
+import { z as z18 } from "zod";
 function registerGetRouteMap(server, ctx) {
   server.tool(
     "arcbridge_get_route_map",
     "Get the route map: pages, layouts, API routes, and their hierarchy. Works with Next.js, ASP.NET controllers, and minimal APIs.",
     {
-      target_dir: z16.string().describe("Absolute path to the project directory"),
-      kind: z16.enum(["page", "layout", "loading", "error", "not-found", "api-route", "middleware"]).optional().describe("Filter by route kind"),
-      route_prefix: z16.string().optional().describe("Filter by route path prefix (e.g. '/dashboard' or '/api/orders')"),
-      service: z16.string().optional().describe("Filter by service name (for multi-project solutions). Omit to show all services.")
+      target_dir: z18.string().describe("Absolute path to the project directory"),
+      kind: z18.enum(["page", "layout", "loading", "error", "not-found", "api-route", "middleware"]).optional().describe("Filter by route kind"),
+      route_prefix: z18.string().optional().describe("Filter by route path prefix (e.g. '/dashboard' or '/api/orders')"),
+      service: z18.string().optional().describe("Filter by service name (for multi-project solutions). Omit to show all services.")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
@@ -1740,13 +1897,13 @@ function registerGetRouteMap(server, ctx) {
 }
 
 // src/tools/get-boundary-analysis.ts
-import { z as z17 } from "zod";
+import { z as z19 } from "zod";
 function registerGetBoundaryAnalysis(server, ctx) {
   server.tool(
     "arcbridge_get_boundary_analysis",
     "Analyze server/client boundaries in a Next.js project. Identifies client components, server components, server actions, and potential boundary violations.",
     {
-      target_dir: z17.string().describe("Absolute path to the project directory")
+      target_dir: z19.string().describe("Absolute path to the project directory")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
@@ -1850,15 +2007,15 @@ function registerGetBoundaryAnalysis(server, ctx) {
 }
 
 // src/tools/check-drift.ts
-import { z as z18 } from "zod";
+import { z as z20 } from "zod";
 import { detectDrift, writeDriftLog } from "@arcbridge/core";
 function registerCheckDrift(server, ctx) {
   server.tool(
     "arcbridge_check_drift",
     "Detect architecture drift: undocumented modules, missing code paths, cross-block dependency violations, and stale ADR references.",
     {
-      target_dir: z18.string().describe("Absolute path to the project directory"),
-      persist: z18.boolean().default(true).describe("Write findings to drift_log table (default: true)")
+      target_dir: z20.string().describe("Absolute path to the project directory"),
+      persist: z20.boolean().default(true).describe("Write findings to drift_log table (default: true)")
     },
     async (params) => {
       const start = Date.now();
@@ -1930,15 +2087,16 @@ function registerCheckDrift(server, ctx) {
 }
 
 // src/tools/get-guidance.ts
-import { z as z19 } from "zod";
+import { z as z21 } from "zod";
+import { loadConfig as loadConfig3 } from "@arcbridge/core";
 function registerGetGuidance(server, ctx) {
   server.tool(
     "arcbridge_get_guidance",
     "Get context-aware architectural guidance for a code change. Surfaces relevant quality scenarios, patterns, constraints, and questions to consider.",
     {
-      target_dir: z19.string().describe("Absolute path to the project directory"),
-      file_path: z19.string().optional().describe("File path you're working on (to determine building block and context)"),
-      action: z19.enum([
+      target_dir: z21.string().describe("Absolute path to the project directory"),
+      file_path: z21.string().optional().describe("File path you're working on (to determine building block and context)"),
+      action: z21.enum([
         "adding-component",
         "adding-api-route",
         "adding-hook",
@@ -2068,7 +2226,10 @@ function registerGetGuidance(server, ctx) {
         }
         lines.push("");
       }
-      const actionGuidance = getActionGuidance(params.action);
+      const projectRoot = ctx.projectRoot ?? params.target_dir;
+      const { config: projConfig, error: configError } = loadConfig3(projectRoot);
+      const projectType = configError ? "unknown" : projConfig?.project_type ?? "nextjs-app-router";
+      const actionGuidance = getActionGuidance(params.action, projectType);
       if (actionGuidance) {
         lines.push("## Guidance", "", actionGuidance, "");
       }
@@ -2092,28 +2253,55 @@ function filterRelevantScenarios(scenarios, action, _blockId) {
   }
   return scenarios.filter((s) => relevantCategories.includes(s.category));
 }
-function getActionGuidance(action) {
-  const guidance = {
-    "adding-component": "- Follow existing component patterns in this directory\n- Add props interface alongside the component\n- Consider server vs. client: does this need interactivity (`'use client'`)?\n- Check accessibility: keyboard navigation, ARIA labels, screen reader support\n- **Arc42:** If this introduces a new UI pattern, document it in `08-crosscutting.md`",
-    "adding-api-route": "- Ensure authentication middleware covers this route\n- Validate all input with zod or equivalent\n- Follow existing error response patterns\n- Consider rate limiting for public endpoints\n- If this introduces a new API pattern or convention, document it in an ADR\n- **Arc42:** Update `03-context.md` if this route exposes a new external integration; update `06-runtime-views.md` if it's a key workflow",
-    "adding-hook": "- Follow the `use` prefix convention\n- Keep hooks focused \u2014 one responsibility per hook\n- Consider memoization for expensive computations\n- Document the hook's return type",
-    "modifying-auth": "- Check all API routes still have auth coverage after changes\n- Verify no secrets leak to client components\n- Test edge cases: expired tokens, revoked sessions, role changes\n- Update security quality scenarios if behavior changes\n- Document the auth strategy and any changes in an ADR \u2014 auth decisions are critical to trace\n- **Arc42:** Update `08-crosscutting.md` with the auth pattern; update `06-runtime-views.md` with the auth flow",
-    "new-dependency": "- Document the dependency rationale in an ADR\n- Check bundle size impact (client-side deps)\n- Verify the dependency doesn't introduce known CVEs\n- Ensure the dependency's license is compatible\n- **Arc42:** If this dependency introduces a new external system, update `03-context.md`",
-    "refactoring": "- Ensure no cross-block boundary violations are introduced\n- Maintain existing public API contracts\n- Run tests before and after to verify behavior preservation\n- Check that no quality scenarios regress\n- If the refactoring changes architectural patterns, update or create an ADR to explain why\n- **Arc42:** Update `05-building-blocks.md` if module structure changed; update `08-crosscutting.md` if patterns changed",
-    "general": "- Check `arcbridge_get_relevant_adrs` for existing decisions that may constrain this change\n- If you're choosing between approaches, document the decision in an ADR\n- **Arc42:** Consider which documentation sections may need updating (check `.arcbridge/arc42/` \u2014 especially `05-building-blocks.md` and `08-crosscutting.md`)"
-  };
-  return guidance[action] ?? null;
+var FRONTEND_GUIDANCE = {
+  "adding-component": "- Follow existing component patterns in this directory\n- Add props interface alongside the component\n- Consider server vs. client: does this need interactivity (`'use client'`)?\n- Check accessibility: keyboard navigation, ARIA labels, screen reader support\n- **Arc42:** If this introduces a new UI pattern, document it in `08-crosscutting.md`",
+  "adding-api-route": "- Ensure authentication middleware covers this route\n- Validate all input with zod or equivalent\n- Follow existing error response patterns\n- Consider rate limiting for public endpoints\n- **Arc42:** Update `03-context.md` if this exposes a new external integration",
+  "adding-hook": "- Follow the `use` prefix convention\n- Keep hooks focused \u2014 one responsibility per hook\n- Consider memoization for expensive computations\n- Document the hook's return type",
+  "modifying-auth": "- Check all API routes still have auth coverage after changes\n- Verify no secrets leak to client components\n- Test edge cases: expired tokens, revoked sessions, role changes\n- **Arc42:** Update `08-crosscutting.md` with the auth pattern",
+  "new-dependency": "- Document the dependency rationale in an ADR\n- Check bundle size impact (client-side deps)\n- Verify no known CVEs\n- **Arc42:** If this introduces a new external system, update `03-context.md`"
+};
+var DOTNET_GUIDANCE = {
+  "adding-component": "- Follow the existing service/repository pattern\n- Register the new class in DI (Program.cs or extension method)\n- Add an interface if the component needs to be mockable\n- **Arc42:** Update `05-building-blocks.md` if this is a new architectural layer",
+  "adding-api-route": "- Use `[HttpGet]`, `[HttpPost]`, etc. attributes for controller routes, or `MapGet`/`MapPost` for minimal APIs\n- Apply `[Authorize]` for protected endpoints\n- Validate input with data annotations or FluentValidation\n- Follow existing error response patterns (ProblemDetails)\n- **Arc42:** Update `03-context.md` if this exposes new external integrations; update `06-runtime-views.md` for key workflows",
+  "adding-hook": "- .NET equivalent: create a middleware, filter, or hosted service\n- Register in the DI container\n- Follow the single responsibility principle",
+  "modifying-auth": "- Check `[Authorize]` coverage on all controllers/endpoints\n- Verify JWT validation, claims, and policy configuration\n- Test edge cases: expired tokens, revoked sessions, role changes\n- **Arc42:** Update `08-crosscutting.md` with the auth pattern",
+  "new-dependency": "- Document the NuGet package rationale in an ADR\n- Check for known vulnerabilities with `dotnet list package --vulnerable`\n- Verify license compatibility\n- **Arc42:** If this introduces a new external system, update `03-context.md`"
+};
+var API_GUIDANCE = {
+  "adding-component": "- Follow existing module/service patterns\n- Add TypeScript interfaces for public APIs\n- Register in the dependency injection or module system\n- **Arc42:** Update `05-building-blocks.md` if this is a new architectural layer",
+  "adding-api-route": "- Ensure authentication middleware covers this route\n- Validate all input with zod or equivalent\n- Follow existing error response patterns\n- Consider rate limiting for public endpoints\n- **Arc42:** Update `03-context.md` if this exposes a new external integration",
+  "adding-hook": "- Use middleware for cross-cutting concerns\n- Keep middleware focused \u2014 one responsibility per middleware\n- Document the middleware's purpose and order",
+  "modifying-auth": "- Check all routes still have auth coverage\n- Verify token validation and session handling\n- Test edge cases: expired tokens, revoked sessions\n- **Arc42:** Update `08-crosscutting.md` with the auth pattern",
+  "new-dependency": "- Document the dependency rationale in an ADR\n- Verify no known CVEs\n- Ensure license compatibility\n- **Arc42:** If this introduces a new external system, update `03-context.md`"
+};
+var SHARED_GUIDANCE = {
+  "refactoring": "- Ensure no cross-block boundary violations are introduced\n- Maintain existing public API contracts\n- Run tests before and after to verify behavior preservation\n- If the refactoring changes architectural patterns, update or create an ADR\n- **Arc42:** Update `05-building-blocks.md` if module structure changed; update `08-crosscutting.md` if patterns changed",
+  "general": "- Check `arcbridge_get_relevant_adrs` for existing decisions that may constrain this change\n- If you're choosing between approaches, document the decision in an ADR\n- **Arc42:** Consider which documentation sections may need updating (check `.arcbridge/arc42/`)"
+};
+function getActionGuidance(action, projectType) {
+  if (SHARED_GUIDANCE[action]) return SHARED_GUIDANCE[action];
+  switch (projectType) {
+    case "dotnet-webapi":
+      return DOTNET_GUIDANCE[action] ?? null;
+    case "api-service":
+      return API_GUIDANCE[action] ?? null;
+    case "react-vite":
+    case "nextjs-app-router":
+      return FRONTEND_GUIDANCE[action] ?? null;
+    default:
+      return null;
+  }
 }
 
 // src/tools/get-open-questions.ts
-import { z as z20 } from "zod";
+import { z as z22 } from "zod";
 function registerGetOpenQuestions(server, ctx) {
   server.tool(
     "arcbridge_get_open_questions",
     "Surface architectural gaps: untested quality scenarios, building blocks without boundaries, unresolved drift, and tasks missing acceptance criteria.",
     {
-      target_dir: z20.string().describe("Absolute path to the project directory"),
-      scope: z20.string().optional().describe("Focus scope: 'current-phase', 'building-block:<id>', or omit for project-wide")
+      target_dir: z22.string().describe("Absolute path to the project directory"),
+      scope: z22.string().optional().describe("Focus scope: 'current-phase', 'building-block:<id>', or omit for project-wide")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
@@ -2223,7 +2411,7 @@ function registerGetOpenQuestions(server, ctx) {
 }
 
 // src/tools/propose-arc42-update.ts
-import { z as z21 } from "zod";
+import { z as z23 } from "zod";
 import {
   resolveRef,
   getChangedFiles,
@@ -2235,9 +2423,9 @@ function registerProposeArc42Update(server, ctx) {
     "arcbridge_propose_arc42_update",
     "Analyze code changes since a reference point and generate specific, actionable proposals for updating arc42 documentation.",
     {
-      target_dir: z21.string().describe("Absolute path to the project directory"),
-      changes_since: z21.string().default("last-sync").describe("Reference point: 'last-commit', 'last-sync', 'last-phase', or a git ref"),
-      update_sync_point: z21.boolean().default(false).describe("Update the stored sync commit to HEAD after generating proposals")
+      target_dir: z23.string().describe("Absolute path to the project directory"),
+      changes_since: z23.string().default("last-sync").describe("Reference point: 'last-commit', 'last-sync', 'last-phase', or a git ref"),
+      update_sync_point: z23.boolean().default(false).describe("Update the stored sync commit to HEAD after generating proposals")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
@@ -2425,10 +2613,11 @@ function findCrossBlockConsumers(db, symbolId, sourceBlockId, blocks) {
 }
 
 // src/tools/get-practice-review.ts
-import { z as z22 } from "zod";
+import { z as z24 } from "zod";
 import {
   resolveRef as resolveRef2,
   getChangedFiles as getChangedFiles2,
+  scopeToProject,
   detectDrift as detectDrift2
 } from "@arcbridge/core";
 function registerGetPracticeReview(server, ctx) {
@@ -2436,15 +2625,16 @@ function registerGetPracticeReview(server, ctx) {
     "arcbridge_get_practice_review",
     "Structured, practice-aware review of recent code changes across 5 dimensions: Architecture, Security, Testing, Documentation, and Complexity.",
     {
-      target_dir: z22.string().describe("Absolute path to the project directory"),
-      since: z22.string().default("last-commit").describe("Reference point: 'last-commit', 'last-session', or 'last-phase'")
+      target_dir: z24.string().describe("Absolute path to the project directory"),
+      since: z24.string().default("last-commit").describe("Reference point: 'last-commit', 'last-session', or 'last-phase'")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
       if (!db) return notInitialized();
       const projectRoot = ctx.projectRoot ?? params.target_dir;
       const ref = resolveRef2(projectRoot, params.since, db);
-      const changedFiles = getChangedFiles2(projectRoot, ref.sha);
+      const allChangedFiles = getChangedFiles2(projectRoot, ref.sha);
+      const changedFiles = scopeToProject(allChangedFiles, projectRoot);
       if (changedFiles.length === 0) {
         return textResult(
           `# Practice Review
@@ -2752,7 +2942,7 @@ function reviewComplexity(db, changedFiles, findings) {
 }
 
 // src/tools/complete-phase.ts
-import { z as z23 } from "zod";
+import { z as z25 } from "zod";
 import {
   detectDrift as detectDrift3,
   writeDriftLog as writeDriftLog2,
@@ -2761,8 +2951,8 @@ import {
   inferTaskStatuses,
   applyInferences,
   verifyScenarios,
-  loadConfig as loadConfig3,
-  refreshFromDocs as refreshFromDocs5,
+  loadConfig as loadConfig4,
+  refreshFromDocs as refreshFromDocs6,
   syncPhaseToYaml,
   transaction
 } from "@arcbridge/core";
@@ -2771,17 +2961,17 @@ function registerCompletePhase(server, ctx) {
     "arcbridge_complete_phase",
     "Attempt to complete a phase by validating all gates: tasks done, no critical drift, quality scenarios passing. Transitions the phase to 'complete' if all gates pass.",
     {
-      target_dir: z23.string().describe("Absolute path to the project directory"),
-      phase_id: z23.string().optional().describe("Phase ID to complete (defaults to current in-progress phase)"),
-      notes: z23.string().optional().describe("Optional notes about this phase completion"),
-      auto_infer: z23.boolean().default(true).describe("Automatically infer task statuses from code state before checking gates"),
-      run_tests: z23.boolean().default(false).describe("Run linked tests for quality scenarios before checking the quality gate")
+      target_dir: z25.string().describe("Absolute path to the project directory"),
+      phase_id: z25.string().optional().describe("Phase ID to complete (defaults to current in-progress phase)"),
+      notes: z25.string().optional().describe("Optional notes about this phase completion"),
+      auto_infer: z25.boolean().default(true).describe("Automatically infer task statuses from code state before checking gates"),
+      run_tests: z25.boolean().default(false).describe("Run linked tests for quality scenarios before checking the quality gate")
     },
     async (params) => {
       const start = Date.now();
       const db = ensureDb(ctx, params.target_dir);
       if (!db) return notInitialized();
-      refreshFromDocs5(db, params.target_dir);
+      refreshFromDocs6(db, params.target_dir);
       let phase;
       if (params.phase_id) {
         phase = db.prepare("SELECT id, name, phase_number, status, gate_status FROM phases WHERE id = ?").get(params.phase_id);
@@ -2816,7 +3006,7 @@ function registerCompletePhase(server, ctx) {
         }
       }
       const tasks = db.prepare("SELECT id, title, status FROM tasks WHERE phase_id = ?").all(phase.id);
-      const incompleteTasks = tasks.filter((t) => t.status !== "done");
+      const incompleteTasks = tasks.filter((t) => t.status !== "done" && t.status !== "cancelled");
       const tasksPass = incompleteTasks.length === 0;
       const driftEntries = detectDrift3(db);
       writeDriftLog2(db, driftEntries);
@@ -2826,7 +3016,7 @@ function registerCompletePhase(server, ctx) {
         const projectRoot = ctx.projectRoot ?? params.target_dir;
         let testCommand = "npx vitest run";
         let timeoutMs = 6e4;
-        const configResult = loadConfig3(params.target_dir);
+        const configResult = loadConfig4(params.target_dir);
         if (configResult.config) {
           testCommand = configResult.config.testing.test_command;
           timeoutMs = configResult.config.testing.timeout_ms;
@@ -2990,18 +3180,18 @@ function registerCompletePhase(server, ctx) {
 }
 
 // src/tools/activate-role.ts
-import { z as z24 } from "zod";
+import { z as z26 } from "zod";
 import { loadRole, loadRoles } from "@arcbridge/core";
 function registerActivateRole(server, ctx) {
   server.tool(
     "arcbridge_activate_role",
     "Activate an agent role: loads the role's system prompt, required tools, quality focus, and pre-loaded architectural context.",
     {
-      target_dir: z24.string().describe("Absolute path to the project directory"),
-      role: z24.string().describe(
+      target_dir: z26.string().describe("Absolute path to the project directory"),
+      role: z26.string().describe(
         "Role ID to activate (e.g., 'architect', 'implementer', 'security-reviewer')"
       ),
-      building_block: z24.string().optional().describe("Focus on a specific building block (for implementer/code-reviewer roles)")
+      building_block: z26.string().optional().describe("Focus on a specific building block (for implementer/code-reviewer roles)")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
@@ -3303,18 +3493,18 @@ function getRoleDefinition(roleId) {
 }
 
 // src/tools/verify-scenarios.ts
-import { z as z25 } from "zod";
-import { verifyScenarios as verifyScenarios2, loadConfig as loadConfig4 } from "@arcbridge/core";
+import { z as z27 } from "zod";
+import { verifyScenarios as verifyScenarios2, loadConfig as loadConfig5 } from "@arcbridge/core";
 function registerVerifyScenarios(server, ctx) {
   server.tool(
     "arcbridge_verify_scenarios",
     "Run linked tests for quality scenarios and update their pass/fail status. Only runs scenarios with verification='automatic' or 'semi-automatic' and non-empty linked_tests.",
     {
-      target_dir: z25.string().describe("Absolute path to the project directory"),
-      scenario_ids: z25.array(z25.string()).optional().describe(
+      target_dir: z27.string().describe("Absolute path to the project directory"),
+      scenario_ids: z27.array(z27.string()).optional().describe(
         "Specific scenario IDs to verify (e.g., ['SEC-01', 'PERF-01']). If omitted, verifies all automatic scenarios."
       ),
-      test_command: z25.string().optional().describe(
+      test_command: z27.string().optional().describe(
         "Override the test command from config (e.g., 'npx jest'). File paths are appended as arguments."
       )
     },
@@ -3323,7 +3513,7 @@ function registerVerifyScenarios(server, ctx) {
       if (!db) return notInitialized();
       let testCommand = "npx vitest run";
       let timeoutMs = 6e4;
-      const configResult = loadConfig4(params.target_dir);
+      const configResult = loadConfig5(params.target_dir);
       if (configResult.config) {
         testCommand = configResult.config.testing.test_command;
         timeoutMs = configResult.config.testing.timeout_ms;
@@ -3381,13 +3571,14 @@ function registerVerifyScenarios(server, ctx) {
 }
 
 // src/tools/run-role-check.ts
-import { z as z26 } from "zod";
+import { z as z28 } from "zod";
 import {
   loadRole as loadRole2,
   loadRoles as loadRoles2,
   detectDrift as detectDrift4,
   resolveRef as resolveRef3,
-  getChangedFiles as getChangedFiles3
+  getChangedFiles as getChangedFiles3,
+  scopeToProject as scopeToProject2
 } from "@arcbridge/core";
 var SCOPE_VALUES = ["last-commit", "current-phase", "full-project"];
 function registerRunRoleCheck(server, ctx) {
@@ -3395,11 +3586,11 @@ function registerRunRoleCheck(server, ctx) {
     "arcbridge_run_role_check",
     "Run a role-specific architectural analysis: resolves the role and executes relevant checks (drift, quality scenarios, boundaries, changed files) based on the role's focus areas.",
     {
-      target_dir: z26.string().describe("Absolute path to the project directory"),
-      role: z26.string().describe(
+      target_dir: z28.string().describe("Absolute path to the project directory"),
+      role: z28.string().describe(
         "Role ID to run checks for (e.g., 'security-reviewer', 'quality-guardian', 'architect', 'phase-manager', 'code-reviewer')"
       ),
-      scope: z26.enum(SCOPE_VALUES).default("current-phase").describe(
+      scope: z28.enum(SCOPE_VALUES).default("current-phase").describe(
         "Scope of analysis: 'last-commit' (recent changes), 'current-phase' (since phase start), 'full-project' (everything)"
       )
     },
@@ -3466,7 +3657,8 @@ function getChangedFilesForScope(db, projectRoot, scope) {
   const since = scope === "last-commit" ? "last-commit" : "last-phase";
   const ref = resolveRef3(projectRoot, since, db);
   try {
-    return getChangedFiles3(projectRoot, ref.sha);
+    const files = getChangedFiles3(projectRoot, ref.sha);
+    return scopeToProject2(files, projectRoot);
   } catch {
     return null;
   }
@@ -3755,7 +3947,7 @@ function runPhaseManagerCheck(db, projectRoot, lines) {
   }
   const ref = resolveRef3(projectRoot, "last-sync", db);
   try {
-    const changedFiles = getChangedFiles3(projectRoot, ref.sha);
+    const changedFiles = scopeToProject2(getChangedFiles3(projectRoot, ref.sha), projectRoot);
     if (changedFiles.length > 0) {
       lines.push(`## Changes Since Last Sync (${ref.label})`, "");
       appendChangedFilesList(lines, changedFiles);
@@ -3818,34 +4010,125 @@ function runCustomRoleCheck(db, lines, roleDef) {
   appendDriftSection(db, lines);
 }
 
+// src/tools/update-scenario-status.ts
+import { z as z29 } from "zod";
+import { syncScenarioToYaml, transaction as transaction2 } from "@arcbridge/core";
+function registerUpdateScenarioStatus(server, ctx) {
+  server.tool(
+    "arcbridge_update_scenario_status",
+    "Update a quality scenario's status and optionally link test files. Use this to mark scenarios as passing/failing after manual verification, or to link test files so `arcbridge_verify_scenarios` can run them automatically.",
+    {
+      target_dir: z29.string().describe("Absolute path to the project directory"),
+      scenario_id: z29.string().describe("Quality scenario ID (e.g., 'SEC-01', 'PERF-01')"),
+      status: z29.enum(["passing", "failing", "untested", "partial"]).describe("New status for the scenario"),
+      linked_tests: z29.array(z29.string()).optional().describe(
+        "Test file paths to link to this scenario (e.g., ['src/__tests__/auth.test.ts']). Once linked, `arcbridge_verify_scenarios` can run them automatically. Also sets verification to 'semi-automatic' if currently 'manual'."
+      )
+    },
+    async (params) => {
+      const db = ensureDb(ctx, params.target_dir);
+      if (!db) return notInitialized();
+      const projectRoot = ctx.projectRoot ?? params.target_dir;
+      const scenario = db.prepare("SELECT id, name, status, linked_tests, verification FROM quality_scenarios WHERE id = ?").get(params.scenario_id);
+      if (!scenario) {
+        const available = db.prepare("SELECT id, name, status FROM quality_scenarios ORDER BY id").all();
+        const list = available.length > 0 ? available.map((s) => `  - \`${s.id}\` ${s.name} (${s.status})`).join("\n") : "  (none)";
+        return textResult(
+          `Scenario '${params.scenario_id}' not found.
+
+**Available scenarios:**
+${list}`
+        );
+      }
+      const oldStatus = scenario.status;
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      if (params.linked_tests) {
+        const { isAbsolute, normalize } = await import("path");
+        const invalid = params.linked_tests.filter((t) => {
+          const norm = normalize(t);
+          return isAbsolute(norm) || norm.startsWith("..");
+        });
+        if (invalid.length > 0) {
+          return textResult(
+            `Invalid test paths (must be relative, no '..' segments):
+${invalid.map((p) => `  - ${p}`).join("\n")}`
+          );
+        }
+      }
+      transaction2(db, () => {
+        db.prepare("UPDATE quality_scenarios SET status = ?, last_checked = ? WHERE id = ?").run(
+          params.status,
+          now,
+          params.scenario_id
+        );
+        if (params.linked_tests) {
+          db.prepare("UPDATE quality_scenarios SET linked_tests = ? WHERE id = ?").run(
+            JSON.stringify(params.linked_tests),
+            params.scenario_id
+          );
+          if (scenario.verification === "manual") {
+            db.prepare("UPDATE quality_scenarios SET verification = 'semi-automatic' WHERE id = ?").run(
+              params.scenario_id
+            );
+          }
+        }
+      });
+      let yamlWarning;
+      try {
+        const newVerification = params.linked_tests && scenario.verification === "manual" ? "semi-automatic" : void 0;
+        syncScenarioToYaml(projectRoot, params.scenario_id, params.status, params.linked_tests, newVerification);
+      } catch (err) {
+        yamlWarning = `YAML sync failed: ${err instanceof Error ? err.message : String(err)}. DB updated but YAML may be out of sync.`;
+      }
+      const lines = [
+        `Scenario **${scenario.id}** (${scenario.name}) updated: ${oldStatus} \u2192 **${params.status}**`
+      ];
+      if (params.linked_tests) {
+        lines.push(
+          "",
+          `**Linked tests:** ${params.linked_tests.length} file(s)`,
+          ...params.linked_tests.map((t) => `  - ${t}`)
+        );
+        if (scenario.verification === "manual") {
+          lines.push("", "*Verification upgraded from manual to semi-automatic*");
+        }
+      }
+      if (yamlWarning) {
+        lines.push("", `**Warning:** ${yamlWarning}`);
+      }
+      return textResult(lines.join("\n"));
+    }
+  );
+}
+
 // src/tools/record-activity.ts
-import { z as z27 } from "zod";
+import { z as z30 } from "zod";
 import { insertActivity as insertActivity2, getSessionTotals } from "@arcbridge/core";
 function registerRecordActivity(server, ctx) {
   server.tool(
     "arcbridge_record_activity",
     "Record agent activity \u2014 model, tokens, cost, duration, and optional quality snapshot. Use this to track what work was done and measure agent performance.",
     {
-      target_dir: z27.string().describe("Absolute path to the project directory"),
-      tool_name: z27.string().describe("Name of the tool or action performed (e.g., 'arcbridge_update_task', 'code_edit')"),
-      action: z27.string().optional().describe("Human-readable label (e.g., 'implement login form')"),
-      model: z27.string().optional().describe("Model identifier (e.g., 'claude-sonnet-4-20250514')"),
-      agent_role: z27.string().optional().describe("Active ArcBridge role (e.g., 'implementer')"),
-      task_id: z27.string().optional().describe("Associated task ID"),
-      phase_id: z27.string().optional().describe("Associated phase ID"),
-      input_tokens: z27.number().int().nonnegative().optional().describe("Input/prompt tokens"),
-      output_tokens: z27.number().int().nonnegative().optional().describe("Output/completion tokens"),
-      total_tokens: z27.number().int().nonnegative().optional().describe("Total tokens (auto-computed if input+output given)"),
-      cost_usd: z27.number().nonnegative().optional().describe("Estimated cost in USD"),
-      duration_ms: z27.number().int().nonnegative().optional().describe("Wall-clock duration in ms"),
-      drift_count: z27.number().int().nonnegative().optional().describe("Current drift count"),
-      drift_errors: z27.number().int().nonnegative().optional().describe("Current drift errors"),
-      test_pass_count: z27.number().int().nonnegative().optional().describe("Passing tests"),
-      test_fail_count: z27.number().int().nonnegative().optional().describe("Failing tests"),
-      lint_clean: z27.boolean().optional().describe("Whether lint passes cleanly"),
-      typecheck_clean: z27.boolean().optional().describe("Whether typecheck passes cleanly"),
-      notes: z27.string().optional().describe("Free-form notes"),
-      metadata: z27.record(z27.unknown()).optional().describe("Additional key-value metadata")
+      target_dir: z30.string().describe("Absolute path to the project directory"),
+      tool_name: z30.string().describe("Name of the tool or action performed (e.g., 'arcbridge_update_task', 'code_edit')"),
+      action: z30.string().optional().describe("Human-readable label (e.g., 'implement login form')"),
+      model: z30.string().optional().describe("Model identifier (e.g., 'claude-sonnet-4-20250514')"),
+      agent_role: z30.string().optional().describe("Active ArcBridge role (e.g., 'implementer')"),
+      task_id: z30.string().optional().describe("Associated task ID"),
+      phase_id: z30.string().optional().describe("Associated phase ID"),
+      input_tokens: z30.number().int().nonnegative().optional().describe("Input/prompt tokens"),
+      output_tokens: z30.number().int().nonnegative().optional().describe("Output/completion tokens"),
+      total_tokens: z30.number().int().nonnegative().optional().describe("Total tokens (auto-computed if input+output given)"),
+      cost_usd: z30.number().nonnegative().optional().describe("Estimated cost in USD"),
+      duration_ms: z30.number().int().nonnegative().optional().describe("Wall-clock duration in ms"),
+      drift_count: z30.number().int().nonnegative().optional().describe("Current drift count"),
+      drift_errors: z30.number().int().nonnegative().optional().describe("Current drift errors"),
+      test_pass_count: z30.number().int().nonnegative().optional().describe("Passing tests"),
+      test_fail_count: z30.number().int().nonnegative().optional().describe("Failing tests"),
+      lint_clean: z30.boolean().optional().describe("Whether lint passes cleanly"),
+      typecheck_clean: z30.boolean().optional().describe("Whether typecheck passes cleanly"),
+      notes: z30.string().optional().describe("Free-form notes"),
+      metadata: z30.record(z30.unknown()).optional().describe("Additional key-value metadata")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
@@ -3900,23 +4183,23 @@ function registerRecordActivity(server, ctx) {
 }
 
 // src/tools/get-metrics.ts
-import { z as z28 } from "zod";
+import { z as z31 } from "zod";
 import { queryMetrics } from "@arcbridge/core";
 function registerGetMetrics(server, ctx) {
   server.tool(
     "arcbridge_get_metrics",
     "Query agent activity metrics \u2014 filter by model, task, phase, or time range. Group by model/task/phase/tool/day for aggregated views.",
     {
-      target_dir: z28.string().describe("Absolute path to the project directory"),
-      task_id: z28.string().optional().describe("Filter by task ID"),
-      phase_id: z28.string().optional().describe("Filter by phase ID"),
-      model: z28.string().optional().describe("Filter by model name"),
-      agent_role: z28.string().optional().describe("Filter by agent role"),
-      tool_name: z28.string().optional().describe("Filter by tool name"),
-      since: z28.string().optional().describe("ISO 8601 timestamp \u2014 activity after this time"),
-      until: z28.string().optional().describe("ISO 8601 timestamp \u2014 activity before this time"),
-      group_by: z28.enum(["model", "task", "phase", "tool", "day", "none"]).default("none").describe("Group results for aggregation"),
-      limit: z28.number().int().min(1).max(500).default(50).describe("Max rows in detail view (group_by=none)")
+      target_dir: z31.string().describe("Absolute path to the project directory"),
+      task_id: z31.string().optional().describe("Filter by task ID"),
+      phase_id: z31.string().optional().describe("Filter by phase ID"),
+      model: z31.string().optional().describe("Filter by model name"),
+      agent_role: z31.string().optional().describe("Filter by agent role"),
+      tool_name: z31.string().optional().describe("Filter by tool name"),
+      since: z31.string().optional().describe("ISO 8601 timestamp \u2014 activity after this time"),
+      until: z31.string().optional().describe("ISO 8601 timestamp \u2014 activity before this time"),
+      group_by: z31.enum(["model", "task", "phase", "tool", "day", "none"]).default("none").describe("Group results for aggregation"),
+      limit: z31.number().int().min(1).max(500).default(50).describe("Max rows in detail view (group_by=none)")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
@@ -3999,23 +4282,23 @@ function mdCell(val) {
 }
 
 // src/tools/export-metrics.ts
-import { z as z29 } from "zod";
+import { z as z32 } from "zod";
 import { exportMetrics } from "@arcbridge/core";
 function registerExportMetrics(server, ctx) {
   server.tool(
     "arcbridge_export_metrics",
     "Export agent activity metrics to a file (JSON, CSV, or Markdown) in .arcbridge/metrics/ for git commits or reporting.",
     {
-      target_dir: z29.string().describe("Absolute path to the project directory"),
-      format: z29.enum(["json", "csv", "markdown"]).default("json").describe("Export format"),
-      task_id: z29.string().optional().describe("Filter by task ID"),
-      phase_id: z29.string().optional().describe("Filter by phase ID"),
-      model: z29.string().optional().describe("Filter by model name"),
-      agent_role: z29.string().optional().describe("Filter by agent role"),
-      tool_name: z29.string().optional().describe("Filter by tool name"),
-      since: z29.string().optional().describe("ISO 8601 \u2014 activity after this time"),
-      until: z29.string().optional().describe("ISO 8601 \u2014 activity before this time"),
-      max_rows: z29.number().int().min(1).default(1e5).describe("Maximum rows to export (default: 100,000)")
+      target_dir: z32.string().describe("Absolute path to the project directory"),
+      format: z32.enum(["json", "csv", "markdown"]).default("json").describe("Export format"),
+      task_id: z32.string().optional().describe("Filter by task ID"),
+      phase_id: z32.string().optional().describe("Filter by phase ID"),
+      model: z32.string().optional().describe("Filter by model name"),
+      agent_role: z32.string().optional().describe("Filter by agent role"),
+      tool_name: z32.string().optional().describe("Filter by tool name"),
+      since: z32.string().optional().describe("ISO 8601 \u2014 activity after this time"),
+      until: z32.string().optional().describe("ISO 8601 \u2014 activity before this time"),
+      max_rows: z32.number().int().min(1).default(1e5).describe("Maximum rows to export (default: 100,000)")
     },
     async (params) => {
       const db = ensureDb(ctx, params.target_dir);
@@ -4063,6 +4346,8 @@ function createArcBridgeServer() {
   registerGetCurrentTasks(server, ctx);
   registerUpdateTask(server, ctx);
   registerCreateTask(server, ctx);
+  registerDeleteTask(server, ctx);
+  registerCreatePhase(server, ctx);
   registerReindex(server, ctx);
   registerSearchSymbols(server, ctx);
   registerGetSymbol(server, ctx);
@@ -4078,6 +4363,7 @@ function createArcBridgeServer() {
   registerCompletePhase(server, ctx);
   registerActivateRole(server, ctx);
   registerVerifyScenarios(server, ctx);
+  registerUpdateScenarioStatus(server, ctx);
   registerRunRoleCheck(server, ctx);
   registerRecordActivity(server, ctx);
   registerGetMetrics(server, ctx);