atabey 0.0.16 → 0.0.18

package/dist/atabey/src/modules/engines/discovery-engine.js

@@ -0,0 +1,161 @@
+/**
+ * [ENGINE] Architecture Discovery Protocol (ADP)
+ *
+ * Implements the ADP from ATABEY_FULL.md:
+ * 1. Entry Point Hunt — find main entry points (index.ts, main.ts, server.ts)
+ * 2. Business Logic Mapping — search for service/repository/controller patterns
+ * 3. Contract Analysis — locate type definitions and API schemas
+ * 4. Adaptive Scaffolding — propose architectural improvements before coding
+ */
+import fs from "fs";
+import path from "path";
+import { logger } from "../../shared/logger.js";
+import { AtabeyStorage } from "../../shared/storage.js";
+export class DiscoveryEngine {
+    /**
+     * Runs the full Architecture Discovery Protocol on a project.
+     */
+    static async discover(projectRoot) {
+        logger.info(`[ADP] Starting Architecture Discovery Protocol for ${projectRoot}`);
+        const entryPoints = DiscoveryEngine.findEntryPoints(projectRoot);
+        const businessLogic = DiscoveryEngine.mapBusinessLogic(projectRoot);
+        const contracts = DiscoveryEngine.analyzeContracts(projectRoot);
+        const architecture = DiscoveryEngine.detectArchitecture(projectRoot);
+        const recommendations = DiscoveryEngine.generateRecommendations(entryPoints, businessLogic, contracts, architecture);
+        // Log discovery results
+        AtabeyStorage.saveLog({
+            agent: "@explorer",
+            action: "ARCHITECTURE_DISCOVERY",
+            trace_id: AtabeyStorage.getMetadata("traceId") || "N/A",
+            status: "SUCCESS",
+            summary: `ADP complete: ${entryPoints.length} entry points, ${businessLogic.length} logic files, ${contracts.length} contracts`
+        });
+        return { entryPoints, businessLogic, contracts, architecture, recommendations };
+    }
+    /**
+     * Step 1: Entry Point Hunt — find main entry points.
+     */
+    static findEntryPoints(projectRoot) {
+        const entryPoints = [];
+        const patterns = ["index.ts", "main.ts", "server.ts", "app.ts", "index.js", "main.js", "server.js"];
+        const searchDir = (dir, depth) => {
+            if (depth > 3)
+                return; // Limit depth
+            try {
+                const entries = fs.readdirSync(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules") {
+                        searchDir(path.join(dir, entry.name), depth + 1);
+                    }
+                    else if (patterns.includes(entry.name)) {
+                        entryPoints.push(path.relative(projectRoot, path.join(dir, entry.name)));
+                    }
+                }
+            }
+            catch { /* skip unreadable */ }
+        };
+        searchDir(projectRoot, 0);
+        return entryPoints;
+    }
+    /**
+     * Step 2: Business Logic Mapping — find service/repository/controller patterns.
+     */
+    static mapBusinessLogic(projectRoot) {
+        const logicFiles = [];
+        const patterns = ["service", "repository", "controller", "handler", "use-case", "domain"];
+        const searchDir = (dir) => {
+            try {
+                const entries = fs.readdirSync(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    const fullPath = path.join(dir, entry.name);
+                    if (entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules") {
+                        searchDir(fullPath);
+                    }
+                    else if (entry.isFile() && (entry.name.endsWith(".ts") || entry.name.endsWith(".js"))) {
+                        const lower = entry.name.toLowerCase();
+                        if (patterns.some(p => lower.includes(p))) {
+                            logicFiles.push(path.relative(projectRoot, fullPath));
+                        }
+                    }
+                }
+            }
+            catch { /* skip unreadable */ }
+        };
+        searchDir(projectRoot);
+        return logicFiles;
+    }
+    /**
+     * Step 3: Contract Analysis — find type definitions and API schemas.
+     */
+    static analyzeContracts(projectRoot) {
+        const contractFiles = [];
+        const patterns = ["types.ts", "schema.ts", "contract.ts", "interface.ts", "dto.ts", "api.ts"];
+        const searchDir = (dir) => {
+            try {
+                const entries = fs.readdirSync(dir, { withFileTypes: true });
+                for (const entry of entries) {
+                    const fullPath = path.join(dir, entry.name);
+                    if (entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules") {
+                        searchDir(fullPath);
+                    }
+                    else if (entry.isFile() && (entry.name.endsWith(".ts") || entry.name.endsWith(".d.ts"))) {
+                        const lower = entry.name.toLowerCase();
+                        if (patterns.some(p => lower.includes(p))) {
+                            contractFiles.push(path.relative(projectRoot, fullPath));
+                        }
+                    }
+                }
+            }
+            catch { /* skip unreadable */ }
+        };
+        searchDir(projectRoot);
+        return contractFiles;
+    }
+    /**
+     * Detects the project architecture type.
+     */
+    static detectArchitecture(projectRoot) {
+        const hasSrc = fs.existsSync(path.join(projectRoot, "src"));
+        const hasApps = fs.existsSync(path.join(projectRoot, "apps"));
+        const hasPackages = fs.existsSync(path.join(projectRoot, "packages"));
+        const hasBackend = fs.existsSync(path.join(projectRoot, "backend")) || fs.existsSync(path.join(projectRoot, "server"));
+        const hasFrontend = fs.existsSync(path.join(projectRoot, "frontend")) || fs.existsSync(path.join(projectRoot, "web"));
+        const hasPackageJson = fs.existsSync(path.join(projectRoot, "package.json"));
+        if (hasApps || hasPackages)
+            return "monorepo";
+        if (hasSrc && hasBackend && hasFrontend)
+            return "fullstack-src";
+        if (hasBackend && hasFrontend)
+            return "fullstack";
+        if (hasBackend)
+            return "backend-only";
+        if (hasFrontend)
+            return "frontend-only";
+        if (hasSrc)
+            return "src-based";
+        if (hasPackageJson)
+            return "simple-node";
+        return "unknown";
+    }
+    /**
+     * Generates recommendations based on discovery results.
+     */
+    static generateRecommendations(entryPoints, businessLogic, contracts, architecture) {
+        const recommendations = [];
+        if (entryPoints.length === 0) {
+            recommendations.push("No entry point found. Consider creating a standard entry point (index.ts, main.ts).");
+        }
+        if (businessLogic.length === 0) {
+            recommendations.push("No business logic files found. Consider using service/repository pattern.");
+        }
+        if (contracts.length === 0) {
+            recommendations.push("No contract/type files found. Define shared types before implementation.");
+        }
+        if (architecture === "unknown") {
+            recommendations.push("Architecture type undetected. Run `atabey init` to scaffold project structure.");
+        }
+        recommendations.push(`Detected architecture: ${architecture}`);
+        return recommendations;
+    }
+}
+//# sourceMappingURL=discovery-engine.js.map

