@hongmaple0820/scale-engine 0.40.2 → 0.44.0

package/dist/cortex/GovernanceMetrics.js

@@ -0,0 +1,230 @@
+// SCALE Cortex — Governance ROI Metrics
+// 对齐 ECC: multi-hook governance ROI measurement
+// Tracks: gate pass rates, token costs, instinct hit rate, auto-fix success, savings
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../core/logger.js';
+// ---------------------------------------------------------------------------
+// GovernanceMetricsCalculator
+// ---------------------------------------------------------------------------
+export class GovernanceMetricsCalculator {
+    constructor(scaleDir = join(process.cwd(), '.scale')) {
+        this.scaleDir = scaleDir;
+    }
+    /**
+     * Compute full governance metrics from observation logs and instinct store.
+     */
+    compute(instincts, lookbackDays = 30) {
+        const observations = this.loadObservations(lookbackDays);
+        const prevObservations = this.loadObservationsRange(lookbackDays, lookbackDays * 2);
+        // Gates
+        const gateMetrics = this.computeGateMetrics(observations);
+        // Instincts
+        const instinctMetrics = this.computeInstinctMetrics(instincts);
+        // Cost
+        const cost = this.computeCostMetrics(observations, instinctMetrics);
+        // Auto-fix
+        const autoFix = this.computeAutoFixMetrics(observations);
+        // Trends
+        const trends = this.computeTrends(observations, prevObservations, instinctMetrics);
+        return {
+            gates: gateMetrics,
+            instincts: instinctMetrics,
+            cost,
+            autoFix,
+            trends,
+            period: {
+                start: new Date(Date.now() - lookbackDays * 86400000).toISOString().slice(0, 10),
+                end: new Date().toISOString().slice(0, 10),
+            },
+        };
+    }
+    /**
+     * Render metrics as a terminal report.
+     */
+    render(metrics) {
+        const pct = (n) => `${(n * 100).toFixed(1)}%`;
+        const usd = (n) => `$${n.toFixed(2)}`;
+        return [
+            'SCALE Cortex — Governance ROI Report',
+            `Period: ${metrics.period.start} → ${metrics.period.end}`,
+            '',
+            '═══ Gate Performance ═══',
+            `  Total runs:    ${metrics.gates.totalRuns}`,
+            `  Pass rate:     ${pct(metrics.gates.passRate)}`,
+            `  Fail rate:     ${pct(metrics.gates.failRate)}`,
+            `  Avg duration:  ${metrics.gates.avgDurationMs}ms`,
+            '',
+            '═══ Instinct Performance ═══',
+            `  Extracted:     ${metrics.instincts.totalExtracted}`,
+            `  Injected:      ${metrics.instincts.totalInjected}`,
+            `  Applied:       ${metrics.instincts.totalApplied}`,
+            `  Hit rate:      ${pct(metrics.instincts.hitRate)}`,
+            '',
+            '═══ Cost Analysis ═══',
+            `  Total tokens:  ${metrics.cost.totalTokens.toLocaleString()}`,
+            `  Total cost:    ${usd(metrics.cost.totalCost)}`,
+            `  Avg token/gate: ${Math.round(metrics.cost.avgTokensPerGate).toLocaleString()}`,
+            `  Saved (cache):  ${usd(metrics.cost.estimatedSavingsFromCaching)}`,
+            `  Saved (instinct): ${usd(metrics.cost.estimatedSavingsFromInstincts)}`,
+            '',
+            '═══ Auto-Fix ═══',
+            `  Attempts:      ${metrics.autoFix.totalAttempts}`,
+            `  Success rate:  ${pct(metrics.autoFix.successRate)}`,
+            `  Avg attempts:  ${metrics.autoFix.avgAttemptsPerFix.toFixed(1)}`,
+            `  Time saved:    ${metrics.autoFix.totalTimeSavedMinutes} min`,
+            '',
+            '═══ Trends (△ vs previous period) ═══',
+            `  Pass rate:     ${metrics.trends.passRateDelta > 0 ? '+' : ''}${pct(metrics.trends.passRateDelta)}`,
+            `  Cost:          ${metrics.trends.costDelta > 0 ? '+' : ''}${usd(metrics.trends.costDelta)}`,
+            `  Instinct hit:  ${metrics.trends.instinctHitRateDelta > 0 ? '+' : ''}${pct(metrics.trends.instinctHitRateDelta)}`,
+            '',
+            `ROI Score: ${this.computeROIScore(metrics)}/100`,
+        ].join('\n');
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    loadObservations(lookbackDays) {
+        return this.loadObservationsRange(0, lookbackDays);
+    }
+    loadObservationsRange(startDaysAgo, endDaysAgo) {
+        const obsDir = join(this.scaleDir, 'observations');
+        if (!existsSync(obsDir))
+            return [];
+        const start = Date.now() - endDaysAgo * 86400000;
+        const end = Date.now() - startDaysAgo * 86400000;
+        const results = [];
+        try {
+            for (const file of readdirSync(obsDir)) {
+                if (!file.endsWith('.jsonl'))
+                    continue;
+                const lines = readFileSync(join(obsDir, file), 'utf-8').split('\n').filter(Boolean);
+                for (const line of lines) {
+                    try {
+                        const obs = JSON.parse(line);
+                        const ts = new Date(obs.timestamp).getTime();
+                        if (ts >= start && ts < end)
+                            results.push(obs);
+                    }
+                    catch { /* skip */ }
+                }
+            }
+        }
+        catch (err) {
+            logger.warn({ err }, 'Failed to load observations');
+        }
+        return results;
+    }
+    computeGateMetrics(observations) {
+        const byGate = {};
+        let totalRuns = 0;
+        let totalPassed = 0;
+        let totalDuration = 0;
+        for (const obs of observations) {
+            totalRuns++;
+            if (obs.gateStatus === 'PASS')
+                totalPassed++;
+            if (obs.gateName) {
+                if (!byGate[obs.gateName])
+                    byGate[obs.gateName] = { runs: 0, passed: 0, avgTokens: 0 };
+                byGate[obs.gateName].runs++;
+                if (obs.gateStatus === 'PASS')
+                    byGate[obs.gateName].passed++;
+                byGate[obs.gateName].avgTokens += obs.tokensUsed ?? 0;
+            }
+            totalDuration += obs.durationMs ?? 0;
+        }
+        // Finalize averages
+        for (const gate of Object.values(byGate)) {
+            gate.avgTokens = gate.runs > 0 ? Math.round(gate.avgTokens / gate.runs) : 0;
+        }
+        return {
+            totalRuns,
+            passRate: totalRuns > 0 ? totalPassed / totalRuns : 0,
+            failRate: totalRuns > 0 ? (totalRuns - totalPassed) / totalRuns : 0,
+            avgDurationMs: totalRuns > 0 ? Math.round(totalDuration / totalRuns) : 0,
+            byGate,
+        };
+    }
+    computeInstinctMetrics(instincts) {
+        const byConfidence = {
+            'near-certain (0.9)': { count: 0, hitRate: 0 },
+            'strong (0.7)': { count: 0, hitRate: 0 },
+            'moderate (0.5)': { count: 0, hitRate: 0 },
+            'tentative (0.3)': { count: 0, hitRate: 0 },
+        };
+        for (const i of instincts) {
+            const bucket = i.confidence >= 0.9 ? 'near-certain (0.9)' :
+                i.confidence >= 0.7 ? 'strong (0.7)' :
+                    i.confidence >= 0.5 ? 'moderate (0.5)' : 'tentative (0.3)';
+            byConfidence[bucket].count++;
+            byConfidence[bucket].hitRate += i.hitRate;
+        }
+        for (const bucket of Object.values(byConfidence)) {
+            bucket.hitRate = bucket.count > 0 ? bucket.hitRate / bucket.count : 0;
+        }
+        const totalApplied = instincts.reduce((sum, i) => sum + i.appliedCount, 0);
+        const totalObs = instincts.reduce((sum, i) => sum + i.observations, 0);
+        return {
+            totalExtracted: instincts.length,
+            totalInjected: instincts.filter(i => i.confidence >= 0.7).length,
+            totalApplied,
+            hitRate: totalObs > 0 ? totalApplied / totalObs : 0,
+            byConfidence,
+        };
+    }
+    computeCostMetrics(observations, _instinctMetrics) {
+        const totalTokens = observations.reduce((sum, o) => sum + (o.tokensUsed ?? 0), 0);
+        const totalCost = observations.reduce((sum, o) => sum + (o.estimatedCostUsd ?? 0), 0);
+        return {
+            totalTokens,
+            totalCost,
+            avgTokensPerGate: observations.length > 0 ? totalTokens / observations.length : 0,
+            estimatedSavingsFromCaching: totalCost * 0.15, // ~15% from caching
+            estimatedSavingsFromInstincts: totalCost * 0.10, // ~10% from instinct prevention
+        };
+    }
+    computeAutoFixMetrics(observations) {
+        const autoFixObs = observations.filter(o => o.gateName?.includes('auto-fix'));
+        const successes = autoFixObs.filter(o => o.gateStatus === 'PASS').length;
+        const totalAttempts = autoFixObs.length;
+        return {
+            totalAttempts,
+            successRate: totalAttempts > 0 ? successes / totalAttempts : 0,
+            avgAttemptsPerFix: totalAttempts > 0 ? totalAttempts / Math.max(successes, 1) : 0,
+            totalTimeSavedMinutes: successes * 5, // ~5 min saved per auto-fix
+        };
+    }
+    computeTrends(current, previous, instinctMetrics) {
+        const currentPassRate = current.length > 0
+            ? current.filter(o => o.gateStatus === 'PASS').length / current.length
+            : 0;
+        const prevPassRate = previous.length > 0
+            ? previous.filter(o => o.gateStatus === 'PASS').length / previous.length
+            : 0;
+        const currentCost = current.reduce((s, o) => s + (o.estimatedCostUsd ?? 0), 0);
+        const prevCost = previous.reduce((s, o) => s + (o.estimatedCostUsd ?? 0), 0);
+        return {
+            passRateDelta: currentPassRate - prevPassRate,
+            costDelta: currentCost - prevCost,
+            instinctHitRateDelta: 0, // Requires historical hit rate data
+        };
+    }
+    computeROIScore(metrics) {
+        let score = 50; // baseline
+        // Gate pass rate contributes up to 20 points
+        score += Math.round(metrics.gates.passRate * 20);
+        // Instinct hit rate contributes up to 15 points
+        score += Math.round(metrics.instincts.hitRate * 15);
+        // Auto-fix success contributes up to 10 points
+        score += Math.round(metrics.autoFix.successRate * 10);
+        // Positive cost savings contribute up to 5 points
+        if (metrics.cost.estimatedSavingsFromCaching > 0)
+            score += 3;
+        if (metrics.cost.estimatedSavingsFromInstincts > 0)
+            score += 2;
+        return Math.min(100, Math.max(0, score));
+    }
+}
+//# sourceMappingURL=GovernanceMetrics.js.map

package/dist/cortex/GovernanceMetrics.js.map

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

package/dist/cortex/InstinctExtractor.d.ts

@@ -0,0 +1,61 @@
+export interface Instinct {
+    id: string;
+    trigger: string;
+    confidence: number;
+    domain: string;
+    source: string;
+    scope: 'project' | 'global';
+    projectId?: string;
+    action: string;
+    evidence: string[];
+    observations: number;
+    createdAt: string;
+    updatedAt: string;
+    appliedCount: number;
+    hitRate: number;
+}
+export interface Observation {
+    timestamp: string;
+    sessionId: string;
+    gateName: string;
+    gateStatus: 'PASS' | 'FAIL' | 'WARN';
+    errorPattern?: string;
+    filePaths: string[];
+    rootCause?: string;
+    resolution?: string;
+    tokensUsed: number;
+    modelUsed: string;
+}
+export interface PatternMatch {
+    pattern: string;
+    count: number;
+    observations: Observation[];
+    rootCauses: string[];
+    resolutions: string[];
+}
+export declare class InstinctExtractor {
+    private observationsDir;
+    private instinctsDir;
+    constructor(baseDir?: string);
+    /**
+     * Load observations from .scale/observations/ directory.
+     */
+    loadObservations(): Observation[];
+    /**
+     * Detect patterns from observations.
+     * Groups failures by error pattern, finds recurring root causes.
+     */
+    detectPatterns(observations: Observation[]): PatternMatch[];
+    /**
+     * Extract instincts from detected patterns.
+     */
+    extract(patterns: PatternMatch[]): Instinct[];
+    /**
+     * Record an observation for future instinct extraction.
+     */
+    recordObservation(obs: Observation): void;
+    private computeConfidence;
+    private inferDomain;
+    private generateTrigger;
+    private buildAction;
+}

package/dist/cortex/InstinctExtractor.js

@@ -0,0 +1,184 @@
+// SCALE Cortex — Instinct Extractor
+// 对齐 ECC: Observation Log → Pattern Detection → Instinct Creation
+// Confidence scoring: 0.3 tentative → 0.5 moderate → 0.7 strong → 0.9 near-certain
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+import { logger } from '../core/logger.js';
+// ---------------------------------------------------------------------------
+// InstinctExtractor
+// ---------------------------------------------------------------------------
+export class InstinctExtractor {
+    constructor(baseDir = join(process.cwd(), '.scale')) {
+        this.observationsDir = join(baseDir, 'observations');
+        this.instinctsDir = join(baseDir, 'instincts');
+    }
+    /**
+     * Load observations from .scale/observations/ directory.
+     */
+    loadObservations() {
+        if (!existsSync(this.observationsDir))
+            return [];
+        const observations = [];
+        try {
+            for (const file of readdirSync(this.observationsDir)) {
+                if (!file.endsWith('.jsonl'))
+                    continue;
+                const lines = readFileSync(join(this.observationsDir, file), 'utf-8')
+                    .split('\n')
+                    .filter(Boolean);
+                for (const line of lines) {
+                    try {
+                        observations.push(JSON.parse(line));
+                    }
+                    catch { /* skip malformed */ }
+                }
+            }
+        }
+        catch (err) {
+            logger.warn({ err }, 'Failed to load observations');
+        }
+        return observations;
+    }
+    /**
+     * Detect patterns from observations.
+     * Groups failures by error pattern, finds recurring root causes.
+     */
+    detectPatterns(observations) {
+        const failures = observations.filter(o => o.gateStatus === 'FAIL');
+        const patterns = new Map();
+        for (const obs of failures) {
+            const key = obs.errorPattern ?? obs.gateName;
+            if (!patterns.has(key)) {
+                patterns.set(key, {
+                    pattern: key,
+                    count: 0,
+                    observations: [],
+                    rootCauses: [],
+                    resolutions: [],
+                });
+            }
+            const match = patterns.get(key);
+            match.count++;
+            match.observations.push(obs);
+            if (obs.rootCause && !match.rootCauses.includes(obs.rootCause)) {
+                match.rootCauses.push(obs.rootCause);
+            }
+            if (obs.resolution && !match.resolutions.includes(obs.resolution)) {
+                match.resolutions.push(obs.resolution);
+            }
+        }
+        // Sort by count descending
+        return Array.from(patterns.values()).sort((a, b) => b.count - a.count);
+    }
+    /**
+     * Extract instincts from detected patterns.
+     */
+    extract(patterns) {
+        const instincts = [];
+        for (const pattern of patterns) {
+            if (pattern.count < 1)
+                continue;
+            // Compute confidence
+            const confidence = this.computeConfidence(pattern.count, pattern.rootCauses.length);
+            // Determine domain
+            const domain = this.inferDomain(pattern.pattern);
+            // Generate trigger from pattern
+            const trigger = this.generateTrigger(pattern);
+            // Build action
+            const action = this.buildAction(pattern);
+            const id = `instinct-${createHash('sha256').update(pattern.pattern).digest('hex').slice(0, 10)}`;
+            instincts.push({
+                id,
+                trigger,
+                confidence,
+                domain,
+                source: `extracted from ${pattern.count} observations`,
+                scope: confidence >= 0.7 ? 'global' : 'project',
+                action,
+                evidence: pattern.observations.slice(0, 5).map(o => `[${o.timestamp}] ${o.gateName}: ${o.errorPattern ?? 'failure'}`),
+                observations: pattern.count,
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+                appliedCount: 0,
+                hitRate: 0,
+            });
+        }
+        return instincts.sort((a, b) => b.confidence - a.confidence);
+    }
+    /**
+     * Record an observation for future instinct extraction.
+     */
+    recordObservation(obs) {
+        if (!existsSync(this.observationsDir)) {
+            mkdirSync(this.observationsDir, { recursive: true });
+        }
+        const today = new Date().toISOString().slice(0, 10);
+        const file = join(this.observationsDir, `${today}.jsonl`);
+        writeFileSync(file, JSON.stringify(obs) + '\n', { flag: 'a' });
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    computeConfidence(count, rootCauseCount) {
+        if (count >= 10 && rootCauseCount >= 3)
+            return 0.9; // near-certain
+        if (count >= 5)
+            return 0.7; // strong
+        if (count >= 2)
+            return 0.5; // moderate
+        return 0.3; // tentative
+    }
+    inferDomain(pattern) {
+        const lower = pattern.toLowerCase();
+        if (lower.includes('security') || lower.includes('secret') || lower.includes('vuln'))
+            return 'security';
+        if (lower.includes('test') || lower.includes('coverage') || lower.includes('assert'))
+            return 'testing';
+        if (lower.includes('lint') || lower.includes('style') || lower.includes('format'))
+            return 'code-quality';
+        if (lower.includes('build') || lower.includes('compile') || lower.includes('type'))
+            return 'build';
+        if (lower.includes('governance') || lower.includes('gate') || lower.includes('policy'))
+            return 'governance';
+        if (lower.includes('import') || lower.includes('dependency') || lower.includes('module'))
+            return 'dependencies';
+        return 'general';
+    }
+    generateTrigger(pattern) {
+        // Use the most frequent root cause as trigger
+        if (pattern.rootCauses.length > 0) {
+            return pattern.rootCauses[0];
+        }
+        return `gate:${pattern.pattern}`;
+    }
+    buildAction(pattern) {
+        const lines = [
+            `## Trigger`,
+            `${pattern.pattern}`,
+            '',
+            `## Observed Behavior`,
+            `This failure pattern has been observed ${pattern.count} time(s).`,
+            '',
+        ];
+        if (pattern.rootCauses.length > 0) {
+            lines.push('## Root Causes');
+            for (const rc of pattern.rootCauses.slice(0, 3)) {
+                lines.push(`- ${rc}`);
+            }
+            lines.push('');
+        }
+        if (pattern.resolutions.length > 0) {
+            lines.push('## Known Resolutions');
+            for (const r of pattern.resolutions.slice(0, 3)) {
+                lines.push(`- ${r}`);
+            }
+            lines.push('');
+        }
+        lines.push('## Recommended Action');
+        lines.push(`Before performing actions matching "${pattern.pattern}", review the known resolutions above.`);
+        lines.push(`If this is a recurrence, escalate by running: scale auto-fix`);
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=InstinctExtractor.js.map

package/dist/cortex/InstinctExtractor.js.map

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

package/dist/cortex/InstinctStore.d.ts

@@ -0,0 +1,54 @@
+import type { Instinct } from './InstinctExtractor.js';
+export declare class InstinctStore {
+    private baseDir;
+    constructor(baseDir?: string);
+    /**
+     * Save an instinct to disk.
+     * Deduplication: if an instinct with the same trigger exists, only keep the higher-confidence one.
+     */
+    save(instinct: Instinct): string;
+    /**
+     * Load all instincts from disk.
+     */
+    loadAll(): Instinct[];
+    /**
+     * Get instincts filtered by confidence threshold and scope.
+     */
+    query(options: {
+        minConfidence?: number;
+        domain?: string;
+        scope?: 'project' | 'global';
+        projectId?: string;
+    }): Instinct[];
+    /**
+     * Get high-confidence instincts for SessionStart injection (0.7+).
+     */
+    getInjectionInstincts(projectId?: string): Instinct[];
+    /**
+     * Find an instinct by trigger pattern.
+     */
+    findByTrigger(trigger: string): Instinct | null;
+    /**
+     * Find an instinct by ID.
+     */
+    findById(id: string): Instinct | null;
+    /**
+     * Delete an instinct by ID.
+     */
+    delete(id: string): boolean;
+    /**
+     * Record an instinct was applied (for hit rate tracking).
+     */
+    recordApplication(id: string, success: boolean): void;
+    /**
+     * Get store statistics.
+     */
+    stats(): {
+        total: number;
+        byDomain: Record<string, number>;
+        byConfidence: Record<string, number>;
+    };
+    private writeInstinctFile;
+    private serializeInstinct;
+    private parseInstinctFile;
+}