bikky 0.3.1 → 0.3.2

package/dist/daemon/capture-policy.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Daemon-owned capture policy for ontology v2.
+ *
+ * These constants define when Bikky should capture memory, how large each
+ * generated object should be, and which prompt/capture versions are stored on
+ * payloads for later audits and prompt evolution.
+ */
+import type { Category, MemorySubtype } from "../mcp/taxonomy.js";
+export declare const CAPTURE_POLICY_VERSION = "capture-policy-v2";
+export declare const PROMPT_VERSIONS: {
+    readonly factExtraction: "fact-extraction-v2";
+    readonly sessionIndex: "session-index-v1";
+    readonly episodeSummary: "episode-summary-v1";
+    readonly workstreamSummary: "workstream-summary-v1";
+    readonly distillation: "distillation-v1";
+};
+export declare const CAPTURE_TRIGGERS: {
+    readonly factExtraction: {
+        readonly minEvents: 10;
+        readonly minUsefulCharacters: 280;
+        readonly maxEventsPerBatch: 120;
+        readonly cooldownSeconds: 300;
+    };
+    readonly episodeSummary: {
+        readonly minEvents: 12;
+        readonly minUsefulCharacters: 600;
+        readonly maxEventsPerEpisode: 80;
+        readonly idleGapMinutes: 20;
+        readonly forceCheckpointEvents: 140;
+    };
+    readonly sessionIndex: {
+        readonly minEvents: 1;
+        readonly forceCheckpointEvents: 140;
+        readonly maxRecentEpisodeRefs: 12;
+    };
+    readonly workstreamSummary: {
+        readonly minEpisodeCount: 1;
+        readonly minConfidence: 0.65;
+        readonly maxEpisodesPerUpdate: 8;
+    };
+    readonly distillation: {
+        readonly minSourceSummaries: 5;
+        readonly maxSourceSummaries: 20;
+        readonly lookbackDays: 14;
+    };
+};
+export declare const CAPTURE_BUDGETS: {
+    readonly fact: {
+        readonly maxFactsPerBatch: 6;
+        readonly targetWords: readonly [12, 45];
+        readonly maxEntities: 8;
+    };
+    readonly episodeSummary: {
+        readonly targetWords: readonly [90, 180];
+        readonly maxTasks: 8;
+        readonly maxDecisions: 8;
+        readonly maxOpenQuestions: 6;
+    };
+    readonly sessionIndex: {
+        readonly targetWords: readonly [30, 80];
+        readonly maxEpisodeRefs: 12;
+    };
+    readonly workstreamSummary: {
+        readonly targetWords: readonly [120, 240];
+        readonly maxCurrentDecisions: 8;
+        readonly maxNextSteps: 8;
+        readonly maxBlockers: 6;
+    };
+    readonly distilled: {
+        readonly targetWords: readonly [60, 160];
+        readonly maxSourceRefs: 12;
+    };
+};
+export declare const QUALITY_THRESHOLDS: {
+    readonly minFactConfidence: 0.55;
+    readonly minFactQualityScore: 0.6;
+    readonly minImportanceForLowConfidenceFact: 0.75;
+    readonly rejectStatusOnlyFacts: true;
+    readonly rejectDuplicatedTranscriptNarration: true;
+};
+export declare const CAPTURE_KIND_SUBTYPES: {
+    readonly fact: readonly ["codebase_map", "architecture_decision", "infra_topology", "access_pattern", "deployment_procedure", "operational_procedure", "domain_rule", "troubleshooting_gotcha", "preference", "ownership"];
+    readonly summary: readonly ["session_index", "episode", "workstream"];
+    readonly distilled: readonly ["runbook_candidate", "failure_mode", "convention", "architecture_pattern", "product_insight"];
+};
+export declare const FACT_CATEGORY_TO_SUBTYPE: Record<Category, MemorySubtype>;
+export declare const DEFAULT_CAPTURE_CONTEXT: {
+    readonly domain: "software_engineering" | "product_strategy" | "business_operations" | "research" | "personal_productivity";
+    readonly source: "daemon";
+    readonly reviewStatus: "candidate";
+    readonly volatility: "medium";
+};
+export declare function promptVersionForSubtype(subtype: MemorySubtype): string;
+export declare function subtypeForCategory(category: Category): MemorySubtype;
+//# sourceMappingURL=capture-policy.d.ts.map

