amalfa 1.0.10 → 1.0.11

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.11",
 	"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.11";
 
 // Database path loaded from config (lazy loaded per command)
 let DB_PATH: string | null = null;
@@ -320,9 +320,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: "(auto-start)" },
+		{ name: "File Watcher", pidFile: ".amalfa-daemon.pid", port: "-", id: "watcher", cmd: "amalfa daemon start" },
 	];
 
 	async function isRunning(pid: number): Promise<boolean> {
@@ -393,14 +393,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 +427,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 daemon start | amalfa stats\n");
 }
 
 async function cmdDoctor() {