atabey 0.0.5 → 0.0.7

package/src/shared/constants.ts

@@ -1,218 +0,0 @@
-/**
- * Agent Atabey — Single Source of Truth for framework constants.
- * Import from here instead of hardcoding paths, phases, or directory names.
- */
-
-// ─── Framework identity ───────────────────────────────────────────────────────
-
-export const FRAMEWORK = {
-    NAME: "Agent Atabey",
-    CORE_DIR: ".atabey",
-    UNIFIED_HUB_DIR: ".agents",
-    CONSTITUTION_FILE: "ATABEY.md",
-    DEFAULT_TRACE_ID: "T-000",
-    DEFAULT_PHASE: "PHASE_0",
-    DEFAULT_MANAGER_STATE: "ACTIVE",
-} as const;
-
-export const PROJECT_PHASES = [
-    "PHASE_0",
-    "PHASE_1",
-    "PHASE_2",
-    "PHASE_3",
-    "PHASE_4",
-] as const;
-
-// ─── Adapter platform directories (native / legacy) ───────────────────────────
-
-export const ADAPTER_DIRS = {
-    GEMINI: ".gemini",
-    CLAUDE: ".claude",
-    GROK: ".grok",
-    CURSOR: ".cursor",
-    CODEX: ".agents",
-    ANTIGRAVITY: ".antigravity",
-    LOCAL: ".atabey",
-    LEGACY_AGENT: ".agent",
-} as const;
-
-/** Priority order for framework directory resolution (CLI + MCP). */
-export const FRAMEWORK_DIR_CANDIDATES = [
-    FRAMEWORK.CORE_DIR,
-    ADAPTER_DIRS.CODEX,
-    ADAPTER_DIRS.CLAUDE,
-    ADAPTER_DIRS.GEMINI,
-    ADAPTER_DIRS.GROK,
-    ADAPTER_DIRS.CURSOR,
-    ADAPTER_DIRS.ANTIGRAVITY,
-    ADAPTER_DIRS.LOCAL,
-] as const;
-
-/** Slug under `.agents/{slug}/` for each adapter in unified mode. */
-export const UNIFIED_ADAPTER_SLUG = {
-    gemini: "gemini",
-    claude: "claude",
-    grok: "grok",
-    cursor: "cursor",
-    codex: "codex",
-    local: "local",
-    "antigravity-cli": "antigravity",
-} as const;
-
-export type UnifiedAdapterSlug = keyof typeof UNIFIED_ADAPTER_SLUG;
-
-// ─── Native agent instruction paths (legacy tool compatibility) ───────────────
-
-export const NATIVE_AGENT_PATHS = {
-    gemini: pathJoin(ADAPTER_DIRS.GEMINI, "agents"),
-    claude: pathJoin(ADAPTER_DIRS.CLAUDE, "agents"),
-    grok: pathJoin(ADAPTER_DIRS.GROK, "agents"),
-    cursor: pathJoin(ADAPTER_DIRS.CURSOR, "rules"),
-    codex: pathJoin(ADAPTER_DIRS.CODEX, "instructions"),
-    local: pathJoin(ADAPTER_DIRS.LOCAL, "agents"),
-    "antigravity-cli": pathJoin(ADAPTER_DIRS.ANTIGRAVITY, "agents"),
-} as const;
-
-/** Legacy layout bases used by `check` and discovery (non-unified installs). */
-export const LEGACY_AGENT_LAYOUT_BASES = [
-    NATIVE_AGENT_PATHS.gemini,
-    NATIVE_AGENT_PATHS.claude,
-    NATIVE_AGENT_PATHS.cursor,
-    NATIVE_AGENT_PATHS.grok,
-    NATIVE_AGENT_PATHS.codex,
-    NATIVE_AGENT_PATHS.local,
-    NATIVE_AGENT_PATHS["antigravity-cli"],
-] as const;
-
-// ─── Framework internal subdirectories (under `.atabey/`) ──────────────────
-
-export const FRAMEWORK_SUBDIRS = {
-    AGENTS: "agents",
-    SKILLS: "skills",
-    KNOWLEDGE: "knowledge",
-    PROMPTS: "prompts",
-    MEMORY: "memory",
-    ROUTER: "router",
-    REGISTRY: "registry",
-    OBSERVABILITY: "observability",
-    RULES: "rules",
-    MESSAGES: "messages",
-    LOGS: "logs",
-    MEMORY_GRAPH: "memory-graph",
-} as const;
-
-export const CORE_SCAFFOLD_SUBDIRS = [
-    FRAMEWORK_SUBDIRS.KNOWLEDGE,
-    FRAMEWORK_SUBDIRS.PROMPTS,
-    FRAMEWORK_SUBDIRS.MEMORY,
-    FRAMEWORK_SUBDIRS.ROUTER,
-    FRAMEWORK_SUBDIRS.REGISTRY,
-    FRAMEWORK_SUBDIRS.OBSERVABILITY,
-    FRAMEWORK_SUBDIRS.RULES,
-] as const;
-
-export const RUNTIME_SUBDIRS = [
-    FRAMEWORK_SUBDIRS.MESSAGES,
-    FRAMEWORK_SUBDIRS.LOGS,
-    FRAMEWORK_SUBDIRS.MEMORY_GRAPH,
-] as const;
-
-export const MEMORY_SUBDIRS = {
-    TASKS: "tasks",
-    HISTORY: "history",
-} as const;
-
-export const MEMORY_FILES = {
-    STATE: "state.json",
-    STATUS: "status.json",
-    PROJECT_MEMORY: "PROJECT_MEMORY.md",
-    SHARED_FACTS: "shared-facts.json",
-} as const;
-
-// ─── Monorepo default paths ───────────────────────────────────────────────────
-
-export const DEFAULT_MONOREPO_PATHS = {
-    backend: "apps/backend",
-    frontend: "apps/web",
-    mobile: "apps/mobile",
-    docs: "docs",
-    tests: "tests",
-} as const;
-
-/** Cursor rule globs per agent role (enterprise monorepo layout). */
-export const CURSOR_AGENT_GLOBS: Record<string, string> = {
-    manager:   "**/*",
-    security:  "**/*",
-    architect: "**/*",
-    backend:   `${DEFAULT_MONOREPO_PATHS.backend}/**/*`,
-    frontend:  `${DEFAULT_MONOREPO_PATHS.frontend}/**/*`,
-    mobile:    `${DEFAULT_MONOREPO_PATHS.mobile}/**/*`,
-    native:    "apps/native/**/*",
-    database:  `${DEFAULT_MONOREPO_PATHS.backend}/src/database/**/*`,
-    devops:    "{.github,docker,infra,scripts,*.yml,*.yaml,Dockerfile*}",
-    quality:   "**/*",
-    analyst:   "{docs,specs,contracts}/**/*",
-    explorer:  "**/*",
-    git:       "**/*",
-};
-
-// ─── MCP & environment ──────────────────────────────────────────────────────
-
-export const MCP = {
-    SERVER_NAME: "atabey",
-    ROOT_CONFIG_FILE: "mcp.json",
-    PROJECT_ROOT_ENV: "ATABEY_PROJECT_ROOT",
-    TEST_DIR_ENV: "ATABEY_TEST_DIR",
-} as const;
-
-export const ROOT_CONFIG_FILES = {
-    MCP: MCP.ROOT_CONFIG_FILE,
-    DOT_MCP: ".mcp.json",
-    ENV_EXAMPLE: ".env.example",
-    VSCODE_MCP: ".vscode/mcp.json",
-} as const;
-
-// ─── Shim template placeholders ───────────────────────────────────────────────
-
-export const TEMPLATE_PLACEHOLDERS = {
-    FRAMEWORK_DIR: "{{FRAMEWORK_DIR}}",
-    ADAPTER: "{{ADAPTER}}",
-    BACKEND_DIR: "{{BACKEND_DIR}}",
-    FRONTEND_DIR: "{{FRONTEND_DIR}}",
-    DOCS_DIR: "{{DOCS_DIR}}",
-    TESTS_DIR: "{{TESTS_DIR}}",
-} as const;
-
-// ─── File extensions ─────────────────────────────────────────────────────────
-
-export const AGENT_FILE_EXT = {
-    MARKDOWN: ".md",
-    CURSOR_RULE: ".mdc",
-} as const;
-
-// ─── Path helpers ─────────────────────────────────────────────────────────────
-
-export function pathJoin(...segments: string[]): string {
-    return segments.filter(Boolean).join("/");
-}
-
-export function corePath(...segments: string[]): string {
-    return pathJoin(FRAMEWORK.CORE_DIR, ...segments);
-}
-
-export function unifiedHubPath(...segments: string[]): string {
-    return pathJoin(FRAMEWORK.UNIFIED_HUB_DIR, ...segments);
-}
-
-export function unifiedAdapterPath(slug: string, ...segments: string[]): string {
-    return unifiedHubPath(slug, ...segments);
-}
-
-export function knowledgePath(filename: string): string {
-    return corePath(FRAMEWORK_SUBDIRS.KNOWLEDGE, filename);
-}
-
-/** Backward-compatible aliases */
-export const CORE_FRAMEWORK_DIR = FRAMEWORK.CORE_DIR;
-export const UNIFIED_HUB_DIR = FRAMEWORK.UNIFIED_HUB_DIR;
-export const SKILLS_HUB_PATH = pathJoin(UNIFIED_HUB_DIR, FRAMEWORK_SUBDIRS.SKILLS);