package/dist/daemon/capture-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-policy.d.ts","sourceRoot":"","sources":["../../src/daemon/capture-policy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAQ,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxE,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAE1D,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAEX,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BnB,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BlB,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC;AAEX,eAAO,MAAM,qBAAqB;;;;CAqBkC,CAAC;AAErE,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,QAAQ,EAAE,aAAa,CAUpE,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;CAK1B,CAAC;AAEX,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CActE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa,CAEpE"}

package/dist/daemon/capture-policy.js

@@ -0,0 +1,139 @@
+/**
+ * Daemon-owned capture policy for ontology v2.
+ *
+ * These constants define when Bikky should capture memory, how large each
+ * generated object should be, and which prompt/capture versions are stored on
+ * payloads for later audits and prompt evolution.
+ */
+import { DEFAULT_DOMAIN } from "../mcp/taxonomy.js";
+export const CAPTURE_POLICY_VERSION = "capture-policy-v2";
+export const PROMPT_VERSIONS = {
+    factExtraction: "fact-extraction-v2",
+    sessionIndex: "session-index-v1",
+    episodeSummary: "episode-summary-v1",
+    workstreamSummary: "workstream-summary-v1",
+    distillation: "distillation-v1",
+};
+export const CAPTURE_TRIGGERS = {
+    factExtraction: {
+        minEvents: 10,
+        minUsefulCharacters: 280,
+        maxEventsPerBatch: 120,
+        cooldownSeconds: 300,
+    },
+    episodeSummary: {
+        minEvents: 12,
+        minUsefulCharacters: 600,
+        maxEventsPerEpisode: 80,
+        idleGapMinutes: 20,
+        forceCheckpointEvents: 140,
+    },
+    sessionIndex: {
+        minEvents: 1,
+        forceCheckpointEvents: 140,
+        maxRecentEpisodeRefs: 12,
+    },
+    workstreamSummary: {
+        minEpisodeCount: 1,
+        minConfidence: 0.65,
+        maxEpisodesPerUpdate: 8,
+    },
+    distillation: {
+        minSourceSummaries: 5,
+        maxSourceSummaries: 20,
+        lookbackDays: 14,
+    },
+};
+export const CAPTURE_BUDGETS = {
+    fact: {
+        maxFactsPerBatch: 6,
+        targetWords: [12, 45],
+        maxEntities: 8,
+    },
+    episodeSummary: {
+        targetWords: [90, 180],
+        maxTasks: 8,
+        maxDecisions: 8,
+        maxOpenQuestions: 6,
+    },
+    sessionIndex: {
+        targetWords: [30, 80],
+        maxEpisodeRefs: 12,
+    },
+    workstreamSummary: {
+        targetWords: [120, 240],
+        maxCurrentDecisions: 8,
+        maxNextSteps: 8,
+        maxBlockers: 6,
+    },
+    distilled: {
+        targetWords: [60, 160],
+        maxSourceRefs: 12,
+    },
+};
+export const QUALITY_THRESHOLDS = {
+    minFactConfidence: 0.55,
+    minFactQualityScore: 0.6,
+    minImportanceForLowConfidenceFact: 0.75,
+    rejectStatusOnlyFacts: true,
+    rejectDuplicatedTranscriptNarration: true,
+};
+export const CAPTURE_KIND_SUBTYPES = {
+    fact: [
+        "codebase_map",
+        "architecture_decision",
+        "infra_topology",
+        "access_pattern",
+        "deployment_procedure",
+        "operational_procedure",
+        "domain_rule",
+        "troubleshooting_gotcha",
+        "preference",
+        "ownership",
+    ],
+    summary: ["session_index", "episode", "workstream"],
+    distilled: [
+        "runbook_candidate",
+        "failure_mode",
+        "convention",
+        "architecture_pattern",
+        "product_insight",
+    ],
+};
+export const FACT_CATEGORY_TO_SUBTYPE = {
+    codebase: "codebase_map",
+    infrastructure: "infra_topology",
+    operations: "operational_procedure",
+    decisions: "architecture_decision",
+    product_domain: "domain_rule",
+    projects: "codebase_map",
+    people: "ownership",
+    preferences: "preference",
+    observations: "troubleshooting_gotcha",
+};
+export const DEFAULT_CAPTURE_CONTEXT = {
+    domain: DEFAULT_DOMAIN,
+    source: "daemon",
+    reviewStatus: "candidate",
+    volatility: "medium",
+};
+export function promptVersionForSubtype(subtype) {
+    if (subtype === "session_index")
+        return PROMPT_VERSIONS.sessionIndex;
+    if (subtype === "episode")
+        return PROMPT_VERSIONS.episodeSummary;
+    if (subtype === "workstream")
+        return PROMPT_VERSIONS.workstreamSummary;
+    if (subtype === "runbook_candidate" ||
+        subtype === "failure_mode" ||
+        subtype === "convention" ||
+        subtype === "architecture_pattern" ||
+        subtype === "product_insight") {
+        return PROMPT_VERSIONS.distillation;
+    }
+    return PROMPT_VERSIONS.factExtraction;
+}
+export function subtypeForCategory(category) {
+    return FACT_CATEGORY_TO_SUBTYPE[category];
+}
+//# sourceMappingURL=capture-policy.js.map