package/dist/atabey/src/modules/engines/discovery-engine.js.map

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

package/dist/atabey/src/modules/engines/evaluation-engine.d.ts

@@ -0,0 +1,18 @@
+import { EvaluationResult } from "./types.js";
+export declare class EvaluationEngine {
+    /**
+     * Evaluates a completed task, calculates a score, and updates Specialty Memory.
+     * Saves lessons from both failures AND successes.
+     */
+    static evaluateTask(traceIdStr: string, agentName: string, durationMs: number, taskDescription?: string): EvaluationResult;
+    private static extractSuccessLesson;
+    /**
+     * Reads learned conventions from an agent's specialty memory.
+     * Used by silent-router to inject context into AI calls.
+     */
+    static readLearnedConventions(agentName: string): string;
+    /**
+     * Appends learned lessons to the agent's specialty memory.
+     */
+    private static updateSpecialtyMemory;
+}

package/dist/atabey/src/modules/engines/evaluation-engine.js

@@ -0,0 +1,171 @@
+import fs from "fs";
+import path from "path";
+import { scanProjectCompliance } from "../../cli/utils/compliance.js";
+import { getFrameworkDir } from "../../cli/utils/memory.js";
+import { appendFile, ensureDir, runCommandQuiet, writeTextFile } from "../../shared/fs.js";
+import { logger } from "../../shared/logger.js";
+import { asTraceID } from "../../shared/types.js";
+export class EvaluationEngine {
+    /**
+     * Evaluates a completed task, calculates a score, and updates Specialty Memory.
+     * Saves lessons from both failures AND successes.
+     */
+    static evaluateTask(traceIdStr, agentName, durationMs, taskDescription) {
+        const traceId = asTraceID(traceIdStr);
+        logger.debug(`Starting evaluation for Trace ${traceId} by ${agentName}`);
+        let score = 100;
+        const metrics = {
+            compilation: true,
+            lint: true,
+            tests: true,
+            compliance: 0
+        };
+        const projectRoot = process.cwd();
+        const lessons = [];
+        // 1. Compliance Check (AST-based discipline check)
+        try {
+            const issues = scanProjectCompliance("src");
+            metrics.compliance = issues.length;
+            if (issues.length > 0) {
+                score -= Math.min(issues.length * 5, 40);
+                lessons.push("Compliance Violations Detected: Ensure strict adherence to zero-any, zero-console.log policies.");
+            }
+            else {
+                lessons.push("Compliance check passed: No any types or console.log violations found.");
+            }
+        }
+        catch (e) {
+            logger.debug("Compliance check failed during evaluation", e);
+        }
+        // 2. Compilation Check
+        try {
+            if (fs.existsSync(path.join(projectRoot, "tsconfig.json"))) {
+                runCommandQuiet("npx", ["tsc", "--noEmit"], projectRoot);
+                lessons.push("TypeScript compilation succeeded. Project is type-safe.");
+            }
+        }
+        catch {
+            metrics.compilation = false;
+            score -= 20;
+            lessons.push("Compilation Error: Always run 'npx tsc --noEmit' to verify type safety before completing a task.");
+        }
+        // 3. Lint Check
+        try {
+            if (fs.existsSync(path.join(projectRoot, "eslint.config.js"))) {
+                runCommandQuiet("npx", ["eslint", ".", "--max-warnings", "0"], projectRoot);
+                lessons.push("Lint check passed. Code follows project style guidelines.");
+            }
+        }
+        catch {
+            metrics.lint = false;
+            score -= 10;
+        }
+        // 4. Test Check
+        try {
+            if (fs.existsSync(path.join(projectRoot, "vitest.config.ts"))) {
+                runCommandQuiet("npx", ["vitest", "run", "--passWithNoTests"], projectRoot);
+                lessons.push("All tests passed. Changes are verified.");
+            }
+        }
+        catch {
+            metrics.tests = false;
+            score -= 20;
+            lessons.push("Test Failure: Ensure all unit tests pass before marking a task as COMPLETED.");
+        }
+        // 5. Efficiency Check
+        if (durationMs > 120000) {
+            score -= 10;
+            lessons.push("Task took longer than 2 minutes. Consider breaking large tasks into smaller steps.");
+        }
+        else if (score >= 80) {
+            lessons.push("Task completed efficiently within expected timeframe.");
+        }
+        // 6. Success Lesson — if score is high and no critical errors
+        if (score >= 80 && taskDescription) {
+            const successLesson = this.extractSuccessLesson(agentName, taskDescription);
+            if (successLesson) {
+                lessons.push(successLesson);
+            }
+        }
+        // Save all lessons to specialty memory
+        for (const lesson of lessons) {
+            this.updateSpecialtyMemory(agentName, lesson);
+        }
+        const result = {
+            traceId,
+            agent: agentName.replace("@", ""),
+            score: Math.max(0, score),
+            metrics,
+            durationMs,
+            timestamp: new Date().toISOString()
+        };
+        logger.debug(`Evaluation completed for ${agentName}: Score ${result.score}/100`);
+        return result;
+    }
+    static extractSuccessLesson(agentName, taskDescription) {
+        const patterns = [
+            { keywords: ["api", "endpoint", "route", "rest"], category: "REST API pattern" },
+            { keywords: ["auth", "login", "jwt", "token"], category: "Authentication/authorization/JWT pattern" },
+            { keywords: ["test", "spec", "vitest"], category: "Test-driven development approach" },
+            { keywords: ["migration", "schema", "database", "sql"], category: "Database schema/migration pattern" },
+            { keywords: ["component", "react", "ui", "page"], category: "UI component design pattern" },
+            { keywords: ["middleware", "guard", "interceptor"], category: "Middleware/guard pipeline pattern" },
+            { keywords: ["service", "repository", "inject"], category: "Service/repository architecture pattern" },
+            { keywords: ["error", "exception", "catch", "try"], category: "Robust error handling pattern" },
+            { keywords: ["config", "env", "environment"], category: "Configuration and environment control pattern" },
+        ];
+        const lower = taskDescription.toLowerCase();
+        let categoryStr = "";
+        for (const { keywords, category } of patterns) {
+            if (keywords.some(k => lower.includes(k))) {
+                categoryStr = ` using ${category}`;
+                break;
+            }
+        }
+        const cleanedTask = taskDescription.replace(/\r?\n/g, " ").trim();
+        const truncatedTask = cleanedTask.length > 120 ? cleanedTask.substring(0, 117) + "..." : cleanedTask;
+        const capitalizedTask = truncatedTask.charAt(0).toUpperCase() + truncatedTask.slice(1);
+        return `Successfully completed task: "${capitalizedTask}"${categoryStr}.`;
+    }
+    /**
+     * Reads learned conventions from an agent's specialty memory.
+     * Used by silent-router to inject context into AI calls.
+     */
+    static readLearnedConventions(agentName) {
+        const cleanName = agentName.replace("@", "");
+        const fwDir = getFrameworkDir();
+        const filePath = path.join(fwDir, "memory", "specialties", `${cleanName}.md`);
+        try {
+            if (fs.existsSync(filePath)) {
+                const content = fs.readFileSync(filePath, "utf8").trim();
+                if (content)
+                    return content;
+            }
+        }
+        catch {
+            // File might not exist yet
+        }
+        return "";
+    }
+    /**
+     * Appends learned lessons to the agent's specialty memory.
+     */
+    static updateSpecialtyMemory(agentName, lesson) {
+        const cleanName = agentName.replace("@", "");
+        const fwDir = getFrameworkDir();
+        const specialtiesDir = path.join(fwDir, "memory", "specialties");
+        ensureDir(specialtiesDir);
+        const filePath = path.join(specialtiesDir, `${cleanName}.md`);
+        const timestamp = new Date().toISOString().split("T")[0];
+        const entry = `- **[${timestamp}]**: ${lesson}\n`;
+        if (!fs.existsSync(filePath)) {
+            writeTextFile(filePath, `# Learned Conventions for @${cleanName}\n\n`);
+        }
+        // Avoid duplicate lessons on the same day
+        const currentContent = fs.readFileSync(filePath, "utf8");
+        if (!currentContent.includes(lesson)) {
+            appendFile(filePath, entry);
+        }
+    }
+}
+//# sourceMappingURL=evaluation-engine.js.map

