atabey 0.0.16 → 0.0.17

package/dist/atabey/src/shared/audit.d.ts

@@ -0,0 +1,105 @@
+/**
+ * [AUDIT] Structured Audit Log Service
+ *
+ * Records all critical operations in structured JSON format to SQLite.
+ * Queryable, filterable, and traceable.
+ *
+ * [KVKK/GDPR] GDPR and KVKK Art. 4, 5, 11, 12 compliant:
+ * - Sensitive data automatically masked (PII masking)
+ * - Data retention limited (TTL)
+ * - Data subject rights supported (erasure, query)
+ *
+ * Usage:
+ *   Audit.log("user.create", "SUCCESS", { userId: "usr_123" });
+ *   Audit.query({ action: "user.create", status: "FAILED" });
+ */
+export type AuditStatus = "SUCCESS" | "FAILED" | "BLOCKED" | "APPROVED" | "REJECTED";
+export type DataCategory = "OPERATIONAL" | "USER_DATA" | "API_CALL" | "SECURITY" | "COMPLIANCE";
+export interface AuditEntry {
+    id?: number;
+    timestamp: string;
+    action: string;
+    status: AuditStatus;
+    agent: string;
+    traceId?: string;
+    details?: Record<string, unknown>;
+    errorMessage?: string;
+    durationMs?: number;
+    dataCategory?: DataCategory;
+    /** [KVKK] Data retention period (days). null = unlimited (not recommended) */
+    retentionDays?: number;
+}
+export declare class Audit {
+    private static TABLE;
+    /** [KVKK] Default data retention period: 30 days */
+    private static DEFAULT_RETENTION_DAYS;
+    /** [KVKK] Maximum retention for sensitive categories: 90 days */
+    private static MAX_RETENTION_DAYS;
+    static initialize(): void;
+    /**
+     * Logs a structured audit entry.
+     * [KVKK] Sensitive data is automatically masked.
+     */
+    static log(action: string, status: AuditStatus, options?: {
+        agent?: string;
+        traceId?: string;
+        details?: Record<string, unknown>;
+        errorMessage?: string;
+        durationMs?: number;
+        dataCategory?: DataCategory;
+        /** [KVKK] Custom retention period (days). Default: 30 */
+        retentionDays?: number;
+    }): void;
+    /**
+     * Queries audit logs with filters.
+     */
+    static query(options?: {
+        action?: string;
+        status?: AuditStatus;
+        agent?: string;
+        traceId?: string;
+        dataCategory?: DataCategory;
+        limit?: number;
+        offset?: number;
+        since?: string;
+        until?: string;
+    }): AuditEntry[];
+    /**
+   * [KVKK Art. 11] Deletes records upon data subject request.
+   * Clears all records matching a given traceId or agent.
+   *
+   * @param filter Which records to delete
+   * @returns Number of deleted records
+   */
+    static deleteByFilter(filter: {
+        traceId?: string;
+        agent?: string;
+        action?: string;
+        olderThanDays?: number;
+    }): number;
+    /**
+     * [KVKK/GDPR] Cleans expired records.
+     * Operates based on each audit record's retentionDays field.
+     * Can be auto-triggered by cron job or each Audit.log() call.
+     *
+     * @returns Number of cleaned records
+     */
+    static cleanExpired(): number;
+    /**
+     * Returns audit statistics.
+     */
+    static getStats(): {
+        total: number;
+        byStatus: Record<string, number>;
+        byAction: Record<string, number>;
+        byCategory: Record<string, number>;
+        recentErrors: AuditEntry[];
+        expiredCount: number;
+    };
+    /**
+     * [KVKK Art. 7] Clears all audit records.
+     * Used under the "Right to Erasure" provision.
+     * Only authorized users may call this.
+     */
+    static clearAll(confirmationCode: string): number;
+}

package/dist/atabey/src/shared/audit.js

