@aigne/afs-cli 1.11.0-beta.10 → 1.11.0-beta.12

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

@@ -1 +1 @@
-{"version":3,"file":"write.d.mts","names":[],"sources":["../../../src/core/commands/write.ts"],"mappings":";;;;;;;UAgBiB,SAAA;EACf,IAAA;EACA,OAAA;EACA,MAAA;EACA,IAAA;AAAA;;;;iBAwBc,kBAAA,CACd,OAAA,EAAS,qBAAA,GACR,aAAA,UAAuB,SAAA"}
+{"version":3,"file":"write.d.mts","names":[],"sources":["../../../src/core/commands/write.ts"],"mappings":";;;;;;;UAgBiB,SAAA;EACf,IAAA;EACA,OAAA;EACA,IAAA;EACA,KAAA;EACA,IAAA;AAAA;;;;iBAwBc,kBAAA,CACd,OAAA,EAAS,qBAAA,GACR,aAAA,UAAuB,SAAA"}

package/dist/core/commands/write.mjs

@@ -36,10 +36,22 @@ function createWriteCommand(options) {
 				type: "string",
 				description: "Content to write"
 			},
-			append: {
-				type: "boolean",
-				description: "Append to file instead of overwriting",
-				default: false
+			mode: {
+				type: "string",
+				choices: [
+					"replace",
+					"append",
+					"prepend",
+					"patch",
+					"create",
+					"update"
+				],
+				description: "Write mode",
+				default: "replace"
+			},
+			patch: {
+				type: "string",
+				description: "JSON array of patch operations (for mode=patch)"
 			},
 			meta: {
 				type: "string",
@@ -50,13 +62,14 @@ function createWriteCommand(options) {
 		handler: async (argv) => {
 			const metadata = parseMetaValues(argv.meta);
 			const fields = metadata ? Object.keys(metadata) : void 0;
-			if (argv.content === void 0 && !metadata) throw new Error("write requires content (use --content or provide as second argument)");
+			if (argv.content === void 0 && !metadata && argv.mode !== "patch") throw new Error("write requires content (use --content or provide as second argument)");
 			const afs = await resolveAFS(options);
 			const canonicalPath = cliPathToCanonical(argv.path);
 			const writeData = {};
 			if (argv.content !== void 0) writeData.content = argv.content;
 			if (metadata) writeData.meta = metadata;
-			const result = await afs.write(canonicalPath, writeData, { append: argv.append });
+			if (argv.patch) writeData.patches = JSON.parse(argv.patch);
+			const result = await afs.write(canonicalPath, writeData, { mode: argv.mode });
 			options.onResult({
 				command: "write",
 				result,

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

@@ -1 +1 @@
-{"version":3,"file":"write.mjs","names":[],"sources":["../../../src/core/commands/write.ts"],"sourcesContent":["/**\n * write Command - Core Implementation\n *\n * Writes content to a file/node. Accepts AFS instance directly.\n * Returns AFSWriteResult directly (no custom type).\n */\n\nimport type { AFSWriteEntryPayload } from \"@aigne/afs\";\nimport type { CommandModule } from \"yargs\";\nimport { formatWriteOutput } from \"../formatters/index.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\n/**\n * Write command arguments\n */\nexport interface WriteArgs {\n  path: string;\n  content?: string;\n  append: boolean;\n  meta?: string[];\n}\n\n/**\n * Parse --meta values into metadata object\n */\nfunction parseMetaValues(metaValues?: string[]): Record<string, string> | undefined {\n  if (!metaValues || metaValues.length === 0) return undefined;\n\n  const meta: Record<string, string> = {};\n  for (const item of metaValues) {\n    const idx = item.indexOf(\"=\");\n    if (idx > 0) {\n      const key = item.slice(0, idx);\n      const value = item.slice(idx + 1);\n      meta[key] = value;\n    }\n  }\n  return Object.keys(meta).length > 0 ? meta : undefined;\n}\n\n/**\n * Create write command factory\n */\nexport function createWriteCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, WriteArgs> {\n  return {\n    command: \"write <path> [content]\",\n    describe: \"Write content to file\",\n    builder: {\n      path: {\n        type: \"string\",\n        demandOption: true,\n        description: \"Path to write\",\n      },\n      content: {\n        type: \"string\",\n        description: \"Content to write\",\n      },\n      append: {\n        type: \"boolean\",\n        description: \"Append to file instead of overwriting\",\n        default: false,\n      },\n      meta: {\n        type: \"string\",\n        array: true,\n        description: \"Set metadata field (key=value)\",\n      },\n    },\n    handler: async (argv) => {\n      const metadata = parseMetaValues(argv.meta);\n      const fields = metadata ? Object.keys(metadata) : undefined;\n\n      // Content is required unless only setting metadata\n      if (argv.content === undefined && !metadata) {\n        throw new Error(\"write requires content (use --content or provide as second argument)\");\n      }\n\n      const afs = await resolveAFS(options);\n      const canonicalPath = cliPathToCanonical(argv.path);\n      const writeData: AFSWriteEntryPayload = {};\n\n      if (argv.content !== undefined) {\n        writeData.content = argv.content;\n      }\n      if (metadata) {\n        writeData.meta = metadata;\n      }\n\n      const result = await afs.write(canonicalPath, writeData, { append: argv.append });\n      options.onResult({\n        command: \"write\",\n        result,\n        format: (res, view) => formatWriteOutput(res, view, { fields }),\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AA0BA,SAAS,gBAAgB,YAA2D;AAClF,KAAI,CAAC,cAAc,WAAW,WAAW,EAAG,QAAO;CAEnD,MAAM,OAA+B,EAAE;AACvC,MAAK,MAAM,QAAQ,YAAY;EAC7B,MAAM,MAAM,KAAK,QAAQ,IAAI;AAC7B,MAAI,MAAM,GAAG;GACX,MAAM,MAAM,KAAK,MAAM,GAAG,IAAI;AAE9B,QAAK,OADS,KAAK,MAAM,MAAM,EAAE;;;AAIrC,QAAO,OAAO,KAAK,KAAK,CAAC,SAAS,IAAI,OAAO;;;;;AAM/C,SAAgB,mBACd,SACmC;AACnC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS;GACP,MAAM;IACJ,MAAM;IACN,cAAc;IACd,aAAa;IACd;GACD,SAAS;IACP,MAAM;IACN,aAAa;IACd;GACD,QAAQ;IACN,MAAM;IACN,aAAa;IACb,SAAS;IACV;GACD,MAAM;IACJ,MAAM;IACN,OAAO;IACP,aAAa;IACd;GACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,WAAW,gBAAgB,KAAK,KAAK;GAC3C,MAAM,SAAS,WAAW,OAAO,KAAK,SAAS,GAAG;AAGlD,OAAI,KAAK,YAAY,UAAa,CAAC,SACjC,OAAM,IAAI,MAAM,uEAAuE;GAGzF,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,gBAAgB,mBAAmB,KAAK,KAAK;GACnD,MAAM,YAAkC,EAAE;AAE1C,OAAI,KAAK,YAAY,OACnB,WAAU,UAAU,KAAK;AAE3B,OAAI,SACF,WAAU,OAAO;GAGnB,MAAM,SAAS,MAAM,IAAI,MAAM,eAAe,WAAW,EAAE,QAAQ,KAAK,QAAQ,CAAC;AACjF,WAAQ,SAAS;IACf,SAAS;IACT;IACA,SAAS,KAAK,SAAS,kBAAkB,KAAK,MAAM,EAAE,QAAQ,CAAC;IAChE,CAAC;;EAEL"}
+{"version":3,"file":"write.mjs","names":[],"sources":["../../../src/core/commands/write.ts"],"sourcesContent":["/**\n * write Command - Core Implementation\n *\n * Writes content to a file/node. Accepts AFS instance directly.\n * Returns AFSWriteResult directly (no custom type).\n */\n\nimport type { AFSWriteEntryPayload } from \"@aigne/afs\";\nimport type { CommandModule } from \"yargs\";\nimport { formatWriteOutput } from \"../formatters/index.js\";\nimport { cliPathToCanonical } from \"../path-utils.js\";\nimport { type CommandFactoryOptions, resolveAFS } from \"./types.js\";\n\n/**\n * Write command arguments\n */\nexport interface WriteArgs {\n  path: string;\n  content?: string;\n  mode: \"replace\" | \"append\" | \"prepend\" | \"patch\" | \"create\" | \"update\";\n  patch?: string;\n  meta?: string[];\n}\n\n/**\n * Parse --meta values into metadata object\n */\nfunction parseMetaValues(metaValues?: string[]): Record<string, string> | undefined {\n  if (!metaValues || metaValues.length === 0) return undefined;\n\n  const meta: Record<string, string> = {};\n  for (const item of metaValues) {\n    const idx = item.indexOf(\"=\");\n    if (idx > 0) {\n      const key = item.slice(0, idx);\n      const value = item.slice(idx + 1);\n      meta[key] = value;\n    }\n  }\n  return Object.keys(meta).length > 0 ? meta : undefined;\n}\n\n/**\n * Create write command factory\n */\nexport function createWriteCommand(\n  options: CommandFactoryOptions,\n): CommandModule<unknown, WriteArgs> {\n  return {\n    command: \"write <path> [content]\",\n    describe: \"Write content to file\",\n    builder: {\n      path: {\n        type: \"string\",\n        demandOption: true,\n        description: \"Path to write\",\n      },\n      content: {\n        type: \"string\",\n        description: \"Content to write\",\n      },\n      mode: {\n        type: \"string\",\n        choices: [\"replace\", \"append\", \"prepend\", \"patch\", \"create\", \"update\"] as const,\n        description: \"Write mode\",\n        default: \"replace\" as const,\n      },\n      patch: {\n        type: \"string\",\n        description: \"JSON array of patch operations (for mode=patch)\",\n      },\n      meta: {\n        type: \"string\",\n        array: true,\n        description: \"Set metadata field (key=value)\",\n      },\n    },\n    handler: async (argv) => {\n      const metadata = parseMetaValues(argv.meta);\n      const fields = metadata ? Object.keys(metadata) : undefined;\n\n      // Content is required unless only setting metadata or using patch mode\n      if (argv.content === undefined && !metadata && argv.mode !== \"patch\") {\n        throw new Error(\"write requires content (use --content or provide as second argument)\");\n      }\n\n      const afs = await resolveAFS(options);\n      const canonicalPath = cliPathToCanonical(argv.path);\n      const writeData: AFSWriteEntryPayload = {};\n\n      if (argv.content !== undefined) {\n        writeData.content = argv.content;\n      }\n      if (metadata) {\n        writeData.meta = metadata;\n      }\n      if (argv.patch) {\n        writeData.patches = JSON.parse(argv.patch);\n      }\n\n      const result = await afs.write(canonicalPath, writeData, { mode: argv.mode });\n      options.onResult({\n        command: \"write\",\n        result,\n        format: (res, view) => formatWriteOutput(res, view, { fields }),\n      });\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AA2BA,SAAS,gBAAgB,YAA2D;AAClF,KAAI,CAAC,cAAc,WAAW,WAAW,EAAG,QAAO;CAEnD,MAAM,OAA+B,EAAE;AACvC,MAAK,MAAM,QAAQ,YAAY;EAC7B,MAAM,MAAM,KAAK,QAAQ,IAAI;AAC7B,MAAI,MAAM,GAAG;GACX,MAAM,MAAM,KAAK,MAAM,GAAG,IAAI;AAE9B,QAAK,OADS,KAAK,MAAM,MAAM,EAAE;;;AAIrC,QAAO,OAAO,KAAK,KAAK,CAAC,SAAS,IAAI,OAAO;;;;;AAM/C,SAAgB,mBACd,SACmC;AACnC,QAAO;EACL,SAAS;EACT,UAAU;EACV,SAAS;GACP,MAAM;IACJ,MAAM;IACN,cAAc;IACd,aAAa;IACd;GACD,SAAS;IACP,MAAM;IACN,aAAa;IACd;GACD,MAAM;IACJ,MAAM;IACN,SAAS;KAAC;KAAW;KAAU;KAAW;KAAS;KAAU;KAAS;IACtE,aAAa;IACb,SAAS;IACV;GACD,OAAO;IACL,MAAM;IACN,aAAa;IACd;GACD,MAAM;IACJ,MAAM;IACN,OAAO;IACP,aAAa;IACd;GACF;EACD,SAAS,OAAO,SAAS;GACvB,MAAM,WAAW,gBAAgB,KAAK,KAAK;GAC3C,MAAM,SAAS,WAAW,OAAO,KAAK,SAAS,GAAG;AAGlD,OAAI,KAAK,YAAY,UAAa,CAAC,YAAY,KAAK,SAAS,QAC3D,OAAM,IAAI,MAAM,uEAAuE;GAGzF,MAAM,MAAM,MAAM,WAAW,QAAQ;GACrC,MAAM,gBAAgB,mBAAmB,KAAK,KAAK;GACnD,MAAM,YAAkC,EAAE;AAE1C,OAAI,KAAK,YAAY,OACnB,WAAU,UAAU,KAAK;AAE3B,OAAI,SACF,WAAU,OAAO;AAEnB,OAAI,KAAK,MACP,WAAU,UAAU,KAAK,MAAM,KAAK,MAAM;GAG5C,MAAM,SAAS,MAAM,IAAI,MAAM,eAAe,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;AAC7E,WAAQ,SAAS;IACf,SAAS;IACT;IACA,SAAS,KAAK,SAAS,kBAAkB,KAAK,MAAM,EAAE,QAAQ,CAAC;IAChE,CAAC;;EAEL"}

package/dist/core/executor/index.cjs

@@ -4,6 +4,28 @@ let yargs = require("yargs");
 yargs = require_rolldown_runtime.__toESM(yargs);
 
 //#region src/core/executor/index.ts
+/** Known command names and aliases for suggestion matching. */
+const KNOWN_COMMANDS = [
+	"ls",
+	"list",
+	"read",
+	"cat",
+	"write",
+	"delete",
+	"rm",
+	"stat",
+	"exec",
+	"explain",
+	"search",
+	"grep",
+	"find",
+	"mount",
+	"serve",
+	"explore",
+	"service",
+	"connect",
+	"vault"
+];
 /**
 * AFS Command Executor
 *
@@ -43,6 +65,8 @@ var AFSCommandExecutor = class {
 				commandResult = result;
 			}
 		};
+		let failMsg;
+		let failErr;
 		let parser = (0, yargs.default)(normalizedArgs).scriptName("afs").usage("$0 <command> [options]").option("json", {
 			type: "boolean",
 			description: "Output in JSON format",
@@ -66,34 +90,42 @@ var AFSCommandExecutor = class {
 			type: "boolean",
 			description: "Start interactive REPL mode",
 			global: false
-		}).help(true).alias("h", "help").version(this.options.version || "unknown").alias("v", "version").demandCommand().showHelpOnFail(true).exitProcess(false);
+		}).help(true).alias("h", "help").version(this.options.version || "unknown").alias("v", "version").demandCommand().strictCommands().exitProcess(false).fail((msg, err) => {
+			failErr = err || new Error(msg || "Unknown error");
+			failMsg = msg;
+		});
 		for (const factory of require_index.commandFactories) parser = parser.command(factory(factoryOptions));
 		try {
 			let output;
-			let error;
-			const parsed = await parser.parseAsync(normalizedArgs, {}, (e, _, o) => {
-				if (e) error = e;
+			await parser.parseAsync(normalizedArgs, {}, (_e, _, o) => {
 				output = o;
 			});
-			if (error) return {
-				success: false,
-				command: normalizedArgs[0] || "unknown",
-				result: void 0,
-				formatted: output,
-				error: { message: error.message }
-			};
-			if (parsed.help) return {
+			if (failErr) {
+				const formatted$1 = await this.formatFailure(normalizedArgs, failMsg, parser);
+				return {
+					success: false,
+					command: normalizedArgs[0] || "unknown",
+					result: void 0,
+					formatted: formatted$1,
+					error: { message: failMsg || failErr.message }
+				};
+			}
+			if (output) return {
 				success: true,
 				command: "help",
 				formatted: output
 			};
-			if (parsed.version) return {
-				success: true,
-				command: "version",
-				formatted: output
-			};
-			if (!commandResult) throw new Error("Command not found");
-			const view = outputOptions.json ? "json" : outputOptions.yaml ? "yaml" : outputOptions.view;
+			if (!commandResult) {
+				const formatted$1 = await this.formatFailure(normalizedArgs, void 0, parser);
+				return {
+					success: false,
+					command: normalizedArgs[0] || "unknown",
+					result: void 0,
+					formatted: formatted$1,
+					error: { message: `Unknown command: "${normalizedArgs[0] || ""}"` }
+				};
+			}
+			const view = outputOptions.json ? "json" : outputOptions.yaml ? "yaml" : commandResult.viewOverride ?? outputOptions.view;
 			const formatted = commandResult.format(commandResult.result, view, { path: this.extractPath(normalizedArgs) });
 			if (commandResult.error) return {
 				success: false,
@@ -120,6 +152,31 @@ var AFSCommandExecutor = class {
 		}
 	}
 	/**
+	* Format a friendly error message for unknown/invalid commands.
+	*/
+	async formatFailure(args, failMsg, parser) {
+		const cmd = args[0] || "";
+		const lines = [];
+		if (cmd && failMsg?.includes("Unknown command")) {
+			lines.push(`Unknown command: "${cmd}"`);
+			const suggestions = suggestCommands(cmd);
+			if (suggestions.length > 0) {
+				lines.push("");
+				lines.push(`Did you mean?`);
+				for (const s of suggestions) lines.push(`  afs ${s}`);
+			}
+		} else if (failMsg) lines.push(failMsg);
+		else lines.push(`Unknown command: "${cmd}"`);
+		lines.push("");
+		try {
+			const helpText = await parser.getHelp();
+			lines.push(helpText);
+		} catch {
+			lines.push("Run \"afs --help\" to see available commands.");
+		}
+		return lines.join("\n");
+	}
+	/**
 	* Normalize argv to an array of strings
 	*/
 	normalizeArgv(argv) {
@@ -191,6 +248,25 @@ var AFSCommandExecutor = class {
 		}
 	}
 };
+/** Levenshtein distance between two strings. */
+function levenshtein(a, b) {
+	const m = a.length;
+	const n = b.length;
+	const dp = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0));
+	for (let i = 0; i <= m; i++) dp[i][0] = i;
+	for (let j = 0; j <= n; j++) dp[0][j] = j;
+	for (let i = 1; i <= m; i++) for (let j = 1; j <= n; j++) dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+	return dp[m][n];
+}
+/** Suggest known commands similar to the given input. */
+function suggestCommands(input) {
+	const lower = input.toLowerCase();
+	return KNOWN_COMMANDS.map((cmd) => ({
+		cmd,
+		dist: levenshtein(lower, cmd),
+		maxLen: Math.max(lower.length, cmd.length)
+	})).filter((x) => x.dist > 0 && x.dist < x.maxLen * .5).sort((a, b) => a.dist - b.dist).map((x) => x.cmd).slice(0, 3);
+}
 
 //#endregion
 exports.AFSCommandExecutor = AFSCommandExecutor;

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

@@ -55,6 +55,10 @@ declare class AFSCommandExecutor {
    * @returns Execution result with formatted output
    */
   execute(argv: string | string[]): Promise<ExecuteResult>;
+  /**
+   * Format a friendly error message for unknown/invalid commands.
+   */
+  private formatFailure;
   /**
    * Normalize argv to an array of strings
    */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/core/executor/index.ts"],"mappings":";;;;;;UAkBiB,aAAA;EAQf;EANA,OAAA;EAUE;EARF,OAAA;EAUS;EART,MAAA;EAee;EAbf,SAAA;;EAEA,KAAA;IAaA,qCAXE,IAAA,WAeF;IAbE,OAAA;EAAA;AAAA;;;;UAOa,eAAA;EAsCiC;EApChD,GAAA;EAoC+C;EAlC/C,GAAA;EAkBQ;EAhBR,OAAA;AAAA;;;;;;;;;;;;;cAeW,kBAAA;EAAA,QACH,GAAA;EAAA,QACA,OAAA;cAEI,GAAA,GAAM,GAAA,EAAK,OAAA,GAAU,eAAA;;;;;;;;;EAa3B,OAAA,CAAQ,IAAA,sBAA0B,OAAA,CAAQ,aAAA;;;;UA6IxC,aAAA;;;;UAoCA,QAAA;;;;UA2CA,oBAAA;;;;UA+BA,WAAA;AAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../src/core/executor/index.ts"],"mappings":";;;;;;UAkBiB,aAAA;EAQf;EANA,OAAA;EAUE;EARF,OAAA;EAUS;EART,MAAA;EAee;EAbf,SAAA;;EAEA,KAAA;IAaA,qCAXE,IAAA,WAeF;IAbE,OAAA;EAAA;AAAA;;;;UAOa,eAAA;EA6DiC;EA3DhD,GAAA;EA2D+C;EAzD/C,GAAA;EAyCQ;EAvCR,OAAA;AAAA;;;;;;;;;;;;;cAsCW,kBAAA;EAAA,QACH,GAAA;EAAA,QACA,OAAA;cAEI,GAAA,GAAM,GAAA,EAAK,OAAA,GAAU,eAAA;;;;;;;;;EAa3B,OAAA,CAAQ,IAAA,sBAA0B,OAAA,CAAQ,aAAA;;;;UAuJlC,aAAA;;;;UAwCN,aAAA;;;;UAoCA,QAAA;;;;UA2CA,oBAAA;;;;UA+BA,WAAA;AAAA"}

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

@@ -55,6 +55,10 @@ declare class AFSCommandExecutor {
    * @returns Execution result with formatted output
    */
   execute(argv: string | string[]): Promise<ExecuteResult>;
+  /**
+   * Format a friendly error message for unknown/invalid commands.
+   */
+  private formatFailure;
   /**
    * Normalize argv to an array of strings
    */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/executor/index.ts"],"mappings":";;;;;;UAkBiB,aAAA;EAQf;EANA,OAAA;EAUE;EARF,OAAA;EAUS;EART,MAAA;EAee;EAbf,SAAA;;EAEA,KAAA;IAaA,qCAXE,IAAA,WAeF;IAbE,OAAA;EAAA;AAAA;;;;UAOa,eAAA;EAsCiC;EApChD,GAAA;EAoC+C;EAlC/C,GAAA;EAkBQ;EAhBR,OAAA;AAAA;;;;;;;;;;;;;cAeW,kBAAA;EAAA,QACH,GAAA;EAAA,QACA,OAAA;cAEI,GAAA,GAAM,GAAA,EAAK,OAAA,GAAU,eAAA;;;;;;;;;EAa3B,OAAA,CAAQ,IAAA,sBAA0B,OAAA,CAAQ,aAAA;;;;UA6IxC,aAAA;;;;UAoCA,QAAA;;;;UA2CA,oBAAA;;;;UA+BA,WAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../src/core/executor/index.ts"],"mappings":";;;;;;UAkBiB,aAAA;EAQf;EANA,OAAA;EAUE;EARF,OAAA;EAUS;EART,MAAA;EAee;EAbf,SAAA;;EAEA,KAAA;IAaA,qCAXE,IAAA,WAeF;IAbE,OAAA;EAAA;AAAA;;;;UAOa,eAAA;EA6DiC;EA3DhD,GAAA;EA2D+C;EAzD/C,GAAA;EAyCQ;EAvCR,OAAA;AAAA;;;;;;;;;;;;;cAsCW,kBAAA;EAAA,QACH,GAAA;EAAA,QACA,OAAA;cAEI,GAAA,GAAM,GAAA,EAAK,OAAA,GAAU,eAAA;;;;;;;;;EAa3B,OAAA,CAAQ,IAAA,sBAA0B,OAAA,CAAQ,aAAA;;;;UAuJlC,aAAA;;;;UAwCN,aAAA;;;;UAoCA,QAAA;;;;UA2CA,oBAAA;;;;UA+BA,WAAA;AAAA"}

package/dist/core/executor/index.mjs

@@ -2,6 +2,28 @@ import { commandFactories } from "../commands/index.mjs";
 import yargs from "yargs";
 
 //#region src/core/executor/index.ts
+/** Known command names and aliases for suggestion matching. */
+const KNOWN_COMMANDS = [
+	"ls",
+	"list",
+	"read",
+	"cat",
+	"write",
+	"delete",
+	"rm",
+	"stat",
+	"exec",
+	"explain",
+	"search",
+	"grep",
+	"find",
+	"mount",
+	"serve",
+	"explore",
+	"service",
+	"connect",
+	"vault"
+];
 /**
 * AFS Command Executor
 *
@@ -41,6 +63,8 @@ var AFSCommandExecutor = class {
 				commandResult = result;
 			}
 		};
+		let failMsg;
+		let failErr;
 		let parser = yargs(normalizedArgs).scriptName("afs").usage("$0 <command> [options]").option("json", {
 			type: "boolean",
 			description: "Output in JSON format",
@@ -64,34 +88,42 @@ var AFSCommandExecutor = class {
 			type: "boolean",
 			description: "Start interactive REPL mode",
 			global: false
-		}).help(true).alias("h", "help").version(this.options.version || "unknown").alias("v", "version").demandCommand().showHelpOnFail(true).exitProcess(false);
+		}).help(true).alias("h", "help").version(this.options.version || "unknown").alias("v", "version").demandCommand().strictCommands().exitProcess(false).fail((msg, err) => {
+			failErr = err || new Error(msg || "Unknown error");
+			failMsg = msg;
+		});
 		for (const factory of commandFactories) parser = parser.command(factory(factoryOptions));
 		try {
 			let output;
-			let error;
-			const parsed = await parser.parseAsync(normalizedArgs, {}, (e, _, o) => {
-				if (e) error = e;
+			await parser.parseAsync(normalizedArgs, {}, (_e, _, o) => {
 				output = o;
 			});
-			if (error) return {
-				success: false,
-				command: normalizedArgs[0] || "unknown",
-				result: void 0,
-				formatted: output,
-				error: { message: error.message }
-			};
-			if (parsed.help) return {
+			if (failErr) {
+				const formatted$1 = await this.formatFailure(normalizedArgs, failMsg, parser);
+				return {
+					success: false,
+					command: normalizedArgs[0] || "unknown",
+					result: void 0,
+					formatted: formatted$1,
+					error: { message: failMsg || failErr.message }
+				};
+			}
+			if (output) return {
 				success: true,
 				command: "help",
 				formatted: output
 			};
-			if (parsed.version) return {
-				success: true,
-				command: "version",
-				formatted: output
-			};
-			if (!commandResult) throw new Error("Command not found");
-			const view = outputOptions.json ? "json" : outputOptions.yaml ? "yaml" : outputOptions.view;
+			if (!commandResult) {
+				const formatted$1 = await this.formatFailure(normalizedArgs, void 0, parser);
+				return {
+					success: false,
+					command: normalizedArgs[0] || "unknown",
+					result: void 0,
+					formatted: formatted$1,
+					error: { message: `Unknown command: "${normalizedArgs[0] || ""}"` }
+				};
+			}
+			const view = outputOptions.json ? "json" : outputOptions.yaml ? "yaml" : commandResult.viewOverride ?? outputOptions.view;
 			const formatted = commandResult.format(commandResult.result, view, { path: this.extractPath(normalizedArgs) });
 			if (commandResult.error) return {
 				success: false,
@@ -118,6 +150,31 @@ var AFSCommandExecutor = class {
 		}
 	}
 	/**
+	* Format a friendly error message for unknown/invalid commands.
+	*/
+	async formatFailure(args, failMsg, parser) {
+		const cmd = args[0] || "";
+		const lines = [];
+		if (cmd && failMsg?.includes("Unknown command")) {
+			lines.push(`Unknown command: "${cmd}"`);
+			const suggestions = suggestCommands(cmd);
+			if (suggestions.length > 0) {
+				lines.push("");
+				lines.push(`Did you mean?`);
+				for (const s of suggestions) lines.push(`  afs ${s}`);
+			}
+		} else if (failMsg) lines.push(failMsg);
+		else lines.push(`Unknown command: "${cmd}"`);
+		lines.push("");
+		try {
+			const helpText = await parser.getHelp();
+			lines.push(helpText);
+		} catch {
+			lines.push("Run \"afs --help\" to see available commands.");
+		}
+		return lines.join("\n");
+	}
+	/**
 	* Normalize argv to an array of strings
 	*/
 	normalizeArgv(argv) {
@@ -189,6 +246,25 @@ var AFSCommandExecutor = class {
 		}
 	}
 };
+/** Levenshtein distance between two strings. */
+function levenshtein(a, b) {
+	const m = a.length;
+	const n = b.length;
+	const dp = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0));
+	for (let i = 0; i <= m; i++) dp[i][0] = i;
+	for (let j = 0; j <= n; j++) dp[0][j] = j;
+	for (let i = 1; i <= m; i++) for (let j = 1; j <= n; j++) dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+	return dp[m][n];
+}
+/** Suggest known commands similar to the given input. */
+function suggestCommands(input) {
+	const lower = input.toLowerCase();
+	return KNOWN_COMMANDS.map((cmd) => ({
+		cmd,
+		dist: levenshtein(lower, cmd),
+		maxLen: Math.max(lower.length, cmd.length)
+	})).filter((x) => x.dist > 0 && x.dist < x.maxLen * .5).sort((a, b) => a.dist - b.dist).map((x) => x.cmd).slice(0, 3);
+}
 
 //#endregion
 export { AFSCommandExecutor };

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

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/core/executor/index.ts"],"sourcesContent":["/**\n * AFS Command Executor\n *\n * Unified command execution interface using yargs and CommandFactory pattern.\n */\n\nimport type { AFS } from \"@aigne/afs\";\nimport yargs from \"yargs\";\nimport {\n  type CommandFactoryOptions,\n  type CommandOutput,\n  commandFactories,\n} from \"../commands/index.js\";\nimport type { ViewType } from \"../types.js\";\n\n/**\n * Result from executing a command\n */\nexport interface ExecuteResult {\n  /** Whether the command executed successfully */\n  success: boolean;\n  /** The command that was executed (ls, read, write, etc.) */\n  command: string;\n  /** The raw result data from AFS */\n  result?: unknown;\n  /** Formatted output string */\n  formatted: string;\n  /** Error info if the command failed */\n  error?: {\n    /** Exit code (from ExitCode enum) */\n    code?: number;\n    /** Error message */\n    message: string;\n  };\n}\n\n/**\n * Options for the executor\n */\nexport interface ExecutorOptions {\n  /** Whether the output is for a TTY (enables colors) */\n  tty?: boolean;\n  /** Current working directory (for explore command) */\n  cwd?: string;\n  /** Version of the AFS CLI */\n  version?: string;\n}\n\n/**\n * AFS Command Executor\n *\n * Provides a unified interface for executing AFS commands using yargs.\n *\n * @example\n * ```typescript\n * const executor = new AFSCommandExecutor(afs, { tty: false });\n * const result = await executor.execute(\"afs ls /path --depth=2\");\n * console.log(result.formatted);\n * ```\n */\nexport class AFSCommandExecutor {\n  private afs?: AFS;\n  private options: ExecutorOptions;\n\n  constructor(afs?: AFS, options?: ExecutorOptions) {\n    this.afs = afs;\n    this.options = options ?? {};\n  }\n\n  /**\n   * Execute an AFS command\n   *\n   * @param argv - Command string or array of arguments\n   *   - String: \"afs ls /path --depth=2\" or \"ls /path --depth=2\"\n   *   - Array: [\"ls\", \"/path\", \"--depth=2\"]\n   * @returns Execution result with formatted output\n   */\n  async execute(argv: string | string[]): Promise<ExecuteResult> {\n    const normalizedArgs = this.normalizeArgv(argv);\n\n    // Capture command result\n    let commandResult: CommandOutput | undefined;\n\n    // Determine output format from args\n    const outputOptions = this.extractOutputOptions(normalizedArgs);\n\n    // Create factory options\n    const factoryOptions: CommandFactoryOptions = {\n      afs: this.afs,\n      argv: normalizedArgs,\n      cwd: this.options.cwd,\n      onResult: (result) => {\n        commandResult = result;\n      },\n    };\n\n    // Build yargs parser with all commands\n    let parser = yargs(normalizedArgs)\n      .scriptName(\"afs\")\n      .usage(\"$0 <command> [options]\")\n      .option(\"json\", {\n        type: \"boolean\",\n        description: \"Output in JSON format\",\n        global: true,\n      })\n      .option(\"yaml\", {\n        type: \"boolean\",\n        description: \"Output in YAML format\",\n        global: true,\n      })\n      .option(\"view\", {\n        type: \"string\",\n        choices: [\"default\", \"llm\", \"human\"],\n        default: \"default\",\n        description: \"Output view format\",\n        global: true,\n      })\n      .option(\"interactive\", {\n        alias: \"i\",\n        type: \"boolean\",\n        description: \"Start interactive REPL mode\",\n        global: false,\n      })\n      .help(true)\n      .alias(\"h\", \"help\")\n      .version(this.options.version || \"unknown\")\n      .alias(\"v\", \"version\")\n      .demandCommand()\n      .showHelpOnFail(true)\n      .exitProcess(false);\n\n    // Register all commands from factories\n    for (const factory of commandFactories) {\n      parser = parser.command(factory(factoryOptions));\n    }\n\n    // Parse and execute\n    try {\n      let output: string | undefined;\n      let error: Error | undefined;\n\n      const parsed = await parser.parseAsync(normalizedArgs, {}, (e, _, o) => {\n        if (e) error = e;\n        output = o;\n      });\n\n      if (error) {\n        return {\n          success: false,\n          command: normalizedArgs[0] || \"unknown\",\n          result: undefined,\n          formatted: output!,\n          error: { message: error.message },\n        };\n      }\n\n      if (parsed.help) {\n        return {\n          success: true,\n          command: \"help\",\n          formatted: output!,\n        };\n      }\n      if (parsed.version) {\n        return {\n          success: true,\n          command: \"version\",\n          formatted: output!,\n        };\n      }\n\n      if (!commandResult) {\n        throw new Error(\"Command not found\");\n      }\n\n      // Always use the formatter - it handles json/llm/human views\n      const view: ViewType = outputOptions.json\n        ? \"json\"\n        : outputOptions.yaml\n          ? \"yaml\"\n          : outputOptions.view;\n      const formatted = commandResult.format(commandResult.result, view, {\n        path: this.extractPath(normalizedArgs),\n      });\n\n      // Check if command indicated failure\n      if (commandResult.error) {\n        return {\n          success: false,\n          command: commandResult.command,\n          result: commandResult.result,\n          formatted,\n          error: commandResult.error,\n        };\n      }\n\n      return {\n        success: true,\n        command: commandResult.command,\n        result: commandResult.result,\n        formatted,\n      };\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n\n      return {\n        success: false,\n        command: normalizedArgs[0] || \"unknown\",\n        result: undefined,\n        formatted: `ERROR: ${errorMessage}`,\n        error: { message: errorMessage },\n      };\n    }\n  }\n\n  /**\n   * Normalize argv to an array of strings\n   */\n  private normalizeArgv(argv: string | string[]): string[] {\n    if (typeof argv === \"string\") {\n      // Parse quoted strings properly\n      return this.tokenize(argv);\n    }\n\n    // Filter array input\n    const filtered: string[] = [];\n    let foundCommand = false;\n\n    for (const arg of argv) {\n      // Skip node and script paths (for process.argv format)\n      if (\n        !foundCommand &&\n        (arg.includes(\"node\") || arg.includes(\"bun\") || arg.endsWith(\".js\") || arg.endsWith(\".ts\"))\n      ) {\n        continue;\n      }\n\n      // Skip \"afs\" prefix\n      if (!foundCommand && arg === \"afs\") {\n        continue;\n      }\n\n      filtered.push(arg);\n      if (!arg.startsWith(\"-\")) {\n        foundCommand = true;\n      }\n    }\n\n    return filtered;\n  }\n\n  /**\n   * Tokenize a command string, respecting quotes\n   */\n  private tokenize(input: string): string[] {\n    const tokens: string[] = [];\n    let current = \"\";\n    let inQuote = false;\n    let quoteChar = \"\";\n\n    for (let i = 0; i < input.length; i++) {\n      const char = input[i]!;\n\n      if (inQuote) {\n        if (char === quoteChar) {\n          inQuote = false;\n        } else {\n          current += char;\n        }\n      } else if (char === '\"' || char === \"'\") {\n        inQuote = true;\n        quoteChar = char;\n      } else if (char === \" \" || char === \"\\t\") {\n        if (current) {\n          tokens.push(current);\n          current = \"\";\n        }\n      } else {\n        current += char;\n      }\n    }\n\n    if (current) {\n      tokens.push(current);\n    }\n\n    // Filter out \"afs\" prefix if present\n    if (tokens[0] === \"afs\") {\n      tokens.shift();\n    }\n\n    return tokens;\n  }\n\n  /**\n   * Extract output options from args\n   */\n  private extractOutputOptions(args: string[]): {\n    json: boolean;\n    yaml: boolean;\n    view: ViewType;\n  } {\n    let json = false;\n    let yaml = false;\n    let view: ViewType | undefined;\n\n    for (let i = 0; i < args.length; i++) {\n      const arg = args[i]!;\n      if (arg === \"--json\") json = true;\n      if (arg === \"--yaml\") yaml = true;\n      if (arg.startsWith(\"--view=\")) {\n        view = arg.slice(7) as ViewType;\n      } else if (arg === \"--view\" && args[i + 1] && !args[i + 1]!.startsWith(\"-\")) {\n        view = args[i + 1] as ViewType;\n      }\n    }\n\n    // Default to human view in TTY, default otherwise\n    if (!view) {\n      view = this.options.tty ? \"human\" : \"default\";\n    }\n\n    return { json, yaml, view };\n  }\n\n  /**\n   * Extract path from args (first non-option argument after command)\n   */\n  private extractPath(args: string[]): string | undefined {\n    for (let i = 1; i < args.length; i++) {\n      const arg = args[i]!;\n      if (!arg.startsWith(\"-\")) {\n        return arg;\n      }\n    }\n    return undefined;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["formatted"],"sources":["../../../src/core/executor/index.ts"],"sourcesContent":["/**\n * AFS Command Executor\n *\n * Unified command execution interface using yargs and CommandFactory pattern.\n */\n\nimport type { AFS } from \"@aigne/afs\";\nimport yargs from \"yargs\";\nimport {\n  type CommandFactoryOptions,\n  type CommandOutput,\n  commandFactories,\n} from \"../commands/index.js\";\nimport type { ViewType } from \"../types.js\";\n\n/**\n * Result from executing a command\n */\nexport interface ExecuteResult {\n  /** Whether the command executed successfully */\n  success: boolean;\n  /** The command that was executed (ls, read, write, etc.) */\n  command: string;\n  /** The raw result data from AFS */\n  result?: unknown;\n  /** Formatted output string */\n  formatted: string;\n  /** Error info if the command failed */\n  error?: {\n    /** Exit code (from ExitCode enum) */\n    code?: number;\n    /** Error message */\n    message: string;\n  };\n}\n\n/**\n * Options for the executor\n */\nexport interface ExecutorOptions {\n  /** Whether the output is for a TTY (enables colors) */\n  tty?: boolean;\n  /** Current working directory (for explore command) */\n  cwd?: string;\n  /** Version of the AFS CLI */\n  version?: string;\n}\n\n/** Known command names and aliases for suggestion matching. */\nconst KNOWN_COMMANDS = [\n  \"ls\",\n  \"list\",\n  \"read\",\n  \"cat\",\n  \"write\",\n  \"delete\",\n  \"rm\",\n  \"stat\",\n  \"exec\",\n  \"explain\",\n  \"search\",\n  \"grep\",\n  \"find\",\n  \"mount\",\n  \"serve\",\n  \"explore\",\n  \"service\",\n  \"connect\",\n  \"vault\",\n];\n\n/**\n * AFS Command Executor\n *\n * Provides a unified interface for executing AFS commands using yargs.\n *\n * @example\n * ```typescript\n * const executor = new AFSCommandExecutor(afs, { tty: false });\n * const result = await executor.execute(\"afs ls /path --depth=2\");\n * console.log(result.formatted);\n * ```\n */\nexport class AFSCommandExecutor {\n  private afs?: AFS;\n  private options: ExecutorOptions;\n\n  constructor(afs?: AFS, options?: ExecutorOptions) {\n    this.afs = afs;\n    this.options = options ?? {};\n  }\n\n  /**\n   * Execute an AFS command\n   *\n   * @param argv - Command string or array of arguments\n   *   - String: \"afs ls /path --depth=2\" or \"ls /path --depth=2\"\n   *   - Array: [\"ls\", \"/path\", \"--depth=2\"]\n   * @returns Execution result with formatted output\n   */\n  async execute(argv: string | string[]): Promise<ExecuteResult> {\n    const normalizedArgs = this.normalizeArgv(argv);\n\n    // Capture command result\n    let commandResult: CommandOutput | undefined;\n\n    // Determine output format from args\n    const outputOptions = this.extractOutputOptions(normalizedArgs);\n\n    // Create factory options\n    const factoryOptions: CommandFactoryOptions = {\n      afs: this.afs,\n      argv: normalizedArgs,\n      cwd: this.options.cwd,\n      onResult: (result) => {\n        commandResult = result;\n      },\n    };\n\n    // Capture fail() info so we can format errors ourselves\n    let failMsg: string | undefined;\n    let failErr: Error | undefined;\n\n    // Build yargs parser with all commands\n    let parser = yargs(normalizedArgs)\n      .scriptName(\"afs\")\n      .usage(\"$0 <command> [options]\")\n      .option(\"json\", {\n        type: \"boolean\",\n        description: \"Output in JSON format\",\n        global: true,\n      })\n      .option(\"yaml\", {\n        type: \"boolean\",\n        description: \"Output in YAML format\",\n        global: true,\n      })\n      .option(\"view\", {\n        type: \"string\",\n        choices: [\"default\", \"llm\", \"human\"],\n        default: \"default\",\n        description: \"Output view format\",\n        global: true,\n      })\n      .option(\"interactive\", {\n        alias: \"i\",\n        type: \"boolean\",\n        description: \"Start interactive REPL mode\",\n        global: false,\n      })\n      .help(true)\n      .alias(\"h\", \"help\")\n      .version(this.options.version || \"unknown\")\n      .alias(\"v\", \"version\")\n      .demandCommand()\n      .strictCommands()\n      .exitProcess(false)\n      .fail((msg, err) => {\n        // Prevent yargs from writing to stderr; we handle output ourselves.\n        failErr = err || new Error(msg || \"Unknown error\");\n        failMsg = msg;\n      });\n\n    // Register all commands from factories\n    for (const factory of commandFactories) {\n      parser = parser.command(factory(factoryOptions));\n    }\n\n    // Parse and execute\n    try {\n      let output: string | undefined;\n\n      await parser.parseAsync(normalizedArgs, {}, (_e, _, o) => {\n        output = o;\n      });\n\n      if (failErr) {\n        const formatted = await this.formatFailure(normalizedArgs, failMsg, parser);\n        return {\n          success: false,\n          command: normalizedArgs[0] || \"unknown\",\n          result: undefined,\n          formatted,\n          error: { message: failMsg || failErr.message },\n        };\n      }\n\n      if (output) {\n        // --help or --version produced output\n        return {\n          success: true,\n          command: \"help\",\n          formatted: output,\n        };\n      }\n\n      if (!commandResult) {\n        const formatted = await this.formatFailure(normalizedArgs, undefined, parser);\n        return {\n          success: false,\n          command: normalizedArgs[0] || \"unknown\",\n          result: undefined,\n          formatted,\n          error: { message: `Unknown command: \"${normalizedArgs[0] || \"\"}\"` },\n        };\n      }\n\n      // Always use the formatter - it handles json/llm/human views\n      // Explicit format flags (--json, --yaml, --view) take precedence over command viewOverride (e.g. -l)\n      const view: ViewType = outputOptions.json\n        ? \"json\"\n        : outputOptions.yaml\n          ? \"yaml\"\n          : (commandResult.viewOverride ?? outputOptions.view);\n      const formatted = commandResult.format(commandResult.result, view, {\n        path: this.extractPath(normalizedArgs),\n      });\n\n      // Check if command indicated failure\n      if (commandResult.error) {\n        return {\n          success: false,\n          command: commandResult.command,\n          result: commandResult.result,\n          formatted,\n          error: commandResult.error,\n        };\n      }\n\n      return {\n        success: true,\n        command: commandResult.command,\n        result: commandResult.result,\n        formatted,\n      };\n    } catch (error) {\n      const errorMessage = error instanceof Error ? error.message : String(error);\n\n      return {\n        success: false,\n        command: normalizedArgs[0] || \"unknown\",\n        result: undefined,\n        formatted: `ERROR: ${errorMessage}`,\n        error: { message: errorMessage },\n      };\n    }\n  }\n\n  /**\n   * Format a friendly error message for unknown/invalid commands.\n   */\n  private async formatFailure(\n    args: string[],\n    failMsg: string | undefined,\n    parser: ReturnType<typeof yargs>,\n  ): Promise<string> {\n    const cmd = args[0] || \"\";\n    const lines: string[] = [];\n\n    // Show what went wrong\n    if (cmd && failMsg?.includes(\"Unknown command\")) {\n      lines.push(`Unknown command: \"${cmd}\"`);\n      const suggestions = suggestCommands(cmd);\n      if (suggestions.length > 0) {\n        lines.push(\"\");\n        lines.push(`Did you mean?`);\n        for (const s of suggestions) {\n          lines.push(`  afs ${s}`);\n        }\n      }\n    } else if (failMsg) {\n      lines.push(failMsg);\n    } else {\n      lines.push(`Unknown command: \"${cmd}\"`);\n    }\n\n    // Append help text\n    lines.push(\"\");\n    try {\n      const helpText = await parser.getHelp();\n      lines.push(helpText);\n    } catch {\n      lines.push('Run \"afs --help\" to see available commands.');\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Normalize argv to an array of strings\n   */\n  private normalizeArgv(argv: string | string[]): string[] {\n    if (typeof argv === \"string\") {\n      // Parse quoted strings properly\n      return this.tokenize(argv);\n    }\n\n    // Filter array input\n    const filtered: string[] = [];\n    let foundCommand = false;\n\n    for (const arg of argv) {\n      // Skip node and script paths (for process.argv format)\n      if (\n        !foundCommand &&\n        (arg.includes(\"node\") || arg.includes(\"bun\") || arg.endsWith(\".js\") || arg.endsWith(\".ts\"))\n      ) {\n        continue;\n      }\n\n      // Skip \"afs\" prefix\n      if (!foundCommand && arg === \"afs\") {\n        continue;\n      }\n\n      filtered.push(arg);\n      if (!arg.startsWith(\"-\")) {\n        foundCommand = true;\n      }\n    }\n\n    return filtered;\n  }\n\n  /**\n   * Tokenize a command string, respecting quotes\n   */\n  private tokenize(input: string): string[] {\n    const tokens: string[] = [];\n    let current = \"\";\n    let inQuote = false;\n    let quoteChar = \"\";\n\n    for (let i = 0; i < input.length; i++) {\n      const char = input[i]!;\n\n      if (inQuote) {\n        if (char === quoteChar) {\n          inQuote = false;\n        } else {\n          current += char;\n        }\n      } else if (char === '\"' || char === \"'\") {\n        inQuote = true;\n        quoteChar = char;\n      } else if (char === \" \" || char === \"\\t\") {\n        if (current) {\n          tokens.push(current);\n          current = \"\";\n        }\n      } else {\n        current += char;\n      }\n    }\n\n    if (current) {\n      tokens.push(current);\n    }\n\n    // Filter out \"afs\" prefix if present\n    if (tokens[0] === \"afs\") {\n      tokens.shift();\n    }\n\n    return tokens;\n  }\n\n  /**\n   * Extract output options from args\n   */\n  private extractOutputOptions(args: string[]): {\n    json: boolean;\n    yaml: boolean;\n    view: ViewType;\n  } {\n    let json = false;\n    let yaml = false;\n    let view: ViewType | undefined;\n\n    for (let i = 0; i < args.length; i++) {\n      const arg = args[i]!;\n      if (arg === \"--json\") json = true;\n      if (arg === \"--yaml\") yaml = true;\n      if (arg.startsWith(\"--view=\")) {\n        view = arg.slice(7) as ViewType;\n      } else if (arg === \"--view\" && args[i + 1] && !args[i + 1]!.startsWith(\"-\")) {\n        view = args[i + 1] as ViewType;\n      }\n    }\n\n    // Default to human view in TTY, default otherwise\n    if (!view) {\n      view = this.options.tty ? \"human\" : \"default\";\n    }\n\n    return { json, yaml, view };\n  }\n\n  /**\n   * Extract path from args (first non-option argument after command)\n   */\n  private extractPath(args: string[]): string | undefined {\n    for (let i = 1; i < args.length; i++) {\n      const arg = args[i]!;\n      if (!arg.startsWith(\"-\")) {\n        return arg;\n      }\n    }\n    return undefined;\n  }\n}\n\n/** Levenshtein distance between two strings. */\nfunction levenshtein(a: string, b: string): number {\n  const m = a.length;\n  const n = b.length;\n  const dp: number[][] = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0) as number[]);\n  for (let i = 0; i <= m; i++) dp[i]![0] = i;\n  for (let j = 0; j <= n; j++) dp[0]![j] = j;\n  for (let i = 1; i <= m; i++) {\n    for (let j = 1; j <= n; j++) {\n      dp[i]![j] =\n        a[i - 1] === b[j - 1]\n          ? dp[i - 1]![j - 1]!\n          : 1 + Math.min(dp[i - 1]![j]!, dp[i]![j - 1]!, dp[i - 1]![j - 1]!);\n    }\n  }\n  return dp[m]![n]!;\n}\n\n/** Suggest known commands similar to the given input. */\nfunction suggestCommands(input: string): string[] {\n  const lower = input.toLowerCase();\n  const scored = KNOWN_COMMANDS.map((cmd) => ({\n    cmd,\n    dist: levenshtein(lower, cmd),\n    maxLen: Math.max(lower.length, cmd.length),\n  }))\n    // Only suggest when edit distance < 50% of the longer string\n    .filter((x) => x.dist > 0 && x.dist < x.maxLen * 0.5)\n    .sort((a, b) => a.dist - b.dist);\n  return scored.map((x) => x.cmd).slice(0, 3);\n}\n"],"mappings":"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"}

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

@@ -1,6 +1,7 @@
 import { formatDeleteOutput } from "./delete.mjs";
 import { formatExecOutput } from "./exec.mjs";
 import { formatExplainOutput } from "./explain.mjs";
+import "./install.mjs";
 import { formatLsOutput } from "./ls.mjs";
 import { formatMountListOutput } from "./mount.mjs";
 import { formatReadOutput } from "./read.mjs";

package/dist/core/formatters/install.cjs

@@ -0,0 +1,21 @@
+
+//#region src/core/formatters/install.ts
+function formatInstallAddOutput(result, view) {
+	if (view === "json") return JSON.stringify(result, null, 2);
+	return `Installed "${result.programName}" (${result.programId}) at ${result.mountPath}`;
+}
+function formatInstallListOutput(programs, view) {
+	if (view === "json") return JSON.stringify(programs, null, 2);
+	if (programs.length === 0) return "No programs installed";
+	return ["Installed programs:", ...programs.map((p) => `  ${p.id}  ${p.name}  ${p.entrypoint}  ${p.mountPath}`)].join("\n");
+}
+function formatInstallRemoveOutput(result, view) {
+	if (view === "json") return JSON.stringify(result, null, 2);
+	const suffix = result.purgedData ? " (data purged)" : "";
+	return `Removed program "${result.programId}"${suffix}`;
+}
+
+//#endregion
+exports.formatInstallAddOutput = formatInstallAddOutput;
+exports.formatInstallListOutput = formatInstallListOutput;
+exports.formatInstallRemoveOutput = formatInstallRemoveOutput;

package/dist/core/formatters/install.d.mts

@@ -0,0 +1 @@
+import "../../config/program-install.mjs";

package/dist/core/formatters/install.mjs

@@ -0,0 +1,19 @@
+//#region src/core/formatters/install.ts
+function formatInstallAddOutput(result, view) {
+	if (view === "json") return JSON.stringify(result, null, 2);
+	return `Installed "${result.programName}" (${result.programId}) at ${result.mountPath}`;
+}
+function formatInstallListOutput(programs, view) {
+	if (view === "json") return JSON.stringify(programs, null, 2);
+	if (programs.length === 0) return "No programs installed";
+	return ["Installed programs:", ...programs.map((p) => `  ${p.id}  ${p.name}  ${p.entrypoint}  ${p.mountPath}`)].join("\n");
+}
+function formatInstallRemoveOutput(result, view) {
+	if (view === "json") return JSON.stringify(result, null, 2);
+	const suffix = result.purgedData ? " (data purged)" : "";
+	return `Removed program "${result.programId}"${suffix}`;
+}
+
+//#endregion
+export { formatInstallAddOutput, formatInstallListOutput, formatInstallRemoveOutput };
+//# sourceMappingURL=install.mjs.map

package/dist/core/formatters/install.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.mjs","names":[],"sources":["../../../src/core/formatters/install.ts"],"sourcesContent":["/**\n * Install Command Formatters\n */\n\nimport type {\n  InstalledProgram,\n  InstallResult,\n  RemoveResult,\n} from \"../../config/program-install.js\";\nimport type { ViewType } from \"../types.js\";\n\nexport function formatInstallAddOutput(result: InstallResult, view?: ViewType): string {\n  if (view === \"json\") {\n    return JSON.stringify(result, null, 2);\n  }\n  return `Installed \"${result.programName}\" (${result.programId}) at ${result.mountPath}`;\n}\n\nexport function formatInstallListOutput(programs: InstalledProgram[], view?: ViewType): string {\n  if (view === \"json\") {\n    return JSON.stringify(programs, null, 2);\n  }\n  if (programs.length === 0) {\n    return \"No programs installed\";\n  }\n  const lines = programs.map((p) => `  ${p.id}  ${p.name}  ${p.entrypoint}  ${p.mountPath}`);\n  return [\"Installed programs:\", ...lines].join(\"\\n\");\n}\n\nexport function formatInstallRemoveOutput(result: RemoveResult, view?: ViewType): string {\n  if (view === \"json\") {\n    return JSON.stringify(result, null, 2);\n  }\n  const suffix = result.purgedData ? \" (data purged)\" : \"\";\n  return `Removed program \"${result.programId}\"${suffix}`;\n}\n"],"mappings":";AAWA,SAAgB,uBAAuB,QAAuB,MAAyB;AACrF,KAAI,SAAS,OACX,QAAO,KAAK,UAAU,QAAQ,MAAM,EAAE;AAExC,QAAO,cAAc,OAAO,YAAY,KAAK,OAAO,UAAU,OAAO,OAAO;;AAG9E,SAAgB,wBAAwB,UAA8B,MAAyB;AAC7F,KAAI,SAAS,OACX,QAAO,KAAK,UAAU,UAAU,MAAM,EAAE;AAE1C,KAAI,SAAS,WAAW,EACtB,QAAO;AAGT,QAAO,CAAC,uBAAuB,GADjB,SAAS,KAAK,MAAM,KAAK,EAAE,GAAG,IAAI,EAAE,KAAK,IAAI,EAAE,WAAW,IAAI,EAAE,YAAY,CAClD,CAAC,KAAK,KAAK;;AAGrD,SAAgB,0BAA0B,QAAsB,MAAyB;AACvF,KAAI,SAAS,OACX,QAAO,KAAK,UAAU,QAAQ,MAAM,EAAE;CAExC,MAAM,SAAS,OAAO,aAAa,mBAAmB;AACtD,QAAO,oBAAoB,OAAO,UAAU,GAAG"}