package/src/shared/errors.ts

@@ -1,75 +0,0 @@
-/**
- * Enterprise Base Error class for the Agent Atabey Framework.
- */
-export class AtabeyBaseError extends Error {
-    public readonly code: string;
-    public readonly timestamp: Date;
-    public readonly details?: unknown;
-    public readonly solution?: string;
-
-    constructor(message: string, code = "ATABEY_INTERNAL_ERROR", details?: unknown, solution?: string) {
-        super(message);
-        this.name = this.constructor.name;
-        this.code = code;
-        this.timestamp = new Date();
-        this.details = details;
-        this.solution = solution;
-        
-        // Ensure proper prototype chain and capture stack trace
-        Object.setPrototypeOf(this, new.target.prototype);
-        if (Error.captureStackTrace) {
-            Error.captureStackTrace(this, this.constructor);
-        }
-    }
-
-    /**
-     * Converts the error into a structured JSON log format.
-     */
-    public toJSON() {
-        return {
-            name: this.name,
-            message: this.message,
-            code: this.code,
-            timestamp: this.timestamp.toISOString(),
-            details: this.details,
-            solution: this.solution,
-            stack: this.stack,
-        };
-    }
-}
-
-/**
- * Thrown when configuration loading or validation fails.
- */
-export class ConfigurationError extends AtabeyBaseError {
-    constructor(message: string, details?: unknown, solution?: string) {
-        super(message, "CONFIGURATION_ERROR", details, solution);
-    }
-}
-
-/**
- * Thrown when data schema or payload validation fails.
- */
-export class ValidationError extends AtabeyBaseError {
-    constructor(message: string, details?: unknown, solution?: string) {
-        super(message, "VALIDATION_ERROR", details, solution);
-    }
-}
-
-/**
- * Thrown when adapter initialization or execution fails.
- */
-export class AdapterError extends AtabeyBaseError {
-    constructor(message: string, adapterId: string, details?: unknown, solution?: string) {
-        super(`Adapter '${adapterId}' failure: ${message}`, "ADAPTER_ERROR", details, solution);
-    }
-}
-
-/**
- * Thrown when orchestration or agent communication fails.
- */
-export class OrchestrationError extends AtabeyBaseError {
-    constructor(message: string, details?: unknown, solution?: string) {
-        super(message, "ORCHESTRATION_ERROR", details, solution);
-    }
-}

