atabey 0.0.6 → 0.0.8

package/{src/modules/agents/definitions.ts → framework-mcp/dist/src/modules/agents/definitions.js}

@@ -13,13 +13,11 @@
 //  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 { AgentDefinition } from "./types.js";
 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";
@@ -34,8 +32,19 @@ import { analyst } from "./registry/analyst.js";
 import { native } from "./registry/native.js";
 import { explorer } from "./registry/explorer.js";
 import { git } from "./registry/git.js";
-
-export const ALL_AGENTS: AgentDefinition[] = [
+/**
+ * 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,
@@ -50,45 +59,42 @@ export const ALL_AGENTS: AgentDefinition[] = [
     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
  */
-const CLAUDE_TOOL_MAP: Record<string, string> = {
-    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",
+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",
+    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
@@ -97,68 +103,61 @@ const CLAUDE_TOOL_MAP: Record<string, string> = {
  *   read_file, write_file, replace, grep_search, glob,
  *   list_directory, run_shell_command
  */
-const GEMINI_TOOL_MAP: Record<string, string> = {
-    read_file:             "read_file",
-    write_file:            "write_file",
-    replace_text:          "replace",           // ✅ NOT replace_in_file
-    batch_surgical_edit:   "replace",           // ✅ NOT replace_in_file
-    patch_file:            "replace",           // ✅ NOT replace_in_file
-    list_dir:              "list_directory",
-    grep_search:           "grep_search",       // ✅ 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",
+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",
+    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: number,
-    platform: "claude-code" | "gemini-cli" | "antigravity" | "codex-cli"
-): string {
+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";
+            : 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";
+            : 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.
@@ -168,22 +167,16 @@ function resolveModel(
  *   frontmatter validators may misinterpret HTML comments in the document body
  *   as unrecognized YAML keys and reject the agent file entirely.
  */
-function buildSystemPrompt(
-    ag: AgentDefinition,
-    baseKnowledgeDir: string = path.join(getPackageRoot(), "templates/standards"),
-    stripMetaComments = false,
-    paths: Record<string, string> = { backend: "apps/backend", frontend: "apps/web", mobile: "apps/mobile", docs: "docs" },
-    backendLanguage: string = "Node.js (TypeScript)"
-): string {
+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: string[] = [
+    const lines = [
         ...metaHeader,
-        `# 🎖️ ${ag.displayName} — Agent Atabey`,
+        `# [ATABEY] ${ag.displayName} — Agent Atabey`,
         "",
         "## Identity",
         ag.instructions.identity,
@@ -197,11 +190,11 @@ function buildSystemPrompt(
         "",
         "## 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}\``,
+        `- **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:",
@@ -211,7 +204,7 @@ function buildSystemPrompt(
         "## Discipline Rules",
         "> These are **non-negotiable** governance mandates. Violating any rule triggers an immediate task freeze.",
         "",
-        ...ag.instructions.rules.map((r: string, i: number) => `${i + 1}. ${r}`),
+        ...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.",
@@ -220,110 +213,130 @@ function buildSystemPrompt(
         "- 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.",
+        "- 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}\`.`,
+        `- 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: string) => {
+        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}`, `> ⚠️ File not found at \`${filePath}\`. Run \`atabey init\` to scaffold standards.`);
+            }
+            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: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>, backendLanguage?: string): string {
-    const tools = [...new Set(ag.tools.map((t: string) => CLAUDE_TOOL_MAP[t] ?? t))];
+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";
-
+        : ag.tier === "recon" ? "gray"
+            : "blue";
+    const cleanDesc = sanitizeFrontmatterText(ag.description);
     // Only officially supported frontmatter fields
     const frontmatter = [
         "---",
         `name: ${ag.name}`,
         "description: >-",
-        `  ${ag.description} Invoke proactively for ${ag.role.toLowerCase()} tasks in enterprise monorepo projects.`,
+        `  ${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: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>, backendLanguage?: string): string {
-    const tools = [...new Set(ag.tools.map((t: string) => GEMINI_TOOL_MAP[t] ?? t))];
+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: >-",
-        `  ${ag.description} Use for ${ag.role.toLowerCase()} tasks.`,
+        `  ${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: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>, backendLanguage: string = "Node.js (TypeScript)"): string {
+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: string) => {
+    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: [
@@ -348,7 +361,7 @@ export function toAntigravityJson(ag: AgentDefinition, baseKnowledgeDir?: string
                     },
                     {
                         title: "Discipline Rules",
-                        content: ag.instructions.rules.map((r: string, i: number) => `${i + 1}. ${r}`).join("\n"),
+                        content: ag.instructions.rules.map((r, i) => `${i + 1}. ${r}`).join("\n"),
                     },
                     {
                         title: "Enterprise Context",
@@ -363,6 +376,7 @@ export function toAntigravityJson(ag: AgentDefinition, baseKnowledgeDir?: string
                         ].join("\n"),
                     },
                     ...knowledgeSections,
+                    ...specialtySections,
                 ],
                 toolNames: ag.tools,
             },
@@ -370,91 +384,74 @@ export function toAntigravityJson(ag: AgentDefinition, baseKnowledgeDir?: string
     };
     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: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>, backendLanguage?: string): string {
+export function toCodexMd(ag, baseKnowledgeDir, paths, backendLanguage) {
     const model = resolveModel(ag.capability, "codex-cli");
-    const tools = [...new Set(ag.tools.map((t: string) => {
-        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 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: "${ag.displayName}"`,
+        `display-name: "${cleanDisplayName}"`,
         "when-to-use: >-",
-        `  Invoke for ${ag.role.toLowerCase()} tasks. ${ag.description}`,
+        `  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: AgentDefinition, baseKnowledgeDir?: string, paths?: Record<string, string>, backendLanguage?: string): string {
+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: "${ag.displayName} — ${ag.description.slice(0, 120).replace(/"/g, "'")}"`,
-        `globs: ${glob}`,
+        `description: "${safeDesc}"`,
+        `globs: "${glob}"`,
         "alwaysApply: false",
         "---",
     ].join("\n");
-
     return `${frontmatter}\n\n${buildSystemPrompt(ag, baseKnowledgeDir, false, paths, backendLanguage)}`;
 }
-
-// ─────────────────────────────────────────────────────────────────────────────
-//  Batch export
-// ─────────────────────────────────────────────────────────────────────────────
-
-export type ExportTarget = "claude-code" | "gemini-cli" | "antigravity" | "codex-cli" | "cursor";
-
-export interface ExportedFile {
-  path: string;
-  content: string;
-}
-
-export function exportAllAgents(target: ExportTarget, paths?: Record<string, string>, backendLanguage?: string): ExportedFile[] {
+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) };
+                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) };
+                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) };
+                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) };
+                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) };
+                return { path: `.cursor/rules/${ag.name}.mdc`, content: toCursorMdc(ag, undefined, paths, backendLanguage) };
         }
     });
 }
