agent-recall-core 3.3.4

package/dist/palace/awareness.js

@@ -0,0 +1,231 @@
+/**
+ * Awareness system — a living 200-line document that compounds insights.
+ *
+ * Unlike the palace (room-based storage) or journal (temporal log),
+ * awareness.md is a SELF-REWRITING document. Every update forces the
+ * system to merge, compress, or demote — creating compounding knowledge.
+ *
+ * Structure:
+ *   ## Identity (5 lines)         — who is the user, what matters
+ *   ## Top Insights (10 items)    — ranked by relevance + confirmation count
+ *   ## Compound Insights (5 max)  — patterns spanning 3+ individual insights
+ *   ## Trajectory (3 lines)       — where is the work heading
+ *   ## Blind Spots (3 lines)      — what the system suspects matters but hasn't confirmed
+ *
+ * Max 200 lines enforced. Overflow triggers merge/demote.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getRoot } from "../types.js";
+import { ensureDir } from "../storage/fs-utils.js";
+const MAX_LINES = 200;
+function awarenessPath() {
+    return path.join(getRoot(), "awareness.md");
+}
+export function readAwareness() {
+    const p = awarenessPath();
+    if (!fs.existsSync(p))
+        return "";
+    return fs.readFileSync(p, "utf-8");
+}
+export function writeAwareness(content) {
+    const p = awarenessPath();
+    ensureDir(path.dirname(p));
+    // Enforce 200-line max
+    const lines = content.split("\n");
+    if (lines.length > MAX_LINES) {
+        const truncated = lines.slice(0, MAX_LINES).join("\n");
+        fs.writeFileSync(p, truncated + "\n", "utf-8");
+    }
+    else {
+        fs.writeFileSync(p, content, "utf-8");
+    }
+}
+const AWARENESS_JSON_PATH = () => path.join(getRoot(), "awareness-state.json");
+export function readAwarenessState() {
+    const p = AWARENESS_JSON_PATH();
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(p, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function writeAwarenessState(state) {
+    const p = AWARENESS_JSON_PATH();
+    ensureDir(path.dirname(p));
+    fs.writeFileSync(p, JSON.stringify(state, null, 2), "utf-8");
+}
+/**
+ * Initialize awareness from scratch.
+ */
+export function initAwareness(identity) {
+    const state = {
+        identity,
+        topInsights: [],
+        compoundInsights: [],
+        trajectory: "",
+        blindSpots: [],
+        lastUpdated: new Date().toISOString(),
+    };
+    writeAwarenessState(state);
+    renderAwareness(state);
+    return state;
+}
+/**
+ * Add or merge an insight into the awareness state.
+ * If similar insight exists (by title keyword overlap), merge and strengthen.
+ * If new, add and demote lowest if over 10.
+ */
+export function addInsight(newInsight) {
+    let state = readAwarenessState();
+    if (!state) {
+        state = initAwareness("(unknown user)");
+    }
+    const now = new Date().toISOString();
+    const titleWords = newInsight.title.toLowerCase().split(/\s+/);
+    // Check for similar existing insight (>50% word overlap)
+    let bestMatch = null;
+    for (let i = 0; i < state.topInsights.length; i++) {
+        const existing = state.topInsights[i];
+        const existingWords = existing.title.toLowerCase().split(/\s+/);
+        const overlap = titleWords.filter((w) => existingWords.includes(w) && w.length > 3).length;
+        const ratio = overlap / Math.max(titleWords.length, existingWords.length);
+        if (ratio > 0.5 && (!bestMatch || ratio > bestMatch.overlap)) {
+            bestMatch = { idx: i, overlap: ratio };
+        }
+    }
+    if (bestMatch) {
+        // Merge: strengthen existing insight
+        const existing = state.topInsights[bestMatch.idx];
+        existing.confirmations++;
+        existing.lastConfirmed = now;
+        existing.evidence += ` | ${newInsight.evidence}`;
+        // Merge appliesWhen
+        for (const aw of newInsight.appliesWhen) {
+            if (!existing.appliesWhen.includes(aw)) {
+                existing.appliesWhen.push(aw);
+            }
+        }
+        writeAwarenessState(state);
+        renderAwareness(state);
+        return { action: "merged", insight: existing };
+    }
+    // New insight
+    const insight = {
+        id: `insight-${Date.now()}`,
+        title: newInsight.title,
+        evidence: newInsight.evidence,
+        confirmations: 1,
+        lastConfirmed: now,
+        appliesWhen: newInsight.appliesWhen,
+        source: newInsight.source,
+    };
+    if (state.topInsights.length < 10) {
+        state.topInsights.push(insight);
+        writeAwarenessState(state);
+        renderAwareness(state);
+        return { action: "added", insight };
+    }
+    // Over 10: replace lowest-confirmation insight
+    state.topInsights.sort((a, b) => b.confirmations - a.confirmations);
+    const demoted = state.topInsights.pop();
+    state.topInsights.push(insight);
+    writeAwarenessState(state);
+    renderAwareness(state);
+    return { action: "replaced", insight };
+}
+/**
+ * Detect compound insights — patterns spanning 3+ individual insights.
+ * Looks for shared appliesWhen keywords across insights.
+ */
+export function detectCompoundInsights() {
+    const state = readAwarenessState();
+    if (!state || state.topInsights.length < 3)
+        return [];
+    // Group insights by shared appliesWhen keywords
+    const keywordMap = new Map();
+    for (const insight of state.topInsights) {
+        for (const aw of insight.appliesWhen) {
+            const key = aw.toLowerCase();
+            if (!keywordMap.has(key))
+                keywordMap.set(key, []);
+            keywordMap.get(key).push(insight);
+        }
+    }
+    const compounds = [];
+    for (const [keyword, insights] of keywordMap) {
+        if (insights.length >= 3) {
+            const id = `compound-${keyword}`;
+            // Don't duplicate
+            if (state.compoundInsights.some((c) => c.id === id))
+                continue;
+            compounds.push({
+                id,
+                title: `Pattern: "${keyword}" appears across ${insights.length} insights`,
+                sourceInsights: insights.map((i) => i.id),
+                pattern: insights.map((i) => i.title).join(" + "),
+                confidence: Math.min(1.0, insights.length * 0.25),
+            });
+        }
+    }
+    if (compounds.length > 0) {
+        state.compoundInsights = [...state.compoundInsights, ...compounds].slice(0, 5);
+        writeAwarenessState(state);
+        renderAwareness(state);
+    }
+    return compounds;
+}
+/**
+ * Render awareness state into the 200-line markdown document.
+ */
+export function renderAwareness(state) {
+    const lines = [];
+    lines.push("# Awareness");
+    lines.push(`> Last updated: ${state.lastUpdated}`);
+    lines.push("");
+    // Identity
+    lines.push("## Identity");
+    lines.push(state.identity || "_(not set)_");
+    lines.push("");
+    // Top insights (sorted by confirmations)
+    lines.push("## Top Insights");
+    lines.push("");
+    const sorted = [...state.topInsights].sort((a, b) => b.confirmations - a.confirmations);
+    for (const insight of sorted) {
+        lines.push(`### ${insight.title} (${insight.confirmations}x confirmed)`);
+        lines.push(`- Evidence: ${insight.evidence.slice(0, 150)}`);
+        lines.push(`- Applies when: ${insight.appliesWhen.join(", ")}`);
+        lines.push(`- Source: ${insight.source} | Last: ${insight.lastConfirmed.slice(0, 10)}`);
+        lines.push("");
+    }
+    // Compound insights
+    if (state.compoundInsights.length > 0) {
+        lines.push("## Compound Insights");
+        lines.push("");
+        for (const ci of state.compoundInsights) {
+            lines.push(`### ${ci.title} (confidence: ${ci.confidence.toFixed(2)})`);
+            lines.push(`- Pattern: ${ci.pattern.slice(0, 200)}`);
+            lines.push(`- Sources: ${ci.sourceInsights.length} insights`);
+            lines.push("");
+        }
+    }
+    // Trajectory
+    lines.push("## Trajectory");
+    lines.push(state.trajectory || "_(not set — will emerge after 3+ sessions)_");
+    lines.push("");
+    // Blind spots
+    lines.push("## Blind Spots");
+    if (state.blindSpots.length > 0) {
+        for (const bs of state.blindSpots) {
+            lines.push(`- ${bs}`);
+        }
+    }
+    else {
+        lines.push("_(none detected yet)_");
+    }
+    writeAwareness(lines.join("\n"));
+}
+//# sourceMappingURL=awareness.js.map

