coding-agent-harness 1.0.4 → 1.0.6

package/scripts/lib/check-task-contracts.mjs

@@ -1,47 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import {
-  lessonCandidatesFile,
-  readFileSafe,
-  toPosix,
-  visualMapFile,
-} from "./core-shared.mjs";
-import {
-  listTaskPlanPaths,
-  parseTaskBudget,
-  parseTaskContractInfo,
-} from "./task-scanner.mjs";
-
-export function validatePlanContracts(target, { strict = true } = {}) {
-  const failures = [];
-  const warnings = [];
-  const report = (message) => {
-    if (strict) failures.push(message);
-    else warnings.push(`adoption-needed: ${message}`);
-  };
-  for (const taskPlanPath of listTaskPlanPaths(target)) {
-    const taskDir = path.dirname(taskPlanPath);
-    const relativeDir = toPosix(path.relative(target.projectRoot, taskDir));
-    const taskPlanContent = readFileSafe(taskPlanPath);
-    const budget = parseTaskBudget(taskPlanContent);
-    const taskContract = parseTaskContractInfo(taskPlanContent);
-    if (!taskContract.generated) {
-      warnings.push(`adoption-needed: ${relativeDir} missing Task Contract: harness-task/v1 marker`);
-    }
-    for (const fileName of requiredTaskFilesForBudget(budget)) {
-      if (!fs.existsSync(path.join(taskDir, fileName))) {
-        if (taskContract.generated) failures.push(`${relativeDir} missing ${fileName}`);
-        else report(`${relativeDir} missing ${fileName}`);
-      }
-    }
-  }
-  return { failures, warnings };
-}
-
-function requiredTaskFilesForBudget(budget) {
-  const simpleFiles = ["brief.md", "task_plan.md", visualMapFile, "progress.md"];
-  if (budget === "simple") return simpleFiles;
-  const standardFiles = [...simpleFiles, "execution_strategy.md", "findings.md", lessonCandidatesFile, "review.md"];
-  if (budget === "complex") return [...standardFiles, "references/INDEX.md", "artifacts/INDEX.md"];
-  return standardFiles;
-}

package/scripts/lib/core-shared.mjs

