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

package/dist/core/commands/install.cjs

@@ -0,0 +1,91 @@
+const require_install = require('../formatters/install.cjs');
+const require_program_install = require('../../config/program-install.cjs');
+
+//#region src/core/commands/install.ts
+/**
+* Create program command factory (with subcommands)
+*/
+function createInstallCommand(options) {
+	return {
+		command: "program",
+		describe: "Install and manage AFS programs",
+		builder: (yargs) => yargs.command(createProgramInstallSubcommand(options)).command(createProgramListSubcommand(options)).command(createProgramUninstallSubcommand(options)).demandCommand(1, "Specify a subcommand: install, list, uninstall").alias("help", "h"),
+		handler: () => {}
+	};
+}
+/**
+* program install <source>
+*/
+function createProgramInstallSubcommand(options) {
+	return {
+		command: "install <source>",
+		describe: "Install a program from local directory, GitHub URL, or zip file",
+		builder: { source: {
+			type: "string",
+			demandOption: true,
+			description: "Source: local path, GitHub URL, or .zip file"
+		} },
+		handler: async (argv) => {
+			const cwd = options.cwd ?? process.cwd();
+			const result = await require_program_install.installProgram(argv.source, { cwd });
+			options.onResult({
+				command: "program install",
+				result,
+				format: require_install.formatInstallAddOutput
+			});
+		}
+	};
+}
+/**
+* program list
+*/
+function createProgramListSubcommand(options) {
+	return {
+		command: ["list", "ls"],
+		describe: "List installed programs",
+		handler: async () => {
+			const programs = await require_program_install.listInstalledPrograms();
+			options.onResult({
+				command: "program list",
+				result: programs,
+				format: require_install.formatInstallListOutput
+			});
+		}
+	};
+}
+/**
+* program uninstall <id>
+*/
+function createProgramUninstallSubcommand(options) {
+	return {
+		command: "uninstall <id>",
+		describe: "Uninstall an installed program",
+		builder: {
+			id: {
+				type: "string",
+				demandOption: true,
+				description: "Program ID to uninstall"
+			},
+			purge: {
+				type: "boolean",
+				default: false,
+				description: "Also remove program data directory"
+			}
+		},
+		handler: async (argv) => {
+			const cwd = options.cwd ?? process.cwd();
+			const result = await require_program_install.removeProgram(argv.id, {
+				purge: argv.purge,
+				cwd
+			});
+			options.onResult({
+				command: "program uninstall",
+				result,
+				format: require_install.formatInstallRemoveOutput
+			});
+		}
+	};
+}
+
+//#endregion
+exports.createInstallCommand = createInstallCommand;

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

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

package/dist/core/commands/install.mjs

