@scitrera/memorylayer-cc-plugin 0.1.22 → 0.2.0

package/dist/src/hooks/observation.js

@@ -0,0 +1,421 @@
+/**
+ * Observation extraction for auto-capture hooks.
+ * Extracts structured observation data from tool usage.
+ */
+import { createHash } from 'crypto';
+// Tools to skip (internal/noisy/self-referential)
+const SKIP_TOOLS = new Set([
+    'TodoWrite', 'TodoRead',
+    'AskFollowupQuestion', 'AskUserQuestion',
+    'AttemptCompletion',
+    'LS', // Low signal
+]);
+// Also skip any tool matching these prefixes (memory tools)
+const SKIP_PREFIXES = [
+    'mcp__memorylayer',
+    'mcp__memory',
+    'memory_',
+];
+export function shouldSkipTool(toolName) {
+    if (SKIP_TOOLS.has(toolName))
+        return true;
+    return SKIP_PREFIXES.some(prefix => toolName.startsWith(prefix));
+}
+/**
+ * Classify tool as read/write/execute/search/other
+ */
+export function getObservationType(toolName) {
+    const readTools = ['Read', 'Glob', 'Grep', 'LS'];
+    const writeTools = ['Write', 'Edit', 'MultiEdit', 'NotebookEdit'];
+    const executeTools = ['Bash', 'Task', 'Skill'];
+    const searchTools = ['WebSearch', 'WebFetch'];
+    if (readTools.includes(toolName))
+        return 'read';
+    if (writeTools.includes(toolName))
+        return 'write';
+    if (executeTools.includes(toolName))
+        return 'execute';
+    if (searchTools.includes(toolName))
+        return 'search';
+    return 'other';
+}
+/**
+ * Extract file paths from tool input, classified as read or modified
+ */
+export function extractFilePaths(toolName, toolInput) {
+    const filesRead = [];
+    const filesModified = [];
+    try {
+        const input = typeof toolInput === 'object' && toolInput !== null ? toolInput : {};
+        const filePath = input?.file_path || input?.path || '';
+        if (!filePath) {
+            // Try to extract paths from bash commands
+            if (toolName === 'Bash') {
+                const command = input?.command || '';
+                const pathMatches = command.match(/(?:^|\s)([^\s]+\.(ts|js|py|json|yaml|yml|md|txt|go|rs|java|c|cpp|h))\b/gi);
+                if (pathMatches) {
+                    filesRead.push(...pathMatches.map((p) => p.trim()));
+                }
+            }
+            return { filesRead, filesModified };
+        }
+        const type = getObservationType(toolName);
+        if (type === 'write') {
+            filesModified.push(filePath);
+        }
+        else if (type === 'read') {
+            filesRead.push(filePath);
+        }
+    }
+    catch {
+        // Ignore parse errors
+    }
+    return { filesRead, filesModified };
+}
+/**
+ * Generate observation title from tool usage
+ */
+export function generateTitle(toolName, toolInput) {
+    try {
+        const input = typeof toolInput === 'object' && toolInput !== null ? toolInput : {};
+        switch (toolName) {
+            case 'Read':
+                return `Read ${input?.file_path || input?.path || 'file'}`;
+            case 'Write':
+                return `Write ${input?.file_path || input?.path || 'file'}`;
+            case 'Edit':
+            case 'MultiEdit':
+                return `Edit ${input?.file_path || input?.path || 'file'}`;
+            case 'Bash': {
+                const cmd = input?.command || '';
+                return `Run: ${cmd.substring(0, 50)}${cmd.length > 50 ? '...' : ''}`;
+            }
+            case 'Glob':
+                return `Find ${input?.pattern || 'files'}`;
+            case 'Grep':
+                return `Search "${input?.pattern || ''}"`;
+            case 'Task':
+                return `Task: ${input?.description || 'agent'}`;
+            case 'WebSearch':
+                return `Search: ${input?.query || ''}`;
+            case 'WebFetch':
+                return `Fetch: ${input?.url || ''}`;
+            default:
+                return `${toolName}`;
+        }
+    }
+    catch {
+        return toolName;
+    }
+}
+/**
+ * Extract facts from tool input/response
+ */
+export function extractFacts(toolName, toolInput, toolOutput) {
+    const facts = [];
+    try {
+        const input = typeof toolInput === 'object' && toolInput !== null ? toolInput : {};
+        const filePath = input?.file_path || input?.path || '';
+        switch (toolName) {
+            case 'Read':
+                if (filePath)
+                    facts.push(`File read: ${filePath}`);
+                break;
+            case 'Write':
+                if (filePath)
+                    facts.push(`File created/updated: ${filePath}`);
+                break;
+            case 'Edit':
+            case 'MultiEdit':
+                if (filePath)
+                    facts.push(`File modified: ${filePath}`);
+                if (input?.old_string) {
+                    facts.push(`Code replaced in ${filePath.split(/[/\\]/).pop() || 'file'}`);
+                }
+                break;
+            case 'Bash': {
+                const cmd = input?.command || '';
+                facts.push(`Command executed: ${cmd.substring(0, 100)}`);
+                // Extract test results
+                if (toolOutput) {
+                    if (toolOutput.includes('passed') || toolOutput.includes('\u2713'))
+                        facts.push('Tests passed');
+                    if (toolOutput.includes('failed') || toolOutput.includes('\u2717'))
+                        facts.push('Tests failed');
+                    if (toolOutput.includes('error') || toolOutput.includes('Error'))
+                        facts.push('Errors encountered');
+                }
+                break;
+            }
+            case 'Glob':
+                if (input?.pattern)
+                    facts.push(`Pattern searched: ${input.pattern}`);
+                break;
+            case 'Grep':
+                if (input?.pattern)
+                    facts.push(`Code pattern searched: ${input.pattern}`);
+                if (input?.path)
+                    facts.push(`Search scope: ${input.path}`);
+                break;
+            case 'WebSearch':
+                if (input?.query)
+                    facts.push(`Web search: ${input.query}`);
+                break;
+            case 'WebFetch':
+                if (input?.url)
+                    facts.push(`URL fetched: ${input.url}`);
+                break;
+            case 'Task':
+                if (input?.description)
+                    facts.push(`Sub-task: ${input.description}`);
+                if (input?.subagent_type)
+                    facts.push(`Agent type: ${input.subagent_type}`);
+                break;
+        }
+    }
+    catch {
+        // Ignore parse errors
+    }
+    return facts;
+}
+/**
+ * Extract concepts/topics from tool usage
+ */
+export function extractConcepts(toolName, toolInput) {
+    const concepts = new Set();
+    try {
+        const input = typeof toolInput === 'object' && toolInput !== null ? toolInput : {};
+        const filePath = (input?.file_path || input?.path || '');
+        // Extract concepts from file paths
+        if (filePath) {
+            // Directory-based concepts
+            const parts = filePath.split(/[/\\]/);
+            for (const part of parts) {
+                if (['src', 'lib', 'dist', 'node_modules', '.', '..'].includes(part))
+                    continue;
+                if (part.includes('.')) {
+                    // File extension concepts
+                    const ext = part.split('.').pop();
+                    const extMap = {
+                        ts: 'typescript', tsx: 'react', js: 'javascript', jsx: 'react',
+                        py: 'python', rs: 'rust', go: 'golang', css: 'styling', scss: 'styling',
+                        html: 'html', json: 'configuration', yaml: 'configuration', yml: 'configuration',
+                        md: 'documentation', test: 'testing', spec: 'testing', sql: 'database',
+                    };
+                    if (ext && extMap[ext])
+                        concepts.add(extMap[ext]);
+                }
+                // Directory-based concepts
+                const dirMap = {
+                    tests: 'testing', __tests__: 'testing', test: 'testing', spec: 'testing',
+                    hooks: 'hooks', api: 'api', auth: 'authentication', db: 'database',
+                    components: 'components', pages: 'pages', routes: 'routing', utils: 'utilities',
+                    services: 'services', middleware: 'middleware', models: 'models', types: 'types',
+                    cli: 'cli', config: 'configuration', migrations: 'database', schemas: 'schemas',
+                };
+                if (dirMap[part])
+                    concepts.add(dirMap[part]);
+            }
+        }
+        // Extract function/class names from Edit/MultiEdit for code-specific searchability
+        if (toolName === 'Edit' || toolName === 'MultiEdit') {
+            const oldStr = (input?.old_string || '');
+            const newStr = (input?.new_string || '');
+            const combined = oldStr + '\n' + newStr;
+            // Extract function names
+            const funcMatches = combined.match(/(?:function|async function|const|let|var)\s+(\w{3,})/g);
+            if (funcMatches) {
+                for (const m of funcMatches.slice(0, 3)) {
+                    const name = m.replace(/(?:function|async function|const|let|var)\s+/, '');
+                    concepts.add(`fn:${name}`);
+                }
+            }
+            // Extract class names
+            const classMatches = combined.match(/class\s+(\w{3,})/g);
+            if (classMatches) {
+                for (const m of classMatches.slice(0, 2)) {
+                    concepts.add(`class:${m.replace('class ', '')}`);
+                }
+            }
+            // Extract patterns: import, export, interface, type, enum
+            if (/\bimport\b/.test(combined))
+                concepts.add('pattern:import');
+            if (/\bexport\b/.test(combined))
+                concepts.add('pattern:export');
+            if (/\binterface\b/.test(combined))
+                concepts.add('pattern:interface');
+            if (/\benum\b/.test(combined))
+                concepts.add('pattern:enum');
+            if (/\btry\s*\{/.test(combined))
+                concepts.add('pattern:error-handling');
+            if (/\basync\b/.test(combined))
+                concepts.add('pattern:async');
+        }
+        // Tool-based concepts
+        switch (toolName) {
+            case 'Bash': {
+                const cmd = (input?.command || '');
+                if (cmd.includes('test') || cmd.includes('vitest') || cmd.includes('jest'))
+                    concepts.add('testing');
+                if (cmd.includes('build') || cmd.includes('tsc'))
+                    concepts.add('build');
+                if (cmd.includes('git'))
+                    concepts.add('version-control');
+                if (cmd.includes('npm') || cmd.includes('yarn') || cmd.includes('pnpm'))
+                    concepts.add('package-management');
+                if (cmd.includes('docker'))
+                    concepts.add('containerization');
+                if (cmd.includes('lint') || cmd.includes('eslint'))
+                    concepts.add('linting');
+                break;
+            }
+            case 'WebSearch':
+                concepts.add('research');
+                break;
+            case 'WebFetch':
+                concepts.add('web-content');
+                break;
+            case 'Task':
+                concepts.add('delegation');
+                if (input?.subagent_type)
+                    concepts.add(input.subagent_type);
+                break;
+        }
+    }
+    catch {
+        // Ignore parse errors
+    }
+    return Array.from(concepts);
+}
+/**
+ * Detect intent from tool usage and user prompt
+ */
+export function detectIntent(toolName, toolInput, prompt) {
+    const intentPatterns = {
+        bugfix: /fix|bug|error|issue|broken|crash|repair/i,
+        feature: /add|feature|implement|create|new|build/i,
+        refactor: /refactor|clean|rename|reorganize|restructure/i,
+        testing: /test|spec|coverage|verify/i,
+        investigation: /find|search|investigate|debug|analyze|explore/i,
+        documentation: /document|comment|readme|doc|explain/i,
+    };
+    // Check user prompt first (if available)
+    if (prompt) {
+        for (const [intent, pattern] of Object.entries(intentPatterns)) {
+            if (pattern.test(prompt)) {
+                return intent;
+            }
+        }
+    }
+    // Check tool input
+    try {
+        const input = typeof toolInput === 'object' && toolInput !== null ? toolInput : {};
+        const inputStr = JSON.stringify(input);
+        for (const [intent, pattern] of Object.entries(intentPatterns)) {
+            if (pattern.test(inputStr)) {
+                return intent;
+            }
+        }
+    }
+    catch {
+        // Ignore parse errors
+    }
+    // Tool-based intent detection
+    switch (toolName) {
+        case 'Read':
+        case 'Glob':
+        case 'Grep':
+            return 'investigation';
+        case 'Write':
+            return 'feature';
+        case 'Edit':
+            return null; // Too ambiguous without context
+        default:
+            return null;
+    }
+}
+/**
+ * Compute content hash for deduplication
+ */
+export function computeContentHash(...parts) {
+    return createHash('sha256')
+        .update(parts.join('|'))
+        .digest('hex')
+        .slice(0, 16);
+}
+/**
+ * Truncate string to max length
+ */
+export function truncate(str, maxLen = 500) {
+    if (str.length <= maxLen)
+        return str;
+    return str.substring(0, maxLen) + '...';
+}
+/**
+ * Build observation from hook input
+ */
+export function buildObservation(input, currentPrompt) {
+    const toolName = input.tool_name;
+    if (!toolName)
+        return null;
+    // Extract all components
+    const type = getObservationType(toolName);
+    const title = generateTitle(toolName, input.tool_input);
+    const { filesRead, filesModified } = extractFilePaths(toolName, input.tool_input);
+    const facts = extractFacts(toolName, input.tool_input, input.tool_output);
+    const concepts = extractConcepts(toolName, input.tool_input);
+    const intent = detectIntent(toolName, input.tool_input, currentPrompt);
+    // Build summary
+    const summary = buildSummary(toolName, input.tool_input, input.tool_output, filesRead, filesModified);
+    // Compute content hash for dedup
+    const contentHash = computeContentHash(toolName, JSON.stringify(input.tool_input || {}), summary);
+    // Skip if empty observation (no meaningful data extracted)
+    if (filesRead.length === 0 && filesModified.length === 0 && facts.length === 0 && concepts.length === 0) {
+        return null;
+    }
+    return {
+        type,
+        title,
+        toolName,
+        filesRead,
+        filesModified,
+        facts,
+        concepts,
+        intent,
+        contentHash,
+        summary,
+    };
+}
+/**
+ * Build human-readable summary
+ */
+function buildSummary(toolName, toolInput, _toolOutput, filesRead, filesModified) {
+    const parts = [];
+    if (filesRead.length > 0) {
+        parts.push(`Read: ${filesRead.join(', ')}`);
+    }
+    if (filesModified.length > 0) {
+        parts.push(`Modified: ${filesModified.join(', ')}`);
+    }
+    // Add tool-specific context
+    try {
+        const input = typeof toolInput === 'object' && toolInput !== null ? toolInput : {};
+        if (toolName === 'Bash') {
+            const cmd = input?.command || '';
+            parts.push(`Command: ${truncate(cmd, 100)}`);
+        }
+        else if (toolName === 'Grep') {
+            const pattern = input?.pattern || '';
+            parts.push(`Pattern: ${pattern}`);
+        }
+        else if (toolName === 'Task') {
+            const desc = input?.description || '';
+            parts.push(`Task: ${truncate(desc, 100)}`);
+        }
+    }
+    catch {
+        // Ignore
+    }
+    return parts.length > 0 ? parts.join('; ') : `Used ${toolName}`;
+}
+//# sourceMappingURL=observation.js.map

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

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

package/dist/src/hooks/state.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Hook state management - persists state between hook invocations
+ */
+import type { HookState } from "./types.js";
+/**
+ * Read current hook state from disk
+ */
+export declare function readHookState(): HookState;
+/**
+ * Write hook state to disk
+ */
+export declare function writeHookState(state: HookState): void;
+/**
+ * Mark that recall has been done this turn for a specific query
+ */
+export declare function markRecallDone(query: string): void;
+/**
+ * Check if recall was already done this turn (any query)
+ */
+export declare function wasRecallDoneThisTurn(): boolean;
+/**
+ * Check if a specific query (or similar) was already recalled this turn.
+ * Allows different queries to proceed even if a recall was already done.
+ */
+export declare function wasQueryRecalledThisTurn(query: string): boolean;
+/**
+ * Reset recall status for new turn
+ */
+export declare function resetRecallStatus(): void;
+/**
+ * Store the user's current topic for cross-hook context
+ */
+export declare function setCurrentTopic(topic: string): void;
+/**
+ * Get the user's current topic (set by UserPromptSubmit)
+ */
+export declare function getCurrentTopic(): string | undefined;
+/**
+ * Store the user's current prompt for cross-hook context
+ */
+export declare function setCurrentPrompt(prompt: string): void;
+/**
+ * Get the user's current prompt (set by UserPromptSubmit)
+ */
+export declare function getCurrentPrompt(): string | undefined;
+/**
+ * Update workspace/session info
+ */
+export declare function updateSessionInfo(workspaceId: string, sessionId?: string): void;
+/** Return the last durably acknowledged byte boundary for this transcript. */
+export declare function getCheckpointBoundary(sessionId: string, transcriptPath: string): number;
+/** Advance a transcript boundary only after the server acknowledges raw capture. */
+export declare function acknowledgeCheckpointBoundary(sessionId: string, transcriptPath: string, boundary: number): void;
+/**
+ * Get current workspace ID from state
+ */
+export declare function getWorkspaceId(): string | undefined;
+/**
+ * Get current session ID from hook-state.json (disk read, singleton).
+ * Prefer resolveSessionId() which checks env first and avoids disk I/O.
+ */
+export declare function getSessionIdFromHookState(): string | undefined;
+/**
+ * Resolve session ID with env-first strategy.
+ *
+ * Prefers process.env.MEMORYLAYER_SESSION_ID (session-scoped via CLAUDE_ENV_FILE)
+ * over hook-state.json (singleton, shared across concurrent sessions).
+ * Only falls back to disk read if env var is not set.
+ *
+ * @param caller - label for diagnostic logging (e.g. "post-tool", "stop")
+ */
+export declare function resolveSessionId(caller: string): string | undefined;
+//# sourceMappingURL=state.d.ts.map

package/dist/src/hooks/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/hooks/state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAU5C;;GAEG;AACH,wBAAgB,aAAa,IAAI,SAAS,CAUzC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CASrD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CASlD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAG/C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAK/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAInD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,SAAS,CAEpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAIrD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAErD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAK/E;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAGvF;AAED,oFAAoF;AACpF,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAO/G;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAEnD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,GAAG,SAAS,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAenE"}