package/dist/core/formatters/vault.cjs

@@ -0,0 +1,36 @@
+
+//#region src/core/formatters/vault.ts
+function formatVaultInitOutput(result, view) {
+	if (view === "json") return JSON.stringify(result, null, 2);
+	const lines = [`Vault initialized at ${result.vaultPath}`];
+	if (result.migrated && result.migrated > 0) lines.push(`Migrated ${result.migrated} credential(s) from credentials.toml`);
+	return lines.join("\n");
+}
+function formatVaultGetOutput(result, view) {
+	if (view === "json") return JSON.stringify(result, null, 2);
+	return result.value;
+}
+function formatVaultSetOutput(result, view) {
+	if (view === "json") return JSON.stringify({
+		...result,
+		success: true
+	}, null, 2);
+	return `OK ${result.group}/${result.name}`;
+}
+function formatVaultDeleteOutput(result, view) {
+	if (view === "json") return JSON.stringify(result, null, 2);
+	const target = result.name ? `${result.group}/${result.name}` : result.group;
+	return result.deleted ? `Deleted ${target}` : `Not found: ${target}`;
+}
+function formatVaultListOutput(result, view) {
+	if (view === "json") return JSON.stringify(result, null, 2);
+	if (result.secrets.length === 0) return result.group ? `No secrets in group: ${result.group}` : "Vault is empty";
+	return result.secrets.join("\n");
+}
+
+//#endregion
+exports.formatVaultDeleteOutput = formatVaultDeleteOutput;
+exports.formatVaultGetOutput = formatVaultGetOutput;
+exports.formatVaultInitOutput = formatVaultInitOutput;
+exports.formatVaultListOutput = formatVaultListOutput;
+exports.formatVaultSetOutput = formatVaultSetOutput;

