agent-recall-mcp 3.2.3 → 3.3.2

package/dist/palace/fan-out.js

@@ -0,0 +1,78 @@
+/**
+ * Fan-out write logic.
+ * When content is written to a room, this module:
+ * 1. Parses [[wikilinks]] from the content
+ * 2. Adds back-references in referenced rooms
+ * 3. Updates graph.json with new edges
+ * 4. Recalculates salience for affected rooms
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { palaceDir } from "../storage/paths.js";
+import { extractWikilinks, addBackReference } from "./obsidian.js";
+import { addEdge, getConnectionCount } from "./graph.js";
+import { getRoomMeta, updateRoomMeta } from "./rooms.js";
+import { computeSalience } from "./salience.js";
+export function fanOut(project, sourceRoom, sourceTopic, content, explicitConnections = [], importance = "medium") {
+    const pd = palaceDir(project);
+    const result = { updatedRooms: [], newEdges: 0 };
+    // Collect all targets: from wikilinks + explicit connections
+    const wikiTargets = extractWikilinks(content);
+    const allTargets = new Set([...wikiTargets, ...explicitConnections]);
+    for (const target of allTargets) {
+        // Target could be "roomSlug" or "roomSlug/topic"
+        const targetRoom = target.split("/")[0];
+        if (targetRoom === sourceRoom)
+            continue; // skip self-references
+        // Add back-reference in target room's README.md
+        const targetReadme = path.join(pd, "rooms", targetRoom, "README.md");
+        if (fs.existsSync(targetReadme)) {
+            const readmeContent = fs.readFileSync(targetReadme, "utf-8");
+            const updated = addBackReference(readmeContent, sourceRoom, sourceTopic);
+            if (updated !== readmeContent) {
+                fs.writeFileSync(targetReadme, updated, "utf-8");
+                result.updatedRooms.push(targetRoom);
+            }
+        }
+        // Add edge to graph
+        addEdge(pd, `${sourceRoom}/${sourceTopic}`, target, "references");
+        result.newEdges++;
+        // Update target room's connections list
+        const targetMeta = getRoomMeta(project, targetRoom);
+        if (targetMeta && !targetMeta.connections.includes(sourceRoom)) {
+            updateRoomMeta(project, targetRoom, {
+                connections: [...targetMeta.connections, sourceRoom],
+            });
+        }
+    }
+    // Update source room's connections list
+    const sourceMeta = getRoomMeta(project, sourceRoom);
+    if (sourceMeta) {
+        const newConns = new Set(sourceMeta.connections);
+        for (const target of allTargets) {
+            const targetRoom = target.split("/")[0];
+            if (targetRoom !== sourceRoom)
+                newConns.add(targetRoom);
+        }
+        updateRoomMeta(project, sourceRoom, {
+            connections: Array.from(newConns),
+        });
+    }
+    // Recalculate salience for all affected rooms
+    const affectedRooms = new Set([sourceRoom, ...result.updatedRooms]);
+    for (const room of affectedRooms) {
+        const meta = getRoomMeta(project, room);
+        if (!meta)
+            continue;
+        const connCount = getConnectionCount(pd, room);
+        const newSalience = computeSalience({
+            importance,
+            lastUpdated: meta.updated,
+            accessCount: meta.access_count,
+            connectionCount: connCount,
+        });
+        updateRoomMeta(project, room, { salience: newSalience });
+    }
+    return result;
+}
+//# sourceMappingURL=fan-out.js.map

package/dist/palace/fan-out.js.map

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

package/dist/palace/graph.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Palace graph management — cross-reference edges between rooms and memories.
+ */
+import type { PalaceGraph } from "../types.js";
+export declare function readGraph(palaceDir: string): PalaceGraph;
+export declare function writeGraph(palaceDir: string, graph: PalaceGraph): void;
+export declare function addEdge(palaceDir: string, from: string, to: string, type?: string, weight?: number): void;
+export declare function removeEdgesFor(palaceDir: string, target: string): void;
+export declare function getConnectionCount(palaceDir: string, roomSlug: string): number;
+export declare function getConnectedRooms(palaceDir: string, roomSlug: string): string[];
+//# sourceMappingURL=graph.d.ts.map