package/dist/atabey/src/modules/engines/evaluation-engine.js.map

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

package/dist/atabey/src/modules/engines/file-lock.d.ts

@@ -0,0 +1,41 @@
+/**
+ * [ENGINE] File Lock — Conflict Resolution for Multi-Agent File Access
+ *
+ * Prevents two agents from writing to the same file simultaneously.
+ * Uses .atabey/locks/ directory with per-file lock files.
+ *
+ * Flow:
+ * 1. Agent A acquires lock on src/file.ts → writes .atabey/locks/src/file.ts.lock
+ * 2. Agent B tries to write src/file.ts → lock exists → WAITING state
+ * 3. Agent A releases lock → Agent B can proceed
+ *
+ * Stale lock detection: locks older than 5 minutes are auto-released.
+ */
+export declare class FileLock {
+    private static LOCKS_DIR;
+    private static STALE_TIMEOUT_MS;
+    /**
+     * Attempts to acquire a lock for a file on behalf of an agent.
+     * Returns true if lock acquired, false if another agent holds it.
+     */
+    static acquire(agentName: string, filePath: string): boolean;
+    /**
+     * Releases a lock held by an agent.
+     * Only the lock-owning agent can release (others get warning).
+     */
+    static release(agentName: string, filePath: string): boolean;
+    /**
+     * Checks if a file is currently locked.
+     * Returns the locking agent name or null.
+     */
+    static isLocked(filePath: string): string | null;
+    /**
+     * Lists all currently active locks.
+     */
+    static listLocks(): Array<{
+        agent: string;
+        file: string;
+        acquiredAt: string;
+    }>;
+    private static getLockPath;
+}

