agentic-qe 1.0.0 → 1.0.1

package/dist/core/hooks/RollbackManager.d.ts

@@ -0,0 +1,90 @@
+/**
+ * RollbackManager - Manages snapshots and automatic rollback on errors/regressions
+ */
+import { SwarmMemoryManager } from '../memory/SwarmMemoryManager';
+export interface Snapshot {
+    id: string;
+    timestamp: number;
+    files: Array<{
+        path: string;
+        hash: string;
+        content: string;
+    }>;
+    metadata?: Record<string, any>;
+}
+export interface SnapshotOptions {
+    id: string;
+    files: string[];
+    metadata?: Record<string, any>;
+}
+export interface RollbackTriggerOptions {
+    metrics: {
+        errorCount?: number;
+        totalOperations?: number;
+        errorRate?: number;
+        currentAccuracy?: number;
+        baselineAccuracy?: number;
+        degradation?: number;
+    };
+    thresholds: {
+        maxErrorRate?: number;
+        maxErrors?: number;
+        maxAccuracyDegradation?: number;
+        minAccuracy?: number;
+    };
+}
+export interface RollbackResult {
+    success: boolean;
+    snapshotId: string;
+    filesRestored: number;
+    errors: string[];
+}
+export interface CleanupOptions {
+    maxAge?: number;
+    keepMinimum?: number;
+}
+export declare class RollbackManager {
+    private memory;
+    private snapshots;
+    constructor(memory: SwarmMemoryManager);
+    /**
+     * Create a snapshot of specified files
+     */
+    createSnapshot(options: SnapshotOptions): Promise<Snapshot>;
+    /**
+     * Restore files from a snapshot
+     */
+    restoreSnapshot(snapshotId: string): Promise<RollbackResult>;
+    /**
+     * Determine if rollback should be triggered based on metrics
+     */
+    shouldTriggerRollback(options: RollbackTriggerOptions): Promise<boolean>;
+    /**
+     * Execute rollback to a specific snapshot
+     */
+    executeRollback(options: {
+        snapshotId: string;
+        reason?: string;
+    }): Promise<RollbackResult>;
+    /**
+     * List available snapshots
+     */
+    listSnapshots(): Promise<Array<{
+        id: string;
+        timestamp: number;
+        fileCount: number;
+    }>>;
+    /**
+     * Clean up old snapshots
+     */
+    cleanSnapshots(options?: CleanupOptions): Promise<number>;
+    /**
+     * Get rollback history
+     */
+    getRollbackHistory(limit?: number): Promise<Array<{
+        snapshotId: string;
+        reason?: string;
+        timestamp: number;
+    }>>;
+}
+//# sourceMappingURL=RollbackManager.d.ts.map

package/dist/core/hooks/RollbackManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RollbackManager.d.ts","sourceRoot":"","sources":["../../../src/core/hooks/RollbackManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAKlE,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,UAAU,EAAE;QACV,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,eAAe;IAGd,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,SAAS,CAAoC;gBAEjC,MAAM,EAAE,kBAAkB;IAE9C;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;IAwCjE;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAkClE;;OAEG;IACG,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC;IAqC9E;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,cAAc,CAAC;IAgB3B;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA2B3F;;OAEG;IACG,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBnE;;OAEG;IACG,kBAAkB,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,KAAK,CAAC;QAC1D,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CAQJ"}

package/dist/core/hooks/RollbackManager.js

