@aigne/afs-cli 1.11.0-beta.4 → 1.11.0-beta.6

package/README.md

@@ -59,10 +59,11 @@ access_mode = "readonly"
 path = "/db"
 uri = "sqlite:///path/to/app.db"
 
-# 远程 AFS 服务器
+# 远程 AFS 服务器 (带认证)
 [[mounts]]
 path = "/remote"
 uri = "https://afs.example.com/afs"
+token = "${AFS_TOKEN}"  # 使用环境变量
 
 # HTTP 服务器配置
 [serve]
@@ -72,8 +73,22 @@ path = "/afs"
 readonly = false
 cors = false
 max_body_size = 10485760  # 10MB
+token = "${AFS_SERVER_TOKEN}"  # 服务器认证 token
 ```
 
+### 挂载配置字段
+
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| `path` | 是 | 挂载路径 (如 `/src`) |
+| `uri` | 是 | Provider URI (如 `fs:///path`) |
+| `description` | 否 | 人类/LLM 可读描述 |
+| `access_mode` | 否 | 访问模式: `readonly` 或 `readwrite` |
+| `token` | 否 | HTTP Provider 认证 token (支持 `${ENV_VAR}`) |
+| `auth` | 否 | 认证字符串 (支持 `${ENV_VAR}`) |
+| `namespace` | 否 | 命名空间 (用于隔离不同环境) |
+| `options` | 否 | Provider 特定选项 |
+
 ## 命令
 
 ### 文件操作

package/dist/cli.cjs

