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

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

@@ -0,0 +1,35 @@
+import { CommandFactoryOptions } from "./types.cjs";
+import { CommandModule } from "yargs";
+
+//#region src/core/commands/mount.d.ts
+/**
+ * Mount list subcommand arguments
+ */
+interface MountListArgs {
+  namespace?: string;
+}
+/**
+ * Mount add subcommand arguments
+ */
+interface MountAddArgs {
+  path: string;
+  uri: string;
+  namespace?: string;
+  description?: string;
+  "sensitive-args"?: string[];
+  [key: string]: unknown;
+}
+/**
+ * Mount remove subcommand arguments
+ */
+interface MountRemoveArgs {
+  path: string;
+  namespace?: string;
+}
+/**
+ * Create mount command factory (with subcommands)
+ */
+declare function createMountCommand(options: CommandFactoryOptions): CommandModule;
+//#endregion
+export { MountAddArgs, MountListArgs, MountRemoveArgs, createMountCommand };
+//# sourceMappingURL=mount.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.cts","names":[],"sources":["../../../src/core/commands/mount.ts"],"mappings":";;;;;AA+BA;;UAPiB,aAAA;EACf,SAAA;AAAA;;;;UAMe,YAAA;EACf,IAAA;EACA,GAAA;EACA,SAAA;EACA,WAAA;EACA,gBAAA;EAAA,CACC,GAAA;AAAA;;AAcH;;UARiB,eAAA;EACf,IAAA;EACA,SAAA;AAAA;;;;iBAMc,kBAAA,CAAmB,OAAA,EAAS,qBAAA,GAAwB,aAAA"}

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

@@ -0,0 +1,35 @@
+import { CommandFactoryOptions } from "./types.mjs";
+import { CommandModule } from "yargs";
+
+//#region src/core/commands/mount.d.ts
+/**
+ * Mount list subcommand arguments
+ */
+interface MountListArgs {
+  namespace?: string;
+}
+/**
+ * Mount add subcommand arguments
+ */
+interface MountAddArgs {
+  path: string;
+  uri: string;
+  namespace?: string;
+  description?: string;
+  "sensitive-args"?: string[];
+  [key: string]: unknown;
+}
+/**
+ * Mount remove subcommand arguments
+ */
+interface MountRemoveArgs {
+  path: string;
+  namespace?: string;
+}
+/**
+ * Create mount command factory (with subcommands)
+ */
+declare function createMountCommand(options: CommandFactoryOptions): CommandModule;
+//#endregion
+export { MountAddArgs, MountListArgs, MountRemoveArgs, createMountCommand };
+//# sourceMappingURL=mount.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.mts","names":[],"sources":["../../../src/core/commands/mount.ts"],"mappings":";;;;;AA+BA;;UAPiB,aAAA;EACf,SAAA;AAAA;;;;UAMe,YAAA;EACf,IAAA;EACA,GAAA;EACA,SAAA;EACA,WAAA;EACA,gBAAA;EAAA,CACC,GAAA;AAAA;;AAcH;;UARiB,eAAA;EACf,IAAA;EACA,SAAA;AAAA;;;;iBAMc,kBAAA,CAAmB,OAAA,EAAS,qBAAA,GAAwB,aAAA"}

package/dist/core/commands/mount.mjs

