atabey 0.0.16 → 0.0.18

package/framework-mcp/dist/src/modules/skills/adapter-skills.js

@@ -1,449 +0,0 @@
-/**
- * Adapter-Skill Mapping System
- *
- * Determines which skills each adapter has based on its unique tool capabilities.
- * This way:
- * - Claude Code uses a different skill set
- * - Gemini CLI uses a different skill set
- * - Cursor uses a different skill set
- * - Codex (Copilot) uses a different skill set
- *
- * Bridges each adapter's tool mapping (CLAUDE_TOOL_VALUES, GEMINI_TOOL_VALUES, etc.)
- * with skill definitions.
- */
-/**
- * Skill configurations for all adapters
- * Each adapter defines its skill set based on platform capabilities.
- */
-export const ADAPTER_SKILLS = {
-    // ─── Claude Code ────────────────────────────────────────────────
-    "claude": {
-        adapterId: "claude",
-        enabledSkills: {
-            file_system: {
-                name: "File System Mastery",
-                tools: ["read_file", "write_file", "list_dir"],
-                description: "Read, write, and list files in the workspace.",
-                mandates: [
-                    "Use Read for file reading with line range support",
-                    "Use Write for creating new files",
-                    "Use LS for directory listing"
-                ]
-            },
-            editing: {
-                name: "Surgical Code Modification",
-                tools: ["replace_text", "batch_surgical_edit", "patch_file"],
-                description: "Precise code edits without full file rewrites.",
-                mandates: [
-                    "Use Edit for single replacements",
-                    "Use MultiEdit for batch operations across files"
-                ]
-            },
-            orchestration: {
-                name: "Hermes Orchestration & Messaging",
-                tools: ["orchestrate_loop", "send_agent_message", "get_framework_status", "log_agent_action"],
-                description: "Inter-agent communication and task delegation.",
-                mandates: [
-                    "Use Task for agent-to-agent messages",
-                    "Always include traceId in all messages"
-                ]
-            },
-            governance: {
-                name: "Control Plane Governance",
-                tools: ["acquire_lock", "release_lock", "register_agent", "update_contract_hash"],
-                description: "Resource locking and agent registration.",
-                mandates: [
-                    "Acquire lock before editing shared resources",
-                    "Release lock immediately after write"
-                ]
-            },
-            quality: {
-                name: "Quality Assurance",
-                tools: ["run_shell_command", "run_tests", "check_lint"],
-                description: "Testing and code quality enforcement.",
-                mandates: [
-                    "Use Bash for running tests and linting",
-                    "Zero-error policy for all quality gates"
-                ]
-            },
-            search: {
-                name: "Codebase Search & Exploration",
-                tools: ["grep_search", "get_project_map", "get_project_gaps"],
-                description: "Search and map the project structure.",
-                mandates: [
-                    "Use Grep for regex search across codebase",
-                    "Use Bash for project map generation"
-                ]
-            },
-            memory: {
-                name: "Project Memory Management",
-                tools: ["read_project_memory", "update_project_memory", "get_memory_insights",
-                    "store_knowledge", "search_knowledge", "delete_knowledge"],
-                description: "Centralized project memory and knowledge base.",
-                mandates: [
-                    "Read PROJECT_MEMORY.md at session start",
-                    "Update memory after every significant change"
-                ]
-            }
-        },
-        toolMapping: {
-            read_file: "Read", write_file: "Write", replace_text: "Edit",
-            batch_surgical_edit: "MultiEdit", patch_file: "Edit",
-            list_dir: "LS", grep_search: "Grep",
-            run_shell_command: "Bash", run_tests: "Bash",
-            send_agent_message: "Task", orchestrate_loop: "Task",
-            log_agent_action: "Write", ask_human: "Task",
-            acquire_lock: "Write", release_lock: "Write",
-            register_agent: "Write", update_contract_hash: "Write",
-            store_knowledge: "Write", search_knowledge: "Read",
-            delete_knowledge: "Write", check_lint: "Bash"
-        }
-    },
-    // ─── Gemini CLI ─────────────────────────────────────────────────
-    "gemini": {
-        adapterId: "gemini",
-        enabledSkills: {
-            file_system: {
-                name: "File System Mastery",
-                tools: ["read_file", "write_file", "list_dir"],
-                description: "Read, write, and list files in the workspace.",
-                mandates: [
-                    "Use read_file with line range for large files",
-                    "Use write_file for creating new files"
-                ]
-            },
-            editing: {
-                name: "Surgical Code Modification",
-                tools: ["replace_text", "patch_file"],
-                description: "Precise code edits.",
-                mandates: [
-                    "Use replace for surgical text replacements",
-                    "Prefer surgical edits over full rewrites"
-                ]
-            },
-            orchestration: {
-                name: "Agent Orchestration",
-                tools: ["orchestrate_loop", "send_agent_message", "get_framework_status"],
-                description: "Inter-agent communication.",
-                mandates: [
-                    "Use run_shell_command for agent messages",
-                    "Always include traceId in communications"
-                ]
-            },
-            governance: {
-                name: "Control Plane Governance",
-                tools: ["acquire_lock", "release_lock", "register_agent"],
-                description: "Resource locking and agent registration.",
-                mandates: [
-                    "Acquire lock before editing shared resources"
-                ]
-            },
-            quality: {
-                name: "Quality Assurance",
-                tools: ["run_shell_command", "check_lint"],
-                description: "Code quality enforcement.",
-                mandates: [
-                    "Use run_shell_command for linting and testing"
-                ]
-            },
-            search: {
-                name: "Codebase Search",
-                tools: ["grep_search", "get_project_map"],
-                description: "Search the project structure.",
-                mandates: [
-                    "Use grep_search for regex search"
-                ]
-            }
-        },
-        toolMapping: {
-            read_file: "read_file", write_file: "write_file",
-            replace_text: "replace", patch_file: "replace",
-            list_dir: "list_directory", grep_search: "grep_search",
-            run_shell_command: "run_shell_command",
-            send_agent_message: "run_shell_command",
-            orchestrate_loop: "run_shell_command",
-            log_agent_action: "write_file", ask_human: "run_shell_command",
-            acquire_lock: "write_file", release_lock: "write_file",
-            register_agent: "write_file", check_lint: "run_shell_command"
-        }
-    },
-    // ─── Grok (Gemini-compatible) ───────────────────────────────────
-    "grok": {
-        adapterId: "grok",
-        enabledSkills: {
-            file_system: {
-                name: "File System Mastery",
-                tools: ["read_file", "write_file", "list_dir"],
-                description: "Read, write, and list files.",
-                mandates: ["Use read_file with line range for large files"]
-            },
-            editing: {
-                name: "Code Modification",
-                tools: ["replace_text", "patch_file"],
-                description: "Precise code edits.",
-                mandates: ["Prefer surgical edits over full rewrites"]
-            },
-            search: {
-                name: "Codebase Search",
-                tools: ["grep_search", "get_project_map"],
-                description: "Search the project structure.",
-                mandates: ["Use grep_search for regex search"]
-            },
-            quality: {
-                name: "Quality Assurance",
-                tools: ["run_shell_command", "check_lint"],
-                description: "Code quality enforcement.",
-                mandates: ["Use run_shell_command for linting"]
-            }
-        },
-        toolMapping: {
-            read_file: "read_file", write_file: "write_file",
-            replace_text: "replace", patch_file: "replace",
-            list_dir: "list_directory", grep_search: "grep_search",
-            run_shell_command: "run_shell_command",
-            check_lint: "run_shell_command"
-        }
-    },
-    // ─── Cursor IDE ─────────────────────────────────────────────────
-    "cursor": {
-        adapterId: "cursor",
-        enabledSkills: {
-            file_system: {
-                name: "File System Mastery",
-                tools: ["read_file", "write_file", "list_dir"],
-                description: "Read, write, and list files.",
-                mandates: ["Use read_file with line range for large files"]
-            },
-            editing: {
-                name: "Code Modification",
-                tools: ["replace_text", "patch_file"],
-                description: "Precise code edits.",
-                mandates: ["Prefer surgical edits over full rewrites"]
-            },
-            search: {
-                name: "Codebase Search",
-                tools: ["grep_search", "get_project_map"],
-                description: "Search the project structure.",
-                mandates: ["Use grep_search for regex search"]
-            },
-            quality: {
-                name: "Quality Assurance",
-                tools: ["run_shell_command", "check_lint"],
-                description: "Code quality enforcement.",
-                mandates: ["Use run_shell_command for linting"]
-            }
-        },
-        toolMapping: {
-            read_file: "read_file", write_file: "write_file",
-            replace_text: "replace", patch_file: "replace",
-            list_dir: "list_directory", grep_search: "grep_search",
-            run_shell_command: "run_shell_command",
-            check_lint: "run_shell_command"
-        }
-    },
-    // ─── Codex (GitHub Copilot) ─────────────────────────────────────
-    "codex": {
-        adapterId: "codex",
-        enabledSkills: {
-            file_system: {
-                name: "File System Mastery",
-                tools: ["read_file", "write_file", "list_dir"],
-                description: "Read, write, and list files.",
-                mandates: ["Use read category tools for file reading"]
-            },
-            editing: {
-                name: "Code Modification",
-                tools: ["replace_text", "patch_file", "batch_surgical_edit"],
-                description: "Precise code edits.",
-                mandates: ["Use write category tools for edits"]
-            },
-            search: {
-                name: "Codebase Search",
-                tools: ["grep_search", "get_project_map"],
-                description: "Search the project structure.",
-                mandates: ["Use read category tools for search"]
-            },
-            quality: {
-                name: "Quality Assurance",
-                tools: ["run_shell_command", "check_lint"],
-                description: "Code quality enforcement.",
-                mandates: ["Use shell category tools for linting"]
-            }
-        },
-        toolMapping: {
-            read_file: "read", write_file: "write",
-            replace_text: "write", patch_file: "write",
-            batch_surgical_edit: "write",
-            list_dir: "read", grep_search: "read",
-            run_shell_command: "shell", check_lint: "shell"
-        }
-    },
-    // ─── Local LLM ──────────────────────────────────────────────────
-    "local": {
-        adapterId: "local",
-        enabledSkills: {
-            file_system: {
-                name: "File System Mastery",
-                tools: ["read_file", "write_file", "list_dir"],
-                description: "Read, write, and list files.",
-                mandates: ["Use read_file with line range for large files"]
-            },
-            editing: {
-                name: "Code Modification",
-                tools: ["replace_text", "patch_file"],
-                description: "Precise code edits.",
-                mandates: ["Prefer surgical edits over full rewrites"]
-            },
-            orchestration: {
-                name: "Agent Orchestration",
-                tools: ["orchestrate_loop", "send_agent_message", "get_framework_status"],
-                description: "Inter-agent communication.",
-                mandates: ["Always include traceId in communications"]
-            },
-            governance: {
-                name: "Control Plane Governance",
-                tools: ["acquire_lock", "release_lock", "register_agent"],
-                description: "Resource locking.",
-                mandates: ["Acquire lock before editing shared resources"]
-            },
-            quality: {
-                name: "Quality Assurance",
-                tools: ["run_shell_command", "check_lint"],
-                description: "Code quality enforcement.",
-                mandates: ["Use run_shell_command for linting"]
-            },
-            search: {
-                name: "Codebase Search",
-                tools: ["grep_search", "get_project_map"],
-                description: "Search the project structure.",
-                mandates: ["Use grep_search for regex search"]
-            }
-        },
-        toolMapping: {
-            read_file: "read_file", write_file: "write_file",
-            replace_text: "replace", patch_file: "replace",
-            list_dir: "list_directory", grep_search: "grep_search",
-            run_shell_command: "run_shell_command",
-            send_agent_message: "run_shell_command",
-            orchestrate_loop: "run_shell_command",
-            log_agent_action: "write_file", ask_human: "run_shell_command",
-            acquire_lock: "write_file", release_lock: "write_file",
-            register_agent: "write_file", check_lint: "run_shell_command"
-        }
-    },
-    // ─── Antigravity CLI ────────────────────────────────────────────
-    "antigravity-cli": {
-        adapterId: "antigravity-cli",
-        enabledSkills: {
-            file_system: {
-                name: "File System Mastery",
-                tools: ["read_file", "write_file", "list_dir"],
-                description: "Read, write, and list files.",
-                mandates: ["Use read_file with line range for large files"]
-            },
-            editing: {
-                name: "Code Modification",
-                tools: ["replace_text", "patch_file", "batch_surgical_edit"],
-                description: "Precise code edits.",
-                mandates: ["Prefer surgical edits over full rewrites"]
-            },
-            orchestration: {
-                name: "Agent Orchestration",
-                tools: ["orchestrate_loop", "send_agent_message", "get_framework_status"],
-                description: "Inter-agent communication.",
-                mandates: ["Always include traceId in communications"]
-            },
-            governance: {
-                name: "Control Plane Governance",
-                tools: ["acquire_lock", "release_lock", "register_agent"],
-                description: "Resource locking.",
-                mandates: ["Acquire lock before editing shared resources"]
-            },
-            quality: {
-                name: "Quality Assurance",
-                tools: ["run_shell_command", "check_lint"],
-                description: "Code quality enforcement.",
-                mandates: ["Use run_shell_command for linting"]
-            },
-            search: {
-                name: "Codebase Search",
-                tools: ["grep_search", "get_project_map"],
-                description: "Search the project structure.",
-                mandates: ["Use grep_search for regex search"]
-            }
-        },
-        toolMapping: {
-            read_file: "read_file", write_file: "write_file",
-            replace_text: "replace", patch_file: "replace",
-            batch_surgical_edit: "replace",
-            list_dir: "list_directory", grep_search: "grep_search",
-            run_shell_command: "run_shell_command",
-            send_agent_message: "run_shell_command",
-            orchestrate_loop: "run_shell_command",
-            log_agent_action: "write_file", ask_human: "run_shell_command",
-            acquire_lock: "write_file", release_lock: "write_file",
-            register_agent: "write_file", check_lint: "run_shell_command"
-        }
-    }
-};
-/**
- * Determines which tools of an agent are available for a specific adapter.
- *
- * @param adapterId - Adapter ID
- * @param agentTools - Agent's defined tool list
- * @returns Filtered tool list (only those supported by the adapter)
- */
-export function filterToolsForAdapter(adapterId, agentTools) {
-    const adapterConfig = ADAPTER_SKILLS[adapterId];
-    if (!adapterConfig)
-        return agentTools;
-    // Collect all tools supported by the adapter
-    const supportedTools = new Set();
-    for (const skill of Object.values(adapterConfig.enabledSkills)) {
-        for (const tool of skill.tools) {
-            supportedTools.add(tool);
-        }
-    }
-    // Filter agent tools by what the adapter supports
-    return agentTools.filter(tool => supportedTools.has(tool));
-}
-/**
- * Returns which skills an agent has for a specific adapter.
- *
- * @param adapterId - Adapter ID
- * @param agentTools - Agent's defined tool list
- * @returns Skills the agent has for this adapter
- */
-export function getSkillsForAgent(adapterId, agentTools) {
-    const adapterConfig = ADAPTER_SKILLS[adapterId];
-    if (!adapterConfig)
-        return [];
-    const agentToolSet = new Set(agentTools);
-    const matchedSkills = [];
-    for (const [, skill] of Object.entries(adapterConfig.enabledSkills)) {
-        // Add skill if at least one of its tools matches the agent
-        const matchingTools = skill.tools.filter(t => agentToolSet.has(t));
-        if (matchingTools.length > 0) {
-            matchedSkills.push({
-                name: skill.name,
-                description: skill.description,
-                tools: matchingTools,
-                mandates: skill.mandates
-            });
-        }
-    }
-    return matchedSkills;
-}
-/**
- * Translates a tool name to its platform-native equivalent for a given adapter.
- *
- * @param adapterId - Adapter ID
- * @param internalToolName - Internal tool name (e.g. "read_file")
- * @returns Platform-native tool name (e.g. "Read" for Claude, "read_file" for Gemini)
- */
-export function mapToolToPlatform(adapterId, internalToolName) {
-    const adapterConfig = ADAPTER_SKILLS[adapterId];
-    if (!adapterConfig)
-        return internalToolName;
-    return adapterConfig.toolMapping[internalToolName] || internalToolName;
-}

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