package/src/shared/fs.ts

@@ -1,50 +0,0 @@
-import fs from "fs";
-import path from "path";
-import { logger } from "./logger.js";
-
-export function ensureDir(dirPath: string, dryRun = false): void {
-    if (!fs.existsSync(dirPath)) {
-        if (dryRun) {
-            logger.info(`[DRY RUN] Would create directory: ${dirPath}`);
-        } else {
-            fs.mkdirSync(dirPath, { recursive: true });
-        }
-    }
-}
-
-/**
- * Writes content to a file atomically by using a temporary file.
- * This prevents data corruption during unexpected system failures.
- */
-export function writeTextFile(filePath: string, content: string, dryRun = false): void {
-    if (dryRun) {
-        logger.info(`[DRY RUN] Would write file: ${filePath}`);
-        return;
-    }
-    const dir = path.dirname(filePath);
-    ensureDir(dir);
-
-    const tempPath = `${filePath}.${Math.random().toString(36).slice(2, 9)}.tmp`;
-    const finalContent = content.endsWith("\n") ? content : `${content}\n`;
-
-    try {
-        fs.writeFileSync(tempPath, finalContent, "utf8");
-        fs.renameSync(tempPath, filePath);
-    } catch (err) {
-        if (fs.existsSync(tempPath)) fs.unlinkSync(tempPath);
-        throw err;
-    }
-}
-
-export function appendFile(filePath: string, content: string, dryRun = false): void {
-    if (dryRun) {
-        logger.info(`[DRY RUN] Would append to file: ${filePath}`);
-        return;
-    }
-    ensureDir(path.dirname(filePath));
-    fs.appendFileSync(filePath, content, "utf8");
-}
-
-export function writeJsonFile(filePath: string, value: unknown, dryRun = false): void {
-    writeTextFile(filePath, JSON.stringify(value, null, 2), dryRun);
-}

package/src/shared/logger.ts

