atabey 0.0.16 → 0.0.18

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

@@ -0,0 +1,127 @@
+import fs from "fs";
+import path from "path";
+import { scanProjectCompliance } from "../../cli/utils/compliance.js";
+import { getFrameworkDir } from "../../cli/utils/memory.js";
+import { ensureDir, writeJsonFile } from "../../shared/fs.js";
+import { Storage } from "../../shared/storage.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 class HealthEngine {
+    /**
+     * Records a post-task evaluation.
+     */
+    static async recordEvaluation(result) {
+        const evalDir = path.join(getFrameworkDir(), "memory", "evaluations");
+        ensureDir(evalDir);
+        const filePath = path.join(evalDir, `${result.traceId}_${result.agent}.json`);
+        writeJsonFile(filePath, result);
+        // Trigger health update
+        await this.updateProjectHealth();
+    }
+    /**
+     * 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 async updateProjectHealth() {
+        const frameworkDir = getFrameworkDir();
+        const agents = Storage.getAllAgents();
+        const logs = Storage.getLogs();
+        const evaluationsDir = path.join(frameworkDir, "memory", "evaluations");
+        // 1. Agent Health Score (based on success rate & state distribution)
+        let agentScore = 100;
+        const totalLogs = logs.length;
+        if (totalLogs > 0) {
+            const successCount = logs.filter((l) => l.status === "SUCCESS").length;
+            const successRate = (successCount / totalLogs) * 100;
+            agentScore = Math.round(successRate);
+        }
+        // Penalize blocked/timeout agents
+        const blockedAgents = agents.filter((a) => a.state === "BLOCKED" || a.state === "TIMEOUT").length;
+        if (blockedAgents > 0) {
+            agentScore -= blockedAgents * 10;
+        }
+        // 2. Code Quality Score (based on compliance violations)
+        let qualityScore = 100;
+        try {
+            const violations = scanProjectCompliance("src");
+            if (violations.length > 0) {
+                qualityScore -= Math.min(violations.length * 5, 50);
+            }
+        }
+        catch {
+            qualityScore = 70; // Fallback if scan fails
+        }
+        // 3. Security Score (based on evaluation findings)
+        let securityScore = 100;
+        if (fs.existsSync(evaluationsDir)) {
+            const evalFiles = fs.readdirSync(evaluationsDir).filter((f) => f.endsWith(".json"));
+            let securityIssues = 0;
+            let totalEvalMetrics = 0;
+            for (const file of evalFiles.slice(-20)) { // Last 20 evaluations
+                try {
+                    const evalData = JSON.parse(fs.readFileSync(path.join(evaluationsDir, file), "utf8"));
+                    if (evalData.metrics) {
+                        totalEvalMetrics++;
+                        if (!evalData.metrics.compilation)
+                            securityIssues += 2;
+                        if (!evalData.metrics.lint)
+                            securityIssues += 1;
+                        if (!evalData.metrics.tests)
+                            securityIssues += 3;
+                    }
+                }
+                catch {
+                    // Skip corrupted files
+                }
+            }
+            if (totalEvalMetrics > 0) {
+                securityScore -= Math.min((securityIssues / totalEvalMetrics) * 20, 40);
+            }
+        }
+        // 4. Architecture Score (based on metadata stability)
+        const phaseOrder = ["PHASE_0", "PHASE_1", "PHASE_2", "PHASE_3", "PHASE_4"];
+        const currentPhase = Storage.getMetadata("phase") || "PHASE_0";
+        const phaseIndex = phaseOrder.indexOf(currentPhase);
+        const architectureScore = Math.min(60 + phaseIndex * 10, 100);
+        // Calculate weighted final score
+        const score = Math.max(0, Math.min(100, Math.round(agentScore * 0.30 + // Agent performance: 30%
+            qualityScore * 0.25 + // Code quality: 25%
+            securityScore * 0.25 + // Security: 25%
+            architectureScore * 0.20 // Architecture: 20%
+        )));
+        const health = {
+            score,
+            codeQuality: Math.max(0, qualityScore),
+            security: Math.max(0, securityScore),
+            architecture: architectureScore,
+            agentHealth: Math.max(0, agentScore),
+            totalAgents: agents.length,
+            activeAgents: agents.filter((a) => a.state === "EXECUTING" || a.state === "ACTIVE").length,
+            blockedAgents,
+            totalLogs,
+            lastUpdated: new Date().toISOString()
+        };
+        const healthFile = path.join(frameworkDir, "memory", "HEALTH.json");
+        writeJsonFile(healthFile, health);
+        return health;
+    }
+    static getHealth() {
+        try {
+            const healthFile = path.join(getFrameworkDir(), "memory", "HEALTH.json");
+            if (!fs.existsSync(healthFile))
+                return null;
+            return JSON.parse(fs.readFileSync(healthFile, "utf8"));
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=health-engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health-engine.js","sourceRoot":"","sources":["../../../../../src/modules/engines/health-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGlD;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACrB;;OAEG;IACI,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAwB;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QACtE,SAAS,CAAC,OAAO,CAAC,CAAC;QAEnB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,OAAO,CAAC,CAAC;QAC9E,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEhC,wBAAwB;QACxB,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;IACrC,CAAC;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,KAAK,CAAC,mBAAmB;QACnC,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAExE,qEAAqE;QACrE,IAAI,UAAU,GAAG,GAAG,CAAC;QACrB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;QAC9B,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAChB,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;YACvE,MAAM,WAAW,GAAG,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC;YACrD,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACzC,CAAC;QAED,kCAAkC;QAClC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;QAClG,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YACpB,UAAU,IAAI,aAAa,GAAG,EAAE,CAAC;QACrC,CAAC;QAED,yDAAyD;QACzD,IAAI,YAAY,GAAG,GAAG,CAAC;QACvB,IAAI,CAAC;YACD,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,YAAY,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YACxD,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,YAAY,GAAG,EAAE,CAAC,CAAC,yBAAyB;QAChD,CAAC;QAED,mDAAmD;QACnD,IAAI,aAAa,GAAG,GAAG,CAAC;QACxB,IAAI,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAChC,MAAM,SAAS,GAAG,EAAE,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YACpF,IAAI,cAAc,GAAG,CAAC,CAAC;YACvB,IAAI,gBAAgB,GAAG,CAAC,CAAC;YAEzB,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,sBAAsB;gBAC7D,IAAI,CAAC;oBACD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACvB,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CACvC,CAAC;oBACtB,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;wBACnB,gBAAgB,EAAE,CAAC;wBACnB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW;4BAAE,cAAc,IAAI,CAAC,CAAC;wBACvD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI;4BAAE,cAAc,IAAI,CAAC,CAAC;wBAChD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK;4BAAE,cAAc,IAAI,CAAC,CAAC;oBACrD,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACL,uBAAuB;gBAC3B,CAAC;YACL,CAAC;YAED,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;gBACvB,aAAa,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,cAAc,GAAG,gBAAgB,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;YAC5E,CAAC;QACL,CAAC;QAED,sDAAsD;QACtD,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC3E,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC;QAC/D,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACpD,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,UAAU,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;QAE9D,iCAAiC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAClC,IAAI,CAAC,KAAK,CACN,UAAU,GAAG,IAAI,GAAK,yBAAyB;YAC/C,YAAY,GAAG,IAAI,GAAI,oBAAoB;YAC3C,aAAa,GAAG,IAAI,GAAG,gBAAgB;YACvC,iBAAiB,GAAG,IAAI,CAAC,oBAAoB;SAChD,CACJ,CAAC,CAAC;QAEH,MAAM,MAAM,GAAkB;YAC1B,KAAK;YACL,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC;YACtC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC;YACpC,YAAY,EAAE,iBAAiB;YAC/B,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC;YACpC,WAAW,EAAE,MAAM,CAAC,MAAM;YAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,WAAW,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,MAAM;YAC1F,aAAa;YACb,SAAS;YACT,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACxC,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QACpE,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAElC,OAAO,MAAM,CAAC;IAClB,CAAC;IAEM,MAAM,CAAC,SAAS;QACnB,IAAI,CAAC;YACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;YACzE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;CACJ"}

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

@@ -0,0 +1,82 @@
+/**
+ * [ENGINE] Phase Engine — State Machine for Development Lifecycle
+ *
+ * Implements the PHASE_0 → PHASE_4 state machine from ATABEY.md.
+ * Prevents phase skipping and enforces rollback when contracts break.
+ *
+ * Phases:
+ *   PHASE_0 (Discovery & Setup)     → Requirements analysis, docs validation
+ *   PHASE_1 (Architecture & Contracts) → Data models, API schemas, types
+ *   PHASE_2 (Core Development)      → Feature implementation
+ *   PHASE_3 (Integration & Testing) → System integration, QA
+ *   PHASE_4 (Optimization & Deployment) → Performance audit, deploy
+ *
+ * Rollback:
+ *   If contracts break during PHASE_2+ → auto rollback to PHASE_1
+ */
+export type Phase = "PHASE_0" | "PHASE_1" | "PHASE_2" | "PHASE_3" | "PHASE_4" | "ROLLBACK_PHASE_1";
+export interface PhaseTransition {
+    from: Phase;
+    to: Phase;
+    timestamp: string;
+    reason: string;
+    triggeredBy: string;
+}
+export interface PhaseRequirements {
+    phase: Phase;
+    name: string;
+    allowedWork: string[];
+    successCriteria: string[];
+    prohibitedWork: string[];
+}
+/**
+ * Phase Engine — manages the development lifecycle state machine.
+ * Stored in Storage metadata under "phase" key.
+ * Transition history stored in `.atabey/logs/phase-transitions.json`.
+ */
+export declare class PhaseEngine {
+    private static readonly VALID_TRANSITIONS;
+    private static readonly PHASE_DEFINITIONS;
+    /**
+     * Returns the current phase from storage.
+     */
+    static getCurrentPhase(): Phase;
+    /**
+     * Attempts to transition to a new phase.
+     * Validates that the transition is allowed by the state machine.
+     */
+    static transitionTo(targetPhase: Phase, reason: string, triggeredBy: string): Promise<{
+        success: boolean;
+        from: Phase;
+        to: Phase;
+        error?: string;
+    }>;
+    /**
+     * Checks if a given work type is allowed in the current phase.
+     */
+    static isWorkAllowed(work: string): boolean;
+    /**
+     * Returns the requirements for the current phase.
+     */
+    static getCurrentPhaseRequirements(): PhaseRequirements;
+    /**
+     * Checks if all success criteria for the current phase are met.
+     */
+    static checkPhaseCompletion(): Promise<{
+        complete: boolean;
+        missingCriteria: string[];
+    }>;
+    /**
+     * Marks a success criterion as completed.
+     */
+    static markCriteriaMet(criteria: string, agent: string): Promise<void>;
+    /**
+     * Detects if contracts are broken and auto-triggers rollback.
+     * Called by ContractEngine when contract_hash changes unexpectedly.
+     */
+    static detectBrokenContracts(triggeredBy: string): Promise<void>;
+    /**
+     * Notifies all agents to switch to WAITING state during rollback.
+     */
+    private static notifyAgentsOfRollback;
+}

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

