@hongmaple0820/scale-engine 0.29.0 → 0.33.0

package/dist/evolution/SessionLearnings.d.ts

@@ -0,0 +1,70 @@
+export type LearningCategory = 'failure' | 'pattern' | 'preference' | 'environment';
+export interface LearningEntry {
+    id: string;
+    ts: string;
+    projectSlug: string;
+    category: LearningCategory;
+    title: string;
+    detail: string;
+    evidenceIds: string[];
+    tags: string[];
+    relevanceDecay?: number;
+}
+export interface LearningSearchQuery {
+    tags?: string[];
+    category?: LearningCategory;
+    limit?: number;
+    projectSlug?: string;
+}
+export interface LearningStore {
+    append(entry: LearningEntry): void;
+    search(query: LearningSearchQuery): LearningEntry[];
+    prune(opts: {
+        olderThanDays?: number;
+        minRelevance?: number;
+    }): number;
+    count(): number;
+    exportJsonl(): string;
+}
+export declare function createLearningStore(opts: {
+    storePath?: string;
+}): LearningStore;
+interface RunReportForLearning {
+    status: string;
+    mode: string;
+    plan: {
+        task: string;
+        level?: string;
+        governance?: {
+            mode?: string;
+        };
+    };
+    failureLearning: {
+        status: string;
+        candidates: Array<{
+            id: string;
+            source: string;
+            title: string;
+            summary: string;
+            evidenceRefs: string[];
+            promotable: boolean;
+        }>;
+    };
+    verification: {
+        allPassed: boolean;
+        commands: Array<{
+            command: string;
+            status: string;
+            exitCode: number;
+        }>;
+    };
+}
+export declare function autoLearnFromRunReport(report: RunReportForLearning): LearningEntry[];
+export declare function loadRelevantLearnings(opts: {
+    projectDir?: string;
+    scaleDir?: string;
+    task?: string;
+    tags?: string[];
+    limit?: number;
+}): LearningEntry[];
+export {};

package/dist/evolution/SessionLearnings.js

