@papi-ai/server 0.7.74 → 0.7.75

package/dist/index.js

@@ -5041,7 +5041,7 @@ var setup_exports = {};
 __export(setup_exports, {
   runSetup: () => runSetup
 });
-import { existsSync as existsSync15, readFileSync as readFileSync17, writeFileSync as writeFileSync8, chmodSync as chmodSync2, statSync as statSync8 } from "fs";
+import { existsSync as existsSync15, readFileSync as readFileSync17, writeFileSync as writeFileSync8, chmodSync as chmodSync2, statSync as statSync9 } from "fs";
 import { join as join24 } from "path";
 function baseUrl() {
   const fromEnv = process.env["PAPI_HOST"] ?? process.env["PAPI_BASE_URL"];
@@ -5101,7 +5101,7 @@ function writeMcpJson(opts) {
   parsed.mcpServers = mcpServers;
   writeFileSync8(path7, JSON.stringify(parsed, null, 2) + "\n", "utf-8");
   try {
-    const mode = statSync8(path7).mode & 511;
+    const mode = statSync9(path7).mode & 511;
     if (mode !== 384) chmodSync2(path7, 384);
   } catch {
   }
@@ -5211,7 +5211,7 @@ var init_setup = __esm({
 // src/index.ts
 import { readFileSync as readFileSync18 } from "fs";
 import { dirname as dirname6, join as join25, basename as basename2 } from "path";
-import { fileURLToPath as fileURLToPath4 } from "url";
+import { fileURLToPath as fileURLToPath5 } from "url";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { Server as Server2 } from "@modelcontextprotocol/sdk/server/index.js";
 import {
@@ -8257,7 +8257,7 @@ Check PAPI_PROJECT_ID in your .mcp.json config. Find your project ID in the PAPI
 import { readFileSync as readFileSync13 } from "fs";
 import { access as access4, readdir as readdir4, readFile as readFile9 } from "fs/promises";
 import { join as join20, dirname as dirname5 } from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
+import { fileURLToPath as fileURLToPath4 } from "url";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import {
   CallToolRequestSchema,
@@ -8284,6 +8284,8 @@ var UNIVERSAL_FRAME = `PAPI gives this project a structured plan \u2192 build \u
 
 5. VERIFY BEFORE DONE. Test the change and confirm it works before reporting a task complete. Report failures honestly, with the output.
 
+6. NAME THE PROJECT WHEN YOU KNOW IT. If you know which repo this session is working in, pass \`project="<slug>"\` on the call rather than relying on whatever the connection defaults to. An account with more than one project cannot be resolved from a connection with no project bound \u2014 PAPI will stop and ask which one rather than guess, and answering costs a round trip. If PAPI asks, put the list to the user, then re-call with their choice; run \`project_switch\` to make it stick.
+
 PAPI reads and writes all project state through these tools \u2014 they are the source of truth, not local files.`;
 
 // src/lib/response.ts
@@ -9034,7 +9036,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 \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.]
+[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. MCP RESTART RULE (task-2978): whenever FILES LIKELY TOUCHED includes any \`packages/server/**\` path, append this line verbatim to the handoff \u2014 "MCP RESTART REQUIRED: a mid-session \`npm run mcp-build\` writes a dist the already-booted MCP process never loads, so verifying this change through PAPI's own tools before an explicit MCP reconnect is INVALID. Implement \u2192 mcp-build \u2192 reconnect \u2192 only then verify." This is one line inside this section, not a new section.]
 
 EFFORT
 [XS/S/M/L/XL]
@@ -9048,7 +9050,7 @@ After your natural language output, include this EXACT format on its own line:
 {
   "cycleLogTitle": "string \u2014 short descriptive title WITHOUT 'Cycle N' prefix. Should capture the cycle theme in 3-5 words (e.g. 'MCP Quality + Product Readiness' not 'Cycle 5 \u2014 Board Triage \u2014 Bug Fix'). This is the canonical theme label for the cycle.",
   "cycleLogContent": "string \u2014 5-10 line cycle log body in markdown, NO heading (the ### heading is generated automatically)",
-  "cycleLogCarryForward": "string or null \u2014 carry-forward items for next cycle",
+  "cycleLogCarryForward": "string or null \u2014 carry-forward for the next cycle, in TWO NAMED SECTIONS, product signal FIRST. Section 1 begins with the literal label 'WHAT SHIPS FOR USERS:' and names, concretely, what a person using this project can now see or do, and how to check it \u2014 never a deploy step. Section 2 begins with the literal label 'RELEASE MECHANICS:' and carries everything operational: deploy, publish, migrations, gate order, branch counts, spot-checks. The mechanics are load-bearing and must NOT be dropped or shortened \u2014 they go second, not away. orient parses these two labels and renders the product half first, so the labels are a contract, not decoration. If a cycle genuinely ships nothing user-visible, say so in one line under section 1 rather than omitting the label.",
   "cycleLogNotes": "string or null \u2014 1-3 lines of cycle-level observations: estimation accuracy, recurring blockers, velocity trends, dependency signals. Omit if no noteworthy observations.",
   "nextMode": "Full",
   "boardHealth": "string \u2014 e.g. 5 tasks (3 backlog, 2 done)",
@@ -9912,7 +9914,7 @@ After your natural language output, include this EXACT format on its own line:
 \`\`\`json
 {
   "sessionLogTitle": "string \u2014 Strategy Review title WITHOUT 'Cycle N' prefix (e.g. 'Strategy Review' not 'Cycle 5 \u2014 Strategy Review')",
-  "sessionLogContent": "string \u2014 5-10 line cycle log body summarizing the review, NO heading (the ### heading is generated automatically)",
+  "sessionLogContent": "string \u2014 5-10 line cycle log body summarizing the review, NO heading (the ### heading is generated automatically). LEAD WITH TANGIBLE PRODUCT INSIGHT: open with what was learned about the product, its users, or the market \u2014 a specific finding a reader can act on. Board hygiene, cadence, cycle counts, branch state and other housekeeping are legitimate content but they TRAIL; they must never be the opening line. If the review's most important finding genuinely is an operational one, say why it matters to the product in the same breath rather than reporting it as admin.",
   "velocityAssessment": "string \u2014 2-3 sentence velocity summary",
   "strategicRecommendations": "string \u2014 key recommendations in markdown",
   "activeDecisionUpdates": [
@@ -10276,7 +10278,7 @@ REFERENCE DOCS
 [Optional \u2014 paths to docs/ files with background context. Omit if not needed.]
 
 FILES LIKELY TOUCHED
-[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.]
+[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. MCP RESTART RULE (task-2978): whenever FILES LIKELY TOUCHED includes any \`packages/server/**\` path, append this line verbatim to the handoff \u2014 "MCP RESTART REQUIRED: a mid-session \`npm run mcp-build\` writes a dist the already-booted MCP process never loads, so verifying this change through PAPI's own tools before an explicit MCP reconnect is INVALID. Implement \u2192 mcp-build \u2192 reconnect \u2192 only then verify." This is one line inside this section, not a new section.]
 
 EFFORT
 [XS/S/M/L/XL]`;
@@ -10641,9 +10643,9 @@ async function getPrompt(name) {
   if (!endpoint) {
     return LOCAL_PROMPTS[name];
   }
-  const cached = cache.get(name);
-  if (cached && Date.now() - cached.fetchedAt < CACHE_TTL_MS) {
-    return cached.content;
+  const cached2 = cache.get(name);
+  if (cached2 && Date.now() - cached2.fetchedAt < CACHE_TTL_MS) {
+    return cached2.content;
   }
   try {
     const url = endpoint.endsWith("/") ? `${endpoint}${name}` : `${endpoint}/${name}`;
@@ -10656,19 +10658,19 @@ async function getPrompt(name) {
     }
     const response = await fetch(url, { headers, signal: AbortSignal.timeout(1e4) });
     if (!response.ok) {
-      if (cached) return cached.content;
+      if (cached2) return cached2.content;
       return LOCAL_PROMPTS[name];
     }
     const data = await response.json();
     const content = data.content;
     if (typeof content !== "string" || content.length === 0) {
-      if (cached) return cached.content;
+      if (cached2) return cached2.content;
       return LOCAL_PROMPTS[name];
     }
     cache.set(name, { content, fetchedAt: Date.now() });
     return content;
   } catch {
-    if (cached) return cached.content;
+    if (cached2) return cached2.content;
     return LOCAL_PROMPTS[name];
   }
 }
@@ -24283,7 +24285,7 @@ var ideaTool = {
       },
       project: {
         type: "string",
-        description: "Project id (UUID) or slug to write this idea to, 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: "Project id (UUID) or slug to write this idea to, 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. PASS THIS WHENEVER YOU KNOW WHICH REPO THE SESSION IS IN: on a multi-project account a connection with no project bound cannot be resolved, and PAPI will stop and ask rather than guess."
       }
     },
     required: ["text"]
@@ -24730,7 +24732,7 @@ var backlogImportTool = {
       },
       project: {
         type: "string",
-        description: "Project id (UUID) or slug to import into, overriding the session project for THIS call only. Must be a project on your account \u2014 fails closed otherwise."
+        description: "Project id (UUID) or slug to import into, overriding the session project for THIS call only. Must be a project on your account \u2014 fails closed otherwise. PASS THIS WHENEVER YOU KNOW WHICH REPO THE SESSION IS IN: on a multi-project account a connection with no project bound cannot be resolved, and PAPI will stop and ask rather than guess."
       }
     },
     required: ["source"]
@@ -24938,7 +24940,7 @@ var bugTool = {
       },
       project: {
         type: "string",
-        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."
+        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. PASS THIS WHENEVER YOU KNOW WHICH REPO THE SESSION IS IN: on a multi-project account a connection with no project bound cannot be resolved, and PAPI will stop and ask rather than guess."
       }
     },
     required: ["text"]
@@ -27841,6 +27843,50 @@ 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",
@@ -28420,7 +28466,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(annotateTaskRefs(health.carryForward, taskRefs));
+    lines.push(...renderCarryForward(health.carryForward, (t) => annotateTaskRefs(t, taskRefs)));
     lines.push("");
   }
   const hasMetrics = health.metricsSection !== "Could not read methodology metrics." && !health.metricsSection.includes("undefined");
@@ -30375,6 +30421,36 @@ ${d.body}`;
 ${formatted}`, meta));
 }
 
