@arcbridge/mcp-server 0.1.5 → 0.2.0

package/dist/index.js

@@ -40,8 +40,8 @@ function registerInitProject(server, ctx) {
     "Initialize ArcBridge in a project directory. Creates .arcbridge/ with arc42 documentation, phase plan, agent roles, SQLite database, and platform-specific configs.",
     {
       name: z.string().min(1).describe("Project name"),
-      template: z.enum(["nextjs-app-router", "react-vite", "api-service", "dotnet-webapi"]).default("nextjs-app-router").describe(
-        "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#)"
+      template: z.enum(["nextjs-app-router", "react-vite", "api-service", "dotnet-webapi", "unity-game"]).default("nextjs-app-router").describe(
+        "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#), unity-game (Unity game project, C#, code-heavy)"
       ),
       features: z.array(z.enum(["auth", "database", "api"])).default([]).describe("Features to scaffold"),
       quality_priorities: z.array(z.string()).default(["security", "performance", "accessibility", "maintainability"]).describe("Quality priorities in order"),
@@ -1104,16 +1104,80 @@ function registerDeleteTask(server, ctx) {
   );
 }
 
-// src/tools/get-relevant-adrs.ts
+// 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: z11.string().describe("Absolute path to the project directory"),
-      file_path: z11.string().optional().describe("File path to find relevant ADRs for"),
-      building_block: z11.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);
@@ -1197,24 +1261,24 @@ function formatAdrs(adrs, title) {
 }
 
 // src/tools/reindex.ts
-import { z as z12 } 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: z12.string().describe("Absolute path to the project directory"),
-      tsconfig_path: z12.string().optional().describe("Override tsconfig.json path (default: auto-detect). Only used for TypeScript projects."),
-      service: z12.string().optional().describe("Service name for monorepo projects (default: 'main')"),
-      language: z12.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,
@@ -1253,16 +1317,16 @@ function registerReindex(server, ctx) {
 }
 
 // src/tools/search-symbols.ts
-import { z as z13 } 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: z13.string().describe("Absolute path to the project directory"),
-      query: z13.string().optional().describe("Search term to match against symbol names"),
-      service: z13.string().optional().describe("Filter by service name (for multi-project solutions). Omit to search all services."),
-      kind: z13.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",
@@ -1274,10 +1338,10 @@ function registerSearchSymbols(server, ctx) {
         "hook",
         "context"
       ]).optional().describe("Filter by symbol kind"),
-      file_path: z13.string().optional().describe("Filter by file path (prefix match)"),
-      is_exported: z13.boolean().optional().describe("Filter by export status"),
-      building_block: z13.string().optional().describe("Filter by building block ID (matches against code_paths)"),
-      limit: z13.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);
@@ -1364,7 +1428,7 @@ function registerSearchSymbols(server, ctx) {
 }
 
 // src/tools/get-symbol.ts
-import { z as z14 } 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) {
@@ -1372,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: z14.string().describe("Absolute path to the project directory"),
-      symbol_id: z14.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: z14.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);
@@ -1474,21 +1538,21 @@ Use \`arcbridge_search_symbols\` to find symbols by name.`
 }
 
 // src/tools/get-dependency-graph.ts
-import { z as z15 } 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: z15.string().describe("Absolute path to the project directory"),
-      module: z15.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: z15.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: z15.number().int().min(1).max(5).default(1).describe("How many levels to traverse (default: 1, max: 5)"),
-      service: z15.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);
@@ -1635,16 +1699,16 @@ function formatEdges(edges, modulePath, direction) {
 }
 
 // src/tools/get-component-graph.ts
-import { z as z16 } 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: z16.string().describe("Absolute path to the project directory"),
-      file_path: z16.string().optional().describe("Filter to components in a specific file or directory prefix"),
-      client_only: z16.boolean().optional().describe("Only show client components ('use client')"),
-      with_state: z16.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);
@@ -1748,16 +1812,16 @@ function registerGetComponentGraph(server, ctx) {
 }
 
 // src/tools/get-route-map.ts
-import { z as z17 } 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: z17.string().describe("Absolute path to the project directory"),
-      kind: z17.enum(["page", "layout", "loading", "error", "not-found", "api-route", "middleware"]).optional().describe("Filter by route kind"),
-      route_prefix: z17.string().optional().describe("Filter by route path prefix (e.g. '/dashboard' or '/api/orders')"),
-      service: z17.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);
@@ -1833,13 +1897,13 @@ function registerGetRouteMap(server, ctx) {
 }
 
 // src/tools/get-boundary-analysis.ts