@@ -0,0 +1,221 @@
+/**
+ * [AUDIT] Structured Audit Log Service
+ *
+ * Records all critical operations in structured JSON format to SQLite.
+ * Queryable, filterable, and traceable.
+ *
+ * [KVKK/GDPR] GDPR and KVKK Art. 4, 5, 11, 12 compliant:
+ * - Sensitive data automatically masked (PII masking)
+ * - Data retention limited (TTL)
+ * - Data subject rights supported (erasure, query)
+ *
+ * Usage:
+ *   Audit.log("user.create", "SUCCESS", { userId: "usr_123" });
+ *   Audit.query({ action: "user.create", status: "FAILED" });
+ */
+import { maskObject, maskText } from "./pii.js";
+import { Storage } from "./storage.js";
+import { logger } from "./logger.js";
+export class Audit {
+    static TABLE = "audit_log";
+    /** [KVKK] Default data retention period: 30 days */
+    static DEFAULT_RETENTION_DAYS = parseInt(process.env.ATABEY_DATA_RETENTION_DAYS || "30", 10);
+    /** [KVKK] Maximum retention for sensitive categories: 90 days */
+    static MAX_RETENTION_DAYS = 90;
+    static initialize() {
+        const db = Storage.getDB();
+        db.exec(`
+            CREATE TABLE IF NOT EXISTS ${this.TABLE} (
+                id INTEGER PRIMARY KEY AUTOINCREMENT,
+                timestamp TEXT NOT NULL,
+                action TEXT NOT NULL,
+                status TEXT NOT NULL,
+                agent TEXT NOT NULL,
+                traceId TEXT,
+                details TEXT,
+                errorMessage TEXT,
+                durationMs INTEGER,
+                dataCategory TEXT DEFAULT 'OPERATIONAL',
+                retentionDays INTEGER DEFAULT ${this.DEFAULT_RETENTION_DAYS}
+            )
+        `);
+        // Indexes for performance
+        db.exec(`
+            CREATE INDEX IF NOT EXISTS idx_audit_action ON ${this.TABLE}(action);
+            CREATE INDEX IF NOT EXISTS idx_audit_status ON ${this.TABLE}(status);
+            CREATE INDEX IF NOT EXISTS idx_audit_trace ON ${this.TABLE}(traceId);
+            CREATE INDEX IF NOT EXISTS idx_audit_timestamp ON ${this.TABLE}(timestamp);
+            CREATE INDEX IF NOT EXISTS idx_audit_category ON ${this.TABLE}(dataCategory);
+        `);
+    }
+    /**
+     * Logs a structured audit entry.
+     * [KVKK] Sensitive data is automatically masked.
+     */
+    static log(action, status, options = {}) {
+        const db = Storage.getDB();
+        const retentionDays = Math.min(options.retentionDays || this.DEFAULT_RETENTION_DAYS, this.MAX_RETENTION_DAYS);
+        // [KVKK] PII Masking — mask sensitive data in the details field
+        const maskedDetails = options.details
+            ? maskObject(options.details)
+            : undefined;
+        const maskedError = options.errorMessage
+            ? maskText(options.errorMessage)
+            : undefined;
+        const entry = {
+            timestamp: new Date().toISOString(),
+            action,
+            status,
+            agent: options.agent || "@manager",
+            traceId: options.traceId,
+            details: maskedDetails,
+            errorMessage: maskedError,
+            durationMs: options.durationMs,
+            dataCategory: options.dataCategory || "OPERATIONAL",
+            retentionDays,
+        };
+        db.prepare(`
+            INSERT INTO ${this.TABLE}
+                (timestamp, action, status, agent, traceId, details, errorMessage, durationMs, dataCategory, retentionDays)
+            VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        `).run(entry.timestamp, entry.action, entry.status, entry.agent, entry.traceId || null, entry.details ? JSON.stringify(entry.details) : null, entry.errorMessage || null, entry.durationMs || null, entry.dataCategory, entry.retentionDays);
+    }
+    /**
+     * Queries audit logs with filters.
+     */
+    static query(options = {}) {
+        const db = Storage.getDB();
+        const conditions = [];
+        const params = [];
+        if (options.action) {
+            conditions.push("action = ?");
+            params.push(options.action);
+        }
+        if (options.status) {
+            conditions.push("status = ?");
+            params.push(options.status);
+        }
+        if (options.agent) {
+            conditions.push("agent = ?");
+            params.push(options.agent);
+        }
+        if (options.traceId) {
+            conditions.push("traceId = ?");
+            params.push(options.traceId);
+        }
+        if (options.dataCategory) {
+            conditions.push("dataCategory = ?");
+            params.push(options.dataCategory);
+        }
+        if (options.since) {
+            conditions.push("timestamp >= ?");
+            params.push(options.since);
+        }
+        if (options.until) {
+            conditions.push("timestamp <= ?");
+            params.push(options.until);
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+        const limit = options.limit || 50;
+        const offset = options.offset || 0;
+        const rows = db.prepare(`SELECT * FROM ${this.TABLE} ${where} ORDER BY timestamp DESC LIMIT ? OFFSET ?`).all(...params, limit, offset);
+        return rows.map(row => ({
+            ...row,
+            details: row.details ? JSON.parse(row.details) : undefined,
+        }));
+    }
+    /**
+   * [KVKK Art. 11] Deletes records upon data subject request.
+   * Clears all records matching a given traceId or agent.
+   *
+   * @param filter Which records to delete
+   * @returns Number of deleted records
+   */
+    static deleteByFilter(filter) {
+        const db = Storage.getDB();
+        const conditions = [];
+        const params = [];
+        if (filter.traceId) {
+            conditions.push("traceId = ?");
+            params.push(filter.traceId);
+        }
+        if (filter.agent) {
+            conditions.push("agent = ?");
+            params.push(filter.agent);
+        }
+        if (filter.action) {
+            conditions.push("action = ?");
+            params.push(filter.action);
+        }
+        if (filter.olderThanDays) {
+            conditions.push("timestamp < datetime('now', ? || ' days')");
+            params.push(`-${filter.olderThanDays}`);
+        }
+        if (conditions.length === 0)
+            return 0;
+        const result = db.prepare(`DELETE FROM ${this.TABLE} WHERE ${conditions.join(" AND ")}`).run(...params);
+        return result.changes;
+    }
+    /**
+     * [KVKK/GDPR] Cleans expired records.
+     * Operates based on each audit record's retentionDays field.
+     * Can be auto-triggered by cron job or each Audit.log() call.
+     *
+     * @returns Number of cleaned records
+     */
+    static cleanExpired() {
+        const db = Storage.getDB();
+        const result = db.prepare(`
+            DELETE FROM ${this.TABLE}
+            WHERE retentionDays IS NOT NULL
+            AND timestamp < datetime('now', '-' || retentionDays || ' days')
+        `).run();
+        if (result.changes > 0) {
+            logger.info(`[AUDIT] Expired records cleaned: ${result.changes}`);
+        }
+        return result.changes;
+    }
+    /**
+     * Returns audit statistics.
+     */
+    static getStats() {
+        const db = Storage.getDB();
+        this.cleanExpired();
+        const total = db.prepare(`SELECT COUNT(*) as count FROM ${this.TABLE}`).get().count;
+        const byStatusRows = db.prepare(`SELECT status, COUNT(*) as count FROM ${this.TABLE} GROUP BY status`).all();
+        const byActionRows = db.prepare(`SELECT action, COUNT(*) as count FROM ${this.TABLE} GROUP BY action ORDER BY count DESC LIMIT 10`).all();
+        const byCategoryRows = db.prepare(`SELECT dataCategory, COUNT(*) as count FROM ${this.TABLE} GROUP BY dataCategory`).all();
+        const errors = db.prepare(`SELECT * FROM ${this.TABLE} WHERE status IN ('FAILED', 'BLOCKED') ORDER BY timestamp DESC LIMIT 10`).all();
+        const expiredCount = db.prepare(`
+                SELECT COUNT(*) as count FROM ${this.TABLE}
+                WHERE retentionDays IS NOT NULL
+                AND timestamp < datetime('now', '-' || retentionDays || ' days')
+            `).get().count;
+        return {
+            total,
+            byStatus: Object.fromEntries(byStatusRows.map(r => [r.status, r.count])),
+            byAction: Object.fromEntries(byActionRows.map(r => [r.action, r.count])),
+            byCategory: Object.fromEntries(byCategoryRows.map(r => [r.dataCategory, r.count])),
+            recentErrors: errors.map(row => ({
+                ...row,
+                details: row.details ? JSON.parse(row.details) : undefined,
+            })),
+            expiredCount,
+        };
+    }
+    /**
+     * [KVKK Art. 7] Clears all audit records.
+     * Used under the "Right to Erasure" provision.
+     * Only authorized users may call this.
+     */
+    static clearAll(confirmationCode) {
+        if (confirmationCode !== "KVKK-RIGHT-TO-ERASURE") {
+            throw new Error("[AUDIT] Invalid confirmation code for data erasure");
+        }
+        const db = Storage.getDB();
+        const result = db.prepare(`DELETE FROM ${this.TABLE}`).run();
+        logger.info(`[AUDIT] All records cleared (${result.changes} records). KVKK Article 7 compliance.`);
+        return result.changes;
+    }
+}
+//# sourceMappingURL=audit.js.map

package/dist/atabey/src/shared/audit.js.map

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

package/dist/atabey/src/shared/constants.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Agent Atabey — Single Source of Truth for framework constants.
+ * Import from here instead of hardcoding paths, phases, or directory names.
+ */
+export declare const FRAMEWORK: {
+    NAME: string;
+    CORE_DIR: string;
+    UNIFIED_HUB_DIR: string;
+    CONSTITUTION_FILE: string;
+    DEFAULT_TRACE_ID: string;
+    DEFAULT_PHASE: string;
+    DEFAULT_MANAGER_STATE: string;
+    DASHBOARD_PORT: number;
+};
+export declare const PROJECT_PHASES: readonly ["PHASE_0", "PHASE_1", "PHASE_2", "PHASE_3", "PHASE_4"];
+export declare const ADAPTER_DIRS: {
+    readonly GEMINI: ".gemini";
+    readonly CLAUDE: ".claude";
+    readonly GROK: ".grok";
+    readonly CURSOR: ".cursor";
+    readonly CODEX: ".agents";
+    readonly ANTIGRAVITY: ".agents";
+    readonly LOCAL: ".atabey";
+    readonly LEGACY_AGENT: ".agent";
+};
+/** Priority order for framework directory resolution (CLI + MCP). */
+export declare const FRAMEWORK_DIR_CANDIDATES: readonly [string, ".agents", ".claude", ".gemini", ".grok", ".cursor", ".agents", ".atabey"];
+/** Slug under `.agents/{slug}/` for each adapter in unified mode. */
+export declare const UNIFIED_ADAPTER_SLUG: {
+    readonly gemini: "gemini";
+    readonly claude: "claude";
+    readonly grok: "grok";
+    readonly cursor: "cursor";
+    readonly codex: "codex";
+    readonly local: "local";
+    readonly "antigravity-cli": "antigravity";
+};
+export type UnifiedAdapterSlug = keyof typeof UNIFIED_ADAPTER_SLUG;
+export declare const NATIVE_AGENT_PATHS: {
+    readonly gemini: string;
+    readonly claude: string;
+    readonly grok: string;
+    readonly cursor: string;
+    readonly codex: string;
+    readonly local: string;
+    readonly "antigravity-cli": string;
+};
+/** Legacy layout bases used by `check` and discovery (non-unified installs). */
+export declare const LEGACY_AGENT_LAYOUT_BASES: readonly [string, string, string, string, string, string, string];
+export declare const FRAMEWORK_SUBDIRS: {
+    readonly AGENTS: "agents";
+    readonly SKILLS: "skills";
+    readonly KNOWLEDGE: "knowledge";
+    readonly PROMPTS: "prompts";
+    readonly MEMORY: "memory";
+    readonly ROUTER: "router";
+    readonly REGISTRY: "registry";
+    readonly OBSERVABILITY: "observability";
+    readonly RULES: "rules";
+    readonly MESSAGES: "messages";
+    readonly LOGS: "logs";
+    readonly MEMORY_GRAPH: "memory-graph";
+    readonly DASHBOARD: "dashboard";
+    readonly UI_DIST: "ui";
+};
+export declare const CORE_SCAFFOLD_SUBDIRS: readonly ["knowledge", "prompts", "memory", "router", "registry", "observability", "rules"];
+export declare const RUNTIME_SUBDIRS: readonly ["messages", "logs", "memory-graph"];
+export declare const MEMORY_SUBDIRS: {
+    readonly TASKS: "tasks";
+    readonly HISTORY: "history";
+};
+export declare const MEMORY_FILES: {
+    readonly STATE: "state.json";
+    readonly STATUS: "status.json";
+    readonly PROJECT_MEMORY: "PROJECT_MEMORY.md";
+    readonly SHARED_FACTS: "shared-facts.json";
+};
+export declare const DEFAULT_MONOREPO_PATHS: {
+    readonly backend: "apps/backend";
+    readonly frontend: "apps/web";
+    readonly mobile: "apps/mobile";
+    readonly docs: "docs";
+    readonly tests: "tests";
+};
+/** Cursor rule globs per agent role (enterprise monorepo layout). */
+export declare const CURSOR_AGENT_GLOBS: Record<string, string>;
+export declare const MCP: {
+    readonly SERVER_NAME: "atabey";
+    readonly ROOT_CONFIG_FILE: "mcp.json";
+    readonly PROJECT_ROOT_ENV: "ATABEY_PROJECT_ROOT";
+    readonly TEST_DIR_ENV: "ATABEY_TEST_DIR";
+    readonly SERVER_DIST_PATH: "atabey-mcp/dist/mcp/index.js";
+};
+export declare const ROOT_CONFIG_FILES: {
+    readonly MCP: "mcp.json";
+    readonly DOT_MCP: ".mcp.json";
+    readonly ENV_EXAMPLE: ".env.example";
+    readonly VSCODE_MCP: ".vscode/mcp.json";
+};
+export declare const TEMPLATE_PLACEHOLDERS: {
+    readonly FRAMEWORK_DIR: "{{FRAMEWORK_DIR}}";
+    readonly ADAPTER: "{{ADAPTER}}";
+    readonly BACKEND_DIR: "{{BACKEND_DIR}}";
+    readonly FRONTEND_DIR: "{{FRONTEND_DIR}}";
+    readonly DOCS_DIR: "{{DOCS_DIR}}";
+    readonly TESTS_DIR: "{{TESTS_DIR}}";
+};
+export declare const AGENT_FILE_EXT: {
+    readonly MARKDOWN: ".md";
+    readonly CURSOR_RULE: ".mdc";
+};
+export declare function pathJoin(...segments: string[]): string;
+export declare function corePath(...segments: string[]): string;
+export declare function unifiedHubPath(...segments: string[]): string;
+export declare function unifiedAdapterPath(slug: string, ...segments: string[]): string;
+export declare function knowledgePath(filename: string): string;
+/** Backward-compatible aliases */
+export declare const CORE_FRAMEWORK_DIR: string;
+export declare const UNIFIED_HUB_DIR: string;
+export declare const SKILLS_HUB_PATH: string;

package/dist/atabey/src/shared/constants.js

@@ -0,0 +1,188 @@
+/**
+ * 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",
+    DASHBOARD_PORT: parseInt(process.env.PORT || process.env.DASHBOARD_PORT || "5858"),
+};
+export const PROJECT_PHASES = [
+    "PHASE_0",
+    "PHASE_1",
+    "PHASE_2",
+    "PHASE_3",
+    "PHASE_4",
+];
+// ─── Adapter platform directories (native / legacy) ───────────────────────────
+export const ADAPTER_DIRS = {
+    GEMINI: ".gemini",
+    CLAUDE: ".claude",
+    GROK: ".grok",
+    CURSOR: ".cursor",
+    CODEX: ".agents",
+    ANTIGRAVITY: ".agents",
+    LOCAL: ".atabey",
+    LEGACY_AGENT: ".agent",
+};
+/** 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,
+];
+/** 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",
+};
+// ─── 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"),
+};
+/** 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"],
+];
+// ─── 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",
+    DASHBOARD: "dashboard",
+    UI_DIST: "ui",
+};
+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,
+];
+export const RUNTIME_SUBDIRS = [
+    FRAMEWORK_SUBDIRS.MESSAGES,
+    FRAMEWORK_SUBDIRS.LOGS,
+    FRAMEWORK_SUBDIRS.MEMORY_GRAPH,
+];
+export const MEMORY_SUBDIRS = {
+    TASKS: "tasks",
+    HISTORY: "history",
+};
+export const MEMORY_FILES = {
+    STATE: "state.json",
+    STATUS: "status.json",
+    PROJECT_MEMORY: "PROJECT_MEMORY.md",
+    SHARED_FACTS: "shared-facts.json",
+};
+// ─── Monorepo default paths ───────────────────────────────────────────────────
+export const DEFAULT_MONOREPO_PATHS = {
+    backend: "apps/backend",
+    frontend: "apps/web",
+    mobile: "apps/mobile",
+    docs: "docs",
+    tests: "tests",
+};
+/** Cursor rule globs per agent role (enterprise monorepo layout). */
+export const CURSOR_AGENT_GLOBS = {
+    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",
+    SERVER_DIST_PATH: "atabey-mcp/dist/mcp/index.js",
+};
+export const ROOT_CONFIG_FILES = {
+    MCP: MCP.ROOT_CONFIG_FILE,
+    DOT_MCP: ".mcp.json",
+    ENV_EXAMPLE: ".env.example",
+    VSCODE_MCP: ".vscode/mcp.json",
+};
+// ─── 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}}",
+};
+// ─── File extensions ─────────────────────────────────────────────────────────
+export const AGENT_FILE_EXT = {
+    MARKDOWN: ".md",
+    CURSOR_RULE: ".mdc",
+};
+// ─── Path helpers ─────────────────────────────────────────────────────────────
+export function pathJoin(...segments) {
+    return segments.filter(Boolean).join("/");
+}
+export function corePath(...segments) {
+    return [FRAMEWORK.CORE_DIR, ...segments.filter(Boolean)].join("/");
+}
+export function unifiedHubPath(...segments) {
+    return [FRAMEWORK.UNIFIED_HUB_DIR, ...segments.filter(Boolean)].join("/");
+}
+export function unifiedAdapterPath(slug, ...segments) {
+    return unifiedHubPath(slug, ...segments);
+}
+export function knowledgePath(filename) {
+    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);
+//# sourceMappingURL=constants.js.map

