jfl 0.9.6 → 0.9.8

package/packages/pi/dist/journal.js

@@ -0,0 +1,250 @@
+/**
+ * Journal Extension
+ *
+ * Detects git commits via tool_execution_end, prompts for journal entries,
+ * registers the /journal command with interactive type selection,
+ * shows themed journal stream in below-editor widget.
+ *
+ * @purpose Auto-journal detection + interactive /journal command + themed widget
+ */
+import { existsSync, readFileSync, appendFileSync, mkdirSync } from "fs";
+import { join } from "path";
+import { execSync } from "child_process";
+import { getCurrentBranch, getSessionBranch } from "./session.js";
+import { emitCustomEvent } from "./map-bridge.js";
+let projectRoot = "";
+function getJournalPath(root) {
+    // Prefer the session branch tracked by session.ts — git HEAD may differ
+    // if checkout failed due to dirty working tree
+    const branch = getSessionBranch() || getCurrentBranch(root);
+    return join(root, ".jfl", "journal", `${branch}.jsonl`);
+}
+function appendJournalEntry(root, entry) {
+    const journalPath = getJournalPath(root);
+    mkdirSync(join(root, ".jfl", "journal"), { recursive: true });
+    appendFileSync(journalPath, JSON.stringify(entry) + "\n");
+}
+function readRecentEntries(root, count = 5) {
+    const journalPath = getJournalPath(root);
+    if (!existsSync(journalPath))
+        return [];
+    try {
+        const lines = readFileSync(journalPath, "utf-8")
+            .split("\n")
+            .filter(Boolean)
+            .slice(-count);
+        return lines.map(l => JSON.parse(l));
+    }
+    catch {
+        return [];
+    }
+}
+export function hasJournalEntryForSession(root, sessionBranch) {
+    const journalPath = join(root, ".jfl", "journal", `${sessionBranch}.jsonl`);
+    if (!existsSync(journalPath))
+        return false;
+    const content = readFileSync(journalPath, "utf-8").trim();
+    return content.length > 0;
+}
+const TYPE_ICONS = {
+    feature: "✦",
+    fix: "✧",
+    decision: "◆",
+    discovery: "◇",
+    milestone: "★",
+    "session-end": "●",
+    spec: "□",
+};
+const TYPE_COLORS = {
+    feature: "success",
+    fix: "error",
+    decision: "warning",
+    discovery: "accent",
+    milestone: "warning",
+    "session-end": "dim",
+    spec: "muted",
+};
+function showRecentJournal(_ctx) {
+    // Widget removed — journal entries visible via /journal or Ctrl+Shift+J
+}
+export async function setupJournal(ctx, _config) {
+    projectRoot = ctx.session.projectRoot;
+    showRecentJournal(ctx);
+    ctx.registerCommand({
+        name: "journal",
+        description: "Write a journal entry for the current session",
+        async handler(_args, ctx) {
+            if (ctx.ui.hasUI) {
+                const types = [
+                    { value: "feature", label: "✦ Feature", description: "Something built or completed" },
+                    { value: "fix", label: "✧ Fix", description: "Bug found and fixed" },
+                    { value: "decision", label: "◆ Decision", description: "Choice made between options" },
+                    { value: "discovery", label: "◇ Discovery", description: "Insight or learning" },
+                    { value: "milestone", label: "★ Milestone", description: "Major goal reached" },
+                ];
+                const type = await ctx.ui.select("Journal Entry Type", types);
+                if (!type)
+                    return;
+                const title = await ctx.ui.input("Title", "What happened?");
+                if (!title?.trim())
+                    return;
+                const summary = await ctx.ui.input("Summary (2-3 sentences)", "Brief description");
+                const entry = {
+                    v: 1,
+                    ts: new Date().toISOString(),
+                    session: getSessionBranch() || getCurrentBranch(projectRoot),
+                    type,
+                    status: "complete",
+                    title: title.trim(),
+                    summary: summary?.trim() ?? title.trim(),
+                };
+                appendJournalEntry(projectRoot, entry);
+                await emitCustomEvent(ctx, "journal:entry", entry);
+                ctx.emit("journal:written", entry);
+                showRecentJournal(ctx);
+                ctx.ui.notify(`${TYPE_ICONS[type] ?? "·"} Journal: ${title.trim()}`, { level: "success" });
+                ctx.ui.setStatus("journal", undefined);
+                return;
+            }
+            // Fallback: raw JSON input for non-interactive mode
+            const branch = getSessionBranch() || getCurrentBranch(projectRoot);
+            const template = JSON.stringify({
+                v: 1,
+                ts: new Date().toISOString(),
+                session: branch,
+                type: "feature",
+                status: "complete",
+                title: "",
+                summary: "",
+                detail: "",
+                files: [],
+            }, null, 2);
+            const content = await ctx.ui.input("Journal Entry (paste JSON)", template);
+            if (!content?.trim())
+                return;
+            try {
+                const entry = JSON.parse(content);
+                appendJournalEntry(projectRoot, entry);
+                await emitCustomEvent(ctx, "journal:entry", entry);
+                ctx.emit("journal:written", entry);
+                showRecentJournal(ctx);
+                ctx.ui.notify("Journal entry saved", { level: "success" });
+            }
+            catch {
+                ctx.ui.notify("Invalid JSON — entry not saved. Use /journal and paste valid JSON.", { level: "warn" });
+            }
+        },
+    });
+    ctx.on("map:journal:entry", () => showRecentJournal(ctx));
+    ctx.on("journal:written", () => showRecentJournal(ctx));
+}
+export async function onToolExecutionEnd(ctx, event) {
+    const toolName = event.toolName ?? event.tool ?? "";
+    // TaskUpdate completed → journal nudge (parity with CC PostToolUse hook)
+    if (toolName === "TaskUpdate") {
+        const input = event.input ?? event.args ?? {};
+        const inputStr = typeof input === "string" ? input : JSON.stringify(input);
+        if (/"status"\s*:\s*"completed"/.test(inputStr)) {
+            const branch = getCurrentBranch(projectRoot);
+            ctx.ui.notify(`Task completed — write journal entry\nFile: .jfl/journal/${branch}.jsonl`, { level: "info" });
+        }
+        return;
+    }
+    if (toolName.toLowerCase() !== "bash")
+        return;
+    const result = String(event.result ?? "");
+    const isGitCommit = /\[[\w/.-]+\s+[0-9a-f]{7,}\]/.test(result);
+    if (!isGitCommit)
+        return;
+    let commitMsg = "";
+    let commitFiles = "";
+    try {
+        commitMsg = execSync("git log -1 --pretty=%B", { cwd: projectRoot }).toString().trim();
+        commitFiles = execSync("git diff-tree --no-commit-id --name-only -r HEAD", { cwd: projectRoot })
+            .toString().trim();
+    }
+    catch { }
+    ctx.emit("pi:git-commit-detected", { message: commitMsg, files: commitFiles });
+    ctx.ui.notify([
+        "Git commit detected — Ctrl+Shift+J for quick journal or /journal",
+        commitMsg ? `Commit: ${commitMsg.split("\n")[0]}` : "",
+        commitFiles ? `Files: ${commitFiles.split("\n").slice(0, 3).join(", ")}` : "",
+    ].filter(Boolean).join("\n"), { level: "info" });
+}
+export async function onJournalAgentEnd(_ctx, _event) {
+    // Removed: "Journal entry recommended" nudge (noisy)
+}
+/**
+ * Check @purpose header on Write/Edit to code files.
+ * Equivalent to Claude Code's PostToolUse(Write|Edit) hook.
+ */
+export function checkPurposeHeader(ctx, event) {
+    const toolName = (event.toolName ?? event.tool ?? "").toLowerCase();
+    if (toolName !== "write" && toolName !== "edit")
+        return;
+    // Extract file path from tool input
+    const input = event.input ?? event.args ?? {};
+    const filePath = typeof input === "string"
+        ? input
+        : input.path ?? input.file_path ?? "";
+    if (!filePath)
+        return;
+    if (!/\.(ts|tsx|js|jsx)$/.test(filePath))
+        return;
+    const fullPath = filePath.startsWith("/") ? filePath : join(projectRoot, filePath);
+    if (!existsSync(fullPath))
+        return;
+    try {
+        const head = readFileSync(fullPath, "utf-8").slice(0, 800);
+        if (!head.includes("@purpose")) {
+            ctx.ui.notify(`⚠️ Missing @purpose header in ${filePath}\n   Add: /** @purpose One-line description */`, { level: "warn" });
+        }
+    }
+    catch { }
+}
+/**
+ * Auto-commit changes before context compaction.
+ * Equivalent to Claude Code's PreCompact hook that runs:
+ *   git add knowledge/ previews/ content/ suggestions/ .jfl/ && git commit
+ */
+function autoCommitBeforeCompact(ctx) {
+    const trackedDirs = ["knowledge", "previews", "content", "suggestions", ".jfl", "CLAUDE.md"];
+    const addPaths = trackedDirs
+        .filter((d) => existsSync(join(projectRoot, d)))
+        .join(" ");
+    if (!addPaths)
+        return;
+    try {
+        const status = execSync(`git status --porcelain -- ${addPaths}`, {
+            cwd: projectRoot,
+            encoding: "utf-8",
+        }).trim();
+        if (!status)
+            return; // nothing to commit
+        execSync(`git add ${addPaths} && git commit -m "auto-commit: pre-compact save"`, {
+            cwd: projectRoot,
+            stdio: "pipe",
+        });
+        ctx.log("Pre-compact auto-commit saved changes", "debug");
+    }
+    catch {
+        // Not critical — auto-commit daemon is the primary safety net
+    }
+}
+export async function checkJournalBeforeCompact(ctx) {
+    // Auto-commit changes before compaction (safety net)
+    autoCommitBeforeCompact(ctx);
+    const branch = getSessionBranch() || getCurrentBranch(projectRoot);
+    if (!hasJournalEntryForSession(projectRoot, branch)) {
+        if (ctx.ui.hasUI) {
+            const ok = await ctx.ui.confirm("No Journal Entry", "No journal entry for this session. Compacting without one loses context.\n\nContinue anyway?");
+            if (!ok)
+                return ctx.cancel();
+        }
+        else {
+            ctx.ui.notify("No journal entry for this session. Write one with /journal before compacting.", { level: "warn" });
+            return ctx.cancel();
+        }
+    }
+}
+//# sourceMappingURL=journal.js.map

