gossipcat 0.6.8 → 0.6.9

package/dist-mcp/mcp-server.js

@@ -24760,7 +24760,7 @@ This section will be used for cross-review with peer agents.
 
 ${OUTPUT_DELIVERY_PROTOCOL}` });
   } else {
-    const hasAnyMeaningfulPart = !!(parts.identity || parts.instructions || parts.memory || parts.memoryDir || parts.lens || parts.skills || parts.context || parts.sessionContext || parts.chainContext || parts.specReviewContext || parts.projectStructure || parts.task || parts.consensusFindings && parts.consensusFindings.length > 0);
+    const hasAnyMeaningfulPart = !!(parts.identity || parts.instructions || parts.memory || parts.memoryDir || parts.lens || parts.skills || parts.context || parts.sessionContext || parts.chainContext || parts.specReviewContext || parts.projectStructure || parts.task || parts.consensusFindings && parts.consensusFindings.length > 0 || parts.agentCorrections && parts.agentCorrections.length > 0);
     if (hasAnyMeaningfulPart) {
       suffix.push({ priority: 0, text: `
 
@@ -24786,13 +24786,18 @@ ${parts.lens}
 ${parts.specReviewContext}
 --- END SPEC REVIEW ---` });
   }
-  if (parts.memory || parts.consensusFindings && parts.consensusFindings.length > 0) {
+  if (parts.memory || parts.consensusFindings && parts.consensusFindings.length > 0 || parts.agentCorrections && parts.agentCorrections.length > 0) {
     const memParts = [];
     if (parts.memory) memParts.push(parts.memory);
     if (parts.consensusFindings && parts.consensusFindings.length > 0) {
       const findingsBlock = "### Recent Consensus Findings\n" + parts.consensusFindings.map((f, i) => `${i + 1}. ${f}`).join("\n");
       memParts.push(findingsBlock);
     }
+    if (parts.agentCorrections && parts.agentCorrections.length > 0) {
+      memParts.push(
+        "### Your Prior Corrections\n" + parts.agentCorrections.map((f, i) => `${i + 1}. ${f}`).join("\n")
+      );
+    }
     suffix.push({ priority: 3, text: `
 
 --- MEMORY ---
@@ -24911,7 +24916,7 @@ var init_prompt_assembler = __esm({
 });
 
 // packages/orchestrator/src/agent-memory.ts
