atabey 0.0.7 → 0.0.9

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

@@ -0,0 +1,104 @@
+import path from "path";
+import fs from "fs";
+import os from "os";
+import { execSync } from "child_process";
+import { writeJsonFile, writeTextFile } from "../../shared/fs.js";
+import { ALL_AGENTS, toAntigravityJson } from "../agents/definitions.js";
+import { CORE_SKILLS } from "../skills/definitions.js";
+import { getPackageRoot } from "../../cli/utils/pkg.js";
+import { logger } from "../../shared/logger.js";
+export function registerGlobalAntigravityPlugins(mcpBlock) {
+    // Allow overriding via env var for different OS/Gemini CLI versions
+    const defaultGlobalDir = path.join(os.homedir(), ".gemini/antigravity-cli");
+    const customDir = process.env["ANTIGRAVITY_GLOBAL_DIR"];
+    const targets = [customDir ?? defaultGlobalDir];
+    const baseKnowledgeDir = path.join(getPackageRoot(), "templates/standards");
+    for (const globalDir of targets) {
+        try {
+            // Write directly under directory
+            fs.mkdirSync(globalDir, { recursive: true });
+            writeJsonFile(path.join(globalDir, "mcp.json"), mcpBlock);
+            writeJsonFile(path.join(globalDir, "mcp_config.json"), mcpBlock);
+            logger.info(`Antigravity MCP registered → ${globalDir}/`);
+            // Global Plugin configuration under plugins/atabey/
+            const globalPluginDir = path.join(globalDir, "plugins/atabey");
+            fs.mkdirSync(globalPluginDir, { recursive: true });
+            // plugin.json marker
+            writeJsonFile(path.join(globalPluginDir, "plugin.json"), {
+                name: "atabey",
+                version: "1.0.0",
+                description: "Agent Atabey AI Orchestration framework"
+            });
+            // MCP Server configs inside the plugin
+            writeJsonFile(path.join(globalPluginDir, "mcp.json"), mcpBlock);
+            writeJsonFile(path.join(globalPluginDir, "mcp_config.json"), mcpBlock);
+            // Scaffold 13 agents
+            const agentsBaseDir = path.join(globalPluginDir, "agents");
+            fs.mkdirSync(agentsBaseDir, { recursive: true });
+            // Also write directly to ~/.gemini/antigravity-cli/agents/ so the CLI's
+            // workspace/global agent discovery finds them without the plugins/ prefix.
+            const globalAgentsDir = path.join(globalDir, "agents");
+            fs.mkdirSync(globalAgentsDir, { recursive: true });
+            for (const ag of ALL_AGENTS) {
+                const agentJson = toAntigravityJson(ag, baseKnowledgeDir);
+                // 1. Nested format inside plugin: plugins/atabey/agents/{name}/agent.json
+                const nestedAgentDir = path.join(agentsBaseDir, ag.name);
+                fs.mkdirSync(nestedAgentDir, { recursive: true });
+                writeTextFile(path.join(nestedAgentDir, "agent.json"), agentJson);
+                // 2. Flat format inside plugin: plugins/atabey/agents/{name}.json
+                writeTextFile(path.join(agentsBaseDir, `${ag.name}.json`), agentJson);
+                // 3. Direct global agents root — THIS is what Antigravity CLI reads:
+                //    ~/.gemini/antigravity-cli/agents/{name}/agent.json
+                const globalNestedDir = path.join(globalAgentsDir, ag.name);
+                fs.mkdirSync(globalNestedDir, { recursive: true });
+                writeTextFile(path.join(globalNestedDir, "agent.json"), agentJson);
+                // 4. Flat global format as fallback
+                writeTextFile(path.join(globalAgentsDir, `${ag.name}.json`), agentJson);
+            }
+            // Scaffold skills
+            const skillsDir = path.join(globalPluginDir, "skills");
+            fs.mkdirSync(skillsDir, { recursive: true });
+            for (const [key, skill] of Object.entries(CORE_SKILLS)) {
+                const skillContent = `# 🛠️ Skill — ${skill.name}\n\n${skill.mandates.join("\n")}\n`;
+                writeTextFile(path.join(skillsDir, `${key.toLowerCase()}.md`), skillContent);
+            }
+            // Scaffold rules
+            const rulesDir = path.join(globalPluginDir, "rules");
+            fs.mkdirSync(rulesDir, { recursive: true });
+            for (const ag of ALL_AGENTS) {
+                const ruleContent = `# [ATABEY] Agent Atabey — @${ag.name} (${ag.displayName})
+
+You are the **${ag.displayName}** of the Agent Atabey Army.
+
+## [AI] Specialist Directive (Role: @${ag.name})
+${ag.instructions.identity}
+
+### [GOAL] Mission
+${ag.instructions.mission}
+
+### 📜 Discipline Rules
+${ag.instructions.rules.map(r => `- ${r}`).join("\n")}
+
+## [SECURITY] Core Mandates
+- **Surgical Precision:** Enforce replace_text / replace_file_content for all code modifications.
+- **Traceability:** Inherit and pass the active Trace ID across all delegations.
+- **Approval Signature:** High-risk actions require manager approval signature.
+`;
+                writeTextFile(path.join(rulesDir, `${ag.name}.md`), ruleContent);
+            }
+            // Scaffold optional empty hooks.json
+            writeJsonFile(path.join(globalPluginDir, "hooks.json"), {});
+            logger.info(`Antigravity Plugin registered → ${globalPluginDir}/`);
+            try {
+                execSync(`agy plugin install "${globalPluginDir}"`, { stdio: "ignore" });
+                logger.info("Antigravity Plugin installed in CLI.");
+            }
+            catch {
+                // Ignore if agy is not in PATH or fails
+            }
+        }
+        catch (e) {
+            logger.warn(`Failed to register plugin/MCP in ${globalDir}`, e);
+        }
+    }
+}

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

