agent-enderun 1.1.9 → 1.10.0

package/dist/tests/time.test.js

@@ -22,7 +22,7 @@ describe("Time Utilities", () => {
             expect(ulid1).toBe(ulid2);
             expect(ulid1).toHaveLength(26);
             // Ensure first 10 chars encode seedTime correctly in base32
-            expect(ulid1.substring(0, 10)).toBe("01HY7Y2A00");
+            expect(ulid1.substring(0, 10)).toBe("01HZQZXF00");
         });
         it("should generate different random parts without a seed even at the same seedTime", () => {
             const seedTime = Date.now();

package/dist/tests/trace.test.js

@@ -1,61 +1,28 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
 import fs from "fs";
 import path from "path";
+import os from "os";
+import * as memoryUtils from "../src/cli/utils/memory.js";
 import { traceNewCommand } from "../src/cli/commands/trace.js";
 describe("Trace Command", () => {
-    const tempDir = path.join(process.cwd(), "tests", "temp-trace-test");
-    let cwdSpy;
+    let tempDir;
+    let memoryDir;
     beforeEach(() => {
-        vi.resetModules();
-        if (!fs.existsSync(tempDir)) {
-            fs.mkdirSync(tempDir, { recursive: true });
-        }
-        cwdSpy = vi.spyOn(process, "cwd").mockReturnValue(tempDir);
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "enderun-trace-test-"));
+        memoryDir = path.join(tempDir, "memory");
+        process.env.ENDERUN_TEST_DIR = tempDir;
+        // Initialize store
+        memoryUtils.initDocumentStore(tempDir);
     });
     afterEach(() => {
-        cwdSpy.mockRestore();
-        if (fs.existsSync(tempDir)) {
-            fs.rmSync(tempDir, { recursive: true, force: true });
-        }
+        fs.rmSync(tempDir, { recursive: true, force: true });
+        delete process.env.ENDERUN_TEST_DIR;
     });
-    it("should print error if PROJECT_MEMORY.md is missing", async () => {
-        const consoleErrorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
-        const result = traceNewCommand("Test description");
-        expect(result).toBeUndefined();
-        expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining("PROJECT_MEMORY.md not found"));
-        consoleErrorSpy.mockRestore();
-    });
-    it("should print error if ACTIVE TASKS table is missing in PROJECT_MEMORY.md", async () => {
-        // Setup mock environment structure
-        const frameworkDir = path.join(tempDir, ".gemini");
-        fs.mkdirSync(frameworkDir, { recursive: true });
-        const memoryPath = path.join(frameworkDir, "PROJECT_MEMORY.md");
-        fs.writeFileSync(memoryPath, "# PROJECT MEMORY\nNo tasks table here.\n");
-        const consoleErrorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
-        const result = traceNewCommand("Test description");
-        expect(result).toBeUndefined();
-        expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining("ACTIVE TASKS table not found"));
-        consoleErrorSpy.mockRestore();
-    });
-    it("should successfully generate Trace ID and add task to table", async () => {
-        const frameworkDir = path.join(tempDir, ".gemini");
-        fs.mkdirSync(frameworkDir, { recursive: true });
-        const memoryPath = path.join(frameworkDir, "PROJECT_MEMORY.md");
-        // Setup proper template with ACTIVE TASKS table
-        const template = "## CURRENT STATUS\n\n## ACTIVE TASKS\n| Trace ID | Description | Agent | Priority | Status |\n| :--- | :--- | :--- | :--- | :--- |\n";
-        fs.writeFileSync(memoryPath, template);
-        const consoleWarnSpy = vi.spyOn(console, "warn").mockImplementation(() => { });
+    it("should successfully generate Trace ID and add task to JSON store", () => {
         const traceId = traceNewCommand("Implement tests", "coder", "P1");
         expect(traceId).toBeDefined();
-        expect(typeof traceId).toBe("string");
-        expect(traceId).toHaveLength(26);
-        const updatedContent = fs.readFileSync(memoryPath, "utf8");
-        expect(updatedContent).toContain(traceId);
-        expect(updatedContent).toContain("Implement tests");
-        expect(updatedContent).toContain("@coder");
-        expect(updatedContent).toContain("P1");
-        expect(updatedContent).toContain("IN_PROGRESS");
-        consoleWarnSpy.mockRestore();
+        const taskPath = path.join(memoryDir, "tasks", `${traceId}.json`);
+        expect(fs.existsSync(taskPath)).toBe(true);
     });
 });
 //# sourceMappingURL=trace.test.js.map

