atabey 0.0.13 → 0.0.15

package/framework-mcp/dist/framework-mcp/src/utils/telemetry-streamer.js

@@ -0,0 +1,396 @@
+/**
+ * ─── 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.
+ */
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { maskObject, maskText } from "../../../src/shared/pii.js";
+// ─── Configuration ────────────────────────────────────────────────
+const CONFIG = {
+    /** Enterprise server URL (e.g., https://atabey.company.com) */
+    SERVER_URL: process.env.ATABEY_SERVER_URL || "",
+    /** Auth token for enterprise server */
+    AUTH_TOKEN: process.env.ATABEY_SERVER_TOKEN || "",
+    /** Max events per batch */
+    BATCH_SIZE: parseInt(process.env.ATABEY_TELEMETRY_BATCH_SIZE || "50", 10),
+    /** Flush interval in ms */
+    FLUSH_INTERVAL_MS: parseInt(process.env.ATABEY_TELEMETRY_FLUSH_INTERVAL || "30000", 10),
+    /** Max retries per batch */
+    MAX_RETRIES: parseInt(process.env.ATABEY_TELEMETRY_MAX_RETRIES || "3", 10),
+    /** Retry base delay (exponential backoff) */
+    RETRY_BASE_DELAY_MS: parseInt(process.env.ATABEY_TELEMETRY_RETRY_DELAY || "1000", 10),
+    /** Max events per minute (throttle) */
+    MAX_EVENTS_PER_MINUTE: parseInt(process.env.ATABEY_TELEMETRY_RATE_LIMIT || "200", 10),
+    /** Enable/disable telemetry */
+    ENABLED: process.env.ATABEY_TELEMETRY_ENABLED !== "false",
+    /** Use WebSocket for real-time streaming (fallback to HTTPS) */
+    USE_WEBSOCKET: process.env.ATABEY_TELEMETRY_WS === "true",
+};
+// ─── Telemetry Streamer ───────────────────────────────────────────
+export class TelemetryStreamer {
+    static instance;
+    queue = [];
+    flushTimer = null;
+    ws = null;
+    wsReconnectTimer = null;
+    eventCountThisMinute = 0;
+    minuteResetTimer = null;
+    machineId;
+    projectHash;
+    isFlushing = false;
+    constructor() {
+        this.machineId = this.generateMachineId();
+        this.projectHash = this.generateProjectHash();
+    }
+    static getInstance() {
+        if (!TelemetryStreamer.instance) {
+            TelemetryStreamer.instance = new TelemetryStreamer();
+        }
+        return TelemetryStreamer.instance;
+    }
+    /**
+     * Start the telemetry streamer.
+     * Begins periodic flush and WebSocket connection if configured.
+     */
+    start() {
+        if (!CONFIG.ENABLED || !CONFIG.SERVER_URL) {
+            process.stderr.write("[TELEMETRY] Disabled or no server URL configured.\n");
+            return;
+        }
+        process.stderr.write(`[TELEMETRY] Starting streamer → ${CONFIG.SERVER_URL}\n`);
+        // Periodic flush
+        this.flushTimer = setInterval(() => this.flush(), CONFIG.FLUSH_INTERVAL_MS);
+        // Minute counter reset
+        this.minuteResetTimer = setInterval(() => {
+            this.eventCountThisMinute = 0;
+        }, 60000);
+        // WebSocket connection (if enabled)
+        if (CONFIG.USE_WEBSOCKET) {
+            this.connectWebSocket();
+        }
+        // Flush on exit
+        process.on("beforeExit", () => this.flushSync());
+        process.on("SIGINT", () => { this.flushSync(); });
+        process.on("SIGTERM", () => { this.flushSync(); });
+    }
+    /**
+     * Stop the telemetry streamer.
+     */
+    stop() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        if (this.minuteResetTimer) {
+            clearInterval(this.minuteResetTimer);
+            this.minuteResetTimer = null;
+        }
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        if (this.wsReconnectTimer) {
+            clearTimeout(this.wsReconnectTimer);
+            this.wsReconnectTimer = null;
+        }
+        this.flushSync();
+    }
+    /**
+     * Enqueue a telemetry event for streaming.
+     * Events are batched and sent asynchronously.
+     */
+    enqueue(event) {
+        if (!CONFIG.ENABLED)
+            return;
+        // Rate limiting
+        if (this.eventCountThisMinute >= CONFIG.MAX_EVENTS_PER_MINUTE) {
+            return; // Silently drop
+        }
+        this.eventCountThisMinute++;
+        const fullEvent = {
+            ...event,
+            id: `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+            machineId: this.machineId,
+            projectHash: this.projectHash,
+            // [KVKK/GDPR] Mask PII before queuing
+            payload: maskObject(event.payload),
+        };
+        this.queue.push({ event: fullEvent, retries: 0, lastAttempt: null });
+        // If queue is large enough, flush immediately
+        if (this.queue.length >= CONFIG.BATCH_SIZE) {
+            this.flush();
+        }
+    }
+    /**
+     * Convenience method for logging tool calls.
+     */
+    logToolCall(agent, toolName, tokens, traceId, durationMs) {
+        this.enqueue({
+            type: "tool_call",
+            timestamp: new Date().toISOString(),
+            agent,
+            payload: {
+                tool: toolName,
+                estimatedTokens: tokens,
+                traceId,
+                durationMs,
+            },
+        });
+    }
+    /**
+     * Convenience method for logging governance violations.
+     */
+    logGovernanceViolation(agent, toolName, error) {
+        this.enqueue({
+            type: "governance_violation",
+            timestamp: new Date().toISOString(),
+            agent,
+            payload: {
+                tool: toolName,
+                error: maskText(error),
+            },
+        });
+    }
+    /**
+     * Convenience method for logging errors.
+     */
+    logError(agent, action, error) {
+        this.enqueue({
+            type: "error",
+            timestamp: new Date().toISOString(),
+            agent,
+            payload: {
+                action,
+                error: maskText(error),
+            },
+        });
+    }
+    // ─── Private Methods ───────────────────────────────────────
+    /**
+     * Flush queued events to the enterprise server.
+     */
+    async flush() {
+        if (this.isFlushing || this.queue.length === 0)
+            return;
+        this.isFlushing = true;
+        let success;
+        const batch = this.queue.splice(0, CONFIG.BATCH_SIZE);
+        try {
+            const events = batch.map(q => q.event);
+            // [KVKK/GDPR] Double-check PII masking before transmission
+            const sanitizedEvents = events.map(e => ({
+                ...e,
+                payload: maskObject(e.payload),
+            }));
+            success = await this.sendBatch(sanitizedEvents);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Unknown error";
+            process.stderr.write(`[TELEMETRY] Send batch failed: ${message}\n`);
+            success = false;
+        }
+        if (!success) {
+            // Re-queue with retry count
+            for (const q of batch) {
+                q.retries++;
+                q.lastAttempt = Date.now();
+                if (q.retries < CONFIG.MAX_RETRIES) {
+                    this.queue.push(q);
+                }
+                else {
+                    // Max retries exceeded, log locally and drop
+                    process.stderr.write(`[TELEMETRY] Dropped event after ${CONFIG.MAX_RETRIES} retries: ${q.event.type}\n`);
+                    this.saveToLocalFallback(q.event);
+                }
+            }
+        }
+        this.isFlushing = false;
+    }
+    /**
+     * Synchronous flush (for process exit).
+     */
+    flushSync() {
+        if (this.queue.length === 0)
+            return;
+        const batch = this.queue.splice(0, CONFIG.BATCH_SIZE);
+        const events = batch.map(q => q.event);
+        // Save to local fallback file (best effort)
+        for (const event of events) {
+            this.saveToLocalFallback(event);
+        }
+    }
+    /**
+     * Send a batch of events to the enterprise server via HTTPS.
+     */
+    async sendBatch(events) {
+        try {
+            const url = `${CONFIG.SERVER_URL.replace(/\/$/, "")}/api/telemetry/ingest`;
+            const response = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Authorization": `Bearer ${CONFIG.AUTH_TOKEN}`,
+                    "X-Machine-Id": this.machineId,
+                    "X-Project-Hash": this.projectHash,
+                },
+                body: JSON.stringify({
+                    batch: events,
+                    sentAt: new Date().toISOString(),
+                    machineId: this.machineId,
+                }),
+            });
+            if (!response.ok) {
+                process.stderr.write(`[TELEMETRY] Server returned ${response.status}: ${response.statusText}\n`);
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            process.stderr.write(`[TELEMETRY] Send failed: ${message}\n`);
+            return false;
+        }
+    }
+    /**
+     * Connect to enterprise server via WebSocket for real-time streaming.
+     */
+    connectWebSocket() {
+        // Native WebSocket is available in Node.js >= 22.
+        // For older versions, we skip WebSocket and rely on HTTPS batch mode.
+        const NodeWebSocket = typeof WebSocket !== "undefined" ? WebSocket : undefined;
+        if (!NodeWebSocket) {
+            process.stderr.write("[TELEMETRY] WebSocket unavailable (Node.js < 22). Using HTTPS batch mode only.\n");
+            // Force HTTPS mode by disabling WS flag
+            return;
+        }
+        try {
+            const wsUrl = CONFIG.SERVER_URL.replace(/^http/, "ws").replace(/\/$/, "") + "/ws/telemetry";
+            this.ws = new NodeWebSocket(wsUrl);
+            this.ws.onopen = () => {
+                process.stderr.write("[TELEMETRY] WebSocket connected.\n");
+                // Authenticate
+                this.ws?.send(JSON.stringify({
+                    type: "auth",
+                    token: CONFIG.AUTH_TOKEN,
+                    machineId: this.machineId,
+                    projectHash: this.projectHash,
+                }));
+            };
+            this.ws.onclose = () => {
+                process.stderr.write("[TELEMETRY] WebSocket disconnected. Reconnecting...\n");
+                this.ws = null;
+                // Reconnect after delay
+                this.wsReconnectTimer = setTimeout(() => this.connectWebSocket(), 5000);
+            };
+            this.ws.onerror = () => {
+                // onclose will handle reconnection
+            };
+            this.ws.onmessage = (msg) => {
+                try {
+                    const data = JSON.parse(msg.data.toString());
+                    if (data.type === "config_update") {
+                        process.stderr.write(`[TELEMETRY] Config update received: ${JSON.stringify(data.payload)}\n`);
+                        // Apply remote config changes
+                        if (data.payload.maxEventsPerMinute) {
+                            // Dynamic rate limiting from server
+                        }
+                    }
+                }
+                catch { /* ignore */ }
+            };
+        }
+        catch (error) {
+            process.stderr.write(`[TELEMETRY] WebSocket connection failed: ${error}\n`);
+            // Retry
+            this.wsReconnectTimer = setTimeout(() => this.connectWebSocket(), 10000);
+        }
+    }
+    /**
+     * Save event to local fallback file (when server is unreachable).
+     */
+    saveToLocalFallback(event) {
+        try {
+            const frameworkDir = process.env.ATABEY_FRAMEWORK_DIR || path.join(process.cwd(), ".atabey");
+            const telemetryDir = path.join(frameworkDir, "telemetry");
+            if (!fs.existsSync(telemetryDir)) {
+                fs.mkdirSync(telemetryDir, { recursive: true });
+            }
+            const fallbackPath = path.join(telemetryDir, "pending-events.jsonl");
+            fs.appendFileSync(fallbackPath, JSON.stringify(event) + "\n");
+        }
+        catch { /* ignore: best effort */ }
+    }
+    /**
+     * Generate a unique machine ID.
+     */
+    generateMachineId() {
+        try {
+            const hostname = os.hostname();
+            const cpus = os.cpus();
+            const cpuModel = cpus.length > 0 ? cpus[0].model : "unknown";
+            const hash = this.simpleHash(`${hostname}-${cpuModel}`);
+            return `machine-${hash}`;
+        }
+        catch {
+            return `machine-${Math.random().toString(36).substr(2, 8)}`;
+        }
+    }
+    /**
+     * Generate a project hash for grouping.
+     */
+    generateProjectHash() {
+        try {
+            const pkgPath = path.join(process.cwd(), "package.json");
+            if (fs.existsSync(pkgPath)) {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+                return this.simpleHash(pkg.name || pkgPath);
+            }
+        }
+        catch { /* ignore */ }
+        return this.simpleHash(process.cwd());
+    }
+    /**
+     * Simple string hash.
+     */
+    simpleHash(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash; // Convert to 32bit integer
+        }
+        return Math.abs(hash).toString(16).substring(0, 8);
+    }
+    /**
+     * Get streamer status.
+     */
+    getStatus() {
+        return {
+            enabled: CONFIG.ENABLED,
+            serverUrl: CONFIG.SERVER_URL,
+            queueSize: this.queue.length,
+            wsConnected: this.ws?.readyState === WebSocket.OPEN,
+            eventsThisMinute: this.eventCountThisMinute,
+        };
+    }
+}
+// ─── Singleton Export ─────────────────────────────────────────────
+export const telemetryStreamer = TelemetryStreamer.getInstance();
+export { CONFIG as TelemetryConfig };

package/framework-mcp/dist/src/cli/platforms/core.js

@@ -0,0 +1,72 @@
+import fs from "fs";
+import path from "path";
+import { MCP } from "../../shared/constants.js";
+import { writeJsonFile } from "../utils/fs.js";
+import { getPackageRoot } from "../utils/pkg.js";
+import { UI } from "../utils/ui.js";
+import { ADAPTER_CONFIGS, POST_INIT_HANDLERS } from "../../modules/providers/definitions.js";
+export const ADAPTERS = ADAPTER_CONFIGS;
+export const SHIM_FILES = Object.keys(ADAPTERS).map((id) => ADAPTERS[id].shimFile);
+export const FRAMEWORK_DIR_CANDIDATES = [
+    ".atabey",
+    ".cursor",
+    ".claude",
+    ".github",
+    ".grok",
+    ".antigravity",
+    ".agent",
+    ".gemini/antigravity-cli",
+    ".gemini",
+    ".agents",
+    "antigravity-cli"
+];
+export function buildMcpServerEntry(projectRoot) {
+    const packageRoot = getPackageRoot();
+    // Check if we are running in the framework local development repository itself
+    const isLocalFrameworkDev = path.resolve(packageRoot) === path.resolve(projectRoot);
+    let relativePath;
+    if (isLocalFrameworkDev) {
+        // In local framework dev, always use the build path directly relative to project root
+        let mcpServerPath = path.join(packageRoot, MCP.SERVER_DIST_PATH);
+        if (!fs.existsSync(mcpServerPath)) {
+            mcpServerPath = path.join(packageRoot, "../atabey-mcp/dist/index.js");
+        }
+        if (!fs.existsSync(mcpServerPath)) {
+            mcpServerPath = path.join(projectRoot, "node_modules/atabey-mcp/dist/index.js");
+        }
+        if (!fs.existsSync(mcpServerPath)) {
+            UI.warning("  MCP Server not found. Did you run 'npm run build' inside atabey-mcp?");
+        }
+        relativePath = path.relative(projectRoot, mcpServerPath) || mcpServerPath;
+    }
+    else {
+        // If we are initializing in a user's project:
+        // We target the atabey-mcp package which is a dependency of atabey.
+        // This ensures a stable path across different npm/pnpm/yarn setups.
+        relativePath = "node_modules/atabey-mcp/dist/index.js";
+        // Fallback check if it actually exists in a different location during init
+        const localAtabeyPath = path.join(projectRoot, "node_modules/atabey", MCP.SERVER_DIST_PATH);
+        if (!fs.existsSync(path.join(projectRoot, relativePath)) && fs.existsSync(localAtabeyPath)) {
+            relativePath = path.join("node_modules/atabey", MCP.SERVER_DIST_PATH);
+        }
+    }
+    return {
+        command: "node",
+        args: [relativePath],
+        env: {
+            [MCP.PROJECT_ROOT_ENV]: projectRoot,
+        },
+    };
+}
+export function runAdapterPostInit(adapter, projectRoot) {
+    const mcpEntry = buildMcpServerEntry(projectRoot);
+    const mcpBlock = { mcpServers: { [MCP.SERVER_NAME]: mcpEntry } };
+    const postInitFn = POST_INIT_HANDLERS[adapter.id];
+    if (postInitFn) {
+        postInitFn(projectRoot, mcpBlock);
+    }
+    const rootMcpPath = path.join(projectRoot, MCP.ROOT_CONFIG_FILE);
+    if (!fs.existsSync(rootMcpPath)) {
+        writeJsonFile(rootMcpPath, mcpBlock);
+    }
+}

package/framework-mcp/dist/src/cli/platforms/index.js

@@ -0,0 +1,5 @@
+export { ADAPTER_IDS } from "../../modules/providers/types.js";
+export { ADAPTERS, buildMcpServerEntry, FRAMEWORK_DIR_CANDIDATES, runAdapterPostInit } from "./core.js";
+export { mirrorUnifiedAgentsToNative, resolveAgentsDir } from "./paths.js";
+export { scaffoldAgents } from "./scaffold.js";
+export { isAdapterShimFile, remapFrameworkContent, resolveAdapter } from "./utils.js";

package/framework-mcp/dist/src/cli/platforms/paths.js

@@ -0,0 +1,101 @@
+import fs from "fs";
+import path from "path";
+import { ADAPTER_IDS } from "../../modules/providers/types.js";
+import { LEGACY_AGENT_LAYOUT_BASES, UNIFIED_ADAPTER_SLUG, UNIFIED_HUB_DIR, pathJoin, unifiedAdapterPath, } from "../../shared/constants.js";
+import { ADAPTERS } from "./core.js";
+export { CORE_FRAMEWORK_DIR, UNIFIED_ADAPTER_SLUG, UNIFIED_HUB_DIR } from "../../shared/constants.js";
+export function unifiedAdapterRoot(aiToolDir, adapterId) {
+    return pathJoin(aiToolDir, UNIFIED_ADAPTER_SLUG[adapterId]);
+}
+export function resolveAgentsDir(adapterId, isUnified, aiToolDir = UNIFIED_HUB_DIR) {
+    const adapter = ADAPTERS[adapterId];
+    if (!isUnified) {
+        return {
+            agentsDir: adapter.agentsDir ?? pathJoin(adapter.frameworkDir, "agents"),
+            agentsExt: adapter.agentsExt ?? ".md",
+            nestedAntigravity: adapterId === "antigravity-cli",
+        };
+    }
+    const base = unifiedAdapterRoot(aiToolDir, adapterId);
+    switch (adapterId) {
+        case "cursor":
+            return { agentsDir: pathJoin(base, "rules"), agentsExt: ".mdc", nestedAntigravity: false };
+        case "codex":
+            return { agentsDir: pathJoin(base, "instructions"), agentsExt: ".md", nestedAntigravity: false };
+        case "antigravity-cli":
+            // Antigravity CLI expects workspace agents at .agents/agents/{agent_name}/agent.json
+            return { agentsDir: pathJoin(aiToolDir, "agents"), agentsExt: ".json", nestedAntigravity: true };
+        default:
+            return { agentsDir: pathJoin(base, "agents"), agentsExt: ".md", nestedAntigravity: false };
+    }
+}
+export function getUnifiedAgentLayoutBases(aiToolDir = UNIFIED_HUB_DIR) {
+    return ADAPTER_IDS.map((id) => resolveAgentsDir(id, true, aiToolDir).agentsDir);
+}
+const AGENT_INSTRUCTION_CANDIDATES = [
+    (n) => ADAPTER_IDS.flatMap((id) => {
+        const { agentsDir, nestedAntigravity, agentsExt } = resolveAgentsDir(id, true);
+        if (nestedAntigravity) {
+            return [pathJoin(agentsDir, n, "agent.json"), pathJoin(agentsDir, n, "agent.md")];
+        }
+        return [pathJoin(agentsDir, `${n}${agentsExt}`)];
+    }),
+    (n) => LEGACY_AGENT_LAYOUT_BASES.flatMap((base) => {
+        if (base.includes("antigravity")) {
+            return [pathJoin(base, n, "agent.json"), pathJoin(base, n, "agent.md")];
+        }
+        const ext = base.includes("rules") ? ".mdc" : ".md";
+        return [pathJoin(base, `${n}${ext}`)];
+    }),
+];
+export function findAgentInstruction(projectRoot, agentName) {
+    for (const buildPaths of AGENT_INSTRUCTION_CANDIDATES) {
+        for (const rel of buildPaths(agentName)) {
+            const full = path.join(projectRoot, rel);
+            if (fs.existsSync(full))
+                return rel;
+        }
+    }
+    return null;
+}
+export function detectActiveAgentLayouts(projectRoot) {
+    const unified = getUnifiedAgentLayoutBases()
+        .filter((b) => fs.existsSync(path.join(projectRoot, b)));
+    const legacy = LEGACY_AGENT_LAYOUT_BASES
+        .filter((b) => fs.existsSync(path.join(projectRoot, b)));
+    return [...new Set([...unified, ...legacy])];
+}
+function copyDirectoryRecursive(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDirectoryRecursive(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+export function mirrorUnifiedAgentsToNative(projectRoot, adapterId) {
+    const { agentsDir: unifiedDir } = resolveAgentsDir(adapterId, true);
+    const nativeRel = ADAPTERS[adapterId].agentsDir;
+    if (!nativeRel)
+        return;
+    const src = path.join(projectRoot, unifiedDir);
+    const dest = path.join(projectRoot, nativeRel);
+    if (!fs.existsSync(src) || path.resolve(src) === path.resolve(dest))
+        return;
+    if (fs.existsSync(dest)) {
+        fs.rmSync(dest, { recursive: true, force: true });
+    }
+    copyDirectoryRecursive(src, dest);
+}
+/** Cursor global rule destinations (native + unified hub). */
+export function getCursorGlobalRulePaths(projectRoot) {
+    return [
+        path.join(projectRoot, ADAPTERS.cursor.frameworkDir, "rules", "global.mdc"),
+        path.join(projectRoot, unifiedAdapterPath(UNIFIED_ADAPTER_SLUG.cursor, "rules", "global.mdc")),
+    ];
+}

package/framework-mcp/dist/src/cli/platforms/scaffold.js

@@ -0,0 +1,72 @@
+import fs from "fs";
+import path from "path";
+import { ALL_AGENTS, toAntigravityJson, toClaudeCodeMd, toCodexMd, toCursorMdc, toGeminiCliMd } from "../../modules/agents/definitions.js";
+import { writeTextFile } from "../utils/fs.js";
+import { getPackageRoot } from "../utils/pkg.js";
+import { UI } from "../utils/ui.js";
+import { ADAPTERS } from "./core.js";
+export function scaffoldAgents(projectRoot, adapterId, dryRun, agentsToScaffold, explicitDestDir, explicitExt, paths, backendLanguage, _language) {
+    const adapter = ADAPTERS[adapterId];
+    if (!adapter)
+        return;
+    const allowedAgents = agentsToScaffold ? new Set(agentsToScaffold) : undefined;
+    const destAgentsDir = explicitDestDir ? path.join(projectRoot, explicitDestDir) : (adapter.agentsDir ? path.join(projectRoot, adapter.agentsDir) : null);
+    const extension = explicitExt || adapter.agentsExt || ".md";
+    if (!destAgentsDir)
+        return;
+    const baseKnowledgeDir = path.join(getPackageRoot(), "templates/standards");
+    try {
+        if (!dryRun)
+            fs.mkdirSync(destAgentsDir, { recursive: true });
+        for (const agent of ALL_AGENTS) {
+            if (allowedAgents && !allowedAgents.has(agent.name))
+                continue;
+            let content = "";
+            let fileName = `${agent.name}${extension}`;
+            let secondaryContent = null;
+            let secondaryFileName = null;
+            switch (adapterId) {
+                case "gemini":
+                    content = toGeminiCliMd(agent, baseKnowledgeDir, paths, backendLanguage);
+                    break;
+                case "grok":
+                    // Grok uses same Gemini-compatible YAML format
+                    content = toGeminiCliMd(agent, baseKnowledgeDir, paths, backendLanguage);
+                    break;
+                case "claude":
+                    content = toClaudeCodeMd(agent, baseKnowledgeDir, paths, backendLanguage);
+                    break;
+                case "cursor":
+                    content = toCursorMdc(agent, baseKnowledgeDir, paths, backendLanguage);
+                    break;
+                case "codex":
+                    content = toCodexMd(agent, baseKnowledgeDir, paths, backendLanguage);
+                    break;
+                case "antigravity-cli": {
+                    // Antigravity uses nested folders: agents/{name}/agent.json and agents/{name}/agent.md
+                    const agentDir = path.join(destAgentsDir, agent.name);
+                    if (!dryRun)
+                        fs.mkdirSync(agentDir, { recursive: true });
+                    content = toAntigravityJson(agent, baseKnowledgeDir, paths, backendLanguage);
+                    fileName = path.join(agent.name, "agent.json");
+                    secondaryContent = `# [ATABEY] Agent Atabey — @${agent.name}\n\n${agent.instructions.identity}\n\n${agent.instructions.mission}`;
+                    secondaryFileName = path.join(agent.name, "agent.md");
+                    break;
+                }
+                default:
+                    // Fallback to Gemini format
+                    content = toGeminiCliMd(agent, baseKnowledgeDir, paths, backendLanguage);
+                    break;
+            }
+            if (!dryRun) {
+                writeTextFile(path.join(destAgentsDir, fileName), content, dryRun);
+                if (secondaryContent && secondaryFileName) {
+                    writeTextFile(path.join(destAgentsDir, secondaryFileName), secondaryContent, dryRun);
+                }
+            }
+        }
+    }
+    catch (e) {
+        UI.warning(`  Failed to scaffold agents for ${adapterId}: ${e}`);
+    }
+}