@@ -0,0 +1,223 @@
+import { MountSchema } from "../../config/schema.mjs";
+import { configMountListCommand, mountRemoveCommand, mountValidateCommand, persistMount, resolveUriPath } from "../../config/mount-commands.mjs";
+import { formatMountListOutput } from "../formatters/mount.mjs";
+
+//#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 configMountListCommand(options.cwd ?? process.cwd());
+			options.onResult({
+				command: "mount list",
+				result: result.mounts,
+				format: 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 = resolveUriPath(argv.uri, cwd);
+			const validation = 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 import("../../config/afs-loader.mjs");
+			const { createCLIAuthContext } = await import("../../credential/cli-auth-context.mjs");
+			const { createCredentialStore } = await import("../../credential/store.mjs");
+			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 import("../../config/afs-loader.mjs");
+			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 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 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 mountValidateCommand(options.cwd ?? process.cwd());
+			options.onResult({
+				command: "mount validate",
+				result,
+				format: formatMountValidateOutput,
+				error: result.valid ? void 0 : { message: result.errors.join("; ") }
+			});
+		}
+	};
+}
+
+//#endregion
+export { createMountCommand };
+//# sourceMappingURL=mount.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mount.mjs","names":[],"sources":["../../../src/core/commands/mount.ts"],"sourcesContent":["/**\n * mount Command - Core Implementation\n *\n * Mount management commands for config file operations.\n * Changes are persisted to .afs-config/config.toml.\n */\n\nimport type { Argv, CommandModule } from \"yargs\";\nimport {\n  configMountListCommand,\n  type MountValidateResult,\n  mountRemoveCommand,\n  mountValidateCommand,\n  persistMount,\n  resolveUriPath,\n} from \"../../config/mount-commands.js\";\nimport { MountSchema } from \"../../config/schema.js\";\nimport { formatMountListOutput } from \"../formatters/index.js\";\nimport type { ViewType } from \"../types.js\";\nimport type { CommandFactoryOptions } from \"./types.js\";\n\n/**\n * Mount list subcommand arguments\n */\nexport interface MountListArgs {\n  namespace?: string;\n}\n\n/**\n * Mount add subcommand arguments\n */\nexport interface MountAddArgs {\n  path: string;\n  uri: string;\n  namespace?: string;\n  description?: string;\n  \"sensitive-args\"?: string[];\n  [key: string]: unknown;\n}\n\n/**\n * Mount remove subcommand arguments\n */\nexport interface MountRemoveArgs {\n  path: string;\n  namespace?: string;\n}\n\n/**\n * Create mount command factory (with subcommands)\n */\nexport function createMountCommand(options: CommandFactoryOptions): CommandModule {\n  return {\n    command: \"mount\",\n    describe: \"Mount management\",\n    builder: (yargs: Argv) =>\n      yargs\n        .command(createMountListSubcommand(options))\n        .command(createMountAddSubcommand(options))\n        .command(createMountRemoveSubcommand(options))\n        .command(createMountValidateSubcommand(options))\n        .demandCommand(1, \"Please specify a subcommand\")\n        .alias(\"help\", \"h\"),\n    handler: () => {},\n  };\n}\n\n/**\n * Create mount list subcommand\n */\nfunction createMountListSubcommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, MountListArgs> {\n  return {\n    command: [\"list\", \"ls\"],\n    describe: \"List all mounts\",\n    builder: {\n      namespace: {\n        type: \"string\",\n        description: \"Filter by namespace\",\n      },\n    },\n    handler: async () => {\n      const cwd = options.cwd ?? process.cwd();\n      const result = await configMountListCommand(cwd);\n      options.onResult({\n        command: \"mount list\",\n        result: result.mounts,\n        format: formatMountListOutput,\n      });\n    },\n  };\n}\n\n/**\n * Create mount add subcommand\n */\n/** Known argv keys that are NOT provider options */\nconst KNOWN_MOUNT_KEYS = new Set([\n  \"path\",\n  \"uri\",\n  \"namespace\",\n  \"description\",\n  \"sensitive-args\",\n  \"sensitiveArgs\",\n  \"_\",\n  \"$0\",\n  \"help\",\n  \"h\",\n  \"version\",\n  \"v\",\n  // Global options from executor\n  \"json\",\n  \"yaml\",\n  \"view\",\n  \"interactive\",\n]);\n\nfunction createMountAddSubcommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, MountAddArgs> {\n  return {\n    command: \"add <path> <uri>\",\n    describe: \"Add a mount\",\n    builder: (yargs) =>\n      yargs\n        .strict(false)\n        .positional(\"path\", {\n          type: \"string\",\n          demandOption: true,\n          description: \"Mount path (e.g., /src)\",\n        })\n        .positional(\"uri\", {\n          type: \"string\",\n          demandOption: true,\n          description: \"Provider URI (e.g., fs://./src)\",\n        })\n        .option(\"namespace\", {\n          type: \"string\",\n          description: \"Mount namespace\",\n        })\n        .option(\"description\", {\n          type: \"string\",\n          description: \"Mount description\",\n        })\n        .option(\"sensitive-args\", {\n          type: \"string\",\n          array: true,\n          description: \"Field names to treat as sensitive credentials\",\n        }) as Argv<MountAddArgs>,\n    handler: async (argv) => {\n      const cwd = options.cwd ?? process.cwd();\n\n      // Step 1: Validate and resolve URI\n      if (!argv.uri || argv.uri.trim() === \"\") {\n        throw new Error(\"URI is required\");\n      }\n      const resolvedUri = resolveUriPath(argv.uri, cwd);\n\n      const validation = MountSchema.safeParse({\n        path: argv.path,\n        uri: resolvedUri,\n        description: argv.description,\n      });\n      if (!validation.success) {\n        const errors = validation.error.issues.map((e) => e.message).join(\"; \");\n        throw new Error(errors);\n      }\n\n      // Collect extra options (any unknown --key value pairs)\n      const extraOptions: Record<string, unknown> = {};\n      for (const [key, value] of Object.entries(argv)) {\n        if (!KNOWN_MOUNT_KEYS.has(key) && !key.startsWith(\"-\")) {\n          extraOptions[key] = value;\n        }\n      }\n      const sensitiveArgs = argv[\"sensitive-args\"] ?? [];\n\n      // Step 2: Resolve credentials FIRST (opens browser if needed)\n      // This must happen before persisting mount config, so that if the user\n      // cancels, no incomplete mount is left in config.toml.\n      const { resolveCredentialsForMount } = await import(\"../../config/afs-loader.js\");\n      const { createCLIAuthContext } = await import(\"../../credential/cli-auth-context.js\");\n      const { createCredentialStore } = await import(\"../../credential/store.js\");\n\n      const authContext = createCLIAuthContext();\n      const credentialStore = createCredentialStore();\n      const credResolveOptions = {\n        cwd,\n        uri: resolvedUri,\n        mountPath: validation.data.path,\n        authContext,\n        credentialStore,\n        extraOptions: Object.keys(extraOptions).length > 0 ? extraOptions : undefined,\n        sensitiveArgs,\n      };\n\n      let credResult = await resolveCredentialsForMount(credResolveOptions);\n\n      // Step 3: Verify mount works before persisting\n      // Use all resolved values (including sensitive) for provider creation verification\n      const { verifyMount } = await import(\"../../config/afs-loader.js\");\n      let verifyOptions = { ...extraOptions, ...(credResult?.allValues ?? {}) };\n\n      try {\n        await verifyMount(\n          resolvedUri,\n          validation.data.path,\n          Object.keys(verifyOptions).length > 0 ? verifyOptions : undefined,\n        );\n      } catch (verifyError) {\n        // Health check failed with silently resolved credentials →\n        // retry once with forced interactive collection so user can fix values\n        if (credResult && !credResult.collected) {\n          credResult = await resolveCredentialsForMount({\n            ...credResolveOptions,\n            forceCollect: true,\n          });\n          verifyOptions = { ...extraOptions, ...(credResult?.allValues ?? {}) };\n          await verifyMount(\n            resolvedUri,\n            validation.data.path,\n            Object.keys(verifyOptions).length > 0 ? verifyOptions : undefined,\n          );\n        } else {\n          throw verifyError;\n        }\n      }\n\n      // Step 4: Persist credentials (only after health check succeeds) and mount config\n      if (credResult) {\n        await credResult.persistCredentials();\n      }\n\n      const nonSensitiveFromCreds = credResult?.nonSensitive ?? {};\n      const mountOptions = { ...extraOptions, ...nonSensitiveFromCreds };\n      // Strip sensitive fields — they go to credentials.toml, not config.toml\n      if (credResult?.sensitiveFields) {\n        for (const field of credResult.sensitiveFields) {\n          delete mountOptions[field];\n        }\n      }\n      const finalMountOptions = Object.keys(mountOptions).length > 0 ? mountOptions : undefined;\n\n      // Use configUri (env params stripped) for config.toml — env values are in credentials.toml\n      const persistUri = credResult?.configUri ?? validation.data.uri;\n\n      const result = await persistMount(cwd, {\n        path: validation.data.path,\n        uri: persistUri,\n        description: argv.description,\n        options: finalMountOptions,\n      });\n      if (!result.success) {\n        throw new Error(result.message ?? \"Failed to add mount\");\n      }\n\n      options.onResult({\n        command: \"mount add\",\n        result: { success: true, path: argv.path, uri: resolvedUri },\n        format: (res: { path: string; uri: string }) => `Mounted ${res.uri} at ${res.path}`,\n      });\n    },\n  };\n}\n\n/**\n * Create mount remove subcommand\n */\nfunction createMountRemoveSubcommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, MountRemoveArgs> {\n  return {\n    command: [\"remove <path>\", \"rm <path>\"],\n    describe: \"Unmount a path\",\n    builder: {\n      path: {\n        type: \"string\",\n        demandOption: true,\n        description: \"Mount path to remove\",\n      },\n      namespace: {\n        type: \"string\",\n        description: \"Namespace of the mount\",\n      },\n    },\n    handler: async (argv) => {\n      const cwd = options.cwd ?? process.cwd();\n      const result = await mountRemoveCommand(cwd, argv.path);\n      if (!result.success) {\n        throw new Error(result.message ?? \"Failed to remove mount\");\n      }\n      options.onResult({\n        command: \"mount remove\",\n        result: { success: true, path: argv.path },\n        format: (res: { success: boolean; path: string }) =>\n          res.success ? `Unmounted ${res.path}` : `Failed to unmount ${res.path}`,\n      });\n    },\n  };\n}\n\n/**\n * Format mount validate output\n */\nfunction formatMountValidateOutput(result: MountValidateResult, view?: ViewType): string {\n  if (view === \"json\") {\n    return JSON.stringify(result, null, 2);\n  }\n\n  if (result.valid) {\n    return \"Configuration is valid\";\n  }\n\n  const lines = [\"Configuration validation failed:\", ...result.errors.map((e) => `  - ${e}`)];\n  return lines.join(\"\\n\");\n}\n\n/**\n * Create mount validate subcommand\n */\nfunction createMountValidateSubcommand(options: CommandFactoryOptions): CommandModule {\n  return {\n    command: \"validate\",\n    describe: \"Validate mount configuration\",\n    handler: async () => {\n      const cwd = options.cwd ?? process.cwd();\n      const result = await mountValidateCommand(cwd);\n\n      options.onResult({\n        command: \"mount validate\",\n        result,\n        format: formatMountValidateOutput,\n        error: result.valid ? undefined : { message: result.errors.join(\"; \") },\n      });\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/core/commands/read.cjs

