atabey 0.0.7 → 0.0.8

package/framework-mcp/dist/src/cli/utils/pkg.js

@@ -0,0 +1,282 @@
+import fs from "fs";
+import path from "path";
+import { writeJsonFile, writeTextFile } from "./fs.js";
+export function getPackageVersion() {
+    const root = getPackageRoot();
+    const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
+    return pkg.version;
+}
+export function getPackageManager() {
+    const override = process.env.AGENT_ATABEY_PACKAGE_MANAGER || process.env.AGENT_ATABEY_PM || process.env.AI_ATABEY_PACKAGE_MANAGER || process.env.AI_ATABEY_PM;
+    if (override)
+        return override.toLowerCase();
+    const userAgent = process.env.npm_config_user_agent || "";
+    const npmExecPath = process.env.npm_execpath || "";
+    if (userAgent.includes("pnpm") || npmExecPath.includes("pnpm"))
+        return "pnpm";
+    if (userAgent.includes("yarn") || npmExecPath.includes("yarn"))
+        return "yarn";
+    // Check for lockfiles in target directory
+    if (fs.existsSync(path.join(process.cwd(), "pnpm-lock.yaml")) || fs.existsSync(path.join(process.cwd(), "pnpm-workspace.yaml")))
+        return "pnpm";
+    if (fs.existsSync(path.join(process.cwd(), "yarn.lock")))
+        return "yarn";
+    return "npm";
+}
+/**
+ * Robustly locates the atabey package root from the currently executing module (src via tsx or bin).
+ * Walks up from import.meta.url until it finds package.json with name === "atabey".
+ * This ensures getValidatorPath() and getPackageVersion() work correctly both in source tree
+ * AND when the package is consumed from node_modules after `npm install atabey` (global or local).
+ * Critical for AL validation (validate-agent-army) and cross-adapter inits to work from npm.
+ */
+function findAgentAtabeyPackageRoot() {
+    let current = path.dirname(new URL(import.meta.url).pathname);
+    const root = path.parse(current).root;
+    while (current !== root) {
+        if (path.basename(current) === "dist") {
+            current = path.dirname(current);
+            continue;
+        }
+        const pkgPath = path.join(current, "package.json");
+        if (fs.existsSync(pkgPath)) {
+            try {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+                if (pkg.name === "atabey") {
+                    return current;
+                }
+            }
+            catch {
+                // ignore parse errors on intermediate package.jsons (e.g. user's project), continue
+            }
+        }
+        current = path.dirname(current);
+    }
+    // Fallback maintains prior behavior for unusual layouts
+    const __filenameLocal = new URL(import.meta.url).pathname;
+    const __dirnameLocal = path.dirname(__filenameLocal);
+    return path.join(__dirnameLocal, "../../..");
+}
+export function getPackageRoot() {
+    return findAgentAtabeyPackageRoot();
+}
+export function getValidatorPath() {
+    return path.join(getPackageRoot(), "bin", "validate-agent-army.js");
+}
+export function getDependencyVersions() {
+    const root = getPackageRoot();
+    const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8"));
+    const devDependencies = pkg.devDependencies || {};
+    const dependencies = pkg.dependencies || {};
+    return {
+        // ── Backend Core ──────────────────────────────────────────
+        "fastify": dependencies["fastify"] || "^5.0.0",
+        "@fastify/cors": dependencies["@fastify/cors"] || "^11.0.0",
+        "@fastify/swagger": dependencies["@fastify/swagger"] || "^9.0.0",
+        "@fastify/swagger-ui": dependencies["@fastify/swagger-ui"] || "^5.0.0",
+        "@fastify/rate-limit": dependencies["@fastify/rate-limit"] || "^10.0.0",
+        "@fastify/static": dependencies["@fastify/static"] || "^8.0.0",
+        "zod": dependencies["zod"] || "^3.24.2",
+        // ── Database / ORM ────────────────────────────────────────
+        "kysely": dependencies["kysely"] || "^0.27.0",
+        "typeorm": dependencies["typeorm"] || "^0.3.0",
+        "reflect-metadata": dependencies["reflect-metadata"] || "^0.2.0",
+        "pg": dependencies["pg"] || "^8.13.0",
+        "better-sqlite3": dependencies["better-sqlite3"] || "^11.0.0",
+        // ── Authentication ────────────────────────────────────────
+        "bcrypt": dependencies["bcrypt"] || "^5.1.0",
+        "@types/bcrypt": devDependencies["@types/bcrypt"] || "^5.0.0",
+        "jsonwebtoken": dependencies["jsonwebtoken"] || "^9.0.0",
+        "@types/jsonwebtoken": devDependencies["@types/jsonwebtoken"] || "^9.0.0",
+        // ── Logging ───────────────────────────────────────────────
+        "pino": dependencies["pino"] || "^9.0.0",
+        "pino-pretty": devDependencies["pino-pretty"] || "^12.0.0",
+        // ── Validation ────────────────────────────────────────────
+        "@fastify/type-provider-typebox": dependencies["@fastify/type-provider-typebox"] || "^5.0.0",
+        // Backend devDependencies
+        "@types/node": devDependencies["@types/node"] || "^22.13.4",
+        "tsx": devDependencies["tsx"] || "^4.19.4",
+        "typescript": devDependencies["typescript"] || "^5.9.3",
+        "vitest-backend": devDependencies["vitest"] || "^3.0.5",
+        // ── Frontend Core ─────────────────────────────────────────
+        "@vitejs/plugin-react": dependencies["@vitejs/plugin-react"] || "^5.0.0",
+        "vite": dependencies["vite"] || "^7.0.0",
+        "react": dependencies["react"] || "^19.0.0",
+        "react-dom": dependencies["react-dom"] || "^19.0.0",
+        "lucide-react": dependencies["lucide-react"] || "^0.468.0",
+        "react-router-dom": dependencies["react-router-dom"] || "^7.0.0",
+        "@tanstack/react-query": dependencies["@tanstack/react-query"] || "^5.0.0",
+        // Frontend devDependencies
+        "@types/react": devDependencies["@types/react"] || "^19.0.0",
+        "@types/react-dom": devDependencies["@types/react-dom"] || "^19.0.0",
+        "vitest-frontend": devDependencies["vitest"] || "^3.0.5",
+        // ── Testing ───────────────────────────────────────────────
+        "@playwright/test": devDependencies["@playwright/test"] || "^1.50.0",
+    };
+}
+export function mergePackageJson(targetPath, sourcePath) {
+    let targetPkg = {};
+    if (fs.existsSync(targetPath)) {
+        try {
+            targetPkg = JSON.parse(fs.readFileSync(targetPath, "utf8"));
+        }
+        catch {
+            console.warn("[WARN]  Could not parse existing package.json, creating a new one.");
+        }
+    }
+    const sourcePkg = JSON.parse(fs.readFileSync(sourcePath, "utf8"));
+    const sanitizeDeps = (deps) => {
+        if (!deps)
+            return deps;
+        const cleaned = {};
+        for (const [name, version] of Object.entries(deps)) {
+            cleaned[name] = (typeof version === "string" && version.startsWith("workspace:")) ? "*" : String(version || "");
+        }
+        return cleaned;
+    };
+    const actualTargetScope = targetPkg.name && targetPkg.name.startsWith("@")
+        ? targetPkg.name.split("/")[0]
+        : (targetPkg.name ? `@${targetPkg.name}` : "");
+    // Cleanup potential leftovers from previous bugged runs where atabey was renamed to target name
+    if (actualTargetScope) {
+        const scopeName = actualTargetScope.startsWith("@") ? actualTargetScope.slice(1) : actualTargetScope;
+        const cleanup = (obj) => {
+            if (!obj)
+                return;
+            delete obj[scopeName];
+            delete obj[actualTargetScope];
+            delete obj["atabey"]; // Will be re-added correctly
+        };
+        cleanup(targetPkg.devDependencies);
+        cleanup(targetPkg.dependencies);
+    }
+    targetPkg.dependencies = sanitizeDeps({
+        ...targetPkg.dependencies,
+        ...sourcePkg.dependencies
+    });
+    // Merge scripts
+    const pkgMgr = getPackageManager();
+    const runCmd = pkgMgr === "yarn" ? "yarn" : (pkgMgr === "pnpm" ? "pnpm" : "npm run");
+    targetPkg.scripts = {
+        ...targetPkg.scripts,
+        "atabey:status": "atabey status",
+        "atabey:trace": "atabey trace:new",
+        "atabey:verify": "atabey verify-contract",
+        "atabey:check": "atabey check",
+        "atabey:test": "vitest run",
+        "atabey:test:watch": "vitest",
+        "atabey:build": `${runCmd} build --prefix framework-mcp`,
+    };
+    const sourceDevDeps = sourcePkg.devDependencies || {};
+    targetPkg.devDependencies = sanitizeDeps({
+        ...targetPkg.devDependencies,
+        "atabey": `^${sourcePkg.version}`,
+        ...(sourceDevDeps["@modelcontextprotocol/sdk"] ? { "@modelcontextprotocol/sdk": sourceDevDeps["@modelcontextprotocol/sdk"] } : {}),
+        ...(sourceDevDeps["zod"] ? { "zod": sourceDevDeps["zod"] } : {}),
+        ...(sourceDevDeps["ts-morph"] ? { "ts-morph": sourceDevDeps["ts-morph"] } : {}),
+        ...(sourceDevDeps["typescript"] ? { "typescript": sourceDevDeps["typescript"] } : {}),
+        ...(sourceDevDeps["@types/node"] ? { "@types/node": sourceDevDeps["@types/node"] } : {}),
+        ...(sourceDevDeps["tsx"] ? { "tsx": sourceDevDeps["tsx"] } : {}),
+        ...(sourceDevDeps["vitest"] ? { "vitest": sourceDevDeps["vitest"] } : {}),
+        "@pandacss/dev": sourceDevDeps["@pandacss/dev"] || "^1.11.1"
+    });
+    if (targetPkg.peerDependencies) {
+        targetPkg.peerDependencies = sanitizeDeps(targetPkg.peerDependencies);
+    }
+    if (targetPkg.optionalDependencies) {
+        targetPkg.optionalDependencies = sanitizeDeps(targetPkg.optionalDependencies);
+    }
+    // Ensure basic fields
+    if (!targetPkg.name)
+        targetPkg.name = path.basename(process.cwd());
+    if (!targetPkg.version)
+        targetPkg.version = "0.1.0";
+    if (!targetPkg.type)
+        targetPkg.type = "module";
+    if (!targetPkg.workspaces)
+        targetPkg.workspaces = ["framework-mcp"];
+    // Add metadata
+    targetPkg.atabey = {
+        version: sourcePkg.version || "0.0.0",
+        initializedAt: new Date().toISOString(),
+    };
+    writeJsonFile(targetPath, targetPkg);
+    console.warn("[OK] package.json updated with Atabey scripts and dependencies.");
+}
+export function sanitizeJson(obj, targetScope = "") {
+    if (typeof obj !== "object" || obj === null)
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(item => sanitizeJson(item, targetScope));
+    const cleaned = {};
+    const record = obj;
+    for (const [key, value] of Object.entries(record)) {
+        let finalKey = key;
+        let finalValue = value;
+        // Remove UnoCSS related keys or values
+        if (typeof key === "string" && key.includes("unocss"))
+            continue;
+        if (typeof value === "string" && value.includes("unocss")) {
+            continue; // Skip this script/field
+        }
+        // Replace scope if needed
+        if (targetScope) {
+            const scopeName = targetScope.startsWith("@") ? targetScope.slice(1) : targetScope;
+            // Handle scoped: @atabey/foo -> @target/foo
+            if (typeof key === "string" && key.startsWith("@atabey/")) {
+                finalKey = key.replace("@atabey/", `${targetScope}/`);
+            }
+            if (typeof value === "string" && value.startsWith("@atabey/")) {
+                finalValue = value.replace("@atabey/", `${targetScope}/`);
+            }
+            // Handle unscoped: atabey-foo -> target-foo
+            if (typeof key === "string" && key.startsWith("atabey-")) {
+                finalKey = key.replace("atabey-", `${scopeName}-`);
+            }
+            if (typeof value === "string" && value.startsWith("atabey-")) {
+                finalValue = value.replace("atabey-", `${scopeName}-`);
+            }
+            // Handle atabey -> target (ONLY for the package name)
+            if (key === "name" && value === "atabey") {
+                finalValue = scopeName;
+            }
+            // Preserve atabey in dependencies and bin
+            // (No action needed as finalKey/finalValue default to original)
+            if (typeof value === "string" && value.startsWith("workspace:")) {
+                finalValue = "*";
+            }
+        }
+        else if (typeof value === "string" && value.startsWith("workspace:")) {
+            finalValue = "*";
+        }
+        cleaned[finalKey] = (typeof finalValue === "object" && finalValue !== null) ? sanitizeJson(finalValue, targetScope) : finalValue;
+    }
+    return cleaned;
+}
+export function deepCleanProtocols(dir, targetScope = "") {
+    if (!fs.existsSync(dir))
+        return;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === "node_modules" || entry.name === ".git")
+                continue;
+            deepCleanProtocols(fullPath, targetScope);
+        }
+        else if (entry.name === "package.json") {
+            try {
+                const content = fs.readFileSync(fullPath, "utf8");
+                const json = JSON.parse(content);
+                const cleaned = JSON.stringify(sanitizeJson(json, targetScope), null, 2);
+                writeTextFile(fullPath, cleaned);
+            }
+            catch {
+                // ignore malformed json
+            }
+        }
+        else if (entry.name === "package-lock.json") {
+            fs.unlinkSync(fullPath);
+        }
+    }
+}