@@ -1,139 +0,0 @@
-import chalk from "chalk";
-import path from "path";
-import { ensureDir, appendFile } from "./fs.js";
-
-export enum LogLevel {
-    DEBUG = 0,
-    INFO = 1,
-    WARN = 2,
-    ERROR = 3,
-    FATAL = 4,
-}
-
-export interface LoggerConfig {
-    minLevel: LogLevel;
-    enableColors: boolean;
-    jsonFormat: boolean;
-    logFile?: string;
-}
-
-export class EnterpriseLogger {
-    private config: LoggerConfig;
-    private static instance: EnterpriseLogger;
-
-    private constructor() {
-        const isProd = process.env.NODE_ENV === "production";
-        this.config = {
-            minLevel: isProd ? LogLevel.INFO : LogLevel.DEBUG,
-            enableColors: !isProd,
-            jsonFormat: isProd,
-        };
-    }
-
-    public static getInstance(): EnterpriseLogger {
-        if (!EnterpriseLogger.instance) {
-            EnterpriseLogger.instance = new EnterpriseLogger();
-        }
-        return EnterpriseLogger.instance;
-    }
-
-    public configure(config: Partial<LoggerConfig>): void {
-        this.config = { ...this.config, ...config };
-        
-        if (this.config.logFile) {
-            try {
-                ensureDir(path.dirname(this.config.logFile));
-            } catch (err) {
-                // Directly write to stderr — using console here would be circular
-                process.stderr.write(`[Logger] Failed to create log directory: ${err}\n`);
-            }
-        }
-    }
-
-    private formatMessage(level: LogLevel, message: string, meta?: unknown): string {
-        const timestamp = new Date().toISOString();
-        const pid = process.pid;
-
-        if (this.config.jsonFormat) {
-            return JSON.stringify({
-                timestamp,
-                level: LogLevel[level],
-                pid,
-                message,
-                meta,
-            });
-        }
-
-        const levelName = LogLevel[level].padEnd(5);
-        let coloredLevel = levelName;
-
-        if (this.config.enableColors) {
-            switch (level) {
-                case LogLevel.DEBUG:
-                    coloredLevel = chalk.blue(levelName);
-                    break;
-                case LogLevel.INFO:
-                    coloredLevel = chalk.green(levelName);
-                    break;
-                case LogLevel.WARN:
-                    coloredLevel = chalk.yellow(levelName);
-                    break;
-                case LogLevel.ERROR:
-                    coloredLevel = chalk.red(levelName);
-                    break;
-                case LogLevel.FATAL:
-                    coloredLevel = chalk.bgRed.white.bold(levelName);
-                    break;
-            }
-        }
-
-        const metaStr = meta ? ` | Meta: ${JSON.stringify(meta)}` : "";
-        return `[${timestamp}] [PID:${pid}] [${coloredLevel}]: ${message}${metaStr}`;
-    }
-
-    private log(level: LogLevel, message: string, meta?: unknown): void {
-        if (level < this.config.minLevel) return;
-
-        const formatted = this.formatMessage(level, message, meta);
-
-        // Route to stderr for ERROR/FATAL, stdout otherwise.
-        // Using process.write directly here is intentional — this IS the logger.
-        if (level >= LogLevel.ERROR) {
-            process.stderr.write(formatted + "\n");
-        } else {
-            process.stdout.write(formatted + "\n");
-        }
-
-        // Output to file if configured
-        if (this.config.logFile) {
-            try {
-                appendFile(this.config.logFile, formatted + "\n");
-            } catch (err) {
-                // Directly write to stderr — using console here would be circular
-                process.stderr.write(`[Logger] Failed to write to log file: ${err}\n`);
-            }
-        }
-    }
-
-    public debug(message: string, meta?: unknown): void {
-        this.log(LogLevel.DEBUG, message, meta);
-    }
-
-    public info(message: string, meta?: unknown): void {
-        this.log(LogLevel.INFO, message, meta);
-    }
-
-    public warn(message: string, meta?: unknown): void {
-        this.log(LogLevel.WARN, message, meta);
-    }
-
-    public error(message: string, meta?: unknown): void {
-        this.log(LogLevel.ERROR, message, meta);
-    }
-
-    public fatal(message: string, meta?: unknown): void {
-        this.log(LogLevel.FATAL, message, meta);
-    }
-}
-
-export const logger = EnterpriseLogger.getInstance();

package/src/shared/types.ts

@@ -1,20 +0,0 @@
-/**
- * Agent Atabey Framework — Internal Branded Types
- * Used to enforce absolute type safety within the core orchestration logic.
- */
-
-export type Brand<K, T> = K & { __brand: T };
-
-export type TraceID = Brand<string, "TraceID">;
-export type AgentID = Brand<string, "AgentID">;
-export type PhaseID = Brand<string, "PhaseID">;
-export type ProjectPath = Brand<string, "ProjectPath">;
-
-/**
- * Casts a raw string to a Branded Type.
- * Use this only at the boundaries of the system.
- */
-export function asTraceID(val: string): TraceID { return val as TraceID; }
-export function asAgentID(val: string): AgentID { return val as AgentID; }
-export function asPhaseID(val: string): PhaseID { return val as PhaseID; }
-export function asProjectPath(val: string): ProjectPath { return val as ProjectPath; }