package/dist/palace/awareness.js.map

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

package/dist/palace/consolidate.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Memory transformation pipeline: episodic (journal) → semantic (palace).
+ *
+ * Inspired by:
+ * - Karpathy's LLM Wiki: fan-out on ingest, query-as-deposit
+ * - llm_wiki: two-step ingest (analyze then generate), source traceability
+ * - Human memory: episodic → semantic consolidation during sleep
+ *
+ * This module extracts decisions, goals, blockers, and observations from
+ * journal entries and consolidates them into palace rooms.
+ */
+export interface ConsolidationResult {
+    entriesProcessed: number;
+    roomsUpdated: string[];
+    memoriesCreated: number;
+}
+/**
+ * Consolidate recent journal entries into palace rooms.
+ *
+ * Process:
+ * 1. Read N recent journal entries
+ * 2. Extract structured content per section type
+ * 3. Route each to the appropriate palace room
+ * 4. Add source traceability (which journal entry it came from)
+ * 5. Trigger fan-out for cross-references
+ */
+export declare function consolidateJournalToPalace(project: string, entryCount?: number): ConsolidationResult;
+//# sourceMappingURL=consolidate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consolidate.d.ts","sourceRoot":"","sources":["../../src/palace/consolidate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,MAAU,GACrB,mBAAmB,CAqHrB"}