@@ -0,0 +1,48 @@
+const require_read = require('../formatters/read.cjs');
+const require_path_utils = require('../../path-utils.cjs');
+require('../path-utils.cjs');
+const require_types = require('./types.cjs');
+
+//#region src/core/commands/read.ts
+/**
+* Create read command factory
+*/
+function createReadCommand(options) {
+	return {
+		command: "read <path>",
+		describe: "Read file content",
+		builder: { path: {
+			type: "string",
+			demandOption: true,
+			description: "Path to read"
+		} },
+		handler: async (argv) => {
+			const afs = await require_types.resolveAFS(options);
+			const canonicalPath = require_path_utils.cliPathToCanonical(argv.path);
+			const result = await afs.read(canonicalPath);
+			if (result.data) {
+				result.data.path = argv.path;
+				const isMeta = argv.path.endsWith("/.meta") || argv.path.includes("/.meta/");
+				const isAction = argv.path.includes("/.actions");
+				if (!isMeta && !isAction) try {
+					const statResult = await afs.stat(canonicalPath);
+					if (statResult.data) {
+						result.data.meta = {
+							...result.data.meta,
+							...statResult.data.meta
+						};
+						result.data.actions = statResult.data.actions;
+					}
+				} catch {}
+			}
+			options.onResult({
+				command: "read",
+				result,
+				format: require_read.formatReadOutput
+			});
+		}
+	};
+}
+
+//#endregion
+exports.createReadCommand = createReadCommand;

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

