@aigne/afs-cli 1.11.0-beta.11 → 1.11.0-beta.12

package/dist/core/commands/connect.cjs

@@ -0,0 +1,53 @@
+const require_index = require('../../ui/index.cjs');
+
+//#region src/core/commands/connect.ts
+/** No-op formatter for lifecycle commands that manage their own output. */
+const noopFormat = () => "";
+function createConnectCommand(options) {
+	return {
+		command: "connect",
+		describe: "Start service and open web explorer",
+		builder: { port: {
+			type: "number",
+			default: 4900,
+			description: "Port for service"
+		} },
+		handler: async (argv) => {
+			const { getDaemonStatus, spawnDaemon } = await Promise.resolve().then(() => require("../../daemon/manager.cjs"));
+			let info = await getDaemonStatus();
+			if (info) console.log(`${require_index.colors.green("Service already running")} on port ${info.port}`);
+			else {
+				console.log(require_index.colors.dim("Starting AFS service..."));
+				try {
+					info = await spawnDaemon(argv.port);
+					console.log(require_index.colors.green("AFS Service started"));
+					console.log(`  ${require_index.colors.dim("PID:")}  ${info.pid}`);
+					console.log(`  ${require_index.colors.dim("Port:")} ${info.port}`);
+				} catch (err) {
+					console.error(require_index.colors.red(`Failed to start service: ${err.message}`));
+					options.onResult({
+						command: "connect",
+						result: null,
+						format: noopFormat
+					});
+					process.exitCode = 1;
+					return;
+				}
+			}
+			console.log(`  ${require_index.colors.dim("URL:")}  ${require_index.colors.brightCyan(info.url)}`);
+			openBrowser(info.url);
+			options.onResult({
+				command: "connect",
+				result: null,
+				format: noopFormat
+			});
+		}
+	};
+}
+function openBrowser(url) {
+	const { exec } = require("node:child_process");
+	exec(`${process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open"} ${url}`);
+}
+
+//#endregion
+exports.createConnectCommand = createConnectCommand;

package/dist/core/commands/connect.d.mts

@@ -0,0 +1,2 @@
+import "./types.mjs";
+import { CommandModule } from "yargs";

package/dist/core/commands/connect.mjs

@@ -0,0 +1,55 @@
+import { __require } from "../../_virtual/rolldown_runtime.mjs";
+import { colors } from "../../ui/index.mjs";
+
+//#region src/core/commands/connect.ts
+/** No-op formatter for lifecycle commands that manage their own output. */
+const noopFormat = () => "";
+function createConnectCommand(options) {
+	return {
+		command: "connect",
+		describe: "Start service and open web explorer",
+		builder: { port: {
+			type: "number",
+			default: 4900,
+			description: "Port for service"
+		} },
+		handler: async (argv) => {
+			const { getDaemonStatus, spawnDaemon } = await import("../../daemon/manager.mjs");
+			let info = await getDaemonStatus();
+			if (info) console.log(`${colors.green("Service already running")} on port ${info.port}`);
+			else {
+				console.log(colors.dim("Starting AFS service..."));
+				try {
+					info = await spawnDaemon(argv.port);
+					console.log(colors.green("AFS Service started"));
+					console.log(`  ${colors.dim("PID:")}  ${info.pid}`);
+					console.log(`  ${colors.dim("Port:")} ${info.port}`);
+				} catch (err) {
+					console.error(colors.red(`Failed to start service: ${err.message}`));
+					options.onResult({
+						command: "connect",
+						result: null,
+						format: noopFormat
+					});
+					process.exitCode = 1;
+					return;
+				}
+			}
+			console.log(`  ${colors.dim("URL:")}  ${colors.brightCyan(info.url)}`);
+			openBrowser(info.url);
+			options.onResult({
+				command: "connect",
+				result: null,
+				format: noopFormat
+			});
+		}
+	};
+}
+function openBrowser(url) {
+	const { exec } = __require("node:child_process");
+	exec(`${process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open"} ${url}`);
+}
+
+//#endregion
+export { createConnectCommand };
+//# sourceMappingURL=connect.mjs.map

