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

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

@@ -0,0 +1 @@
+{"version":3,"file":"explain.mjs","names":[],"sources":["../../../src/core/commands/explain.ts"],"sourcesContent":["/**\n * explain Command - Core Implementation\n *\n * Explains AFS paths or concepts.\n * Matches old version output format with topic/explanation/examples structure.\n */\n\nimport type { AFS } from \"@aigne/afs\";\nimport type { CommandModule } from \"yargs\";\nimport { configMountListCommand } from \"../../config/mount-commands.js\";\nimport { formatExplainOutput, formatPathExplainOutput } from \"../formatters/index.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\n/**\n * Result for concept explanations (mount, paths, uri, overview)\n */\nexport interface ExplainResult {\n  topic: string;\n  explanation: string;\n  examples?: string[];\n}\n\n/**\n * Result for path explanations\n */\nexport interface PathExplainResult {\n  path: string;\n  type: string;\n  description?: string;\n  inputs?: string[];\n  outputs?: string[];\n  errors?: string[];\n  sideEffects?: string[];\n  meta?: Record<string, string>;\n}\n\n/**\n * Explain command arguments\n */\nexport interface ExplainArgs {\n  topic?: string;\n}\n\n/**\n * Create explain command factory\n */\nexport function createExplainCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, ExplainArgs> {\n  return {\n    command: \"explain [topic]\",\n    describe: \"Explain AFS concepts or paths\",\n    builder: {\n      topic: {\n        type: \"string\",\n        description: \"Topic (mount, path, uri) or AFS path (e.g., /src)\",\n      },\n    },\n    handler: async (argv) => {\n      const target = argv.topic;\n\n      // No target - explain overview\n      if (!target) {\n        options.onResult({\n          command: \"explain\",\n          result: explainOverview(),\n          format: formatExplainOutput,\n        });\n        return;\n      }\n\n      // Check if it's a path (starts with /, @, or $)\n      const isPath = target.startsWith(\"/\") || target.startsWith(\"@\") || target.startsWith(\"$\");\n\n      if (isPath) {\n        const afs = await resolveAFS(options);\n        const canonicalPath = cliPathToCanonical(target);\n        const result = await getPathExplanation(afs, target, canonicalPath);\n        options.onResult({ command: \"explain\", result, format: formatPathExplainOutput });\n      } else {\n        const cwd = options.cwd ?? process.cwd();\n        // Pass AFS instance for runtime mount info (DOC-2)\n        let afs: AFS | undefined;\n        try {\n          afs = await resolveAFS(options);\n        } catch {}\n        const result = await getConceptExplanation(target.toLowerCase(), cwd, afs);\n        options.onResult({\n          command: \"explain\",\n          result,\n          format: formatExplainOutput,\n        });\n      }\n    },\n  };\n}\n\n/**\n * Get explanation for a path\n */\nasync function getPathExplanation(\n  afs: AFS,\n  path: string,\n  canonicalPath: string,\n): Promise<PathExplainResult> {\n  try {\n    // Try stat first (lightweight metadata query), fallback to read\n    let entry:\n      | { path: string; meta?: Record<string, unknown> | null; content?: unknown }\n      | undefined;\n\n    try {\n      const statResult = await afs.stat(canonicalPath);\n      entry = statResult.data;\n    } catch {}\n\n    if (!entry) {\n      try {\n        const readResult = await afs.read(canonicalPath);\n        entry = readResult.data;\n      } catch {}\n    }\n\n    if (!entry) {\n      return {\n        path,\n        type: \"unknown\",\n      };\n    }\n\n    const metadata = entry.meta || {};\n    // Determine type from childrenCount: if defined, it has children (directory-like); otherwise file-like\n    const entryType =\n      metadata.kind === \"afs:executable\"\n        ? \"exec\"\n        : typeof metadata.childrenCount === \"number\"\n          ? \"directory\"\n          : \"file\";\n\n    const result: PathExplainResult = {\n      path: entry.path,\n      type: entryType,\n      description: metadata.description as string | undefined,\n      meta: {},\n    };\n\n    // Add metadata\n    if (metadata.provider) {\n      result.meta!.provider = String(metadata.provider);\n    }\n    if (metadata.permissions) {\n      const perms = metadata.permissions;\n      result.meta!.permissions = Array.isArray(perms) ? perms.join(\", \") : String(perms);\n    }\n\n    // For exec type, try to get schema info\n    if (entryType === \"exec\") {\n      if (metadata.inputs) {\n        result.inputs = Array.isArray(metadata.inputs)\n          ? (metadata.inputs as string[])\n          : [String(metadata.inputs)];\n      }\n      if (metadata.outputs) {\n        result.outputs = Array.isArray(metadata.outputs)\n          ? (metadata.outputs as string[])\n          : [String(metadata.outputs)];\n      }\n      if (metadata.errors) {\n        result.errors = Array.isArray(metadata.errors)\n          ? (metadata.errors as string[])\n          : [String(metadata.errors)];\n      }\n      if (metadata.sideEffects) {\n        result.sideEffects = Array.isArray(metadata.sideEffects)\n          ? (metadata.sideEffects as string[])\n          : [String(metadata.sideEffects)];\n      }\n    }\n\n    // Clean up empty metadata\n    if (Object.keys(result.meta!).length === 0) {\n      delete result.meta;\n    }\n\n    return result;\n  } catch (err) {\n    return {\n      path,\n      type: \"error\",\n      description: err instanceof Error ? err.message : String(err),\n    };\n  }\n}\n\n/**\n * Get explanation for a concept\n */\nasync function getConceptExplanation(\n  topic: string,\n  cwd: string,\n  afs?: AFS,\n): Promise<ExplainResult> {\n  switch (topic) {\n    case \"mount\":\n    case \"mounts\":\n      return explainMounts(cwd, afs);\n    case \"path\":\n    case \"paths\":\n      return explainPaths();\n    case \"uri\":\n    case \"provider\":\n    case \"providers\":\n      return explainUri();\n    default:\n      return {\n        topic: \"Unknown Topic\",\n        explanation: `Unknown topic: ${topic}\\n\\nAvailable topics: overview, mount, path, uri`,\n      };\n  }\n}\n\nfunction explainOverview(): ExplainResult {\n  return {\n    topic: \"AFS Overview\",\n    explanation: `AFS (Abstract File System) is a virtual filesystem that unifies different data sources into a single namespace.\n\nCore Concepts:\n- mount: Mount a data source to a virtual path\n- path: Virtual path, e.g., /src, /data\n- uri: Data source address, e.g., fs://, git://, sqlite://\n\nData Flow:\n  User Path -> AFS -> /{mount} -> Provider -> Actual Data`,\n    examples: [\"afs mount add /src fs:///path/to/source\", \"afs ls /src\", \"afs read /src/file.txt\"],\n  };\n}\n\nasync function explainMounts(cwd: string, afs?: AFS): Promise<ExplainResult> {\n  const result = await configMountListCommand(cwd);\n\n  if (result.mounts.length === 0) {\n    // Try runtime mounts if no config mounts\n    if (afs) {\n      try {\n        const listResult = await afs.list(\"$afs:/\");\n        if (listResult.data?.length) {\n          const runtimeMounts = listResult.data\n            .map((entry) => `  ${entry.path} (runtime mount)`)\n            .join(\"\\n\");\n\n          return {\n            topic: \"Mounts\",\n            explanation: `Runtime mounts (mounted via API):\\n\\n${runtimeMounts}`,\n            examples: listResult.data.slice(0, 3).map((entry) => `afs ls ${entry.path}`),\n          };\n        }\n      } catch {}\n    }\n\n    return {\n      topic: \"Mounts\",\n      explanation: `No mounts configured.\n\nUse mount add to add a mount:\n  afs mount add <path> <uri>\n\npath: Virtual path for accessing data in AFS\nuri: Data source URI specifying the data origin`,\n      examples: [\n        \"afs mount add /src fs:///Users/me/project\",\n        \"afs mount add /data sqlite:///data.db\",\n      ],\n    };\n  }\n\n  const mountList = result.mounts\n    .map((m) => `  ${m.path}${m.description ? ` - ${m.description}` : \"\"}`)\n    .join(\"\\n\");\n\n  return {\n    topic: \"Mounts\",\n    explanation: `Current mount configuration:\n\n${mountList}\n\nAfter mounting, data is accessed via the mount path:\n  path=\"/src\" -> /src`,\n    examples: result.mounts.map((m) => `afs ls ${m.path}`),\n  };\n}\n\nfunction explainPaths(): ExplainResult {\n  return {\n    topic: \"Paths\",\n    explanation: `AFS Path Structure:\n\n/                     Root directory\n/{mount}              Mounted data source\n/{mount}/{path}       Files/nodes within a mount\n\nPath Mapping:\n  config: path=\"/src\"  ->  access: /src\n  config: path=\"/data\" ->  access: /data\n\nMounts are accessed directly at their configured path.`,\n  };\n}\n\nfunction explainUri(): ExplainResult {\n  return {\n    topic: \"URI\",\n    explanation: `AFS URI Schemes and Objects:\n\nfs://       Local Filesystem Provider\n  Format: fs:///absolute/path or fs://./relative/path\n  Operations: list, read, write, delete\n\ngit://      Git Repository Provider\n  Format: git:///local/repo or git://github.com/user/repo?branch=main\n  Operations: list, read, exec (diff, create-branch, commit, merge)\n\nsqlite://   SQLite Database Provider\n  Format: sqlite:///path/to/db.sqlite\n  Operations: list, read, exec (SQL queries)\n\njson://     JSON Data Provider\n  Format: json:///path/to/data.json\n  Operations: list, read, write\n\ntoml://     TOML Data Provider\n  Format: toml:///path/to/config.toml\n  Operations: list, read, write\n\nsandbox://  Sandboxed Script Execution Provider\n  Format: sandbox:///path/to/scripts\n  Operations: list, read, exec\n\ngithub://   GitHub Issues/PRs Provider\n  Format: github://owner/repo\n  Operations: list, read, exec (create-issue, close-issue, etc.)\n\nhttp://     HTTP Proxy Provider\n  Format: http://host:port/path\n  Operations: list, read\n\nmcp://      MCP Server Provider\n  Format: mcp:///path/to/server\n  Operations: list, read, exec\n\ns3://       AWS S3 Storage Provider\n  Format: s3://bucket-name\n  Operations: list, read, write, delete\n\ngcs://      Google Cloud Storage Provider\n  Format: gcs://bucket-name\n  Operations: list, read, write, delete\n\nec2://      AWS EC2 Instances Provider\n  Format: ec2://region\n  Operations: list, read, exec (run-instances)\n\ngce://      Google Compute Engine Provider\n  Format: gce://project/zone\n  Operations: list, read, exec\n\ndns://      Cloud DNS Provider\n  Format: dns://provider (route53, clouddns)\n  Operations: list, read`,\n    examples: [\n      \"afs mount add /src fs:///Users/me/project\",\n      \"afs mount add /repo git://github.com/user/repo\",\n      \"afs mount add /db sqlite:///data.sqlite\",\n      \"afs mount add /s3 s3://my-bucket\",\n    ],\n  };\n}\n"],"mappings":"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"}

