atabey 0.0.16 → 0.0.18

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

@@ -0,0 +1,54 @@
+import { execFileSync } from "child_process";
+import fs from "fs";
+import path from "path";
+import { logger } from "./logger.js";
+export function ensureDir(dirPath, dryRun = false) {
+    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, content, dryRun = false) {
+    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, content, dryRun = false) {
+    if (dryRun) {
+        logger.info(`[DRY RUN] Would append to file: ${filePath}`);
+        return;
+    }
+    ensureDir(path.dirname(filePath));
+    // Atomic append: oku → ekle → atomic yaz
+    const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf8") : "";
+    writeTextFile(filePath, existing + content);
+}
+export function writeJsonFile(filePath, value, dryRun = false) {
+    writeTextFile(filePath, JSON.stringify(value, null, 2), dryRun);
+}
+export function runCommandQuiet(command, args, cwd) {
+    execFileSync(command, args, { cwd, stdio: "ignore" });
+}
+//# sourceMappingURL=fs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../../src/shared/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,MAAM,GAAG,KAAK;IACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,IAAI,MAAM,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACJ,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,OAAe,EAAE,MAAM,GAAG,KAAK;IAC3E,IAAI,MAAM,EAAE,CAAC;QACT,MAAM,CAAC,IAAI,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;QACvD,OAAO;IACX,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,SAAS,CAAC,GAAG,CAAC,CAAC;IAEf,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IAC7E,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC;IAEvE,IAAI,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QACjD,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACrD,MAAM,GAAG,CAAC;IACd,CAAC;AACL,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,OAAe,EAAE,MAAM,GAAG,KAAK;IACxE,IAAI,MAAM,EAAE,CAAC;QACT,MAAM,CAAC,IAAI,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;QAC3D,OAAO;IACX,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClC,yCAAyC;IACzC,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,KAAc,EAAE,MAAM,GAAG,KAAK;IAC1E,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,IAAc,EAAE,GAAW;IACxE,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,82 @@
+/**
+ * [LOCK] Multi-user Distributed Lock Mechanism
+ *
+ * Git-based lock system. Enables team members to work on the same
+ * files/resources without conflicts.
+ *
+ * Usage:
+ *   const lock = new DistributedLock("database/schema.sql");
+ *   if (lock.acquire("user-123", 60000)) {
+ *     // Apply changes
+ *     lock.release("user-123");
+ *   }
+ */
+export type LockStatus = "LOCKED" | "AVAILABLE" | "STALE" | "EXPIRED";
+export interface LockInfo {
+    resource: string;
+    ownerId: string;
+    ownerName: string;
+    acquiredAt: string;
+    expiresAt: string;
+    reason: string;
+    traceId?: string;
+}
+export declare class DistributedLock {
+    private static TABLE;
+    /**
+     * Initialize the locks table (run once at startup).
+     */
+    static initialize(): void;
+    /**
+     * Attempts to acquire a lock on a resource.
+     *
+     * @param resource - Lock resource name (e.g., "apps/backend/src/types/user.ts")
+     * @param ownerId - Unique owner identifier (e.g., "yusuf", "ci-bot-01")
+     * @param options - Optional parameters
+     * @returns true if lock acquired, false if already locked
+     */
+    static acquire(resource: string, ownerId: string, options?: {
+        ownerName?: string;
+        ttlMs?: number;
+        reason?: string;
+        traceId?: string;
+        force?: boolean;
+    }): boolean;
+    /**
+     * Releases a lock. Only the lock owner can release.
+     *
+     * @param resource - Lock resource name
+     * @param ownerId - Owner identifier for verification
+     * @returns true if released successfully
+     */
+    static release(resource: string, ownerId: string): boolean;
+    /**
+     * Checks if a resource is locked.
+     */
+    static isLocked(resource: string): boolean;
+    /**
+     * Gets lock information for a resource.
+     */
+    static getLock(resource: string): LockInfo | null;
+    /**
+     * Lists all active locks.
+     */
+    static listActiveLocks(): LockInfo[];
+    /**
+     * Lists all locks owned by a specific owner.
+     */
+    static listOwnerLocks(ownerId: string): LockInfo[];
+    /**
+     * Releases all locks owned by a specific owner (e.g., on disconnect).
+     */
+    static releaseAllByOwner(ownerId: string): number;
+    /**
+     * Releases all expired/stale locks.
+     */
+    private static releaseStaleLocks;
+    /**
+     * Generates a unique owner ID for the current user/machine.
+     * Uses git config user.name or hostname as fallback.
+     */
+    static getLocalOwnerId(): string;
+}

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

