atabey 0.0.13 → 0.0.15

package/framework-mcp/dist/src/shared/retention.js

@@ -0,0 +1,170 @@
+/**
+ * [KVKK/GDPR] Data Retention & Privacy Service
+ *
+ * KVKK Art. 4, 5, 7, 11 and GDPR Art. 5, 17 compliant data retention management.
+ *
+ * Features:
+ * - Automatic expired record cleanup
+ * - Data categorization (operational, user_data, api_call, security, compliance)
+ * - "Right to Erasure" support
+ * - Configurable retention policies
+ * - Periodic cleanup cron job
+ */
+import { Audit } from "./audit.js";
+import { logger } from "./logger.js";
+import { Storage } from "./storage.js";
+/**
+ * Data retention categories and default durations (days)
+ */
+export const RETENTION_POLICIES = {
+    OPERATIONAL: 30, // Operational logs: 30 days
+    USER_DATA: 90, // User data: 90 days (KVKK Art. 5)
+    API_CALL: 180, // API call records: 180 days
+    SECURITY: 365, // Security logs: 1 year
+    COMPLIANCE: 730, // Compliance records: 2 years
+};
+/**
+ * [KVKK/GDPR] Data Retention Manager
+ */
+export class DataRetention {
+    static cleanupInterval = null;
+    /**
+   * Initialize data retention with automatic cleanup.
+   * Starts a periodic cleanup job.
+   *
+   * @param intervalMs Cleanup interval in milliseconds (default: 1 hour)
+   */
+    static initialize(intervalMs = 3600000) {
+        // Run initial cleanup
+        this.runCleanup();
+        // Schedule periodic cleanup
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+        }
+        this.cleanupInterval = setInterval(() => this.runCleanup(), intervalMs);
+        logger.info("[RETENTION] Data retention initialized. " +
+            `Cleanup interval: ${intervalMs / 60000}min. ` +
+            `Policies: ${Object.entries(RETENTION_POLICIES).map(([k, v]) => `${k}=${v}d`).join(", ")}`);
+    }
+    /**
+   * Run cleanup for all data stores.
+   * Cleans audit logs, messages, and logs based on retention policies.
+   */
+    static runCleanup() {
+        const result = { audit: 0, messages: 0, logs: 0 };
+        try {
+            // 1. Clean audit logs
+            result.audit = Audit.cleanExpired();
+            // 2. Clean old messages (Hermes message queue)
+            result.messages = this.cleanOldMessages();
+            // 3. Clean old logs
+            result.logs = this.cleanOldLogs();
+            if (result.audit > 0 || result.messages > 0 || result.logs > 0) {
+                logger.info("[RETENTION] Cleanup complete: " +
+                    `${result.audit} audit, ${result.messages} messages, ${result.logs} logs`);
+            }
+        }
+        catch (error) {
+            logger.error(`[RETENTION] Cleanup failed: ${error.message}`);
+        }
+        return result;
+    }
+    /**
+   * [KVKK Art. 7] "Right to Erasure" — Deletes all data for a given trace ID.
+   * Cleans audit records, messages, logs, and tasks.
+   *
+   * @param traceId Trace ID to erase
+   * @returns Total number of deleted records
+   */
+    static eraseTraceData(traceId) {
+        let total = 0;
+        // Audit logs
+        total += Audit.deleteByFilter({ traceId });
+        // Messages
+        const db = Storage.getDB();
+        const msgResult = db.prepare("DELETE FROM messages WHERE trace_id = ?").run(traceId);
+        total += msgResult.changes;
+        // Tasks
+        const taskResult = db.prepare("DELETE FROM tasks WHERE trace_id = ?").run(traceId);
+        total += taskResult.changes;
+        // Logs
+        const logResult = db.prepare("DELETE FROM logs WHERE trace_id = ?").run(traceId);
+        total += logResult.changes;
+        logger.info(`[RETENTION] Trace ${traceId} erased: ${total} records deleted (KVKK Article 7)`);
+        return total;
+    }
+    /**
+   * [KVKK Art. 11] Erases all data.
+   * Only works with the confirmation code.
+   */
+    static eraseAllData(confirmationCode) {
+        if (confirmationCode !== "KVKK-RIGHT-TO-ERASURE") {
+            throw new Error("[RETENTION] Invalid confirmation code. Use 'KVKK-RIGHT-TO-ERASURE'");
+        }
+        let total = 0;
+        const db = Storage.getDB();
+        total += Audit.clearAll(confirmationCode);
+        total += db.prepare("DELETE FROM messages").run().changes;
+        total += db.prepare("DELETE FROM tasks").run().changes;
+        total += db.prepare("DELETE FROM logs").run().changes;
+        total += db.prepare("DELETE FROM agents").run().changes;
+        total += db.prepare("DELETE FROM metadata").run().changes;
+        logger.warn(`[RETENTION] ALL DATA ERASED: ${total} records (KVKK Article 7 - Right to Erasure)`);
+        return total;
+    }
+    /**
+   * Get retention statistics.
+   */
+    static getStats() {
+        const db = Storage.getDB();
+        const auditExpired = db.prepare(`
+        SELECT COUNT(*) as count FROM audit_log
+        WHERE retentionDays IS NOT NULL
+        AND timestamp < datetime('now', '-' || retentionDays || ' days')
+      `).get().count;
+        const messageCount = db.prepare("SELECT COUNT(*) as count FROM messages").get().count;
+        const logCount = db.prepare("SELECT COUNT(*) as count FROM logs").get().count;
+        const taskCount = db.prepare("SELECT COUNT(*) as count FROM tasks").get().count;
+        return {
+            auditExpired,
+            messageCount,
+            logCount,
+            taskCount,
+            policies: { ...RETENTION_POLICIES },
+        };
+    }
+    /**
+   * Stop the periodic cleanup job.
+   */
+    static shutdown() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+            logger.info("[RETENTION] Cleanup job stopped");
+        }
+    }
+    /**
+   * Clean old messages from the Hermes queue.
+   * Messages older than 30 days are removed.
+   */
+    static cleanOldMessages() {
+        const db = Storage.getDB();
+        const result = db.prepare(`
+      DELETE FROM messages
+      WHERE timestamp < datetime('now', '-30 days')
+    `).run();
+        return result.changes;
+    }
+    /**
+   * Clean old logs.
+   * Logs older than 30 days are removed.
+   */
+    static cleanOldLogs() {
+        const db = Storage.getDB();
+        const result = db.prepare(`
+      DELETE FROM logs
+      WHERE timestamp < datetime('now', '-30 days')
+    `).run();
+        return result.changes;
+    }
+}