package/dist/core/commands/explore.cjs

@@ -0,0 +1,30 @@
+const require_types = require('./types.cjs');
+const require_version = require('../../version.cjs');
+
+//#region src/core/commands/explore.ts
+/**
+* Create explore command
+*/
+function createExploreCommand(options) {
+	return {
+		command: "explore [path]",
+		describe: "Interactive TUI explorer",
+		builder: { path: {
+			type: "string",
+			default: "/",
+			description: "Starting path"
+		} },
+		handler: async (argv) => {
+			const afs = await require_types.resolveAFS(options);
+			const { createExplorerScreen } = await Promise.resolve().then(() => require("../../explorer/screen.cjs"));
+			await createExplorerScreen({
+				afs,
+				startPath: argv.path,
+				version: require_version.VERSION
+			});
+		}
+	};
+}
+
+//#endregion
+exports.createExploreCommand = createExploreCommand;

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

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

package/dist/core/commands/explore.mjs

@@ -0,0 +1,31 @@
+import { resolveAFS } from "./types.mjs";
+import { VERSION } from "../../version.mjs";
+
+//#region src/core/commands/explore.ts
+/**
+* Create explore command
+*/
+function createExploreCommand(options) {
+	return {
+		command: "explore [path]",
+		describe: "Interactive TUI explorer",
+		builder: { path: {
+			type: "string",
+			default: "/",
+			description: "Starting path"
+		} },
+		handler: async (argv) => {
+			const afs = await resolveAFS(options);
+			const { createExplorerScreen } = await import("../../explorer/screen.mjs");
+			await createExplorerScreen({
+				afs,
+				startPath: argv.path,
+				version: VERSION
+			});
+		}
+	};
+}
+
+//#endregion
+export { createExploreCommand };
+//# sourceMappingURL=explore.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explore.mjs","names":[],"sources":["../../../src/core/commands/explore.ts"],"sourcesContent":["/**\n * AFS Explore Command\n *\n * Interactive TUI explorer for AFS\n */\n\nimport type { CommandModule } from \"yargs\";\nimport { VERSION } from \"../../version.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\nexport interface ExploreArgs {\n  path: string;\n}\n\n/**\n * Create explore command\n */\nexport function createExploreCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, ExploreArgs> {\n  return {\n    command: \"explore [path]\",\n    describe: \"Interactive TUI explorer\",\n    builder: {\n      path: { type: \"string\", default: \"/\", description: \"Starting path\" },\n    },\n    handler: async (argv) => {\n      const afs = await resolveAFS(options);\n      const { createExplorerScreen } = await import(\"../../explorer/screen.js\");\n      await createExplorerScreen({ afs, startPath: argv.path, version: VERSION });\n    },\n  };\n}\n"],"mappings":";;;;;;;AAiBA,SAAgB,qBACd,SACqC;AACrC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS,EACP,MAAM;GAAE,MAAM;GAAU,SAAS;GAAK,aAAa;GAAiB,EACrE;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,EAAE,yBAAyB,MAAM,OAAO;AAC9C,SAAM,qBAAqB;IAAE;IAAK,WAAW,KAAK;IAAM,SAAS;IAAS,CAAC;;EAE9E"}

