@hongmaple0820/scale-engine 0.6.0 → 0.7.1

package/dist/evolution/EvolutionEvaluator.d.ts

@@ -0,0 +1,59 @@
+import type { IEventBus } from '../core/eventBus.js';
+import type { IKnowledgeBase } from '../knowledge/KnowledgeBase.js';
+import type { DetectorStatisticsTracker } from '../guardrails/DetectorEnhanced.js';
+export interface EvolutionMetrics {
+    lessonsProposed: number;
+    lessonsValidated: number;
+    lessonsApproved: number;
+    lessonsRejected: number;
+    lessonQualityScore: number;
+    rulesProposed: number;
+    rulesApproved: number;
+    rulesEnforced: number;
+    ruleEffectivenessScore: number;
+    hooksGenerated: number;
+    hooksDeployed: number;
+    hooksTriggered: number;
+    hookBlockingRate: number;
+    detectorTriggers: number;
+    detectorBlocks: number;
+    detectorWarnings: number;
+    detectorEffectivenessScore: number;
+    overallScore: number;
+    trend: 'improving' | 'stable' | 'declining';
+}
+export interface EvolutionSnapshot {
+    timestamp: number;
+    metrics: EvolutionMetrics;
+}
+export interface IEvolutionEvaluator {
+    evaluate(): Promise<EvolutionMetrics>;
+    getHistory(): EvolutionSnapshot[];
+    compareWithBaseline(baseline: EvolutionMetrics): Promise<{
+        improved: boolean;
+        delta: Partial<EvolutionMetrics>;
+    }>;
+    getRecommendations(): Promise<string[]>;
+}
+export declare class EvolutionEvaluator implements IEvolutionEvaluator {
+    private eventBus;
+    private stats?;
+    private history;
+    private maxHistory;
+    constructor(eventBus: IEventBus, _kb?: IKnowledgeBase, stats?: DetectorStatisticsTracker | undefined, opts?: {
+        maxHistory?: number;
+    });
+    evaluate(): Promise<EvolutionMetrics>;
+    getHistory(): EvolutionSnapshot[];
+    compareWithBaseline(baseline: EvolutionMetrics): Promise<{
+        improved: boolean;
+        delta: Partial<EvolutionMetrics>;
+    }>;
+    getRecommendations(): Promise<string[]>;
+    private countEvents;
+    private calculateLessonQuality;
+    private calculateRuleEffectiveness;
+    private calculateDetectorEffectiveness;
+    private calculateOverallScore;
+    private determineTrend;
+}

package/dist/evolution/EvolutionEvaluator.js