package/dist/core/formatters/vault.mjs

@@ -0,0 +1,32 @@
+//#region src/core/formatters/vault.ts
+function formatVaultInitOutput(result, view) {
+	if (view === "json") return JSON.stringify(result, null, 2);
+	const lines = [`Vault initialized at ${result.vaultPath}`];
+	if (result.migrated && result.migrated > 0) lines.push(`Migrated ${result.migrated} credential(s) from credentials.toml`);
+	return lines.join("\n");
+}
+function formatVaultGetOutput(result, view) {
+	if (view === "json") return JSON.stringify(result, null, 2);
+	return result.value;
+}
+function formatVaultSetOutput(result, view) {
+	if (view === "json") return JSON.stringify({
+		...result,
+		success: true
+	}, null, 2);
+	return `OK ${result.group}/${result.name}`;
+}
+function formatVaultDeleteOutput(result, view) {
+	if (view === "json") return JSON.stringify(result, null, 2);
+	const target = result.name ? `${result.group}/${result.name}` : result.group;
+	return result.deleted ? `Deleted ${target}` : `Not found: ${target}`;
+}
+function formatVaultListOutput(result, view) {
+	if (view === "json") return JSON.stringify(result, null, 2);
+	if (result.secrets.length === 0) return result.group ? `No secrets in group: ${result.group}` : "Vault is empty";
+	return result.secrets.join("\n");
+}
+
+//#endregion
+export { formatVaultDeleteOutput, formatVaultGetOutput, formatVaultInitOutput, formatVaultListOutput, formatVaultSetOutput };
+//# sourceMappingURL=vault.mjs.map