package/dist/core/commands/index.cjs

@@ -0,0 +1,36 @@
+const require_types = require('./types.cjs');
+const require_delete = require('./delete.cjs');
+const require_exec_args = require('../helpers/exec-args.cjs');
+const require_exec = require('./exec.cjs');
+const require_explain = require('./explain.cjs');
+const require_explore = require('./explore.cjs');
+const require_ls = require('./ls.cjs');
+const require_mount = require('./mount.cjs');
+const require_read = require('./read.cjs');
+const require_search = require('./search.cjs');
+const require_serve = require('./serve.cjs');
+const require_stat = require('./stat.cjs');
+const require_write = require('./write.cjs');
+
+//#region src/core/commands/index.ts
+/**
+* Array of all command factories
+*
+* Used by AFSCommandExecutor to register all commands.
+*/
+const commandFactories = [
+	require_ls.createLsCommand,
+	require_read.createReadCommand,
+	require_write.createWriteCommand,
+	require_delete.createDeleteCommand,
+	require_stat.createStatCommand,
+	require_exec.createExecCommand,
+	require_explain.createExplainCommand,
+	require_search.createSearchCommand,
+	require_mount.createMountCommand,
+	require_serve.createServeCommand,
+	require_explore.createExploreCommand
+];
+
+//#endregion
+exports.commandFactories = commandFactories;

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