package/dist/daemon/capture-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-policy.js","sourceRoot":"","sources":["../../src/daemon/capture-policy.ts"],"names":[],"mappings":"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"}

package/dist/daemon/capture-policy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=capture-policy.test.d.ts.map

package/dist/daemon/capture-policy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-policy.test.d.ts","sourceRoot":"","sources":["../../src/daemon/capture-policy.test.ts"],"names":[],"mappings":""}

package/dist/daemon/capture-policy.test.js

@@ -0,0 +1,46 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { CAPTURE_BUDGETS, CAPTURE_KIND_SUBTYPES, CAPTURE_POLICY_VERSION, CAPTURE_TRIGGERS, DEFAULT_CAPTURE_CONTEXT, PROMPT_VERSIONS, QUALITY_THRESHOLDS, promptVersionForSubtype, subtypeForCategory, } from "./capture-policy.js";
+describe("daemon/capture-policy", () => {
+    it("uses ontology v2 and software_engineering defaults", () => {
+        assert.strictEqual(CAPTURE_POLICY_VERSION, "capture-policy-v2");
+        assert.strictEqual(DEFAULT_CAPTURE_CONTEXT.domain, "software_engineering");
+        assert.strictEqual(DEFAULT_CAPTURE_CONTEXT.source, "daemon");
+        assert.strictEqual(DEFAULT_CAPTURE_CONTEXT.reviewStatus, "candidate");
+    });
+    it("keeps fact extraction cadence aligned with config defaults", () => {
+        assert.strictEqual(CAPTURE_TRIGGERS.factExtraction.minEvents, 10);
+        assert.strictEqual(CAPTURE_TRIGGERS.factExtraction.cooldownSeconds, 300);
+        assert.ok(CAPTURE_TRIGGERS.factExtraction.maxEventsPerBatch > CAPTURE_TRIGGERS.factExtraction.minEvents);
+    });
+    it("defines bounded budgets for every first-slice object", () => {
+        assert.ok(CAPTURE_BUDGETS.fact.maxFactsPerBatch > 0);
+        assert.ok(CAPTURE_BUDGETS.episodeSummary.targetWords[0] < CAPTURE_BUDGETS.episodeSummary.targetWords[1]);
+        assert.ok(CAPTURE_BUDGETS.workstreamSummary.targetWords[0] < CAPTURE_BUDGETS.workstreamSummary.targetWords[1]);
+        assert.ok(CAPTURE_BUDGETS.distilled.maxSourceRefs > 0);
+    });
+    it("maps each capture kind to approved subtypes", () => {
+        assert.ok(CAPTURE_KIND_SUBTYPES.fact?.includes("codebase_map"));
+        assert.ok(CAPTURE_KIND_SUBTYPES.summary?.includes("episode"));
+        assert.ok(CAPTURE_KIND_SUBTYPES.distilled?.includes("convention"));
+    });
+    it("maps categories to deterministic default fact subtypes", () => {
+        assert.strictEqual(subtypeForCategory("codebase"), "codebase_map");
+        assert.strictEqual(subtypeForCategory("infrastructure"), "infra_topology");
+        assert.strictEqual(subtypeForCategory("people"), "ownership");
+        assert.strictEqual(subtypeForCategory("preferences"), "preference");
+    });
+    it("selects prompt versions by subtype lifecycle", () => {
+        assert.strictEqual(promptVersionForSubtype("codebase_map"), PROMPT_VERSIONS.factExtraction);
+        assert.strictEqual(promptVersionForSubtype("session_index"), PROMPT_VERSIONS.sessionIndex);
+        assert.strictEqual(promptVersionForSubtype("episode"), PROMPT_VERSIONS.episodeSummary);
+        assert.strictEqual(promptVersionForSubtype("workstream"), PROMPT_VERSIONS.workstreamSummary);
+        assert.strictEqual(promptVersionForSubtype("convention"), PROMPT_VERSIONS.distillation);
+    });
+    it("sets quality thresholds that reject weak daemon memories", () => {
+        assert.ok(QUALITY_THRESHOLDS.minFactConfidence > 0.5);
+        assert.ok(QUALITY_THRESHOLDS.minFactQualityScore > 0.5);
+        assert.strictEqual(QUALITY_THRESHOLDS.rejectStatusOnlyFacts, true);
+    });
+});
+//# sourceMappingURL=capture-policy.test.js.map