@@ -0,0 +1,115 @@
+// SCALE Engine — Evolution Evaluator (v0.7.0)
+// Self-evolution 循环效果评估
+import { logger } from '../core/logger.js';
+export class EvolutionEvaluator {
+    eventBus;
+    stats;
+    history = [];
+    maxHistory;
+    constructor(eventBus, 
+    // kb is reserved for future use with KB-based metrics
+    _kb, stats, opts = {}) {
+        this.eventBus = eventBus;
+        this.stats = stats;
+        this.maxHistory = opts.maxHistory ?? 30;
+    }
+    async evaluate() {
+        const metrics = {
+            lessonsProposed: await this.countEvents('lesson.proposed'),
+            lessonsValidated: await this.countEvents('lesson.validated'),
+            lessonsApproved: await this.countEvents('lesson.approved'),
+            lessonsRejected: await this.countEvents('lesson.rejected'),
+            lessonQualityScore: 0,
+            rulesProposed: await this.countEvents('rule.proposed'),
+            rulesApproved: await this.countEvents('rule.approved'),
+            rulesEnforced: await this.countEvents('rule.enforced'),
+            ruleEffectivenessScore: 0,
+            hooksGenerated: await this.countEvents('hook.generated'),
+            hooksDeployed: await this.countEvents('hook.deployed'),
+            hooksTriggered: await this.countEvents('tool.blocked'),
+            hookBlockingRate: 0,
+            detectorTriggers: this.stats ? this.stats.getRecentTriggers(100).length : 0,
+            detectorBlocks: this.stats ? this.stats.getRecentTriggers(100).filter(t => t.severity === 'block' || t.severity === 'deny').length : 0,
+            detectorWarnings: this.stats ? this.stats.getRecentTriggers(100).filter(t => t.severity === 'warn').length : 0,
+            detectorEffectivenessScore: 0,
+            overallScore: 0,
+            trend: 'stable',
+        };
+        metrics.lessonQualityScore = this.calculateLessonQuality(metrics);
+        metrics.ruleEffectivenessScore = this.calculateRuleEffectiveness(metrics);
+        metrics.hookBlockingRate = metrics.hooksTriggered > 0 ? metrics.detectorBlocks / metrics.hooksTriggered : 0;
+        metrics.detectorEffectivenessScore = this.calculateDetectorEffectiveness(metrics);
+        metrics.overallScore = this.calculateOverallScore(metrics);
+        metrics.trend = this.determineTrend(metrics);
+        this.history.push({ timestamp: Date.now(), metrics });
+        if (this.history.length > this.maxHistory)
+            this.history.shift();
+        this.eventBus.emit('evolution.evaluated', { score: metrics.overallScore, trend: metrics.trend });
+        logger.info({ score: metrics.overallScore, trend: metrics.trend }, 'Evolution evaluated');
+        return metrics;
+    }
+    getHistory() { return [...this.history]; }
+    async compareWithBaseline(baseline) {
+        const current = await this.evaluate();
+        const delta = {};
+        const keys = ['overallScore', 'lessonQualityScore', 'ruleEffectivenessScore', 'detectorEffectivenessScore'];
+        for (const key of keys) {
+            const currentVal = current[key];
+            const baselineVal = baseline[key];
+            const diff = currentVal - baselineVal;
+            // @ts-expect-error: Assigning number to optional field is intentional for delta calculation
+            delta[key] = diff;
+        }
+        const improved = delta.overallScore !== undefined && delta.overallScore > 0;
+        return { improved, delta };
+    }
+    async getRecommendations() {
+        const metrics = await this.evaluate();
+        const recommendations = [];
+        if (metrics.lessonQualityScore < 0.5)
+            recommendations.push('Lesson quality low. Focus on context-specific lessons.');
+        if (metrics.lessonsRejected > metrics.lessonsApproved)
+            recommendations.push('High rejection rate. Review validation criteria.');
+        if (metrics.rulesProposed > 0 && metrics.rulesApproved === 0)
+            recommendations.push('Rules proposed but none approved.');
+        if (metrics.hooksGenerated > metrics.hooksDeployed)
+            recommendations.push('Hooks not deployed. Run deployment.');
+        if (metrics.detectorWarnings > metrics.detectorBlocks * 3)
+            recommendations.push('Too many warnings. Consider stricter enforcement.');
+        return recommendations;
+    }
+    async countEvents(type) {
+        const events = await this.eventBus.query({ types: [type], limit: 1000 });
+        return events.length;
+    }
+    calculateLessonQuality(m) {
+        if (m.lessonsProposed === 0)
+            return 0;
+        return (m.lessonsApproved / m.lessonsProposed) * 0.6 + (m.lessonsValidated / m.lessonsProposed) * 0.4;
+    }
+    calculateRuleEffectiveness(m) {
+        if (m.rulesApproved === 0)
+            return 0;
+        return Math.min(1, m.rulesEnforced / m.rulesApproved);
+    }
+    calculateDetectorEffectiveness(m) {
+        if (m.detectorTriggers === 0)
+            return 0;
+        return Math.min(1, (m.detectorBlocks / m.detectorTriggers) * 2);
+    }
+    calculateOverallScore(m) {
+        return m.lessonQualityScore * 0.3 + m.ruleEffectivenessScore * 0.25 + m.detectorEffectivenessScore * 0.25 + (m.hookBlockingRate > 0 ? 0.2 : 0);
+    }
+    determineTrend(m) {
+        if (this.history.length < 2)
+            return 'stable';
+        const prev = this.history[this.history.length - 2].metrics.overallScore;
+        const delta = m.overallScore - prev;
+        if (delta > 0.05)
+            return 'improving';
+        if (delta < -0.05)
+            return 'declining';
+        return 'stable';
+    }
+}
+//# sourceMappingURL=EvolutionEvaluator.js.map

