@papi-ai/server 0.7.46 → 0.7.47

package/dist/backfill-cycle-metrics.js

@@ -4519,31 +4519,66 @@ Check PAPI_PROJECT_ID in your .mcp.json config. Find your project ID in the PAPI
 }
 
 // src/lib/formatters.ts
-var EFFORT_MAP = { XS: 1, S: 2, M: 3, L: 5, XL: 8 };
-function computeSnapshotsFromBuildReports(reports) {
-  if (reports.length === 0) return [];
-  const byCycleMap = /* @__PURE__ */ new Map();
+function effortWeight(size) {
+  switch ((size || "").toUpperCase()) {
+    case "XS":
+      return 1;
+    case "S":
+    case "SMALL":
+      return 2;
+    case "M":
+    case "MEDIUM":
+      return 3;
+    case "L":
+    case "LARGE":
+      return 5;
+    case "XL":
+      return 8;
+    default:
+      return 3;
+  }
+}
+function computeSnapshotsFromBuildReports(reports, tasks) {
+  const reportsByCycle = /* @__PURE__ */ new Map();
   for (const r of reports) {
-    const existing = byCycleMap.get(r.cycle) ?? [];
+    const existing = reportsByCycle.get(r.cycle) ?? [];
     existing.push(r);
-    byCycleMap.set(r.cycle, existing);
+    reportsByCycle.set(r.cycle, existing);
   }
+  const tasksByCycle = /* @__PURE__ */ new Map();
+  for (const t of tasks ?? []) {
+    if (t.cycle == null) continue;
+    const existing = tasksByCycle.get(t.cycle) ?? [];
+    existing.push(t);
+    tasksByCycle.set(t.cycle, existing);
+  }
+  const cycleNumbers = /* @__PURE__ */ new Set([...reportsByCycle.keys(), ...tasksByCycle.keys()]);
+  if (cycleNumbers.size === 0) return [];
   const snapshots = [];
-  for (const [sn, cycleReports] of byCycleMap) {
-    const completed = cycleReports.filter((r) => r.completed === "Yes").length;
-    const total = cycleReports.length;
+  for (const sn of cycleNumbers) {
+    const cycleReports = reportsByCycle.get(sn) ?? [];
+    const cycleTaskRows = tasksByCycle.get(sn);
     const withEffort = cycleReports.filter((r) => r.estimatedEffort && r.actualEffort);
     const accurate = withEffort.filter((r) => r.estimatedEffort === r.actualEffort).length;
     const matchRate = withEffort.length > 0 ? Math.round(accurate / withEffort.length * 100) : 0;
-    let effortPoints = 0;
-    for (const r of cycleReports) {
-      effortPoints += EFFORT_MAP[r.actualEffort] ?? 3;
+    let completed;
+    let total;
+    let effortPoints;
+    if (cycleTaskRows && cycleTaskRows.length > 0) {
+      const done = cycleTaskRows.filter((t) => t.status === "Done");
+      completed = done.length;
+      total = cycleTaskRows.length;
+      effortPoints = done.reduce((s, t) => s + effortWeight(t.complexity), 0);
+    } else {
+      completed = cycleReports.filter((r) => r.completed === "Yes").length;
+      total = cycleReports.length;
+      effortPoints = cycleReports.reduce((s, r) => s + effortWeight(r.actualEffort), 0);
     }
     snapshots.push({
       cycle: sn,
       date: (/* @__PURE__ */ new Date()).toISOString(),
-      accuracy: [{ cycle: sn, reports: total, matchRate, mae: 0, bias: 0 }],
-      velocity: [{ cycle: sn, completed, partial: 0, failed: total - completed, effortPoints }]
+      accuracy: [{ cycle: sn, reports: cycleReports.length, matchRate, mae: 0, bias: 0 }],
+      velocity: [{ cycle: sn, completed, partial: 0, failed: Math.max(0, total - completed), effortPoints }]
     });
   }
   snapshots.sort((a, b) => a.cycle - b.cycle);

package/dist/index.js

@@ -8306,31 +8306,66 @@ function formatBoardForReview(tasks) {
   Notes: ${t.notes}` : ""}`
   ).join("\n\n");
 }
-var EFFORT_MAP = { XS: 1, S: 2, M: 3, L: 5, XL: 8 };
-function computeSnapshotsFromBuildReports(reports) {
-  if (reports.length === 0) return [];
-  const byCycleMap = /* @__PURE__ */ new Map();
+function effortWeight(size2) {
+  switch ((size2 || "").toUpperCase()) {
+    case "XS":
+      return 1;
+    case "S":
+    case "SMALL":
+      return 2;
+    case "M":
+    case "MEDIUM":
+      return 3;
+    case "L":
+    case "LARGE":
+      return 5;
+    case "XL":
+      return 8;
+    default:
+      return 3;
+  }
+}
+function computeSnapshotsFromBuildReports(reports, tasks) {
+  const reportsByCycle = /* @__PURE__ */ new Map();
   for (const r of reports) {
-    const existing = byCycleMap.get(r.cycle) ?? [];
+    const existing = reportsByCycle.get(r.cycle) ?? [];
     existing.push(r);
-    byCycleMap.set(r.cycle, existing);
+    reportsByCycle.set(r.cycle, existing);
+  }
+  const tasksByCycle = /* @__PURE__ */ new Map();
+  for (const t of tasks ?? []) {
+    if (t.cycle == null) continue;
+    const existing = tasksByCycle.get(t.cycle) ?? [];
+    existing.push(t);
+    tasksByCycle.set(t.cycle, existing);
   }
+  const cycleNumbers = /* @__PURE__ */ new Set([...reportsByCycle.keys(), ...tasksByCycle.keys()]);
+  if (cycleNumbers.size === 0) return [];
   const snapshots = [];
-  for (const [sn, cycleReports] of byCycleMap) {
-    const completed = cycleReports.filter((r) => r.completed === "Yes").length;
-    const total = cycleReports.length;
+  for (const sn of cycleNumbers) {
+    const cycleReports = reportsByCycle.get(sn) ?? [];
+    const cycleTaskRows = tasksByCycle.get(sn);
     const withEffort = cycleReports.filter((r) => r.estimatedEffort && r.actualEffort);
     const accurate = withEffort.filter((r) => r.estimatedEffort === r.actualEffort).length;
     const matchRate = withEffort.length > 0 ? Math.round(accurate / withEffort.length * 100) : 0;
-    let effortPoints = 0;
-    for (const r of cycleReports) {
-      effortPoints += EFFORT_MAP[r.actualEffort] ?? 3;
+    let completed;
+    let total;
+    let effortPoints;
+    if (cycleTaskRows && cycleTaskRows.length > 0) {
+      const done = cycleTaskRows.filter((t) => t.status === "Done");
+      completed = done.length;
+      total = cycleTaskRows.length;
+      effortPoints = done.reduce((s, t) => s + effortWeight(t.complexity), 0);
+    } else {
+      completed = cycleReports.filter((r) => r.completed === "Yes").length;
+      total = cycleReports.length;
+      effortPoints = cycleReports.reduce((s, r) => s + effortWeight(r.actualEffort), 0);
     }
     snapshots.push({
       cycle: sn,
       date: (/* @__PURE__ */ new Date()).toISOString(),
-      accuracy: [{ cycle: sn, reports: total, matchRate, mae: 0, bias: 0 }],
-      velocity: [{ cycle: sn, completed, partial: 0, failed: total - completed, effortPoints }]
+      accuracy: [{ cycle: sn, reports: cycleReports.length, matchRate, mae: 0, bias: 0 }],
+      velocity: [{ cycle: sn, completed, partial: 0, failed: Math.max(0, total - completed), effortPoints }]
     });
   }
   snapshots.sort((a, b2) => a.cycle - b2.cycle);
@@ -9274,7 +9309,7 @@ function buildHandoffsOnlyUserMessage(inputs) {
 }
 function extractDependencyChain(displayText) {
   const match = displayText.match(
-    /^##\s+Dependency Chain[^\n]*\n([\s\S]*?)(?=\n#{2,3}\s|$(?![\s\S]))/m
+    /^##\s+Dependency Chain[^\n]*\n([\s\S]*?)(?=\n#{2,3}\s|\n-{3,}\s*(?:\n|$)|\n\s*BUILD HANDOFF\b|\n<!--\s*PAPI_STRUCTURED_OUTPUT|$(?![\s\S]))/m
   );
   if (!match) return void 0;
   const body = match[1].trim();
@@ -12515,6 +12550,13 @@ async function preparePlan(adapter2, config2, filters, focus, force, handoffsOnl
     contextHashes
   };
 }
+var PLAN_STAGE_STEPS = ["health-check", "inbox-triage", "board-integrity", "maturity-gate", "recommendation", "dependency-chain"];
+async function streamPlanStageSteps(tracker, newCycleNumber) {
+  tracker.setStreamScope({ cycle: newCycleNumber });
+  for (const step of PLAN_STAGE_STEPS) {
+    await tracker.recordStep(step);
+  }
+}
 async function applyPlan(adapter2, config2, rawLlmOutput, mode, cycleNumber, strategyReviewWarning, contextHashes, planRunMeta, tracker) {
   const applyTimer = startTimer();
   console.error(`[plan-perf] applyPlan: start (llm_response=${rawLlmOutput.length} chars)`);
@@ -12527,6 +12569,7 @@ async function applyPlan(adapter2, config2, rawLlmOutput, mode, cycleNumber, str
     if (config2.adapterType === "pg") {
       tracker?.mark("process_llm_output_pg");
       const result = await processLlmOutput(adapter2, config2, rawLlmOutput, mode, cycleNumber, contextHashes, planRunMeta);
+      if (tracker) await streamPlanStageSteps(tracker, cycleNumber + 1);
       const applyMs2 = applyTimer();
       console.error(`[plan-perf] applyPlan: total=${applyMs2}ms (pg, no git sync)`);
       return { ...result, pullNote: "", strategyReviewWarning };
@@ -13253,10 +13296,6 @@ async function handlePlan(adapter2, config2, args) {
       }
       const skipHandoffs = args.skip_handoffs === true;
       const result = await preparePlan(adapter2, config2, filters, focus, force, handoffsOnly, skipHandoffs, tracker);
-      tracker.setStreamScope({ cycle: result.cycleNumber + 1 });
-      for (const step of ["health-check", "inbox-triage", "board-integrity", "maturity-gate", "recommendation", "dependency-chain"]) {
-        await tracker.recordStep(step);
-      }
       planPrepareCache.set(callerKey, {
         contextHashes: result.contextHashes,
         userMessage: result.userMessage,
@@ -18835,7 +18874,8 @@ To override, pass force=true (emits a telemetry warning).`
       if (adapter2.getBuildReportsSince) {
         try {
           const cycleReports = (await adapter2.getBuildReportsSince(currentCycle)).filter((r) => r.cycle === currentCycle);
-          [snapshot] = computeSnapshotsFromBuildReports(cycleReports);
+          const cycleTasks = (await adapter2.queryBoard({ cycleSince: currentCycle, compact: true })).filter((t) => t.cycle === currentCycle);
+          [snapshot] = computeSnapshotsFromBuildReports(cycleReports, cycleTasks);
         } catch (err) {
           console.error(
             `[release] cycle-metrics snapshot compute failed for cycle ${currentCycle} (non-blocking): ${err instanceof Error ? err.message : String(err)}`
@@ -20071,6 +20111,9 @@ async function describeTask(adapter2, taskId) {
   }
   return { task };
 }
+function shouldBlockDirtyBranchSwitch(opts) {
+  return opts.trackedDirtyCount > 0 && opts.currentBranch !== opts.baseBranch && opts.currentBranch !== opts.featureBranch;
+}
 async function startBuild(adapter2, config2, taskId, options = {}, clientName) {
   const task = await adapter2.getTask(taskId);
   if (!task) {
@@ -20192,11 +20235,11 @@ async function startBuild(adapter2, config2, taskId, options = {}, clientName) {
         branchLines.push(`Base branch '${config2.baseBranch}' not found \u2014 using '${baseBranch}'.`);
       }
       const trackedDirty = getTrackedModifiedFiles(config2.projectRoot);
-      if (trackedDirty.length > 0 && currentBranch !== baseBranch) {
+      if (shouldBlockDirtyBranchSwitch({ trackedDirtyCount: trackedDirty.length, currentBranch, baseBranch, featureBranch })) {
         const shown = trackedDirty.slice(0, 5).join(", ");
         const more = trackedDirty.length > 5 ? ` (+${trackedDirty.length - 5} more)` : "";
         throw new Error(
-          `build_execute won't switch branches: the working tree has uncommitted changes on '${currentBranch}' (this task targets '${featureBranch}'). Another session may be working there, and switching would revert those files. Commit or stash them first, or run build_execute from '${baseBranch}'. Dirty: ${shown}${more}.`
+          `build_execute won't switch branches: the working tree has uncommitted changes on '${currentBranch}' (this task targets '${featureBranch}'). Another session may be working there, and switching would revert those files. Commit or stash them first, run build_execute from '${baseBranch}', or check out '${featureBranch}' if this is your own in-progress work. Dirty: ${shown}${more}.`
         );
       }
       if (hasUncommittedChanges(config2.projectRoot, AUTO_WRITTEN_PATHS)) {
@@ -20369,7 +20412,8 @@ function extractDocMeta(absolutePath, relativePath, cycleNumber) {
   }
   return { title, type, cycle, summary, tags: [] };
 }
-function assertDeployVerification(config2, input) {
+function assertDeployVerification(config2, input, opts = { deployingNow: true }) {
+  if (!opts.deployingNow) return;
   if (config2.adapterType !== "pg" && config2.adapterType !== "proxy") return;
   let triggerHits = [];
   try {
@@ -20378,6 +20422,8 @@ function assertDeployVerification(config2, input) {
     return;
   }
   if (triggerHits.length === 0) return;
+  const mergeDeployHits = triggerHits.filter((p) => !isDeployAtReleaseSurface(p));
+  if (mergeDeployHits.length === 0) return;
   const verification = input.productionVerification;
   if (!verification) {
     const targetLine = config2.verifyCommand ? `
@@ -20391,25 +20437,28 @@ Run a curl against the live deploy and pass production_verification on build_exe
   { urls, curl_command, http_status, response_excerpt, verified_at }
 `;
     throw new Error(
-      `Deploy-verification required: this branch's diff touches ${triggerHits.length} trigger-surface file(s):
-` + triggerHits.map((p) => `  - ${p}`).join("\n") + targetLine + `
-Trigger surface is enforced because changes here have historically shipped to prod undetected (C166, C264-C265, C271).`
+      `Deploy-verification required: this branch's diff touches ${mergeDeployHits.length} deploy-on-merge trigger-surface file(s):
+` + mergeDeployHits.map((p) => `  - ${p}`).join("\n") + targetLine + `
+Trigger surface is enforced because changes here have historically shipped to prod undetected (C166, C264-C265, C271). Edge/data-proxy diffs (supabase/functions/**) are verified at release instead.`
     );
   }
   if (verification.http_status < 200 || verification.http_status >= 300) {
     throw new Error(
       `Deploy-verification failed: production_verification reports http_status=${verification.http_status} on a trigger-surface task.
-Trigger files touched: ${triggerHits.join(", ")}
+Trigger files touched: ${mergeDeployHits.join(", ")}
 Fix the deploy first, then re-run build_execute complete with a 2xx verification.`
     );
   }
 }
+function isDeployAtReleaseSurface(path7) {
+  return path7.startsWith("supabase/functions/");
+}
 async function completeBuild(adapter2, config2, taskId, input, options = {}, clientName) {
   const task = await adapter2.getTask(taskId);
   if (!task) {
     throw new Error(`Task "${taskId}" not found on the Cycle Board.`);
   }
-  assertDeployVerification(config2, input);
+  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)
@@ -22195,7 +22244,7 @@ function collectDiagnostics(config2) {
 }
 var bugTool = {
   name: "bug",
-  description: 'Report a bug OR submit an idea. Routing: a bug about PAPI itself (a PAPI tool/MCP error, the connector, a handoff/cycle problem) auto-submits UPSTREAM to PAPI maintainers with diagnostics \u2014 you do NOT need to set report=true for these. A bug in the user\'s OWN project auto-files as a Backlog task on their board. Override the routing explicitly: report=true forces upstream, report=false forces the user\'s own board. Set `type` ("bug"/"idea") and optional notify-when-fixed / contact-ok consent for upstream submissions. Does not call the Anthropic API.',
+  description: `Report a bug OR submit an idea. Routing: a bug about PAPI itself (a PAPI tool/MCP error, the connector, a handoff/cycle problem) auto-submits UPSTREAM to PAPI maintainers with diagnostics \u2014 you do NOT need to set report=true for these. A bug in the user's OWN project auto-files as a Backlog task on their board. IMPORTANT: report=true is ONLY for a genuine PAPI-product defect \u2014 it is NOT the catch-all for "not about my app". A bug in the user's harness/editor/OS/git/other tooling (e.g. Claude Code, Codex, VS Code, a shell command) is NOT a PAPI bug: file it on the user's own board (report=false / default) or that tool's own tracker, never upstream. Override the routing explicitly: report=true forces upstream (PAPI-product only), report=false forces the user's own board. Set \`type\` ("bug"/"idea") and optional notify-when-fixed / contact-ok consent for upstream submissions. Does not call the Anthropic API.`,
   annotations: { readOnlyHint: false, destructiveHint: false },
   inputSchema: {
     type: "object",
@@ -22227,7 +22276,7 @@ var bugTool = {
       },
       report: {
         type: "boolean",
-        description: "Routing override. Leave UNSET to auto-route: PAPI-product bugs go upstream to maintainers, project-domain bugs go to the user's board. Set true to force an upstream diagnostic submission; set false to force a task on the user's own board (use false when an auto-detected PAPI bug is actually about the user's project)."
+        description: "Routing override. Leave UNSET to auto-route: PAPI-product bugs go upstream to maintainers, project-domain bugs go to the user's board. Set true ONLY for a genuine PAPI-product defect (PAPI tool/MCP/connector/handoff) \u2014 a bug in the user's harness/editor/OS/other tooling is NOT a PAPI bug and must go to their own board (report=false or default), not upstream. Set false to force a task on the user's own board (use false when an auto-detected PAPI bug is actually about the user's project, harness, or environment)."
       },
       type: {
         type: "string",
@@ -22244,7 +22293,7 @@ var bugTool = {
       },
       project: {
         type: "string",
-        description: "Project id (UUID) or slug to file this bug under, overriding the session project for THIS call only. Must be a project on your account \u2014 fails closed otherwise. Use project_switch to change the session default."
+        description: "BOARD MODE ONLY. Project id (UUID) or slug to file this bug under, overriding the session project for THIS call only. Must be a project on your account \u2014 fails closed otherwise. It CANNOT redirect an upstream (report=true) submission \u2014 those always go to PAPI maintainers. Use project_switch to change the session default."
       }
     },
     required: ["text"]
@@ -24698,7 +24747,12 @@ async function getHealthSummary(adapter2) {
   try {
     try {
       buildReports = await adapter2.getRecentBuildReports(50);
-      snapshots = computeSnapshotsFromBuildReports(buildReports);
+      let metricsTasks = [];
+      try {
+        metricsTasks = await adapter2.queryBoard({ cycleSince: Math.max(1, cycleNumber - 6), compact: true });
+      } catch {
+      }
+      snapshots = computeSnapshotsFromBuildReports(buildReports, metricsTasks);
     } catch {
     }
     metricsSection = formatCycleMetrics(snapshots);

package/dist/prompts.js

@@ -661,7 +661,7 @@ function buildHandoffsOnlyUserMessage(inputs) {
 }
 function extractDependencyChain(displayText) {
   const match = displayText.match(
-    /^##\s+Dependency Chain[^\n]*\n([\s\S]*?)(?=\n#{2,3}\s|$(?![\s\S]))/m
+    /^##\s+Dependency Chain[^\n]*\n([\s\S]*?)(?=\n#{2,3}\s|\n-{3,}\s*(?:\n|$)|\n\s*BUILD HANDOFF\b|\n<!--\s*PAPI_STRUCTURED_OUTPUT|$(?![\s\S]))/m
   );
   if (!match) return void 0;
   const body = match[1].trim();

package/package.json

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