-import { z as z18 } 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: z18.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);
@@ -1943,15 +2007,15 @@ function registerGetBoundaryAnalysis(server, ctx) {
 }
 
 // src/tools/check-drift.ts
-import { z as z19 } 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: z19.string().describe("Absolute path to the project directory"),
-      persist: z19.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();
@@ -2023,16 +2087,16 @@ function registerCheckDrift(server, ctx) {
 }
 
 // src/tools/get-guidance.ts
-import { z as z20 } 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: z20.string().describe("Absolute path to the project directory"),
-      file_path: z20.string().optional().describe("File path you're working on (to determine building block and context)"),
-      action: z20.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",
@@ -2230,14 +2294,14 @@ function getActionGuidance(action, projectType) {
 }
 
 // src/tools/get-open-questions.ts
-import { z as z21 } 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: z21.string().describe("Absolute path to the project directory"),
-      scope: z21.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);
@@ -2347,7 +2411,7 @@ function registerGetOpenQuestions(server, ctx) {
 }
 
 // src/tools/propose-arc42-update.ts
-import { z as z22 } from "zod";
+import { z as z23 } from "zod";
 import {
   resolveRef,
   getChangedFiles,
@@ -2359,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: z22.string().describe("Absolute path to the project directory"),
-      changes_since: z22.string().default("last-sync").describe("Reference point: 'last-commit', 'last-sync', 'last-phase', or a git ref"),
-      update_sync_point: z22.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);
@@ -2549,7 +2613,7 @@ function findCrossBlockConsumers(db, symbolId, sourceBlockId, blocks) {
 }
 
 // src/tools/get-practice-review.ts
-import { z as z23 } from "zod";
+import { z as z24 } from "zod";
 import {
   resolveRef as resolveRef2,
   getChangedFiles as getChangedFiles2,
@@ -2561,8 +2625,8 @@ 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: z23.string().describe("Absolute path to the project directory"),
-      since: z23.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);
@@ -2878,7 +2942,7 @@ function reviewComplexity(db, changedFiles, findings) {
 }
 
 // src/tools/complete-phase.ts
-import { z as z24 } from "zod";
+import { z as z25 } from "zod";
 import {
   detectDrift as detectDrift3,
   writeDriftLog as writeDriftLog2,
@@ -2888,7 +2952,7 @@ import {
   applyInferences,
   verifyScenarios,
   loadConfig as loadConfig4,
-  refreshFromDocs as refreshFromDocs5,
+  refreshFromDocs as refreshFromDocs6,
   syncPhaseToYaml,
   transaction
 } from "@arcbridge/core";
@@ -2897,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: z24.string().describe("Absolute path to the project directory"),
-      phase_id: z24.string().optional().describe("Phase ID to complete (defaults to current in-progress phase)"),
-      notes: z24.string().optional().describe("Optional notes about this phase completion"),
-      auto_infer: z24.boolean().default(true).describe("Automatically infer task statuses from code state before checking gates"),
-      run_tests: z24.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);
@@ -3116,18 +3180,18 @@ function registerCompletePhase(server, ctx) {
 }
 
 // src/tools/activate-role.ts
-import { z as z25 } 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: z25.string().describe("Absolute path to the project directory"),
-      role: z25.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: z25.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);
@@ -3429,18 +3493,18 @@ function getRoleDefinition(roleId) {
 }
 
 // src/tools/verify-scenarios.ts
-import { z as z26 } from "zod";
+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: z26.string().describe("Absolute path to the project directory"),
-      scenario_ids: z26.array(z26.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: z26.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."
       )
     },
@@ -3507,7 +3571,7 @@ function registerVerifyScenarios(server, ctx) {
 }
 
 // src/tools/run-role-check.ts
-import { z as z27 } from "zod";
+import { z as z28 } from "zod";
 import {
   loadRole as loadRole2,
   loadRoles as loadRoles2,
@@ -3522,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: z27.string().describe("Absolute path to the project directory"),
-      role: z27.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: z27.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)"
       )
     },