@@ -0,0 +1,160 @@
+/**
+ * [LOCK] Multi-user Distributed Lock Mechanism
+ *
+ * Git-based lock system. Enables team members to work on the same
+ * files/resources without conflicts.
+ *
+ * Usage:
+ *   const lock = new DistributedLock("database/schema.sql");
+ *   if (lock.acquire("user-123", 60000)) {
+ *     // Apply changes
+ *     lock.release("user-123");
+ *   }
+ */
+import { execSync } from "child_process";
+import os from "os";
+import { Storage } from "./storage.js";
+export class DistributedLock {
+    static TABLE = "distributed_locks";
+    /**
+     * Initialize the locks table (run once at startup).
+     */
+    static initialize() {
+        const db = Storage.getDB();
+        db.exec(`
+            CREATE TABLE IF NOT EXISTS ${this.TABLE} (
+                resource TEXT PRIMARY KEY,
+                ownerId TEXT NOT NULL,
+                ownerName TEXT NOT NULL,
+                acquiredAt TEXT NOT NULL,
+                expiresAt TEXT NOT NULL,
+                reason TEXT,
+                traceId TEXT
+            )
+        `);
+    }
+    /**
+     * Attempts to acquire a lock on a resource.
+     *
+     * @param resource - Lock resource name (e.g., "apps/backend/src/types/user.ts")
+     * @param ownerId - Unique owner identifier (e.g., "yusuf", "ci-bot-01")
+     * @param options - Optional parameters
+     * @returns true if lock acquired, false if already locked
+     */
+    static acquire(resource, ownerId, options = {}) {
+        const db = Storage.getDB();
+        const now = new Date();
+        const expiresAt = new Date(now.getTime() + (options.ttlMs || 60000)).toISOString();
+        const ownerName = options.ownerName || ownerId;
+        const reason = options.reason || "No reason provided";
+        // Clean up stale locks first
+        this.releaseStaleLocks();
+        // Check current lock status
+        const existing = db.prepare(`SELECT * FROM ${this.TABLE} WHERE resource = ?`).get(resource);
+        if (existing) {
+            // If force=true, override existing lock
+            if (options.force) {
+                db.prepare(`
+                    INSERT OR REPLACE INTO ${this.TABLE} (resource, ownerId, ownerName, acquiredAt, expiresAt, reason, traceId)
+                    VALUES (?, ?, ?, ?, ?, ?, ?)
+                `).run(resource, ownerId, ownerName, now.toISOString(), expiresAt, reason, options.traceId || null);
+                return true;
+            }
+            return false; // Already locked
+        }
+        // Acquire new lock
+        db.prepare(`
+            INSERT INTO ${this.TABLE} (resource, ownerId, ownerName, acquiredAt, expiresAt, reason, traceId)
+            VALUES (?, ?, ?, ?, ?, ?, ?)
+        `).run(resource, ownerId, ownerName, now.toISOString(), expiresAt, reason, options.traceId || null);
+        return true;
+    }
+    /**
+     * Releases a lock. Only the lock owner can release.
+     *
+     * @param resource - Lock resource name
+     * @param ownerId - Owner identifier for verification
+     * @returns true if released successfully
+     */
+    static release(resource, ownerId) {
+        const db = Storage.getDB();
+        const result = db.prepare(`DELETE FROM ${this.TABLE} WHERE resource = ? AND ownerId = ?`).run(resource, ownerId);
+        return result.changes > 0;
+    }
+    /**
+     * Checks if a resource is locked.
+     */
+    static isLocked(resource) {
+        const db = Storage.getDB();
+        const lock = db.prepare(`SELECT * FROM ${this.TABLE} WHERE resource = ? AND expiresAt > datetime('now')`).get(resource);
+        return !!lock;
+    }
+    /**
+     * Gets lock information for a resource.
+     */
+    static getLock(resource) {
+        const db = Storage.getDB();
+        this.releaseStaleLocks();
+        const lock = db.prepare(`SELECT * FROM ${this.TABLE} WHERE resource = ?`).get(resource);
+        return lock || null;
+    }
+    /**
+     * Lists all active locks.
+     */
+    static listActiveLocks() {
+        const db = Storage.getDB();
+        this.releaseStaleLocks();
+        return db.prepare(`SELECT * FROM ${this.TABLE} WHERE expiresAt > datetime('now') ORDER BY acquiredAt DESC`).all();
+    }
+    /**
+     * Lists all locks owned by a specific owner.
+     */
+    static listOwnerLocks(ownerId) {
+        const db = Storage.getDB();
+        return db.prepare(`SELECT * FROM ${this.TABLE} WHERE ownerId = ? ORDER BY acquiredAt DESC`).all(ownerId);
+    }
+    /**
+     * Releases all locks owned by a specific owner (e.g., on disconnect).
+     */
+    static releaseAllByOwner(ownerId) {
+        const db = Storage.getDB();
+        const result = db.prepare(`DELETE FROM ${this.TABLE} WHERE ownerId = ?`).run(ownerId);
+        return result.changes;
+    }
+    /**
+     * Releases all expired/stale locks.
+     */
+    static releaseStaleLocks() {
+        const db = Storage.getDB();
+        const result = db.prepare(`DELETE FROM ${this.TABLE} WHERE expiresAt < datetime('now')`).run();
+        return result.changes;
+    }
+    /**
+     * Generates a unique owner ID for the current user/machine.
+     * Uses git config user.name or hostname as fallback.
+     */
+    static getLocalOwnerId() {
+        // Try git config
+        try {
+            const name = execSync("git config user.name", { encoding: "utf8" }).trim();
+            if (name)
+                return name;
+        }
+        catch {
+            // Fallback
+        }
+        // Try environment
+        if (process.env.USER)
+            return process.env.USER;
+        if (process.env.USERNAME)
+            return process.env.USERNAME;
+        // Fallback to hostname
+        try {
+            return os.hostname();
+        }
+        catch {
+            return "unknown-user";
+        }
+    }
+}
+//# sourceMappingURL=lock.js.map

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

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

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