package/dist/atabey/src/modules/engines/file-lock.js

@@ -0,0 +1,168 @@
+import fs from "fs";
+import path from "path";
+import { logger } from "../../shared/logger.js";
+import { AtabeyStorage } from "../../shared/storage.js";
+/**
+ * [ENGINE] File Lock — Conflict Resolution for Multi-Agent File Access
+ *
+ * Prevents two agents from writing to the same file simultaneously.
+ * Uses .atabey/locks/ directory with per-file lock files.
+ *
+ * Flow:
+ * 1. Agent A acquires lock on src/file.ts → writes .atabey/locks/src/file.ts.lock
+ * 2. Agent B tries to write src/file.ts → lock exists → WAITING state
+ * 3. Agent A releases lock → Agent B can proceed
+ *
+ * Stale lock detection: locks older than 5 minutes are auto-released.
+ */
+export class FileLock {
+    static LOCKS_DIR = ".atabey/locks";
+    static STALE_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
+    /**
+     * Attempts to acquire a lock for a file on behalf of an agent.
+     * Returns true if lock acquired, false if another agent holds it.
+     */
+    static acquire(agentName, filePath) {
+        const lockFile = FileLock.getLockPath(filePath);
+        const lockDir = path.dirname(lockFile);
+        // Ensure locks directory exists
+        if (!fs.existsSync(lockDir)) {
+            fs.mkdirSync(lockDir, { recursive: true });
+        }
+        // Check if lock already exists
+        if (fs.existsSync(lockFile)) {
+            try {
+                const lockData = JSON.parse(fs.readFileSync(lockFile, "utf8"));
+                // Check if lock is stale (older than 5 min)
+                const lockAge = Date.now() - new Date(lockData.acquiredAt).getTime();
+                if (lockAge > FileLock.STALE_TIMEOUT_MS) {
+                    logger.warn(`[FILE_LOCK] Stale lock detected for ${filePath} (age: ${Math.round(lockAge / 1000)}s). Overriding.`);
+                    fs.unlinkSync(lockFile);
+                }
+                else {
+                    // Lock is held by another agent — conflict
+                    logger.warn(`[FILE_LOCK] CONFLICT: ${agentName} cannot write ${filePath} — locked by ${lockData.agent}`);
+                    AtabeyStorage.saveLog({
+                        agent: agentName,
+                        action: "FILE_LOCK_CONFLICT",
+                        trace_id: AtabeyStorage.getMetadata("traceId") || "N/A",
+                        status: "BLOCKED",
+                        summary: `File ${filePath} is locked by ${lockData.agent}. Waiting for release.`
+                    });
+                    return false;
+                }
+            }
+            catch {
+                // Corrupted lock file — remove and retry
+                fs.unlinkSync(lockFile);
+            }
+        }
+        // Acquire lock
+        fs.writeFileSync(lockFile, JSON.stringify({
+            agent: agentName,
+            file: filePath,
+            acquiredAt: new Date().toISOString(),
+            traceId: AtabeyStorage.getMetadata("traceId") || "N/A"
+        }, null, 2));
+        logger.debug(`[FILE_LOCK] ${agentName} acquired lock on ${filePath}`);
+        return true;
+    }
+    /**
+     * Releases a lock held by an agent.
+     * Only the lock-owning agent can release (others get warning).
+     */
+    static release(agentName, filePath) {
+        const lockFile = FileLock.getLockPath(filePath);
+        if (!fs.existsSync(lockFile)) {
+            return true; // No lock to release
+        }
+        try {
+            const lockData = JSON.parse(fs.readFileSync(lockFile, "utf8"));
+            if (lockData.agent !== agentName) {
+                logger.warn(`[FILE_LOCK] ${agentName} tried to release lock held by ${lockData.agent} on ${filePath}`);
+                return false;
+            }
+            fs.unlinkSync(lockFile);
+            logger.debug(`[FILE_LOCK] ${agentName} released lock on ${filePath}`);
+            return true;
+        }
+        catch {
+            // Corrupted lock file — just remove it
+            try {
+                fs.unlinkSync(lockFile);
+            }
+            catch { /* ignore */ }
+            return true;
+        }
+    }
+    /**
+     * Checks if a file is currently locked.
+     * Returns the locking agent name or null.
+     */
+    static isLocked(filePath) {
+        const lockFile = FileLock.getLockPath(filePath);
+        if (!fs.existsSync(lockFile))
+            return null;
+        try {
+            const lockData = JSON.parse(fs.readFileSync(lockFile, "utf8"));
+            // Check for stale lock
+            const lockAge = Date.now() - new Date(lockData.acquiredAt).getTime();
+            if (lockAge > FileLock.STALE_TIMEOUT_MS) {
+                fs.unlinkSync(lockFile);
+                return null;
+            }
+            return lockData.agent;
+        }
+        catch {
+            try {
+                fs.unlinkSync(lockFile);
+            }
+            catch { /* ignore */ }
+            return null;
+        }
+    }
+    /**
+     * Lists all currently active locks.
+     */
+    static listLocks() {
+        const locksDir = path.join(process.cwd(), FileLock.LOCKS_DIR);
+        if (!fs.existsSync(locksDir))
+            return [];
+        const locks = [];
+        const walkDir = (dir) => {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    walkDir(fullPath);
+                }
+                else if (entry.name.endsWith(".lock")) {
+                    try {
+                        const data = JSON.parse(fs.readFileSync(fullPath, "utf8"));
+                        const lockAge = Date.now() - new Date(data.acquiredAt).getTime();
+                        if (lockAge <= FileLock.STALE_TIMEOUT_MS) {
+                            locks.push(data);
+                        }
+                        else {
+                            fs.unlinkSync(fullPath); // Clean stale
+                        }
+                    }
+                    catch {
+                        try {
+                            fs.unlinkSync(fullPath);
+                        }
+                        catch { /* ignore */ }
+                    }
+                }
+            }
+        };
+        walkDir(locksDir);
+        return locks;
+    }
+    static getLockPath(filePath) {
+        // Convert absolute/relative path to lock file path
+        const relativePath = path.relative(process.cwd(), filePath).replace(/^\.\.\//, "");
+        return path.join(process.cwd(), FileLock.LOCKS_DIR, `${relativePath}.lock`);
+    }
+}
+//# sourceMappingURL=file-lock.js.map

package/dist/atabey/src/modules/engines/file-lock.js.map

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

package/dist/atabey/src/modules/engines/health-engine.d.ts

@@ -0,0 +1,22 @@
+import { EvaluationResult, ProjectHealth } from "./types.js";
+/**
+ * [DATA] Evaluation & Health Engine
+ * Rates agent performance and tracks overall project stability.
+ * Now uses real metrics from SQLite, compliance scans, and agent states.
+ */
+export declare class HealthEngine {
+    /**
+     * Records a post-task evaluation.
+     */
+    static recordEvaluation(result: EvaluationResult): Promise<void>;
+    /**
+     * Aggregates real data to calculate the overall Project Health.
+     * Uses actual metrics from:
+     * - Agent success rates from SQLite logs
+     * - Compliance violations from AST scanning
+     * - Agent state distribution (blocked/ready ratio)
+     * - Test results from recent evaluations
+     */
+    static updateProjectHealth(): Promise<ProjectHealth>;
+    static getHealth(): ProjectHealth | null;
+}