@@ -0,0 +1 @@
+export const ADAPTER_IDS = ["gemini", "claude", "grok", "cursor", "codex", "local", "antigravity-cli"];

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

@@ -0,0 +1,457 @@
+// ─────────────────────────────────────────────────────────────────────────────
+//  Atabey Army — Agent Registry
+//  Atabey Order v2 · Structured AgentDefinition schema
+//
+//  VALID FRONTMATTER FIELDS per platform:
+//  ┌───────────────┬────────────────────────────────────────────────────────────┐
+//  │ gemini-cli    │ name, description, model, tools (YAML list)                │
+//  │ claude-code   │ name, description, model, tools (inline array), color      │
+//  │ cursor        │ description, globs, alwaysApply                            │
+//  │ codex-cli     │ agent-type, display-name, when-to-use, model, allowed-tools│
+//  │ antigravity   │ JSON — customAgentSpec schema                              │
+//  └───────────────┴────────────────────────────────────────────────────────────┘
+//  Custom fields (capability, tags, tier) are Atabey-internal metadata and
+//  must NOT appear in any platform frontmatter.
+// ─────────────────────────────────────────────────────────────────────────────
+import fs from "fs";
+import path from "path";
+import { getPackageRoot } from "../../cli/utils/pkg.js";
+import { CURSOR_AGENT_GLOBS } from "../../shared/constants.js";
+import { getFrameworkDir } from "../../cli/utils/memory.js";
+// Import individual agent definitions
+import { manager } from "./registry/manager.js";
+import { security } from "./registry/security.js";
+import { architect } from "./registry/architect.js";
+import { backend } from "./registry/backend.js";
+import { frontend } from "./registry/frontend.js";
+import { mobile } from "./registry/mobile.js";
+import { quality } from "./registry/quality.js";
+import { database } from "./registry/database.js";
+import { devops } from "./registry/devops.js";
+import { analyst } from "./registry/analyst.js";
+import { native } from "./registry/native.js";
+import { explorer } from "./registry/explorer.js";
+import { git } from "./registry/git.js";
+/**
+ * Sanitizes description or displayName strings before embedding them into frontmatter.
+ * Replaces delimiters (like ---), strips newlines to avoid formatting breakage, and trims.
+ */
+export function sanitizeFrontmatterText(text) {
+    if (!text)
+        return "";
+    return text
+        .replace(/---/g, "- - -") // Prevent frontmatter boundary injection
+        .replace(/\r?\n/g, " ") // Replace line breaks with spaces
+        .trim();
+}
+export const ALL_AGENTS = [
+    manager,
+    security,
+    architect,
+    backend,
+    frontend,
+    mobile,
+    quality,
+    database,
+    devops,
+    analyst,
+    native,
+    explorer,
+    git
+];
+// ─────────────────────────────────────────────────────────────────────────────
+//  Tool Maps — Internal tool names → platform-native tool identifiers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Claude Code built-in tool names (case-sensitive).
+ * Reference: https://docs.anthropic.com/en/docs/claude-code/sub-agents
+ */
+export const CLAUDE_TOOL_MAP = {
+    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",
+    view_file: "Read",
+    run_tests: "Bash",
+    log_agent_action: "Write",
+    send_agent_message: "Task",
+    orchestrate_loop: "Task",
+    get_project_map: "Bash",
+    get_project_gaps: "Bash",
+    get_memory_insights: "Read",
+    read_project_memory: "Read",
+    update_project_memory: "Write",
+    audit_dependencies: "Bash",
+    get_framework_status: "Bash",
+    get_system_health: "Bash",
+    check_active_ports: "Bash",
+    update_contract_hash: "Write",
+    acquire_lock: "Write",
+    release_lock: "Write",
+    register_agent: "Write",
+    check_lint: "Bash",
+};
+/**
+ * Gemini CLI built-in tool names (canonical names validated by Gemini CLI agent schema).
+ * Reference: https://github.com/google-gemini/gemini-cli
+ *
+ * Valid Gemini CLI tool names:
+ *   read_file, write_file, replace, grep_search, glob,
+ *   list_directory, run_shell_command
+ */
+export const GEMINI_TOOL_MAP = {
+    read_file: "read_file",
+    write_file: "write_file",
+    replace_text: "replace", // [OK] NOT replace_in_file
+    batch_surgical_edit: "replace", // [OK] NOT replace_in_file
+    patch_file: "replace", // [OK] NOT replace_in_file
+    list_dir: "list_directory",
+    grep_search: "grep_search", // [OK] NOT search_file_content
+    run_shell_command: "run_shell_command",
+    view_file: "read_file",
+    run_tests: "run_shell_command",
+    log_agent_action: "write_file",
+    send_agent_message: "run_shell_command",
+    orchestrate_loop: "run_shell_command",
+    get_project_map: "run_shell_command",
+    get_project_gaps: "run_shell_command",
+    get_memory_insights: "read_file",
+    read_project_memory: "read_file",
+    update_project_memory: "write_file",
+    audit_dependencies: "run_shell_command",
+    get_framework_status: "run_shell_command",
+    get_system_health: "run_shell_command",
+    check_active_ports: "run_shell_command",
+    update_contract_hash: "write_file",
+    acquire_lock: "write_file",
+    release_lock: "write_file",
+    register_agent: "write_file",
+    check_lint: "run_shell_command",
+};
+// ─────────────────────────────────────────────────────────────────────────────
+//  Model Resolution
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Assigns the appropriate model based on capability score.
+ * Only valid, real model identifiers are used here.
+ */
+function resolveModel(cap, platform) {
+    if (platform === "claude-code") {
+        // Verified Claude model names as of 2025-06
+        return cap === 10 ? "claude-opus-4-5"
+            : cap === 9 ? "claude-sonnet-4-5"
+                : "claude-haiku-3-5";
+    }
+    if (platform === "gemini-cli" || platform === "antigravity") {
+        // Verified Gemini model names as of 2025-06
+        return cap === 10 ? "gemini-2.5-pro"
+            : cap === 9 ? "gemini-2.5-flash"
+                : "gemini-2.5-flash-lite";
+    }
+    // codex-cli / OpenAI
+    return cap === 10 ? "o3" : "o4-mini";
+}
+// ─────────────────────────────────────────────────────────────────────────────
+//  System Prompt Builder
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Builds a rich, enterprise-grade system prompt from structured instructions.
+ * Embeds governance document contents inline for agents that have knowledgeFiles.
+ *
+ * @param stripMetaComments - When true, skips the HTML meta-comment header block
+ *   (name/capability/tags). Set to true for Gemini CLI and Grok, whose strict
+ *   frontmatter validators may misinterpret HTML comments in the document body
+ *   as unrecognized YAML keys and reject the agent file entirely.
+ */
+function buildSystemPrompt(ag, baseKnowledgeDir = path.join(getPackageRoot(), "templates/standards"), stripMetaComments = false, paths = { backend: "apps/backend", frontend: "apps/web", mobile: "apps/mobile", docs: "docs" }, backendLanguage = "Node.js (TypeScript)") {
+    const metaHeader = stripMetaComments ? [] : [
+        `<!-- name: ${ag.name} -->`,
+        `<!-- capability: ${ag.capability} -->`,
+        `<!-- tags: ${JSON.stringify(ag.tags)} -->`,
+        "",
+    ];
+    const lines = [
+        ...metaHeader,
+        `# [ATABEY] ${ag.displayName} — Agent Atabey`,
+        "",
+        "## Identity",
+        ag.instructions.identity,
+        "",
+        "## Mission",
+        ag.instructions.mission,
+        "",
+        "## Role Scope",
+        `**Primary Role:** ${ag.role}`,
+        `**Authority Tier:** ${ag.tier} (Capability: ${ag.capability}/10)`,
+        "",
+        "## Project Structure & Technology",
+        "This project uses the following stack and directory structure:",
+        `- **Backend Language:** ${backendLanguage}`,
+        `- **Backend Path:** ${paths.backend}`,
+        `- **Frontend Path:** ${paths.frontend}`,
+        `- **Mobile Path:** ${paths.mobile}`,
+        `- **Documentation:** ${paths.docs}`,
+        "",
+        "## Chain of Thought Protocol",
+        "> Follow these steps in strict order for every task:",
+        "",
+        ag.instructions.chainOfThought,
+        "",
+        "## Discipline Rules",
+        "> These are **non-negotiable** governance mandates. Violating any rule triggers an immediate task freeze.",
+        "",
+        ...ag.instructions.rules.map((r, i) => `${i + 1}. ${r}`),
+        "",
+        "## Enterprise Context",
+        "You are operating within a **multi-agent enterprise system** governed by the Agent Atabey framework.",
+        "All actions are traced, logged, and auditable. Every decision must be defensible and reversible.",
+        `- You are a specialist in **${backendLanguage}** development for backend tasks.`,
+        "- Always read PROJECT_MEMORY.md at session start for full context.",
+        "- Always pass the active **Trace ID** in all agent-to-agent messages.",
+        "- Never perform irreversible operations (schema drops, bulk deletes) without @manager approval.",
+        "- Prefer surgical edits (replace_text, patch_file) over full file rewrites.",
+        "- Escalate ambiguity to @manager instead of guessing.",
+        `- Ensure all development happens exclusively inside ${paths.backend}, ${paths.frontend}, or ${paths.mobile}.`,
+    ];
+    if (ag.instructions.knowledgeFiles?.length) {
+        lines.push("", "## Governance Standards (Required Reading)");
+        lines.push("> Read and internalize the following standards before acting on any task.");
+        ag.instructions.knowledgeFiles.forEach((f) => {
+            const filePath = path.join(baseKnowledgeDir, f);
+            if (fs.existsSync(filePath)) {
+                lines.push("", `### 📘 ${f}`, "", fs.readFileSync(filePath, "utf8").trim());
+            }
+            else {
+                lines.push("", `### 📘 ${f}`, `> [WARN] File not found at ${filePath}. Run atabey init to scaffold standards.`);
+            }
+        });
+    }
+    // Read learned conventions from local memory if exist (Memory V2)
+    const fDir = getFrameworkDir();
+    const specialtyFile = path.join(fDir, "memory", "specialties", `${ag.name}.md`);
+    if (fs.existsSync(specialtyFile)) {
+        try {
+            const learnedContent = fs.readFileSync(specialtyFile, "utf8").trim();
+            if (learnedContent) {
+                lines.push("", "## Learned Conventions (Project-Specific Experience)", "> These are lessons learned from past task executions in this project. Adhere to them strictly.", "", learnedContent);
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return lines.join("\n");
+}
+// ─────────────────────────────────────────────────────────────────────────────
+//  CLAUDE CODE  →  .claude/agents/{name}.md
+//  Valid fields: name, description, model, tools, color
+//  Ref: https://docs.anthropic.com/en/docs/claude-code/sub-agents
+// ─────────────────────────────────────────────────────────────────────────────
+export function toClaudeCodeMd(ag, baseKnowledgeDir, paths, backendLanguage) {
+    const tools = [...new Set(ag.tools.map((t) => CLAUDE_TOOL_MAP[t] ?? t))];
+    const model = resolveModel(ag.capability, "claude-code");
+    const color = ag.tier === "supreme" ? "purple"
+        : ag.tier === "recon" ? "gray"
+            : "blue";
+    const cleanDesc = sanitizeFrontmatterText(ag.description);
+    // Only officially supported frontmatter fields
+    const frontmatter = [
+        "---",
+        `name: ${ag.name}`,
+        "description: >-",
+        `  ${cleanDesc} Invoke proactively for ${ag.role.toLowerCase()} tasks in enterprise monorepo projects.`,
+        `model: ${model}`,
+        `tools: [${tools.map(t => `"${t}"`).join(", ")}]`,
+        `color: ${color}`,
+        "---",
+    ].join("\n");
+    return `${frontmatter}\n\n${buildSystemPrompt(ag, baseKnowledgeDir, false, paths, backendLanguage)}`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+//  GEMINI CLI  →  .gemini/agents/{name}.md
+//  Valid fields: name, description, model, tools (YAML list)
+//  Ref: https://ai.google.dev/gemini-api/docs/agents
+// ─────────────────────────────────────────────────────────────────────────────
+export function toGeminiCliMd(ag, baseKnowledgeDir, paths, backendLanguage) {
+    const tools = [...new Set(ag.tools.map((t) => GEMINI_TOOL_MAP[t] ?? t))];
+    const model = resolveModel(ag.capability, "gemini-cli");
+    const cleanDesc = sanitizeFrontmatterText(ag.description);
+    const frontmatter = [
+        "---",
+        `name: ${ag.name}`,
+        "description: >-",
+        `  ${cleanDesc} Use for ${ag.role.toLowerCase()} tasks.`,
+        `model: ${model}`,
+        "tools:",
+        ...tools.map(t => `  - ${t}`),
+        "---",
+    ].join("\n");
+    const body = buildSystemPrompt(ag, baseKnowledgeDir, true, paths, backendLanguage);
+    const metaFooter = [
+        "",
+        `<!-- name: ${ag.name} -->`,
+        `<!-- capability: ${ag.capability} -->`,
+        `<!-- tags: ${JSON.stringify(ag.tags)} -->`,
+    ].join("\n");
+    return `${frontmatter}\n\n${body}${metaFooter}`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+//  ANTIGRAVITY CLI  →  .agents/{name}/agent.json
+//  Spec: Antigravity customAgentSpec JSON schema
+// ─────────────────────────────────────────────────────────────────────────────
+export function toAntigravityJson(ag, baseKnowledgeDir, paths, backendLanguage = "Node.js (TypeScript)") {
+    const knowledgeBase = baseKnowledgeDir ?? path.join(getPackageRoot(), "templates/standards");
+    // Embed actual file contents so the agent can read governance docs
+    const knowledgeSections = (ag.instructions.knowledgeFiles ?? []).map((f) => {
+        const filePath = path.join(knowledgeBase, f);
+        const content = fs.existsSync(filePath)
+            ? fs.readFileSync(filePath, "utf8").trim()
+            : `(${f} — file not found at build time)`;
+        return { title: `Required Reading — ${f}`, content };
+    });
+    // Read learned conventions from local memory if exist (Memory V2)
+    const fDir = getFrameworkDir();
+    const specialtyFile = path.join(fDir, "memory", "specialties", `${ag.name}.md`);
+    const specialtySections = [];
+    if (fs.existsSync(specialtyFile)) {
+        try {
+            const learnedContent = fs.readFileSync(specialtyFile, "utf8").trim();
+            if (learnedContent) {
+                specialtySections.push({
+                    title: "Learned Conventions (Project-Specific Experience)",
+                    content: learnedContent
+                });
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    const payload = {
+        name: ag.name,
+        displayName: ag.displayName,
+        description: ag.description,
+        hidden: false,
+        schemaVersion: "2.0",
+        customAgentSpec: {
+            customAgent: {
+                systemPromptSections: [
+                    {
+                        title: "Identity & Mission",
+                        content: `${ag.instructions.identity}\n\n**Mission:** ${ag.instructions.mission}`,
+                    },
+                    {
+                        title: "Project Structure & Technology",
+                        content: [
+                            "This project uses the following stack and directory structure:",
+                            `- Backend Language: ${backendLanguage}`,
+                            `- Backend Path: ${paths?.backend || "apps/backend"}`,
+                            `- Frontend Path: ${paths?.frontend || "apps/web"}`,
+                            `- Mobile Path: ${paths?.mobile || "apps/mobile"}`,
+                            `- Documentation: ${paths?.docs || "docs"}`,
+                        ].join("\n"),
+                    },
+                    {
+                        title: "Chain of Thought Protocol",
+                        content: ag.instructions.chainOfThought,
+                    },
+                    {
+                        title: "Discipline Rules",
+                        content: ag.instructions.rules.map((r, i) => `${i + 1}. ${r}`).join("\n"),
+                    },
+                    {
+                        title: "Enterprise Context",
+                        content: [
+                            "You are part of a multi-agent enterprise governance system.",
+                            `- You are a specialist in **${backendLanguage}** development for backend tasks.`,
+                            "- Always include active Trace ID in all messages.",
+                            "- Read PROJECT_MEMORY.md at session start.",
+                            "- Prefer surgical edits over full file rewrites.",
+                            "- Escalate high-risk operations to @manager.",
+                            `- Ensure development happens inside ${paths?.backend || "apps/backend"}, ${paths?.frontend || "apps/web"}, or ${paths?.mobile || "apps/mobile"}.`,
+                        ].join("\n"),
+                    },
+                    ...knowledgeSections,
+                    ...specialtySections,
+                ],
+                toolNames: ag.tools,
+            },
+        },
+    };
+    return JSON.stringify(payload, null, 2);
+}
+/** Alias for Antigravity JSON export used by CLI */
+export const buildAgentJson = toAntigravityJson;
+// ─────────────────────────────────────────────────────────────────────────────
+//  CODEX CLI (OpenAI)  →  .agents/{name}.md
+//  Valid fields: agent-type, display-name, when-to-use, model, allowed-tools
+// ─────────────────────────────────────────────────────────────────────────────
+export function toCodexMd(ag, baseKnowledgeDir, paths, backendLanguage) {
+    const model = resolveModel(ag.capability, "codex-cli");
+    const tools = [...new Set(ag.tools.map((t) => {
+            if (["read_file", "view_file", "list_dir", "grep_search", "get_memory_insights", "read_project_memory", "get_project_map", "get_project_gaps", "get_framework_status"].includes(t))
+                return "read";
+            if (["write_file", "replace_text", "batch_surgical_edit", "patch_file", "update_project_memory", "log_agent_action", "acquire_lock", "release_lock", "register_agent", "update_contract_hash"].includes(t))
+                return "write";
+            return "shell";
+        }))];
+    const cleanDesc = sanitizeFrontmatterText(ag.description);
+    const cleanDisplayName = sanitizeFrontmatterText(ag.displayName).replace(/"/g, "\\\"");
+    const frontmatter = [
+        "---",
+        `agent-type: "${ag.name}"`,
+        `display-name: "${cleanDisplayName}"`,
+        "when-to-use: >-",
+        `  Invoke for ${ag.role.toLowerCase()} tasks. ${cleanDesc}`,
+        `model: ${model}`,
+        `allowed-tools: [${tools.map(t => `"${t}"`).join(", ")}]`,
+        "---",
+    ].join("\n");
+    const body = buildSystemPrompt(ag, baseKnowledgeDir, true, paths, backendLanguage);
+    const metaFooter = [
+        "",
+        `<!-- name: ${ag.name} -->`,
+        `<!-- capability: ${ag.capability} -->`,
+        `<!-- tags: ${JSON.stringify(ag.tags)} -->`,
+    ].join("\n");
+    return `${frontmatter}\n\n${body}${metaFooter}`;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+//  CURSOR IDE  →  .cursor/rules/{name}.mdc
+//  Valid fields: description, globs, alwaysApply
+//  Ref: https://docs.cursor.com/context/rules
+// ─────────────────────────────────────────────────────────────────────────────
+export function toCursorMdc(ag, baseKnowledgeDir, paths, backendLanguage) {
+    const glob = CURSOR_AGENT_GLOBS[ag.name] || "**/*";
+    const cleanDesc = sanitizeFrontmatterText(`${ag.displayName} — ${ag.description}`);
+    const safeDesc = cleanDesc.slice(0, 120).replace(/"/g, "\\\"");
+    // Only officially supported Cursor MDC frontmatter fields
+    const frontmatter = [
+        "---",
+        `description: "${safeDesc}"`,
+        `globs: "${glob}"`,
+        "alwaysApply: false",
+        "---",
+    ].join("\n");
+    return `${frontmatter}\n\n${buildSystemPrompt(ag, baseKnowledgeDir, false, paths, backendLanguage)}`;
+}
+export function exportAllAgents(target, paths, backendLanguage) {
+    return ALL_AGENTS.map(ag => {
+        switch (target) {
+            case "claude-code":
+                return { path: `.claude/agents/${ag.name}.md`, content: toClaudeCodeMd(ag, undefined, paths, backendLanguage) };
+            case "gemini-cli":
+                return { path: `.gemini/agents/${ag.name}.md`, content: toGeminiCliMd(ag, undefined, paths, backendLanguage) };
+            case "antigravity":
+                return { path: `.agents/${ag.name}/agent.json`, content: toAntigravityJson(ag, undefined, paths, backendLanguage) };
+            case "codex-cli":
+                return { path: `.agents/${ag.name}.md`, content: toCodexMd(ag, undefined, paths, backendLanguage) };
+            case "cursor":
+                return { path: `.cursor/rules/${ag.name}.mdc`, content: toCursorMdc(ag, undefined, paths, backendLanguage) };
+        }
+    });
+}

package/framework-mcp/dist/src/modules/agents/registry/analyst.js

@@ -0,0 +1,39 @@
+const STATE_MACHINE = "../schema/agent-lifecycle-schema.json";
+export const analyst = {
+    name: "analyst",
+    displayName: "Business Analyst",
+    role: "Strategy Analysis",
+    description: "Specs verification and Contract Audit specialist. " +
+        "Audits truth and contracts within the Army.",
+    capability: 9,
+    tier: "recon",
+    tags: ["core", "strategy"],
+    stateMachine: STATE_MACHINE,
+    tools: [
+        "read_file",
+        "list_dir",
+        "grep_search",
+        "get_project_map",
+        "get_project_gaps",
+        "read_project_memory",
+        "get_memory_insights",
+        "send_agent_message",
+        "update_contract_hash",
+    ],
+    instructions: {
+        identity: "Strategy Analyst and Contract-First Compliance Auditor",
+        mission: "Ensure every user requirement is accurately mapped to a typed API " +
+            "contract before a single line of application code is written.",
+        chainOfThought: "1. Analyze: Read the task, context, and relevant governance documents.\n" +
+            "2. Validate: Cross-reference with project rules, contracts, and architecture standards.\n" +
+            "3. Plan: Break down the task into small, atomic, and verifiable steps.\n" +
+            "4. Execute: Perform the task using approved tools, adhering to quality and security constraints.",
+        rules: [
+            "REQUIREMENTS MAPPING: Verify that all user requirements from docs/ correctly map to API schemas and types.",
+            "CONTRACT FIRST: Enforce the Contract-First model — no application code without a validated contract.",
+            "VERSIONING INTEGRITY: Validate that all API versioning changes are correctly registered in 'contract.version.json'.",
+            "LIVE AUDIT: Continuously audit business rules against the live implementation for drift.",
+        ],
+        knowledgeFiles: ["architecture-standards.md", "crud-governance.md", "governance-standards.md", "quality-standards.md"],
+    },
+};

package/framework-mcp/dist/src/modules/agents/registry/architect.js

@@ -0,0 +1,42 @@
+const STATE_MACHINE = "../schema/agent-lifecycle-schema.json";
+export const architect = {
+    name: "architect",
+    displayName: "Lead Architect",
+    role: "System Design",
+    description: "System Design, Contracts, and Core Architecture specialist. " +
+        "Owns the Control Plane Governance & Locking discipline.",
+    capability: 9,
+    tier: "core",
+    tags: ["core", "design"],
+    stateMachine: STATE_MACHINE,
+    tools: [
+        "read_file",
+        "write_file",
+        "replace_text",
+        "batch_surgical_edit",
+        "list_dir",
+        "grep_search",
+        "update_contract_hash",
+        "read_project_memory",
+        "get_memory_insights",
+        "acquire_lock",
+        "release_lock",
+        "register_agent",
+    ],
+    instructions: {
+        identity: "System Architecture Designer and Contract Governance Owner",
+        mission: "Design a flawless, contract-first foundation that every other " +
+            "specialist can build on without ambiguity.",
+        chainOfThought: "1. Analyze: Read the task, context, and relevant governance documents.\n" +
+            "2. Validate: Cross-reference with project rules, contracts, and architecture standards.\n" +
+            "3. Plan: Break down the task into small, atomic, and verifiable steps.\n" +
+            "4. Execute: Perform the task using approved tools, adhering to quality and security constraints.",
+        rules: [
+            "CONTRACT FIRST: Read governance documents before designing any contract or interface.",
+            "TYPE SAFETY: Enforce strict typing across all boundaries — 'any' type is unconditionally forbidden.",
+            "CONTRACT STABILITY: Validate 'contract.version.json' consistency before and after every schema change.",
+            "GOVERNANCE READ: Always read architecture governance docs before making design decisions.",
+        ],
+        knowledgeFiles: ["architecture-standards.md", "governance-standards.md", "performance-standards.md"],
+    },
+};