@@ -0,0 +1,92 @@
+import { formatInstallAddOutput, formatInstallListOutput, formatInstallRemoveOutput } from "../formatters/install.mjs";
+import { installProgram, listInstalledPrograms, removeProgram } from "../../config/program-install.mjs";
+
+//#region src/core/commands/install.ts
+/**
+* Create program command factory (with subcommands)
+*/
+function createInstallCommand(options) {
+	return {
+		command: "program",
+		describe: "Install and manage AFS programs",
+		builder: (yargs) => yargs.command(createProgramInstallSubcommand(options)).command(createProgramListSubcommand(options)).command(createProgramUninstallSubcommand(options)).demandCommand(1, "Specify a subcommand: install, list, uninstall").alias("help", "h"),
+		handler: () => {}
+	};
+}
+/**
+* program install <source>
+*/
+function createProgramInstallSubcommand(options) {
+	return {
+		command: "install <source>",
+		describe: "Install a program from local directory, GitHub URL, or zip file",
+		builder: { source: {
+			type: "string",
+			demandOption: true,
+			description: "Source: local path, GitHub URL, or .zip file"
+		} },
+		handler: async (argv) => {
+			const cwd = options.cwd ?? process.cwd();
+			const result = await installProgram(argv.source, { cwd });
+			options.onResult({
+				command: "program install",
+				result,
+				format: formatInstallAddOutput
+			});
+		}
+	};
+}
+/**
+* program list
+*/
+function createProgramListSubcommand(options) {
+	return {
+		command: ["list", "ls"],
+		describe: "List installed programs",
+		handler: async () => {
+			const programs = await listInstalledPrograms();
+			options.onResult({
+				command: "program list",
+				result: programs,
+				format: formatInstallListOutput
+			});
+		}
+	};
+}
+/**
+* program uninstall <id>
+*/
+function createProgramUninstallSubcommand(options) {
+	return {
+		command: "uninstall <id>",
+		describe: "Uninstall an installed program",
+		builder: {
+			id: {
+				type: "string",
+				demandOption: true,
+				description: "Program ID to uninstall"
+			},
+			purge: {
+				type: "boolean",
+				default: false,
+				description: "Also remove program data directory"
+			}
+		},
+		handler: async (argv) => {
+			const cwd = options.cwd ?? process.cwd();
+			const result = await removeProgram(argv.id, {
+				purge: argv.purge,
+				cwd
+			});
+			options.onResult({
+				command: "program uninstall",
+				result,
+				format: formatInstallRemoveOutput
+			});
+		}
+	};
+}
+
+//#endregion
+export { createInstallCommand };
+//# sourceMappingURL=install.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.mjs","names":[],"sources":["../../../src/core/commands/install.ts"],"sourcesContent":["/**\n * program Command — Install, list, and uninstall AFS programs.\n *\n * Programs are installed to ~/.afs-config/programs/<id>/\n * and mounted at /programs/<id> in user-level config.\n */\n\nimport type { Argv, CommandModule } from \"yargs\";\nimport {\n  installProgram,\n  listInstalledPrograms,\n  removeProgram,\n} from \"../../config/program-install.js\";\nimport {\n  formatInstallAddOutput,\n  formatInstallListOutput,\n  formatInstallRemoveOutput,\n} from \"../formatters/install.js\";\nimport type { CommandFactoryOptions } from \"./types.js\";\n\nexport interface InstallAddArgs {\n  source: string;\n}\n\nexport interface InstallRemoveArgs {\n  id: string;\n  purge?: boolean;\n}\n\n/**\n * Create program command factory (with subcommands)\n */\nexport function createInstallCommand(options: CommandFactoryOptions): CommandModule {\n  return {\n    command: \"program\",\n    describe: \"Install and manage AFS programs\",\n    builder: (yargs: Argv) =>\n      yargs\n        .command(createProgramInstallSubcommand(options))\n        .command(createProgramListSubcommand(options))\n        .command(createProgramUninstallSubcommand(options))\n        .demandCommand(1, \"Specify a subcommand: install, list, uninstall\")\n        .alias(\"help\", \"h\"),\n    handler: () => {},\n  };\n}\n\n/**\n * program install <source>\n */\nfunction createProgramInstallSubcommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, InstallAddArgs> {\n  return {\n    command: \"install <source>\",\n    describe: \"Install a program from local directory, GitHub URL, or zip file\",\n    builder: {\n      source: {\n        type: \"string\",\n        demandOption: true,\n        description: \"Source: local path, GitHub URL, or .zip file\",\n      },\n    },\n    handler: async (argv) => {\n      const cwd = options.cwd ?? process.cwd();\n      const result = await installProgram(argv.source, { cwd });\n\n      options.onResult({\n        command: \"program install\",\n        result,\n        format: formatInstallAddOutput,\n      });\n    },\n  };\n}\n\n/**\n * program list\n */\nfunction createProgramListSubcommand(options: CommandFactoryOptions): CommandModule {\n  return {\n    command: [\"list\", \"ls\"],\n    describe: \"List installed programs\",\n    handler: async () => {\n      const programs = await listInstalledPrograms();\n\n      options.onResult({\n        command: \"program list\",\n        result: programs,\n        format: formatInstallListOutput,\n      });\n    },\n  };\n}\n\n/**\n * program uninstall <id>\n */\nfunction createProgramUninstallSubcommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, InstallRemoveArgs> {\n  return {\n    command: \"uninstall <id>\",\n    describe: \"Uninstall an installed program\",\n    builder: {\n      id: {\n        type: \"string\",\n        demandOption: true,\n        description: \"Program ID to uninstall\",\n      },\n      purge: {\n        type: \"boolean\",\n        default: false,\n        description: \"Also remove program data directory\",\n      },\n    },\n    handler: async (argv) => {\n      const cwd = options.cwd ?? process.cwd();\n      const result = await removeProgram(argv.id, { purge: argv.purge, cwd });\n\n      options.onResult({\n        command: \"program uninstall\",\n        result,\n        format: formatInstallRemoveOutput,\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;AAgCA,SAAgB,qBAAqB,SAA+C;AAClF,QAAO;EACL,SAAS;EACT,UAAU;EACV,UAAU,UACR,MACG,QAAQ,+BAA+B,QAAQ,CAAC,CAChD,QAAQ,4BAA4B,QAAQ,CAAC,CAC7C,QAAQ,iCAAiC,QAAQ,CAAC,CAClD,cAAc,GAAG,iDAAiD,CAClE,MAAM,QAAQ,IAAI;EACvB,eAAe;EAChB;;;;;AAMH,SAAS,+BACP,SACwC;AACxC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS,EACP,QAAQ;GACN,MAAM;GACN,cAAc;GACd,aAAa;GACd,EACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,QAAQ,OAAO,QAAQ,KAAK;GACxC,MAAM,SAAS,MAAM,eAAe,KAAK,QAAQ,EAAE,KAAK,CAAC;AAEzD,WAAQ,SAAS;IACf,SAAS;IACT;IACA,QAAQ;IACT,CAAC;;EAEL;;;;;AAMH,SAAS,4BAA4B,SAA+C;AAClF,QAAO;EACL,SAAS,CAAC,QAAQ,KAAK;EACvB,UAAU;EACV,SAAS,YAAY;GACnB,MAAM,WAAW,MAAM,uBAAuB;AAE9C,WAAQ,SAAS;IACf,SAAS;IACT,QAAQ;IACR,QAAQ;IACT,CAAC;;EAEL;;;;;AAMH,SAAS,iCACP,SAC2C;AAC3C,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS;GACP,IAAI;IACF,MAAM;IACN,cAAc;IACd,aAAa;IACd;GACD,OAAO;IACL,MAAM;IACN,SAAS;IACT,aAAa;IACd;GACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,QAAQ,OAAO,QAAQ,KAAK;GACxC,MAAM,SAAS,MAAM,cAAc,KAAK,IAAI;IAAE,OAAO,KAAK;IAAO;IAAK,CAAC;AAEvE,WAAQ,SAAS;IACf,SAAS;IACT;IACA,QAAQ;IACT,CAAC;;EAEL"}

