cmp-standards 2.8.0 → 2.9.1

package/dist/hooks/startup-verify.js

@@ -0,0 +1,360 @@
+/**
+ * @file Startup Verification Hook
+ * @description Validates all services and infrastructure on session start
+ *
+ * This hook should run FIRST to verify:
+ * - Environment variables are loaded correctly
+ * - Cloud services are reachable
+ * - Database connections work
+ * - Required configurations exist
+ *
+ * Outputs a clear status report so issues are visible immediately.
+ *
+ * @version 2.9.0
+ */
+import { config as dotenvConfig } from 'dotenv';
+import { resolve } from 'path';
+import { existsSync, readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+// =============================================================================
+// Environment Loading
+// =============================================================================
+/**
+ * Load .env from multiple possible locations (monorepo support)
+ */
+function loadEnvironment(cwd) {
+    const possiblePaths = [
+        resolve(cwd, '.env'),
+        resolve(cwd, '../.env'),
+        resolve(cwd, '../../.env'),
+        resolve(cwd, '../../../.env'),
+    ];
+    for (const envPath of possiblePaths) {
+        if (existsSync(envPath)) {
+            dotenvConfig({ path: envPath, override: true });
+            return { loaded: true, path: envPath };
+        }
+    }
+    // Try default dotenv behavior
+    dotenvConfig();
+    return { loaded: false };
+}
+// =============================================================================
+// Individual Verifications
+// =============================================================================
+function verifyEnvVariable(name, required = true) {
+    const value = process.env[name];
+    if (!value) {
+        return {
+            service: `ENV:${name}`,
+            status: required ? 'error' : 'warn',
+            message: required ? `Missing required variable` : `Optional variable not set`,
+        };
+    }
+    // Mask the value for display
+    const masked = value.length > 8 ? value.slice(0, 4) + '***' + value.slice(-4) : '***';
+    return {
+        service: `ENV:${name}`,
+        status: 'ok',
+        message: `Set (${masked})`,
+    };
+}
+async function verifyTurso() {
+    const url = process.env.TURSO_DATABASE_URL;
+    const token = process.env.TURSO_AUTH_TOKEN;
+    if (!url || !token) {
+        return {
+            service: 'Turso',
+            status: 'error',
+            message: 'Missing credentials',
+            details: `URL: ${url ? 'set' : 'missing'}, Token: ${token ? 'set' : 'missing'}`,
+        };
+    }
+    try {
+        const { createClient } = await import('@libsql/client');
+        const client = createClient({ url, authToken: token });
+        const result = await client.execute('SELECT 1 as test');
+        if (result.rows.length > 0) {
+            return {
+                service: 'Turso',
+                status: 'ok',
+                message: 'Connected and responding',
+            };
+        }
+        return {
+            service: 'Turso',
+            status: 'warn',
+            message: 'Connected but query returned no results',
+        };
+    }
+    catch (error) {
+        return {
+            service: 'Turso',
+            status: 'error',
+            message: 'Connection failed',
+            details: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+async function verifyRedis() {
+    const url = process.env.UPSTASH_REDIS_REST_URL;
+    const token = process.env.UPSTASH_REDIS_REST_TOKEN;
+    if (!url || !token) {
+        return {
+            service: 'Redis',
+            status: 'error',
+            message: 'Missing credentials',
+            details: `URL: ${url ? 'set' : 'missing'}, Token: ${token ? 'set' : 'missing'}`,
+        };
+    }
+    try {
+        const { Redis } = await import('@upstash/redis');
+        const redis = new Redis({ url, token });
+        const pong = await redis.ping();
+        if (pong === 'PONG') {
+            return {
+                service: 'Redis',
+                status: 'ok',
+                message: 'Connected (PONG)',
+            };
+        }
+        return {
+            service: 'Redis',
+            status: 'warn',
+            message: `Unexpected response: ${pong}`,
+        };
+    }
+    catch (error) {
+        return {
+            service: 'Redis',
+            status: 'error',
+            message: 'Connection failed',
+            details: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+async function verifyVector() {
+    const url = process.env.UPSTASH_VECTOR_REST_URL;
+    const token = process.env.UPSTASH_VECTOR_REST_TOKEN;
+    if (!url || !token) {
+        return {
+            service: 'Vector',
+            status: 'warn',
+            message: 'Not configured (optional)',
+            details: `URL: ${url ? 'set' : 'missing'}, Token: ${token ? 'set' : 'missing'}`,
+        };
+    }
+    try {
+        const { Index } = await import('@upstash/vector');
+        const index = new Index({ url, token });
+        const info = await index.info();
+        return {
+            service: 'Vector',
+            status: 'ok',
+            message: `Connected (${info.vectorCount ?? 0} vectors)`,
+        };
+    }
+    catch (error) {
+        return {
+            service: 'Vector',
+            status: 'warn',
+            message: 'Connection failed (optional service)',
+            details: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+function verifyProjectConfig(cwd) {
+    const configPath = resolve(cwd, '.claude/project.config.json');
+    if (!existsSync(configPath)) {
+        return {
+            service: 'Project Config',
+            status: 'warn',
+            message: 'Not found (.claude/project.config.json)',
+            details: 'Run: npx cmp-standards init --system YOUR_SYSTEM',
+        };
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        if (!config.system) {
+            return {
+                service: 'Project Config',
+                status: 'warn',
+                message: 'Missing system identifier',
+            };
+        }
+        return {
+            service: 'Project Config',
+            status: 'ok',
+            message: `System: ${config.system}`,
+        };
+    }
+    catch (error) {
+        return {
+            service: 'Project Config',
+            status: 'error',
+            message: 'Invalid JSON',
+            details: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+function verifyHooksDirectory(cwd) {
+    const hooksPath = resolve(cwd, '.claude/hooks');
+    if (!existsSync(hooksPath)) {
+        return {
+            service: 'Hooks Directory',
+            status: 'warn',
+            message: 'Not found (.claude/hooks)',
+            details: 'Run: npx cmp-standards sync --hooks',
+        };
+    }
+    return {
+        service: 'Hooks Directory',
+        status: 'ok',
+        message: 'Exists',
+    };
+}
+// =============================================================================
+// Main Verification Function
+// =============================================================================
+export async function verifyStartup(cwd) {
+    const timestamp = new Date().toISOString();
+    const results = [];
+    const issues = [];
+    const recommendations = [];
+    // 1. Load environment
+    const envResult = loadEnvironment(cwd);
+    results.push({
+        service: 'Environment',
+        status: envResult.loaded ? 'ok' : 'warn',
+        message: envResult.loaded ? `Loaded from ${envResult.path}` : 'Using process.env only',
+    });
+    // 2. Check required env vars
+    const requiredVars = ['TURSO_DATABASE_URL', 'TURSO_AUTH_TOKEN'];
+    const optionalVars = ['UPSTASH_REDIS_REST_URL', 'UPSTASH_REDIS_REST_TOKEN', 'UPSTASH_VECTOR_REST_URL', 'UPSTASH_VECTOR_REST_TOKEN'];
+    for (const varName of requiredVars) {
+        results.push(verifyEnvVariable(varName, true));
+    }
+    for (const varName of optionalVars) {
+        results.push(verifyEnvVariable(varName, false));
+    }
+    // 3. Check cloud services
+    const [tursoResult, redisResult, vectorResult] = await Promise.all([
+        verifyTurso(),
+        verifyRedis(),
+        verifyVector(),
+    ]);
+    results.push(tursoResult, redisResult, vectorResult);
+    // 4. Check project configuration
+    results.push(verifyProjectConfig(cwd));
+    results.push(verifyHooksDirectory(cwd));
+    // Analyze results
+    const errors = results.filter(r => r.status === 'error');
+    const warnings = results.filter(r => r.status === 'warn');
+    for (const err of errors) {
+        issues.push(`${err.service}: ${err.message}${err.details ? ` (${err.details})` : ''}`);
+    }
+    // Generate recommendations
+    if (errors.some(e => e.service.includes('TURSO'))) {
+        recommendations.push('Set TURSO_DATABASE_URL and TURSO_AUTH_TOKEN in your .env file');
+    }
+    if (errors.some(e => e.service === 'Turso')) {
+        recommendations.push('Check Turso credentials at https://turso.tech/app');
+    }
+    if (errors.some(e => e.service === 'Redis')) {
+        recommendations.push('Check Upstash Redis credentials at https://console.upstash.com');
+    }
+    if (warnings.some(w => w.service === 'Project Config')) {
+        recommendations.push('Run: npx cmp-standards init --system YOUR_SYSTEM');
+    }
+    // Determine overall status
+    let overallStatus = 'healthy';
+    if (warnings.length > 0)
+        overallStatus = 'degraded';
+    if (errors.length > 0)
+        overallStatus = 'critical';
+    return {
+        timestamp,
+        cwd,
+        results,
+        overallStatus,
+        issues,
+        recommendations,
+    };
+}
+// =============================================================================
+// Output Formatting
+// =============================================================================
+function formatReport(report) {
+    const lines = [];
+    // Header
+    const statusIcon = {
+        healthy: '\u2705', // green check
+        degraded: '\u26A0\uFE0F', // warning
+        critical: '\u274C', // red X
+    }[report.overallStatus];
+    lines.push('');
+    lines.push(`${statusIcon} CMP Standards Startup Verification`);
+    lines.push(`${'='.repeat(50)}`);
+    lines.push(`Status: ${report.overallStatus.toUpperCase()}`);
+    lines.push(`Time: ${report.timestamp}`);
+    lines.push(`Directory: ${report.cwd}`);
+    lines.push('');
+    // Service Status
+    lines.push('Service Status:');
+    lines.push('-'.repeat(30));
+    for (const result of report.results) {
+        const icon = result.status === 'ok' ? '\u2705' : result.status === 'warn' ? '\u26A0\uFE0F' : '\u274C';
+        lines.push(`${icon} ${result.service}: ${result.message}`);
+        if (result.details && result.status !== 'ok') {
+            lines.push(`   \u2514\u2500 ${result.details}`);
+        }
+    }
+    // Issues
+    if (report.issues.length > 0) {
+        lines.push('');
+        lines.push('Issues Found:');
+        lines.push('-'.repeat(30));
+        for (const issue of report.issues) {
+            lines.push(`\u2022 ${issue}`);
+        }
+    }
+    // Recommendations
+    if (report.recommendations.length > 0) {
+        lines.push('');
+        lines.push('Recommendations:');
+        lines.push('-'.repeat(30));
+        for (const rec of report.recommendations) {
+            lines.push(`\u27A4 ${rec}`);
+        }
+    }
+    lines.push('');
+    lines.push(`${'='.repeat(50)}`);
+    lines.push('');
+    return lines.join('\n');
+}
+// =============================================================================
+// CLI Entry Point
+// =============================================================================
+async function main() {
+    const cwd = process.cwd();
+    try {
+        const report = await verifyStartup(cwd);
+        console.log(formatReport(report));
+        // Exit with error code if critical
+        if (report.overallStatus === 'critical') {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error('Startup verification failed:', error);
+        process.exit(1);
+    }
+}
+// Run if executed directly
+const __filename = fileURLToPath(import.meta.url);
+if (process.argv[1] === __filename || process.argv[1]?.includes('startup-verify')) {
+    main();
+}
+export default verifyStartup;
+//# sourceMappingURL=startup-verify.js.map

package/dist/hooks/startup-verify.js.map

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

package/dist/mcp/schemas.d.ts

@@ -139,12 +139,12 @@ export declare const FeedbackSubmitSchema: z.ZodObject<{
     helpful: z.ZodBoolean;
     comment: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    memoryId: string;
     helpful: boolean;
+    memoryId: string;
     comment?: string | undefined;
 }, {
-    memoryId: string;
     helpful: boolean;
+    memoryId: string;
     comment?: string | undefined;
 }>;
 export declare const TaskStartSchema: z.ZodObject<{

package/dist/performance/Debouncer.d.ts

@@ -23,6 +23,19 @@ export interface DebouncerStats {
     skipRate: number;
     activeEntries: number;
 }
+/**
+ * Tool-specific debounce windows
+ * Different tools have different optimal debounce times
+ */
+export declare const TOOL_DEBOUNCE_CONFIG: Record<string, number>;
+/**
+ * Get debounce window for a specific tool
+ */
+export declare function getToolDebounceMs(toolName: string): number;
+/**
+ * Check if a tool should never be debounced (write operations)
+ */
+export declare function isWriteOperation(toolName: string): boolean;
 export declare class Debouncer {
     private config;
     private entries;
@@ -84,8 +97,52 @@ export declare class HookDebouncer extends Debouncer {
     constructor(config?: Partial<DebouncerConfig>);
     shouldSkipHook(hookName: string, context: Record<string, unknown>): boolean;
 }
+/**
+ * Smart Debouncer with tool-specific windows
+ * Uses different debounce times based on tool type
+ */
+export declare class SmartDebouncer {
+    private entries;
+    private maxEntries;
+    private debug;
+    private stats;
+    constructor(options?: {
+        maxEntries?: number;
+        debug?: boolean;
+    });
+    /**
+     * Check if operation should be skipped based on tool-specific window
+     */
+    shouldSkip(toolName: string, params: Record<string, unknown>): boolean;
+    private trackCall;
+    /**
+     * Cleanup old entries (uses longest debounce window)
+     */
+    cleanup(): number;
+    /**
+     * Get statistics including per-tool breakdown
+     */
+    getStats(): {
+        totalCalls: number;
+        skipped: number;
+        skipRate: number;
+        byTool: Record<string, {
+            total: number;
+            skipped: number;
+            skipRate: number;
+        }>;
+    };
+    /**
+     * Reset all state
+     */
+    reset(): void;
+}
 export declare function getDebouncer(config?: Partial<DebouncerConfig>): Debouncer;
 export declare function getEmbeddingDebouncer(config?: Partial<DebouncerConfig>): EmbeddingDebouncer;
 export declare function getHookDebouncer(config?: Partial<DebouncerConfig>): HookDebouncer;
+export declare function getSmartDebouncer(options?: {
+    maxEntries?: number;
+    debug?: boolean;
+}): SmartDebouncer;
 export declare function resetDebouncers(): void;
 //# sourceMappingURL=Debouncer.d.ts.map

package/dist/performance/Debouncer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Debouncer.d.ts","sourceRoot":"","sources":["../../src/performance/Debouncer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,2BAA2B;IAC3B,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;CACtB;AAiBD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,KAAK,CAGZ;gBAEW,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAIjD;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IA4BhC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAMpE;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAK/E;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO;IAM1C;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,OAAO,IAAI,MAAM;IAkBjB;;OAEG;IACH,QAAQ,IAAI,cAAc;IAY1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,SAAS,IAAI,eAAe;IAI5B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;CAGlD;AAMD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAQjD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAIxC;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAQjD,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;CAI5E;AAUD,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,CAKzE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,kBAAkB,CAK3F;AAED,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,aAAa,CAKjF;AAED,wBAAgB,eAAe,IAAI,IAAI,CAItC"}
+{"version":3,"file":"Debouncer.d.ts","sourceRoot":"","sources":["../../src/performance/Debouncer.ts"],"names":[],"mappings":"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"}

package/dist/performance/Debouncer.js

@@ -15,6 +15,45 @@ const DEFAULT_CONFIG = {
     debug: false,
 };
 // =============================================================================
+// Smart Debouncing by Tool Type
+// =============================================================================
+/**
+ * Tool-specific debounce windows
+ * Different tools have different optimal debounce times
+ */
+export const TOOL_DEBOUNCE_CONFIG = {
+    // Read operations - frequent, short debounce
+    'Read': 1000,
+    'Glob': 2000,
+    'Grep': 2000,
+    'LSP': 1000,
+    // Write operations - no debounce (always execute)
+    'Write': 0,
+    'Edit': 0,
+    'NotebookEdit': 0,
+    // External operations - longer debounce
+    'WebSearch': 5000,
+    'WebFetch': 5000,
+    'Bash': 3000,
+    // Task/Agent operations - medium debounce
+    'Task': 3000,
+    'Skill': 2000,
+    // Default for unknown tools
+    'default': 3000
+};
+/**
+ * Get debounce window for a specific tool
+ */
+export function getToolDebounceMs(toolName) {
+    return TOOL_DEBOUNCE_CONFIG[toolName] ?? TOOL_DEBOUNCE_CONFIG['default'];
+}
+/**
+ * Check if a tool should never be debounced (write operations)
+ */
+export function isWriteOperation(toolName) {
+    return ['Write', 'Edit', 'NotebookEdit'].includes(toolName);
+}
+// =============================================================================
 // Debouncer Implementation
 // =============================================================================
 export class Debouncer {
@@ -166,12 +205,115 @@ export class HookDebouncer extends Debouncer {
         return this.shouldSkip(`hook:${key}`);
     }
 }
+/**
+ * Smart Debouncer with tool-specific windows
+ * Uses different debounce times based on tool type
+ */
+export class SmartDebouncer {
+    entries = new Map();
+    maxEntries;
+    debug;
+    stats = {
+        totalCalls: 0,
+        skipped: 0,
+        byTool: new Map()
+    };
+    constructor(options = {}) {
+        this.maxEntries = options.maxEntries ?? 500;
+        this.debug = options.debug ?? false;
+    }
+    /**
+     * Check if operation should be skipped based on tool-specific window
+     */
+    shouldSkip(toolName, params) {
+        const debounceMs = getToolDebounceMs(toolName);
+        // Write operations are never debounced
+        if (debounceMs === 0) {
+            this.trackCall(toolName, false);
+            return false;
+        }
+        this.stats.totalCalls++;
+        const now = Date.now();
+        const paramsStr = JSON.stringify(params, Object.keys(params).sort());
+        const key = createHash('md5').update(`${toolName}:${paramsStr}`).digest('hex');
+        const entry = this.entries.get(key);
+        if (entry && now - entry.lastCall < debounceMs) {
+            this.stats.skipped++;
+            entry.callCount++;
+            this.trackCall(toolName, true);
+            if (this.debug) {
+                console.log(`[SmartDebouncer] Skipping ${toolName} (window: ${debounceMs}ms, called ${entry.callCount}x)`);
+            }
+            return true;
+        }
+        // Update or create entry
+        this.entries.set(key, { lastCall: now, callCount: 1 });
+        // Cleanup if needed
+        if (this.entries.size > this.maxEntries) {
+            this.cleanup();
+        }
+        this.trackCall(toolName, false);
+        return false;
+    }
+    trackCall(toolName, skipped) {
+        const existing = this.stats.byTool.get(toolName) ?? { total: 0, skipped: 0 };
+        existing.total++;
+        if (skipped)
+            existing.skipped++;
+        this.stats.byTool.set(toolName, existing);
+    }
+    /**
+     * Cleanup old entries (uses longest debounce window)
+     */
+    cleanup() {
+        const now = Date.now();
+        const maxWindow = Math.max(...Object.values(TOOL_DEBOUNCE_CONFIG));
+        let removed = 0;
+        for (const [key, entry] of this.entries) {
+            if (now - entry.lastCall > maxWindow) {
+                this.entries.delete(key);
+                removed++;
+            }
+        }
+        return removed;
+    }
+    /**
+     * Get statistics including per-tool breakdown
+     */
+    getStats() {
+        const byTool = {};
+        for (const [tool, stats] of this.stats.byTool) {
+            byTool[tool] = {
+                ...stats,
+                skipRate: stats.total > 0 ? stats.skipped / stats.total : 0
+            };
+        }
+        return {
+            totalCalls: this.stats.totalCalls,
+            skipped: this.stats.skipped,
+            skipRate: this.stats.totalCalls > 0 ? this.stats.skipped / this.stats.totalCalls : 0,
+            byTool
+        };
+    }
+    /**
+     * Reset all state
+     */
+    reset() {
+        this.entries.clear();
+        this.stats = {
+            totalCalls: 0,
+            skipped: 0,
+            byTool: new Map()
+        };
+    }
+}
 // =============================================================================
 // Singleton Instances
 // =============================================================================
 let globalDebouncer = null;
 let globalEmbeddingDebouncer = null;
 let globalHookDebouncer = null;
+let globalSmartDebouncer = null;
 export function getDebouncer(config) {
     if (!globalDebouncer) {
         globalDebouncer = new Debouncer(config);
@@ -190,9 +332,16 @@ export function getHookDebouncer(config) {
     }
     return globalHookDebouncer;
 }
+export function getSmartDebouncer(options) {
+    if (!globalSmartDebouncer) {
+        globalSmartDebouncer = new SmartDebouncer(options);
+    }
+    return globalSmartDebouncer;
+}
 export function resetDebouncers() {
     globalDebouncer = null;
     globalEmbeddingDebouncer = null;
     globalHookDebouncer = null;
+    globalSmartDebouncer = null;
 }
 //# sourceMappingURL=Debouncer.js.map