package/framework-mcp/dist/src/shared/storage.js

@@ -3,6 +3,7 @@ import fs from "fs";
 import path from "path";
 import { getFrameworkDir } from "../cli/utils/memory.js";
 import { logger } from "./logger.js";
+import { maskText } from "./pii.js";
 import { asAgentID, asLogID, asMessageID, asTaskID } from "./types.js";
 /**
  * [DB] Atabey Storage Engine
@@ -17,7 +18,8 @@ export class AtabeyStorage {
                 fs.mkdirSync(frameworkDir, { recursive: true });
             }
             const dbPath = path.join(frameworkDir, "atabey.db");
-            this.db = new Database(dbPath);
+            this.db = new Database(dbPath, { timeout: 5000 });
+            this.db.pragma("journal_mode = WAL");
             this.initializeSchema();
         }
         return this.db;
@@ -82,12 +84,47 @@ export class AtabeyStorage {
                 value TEXT
             )
         `);
+        // Costs Table
+        db.exec(`
+            CREATE TABLE IF NOT EXISTS costs (
+                id INTEGER PRIMARY KEY AUTOINCREMENT,
+                provider TEXT,
+                model TEXT,
+                input_tokens INTEGER,
+                output_tokens INTEGER,
+                cost REAL,
+                timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
+                trace_id TEXT
+            )
+        `);
+    }
+    // --- Cost Operations ---
+    static saveCost(cost) {
+        const db = this.getDB();
+        db.prepare(`
+            INSERT INTO costs (provider, model, input_tokens, output_tokens, cost, timestamp, trace_id)
+            VALUES (?, ?, ?, ?, ?, ?, ?)
+        `).run(cost.provider, cost.model, cost.inputTokens, cost.outputTokens, cost.cost, cost.timestamp, cost.traceId || null);
+    }
+    static getAllCosts() {
+        const rows = this.getDB().prepare("SELECT * FROM costs ORDER BY timestamp ASC").all();
+        return rows.map(r => ({
+            provider: r.provider,
+            model: r.model,
+            inputTokens: r.input_tokens,
+            outputTokens: r.output_tokens,
+            cost: r.cost,
+            timestamp: r.timestamp,
+            traceId: r.trace_id || undefined
+        }));
     }
     // --- Agent Operations ---
     static updateAgentStatus(name, state, task, lastUpdated) {
         const db = this.getDB();
         const cleanName = name.replace("@", "");
         const timestamp = lastUpdated || new Date().toISOString();
+        // [KVKK/GDPR] Mask PII in task description before storing
+        const maskedTask = maskText(task);
         db.prepare(`
             INSERT INTO agents (name, state, task, last_updated)
             VALUES (?, ?, ?, ?)
@@ -95,7 +132,7 @@ export class AtabeyStorage {
                 state = excluded.state,
                 task = excluded.task,
                 last_updated = excluded.last_updated
-        `).run(cleanName, state, task, timestamp);
+        `).run(cleanName, state, maskedTask, timestamp);
     }
     static getAllAgents() {
         return this.getDB().prepare("SELECT * FROM agents").all();
@@ -103,10 +140,12 @@ export class AtabeyStorage {
     // --- Message Operations ---
     static saveMessage(msg) {
         const db = this.getDB();
+        // [KVKK/GDPR] Mask PII in message content before storing
+        const maskedContent = maskText(msg.content);
         db.prepare(`
             INSERT INTO messages (sender, receiver, category, content, trace_id, parent_id, status, priority, requires_approval)
             VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-        `).run(msg.from, msg.to, msg.category, msg.content, msg.traceId, msg.parentId || null, msg.status || "PENDING", msg.priority || "NORMAL", msg.requiresApproval ? 1 : 0);
+        `).run(msg.from, msg.to, msg.category, maskedContent, msg.traceId, msg.parentId || null, msg.status || "PENDING", msg.priority || "NORMAL", msg.requiresApproval ? 1 : 0);
     }
     static getPendingMessages() {
         const rows = this.getDB().prepare("SELECT * FROM messages WHERE status IN ('PENDING', 'APPROVED') ORDER BY priority DESC, timestamp ASC").all();
@@ -151,7 +190,6 @@ export class AtabeyStorage {
             let deps = [];
             try {
                 const parsed = JSON.parse(r.dependencies || "[]");
-                // Handle cases where dependencies might be double-stringified or are raw JSON strings
                 deps = Array.isArray(parsed) ? parsed : JSON.parse(parsed);
             }
             catch (err) {
@@ -164,7 +202,8 @@ export class AtabeyStorage {
                 agent: asAgentID(r.agent),
                 status: r.status,
                 priority: r.priority,
-                dependencies: deps
+                dependencies: deps,
+                createdAt: r.created_at
             };
         });
     }
@@ -185,8 +224,9 @@ export class AtabeyStorage {
             action: r.action,
             trace_id: r.trace_id || undefined,
             status: r.status,
-            summary: r.summary,
-            findings: r.findings || undefined
+            // [KVKK/GDPR] Mask PII in log summaries before returning
+            summary: maskText(r.summary),
+            findings: r.findings ? maskText(r.findings) : undefined
         }));
     }
     // --- Metadata Operations ---

package/framework-mcp/dist/src/shared/string.js

@@ -0,0 +1,29 @@
+export function stripMarkdownCodeBlocks(text) {
+    // Regex to find markdown code blocks (```lang ... ```) and extract their content.
+    // Handles cases where LLMs might wrap JSON in such blocks.
+    const markdownCodeBlockRegex = /```(?:\w+)?\s*([\s\S]*?)\s*```/g;
+    // Attempt to extract content from a single markdown code block.
+    const cleanedText = text.replace(markdownCodeBlockRegex, "$1").trim();
+    // If after stripping, it looks like JSON, return it.
+    if ((cleanedText.startsWith("{") && cleanedText.endsWith("}")) || (cleanedText.startsWith("[") && cleanedText.endsWith("]"))) {
+        return cleanedText;
+    }
+    // Fallback: If the original text itself was valid JSON (without being in a code block)
+    // or if the stripping made it valid, this check helps.
+    try {
+        JSON.parse(text.trim());
+        return text.trim(); // Original text was valid JSON
+    }
+    catch {
+        // Continue if original text wasn't valid JSON
+    }
+    // Try a more specific JSON code block extraction if the generic one didn't yield valid JSON
+    const specificJsonCodeBlockRegex = /```json\s*(\{[\s\S]*?\}|\[[\s\S]*?\])\s*```/g;
+    const specificMatch = text.match(specificJsonCodeBlockRegex);
+    if (specificMatch && specificMatch[1]) {
+        return specificMatch[1].trim();
+    }
+    // If all else fails, return the most aggressively stripped version.
+    // JSON.parse will fail if it's not valid, which is the expected behavior.
+    return cleanedText;
+}

package/framework-mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atabey-mcp",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Agent Atabey Model Context Protocol (MCP) Server",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -22,7 +22,12 @@
   "scripts": {
     "build": "npx tsc",
     "start": "node dist/index.js",
-    "dev": "tsx src/index.ts"
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "vitest": {
+    "include": ["tests/**/*.test.ts"]
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
@@ -32,6 +37,7 @@
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^25.9.1",
+    "tsx": "^4.22.3",
     "typescript": "^5.9.3"
   }
 }

