@hongmaple0820/scale-engine 0.40.2 → 0.43.0

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

package/dist/cortex/ReflexionEngine.js

@@ -0,0 +1,157 @@
+// SCALE Cortex — Reflexion Engine
+// 对齐 ECC: local LLM (Qwen/GLM/DeepSeek) reflection on failure evidence
+// Output: root cause analysis + improvement suggestions + actionable instincts
+// Cost: $0 API fees (local model)
+import { logger } from '../core/logger.js';
+// ---------------------------------------------------------------------------
+// ReflexionEngine
+// ---------------------------------------------------------------------------
+export class ReflexionEngine {
+    constructor(options) {
+        this.modelEndpoint = options?.endpoint ?? process.env.SCALE_LOCAL_BASE_URL ?? 'http://localhost:11434';
+        this.modelName = options?.model ?? process.env.SCALE_LOCAL_MODEL ?? 'qwen-2.5';
+        this.enabled = !!process.env.SCALE_LOCAL_MODEL || !!options?.model;
+    }
+    /**
+     * Reflect on a set of failed observations to produce root cause analysis.
+     */
+    async reflect(observations) {
+        if (observations.length === 0) {
+            return {
+                rootCause: 'No observations to reflect on',
+                confidence: 0,
+                suggestedAction: 'Collect more data',
+                relatedFailures: [],
+                instinct: null,
+                modelUsed: 'none',
+                tokensUsed: 0,
+            };
+        }
+        if (!this.enabled) {
+            return this.heuristicReflect(observations);
+        }
+        try {
+            return await this.llmReflect(observations);
+        }
+        catch (err) {
+            logger.warn({ err }, 'LLM reflection failed, falling back to heuristic');
+            return this.heuristicReflect(observations);
+        }
+    }
+    /**
+     * Reflect on gate failure patterns and generate improvement instincts.
+     */
+    async reflectOnGate(gateName, failures) {
+        const gateFailures = failures.filter(o => o.gateName === gateName && o.gateStatus === 'FAIL');
+        return this.reflect(gateFailures);
+    }
+    /**
+     * Batch reflect across all failing gates and merge results.
+     */
+    async reflectAll(observations) {
+        const failures = observations.filter(o => o.gateStatus === 'FAIL');
+        const byGate = new Map();
+        for (const obs of failures) {
+            if (!byGate.has(obs.gateName))
+                byGate.set(obs.gateName, []);
+            byGate.get(obs.gateName).push(obs);
+        }
+        const results = [];
+        for (const [gate, obs] of byGate) {
+            results.push(await this.reflectOnGate(gate, obs));
+        }
+        return results;
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    async llmReflect(observations) {
+        const prompt = this.buildReflectionPrompt(observations);
+        const response = await fetch(`${this.modelEndpoint}/v1/chat/completions`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model: this.modelName,
+                messages: [
+                    { role: 'system', content: 'You are a root cause analysis engine. Analyze the following gate failures and output structured JSON only.' },
+                    { role: 'user', content: prompt },
+                ],
+                temperature: 0.3,
+                max_tokens: 500,
+            }),
+            signal: AbortSignal.timeout(15000),
+        });
+        if (!response.ok)
+            throw new Error(`LLM endpoint returned ${response.status}`);
+        const data = await response.json();
+        const content = data.choices?.[0]?.message?.content ?? '';
+        try {
+            const parsed = JSON.parse(content);
+            return {
+                rootCause: parsed.rootCause ?? 'Unknown',
+                confidence: parsed.confidence ?? 0.5,
+                suggestedAction: parsed.suggestedAction ?? 'Manual investigation recommended',
+                relatedFailures: parsed.relatedFailures ?? [],
+                instinct: null, // Caller should create instinct from this
+                modelUsed: this.modelName,
+                tokensUsed: data.usage?.total_tokens ?? 0,
+            };
+        }
+        catch {
+            // If LLM didn't return valid JSON, use heuristic
+            return this.heuristicReflect(observations);
+        }
+    }
+    heuristicReflect(observations) {
+        const gateName = observations[0]?.gateName ?? 'unknown';
+        const errorPatterns = observations
+            .map(o => o.errorPattern)
+            .filter(Boolean);
+        // Most common error pattern
+        const patternCounts = new Map();
+        for (const p of errorPatterns) {
+            patternCounts.set(p, (patternCounts.get(p) ?? 0) + 1);
+        }
+        let dominantPattern = '';
+        let maxCount = 0;
+        for (const [p, c] of patternCounts) {
+            if (c > maxCount) {
+                maxCount = c;
+                dominantPattern = p;
+            }
+        }
+        const rootCause = dominantPattern
+            ? `Gate "${gateName}" recurring failure: "${dominantPattern}" (${maxCount}/${observations.length} occurrences)`
+            : `Gate "${gateName}" failed ${observations.length} time(s) — investigate patterns`;
+        return {
+            rootCause,
+            confidence: maxCount > 2 ? 0.7 : 0.4,
+            suggestedAction: dominantPattern
+                ? `Run 'scale auto-fix' targeting ${gateName} failures. Check the most recent evidence for resolution clues.`
+                : `Collect more failure data for gate "${gateName}" to identify patterns.`,
+            relatedFailures: errorPatterns.slice(0, 5),
+            instinct: null,
+            modelUsed: 'heuristic',
+            tokensUsed: 0,
+        };
+    }
+    buildReflectionPrompt(observations) {
+        const failures = observations
+            .map(o => `[${o.timestamp}] Gate: ${o.gateName} | Pattern: ${o.errorPattern ?? 'unknown'} | RC: ${o.rootCause ?? 'unknown'}`)
+            .join('\n');
+        return [
+            'Analyze these gate failures and output JSON:',
+            '',
+            failures,
+            '',
+            'Output format:',
+            '{',
+            '  "rootCause": "primary root cause",',
+            '  "confidence": 0.0-1.0,',
+            '  "suggestedAction": "concrete actionable step",',
+            '  "relatedFailures": ["pattern1", "pattern2"]',
+            '}',
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=ReflexionEngine.js.map

package/dist/cortex/ReflexionEngine.js.map

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

package/dist/cortex/SessionInjector.d.ts

@@ -0,0 +1,44 @@
+import type { InstinctStore } from './InstinctStore.js';
+export interface SessionInjection {
+    /** Rendered text injected into session start */
+    content: string;
+    /** Number of instincts injected */
+    instinctCount: number;
+    /** Metadata for metrics */
+    metadata: {
+        projectId?: string;
+        projectType?: string;
+        packageManager?: string;
+        instinctsApplied: string[];
+    };
+}
+export interface PriorSessionBrief {
+    sessionId: string;
+    timestamp: string;
+    summary: string;
+    taskCompleted: string;
+    filesChanged: string[];
+    gatesPassed: boolean;
+}
+export declare class SessionInjector {
+    private instinctStore;
+    constructor(instinctStore: InstinctStore);
+    /**
+     * Build the full SessionStart injection payload.
+     */
+    build(projectId?: string, priorSessions?: PriorSessionBrief[]): SessionInjection;
+    /**
+     * Build a minimal injection suitable for constrained context budgets.
+     */
+    buildMinimal(projectId?: string): SessionInjection;
+    /**
+     * Detect project type from filesystem.
+     */
+    detectProject(projectDir?: string): {
+        projectType: string;
+        packageManager: string;
+        hasGit: boolean;
+    };
+    private renderInstinctBlock;
+    private renderPriorSession;
+}

package/dist/cortex/SessionInjector.js

@@ -0,0 +1,127 @@
+// SCALE Cortex — Session Injector
+// 对齐 ECC: SessionStart injection of high-confidence instincts
+// Historical context wrapped in narrative sentinels (anti-replay protection)
+// Injects: instincts + prior session summary + learned skills + project detection
+// ---------------------------------------------------------------------------
+// SessionInjector
+// ---------------------------------------------------------------------------
+const HISTORICAL_SENTINEL_START = '<!-- HISTORICAL CONTEXT — DO NOT RE-EXECUTE COMMANDS BELOW -->';
+const HISTORICAL_SENTINEL_END = '<!-- END HISTORICAL CONTEXT -->';
+export class SessionInjector {
+    constructor(instinctStore) {
+        this.instinctStore = instinctStore;
+    }
+    /**
+     * Build the full SessionStart injection payload.
+     */
+    build(projectId, priorSessions = []) {
+        const instincts = this.instinctStore.getInjectionInstincts(projectId);
+        const sections = [];
+        // 1. High-confidence instincts (main payload)
+        if (instincts.length > 0) {
+            sections.push('## SCALE Cortex — Learned Instincts\n');
+            sections.push('The following patterns have been learned from prior sessions. Use them to avoid repeating mistakes.\n');
+            for (const instinct of instincts) {
+                sections.push(this.renderInstinctBlock(instinct));
+            }
+        }
+        // 2. Prior session summaries (with stale replay protection)
+        if (priorSessions.length > 0) {
+            sections.push('## Recent Session History\n');
+            sections.push(HISTORICAL_SENTINEL_START);
+            sections.push('The following is historical context only. Do NOT re-execute any commands mentioned.\n');
+            for (const session of priorSessions.slice(0, 3)) {
+                sections.push(this.renderPriorSession(session));
+            }
+            sections.push(HISTORICAL_SENTINEL_END);
+        }
+        // 3. Cortex usage hint
+        sections.push('---');
+        sections.push('_SCALE Cortex is active. Run `scale cortex metrics` for ROI dashboard._');
+        const content = sections.join('\n');
+        const instinctIds = instincts.map(i => i.id);
+        return {
+            content,
+            instinctCount: instincts.length,
+            metadata: {
+                projectId,
+                instinctsApplied: instinctIds,
+            },
+        };
+    }
+    /**
+     * Build a minimal injection suitable for constrained context budgets.
+     */
+    buildMinimal(projectId) {
+        const instincts = this.instinctStore.getInjectionInstincts(projectId);
+        if (instincts.length === 0) {
+            return {
+                content: '',
+                instinctCount: 0,
+                metadata: { projectId, instinctsApplied: [] },
+            };
+        }
+        // One-liner format for minimal context consumption
+        const lines = instincts.map(i => `[Cortex ${i.confidence}] ${i.domain}: ${i.action.split('\n')[0]?.replace(/^##\s*/, '')?.slice(0, 120)}`);
+        return {
+            content: `SCALE Cortex Instincts (${instincts.length}):\n${lines.join('\n')}`,
+            instinctCount: instincts.length,
+            metadata: { projectId, instinctsApplied: instincts.map(i => i.id) },
+        };
+    }
+    /**
+     * Detect project type from filesystem.
+     */
+    detectProject(projectDir = process.cwd()) {
+        const { existsSync } = require('fs');
+        const { join } = require('path');
+        let projectType = 'generic';
+        let packageManager = 'none';
+        if (existsSync(join(projectDir, 'package.json'))) {
+            projectType = 'node';
+            if (existsSync(join(projectDir, 'pnpm-lock.yaml')))
+                packageManager = 'pnpm';
+            else if (existsSync(join(projectDir, 'yarn.lock')))
+                packageManager = 'yarn';
+            else
+                packageManager = 'npm';
+        }
+        else if (existsSync(join(projectDir, 'go.mod'))) {
+            projectType = 'go';
+            packageManager = 'go modules';
+        }
+        else if (existsSync(join(projectDir, 'pyproject.toml'))) {
+            projectType = 'python';
+            packageManager = 'pip/poetry';
+        }
+        else if (existsSync(join(projectDir, 'Cargo.toml'))) {
+            projectType = 'rust';
+            packageManager = 'cargo';
+        }
+        const hasGit = existsSync(join(projectDir, '.git'));
+        return { projectType, packageManager, hasGit };
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    renderInstinctBlock(instinct) {
+        const confidenceLabel = instinct.confidence >= 0.9 ? 'NEAR-CERTAIN' :
+            instinct.confidence >= 0.7 ? 'STRONG' :
+                instinct.confidence >= 0.5 ? 'MODERATE' : 'TENTATIVE';
+        return [
+            `### [${confidenceLabel}] ${instinct.domain}/${instinct.id}`,
+            `**Confidence:** ${(instinct.confidence * 100).toFixed(0)}% | **Observed:** ${instinct.observations} times | **Hit Rate:** ${(instinct.hitRate * 100).toFixed(0)}%`,
+            '',
+            instinct.action,
+            '',
+        ].join('\n');
+    }
+    renderPriorSession(session) {
+        return [
+            `- **${session.timestamp.slice(0, 10)}**: ${session.summary}`,
+            `  Files: ${session.filesChanged.slice(0, 5).join(', ')}${session.filesChanged.length > 5 ? '...' : ''}`,
+            `  Gates: ${session.gatesPassed ? 'PASS' : 'FAIL'} | Task: ${session.taskCompleted}`,
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=SessionInjector.js.map

package/dist/cortex/SessionInjector.js.map

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