package/dist/palace/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/palace/graph.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAO1D,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAExD;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAEtE;AAED,wBAAgB,OAAO,CACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,MAAqB,EAC3B,MAAM,GAAE,MAAY,GACnB,IAAI,CAkBN;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAMtE;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS9E;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAgB/E"}

package/dist/palace/graph.js

@@ -0,0 +1,59 @@
+/**
+ * Palace graph management — cross-reference edges between rooms and memories.
+ */
+import * as path from "node:path";
+import { readJsonSafe, writeJsonAtomic } from "../storage/fs-utils.js";
+function graphPath(palaceDir) {
+    return path.join(palaceDir, "graph.json");
+}
+export function readGraph(palaceDir) {
+    return readJsonSafe(graphPath(palaceDir)) ?? { edges: [] };
+}
+export function writeGraph(palaceDir, graph) {
+    writeJsonAtomic(graphPath(palaceDir), graph);
+}
+export function addEdge(palaceDir, from, to, type = "references", weight = 0.5) {
+    const graph = readGraph(palaceDir);
+    // Don't duplicate
+    const exists = graph.edges.some((e) => e.from === from && e.to === to && e.type === type);
+    if (exists)
+        return;
+    graph.edges.push({
+        from,
+        to,
+        type,
+        weight,
+        created: new Date().toISOString(),
+    });
+    writeGraph(palaceDir, graph);
+}
+export function removeEdgesFor(palaceDir, target) {
+    const graph = readGraph(palaceDir);
+    graph.edges = graph.edges.filter((e) => e.from !== target && e.to !== target);
+    writeGraph(palaceDir, graph);
+}
+export function getConnectionCount(palaceDir, roomSlug) {
+    const graph = readGraph(palaceDir);
+    return graph.edges.filter((e) => e.from.startsWith(roomSlug + "/") ||
+        e.to.startsWith(roomSlug + "/") ||
+        e.from === roomSlug ||
+        e.to === roomSlug).length;
+}
+export function getConnectedRooms(palaceDir, roomSlug) {
+    const graph = readGraph(palaceDir);
+    const connected = new Set();
+    for (const edge of graph.edges) {
+        if (edge.from.startsWith(roomSlug + "/") || edge.from === roomSlug) {
+            const target = edge.to.split("/")[0];
+            if (target !== roomSlug)
+                connected.add(target);
+        }
+        if (edge.to.startsWith(roomSlug + "/") || edge.to === roomSlug) {
+            const source = edge.from.split("/")[0];
+            if (source !== roomSlug)
+                connected.add(source);
+        }
+    }
+    return Array.from(connected);
+}
+//# sourceMappingURL=graph.js.map

package/dist/palace/graph.js.map

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

package/dist/palace/identity.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Palace identity card — ~50 token project summary.
+ */
+export declare function readIdentity(project: string): string;
+export declare function writeIdentity(project: string, content: string): void;
+//# sourceMappingURL=identity.d.ts.map

package/dist/palace/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/palace/identity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGpE"}

package/dist/palace/identity.js

@@ -0,0 +1,18 @@
+/**
+ * Palace identity card — ~50 token project summary.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { palaceDir } from "../storage/paths.js";
+export function readIdentity(project) {
+    const idPath = path.join(palaceDir(project), "identity.md");
+    if (!fs.existsSync(idPath)) {
+        return `# ${project}\n\n> No identity card yet. Use palace_write to add one.`;
+    }
+    return fs.readFileSync(idPath, "utf-8");
+}
+export function writeIdentity(project, content) {
+    const idPath = path.join(palaceDir(project), "identity.md");
+    fs.writeFileSync(idPath, content, "utf-8");
+}
+//# sourceMappingURL=identity.js.map

package/dist/palace/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/palace/identity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;IAC5D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,OAAO,0DAA0D,CAAC;IAChF,CAAC;IACD,OAAO,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,OAAe;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;IAC5D,EAAE,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC"}

package/dist/palace/index-manager.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Palace index management — maintains palace-index.json.
+ */
+import type { PalaceIndex } from "../types.js";
+export declare function readPalaceIndex(project: string): PalaceIndex | null;
+export declare function updatePalaceIndex(project: string): PalaceIndex;
+//# sourceMappingURL=index-manager.d.ts.map

