atabey 0.0.7 → 0.0.9

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

@@ -0,0 +1,207 @@
+import Database from "better-sqlite3";
+import path from "path";
+import fs from "fs";
+import { getFrameworkDir } from "./memory.js";
+/**
+ * [DB] Atabey Storage Engine
+ * Central SQLite database for enterprise-scale agent state management.
+ */
+export class Storage {
+    static db = null;
+    static getDB() {
+        if (!this.db) {
+            const frameworkDir = getFrameworkDir();
+            if (!fs.existsSync(frameworkDir)) {
+                fs.mkdirSync(frameworkDir, { recursive: true });
+            }
+            const dbPath = path.join(frameworkDir, "atabey.db");
+            this.db = new Database(dbPath);
+            this.initializeSchema();
+        }
+        return this.db;
+    }
+    static initializeSchema() {
+        const db = this.db;
+        // Agents Table
+        db.exec(`
+            CREATE TABLE IF NOT EXISTS agents (
+                name TEXT PRIMARY KEY,
+                state TEXT DEFAULT 'READY',
+                task TEXT DEFAULT 'Idle',
+                last_updated DATETIME DEFAULT CURRENT_TIMESTAMP
+            )
+        `);
+        // Messages (Hermes) Table
+        db.exec(`
+            CREATE TABLE IF NOT EXISTS messages (
+                id INTEGER PRIMARY KEY AUTOINCREMENT,
+                timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
+                sender TEXT,
+                receiver TEXT,
+                category TEXT,
+                content TEXT,
+                trace_id TEXT,
+                parent_id TEXT,
+                status TEXT DEFAULT 'PENDING',
+                priority TEXT DEFAULT 'NORMAL',
+                requires_approval BOOLEAN DEFAULT 0
+            )
+        `);
+        // Tasks Table
+        db.exec(`
+            CREATE TABLE IF NOT EXISTS tasks (
+                id TEXT PRIMARY KEY,
+                trace_id TEXT,
+                description TEXT,
+                agent TEXT,
+                status TEXT DEFAULT 'PENDING',
+                priority TEXT DEFAULT 'NORMAL',
+                dependencies TEXT, -- JSON Array
+                created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+            )
+        `);
+        // Logs Table
+        db.exec(`
+            CREATE TABLE IF NOT EXISTS logs (
+                id INTEGER PRIMARY KEY AUTOINCREMENT,
+                timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
+                agent TEXT,
+                action TEXT,
+                trace_id TEXT,
+                status TEXT,
+                summary TEXT,
+                findings TEXT
+            )
+        `);
+        // Metadata (State) Table
+        db.exec(`
+            CREATE TABLE IF NOT EXISTS metadata (
+                key TEXT PRIMARY KEY,
+                value TEXT
+            )
+        `);
+    }
+    // --- Agent Operations ---
+    static updateAgentStatus(name, state, task, lastUpdated) {
+        const db = this.getDB();
+        const cleanName = name.replace("@", "");
+        const timestamp = lastUpdated || new Date().toISOString();
+        db.prepare(`
+            INSERT INTO agents (name, state, task, last_updated) 
+            VALUES (?, ?, ?, ?)
+            ON CONFLICT(name) DO UPDATE SET 
+                state = excluded.state,
+                task = excluded.task,
+                last_updated = excluded.last_updated
+        `).run(cleanName, state, task, timestamp);
+    }
+    static getAllAgents() {
+        return this.getDB().prepare("SELECT * FROM agents").all();
+    }
+    // --- Message Operations ---
+    static saveMessage(msg) {
+        const db = this.getDB();
+        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);
+    }
+    static getPendingMessages() {
+        const rows = this.getDB().prepare("SELECT * FROM messages WHERE status IN ('PENDING', 'APPROVED') ORDER BY priority DESC, timestamp ASC").all();
+        return rows.map(r => ({
+            id: r.id,
+            timestamp: r.timestamp,
+            from: r.sender,
+            to: r.receiver,
+            category: r.category,
+            content: r.content,
+            traceId: r.trace_id,
+            parentId: r.parent_id || undefined,
+            status: r.status,
+            priority: r.priority,
+            requiresApproval: r.requires_approval === 1
+        }));
+    }
+    static updateMessageStatus(id, status) {
+        this.getDB().prepare("UPDATE messages SET status = ? WHERE id = ?").run(status, id);
+    }
+    // --- Task Operations ---
+    static saveTask(task) {
+        const db = this.getDB();
+        db.prepare(`
+            INSERT INTO tasks (id, trace_id, description, agent, status, priority, dependencies)
+            VALUES (?, ?, ?, ?, ?, ?, ?)
+            ON CONFLICT(id) DO UPDATE SET
+                status = excluded.status,
+                description = excluded.description
+        `).run(task.id, task.traceId, task.description, task.agent, task.status, task.priority, JSON.stringify(task.dependencies || []));
+    }
+    static getTasks(traceId) {
+        const db = this.getDB();
+        let rows;
+        if (traceId) {
+            rows = db.prepare("SELECT * FROM tasks WHERE trace_id = ?").all(traceId);
+        }
+        else {
+            rows = db.prepare("SELECT * FROM tasks").all();
+        }
+        return rows.map(r => {
+            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 {
+                // Keep empty array
+            }
+            return {
+                id: r.id,
+                traceId: r.trace_id,
+                description: r.description,
+                agent: r.agent,
+                status: r.status,
+                priority: r.priority,
+                dependencies: deps
+            };
+        });
+    }
+    static getLogs(agentName) {
+        const db = this.getDB();
+        let rows;
+        const cleanName = agentName ? agentName.replace("@", "") : undefined;
+        if (cleanName) {
+            rows = db.prepare("SELECT * FROM logs WHERE agent = ? ORDER BY timestamp DESC").all(cleanName);
+        }
+        else {
+            rows = db.prepare("SELECT * FROM logs ORDER BY timestamp DESC").all();
+        }
+        return rows.map(r => ({
+            id: r.id,
+            timestamp: r.timestamp,
+            agent: r.agent,
+            action: r.action,
+            trace_id: r.trace_id || undefined,
+            status: r.status,
+            summary: r.summary,
+            findings: r.findings || undefined
+        }));
+    }
+    // --- Metadata Operations ---
+    static setMetadata(key, value) {
+        this.getDB().prepare(`
+            INSERT INTO metadata (key, value) VALUES (?, ?)
+            ON CONFLICT(key) DO UPDATE SET value = excluded.value
+        `).run(key, value);
+    }
+    static getMetadata(key) {
+        const row = this.getDB().prepare("SELECT value FROM metadata WHERE key = ?").get(key);
+        return row ? row.value : null;
+    }
+    static reset() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+}

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