package/dist/core/commands/connect.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.mjs","names":[],"sources":["../../../src/core/commands/connect.ts"],"sourcesContent":["/**\n * AFS Connect Command\n *\n * One-command experience: starts service (if not running) + opens browser + exits.\n * This is the primary user entry point.\n */\n\nimport type { CommandModule } from \"yargs\";\nimport { colors } from \"../../ui/index.js\";\nimport type { CommandFactoryOptions } from \"./types.js\";\n\nexport interface ConnectArgs {\n  port: number;\n}\n\n/** No-op formatter for lifecycle commands that manage their own output. */\nconst noopFormat = () => \"\";\n\nexport function createConnectCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, ConnectArgs> {\n  return {\n    command: \"connect\",\n    describe: \"Start service and open web explorer\",\n    builder: {\n      port: {\n        type: \"number\",\n        default: 4900,\n        description: \"Port for service\",\n      },\n    },\n    handler: async (argv) => {\n      const { getDaemonStatus, spawnDaemon } = await import(\"../../daemon/manager.js\");\n\n      let info = await getDaemonStatus();\n\n      if (info) {\n        console.log(`${colors.green(\"Service already running\")} on port ${info.port}`);\n      } else {\n        console.log(colors.dim(\"Starting AFS service...\"));\n        try {\n          info = await spawnDaemon(argv.port);\n          console.log(colors.green(\"AFS Service started\"));\n          console.log(`  ${colors.dim(\"PID:\")}  ${info.pid}`);\n          console.log(`  ${colors.dim(\"Port:\")} ${info.port}`);\n        } catch (err) {\n          console.error(colors.red(`Failed to start service: ${(err as Error).message}`));\n          options.onResult({ command: \"connect\", result: null, format: noopFormat });\n          process.exitCode = 1;\n          return;\n        }\n      }\n\n      console.log(`  ${colors.dim(\"URL:\")}  ${colors.brightCyan(info.url)}`);\n      openBrowser(info.url);\n\n      // Signal executor that command ran (output already printed above)\n      options.onResult({ command: \"connect\", result: null, format: noopFormat });\n    },\n  };\n}\n\nfunction openBrowser(url: string): void {\n  const { exec } = require(\"node:child_process\") as typeof import(\"node:child_process\");\n  const cmd =\n    process.platform === \"darwin\" ? \"open\" : process.platform === \"win32\" ? \"start\" : \"xdg-open\";\n  exec(`${cmd} ${url}`);\n}\n"],"mappings":";;;;;AAgBA,MAAM,mBAAmB;AAEzB,SAAgB,qBACd,SACqC;AACrC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS,EACP,MAAM;GACJ,MAAM;GACN,SAAS;GACT,aAAa;GACd,EACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,EAAE,iBAAiB,gBAAgB,MAAM,OAAO;GAEtD,IAAI,OAAO,MAAM,iBAAiB;AAElC,OAAI,KACF,SAAQ,IAAI,GAAG,OAAO,MAAM,0BAA0B,CAAC,WAAW,KAAK,OAAO;QACzE;AACL,YAAQ,IAAI,OAAO,IAAI,0BAA0B,CAAC;AAClD,QAAI;AACF,YAAO,MAAM,YAAY,KAAK,KAAK;AACnC,aAAQ,IAAI,OAAO,MAAM,sBAAsB,CAAC;AAChD,aAAQ,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;AACnD,aAAQ,IAAI,KAAK,OAAO,IAAI,QAAQ,CAAC,GAAG,KAAK,OAAO;aAC7C,KAAK;AACZ,aAAQ,MAAM,OAAO,IAAI,4BAA6B,IAAc,UAAU,CAAC;AAC/E,aAAQ,SAAS;MAAE,SAAS;MAAW,QAAQ;MAAM,QAAQ;MAAY,CAAC;AAC1E,aAAQ,WAAW;AACnB;;;AAIJ,WAAQ,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,IAAI,OAAO,WAAW,KAAK,IAAI,GAAG;AACtE,eAAY,KAAK,IAAI;AAGrB,WAAQ,SAAS;IAAE,SAAS;IAAW,QAAQ;IAAM,QAAQ;IAAY,CAAC;;EAE7E;;AAGH,SAAS,YAAY,KAAmB;CACtC,MAAM,EAAE,mBAAiB,qBAAqB;AAG9C,MAAK,GADH,QAAQ,aAAa,WAAW,SAAS,QAAQ,aAAa,UAAU,UAAU,WACxE,GAAG,MAAM"}

package/dist/core/commands/daemon.cjs

