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

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

@@ -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 import("../../daemon/manager.mjs");
+			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
+export { createMcpBridgeCommand };
+//# sourceMappingURL=mcp-bridge.mjs.map

package/dist/core/commands/mcp-bridge.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-bridge.mjs","names":[],"sources":["../../../src/core/commands/mcp-bridge.ts"],"sourcesContent":["/**\n * AFS MCP Bridge Command\n *\n * Stdio-to-HTTP bridge: forwards MCP protocol between stdin/stdout and the running AFS daemon's /mcp endpoint.\n * Unlike `serve --transport mcp-stdio` which runs a full MCP server, this is a pure proxy — no AFS loading needed.\n *\n * Auto-reconnects when the daemon restarts. While disconnected, requests get immediate JSON-RPC errors\n * so Claude Desktop doesn't hang waiting for a timeout.\n */\n\nimport type { JSONRPCMessage } from \"@modelcontextprotocol/sdk/types.js\";\nimport type { CommandModule } from \"yargs\";\nimport type { CommandFactoryOptions } from \"./types.js\";\n\nexport interface McpBridgeArgs {\n  port: number;\n}\n\nconst noopFormat = () => \"\";\n\n/** Backoff config for reconnection */\nconst RECONNECT = {\n  initialDelay: 500,\n  maxDelay: 10_000,\n  factor: 1.5,\n} as const;\n\nexport function createMcpBridgeCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, McpBridgeArgs> {\n  return {\n    command: \"mcp\",\n    describe: \"Connect Claude Desktop (or any stdio MCP client) to AFS\",\n    builder: (yargs) =>\n      yargs\n        .option(\"port\", {\n          type: \"number\",\n          default: 4900,\n          description: \"Daemon port\",\n        })\n        .epilog(\n          [\n            \"Bridges stdio ↔ the running AFS daemon's MCP endpoint.\",\n            \"Auto-starts the daemon if not running.\",\n            \"\",\n            \"Claude Desktop config example:\",\n            '  { \"mcpServers\": { \"AFS\": { \"command\": \"afs\", \"args\": [\"mcp\"] } } }',\n            \"\",\n            \"This is NOT a standalone MCP server. For that, use:\",\n            \"  afs serve --transport mcp-stdio    (standalone, loads AFS directly)\",\n            \"  afs serve --transport mcp-http     (standalone, HTTP transport)\",\n          ].join(\"\\n\"),\n        ),\n    handler: async (argv) => {\n      const { getDaemonStatus, spawnDaemon } = await import(\"../../daemon/manager.js\");\n      const { StdioServerTransport } = await import(\"@modelcontextprotocol/sdk/server/stdio.js\");\n      const { StreamableHTTPClientTransport } = await import(\n        \"@modelcontextprotocol/sdk/client/streamableHttp.js\"\n      );\n\n      // Ensure daemon is running\n      let info = await getDaemonStatus();\n      if (!info) {\n        console.error(\"Starting AFS service...\");\n        try {\n          info = await spawnDaemon(argv.port);\n          console.error(`AFS service started on port ${info.port}`);\n        } catch (err) {\n          console.error(`Failed to start service: ${(err as Error).message}`);\n          options.onResult({ command: \"mcp\", result: null, format: noopFormat });\n          process.exitCode = 1;\n          return;\n        }\n      }\n\n      const mcpUrl = new URL(info.mcpUrl);\n\n      // --- Reconnectable HTTP transport state ---\n      let http: InstanceType<typeof StreamableHTTPClientTransport> | null = null;\n      let connected = false;\n      let reconnecting = false;\n      // Promise that resolves when an in-flight connectHttp() finishes\n      let connectingPromise: Promise<boolean> | null = null;\n      // Cache the initialize request so we can replay it on reconnect\n      let cachedInitialize: Record<string, unknown> | null = null;\n\n      /**\n       * Try to connect to the daemon's MCP endpoint.\n       * Does NOT spawn a new daemon — only connects to an existing one.\n       * Spawning is done once at startup; reconnect just waits for it to come back.\n       *\n       * On reconnect (when cachedInitialize is set), transparently replays the\n       * initialize handshake so the new daemon session is established before\n       * any client requests are forwarded.\n       */\n      async function connectHttp(): Promise<boolean> {\n        try {\n          const transport = new StreamableHTTPClientTransport(mcpUrl);\n\n          // During re-init, suppress forwarding the initialize response to Claude Desktop\n          let swallowNextResponse = false;\n\n          // Wire http → stdio forwarding\n          transport.onmessage = async (message) => {\n            if (swallowNextResponse) {\n              swallowNextResponse = false;\n              return;\n            }\n            try {\n              await stdio.send(message);\n            } catch (err) {\n              console.error(`Bridge receive error: ${(err as Error).message}`);\n            }\n          };\n\n          transport.onclose = () => {\n            // Only handle if this is still the active transport\n            if (http !== transport) return;\n            connected = false;\n            http = null;\n            console.error(\"Backend disconnected, will reconnect...\");\n            scheduleReconnect();\n          };\n\n          await transport.start();\n\n          // On reconnect, replay the initialize handshake transparently\n          if (cachedInitialize) {\n            swallowNextResponse = true;\n            await transport.send(cachedInitialize as JSONRPCMessage);\n            // Send initialized notification to complete the handshake\n            await transport.send({ jsonrpc: \"2.0\", method: \"notifications/initialized\" });\n            console.error(\"Session re-initialized on new daemon\");\n          }\n\n          http = transport;\n          connected = true;\n          return true;\n        } catch {\n          return false;\n        }\n      }\n\n      /** Reconnect loop with exponential backoff */\n      function scheduleReconnect() {\n        if (reconnecting) return;\n        reconnecting = true;\n\n        // Create a gate promise immediately — incoming requests can await this\n        // instead of getting an instant error during the reconnect window.\n        let resolveGate!: (ok: boolean) => void;\n        connectingPromise = new Promise<boolean>((r) => {\n          resolveGate = r;\n        });\n\n        let delay: number = RECONNECT.initialDelay;\n        const attempt = async () => {\n          if (connected) {\n            reconnecting = false;\n            resolveGate(true);\n            connectingPromise = null;\n            return;\n          }\n\n          const ok = await connectHttp();\n\n          if (ok) {\n            reconnecting = false;\n            resolveGate(true);\n            connectingPromise = null;\n            console.error(`MCP bridge reconnected to ${mcpUrl}`);\n            return;\n          }\n\n          delay = Math.min(delay * RECONNECT.factor, RECONNECT.maxDelay);\n          setTimeout(attempt, delay);\n        };\n\n        // First attempt immediate — no delay for fastest recovery\n        attempt();\n      }\n\n      // --- Stdio transport (lives for the entire process lifetime) ---\n      const stdio = new StdioServerTransport();\n\n      /** Send a JSON-RPC error back to the client */\n      async function sendError(id: string | number, message: string) {\n        try {\n          await stdio.send({\n            jsonrpc: \"2.0\",\n            id,\n            error: { code: -32000, message },\n          });\n        } catch {\n          // Client may have disconnected — error response is best-effort\n        }\n      }\n\n      // Bridge: stdio → http (with fast error when disconnected)\n      stdio.onmessage = async (message) => {\n        const msg = message as Record<string, unknown>;\n\n        // Cache the initialize request for replay on reconnect\n        if (msg.method === \"initialize\") {\n          cachedInitialize = msg;\n        }\n\n        // If we're in the middle of connecting, wait for it\n        if (!connected && connectingPromise) {\n          await connectingPromise;\n        }\n\n        if (!connected || !http) {\n          if (msg.id != null) {\n            await sendError(msg.id as string | number, \"AFS service unavailable, reconnecting...\");\n          }\n          return;\n        }\n\n        try {\n          await http.send(message);\n        } catch (err) {\n          console.error(`Bridge send error: ${(err as Error).message}`);\n          // Trigger reconnect\n          if (connected) {\n            connected = false;\n            http = null;\n            scheduleReconnect();\n          }\n          // Wait for reconnection and retry once\n          if (connectingPromise) {\n            await connectingPromise;\n          }\n          if (connected && http) {\n            try {\n              await http.send(message);\n              return;\n            } catch {\n              // Retry also failed\n            }\n          }\n          if (msg.id != null) {\n            await sendError(msg.id as string | number, \"AFS service unavailable, reconnecting...\");\n          }\n        }\n      };\n\n      let shuttingDown = false;\n      const shutdown = () => {\n        if (shuttingDown) return;\n        shuttingDown = true;\n        // Detach onclose handlers BEFORE calling close() to prevent recursion\n        stdio.onclose = undefined as never;\n        if (http) {\n          http.onclose = undefined as never;\n          http.close().catch(() => {});\n        }\n        stdio.close().catch(() => {});\n        // Give a tick for cleanup, then exit\n        setTimeout(() => process.exit(0), 50);\n      };\n\n      stdio.onclose = () => shutdown();\n      process.on(\"SIGINT\", () => shutdown());\n      process.on(\"SIGTERM\", () => shutdown());\n\n      // IMPORTANT: Connect HTTP FIRST, then start stdio.\n      // This prevents the race where Claude Desktop sends `initialize`\n      // before the backend connection is ready.\n      connectingPromise = connectHttp();\n      const ok = await connectingPromise;\n      connectingPromise = null;\n\n      if (ok) {\n        console.error(`MCP bridge connected to ${info.mcpUrl}`);\n      } else {\n        console.error(`MCP bridge started, waiting for daemon at ${info.mcpUrl}...`);\n        scheduleReconnect();\n      }\n\n      // Start stdio AFTER HTTP is connected (or reconnect is scheduled)\n      await stdio.start();\n\n      // Block forever — process lives until stdin closes or signal\n      await new Promise(() => {});\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/core/commands/read.cjs