@@ -3947,17 +4011,17 @@ function runCustomRoleCheck(db, lines, roleDef) {
 }
 
 // src/tools/update-scenario-status.ts
-import { z as z28 } from "zod";
+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: z28.string().describe("Absolute path to the project directory"),
-      scenario_id: z28.string().describe("Quality scenario ID (e.g., 'SEC-01', 'PERF-01')"),
-      status: z28.enum(["passing", "failing", "untested", "partial"]).describe("New status for the scenario"),
-      linked_tests: z28.array(z28.string()).optional().describe(
+      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'."
       )
     },
@@ -4038,33 +4102,33 @@ ${invalid.map((p) => `  - ${p}`).join("\n")}`
 }
 
 // src/tools/record-activity.ts
-import { z as z29 } 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: z29.string().describe("Absolute path to the project directory"),
-      tool_name: z29.string().describe("Name of the tool or action performed (e.g., 'arcbridge_update_task', 'code_edit')"),
-      action: z29.string().optional().describe("Human-readable label (e.g., 'implement login form')"),
-      model: z29.string().optional().describe("Model identifier (e.g., 'claude-sonnet-4-20250514')"),
-      agent_role: z29.string().optional().describe("Active ArcBridge role (e.g., 'implementer')"),
-      task_id: z29.string().optional().describe("Associated task ID"),
-      phase_id: z29.string().optional().describe("Associated phase ID"),
-      input_tokens: z29.number().int().nonnegative().optional().describe("Input/prompt tokens"),
-      output_tokens: z29.number().int().nonnegative().optional().describe("Output/completion tokens"),
-      total_tokens: z29.number().int().nonnegative().optional().describe("Total tokens (auto-computed if input+output given)"),
-      cost_usd: z29.number().nonnegative().optional().describe("Estimated cost in USD"),
-      duration_ms: z29.number().int().nonnegative().optional().describe("Wall-clock duration in ms"),
-      drift_count: z29.number().int().nonnegative().optional().describe("Current drift count"),
-      drift_errors: z29.number().int().nonnegative().optional().describe("Current drift errors"),
-      test_pass_count: z29.number().int().nonnegative().optional().describe("Passing tests"),
-      test_fail_count: z29.number().int().nonnegative().optional().describe("Failing tests"),
-      lint_clean: z29.boolean().optional().describe("Whether lint passes cleanly"),
-      typecheck_clean: z29.boolean().optional().describe("Whether typecheck passes cleanly"),
-      notes: z29.string().optional().describe("Free-form notes"),
-      metadata: z29.record(z29.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);
@@ -4119,23 +4183,23 @@ function registerRecordActivity(server, ctx) {
 }
 
 // src/tools/get-metrics.ts
-import { z as z30 } 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: z30.string().describe("Absolute path to the project directory"),
-      task_id: z30.string().optional().describe("Filter by task ID"),
-      phase_id: z30.string().optional().describe("Filter by phase ID"),
-      model: z30.string().optional().describe("Filter by model name"),
-      agent_role: z30.string().optional().describe("Filter by agent role"),
-      tool_name: z30.string().optional().describe("Filter by tool name"),
-      since: z30.string().optional().describe("ISO 8601 timestamp \u2014 activity after this time"),
-      until: z30.string().optional().describe("ISO 8601 timestamp \u2014 activity before this time"),
-      group_by: z30.enum(["model", "task", "phase", "tool", "day", "none"]).default("none").describe("Group results for aggregation"),
-      limit: z30.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);
@@ -4218,23 +4282,23 @@ function mdCell(val) {
 }
 
 // src/tools/export-metrics.ts
-import { z as z31 } 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: z31.string().describe("Absolute path to the project directory"),
-      format: z31.enum(["json", "csv", "markdown"]).default("json").describe("Export format"),
-      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 \u2014 activity after this time"),
-      until: z31.string().optional().describe("ISO 8601 \u2014 activity before this time"),
-      max_rows: z31.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);
@@ -4283,6 +4347,7 @@ function createArcBridgeServer() {
   registerUpdateTask(server, ctx);
   registerCreateTask(server, ctx);
   registerDeleteTask(server, ctx);
+  registerCreatePhase(server, ctx);
   registerReindex(server, ctx);
   registerSearchSymbols(server, ctx);
   registerGetSymbol(server, ctx);