@@ -0,0 +1,207 @@
+const require_index = require('../../ui/index.cjs');
+
+//#region src/core/commands/daemon.ts
+/** No-op formatter for lifecycle commands that manage their own output. */
+const noopFormat = () => "";
+/** Print endpoint table for a running service. */
+function printEndpoints(url) {
+	console.log("");
+	console.log(`  ${require_index.colors.dim("Endpoints:")}`);
+	console.log(`    ${require_index.colors.brightCyan(`${url}/`)}${require_index.colors.dim("        Explorer UI")}`);
+	console.log(`    ${require_index.colors.brightCyan(`${url}/ws`)}${require_index.colors.dim("      WebSocket JSON-RPC")}`);
+	console.log(`    ${require_index.colors.brightCyan(`${url}/afs/*`)}${require_index.colors.dim("   REST API")}`);
+	console.log(`    ${require_index.colors.brightCyan(`${url}/mcp`)}${require_index.colors.dim("     MCP Streamable HTTP")}`);
+}
+function createServiceCommand(options) {
+	return {
+		command: "service <action>",
+		describe: "Manage AFS background service",
+		builder: (yargs) => yargs.positional("action", {
+			type: "string",
+			choices: [
+				"start",
+				"stop",
+				"status",
+				"restart"
+			],
+			description: "Service action"
+		}).option("port", {
+			type: "number",
+			default: 4900,
+			description: "Port for service"
+		}).option("cwd", {
+			type: "string",
+			hidden: true,
+			description: "Working directory (used by _run)"
+		}),
+		handler: async (argv) => {
+			const action = argv.action;
+			const { getDaemonStatus, stopDaemon, spawnDaemon, getLogFile } = await Promise.resolve().then(() => require("../../daemon/manager.cjs"));
+			switch (action) {
+				case "start": {
+					const existing = await getDaemonStatus();
+					if (existing) {
+						console.log(`${require_index.colors.yellow("Service already running")} (PID ${existing.pid}, port ${existing.port})`);
+						printEndpoints(existing.url);
+						return;
+					}
+					console.log(require_index.colors.dim("Starting AFS service..."));
+					try {
+						const info = await spawnDaemon(argv.port);
+						console.log(require_index.colors.green("AFS Service started"));
+						console.log(`  ${require_index.colors.dim("PID:")}  ${info.pid}`);
+						console.log(`  ${require_index.colors.dim("Port:")} ${info.port}`);
+						console.log(`  ${require_index.colors.dim("Log:")}  ${getLogFile()}`);
+						printEndpoints(info.url);
+					} catch (err) {
+						console.error(require_index.colors.red(`Failed to start service: ${err.message}`));
+						process.exitCode = 1;
+					}
+					break;
+				}
+				case "_run": {
+					const logTs = () => (/* @__PURE__ */ new Date()).toISOString();
+					process.on("uncaughtException", (err) => {
+						console.error(`[${logTs()}] FATAL uncaughtException: ${err.stack || err.message}`);
+						process.exit(1);
+					});
+					process.on("unhandledRejection", (reason) => {
+						const msg = reason instanceof Error ? reason.stack || reason.message : String(reason);
+						console.error(`[${logTs()}] FATAL unhandledRejection: ${msg}`);
+						process.exit(1);
+					});
+					const { homedir } = await import("node:os");
+					const cwd = argv.cwd ?? homedir();
+					const { createAFS } = await Promise.resolve().then(() => require("../../config/afs-loader.cjs"));
+					const { startDaemonServer } = await Promise.resolve().then(() => require("../../daemon/server.cjs"));
+					const { DaemonConfigManager } = await Promise.resolve().then(() => require("../../daemon/config-manager.cjs"));
+					const { writePidFile, writePortFile, ensureDaemonDir, cleanPidFiles } = await Promise.resolve().then(() => require("../../daemon/manager.cjs"));
+					const { createCredentialStore } = await Promise.resolve().then(() => require("../../credential/store.cjs"));
+					const { afs, failures, configMountPaths, registry } = await createAFS(cwd, { credentialStore: createCredentialStore() });
+					if (failures.length > 0) {
+						console.warn(`[${logTs()}] ${failures.length} provider(s) failed to mount:`);
+						for (const f of failures) console.warn(`  ${f.path}: ${f.reason}`);
+					}
+					const configManager = new DaemonConfigManager({
+						cwd,
+						afs,
+						registry,
+						configMountPaths,
+						failures: failures.map((f) => ({
+							path: f.path,
+							uri: "",
+							reason: f.reason
+						})),
+						onConfigChanged: (added, removed) => {
+							if (serverInfo?.server) serverInfo.server.broadcast("configReloaded", {
+								added,
+								removed
+							});
+						}
+					});
+					configManager.startWatching();
+					const { ProgramManager } = await Promise.resolve().then(() => require("../../program/program-manager.cjs"));
+					const { scanProgramTriggers } = await Promise.resolve().then(() => require("../../program/trigger-scanner.cjs"));
+					const { listInstalledPrograms, getUserConfigDir } = await Promise.resolve().then(() => require("../../config/program-install.cjs"));
+					const userConfigDir = getUserConfigDir();
+					const programManager = new ProgramManager({
+						globalAFS: afs,
+						createProvider: afs.createProviderFromMount,
+						listPrograms: async () => {
+							return (await listInstalledPrograms({ userConfigDir })).map((p) => ({
+								id: p.id,
+								installPath: p.installPath,
+								mountPath: p.mountPath
+							}));
+						},
+						scanTriggers: async (programDir) => {
+							let compile = null;
+							try {
+								compile = (await import("@aigne/ash")).compileSource;
+							} catch {}
+							return scanProgramTriggers(programDir, compile);
+						},
+						dataDir: (programId) => `/.data/${programId}`
+					});
+					try {
+						await programManager.activateAll();
+						const activated = programManager.getActivatedPrograms();
+						if (activated.length > 0) console.log(`[${logTs()}] Activated ${activated.length} program(s): ${activated.join(", ")}`);
+					} catch (err) {
+						console.warn(`[${logTs()}] Program activation failed: ${err instanceof Error ? err.message : err}`);
+					}
+					let serverInfo;
+					serverInfo = await startDaemonServer({
+						afs,
+						port: argv.port,
+						configManager,
+						programManager
+					});
+					await ensureDaemonDir();
+					await writePidFile(process.pid);
+					await writePortFile(serverInfo.port);
+					const mounts = afs.getMounts();
+					console.log(`[${logTs()}] AFS Service started`);
+					console.log(`PID: ${process.pid}, Port: ${serverInfo.port}`);
+					console.log(`MCP: ${serverInfo.mcpUrl}`);
+					for (const m of mounts) console.log(`  ${m.path} → ${m.module.name}`);
+					let shuttingDown = false;
+					const shutdown = async () => {
+						if (shuttingDown) return;
+						shuttingDown = true;
+						console.log(`[${logTs()}] Shutting down service...`);
+						try {
+							await programManager.deactivateAll();
+						} catch (err) {
+							console.warn(`[${logTs()}] Program deactivation error: ${err instanceof Error ? err.message : err}`);
+						}
+						configManager.stopWatching();
+						serverInfo?.stop();
+						await cleanPidFiles();
+						process.exit(0);
+					};
+					process.on("SIGINT", shutdown);
+					process.on("SIGTERM", shutdown);
+					await new Promise(() => {});
+					break;
+				}
+				case "stop":
+					if (await stopDaemon()) console.log(require_index.colors.green("Service stopped"));
+					else console.log(require_index.colors.yellow("No running service found"));
+					break;
+				case "status": {
+					const info = await getDaemonStatus();
+					if (info) {
+						console.log(require_index.colors.green("Service is running"));
+						console.log(`  PID:  ${info.pid}`);
+						console.log(`  Port: ${info.port}`);
+						printEndpoints(info.url);
+					} else console.log(require_index.colors.dim("Service is not running"));
+					break;
+				}
+				case "restart":
+					if (await stopDaemon()) console.log(require_index.colors.dim("Stopped existing service, restarting..."));
+					console.log(require_index.colors.dim("Starting AFS service..."));
+					try {
+						const info = await spawnDaemon(argv.port);
+						console.log(require_index.colors.green("AFS Service restarted"));
+						console.log(`  ${require_index.colors.dim("PID:")}  ${info.pid}`);
+						console.log(`  ${require_index.colors.dim("Port:")} ${info.port}`);
+						printEndpoints(info.url);
+					} catch (err) {
+						console.error(require_index.colors.red(`Failed to restart service: ${err.message}`));
+						process.exitCode = 1;
+					}
+					break;
+			}
+			options.onResult({
+				command: "service",
+				result: null,
+				format: noopFormat
+			});
+		}
+	};
+}
+
+//#endregion
+exports.createServiceCommand = createServiceCommand;

