atabey 0.0.13 → 0.0.15

package/dist/framework-mcp/src/utils/rules-engine.js

@@ -0,0 +1,232 @@
+/**
+ * ─── RULES ENGINE (Prompt Conflict Resolution) ────────────────────
+ *
+ * Resolves conflicts between AI CLI built-in prompts and Atabey governance rules.
+ * Ensures Atabey's critical rules ALWAYS override CLI-level instructions.
+ *
+ * Priority System:
+ * - CRITICAL (P0): Non-bypassable rules (zero any, no console.log, PII masking)
+ * - HIGH (P1): Important rules that should not be violated
+ * - MEDIUM (P2): Standard best practices
+ * - LOW (P3): Recommendations only
+ *
+ * Enforcement Mechanisms:
+ * 1. Pre-execution: Rule validation BEFORE tool runs
+ * 2. Post-execution: Scan changed files for violations → auto-rollback
+ * 3. CLI System Prompt Override: Inject critical rules at MCP initialization
+ */
+import path from "path";
+// ─── Built-in Governance Rules ────────────────────────────────────
+const GOVERNANCE_RULES = [
+    // ── CRITICAL (P0) Rules ────────────────────────────────────
+    {
+        id: "no-any-types",
+        name: "Zero Any Type Policy",
+        description: "TypeScript 'any' type is strictly forbidden",
+        priority: "CRITICAL",
+        detectPattern: /:\s*any\b/g,
+        appliesToExtensions: [".ts", ".tsx"],
+        errorMessage: "CRITICAL: 'any' type is forbidden. Use 'unknown' with proper type guards instead.",
+        bypassable: false,
+    },
+    {
+        id: "no-console-log",
+        name: "No Console Log",
+        description: "console.log/error/warn is forbidden (use logger instead)",
+        priority: "CRITICAL",
+        detectPattern: /console\.(log|error|warn|debug|info)\s*\(/g,
+        appliesToExtensions: [".ts", ".tsx", ".js", ".jsx"],
+        errorMessage: "CRITICAL: console.log/error/warn is forbidden. Use the project's logger instead.",
+        bypassable: false,
+    },
+    {
+        id: "pii-masking",
+        name: "PII Masking Required",
+        description: "Sensitive data must be masked before logging or storing",
+        priority: "CRITICAL",
+        errorMessage: "CRITICAL: Detected potential PII in unmasked form. Use maskText() / maskObject() from pii.ts.",
+        bypassable: false,
+    },
+    // ── HIGH (P1) Rules ────────────────────────────────────────
+    {
+        id: "no-hardcoded-secrets",
+        name: "No Hardcoded Secrets",
+        description: "API keys, tokens, passwords must use environment variables",
+        priority: "HIGH",
+        detectPattern: /(['"])sk-[a-zA-Z0-9]{20,}['"]|(['"])ghp_[a-zA-Z0-9]{36,}['"]|(['"])AIza[0-9A-Za-z_-]{35}['"]/g,
+        appliesToExtensions: [".ts", ".tsx", ".js", ".jsx", ".py", ".go", ".java", ".yaml", ".yml", ".env.example"],
+        errorMessage: "HIGH: Hardcoded API keys/tokens detected. Use environment variables (process.env.*).",
+        bypassable: false,
+    },
+    {
+        id: "no-commented-code",
+        name: "No Commented-Out Code",
+        description: "Dead code should be removed, not commented out",
+        priority: "HIGH",
+        detectPattern: /\/\/\s*.{10,}/g,
+        appliesToExtensions: [".ts", ".tsx", ".js", ".jsx"],
+        errorMessage: "HIGH: Commented-out code detected. Remove dead code instead of commenting.",
+        bypassable: true,
+    },
+    // ── MEDIUM (P2) Rules ──────────────────────────────────────
+    {
+        id: "no-console-in-jsx",
+        name: "No Console in JSX",
+        description: "Avoid console statements inside JSX/TSX components",
+        priority: "MEDIUM",
+        detectPattern: /{.*console\.(log|error|warn)\(.*}/g,
+        appliesToExtensions: [".tsx", ".jsx"],
+        errorMessage: "MEDIUM: Console statement inside JSX detected. Move to event handler or useEffect.",
+        bypassable: true,
+    },
+    {
+        id: "i18n-usage",
+        name: "Internationalization Required",
+        description: "Use i18n for user-facing strings",
+        priority: "MEDIUM",
+        detectPattern: /(['"])([A-Z][a-z]+ [a-z]+ [a-z]+)['"]/g,
+        appliesToExtensions: [".tsx", ".jsx"],
+        errorMessage: "MEDIUM: User-facing string detected. Use i18n translation function instead.",
+        bypassable: true,
+    },
+];
+// ─── Rule Engine ──────────────────────────────────────────────────
+let rulesMap = null;
+function getRulesMap() {
+    if (!rulesMap) {
+        rulesMap = new Map();
+        for (const rule of GOVERNANCE_RULES) {
+            rulesMap.set(rule.id, rule);
+        }
+    }
+    return rulesMap;
+}
+/**
+ * Get all governance rules.
+ */
+export function getAllRules() {
+    return [...GOVERNANCE_RULES];
+}
+/**
+ * Get rules by priority level.
+ */
+export function getRulesByPriority(priority) {
+    return GOVERNANCE_RULES.filter(r => r.priority === priority);
+}
+/**
+ * Get non-bypassable rules (CRITICAL + HIGH non-bypassable).
+ */
+export function getNonBypassableRules() {
+    return GOVERNANCE_RULES.filter(r => !r.bypassable);
+}
+/**
+ * Scan file content for rule violations.
+ * Returns array of violations found.
+ */
+export function scanFileForViolations(filePath, content) {
+    const ext = path.extname(filePath);
+    const violations = [];
+    const lines = content.split("\n");
+    for (const rule of GOVERNANCE_RULES) {
+        // Check if rule applies to this file extension
+        if (rule.appliesToExtensions && !rule.appliesToExtensions.includes(ext)) {
+            continue;
+        }
+        // Check if rule has a detect pattern
+        if (!rule.detectPattern)
+            continue;
+        // Scan each line
+        for (let i = 0; i < lines.length; i++) {
+            const match = lines[i].match(rule.detectPattern);
+            if (match) {
+                violations.push({
+                    rule,
+                    match: match[0],
+                    line: i + 1,
+                });
+            }
+        }
+    }
+    return violations;
+}
+/**
+ * Validate tool arguments against governance rules.
+ * Returns violation messages if any critical rule is violated.
+ */
+export function validateArgsAgainstRules(toolName, args) {
+    const nonBypassable = getNonBypassableRules();
+    for (const rule of nonBypassable) {
+        // Check if rule applies to this tool
+        if (rule.appliesToTools && !rule.appliesToTools.includes(toolName)) {
+            continue;
+        }
+        // For write_file and replace_text, check content for violations
+        if ((toolName === "write_file" || toolName === "replace_text") && args.content) {
+            const content = args.content;
+            const filePath = args.path || "unknown.ts";
+            const violations = scanFileForViolations(filePath, content);
+            if (violations.length > 0) {
+                const details = violations.map(v => `  Line ${v.line}: ${v.match} (${v.rule.name} - ${v.rule.priority})`).join("\n");
+                return [
+                    `[GOVERNANCE] ${rule.priority} rule violation: ${rule.name}`,
+                    `${rule.errorMessage}`,
+                    "\nViolations:",
+                    details,
+                ].join("\n");
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Validate tool response for governance violations.
+ * Returns violation messages if found.
+ */
+export function validateResponseAgainstRules(toolName, responseText) {
+    // For file reads, check if the content contains PII or secrets
+    if (toolName === "read_file" && responseText.length > 0) {
+        const criticalRules = getNonBypassableRules();
+        for (const rule of criticalRules) {
+            if (rule.detectPattern && rule.detectPattern.test(responseText)) {
+                return `[GOVERNANCE] ${rule.priority} violation detected in response: ${rule.name}. ${rule.errorMessage}`;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Build system prompt override block for CLI initialization.
+ * This is injected into the AI's system prompt at MCP connect time.
+ */
+export function buildSystemPromptOverride() {
+    const criticalRules = getRulesByPriority("CRITICAL");
+    const highRules = getRulesByPriority("HIGH");
+    return [
+        "## [ATABEY GOVERNANCE] Critical Rules — DO NOT OVERRIDE",
+        "",
+        "The following rules are ENFORCED by the Atabey Governance Layer.",
+        "They CANNOT be bypassed or disabled.",
+        "",
+        "### Critical Rules (Non-Bypassable)",
+        ...criticalRules.map(r => `- 🔴 ${r.name}: ${r.description}`),
+        "",
+        "### High Priority Rules",
+        ...highRules.map(r => `- 🟠 ${r.name}: ${r.description}`),
+        "",
+        "> These rules are injected at the MCP middleware layer and enforced",
+        "> at both pre-execution and post-execution stages.",
+        "",
+    ].join("\n");
+}
+/**
+ * Add a custom governance rule at runtime.
+ */
+export function addRule(rule) {
+    const map = getRulesMap();
+    if (!map.has(rule.id)) {
+        GOVERNANCE_RULES.push(rule);
+        map.set(rule.id, rule);
+    }
+}
+export { GOVERNANCE_RULES as DefaultGovernanceRules };
+//# sourceMappingURL=rules-engine.js.map

package/dist/framework-mcp/src/utils/rules-engine.js.map

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

package/dist/framework-mcp/src/utils/silent-router.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ─── SILENT ROUTER ─────────────────────────────────────────────────
+ *
+ * Automatically routes tool calls to the most appropriate agent
+ * WITHOUT requiring the developer to type `@agent` commands.
+ *
+ * The magic: developer types "Make this API secure" and Atabey
+ * silently activates @security agent rules behind the scenes.
+ *
+ * Features:
+ * - Auto-agent detection from tool call context
+ * - Silent system prompt injection with specialty memory
+ * - Multi-agent chain support
+ * - Stealth notifications (stderr/dashboard only, never chat)
+ */
+declare const CONFIG: {
+    /** Enable silent routing (default: true) */
+    ENABLED: boolean;
+    /** Enable stealth notifications to stderr */
+    STEALTH_NOTIFY: boolean;
+    /** Agent override via env (for testing/debugging) */
+    FORCE_AGENT: string | null;
+    /** Enable specialty memory injection into context */
+    INJECT_SPECIALTY_MEMORY: boolean;
+};
+/**
+ * Detect the most appropriate agent for a given tool call and arguments.
+ * Uses RoutingEngine's TF-IDF matching on the args context.
+ */
+export declare function detectAgent(toolName: string, args: Record<string, unknown>): string;
+/**
+ * Get the system prompt rules for a given agent.
+ * Used to inject discipline silently into tool context.
+ */
+export declare function getAgentPrompt(agentName: string): Promise<string | null>;
+/**
+ * Build a silent context injection payload.
+ * Injects agent rules + specialty memory into tool responses.
+ */
+export declare function buildSilentContext(detectedAgent: string, toolName: string, responseText: string): Promise<string>;
+/**
+ * Send a stealth notification to stderr (never to the chat).
+ */
+export declare function stealthNotify(agent: string, toolName: string, message: string): void;
+/**
+ * Get silent router config.
+ */
+export declare function getSilentRouterConfig(): typeof CONFIG;
+export { CONFIG as SilentRouterConfig };

package/dist/framework-mcp/src/utils/silent-router.js

@@ -0,0 +1,155 @@
+/**
+ * ─── SILENT ROUTER ─────────────────────────────────────────────────
+ *
+ * Automatically routes tool calls to the most appropriate agent
+ * WITHOUT requiring the developer to type `@agent` commands.
+ *
+ * The magic: developer types "Make this API secure" and Atabey
+ * silently activates @security agent rules behind the scenes.
+ *
+ * Features:
+ * - Auto-agent detection from tool call context
+ * - Silent system prompt injection with specialty memory
+ * - Multi-agent chain support
+ * - Stealth notifications (stderr/dashboard only, never chat)
+ */
+import { EvaluationEngine } from "../../../src/modules/engines/evaluation-engine.js";
+import { RoutingEngine } from "../../../src/modules/engines/routing-engine.js";
+// ─── Configuration ────────────────────────────────────────────────
+const CONFIG = {
+    /** Enable silent routing (default: true) */
+    ENABLED: process.env.MCP_SILENT_ROUTING !== "false",
+    /** Enable stealth notifications to stderr */
+    STEALTH_NOTIFY: process.env.MCP_SILENT_STEALTH !== "false",
+    /** Agent override via env (for testing/debugging) */
+    FORCE_AGENT: process.env.MCP_FORCE_AGENT || null,
+    /** Enable specialty memory injection into context */
+    INJECT_SPECIALTY_MEMORY: process.env.MCP_INJECT_SPECIALTY_MEMORY !== "false",
+};
+let agentRuleCache = null;
+async function loadAgentRules() {
+    if (agentRuleCache)
+        return agentRuleCache;
+    try {
+        const { ALL_AGENTS } = await import("../../../src/modules/agents/definitions.js");
+        agentRuleCache = new Map();
+        for (const agent of ALL_AGENTS) {
+            agentRuleCache.set(agent.name, {
+                name: agent.name,
+                identity: agent.instructions.identity,
+                mission: agent.instructions.mission,
+                rules: agent.instructions.rules,
+            });
+        }
+    }
+    catch {
+        agentRuleCache = new Map();
+    }
+    return agentRuleCache;
+}
+/**
+ * Detect the most appropriate agent for a given tool call and arguments.
+ * Uses RoutingEngine's TF-IDF matching on the args context.
+ */
+export function detectAgent(toolName, args) {
+    if (CONFIG.FORCE_AGENT)
+        return CONFIG.FORCE_AGENT;
+    const contextParts = [toolName];
+    for (const [, value] of Object.entries(args)) {
+        if (typeof value === "string") {
+            contextParts.push(value);
+        }
+        else if (Array.isArray(value)) {
+            contextParts.push(value.filter(v => typeof v === "string").join(" "));
+        }
+    }
+    const context = contextParts.join(" ").substring(0, 500);
+    return RoutingEngine.resolveAgent(context);
+}
+/**
+ * Get the system prompt rules for a given agent.
+ * Used to inject discipline silently into tool context.
+ */
+export async function getAgentPrompt(agentName) {
+    const rules = await loadAgentRules();
+    const agent = rules.get(agentName.replace("@", ""));
+    if (!agent)
+        return null;
+    return [
+        `## [ATABEY SILENT] ${agent.name} (${agent.identity})`,
+        "",
+        "### Mission",
+        `${agent.mission}`,
+        "",
+        "### Active Disciplines",
+        ...agent.rules.map(r => `- ${r}`),
+        "",
+        "> These rules are injected by Atabey governance layer.",
+        "> They supplement (not replace) your existing instructions.",
+    ].join("\n");
+}
+/**
+ * Load specialty memory for an agent and format it for injection.
+ */
+function getSpecialtyMemoryContext(agentName) {
+    if (!CONFIG.INJECT_SPECIALTY_MEMORY)
+        return null;
+    try {
+        const conventions = EvaluationEngine.readLearnedConventions(agentName);
+        if (!conventions)
+            return null;
+        return [
+            "",
+            "### Previously Learned Conventions",
+            `The following lessons were learned from past tasks for @${agentName}:`,
+            "",
+            conventions,
+            "",
+        ].join("\n");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build a silent context injection payload.
+ * Injects agent rules + specialty memory into tool responses.
+ */
+export async function buildSilentContext(detectedAgent, toolName, responseText) {
+    if (!CONFIG.ENABLED)
+        return responseText;
+    const agentPrompt = await getAgentPrompt(detectedAgent);
+    if (!agentPrompt)
+        return responseText;
+    if (responseText.length < 50)
+        return responseText;
+    // Inject specialty memory if available
+    const specialtyContext = getSpecialtyMemoryContext(detectedAgent);
+    const fullPrompt = specialtyContext
+        ? `${agentPrompt}\n${specialtyContext}`
+        : agentPrompt;
+    const injection = [
+        "",
+        `<!-- ATABEY_GOVERNANCE agent="${detectedAgent}" tool="${toolName}" -->`,
+        `${fullPrompt}`,
+        "<!-- /ATABEY_GOVERNANCE -->",
+        "",
+    ].join("\n");
+    return injection + responseText;
+}
+/**
+ * Send a stealth notification to stderr (never to the chat).
+ */
+export function stealthNotify(agent, toolName, message) {
+    if (!CONFIG.STEALTH_NOTIFY)
+        return;
+    process.stderr.write(`[ATABEY:${agent}] ${message} (tool: ${toolName})\n`);
+}
+/**
+ * Get silent router config.
+ */
+export function getSilentRouterConfig() {
+    return { ...CONFIG };
+}
+export { CONFIG as SilentRouterConfig };
+//# sourceMappingURL=silent-router.js.map

package/dist/framework-mcp/src/utils/silent-router.js.map

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

package/dist/framework-mcp/src/utils/storage.d.ts

@@ -27,6 +27,7 @@ export interface TaskRow {
     status: string;
     priority: string;
     dependencies: string[];
+    createdAt?: string;
 }
 export interface LogRow {
     id?: number;

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

@@ -149,7 +149,6 @@ export class Storage {
             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 {
@@ -162,7 +161,8 @@ export class Storage {
                 agent: r.agent,
                 status: r.status,
                 priority: r.priority,
-                dependencies: deps
+                dependencies: deps,
+                createdAt: r.created_at
             };
         });
     }

package/dist/framework-mcp/src/utils/storage.js.map

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

package/dist/framework-mcp/src/utils/telemetry-streamer.d.ts

@@ -0,0 +1,133 @@
+/**
+ * ─── ASYNCHRONOUS TELEMETRY STREAMER ───────────────────────────────
+ *
+ * Streams local audit logs, metrics, and governance events to the
+ * central enterprise server asynchronously without blocking the
+ * developer's AI CLI workflow.
+ *
+ * Features:
+ * - Batch streaming (accumulates events, sends in batches)
+ * - Retry with exponential backoff
+ * - Queue persistence (survives process restarts)
+ * - Bandwidth throttling (max N events per minute)
+ * - PII masking before transmission (GDPR/KVKK)
+ * - Connection health monitoring
+ *
+ * Architecture:
+ *   [Local MCP] → SQLite Queue → Batch Processor → HTTPS/WS → [Enterprise Server]
+ *
+ * [KVKK/GDPR] All PII is masked BEFORE leaving the local machine.
+ */
+declare const CONFIG: {
+    /** Enterprise server URL (e.g., https://atabey.company.com) */
+    SERVER_URL: string;
+    /** Auth token for enterprise server */
+    AUTH_TOKEN: string;
+    /** Max events per batch */
+    BATCH_SIZE: number;
+    /** Flush interval in ms */
+    FLUSH_INTERVAL_MS: number;
+    /** Max retries per batch */
+    MAX_RETRIES: number;
+    /** Retry base delay (exponential backoff) */
+    RETRY_BASE_DELAY_MS: number;
+    /** Max events per minute (throttle) */
+    MAX_EVENTS_PER_MINUTE: number;
+    /** Enable/disable telemetry */
+    ENABLED: boolean;
+    /** Use WebSocket for real-time streaming (fallback to HTTPS) */
+    USE_WEBSOCKET: boolean;
+};
+export interface TelemetryEvent {
+    id: string;
+    type: "tool_call" | "governance_violation" | "risk_blocked" | "approval" | "error" | "metric" | "heartbeat";
+    timestamp: string;
+    agent: string;
+    machineId: string;
+    projectHash: string;
+    payload: Record<string, unknown>;
+}
+export declare class TelemetryStreamer {
+    private static instance;
+    private queue;
+    private flushTimer;
+    private ws;
+    private wsReconnectTimer;
+    private eventCountThisMinute;
+    private minuteResetTimer;
+    private machineId;
+    private projectHash;
+    private isFlushing;
+    private constructor();
+    static getInstance(): TelemetryStreamer;
+    /**
+     * Start the telemetry streamer.
+     * Begins periodic flush and WebSocket connection if configured.
+     */
+    start(): void;
+    /**
+     * Stop the telemetry streamer.
+     */
+    stop(): void;
+    /**
+     * Enqueue a telemetry event for streaming.
+     * Events are batched and sent asynchronously.
+     */
+    enqueue(event: Omit<TelemetryEvent, "id" | "machineId" | "projectHash">): void;
+    /**
+     * Convenience method for logging tool calls.
+     */
+    logToolCall(agent: string, toolName: string, tokens: number, traceId: string, durationMs: number): void;
+    /**
+     * Convenience method for logging governance violations.
+     */
+    logGovernanceViolation(agent: string, toolName: string, error: string): void;
+    /**
+     * Convenience method for logging errors.
+     */
+    logError(agent: string, action: string, error: string): void;
+    /**
+     * Flush queued events to the enterprise server.
+     */
+    private flush;
+    /**
+     * Synchronous flush (for process exit).
+     */
+    private flushSync;
+    /**
+     * Send a batch of events to the enterprise server via HTTPS.
+     */
+    private sendBatch;
+    /**
+     * Connect to enterprise server via WebSocket for real-time streaming.
+     */
+    private connectWebSocket;
+    /**
+     * Save event to local fallback file (when server is unreachable).
+     */
+    private saveToLocalFallback;
+    /**
+     * Generate a unique machine ID.
+     */
+    private generateMachineId;
+    /**
+     * Generate a project hash for grouping.
+     */
+    private generateProjectHash;
+    /**
+     * Simple string hash.
+     */
+    private simpleHash;
+    /**
+     * Get streamer status.
+     */
+    getStatus(): {
+        enabled: boolean;
+        serverUrl: string;
+        queueSize: number;
+        wsConnected: boolean;
+        eventsThisMinute: number;
+    };
+}
+export declare const telemetryStreamer: TelemetryStreamer;
+export { CONFIG as TelemetryConfig };