@@ -0,0 +1,21 @@
+import { CommandFactory, CommandFactoryOptions, CommandOutput, FormatFunction } from "./types.cjs";
+import { DeleteArgs, createDeleteCommand } from "./delete.cjs";
+import { parseExecArgs, parseValueBySchema } from "../helpers/exec-args.cjs";
+import { ExecArgs, createExecCommand } from "./exec.cjs";
+import { ExplainArgs, createExplainCommand } from "./explain.cjs";
+import { LsArgs, createLsCommand } from "./ls.cjs";
+import { MountAddArgs, MountListArgs, MountRemoveArgs, createMountCommand } from "./mount.cjs";
+import { ReadArgs, createReadCommand } from "./read.cjs";
+import { StatArgs, createStatCommand } from "./stat.cjs";
+import { WriteArgs, createWriteCommand } from "./write.cjs";
+
+//#region src/core/commands/index.d.ts
+/**
+ * Array of all command factories
+ *
+ * Used by AFSCommandExecutor to register all commands.
+ */
+declare const commandFactories: CommandFactory[];
+//#endregion
+export { commandFactories };
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/core/commands/index.ts"],"mappings":";;;;;;;;;;;;;;;;;cAmDa,gBAAA,EAAkB,cAAA"}

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

@@ -0,0 +1,24 @@
+import { CommandFactory, CommandFactoryOptions, CommandOutput, FormatFunction } from "./types.mjs";
+import { DeleteArgs, createDeleteCommand } from "./delete.mjs";
+import { parseExecArgs, parseValueBySchema } from "../helpers/exec-args.mjs";
+import { ExecArgs, createExecCommand } from "./exec.mjs";
+import { ExplainArgs, createExplainCommand } from "./explain.mjs";
+import "./explore.mjs";
+import { LsArgs, createLsCommand } from "./ls.mjs";
+import { MountAddArgs, MountListArgs, MountRemoveArgs, createMountCommand } from "./mount.mjs";
+import { ReadArgs, createReadCommand } from "./read.mjs";
+import "./search.mjs";
+import "./serve.mjs";
+import { StatArgs, createStatCommand } from "./stat.mjs";
+import { WriteArgs, createWriteCommand } from "./write.mjs";
+
+//#region src/core/commands/index.d.ts
+/**
+ * Array of all command factories
+ *
+ * Used by AFSCommandExecutor to register all commands.
+ */
+declare const commandFactories: CommandFactory[];
+//#endregion
+export { commandFactories };
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/commands/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;cAmDa,gBAAA,EAAkB,cAAA"}