package/dist/evolution/EvolutionEvaluator.js.map

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

package/dist/evolution/LessonValidator.d.ts

@@ -0,0 +1,36 @@
+import type { KnowledgeEntry } from '../artifact/types.js';
+import type { IEventBus } from '../core/eventBus.js';
+import type { IKnowledgeBase } from '../knowledge/KnowledgeBase.js';
+export interface ValidationResult {
+    valid: boolean;
+    gateResults: GateResult[];
+    overallScore: number;
+    reason?: string;
+}
+export interface GateResult {
+    gateName: string;
+    passed: boolean;
+    score: number;
+    details: string;
+}
+export interface ILessonValidator {
+    validate(entry: Omit<KnowledgeEntry, 'id' | 'createdAt' | 'accessCount' | 'relevance'>): Promise<ValidationResult>;
+    checkGoogleability(title: string): Promise<GateResult>;
+    checkContextSpecific(entry: Omit<KnowledgeEntry, 'id' | 'createdAt' | 'accessCount' | 'relevance'>): Promise<GateResult>;
+    checkDuplicate(title: string, contentRef: string): Promise<GateResult>;
+}
+export declare class LessonValidator implements ILessonValidator {
+    private eventBus;
+    private kb;
+    private minGoogleabilityScore;
+    private maxDuplicateSimilarity;
+    constructor(eventBus: IEventBus, kb?: IKnowledgeBase, opts?: {
+        minGoogleabilityScore?: number;
+        maxDuplicateSimilarity?: number;
+    });
+    validate(entry: Omit<KnowledgeEntry, 'id' | 'createdAt' | 'accessCount' | 'relevance'>): Promise<ValidationResult>;
+    checkGoogleability(title: string): Promise<GateResult>;
+    checkContextSpecific(entry: Omit<KnowledgeEntry, 'id' | 'createdAt' | 'accessCount' | 'relevance'>): Promise<GateResult>;
+    checkDuplicate(title: string, _contentRef: string): Promise<GateResult>;
+    private calculateSimilarity;
+}

package/dist/evolution/LessonValidator.js