-var import_fs20, import_path21, FINDINGS_MAX_RESULTS, FINDINGS_MAX_CHARS, FINDINGS_STALE_DAYS, FINDINGS_MIN_SCORE, AgentMemoryReader;
+var import_fs20, import_path21, FINDINGS_MAX_RESULTS, FINDINGS_MAX_CHARS, FINDINGS_STALE_DAYS, FINDINGS_MIN_SCORE, CORRECTIONS_MAX_RESULTS, AgentMemoryReader;
 var init_agent_memory = __esm({
   "packages/orchestrator/src/agent-memory.ts"() {
     "use strict";
@@ -24921,6 +24926,7 @@ var init_agent_memory = __esm({
     FINDINGS_MAX_CHARS = 150;
     FINDINGS_STALE_DAYS = 30;
     FINDINGS_MIN_SCORE = 1;
+    CORRECTIONS_MAX_RESULTS = 2;
     AgentMemoryReader = class {
       constructor(projectRoot) {
         this.projectRoot = projectRoot;
@@ -25021,6 +25027,46 @@ ${content}
         }
         return scored.sort((a, b) => b.score - a.score).slice(0, FINDINGS_MAX_RESULTS).map((s) => s.text);
       }
+      /**
+       * Pre-fetch this agent's own prior lesson cards relevant to the task (issue #642 B-delta).
+       * Selects by `lesson-*.md` filename (not frontmatter `type`, which parsers don't read),
+       * ranks by body keyword overlap, drops cards older than FINDINGS_STALE_DAYS, and strips
+       * prompt-injection delimiters before returning. Returns top CORRECTIONS_MAX_RESULTS snippets.
+       */
+      prefetchAgentCorrectionsText(agentId, taskText) {
+        if (!agentId || /[/\\.\0]/.test(agentId)) return [];
+        const knowledgeDir = (0, import_path21.join)(this.projectRoot, ".gossip", "agents", agentId, "memory", "knowledge");
+        if (!(0, import_fs20.existsSync)(knowledgeDir)) return [];
+        let files;
+        try {
+          files = (0, import_fs20.readdirSync)(knowledgeDir).filter((f) => f.startsWith("lesson-") && f.endsWith(".md"));
+        } catch {
+          return [];
+        }
+        if (files.length === 0) return [];
+        const keywords = this.extractKeywords(taskText);
+        if (keywords.length === 0) return [];
+        const cutoffMs = Date.now() - FINDINGS_STALE_DAYS * 864e5;
+        const scored = [];
+        for (const file2 of files) {
+          const filePath = (0, import_path21.join)(knowledgeDir, file2);
+          let content;
+          try {
+            const mtime = (0, import_fs20.statSync)(filePath).mtimeMs;
+            if (mtime < cutoffMs) continue;
+            content = (0, import_fs20.readFileSync)(filePath, "utf-8");
+          } catch {
+            continue;
+          }
+          const body = content.replace(/^---\n[\s\S]*?\n---\n*/, "").replace(/<\/?(?:agent-memory|system|instructions)>/gi, "").replace(/\s+/g, " ").trim();
+          if (!body) continue;
+          const score = this.scoreKeywords(keywords, body);
+          if (score >= FINDINGS_MIN_SCORE) {
+            scored.push({ text: body.slice(0, FINDINGS_MAX_CHARS).trim(), score });
+          }
+        }
+        return scored.sort((a, b) => b.score - a.score).slice(0, CORRECTIONS_MAX_RESULTS).map((s) => s.text);
+      }
       /** Simple word-boundary keyword overlap scoring (no LLM). */
       extractKeywords(taskText) {
         const words = taskText.toLowerCase().split(/[\s,/.;:!?()\[\]{}*_~`"'<>|]+/);
@@ -25505,7 +25551,21 @@ function validateAgentId(agentId) {
 function sanitizeTaskId(taskId) {
   return taskId.replace(/[/\\:*?"<>|\0]/g, "_");
 }
-var import_fs23, import_path24, import_crypto11, MemoryWriter;
+function writeLessonCardsForSignals(projectRoot, signals) {
+  if (!Array.isArray(signals) || signals.length === 0) return;
+  const writer = new MemoryWriter(projectRoot);
+  for (const s of signals) {
+    if (!s || !s.finding_id || !TERMINAL_LESSON_SIGNALS.has(s.signal)) continue;
+    writer.writeLessonCard(s.agent_id, {
+      signal: s.signal,
+      findingId: s.finding_id,
+      finding: s.finding ?? "",
+      lesson: s.lesson,
+      taskTokens: s.finding
+    });
+  }
+}
+var import_fs23, import_path24, import_crypto11, TERMINAL_LESSON_SIGNALS, LESSON_CARDS_MAX_PER_AGENT, LESSON_RESERVED_AGENT_IDS, MemoryWriter;
 var init_memory_writer = __esm({
   "packages/orchestrator/src/memory-writer.ts"() {
     "use strict";
@@ -25516,6 +25576,13 @@ var init_memory_writer = __esm({
     init_project_structure();
     init_log();
     init_completion_signals();
+    TERMINAL_LESSON_SIGNALS = /* @__PURE__ */ new Set([
+      "hallucination_caught",
+      "impl_test_fail",
+      "impl_peer_rejected"
+    ]);
+    LESSON_CARDS_MAX_PER_AGENT = 200;
+    LESSON_RESERVED_AGENT_IDS = /* @__PURE__ */ new Set(["_project", "_system", "_utility"]);
     MemoryWriter = class {
       constructor(projectRoot) {
         this.projectRoot = projectRoot;
@@ -26088,7 +26155,7 @@ ${truncateAtWord(summaryBody, NEXT_SESSION_MAX_CHARS)}
       /** Shared warmth-aware pruning — evicts lowest-warmth files, respects pinned */
       pruneKnowledgeDir(knowledgeDir, maxFiles) {
         try {
-          const existing = (0, import_fs23.readdirSync)(knowledgeDir).filter((f) => f.endsWith(".md") && !f.endsWith("-session.md")).sort();
+          const existing = (0, import_fs23.readdirSync)(knowledgeDir).filter((f) => f.endsWith(".md") && !f.endsWith("-session.md") && !f.startsWith("lesson-")).sort();
           if (existing.length >= maxFiles) {
             const scored = existing.map((f) => {
               const content = (0, import_fs23.readFileSync)((0, import_path24.join)(knowledgeDir, f), "utf-8");
@@ -26392,6 +26459,76 @@ ${result}`;
         this.pruneKnowledgeDir(knowledgeDir, 25);
         (0, import_fs23.writeFileSync)((0, import_path24.join)(knowledgeDir, filename), content);
       }
+      /**
+       * Write a recallable "lesson card" for a terminal correction signal (issue #642 A).
+       * Best-effort: any failure is swallowed — this MUST NOT fail signal recording.
+       * Idempotent: keyed by finding_id via sanitizeTaskId, no timestamp in the filename.
+       */
+      writeLessonCard(agentId, card) {
+        try {
+          if (LESSON_RESERVED_AGENT_IDS.has(agentId)) return;
+          validateAgentId(agentId);
+          const slug = sanitizeTaskId(card.findingId).slice(0, 96);
+          if (!slug) return;
+          const memDir = this.ensureDirs(agentId);
+          const knowledgeDir = (0, import_path24.join)(memDir, "knowledge");
+          const today = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+          const generated = (/* @__PURE__ */ new Date()).toISOString();
+          const shortId = slug.slice(0, 24);
+          const finding = truncateAtWord(sanitizeYamlValue(card.finding ?? ""), 400);
+          const lessonBody = card.lesson ? truncateAtWord(sanitizeYamlValue(card.lesson), 400) : "(no root-cause supplied)";
+          const desc = sanitizeYamlValue(card.lesson || card.finding || "lesson").slice(0, 80);
+          const taskTokens = (card.taskTokens ?? card.finding ?? "").replace(/[\n\r]/g, " ").slice(0, 300);
+          const content = [
+            "---",
+            `name: lesson-${sanitizeYamlValue(card.signal)}-${shortId}`,
+            `description: ${desc}`,
+            "type: lesson",
+            `agent: ${sanitizeYamlValue(agentId)}`,
+            `signal: ${sanitizeYamlValue(card.signal)}`,
+            `finding_id: ${sanitizeYamlValue(card.findingId)}`,
+            "importance: 0.7",
+            `lastAccessed: ${today}`,
+            "accessCount: 0",
+            `generated: ${generated}`,
+            "---",
+            "",
+            `**Why it failed:** ${lessonBody}`,
+            "",
+            `**What happened:** ${finding}`,
+            "",
+            `**Task context:** ${taskTokens}`
+          ].join("\n");
+          const cardPath = (0, import_path24.join)(knowledgeDir, `lesson-${slug}.md`);
+          if (!(0, import_fs23.existsSync)(cardPath)) this.pruneLessonCards(knowledgeDir, LESSON_CARDS_MAX_PER_AGENT);
+          (0, import_fs23.writeFileSync)(cardPath, content);
+        } catch {
+        }
+      }
+      /** Count-based prune of lesson-*.md only (leaves consensus/session knowledge untouched). */
+      pruneLessonCards(knowledgeDir, maxFiles) {
+        try {
+          const cards = (0, import_fs23.readdirSync)(knowledgeDir).filter((f) => f.startsWith("lesson-") && f.endsWith(".md"));
+          if (cards.length < maxFiles) return;
+          const withMtime = cards.map((f) => {
+            let mtime = 0;
+            try {
+              mtime = (0, import_fs23.statSync)((0, import_path24.join)(knowledgeDir, f)).mtimeMs;
+            } catch {
+            }
+            return { f, mtime };
+          });
+          withMtime.sort((a, b) => a.mtime - b.mtime);
+          const toEvict = withMtime.slice(0, cards.length - (maxFiles - 1));
+          for (const item of toEvict) {
+            try {
+              (0, import_fs23.unlinkSync)((0, import_path24.join)(knowledgeDir, item.f));
+            } catch {
+            }
+          }
+        } catch {
+        }
+      }
       /**
        * Update task memory importance based on consensus signals.
        * High-quality findings get boosted, hallucinations get reduced.
@@ -32298,6 +32435,10 @@ var init_dispatch_pipeline = __esm({
         if (consensusFindings.length > 0) {
           gossipLog(`\u{1F4CB} pre-fetched ${consensusFindings.length} consensus findings for ${agentId}`);
         }
+        const agentCorrections = this.memReader.prefetchAgentCorrectionsText(agentId, task);
+        if (agentCorrections.length > 0) {
+          gossipLog(`\u{1F9E0} pre-fetched ${agentCorrections.length} prior corrections for ${agentId}`);
+        }
         const effectiveSkills = resolveEffectiveSkills(agentId, agentSkills, this.skillIndex ?? void 0);
         const skillWarnings = this.catalog ? this.catalog.checkCoverage(effectiveSkills, task) : [];
         const sessionGossip = this.sessionContext.getSessionGossip();
@@ -32348,7 +32489,8 @@ var init_dispatch_pipeline = __esm({
           consensusSummary: options?.consensus,
           specReviewContext,
           projectStructure: this.getProjectStructure(),
-          consensusFindings: consensusFindings.length > 0 ? consensusFindings : void 0
+          consensusFindings: consensusFindings.length > 0 ? consensusFindings : void 0,
+          agentCorrections: agentCorrections.length > 0 ? agentCorrections : void 0
         });
         this.taskGraph.recordCreated(taskId, agentId, task, agentSkills);
         const entry = {
@@ -40598,6 +40740,7 @@ __export(src_exports3, {
   JACCARD_THRESHOLD: () => JACCARD_THRESHOLD,
   KEY_REQUIRING_PROVIDERS: () => KEY_REQUIRING_PROVIDERS,
   LEDGER_INDEX_FILENAME: () => LEDGER_INDEX_FILENAME,
+  LESSON_CARDS_MAX_PER_AGENT: () => LESSON_CARDS_MAX_PER_AGENT,
   LensGenerator: () => LensGenerator,
   MAX_ASSEMBLED_PROMPT_CHARS: () => MAX_ASSEMBLED_PROMPT_CHARS,
   MAX_CLAIMS_PER_BLOCK: () => MAX_CLAIMS_PER_BLOCK,
@@ -40641,6 +40784,7 @@ __export(src_exports3, {
   SkillEngine: () => SkillEngine,
   SkillGapTracker: () => SkillGapTracker,
   SkillIndex: () => SkillIndex,
+  TERMINAL_LESSON_SIGNALS: () => TERMINAL_LESSON_SIGNALS,
   TIMEOUT_DAYS: () => TIMEOUT_DAYS,
   TIMEOUT_MS: () => TIMEOUT_MS,
   TOOL_SCHEMAS: () => TOOL_SCHEMAS2,
@@ -40808,6 +40952,7 @@ __export(src_exports3, {
   verifyClaims: () => verifyClaims,
   withResolverLock: () => withResolverLock,
   writeLedgerIndex: () => writeLedgerIndex,
+  writeLessonCardsForSignals: () => writeLessonCardsForSignals,
   writeOrchestratorRoleMarker: () => writeOrchestratorRoleMarker
 });
 var init_src4 = __esm({
@@ -46531,11 +46676,11 @@ var init_routes = __esm({
         }
         if (!existsSync74(reportsDir)) return { reports: [], totalReports: 0, page, pageSize, retractedConsensusIds, roundRetractions };
         try {
-          const { statSync: statSync36 } = require("fs");
+          const { statSync: statSync37 } = require("fs");
           const allFiles = readdirSync22(reportsDir).filter((f) => f.endsWith(".json")).sort((a, b) => {
             try {
-              const aTime = statSync36((0, import_path80.join)(reportsDir, a)).mtimeMs;
-              const bTime = statSync36((0, import_path80.join)(reportsDir, b)).mtimeMs;
+              const aTime = statSync37((0, import_path80.join)(reportsDir, a)).mtimeMs;
+              const bTime = statSync37((0, import_path80.join)(reportsDir, b)).mtimeMs;
               return bTime - aTime;
             } catch {
               return 0;
@@ -49403,7 +49548,7 @@ function appendRelayWarning(projectRoot, entry) {
 }
 function checkWorktreeEngaged(startedAt, projectRoot = process.cwd()) {
   try {
-    const { readdirSync: readdirSync22, statSync: statSync36 } = require("fs");
+    const { readdirSync: readdirSync22, statSync: statSync37 } = require("fs");
     const { join: join93 } = require("path");
     const wtDir = join93(projectRoot, ".claude", "worktrees");
     let entries;
@@ -49416,7 +49561,7 @@ function checkWorktreeEngaged(startedAt, projectRoot = process.cwd()) {
     for (const entry of entries) {
       if (!entry.startsWith("agent-")) continue;
       try {
-        const st = statSync36(join93(wtDir, entry));
+        const st = statSync37(join93(wtDir, entry));
         if (st.isDirectory() && st.mtimeMs >= startedAt - 2e3) return true;
       } catch {
       }
@@ -81759,7 +81904,7 @@ Ledger: ${ledgerPath2}`
       } catch {
       }
       try {
-        const { readdirSync: readdirSync22, statSync: statSync36, readFileSync: readFileSync70 } = await import("fs");
+        const { readdirSync: readdirSync22, statSync: statSync37, readFileSync: readFileSync70 } = await import("fs");
         const { readJsonlWithRotated: readJsonlRotated1506 } = await Promise.resolve().then(() => (init_src4(), src_exports3));
         const reportsDir = (0, import_path97.join)(process.cwd(), ".gossip", "consensus-reports");
         const perfPath = (0, import_path97.join)(process.cwd(), ".gossip", "agent-performance.jsonl");
@@ -81770,7 +81915,7 @@ Ledger: ${ledgerPath2}`
           for (const fname of readdirSync22(reportsDir)) {
             if (!fname.endsWith(".json")) continue;
             const fpath = (0, import_path97.join)(reportsDir, fname);
-            const st = statSync36(fpath);
+            const st = statSync37(fpath);
             if (now - st.mtimeMs > WINDOW_MS3) continue;
             try {
               const report = JSON.parse(readFileSync70(fpath, "utf8"));
@@ -82595,6 +82740,7 @@ ${output}` }]
         agent_id: external_exports.string().describe("Agent being evaluated"),
         counterpart_id: external_exports.string().optional().describe("The other agent involved (e.g., who won the disagreement)"),
         finding: external_exports.string().describe("Brief description of the finding"),
+        lesson: external_exports.string().optional().describe("Root-cause narrative for a terminal correction signal \u2014 1-2 sentences on why it failed and the check that would have caught it. Written verbatim into the discovering agent's lesson card (issue #642 A)."),
         finding_id: external_exports.string().optional().describe("Consensus finding ID \u2014 links this signal to a specific finding in a consensus report. Enables dashboard to resolve UNVERIFIED findings."),
         severity: external_exports.enum(["critical", "high", "medium", "low"]).optional().describe("Finding severity for impact scoring. If omitted, defaults to medium."),
         category: external_exports.string().optional().describe("Finding category for ATI competency profiles (e.g., concurrency, trust_boundaries, injection_vectors, resource_exhaustion, type_safety, error_handling, data_integrity, input_validation)"),
@@ -83083,6 +83229,11 @@ Uncategorized finding_ids: ${uncategorized.join(", ")}`;
           if (dedupedConsensus.length > 0) emitRecordConsensusSignals(process.cwd(), dedupedConsensus);
           if (dedupedImpl.length > 0) emitRecordImplSignals(process.cwd(), dedupedImpl);
         }
+        try {
+          const { writeLessonCardsForSignals: writeLessonCardsForSignals2 } = await Promise.resolve().then(() => (init_src4(), src_exports3));
+          writeLessonCardsForSignals2(process.cwd(), signals ?? []);
+        } catch {
+        }
         const hallucinationSignals = deduped.filter(
           (s) => s.type === "consensus" && s.signal === "hallucination_caught"
         );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gossipcat",
-  "version": "0.6.8",
+  "version": "0.6.9",
   "description": "Multi-agent orchestration for Claude Code — parallel review, consensus, adaptive dispatch",
   "mcpName": "io.github.ataberk-xyz/gossipcat",
   "repository": {