-

package/{src/modules/agents/registry/analyst.ts → framework-mcp/dist/src/modules/agents/registry/analyst.js}

@@ -1,14 +1,10 @@
-import { AgentDefinition } from "../types.js";
-
-const STATE_MACHINE = "../schema/agent-lifecycle-schema.json" as const;
-
-export const analyst: AgentDefinition = {
+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.",
+    description: "Specs verification and Contract Audit specialist. " +
+        "Audits truth and contracts within the Army.",
     capability: 9,
     tier: "recon",
     tags: ["core", "strategy"],
@@ -26,13 +22,12 @@ export const analyst: AgentDefinition = {
     ],
     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.",
+        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.",
+            "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.",

package/{src/modules/agents/registry/architect.ts → framework-mcp/dist/src/modules/agents/registry/architect.js}

@@ -1,14 +1,10 @@
-import { AgentDefinition } from "../types.js";
-
-const STATE_MACHINE = "../schema/agent-lifecycle-schema.json" as const;
-
-export const architect: AgentDefinition = {
+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.",
+    description: "System Design, Contracts, and Core Architecture specialist. " +
+        "Owns the Control Plane Governance & Locking discipline.",
     capability: 9,
     tier: "core",
     tags: ["core", "design"],
@@ -29,13 +25,12 @@ export const architect: AgentDefinition = {
     ],
     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.",
+        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.",
+            "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.",