add-coder 0.3.26 → 0.3.28

package/templates/core/scripts/mcp-server/shared/schema-topology.ts

@@ -0,0 +1,159 @@
+import { readdir, readFile } from "fs/promises"
+import { basename, join, relative } from "path"
+
+export type SchemaView = "business" | "add" | "all"
+export type SchemaTopologyMode = "single" | "split"
+export type SchemaBoundary = "shared" | "business" | "add"
+
+export interface PrismaDeclaration {
+  kind: "model" | "enum"
+  name: string
+  sourcePath: string
+  sourceFile: string
+  boundary: SchemaBoundary
+  body: string
+  fieldCount: number
+}
+
+export interface PrismaSchemaFile {
+  path: string
+  file: string
+  boundary: SchemaBoundary
+  declarations: PrismaDeclaration[]
+}
+
+export interface PrismaSchemaTopology {
+  mode: SchemaTopologyMode
+  view: SchemaView
+  schemaRoot: string
+  files: PrismaSchemaFile[]
+  models: PrismaDeclaration[]
+  enums: PrismaDeclaration[]
+}
+
+function extractBlock(source: string, braceIndex: number): string {
+  let depth = 1
+  let cursor = braceIndex + 1
+  while (depth > 0 && cursor < source.length) {
+    if (source[cursor] === "{") depth += 1
+    if (source[cursor] === "}") depth -= 1
+    cursor += 1
+  }
+  if (depth !== 0) throw new Error("Prisma declaration 花括号未闭合")
+  return source.slice(braceIndex, cursor)
+}
+
+export function parsePrismaDeclarations(
+  source: string,
+  sourcePath: string,
+  boundary: SchemaBoundary,
+): PrismaDeclaration[] {
+  const declarations: PrismaDeclaration[] = []
+  const declarationRegex = /^\s*(model|enum)\s+(\w+)\s*\{/gm
+  let match: RegExpExecArray | null
+  while ((match = declarationRegex.exec(source)) !== null) {
+    const braceIndex = source.indexOf("{", match.index)
+    const body = extractBlock(source, braceIndex)
+    const kind = match[1] as "model" | "enum"
+    declarations.push({
+      kind,
+      name: match[2],
+      sourcePath,
+      sourceFile: basename(sourcePath),
+      boundary,
+      body,
+      fieldCount: kind === "model"
+        ? body.split("\n").filter(line => {
+            const trimmed = line.trim()
+            return trimmed.length > 0 && trimmed !== "{" && trimmed !== "}" && !trimmed.startsWith("//") && !trimmed.startsWith("@@")
+          }).length
+        : 0,
+    })
+  }
+  return declarations
+}
+
+function boundaryFor(file: string, mode: SchemaTopologyMode): SchemaBoundary {
+  if (mode === "single") return "shared"
+  return file === "add.prisma" ? "add" : "business"
+}
+
+function includedInView(file: string, view: SchemaView): boolean {
+  if (view === "all") return true
+  return view === "add" ? file === "add.prisma" : file !== "add.prisma"
+}
+
+export async function loadPrismaSchemaTopology(input: {
+  projectRoot: string
+  splitDatabase: boolean
+  view?: SchemaView
+}): Promise<PrismaSchemaTopology> {
+  const schemaRoot = join(input.projectRoot, "prisma")
+  const mode: SchemaTopologyMode = input.splitDatabase ? "split" : "single"
+  const view = input.view ?? "all"
+  let names: string[]
+  try {
+    names = (await readdir(schemaRoot)).filter(file => file.endsWith(".prisma")).sort()
+  } catch {
+    throw new Error(`未找到 Prisma schema 目录: ${schemaRoot}`)
+  }
+  if (names.length === 0) throw new Error(`Prisma schema 目录中没有 *.prisma: ${schemaRoot}`)
+
+  const selected = names.filter(file => includedInView(file, view))
+  if (selected.length === 0) {
+    throw new Error(`Schema view=${view} 没有可扫描文件；mode=${mode}；全部文件=${names.join(", ")}`)
+  }
+  const files: PrismaSchemaFile[] = []
+  for (const file of selected) {
+    const path = join(schemaRoot, file)
+    const boundary = boundaryFor(file, mode)
+    const source = await readFile(path, "utf8")
+    files.push({ path, file, boundary, declarations: parsePrismaDeclarations(source, path, boundary) })
+  }
+  const declarations = files.flatMap(file => file.declarations)
+  const models = declarations.filter(item => item.kind === "model")
+  const enums = declarations.filter(item => item.kind === "enum")
+  if (models.length === 0) {
+    throw new Error(
+      `Schema 诊断: 检测到 ${files.length} 个 Prisma 文件但 view=${view} 解析为 0 个模型；` +
+      `mode=${mode}；扫描=${files.map(file => relative(input.projectRoot, file.path)).join(", ")}`,
+    )
+  }
+
+  const byName = new Map<string, PrismaDeclaration[]>()
+  for (const model of models) {
+    const key = model.name.toLowerCase()
+    byName.set(key, [...(byName.get(key) ?? []), model])
+  }
+  const conflicts = [...byName.entries()].filter(([, entries]) => entries.length > 1)
+  if (conflicts.length > 0) {
+    const details = conflicts.map(([name, entries]) =>
+      `${name}: ${entries.map(entry => `${relative(input.projectRoot, entry.sourcePath)}[${entry.boundary}]`).join(", ")}`,
+    )
+    throw new Error(`Schema 模型冲突（fail closed）: ${details.join("; ")}`)
+  }
+
+  return { mode, view, schemaRoot, files, models, enums }
+}
+
+export function formatSchemaTopology(topology: PrismaSchemaTopology, projectRoot: string): string {
+  const lines = [
+    "=== Prisma Schema 拓扑 ===",
+    `mode: ${topology.mode}`,
+    `view: ${topology.view}`,
+    `databaseBoundaries: ${topology.mode === "single" ? "shared (business + ADD 同库)" : "business, add (分库；all 仅汇总展示，不代表可跨库 join)"}`,
+    `scannedFiles: ${topology.files.length}`,
+  ]
+  for (const file of topology.files) {
+    lines.push(`  - ${relative(projectRoot, file.path)} [${file.boundary}] models=${file.declarations.filter(item => item.kind === "model").length}`)
+  }
+  lines.push("", `模型 (${topology.models.length} 个):`)
+  for (const model of topology.models) {
+    lines.push(`  ${model.name} (${model.fieldCount} 字段) — ${relative(projectRoot, model.sourcePath)} [${model.boundary}]`)
+  }
+  if (topology.enums.length > 0) {
+    lines.push("", `枚举 (${topology.enums.length} 个):`)
+    for (const item of topology.enums) lines.push(`  ${item.name} — ${relative(projectRoot, item.sourcePath)} [${item.boundary}]`)
+  }
+  return lines.join("\n")
+}

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

@@ -1,12 +1,14 @@
 import * as z from "zod/v4"
+import { createHash } from "crypto"
 import type { ToolRegistrar } from "./registrar.js"
 import { textResponse, errorResponse } from "../shared/response.js"
 import { prisma } from "../shared/prisma.js"
-import { PROJECT_ID, PROJECT_ROOT } from "../shared/env.js"
+import { PROJECT_ID, PROJECT_ROOT, getRuntimeContext } from "../shared/env.js"
 import type { AddUserRow, DevOperationRow } from "../shared/db-types.js"
 import { AddUserRowSchema, DevOperationRowSchema, validatedDelegate } from "../shared/db-types.js"
 
 export function registerAuditTools(server: ToolRegistrar) {
+  const runtimeContext = getRuntimeContext()
 
   // 无类型边界单点（zod 托管）：动态 client → 运行期校验的泛型委托
   const devDb = validatedDelegate<DevOperationRow>(prisma.devOperation, DevOperationRowSchema, "DevOperation")
@@ -30,7 +32,10 @@ export function registerAuditTools(server: ToolRegistrar) {
   }, async (args: Record<string, string | number | undefined>, _ctx: unknown) => {
     try {
       const { targetType, action, targetId, planKeyword, keyword, sinceMinutes, limit = 20 } = args
-      const where: Record<string, unknown> = {}
+      const where: Record<string, unknown> = {
+        projectKey: runtimeContext.projectKey,
+        producerAdapterKey: runtimeContext.adapterKey,
+      }
       if (sinceMinutes !== undefined) where.createdAt = { gte: new Date(Date.now() - Number(sinceMinutes) * 60 * 1000) }
       if (targetType) where.targetType = s(targetType); if (action) where.action = s(action); if (targetId) where.targetId = s(targetId); if (planKeyword) where.planKeyword = s(planKeyword)
       const kw = s(keyword)
@@ -44,6 +49,7 @@ export function registerAuditTools(server: ToolRegistrar) {
       const lines = [`=== 开发操作审计日志 (条件: ${fl.length > 0 ? fl.join(", ") : "无过滤条件（最近全部）"}) ===`, `服务项目: ${PROJECT_ID} (${PROJECT_ROOT})`, `共 ${logs.length} 条记录`]
       for (let i = 0; i < logs.length; i++) {
         const l = logs[i]; lines.push(`[${i+1}] ${l.createdAt.toISOString()}`, `    action: ${l.action} | targetType: ${l.targetType} | targetId: ${l.targetId || "(无)"}`)
+        lines.push(`    beforeState: ${JSON.stringify(l.beforeState)}`, `    afterState: ${JSON.stringify(l.afterState)}`)
         if (l.reason) lines.push(`    reason: ${l.reason}`); if (l.planKeyword) lines.push(`    planKeyword: ${l.planKeyword}`)
       }
       if (planKeyword) { lines.push("=== Plan 分组 ===", `planKeyword=${planKeyword} 的操作链:`); for (const l of logs) lines.push(`  ${l.createdAt.toISOString().slice(11,19)} ${l.action}`) }
@@ -60,22 +66,58 @@ export function registerAuditTools(server: ToolRegistrar) {
       targetType: z.string().describe("目标类型: 'API_ROUTE', 'COMPONENT', 'SCHEMA', 'RULE', 'DOC', 'PLAN', 'SPEC', 'SKILL', 'AGENT' 等"),
       targetId: z.string().optional().describe("目标标识（相对路径）"),
       planKeyword: z.string().optional().describe("关联 Plan 的关键词"),
-      beforeState: z.string().describe("操作前的状态（JSON 字符串）。必填，记录变更前的文件内容或配置状态，用于审计回溯。"),
-      afterState: z.string().describe("操作后的状态（JSON 字符串）。必填，记录变更后的文件内容或配置状态，用于审计回溯。"),
+      beforeState: z.string().describe("操作前的状态（非 null JSON 对象或数组字符串）。必填，用于审计回溯。"),
+      afterState: z.string().describe("操作后的状态（非 null JSON 对象或数组字符串）。必填，用于审计回溯。"),
       reason: z.string().optional().describe("操作原因"),
+      operationKey: z.string().optional().describe("调用方提供的幂等键；未提供时按本次结构化操作内容计算"),
     }),
   }, async (args: Record<string, string | number | undefined>, _ctx: unknown) => {
     try {
-      const { action, targetType, targetId, planKeyword, beforeState, afterState, reason } = args
+      const { action, targetType, targetId, planKeyword, beforeState, afterState, reason, operationKey } = args
       const tId = s(targetId)
       const pathWarnings: string[] = []
       if (tId && (tId.startsWith("/") || /^[A-Z]:\\/.test(tId))) pathWarnings.push(`⚠️ targetId 使用了绝对路径: "${tId}"。请使用相对路径。`)
+      if (!s(beforeState).trim() || !s(afterState).trim()) return errorResponse("beforeState/afterState 必须提供非空 JSON 字符串。")
       let parsedBefore: unknown, parsedAfter: unknown
       try { if (beforeState) parsedBefore = JSON.parse(s(beforeState)); if (afterState) parsedAfter = JSON.parse(s(afterState)) } catch { return errorResponse("beforeState/afterState 必须是有效的 JSON 字符串。") }
+      const isStructuredState = (value: unknown): value is Record<string, unknown> | unknown[] => typeof value === "object" && value !== null
+      if (!isStructuredState(parsedBefore) || !isStructuredState(parsedAfter)) return errorResponse("beforeState/afterState 必须是非 null 的 JSON 对象或数组。")
       let systemUser = await userDb.findUnique({ where: { username: "ai-assistant" }, select: { id: true } })
       if (!systemUser) systemUser = await userDb.create({ data: { id: "ai-assistant", username: "ai-assistant", email: "ai-assistant@internal" } })
-      const log = await devDb.create({ data: { userId: systemUser.id, planKeyword: s(planKeyword) || "unknown", action: s(action), targetType: s(targetType), targetId: tId || "unknown", beforeState: parsedBefore ?? null, afterState: parsedAfter ?? null, reason: s(reason) || null } })
-      const lines = [`✅ 开发操作已记录`, `  落库项目: ${PROJECT_ID} (${PROJECT_ROOT})`, `  ID: ${log.id}`, `  action: ${s(action)}`, `  targetType: ${s(targetType)}`, `  targetId: ${tId || "unknown"}`, `  planKeyword: ${s(planKeyword) || "unknown"}`, `  createdAt: ${log.createdAt.toISOString()}`]
+      const operationPayload = {
+        projectKey: runtimeContext.projectKey,
+        producerAdapterKey: runtimeContext.adapterKey,
+        action: s(action),
+        targetType: s(targetType),
+        targetId: tId || "unknown",
+        planKeyword: s(planKeyword) || "unknown",
+        beforeState: parsedBefore,
+        afterState: parsedAfter,
+        reason: s(reason) || null,
+      }
+      const resolvedOperationKey = s(operationKey).trim() || createHash("sha256")
+        .update(JSON.stringify(operationPayload))
+        .digest("hex")
+      const scopedData: Partial<DevOperationRow> = {
+        ...operationPayload,
+        userId: systemUser.id,
+        contextId: runtimeContext.contextId,
+        toolName: "record_dev_operation",
+        operationKey: resolvedOperationKey,
+      }
+      const log = await devDb.upsert({
+        where: {
+          projectKey_producerAdapterKey_toolName_operationKey: {
+            projectKey: runtimeContext.projectKey,
+            producerAdapterKey: runtimeContext.adapterKey,
+            toolName: "record_dev_operation",
+            operationKey: resolvedOperationKey,
+          },
+        },
+        create: scopedData,
+        update: {},
+      })
+      const lines = [`✅ 开发操作已记录`, `  落库项目: ${PROJECT_ID} (${PROJECT_ROOT})`, `  ID: ${log.id}`, `  action: ${s(action)}`, `  targetType: ${s(targetType)}`, `  targetId: ${tId || "unknown"}`, `  planKeyword: ${s(planKeyword) || "unknown"}`, `  beforeState: ${JSON.stringify(log.beforeState)}`, `  afterState: ${JSON.stringify(log.afterState)}`, `  createdAt: ${log.createdAt.toISOString()}`]
       if (pathWarnings.length > 0) { lines.push(""); lines.push(...pathWarnings) }
       lines.push("", `📋 落库回查（必须执行）:`, tId ? `  query_audit_logs({ targetId: "${tId}" }) — 确认本条记录已写入` : "")
       return textResponse(lines.join("\n"))

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)}`) }
     }
   )