amalfa 1.0.39 → 1.0.40

package/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to AMALFA will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.40] - 2026-01-09
+
+### Added
+- **Ember Phase 2**: Integrated `EmberService` into the `AmalfaDaemon`.
+- **Optimization**: Changes to file content now trigger immediate sidecar generation (if applicable).
+- **Configuration**: Added `tests` to default `excludePatterns`.
+- **CLI**: Added `amalfa stop-all` (alias `kill`) to stop all running services.
+
 ## [1.0.39] - 2026-01-09
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "amalfa",
-	"version": "1.0.39",
+	"version": "1.0.40",
 	"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",

package/src/cli.ts

@@ -53,6 +53,7 @@ Commands:
   ember <action>     Manage Ember enrichment service (scan|squash)
   scripts list       List available scripts and their descriptions
   servers [--dot]    Show status of all AMALFA services (--dot for graph)
+  stop-all (kill)    Stop all running AMALFA services
 
 Options:
   --force            Override pre-flight warnings (errors still block)
@@ -738,6 +739,63 @@ async function cmdServers() {
 	);
 }
 
+async function cmdStopAll() {
+	console.log("🛑 Stopping ALL Amalfa Services...\n");
+
+	// We reuse the service definitions from cmdServers logic,
+	// but abstracted slightly or duplicated for simplicity since they are inside cmdServers
+	const { AMALFA_DIRS } = await import("./config/defaults");
+	const { join } = await import("node:path");
+	const { existsSync, readFileSync, unlinkSync } = await import("node:fs");
+
+	const SERVICES = [
+		{
+			name: "Vector Daemon",
+			pidFile: join(AMALFA_DIRS.runtime, "vector-daemon.pid"),
+		},
+		{ name: "File Watcher", pidFile: join(AMALFA_DIRS.runtime, "daemon.pid") },
+		{ name: "Sonar Agent", pidFile: join(AMALFA_DIRS.runtime, "sonar.pid") },
+		// MCP usually runs as stdio, but if we track a PID file for it:
+		{ name: "MCP Server", pidFile: join(AMALFA_DIRS.runtime, "mcp.pid") },
+	];
+
+	let stoppedCount = 0;
+
+	for (const svc of SERVICES) {
+		if (existsSync(svc.pidFile)) {
+			try {
+				const pidStr = readFileSync(svc.pidFile, "utf-8").trim();
+				const pid = Number.parseInt(pidStr, 10);
+
+				if (!Number.isNaN(pid)) {
+					// Check if running
+					try {
+						process.kill(pid, 0); // Check existence
+						process.kill(pid, "SIGTERM");
+						console.log(`✅ Sent SIGTERM to ${svc.name} (PID: ${pid})`);
+						stoppedCount++;
+					} catch {
+						// Not running, just stale
+						console.log(`🧹 Cleaning stale PID file for ${svc.name}`);
+					}
+				}
+			} catch (e) {
+				console.warn(`⚠️ Failed to stop ${svc.name}:`, e);
+			}
+			// Always clean up PID file
+			try {
+				unlinkSync(svc.pidFile);
+			} catch {}
+		}
+	}
+
+	if (stoppedCount === 0) {
+		console.log("✨ No active services found.");
+	} else {
+		console.log(`\n✅ Stopped ${stoppedCount} service(s).`);
+	}
+}
+
 async function cmdValidate() {
 	console.log("🛡️  AMALFA Database Validation\n");
 
@@ -1002,6 +1060,11 @@ async function main() {
 			await cmdServers();
 			break;
 
+		case "stop-all":
+		case "kill":
+			await cmdStopAll();
+			break;
+
 		case "sonar":
 			await cmdSonar();
 			break;

package/src/config/defaults.ts

@@ -44,6 +44,8 @@ export function initAmalfaDirs(): void {
 	}
 }
 
+import type { EmberConfig } from "@src/ember/types";
+
 export interface AmalfaConfig {
 	/** @deprecated Use sources array instead */
 	source?: string;
@@ -77,6 +79,8 @@ export interface AmalfaConfig {
 	sonar: SonarConfig;
 	/** @deprecated Use sonar instead */
 	phi3?: SonarConfig;
+	/** Ember automated enrichment configuration */
+	ember: EmberConfig;
 }
 
 export interface SonarConfig {
@@ -142,12 +146,18 @@ export const DEFAULT_CONFIG: AmalfaConfig = {
 		model: "BAAI/bge-small-en-v1.5",
 		dimensions: 384,
 	},
+	ember: {
+		enabled: true,
+		minConfidence: 0.8,
+		autoSquash: false,
+		backupDir: ".amalfa/backups/ember",
+	},
 	watch: {
 		enabled: true,
 		debounce: 1000,
 		notifications: true,
 	},
-	excludePatterns: ["node_modules", ".git", ".amalfa"],
+	excludePatterns: ["node_modules", ".git", ".amalfa", "tests"],
 	// Optional graph tuning (for advanced use)
 	graph: {
 		tuning: {
@@ -276,6 +286,10 @@ export async function loadConfig(): Promise<AmalfaConfig> {
 							},
 						},
 					} as SonarConfig,
+					ember: {
+						...DEFAULT_CONFIG.ember,
+						...(userConfig.ember || {}),
+					},
 				};
 
 				// Normalize: Convert legacy 'source' to 'sources' array

package/src/daemon/index.ts

@@ -12,6 +12,7 @@ import {
 	type AmalfaConfig,
 	loadConfig,
 } from "@src/config/defaults";
+import { EmberService } from "@src/ember";
 import { AmalfaIngestor } from "@src/pipeline/AmalfaIngestor";
 import { ResonanceDB } from "@src/resonance/db";
 import { getLogger } from "@src/utils/Logger";
@@ -157,6 +158,32 @@ function triggerIngestion(debounceMs: number) {
 			// For now, we'll re-run full ingestion (hash checking prevents duplicates)
 			await ingestor.ingest();
 
+			// --- EMBER INTEGRATION ---
+			if (config.ember?.enabled) {
+				log.info("🔥 Running Ember Analysis...");
+				const ember = new EmberService(db, config.ember);
+				let enrichedCount = 0;
+
+				// Analyze changed files only
+				// Note: Reading again from disk is safer than passing content from ingestor for now
+				for (const file of batch) {
+					try {
+						const content = await Bun.file(file).text();
+						const sidecar = await ember.analyze(file, content);
+						if (sidecar) {
+							await ember.generate(sidecar);
+							enrichedCount++;
+						}
+					} catch (err) {
+						log.warn({ file, err }, "Failed to analyze with Ember");
+					}
+				}
+				if (enrichedCount > 0) {
+					log.info({ enrichedCount }, "🔥 Ember enriched files");
+				}
+			}
+			// -------------------------
+
 			db.close();
 
 			log.info({ files: batchSize }, "✅ Update complete");

package/src/ember/index.ts

@@ -5,7 +5,7 @@ import { Glob } from "bun";
 import { EmberAnalyzer } from "./analyzer";
 import { EmberGenerator } from "./generator";
 import { EmberSquasher } from "./squasher";
-import type { EmberConfig } from "./types";
+import type { EmberConfig, EmberSidecar } from "./types";
 
 export class EmberService {
 	private analyzer: EmberAnalyzer;
@@ -50,6 +50,20 @@ export class EmberService {
 		return enrichedCount;
 	}
 
+	/**
+	 * Analyze a single file
+	 */
+	async analyze(filePath: string, content: string) {
+		return this.analyzer.analyze(filePath, content);
+	}
+
+	/**
+	 * Generate a sidecar file
+	 */
+	async generate(sidecar: EmberSidecar) {
+		return this.generator.generate(sidecar);
+	}
+
 	/**
 	 * Squash all pending sidecars
 	 */
@@ -71,8 +85,9 @@ export class EmberService {
 	private async findSidecars(): Promise<string[]> {
 		const sidecars: string[] = [];
 		const glob = new Glob("**/*.ember.json");
+		const sources = this.config.sources || ["./docs"];
 		// Scan sources
-		for (const source of this.config.sources) {
+		for (const source of sources) {
 			// Assuming source is like "./docs"
 			const sourcePath = join(process.cwd(), source);
 			for (const file of glob.scanSync({ cwd: sourcePath })) {
@@ -85,14 +100,14 @@ export class EmberService {
 	private async discoverFiles(): Promise<string[]> {
 		const files: string[] = [];
 		const glob = new Glob("**/*.{md,mdx}"); // Only markdown for now
+		const sources = this.config.sources || ["./docs"];
+		const excludes = this.config.excludePatterns || [];
 
-		for (const source of this.config.sources) {
+		for (const source of sources) {
 			const sourcePath = join(process.cwd(), source);
 			try {
 				for (const file of glob.scanSync({ cwd: sourcePath })) {
-					const shouldExclude = this.config.excludePatterns.some((p) =>
-						file.includes(p),
-					);
+					const shouldExclude = excludes.some((p) => file.includes(p));
 					if (!shouldExclude) {
 						files.push(join(sourcePath, file));
 					}

package/src/ember/types.ts

@@ -17,10 +17,11 @@ export interface EmberSidecar {
 
 export interface EmberConfig {
 	enabled: boolean;
-	sources: string[];
+	sources?: string[];
 	minConfidence: number;
 	backupDir: string;
-	excludePatterns: string[];
+	excludePatterns?: string[];
+	autoSquash?: boolean;
 }
 
 export type EnrichmentType = "tag" | "link" | "summary" | "metadata";