@@ -0,0 +1,17 @@
+import { CommandFactoryOptions } from "./types.cjs";
+import { CommandModule } from "yargs";
+
+//#region src/core/commands/read.d.ts
+/**
+ * Read command arguments
+ */
+interface ReadArgs {
+  path: string;
+}
+/**
+ * Create read command factory
+ */
+declare function createReadCommand(options: CommandFactoryOptions): CommandModule<unknown, ReadArgs>;
+//#endregion
+export { ReadArgs, createReadCommand };
+//# sourceMappingURL=read.d.cts.map

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

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

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

@@ -0,0 +1,17 @@
+import { CommandFactoryOptions } from "./types.mjs";
+import { CommandModule } from "yargs";
+
+//#region src/core/commands/read.d.ts
+/**
+ * Read command arguments
+ */
+interface ReadArgs {
+  path: string;
+}
+/**
+ * Create read command factory
+ */
+declare function createReadCommand(options: CommandFactoryOptions): CommandModule<unknown, ReadArgs>;
+//#endregion
+export { ReadArgs, createReadCommand };
+//# sourceMappingURL=read.d.mts.map

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

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

package/dist/core/commands/read.mjs

@@ -0,0 +1,49 @@
+import { formatReadOutput } from "../formatters/read.mjs";
+import { cliPathToCanonical } from "../../path-utils.mjs";
+import "../path-utils.mjs";
+import { resolveAFS } from "./types.mjs";
+
+//#region src/core/commands/read.ts
+/**
+* Create read command factory
+*/
+function createReadCommand(options) {
+	return {
+		command: "read <path>",
+		describe: "Read file content",
+		builder: { path: {
+			type: "string",
+			demandOption: true,
+			description: "Path to read"
+		} },
+		handler: async (argv) => {
+			const afs = await resolveAFS(options);
+			const canonicalPath = cliPathToCanonical(argv.path);
+			const result = await afs.read(canonicalPath);
+			if (result.data) {
+				result.data.path = argv.path;
+				const isMeta = argv.path.endsWith("/.meta") || argv.path.includes("/.meta/");
+				const isAction = argv.path.includes("/.actions");
+				if (!isMeta && !isAction) try {
+					const statResult = await afs.stat(canonicalPath);
+					if (statResult.data) {
+						result.data.meta = {
+							...result.data.meta,
+							...statResult.data.meta
+						};
+						result.data.actions = statResult.data.actions;
+					}
+				} catch {}
+			}
+			options.onResult({
+				command: "read",
+				result,
+				format: formatReadOutput
+			});
+		}
+	};
+}
+
+//#endregion
+export { createReadCommand };
+//# sourceMappingURL=read.mjs.map

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

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

