agent-enderun 1.1.10 → 1.10.0

package/src/cli/commands/init.ts

@@ -1,28 +1,30 @@
-import fs from "fs";
 import path from "path";
 import readline from "readline";
 
-import { logger } from "../../shared/logger.js";
 import {
-    remapFrameworkContent,
     resolveAdapter,
     runAdapterPostInit,
     scaffoldAgents,
-    type AdapterConfig,
     type AdapterId,
 } from "../adapters/index.js";
-import { SHIM_TEMPLATES } from "../shims.js";
-import { ensureDir, writeJsonFile } from "../utils/fs.js";
+import { ensureDir } from "../utils/fs.js";
 import { initializeMemory } from "../utils/memory.js";
-import { getPackageRoot, getPackageVersion } from "../utils/pkg.js";
+import { getPackageVersion } from "../utils/pkg.js";
 import { UI } from "../utils/ui.js";
 
 import { ALL_AGENTS } from "../../modules/agents/definitions.js";
-import { CORE_SKILLS } from "../../modules/skills/definitions.js";
-
-
-const FRAMEWORK_NAME = "Enderun Core";
-const FRAMEWORK_VERSION = getPackageVersion();
+import { 
+    scaffoldConstitution, 
+    scaffoldFrameworkConfigs, 
+    scaffoldShims 
+} from "./init/scaffold-core.js";
+import { 
+    scaffoldSkills, 
+    scaffoldStandards 
+} from "./init/scaffold-standards.js";
+import { scaffoldOps } from "./init/scaffold-ops.js";
+
+const FRAMEWORK_NAME = "Agent Enderun";
 
 const FRAMEWORK_SUBDIRS = [
     "agents",
@@ -36,13 +38,6 @@ const FRAMEWORK_SUBDIRS = [
     "rules",
 ];
 
-
-const COLOR_PALETTES = {
-    "Modern Blue": { primary: "#0ea5e9", secondary: "#64748b", accent: "#f43f5e" },
-    "Enterprise Slate": { primary: "#334155", secondary: "#94a3b8", accent: "#10b981" },
-    "Deep Purple": { primary: "#8b5cf6", secondary: "#d8b4fe", accent: "#f59e0b" }
-};
-
 async function runInteractiveInit(): Promise<{ selectedDirs: string[], selectedAgents: string[], selectedPalette: string }> {
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     const question = (query: string): Promise<string> => new Promise((resolve) => rl.question(query, resolve));
@@ -60,7 +55,7 @@ async function runInteractiveInit(): Promise<{ selectedDirs: string[], selectedA
         const selectedAgents = agentInput ? agentInput.split(",").map(n => ALL_AGENTS[parseInt(n.trim()) - 1].name).filter(Boolean) : ALL_AGENTS.map(a => a.name);
 
         console.warn("\nAvailable Color Palettes:");
-        const palettes = Object.keys(COLOR_PALETTES);
+        const palettes = ["Modern Blue", "Enterprise Slate", "Deep Purple"];
         palettes.forEach((p, i) => console.warn(`${i + 1}. ${p}`));
         const palInput = await question("\nSelect palette (1-3) or Enter for 'Modern Blue': ");
         const selectedPalette = palettes[parseInt(palInput.trim()) - 1] || "Modern Blue";
@@ -69,266 +64,6 @@ async function runInteractiveInit(): Promise<{ selectedDirs: string[], selectedA
     } finally { rl.close(); }
 }
 
-function scaffoldConstitution(targetDir: string, frameworkDir: string, adapterId: AdapterId, dryRun: boolean) {
-    if (dryRun) return;
-    let content = `# 🎖️ ${FRAMEWORK_NAME} — Constitution (v${FRAMEWORK_VERSION})\n\nDiscipline and Order.`;
-    let readSuccess = false;
-    try {
-        const templatePath = path.join(getPackageRoot(), "ENDERUN.md");
-        if (fs.existsSync(templatePath)) {
-            content = fs.readFileSync(templatePath, "utf8");
-            readSuccess = true;
-        }
-    } catch (e) {
-        console.warn(`⚠️  Failed to read global constitution template: ${e}`);
-    }
-    content = remapFrameworkContent(content, frameworkDir, adapterId);
-
-    // Write ONLY to the framework directory (e.g. .gemini/ENDERUN.md)
-    const destPath = path.join(targetDir, frameworkDir, "ENDERUN.md");
-    fs.writeFileSync(destPath, content);
-    console.warn(`✅ Constitution file created inside: ${frameworkDir}/ENDERUN.md${readSuccess ? "" : " (default template)"}`);
-}
-
-function scaffoldSkills(skillsBaseDir: string, dryRun: boolean) {
-    if (dryRun) return;
-    ensureDir(skillsBaseDir, dryRun);
-    for (const [key, skill] of Object.entries(CORE_SKILLS)) {
-        const mdContent = `# 🛠️ ${FRAMEWORK_NAME} Skill — ${skill.name}
-
-${skill.description}
-
-## 🔌 Associated Tools
-${skill.tools.map(t => `- \`${t}\``).join("\n")}
-
-## 🛡️ Core Mandates
-${skill.mandates.join("\n")}
-`;
-        fs.writeFileSync(path.join(skillsBaseDir, `${key.toLowerCase()}.md`), mdContent);
-    }
-}
-
-function scaffoldFrameworkConfigs(targetDir: string, fDir: string, adapter: AdapterConfig, dryRun: boolean, selectedPalette: string) {
-    if (dryRun) return;
-    const frameworkDir = path.join(targetDir, fDir);
-    const palette = COLOR_PALETTES[selectedPalette as keyof typeof COLOR_PALETTES] || COLOR_PALETTES["Modern Blue"];
-
-    const config = {
-        name: FRAMEWORK_NAME,
-        version: FRAMEWORK_VERSION,
-        theme: {
-            palette: selectedPalette,
-            colors: palette
-        }
-    };
-    writeJsonFile(path.join(frameworkDir, "config.json"), config, dryRun);
-    let statusContent = "# 🎖️ Status\n\n| Agent | State | Active Task | Last Updated | Notes | Extra | Backup |\n|---|---|---|---|---|---|---|\n";
-    for (const ag of ALL_AGENTS) {
-        statusContent += "| @" + ag.name + " | READY | Idle | - | - | - | - |\n";
-    }
-    fs.writeFileSync(path.join(frameworkDir, "STATUS.md"), statusContent);
-
-    // Scaffold eslint-standards.md
-    let knowledgeDir = "knowledge";
-    if (fDir === ".github") knowledgeDir = "instructions";
-    const eslintStandardsContent = `# 🎖️ Agent Enderun — ESLint Standards
-
-This document outlines the strict ESLint coding standards for Agent Enderun projects.
-
-## 📏 Core Rules
-- **Indentation:** 4 spaces (strict).
-- **Quotes:** Double quotes (\`"\`) for strings.
-- **Semicolons:** Always terminate statements with a semicolon (\`;\`).
-- **No Explicit Any:** Avoid using \`any\`. Use strongly typed interfaces, generics, or \`unknown\` with type assertions.
-- **Unused Variables:** Warning on unused variables unless prefixed with an underscore (\`_\`).
-`;
-    const knowledgePath = path.join(frameworkDir, knowledgeDir);
-    if (!fs.existsSync(knowledgePath)) fs.mkdirSync(knowledgePath, { recursive: true });
-    fs.writeFileSync(path.join(knowledgePath, "eslint-standards.md"), eslintStandardsContent);
-
-    // Scaffold Corporate Standards (CRUD & Architecture)
-    const standards = [
-        {
-            file: "crud-governance.md",
-            template: "templates/standards/crud-governance.md",
-            default: "# 🏛️ Corporate CRUD and Governance Standards\n\n1. **High-Risk Operations:** Requires @manager approval.\n2. **Branded Types:** Mandatory.\n3. **Kysely:** Raw SQL is forbidden."
-        },
-        {
-            file: "architecture-standards.md",
-            template: "templates/standards/architecture-standards.md",
-            default: "# 📐 Corporate Architecture Standards\n\n1. **Layered Architecture:** Route -> Service -> Repository.\n2. **Zero Mock:** Use of real data/contracts is mandatory.\n3. **any Forbidden:** TypeScript discipline."
-        },
-        {
-            file: "frontend-standards.md",
-            template: "templates/standards/frontend-standards.md",
-            default: "# 🎨 Corporate Frontend Standards\n\n1. **Style Discipline:** Type-safe or utility-first systems preferred.\n2. **Responsive-First:** Mobile-first design is mandatory.\n3. **WCAG AA:** Accessibility is standard."
-        },
-        {
-            file: "tailwind-standards.md",
-            template: "templates/standards/tailwind-standards.md",
-            default: "# 🌊 Corporate Tailwind Standards\n\n1. **No Arbitrary Values:** h-[10px] is forbidden.\n2. **Mobile-First:** sm:, md: usage is mandatory.\n3. **Prettier:** Tailwind plugin usage recommended."
-        },
-        {
-            file: "mobile-standards.md",
-            template: "templates/standards/mobile-standards.md",
-            default: "# 📱 Corporate Mobile Standards\n\n1. **Expo/React Native:** Standard platform.\n2. **Dynamic Scaling:** useWindowDimensions usage is mandatory.\n3. **FlashList:** Shopify FlashList used for large lists."
-        },
-        {
-            file: "security-standards.md",
-            template: "templates/standards/security-standards.md",
-            default: "# 🛡️ Corporate Security Standards\n\n1. **No Raw SQL:** Kysely mandatory.\n2. **RLS:** Row Level Security must be applied.\n3. **Secrets:** .env discipline."
-        },
-        {
-            file: "quality-standards.md",
-            template: "templates/standards/quality-standards.md",
-            default: "# ⚖️ Corporate Code Quality Standards\n\n1. **Zero any:** TypeScript discipline.\n2. **Zero Warnings:** ESLint clean.\n3. **4 Spaces:** Indentation rule."
-        },
-        {
-            file: "logging-and-secrets.md",
-            template: "templates/standards/logging-and-secrets.md",
-            default: "# 🪵 Corporate Logging Standards\n\n1. **Zero Console:** console.log is forbidden.\n2. **Logger:** Corporate logger used.\n3. **Secrets:** .env discipline mandatory."
-        },
-        {
-            file: "testing-standards.md",
-            template: "templates/standards/testing-standards.md",
-            default: "# 🧪 Corporate Testing Standards\n\n1. **Framework:** Vitest used.\n2. **Naming:** .test.ts format.\n3. **Zero Mock:** Internal services not mocked."
-        },
-        {
-            file: "i18n-standards.md",
-            template: "templates/standards/i18n-standards.md",
-            default: "# 🌐 Corporate i18n Standards\n\n1. **No Hardcoded:** Text kept in JSON.\n2. **i18next:** Standard library.\n3. **Centralized:** Locales directory mandatory."
-        }
-    ];
-
-    for (const std of standards) {
-        let content = std.default;
-        try {
-            const fullTemplatePath = path.join(getPackageRoot(), std.template);
-            if (fs.existsSync(fullTemplatePath)) {
-                content = fs.readFileSync(fullTemplatePath, "utf8");
-            }
-        } catch {
-            // Intentional: if the template file is unreadable, fall back to the inline default.
-            // No logging needed — the default value is a valid fallback, not an error condition.
-        }
-        fs.writeFileSync(path.join(knowledgePath, std.file), content);
-    }
-
-    // Scaffold Prompt Recipes
-    const promptsPath = path.join(frameworkDir, "prompts");
-    if (!fs.existsSync(promptsPath)) fs.mkdirSync(promptsPath, { recursive: true });
-
-    const recipes = [
-        { file: "refactoring-recipe.md", template: "templates/prompts/refactoring-recipe.md" },
-        { file: "bug-fix-recipe.md", template: "templates/prompts/bug-fix-recipe.md" },
-        { file: "new-feature-recipe.md", template: "templates/prompts/new-feature-recipe.md" }
-    ];
-
-    for (const recipe of recipes) {
-        try {
-            const fullTemplatePath = path.join(getPackageRoot(), recipe.template);
-            if (fs.existsSync(fullTemplatePath)) {
-                const content = fs.readFileSync(fullTemplatePath, "utf8");
-                fs.writeFileSync(path.join(promptsPath, recipe.file), content);
-            }
-        } catch (e) {
-            logger.debug(`Failed to scaffold prompt recipe: ${recipe.file}`, e);
-        }
-    }
-
-    // Scaffold cli-commands.json
-    const cliCommands = {
-        commands: {
-            init: { agent: "manager", description: "Initialize Enderun Core structure and AI configuration." },
-            check: { agent: "quality", description: "Verify framework files and code quality discipline." },
-            status: { agent: "manager", description: "Show the current status of the active project phase." },
-            "trace:new": { agent: "manager", description: "Generate a new Trace ID to start a task sequence." },
-            orchestrate: { agent: "manager", description: "Execute the Hermes message broker loop." },
-            "verify-contract": { agent: "architect", description: "Validate type contracts between backend and frontend." },
-            "update-contract": { agent: "architect", description: "Update the contract signature hash." }
-        }
-    };
-    writeJsonFile(path.join(frameworkDir, "cli-commands.json"), cliCommands, dryRun);
-
-    // Scaffold BRAIN_DASHBOARD.md
-    fs.writeFileSync(path.join(frameworkDir, "BRAIN_DASHBOARD.md"), "# 🧠 Brain Dashboard\n\nActive Trace: T-000\nActive Phase: PHASE_0 (Genesis)\n\n## Agent Statuses\n- @manager: READY\n- @architect: READY\n- @backend: READY\n- @frontend: READY\n- @quality: READY\n");
-
-    // Scaffold router/routing_rules.md
-    const routerDir = path.join(frameworkDir, "router");
-    if (!fs.existsSync(routerDir)) fs.mkdirSync(routerDir, { recursive: true });
-    fs.writeFileSync(
-        path.join(routerDir, "routing_rules.md"),
-        `# 📡 Agent Enderun — Natural Language & Event Router
-
-This configuration governs how user inputs and event messages are routed across the 12 expert agents.
-
-## 🧭 Routing Engine Protocols
-- **User Input Routing:** By default, all un-targeted natural language prompts are routed to the \`@manager\` agent for analysis and decomposition into a Directed Acyclic Graph (DAG) task list.
-- **Targeted Input Routing:** Prompts beginning with \`@<agent_name>\` (e.g., \`@backend\`) bypass the general manager routing and are directly appended to the target agent's Hermes mailbox.
-- **Hermes Event Loops:** Agents publish status changes and handoffs which the message broker routes dynamically according to active dependencies.
-`
-    );
-
-    // Scaffold registry/agent_registry.md
-    const registryDir = path.join(frameworkDir, "registry");
-    if (!fs.existsSync(registryDir)) fs.mkdirSync(registryDir, { recursive: true });
-    fs.writeFileSync(
-        path.join(registryDir, "agent_registry.md"),
-        `# 🎖️ Agent Enderun — Army Registry
-
-List of active agents, their roles, capacities, and matching directory patterns.
-
-| Agent Name | Role | Scope / Globs | Action Compliance |
-|---|---|---|---|
-| \`@manager\` | Orchestrator & Controller | \`*\` | Rules Verification |
-| \`@quality\` | Quality & Test Enforcer | \`*\` | AST Security Scans |
-| \`@database\` | Database Optimizer | \`apps/backend/src/database/**/*\` | Schema & Migrations |
-| \`@backend\` | Core Domain Developer | \`apps/backend/**/*\` | Branded Types & APIs |
-| \`@frontend\` | UI/UX Developer | \`apps/web/**/*\` | Panda CSS, Fluid UI |
-| \`@mobile\` | Mobile App Specialist | \`apps/mobile/**/*\` | Expo/React Native |
-| \`@native\` | Desktop / Native Integrator | \`apps/native/**/*\` | Electron/Tauri |
-| \`@devops\` | Deployment & CI/CD | CI/CD YAML & Deployment files | Native Rollbacks |
-| \`@explorer\` | Codebase Discovery | All source directories | Onboarding & Audit |
-| \`@git\` | Version Control System | \`.git/\` & Commit traces | Trace ID commits |
-| \`@security\` | Security Officer | All source directories | RLS & Secrets Scan |
-| \`@analyst\` | Contract Validator | Contract and API schema definitions | SHA-256 validation |
-`
-    );
-
-    // Scaffold observability files
-    const obsDir = path.join(frameworkDir, "observability");
-    if (!fs.existsSync(obsDir)) fs.mkdirSync(obsDir, { recursive: true });
-
-    // Add audit log
-    const auditLogPath = path.join(obsDir, "audit_log.md");
-    if (!fs.existsSync(auditLogPath)) {
-        fs.writeFileSync(auditLogPath, "# 🎖️ Agent Enderun — Audit Log\n\n| Timestamp | Agent | Action | Trace ID | Status |\n|---|---|---|---|---|\n");
-    }
-
-    // Add metrics.json
-    const metricsPath = path.join(obsDir, "metrics.json");
-    if (!fs.existsSync(metricsPath)) {
-        fs.writeFileSync(metricsPath, "[]");
-    }
-
-    // Scaffold rules
-    const rulesDir = path.join(frameworkDir, "rules");
-    if (!fs.existsSync(rulesDir)) fs.mkdirSync(rulesDir, { recursive: true });
-    fs.writeFileSync(path.join(rulesDir, "global_rules.mdc"), `---
-description: Global Rules for Agent Enderun Army
-globs: **/*
----
-
-# 🎖️ Agent Enderun — Global Army Rules
-
-- **Traceability:** Prefix every commit and log with the active Trace ID.
-- **Surgical Edits:** Use \`replace_text\` or \`patch_file\` tools. Overwriting entire files is forbidden.
-- **Contract-First:** Verify types before implementation.
-- **Zero Mock:** Use real data contracts.
-- **any Forbidden:** Strictly use TypeScript types.
-`);
-}
-
 export async function initCommand(adapterName: string, options: { unified?: boolean, dryRun?: boolean, yes?: boolean }) {
     const adapterId = (adapterName || "gemini") as AdapterId;
     const adapter = resolveAdapter(adapterId);
@@ -348,7 +83,7 @@ export async function initCommand(adapterName: string, options: { unified?: bool
     const dryRun = options.dryRun || false;
     const forceYes = options.yes || false;
 
-    UI.intent("Enderun Initialization", `Bootstrapping ${FRAMEWORK_NAME} (v${FRAMEWORK_VERSION}) with ${adapterId} adapter...`);
+    UI.intent("Enderun Initialization", `Bootstrapping ${FRAMEWORK_NAME} (v${getPackageVersion()}) with ${adapterId} adapter...`);
 
     let selectedDirs: string[];
     let selectedAgents: string[];
@@ -383,21 +118,15 @@ export async function initCommand(adapterName: string, options: { unified?: bool
     const skillsBaseDir = path.join(projectRoot, aiToolDir, "skills");
     scaffoldSkills(skillsBaseDir, dryRun);
 
-    initializeMemory(projectRoot, dryRun);
+    initializeMemory(path.join(projectRoot, coreDir), dryRun);
     scaffoldFrameworkConfigs(projectRoot, coreDir, adapter, dryRun, selectedPalette);
-
-    for (const [name, content] of Object.entries(SHIM_TEMPLATES)) {
-        if (name.toLowerCase() === adapterId.split("-")[0] || name === adapterId) {
-            const shimContent = remapFrameworkContent(content, coreDir, adapterId);
-            const shimFileName = adapter.shimFile || `${name.toUpperCase()}.md`;
-            if (!dryRun) fs.writeFileSync(path.join(projectRoot, shimFileName), shimContent);
-            console.warn(`✅ Platform shim created: ${shimFileName}`);
-        }
-    }
+    scaffoldStandards(path.join(projectRoot, coreDir), dryRun);
+    scaffoldOps(path.join(projectRoot, coreDir), dryRun);
+    scaffoldShims(projectRoot, coreDir, adapterId, adapter, dryRun);
 
     runAdapterPostInit(adapter, projectRoot);
 
-    UI.success(`\n🚀 ${FRAMEWORK_NAME} initialized successfully!`);
+    UI.success(`\n🚀 ${FRAMEWORK_NAME} (v${getPackageVersion()}) initialized successfully!`);
     console.warn(`\n- Brain & Memory Hub (Protected): ${coreDir}/`);
     console.warn(`- AI Agent Commands (Active): ${aiToolDir}/`);
     console.warn("\nNext Steps:");

package/src/cli/commands/knowledge.ts

@@ -3,7 +3,9 @@ import path from "path";
 
 import { getFrameworkDir } from "../utils/memory.js";
 
-export function updateKnowledgeBaseCommand(topic: string, content: string) {
+import { writeTextFile } from "../utils/fs.js";
+
+export async function updateKnowledgeBaseCommand(topic: string, content: string) {
     if (!topic || !content) {
         console.error("❌ Usage: agent-enderun update_knowledge_base <topic> <content>");
         return;
@@ -12,11 +14,11 @@ export function updateKnowledgeBaseCommand(topic: string, content: string) {
     const kbDir = path.join(frameworkDir, "knowledge");
     if (!fs.existsSync(kbDir)) fs.mkdirSync(kbDir, { recursive: true });
     const fileName = topic.replace(/[^a-z0-9]/gi, "_").toLowerCase() + ".md";
-    fs.writeFileSync(path.join(kbDir, fileName), content);
+    writeTextFile(path.join(kbDir, fileName), content);
     console.warn(`✅ Knowledge base updated: ${topic}`);
 }
 
-export function searchKnowledgeBaseCommand(query: string) {
+export async function searchKnowledgeBaseCommand(query: string) {
     if (!query) {
         console.error("❌ Usage: agent-enderun search_knowledge_base <query>");
         return;

package/src/cli/commands/lint.ts

@@ -2,13 +2,11 @@ import { execSync } from "child_process";
 
 import { getPackageVersion } from "../utils/pkg.js";
 
-const FRAMEWORK_VERSION = getPackageVersion();
-
 /**
  * Run ESLint for the project (same as npm run lint).
  */
-export function lintCommand(): void {
-    console.warn(`🔍 Running ESLint (v${FRAMEWORK_VERSION})...`);
+export async function lintCommand(): Promise<void> {
+    console.warn(`🔍 Running ESLint (v${getPackageVersion()})...`);
     const projectRoot = process.cwd();
     try {
         execSync("npm run lint", {

package/src/cli/commands/log.ts

@@ -4,7 +4,9 @@ import path from "path";
 import { getFrameworkDir } from "../utils/memory.js";
 import { normalizeAgentName } from "../utils/string.js";
 
-export function logAgentActionCommand(data: { agent?: unknown; action?: string; requestId?: string; traceId?: string; status?: string; summary?: string; files?: string[]; details?: Record<string, unknown> }) {
+import { writeJsonFile } from "../utils/fs.js";
+
+export async function logAgentActionCommand(data: { agent?: unknown; action?: string; requestId?: string; traceId?: string; status?: string; summary?: string; files?: string[]; details?: Record<string, unknown> }) {
     const frameworkDir = getFrameworkDir();
     const logsDir = path.join(frameworkDir, "logs");
     if (!fs.existsSync(logsDir)) {
@@ -30,6 +32,6 @@ export function logAgentActionCommand(data: { agent?: unknown; action?: string;
     };
 
     logs.push(newEntry);
-    fs.writeFileSync(logPath, JSON.stringify(logs, null, 2));
+    writeJsonFile(logPath, logs);
     console.warn(`✅ Logged action to ${frameworkDir}/logs/${agent}.json`);
 }

package/src/cli/commands/memory.ts

@@ -1,6 +1,6 @@
 import { updateProjectMemory } from "../utils/memory.js";
 
-export function updateProjectMemoryCommand(section: string, content: string) {
+export async function updateProjectMemoryCommand(section: string, content: string) {
     updateProjectMemory(section, content);
 }