@@ -1,196 +0,0 @@
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-export const repoRoot = path.resolve(__dirname, "../..");
-export const legacyChecker = path.join(repoRoot, "scripts/check-harness.mjs");
-export const visualMapFile = "visual_map.md";
-export const legacyVisualRoadmapFile = "visual_roadmap.md";
-export const lessonCandidatesFile = "lesson_candidates.md";
-export const longRunningTaskContractFile = "long-running-task-contract.md";
-export const taskContractMarker = "Task Contract: harness-task/v1";
-export const builtinPresetRoot = path.join(repoRoot, "presets");
-export function userPresetRootForHome(home = "") {
-  return path.join(path.resolve(home || os.homedir()), ".coding-agent-harness/presets");
-}
-export const userPresetRoot = userPresetRootForHome();
-
-
-export const supportedLocales = new Set(["zh-CN", "en-US"]);
-export const allowedReviewDispositions = new Set([
-  "open",
-  "mitigated",
-  "closed",
-  "deferred",
-  "accepted-risk",
-  "not-reproducible",
-  "out-of-scope",
-]);
-export const allowedTaskStates = new Set(["not_started", "planned", "in_progress", "review", "blocked", "done"]);
-export const allowedTaskBudgets = new Set(["simple", "standard", "complex"]);
-export const allowedPhaseStates = new Set(["planned", "in_progress", "review", "blocked", "done", "skipped"]);
-export const allowedEvidenceStatus = new Set(["missing", "partial", "present", "waived"]);
-
-export function normalizeTarget(input = ".") {
-  const target = path.resolve(input);
-  const isDocsRoot =
-    path.basename(target) === "docs" &&
-    (fs.existsSync(path.join(target, "09-PLANNING")) || fs.existsSync(path.join(target, "11-REFERENCE")));
-  return {
-    input: target,
-    projectRoot: isDocsRoot ? path.dirname(target) : target,
-    docsRoot: isDocsRoot ? target : path.join(target, "docs"),
-    docsOnly: isDocsRoot,
-  };
-}
-
-export function projectPresetRoot(targetInput = ".") {
-  return path.join(normalizeTarget(targetInput).projectRoot, ".coding-agent-harness/presets");
-}
-
-export function toPosix(value) {
-  return value.split(path.sep).join("/");
-}
-
-export function exists(target, relativePath) {
-  return fs.existsSync(path.join(target.projectRoot, relativePath));
-}
-
-export function existsInDocs(target, relativePath) {
-  return fs.existsSync(path.join(target.docsRoot, relativePath));
-}
-
-export function readFileSafe(filePath) {
-  try {
-    return fs.readFileSync(filePath, "utf8");
-  } catch {
-    return "";
-  }
-}
-
-export function readBundledTemplate(source) {
-  const sourcePath = path.join(repoRoot, source);
-  if (!fs.existsSync(sourcePath)) throw new Error(`Bundled template missing: ${source}`);
-  const content = fs.readFileSync(sourcePath, "utf8");
-  if (!content.trim()) throw new Error(`Bundled template is empty: ${source}`);
-  return content;
-}
-
-export function walkFiles(root) {
-  const results = [];
-  if (!fs.existsSync(root)) return results;
-  function walk(dir) {
-    for (const entry of fs.readdirSync(dir)) {
-      const full = path.join(dir, entry);
-      const stat = fs.statSync(full);
-      if (stat.isDirectory()) {
-        if ([".git", "node_modules", "tmp"].includes(entry)) continue;
-        walk(full);
-      } else {
-        results.push(full);
-      }
-    }
-  }
-  walk(root);
-  return results;
-}
-
-export function normalizeLocale(locale = "en-US") {
-  return supportedLocales.has(locale) ? locale : "en-US";
-}
-
-export function inferProjectLocale(target, fallback = "en-US") {
-  const candidates = [
-    path.join(target.projectRoot, "AGENTS.md"),
-    path.join(target.projectRoot, "CLAUDE.md"),
-    path.join(target.docsRoot, "AGENTS.md"),
-    path.join(target.docsRoot, "Harness-Ledger.md"),
-  ];
-  for (const file of candidates) {
-    const content = readFileSafe(file);
-    if (/\p{Script=Han}/u.test(content)) return "zh-CN";
-  }
-  return normalizeLocale(fallback);
-}
-
-export function slug(value) {
-  return String(value || "item")
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, "-")
-    .replace(/^-+|-+$/g, "")
-    .slice(0, 80) || "item";
-}
-
-export function prefixedPath(target, filePath) {
-  return `TARGET:${toPosix(path.relative(target.projectRoot, filePath))}`;
-}
-
-export function sanitizeText(value) {
-  return String(value ?? "")
-    .replace(/file:\/\/\/[^\s)"'`<>\]]+/g, "LOCAL_FILE_URL_REDACTED")
-    .replaceAll("file://", "LOCAL_FILE_URL_REDACTED")
-    .replace(/\/Users\/[^/\s)"'`<>\]]+(?:\/[^\s)"'`<>\]]*)*/g, "LOCAL_PATH_REDACTED")
-    .replace(/\/Volumes\/[^\s)"'`<>\]]+(?:\/[^\s)"'`<>\]]*)*/g, "LOCAL_PATH_REDACTED")
-    .replace(/\/(?:private\/)?tmp\/[^\s)"'`<>\]]+(?:\/[^\s)"'`<>\]]*)*/g, "LOCAL_PATH_REDACTED")
-    .replace(/\/var\/folders\/[^\s)"'`<>\]]+(?:\/[^\s)"'`<>\]]*)*/g, "LOCAL_PATH_REDACTED")
-    .replace(/\/home\/[^/\s)"'`<>\]]+(?:\/[^\s)"'`<>\]]*)*/g, "LOCAL_PATH_REDACTED")
-    .replace(/[A-Za-z]:\\[^\s)"'`<>\]]+(?:\\[^\s)"'`<>\]]*)*/g, "LOCAL_PATH_REDACTED");
-}
-
-export function sanitizeDeep(value) {
-  if (typeof value === "string") return sanitizeText(value);
-  if (Array.isArray(value)) return value.map(sanitizeDeep);
-  if (value && typeof value === "object") {
-    return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, sanitizeDeep(entry)]));
-  }
-  return value;
-}
-
-export function titleFromMarkdown(content, fallback) {
-  const match = content.match(/^#\s+(.+)$/m);
-  return match ? match[1].trim() : fallback;
-}
-
-export function localizedTemplateSource(source, locale) {
-  const localeSource = normalizeLocale(locale) === "zh-CN" ? source.replace(/^templates\//, "templates-zh-CN/") : source;
-  return fs.existsSync(path.join(repoRoot, localeSource)) ? localeSource : source;
-}
-
-export function todayDate() {
-  return localDate();
-}
-
-export function localDate() {
-  const now = new Date();
-  const year = now.getFullYear();
-  const month = String(now.getMonth() + 1).padStart(2, "0");
-  const day = String(now.getDate()).padStart(2, "0");
-  return `${year}-${month}-${day}`;
-}
-
-export const datePrefix = /^\d{4}-\d{2}-\d{2}-/;
-
-export function nowTimestamp() {
-  return new Date().toISOString().replace("T", " ").slice(0, 16);
-}
-
-export function normalizeTaskId(value) {
-  return slug(value || "task");
-}
-
-export function renderTaskTemplate(content, { taskId, title, locale, budget = "standard" }) {
-  const date = todayDate();
-  return String(content)
-    .replaceAll("{{TASK_ID}}", taskId)
-    .replaceAll("{{TASK_TITLE}}", title)
-    .replaceAll("{{DATE}}", date)
-    .replaceAll("{{LOCALE}}", normalizeLocale(locale))
-    .replaceAll("{{TASK_BUDGET}}", budget)
-    .replaceAll("[simple / standard / complex]", budget)
-    .replaceAll("[simple / standard / long-running / module-parallel]", budget)
-    .replaceAll("[simple / complex]", budget)
-    .replaceAll("[Task Name]", title)
-    .replaceAll("[任务名称]", title);
-}

package/scripts/lib/dashboard-data.mjs

@@ -1,412 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import {
-  repoRoot,
-  normalizeTarget,
-  readFileSafe,
-  sanitizeText,
-  sanitizeDeep,
-  slug,
-  titleFromMarkdown,
-  prefixedPath,
-  toPosix,
-  walkFiles,
-  visualMapFile,
-  legacyVisualRoadmapFile,
-  lessonCandidatesFile,
-  longRunningTaskContractFile,
-} from "./core-shared.mjs";
-import {
-  parseAllMarkdownTables,
-  getCell,
-  splitDependencies,
-} from "./markdown-utils.mjs";
-import { readCapabilityRegistry } from "./capability-registry.mjs";
-import { buildStatus } from "./check-profiles.mjs";
-import {
-  listTaskPlanPaths,
-  parseTaskState,
-  isActiveTaskState,
-} from "./task-scanner.mjs";
-import { writeDashboardDirectory, writeDashboardFile } from "./dashboard-writer.mjs";
-
-export function collectMarkdownDocuments(target) {
-  const docs = collectDashboardDocumentPaths(target);
-  return docs.map((file, index) => {
-    const content = sanitizeText(readFileSafe(file));
-    const source = prefixedPath(target, file);
-    return {
-      id: `doc-${String(index + 1).padStart(4, "0")}-${slug(path.basename(file, ".md"))}`,
-      path: source,
-      title: titleFromMarkdown(content, path.basename(file)),
-      type: documentKind(source),
-      content,
-    };
-  });
-}
-
-function collectDashboardDocumentPaths(target) {
-  const selected = new Set();
-  const addDocsPath = (relativePath) => {
-    const file = path.join(target.docsRoot, relativePath);
-    if (fs.existsSync(file)) selected.add(file);
-  };
-  for (const relativePath of [
-    "Harness-Ledger.md",
-    "09-PLANNING/Module-Registry.md",
-    "05-TEST-QA/Regression-SSoT.md",
-    "05-TEST-QA/Cadence-Ledger.md",
-    "10-WALKTHROUGH/Closeout-SSoT.md",
-  ]) {
-    addDocsPath(relativePath);
-  }
-  for (const file of walkFiles(path.join(target.docsRoot, "10-WALKTHROUGH"))) {
-    if (!file.endsWith(".md")) continue;
-    if (file.includes(`${path.sep}_archive${path.sep}`)) continue;
-    if (path.basename(file).startsWith("_")) continue;
-    selected.add(file);
-  }
-  for (const taskPlanPath of listTaskPlanPaths(target)) {
-    const taskDir = path.dirname(taskPlanPath);
-    const progress = readFileSafe(path.join(taskDir, "progress.md"));
-    const state = parseTaskState(progress);
-    const active = isActiveTaskState(state);
-    const documentNames = active
-      ? ["brief.md", "task_plan.md", "execution_strategy.md", visualMapFile, legacyVisualRoadmapFile, lessonCandidatesFile, longRunningTaskContractFile, "progress.md", "review.md", "findings.md"]
-      : ["brief.md", "task_plan.md", "execution_strategy.md", visualMapFile, legacyVisualRoadmapFile, lessonCandidatesFile, longRunningTaskContractFile, "progress.md", "review.md", "findings.md"];
-    for (const fileName of documentNames) {
-      const file = path.join(taskDir, fileName);
-      if (fs.existsSync(file)) selected.add(file);
-    }
-    for (const indexFile of ["references/INDEX.md", "artifacts/INDEX.md"]) {
-      const file = path.join(taskDir, indexFile);
-      if (fs.existsSync(file)) selected.add(file);
-    }
-  }
-  for (const file of walkFiles(path.join(target.docsRoot, "09-PLANNING/MODULES"))) {
-    if (file.endsWith("module_plan.md")) selected.add(file);
-    if (/09-PLANNING[\\/]+MODULES[\\/]+[^\\/]+[\\/]brief\.md$/.test(file)) selected.add(file);
-  }
-  for (const file of walkFiles(path.join(target.docsRoot, "01-GOVERNANCE/lessons"))) {
-    if (file.endsWith(".md")) selected.add(file);
-  }
-  return [...selected]
-    .filter((file) => !file.includes(`${path.sep}_archive${path.sep}`))
-    .filter((file) => !file.includes(`${path.sep}_task-template${path.sep}`))
-    .filter((file) => !file.includes(`${path.sep}_optional-structures${path.sep}`))
-    .sort();
-}
-
-function documentKind(source) {
-  const lower = source.toLowerCase();
-  if (lower.includes("harness-ledger.md")) return "harness-ledger";
-  if (lower.includes("module-registry.md")) return "module-registry";
-  if (lower.includes("regression-ssot.md")) return "regression-ssot";
-  if (lower.includes("cadence-ledger.md")) return "cadence-ledger";
-  if (/\/01-governance\/lessons\/[^/]+\.md$/i.test(lower)) return "lesson-detail";
-  if (lower.endsWith("/progress.md")) return "task-progress";
-  if (lower.endsWith("/brief.md")) return "task-brief";
-  if (lower.endsWith("/review.md")) return "task-review";
-  if (lower.endsWith("/lesson_candidates.md")) return "lesson-candidates";
-  if (lower.endsWith("/long-running-task-contract.md")) return "long-running-contract";
-  if (lower.endsWith("/references/index.md")) return "task-references";
-  if (lower.endsWith("/artifacts/index.md")) return "task-artifacts";
-  if (lower.endsWith("/execution_strategy.md")) return "execution-strategy";
-  if (lower.endsWith("/visual_map.md")) return "visual-map";
-  if (lower.endsWith("/visual_roadmap.md")) return "legacy-visual-roadmap";
-  if (lower.endsWith("/module_plan.md")) return "module-plan";
-  return "markdown-table";
-}
-
-export function collectTables(documents) {
-  return {
-    tables: documents.flatMap((document) => parseAllMarkdownTables(document.content, document.path, documentKind(document.path))),
-  };
-}
-
-export function collectGraph(status, tables = { tables: [] }) {
-  const nodes = [];
-  const edges = [];
-  const seenNodes = new Map();
-  const addNode = (node) => {
-    const existing = seenNodes.get(node.id);
-    if (existing) {
-      Object.assign(existing, node);
-      return;
-    }
-    seenNodes.set(node.id, node);
-    nodes.push(node);
-  };
-  const addEdge = (edge) => {
-    if (!edge.from || !edge.to || edge.from === edge.to) return;
-    edges.push(edge);
-  };
-  for (const task of status.tasks) {
-    addNode({ id: `task:${task.id}`, type: "task", label: task.title, state: task.state, completion: task.completion });
-    for (const phase of task.phases || []) {
-      const phaseId = `phase:${task.id}:${phase.id}`;
-      addNode({ id: phaseId, type: "phase", label: phase.id, state: phase.state, completion: phase.completion, taskId: task.id });
-      addEdge({ from: `task:${task.id}`, to: phaseId, type: "contains" });
-      for (const dependency of phase.dependsOn || []) {
-        addEdge({ from: `phase:${task.id}:${dependency}`, to: phaseId, type: "depends_on" });
-      }
-    }
-    for (const handoff of task.handoffs || []) {
-      const handoffId = `handoff:${handoff.id}`;
-      addNode({ id: handoffId, type: "handoff", label: handoff.summary, state: handoff.state });
-      addEdge({ from: `task:${task.id}`, to: handoffId, type: "handoff" });
-    }
-  }
-  for (const table of tables.tables || []) {
-    if (table.kind === "module-registry") {
-      for (const row of table.rows) {
-        const key = getCell(row.cells, ["Key", "Module", "模块 Key", "模块"]) || "";
-        if (!key) continue;
-        const moduleId = `module:${key}`;
-        const status = getCell(row.cells, ["Status", "状态"], "unknown");
-        const currentStep = getCell(row.cells, ["Current Step", "当前步骤"], "");
-        addNode({ id: moduleId, type: "module", label: getCell(row.cells, ["Name", "Module", "模块名称", "模块"], key), state: status, currentStep });
-        if (currentStep) {
-          const stepId = `step:${currentStep}`;
-          if (!seenNodes.has(stepId)) addNode({ id: stepId, type: "step", label: currentStep, state: status, module: key });
-          addEdge({ from: moduleId, to: stepId, type: "current_step" });
-        }
-      }
-    }
-    if (table.kind === "module-plan") {
-      const moduleMatch = table.source.match(/MODULES\/([^/]+)\/module_plan\.md$/);
-      const moduleKey = moduleMatch ? moduleMatch[1] : slug(table.source);
-      const moduleId = `module:${moduleKey}`;
-      addNode({ id: moduleId, type: "module", label: moduleKey, state: "planned" });
-      for (const row of table.rows) {
-        const step = getCell(row.cells, ["Step ID", "步骤 ID"]);
-        if (!step) continue;
-        const stepId = `step:${step}`;
-        addNode({ id: stepId, type: "step", label: `${step} ${getCell(row.cells, ["Name", "名称"]) || ""}`.trim(), state: getCell(row.cells, ["Status", "状态"], "unknown"), module: moduleKey });
-        addEdge({ from: moduleId, to: stepId, type: "contains" });
-        for (const dependency of splitDependencies(getCell(row.cells, ["Depends On", "依赖"]) || "")) {
-          addEdge({ from: `step:${dependency}`, to: stepId, type: "depends_on" });
-        }
-      }
-    }
-  }
-  for (const edge of edges) {
-    if (edge.type === "depends_on" && !seenNodes.has(edge.from)) {
-      addNode({ id: edge.from, type: "external-dependency", label: edge.from.replace(/^(phase:[^:]+:|step:)/, ""), state: "external" });
-    }
-  }
-  return { nodes, edges: edges.filter((edge) => seenNodes.has(edge.from) && seenNodes.has(edge.to)) };
-}
-
-export function categorizeWarning(message) {
-  if (/governance-table-entropy/i.test(message)) return "Governance Table Boundary";
-  if (/missing execution_strategy\.md|missing visual_(?:map|roadmap)\.md|Visual (?:Map|Roadmap)/i.test(message)) return "Plan Contract Missing";
-  if (/legacy-compat|adoption-needed|legacy check/i.test(message)) return "Adoption Advice";
-  if (/Evidence|evidence/i.test(message)) return "Missing Evidence";
-  if (/schema|missing .*columns|invalid/i.test(message)) return "Schema Drift";
-  return "Review Finding";
-}
-
-function warningType(message) {
-  if (/missing brief\.md|briefSource|brief/i.test(message) && /missing|缺少/i.test(message)) return "missing-brief";
-  if (/missing execution_strategy\.md/i.test(message)) return "missing-execution-strategy";
-  if (/missing visual_map\.md|Visual Map/i.test(message)) return "missing-visual-map";
-  if (/missing visual_roadmap\.md|Visual Roadmap/i.test(message)) return "missing-visual-roadmap";
-  if (/Reviewer Identity|Confidence Challenge|Final Confidence Basis|Evidence Checked/i.test(message)) return "review-schema-gap";
-  if (/governance-table-entropy/i.test(message)) return "governance-table-entropy";
-  if (/Evidence|evidence/i.test(message)) return "missing-evidence";
-  if (/missing required file/i.test(message)) return "legacy-reference-gap";
-  if (/legacy-compat|legacy check|adoption-needed/i.test(message)) return "capability-adoption";
-  if (/schema|missing .*columns|invalid/i.test(message)) return "schema-drift";
-  return "review-finding";
-}
-
-function warningScope(message) {
-  if (/docs\/09-PLANNING\/TASKS\//i.test(message)) return "task";
-  if (/docs\/09-PLANNING\/MODULES\//i.test(message)) return "module";
-  if (/review\.md|findings table/i.test(message)) return "review";
-  if (/docs\/11-REFERENCE\//i.test(message)) return "reference";
-  if (/\.harness-capabilities\.json|capability|legacy-compat/i.test(message)) return "capability";
-  return "project";
-}
-
-function warningPhase(type, scope) {
-  if (type === "capability-adoption") return "baseline";
-  if (type === "governance-table-entropy") return "global-table-boundary";
-  if (type === "missing-brief" || type === "missing-execution-strategy" || type === "missing-visual-map" || type === "missing-visual-roadmap") return "active-task-contracts";
-  if (scope === "module") return "module-classification";
-  if (type === "review-schema-gap" || type === "missing-evidence") return "review-evidence";
-  if (type === "legacy-reference-gap" || type === "schema-drift") return "strict-cutover";
-  return "triage";
-}
-
-function warningFixability(type, scope) {
-  if (["missing-brief", "missing-execution-strategy", "missing-visual-map", "missing-visual-roadmap"].includes(type)) return "guided";
-  if (type === "governance-table-entropy") return "manual";
-  if (type === "legacy-reference-gap" || scope === "reference") return "template";
-  if (type === "capability-adoption") return "decision";
-  if (type === "review-schema-gap" || type === "missing-evidence") return "human-evidence";
-  return "manual";
-}
-
-function warningPriority(type, scope, message) {
-  if (/fail|invalid|blocked/i.test(message) || type === "schema-drift") return "P1";
-  if (type === "governance-table-entropy") return /legacy-report-only/i.test(message) ? "P3" : "P2";
-  if (["missing-brief", "missing-execution-strategy", "missing-visual-map", "missing-visual-roadmap"].includes(type) && scope === "task") return "P2";
-  if (type === "review-schema-gap" || type === "missing-evidence") return "P2";
-  if (type === "capability-adoption") return "P3";
-  return "P3";
-}
-
-function warningConfidence(message) {
-  if (/legacy|unknown|fallback/i.test(message)) return "medium";
-  return "high";
-}
-
-function warningAffectedPaths(message) {
-  const matches = String(message).match(/(?:docs|\.harness-private)\/[^\s:]+|\.harness-capabilities\.json|AGENTS\.md|CLAUDE\.md/g) || [];
-  return [...new Set(matches.map((item) => item.replace(/[),.;]+$/, "")))];
-}
-
-function summarizeWarnings(warnings) {
-  const countBy = (field) =>
-    warnings.reduce((acc, warning) => {
-      const key = warning[field] || "unknown";
-      acc[key] = (acc[key] || 0) + 1;
-      return acc;
-    }, {});
-  return {
-    total: warnings.length,
-    byCategory: countBy("category"),
-    byType: countBy("type"),
-    byPriority: countBy("priority"),
-    byPhase: countBy("phase"),
-    byFixability: countBy("fixability"),
-    activeTaskWarnings: warnings.filter((warning) => warning.scope === "task" && warning.phase === "active-task-contracts").length,
-    strictCutoverWarnings: warnings.filter((warning) => warning.phase === "strict-cutover").length,
-  };
-}
-
-export function collectAdoption(status) {
-  const dashboardMessages = [
-    ...(status.checkState.details.warnings || []),
-    ...(status.checkState.details.failures || []).filter((message) => /governance-table-entropy/i.test(message)),
-  ];
-  const warnings = dashboardMessages.flatMap((message) => splitWarningMessage(message)).map((message, index) => {
-    const type = warningType(message);
-    const scope = warningScope(message);
-    const affectedPaths = warningAffectedPaths(message);
-    const stableSuffix = type === "governance-table-entropy" ? `-${stableWarningIdPart(governanceWarningRowKey(message))}` : "";
-    return {
-      id: `AD-${String(index + 1).padStart(3, "0")}${stableSuffix}`,
-      category: categorizeWarning(message),
-      type,
-      scope,
-      priority: warningPriority(type, scope, message),
-      phase: warningPhase(type, scope),
-      fixability: warningFixability(type, scope),
-      status: /legacy-report-only/i.test(message) ? "legacy-report-only" : "open",
-      confidence: warningConfidence(message),
-      severity: status.mode === "legacy-compat" ? "advice" : "warning",
-      title: warningTitle(message),
-      affected: affectedPaths[0] || warningAffected(message),
-      affectedPaths,
-      requiredAction: warningAction(message),
-      detail: sanitizeText(message),
-    };
-  });
-  return {
-    mode: status.mode,
-    project: status.project,
-    summary: {
-      blockers: status.checkState.failures,
-      advice: warnings.length,
-      ...summarizeWarnings(warnings),
-    },
-    warnings,
-    manualSteps: {
-      zh: [
-        "先查看升级建议，决定当前项目要采用哪些 v1.0 能力合同。",
-        "为仍在活跃的任务手工补齐 execution_strategy.md 和 visual_map.md。",
-        "只有在项目明确声明 v1.0 capability 后，再把 strict check 当成阻塞门禁。",
-      ],
-      en: [
-        "Review adoption advice and decide which v1.0 capability contracts should be adopted.",
-        "Manually add execution_strategy.md and visual_map.md for active tasks.",
-        "Treat strict check as blocking only after the project intentionally declares v1.0 capabilities.",
-      ],
-    },
-  };
-}
-
-function governanceWarningRowKey(message) {
-  const match = String(message || "").match(/\brow\s+([^:]+)/i);
-  return match ? match[1].trim() : "global-table";
-}
-
-function stableWarningIdPart(value) {
-  return String(value || "global-table")
-    .replace(/[^A-Za-z0-9_-]+/g, "-")
-    .replace(/^-+|-+$/g, "")
-    .slice(0, 80) || "global-table";
-}
-
-export function splitWarningMessage(message) {
-  return String(message || "")
-    .split(/\n-\s+/)
-    .map((item, index) => (index === 0 ? item : `- ${item}`))
-    .filter(Boolean);
-}
-
-function warningTitle(message) {
-  if (/governance-table-entropy/i.test(message)) return "Global table boundary";
-  if (/missing execution_strategy\.md/i.test(message)) return "Missing execution strategy";
-  if (/missing visual_map\.md|Visual Map/i.test(message)) return "Missing visual map";
-  if (/missing visual_roadmap\.md|Visual Roadmap/i.test(message)) return "Missing legacy visual roadmap";
-  if (/legacy-compat/i.test(message)) return "Legacy compatibility mode";
-  if (/legacy check failed/i.test(message)) return "Legacy checker finding";
-  if (/review\.md missing/i.test(message)) return "Review schema gap";
-  if (/findings table missing/i.test(message)) return "Review findings schema gap";
-  return String(message).split(":")[0].slice(0, 96);
-}
-
-function warningAffected(message) {
-  const target = String(message).match(/(?:docs|\.harness-private)\/[^\s:]+/);
-  return target ? target[0] : "project";
-}
-
-function warningAction(message) {
-  if (/governance-table-entropy/i.test(message)) return "Move local detail to module/task docs; keep the global row to summary, state, route, and audit result.";
-  if (/execution_strategy\.md/i.test(message)) return "Add standalone execution strategy file.";
-  if (/visual_map\.md|Visual Map/i.test(message)) return "Add standalone visual map file.";
-  if (/visual_roadmap\.md|Visual Roadmap/i.test(message)) return "Rewrite legacy visual_roadmap.md into canonical visual_map.md.";
-  if (/review\.md missing/i.test(message)) return "Update review.md to v1 review schema.";
-  if (/legacy/i.test(message)) return "Review manually; do not auto-migrate.";
-  return "Inspect source document and decide whether to adopt v1 contract.";
-}
-
-export function buildDashboardBundle(targetInput, options = {}) {
-  const status = buildStatus(targetInput, options);
-  const target = normalizeTarget(targetInput);
-  const documents = { documents: collectMarkdownDocuments(target) };
-  const tables = collectTables(documents.documents);
-  const graph = collectGraph(status, tables);
-  const adoption = collectAdoption(status);
-  return sanitizeDeep({ status, tables, documents, graph, adoption });
-}
-
-export function writeDashboardFolder(outDir, targetInput, options = {}) {
-  const target = normalizeTarget(targetInput);
-  const registry = readCapabilityRegistry(target);
-  const locale = options.localeOverride || registry.locale;
-  const bundle = buildDashboardBundle(targetInput, options);
-  return writeDashboardDirectory(outDir, bundle, { repoRoot, projectRoot: target.projectRoot, docsRoot: target.docsRoot, locale, workbenchRuntime: options.workbenchRuntime === true, recoverGeneratedDashboard: options.recoverGeneratedDashboard === true });
-}
-
-export function writeDashboardSingleFile(outFile, targetInput, options = {}) {
-  const target = normalizeTarget(targetInput);
-  const registry = readCapabilityRegistry(target);
-  const locale = options.localeOverride || registry.locale;
-  const bundle = buildDashboardBundle(targetInput, options);
-  return writeDashboardFile(outFile, bundle, { repoRoot, projectRoot: target.projectRoot, docsRoot: target.docsRoot, locale });
-}