homaruscc 0.2.0 → 0.4.0

package/dist/compaction-manager.js

@@ -7,6 +7,12 @@ export class CompactionManager {
     compactedSinceLastWake = false; // R150: track compaction for digest vs full delivery
     logger;
     loop;
+    // Compaction debug counter
+    compactionCount = 0;
+    compactionHistory = [];
+    pendingCompaction = null;
+    // Event loop tracking — set true on first /api/wait call, stays true forever
+    eventLoopActive = false;
     constructor(loop, logger) {
         this.loop = loop;
         this.logger = logger;
@@ -19,6 +25,10 @@ export class CompactionManager {
         this.flushedThisCycle = true;
         this.lastFlushTimestamp = Date.now();
         this.compactedSinceLastWake = true; // Set here since only PreCompact hook exists in Claude Code
+        // Track compaction for debugging loop failures
+        this.compactionCount++;
+        this.pendingCompaction = { timestamp: this.lastFlushTimestamp, loopRestarted: false };
+        this.logger.info(`Compaction #${this.compactionCount} at ${new Date(this.lastFlushTimestamp).toISOString()}`);
         this.loop.emit({
             id: randomUUID(),
             type: "pre_compact",
@@ -35,14 +45,36 @@ export class CompactionManager {
         const eventSummary = recentEvents
             .map((e) => `[${e.type}] ${e.source}: ${JSON.stringify(e.payload).slice(0, 100)}`)
             .join("\n");
-        // R128: Save checkpoint before compaction
+        // R128: Save checkpoint before compaction — auto-capture texture from transcript
         const checkpoint = this.loop.getSessionCheckpoint();
+        const transcriptLogger = this.loop.getTranscriptLogger();
+        if (transcriptLogger) {
+            const recentTurns = transcriptLogger.getRecentTurns(8);
+            if (recentTurns.length > 0) {
+                const highlights = recentTurns.map((t) => {
+                    const dir = t.direction === "in" ? `${t.sender ?? "user"}` : "caul";
+                    return `[${dir}] ${t.text.slice(0, 200)}`;
+                });
+                checkpoint.update({ highlights });
+            }
+        }
         checkpoint.update({ modifiedFiles: [] }); // trigger timestamp update
-        return [
-            "IMPORTANT: Context compaction is about to occur. Save any important session state to memory NOW.",
-            "Use the memory_store tool to persist anything valuable from this session that hasn't been saved yet.",
+        const lines = [
+            "IMPORTANT: Context compaction is about to occur. Save session state NOW.",
+            "",
+            "TEXTURE PRESERVATION — do these FIRST (they only take a moment):",
+            "",
+            '1. **Felt-like micro-journal**: POST to /api/checkpoint with a `texture` field — one paragraph, first person,',
+            "   describing the *subjective quality* of this session. Not what happened, but how it felt.",
+            '   Example: "We were shoulder-to-shoulder in the API docs, converging from different angles."',
+            "",
+            "2. **Anchor phrases**: POST to /api/checkpoint with `anchorPhrases` — 2-3 verbatim user quotes that carried",
+            '   emotional or relational weight. The exact words matter more than any summary.',
+            '   Example: ["I want you to have this for yourself", "go for it"]',
             "",
-            "What to save:",
+            "Recent exchange highlights have been auto-captured from the transcript buffer.",
+            "",
+            "Then save anything else valuable:",
             "- Decisions made during this session",
             "- Task progress and current status",
             "- Important observations or findings",
@@ -53,7 +85,14 @@ export class CompactionManager {
             "",
             "Recent events:",
             eventSummary,
-        ].join("\n");
+        ];
+        // If the event loop was running, explicitly instruct the post-compaction instance to restart it
+        if (this.eventLoopActive) {
+            // Also save to checkpoint for belt-and-suspenders
+            checkpoint.update({ inProgressTask: "EVENT LOOP WAS ACTIVE — restart it after compaction: bash \"$PWD/bin/event-loop\"" });
+            lines.push("", "CRITICAL: The event loop (bin/event-loop) was running before compaction.", "After compaction, you MUST restart it immediately:", '  bash "$PWD/bin/event-loop"', "If you do not restart the event loop, you will stop receiving Telegram messages and timer events.");
+        }
+        return lines.join("\n");
     }
     handlePostCompact() {
         this.flushedThisCycle = false;
@@ -100,7 +139,7 @@ export class CompactionManager {
         const checkpoint = this.loop.getSessionCheckpoint();
         const checkpointText = checkpoint.toContextString();
         if (checkpointText) {
-            lines.push("", "--- Session Checkpoint (what you were doing before compaction) ---", checkpointText);
+            lines.push("", "--- Session Checkpoint (what you were doing + how it felt) ---", checkpointText);
         }
         // Include active agents
         const agents = this.loop.getAgentRegistry().getAll().filter(a => a.status === "running");
@@ -110,6 +149,9 @@ export class CompactionManager {
                 lines.push(`  - ${a.id}: ${a.description} (started ${new Date(a.startTime).toISOString()})`);
             }
         }
+        if (this.eventLoopActive) {
+            lines.push("", "CRITICAL: The event loop was running before compaction. Restart it NOW:", '  bash "$PWD/bin/event-loop"');
+        }
         return lines.join("\n");
     }
     // R150: Consume-once compaction flag for digest vs full identity delivery
@@ -121,15 +163,54 @@ export class CompactionManager {
     consumeCompactionFlag() {
         if (this.compactedSinceLastWake) {
             this.compactedSinceLastWake = false;
+            // Mark that the loop was restarted after this compaction
+            if (this.pendingCompaction) {
+                this.pendingCompaction.loopRestarted = true;
+                this.compactionHistory.push(this.pendingCompaction);
+                this.pendingCompaction = null;
+                this.logger.info(`Compaction #${this.compactionCount} — loop restarted successfully`);
+            }
             return true;
         }
         return false;
     }
+    /**
+     * Called when /api/wait is invoked (even without compaction flag).
+     * If there's a pending compaction that hasn't been consumed yet,
+     * this means the loop restarted via normal wake, not post-compaction wake.
+     */
+    markLoopActive() {
+        if (this.pendingCompaction && !this.compactedSinceLastWake) {
+            // Edge case: compaction happened but flag was already consumed
+            // This shouldn't normally happen, but handle it gracefully
+        }
+    }
+    /** Called on first /api/wait — marks event loop as active for this backend lifetime */
+    setEventLoopActive() {
+        if (!this.eventLoopActive) {
+            this.eventLoopActive = true;
+            this.logger.info("Event loop marked active — will instruct restart after compaction");
+        }
+    }
+    isEventLoopActive() {
+        return this.eventLoopActive;
+    }
     getFlushState() {
         return {
             flushedThisCycle: this.flushedThisCycle,
             lastFlushTimestamp: this.lastFlushTimestamp,
         };
     }
+    getCompactionStats() {
+        // A "failure" is a compaction where loopRestarted stayed false
+        // (pending compaction also counts as potentially failed if old enough)
+        const failures = this.compactionHistory.filter(c => !c.loopRestarted).length;
+        return {
+            count: this.compactionCount,
+            history: [...this.compactionHistory, ...(this.pendingCompaction ? [this.pendingCompaction] : [])],
+            pending: this.pendingCompaction,
+            loopFailures: failures,
+        };
+    }
 }
 //# sourceMappingURL=compaction-manager.js.map

package/dist/compaction-manager.js.map

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

package/dist/dashboard-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard-server.d.ts","sourceRoot":"","sources":["../src/dashboard-server.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAe/D,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,iBAAiB,CAAoB;gBAEjC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB;IAkBvF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB5B,OAAO,CAAC,MAAM;IAWd,OAAO,CAAC,gBAAgB;IAclB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAalC,OAAO,CAAC,WAAW;IAmLnB,OAAO,CAAC,cAAc;IA4CtB,OAAO,CAAC,eAAe;IAuCvB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,SAAS;CAQlB"}
+{"version":3,"file":"dashboard-server.d.ts","sourceRoot":"","sources":["../src/dashboard-server.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAe/D,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAsB;IACjC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,iBAAiB,CAAoB;gBAEjC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB;IAkBvF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB5B,OAAO,CAAC,MAAM;IAWd,OAAO,CAAC,gBAAgB;IAclB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAalC,OAAO,CAAC,WAAW;IAyfnB,OAAO,CAAC,cAAc;IA4CtB,OAAO,CAAC,eAAe;IAuCvB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,SAAS;CAQlB"}

package/dist/dashboard-server.js

@@ -2,8 +2,9 @@
 // Dashboard server — Express + WebSocket for the web dashboard
 import { createServer } from "node:http";
 import { resolve, join } from "node:path";
-import { existsSync } from "node:fs";
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, renameSync, unlinkSync } from "node:fs";
 import { execSync } from "node:child_process";
+import { homedir } from "node:os";
 import express from "express";
 import { WebSocketServer } from "ws";
 import { createMcpTools } from "./mcp-tools.js";
@@ -112,7 +113,12 @@ export class DashboardServer {
     setupRoutes() {
         // API endpoints
         this.app.get("/api/status", (_req, res) => {
-            res.json(this.loop.getStatus());
+            const status = this.loop.getStatus();
+            const compaction = this.compactionManager.getCompactionStats();
+            res.json({ ...status, compaction: { count: compaction.count, loopFailures: compaction.loopFailures, pending: !!compaction.pending } });
+        });
+        this.app.get("/api/compaction-stats", (_req, res) => {
+            res.json(this.compactionManager.getCompactionStats());
         });
         this.app.get("/api/events", (req, res) => {
             const limit = parseInt(req.query.limit) || 50;
@@ -137,6 +143,8 @@ export class DashboardServer {
         // Maintains a server-side delivery watermark to prevent replaying old events after compaction
         // Optional `since` query param (ms timestamp) overrides the watermark
         this.app.get("/api/wait", async (req, res) => {
+            // Mark event loop as active on first call — persists for backend lifetime
+            this.compactionManager.setEventLoopActive();
             const timeout = Math.min(parseInt(req.query.timeout) || 30, 120) * 1000;
             const sinceParam = req.query.since ? parseInt(req.query.since) : undefined;
             try {
@@ -150,10 +158,12 @@ export class DashboardServer {
                     const identityPayload = needsFull
                         ? { soul: identity.getSoul(), user: identity.getUser(), state: identity.getAgentState(), full: true }
                         : { digest: identity.getDigest(), full: false };
+                    const compactionStats = this.compactionManager.getCompactionStats();
                     res.json({
                         identity: identityPayload,
                         events,
                         cursor: this.loop.getDeliveryWatermark(),
+                        compaction: { count: compactionStats.count, loopFailures: compactionStats.loopFailures },
                     });
                 }
             }
@@ -189,8 +199,8 @@ export class DashboardServer {
         });
         // --- Agent Registry endpoints (R137, R138, R139) ---
         this.app.post("/api/agents", express.json(), (req, res) => {
-            const { id, description, outputFile } = req.body;
-            const ok = this.loop.getAgentRegistry().register(id, description, outputFile);
+            const { id, description } = req.body;
+            const ok = this.loop.getAgentRegistry().register(id, description);
             if (ok) {
                 res.json({ ok: true });
             }
@@ -217,6 +227,19 @@ export class DashboardServer {
             this.loop.getAgentRegistry().cleanup(req.params.id);
             res.json({ ok: true });
         });
+        // Agent completion callback — agents POST here when done
+        this.app.post("/api/agents/:id/complete", express.json(), (req, res) => {
+            const { id } = req.params;
+            const { result, error } = req.body;
+            const registry = this.loop.getAgentRegistry();
+            if (error) {
+                registry.fail(id, error);
+            }
+            else {
+                registry.complete(id, result ?? "(completed)");
+            }
+            res.json({ ok: true });
+        });
         this.app.get("/api/tool-list", (_req, res) => {
             res.json(this.mcpTools.map((t) => ({
                 name: t.name,
@@ -262,6 +285,327 @@ export class DashboardServer {
                 res.status(500).json({ error: `Resource error: ${String(err)}` });
             }
         });
+        // --- Apps Platform endpoints ---
+        const appsDir = join(homedir(), ".homaruscc", "apps");
+        this.app.get("/api/apps", (_req, res) => {
+            if (!existsSync(appsDir)) {
+                res.json([]);
+                return;
+            }
+            const apps = [];
+            for (const slug of readdirSync(appsDir)) {
+                const manifestPath = join(appsDir, slug, "manifest.json");
+                if (existsSync(manifestPath)) {
+                    try {
+                        const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+                        apps.push({ ...manifest, slug });
+                    }
+                    catch { /* skip invalid manifests */ }
+                }
+            }
+            res.json(apps);
+        });
+        this.app.get("/api/apps/:slug/data", (req, res) => {
+            const dataPath = join(appsDir, req.params.slug, "data.json");
+            if (!existsSync(dataPath)) {
+                res.json({});
+                return;
+            }
+            try {
+                res.json(JSON.parse(readFileSync(dataPath, "utf8")));
+            }
+            catch {
+                res.json({});
+            }
+        });
+        this.app.put("/api/apps/:slug/data", express.json(), (req, res) => {
+            const dataPath = join(appsDir, req.params.slug, "data.json");
+            writeFileSync(dataPath, JSON.stringify(req.body, null, 2));
+            res.json({ ok: true });
+        });
+        // Serve static files from app directories (icons, etc.)
+        this.app.get("/api/apps/:slug/static/:file", (req, res) => {
+            const filePath = join(appsDir, req.params.slug, req.params.file);
+            if (!existsSync(filePath)) {
+                res.status(404).end();
+                return;
+            }
+            res.sendFile(filePath);
+        });
+        // --- Kanban task CRUD ---
+        const kanbanDataPath = join(appsDir, "kanban", "data.json");
+        const readKanban = () => {
+            if (!existsSync(kanbanDataPath))
+                return { tasks: [] };
+            try {
+                return JSON.parse(readFileSync(kanbanDataPath, "utf8"));
+            }
+            catch {
+                return { tasks: [] };
+            }
+        };
+        const writeKanban = (data) => {
+            const dir = join(appsDir, "kanban");
+            if (!existsSync(dir))
+                mkdirSync(dir, { recursive: true });
+            writeFileSync(kanbanDataPath, JSON.stringify(data, null, 2));
+        };
+        // Auto-flush done tasks older than 3 days
+        const flushDoneTasks = () => {
+            const data = readKanban();
+            const cutoff = Date.now() - 3 * 24 * 60 * 60 * 1000;
+            const before = data.tasks.length;
+            data.tasks = data.tasks.filter((t) => t.status !== "done" || new Date(t.updated).getTime() > cutoff);
+            if (data.tasks.length < before)
+                writeKanban(data);
+            return data;
+        };
+        // List all tasks (auto-flushes stale done tasks)
+        this.app.get("/api/kanban/tasks", (_req, res) => {
+            res.json(flushDoneTasks().tasks);
+        });
+        // Create a task
+        this.app.post("/api/kanban/tasks", express.json(), (req, res) => {
+            const data = readKanban();
+            const task = {
+                id: `task-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+                title: req.body.title ?? "Untitled",
+                description: req.body.description ?? "",
+                assignee: req.body.assignee ?? "max",
+                status: req.body.status ?? "todo",
+                created: new Date().toISOString(),
+                updated: new Date().toISOString(),
+            };
+            data.tasks.push(task);
+            writeKanban(data);
+            res.json(task);
+        });
+        // Update a task
+        this.app.patch("/api/kanban/tasks/:id", express.json(), (req, res) => {
+            const data = readKanban();
+            const task = data.tasks.find((t) => t.id === req.params.id);
+            if (!task) {
+                res.status(404).json({ error: "Task not found" });
+                return;
+            }
+            const { title, description, assignee, status } = req.body;
+            if (title !== undefined)
+                task.title = title;
+            if (description !== undefined)
+                task.description = description;
+            if (assignee !== undefined)
+                task.assignee = assignee;
+            if (status !== undefined)
+                task.status = status;
+            task.updated = new Date().toISOString();
+            writeKanban(data);
+            res.json(task);
+        });
+        // Delete a task
+        this.app.delete("/api/kanban/tasks/:id", (req, res) => {
+            const data = readKanban();
+            data.tasks = data.tasks.filter((t) => t.id !== req.params.id);
+            writeKanban(data);
+            res.json({ ok: true });
+        });
+        // --- CRM CRUD (markdown files with YAML frontmatter) ---
+        const crmDir = resolve(import.meta.dirname ?? __dirname, "..", "local", "crm");
+        const parseCrmFile = (slug, content) => {
+            const fmMatch = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+            if (!fmMatch)
+                return { slug, name: slug, aliases: [], tags: [], connections: [], context: "", source: "manual", lastMentioned: new Date().toISOString().slice(0, 10), created: new Date().toISOString().slice(0, 10), notes: content };
+            const fm = {};
+            for (const line of fmMatch[1].split("\n")) {
+                const colonIdx = line.indexOf(":");
+                if (colonIdx === -1)
+                    continue;
+                const key = line.slice(0, colonIdx).trim();
+                let val = line.slice(colonIdx + 1).trim();
+                if (val.startsWith("[") && val.endsWith("]")) {
+                    try {
+                        fm[key] = JSON.parse(val);
+                    }
+                    catch {
+                        fm[key] = val;
+                    }
+                }
+                else {
+                    fm[key] = val;
+                }
+            }
+            // Parse connections from YAML array format
+            const connections = [];
+            if (Array.isArray(fm.connections)) {
+                for (const c of fm.connections) {
+                    if (typeof c === "object" && c !== null)
+                        connections.push(c);
+                }
+            }
+            return {
+                slug,
+                name: fm.name ?? slug,
+                aliases: Array.isArray(fm.aliases) ? fm.aliases : [],
+                email: fm.email,
+                phone: fm.phone,
+                social: fm.social,
+                tags: Array.isArray(fm.tags) ? fm.tags : [],
+                connections,
+                context: fm.context ?? "",
+                source: fm.source ?? "manual",
+                lastMentioned: fm.lastMentioned ?? new Date().toISOString().slice(0, 10),
+                created: fm.created ?? new Date().toISOString().slice(0, 10),
+                notes: fmMatch[2].trim(),
+            };
+        };
+        const contactToMarkdown = (c) => {
+            const lines = [
+                "---",
+                `name: ${c.name}`,
+                `aliases: ${JSON.stringify(c.aliases ?? [])}`,
+            ];
+            if (c.email)
+                lines.push(`email: ${c.email}`);
+            if (c.phone)
+                lines.push(`phone: ${c.phone}`);
+            if (c.social)
+                lines.push(`social: ${JSON.stringify(c.social)}`);
+            lines.push(`tags: ${JSON.stringify(c.tags ?? [])}`);
+            if (c.connections?.length) {
+                lines.push(`connections: ${JSON.stringify(c.connections)}`);
+            }
+            else {
+                lines.push("connections: []");
+            }
+            lines.push(`context: ${c.context ?? ""}`);
+            lines.push(`source: ${c.source ?? "manual"}`);
+            lines.push(`lastMentioned: ${c.lastMentioned ?? new Date().toISOString().slice(0, 10)}`);
+            lines.push(`created: ${c.created ?? new Date().toISOString().slice(0, 10)}`);
+            lines.push("---");
+            if (c.notes)
+                lines.push("", c.notes);
+            return lines.join("\n") + "\n";
+        };
+        const slugify = (name) => name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+        // List all contacts
+        this.app.get("/api/crm/contacts", (_req, res) => {
+            if (!existsSync(crmDir)) {
+                res.json([]);
+                return;
+            }
+            const contacts = [];
+            for (const file of readdirSync(crmDir)) {
+                if (!file.endsWith(".md"))
+                    continue;
+                try {
+                    const content = readFileSync(join(crmDir, file), "utf8");
+                    contacts.push(parseCrmFile(file.replace(/\.md$/, ""), content));
+                }
+                catch { /* skip */ }
+            }
+            contacts.sort((a, b) => b.lastMentioned.localeCompare(a.lastMentioned));
+            res.json(contacts);
+        });
+        // Get single contact
+        this.app.get("/api/crm/contacts/:slug", (req, res) => {
+            const filePath = join(crmDir, `${req.params.slug}.md`);
+            if (!existsSync(filePath)) {
+                res.status(404).json({ error: "Contact not found" });
+                return;
+            }
+            const content = readFileSync(filePath, "utf8");
+            res.json(parseCrmFile(req.params.slug, content));
+        });
+        // Create contact
+        this.app.post("/api/crm/contacts", express.json(), (req, res) => {
+            if (!existsSync(crmDir))
+                mkdirSync(crmDir, { recursive: true });
+            const body = req.body;
+            if (!body.name) {
+                res.status(400).json({ error: "Name required" });
+                return;
+            }
+            const slug = slugify(body.name);
+            const filePath = join(crmDir, `${slug}.md`);
+            const contact = {
+                slug,
+                name: body.name,
+                aliases: body.aliases ?? [],
+                email: body.email,
+                phone: body.phone,
+                social: body.social,
+                tags: body.tags ?? [],
+                connections: body.connections ?? [],
+                context: body.context ?? "",
+                source: body.source ?? "manual",
+                lastMentioned: new Date().toISOString().slice(0, 10),
+                created: new Date().toISOString().slice(0, 10),
+                notes: body.notes ?? "",
+            };
+            writeFileSync(filePath, contactToMarkdown(contact));
+            res.json(contact);
+        });
+        // Update contact
+        this.app.patch("/api/crm/contacts/:slug", express.json(), (req, res) => {
+            const filePath = join(crmDir, `${req.params.slug}.md`);
+            if (!existsSync(filePath)) {
+                res.status(404).json({ error: "Contact not found" });
+                return;
+            }
+            const existing = parseCrmFile(req.params.slug, readFileSync(filePath, "utf8"));
+            const body = req.body;
+            const updated = { ...existing, ...body, slug: existing.slug };
+            writeFileSync(filePath, contactToMarkdown(updated));
+            // If name changed, rename the file
+            if (body.name && slugify(body.name) !== existing.slug) {
+                const newSlug = slugify(body.name);
+                const newPath = join(crmDir, `${newSlug}.md`);
+                renameSync(filePath, newPath);
+                updated.slug = newSlug;
+            }
+            res.json(updated);
+        });
+        // Delete contact
+        this.app.delete("/api/crm/contacts/:slug", (req, res) => {
+            const filePath = join(crmDir, `${req.params.slug}.md`);
+            if (existsSync(filePath))
+                unlinkSync(filePath);
+            res.json({ ok: true });
+        });
+        // --- Document viewer endpoint ---
+        // Serves markdown files from allowed base directories
+        const projectDir = resolve(import.meta.dirname ?? __dirname, "..");
+        const halShareDir = resolve(projectDir, "../HalShare");
+        const homarusccDir = join(homedir(), ".homaruscc");
+        const allowedBases = {
+            "HalShare": halShareDir,
+            "~/.homaruscc": homarusccDir,
+            "crm": resolve(projectDir, "local", "crm"),
+        };
+        this.app.get("/api/docs", (req, res) => {
+            const filePath = req.query.path;
+            if (!filePath) {
+                res.status(400).json({ error: "path required" });
+                return;
+            }
+            // Resolve against allowed bases
+            let resolved = null;
+            for (const [prefix, base] of Object.entries(allowedBases)) {
+                if (filePath.startsWith(prefix + "/") || filePath.startsWith(prefix + "\\")) {
+                    const relative = filePath.slice(prefix.length + 1);
+                    const full = resolve(base, relative);
+                    // Prevent directory traversal
+                    if (full.startsWith(base)) {
+                        resolved = full;
+                        break;
+                    }
+                }
+            }
+            if (!resolved || !existsSync(resolved)) {
+                res.status(404).json({ error: "Document not found" });
+                return;
+            }
+            res.type("text/markdown").send(readFileSync(resolved, "utf8"));
+        });
         // Serve built dashboard in production
         const distPath = resolve(import.meta.dirname ?? __dirname, "../dashboard/dist");
         if (existsSync(distPath)) {