package/packages/pi/dist/journal.js.map

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

package/packages/pi/dist/map-bridge.d.ts

@@ -0,0 +1,20 @@
+/**
+ * MAP Event Bridge Extension
+ *
+ * Translates Pi lifecycle events → MAP event bus (Context Hub HTTP).
+ * Also subscribes to hub SSE stream and re-emits as Pi custom events.
+ * Enforces scope filtering from .jfl/config.json context_scope.
+ *
+ * @purpose Pi lifecycle → MAP bus bridge with scope enforcement
+ */
+import type { PiContext, JflConfig, AgentEndEvent, ToolExecutionEvent } from "./types.js";
+declare let hubUrl: string;
+declare let authToken: string | null;
+export declare function setupMapBridge(ctx: PiContext, config: JflConfig): Promise<void>;
+export declare function onMapBridgeShutdown(_ctx: PiContext): Promise<void>;
+export declare function emitAgentStart(ctx: PiContext, event: unknown): Promise<void>;
+export declare function emitAgentEnd(ctx: PiContext, event: AgentEndEvent): Promise<void>;
+export declare function onMapToolEnd(ctx: PiContext, event: ToolExecutionEvent): Promise<void>;
+export declare function emitCustomEvent(ctx: PiContext, type: string, data: unknown): Promise<void>;
+export { hubUrl, authToken };
+//# sourceMappingURL=map-bridge.d.ts.map