package/dist/palace/index-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-manager.d.ts","sourceRoot":"","sources":["../../src/palace/index-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU/C,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAEnE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAoC9D"}

package/dist/palace/index-manager.js

@@ -0,0 +1,46 @@
+/**
+ * Palace index management — maintains palace-index.json.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { VERSION } from "../types.js";
+import { palaceDir } from "../storage/paths.js";
+import { readJsonSafe, writeJsonAtomic } from "../storage/fs-utils.js";
+import { listRooms } from "./rooms.js";
+function indexPath(project) {
+    return path.join(palaceDir(project), "palace-index.json");
+}
+export function readPalaceIndex(project) {
+    return readJsonSafe(indexPath(project));
+}
+export function updatePalaceIndex(project) {
+    const rooms = listRooms(project);
+    const pd = palaceDir(project);
+    const existing = readPalaceIndex(project);
+    const roomsMap = {};
+    for (const room of rooms) {
+        // Count memory files in this room (everything except _room.json and README.md)
+        const roomPath = path.join(pd, "rooms", room.slug);
+        let memoryCount = 0;
+        if (fs.existsSync(roomPath)) {
+            const files = fs.readdirSync(roomPath);
+            memoryCount = files.filter((f) => f.endsWith(".md") && f !== "README.md").length;
+        }
+        roomsMap[room.slug] = {
+            salience: room.salience,
+            memory_count: memoryCount,
+            last_updated: room.updated,
+        };
+    }
+    const index = {
+        version: VERSION,
+        project,
+        created: existing?.created ?? new Date().toISOString(),
+        rooms: roomsMap,
+        identity_hash: existing?.identity_hash ?? "",
+        last_lint: existing?.last_lint ?? "",
+    };
+    writeJsonAtomic(indexPath(project), index);
+    return index;
+}
+//# sourceMappingURL=index-manager.js.map

package/dist/palace/index-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-manager.js","sourceRoot":"","sources":["../../src/palace/index-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,SAAS,SAAS,CAAC,OAAe;IAChC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,YAAY,CAAc,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAE9B,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,+EAA+E;QAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YACvC,WAAW,GAAG,KAAK,CAAC,MAAM,CACxB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,WAAW,CAC9C,CAAC,MAAM,CAAC;QACX,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,WAAW;YACzB,YAAY,EAAE,IAAI,CAAC,OAAO;SAC3B,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAgB;QACzB,OAAO,EAAE,OAAO;QAChB,OAAO;QACP,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACtD,KAAK,EAAE,QAAQ;QACf,aAAa,EAAE,QAAQ,EAAE,aAAa,IAAI,EAAE;QAC5C,SAAS,EAAE,QAAQ,EAAE,SAAS,IAAI,EAAE;KACrC,CAAC;IAEF,eAAe,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/palace/insights-index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Cross-project insights index.
+ *
+ * A single JSON file mapping insights to situations.
+ * When an agent starts a task, it can query: "what insights apply here?"
+ * The system matches the current context against `applies_when` keywords.
+ *
+ * Global scope: ~/.agent-recall/insights-index.json
+ */
+export interface IndexedInsight {
+    id: string;
+    title: string;
+    source: string;
+    applies_when: string[];
+    file?: string;
+    severity: "critical" | "important" | "minor";
+    confirmed_count: number;
+    last_confirmed: string;
+}
+export interface InsightsIndex {
+    version: string;
+    updated: string;
+    insights: IndexedInsight[];
+}
+export declare function readInsightsIndex(): InsightsIndex;
+export declare function writeInsightsIndex(index: InsightsIndex): void;
+/**
+ * Add or update an insight in the index.
+ */
+export declare function addIndexedInsight(insight: Omit<IndexedInsight, "id" | "confirmed_count" | "last_confirmed">): IndexedInsight;
+/**
+ * Recall insights relevant to a given context.
+ * Matches context words against applies_when keywords.
+ * Returns top N matches sorted by relevance (keyword match count × severity weight × confirmation count).
+ */
+export declare function recallInsights(context: string, limit?: number): Array<IndexedInsight & {
+    relevance: number;
+}>;
+//# sourceMappingURL=insights-index.d.ts.map