package/dist/tests/trace.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.test.js","sourceRoot":"","sources":["../../tests/trace.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trace.test.js","sourceRoot":"","sources":["../../tests/trace.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,KAAK,WAAW,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC3B,IAAI,OAAe,CAAC;IACpB,IAAI,SAAiB,CAAC;IAEtB,UAAU,CAAC,GAAG,EAAE;QACZ,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAAC,CAAC;QACxE,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,OAAO,CAAC;QAEvC,mBAAmB;QACnB,WAAW,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACX,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QACxE,MAAM,OAAO,GAAG,eAAe,CAAC,iBAAiB,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAElE,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAE9B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,OAAO,OAAO,CAAC,CAAC;QAClE,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-enderun",
-  "version": "1.1.9",
-  "description": "The Supreme AI Governance & Autonomous Orchestration Framework for Enterprise Development. Acts as a Corporate AL Management Assistant.",
+  "version": "1.10.0",
+  "description": "The Supreme AI Governance & Autonomous Orchestration Framework for Enterprise Development. Acts as a Corporate AI Management Assistant.",
   "author": "Yusuf BEKAR",
   "license": "MIT",
   "readme": "README.md",
@@ -31,24 +31,10 @@
   },
   "files": [
     "bin",
-    "src",
     "dist",
-    "framework-mcp",
-    ".enderun",
-    "ENDERUN.md",
+    "src",
     "README.md",
-    "LICENSE",
-    "tsconfig.json",
-    "eslint.config.js",
-    "panda.config.ts",
-    "GEMINI.md",
-    "CLAUDE.md",
-    "GROK.md",
-    "agent.md",
-    "docs",
-    "templates",
-    ".cursor",
-    ".github"
+    "LICENSE"
   ],
   "scripts": {
     "build": "tsc && npm run build --prefix framework-mcp",
@@ -62,7 +48,6 @@
     "enderun:check": "agent-enderun check",
     "enderun:dashboard": "node bin/enderun-dashboard.js",
     "test:init": "node dist/src/cli/index.js init",
-    "test:init:run": "node bin/test-init-run.js",
     "enderun:lint": "eslint .",
     "lint": "eslint .",
     "prepublishOnly": "npm run build",
@@ -84,7 +69,7 @@
     "vitest": "^4.1.7"
   },
   "enderun": {
-    "version": "1.1.9",
+    "version": "1.10.0",
     "initializedAt": "2026-06-04T18:51:28.970Z",
     "frameworkDir": ".gemini"
   },

package/src/cli/adapters/core.ts