package/dist/core/commands/index.mjs

@@ -0,0 +1,37 @@
+import { resolveAFS } from "./types.mjs";
+import { createDeleteCommand } from "./delete.mjs";
+import { parseExecArgs, parseValueBySchema } from "../helpers/exec-args.mjs";
+import { createExecCommand } from "./exec.mjs";
+import { createExplainCommand } from "./explain.mjs";
+import { createExploreCommand } from "./explore.mjs";
+import { createLsCommand } from "./ls.mjs";
+import { createMountCommand } from "./mount.mjs";
+import { createReadCommand } from "./read.mjs";
+import { createSearchCommand } from "./search.mjs";
+import { createServeCommand } from "./serve.mjs";
+import { createStatCommand } from "./stat.mjs";
+import { createWriteCommand } from "./write.mjs";
+
+//#region src/core/commands/index.ts
+/**
+* Array of all command factories
+*
+* Used by AFSCommandExecutor to register all commands.
+*/
+const commandFactories = [
+	createLsCommand,
+	createReadCommand,
+	createWriteCommand,
+	createDeleteCommand,
+	createStatCommand,
+	createExecCommand,
+	createExplainCommand,
+	createSearchCommand,
+	createMountCommand,
+	createServeCommand,
+	createExploreCommand
+];
+
+//#endregion
+export { commandFactories };
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/core/commands/index.ts"],"sourcesContent":["/**\n * CLI Core Commands\n *\n * Re-exports all command implementations and factories.\n */\n\n// Command factories and types\nexport { createDeleteCommand, type DeleteArgs } from \"./delete.js\";\nexport { createExecCommand, type ExecArgs, parseExecArgs, parseValueBySchema } from \"./exec.js\";\nexport { createExplainCommand, type ExplainArgs } from \"./explain.js\";\nexport { createExploreCommand, type ExploreArgs } from \"./explore.js\";\nexport { createLsCommand, type LsArgs } from \"./ls.js\";\nexport {\n  createMountCommand,\n  type MountAddArgs,\n  type MountListArgs,\n  type MountRemoveArgs,\n} from \"./mount.js\";\nexport { createReadCommand, type ReadArgs } from \"./read.js\";\nexport { createSearchCommand, type SearchArgs } from \"./search.js\";\nexport { createServeCommand, type ServeArgs, type ServeResult } from \"./serve.js\";\nexport { createStatCommand, type StatArgs } from \"./stat.js\";\n// Types and helpers\nexport type {\n  CommandFactory,\n  CommandFactoryOptions,\n  CommandOutput,\n  FormatFunction,\n} from \"./types.js\";\nexport { resolveAFS } from \"./types.js\";\nexport { createWriteCommand, type WriteArgs } from \"./write.js\";\n\n// Import factories for array export\nimport { createDeleteCommand } from \"./delete.js\";\nimport { createExecCommand } from \"./exec.js\";\nimport { createExplainCommand } from \"./explain.js\";\nimport { createExploreCommand } from \"./explore.js\";\nimport { createLsCommand } from \"./ls.js\";\nimport { createMountCommand } from \"./mount.js\";\nimport { createReadCommand } from \"./read.js\";\nimport { createSearchCommand } from \"./search.js\";\nimport { createServeCommand } from \"./serve.js\";\nimport { createStatCommand } from \"./stat.js\";\nimport type { CommandFactory } from \"./types.js\";\nimport { createWriteCommand } from \"./write.js\";\n\n/**\n * Array of all command factories\n *\n * Used by AFSCommandExecutor to register all commands.\n */\nexport const commandFactories: CommandFactory[] = [\n  createLsCommand,\n  createReadCommand,\n  createWriteCommand,\n  createDeleteCommand,\n  createStatCommand,\n  createExecCommand,\n  createExplainCommand,\n  createSearchCommand,\n  createMountCommand,\n  createServeCommand,\n  createExploreCommand,\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAmDA,MAAa,mBAAqC;CAChD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}