@@ -0,0 +1,12 @@
+/**
+ * Agent Atabey Framework — Internal Branded Types
+ * Used to enforce absolute type safety within the core orchestration logic.
+ */
+/**
+ * Casts a raw string to a Branded Type.
+ * Use this only at the boundaries of the system.
+ */
+export function asTraceID(val) { return val; }
+export function asAgentID(val) { return val; }
+export function asPhaseID(val) { return val; }
+export function asProjectPath(val) { return val; }

package/framework-mcp/dist/index.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { TOOLS, toolHandlers } from "./tools/index.js";
+import { RESOURCES, handleReadResource } from "./resources/index.js";
+// ─── Server Setup ─────────────────────────────────────────────────
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+// Robustly find package.json by walking up from __dirname
+function findPackageJson(startDir) {
+    let currentDir = startDir;
+    while (currentDir !== path.parse(currentDir).root) {
+        const pkgPath = path.join(currentDir, "package.json");
+        if (fs.existsSync(pkgPath))
+            return pkgPath;
+        currentDir = path.dirname(currentDir);
+    }
+    throw new Error("Could not find package.json for atabey-mcp");
+}
+const pkgPath = findPackageJson(__dirname);
+const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+const serverVersion = pkg.version;
+const server = new Server({
+    name: "atabey-mcp",
+    version: serverVersion,
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+// Basic Schema Validator for Required Fields
+function validateArgs(toolName, args) {
+    const definition = TOOLS.find(t => t.name === toolName);
+    if (!definition)
+        return `Unknown tool: ${toolName}`;
+    const required = definition.inputSchema.required || [];
+    for (const field of required) {
+        if (args[field] === undefined || args[field] === null || args[field] === "") {
+            return `Missing required argument: '${field}' for tool '${toolName}'`;
+        }
+    }
+    return null;
+}
+server.setRequestHandler(ListToolsRequestSchema, async (request) => {
+    // 2026 Stateless Spec: Log client info from metadata if available
+    const meta = request._meta;
+    if (meta) {
+        process.stderr.write(`[MCP] Stateless ListTools from ${meta.client?.name || "unknown"} v${meta.client?.version || "?.?"}\n`);
+    }
+    return { tools: TOOLS };
+});
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    return { resources: RESOURCES };
+});
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const uri = request.params.uri;
+    try {
+        const content = await handleReadResource(uri);
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: "text/markdown",
+                    text: content,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to read resource: ${message}`, { cause: error });
+    }
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const req = request;
+    const { name, arguments: args } = req.params;
+    const meta = request._meta;
+    // 2026 Stateless Spec: Prioritize metadata-driven context
+    if (meta) {
+        process.stderr.write(`[MCP] Stateless CallTool: ${name} (Client: ${meta.client?.name || "unknown"})\n`);
+    }
+    const projectRoot = process.env.ATABEY_PROJECT_ROOT || process.cwd();
+    try {
+        const handler = toolHandlers[name];
+        if (!handler) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `[ERROR] Unknown tool: ${name}` }],
+            };
+        }
+        // [SECURITY] Runtime Validation
+        const validationError = validateArgs(name, args || {});
+        if (validationError) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `[ERROR] Validation Error: ${validationError}` }],
+            };
+        }
+        return await handler(projectRoot, args || {});
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+            isError: true,
+            content: [{ type: "text", text: `[ERROR] Execution failed: ${message}` }],
+        };
+    }
+});
+// ─── Graceful Startup & Shutdown ──────────────────────────────────
+async function run() {
+    const transport = new StdioServerTransport();
+    // Prevent unhandled errors from crashing the MCP stream
+    process.on("uncaughtException", (error) => {
+        process.stderr.write(`[atabey-mcp] Uncaught exception: ${error.message}
+`);
+    });
+    process.on("unhandledRejection", (reason) => {
+        const message = reason instanceof Error ? reason.message : String(reason);
+        process.stderr.write(`[atabey-mcp] Unhandled rejection: ${message}
+`);
+    });
+    // Graceful shutdown on SIGINT/SIGTERM
+    const shutdown = async () => {
+        try {
+            await server.close();
+        }
+        catch {
+            // Already closed or failed — safe to ignore
+        }
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    await server.connect(transport);
+}
+run().catch((error) => {
+    process.stderr.write(`[atabey-mcp] Fatal startup error: ${error.message}
+`);
+    process.exit(1);
+});

package/framework-mcp/dist/resources/index.js

@@ -0,0 +1,58 @@
+import { Storage } from "../../../src/shared/storage.js";
+/**
+ * [DATA] MCP Resource Definitions
+ */
+export const RESOURCES = [
+    {
+        uri: "atabey://army/status",
+        name: "Agent Army Status",
+        description: "Real-time state and active tasks of all specialized agents.",
+        mimeType: "text/markdown"
+    },
+    {
+        uri: "atabey://plan/active",
+        name: "Active Execution Plan",
+        description: "The current DAG of tasks and their completion status.",
+        mimeType: "text/markdown"
+    },
+    {
+        uri: "atabey://memory/project",
+        name: "Project Memory",
+        description: "The central source of truth for project context (PROJECT_MEMORY.md).",
+        mimeType: "text/markdown"
+    }
+];
+export async function handleReadResource(uri) {
+    if (uri === "atabey://army/status") {
+        const agents = Storage.getAllAgents();
+        let md = "# [AI] Agent Army Status\n\n| Agent | State | Active Task | Last Updated |\n| :--- | :--- | :--- | :--- |\n";
+        agents.forEach((a) => {
+            md += `| @${a.name} | ${a.state} | ${a.task} | ${a.last_updated} |\n`;
+        });
+        return md;
+    }
+    if (uri === "atabey://plan/active") {
+        const tasks = Storage.getTasks();
+        let md = "# 📋 Active Execution Plan\n\n| ID | Task | Agent | Status | Dependencies |\n| :--- | :--- | :--- | :--- | :--- |\n";
+        tasks.forEach((t) => {
+            const deps = t.dependencies.join(", ") || "-";
+            md += `| ${t.id} | ${t.description} | ${t.agent} | ${t.status} | ${deps} |\n`;
+        });
+        return md;
+    }
+    if (uri === "atabey://memory/project") {
+        const fs = await import("fs");
+        const path = await import("path");
+        const { getFrameworkDir } = await import("../../../src/cli/utils/memory.js");
+        const projectRoot = process.env.ATABEY_PROJECT_ROOT || process.cwd();
+        const fwDir = getFrameworkDir();
+        const p = path.isAbsolute(fwDir)
+            ? path.join(fwDir, "memory", "PROJECT_MEMORY.md")
+            : path.join(projectRoot, fwDir, "memory", "PROJECT_MEMORY.md");
+        if (fs.existsSync(p)) {
+            return fs.readFileSync(p, "utf8");
+        }
+        return "Project memory not found. Run 'atabey init' first.";
+    }
+    throw new Error(`Unknown resource URI: ${uri}`);
+}

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

@@ -0,0 +1,71 @@
+import fs from "fs";
+import path from "path";
+import { writeJsonFile } from "../utils/fs.js";
+import { getPackageRoot } from "../utils/pkg.js";
+import { MCP } from "../../shared/constants.js";
+import { ADAPTER_CONFIGS, POST_INIT_HANDLERS } from "../../modules/adapters/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)) {
+            console.warn("[WARN]  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/adapters/index.js

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

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

@@ -0,0 +1,101 @@
+import fs from "fs";
+import path from "path";
+import { ADAPTER_IDS } from "../../modules/adapters/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_HUB_DIR, UNIFIED_ADAPTER_SLUG, } 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/adapters/scaffold.js

@@ -0,0 +1,71 @@
+import { writeTextFile } from "../utils/fs.js";
+import path from "path";
+import fs from "fs";
+import { getPackageRoot } from "../utils/pkg.js";
+import { ALL_AGENTS, toClaudeCodeMd, toGeminiCliMd, toCodexMd, toAntigravityJson, toCursorMdc } from "../../modules/agents/definitions.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) {
+        console.warn(`[WARN]  Failed to scaffold agents for ${adapterId}: ${e}`);
+    }
+}