@@ -0,0 +1,53 @@
+import fs from "fs";
+import path from "path";
+import { writeJsonFile } from "../utils/fs.js";
+import { getPackageRoot } from "../utils/pkg.js";
+
+import type { AdapterConfig, AdapterId } from "../../modules/adapters/types.js";
+import { ADAPTER_CONFIGS, POST_INIT_HANDLERS } from "../../modules/adapters/definitions.js";
+
+export const ADAPTERS: Record<AdapterId, AdapterConfig> = ADAPTER_CONFIGS;
+
+export const SHIM_FILES = (Object.keys(ADAPTERS) as AdapterId[]).map((id) => ADAPTERS[id].shimFile);
+
+export const FRAMEWORK_DIR_CANDIDATES = [
+    ".enderun",
+    ".cursor",
+    ".claude",
+    ".github",
+    ".grok",
+    ".antigravity",
+    ".agent",
+    ".gemini/antigravity-cli",
+    ".gemini",
+    ".agents",
+] as const;
+
+export function buildMcpServerEntry(projectRoot: string) {
+    const packageRoot = getPackageRoot();
+    const mcpServerPath = path.join(packageRoot, "framework-mcp/dist/index.js");
+    const relativePath = path.relative(projectRoot, mcpServerPath) || mcpServerPath;
+
+    return {
+        command: "node",
+        args: [relativePath],
+        env: {
+            ENDERUN_PROJECT_ROOT: projectRoot,
+        },
+    };
+}
+
+export function runAdapterPostInit(adapter: AdapterConfig, projectRoot: string): void {
+    const mcpEntry = buildMcpServerEntry(projectRoot);
+    const mcpBlock = { mcpServers: { "agent-enderun": mcpEntry } };
+
+    const postInitFn = POST_INIT_HANDLERS[adapter.id];
+    if (postInitFn) {
+        postInitFn(projectRoot, mcpBlock);
+    }
+
+    const rootMcpPath = path.join(projectRoot, "mcp.json");
+    if (!fs.existsSync(rootMcpPath)) {
+        writeJsonFile(rootMcpPath, mcpBlock);
+    }
+}

package/src/cli/adapters/index.ts

@@ -0,0 +1,4 @@
+export { ADAPTER_IDS, type AdapterConfig, type AdapterId, type AdapterRole } from "../../modules/adapters/types.js";
+export { ADAPTERS, FRAMEWORK_DIR_CANDIDATES, runAdapterPostInit, buildMcpServerEntry } from "./core.js";
+export { resolveAdapter, isAdapterShimFile, remapFrameworkContent } from "./utils.js";
+export { scaffoldAgents } from "./scaffold.js";

package/src/cli/adapters/scaffold.ts

@@ -0,0 +1,78 @@
+import { writeTextFile } from "../utils/fs.js";
+import path from "path";
+import fs from "fs";
+import { 
+    ALL_AGENTS, 
+    toClaudeCodeMd, 
+    toGeminiCliMd, 
+    toCodexMd, 
+    toAntigravityJson,
+    toCursorMdc
+} from "../../modules/agents/definitions.js";
+
+import type { AdapterId } from "../../modules/adapters/types.js";
+import { ADAPTERS } from "./core.js";
+
+export function scaffoldAgents(projectRoot: string, adapterId: AdapterId, dryRun: boolean, agentsToScaffold?: string[]): void {
+    const adapter = ADAPTERS[adapterId];
+    if (!adapter || !adapter.agentsDir || !adapter.agentsExt) return;
+
+    const allowedAgents = agentsToScaffold ? new Set(agentsToScaffold) : undefined;
+    const destAgentsDir = path.join(projectRoot, adapter.agentsDir);
+
+    const baseKnowledgeDir = path.join(projectRoot, "templates/standards");
+
+    try {
+        if (!dryRun) fs.mkdirSync(destAgentsDir, { recursive: true });
+
+        for (const agent of ALL_AGENTS) {
+            if (allowedAgents && !allowedAgents.has(agent.name)) continue;
+            
+            let content = "";
+            let fileName = `${agent.name}${adapter.agentsExt}`;
+            let secondaryContent: string | null = null;
+            let secondaryFileName: string | null = null;
+
+            switch (adapterId) {
+                case "gemini":
+                    content = toGeminiCliMd(agent, baseKnowledgeDir);
+                    break;
+                case "claude":
+                    content = toClaudeCodeMd(agent, baseKnowledgeDir);
+                    break;
+                case "cursor":
+                    content = toCursorMdc(agent, baseKnowledgeDir);
+                    break;
+                case "codex":
+                    content = toCodexMd(agent, baseKnowledgeDir);
+                    break;
+                case "antigravity-cli": {
+                    // Antigravity uses nested folders: agents/{name}/agent.json and agents/{name}/agent.md
+                    const agentDir = path.join(destAgentsDir, agent.name);
+                    if (!dryRun) fs.mkdirSync(agentDir, { recursive: true });
+                    
+                    content = toAntigravityJson(agent);
+                    fileName = path.join(agent.name, "agent.json");
+                    
+                    secondaryContent = `# 🎖️ Agent Enderun — @${agent.name}\n\n${agent.instructions.identity}\n\n${agent.instructions.mission}`;
+                    secondaryFileName = path.join(agent.name, "agent.md");
+                    break;
+                }
+                default:
+                    // Fallback to Gemini format
+                    content = toGeminiCliMd(agent, baseKnowledgeDir);
+                    break;
+            }
+
+            if (!dryRun) {
+                writeTextFile(path.join(destAgentsDir, fileName), content, dryRun);
+                if (secondaryContent && secondaryFileName) {
+                    writeTextFile(path.join(destAgentsDir, secondaryFileName), secondaryContent, dryRun);
+                }
+            }
+        }
+        console.warn(`✅ Generated ${allowedAgents ? allowedAgents.size : ALL_AGENTS.length} Agent/Rule definitions under ${path.relative(projectRoot, destAgentsDir)}/`);
+    } catch (e) {
+        console.warn(`⚠️  Failed to scaffold agents: ${e}`);
+    }
+}