@@ -0,0 +1,30 @@
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3,
+    FATAL = 4
+}
+export interface LoggerConfig {
+    minLevel: LogLevel;
+    enableColors: boolean;
+    jsonFormat: boolean;
+    logFile?: string;
+    enablePiiMasking: boolean;
+    piiWarning: boolean;
+}
+export declare class EnterpriseLogger {
+    private config;
+    private static instance;
+    private constructor();
+    static getInstance(): EnterpriseLogger;
+    configure(config: Partial<LoggerConfig>): void;
+    private formatMessage;
+    private log;
+    debug(message: string, meta?: unknown): void;
+    info(message: string, meta?: unknown): void;
+    warn(message: string, meta?: unknown): void;
+    error(message: string, meta?: unknown): void;
+    fatal(message: string, meta?: unknown): void;
+}
+export declare const logger: EnterpriseLogger;

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

@@ -0,0 +1,127 @@
+import chalk from "chalk";
+import path from "path";
+import { appendFile, ensureDir } from "./fs.js";
+import { containsPII, maskObject, maskText } from "./pii.js";
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["FATAL"] = 4] = "FATAL";
+})(LogLevel || (LogLevel = {}));
+export class EnterpriseLogger {
+    config;
+    static instance;
+    constructor() {
+        const isProd = process.env.NODE_ENV === "production";
+        this.config = {
+            minLevel: isProd ? LogLevel.INFO : LogLevel.DEBUG,
+            enableColors: !isProd,
+            jsonFormat: isProd,
+            enablePiiMasking: true, // KVKK: PII masking ON by default
+            piiWarning: true,
+        };
+    }
+    static getInstance() {
+        if (!EnterpriseLogger.instance) {
+            EnterpriseLogger.instance = new EnterpriseLogger();
+        }
+        return EnterpriseLogger.instance;
+    }
+    configure(config) {
+        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`);
+            }
+        }
+    }
+    formatMessage(level, message, meta) {
+        const timestamp = new Date().toISOString();
+        const pid = process.pid;
+        // [KVKK] PII masking — mask sensitive data before logging
+        const safeMessage = this.config.enablePiiMasking ? maskText(message) : message;
+        const safeMeta = this.config.enablePiiMasking && meta ? maskObject(meta) : meta;
+        // [KVKK] Warn if PII detected in production
+        if (this.config.piiWarning && (containsPII(message) || (meta && containsPII(JSON.stringify(meta))))) {
+            process.stderr.write(`[PII WARNING] Potential PII detected in log at ${timestamp}\n`);
+        }
+        if (this.config.jsonFormat) {
+            return JSON.stringify({
+                timestamp,
+                level: LogLevel[level],
+                pid,
+                message: safeMessage,
+                meta: safeMeta,
+            });
+        }
+        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 = safeMeta ? ` | Meta: ${JSON.stringify(safeMeta)}` : "";
+        return `[${timestamp}] [PID:${pid}] [${coloredLevel}]: ${safeMessage}${metaStr}`;
+    }
+    log(level, message, meta) {
+        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`);
+            }
+        }
+    }
+    debug(message, meta) {
+        this.log(LogLevel.DEBUG, message, meta);
+    }
+    info(message, meta) {
+        this.log(LogLevel.INFO, message, meta);
+    }
+    warn(message, meta) {
+        this.log(LogLevel.WARN, message, meta);
+    }
+    error(message, meta) {
+        this.log(LogLevel.ERROR, message, meta);
+    }
+    fatal(message, meta) {
+        this.log(LogLevel.FATAL, message, meta);
+    }
+}
+export const logger = EnterpriseLogger.getInstance();
+//# sourceMappingURL=logger.js.map

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

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

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