package/dist/core/commands/search.cjs

@@ -0,0 +1,40 @@
+const require_search = require('../formatters/search.cjs');
+const require_path_utils = require('../../path-utils.cjs');
+require('../path-utils.cjs');
+const require_types = require('./types.cjs');
+
+//#region src/core/commands/search.ts
+/**
+* Create search command factory
+*/
+function createSearchCommand(options) {
+	return {
+		command: "search <path> <query>",
+		describe: "Search for content within an AFS path",
+		builder: {
+			path: {
+				type: "string",
+				demandOption: true,
+				description: "Path to search in"
+			},
+			query: {
+				type: "string",
+				demandOption: true,
+				description: "Search query"
+			}
+		},
+		handler: async (argv) => {
+			const afs = await require_types.resolveAFS(options);
+			const canonicalPath = require_path_utils.cliPathToCanonical(argv.path);
+			const result = await afs.search(canonicalPath, argv.query);
+			options.onResult({
+				command: "search",
+				result,
+				format: require_search.formatSearchOutput
+			});
+		}
+	};
+}
+
+//#endregion
+exports.createSearchCommand = createSearchCommand;

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

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

package/dist/core/commands/search.mjs

@@ -0,0 +1,41 @@
+import { formatSearchOutput } from "../formatters/search.mjs";
+import { cliPathToCanonical } from "../../path-utils.mjs";
+import "../path-utils.mjs";
+import { resolveAFS } from "./types.mjs";
+
+//#region src/core/commands/search.ts
+/**
+* Create search command factory
+*/
+function createSearchCommand(options) {
+	return {
+		command: "search <path> <query>",
+		describe: "Search for content within an AFS path",
+		builder: {
+			path: {
+				type: "string",
+				demandOption: true,
+				description: "Path to search in"
+			},
+			query: {
+				type: "string",
+				demandOption: true,
+				description: "Search query"
+			}
+		},
+		handler: async (argv) => {
+			const afs = await resolveAFS(options);
+			const canonicalPath = cliPathToCanonical(argv.path);
+			const result = await afs.search(canonicalPath, argv.query);
+			options.onResult({
+				command: "search",
+				result,
+				format: formatSearchOutput
+			});
+		}
+	};
+}
+
+//#endregion
+export { createSearchCommand };
+//# sourceMappingURL=search.mjs.map

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

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