package/dist/atabey/src/shared/constants.js.map

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

package/dist/atabey/src/shared/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACtB,IAAI,CAAS;IACb,SAAS,CAAO;IAChB,OAAO,CAAW;IAClB,QAAQ,CAAU;IAElC,YAAY,OAAe,EAAE,IAAI,GAAG,uBAAuB,EAAE,OAAiB,EAAE,QAAiB;QAC7F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,wDAAwD;QACxD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IAED;;OAEG;IACI,MAAM;QACT,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK;SACpB,CAAC;IACN,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACnD,YAAY,OAAe,EAAE,OAAiB,EAAE,QAAiB;QAC7D,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,eAAe;IAChD,YAAY,OAAe,EAAE,OAAiB,EAAE,QAAiB;QAC7D,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,eAAe;IAC7C,YAAY,OAAe,EAAE,SAAiB,EAAE,OAAiB,EAAE,QAAiB;QAChF,KAAK,CAAC,YAAY,SAAS,cAAc,OAAO,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC5F,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACnD,YAAY,OAAe,EAAE,OAAiB,EAAE,QAAiB;QAC7D,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;CACJ"}

package/dist/atabey/src/shared/fs.d.ts

@@ -0,0 +1,9 @@
+export declare function ensureDir(dirPath: string, dryRun?: boolean): void;
+/**
+ * Writes content to a file atomically by using a temporary file.
+ * This prevents data corruption during unexpected system failures.
+ */
+export declare function writeTextFile(filePath: string, content: string, dryRun?: boolean): void;
+export declare function appendFile(filePath: string, content: string, dryRun?: boolean): void;
+export declare function writeJsonFile(filePath: string, value: unknown, dryRun?: boolean): void;
+export declare function runCommandQuiet(command: string, args: string[], cwd: string): void;