package/packages/pi/dist/map-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-bridge.d.ts","sourceRoot":"","sources":["../extensions/map-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAezF,QAAA,IAAI,MAAM,QAA0B,CAAA;AACpC,QAAA,IAAI,SAAS,EAAE,MAAM,GAAG,IAAW,CAAA;AAyGnC,wBAAsB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CrF;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAGxE;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAO3F;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhG;AAED,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAA"}

package/packages/pi/dist/map-bridge.js

@@ -0,0 +1,181 @@
+/**
+ * MAP Event Bridge Extension
+ *
+ * Translates Pi lifecycle events → MAP event bus (Context Hub HTTP).
+ * Also subscribes to hub SSE stream and re-emits as Pi custom events.
+ * Enforces scope filtering from .jfl/config.json context_scope.
+ *
+ * @purpose Pi lifecycle → MAP bus bridge with scope enforcement
+ */
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+let hubUrl = "http://localhost:4242";
+let authToken = null;
+let scope = {};
+let sseAbort = null;
+const PI_TO_MAP = {
+    "hook:session-start": "hook:session-start",
+    "hook:session-end": "hook:session-end",
+    "task:started": "task:started",
+    "task:completed": "task:completed",
+    "hook:tool-use": "hook:tool-use",
+    "hook:tool-result": "hook:tool-result",
+};
+function readToken(root) {
+    const tokenPath = join(root, ".jfl", "context-hub.token");
+    if (existsSync(tokenPath)) {
+        return readFileSync(tokenPath, "utf-8").trim();
+    }
+    return null;
+}
+function matchPattern(pattern, value) {
+    if (pattern === "*")
+        return true;
+    if (pattern === value)
+        return true;
+    if (pattern.includes("*")) {
+        const regex = new RegExp("^" + pattern.replace(/\*/g, ".*") + "$");
+        return regex.test(value);
+    }
+    return false;
+}
+function isEventAllowedToEmit(eventType, src) {
+    if (!src.produces || src.produces.length === 0)
+        return true;
+    return src.produces.some(p => matchPattern(p, eventType));
+}
+function isEventDenied(eventType, src) {
+    if (!src.denied || src.denied.length === 0)
+        return false;
+    return src.denied.some(d => matchPattern(d, eventType));
+}
+async function postToHub(event) {
+    if (isEventDenied(event.type, scope))
+        return;
+    if (!isEventAllowedToEmit(event.type, scope))
+        return;
+    try {
+        const response = await fetch(`${hubUrl}/api/events`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...(authToken ? { Authorization: `Bearer ${authToken}` } : {}),
+            },
+            body: JSON.stringify(event),
+        });
+        if (!response.ok) {
+            // Silently ignore hub connectivity issues — it may not be running
+        }
+    }
+    catch {
+        // Hub not available — non-fatal
+    }
+}
+async function subscribeToHubSSE(ctx) {
+    sseAbort = new AbortController();
+    const consumesPatterns = scope.consumes ?? ["*"];
+    try {
+        const patternsParam = consumesPatterns.join(",");
+        const url = `${hubUrl}/api/events/stream?pattern=${encodeURIComponent(patternsParam)}`;
+        const resp = await fetch(url, {
+            headers: authToken ? { Authorization: `Bearer ${authToken}` } : {},
+            signal: sseAbort.signal,
+        });
+        if (!resp.ok || !resp.body)
+            return;
+        const reader = resp.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                if (!line.startsWith("data: "))
+                    continue;
+                try {
+                    const event = JSON.parse(line.slice(6));
+                    if (isEventDenied(event.type, scope))
+                        continue;
+                    ctx.emit(`map:${event.type}`, event);
+                }
+                catch { }
+            }
+        }
+    }
+    catch (err) {
+        if (err.name === "AbortError")
+            return;
+        // Silently ignore — Context Hub may not be running
+    }
+}
+export async function setupMapBridge(ctx, config) {
+    const root = ctx.session.projectRoot;
+    authToken = readToken(root);
+    scope = config.context_scope ?? {};
+    const portFile = join(root, ".jfl", "context-hub.port");
+    if (existsSync(portFile)) {
+        const port = readFileSync(portFile, "utf-8").trim();
+        if (port)
+            hubUrl = `http://localhost:${port}`;
+    }
+    // Verify the hub is actually reachable on this port.
+    // If not, try discovering the real port from the running process.
+    try {
+        const healthResp = await fetch(`${hubUrl}/health`, { signal: AbortSignal.timeout(3000) });
+        if (!healthResp.ok)
+            throw new Error("unhealthy");
+    }
+    catch {
+        ctx.log(`Hub unreachable at ${hubUrl}, attempting port discovery...`, "warn");
+        // Try to find the actual port from the running hub process
+        try {
+            const { execSync } = await import("child_process");
+            const psOut = execSync(`ps aux | grep "context-hub serve.*--project-root ${root.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}" | grep -v grep`, { encoding: "utf-8", timeout: 5000, stdio: ["pipe", "pipe", "pipe"] }).trim();
+            const portMatch = psOut.match(/--port\s+(\d+)/);
+            if (portMatch) {
+                const discoveredPort = portMatch[1];
+                const testResp = await fetch(`http://localhost:${discoveredPort}/health`, { signal: AbortSignal.timeout(3000) });
+                if (testResp.ok) {
+                    hubUrl = `http://localhost:${discoveredPort}`;
+                    // Fix the stale port file
+                    const { writeFileSync } = await import("fs");
+                    writeFileSync(join(root, ".jfl", "context-hub.port"), discoveredPort);
+                    ctx.log(`Hub discovered on port ${discoveredPort} — fixed stale port file`, "warn");
+                }
+            }
+        }
+        catch {
+            ctx.log("Hub port discovery failed — hub tools will be unavailable", "warn");
+        }
+    }
+    ctx.on("hook:session-start", (data) => postToHub({ type: "hook:session-start", source: "pi-session", data, ts: new Date().toISOString() }));
+    ctx.on("hook:session-end", (data) => postToHub({ type: "hook:session-end", source: "pi-session", data, ts: new Date().toISOString() }));
+    subscribeToHubSSE(ctx).catch(() => { });
+}
+export async function onMapBridgeShutdown(_ctx) {
+    sseAbort?.abort();
+    sseAbort = null;
+}
+export async function emitAgentStart(ctx, event) {
+    await postToHub({ type: "task:started", source: `pi-agent:${ctx.session.id}`, data: event, ts: new Date().toISOString() });
+}
+export async function emitAgentEnd(ctx, event) {
+    await postToHub({ type: "task:completed", source: `pi-agent:${ctx.session.id}`, data: event, ts: new Date().toISOString() });
+}
+export async function onMapToolEnd(ctx, event) {
+    await postToHub({
+        type: "hook:tool-result",
+        source: `pi-agent:${ctx.session.id}`,
+        data: { tool: event.toolName ?? event.tool, duration: event.duration },
+        ts: new Date().toISOString(),
+    });
+}
+export async function emitCustomEvent(ctx, type, data) {
+    await postToHub({ type, source: `pi:${ctx.session.id}`, data, ts: new Date().toISOString() });
+}
+export { hubUrl, authToken };
+//# sourceMappingURL=map-bridge.js.map

