@papi-ai/server 0.7.7 → 0.7.8

package/dist/index.js

@@ -7703,7 +7703,7 @@ ${r.content}` + (r.carry_forward ? `
         FROM cycle_tasks
         WHERE project_id = ${this.projectId}
           AND status NOT IN ('Done', 'Cancelled', 'Archived', 'Deferred')
-          AND (task_type IN ('task', 'bug', 'research') OR task_type IS NULL)
+          AND (task_type IN ('task', 'bug', 'research', 'discovery', 'spike') OR task_type IS NULL)
         ORDER BY
           CASE priority
             WHEN 'P0 Critical' THEN 0
@@ -9224,9 +9224,11 @@ var init_git = __esm({
 
 // src/index.ts
 import { readFileSync as readFileSync4 } from "fs";
+import { createServer as createHttpServer } from "http";
 import { dirname as dirname2, join as join11 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { Server as Server2 } from "@modelcontextprotocol/sdk/server/index.js";
 import {
   CallToolRequestSchema as CallToolRequestSchema2,
@@ -9249,6 +9251,8 @@ function loadConfig() {
   const baseBranch = process.env.PAPI_BASE_BRANCH ?? "main";
   const autoPR = process.env.PAPI_AUTO_PR !== "false";
   const lightMode = process.env.PAPI_LIGHT_MODE === "true";
+  const projectOwner = process.env.PAPI_OWNER ?? "Cathal";
+  const skipProjectSpecificRules = process.env.PAPI_SKIP_PROJECT_RULES === "true";
   const papiEndpoint = process.env.PAPI_ENDPOINT;
   const dataEndpoint = process.env.PAPI_DATA_ENDPOINT;
   const databaseUrl = process.env.DATABASE_URL;
@@ -9263,7 +9267,9 @@ function loadConfig() {
     autoPR,
     adapterType,
     papiEndpoint,
-    lightMode
+    lightMode,
+    projectOwner,
+    skipProjectSpecificRules
   };
 }
 
@@ -12083,10 +12089,11 @@ async function assembleContext(adapter2, mode, _config, filters, focus) {
   timings["getPlanContextSummary"] = t();
   if (leanSummary) {
     t = startTimer();
-    let [metricsSnapshots2, reviews2] = await Promise.all([
+    const [metricsSnapshotsRaw, reviews2] = await Promise.all([
       adapter2.readCycleMetrics(),
       adapter2.getRecentReviews(5)
     ]);
+    let metricsSnapshots2 = metricsSnapshotsRaw;
     let leanBuildReports = [];
     try {
       leanBuildReports = await adapter2.getRecentBuildReports(50);
@@ -17205,7 +17212,7 @@ function extractDocMeta(absolutePath, relativePath, cycleNumber) {
   let title = relativePath.split("/").pop()?.replace(".md", "") ?? relativePath;
   let type = "reference";
   let cycle = cycleNumber;
-  let summary = "Auto-registered \u2014 no summary available. Update via doc_register.";
+  const summary = "Auto-registered \u2014 no summary available. Update via doc_register.";
   if (relativePath.startsWith("docs/research/")) type = "research";
   else if (relativePath.startsWith("docs/architecture/")) type = "architecture";
   else if (relativePath.startsWith("docs/audits/")) type = "audit";
@@ -17612,8 +17619,6 @@ For M/L tasks: use the full toolchain \u2014 Playground (design preview) \u2192
 - Check adapter-pg implementation, not adapter-md. adapter-md is legacy.
 - Verify the full write\u2192DB\u2192read\u2192consumer path for any data changes.
 - Run migrations on dev before prod. Test with \`execute_sql\` via Supabase MCP.
-- When adding adapter interface methods, implement in BOTH adapter-md and adapter-pg.
-- Build order matters: adapter-md \u2192 adapter-pg \u2192 server.
 - .papi/ files may be stale \u2014 DB via MCP tools is the source of truth.`,
   Auth: `**MODULE INSTRUCTIONS \u2014 Auth**
 - NEVER expose the Supabase service role key in client-side code or API responses.
@@ -18366,15 +18371,15 @@ ${lines.join("\n")}
   ]);
   warnIfEmpty("getCycleHealth (idea)", health);
   const phase = input.phase || resolveCurrentPhase(phases);
-  const VALID_PRIORITIES2 = /* @__PURE__ */ new Set(["P0 Critical", "P1 High", "P2 Medium", "P3 Low"]);
+  const VALID_PRIORITIES3 = /* @__PURE__ */ new Set(["P0 Critical", "P1 High", "P2 Medium", "P3 Low"]);
   const VALID_COMPLEXITIES2 = /* @__PURE__ */ new Set(["XS", "Small", "Medium", "Large", "XL"]);
-  const priority = input.priority && VALID_PRIORITIES2.has(input.priority) ? input.priority : "P2 Medium";
+  const priority = input.priority && VALID_PRIORITIES3.has(input.priority) ? input.priority : "P2 Medium";
   const complexity = input.complexity && VALID_COMPLEXITIES2.has(input.complexity) ? input.complexity : "Small";
-  const VALID_TYPES = /* @__PURE__ */ new Set(["task", "bug", "research", "idea", "spike", "discovery"]);
+  const VALID_TYPES2 = /* @__PURE__ */ new Set(["task", "bug", "research", "idea", "spike", "discovery"]);
   let taskTitle = input.text;
   let taskType = "idea";
   let typeInferred = false;
-  if (input.type && VALID_TYPES.has(input.type)) {
+  if (input.type && VALID_TYPES2.has(input.type)) {
     taskType = input.type;
   } else {
     const PREFIX_MAP = {
@@ -18843,16 +18848,16 @@ async function recordAdHoc(adapter2, input) {
       displayId: "",
       title: input.title,
       status: "Done",
-      priority: "P3 Low",
+      priority: input.priority || "P2 Medium",
       complexity: input.effort === "XS" || input.effort === "S" ? "Small" : "Medium",
       module: input.module || "Core",
       epic: input.epic || "Platform",
       phase,
-      owner: "Cathal",
+      owner: input.owner || "Cathal",
       reviewed: true,
       createdCycle: cycle,
       notes: input.notes ? `[ad-hoc] ${input.notes}` : "[ad-hoc]",
-      taskType: "task",
+      taskType: input.taskType || "task",
       source: "owner"
     });
   }
@@ -18877,6 +18882,16 @@ async function recordAdHoc(adapter2, input) {
 
 // src/tools/ad-hoc.ts
 var VALID_EFFORTS = ["XS", "S", "M", "L", "XL"];
+var VALID_PRIORITIES = ["P0 Critical", "P1 High", "P2 Medium", "P3 Low"];
+var VALID_TYPES = ["task", "bug", "research", "discovery", "spike", "idea"];
+function inferTaskType(description) {
+  const lower = description.toLowerCase();
+  if (/\bfix\b|bug|error|crash|broken|regression|defect/.test(lower)) return "bug";
+  if (/research|investigate|explore|analysis|audit|review|assess/.test(lower)) return "research";
+  if (/discover|discovery|found|uncovered/.test(lower)) return "discovery";
+  if (/spike|poc|proof.of.concept|prototype|experiment/.test(lower)) return "spike";
+  return "task";
+}
 var adHocTool = {
   name: "ad_hoc",
   description: "Record work done outside the normal cycle. Creates a Done task with a lightweight build report, or associates work with an existing task if task_id is provided (without changing task status \u2014 use build_execute for status transitions). Use for quick fixes, bug patches, or ad-hoc changes. Does not call the Anthropic API.",
@@ -18908,6 +18923,16 @@ var adHocTool = {
       epic: {
         type: "string",
         description: 'Epic this relates to (default: "Platform").'
+      },
+      priority: {
+        type: "string",
+        enum: ["P0 Critical", "P1 High", "P2 Medium", "P3 Low"],
+        description: "Task priority (default: P2 Medium). Use P1 for important fixes, P0 for critical incidents."
+      },
+      type: {
+        type: "string",
+        enum: ["task", "bug", "research", "discovery", "spike", "idea"],
+        description: 'Task type (default: inferred from description \u2014 "fix"/"bug" \u2192 bug, "research"/"investigate" \u2192 research, otherwise task).'
       }
     },
     required: []
@@ -18923,6 +18948,14 @@ async function handleAdHoc(adapter2, config2, args) {
   if (!VALID_EFFORTS.includes(effortRaw)) {
     return errorResponse(`effort must be one of: ${VALID_EFFORTS.join(", ")}`);
   }
+  const priorityRaw = args.priority || "P2 Medium";
+  if (!VALID_PRIORITIES.includes(priorityRaw)) {
+    return errorResponse(`priority must be one of: ${VALID_PRIORITIES.join(", ")}`);
+  }
+  const typeRaw = args.type || inferTaskType(title || (args.notes ?? ""));
+  if (!VALID_TYPES.includes(typeRaw)) {
+    return errorResponse(`type must be one of: ${VALID_TYPES.join(", ")}`);
+  }
   const MAX_NOTES_LENGTH = 2e3;
   let rawNotes = args.notes?.trim();
   let notesTruncated = false;
@@ -18936,7 +18969,11 @@ async function handleAdHoc(adapter2, config2, args) {
     notes: rawNotes,
     effort: effortRaw,
     module: args.module,
-    epic: args.epic
+    epic: args.epic,
+    priority: priorityRaw,
+    taskType: typeRaw,
+    // PROJECT-SPECIFIC: owner resolved from config (PAPI_OWNER env var, default 'Cathal')
+    owner: config2.projectOwner
   });
   if (isGitAvailable() && isGitRepo(config2.projectRoot)) {
     try {
@@ -18949,8 +18986,11 @@ async function handleAdHoc(adapter2, config2, args) {
     }
   }
   const truncateWarning = notesTruncated ? ` (notes truncated to ${MAX_NOTES_LENGTH} chars)` : "";
+  const taskModule = result.task.module || "Core";
+  const typeLabel = result.task.taskType || typeRaw;
   return textResponse(
-    `**${result.task.id}:** "${result.task.title}" \u2014 recorded as ad-hoc (${effortRaw}). Build report attached.${truncateWarning}`
+    `**${result.task.id}:** "${result.task.title}" recorded (${effortRaw}, ${priorityRaw}, ${typeLabel}, ${taskModule}).${truncateWarning} Build report attached.
+_To correct: board_edit ${result.task.id} with updated fields._`
   );
 }
 
@@ -19173,7 +19213,7 @@ async function applyReconcile(adapter2, corrections) {
   }
   return { applied, skipped, details, phaseChanges };
 }
-var VALID_PRIORITIES = /* @__PURE__ */ new Set(["P0 Critical", "P1 High", "P2 Medium", "P3 Low"]);
+var VALID_PRIORITIES2 = /* @__PURE__ */ new Set(["P0 Critical", "P1 High", "P2 Medium", "P3 Low"]);
 var VALID_COMPLEXITIES = /* @__PURE__ */ new Set(["XS", "Small", "Medium", "Large", "XL"]);
 async function prepareRetriage(adapter2) {
   const health = await adapter2.getCycleHealth();
@@ -19234,7 +19274,7 @@ async function applyRetriage(adapter2, retriages) {
         skipped++;
         continue;
       }
-      if (!VALID_PRIORITIES.has(r.priority)) {
+      if (!VALID_PRIORITIES2.has(r.priority)) {
         details.push(`${r.taskId}: skipped \u2014 invalid priority "${r.priority}"`);
         skipped++;
         continue;
@@ -20205,11 +20245,41 @@ ${result.handoffRegenPrompt.userMessage}
       }
     }
     let autoReleaseNote = "";
+    let batchSummaryNote = "";
     if (stage === "build-acceptance" && verdict === "accept" && result.newStatus === "Done" && result.currentCycle > 0) {
       try {
         const allTasks = await adapter2.queryBoard();
         const cycleTasks = allTasks.filter((t) => t.cycle === result.currentCycle);
         if (cycleTasks.length > 0 && cycleTasks.every((t) => t.status === "Done")) {
+          try {
+            const allReviews = await adapter2.getRecentReviews(200);
+            const cycleReviews = allReviews.filter(
+              (r) => r.cycle === result.currentCycle && r.stage === "build-acceptance"
+            );
+            const reviewsWithAutoReview = cycleReviews.filter((r) => r.autoReview);
+            if (reviewsWithAutoReview.length > 0) {
+              const verdictCounts = { pass: 0, warn: 0, fail: 0 };
+              const findingsBySeverity = { error: 0, warning: 0, info: 0 };
+              for (const r of reviewsWithAutoReview) {
+                if (r.autoReview) {
+                  verdictCounts[r.autoReview.verdict] = (verdictCounts[r.autoReview.verdict] ?? 0) + 1;
+                  for (const f of r.autoReview.findings) {
+                    findingsBySeverity[f.severity] = (findingsBySeverity[f.severity] ?? 0) + 1;
+                  }
+                }
+              }
+              const totalFindings = findingsBySeverity.error + findingsBySeverity.warning + findingsBySeverity.info;
+              batchSummaryNote = `
+
+---
+
+**Cycle ${result.currentCycle} Auto-Review Summary** (${reviewsWithAutoReview.length}/${cycleReviews.length} reviews had auto-review)
+
+- Verdicts: ${verdictCounts.pass} pass, ${verdictCounts.warn} warn, ${verdictCounts.fail} fail
+` + (totalFindings > 0 ? `- Findings: ${findingsBySeverity.error} error${findingsBySeverity.error !== 1 ? "s" : ""}, ${findingsBySeverity.warning} warning${findingsBySeverity.warning !== 1 ? "s" : ""}, ${findingsBySeverity.info} info` : "- No findings logged");
+            }
+          } catch {
+          }
           const version = `v0.${result.currentCycle}.0`;
           const baseBranch = resolveBaseBranch(config2.projectRoot, config2.baseBranch);
           const releaseResult = await createRelease(config2, baseBranch, version, adapter2);
@@ -20254,7 +20324,7 @@ Next: address the feedback, then run \`build_execute ${taskId}\` to resubmit.`;
 - **Verdict:** ${result.verdict}
 - **Comments:** ${result.comments}
 
-${statusNote}${autoReviewNote}${unblockNote}${regenNote}${mergeNote}${autoReleaseNote}${nextStepNote}${phaseNote}`
+${statusNote}${autoReviewNote}${unblockNote}${regenNote}${mergeNote}${batchSummaryNote}${autoReleaseNote}${nextStepNote}${phaseNote}`
     );
   } catch (err) {
     return errorResponse(err instanceof Error ? err.message : String(err));
@@ -22453,5 +22523,123 @@ if (pkgVersion !== "unknown") {
     }
   })();
 }
-var transport = new StdioServerTransport();
-await server.connect(transport);
+var httpPortRaw = process.env["PAPI_HTTP_PORT"] ?? process.env["PORT"];
+var httpPort = httpPortRaw ? parseInt(httpPortRaw, 10) : void 0;
+var httpHost = process.env["PORT"] ? "0.0.0.0" : "127.0.0.1";
+if (httpPort) {
+  if (isNaN(httpPort) || httpPort < 1 || httpPort > 65535) {
+    process.stderr.write(`[papi] Invalid PAPI_HTTP_PORT: "${process.env.PAPI_HTTP_PORT}". Must be a number between 1 and 65535.
+`);
+    process.exit(1);
+  }
+  const httpToken = process.env.PAPI_HTTP_TOKEN;
+  if (!httpToken) {
+    process.stderr.write("[papi] WARNING: PAPI_HTTP_TOKEN is not set. HTTP transport is unauthenticated \u2014 anyone with the URL can call your PAPI tools. Set PAPI_HTTP_TOKEN to a secret string.\n");
+  }
+  const createServerForRequest = () => {
+    if (adapter && !setupError) {
+      return createServer(adapter, config);
+    }
+    const errorServer = new Server2(
+      { name: "papi", version: pkgVersion },
+      { capabilities: { tools: {} } }
+    );
+    const errorMessage = setupError || "Unknown startup error";
+    errorServer.setRequestHandler(ListToolsRequestSchema2, async () => ({
+      tools: [{
+        name: "setup",
+        description: "PAPI is not connected \u2014 run this tool for setup instructions.",
+        inputSchema: { type: "object", properties: {}, required: [] }
+      }]
+    }));
+    errorServer.setRequestHandler(CallToolRequestSchema2, async () => ({
+      content: [{
+        type: "text",
+        text: `# PAPI Connection Error
+
+${errorMessage}
+
+## Quick Fix
+
+If you haven't set up PAPI yet:
+1. Go to https://getpapi.ai/login and sign up
+2. Complete the onboarding wizard \u2014 it generates your config
+3. Copy the config to your project and restart your AI tool
+
+If you already have an account, check that both **PAPI_PROJECT_ID** and **PAPI_DATA_API_KEY** are set in your .mcp.json env config.`
+      }]
+    }));
+    return errorServer;
+  };
+  const httpServer = createHttpServer((req, res) => {
+    if (req.method === "GET" && req.url === "/healthz") {
+      res.writeHead(200, { "Content-Type": "text/plain" });
+      res.end("ok");
+      return;
+    }
+    if (httpToken) {
+      const authHeader = req.headers["authorization"] ?? "";
+      const provided = authHeader.startsWith("Bearer ") ? authHeader.slice(7) : "";
+      if (provided !== httpToken) {
+        res.writeHead(401, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: "Unauthorized" }));
+        return;
+      }
+    }
+    if (req.url === "/mcp" || req.url === "/sse") {
+      if (req.method === "POST") {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk));
+        req.on("end", () => {
+          let parsedBody;
+          try {
+            parsedBody = JSON.parse(Buffer.concat(chunks).toString("utf-8"));
+          } catch {
+            res.writeHead(400, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Invalid JSON body" }));
+            return;
+          }
+          (async () => {
+            const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: void 0 });
+            const reqServer = createServerForRequest();
+            await reqServer.connect(transport);
+            await transport.handleRequest(req, res, parsedBody);
+            await reqServer.close();
+          })().catch((err) => {
+            process.stderr.write(`[papi] HTTP transport error: ${err instanceof Error ? err.message : String(err)}
+`);
+            if (!res.headersSent) {
+              res.writeHead(500, { "Content-Type": "application/json" });
+              res.end(JSON.stringify({ error: "Internal server error" }));
+            }
+          });
+        });
+        return;
+      }
+      (async () => {
+        const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: void 0 });
+        const reqServer = createServerForRequest();
+        await reqServer.connect(transport);
+        await transport.handleRequest(req, res);
+        await reqServer.close();
+      })().catch((err) => {
+        process.stderr.write(`[papi] HTTP transport error: ${err instanceof Error ? err.message : String(err)}
+`);
+        if (!res.headersSent) {
+          res.writeHead(500, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ error: "Internal server error" }));
+        }
+      });
+      return;
+    }
+    res.writeHead(404, { "Content-Type": "text/plain" });
+    res.end("Not found");
+  });
+  httpServer.listen(httpPort, httpHost, () => {
+    process.stderr.write(`[papi] HTTP transport listening on http://${httpHost}:${httpPort}/mcp
+`);
+  });
+} else {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@papi-ai/server",
-  "version": "0.7.7",
+  "version": "0.7.8",
   "description": "PAPI MCP server — AI-powered sprint planning, build execution, and strategy review for software projects",
   "license": "Elastic-2.0",
   "type": "module",