package/framework-mcp/dist/src/cli/utils/schemas.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+export const StateSchema = z.object({
+    phase: z.string(),
+    traceId: z.string(),
+    managerState: z.enum(["ACTIVE", "IDLE", "PAUSED"]),
+});
+export const AgentStatusSchema = z.record(z.object({
+    state: z.enum(["READY", "EXECUTING", "BLOCKED", "TIMEOUT", "WAITING", "IDLE"]),
+    task: z.string(),
+    lastUpdated: z.string().optional(),
+}));
+export const TaskSchema = z.object({
+    traceId: z.string(),
+    description: z.string(),
+    agent: z.string(),
+    priority: z.enum(["P1", "P2", "P3", "HIGH", "NORMAL", "LOW"]),
+    status: z.enum(["PENDING", "IN_PROGRESS", "APPROVED", "COMPLETED"]),
+    createdAt: z.string(),
+});

package/framework-mcp/dist/src/cli/utils/string.js

@@ -0,0 +1,49 @@
+export function insertTaskRow(memoryContent, row) {
+    const sectionHeader = "## ACTIVE TASKS";
+    const tableDivider = "| :--- | :--- | :--- | :--- | :--- |";
+    const sectionIndex = memoryContent.indexOf(sectionHeader);
+    if (sectionIndex === -1)
+        return null;
+    const dividerIndex = memoryContent.indexOf(tableDivider, sectionIndex);
+    if (dividerIndex === -1)
+        return null;
+    const dividerLineEnd = memoryContent.indexOf("\n", dividerIndex);
+    if (dividerLineEnd === -1)
+        return null;
+    return (memoryContent.slice(0, dividerLineEnd + 1) +
+        `${row}\n` +
+        memoryContent.slice(dividerLineEnd + 1));
+}
+export function sanitizeInput(input) {
+    return String(input)
+        .replace(/\\/g, "\\\\")
+        .replace(/"/g, "\\\"")
+        .replace(/[\r\n]+/g, " ")
+        .replace(/<script\b[^>]*>([\s\S]*?)<\/script>/gim, "")
+        .replace(/--/g, "-")
+        .trim();
+}
+export function sanitizeTableCell(value) {
+    return sanitizeInput(String(value)).replace(/\|/g, "\\|");
+}
+export function normalizeAgentName(agent) {
+    return String(agent || "manager").replace(/^@+/, "").trim() || "manager";
+}
+export function normalizePriority(priority) {
+    const normalized = String(priority || "P2").toUpperCase().trim();
+    return /^P[0-3]$/.test(normalized) ? normalized : "P2";
+}
+export function slugifyName(value) {
+    const slug = String(value || "atabey-app")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug || "atabey-app";
+}
+export function titleCase(value) {
+    return String(value || "Atabey App")
+        .replace(/[-_]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .replace(/\b\w/g, (char) => char.toUpperCase());
+}

package/framework-mcp/dist/src/cli/utils/time.js

@@ -0,0 +1,27 @@
+export function generateULID(seedTime = Date.now(), seed) {
+    const ENCODING = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+    const ENCODING_LEN = ENCODING.length;
+    let time = seedTime;
+    const timeChars = new Array(10);
+    for (let i = 9; i >= 0; i--) {
+        timeChars[i] = ENCODING.charAt(time % ENCODING_LEN);
+        time = Math.floor(time / ENCODING_LEN);
+    }
+    const randomChars = new Array(16);
+    if (seed) {
+        let pseudoRandom = seed;
+        for (let i = 0; i < 16; i++) {
+            pseudoRandom = (pseudoRandom * 16807) % 2147483647;
+            randomChars[i] = ENCODING.charAt(pseudoRandom % ENCODING_LEN);
+        }
+    }
+    else {
+        for (let i = 0; i < 16; i++) {
+            randomChars[i] = ENCODING.charAt(Math.floor(Math.random() * ENCODING_LEN));
+        }
+    }
+    return timeChars.join("") + randomChars.join("");
+}
+export function sleep(ms) {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}

package/framework-mcp/dist/src/cli/utils/ui.js

@@ -0,0 +1,58 @@
+import chalk from "chalk";
+/**
+ * Professional UI Utilities for Agent Atabey CLI.
+ * Standardizes headers, status boxes, and strategic intent reporting.
+ */
+export const UI = {
+    /**
+     * Renders a strategic intent block similar to Gemini CLI's topic updates.
+     */
+    intent: (title, intent) => {
+        process.stdout.write(`\n${chalk.bold.cyan(title)}:\n`);
+        process.stdout.write(`${chalk.italic.gray(`  ${intent}`)}\n\n`);
+    },
+    /**
+     * Renders a professional agent execution box.
+     */
+    agentBox: (agentName, action, details) => {
+        const width = process.stdout.columns || 80;
+        const line = "─".repeat(Math.max(0, width - 2));
+        process.stdout.write(chalk.gray(`╭${line}╮`) + "\n");
+        const padding = Math.max(0, width - agentName.length - 27);
+        process.stdout.write(`${chalk.gray("│")} ${chalk.bold.yellow("=")} ${chalk.white(`Running Agent: ${chalk.bold.green(agentName)}...`)} ${chalk.gray("(ctrl+o to expand)".padStart(padding))} ${chalk.gray("│")}\n`);
+        if (action) {
+            const paddingAction = Math.max(0, width - action.length - 6);
+            process.stdout.write(`${chalk.gray("│")} ${chalk.blue("!")} ${chalk.cyan(action)} ${" ".repeat(paddingAction)} ${chalk.gray("│")}\n`);
+        }
+        if (details) {
+            const paddingDetails = Math.max(0, width - details.length - 7);
+            process.stdout.write(`${chalk.gray("│")}   ${chalk.gray(details.slice(0, width - 10))} ${" ".repeat(paddingDetails)} ${chalk.gray("│")}\n`);
+        }
+        process.stdout.write(chalk.gray(`╰${line}╯`) + "\n");
+    },
+    /**
+     * Renders a success status message.
+     */
+    success: (msg) => {
+        process.stdout.write(`${chalk.bold.green("[OK]")} ${msg}\n`);
+    },
+    /**
+     * Renders an error status message.
+     */
+    error: (msg) => {
+        process.stderr.write(`${chalk.bold.red("[ERROR]")} ${chalk.red(msg)}\n`);
+    },
+    /**
+     * Renders a warning status message.
+     */
+    warning: (msg) => {
+        process.stdout.write(`${chalk.bold.yellow("[WARN]")} ${chalk.yellow(msg)}\n`);
+    },
+    /**
+     * Renders an info/divider line.
+     */
+    divider: () => {
+        const width = process.stdout.columns || 80;
+        process.stdout.write(chalk.gray("─".repeat(width)) + "\n");
+    }
+};

package/framework-mcp/dist/src/contracts/index.js

@@ -0,0 +1 @@
+export * from "./tasks.js";

package/framework-mcp/dist/src/contracts/tasks.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+/**
+ * Standard request contract sent to an agent.
+ */
+export const TaskRequestSchema = z.object({
+    traceId: z.string(),
+    task: z.string(),
+    priority: z.enum(["P1", "P2", "P3", "HIGH", "NORMAL", "LOW"]),
+    agent: z.string(),
+    context: z.record(z.unknown()).optional(),
+});
+/**
+ * Standard response contract sent back by an agent.
+ */
+export const TaskResponseSchema = z.object({
+    traceId: z.string(),
+    status: z.enum(["SUCCESS", "FAILED", "RETRY", "WAITING_FOR_APPROVAL"]),
+    message: z.string().optional(),
+    errorCode: z.string().optional(),
+});

package/framework-mcp/dist/src/dashboard/vite.config.js

@@ -0,0 +1,15 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+export default defineConfig({
+    plugins: [react()],
+    build: {
+        outDir: "../../dist/ui",
+        emptyOutDir: true,
+    },
+    server: {
+        port: 3000,
+        proxy: {
+            "/api": "http://localhost:4200"
+        }
+    }
+});

package/framework-mcp/dist/src/modules/adapters/definitions.js

@@ -0,0 +1,140 @@
+import path from "path";
+import { addMcpServerToClaude, findClaudeConfigPath } from "../../cli/utils/claude.js";
+import { writeJsonFile } from "../../shared/fs.js";
+import { registerGlobalAntigravityPlugins } from "./shared.js";
+import { registry } from "./registry.js";
+import { UI } from "../../cli/utils/ui.js";
+// ─── Register Core Adapters ──────────────────────────────────────────────────
+// [GEMINI] Gemini
+registry.register({
+    id: "gemini",
+    frameworkDir: ".gemini",
+    shimFile: "GEMINI.md",
+    shimTemplate: "src/cli/shims/gemini.md",
+    role: "commander",
+    templateDir: ".atabey",
+    nestedDirs: ["agents", "rules"],
+    agentsDir: ".gemini/agents",
+    agentsExt: ".md"
+}, (projectRoot, mcpBlock) => {
+    const frameworkDir = ".gemini";
+    writeJsonFile(path.join(projectRoot, frameworkDir, "mcp.json"), mcpBlock);
+    UI.success(`Gemini MCP registered → ${frameworkDir}/mcp.json`);
+    registerGlobalAntigravityPlugins(mcpBlock);
+});
+// [START] Claude
+registry.register({
+    id: "claude",
+    frameworkDir: ".claude",
+    shimFile: "CLAUDE.md",
+    shimTemplate: "src/cli/shims/claude.md",
+    role: "architect",
+    templateDir: ".atabey",
+    nestedDirs: ["agents", "rules"],
+    agentsDir: ".claude/agents",
+    agentsExt: ".md"
+}, (projectRoot, mcpBlock) => {
+    const configPath = findClaudeConfigPath();
+    if (configPath) {
+        const block = mcpBlock;
+        const mcpEntry = block.mcpServers["atabey"];
+        const ok = addMcpServerToClaude(configPath, "atabey", mcpEntry);
+        if (ok)
+            UI.success(`Claude MCP registered → ${configPath}`);
+    }
+    const frameworkDir = ".claude";
+    writeJsonFile(path.join(projectRoot, frameworkDir, "mcp_config.json"), mcpBlock);
+    writeJsonFile(path.join(projectRoot, ".mcp.json"), mcpBlock);
+    UI.success("Claude Code Project MCP → .mcp.json");
+});
+// [AI] Grok
+registry.register({
+    id: "grok",
+    frameworkDir: ".grok",
+    shimFile: "GROK.md",
+    shimTemplate: "src/cli/shims/grok.md",
+    role: "researcher",
+    templateDir: ".atabey",
+    nestedDirs: ["agents", "rules"],
+    agentsDir: ".grok/agents",
+    agentsExt: ".md"
+}, (projectRoot, mcpBlock) => {
+    const frameworkDir = ".grok";
+    writeJsonFile(path.join(projectRoot, frameworkDir, "mcp_config.json"), mcpBlock);
+    UI.success(`Grok MCP → ${frameworkDir}/mcp_config.json`);
+});
+// [CURSOR] Cursor
+registry.register({
+    id: "cursor",
+    frameworkDir: ".cursor",
+    shimFile: "CURSOR.md",
+    shimTemplate: "src/cli/shims/cursor.mdc",
+    role: "implementer",
+    templateDir: ".atabey",
+    nestedDirs: ["rules"],
+    agentsDir: ".cursor/rules",
+    agentsExt: ".mdc"
+}, (projectRoot, mcpBlock) => {
+    const frameworkDir = ".cursor";
+    writeJsonFile(path.join(projectRoot, frameworkDir, "mcp.json"), mcpBlock);
+    UI.success(`Cursor IDE Project MCP → ${frameworkDir}/mcp.json`);
+});
+// [TIP] Codex (Copilot)
+registry.register({
+    id: "codex",
+    frameworkDir: ".agents",
+    shimFile: "copilot-instructions.md",
+    shimTemplate: "src/cli/shims/codex.md",
+    role: "implementer",
+    templateDir: ".atabey",
+    nestedDirs: ["skills", "rules", "instructions"],
+    agentsDir: ".agents/instructions",
+    agentsExt: ".md"
+}, (projectRoot, mcpBlock) => {
+    const frameworkDir = ".agents";
+    writeJsonFile(path.join(projectRoot, frameworkDir, "mcp_config.json"), mcpBlock);
+    writeJsonFile(path.join(projectRoot, ".vscode/mcp.json"), mcpBlock);
+    writeJsonFile(path.join(projectRoot, ".mcp.json"), mcpBlock);
+    UI.success("GitHub Copilot Project MCP → .vscode/mcp.json & .mcp.json");
+});
+// [LOCAL] Local LLM (Ollama / Private AI)
+registry.register({
+    id: "local",
+    frameworkDir: ".atabey",
+    shimFile: "LOCAL_AI.md",
+    shimTemplate: "src/cli/shims/local.md",
+    role: "commander",
+    templateDir: ".atabey",
+    nestedDirs: ["agents", "rules"],
+    agentsDir: ".atabey/agents",
+    agentsExt: ".md"
+}, (projectRoot, mcpBlock) => {
+    const frameworkDir = ".atabey";
+    writeJsonFile(path.join(projectRoot, frameworkDir, "mcp_config.json"), mcpBlock);
+    UI.success(`Local LLM MCP (Ollama/Private AI) registered → ${frameworkDir}/mcp_config.json`);
+});
+// [ANTIGRAVITY] Antigravity
+registry.register({
+    id: "antigravity-cli",
+    frameworkDir: ".agents",
+    shimFile: "AGENTS.md",
+    shimTemplate: "src/cli/shims/antigravity-cli.md",
+    role: "general",
+    templateDir: ".atabey",
+    nestedDirs: ["agents", "plugins", "rules"],
+    agentsDir: ".agents/agents",
+    agentsExt: ".md"
+}, (projectRoot, mcpBlock) => {
+    const frameworkDir = ".agents";
+    writeJsonFile(path.join(projectRoot, frameworkDir, "mcp_config.json"), mcpBlock);
+    UI.success(`Antigravity CLI MCP → ${frameworkDir}/mcp_config.json`);
+    registerGlobalAntigravityPlugins(mcpBlock);
+});
+/**
+ * Mapped Adapter Configurations
+ */
+export const ADAPTER_CONFIGS = registry.getConfigs();
+/**
+ * Post-Initialization Handlers for specific adapters
+ */
+export const POST_INIT_HANDLERS = registry.getHandlers();

package/framework-mcp/dist/src/modules/adapters/registry.js

@@ -0,0 +1,18 @@
+class AdapterRegistry {
+    configs = new Map();
+    handlers = new Map();
+    register(config, handler) {
+        this.configs.set(config.id, config);
+        this.handlers.set(config.id, handler);
+    }
+    getConfigs() {
+        return Object.fromEntries(this.configs);
+    }
+    getHandlers() {
+        return Object.fromEntries(this.handlers);
+    }
+    getIds() {
+        return Array.from(this.configs.keys());
+    }
+}
+export const registry = new AdapterRegistry();