@papi-ai/server 0.7.61 → 0.7.62

package/design-assets/agents/frontend-design-engineer.md

@@ -88,6 +88,13 @@ Your output is **not done** if ANY of these is true (these are falsifiable — c
 - [ ] Guidance, state, or a next action explained in a sentence of helper text where a visual cue
       (position, size, colour, icon, a signpost, motion-on-change) would carry it — prose used as a
       crutch for missing visual steering.
+- [ ] A label, its value, and its explanation each taking their own line ("The Stacked Caption").
+      Anywhere the three exist, they share ONE line.
+- [ ] A new datum added as a sibling row beside a row it could extend ("The Siblinged Row").
+      Extend the existing row — inline suffix, extra cell, chip on the same baseline — never stack
+      a twin row underneath.
+- [ ] An eyebrow label or an explanatory subtitle above/below a heading ("The Eyebrow Crutch").
+      Labels carry themselves; if a heading needs a subtitle to be understood, the heading is wrong.
 - [ ] More than ~3 sections fully visible above the fold.
 - [ ] Identical-sized cards in a uniform row (flat hierarchy — needs a dominant 2×+ cell).
 - [ ] Monospace on labels, status, timestamps, or nav.

package/design-assets/skills/design-critique/SKILL.md

@@ -108,6 +108,12 @@ Run through every named anti-pattern and flag matches. Common universal ones:
 - Guidance, state, or a next action carried by a sentence of helper text where a visual cue
   (position, size, colour, an icon, a signpost, motion-on-change) would do — prose as a crutch for
   missing visual steering. Prefer showing over telling.
+- A label, its value, and its explanation each taking their own line ("The Stacked Caption") —
+  anywhere the three exist, they share ONE line.
+- A new datum added as a sibling row beside a row it could extend ("The Siblinged Row") — extend
+  the existing row (inline suffix, extra cell, chip on the same baseline), never stack a twin row.
+- An eyebrow label or explanatory subtitle above/below a heading ("The Eyebrow Crutch") — labels
+  carry themselves; a heading that needs a subtitle to be understood is the wrong heading.
 - Identical-sized cards in a uniform row (flat hierarchy).
 - Monospace on labels / status / timestamps / nav.
 - Header, label, and value at the same size+weight.

package/dist/index.js

@@ -5059,7 +5059,7 @@ var init_setup = __esm({
 
 // src/index.ts
 import { readFileSync as readFileSync16 } from "fs";
-import { dirname as dirname6, join as join24 } from "path";
+import { dirname as dirname6, join as join24, basename as basename2 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { Server as Server2 } from "@modelcontextprotocol/sdk/server/index.js";
@@ -12765,6 +12765,7 @@ async function preparePlan(adapter2, config2, filters, focus, force, handoffsOnl
     const contextBytes2 = Buffer.byteLength(userMessage2, "utf-8");
     console.error(`[plan-perf] contextBytes=${contextBytes2} (handoffs-only)`);
     const planSystemPrompt2 = await getPrompt("plan-system");
+    await recordPlanGenerationActive(tracker, incomingCycle);
     return {
       mode: "full",
       // apply phase treats it the same
@@ -12825,6 +12826,7 @@ async function preparePlan(adapter2, config2, filters, focus, force, handoffsOnl
   } catch {
   }
   const planSystemPrompt = await getPrompt("plan-system");
+  await recordPlanGenerationActive(tracker, incomingCycle);
   return {
     mode,
     cycleNumber,
@@ -12848,6 +12850,15 @@ async function streamPlanStageSteps(tracker, newCycleNumber) {
     await tracker.recordStep(step);
   }
 }
+async function recordPlanGenerationActive(tracker, incomingCycleNumber) {
+  if (!tracker) return;
+  await tracker.recordStep("recommendation", {
+    cycle: incomingCycleNumber,
+    stage: "plan",
+    status: "active",
+    metadata: { phase: "generating" }
+  });
+}
 async function applyPlan(adapter2, config2, rawLlmOutput, mode, cycleNumber, strategyReviewWarning, contextHashes, planRunMeta, tracker) {
   const applyTimer = startTimer();
   console.error(`[plan-perf] applyPlan: start (llm_response=${rawLlmOutput.length} chars)`);
@@ -22436,6 +22447,27 @@ ${entries}`;
       }
     } catch {
     }
+    let openIssuesSection = "";
+    try {
+      if (adapter2.getCycleLearnings) {
+        const issues = (await adapter2.getCycleLearnings({ category: "issue", limit: 20 })).filter((l) => !l.resolvedAt && l.id);
+        const taskIds = new Set([result.task.id, result.task.displayId].filter(Boolean));
+        const moduleTag = result.task.module?.trim().toLowerCase();
+        const score = (l) => (taskIds.has(l.taskId) ? 2 : 0) + (moduleTag && l.tags.some((t) => t.toLowerCase() === moduleTag) ? 1 : 0);
+        const top = issues.sort((a, b2) => score(b2) - score(a)).slice(0, 8);
+        if (top.length > 0) {
+          const rows = top.map((l) => `- \`${l.id}\` \xB7 ${l.severity ?? "P3"} \xB7 ${l.summary}`).join("\n");
+          openIssuesSection = `
+
+---
+
+**OPEN DISCOVERED ISSUES** (${top.length} shown):
+${rows}
+If this build fixes any of these, pass their UUIDs in \`fixed_issues\` on complete \u2014 that stamps them FIXED on the caught\u2192fixed ledger. Do not fix out-of-scope issues just to clear the list.`;
+        }
+      }
+    } catch {
+    }
     const moduleInstructions = getModuleInstructions(result.task.module);
     const moduleContext = await getModuleContext(adapter2, result.task);
     const filesToWriteSection = result.filesToWrite ? formatFilesToWriteSection(result.filesToWrite) : "";
@@ -22444,7 +22476,7 @@ ${entries}`;
       formatModelRecommendation(result.task.buildHandoff?.effort ?? result.task.complexity)
     ) ?? "";
     const gestaltNote = buildGestaltPreBuildDirective(caps) ?? "";
-    return textResponse(header + serializeBuildHandoff(result.task.buildHandoff) + modelNote + gestaltNote + adSection + moduleInstructions + moduleContext + dogfoodSection + verificationNote + buildDisciplineNote + chainInstruction + phaseNote + filesToWriteSection);
+    return textResponse(header + serializeBuildHandoff(result.task.buildHandoff) + modelNote + gestaltNote + adSection + moduleInstructions + moduleContext + dogfoodSection + openIssuesSection + verificationNote + buildDisciplineNote + chainInstruction + phaseNote + filesToWriteSection);
   } catch (err) {
     if (isNoHandoffError(err)) {
       const lines = [
@@ -22618,9 +22650,14 @@ async function handleExecuteComplete(adapter2, config2, taskId, args, light = fa
         batchRollupNote = "";
       }
     }
-    const fixedNote = fixedResolvedCount > 0 ? `
+    let fixedNote = "";
+    if (fixedResolvedCount > 0) {
+      fixedNote = `
 
-\u2705 Marked ${fixedResolvedCount} discovered issue(s) FIXED \u2014 resolved_at stamped, now counted as fixed on the hub's caught\u2192fixed ledger.` : "";
+\u2705 Marked ${fixedResolvedCount} discovered issue(s) FIXED \u2014 resolved_at stamped, now counted as fixed on the hub's caught\u2192fixed ledger.`;
+    } else if (discoveredIssues && discoveredIssues.trim() !== "" && !/^none\b/i.test(discoveredIssues.trim())) {
+      fixedNote = "\n\n\u2139\uFE0F This build filed discovered issues but passed no `fixed_issues`. When a future build fixes one, pass its UUID in `fixed_issues` so it counts as FIXED (not just auto-cleared) on the hub ledger.";
+    }
     return textResponse(formatCompleteResult(result) + fixedNote + docsNote + batchRollupNote);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
@@ -23088,7 +23125,11 @@ async function handleBug(adapter2, config2, args) {
       type,
       description: text,
       diagnostics,
-      status: "open",
+      // Canonical triage vocabulary (submitted|investigating|fixed|wont_fix).
+      // Was 'open' — a third vocabulary that made the owner triage console
+      // render new upstream reports as un-triaged. Adapters pass status through,
+      // so emitting canonical here keeps hosted + pg writes consistent.
+      status: "submitted",
       notifyRequested,
       contactOk
     });
@@ -30199,4 +30240,10 @@ if (isHttpMode && httpPort !== void 0) {
   }
   const transport = new StdioServerTransport();
   await server.connect(transport);
+  const projectName = basename2(config.projectRoot);
+  const projectIdShort = config.projectId ? ` (${config.projectId.slice(0, 8)})` : process.env.PAPI_PROJECT_ID ? ` (${process.env.PAPI_PROJECT_ID.slice(0, 8)})` : "";
+  process.stderr.write(
+    `[papi] Connected \u2014 project: ${projectName}${projectIdShort}, adapter: ${config.adapterType}, v${pkgVersion}
+`
+  );
 }

package/package.json

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