@@ -0,0 +1,211 @@
+/**
+ * [ENGINE] Phase Engine — State Machine for Development Lifecycle
+ *
+ * Implements the PHASE_0 → PHASE_4 state machine from ATABEY.md.
+ * Prevents phase skipping and enforces rollback when contracts break.
+ *
+ * Phases:
+ *   PHASE_0 (Discovery & Setup)     → Requirements analysis, docs validation
+ *   PHASE_1 (Architecture & Contracts) → Data models, API schemas, types
+ *   PHASE_2 (Core Development)      → Feature implementation
+ *   PHASE_3 (Integration & Testing) → System integration, QA
+ *   PHASE_4 (Optimization & Deployment) → Performance audit, deploy
+ *
+ * Rollback:
+ *   If contracts break during PHASE_2+ → auto rollback to PHASE_1
+ */
+import { logger } from "../../shared/logger.js";
+import { AtabeyStorage } from "../../shared/storage.js";
+/**
+ * Phase Engine — manages the development lifecycle state machine.
+ * Stored in Storage metadata under "phase" key.
+ * Transition history stored in `.atabey/logs/phase-transitions.json`.
+ */
+export class PhaseEngine {
+    static VALID_TRANSITIONS = {
+        "PHASE_0": ["PHASE_1"],
+        "PHASE_1": ["PHASE_2", "ROLLBACK_PHASE_1"],
+        "PHASE_2": ["PHASE_3", "ROLLBACK_PHASE_1"],
+        "PHASE_3": ["PHASE_4", "ROLLBACK_PHASE_1"],
+        "PHASE_4": ["PHASE_0"], // Release → restart cycle
+        "ROLLBACK_PHASE_1": ["PHASE_1"], // Rollback → fix → re-enter PHASE_1
+    };
+    static PHASE_DEFINITIONS = {
+        "PHASE_0": {
+            phase: "PHASE_0",
+            name: "Discovery & Setup",
+            allowedWork: ["Requirement analysis", "Documentation validation", "Environment setup", "Scaffolding"],
+            successCriteria: ["docs/README.md validated", "Technology stack confirmed", "Target audience identified"],
+            prohibitedWork: ["Any code implementation", "Database migrations", "API development"],
+        },
+        "PHASE_1": {
+            phase: "PHASE_1",
+            name: "Architecture & Contracts",
+            allowedWork: ["Type definitions", "API schema design", "Interface design", "Contract versioning"],
+            successCriteria: ["contract.version.json created", "All shared types defined", "Frontend + Backend approve schemas"],
+            prohibitedWork: ["Business logic implementation", "Database queries", "UI components"],
+        },
+        "PHASE_2": {
+            phase: "PHASE_2",
+            name: "Core Development",
+            allowedWork: ["Feature implementation", "Business logic", "API endpoints", "UI components", "Tests"],
+            successCriteria: ["All features implemented", "Tests passing", "Contract hash verified"],
+            prohibitedWork: ["Production deployment", "Schema changes without rollback"],
+        },
+        "PHASE_3": {
+            phase: "PHASE_3",
+            name: "Integration & Testing",
+            allowedWork: ["System integration", "End-to-end testing", "Performance testing", "Security audit"],
+            successCriteria: ["All integration tests pass", "No critical bugs", "Security scan clean"],
+            prohibitedWork: ["New features", "Schema changes"],
+        },
+        "PHASE_4": {
+            phase: "PHASE_4",
+            name: "Optimization & Deployment",
+            allowedWork: ["Performance optimization", "Deployment", "Post-release monitoring"],
+            successCriteria: ["Deployment successful", "Health checks passing", "Rollback plan ready"],
+            prohibitedWork: ["New features", "Schema changes"],
+        },
+        "ROLLBACK_PHASE_1": {
+            phase: "ROLLBACK_PHASE_1",
+            name: "Contract Rollback",
+            allowedWork: ["Contract repair", "Type definition fixes", "Schema corrections"],
+            successCriteria: ["Contracts fixed", "contract_hash recalculated"],
+            prohibitedWork: ["New features", "Deployment"],
+        },
+    };
+    /**
+     * Returns the current phase from storage.
+     */
+    static getCurrentPhase() {
+        const phase = AtabeyStorage.getMetadata("phase");
+        return phase || "PHASE_0";
+    }
+    /**
+     * Attempts to transition to a new phase.
+     * Validates that the transition is allowed by the state machine.
+     */
+    static async transitionTo(targetPhase, reason, triggeredBy) {
+        const currentPhase = PhaseEngine.getCurrentPhase();
+        const allowedTransitions = PhaseEngine.VALID_TRANSITIONS[currentPhase];
+        if (!allowedTransitions || !allowedTransitions.includes(targetPhase)) {
+            const errorMsg = `Phase transition ${currentPhase} → ${targetPhase} is NOT ALLOWED. Allowed: ${allowedTransitions?.join(", ") || "none"}`;
+            logger.warn(`[PHASE] ${errorMsg}`);
+            AtabeyStorage.saveLog({
+                agent: triggeredBy,
+                action: "PHASE_TRANSITION_BLOCKED",
+                trace_id: AtabeyStorage.getMetadata("traceId") || "N/A",
+                status: "FAILED",
+                summary: errorMsg
+            });
+            return {
+                success: false,
+                from: currentPhase,
+                to: targetPhase,
+                error: errorMsg,
+            };
+        }
+        // Execute transition
+        AtabeyStorage.setMetadata("phase", targetPhase);
+        const transition = {
+            from: currentPhase,
+            to: targetPhase,
+            timestamp: new Date().toISOString(),
+            reason,
+            triggeredBy,
+        };
+        // Log transition
+        AtabeyStorage.saveLog({
+            agent: triggeredBy,
+            action: "PHASE_TRANSITION",
+            trace_id: AtabeyStorage.getMetadata("traceId") || "N/A",
+            status: "SUCCESS",
+            summary: `${currentPhase} → ${targetPhase}: ${reason}`
+        });
+        logger.info(`[PHASE] ${currentPhase} → ${targetPhase} (by ${triggeredBy}): ${reason}`);
+        // If entering ROLLBACK, notify all agents to switch to WAITING
+        if (targetPhase === "ROLLBACK_PHASE_1") {
+            await PhaseEngine.notifyAgentsOfRollback();
+        }
+        return {
+            success: true,
+            from: currentPhase,
+            to: targetPhase,
+        };
+    }
+    /**
+     * Checks if a given work type is allowed in the current phase.
+     */
+    static isWorkAllowed(work) {
+        const currentPhase = PhaseEngine.getCurrentPhase();
+        const phaseDef = PhaseEngine.PHASE_DEFINITIONS[currentPhase];
+        if (!phaseDef)
+            return false;
+        const workLower = work.toLowerCase();
+        return phaseDef.allowedWork.some(allowed => workLower.includes(allowed.toLowerCase()));
+    }
+    /**
+     * Returns the requirements for the current phase.
+     */
+    static getCurrentPhaseRequirements() {
+        const currentPhase = PhaseEngine.getCurrentPhase();
+        return PhaseEngine.PHASE_DEFINITIONS[currentPhase] || PhaseEngine.PHASE_DEFINITIONS["PHASE_0"];
+    }
+    /**
+     * Checks if all success criteria for the current phase are met.
+     */
+    static async checkPhaseCompletion() {
+        const phaseDef = PhaseEngine.getCurrentPhaseRequirements();
+        const missingCriteria = [];
+        for (const criteria of phaseDef.successCriteria) {
+            // Check if the criteria has been logged as completed
+            const logs = AtabeyStorage.getLogs();
+            const isCompleted = logs.some(l => l.action === "PHASE_CRITERIA_MET" &&
+                l.summary.includes(criteria));
+            if (!isCompleted) {
+                missingCriteria.push(criteria);
+            }
+        }
+        return {
+            complete: missingCriteria.length === 0,
+            missingCriteria,
+        };
+    }
+    /**
+     * Marks a success criterion as completed.
+     */
+    static async markCriteriaMet(criteria, agent) {
+        AtabeyStorage.saveLog({
+            agent,
+            action: "PHASE_CRITERIA_MET",
+            trace_id: AtabeyStorage.getMetadata("traceId") || "N/A",
+            status: "SUCCESS",
+            summary: criteria
+        });
+        logger.info(`[PHASE] Criteria met: ${criteria} (by ${agent})`);
+    }
+    /**
+     * Detects if contracts are broken and auto-triggers rollback.
+     * Called by ContractEngine when contract_hash changes unexpectedly.
+     */
+    static async detectBrokenContracts(triggeredBy) {
+        const currentPhase = PhaseEngine.getCurrentPhase();
+        if (currentPhase === "PHASE_2" || currentPhase === "PHASE_3" || currentPhase === "PHASE_4") {
+            logger.warn(`[PHASE] Broken contracts detected in ${currentPhase}. Auto-rolling back to PHASE_1.`);
+            await PhaseEngine.transitionTo("ROLLBACK_PHASE_1", "Contract hash mismatch detected — automatic rollback", triggeredBy);
+        }
+    }
+    /**
+     * Notifies all agents to switch to WAITING state during rollback.
+     */
+    static async notifyAgentsOfRollback() {
+        const agents = AtabeyStorage.getAllAgents();
+        for (const agent of agents) {
+            if (agent.state === "EXECUTING" || agent.state === "COMPLETED") {
+                AtabeyStorage.updateAgentStatus(agent.name, "WAITING", `Contract rollback in progress — phase reset to PHASE_1`);
+            }
+        }
+        logger.info("[PHASE] All agents notified of rollback. Waiting for contract fixes.");
+    }
+}
+//# sourceMappingURL=phase-engine.js.map

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

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

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

