@papi-ai/server 0.7.108 → 0.7.110

package/README.md

@@ -43,6 +43,14 @@ PAPI collects anonymous usage data (tool name, duration, project UUID — no cod
 
 PAPI is configured with `PAPI_PROJECT_ID` and `PAPI_DATA_API_KEY` — both are generated by the onboarding wizard at [getpapi.ai](https://getpapi.ai/) and pasted into your `.mcp.json`. If those env vars aren't set, PAPI will fall back to local file storage (md mode) and emit a stderr warning that your cycles aren't visible on the dashboard. To get on the dashboard, sign up at [getpapi.ai](https://getpapi.ai/) and use the config it gives you.
 
+### Stdio idle shutdown
+
+The stdio server exits cleanly after two minutes without input, including its
+database adapter pool, so abandoned client sessions do not accumulate. Set
+`PAPI_STDIO_IDLE_TIMEOUT_MS=0` to disable this behavior, or provide another
+non-negative millisecond value in the `.mcp.json` environment block. This
+setting applies only to stdio mode; hosted HTTP instances are not idle-killed.
+
 ## License
 
 [Elastic License 2.0](https://www.elastic.co/licensing/elastic-license) — free to use, self-host, and modify. Commercial hosting requires a license.

package/dist/index.js

@@ -7558,9 +7558,10 @@ function resolveServerName(serverName) {
   const candidate = serverName?.trim();
   return candidate && SAFE_SERVER_NAME.test(candidate) ? candidate : DEFAULT_SERVER_NAME;
 }
-function formatConnectionBanner(identity) {
+function formatConnectionBanner(identity, health = "connected") {
   const projectIdShort = identity.projectId ? ` (${identity.projectId.slice(0, 8)})` : "";
-  return `[papi] Connected \u2014 server: ${resolveServerName(identity.serverName)}, project: ${identity.projectName}${projectIdShort}, adapter: ${identity.adapterType}, v${identity.pkgVersion}`;
+  const lead = health === "degraded" ? "Degraded \u2014 data may be stale" : health === "offline" ? "Offline \u2014 no database connection" : "Connected";
+  return `[papi] ${lead} \u2014 server: ${resolveServerName(identity.serverName)}, project: ${identity.projectName}${projectIdShort}, adapter: ${identity.adapterType}, v${identity.pkgVersion}`;
 }
 
 // src/server.ts
@@ -11034,7 +11035,7 @@ function isBlockerResolved(blocker, ctx) {
       if (decision?.outcome && resolvedOutcomes.has(decision.outcome)) return true;
       if (decision?.resolutionState === "resolved") return true;
       const hasRecentEvent = ctx.decisionEvents.some(
-        (e) => idMatches(e.decisionId, blocker.ref) && e.cycle >= blocker.blockedCycle && !PROPOSAL_EVENT_TYPES.includes(e.eventType)
+        (e) => idMatches(e.decisionId, blocker.ref) && e.cycle >= blocker.blockedCycle && !PROPOSAL_EVENT_TYPES.includes(e.eventType) && e.source !== "build_complete"
       );
       return hasRecentEvent;
     }
@@ -32781,23 +32782,23 @@ ${formatRuntimeIdentity(getRuntimeIdentity(config2, serverVersion))}`;
   }
 }
 function enrichClaudeMd(projectRoot, cycleNumber, adapterType, collector, clientName) {
-  if (!shouldWriteClaudeMd(clientName)) return "";
+  const targetFile = shouldWriteClaudeMd(clientName) ? "CLAUDE.md" : "AGENTS.md";
   if (adapterType === "proxy") {
     const additions2 = [];
     if (cycleNumber >= 6) additions2.push(CLAUDE_MD_TIER_1);
     if (cycleNumber >= 21) additions2.push(CLAUDE_MD_TIER_2);
     if (additions2.length === 0) return "";
-    collector.add({ path: "CLAUDE.md", content: additions2.join(""), mode: "append" });
+    collector.add({ path: targetFile, content: additions2.join(""), mode: "append" });
     const tierNames2 = [];
     if (cycleNumber >= 6) tierNames2.push("Established (batch building, strategy reviews, AD lifecycle)");
     if (cycleNumber >= 21) tierNames2.push("Mature (idea pipeline, doc registry, advanced patterns)");
     return `
 
-\u{1F4DD} **CLAUDE.md enriched** \u2014 added ${tierNames2.join(" + ")} guidance for cycle ${cycleNumber}+ projects.`;
+\u{1F4DD} **${targetFile} enriched** \u2014 added ${tierNames2.join(" + ")} guidance for cycle ${cycleNumber}+ projects.`;
   }
-  const claudeMdPath = join18(projectRoot, "CLAUDE.md");
-  if (!existsSync11(claudeMdPath)) return "";
-  const content = readFileSync13(claudeMdPath, "utf-8");
+  const targetPath = join18(projectRoot, targetFile);
+  if (!existsSync11(targetPath)) return "";
+  const content = readFileSync13(targetPath, "utf-8");
   const additions = [];
   if (cycleNumber >= 6 && !content.includes(CLAUDE_MD_ENRICHMENT_SENTINEL_T1)) {
     additions.push(dedupeEnrichmentBlob(content, CLAUDE_MD_TIER_1));
@@ -32806,13 +32807,13 @@ function enrichClaudeMd(projectRoot, cycleNumber, adapterType, collector, client
     additions.push(dedupeEnrichmentBlob(content, CLAUDE_MD_TIER_2));
   }
   if (additions.length === 0) return "";
-  writeFileSync7(claudeMdPath, content + additions.join(""), "utf-8");
+  writeFileSync7(targetPath, content + additions.join(""), "utf-8");
   const tierNames = [];
   if (additions.some((a) => a.includes(CLAUDE_MD_ENRICHMENT_SENTINEL_T1))) tierNames.push("Established (batch building, strategy reviews, AD lifecycle)");
   if (additions.some((a) => a.includes(CLAUDE_MD_ENRICHMENT_SENTINEL_T2))) tierNames.push("Mature (idea pipeline, doc registry, advanced patterns)");
   return `
 
-\u{1F4DD} **CLAUDE.md enriched** \u2014 added ${tierNames.join(" + ")} guidance for cycle ${cycleNumber}+ projects.`;
+\u{1F4DD} **${targetFile} enriched** \u2014 added ${tierNames.join(" + ")} guidance for cycle ${cycleNumber}+ projects.`;
 }
 
 // src/tools/hierarchy.ts
@@ -36707,6 +36708,43 @@ function shouldCheckForUpdate(version, selfHostFlag) {
   return version !== "unknown" && !isSelfHostedDeployment(selfHostFlag);
 }
 
+// src/lib/stdio-idle-timeout.ts
+var DEFAULT_STDIO_IDLE_TIMEOUT_MS = 12e4;
+function parseStdioIdleTimeoutMs(raw = process.env["PAPI_STDIO_IDLE_TIMEOUT_MS"]) {
+  if (raw === void 0 || raw.trim() === "") return DEFAULT_STDIO_IDLE_TIMEOUT_MS;
+  const timeoutMs = Number(raw);
+  if (!Number.isInteger(timeoutMs) || timeoutMs < 0) {
+    throw new Error(
+      `PAPI_STDIO_IDLE_TIMEOUT_MS must be a non-negative integer in milliseconds; received ${JSON.stringify(raw)}`
+    );
+  }
+  return timeoutMs;
+}
+function startStdioIdleTimeout(input, timeoutMs, onTimeout) {
+  if (timeoutMs === 0) return () => void 0;
+  let timer2;
+  let stopped = false;
+  const stop = () => {
+    if (stopped) return;
+    stopped = true;
+    if (timer2 !== void 0) clearTimeout(timer2);
+    input.off("data", refresh);
+  };
+  const refresh = () => {
+    if (stopped) return;
+    if (timer2 !== void 0) clearTimeout(timer2);
+    timer2 = setTimeout(() => {
+      if (stopped) return;
+      stopped = true;
+      input.off("data", refresh);
+      onTimeout();
+    }, timeoutMs);
+  };
+  input.on("data", refresh);
+  refresh();
+  return stop;
+}
+
 // src/index.ts
 init_dist();
 var __dirname = dirname7(fileURLToPath5(import.meta.url));
@@ -36808,7 +36846,7 @@ async function gracefulShutdown(signal) {
   } catch (err) {
     console.error(`[papi] Adapter close failed during ${signal}: ${err instanceof Error ? err.message : String(err)}`);
   }
-  process.exit(signal === "SIGTERM" || signal === "SIGINT" ? 0 : 1);
+  process.exit(signal === "SIGTERM" || signal === "SIGINT" || signal === "idle-timeout" ? 0 : 1);
 }
 process.on("SIGTERM", () => {
   void gracefulShutdown("SIGTERM");
@@ -36922,13 +36960,22 @@ if (isHttpMode && httpPort !== void 0) {
   } catch {
   }
   const transport = new StdioServerTransport();
+  let stopStdioIdleTimeout = () => void 0;
+  transport.onclose = () => stopStdioIdleTimeout();
   await server.connect(transport);
+  stopStdioIdleTimeout = startStdioIdleTimeout(
+    process.stdin,
+    parseStdioIdleTimeoutMs(),
+    () => {
+      void gracefulShutdown("idle-timeout");
+    }
+  );
   process.stderr.write(`${formatConnectionBanner({
     serverName: config.serverName,
     projectName: basename2(config.projectRoot),
     projectId: config.projectId ?? process.env.PAPI_PROJECT_ID,
     adapterType: config.adapterType,
     pkgVersion
-  })}
+  }, getConnectionStatus())}
 `);
 }

package/package.json

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