cmp-standards 2.8.1 → 2.9.1

package/dist/services/GitIntegration.js

@@ -0,0 +1,423 @@
+/**
+ * Git Integration Service
+ *
+ * Provides Git integration for memory system:
+ * - Auto-commit memory changes
+ * - Export memories as Git-tracked files
+ * - Sync with remote repositories
+ * - Version history via Git
+ *
+ * @version 2.9.0
+ */
+import { simpleGit } from 'simple-git';
+import path from 'path';
+import fs from 'fs/promises';
+// =============================================================================
+// Git Integration Service
+// =============================================================================
+export class GitIntegrationService {
+    git;
+    config;
+    system;
+    pendingChanges = new Map();
+    commitTimer;
+    initialized = false;
+    constructor(options) {
+        this.system = options.system;
+        this.config = {
+            enabled: options.config.enabled ?? true,
+            repoPath: options.config.repoPath ?? process.cwd(),
+            memoriesDir: options.config.memoriesDir ?? '.memories',
+            branch: options.config.branch,
+            remote: options.config.remote ?? 'origin',
+            autoCommit: options.config.autoCommit ?? false,
+            autoCommitInterval: options.config.autoCommitInterval ?? 300000, // 5 minutes
+            commitPrefix: options.config.commitPrefix ?? '[memory]',
+            author: options.config.author,
+        };
+        this.git = simpleGit(this.config.repoPath);
+    }
+    /**
+     * Initialize the Git integration
+     */
+    async init() {
+        if (!this.config.enabled)
+            return false;
+        try {
+            // Check if it's a git repo
+            const isRepo = await this.git.checkIsRepo();
+            if (!isRepo) {
+                console.warn('[GitIntegration] Not a git repository');
+                return false;
+            }
+            // Create memories directory if it doesn't exist
+            const memoriesPath = path.join(this.config.repoPath, this.config.memoriesDir);
+            await fs.mkdir(memoriesPath, { recursive: true });
+            // Add .gitkeep
+            const gitkeepPath = path.join(memoriesPath, '.gitkeep');
+            try {
+                await fs.access(gitkeepPath);
+            }
+            catch {
+                await fs.writeFile(gitkeepPath, '');
+            }
+            // Start auto-commit timer if enabled
+            if (this.config.autoCommit) {
+                this.startAutoCommit();
+            }
+            this.initialized = true;
+            return true;
+        }
+        catch (error) {
+            console.error('[GitIntegration] Init failed:', error);
+            return false;
+        }
+    }
+    /**
+     * Save a memory to file and stage for commit
+     */
+    async saveMemory(memoryId, content, options) {
+        if (!this.initialized)
+            return false;
+        try {
+            const filePath = this.getMemoryFilePath(memoryId, content.domain);
+            const fileContent = this.formatMemoryFile(memoryId, content);
+            await fs.mkdir(path.dirname(filePath), { recursive: true });
+            await fs.writeFile(filePath, fileContent, 'utf-8');
+            // Stage the file
+            await this.git.add(filePath);
+            // Track for batch commit
+            this.pendingChanges.set(memoryId, content);
+            // Commit immediately if requested
+            if (options?.immediate) {
+                await this.commit(`Add memory: ${content.title}`);
+            }
+            return true;
+        }
+        catch (error) {
+            console.error('[GitIntegration] Save failed:', error);
+            return false;
+        }
+    }
+    /**
+     * Delete a memory file and stage for commit
+     */
+    async deleteMemory(memoryId, domain, options) {
+        if (!this.initialized)
+            return false;
+        try {
+            const filePath = this.getMemoryFilePath(memoryId, domain);
+            try {
+                await fs.unlink(filePath);
+                await this.git.add(filePath);
+            }
+            catch {
+                // File doesn't exist, that's fine
+            }
+            // Track deletion
+            this.pendingChanges.delete(memoryId);
+            if (options?.immediate) {
+                await this.commit(`Delete memory: ${memoryId}`);
+            }
+            return true;
+        }
+        catch (error) {
+            console.error('[GitIntegration] Delete failed:', error);
+            return false;
+        }
+    }
+    /**
+     * Commit pending changes
+     */
+    async commit(message) {
+        if (!this.initialized) {
+            return { success: false, message: 'Not initialized', error: 'Git integration not initialized' };
+        }
+        try {
+            const status = await this.git.status();
+            if (!this.hasChanges(status)) {
+                return { success: true, message: 'No changes to commit', filesChanged: 0 };
+            }
+            const commitMessage = this.formatCommitMessage(message, status);
+            // Use raw command for author option
+            let result;
+            if (this.config.author) {
+                result = await this.git.raw([
+                    'commit',
+                    '-m', commitMessage,
+                    '--author', `${this.config.author.name} <${this.config.author.email}>`
+                ]);
+            }
+            else {
+                result = await this.git.commit(commitMessage);
+            }
+            // Get the commit hash from the result
+            const commitMatch = typeof result === 'string'
+                ? result.match(/\[[\w\s]+\s([a-f0-9]+)\]/)
+                : null;
+            // Clear pending changes
+            this.pendingChanges.clear();
+            const commitHash = commitMatch?.[1] ??
+                (typeof result === 'object' && 'commit' in result ? result.commit : undefined);
+            return {
+                success: true,
+                commitHash,
+                message: commitMessage,
+                filesChanged: status.files.length,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { success: false, message: 'Commit failed', error: errorMessage };
+        }
+    }
+    /**
+     * Push changes to remote
+     */
+    async push() {
+        if (!this.initialized) {
+            return { success: false, error: 'Not initialized' };
+        }
+        try {
+            const branch = this.config.branch ?? (await this.git.branch()).current;
+            await this.git.push(this.config.remote, branch);
+            return { success: true, pushed: 1 };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { success: false, error: errorMessage };
+        }
+    }
+    /**
+     * Pull changes from remote
+     */
+    async pull() {
+        if (!this.initialized) {
+            return { success: false, error: 'Not initialized' };
+        }
+        try {
+            const branch = this.config.branch ?? (await this.git.branch()).current;
+            const result = await this.git.pull(this.config.remote, branch);
+            return {
+                success: true,
+                pulled: result.summary.changes,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { success: false, error: errorMessage };
+        }
+    }
+    /**
+     * Get current status
+     */
+    async getStatus() {
+        return this.git.status();
+    }
+    /**
+     * Get commit history for memories
+     */
+    async getHistory(limit = 20) {
+        try {
+            const log = await this.git.log({
+                maxCount: limit,
+                '--': [this.config.memoriesDir],
+            });
+            return log.all.map(entry => ({
+                hash: entry.hash,
+                date: entry.date,
+                message: entry.message,
+                author: entry.author_name,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Export all memories from database to files
+     */
+    async exportAll(memories) {
+        let exported = 0;
+        let failed = 0;
+        for (const memory of memories) {
+            const success = await this.saveMemory(memory.id, memory.content);
+            if (success) {
+                exported++;
+            }
+            else {
+                failed++;
+            }
+        }
+        // Commit all changes
+        if (exported > 0) {
+            await this.commit(`Export ${exported} memories`);
+        }
+        return { exported, failed };
+    }
+    /**
+     * Import memories from files
+     */
+    async importAll() {
+        const memories = [];
+        const memoriesPath = path.join(this.config.repoPath, this.config.memoriesDir);
+        try {
+            const files = await this.findMemoryFiles(memoriesPath);
+            for (const file of files) {
+                try {
+                    const content = await fs.readFile(file, 'utf-8');
+                    const memory = this.parseMemoryFile(content);
+                    if (memory) {
+                        memories.push(memory);
+                    }
+                }
+                catch {
+                    console.warn(`[GitIntegration] Failed to parse: ${file}`);
+                }
+            }
+        }
+        catch {
+            // Memories directory doesn't exist
+        }
+        return memories;
+    }
+    /**
+     * Stop auto-commit and cleanup
+     */
+    stop() {
+        if (this.commitTimer) {
+            clearInterval(this.commitTimer);
+            this.commitTimer = undefined;
+        }
+    }
+    // ==========================================================================
+    // Private Methods
+    // ==========================================================================
+    startAutoCommit() {
+        if (this.commitTimer) {
+            clearInterval(this.commitTimer);
+        }
+        this.commitTimer = setInterval(async () => {
+            if (this.pendingChanges.size > 0) {
+                await this.commit();
+            }
+        }, this.config.autoCommitInterval);
+    }
+    getMemoryFilePath(memoryId, domain) {
+        const domainDir = domain ?? 'general';
+        const fileName = `${memoryId}.md`;
+        return path.join(this.config.repoPath, this.config.memoriesDir, domainDir, fileName);
+    }
+    formatMemoryFile(memoryId, content) {
+        const now = new Date().toISOString();
+        const frontmatter = {
+            id: memoryId,
+            title: content.title,
+            domain: content.domain ?? 'general',
+            source: content.source ?? 'system',
+            createdAt: now,
+            updatedAt: now,
+        };
+        const yaml = Object.entries(frontmatter)
+            .map(([k, v]) => `${k}: ${JSON.stringify(v)}`)
+            .join('\n');
+        return `---
+${yaml}
+---
+
+# ${content.title}
+
+${content.body ?? ''}
+
+${content.relatedFiles?.length ? `\n## Related Files\n\n${content.relatedFiles.map(f => `- ${f}`).join('\n')}` : ''}
+`;
+    }
+    parseMemoryFile(content) {
+        const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+        if (!match)
+            return null;
+        try {
+            const [, frontmatter, body] = match;
+            const metadata = {};
+            // Parse YAML-like frontmatter
+            for (const line of frontmatter.split('\n')) {
+                const colonIdx = line.indexOf(':');
+                if (colonIdx > 0) {
+                    const key = line.slice(0, colonIdx).trim();
+                    const value = line.slice(colonIdx + 1).trim();
+                    try {
+                        metadata[key] = JSON.parse(value);
+                    }
+                    catch {
+                        metadata[key] = value;
+                    }
+                }
+            }
+            return {
+                id: String(metadata.id ?? ''),
+                title: String(metadata.title ?? ''),
+                body: body.trim(),
+                domain: metadata.domain,
+                source: metadata.source,
+                createdAt: String(metadata.createdAt ?? ''),
+                updatedAt: String(metadata.updatedAt ?? ''),
+                metadata,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    async findMemoryFiles(dir) {
+        const files = [];
+        try {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    const subFiles = await this.findMemoryFiles(fullPath);
+                    files.push(...subFiles);
+                }
+                else if (entry.name.endsWith('.md')) {
+                    files.push(fullPath);
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist
+        }
+        return files;
+    }
+    hasChanges(status) {
+        return status.files.length > 0;
+    }
+    formatCommitMessage(message, status) {
+        const prefix = this.config.commitPrefix;
+        const changes = status.files.length;
+        const defaultMsg = `Update ${changes} memory file${changes !== 1 ? 's' : ''}`;
+        return `${prefix} ${message ?? defaultMsg}`;
+    }
+}
+// =============================================================================
+// Singleton Instance
+// =============================================================================
+let instance = null;
+export function getGitIntegration(system = 'ECOSYSTEM', config) {
+    if (!instance) {
+        instance = new GitIntegrationService({ system, config: config ?? {} });
+    }
+    return instance;
+}
+export function resetGitIntegration() {
+    if (instance) {
+        instance.stop();
+        instance = null;
+    }
+}
+/**
+ * Create a new Git integration with custom config
+ */
+export function createGitIntegration(options) {
+    return new GitIntegrationService(options);
+}
+//# sourceMappingURL=GitIntegration.js.map

package/dist/services/GitIntegration.js.map

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

package/dist/services/HookVerifier.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Hook Verifier Service
+ *
+ * Validates and auto-fixes Claude Code hook configurations:
+ * - Checks if hooks are properly configured in .claude/settings.json
+ * - Verifies hook files exist and have proper CLI entry points
+ * - Auto-fixes misconfigured hooks
+ * - Can run automatically on startup or via CLI
+ *
+ * @version 2.9.0
+ */
+export interface HookConfig {
+    type: 'command';
+    command: string;
+}
+export interface ClaudeSettings {
+    hooks?: {
+        PreToolUse?: HookConfig[];
+        PostToolUse?: HookConfig[];
+        Notification?: HookConfig[];
+        Stop?: HookConfig[];
+        SubagentStop?: HookConfig[];
+    };
+    permissions?: {
+        allow?: string[];
+        deny?: string[];
+    };
+}
+export interface HookVerificationResult {
+    hookPath: string;
+    hookType: string;
+    status: 'valid' | 'missing_file' | 'missing_entry_point' | 'invalid_syntax' | 'missing_shebang';
+    message: string;
+    autoFixable: boolean;
+    fixed?: boolean;
+}
+export interface VerificationReport {
+    projectPath: string;
+    settingsPath: string;
+    settingsExists: boolean;
+    hooksConfigured: number;
+    results: HookVerificationResult[];
+    errors: string[];
+    warnings: string[];
+    allValid: boolean;
+    fixedCount: number;
+}
+export declare class HookVerifierService {
+    private projectPath;
+    constructor(projectPath?: string);
+    /**
+     * Verify all hooks in the project
+     */
+    verify(autoFix?: boolean): Promise<VerificationReport>;
+    /**
+     * Verify a single hook configuration
+     */
+    private verifyHook;
+    /**
+     * Extract hook file path from command
+     */
+    private extractHookPath;
+    /**
+     * Check if the file has a valid CLI entry point
+     */
+    private hasValidEntryPoint;
+    /**
+     * Attempt to fix a hook issue
+     */
+    private fixHook;
+    /**
+     * Fix missing entry point by adding CLI execution code
+     */
+    private fixMissingEntryPoint;
+    /**
+     * Fix missing shebang in shell script
+     */
+    private fixMissingShebang;
+    /**
+     * Generate hook template
+     */
+    static generateHookTemplate(hookType: string, language?: 'ts' | 'js' | 'sh'): string;
+    /**
+     * Create a new hook file with proper structure
+     */
+    createHook(hookType: string, fileName: string, language?: 'ts' | 'js' | 'sh'): Promise<string>;
+    /**
+     * Add hook to settings.json
+     */
+    addHookToSettings(hookType: 'PreToolUse' | 'PostToolUse' | 'Notification' | 'Stop' | 'SubagentStop', command: string): Promise<void>;
+}
+export declare function formatVerificationReport(report: VerificationReport): string;
+export declare function getHookVerifier(projectPath?: string): HookVerifierService;
+export declare function resetHookVerifier(): void;
+//# sourceMappingURL=HookVerifier.d.ts.map

package/dist/services/HookVerifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HookVerifier.d.ts","sourceRoot":"","sources":["../../src/services/HookVerifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,UAAU,EAAE,CAAA;QACzB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;QAC1B,YAAY,CAAC,EAAE,UAAU,EAAE,CAAA;QAC3B,IAAI,CAAC,EAAE,UAAU,EAAE,CAAA;QACnB,YAAY,CAAC,EAAE,UAAU,EAAE,CAAA;KAC5B,CAAA;IACD,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAChB,CAAA;CACF;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,OAAO,GAAG,cAAc,GAAG,qBAAqB,GAAG,gBAAgB,GAAG,iBAAiB,CAAA;IAC/F,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,OAAO,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,OAAO,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE,sBAAsB,EAAE,CAAA;IACjC,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAMD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,WAAW,CAAQ;gBAEf,WAAW,CAAC,EAAE,MAAM;IAIhC;;OAEG;IACG,MAAM,CAAC,OAAO,GAAE,OAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqEnE;;OAEG;YACW,UAAU;IA6ExB;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoD1B;;OAEG;YACW,OAAO;IAqBrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyC5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,IAAI,GAAG,IAAI,GAAG,IAAW,GAAG,MAAM;IAsE1F;;OAEG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,IAAI,GAAG,IAAI,GAAG,IAAW,GAClC,OAAO,CAAC,MAAM,CAAC;IA0BlB;;OAEG;IACG,iBAAiB,CACrB,QAAQ,EAAE,YAAY,GAAG,aAAa,GAAG,cAAc,GAAG,MAAM,GAAG,cAAc,EACjF,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;CAsCjB;AAMD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAuD3E;AAQD,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAKzE;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}