package/dist/core/formatters/vault.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.mjs","names":[],"sources":["../../../src/core/formatters/vault.ts"],"sourcesContent":["/**\n * vault Formatter - Core Implementation\n *\n * Formats vault command output without colors.\n */\n\nimport type { ViewType } from \"../types.js\";\n\nexport interface VaultInitResult {\n  success: boolean;\n  vaultPath: string;\n  migrated?: number;\n}\n\nexport interface VaultGetResult {\n  group: string;\n  name: string;\n  value: string;\n}\n\nexport interface VaultSetResult {\n  group: string;\n  name: string;\n}\n\nexport interface VaultDeleteResult {\n  group: string;\n  name?: string;\n  deleted: boolean;\n}\n\nexport interface VaultListResult {\n  group?: string;\n  secrets: string[];\n}\n\nexport function formatVaultInitOutput(result: VaultInitResult, view: ViewType): string {\n  if (view === \"json\") return JSON.stringify(result, null, 2);\n  const lines = [`Vault initialized at ${result.vaultPath}`];\n  if (result.migrated && result.migrated > 0) {\n    lines.push(`Migrated ${result.migrated} credential(s) from credentials.toml`);\n  }\n  return lines.join(\"\\n\");\n}\n\nexport function formatVaultGetOutput(result: VaultGetResult, view: ViewType): string {\n  if (view === \"json\") return JSON.stringify(result, null, 2);\n  return result.value;\n}\n\nexport function formatVaultSetOutput(result: VaultSetResult, view: ViewType): string {\n  if (view === \"json\") return JSON.stringify({ ...result, success: true }, null, 2);\n  return `OK ${result.group}/${result.name}`;\n}\n\nexport function formatVaultDeleteOutput(result: VaultDeleteResult, view: ViewType): string {\n  if (view === \"json\") return JSON.stringify(result, null, 2);\n  const target = result.name ? `${result.group}/${result.name}` : result.group;\n  return result.deleted ? `Deleted ${target}` : `Not found: ${target}`;\n}\n\nexport function formatVaultListOutput(result: VaultListResult, view: ViewType): string {\n  if (view === \"json\") return JSON.stringify(result, null, 2);\n  if (result.secrets.length === 0) {\n    return result.group ? `No secrets in group: ${result.group}` : \"Vault is empty\";\n  }\n  return result.secrets.join(\"\\n\");\n}\n"],"mappings":";AAoCA,SAAgB,sBAAsB,QAAyB,MAAwB;AACrF,KAAI,SAAS,OAAQ,QAAO,KAAK,UAAU,QAAQ,MAAM,EAAE;CAC3D,MAAM,QAAQ,CAAC,wBAAwB,OAAO,YAAY;AAC1D,KAAI,OAAO,YAAY,OAAO,WAAW,EACvC,OAAM,KAAK,YAAY,OAAO,SAAS,sCAAsC;AAE/E,QAAO,MAAM,KAAK,KAAK;;AAGzB,SAAgB,qBAAqB,QAAwB,MAAwB;AACnF,KAAI,SAAS,OAAQ,QAAO,KAAK,UAAU,QAAQ,MAAM,EAAE;AAC3D,QAAO,OAAO;;AAGhB,SAAgB,qBAAqB,QAAwB,MAAwB;AACnF,KAAI,SAAS,OAAQ,QAAO,KAAK,UAAU;EAAE,GAAG;EAAQ,SAAS;EAAM,EAAE,MAAM,EAAE;AACjF,QAAO,MAAM,OAAO,MAAM,GAAG,OAAO;;AAGtC,SAAgB,wBAAwB,QAA2B,MAAwB;AACzF,KAAI,SAAS,OAAQ,QAAO,KAAK,UAAU,QAAQ,MAAM,EAAE;CAC3D,MAAM,SAAS,OAAO,OAAO,GAAG,OAAO,MAAM,GAAG,OAAO,SAAS,OAAO;AACvE,QAAO,OAAO,UAAU,WAAW,WAAW,cAAc;;AAG9D,SAAgB,sBAAsB,QAAyB,MAAwB;AACrF,KAAI,SAAS,OAAQ,QAAO,KAAK,UAAU,QAAQ,MAAM,EAAE;AAC3D,KAAI,OAAO,QAAQ,WAAW,EAC5B,QAAO,OAAO,QAAQ,wBAAwB,OAAO,UAAU;AAEjE,QAAO,OAAO,QAAQ,KAAK,KAAK"}