@papi-ai/server 0.7.56 → 0.7.57

package/dist/index.js

@@ -8425,6 +8425,21 @@ function computeCycleEffort(cycleTaskRows, cycleReports) {
 function velocityPoints(v) {
   return v.deliveredPoints ?? v.effortPoints;
 }
+function resolveCompletedCycleDates(existingStart, earliestActivity, now) {
+  const startDate = existingStart || earliestActivity || now;
+  const startMs = Date.parse(startDate);
+  const endMs = Date.parse(now);
+  const known = Number.isFinite(startMs) && Number.isFinite(endMs) && startMs < endMs;
+  return { startDate, endDate: known ? now : null };
+}
+function earliestCycleActivity(reports) {
+  let earliest;
+  for (const r of reports) {
+    const ts = r.startedAt || r.createdAt || r.date;
+    if (ts && (!earliest || Date.parse(ts) < Date.parse(earliest))) earliest = ts;
+  }
+  return earliest;
+}
 function computeSnapshotsFromBuildReports(reports, tasks) {
   const reportsByCycle = /* @__PURE__ */ new Map();
   for (const r of reports) {
@@ -8826,7 +8841,7 @@ PRE-BUILD VERIFICATION
 [List 2-5 specific file paths the builder should read BEFORE implementing to check if the functionality already exists. Derive these from FILES LIKELY TOUCHED \u2014 pick the files most likely to already contain the target functionality. ALSO mandate a docs sweep, not just file-existence (task-2161): name any docs the builder should check via doc_search or the docs index \u2014 a design/research/status:final doc or a prior task may already cover the work. If >80% of the scope is already implemented, the builder should report "already built" instead of re-implementing. Include this section for EVERY task \u2014 it prevents wasted build slots on already-shipped code.]
 
 FILES LIKELY TOUCHED
-[files]
+[files \u2014 real paths only. TEST FILE LOCATIONS (task-2606): PAPI tests are NOT co-located next to source in a src/**/__tests__/ folder. Use the actual layout: server tests \u2192 packages/server/tests/<name>.test.ts; adapter-pg tests \u2192 packages/adapter-pg/src/__tests__/<name>.test.ts; dashboard/root tests \u2192 tests/<area>/<name>.test.ts. Do NOT invent packages/server/src/**/__tests__/ paths \u2014 they do not exist.]
 
 EFFORT
 [XS/S/M/L/XL]
@@ -9983,7 +9998,7 @@ REFERENCE DOCS
 [Optional \u2014 paths to docs/ files with background context. Omit if not needed.]
 
 FILES LIKELY TOUCHED
-[files]
+[files \u2014 real paths only. TEST FILE LOCATIONS (task-2606): PAPI tests are NOT co-located next to source in a src/**/__tests__/ folder. Use the actual layout: server tests \u2192 packages/server/tests/<name>.test.ts; adapter-pg tests \u2192 packages/adapter-pg/src/__tests__/<name>.test.ts; dashboard/root tests \u2192 tests/<area>/<name>.test.ts. Do NOT invent packages/server/src/**/__tests__/ paths \u2014 they do not exist.]
 
 EFFORT
 [XS/S/M/L/XL]`;
@@ -19056,20 +19071,11 @@ To override, pass force=true (emits a telemetry warning).`
         existing = (await adapter2.readCycles()).find((c) => c.number === currentCycle);
       } catch {
       }
-      const completedCycle = {
-        id: `cycle-${currentCycle}`,
-        number: currentCycle,
-        status: "complete",
-        startDate: existing?.startDate ?? (/* @__PURE__ */ new Date()).toISOString(),
-        endDate: (/* @__PURE__ */ new Date()).toISOString(),
-        goals: existing?.goals ?? [],
-        boardHealth: existing?.boardHealth ?? "",
-        taskIds: existing?.taskIds ?? []
-      };
       let snapshot;
+      let cycleReports = [];
       if (adapter2.getBuildReportsSince) {
         try {
-          const cycleReports = (await adapter2.getBuildReportsSince(currentCycle)).filter((r) => r.cycle === currentCycle);
+          cycleReports = (await adapter2.getBuildReportsSince(currentCycle)).filter((r) => r.cycle === currentCycle);
           const cycleTasks = (await adapter2.queryBoard({ cycleSince: currentCycle, compact: true })).filter((t) => t.cycle === currentCycle);
           [snapshot] = computeSnapshotsFromBuildReports(cycleReports, cycleTasks);
         } catch (err) {
@@ -19078,6 +19084,22 @@ To override, pass force=true (emits a telemetry warning).`
           );
         }
       }
+      const releaseNow = (/* @__PURE__ */ new Date()).toISOString();
+      const { startDate: resolvedStart, endDate: resolvedEnd } = resolveCompletedCycleDates(
+        existing?.startDate,
+        earliestCycleActivity(cycleReports),
+        releaseNow
+      );
+      const completedCycle = {
+        id: `cycle-${currentCycle}`,
+        number: currentCycle,
+        status: "complete",
+        startDate: resolvedStart,
+        endDate: resolvedEnd ?? void 0,
+        goals: existing?.goals ?? [],
+        boardHealth: existing?.boardHealth ?? "",
+        taskIds: existing?.taskIds ?? []
+      };
       if (typeof adapter2.commitRelease === "function") {
         try {
           await adapter2.commitRelease({ cycle: completedCycle, snapshot: snapshot ?? null });
@@ -25782,6 +25804,50 @@ function countStalledP1(warnings) {
   const matches = stallLine.match(/task-\d+/g);
   return matches ? matches.length : 0;
 }
+function truncateTaskTitle(title, max = 55) {
+  const t = (title ?? "").trim();
+  if (!t) return "untitled";
+  if (t.length <= max) return t;
+  return t.slice(0, max - 1).trimEnd() + "\u2026";
+}
+async function resolveCarryForwardRefs(carryForward, tasks, adapter2) {
+  const refs = /* @__PURE__ */ new Map();
+  const ids = carryForward?.match(/\btask-\d+\b/g);
+  if (!ids) return refs;
+  const unique = [...new Set(ids)];
+  const byId = new Map(tasks.filter((t) => t.displayId).map((t) => [t.displayId, t]));
+  const missing = [];
+  for (const id of unique) {
+    const t = byId.get(id);
+    if (t) refs.set(id, { title: t.title, status: t.status });
+    else missing.push(id);
+  }
+  if (missing.length > 0 && adapter2?.getTasks) {
+    try {
+      const fetched = await adapter2.getTasks(missing);
+      for (const t of fetched) {
+        if (t.displayId) refs.set(t.displayId, { title: t.title, status: t.status });
+      }
+    } catch {
+    }
+  }
+  return refs;
+}
+function annotateTaskRefs(text, refs) {
+  if (!text || refs.size === 0) return text;
+  const RESOLVED = /* @__PURE__ */ new Set(["Done", "Cancelled"]);
+  return text.replace(/\btask-\d+\b(?!\s*[(—–-])/g, (id, offset, full) => {
+    const ref = refs.get(id);
+    if (!ref) return id;
+    const rest = full.slice(offset + id.length);
+    if (/^\s*[(—–-]/.test(rest)) return id;
+    const resolved = ref.status && RESOLVED.has(ref.status);
+    const titlePart = ref.title ? ` \u2014 ${truncateTaskTitle(ref.title)}` : "";
+    const statusPart = resolved ? ` [\u2713 ${ref.status}]` : "";
+    if (!titlePart && !statusPart) return id;
+    return `${id}${titlePart}${statusPart}`;
+  });
+}
 function formatSynthesisParagraph(opts) {
   const parts = [];
   parts.push(
@@ -25801,7 +25867,7 @@ function formatSynthesisParagraph(opts) {
   parts.push(`Next: ${cleanMode}`);
   return parts.join(" ");
 }
-function formatOrientSummary(health, buildInfo, hierarchy, latestTag, projectRoot, environment = "unknown", subAgents = [], projectName, teamSummary, clientName) {
+function formatOrientSummary(health, buildInfo, hierarchy, latestTag, projectRoot, environment = "unknown", subAgents = [], projectName, teamSummary, clientName, taskRefs = /* @__PURE__ */ new Map()) {
   const lines = [];
   const cycleIsComplete = health.latestCycleStatus === "complete";
   const tagSuffix = latestTag ? ` \u2014 ${latestTag}` : "";
@@ -25944,7 +26010,7 @@ function formatOrientSummary(health, buildInfo, hierarchy, latestTag, projectRoo
   const hasCarryForward = health.carryForward !== "None found" && !health.carryForward.startsWith("No carry-forward");
   if (hasCarryForward) {
     lines.push("## Carry-Forward");
-    lines.push(health.carryForward);
+    lines.push(annotateTaskRefs(health.carryForward, taskRefs));
     lines.push("");
   }
   const hasMetrics = health.metricsSection !== "Could not read methodology metrics." && !health.metricsSection.includes("undefined");
@@ -26233,7 +26299,7 @@ async function handleOrient(adapter2, config2, args = {}, clientName) {
           (t) => t.createdCycle != null && currentCycle - t.createdCycle >= 3
         );
         if (stalledP1.length === 0) return void 0;
-        const ids = stalledP1.map((t) => `${t.displayId} (${currentCycle - (t.createdCycle ?? currentCycle)}+ cycles)`).join(", ");
+        const ids = stalledP1.map((t) => `${t.displayId} \u2014 ${truncateTaskTitle(t.title)} (${currentCycle - (t.createdCycle ?? currentCycle)}+ cycles)`).join(", ");
         return `\u26A0\uFE0F P1 tasks stalled 3+ cycles: ${ids}`;
       }),
       // task-1917 (C280): Owner Action Queue surface. Counts the user's open
@@ -26251,10 +26317,12 @@ async function handleOrient(adapter2, config2, args = {}, clientName) {
           let dueSuffix = "";
           if (adapter2.countDueOwnerActions) {
             const due = await adapter2.countDueOwnerActions(userId, projectId);
-            const parts = [];
-            if (due.dueToday > 0) parts.push(`${due.dueToday} due today`);
-            if (due.overdue > 0) parts.push(`${due.overdue} overdue`);
-            if (parts.length > 0) dueSuffix = ` (${parts.join(", ")})`;
+            if (due.urgent > 0) {
+              const detail = [];
+              if (due.overdue > 0) detail.push(`${due.overdue} overdue`);
+              if (due.dueToday > 0) detail.push(`${due.dueToday} due today`);
+              dueSuffix = detail.length > 0 ? ` (${due.urgent} need you now \u2014 ${detail.join(", ")})` : ` (${due.urgent} need you now)`;
+            }
           }
           return `\u26A0\uFE0F ${count} action${count === 1 ? "" : "s"} waiting on you${dueSuffix} \u2014 open /hub to triage the Owner Action Queue.`;
         } catch {
@@ -26657,7 +26725,8 @@ ${section}`;
     ]);
     const teamSummary = [teamSummaryLine, releaseHistoryLine].filter(Boolean).join("\n") || void 0;
     const deepHint = deepHousekeeping ? "" : "\n\n*Tip: pass `full: true` for Research Signals + version-drift, or `deep_housekeeping: true` to also check orphaned branches, merged-but-In-Progress tasks, unrecorded commits, unregistered docs, and stale skill forks (implies `full`).*";
-    return textResponse(projectBannerNote + formatOrientSummary(healthResult, buildInfo, hierarchy, latestTag, config2.projectRoot, environment, subAgents, projectName, teamSummary, clientName) + unblockNote + deferredGateNote + feedbackResolvedNote + alertsNote + ttfvNote + reconciliationNote + mergedInProgressNote + unrecordedNote + unregisteredDocsNote + staleSkillsNote + researchSignalsNote + recsNote + pendingReviewNote + patternsNote + unactionedIssuesNote + skillProposalsNote + sessionGuidanceNote + versionNote + enrichmentNote + deliveryShapeNote + preBuildCheckNote + deepHint + enrichmentFilesSection);
+    const carryForwardRefs = await resolveCarryForwardRefs(healthResult.carryForward, allTasks, adapter2);
+    return textResponse(projectBannerNote + formatOrientSummary(healthResult, buildInfo, hierarchy, latestTag, config2.projectRoot, environment, subAgents, projectName, teamSummary, clientName, carryForwardRefs) + unblockNote + deferredGateNote + feedbackResolvedNote + alertsNote + ttfvNote + reconciliationNote + mergedInProgressNote + unrecordedNote + unregisteredDocsNote + staleSkillsNote + researchSignalsNote + recsNote + pendingReviewNote + patternsNote + unactionedIssuesNote + skillProposalsNote + sessionGuidanceNote + versionNote + enrichmentNote + deliveryShapeNote + preBuildCheckNote + deepHint + enrichmentFilesSection);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     const isKnownFriendly = /^(Orient failed|Project not found|No project|Setup required)/i.test(message);

package/dist/prompts.js

@@ -69,7 +69,7 @@ PRE-BUILD VERIFICATION
 [List 2-5 specific file paths the builder should read BEFORE implementing to check if the functionality already exists. Derive these from FILES LIKELY TOUCHED \u2014 pick the files most likely to already contain the target functionality. ALSO mandate a docs sweep, not just file-existence (task-2161): name any docs the builder should check via doc_search or the docs index \u2014 a design/research/status:final doc or a prior task may already cover the work. If >80% of the scope is already implemented, the builder should report "already built" instead of re-implementing. Include this section for EVERY task \u2014 it prevents wasted build slots on already-shipped code.]
 
 FILES LIKELY TOUCHED
-[files]
+[files \u2014 real paths only. TEST FILE LOCATIONS (task-2606): PAPI tests are NOT co-located next to source in a src/**/__tests__/ folder. Use the actual layout: server tests \u2192 packages/server/tests/<name>.test.ts; adapter-pg tests \u2192 packages/adapter-pg/src/__tests__/<name>.test.ts; dashboard/root tests \u2192 tests/<area>/<name>.test.ts. Do NOT invent packages/server/src/**/__tests__/ paths \u2014 they do not exist.]
 
 EFFORT
 [XS/S/M/L/XL]
@@ -1226,7 +1226,7 @@ REFERENCE DOCS
 [Optional \u2014 paths to docs/ files with background context. Omit if not needed.]
 
 FILES LIKELY TOUCHED
-[files]
+[files \u2014 real paths only. TEST FILE LOCATIONS (task-2606): PAPI tests are NOT co-located next to source in a src/**/__tests__/ folder. Use the actual layout: server tests \u2192 packages/server/tests/<name>.test.ts; adapter-pg tests \u2192 packages/adapter-pg/src/__tests__/<name>.test.ts; dashboard/root tests \u2192 tests/<area>/<name>.test.ts. Do NOT invent packages/server/src/**/__tests__/ paths \u2014 they do not exist.]
 
 EFFORT
 [XS/S/M/L/XL]`;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@papi-ai/server",
-  "version": "0.7.56",
-  "description": "PAPI MCP server — AI-powered sprint planning, build execution, and strategy review for software projects",
+  "version": "0.7.57",
+  "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",
   "type": "module",