@@ -0,0 +1,217 @@
+// SCALE Engine — Session Learnings (v0.31.0)
+// Cross-session knowledge persistence inspired by gstack's learnings.jsonl.
+// Learnings survive across sessions and are loaded into future plans.
+import { existsSync, mkdirSync, readFileSync, writeFileSync, appendFileSync, readdirSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { randomUUID } from 'node:crypto';
+// ============================================================================
+// Store Implementation
+// ============================================================================
+export function createLearningStore(opts) {
+    const storePath = opts.storePath ?? '.scale/learnings';
+    const dir = storePath;
+    function ensureDir() {
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+    }
+    function getJsonlPath(projectSlug) {
+        return join(dir, `${projectSlug}.jsonl`);
+    }
+    function readEntries(projectSlug) {
+        const path = getJsonlPath(projectSlug);
+        if (!existsSync(path))
+            return [];
+        try {
+            const content = readFileSync(path, 'utf-8');
+            return content.split('\n').filter(line => line.trim()).map(line => JSON.parse(line));
+        }
+        catch {
+            return [];
+        }
+    }
+    function writeEntries(projectSlug, entries) {
+        ensureDir();
+        const path = getJsonlPath(projectSlug);
+        const content = entries.map(e => JSON.stringify(e)).join('\n') + '\n';
+        writeFileSync(path, content, 'utf-8');
+    }
+    return {
+        append(entry) {
+            ensureDir();
+            const path = getJsonlPath(entry.projectSlug);
+            appendFileSync(path, JSON.stringify(entry) + '\n', 'utf-8');
+        },
+        search(query) {
+            const slug = query.projectSlug;
+            const slugs = slug ? [slug] : listProjectSlugs(dir);
+            const allEntries = [];
+            for (const s of slugs) {
+                const entries = readEntries(s);
+                allEntries.push(...entries);
+            }
+            let filtered = allEntries;
+            if (query.category) {
+                filtered = filtered.filter(e => e.category === query.category);
+            }
+            if (query.tags && query.tags.length > 0) {
+                filtered = filtered.filter(e => query.tags.some(t => e.tags.includes(t)));
+            }
+            // Sort by timestamp descending (newest first)
+            filtered.sort((a, b) => new Date(b.ts).getTime() - new Date(a.ts).getTime());
+            if (query.limit) {
+                filtered = filtered.slice(0, query.limit);
+            }
+            return filtered;
+        },
+        prune(opts) {
+            const slugs = listProjectSlugs(dir);
+            let prunedCount = 0;
+            for (const slug of slugs) {
+                const entries = readEntries(slug);
+                const now = Date.now();
+                const kept = entries.filter(e => {
+                    if (opts.olderThanDays) {
+                        const ageMs = now - new Date(e.ts).getTime();
+                        const ageDays = ageMs / (1000 * 60 * 60 * 24);
+                        if (ageDays > opts.olderThanDays) {
+                            prunedCount++;
+                            return false;
+                        }
+                    }
+                    if (opts.minRelevance && e.relevanceDecay) {
+                        const ageMs = now - new Date(e.ts).getTime();
+                        const ageDays = ageMs / (1000 * 60 * 60 * 24);
+                        const relevance = Math.max(0, 1 - (e.relevanceDecay * ageDays / 30));
+                        if (relevance < opts.minRelevance) {
+                            prunedCount++;
+                            return false;
+                        }
+                    }
+                    return true;
+                });
+                if (kept.length !== entries.length) {
+                    writeEntries(slug, kept);
+                }
+            }
+            return prunedCount;
+        },
+        count() {
+            const slugs = listProjectSlugs(dir);
+            let total = 0;
+            for (const slug of slugs) {
+                total += readEntries(slug).length;
+            }
+            return total;
+        },
+        exportJsonl() {
+            const slugs = listProjectSlugs(dir);
+            const lines = [];
+            for (const slug of slugs) {
+                const entries = readEntries(slug);
+                for (const entry of entries) {
+                    lines.push(JSON.stringify(entry));
+                }
+            }
+            return lines.join('\n') + '\n';
+        },
+    };
+}
+export function autoLearnFromRunReport(report) {
+    const entries = [];
+    const projectSlug = deriveProjectSlug();
+    const ts = new Date().toISOString();
+    // Learn from blocked runs
+    if (report.status === 'blocked') {
+        entries.push({
+            id: randomUUID(),
+            ts,
+            projectSlug,
+            category: 'failure',
+            title: `Run blocked: ${report.plan.task.slice(0, 80)}`,
+            detail: `Task "${report.plan.task}" was blocked. Governance mode: ${report.plan.governance?.mode ?? 'unknown'}.`,
+            evidenceIds: [],
+            tags: ['blocked', report.mode],
+            relevanceDecay: 0.3,
+        });
+    }
+    // Learn from failure learning candidates
+    for (const candidate of report.failureLearning.candidates) {
+        entries.push({
+            id: randomUUID(),
+            ts,
+            projectSlug,
+            category: 'failure',
+            title: candidate.title,
+            detail: candidate.summary,
+            evidenceIds: candidate.evidenceRefs,
+            tags: ['failure-learning', candidate.source, candidate.promotable ? 'promotable' : 'non-promotable'],
+            relevanceDecay: 0.2,
+        });
+    }
+    // Learn from verification failures
+    for (const cmd of report.verification.commands) {
+        if (cmd.status === 'failed') {
+            entries.push({
+                id: randomUUID(),
+                ts,
+                projectSlug,
+                category: 'failure',
+                title: `Verification failed: ${cmd.command}`,
+                detail: `Command "${cmd.command}" exited with code ${cmd.exitCode}.`,
+                evidenceIds: [],
+                tags: ['verification-failure', 'exit-code-' + cmd.exitCode],
+                relevanceDecay: 0.4,
+            });
+        }
+    }
+    return entries;
+}
+// ============================================================================
+// Load Relevant Learnings
+// ============================================================================
+export function loadRelevantLearnings(opts) {
+    const scaleDir = opts.scaleDir ?? '.scale';
+    const storePath = join(scaleDir, 'learnings');
+    const store = createLearningStore({ storePath });
+    const projectSlug = deriveProjectSlug(opts.projectDir);
+    const query = {
+        projectSlug,
+        tags: opts.tags,
+        limit: opts.limit ?? 10,
+    };
+    let results = store.search(query);
+    // If task is provided, filter by relevance to task keywords
+    if (opts.task) {
+        const taskWords = opts.task.toLowerCase().split(/\s+/).filter(w => w.length > 3);
+        results = results.filter(e => {
+            const entryText = `${e.title} ${e.detail}`.toLowerCase();
+            return taskWords.some(w => entryText.includes(w));
+        });
+    }
+    return results.slice(0, opts.limit ?? 10);
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function deriveProjectSlug(projectDir) {
+    try {
+        const dir = projectDir ?? process.cwd();
+        return basename(dir).replace(/[^a-zA-Z0-9-]/g, '-').toLowerCase();
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function listProjectSlugs(dir) {
+    if (!existsSync(dir))
+        return [];
+    try {
+        return readdirSync(dir)
+            .filter(f => f.endsWith('.jsonl'))
+            .map(f => f.replace('.jsonl', ''));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=SessionLearnings.js.map

package/dist/evolution/SessionLearnings.js.map

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

package/dist/runtime/AiOsRuntime.d.ts

@@ -4,6 +4,10 @@ import { type GovernanceMode, type ProgressiveGovernanceReport } from '../govern
 import type { IKnowledgeBase } from '../knowledge/KnowledgeBase.js';
 import { type ContextPack as MemoryContextPack, type MemoryProviderRecallItem } from '../memory/index.js';
 import { type SkillPlan, type SkillTaskLevel } from '../skills/routing/index.js';
+import { type WorkflowProfile } from '../workflow/AdaptiveWorkflowRouter.js';
+import { type EvolutionShadowReport } from '../workflow/EvolutionShadowPromoter.js';
+import { type LearningEntry } from '../evolution/SessionLearnings.js';
+import { type SessionPreamble } from '../workflow/SessionPreamble.js';
 export interface AiOsRuntimeInput {
     projectDir?: string;
     scaleDir?: string;
@@ -37,11 +41,67 @@ export interface AiOsMemoryRuntimeSummary {
 }
 export interface AiOsAdaptiveWorkflow {
     strategy: 'risk-adaptive-runtime-v1';
+    profile: WorkflowProfile;
+    escalationReasons: string[];
     mode: GovernanceMode;
     requiredBehaviors: string[];
     gates: string[];
     exitCriteria: string[];
 }
+export type AiOsEvaluatorGateId = 'architecture-critique' | 'root-cause-review' | 'security-threat-model' | 'release-readiness-review' | 'uncertainty-decision-log';
+export interface AiOsEvaluatorGate {
+    id: AiOsEvaluatorGateId;
+    required: boolean;
+    reason: string;
+    evidence: string[];
+}
+export interface AiOsEvaluatorIntelligence {
+    strategy: 'evaluator-intelligence-v1';
+    required: boolean;
+    riskLevel: 'low' | 'medium' | 'high';
+    uncertainty: {
+        score: number;
+        threshold: number;
+        drivers: string[];
+    };
+    gates: AiOsEvaluatorGate[];
+    recommendations: string[];
+}
+export type AiOsToolStrategyRisk = 'low' | 'medium' | 'high';
+export interface AiOsToolStrategyNode {
+    id: string;
+    kind: SkillPlan['executionPlan']['steps'][number]['kind'];
+    required: boolean;
+    cost: {
+        units: number;
+        timeRisk: AiOsToolStrategyRisk;
+        sideEffectRisk: AiOsToolStrategyRisk;
+    };
+    retry: {
+        maxAttempts: number;
+        backoff: 'none' | 'linear' | 'manual-review';
+    };
+    fallback: string;
+    evidence: string[];
+}
+export interface AiOsToolStrategyEdge {
+    from: string;
+    to: string;
+    reason: string;
+}
+export interface AiOsToolStrategyPlan {
+    strategy: 'tool-strategy-v1';
+    nodes: AiOsToolStrategyNode[];
+    edges: AiOsToolStrategyEdge[];
+    summary: {
+        totalSteps: number;
+        requiredSteps: number;
+        highRiskSteps: number;
+        estimatedCostUnits: number;
+        fallbackCoveredSteps: number;
+    };
+    recommendations: string[];
+}
 export interface AiOsRuntimePlan {
     version: string;
     generatedAt: string;
@@ -52,11 +112,16 @@ export interface AiOsRuntimePlan {
         files: string[];
         services: string[];
     };
+    preamble: SessionPreamble;
     governance: ProgressiveGovernanceReport;
     adaptiveWorkflow: AiOsAdaptiveWorkflow;
+    evaluator: AiOsEvaluatorIntelligence;
+    toolStrategy: AiOsToolStrategyPlan;
+    evolutionShadow: EvolutionShadowReport;
     context: BudgetedContextPack;
     memory: AiOsMemoryRuntimeSummary;
     skillPlan: SkillPlan;
+    sessionLearnings: LearningEntry[];
     roi: GovernanceRoiReport;
     recommendations: string[];
 }
@@ -172,6 +237,7 @@ export interface AiOsBenchmarkScenarioResult {
     task: string;
     level: SkillTaskLevel;
     governanceMode: GovernanceMode;
+    workflowProfile: WorkflowProfile;
     metrics: {
         estimatedTokens: number;
         budget: number;
@@ -180,6 +246,10 @@ export interface AiOsBenchmarkScenarioResult {
         selectedProviders: string[];
         skillSteps: number;
         requiredSkillSteps: number;
+        evaluatorGates: number;
+        toolStrategySteps: number;
+        toolStrategyCostUnits: number;
+        evolutionProposals: number;
         gates: number;
         roiModules: number;
     };
@@ -196,7 +266,12 @@ export interface AiOsBenchmarkReport {
         totalMemoryItems: number;
         totalSkillSteps: number;
         requiredSkillSteps: number;
+        totalEvaluatorGates: number;
+        totalToolStrategySteps: number;
+        totalToolStrategyCostUnits: number;
+        totalEvolutionProposals: number;
         governanceModes: GovernanceMode[];
+        workflowProfiles: WorkflowProfile[];
         averageTokenUtilization: number;
     };
     dashboard: AiOsDashboardReport;
@@ -335,7 +410,7 @@ export interface AiOsStatusReport {
     nextActions: string[];
     warnings: string[];
 }
-export type AiOsIntelligenceSignalId = 'memory-recall' | 'context-savings' | 'skill-routing' | 'benchmark-intelligence';
+export type AiOsIntelligenceSignalId = 'memory-recall' | 'context-savings' | 'skill-routing' | 'evaluator-intelligence' | 'tool-strategy' | 'adaptive-workflow' | 'evolution-shadow' | 'benchmark-intelligence';
 export interface AiOsIntelligenceSignal {
     id: AiOsIntelligenceSignalId;
     status: AiOsClosedLoopStatus;
@@ -353,6 +428,9 @@ export interface AiOsIntelligenceReport {
         selectedProviders: string[];
         memoryQuality: AiOsMemoryQualitySummary;
         contextQuality: AiOsContextQualitySummary;
+        evaluatorQuality: AiOsEvaluatorQualitySummary;
+        toolStrategyQuality: AiOsToolStrategyQualitySummary;
+        evolutionQuality: AiOsEvolutionQualitySummary;
         estimatedTokenSavings: number;
         skillSteps: number;
     };
@@ -374,6 +452,26 @@ export interface AiOsContextQualitySummary {
     highestOmittedTokens: number;
     compressionRisk: 'low' | 'medium' | 'high';
 }
+export interface AiOsEvaluatorQualitySummary {
+    requiredGates: number;
+    highRiskPlans: number;
+    averageUncertainty: number;
+    gateIds: AiOsEvaluatorGateId[];
+}
+export interface AiOsToolStrategyQualitySummary {
+    totalSteps: number;
+    requiredSteps: number;
+    highRiskSteps: number;
+    estimatedCostUnits: number;
+    fallbackCoverage: number;
+}
+export interface AiOsEvolutionQualitySummary {
+    proposals: number;
+    shadowRules: number;
+    candidateHooks: number;
+    approvedBlocking: number;
+    pendingValidation: number;
+}
 export declare function createAiOsPlan(input: AiOsRuntimeInput): Promise<AiOsRuntimePlan>;
 export declare function createAiOsRun(input: AiOsRunInput): Promise<AiOsRunReport>;
 export declare function createAiOsDashboard(input?: AiOsDashboardInput): AiOsDashboardReport;