@@ -0,0 +1,136 @@
+// SCALE Engine — Lesson Validator (v0.7.0)
+// Lesson 提取验证：Googleability、Context-Specific、Non-Duplicate
+import { logger } from '../core/logger.js';
+export class LessonValidator {
+    eventBus;
+    kb;
+    minGoogleabilityScore;
+    maxDuplicateSimilarity;
+    constructor(eventBus, kb, opts = {}) {
+        this.eventBus = eventBus;
+        this.kb = kb ?? null;
+        this.minGoogleabilityScore = opts.minGoogleabilityScore ?? 0.3;
+        this.maxDuplicateSimilarity = opts.maxDuplicateSimilarity ?? 0.8;
+    }
+    async validate(entry) {
+        const gateResults = [];
+        // Gate 1: Trigger Check (already done by LessonExtractor)
+        const triggerGate = {
+            gateName: 'trigger',
+            passed: true,
+            score: 1.0,
+            details: 'Defect passed trigger conditions',
+        };
+        gateResults.push(triggerGate);
+        // Gate 2: Googleability (not easily searchable)
+        const googleabilityGate = await this.checkGoogleability(entry.title);
+        gateResults.push(googleabilityGate);
+        // Gate 3: Context-Specific (references specific artifacts)
+        const contextGate = await this.checkContextSpecific(entry);
+        gateResults.push(contextGate);
+        // Gate 4: Deduplication
+        const duplicateGate = await this.checkDuplicate(entry.title, entry.contentRef);
+        gateResults.push(duplicateGate);
+        // Calculate overall score
+        const totalScore = gateResults.reduce((sum, g) => sum + g.score, 0) / gateResults.length;
+        const allPassed = gateResults.every(g => g.passed);
+        const result = {
+            valid: allPassed,
+            gateResults,
+            overallScore: totalScore,
+            reason: allPassed ? undefined : 'Failed gates: ' + gateResults.filter(g => !g.passed).map(g => g.gateName).join(', '),
+        };
+        this.eventBus.emit('lesson.validated', {
+            title: entry.title,
+            valid: result.valid,
+            score: result.overallScore,
+            gates: gateResults,
+        });
+        logger.info({ title: entry.title, valid: result.valid, score: totalScore }, 'Lesson validated');
+        return result;
+    }
+    async checkGoogleability(title) {
+        // Simulate googleability check (in production, would call actual search API)
+        // High googleability = easily found on Google = not unique enough
+        // We want lessons that are NOT easily googleable (context-specific)
+        // Placeholder implementation: check for generic terms
+        const genericTerms = [
+            'error', 'bug', 'fix', 'issue', 'how to', 'tutorial',
+            'guide', 'documentation', 'reference', 'api', 'example',
+        ];
+        const titleLower = title.toLowerCase();
+        const hasGenericTerm = genericTerms.some(t => titleLower.includes(t));
+        // If title has many generic terms, it's probably googleable (bad)
+        // We want titles that are specific enough that you can't just Google them
+        const score = hasGenericTerm ? 0.2 : 0.8;
+        const passed = score >= this.minGoogleabilityScore;
+        return {
+            gateName: 'googleability',
+            passed,
+            score,
+            details: passed
+                ? 'Title is context-specific, not easily googleable'
+                : 'Title contains generic terms, likely googleable',
+        };
+    }
+    async checkContextSpecific(entry) {
+        // Check if lesson references specific context (artifact, project, specific code)
+        const hasSourceArtifact = entry.sourceArtifact !== undefined;
+        const hasTags = entry.tags.length > 0;
+        // Check content for context markers
+        const contentRef = entry.contentRef.toLowerCase();
+        const hasContextMarkers = /art-|spec-|plan-|task-|defect-/.test(contentRef);
+        const score = (hasSourceArtifact ? 0.4 : 0) + (hasTags ? 0.3 : 0) + (hasContextMarkers ? 0.3 : 0);
+        const passed = score >= 0.5;
+        return {
+            gateName: 'context_specific',
+            passed,
+            score,
+            details: passed
+                ? 'Lesson has context markers (artifact refs, tags)'
+                : 'Lesson lacks specific context references',
+        };
+    }
+    async checkDuplicate(title, _contentRef) {
+        if (!this.kb) {
+            return {
+                gateName: 'deduplication',
+                passed: true,
+                score: 1.0,
+                details: 'No KB available for deduplication check',
+            };
+        }
+        // Check for similar lessons in KB
+        const existing = await this.kb.recall({
+            tags: [],
+            limit: 100,
+        });
+        // Simple title similarity check
+        const titleLower = title.toLowerCase();
+        let maxSimilarity = 0;
+        for (const entry of existing) {
+            const existingTitle = entry.title.toLowerCase();
+            const similarity = this.calculateSimilarity(titleLower, existingTitle);
+            maxSimilarity = Math.max(maxSimilarity, similarity);
+        }
+        const passed = maxSimilarity < this.maxDuplicateSimilarity;
+        const score = 1 - maxSimilarity;
+        return {
+            gateName: 'deduplication',
+            passed,
+            score,
+            details: passed
+                ? 'No similar lesson found (max similarity: ' + maxSimilarity.toFixed(2) + ')'
+                : 'Similar lesson exists (similarity: ' + maxSimilarity.toFixed(2) + ')',
+        };
+    }
+    calculateSimilarity(a, b) {
+        // Simple word overlap similarity
+        const wordsA = a.split(/\s+/);
+        const wordsB = b.split(/\s+/);
+        const intersection = wordsA.filter(w => wordsB.includes(w));
+        const union = [...new Set([...wordsA, ...wordsB])];
+        return intersection.length / union.length;
+    }
+}
+//# sourceMappingURL=LessonValidator.js.map