package/dist/daemon/capture-policy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-policy.test.js","sourceRoot":"","sources":["../../src/daemon/capture-policy.test.ts"],"names":[],"mappings":"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"}

package/dist/daemon/consolidation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consolidation.d.ts","sourceRoot":"","sources":["../../src/daemon/consolidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAA4B,MAAM,aAAa,CAAC;AAMnE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;CACzD;AASD,QAAA,MAAM,SAAS,GAAI,IAAI,KAAK,KAAG,IAAuB,CAAC;AAgIvD;;;GAGG;AACH,QAAA,MAAM,mBAAmB,GACvB,MAAM;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EACpF,SAAS,WAAW,KACnB,OAAO,CAAC,mBAAmB,CAmE7B,CAAC;AAwPF;;;GAGG;AACH,QAAA,MAAM,IAAI,GAAU,QAAQ,WAAW,EAAE,OAAM,wBAA6B,KAAG,OAAO,CAAC,IAAI,CAkC1F,CAAC;AAEF,iCAAiC;AACjC,QAAA,MAAM,MAAM,QAAO,IAElB,CAAC;AAEF,OAAO,EACL,mBAAmB,EACnB,IAAI,EACJ,SAAS,EACT,MAAM,GACP,CAAC"}
+{"version":3,"file":"consolidation.d.ts","sourceRoot":"","sources":["../../src/daemon/consolidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAmBH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAA4B,MAAM,aAAa,CAAC;AAMnE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;CACzD;AASD,QAAA,MAAM,SAAS,GAAI,IAAI,KAAK,KAAG,IAAuB,CAAC;AA6IvD;;;GAGG;AACH,QAAA,MAAM,mBAAmB,GACvB,MAAM;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EACpF,SAAS,WAAW,KACnB,OAAO,CAAC,mBAAmB,CAyE7B,CAAC;AAuOF;;;GAGG;AACH,QAAA,MAAM,IAAI,GAAU,QAAQ,WAAW,EAAE,OAAM,wBAA6B,KAAG,OAAO,CAAC,IAAI,CAkC1F,CAAC;AAEF,iCAAiC;AACjC,QAAA,MAAM,MAAM,QAAO,IAElB,CAAC;AAEF,OAAO,EACL,mBAAmB,EACnB,IAAI,EACJ,SAAS,EACT,MAAM,GACP,CAAC"}

package/dist/daemon/consolidation.js

@@ -14,7 +14,8 @@ import { join, dirname } from "node:path";
 import { createHash } from "node:crypto";
 import * as qdrant from "./qdrant.js";
 import { chatCompletion } from "../llm/index.js";
-import { categoryValues } from "../mcp/taxonomy.js";
+import { categoryValues, normalizeCategory, normalizeDomain } from "../mcp/taxonomy.js";
+import { distillPrompt, DISTILL_PROMPT_DESCRIPTOR, contradictionPrompt, briefPrompt, BRIEF_PROMPT_DESCRIPTOR, safeParseJson, } from "../prompts/index.js";
 import { STATE_DIR } from "../config.js";
 // ---------------------------------------------------------------------------
 // State
@@ -65,35 +66,33 @@ const autoDistill = async (_config, { minSummaries = 5 } = {}) => {
         if (points.length < minSummaries) {
             return { distilled: false, count: points.length };
         }
-        // Sort by date (oldest first)
-        points.sort((a, b) => (a.payload?.created_at || "").localeCompare(b.payload?.created_at || ""));
-        // Take the oldest batch (up to 20)
+        // Sort by date — newest first (recent patterns are more actionable)
+        points.sort((a, b) => (b.payload?.created_at || "").localeCompare(a.payload?.created_at || ""));
+        // Take the latest batch (up to 20)
         const batch = points.slice(0, 20);
-        const summaryTexts = batch.map(pt => `[${pt.payload?.created_at?.slice(0, 10)}] ${pt.payload?.content}`).join("\n");
-        const raw = await chatCompletion({
-            messages: [
-                { role: "system", content: "You consolidate session summaries into high-level patterns. Output only valid JSON." },
-                { role: "user", content: `Consolidate these ${batch.length} session summaries into 3-5 distilled patterns.
-
-## Session Summaries:
-${summaryTexts}
-
-## Output (JSON array):
-Each object: { "content": "pattern description (1-2 sentences)", "entities": ["entity1", "entity2"], "importance": 0.0-1.0 }
-
-Return ONLY the JSON array.` },
-            ],
-            temperature: 0.2,
-            max_tokens: 1000,
+        const rendered = distillPrompt({
+            summaries: batch.map((pt, i) => ({
+                id: i + 1,
+                date: pt.payload?.created_at?.slice(0, 10) ?? "unknown",
+                content: pt.payload?.content ?? "",
+            })),
         });
+        const raw = await chatCompletion(rendered);
         if (!raw) {
             logFn("WARN", "Auto-distill LLM returned empty");
             return { distilled: false };
         }
-        const jsonStr = raw.replace(/^```json?\n?/, "").replace(/\n?```$/, "").trim();
-        const patterns = JSON.parse(jsonStr);
-        if (!Array.isArray(patterns) || patterns.length === 0)
+        const parsed = safeParseJson(raw);
+        let patterns = [];
+        if (Array.isArray(parsed)) {
+            patterns = parsed;
+        }
+        else if (parsed && Array.isArray(parsed.patterns)) {
+            patterns = parsed.patterns;
+        }
+        if (patterns.length === 0)
             return { distilled: false };
+        const promptStamp = `${DISTILL_PROMPT_DESCRIPTOR.id}@${DISTILL_PROMPT_DESCRIPTOR.version}`;
         // Store distilled patterns
         for (const pattern of patterns) {
             if (!pattern.content)
@@ -101,15 +100,19 @@ Return ONLY the JSON array.` },
             const hash = createHash("sha256").update(`distilled:${pattern.content}`).digest("hex");
             await qdrant.storeFact({
                 content: pattern.content,
-                category: "observation",
-                domain: "work",
+                category: normalizeCategory(pattern.category ?? "observation"),
+                domain: normalizeDomain(pattern.domain ?? "work"),
                 kind: "distilled",
                 entities: Array.isArray(pattern.entities) ? pattern.entities.map(e => String(e).toLowerCase()) : [],
                 source: "system",
                 confidence: 0.85,
                 importance: pattern.importance || 0.7,
                 content_hash: hash,
-                metadata: { distilled_from: batch.length.toString(), distilled_at: new Date().toISOString() },
+                metadata: {
+                    distilled_from: batch.length.toString(),
+                    distilled_at: new Date().toISOString(),
+                    distilled_by_prompt: promptStamp,
+                },
             });
         }
         // Supersede the source summaries
@@ -132,54 +135,54 @@ Return ONLY the JSON array.` },
 const detectContradiction = async (fact, _config) => {
     if (!qdrant.isReady())
         return { contradiction: false };
-    if ((fact.importance || 0) < 0.5)
+    if ((fact.importance || 0) < 0.3)
         return { contradiction: false };
     try {
         const vector = await qdrant.embed(fact.content);
+        // Search across ALL categories — contradictions can cross category lines
+        // (e.g. an "infrastructure" port fact vs an "observation" workaround fact).
         const results = await qdrant.qdrantRequest("POST", `/collections/${qdrant.collection}/points/search`, {
             vector,
-            filter: {
-                must: [
-                    { key: "category", match: { value: fact.category } },
-                    { is_null: { key: "superseded_by" } },
-                ],
-            },
-            limit: 3,
+            filter: { must: [{ is_null: { key: "superseded_by" } }] },
+            limit: 5,
             with_payload: true,
         });
         const candidates = (results.result || [])
             .filter(r => r.score >= 0.75 && r.score < 0.92);
         if (candidates.length === 0)
             return { contradiction: false };
-        // Use LLM to check if any candidate contradicts the new fact
-        const candidateTexts = candidates.map(c => `ID: ${c.id}\nFact: ${c.payload?.content}\nSimilarity: ${c.score.toFixed(3)}`).join("\n\n");
-        const raw = await chatCompletion({
-            messages: [
-                { role: "system", content: "You detect contradictions between facts. Output only valid JSON." },
-                { role: "user", content: `Does the NEW fact contradict any of the EXISTING facts?
-
-NEW FACT: ${fact.content}
-
-EXISTING FACTS:
-${candidateTexts}
-
-If a contradiction exists, return: {"contradiction": true, "existing_id": "the contradicted fact ID", "reason": "brief explanation"}
-If no contradiction: {"contradiction": false}
-
-Return ONLY the JSON object.` },
-            ],
-            temperature: 0.1,
-            max_tokens: 200,
+        const rendered = contradictionPrompt({
+            newFact: { content: fact.content, category: fact.category },
+            candidates: candidates.map((c) => ({
+                id: c.id,
+                content: c.payload?.content ?? "",
+                category: c.payload?.category ?? "unknown",
+                score: c.score,
+            })),
         });
+        const raw = await chatCompletion(rendered);
         if (!raw)
             return { contradiction: false };
-        const result = JSON.parse(raw.replace(/^```json?\n?/, "").replace(/\n?```$/, "").trim());
-        if (result.contradiction && result.existing_id) {
-            logFn("INFO", `Contradiction detected: "${fact.content}" vs existing ${result.existing_id}: ${result.reason}`);
+        const result = safeParseJson(raw);
+        if (!result)
+            return { contradiction: false };
+        const outcome = result.outcome
+            ?? (result.contradiction === true ? "contradicted" : "compatible");
+        if (outcome === "compatible")
+            return { contradiction: false };
+        if (outcome === "superseded" && result.existing_id) {
+            // Auto-resolve: caller (extraction) marks the old fact superseded via
+            // qdrant dedup machinery; here we just signal it's not a contradiction.
+            logFn("INFO", `Supersede detected: "${fact.content.slice(0, 60)}…" → existing ${result.existing_id} (${result.reason ?? ""})`);
+            return { contradiction: false };
+        }
+        if (outcome === "contradicted" && result.existing_id) {
+            const existing = candidates.find((c) => c.id === result.existing_id);
+            logFn("INFO", `Contradiction detected: "${fact.content}" vs existing ${result.existing_id}: ${result.reason ?? ""}`);
             return {
                 contradiction: true,
                 existingId: result.existing_id,
-                existingContent: candidates.find(c => c.id === result.existing_id)?.payload?.content,
+                existingContent: existing?.payload?.content,
                 reason: result.reason,
             };
         }
@@ -327,6 +330,16 @@ const formatHealthReport = (report) => {
  * Generate a compact memory brief from top facts.
  * Written to ~/.bikky/state/brief.md for agent orientation.
  */
+const CATEGORY_TO_HEADING = {
+    team: "Key People & Team",
+    people: "Key People & Team",
+    projects: "Active Projects",
+    infrastructure: "Infrastructure Overview",
+    decisions: "Recent Decisions",
+    observation: "Known Gotchas",
+    observations: "Known Gotchas",
+    preferences: "Preferences & Conventions",
+};
 const generateMemoryBrief = async (_config) => {
     if (!qdrant.isReady())
         return false;
@@ -335,6 +348,9 @@ const generateMemoryBrief = async (_config) => {
         const sections = {};
         const categories = CATEGORIES;
         for (const cat of categories) {
+            const heading = CATEGORY_TO_HEADING[cat];
+            if (!heading)
+                continue;
             const result = await qdrant.qdrantRequest("POST", `/collections/${qdrant.collection}/points/scroll`, {
                 filter: {
                     must: [
@@ -349,55 +365,25 @@ const generateMemoryBrief = async (_config) => {
                 .sort((a, b) => (b.payload?.importance || 0) - (a.payload?.importance || 0))
                 .slice(0, 10);
             if (points.length > 0) {
-                sections[cat] = points.map(pt => pt.payload?.content).filter(Boolean);
+                const existing = sections[heading] ?? [];
+                const newOnes = points.map(pt => pt.payload?.content).filter(Boolean);
+                sections[heading] = [...existing, ...newOnes];
             }
         }
         if (Object.keys(sections).length === 0)
             return false;
-        // Use LLM to synthesize into a structured brief
-        const factsText = Object.entries(sections)
-            .map(([cat, facts]) => `### ${cat}\n${facts.map(f => `- ${f}`).join("\n")}`)
-            .join("\n\n");
-        const brief = await chatCompletion({
-            messages: [
-                { role: "system", content: "You generate concise orientation documents for AI agents. Write in a structured, scannable format." },
-                { role: "user", content: `Generate a compact memory brief from these facts. This brief will be loaded by AI agents at session start for orientation.
-
-## Facts by Category:
-${factsText}
-
-## Output Format (markdown):
-# Memory Brief
-Generated: [date]
-
-## Key People & Team
-[who matters and their roles]
-
-## Active Projects
-[what's in progress, blocked, recently completed]
-
-## Infrastructure Overview
-[key services, databases, deployment details]
-
-## Recent Decisions
-[important architectural/technical decisions]
-
-## Known Gotchas
-[errors, workarounds, caveats to watch for]
-
-## Preferences & Conventions
-[user/team preferences, coding style, etc.]
-
-Keep each section to 3-5 bullet points. Omit empty sections. Be factual, not chatty.` },
-            ],
-            temperature: 0.2,
-            max_tokens: 1500,
-        });
+        const generatedAt = new Date().toISOString().slice(0, 10);
+        const rendered = briefPrompt({ generatedAt, sections });
+        const brief = await chatCompletion(rendered);
         if (!brief)
             return false;
+        // Stamp the prompt version as a comment so we know which prompt produced
+        // a given on-disk brief (debugging aid; ignored by markdown renderers).
+        const promptStamp = `${BRIEF_PROMPT_DESCRIPTOR.id}@${BRIEF_PROMPT_DESCRIPTOR.version}`;
+        const output = `<!-- generated by ${promptStamp} -->\n${brief}\n`;
         // Write to disk
         mkdirSync(dirname(MEMORY_BRIEF_PATH), { recursive: true });
-        writeFileSync(MEMORY_BRIEF_PATH, brief + "\n", "utf8");
+        writeFileSync(MEMORY_BRIEF_PATH, output, "utf8");
         logFn("INFO", `Memory brief generated: ${MEMORY_BRIEF_PATH} (${brief.length} chars)`);
         return true;
     }