@hongmaple0820/scale-engine 0.40.1 → 0.43.0

package/dist/core/GbrainRuntime.js

@@ -0,0 +1,270 @@
+import { spawnSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { cpSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join, relative, resolve } from 'node:path';
+import { resolveExternalCommandPath } from './ExternalCommand.js';
+const MIRROR_META_FILE = '.scale-gbrain-runtime.json';
+export function runGbrainCommandSync(args, options = {}, deps = {}) {
+    const currentPlatform = deps.platform ?? process.platform;
+    const resolveCommandPath = deps.resolveCommandPath ?? resolveExternalCommandPath;
+    const spawn = deps.spawn ?? spawnSync;
+    if (currentPlatform === 'win32') {
+        const runtime = resolveWindowsGbrainRuntime(resolveCommandPath);
+        if (runtime) {
+            const direct = spawnGbrain(spawn, runtime.bunExe, [runtime.cliPath, ...args], {
+                ...options,
+                env: mergeEnv(deps.env, options.env),
+                cwd: options.cwd ?? runtime.packageRoot,
+            });
+            if (!shouldRetryWithMirroredRuntime(direct, runtime.cliPath))
+                return direct;
+            const mirrored = ensureMirroredRuntime(runtime, deps);
+            const retried = spawnGbrain(spawn, mirrored.bunExe, [mirrored.cliPath, ...args], {
+                ...options,
+                env: mergeEnv(deps.env, options.env),
+                cwd: options.cwd ?? mirrored.mirrorRoot,
+            });
+            return {
+                ...retried,
+                usedMirroredRuntime: true,
+            };
+        }
+    }
+    return spawnResolvedCommand(resolveCommandPath, spawn, currentPlatform, 'gbrain', args, {
+        ...options,
+        env: mergeEnv(deps.env, options.env),
+    });
+}
+function spawnResolvedCommand(resolveCommandPath, spawn, currentPlatform, command, args, options) {
+    const resolved = resolveWindowsCommandShim(resolveCommandPath(command) ?? command, currentPlatform);
+    if (currentPlatform === 'win32' && /\.(cmd|bat)$/i.test(resolved)) {
+        return spawnGbrain(spawn, process.env.ComSpec ?? 'cmd.exe', ['/d', '/c', 'call', resolved, ...args], options);
+    }
+    return spawnGbrain(spawn, resolved, args, options);
+}
+function spawnGbrain(spawn, command, args, options) {
+    const result = spawn(command, args, {
+        cwd: options.cwd,
+        env: options.env,
+        input: options.input,
+        stdio: options.stdio ?? ['ignore', 'pipe', 'pipe'],
+        timeout: options.timeout,
+        maxBuffer: options.maxBuffer,
+        encoding: 'utf8',
+        shell: false,
+        windowsHide: true,
+    });
+    return toCommandResult(args, result);
+}
+function toCommandResult(args, result) {
+    const stdout = String(result.stdout ?? '');
+    const stderr = `${String(result.stderr ?? '')}${result.error ? `\n${result.error.message}` : ''}`.trim();
+    const exitCode = typeof result.status === 'number' ? result.status : 1;
+    const timedOut = /ETIMEDOUT/i.test(String(result.error?.message ?? ''));
+    const recoveredTimeout = shouldRecoverGbrainTimeout(args, stdout, stderr, exitCode, timedOut);
+    return {
+        stdout,
+        stderr: recoveredTimeout ? stripRecoverableTimeoutNoise(stderr) : stderr,
+        exitCode: recoveredTimeout ? 0 : exitCode,
+        timedOut: recoveredTimeout ? false : timedOut,
+        usedMirroredRuntime: false,
+        recoveredTimeout,
+    };
+}
+const GBRAIN_TIMEOUT_RECOVERY_COMMANDS = new Set(['--version', 'version', 'doctor', 'list', 'get', 'query', 'search']);
+function shouldRecoverGbrainTimeout(args, stdout, stderr, exitCode, timedOut) {
+    if (!timedOut || exitCode === 0)
+        return false;
+    const command = normalizeGbrainSubcommand(args);
+    if (!command || !GBRAIN_TIMEOUT_RECOVERY_COMMANDS.has(command))
+        return false;
+    const cleanedStderr = stripRecoverableTimeoutNoise(stderr);
+    if (cleanedStderr)
+        return false;
+    return hasRecoverableGbrainOutput(command, stdout.trim());
+}
+function normalizeGbrainSubcommand(args) {
+    const command = String(args[0] ?? '').trim().toLowerCase();
+    return command || null;
+}
+function hasRecoverableGbrainOutput(command, stdout) {
+    if (!stdout)
+        return false;
+    switch (command) {
+        case '--version':
+        case 'version':
+            return /\bgbrain\b/i.test(stdout) || /\d+\.\d+\.\d+/.test(stdout);
+        case 'doctor':
+            return looksLikeJsonOutput(stdout);
+        case 'list':
+            return /no pages found/i.test(stdout)
+                || /^\d+\.\s+\S+/m.test(stdout)
+                || /^\[\d+(?:\.\d+)?\]\s+/m.test(stdout);
+        case 'get':
+            return /^---$/m.test(stdout)
+                || /^#\s+\S+/m.test(stdout)
+                || looksLikeJsonOutput(stdout);
+        case 'query':
+        case 'search':
+            return looksLikeJsonOutput(stdout)
+                || /no (pages|results) found/i.test(stdout)
+                || /^\[\d+(?:\.\d+)?\]\s+/m.test(stdout)
+                || /^\d+\.\s+\S+/m.test(stdout);
+        default:
+            return false;
+    }
+}
+function looksLikeJsonOutput(stdout) {
+    const trimmed = stdout.trim();
+    if (!trimmed || (!trimmed.startsWith('{') && !trimmed.startsWith('[')))
+        return false;
+    try {
+        JSON.parse(trimmed);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function stripRecoverableTimeoutNoise(stderr) {
+    return String(stderr ?? '')
+        .replace(/\n?spawnSync .*?\bETIMEDOUT\b\s*/gim, '\n')
+        .replace(/\n?Command failed: .*?\bETIMEDOUT\b\s*/gim, '\n')
+        .replace(/\n?timed out after .*$/gim, '\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+function shouldRetryWithMirroredRuntime(result, cliPath) {
+    if (result.exitCode === 0)
+        return false;
+    const output = `${result.stdout}\n${result.stderr}`;
+    if (!/EPERM reading/i.test(output))
+        return false;
+    const normalizedOutput = normalizeForCompare(output);
+    const normalizedCli = normalizeForCompare(cliPath);
+    return normalizedOutput.includes(normalizedCli) || /src[\\/]cli\.ts/i.test(output);
+}
+function resolveWindowsGbrainRuntime(resolveCommandPath) {
+    const shimPath = resolveCommandPath('gbrain');
+    if (!shimPath || !/\.cmd$/i.test(shimPath) || !existsSync(shimPath))
+        return null;
+    try {
+        const content = readFileSync(shimPath, 'utf8');
+        const match = content.match(/call\s+"([^"]*bun\.cmd)"\s+"([^"]*src[\\/]cli\.ts)"/i);
+        const cliPath = match?.[2];
+        const bunShim = match?.[1] ?? resolveCommandPath('bun');
+        const bunExe = resolveWindowsBunExe(bunShim);
+        if (!cliPath || !bunExe || !existsSync(cliPath) || !existsSync(bunExe))
+            return null;
+        const packageRoot = dirname(dirname(cliPath));
+        return {
+            shimPath,
+            bunExe,
+            cliPath,
+            packageRoot,
+            version: readPackageVersion(packageRoot),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function resolveWindowsBunExe(bunShim) {
+    if (!bunShim)
+        return null;
+    const candidate = join(dirname(bunShim), 'node_modules', 'bun', 'bin', 'bun.exe');
+    return existsSync(candidate) ? candidate : null;
+}
+function ensureMirroredRuntime(runtime, deps) {
+    const cliMtimeMs = statSync(runtime.cliPath).mtimeMs;
+    const mirrorKey = `${resolve(runtime.packageRoot)}|${runtime.version ?? ''}|${cliMtimeMs}`;
+    const mirrorRoot = join(deps.tmpDir ?? tmpdir(), 'scale-engine', 'gbrain-runtime', createHash('sha1').update(mirrorKey).digest('hex').slice(0, 16));
+    const cliRelativePath = relative(runtime.packageRoot, runtime.cliPath);
+    const mirrorCliPath = join(mirrorRoot, cliRelativePath);
+    let selectedRoot = mirrorRoot;
+    if (!isMirrorFresh(mirrorRoot, runtime.packageRoot, runtime.version, cliMtimeMs, mirrorCliPath)) {
+        const stagedRoot = `${mirrorRoot}-staging-${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2, 8)}`;
+        rmSync(stagedRoot, { recursive: true, force: true });
+        mkdirSync(dirname(mirrorRoot), { recursive: true });
+        cpSync(runtime.packageRoot, stagedRoot, { recursive: true, force: true });
+        const metadata = {
+            sourceRoot: runtime.packageRoot,
+            version: runtime.version,
+            cliMtimeMs,
+        };
+        writeFileSync(join(stagedRoot, MIRROR_META_FILE), JSON.stringify(metadata, null, 2), 'utf8');
+        const stagedCliPath = join(stagedRoot, cliRelativePath);
+        if (!isMirrorFresh(mirrorRoot, runtime.packageRoot, runtime.version, cliMtimeMs, mirrorCliPath)) {
+            try {
+                renameSync(stagedRoot, mirrorRoot);
+            }
+            catch {
+                if (isMirrorFresh(mirrorRoot, runtime.packageRoot, runtime.version, cliMtimeMs, mirrorCliPath)) {
+                    rmSync(stagedRoot, { recursive: true, force: true });
+                }
+                else {
+                    selectedRoot = stagedRoot;
+                }
+            }
+        }
+        else {
+            rmSync(stagedRoot, { recursive: true, force: true });
+        }
+        if (selectedRoot === mirrorRoot && !existsSync(mirrorCliPath) && existsSync(stagedCliPath))
+            selectedRoot = stagedRoot;
+    }
+    return {
+        ...runtime,
+        cliPath: join(selectedRoot, cliRelativePath),
+        mirrorRoot: selectedRoot,
+    };
+}
+function isMirrorFresh(mirrorRoot, sourceRoot, version, cliMtimeMs, mirrorCliPath) {
+    if (!existsSync(mirrorCliPath))
+        return false;
+    const metadataPath = join(mirrorRoot, MIRROR_META_FILE);
+    if (!existsSync(metadataPath))
+        return false;
+    try {
+        const parsed = JSON.parse(readFileSync(metadataPath, 'utf8'));
+        return parsed.sourceRoot === sourceRoot
+            && parsed.version === version
+            && parsed.cliMtimeMs === cliMtimeMs;
+    }
+    catch {
+        return false;
+    }
+}
+function readPackageVersion(packageRoot) {
+    try {
+        const parsed = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'));
+        return typeof parsed.version === 'string' ? parsed.version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveWindowsCommandShim(executable, currentPlatform) {
+    if (currentPlatform !== 'win32')
+        return executable;
+    if (!/[\\/]/.test(executable) || /\.[a-z0-9]+$/i.test(executable))
+        return executable;
+    for (const extension of ['.cmd', '.exe', '.bat', '.com']) {
+        const candidate = `${executable}${extension}`;
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return executable;
+}
+function normalizeForCompare(value) {
+    return value.replace(/\//g, '\\').toLowerCase();
+}
+function mergeEnv(baseEnv, overrideEnv) {
+    return {
+        ...process.env,
+        ...(baseEnv ?? {}),
+        ...(overrideEnv ?? {}),
+    };
+}
+//# sourceMappingURL=GbrainRuntime.js.map

package/dist/core/GbrainRuntime.js.map

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

package/dist/cortex/GovernanceMetrics.d.ts

@@ -0,0 +1,66 @@
+import type { Instinct } from './InstinctExtractor.js';
+export interface GovernanceMetrics {
+    gates: {
+        totalRuns: number;
+        passRate: number;
+        failRate: number;
+        avgDurationMs: number;
+        byGate: Record<string, {
+            runs: number;
+            passed: number;
+            avgTokens: number;
+        }>;
+    };
+    instincts: {
+        totalExtracted: number;
+        totalInjected: number;
+        totalApplied: number;
+        hitRate: number;
+        byConfidence: Record<string, {
+            count: number;
+            hitRate: number;
+        }>;
+    };
+    cost: {
+        totalTokens: number;
+        totalCost: number;
+        avgTokensPerGate: number;
+        estimatedSavingsFromCaching: number;
+        estimatedSavingsFromInstincts: number;
+    };
+    autoFix: {
+        totalAttempts: number;
+        successRate: number;
+        avgAttemptsPerFix: number;
+        totalTimeSavedMinutes: number;
+    };
+    trends: {
+        passRateDelta: number;
+        costDelta: number;
+        instinctHitRateDelta: number;
+    };
+    period: {
+        start: string;
+        end: string;
+    };
+}
+export declare class GovernanceMetricsCalculator {
+    private scaleDir;
+    constructor(scaleDir?: string);
+    /**
+     * Compute full governance metrics from observation logs and instinct store.
+     */
+    compute(instincts: Instinct[], lookbackDays?: number): GovernanceMetrics;
+    /**
+     * Render metrics as a terminal report.
+     */
+    render(metrics: GovernanceMetrics): string;
+    private loadObservations;
+    private loadObservationsRange;
+    private computeGateMetrics;
+    private computeInstinctMetrics;
+    private computeCostMetrics;
+    private computeAutoFixMetrics;
+    private computeTrends;
+    private computeROIScore;
+}

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