package/mcp.json

@@ -2,13 +2,19 @@
   "mcpServers": {
     "atabey": {
       "command": "atabey",
-      "args": [
-        "mcp",
-        "start"
-      ],
+      "args": ["mcp", "start"],
       "env": {
+        "MCP_TRANSPORT": "stdio",
         "ATABEY_PROJECT_ROOT": "/Users/ybekar/Desktop/Projeler/atabey"
-      }
+      },
+      "description": "Stdio mode: each developer connects from their own IDE."
+    },
+    "atabey-sse": {
+      "url": "http://localhost:5858/mcp/sse",
+      "env": {
+        "ATABEY_PROJECT_ROOT": "/Users/ybekar/Desktop/Projeler/atabey"
+      },
+      "description": "Unified mode: MCP + Dashboard on single port 5858. Dashboard: http://localhost:5858"
     }
   }
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atabey",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "MCP-Powered AI Governance & Autonomous Orchestration Framework. Plugs into Claude Code, Gemini CLI, and Cursor as an MCP server.",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -58,7 +58,14 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "prepublishOnly": "npm run build",
-    "clean": "rm -rf dist node_modules framework-mcp/node_modules framework-mcp/dist"
+    "clean": "rm -rf dist node_modules framework-mcp/node_modules framework-mcp/dist",
+    "atabey:status": "atabey status",
+    "atabey:trace": "atabey trace:new",
+    "atabey:verify": "atabey verify-contract",
+    "atabey:check": "atabey check",
+    "atabey:test": "vitest run",
+    "atabey:test:watch": "vitest",
+    "atabey:build": "npm run build --prefix framework-mcp"
   },
   "publishConfig": {
     "access": "public"
@@ -74,7 +81,6 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@pandacss/dev": "^1.11.1",
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^25.9.1",
     "@types/ws": "^8.18.1",
@@ -86,7 +92,7 @@
     "vitest": "^3.0.0"
   },
   "atabey": {
-    "version": "0.0.12",
-    "initializedAt": "2026-06-17T12:23:33.114Z"
+    "version": "0.0.15",
+    "initializedAt": "2026-06-20T15:11:43.308Z"
   }
 }

package/templates/full/ATABEY_FULL.md

@@ -1,4 +1,4 @@
-# Agent Atabey Enterprise
+# Atabey Governance Framework Enterprise
 # Place in project root. This file is the single source of truth for Base Project AI Extensions.
 
 ## [ATABEY] SUPREME LAW & ZERO DEVIATION POLICY (MANDATORY)