package/dist/core/commands/ls.cjs

@@ -0,0 +1,57 @@
+const require_ls = require('../formatters/ls.cjs');
+const require_path_utils = require('../../path-utils.cjs');
+require('../path-utils.cjs');
+const require_types = require('./types.cjs');
+
+//#region src/core/commands/ls.ts
+/**
+* Create ls command factory
+*/
+function createLsCommand(options) {
+	return {
+		command: ["ls [path]", "list [path]"],
+		describe: "List directory contents",
+		builder: {
+			path: {
+				type: "string",
+				default: "/",
+				description: "Path to list"
+			},
+			depth: {
+				type: "number",
+				default: 1,
+				description: "Maximum depth to list"
+			},
+			limit: {
+				type: "number",
+				description: "Maximum number of entries to return"
+			},
+			"max-children": {
+				type: "number",
+				description: "Maximum children per directory"
+			},
+			pattern: {
+				type: "string",
+				description: "Glob pattern to filter entries"
+			}
+		},
+		handler: async (argv) => {
+			const afs = await require_types.resolveAFS(options);
+			const canonicalPath = require_path_utils.cliPathToCanonical(argv.path || "/");
+			const result = await afs.list(canonicalPath, {
+				maxDepth: argv.depth ?? 1,
+				limit: argv.limit,
+				maxChildren: argv.maxChildren,
+				pattern: argv.pattern
+			});
+			options.onResult({
+				command: "ls",
+				result,
+				format: require_ls.formatLsOutput
+			});
+		}
+	};
+}
+
+//#endregion
+exports.createLsCommand = createLsCommand;

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

@@ -0,0 +1,21 @@
+import { CommandFactoryOptions } from "./types.cjs";
+import { CommandModule } from "yargs";
+
+//#region src/core/commands/ls.d.ts
+/**
+ * Ls command arguments
+ */
+interface LsArgs {
+  path: string;
+  depth: number;
+  limit?: number;
+  maxChildren?: number;
+  pattern?: string;
+}
+/**
+ * Create ls command factory
+ */
+declare function createLsCommand(options: CommandFactoryOptions): CommandModule<unknown, LsArgs>;
+//#endregion
+export { LsArgs, createLsCommand };
+//# sourceMappingURL=ls.d.cts.map

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

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

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

@@ -0,0 +1,21 @@
+import { CommandFactoryOptions } from "./types.mjs";
+import { CommandModule } from "yargs";
+
+//#region src/core/commands/ls.d.ts
+/**
+ * Ls command arguments
+ */
+interface LsArgs {
+  path: string;
+  depth: number;
+  limit?: number;
+  maxChildren?: number;
+  pattern?: string;
+}
+/**
+ * Create ls command factory
+ */
+declare function createLsCommand(options: CommandFactoryOptions): CommandModule<unknown, LsArgs>;
+//#endregion
+export { LsArgs, createLsCommand };
+//# sourceMappingURL=ls.d.mts.map

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

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

package/dist/core/commands/ls.mjs

