atabey 0.0.6 → 0.0.8

package/{src/cli/adapters/core.ts → framework-mcp/dist/src/cli/adapters/core.js}

@@ -2,14 +2,10 @@ 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";
-import type { AdapterConfig, AdapterId } from "../../modules/adapters/types.js";
-
-export const ADAPTERS: Record<AdapterId, AdapterConfig> = ADAPTER_CONFIGS;
-
-export const SHIM_FILES = (Object.keys(ADAPTERS) as AdapterId[]).map((id) => ADAPTERS[id].shimFile);
-
+export const ADAPTERS = ADAPTER_CONFIGS;
+export const SHIM_FILES = Object.keys(ADAPTERS).map((id) => ADAPTERS[id].shimFile);
 export const FRAMEWORK_DIR_CANDIDATES = [
     ".atabey",
     ".cursor",
@@ -22,69 +18,53 @@ export const FRAMEWORK_DIR_CANDIDATES = [
     ".gemini",
     ".agents",
     "antigravity-cli"
-] as const;
-
-export function buildMcpServerEntry(projectRoot: string) {
+];
+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: string;
-
+    let relativePath;
     if (isLocalFrameworkDev) {
         // In local framework dev, always use the build path directly relative to project root
-        let mcpServerPath = path.join(packageRoot, "framework-mcp/dist/index.js");
+        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("⚠️  MCP Server not found. Did you run 'npm run build' inside atabey-mcp?");
+            console.warn("[WARN]  MCP Server not found. Did you run 'npm run build' inside atabey-mcp?");
         }
         relativePath = path.relative(projectRoot, mcpServerPath) || mcpServerPath;
-    } else {
+    }
+    else {
         // If we are initializing in a user's project:
-        // We want to target the local node_modules of the user's project.
-        // Even if node_modules is not populated yet (e.g. running via npx before npm install),
-        // we should write the local node_modules path so that it will work once installed.
-        
-        const localAtabeyPath = path.join(projectRoot, "node_modules/atabey/framework-mcp/dist/index.js");
-        const localScopedPath = path.join(projectRoot, "node_modules/atabey-mcp/dist/index.js");
-
-        if (fs.existsSync(localScopedPath)) {
-            relativePath = path.relative(projectRoot, localScopedPath);
-        } else if (fs.existsSync(localAtabeyPath)) {
-            relativePath = path.relative(projectRoot, localAtabeyPath);
-        } else {
-            // Default to the standard relative local path in node_modules/atabey
-            // This is clean and portable across machines/developers.
-            relativePath = "node_modules/atabey/framework-mcp/dist/index.js";
+        // 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: {
-            ATABEY_PROJECT_ROOT: projectRoot,
+            [MCP.PROJECT_ROOT_ENV]: projectRoot,
         },
     };
 }
