cmp-memory-system 1.0.0

package/dist/hooks/post-tool-use.d.ts

@@ -0,0 +1,61 @@
+/**
+ * PostToolUse Hook - Executable
+ *
+ * Records what was actually changed after Edit/Write completes.
+ * Creates memory entries for significant changes.
+ */
+import type { HookResult } from '../types/index.js';
+export interface PostToolUseEvent {
+    tool_name: string;
+    parameters: Record<string, unknown>;
+    result: {
+        success: boolean;
+        output?: string;
+        error?: string;
+    };
+}
+interface ChangeRecord {
+    file: string;
+    type: 'edit' | 'write' | 'delete';
+    linesChanged?: number;
+    summary?: string;
+}
+export declare class PostToolUseHook {
+    private config;
+    private projectRoot;
+    private client;
+    private sessionChanges;
+    /**
+     * Initialize the hook
+     */
+    init(projectRoot?: string): Promise<void>;
+    /**
+     * Execute the hook after a tool completes
+     */
+    execute(event: PostToolUseEvent): Promise<HookResult>;
+    /**
+     * Record a significant change to memory
+     */
+    private recordChange;
+    /**
+     * Generate description for change
+     */
+    private generateChangeDescription;
+    /**
+     * Get all changes recorded this session
+     */
+    getSessionChanges(): ChangeRecord[];
+    /**
+     * Create session summary
+     */
+    createSessionSummary(): Promise<{
+        id: string;
+    } | null>;
+    /**
+     * Clear session changes
+     */
+    clearSession(): void;
+}
+export declare function runPostToolUseHook(eventJson: string): Promise<void>;
+export {};
+//# sourceMappingURL=post-tool-use.d.ts.map

package/dist/hooks/post-tool-use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-tool-use.d.ts","sourceRoot":"","sources":["../../src/hooks/post-tool-use.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAA+B,MAAM,mBAAmB,CAAA;AAShF,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,MAAM,EAAE;QACN,OAAO,EAAE,OAAO,CAAA;QAChB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IACjC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AA0GD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,cAAc,CAAqB;IAE3C;;OAEG;IACG,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IA0C3D;;OAEG;YACW,YAAY;IA4B1B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAkBjC;;OAEG;IACH,iBAAiB,IAAI,YAAY,EAAE;IAInC;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IA6C5D;;OAEG;IACH,YAAY,IAAI,IAAI;CAGrB;AAMD,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKzE"}

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