+// src/lib/dist-staleness.ts
+import { statSync as statSync8 } from "fs";
+import { fileURLToPath as fileURLToPath3 } from "url";
+var BOOT_MS = Date.now();
+var DEFAULT_SKEW_MS = 2e3;
+var STAT_TTL_MS = 1e4;
+function isDistStale({ bootMs, distMtimeMs, skewMs = DEFAULT_SKEW_MS }) {
+  if (distMtimeMs === null || !Number.isFinite(distMtimeMs)) return false;
+  return distMtimeMs > bootMs + skewMs;
+}
+var cached = null;
+function checkDistStaleness(now = Date.now()) {
+  if (cached && now - cached.at < STAT_TTL_MS) return cached.stale;
+  let distMtimeMs = null;
+  try {
+    distMtimeMs = statSync8(fileURLToPath3(import.meta.url)).mtimeMs;
+  } catch {
+    distMtimeMs = null;
+  }
+  const stale = isDistStale({ bootMs: BOOT_MS, distMtimeMs });
+  cached = { at: now, stale };
+  return stale;
+}
+function stalenessWarning(now = Date.now()) {
+  const age = Math.round((now - BOOT_MS) / 1e3);
+  return `\u26A0\uFE0F This PAPI MCP server process booted ${age}s ago and packages/server has been REBUILT since. It is still running the code it booted with, so anything you verify through these tools right now reflects the OLD bundle. Reconnect / restart the PAPI MCP server before trusting this output.
+
+`;
+}
+
 // src/tools/learning-action.ts
 var learningActionTool = {
   name: "learning_action",
@@ -31346,9 +31422,9 @@ async function checkMeter(adapter2, toolName, cacheKey) {
   if (!adapter2.getMeteredUsage) return { blocked: false };
   try {
     let usage;
-    const cached = usageCache.get(cacheKey);
-    if (cached && Date.now() - cached.at < CACHE_TTL_MS3) {
-      usage = cached.usage;
+    const cached2 = usageCache.get(cacheKey);
+    if (cached2 && Date.now() - cached2.at < CACHE_TTL_MS3) {
+      usage = cached2.usage;
     } else {
       usage = await adapter2.getMeteredUsage();
       usageCache.set(cacheKey, { usage, at: Date.now() });
@@ -31537,7 +31613,7 @@ function getToolMetadata() {
   return PAPI_TOOLS.map((t) => ({ name: t.name, description: t.description }));
 }
 function createServer(adapter2, config2) {
-  const __pkgFilename = fileURLToPath3(import.meta.url);
+  const __pkgFilename = fileURLToPath4(import.meta.url);
   const __pkgDir = dirname5(__pkgFilename);
   let serverVersion = "unknown";
   try {
@@ -31557,7 +31633,7 @@ function createServer(adapter2, config2) {
       "\n\u26A0 PAPI is running in md mode \u2014 your cycles are not visible on the hosted dashboard.\n  Configure DATABASE_URL or sign up at https://getpapi.ai/setup to enable observability.\n\n"
     );
   }
-  const __filename = fileURLToPath3(import.meta.url);
+  const __filename = fileURLToPath4(import.meta.url);
   const __dirname2 = dirname5(__filename);
   const skillsDir = join20(__dirname2, "..", "skills");
   function parseSkillFrontmatter(content) {
@@ -31859,6 +31935,15 @@ ${usageLine(decision.usage)}`;
     }
     const footer = formatMetricsFooter(elapsed, usage, contextBytes);
     result.content.push({ type: "text", text: footer });
+    try {
+      if (checkDistStaleness() && result.content.length > 0) {
+        const first = result.content[0];
+        if (first && typeof first.text === "string") {
+          first.text = stalenessWarning() + first.text;
+        }
+      }
+    } catch {
+    }
     return result;
   });
   return server2;
@@ -32304,7 +32389,7 @@ async function dispatchRequest(args) {
 }
 
 // src/index.ts
-var __dirname = dirname6(fileURLToPath4(import.meta.url));
+var __dirname = dirname6(fileURLToPath5(import.meta.url));
 var pkgVersion = "unknown";
 try {
   const pkg = JSON.parse(readFileSync18(join25(__dirname, "..", "package.json"), "utf-8"));

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 \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.]
+[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. MCP RESTART RULE (task-2978): whenever FILES LIKELY TOUCHED includes any \`packages/server/**\` path, append this line verbatim to the handoff \u2014 "MCP RESTART REQUIRED: a mid-session \`npm run mcp-build\` writes a dist the already-booted MCP process never loads, so verifying this change through PAPI's own tools before an explicit MCP reconnect is INVALID. Implement \u2192 mcp-build \u2192 reconnect \u2192 only then verify." This is one line inside this section, not a new section.]
 
 EFFORT
 [XS/S/M/L/XL]
@@ -83,7 +83,7 @@ After your natural language output, include this EXACT format on its own line:
 {
   "cycleLogTitle": "string \u2014 short descriptive title WITHOUT 'Cycle N' prefix. Should capture the cycle theme in 3-5 words (e.g. 'MCP Quality + Product Readiness' not 'Cycle 5 \u2014 Board Triage \u2014 Bug Fix'). This is the canonical theme label for the cycle.",
   "cycleLogContent": "string \u2014 5-10 line cycle log body in markdown, NO heading (the ### heading is generated automatically)",
-  "cycleLogCarryForward": "string or null \u2014 carry-forward items for next cycle",
+  "cycleLogCarryForward": "string or null \u2014 carry-forward for the next cycle, in TWO NAMED SECTIONS, product signal FIRST. Section 1 begins with the literal label 'WHAT SHIPS FOR USERS:' and names, concretely, what a person using this project can now see or do, and how to check it \u2014 never a deploy step. Section 2 begins with the literal label 'RELEASE MECHANICS:' and carries everything operational: deploy, publish, migrations, gate order, branch counts, spot-checks. The mechanics are load-bearing and must NOT be dropped or shortened \u2014 they go second, not away. orient parses these two labels and renders the product half first, so the labels are a contract, not decoration. If a cycle genuinely ships nothing user-visible, say so in one line under section 1 rather than omitting the label.",
   "cycleLogNotes": "string or null \u2014 1-3 lines of cycle-level observations: estimation accuracy, recurring blockers, velocity trends, dependency signals. Omit if no noteworthy observations.",
   "nextMode": "Full",
   "boardHealth": "string \u2014 e.g. 5 tasks (3 backlog, 2 done)",
@@ -947,7 +947,7 @@ After your natural language output, include this EXACT format on its own line:
 \`\`\`json
 {
   "sessionLogTitle": "string \u2014 Strategy Review title WITHOUT 'Cycle N' prefix (e.g. 'Strategy Review' not 'Cycle 5 \u2014 Strategy Review')",
-  "sessionLogContent": "string \u2014 5-10 line cycle log body summarizing the review, NO heading (the ### heading is generated automatically)",
+  "sessionLogContent": "string \u2014 5-10 line cycle log body summarizing the review, NO heading (the ### heading is generated automatically). LEAD WITH TANGIBLE PRODUCT INSIGHT: open with what was learned about the product, its users, or the market \u2014 a specific finding a reader can act on. Board hygiene, cadence, cycle counts, branch state and other housekeeping are legitimate content but they TRAIL; they must never be the opening line. If the review's most important finding genuinely is an operational one, say why it matters to the product in the same breath rather than reporting it as admin.",
   "velocityAssessment": "string \u2014 2-3 sentence velocity summary",
   "strategicRecommendations": "string \u2014 key recommendations in markdown",
   "activeDecisionUpdates": [
@@ -1311,7 +1311,7 @@ REFERENCE DOCS
 [Optional \u2014 paths to docs/ files with background context. Omit if not needed.]
 
 FILES LIKELY TOUCHED
-[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.]
+[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. MCP RESTART RULE (task-2978): whenever FILES LIKELY TOUCHED includes any \`packages/server/**\` path, append this line verbatim to the handoff \u2014 "MCP RESTART REQUIRED: a mid-session \`npm run mcp-build\` writes a dist the already-booted MCP process never loads, so verifying this change through PAPI's own tools before an explicit MCP reconnect is INVALID. Implement \u2192 mcp-build \u2192 reconnect \u2192 only then verify." This is one line inside this section, not a new section.]
 
 EFFORT
 [XS/S/M/L/XL]`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@papi-ai/server",
-  "version": "0.7.74",
+  "version": "0.7.75",
   "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",