@mandujs/cli 0.8.2 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/cli",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "Agent-Native Fullstack Framework - 에이전트가 코딩해도 아키텍처가 무너지지 않는 개발 OS",
   "type": "module",
   "main": "./src/main.ts",
@@ -32,7 +32,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@mandujs/core": "0.8.2"
+    "@mandujs/core": "0.9.0"
   },
   "engines": {
     "bun": ">=1.0.0"

package/src/commands/brain.ts

@@ -0,0 +1,157 @@
+/**
+ * Mandu CLI - Brain Commands
+ *
+ * Commands for managing Brain (sLLM) configuration.
+ * - brain setup: Configure sLLM settings
+ * - brain status: Check current Brain status
+ */
+
+import {
+  initializeBrain,
+  getBrain,
+  detectEnvironment,
+  createOllamaAdapter,
+  DEFAULT_OLLAMA_CONFIG,
+} from "../../../core/src/index";
+
+export interface BrainSetupOptions {
+  /** Model name (default: llama3.2) */
+  model?: string;
+  /** Ollama server URL */
+  url?: string;
+  /** Skip model check */
+  skipCheck?: boolean;
+}
+
+export interface BrainStatusOptions {
+  /** Show verbose status */
+  verbose?: boolean;
+}
+
+/**
+ * Setup Brain (sLLM configuration)
+ */
+export async function brainSetup(options: BrainSetupOptions = {}): Promise<boolean> {
+  const { model = DEFAULT_OLLAMA_CONFIG.model, url = DEFAULT_OLLAMA_CONFIG.baseUrl, skipCheck } = options;
+
+  console.log("🧠 Mandu Brain Setup");
+  console.log("─".repeat(40));
+  console.log();
+
+  // Create adapter with provided settings
+  const adapter = createOllamaAdapter({
+    model,
+    baseUrl: url,
+  });
+
+  console.log(`📦 Model: ${model}`);
+  console.log(`🔗 URL: ${url}`);
+  console.log();
+
+  if (!skipCheck) {
+    console.log("🔍 Checking Ollama connection...");
+
+    const status = await adapter.checkStatus();
+
+    if (status.available) {
+      console.log(`✅ Ollama is running`);
+      console.log(`✅ Model '${status.model}' is available`);
+
+      if (status.error) {
+        console.log(`⚠️  ${status.error}`);
+      }
+    } else {
+      console.log(`❌ ${status.error || "Ollama is not available"}`);
+      console.log();
+      console.log("💡 To fix this:");
+      console.log("   1. Install Ollama: https://ollama.com");
+      console.log("   2. Start Ollama: ollama serve");
+      console.log(`   3. Pull the model: ollama pull ${model}`);
+      console.log();
+      console.log("   Or run with --skip-check to skip this verification.");
+      return false;
+    }
+  }
+
+  console.log();
+  console.log("✅ Brain setup complete!");
+  console.log();
+  console.log("💡 Brain is now ready to assist with:");
+  console.log("   • mandu doctor - Guard failure analysis + patch suggestions");
+  console.log("   • mandu watch - Real-time file monitoring with warnings");
+  console.log();
+  console.log("ℹ️  Brain works without LLM too - LLM only improves suggestion quality.");
+
+  return true;
+}
+
+/**
+ * Check Brain status
+ */
+export async function brainStatus(options: BrainStatusOptions = {}): Promise<boolean> {
+  const { verbose } = options;
+
+  console.log("🧠 Mandu Brain Status");
+  console.log("─".repeat(40));
+  console.log();
+
+  // Initialize Brain
+  await initializeBrain();
+  const brain = getBrain();
+  const status = await brain.getStatus();
+
+  // Environment info
+  console.log("📊 Environment");
+  console.log(`   CI: ${status.environment.isCI ? `Yes (${status.environment.ciProvider})` : "No"}`);
+  console.log(`   Development: ${status.environment.isDevelopment ? "Yes" : "No"}`);
+  console.log();
+
+  // Brain status
+  const brainIcon = status.enabled ? "🟢" : "🔴";
+  console.log(`${brainIcon} Brain: ${status.enabled ? "Enabled" : "Disabled"}`);
+
+  // Adapter status
+  const adapterIcon = status.adapter.available ? "🟢" : "🔴";
+  console.log(
+    `${adapterIcon} LLM: ${status.adapter.available ? `Available (${status.adapter.model})` : "Not available"}`
+  );
+
+  if (status.adapter.error) {
+    console.log(`   ⚠️  ${status.adapter.error}`);
+  }
+
+  // Memory status
+  if (verbose) {
+    console.log();
+    console.log("📦 Memory");
+    console.log(`   Has data: ${status.memory.hasData ? "Yes" : "No"}`);
+    console.log(`   Session duration: ${status.memory.sessionDuration}s`);
+    console.log(`   Idle time: ${status.memory.idleTime}s`);
+  }
+
+  console.log();
+
+  // Recommendations
+  if (!status.enabled) {
+    console.log("💡 Brain is disabled because:");
+
+    if (status.environment.isCI) {
+      console.log("   • Running in CI environment (by design)");
+    } else if (!status.adapter.available) {
+      console.log("   • No LLM adapter available");
+      console.log();
+      console.log("   To enable Brain:");
+      console.log("   1. Install Ollama: https://ollama.com");
+      console.log("   2. Start Ollama: ollama serve");
+      console.log("   3. Run: bunx mandu brain setup");
+    }
+  } else {
+    console.log("✅ Brain is ready!");
+    console.log();
+    console.log("💡 Available commands:");
+    console.log("   • bunx mandu doctor - Analyze Guard failures");
+    console.log("   • bunx mandu watch - Real-time file monitoring");
+  }
+
+  return true;
+}

package/src/commands/doctor.ts

@@ -0,0 +1,124 @@
+/**
+ * Mandu CLI - Doctor Command
+ *
+ * Analyzes Guard failures and suggests patches.
+ * Works with or without LLM - template-based analysis is always available.
+ */
+
+import {
+  loadManifest,
+  runGuardCheck,
+  analyzeViolations,
+  printDoctorReport,
+  generateMarkdownReport,
+  initializeBrain,
+  getBrain,
+} from "../../../core/src/index";
+import { resolveFromCwd, getRootDir } from "../util/fs";
+import path from "path";
+import fs from "fs/promises";
+
+export interface DoctorOptions {
+  /** Output format: console, json, or markdown */
+  format?: "console" | "json" | "markdown";
+  /** Whether to use LLM for enhanced analysis */
+  useLLM?: boolean;
+  /** Output file path (for json/markdown formats) */
+  output?: string;
+}
+
+export async function doctor(options: DoctorOptions = {}): Promise<boolean> {
+  const { format = "console", useLLM = true, output } = options;
+
+  const specPath = resolveFromCwd("spec/routes.manifest.json");
+  const rootDir = getRootDir();
+
+  console.log(`🩺 Mandu Doctor`);
+  console.log(`📄 Spec 파일: ${specPath}`);
+
+  // Initialize Brain
+  const brainEnabled = await initializeBrain();
+  const brain = getBrain();
+  const llmAvailable = await brain.isLLMAvailable();
+
+  if (brainEnabled) {
+    console.log(`🧠 Brain: ${llmAvailable ? "LLM 활성화" : "템플릿 모드"}`);
+  } else {
+    console.log(`🧠 Brain: 비활성화`);
+  }
+  console.log();
+
+  // Load manifest
+  const result = await loadManifest(specPath);
+
+  if (!result.success || !result.data) {
+    console.error("❌ Spec 로드 실패:");
+    result.errors?.forEach((e) => console.error(`  - ${e}`));
+    return false;
+  }
+
+  console.log(`✅ Spec 로드 완료`);
+  console.log(`🔍 Guard 검사 중...\n`);
+
+  // Run guard check
+  const checkResult = await runGuardCheck(result.data, rootDir);
+
+  if (checkResult.passed) {
+    console.log(`✅ Guard 통과 - 위반 사항이 없습니다.`);
+    console.log();
+    console.log(`💡 다음 단계: bunx mandu dev`);
+    return true;
+  }
+
+  console.log(
+    `⚠️  ${checkResult.violations.length}개 위반 발견 - 분석 중...\n`
+  );
+
+  // Analyze violations
+  const analysis = await analyzeViolations(checkResult.violations, {
+    useLLM: useLLM && brainEnabled && llmAvailable,
+  });
+
+  // Output based on format
+  switch (format) {
+    case "console":
+      printDoctorReport(analysis);
+      break;
+
+    case "json": {
+      const json = JSON.stringify(
+        {
+          summary: analysis.summary,
+          violations: analysis.violations,
+          patches: analysis.patches,
+          nextCommand: analysis.nextCommand,
+          llmAssisted: analysis.llmAssisted,
+        },
+        null,
+        2
+      );
+
+      if (output) {
+        await fs.writeFile(output, json, "utf-8");
+        console.log(`📄 Report saved to: ${output}`);
+      } else {
+        console.log(json);
+      }
+      break;
+    }
+
+    case "markdown": {
+      const md = generateMarkdownReport(analysis);
+
+      if (output) {
+        await fs.writeFile(output, md, "utf-8");
+        console.log(`📄 Report saved to: ${output}`);
+      } else {
+        console.log(md);
+      }
+      break;
+    }
+  }
+
+  return false;
+}

package/src/commands/watch.ts

@@ -0,0 +1,80 @@
+/**
+ * Mandu CLI - Watch Command
+ *
+ * Real-time file watching with architecture rule warnings.
+ * Warnings only - never blocks operations.
+ */
+
+import {
+  startWatcher,
+  stopWatcher,
+  getWatcher,
+  printWatchStart,
+  printWatchStop,
+  printStatus,
+  createConsoleHandler,
+} from "../../../core/src/index";
+import { getRootDir } from "../util/fs";
+
+export interface WatchOptions {
+  /** Extra commands to run on violations */
+  extraCommands?: string[];
+  /** Debounce delay in ms */
+  debounce?: number;
+  /** Show status only (don't start watching) */
+  status?: boolean;
+}
+
+export async function watch(options: WatchOptions = {}): Promise<boolean> {
+  const { extraCommands, debounce, status } = options;
+
+  const rootDir = getRootDir();
+
+  // Status only mode
+  if (status) {
+    const watcher = getWatcher();
+    if (watcher) {
+      printStatus(watcher.getStatus());
+    } else {
+      console.log("👁️ Watch is not running");
+    }
+    return true;
+  }
+
+  // Start watching
+  printWatchStart(rootDir);
+
+  try {
+    const watcher = await startWatcher({
+      rootDir,
+      extraCommands,
+      debounceMs: debounce,
+    });
+
+    // Add console handler
+    watcher.onWarning(createConsoleHandler());
+
+    // Handle shutdown signals
+    const shutdown = () => {
+      printWatchStop();
+      stopWatcher();
+      process.exit(0);
+    };
+
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+
+    // Keep the process running
+    await new Promise(() => {
+      // Never resolves - runs until interrupted
+    });
+
+    return true;
+  } catch (error) {
+    console.error(
+      "❌ Watch failed:",
+      error instanceof Error ? error.message : error
+    );
+    return false;
+  }
+}

package/src/main.ts

@@ -16,6 +16,9 @@ import {
   changeList,
   changePrune,
 } from "./commands/change";
+import { doctor } from "./commands/doctor";
+import { watch } from "./commands/watch";
+import { brainSetup, brainStatus } from "./commands/brain";
 
 const HELP_TEXT = `
 🥟 Mandu CLI - Agent-Native Fullstack Framework
@@ -30,6 +33,12 @@ Commands:
   build          클라이언트 번들 빌드 (Hydration)
   dev            개발 서버 실행
 
+  doctor         Guard 실패 분석 + 패치 제안 (Brain)
+  watch          실시간 파일 감시 - 경고만 (Brain)
+
+  brain setup    sLLM 설정 (선택)
+  brain status   Brain 상태 확인
+
   contract create <routeId>  라우트에 대한 Contract 생성
   contract validate          Contract-Slot 일관성 검증
 
@@ -54,8 +63,12 @@ Options:
   --message <msg>    change begin 시 설명 메시지
   --id <id>          change rollback 시 특정 변경 ID
   --keep <n>         change prune 시 유지할 스냅샷 수 (기본: 5)
-  --output <path>    openapi generate 시 출력 경로 (기본: openapi.json)
-  --verbose          contract validate 시 상세 출력
+  --output <path>    openapi/doctor 출력 경로
+  --format <fmt>     doctor 출력 형식: console, json, markdown (기본: console)
+  --no-llm           doctor에서 LLM 사용 안 함 (템플릿 모드)
+  --model <name>     brain setup 시 모델 이름 (기본: llama3.2)
+  --url <url>        brain setup 시 Ollama URL
+  --verbose          상세 출력
   --help, -h         도움말 표시
 
 Examples:
@@ -66,6 +79,11 @@ Examples:
   bunx mandu build --minify
   bunx mandu build --watch
   bunx mandu dev --port 3000
+  bunx mandu doctor
+  bunx mandu doctor --format markdown --output report.md
+  bunx mandu watch
+  bunx mandu brain setup --model codellama
+  bunx mandu brain status
   bunx mandu contract create users
   bunx mandu contract validate --verbose
   bunx mandu openapi generate --output docs/api.json
@@ -79,6 +97,9 @@ Workflow:
 
 Contract-first Workflow:
   1. contract create → 2. Edit contract → 3. generate → 4. Edit slot → 5. contract validate
+
+Brain (sLLM) Workflow:
+  1. brain setup → 2. doctor (분석) → 3. watch (감시)
 `;
 
 function parseArgs(args: string[]): { command: string; options: Record<string, string> } {
@@ -224,6 +245,44 @@ async function main(): Promise<void> {
       break;
     }
 
+    case "doctor":
+      success = await doctor({
+        format: (options.format as "console" | "json" | "markdown") || "console",
+        useLLM: options["no-llm"] !== "true",
+        output: options.output,
+      });
+      break;
+
+    case "watch":
+      success = await watch({
+        status: options.status === "true",
+        debounce: options.debounce ? Number(options.debounce) : undefined,
+      });
+      break;
+
+    case "brain": {
+      const subCommand = args[1];
+      switch (subCommand) {
+        case "setup":
+          success = await brainSetup({
+            model: options.model,
+            url: options.url,
+            skipCheck: options["skip-check"] === "true",
+          });
+          break;
+        case "status":
+          success = await brainStatus({
+            verbose: options.verbose === "true",
+          });
+          break;
+        default:
+          console.error(`❌ Unknown brain subcommand: ${subCommand}`);
+          console.log("\nUsage: bunx mandu brain <setup|status>");
+          process.exit(1);
+      }
+      break;
+    }
+
     default:
       console.error(`❌ Unknown command: ${command}`);
       console.log(HELP_TEXT);