@@ -0,0 +1,262 @@
+/**
+ * PostToolUse Hook - Executable
+ *
+ * Records what was actually changed after Edit/Write completes.
+ * Creates memory entries for significant changes.
+ */
+import { loadConfig } from '../utils/config.js';
+import { getProjectRoot, matchesPattern } from '../utils/paths.js';
+import { createDrizzleClient } from '../db/drizzle-client.js';
+// =============================================================================
+// CHANGE ANALYSIS
+// =============================================================================
+/**
+ * Analyze what was changed
+ */
+function analyzeChange(event) {
+    const { tool_name, parameters, result } = event;
+    if (!result.success) {
+        return null;
+    }
+    switch (tool_name) {
+        case 'Edit': {
+            const filePath = parameters.file_path;
+            const oldString = parameters.old_string;
+            const newString = parameters.new_string;
+            if (!filePath)
+                return null;
+            const linesChanged = Math.abs((newString?.split('\n').length ?? 0) - (oldString?.split('\n').length ?? 0));
+            return {
+                file: filePath,
+                type: 'edit',
+                linesChanged,
+                summary: `Edited ${filePath.split('/').pop()}`,
+            };
+        }
+        case 'Write': {
+            const filePath = parameters.file_path;
+            const content = parameters.content;
+            if (!filePath)
+                return null;
+            return {
+                file: filePath,
+                type: 'write',
+                linesChanged: content?.split('\n').length ?? 0,
+                summary: `Created ${filePath.split('/').pop()}`,
+            };
+        }
+        default:
+            return null;
+    }
+}
+/**
+ * Determine if change is significant enough to record
+ */
+function isSignificantChange(change, config) {
+    // Critical paths are always significant
+    if (matchesPattern(change.file, config.checkpoint.criticalPaths)) {
+        return true;
+    }
+    // Check minimum lines changed
+    if (change.linesChanged && change.linesChanged >= config.checkpoint.minLinesChanged) {
+        return true;
+    }
+    // New files are significant
+    if (change.type === 'write') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Extract domain from file path
+ */
+function extractDomain(filePath, domains) {
+    const pathLower = filePath.toLowerCase();
+    for (const domain of domains) {
+        if (pathLower.includes(domain.replace(/-/g, '/')) ||
+            pathLower.includes(domain.replace(/-/g, '_'))) {
+            return domain;
+        }
+    }
+    // Fallback detection
+    if (pathLower.includes('/schema/'))
+        return 'schema';
+    if (pathLower.includes('/api/') || pathLower.includes('/routers/'))
+        return 'api';
+    if (pathLower.includes('/components/'))
+        return 'components';
+    if (pathLower.includes('/hooks/'))
+        return 'hooks';
+    return 'general';
+}
+// =============================================================================
+// MAIN HOOK CLASS
+// =============================================================================
+export class PostToolUseHook {
+    config = null;
+    projectRoot = null;
+    client = null;
+    sessionChanges = [];
+    /**
+     * Initialize the hook
+     */
+    async init(projectRoot) {
+        this.projectRoot = projectRoot ?? await getProjectRoot();
+        this.config = await loadConfig(this.projectRoot);
+        try {
+            this.client = createDrizzleClient(this.config.system);
+        }
+        catch {
+            // DB not available, will log locally
+            console.warn('[PostToolUse] Database not available, recording changes locally');
+        }
+    }
+    /**
+     * Execute the hook after a tool completes
+     */
+    async execute(event) {
+        if (!this.config || !this.projectRoot) {
+            await this.init();
+        }
+        const config = this.config;
+        // Skip if checkpointing disabled
+        if (!config.checkpoint.enabled) {
+            return { mode: 'proceed' };
+        }
+        // Analyze the change
+        const change = analyzeChange(event);
+        if (!change) {
+            return { mode: 'proceed' };
+        }
+        // Check if excluded
+        if (matchesPattern(change.file, config.checkpoint.excludePaths)) {
+            return { mode: 'proceed' };
+        }
+        // Track the change
+        this.sessionChanges.push(change);
+        // Check if significant
+        if (!isSignificantChange(change, config)) {
+            return { mode: 'proceed' };
+        }
+        // Record significant change
+        try {
+            await this.recordChange(change, config);
+        }
+        catch (error) {
+            console.error('[PostToolUse] Failed to record change:', error);
+        }
+        return { mode: 'proceed' };
+    }
+    /**
+     * Record a significant change to memory
+     */
+    async recordChange(change, config) {
+        const domain = extractDomain(change.file, config.domains);
+        const content = {
+            title: change.summary ?? `Change to ${change.file}`,
+            body: this.generateChangeDescription(change),
+            domain,
+            source: 'checkpoint',
+            relatedFiles: [change.file],
+        };
+        if (this.client) {
+            // Save to database
+            await this.client.createMemory(content, [
+                'auto-checkpoint',
+                domain,
+                change.type,
+            ]);
+            console.log(`📝 [PostToolUse] Recorded: ${content.title}`);
+        }
+        else {
+            // Log locally
+            console.log(`📝 [PostToolUse] Change recorded (local): ${content.title}`);
+        }
+    }
+    /**
+     * Generate description for change
+     */
+    generateChangeDescription(change) {
+        const lines = [];
+        lines.push(`## Change Details`);
+        lines.push('');
+        lines.push(`- **File**: ${change.file}`);
+        lines.push(`- **Type**: ${change.type}`);
+        if (change.linesChanged) {
+            lines.push(`- **Lines changed**: ${change.linesChanged}`);
+        }
+        lines.push('');
+        lines.push(`*Recorded at ${new Date().toISOString()}*`);
+        return lines.join('\n');
+    }
+    /**
+     * Get all changes recorded this session
+     */
+    getSessionChanges() {
+        return [...this.sessionChanges];
+    }
+    /**
+     * Create session summary
+     */
+    async createSessionSummary() {
+        if (this.sessionChanges.length === 0) {
+            return null;
+        }
+        const config = this.config;
+        const changes = this.sessionChanges;
+        // Group by domain
+        const byDomain = new Map();
+        for (const change of changes) {
+            const domain = extractDomain(change.file, config.domains);
+            const existing = byDomain.get(domain) ?? [];
+            existing.push(change);
+            byDomain.set(domain, existing);
+        }
+        // Generate summary
+        const lines = ['## Session Summary', ''];
+        for (const [domain, domainChanges] of byDomain) {
+            lines.push(`### ${domain}`);
+            for (const change of domainChanges) {
+                lines.push(`- ${change.type}: ${change.file.split('/').pop()}`);
+            }
+            lines.push('');
+        }
+        lines.push(`**Total changes**: ${changes.length}`);
+        lines.push(`**Domains affected**: ${byDomain.size}`);
+        const content = {
+            title: `Session Summary: ${changes.length} changes`,
+            body: lines.join('\n'),
+            source: 'checkpoint',
+            relatedFiles: changes.map(c => c.file),
+        };
+        if (this.client) {
+            return this.client.createMemory(content, ['session-summary']);
+        }
+        return null;
+    }
+    /**
+     * Clear session changes
+     */
+    clearSession() {
+        this.sessionChanges = [];
+    }
+}
+// =============================================================================
+// STANDALONE EXECUTION
+// =============================================================================
+export async function runPostToolUseHook(eventJson) {
+    const event = JSON.parse(eventJson);
+    const hook = new PostToolUseHook();
+    const result = await hook.execute(event);
+    console.log(JSON.stringify(result));
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const eventJson = process.argv[2];
+    if (eventJson) {
+        runPostToolUseHook(eventJson).catch(console.error);
+    }
+    else {
+        console.error('Usage: node post-tool-use.js <event-json>');
+    }
+}
+//# sourceMappingURL=post-tool-use.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"post-tool-use.js","sourceRoot":"","sources":["../../src/hooks/post-tool-use.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAA4B,MAAM,yBAAyB,CAAA;AAuBvF,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;GAEG;AACH,SAAS,aAAa,CAAC,KAAuB;IAC5C,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,KAAK,CAAA;IAE/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAmB,CAAA;YAC/C,MAAM,SAAS,GAAG,UAAU,CAAC,UAAoB,CAAA;YACjD,MAAM,SAAS,GAAG,UAAU,CAAC,UAAoB,CAAA;YAEjD,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAA;YAE1B,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAC3B,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAC5E,CAAA;YAED,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,MAAM;gBACZ,YAAY;gBACZ,OAAO,EAAE,UAAU,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;aAC/C,CAAA;QACH,CAAC;QAED,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAmB,CAAA;YAC/C,MAAM,OAAO,GAAG,UAAU,CAAC,OAAiB,CAAA;YAE5C,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAA;YAE1B,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,OAAO;gBACb,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;gBAC9C,OAAO,EAAE,WAAW,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;aAChD,CAAA;QACH,CAAC;QAED;YACE,OAAO,IAAI,CAAA;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAC1B,MAAoB,EACpB,MAAoB;IAEpB,wCAAwC;IACxC,IAAI,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACjE,OAAO,IAAI,CAAA;IACb,CAAC;IAED,8BAA8B;IAC9B,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;QACpF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,4BAA4B;IAC5B,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,QAAgB,EAAE,OAAiB;IACxD,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAA;IAExC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC7C,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;YAClD,OAAO,MAAM,CAAA;QACf,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,IAAI,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,QAAQ,CAAA;IACnD,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAA;IAChF,IAAI,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,YAAY,CAAA;IAC3D,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,OAAO,CAAA;IAEjD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,MAAM,OAAO,eAAe;IAClB,MAAM,GAAwB,IAAI,CAAA;IAClC,WAAW,GAAkB,IAAI,CAAA;IACjC,MAAM,GAA+B,IAAI,CAAA;IACzC,cAAc,GAAmB,EAAE,CAAA;IAE3C;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,WAAoB;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,IAAI,MAAM,cAAc,EAAE,CAAA;QACxD,IAAI,CAAC,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAEhD,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;YACrC,OAAO,CAAC,IAAI,CAAC,iEAAiE,CAAC,CAAA;QACjF,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,KAAuB;QACnC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;QACnB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAO,CAAA;QAE3B,iCAAiC;QACjC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YAC/B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;QAC5B,CAAC;QAED,qBAAqB;QACrB,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;QAEnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;QAC5B,CAAC;QAED,oBAAoB;QACpB,IAAI,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;QAC5B,CAAC;QAED,mBAAmB;QACnB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAEhC,uBAAuB;QACvB,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;YACzC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;QAC5B,CAAC;QAED,4BAA4B;QAC5B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAA;QAChE,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;IAC5B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CACxB,MAAoB,EACpB,MAAoB;QAEpB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;QAEzD,MAAM,OAAO,GAAkB;YAC7B,KAAK,EAAE,MAAM,CAAC,OAAO,IAAI,aAAa,MAAM,CAAC,IAAI,EAAE;YACnD,IAAI,EAAE,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC;YAC5C,MAAM;YACN,MAAM,EAAE,YAAY;YACpB,YAAY,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;SAC5B,CAAA;QAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,mBAAmB;YACnB,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;gBACtC,iBAAiB;gBACjB,MAAM;gBACN,MAAM,CAAC,IAAI;aACZ,CAAC,CAAA;YACF,OAAO,CAAC,GAAG,CAAC,8BAA8B,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;QAC5D,CAAC;aAAM,CAAC;YACN,cAAc;YACd,OAAO,CAAC,GAAG,CAAC,6CAA6C,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;QAC3E,CAAC;IACH,CAAC;IAED;;OAEG;IACK,yBAAyB,CAAC,MAAoB;QACpD,MAAM,KAAK,GAAa,EAAE,CAAA;QAE1B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QACxC,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QAExC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAA;QAC3D,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACd,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;QAEvD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,CAAA;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB;QACxB,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAO,CAAA;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAA;QAEnC,kBAAkB;QAClB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAA;QAClD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;YACzD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;YAC3C,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACrB,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAChC,CAAC;QAED,mBAAmB;QACnB,MAAM,KAAK,GAAa,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAA;QAElD,KAAK,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,IAAI,QAAQ,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,EAAE,CAAC,CAAA;YAC3B,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;YACjE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAChB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,sBAAsB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;QAClD,KAAK,CAAC,IAAI,CAAC,yBAAyB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;QAEpD,MAAM,OAAO,GAAkB;YAC7B,KAAK,EAAE,oBAAoB,OAAO,CAAC,MAAM,UAAU;YACnD,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YACtB,MAAM,EAAE,YAAY;YACpB,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SACvC,CAAA;QAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAA;QAC/D,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;OAEG;IACH,YAAY;QACV,IAAI,CAAC,cAAc,GAAG,EAAE,CAAA;IAC1B,CAAC;CACF;AAED,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAqB,CAAA;IACvD,MAAM,IAAI,GAAG,IAAI,eAAe,EAAE,CAAA;IAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACxC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;AACrC,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjC,IAAI,SAAS,EAAE,CAAC;QACd,kBAAkB,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACpD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAA;IAC5D,CAAC;AACH,CAAC"}

package/dist/hooks/pre-tool-use.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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 type { HookResult, PreToolUseEvent } from '../types/index.js';
+export declare class PreToolUseHook {
+    private config;
+    private projectRoot;
+    /**
+     * Initialize the hook
+     */
+    init(projectRoot?: string): Promise<void>;
+    /**
+     * Execute the hook for a tool call
+     */
+    execute(event: PreToolUseEvent): Promise<HookResult>;
+    /**
+     * Handle Edit/Write tool calls - run guards
+     */
+    private handleFileOperation;
+    /**
+     * Handle Task tool calls - inject knowledge
+     */
+    private handleTaskTool;
+}
+/**
+ * Run hook as standalone script (reads event from stdin)
+ */
+export declare function runPreToolUseHook(): Promise<void>;
+//# sourceMappingURL=pre-tool-use.d.ts.map

package/dist/hooks/pre-tool-use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-tool-use.d.ts","sourceRoot":"","sources":["../../src/hooks/pre-tool-use.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAEV,UAAU,EACV,eAAe,EAMhB,MAAM,mBAAmB,CAAA;AAwQ1B,qBAAa,cAAc;IACzB,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,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAuB1D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiD3B;;OAEG;YACW,cAAc;CA6C7B;AAMD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAuBvD"}