package/dist/palace/consolidate.js

@@ -0,0 +1,129 @@
+/**
+ * Memory transformation pipeline: episodic (journal) → semantic (palace).
+ *
+ * Inspired by:
+ * - Karpathy's LLM Wiki: fan-out on ingest, query-as-deposit
+ * - llm_wiki: two-step ingest (analyze then generate), source traceability
+ * - Human memory: episodic → semantic consolidation during sleep
+ *
+ * This module extracts decisions, goals, blockers, and observations from
+ * journal entries and consolidates them into palace rooms.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { palaceDir } from "../storage/paths.js";
+import { ensureDir, todayISO } from "../storage/fs-utils.js";
+import { listJournalFiles } from "../helpers/journal-files.js";
+import { extractSection } from "../helpers/sections.js";
+import { ensurePalaceInitialized, roomExists, createRoom, updateRoomMeta } from "./rooms.js";
+import { fanOut } from "./fan-out.js";
+import { generateFrontmatter } from "./obsidian.js";
+import { updatePalaceIndex } from "./index-manager.js";
+import { appendToLog } from "./log.js";
+/**
+ * Consolidate recent journal entries into palace rooms.
+ *
+ * Process:
+ * 1. Read N recent journal entries
+ * 2. Extract structured content per section type
+ * 3. Route each to the appropriate palace room
+ * 4. Add source traceability (which journal entry it came from)
+ * 5. Trigger fan-out for cross-references
+ */
+export function consolidateJournalToPalace(project, entryCount = 5) {
+    ensurePalaceInitialized(project);
+    const entries = listJournalFiles(project);
+    const toProcess = entries.slice(0, entryCount);
+    const pd = palaceDir(project);
+    const date = todayISO();
+    const result = {
+        entriesProcessed: 0,
+        roomsUpdated: [],
+        memoriesCreated: 0,
+    };
+    const updatedRooms = new Set();
+    for (const entry of toProcess) {
+        const content = fs.readFileSync(path.join(entry.dir, entry.file), "utf-8");
+        const sourceRef = `[[journal/${entry.date}]]`;
+        // Extract and route each section type
+        const routes = [
+            { section: "decisions", room: "architecture", topic: "decisions" },
+            { section: "blockers", room: "blockers", topic: "current" },
+            { section: "next", room: "goals", topic: "active" },
+            { section: "observations", room: "knowledge", topic: "observations" },
+        ];
+        for (const route of routes) {
+            const sectionContent = extractSection(content, route.section);
+            if (!sectionContent || sectionContent.trim().length < 10)
+                continue;
+            // Ensure room exists
+            if (!roomExists(project, route.room)) {
+                const name = route.room.charAt(0).toUpperCase() + route.room.slice(1);
+                createRoom(project, route.room, name, `Consolidated from journal ${route.section}`, []);
+            }
+            const topicPath = path.join(pd, "rooms", route.room, `${route.topic}.md`);
+            ensureDir(path.dirname(topicPath));
+            // Build entry with source traceability
+            const fm = !fs.existsSync(topicPath)
+                ? generateFrontmatter({
+                    room: route.room,
+                    topic: route.topic,
+                    created: new Date().toISOString(),
+                    source: "consolidation",
+                    sources: [entry.date],
+                })
+                : "";
+            const memoryEntry = `\n### ${entry.date} ${sourceRef}\n\n${sectionContent.replace(/^## .+\n/, "").trim()}\n`;
+            if (fs.existsSync(topicPath)) {
+                // Check if this date's content is already consolidated (idempotent)
+                const existing = fs.readFileSync(topicPath, "utf-8");
+                if (existing.includes(`### ${entry.date}`))
+                    continue;
+                fs.appendFileSync(topicPath, memoryEntry, "utf-8");
+            }
+            else {
+                fs.writeFileSync(topicPath, `${fm}# ${route.room} / ${route.topic}\n${memoryEntry}`, "utf-8");
+            }
+            // Update room metadata
+            updateRoomMeta(project, route.room, {
+                updated: new Date().toISOString(),
+            });
+            updatedRooms.add(route.room);
+            result.memoriesCreated++;
+            // Fan-out with source reference
+            fanOut(project, route.room, route.topic, sectionContent, [], "medium");
+        }
+        // Extract brief → goals/evolution
+        const brief = extractSection(content, "brief");
+        if (brief && brief.trim().length > 5) {
+            const evoPath = path.join(pd, "rooms", "goals", "evolution.md");
+            ensureDir(path.dirname(evoPath));
+            const evoEntry = `\n### ${entry.date} ${sourceRef}\n\n${brief.split("\n")[0]}\n`;
+            if (fs.existsSync(evoPath)) {
+                const existing = fs.readFileSync(evoPath, "utf-8");
+                if (!existing.includes(`### ${entry.date}`)) {
+                    fs.appendFileSync(evoPath, evoEntry, "utf-8");
+                    result.memoriesCreated++;
+                }
+            }
+            else {
+                const fm = generateFrontmatter({ room: "goals", topic: "evolution", created: new Date().toISOString(), source: "consolidation" });
+                fs.writeFileSync(evoPath, `${fm}# goals / evolution\n${evoEntry}`, "utf-8");
+                result.memoriesCreated++;
+            }
+            updatedRooms.add("goals");
+        }
+        result.entriesProcessed++;
+    }
+    result.roomsUpdated = Array.from(updatedRooms);
+    // Update palace index
+    updatePalaceIndex(project);
+    // Log the operation
+    appendToLog(project, "consolidate", {
+        entries_processed: result.entriesProcessed,
+        rooms_updated: result.roomsUpdated,
+        memories_created: result.memoriesCreated,
+    });
+    return result;
+}
+//# sourceMappingURL=consolidate.js.map