package/dist/core/commands/daemon.d.mts

@@ -0,0 +1,2 @@
+import "./types.mjs";
+import { CommandModule } from "yargs";

package/dist/core/commands/daemon.mjs

@@ -0,0 +1,208 @@
+import { colors } from "../../ui/index.mjs";
+
+//#region src/core/commands/daemon.ts
+/** No-op formatter for lifecycle commands that manage their own output. */
+const noopFormat = () => "";
+/** Print endpoint table for a running service. */
+function printEndpoints(url) {
+	console.log("");
+	console.log(`  ${colors.dim("Endpoints:")}`);
+	console.log(`    ${colors.brightCyan(`${url}/`)}${colors.dim("        Explorer UI")}`);
+	console.log(`    ${colors.brightCyan(`${url}/ws`)}${colors.dim("      WebSocket JSON-RPC")}`);
+	console.log(`    ${colors.brightCyan(`${url}/afs/*`)}${colors.dim("   REST API")}`);
+	console.log(`    ${colors.brightCyan(`${url}/mcp`)}${colors.dim("     MCP Streamable HTTP")}`);
+}
+function createServiceCommand(options) {
+	return {
+		command: "service <action>",
+		describe: "Manage AFS background service",
+		builder: (yargs) => yargs.positional("action", {
+			type: "string",
+			choices: [
+				"start",
+				"stop",
+				"status",
+				"restart"
+			],
+			description: "Service action"
+		}).option("port", {
+			type: "number",
+			default: 4900,
+			description: "Port for service"
+		}).option("cwd", {
+			type: "string",
+			hidden: true,
+			description: "Working directory (used by _run)"
+		}),
+		handler: async (argv) => {
+			const action = argv.action;
+			const { getDaemonStatus, stopDaemon, spawnDaemon, getLogFile } = await import("../../daemon/manager.mjs");
+			switch (action) {
+				case "start": {
+					const existing = await getDaemonStatus();
+					if (existing) {
+						console.log(`${colors.yellow("Service already running")} (PID ${existing.pid}, port ${existing.port})`);
+						printEndpoints(existing.url);
+						return;
+					}
+					console.log(colors.dim("Starting AFS service..."));
+					try {
+						const info = await spawnDaemon(argv.port);
+						console.log(colors.green("AFS Service started"));
+						console.log(`  ${colors.dim("PID:")}  ${info.pid}`);
+						console.log(`  ${colors.dim("Port:")} ${info.port}`);
+						console.log(`  ${colors.dim("Log:")}  ${getLogFile()}`);
+						printEndpoints(info.url);
+					} catch (err) {
+						console.error(colors.red(`Failed to start service: ${err.message}`));
+						process.exitCode = 1;
+					}
+					break;
+				}
+				case "_run": {
+					const logTs = () => (/* @__PURE__ */ new Date()).toISOString();
+					process.on("uncaughtException", (err) => {
+						console.error(`[${logTs()}] FATAL uncaughtException: ${err.stack || err.message}`);
+						process.exit(1);
+					});
+					process.on("unhandledRejection", (reason) => {
+						const msg = reason instanceof Error ? reason.stack || reason.message : String(reason);
+						console.error(`[${logTs()}] FATAL unhandledRejection: ${msg}`);
+						process.exit(1);
+					});
+					const { homedir } = await import("node:os");
+					const cwd = argv.cwd ?? homedir();
+					const { createAFS } = await import("../../config/afs-loader.mjs");
+					const { startDaemonServer } = await import("../../daemon/server.mjs");
+					const { DaemonConfigManager } = await import("../../daemon/config-manager.mjs");
+					const { writePidFile, writePortFile, ensureDaemonDir, cleanPidFiles } = await import("../../daemon/manager.mjs");
+					const { createCredentialStore } = await import("../../credential/store.mjs");
+					const { afs, failures, configMountPaths, registry } = await createAFS(cwd, { credentialStore: createCredentialStore() });
+					if (failures.length > 0) {
+						console.warn(`[${logTs()}] ${failures.length} provider(s) failed to mount:`);
+						for (const f of failures) console.warn(`  ${f.path}: ${f.reason}`);
+					}
+					const configManager = new DaemonConfigManager({
+						cwd,
+						afs,
+						registry,
+						configMountPaths,
+						failures: failures.map((f) => ({
+							path: f.path,
+							uri: "",
+							reason: f.reason
+						})),
+						onConfigChanged: (added, removed) => {
+							if (serverInfo?.server) serverInfo.server.broadcast("configReloaded", {
+								added,
+								removed
+							});
+						}
+					});
+					configManager.startWatching();
+					const { ProgramManager } = await import("../../program/program-manager.mjs");
+					const { scanProgramTriggers } = await import("../../program/trigger-scanner.mjs");
+					const { listInstalledPrograms, getUserConfigDir } = await import("../../config/program-install.mjs");
+					const userConfigDir = getUserConfigDir();
+					const programManager = new ProgramManager({
+						globalAFS: afs,
+						createProvider: afs.createProviderFromMount,
+						listPrograms: async () => {
+							return (await listInstalledPrograms({ userConfigDir })).map((p) => ({
+								id: p.id,
+								installPath: p.installPath,
+								mountPath: p.mountPath
+							}));
+						},
+						scanTriggers: async (programDir) => {
+							let compile = null;
+							try {
+								compile = (await import("@aigne/ash")).compileSource;
+							} catch {}
+							return scanProgramTriggers(programDir, compile);
+						},
+						dataDir: (programId) => `/.data/${programId}`
+					});
+					try {
+						await programManager.activateAll();
+						const activated = programManager.getActivatedPrograms();
+						if (activated.length > 0) console.log(`[${logTs()}] Activated ${activated.length} program(s): ${activated.join(", ")}`);
+					} catch (err) {
+						console.warn(`[${logTs()}] Program activation failed: ${err instanceof Error ? err.message : err}`);
+					}
+					let serverInfo;
+					serverInfo = await startDaemonServer({
+						afs,
+						port: argv.port,
+						configManager,
+						programManager
+					});
+					await ensureDaemonDir();
+					await writePidFile(process.pid);
+					await writePortFile(serverInfo.port);
+					const mounts = afs.getMounts();
+					console.log(`[${logTs()}] AFS Service started`);
+					console.log(`PID: ${process.pid}, Port: ${serverInfo.port}`);
+					console.log(`MCP: ${serverInfo.mcpUrl}`);
+					for (const m of mounts) console.log(`  ${m.path} → ${m.module.name}`);
+					let shuttingDown = false;
+					const shutdown = async () => {
+						if (shuttingDown) return;
+						shuttingDown = true;
+						console.log(`[${logTs()}] Shutting down service...`);
+						try {
+							await programManager.deactivateAll();
+						} catch (err) {
+							console.warn(`[${logTs()}] Program deactivation error: ${err instanceof Error ? err.message : err}`);
+						}
+						configManager.stopWatching();
+						serverInfo?.stop();
+						await cleanPidFiles();
+						process.exit(0);
+					};
+					process.on("SIGINT", shutdown);
+					process.on("SIGTERM", shutdown);
+					await new Promise(() => {});
+					break;
+				}
+				case "stop":
+					if (await stopDaemon()) console.log(colors.green("Service stopped"));
+					else console.log(colors.yellow("No running service found"));
+					break;
+				case "status": {
+					const info = await getDaemonStatus();
+					if (info) {
+						console.log(colors.green("Service is running"));
+						console.log(`  PID:  ${info.pid}`);
+						console.log(`  Port: ${info.port}`);
+						printEndpoints(info.url);
+					} else console.log(colors.dim("Service is not running"));
+					break;
+				}
+				case "restart":
+					if (await stopDaemon()) console.log(colors.dim("Stopped existing service, restarting..."));
+					console.log(colors.dim("Starting AFS service..."));
+					try {
+						const info = await spawnDaemon(argv.port);
+						console.log(colors.green("AFS Service restarted"));
+						console.log(`  ${colors.dim("PID:")}  ${info.pid}`);
+						console.log(`  ${colors.dim("Port:")} ${info.port}`);
+						printEndpoints(info.url);
+					} catch (err) {
+						console.error(colors.red(`Failed to restart service: ${err.message}`));
+						process.exitCode = 1;
+					}
+					break;
+			}
+			options.onResult({
+				command: "service",
+				result: null,
+				format: noopFormat
+			});
+		}
+	};
+}
+
+//#endregion
+export { createServiceCommand };
+//# sourceMappingURL=daemon.mjs.map

