@hongmaple0820/med-scale-research-os 0.43.0

package/dist/fsm/FSMAgentBridge.js

@@ -0,0 +1,193 @@
+// SCALE Engine — FSM Agent Bridge (v0.7.0)
+// 让 Agent 能感知 FSM 状态约束
+export class FSMAgentBridge {
+    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":"AAAA,2CAA2C;AAC3C,uBAAuB;AAkCvB,MAAM,OAAO,cAAc;IACzB,YACU,GAAS,EACT,KAAqB;QADrB,QAAG,GAAH,GAAG,CAAM;QACT,UAAK,GAAL,KAAK,CAAgB;IAC5B,CAAC;IAEJ,KAAK,CAAC,aAAa,CAAC,UAAkB;QACpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QACjD,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAA;QAE1B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACpD,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAA;QAExB,UAAU;QACV,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAA;QAEpE,SAAS;QACT,MAAM,eAAe,GAAa,EAAE,CAAA;QAEpC,iBAAiB;QACjB,MAAM,sBAAsB,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAA;QAEzF,KAAK,MAAM,EAAE,IAAI,sBAAsB,EAAE,CAAC;YACxC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,CAAA;YAClE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACxC,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC1F,CAAC;QACH,CAAC;QAED,OAAO;QACP,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAA;QAEvE,OAAO;QACP,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAC9C,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM;YACrD,CAAC,CAAC,SAAS,CAAA;QACb,MAAM,gBAAgB,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;aACjE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;QAErB,OAAO;YACL,UAAU;YACV,YAAY,EAAE,QAAQ,CAAC,IAAI;YAC3B,aAAa,EAAE,QAAQ,CAAC,MAAM;YAC9B,kBAAkB,EAAE,gBAAgB;YACpC,eAAe;YACf,gBAAgB;YAChB,YAAY;YACZ,gBAAgB;SACjB,CAAA;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAAkB,EAAE,SAAiB;QACxD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QACjD,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,oBAAoB,CAAC,EAAE,CAAA;QAEzE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACpD,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,0CAA0C,CAAC,EAAE,CAAA;QAE7F,YAAY;QACZ,MAAM,sBAAsB,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAA;QACzF,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAA;QAE3E,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAA;YAC9E,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,CAAC,IAAI,SAAS,oCAAoC,QAAQ,CAAC,MAAM,cAAc,OAAO,EAAE,CAAC;aACnG,CAAA;QACH,CAAC;QAED,YAAY;QACZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;QAClE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACxC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAA;QAC1E,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAA;IACvC,CAAC;IAED,KAAK,CAAC,wBAAwB,CAAC,YAAoB;QACjD,kBAAkB;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,YAAmB,CAAC,CAAA;QAC1D,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,oBAAoB,EAAE,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAA;QAExF,wBAAwB;QACxB,MAAM,IAAI,GAAiE;YACzE,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE;YACpD,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE;YACtD,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE;YAC3D,QAAQ,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE;SACvD,CAAA;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,CAAA;QAC9B,IAAI,GAAG,EAAE,CAAC;YACR,OAAO;gBACL,oBAAoB,EAAE,CAAC,GAAG,GAAG,CAAC,UAAU,eAAe,GAAG,CAAC,YAAY,SAAS,CAAC;gBACjF,OAAO,EAAE,YAAY,YAAY,oBAAoB,GAAG,CAAC,UAAU,UAAU,GAAG,CAAC,YAAY,EAAE;aAChG,CAAA;QACH,CAAC;QAED,OAAO,EAAE,oBAAoB,EAAE,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAA;IAC1E,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CACrB,SAAiB,EACjB,QAAmB;QAEnB,6CAA6C;QAC7C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC;YAClC,SAAS;YACT,KAAK,EAAE,CAAC,kBAAkB,EAAE,uBAAuB,CAAgB;YACnE,KAAK,EAAE,EAAE;SACV,CAAC,CAAA;QAEF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAA;QACrC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,UAAU;gBAAE,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QACzD,CAAC;QAED,sCAAsC;QACtC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAC1D,CAAA;QACD,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAyB,CAAA;QAExE,8CAA8C;QAC9C,MAAM,eAAe,GAAG,IAAI,CAAC,uBAAuB,CAAC,cAAc,CAAC,CAAA;QAEpE,OAAO;YACL,SAAS;YACT,SAAS,EAAE,cAAc;YACzB,eAAe,EAAE,EAAE,EAAE,2CAA2C;YAChE,eAAe;YACf,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;SACxB,CAAA;IACH,CAAC;IAED;;OAEG;IACK,uBAAuB,CAAC,SAA+B;QAC7D,MAAM,IAAI,GAAa,EAAE,CAAA;QAEzB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,gDAAgD;YAChD,IAAI,CAAC,CAAC,YAAY,KAAK,MAAM,IAAI,CAAC,CAAC,aAAa,KAAK,WAAW,EAAE,CAAC;gBACjE,IAAI,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,UAAU,mDAAmD,CAAC,CAAC,UAAU,UAAU,CAAC,CAAA;gBAC1G,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,UAAU,2BAA2B,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBAC1F,CAAC;YACH,CAAC;YAED,4CAA4C;YAC5C,IAAI,CAAC,CAAC,YAAY,KAAK,MAAM,IAAI,CAAC,CAAC,aAAa,KAAK,OAAO,EAAE,CAAC;gBAC7D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,UAAU,qCAAqC,CAAC,CAAA;YACtE,CAAC;YAED,sBAAsB;YACtB,IAAI,CAAC,CAAC,YAAY,KAAK,MAAM,IAAI,CAAC,CAAC,aAAa,KAAK,OAAO,EAAE,CAAC;gBAC7D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,UAAU,wBAAwB,CAAC,CAAA;YACzD,CAAC;YAED,gCAAgC;YAChC,IAAI,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,YAAY,mBAAmB,CAAC,CAAC,aAAa,EAAE,CAAC,CAAA;YACtF,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAEH,KAAK,CAAC,wBAAwB,CAAC,MAAc,EAAE,WAAqB;QAChE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAA;QAE3C,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAC9C,CAAA;QAED,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAyB,CAAA;QACxE,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAA;QAE9C,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,CAAA;QAEpD,mBAAmB;QACnB,MAAM,YAAY,GAAG,CAAC,mBAAmB,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAA;QAC7E,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;YACjC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,KAAK,CAAC,CAAA;YACvD,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,OAAO,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAA;IACjC,CAAC;IAEO,KAAK,CAAC,yBAAyB,CAAC,QAAkB;QACxD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;QAC3D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;IAC7D,CAAC;IAEO,cAAc,CAAC,SAA+B;QACpD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAC9B,MAAM,OAAO,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;YAC1F,MAAM,OAAO,GAAG,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;YAChG,MAAM,MAAM,GAAG,CAAC,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,gBAAgB,CAAC,MAAM,WAAW,CAAC,CAAC,CAAC,MAAM,CAAA;YAE/F,OAAO,OAAO,CAAC,CAAC,UAAU,KAAK,CAAC,CAAC,YAAY;cACrC,CAAC,CAAC,aAAa;qBACR,OAAO;aACf,OAAO;uBACG,MAAM;YACjB,CAAC,CAAC,YAAY,IAAI,MAAM;cACtB,CAAC,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;QAClF,CAAC,CAAC,CAAA;QAEF,OAAO;;EAET,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;;;CAGnB,CAAA;IACC,CAAC;CACF"}

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"}

package/dist/governance/GovernanceRoi.d.ts

@@ -0,0 +1,30 @@
+import type { ContextBudgetReport, ContextPack } from '../context/ContextBudget.js';
+import type { CodeGraphQueryReport } from '../codegraph/CodeIntelligence.js';
+import type { MemoryProviderRecallReport } from '../memory/MemoryProviders.js';
+import type { SkillPlan } from '../skills/routing/index.js';
+import type { ProgressiveGovernanceReport } from './ProgressiveGovernance.js';
+export interface GovernanceRoiModule {
+    module: string;
+    evidenceLevel: 'measured' | 'estimated' | 'missing';
+    benefit: string;
+    overhead: string;
+    recommendation: 'keep-default' | 'keep-optional' | 'demote' | 'needs-evidence';
+}
+export interface GovernanceRoiReport {
+    taskId?: string;
+    generatedAt: string;
+    summary: {
+        evidenceLevel: 'measured' | 'estimated' | 'missing';
+        recommendation: 'keep-default' | 'keep-optional' | 'demote' | 'needs-evidence';
+    };
+    modules: GovernanceRoiModule[];
+}
+export declare function createGovernanceRoiReport(options: {
+    taskId?: string;
+    contextBudget?: ContextBudgetReport;
+    contextPack?: ContextPack;
+    codeIntelligence?: CodeGraphQueryReport;
+    governance?: ProgressiveGovernanceReport;
+    memoryRecall?: MemoryProviderRecallReport;
+    skillPlan?: SkillPlan;
+}): GovernanceRoiReport;

package/dist/governance/GovernanceRoi.js

@@ -0,0 +1,102 @@
+export function createGovernanceRoiReport(options) {
+    const modules = [];
+    if (options.contextBudget) {
+        const budget = options.contextBudget;
+        modules.push({
+            module: 'context-budget',
+            evidenceLevel: 'estimated',
+            benefit: `Visible context cost: ${budget.summary.totalTokens} estimated tokens across ${budget.summary.totalFiles} files; Always-loaded cost ${budget.summary.alwaysTokens}.`,
+            overhead: 'One filesystem scan over governance and documentation artifacts.',
+            recommendation: budget.summary.alwaysTokens <= budget.thresholds.maxAlwaysTokens ? 'keep-default' : 'needs-evidence',
+        });
+    }
+    else {
+        modules.push({
+            module: 'context-budget',
+            evidenceLevel: 'missing',
+            benefit: 'No context budget evidence available.',
+            overhead: 'Unknown.',
+            recommendation: 'needs-evidence',
+        });
+    }
+    if (options.contextPack?.compiler) {
+        const compiler = options.contextPack.compiler;
+        modules.push({
+            module: 'context-compiler',
+            evidenceLevel: 'estimated',
+            benefit: `Selected ${options.contextPack.sections.filter(section => section.included).length}/${options.contextPack.sections.length} context section(s); estimated savings ${compiler.estimatedTokenSavings} tokens from ${compiler.totalCandidateTokens} candidates.`,
+            overhead: `One relevance ranking pass with ${compiler.ranking.length} candidate section(s).`,
+            recommendation: compiler.estimatedTokenSavings > 0 ? 'keep-default' : 'keep-optional',
+        });
+    }
+    if (options.governance) {
+        const governance = options.governance;
+        modules.push({
+            module: 'progressive-governance',
+            evidenceLevel: 'estimated',
+            benefit: `Recommended ${governance.recommendedMode} mode from ${governance.signals.length} risk signal(s); effective mode ${governance.effectiveMode}.`,
+            overhead: `${governance.requiredBehaviors.length} required behavior(s) activated.`,
+            recommendation: governance.effectiveMode === 'minimal' ? 'keep-default' : 'keep-optional',
+        });
+    }
+    else {
+        modules.push({
+            module: 'progressive-governance',
+            evidenceLevel: 'missing',
+            benefit: 'No risk-signal evaluation available.',
+            overhead: 'Unknown.',
+            recommendation: 'needs-evidence',
+        });
+    }
+    if (options.memoryRecall) {
+        const memory = options.memoryRecall;
+        modules.push({
+            module: 'memory-provider-runtime',
+            evidenceLevel: memory.items.length > 0 ? 'estimated' : 'missing',
+            benefit: memory.items.length > 0
+                ? `Recalled ${memory.items.length} memory item(s) from ${memory.selectedProviders.join(', ') || 'no provider'}; fallback used: ${memory.fallbackUsed}.`
+                : `No memory item recalled; provider order was ${memory.providerOrder.join(' -> ')}.`,
+            overhead: `${memory.providerOrder.length} provider route(s), ${memory.warnings.length} warning(s).`,
+            recommendation: memory.items.length > 0 ? 'keep-default' : 'keep-optional',
+        });
+    }
+    if (options.skillPlan) {
+        const plan = options.skillPlan;
+        modules.push({
+            module: 'skill-routing-engine',
+            evidenceLevel: plan.executionPlan.steps.length > 0 ? 'estimated' : 'missing',
+            benefit: `Detected ${plan.intents.length} intent(s), ${plan.requiredSkills.length} required skill(s), and ${plan.executionPlan.steps.length} executable evidence step(s).`,
+            overhead: `${plan.requiredArtifacts.length} required artifact(s), ${plan.requiredVerification.length} verification evidence item(s).`,
+            recommendation: plan.requiredSkills.length > 0 || plan.requiredArtifacts.length > 0 ? 'keep-default' : 'keep-optional',
+        });
+    }
+    if (options.codeIntelligence) {
+        const code = options.codeIntelligence;
+        modules.push({
+            module: 'code-intelligence',
+            evidenceLevel: code.fallbackUsed ? 'estimated' : 'measured',
+            benefit: code.fallbackUsed
+                ? `No graph provider answered "${code.query}"; fallback found ${code.files.length} file(s) with ${code.roi.fileReadsSaved} estimated reads saved by scoping.`
+                : `Graph provider ${code.provider} returned ${code.hits.length} hit(s), ${code.files.length} file(s), and ${code.roi.fileReadsSaved} estimated file reads saved.`,
+            overhead: code.fallbackUsed ? 'One scoped source scan fallback.' : 'One code intelligence provider query.',
+            recommendation: code.fallbackUsed ? 'needs-evidence' : 'keep-optional',
+        });
+    }
+    const summary = summarize(modules);
+    return {
+        taskId: options.taskId,
+        generatedAt: new Date().toISOString(),
+        summary,
+        modules,
+    };
+}
+function summarize(modules) {
+    if (modules.some(module => module.recommendation === 'needs-evidence')) {
+        return { evidenceLevel: 'estimated', recommendation: 'needs-evidence' };
+    }
+    if (modules.some(module => module.recommendation === 'keep-optional')) {
+        return { evidenceLevel: 'estimated', recommendation: 'keep-optional' };
+    }
+    return { evidenceLevel: 'estimated', recommendation: 'keep-default' };
+}
+//# sourceMappingURL=GovernanceRoi.js.map

package/dist/governance/GovernanceRoi.js.map

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

package/dist/governance/ProgressiveGovernance.d.ts

@@ -0,0 +1,22 @@
+export type GovernanceMode = 'minimal' | 'standard' | 'expanded' | 'critical';
+export interface GovernanceRiskSignal {
+    id: string;
+    mode: GovernanceMode;
+    reason: string;
+    evidence: string[];
+}
+export interface ProgressiveGovernanceInput {
+    task?: string;
+    changedFiles?: string[];
+    requestedMode?: GovernanceMode;
+}
+export interface ProgressiveGovernanceReport {
+    requestedMode?: GovernanceMode;
+    recommendedMode: GovernanceMode;
+    effectiveMode: GovernanceMode;
+    escalated: boolean;
+    signals: GovernanceRiskSignal[];
+    requiredBehaviors: string[];
+}
+export declare function normalizeGovernanceMode(value: unknown): GovernanceMode | undefined;
+export declare function evaluateProgressiveGovernance(input?: ProgressiveGovernanceInput): ProgressiveGovernanceReport;

package/dist/governance/ProgressiveGovernance.js

@@ -0,0 +1,159 @@
+const MODE_ORDER = ['minimal', 'standard', 'expanded', 'critical'];
+export function normalizeGovernanceMode(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const normalized = String(value).trim().toLowerCase();
+    if (normalized === 'minimal' || normalized === 'standard' || normalized === 'expanded' || normalized === 'critical')
+        return normalized;
+    throw new Error(`Invalid governance mode "${String(value)}"; expected minimal, standard, expanded, or critical.`);
+}
+export function evaluateProgressiveGovernance(input = {}) {
+    const task = input.task ?? '';
+    const changedFiles = (input.changedFiles ?? []).map(normalizePath).filter(Boolean);
+    const signals = detectSignals(task, changedFiles);
+    const recommendedMode = highestMode(signals.map(signal => signal.mode), changedFiles.length > 0 || task ? 'standard' : 'minimal');
+    const requestedMode = input.requestedMode;
+    const effectiveMode = highestMode([recommendedMode, requestedMode].filter(Boolean), recommendedMode);
+    return {
+        requestedMode,
+        recommendedMode,
+        effectiveMode,
+        escalated: Boolean(requestedMode && modeRank(recommendedMode) > modeRank(requestedMode)),
+        signals,
+        requiredBehaviors: requiredBehaviors(effectiveMode, signals),
+    };
+}
+function detectSignals(task, changedFiles) {
+    const haystack = `${task} ${changedFiles.join(' ')}`.toLowerCase();
+    const signals = [];
+    if (changedFiles.length === 0 && !task.trim()) {
+        signals.push({
+            id: 'no-task-context',
+            mode: 'minimal',
+            reason: 'No task text or changed files were provided.',
+            evidence: [],
+        });
+        return signals;
+    }
+    const lowRiskDocsOnly = isDocsOnly(changedFiles) && !/api|auth|security|release|deploy|database|migration|permission/.test(haystack);
+    if (lowRiskDocsOnly) {
+        signals.push({
+            id: 'docs-only-low-risk',
+            mode: 'minimal',
+            reason: 'Only low-risk documentation files were provided.',
+            evidence: changedFiles,
+        });
+    }
+    if (!lowRiskDocsOnly && (changedFiles.length > 0 || task.trim())) {
+        signals.push({
+            id: 'normal-engineering-work',
+            mode: 'standard',
+            reason: 'Task has implementation or verification context.',
+            evidence: changedFiles.slice(0, 8),
+        });
+    }
+    if (changedFiles.length >= 6 || topLevelCount(changedFiles) >= 3) {
+        signals.push({
+            id: 'cross-module-scope',
+            mode: 'expanded',
+            reason: 'Changed files span enough paths to require broader impact analysis.',
+            evidence: changedFiles.slice(0, 12),
+        });
+    }
+    if (/ui|ux|frontend|browser|e2e|playwright|desktop|cua|screenshot|visual/.test(haystack)) {
+        signals.push({
+            id: 'interactive-or-visual-flow',
+            mode: 'expanded',
+            reason: 'Task touches UI, browser, E2E, desktop, or visual verification.',
+            evidence: matchingEvidence(changedFiles, /ui|frontend|browser|e2e|playwright|desktop|visual/i),
+        });
+    }
+    if (/public api|new api|contract|schema|sdk|breaking/.test(haystack)) {
+        signals.push({
+            id: 'public-interface-change',
+            mode: 'expanded',
+            reason: 'Task mentions public API, contract, schema, SDK, or breaking behavior.',
+            evidence: matchingEvidence(changedFiles, /api|contract|schema|sdk/i),
+        });
+    }
+    if (/auth|permission|secret|token|password|private key|database|migration|production|deploy|release|destructive|delete|drop table|truncate/.test(haystack)) {
+        signals.push({
+            id: 'critical-risk-domain',
+            mode: 'critical',
+            reason: 'Task touches auth, permissions, secrets, database, production, release, or destructive operations.',
+            evidence: matchingEvidence(changedFiles, /auth|permission|secret|token|database|migration|config|deploy|release|delete/i),
+        });
+    }
+    if (changedFiles.some(file => /\.(env|pem|key|crt)$/i.test(file) || /(^|\/)(migration|migrations|schema|auth|permission|config|deploy|release)(\/|\.|-|_)/i.test(file))) {
+        signals.push({
+            id: 'critical-file-path',
+            mode: 'critical',
+            reason: 'Changed file paths include critical config, auth, schema, migration, or secret-like files.',
+            evidence: matchingEvidence(changedFiles, /\.(env|pem|key|crt)$/i),
+        });
+    }
+    if (changedFiles.some(file => /\.(html|png|jpg|jpeg|gif|mp4|mov|zip|tar|gz)$/i.test(file) || /docs\/worklog|tmp|report|screenshot|artifact/i.test(file))) {
+        signals.push({
+            id: 'resource-lifecycle',
+            mode: 'standard',
+            reason: 'Generated reports, media, temporary files, or task artifacts require resource governance.',
+            evidence: matchingEvidence(changedFiles, /\.(html|png|jpg|jpeg|gif|mp4|mov|zip|tar|gz)$/i),
+        });
+    }
+    return dedupeSignals(signals);
+}
+function requiredBehaviors(mode, signals) {
+    const behaviors = new Set();
+    if (mode === 'minimal') {
+        behaviors.add('run relevant validation only');
+        return Array.from(behaviors);
+    }
+    behaviors.add('record verification evidence');
+    behaviors.add('summarize context budget');
+    if (mode === 'expanded' || mode === 'critical') {
+        behaviors.add('attempt code intelligence or explain fallback');
+        behaviors.add('run skill radar when tool, browser, UI, or external CLI signals apply');
+    }
+    if (mode === 'critical') {
+        behaviors.add('run security review');
+        behaviors.add('record rollback or disable strategy');
+        behaviors.add('require human review for destructive, data, auth, or production changes');
+    }
+    if (signals.some(signal => signal.id === 'resource-lifecycle')) {
+        behaviors.add('settle resource lifecycle');
+    }
+    if (signals.some(signal => signal.id === 'interactive-or-visual-flow')) {
+        behaviors.add('collect browser, screenshot, or visual evidence');
+    }
+    return Array.from(behaviors);
+}
+function highestMode(modes, fallback) {
+    if (modes.length === 0)
+        return fallback;
+    return modes.reduce((current, next) => modeRank(next) > modeRank(current) ? next : current, modes[0]);
+}
+function modeRank(mode) {
+    return mode ? MODE_ORDER.indexOf(mode) : -1;
+}
+function isDocsOnly(files) {
+    return files.length > 0 && files.every(file => /\.(md|mdx|txt)$/i.test(file) && /^(readme|docs\/|changelog|license)/i.test(file));
+}
+function topLevelCount(files) {
+    return new Set(files.map(file => file.split('/')[0]).filter(Boolean)).size;
+}
+function matchingEvidence(files, pattern) {
+    return files.filter(file => pattern.test(file)).slice(0, 12);
+}
+function dedupeSignals(signals) {
+    const seen = new Set();
+    return signals.filter(signal => {
+        if (seen.has(signal.id))
+            return false;
+        seen.add(signal.id);
+        return true;
+    });
+}
+function normalizePath(path) {
+    return path.replace(/\\/g, '/').trim();
+}
+//# sourceMappingURL=ProgressiveGovernance.js.map

package/dist/governance/ProgressiveGovernance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressiveGovernance.js","sourceRoot":"","sources":["../../src/governance/ProgressiveGovernance.ts"],"names":[],"mappings":"AAwBA,MAAM,UAAU,GAAqB,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;AAEpF,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAA;IAC3E,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACrD,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,UAAU,IAAI,UAAU,KAAK,UAAU,IAAI,UAAU,KAAK,UAAU;QAAE,OAAO,UAAU,CAAA;IACtI,MAAM,IAAI,KAAK,CAAC,4BAA4B,MAAM,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAA;AACnH,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,QAAoC,EAAE;IAClF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAA;IAC7B,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAClF,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;IACjD,MAAM,eAAe,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACjI,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAA;IACzC,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,MAAM,CAAC,OAAO,CAAqB,EAAE,eAAe,CAAC,CAAA;IACxH,OAAO;QACL,aAAa;QACb,eAAe;QACf,aAAa;QACb,SAAS,EAAE,OAAO,CAAC,aAAa,IAAI,QAAQ,CAAC,eAAe,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC;QACxF,OAAO;QACP,iBAAiB,EAAE,iBAAiB,CAAC,aAAa,EAAE,OAAO,CAAC;KAC7D,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,YAAsB;IACzD,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAA;IAClE,MAAM,OAAO,GAA2B,EAAE,CAAA;IAE1C,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,iBAAiB;YACrB,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,8CAA8C;YACtD,QAAQ,EAAE,EAAE;SACb,CAAC,CAAA;QACF,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,MAAM,eAAe,GAAG,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,gEAAgE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACpI,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,oBAAoB;YACxB,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,kDAAkD;YAC1D,QAAQ,EAAE,YAAY;SACvB,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,CAAC,eAAe,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,yBAAyB;YAC7B,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,kDAAkD;YAC1D,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACnC,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,IAAI,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,oBAAoB;YACxB,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,qEAAqE;YAC7E,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACpC,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,qEAAqE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzF,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,4BAA4B;YAChC,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,iEAAiE;YACzE,QAAQ,EAAE,gBAAgB,CAAC,YAAY,EAAE,oDAAoD,CAAC;SAC/F,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,iDAAiD,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,yBAAyB;YAC7B,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,wEAAwE;YAChF,QAAQ,EAAE,gBAAgB,CAAC,YAAY,EAAE,0BAA0B,CAAC;SACrE,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,uIAAuI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC3J,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,sBAAsB;YAC1B,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,oGAAoG;YAC5G,QAAQ,EAAE,gBAAgB,CAAC,YAAY,EAAE,+EAA+E,CAAC;SAC1H,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,uFAAuF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACxK,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,oBAAoB;YACxB,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,4FAA4F;YACpG,QAAQ,EAAE,gBAAgB,CAAC,YAAY,EAAE,uBAAuB,CAAC;SAClE,CAAC,CAAA;IACJ,CAAC;IAED,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,gDAAgD,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,+CAA+C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACzJ,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,oBAAoB;YACxB,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,2FAA2F;YACnG,QAAQ,EAAE,gBAAgB,CAAC,YAAY,EAAE,gDAAgD,CAAC;SAC3F,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,aAAa,CAAC,OAAO,CAAC,CAAA;AAC/B,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAoB,EAAE,OAA+B;IAC9E,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAA;IACnC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,SAAS,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAA;QAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAC9B,CAAC;IACD,SAAS,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAA;IAC7C,SAAS,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAA;IACzC,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/C,SAAS,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAA;QAC9D,SAAS,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAA;IACxF,CAAC;IACD,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,SAAS,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;QACpC,SAAS,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAA;QACpD,SAAS,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAA;IAC1F,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,oBAAoB,CAAC,EAAE,CAAC;QAC/D,SAAS,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAA;IAC5C,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,4BAA4B,CAAC,EAAE,CAAC;QACvE,SAAS,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAA;IAClE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;AAC9B,CAAC;AAED,SAAS,WAAW,CAAC,KAAuB,EAAE,QAAwB;IACpE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAA;IACvC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AACvG,CAAC;AAED,SAAS,QAAQ,CAAC,IAAqB;IACrC,OAAO,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC7C,CAAC;AAED,SAAS,UAAU,CAAC,KAAe;IACjC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,qCAAqC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AACnI,CAAC;AAED,SAAS,aAAa,CAAC,KAAe;IACpC,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;AAC5E,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAe,EAAE,OAAe;IACxD,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;AAC9D,CAAC;AAED,SAAS,aAAa,CAAC,OAA+B;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;QAC7B,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,OAAO,KAAK,CAAA;QACrC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACnB,OAAO,IAAI,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;AACxC,CAAC"}

package/dist/guardrails/ActiveRedTeam.d.ts

@@ -0,0 +1,46 @@
+export type ActiveRedTeamSeverity = 'HIGH' | 'MEDIUM' | 'LOW';
+export type ActiveRedTeamStatus = 'SKIPPED' | 'PASSED' | 'FAILED';
+export interface ActiveRedTeamConfig {
+    enabled?: boolean;
+    baseUrl?: string;
+    startCommand?: string;
+    targets?: string[];
+    payloads?: string[];
+    timeoutMs?: number;
+    maxRequests?: number;
+}
+export interface ActiveRedTeamFinding {
+    ruleId: string;
+    severity: ActiveRedTeamSeverity;
+    target: string;
+    message: string;
+    evidence?: string;
+}
+export interface ActiveRedTeamProbe {
+    target: string;
+    url: string;
+    status?: number;
+    passed: boolean;
+    findingIds?: string[];
+    error?: string;
+}
+export interface ActiveRedTeamReport {
+    ok: boolean;
+    status: ActiveRedTeamStatus;
+    evidence: string;
+    findings: ActiveRedTeamFinding[];
+    probes: ActiveRedTeamProbe[];
+    blockers: string[];
+    summary: {
+        targets: number;
+        requests: number;
+        findings: number;
+    };
+}
+export interface ActiveRedTeamRuntime {
+    fetch?: (url: string, init?: RequestInit) => Promise<{
+        status: number;
+        text(): Promise<string>;
+    }>;
+}
+export declare function runActiveRedTeam(config?: ActiveRedTeamConfig, runtime?: ActiveRedTeamRuntime): Promise<ActiveRedTeamReport>;