@arcbridge/mcp-server 0.1.3 → 0.1.4

package/dist/index.js

@@ -30,7 +30,8 @@ import {
   generateAgentRoles,
   generateDatabase,
   generateSyncFiles,
-  indexProject
+  indexProject,
+  loadConfig
 } from "@arcbridge/core";
 import { getAdapter } from "@arcbridge/adapters";
 function registerInitProject(server, ctx) {
@@ -39,7 +40,9 @@ 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"),
+      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#)"
+      ),
       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"),
       platforms: z.array(z.string()).default(["claude"]).describe("Target platforms for agent config generation"),
@@ -47,16 +50,51 @@ function registerInitProject(server, ctx) {
     },
     async (params) => {
       const targetDir = params.target_dir;
-      if (existsSync(join(targetDir, ".arcbridge", "config.yaml"))) {
+      const dbExists = existsSync(join(targetDir, ".arcbridge", "index.db"));
+      const configExists = existsSync(join(targetDir, ".arcbridge", "config.yaml"));
+      if (dbExists && configExists) {
+        const { error: validationError } = loadConfig(targetDir);
+        const msg = validationError ? `ArcBridge is initialized in ${targetDir} but config has issues: ${validationError}. Use \`arcbridge_get_project_status\` to see the current state, or delete \`.arcbridge/\` to reinitialize.` : `ArcBridge is already initialized in ${targetDir}. Use \`arcbridge_get_project_status\` to see the current state, or delete \`.arcbridge/\` to reinitialize.`;
+        return {
+          content: [{ type: "text", text: msg }]
+        };
+      }
+      if (dbExists && !configExists) {
         return {
           content: [
             {
               type: "text",
-              text: `ArcBridge is already initialized in ${targetDir}. Use arcbridge_get_project_status to see the current state.`
+              text: `ArcBridge database exists in ${targetDir} but config.yaml is missing. Delete \`.arcbridge/\` to reinitialize, or restore config.yaml.`
             }
           ]
         };
       }
+      if (configExists && !dbExists) {
+        const { config: existingConfig } = loadConfig(targetDir);
+        if (existingConfig) {
+          const recoverInput = {
+            name: existingConfig.project_name,
+            template: existingConfig.project_type,
+            features: [],
+            quality_priorities: existingConfig.quality_priorities,
+            platforms: existingConfig.platforms,
+            projectRoot: targetDir
+          };
+          const { db: recoveredDb } = generateDatabase(targetDir, recoverInput);
+          ctx.db = recoveredDb;
+          ctx.projectRoot = targetDir;
+          return {
+            content: [
+              {
+                type: "text",
+                text: `ArcBridge database recovered from existing config in ${targetDir}. Your arc42 docs and plans were preserved.
+
+Use \`arcbridge_get_project_status\` to see the current state.`
+              }
+            ]
+          };
+        }
+      }
       const input = {
         name: params.name,
         template: params.template,
@@ -137,6 +175,13 @@ function registerInitProject(server, ctx) {
           ...allWarnings.map((w) => `- ${w}`)
         ] : [],
         "",
+        "## Next Steps",
+        "",
+        "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",
+        "",
         "Use `arcbridge_get_project_status` to see the full project status."
       ];
       return {
@@ -637,6 +682,7 @@ function registerGetPhasePlan(server, ctx) {
         lines.push(
           `## ${icon} Phase ${phase.phase_number}: ${phase.name}`,
           "",
+          `**ID:** \`${phase.id}\``,
           `**Status:** ${phase.status}`,
           `**Description:** ${phase.description}`
         );
@@ -769,7 +815,7 @@ import { z as z8 } from "zod";
 import { syncTaskToYaml } from "@arcbridge/core";
 
 // src/auto-record.ts
-import { loadConfig, insertActivity } from "@arcbridge/core";
+import { loadConfig as loadConfig2, insertActivity } from "@arcbridge/core";
 var configCache = /* @__PURE__ */ new Map();
 var CACHE_TTL_MS = 3e4;
 function isAutoRecordEnabled(projectRoot) {
@@ -777,7 +823,7 @@ function isAutoRecordEnabled(projectRoot) {
   if (cached && Date.now() - cached.loadedAt < CACHE_TTL_MS) {
     return cached.autoRecord;
   }
-  const { config } = loadConfig(projectRoot);
+  const { config } = loadConfig2(projectRoot);
   const autoRecord2 = config?.metrics?.auto_record ?? false;
   configCache.set(projectRoot, { autoRecord: autoRecord2, loadedAt: Date.now() });
   return autoRecord2;
@@ -945,7 +991,7 @@ function registerCreateTask(server, ctx) {
         `Task created: **${taskId}**`,
         "",
         `**Title:** ${params.title}`,
-        `**Phase:** ${phase.name}`,
+        `**Phase:** ${phase.name} (\`${phase.id}\`)`,
         `**Status:** todo`
       ];
       if (params.building_block) {
@@ -2715,7 +2761,7 @@ import {
   inferTaskStatuses,
   applyInferences,
   verifyScenarios,
-  loadConfig as loadConfig2,
+  loadConfig as loadConfig3,
   refreshFromDocs as refreshFromDocs5,
   syncPhaseToYaml,
   transaction
@@ -2780,7 +2826,7 @@ function registerCompletePhase(server, ctx) {
         const projectRoot = ctx.projectRoot ?? params.target_dir;
         let testCommand = "npx vitest run";
         let timeoutMs = 6e4;
-        const configResult = loadConfig2(params.target_dir);
+        const configResult = loadConfig3(params.target_dir);
         if (configResult.config) {
           testCommand = configResult.config.testing.test_command;
           timeoutMs = configResult.config.testing.timeout_ms;
@@ -3258,7 +3304,7 @@ function getRoleDefinition(roleId) {
 
 // src/tools/verify-scenarios.ts
 import { z as z25 } from "zod";
-import { verifyScenarios as verifyScenarios2, loadConfig as loadConfig3 } from "@arcbridge/core";
+import { verifyScenarios as verifyScenarios2, loadConfig as loadConfig4 } from "@arcbridge/core";
 function registerVerifyScenarios(server, ctx) {
   server.tool(
     "arcbridge_verify_scenarios",
@@ -3277,7 +3323,7 @@ function registerVerifyScenarios(server, ctx) {
       if (!db) return notInitialized();
       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;