@scitrera/memorylayer-cc-plugin 0.1.22 → 0.2.0

package/dist/src/hooks/formatters.js

@@ -0,0 +1,187 @@
+/**
+ * Format API responses for injection into Claude's context.
+ *
+ * Uses the same types returned by MemoryLayerClient (the MCP adapter),
+ * so hooks and MCP tools share the same data contracts.
+ */
+/**
+ * Format a single memory for display
+ */
+function formatMemory(memory, index) {
+    const lines = [];
+    const typeStr = memory.subtype
+        ? `${memory.type}/${memory.subtype}`
+        : memory.type;
+    const relevanceStr = memory.relevance_score
+        ? ` (relevance: ${(memory.relevance_score * 100).toFixed(0)}%)`
+        : "";
+    lines.push(`${index + 1}. [${typeStr}]${relevanceStr}`);
+    lines.push(`   ${memory.content}`);
+    const tags = memory.tags ?? [];
+    if (tags.length > 0) {
+        lines.push(`   Tags: ${tags.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format recall results for context injection
+ */
+export function formatRecallResult(result, query) {
+    if (result.memories.length === 0) {
+        return `No memories found matching "${query}".`;
+    }
+    const totalCount = result.total_count ?? result.memories.length;
+    const lines = [
+        `Found ${totalCount} memories for "${query}" (showing ${result.memories.length}):`,
+        "",
+    ];
+    for (let i = 0; i < result.memories.length; i++) {
+        lines.push(formatMemory(result.memories[i], i));
+        if (i < result.memories.length - 1) {
+            lines.push("");
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Format briefing for context injection.
+ * Accepts the ToolResponse from MemoryLayerClient.getBriefing().
+ */
+export function formatBriefing(briefing) {
+    if (!briefing) {
+        return "=== Workspace Briefing ===\n\nNo workspace data available.";
+    }
+    const totalMemories = briefing.total_memories ?? 0;
+    const activeTopics = briefing.active_topics ?? [];
+    const memoryTypes = briefing.memory_types ?? {};
+    const recentActivity = briefing.recent_activity ?? [];
+    const lines = [
+        "=== Workspace Briefing ===",
+        "",
+        `Total memories: ${totalMemories}`,
+    ];
+    if (activeTopics.length > 0) {
+        lines.push(`Active topics: ${activeTopics.join(", ")}`);
+    }
+    // Memory type breakdown
+    const types = Object.entries(memoryTypes);
+    if (types.length > 0) {
+        lines.push("");
+        lines.push("Memory types:");
+        for (const [type, count] of types) {
+            lines.push(`  - ${type}: ${count}`);
+        }
+    }
+    // Recent activity
+    if (recentActivity.length > 0) {
+        lines.push("");
+        lines.push("Recent activity:");
+        for (const activity of recentActivity.slice(0, 3)) {
+            const date = new Date(activity.timestamp ?? new Date().toISOString()).toLocaleDateString();
+            lines.push(`  - ${date}: ${activity.summary ?? ""} (${activity.memories_created ?? 0} memories)`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Format directive memories specially (high importance user instructions)
+ */
+export function formatDirectives(memories) {
+    const directives = memories.filter(m => m.subtype === "directive" || (m.subtype === "preference" && (m.importance ?? 0) >= 0.9));
+    if (directives.length === 0) {
+        return "";
+    }
+    const lines = [
+        "=== User Directives (must follow) ===",
+        "",
+    ];
+    for (const directive of directives) {
+        lines.push(`• ${directive.content}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Format sandbox state for context injection (post-compaction recovery)
+ */
+export function formatSandboxState(inspectResult) {
+    const variableCount = inspectResult.variable_count ?? 0;
+    const variables = inspectResult.variables ?? {};
+    const lines = [
+        "=== Existing Sandbox State (server-side) ===",
+        "",
+        `The server-side sandbox has ${variableCount} variable(s) from a prior session or before context compaction.`,
+        "These variables are live and available for memory_context_exec, memory_context_query, and memory_context_rlm.",
+        "",
+    ];
+    for (const [name, info] of Object.entries(variables)) {
+        lines.push(`  ${name} (${info.type}): ${info.preview}`);
+    }
+    lines.push("");
+    lines.push("Use `memory_context_inspect` for detailed variable inspection.");
+    return lines.join("\n");
+}
+/**
+ * Format combined SessionStart output
+ */
+export function formatSessionStart(briefing, directives, topicRecall, topic, sandboxState) {
+    const sections = [];
+    // Briefing first
+    if (briefing) {
+        sections.push(formatBriefing(briefing));
+    }
+    // Directives (high priority)
+    const directiveSection = formatDirectives(directives);
+    if (directiveSection) {
+        sections.push(directiveSection);
+    }
+    // Topic-specific recall
+    if (topicRecall && topicRecall.memories.length > 0 && topic) {
+        sections.push(formatRecallResult(topicRecall, topic));
+    }
+    // Existing sandbox state (post-compaction or resumed session)
+    if (sandboxState) {
+        sections.push(formatSandboxState(sandboxState));
+    }
+    // Add session guidance
+    const guidance = `=== Session Guidance ===
+
+Recalling Memories:
+- Before answering questions about preferences, setup, conventions, or past decisions, call \`memory_recall\` first
+- For broad context gathering, use \`memory_recall\` with relevant keywords
+- Directives (subtype: directive) and preferences (subtype: preference) represent explicit user instructions — prioritize these
+
+Storing Memories:
+- \`memory_remember\`: store to long-term memory with type, subtype, and importance
+- \`memory_session_commit\`: checkpoint working memory mid-session (without ending it)
+
+Importance Guide: directives/preferences → 0.9 | decisions/architecture → 0.7-0.8 | fixes/solutions → 0.7 | patterns → 0.5-0.6
+Types: semantic (facts), procedural (how-to), episodic (events), working (current context, auto-expires)
+Subtypes: directive, decision, fix, solution, code_pattern, error, workflow, preference, problem
+
+Context Environment (sandbox survives compaction):
+- Load + analyze memories server-side: \`memory_context_load\` → \`memory_context_query\` or \`memory_context_rlm\`
+- Run computations on loaded data: \`memory_context_exec\` (Python sandbox)
+- After compaction, call \`memory_context_inspect\` to re-orient with existing sandbox variables`;
+    sections.push(guidance);
+    if (sections.length === 1) {
+        // Only guidance, no prior context
+        return "MemoryLayer: No prior context found for this session.\n\n" + guidance;
+    }
+    return sections.join("\n\n");
+}
+/**
+ * Format guidance for storing memories after tool use
+ */
+export function formatStorageGuidance(toolName, isSignificant) {
+    if (!isSignificant) {
+        return "";
+    }
+    const guidance = {
+        Task: "Consider storing exploration/research findings with `memory_remember` (subtype: decision/problem/entity).",
+        Bash: "If this was a significant git commit, test result, or build output, store with `memory_remember` (subtype: workflow).",
+        Edit: "If this edit completes a milestone, store with `memory_remember` (type: working, tags: [active-file]).",
+        Write: "If this file represents a significant deliverable, store with `memory_remember` (type: working, tags: [active-file]).",
+    };
+    return guidance[toolName] || "";
+}
+//# sourceMappingURL=formatters.js.map

package/dist/src/hooks/formatters.js.map

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

package/dist/src/hooks/handlers/post-tool.d.ts

@@ -0,0 +1,10 @@
+/**
+ * PostToolUse hook handler
+ * Silently captures tool observations as working memory
+ */
+import type { HookInput, HookOutput } from "../types.js";
+/**
+ * Handle PostToolUse event
+ */
+export declare function handlePostToolUse(input: HookInput): Promise<HookOutput>;
+//# sourceMappingURL=post-tool.d.ts.map

package/dist/src/hooks/handlers/post-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-tool.d.ts","sourceRoot":"","sources":["../../../../src/hooks/handlers/post-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA0DzD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CA6C7E"}

package/dist/src/hooks/handlers/post-tool.js

@@ -0,0 +1,98 @@
+/**
+ * PostToolUse hook handler
+ * Silently captures tool observations as working memory
+ */
+import { formatStorageGuidance } from "../formatters.js";
+import { shouldSkipTool, buildObservation } from "../observation.js";
+import { getClient } from "../client.js";
+import { getCurrentPrompt } from "../state.js";
+/**
+ * Store observation asynchronously (fire-and-forget)
+ */
+async function storeObservationAsync(obs) {
+    // getClient() syncs session ID from env/hook-state via resolveSessionId
+    const client = getClient();
+    const sessionId = client.getSessionId();
+    if (!sessionId)
+        return;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 3000);
+    try {
+        await client.setWorkingMemory(sessionId, `obs_${obs.contentHash}`, {
+            type: obs.type,
+            title: obs.title,
+            tool: obs.toolName,
+            files_read: obs.filesRead,
+            files_modified: obs.filesModified,
+            facts: obs.facts,
+            concepts: obs.concepts,
+            intent: obs.intent,
+            summary: obs.summary,
+            captured_at: new Date().toISOString(),
+        });
+    }
+    catch {
+        // Silent failure - never block tool execution
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Check if Bash output indicates significant action
+ */
+function isSignificantBashOutput(input) {
+    const command = input.tool_input?.command;
+    if (!command)
+        return false;
+    // Git commits
+    if (/git\s+commit/i.test(command))
+        return true;
+    // Build commands with errors
+    if (/npm\s+run\s+build|cargo\s+build|make\b|tsc\b/i.test(command)) {
+        const output = input.tool_output || "";
+        return /error|fail/i.test(output);
+    }
+    return false;
+}
+/**
+ * Handle PostToolUse event
+ */
+export async function handlePostToolUse(input) {
+    const toolName = input.tool_name;
+    if (!toolName) {
+        return { success: true };
+    }
+    // Skip tools that shouldn't be captured
+    if (shouldSkipTool(toolName)) {
+        return { success: true };
+    }
+    // Build observation from tool usage
+    const currentPrompt = getCurrentPrompt();
+    const obs = buildObservation(input, currentPrompt);
+    // If observation is empty/no-op, skip
+    if (!obs) {
+        return { success: true };
+    }
+    // Fire-and-forget storage (do NOT await)
+    storeObservationAsync(obs).catch(() => { });
+    // Keep significant-event guidance for git commits and build errors
+    if (toolName === "Bash" && isSignificantBashOutput(input)) {
+        const command = input.tool_input?.command || "";
+        if (/git\s+commit/i.test(command)) {
+            return {
+                success: true,
+                additionalContext: formatStorageGuidance("Bash", true),
+            };
+        }
+        if (/build|tsc|make/i.test(command)) {
+            return {
+                success: true,
+                additionalContext: "Build had errors. Consider storing the issue with `memory_remember` (subtype: error) for future reference.",
+            };
+        }
+    }
+    // Silent capture - no context injection
+    return { success: true };
+}
+//# sourceMappingURL=post-tool.js.map

package/dist/src/hooks/handlers/post-tool.js.map

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

package/dist/src/hooks/handlers/pre-compact.d.ts

@@ -0,0 +1,5 @@
+/** Durable, deterministic pre-compaction capture for Claude Code transcripts. */
+import type { HookInput, HookOutput } from "../types.js";
+/** Capture raw transcript first, then best-effort commit and sandbox checkpoint. */
+export declare function handlePreCompact(input: HookInput): Promise<HookOutput>;
+//# sourceMappingURL=pre-compact.d.ts.map

package/dist/src/hooks/handlers/pre-compact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-compact.d.ts","sourceRoot":"","sources":["../../../../src/hooks/handlers/pre-compact.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAIjF,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAmFzD,oFAAoF;AACpF,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CA+B5E"}

package/dist/src/hooks/handlers/pre-compact.js

@@ -0,0 +1,117 @@
+/** Durable, deterministic pre-compaction capture for Claude Code transcripts. */
+import { closeSync, existsSync, fstatSync, openSync, readSync } from "fs";
+import { createHash } from "crypto";
+import { getClient } from "../client.js";
+import { acknowledgeCheckpointBoundary, getCheckpointBoundary } from "../state.js";
+const CAPTURE_CHUNK_BYTES = 900_000;
+const MAX_ATTEMPTS = 3;
+function decodeUtf8Prefix(buffer) {
+    for (let trim = 0; trim <= Math.min(4, buffer.length); trim += 1) {
+        const candidate = trim === 0 ? buffer : buffer.subarray(0, buffer.length - trim);
+        try {
+            return {
+                content: new TextDecoder("utf-8", { fatal: true }).decode(candidate),
+                byteCount: candidate.length,
+            };
+        }
+        catch {
+            // A chunk may end within one UTF-8 code point; try the preceding boundary.
+        }
+    }
+    throw new Error("transcript contains malformed UTF-8");
+}
+async function retry(operation) {
+    let lastError;
+    const deadline = Date.now() + 5_000;
+    for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt += 1) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt < MAX_ATTEMPTS && Date.now() < deadline) {
+                await new Promise(resolve => setTimeout(resolve, attempt * 100));
+            }
+            else {
+                break;
+            }
+        }
+    }
+    throw lastError;
+}
+async function captureTranscript(input, sessionId) {
+    const transcriptPath = input.transcript_path;
+    if (!transcriptPath || !existsSync(transcriptPath)) {
+        console.error("[pre-compact] transcript path unavailable; continuing with commit/checkpoint side effects");
+        return 0;
+    }
+    const client = getClient();
+    const descriptor = openSync(transcriptPath, "r");
+    let captured = 0;
+    try {
+        const size = fstatSync(descriptor).size;
+        let boundary = getCheckpointBoundary(sessionId, transcriptPath);
+        if (boundary > size)
+            boundary = 0;
+        while (boundary < size) {
+            const requested = Math.min(CAPTURE_CHUNK_BYTES, size - boundary);
+            const buffer = Buffer.allocUnsafe(requested);
+            const bytesRead = readSync(descriptor, buffer, 0, requested, boundary);
+            if (bytesRead === 0)
+                break;
+            const decoded = decodeUtf8Prefix(buffer.subarray(0, bytesRead));
+            if (decoded.byteCount === 0)
+                throw new Error("unable to find a complete UTF-8 boundary");
+            const nextBoundary = boundary + decoded.byteCount;
+            const contentHash = createHash("sha256").update(Buffer.from(decoded.content, "utf-8")).digest("hex");
+            const idempotencyKey = `claude-code:${sessionId}:${nextBoundary}:${contentHash}`;
+            await retry(() => client.createCheckpoint(sessionId, {
+                transcript_segment: decoded.content,
+                content_hash: contentHash,
+                idempotency_key: idempotencyKey,
+                source_kind: "claude_code_transcript",
+                source_boundary: nextBoundary,
+            }));
+            acknowledgeCheckpointBoundary(sessionId, transcriptPath, nextBoundary);
+            captured += decoded.byteCount;
+            boundary = nextBoundary;
+        }
+    }
+    finally {
+        closeSync(descriptor);
+    }
+    return captured;
+}
+/** Capture raw transcript first, then best-effort commit and sandbox checkpoint. */
+export async function handlePreCompact(input) {
+    const client = getClient();
+    const sessionId = client.getSessionId();
+    if (!sessionId) {
+        console.error("[pre-compact] no server session; MemoryLayer capture skipped without blocking compaction");
+        return { success: true };
+    }
+    try {
+        const captured = await captureTranscript(input, sessionId);
+        console.error(`[pre-compact] durably captured ${captured} new transcript bytes`);
+    }
+    catch (error) {
+        console.error("[pre-compact] raw capture failed; compaction will continue:", error instanceof Error ? error.message : error);
+    }
+    try {
+        await retry(() => client.commitSession(sessionId, { importance_threshold: 0.3 }));
+    }
+    catch (error) {
+        console.error("[pre-compact] working-memory commit failed:", error instanceof Error ? error.message : error);
+    }
+    try {
+        const status = await client.contextStatus();
+        if (status.exists && (status.variable_count ?? 0) > 0) {
+            await retry(() => client.contextCheckpoint());
+        }
+    }
+    catch (error) {
+        console.error("[pre-compact] sandbox checkpoint failed:", error instanceof Error ? error.message : error);
+    }
+    return { success: true };
+}
+//# sourceMappingURL=pre-compact.js.map