@@ -122,13 +122,15 @@ async function main() {
 	}), async (argv) => {
 		const view = getViewType(argv);
 		await maybeShowHeader(view);
-		const result = await require_ls.lsCommand(await require_runtime.createRuntime(), argv.path, {
+		const runtime = await require_runtime.createRuntime();
+		const path = argv.path;
+		const result = await require_ls.lsCommand(runtime, path, {
 			maxDepth: argv.depth,
 			limit: argv.limit,
 			maxChildren: argv["max-children"],
 			pattern: argv.pattern
 		});
-		console.log(require_ls.formatLsOutput(result, view));
+		console.log(require_ls.formatLsOutput(result, view, { path }));
 	}).command("stat <path>", "Get file or directory info", (yargs$2) => yargs$2.positional("path", {
 		type: "string",
 		demandOption: true,
@@ -158,35 +160,45 @@ async function main() {
 		type: "boolean",
 		default: false,
 		description: "Append to file instead of overwrite"
+	}).option("set", {
+		type: "array",
+		string: true,
+		description: "Set metadata field (format: key=value), can be repeated"
 	}), async (argv) => {
 		const view = getViewType(argv);
 		await maybeShowHeader(view);
 		let content;
 		if (argv.content !== void 0) content = argv.content;
+		else if (argv.set && argv.set.length > 0) content = void 0;
 		else {
 			const chunks = [];
 			for await (const chunk of process.stdin) chunks.push(chunk);
 			content = Buffer.concat(chunks).toString("utf-8");
 		}
-		const result = await require_write.writeCommand(await require_runtime.createRuntime(), argv.path, content, { append: argv.append });
+		const result = await require_write.writeCommand(await require_runtime.createRuntime(), argv.path, content, {
+			append: argv.append,
+			set: argv.set
+		});
 		console.log(require_write.formatWriteOutput(result, view));
 		if (!result.success) process.exit(require_errors.ExitCode.RUNTIME_ERROR);
-	}).command("exec <path> [action]", "Execute operation on path", (yargs$2) => yargs$2.positional("path", {
+	}).command("exec <path>", "Execute an executable path (e.g., MCP tool)", (yargs$2) => yargs$2.positional("path", {
 		type: "string",
 		demandOption: true,
-		description: "Path to execute on"
-	}).positional("action", {
-		type: "string",
-		default: "default",
-		description: "Action to execute"
-	}).option("params", {
+		description: "Path to execute (must be executable)"
+	}).option("args", {
 		type: "string",
-		description: "JSON parameters for the action"
-	}), async (argv) => {
-		const view = getViewType(argv);
+		description: "JSON arguments: --args '{\"key\": \"value\"}'"
+	}).option("yaml", {
+		type: "boolean",
+		description: "Output in YAML format"
+	}).example("$0 exec /modules/mcp/tools/echo --message hello", "Execute with named param").example("$0 exec /modules/mcp/tools/query --args '{\"sql\": \"SELECT 1\"}'", "Execute with JSON args").strict(false), async (argv) => {
+		let view = "human";
+		if (argv.json) view = "json";
+		else if (argv.yaml) view = "yaml";
+		else if (argv.view) view = argv.view;
 		await maybeShowHeader(view);
-		const params = argv.params ? JSON.parse(argv.params) : {};
-		const result = await require_exec.execCommand(await require_runtime.createRuntime(), argv.path, argv.action, params);
+		const args = await require_exec.parseExecArgsWithStdin(argv);
+		const result = await require_exec.execCommand(await require_runtime.createRuntime(), argv.path, args);
 		console.log(require_exec.formatExecOutput(result, view));
 		if (!result.success) process.exit(require_errors.ExitCode.RUNTIME_ERROR);
 	}).command("mount", "Manage mount configurations", (yargs$2) => yargs$2.command(["list", "ls"], "List all mounts", () => {}, async (argv) => {
@@ -205,10 +217,16 @@ async function main() {
 	}).option("description", {
 		type: "string",
 		description: "Human-readable description for this mount"
+	}).option("token", {
+		type: "string",
+		description: "Bearer token for HTTP provider authorization"
 	}), async (argv) => {
 		const view = getViewType(argv);
 		await maybeShowHeader(view);
-		const result = await require_mount.mountAddCommand(process.cwd(), argv.path, argv.uri, { description: argv.description });
+		const result = await require_mount.mountAddCommand(process.cwd(), argv.path, argv.uri, {
+			description: argv.description,
+			token: argv.token
+		});
 		if (view === "json") console.log(JSON.stringify(result, null, 2));
 		else if (result.success) {
 			const msg = view === "human" ? `${require_index.colors.success("Added mount")} ${require_index.colors.cyan(result.normalizedPath)}` : `Added mount ${result.normalizedPath}`;
@@ -289,6 +307,9 @@ async function main() {
 	}).option("max-body", {
 		type: "number",
 		description: "Maximum request body size in bytes (default: 10MB)"
+	}).option("token", {
+		type: "string",
+		description: "Bearer token for authorization"
 	}), async (argv) => {
 		await maybeShowHeader(getViewType(argv));
 		const result = await require_serve.serveCommand({
@@ -297,7 +318,8 @@ async function main() {
 			path: argv.path,
 			readonly: argv.readonly,
 			cors: argv.cors,
-			maxBodySize: argv["max-body"]
+			maxBodySize: argv["max-body"],
+			token: argv.token
 		});
 		console.log(require_serve.formatServeOutput(result));
 		await new Promise(() => {});
@@ -325,9 +347,20 @@ async function main() {
 		throw error;
 	}
 }
-main().catch((error) => {
-	console.error("Fatal error:", error.message);
-	process.exit(require_errors.ExitCode.RUNTIME_ERROR);
+/**
+* Format error message for display
+*/
+function formatErrorForDisplay(error) {
+	const message = error.message;
+	const lines = message.split("\n");
+	if (lines.length > 1) return lines.map((line, i) => i === 0 ? `${require_index.colors.red("Error:")} ${line}` : `  ${line}`).join("\n");
+	return `${require_index.colors.red("Error:")} ${message}`;
+}
+main().then(() => {
+	process.exit(0);
+}).catch((error) => {
+	console.error(formatErrorForDisplay(error));
+	process.exit(error instanceof require_errors.CLIError ? error.exitCode : require_errors.ExitCode.RUNTIME_ERROR);
 });
 
 //#endregion

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { VERSION } from "./version.mjs";
-import { execCommand, formatExecOutput } from "./commands/exec.mjs";
+import { execCommand, formatExecOutput, parseExecArgsWithStdin } from "./commands/exec.mjs";
 import { ConfigLoader } from "./config/loader.mjs";
 import { colors, printHeader, shouldShowHeader } from "./ui/index.mjs";
 import { formatMountListOutput, mountAddCommand, mountListCommand, mountRemoveCommand, mountValidateCommand } from "./commands/mount.mjs";
@@ -120,13 +120,15 @@ async function main() {
 	}), async (argv) => {
 		const view = getViewType(argv);
 		await maybeShowHeader(view);
-		const result = await lsCommand(await createRuntime(), argv.path, {
+		const runtime = await createRuntime();
+		const path = argv.path;
+		const result = await lsCommand(runtime, path, {
 			maxDepth: argv.depth,
 			limit: argv.limit,
 			maxChildren: argv["max-children"],
 			pattern: argv.pattern
 		});
-		console.log(formatLsOutput(result, view));
+		console.log(formatLsOutput(result, view, { path }));
 	}).command("stat <path>", "Get file or directory info", (yargs$1) => yargs$1.positional("path", {
 		type: "string",
 		demandOption: true,
@@ -156,35 +158,45 @@ async function main() {
 		type: "boolean",
 		default: false,
 		description: "Append to file instead of overwrite"
+	}).option("set", {
+		type: "array",
+		string: true,
+		description: "Set metadata field (format: key=value), can be repeated"
 	}), async (argv) => {
 		const view = getViewType(argv);
 		await maybeShowHeader(view);
 		let content;
 		if (argv.content !== void 0) content = argv.content;
+		else if (argv.set && argv.set.length > 0) content = void 0;
 		else {
 			const chunks = [];
 			for await (const chunk of process.stdin) chunks.push(chunk);
 			content = Buffer.concat(chunks).toString("utf-8");
 		}
-		const result = await writeCommand(await createRuntime(), argv.path, content, { append: argv.append });
+		const result = await writeCommand(await createRuntime(), argv.path, content, {
+			append: argv.append,
+			set: argv.set
+		});
 		console.log(formatWriteOutput(result, view));
 		if (!result.success) process.exit(ExitCode.RUNTIME_ERROR);
-	}).command("exec <path> [action]", "Execute operation on path", (yargs$1) => yargs$1.positional("path", {
+	}).command("exec <path>", "Execute an executable path (e.g., MCP tool)", (yargs$1) => yargs$1.positional("path", {
 		type: "string",
 		demandOption: true,
-		description: "Path to execute on"
-	}).positional("action", {
-		type: "string",
-		default: "default",
-		description: "Action to execute"
-	}).option("params", {
+		description: "Path to execute (must be executable)"
+	}).option("args", {
 		type: "string",
-		description: "JSON parameters for the action"
-	}), async (argv) => {
-		const view = getViewType(argv);
+		description: "JSON arguments: --args '{\"key\": \"value\"}'"
+	}).option("yaml", {
+		type: "boolean",
+		description: "Output in YAML format"
+	}).example("$0 exec /modules/mcp/tools/echo --message hello", "Execute with named param").example("$0 exec /modules/mcp/tools/query --args '{\"sql\": \"SELECT 1\"}'", "Execute with JSON args").strict(false), async (argv) => {
+		let view = "human";
+		if (argv.json) view = "json";
+		else if (argv.yaml) view = "yaml";
+		else if (argv.view) view = argv.view;
 		await maybeShowHeader(view);
-		const params = argv.params ? JSON.parse(argv.params) : {};
-		const result = await execCommand(await createRuntime(), argv.path, argv.action, params);
+		const args = await parseExecArgsWithStdin(argv);
+		const result = await execCommand(await createRuntime(), argv.path, args);
 		console.log(formatExecOutput(result, view));
 		if (!result.success) process.exit(ExitCode.RUNTIME_ERROR);
 	}).command("mount", "Manage mount configurations", (yargs$1) => yargs$1.command(["list", "ls"], "List all mounts", () => {}, async (argv) => {
@@ -203,10 +215,16 @@ async function main() {
 	}).option("description", {
 		type: "string",
 		description: "Human-readable description for this mount"
+	}).option("token", {
+		type: "string",
+		description: "Bearer token for HTTP provider authorization"
 	}), async (argv) => {
 		const view = getViewType(argv);
 		await maybeShowHeader(view);
-		const result = await mountAddCommand(process.cwd(), argv.path, argv.uri, { description: argv.description });
+		const result = await mountAddCommand(process.cwd(), argv.path, argv.uri, {
+			description: argv.description,
+			token: argv.token
+		});
 		if (view === "json") console.log(JSON.stringify(result, null, 2));
 		else if (result.success) {
 			const msg = view === "human" ? `${colors.success("Added mount")} ${colors.cyan(result.normalizedPath)}` : `Added mount ${result.normalizedPath}`;
@@ -287,6 +305,9 @@ async function main() {
 	}).option("max-body", {
 		type: "number",
 		description: "Maximum request body size in bytes (default: 10MB)"
+	}).option("token", {
+		type: "string",
+		description: "Bearer token for authorization"
 	}), async (argv) => {
 		await maybeShowHeader(getViewType(argv));
 		const result = await serveCommand({
@@ -295,7 +316,8 @@ async function main() {
 			path: argv.path,
 			readonly: argv.readonly,
 			cors: argv.cors,
-			maxBodySize: argv["max-body"]
+			maxBodySize: argv["max-body"],
+			token: argv.token
 		});
 		console.log(formatServeOutput(result));
 		await new Promise(() => {});
@@ -323,9 +345,20 @@ async function main() {
 		throw error;
 	}
 }
-main().catch((error) => {
-	console.error("Fatal error:", error.message);
-	process.exit(ExitCode.RUNTIME_ERROR);
+/**
+* Format error message for display
+*/
+function formatErrorForDisplay(error) {
+	const message = error.message;
+	const lines = message.split("\n");
+	if (lines.length > 1) return lines.map((line, i) => i === 0 ? `${colors.red("Error:")} ${line}` : `  ${line}`).join("\n");
+	return `${colors.red("Error:")} ${message}`;
+}
+main().then(() => {
+	process.exit(0);
+}).catch((error) => {
+	console.error(formatErrorForDisplay(error));
+	process.exit(error instanceof CLIError ? error.exitCode : ExitCode.RUNTIME_ERROR);
 });
 
 //#endregion

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":["yargs"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * AFS CLI - Command Line Interface\n *\n * Commands:\n * - afs mount list|ls          List mount configurations\n * - afs mount add <path> <uri> Add a mount\n * - afs mount remove|rm <path> Remove a mount\n * - afs mount validate         Validate mount configuration\n * - afs list|ls [path]         List directory\n * - afs stat <path>            Get file/directory info\n * - afs read <path>            Read file content\n * - afs write <path>           Write file content (--content or stdin)\n * - afs exec <path> <action>   Execute operation\n * - afs serve                  Start HTTP server to expose AFS\n * - afs explore [path]         Interactive TUI file explorer\n *\n * Output modes (default: human):\n * - --view=human: Human friendly format with colors (default)\n * - --view=llm: LLM optimized output (token-efficient)\n * - --view=default: Machine truth (script/pipe friendly)\n * - --json: Structured JSON\n */\n\nimport yargs from \"yargs\";\nimport { hideBin } from \"yargs/helpers\";\nimport {\n  execCommand,\n  explainCommand,\n  explainPathCommand,\n  formatExecOutput,\n  formatExplainOutput,\n  formatLsOutput,\n  formatMountListOutput,\n  formatPathExplainOutput,\n  formatReadOutput,\n  formatServeOutput,\n  formatStatOutput,\n  formatWriteOutput,\n  lsCommand,\n  mountAddCommand,\n  mountListCommand,\n  mountRemoveCommand,\n  mountValidateCommand,\n  readCommand,\n  serveCommand,\n  statCommand,\n  type ViewType,\n  writeCommand,\n} from \"./commands/index.js\";\nimport { ConfigLoader } from \"./config/loader.js\";\nimport { CLIError, ExitCode } from \"./errors.js\";\nimport { createExplorerScreen } from \"./explorer/screen.js\";\nimport { createRuntime } from \"./runtime.js\";\nimport { colors, printHeader, shouldShowHeader } from \"./ui/index.js\";\nimport { VERSION } from \"./version.js\";\n\n// Global view type derived from args\n// Default is \"human\" for interactive use; LLMs can use --view=llm or --view=default\nfunction getViewType(argv: { json?: boolean; view?: string }): ViewType {\n  if (argv.json) return \"json\";\n  if (argv.view) return argv.view as ViewType;\n  return \"human\";\n}\n\n// Track if header has been shown (show only once per invocation)\nlet headerShown = false;\n\n/**\n * Show header if in human view mode and not already shown\n */\nasync function maybeShowHeader(view: ViewType): Promise<void> {\n  if (view !== \"human\" || headerShown || !shouldShowHeader()) {\n    return;\n  }\n\n  headerShown = true;\n\n  // Load mount count for header\n  try {\n    const configLoader = new ConfigLoader();\n    const config = await configLoader.load(process.cwd());\n    printHeader({\n      version: VERSION,\n      mountCount: config.mounts.length,\n    });\n  } catch {\n    // If config loading fails, just show header without mount count\n    printHeader({\n      version: VERSION,\n      mountCount: 0,\n    });\n  }\n}\n\n// Show header for help/version in interactive mode\nasync function showHeaderIfNeeded(): Promise<void> {\n  const args = process.argv.slice(2);\n  const isHelp =\n    args.length === 0 ||\n    args.includes(\"--help\") ||\n    args.includes(\"-h\") ||\n    (args.length === 1 && [\"help\", \"mount\", \"explain\"].includes(args[0]!));\n\n  if (isHelp && shouldShowHeader()) {\n    try {\n      const configLoader = new ConfigLoader();\n      const config = await configLoader.load(process.cwd());\n      printHeader({\n        version: VERSION,\n        mountCount: config.mounts.length,\n      });\n    } catch {\n      printHeader({\n        version: VERSION,\n        mountCount: 0,\n      });\n    }\n  }\n}\n\n// Run the CLI\nasync function main() {\n  await showHeaderIfNeeded();\n\n  const cli = yargs(hideBin(process.argv))\n    .scriptName(\"afs\")\n    .version(VERSION)\n    .alias(\"version\", \"V\")\n    .help(\"help\")\n    .alias(\"help\", \"h\")\n    .usage(\"$0 <command> [options]\")\n    .option(\"json\", {\n      type: \"boolean\",\n      description: \"Output in JSON format\",\n      global: true,\n    })\n    .option(\"view\", {\n      type: \"string\",\n      choices: [\"default\", \"llm\", \"human\"],\n      default: \"human\",\n      description: \"Output format (llm for AI agents, default for scripts)\",\n      global: true,\n    })\n    .command(\n      [\"list [path]\", \"ls [path]\"],\n      \"List directory contents\",\n      (yargs) =>\n        yargs\n          .positional(\"path\", {\n            type: \"string\",\n            default: \"/\",\n            description: \"Path to list\",\n          })\n          .option(\"depth\", {\n            type: \"number\",\n            default: 1,\n            description: \"Maximum depth to list\",\n          })\n          .option(\"limit\", {\n            alias: \"n\",\n            type: \"number\",\n            description: \"Maximum number of entries to return\",\n          })\n          .option(\"max-children\", {\n            type: \"number\",\n            description: \"Maximum children per directory\",\n          })\n          .option(\"pattern\", {\n            alias: \"p\",\n            type: \"string\",\n            description: \"Glob pattern to filter entries (e.g., *.ts, **/*.js)\",\n          }),\n      async (argv) => {\n        const view = getViewType(argv);\n        await maybeShowHeader(view);\n        const runtime = await createRuntime();\n        const result = await lsCommand(runtime, argv.path!, {\n          maxDepth: argv.depth,\n          limit: argv.limit,\n          maxChildren: argv[\"max-children\"],\n          pattern: argv.pattern,\n        });\n        console.log(formatLsOutput(result, view));\n      },\n    )\n    .command(\n      \"stat <path>\",\n      \"Get file or directory info\",\n      (yargs) =>\n        yargs.positional(\"path\", {\n          type: \"string\",\n          demandOption: true,\n          description: \"Path to stat\",\n        }),\n      async (argv) => {\n        const view = getViewType(argv);\n        await maybeShowHeader(view);\n        const runtime = await createRuntime();\n        const result = await statCommand(runtime, argv.path!);\n        console.log(formatStatOutput(result, view));\n      },\n    )\n    .command(\n      \"read <path>\",\n      \"Read file content\",\n      (yargs) =>\n        yargs.positional(\"path\", {\n          type: \"string\",\n          demandOption: true,\n          description: \"Path to read\",\n        }),\n      async (argv) => {\n        const view = getViewType(argv);\n        await maybeShowHeader(view);\n        const runtime = await createRuntime();\n        const result = await readCommand(runtime, argv.path!);\n        console.log(formatReadOutput(result, view));\n      },\n    )\n    .command(\n      \"write <path>\",\n      \"Write content to file (from --content or stdin)\",\n      (yargs) =>\n        yargs\n          .positional(\"path\", {\n            type: \"string\",\n            demandOption: true,\n            description: \"Path to write\",\n          })\n          .option(\"content\", {\n            type: \"string\",\n            description: \"Content to write (if not provided, reads from stdin)\",\n          })\n          .option(\"append\", {\n            type: \"boolean\",\n            default: false,\n            description: \"Append to file instead of overwrite\",\n          }),\n      async (argv) => {\n        const view = getViewType(argv);\n        await maybeShowHeader(view);\n\n        let content: string;\n\n        if (argv.content !== undefined) {\n          // Use --content parameter\n          content = argv.content;\n        } else {\n          // Read content from stdin\n          const chunks: Buffer[] = [];\n          for await (const chunk of process.stdin) {\n            chunks.push(chunk);\n          }\n          content = Buffer.concat(chunks).toString(\"utf-8\");\n        }\n\n        const runtime = await createRuntime();\n        const result = await writeCommand(runtime, argv.path!, content, {\n          append: argv.append,\n        });\n        console.log(formatWriteOutput(result, view));\n\n        if (!result.success) {\n          process.exit(ExitCode.RUNTIME_ERROR);\n        }\n      },\n    )\n    .command(\n      \"exec <path> [action]\",\n      \"Execute operation on path\",\n      (yargs) =>\n        yargs\n          .positional(\"path\", {\n            type: \"string\",\n            demandOption: true,\n            description: \"Path to execute on\",\n          })\n          .positional(\"action\", {\n            type: \"string\",\n            default: \"default\",\n            description: \"Action to execute\",\n          })\n          .option(\"params\", {\n            type: \"string\",\n            description: \"JSON parameters for the action\",\n          }),\n      async (argv) => {\n        const view = getViewType(argv);\n        await maybeShowHeader(view);\n\n        const params = argv.params ? JSON.parse(argv.params) : {};\n\n        const runtime = await createRuntime();\n        const result = await execCommand(runtime, argv.path!, argv.action!, params);\n        console.log(formatExecOutput(result, view));\n\n        if (!result.success) {\n          process.exit(ExitCode.RUNTIME_ERROR);\n        }\n      },\n    )\n    .command(\n      \"mount\",\n      \"Manage mount configurations\",\n      (yargs) =>\n        yargs\n          .command(\n            [\"list\", \"ls\"],\n            \"List all mounts\",\n            () => {},\n            async (argv) => {\n              const view = getViewType(argv);\n              await maybeShowHeader(view);\n              const result = await mountListCommand(process.cwd());\n              console.log(formatMountListOutput(result.mounts, view));\n            },\n          )\n          .command(\n            \"add <path> <uri>\",\n            \"Add a new mount (path=virtual path, uri=data source)\",\n            (yargs) =>\n              yargs\n                .positional(\"path\", {\n                  type: \"string\",\n                  demandOption: true,\n                  description: \"Virtual path in AFS namespace (e.g., /src, /data)\",\n                })\n                .positional(\"uri\", {\n                  type: \"string\",\n                  demandOption: true,\n                  description: \"Data source URI: fs:///local/path, git://repo, sqlite:///db.sqlite\",\n                })\n                .option(\"description\", {\n                  type: \"string\",\n                  description: \"Human-readable description for this mount\",\n                }),\n            async (argv) => {\n              const view = getViewType(argv);\n              await maybeShowHeader(view);\n\n              const result = await mountAddCommand(process.cwd(), argv.path!, argv.uri!, {\n                description: argv.description,\n              });\n\n              if (view === \"json\") {\n                console.log(JSON.stringify(result, null, 2));\n              } else {\n                if (result.success) {\n                  const msg =\n                    view === \"human\"\n                      ? `${colors.success(\"Added mount\")} ${colors.cyan(result.normalizedPath!)}`\n                      : `Added mount ${result.normalizedPath}`;\n                  console.log(msg);\n                } else {\n                  const msg = view === \"human\" ? colors.error(result.message!) : result.message;\n                  console.error(msg);\n                  process.exit(ExitCode.RUNTIME_ERROR);\n                }\n              }\n            },\n          )\n          .command(\n            [\"remove <path>\", \"rm <path>\"],\n            \"Remove a mount\",\n            (yargs) =>\n              yargs.positional(\"path\", {\n                type: \"string\",\n                demandOption: true,\n                description: \"Virtual path to remove (e.g., /src)\",\n              }),\n            async (argv) => {\n              const view = getViewType(argv);\n              await maybeShowHeader(view);\n\n              const result = await mountRemoveCommand(process.cwd(), argv.path!);\n\n              if (view === \"json\") {\n                console.log(JSON.stringify(result, null, 2));\n              } else {\n                if (result.success) {\n                  const msg =\n                    view === \"human\"\n                      ? `${colors.success(\"Removed mount\")} ${colors.cyan(argv.path!)}`\n                      : `Removed mount ${argv.path}`;\n                  console.log(msg);\n                } else {\n                  const msg = view === \"human\" ? colors.error(result.message!) : result.message;\n                  console.error(msg);\n                  process.exit(ExitCode.RUNTIME_ERROR);\n                }\n              }\n            },\n          )\n          .command(\n            \"validate\",\n            \"Validate mount configuration\",\n            () => {},\n            async (argv) => {\n              const view = getViewType(argv);\n              await maybeShowHeader(view);\n\n              const result = await mountValidateCommand(process.cwd());\n\n              if (view === \"json\") {\n                console.log(JSON.stringify(result, null, 2));\n              } else {\n                if (result.valid) {\n                  const msg =\n                    view === \"human\"\n                      ? colors.success(\"Configuration is valid\")\n                      : \"Configuration is valid\";\n                  console.log(msg);\n                } else {\n                  const titleMsg =\n                    view === \"human\"\n                      ? colors.error(\"Configuration has errors:\")\n                      : \"Configuration has errors:\";\n                  console.error(titleMsg);\n                  for (const error of result.errors) {\n                    const errMsg =\n                      view === \"human\"\n                        ? `  ${colors.dim(\"-\")} ${colors.error(error)}`\n                        : `  - ${error}`;\n                    console.error(errMsg);\n                  }\n                  process.exit(ExitCode.RUNTIME_ERROR);\n                }\n              }\n            },\n          )\n          .demandCommand(1, \"Please specify a mount subcommand\"),\n      () => {},\n    )\n    .command(\n      \"explain [topic]\",\n      \"Explain AFS concepts or AFS object\",\n      (yargs) =>\n        yargs.positional(\"topic\", {\n          type: \"string\",\n          description: \"Topic (mount, path, uri) or AFS path (e.g., /modules/src)\",\n        }),\n      async (argv) => {\n        const view = getViewType(argv);\n        await maybeShowHeader(view);\n        const topic = argv.topic;\n\n        // If topic starts with /, treat as object path\n        if (topic?.startsWith(\"/\")) {\n          const runtime = await createRuntime();\n          const result = await explainPathCommand(runtime, topic);\n          console.log(formatPathExplainOutput(result, view));\n        } else {\n          const result = await explainCommand(process.cwd(), topic);\n          console.log(formatExplainOutput(result, view));\n        }\n      },\n    )\n    .command(\n      \"serve\",\n      \"Start HTTP server to expose AFS providers\",\n      (yargs) =>\n        yargs\n          .option(\"host\", {\n            type: \"string\",\n            default: \"localhost\",\n            description: \"Host address to listen on\",\n          })\n          .option(\"port\", {\n            type: \"number\",\n            default: 3000,\n            description: \"Port to listen on\",\n          })\n          .option(\"path\", {\n            type: \"string\",\n            default: \"/afs\",\n            description: \"Base path for the server\",\n          })\n          .option(\"readonly\", {\n            type: \"boolean\",\n            default: false,\n            description: \"Run in readonly mode (disable write operations)\",\n          })\n          .option(\"cors\", {\n            type: \"boolean\",\n            default: false,\n            description: \"Enable CORS support\",\n          })\n          .option(\"max-body\", {\n            type: \"number\",\n            description: \"Maximum request body size in bytes (default: 10MB)\",\n          }),\n      async (argv) => {\n        const view = getViewType(argv);\n        await maybeShowHeader(view);\n\n        const result = await serveCommand({\n          host: argv.host,\n          port: argv.port,\n          path: argv.path,\n          readonly: argv.readonly,\n          cors: argv.cors,\n          maxBodySize: argv[\"max-body\"],\n        });\n\n        console.log(formatServeOutput(result));\n\n        // Keep the process running\n        await new Promise(() => {});\n      },\n    )\n    .command(\n      \"explore [path]\",\n      \"Interactive TUI file explorer (PC Tools style)\",\n      (yargs) =>\n        yargs.positional(\"path\", {\n          type: \"string\",\n          default: \"/\",\n          description: \"Starting path to explore\",\n        }),\n      async (argv) => {\n        const configLoader = new ConfigLoader();\n        const config = await configLoader.load(process.cwd());\n        const runtime = await createRuntime(process.cwd(), { configLoader });\n        await createExplorerScreen({\n          runtime,\n          startPath: argv.path,\n          version: VERSION,\n          mountCount: config.mounts.length,\n        });\n      },\n    )\n    .demandCommand(1, \"Please specify a command\")\n    .strict();\n\n  try {\n    await cli.parse();\n  } catch (error) {\n    if (error instanceof CLIError) {\n      console.error(error.message);\n      process.exit(error.exitCode);\n    }\n    throw error;\n  }\n}\n\nmain().catch((error) => {\n  console.error(\"Fatal error:\", error.message);\n  process.exit(ExitCode.RUNTIME_ERROR);\n});\n"],"mappings":"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"}
+{"version":3,"file":"cli.mjs","names":["yargs"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * AFS CLI - Command Line Interface\n *\n * Commands:\n * - afs mount list|ls          List mount configurations\n * - afs mount add <path> <uri> Add a mount\n * - afs mount remove|rm <path> Remove a mount\n * - afs mount validate         Validate mount configuration\n * - afs list|ls [path]         List directory\n * - afs stat <path>            Get file/directory info\n * - afs read <path>            Read file content\n * - afs write <path>           Write file content (--content or stdin)\n * - afs exec <path> <action>   Execute operation\n * - afs serve                  Start HTTP server to expose AFS\n * - afs explore [path]         Interactive TUI file explorer\n *\n * Output modes (default: human):\n * - --view=human: Human friendly format with colors (default)\n * - --view=llm: LLM optimized output (token-efficient)\n * - --view=default: Machine truth (script/pipe friendly)\n * - --json: Structured JSON\n */\n\nimport yargs from \"yargs\";\nimport { hideBin } from \"yargs/helpers\";\nimport {\n  type ExecViewType,\n  execCommand,\n  explainCommand,\n  explainPathCommand,\n  formatExecOutput,\n  formatExplainOutput,\n  formatLsOutput,\n  formatMountListOutput,\n  formatPathExplainOutput,\n  formatReadOutput,\n  formatServeOutput,\n  formatStatOutput,\n  formatWriteOutput,\n  lsCommand,\n  mountAddCommand,\n  mountListCommand,\n  mountRemoveCommand,\n  mountValidateCommand,\n  parseExecArgsWithStdin,\n  readCommand,\n  serveCommand,\n  statCommand,\n  type ViewType,\n  writeCommand,\n} from \"./commands/index.js\";\nimport { ConfigLoader } from \"./config/loader.js\";\nimport { CLIError, ExitCode } from \"./errors.js\";\nimport { createExplorerScreen } from \"./explorer/screen.js\";\nimport { createRuntime } from \"./runtime.js\";\nimport { colors, printHeader, shouldShowHeader } from \"./ui/index.js\";\nimport { VERSION } from \"./version.js\";\n\n// Global view type derived from args\n// Default is \"human\" for interactive use; LLMs can use --view=llm or --view=default\nfunction getViewType(argv: { json?: boolean; view?: string }): ViewType {\n  if (argv.json) return \"json\";\n  if (argv.view) return argv.view as ViewType;\n  return \"human\";\n}\n\n// Track if header has been shown (show only once per invocation)\nlet headerShown = false;\n\n/**\n * Show header if in human view mode and not already shown\n */\nasync function maybeShowHeader(view: ViewType): Promise<void> {\n  if (view !== \"human\" || headerShown || !shouldShowHeader()) {\n    return;\n  }\n\n  headerShown = true;\n\n  // Load mount count for header\n  try {\n    const configLoader = new ConfigLoader();\n    const config = await configLoader.load(process.cwd());\n    printHeader({\n      version: VERSION,\n      mountCount: config.mounts.length,\n    });\n  } catch {\n    // If config loading fails, just show header without mount count\n    printHeader({\n      version: VERSION,\n      mountCount: 0,\n    });\n  }\n}\n\n// Show header for help/version in interactive mode\nasync function showHeaderIfNeeded(): Promise<void> {\n  const args = process.argv.slice(2);\n  const isHelp =\n    args.length === 0 ||\n    args.includes(\"--help\") ||\n    args.includes(\"-h\") ||\n    (args.length === 1 && [\"help\", \"mount\", \"explain\"].includes(args[0]!));\n\n  if (isHelp && shouldShowHeader()) {\n    try {\n      const configLoader = new ConfigLoader();\n      const config = await configLoader.load(process.cwd());\n      printHeader({\n        version: VERSION,\n        mountCount: config.mounts.length,\n      });\n    } catch {\n      printHeader({\n        version: VERSION,\n        mountCount: 0,\n      });\n    }\n  }\n}\n\n// Run the CLI\nasync function main() {\n  await showHeaderIfNeeded();\n\n  const cli = yargs(hideBin(process.argv))\n    .scriptName(\"afs\")\n    .version(VERSION)\n    .alias(\"version\", \"V\")\n    .help(\"help\")\n    .alias(\"help\", \"h\")\n    .usage(\"$0 <command> [options]\")\n    .option(\"json\", {\n      type: \"boolean\",\n      description: \"Output in JSON format\",\n      global: true,\n    })\n    .option(\"view\", {\n      type: \"string\",\n      choices: [\"default\", \"llm\", \"human\"],\n      default: \"human\",\n      description: \"Output format (llm for AI agents, default for scripts)\",\n      global: true,\n    })\n    .command(\n      [\"list [path]\", \"ls [path]\"],\n      \"List directory contents\",\n      (yargs) =>\n        yargs\n          .positional(\"path\", {\n            type: \"string\",\n            default: \"/\",\n            description: \"Path to list\",\n          })\n          .option(\"depth\", {\n            type: \"number\",\n            default: 1,\n            description: \"Maximum depth to list\",\n          })\n          .option(\"limit\", {\n            alias: \"n\",\n            type: \"number\",\n            description: \"Maximum number of entries to return\",\n          })\n          .option(\"max-children\", {\n            type: \"number\",\n            description: \"Maximum children per directory\",\n          })\n          .option(\"pattern\", {\n            alias: \"p\",\n            type: \"string\",\n            description: \"Glob pattern to filter entries (e.g., *.ts, **/*.js)\",\n          }),\n      async (argv) => {\n        const view = getViewType(argv);\n        await maybeShowHeader(view);\n        const runtime = await createRuntime();\n        const path = argv.path!;\n        const result = await lsCommand(runtime, path, {\n          maxDepth: argv.depth,\n          limit: argv.limit,\n          maxChildren: argv[\"max-children\"],\n          pattern: argv.pattern,\n        });\n        console.log(formatLsOutput(result, view, { path }));\n      },\n    )\n    .command(\n      \"stat <path>\",\n      \"Get file or directory info\",\n      (yargs) =>\n        yargs.positional(\"path\", {\n          type: \"string\",\n          demandOption: true,\n          description: \"Path to stat\",\n        }),\n      async (argv) => {\n        const view = getViewType(argv);\n        await maybeShowHeader(view);\n        const runtime = await createRuntime();\n        const result = await statCommand(runtime, argv.path!);\n        console.log(formatStatOutput(result, view));\n      },\n    )\n    .command(\n      \"read <path>\",\n      \"Read file content\",\n      (yargs) =>\n        yargs.positional(\"path\", {\n          type: \"string\",\n          demandOption: true,\n          description: \"Path to read\",\n        }),\n      async (argv) => {\n        const view = getViewType(argv);\n        await maybeShowHeader(view);\n        const runtime = await createRuntime();\n        const result = await readCommand(runtime, argv.path!);\n        console.log(formatReadOutput(result, view));\n      },\n    )\n    .command(\n      \"write <path>\",\n      \"Write content to file (from --content or stdin)\",\n      (yargs) =>\n        yargs\n          .positional(\"path\", {\n            type: \"string\",\n            demandOption: true,\n            description: \"Path to write\",\n          })\n          .option(\"content\", {\n            type: \"string\",\n            description: \"Content to write (if not provided, reads from stdin)\",\n          })\n          .option(\"append\", {\n            type: \"boolean\",\n            default: false,\n            description: \"Append to file instead of overwrite\",\n          })\n          .option(\"set\", {\n            type: \"array\",\n            string: true,\n            description: \"Set metadata field (format: key=value), can be repeated\",\n          }),\n      async (argv) => {\n        const view = getViewType(argv);\n        await maybeShowHeader(view);\n\n        let content: string | undefined;\n\n        if (argv.content !== undefined) {\n          // Use --content parameter\n          content = argv.content;\n        } else if (argv.set && argv.set.length > 0) {\n          // If only --set is provided without content, content is optional\n          content = undefined;\n        } else {\n          // Read content from stdin\n          const chunks: Buffer[] = [];\n          for await (const chunk of process.stdin) {\n            chunks.push(chunk);\n          }\n          content = Buffer.concat(chunks).toString(\"utf-8\");\n        }\n\n        const runtime = await createRuntime();\n        const result = await writeCommand(runtime, argv.path!, content, {\n          append: argv.append,\n          set: argv.set as string[] | undefined,\n        });\n        console.log(formatWriteOutput(result, view));\n\n        if (!result.success) {\n          process.exit(ExitCode.RUNTIME_ERROR);\n        }\n      },\n    )\n    .command(\n      \"exec <path>\",\n      \"Execute an executable path (e.g., MCP tool)\",\n      (yargs) =>\n        yargs\n          .positional(\"path\", {\n            type: \"string\",\n            demandOption: true,\n            description: \"Path to execute (must be executable)\",\n          })\n          .option(\"args\", {\n            type: \"string\",\n            description: 'JSON arguments: --args \\'{\"key\": \"value\"}\\'',\n          })\n          .option(\"yaml\", {\n            type: \"boolean\",\n            description: \"Output in YAML format\",\n          })\n          .example(\"$0 exec /modules/mcp/tools/echo --message hello\", \"Execute with named param\")\n          .example(\n            '$0 exec /modules/mcp/tools/query --args \\'{\"sql\": \"SELECT 1\"}\\'',\n            \"Execute with JSON args\",\n          )\n          .strict(false), // Allow unknown options as exec arguments\n      async (argv) => {\n        // Determine output format\n        let view: ExecViewType = \"human\";\n        if (argv.json) view = \"json\";\n        else if (argv.yaml) view = \"yaml\";\n        else if (argv.view) view = argv.view as ExecViewType;\n\n        await maybeShowHeader(view as ViewType);\n\n        // Parse arguments from CLI options with stdin support\n        const args = await parseExecArgsWithStdin(argv as Record<string, unknown>);\n\n        const runtime = await createRuntime();\n        const result = await execCommand(runtime, argv.path!, args);\n        console.log(formatExecOutput(result, view));\n\n        if (!result.success) {\n          process.exit(ExitCode.RUNTIME_ERROR);\n        }\n      },\n    )\n    .command(\n      \"mount\",\n      \"Manage mount configurations\",\n      (yargs) =>\n        yargs\n          .command(\n            [\"list\", \"ls\"],\n            \"List all mounts\",\n            () => {},\n            async (argv) => {\n              const view = getViewType(argv);\n              await maybeShowHeader(view);\n              const result = await mountListCommand(process.cwd());\n              console.log(formatMountListOutput(result.mounts, view));\n            },\n          )\n          .command(\n            \"add <path> <uri>\",\n            \"Add a new mount (path=virtual path, uri=data source)\",\n            (yargs) =>\n              yargs\n                .positional(\"path\", {\n                  type: \"string\",\n                  demandOption: true,\n                  description: \"Virtual path in AFS namespace (e.g., /src, /data)\",\n                })\n                .positional(\"uri\", {\n                  type: \"string\",\n                  demandOption: true,\n                  description: \"Data source URI: fs:///local/path, git://repo, sqlite:///db.sqlite\",\n                })\n                .option(\"description\", {\n                  type: \"string\",\n                  description: \"Human-readable description for this mount\",\n                })\n                .option(\"token\", {\n                  type: \"string\",\n                  description: \"Bearer token for HTTP provider authorization\",\n                }),\n            async (argv) => {\n              const view = getViewType(argv);\n              await maybeShowHeader(view);\n\n              const result = await mountAddCommand(process.cwd(), argv.path!, argv.uri!, {\n                description: argv.description,\n                token: argv.token,\n              });\n\n              if (view === \"json\") {\n                console.log(JSON.stringify(result, null, 2));\n              } else {\n                if (result.success) {\n                  const msg =\n                    view === \"human\"\n                      ? `${colors.success(\"Added mount\")} ${colors.cyan(result.normalizedPath!)}`\n                      : `Added mount ${result.normalizedPath}`;\n                  console.log(msg);\n                } else {\n                  const msg = view === \"human\" ? colors.error(result.message!) : result.message;\n                  console.error(msg);\n                  process.exit(ExitCode.RUNTIME_ERROR);\n                }\n              }\n            },\n          )\n          .command(\n            [\"remove <path>\", \"rm <path>\"],\n            \"Remove a mount\",\n            (yargs) =>\n              yargs.positional(\"path\", {\n                type: \"string\",\n                demandOption: true,\n                description: \"Virtual path to remove (e.g., /src)\",\n              }),\n            async (argv) => {\n              const view = getViewType(argv);\n              await maybeShowHeader(view);\n\n              const result = await mountRemoveCommand(process.cwd(), argv.path!);\n\n              if (view === \"json\") {\n                console.log(JSON.stringify(result, null, 2));\n              } else {\n                if (result.success) {\n                  const msg =\n                    view === \"human\"\n                      ? `${colors.success(\"Removed mount\")} ${colors.cyan(argv.path!)}`\n                      : `Removed mount ${argv.path}`;\n                  console.log(msg);\n                } else {\n                  const msg = view === \"human\" ? colors.error(result.message!) : result.message;\n                  console.error(msg);\n                  process.exit(ExitCode.RUNTIME_ERROR);\n                }\n              }\n            },\n          )\n          .command(\n            \"validate\",\n            \"Validate mount configuration\",\n            () => {},\n            async (argv) => {\n              const view = getViewType(argv);\n              await maybeShowHeader(view);\n\n              const result = await mountValidateCommand(process.cwd());\n\n              if (view === \"json\") {\n                console.log(JSON.stringify(result, null, 2));\n              } else {\n                if (result.valid) {\n                  const msg =\n                    view === \"human\"\n                      ? colors.success(\"Configuration is valid\")\n                      : \"Configuration is valid\";\n                  console.log(msg);\n                } else {\n                  const titleMsg =\n                    view === \"human\"\n                      ? colors.error(\"Configuration has errors:\")\n                      : \"Configuration has errors:\";\n                  console.error(titleMsg);\n                  for (const error of result.errors) {\n                    const errMsg =\n                      view === \"human\"\n                        ? `  ${colors.dim(\"-\")} ${colors.error(error)}`\n                        : `  - ${error}`;\n                    console.error(errMsg);\n                  }\n                  process.exit(ExitCode.RUNTIME_ERROR);\n                }\n              }\n            },\n          )\n          .demandCommand(1, \"Please specify a mount subcommand\"),\n      () => {},\n    )\n    .command(\n      \"explain [topic]\",\n      \"Explain AFS concepts or AFS object\",\n      (yargs) =>\n        yargs.positional(\"topic\", {\n          type: \"string\",\n          description: \"Topic (mount, path, uri) or AFS path (e.g., /modules/src)\",\n        }),\n      async (argv) => {\n        const view = getViewType(argv);\n        await maybeShowHeader(view);\n        const topic = argv.topic;\n\n        // If topic starts with /, treat as object path\n        if (topic?.startsWith(\"/\")) {\n          const runtime = await createRuntime();\n          const result = await explainPathCommand(runtime, topic);\n          console.log(formatPathExplainOutput(result, view));\n        } else {\n          const result = await explainCommand(process.cwd(), topic);\n          console.log(formatExplainOutput(result, view));\n        }\n      },\n    )\n    .command(\n      \"serve\",\n      \"Start HTTP server to expose AFS providers\",\n      (yargs) =>\n        yargs\n          .option(\"host\", {\n            type: \"string\",\n            default: \"localhost\",\n            description: \"Host address to listen on\",\n          })\n          .option(\"port\", {\n            type: \"number\",\n            default: 3000,\n            description: \"Port to listen on\",\n          })\n          .option(\"path\", {\n            type: \"string\",\n            default: \"/afs\",\n            description: \"Base path for the server\",\n          })\n          .option(\"readonly\", {\n            type: \"boolean\",\n            default: false,\n            description: \"Run in readonly mode (disable write operations)\",\n          })\n          .option(\"cors\", {\n            type: \"boolean\",\n            default: false,\n            description: \"Enable CORS support\",\n          })\n          .option(\"max-body\", {\n            type: \"number\",\n            description: \"Maximum request body size in bytes (default: 10MB)\",\n          })\n          .option(\"token\", {\n            type: \"string\",\n            description: \"Bearer token for authorization\",\n          }),\n      async (argv) => {\n        const view = getViewType(argv);\n        await maybeShowHeader(view);\n\n        const result = await serveCommand({\n          host: argv.host,\n          port: argv.port,\n          path: argv.path,\n          readonly: argv.readonly,\n          cors: argv.cors,\n          maxBodySize: argv[\"max-body\"],\n          token: argv.token,\n        });\n\n        console.log(formatServeOutput(result));\n\n        // Keep the process running\n        await new Promise(() => {});\n      },\n    )\n    .command(\n      \"explore [path]\",\n      \"Interactive TUI file explorer (PC Tools style)\",\n      (yargs) =>\n        yargs.positional(\"path\", {\n          type: \"string\",\n          default: \"/\",\n          description: \"Starting path to explore\",\n        }),\n      async (argv) => {\n        const configLoader = new ConfigLoader();\n        const config = await configLoader.load(process.cwd());\n        const runtime = await createRuntime(process.cwd(), { configLoader });\n        await createExplorerScreen({\n          runtime,\n          startPath: argv.path,\n          version: VERSION,\n          mountCount: config.mounts.length,\n        });\n      },\n    )\n    .demandCommand(1, \"Please specify a command\")\n    .strict();\n\n  try {\n    await cli.parse();\n  } catch (error) {\n    if (error instanceof CLIError) {\n      console.error(error.message);\n      process.exit(error.exitCode);\n    }\n    throw error;\n  }\n}\n\n/**\n * Format error message for display\n */\nfunction formatErrorForDisplay(error: Error): string {\n  const message = error.message;\n\n  // Format multi-line messages with proper indentation\n  const lines = message.split(\"\\n\");\n  if (lines.length > 1) {\n    return lines\n      .map((line, i) => (i === 0 ? `${colors.red(\"Error:\")} ${line}` : `  ${line}`))\n      .join(\"\\n\");\n  }\n\n  return `${colors.red(\"Error:\")} ${message}`;\n}\n\nmain()\n  .then(() => {\n    // Force exit after command completes to ensure child processes (like MCP stdio)\n    // don't keep the process alive. Long-running commands (serve, explore) handle\n    // their own lifecycle and never reach here.\n    process.exit(0);\n  })\n  .catch((error) => {\n    console.error(formatErrorForDisplay(error));\n    process.exit(error instanceof CLIError ? error.exitCode : ExitCode.RUNTIME_ERROR);\n  });\n"],"mappings":"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"}

package/dist/commands/exec.cjs

@@ -1,17 +1,110 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let yaml = require("yaml");
+yaml = require_rolldown_runtime.__toESM(yaml);
 
 //#region src/commands/exec.ts
 /**
+* Reserved CLI option names that should not be passed as exec arguments
+*/
+const RESERVED_OPTIONS = new Set([
+	"json",
+	"yaml",
+	"view",
+	"help",
+	"h",
+	"version",
+	"V",
+	"_",
+	"$0",
+	"args"
+]);
+/**
+* Read JSON from stdin (non-blocking if TTY)
+*/
+async function readStdin() {
+	if (process.stdin.isTTY) return null;
+	const chunks = [];
+	for await (const chunk of process.stdin) chunks.push(chunk);
+	return Buffer.concat(chunks).toString("utf-8").trim() || null;
+}
+/**
+* Parse exec arguments with stdin support (async version)
+*
+* Priority: CLI flags > stdin > --args
+*/
+async function parseExecArgsWithStdin(options) {
+	let result = {};
+	if (options.args && typeof options.args === "string") try {
+		const parsed = JSON.parse(options.args);
+		if (typeof parsed === "object" && parsed !== null) result = { ...parsed };
+	} catch (e) {
+		throw new Error(`Invalid JSON in --args: ${e.message}`);
+	}
+	const stdinContent = await readStdin();
+	if (stdinContent) try {
+		const parsed = JSON.parse(stdinContent);
+		if (typeof parsed === "object" && parsed !== null) result = {
+			...result,
+			...parsed
+		};
+	} catch (e) {
+		throw new Error(`Invalid JSON in stdin: ${e.message}`);
+	}
+	for (const [key, value] of Object.entries(options)) {
+		if (RESERVED_OPTIONS.has(key) || value === void 0 || value === null) continue;
+		result[key] = value;
+	}
+	return result;
+}
+/**
+* Check if an entry is executable based on its metadata
+*
+* An entry is executable if:
+* 1. Its `kinds` array includes "afs:executable", OR
+* 2. Its `kind` field equals "afs:executable" (legacy support)
+*/
+function isExecutable(metadata) {
+	if (!metadata) return false;
+	if (Array.isArray(metadata.kinds)) return metadata.kinds.includes("afs:executable");
+	return metadata.kind === "afs:executable";
+}
+/**
 * Execute an action on an AFS path
 *
-* Note: exec is not widely implemented by providers yet.
-* This is a placeholder for future functionality.
+* This function directly executes the path without pre-checking if it's executable.
+* The provider will return an appropriate error if the path is not executable.
+*
+* @param runtime - AFS runtime
+* @param path - Path to execute
+* @param args - Arguments to pass to the executable
+* @returns Exec result
+*/
+async function execCommand(runtime, path, args = {}) {
+	try {
+		const execResult = await runtime.exec(path, args);
+		return {
+			path,
+			success: execResult.success,
+			data: execResult.data,
+			message: execResult.error?.message,
+			error: execResult.error
+		};
+	} catch (error) {
+		const errorCode = extractErrorCode(error);
+		return {
+			path,
+			success: false,
+			message: error instanceof Error ? error.message : String(error),
+			error: errorCode ? { code: errorCode } : void 0
+		};
+	}
+}
+/**
+* Extract error code from an error object
 */
-async function execCommand(_runtime, path, _action, _params = {}) {
-	return {
-		path,
-		success: false,
-		message: "exec operation is not yet implemented"
-	};
+function extractErrorCode(error) {
+	if (!error || typeof error !== "object") return void 0;
+	if ("code" in error && typeof error.code === "string") return error.code;
 }
 /**
 * Format exec output for different views
@@ -19,28 +112,53 @@ async function execCommand(_runtime, path, _action, _params = {}) {
 function formatExecOutput(result, view) {
 	switch (view) {
 		case "json": return JSON.stringify(result, null, 2);
+		case "yaml": return yaml.default.stringify(result);
 		case "llm": return formatLlm(result);
 		case "human": return formatHuman(result);
 		default: return formatDefault(result);
 	}
 }
 function formatDefault(result) {
-	if (result.success) return `OK ${result.path}`;
-	return `ERROR ${result.path} ${result.message}`;
+	if (result.success) {
+		if (result.data) return JSON.stringify(result.data);
+		return `OK ${result.path}`;
+	}
+	return `${result.error?.code || "ERROR"} ${result.path} ${result.message || ""}`.trim();
 }
 function formatLlm(result) {
 	const lines = [];
 	lines.push(`EXEC ${result.path}`);
 	lines.push(`STATUS ${result.success ? "SUCCESS" : "FAILED"}`);
 	if (result.data) lines.push(`DATA ${JSON.stringify(result.data)}`);
-	if (result.message) lines.push(`MESSAGE ${result.message}`);
+	if (!result.success && result.error) {
+		if (result.error.code) lines.push(`ERROR ${result.error.code}`);
+		if (result.message) lines.push(`MESSAGE ${result.message}`);
+		if (result.error.details) lines.push(`DETAILS ${JSON.stringify(result.error.details)}`);
+	} else if (result.message) lines.push(`MESSAGE ${result.message}`);
 	return lines.join("\n");
 }
 function formatHuman(result) {
-	if (result.success) return `Executed on ${result.path}\n${result.data ? JSON.stringify(result.data, null, 2) : ""}`;
-	return `Failed to execute on ${result.path}: ${result.message}`;
+	if (result.success) {
+		const lines$1 = [`✓ Executed: ${result.path}`];
+		if (result.data) {
+			lines$1.push("");
+			lines$1.push(JSON.stringify(result.data, null, 2));
+		}
+		return lines$1.join("\n");
+	}
+	const lines = [`✗ Failed: ${result.path}`];
+	lines.push("");
+	if (result.error?.code) lines.push(`Error: ${result.error.code}`);
+	if (result.message) lines.push(`Message: ${result.message}`);
+	if (result.error?.details) {
+		lines.push("Details:");
+		for (const [key, value] of Object.entries(result.error.details)) lines.push(`  ${key}: ${JSON.stringify(value)}`);
+	}
+	return lines.join("\n");
 }
 
 //#endregion
 exports.execCommand = execCommand;
-exports.formatExecOutput = formatExecOutput;
+exports.formatExecOutput = formatExecOutput;
+exports.isExecutable = isExecutable;
+exports.parseExecArgsWithStdin = parseExecArgsWithStdin;