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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/afs-cli",
-  "version": "1.11.0-beta.5",
+  "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,27 +44,46 @@
     "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.5",
-    "@aigne/afs-git": "1.11.0-beta.5",
-    "@aigne/afs-json": "1.11.0-beta.5",
-    "@aigne/afs-fs": "1.11.0-beta.5",
-    "@aigne/afs-sqlite": "1.11.0-beta.5",
-    "@aigne/afs-http": "1.11.0-beta.5"
+    "@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",
     "typescript": "5.9.2",
-    "@aigne/scripts": "0.0.0",
-    "@aigne/typescript-config": "0.0.0"
+    "@aigne/typescript-config": "0.0.0",
+    "@aigne/scripts": "0.0.0"
   },
   "scripts": {
     "build": "tsdown",

package/dist/commands/exec.cjs

@@ -1,46 +0,0 @@
-
-//#region src/commands/exec.ts
-/**
-* Execute an action on an AFS path
-*
-* Note: exec is not widely implemented by providers yet.
-* This is a placeholder for future functionality.
-*/
-async function execCommand(_runtime, path, _action, _params = {}) {
-	return {
-		path,
-		success: false,
-		message: "exec operation is not yet implemented"
-	};
-}
-/**
-* Format exec output for different views
-*/
-function formatExecOutput(result, view) {
-	switch (view) {
-		case "json": return JSON.stringify(result, null, 2);
-		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}`;
-}
-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}`);
-	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}`;
-}
-
-//#endregion
-exports.execCommand = execCommand;
-exports.formatExecOutput = formatExecOutput;

package/dist/commands/exec.mjs

@@ -1,45 +0,0 @@
-//#region src/commands/exec.ts
-/**
-* Execute an action on an AFS path
-*
-* Note: exec is not widely implemented by providers yet.
-* This is a placeholder for future functionality.
-*/
-async function execCommand(_runtime, path, _action, _params = {}) {
-	return {
-		path,
-		success: false,
-		message: "exec operation is not yet implemented"
-	};
-}
-/**
-* Format exec output for different views
-*/
-function formatExecOutput(result, view) {
-	switch (view) {
-		case "json": return JSON.stringify(result, null, 2);
-		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}`;
-}
-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}`);
-	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}`;
-}
-
-//#endregion
-export { execCommand, formatExecOutput };
-//# sourceMappingURL=exec.mjs.map

package/dist/commands/exec.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"exec.mjs","names":[],"sources":["../../src/commands/exec.ts"],"sourcesContent":["import type { AFSRuntime } from \"../runtime.js\";\nimport type { ViewType } from \"./ls.js\";\n\nexport interface ExecResult {\n  path: string;\n  success: boolean;\n  data?: Record<string, unknown>;\n  message?: string;\n}\n\n/**\n * Execute an action on an AFS path\n *\n * Note: exec is not widely implemented by providers yet.\n * This is a placeholder for future functionality.\n */\nexport async function execCommand(\n  _runtime: AFSRuntime,\n  path: string,\n  _action: string,\n  _params: Record<string, unknown> = {},\n): Promise<ExecResult> {\n  // exec is not yet implemented in the runtime\n  // This is a placeholder that returns an error\n\n  return {\n    path,\n    success: false,\n    message: \"exec operation is not yet implemented\",\n  };\n}\n\n/**\n * Format exec output for different views\n */\nexport function formatExecOutput(result: ExecResult, view: ViewType): string {\n  switch (view) {\n    case \"json\":\n      return JSON.stringify(result, null, 2);\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    return `OK ${result.path}`;\n  }\n  return `ERROR ${result.path} ${result.message}`;\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.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    return `Executed on ${result.path}\\n${result.data ? JSON.stringify(result.data, null, 2) : \"\"}`;\n  }\n  return `Failed to execute on ${result.path}: ${result.message}`;\n}\n"],"mappings":";;;;;;;AAgBA,eAAsB,YACpB,UACA,MACA,SACA,UAAmC,EAAE,EAChB;AAIrB,QAAO;EACL;EACA,SAAS;EACT,SAAS;EACV;;;;;AAMH,SAAgB,iBAAiB,QAAoB,MAAwB;AAC3E,SAAQ,MAAR;EACE,KAAK,OACH,QAAO,KAAK,UAAU,QAAQ,MAAM,EAAE;EACxC,KAAK,MACH,QAAO,UAAU,OAAO;EAC1B,KAAK,QACH,QAAO,YAAY,OAAO;EAC5B,QACE,QAAO,cAAc,OAAO;;;AAIlC,SAAS,cAAc,QAA4B;AACjD,KAAI,OAAO,QACT,QAAO,MAAM,OAAO;AAEtB,QAAO,SAAS,OAAO,KAAK,GAAG,OAAO;;AAGxC,SAAS,UAAU,QAA4B;CAC7C,MAAM,QAAkB,EAAE;AAE1B,OAAM,KAAK,QAAQ,OAAO,OAAO;AACjC,OAAM,KAAK,UAAU,OAAO,UAAU,YAAY,WAAW;AAE7D,KAAI,OAAO,KACT,OAAM,KAAK,QAAQ,KAAK,UAAU,OAAO,KAAK,GAAG;AAGnD,KAAI,OAAO,QACT,OAAM,KAAK,WAAW,OAAO,UAAU;AAGzC,QAAO,MAAM,KAAK,KAAK;;AAGzB,SAAS,YAAY,QAA4B;AAC/C,KAAI,OAAO,QACT,QAAO,eAAe,OAAO,KAAK,IAAI,OAAO,OAAO,KAAK,UAAU,OAAO,MAAM,MAAM,EAAE,GAAG;AAE7F,QAAO,wBAAwB,OAAO,KAAK,IAAI,OAAO"}

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.type || "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;

package/dist/commands/explain.mjs

@@ -1,242 +0,0 @@
-import { mountListCommand } from "./mount.mjs";
-
-//#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.type || "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 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
-export { explainCommand, explainPathCommand, formatExplainOutput, formatPathExplainOutput };
-//# sourceMappingURL=explain.mjs.map