atabey 0.0.37 → 0.1.0

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

@@ -1,161 +0,0 @@
-/**
- * [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

@@ -1 +0,0 @@
-{"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/file-lock.d.ts

@@ -1,56 +0,0 @@
-/**
- * [ENGINE] File Lock — Conflict Resolution for Multi-Agent File Access
- *
- * Prevents two agents from writing to the same file simultaneously.
- * Uses atomic exclusive create (`fs.openSync(path, "wx")`) under `.atabey/locks/`.
- *
- * Flow:
- * 1. Agent A acquires lock on src/file.ts → exclusive .lock file created
- * 2. Agent B tries same path → EEXIST → WAITING / false
- * 3. Agent A releases → unlink → Agent B can proceed
- *
- * Stale lock detection: locks older than TTL (default 5 min) are reclaimed.
- */
-export declare class FileLock {
-    private static STALE_TIMEOUT_MS;
-    /** Prefer ATABEY_PROJECT_ROOT (MCP) over process.cwd(). */
-    private static projectRoot;
-    private static locksDir;
-    private static locker;
-    /**
-     * 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;
-    /**
-     * Async acquire with retry until timeout (default 10s).
-     */
-    static acquireAsync(agentName: string, filePath: string, timeoutMs?: number): Promise<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;
-    /**
-     * Run fn while holding an exclusive lock on filePath.
-     * Always releases in finally (even if fn throws) — prevents stuck .lock deadlocks.
-     */
-    static withLock<T>(agentName: string, filePath: string, fn: () => Promise<T> | T, timeoutMs?: number): Promise<T>;
-    /**
-     * Synchronous withLock — same try/finally release guarantee.
-     */
-    static withLockSync<T>(agentName: string, filePath: string, fn: () => T): T;
-    /**
-     * Lists all currently active locks under `.atabey/locks`.
-     */
-    static listLocks(): Array<{
-        agent: string;
-        file: string;
-        acquiredAt: string;
-    }>;
-}

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

@@ -1,171 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { AtomicFileLock } from "atabey-shared/file-lock.js";
-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 atomic exclusive create (`fs.openSync(path, "wx")`) under `.atabey/locks/`.
- *
- * Flow:
- * 1. Agent A acquires lock on src/file.ts → exclusive .lock file created
- * 2. Agent B tries same path → EEXIST → WAITING / false
- * 3. Agent A releases → unlink → Agent B can proceed
- *
- * Stale lock detection: locks older than TTL (default 5 min) are reclaimed.
- */
-export class FileLock {
-    static STALE_TIMEOUT_MS = 5 * 60 * 1000;
-    /** Prefer ATABEY_PROJECT_ROOT (MCP) over process.cwd(). */
-    static projectRoot() {
-        return process.env.ATABEY_PROJECT_ROOT || process.cwd();
-    }
-    static locksDir() {
-        return path.join(FileLock.projectRoot(), ".atabey", "locks");
-    }
-    static locker() {
-        const projectRoot = FileLock.projectRoot();
-        return new AtomicFileLock({
-            projectRoot,
-            locksDir: FileLock.locksDir(),
-            ttlMs: FileLock.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, filePath) {
-        const lock = FileLock.locker();
-        const result = lock.tryAcquire(filePath, agentName, "multi-agent file write");
-        if (result.acquired) {
-            logger.debug(`[FILE_LOCK] ${agentName} acquired lock on ${filePath}`);
-            return true;
-        }
-        const heldBy = result.heldBy?.ownerId ?? "unknown";
-        logger.warn(`[FILE_LOCK] CONFLICT: ${agentName} cannot write ${filePath} — locked by ${heldBy}`);
-        AtabeyStorage.saveLog({
-            agent: agentName,
-            action: "FILE_LOCK_CONFLICT",
-            trace_id: AtabeyStorage.getMetadata("traceId") || "N/A",
-            status: "BLOCKED",
-            summary: `File ${filePath} is locked by ${heldBy}. Waiting for release.`,
-        });
-        return false;
-    }
-    /**
-     * Async acquire with retry until timeout (default 10s).
-     */
-    static async acquireAsync(agentName, filePath, timeoutMs = 10_000) {
-        const lock = FileLock.locker();
-        try {
-            await lock.acquireAsync(filePath, agentName, {
-                reason: "multi-agent file write",
-                timeoutMs,
-            });
-            logger.debug(`[FILE_LOCK] ${agentName} acquired lock (async) on ${filePath}`);
-            return true;
-        }
-        catch (err) {
-            logger.warn(`[FILE_LOCK] ${agentName} timed out waiting for ${filePath}: ${err.message}`);
-            AtabeyStorage.saveLog({
-                agent: agentName,
-                action: "FILE_LOCK_TIMEOUT",
-                trace_id: AtabeyStorage.getMetadata("traceId") || "N/A",
-                status: "BLOCKED",
-                summary: err.message,
-            });
-            return false;
-        }
-    }
-    /**
-     * Releases a lock held by an agent.
-     * Only the lock-owning agent can release (others get warning).
-     */
-    static release(agentName, filePath) {
-        const lock = FileLock.locker();
-        const released = lock.release(filePath, agentName);
-        if (!released) {
-            const held = lock.isLocked(filePath);
-            if (held) {
-                logger.warn(`[FILE_LOCK] ${agentName} tried to release lock held by ${held.ownerId} on ${filePath}`);
-            }
-            return false;
-        }
-        logger.debug(`[FILE_LOCK] ${agentName} released lock on ${filePath}`);
-        return true;
-    }
-    /**
-     * Checks if a file is currently locked.
-     * Returns the locking agent name or null.
-     */
-    static isLocked(filePath) {
-        const meta = FileLock.locker().isLocked(filePath);
-        return meta?.ownerId ?? null;
-    }
-    /**
-     * Run fn while holding an exclusive lock on filePath.
-     * Always releases in finally (even if fn throws) — prevents stuck .lock deadlocks.
-     */
-    static async withLock(agentName, filePath, fn, timeoutMs = 10_000) {
-        return FileLock.locker().withLock(filePath, agentName, fn, {
-            reason: "multi-agent file write",
-            timeoutMs,
-        });
-    }
-    /**
-     * Synchronous withLock — same try/finally release guarantee.
-     */
-    static withLockSync(agentName, filePath, fn) {
-        return FileLock.locker().withLockSync(filePath, agentName, fn, {
-            reason: "multi-agent file write",
-        });
-    }
-    /**
-     * Lists all currently active locks under `.atabey/locks`.
-     */
-    static listLocks() {
-        const locksDir = FileLock.locksDir();
-        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 exp = Date.parse(data.expiresAt);
-                        if (!Number.isNaN(exp) && Date.now() > exp) {
-                            try {
-                                fs.unlinkSync(fullPath);
-                            }
-                            catch { /* ignore */ }
-                            continue;
-                        }
-                        locks.push({
-                            agent: data.ownerId,
-                            file: data.resource,
-                            acquiredAt: data.acquiredAt,
-                        });
-                    }
-                    catch {
-                        try {
-                            fs.unlinkSync(fullPath);
-                        }
-                        catch { /* ignore */ }
-                    }
-                }
-            }
-        };
-        walkDir(locksDir);
-        return locks;
-    }
-}
-//# sourceMappingURL=file-lock.js.map

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

@@ -1 +0,0 @@
-{"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/phase-engine.d.ts

@@ -1,82 +0,0 @@
-/**
- * [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;
-}