@hongmaple0820/scale-engine 0.40.1 → 0.43.0

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;
+}

package/dist/cortex/InstinctStore.js

@@ -0,0 +1,266 @@
+// SCALE Cortex — Instinct Store
+// 对齐 ECC: hierarchical filesystem-based storage under .scale/instincts/
+// Future: SQLite-backed in Cortex v2
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+import { logger } from '../core/logger.js';
+// ---------------------------------------------------------------------------
+// InstinctStore
+// ---------------------------------------------------------------------------
+export class InstinctStore {
+    constructor(baseDir = join(process.cwd(), '.scale', 'instincts')) {
+        this.baseDir = baseDir;
+        if (!existsSync(baseDir))
+            mkdirSync(baseDir, { recursive: true });
+    }
+    /**
+     * Save an instinct to disk.
+     * Deduplication: if an instinct with the same trigger exists, only keep the higher-confidence one.
+     */
+    save(instinct) {
+        const existing = this.findByTrigger(instinct.trigger);
+        if (existing && existing.confidence >= instinct.confidence) {
+            // Keep existing. Increment observation count.
+            existing.observations += instinct.observations;
+            existing.updatedAt = new Date().toISOString();
+            this.writeInstinctFile(existing);
+            return existing.id;
+        }
+        // New or higher-confidence instinct replaces existing
+        if (existing) {
+            this.delete(existing.id);
+        }
+        instinct.updatedAt = new Date().toISOString();
+        this.writeInstinctFile(instinct);
+        return instinct.id;
+    }
+    /**
+     * Load all instincts from disk.
+     */
+    loadAll() {
+        const instincts = [];
+        if (!existsSync(this.baseDir))
+            return instincts;
+        try {
+            for (const domain of readdirSync(this.baseDir)) {
+                const domainDir = join(this.baseDir, domain);
+                if (!domain.endsWith('.yaml') && existsSync(domainDir) && !domain.startsWith('.')) {
+                    // Directory-based domain
+                    try {
+                        for (const file of readdirSync(domainDir)) {
+                            if (!file.endsWith('.yaml'))
+                                continue;
+                            const instinct = this.parseInstinctFile(join(domainDir, file));
+                            if (instinct)
+                                instincts.push(instinct);
+                        }
+                    }
+                    catch { /* skip unreadable domains */ }
+                }
+                else if (domain.endsWith('.yaml')) {
+                    // Flat file in root
+                    const instinct = this.parseInstinctFile(join(this.baseDir, domain));
+                    if (instinct)
+                        instincts.push(instinct);
+                }
+            }
+        }
+        catch (err) {
+            logger.warn({ err }, 'Failed to load instincts');
+        }
+        return instincts.sort((a, b) => b.confidence - a.confidence);
+    }
+    /**
+     * Get instincts filtered by confidence threshold and scope.
+     */
+    query(options) {
+        let instincts = this.loadAll();
+        if (options.minConfidence) {
+            instincts = instincts.filter(i => i.confidence >= options.minConfidence);
+        }
+        if (options.domain) {
+            instincts = instincts.filter(i => i.domain === options.domain);
+        }
+        if (options.scope) {
+            instincts = instincts.filter(i => i.scope === options.scope);
+        }
+        if (options.projectId) {
+            instincts = instincts.filter(i => !i.projectId || i.projectId === options.projectId);
+        }
+        return instincts;
+    }
+    /**
+     * Get high-confidence instincts for SessionStart injection (0.7+).
+     */
+    getInjectionInstincts(projectId) {
+        return this.query({ minConfidence: 0.7, projectId });
+    }
+    /**
+     * Find an instinct by trigger pattern.
+     */
+    findByTrigger(trigger) {
+        const hash = createHash('sha256').update(trigger).digest('hex').slice(0, 10);
+        const id = `instinct-${hash}`;
+        return this.findById(id);
+    }
+    /**
+     * Find an instinct by ID.
+     */
+    findById(id) {
+        // Search all domain directories
+        if (!existsSync(this.baseDir))
+            return null;
+        try {
+            for (const entry of readdirSync(this.baseDir)) {
+                const full = join(this.baseDir, entry);
+                if (existsSync(full) && !entry.startsWith('.')) {
+                    if (!entry.endsWith('.yaml')) {
+                        // Domain directory
+                        const filePath = join(full, `${id}.yaml`);
+                        if (existsSync(filePath))
+                            return this.parseInstinctFile(filePath);
+                    }
+                }
+            }
+        }
+        catch { /* skip */ }
+        // Flat file search
+        const flatPath = join(this.baseDir, `${id}.yaml`);
+        if (existsSync(flatPath))
+            return this.parseInstinctFile(flatPath);
+        return null;
+    }
+    /**
+     * Delete an instinct by ID.
+     */
+    delete(id) {
+        const instinct = this.findById(id);
+        if (!instinct)
+            return false;
+        const domainDir = join(this.baseDir, instinct.domain);
+        const filePath = join(domainDir, `${id}.yaml`);
+        try {
+            if (existsSync(filePath))
+                unlinkSync(filePath);
+            return true;
+        }
+        catch (err) {
+            logger.warn({ err, id }, 'Failed to delete instinct');
+            return false;
+        }
+    }
+    /**
+     * Record an instinct was applied (for hit rate tracking).
+     */
+    recordApplication(id, success) {
+        const instinct = this.findById(id);
+        if (!instinct)
+            return;
+        instinct.appliedCount++;
+        instinct.hitRate = instinct.observations > 0
+            ? instinct.appliedCount / instinct.observations
+            : 0;
+        instinct.updatedAt = new Date().toISOString();
+        this.writeInstinctFile(instinct);
+    }
+    /**
+     * Get store statistics.
+     */
+    stats() {
+        const all = this.loadAll();
+        const byDomain = {};
+        const byConfidence = {
+            'near-certain (0.9)': 0,
+            'strong (0.7)': 0,
+            'moderate (0.5)': 0,
+            'tentative (0.3)': 0,
+        };
+        for (const i of all) {
+            byDomain[i.domain] = (byDomain[i.domain] ?? 0) + 1;
+            if (i.confidence >= 0.9)
+                byConfidence['near-certain (0.9)']++;
+            else if (i.confidence >= 0.7)
+                byConfidence['strong (0.7)']++;
+            else if (i.confidence >= 0.5)
+                byConfidence['moderate (0.5)']++;
+            else
+                byConfidence['tentative (0.3)']++;
+        }
+        return { total: all.length, byDomain, byConfidence };
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    writeInstinctFile(instinct) {
+        const domainDir = join(this.baseDir, instinct.domain);
+        if (!existsSync(domainDir))
+            mkdirSync(domainDir, { recursive: true });
+        const filePath = join(domainDir, `${instinct.id}.yaml`);
+        const yaml = this.serializeInstinct(instinct);
+        writeFileSync(filePath, yaml, 'utf-8');
+    }
+    serializeInstinct(instinct) {
+        const frontmatter = [
+            `id: ${instinct.id}`,
+            `trigger: "${instinct.trigger.replace(/"/g, '\\"')}"`,
+            `confidence: ${instinct.confidence}`,
+            `domain: ${instinct.domain}`,
+            `source: "${instinct.source}"`,
+            `scope: ${instinct.scope}`,
+            `project_id: ${instinct.projectId ?? ''}`,
+            `observations: ${instinct.observations}`,
+            `applied_count: ${instinct.appliedCount}`,
+            `hit_rate: ${instinct.hitRate.toFixed(2)}`,
+            `created_at: ${instinct.createdAt}`,
+            `updated_at: ${instinct.updatedAt}`,
+        ].join('\n');
+        const evidence = instinct.evidence.map(e => `  - "${e}"`).join('\n');
+        return [
+            '---',
+            frontmatter,
+            '---',
+            '',
+            instinct.action,
+            '',
+            '## Evidence',
+            evidence,
+            '',
+        ].join('\n');
+    }
+    parseInstinctFile(filePath) {
+        try {
+            const raw = readFileSync(filePath, 'utf-8');
+            const fmMatch = raw.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+            if (!fmMatch)
+                return null;
+            const frontmatter = fmMatch[1];
+            const body = fmMatch[2] ?? '';
+            const getYamlVal = (key) => {
+                const m = frontmatter.match(new RegExp(`^${key}:\\s*(.+?)$`, 'm'));
+                return m ? m[1].trim().replace(/^"(.*)"$/, '$1') : '';
+            };
+            return {
+                id: getYamlVal('id'),
+                trigger: getYamlVal('trigger'),
+                confidence: parseFloat(getYamlVal('confidence')) || 0.3,
+                domain: getYamlVal('domain') || 'general',
+                source: getYamlVal('source'),
+                scope: getYamlVal('scope') || 'project',
+                projectId: getYamlVal('project_id') || undefined,
+                action: body.trim(),
+                evidence: [],
+                observations: parseInt(getYamlVal('observations'), 10) || 0,
+                createdAt: getYamlVal('created_at') || new Date().toISOString(),
+                updatedAt: getYamlVal('updated_at') || new Date().toISOString(),
+                appliedCount: parseInt(getYamlVal('applied_count'), 10) || 0,
+                hitRate: parseFloat(getYamlVal('hit_rate')) || 0,
+            };
+        }
+        catch (err) {
+            logger.warn({ err, path: filePath }, 'Failed to parse instinct file');
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=InstinctStore.js.map

package/dist/cortex/InstinctStore.js.map

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

package/dist/cortex/ReflexionEngine.d.ts

@@ -0,0 +1,34 @@
+import type { Observation, Instinct } from './InstinctExtractor.js';
+export interface ReflexionResult {
+    rootCause: string;
+    confidence: number;
+    suggestedAction: string;
+    relatedFailures: string[];
+    instinct: Instinct | null;
+    modelUsed: string;
+    tokensUsed: number;
+}
+export declare class ReflexionEngine {
+    private modelEndpoint;
+    private modelName;
+    private enabled;
+    constructor(options?: {
+        endpoint?: string;
+        model?: string;
+    });
+    /**
+     * Reflect on a set of failed observations to produce root cause analysis.
+     */
+    reflect(observations: Observation[]): Promise<ReflexionResult>;
+    /**
+     * Reflect on gate failure patterns and generate improvement instincts.
+     */
+    reflectOnGate(gateName: string, failures: Observation[]): Promise<ReflexionResult>;
+    /**
+     * Batch reflect across all failing gates and merge results.
+     */
+    reflectAll(observations: Observation[]): Promise<ReflexionResult[]>;
+    private llmReflect;
+    private heuristicReflect;
+    private buildReflectionPrompt;
+}