@@ -0,0 +1,214 @@
+"use strict";
+/**
+ * RollbackManager - Manages snapshots and automatic rollback on errors/regressions
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RollbackManager = void 0;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const crypto = __importStar(require("crypto"));
+class RollbackManager {
+    constructor(memory) {
+        this.memory = memory;
+        this.snapshots = new Map();
+    }
+    /**
+     * Create a snapshot of specified files
+     */
+    async createSnapshot(options) {
+        const snapshot = {
+            id: options.id,
+            timestamp: Date.now(),
+            files: [],
+            metadata: options.metadata
+        };
+        for (const filePath of options.files) {
+            try {
+                const exists = await fs.pathExists(filePath);
+                if (!exists) {
+                    continue;
+                }
+                const content = await fs.readFile(filePath, 'utf-8');
+                const hash = crypto.createHash('sha256').update(content).digest('hex');
+                snapshot.files.push({
+                    path: filePath,
+                    hash,
+                    content
+                });
+            }
+            catch (error) {
+                // Skip files that can't be read
+                continue;
+            }
+        }
+        // Store snapshot in memory
+        this.snapshots.set(snapshot.id, snapshot);
+        // Persist to memory manager
+        await this.memory.store(`snapshot:${snapshot.id}`, snapshot, {
+            partition: 'snapshots'
+        });
+        return snapshot;
+    }
+    /**
+     * Restore files from a snapshot
+     */
+    async restoreSnapshot(snapshotId) {
+        const snapshot = this.snapshots.get(snapshotId) ||
+            await this.memory.retrieve(`snapshot:${snapshotId}`, { partition: 'snapshots' });
+        if (!snapshot) {
+            return {
+                success: false,
+                snapshotId,
+                filesRestored: 0,
+                errors: [`Snapshot not found: ${snapshotId}`]
+            };
+        }
+        const errors = [];
+        let filesRestored = 0;
+        for (const file of snapshot.files) {
+            try {
+                await fs.ensureDir(path.dirname(file.path));
+                await fs.writeFile(file.path, file.content, 'utf-8');
+                filesRestored++;
+            }
+            catch (error) {
+                errors.push(`Failed to restore ${file.path}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        return {
+            success: errors.length === 0,
+            snapshotId,
+            filesRestored,
+            errors
+        };
+    }
+    /**
+     * Determine if rollback should be triggered based on metrics
+     */
+    async shouldTriggerRollback(options) {
+        const { metrics, thresholds } = options;
+        // Check error rate
+        if (thresholds.maxErrorRate !== undefined && metrics.errorRate !== undefined) {
+            if (metrics.errorRate > thresholds.maxErrorRate) {
+                return true;
+            }
+        }
+        // Check error count
+        if (thresholds.maxErrors !== undefined && metrics.errorCount !== undefined) {
+            if (metrics.errorCount > thresholds.maxErrors) {
+                return true;
+            }
+        }
+        // Check accuracy degradation
+        if (thresholds.maxAccuracyDegradation !== undefined &&
+            metrics.currentAccuracy !== undefined &&
+            metrics.baselineAccuracy !== undefined) {
+            const degradation = metrics.baselineAccuracy - metrics.currentAccuracy;
+            if (degradation > thresholds.maxAccuracyDegradation) {
+                return true;
+            }
+        }
+        // Check minimum accuracy
+        if (thresholds.minAccuracy !== undefined && metrics.currentAccuracy !== undefined) {
+            if (metrics.currentAccuracy < thresholds.minAccuracy) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Execute rollback to a specific snapshot
+     */
+    async executeRollback(options) {
+        // Log rollback attempt
+        await this.memory.store(`rollback:${Date.now()}`, {
+            snapshotId: options.snapshotId,
+            reason: options.reason,
+            timestamp: Date.now()
+        }, { partition: 'rollback_history' });
+        // Restore the snapshot
+        return this.restoreSnapshot(options.snapshotId);
+    }
+    /**
+     * List available snapshots
+     */
+    async listSnapshots() {
+        const snapshotList = [];
+        // Get from in-memory cache
+        for (const [id, snapshot] of this.snapshots) {
+            snapshotList.push({
+                id,
+                timestamp: snapshot.timestamp,
+                fileCount: snapshot.files.length
+            });
+        }
+        // Get from memory manager
+        const stored = await this.memory.query('snapshot:%', { partition: 'snapshots' });
+        for (const entry of stored) {
+            if (!this.snapshots.has(entry.value.id)) {
+                snapshotList.push({
+                    id: entry.value.id,
+                    timestamp: entry.value.timestamp,
+                    fileCount: entry.value.files?.length || 0
+                });
+            }
+        }
+        return snapshotList.sort((a, b) => b.timestamp - a.timestamp);
+    }
+    /**
+     * Clean up old snapshots
+     */
+    async cleanSnapshots(options = {}) {
+        const maxAge = options.maxAge || 24 * 60 * 60 * 1000; // 24 hours default
+        const keepMinimum = options.keepMinimum || 5;
+        const snapshots = await this.listSnapshots();
+        const now = Date.now();
+        let cleaned = 0;
+        // Keep at least keepMinimum snapshots
+        const snapshotsToCheck = snapshots.slice(keepMinimum);
+        for (const snapshot of snapshotsToCheck) {
+            const age = now - snapshot.timestamp;
+            if (age > maxAge) {
+                this.snapshots.delete(snapshot.id);
+                await this.memory.delete(`snapshot:${snapshot.id}`, 'snapshots');
+                cleaned++;
+            }
+        }
+        return cleaned;
+    }
+    /**
+     * Get rollback history
+     */
+    async getRollbackHistory(limit = 10) {
+        const history = await this.memory.query('rollback:%', { partition: 'rollback_history' });
+        return history
+            .map(entry => entry.value)
+            .sort((a, b) => b.timestamp - a.timestamp)
+            .slice(0, limit);
+    }
+}
+exports.RollbackManager = RollbackManager;
+//# sourceMappingURL=RollbackManager.js.map

package/dist/core/hooks/RollbackManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RollbackManager.js","sourceRoot":"","sources":["../../../src/core/hooks/RollbackManager.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;AAGH,6CAA+B;AAC/B,2CAA6B;AAC7B,+CAAiC;AAgDjC,MAAa,eAAe;IAG1B,YAAoB,MAA0B;QAA1B,WAAM,GAAN,MAAM,CAAoB;QAFtC,cAAS,GAA0B,IAAI,GAAG,EAAE,CAAC;IAEJ,CAAC;IAElD;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,OAAwB;QAC3C,MAAM,QAAQ,GAAa;YACzB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC;QAEF,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,SAAS;gBACX,CAAC;gBAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACrD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAEvE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;oBAClB,IAAI,EAAE,QAAQ;oBACd,IAAI;oBACJ,OAAO;iBACR,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,gCAAgC;gBAChC,SAAS;YACX,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAE1C,4BAA4B;QAC5B,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,QAAQ,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE;YAC3D,SAAS,EAAE,WAAW;SACvB,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,UAAkB;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;YAC7C,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QAEnF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,UAAU;gBACV,aAAa,EAAE,CAAC;gBAChB,MAAM,EAAE,CAAC,uBAAuB,UAAU,EAAE,CAAC;aAC9C,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC5C,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACrD,aAAa,EAAE,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC3G,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC5B,UAAU;YACV,aAAa;YACb,MAAM;SACP,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,OAA+B;QACzD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAExC,mBAAmB;QACnB,IAAI,UAAU,CAAC,YAAY,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAC7E,IAAI,OAAO,CAAC,SAAS,GAAG,UAAU,CAAC,YAAY,EAAE,CAAC;gBAChD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,IAAI,UAAU,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAC3E,IAAI,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;gBAC9C,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,6BAA6B;QAC7B,IAAI,UAAU,CAAC,sBAAsB,KAAK,SAAS;YAC/C,OAAO,CAAC,eAAe,KAAK,SAAS;YACrC,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YAC3C,MAAM,WAAW,GAAG,OAAO,CAAC,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;YACvE,IAAI,WAAW,GAAG,UAAU,CAAC,sBAAsB,EAAE,CAAC;gBACpD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,IAAI,UAAU,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YAClF,IAAI,OAAO,CAAC,eAAe,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;gBACrD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,OAGrB;QACC,uBAAuB;QACvB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CACrB,YAAY,IAAI,CAAC,GAAG,EAAE,EAAE,EACxB;YACE,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,EACD,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAClC,CAAC;QAEF,uBAAuB;QACvB,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,YAAY,GAAgE,EAAE,CAAC;QAErF,2BAA2B;QAC3B,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5C,YAAY,CAAC,IAAI,CAAC;gBAChB,EAAE;gBACF,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;aACjC,CAAC,CAAC;QACL,CAAC;QAED,0BAA0B;QAC1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;QACjF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;gBACxC,YAAY,CAAC,IAAI,CAAC;oBAChB,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE;oBAClB,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;oBAChC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;iBAC1C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,UAA0B,EAAE;QAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,mBAAmB;QACzE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;QAE7C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,sCAAsC;QACtC,MAAM,gBAAgB,GAAG,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAEtD,KAAK,MAAM,QAAQ,IAAI,gBAAgB,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC;YACrC,IAAI,GAAG,GAAG,MAAM,EAAE,CAAC;gBACjB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACnC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,QAAQ,CAAC,EAAE,EAAE,EAAE,WAAW,CAAC,CAAC;gBACjE,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,QAAgB,EAAE;QAKzC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAEzF,OAAO,OAAO;aACX,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;aACzB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;aACzC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;CACF;AA3ND,0CA2NC"}

package/dist/core/hooks/VerificationHookManager.d.ts

@@ -0,0 +1,134 @@
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { SwarmMemoryManager } from '../memory/SwarmMemoryManager';
+export interface PreToolUseBundle {
+    summary: string;
+    rules: string[];
+    artifactIds: string[];
+    hints: any;
+    patterns: any[];
+    workflow: any;
+}
+export interface PostToolUsePersistence {
+    events: Array<{
+        type: string;
+        payload: any;
+    }>;
+    patterns: Array<{
+        pattern: string;
+        confidence: number;
+    }>;
+    checkpoints: Array<{
+        step: string;
+        status: string;
+    }>;
+    artifacts: Array<{
+        kind: string;
+        path: string;
+        sha256: string;
+    }>;
+    metrics: Array<{
+        metric: string;
+        value: number;
+        unit: string;
+    }>;
+}
+export interface VerificationResult {
+    passed: boolean;
+    score: number;
+    priority: number;
+    checks: string[];
+}
+export interface ValidationResult {
+    valid: boolean;
+    accuracy: number;
+    priority: number;
+    validations: string[];
+}
+export interface EditVerificationResult {
+    allowed: boolean;
+    priority: number;
+    checks: string[];
+}
+export interface EditUpdateResult {
+    updated: boolean;
+    priority: number;
+    updates: string[];
+}
+export interface SessionFinalizationResult {
+    finalized: boolean;
+    priority: number;
+    actions: string[];
+}
+/**
+ * VerificationHookManager - Implements 5-stage verification hooks with context engineering
+ * Provides PreToolUse context bundles and PostToolUse persistence across multiple memory tables
+ */
+export declare class VerificationHookManager extends EventEmitter {
+    private memory;
+    private readonly RULES;
+    private environmentChecker;
+    private resourceChecker;
+    private permissionChecker;
+    private configurationChecker;
+    private outputValidator;
+    private qualityValidator;
+    private coverageValidator;
+    private performanceValidator;
+    private rollbackManager;
+    constructor(memory: SwarmMemoryManager);
+    /**
+     * Build a small context bundle for PreToolUse with top-N artifacts (IDs only)
+     * Includes hints from blackboard, patterns, and workflow state
+     */
+    buildPreToolUseBundle(options: {
+        task: string;
+        maxArtifacts?: number;
+    }): Promise<PreToolUseBundle>;
+    /**
+     * Persist PostToolUse outcomes to multiple memory tables with appropriate TTLs
+     */
+    persistPostToolUseOutcomes(outcomes: PostToolUsePersistence): Promise<void>;
+    /**
+     * Stage 1: Pre-Task Verification (Priority 100)
+     * Validates environment, resources, and dependencies before task execution
+     */
+    executePreTaskVerification(options: {
+        task: string;
+        context?: any;
+    }): Promise<VerificationResult>;
+    /**
+     * Stage 2: Post-Task Validation (Priority 90)
+     * Validates task outputs and quality metrics
+     */
+    executePostTaskValidation(options: {
+        task: string;
+        result: any;
+    }): Promise<ValidationResult>;
+    /**
+     * Stage 3: Pre-Edit Verification (Priority 80)
+     * Verifies file locks and syntax before editing
+     */
+    executePreEditVerification(options: {
+        file: string;
+        changes: any;
+    }): Promise<EditVerificationResult>;
+    /**
+     * Stage 4: Post-Edit Update (Priority 70)
+     * Updates artifact tracking and dependencies after edits
+     */
+    executePostEditUpdate(options: {
+        file: string;
+        changes: any;
+    }): Promise<EditUpdateResult>;
+    /**
+     * Stage 5: Session-End Finalization (Priority 60)
+     * Exports state, aggregates metrics, and performs cleanup
+     */
+    executeSessionEndFinalization(options: {
+        sessionId: string;
+        duration: number;
+        tasksCompleted: number;
+    }): Promise<SessionFinalizationResult>;
+}
+//# sourceMappingURL=VerificationHookManager.d.ts.map

package/dist/core/hooks/VerificationHookManager.d.ts.map

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