package/dist/core/commands/daemon.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.mjs","names":[],"sources":["../../../src/core/commands/daemon.ts"],"sourcesContent":["/**\n * AFS Service Command\n *\n * Manages the AFS background service process.\n * Subcommands: start, stop, status, restart, _run (hidden)\n *\n * File is named daemon.ts for historical reasons; the user-facing command is \"service\".\n */\n\nimport type { CommandModule } from \"yargs\";\nimport { colors } from \"../../ui/index.js\";\nimport type { CommandFactoryOptions } from \"./types.js\";\n\nexport interface ServiceArgs {\n  port: number;\n  cwd?: string;\n}\n\n/** No-op formatter for lifecycle commands that manage their own output. */\nconst noopFormat = () => \"\";\n\n/** Print endpoint table for a running service. */\nfunction printEndpoints(url: string): void {\n  console.log(\"\");\n  console.log(`  ${colors.dim(\"Endpoints:\")}`);\n  console.log(`    ${colors.brightCyan(`${url}/`)}${colors.dim(\"        Explorer UI\")}`);\n  console.log(`    ${colors.brightCyan(`${url}/ws`)}${colors.dim(\"      WebSocket JSON-RPC\")}`);\n  console.log(`    ${colors.brightCyan(`${url}/afs/*`)}${colors.dim(\"   REST API\")}`);\n  console.log(`    ${colors.brightCyan(`${url}/mcp`)}${colors.dim(\"     MCP Streamable HTTP\")}`);\n}\n\nexport function createServiceCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, ServiceArgs> {\n  return {\n    command: \"service <action>\",\n    describe: \"Manage AFS background service\",\n    builder: (yargs) =>\n      yargs\n        .positional(\"action\", {\n          type: \"string\",\n          choices: [\"start\", \"stop\", \"status\", \"restart\"],\n          description: \"Service action\",\n        })\n        .option(\"port\", {\n          type: \"number\",\n          default: 4900,\n          description: \"Port for service\",\n        })\n        .option(\"cwd\", {\n          type: \"string\",\n          hidden: true,\n          description: \"Working directory (used by _run)\",\n        }) as any,\n    handler: async (argv) => {\n      const action = (argv as any).action as string;\n      const { getDaemonStatus, stopDaemon, spawnDaemon, getLogFile } = await import(\n        \"../../daemon/manager.js\"\n      );\n\n      switch (action) {\n        case \"start\": {\n          const existing = await getDaemonStatus();\n          if (existing) {\n            console.log(\n              `${colors.yellow(\"Service already running\")} (PID ${existing.pid}, port ${existing.port})`,\n            );\n            printEndpoints(existing.url);\n            return;\n          }\n\n          console.log(colors.dim(\"Starting AFS service...\"));\n\n          try {\n            const info = await spawnDaemon(argv.port);\n            console.log(colors.green(\"AFS Service started\"));\n            console.log(`  ${colors.dim(\"PID:\")}  ${info.pid}`);\n            console.log(`  ${colors.dim(\"Port:\")} ${info.port}`);\n            console.log(`  ${colors.dim(\"Log:\")}  ${getLogFile()}`);\n            printEndpoints(info.url);\n          } catch (err) {\n            console.error(colors.red(`Failed to start service: ${(err as Error).message}`));\n            process.exitCode = 1;\n          }\n          break;\n        }\n\n        case \"_run\": {\n          // Hidden subcommand — the actual service process (runs in detached child)\n\n          // Install crash handlers immediately — before any async work.\n          // Without these, uncaught errors kill the process with no trace in the log.\n          const logTs = () => new Date().toISOString();\n          process.on(\"uncaughtException\", (err) => {\n            console.error(`[${logTs()}] FATAL uncaughtException: ${err.stack || err.message}`);\n            process.exit(1);\n          });\n          process.on(\"unhandledRejection\", (reason) => {\n            const msg = reason instanceof Error ? reason.stack || reason.message : String(reason);\n            console.error(`[${logTs()}] FATAL unhandledRejection: ${msg}`);\n            process.exit(1);\n          });\n\n          // Always use home directory for config discovery — daemon serves a\n          // global AFS instance, independent of which directory it was started from.\n          const { homedir } = await import(\"node:os\");\n          const cwd = argv.cwd ?? homedir();\n          const { createAFS } = await import(\"../../config/afs-loader.js\");\n          const { startDaemonServer } = await import(\"../../daemon/server.js\");\n          const { DaemonConfigManager } = await import(\"../../daemon/config-manager.js\");\n          const { writePidFile, writePortFile, ensureDaemonDir, cleanPidFiles } = await import(\n            \"../../daemon/manager.js\"\n          );\n          const { createCredentialStore } = await import(\"../../credential/store.js\");\n\n          const { afs, failures, configMountPaths, registry } = await createAFS(cwd, {\n            credentialStore: createCredentialStore(),\n            // No authContext — daemon is non-interactive, relies on stored credentials\n          });\n\n          if (failures.length > 0) {\n            console.warn(`[${logTs()}] ${failures.length} provider(s) failed to mount:`);\n            for (const f of failures) {\n              console.warn(`  ${f.path}: ${f.reason}`);\n            }\n          }\n\n          const configManager = new DaemonConfigManager({\n            cwd,\n            afs,\n            registry,\n            configMountPaths,\n            failures: failures.map((f) => ({ path: f.path, uri: \"\", reason: f.reason })),\n            onConfigChanged: (added, removed) => {\n              if (serverInfo?.server) {\n                serverInfo.server.broadcast(\"configReloaded\", { added, removed });\n              }\n            },\n          });\n          configManager.startWatching();\n\n          // Initialize ProgramManager for program activation\n          const { ProgramManager } = await import(\"../../program/program-manager.js\");\n          const { scanProgramTriggers } = await import(\"../../program/trigger-scanner.js\");\n          const { listInstalledPrograms, getUserConfigDir } = await import(\n            \"../../config/program-install.js\"\n          );\n\n          const userConfigDir = getUserConfigDir();\n          const programManager = new ProgramManager({\n            globalAFS: afs,\n            createProvider: afs.createProviderFromMount,\n            listPrograms: async () => {\n              const programs = await listInstalledPrograms({ userConfigDir });\n              return programs.map((p) => ({\n                id: p.id,\n                installPath: p.installPath,\n                mountPath: p.mountPath,\n              }));\n            },\n            scanTriggers: async (programDir: string) => {\n              let compile = null;\n              try {\n                // Dynamic import — @aigne/ash is an optional peer dependency\n                const ashModule = \"@aigne/ash\";\n                const mod = await import(/* webpackIgnore: true */ ashModule);\n                compile = mod.compileSource;\n              } catch {\n                // @aigne/ash not available — use regex fallback\n              }\n              return scanProgramTriggers(programDir, compile);\n            },\n            dataDir: (programId: string) => `/.data/${programId}`,\n          });\n\n          // Activate all programs (best-effort — failures don't block daemon startup)\n          try {\n            await programManager.activateAll();\n            const activated = programManager.getActivatedPrograms();\n            if (activated.length > 0) {\n              console.log(\n                `[${logTs()}] Activated ${activated.length} program(s): ${activated.join(\", \")}`,\n              );\n            }\n          } catch (err) {\n            console.warn(\n              `[${logTs()}] Program activation failed: ${err instanceof Error ? err.message : err}`,\n            );\n          }\n\n          let serverInfo: Awaited<ReturnType<typeof startDaemonServer>> | undefined;\n          serverInfo = await startDaemonServer({\n            afs,\n            port: argv.port,\n            configManager,\n            programManager,\n          });\n\n          // Write PID and port files so parent (and status/stop) can find us\n          await ensureDaemonDir();\n          await writePidFile(process.pid);\n          await writePortFile(serverInfo.port);\n\n          const mounts = afs.getMounts();\n          console.log(`[${logTs()}] AFS Service started`);\n          console.log(`PID: ${process.pid}, Port: ${serverInfo.port}`);\n          console.log(`MCP: ${serverInfo.mcpUrl}`);\n          for (const m of mounts) {\n            console.log(`  ${m.path} → ${m.module.name}`);\n          }\n\n          // Graceful shutdown\n          let shuttingDown = false;\n          const shutdown = async () => {\n            if (shuttingDown) return;\n            shuttingDown = true;\n            console.log(`[${logTs()}] Shutting down service...`);\n            try {\n              await programManager.deactivateAll();\n            } catch (err) {\n              console.warn(\n                `[${logTs()}] Program deactivation error: ${err instanceof Error ? err.message : err}`,\n              );\n            }\n            configManager.stopWatching();\n            serverInfo?.stop();\n            await cleanPidFiles();\n            process.exit(0);\n          };\n\n          process.on(\"SIGINT\", shutdown);\n          process.on(\"SIGTERM\", shutdown);\n\n          // Keep running\n          await new Promise(() => {});\n          break;\n        }\n\n        case \"stop\": {\n          const stopped = await stopDaemon();\n          if (stopped) {\n            console.log(colors.green(\"Service stopped\"));\n          } else {\n            console.log(colors.yellow(\"No running service found\"));\n          }\n          break;\n        }\n\n        case \"status\": {\n          const info = await getDaemonStatus();\n          if (info) {\n            console.log(colors.green(\"Service is running\"));\n            console.log(`  PID:  ${info.pid}`);\n            console.log(`  Port: ${info.port}`);\n            printEndpoints(info.url);\n          } else {\n            console.log(colors.dim(\"Service is not running\"));\n          }\n          break;\n        }\n\n        case \"restart\": {\n          const wasRunning = await stopDaemon();\n          if (wasRunning) {\n            console.log(colors.dim(\"Stopped existing service, restarting...\"));\n          }\n\n          console.log(colors.dim(\"Starting AFS service...\"));\n          try {\n            const info = await spawnDaemon(argv.port);\n            console.log(colors.green(\"AFS Service restarted\"));\n            console.log(`  ${colors.dim(\"PID:\")}  ${info.pid}`);\n            console.log(`  ${colors.dim(\"Port:\")} ${info.port}`);\n            printEndpoints(info.url);\n          } catch (err) {\n            console.error(colors.red(`Failed to restart service: ${(err as Error).message}`));\n            process.exitCode = 1;\n          }\n          break;\n        }\n      }\n\n      // Signal executor that command ran (output already printed above)\n      options.onResult({ command: \"service\", result: null, format: noopFormat });\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/core/commands/explain.cjs

@@ -165,7 +165,9 @@ async function explainMounts(cwd, afs) {
 				explanation: `Runtime mounts (mounted via API):\n\n${listResult.data.map((entry) => `  ${entry.path} (runtime mount)`).join("\n")}`,
 				examples: listResult.data.slice(0, 3).map((entry) => `afs ls ${entry.path}`)
 			};
-		} catch {}
+		} catch (err) {
+			console.debug("[explain] mount enumeration failed:", err);
+		}
 		return {
 			topic: "Mounts",
 			explanation: `No mounts configured.

package/dist/core/commands/explain.mjs

@@ -165,7 +165,9 @@ async function explainMounts(cwd, afs) {
 				explanation: `Runtime mounts (mounted via API):\n\n${listResult.data.map((entry) => `  ${entry.path} (runtime mount)`).join("\n")}`,
 				examples: listResult.data.slice(0, 3).map((entry) => `afs ls ${entry.path}`)
 			};
-		} catch {}
+		} catch (err) {
+			console.debug("[explain] mount enumeration failed:", err);
+		}
 		return {
 			topic: "Mounts",
 			explanation: `No mounts configured.