package/dist/src/hooks/handlers/pre-compact.js.map

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

package/dist/src/hooks/handlers/pre-tool.d.ts

@@ -0,0 +1,10 @@
+/**
+ * PreToolUse hook handler
+ * Provides recall guidance before tool execution
+ */
+import type { HookInput, HookOutput } from "../types.js";
+/**
+ * Handle PreToolUse event
+ */
+export declare function handlePreToolUse(input: HookInput): Promise<HookOutput>;
+//# sourceMappingURL=pre-tool.d.ts.map

package/dist/src/hooks/handlers/pre-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-tool.d.ts","sourceRoot":"","sources":["../../../../src/hooks/handlers/pre-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAE,UAAU,EAAC,MAAM,aAAa,CAAC;AA0GvD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAkB5E"}

package/dist/src/hooks/handlers/pre-tool.js

@@ -0,0 +1,114 @@
+/**
+ * PreToolUse hook handler
+ * Provides recall guidance before tool execution
+ */
+import { getClient, checkHealth } from "../client.js";
+import { formatRecallResult } from "../formatters.js";
+import { wasQueryRecalledThisTurn, markRecallDone, getCurrentTopic } from "../state.js";
+/**
+ * Handle PreToolUse for Task tool (subagent delegation)
+ */
+async function handleTaskTool(input) {
+    // Extract topic from Task prompt if available
+    const taskPrompt = input.tool_input?.prompt;
+    if (!taskPrompt) {
+        return {
+            success: true,
+            additionalContext: "RECALL-FIRST RULE: Consider using `memory_recall` before delegating to subagent. Subagents cannot access MemoryLayer.",
+        };
+    }
+    // Use first 100 chars of task prompt as query
+    const query = taskPrompt.substring(0, 100);
+    // Check if this specific query was already recalled (allow different queries)
+    if (wasQueryRecalledThisTurn(query)) {
+        return {
+            success: true,
+            additionalContext: "Recall already done for this topic. Include relevant memories in subagent prompt.",
+        };
+    }
+    // Check server health
+    const healthy = await checkHealth();
+    if (!healthy) {
+        return { success: true };
+    }
+    try {
+        const client = getClient();
+        const result = await client.recall({ query, limit: 5 });
+        markRecallDone(query);
+        if (result.memories.length === 0) {
+            return {
+                success: true,
+                additionalContext: "No relevant memories found for this task. Proceeding with delegation.",
+            };
+        }
+        const recallOutput = formatRecallResult(result, query);
+        return {
+            success: true,
+            additionalContext: `INCLUDE IN SUBAGENT PROMPT - Relevant context from memory:\n\n${recallOutput}`,
+        };
+    }
+    catch {
+        return {
+            success: true,
+            additionalContext: "Memory recall failed. Consider manual recall before delegation.",
+        };
+    }
+}
+/**
+ * Handle PreToolUse for Edit/Write tools
+ */
+async function handleEditWriteTool(input) {
+    // Only provide guidance for non-trivial edits
+    const filePath = input.tool_input?.file_path;
+    if (!filePath) {
+        return { success: true };
+    }
+    // Build query from filename + user's current topic (if available)
+    const filename = filePath.split("/").pop() || filePath;
+    const topic = getCurrentTopic();
+    const query = topic ? `${filename} ${topic}` : `${filename} patterns solutions`;
+    // Skip if this specific query was already recalled
+    if (wasQueryRecalledThisTurn(query)) {
+        return { success: true };
+    }
+    // Check server health
+    const healthy = await checkHealth();
+    if (!healthy) {
+        return { success: true };
+    }
+    try {
+        const client = getClient();
+        const result = await client.recall({ query, limit: 3 });
+        if (result.memories.length === 0) {
+            return { success: true };
+        }
+        markRecallDone(query);
+        const recallOutput = formatRecallResult(result, filename);
+        return {
+            success: true,
+            additionalContext: `Relevant context for ${filename}:\n\n${recallOutput}`,
+        };
+    }
+    catch {
+        return { success: true };
+    }
+}
+/**
+ * Handle PreToolUse event
+ */
+export async function handlePreToolUse(input) {
+    const toolName = input.tool_name;
+    if (!toolName) {
+        return { success: true };
+    }
+    switch (toolName) {
+        case "Task":
+            return handleTaskTool(input);
+        case "Edit":
+        case "Write":
+            return handleEditWriteTool(input);
+        default:
+            return { success: true };
+    }
+}
+//# sourceMappingURL=pre-tool.js.map

package/dist/src/hooks/handlers/pre-tool.js.map

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

package/dist/src/hooks/handlers/session-start.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SessionStart hook handler
+ * Retrieves briefing and relevant memories at session start
+ */
+import type { HookInput, HookOutput } from "../types.js";
+/**
+ * Handle SessionStart event
+ */
+export declare function handleSessionStart(input: HookInput): Promise<HookOutput>;
+//# sourceMappingURL=session-start.d.ts.map

package/dist/src/hooks/handlers/session-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../../../src/hooks/handlers/session-start.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAC,SAAS,EAAE,UAAU,EAAC,MAAM,aAAa,CAAC;AA4CvD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAmE9E"}