@@ -0,0 +1,25 @@
+import { Plan } from "./types.js";
+/**
+ * [MAP] Planning Engine (The Strategist)
+ * Responsible for decomposing complex requests into a DAG of atomic tasks.
+ */
+export declare class PlanningEngine {
+    /**
+     * Creates a new Plan structure.
+     * In a real enterprise scenario, this would be fueled by an LLM prompt.
+     * For now, it provides the structural backbone.
+     */
+    static createPlan(rawTasks: {
+        id?: string;
+        task: string;
+        agent?: string;
+        dependencies?: string[];
+    }[]): Plan;
+    /**
+     * Validates a plan's integrity (no circular dependencies, all agents valid).
+     */
+    static validatePlan(plan: Plan): {
+        valid: boolean;
+        errors: string[];
+    };
+}

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

@@ -0,0 +1,80 @@
+import { asPlanID, asTaskID } from "../../shared/types.js";
+import { generateULID } from "../../cli/utils/time.js";
+import { RoutingEngine } from "./routing-engine.js";
+/**
+ * [MAP] Planning Engine (The Strategist)
+ * Responsible for decomposing complex requests into a DAG of atomic tasks.
+ */
+export class PlanningEngine {
+    /**
+     * Creates a new Plan structure.
+     * In a real enterprise scenario, this would be fueled by an LLM prompt.
+     * For now, it provides the structural backbone.
+     */
+    static createPlan(rawTasks) {
+        const planId = asPlanID(generateULID());
+        const tasks = rawTasks.map((t, index) => {
+            const id = t.id || `TASK_${String(index + 1).padStart(2, "0")}`;
+            return {
+                id: asTaskID(id),
+                agent: t.agent || RoutingEngine.resolveAgent(t.task),
+                task: t.task,
+                dependencies: (t.dependencies || []).map(d => asTaskID(d))
+            };
+        });
+        return {
+            planId,
+            tasks
+        };
+    }
+    /**
+     * Validates a plan's integrity (no circular dependencies, all agents valid).
+     */
+    static validatePlan(plan) {
+        const errors = [];
+        const taskIds = new Set(plan.tasks.map(t => t.id));
+        for (const task of plan.tasks) {
+            // Check dependencies exist
+            for (const dep of task.dependencies) {
+                if (!taskIds.has(dep)) {
+                    errors.push(`Task ${task.id} has non-existent dependency: ${dep}`);
+                }
+            }
+            // Check circular dependencies (simple check for now)
+            if (task.dependencies.includes(task.id)) {
+                errors.push(`Task ${task.id} cannot depend on itself.`);
+            }
+        }
+        // Circular dependency detection using DFS
+        const visited = new Set();
+        const recStack = new Set();
+        const hasCycle = (taskId) => {
+            if (recStack.has(taskId))
+                return true;
+            if (visited.has(taskId))
+                return false;
+            visited.add(taskId);
+            recStack.add(taskId);
+            const task = plan.tasks.find(t => t.id === taskId);
+            if (task) {
+                for (const dep of task.dependencies) {
+                    if (hasCycle(dep))
+                        return true;
+                }
+            }
+            recStack.delete(taskId);
+            return false;
+        };
+        for (const task of plan.tasks) {
+            if (hasCycle(task.id)) {
+                errors.push("Circular dependency detected in plan.");
+                break;
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors
+        };
+    }
+}
+//# sourceMappingURL=planning-engine.js.map

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

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

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

@@ -0,0 +1,63 @@
+/**
+ * [ENGINE] Policy Engine — Language, CLI, Dashboard & Parallel Rules
+ *
+ * Combines remaining vision items:
+ * 5. API Versioning Strategy — URL versioning enforcement
+ * 7. Dashboard Live Features — WebSocket ApprovalCenter, CompliancePanel
+ * 8. CLI Command Map — .atabey/cli-commands.json management
+ * 9. Language Policy Enforcer — English-only comments/variables
+ * 10. Parallel Execution Rules — dependency lock, ownership, commit logging
+ */
+export interface CliCommandEntry {
+    command: string;
+    agent: string;
+    description: string;
+    outputFormat?: "json" | "text";
+}
+export interface LanguageViolation {
+    file: string;
+    line: number;
+    type: "turkish_comment" | "non_english_variable" | "ui_text_not_english";
+    content: string;
+}
+/**
+ * Policy Engine — enforces language policy, manages CLI command map,
+ * provides dashboard live data, and enforces parallel execution rules.
+ */
+export declare class PolicyEngine {
+    /**
+     * Validates that API endpoints use versioned paths (/api/v{N}/...).
+     */
+    static validateApiVersioning(filePath: string, content: string): string[];
+    /**
+     * Returns dashboard live data for WebSocket broadcast.
+     */
+    static getDashboardData(): Record<string, unknown>;
+    /**
+     * Gets the CLI command map from .atabey/cli-commands.json.
+     */
+    static getCliCommands(): CliCommandEntry[];
+    /**
+     * Saves CLI command map.
+     */
+    static saveCliCommand(command: CliCommandEntry): void;
+    private static getDefaultCommands;
+    /**
+     * Scans files for language policy violations.
+     * Rules: comments in English, variable/function names in English, UI text in English.
+     */
+    static scanLanguagePolicy(filePath: string, content: string): LanguageViolation[];
+    /**
+     * Checks implicit dependency lock — if an agent's required output
+     * is not ready, the dependent agent switches to WAITING state.
+     */
+    static checkImplicitDependency(agentName: string, requiredAgent: string): boolean;
+    /**
+     * Enforces file ownership — an agent cannot modify files outside its scope.
+     */
+    static enforceOwnership(agentName: string, filePath: string): boolean;
+    /**
+     * Logs commit-level information for traceability.
+     */
+    static logCommit(agentName: string, message: string, traceId: string): void;
+}