amalfa 1.0.10 → 1.0.12

package/README.md

@@ -270,20 +270,30 @@ bun run dev
 ### Commands
 
 ```bash
-# CLI commands (available after global install)
+# CLI commands (after global install: bun install -g amalfa)
 amalfa init              # Initialize database from markdown
 amalfa serve             # Start MCP server (stdio)
 amalfa stats             # Show database statistics
 amalfa doctor            # Health check
-amalfa servers           # Show all service status
+amalfa servers           # Show all service status (with commands!)
+amalfa servers --dot     # Generate DOT diagram
 amalfa daemon start      # Start file watcher daemon
 amalfa daemon stop       # Stop file watcher daemon
 amalfa daemon status     # Check daemon status
 amalfa setup-mcp         # Generate MCP config
+amalfa --help            # Show help
 
-# Development commands
+# Local development scripts (bun run <script>)
+bun run servers          # Test servers command
+bun run servers:dot      # Test DOT diagram
+bun run stats            # Test stats
+bun run doctor           # Test doctor
+bun run help             # Show CLI help
+
+# Code quality
 bun test                 # Run tests
-bun run precommit        # TypeScript + Biome checks
+bun run check            # Biome check
+bun run format           # Biome format
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "amalfa",
-	"version": "1.0.10",
+	"version": "1.0.12",
 	"description": "Local-first knowledge graph engine for AI agents. Transforms markdown into searchable memory with MCP protocol.",
 	"license": "MIT",
 	"homepage": "https://github.com/pjsvis/amalfa#readme",
@@ -44,12 +44,13 @@
 		"precommit": "bun run scripts/maintenance/pre-commit.ts",
 		"check": "biome check .",
 		"format": "biome format --write .",
-		"cli": "bun run src/cli.ts",
-		"cli:servers": "bun run src/cli.ts servers",
-		"cli:servers:dot": "bun run src/cli.ts servers --dot",
-		"cli:stats": "bun run src/cli.ts stats",
-		"cli:doctor": "bun run src/cli.ts doctor",
-		"cli:daemon": "bun run src/cli.ts daemon status"
+		"amalfa": "bun run src/cli.ts",
+		"servers": "bun run src/cli.ts servers",
+		"servers:dot": "bun run src/cli.ts servers --dot",
+		"stats": "bun run src/cli.ts stats",
+		"doctor": "bun run src/cli.ts doctor",
+		"daemon": "bun run src/cli.ts daemon status",
+		"help": "bun run src/cli.ts --help"
 	},
 	"dependencies": {
 		"@modelcontextprotocol/sdk": "1.25.0",

package/src/cli.ts

@@ -3,7 +3,7 @@ import { existsSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { spawn } from "node:child_process";
 
-const VERSION = "1.0.10";
+const VERSION = "1.0.12";
 
 // Database path loaded from config (lazy loaded per command)
 let DB_PATH: string | null = null;
@@ -26,6 +26,7 @@ Commands:
   doctor             Check installation and configuration
   setup-mcp          Generate MCP configuration JSON
   daemon <action>    Manage file watcher (start|stop|status|restart)
+  vector <action>    Manage vector daemon (start|stop|status|restart)
   servers [--dot]    Show status of all AMALFA services (--dot for graph)
 
 Options:
@@ -267,6 +268,28 @@ async function cmdDaemon() {
 	});
 }
 
+async function cmdVector() {
+	const action = args[1] || "status";
+	const validActions = ["start", "stop", "status", "restart"];
+
+	if (!validActions.includes(action)) {
+		console.error(`❌ Invalid action: ${action}`);
+		console.error("\nUsage: amalfa vector <start|stop|status|restart>");
+		process.exit(1);
+	}
+
+	// Run vector daemon with the specified action
+	const vectorPath = join(import.meta.dir, "resonance/services/vector-daemon.ts");
+	const proc = spawn("bun", ["run", vectorPath, action], {
+		stdio: "inherit",
+		cwd: process.cwd(),
+	});
+
+	proc.on("exit", (code) => {
+		process.exit(code ?? 0);
+	});
+}
+
 async function cmdSetupMcp() {
 	const { resolve } = await import("node:path");
 	
@@ -320,9 +343,9 @@ async function cmdServers() {
 	const showDot = args.includes("--dot");
 	
 	const SERVICES = [
-		{ name: "MCP Server", pidFile: ".mcp.pid", port: "stdio", id: "mcp" },
-		{ name: "Vector Daemon", pidFile: ".vector-daemon.pid", port: "3010", id: "vector" },
-		{ name: "File Watcher", pidFile: ".amalfa-daemon.pid", port: "-", id: "watcher" },
+		{ name: "MCP Server", pidFile: ".mcp.pid", port: "stdio", id: "mcp", cmd: "amalfa serve" },
+		{ name: "Vector Daemon", pidFile: ".vector-daemon.pid", port: "3010", id: "vector", cmd: "amalfa vector start" },
+		{ name: "File Watcher", pidFile: ".amalfa-daemon.pid", port: "-", id: "watcher", cmd: "amalfa daemon start" },
 	];
 
 	async function isRunning(pid: number): Promise<boolean> {
@@ -393,14 +416,15 @@ async function cmdServers() {
 	}
 
 	console.log("\n📡 AMALFA Service Status\n");
-	console.log("─".repeat(70));
+	console.log("─".repeat(95));
 	console.log(
 		"SERVICE".padEnd(18) +
+		"COMMAND".padEnd(25) +
 		"PORT".padEnd(12) +
 		"STATUS".padEnd(15) +
 		"PID".padEnd(10)
 	);
-	console.log("─".repeat(70));
+	console.log("─".repeat(95));
 
 	for (const svc of SERVICES) {
 		const { readFileSync } = await import("node:fs");
@@ -426,14 +450,15 @@ async function cmdServers() {
 
 		console.log(
 			svc.name.padEnd(18) +
+			svc.cmd.padEnd(25) +
 			svc.port.padEnd(12) +
 			status.padEnd(15) +
 			pidStr.padEnd(10)
 		);
 	}
 
-	console.log("─".repeat(70));
-	console.log("\n💡 Tip: Use 'amalfa daemon start' to start the file watcher\n");
+	console.log("─".repeat(95));
+	console.log("\n💡 Commands: amalfa serve | amalfa vector start | amalfa daemon start\n");
 }
 
 async function cmdDoctor() {
@@ -537,6 +562,10 @@ async function main() {
 		await cmdDaemon();
 		break;
 
+	case "vector":
+		await cmdVector();
+		break;
+
 	case "setup-mcp":
 		await cmdSetupMcp();
 		break;