@@ -0,0 +1,69 @@
+/**
+ * [PII] Personally Identifiable Information Masking Service
+ *
+ * Detects and masks sensitive data in compliance with KVKK/GDPR.
+ * Used in audit log, logger, storage layers, and MCP middleware.
+ *
+ * Supported patterns:
+ * - Email addresses
+ * - Phone numbers (international, Turkish, US, UK)
+ * - TC Identification number (11 digits)
+ * - API keys / tokens (OpenAI, Anthropic, Google, GitHub, generic)
+ * - Bearer tokens / JWTs
+ * - IP addresses (IPv4, IPv6)
+ * - Credit card numbers (AMEX, Visa, Mastercard, etc.)
+ * - Password / secret fields in structured data
+ * - Bank account / IBAN
+ * - Date of birth / full address patterns
+ * - Custom names (configurable)
+ */
+/**
+ * Mask sensitive data in a text string.
+ */
+export declare function maskText(text: string): string;
+/**
+ * Recursively mask sensitive fields in an object.
+ * Returns a new object with sensitive values redacted.
+ * Strict mode: when true, also masks values in objects even if the key
+ * is not a known sensitive field name (catches data passed to unknown schemas).
+ */
+export declare function maskObject(obj: unknown, depth?: number, strictMode?: boolean): unknown;
+/**
+ * Check if a string contains potential PII.
+ * Useful for warning before sending data to external APIs.
+ */
+export declare function containsPII(text: string): boolean;
+/**
+ * Check if an object contains PII in any of its string values (recursive).
+ */
+export declare function containsPIIInObject(obj: unknown, depth?: number): boolean;
+/**
+ * Data classification levels for audit/log decisions.
+ */
+export type DataClassification = "public" | "internal" | "confidential" | "restricted" | "critical";
+/**
+ * Classify a piece of data based on content analysis.
+ */
+export declare function classifyData(text: string): DataClassification;
+/**
+ * Mask the content field of an MCP tool result.
+ * This is used by the MCP middleware layer to automatically
+ * sanitize all tool outputs before they reach the AI.
+ */
+export declare function maskToolResult(result: {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}): {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+};
+/**
+ * Mask sensitive arguments in an MCP tool call.
+ * This is applied BEFORE the tool handler executes, ensuring
+ * PII never reaches any processing layer unnecessarily.
+ */
+export declare function maskToolArgs(args: Record<string, unknown>): Record<string, unknown>;