@pcircle/claude-code-buddy-mcp 2.3.1

package/dist/agents/e2e-healing/safety/RollbackManager.js

@@ -0,0 +1,130 @@
+import { spawn } from 'child_process';
+export class RollbackManager {
+    static TESTID_REGEX = /^[a-zA-Z0-9_-]+$/;
+    static DESCRIPTION_REGEX = /^[a-zA-Z0-9\s_.,:-]+$/;
+    static MESSAGE_REGEX = /^[a-zA-Z0-9\s_.,:-]+$/;
+    checkpoints = new Map();
+    rollbackHistory = [];
+    MAX_ROLLBACK_HISTORY = 500;
+    execFunction;
+    constructor() {
+        this.execFunction = this.defaultExec;
+    }
+    validateTestId(testId) {
+        if (!RollbackManager.TESTID_REGEX.test(testId)) {
+            throw new Error(`Invalid testId: "${testId}". Only alphanumeric, dashes, and underscores allowed.`);
+        }
+    }
+    validateDescription(description) {
+        if (!RollbackManager.DESCRIPTION_REGEX.test(description)) {
+            throw new Error(`Invalid description: "${description}". Only alphanumeric, spaces, and basic punctuation allowed.`);
+        }
+    }
+    validateMessage(message) {
+        if (!RollbackManager.MESSAGE_REGEX.test(message)) {
+            throw new Error(`Invalid commit message: "${message}". Only alphanumeric, spaces, and basic punctuation allowed.`);
+        }
+    }
+    setExecFunction(fn) {
+        this.execFunction = fn;
+    }
+    async createCheckpoint(testId, description) {
+        this.validateTestId(testId);
+        this.validateDescription(description);
+        try {
+            await this.execFunction('git', [
+                'stash',
+                'push',
+                '-m',
+                `E2E Healing: ${description}`,
+            ]);
+            const stashId = await this.getLatestStashId();
+            const checkpoint = {
+                testId,
+                stashId,
+                timestamp: Date.now(),
+                description,
+            };
+            this.checkpoints.set(testId, checkpoint);
+            return stashId;
+        }
+        catch (error) {
+            this.checkpoints.delete(testId);
+            throw new Error(`Failed to create checkpoint for test ${testId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    async rollback(testId, reason = 'Fix failed') {
+        const checkpoint = this.checkpoints.get(testId);
+        if (!checkpoint) {
+            throw new Error(`No checkpoint found for test ${testId}`);
+        }
+        try {
+            await this.execFunction('git', ['stash', 'pop', checkpoint.stashId]);
+            this.rollbackHistory.push({
+                testId,
+                timestamp: Date.now(),
+                reason,
+            });
+            if (this.rollbackHistory.length > this.MAX_ROLLBACK_HISTORY) {
+                this.rollbackHistory = this.rollbackHistory.slice(-this.MAX_ROLLBACK_HISTORY);
+            }
+            this.checkpoints.delete(testId);
+        }
+        catch (error) {
+            throw new Error(`Failed to rollback test ${testId} using stash ${checkpoint.stashId}: ${error instanceof Error ? error.message : String(error)}. Manual recovery: git stash apply ${checkpoint.stashId}`);
+        }
+    }
+    async commit(testId, message) {
+        this.validateMessage(message);
+        const checkpoint = this.checkpoints.get(testId);
+        if (!checkpoint) {
+            throw new Error(`No checkpoint found for test ${testId}`);
+        }
+        try {
+            await this.execFunction('git', ['add', '.']);
+            await this.execFunction('git', ['commit', '-m', message]);
+            await this.execFunction('git', ['stash', 'drop', checkpoint.stashId]);
+            this.checkpoints.delete(testId);
+        }
+        catch (error) {
+            throw new Error(`Failed to commit changes for test ${testId}: ${error instanceof Error ? error.message : String(error)}. Stash ${checkpoint.stashId} preserved for manual review.`);
+        }
+    }
+    getRollbackHistory() {
+        return [...this.rollbackHistory];
+    }
+    async getLatestStashId() {
+        const { stdout } = await this.execFunction('git', ['stash', 'list']);
+        const firstLine = stdout.trim().split('\n')[0];
+        const match = firstLine?.match(/^(stash@\{\d+\})/);
+        if (!match) {
+            throw new Error('Failed to get stash ID from git stash list');
+        }
+        return match[1];
+    }
+    async defaultExec(command, args) {
+        return new Promise((resolve, reject) => {
+            const proc = spawn(command, args);
+            let stdout = '';
+            let stderr = '';
+            proc.stdout.on('data', (data) => {
+                stdout += data.toString();
+            });
+            proc.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            proc.on('close', (code) => {
+                if (code !== 0) {
+                    reject(new Error(`Command failed with code ${code}: ${stderr}`));
+                }
+                else {
+                    resolve({ stdout, stderr });
+                }
+            });
+            proc.on('error', (error) => {
+                reject(error);
+            });
+        });
+    }
+}
+//# sourceMappingURL=RollbackManager.js.map

package/dist/agents/e2e-healing/safety/RollbackManager.js.map

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

package/dist/agents/e2e-healing/safety/SafetyGate.d.ts

@@ -0,0 +1,21 @@
+import { CircuitBreaker } from './CircuitBreaker.js';
+import { ScopeLimiter } from './ScopeLimiter.js';
+import type { GeneratedFix } from '../generators/FixGenerator.js';
+export interface SafetyValidationResult {
+    allowed: boolean;
+    violations: string[];
+}
+export declare class SafetyGate {
+    private circuitBreaker;
+    private scopeLimiter;
+    private maxAttempts;
+    private attemptCounts;
+    private readonly MAX_TESTS_TRACKED;
+    constructor(circuitBreaker: CircuitBreaker, scopeLimiter: ScopeLimiter, maxAttempts: number);
+    validate(testId: string, testFile: string, fix: GeneratedFix): SafetyValidationResult;
+    recordSuccess(testId: string): void;
+    recordFailure(testId: string): void;
+    private convertToCodeChanges;
+    private cleanupOldTests;
+}
+//# sourceMappingURL=SafetyGate.d.ts.map

package/dist/agents/e2e-healing/safety/SafetyGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SafetyGate.d.ts","sourceRoot":"","sources":["../../../../src/agents/e2e-healing/safety/SafetyGate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAMlE,MAAM,WAAW,sBAAsB;IAErC,OAAO,EAAE,OAAO,CAAC;IAEjB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAQD,qBAAa,UAAU;IAKnB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,WAAW;IANrB,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;gBAGhC,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,MAAM;IAW7B,QAAQ,CACN,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,YAAY,GAChB,sBAAsB;IAgDzB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAYnC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUnC,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,eAAe;CAgBxB"}

package/dist/agents/e2e-healing/safety/SafetyGate.js

@@ -0,0 +1,62 @@
+export class SafetyGate {
+    circuitBreaker;
+    scopeLimiter;
+    maxAttempts;
+    attemptCounts = new Map();
+    MAX_TESTS_TRACKED = 1000;
+    constructor(circuitBreaker, scopeLimiter, maxAttempts) {
+        this.circuitBreaker = circuitBreaker;
+        this.scopeLimiter = scopeLimiter;
+        this.maxAttempts = maxAttempts;
+    }
+    validate(testId, testFile, fix) {
+        const violations = [];
+        const attemptCount = (this.attemptCounts.get(testId) || 0) + 1;
+        this.attemptCounts.set(testId, attemptCount);
+        this.cleanupOldTests();
+        if (attemptCount > this.maxAttempts) {
+            violations.push(`max attempts (${this.maxAttempts}) exceeded for test ${testId}`);
+        }
+        if (!this.circuitBreaker.canAttemptRepair(testId)) {
+            violations.push(`circuit breaker is open for test ${testId} - too many recent failures`);
+        }
+        const proposedChanges = this.convertToCodeChanges(fix);
+        const scopeResult = this.scopeLimiter.validateRepairScope(testFile, proposedChanges);
+        if (!scopeResult.valid) {
+            violations.push(...scopeResult.violations);
+        }
+        return {
+            allowed: violations.length === 0,
+            violations,
+        };
+    }
+    recordSuccess(testId) {
+        this.circuitBreaker.recordAttempt(testId, true);
+        this.attemptCounts.delete(testId);
+    }
+    recordFailure(testId) {
+        this.circuitBreaker.recordAttempt(testId, false);
+    }
+    convertToCodeChanges(fix) {
+        const lines = fix.code.split('\n').length;
+        return [
+            {
+                path: fix.targetFile,
+                additions: lines,
+                deletions: 0,
+                diff: fix.code,
+            },
+        ];
+    }
+    cleanupOldTests() {
+        if (this.attemptCounts.size <= this.MAX_TESTS_TRACKED) {
+            return;
+        }
+        const entries = Array.from(this.attemptCounts.entries()).sort((a, b) => b[1] - a[1]);
+        const toRemove = Math.floor(this.MAX_TESTS_TRACKED * 0.1);
+        for (let i = 0; i < toRemove; i++) {
+            this.attemptCounts.delete(entries[i][0]);
+        }
+    }
+}
+//# sourceMappingURL=SafetyGate.js.map

package/dist/agents/e2e-healing/safety/SafetyGate.js.map

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

package/dist/agents/e2e-healing/safety/ScopeLimiter.d.ts

@@ -0,0 +1,14 @@
+import { HealingConstraints, CodeChange } from '../types.js';
+interface ValidationResult {
+    valid: boolean;
+    violations: string[];
+}
+export declare class ScopeLimiter {
+    private constraints;
+    constructor(constraints: HealingConstraints);
+    validateRepairScope(testFile: string, proposedFix: CodeChange[]): ValidationResult;
+    private isForbidden;
+    private isAllowed;
+}
+export {};
+//# sourceMappingURL=ScopeLimiter.d.ts.map

package/dist/agents/e2e-healing/safety/ScopeLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopeLimiter.d.ts","sourceRoot":"","sources":["../../../../src/agents/e2e-healing/safety/ScopeLimiter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE7D,UAAU,gBAAgB;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAqB;gBAE5B,WAAW,EAAE,kBAAkB;IAI3C,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,UAAU,EAAE,GACxB,gBAAgB;IAuCnB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,SAAS;CAKlB"}

package/dist/agents/e2e-healing/safety/ScopeLimiter.js

@@ -0,0 +1,36 @@
+import { minimatch } from 'minimatch';
+export class ScopeLimiter {
+    constraints;
+    constructor(constraints) {
+        this.constraints = constraints;
+    }
+    validateRepairScope(testFile, proposedFix) {
+        const violations = [];
+        if (proposedFix.length > this.constraints.maxFilesModified) {
+            violations.push(`Fix modifies ${proposedFix.length} files, exceeds limit of ${this.constraints.maxFilesModified}`);
+        }
+        const totalLines = proposedFix.reduce((sum, f) => sum + f.additions + f.deletions, 0);
+        if (totalLines > this.constraints.maxLinesChanged) {
+            violations.push(`Fix changes ${totalLines} lines, exceeds limit of ${this.constraints.maxLinesChanged}`);
+        }
+        for (const file of proposedFix) {
+            if (this.isForbidden(file.path)) {
+                violations.push(`Fix attempts to modify forbidden file: ${file.path}`);
+            }
+            else if (!this.isAllowed(file.path)) {
+                violations.push(`File ${file.path} not in allowed patterns: ${this.constraints.allowedFilePatterns.join(', ')}`);
+            }
+        }
+        return {
+            valid: violations.length === 0,
+            violations,
+        };
+    }
+    isForbidden(filePath) {
+        return this.constraints.forbiddenFilePatterns.some((pattern) => minimatch(filePath, pattern));
+    }
+    isAllowed(filePath) {
+        return this.constraints.allowedFilePatterns.some((pattern) => minimatch(filePath, pattern));
+    }
+}
+//# sourceMappingURL=ScopeLimiter.js.map

package/dist/agents/e2e-healing/safety/ScopeLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopeLimiter.js","sourceRoot":"","sources":["../../../../src/agents/e2e-healing/safety/ScopeLimiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAQtC,MAAM,OAAO,YAAY;IACf,WAAW,CAAqB;IAExC,YAAY,WAA+B;QACzC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,mBAAmB,CACjB,QAAgB,EAChB,WAAyB;QAEzB,MAAM,UAAU,GAAa,EAAE,CAAC;QAGhC,IAAI,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAAC;YAC3D,UAAU,CAAC,IAAI,CACb,gBAAgB,WAAW,CAAC,MAAM,4BAA4B,IAAI,CAAC,WAAW,CAAC,gBAAgB,EAAE,CAClG,CAAC;QACJ,CAAC;QAGD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CACnC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,EAC3C,CAAC,CACF,CAAC;QACF,IAAI,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC;YAClD,UAAU,CAAC,IAAI,CACb,eAAe,UAAU,4BAA4B,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,CACxF,CAAC;QACJ,CAAC;QAID,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,UAAU,CAAC,IAAI,CAAC,0CAA0C,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACzE,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,UAAU,CAAC,IAAI,CACb,QAAQ,IAAI,CAAC,IAAI,6BAA6B,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChG,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC;YAC9B,UAAU;SACX,CAAC;IACJ,CAAC;IAEO,WAAW,CAAC,QAAgB;QAClC,OAAO,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAC7D,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAC7B,CAAC;IACJ,CAAC;IAEO,SAAS,CAAC,QAAgB;QAChC,OAAO,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAC3D,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAC7B,CAAC;IACJ,CAAC;CACF"}

package/dist/agents/e2e-healing/sdk/AgentSDKAdapter.d.ts

@@ -0,0 +1,29 @@
+import Anthropic from '@anthropic-ai/sdk';
+interface AnalyzeFailureInput {
+    error: Error;
+    screenshot?: string;
+    codeContext: string;
+    useExtendedThinking?: boolean;
+}
+interface AnalyzeFailureResult {
+    rootCause: string;
+    tokensUsed: number;
+}
+interface GenerateFixInput {
+    rootCause: string;
+    codeContext: string;
+    testFile: string;
+}
+interface GenerateFixResult {
+    code: string;
+    tokensUsed: number;
+    cacheHit: boolean;
+}
+export declare class AgentSDKAdapter {
+    private client;
+    constructor(client: Anthropic);
+    analyzeFailure(input: AnalyzeFailureInput): Promise<AnalyzeFailureResult>;
+    generateFix(input: GenerateFixInput): Promise<GenerateFixResult>;
+}
+export {};
+//# sourceMappingURL=AgentSDKAdapter.d.ts.map

package/dist/agents/e2e-healing/sdk/AgentSDKAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentSDKAdapter.d.ts","sourceRoot":"","sources":["../../../../src/agents/e2e-healing/sdk/AgentSDKAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAE1C,UAAU,mBAAmB;IAC3B,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,UAAU,oBAAoB;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,EAAE,SAAS;IAIvB,cAAc,CAClB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,CAAC;IA2C1B,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA+CvE"}

package/dist/agents/e2e-healing/sdk/AgentSDKAdapter.js

@@ -0,0 +1,86 @@
+export class AgentSDKAdapter {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async analyzeFailure(input) {
+        const extendedThinkingBudgetTokens = 1024;
+        const response = await this.client.messages.create({
+            model: 'claude-sonnet-4-5-20250929',
+            max_tokens: 4000,
+            ...(input.useExtendedThinking
+                ? {
+                    thinking: {
+                        type: 'enabled',
+                        budget_tokens: extendedThinkingBudgetTokens,
+                    },
+                }
+                : {}),
+            messages: [
+                {
+                    role: 'user',
+                    content: `Analyze this E2E test failure:
+
+Error: ${input.error.message}
+
+Code Context:
+${input.codeContext}
+
+${input.screenshot ? `Screenshot: ${input.screenshot.slice(0, 100)}...` : ''}
+
+Identify the root cause of this failure.`,
+                },
+            ],
+        });
+        const text = response.content
+            .filter((c) => c.type === 'text')
+            .map((c) => c.text)
+            .join('\n');
+        return {
+            rootCause: text,
+            tokensUsed: response.usage.input_tokens + response.usage.output_tokens,
+        };
+    }
+    async generateFix(input) {
+        const response = await this.client.messages.create({
+            model: 'claude-sonnet-4-5-20250929',
+            max_tokens: 4000,
+            system: [
+                {
+                    type: 'text',
+                    text: 'You are an expert at fixing E2E test failures. Generate minimal code fixes.',
+                    cache_control: { type: 'ephemeral' },
+                },
+            ],
+            messages: [
+                {
+                    role: 'user',
+                    content: `Generate a fix for this issue:
+
+Root Cause: ${input.rootCause}
+
+Code Context:
+${input.codeContext}
+
+Test File: ${input.testFile}
+
+Provide the fixed code in a TypeScript code block.`,
+                },
+            ],
+        });
+        const text = response.content
+            .filter((c) => c.type === 'text')
+            .map((c) => c.text)
+            .join('\n');
+        const codeMatch = text.match(/```(?:typescript|tsx?)\n([\s\S]*?)```/);
+        const code = codeMatch ? codeMatch[1] : text;
+        const cacheReadTokens = response.usage.cache_read_input_tokens ?? 0;
+        const cacheHit = cacheReadTokens > 0;
+        return {
+            code,
+            tokensUsed: response.usage.input_tokens + response.usage.output_tokens,
+            cacheHit,
+        };
+    }
+}
+//# sourceMappingURL=AgentSDKAdapter.js.map

package/dist/agents/e2e-healing/sdk/AgentSDKAdapter.js.map

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

package/dist/agents/e2e-healing/types.d.ts

@@ -0,0 +1,46 @@
+export interface E2EHealingConfig {
+    maxAttempts: number;
+    cooldownPeriod: number;
+    failureThreshold: number;
+    resetTimeout: number;
+}
+export interface HealingConstraints {
+    maxAttempts: number;
+    maxFilesModified: number;
+    maxLinesChanged: number;
+    allowedFilePatterns: string[];
+    forbiddenFilePatterns: string[];
+    maxDirectoryDepth: number;
+}
+export interface TestResult {
+    status: 'success' | 'failure';
+    error?: Error;
+    screenshot?: string;
+    logs?: string[];
+}
+export interface HealingResult {
+    status: 'healed' | 'unhealed' | 'aborted';
+    attempts: number;
+    history: AttemptHistory[];
+    reason?: string;
+    recommendation?: string;
+}
+export interface AttemptHistory {
+    attemptNumber: number;
+    error: Error;
+    analysis: string;
+    fixApplied: FixResult;
+    result: 'fixed' | 'failed';
+}
+export interface FixResult {
+    status: 'applied' | 'skipped';
+    reason?: string;
+    files: CodeChange[];
+}
+export interface CodeChange {
+    path: string;
+    additions: number;
+    deletions: number;
+    diff: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agents/e2e-healing/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agents/e2e-healing/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,SAAS,CAAC;IACtB,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/agents/e2e-healing/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agents/e2e-healing/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agents/e2e-healing/types.ts"],"names":[],"mappings":""}

package/dist/agents/knowledge/KnowledgeGraph.d.ts

@@ -0,0 +1,26 @@
+import { Entity, Relation, SearchOptions } from './types';
+export { Entity, Relation, SearchOptions };
+export declare class KnowledgeGraph {
+    private store;
+    private initialized;
+    constructor(dbPath?: string);
+    initialize(): Promise<void>;
+    createEntity(entity: Entity): Promise<void>;
+    getEntity(name: string): Promise<Entity | null>;
+    updateEntity(entity: Entity): Promise<void>;
+    deleteEntity(name: string): Promise<void>;
+    searchEntities(query: string, options?: SearchOptions): Promise<Entity[]>;
+    getAllEntities(): Promise<Entity[]>;
+    createRelation(relation: Relation): Promise<void>;
+    getRelations(entityName: string): Promise<Relation[]>;
+    deleteRelation(from: string, to: string, relationType: string): Promise<void>;
+    getConnectedEntities(entityName: string, maxDepth?: number): Promise<Set<string>>;
+    getStats(): Promise<{
+        totalEntities: number;
+        totalRelations: number;
+        entityTypeBreakdown: Record<string, number>;
+    }>;
+    close(): Promise<void>;
+    private ensureInitialized;
+}
+//# sourceMappingURL=KnowledgeGraph.d.ts.map

package/dist/agents/knowledge/KnowledgeGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgeGraph.d.ts","sourceRoot":"","sources":["../../../src/agents/knowledge/KnowledgeGraph.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAK1D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;AAE3C,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,CAAC,EAAE,MAAM;IAIrB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAK/C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAK7E,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAMnC,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjD,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKrD,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7E,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAwBpF,QAAQ,IAAI,OAAO,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC7C,CAAC;IAiCI,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,OAAO,CAAC,iBAAiB;CAK1B"}

package/dist/agents/knowledge/KnowledgeGraph.js

@@ -0,0 +1,106 @@
+import { KnowledgeGraphStore } from './storage/KnowledgeGraphStore.js';
+import { logger } from '../../utils/logger.js';
+export class KnowledgeGraph {
+    store;
+    initialized = false;
+    constructor(dbPath) {
+        this.store = new KnowledgeGraphStore(dbPath);
+    }
+    async initialize() {
+        if (this.initialized)
+            return;
+        await this.store.initialize();
+        this.initialized = true;
+        logger.info('Knowledge Graph initialized with persistent storage');
+    }
+    async createEntity(entity) {
+        this.ensureInitialized();
+        await this.store.createEntity(entity);
+    }
+    async getEntity(name) {
+        this.ensureInitialized();
+        return await this.store.getEntity(name);
+    }
+    async updateEntity(entity) {
+        this.ensureInitialized();
+        await this.store.updateEntity(entity);
+    }
+    async deleteEntity(name) {
+        this.ensureInitialized();
+        await this.store.deleteEntity(name);
+    }
+    async searchEntities(query, options = {}) {
+        this.ensureInitialized();
+        return await this.store.searchEntities(query, options);
+    }
+    async getAllEntities() {
+        this.ensureInitialized();
+        return await this.store.getAllEntities();
+    }
+    async createRelation(relation) {
+        this.ensureInitialized();
+        await this.store.createRelation(relation);
+    }
+    async getRelations(entityName) {
+        this.ensureInitialized();
+        return await this.store.getRelations(entityName);
+    }
+    async deleteRelation(from, to, relationType) {
+        this.ensureInitialized();
+        await this.store.deleteRelation(from, to, relationType);
+    }
+    async getConnectedEntities(entityName, maxDepth = 2) {
+        const visited = new Set();
+        const queue = [{ name: entityName, depth: 0 }];
+        while (queue.length > 0) {
+            const current = queue.shift();
+            if (visited.has(current.name) || current.depth > maxDepth)
+                continue;
+            visited.add(current.name);
+            if (current.depth < maxDepth) {
+                const relations = await this.getRelations(current.name);
+                for (const rel of relations) {
+                    if (!visited.has(rel.to)) {
+                        queue.push({ name: rel.to, depth: current.depth + 1 });
+                    }
+                }
+            }
+        }
+        return visited;
+    }
+    async getStats() {
+        this.ensureInitialized();
+        const entities = await this.store.getAllEntities();
+        const entityTypeBreakdown = {};
+        for (const entity of entities) {
+            entityTypeBreakdown[entity.entityType] = (entityTypeBreakdown[entity.entityType] || 0) + 1;
+        }
+        let totalRelations = 0;
+        const countedRelations = new Set();
+        for (const entity of entities) {
+            const relations = await this.store.getRelations(entity.name);
+            for (const rel of relations) {
+                const relKey = `${rel.from}:${rel.to}:${rel.relationType}`;
+                if (!countedRelations.has(relKey)) {
+                    countedRelations.add(relKey);
+                    totalRelations++;
+                }
+            }
+        }
+        return {
+            totalEntities: entities.length,
+            totalRelations,
+            entityTypeBreakdown,
+        };
+    }
+    async close() {
+        await this.store.close();
+        this.initialized = false;
+    }
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('Knowledge Graph not initialized. Call initialize() first.');
+        }
+    }
+}
+//# sourceMappingURL=KnowledgeGraph.js.map

package/dist/agents/knowledge/KnowledgeGraph.js.map

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