amalfa 1.0.22 → 1.0.23

package/src/cli.ts

@@ -29,6 +29,8 @@ Commands:
   setup-mcp          Generate MCP configuration JSON
   daemon <action>    Manage file watcher (start|stop|status|restart)
   vector <action>    Manage vector daemon (start|stop|status|restart)
+  sonar <action>     Manage Sonar AI agent (start|stop|status|restart)
+  scripts list       List available scripts and their descriptions
   servers [--dot]    Show status of all AMALFA services (--dot for graph)
 
 Options:
@@ -42,6 +44,7 @@ Examples:
   amalfa serve       # Start MCP server for Claude Desktop
   amalfa stats       # Show knowledge graph statistics
   amalfa doctor      # Verify installation
+  amalfa sonar start # Start Sonar AI agent for enhanced search
 
 Documentation: https://github.com/pjsvis/amalfa
 `);
@@ -53,7 +56,7 @@ function showVersion() {
 
 async function getDbPath(): Promise<string> {
 	if (DB_PATH) return DB_PATH;
-	
+
 	// Load from config
 	const { loadConfig } = await import("./config/defaults");
 	const config = await loadConfig();
@@ -108,28 +111,68 @@ async function cmdStats() {
 	// Import database wrapper
 	const dbPath = await getDbPath();
 	const { ResonanceDB } = await import("./resonance/db");
+	const { loadConfig } = await import("./config/defaults");
+
 	const db = new ResonanceDB(dbPath);
+	const config = await loadConfig();
+	const sources = config.sources || ["./docs"];
 
 	try {
 		const stats = db.getStats();
-		const fileSize = statSync(dbPath).size;
-		const fileSizeMB = (fileSize / 1024 / 1024).toFixed(2);
+		const dbStats = statSync(dbPath);
+		const fileSizeMB = (dbStats.size / 1024 / 1024).toFixed(2);
+
+		// Check for stale files
+		let newerFiles = 0;
+		let newestFileDate = new Date(0);
+
+		const { readdirSync, statSync: statSyncFs } = await import("node:fs");
+
+		function scan(dir: string) {
+			if (!existsSync(dir)) return;
+			const entries = readdirSync(dir, { withFileTypes: true });
+			for (const entry of entries) {
+				const fullPath = join(dir, entry.name);
+				if (entry.name.startsWith(".")) continue;
+
+				if (entry.isDirectory()) {
+					scan(fullPath);
+				} else if (entry.name.endsWith(".md")) {
+					const mtime = statSyncFs(fullPath).mtime;
+					if (mtime > dbStats.mtime) {
+						newerFiles++;
+					}
+					if (mtime > newestFileDate) {
+						newestFileDate = mtime;
+					}
+				}
+			}
+		}
 
-	console.log(`
+		for (const source of sources) {
+			scan(join(process.cwd(), source));
+		}
+
+		const isStale = newerFiles > 0;
+		const statusIcon = isStale ? "⚠️  STALE" : "✅ FRESH";
+
+		console.log(`
 📊 AMALFA Database Statistics
 
 Database: ${dbPath}
-Size: ${fileSizeMB} MB
+Status:   ${statusIcon}
+Size:     ${fileSizeMB} MB
 
-Nodes: ${stats.nodes.toLocaleString()}
-Edges: ${stats.edges.toLocaleString()}
+Nodes:      ${stats.nodes.toLocaleString()}
+Edges:      ${stats.edges.toLocaleString()}
 Embeddings: ${stats.vectors.toLocaleString()} (384-dim)
 
-Source: ./docs (markdown files)
-Last modified: ${new Date(statSync(dbPath).mtime).toISOString()}
+Sources:       ${sources.join(", ")}
+DB Modified:   ${new Date(dbStats.mtime).toISOString()}
+Latest File:   ${newestFileDate.toISOString()}
+Stale Files:   ${newerFiles}
 
-🔍 To search: Use with Claude Desktop or other MCP client
-📝 To update: Run 'amalfa daemon start' to watch for file changes
+${isStale ? "⚠️  ACTION REQUIRED: Run 'amalfa init' or start 'amalfa daemon' to update!" : "🔍 System is up to date."}
 `);
 	} catch (error) {
 		console.error("❌ Failed to read database statistics:", error);
@@ -165,7 +208,9 @@ async function cmdInit() {
 	console.log(`  Total files: ${report.totalFiles}`);
 	console.log(`  Valid files: ${report.validFiles}`);
 	console.log(`  Skipped files: ${report.skippedFiles}`);
-	console.log(`  Total size: ${(report.totalSizeBytes / 1024 / 1024).toFixed(2)} MB`);
+	console.log(
+		`  Total size: ${(report.totalSizeBytes / 1024 / 1024).toFixed(2)} MB`,
+	);
 	console.log(`  Estimated nodes: ${report.estimatedNodes}\n`);
 
 	if (report.hasErrors) {
@@ -174,7 +219,9 @@ async function cmdInit() {
 		for (const issue of report.issues.filter((i) => i.severity === "error")) {
 			console.error(`  - ${issue.path}: ${issue.details}`);
 		}
-			console.error("\nSee .amalfa/logs/pre-flight.log for details and recommendations");
+		console.error(
+			"\nSee .amalfa/logs/pre-flight.log for details and recommendations",
+		);
 		console.error("\nFix these issues and try again.");
 		process.exit(1);
 	}
@@ -185,14 +232,14 @@ async function cmdInit() {
 		for (const issue of report.issues.filter((i) => i.severity === "warning")) {
 			console.warn(`  - ${issue.path}: ${issue.details}`);
 		}
-			console.warn("\nSee .amalfa/logs/pre-flight.log for recommendations");
+		console.warn("\nSee .amalfa/logs/pre-flight.log for recommendations");
 		console.warn("\nTo proceed anyway, use: amalfa init --force");
 		process.exit(1);
 	}
 
 	if (report.validFiles === 0) {
 		console.error("\n❌ No valid markdown files found");
-			console.error("See .amalfa/logs/pre-flight.log for details");
+		console.error("See .amalfa/logs/pre-flight.log for details");
 		process.exit(1);
 	}
 
@@ -231,7 +278,7 @@ async function cmdInit() {
 			const tracker = new StatsTracker();
 			const fileSize = statSync(dbPath).size;
 			const dbSizeMB = fileSize / 1024 / 1024;
-			
+
 			await tracker.recordSnapshot({
 				timestamp: new Date().toISOString(),
 				nodes: result.stats.nodes,
@@ -272,16 +319,168 @@ async function cmdDaemon() {
 		process.exit(1);
 	}
 
-	// Run daemon with the specified action
-	const daemonPath = join(import.meta.dir, "daemon/index.ts");
-	const proc = spawn("bun", ["run", daemonPath, action], {
-		stdio: "inherit",
-		cwd: process.cwd(),
-	});
+	const { DaemonManager } = await import("./utils/DaemonManager");
+	const manager = new DaemonManager();
 
-	proc.on("exit", (code) => {
-		process.exit(code ?? 0);
-	});
+	if (action === "status") {
+		const status = await manager.checkFileWatcher();
+		if (status.running) {
+			console.log(`✅ File Watcher: Running (PID: ${status.pid})`);
+		} else {
+			console.log("❌ File Watcher: Stopped");
+		}
+		return;
+	}
+
+	if (action === "start") {
+		console.log("🚀 Starting File Watcher...");
+		try {
+			await manager.startFileWatcher();
+			console.log("✅ File Watcher started");
+		} catch (e) {
+			console.error("❌ Failed to start File Watcher:", e);
+			process.exit(1);
+		}
+		return;
+	}
+
+	if (action === "stop") {
+		console.log("🛑 Stopping File Watcher...");
+		try {
+			await manager.stopFileWatcher();
+			console.log("✅ File Watcher stopped");
+		} catch (e) {
+			console.error("❌ Failed to stop File Watcher:", e);
+			process.exit(1);
+		}
+		return;
+	}
+
+	if (action === "restart") {
+		console.log("🔄 Restarting File Watcher...");
+		try {
+			await manager.stopFileWatcher();
+			await manager.startFileWatcher();
+			console.log("✅ File Watcher restarted");
+		} catch (e) {
+			console.error("❌ Failed to restart File Watcher:", e);
+			process.exit(1);
+		}
+		return;
+	}
+}
+
+async function cmdSonar() {
+	const action = args[1] || "status";
+	const validActions = ["start", "stop", "status", "restart", "chat"];
+
+	if (!validActions.includes(action)) {
+		console.error(`❌ Invalid action: ${action}`);
+		console.error("\nUsage: amalfa sonar <start|stop|status|restart|chat>");
+		process.exit(1);
+	}
+
+	const { DaemonManager } = await import("./utils/DaemonManager");
+	const { discoverOllamaCapabilities } = await import(
+		"./utils/ollama-discovery"
+	);
+	const manager = new DaemonManager();
+
+	if (action === "status") {
+		console.log("🔍 Checking status...");
+
+		// Check Ollama
+		try {
+			const ollama = await discoverOllamaCapabilities();
+			if (ollama.available) {
+				console.log(
+					`✅ Ollama: Running (Model: ${ollama.model}, Size: ${ollama.size})`,
+				);
+			} else {
+				console.log("❌ Ollama: Not detected");
+			}
+		} catch {
+			console.log("❌ Ollama: Check failed");
+		}
+
+		// Check Daemon
+		const status = await manager.checkSonarAgent();
+
+		if (status.running) {
+			console.log(
+				`✅ Sonar Agent: Running (PID: ${status.pid}, Port: ${status.port})`,
+			);
+
+			// Check health endpoint
+			try {
+				const res = await fetch(`http://localhost:${status.port}/health`);
+				const health = await res.json();
+				console.log(`   Health: ${JSON.stringify(health)}`);
+			} catch {
+				console.log("   Health: ⚠️  Unresponsive");
+			}
+		} else {
+			console.log("❌ Sonar Agent: Stopped");
+		}
+		return;
+	}
+
+	if (action === "start") {
+		console.log("🚀 Starting Sonar Agent...");
+		try {
+			await manager.startSonarAgent();
+			console.log("✅ Sonar Agent started");
+		} catch (e) {
+			console.error("❌ Failed to start Sonar Agent:", e);
+			process.exit(1);
+		}
+		return;
+	}
+
+	if (action === "stop") {
+		console.log("🛑 Stopping Sonar Agent...");
+		try {
+			await manager.stopSonarAgent();
+			console.log("✅ Sonar Agent stopped");
+		} catch (e) {
+			console.error("❌ Failed to stop Sonar Agent:", e);
+			process.exit(1);
+		}
+		return;
+	}
+
+	if (action === "chat") {
+		const { chatLoop } = await import("./cli/sonar-chat");
+		await chatLoop();
+		return;
+	}
+
+	if (action === "restart") {
+		console.log("🔄 Restarting Sonar Agent...");
+		try {
+			await manager.stopSonarAgent();
+			await manager.startSonarAgent();
+			console.log("✅ Sonar Agent restarted");
+		} catch (e) {
+			console.error("❌ Failed to restart Sonar Agent:", e);
+			process.exit(1);
+		}
+		return;
+	}
+}
+
+async function cmdScripts() {
+	const action = args[1] || "list";
+
+	if (action === "list") {
+		// Dynamic import to avoid loading everything at startup
+		await import("./cli/list-scripts");
+		return;
+	}
+
+	console.error(`❌ Invalid action: ${action}`);
+	console.error("Usage: amalfa scripts list");
+	process.exit(1);
 }
 
 async function cmdVector() {
@@ -295,7 +494,10 @@ async function cmdVector() {
 	}
 
 	// Run vector daemon with the specified action
-	const vectorPath = join(import.meta.dir, "resonance/services/vector-daemon.ts");
+	const vectorPath = join(
+		import.meta.dir,
+		"resonance/services/vector-daemon.ts",
+	);
 	const proc = spawn("bun", ["run", vectorPath, action], {
 		stdio: "inherit",
 		cwd: process.cwd(),
@@ -308,22 +510,22 @@ async function cmdVector() {
 
 async function cmdSetupMcp() {
 	const { resolve } = await import("node:path");
-	
+
 	const cwd = resolve(process.cwd());
 	const mcpScript = resolve(cwd, "src/mcp/index.ts");
-	
+
 	// Minimal PATH for MCP - only include essential directories
-	const bunPath = process.execPath.replace(/\/bun$/, ''); // Directory containing bun
+	const bunPath = process.execPath.replace(/\/bun$/, ""); // Directory containing bun
 	const minimalPath = [
 		bunPath,
-		'/usr/local/bin',
-		'/usr/bin',
-		'/bin',
-		'/usr/sbin',
-		'/sbin',
-		'/opt/homebrew/bin',  // Apple Silicon Homebrew
-	].join(':');
-	
+		"/usr/local/bin",
+		"/usr/bin",
+		"/bin",
+		"/usr/sbin",
+		"/sbin",
+		"/opt/homebrew/bin", // Apple Silicon Homebrew
+	].join(":");
+
 	const config = {
 		mcpServers: {
 			amalfa: {
@@ -335,19 +537,21 @@ async function cmdSetupMcp() {
 			},
 		},
 	};
-	
+
 	console.log("\n✅ AMALFA MCP Configuration");
 	console.log("=".repeat(60));
 	console.log(`📂 Installation: ${cwd}`);
 	console.log("=".repeat(60));
 	console.log("\n📋 Copy this JSON to your MCP client config:");
-	console.log("   Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json");
+	console.log(
+		"   Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json",
+	);
 	console.log("   Warp Preview: MCP settings\n");
 	console.log("=".repeat(60));
 	console.log();
-	
+
 	console.log(JSON.stringify(config, null, 2));
-	
+
 	console.log();
 	console.log("=".repeat(60));
 	console.log("💡 Tip: If you move this folder, run 'amalfa setup-mcp' again");
@@ -358,11 +562,36 @@ async function cmdSetupMcp() {
 async function cmdServers() {
 	const showDot = args.includes("--dot");
 	const { AMALFA_DIRS } = await import("./config/defaults");
-	
+
 	const SERVICES = [
-		{ name: "MCP Server", pidFile: join(AMALFA_DIRS.runtime, "mcp.pid"), port: "stdio", id: "mcp", cmd: "amalfa serve" },
-		{ name: "Vector Daemon", pidFile: join(AMALFA_DIRS.runtime, "vector-daemon.pid"), port: "3010", id: "vector", cmd: "amalfa vector start" },
-		{ name: "File Watcher", pidFile: join(AMALFA_DIRS.runtime, "daemon.pid"), port: "-", id: "watcher", cmd: "amalfa daemon start" },
+		{
+			name: "MCP Server",
+			pidFile: join(AMALFA_DIRS.runtime, "mcp.pid"),
+			port: "stdio",
+			id: "mcp",
+			cmd: "amalfa serve",
+		},
+		{
+			name: "Vector Daemon",
+			pidFile: join(AMALFA_DIRS.runtime, "vector-daemon.pid"),
+			port: "3010",
+			id: "vector",
+			cmd: "amalfa vector start",
+		},
+		{
+			name: "File Watcher",
+			pidFile: join(AMALFA_DIRS.runtime, "daemon.pid"),
+			port: "-",
+			id: "watcher",
+			cmd: "amalfa daemon start",
+		},
+		{
+			name: "Sonar Agent",
+			pidFile: join(AMALFA_DIRS.runtime, "sonar.pid"),
+			port: "3012",
+			id: "sonar",
+			cmd: "amalfa sonar start",
+		},
 	];
 
 	async function isRunning(pid: number): Promise<boolean> {
@@ -373,22 +602,22 @@ async function cmdServers() {
 			return false;
 		}
 	}
-	
+
 	if (showDot) {
 		// Generate DOT diagram
 		const statuses = new Map<string, { status: string; pid: string }>();
-		
+
 		for (const svc of SERVICES) {
 			let status = "stopped";
 			let pidStr = "-";
-			
+
 			if (existsSync(svc.pidFile)) {
 				try {
 					const { readFileSync } = await import("node:fs");
 					const text = readFileSync(svc.pidFile, "utf-8");
 					const pid = Number.parseInt(text.trim(), 10);
-					
-					if (!Number.isNaN(pid) && await isRunning(pid)) {
+
+					if (!Number.isNaN(pid) && (await isRunning(pid))) {
 						status = "running";
 						pidStr = pid.toString();
 					} else {
@@ -399,32 +628,39 @@ async function cmdServers() {
 					// Ignore
 				}
 			}
-			
+
 			statuses.set(svc.id, { status, pid: pidStr });
 		}
-		
+
 		console.log("digraph AMALFA {");
 		console.log("  rankdir=LR;");
 		console.log("  node [shape=box, style=filled];");
 		console.log("");
 		console.log("  // Nodes");
-		
+
 		for (const svc of SERVICES) {
 			const st = statuses.get(svc.id);
-			const color = st?.status === "running" ? "lightgreen" : st?.status === "stale" ? "orange" : "lightgray";
+			const color =
+				st?.status === "running"
+					? "lightgreen"
+					: st?.status === "stale"
+						? "orange"
+						: "lightgray";
 			const label = `${svc.name}\\nPort: ${svc.port}\\nPID: ${st?.pid || "-"}`;
 			console.log(`  ${svc.id} [label="${label}", fillcolor=${color}];`);
 		}
-		
+
 		console.log("");
 		console.log("  // Database");
-		console.log("  db [label=\"SQLite\\n.amalfa/resonance.db\", shape=cylinder, fillcolor=lightyellow];");
+		console.log(
+			'  db [label="SQLite\\n.amalfa/resonance.db", shape=cylinder, fillcolor=lightyellow];',
+		);
 		console.log("");
 		console.log("  // Connections");
-		console.log("  mcp -> db [label=\"read/write\"];");
-		console.log("  vector -> db [label=\"embeddings\"];");
-		console.log("  watcher -> db [label=\"updates\"];");
-		console.log("  mcp -> vector [label=\"query\", style=dashed];");
+		console.log('  mcp -> db [label="read/write"];');
+		console.log('  vector -> db [label="embeddings"];');
+		console.log('  watcher -> db [label="updates"];');
+		console.log('  mcp -> vector [label="query", style=dashed];');
 		console.log("}");
 		console.log("");
 		console.log("# Save to file: amalfa servers --dot > amalfa.dot");
@@ -436,10 +672,10 @@ async function cmdServers() {
 	console.log("─".repeat(95));
 	console.log(
 		"SERVICE".padEnd(18) +
-		"COMMAND".padEnd(25) +
-		"PORT".padEnd(12) +
-		"STATUS".padEnd(15) +
-		"PID".padEnd(10)
+			"COMMAND".padEnd(25) +
+			"PORT".padEnd(12) +
+			"STATUS".padEnd(15) +
+			"PID".padEnd(10),
 	);
 	console.log("─".repeat(95));
 
@@ -453,7 +689,7 @@ async function cmdServers() {
 				const text = readFileSync(svc.pidFile, "utf-8");
 				const pid = Number.parseInt(text.trim(), 10);
 
-				if (!Number.isNaN(pid) && await isRunning(pid)) {
+				if (!Number.isNaN(pid) && (await isRunning(pid))) {
 					status = "🟢 RUNNING";
 					pidStr = pid.toString();
 				} else {
@@ -467,15 +703,17 @@ async function cmdServers() {
 
 		console.log(
 			svc.name.padEnd(18) +
-			svc.cmd.padEnd(25) +
-			svc.port.padEnd(12) +
-			status.padEnd(15) +
-			pidStr.padEnd(10)
+				svc.cmd.padEnd(25) +
+				svc.port.padEnd(12) +
+				status.padEnd(15) +
+				pidStr.padEnd(10),
 		);
 	}
 
 	console.log("─".repeat(95));
-	console.log("\n💡 Commands: amalfa serve | amalfa vector start | amalfa daemon start\n");
+	console.log(
+		"\n💡 Commands: amalfa serve | amalfa vector start | amalfa daemon start\n",
+	);
 }
 
 async function cmdValidate() {
@@ -635,7 +873,9 @@ async function cmdDoctor() {
 		console.log("  amalfa serve    # Start MCP server");
 		console.log("  amalfa stats    # View database statistics");
 	} else {
-		console.log(`❌ Found ${issues} issue(s). Please resolve them and try again.`);
+		console.log(
+			`❌ Found ${issues} issue(s). Please resolve them and try again.`,
+		);
 		process.exit(1);
 	}
 }
@@ -651,33 +891,47 @@ async function main() {
 			await cmdStats();
 			break;
 
-	case "doctor":
-		await cmdDoctor();
-		break;
+		case "doctor":
+			await cmdDoctor();
+			break;
 
-	case "validate":
-		await cmdValidate();
-		break;
+		case "validate":
+			await cmdValidate();
+			break;
 
-	case "init":
-		await cmdInit();
-		break;
+		case "init":
+			await cmdInit();
+			break;
 
-	case "daemon":
-		await cmdDaemon();
-		break;
+		case "daemon":
+			await cmdDaemon();
+			break;
 
-	case "vector":
-		await cmdVector();
-		break;
+		case "vector":
+			await cmdVector();
+			break;
 
-	case "setup-mcp":
-		await cmdSetupMcp();
-		break;
+		case "setup-mcp":
+			await cmdSetupMcp();
+			break;
 
-	case "servers":
-		await cmdServers();
-		break;
+		case "servers":
+			await cmdServers();
+			break;
+
+		case "sonar":
+			await cmdSonar();
+			break;
+
+		case "scripts":
+			await cmdScripts();
+			break;
+
+		case "enhance": {
+			const { cmdEnhance } = await import("./cli/enhance-commands");
+			await cmdEnhance(args);
+			break;
+		}
 
 		case "version":
 		case "--version":