package/dist/palace/insights-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights-index.d.ts","sourceRoot":"","sources":["../../src/palace/insights-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAMD,wBAAgB,iBAAiB,IAAI,aAAa,CAUjD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAK7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,iBAAiB,GAAG,gBAAgB,CAAC,GAAG,cAAc,CAmC5H;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,KAAK,CAAC,cAAc,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA8BhH"}

package/dist/palace/insights-index.js

@@ -0,0 +1,101 @@
+/**
+ * Cross-project insights index.
+ *
+ * A single JSON file mapping insights to situations.
+ * When an agent starts a task, it can query: "what insights apply here?"
+ * The system matches the current context against `applies_when` keywords.
+ *
+ * Global scope: ~/.agent-recall/insights-index.json
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { JOURNAL_ROOT } from "../types.js";
+import { ensureDir } from "../storage/fs-utils.js";
+function indexPath() {
+    return path.join(JOURNAL_ROOT, "insights-index.json");
+}
+export function readInsightsIndex() {
+    const p = indexPath();
+    if (!fs.existsSync(p)) {
+        return { version: "1.0.0", updated: new Date().toISOString(), insights: [] };
+    }
+    try {
+        return JSON.parse(fs.readFileSync(p, "utf-8"));
+    }
+    catch {
+        return { version: "1.0.0", updated: new Date().toISOString(), insights: [] };
+    }
+}
+export function writeInsightsIndex(index) {
+    const p = indexPath();
+    ensureDir(path.dirname(p));
+    index.updated = new Date().toISOString();
+    fs.writeFileSync(p, JSON.stringify(index, null, 2), "utf-8");
+}
+/**
+ * Add or update an insight in the index.
+ */
+export function addIndexedInsight(insight) {
+    const index = readInsightsIndex();
+    const now = new Date().toISOString();
+    // Check for existing by title similarity
+    const existing = index.insights.find((i) => {
+        const existingWords = i.title.toLowerCase().split(/\s+/);
+        const newWords = insight.title.toLowerCase().split(/\s+/);
+        const overlap = newWords.filter((w) => existingWords.includes(w) && w.length > 3).length;
+        return overlap / Math.max(existingWords.length, newWords.length) > 0.5;
+    });
+    if (existing) {
+        existing.confirmed_count++;
+        existing.last_confirmed = now;
+        // Merge applies_when
+        for (const aw of insight.applies_when) {
+            if (!existing.applies_when.includes(aw)) {
+                existing.applies_when.push(aw);
+            }
+        }
+        writeInsightsIndex(index);
+        return existing;
+    }
+    const newInsight = {
+        id: `idx-${Date.now()}`,
+        ...insight,
+        confirmed_count: 1,
+        last_confirmed: now,
+    };
+    index.insights.push(newInsight);
+    writeInsightsIndex(index);
+    return newInsight;
+}
+/**
+ * Recall insights relevant to a given context.
+ * Matches context words against applies_when keywords.
+ * Returns top N matches sorted by relevance (keyword match count × severity weight × confirmation count).
+ */
+export function recallInsights(context, limit = 5) {
+    const index = readInsightsIndex();
+    if (index.insights.length === 0)
+        return [];
+    const contextWords = context.toLowerCase().split(/\s+/).filter((w) => w.length > 2);
+    const severityWeight = { critical: 3, important: 2, minor: 1 };
+    const scored = index.insights.map((insight) => {
+        let matchCount = 0;
+        for (const keyword of insight.applies_when) {
+            const kwWords = keyword.toLowerCase().split(/\s+/);
+            for (const kw of kwWords) {
+                if (contextWords.some((cw) => cw.includes(kw) || kw.includes(cw))) {
+                    matchCount++;
+                }
+            }
+        }
+        const relevance = matchCount *
+            (severityWeight[insight.severity] || 1) *
+            Math.log2(insight.confirmed_count + 1);
+        return { ...insight, relevance };
+    });
+    return scored
+        .filter((s) => s.relevance > 0)
+        .sort((a, b) => b.relevance - a.relevance)
+        .slice(0, limit);
+}
+//# sourceMappingURL=insights-index.js.map

