@papi-ai/server 0.7.54 → 0.7.55

package/dist/backfill-cycle-metrics.js

@@ -1065,7 +1065,7 @@ var init_install_id = __esm({
 function reportTelemetryEmitFailure(reason, ctx) {
   consecutiveTelemetryFailures += 1;
   console.error(
-    `[telemetry] emit failed (${reason}) tool=${ctx.toolName} event=${ctx.eventType} project=${ctx.projectId}`
+    `[telemetry] emit failed (${reason}) tool=${ctx.toolName} event=${ctx.eventType} project=${ctx.projectId ?? "(none)"}`
   );
   if (consecutiveTelemetryFailures >= TELEMETRY_BLACKOUT_THRESHOLD) {
     console.error(
@@ -1561,18 +1561,19 @@ Check PAPI_PROJECT_ID in your .mcp.json config. Find your project ID in the PAPI
        */
       emitTelemetry(event) {
         const ctx = { projectId: event.projectId, toolName: event.toolName, eventType: event.eventType };
+        const payload = {
+          toolName: event.toolName,
+          eventType: event.eventType,
+          metadata: event.metadata ?? {}
+        };
+        if (event.projectId) payload["projectId"] = event.projectId;
         fetch(`${this.endpoint}/telemetry`, {
           method: "POST",
           headers: {
             "Content-Type": "application/json",
             "Authorization": `Bearer ${this.apiKey}`
           },
-          body: JSON.stringify({
-            projectId: event.projectId,
-            toolName: event.toolName,
-            eventType: event.eventType,
-            metadata: event.metadata ?? {}
-          }),
+          body: JSON.stringify(payload),
           signal: AbortSignal.timeout(5e3)
         }).then((res) => {
           if (res.ok) noteTelemetryEmitSuccess();

package/dist/index.js

@@ -1103,7 +1103,7 @@ function isEnabled() {
 function reportTelemetryEmitFailure(reason, ctx) {
   consecutiveTelemetryFailures += 1;
   console.error(
-    `[telemetry] emit failed (${reason}) tool=${ctx.toolName} event=${ctx.eventType} project=${ctx.projectId}`
+    `[telemetry] emit failed (${reason}) tool=${ctx.toolName} event=${ctx.eventType} project=${ctx.projectId ?? "(none)"}`
   );
   if (consecutiveTelemetryFailures >= TELEMETRY_BLACKOUT_THRESHOLD) {
     console.error(
@@ -1120,11 +1120,11 @@ function emitTelemetryEvent(event) {
   if (!apiKey) return;
   const endpoint = process.env["PAPI_DATA_ENDPOINT"] ?? DEFAULT_TELEMETRY_ENDPOINT;
   const body = {
-    projectId: event.project_id,
     toolName: event.tool_name,
     eventType: event.event_type,
     metadata: event.metadata ?? {}
   };
+  if (event.project_id) body["projectId"] = event.project_id;
   const ctx = {
     projectId: event.project_id,
     toolName: event.tool_name,
@@ -1678,18 +1678,19 @@ Check PAPI_PROJECT_ID in your .mcp.json config. Find your project ID in the PAPI
        */
       emitTelemetry(event) {
         const ctx = { projectId: event.projectId, toolName: event.toolName, eventType: event.eventType };
+        const payload = {
+          toolName: event.toolName,
+          eventType: event.eventType,
+          metadata: event.metadata ?? {}
+        };
+        if (event.projectId) payload["projectId"] = event.projectId;
         fetch(`${this.endpoint}/telemetry`, {
           method: "POST",
           headers: {
             "Content-Type": "application/json",
             "Authorization": `Bearer ${this.apiKey}`
           },
-          body: JSON.stringify({
-            projectId: event.projectId,
-            toolName: event.toolName,
-            eventType: event.eventType,
-            metadata: event.metadata ?? {}
-          }),
+          body: JSON.stringify(payload),
           signal: AbortSignal.timeout(5e3)
         }).then((res) => {
           if (res.ok) noteTelemetryEmitSuccess();
@@ -8411,6 +8412,9 @@ function computeCycleEffort(cycleTaskRows, cycleReports) {
     deliveredPoints: cycleReports.reduce((s, r) => s + effortWeight(r.actualEffort || r.estimatedEffort), 0)
   };
 }
+function velocityPoints(v) {
+  return v.deliveredPoints ?? v.effortPoints;
+}
 function computeSnapshotsFromBuildReports(reports, tasks) {
   const reportsByCycle = /* @__PURE__ */ new Map();
   for (const r of reports) {
@@ -8461,22 +8465,22 @@ function formatCycleMetrics(snapshots) {
     const avgPlanned = Math.round(
       recentVelocities.reduce((sum, v) => sum + v.effortPoints, 0) / recentVelocities.length * 10
     ) / 10;
-    const withDelivered = recentVelocities.filter((v) => v.deliveredPoints !== void 0);
-    const avgDelivered = withDelivered.length > 0 ? Math.round(withDelivered.reduce((sum, v) => sum + (v.deliveredPoints ?? 0), 0) / withDelivered.length * 10) / 10 : void 0;
-    lines.push("**Cycle Sizing \u2014 planned vs delivered effort points**");
+    const avgDelivered = Math.round(
+      recentVelocities.reduce((sum, v) => sum + velocityPoints(v), 0) / recentVelocities.length * 10
+    ) / 10;
+    const anyDelivered = recentVelocities.some((v) => v.deliveredPoints !== void 0);
+    lines.push("**Velocity \u2014 delivered effort points (size the next cycle from this)**");
     lines.push(
-      `- Last ${recentVelocities.length} cycles: ` + recentVelocities.map((v) => v.deliveredPoints !== void 0 ? `S${v.cycle}=${v.effortPoints} planned/${v.deliveredPoints} delivered` : `S${v.cycle}=${v.effortPoints} planned`).join(", ")
+      `- Last ${recentVelocities.length} cycles: ` + recentVelocities.map((v) => v.deliveredPoints !== void 0 ? `S${v.cycle}=${v.deliveredPoints} delivered/${v.effortPoints} planned` : `S${v.cycle}=${v.effortPoints} planned (no delivered data \u2014 using planned)`).join(", ")
     );
-    if (avgDelivered !== void 0) {
+    lines.push(`- Velocity (avg delivered): ${avgDelivered} pts/cycle (XS=1, S=2, M=3, L=5, XL=8)`);
+    if (anyDelivered) {
       const delta = Math.round((avgDelivered - avgPlanned) * 10) / 10;
       const sign = delta > 0 ? "+" : "";
       const read = delta === 0 ? "delivered matches planned" : delta > 0 ? "cycles cost MORE than scoped (under-scoping)" : "cycles cost LESS than scoped (over-scoping)";
-      lines.push(`- Average: ${avgPlanned} planned / ${avgDelivered} delivered (XS=1, S=2, M=3, L=5, XL=8)`);
-      lines.push(`- Scope accuracy: ${sign}${delta} pts/cycle \u2014 ${read}.`);
-    } else {
-      lines.push(`- Average: ${avgPlanned} planned effort points/cycle (XS=1, S=2, M=3, L=5, XL=8)`);
+      lines.push(`- Scope accuracy (drift vs planned): planned averaged ${avgPlanned} pts/cycle \u2014 ${sign}${delta} pts, ${read}.`);
     }
-    lines.push(`- Size cycles on what the selected tasks actually require \u2014 planned is a reference, not a target.`);
+    lines.push(`- Size cycles on what the selected tasks actually cost \u2014 delivered is the signal, planned is the estimate that was wrong.`);
   }
   return lines.join("\n");
 }
@@ -8490,7 +8494,9 @@ function formatDerivedMetrics(snapshots, backlogTasks) {
       const latest = recent[recent.length - 1];
       lines.push("**Cycle History (5-cycle avg)**");
       lines.push(`- Average: ${avg.toFixed(1)} tasks/cycle`);
-      lines.push(`- Latest (Cycle ${latest.cycle}): ${latest.completed} tasks, ${latest.effortPoints} effort points`);
+      const latestDelivered = velocityPoints(latest);
+      const plannedNote = latest.deliveredPoints !== void 0 && latest.deliveredPoints !== latest.effortPoints ? ` (planned ${latest.effortPoints})` : "";
+      lines.push(`- Latest (Cycle ${latest.cycle}): ${latest.completed} tasks, ${latestDelivered} effort points delivered${plannedNote}`);
     }
   }
   const activeTasks = backlogTasks.filter(
@@ -14072,6 +14078,7 @@ function extractTrendPoints(snapshots) {
       matchRate: accuracyRow.matchRate,
       bias: accuracyRow.bias,
       effortPoints: velocityRow.effortPoints,
+      deliveredPoints: velocityPoints(velocityRow),
       completed: velocityRow.completed
     });
   }
@@ -14085,7 +14092,8 @@ function generateValueReport(snapshots) {
   const first = recent[0];
   const last = recent[recent.length - 1];
   const matchRateDelta = last.matchRate - first.matchRate;
-  const effortDelta = last.effortPoints - first.effortPoints;
+  const effortDelta = last.deliveredPoints - first.deliveredPoints;
+  const plannedDelta = last.effortPoints - first.effortPoints;
   const completedDelta = last.completed - first.completed;
   const biasTrend = assessBiasTrend(first.bias, last.bias);
   const lines = [];
@@ -14094,7 +14102,8 @@ function generateValueReport(snapshots) {
   lines.push("");
   lines.push(`- **Scope accuracy:** ${first.matchRate}% \u2192 ${last.matchRate}% (${formatDelta(matchRateDelta, "pp")})`);
   lines.push(`- **Estimation bias:** ${formatBias(first.bias)} \u2192 ${formatBias(last.bias)} (${biasTrend})`);
-  lines.push(`- **Velocity:** ${first.effortPoints} \u2192 ${last.effortPoints} effort points/cycle (${formatDelta(effortDelta, "")})`);
+  lines.push(`- **Velocity (delivered):** ${first.deliveredPoints} \u2192 ${last.deliveredPoints} effort points/cycle (${formatDelta(effortDelta, "")})`);
+  lines.push(`- **Planned (for drift):** ${first.effortPoints} \u2192 ${last.effortPoints} effort points/cycle (${formatDelta(plannedDelta, "")})`);
   lines.push(`- **Throughput:** ${first.completed} \u2192 ${last.completed} tasks/cycle (${formatDelta(completedDelta, "")})`);
   return lines.join("\n");
 }
@@ -24992,7 +25001,7 @@ function computeHealthScore(cycleNumber, snapshots, activeTasks, decisionUsage)
   const recentSnaps = snapshots.slice(-3);
   const baselineSnaps = snapshots.slice(-10);
   if (recentSnaps.length > 0 && baselineSnaps.length > 0) {
-    const avg = (snaps) => snaps.reduce((s, sn) => s + (sn.velocity[0]?.effortPoints ?? 0), 0) / snaps.length;
+    const avg = (snaps) => snaps.reduce((s, sn) => s + (sn.velocity[0] ? velocityPoints(sn.velocity[0]) : 0), 0) / snaps.length;
     const recentAvg = avg(recentSnaps);
     const baselineAvg = avg(baselineSnaps);
     const velocityScore = baselineAvg > 0 ? Math.min(100, Math.round(recentAvg / baselineAvg * 100)) : 50;
@@ -29064,7 +29073,7 @@ ${usageLine(decision.usage)}`;
       emitMdAdapterPing(name, { duration_ms: elapsed, success: !isError }, config2.userId, mdProjectSlug);
     }
     const telemetryProjectId = resolveTelemetryProjectId(config2);
-    if (telemetryProjectId) {
+    {
       const adapterEmit = adapter2.emitTelemetry?.bind(adapter2) ?? null;
       if (adapterEmit) {
         adapterEmit({

package/package.json

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