@@ -9,17 +9,30 @@ const require_types = require('./types.cjs');
 */
 function createReadCommand(options) {
 	return {
-		command: "read <path>",
+		command: ["read <path>", "cat <path>"],
 		describe: "Read file content",
-		builder: { path: {
-			type: "string",
-			demandOption: true,
-			description: "Path to read"
-		} },
+		builder: {
+			path: {
+				type: "string",
+				demandOption: true,
+				description: "Path to read"
+			},
+			"start-line": {
+				type: "number",
+				description: "Start line (1-indexed, inclusive)"
+			},
+			"end-line": {
+				type: "number",
+				description: "End line (1-indexed, inclusive). -1 for end of file"
+			}
+		},
 		handler: async (argv) => {
 			const afs = await require_types.resolveAFS(options);
 			const canonicalPath = require_path_utils.cliPathToCanonical(argv.path);
-			const result = await afs.read(canonicalPath);
+			const result = await afs.read(canonicalPath, {
+				startLine: argv.startLine,
+				endLine: argv.endLine
+			});
 			if (result.data) {
 				result.data.path = argv.path;
 				const isMeta = argv.path.endsWith("/.meta") || argv.path.includes("/.meta/");

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

@@ -7,6 +7,8 @@ import { CommandModule } from "yargs";
  */
 interface ReadArgs {
   path: string;
+  startLine?: number;
+  endLine?: number;
 }
 /**
  * Create read command factory

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

@@ -1 +1 @@
-{"version":3,"file":"read.d.cts","names":[],"sources":["../../../src/core/commands/read.ts"],"mappings":";;;;;AAsBA;;UAPiB,QAAA;EACf,IAAA;AAAA;;;;iBAMc,iBAAA,CACd,OAAA,EAAS,qBAAA,GACR,aAAA,UAAuB,QAAA"}
+{"version":3,"file":"read.d.cts","names":[],"sources":["../../../src/core/commands/read.ts"],"mappings":";;;;;;;UAeiB,QAAA;EACf,IAAA;EACA,SAAA;EACA,OAAA;AAAA;;;;iBAMc,iBAAA,CACd,OAAA,EAAS,qBAAA,GACR,aAAA,UAAuB,QAAA"}

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

@@ -7,6 +7,8 @@ import { CommandModule } from "yargs";
  */
 interface ReadArgs {
   path: string;
+  startLine?: number;
+  endLine?: number;
 }
 /**
  * Create read command factory

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

@@ -1 +1 @@
-{"version":3,"file":"read.d.mts","names":[],"sources":["../../../src/core/commands/read.ts"],"mappings":";;;;;AAsBA;;UAPiB,QAAA;EACf,IAAA;AAAA;;;;iBAMc,iBAAA,CACd,OAAA,EAAS,qBAAA,GACR,aAAA,UAAuB,QAAA"}
+{"version":3,"file":"read.d.mts","names":[],"sources":["../../../src/core/commands/read.ts"],"mappings":";;;;;;;UAeiB,QAAA;EACf,IAAA;EACA,SAAA;EACA,OAAA;AAAA;;;;iBAMc,iBAAA,CACd,OAAA,EAAS,qBAAA,GACR,aAAA,UAAuB,QAAA"}

package/dist/core/commands/read.mjs

@@ -9,17 +9,30 @@ import { resolveAFS } from "./types.mjs";
 */
 function createReadCommand(options) {
 	return {
-		command: "read <path>",
+		command: ["read <path>", "cat <path>"],
 		describe: "Read file content",
-		builder: { path: {
-			type: "string",
-			demandOption: true,
-			description: "Path to read"
-		} },
+		builder: {
+			path: {
+				type: "string",
+				demandOption: true,
+				description: "Path to read"
+			},
+			"start-line": {
+				type: "number",
+				description: "Start line (1-indexed, inclusive)"
+			},
+			"end-line": {
+				type: "number",
+				description: "End line (1-indexed, inclusive). -1 for end of file"
+			}
+		},
 		handler: async (argv) => {
 			const afs = await resolveAFS(options);
 			const canonicalPath = cliPathToCanonical(argv.path);
-			const result = await afs.read(canonicalPath);
+			const result = await afs.read(canonicalPath, {
+				startLine: argv.startLine,
+				endLine: argv.endLine
+			});
 			if (result.data) {
 				result.data.path = argv.path;
 				const isMeta = argv.path.endsWith("/.meta") || argv.path.includes("/.meta/");

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

@@ -1 +1 @@
-{"version":3,"file":"read.mjs","names":[],"sources":["../../../src/core/commands/read.ts"],"sourcesContent":["/**\n * read Command - Core Implementation\n *\n * Reads file/node content. Accepts AFS instance directly.\n * Returns AFSReadResult directly (no custom type).\n */\n\nimport type { CommandModule } from \"yargs\";\nimport { formatReadOutput } from \"../formatters/index.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\n/**\n * Read command arguments\n */\nexport interface ReadArgs {\n  path: string;\n}\n\n/**\n * Create read command factory\n */\nexport function createReadCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, ReadArgs> {\n  return {\n    command: \"read <path>\",\n    describe: \"Read file content\",\n    builder: {\n      path: {\n        type: \"string\",\n        demandOption: true,\n        description: \"Path to read\",\n      },\n    },\n    handler: async (argv) => {\n      const afs = await resolveAFS(options);\n      const canonicalPath = cliPathToCanonical(argv.path);\n      const result = await afs.read(canonicalPath);\n\n      // Use the original CLI path for display (UX-friendly, e.g. /fs instead of $afs/fs)\n      if (result.data) {\n        result.data.path = argv.path;\n\n        // Fetch metadata and actions from stat for non-virtual paths\n        const isMeta = argv.path.endsWith(\"/.meta\") || argv.path.includes(\"/.meta/\");\n        const isAction = argv.path.includes(\"/.actions\");\n\n        if (!isMeta && !isAction) {\n          try {\n            const statResult = await afs.stat(canonicalPath);\n            if (statResult.data) {\n              result.data.meta = { ...result.data.meta, ...statResult.data.meta };\n              result.data.actions = statResult.data.actions;\n            }\n          } catch {\n            // stat not supported\n          }\n        }\n      }\n\n      options.onResult({\n        command: \"read\",\n        result,\n        format: formatReadOutput,\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AAsBA,SAAgB,kBACd,SACkC;AAClC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS,EACP,MAAM;GACJ,MAAM;GACN,cAAc;GACd,aAAa;GACd,EACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,gBAAgB,mBAAmB,KAAK,KAAK;GACnD,MAAM,SAAS,MAAM,IAAI,KAAK,cAAc;AAG5C,OAAI,OAAO,MAAM;AACf,WAAO,KAAK,OAAO,KAAK;IAGxB,MAAM,SAAS,KAAK,KAAK,SAAS,SAAS,IAAI,KAAK,KAAK,SAAS,UAAU;IAC5E,MAAM,WAAW,KAAK,KAAK,SAAS,YAAY;AAEhD,QAAI,CAAC,UAAU,CAAC,SACd,KAAI;KACF,MAAM,aAAa,MAAM,IAAI,KAAK,cAAc;AAChD,SAAI,WAAW,MAAM;AACnB,aAAO,KAAK,OAAO;OAAE,GAAG,OAAO,KAAK;OAAM,GAAG,WAAW,KAAK;OAAM;AACnE,aAAO,KAAK,UAAU,WAAW,KAAK;;YAElC;;AAMZ,WAAQ,SAAS;IACf,SAAS;IACT;IACA,QAAQ;IACT,CAAC;;EAEL"}
+{"version":3,"file":"read.mjs","names":[],"sources":["../../../src/core/commands/read.ts"],"sourcesContent":["/**\n * read Command - Core Implementation\n *\n * Reads file/node content. Accepts AFS instance directly.\n * Returns AFSReadResult directly (no custom type).\n */\n\nimport type { CommandModule } from \"yargs\";\nimport { formatReadOutput } from \"../formatters/index.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\n/**\n * Read command arguments\n */\nexport interface ReadArgs {\n  path: string;\n  startLine?: number;\n  endLine?: number;\n}\n\n/**\n * Create read command factory\n */\nexport function createReadCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, ReadArgs> {\n  return {\n    command: [\"read <path>\", \"cat <path>\"],\n    describe: \"Read file content\",\n    builder: {\n      path: {\n        type: \"string\",\n        demandOption: true,\n        description: \"Path to read\",\n      },\n      \"start-line\": {\n        type: \"number\",\n        description: \"Start line (1-indexed, inclusive)\",\n      },\n      \"end-line\": {\n        type: \"number\",\n        description: \"End line (1-indexed, inclusive). -1 for end of file\",\n      },\n    },\n    handler: async (argv) => {\n      const afs = await resolveAFS(options);\n      const canonicalPath = cliPathToCanonical(argv.path);\n      const result = await afs.read(canonicalPath, {\n        startLine: argv.startLine,\n        endLine: argv.endLine,\n      });\n\n      // Use the original CLI path for display (UX-friendly, e.g. /fs instead of $afs/fs)\n      if (result.data) {\n        result.data.path = argv.path;\n\n        // Fetch metadata and actions from stat for non-virtual paths\n        const isMeta = argv.path.endsWith(\"/.meta\") || argv.path.includes(\"/.meta/\");\n        const isAction = argv.path.includes(\"/.actions\");\n\n        if (!isMeta && !isAction) {\n          try {\n            const statResult = await afs.stat(canonicalPath);\n            if (statResult.data) {\n              result.data.meta = { ...result.data.meta, ...statResult.data.meta };\n              result.data.actions = statResult.data.actions;\n            }\n          } catch {\n            // stat not supported\n          }\n        }\n      }\n\n      options.onResult({\n        command: \"read\",\n        result,\n        format: formatReadOutput,\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AAwBA,SAAgB,kBACd,SACkC;AAClC,QAAO;EACL,SAAS,CAAC,eAAe,aAAa;EACtC,UAAU;EACV,SAAS;GACP,MAAM;IACJ,MAAM;IACN,cAAc;IACd,aAAa;IACd;GACD,cAAc;IACZ,MAAM;IACN,aAAa;IACd;GACD,YAAY;IACV,MAAM;IACN,aAAa;IACd;GACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,gBAAgB,mBAAmB,KAAK,KAAK;GACnD,MAAM,SAAS,MAAM,IAAI,KAAK,eAAe;IAC3C,WAAW,KAAK;IAChB,SAAS,KAAK;IACf,CAAC;AAGF,OAAI,OAAO,MAAM;AACf,WAAO,KAAK,OAAO,KAAK;IAGxB,MAAM,SAAS,KAAK,KAAK,SAAS,SAAS,IAAI,KAAK,KAAK,SAAS,UAAU;IAC5E,MAAM,WAAW,KAAK,KAAK,SAAS,YAAY;AAEhD,QAAI,CAAC,UAAU,CAAC,SACd,KAAI;KACF,MAAM,aAAa,MAAM,IAAI,KAAK,cAAc;AAChD,SAAI,WAAW,MAAM;AACnB,aAAO,KAAK,OAAO;OAAE,GAAG,OAAO,KAAK;OAAM,GAAG,WAAW,KAAK;OAAM;AACnE,aAAO,KAAK,UAAU,WAAW,KAAK;;YAElC;;AAMZ,WAAQ,SAAS;IACf,SAAS;IACT;IACA,QAAQ;IACT,CAAC;;EAEL"}

package/dist/core/commands/search.cjs

@@ -9,7 +9,11 @@ const require_types = require('./types.cjs');
 */
 function createSearchCommand(options) {
 	return {
-		command: "search <path> <query>",
+		command: [
+			"search <path> <query>",
+			"grep <path> <query>",
+			"find <path> <query>"
+		],
 		describe: "Search for content within an AFS path",
 		builder: {
 			path: {

package/dist/core/commands/search.mjs

@@ -9,7 +9,11 @@ import { resolveAFS } from "./types.mjs";
 */
 function createSearchCommand(options) {
 	return {
-		command: "search <path> <query>",
+		command: [
+			"search <path> <query>",
+			"grep <path> <query>",
+			"find <path> <query>"
+		],
 		describe: "Search for content within an AFS path",
 		builder: {
 			path: {

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

@@ -1 +1 @@
-{"version":3,"file":"search.mjs","names":[],"sources":["../../../src/core/commands/search.ts"],"sourcesContent":["/**\n * search Command - Core Implementation\n *\n * Searches for content within an AFS path.\n * Returns AFSSearchResult directly (no custom type).\n */\n\nimport type { CommandModule } from \"yargs\";\nimport { formatSearchOutput } from \"../formatters/index.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\n/**\n * Search command arguments\n */\nexport interface SearchArgs {\n  path: string;\n  query: string;\n}\n\n/**\n * Create search command factory\n */\nexport function createSearchCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, SearchArgs> {\n  return {\n    command: \"search <path> <query>\",\n    describe: \"Search for content within an AFS path\",\n    builder: {\n      path: {\n        type: \"string\",\n        demandOption: true,\n        description: \"Path to search in\",\n      },\n      query: {\n        type: \"string\",\n        demandOption: true,\n        description: \"Search query\",\n      },\n    },\n    handler: async (argv) => {\n      const afs = await resolveAFS(options);\n      const canonicalPath = cliPathToCanonical(argv.path);\n      const result = await afs.search(canonicalPath, argv.query);\n      options.onResult({\n        command: \"search\",\n        result,\n        format: formatSearchOutput,\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AAuBA,SAAgB,oBACd,SACoC;AACpC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS;GACP,MAAM;IACJ,MAAM;IACN,cAAc;IACd,aAAa;IACd;GACD,OAAO;IACL,MAAM;IACN,cAAc;IACd,aAAa;IACd;GACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,gBAAgB,mBAAmB,KAAK,KAAK;GACnD,MAAM,SAAS,MAAM,IAAI,OAAO,eAAe,KAAK,MAAM;AAC1D,WAAQ,SAAS;IACf,SAAS;IACT;IACA,QAAQ;IACT,CAAC;;EAEL"}
+{"version":3,"file":"search.mjs","names":[],"sources":["../../../src/core/commands/search.ts"],"sourcesContent":["/**\n * search Command - Core Implementation\n *\n * Searches for content within an AFS path.\n * Returns AFSSearchResult directly (no custom type).\n */\n\nimport type { CommandModule } from \"yargs\";\nimport { formatSearchOutput } from \"../formatters/index.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\n/**\n * Search command arguments\n */\nexport interface SearchArgs {\n  path: string;\n  query: string;\n}\n\n/**\n * Create search command factory\n */\nexport function createSearchCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, SearchArgs> {\n  return {\n    command: [\"search <path> <query>\", \"grep <path> <query>\", \"find <path> <query>\"],\n    describe: \"Search for content within an AFS path\",\n    builder: {\n      path: {\n        type: \"string\",\n        demandOption: true,\n        description: \"Path to search in\",\n      },\n      query: {\n        type: \"string\",\n        demandOption: true,\n        description: \"Search query\",\n      },\n    },\n    handler: async (argv) => {\n      const afs = await resolveAFS(options);\n      const canonicalPath = cliPathToCanonical(argv.path);\n      const result = await afs.search(canonicalPath, argv.query);\n      options.onResult({\n        command: \"search\",\n        result,\n        format: formatSearchOutput,\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AAuBA,SAAgB,oBACd,SACoC;AACpC,QAAO;EACL,SAAS;GAAC;GAAyB;GAAuB;GAAsB;EAChF,UAAU;EACV,SAAS;GACP,MAAM;IACJ,MAAM;IACN,cAAc;IACd,aAAa;IACd;GACD,OAAO;IACL,MAAM;IACN,cAAc;IACd,aAAa;IACd;GACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,gBAAgB,mBAAmB,KAAK,KAAK;GACnD,MAAM,SAAS,MAAM,IAAI,OAAO,eAAe,KAAK,MAAM;AAC1D,WAAQ,SAAS;IACf,SAAS;IACT;IACA,QAAQ;IACT,CAAC;;EAEL"}

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

@@ -1 +1 @@
-{"version":3,"file":"stat.mjs","names":[],"sources":["../../../src/core/commands/stat.ts"],"sourcesContent":["/**\n * stat Command - Core Implementation\n *\n * Gets file/node statistics. Accepts AFS instance directly.\n * Returns AFSStatResult directly (no custom type).\n */\n\nimport type { AFSStatResult } from \"@aigne/afs\";\nimport type { CommandModule } from \"yargs\";\nimport { ExitCode } from \"../../errors.js\";\nimport { formatStatOutput } from \"../formatters/index.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\n/**\n * Stat command arguments\n */\nexport interface StatArgs {\n  path: string;\n}\n\n/**\n * Create stat command factory\n */\nexport function createStatCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, StatArgs> {\n  return {\n    command: \"stat <path>\",\n    describe: \"Get file or directory info\",\n    builder: {\n      path: {\n        type: \"string\",\n        demandOption: true,\n        description: \"Path to stat\",\n      },\n    },\n    handler: async (argv) => {\n      const afs = await resolveAFS(options);\n      const canonicalPath = cliPathToCanonical(argv.path);\n      let result: AFSStatResult | undefined;\n      try {\n        result = await afs.stat(canonicalPath);\n      } catch {}\n\n      if (!result) {\n        // Fallback: Use read to get detailed metadata\n        try {\n          const entry = (await afs.read(canonicalPath)).data;\n          if (entry) {\n            result = { data: { ...entry, meta: entry.meta ?? {} } };\n          }\n        } catch {}\n      }\n\n      // Use the original CLI path for display (UX-friendly, e.g. /fs instead of $afs/fs)\n      if (result?.data) {\n        result.data.path = argv.path;\n      }\n\n      const notFound = !result?.data;\n      options.onResult({\n        command: \"stat\",\n        result: result ?? { data: undefined, message: `No data found for path: ${argv.path}` },\n        format: formatStatOutput,\n        ...(notFound && {\n          error: {\n            code: ExitCode.NOT_FOUND,\n            message: `No data found for path: ${argv.path}`,\n          },\n        }),\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;AAwBA,SAAgB,kBACd,SACkC;AAClC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS,EACP,MAAM;GACJ,MAAM;GACN,cAAc;GACd,aAAa;GACd,EACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,gBAAgB,mBAAmB,KAAK,KAAK;GACnD,IAAI;AACJ,OAAI;AACF,aAAS,MAAM,IAAI,KAAK,cAAc;WAChC;AAER,OAAI,CAAC,OAEH,KAAI;IACF,MAAM,SAAS,MAAM,IAAI,KAAK,cAAc,EAAE;AAC9C,QAAI,MACF,UAAS,EAAE,MAAM;KAAE,GAAG;KAAO,MAAM,MAAM,QAAQ,EAAE;KAAE,EAAE;WAEnD;AAIV,OAAI,QAAQ,KACV,QAAO,KAAK,OAAO,KAAK;GAG1B,MAAM,WAAW,CAAC,QAAQ;AAC1B,WAAQ,SAAS;IACf,SAAS;IACT,QAAQ,UAAU;KAAE,MAAM;KAAW,SAAS,2BAA2B,KAAK;KAAQ;IACtF,QAAQ;IACR,GAAI,YAAY,EACd,OAAO;KACL,MAAM,SAAS;KACf,SAAS,2BAA2B,KAAK;KAC1C,EACF;IACF,CAAC;;EAEL"}
+{"version":3,"file":"stat.mjs","names":[],"sources":["../../../src/core/commands/stat.ts"],"sourcesContent":["/**\n * stat Command - Core Implementation\n *\n * Gets file/node statistics. Accepts AFS instance directly.\n * Returns AFSStatResult directly (no custom type).\n */\n\nimport type { AFSStatResult } from \"@aigne/afs\";\nimport type { CommandModule } from \"yargs\";\nimport { ExitCode } from \"../../errors.js\";\nimport { formatStatOutput } from \"../formatters/index.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\n/**\n * Stat command arguments\n */\nexport interface StatArgs {\n  path: string;\n}\n\n/**\n * Create stat command factory\n */\nexport function createStatCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, StatArgs> {\n  return {\n    command: \"stat <path>\",\n    describe: \"Get file or directory info\",\n    builder: {\n      path: {\n        type: \"string\",\n        demandOption: true,\n        description: \"Path to stat\",\n      },\n    },\n    handler: async (argv) => {\n      const afs = await resolveAFS(options);\n      const canonicalPath = cliPathToCanonical(argv.path);\n      let result: AFSStatResult | undefined;\n      try {\n        result = await afs.stat(canonicalPath);\n      } catch {\n        // stat() is optional — provider may not support it; fall through to read()\n      }\n\n      if (!result) {\n        // Fallback: Use read to get detailed metadata\n        try {\n          const entry = (await afs.read(canonicalPath)).data;\n          if (entry) {\n            result = { data: { ...entry, meta: entry.meta ?? {} } };\n          }\n        } catch {\n          // read() also failed — result stays undefined, handled below\n        }\n      }\n\n      // Use the original CLI path for display (UX-friendly, e.g. /fs instead of $afs/fs)\n      if (result?.data) {\n        result.data.path = argv.path;\n      }\n\n      const notFound = !result?.data;\n      options.onResult({\n        command: \"stat\",\n        result: result ?? { data: undefined, message: `No data found for path: ${argv.path}` },\n        format: formatStatOutput,\n        ...(notFound && {\n          error: {\n            code: ExitCode.NOT_FOUND,\n            message: `No data found for path: ${argv.path}`,\n          },\n        }),\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;AAwBA,SAAgB,kBACd,SACkC;AAClC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS,EACP,MAAM;GACJ,MAAM;GACN,cAAc;GACd,aAAa;GACd,EACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,gBAAgB,mBAAmB,KAAK,KAAK;GACnD,IAAI;AACJ,OAAI;AACF,aAAS,MAAM,IAAI,KAAK,cAAc;WAChC;AAIR,OAAI,CAAC,OAEH,KAAI;IACF,MAAM,SAAS,MAAM,IAAI,KAAK,cAAc,EAAE;AAC9C,QAAI,MACF,UAAS,EAAE,MAAM;KAAE,GAAG;KAAO,MAAM,MAAM,QAAQ,EAAE;KAAE,EAAE;WAEnD;AAMV,OAAI,QAAQ,KACV,QAAO,KAAK,OAAO,KAAK;GAG1B,MAAM,WAAW,CAAC,QAAQ;AAC1B,WAAQ,SAAS;IACf,SAAS;IACT,QAAQ,UAAU;KAAE,MAAM;KAAW,SAAS,2BAA2B,KAAK;KAAQ;IACtF,QAAQ;IACR,GAAI,YAAY,EACd,OAAO;KACL,MAAM,SAAS;KACf,SAAS,2BAA2B,KAAK;KAC1C,EACF;IACF,CAAC;;EAEL"}

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

@@ -22,6 +22,8 @@ interface CommandOutput {
   result: unknown;
   /** Format function to convert result to string */
   format: FormatFunction;
+  /** Override the view type (e.g. -l flag forces "human" view) */
+  viewOverride?: ViewType;
   /** Error info if command failed (presence indicates failure) */
   error?: {
     /** Exit code (from ExitCode enum) */code?: number; /** Error message */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../../../src/core/commands/types.ts"],"mappings":";;;;;;;;;;;KAmBY,cAAA,IAAkB,MAAA,OAAa,IAAA,EAAM,QAAA,EAAU,OAAA;EAAY,IAAA;AAAA;;;;UAKtD,aAAA;EAIf;EAFA,OAAA;EAIQ;EAFR,MAAA;EAME;EAJF,MAAA,EAAQ,cAAA;EAMC;EAJT,KAAA;IAWe,qCATb,IAAA,WAWI;IATJ,OAAA;EAAA;AAAA;;;;UAOa,qBAAA;EAQf;EANA,GAAA,GAAM,GAAA;EAMH;EAJH,IAAA;EAyBwB;EAvBxB,QAAA,GAAW,MAAA,EAAQ,aAAA;EAuByD;EArB5E,GAAA;AAAA;;;;;;;;KAqBU,cAAA,IAAkB,OAAA,EAAS,qBAAA,KAA0B,aAAA"}
+{"version":3,"file":"types.d.cts","names":[],"sources":["../../../src/core/commands/types.ts"],"mappings":";;;;;;;;;;;KAmBY,cAAA,IAAkB,MAAA,OAAa,IAAA,EAAM,QAAA,EAAU,OAAA;EAAY,IAAA;AAAA;;;;UAKtD,aAAA;EAIf;EAFA,OAAA;EAIQ;EAFR,MAAA;EAIe;EAFf,MAAA,EAAQ,cAAA;EAMN;EAJF,YAAA,GAAe,QAAA;EAMN;EAJT,KAAA;IAWe,qCATb,IAAA,WAWI;IATJ,OAAA;EAAA;AAAA;;;;UAOa,qBAAA;EAQf;EANA,GAAA,GAAM,GAAA;EAMH;EAJH,IAAA;EAyBwB;EAvBxB,QAAA,GAAW,MAAA,EAAQ,aAAA;EAuByD;EArB5E,GAAA;AAAA;;;;;;;;KAqBU,cAAA,IAAkB,OAAA,EAAS,qBAAA,KAA0B,aAAA"}

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

@@ -22,6 +22,8 @@ interface CommandOutput {
   result: unknown;
   /** Format function to convert result to string */
   format: FormatFunction;
+  /** Override the view type (e.g. -l flag forces "human" view) */
+  viewOverride?: ViewType;
   /** Error info if command failed (presence indicates failure) */
   error?: {
     /** Exit code (from ExitCode enum) */code?: number; /** Error message */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/core/commands/types.ts"],"mappings":";;;;;;;;;;;KAmBY,cAAA,IAAkB,MAAA,OAAa,IAAA,EAAM,QAAA,EAAU,OAAA;EAAY,IAAA;AAAA;;;;UAKtD,aAAA;EAIf;EAFA,OAAA;EAIQ;EAFR,MAAA;EAME;EAJF,MAAA,EAAQ,cAAA;EAMC;EAJT,KAAA;IAWe,qCATb,IAAA,WAWI;IATJ,OAAA;EAAA;AAAA;;;;UAOa,qBAAA;EAQf;EANA,GAAA,GAAM,GAAA;EAMH;EAJH,IAAA;EAyBwB;EAvBxB,QAAA,GAAW,MAAA,EAAQ,aAAA;EAuByD;EArB5E,GAAA;AAAA;;;;;;;;KAqBU,cAAA,IAAkB,OAAA,EAAS,qBAAA,KAA0B,aAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../src/core/commands/types.ts"],"mappings":";;;;;;;;;;;KAmBY,cAAA,IAAkB,MAAA,OAAa,IAAA,EAAM,QAAA,EAAU,OAAA;EAAY,IAAA;AAAA;;;;UAKtD,aAAA;EAIf;EAFA,OAAA;EAIQ;EAFR,MAAA;EAIe;EAFf,MAAA,EAAQ,cAAA;EAMN;EAJF,YAAA,GAAe,QAAA;EAMN;EAJT,KAAA;IAWe,qCATb,IAAA,WAWI;IATJ,OAAA;EAAA;AAAA;;;;UAOa,qBAAA;EAQf;EANA,GAAA,GAAM,GAAA;EAMH;EAJH,IAAA;EAyBwB;EAvBxB,QAAA,GAAW,MAAA,EAAQ,aAAA;EAuByD;EArB5E,GAAA;AAAA;;;;;;;;KAqBU,cAAA,IAAkB,OAAA,EAAS,qBAAA,KAA0B,aAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../../../src/core/commands/types.ts"],"sourcesContent":["/**\n * Command Factory Types\n *\n * Defines the interface for yargs CommandModule factories.\n */\n\nimport type { AFS } from \"@aigne/afs\";\nimport type { CommandModule } from \"yargs\";\nimport { loadAFS } from \"../../config/afs-loader.js\";\nimport { createCLIAuthContext } from \"../../credential/cli-auth-context.js\";\nimport { createCredentialStore } from \"../../credential/store.js\";\nimport type { ViewType } from \"../types.js\";\n\n/**\n * Format function type for command output\n *\n * Uses `any` for result type to allow different AFS result types\n * (AFSListResult, AFSReadResult, etc.) to be passed to the formatter.\n */\nexport type FormatFunction = (result: any, view: ViewType, options?: { path?: string }) => string;\n\n/**\n * Command output passed to executor via onResult callback\n */\nexport interface CommandOutput {\n  /** The command name (ls, read, write, etc.) */\n  command: string;\n  /** Raw result from AFS operation */\n  result: unknown;\n  /** Format function to convert result to string */\n  format: FormatFunction;\n  /** Error info if command failed (presence indicates failure) */\n  error?: {\n    /** Exit code (from ExitCode enum) */\n    code?: number;\n    /** Error message */\n    message: string;\n  };\n}\n\n/**\n * Options passed to command factory functions\n */\nexport interface CommandFactoryOptions {\n  /** AFS instance for executing operations (optional: injected in tests, lazy-loaded in production) */\n  afs?: AFS;\n  /** Original command line arguments (for pre-parsing in builder) */\n  argv: string[];\n  /** Callback to pass result back to executor */\n  onResult: (output: CommandOutput) => void;\n  /** Current working directory (for explore command) */\n  cwd?: string;\n}\n\n/**\n * Resolve AFS instance: use injected instance or lazy-load from config\n */\nexport function resolveAFS(options: CommandFactoryOptions): Promise<AFS> {\n  if (options.afs) return Promise.resolve(options.afs);\n  return loadAFS(options.cwd ?? process.cwd(), {\n    authContext: createCLIAuthContext(),\n    credentialStore: createCredentialStore(),\n  }).then((result) => result.afs);\n}\n\n/**\n * Command factory function type\n *\n * Uses `any` for CommandModule generics to allow different command\n * factories (with different argument types) to be stored in a common array.\n * Each individual factory uses strict types internally.\n */\nexport type CommandFactory = (options: CommandFactoryOptions) => CommandModule<unknown, any>;\n"],"mappings":";;;;;;;;AAyDA,SAAgB,WAAW,SAA8C;AACvE,KAAI,QAAQ,IAAK,QAAO,QAAQ,QAAQ,QAAQ,IAAI;AACpD,QAAO,QAAQ,QAAQ,OAAO,QAAQ,KAAK,EAAE;EAC3C,aAAa,sBAAsB;EACnC,iBAAiB,uBAAuB;EACzC,CAAC,CAAC,MAAM,WAAW,OAAO,IAAI"}
+{"version":3,"file":"types.mjs","names":[],"sources":["../../../src/core/commands/types.ts"],"sourcesContent":["/**\n * Command Factory Types\n *\n * Defines the interface for yargs CommandModule factories.\n */\n\nimport type { AFS } from \"@aigne/afs\";\nimport type { CommandModule } from \"yargs\";\nimport { loadAFS } from \"../../config/afs-loader.js\";\nimport { createCLIAuthContext } from \"../../credential/cli-auth-context.js\";\nimport { createCredentialStore } from \"../../credential/store.js\";\nimport type { ViewType } from \"../types.js\";\n\n/**\n * Format function type for command output\n *\n * Uses `any` for result type to allow different AFS result types\n * (AFSListResult, AFSReadResult, etc.) to be passed to the formatter.\n */\nexport type FormatFunction = (result: any, view: ViewType, options?: { path?: string }) => string;\n\n/**\n * Command output passed to executor via onResult callback\n */\nexport interface CommandOutput {\n  /** The command name (ls, read, write, etc.) */\n  command: string;\n  /** Raw result from AFS operation */\n  result: unknown;\n  /** Format function to convert result to string */\n  format: FormatFunction;\n  /** Override the view type (e.g. -l flag forces \"human\" view) */\n  viewOverride?: ViewType;\n  /** Error info if command failed (presence indicates failure) */\n  error?: {\n    /** Exit code (from ExitCode enum) */\n    code?: number;\n    /** Error message */\n    message: string;\n  };\n}\n\n/**\n * Options passed to command factory functions\n */\nexport interface CommandFactoryOptions {\n  /** AFS instance for executing operations (optional: injected in tests, lazy-loaded in production) */\n  afs?: AFS;\n  /** Original command line arguments (for pre-parsing in builder) */\n  argv: string[];\n  /** Callback to pass result back to executor */\n  onResult: (output: CommandOutput) => void;\n  /** Current working directory (for explore command) */\n  cwd?: string;\n}\n\n/**\n * Resolve AFS instance: use injected instance or lazy-load from config\n */\nexport function resolveAFS(options: CommandFactoryOptions): Promise<AFS> {\n  if (options.afs) return Promise.resolve(options.afs);\n  return loadAFS(options.cwd ?? process.cwd(), {\n    authContext: createCLIAuthContext(),\n    credentialStore: createCredentialStore(),\n  }).then((result) => result.afs);\n}\n\n/**\n * Command factory function type\n *\n * Uses `any` for CommandModule generics to allow different command\n * factories (with different argument types) to be stored in a common array.\n * Each individual factory uses strict types internally.\n */\nexport type CommandFactory = (options: CommandFactoryOptions) => CommandModule<unknown, any>;\n"],"mappings":";;;;;;;;AA2DA,SAAgB,WAAW,SAA8C;AACvE,KAAI,QAAQ,IAAK,QAAO,QAAQ,QAAQ,QAAQ,IAAI;AACpD,QAAO,QAAQ,QAAQ,OAAO,QAAQ,KAAK,EAAE;EAC3C,aAAa,sBAAsB;EACnC,iBAAiB,uBAAuB;EACzC,CAAC,CAAC,MAAM,WAAW,OAAO,IAAI"}