add-coder 0.3.26 → 0.3.27

package/templates/core/scripts/mcp-server/tools/context.ts

@@ -6,13 +6,23 @@ import { stat } from "fs/promises"
 import { existsSync } from "fs"
 import { join, relative } from "path"
 import { textResponse, errorResponse } from "../shared/response.js"
-import { readFileSafe, readdirRecursive } from "../shared/fs.js"
+import { readFileSafe } from "../shared/fs.js"
 import { PROJECT_ROOT, MAGIC_DIR } from "../shared/fs.js"
 import { prisma } from "../shared/prisma.js"
-import type { PlanRow } from "../shared/db-types.js"
-import { PlanRowSchema, validatedDelegate } from "../shared/db-types.js"
+import type { PlanRow, ReviewRow } from "../shared/db-types.js"
+import { PlanRowSchema, ReviewRowSchema, validatedDelegate } from "../shared/db-types.js"
+import { getRuntimeContext } from "../shared/env.js"
+import { resolvePlanStatus } from "../shared/plan-lifecycle.js"
+import { createPrismaPlanStatusStore } from "../shared/plan-status-store.js"
+import { assertPathInRuntimeScope } from "../shared/runtime-context.js"
+import {
+  formatSchemaTopology,
+  loadPrismaSchemaTopology,
+  type SchemaView,
+} from "../shared/schema-topology.js"
 
 export function registerContextTools(server: ToolRegistrar) {
+  const runtimeContext = getRuntimeContext()
 
   // ===== get_project_context (L166-430) =====
   server.registerTool(
@@ -91,88 +101,73 @@ export function registerContextTools(server: ToolRegistrar) {
 
         if (scope === "all" || scope === "structure" || scope === "add-state") {
           parts.push("=== ADD 工作流状态 ===")
-          const plansDir = join(PROJECT_ROOT, MAGIC_DIR, "plans")
-          const reviewsDir = join(PROJECT_ROOT, MAGIC_DIR, "reviews")
-          const specsDir = join(PROJECT_ROOT, MAGIC_DIR, "specs")
+          parts.push(`contextId: ${runtimeContext.contextId}`)
+          parts.push("source: database")
 
-          let activePlan = ""
-          let activePlanPath = ""
-          if (existsSync(plansDir)) {
-            const planFiles = (await readdirRecursive(plansDir))
-              .filter(f => f.endsWith(".md") && !f.includes("add-route") && !f.includes("handoff"))
-              .sort()
-            if (planFiles.length > 0) {
-              activePlan = planFiles[planFiles.length - 1]
-              activePlanPath = join(plansDir, activePlan)
-              parts.push(`最近 Plan: ${activePlan}`)
-              const allPlanFiles = await readdirRecursive(plansDir)
-              const addRouteFile = allPlanFiles.find(f => f.includes("add-route"))
-              const planKeyword = activePlan.replace(/-plan-v\d+\.md$/, "")
-              const handoffFiles = allPlanFiles.filter(f => f.includes("handoff"))
-              const hasHandoff = handoffFiles.some(f => f.toLowerCase().includes(planKeyword.toLowerCase()))
-              parts.push(` add-route: ${addRouteFile ? "✅ " + addRouteFile : "❌ 缺失（需回退 Step 0.5）"}`)
-              parts.push(` handoff: ${hasHandoff ? "✅ 已生成" : "❌ 缺失（需回退 Step 0.5）"}`)
-            } else { parts.push("最近 Plan: 无") }
-          } else { parts.push("最近 Plan: 无") }
-
-          let reviewFileName = ""; let reviewP0Count = 0; let reviewP1Count = 0; let reviewBackflowRate = 0
-          if (existsSync(reviewsDir) && activePlan) {
-            const reviewFiles = await readdir(reviewsDir)
-            const planKeyword = activePlan.replace(/-plan-v\d+\.md$/, "")
-            const matchingReview = reviewFiles.find(f => f.toLowerCase().includes(planKeyword.toLowerCase()) && f.includes("-review-v"))
-              || reviewFiles.find(f => f.toLowerCase().includes(planKeyword.toLowerCase()))
-            if (matchingReview) {
-              reviewFileName = matchingReview
-              const reviewContent = await readFileSafe(join(reviewsDir, matchingReview)) || ""
-              const reviewLines = reviewContent.split("\n")
-              let inP0 = false, inP1 = false
-              for (const line of reviewLines) {
-                if (line.match(/P0|ADD.*合规|阻断/)) { inP0 = true; inP1 = false; continue }
-                if (line.match(/P1|架构设计.*缺口/)) { inP0 = false; inP1 = true; continue }
-                if (line.match(/P2|中等|影响评估|决策结论|方案对比/)) { inP0 = false; inP1 = false; continue }
-                if ((inP0 || inP1) && line.trim().startsWith("|") && !line.includes("---")) {
-                  const cols = line.split("|").map(c => c.trim()).filter(Boolean)
-                  if (cols.length >= 4 && cols[0].match(/^\d+$/)) {
-                    if (inP0) reviewP0Count++; else if (inP1) reviewP1Count++
-                  }
-                }
-              }
-              const planContent = await readFileSafe(activePlanPath) || ""
-              if ((reviewP0Count + reviewP1Count) > 0 && planContent) {
-                const indicators = ["add-route", "specs/", "handoff", "Task Group", "perExpertTopK", "agri_tech", "ChromaCollectionManager", "迁移路线图", "8 个 Expert", "冗余策略"]
-                let hit = 0
-                for (const ind of indicators) { if (planContent.toLowerCase().includes(ind.toLowerCase())) hit++ }
-                reviewBackflowRate = Math.min(100, Math.round((hit / Math.max(reviewP0Count + reviewP1Count, 1)) * 100))
-              }
-              parts.push(""); parts.push(`关联 Review: ${matchingReview}`)
-              parts.push(`  P0 问题: ${reviewP0Count} 个, P1 问题: ${reviewP1Count} 个`)
-              parts.push(`  回流状态: 约 ${reviewBackflowRate}%`)
-              parts.push(reviewBackflowRate < 70 ? "  ⚠️ Review 结论未充分回流至 Plan — 需执行 0.6.5 卡位" : "  ✅ Review 结论基本回流至 Plan")
-            } else { parts.push(""); parts.push("关联 Review: 无（该 Plan 尚未生成方案评审）") }
-          }
-
-          if (activePlan) {
-            const planKeyword = activePlan.replace(/-plan-v\d+\.md$/, "")
-            const specDirs = existsSync(specsDir) ? await readdir(specsDir) : []
-            const matchingSpec = specDirs.find(d => d.toLowerCase().includes(planKeyword.toLowerCase()))
+          const planDb = validatedDelegate<PlanRow>(prisma.planRecord, PlanRowSchema, "PlanRecord")
+          const reviewDb = validatedDelegate<ReviewRow>(prisma.reviewRecord, ReviewRowSchema, "ReviewRecord")
+          const resolution = await resolvePlanStatus(
+            createPrismaPlanStatusStore(prisma),
+            runtimeContext,
+            { activeOnly: true },
+          )
+          let activePlan: PlanRow | null = null
+          let reviewRows: ReviewRow[] = []
+          if (resolution.availability === "STATUS_UNAVAILABLE") {
+            parts.push(`状态: ⛔ STATUS_UNAVAILABLE — ${resolution.reason}`)
+            parts.push("裁决: fail closed；未回退 Plan/Handoff/add-route 文件猜测")
+          } else if (resolution.planName === null) {
+            parts.push("活跃 Plan: 无（DB lifecycle 无 ACTIVE/BLOCKED）")
+          } else {
+            activePlan = await planDb.findFirst({
+              where: {
+                projectKey: runtimeContext.projectKey,
+                adapterKey: runtimeContext.adapterKey,
+                planName: resolution.planName,
+              },
+            })
+            if (!activePlan) throw new Error(`resolver 返回 Plan 后记录消失: ${resolution.planName}`)
+            assertPathInRuntimeScope(runtimeContext, activePlan.planPath)
+            parts.push(`活跃 Plan: ${activePlan.planName}`)
+            parts.push(` lifecycle: ${resolution.lifecycle} | revision: ${resolution.revision}`)
+            parts.push(` approval: ${resolution.approvalStatus ?? "—"}`)
+            parts.push(` tasks: ${resolution.progress.doneTasks}/${resolution.progress.totalTasks}`)
+            parts.push(` Plan: ${activePlan.planPath}`)
+            parts.push(` add-route: ${activePlan.addRoutePath && existsSync(activePlan.addRoutePath) ? `✅ ${activePlan.addRoutePath}` : "❌ 缺失"}`)
+            parts.push(" handoff: 不参与 active 裁决（仅 Step 8 交接产物）")
+            parts.push("")
+            parts.push("Specs:")
+            parts.push(` spec.md: ${activePlan.specPath && existsSync(activePlan.specPath) ? "✅" : "❌"}`)
+            parts.push(` tasks.md: ${activePlan.tasksPath && existsSync(activePlan.tasksPath) ? "✅" : "❌"}`)
+            parts.push(` checklist.md: ${activePlan.checklistPath && existsSync(activePlan.checklistPath) ? "✅" : "❌"}`)
+            reviewRows = await reviewDb.findMany({
+              where: {
+                projectKey: runtimeContext.projectKey,
+                adapterKey: runtimeContext.adapterKey,
+                planName: activePlan.planName,
+              },
+              orderBy: { updatedAt: "desc" },
+            })
             parts.push("")
-            if (matchingSpec) {
-              const hasSpec = existsSync(join(specsDir, matchingSpec, "spec.md"))
-              const hasTasks = existsSync(join(specsDir, matchingSpec, "tasks.md"))
-              const hasChecklist = existsSync(join(specsDir, matchingSpec, "checklist.md"))
-              parts.push(`Specs: ${matchingSpec}/`)
-              parts.push(`  spec.md:      ${hasSpec ? "✅" : "❌"}`)
-              parts.push(`  tasks.md:     ${hasTasks ? "✅" : "❌"}`)
-              parts.push(`  checklist.md: ${hasChecklist ? "✅" : "❌"}`)
-            } else { parts.push("Specs: ❌ 缺失") }
+            if (reviewRows.length === 0) {
+              parts.push("关联 Review: 无")
+            } else {
+              parts.push(`关联 Review: ${reviewRows.length} 条（DB scoped）`)
+              for (const review of reviewRows) {
+                parts.push(`  ${review.type}: P0=${review.p0Count}, P1=${review.p1Count}, backflow=${review.backflowRate}`)
+              }
+            }
           }
 
           parts.push(""); parts.push("=== 悬空 Plan 对账（记录在、文件缺失） ===")
-          // 孤儿可见性：create_hitl 预置行被中断 / 放弃未清理 → 开局即提示，不静默累积
           try {
-            // 无类型边界单点（zod 托管）：动态 client → 运行期校验的泛型委托
-            const planDb = validatedDelegate<PlanRow>(prisma.planRecord, PlanRowSchema, "PlanRecord")
-            const allPlans = await planDb.findMany({ orderBy: { createdAt: "desc" } })
+            const allPlans = await planDb.findMany({
+              where: {
+                projectKey: runtimeContext.projectKey,
+                adapterKey: runtimeContext.adapterKey,
+              },
+              orderBy: { createdAt: "desc" },
+            })
             const orphans = allPlans.filter(p => !existsSync(p.planPath))
             if (orphans.length > 0) {
               const cutoff = Date.now() - 14 * 86400000
@@ -185,20 +180,19 @@ export function registerContextTools(server: ToolRegistrar) {
 
           parts.push(""); parts.push("=== 待执行 ADD 操作（按流程顺序） ===")
           const todoItems: string[] = []
-          if (!activePlan) { todoItems.push("1. [未开始] 用户提出需求 → 生成 Plan") }
-          else {
-            if (!reviewFileName) { todoItems.push("1. [Step 0] 生成 Plan Review（ADD-9 方案评审）") }
-            else if (reviewP0Count + reviewP1Count > 0 && reviewBackflowRate < 70) {
-              todoItems.push("1. [0.6.5] Review 结论回流至 Plan — P0/P1 未写入 Plan 体")
-              todoItems.push("2. [check_dps] DPS 门禁预计不通过（回流完整度 < 70%）")
+          if (resolution.availability === "STATUS_UNAVAILABLE") {
+            todoItems.push("1. [阻断] 恢复 DB/MCP resolver；禁止按文件继续")
+          } else if (!activePlan) { todoItems.push("1. [未开始] 用户提出需求 → 生成 Plan + HITL") }
+          else if (resolution.planName !== null) {
+            if (resolution.approvalStatus !== "TONGYI") todoItems.push("1. [HITL] 完成当前 Plan 审批")
+            if (reviewRows.length === 0) todoItems.push("2. [Step 0] 生成并追踪 Plan Review")
+            if (reviewRows.some(review => review.p0Count + review.p1Count > 0 && review.backflowRate === 0)) {
+              todoItems.push("3. [0.6.5] Review P0/P1 回流至 Plan")
             }
-            const allPlanDir = await readdirRecursive(plansDir)
-            const hasAddRoute = allPlanDir.some(f => f.includes("add-route"))
-            if (!hasAddRoute && reviewBackflowRate >= 70) { todoItems.push("2. [Step 0.5] 生成 add-route") }
-            const planKw = activePlan.replace(/-plan-v\d+\.md$/, "")
-            const sd = existsSync(specsDir) ? await readdir(specsDir) : []
-            if (!sd.some(d => d.toLowerCase().includes(planKw.toLowerCase())) && reviewBackflowRate >= 70) { todoItems.push("3. [Step 0] 生成 Specs 三元组") }
-            if (todoItems.length === 0) { todoItems.push("✅ ADD 就绪 — check_dps ≥ {{dpsPass}} 后可进入 Step 1") }
+            if (!activePlan.addRoutePath || !existsSync(activePlan.addRoutePath)) todoItems.push("4. [Step 0.5] 生成 add-route")
+            if (!activePlan.specPath || !activePlan.tasksPath || !activePlan.checklistPath) todoItems.push("5. [Step 0] 补齐 Specs 三元组")
+            if (activePlan.doneTasks < activePlan.totalTasks) todoItems.push(`6. [实施] 继续未完成 Task（${activePlan.doneTasks}/${activePlan.totalTasks}）`)
+            if (todoItems.length === 0) todoItems.push("✅ DB lifecycle 与文档链已就绪，可进入 Review/closure")
           }
           for (const item of todoItems) parts.push(item)
           parts.push(""); parts.push("快速指令: 说「执行 add-paradigm Step 0」进入文档先行流程")
@@ -243,39 +237,41 @@ export function registerContextTools(server: ToolRegistrar) {
   server.registerTool(
     "get_db_schema",
     {
-      description: "获取 Prisma 数据库 Schema 定义（MCP-1 上下文优先）。返回指定模型的结构、字段、关系。AI 助手在编写数据库查询代码时应调用此工具获取真实的 Schema 信息，避免凭记忆假设。",
-      inputSchema: z.object({ model: z.string().optional().describe("可选的模型名称（不区分大小写）。不指定则返回所有模型概况。指定则返回该模型的完整字段定义。") }),
+      description: "获取 topology-aware Prisma Schema。兼容单库多文件 schema folder 与 ADD_DATABASE_URL 分库；返回扫描文件、数据库边界、模型来源和诊断。",
+      inputSchema: z.object({
+        model: z.string().optional().describe("可选模型或枚举名称（不区分大小写）"),
+        view: z.enum(["business", "add", "all"]).optional().default("all").describe("Schema 视图；分库时 all 仅分组汇总，不表示可跨库 join"),
+      }),
     },
-    async (args: { model?: string }) => {
+    async (args: { model?: string; view?: SchemaView }) => {
       try {
-        const schemaPath = join(PROJECT_ROOT, "prisma", "schema.prisma")
-        const schema = await readFileSafe(schemaPath)
-        if (!schema) return errorResponse("未找到 prisma/schema.prisma 文件")
-        const modelName = args?.model?.toLowerCase()
-        if (modelName) {
-          const modelRegex = new RegExp(`model\\s+${modelName}\\s*\\{`, "i")
-          const match = schema.match(modelRegex)
-          if (match) {
-            const startIdx = match.index ?? 0; const braceIdx = schema.indexOf("{", startIdx)
-            if (braceIdx !== -1) { let depth = 1; let endIdx = braceIdx + 1; while (depth > 0 && endIdx < schema.length) { if (schema[endIdx] === "{") depth++; else if (schema[endIdx] === "}") depth--; endIdx++ }; return textResponse(`=== Model: ${args.model} ===\n\nmodel ${args.model} ${schema.slice(braceIdx, endIdx)}`) }
+        const topology = await loadPrismaSchemaTopology({
+          projectRoot: PROJECT_ROOT,
+          splitDatabase: Boolean(process.env.ADD_DATABASE_URL?.trim()),
+          view: args?.view ?? "all",
+        })
+        const requested = args?.model?.trim().toLowerCase()
+        if (requested) {
+          const declaration = [...topology.models, ...topology.enums]
+            .find(item => item.name.toLowerCase() === requested)
+          if (!declaration) {
+            return errorResponse(`未在 view=${topology.view} 找到模型或枚举: ${args.model}。扫描: ${topology.files.map(file => file.file).join(", ")}`)
           }
-          const enumMatch = schema.match(new RegExp(`enum\\s+${modelName}\\s*\\{`, "i"))
-          if (enumMatch) return textResponse(`=== Enum: ${args.model} ===\n\n可用的枚举值见不传参调用结果。`)
-          return errorResponse(`未找到模型或枚举: ${args.model}。可用模型见不传参调用结果。`)
-        }
-        const models: Array<{ name: string; fieldCount: number }> = []
-        const modelRegex = /model\s+(\w+)\s*\{/g; let m
-        while ((m = modelRegex.exec(schema)) !== null) {
-          const startIdx = m.index; const braceIdx = schema.indexOf("{", startIdx)
-          if (braceIdx !== -1) { let depth = 1; let endIdx = braceIdx + 1; while (depth > 0 && endIdx < schema.length) { if (schema[endIdx] === "{") depth++; else if (schema[endIdx] === "}") depth--; endIdx++ }; const body = schema.slice(braceIdx, endIdx); const fieldCount = body.split("\n").filter((l: string) => l.trim() && !l.trim().startsWith("//") && !l.trim().startsWith("@@")).length; models.push({ name: m[1], fieldCount }) }
+          return textResponse([
+            `=== ${declaration.kind === "model" ? "Model" : "Enum"}: ${declaration.name} ===`,
+            `mode: ${topology.mode}`,
+            `view: ${topology.view}`,
+            `boundary: ${declaration.boundary}`,
+            `source: ${relative(PROJECT_ROOT, declaration.sourcePath)}`,
+            "",
+            `${declaration.kind} ${declaration.name} ${declaration.body}`,
+          ].join("\n"))
         }
-        const enums: string[] = []; const enumRegex = /enum\s+(\w+)\s*\{/g
-        while ((m = enumRegex.exec(schema)) !== null) { enums.push(m[1]) }
-        const parts = ["=== Prisma Schema 概况 ===", "", `模型 (${models.length} 个):`]
-        for (const model of models) parts.push(`  ${model.name} (${model.fieldCount} 字段)`)
-        if (enums.length > 0) { parts.push(""); parts.push(`枚举 (${enums.length} 个): ${enums.join(", ")}`) }
-        parts.push("", '提示: 指定 model 参数获取完整字段定义，例如: get_db_schema({ model: "User" })')
-        return textResponse(parts.join("\n"))
+        return textResponse([
+          formatSchemaTopology(topology, PROJECT_ROOT),
+          "",
+          '提示: 指定 model/view 获取完整定义，例如 get_db_schema({ model: "PlanRecord", view: "add" })',
+        ].join("\n"))
       } catch (error) { return errorResponse(`获取 Schema 失败: ${error instanceof Error ? error.message : String(error)}`) }
     }
   )

package/templates/core/scripts/mcp-server/tools/contract.ts

@@ -7,6 +7,7 @@ import { readdirRecursive, PROJECT_ROOT, MAGIC_DIR } from "../shared/fs.js"
 import { prisma } from "../shared/prisma.js"
 import type { CollabContractRow, PlanRow } from "../shared/db-types.js"
 import { CollabContractRowSchema, PlanRowSchema, validatedDelegate } from "../shared/db-types.js"
+import { getRuntimeContext } from "../shared/env.js"
 
 const db = {
   get collabContract() { return validatedDelegate<CollabContractRow>(prisma.collabContract, CollabContractRowSchema, "CollabContract") },
@@ -67,6 +68,7 @@ function parseContractDoc(content: string): ParsedContract {
 }
 
 export function registerContractTools(server: ToolRegistrar) {
+  const runtimeContext = getRuntimeContext()
 
   // ===== contract_track =====
   server.registerTool("contract_track", {
@@ -124,13 +126,30 @@ export function registerContractTools(server: ToolRegistrar) {
           results.push(`⚠️ ${name}  缺少「总控 Plan:」声明，跳过`)
           continue
         }
-        const existing = await db.collabContract.findFirst({ where: { contractName: name } })
+        const masterPlan = await db.plan.findFirst({
+          where: {
+            projectKey: runtimeContext.projectKey,
+            adapterKey: runtimeContext.adapterKey,
+            planName: masterPlanName,
+          },
+        })
+        if (!masterPlan) {
+          results.push(`⚠️ ${name}  当前 RuntimeContextKey 下不存在 Master Plan: ${masterPlanName}`)
+          continue
+        }
+        const existing = await db.collabContract.findFirst({
+          where: { projectKey: runtimeContext.projectKey, contractName: name },
+        })
         const version = (existing?.version as number ?? 0) + 1
 
         const data = {
           contractName: name,
+          projectKey: runtimeContext.projectKey,
+          ownerAdapterKey: runtimeContext.adapterKey,
           contractPath: path,
           masterPlanName,
+          masterProjectKey: runtimeContext.projectKey,
+          masterAdapterKey: runtimeContext.adapterKey,
           participants: parsed.participants as never,
           abilityMatrix: parsed.abilityMatrix as never,
           stages: parsed.stages as never,
@@ -142,7 +161,7 @@ export function registerContractTools(server: ToolRegistrar) {
         }
 
         if (existing) {
-          await db.collabContract.update({ where: { contractName: name }, data })
+          await db.collabContract.update({ where: { id: existing.id }, data })
           results.push(`📄 ${name}  ✅ 已更新 (v${version})`)
         } else {
           await db.collabContract.create({ data })
@@ -152,8 +171,12 @@ export function registerContractTools(server: ToolRegistrar) {
         // 若 masterPlan 存在，标记 PlanRecord 角色
         if (masterPlanName) {
           await db.plan.updateMany({
-            where: { planName: masterPlanName },
-            data: { contractRole: "MASTER", contractName: name } as never,
+            where: {
+              projectKey: runtimeContext.projectKey,
+              adapterKey: runtimeContext.adapterKey,
+              planName: masterPlanName,
+            },
+            data: { contractRole: "MASTER", contractName: name },
           })
         }
       }
@@ -173,7 +196,9 @@ export function registerContractTools(server: ToolRegistrar) {
   }, async (args: Record<string, unknown>) => {
     try {
       const { contractName } = args as { contractName: string }
-      const contract = await db.collabContract.findFirst({ where: { contractName } })
+      const contract = await db.collabContract.findFirst({
+        where: { projectKey: runtimeContext.projectKey, contractName },
+      })
       if (!contract) {
         return textResponse(`📋 契约: 未跟踪\ncontractName: ${contractName}\n\n操作: contract_track({ contractName: "${contractName}" })`)
       }
@@ -182,11 +207,11 @@ export function registerContractTools(server: ToolRegistrar) {
       const boundaries = (contract.fileBoundaries as unknown[]) || []
       const parallelCount = stages.filter((s) => (s as Record<string, unknown>).parallelism === "parallel").length
       const serialCount = stages.filter((s) => (s as Record<string, unknown>).parallelism === "serial").length
-      const versionStr = String(contract.version as number ?? "?")
-      const statusStr = String(contract.status as string ?? "?")
-      const masterStr = String(contract.masterPlanName as string ?? "(未绑定)")
+      const versionStr = String(contract.version ?? "?")
+      const statusStr = String(contract.status ?? "?")
+      const masterStr = String(contract.masterPlanName ?? "(未绑定)")
       const depStr = contract.dependencyGraph ? "已声明" : "未声明"
-      const pathStr = String(contract.contractPath as string ?? "(无)")
+      const pathStr = String(contract.contractPath ?? "(无)")
       return textResponse(
         `📊 ${contractName}\n` +
         `版本:      v${versionStr} (${statusStr})\n` +

package/templates/core/scripts/mcp-server/tools/gateway/check_add_route_status.ts

@@ -17,6 +17,7 @@ import {
   MAGIC_DIR,
 } from "../../shared/fs.js";
 import { prisma } from "../../shared/prisma.js";
+import { getRuntimeContext } from "../../shared/env.js";
 
 function scanCheckboxes(content: string) {
   let t = 0,
@@ -61,6 +62,7 @@ function scanCheckboxes(content: string) {
 }
 
 export function registerCheckAddRouteStatus(server: ToolRegistrar) {
+  const runtimeContext = getRuntimeContext();
   server.registerTool(
     "check_add_route_status",
     {
@@ -85,10 +87,13 @@ export function registerCheckAddRouteStatus(server: ToolRegistrar) {
             prisma.auditLog as Record<string, (...a: unknown[]) => unknown>
           ).findMany({
             where: {
-              OR: [
-                { targetId: { contains: "add-route", mode: "insensitive" } },
+              projectKey: runtimeContext.projectKey,
+              producerAdapterKey: runtimeContext.adapterKey,
+              // 按当前 Plan 精准定位：targetId 同时含 planKeyword 与 add-route（与文件匹配语义一致）
+              AND: [
+                { targetId: { startsWith: `${MAGIC_DIR}/` } },
                 { targetId: { contains: planKeyword, mode: "insensitive" } },
-                { reason: { contains: "add-route", mode: "insensitive" } },
+                { targetId: { contains: "add-route", mode: "insensitive" } },
               ],
             },
             orderBy: { createdAt: "desc" },
@@ -113,6 +118,48 @@ export function registerCheckAddRouteStatus(server: ToolRegistrar) {
         } catch {
           /* empty */
         }
+        // 补查 DevOperation 表（record_dev_operation 写入通道；R10 修复，2026-08-12 用户拍板不另立 Plan，本 Plan 内闭环）
+        try {
+          const devLogs = await (
+            prisma.devOperation as Record<string, (...a: unknown[]) => unknown>
+          ).findMany({
+            where: {
+              projectKey: runtimeContext.projectKey,
+              producerAdapterKey: runtimeContext.adapterKey,
+              // 按当前 Plan 精准定位（AND：planKeyword + add-route），命中集天然为当前 Plan 的 add-route 记录
+              AND: [
+                { targetId: { startsWith: `${MAGIC_DIR}/` } },
+                { targetId: { contains: planKeyword, mode: "insensitive" } },
+                { targetId: { contains: "add-route", mode: "insensitive" } },
+              ],
+            },
+            orderBy: { createdAt: "desc" },
+            take: 100,
+          }) as Array<{
+            targetId?: string;
+            reason?: string;
+            action: string;
+            createdAt: Date;
+          }>;
+          const pl = planKeyword.toLowerCase();
+          for (const l of devLogs) {
+            const ti = (l.targetId || "").toLowerCase();
+            const r = (l.reason || "").toLowerCase();
+            if (
+              (ti.includes("add-route") && ti.includes(pl)) ||
+              (r.includes("add-route") && r.includes(pl))
+            ) {
+              auditHasRecord = true;
+              auditRecords.push({
+                action: l.action,
+                targetId: l.targetId || "unknown",
+                createdAt: l.createdAt,
+              });
+            }
+          }
+        } catch {
+          /* empty */
+        }
         let fileExists = false;
         const matchedFiles: string[] = [];
         try {