package/src/cli/adapters/utils.ts

@@ -0,0 +1,87 @@
+import fs from "fs";
+import path from "path";
+import { logger } from "../../shared/logger.js";
+import { UI } from "../utils/ui.js";
+
+import type { AdapterConfig, AdapterId } from "../../modules/adapters/types.js";
+import { ADAPTERS, SHIM_FILES } from "./core.js";
+
+export function resolveAdapter(input?: string): AdapterConfig {
+    let normalized = (input || "gemini").toLowerCase();
+    if (normalized === "antigravity") {
+        normalized = "antigravity-cli";
+    } else if (normalized === "copilot" || normalized === "github") {
+        normalized = "codex";
+    }
+
+    let config: AdapterConfig;
+    if (normalized in ADAPTERS) {
+        config = { ...ADAPTERS[normalized as AdapterId] };
+    } else {
+        UI.warning(`Unknown adapter "${input}". Falling back to gemini.`);
+        config = { ...ADAPTERS.gemini };
+    }
+
+    return config;
+}
+
+export function isAdapterShimFile(fileName: string): boolean {
+    return SHIM_FILES.includes(fileName);
+}
+
+export function remapFrameworkContent(
+    content: string,
+    frameworkDir: string,
+    adapterId: AdapterId,
+): string {
+    let result = content;
+
+    result = result.replace(/\{\{FRAMEWORK_DIR\}\}/g, frameworkDir);
+    result = result.replace(/\{\{ADAPTER\}\}/g, adapterId);
+
+    let agentFolder = "agents";
+    let knowledgeFolder = "knowledge";
+
+    if (frameworkDir !== ".enderun") {
+        if (adapterId === "antigravity-cli") {
+            agentFolder = "agents";
+            knowledgeFolder = "rules";
+        } else if (adapterId === "grok") {
+            agentFolder = "plugins";
+        }
+    }
+
+    const frameworkPattern = ".enderun/";
+    result = result.replace(new RegExp(frameworkPattern + "agents/", "g"), `${frameworkDir}/${agentFolder}/`);
+    result = result.replace(new RegExp(frameworkPattern + "knowledge/", "g"), `${frameworkDir}/${knowledgeFolder}/`);
+
+    result = result.replace(/\.enderun\//g, `${frameworkDir}/`);
+    result = result.replace(/`\.enderun`/g, `\`${frameworkDir}\``);
+    result = result.replace(/\.enderun(?![\w/-])/g, frameworkDir);
+
+    let backend = "apps/backend";
+    let frontend = "apps/web";
+    let docs = "docs";
+    let tests = "tests";
+    try {
+        const configPath = path.join(process.cwd(), frameworkDir, "config.json");
+        if (fs.existsSync(configPath)) {
+            const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+            if (config.paths) {
+                if (config.paths.backend) backend = config.paths.backend;
+                if (config.paths.frontend) frontend = config.paths.frontend;
+                if (config.paths.docs) docs = config.paths.docs;
+                if (config.paths.tests) tests = config.paths.tests;
+            }
+        }
+    } catch (err) {
+        logger.debug("Failed to read config.json in remapFrameworkContent", err);
+    }
+
+    result = result.replace(/\{\{BACKEND_DIR\}\}/g, backend);
+    result = result.replace(/\{\{FRONTEND_DIR\}\}/g, frontend);
+    result = result.replace(/\{\{DOCS_DIR\}\}/g, docs);
+    result = result.replace(/\{\{TESTS_DIR\}\}/g, tests);
+
+    return result;
+}

package/src/cli/commands/app.ts

@@ -1,20 +1,38 @@
 import fs from "fs";
 
-import { updateMemoryForGeneratedApp, collectCreateAppDescription, inferAppSpec, createBackendFiles, createWebFiles, updateProjectDocs } from "../utils/app.js";
+import { updateMemoryForGeneratedApp, collectCreateAppDescription, inferAppSpec, createBackendFiles, createWebFiles, createMobileFiles, updateProjectDocs } from "../utils/app.js";
 import { traceNewCommand } from "./trace.js";
 import { getMemoryPath } from "../utils/memory.js";
 
+import { ValidationError } from "../../shared/errors.js";
+
 /**
  * Generate a new application based on natural language input.
  */
 export async function createAppCommand(args: string[]) {
+    if (!fs.existsSync("apps")) {
+        throw new ValidationError(
+            "The 'apps/' directory is missing.",
+            null,
+            "Ensure you are in the project root and the 'apps/' folder exists. Run 'mkdir apps' if needed."
+        );
+    }
     const description = await collectCreateAppDescription(args);
     const spec = inferAppSpec(description);
 
-    console.warn(`🚀 Generating Enterprise App: ${spec.title}...`);
+    console.warn(`🚀 Generating Enterprise App: ${spec.title} (Platform: ${spec.platform})...`);
+
+    if (spec.platform === "full-stack") {
+        createBackendFiles(spec);
+        createWebFiles(spec);
+    } else if (spec.platform === "web") {
+        createWebFiles(spec);
+    } else if (spec.platform === "mobile") {
+        createMobileFiles(spec);
+    } else if (spec.platform === "backend") {
+        createBackendFiles(spec);
+    }
 
-    createBackendFiles(spec);
-    createWebFiles(spec);
     updateProjectDocs(spec);
 
     const memoryPath = getMemoryPath();
@@ -26,7 +44,7 @@ export async function createAppCommand(args: string[]) {
         if (match) traceId = match[1].trim();
     }
 
-    const activeTraceId = traceNewCommand(`Generate ${spec.title} from natural language request`, "manager", "P1") || traceId;
+    const activeTraceId = (await traceNewCommand(`Generate ${spec.title} from natural language request`, "manager", "P1")) || traceId;
     updateMemoryForGeneratedApp(spec, activeTraceId);
 
     console.warn("\n✨ Application scaffolded successfully!");

package/src/cli/commands/approve.ts

@@ -2,16 +2,21 @@ import fs from "fs";
 import path from "path";
 import { getFrameworkDir } from "../utils/memory.js";
 import { UI } from "../utils/ui.js";
+import { writeTextFile, appendFile } from "../utils/fs.js";
+import { ValidationError } from "../../shared/errors.js";
 
 import { HermesMessageSchema } from "./orchestrate.js";
 
-export function approveCommand(traceId: string) {
+export async function approveCommand(traceId: string) {
     const frameworkDir = getFrameworkDir();
     const messagesDir = path.join(frameworkDir, "messages");
 
     if (!fs.existsSync(messagesDir)) {
-        UI.error("No messages directory found.");
-        process.exit(1);
+        throw new ValidationError(
+            "No messages directory found.",
+            null,
+            "Ensure the framework is initialized and the Hermes orchestrator has been run at least once."
+        );
     }
 
     const files = fs.readdirSync(messagesDir).filter((f) => f.endsWith(".json"));
@@ -43,7 +48,7 @@ export function approveCommand(traceId: string) {
             });
 
             if (updated) {
-                fs.writeFileSync(filePath, newLines.join("\n") + "\n", "utf8");
+                writeTextFile(filePath, newLines.join("\n") + "\n");
             }
         } catch (e) {
             UI.error(`Error reading or updating message file ${file}: ${(e as Error).message}`);
@@ -55,11 +60,14 @@ export function approveCommand(traceId: string) {
         const auditPath = path.join(frameworkDir, "observability/audit_log.md");
         if (fs.existsSync(auditPath)) {
             const logEntry = "\n- **[" + new Date().toISOString() + "]** USER -> @manager | APPROVED | Trace: " + traceId;
-            fs.appendFileSync(auditPath, logEntry);
+            appendFile(auditPath, logEntry);
         }
         UI.success("Successfully approved Trace: " + traceId);
     } else {
-        UI.error("No pending approval request found for Trace ID: " + traceId);
-        process.exit(1);
+        throw new ValidationError(
+            `No pending approval request found for Trace ID: ${traceId}`,
+            null,
+            "Run 'npx agent-enderun status' to see active traces and ensure the ID is correct and pending approval."
+        );
     }
 }

package/src/cli/commands/check.ts

@@ -6,11 +6,11 @@ import { getFrameworkDir, getMemoryPath, getConfiguredPaths } from "../utils/mem
 import { getPackageVersion, getValidatorPath } from "../utils/pkg.js";
 import { UI } from "../utils/ui.js";
 import { logger } from "../../shared/logger.js";
+import { scanProjectCompliance } from "../utils/compliance.js";
+import { ALL_AGENTS } from "../../modules/agents/definitions.js";
 
-const FRAMEWORK_VERSION = getPackageVersion();
-
-export function checkCommand() {
-    UI.intent("Enderun Core Health Check", `Sistem sağlığı ve disiplin kuralları denetleniyor (v${FRAMEWORK_VERSION})...`);
+export async function checkCommand() {
+    UI.intent("Agent Enderun Health Check", `Checking system health and discipline rules (v${getPackageVersion()})...`);
     let issues = 0;
 
     const frameworkDir = getFrameworkDir();
@@ -97,22 +97,50 @@ export function checkCommand() {
         issues++;
     }
 
-    // Code Quality
-    console.warn("\n⚖️  Checking Discipline (Code Quality)...");
-    const consoleLogIssues = checkConsoleLogs();
-    if (consoleLogIssues.length > 0) {
-        UI.error(`Forbidden 'console.log' found in ${consoleLogIssues.length} locations.`);
-        issues++;
+    // Agent Documentation Check (Live Integrity)
+    console.warn("\n📚 Checking Agent Integrity (Instructions)...");
+    
+    // We check both the main framework dir and common subdirs
+    const possibleAgentDirs = [
+        path.join(process.cwd(), ".agents"),
+        path.join(process.cwd(), ".gemini/agents"),
+        path.join(process.cwd(), ".claude/agents"),
+        path.join(process.cwd(), ".cursor/rules"),
+        path.join(process.cwd(), ".grok"),
+        path.join(process.cwd(), ".antigravity/agents"),
+    ];
+
+    const activeAgentDir = possibleAgentDirs.find(d => fs.existsSync(d));
+
+    if (activeAgentDir) {
+        ALL_AGENTS.forEach(agent => {
+            const agentName = agent.name.replace("@", "");
+            // Support both .md and .mdc (Cursor)
+            const mdPath = path.join(activeAgentDir, `${agentName}.md`);
+            const mdcPath = path.join(activeAgentDir, `${agentName}.mdc`);
+            
+            if (fs.existsSync(mdPath) || fs.existsSync(mdcPath)) {
+                UI.success(`Instructions for @${agentName} found in ${path.relative(process.cwd(), activeAgentDir)}`);
+            } else {
+                UI.error(`Instructions for @${agentName} MISSING! Expected in ${path.relative(process.cwd(), activeAgentDir)}`);
+                issues++;
+            }
+        });
     } else {
-        UI.success("No forbidden 'console.log' detected.");
+        UI.warning("No active agent instruction directory detected (.gemini/agents, .claude/agents, etc.). Run 'init' first.");
+        issues++;
     }
 
-    const anyUsageIssues = checkAnyUsage();
-    if (anyUsageIssues.length > 0) {
-        UI.error(`Forbidden 'any' type usage found in ${anyUsageIssues.length} locations.`);
-        issues++;
+    // Code Quality - Using the new Compliance Scanner
+    console.warn("\n⚖️  Checking Discipline (Code Quality)...");
+    const complianceIssues = scanProjectCompliance();
+    if (complianceIssues.length > 0) {
+        complianceIssues.forEach(issue => {
+            UI.error(`${issue.rule} in ${issue.file}:${issue.line}`);
+        });
+        issues += complianceIssues.length;
     } else {
-        UI.success("No forbidden 'any' type usage detected.");
+        UI.success("No compliance issues detected.");
     }
 
     const rootTestFiles = checkRootTestFiles();
@@ -176,60 +204,13 @@ export function checkCommand() {
     }
 
     if (issues === 0) {
-        UI.success("\n🚀 All systems green! Enderun Core is ready.");
+        UI.success("\n🚀 All systems green! Agent Enderun is ready.");
     } else {
         UI.error(`\n⚠️  Found ${issues} issues. Please fix them.`);
         process.exit(1);
     }
 }
 
-function checkConsoleLogs(): string[] {
-    const issues: string[] = [];
-    const srcDir = path.join(process.cwd(), "src");
-    if (!fs.existsSync(srcDir)) return [];
-    const walk = (dir: string) => {
-        const files = fs.readdirSync(dir);
-        for (const file of files) {
-            const fullPath = path.join(dir, file);
-            if (fs.statSync(fullPath).isDirectory()) walk(fullPath);
-            else if (file.endsWith(".ts") && !file.includes(".test.")) {
-                const content = fs.readFileSync(fullPath, "utf8");
-                const target = "console." + "log(";
-                if (content.includes(target) && !fullPath.includes("check.ts") && !fullPath.includes("logger.ts")) {
-                    issues.push(fullPath);
-                }
-
-            }
-        }
-    };
-    walk(srcDir);
-    return issues;
-}
-
-function checkAnyUsage(): string[] {
-    const issues: string[] = [];
-    const srcDir = path.join(process.cwd(), "src");
-    if (!fs.existsSync(srcDir)) return [];
-    
-    const walk = (dir: string) => {
-        const files = fs.readdirSync(dir);
-        for (const file of files) {
-            const fullPath = path.join(dir, file);
-            if (fs.statSync(fullPath).isDirectory()) walk(fullPath);
-            else if (file.endsWith(".ts") && !file.includes(".test.")) {
-                const content = fs.readFileSync(fullPath, "utf8");
-                // Match ": any", "<any>", "as any" but try to avoid false positives in comments if possible
-                const anyRegex = /[:<]\s*any\b|\bas\s+any\b/g;
-                if (anyRegex.test(content) && !fullPath.includes("check.ts") && !fullPath.includes("definitions.ts")) {
-                    issues.push(fullPath);
-                }
-            }
-        }
-    };
-    walk(srcDir);
-    return issues;
-}
-
 function checkRootTestFiles(): string[] {
     const rootDir = process.cwd();
     if (!fs.existsSync(rootDir)) return [];

package/src/cli/commands/compliance.ts

@@ -5,7 +5,7 @@ import { collectFiles } from "../utils/fs.js";
 
 const targetDir = process.cwd(); // Assuming targetDir is process.cwd() in the CLI context
 
-export function complianceCheckCommand(targetPath: string) {
+export async function complianceCheckCommand(targetPath: string) {
     console.warn(`📜 Checking Constitution Compliance: ${targetPath}...`);
     const violations: string[] = [];
     const forbidden = ["@shadcn", "mui", "@chakra-ui", "tailwindcss"];