@papi-ai/server 0.7.78 → 0.7.80

package/dist/backfill-cycle-metrics.js

@@ -1116,16 +1116,16 @@ var init_git = __esm({
 });
 
 // src/lib/install-id.ts
-import { randomUUID as randomUUID7 } from "crypto";
+import { randomUUID } from "crypto";
 import { mkdirSync, readFileSync, writeFileSync, chmodSync } from "fs";
 import { homedir } from "os";
-import { join as join2 } from "path";
+import { join } from "path";
 var PAPI_HOME_DIR, INSTALL_ID_FILE;
 var init_install_id = __esm({
   "src/lib/install-id.ts"() {
     "use strict";
-    PAPI_HOME_DIR = join2(homedir(), ".papi");
-    INSTALL_ID_FILE = join2(PAPI_HOME_DIR, "install-id.json");
+    PAPI_HOME_DIR = join(homedir(), ".papi");
+    INSTALL_ID_FILE = join(PAPI_HOME_DIR, "install-id.json");
   }
 });
 
@@ -1226,6 +1226,10 @@ var init_proxy_adapter = __esm({
       "stateHistory",
       "handoffAccuracy",
       "briefImplications",
+      // task-3223: acceptance_results carries host-authored strings (a check's
+      // `run`/`pattern`). Its internals are already camelCase and must not be
+      // key-transformed — same reason as handoffAccuracy above.
+      "acceptanceResults",
       "autoReview",
       "structuredData",
       "data"
@@ -2068,2402 +2072,110 @@ import { pathToFileURL } from "url";
 import path2 from "path";
 import { execSync } from "child_process";
 
-// ../../../../../Users/cathaloullivan/Ai-App-Projects/PapiUI/packages/adapter-md/dist/index.js
-import { readFile, writeFile, access } from "fs/promises";
-import { randomUUID as randomUUID6 } from "crypto";
-import { join } from "path";
-import {
-  VALID_TRANSITIONS as _VALID_TRANSITIONS,
-  isValidTransition as _isValidTransition,
-  validateTransition as _validateTransition,
-  isValidStatus as _isValidStatus,
-  isLiveDecision as _isLiveDecision,
-  RETIRED_DECISION_OUTCOMES as _RETIRED_DECISION_OUTCOMES
-} from "@papi-ai/shared";
-import { randomUUID } from "crypto";
-import { randomUUID as randomUUID3 } from "crypto";
-import yaml from "js-yaml";
-import { randomUUID as randomUUID2 } from "crypto";
-import { randomUUID as randomUUID4 } from "crypto";
-import { randomUUID as randomUUID5 } from "crypto";
-import yaml2 from "js-yaml";
-import yaml3 from "js-yaml";
-var VALID_TRANSITIONS = _VALID_TRANSITIONS;
-var isLiveDecision = _isLiveDecision;
-function extractSection(content, heading) {
-  const headingPattern = new RegExp(`^## ${heading}\\s*$`, "m");
-  const start = content.search(headingPattern);
-  if (start === -1) return "";
-  const afterHeading = content.slice(start);
-  const nextSection = afterHeading.slice(1).search(/^## /m);
-  return nextSection === -1 ? afterHeading : afterHeading.slice(0, nextSection + 1);
-}
-function extractSectionCompat(content, newHeading, legacyHeading) {
-  const section = extractSection(content, newHeading);
-  return section || extractSection(content, legacyHeading);
-}
-function parseCycleHealth(content) {
-  const section = extractSectionCompat(content, "Cycle Health", "Sprint Health") || extractSection(content, "Session Health");
-  const rows = /* @__PURE__ */ new Map();
-  for (const line of section.split("\n")) {
-    const match = line.match(/^\|\s*(.+?)\s*\|\s*(.+?)\s*\|$/);
-    if (!match) continue;
-    const key = match[1].trim().toLowerCase();
-    const value = match[2].trim();
-    if (key !== "metric") rows.set(key, value);
-  }
-  const get = (key) => rows.get(key) ?? "";
-  return {
-    totalCycles: parseInt(get("total cycles") || get("total sprints") || get("total sessions"), 10) || 0,
-    cyclesSinceLastStrategyReview: parseInt(get("cycles since last strategy review") || get("sprints since last strategy review") || get("sessions since last strategy review"), 10) || 0,
-    strategyReviewDue: get("strategy review due"),
-    boardHealth: get("board health"),
-    strategicDirection: get("strategic direction"),
-    lastFullMode: parseInt(get("last full mode"), 10) || 0
-  };
-}
-function serializeCycleHealth(health, content) {
-  const section = extractSectionCompat(content, "Cycle Health", "Sprint Health") || extractSection(content, "Session Health");
-  const fieldMap = {
-    "Total cycles": String(health.totalCycles),
-    "Cycles since last Strategy Review": String(health.cyclesSinceLastStrategyReview),
-    "Strategy Review due": health.strategyReviewDue,
-    "Board health": health.boardHealth,
-    "Strategic direction": health.strategicDirection,
-    "Last Full Mode": String(health.lastFullMode)
-  };
-  const legacyFieldMap = {
-    "Total sprints": String(health.totalCycles),
-    "Sprints since last Strategy Review": String(health.cyclesSinceLastStrategyReview),
-    "Total sessions": String(health.totalCycles),
-    "Sessions since last Strategy Review": String(health.cyclesSinceLastStrategyReview)
-  };
-  let updatedSection = section;
-  for (const [metric, value] of Object.entries({ ...fieldMap, ...legacyFieldMap })) {
-    const pattern = new RegExp(`(\\|\\s*${metric}\\s*\\|\\s*)(.+?)(\\s*\\|)`, "i");
-    updatedSection = updatedSection.replace(pattern, `$1${value}$3`);
-  }
-  return content.replace(section, updatedSection);
-}
-function parseActiveDecisions(content) {
-  const section = extractSection(content, "Active Decisions");
-  const chunks = section.split(/^(?=### AD-\d+:)/m).map((c) => c.trim()).filter((c) => c.startsWith("### AD-"));
-  return chunks.map((block) => {
-    const headingMatch = block.match(
-      /^### (AD-\d+):\s*(.+?)(?:\s*\[Confidence:\s*(HIGH|MEDIUM|LOW)\])?(?:\s*\[SUPERSEDED by (AD-\d+)\])?\s*$/m
-    );
-    if (!headingMatch) return null;
-    const metaMatch = block.match(/<!-- papi:(?:created_sprint=(\d+))?\s*(?:modified_sprint=(\d+)\s*)*(?:uuid=(\S+))? -->/);
-    const createdCycle = metaMatch?.[1] ? parseInt(metaMatch[1], 10) : void 0;
-    const modifiedCycle = metaMatch?.[2] ? parseInt(metaMatch[2], 10) : void 0;
-    const uuid = metaMatch?.[3] ?? randomUUID();
-    return {
-      uuid,
-      id: headingMatch[1],
-      displayId: headingMatch[1],
-      title: headingMatch[2].trim(),
-      confidence: headingMatch[3] ?? "HIGH",
-      superseded: !!headingMatch[4],
-      supersededBy: headingMatch[4],
-      createdCycle,
-      modifiedCycle,
-      body: block
-    };
-  }).filter((d) => d !== null);
-}
-function stripTemporalMeta(body) {
-  return body.replace(/\n?<!-- papi:(?:created_sprint=\d+)?\s*(?:modified_sprint=\d+\s*)*(?:uuid=\S+)? -->/g, "");
-}
-function buildTemporalMeta(createdCycle, modifiedCycle, uuid) {
-  const parts = [];
-  if (createdCycle != null) parts.push(`created_sprint=${createdCycle}`);
-  if (modifiedCycle != null) parts.push(`modified_sprint=${modifiedCycle}`);
-  if (uuid) parts.push(`uuid=${uuid}`);
-  if (parts.length === 0) return "";
-  return `
-<!-- papi:${parts.join(" ")} -->`;
-}
-function extractCreatedCycle(block) {
-  const m = block.match(/<!-- papi:(?:created_sprint=(\d+))/);
-  return m?.[1] ? parseInt(m[1], 10) : void 0;
-}
-function extractUuid(block) {
-  const m = block.match(/<!-- papi:.*?uuid=(\S+)/);
-  return m?.[1];
-}
-function updateActiveDecisionInContent(id, newBody, content, cycleNumber) {
-  if (!newBody) return content;
-  const escapedId = id.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, "\\$&");
-  const pattern = new RegExp(`(### ${escapedId}:.*?)(?=^### AD-\\d+:|^## |$(?![\\s\\S]))`, "ms");
-  const cleanBody = stripTemporalMeta(newBody);
-  if (pattern.test(content)) {
-    const existingMatch = content.match(pattern);
-    const existingCreated = existingMatch ? extractCreatedCycle(existingMatch[0]) : void 0;
-    const existingUuid = existingMatch ? extractUuid(existingMatch[0]) : void 0;
-    const meta2 = cycleNumber != null ? buildTemporalMeta(existingCreated, cycleNumber, existingUuid) : existingUuid ? buildTemporalMeta(existingCreated, void 0, existingUuid) : "";
-    return content.replace(pattern, cleanBody.trimEnd() + meta2 + "\n\n");
-  }
-  const meta = cycleNumber != null ? buildTemporalMeta(cycleNumber) : "";
-  const sectionPattern = /^(#{1,2} Active Decisions\n)([\s\S]*?)(?=^#{1,2} |$(?![\s\S]))/m;
-  const sectionMatch = content.match(sectionPattern);
-  if (sectionMatch) {
-    const sectionHeader = sectionMatch[1];
-    const sectionBody = sectionMatch[2];
-    const newSection = sectionHeader + sectionBody.trimEnd() + "\n\n" + cleanBody.trimEnd() + meta + "\n\n";
-    return content.replace(sectionPattern, newSection);
-  }
-  return content;
-}
-function parseCycleLog(content, limit) {
-  const section = extractSectionCompat(content, "Cycle Log", "Sprint Log");
-  const chunks = section.split(/^(?=### (?:Cycle|Sprint|Session) \d+ —)/m).map((c) => c.trim()).filter((c) => c.match(/^### (?:Cycle|Sprint|Session) \d+ —/));
-  const entries = chunks.map((block) => {
-    const headingMatch = block.match(/^### (?:Cycle|Sprint|Session) (\d+) — (.+?)$/m);
-    const cycleNumber = headingMatch ? parseInt(headingMatch[1], 10) : 0;
-    const title = headingMatch ? headingMatch[2].trim() : block.split("\n")[0].replace(/^### /, "");
-    const carryForwardMatch = block.match(/^- \*\*CARRY FORWARD:\*\*\s*(.+)$/m);
-    const uuidMatch = block.match(/<!-- papi:.*?uuid=(\S+)/);
-    const uuid = uuidMatch?.[1];
-    const blockClean = block.replace(/\n?<!-- papi:.*?-->/g, "");
-    const notesMatch = blockClean.match(/\*\*Cycle Notes:\*\*\s*([\s\S]*?)$/);
-    const notes = notesMatch ? notesMatch[1].trim() : void 0;
-    return {
-      uuid: uuid ?? randomUUID(),
-      cycleNumber,
-      title,
-      content: block,
-      carryForward: carryForwardMatch ? carryForwardMatch[1].trim() : void 0,
-      notes
-    };
-  });
-  return limit ? entries.slice(0, limit) : entries;
-}
-function prependCycleLogEntry(entry, content) {
-  const headingPattern = /^## (?:Cycle|Sprint|Session) Log\s*$/m;
-  const headingMatch = content.match(headingPattern);
-  if (!headingMatch || headingMatch.index === void 0) {
-    throw new Error("Cycle Log section not found in Planning Log");
-  }
-  const insertPos = headingMatch.index + headingMatch[0].length;
-  const before = content.slice(0, insertPos);
-  const after = content.slice(insertPos);
-  let entryContent = entry.content;
-  if (entry.notes) {
-    entryContent = `${entryContent}
-
-**Cycle Notes:** ${entry.notes}`;
-  }
-  if (entry.uuid) {
-    entryContent = `${entryContent}
-<!-- papi:uuid=${entry.uuid} -->`;
-  }
-  return `${before}
-
-${entryContent}
-${after}`;
-}
-function parseNorthStar(content) {
-  return extractSection(content, "North Star").replace(/^## North Star\s*/m, "").trim();
-}
-function upsertNorthStarInContent(content, statement) {
-  const headingPattern = /^## North Star\s*$/m;
-  const start = content.search(headingPattern);
-  if (start === -1) {
-    const cycleLogIdx = content.search(/^## (?:Cycle Log|Sprint Log)/m);
-    const newSection = `## North Star
-
-${statement}
-
-`;
-    if (cycleLogIdx === -1) {
-      return content.trimEnd() + "\n\n" + newSection;
-    }
-    return content.slice(0, cycleLogIdx) + newSection + content.slice(cycleLogIdx);
-  }
-  const afterHeading = content.slice(start);
-  const nextSection = afterHeading.slice(1).search(/^## /m);
-  const sectionEnd = nextSection === -1 ? content.length : start + nextSection + 1;
-  return content.slice(0, start) + `## North Star
-
-${statement}
-
-` + content.slice(sectionEnd);
-}
-function parseDeferred(content) {
-  const section = extractSection(content, "Deferred / Parking Lot");
-  return section.split("\n").filter((line) => line.match(/^-\s+/)).map((line) => line.replace(/^-\s+/, "").trim());
-}
-function compressCycleLogInContent(content, threshold, summary) {
-  const section = extractSectionCompat(content, "Cycle Log", "Sprint Log");
-  const chunks = section.split(/^(?=### (?:Cycle|Sprint|Session) \d+ —)/m).map((c) => c.trim()).filter((c) => c.match(/^### (?:Cycle|Sprint|Session) \d+ —/));
-  const keep = [];
-  let hasOld = false;
-  for (const block of chunks) {
-    const match = block.match(/^### (?:Cycle|Sprint|Session) (\d+) —/);
-    const num = match ? parseInt(match[1], 10) : 0;
-    if (num >= threshold) {
-      keep.push(block);
-    } else {
-      hasOld = true;
-    }
-  }
-  if (!hasOld) return content;
-  const summaryBlock = `### Cycles 1\u2013${threshold - 1} \u2014 Compressed Summary
-
-${summary}`;
-  const newEntries = [...keep, summaryBlock].join("\n\n");
-  const newSection = `## Cycle Log
-
-${newEntries}
-`;
-  return content.replace(section, newSection);
-}
-function parsePlanningLog(content, activeDecisionsContent, cycleLogContent) {
-  return {
-    cycleHealth: parseCycleHealth(content),
-    northStar: parseNorthStar(content),
-    activeDecisions: parseActiveDecisions(activeDecisionsContent ?? content),
-    deferred: parseDeferred(content),
-    cycleLog: cycleLogContent ? parseCycleLog(cycleLogContent) : []
-  };
-}
-var VALID_EFFORT_SIZES = /* @__PURE__ */ new Set(["XS", "S", "M", "L", "XL"]);
-var SECTION_HEADERS = [
-  "SCOPE (DO THIS)",
-  "WHY NOT SIMPLER",
-  "SCOPE BOUNDARY (DO NOT DO THIS)",
-  "ACCEPTANCE CRITERIA",
-  "PRE-MORTEM",
-  "SECURITY CONSIDERATIONS",
-  "DEPLOY VERIFICATION",
-  "PRE-BUILD VERIFICATION",
-  "FILES LIKELY TOUCHED",
-  "EFFORT"
-];
-function normaliseHeaderLine(line) {
-  return line.trim().replace(/^#{1,6}\s*/, "").replace(/^-\s+/, "").replace(/^\*\*(.*?)\*\*$/, "$1").replace(/:\s*$/, "").trim();
-}
-function splitSections(text) {
-  const sections = /* @__PURE__ */ new Map();
-  const lines = text.split("\n");
-  let currentSection = null;
-  const sectionLines = [];
-  const flush = () => {
-    if (currentSection !== null) {
-      sections.set(currentSection, sectionLines.join("\n").trim());
-      sectionLines.length = 0;
-    }
-  };
-  for (const line of lines) {
-    const normalised = normaliseHeaderLine(line);
-    const matched = SECTION_HEADERS.find((h) => normalised === h);
-    if (matched) {
-      flush();
-      currentSection = matched;
-    } else if (currentSection !== null) {
-      sectionLines.push(line);
-    }
-  }
-  flush();
-  return sections;
-}
-function parseBulletList(text) {
-  return text.split("\n").map((l) => l.replace(/^\s*-\s*/, "").trim()).filter((l) => l.length > 0);
-}
-function parseBulletsOnly(text) {
-  return text.split("\n").filter((l) => /^\s*-\s/.test(l)).map((l) => l.replace(/^\s*-\s*/, "").trim()).filter((l) => l.length > 0);
-}
-function parseChecklist(text) {
-  return text.split("\n").map((l) => l.replace(/^\s*(?:[-*+]\s*)?(?:\[[ xX]\]\s*)?/, "").trim()).filter((l) => l.length > 0);
-}
-function parseBuildHandoff(markdown) {
-  if (typeof markdown !== "string" || !markdown.trim()) return null;
-  if (!markdown.includes("BUILD HANDOFF") && splitSections(markdown).size === 0) {
-    return null;
+// src/lib/path-identity.ts
+import fs from "fs";
+import path from "path";
+function realpathOrSelf(p) {
+  try {
+    return fs.realpathSync(p);
+  } catch {
+    return p;
   }
-  const taskIdMatch = markdown.match(/BUILD HANDOFF\s*—\s*(task-\d+)/);
-  const taskTitleMatch = markdown.match(/^Task:\s*(.+)$/m);
-  const cycleMatch = markdown.match(/^Cycle:\s*(\d+)$/m);
-  const whyNowMatch = markdown.match(/^Why now:\s*([\s\S]*?)(?=\n\n|\nSCOPE)/m);
-  const taskId = taskIdMatch?.[1] ?? "";
-  const taskTitle = taskTitleMatch?.[1]?.trim() ?? "";
-  const cycle = cycleMatch ? parseInt(cycleMatch[1], 10) : 0;
-  const whyNow = whyNowMatch?.[1]?.replace(/\s+/g, " ").trim() ?? "";
-  const uuidMatch = markdown.match(/^UUID:\s*(\S+)$/m);
-  const uuid = uuidMatch?.[1];
-  const displayIdMatch = markdown.match(/^Display ID:\s*(\S+)$/m);
-  const displayId = displayIdMatch?.[1];
-  const createdAtMatch = markdown.match(/^Created:\s*(.+)$/m);
-  const createdAt = createdAtMatch?.[1]?.trim();
-  const sections = splitSections(markdown);
-  const effortText = (sections.get("EFFORT") ?? "").trim().toUpperCase();
-  const effort = VALID_EFFORT_SIZES.has(effortText) ? effortText : "M";
-  return {
-    uuid: uuid ?? randomUUID2(),
-    ...displayId ? { displayId } : {},
-    ...createdAt ? { createdAt } : {},
-    taskId,
-    taskTitle,
-    cycle,
-    whyNow,
-    scope: parseBulletList(sections.get("SCOPE (DO THIS)") ?? ""),
-    scopeBoundary: parseBulletList(sections.get("SCOPE BOUNDARY (DO NOT DO THIS)") ?? ""),
-    acceptanceCriteria: parseChecklist(sections.get("ACCEPTANCE CRITERIA") ?? ""),
-    securityConsiderations: (sections.get("SECURITY CONSIDERATIONS") ?? "").trim(),
-    verificationFiles: parseBulletsOnly(sections.get("PRE-BUILD VERIFICATION") ?? ""),
-    filesLikelyTouched: parseBulletList(sections.get("FILES LIKELY TOUCHED") ?? ""),
-    effort
-  };
 }
-function ensureArray(value) {
-  if (Array.isArray(value)) return value;
-  if (typeof value === "string") {
-    try {
-      const parsed = JSON.parse(value);
-      if (Array.isArray(parsed)) return parsed;
-    } catch {
-    }
-    return value.trim() ? [value] : [];
+function checkProjectPathIdentity(opts) {
+  const { storedPapiDir, projectName, cwd } = opts;
+  const log = opts.log ?? ((msg) => console.error(msg));
+  const allowMigrate = opts.allowMigrate ?? (process.env.PAPI_ALLOW_PATH_MIGRATE === "1" || process.env.PAPI_ALLOW_PATH_MIGRATE === "true");
+  const realCwd = realpathOrSelf(cwd);
+  const expectedPapiDir = path.join(realCwd, ".papi");
+  if (!storedPapiDir || storedPapiDir.trim() === "" || storedPapiDir.trim() === ".") {
+    log(`[papi] Backfilling project root for '${projectName}' from current cwd: ${realCwd}`);
+    return { action: "backfill", newPapiDir: expectedPapiDir };
   }
-  return [];
-}
-function serializeBuildHandoff(raw) {
-  let handoff;
-  if (typeof raw === "string") {
-    try {
-      handoff = JSON.parse(raw);
-    } catch {
-      return raw;
-    }
+  const trimmed = storedPapiDir.trim();
+  const endsInPapi = trimmed.endsWith("/.papi") || trimmed.endsWith("\\.papi");
+  const isWindowsPath = /^[A-Za-z]:[\\/]/.test(trimmed);
+  const realStored = realpathOrSelf(trimmed);
+  let storedProjectRoot;
+  if (endsInPapi) {
+    storedProjectRoot = isWindowsPath ? path.win32.dirname(realStored) : path.dirname(realStored);
   } else {
-    handoff = raw;
-  }
-  const lines = [];
-  lines.push(`BUILD HANDOFF \u2014 ${handoff.taskId}`);
-  if (handoff.uuid) lines.push(`UUID: ${handoff.uuid}`);
-  if (handoff.displayId) lines.push(`Display ID: ${handoff.displayId}`);
-  if (handoff.createdAt) lines.push(`Created: ${handoff.createdAt}`);
-  lines.push(`Task: ${handoff.taskTitle}`);
-  lines.push(`Cycle: ${handoff.cycle}`);
-  lines.push(`Why now: ${handoff.whyNow}`);
-  lines.push("");
-  lines.push("SCOPE (DO THIS)");
-  for (const item of ensureArray(handoff.scope)) {
-    lines.push(`- ${item}`);
-  }
-  lines.push("");
-  lines.push("SCOPE BOUNDARY (DO NOT DO THIS)");
-  for (const item of ensureArray(handoff.scopeBoundary)) {
-    lines.push(`- ${item}`);
-  }
-  lines.push("");
-  lines.push("ACCEPTANCE CRITERIA");
-  for (const item of ensureArray(handoff.acceptanceCriteria)) {
-    lines.push(`[ ] ${item}`);
+    storedProjectRoot = realStored;
   }
-  lines.push("");
-  lines.push("SECURITY CONSIDERATIONS");
-  lines.push(handoff.securityConsiderations ?? "");
-  const verificationFiles = ensureArray(handoff.verificationFiles);
-  if (verificationFiles.length > 0) {
-    lines.push("");
-    lines.push("PRE-BUILD VERIFICATION");
-    lines.push("Before implementing, read these files and check if the functionality already exists:");
-    for (const item of verificationFiles) {
-      lines.push(`- ${item}`);
+  if (storedProjectRoot === realCwd) {
+    if (!endsInPapi) {
+      log(`[papi] Normalising legacy papi_dir for '${projectName}': ${trimmed} \u2192 ${expectedPapiDir}`);
+      return { action: "migrate", newPapiDir: expectedPapiDir };
     }
-    lines.push('If >80% of the scope is already implemented, call build_execute with completed="yes" and note "already built" in surprises instead of re-implementing.');
-  }
-  lines.push("");
-  lines.push("FILES LIKELY TOUCHED");
-  for (const item of ensureArray(handoff.filesLikelyTouched)) {
-    lines.push(`- ${item}`);
-  }
-  lines.push("");
-  lines.push("EFFORT");
-  lines.push(handoff.effort ?? "M");
-  return lines.join("\n");
-}
-var YAML_MARKER = "<!-- PAPI-ADAPTER: parse the yaml block below -->";
-var YAML_START = "<!-- PAPI-YAML-START -->";
-var YAML_END = "<!-- PAPI-YAML-END -->";
-function toCycleTask(raw) {
-  return {
-    uuid: raw.uuid || randomUUID3(),
-    id: raw.id,
-    displayId: raw.id,
-    title: raw.title,
-    status: raw.status,
-    priority: raw.priority,
-    complexity: raw.complexity,
-    module: raw.module,
-    epic: raw.epic,
-    phase: raw.phase,
-    owner: raw.owner,
-    reviewed: raw.reviewed ?? false,
-    cycle: raw.cycle != null ? raw.cycle : void 0,
-    createdCycle: raw.created_sprint != null ? raw.created_sprint : void 0,
-    createdAt: raw.created_at || void 0,
-    why: raw.why || void 0,
-    dependsOn: raw.depends_on || void 0,
-    notes: raw.notes || void 0,
-    stateHistory: raw.state_history?.length ? raw.state_history.map((e) => ({ status: e.status, timestamp: e.timestamp })) : void 0,
-    closureReason: raw.closure_reason || void 0,
-    buildHandoff: raw.build_handoff ? parseBuildHandoff(raw.build_handoff) ?? void 0 : void 0,
-    buildReport: raw.build_report || void 0,
-    scopeClass: raw.scope_class === "brief" ? "brief" : "task",
-    assigneeId: raw.assignee_id || void 0,
-    claimSource: raw.claim_source === "pool" || raw.claim_source === "self_generated" ? raw.claim_source : void 0,
-    reviewerId: raw.reviewer_id || void 0
-  };
-}
-function sanitizeDelimiters(value) {
-  return value.replaceAll(YAML_END, "<!-- PAPI-YAML-END (sanitized) -->");
-}
-function fromCycleTask(task) {
-  const raw = {
-    uuid: task.uuid,
-    id: task.id,
-    title: task.title,
-    status: task.status,
-    priority: task.priority,
-    complexity: task.complexity,
-    module: task.module,
-    epic: task.epic,
-    phase: task.phase,
-    owner: task.owner,
-    reviewed: task.reviewed,
-    depends_on: task.dependsOn ?? "",
-    notes: task.notes ? sanitizeDelimiters(task.notes) : ""
-  };
-  if (task.cycle != null) raw.cycle = task.cycle;
-  if (task.createdCycle != null) raw.created_sprint = task.createdCycle;
-  if (task.createdAt) raw.created_at = task.createdAt;
-  if (task.why) raw.why = task.why;
-  if (task.stateHistory?.length) {
-    raw.state_history = task.stateHistory.map((e) => ({ status: e.status, timestamp: e.timestamp }));
-  }
-  if (task.closureReason) raw.closure_reason = task.closureReason;
-  if (task.buildHandoff) raw.build_handoff = sanitizeDelimiters(serializeBuildHandoff(task.buildHandoff));
-  if (task.buildReport) raw.build_report = sanitizeDelimiters(task.buildReport);
-  if (task.scopeClass && task.scopeClass !== "task") raw.scope_class = task.scopeClass;
-  if (task.assigneeId) raw.assignee_id = task.assigneeId;
-  if (task.claimSource) raw.claim_source = task.claimSource;
-  if (task.reviewerId) raw.reviewer_id = task.reviewerId;
-  return raw;
-}
-function mergeConflictHint(content) {
-  if (/^[<=>]{7}/m.test(content)) {
-    return " The file contains merge conflict markers (<<<<<<, ======, >>>>>>) \u2014 resolve them first.";
-  }
-  return "";
-}
-function extractYamlBlock(content) {
-  const markerIdx = content.indexOf(YAML_MARKER);
-  if (markerIdx === -1) throw new Error("PAPI-ADAPTER marker not found in CYCLE_BOARD.md");
-  const afterMarker = content.slice(markerIdx + YAML_MARKER.length);
-  const startIdx = afterMarker.indexOf(YAML_START);
-  if (startIdx !== -1) {
-    const yamlStart = startIdx + YAML_START.length;
-    const endIdx = afterMarker.indexOf(YAML_END, yamlStart);
-    if (endIdx === -1) throw new Error("PAPI-YAML-END marker not found in CYCLE_BOARD.md");
-    return afterMarker.slice(yamlStart, endIdx);
+    return { action: "ok" };
   }
-  const blockMatch = afterMarker.match(/```yaml\n([\s\S]*?)```/);
-  if (!blockMatch) throw new Error("YAML block not found in CYCLE_BOARD.md");
-  return blockMatch[1];
-}
-function parseBoard(content) {
-  const yamlText = extractYamlBlock(content);
-  let data;
-  try {
-    data = yaml.load(yamlText);
-  } catch (err) {
-    const yamlErr = err;
-    const lineInfo = yamlErr.mark?.line != null ? ` (near line ${yamlErr.mark.line + 1} of YAML block)` : "";
-    const hint = mergeConflictHint(yamlText);
-    throw new Error(
-      `YAML parse error in CYCLE_BOARD.md${lineInfo}. Check for syntax errors \u2014 unquoted special characters, bad indentation, or missing colons.${hint}`
+  if (allowMigrate) {
+    log(
+      `[papi] PAPI_ALLOW_PATH_MIGRATE set \u2014 updating project '${projectName}' root: ${storedProjectRoot} \u2192 ${realCwd}`
     );
+    return { action: "migrate", newPapiDir: expectedPapiDir };
   }
-  return (data.tasks ?? []).map(toCycleTask);
-}
-function serializeBoard(tasks, content) {
-  const raw = tasks.map(fromCycleTask);
-  const yamlStr = yaml.dump({ tasks: raw }, { lineWidth: 120, quotingType: '"' });
-  const markerIdx = content.indexOf(YAML_MARKER);
-  if (markerIdx === -1) throw new Error("PAPI-ADAPTER marker not found in CYCLE_BOARD.md");
-  const afterMarker = content.slice(markerIdx + YAML_MARKER.length);
-  const htmlStartIdx = afterMarker.indexOf(YAML_START);
-  if (htmlStartIdx !== -1) {
-    const absStart = markerIdx + YAML_MARKER.length + htmlStartIdx;
-    const endIdx = afterMarker.indexOf(YAML_END, htmlStartIdx);
-    if (endIdx === -1) throw new Error("PAPI-YAML-END marker not found in CYCLE_BOARD.md");
-    const absEnd = markerIdx + YAML_MARKER.length + endIdx + YAML_END.length;
-    return content.slice(0, absStart) + YAML_START + "\n" + yamlStr + YAML_END + content.slice(absEnd);
-  }
-  const blockMatch = afterMarker.match(/```yaml\n[\s\S]*?```/);
-  if (!blockMatch) throw new Error("YAML block not found in CYCLE_BOARD.md");
-  const blockStart = markerIdx + YAML_MARKER.length + afterMarker.indexOf(blockMatch[0]);
-  const blockEnd = blockStart + blockMatch[0].length;
-  return content.slice(0, blockStart) + YAML_START + "\n" + yamlStr + YAML_END + content.slice(blockEnd);
-}
-function filterTasks(tasks, options) {
-  return tasks.filter((task) => {
-    if (options.status && !options.status.includes(task.status)) return false;
-    if (options.priority && !options.priority.includes(task.priority)) return false;
-    if (options.phase && !task.phase.toLowerCase().includes(options.phase.toLowerCase())) return false;
-    if (options.reviewed !== void 0 && task.reviewed !== options.reviewed) return false;
-    if (options.module && task.module !== options.module) return false;
-    if (options.epic && task.epic !== options.epic) return false;
-    if (options.assigneeId && task.assigneeId !== options.assigneeId) return false;
-    return true;
-  });
-}
-function nextTaskId(tasks) {
-  const maxN = tasks.reduce((max, t) => {
-    const match = t.id.match(/^task-(\d+)$/);
-    return match ? Math.max(max, parseInt(match[1], 10)) : max;
-  }, 0);
-  return `task-${String(maxN + 1).padStart(3, "0")}`;
-}
-var VALID_EFFORT_SIZES2 = /* @__PURE__ */ new Set(["XS", "S", "M", "L", "XL"]);
-function parseEffortSize(value) {
-  const normalized = value.trim().toUpperCase();
-  return VALID_EFFORT_SIZES2.has(normalized) ? normalized : void 0;
-}
-var HEADER_SENTINEL = "*After each build";
-function parseField(block, field) {
-  const pattern = new RegExp(`^- \\*\\*${field}:\\*\\*\\s*(.+)$`, "m");
-  const match = block.match(pattern);
-  return match ? match[1].trim() : "";
-}
-function parseEffort(effortLine) {
-  const match = effortLine.match(/^(\S+)\s+vs\s+estimated\s+(\S+)$/i);
-  return match ? { actual: match[1], estimated: match[2] } : { actual: effortLine, estimated: "" };
-}
-function parseBuildReports(content) {
-  const chunks = content.split(/^(?=### .+ — .+ — (?:Cycle|Sprint|Session) \d+)/m).map((c) => c.trim()).filter((c) => c.match(/^### .+ — .+ — (?:Cycle|Sprint|Session) \d+/));
-  return chunks.map((block) => {
-    const headingMatch = block.match(/^### (.+?) — (.+?) — (?:Cycle|Sprint|Session) (\d+)/);
-    if (!headingMatch) return null;
-    const effortLine = parseField(block, "Actual Effort");
-    const { actual, estimated } = parseEffort(effortLine);
-    const completedRaw = parseField(block, "Completed");
-    const taskId = parseField(block, "Task ID") || "unknown";
-    const uuidRaw = parseField(block, "UUID");
-    const displayIdRaw = parseField(block, "Display ID");
-    const scopeAccuracyRaw = parseField(block, "Scope Accuracy");
-    const validScopeValues = /* @__PURE__ */ new Set(["accurate", "over-scoped", "under-scoped", "missed-context"]);
-    const scopeAccuracy = scopeAccuracyRaw && validScopeValues.has(scopeAccuracyRaw) ? scopeAccuracyRaw : "accurate";
-    const actualEffort = parseEffortSize(actual) ?? "M";
-    const estimatedEffort = parseEffortSize(estimated) ?? "M";
-    const createdAtRaw = parseField(block, "Created");
-    const commitShaRaw = parseField(block, "Commit SHA");
-    const filesChangedRaw = parseField(block, "Files Changed");
-    const report = {
-      uuid: uuidRaw ?? randomUUID4(),
-      ...displayIdRaw ? { displayId: displayIdRaw } : {},
-      ...createdAtRaw ? { createdAt: createdAtRaw } : {},
-      taskId,
-      taskName: headingMatch[1].trim(),
-      date: headingMatch[2].trim(),
-      cycle: parseInt(headingMatch[3], 10),
-      completed: completedRaw.startsWith("Yes") ? "Yes" : completedRaw.startsWith("No") ? "No" : "Partial",
-      actualEffort,
-      estimatedEffort,
-      surprises: parseField(block, "Surprises"),
-      discoveredIssues: parseField(block, "Discovered Issues"),
-      architectureNotes: parseField(block, "Architecture Notes"),
-      scopeAccuracy
-    };
-    if (commitShaRaw) report.commitSha = commitShaRaw;
-    if (filesChangedRaw) report.filesChanged = filesChangedRaw.split(",").map((f) => f.trim()).filter(Boolean);
-    return report;
-  }).filter((r) => r !== null);
-}
-function serializeBuildReport(report) {
-  const lines = [
-    `### ${report.taskName} \u2014 ${report.date} \u2014 Cycle ${report.cycle}`
-  ];
-  if (report.uuid) lines.push(`- **UUID:** ${report.uuid}`);
-  if (report.displayId) lines.push(`- **Display ID:** ${report.displayId}`);
-  if (report.createdAt) lines.push(`- **Created:** ${report.createdAt}`);
-  lines.push(
-    `- **Task ID:** ${report.taskId}`,
-    `- **Completed:** ${report.completed}`,
-    `- **Actual Effort:** ${report.actualEffort} vs estimated ${report.estimatedEffort}`,
-    `- **Surprises:** ${report.surprises || "None"}`,
-    `- **Discovered Issues:** ${report.discoveredIssues || "None"}`,
-    `- **Architecture Notes:** ${report.architectureNotes || "None"}`,
-    `- **Scope Accuracy:** ${report.scopeAccuracy}`
+  throw new Error(
+    `PAPI is configured for project '${projectName}' which was set up in ${storedProjectRoot},
+but you're running in ${realCwd}.
+
+To fix:
+  - cd to the right project directory, OR
+  - run \`setup\` to attach this directory to a project, OR
+  - update PAPI_PROJECT_ID in .mcp.json if you intentionally moved the project, OR
+  - set PAPI_ALLOW_PATH_MIGRATE=1 to update the stored path on next boot.`
   );
-  if (report.commitSha) lines.push(`- **Commit SHA:** ${report.commitSha}`);
-  if (report.filesChanged && report.filesChanged.length > 0) {
-    lines.push(`- **Files Changed:** ${report.filesChanged.join(", ")}`);
-  }
-  return lines.join("\n");
-}
-function formatCompressedSummary(reports, cycleRange, aiSummary) {
-  const dates = reports.map((r) => r.date).filter(Boolean);
-  const dateRange = dates.length > 0 ? `${dates[dates.length - 1]} \u2013 ${dates[0]}` : "unknown";
-  const completed = reports.filter((r) => r.completed === "Yes");
-  const partial = reports.filter((r) => r.completed === "Partial");
-  const failed = reports.filter((r) => r.completed === "No");
-  const formatTaskList = (list) => list.map((r) => r.taskId !== "unknown" ? `${r.taskId} (${r.taskName})` : r.taskName).join(", ");
-  const lines = [`### ${cycleRange} \u2014 Compressed Summary`];
-  lines.push(`**Date range:** ${dateRange}`);
-  lines.push(`**Reports:** ${reports.length}`);
-  if (completed.length > 0) {
-    lines.push(`**Completed:** ${formatTaskList(completed)}`);
-  }
-  if (partial.length > 0) {
-    lines.push(`**Partial:** ${formatTaskList(partial)}`);
-  }
-  if (failed.length > 0) {
-    lines.push(`**Failed:** ${formatTaskList(failed)}`);
-  }
-  const surprises = reports.map((r) => r.surprises).filter((s) => s && s !== "None" && s !== "None.");
-  if (surprises.length > 0) {
-    lines.push(`**Surprises:** ${surprises.join("; ")}`);
-  }
-  const issues = reports.map((r) => r.discoveredIssues).filter((s) => s && s !== "None" && s !== "None.");
-  if (issues.length > 0) {
-    lines.push(`**Discovered issues:** ${issues.join("; ")}`);
-  }
-  if (aiSummary) {
-    lines.push(`**Key outcomes:** ${aiSummary}`);
-  }
-  return lines.join("\n");
-}
-function compressBuildReportsInContent(content, threshold, summary) {
-  const chunks = content.split(/^(?=### .+ — .+ — (?:Cycle|Sprint|Session) \d+)/m).map((c) => c.trim()).filter((c) => c.match(/^### .+ — .+ — (?:Cycle|Sprint|Session) \d+/));
-  const keep = [];
-  const oldChunks = [];
-  for (const block of chunks) {
-    const match = block.match(/— (?:Cycle|Sprint|Session) (\d+)/);
-    const num = match ? parseInt(match[1], 10) : 0;
-    if (num >= threshold) {
-      keep.push(block);
-    } else {
-      oldChunks.push(block);
-    }
-  }
-  if (oldChunks.length === 0) return content;
-  const oldReports = parseBuildReports(oldChunks.join("\n\n---\n\n"));
-  const cycleRange = `Cycles 1\u2013${threshold - 1}`;
-  const summaryBlock = formatCompressedSummary(oldReports, cycleRange, summary);
-  const firstReportIdx = content.search(/^### /m);
-  const header = firstReportIdx === -1 ? content : content.slice(0, firstReportIdx);
-  const entries = [...keep, summaryBlock].join("\n\n---\n\n");
-  return header + entries + "\n";
 }
-function mergeTextField(existing, incoming) {
-  if (!existing || existing === "None" || existing === "None.") return incoming;
-  if (!incoming || incoming === "None" || incoming === "None.") return existing;
-  if (existing === incoming) return existing;
-  return `${existing} | ${incoming}`;
-}
-function mergeBuildReports(existing, incoming) {
-  const uuid = incoming.uuid ?? existing.uuid;
-  const displayId = incoming.displayId ?? existing.displayId;
-  const merged = {
-    uuid,
-    ...displayId ? { displayId } : {},
-    taskId: incoming.taskId,
-    taskName: incoming.taskName,
-    date: incoming.date,
-    cycle: incoming.cycle,
-    completed: incoming.completed,
-    actualEffort: incoming.actualEffort,
-    estimatedEffort: incoming.estimatedEffort,
-    surprises: mergeTextField(existing.surprises, incoming.surprises),
-    discoveredIssues: mergeTextField(existing.discoveredIssues, incoming.discoveredIssues),
-    architectureNotes: incoming.architectureNotes,
-    scopeAccuracy: incoming.scopeAccuracy
-  };
-  if (incoming.createdAt ?? existing.createdAt) merged.createdAt = incoming.createdAt ?? existing.createdAt;
-  if (incoming.commitSha ?? existing.commitSha) merged.commitSha = incoming.commitSha ?? existing.commitSha;
-  if (incoming.filesChanged ?? existing.filesChanged) merged.filesChanged = incoming.filesChanged ?? existing.filesChanged;
-  return merged;
-}
-function replaceBuildReport(existing, replacement, content) {
-  const oldSerialized = serializeBuildReport(existing);
-  const newSerialized = serializeBuildReport(replacement);
-  const idx = content.indexOf(oldSerialized);
-  if (idx !== -1) {
-    return content.slice(0, idx) + newSerialized + content.slice(idx + oldSerialized.length);
-  }
-  const headingPattern = `### ${existing.taskName} \u2014 ${existing.date} \u2014 Cycle ${existing.cycle}`;
-  let headingIdx = content.indexOf(headingPattern);
-  if (headingIdx === -1) {
-    const legacyPattern = `### ${existing.taskName} \u2014 ${existing.date} \u2014 Sprint ${existing.cycle}`;
-    headingIdx = content.indexOf(legacyPattern);
-  }
-  if (headingIdx === -1) throw new Error(`Could not find existing build report for ${existing.taskId}`);
-  const afterHeading = content.slice(headingIdx);
-  const nextSeparator = afterHeading.indexOf("\n\n---\n");
-  const blockEnd = nextSeparator === -1 ? content.length : headingIdx + nextSeparator;
-  return content.slice(0, headingIdx) + newSerialized + content.slice(blockEnd);
-}
-function prependBuildReport(report, content) {
-  if (report.taskId !== "unknown") {
-    const existingReports = parseBuildReports(content);
-    const existingReport = existingReports.find((r) => r.taskId === report.taskId);
-    if (existingReport) {
-      const merged = mergeBuildReports(existingReport, report);
-      return replaceBuildReport(existingReport, merged, content);
-    }
-  }
-  const sentinelIdx = content.indexOf(HEADER_SENTINEL);
-  if (sentinelIdx === -1) throw new Error("Build Reports header sentinel not found");
-  const afterSentinel = content.slice(sentinelIdx);
-  const separatorIdx = afterSentinel.indexOf("\n---\n");
-  if (separatorIdx === -1) throw new Error("Separator after Build Reports header not found");
-  const insertAt = sentinelIdx + separatorIdx + "\n---\n".length;
-  const serialized = serializeBuildReport(report);
-  return content.slice(0, insertAt) + "\n" + serialized + "\n\n---\n" + content.slice(insertAt);
-}
-var TABLE_HEADER = "| Timestamp | Tool | Duration (ms) | Input Tokens | Output Tokens | Cost ($) | Model | Cycle | Context |";
-var TABLE_SEPARATOR = "|-----------|------|---------------|--------------|---------------|----------|-------|--------|---------|";
-var PREV_TABLE_HEADER = "| Timestamp | Tool | Duration (ms) | Input Tokens | Output Tokens | Cost ($) | Model | Cycle |";
-var LEGACY_TABLE_HEADER = "| Timestamp | Tool | Duration (ms) | Input Tokens | Output Tokens | Cost ($) | Model |";
-var SECTION_HEADING = "## Tool Call Metrics";
-var FILE_TEMPLATE = `# PAPI Metrics
 
-${SECTION_HEADING}
+// src/lib/project-resolution.ts
+function assertWorkspaceMatch(input) {
+  if (!input.workspacePath) return null;
+  return checkProjectPathIdentity({
+    storedPapiDir: input.storedPapiDir,
+    projectName: input.projectName,
+    cwd: input.workspacePath,
+    allowMigrate: input.allowMigrate,
+    log: input.log
+  });
+}
 
-${TABLE_HEADER}
-${TABLE_SEPARATOR}
-`;
-function parseToolMetrics(content) {
-  const lines = content.split("\n");
-  const metrics = [];
-  let inSection = false;
-  let inTable = false;
-  for (const line of lines) {
-    if (line.startsWith(SECTION_HEADING)) {
-      inSection = true;
-      continue;
-    }
-    if (inSection && line.startsWith(COST_SECTION_HEADING)) {
-      break;
-    }
-    if (!inSection) continue;
-    if (line.startsWith(TABLE_SEPARATOR) || line.startsWith("|---")) {
-      inTable = true;
-      continue;
-    }
-    if (!inTable) continue;
-    if (!line.startsWith("|")) {
-      inTable = false;
-      continue;
-    }
-    const cells = line.split("|").map((c) => c.trim()).filter(Boolean);
-    if (cells.length < 7) continue;
-    const inputTokens = cells[3] !== "-" ? parseInt(cells[3].replace(/,/g, ""), 10) : void 0;
-    const outputTokens = cells[4] !== "-" ? parseInt(cells[4].replace(/,/g, ""), 10) : void 0;
-    const cost = cells[5] !== "-" ? parseFloat(cells[5]) : void 0;
-    const model = cells[6] !== "-" ? cells[6] : void 0;
-    const cycleRaw = cells.length >= 8 && cells[7] !== "-" ? parseInt(cells[7], 10) : void 0;
-    const cycleNumber = cycleRaw !== void 0 && !isNaN(cycleRaw) ? cycleRaw : void 0;
-    const contextRaw = cells.length >= 9 && cells[8] !== "-" ? parseInt(cells[8].replace(/,/g, ""), 10) : void 0;
-    const contextBytes = contextRaw !== void 0 && !isNaN(contextRaw) ? contextRaw : void 0;
-    const utilisationRaw = cells.length >= 10 && cells[9] !== "-" ? parseFloat(cells[9]) : void 0;
-    const contextUtilisation = utilisationRaw !== void 0 && !isNaN(utilisationRaw) ? utilisationRaw : void 0;
-    metrics.push({
-      timestamp: cells[0],
-      tool: cells[1],
-      durationMs: parseInt(cells[2].replace(/,/g, ""), 10),
-      ...inputTokens !== void 0 && !isNaN(inputTokens) ? { inputTokens } : {},
-      ...outputTokens !== void 0 && !isNaN(outputTokens) ? { outputTokens } : {},
-      ...cost !== void 0 && !isNaN(cost) ? { estimatedCostUsd: cost } : {},
-      ...model ? { model } : {},
-      ...cycleNumber !== void 0 ? { cycleNumber } : {},
-      ...contextBytes !== void 0 ? { contextBytes } : {},
-      ...contextUtilisation !== void 0 ? { contextUtilisation } : {}
-    });
+// src/adapter-factory.ts
+function detectUserId() {
+  try {
+    const email = execSync("git config user.email", { encoding: "utf8", timeout: 5e3 }).trim();
+    if (email) return email;
+  } catch {
   }
-  return metrics;
-}
-function formatNumber(n) {
-  return n.toLocaleString("en-US");
-}
-function serializeToolMetric(metric) {
-  const inputTokens = metric.inputTokens !== void 0 ? formatNumber(metric.inputTokens) : "-";
-  const outputTokens = metric.outputTokens !== void 0 ? formatNumber(metric.outputTokens) : "-";
-  const cost = metric.estimatedCostUsd !== void 0 ? metric.estimatedCostUsd.toFixed(4) : "-";
-  const model = metric.model ?? "-";
-  const cycle = metric.cycleNumber !== void 0 ? String(metric.cycleNumber) : "-";
-  const context = metric.contextBytes !== void 0 ? formatNumber(metric.contextBytes) : "-";
-  const utilisation = metric.contextUtilisation !== void 0 ? metric.contextUtilisation.toFixed(2) : "-";
-  return `| ${metric.timestamp} | ${metric.tool} | ${formatNumber(metric.durationMs)} | ${inputTokens} | ${outputTokens} | ${cost} | ${model} | ${cycle} | ${context} | ${utilisation} |`;
-}
-function appendToolMetricToContent(metric, content) {
-  if (!content.trim()) {
-    return FILE_TEMPLATE + serializeToolMetric(metric) + "\n";
+  try {
+    const ghUser = execSync("gh api user --jq .email", { encoding: "utf8", timeout: 1e4 }).trim();
+    if (ghUser && ghUser !== "null") return ghUser;
+  } catch {
   }
-  if (content.includes(LEGACY_TABLE_HEADER) && !content.includes(TABLE_HEADER)) {
-    content = content.replace(LEGACY_TABLE_HEADER, TABLE_HEADER);
-    content = content.replace(
-      /\|[-]+\|[-]+\|[-]+\|[-]+\|[-]+\|[-]+\|[-]+\|/,
-      TABLE_SEPARATOR
+  return void 0;
+}
+var HOSTED_SUPABASE_URL2 = process.env["PAPI_HOSTED_SUPABASE_URL"] ?? "https://guewgygcpcmrcoppihzx.supabase.co";
+var HOSTED_PROXY_ENDPOINT = `${HOSTED_SUPABASE_URL2}/functions/v1/data-proxy`;
+var PLACEHOLDER_PATTERNS = [
+  "<YOUR_DATABASE_URL>",
+  "your-database-url",
+  "your_database_url",
+  "placeholder",
+  "example.com",
+  "localhost:5432/dbname",
+  "user:password@host"
+];
+function validateDatabaseUrl(connectionString) {
+  const lower = connectionString.toLowerCase().trim();
+  if (PLACEHOLDER_PATTERNS.some((p) => lower.includes(p.toLowerCase()))) {
+    throw new Error(
+      "DATABASE_URL contains a placeholder value and is not configured.\nReplace it with your actual Supabase connection string in .mcp.json.\nIf you don't have one yet, contact the PAPI admin for access."
     );
   }
-  if (content.includes(PREV_TABLE_HEADER) && !content.includes(TABLE_HEADER)) {
-    content = content.replace(PREV_TABLE_HEADER, TABLE_HEADER);
-    content = content.replace(
-      /\|[-]+\|[-]+\|[-]+\|[-]+\|[-]+\|[-]+\|[-]+\|[-]+\|/,
-      TABLE_SEPARATOR
-    );
-  }
-  if (!content.includes(SECTION_HEADING)) {
-    return content.trimEnd() + "\n\n" + SECTION_HEADING + "\n\n" + TABLE_HEADER + "\n" + TABLE_SEPARATOR + "\n" + serializeToolMetric(metric) + "\n";
-  }
-  const costIdx = content.indexOf(COST_SECTION_HEADING);
-  if (costIdx === -1) {
-    return content.trimEnd() + "\n" + serializeToolMetric(metric) + "\n";
-  }
-  const before = content.slice(0, costIdx).trimEnd();
-  const after = content.slice(costIdx);
-  return before + "\n" + serializeToolMetric(metric) + "\n\n" + after;
-}
-function aggregateCostSummary(metrics, cycleNumber) {
-  const filtered = cycleNumber !== void 0 ? metrics.filter((m) => m.cycleNumber === cycleNumber) : metrics;
-  let totalCostUsd = 0;
-  let totalInputTokens = 0;
-  let totalOutputTokens = 0;
-  const byCommand = /* @__PURE__ */ new Map();
-  for (const m of filtered) {
-    totalCostUsd += m.estimatedCostUsd ?? 0;
-    totalInputTokens += m.inputTokens ?? 0;
-    totalOutputTokens += m.outputTokens ?? 0;
-    const entry = byCommand.get(m.tool) ?? { cost: 0, calls: 0 };
-    entry.cost += m.estimatedCostUsd ?? 0;
-    entry.calls += 1;
-    byCommand.set(m.tool, entry);
-  }
-  const costByCommand = Array.from(byCommand.entries()).map(([command, { cost, calls }]) => ({
-    command,
-    totalCostUsd: cost,
-    calls,
-    avgCostUsd: calls > 0 ? cost / calls : 0
-  })).sort((a, b) => b.totalCostUsd - a.totalCostUsd);
-  const mostExpensiveCommand = costByCommand.length > 0 ? costByCommand[0].command : null;
-  return {
-    totalCostUsd,
-    totalInputTokens,
-    totalOutputTokens,
-    totalCalls: filtered.length,
-    costByCommand,
-    mostExpensiveCommand,
-    avgCostPerCall: filtered.length > 0 ? totalCostUsd / filtered.length : 0
-  };
-}
-var COST_SECTION_HEADING = "## Cost Summary";
-var COST_TABLE_SEPARATOR = "|--------|------|----------------|--------------|---------------|-------|";
-function parseCostSnapshots(content) {
-  const lines = content.split("\n");
-  const snapshots = [];
-  let inTable = false;
-  for (const line of lines) {
-    if (line.startsWith(COST_TABLE_SEPARATOR)) {
-      inTable = true;
-      continue;
-    }
-    if (!inTable) continue;
-    if (!line.startsWith("|")) {
-      inTable = false;
-      continue;
-    }
-    const cells = line.split("|").map((c) => c.trim()).filter(Boolean);
-    if (cells.length < 6) continue;
-    snapshots.push({
-      cycle: parseInt(cells[0], 10),
-      date: cells[1],
-      totalCostUsd: parseFloat(cells[2]),
-      totalInputTokens: parseInt(cells[3].replace(/,/g, ""), 10),
-      totalOutputTokens: parseInt(cells[4].replace(/,/g, ""), 10),
-      totalCalls: parseInt(cells[5].replace(/,/g, ""), 10)
-    });
-  }
-  return snapshots;
-}
-var FILE_HEADING = "# Cycle Methodology Metrics";
-var ACCURACY_HEADER = "| Cycle | Reports | Match Rate | MAE | Bias |";
-var ACCURACY_SEPARATOR = "|--------|---------|------------|-----|------|";
-var VELOCITY_HEADER = "| Cycle | Completed | Partial | Failed | Effort Points |";
-var VELOCITY_SEPARATOR = "|--------|-----------|---------|--------|---------------|";
-var EFFORT_SCALE = {
-  XS: 1,
-  S: 2,
-  M: 3,
-  L: 4,
-  XL: 5
-};
-function effortOrdinal(effort) {
-  if (typeof effort !== "string") return void 0;
-  const normalized = effort.trim().toUpperCase();
-  return EFFORT_SCALE[normalized];
-}
-function isUnparsedEffort(effort) {
-  if (typeof effort !== "string" || effort.trim().length === 0) return false;
-  return effortOrdinal(effort) === void 0;
-}
-function calculateCycleMetrics(reports, currentCycle, window = 5) {
-  const recentReports = reports.filter(
-    (r) => r.cycle > currentCycle - window && r.cycle <= currentCycle
-  );
-  const unparsedEffortCount = recentReports.filter(
-    (r) => isUnparsedEffort(r.actualEffort) || isUnparsedEffort(r.estimatedEffort)
-  ).length;
-  const perCycle = /* @__PURE__ */ new Map();
-  for (const r of recentReports) {
-    const group = perCycle.get(r.cycle) ?? [];
-    group.push(r);
-    perCycle.set(r.cycle, group);
-  }
-  const accuracy = [];
-  const velocity = [];
-  const sortedCycles = [...perCycle.keys()].sort((a, b) => a - b);
-  for (const cycle of sortedCycles) {
-    const reps = perCycle.get(cycle);
-    const deltas = [];
-    for (const r of reps) {
-      const actual = effortOrdinal(r.actualEffort);
-      const estimated = effortOrdinal(r.estimatedEffort);
-      if (actual !== void 0 && estimated !== void 0) {
-        deltas.push(actual - estimated);
-      }
-    }
-    if (deltas.length > 0) {
-      accuracy.push({
-        cycle,
-        reports: deltas.length,
-        matchRate: Math.round(deltas.filter((d) => d === 0).length / deltas.length * 100),
-        mae: Math.round(deltas.reduce((s, d) => s + Math.abs(d), 0) / deltas.length * 10) / 10,
-        bias: Math.round(deltas.reduce((s, d) => s + d, 0) / deltas.length * 10) / 10
-      });
-    }
-    velocity.push({
-      cycle,
-      completed: reps.filter((r) => r.completed === "Yes").length,
-      partial: reps.filter((r) => r.completed === "Partial").length,
-      failed: reps.filter((r) => r.completed === "No").length,
-      effortPoints: reps.reduce((s, r) => s + (effortOrdinal(r.actualEffort) ?? 0), 0)
-    });
-  }
-  return { accuracy, velocity, unparsedEffortCount };
-}
-function serializeAccuracyRow(a) {
-  return `| ${a.cycle} | ${a.reports} | ${a.matchRate}% | ${a.mae} | ${a.bias >= 0 ? "+" : ""}${a.bias} |`;
-}
-function serializeVelocityRow(v) {
-  return `| ${v.cycle} | ${v.completed} | ${v.partial} | ${v.failed} | ${v.effortPoints} |`;
-}
-function serializeSnapshot(snapshot) {
-  const lines = [];
-  lines.push(`## Cycle ${snapshot.cycle} Snapshot \u2014 ${snapshot.date}`);
-  lines.push("");
-  lines.push("### Estimation Accuracy (last 5 cycles)");
-  lines.push(ACCURACY_HEADER);
-  lines.push(ACCURACY_SEPARATOR);
-  for (const a of snapshot.accuracy) {
-    lines.push(serializeAccuracyRow(a));
-  }
-  lines.push("");
-  lines.push("### Cycle Velocity");
-  lines.push(VELOCITY_HEADER);
-  lines.push(VELOCITY_SEPARATOR);
-  for (const v of snapshot.velocity) {
-    lines.push(serializeVelocityRow(v));
-  }
-  return lines.join("\n");
-}
-function appendSnapshotToContent(snapshot, content) {
-  const block = serializeSnapshot(snapshot);
-  if (!content.trim()) {
-    return FILE_HEADING + "\n\n" + block + "\n";
-  }
-  const marker = `## Cycle ${snapshot.cycle} Snapshot`;
-  const legacyMarker = `## Sprint ${snapshot.cycle} Snapshot`;
-  let markerIdx = content.indexOf(marker);
-  if (markerIdx === -1) markerIdx = content.indexOf(legacyMarker);
-  if (markerIdx !== -1) {
-    let nextSnapshotIdx = content.indexOf("\n## Cycle ", markerIdx + marker.length);
-    if (nextSnapshotIdx === -1) nextSnapshotIdx = content.indexOf("\n## Sprint ", markerIdx + marker.length);
-    const before = content.slice(0, markerIdx).trimEnd();
-    const after = nextSnapshotIdx !== -1 ? content.slice(nextSnapshotIdx) : "";
-    return before + "\n\n" + block + (after ? after : "\n");
-  }
-  return content.trimEnd() + "\n\n" + block + "\n";
-}
-function parseSnapshots(content) {
-  if (!content.trim()) return [];
-  const snapshots = [];
-  const headerRegex = /^## (?:Cycle|Sprint) (\d+) Snapshot — (\S+)/gm;
-  let match;
-  const headers = [];
-  while ((match = headerRegex.exec(content)) !== null) {
-    headers.push({
-      cycle: parseInt(match[1], 10),
-      date: match[2],
-      index: match.index
-    });
-  }
-  for (let i = 0; i < headers.length; i++) {
-    const start = headers[i].index;
-    const end = i + 1 < headers.length ? headers[i + 1].index : content.length;
-    const block = content.slice(start, end);
-    const accuracy = parseAccuracyTable(block);
-    const velocity = parseVelocityTable(block);
-    snapshots.push({
-      cycle: headers[i].cycle,
-      date: headers[i].date,
-      accuracy,
-      velocity
-    });
-  }
-  return snapshots;
-}
-function parseAccuracyTable(block) {
-  const rows = [];
-  const lines = block.split("\n");
-  let inTable = false;
-  for (const line of lines) {
-    if (line.startsWith(ACCURACY_SEPARATOR)) {
-      inTable = true;
-      continue;
-    }
-    if (!inTable) continue;
-    if (!line.startsWith("|")) {
-      inTable = false;
-      continue;
-    }
-    const cells = line.split("|").map((c) => c.trim()).filter(Boolean);
-    if (cells.length < 5) continue;
-    rows.push({
-      cycle: parseInt(cells[0], 10),
-      reports: parseInt(cells[1], 10),
-      matchRate: parseInt(cells[2].replace("%", ""), 10),
-      mae: parseFloat(cells[3]),
-      bias: parseFloat(cells[4])
-    });
-  }
-  return rows;
-}
-function parseVelocityTable(block) {
-  const rows = [];
-  const lines = block.split("\n");
-  let inTable = false;
-  for (const line of lines) {
-    if (line.startsWith(VELOCITY_SEPARATOR)) {
-      inTable = true;
-      continue;
-    }
-    if (!inTable) continue;
-    if (!line.startsWith("|")) {
-      inTable = false;
-      continue;
-    }
-    const cells = line.split("|").map((c) => c.trim()).filter(Boolean);
-    if (cells.length < 5) continue;
-    rows.push({
-      cycle: parseInt(cells[0], 10),
-      completed: parseInt(cells[1], 10),
-      partial: parseInt(cells[2], 10),
-      failed: parseInt(cells[3], 10),
-      effortPoints: parseInt(cells[4], 10)
-    });
-  }
-  return rows;
-}
-var HEADER_SENTINEL2 = "*Reviews are stored newest-first.";
-var VALID_STAGES = /* @__PURE__ */ new Set(["handoff-review", "build-acceptance"]);
-var VALID_VERDICTS = /* @__PURE__ */ new Set(["approve", "accept", "request-changes", "reject"]);
-function parseField2(block, field) {
-  const pattern = new RegExp(`^- \\*\\*${field}:\\*\\*\\s*(.+)$`, "m");
-  const match = block.match(pattern);
-  return match ? match[1].trim() : "";
-}
-function parseReviews(content) {
-  if (!content.trim()) return [];
-  const chunks = content.split(/^(?=### task-\S+ — .+ — \d{4}-\d{2}-\d{2})/m).map((c) => c.trim()).filter((c) => c.match(/^### task-\S+ — .+ — \d{4}-\d{2}-\d{2}/));
-  return chunks.map((block) => {
-    const headingMatch = block.match(/^### (task-\S+) — (.+?) — (\d{4}-\d{2}-\d{2}[T\d:.Z]*)/);
-    if (!headingMatch) return null;
-    const taskId = headingMatch[1];
-    const stageRaw = headingMatch[2].trim();
-    const date = headingMatch[3];
-    const stage = stageRaw.toLowerCase().replace(/\s+/g, "-");
-    if (!VALID_STAGES.has(stage)) return null;
-    const reviewer = parseField2(block, "Reviewer");
-    const verdictRaw = parseField2(block, "Verdict");
-    if (!VALID_VERDICTS.has(verdictRaw)) return null;
-    const verdict = verdictRaw;
-    const cycle = parseInt(parseField2(block, "Cycle"), 10);
-    if (isNaN(cycle)) return null;
-    const comments = parseField2(block, "Comments");
-    const uuidRaw = parseField2(block, "UUID");
-    const displayIdRaw = parseField2(block, "Display ID");
-    const review = { uuid: uuidRaw ?? randomUUID5(), ...displayIdRaw ? { displayId: displayIdRaw } : {}, taskId, stage, reviewer, verdict, cycle, date, comments };
-    const handoffRevRaw = parseField2(block, "Handoff Revision");
-    if (handoffRevRaw) {
-      const parsed = parseInt(handoffRevRaw, 10);
-      if (!isNaN(parsed)) review.handoffRevision = parsed;
-    }
-    const buildCommitSha = parseField2(block, "Build Commit SHA");
-    if (buildCommitSha) review.buildCommitSha = buildCommitSha;
-    return review;
-  }).filter((r) => r !== null);
-}
-var STAGE_DISPLAY = {
-  "handoff-review": "Handoff Review",
-  "build-acceptance": "Build Acceptance"
-};
-function serializeReview(review) {
-  const stageDisplay = STAGE_DISPLAY[review.stage];
-  const lines = [
-    `### ${review.taskId} \u2014 ${stageDisplay} \u2014 ${review.date}`,
-    ""
-  ];
-  if (review.uuid) lines.push(`- **UUID:** ${review.uuid}`);
-  if (review.displayId) lines.push(`- **Display ID:** ${review.displayId}`);
-  lines.push(
-    `- **Reviewer:** ${review.reviewer}`,
-    `- **Verdict:** ${review.verdict}`,
-    `- **Cycle:** ${review.cycle}`,
-    `- **Comments:** ${review.comments}`
-  );
-  if (review.handoffRevision !== void 0) lines.push(`- **Handoff Revision:** ${review.handoffRevision}`);
-  if (review.buildCommitSha) lines.push(`- **Build Commit SHA:** ${review.buildCommitSha}`);
-  if (review.autoReview) {
-    lines.push("", `#### Auto-Review (${review.autoReview.verdict})`);
-    lines.push(`> ${review.autoReview.summary}`);
-    if (review.autoReview.findings.length > 0) {
-      lines.push("");
-      for (const f of review.autoReview.findings) {
-        const loc = f.file ? f.line ? `${f.file}:${f.line}` : f.file : "";
-        lines.push(`- \`${f.severity}\`${loc ? ` ${loc}` : ""}: ${f.message}`);
-      }
-    }
-  }
-  return lines.join("\n");
-}
-function prependReview(review, content) {
-  const serialized = serializeReview(review);
-  if (!content.trim()) {
-    return `# Human Reviews
-
-${HEADER_SENTINEL2} Each review block references a task and stage.*
-
----
-
-${serialized}
-`;
-  }
-  const sentinelIdx = content.indexOf(HEADER_SENTINEL2);
-  if (sentinelIdx === -1) {
-    const firstSep = content.indexOf("\n---\n");
-    if (firstSep === -1) return content.trimEnd() + "\n\n---\n\n" + serialized + "\n";
-    const insertAt2 = firstSep + "\n---\n".length;
-    return content.slice(0, insertAt2) + "\n" + serialized + "\n\n---\n" + content.slice(insertAt2);
-  }
-  const afterSentinel = content.slice(sentinelIdx);
-  const separatorIdx = afterSentinel.indexOf("\n---\n");
-  if (separatorIdx === -1) {
-    return content.trimEnd() + "\n\n---\n\n" + serialized + "\n";
-  }
-  const insertAt = sentinelIdx + separatorIdx + "\n---\n".length;
-  return content.slice(0, insertAt) + "\n" + serialized + "\n\n---\n" + content.slice(insertAt);
-}
-var VALID_STATUSES = /* @__PURE__ */ new Set(["Not Started", "In Progress", "Done", "Deferred"]);
-var PHASES_START = "<!-- PHASES:START -->";
-var PHASES_END = "<!-- PHASES:END -->";
-function parsePhases(content) {
-  const startIdx = content.indexOf(PHASES_START);
-  const endIdx = content.indexOf(PHASES_END);
-  if (startIdx === -1 || endIdx === -1 || endIdx <= startIdx) return [];
-  const section = content.slice(startIdx + PHASES_START.length, endIdx);
-  const yamlMatch = section.match(/```yaml\s*\n([\s\S]*?)```/);
-  if (!yamlMatch) return [];
-  const yamlBody = yamlMatch[1];
-  const phases = [];
-  const blocks = yamlBody.split(/^(?=\s*- id:)/m).filter((b) => b.trim());
-  for (const block of blocks) {
-    const phase = parsePhaseBlock(block);
-    if (phase) phases.push(phase);
-  }
-  return phases.sort((a, b) => a.order - b.order);
-}
-function parseYamlField(block, field) {
-  const pattern = new RegExp(`^\\s*${field}:\\s*(.+)$`, "m");
-  const match = block.match(pattern);
-  if (!match) return "";
-  let value = match[1].trim();
-  if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
-    value = value.slice(1, -1);
-  }
-  return value;
-}
-function parsePhaseBlock(block) {
-  const idMatch = block.match(/^\s*- id:\s*(\S+)/m);
-  if (!idMatch) return null;
-  const id = idMatch[1];
-  const slug = parseYamlField(block, "slug");
-  const label = parseYamlField(block, "label");
-  const description = parseYamlField(block, "description");
-  const statusRaw = parseYamlField(block, "status");
-  const orderRaw = parseYamlField(block, "order");
-  if (!slug || !label || !statusRaw || !orderRaw) return null;
-  const status = statusRaw;
-  if (!VALID_STATUSES.has(status)) return null;
-  const order = parseInt(orderRaw, 10);
-  if (isNaN(order)) return null;
-  return { id, slug, label, description, status, order };
-}
-function serializePhases(phases) {
-  const sorted = [...phases].sort((a, b) => a.order - b.order);
-  const yamlLines = ["phases:"];
-  for (const p of sorted) {
-    yamlLines.push(`  - id: ${p.id}`);
-    yamlLines.push(`    slug: "${p.slug}"`);
-    yamlLines.push(`    label: "${p.label}"`);
-    yamlLines.push(`    description: "${p.description}"`);
-    yamlLines.push(`    status: "${p.status}"`);
-    yamlLines.push(`    order: ${p.order}`);
-  }
-  return yamlLines.join("\n");
-}
-var YAML_MARKER2 = "<!-- PAPI-ADAPTER: parse the yaml block below -->";
-var YAML_START2 = "<!-- PAPI-YAML-START -->";
-var YAML_END2 = "<!-- PAPI-YAML-END -->";
-var VALID_STATUSES2 = /* @__PURE__ */ new Set(["planning", "active", "complete"]);
-function toCycle(raw) {
-  if (!VALID_STATUSES2.has(raw.status)) return null;
-  const cycle = {
-    id: raw.id,
-    number: raw.number,
-    status: raw.status,
-    startDate: raw.start_date,
-    goals: raw.goals ?? [],
-    boardHealth: raw.board_health ?? "",
-    taskIds: raw.task_ids ?? []
-  };
-  if (raw.end_date) cycle.endDate = raw.end_date;
-  if (raw.user_id) cycle.userId = raw.user_id;
-  if (raw.dependency_chain) cycle.dependencyChain = raw.dependency_chain;
-  return cycle;
-}
-function fromCycle(cycle) {
-  const raw = {
-    id: cycle.id,
-    number: cycle.number,
-    status: cycle.status,
-    start_date: cycle.startDate,
-    goals: cycle.goals,
-    board_health: cycle.boardHealth,
-    task_ids: cycle.taskIds
-  };
-  if (cycle.endDate) raw.end_date = cycle.endDate;
-  if (cycle.userId) raw.user_id = cycle.userId;
-  if (cycle.dependencyChain) raw.dependency_chain = cycle.dependencyChain;
-  return raw;
-}
-function extractYamlBlock2(content) {
-  const markerIdx = content.indexOf(YAML_MARKER2);
-  if (markerIdx === -1) throw new Error("PAPI-ADAPTER marker not found in CYCLES.md");
-  const afterMarker = content.slice(markerIdx + YAML_MARKER2.length);
-  const startIdx = afterMarker.indexOf(YAML_START2);
-  if (startIdx === -1) throw new Error("PAPI-YAML-START marker not found in CYCLES.md");
-  const yamlStart = startIdx + YAML_START2.length;
-  const endIdx = afterMarker.indexOf(YAML_END2, yamlStart);
-  if (endIdx === -1) throw new Error("PAPI-YAML-END marker not found in CYCLES.md");
-  return afterMarker.slice(yamlStart, endIdx);
-}
-function parseCycles(content) {
-  if (!content.trim()) return [];
-  const yamlText = extractYamlBlock2(content);
-  const data = yaml2.load(yamlText);
-  return (data.cycles ?? []).map(toCycle).filter((s) => s !== null);
-}
-function serializeCycles(cycles, content) {
-  const raw = cycles.map(fromCycle);
-  const yamlStr = yaml2.dump({ cycles: raw }, { lineWidth: 120, quotingType: '"' });
-  const markerIdx = content.indexOf(YAML_MARKER2);
-  if (markerIdx === -1) throw new Error("PAPI-ADAPTER marker not found in CYCLES.md");
-  const afterMarker = content.slice(markerIdx + YAML_MARKER2.length);
-  const startIdx = afterMarker.indexOf(YAML_START2);
-  if (startIdx === -1) throw new Error("PAPI-YAML-START marker not found in CYCLES.md");
-  const absStart = markerIdx + YAML_MARKER2.length + startIdx;
-  const endIdx = afterMarker.indexOf(YAML_END2, startIdx);
-  if (endIdx === -1) throw new Error("PAPI-YAML-END marker not found in CYCLES.md");
-  const absEnd = markerIdx + YAML_MARKER2.length + endIdx + YAML_END2.length;
-  return content.slice(0, absStart) + YAML_START2 + "\n" + yamlStr + YAML_END2 + content.slice(absEnd);
-}
-function prependCycle(cycle, content) {
-  if (!content.trim()) {
-    const header = `# Cycles
-
-<!-- PAPI-ADAPTER: parse the yaml block below -->
-
-`;
-    const raw = fromCycle(cycle);
-    const yamlStr = yaml2.dump({ cycles: [raw] }, { lineWidth: 120, quotingType: '"' });
-    return header + YAML_START2 + "\n" + yamlStr + YAML_END2 + "\n";
-  }
-  const existing = parseCycles(content).filter((c) => c.number !== cycle.number);
-  const merged = [cycle, ...existing];
-  return serializeCycles(merged, content);
-}
-var YAML_MARKER3 = "<!-- PAPI-ADAPTER: parse the yaml block below -->";
-var YAML_START3 = "<!-- PAPI-YAML-START -->";
-var YAML_END3 = "<!-- PAPI-YAML-END -->";
-function extractYamlBlock3(content) {
-  const markerIdx = content.indexOf(YAML_MARKER3);
-  if (markerIdx === -1) throw new Error("PAPI-ADAPTER marker not found in REGISTRIES.md");
-  const afterMarker = content.slice(markerIdx + YAML_MARKER3.length);
-  const startIdx = afterMarker.indexOf(YAML_START3);
-  if (startIdx === -1) throw new Error("PAPI-YAML-START marker not found in REGISTRIES.md");
-  const yamlStart = startIdx + YAML_START3.length;
-  const endIdx = afterMarker.indexOf(YAML_END3, yamlStart);
-  if (endIdx === -1) throw new Error("PAPI-YAML-END marker not found in REGISTRIES.md");
-  return afterMarker.slice(yamlStart, endIdx);
-}
-function parseRegistries(content) {
-  if (!content.trim()) return { modules: [], epics: [] };
-  const yamlText = extractYamlBlock3(content);
-  const data = yaml3.load(yamlText);
-  return {
-    modules: data.modules ?? [],
-    epics: data.epics ?? []
-  };
-}
-function serializeRegistries(registries, content) {
-  const yamlStr = yaml3.dump(
-    { modules: registries.modules, epics: registries.epics },
-    { lineWidth: 120, quotingType: '"' }
-  );
-  const markerIdx = content.indexOf(YAML_MARKER3);
-  if (markerIdx === -1) throw new Error("PAPI-ADAPTER marker not found in REGISTRIES.md");
-  const afterMarker = content.slice(markerIdx + YAML_MARKER3.length);
-  const startIdx = afterMarker.indexOf(YAML_START3);
-  if (startIdx === -1) throw new Error("PAPI-YAML-START marker not found in REGISTRIES.md");
-  const absStart = markerIdx + YAML_MARKER3.length + startIdx;
-  const endIdx = afterMarker.indexOf(YAML_END3, startIdx);
-  if (endIdx === -1) throw new Error("PAPI-YAML-END marker not found in REGISTRIES.md");
-  const absEnd = markerIdx + YAML_MARKER3.length + endIdx + YAML_END3.length;
-  return content.slice(0, absStart) + YAML_START3 + "\n" + yamlStr + YAML_END3 + content.slice(absEnd);
-}
-function displayIdNumber(displayId, prefix) {
-  if (!displayId) return 0;
-  const match = displayId.match(new RegExp(`^${prefix}-(\\d+)$`));
-  return match ? parseInt(match[1], 10) : 0;
-}
-var MdFileAdapter = class {
-  dir;
-  constructor(projectDir) {
-    this.dir = projectDir;
-  }
-  /** Resolve a filename to an absolute path within the .papi/ directory. */
-  path(file) {
-    return join(this.dir, file);
-  }
-  /** Read a .papi/ file as UTF-8 text. Throws a clear error if the file is missing. */
-  async read(file) {
-    try {
-      return await readFile(this.path(file), "utf-8");
-    } catch (err) {
-      if (err instanceof Error && "code" in err && err.code === "ENOENT") {
-        throw new Error(`.papi/${file} not found. Run the setup tool to initialise your project.`);
-      }
-      throw err;
-    }
-  }
-  /** Write UTF-8 text to a .papi/ file. */
-  async write(file, content) {
-    await writeFile(this.path(file), content, "utf-8");
-  }
-  // --- Planning Log ---
-  /** Parse the full planning context into structured sections (reads from PLANNING_LOG.md + ACTIVE_DECISIONS.md + CYCLE_LOG.md). */
-  async readPlanningLog() {
-    const [planningContent, activeDecisionsContent, cycleLogContent] = await Promise.all([
-      this.read("PLANNING_LOG.md"),
-      this.readOptional("ACTIVE_DECISIONS.md"),
-      this.readOptional("SPRINT_LOG.md")
-    ]);
-    return parsePlanningLog(planningContent, activeDecisionsContent, cycleLogContent);
-  }
-  /** Read the Cycle Health table from PLANNING_LOG.md. */
-  async getCycleHealth() {
-    return parseCycleHealth(await this.read("PLANNING_LOG.md"));
-  }
-  /**
-   * Read Active Decisions from ACTIVE_DECISIONS.md.
-   *
-   * Default filters out retired ADs (outcome ∈ abandoned/superseded/resolved or superseded=true).
-   * Pass { includeRetired: true } for management/triage surfaces. See PapiAdapter docstring.
-   */
-  async getActiveDecisions(options) {
-    const content = await this.readOptional("ACTIVE_DECISIONS.md");
-    if (!content) return [];
-    const all = parseActiveDecisions(content);
-    if (options?.includeRetired) return all;
-    return all.filter(isLiveDecision);
-  }
-  /** Read cycle log entries (newest first), optionally limited to {@link limit} entries. */
-  async getCycleLog(limit) {
-    return parseCycleLog(await this.read("SPRINT_LOG.md"), limit);
-  }
-  async getCycleLogSince(cycleNumber) {
-    const log = await this.getCycleLog();
-    return log.filter((entry) => entry.cycleNumber >= cycleNumber);
-  }
-  /** Merge partial updates into the Cycle Health table and write back. */
-  async setCycleHealth(updates) {
-    const content = await this.read("PLANNING_LOG.md");
-    const current = parseCycleHealth(content);
-    const updated = { ...current, ...updates };
-    await this.write("PLANNING_LOG.md", serializeCycleHealth(updated, content));
-  }
-  /** Prepend a new cycle log entry at the top of the Cycle Log section. */
-  async writeCycleLogEntry(entry) {
-    const patched = {
-      ...entry,
-      uuid: entry.uuid || randomUUID6(),
-      date: entry.date ?? (/* @__PURE__ */ new Date()).toISOString()
-    };
-    const content = await this.read("SPRINT_LOG.md");
-    await this.write("SPRINT_LOG.md", prependCycleLogEntry(patched, content));
-  }
-  /** Write a strategy review — for md adapter, delegates to cycle log. */
-  async writeStrategyReview(review) {
-    await this.writeCycleLogEntry({
-      uuid: randomUUID6(),
-      cycleNumber: review.cycleNumber,
-      title: review.title,
-      content: review.content,
-      notes: review.notes
-    });
-  }
-  /**
-   * Get the cycle number of the last strategy review.
-   * task-2416 (C315): `excludeZoomOut` is accepted for interface parity with the pg
-   * adapter. The md adapter already matches strategy-review titles only (zoom-out logs
-   * carry a "Zoom-Out" title, not a strategy-review one), so the flag is a no-op here —
-   * legacy/best-effort path.
-   */
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  async getLastStrategyReviewCycle(_opts) {
-    const log = await this.getCycleLog();
-    const entry = log.find(
-      (e) => /strategy.*review|strategic.*shift/i.test(e.title)
-    );
-    return entry?.cycleNumber ?? 0;
-  }
-  /** task-2416 (C315): cycle of the last zoom-out retrospective. md best-effort — matches the log title. */
-  async getLastZoomOutCycle() {
-    const log = await this.getCycleLog();
-    const entry = log.find((e) => /zoom[-\s]?out/i.test(e.title));
-    return entry?.cycleNumber ?? 0;
-  }
-  /** Get strategy reviews — md adapter returns empty (reviews live in cycle log). */
-  async getStrategyReviews(_limit, _includeFullAnalysis) {
-    return [];
-  }
-  /** Update or insert an Active Decision block by ID. */
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  async updateActiveDecision(id, body, cycleNumber, _action) {
-    const content = await this.readOptional("ACTIVE_DECISIONS.md") || "## Active Decisions\n\n";
-    await this.write("ACTIVE_DECISIONS.md", updateActiveDecisionInContent(id, body, content, cycleNumber));
-  }
-  // --- Cycle Board ---
-  /** Query the cycle board, optionally filtering by status/priority/phase/etc. */
-  async queryBoard(options) {
-    const tasks = parseBoard(await this.read("SPRINT_BOARD.md"));
-    return options ? filterTasks(tasks, options) : tasks;
-  }
-  /** Look up a single task by ID, returning null if not found. */
-  async getTask(id) {
-    const tasks = parseBoard(await this.read("SPRINT_BOARD.md"));
-    const found = tasks.find((t) => t.id === id);
-    if (found) return found;
-    const archiveContent = await this.readOptional("ARCHIVE_SPRINT_BOARD.md");
-    if (!archiveContent) return null;
-    return parseBoard(archiveContent).find((t) => t.id === id) ?? null;
-  }
-  /** Look up multiple tasks by ID in a single board read. */
-  async getTasks(ids) {
-    const idSet = new Set(ids);
-    const tasks = parseBoard(await this.read("SPRINT_BOARD.md"));
-    return tasks.filter((t) => idSet.has(t.id));
-  }
-  /** Warn if a phase name doesn't match any known phase label from PRODUCT_BRIEF.md. */
-  async warnInvalidPhase(phase) {
-    const phases = await this.readPhases();
-    if (phases.length === 0) return;
-    const knownLabels = new Set(phases.map((p) => p.label));
-    if (!knownLabels.has(phase)) {
-      console.warn(`[papi] Warning: phase "${phase}" does not match any known phase. Valid phases: ${[...knownLabels].join(", ")}`);
-    }
-  }
-  /** Warn if a module name doesn't match any registered module in REGISTRIES.md. */
-  async warnInvalidModule(module) {
-    const registries = await this.readRegistries();
-    if (registries.modules.length === 0) return;
-    const known = new Set(registries.modules);
-    if (!known.has(module)) {
-      console.warn(`[papi] Warning: module "${module}" is not a registered module. Registered modules: ${registries.modules.join(", ")}`);
-    }
-  }
-  /** Warn if an epic name doesn't match any registered epic in REGISTRIES.md. */
-  async warnInvalidEpic(epic) {
-    const registries = await this.readRegistries();
-    if (registries.epics.length === 0) return;
-    const known = new Set(registries.epics);
-    if (!known.has(epic)) {
-      console.warn(`[papi] Warning: epic "${epic}" is not a registered epic. Registered epics: ${registries.epics.join(", ")}`);
-    }
-  }
-  /** Create a new task on the board with an auto-generated sequential ID. */
-  async createTask(task) {
-    const content = await this.read("SPRINT_BOARD.md");
-    const tasks = parseBoard(content);
-    const createdAt = task.createdAt ?? (/* @__PURE__ */ new Date()).toISOString();
-    const archiveContent = await this.readOptional("ARCHIVE_SPRINT_BOARD.md");
-    const archivedTasks = archiveContent ? parseBoard(archiveContent) : [];
-    await this.warnInvalidPhase(task.phase);
-    await this.warnInvalidModule(task.module);
-    if (task.epic) await this.warnInvalidEpic(task.epic);
-    if (task.dependsOn) {
-      const allTaskIds = new Set([...tasks, ...archivedTasks].map((t) => t.id));
-      const depIds = task.dependsOn.split(",").map((s) => s.trim()).filter(Boolean);
-      for (const depId of depIds) {
-        if (!allTaskIds.has(depId)) {
-          console.warn(`[papi] Warning: dependsOn references non-existent task "${depId}"`);
-        }
-      }
-    }
-    const uuid = task.uuid ?? randomUUID6();
-    const id = nextTaskId([...tasks, ...archivedTasks]);
-    const newTask = { ...task, uuid, createdAt, id, displayId: id };
-    if (newTask.buildHandoff) {
-      if (!newTask.buildHandoff.uuid) {
-        newTask.buildHandoff = { ...newTask.buildHandoff, uuid: randomUUID6() };
-      }
-      if (!newTask.buildHandoff.displayId) {
-        const maxNum = tasks.reduce((max, t) => Math.max(max, displayIdNumber(t.buildHandoff?.displayId, "ho")), 0);
-        newTask.buildHandoff = { ...newTask.buildHandoff, displayId: `ho-${maxNum + 1}` };
-      }
-    }
-    tasks.push(newTask);
-    await this.write("SPRINT_BOARD.md", serializeBoard(tasks, content));
-    return newTask;
-  }
-  /** Update one or more fields on an existing task. Throws if the task ID is not found. */
-  async updateTask(id, updates, options) {
-    const content = await this.read("SPRINT_BOARD.md");
-    const tasks = parseBoard(content);
-    const idx = tasks.findIndex((t) => t.id === id);
-    if (idx === -1) throw new Error(`Task ${id} not found`);
-    if (updates.phase && updates.phase !== tasks[idx].phase) {
-      await this.warnInvalidPhase(updates.phase);
-    }
-    if (updates.module && updates.module !== tasks[idx].module) {
-      await this.warnInvalidModule(updates.module);
-    }
-    if (updates.epic && updates.epic !== tasks[idx].epic) {
-      await this.warnInvalidEpic(updates.epic);
-    }
-    if (updates.status && updates.status !== tasks[idx].status && !options?.force) {
-      const from = tasks[idx].status;
-      const allowed = VALID_TRANSITIONS[from];
-      if (!allowed.includes(updates.status)) {
-        console.warn(`[papi] Warning: invalid status transition "${from}" \u2192 "${updates.status}" for task ${id}. Allowed from "${from}": ${allowed.length > 0 ? allowed.join(", ") : "none"}`);
-      }
-    }
-    if (updates.status && updates.status !== tasks[idx].status) {
-      const history = tasks[idx].stateHistory ?? [];
-      history.push({ status: updates.status, timestamp: (/* @__PURE__ */ new Date()).toISOString() });
-      updates = { ...updates, stateHistory: history };
-    }
-    if (updates.buildHandoff) {
-      let handoff = { ...updates.buildHandoff };
-      if (!handoff.uuid) handoff = { ...handoff, uuid: randomUUID6() };
-      if (!handoff.displayId) {
-        const maxNum = tasks.reduce((max, t) => Math.max(max, displayIdNumber(t.buildHandoff?.displayId, "ho")), 0);
-        handoff = { ...handoff, displayId: `ho-${maxNum + 1}` };
-      }
-      updates = { ...updates, buildHandoff: handoff };
-    }
-    tasks[idx] = { ...tasks[idx], ...updates };
-    await this.write("SPRINT_BOARD.md", serializeBoard(tasks, content));
-  }
-  /** Shorthand to update only the status field of a task. */
-  async updateTaskStatus(id, status) {
-    return this.updateTask(id, { status });
-  }
-  /**
-   * task-1763 (C293): atomic compare-and-swap task claim. First-claim-wins —
-   * sets assigneeId only if the task is currently unclaimed. The markdown adapter
-   * is single-process, so the read-check-write is trivially atomic here; the real
-   * concurrency guarantee lives in the pg adapter's RETURNING CAS. Returns the
-   * claimed task, or null if it was already claimed or does not exist.
-   *
-   * task-2071 (MU-3): the pooled-task invariant is `assigneeId == null && cycle
-   * == null` — a task already pulled into someone's cycle is NOT in the pool and
-   * cannot be claimed. Sets claimSource='pool' on success.
-   */
-  async claimTask(taskId, assigneeId) {
-    const content = await this.read("SPRINT_BOARD.md");
-    const tasks = parseBoard(content);
-    const idx = tasks.findIndex((t) => t.id === taskId);
-    if (idx === -1) return null;
-    if (tasks[idx].assigneeId || tasks[idx].cycle != null) return null;
-    tasks[idx] = { ...tasks[idx], assigneeId, claimSource: "pool" };
-    await this.write("SPRINT_BOARD.md", serializeBoard(tasks, content));
-    return tasks[idx];
-  }
-  /**
-   * task-2071 (C293, MU-3): claimer-only release. Clears assigneeId + claimSource
-   * only if the task is currently assigned to `assigneeId` and has not entered
-   * review. Returns the unclaimed task, or null if the caller is not the claimer,
-   * the task has progressed, or it does not exist.
-   */
-  async unclaimTask(taskId, assigneeId) {
-    const content = await this.read("SPRINT_BOARD.md");
-    const tasks = parseBoard(content);
-    const idx = tasks.findIndex((t2) => t2.id === taskId);
-    if (idx === -1) return null;
-    const t = tasks[idx];
-    if (t.assigneeId !== assigneeId) return null;
-    if (t.status === "In Review" || t.status === "Done") return null;
-    const next = { ...t };
-    delete next.assigneeId;
-    delete next.claimSource;
-    tasks[idx] = next;
-    await this.write("SPRINT_BOARD.md", serializeBoard(tasks, content));
-    return tasks[idx];
-  }
-  /**
-   * task-2072 (C293, MU-4): atomic review claim. Sets reviewerId only if the task
-   * is In Review and not yet claimed for review (reviewerId == null). First-claim-
-   * wins. Returns the claimed task, or null if already review-claimed / not In
-   * Review / missing.
-   */
-  async claimReview(taskId, reviewerId) {
-    const content = await this.read("SPRINT_BOARD.md");
-    const tasks = parseBoard(content);
-    const idx = tasks.findIndex((t2) => t2.id === taskId);
-    if (idx === -1) return null;
-    const t = tasks[idx];
-    if (t.status !== "In Review") return null;
-    if (t.reviewerId) return null;
-    tasks[idx] = { ...t, reviewerId };
-    await this.write("SPRINT_BOARD.md", serializeBoard(tasks, content));
-    return tasks[idx];
-  }
-  async recordTransition(_taskId, _fromStatus, _toStatus, _changedBy) {
-  }
-  // --- Build Reports ---
-  /** Insert a new build report at the top of BUILD_REPORTS.md. */
-  async appendBuildReport(report) {
-    const boardTasks = parseBoard(await this.read("SPRINT_BOARD.md"));
-    if (!boardTasks.some((t) => t.id === report.taskId)) {
-      const archiveContent = await this.readOptional("ARCHIVE_SPRINT_BOARD.md");
-      const archivedTasks = archiveContent ? parseBoard(archiveContent) : [];
-      if (!archivedTasks.some((t) => t.id === report.taskId)) {
-        console.warn(`[papi] Warning: BuildReport.taskId references non-existent task "${report.taskId}"`);
-      }
-    }
-    const content = await this.read("BUILD_REPORTS.md");
-    if (!report.uuid) {
-      report = { ...report, uuid: randomUUID6() };
-    }
-    if (!report.displayId) {
-      const existing = parseBuildReports(content);
-      const maxNum = existing.reduce((max, r) => Math.max(max, displayIdNumber(r.displayId, "br")), 0);
-      report = { ...report, displayId: `br-${maxNum + 1}` };
-    }
-    await this.write("BUILD_REPORTS.md", prependBuildReport(report, content));
-  }
-  /** Return the most recent {@link count} build reports. */
-  async getRecentBuildReports(count) {
-    const reports = parseBuildReports(await this.read("BUILD_REPORTS.md"));
-    return reports.slice(0, count);
-  }
-  /** Return the number of build reports for a specific task. */
-  async getBuildReportCountForTask(taskId) {
-    const reports = parseBuildReports(await this.read("BUILD_REPORTS.md"));
-    return reports.filter((r) => r.taskId === taskId).length;
-  }
-  /** Return all build reports from cycles >= {@link cycleNumber}. */
-  async getBuildReportsSince(cycleNumber) {
-    const reports = parseBuildReports(await this.read("BUILD_REPORTS.md"));
-    return reports.filter((r) => r.cycle >= cycleNumber);
-  }
-  // --- Human Reviews ---
-  /** Return recent human reviews from REVIEWS.md (newest first), optionally limited to {@link count}. */
-  async getRecentReviews(count) {
-    const content = await this.readOptional("REVIEWS.md");
-    if (!content) return [];
-    const reviews = parseReviews(content);
-    return count ? reviews.slice(0, count) : reviews;
-  }
-  /** Write a new human review to REVIEWS.md. */
-  async writeReview(review) {
-    const boardTasks = parseBoard(await this.read("SPRINT_BOARD.md"));
-    if (!boardTasks.some((t) => t.id === review.taskId)) {
-      const archiveContent = await this.readOptional("ARCHIVE_SPRINT_BOARD.md");
-      const archivedTasks = archiveContent ? parseBoard(archiveContent) : [];
-      if (!archivedTasks.some((t) => t.id === review.taskId)) {
-        console.warn(`[papi] Warning: HumanReview.taskId references non-existent task "${review.taskId}"`);
-      }
-    }
-    const content = await this.readOptional("REVIEWS.md");
-    if (!review.uuid) {
-      review = { ...review, uuid: randomUUID6() };
-    }
-    if (!review.displayId) {
-      const existing = content ? parseReviews(content) : [];
-      const maxNum = existing.reduce((max, r) => Math.max(max, displayIdNumber(r.displayId, "rv")), 0);
-      review = { ...review, displayId: `rv-${maxNum + 1}` };
-    }
-    await this.write("REVIEWS.md", prependReview(review, content));
-  }
-  // --- Compression ---
-  /** Compress old cycle log entries below {@link threshold} into a summary block. */
-  async compressCycleLog(threshold, summary) {
-    const content = await this.read("SPRINT_LOG.md");
-    await this.write("SPRINT_LOG.md", compressCycleLogInContent(content, threshold, summary));
-  }
-  /** Compress old build reports below {@link threshold} into a summary block. */
-  async compressBuildReports(threshold, summary) {
-    const content = await this.read("BUILD_REPORTS.md");
-    await this.write("BUILD_REPORTS.md", compressBuildReportsInContent(content, threshold, summary));
-  }
-  // --- Archival ---
-  /** Read a .papi/ file, returning empty string if it doesn't exist. */
-  async readOptional(file) {
-    try {
-      await access(this.path(file));
-      return readFile(this.path(file), "utf-8");
-    } catch (_err) {
-      return "";
-    }
-  }
-  /** Strip build_handoff and build_report from a task before archiving — these are already in BUILD_REPORTS.md. */
-  stripHeavyFields(task) {
-    const { buildHandoff, buildReport, ...rest } = task;
-    return rest;
-  }
-  /** Append tasks to ARCHIVE_CYCLE_BOARD.md, stripping heavy fields and deduplicating by ID. */
-  async appendToArchive(tasks) {
-    const existing = await this.readOptional("ARCHIVE_SPRINT_BOARD.md");
-    const archiveContent = existing || "# PAPI Cycle Board \u2014 Archive\n\n<!-- PAPI-ADAPTER: parse the yaml block below -->\n\n<!-- PAPI-YAML-START -->\ntasks: []\n<!-- PAPI-YAML-END -->\n";
-    const existingArchived = parseBoard(archiveContent);
-    const existingIds = new Set(existingArchived.map((t) => t.id));
-    const newArchive = tasks.filter((t) => !existingIds.has(t.id)).map((t) => this.stripHeavyFields(t));
-    const merged = [...existingArchived, ...newArchive];
-    await this.write("ARCHIVE_SPRINT_BOARD.md", serializeBoard(merged, archiveContent));
-  }
-  /** Archive tasks matching phases and/or statuses to ARCHIVE_CYCLE_BOARD.md and remove them from active board. */
-  async archiveTasks(phases, statuses) {
-    const content = await this.read("SPRINT_BOARD.md");
-    const tasks = parseBoard(content);
-    const phaseSet = new Set(phases.map((p) => p.toLowerCase()));
-    const statusSet = statuses ? new Set(statuses.map((s) => s.toLowerCase())) : null;
-    const keep = [];
-    const archive = [];
-    const hasPhaseFilter = phaseSet.size > 0;
-    const hasStatusFilter = statusSet !== null;
-    for (const task of tasks) {
-      const matchesPhase = hasPhaseFilter && phaseSet.has(task.phase.toLowerCase());
-      const matchesStatus = hasStatusFilter && statusSet.has(task.status.toLowerCase());
-      const shouldArchive = hasPhaseFilter && hasStatusFilter ? matchesPhase && matchesStatus : matchesPhase || matchesStatus;
-      if (shouldArchive) {
-        archive.push(task);
-      } else {
-        keep.push(task);
-      }
-    }
-    if (archive.length === 0) {
-      return { archivedCount: 0, taskIds: [] };
-    }
-    await this.appendToArchive(archive);
-    await this.write("SPRINT_BOARD.md", serializeBoard(keep, content));
-    return { archivedCount: archive.length, taskIds: archive.map((t) => t.id) };
-  }
-  // --- Product Brief ---
-  /** Read the raw PRODUCT_BRIEF.md content. */
-  async readProductBrief() {
-    return this.read("PRODUCT_BRIEF.md");
-  }
-  /** Overwrite PRODUCT_BRIEF.md with new content. */
-  async updateProductBrief(content) {
-    await this.write("PRODUCT_BRIEF.md", content);
-  }
-  async readDiscoveryCanvas() {
-    return {};
-  }
-  async updateDiscoveryCanvas(_canvas) {
-  }
-  /** Read all phases from PHASES.md (falls back to PRODUCT_BRIEF.md for migration). */
-  async readPhases() {
-    const phasesContent = await this.readOptional("PHASES.md");
-    if (phasesContent) return parsePhases(phasesContent);
-    const briefContent = await this.readOptional("PRODUCT_BRIEF.md");
-    return briefContent ? parsePhases(briefContent) : [];
-  }
-  /** Write phases to PHASES.md. */
-  async writePhases(phases) {
-    const content = await this.readOptional("PHASES.md");
-    const existing = content || "";
-    const yaml4 = serializePhases(phases);
-    const PHASES_START2 = "<!-- PHASES:START -->";
-    const PHASES_END2 = "<!-- PHASES:END -->";
-    const newSection = `${PHASES_START2}
-
-\`\`\`yaml
-${yaml4}
-\`\`\`
-
-${PHASES_END2}`;
-    const startIdx = existing.indexOf(PHASES_START2);
-    const endIdx = existing.indexOf(PHASES_END2);
-    if (startIdx !== -1 && endIdx !== -1) {
-      await this.write("PHASES.md", existing.slice(0, startIdx) + newSection + existing.slice(endIdx + PHASES_END2.length));
-    } else {
-      await this.write("PHASES.md", `# Phases
-
-${newSection}
-`);
-    }
-  }
-  // --- Tool Call Metrics ---
-  /** Append a tool call metric entry to METRICS.md. */
-  async appendToolMetric(metric) {
-    const content = await this.readOptional("METRICS.md");
-    await this.write("METRICS.md", appendToolMetricToContent(metric, content));
-  }
-  /** Read all tool call metrics from METRICS.md. */
-  async readToolMetrics() {
-    const content = await this.readOptional("METRICS.md");
-    if (!content) return [];
-    return parseToolMetrics(content);
-  }
-  async hasToolMilestone(name) {
-    const metrics = await this.readToolMetrics();
-    return metrics.some((m) => m.tool === name);
-  }
-  /** Aggregate tool call metrics into a cost summary, optionally filtered by cycle. */
-  async getCostSummary(cycleNumber) {
-    const metrics = await this.readToolMetrics();
-    return aggregateCostSummary(metrics, cycleNumber);
-  }
-  /** Read all cost snapshots from the Cost Summary section of METRICS.md. */
-  async getCostSnapshots() {
-    const content = await this.readOptional("METRICS.md");
-    if (!content) return [];
-    return parseCostSnapshots(content);
-  }
-  // --- Cycle Methodology Metrics ---
-  /** Append a cycle metrics snapshot to CYCLE_METRICS.md. */
-  async appendCycleMetrics(snapshot) {
-    const content = await this.readOptional("SPRINT_METRICS.md");
-    await this.write("SPRINT_METRICS.md", appendSnapshotToContent(snapshot, content));
-  }
-  /** Read all cycle metrics snapshots from CYCLE_METRICS.md. */
-  async readCycleMetrics() {
-    const content = await this.readOptional("SPRINT_METRICS.md");
-    if (!content) return [];
-    return parseSnapshots(content);
-  }
-  // --- Cycles ---
-  /** Read all Cycle entities from CYCLES.md (newest first). */
-  async readCycles() {
-    const content = await this.readOptional("CYCLES.md");
-    if (!content) return [];
-    return parseCycles(content);
-  }
-  /** Write a new Cycle entity to CYCLES.md. */
-  async createCycle(cycle) {
-    const content = await this.readOptional("CYCLES.md");
-    await this.write("CYCLES.md", prependCycle(cycle, content));
-  }
-  // --- Registries ---
-  /** Read module and epic registries from REGISTRIES.md. */
-  async readRegistries() {
-    const content = await this.readOptional("REGISTRIES.md");
-    if (!content) return { modules: [], epics: [] };
-    return parseRegistries(content);
-  }
-  /** Overwrite REGISTRIES.md with updated registries. */
-  async updateRegistries(registries) {
-    const content = await this.readOptional("REGISTRIES.md") || "# Registries\n\n<!-- PAPI-ADAPTER: parse the yaml block below -->\n\n<!-- PAPI-YAML-START -->\nmodules: []\nepics: []\n<!-- PAPI-YAML-END -->\n";
-    await this.write("REGISTRIES.md", serializeRegistries(registries, content));
-  }
-  // --- Strategy Recommendations ---
-  /**
-   * Write a new strategy recommendation to STRATEGY_RECOMMENDATIONS.md.
-   * File-based implementation stores as YAML entries.
-   */
-  async writeRecommendation(rec) {
-    const id = randomUUID6();
-    const full = { id, ...rec };
-    const content = await this.readOptional("STRATEGY_RECOMMENDATIONS.md");
-    const header = "# Strategy Recommendations\n\n<!-- PAPI-ADAPTER: parse the yaml block below -->\n\n<!-- PAPI-YAML-START -->\nrecommendations:\n";
-    const footer = "<!-- PAPI-YAML-END -->\n";
-    const entry = [
-      `  - id: ${full.id}`,
-      `    type: ${full.type}`,
-      `    status: ${full.status}`,
-      `    content: ${JSON.stringify(full.content)}`,
-      `    created_sprint: ${full.createdCycle}`,
-      full.actionedCycle != null ? `    actioned_cycle: ${full.actionedCycle}` : null,
-      full.target != null ? `    target: ${JSON.stringify(full.target)}` : null
-    ].filter(Boolean).join("\n");
-    if (!content) {
-      await this.write("STRATEGY_RECOMMENDATIONS.md", `${header}${entry}
-${footer}`);
-    } else {
-      const insertPoint = content.indexOf("<!-- PAPI-YAML-END -->");
-      if (insertPoint === -1) {
-        await this.write("STRATEGY_RECOMMENDATIONS.md", `${header}${entry}
-${footer}`);
-      } else {
-        const updated = content.slice(0, insertPoint) + entry + "\n" + content.slice(insertPoint);
-        await this.write("STRATEGY_RECOMMENDATIONS.md", updated);
-      }
-    }
-    return full;
-  }
-  /** Read all pending (unactioned) strategy recommendations. */
-  async getPendingRecommendations() {
-    const content = await this.readOptional("STRATEGY_RECOMMENDATIONS.md");
-    if (!content) return [];
-    const yamlStart = content.indexOf("<!-- PAPI-YAML-START -->");
-    const yamlEnd = content.indexOf("<!-- PAPI-YAML-END -->");
-    if (yamlStart === -1 || yamlEnd === -1) return [];
-    const yamlBlock = content.slice(yamlStart + "<!-- PAPI-YAML-START -->".length, yamlEnd).trim();
-    const entries = yamlBlock.split(/(?=\s+-\s+id:)/);
-    const recs = [];
-    for (const block of entries) {
-      const idMatch = block.match(/id:\s+(.+)/);
-      const typeMatch = block.match(/type:\s+(.+)/);
-      const statusMatch = block.match(/status:\s+(.+)/);
-      const contentMatch = block.match(/content:\s+(.+)/);
-      const createdMatch = block.match(/created_sprint:\s+(\d+)/);
-      const actionedMatch = block.match(/actioned_cycle:\s+(\d+)/);
-      if (!idMatch || !typeMatch || !statusMatch || !contentMatch || !createdMatch) continue;
-      const status = statusMatch[1].trim();
-      if (status !== "pending") continue;
-      let parsedContent = contentMatch[1].trim();
-      if (parsedContent.startsWith('"') && parsedContent.endsWith('"')) {
-        try {
-          parsedContent = JSON.parse(parsedContent);
-        } catch {
-        }
-      }
-      recs.push({
-        id: idMatch[1].trim(),
-        type: typeMatch[1].trim(),
-        status: "pending",
-        content: parsedContent,
-        createdCycle: parseInt(createdMatch[1], 10),
-        actionedCycle: actionedMatch ? parseInt(actionedMatch[1], 10) : void 0
-      });
-    }
-    return recs;
-  }
-  /** Mark a recommendation as actioned. */
-  async actionRecommendation(id, cycleNumber) {
-    const content = await this.readOptional("STRATEGY_RECOMMENDATIONS.md");
-    if (!content) return;
-    const idPattern = new RegExp(`(\\s+-\\s+id:\\s+${id}\\n(?:.*\\n)*?)(\\s+status:\\s+)pending`);
-    let updated = content.replace(idPattern, `$1$2actioned`);
-    const entryPattern = new RegExp(`(\\s+-\\s+id:\\s+${id}\\n(?:.*\\n)*?)(?=\\s+-\\s+id:|<!-- PAPI-YAML-END -->)`);
-    const entryMatch = updated.match(entryPattern);
-    if (entryMatch && !entryMatch[0].includes("actioned_cycle:")) {
-      const cyclePattern = new RegExp(`(\\s+-\\s+id:\\s+${id}\\n(?:.*\\n)*?\\s+created_sprint:\\s+\\d+)\\n`);
-      updated = updated.replace(cyclePattern, `$1
-    actioned_cycle: ${cycleNumber}
-`);
-    }
-    await this.write("STRATEGY_RECOMMENDATIONS.md", updated);
-  }
-  // -------------------------------------------------------------------------
-  // Strategy Review Agenda (markdown persistence)
-  // -------------------------------------------------------------------------
-  async addAgendaTopic(input) {
-    const id = randomUUID6();
-    const createdAt = (/* @__PURE__ */ new Date()).toISOString();
-    const full = {
-      id,
-      topic: input.topic,
-      source: input.source,
-      sourceCycle: input.sourceCycle,
-      status: "pending",
-      createdAt
-    };
-    const content = await this.readOptional("STRATEGY_REVIEW_AGENDA.md");
-    const header = "# Strategy Review Agenda\n\n<!-- PAPI-ADAPTER: parse the yaml block below -->\n\n<!-- PAPI-YAML-START -->\ntopics:\n";
-    const footer = "<!-- PAPI-YAML-END -->\n";
-    const entry = [
-      `  - id: ${full.id}`,
-      `    topic: ${JSON.stringify(full.topic)}`,
-      `    source: ${full.source}`,
-      full.sourceCycle != null ? `    source_cycle: ${full.sourceCycle}` : null,
-      `    status: ${full.status}`,
-      `    created_at: ${full.createdAt}`
-    ].filter(Boolean).join("\n");
-    if (!content) {
-      await this.write("STRATEGY_REVIEW_AGENDA.md", `${header}${entry}
-${footer}`);
-    } else {
-      const insertPoint = content.indexOf("<!-- PAPI-YAML-END -->");
-      if (insertPoint === -1) {
-        await this.write("STRATEGY_REVIEW_AGENDA.md", `${header}${entry}
-${footer}`);
-      } else {
-        const updated = content.slice(0, insertPoint) + entry + "\n" + content.slice(insertPoint);
-        await this.write("STRATEGY_REVIEW_AGENDA.md", updated);
-      }
-    }
-    return full;
-  }
-  async getPendingAgendaTopics() {
-    const content = await this.readOptional("STRATEGY_REVIEW_AGENDA.md");
-    if (!content) return [];
-    const yamlStart = content.indexOf("<!-- PAPI-YAML-START -->");
-    const yamlEnd = content.indexOf("<!-- PAPI-YAML-END -->");
-    if (yamlStart === -1 || yamlEnd === -1) return [];
-    const yamlBlock = content.slice(yamlStart + "<!-- PAPI-YAML-START -->".length, yamlEnd).trim();
-    const entries = yamlBlock.split(/(?=\s+-\s+id:)/);
-    const topics = [];
-    for (const block of entries) {
-      const idMatch = block.match(/id:\s+(.+)/);
-      const topicMatch = block.match(/topic:\s+(.+)/);
-      const sourceMatch = block.match(/source:\s+(\S+)/);
-      const statusMatch = block.match(/status:\s+(\S+)/);
-      const createdMatch = block.match(/created_at:\s+(.+)/);
-      const sourceCycleMatch = block.match(/source_cycle:\s+(\d+)/);
-      if (!idMatch || !topicMatch || !sourceMatch || !statusMatch || !createdMatch) continue;
-      if (statusMatch[1].trim() !== "pending") continue;
-      let parsedTopic = topicMatch[1].trim();
-      if (parsedTopic.startsWith('"') && parsedTopic.endsWith('"')) {
-        try {
-          parsedTopic = JSON.parse(parsedTopic);
-        } catch {
-        }
-      }
-      topics.push({
-        id: idMatch[1].trim(),
-        topic: parsedTopic,
-        source: sourceMatch[1].trim(),
-        sourceCycle: sourceCycleMatch ? parseInt(sourceCycleMatch[1], 10) : void 0,
-        status: "pending",
-        createdAt: createdMatch[1].trim()
-      });
-    }
-    return topics;
-  }
-  async markAgendaTopicsAddressed(ids, cycleNumber) {
-    if (ids.length === 0) return;
-    const content = await this.readOptional("STRATEGY_REVIEW_AGENDA.md");
-    if (!content) return;
-    let updated = content;
-    const addressedAt = (/* @__PURE__ */ new Date()).toISOString();
-    for (const id of ids) {
-      const statusPattern = new RegExp(`(\\s+-\\s+id:\\s+${id}\\n(?:.*\\n)*?\\s+status:\\s+)pending`);
-      updated = updated.replace(statusPattern, `$1addressed`);
-      const insertionAnchor = new RegExp(`(\\s+-\\s+id:\\s+${id}\\n(?:.*\\n)*?\\s+created_at:\\s+[^\\n]+)\\n`);
-      const match = updated.match(insertionAnchor);
-      if (match && !match[0].includes("addressed_at:")) {
-        updated = updated.replace(insertionAnchor, `$1
-    addressed_at: ${addressedAt}
-    addressed_in_review: ${cycleNumber}
-`);
-      }
-    }
-    await this.write("STRATEGY_REVIEW_AGENDA.md", updated);
-  }
-  // -------------------------------------------------------------------------
-  // Decision Events & Scores (markdown persistence)
-  // -------------------------------------------------------------------------
-  async appendDecisionEvent(event) {
-    const id = randomUUID6();
-    const createdAt = (/* @__PURE__ */ new Date()).toISOString();
-    const full = { ...event, id, createdAt };
-    const content = await this.readOptional("DECISION_EVENTS.md");
-    const header = "# Decision Events\n\n";
-    const entry = `## ${full.decisionId} | ${full.eventType} | Cycle ${full.cycle}
-- **id:** ${full.id}
-- **source:** ${full.source}
-` + (full.sourceRef ? `- **sourceRef:** ${full.sourceRef}
-` : "") + (full.detail ? `- **detail:** ${full.detail}
-` : "") + (full.evidenceRef ? `- **evidenceRef:** ${full.evidenceRef}
-` : "") + (full.metricDelta ? `- **metricDelta:** ${JSON.stringify(full.metricDelta)}
-` : "") + `- **createdAt:** ${full.createdAt}
-
----
-
-`;
-    if (!content) {
-      await this.write("DECISION_EVENTS.md", header + entry);
-    } else {
-      await this.write("DECISION_EVENTS.md", content + entry);
-    }
-    return full;
-  }
-  async getDecisionEvents(decisionId, limit) {
-    const all = await this.parseDecisionEvents();
-    const filtered = all.filter((e) => e.decisionId === decisionId);
-    return limit ? filtered.slice(0, limit) : filtered;
-  }
-  async getDecisionEventsSince(cycle) {
-    const all = await this.parseDecisionEvents();
-    return all.filter((e) => e.cycle >= cycle);
-  }
-  async parseDecisionEvents() {
-    const content = await this.readOptional("DECISION_EVENTS.md");
-    if (!content) return [];
-    const events = [];
-    const blocks = content.split("---").filter((b) => b.trim());
-    for (const block of blocks) {
-      const headingMatch = block.match(/^##\s+(\S+)\s+\|\s+(\S+)\s+\|\s+Cycle\s+(\d+)/m);
-      if (!headingMatch) continue;
-      const idMatch = block.match(/\*\*id:\*\*\s+(.+)/);
-      const sourceMatch = block.match(/\*\*source:\*\*\s+(.+)/);
-      const sourceRefMatch = block.match(/\*\*sourceRef:\*\*\s+(.+)/);
-      const detailMatch = block.match(/\*\*detail:\*\*\s+(.+)/);
-      const evidenceRefMatch = block.match(/\*\*evidenceRef:\*\*\s+(.+)/);
-      const metricDeltaMatch = block.match(/\*\*metricDelta:\*\*\s+(.+)/);
-      const createdAtMatch = block.match(/\*\*createdAt:\*\*\s+(.+)/);
-      if (!idMatch || !sourceMatch || !createdAtMatch) continue;
-      let metricDelta;
-      if (metricDeltaMatch?.[1]) {
-        try {
-          metricDelta = JSON.parse(metricDeltaMatch[1].trim());
-        } catch {
-          metricDelta = null;
-        }
-      }
-      events.push({
-        id: idMatch[1].trim(),
-        decisionId: headingMatch[1],
-        eventType: headingMatch[2],
-        cycle: parseInt(headingMatch[3], 10),
-        source: sourceMatch[1].trim(),
-        sourceRef: sourceRefMatch?.[1]?.trim(),
-        detail: detailMatch?.[1]?.trim(),
-        evidenceRef: evidenceRefMatch?.[1]?.trim(),
-        metricDelta,
-        createdAt: createdAtMatch[1].trim()
-      });
-    }
-    return events;
-  }
-  async writeDecisionScore(score) {
-    const id = randomUUID6();
-    const createdAt = (/* @__PURE__ */ new Date()).toISOString();
-    const totalScore = score.effort + score.risk + score.reversibility + score.scaleCost + score.lockIn;
-    const full = { ...score, id, totalScore, createdAt };
-    const content = await this.readOptional("DECISION_SCORES.md");
-    const header = "# Decision Scores\n\n";
-    const entry = `## ${full.decisionId} | Cycle ${full.cycle}
-- **id:** ${full.id}
-- **effort:** ${full.effort}
-- **risk:** ${full.risk}
-- **reversibility:** ${full.reversibility}
-- **scaleCost:** ${full.scaleCost}
-- **lockIn:** ${full.lockIn}
-- **totalScore:** ${full.totalScore}
-` + (full.rationale ? `- **rationale:** ${full.rationale}
-` : "") + `- **createdAt:** ${full.createdAt}
-
----
-
-`;
-    if (!content) {
-      await this.write("DECISION_SCORES.md", header + entry);
-    } else {
-      await this.write("DECISION_SCORES.md", content + entry);
-    }
-    return full;
-  }
-  async getDecisionScores(decisionId) {
-    const all = await this.parseDecisionScores();
-    return all.filter((s) => s.decisionId === decisionId);
-  }
-  async getLatestDecisionScores() {
-    const all = await this.parseDecisionScores();
-    const latest = /* @__PURE__ */ new Map();
-    for (const s of all) {
-      const existing = latest.get(s.decisionId);
-      if (!existing || s.cycle > existing.cycle) {
-        latest.set(s.decisionId, s);
-      }
-    }
-    return Array.from(latest.values());
-  }
-  async parseDecisionScores() {
-    const content = await this.readOptional("DECISION_SCORES.md");
-    if (!content) return [];
-    const scores = [];
-    const blocks = content.split("---").filter((b) => b.trim());
-    for (const block of blocks) {
-      const headingMatch = block.match(/^##\s+(\S+)\s+\|\s+Cycle\s+(\d+)/m);
-      if (!headingMatch) continue;
-      const field = (name) => block.match(new RegExp(`\\*\\*${name}:\\*\\*\\s+(.+)`))?.[1]?.trim();
-      const id = field("id");
-      const createdAt = field("createdAt");
-      if (!id || !createdAt) continue;
-      scores.push({
-        id,
-        decisionId: headingMatch[1],
-        cycle: parseInt(headingMatch[2], 10),
-        effort: parseInt(field("effort") ?? "0", 10),
-        risk: parseInt(field("risk") ?? "0", 10),
-        reversibility: parseInt(field("reversibility") ?? "0", 10),
-        scaleCost: parseInt(field("scaleCost") ?? "0", 10),
-        lockIn: parseInt(field("lockIn") ?? "0", 10),
-        totalScore: parseInt(field("totalScore") ?? "0", 10),
-        rationale: field("rationale"),
-        createdAt
-      });
-    }
-    return scores;
-  }
-  // Entity reference tracking — no-op for md adapter (DB-only feature)
-  async logEntityReferences(_refs) {
-  }
-  async getDecisionUsage(_currentCycle) {
-    return [];
-  }
-  // --- North Star ---
-  async getCurrentNorthStar() {
-    const content = await this.read("PLANNING_LOG.md");
-    const ns = parseNorthStar(content);
-    return ns || null;
-  }
-  async getNorthStarSetCycle() {
-    return null;
-  }
-  async getNorthStarStaleness() {
-    return null;
-  }
-  async upsertNorthStar(statement, _cycleNumber) {
-    const content = await this.read("PLANNING_LOG.md");
-    const updated = upsertNorthStarInContent(content, statement);
-    await this.write("PLANNING_LOG.md", updated);
-  }
-};
-
-// src/lib/path-identity.ts
-import fs from "fs";
-import path from "path";
-function realpathOrSelf(p) {
-  try {
-    return fs.realpathSync(p);
-  } catch {
-    return p;
-  }
-}
-function checkProjectPathIdentity(opts) {
-  const { storedPapiDir, projectName, cwd } = opts;
-  const log = opts.log ?? ((msg) => console.error(msg));
-  const allowMigrate = opts.allowMigrate ?? (process.env.PAPI_ALLOW_PATH_MIGRATE === "1" || process.env.PAPI_ALLOW_PATH_MIGRATE === "true");
-  const realCwd = realpathOrSelf(cwd);
-  const expectedPapiDir = path.join(realCwd, ".papi");
-  if (!storedPapiDir || storedPapiDir.trim() === "" || storedPapiDir.trim() === ".") {
-    log(`[papi] Backfilling project root for '${projectName}' from current cwd: ${realCwd}`);
-    return { action: "backfill", newPapiDir: expectedPapiDir };
-  }
-  const trimmed = storedPapiDir.trim();
-  const endsInPapi = trimmed.endsWith("/.papi") || trimmed.endsWith("\\.papi");
-  const isWindowsPath = /^[A-Za-z]:[\\/]/.test(trimmed);
-  const realStored = realpathOrSelf(trimmed);
-  let storedProjectRoot;
-  if (endsInPapi) {
-    storedProjectRoot = isWindowsPath ? path.win32.dirname(realStored) : path.dirname(realStored);
-  } else {
-    storedProjectRoot = realStored;
-  }
-  if (storedProjectRoot === realCwd) {
-    if (!endsInPapi) {
-      log(`[papi] Normalising legacy papi_dir for '${projectName}': ${trimmed} \u2192 ${expectedPapiDir}`);
-      return { action: "migrate", newPapiDir: expectedPapiDir };
-    }
-    return { action: "ok" };
-  }
-  if (allowMigrate) {
-    log(
-      `[papi] PAPI_ALLOW_PATH_MIGRATE set \u2014 updating project '${projectName}' root: ${storedProjectRoot} \u2192 ${realCwd}`
-    );
-    return { action: "migrate", newPapiDir: expectedPapiDir };
-  }
-  throw new Error(
-    `PAPI is configured for project '${projectName}' which was set up in ${storedProjectRoot},
-but you're running in ${realCwd}.
-
-To fix:
-  - cd to the right project directory, OR
-  - run \`setup\` to attach this directory to a project, OR
-  - update PAPI_PROJECT_ID in .mcp.json if you intentionally moved the project, OR
-  - set PAPI_ALLOW_PATH_MIGRATE=1 to update the stored path on next boot.`
-  );
-}
-
-// src/lib/project-resolution.ts
-function assertWorkspaceMatch(input) {
-  if (!input.workspacePath) return null;
-  return checkProjectPathIdentity({
-    storedPapiDir: input.storedPapiDir,
-    projectName: input.projectName,
-    cwd: input.workspacePath,
-    allowMigrate: input.allowMigrate,
-    log: input.log
-  });
-}
-
-// src/adapter-factory.ts
-function detectUserId() {
-  try {
-    const email = execSync("git config user.email", { encoding: "utf8", timeout: 5e3 }).trim();
-    if (email) return email;
-  } catch {
-  }
-  try {
-    const ghUser = execSync("gh api user --jq .email", { encoding: "utf8", timeout: 1e4 }).trim();
-    if (ghUser && ghUser !== "null") return ghUser;
-  } catch {
-  }
-  return void 0;
-}
-var HOSTED_SUPABASE_URL2 = process.env["PAPI_HOSTED_SUPABASE_URL"] ?? "https://guewgygcpcmrcoppihzx.supabase.co";
-var HOSTED_PROXY_ENDPOINT = `${HOSTED_SUPABASE_URL2}/functions/v1/data-proxy`;
-var PLACEHOLDER_PATTERNS = [
-  "<YOUR_DATABASE_URL>",
-  "your-database-url",
-  "your_database_url",
-  "placeholder",
-  "example.com",
-  "localhost:5432/dbname",
-  "user:password@host"
-];
-function validateDatabaseUrl(connectionString) {
-  const lower = connectionString.toLowerCase().trim();
-  if (PLACEHOLDER_PATTERNS.some((p) => lower.includes(p.toLowerCase()))) {
-    throw new Error(
-      "DATABASE_URL contains a placeholder value and is not configured.\nReplace it with your actual Supabase connection string in .mcp.json.\nIf you don't have one yet, contact the PAPI admin for access."
-    );
-  }
-  if (!lower.startsWith("postgres://") && !lower.startsWith("postgresql://")) {
-    throw new Error(
-      `DATABASE_URL must be a PostgreSQL connection string (postgres:// or postgresql://).
-Got: "${connectionString.slice(0, 30)}..."
-Check your .mcp.json configuration.`
+  if (!lower.startsWith("postgres://") && !lower.startsWith("postgresql://")) {
+    throw new Error(
+      `DATABASE_URL must be a PostgreSQL connection string (postgres:// or postgresql://).
+Got: "${connectionString.slice(0, 30)}..."
+Check your .mcp.json configuration.`
     );
   }
 }
@@ -4473,9 +2185,6 @@ async function createAdapter(optionsOrType, maybePapiDir) {
   const options = typeof optionsOrType === "string" ? { adapterType: optionsOrType, papiDir: maybePapiDir } : optionsOrType;
   const { adapterType, papiDir, papiEndpoint } = options;
   switch (adapterType) {
-    case "md":
-      _connectionStatus = "offline";
-      return new MdFileAdapter(papiDir);
     case "pg": {
       const { PgAdapter, PgPapiAdapter, configFromEnv } = await import("@papi-ai/adapter-pg");
       let projectId = process.env["PAPI_PROJECT_ID"];
@@ -4788,12 +2497,116 @@ Check PAPI_PROJECT_ID in your .mcp.json config. Find your project ID in the PAPI
     default: {
       const _exhaustive = adapterType;
       throw new Error(
-        `Unknown PAPI_ADAPTER value: "${_exhaustive}". Valid options: "md", "pg", "proxy".`
+        `Unknown PAPI_ADAPTER value: "${_exhaustive}". Valid options: "pg", "proxy".`
       );
     }
   }
 }
 
+// ../shared/dist/index.js
+var CAPABILITY_REGISTRY = [
+  { key: "prReviewer", label: "Auto code review", description: "Runs a code review of the branch diff before accepting.", step: "review" },
+  { key: "securityScan", label: "Security scan", description: "Flags a security pass on risk-tier changes at review time.", step: "review" },
+  { key: "changelog", label: "Changelog & cycle update", description: "Curates a cycle-update post when a release ships.", step: "release" },
+  { key: "verifyHealthCheck", label: "Release health check", description: "Reminds you to verify cycle state before release.", step: "release" },
+  { key: "gestaltPreBuild", label: "Gestalt pre-build check", description: "Reads the whole cycle before building the first task.", step: "build" },
+  { key: "batchBuildRollup", label: "Batch build rollup", description: "Emits a cross-task summary after a batch build.", step: "build" },
+  { key: "modelRecommendation", label: "Model recommendation", description: "Suggests a model tier for each task.", step: "build" },
+  { key: "discoveredIssues", label: "Discovered issues surfacing", description: "Surfaces issues logged during builds at release.", step: "release" },
+  { key: "publishDirective", label: "Publish & registry updates", description: "Announces the release and updates MCP registry listings.", step: "release" },
+  // task-2482 (C319): the release quality gate. When on AND a gate command is
+  // configured (PAPI_GATE), release makes the host LLM run that command and
+  // BLOCKS the tag/merge on failure (fail-closed, AD-58 — PAPI never runs it).
+  { key: "releaseGate", label: "Release quality gate", description: "Runs your test/build command before release and blocks on failure.", step: "release" },
+  // task-2491 (C320): post-release deploy hook — the deploy half of the ship→verify
+  // loop. UNLIKE every other capability this one defaults OFF (defaultEnabled:false):
+  // running a deploy command is destructive, so it is strictly opt-in. When ON AND
+  // papi.deploy (PAPI_DEPLOY) is set, release emits a directive telling the HOST to
+  // run the deploy command AFTER the merge/tag (AD-58 — PAPI never runs it) and
+  // records a deploy_hook progress step so the reactive hub shows the deploy step.
+  { key: "deployHook", label: "Post-release deploy", description: "Runs your deploy command after a release merges.", step: "release", defaultEnabled: false },
+  // task-2833 (C341): enforce the handoff's acceptanceCriteria[] at build-complete.
+  // When ON, a completed:"yes" build whose handoff lists acceptance criteria must
+  // pass acceptance_confirmed:true or build_execute returns the checklist and does
+  // NOT mark the task Done (non-destructive — the report is not discarded). Defaults
+  // OFF: it changes the completion contract, so it is strictly opt-in until a project
+  // chooses to hold builds to their own acceptance criteria.
+  { key: "acceptanceGate", label: "Acceptance-criteria gate", description: "Requires confirming the handoff acceptance criteria before a build completes.", step: "build", defaultEnabled: false },
+  // task-2325 (C344): configurable workflow guardrails — let a user opt out of the
+  // git/branch/commit/PR ceremony and PAPI-meta framing so PAPI adapts to their
+  // workflow instead of imposing one. Every toggle DEFAULTS ON (no defaultEnabled)
+  // so current behaviour is byte-identical until the user flips it off. The no-git
+  // fallback that these ride on top of is a separate task (task-2353).
+  { key: "autoBranch", label: "Auto branch", description: "Creates a feature branch per task/cycle at build start.", step: "build" },
+  { key: "autoCommit", label: "Auto commit", description: "Commits your work automatically when a build completes.", step: "build" },
+  { key: "autoPush", label: "Auto push & PR", description: "Pushes the branch and opens a pull request on build complete.", step: "build" },
+  { key: "papiMetaFraming", label: "PAPI self-referential framing", description: "Includes PAPI-meta build-discipline framing in handoff output.", step: "build" }
+];
+var CAPABILITY_KEYS = CAPABILITY_REGISTRY.map((c) => c.key);
+var WAB_WINDOW_DAYS = 7;
+var WAB_WEEK_MS = WAB_WINDOW_DAYS * 24 * 60 * 60 * 1e3;
+var EFFORT_SCALE = {
+  XS: 1,
+  S: 2,
+  M: 3,
+  L: 4,
+  XL: 5
+};
+function effortOrdinal(effort) {
+  if (typeof effort !== "string") return void 0;
+  const normalized = effort.trim().toUpperCase();
+  return EFFORT_SCALE[normalized];
+}
+function isUnparsedEffort(effort) {
+  if (typeof effort !== "string" || effort.trim().length === 0) return false;
+  return effortOrdinal(effort) === void 0;
+}
+function calculateCycleMetrics(reports, currentCycle, window = 5) {
+  const recentReports = reports.filter(
+    (r) => r.cycle > currentCycle - window && r.cycle <= currentCycle
+  );
+  const unparsedEffortCount = recentReports.filter(
+    (r) => isUnparsedEffort(r.actualEffort) || isUnparsedEffort(r.estimatedEffort)
+  ).length;
+  const perCycle = /* @__PURE__ */ new Map();
+  for (const r of recentReports) {
+    const group = perCycle.get(r.cycle) ?? [];
+    group.push(r);
+    perCycle.set(r.cycle, group);
+  }
+  const accuracy = [];
+  const velocity = [];
+  const sortedCycles = [...perCycle.keys()].sort((a, b) => a - b);
+  for (const cycle of sortedCycles) {
+    const reps = perCycle.get(cycle);
+    const deltas = [];
+    for (const r of reps) {
+      const actual = effortOrdinal(r.actualEffort);
+      const estimated = effortOrdinal(r.estimatedEffort);
+      if (actual !== void 0 && estimated !== void 0) {
+        deltas.push(actual - estimated);
+      }
+    }
+    if (deltas.length > 0) {
+      accuracy.push({
+        cycle,
+        reports: deltas.length,
+        matchRate: Math.round(deltas.filter((d) => d === 0).length / deltas.length * 100),
+        mae: Math.round(deltas.reduce((s, d) => s + Math.abs(d), 0) / deltas.length * 10) / 10,
+        bias: Math.round(deltas.reduce((s, d) => s + d, 0) / deltas.length * 10) / 10
+      });
+    }
+    velocity.push({
+      cycle,
+      completed: reps.filter((r) => r.completed === "Yes").length,
+      partial: reps.filter((r) => r.completed === "Partial").length,
+      failed: reps.filter((r) => r.completed === "No").length,
+      effortPoints: reps.reduce((s, r) => s + (effortOrdinal(r.actualEffort) ?? 0), 0)
+    });
+  }
+  return { accuracy, velocity, unparsedEffortCount };
+}
+
 // src/lib/formatters.ts
 var PLAN_FULL_NOTES_BUDGET_BYTES = Number(process.env.PAPI_PLAN_NOTES_BUDGET) || 6e4;
 function effortWeight(size) {