package/dist/evolution/LessonValidator.js.map

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

package/dist/fsm/FSMAgentBridge.d.ts

@@ -0,0 +1,59 @@
+import type { IArtifactStore } from "../artifact/store.js";
+import type { IFSM } from "../artifact/fsm.js";
+import type { IEventBus } from "../core/eventBus.js";
+export interface FSMContextSnapshot {
+    artifactId: string;
+    artifactType: string;
+    currentStatus: string;
+    allowedTransitions: string[];
+    blockingReasons: string[];
+    downstreamImpact: string[];
+    parentStatus?: string;
+    childrenStatuses: string[];
+}
+export interface SessionFSMContext {
+    sessionId: string;
+    artifacts: FSMContextSnapshot[];
+    recalledLessons: string[];
+    recommendations: string[];
+    generatedAt: number;
+}
+export interface IFSMAgentBridge {
+    getFSMContext(artifactId: string): Promise<FSMContextSnapshot | null>;
+    getSessionContext(sessionId: string, eventBus: IEventBus): Promise<SessionFSMContext>;
+    checkOperation(artifactId: string, operation: string): Promise<{
+        allowed: boolean;
+        reasons: string[];
+    }>;
+    getCreationPrerequisites(artifactType: string): Promise<{
+        requiredParentStatus: string[];
+        message: string;
+    }>;
+    injectFSMContextToPrompt(prompt: string, artifactIds: string[]): Promise<string>;
+}
+export declare class FSMAgentBridge implements IFSMAgentBridge {
+    private fsm;
+    private store;
+    constructor(fsm: IFSM, store: IArtifactStore);
+    getFSMContext(artifactId: string): Promise<FSMContextSnapshot | null>;
+    checkOperation(artifactId: string, operation: string): Promise<{
+        allowed: boolean;
+        reasons: string[];
+    }>;
+    getCreationPrerequisites(artifactType: string): Promise<{
+        requiredParentStatus: string[];
+        message: string;
+    }>;
+    /**
+     * Get FSM context for all artifacts related to a session
+     * This is the primary method for SessionStart hook to inject context
+     */
+    getSessionContext(sessionId: string, eventBus: IEventBus): Promise<SessionFSMContext>;
+    /**
+     * Generate actionable recommendations from FSM state
+     */
+    private generateRecommendations;
+    injectFSMContextToPrompt(prompt: string, artifactIds: string[]): Promise<string>;
+    private calculateDownstreamImpact;
+    private formatFSMBlock;
+}

package/dist/fsm/FSMAgentBridge.js

