cmp-memory-system 1.0.0

package/dist/hooks/pre-tool-use.js

@@ -0,0 +1,358 @@
+/**
+ * PreToolUse Hook - Executable
+ *
+ * Validates tool calls against configured guards:
+ * 1. Schema protection (block modifications to protected files)
+ * 2. Pattern validation (warn about bad patterns)
+ * 3. Embedding injection (inject relevant knowledge for Task tool)
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import { loadConfig } from '../utils/config.js';
+import { getProjectRoot, matchesPattern } from '../utils/paths.js';
+// =============================================================================
+// GUARD VALIDATION
+// =============================================================================
+/**
+ * Check if content matches a regex pattern
+ */
+function matchesContentTrigger(content, trigger) {
+    try {
+        const regex = new RegExp(trigger, 'gm');
+        return regex.test(content);
+    }
+    catch {
+        // Invalid regex, treat as literal match
+        return content.includes(trigger);
+    }
+}
+/**
+ * Validate a single guard rule against file and content
+ */
+function validateGuard(rule, filePath, content) {
+    // Check file pattern
+    if (!matchesPattern(filePath, [rule.filePattern])) {
+        return null;
+    }
+    // Check excluded files
+    if (rule.excludeFiles && matchesPattern(filePath, rule.excludeFiles)) {
+        return null;
+    }
+    // Check content trigger if specified
+    if (rule.contentTrigger && content) {
+        if (!matchesContentTrigger(content, rule.contentTrigger)) {
+            return null;
+        }
+    }
+    // Guard triggered
+    return {
+        ruleId: rule.id,
+        type: rule.type,
+        message: rule.message,
+        file: filePath,
+    };
+}
+/**
+ * Run all guards against a file operation
+ */
+function runGuards(config, filePath, content) {
+    if (!config.guards.enabled) {
+        return [];
+    }
+    const violations = [];
+    for (const rule of config.guards.rules) {
+        const violation = validateGuard(rule, filePath, content);
+        if (violation) {
+            violations.push(violation);
+        }
+    }
+    return violations;
+}
+// =============================================================================
+// EMBEDDING INJECTION
+// =============================================================================
+/**
+ * Generate embedding using OpenAI or Gemini
+ */
+async function generateEmbedding(text) {
+    const openaiKey = process.env.OPENAI_API_KEY;
+    const geminiKey = process.env.GEMINI_API_KEY;
+    // Try OpenAI first
+    if (openaiKey) {
+        try {
+            const response = await fetch('https://api.openai.com/v1/embeddings', {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${openaiKey}`
+                },
+                body: JSON.stringify({
+                    model: 'text-embedding-3-small',
+                    input: text.slice(0, 8000 * 4),
+                    encoding_format: 'float'
+                })
+            });
+            if (response.ok) {
+                const data = await response.json();
+                return data.data[0]?.embedding ?? null;
+            }
+        }
+        catch {
+            // Fall through to Gemini
+        }
+    }
+    // Try Gemini
+    if (geminiKey) {
+        try {
+            const response = await fetch(`https://generativelanguage.googleapis.com/v1/models/text-embedding-004:embedContent?key=${geminiKey}`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    content: { parts: [{ text: text.slice(0, 10000) }] }
+                })
+            });
+            if (response.ok) {
+                const data = await response.json();
+                return data.embedding.values;
+            }
+        }
+        catch {
+            // No embedding available
+        }
+    }
+    return null;
+}
+/**
+ * Compute cosine similarity between two vectors
+ */
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    let dotProduct = 0;
+    let magnitudeA = 0;
+    let magnitudeB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        magnitudeA += a[i] * a[i];
+        magnitudeB += b[i] * b[i];
+    }
+    const magnitude = Math.sqrt(magnitudeA) * Math.sqrt(magnitudeB);
+    return magnitude === 0 ? 0 : dotProduct / magnitude;
+}
+/**
+ * Load embedding registry
+ */
+async function loadRegistry(projectRoot) {
+    const registryPath = path.join(projectRoot, '.claude/knowledge/registry.json');
+    try {
+        const content = await fs.readFile(registryPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Find matching knowledge sections for a query
+ */
+async function findMatchingSections(projectRoot, queryText, config) {
+    if (!config.embedding.enabled) {
+        return [];
+    }
+    const registry = await loadRegistry(projectRoot);
+    if (!registry || registry.sections.length === 0) {
+        return [];
+    }
+    const queryEmbedding = await generateEmbedding(queryText);
+    if (!queryEmbedding) {
+        return [];
+    }
+    // Find matches
+    const matches = registry.sections
+        .map(section => ({
+        ...section,
+        similarity: cosineSimilarity(queryEmbedding, section.embedding)
+    }))
+        .filter(s => s.similarity >= config.embedding.threshold)
+        .sort((a, b) => {
+        // Prioritize CRITICAL sections if configured
+        if (config.embedding.prioritizeCritical) {
+            if (a.criticality === 'CRITICAL' && b.criticality !== 'CRITICAL')
+                return -1;
+            if (b.criticality === 'CRITICAL' && a.criticality !== 'CRITICAL')
+                return 1;
+        }
+        return b.similarity - a.similarity;
+    })
+        .slice(0, config.embedding.maxSections);
+    return matches;
+}
+/**
+ * Load content of a knowledge section
+ */
+async function loadSectionContent(projectRoot, sectionPath) {
+    const fullPath = path.join(projectRoot, sectionPath);
+    return fs.readFile(fullPath, 'utf-8');
+}
+/**
+ * Format matching sections as injectable context
+ */
+function formatInjectedContext(matches, contents, system) {
+    const totalTokens = matches.reduce((sum, m) => sum + m.tokens, 0);
+    const criticalityBadges = {
+        CRITICAL: '🔴 CRITICAL',
+        HIGH: '🟡 HIGH',
+        MEDIUM: '🟢 MEDIUM',
+        LOW: '⚪ LOW'
+    };
+    const sections = matches
+        .map((match, i) => {
+        const badge = criticalityBadges[match.criticality] ?? '';
+        const similarity = Math.round(match.similarity * 100);
+        return `## ${match.title} (${similarity}% match) ${badge}\n\n${contents[i]}\n\n---`;
+    })
+        .join('\n\n');
+    return `<relevant_knowledge source="metanautical-memory" system="${system}" sections="${matches.length}" tokens="${totalTokens}">
+
+${sections}
+
+</relevant_knowledge>
+
+**System Note**: Loaded ${matches.length} knowledge sections (${totalTokens.toLocaleString()} tokens) via semantic matching.`;
+}
+// =============================================================================
+// MAIN HOOK CLASS
+// =============================================================================
+export class PreToolUseHook {
+    config = null;
+    projectRoot = null;
+    /**
+     * Initialize the hook
+     */
+    async init(projectRoot) {
+        this.projectRoot = projectRoot ?? await getProjectRoot();
+        this.config = await loadConfig(this.projectRoot);
+    }
+    /**
+     * Execute the hook for a tool call
+     */
+    async execute(event) {
+        if (!this.config || !this.projectRoot) {
+            await this.init();
+        }
+        const config = this.config;
+        const projectRoot = this.projectRoot;
+        const toolName = event.tool_name;
+        // Handle different tools
+        switch (toolName) {
+            case 'Edit':
+            case 'Write':
+                return this.handleFileOperation(event, config);
+            case 'Task':
+                return this.handleTaskTool(event, config, projectRoot);
+            default:
+                return { mode: 'proceed' };
+        }
+    }
+    /**
+     * Handle Edit/Write tool calls - run guards
+     */
+    handleFileOperation(event, config) {
+        const filePath = event.parameters.file_path;
+        const content = (event.parameters.new_string ?? event.parameters.content);
+        if (!filePath) {
+            return { mode: 'proceed' };
+        }
+        // Run guards
+        const violations = runGuards(config, filePath, content);
+        if (violations.length === 0) {
+            return { mode: 'proceed' };
+        }
+        // Check for blocking violations
+        const blockingViolations = violations.filter(v => v.type === 'block');
+        const warnings = violations.filter(v => v.type === 'warn' || v.type === 'suggest');
+        if (blockingViolations.length > 0) {
+            const messages = blockingViolations.map(v => `⛔ ${v.ruleId.toUpperCase()}: ${v.message}`);
+            return {
+                mode: 'block',
+                message: messages.join('\n\n'),
+                violations: blockingViolations,
+            };
+        }
+        if (warnings.length > 0) {
+            const messages = warnings.map(v => `⚠️  ${v.ruleId}: ${v.message}`);
+            return {
+                mode: 'warn',
+                message: messages.join('\n\n'),
+                violations: warnings,
+            };
+        }
+        return { mode: 'proceed' };
+    }
+    /**
+     * Handle Task tool calls - inject knowledge
+     */
+    async handleTaskTool(event, config, projectRoot) {
+        const prompt = event.parameters.prompt;
+        const description = event.parameters.description;
+        if (!prompt && !description) {
+            return { mode: 'proceed' };
+        }
+        const queryText = `${description ?? ''}\n\n${prompt ?? ''}`.trim();
+        if (queryText.length < 20) {
+            return { mode: 'proceed' };
+        }
+        try {
+            // Find matching sections
+            const matches = await findMatchingSections(projectRoot, queryText, config);
+            if (matches.length === 0) {
+                return { mode: 'proceed' };
+            }
+            // Load section contents
+            const contents = await Promise.all(matches.map(m => loadSectionContent(projectRoot, m.path)));
+            // Format context
+            const context = formatInjectedContext(matches, contents, config.system);
+            console.log(`📚 [${config.system}] Injected ${matches.length} knowledge sections`);
+            return {
+                mode: 'inject_context',
+                context,
+            };
+        }
+        catch (error) {
+            console.error('[PreToolUse] Embedding error:', error);
+            return { mode: 'proceed' };
+        }
+    }
+}
+// =============================================================================
+// STANDALONE EXECUTION
+// =============================================================================
+/**
+ * Run hook as standalone script (reads event from stdin)
+ */
+export async function runPreToolUseHook() {
+    const hook = new PreToolUseHook();
+    // Read event from stdin or args
+    let event;
+    if (process.argv[2]) {
+        // Event passed as argument
+        event = JSON.parse(process.argv[2]);
+    }
+    else {
+        // Read from stdin
+        const chunks = [];
+        for await (const chunk of process.stdin) {
+            chunks.push(chunk);
+        }
+        const input = Buffer.concat(chunks).toString('utf-8');
+        event = JSON.parse(input);
+    }
+    const result = await hook.execute(event);
+    // Output result as JSON
+    console.log(JSON.stringify(result));
+}
+// Execute if run directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runPreToolUseHook().catch(console.error);
+}
+//# sourceMappingURL=pre-tool-use.js.map

package/dist/hooks/pre-tool-use.js.map

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

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

@@ -0,0 +1,38 @@
+/**
+ * SessionStart Hook - Executable
+ *
+ * Loads relevant context when a Claude session starts:
+ * 1. Detects which module user is working on (via git diff)
+ * 2. Queries DEV_Items for recent memories of that module
+ * 3. Returns formatted context for injection
+ */
+import type { HookResult, MemoryConfig } from '../types/index.js';
+export declare class SessionStartHook {
+    private config;
+    private projectRoot;
+    /**
+     * Initialize the hook
+     */
+    init(projectRoot?: string): Promise<void>;
+    /**
+     * Execute the session start hook
+     */
+    execute(): Promise<HookResult>;
+    /**
+     * Load workflow context (plan, tasks, ideas)
+     */
+    private loadWorkflowContext;
+    /**
+     * Get current configuration
+     */
+    getConfig(): MemoryConfig | null;
+    /**
+     * Get detected project root
+     */
+    getProjectRoot(): string | null;
+}
+/**
+ * Run hook as standalone script
+ */
+export declare function runSessionStartHook(): Promise<void>;
+//# sourceMappingURL=session-start.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAEV,UAAU,EAEV,YAAY,EAEb,MAAM,mBAAmB,CAAA;AA8O1B,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,WAAW,CAAsB;IAEzC;;OAEG;IACG,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IA0CpC;;OAEG;YACW,mBAAmB;IAoCjC;;OAEG;IACH,SAAS,IAAI,YAAY,GAAG,IAAI;IAIhC;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,IAAI;CAGhC;AAMD;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAOzD"}