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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/afs-cli",
-  "version": "1.11.0-beta.6",
+  "version": "1.11.0-beta.7",
   "description": "AFS Command Line Interface",
   "license": "UNLICENSED",
   "publishConfig": {
@@ -31,6 +31,10 @@
       "require": "./dist/cli.cjs",
       "import": "./dist/cli.mjs"
     },
+    "./core": {
+      "require": "./dist/core/index.cjs",
+      "import": "./dist/core/index.mjs"
+    },
     "./*": "./*"
   },
   "files": [
@@ -40,31 +44,40 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
     "blessed": "^0.1.81",
     "smol-toml": "^1.3.1",
+    "ufo": "^1.6.3",
+    "urlpattern-polyfill": "^10.1.0",
     "yaml": "^2.8.2",
     "yargs": "^17.7.2",
+    "yargs-parser": "^22.0.0",
     "zod": "^3.24.1",
-    "@aigne/afs": "1.11.0-beta.6",
-    "@aigne/afs-fs": "1.11.0-beta.6",
-    "@aigne/afs-git": "1.11.0-beta.6",
-    "@aigne/afs-github": "1.11.0-beta.6",
-    "@aigne/afs-http": "1.11.0-beta.6",
-    "@aigne/afs-json": "1.11.0-beta.6",
-    "@aigne/afs-toml": "1.11.0-beta.6",
-    "@aigne/afs-s3": "1.11.0-beta.6",
-    "@aigne/afs-gcs": "1.11.0-beta.6",
-    "@aigne/afs-ec2": "1.11.0-beta.6",
-    "@aigne/afs-gce": "1.11.0-beta.6",
-    "@aigne/afs-dns": "1.11.0-beta.6",
-    "@aigne/afs-mcp": "1.11.0-beta.6",
-    "@aigne/afs-sqlite": "1.11.0-beta.6",
-    "@aigne/afs-sandbox": "1.11.0-beta.6"
+    "@aigne/afs-dns": "1.11.0-beta.7",
+    "@aigne/afs-ec2": "1.11.0-beta.7",
+    "@aigne/afs": "1.11.0-beta.7",
+    "@aigne/afs-fs": "1.11.0-beta.7",
+    "@aigne/afs-gce": "1.11.0-beta.7",
+    "@aigne/afs-gcs": "1.11.0-beta.7",
+    "@aigne/afs-git": "1.11.0-beta.7",
+    "@aigne/afs-github": "1.11.0-beta.7",
+    "@aigne/afs-http": "1.11.0-beta.7",
+    "@aigne/afs-json": "1.11.0-beta.7",
+    "@aigne/afs-mcp": "1.11.0-beta.7",
+    "@aigne/afs-provider-registry": "1.11.0-beta.7",
+    "@aigne/afs-registry": "1.11.0-beta.7",
+    "@aigne/afs-s3": "1.11.0-beta.7",
+    "@aigne/afs-sandbox": "1.11.0-beta.7",
+    "@aigne/afs-sqlite": "1.11.0-beta.7",
+    "@aigne/afs-toml": "1.11.0-beta.7",
+    "@aigne/afs-workspace": "1.11.0-beta.7"
   },
   "devDependencies": {
+    "@modelcontextprotocol/server-everything": "^2026.1.26",
     "@types/blessed": "^0.1.25",
     "@types/bun": "^1.3.6",
     "@types/yargs": "^17.0.33",
+    "@types/yargs-parser": "^21.0.3",
     "npm-run-all": "^4.1.5",
     "rimraf": "^6.1.2",
     "tsdown": "0.20.0-beta.3",

package/dist/commands/exec.cjs

@@ -1,164 +0,0 @@
-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
-*
-* 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
-*/
-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
-*/
-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) {
-		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.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) {
-		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.isExecutable = isExecutable;
-exports.parseExecArgsWithStdin = parseExecArgsWithStdin;

package/dist/commands/exec.mjs

@@ -1,160 +0,0 @@
-import YAML from "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
-*
-* 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
-*/
-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
-*/
-function formatExecOutput(result, view) {
-	switch (view) {
-		case "json": return JSON.stringify(result, null, 2);
-		case "yaml": return YAML.stringify(result);
-		case "llm": return formatLlm(result);
-		case "human": return formatHuman(result);
-		default: return formatDefault(result);
-	}
-}
-function formatDefault(result) {
-	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.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) {
-		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
-export { execCommand, formatExecOutput, isExecutable, parseExecArgsWithStdin };
-//# sourceMappingURL=exec.mjs.map

package/dist/commands/exec.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"exec.mjs","names":["lines"],"sources":["../../src/commands/exec.ts"],"sourcesContent":["import type { AFSEntryMetadata } from \"@aigne/afs\";\nimport YAML from \"yaml\";\nimport type { AFSRuntime } from \"../runtime.js\";\nimport type { ViewType } from \"./ls.js\";\n\n/**\n * Extended view type that includes yaml\n */\nexport type ExecViewType = ViewType | \"yaml\";\n\nexport interface ExecResult {\n  path: string;\n  success: boolean;\n  data?: Record<string, unknown>;\n  message?: string;\n  error?: {\n    code?: string;\n    message?: string;\n    details?: Record<string, unknown>;\n  };\n}\n\n/**\n * Reserved CLI option names that should not be passed as exec arguments\n */\nconst RESERVED_OPTIONS = new Set([\n  \"json\",\n  \"yaml\",\n  \"view\",\n  \"help\",\n  \"h\",\n  \"version\",\n  \"V\",\n  \"_\", // yargs positional args array\n  \"$0\", // yargs script name\n  \"args\", // our --args option (processed separately)\n]);\n\n/**\n * Read JSON from stdin (non-blocking if TTY)\n */\nasync function readStdin(): Promise<string | null> {\n  // Only read from stdin if it's not a TTY (i.e., there's pipe input)\n  if (process.stdin.isTTY) {\n    return null;\n  }\n\n  const chunks: Buffer[] = [];\n  for await (const chunk of process.stdin) {\n    chunks.push(chunk as Buffer);\n  }\n  const content = Buffer.concat(chunks).toString(\"utf-8\").trim();\n  return content || null;\n}\n\n/**\n * Parse exec arguments from CLI options with stdin support\n *\n * Priority: CLI flags > stdin > --args\n *\n * Supports three input sources:\n * 1. JSON via --args: `afs exec /path --args '{\"key\": \"value\"}'`\n * 2. JSON via stdin: `echo '{\"key\": \"value\"}' | afs exec /path`\n * 3. Named parameters: `afs exec /path --sql \"SELECT * FROM users\" --limit 10`\n */\nexport function parseExecArgs(options: Record<string, unknown>): Record<string, unknown> {\n  let result: Record<string, unknown> = {};\n\n  // Parse --args JSON if provided (lowest priority)\n  if (options.args && typeof options.args === \"string\") {\n    try {\n      const parsed = JSON.parse(options.args);\n      if (typeof parsed === \"object\" && parsed !== null) {\n        result = { ...parsed };\n      }\n    } catch (e) {\n      throw new Error(`Invalid JSON in --args: ${(e as Error).message}`);\n    }\n  }\n\n  // Add named parameters (overwrite JSON args if same key) - highest priority\n  for (const [key, value] of Object.entries(options)) {\n    // Skip reserved options and undefined/null values\n    if (RESERVED_OPTIONS.has(key) || value === undefined || value === null) {\n      continue;\n    }\n    result[key] = value;\n  }\n\n  return result;\n}\n\n/**\n * Parse exec arguments with stdin support (async version)\n *\n * Priority: CLI flags > stdin > --args\n */\nexport async function parseExecArgsWithStdin(\n  options: Record<string, unknown>,\n): Promise<Record<string, unknown>> {\n  let result: Record<string, unknown> = {};\n\n  // 1. Parse --args JSON if provided (lowest priority)\n  if (options.args && typeof options.args === \"string\") {\n    try {\n      const parsed = JSON.parse(options.args);\n      if (typeof parsed === \"object\" && parsed !== null) {\n        result = { ...parsed };\n      }\n    } catch (e) {\n      throw new Error(`Invalid JSON in --args: ${(e as Error).message}`);\n    }\n  }\n\n  // 2. Read from stdin if available (medium priority)\n  const stdinContent = await readStdin();\n  if (stdinContent) {\n    try {\n      const parsed = JSON.parse(stdinContent);\n      if (typeof parsed === \"object\" && parsed !== null) {\n        result = { ...result, ...parsed };\n      }\n    } catch (e) {\n      throw new Error(`Invalid JSON in stdin: ${(e as Error).message}`);\n    }\n  }\n\n  // 3. Add named CLI parameters (highest priority)\n  for (const [key, value] of Object.entries(options)) {\n    if (RESERVED_OPTIONS.has(key) || value === undefined || value === null) {\n      continue;\n    }\n    result[key] = value;\n  }\n\n  return result;\n}\n\n/**\n * Check if an entry is executable based on its metadata\n *\n * An entry is executable if:\n * 1. Its `kinds` array includes \"afs:executable\", OR\n * 2. Its `kind` field equals \"afs:executable\" (legacy support)\n */\nexport function isExecutable(metadata: AFSEntryMetadata | null | undefined): boolean {\n  if (!metadata) return false;\n\n  // Check kinds array first (new way)\n  if (Array.isArray(metadata.kinds)) {\n    return metadata.kinds.includes(\"afs:executable\");\n  }\n\n  // Fall back to kind field (legacy)\n  return metadata.kind === \"afs:executable\";\n}\n\n/**\n * Execute an action on an AFS path\n *\n * This function directly executes the path without pre-checking if it's executable.\n * The provider will return an appropriate error if the path is not executable.\n *\n * @param runtime - AFS runtime\n * @param path - Path to execute\n * @param args - Arguments to pass to the executable\n * @returns Exec result\n */\nexport async function execCommand(\n  runtime: AFSRuntime,\n  path: string,\n  args: Record<string, unknown> = {},\n): Promise<ExecResult> {\n  try {\n    // Execute directly - let provider handle validation\n    const execResult = await runtime.exec(path, args);\n\n    return {\n      path,\n      success: execResult.success,\n      data: execResult.data,\n      message: execResult.error?.message,\n      error: execResult.error,\n    };\n  } catch (error) {\n    // Extract error code if available\n    const errorCode = extractErrorCode(error);\n\n    return {\n      path,\n      success: false,\n      message: error instanceof Error ? error.message : String(error),\n      error: errorCode ? { code: errorCode } : undefined,\n    };\n  }\n}\n\n/**\n * Extract error code from an error object\n */\nfunction extractErrorCode(error: unknown): string | undefined {\n  if (!error || typeof error !== \"object\") return undefined;\n  if (\"code\" in error && typeof (error as { code: unknown }).code === \"string\") {\n    return (error as { code: string }).code;\n  }\n  return undefined;\n}\n\n/**\n * Format exec output for different views\n */\nexport function formatExecOutput(result: ExecResult, view: ExecViewType): string {\n  switch (view) {\n    case \"json\":\n      return JSON.stringify(result, null, 2);\n    case \"yaml\":\n      return YAML.stringify(result);\n    case \"llm\":\n      return formatLlm(result);\n    case \"human\":\n      return formatHuman(result);\n    default:\n      return formatDefault(result);\n  }\n}\n\nfunction formatDefault(result: ExecResult): string {\n  if (result.success) {\n    if (result.data) {\n      return JSON.stringify(result.data);\n    }\n    return `OK ${result.path}`;\n  }\n  const errorCode = result.error?.code || \"ERROR\";\n  return `${errorCode} ${result.path} ${result.message || \"\"}`.trim();\n}\n\nfunction formatLlm(result: ExecResult): string {\n  const lines: string[] = [];\n\n  lines.push(`EXEC ${result.path}`);\n  lines.push(`STATUS ${result.success ? \"SUCCESS\" : \"FAILED\"}`);\n\n  if (result.data) {\n    lines.push(`DATA ${JSON.stringify(result.data)}`);\n  }\n\n  if (!result.success && result.error) {\n    if (result.error.code) {\n      lines.push(`ERROR ${result.error.code}`);\n    }\n    if (result.message) {\n      lines.push(`MESSAGE ${result.message}`);\n    }\n    if (result.error.details) {\n      lines.push(`DETAILS ${JSON.stringify(result.error.details)}`);\n    }\n  } else if (result.message) {\n    lines.push(`MESSAGE ${result.message}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction formatHuman(result: ExecResult): string {\n  if (result.success) {\n    const lines = [`✓ Executed: ${result.path}`];\n    if (result.data) {\n      lines.push(\"\");\n      lines.push(JSON.stringify(result.data, null, 2));\n    }\n    return lines.join(\"\\n\");\n  }\n\n  const lines = [`✗ Failed: ${result.path}`];\n  lines.push(\"\");\n  if (result.error?.code) {\n    lines.push(`Error: ${result.error.code}`);\n  }\n  if (result.message) {\n    lines.push(`Message: ${result.message}`);\n  }\n  if (result.error?.details) {\n    lines.push(\"Details:\");\n    for (const [key, value] of Object.entries(result.error.details)) {\n      lines.push(`  ${key}: ${JSON.stringify(value)}`);\n    }\n  }\n  return lines.join(\"\\n\");\n}\n"],"mappings":"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"}

package/dist/commands/explain.cjs

@@ -1,244 +0,0 @@
-const require_mount = require('./mount.cjs');
-
-//#region src/commands/explain.ts
-/**
-* Explain AFS concepts or current configuration
-*/
-async function explainCommand(cwd, topic) {
-	switch (topic) {
-		case "mount":
-		case "mounts": return explainMounts(cwd);
-		case "path":
-		case "paths": return explainPaths();
-		case "uri": return explainUri();
-		default: return explainOverview();
-	}
-}
-/**
-* Explain an AFS object at a given path
-*/
-async function explainPathCommand(runtime, path) {
-	const entry = (await runtime.read(path)).data;
-	if (!entry) return {
-		path,
-		type: "unknown"
-	};
-	const metadata = entry.metadata || {};
-	const entryType = metadata.kind === "afs:executable" ? "exec" : typeof metadata.childrenCount === "number" ? "directory" : "file";
-	const result = {
-		path: entry.path,
-		type: entryType,
-		description: metadata.description,
-		metadata: {}
-	};
-	if (metadata.provider) result.metadata.provider = String(metadata.provider);
-	if (metadata.permissions) {
-		const perms = metadata.permissions;
-		result.metadata.permissions = Array.isArray(perms) ? perms.join(", ") : String(perms);
-	}
-	if (entryType === "exec") {
-		if (metadata.inputs) result.inputs = Array.isArray(metadata.inputs) ? metadata.inputs : [String(metadata.inputs)];
-		if (metadata.outputs) result.outputs = Array.isArray(metadata.outputs) ? metadata.outputs : [String(metadata.outputs)];
-		if (metadata.errors) result.errors = Array.isArray(metadata.errors) ? metadata.errors : [String(metadata.errors)];
-		if (metadata.sideEffects) result.sideEffects = Array.isArray(metadata.sideEffects) ? metadata.sideEffects : [String(metadata.sideEffects)];
-	}
-	if (Object.keys(result.metadata).length === 0) delete result.metadata;
-	return result;
-}
-function explainOverview() {
-	return {
-		topic: "AFS Overview",
-		explanation: `AFS (Abstract File System) is a virtual filesystem that unifies different data sources into a single namespace.
-
-Core Concepts:
-- mount: Mount a data source to a virtual path
-- path: Virtual path, e.g., /src, /data
-- uri: Data source address, e.g., fs://, git://, sqlite://
-
-Data Flow:
-  User Path -> AFS -> /modules/{name} -> Provider -> Actual Data`,
-		examples: [
-			"afs mount add /src fs:///path/to/source",
-			"afs ls /modules/src",
-			"afs read /modules/src/file.txt"
-		]
-	};
-}
-async function explainMounts(cwd) {
-	const result = await require_mount.mountListCommand(cwd);
-	if (result.mounts.length === 0) return {
-		topic: "Mounts",
-		explanation: `No mounts configured.
-
-Use mount add to add a mount:
-  afs mount add <path> <uri>
-
-path: Virtual path for accessing data in AFS
-uri: Data source URI specifying the data origin`,
-		examples: ["afs mount add /src fs:///Users/me/project", "afs mount add /data sqlite:///data.db"]
-	};
-	return {
-		topic: "Mounts",
-		explanation: `Current mount configuration:
-
-${result.mounts.map((m) => `  ${m.path} → ${m.uri}${m.description ? ` (${m.description})` : ""}`).join("\n")}
-
-After mounting, data is accessed via /modules/{name}:
-  path="/src" -> /modules/src`,
-		examples: result.mounts.map((m) => {
-			return `afs ls /modules/${m.path.slice(1).replace(/\//g, "-") || "root"}`;
-		})
-	};
-}
-function explainPaths() {
-	return {
-		topic: "Paths",
-		explanation: `AFS Path Structure:
-
-/                     Root directory
-/modules              All mounted modules
-/modules/{name}       Specific module, name derived from mount path
-
-Path Mapping:
-  config: path="/src"  ->  access: /modules/src
-  config: path="/data" ->  access: /modules/data
-
-Note: The path configured by user is transformed to /modules/{name}`
-	};
-}
-function explainUri() {
-	return {
-		topic: "URI",
-		explanation: `AFS URI Schemes and Objects:
-
-fs://       Local Filesystem Provider
-  Format: fs:///absolute/path or fs://./relative/path
-  Objects:
-    - directory: folder entries, supports list
-    - file: file entries, supports read/write
-  Operations: list, read, write, delete
-
-git://      Git Repository Provider
-  Format: git:///local/repo or git://github.com/user/repo?branch=main
-  Objects:
-    - directory: tree entries
-    - file: blob entries, read-only
-  Operations: list, read
-
-sqlite://   SQLite Database Provider
-  Format: sqlite:///path/to/db.sqlite
-  Objects:
-    - directory: database root, tables list
-    - exec: table entries, supports query operations
-  Operations: list, read, exec (SQL queries)
-
-json://     JSON Data Provider
-  Format: json:///path/to/data.json
-  Objects:
-    - directory: object/array entries
-    - file: primitive values
-  Operations: list, read, write`,
-		examples: [
-			"afs mount add /src fs:///Users/me/project",
-			"afs mount add /repo git://github.com/user/repo",
-			"afs mount add /db sqlite:///data.sqlite"
-		]
-	};
-}
-/**
-* Format explain output for different views
-*/
-function formatExplainOutput(result, view) {
-	switch (view) {
-		case "json": return JSON.stringify(result, null, 2);
-		case "llm": return formatLlm(result);
-		default: return formatDefault(result);
-	}
-}
-function formatDefault(result) {
-	let output = `${result.topic}\n${"=".repeat(result.topic.length)}\n\n${result.explanation}`;
-	if (result.examples && result.examples.length > 0) output += `\n\nExamples:\n${result.examples.map((e) => `  $ ${e}`).join("\n")}`;
-	return output;
-}
-function formatLlm(result) {
-	const lines = [
-		`TOPIC ${result.topic}`,
-		"",
-		result.explanation
-	];
-	if (result.examples && result.examples.length > 0) {
-		lines.push("", "EXAMPLES");
-		for (const example of result.examples) lines.push(`CMD ${example}`);
-	}
-	return lines.join("\n");
-}
-/**
-* Format object explain output for different views
-*/
-function formatPathExplainOutput(result, view) {
-	switch (view) {
-		case "json": return JSON.stringify(result, null, 2);
-		case "llm": return formatPathLlm(result);
-		default: return formatPathDefault(result);
-	}
-}
-function formatPathDefault(result) {
-	const lines = [];
-	lines.push(`PATH ${result.path}`);
-	lines.push("");
-	lines.push("TYPE");
-	lines.push(result.type);
-	if (result.description) {
-		lines.push("");
-		lines.push("DESCRIPTION");
-		lines.push(result.description);
-	}
-	if (result.inputs && result.inputs.length > 0) {
-		lines.push("");
-		lines.push("INPUTS");
-		for (const input of result.inputs) lines.push(`- ${input}`);
-	}
-	if (result.outputs && result.outputs.length > 0) {
-		lines.push("");
-		lines.push("OUTPUTS");
-		for (const output of result.outputs) lines.push(`- ${output}`);
-	}
-	if (result.errors && result.errors.length > 0) {
-		lines.push("");
-		lines.push("ERRORS");
-		for (const error of result.errors) lines.push(`- ${error}`);
-	}
-	if (result.sideEffects && result.sideEffects.length > 0) {
-		lines.push("");
-		lines.push("SIDE EFFECTS");
-		for (const effect of result.sideEffects) lines.push(`- ${effect}`);
-	} else {
-		lines.push("");
-		lines.push("SIDE EFFECTS");
-		lines.push("- none");
-	}
-	if (result.metadata && Object.keys(result.metadata).length > 0) {
-		lines.push("");
-		lines.push("METADATA");
-		for (const [key, value] of Object.entries(result.metadata)) lines.push(`- ${key}: ${value}`);
-	}
-	return lines.join("\n");
-}
-function formatPathLlm(result) {
-	const lines = [];
-	lines.push(`PATH ${result.path}`);
-	lines.push(`TYPE ${result.type.toUpperCase()}`);
-	if (result.description) lines.push(`DESC ${result.description}`);
-	if (result.inputs && result.inputs.length > 0) lines.push(`INPUTS ${result.inputs.join(", ")}`);
-	if (result.outputs && result.outputs.length > 0) lines.push(`OUTPUTS ${result.outputs.join(", ")}`);
-	if (result.errors && result.errors.length > 0) lines.push(`ERRORS ${result.errors.join(", ")}`);
-	lines.push(`SIDE_EFFECTS ${result.sideEffects?.join(", ") || "none"}`);
-	if (result.metadata) for (const [key, value] of Object.entries(result.metadata)) lines.push(`${key.toUpperCase()} ${value}`);
-	return lines.join("\n");
-}
-
-//#endregion
-exports.explainCommand = explainCommand;
-exports.explainPathCommand = explainPathCommand;
-exports.formatExplainOutput = formatExplainOutput;
-exports.formatPathExplainOutput = formatPathExplainOutput;