@papi-ai/adapter-md 0.1.1-alpha → 0.2.0

package/dist/index.js

@@ -8,18 +8,27 @@ import {
   VALID_TRANSITIONS as _VALID_TRANSITIONS,
   isValidTransition as _isValidTransition,
   validateTransition as _validateTransition,
-  isValidStatus as _isValidStatus
+  isValidStatus as _isValidStatus,
+  isLiveDecision as _isLiveDecision,
+  RETIRED_DECISION_OUTCOMES as _RETIRED_DECISION_OUTCOMES
 } from "@papi-ai/shared";
 var VALID_TRANSITIONS = _VALID_TRANSITIONS;
 var isValidTransition = _isValidTransition;
 var validateTransition = _validateTransition;
 var isValidStatus = _isValidStatus;
+var isLiveDecision = _isLiveDecision;
 var TASK_TYPE_TIERS = {
   bug: 1,
   task: 1,
   research: 2,
+  spike: 2,
   idea: 3,
-  feedback: 3
+  discovery: 1,
+  // Non-code brief types for non-technical Owners (AD-12)
+  "design-brief": 1,
+  "research-brief": 1,
+  "marketing-brief": 1,
+  "ops-brief": 1
 };
 
 // src/parsers/planning-log.ts
@@ -199,6 +208,30 @@ ${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());
@@ -250,6 +283,7 @@ var SECTION_HEADERS = [
   "SCOPE BOUNDARY (DO NOT DO THIS)",
   "ACCEPTANCE CRITERIA",
   "SECURITY CONSIDERATIONS",
+  "PRE-BUILD VERIFICATION",
   "FILES LIKELY TOUCHED",
   "EFFORT"
 ];
@@ -280,6 +314,9 @@ function splitSections(text) {
 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*\[[ x]]\s*/, "").trim()).filter((l) => l.length > 0);
 }