package/dist/palace/consolidate.js.map

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

package/dist/palace/fan-out.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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 type { Importance } from "../types.js";
+export interface FanOutResult {
+    updatedRooms: string[];
+    newEdges: number;
+}
+export declare function fanOut(project: string, sourceRoom: string, sourceTopic: string, content: string, explicitConnections?: string[], importance?: Importance): FanOutResult;
+//# sourceMappingURL=fan-out.d.ts.map

package/dist/palace/fan-out.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fan-out.d.ts","sourceRoot":"","sources":["../../src/palace/fan-out.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,MAAM,CACpB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,mBAAmB,GAAE,MAAM,EAAO,EAClC,UAAU,GAAE,UAAqB,GAChC,YAAY,CAoEd"}

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":"AAAA;;;;;;;GAOG;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,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAQhD,MAAM,UAAU,MAAM,CACpB,OAAe,EACf,UAAkB,EAClB,WAAmB,EACnB,OAAe,EACf,sBAAgC,EAAE,EAClC,aAAyB,QAAQ;IAEjC,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAiB,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAE/D,6DAA6D;IAC7D,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,CAAC,GAAG,WAAW,EAAE,GAAG,mBAAmB,CAAC,CAAC,CAAC;IAE7E,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,iDAAiD;QACjD,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,UAAU,KAAK,UAAU;YAAE,SAAS,CAAC,uBAAuB;QAEhE,gDAAgD;QAChD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QACrE,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,MAAM,aAAa,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAC7D,MAAM,OAAO,GAAG,gBAAgB,CAAC,aAAa,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;YACzE,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;gBAC9B,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBACjD,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,OAAO,CAAC,EAAE,EAAE,GAAG,UAAU,IAAI,WAAW,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QAClE,MAAM,CAAC,QAAQ,EAAE,CAAC;QAElB,wCAAwC;QACxC,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACpD,IAAI,UAAU,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/D,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE;gBAClC,WAAW,EAAE,CAAC,GAAG,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC;aACrD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACpD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACjD,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;YAChC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,IAAI,UAAU,KAAK,UAAU;gBAAE,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC1D,CAAC;QACD,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE;YAClC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;IAED,8CAA8C;IAC9C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IACpE,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,MAAM,SAAS,GAAG,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC/C,MAAM,WAAW,GAAG,eAAe,CAAC;YAClC,UAAU;YACV,WAAW,EAAE,IAAI,CAAC,OAAO;YACzB,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,eAAe,EAAE,SAAS;SAC3B,CAAC,CAAC;QAEH,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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