@@ -0,0 +1,58 @@
+import { formatLsOutput } from "../formatters/ls.mjs";
+import { cliPathToCanonical } from "../../path-utils.mjs";
+import "../path-utils.mjs";
+import { resolveAFS } from "./types.mjs";
+
+//#region src/core/commands/ls.ts
+/**
+* Create ls command factory
+*/
+function createLsCommand(options) {
+	return {
+		command: ["ls [path]", "list [path]"],
+		describe: "List directory contents",
+		builder: {
+			path: {
+				type: "string",
+				default: "/",
+				description: "Path to list"
+			},
+			depth: {
+				type: "number",
+				default: 1,
+				description: "Maximum depth to list"
+			},
+			limit: {
+				type: "number",
+				description: "Maximum number of entries to return"
+			},
+			"max-children": {
+				type: "number",
+				description: "Maximum children per directory"
+			},
+			pattern: {
+				type: "string",
+				description: "Glob pattern to filter entries"
+			}
+		},
+		handler: async (argv) => {
+			const afs = await resolveAFS(options);
+			const canonicalPath = cliPathToCanonical(argv.path || "/");
+			const result = await afs.list(canonicalPath, {
+				maxDepth: argv.depth ?? 1,
+				limit: argv.limit,
+				maxChildren: argv.maxChildren,
+				pattern: argv.pattern
+			});
+			options.onResult({
+				command: "ls",
+				result,
+				format: formatLsOutput
+			});
+		}
+	};
+}
+
+//#endregion
+export { createLsCommand };
+//# sourceMappingURL=ls.mjs.map

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

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

package/dist/core/commands/mount.cjs