-
-export function runAdapterPostInit(adapter: AdapterConfig, projectRoot: string): void {
+export function runAdapterPostInit(adapter, projectRoot) {
     const mcpEntry = buildMcpServerEntry(projectRoot);
-    const mcpBlock = { mcpServers: { "atabey": mcpEntry } };
-
+    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.json");
+    const rootMcpPath = path.join(projectRoot, MCP.ROOT_CONFIG_FILE);
     if (!fs.existsSync(rootMcpPath)) {
         writeJsonFile(rootMcpPath, mcpBlock);
     }

package/{src/cli/adapters/index.ts → framework-mcp/dist/src/cli/adapters/index.js}

@@ -1,4 +1,4 @@
-export { ADAPTER_IDS, type AdapterConfig, type AdapterId, type AdapterRole } from "../../modules/adapters/types.js";
+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";

package/{src/cli/adapters/paths.ts → framework-mcp/dist/src/cli/adapters/paths.js}

@@ -1,39 +1,14 @@
 import fs from "fs";
 import path from "path";
-import type { AdapterId } from "../../modules/adapters/types.js";
 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 { 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 interface AgentsDestination {
-    agentsDir: string;
-    agentsExt: string;
-    nestedAntigravity: boolean;
-}
-
-export function unifiedAdapterRoot(aiToolDir: string, adapterId: AdapterId): string {
+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: AdapterId,
-    isUnified: boolean,
-    aiToolDir: string = UNIFIED_HUB_DIR,
-): AgentsDestination {
+export function resolveAgentsDir(adapterId, isUnified, aiToolDir = UNIFIED_HUB_DIR) {
     const adapter = ADAPTERS[adapterId];
-
     if (!isUnified) {
         return {
             agentsDir: adapter.agentsDir ?? pathJoin(adapter.frameworkDir, "agents"),
@@ -41,9 +16,7 @@ export function resolveAgentsDir(
             nestedAntigravity: adapterId === "antigravity-cli",
         };
     }
-
     const base = unifiedAdapterRoot(aiToolDir, adapterId);
-
     switch (adapterId) {
         case "cursor":
             return { agentsDir: pathJoin(base, "rules"), agentsExt: ".mdc", nestedAntigravity: false };
@@ -56,12 +29,10 @@ export function resolveAgentsDir(
             return { agentsDir: pathJoin(base, "agents"), agentsExt: ".md", nestedAntigravity: false };
     }
 }
-
-export function getUnifiedAgentLayoutBases(aiToolDir: string = UNIFIED_HUB_DIR): string[] {
+export function getUnifiedAgentLayoutBases(aiToolDir = UNIFIED_HUB_DIR) {
     return ADAPTER_IDS.map((id) => resolveAgentsDir(id, true, aiToolDir).agentsDir);
 }
-
-const AGENT_INSTRUCTION_CANDIDATES: Array<(name: string) => string[]> = [
+const AGENT_INSTRUCTION_CANDIDATES = [
     (n) => ADAPTER_IDS.flatMap((id) => {
         const { agentsDir, nestedAntigravity, agentsExt } = resolveAgentsDir(id, true);
         if (nestedAntigravity) {
@@ -77,57 +48,52 @@ const AGENT_INSTRUCTION_CANDIDATES: Array<(name: string) => string[]> = [
         return [pathJoin(base, `${n}${ext}`)];
     }),
 ];
-
-export function findAgentInstruction(projectRoot: string, agentName: string): string | null {
+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;
+            if (fs.existsSync(full))
+                return rel;
         }
     }
     return null;
 }
-
-export function detectActiveAgentLayouts(projectRoot: string): string[] {
+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: string, dest: string): void {
+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 {
+        }
+        else {
             fs.copyFileSync(srcPath, destPath);
         }
     }
 }
-
-export function mirrorUnifiedAgentsToNative(projectRoot: string, adapterId: AdapterId): void {
+export function mirrorUnifiedAgentsToNative(projectRoot, adapterId) {
     const { agentsDir: unifiedDir } = resolveAgentsDir(adapterId, true);
     const nativeRel = ADAPTERS[adapterId].agentsDir;
-    if (!nativeRel) return;
-
+    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(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: string): string[] {
+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/{src/cli/adapters/scaffold.ts → framework-mcp/dist/src/cli/adapters/scaffold.js}

@@ -2,51 +2,28 @@ 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 type { AdapterId } from "../../modules/adapters/types.js";
+import { ALL_AGENTS, toClaudeCodeMd, toGeminiCliMd, toCodexMd, toAntigravityJson, toCursorMdc } from "../../modules/agents/definitions.js";
 import { ADAPTERS } from "./core.js";
-
-export function scaffoldAgents(
-    projectRoot: string, 
-    adapterId: AdapterId, 
-    dryRun: boolean, 
-    agentsToScaffold?: string[],
-    explicitDestDir?: string,
-    explicitExt?: string,
-    paths?: Record<string, string>,
-    backendLanguage?: string,
-    _language?: string
-): void {
+export function scaffoldAgents(projectRoot, adapterId, dryRun, agentsToScaffold, explicitDestDir, explicitExt, paths, backendLanguage, _language) {
     const adapter = ADAPTERS[adapterId];
-    if (!adapter) return;
-
+    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;
-
+    if (!destAgentsDir)
+        return;
     const baseKnowledgeDir = path.join(getPackageRoot(), "templates/standards");
-
     try {
-        if (!dryRun) fs.mkdirSync(destAgentsDir, { recursive: true });
-
+        if (!dryRun)
+            fs.mkdirSync(destAgentsDir, { recursive: true });
         for (const agent of ALL_AGENTS) {
-            if (allowedAgents && !allowedAgents.has(agent.name)) continue;
-            
+            if (allowedAgents && !allowedAgents.has(agent.name))
+                continue;
             let content = "";
             let fileName = `${agent.name}${extension}`;
-            let secondaryContent: string | null = null;
-            let secondaryFileName: string | null = null;
-
+            let secondaryContent = null;
+            let secondaryFileName = null;
             switch (adapterId) {
                 case "gemini":
                     content = toGeminiCliMd(agent, baseKnowledgeDir, paths, backendLanguage);
@@ -67,12 +44,11 @@ export function scaffoldAgents(
                 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 });
-                    
+                    if (!dryRun)
+                        fs.mkdirSync(agentDir, { recursive: true });
                     content = toAntigravityJson(agent, baseKnowledgeDir, paths, backendLanguage);
                     fileName = path.join(agent.name, "agent.json");
-                    
-                    secondaryContent = `# 🎖️ Agent Atabey — @${agent.name}\n\n${agent.instructions.identity}\n\n${agent.instructions.mission}`;
+                    secondaryContent = `# [ATABEY] Agent Atabey — @${agent.name}\n\n${agent.instructions.identity}\n\n${agent.instructions.mission}`;
                     secondaryFileName = path.join(agent.name, "agent.md");
                     break;
                 }
@@ -81,7 +57,6 @@ export function scaffoldAgents(
                     content = toGeminiCliMd(agent, baseKnowledgeDir, paths, backendLanguage);
                     break;
             }
-
             if (!dryRun) {
                 writeTextFile(path.join(destAgentsDir, fileName), content, dryRun);
                 if (secondaryContent && secondaryFileName) {
@@ -89,7 +64,8 @@ export function scaffoldAgents(
                 }
             }
         }
-    } catch (e) {
-        console.warn(`⚠️  Failed to scaffold agents for ${adapterId}: ${e}`);
+    }
+    catch (e) {
+        console.warn(`[WARN]  Failed to scaffold agents for ${adapterId}: ${e}`);
     }
 }

package/{src/cli/adapters/utils.ts → framework-mcp/dist/src/cli/adapters/utils.js}

@@ -2,46 +2,34 @@ import fs from "fs";
 import path from "path";
 import { logger } from "../../shared/logger.js";
 import { UI } from "../utils/ui.js";
-
-import type { AdapterConfig, AdapterId } from "../../modules/adapters/types.js";
 import { ADAPTERS, SHIM_FILES } from "./core.js";
-
-export function resolveAdapter(input?: string): AdapterConfig {
+export function resolveAdapter(input) {
     let normalized = (input || "gemini").toLowerCase();
     if (normalized === "antigravity") {
         normalized = "antigravity-cli";
-    } else if (normalized === "copilot" || normalized === "github") {
+    }
+    else if (normalized === "copilot" || normalized === "github") {
         normalized = "codex";
     }
-
-    let config: AdapterConfig;
+    let config;
     if (normalized in ADAPTERS) {
-        config = { ...ADAPTERS[normalized as AdapterId] };
-    } else {
+        config = { ...ADAPTERS[normalized] };
+    }
+    else {
         UI.warning(`Unknown adapter "${input}". Falling back to gemini.`);
         config = { ...ADAPTERS.gemini };
     }
-
     return config;
 }
-
-export function isAdapterShimFile(fileName: string): boolean {
+export function isAdapterShimFile(fileName) {
     return SHIM_FILES.includes(fileName);
 }
-
-export function remapFrameworkContent(
-    content: string,
-    frameworkDir: string,
-    adapterId: AdapterId,
-): string {
+export function remapFrameworkContent(content, frameworkDir, adapterId) {
     let result = content;
-
     result = result.replace(/\{\{FRAMEWORK_DIR\}\}/g, frameworkDir);
     result = result.replace(/\{\{ADAPTER\}\}/g, adapterId);
-
     let agentFolder = "agents";
     let knowledgeFolder = "knowledge";
-
     if (frameworkDir !== ".atabey") {
         if (adapterId === "antigravity-cli") {
             agentFolder = "agents";
@@ -50,15 +38,12 @@ export function remapFrameworkContent(
         // Note: Grok uses the same directory structure as Gemini (".grok/agents").
         // No override needed — default agentFolder = "agents" is correct.
     }
-
     const frameworkPattern = ".atabey/";
     result = result.replace(new RegExp(frameworkPattern + "agents/", "g"), `${frameworkDir}/${agentFolder}/`);
     result = result.replace(new RegExp(frameworkPattern + "knowledge/", "g"), `${frameworkDir}/${knowledgeFolder}/`);
-
     result = result.replace(/\.atabey\//g, `${frameworkDir}/`);
     result = result.replace(/`\.atabey`/g, `\`${frameworkDir}\``);
     result = result.replace(/\.atabey(?![\w/-])/g, frameworkDir);
-
     let backend = "apps/backend";
     let frontend = "apps/web";
     let docs = "docs";
@@ -68,20 +53,23 @@ export function remapFrameworkContent(
         if (fs.existsSync(configPath)) {
             const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
             if (config.paths) {
-                if (config.paths.backend) backend = config.paths.backend;
-                if (config.paths.frontend) frontend = config.paths.frontend;
-                if (config.paths.docs) docs = config.paths.docs;
-                if (config.paths.tests) tests = config.paths.tests;
+                if (config.paths.backend)
+                    backend = config.paths.backend;
+                if (config.paths.frontend)
+                    frontend = config.paths.frontend;
+                if (config.paths.docs)
+                    docs = config.paths.docs;
+                if (config.paths.tests)
+                    tests = config.paths.tests;
             }
         }
-    } catch (err) {
+    }
+    catch (err) {
         logger.debug("Failed to read config.json in remapFrameworkContent", err);
     }
-
     result = result.replace(/\{\{BACKEND_DIR\}\}/g, backend);
     result = result.replace(/\{\{FRONTEND_DIR\}\}/g, frontend);
     result = result.replace(/\{\{DOCS_DIR\}\}/g, docs);
     result = result.replace(/\{\{TESTS_DIR\}\}/g, tests);
-
     return result;
 }

package/{src/cli/commands/approve.ts → framework-mcp/dist/src/cli/commands/approve.js}

@@ -4,33 +4,26 @@ import { getFrameworkDir } from "../utils/memory.js";
 import { UI } from "../utils/ui.js";
 import { writeTextFile, appendFile } from "../utils/fs.js";
 import { ValidationError } from "../../shared/errors.js";
-
 import { HermesMessageSchema } from "./orchestrate.js";
-
-export async function approveCommand(traceId: string) {
+export async function approveCommand(traceId) {
     const frameworkDir = getFrameworkDir();
     const messagesDir = path.join(frameworkDir, "messages");
-
     if (!fs.existsSync(messagesDir)) {
-        throw new ValidationError(
-            "No messages directory found.",
-            null,
-            "Ensure the framework is initialized and the Hermes orchestrator has been run at least once."
-        );
+        throw new ValidationError("No messages directory found.", null, "Ensure the framework is initialized and the Hermes orchestrator has been run at least once.");
     }
-
     const files = fs.readdirSync(messagesDir).filter((f) => f.endsWith(".json"));
     let found = false;
-
     for (const file of files) {
         const filePath = path.join(messagesDir, file);
         try {
             const content = fs.readFileSync(filePath, "utf8").trim();
-            if (!content) continue;
+            if (!content)
+                continue;
             const lines = content.split("\n");
             let updated = false;
             const newLines = lines.map((line) => {
-                if (!line.trim()) return line;
+                if (!line.trim())
+                    return line;
                 try {
                     const parsed = JSON.parse(line);
                     const msg = HermesMessageSchema.parse(parsed);
@@ -41,20 +34,20 @@ export async function approveCommand(traceId: string) {
                         UI.success(`Approved message from ${msg.from} to ${msg.to} (Action: ${msg.action || "None"})`);
                     }
                     return JSON.stringify(msg);
-                } catch (e) {
-                    UI.error(`Skipping invalid Hermes message during approval: ${(e as Error).message}`);
+                }
+                catch (e) {
+                    UI.error(`Skipping invalid Hermes message during approval: ${e.message}`);
                     return line;
                 }
             });
-
             if (updated) {
                 writeTextFile(filePath, newLines.join("\n") + "\n");
             }
-        } catch (e) {
-            UI.error(`Error reading or updating message file ${file}: ${(e as Error).message}`);
+        }
+        catch (e) {
+            UI.error(`Error reading or updating message file ${file}: ${e.message}`);
         }
     }
-
     if (found) {
         // Log user approval to audit log
         const auditPath = path.join(frameworkDir, "observability/audit_log.md");
@@ -63,11 +56,8 @@ export async function approveCommand(traceId: string) {
             appendFile(auditPath, logEntry);
         }
         UI.success("Successfully approved Trace: " + traceId);
-    } else {
-        throw new ValidationError(
-            `No pending approval request found for Trace ID: ${traceId}`,
-            null,
-            "Run 'npx atabey status' to see active traces and ensure the ID is correct and pending approval."
-        );
+    }
+    else {
+        throw new ValidationError(`No pending approval request found for Trace ID: ${traceId}`, null, "Run 'npx atabey status' to see active traces and ensure the ID is correct and pending approval.");
     }
 }