@@ -314,11 +351,34 @@ function parseBuildHandoff(markdown) {
     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 serializeBuildHandoff(handoff) {
+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] : [];
+  }
+  return [];
+}
+function serializeBuildHandoff(raw) {
+  let handoff;
+  if (typeof raw === "string") {
+    try {
+      handoff = JSON.parse(raw);
+    } catch {
+      return raw;
+    }
+  } else {
+    handoff = raw;
+  }
   const lines = [];
   lines.push(`BUILD HANDOFF \u2014 ${handoff.taskId}`);
   if (handoff.uuid) lines.push(`UUID: ${handoff.uuid}`);
@@ -329,30 +389,40 @@ function serializeBuildHandoff(handoff) {
   lines.push(`Why now: ${handoff.whyNow}`);
   lines.push("");
   lines.push("SCOPE (DO THIS)");
-  for (const item of handoff.scope) {
+  for (const item of ensureArray(handoff.scope)) {
     lines.push(`- ${item}`);
   }
   lines.push("");
   lines.push("SCOPE BOUNDARY (DO NOT DO THIS)");
-  for (const item of handoff.scopeBoundary) {
+  for (const item of ensureArray(handoff.scopeBoundary)) {
     lines.push(`- ${item}`);
   }
   lines.push("");
   lines.push("ACCEPTANCE CRITERIA");
-  for (const item of handoff.acceptanceCriteria) {
+  for (const item of ensureArray(handoff.acceptanceCriteria)) {
     lines.push(`[ ] ${item}`);
   }
   lines.push("");
   lines.push("SECURITY CONSIDERATIONS");
-  lines.push(handoff.securityConsiderations);
+  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}`);
+    }
+    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 handoff.filesLikelyTouched) {
+  for (const item of ensureArray(handoff.filesLikelyTouched)) {
     lines.push(`- ${item}`);
   }
   lines.push("");
   lines.push("EFFORT");
-  lines.push(handoff.effort);
+  lines.push(handoff.effort ?? "M");
   return lines.join("\n");
 }
 
@@ -383,7 +453,11 @@ function toCycleTask(raw) {
     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
+    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) {
@@ -415,6 +489,10 @@ function fromCycleTask(task) {
   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) {
@@ -481,6 +559,7 @@ function filterTasks(tasks, options) {
     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;
   });
 }
@@ -830,7 +909,6 @@ function aggregateCostSummary(metrics, cycleNumber) {
   };
 }
 var COST_SECTION_HEADING = "## Cost Summary";
-var COST_TABLE_HEADER = "| Cycle | Date | Total Cost ($) | Input Tokens | Output Tokens | Calls |";
 var COST_TABLE_SEPARATOR = "|--------|------|----------------|--------------|---------------|-------|";
 function parseCostSnapshots(content) {
   const lines = content.split("\n");
@@ -859,28 +937,6 @@ function parseCostSnapshots(content) {
   }
   return snapshots;
 }
-function serializeCostSnapshot(snapshot) {
-  return `| ${snapshot.cycle} | ${snapshot.date} | ${snapshot.totalCostUsd.toFixed(4)} | ${formatNumber(snapshot.totalInputTokens)} | ${formatNumber(snapshot.totalOutputTokens)} | ${formatNumber(snapshot.totalCalls)} |`;
-}
-function writeCostSnapshotToContent(snapshot, content) {
-  if (!content.includes(COST_SECTION_HEADING)) {
-    return content.trimEnd() + "\n\n" + COST_SECTION_HEADING + "\n\n" + COST_TABLE_HEADER + "\n" + COST_TABLE_SEPARATOR + "\n" + serializeCostSnapshot(snapshot) + "\n";
-  }
-  const lines = content.split("\n");
-  const cyclePrefix = `| ${snapshot.cycle} |`;
-  let replaced = false;
-  for (let i = 0; i < lines.length; i++) {
-    if (lines[i].startsWith(cyclePrefix)) {
-      lines[i] = serializeCostSnapshot(snapshot);
-      replaced = true;
-      break;
-    }
-  }
-  if (replaced) {
-    return lines.join("\n");
-  }
-  return content.trimEnd() + "\n" + serializeCostSnapshot(snapshot) + "\n";
-}
 
 // src/parsers/cycle-metrics.ts
 var FILE_HEADING = "# Cycle Methodology Metrics";
@@ -1358,6 +1414,7 @@ function toCycle(raw) {
     taskIds: raw.task_ids ?? []
   };
   if (raw.end_date) cycle.endDate = raw.end_date;
+  if (raw.user_id) cycle.userId = raw.user_id;
   return cycle;
 }
 function fromCycle(cycle) {
@@ -1371,6 +1428,7 @@ function fromCycle(cycle) {
     task_ids: cycle.taskIds
   };
   if (cycle.endDate) raw.end_date = cycle.endDate;
+  if (cycle.userId) raw.user_id = cycle.userId;
   return raw;
 }
 function extractYamlBlock2(content) {
@@ -1510,11 +1568,18 @@ var MdFileAdapter = class {
   async getCycleHealth() {
     return parseCycleHealth(await this.read("PLANNING_LOG.md"));
   }
-  /** Read all Active Decisions from ACTIVE_DECISIONS.md. */
-  async getActiveDecisions() {
+  /**
+   * 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 [];
-    return parseActiveDecisions(content);
+    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) {
@@ -1533,11 +1598,13 @@ var MdFileAdapter = class {
   }
   /** Prepend a new cycle log entry at the top of the Cycle Log section. */
   async writeCycleLogEntry(entry) {
-    if (!entry.uuid) {
-      entry = { ...entry, uuid: randomUUID6() };
-    }
+    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(entry, content));
+    await this.write("SPRINT_LOG.md", prependCycleLogEntry(patched, content));
   }
   /** Write a strategy review — for md adapter, delegates to cycle log. */
   async writeStrategyReview(review) {
@@ -1562,7 +1629,8 @@ var MdFileAdapter = class {
     return [];
   }
   /** Update or insert an Active Decision block by ID. */
-  async updateActiveDecision(id, body, cycleNumber) {
+  // 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));
   }
@@ -1692,6 +1760,66 @@ var MdFileAdapter = class {
   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 ---
@@ -1721,6 +1849,11 @@ var MdFileAdapter = class {
     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"));
@@ -1876,16 +2009,15 @@ ${newSection}
     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);
   }
-  /** Write a cost snapshot to the Cost Summary section of METRICS.md. */
-  async writeCostSnapshot(snapshot) {
-    const content = await this.readOptional("METRICS.md");
-    await this.write("METRICS.md", writeCostSnapshotToContent(snapshot, content));
-  }
   /** Read all cost snapshots from the Cost Summary section of METRICS.md. */
   async getCostSnapshots() {
     const content = await this.readOptional("METRICS.md");
@@ -2018,6 +2150,102 @@ ${footer}`);
     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) {
@@ -2031,6 +2259,8 @@ ${footer}`);
 - **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}
 
 ---
@@ -2064,8 +2294,18 @@ ${footer}`);
       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],
@@ -2074,6 +2314,8 @@ ${footer}`);
         source: sourceMatch[1].trim(),
         sourceRef: sourceRefMatch?.[1]?.trim(),
         detail: detailMatch?.[1]?.trim(),
+        evidenceRef: evidenceRefMatch?.[1]?.trim(),
+        metricDelta,
         createdAt: createdAtMatch[1].trim()
       });
     }
@@ -2156,6 +2398,23 @@ ${footer}`);
   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/parsers/review-patterns.ts

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "@papi-ai/adapter-md",
-  "version": "0.1.1-alpha",
+  "version": "0.2.0",
   "description": "PAPI markdown file storage adapter — reads and writes .papi/ project files",
   "license": "Elastic-2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "files": [
     "dist",
     "README.md"
@@ -32,7 +38,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@papi-ai/shared": "^0.1.0-alpha",
+    "@papi-ai/shared": "^0.1.0",
     "js-yaml": "^4.1.0"
   },
   "devDependencies": {