package/packages/pi/dist/map-bridge.js.map

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

package/packages/pi/dist/memory-tool.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Memory Tool Extension
+ *
+ * Registers jfl_memory_search, jfl_memory_add, and jfl_memory_status tools.
+ * Full parity with the Context Hub MCP server's memory tools.
+ *
+ * @purpose Memory tools — search, add, and status for project memory
+ */
+import type { PiContext } from "./types.js";
+export declare function setupMemoryTool(ctx: PiContext): void;
+//# sourceMappingURL=memory-tool.d.ts.map

package/packages/pi/dist/memory-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tool.d.ts","sourceRoot":"","sources":["../extensions/memory-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAI3C,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CA2IpD"}

package/packages/pi/dist/memory-tool.js

@@ -0,0 +1,148 @@
+/**
+ * Memory Tool Extension
+ *
+ * Registers jfl_memory_search, jfl_memory_add, and jfl_memory_status tools.
+ * Full parity with the Context Hub MCP server's memory tools.
+ *
+ * @purpose Memory tools — search, add, and status for project memory
+ */
+import { hubUrl, authToken } from "./map-bridge.js";
+import { memoryRenderCall, memoryRenderResult } from "./tool-renderers.js";
+export function setupMemoryTool(ctx) {
+    // ─── jfl_memory_search ───────────────────────────────────────────────────
+    ctx.registerTool({
+        name: "jfl_memory_search",
+        description: "Search JFL project memory — find past decisions, learnings, and patterns across all sessions",
+        promptSnippet: "Search project memory for decisions, learnings, and session history",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query to find relevant memories",
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum results (default: 10)",
+                },
+                type: {
+                    type: "string",
+                    description: "Filter by entry type: feature, fix, decision, discovery, milestone, all",
+                    enum: ["feature", "fix", "decision", "discovery", "milestone", "all"],
+                },
+            },
+            required: ["query"],
+        },
+        async handler(input) {
+            const { query, limit, type } = input;
+            try {
+                const body = { query, maxItems: limit ?? 10 };
+                if (type && type !== "all")
+                    body.type = type;
+                const resp = await fetch(`${hubUrl}/api/memory/search`, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                        ...(authToken ? { Authorization: `Bearer ${authToken}` } : {}),
+                    },
+                    body: JSON.stringify(body),
+                });
+                if (!resp.ok)
+                    return "Memory search unavailable.";
+                const data = await resp.json();
+                if (!data.results?.length)
+                    return "No memories found.";
+                return data.results
+                    .map(r => {
+                    const header = [r.type && `[${r.type}]`, r.title].filter(Boolean).join(" ");
+                    return [header, r.content].filter(Boolean).join("\n");
+                })
+                    .join("\n\n---\n\n");
+            }
+            catch {
+                return "Memory search unavailable — Context Hub may not be running.";
+            }
+        },
+        renderCall: memoryRenderCall,
+        renderResult: memoryRenderResult,
+    });
+    // ─── jfl_memory_add ──────────────────────────────────────────────────────
+    ctx.registerTool({
+        name: "jfl_memory_add",
+        description: "Manually add a memory or note to the project memory system. Use to capture insights, decisions, or important context that should persist across sessions.",
+        promptSnippet: "Add a memory/note to project memory",
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: {
+                    type: "string",
+                    description: "Title for the memory entry",
+                },
+                content: {
+                    type: "string",
+                    description: "Content of the memory — the insight, decision, or note",
+                },
+                type: {
+                    type: "string",
+                    description: "Type of memory entry",
+                    enum: ["decision", "discovery", "insight", "note"],
+                },
+            },
+            required: ["title", "content"],
+        },
+        async handler(input) {
+            const { title, content, type } = input;
+            try {
+                const resp = await fetch(`${hubUrl}/api/memory/add`, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json",
+                        ...(authToken ? { Authorization: `Bearer ${authToken}` } : {}),
+                    },
+                    body: JSON.stringify({ title, content, type: type ?? "note" }),
+                    signal: AbortSignal.timeout(5000),
+                });
+                if (!resp.ok)
+                    return "Failed to add memory — hub returned error.";
+                const data = await resp.json();
+                return (data.ok || data.id)
+                    ? `Memory added: "${title}" (${type ?? "note"})${data.id ? ` [id: ${data.id}]` : ""}`
+                    : "Memory add returned unexpected response.";
+            }
+            catch {
+                return "Memory add unavailable — Context Hub may not be running.";
+            }
+        },
+    });
+    // ─── jfl_memory_status ───────────────────────────────────────────────────
+    ctx.registerTool({
+        name: "jfl_memory_status",
+        description: "Get memory system statistics and health — total entries, indexed count, embedding status.",
+        promptSnippet: "Check memory system health and stats",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+        async handler() {
+            try {
+                const resp = await fetch(`${hubUrl}/api/memory/status`, {
+                    method: "GET",
+                    headers: {
+                        ...(authToken ? { Authorization: `Bearer ${authToken}` } : {}),
+                    },
+                    signal: AbortSignal.timeout(5000),
+                });
+                if (!resp.ok)
+                    return "Memory status unavailable.";
+                const data = await resp.json();
+                return Object.entries(data)
+                    .map(([k, v]) => `${k}: ${typeof v === "object" ? JSON.stringify(v) : v}`)
+                    .join("\n");
+            }
+            catch {
+                return "Memory status unavailable — Context Hub may not be running.";
+            }
+        },
+    });
+}
+//# sourceMappingURL=memory-tool.js.map