package/dist/palace/insights-index.js.map

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

package/dist/palace/log.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Palace operation log — parseable audit trail.
+ * Inspired by llm_wiki's wiki/log.md pattern.
+ *
+ * Every palace operation (write, consolidate, lint, archive) is logged
+ * in a structured, grep-friendly format.
+ */
+export declare function appendToLog(project: string, operation: string, details: Record<string, unknown>): void;
+//# sourceMappingURL=log.d.ts.map

package/dist/palace/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/palace/log.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,IAAI,CAiBN"}

package/dist/palace/log.js

@@ -0,0 +1,28 @@
+/**
+ * Palace operation log — parseable audit trail.
+ * Inspired by llm_wiki's wiki/log.md pattern.
+ *
+ * Every palace operation (write, consolidate, lint, archive) is logged
+ * in a structured, grep-friendly format.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { palaceDir } from "../storage/paths.js";
+import { ensureDir } from "../storage/fs-utils.js";
+export function appendToLog(project, operation, details) {
+    const pd = palaceDir(project);
+    ensureDir(pd);
+    const logPath = path.join(pd, "log.md");
+    const timestamp = new Date().toISOString();
+    const detailStr = Object.entries(details)
+        .map(([k, v]) => `${k}=${JSON.stringify(v)}`)
+        .join(" ");
+    const line = `[${timestamp}] ${operation}: ${detailStr}\n`;
+    if (!fs.existsSync(logPath)) {
+        fs.writeFileSync(logPath, `# Palace Operation Log\n\n${line}`, "utf-8");
+    }
+    else {
+        fs.appendFileSync(logPath, line, "utf-8");
+    }
+}
+//# sourceMappingURL=log.js.map

package/dist/palace/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/palace/log.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,SAAiB,EACjB,OAAgC;IAEhC,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,CAAC,CAAC;IACd,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAExC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5C,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,MAAM,IAAI,GAAG,IAAI,SAAS,KAAK,SAAS,KAAK,SAAS,IAAI,CAAC;IAE3D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,6BAA6B,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC"}

package/dist/palace/obsidian.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Obsidian-compatible markdown formatting.
+ * Generates YAML frontmatter and [[wikilinks]] for every palace file.
+ */
+import type { RoomMeta } from "../types.js";
+export declare function generateFrontmatter(meta: Record<string, unknown>): string;
+export declare function roomReadmeContent(meta: RoomMeta): string;
+/** Extract [[wikilinks]] from markdown content. */
+export declare function extractWikilinks(content: string): string[];
+/** Insert a back-reference section into a README if not already present. */
+export declare function addBackReference(content: string, fromRoom: string, fromTopic: string): string;
+//# sourceMappingURL=obsidian.d.ts.map

package/dist/palace/obsidian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian.d.ts","sourceRoot":"","sources":["../../src/palace/obsidian.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAczE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CA0BxD;AAED,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAU1D;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CAmBR"}

package/dist/palace/obsidian.js

