@papi-ai/server 0.7.81 → 0.7.82

package/dist/backfill-cycle-metrics.js

@@ -63,6 +63,7 @@ __export(git_exports, {
   isGhAvailable: () => isGhAvailable,
   isGitAvailable: () => isGitAvailable,
   isGitRepo: () => isGitRepo,
+  isPathCommittedAnywhere: () => isPathCommittedAnywhere,
   isPathIgnored: () => isPathIgnored,
   isPathTracked: () => isPathTracked,
   listGroupedCycleBranches: () => listGroupedCycleBranches,
@@ -102,6 +103,22 @@ function isGitRepo(cwd) {
     return false;
   }
 }
+function isPathCommittedAnywhere(cwd, path3) {
+  const run = (args) => {
+    try {
+      return execFileSync("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    } catch {
+      return null;
+    }
+  };
+  const commit = run(["log", "--all", "--format=%H", "-1", "--", path3]);
+  if (!commit) return false;
+  const committedBlob = run(["rev-parse", `${commit}:${path3}`]);
+  if (!committedBlob) return false;
+  const onDiskBlob = run(["hash-object", "--", path3]);
+  if (!onDiskBlob) return false;
+  return committedBlob === onDiskBlob;
+}
 function isPathTracked(cwd, path3) {
   try {
     execFileSync("git", ["ls-files", "--error-unmatch", "--", path3], {
@@ -1285,7 +1302,7 @@ function wrapWithForwarding(instance) {
 function createProxyAdapter(config) {
   return wrapWithForwarding(new ProxyPapiAdapter(config));
 }
-var JSONB_PASSTHROUGH_KEYS, DISPLAY_ID_METHODS, NO_FORWARD, ProxyPapiAdapter;
+var JSONB_PASSTHROUGH_KEYS, DISPLAY_ID_METHODS, HOSTED_SERVED, NO_FORWARD, ProxyPapiAdapter;
 var init_proxy_adapter = __esm({
   "src/proxy-adapter.ts"() {
     "use strict";
@@ -1313,6 +1330,156 @@ var init_proxy_adapter = __esm({
       "getRecentReviews",
       "getActiveDecisions"
     ]);
+    HOSTED_SERVED = /* @__PURE__ */ new Set([
+      "actionRecommendation",
+      "addAgendaTopic",
+      "addContributorByEmail",
+      "appendBuildReport",
+      "appendCycleLearnings",
+      "appendCycleMetrics",
+      "appendDecisionEvent",
+      "appendToolMetric",
+      "archiveTasks",
+      "claimTask",
+      "clearPendingReviewResponse",
+      "compressBuildReports",
+      "compressCycleLog",
+      "confirmPendingActiveDecisions",
+      "correctLatestBuildReportEffort",
+      "countDueOwnerActions",
+      "countNudgedOwnerActions",
+      "countOpenOwnerActions",
+      "countOwnerActionsBlockingTasks",
+      "countPlanRunsForCycle",
+      "createConvention",
+      "createCycle",
+      "createHorizon",
+      "createOwnerAction",
+      "createStage",
+      "createTask",
+      "deleteActiveDecision",
+      "deleteConvention",
+      "deleteDoc",
+      "dismissRecommendation",
+      "findPendingDocActionsForTask",
+      "getActiveDecisions",
+      "getActiveStage",
+      "getBuildReportCountForTask",
+      "getBuildReportsSince",
+      "getContextHashes",
+      "getContextUtilisation",
+      "getCostSnapshots",
+      "getCostSummary",
+      "getCurrentNorthStar",
+      "getCycleHealth",
+      "getCycleLearningPatterns",
+      "getCycleLearnings",
+      "getCycleLog",
+      "getCycleLogSince",
+      "getDecisionEvents",
+      "getDecisionEventsSince",
+      "getDecisionScorePatterns",
+      "getDecisionScores",
+      "getDecisionUsage",
+      "getDoc",
+      "getDocBody",
+      "getDocBodyUsage",
+      "getDogfoodLog",
+      "getEstimationCalibration",
+      "getFailedBuildAttemptsForTask",
+      "getHarnessInventory",
+      "getHarnessState",
+      "getLastStrategyReviewCycle",
+      "getLatestDecisionScores",
+      "getModelOutcomeStats",
+      "getModuleEstimationStats",
+      "getNorthStarSetCycle",
+      "getNorthStarStaleness",
+      "getOwnerIdentity",
+      "getPendingAgendaTopics",
+      "getPendingRecommendations",
+      "getPendingReviewResponse",
+      "getPlanContextSummary",
+      "getProjectInfo",
+      "getProjectOwnerUserId",
+      "getRecentBuildReports",
+      "getRecentReviews",
+      "getRecentTaskComments",
+      "getRecommendationEffectiveness",
+      "getStrategyReviews",
+      "getTask",
+      "getTasks",
+      "getToolCallCount",
+      "getUnactionedDogfoodEntries",
+      "getUnnotifiedResolvedFeedback",
+      "hasToolMilestone",
+      "insertPlanRun",
+      "insertToolRun",
+      "linkOwnerActionToTask",
+      "linkPhasesToStage",
+      "listContributors",
+      "listConventions",
+      "listMyBugReports",
+      "listOwnerActionsForBlockerScan",
+      "logEntityReferences",
+      "markAgendaTopicsAddressed",
+      "markCycleLearningResolved",
+      "markFeedbackNotified",
+      "moveTask",
+      "planWriteBack",
+      "projectExists",
+      "queryBoard",
+      "readCycleMetrics",
+      "readCycles",
+      "readCycles",
+      "readDiscoveryCanvas",
+      "readHorizons",
+      "readPhases",
+      "readPlanningLog",
+      "readProductBrief",
+      "readRegistries",
+      "readStages",
+      "readToolMetrics",
+      "recordProgressStep",
+      "recordTransition",
+      "registerDoc",
+      "removeContributorByEmail",
+      "reorderDocs",
+      "replaceHarnessInventory",
+      "resolveLearningsForDoneTasks",
+      "savePendingReviewResponse",
+      "searchDocs",
+      "setCriterionMet",
+      "setCycleHealth",
+      "setHarnessState",
+      "setProjectPapiDir",
+      "storeDocBody",
+      "submitBugReport",
+      "unclaimTask",
+      "updateActiveDecision",
+      "updateCycleLearningActionRef",
+      "updateDiscoveryCanvas",
+      "updateDocAction",
+      "updateDocStatus",
+      "updateDogfoodEntryStatus",
+      "updateHorizonStatus",
+      "updatePhaseStatus",
+      "updateProductBrief",
+      "updateRegistries",
+      "updateStageExitCriteria",
+      "updateStageStatus",
+      "updateTask",
+      "updateTaskStatus",
+      "upsertActiveDecision",
+      "upsertNorthStar",
+      "writeCycleLogEntry",
+      "writeDecisionScore",
+      "writeDogfoodEntries",
+      "writePhases",
+      "writeRecommendation",
+      "writeReview",
+      "writeStrategyReview"
+    ]);
     NO_FORWARD = /* @__PURE__ */ new Set([
       // (1) local-only
       "close",
@@ -1399,6 +1566,30 @@ var init_proxy_adapter = __esm({
         this.projectId = config.projectId ?? "";
         this.onAuthRejected = config.onAuthRejected;
       }
+      /**
+       * Does the hosted path genuinely serve `name`? (task-3022, C362)
+       *
+       * This is the honest answer to the question `typeof adapter.name === 'function'`
+       * USED to ask and could not answer: the get-trap below manufactures a function
+       * for any name absent from NO_FORWARD, so a structural probe reads true for
+       * pg-only methods and the caller then earns a 403 from the edge.
+       *
+       * Answered from NO_FORWARD itself, deliberately — the same set the forwarder
+       * consults — so this can never disagree with what an actual call would do. A
+       * name in NO_FORWARD is either local-only or not yet wired hosted; either way
+       * the caller must take its fallback. The proxy-parity test guarantees every
+       * method is an explicit wrapper, in NO_FORWARD, or in the edge allowlist, so
+       * "not in NO_FORWARD" is a sound proxy for "served hosted".
+       *
+       * A REAL method, not a forwarded one: Reflect.get in the trap returns it before
+       * the forwarding branch is reached, so callers get this implementation rather
+       * than a forwarder that would POST "supportsMethod" to the edge.
+       */
+      supportsMethod(name) {
+        if (NO_FORWARD.has(name)) return false;
+        if (name in _ProxyPapiAdapter.prototype) return true;
+        return HOSTED_SERVED.has(name);
+      }
       /**
        * task-1773: bearer-only auth probe. Hits the USER-scoped `project-list` route
        * (no projectId needed), so it answers exactly one question: does the proxy

package/dist/index.js

@@ -64,6 +64,7 @@ __export(git_exports, {
   isGhAvailable: () => isGhAvailable,
   isGitAvailable: () => isGitAvailable,
   isGitRepo: () => isGitRepo,
+  isPathCommittedAnywhere: () => isPathCommittedAnywhere,
   isPathIgnored: () => isPathIgnored,
   isPathTracked: () => isPathTracked,
   listGroupedCycleBranches: () => listGroupedCycleBranches,
@@ -103,6 +104,22 @@ function isGitRepo(cwd) {
     return false;
   }
 }
+function isPathCommittedAnywhere(cwd, path7) {
+  const run = (args) => {
+    try {
+      return execFileSync("git", args, { cwd, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
+    } catch {
+      return null;
+    }
+  };
+  const commit = run(["log", "--all", "--format=%H", "-1", "--", path7]);
+  if (!commit) return false;
+  const committedBlob = run(["rev-parse", `${commit}:${path7}`]);
+  if (!committedBlob) return false;
+  const onDiskBlob = run(["hash-object", "--", path7]);
+  if (!onDiskBlob) return false;
+  return committedBlob === onDiskBlob;
+}
 function isPathTracked(cwd, path7) {
   try {
     execFileSync("git", ["ls-files", "--error-unmatch", "--", path7], {
@@ -1342,7 +1359,7 @@ function wrapWithForwarding(instance) {
 function createProxyAdapter(config2) {
   return wrapWithForwarding(new ProxyPapiAdapter(config2));
 }
-var JSONB_PASSTHROUGH_KEYS, DISPLAY_ID_METHODS, NO_FORWARD, ProxyPapiAdapter;
+var JSONB_PASSTHROUGH_KEYS, DISPLAY_ID_METHODS, HOSTED_SERVED, NO_FORWARD, ProxyPapiAdapter;
 var init_proxy_adapter = __esm({
   "src/proxy-adapter.ts"() {
     "use strict";
@@ -1370,6 +1387,156 @@ var init_proxy_adapter = __esm({
       "getRecentReviews",
       "getActiveDecisions"
     ]);
+    HOSTED_SERVED = /* @__PURE__ */ new Set([
+      "actionRecommendation",
+      "addAgendaTopic",
+      "addContributorByEmail",
+      "appendBuildReport",
+      "appendCycleLearnings",
+      "appendCycleMetrics",
+      "appendDecisionEvent",
+      "appendToolMetric",
+      "archiveTasks",
+      "claimTask",
+      "clearPendingReviewResponse",
+      "compressBuildReports",
+      "compressCycleLog",
+      "confirmPendingActiveDecisions",
+      "correctLatestBuildReportEffort",
+      "countDueOwnerActions",
+      "countNudgedOwnerActions",
+      "countOpenOwnerActions",
+      "countOwnerActionsBlockingTasks",
+      "countPlanRunsForCycle",
+      "createConvention",
+      "createCycle",
+      "createHorizon",
+      "createOwnerAction",
+      "createStage",
+      "createTask",
+      "deleteActiveDecision",
+      "deleteConvention",
+      "deleteDoc",
+      "dismissRecommendation",
+      "findPendingDocActionsForTask",
+      "getActiveDecisions",
+      "getActiveStage",
+      "getBuildReportCountForTask",
+      "getBuildReportsSince",
+      "getContextHashes",
+      "getContextUtilisation",
+      "getCostSnapshots",
+      "getCostSummary",
+      "getCurrentNorthStar",
+      "getCycleHealth",
+      "getCycleLearningPatterns",
+      "getCycleLearnings",
+      "getCycleLog",
+      "getCycleLogSince",
+      "getDecisionEvents",
+      "getDecisionEventsSince",
+      "getDecisionScorePatterns",
+      "getDecisionScores",
+      "getDecisionUsage",
+      "getDoc",
+      "getDocBody",
+      "getDocBodyUsage",
+      "getDogfoodLog",
+      "getEstimationCalibration",
+      "getFailedBuildAttemptsForTask",
+      "getHarnessInventory",
+      "getHarnessState",
+      "getLastStrategyReviewCycle",
+      "getLatestDecisionScores",
+      "getModelOutcomeStats",
+      "getModuleEstimationStats",
+      "getNorthStarSetCycle",
+      "getNorthStarStaleness",
+      "getOwnerIdentity",
+      "getPendingAgendaTopics",
+      "getPendingRecommendations",
+      "getPendingReviewResponse",
+      "getPlanContextSummary",
+      "getProjectInfo",
+      "getProjectOwnerUserId",
+      "getRecentBuildReports",
+      "getRecentReviews",
+      "getRecentTaskComments",
+      "getRecommendationEffectiveness",
+      "getStrategyReviews",
+      "getTask",
+      "getTasks",
+      "getToolCallCount",
+      "getUnactionedDogfoodEntries",
+      "getUnnotifiedResolvedFeedback",
+      "hasToolMilestone",
+      "insertPlanRun",
+      "insertToolRun",
+      "linkOwnerActionToTask",
+      "linkPhasesToStage",
+      "listContributors",
+      "listConventions",
+      "listMyBugReports",
+      "listOwnerActionsForBlockerScan",
+      "logEntityReferences",
+      "markAgendaTopicsAddressed",
+      "markCycleLearningResolved",
+      "markFeedbackNotified",
+      "moveTask",
+      "planWriteBack",
+      "projectExists",
+      "queryBoard",
+      "readCycleMetrics",
+      "readCycles",
+      "readCycles",
+      "readDiscoveryCanvas",
+      "readHorizons",
+      "readPhases",
+      "readPlanningLog",
+      "readProductBrief",
+      "readRegistries",
+      "readStages",
+      "readToolMetrics",
+      "recordProgressStep",
+      "recordTransition",
+      "registerDoc",
+      "removeContributorByEmail",
+      "reorderDocs",
+      "replaceHarnessInventory",
+      "resolveLearningsForDoneTasks",
+      "savePendingReviewResponse",
+      "searchDocs",
+      "setCriterionMet",
+      "setCycleHealth",
+      "setHarnessState",
+      "setProjectPapiDir",
+      "storeDocBody",
+      "submitBugReport",
+      "unclaimTask",
+      "updateActiveDecision",
+      "updateCycleLearningActionRef",
+      "updateDiscoveryCanvas",
+      "updateDocAction",
+      "updateDocStatus",
+      "updateDogfoodEntryStatus",
+      "updateHorizonStatus",
+      "updatePhaseStatus",
+      "updateProductBrief",
+      "updateRegistries",
+      "updateStageExitCriteria",
+      "updateStageStatus",
+      "updateTask",
+      "updateTaskStatus",
+      "upsertActiveDecision",
+      "upsertNorthStar",
+      "writeCycleLogEntry",
+      "writeDecisionScore",
+      "writeDogfoodEntries",
+      "writePhases",
+      "writeRecommendation",
+      "writeReview",
+      "writeStrategyReview"
+    ]);
     NO_FORWARD = /* @__PURE__ */ new Set([
       // (1) local-only
       "close",
@@ -1456,6 +1623,30 @@ var init_proxy_adapter = __esm({
         this.projectId = config2.projectId ?? "";
         this.onAuthRejected = config2.onAuthRejected;
       }
+      /**
+       * Does the hosted path genuinely serve `name`? (task-3022, C362)
+       *
+       * This is the honest answer to the question `typeof adapter.name === 'function'`
+       * USED to ask and could not answer: the get-trap below manufactures a function
+       * for any name absent from NO_FORWARD, so a structural probe reads true for
+       * pg-only methods and the caller then earns a 403 from the edge.
+       *
+       * Answered from NO_FORWARD itself, deliberately — the same set the forwarder
+       * consults — so this can never disagree with what an actual call would do. A
+       * name in NO_FORWARD is either local-only or not yet wired hosted; either way
+       * the caller must take its fallback. The proxy-parity test guarantees every
+       * method is an explicit wrapper, in NO_FORWARD, or in the edge allowlist, so
+       * "not in NO_FORWARD" is a sound proxy for "served hosted".
+       *
+       * A REAL method, not a forwarded one: Reflect.get in the trap returns it before
+       * the forwarding branch is reached, so callers get this implementation rather
+       * than a forwarder that would POST "supportsMethod" to the edge.
+       */
+      supportsMethod(name) {
+        if (NO_FORWARD.has(name)) return false;
+        if (name in _ProxyPapiAdapter.prototype) return true;
+        return HOSTED_SERVED.has(name);
+      }
       /**
        * task-1773: bearer-only auth probe. Hits the USER-scoped `project-list` route
        * (no projectId needed), so it answers exactly one question: does the proxy
@@ -6193,7 +6384,78 @@ function validateFindings(findings) {
   return { ok: violations.length === 0, violations };
 }
 var WAB_WINDOW_DAYS = 7;
+var WAB_DEFAULT_WEEKS = 8;
 var WAB_WEEK_MS = WAB_WINDOW_DAYS * 24 * 60 * 60 * 1e3;
+function wabCompletionMs(row) {
+  const ts = row.end_date ?? row.updated_at;
+  if (!ts) return null;
+  const ms = Date.parse(ts);
+  return Number.isNaN(ms) ? null : ms;
+}
+function bucketWabSeries(rows, ownerUserId, nowMs, weeks = WAB_DEFAULT_WEEKS) {
+  const buckets = Array.from({ length: weeks }, () => /* @__PURE__ */ new Set());
+  for (const row of rows) {
+    if (!row.user_id) continue;
+    const ms = wabCompletionMs(row);
+    if (ms === null) continue;
+    const idx = Math.floor((nowMs - ms) / WAB_WEEK_MS);
+    if (idx < 0 || idx >= weeks) continue;
+    buckets[idx].add(row.user_id);
+  }
+  const out = [];
+  for (let idx = weeks - 1; idx >= 0; idx--) {
+    const owners = buckets[idx];
+    const external = ownerUserId ? [...owners].filter((id) => id !== ownerUserId).length : owners.size;
+    out.push({
+      weekStart: new Date(nowMs - (idx + 1) * WAB_WEEK_MS).toISOString(),
+      total: owners.size,
+      external
+    });
+  }
+  return out;
+}
+var PRODUCT_MARKER = /WHAT SHIPS FOR USERS\b[^\n:]*:/i;
+var MECHANICS_MARKER = /RELEASE MECHANICS\b[^\n:]*:/i;
+function splitCarryForward(raw) {
+  const productMatch = PRODUCT_MARKER.exec(raw);
+  const mechanicsMatch = MECHANICS_MARKER.exec(raw);
+  if (!productMatch && !mechanicsMatch) {
+    return { product: raw.trim(), mechanics: "", split: false };
+  }
+  if (!productMatch && mechanicsMatch) {
+    const head = raw.slice(0, mechanicsMatch.index).trim();
+    const tail = raw.slice(mechanicsMatch.index + mechanicsMatch[0].length).trim();
+    return { product: head, mechanics: tail, split: true };
+  }
+  const productStart = productMatch.index + productMatch[0].length;
+  if (!mechanicsMatch) {
+    return { product: raw.slice(productStart).trim(), mechanics: "", split: true };
+  }
+  if (mechanicsMatch.index < productMatch.index) {
+    return {
+      product: raw.slice(productStart).trim(),
+      mechanics: raw.slice(mechanicsMatch.index + mechanicsMatch[0].length, productMatch.index).trim(),
+      split: true
+    };
+  }
+  return {
+    product: raw.slice(productStart, mechanicsMatch.index).trim(),
+    mechanics: raw.slice(mechanicsMatch.index + mechanicsMatch[0].length).trim(),
+    split: true
+  };
+}
+function renderCarryForward(raw, decorate = (t) => t) {
+  const { product, mechanics, split } = splitCarryForward(raw);
+  if (!split) return [decorate(product)];
+  const lines = [];
+  if (product) lines.push(decorate(product));
+  if (mechanics) {
+    if (product) lines.push("");
+    lines.push("**Release mechanics** \u2014 needed at release, not now:");
+    lines.push(decorate(mechanics));
+  }
+  return lines;
+}
 var CHECK_VALUE_MAX = 200;
 function codeSpanSafe(value) {
   const flat = value.replace(/[`\r\n]+/g, " ").replace(/\s+/g, " ").trim();
@@ -9860,6 +10122,13 @@ function formatBlockerWaiting(blocker) {
   }
 }
 
+// src/lib/adapter-capability.ts
+function adapterSupports(adapter2, method) {
+  const declared = adapter2.supportsMethod;
+  if (typeof declared === "function") return declared.call(adapter2, method);
+  return typeof adapter2[method] === "function";
+}
+
 // src/lib/tool-telemetry.ts
 var INSTRUMENTED_TOOLS = /* @__PURE__ */ new Set([
   "plan",
@@ -9882,7 +10151,7 @@ function measureResultBytes(content) {
 }
 function recordToolRun(adapter2, sample) {
   if (sample.toolName !== PLAN_PREPARE_TOOL_NAME && !WRAPPER_INSTRUMENTED_TOOLS.has(sample.toolName)) return;
-  if (typeof adapter2.insertToolRun !== "function") return;
+  if (!adapterSupports(adapter2, "insertToolRun")) return;
   try {
     const promise = adapter2.insertToolRun({
       toolName: sample.toolName,
@@ -9956,7 +10225,7 @@ function isProjectOwner(callerUserId, ownerUserId) {
   return caller === owner;
 }
 async function resolveOwnerGate(adapter2, config2) {
-  if (typeof adapter2.getOwnerIdentity === "function") {
+  if (adapterSupports(adapter2, "getOwnerIdentity")) {
     try {
       const identity = await adapter2.getOwnerIdentity();
       const callerUserId = identity.callerUserId ?? config2.userId ?? null;
@@ -9978,7 +10247,7 @@ async function resolveOwnerGate(adapter2, config2) {
       };
     }
   }
-  if (typeof adapter2.getProjectOwnerUserId === "function") {
+  if (adapterSupports(adapter2, "getProjectOwnerUserId")) {
     let ownerUserId = null;
     let resolutionError;
     try {
@@ -18897,7 +19166,7 @@ function isDecisionPending(task) {
   return d != null && d.answer == null;
 }
 async function countFailedAttempts(adapter2, taskId) {
-  if (typeof adapter2.getFailedBuildAttemptsForTask !== "function") return null;
+  if (!adapterSupports(adapter2, "getFailedBuildAttemptsForTask")) return null;
   try {
     return await adapter2.getFailedBuildAttemptsForTask(taskId);
   } catch {
@@ -19310,7 +19579,7 @@ To override, pass force=true (emits a telemetry warning).`
         boardHealth: existing?.boardHealth ?? "",
         taskIds: existing?.taskIds ?? []
       };
-      if (typeof adapter2.commitRelease === "function") {
+      if (adapterSupports(adapter2, "commitRelease")) {
         try {
           await adapter2.commitRelease({ cycle: completedCycle, snapshot: snapshot ?? null });
         } catch (err) {
@@ -20868,7 +21137,7 @@ async function listBuilds(adapter2, config2) {
   const [{ result: tasks, warnings }, health] = await Promise.all([
     withBaseBranchSync(
       { projectRoot: config2.projectRoot, baseBranch: config2.baseBranch },
-      () => adapter2.queryBoard()
+      () => adapter2.queryBoard({ compact: true })
     ),
     adapter2.getCycleHealth().catch(() => null)
   ]);
@@ -20876,14 +21145,16 @@ async function listBuilds(adapter2, config2) {
   if (tasks.length === 0) {
     return { sorted: [], inProgress: [], backlog: [], blocked: [], warnings, isEmpty: true, noHandoffs: false, currentCycle, totalTasks: tasks.length };
   }
-  const withHandoff = tasks.filter((t) => {
-    if (!t.buildHandoff) return false;
+  const candidates = tasks.filter((t) => {
     if (t.status === "Done" || t.status === "Cancelled" || t.status === "Blocked" || t.status === "Backlog" || t.status === "Deferred" || t.status === "Archived") {
       return false;
     }
     if (currentCycle > 0 && t.cycle !== currentCycle) return false;
     return true;
   });
+  const hydrated = candidates.length > 0 ? await adapter2.getTasks(candidates.map((t) => t.id)) : [];
+  const byId = new Map(hydrated.map((t) => [t.id, t]));
+  const withHandoff = candidates.map((t) => byId.get(t.id)).filter((t) => Boolean(t?.buildHandoff));
   if (withHandoff.length === 0) {
     return { sorted: [], inProgress: [], backlog: [], blocked: [], warnings, isEmpty: false, noHandoffs: true, currentCycle, totalTasks: tasks.length };
   }
@@ -21381,7 +21652,7 @@ async function completeBuild(adapter2, config2, taskId, input, options = {}, cli
   assertDeployVerification(config2, input, { deployingNow: options.light === true });
   const [healthResult, priorCount] = await Promise.all([
     adapter2.getCycleHealth().catch(() => ({ totalCycles: 0 })),
-    typeof adapter2.getBuildReportCountForTask === "function" ? adapter2.getBuildReportCountForTask(taskId).catch(() => 0) : Promise.resolve(0)
+    adapterSupports(adapter2, "getBuildReportCountForTask") ? adapter2.getBuildReportCountForTask(taskId).catch(() => 0) : Promise.resolve(0)
   ]);
   const cycleNumber = healthResult.totalCycles;
   const iterationCount = priorCount + 1;
@@ -21425,7 +21696,7 @@ async function completeBuild(adapter2, config2, taskId, input, options = {}, cli
   console.error(
     `[build] task ${taskId} related_decisions: ${relatedAdIds.length} AD(s) (${relatedAdIds.length === 0 ? "none" : relatedInferred ? "inferred from handoff" : "builder-provided"}).`
   );
-  if (report.startedAt && report.completedAt && typeof adapter2.getToolCallCount === "function") {
+  if (report.startedAt && report.completedAt && adapterSupports(adapter2, "getToolCallCount")) {
     try {
       const count = await adapter2.getToolCallCount(report.startedAt, report.completedAt);
       if (count > 0) report.toolCallCount = count;
@@ -21438,7 +21709,7 @@ async function completeBuild(adapter2, config2, taskId, input, options = {}, cli
   const buildReportSummary = `${capitalizeCompleted(input.completed)}. Effort ${input.effort} vs estimated ${input.estimatedEffort}.${iterNote}${surpriseNote}${issueNote}`;
   const statusChange = input.completed === "yes" ? { from: task.status, to: options.light ? "Done" : "In Review" } : void 0;
   let atomicCommitDone = false;
-  if (typeof adapter2.commitBuildComplete === "function") {
+  if (adapterSupports(adapter2, "commitBuildComplete")) {
     await adapter2.commitBuildComplete({
       report,
       taskId,
@@ -21451,7 +21722,7 @@ async function completeBuild(adapter2, config2, taskId, input, options = {}, cli
     await adapter2.appendBuildReport(report);
   }
   let reportWriteVerified;
-  if (typeof adapter2.getBuildReportCountForTask === "function") {
+  if (adapterSupports(adapter2, "getBuildReportCountForTask")) {
     try {
       const postWriteCount = await adapter2.getBuildReportCountForTask(taskId);
       reportWriteVerified = postWriteCount >= iterationCount;
@@ -21569,7 +21840,7 @@ async function completeBuild(adapter2, config2, taskId, input, options = {}, cli
     if (row.findingKey) insertedByKey.set(row.findingKey, row.inserted);
   }
   const haveInsertSignal = appendedRows.length > 0;
-  if (findingRows.length > 0 && typeof adapter2.createTask === "function") {
+  if (findingRows.length > 0 && adapterSupports(adapter2, "createTask")) {
     for (const { finding, learning } of findingRows) {
       if (learning.category !== "issue") continue;
       if (finding.disposition !== "filed") continue;
@@ -22390,7 +22661,7 @@ var MAX_DOC_BODY_BYTES = 2 * 1024 * 1024;
 var PAID_TIERS = /* @__PURE__ */ new Set(["pro", "team"]);
 var PRICING_URL = "https://getpapi.ai/pricing";
 async function resolveTier(adapter2) {
-  if (typeof adapter2.getMeteredUsage !== "function") return null;
+  if (!adapterSupports(adapter2, "getMeteredUsage")) return null;
   try {
     const usage = await adapter2.getMeteredUsage();
     return usage?.tier ?? null;
@@ -22405,7 +22676,7 @@ async function enforceProjectCap(adapter2, target) {
   if (isSelfHostedDeployment(process.env.PAPI_SELF_HOST)) return null;
   const tier = await resolveTier(adapter2);
   if (tier === null || isPaidTier(tier)) return null;
-  if (typeof adapter2.listUserProjects !== "function") return null;
+  if (!adapterSupports(adapter2, "listUserProjects")) return null;
   let projects;
   try {
     projects = await adapter2.listUserProjects();
@@ -22448,7 +22719,7 @@ The registry entry was saved and everything else is unaffected. Split the docume
   const tier = await resolveTier(adapter2);
   if (tier === null) return { storeBody: true };
   const ceiling = DOC_STORAGE_CEILING_BY_TIER[tier] ?? DOC_STORAGE_CEILING_BY_TIER.free;
-  if (typeof adapter2.getDocBodyUsage !== "function") return { storeBody: true };
+  if (!adapterSupports(adapter2, "getDocBodyUsage")) return { storeBody: true };
   let usage;
   try {
     usage = await adapter2.getDocBodyUsage();
@@ -22625,6 +22896,7 @@ The registry stores metadata and a summary \u2014 not the body. This doc has one
     );
   }
   if (isPathTracked(projectRoot, path7)) return "";
+  if (isPathCommittedAnywhere(projectRoot, path7)) return "";
   if (isPathIgnored(projectRoot, path7)) {
     return warn(
       `\`${path7}\` is excluded by .gitignore, so it cannot be committed (docs/private/ is ignored by design).`,
@@ -22826,7 +23098,7 @@ function resolveRestoreTarget(projectRoot, docPath) {
   return { abs };
 }
 async function handleDocRead(adapter2, config2, args) {
-  if (!adapter2.getDoc || typeof adapter2.getDocBody !== "function") {
+  if (!adapter2.getDoc || !adapterSupports(adapter2, "getDocBody")) {
     return errorResponse(
       "Doc bodies are not available on this adapter \u2014 requires the pg/proxy adapter. Nothing is blocked; the file on disk (if any) is still the copy you have."
     );
@@ -23985,7 +24257,7 @@ ${checklist}
       });
     }
     let fixedResolvedCount = 0;
-    if (fixedIssues && fixedIssues.length > 0 && typeof adapter2.markCycleLearningResolved === "function") {
+    if (fixedIssues && fixedIssues.length > 0 && adapterSupports(adapter2, "markCycleLearningResolved")) {
       const resolvedBy = `build:${result.task.displayId ?? taskId}`;
       for (const learningId of fixedIssues) {
         try {
@@ -26194,7 +26466,7 @@ Re-run build_execute complete with a production_verification field, then re-subm
   }
   const newStatus = resolveStatus(input.stage, input.verdict);
   const statusChange = newStatus ? { from: task.status, to: newStatus } : void 0;
-  if (typeof adapter2.commitReviewSubmit === "function") {
+  if (adapterSupports(adapter2, "commitReviewSubmit")) {
     await adapter2.commitReviewSubmit({
       review,
       taskId: input.taskId,
@@ -26225,7 +26497,7 @@ Re-run build_execute complete with a production_verification field, then re-subm
     }
   }
   const closedDocActions = [];
-  if (newStatus === "Done" && typeof adapter2.findPendingDocActionsForTask === "function" && typeof adapter2.updateDocAction === "function") {
+  if (newStatus === "Done" && adapterSupports(adapter2, "findPendingDocActionsForTask") && adapterSupports(adapter2, "updateDocAction")) {
     try {
       const pending = await adapter2.findPendingDocActionsForTask(input.taskId);
       for (const match of pending) {
@@ -26236,7 +26508,7 @@ Re-run build_execute complete with a production_verification field, then re-subm
           console.error(`[doc-closure] failed to resolve doc action ${match.docId}#${match.actionIndex}: ${err instanceof Error ? err.message : String(err)}`);
         }
       }
-      if (closedDocActions.length > 0 && typeof adapter2.appendCycleLearnings === "function") {
+      if (closedDocActions.length > 0 && adapterSupports(adapter2, "appendCycleLearnings")) {
         try {
           await adapter2.appendCycleLearnings([{
             taskId: input.taskId,
@@ -26497,6 +26769,19 @@ function mergeAfterAccept(config2, taskId) {
     };
   }
   const details = [];
+  if (isBranchMergedInto(config2.projectRoot, featureBranch, baseBranch)) {
+    details.push(`Branch '${featureBranch}' is already merged into '${baseBranch}'.`);
+    return { merged: true, skipped: false, message: `Already merged: \`${featureBranch}\` \u2192 \`${baseBranch}\`.`, details };
+  }
+  if (isBranchContentAlreadyInBase(config2.projectRoot, featureBranch, baseBranch)) {
+    details.push(`Branch '${featureBranch}' adds nothing to '${baseBranch}' \u2014 its commits already landed there.`);
+    return {
+      merged: true,
+      skipped: false,
+      message: `Already on \`${baseBranch}\` \u2014 no PR merge needed (these commits were folded into another branch and landed with it).`,
+      details
+    };
+  }
   const papiDir = join15(config2.projectRoot, ".papi");
   if (existsSync10(papiDir)) {
     try {
@@ -26841,7 +27126,7 @@ ${overlap}`;
 \u2705 Verdict recorded. All cycle tasks are Done, but **auto-release is owner-only** \u2014 your identity does not match this project's owner, so no release was cut. Push your branch and open a PR for the owner to run \`release\`.${resolutionNote}`;
         } else if (cycleTasks.length > 0 && cycleTasks.every((t) => t.status === "Done")) {
           let planRunCount = null;
-          if (typeof adapter2.countPlanRunsForCycle === "function") {
+          if (adapterSupports(adapter2, "countPlanRunsForCycle")) {
             try {
               planRunCount = await adapter2.countPlanRunsForCycle(result.currentCycle);
             } catch {
@@ -27044,7 +27329,7 @@ async function resolveReviewerIdentity(adapter2, config2) {
     const note = gate.resolutionError ? ` (${gate.resolutionError})` : "";
     return { error: "Reviewing requires a resolvable user identity, but none was found" + note + ". Set PAPI_USER_ID to your account UUID (local) \u2014 hosted sessions derive it from the bearer token." };
   }
-  if (!gate.callerIsOwner && typeof adapter2.listContributors === "function") {
+  if (!gate.callerIsOwner && adapterSupports(adapter2, "listContributors")) {
     try {
       const members = await adapter2.listContributors();
       if (!members.some((m) => m.userId === callerUserId)) {
@@ -27059,7 +27344,7 @@ async function resolveReviewerIdentity(adapter2, config2) {
 async function handleReviewClaim(adapter2, config2, args) {
   const taskId = typeof args.task_id === "string" ? args.task_id.trim() : "";
   if (!taskId) return errorResponse('A task_id is required. Example: review_claim task_id="task-2072"');
-  if (typeof adapter2.claimReview !== "function") {
+  if (!adapterSupports(adapter2, "claimReview")) {
     return errorResponse("The shared review queue is not available on this adapter.");
   }
   const identity = await resolveReviewerIdentity(adapter2, config2);
@@ -28008,50 +28293,6 @@ function formatUnblockSection(candidates) {
   return lines.join("\n");
 }
 
-// src/lib/carry-forward-shape.ts
-var PRODUCT_MARKER = /WHAT SHIPS FOR USERS\b[^\n:]*:/i;
-var MECHANICS_MARKER = /RELEASE MECHANICS\b[^\n:]*:/i;
-function splitCarryForward(raw) {
-  const productMatch = PRODUCT_MARKER.exec(raw);
-  const mechanicsMatch = MECHANICS_MARKER.exec(raw);
-  if (!productMatch && !mechanicsMatch) {
-    return { product: raw.trim(), mechanics: "", split: false };
-  }
-  if (!productMatch && mechanicsMatch) {
-    const head = raw.slice(0, mechanicsMatch.index).trim();
-    const tail = raw.slice(mechanicsMatch.index + mechanicsMatch[0].length).trim();
-    return { product: head, mechanics: tail, split: true };
-  }
-  const productStart = productMatch.index + productMatch[0].length;
-  if (!mechanicsMatch) {
-    return { product: raw.slice(productStart).trim(), mechanics: "", split: true };
-  }
-  if (mechanicsMatch.index < productMatch.index) {
-    return {
-      product: raw.slice(productStart).trim(),
-      mechanics: raw.slice(mechanicsMatch.index + mechanicsMatch[0].length, productMatch.index).trim(),
-      split: true
-    };
-  }
-  return {
-    product: raw.slice(productStart, mechanicsMatch.index).trim(),
-    mechanics: raw.slice(mechanicsMatch.index + mechanicsMatch[0].length).trim(),
-    split: true
-  };
-}
-function renderCarryForward(raw, decorate = (t) => t) {
-  const { product, mechanics, split } = splitCarryForward(raw);
-  if (!split) return [decorate(product)];
-  const lines = [];
-  if (product) lines.push(decorate(product));
-  if (mechanics) {
-    if (product) lines.push("");
-    lines.push("**Release mechanics** \u2014 needed at release, not now:");
-    lines.push(decorate(mechanics));
-  }
-  return lines;
-}
-
 // src/lib/deferred-gate.ts
 var GATE_PHRASES = [
   "depends on",
@@ -28372,12 +28613,39 @@ var evaluateSelfServeActivation = async (adapter2, projectId) => {
     unevaluatedReason: `mechanically satisfied (${users} non-owner accounts planned in their own project) \u2014 but "ZERO owner intervention" is a human judgement, so this needs an owner tick via set_criterion_met`
   } : { met: false, evidence: `0 non-owner accounts with a planned cycle. Counted ${(/* @__PURE__ */ new Date()).toISOString()}.` };
 };
+var evaluateWeeklyActiveBuilders = async (adapter2, projectId) => {
+  const sql = sqlOf(adapter2);
+  if (!sql) return { met: null, unevaluatedReason: "no direct SQL access on this adapter (hosted path)" };
+  const owner = await sql`
+    SELECT user_id FROM projects WHERE id = ${projectId}
+  `;
+  const ownerUserId = owner[0]?.user_id ?? null;
+  const rows = await sql`
+    SELECT c.user_id, c.end_date, c.updated_at
+    FROM cycles c
+    JOIN projects p ON p.id = c.project_id
+    JOIN auth.users u ON u.id = p.user_id
+    WHERE c.status = 'complete'
+      AND c.user_id IS NOT NULL
+      AND u.email NOT LIKE ${TEST_ACCOUNT_PATTERN}
+  `;
+  const series = bucketWabSeries(rows, ownerUserId, Date.now(), WAB_DEFAULT_WEEKS);
+  const peak = series.reduce((max, w) => Math.max(max, w.external), 0);
+  let consecutive = 0;
+  let bestRun = 0;
+  for (const week of series) {
+    consecutive = week.external >= 3 ? consecutive + 1 : 0;
+    bestRun = Math.max(bestRun, consecutive);
+  }
+  const counted = `Peak ${peak} external builder(s) in any trailing week; longest run at >=3 is ${bestRun} consecutive week(s) over the last ${WAB_DEFAULT_WEEKS}. Owner and ${TEST_ACCOUNT_PATTERN} excluded. Counted ${(/* @__PURE__ */ new Date()).toISOString()}.`;
+  return bestRun >= 2 ? { met: true, evidence: counted } : { met: false, evidence: counted };
+};
 var EVALUATORS = {
   "c4a11d42-b222-45af-a470-08970e1bd6a9": evaluateSelfServeActivation,
-  "59751bcb-f719-4cf6-a4d4-608770999a22": evaluateUnaidedFullLoop
+  "59751bcb-f719-4cf6-a4d4-608770999a22": evaluateUnaidedFullLoop,
+  "e9d984f4-1e75-4486-8605-5dfd07412915": evaluateWeeklyActiveBuilders
 };
 var UNEVALUATABLE = {
-  "e9d984f4-1e75-4486-8605-5dfd07412915": "no evaluator here \u2014 the canonical completion-keyed definition lives in lib/weekly-active-builders.ts (Next app) and must not be re-derived in the server",
   "c596a082-9ad3-4089-b497-46cd189e892b": "threshold is provisional pending an owner ruling \u2014 no settled bar to evaluate against"
 };
 async function evaluateExitCriteria(adapter2, projectId, criteria) {
@@ -28787,7 +29055,10 @@ async function getHierarchyPosition(adapter2, projectId) {
       adapter2.readHorizons?.() ?? [],
       adapter2.readStages?.() ?? [],
       adapter2.readPhases(),
-      adapter2.queryBoard()
+      // Compact: the only fields read below are `phase` and `status`, for the
+      // per-phase done/total tally. A non-compact pull dragged every handoff and
+      // build report across the wire for two columns.
+      adapter2.queryBoard({ compact: true })
     ]);
     if (horizons.length === 0) return void 0;
     const isInProgress = (s) => s.status === "In Progress";
@@ -28907,7 +29178,7 @@ function formatDiscoveredIssuesBlocks(candidateLearnings, closedTaskIds) {
   return { alertsNote, unactionedIssuesNote };
 }
 async function computeTeamSummary(adapter2, contributorsInput) {
-  if (typeof adapter2.listContributors !== "function") return void 0;
+  if (!adapterSupports(adapter2, "listContributors")) return void 0;
   let members;
   try {
     members = (await (contributorsInput ?? adapter2.listContributors())).length;
@@ -28928,7 +29199,7 @@ async function computeTeamSummary(adapter2, contributorsInput) {
   return `**Team:** ${members} members \xB7 ${pool} in pool \xB7 ${inFlight} in flight \xB7 ${reviewQueue} in review`;
 }
 async function computeReleaseHistory(adapter2, contributorsInput) {
-  if (typeof adapter2.listContributors !== "function") return void 0;
+  if (!adapterSupports(adapter2, "listContributors")) return void 0;
   let contributors;
   try {
     contributors = await (contributorsInput ?? adapter2.listContributors());
@@ -28968,7 +29239,29 @@ function formatResolvedFeedback(items) {
   lines.push("_Thanks for the signal \u2014 it shaped what shipped._");
   return lines.join("\n");
 }
-async function handleOrient(adapter2, config2, args = {}, clientName) {
+function withBoardMemo(adapter2) {
+  const inflight = /* @__PURE__ */ new Map();
+  const queryBoard = (options) => {
+    const key = JSON.stringify(options ?? null);
+    const hit = inflight.get(key);
+    if (hit) return hit;
+    const pending = adapter2.queryBoard(options).catch((err) => {
+      inflight.delete(key);
+      throw err;
+    });
+    inflight.set(key, pending);
+    return pending;
+  };
+  return new Proxy(adapter2, {
+    get(target, prop, receiver) {
+      if (prop === "queryBoard") return queryBoard;
+      const value = Reflect.get(target, prop, receiver);
+      return typeof value === "function" ? value.bind(target) : value;
+    }
+  });
+}
+async function handleOrient(rawAdapter, config2, args = {}, clientName) {
+  const adapter2 = withBoardMemo(rawAdapter);
   const environment = normaliseEnvironment(args.environment);
   const deepHousekeeping = args.deep_housekeeping === true;
   const fullEnrichment = args.full === true || deepHousekeeping;
@@ -29464,7 +29757,7 @@ ${versionDrift}` : "";
       }
     }
     tracker.mark("parallel-tail");
-    const sharedContributorsPromise = typeof adapter2.listContributors === "function" ? adapter2.listContributors().catch(() => []) : Promise.resolve([]);
+    const sharedContributorsPromise = adapterSupports(adapter2, "listContributors") ? adapter2.listContributors().catch(() => []) : Promise.resolve([]);
     const [unblockCandidates, subAgents, teamSummaryLine, releaseHistoryLine, carryForwardRefs] = await Promise.all([
       tracked("unblock-candidates", () => findUnblockCandidates(adapter2, currentCycle))().catch(() => []),
       // task-1866: discover project sub-agents for the orient surface (read-only, never throws).
@@ -31071,7 +31364,7 @@ var contributorListTool = {
   }
 };
 function denyUnlessCohortCapable(adapter2) {
-  if (typeof adapter2.listContributors !== "function") {
+  if (!adapterSupports(adapter2, "listContributors")) {
     return "Contributor management is not available on this adapter (requires the pg or proxy adapter \u2014 the local md adapter has no cohort).";
   }
   return null;
@@ -31092,7 +31385,7 @@ async function denyUnlessMember(adapter2, config2) {
   const gate = await resolveOwnerGate(adapter2, config2);
   if (!gate.enforced) return null;
   if (gate.callerIsOwner) return null;
-  const callerRole = gate.callerUserId && typeof adapter2.getContributorRole === "function" ? await adapter2.getContributorRole(gate.callerUserId).catch(() => null) : null;
+  const callerRole = gate.callerUserId && adapterSupports(adapter2, "getContributorRole") ? await adapter2.getContributorRole(gate.callerUserId).catch(() => null) : null;
   if (callerRole) return null;
   const note = gate.resolutionError ? ` (Identity resolution failed: ${gate.resolutionError} \u2014 the gate fails closed; retry once connectivity is restored.)` : "";
   return `Listing contributors is restricted to project members. Your identity does not match this project's owner or any contributor.${note}`;
@@ -31193,7 +31486,7 @@ function requireTaskId(args) {
   return id.length > 0 ? id : null;
 }
 async function resolveClaimerIdentity(adapter2, config2) {
-  if (typeof adapter2.claimTask !== "function") {
+  if (!adapterSupports(adapter2, "claimTask")) {
     return { error: "Claiming is not available on this adapter." };
   }
   const gate = await resolveOwnerGate(adapter2, config2);
@@ -31204,7 +31497,7 @@ async function resolveClaimerIdentity(adapter2, config2) {
       error: "Claiming requires a resolvable user identity, but none was found" + note + ". Set PAPI_USER_ID to your account UUID (local) \u2014 hosted sessions derive it from your bearer token."
     };
   }
-  if (!gate.callerIsOwner && typeof adapter2.listContributors === "function") {
+  if (!gate.callerIsOwner && adapterSupports(adapter2, "listContributors")) {
     try {
       const members = await adapter2.listContributors();
       if (!members.some((m) => m.userId === callerUserId)) {
@@ -31290,7 +31583,7 @@ ${claimedList}`
 async function handleTaskUnclaim(adapter2, config2, args) {
   const taskId = requireTaskId(args);
   if (!taskId) return errorResponse('A task_id is required. Example: task_unclaim task_id="task-2071"');
-  if (typeof adapter2.unclaimTask !== "function") {
+  if (!adapterSupports(adapter2, "unclaimTask")) {
     return errorResponse("Unclaiming is not available on this adapter.");
   }
   const identity = await resolveClaimerIdentity(adapter2, config2);
@@ -31341,7 +31634,7 @@ async function handleTaskMove(adapter2, config2, args) {
   if (!taskId) return errorResponse('A task_id is required. Example: task_move task_id="task-42" target_project="other-project" confirm=true');
   const targetProject = requireStr(args.target_project);
   if (!targetProject) return errorResponse("A target_project (slug or UUID) is required \u2014 the project you want to move the task into.");
-  if (typeof adapter2.moveTask !== "function") {
+  if (!adapterSupports(adapter2, "moveTask")) {
     return errorResponse("Cross-project move is not available on this adapter.");
   }
   const gate = await resolveOwnerGate(adapter2, config2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@papi-ai/server",
-  "version": "0.7.81",
+  "version": "0.7.82",
   "description": "PAPI MCP server — AI-powered sprint planning, build execution, and strategy review for software projects",
   "license": "Elastic-2.0",
   "mcpName": "io.github.getpapi/papi",