atabey 0.0.37 → 0.1.0

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

@@ -1,204 +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
- */
-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);
-        // 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

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

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

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

@@ -1,188 +0,0 @@
-/**
- * [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
- */
-import fs from "fs";
-import path from "path";
-import { logger } from "../../shared/logger.js";
-import { AtabeyStorage } from "../../shared/storage.js";
-/**
- * Policy Engine — enforces language policy, manages CLI command map,
- * provides dashboard live data, and enforces parallel execution rules.
- */
-export class PolicyEngine {
-    // ─── 5. API Versioning Strategy ──────────────────────────────────
-    /**
-     * Validates that API endpoints use versioned paths (/api/v{N}/...).
-     */
-    static validateApiVersioning(filePath, content) {
-        const violations = [];
-        const lines = content.split("\n");
-        for (let i = 0; i < lines.length; i++) {
-            const line = lines[i];
-            // Check for route definitions without version prefix
-            const routeMatch = line.match(/\.(get|post|put|delete|patch)\(['"`]\/api\/(?!v\d+\/)/i);
-            if (routeMatch) {
-                violations.push(`Line ${i + 1}: API route without version prefix: ${line.trim()}`);
-            }
-        }
-        return violations;
-    }
-    // ─── 7. Dashboard Live Data ─────────────────────────────────────
-    /**
-     * Returns dashboard live data for WebSocket broadcast.
-     */
-    static getDashboardData() {
-        return {
-            agents: AtabeyStorage.getAllAgents().map(a => ({ name: a.name, state: a.state, task: a.task })),
-            pendingApprovals: AtabeyStorage.getPendingMessages()
-                .filter(m => m.category === "ALERT" || m.category === "ACTION")
-                .map(m => ({ traceId: m.traceId, description: m.content?.substring(0, 100), status: m.status })),
-            messageQueue: {
-                pending: AtabeyStorage.getPendingMessages().length,
-                categories: AtabeyStorage.getPendingMessages().reduce((acc, m) => {
-                    acc[m.category] = (acc[m.category] || 0) + 1;
-                    return acc;
-                }, {}),
-            },
-            activeTraceId: AtabeyStorage.getMetadata("traceId") || "N/A",
-            currentPhase: AtabeyStorage.getMetadata("phase") || "PHASE_0",
-        };
-    }
-    // ─── 8. CLI Command Map Management ──────────────────────────────
-    /**
-     * Gets the CLI command map from .atabey/cli-commands.json.
-     */
-    static getCliCommands() {
-        const cmdsPath = path.join(process.cwd(), ".atabey", "cli-commands.json");
-        if (!fs.existsSync(cmdsPath))
-            return PolicyEngine.getDefaultCommands();
-        try {
-            return JSON.parse(fs.readFileSync(cmdsPath, "utf8"));
-        }
-        catch {
-            return PolicyEngine.getDefaultCommands();
-        }
-    }
-    /**
-     * Saves CLI command map.
-     */
-    static saveCliCommand(command) {
-        const cmdsDir = path.join(process.cwd(), ".atabey");
-        const cmdsPath = path.join(cmdsDir, "cli-commands.json");
-        if (!fs.existsSync(cmdsDir))
-            fs.mkdirSync(cmdsDir, { recursive: true });
-        const commands = PolicyEngine.getCliCommands();
-        const existing = commands.findIndex(c => c.command === command.command);
-        if (existing >= 0) {
-            commands[existing] = command;
-        }
-        else {
-            commands.push(command);
-        }
-        fs.writeFileSync(cmdsPath, JSON.stringify(commands, null, 2));
-    }
-    static getDefaultCommands() {
-        return [
-            { command: "atabey status", agent: "@manager", description: "Show system status" },
-            { command: "atabey approve", agent: "@human", description: "Approve a high-risk operation", outputFormat: "json" },
-            { command: "atabey trace:new", agent: "@manager", description: "Create a new trace" },
-            { command: "atabey verify-contract", agent: "@architect", description: "Verify contract integrity" },
-            { command: "atabey mcp setup", agent: "@manager", description: "Setup MCP server" },
-        ];
-    }
-    // ─── 9. Language Policy Enforcer ────────────────────────────────
-    /**
-     * Scans files for language policy violations.
-     * Rules: comments in English, variable/function names in English, UI text in English.
-     */
-    static scanLanguagePolicy(filePath, content) {
-        const violations = [];
-        const lines = content.split("\n");
-        // Detector data only: common non-English (TR) stop-words used to flag comments
-        // that violate the English-only content policy. Not user-facing copy.
-        const nonEnglishCommentPatterns = [
-            /\b(bu|şu|o|ve|veya|ile|için|göre|kadar|sonra|önce|ama|fakat|çünkü|eğer|her|bir|daha|en|çok|az|yeni|eski|büyük|küçük|iyi|kötü|doğru|yanlış)\b/i,
-            /\b(yap|et|git|gel|bak|ver|al|tut|koş|dur|otur|kalk|aç|kapa|çalış|oku|yaz|sil|ekle|güncelle|sil|temizle)\b/i,
-        ];
-        for (let i = 0; i < lines.length; i++) {
-            const line = lines[i].trim();
-            // Skip empty lines, pure code, and URLs
-            if (!line || line.startsWith("// @") || line.startsWith("import") || line.startsWith("export") || line.includes("http"))
-                continue;
-            // Flag comments that look non-English (policy: product content is English)
-            const commentMatch = line.match(/\/\/\s*(.+)/);
-            if (commentMatch) {
-                const comment = commentMatch[1];
-                if (nonEnglishCommentPatterns.some(p => p.test(comment))) {
-                    violations.push({ file: filePath, line: i + 1, type: "turkish_comment", content: comment.substring(0, 80) });
-                }
-            }
-        }
-        return violations;
-    }
-    // ─── 10. Parallel Execution Rules ───────────────────────────────
-    /**
-     * Checks implicit dependency lock — if an agent's required output
-     * is not ready, the dependent agent switches to WAITING state.
-     */
-    static checkImplicitDependency(agentName, requiredAgent) {
-        const agents = AtabeyStorage.getAllAgents();
-        const required = agents.find(a => a.name === requiredAgent);
-        if (!required || required.state !== "COMPLETED") {
-            AtabeyStorage.updateAgentStatus(agentName, "WAITING", `Waiting for ${requiredAgent} to complete`);
-            logger.info(`[PARALLEL] ${agentName} → WAITING (dependency: ${requiredAgent} not ready)`);
-            return false;
-        }
-        return true;
-    }
-    /**
-     * Enforces file ownership — an agent cannot modify files outside its scope.
-     */
-    static enforceOwnership(agentName, filePath) {
-        const ownershipMap = {
-            "@backend": ["src/modules/", "src/contracts/", "apps/backend/"],
-            "@frontend": ["apps/web/", "src/components/", "src/pages/"],
-            "@database": ["src/database/", "migrations/"],
-            "@devops": [".github/", "Dockerfile", "docker-compose", ".env"],
-            "@architect": ["src/contracts/", "src/types/", "contract.version.json"],
-        };
-        const allowedPaths = ownershipMap[agentName];
-        if (!allowedPaths)
-            return true; // No restriction for this agent
-        const relativePath = path.relative(process.cwd(), filePath);
-        const isAllowed = allowedPaths.some(p => relativePath.startsWith(p) || relativePath.includes(p));
-        if (!isAllowed) {
-            logger.warn(`[OWNERSHIP] ${agentName} cannot modify ${filePath} — outside scope`);
-            AtabeyStorage.saveLog({
-                agent: agentName.replace("@", ""),
-                action: "OWNERSHIP_VIOLATION",
-                trace_id: AtabeyStorage.getMetadata("traceId") || "N/A",
-                status: "BLOCKED",
-                summary: `${agentName} attempted to modify ${filePath} — outside allowed scope: ${allowedPaths.join(", ")}`
-            });
-            return false;
-        }
-        return true;
-    }
-    /**
-     * Logs commit-level information for traceability.
-     */
-    static logCommit(agentName, message, traceId) {
-        AtabeyStorage.saveLog({
-            agent: agentName.replace("@", ""),
-            action: "COMMIT",
-            trace_id: traceId,
-            status: "SUCCESS",
-            summary: `[${traceId}] ${message.substring(0, 200)}`
-        });
-        logger.info(`[COMMIT] ${agentName}: ${message} (trace: ${traceId})`);
-    }
-}
-//# sourceMappingURL=policy-engine.js.map

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

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

package/dist/atabey/src/modules/engines/sandbox.d.ts

@@ -1,31 +0,0 @@
-/**
- * [ENGINE] OS-Level Sandbox — thin adapter over atabey-shared/sandbox.
- *
- * Prefer importing from `atabey-shared/sandbox.js` in new code.
- * This class keeps a stable engine-facing API for callers inside packages/atabey.
- */
-import { sandboxSpawn } from "atabey-shared/sandbox.js";
-import type { SpawnOptions } from "child_process";
-export declare class Sandbox {
-    /** Resolve and cache sandbox identity (uid/gid). */
-    static resolve(): void;
-    static spawn(command: string, args: string[], options?: SpawnOptions): ReturnType<typeof sandboxSpawn>;
-    static isActive(): boolean;
-    static getInfo(): {
-        uid?: number;
-        gid?: number;
-        user?: string;
-        active: boolean;
-        reason?: string;
-    };
-    static clearCache(): void;
-    static status(): {
-        platform: string;
-        identity: import("atabey-shared").SandboxIdentity;
-        processUid: number | null;
-        processGid: number | null;
-    };
-    static applyOptions(options?: SpawnOptions & {
-        disableSandbox?: boolean;
-    }): SpawnOptions;
-}

package/dist/atabey/src/modules/engines/sandbox.js

@@ -1,57 +0,0 @@
-/**
- * [ENGINE] OS-Level Sandbox — thin adapter over atabey-shared/sandbox.
- *
- * Prefer importing from `atabey-shared/sandbox.js` in new code.
- * This class keeps a stable engine-facing API for callers inside packages/atabey.
- */
-import { applySandboxToSpawnOptions, clearSandboxIdentityCache, getSandboxStatus, resolveSandboxIdentity, sandboxSpawn, } from "atabey-shared/sandbox.js";
-import { logger } from "../../shared/logger.js";
-export class Sandbox {
-    /** Resolve and cache sandbox identity (uid/gid). */
-    static resolve() {
-        const id = resolveSandboxIdentity();
-        if (id.enabled) {
-            logger.info(`[SANDBOX] Active uid=${id.uid}${id.gid !== undefined ? ` gid=${id.gid}` : ""}${id.user ? ` user=${id.user}` : ""}`);
-        }
-        else if (id.reason) {
-            logger.debug(`[SANDBOX] Inactive: ${id.reason}`);
-        }
-    }
-    static spawn(command, args, options = {}) {
-        const id = resolveSandboxIdentity();
-        if (id.enabled) {
-            logger.info(`[SANDBOX] Active uid=${id.uid}${id.gid !== undefined ? ` gid=${id.gid}` : ""}${id.user ? ` user=${id.user}` : ""}`);
-        }
-        else if (id.reason) {
-            logger.debug(`[SANDBOX] Inactive: ${id.reason}`);
-        }
-        const child = sandboxSpawn(command, args, options);
-        if (id.enabled) {
-            logger.debug(`[SANDBOX] Spawning with uid=${id.uid}: ${command} ${args.join(" ")}`);
-        }
-        return child;
-    }
-    static isActive() {
-        return resolveSandboxIdentity().enabled;
-    }
-    static getInfo() {
-        const id = resolveSandboxIdentity();
-        return {
-            uid: id.uid,
-            gid: id.gid,
-            user: id.user,
-            active: id.enabled,
-            reason: id.reason,
-        };
-    }
-    static clearCache() {
-        clearSandboxIdentityCache();
-    }
-    static status() {
-        return getSandboxStatus();
-    }
-    static applyOptions(options = {}) {
-        return applySandboxToSpawnOptions(options);
-    }
-}
-//# sourceMappingURL=sandbox.js.map

package/dist/atabey/src/modules/engines/sandbox.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../../../../../src/modules/engines/sandbox.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACH,0BAA0B,EAC1B,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,GACf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAEhD,MAAM,OAAO,OAAO;IAChB,oDAAoD;IAC7C,MAAM,CAAC,OAAO;QACjB,MAAM,EAAE,GAAG,sBAAsB,EAAE,CAAC;QACpC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CACP,wBAAwB,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GACzE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EACnC,EAAE,CACL,CAAC;QACN,CAAC;aAAM,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QACrD,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,KAAK,CACf,OAAe,EACf,IAAc,EACd,UAAwB,EAAE;QAE1B,MAAM,EAAE,GAAG,sBAAsB,EAAE,CAAC;QACpC,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CACP,wBAAwB,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,GACzE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EACnC,EAAE,CACL,CAAC;QACN,CAAC;aAAM,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CACR,+BAA+B,EAAE,CAAC,GAAG,KAAK,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACxE,CAAC;QACN,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAEM,MAAM,CAAC,QAAQ;QAClB,OAAO,sBAAsB,EAAE,CAAC,OAAO,CAAC;IAC5C,CAAC;IAEM,MAAM,CAAC,OAAO;QAOjB,MAAM,EAAE,GAAG,sBAAsB,EAAE,CAAC;QACpC,OAAO;YACH,GAAG,EAAE,EAAE,CAAC,GAAG;YACX,GAAG,EAAE,EAAE,CAAC,GAAG;YACX,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,MAAM,EAAE,EAAE,CAAC,OAAO;YAClB,MAAM,EAAE,EAAE,CAAC,MAAM;SACpB,CAAC;IACN,CAAC;IAEM,MAAM,CAAC,UAAU;QACpB,yBAAyB,EAAE,CAAC;IAChC,CAAC;IAEM,MAAM,CAAC,MAAM;QAChB,OAAO,gBAAgB,EAAE,CAAC;IAC9B,CAAC;IAEM,MAAM,CAAC,YAAY,CAAC,UAAuD,EAAE;QAChF,OAAO,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;CACJ"}

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

@@ -1,68 +0,0 @@
-/**
- * [ENGINE] Session Engine — STEP 0 STARTUP Protocol
- *
- * Implements ATABEY_FULL.md STEP 0:
- * 1. Restore Session Memory & Load Role — read PROJECT_MEMORY.md, DECISIONS.md
- * 2. Read Platform Shim — detect Claude/Gemini/Cursor platform
- * 3. Respect Authority — report to @manager
- *
- * Integrates Token Economy Protocol and Output Flow Standards.
- */
-export interface SessionContext {
-    projectMemory: string;
-    decisions: string[];
-    activeTraceId: string;
-    currentPhase: string;
-    platform: string;
-    agentState: string;
-    tokenBudget: {
-        used: number;
-        limit: number;
-    };
-}
-export interface OutputFlow {
-    assumptions: string[];
-    problem: string;
-    fileTree: string[];
-    codeBlocks: number;
-    auditLog: string;
-    tests: string[];
-}
-/**
- * Session Engine — manages the STEP 0 startup protocol and enforces
- * token economy and output flow standards on every session.
- */
-export declare class SessionEngine {
-    /**
-     * STEP 0: STARTUP Protocol — runs at the beginning of every session.
-     * Reads PROJECT_MEMORY.md, checks active decisions, detects platform.
-     */
-    static startup(): Promise<SessionContext>;
-    /**
-     * Token Economy Protocol — enforces:
-     * - Search before read (never read_file entire directories)
-     * - Surgical operations (replace instead of write)
-     * - Output conciseness (minimum required data)
-     * - Context compaction (retrieve only relevant history)
-     */
-    static checkTokenEconomy(operationType: "read" | "write" | "replace" | "search", estimatedTokens: number): Promise<{
-        allowed: boolean;
-        warning?: string;
-    }>;
-    /**
-     * Output Flow Standard — validates that agent output follows the
-     * mandatory format: Assumptions, Problem, File Tree, Code, Tests, Audit Log.
-     */
-    static validateOutputFlow(output: string): {
-        passed: boolean;
-        missing: string[];
-    };
-    /**
-     * Checks session compliance with STEP 0 rules.
-     * Logs a warning if rules are not followed.
-     */
-    static checkSessionCompliance(): Promise<{
-        compliant: boolean;
-        warnings: string[];
-    }>;
-}