package/dist/core/commands/ls.cjs

@@ -22,6 +22,16 @@ function createLsCommand(options) {
 				default: 1,
 				description: "Maximum depth to list"
 			},
+			l: {
+				type: "boolean",
+				default: false,
+				description: "Long listing format (detailed view)"
+			},
+			R: {
+				type: "boolean",
+				default: false,
+				description: "List recursively"
+			},
 			limit: {
 				type: "number",
 				description: "Maximum number of entries to return"
@@ -38,8 +48,9 @@ function createLsCommand(options) {
 		handler: async (argv) => {
 			const afs = await require_types.resolveAFS(options);
 			const canonicalPath = require_path_utils.cliPathToCanonical(argv.path || "/");
+			const depth = argv.R ? 10 : argv.depth ?? 1;
 			const result = await afs.list(canonicalPath, {
-				maxDepth: argv.depth ?? 1,
+				maxDepth: depth,
 				limit: argv.limit,
 				maxChildren: argv.maxChildren,
 				pattern: argv.pattern
@@ -47,7 +58,8 @@ function createLsCommand(options) {
 			options.onResult({
 				command: "ls",
 				result,
-				format: require_ls.formatLsOutput
+				format: require_ls.formatLsOutput,
+				...argv.l && { viewOverride: "human" }
 			});
 		}
 	};

package/dist/core/commands/ls.d.cts

@@ -8,6 +8,8 @@ import { CommandModule } from "yargs";
 interface LsArgs {
   path: string;
   depth: number;
+  l: boolean;
+  R: boolean;
   limit?: number;
   maxChildren?: number;
   pattern?: string;

package/dist/core/commands/ls.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"ls.d.cts","names":[],"sources":["../../../src/core/commands/ls.ts"],"mappings":";;;;;;;UAeiB,MAAA;EACf,IAAA;EACA,KAAA;EACA,KAAA;EACA,WAAA;EACA,OAAA;AAAA;;;;iBAMc,eAAA,CAAgB,OAAA,EAAS,qBAAA,GAAwB,aAAA,UAAuB,MAAA"}
+{"version":3,"file":"ls.d.cts","names":[],"sources":["../../../src/core/commands/ls.ts"],"mappings":";;;;;;;UAeiB,MAAA;EACf,IAAA;EACA,KAAA;EACA,CAAA;EACA,CAAA;EACA,KAAA;EACA,WAAA;EACA,OAAA;AAAA;;;;iBAMc,eAAA,CAAgB,OAAA,EAAS,qBAAA,GAAwB,aAAA,UAAuB,MAAA"}

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

@@ -8,6 +8,8 @@ import { CommandModule } from "yargs";
 interface LsArgs {
   path: string;
   depth: number;
+  l: boolean;
+  R: boolean;
   limit?: number;
   maxChildren?: number;
   pattern?: string;

package/dist/core/commands/ls.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"ls.d.mts","names":[],"sources":["../../../src/core/commands/ls.ts"],"mappings":";;;;;;;UAeiB,MAAA;EACf,IAAA;EACA,KAAA;EACA,KAAA;EACA,WAAA;EACA,OAAA;AAAA;;;;iBAMc,eAAA,CAAgB,OAAA,EAAS,qBAAA,GAAwB,aAAA,UAAuB,MAAA"}
+{"version":3,"file":"ls.d.mts","names":[],"sources":["../../../src/core/commands/ls.ts"],"mappings":";;;;;;;UAeiB,MAAA;EACf,IAAA;EACA,KAAA;EACA,CAAA;EACA,CAAA;EACA,KAAA;EACA,WAAA;EACA,OAAA;AAAA;;;;iBAMc,eAAA,CAAgB,OAAA,EAAS,qBAAA,GAAwB,aAAA,UAAuB,MAAA"}

package/dist/core/commands/ls.mjs

@@ -22,6 +22,16 @@ function createLsCommand(options) {
 				default: 1,
 				description: "Maximum depth to list"
 			},
+			l: {
+				type: "boolean",
+				default: false,
+				description: "Long listing format (detailed view)"
+			},
+			R: {
+				type: "boolean",
+				default: false,
+				description: "List recursively"
+			},
 			limit: {
 				type: "number",
 				description: "Maximum number of entries to return"
@@ -38,8 +48,9 @@ function createLsCommand(options) {
 		handler: async (argv) => {
 			const afs = await resolveAFS(options);
 			const canonicalPath = cliPathToCanonical(argv.path || "/");
+			const depth = argv.R ? 10 : argv.depth ?? 1;
 			const result = await afs.list(canonicalPath, {
-				maxDepth: argv.depth ?? 1,
+				maxDepth: depth,
 				limit: argv.limit,
 				maxChildren: argv.maxChildren,
 				pattern: argv.pattern
@@ -47,7 +58,8 @@ function createLsCommand(options) {
 			options.onResult({
 				command: "ls",
 				result,
-				format: formatLsOutput
+				format: formatLsOutput,
+				...argv.l && { viewOverride: "human" }
 			});
 		}
 	};

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

@@ -1 +1 @@
-{"version":3,"file":"ls.mjs","names":[],"sources":["../../../src/core/commands/ls.ts"],"sourcesContent":["/**\n * ls Command - Core Implementation\n *\n * Lists directory contents. Accepts AFS instance directly.\n * Returns AFSListResult directly (no custom type).\n */\n\nimport type { CommandModule } from \"yargs\";\nimport { formatLsOutput } from \"../formatters/index.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\n/**\n * Ls command arguments\n */\nexport interface LsArgs {\n  path: string;\n  depth: number;\n  limit?: number;\n  maxChildren?: number;\n  pattern?: string;\n}\n\n/**\n * Create ls command factory\n */\nexport function createLsCommand(options: CommandFactoryOptions): CommandModule<unknown, LsArgs> {\n  return {\n    command: [\"ls [path]\", \"list [path]\"],\n    describe: \"List directory contents\",\n    builder: {\n      path: {\n        type: \"string\",\n        default: \"/\",\n        description: \"Path to list\",\n      },\n      depth: {\n        type: \"number\",\n        default: 1,\n        description: \"Maximum depth to list\",\n      },\n      limit: {\n        type: \"number\",\n        description: \"Maximum number of entries to return\",\n      },\n      \"max-children\": {\n        type: \"number\",\n        description: \"Maximum children per directory\",\n      },\n      pattern: {\n        type: \"string\",\n        description: \"Glob pattern to filter entries\",\n      },\n    },\n    handler: async (argv) => {\n      const afs = await resolveAFS(options);\n      const canonicalPath = cliPathToCanonical(argv.path || \"/\");\n      const result = await afs.list(canonicalPath, {\n        maxDepth: argv.depth ?? 1,\n        limit: argv.limit,\n        maxChildren: argv.maxChildren,\n        pattern: argv.pattern,\n      });\n      options.onResult({\n        command: \"ls\",\n        result,\n        format: formatLsOutput,\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AA0BA,SAAgB,gBAAgB,SAAgE;AAC9F,QAAO;EACL,SAAS,CAAC,aAAa,cAAc;EACrC,UAAU;EACV,SAAS;GACP,MAAM;IACJ,MAAM;IACN,SAAS;IACT,aAAa;IACd;GACD,OAAO;IACL,MAAM;IACN,SAAS;IACT,aAAa;IACd;GACD,OAAO;IACL,MAAM;IACN,aAAa;IACd;GACD,gBAAgB;IACd,MAAM;IACN,aAAa;IACd;GACD,SAAS;IACP,MAAM;IACN,aAAa;IACd;GACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,gBAAgB,mBAAmB,KAAK,QAAQ,IAAI;GAC1D,MAAM,SAAS,MAAM,IAAI,KAAK,eAAe;IAC3C,UAAU,KAAK,SAAS;IACxB,OAAO,KAAK;IACZ,aAAa,KAAK;IAClB,SAAS,KAAK;IACf,CAAC;AACF,WAAQ,SAAS;IACf,SAAS;IACT;IACA,QAAQ;IACT,CAAC;;EAEL"}
+{"version":3,"file":"ls.mjs","names":[],"sources":["../../../src/core/commands/ls.ts"],"sourcesContent":["/**\n * ls Command - Core Implementation\n *\n * Lists directory contents. Accepts AFS instance directly.\n * Returns AFSListResult directly (no custom type).\n */\n\nimport type { CommandModule } from \"yargs\";\nimport { formatLsOutput } from \"../formatters/index.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\n/**\n * Ls command arguments\n */\nexport interface LsArgs {\n  path: string;\n  depth: number;\n  l: boolean;\n  R: boolean;\n  limit?: number;\n  maxChildren?: number;\n  pattern?: string;\n}\n\n/**\n * Create ls command factory\n */\nexport function createLsCommand(options: CommandFactoryOptions): CommandModule<unknown, LsArgs> {\n  return {\n    command: [\"ls [path]\", \"list [path]\"],\n    describe: \"List directory contents\",\n    builder: {\n      path: {\n        type: \"string\",\n        default: \"/\",\n        description: \"Path to list\",\n      },\n      depth: {\n        type: \"number\",\n        default: 1,\n        description: \"Maximum depth to list\",\n      },\n      l: {\n        type: \"boolean\",\n        default: false,\n        description: \"Long listing format (detailed view)\",\n      },\n      R: {\n        type: \"boolean\",\n        default: false,\n        description: \"List recursively\",\n      },\n      limit: {\n        type: \"number\",\n        description: \"Maximum number of entries to return\",\n      },\n      \"max-children\": {\n        type: \"number\",\n        description: \"Maximum children per directory\",\n      },\n      pattern: {\n        type: \"string\",\n        description: \"Glob pattern to filter entries\",\n      },\n    },\n    handler: async (argv) => {\n      const afs = await resolveAFS(options);\n      const canonicalPath = cliPathToCanonical(argv.path || \"/\");\n      const depth = argv.R ? 10 : (argv.depth ?? 1);\n      const result = await afs.list(canonicalPath, {\n        maxDepth: depth,\n        limit: argv.limit,\n        maxChildren: argv.maxChildren,\n        pattern: argv.pattern,\n      });\n      options.onResult({\n        command: \"ls\",\n        result,\n        format: formatLsOutput,\n        ...(argv.l && { viewOverride: \"human\" as const }),\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AA4BA,SAAgB,gBAAgB,SAAgE;AAC9F,QAAO;EACL,SAAS,CAAC,aAAa,cAAc;EACrC,UAAU;EACV,SAAS;GACP,MAAM;IACJ,MAAM;IACN,SAAS;IACT,aAAa;IACd;GACD,OAAO;IACL,MAAM;IACN,SAAS;IACT,aAAa;IACd;GACD,GAAG;IACD,MAAM;IACN,SAAS;IACT,aAAa;IACd;GACD,GAAG;IACD,MAAM;IACN,SAAS;IACT,aAAa;IACd;GACD,OAAO;IACL,MAAM;IACN,aAAa;IACd;GACD,gBAAgB;IACd,MAAM;IACN,aAAa;IACd;GACD,SAAS;IACP,MAAM;IACN,aAAa;IACd;GACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,gBAAgB,mBAAmB,KAAK,QAAQ,IAAI;GAC1D,MAAM,QAAQ,KAAK,IAAI,KAAM,KAAK,SAAS;GAC3C,MAAM,SAAS,MAAM,IAAI,KAAK,eAAe;IAC3C,UAAU;IACV,OAAO,KAAK;IACZ,aAAa,KAAK;IAClB,SAAS,KAAK;IACf,CAAC;AACF,WAAQ,SAAS;IACf,SAAS;IACT;IACA,QAAQ;IACR,GAAI,KAAK,KAAK,EAAE,cAAc,SAAkB;IACjD,CAAC;;EAEL"}

package/dist/core/commands/mcp-bridge.cjs

@@ -0,0 +1,201 @@
+
+//#region src/core/commands/mcp-bridge.ts
+const noopFormat = () => "";
+/** Backoff config for reconnection */
+const RECONNECT = {
+	initialDelay: 500,
+	maxDelay: 1e4,
+	factor: 1.5
+};
+function createMcpBridgeCommand(options) {
+	return {
+		command: "mcp",
+		describe: "Connect Claude Desktop (or any stdio MCP client) to AFS",
+		builder: (yargs) => yargs.option("port", {
+			type: "number",
+			default: 4900,
+			description: "Daemon port"
+		}).epilog([
+			"Bridges stdio ↔ the running AFS daemon's MCP endpoint.",
+			"Auto-starts the daemon if not running.",
+			"",
+			"Claude Desktop config example:",
+			"  { \"mcpServers\": { \"AFS\": { \"command\": \"afs\", \"args\": [\"mcp\"] } } }",
+			"",
+			"This is NOT a standalone MCP server. For that, use:",
+			"  afs serve --transport mcp-stdio    (standalone, loads AFS directly)",
+			"  afs serve --transport mcp-http     (standalone, HTTP transport)"
+		].join("\n")),
+		handler: async (argv) => {
+			const { getDaemonStatus, spawnDaemon } = await Promise.resolve().then(() => require("../../daemon/manager.cjs"));
+			const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+			const { StreamableHTTPClientTransport } = await import("@modelcontextprotocol/sdk/client/streamableHttp.js");
+			let info = await getDaemonStatus();
+			if (!info) {
+				console.error("Starting AFS service...");
+				try {
+					info = await spawnDaemon(argv.port);
+					console.error(`AFS service started on port ${info.port}`);
+				} catch (err) {
+					console.error(`Failed to start service: ${err.message}`);
+					options.onResult({
+						command: "mcp",
+						result: null,
+						format: noopFormat
+					});
+					process.exitCode = 1;
+					return;
+				}
+			}
+			const mcpUrl = new URL(info.mcpUrl);
+			let http = null;
+			let connected = false;
+			let reconnecting = false;
+			let connectingPromise = null;
+			let cachedInitialize = null;
+			/**
+			* Try to connect to the daemon's MCP endpoint.
+			* Does NOT spawn a new daemon — only connects to an existing one.
+			* Spawning is done once at startup; reconnect just waits for it to come back.
+			*
+			* On reconnect (when cachedInitialize is set), transparently replays the
+			* initialize handshake so the new daemon session is established before
+			* any client requests are forwarded.
+			*/
+			async function connectHttp() {
+				try {
+					const transport = new StreamableHTTPClientTransport(mcpUrl);
+					let swallowNextResponse = false;
+					transport.onmessage = async (message) => {
+						if (swallowNextResponse) {
+							swallowNextResponse = false;
+							return;
+						}
+						try {
+							await stdio.send(message);
+						} catch (err) {
+							console.error(`Bridge receive error: ${err.message}`);
+						}
+					};
+					transport.onclose = () => {
+						if (http !== transport) return;
+						connected = false;
+						http = null;
+						console.error("Backend disconnected, will reconnect...");
+						scheduleReconnect();
+					};
+					await transport.start();
+					if (cachedInitialize) {
+						swallowNextResponse = true;
+						await transport.send(cachedInitialize);
+						await transport.send({
+							jsonrpc: "2.0",
+							method: "notifications/initialized"
+						});
+						console.error("Session re-initialized on new daemon");
+					}
+					http = transport;
+					connected = true;
+					return true;
+				} catch {
+					return false;
+				}
+			}
+			/** Reconnect loop with exponential backoff */
+			function scheduleReconnect() {
+				if (reconnecting) return;
+				reconnecting = true;
+				let resolveGate;
+				connectingPromise = new Promise((r) => {
+					resolveGate = r;
+				});
+				let delay = RECONNECT.initialDelay;
+				const attempt = async () => {
+					if (connected) {
+						reconnecting = false;
+						resolveGate(true);
+						connectingPromise = null;
+						return;
+					}
+					if (await connectHttp()) {
+						reconnecting = false;
+						resolveGate(true);
+						connectingPromise = null;
+						console.error(`MCP bridge reconnected to ${mcpUrl}`);
+						return;
+					}
+					delay = Math.min(delay * RECONNECT.factor, RECONNECT.maxDelay);
+					setTimeout(attempt, delay);
+				};
+				attempt();
+			}
+			const stdio = new StdioServerTransport();
+			/** Send a JSON-RPC error back to the client */
+			async function sendError(id, message) {
+				try {
+					await stdio.send({
+						jsonrpc: "2.0",
+						id,
+						error: {
+							code: -32e3,
+							message
+						}
+					});
+				} catch {}
+			}
+			stdio.onmessage = async (message) => {
+				const msg = message;
+				if (msg.method === "initialize") cachedInitialize = msg;
+				if (!connected && connectingPromise) await connectingPromise;
+				if (!connected || !http) {
+					if (msg.id != null) await sendError(msg.id, "AFS service unavailable, reconnecting...");
+					return;
+				}
+				try {
+					await http.send(message);
+				} catch (err) {
+					console.error(`Bridge send error: ${err.message}`);
+					if (connected) {
+						connected = false;
+						http = null;
+						scheduleReconnect();
+					}
+					if (connectingPromise) await connectingPromise;
+					if (connected && http) try {
+						await http.send(message);
+						return;
+					} catch {}
+					if (msg.id != null) await sendError(msg.id, "AFS service unavailable, reconnecting...");
+				}
+			};
+			let shuttingDown = false;
+			const shutdown = () => {
+				if (shuttingDown) return;
+				shuttingDown = true;
+				stdio.onclose = void 0;
+				if (http) {
+					http.onclose = void 0;
+					http.close().catch(() => {});
+				}
+				stdio.close().catch(() => {});
+				setTimeout(() => process.exit(0), 50);
+			};
+			stdio.onclose = () => shutdown();
+			process.on("SIGINT", () => shutdown());
+			process.on("SIGTERM", () => shutdown());
+			connectingPromise = connectHttp();
+			const ok = await connectingPromise;
+			connectingPromise = null;
+			if (ok) console.error(`MCP bridge connected to ${info.mcpUrl}`);
+			else {
+				console.error(`MCP bridge started, waiting for daemon at ${info.mcpUrl}...`);
+				scheduleReconnect();
+			}
+			await stdio.start();
+			await new Promise(() => {});
+		}
+	};
+}
+
+//#endregion
+exports.createMcpBridgeCommand = createMcpBridgeCommand;

package/dist/core/commands/mcp-bridge.d.mts

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