@@ -0,0 +1,222 @@
+const require_schema = require('../../config/schema.cjs');
+const require_mount_commands = require('../../config/mount-commands.cjs');
+const require_mount = require('../formatters/mount.cjs');
+
+//#region src/core/commands/mount.ts
+/**
+* Create mount command factory (with subcommands)
+*/
+function createMountCommand(options) {
+	return {
+		command: "mount",
+		describe: "Mount management",
+		builder: (yargs) => yargs.command(createMountListSubcommand(options)).command(createMountAddSubcommand(options)).command(createMountRemoveSubcommand(options)).command(createMountValidateSubcommand(options)).demandCommand(1, "Please specify a subcommand").alias("help", "h"),
+		handler: () => {}
+	};
+}
+/**
+* Create mount list subcommand
+*/
+function createMountListSubcommand(options) {
+	return {
+		command: ["list", "ls"],
+		describe: "List all mounts",
+		builder: { namespace: {
+			type: "string",
+			description: "Filter by namespace"
+		} },
+		handler: async () => {
+			const result = await require_mount_commands.configMountListCommand(options.cwd ?? process.cwd());
+			options.onResult({
+				command: "mount list",
+				result: result.mounts,
+				format: require_mount.formatMountListOutput
+			});
+		}
+	};
+}
+/**
+* Create mount add subcommand
+*/
+/** Known argv keys that are NOT provider options */
+const KNOWN_MOUNT_KEYS = new Set([
+	"path",
+	"uri",
+	"namespace",
+	"description",
+	"sensitive-args",
+	"sensitiveArgs",
+	"_",
+	"$0",
+	"help",
+	"h",
+	"version",
+	"v",
+	"json",
+	"yaml",
+	"view",
+	"interactive"
+]);
+function createMountAddSubcommand(options) {
+	return {
+		command: "add <path> <uri>",
+		describe: "Add a mount",
+		builder: (yargs) => yargs.strict(false).positional("path", {
+			type: "string",
+			demandOption: true,
+			description: "Mount path (e.g., /src)"
+		}).positional("uri", {
+			type: "string",
+			demandOption: true,
+			description: "Provider URI (e.g., fs://./src)"
+		}).option("namespace", {
+			type: "string",
+			description: "Mount namespace"
+		}).option("description", {
+			type: "string",
+			description: "Mount description"
+		}).option("sensitive-args", {
+			type: "string",
+			array: true,
+			description: "Field names to treat as sensitive credentials"
+		}),
+		handler: async (argv) => {
+			const cwd = options.cwd ?? process.cwd();
+			if (!argv.uri || argv.uri.trim() === "") throw new Error("URI is required");
+			const resolvedUri = require_mount_commands.resolveUriPath(argv.uri, cwd);
+			const validation = require_schema.MountSchema.safeParse({
+				path: argv.path,
+				uri: resolvedUri,
+				description: argv.description
+			});
+			if (!validation.success) {
+				const errors = validation.error.issues.map((e) => e.message).join("; ");
+				throw new Error(errors);
+			}
+			const extraOptions = {};
+			for (const [key, value] of Object.entries(argv)) if (!KNOWN_MOUNT_KEYS.has(key) && !key.startsWith("-")) extraOptions[key] = value;
+			const sensitiveArgs = argv["sensitive-args"] ?? [];
+			const { resolveCredentialsForMount } = await Promise.resolve().then(() => require("../../config/afs-loader.cjs"));
+			const { createCLIAuthContext } = await Promise.resolve().then(() => require("../../credential/cli-auth-context.cjs"));
+			const { createCredentialStore } = await Promise.resolve().then(() => require("../../credential/store.cjs"));
+			const authContext = createCLIAuthContext();
+			const credentialStore = createCredentialStore();
+			const credResolveOptions = {
+				cwd,
+				uri: resolvedUri,
+				mountPath: validation.data.path,
+				authContext,
+				credentialStore,
+				extraOptions: Object.keys(extraOptions).length > 0 ? extraOptions : void 0,
+				sensitiveArgs
+			};
+			let credResult = await resolveCredentialsForMount(credResolveOptions);
+			const { verifyMount } = await Promise.resolve().then(() => require("../../config/afs-loader.cjs"));
+			let verifyOptions = {
+				...extraOptions,
+				...credResult?.allValues ?? {}
+			};
+			try {
+				await verifyMount(resolvedUri, validation.data.path, Object.keys(verifyOptions).length > 0 ? verifyOptions : void 0);
+			} catch (verifyError) {
+				if (credResult && !credResult.collected) {
+					credResult = await resolveCredentialsForMount({
+						...credResolveOptions,
+						forceCollect: true
+					});
+					verifyOptions = {
+						...extraOptions,
+						...credResult?.allValues ?? {}
+					};
+					await verifyMount(resolvedUri, validation.data.path, Object.keys(verifyOptions).length > 0 ? verifyOptions : void 0);
+				} else throw verifyError;
+			}
+			if (credResult) await credResult.persistCredentials();
+			const nonSensitiveFromCreds = credResult?.nonSensitive ?? {};
+			const mountOptions = {
+				...extraOptions,
+				...nonSensitiveFromCreds
+			};
+			if (credResult?.sensitiveFields) for (const field of credResult.sensitiveFields) delete mountOptions[field];
+			const finalMountOptions = Object.keys(mountOptions).length > 0 ? mountOptions : void 0;
+			const persistUri = credResult?.configUri ?? validation.data.uri;
+			const result = await require_mount_commands.persistMount(cwd, {
+				path: validation.data.path,
+				uri: persistUri,
+				description: argv.description,
+				options: finalMountOptions
+			});
+			if (!result.success) throw new Error(result.message ?? "Failed to add mount");
+			options.onResult({
+				command: "mount add",
+				result: {
+					success: true,
+					path: argv.path,
+					uri: resolvedUri
+				},
+				format: (res) => `Mounted ${res.uri} at ${res.path}`
+			});
+		}
+	};
+}
+/**
+* Create mount remove subcommand
+*/
+function createMountRemoveSubcommand(options) {
+	return {
+		command: ["remove <path>", "rm <path>"],
+		describe: "Unmount a path",
+		builder: {
+			path: {
+				type: "string",
+				demandOption: true,
+				description: "Mount path to remove"
+			},
+			namespace: {
+				type: "string",
+				description: "Namespace of the mount"
+			}
+		},
+		handler: async (argv) => {
+			const result = await require_mount_commands.mountRemoveCommand(options.cwd ?? process.cwd(), argv.path);
+			if (!result.success) throw new Error(result.message ?? "Failed to remove mount");
+			options.onResult({
+				command: "mount remove",
+				result: {
+					success: true,
+					path: argv.path
+				},
+				format: (res) => res.success ? `Unmounted ${res.path}` : `Failed to unmount ${res.path}`
+			});
+		}
+	};
+}
+/**
+* Format mount validate output
+*/
+function formatMountValidateOutput(result, view) {
+	if (view === "json") return JSON.stringify(result, null, 2);
+	if (result.valid) return "Configuration is valid";
+	return ["Configuration validation failed:", ...result.errors.map((e) => `  - ${e}`)].join("\n");
+}
+/**
+* Create mount validate subcommand
+*/
+function createMountValidateSubcommand(options) {
+	return {
+		command: "validate",
+		describe: "Validate mount configuration",
+		handler: async () => {
+			const result = await require_mount_commands.mountValidateCommand(options.cwd ?? process.cwd());
+			options.onResult({
+				command: "mount validate",
+				result,
+				format: formatMountValidateOutput,
+				error: result.valid ? void 0 : { message: result.errors.join("; ") }
+			});
+		}
+	};
+}
+
+//#endregion
+exports.createMountCommand = createMountCommand;