@@ -1,70 +0,0 @@
-/**
- * Core Skill Definitions for Agent Atabey.
- * Groups tools into logical capabilities for agents.
- */
-export const CORE_SKILLS = {
-    FILE_SYSTEM: {
-        name: "File System Mastery",
-        tools: ["read_file", "write_file"],
-        description: "Enables reading and writing files in the workspace with token efficiency.",
-        mandates: [
-            "- **Token Efficiency:** When reading large files, always specify `startLine` and `endLine` to avoid loading the entire file content into context.",
-            "- **Surgical Changes:** Avoid overwriting entire files for small updates; prefer surgical edit tools."
-        ]
-    },
-    EDITING: {
-        name: "Surgical Code Modification",
-        tools: ["replace_text", "patch_file"],
-        description: "Enables surgical, precise edits to source code files without overwriting the entire content.",
-        mandates: [
-            "- **Precise Selection:** Ensure `oldText` matches the target string exactly, including all whitespace and indentation.",
-            "- **Line-based Replacement:** Use `patch_file` for multi-line block updates, specifying exact 1-indexed start and end lines."
-        ]
-    },
-    ORCHESTRATION: {
-        name: "Hermes Orchestration & Messaging",
-        tools: ["orchestrate_loop", "send_agent_message", "get_framework_status", "log_agent_action"],
-        description: "Governs inter-agent message passing, task delegation, and execution logs using the Hermes Message Broker.",
-        mandates: [
-            "- **Traceability:** Always include the active `traceId` in all messages and action logs.",
-            "- **Action Logs:** Log critical operations with `log_agent_action` to ensure transparency and accountability.",
-            "- **Message Loops:** Run `orchestrate_loop` to process queued messages and trigger state transitions."
-        ]
-    },
-    GOVERNANCE: {
-        name: "Control Plane Governance & Locking",
-        tools: ["acquire_lock", "release_lock", "register_agent", "update_contract_hash"],
-        description: "Governs access control, resource locking, type contract validation, and agent registration.",
-        mandates: [
-            "- **Locking Protocol:** Always acquire a lock via `acquire_lock` on shared resources (like memory files) before editing, and release it immediately after writing.",
-            "- **Contract Enforcement:** Run `update_contract_hash` to re-sync backend types and check for breaking API changes."
-        ]
-    },
-    QUALITY_ASSURANCE: {
-        name: "Quality Assurance & Testing",
-        tools: ["run_shell_command", "view_file"],
-        description: "Enforces testing coverage standards, code style compliance, and runs test suites.",
-        mandates: [
-            "- **Zero-Mock Policy:** Integration tests must use real test database connections or service-compatible backends; do not rely on fake mocks.",
-            "- **Coverage Standards:** Ensure new code meets the 80% test coverage threshold before transitioning to release phases."
-        ]
-    },
-    DATABASE_MANAGEMENT: {
-        name: "Database Management & Migrations",
-        tools: ["view_file", "replace_text", "run_shell_command"],
-        description: "Handles database migrations, schema design, and query optimization.",
-        mandates: [
-            "- **No Direct DB Calls in Controllers:** Database operations must be isolated inside repository or service files; controllers must never perform raw DB calls.",
-            "- **No Raw SQL Strings:** Do not write raw SQL query strings; strictly use type-safe query builders like Kysely."
-        ]
-    },
-    DEVOPS_INFRASTRUCTURE: {
-        name: "DevOps & Infrastructure",
-        tools: ["run_shell_command", "view_file"],
-        description: "Manages CI/CD pipelines, container configurations, env files, and deployments.",
-        mandates: [
-            "- **No Hardcoded Secrets:** Never embed API keys, secrets, or passwords inside configuration files or codebases.",
-            "- **Immutable Deploys:** Ensure build steps compile production bundles successfully without configuration side-effects."
-        ]
-    }
-};