@@ -0,0 +1,76 @@
+/**
+ * Obsidian-compatible markdown formatting.
+ * Generates YAML frontmatter and [[wikilinks]] for every palace file.
+ */
+export function generateFrontmatter(meta) {
+    const lines = ["---"];
+    for (const [key, value] of Object.entries(meta)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            lines.push(`${key}: [${value.map((v) => JSON.stringify(v)).join(", ")}]`);
+        }
+        else if (typeof value === "object") {
+            lines.push(`${key}: ${JSON.stringify(value)}`);
+        }
+        else {
+            lines.push(`${key}: ${value}`);
+        }
+    }
+    lines.push("---", "");
+    return lines.join("\n");
+}
+export function roomReadmeContent(meta) {
+    const fm = generateFrontmatter({
+        aliases: [meta.slug],
+        tags: meta.tags,
+        salience: meta.salience,
+        created: meta.created,
+        updated: meta.updated,
+        connections: meta.connections,
+    });
+    let md = fm;
+    md += `# ${meta.name}\n\n`;
+    md += `> ${meta.description}\n\n`;
+    if (meta.connections.length > 0) {
+        md += `## Connected Rooms\n\n`;
+        for (const conn of meta.connections) {
+            md += `- [[${conn}/README|${conn}]]\n`;
+        }
+        md += "\n";
+    }
+    md += `## Memories\n\n`;
+    md += `_(entries will appear below as the agent writes to this room)_\n`;
+    return md;
+}
+/** Extract [[wikilinks]] from markdown content. */
+export function extractWikilinks(content) {
+    const matches = content.matchAll(/\[\[([^\]|]+?)(?:\|[^\]]*?)?\]\]/g);
+    const links = [];
+    for (const m of matches) {
+        const target = m[1].replace(/\/README$/, "").trim();
+        if (target && !links.includes(target)) {
+            links.push(target);
+        }
+    }
+    return links;
+}
+/** Insert a back-reference section into a README if not already present. */
+export function addBackReference(content, fromRoom, fromTopic) {
+    const refLine = `- [[${fromRoom}/${fromTopic}|${fromRoom}/${fromTopic}]]`;
+    // Check if section exists
+    const sectionHeader = "## Referenced By";
+    if (content.includes(sectionHeader)) {
+        if (content.includes(refLine))
+            return content; // already referenced
+        const idx = content.indexOf(sectionHeader);
+        const insertPos = idx + sectionHeader.length;
+        return (content.slice(0, insertPos) +
+            "\n\n" +
+            refLine +
+            content.slice(insertPos));
+    }
+    // Add section at end
+    return content.trimEnd() + `\n\n${sectionHeader}\n\n${refLine}\n`;
+}
+//# sourceMappingURL=obsidian.js.map

package/dist/palace/obsidian.js.map

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

package/dist/palace/rooms.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Palace room management — create, list, read, update rooms.
+ */
+import type { RoomMeta } from "../types.js";
+export declare function createRoom(project: string, slug: string, name: string, description: string, tags?: string[], connections?: string[]): RoomMeta;
+export declare function getRoomMeta(project: string, roomSlug: string): RoomMeta | null;
+export declare function updateRoomMeta(project: string, roomSlug: string, updates: Partial<RoomMeta>): RoomMeta | null;
+export declare function listRooms(project: string): RoomMeta[];
+export declare function roomExists(project: string, roomSlug: string): boolean;
+/** Initialize default palace rooms if palace doesn't exist yet. */
+export declare function ensurePalaceInitialized(project: string): void;
+/** Record an access (bump access_count and last_accessed). */
+export declare function recordAccess(project: string, roomSlug: string): void;
+//# sourceMappingURL=rooms.d.ts.map

package/dist/palace/rooms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rooms.d.ts","sourceRoot":"","sources":["../../src/palace/rooms.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAW5C,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,MAAM,EAAO,EACnB,WAAW,GAAE,MAAM,EAAO,GACzB,QAAQ,CA4BV;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAG9E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,IAAI,CAS7G;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CAiBrD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrE;AAED,mEAAmE;AACnE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAyC7D;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOpE"}