@@ -0,0 +1,195 @@
+// SCALE Engine — FSM Agent Bridge (v0.7.0)
+// 让 Agent 能感知 FSM 状态约束
+export class FSMAgentBridge {
+    fsm;
+    store;
+    constructor(fsm, store) {
+        this.fsm = fsm;
+        this.store = store;
+    }
+    async getFSMContext(artifactId) {
+        const artifact = await this.store.get(artifactId);
+        if (!artifact)
+            return null;
+        const fsmDef = this.fsm.getDefinition(artifact.type);
+        if (!fsmDef)
+            return null;
+        // 计算允许的迁移
+        const availableActions = await this.fsm.availableActions(artifactId);
+        // 计算阻塞原因
+        const blockingReasons = [];
+        // 找出从当前状态出发的所有迁移
+        const transitionsFromCurrent = fsmDef.transitions.filter(t => t.from === artifact.status);
+        for (const tx of transitionsFromCurrent) {
+            const result = await this.fsm.canTransition(artifactId, tx.action);
+            if (!result.allowed && result.blockedBy) {
+                blockingReasons.push(`${tx.action}: ${result.blockedBy.map(g => g.message).join(', ')}`);
+            }
+        }
+        // 下游影响
+        const downstreamImpact = await this.calculateDownstreamImpact(artifact);
+        // 父子状态
+        const parentStatus = artifact.parents.length > 0
+            ? (await this.store.get(artifact.parents[0]))?.status
+            : undefined;
+        const childrenStatuses = (await this.store.findChildren(artifactId))
+            .map(c => c.status);
+        return {
+            artifactId,
+            artifactType: artifact.type,
+            currentStatus: artifact.status,
+            allowedTransitions: availableActions,
+            blockingReasons,
+            downstreamImpact,
+            parentStatus,
+            childrenStatuses,
+        };
+    }
+    async checkOperation(artifactId, operation) {
+        const artifact = await this.store.get(artifactId);
+        if (!artifact)
+            return { allowed: false, reasons: ['Artifact not found'] };
+        const fsmDef = this.fsm.getDefinition(artifact.type);
+        if (!fsmDef)
+            return { allowed: false, reasons: ['No FSM definition for this artifact type'] };
+        // 检查是否是合法迁移
+        const transitionsFromCurrent = fsmDef.transitions.filter(t => t.from === artifact.status);
+        const transition = transitionsFromCurrent.find(t => t.action === operation);
+        if (!transition) {
+            const allowed = transitionsFromCurrent.map(t => t.action).join(', ') || 'none';
+            return {
+                allowed: false,
+                reasons: [`"${operation}" is not a valid transition from ${artifact.status}. Allowed: ${allowed}`]
+            };
+        }
+        // 检查 Guards
+        const result = await this.fsm.canTransition(artifactId, operation);
+        if (!result.allowed && result.blockedBy) {
+            return { allowed: false, reasons: result.blockedBy.map(g => g.message) };
+        }
+        return { allowed: true, reasons: [] };
+    }
+    async getCreationPrerequisites(artifactType) {
+        // 基于 FSM 定义判断创建条件
+        const fsmDef = this.fsm.getDefinition(artifactType);
+        if (!fsmDef)
+            return { requiredParentStatus: [], message: 'No FSM definition available' };
+        // 从 FSM 定义中提取依赖关系（简化实现）
+        const deps = {
+            Plan: { parentType: 'Spec', parentStatus: 'FROZEN' },
+            Task: { parentType: 'Plan', parentStatus: 'APPROVED' },
+            Change: { parentType: 'Task', parentStatus: 'IN_PROGRESS' },
+            Evidence: { parentType: 'Task', parentStatus: 'DONE' },
+        };
+        const dep = deps[artifactType];
+        if (dep) {
+            return {
+                requiredParentStatus: [`${dep.parentType} must be in ${dep.parentStatus} status`],
+                message: `Creating ${artifactType} requires parent ${dep.parentType} to be ${dep.parentStatus}`,
+            };
+        }
+        return { requiredParentStatus: [], message: 'No special prerequisites' };
+    }
+    /**
+     * Get FSM context for all artifacts related to a session
+     * This is the primary method for SessionStart hook to inject context
+     */
+    async getSessionContext(sessionId, eventBus) {
+        // Find all artifacts related to this session
+        const events = await eventBus.query({
+            sessionId,
+            types: ['artifact.created', 'artifact.transitioned'],
+            limit: 50,
+        });
+        const artifactIds = new Set();
+        for (const event of events) {
+            if (event.artifactId)
+                artifactIds.add(event.artifactId);
+        }
+        // Get FSM snapshots for each artifact
+        const snapshots = await Promise.all(Array.from(artifactIds).map(id => this.getFSMContext(id)));
+        const validSnapshots = snapshots.filter(Boolean);
+        // Generate recommendations based on FSM state
+        const recommendations = this.generateRecommendations(validSnapshots);
+        return {
+            sessionId,
+            artifacts: validSnapshots,
+            recalledLessons: [], // Will be filled by context inject command
+            recommendations,
+            generatedAt: Date.now(),
+        };
+    }
+    /**
+     * Generate actionable recommendations from FSM state
+     */
+    generateRecommendations(snapshots) {
+        const recs = [];
+        for (const s of snapshots) {
+            // Spec needs to be frozen before implementation
+            if (s.artifactType === 'Spec' && s.currentStatus === 'REVIEWING') {
+                if (s.allowedTransitions.includes('freeze')) {
+                    recs.push(`Spec ${s.artifactId} is ready to freeze — execute 'scale transition ${s.artifactId} freeze'`);
+                }
+                else {
+                    recs.push(`Spec ${s.artifactId} blocked from freezing: ${s.blockingReasons.join('; ')}`);
+                }
+            }
+            // Plan needs approval before implementation
+            if (s.artifactType === 'Plan' && s.currentStatus === 'DRAFT') {
+                recs.push(`Plan ${s.artifactId} needs review before implementation`);
+            }
+            // Task ready to start
+            if (s.artifactType === 'Task' && s.currentStatus === 'READY') {
+                recs.push(`Task ${s.artifactId} is ready to implement`);
+            }
+            // Warning for blocked artifacts
+            if (s.blockingReasons.length > 0 && s.allowedTransitions.length === 0) {
+                recs.push(`⚠️ ${s.artifactId} (${s.artifactType}) is blocked in ${s.currentStatus}`);
+            }
+        }
+        return recs;
+    }
+    async injectFSMContextToPrompt(prompt, artifactIds) {
+        if (artifactIds.length === 0)
+            return prompt;
+        const snapshots = await Promise.all(artifactIds.map(id => this.getFSMContext(id)));
+        const validSnapshots = snapshots.filter(Boolean);
+        if (validSnapshots.length === 0)
+            return prompt;
+        const fsmBlock = this.formatFSMBlock(validSnapshots);
+        // 插入到 prompt 的合适位置
+        const insertPoints = ['<context_summary>', '## Task', '## Context', '## 上下文'];
+        for (const point of insertPoints) {
+            if (prompt.includes(point)) {
+                return prompt.replace(point, fsmBlock + '\n' + point);
+            }
+        }
+        // 如果找不到合适位置，添加到末尾
+        return prompt + '\n' + fsmBlock;
+    }
+    async calculateDownstreamImpact(artifact) {
+        const children = await this.store.findChildren(artifact.id);
+        return children.map(c => `${c.id} (${c.type}:${c.status})`);
+    }
+    formatFSMBlock(snapshots) {
+        const lines = snapshots.map(s => {
+            const allowed = s.allowedTransitions.length > 0 ? s.allowedTransitions.join(', ') : 'none';
+            const blocked = s.blockingReasons.length > 0 ? s.blockingReasons.slice(0, 3).join('; ') : 'none';
+            const impact = s.downstreamImpact.length > 0 ? `${s.downstreamImpact.length} children` : 'none';
+            return `### ${s.artifactId} (${s.artifactType})
+- Status: **${s.currentStatus}**
+- Allowed actions: ${allowed}
+- Blocked: ${blocked}
+- Downstream impact: ${impact}
+- Parent: ${s.parentStatus ?? 'none'}
+- Children: ${s.childrenStatuses.length > 0 ? s.childrenStatuses.join(', ') : 'none'}`;
+        });
+        return `\n## FSM Status Constraints
+
+${lines.join('\n\n')}
+
+> **Important**: Only execute actions listed in "Allowed actions". Blocked actions require resolving constraints first.
+`;
+    }
+}
+//# sourceMappingURL=FSMAgentBridge.js.map

package/dist/fsm/FSMAgentBridge.js.map

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

package/dist/fsm/index.d.ts

@@ -0,0 +1,2 @@
+export { FSMAgentBridge } from './FSMAgentBridge.js';
+export type { IFSMAgentBridge, FSMContextSnapshot } from './FSMAgentBridge.js';

package/dist/fsm/index.js

@@ -0,0 +1,3 @@
+// SCALE Engine — FSM Module (v0.7.0)
+export { FSMAgentBridge } from './FSMAgentBridge.js';
+//# sourceMappingURL=index.js.map

package/dist/fsm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fsm/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAErC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}