@aigne/afs-cli 1.11.0-beta.1 → 1.11.0-beta.3

package/dist/commands/write.cjs

@@ -0,0 +1,52 @@
+
+//#region src/commands/write.ts
+/**
+* Write content to a file
+*/
+async function writeCommand(runtime, path, content, options = {}) {
+	try {
+		const result = await runtime.write(path, { content }, { append: options.append });
+		return {
+			path: result.data.path,
+			success: true,
+			size: result.data.metadata?.size
+		};
+	} catch (error) {
+		return {
+			path,
+			success: false,
+			message: error instanceof Error ? error.message : String(error)
+		};
+	}
+}
+/**
+* Format write output for different views
+*/
+function formatWriteOutput(result, view) {
+	switch (view) {
+		case "json": return JSON.stringify(result, null, 2);
+		case "llm": return formatLlm(result);
+		case "human": return formatHuman(result);
+		default: return formatDefault(result);
+	}
+}
+function formatDefault(result) {
+	if (result.success) return `OK ${result.path}`;
+	return `ERROR ${result.path} ${result.message}`;
+}
+function formatLlm(result) {
+	const lines = [];
+	lines.push(`WRITE ${result.path}`);
+	lines.push(`STATUS ${result.success ? "SUCCESS" : "FAILED"}`);
+	if (result.size !== void 0) lines.push(`SIZE ${result.size}`);
+	if (result.message) lines.push(`MESSAGE ${result.message}`);
+	return lines.join("\n");
+}
+function formatHuman(result) {
+	if (result.success) return `Successfully wrote to ${result.path}${result.size ? ` (${result.size} bytes)` : ""}`;
+	return `Failed to write to ${result.path}: ${result.message}`;
+}
+
+//#endregion
+exports.formatWriteOutput = formatWriteOutput;
+exports.writeCommand = writeCommand;

package/dist/commands/write.mjs

@@ -0,0 +1,51 @@
+//#region src/commands/write.ts
+/**
+* Write content to a file
+*/
+async function writeCommand(runtime, path, content, options = {}) {
+	try {
+		const result = await runtime.write(path, { content }, { append: options.append });
+		return {
+			path: result.data.path,
+			success: true,
+			size: result.data.metadata?.size
+		};
+	} catch (error) {
+		return {
+			path,
+			success: false,
+			message: error instanceof Error ? error.message : String(error)
+		};
+	}
+}
+/**
+* Format write output for different views
+*/
+function formatWriteOutput(result, view) {
+	switch (view) {
+		case "json": return JSON.stringify(result, null, 2);
+		case "llm": return formatLlm(result);
+		case "human": return formatHuman(result);
+		default: return formatDefault(result);
+	}
+}
+function formatDefault(result) {
+	if (result.success) return `OK ${result.path}`;
+	return `ERROR ${result.path} ${result.message}`;
+}
+function formatLlm(result) {
+	const lines = [];
+	lines.push(`WRITE ${result.path}`);
+	lines.push(`STATUS ${result.success ? "SUCCESS" : "FAILED"}`);
+	if (result.size !== void 0) lines.push(`SIZE ${result.size}`);
+	if (result.message) lines.push(`MESSAGE ${result.message}`);
+	return lines.join("\n");
+}
+function formatHuman(result) {
+	if (result.success) return `Successfully wrote to ${result.path}${result.size ? ` (${result.size} bytes)` : ""}`;
+	return `Failed to write to ${result.path}: ${result.message}`;
+}
+
+//#endregion
+export { formatWriteOutput, writeCommand };
+//# sourceMappingURL=write.mjs.map

package/dist/commands/write.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.mjs","names":[],"sources":["../../src/commands/write.ts"],"sourcesContent":["import type { AFSRuntime } from \"../runtime.js\";\nimport type { ViewType } from \"./ls.js\";\n\nexport interface WriteResult {\n  path: string;\n  success: boolean;\n  size?: number;\n  message?: string;\n}\n\n/**\n * Write content to a file\n */\nexport async function writeCommand(\n  runtime: AFSRuntime,\n  path: string,\n  content: string,\n  options: { append?: boolean } = {},\n): Promise<WriteResult> {\n  try {\n    const result = await runtime.write(path, { content }, { append: options.append });\n\n    return {\n      path: result.data.path,\n      success: true,\n      size: result.data.metadata?.size,\n    };\n  } catch (error) {\n    return {\n      path,\n      success: false,\n      message: error instanceof Error ? error.message : String(error),\n    };\n  }\n}\n\n/**\n * Format write output for different views\n */\nexport function formatWriteOutput(result: WriteResult, view: ViewType): string {\n  switch (view) {\n    case \"json\":\n      return JSON.stringify(result, null, 2);\n    case \"llm\":\n      return formatLlm(result);\n    case \"human\":\n      return formatHuman(result);\n    default:\n      return formatDefault(result);\n  }\n}\n\nfunction formatDefault(result: WriteResult): string {\n  if (result.success) {\n    return `OK ${result.path}`;\n  }\n  return `ERROR ${result.path} ${result.message}`;\n}\n\nfunction formatLlm(result: WriteResult): string {\n  const lines: string[] = [];\n\n  lines.push(`WRITE ${result.path}`);\n  lines.push(`STATUS ${result.success ? \"SUCCESS\" : \"FAILED\"}`);\n\n  if (result.size !== undefined) {\n    lines.push(`SIZE ${result.size}`);\n  }\n\n  if (result.message) {\n    lines.push(`MESSAGE ${result.message}`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction formatHuman(result: WriteResult): string {\n  if (result.success) {\n    return `Successfully wrote to ${result.path}${result.size ? ` (${result.size} bytes)` : \"\"}`;\n  }\n  return `Failed to write to ${result.path}: ${result.message}`;\n}\n"],"mappings":";;;;AAaA,eAAsB,aACpB,SACA,MACA,SACA,UAAgC,EAAE,EACZ;AACtB,KAAI;EACF,MAAM,SAAS,MAAM,QAAQ,MAAM,MAAM,EAAE,SAAS,EAAE,EAAE,QAAQ,QAAQ,QAAQ,CAAC;AAEjF,SAAO;GACL,MAAM,OAAO,KAAK;GAClB,SAAS;GACT,MAAM,OAAO,KAAK,UAAU;GAC7B;UACM,OAAO;AACd,SAAO;GACL;GACA,SAAS;GACT,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAChE;;;;;;AAOL,SAAgB,kBAAkB,QAAqB,MAAwB;AAC7E,SAAQ,MAAR;EACE,KAAK,OACH,QAAO,KAAK,UAAU,QAAQ,MAAM,EAAE;EACxC,KAAK,MACH,QAAO,UAAU,OAAO;EAC1B,KAAK,QACH,QAAO,YAAY,OAAO;EAC5B,QACE,QAAO,cAAc,OAAO;;;AAIlC,SAAS,cAAc,QAA6B;AAClD,KAAI,OAAO,QACT,QAAO,MAAM,OAAO;AAEtB,QAAO,SAAS,OAAO,KAAK,GAAG,OAAO;;AAGxC,SAAS,UAAU,QAA6B;CAC9C,MAAM,QAAkB,EAAE;AAE1B,OAAM,KAAK,SAAS,OAAO,OAAO;AAClC,OAAM,KAAK,UAAU,OAAO,UAAU,YAAY,WAAW;AAE7D,KAAI,OAAO,SAAS,OAClB,OAAM,KAAK,QAAQ,OAAO,OAAO;AAGnC,KAAI,OAAO,QACT,OAAM,KAAK,WAAW,OAAO,UAAU;AAGzC,QAAO,MAAM,KAAK,KAAK;;AAGzB,SAAS,YAAY,QAA6B;AAChD,KAAI,OAAO,QACT,QAAO,yBAAyB,OAAO,OAAO,OAAO,OAAO,KAAK,OAAO,KAAK,WAAW;AAE1F,QAAO,sBAAsB,OAAO,KAAK,IAAI,OAAO"}

package/dist/config/env.cjs

@@ -0,0 +1,46 @@
+
+//#region src/config/env.ts
+/**
+* Resolve environment variable references in a string
+*
+* Syntax: ${VAR_NAME}
+* Escape: \${VAR_NAME} (will not be resolved)
+*
+* @param value - String containing ${VAR} references
+* @param options - Resolution options
+* @returns String with env vars resolved
+* @throws Error if env var is undefined and allowUndefined is false
+*/
+function resolveEnvVars(value, options = {}) {
+	const { allowUndefined = false } = options;
+	if (!value) return value;
+	const ESCAPE_PLACEHOLDER = "\0ESCAPED_ENV\0";
+	let result = value.replace(/\\\$\{/g, ESCAPE_PLACEHOLDER);
+	result = result.replace(/\$\{([^}]+)\}/g, (_match, varName) => {
+		const envValue = process.env[varName];
+		if (envValue === void 0) {
+			if (allowUndefined) return "";
+			throw new Error(`Environment variable ${varName} is not defined`);
+		}
+		return envValue;
+	});
+	result = result.replace(new RegExp(ESCAPE_PLACEHOLDER, "g"), "${");
+	return result;
+}
+/**
+* Resolve environment variables in all string fields of an object (deep)
+*/
+function resolveEnvVarsInObject(obj, options = {}) {
+	if (obj === null || obj === void 0) return obj;
+	if (typeof obj === "string") return resolveEnvVars(obj, options);
+	if (Array.isArray(obj)) return obj.map((item) => resolveEnvVarsInObject(item, options));
+	if (typeof obj === "object") {
+		const result = {};
+		for (const [key, value] of Object.entries(obj)) result[key] = resolveEnvVarsInObject(value, options);
+		return result;
+	}
+	return obj;
+}
+
+//#endregion
+exports.resolveEnvVarsInObject = resolveEnvVarsInObject;

package/dist/config/env.mjs

@@ -0,0 +1,46 @@
+//#region src/config/env.ts
+/**
+* Resolve environment variable references in a string
+*
+* Syntax: ${VAR_NAME}
+* Escape: \${VAR_NAME} (will not be resolved)
+*
+* @param value - String containing ${VAR} references
+* @param options - Resolution options
+* @returns String with env vars resolved
+* @throws Error if env var is undefined and allowUndefined is false
+*/
+function resolveEnvVars(value, options = {}) {
+	const { allowUndefined = false } = options;
+	if (!value) return value;
+	const ESCAPE_PLACEHOLDER = "\0ESCAPED_ENV\0";
+	let result = value.replace(/\\\$\{/g, ESCAPE_PLACEHOLDER);
+	result = result.replace(/\$\{([^}]+)\}/g, (_match, varName) => {
+		const envValue = process.env[varName];
+		if (envValue === void 0) {
+			if (allowUndefined) return "";
+			throw new Error(`Environment variable ${varName} is not defined`);
+		}
+		return envValue;
+	});
+	result = result.replace(new RegExp(ESCAPE_PLACEHOLDER, "g"), "${");
+	return result;
+}
+/**
+* Resolve environment variables in all string fields of an object (deep)
+*/
+function resolveEnvVarsInObject(obj, options = {}) {
+	if (obj === null || obj === void 0) return obj;
+	if (typeof obj === "string") return resolveEnvVars(obj, options);
+	if (Array.isArray(obj)) return obj.map((item) => resolveEnvVarsInObject(item, options));
+	if (typeof obj === "object") {
+		const result = {};
+		for (const [key, value] of Object.entries(obj)) result[key] = resolveEnvVarsInObject(value, options);
+		return result;
+	}
+	return obj;
+}
+
+//#endregion
+export { resolveEnvVarsInObject };
+//# sourceMappingURL=env.mjs.map

package/dist/config/env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.mjs","names":[],"sources":["../../src/config/env.ts"],"sourcesContent":["/**\n * Options for environment variable resolution\n */\nexport interface ResolveEnvOptions {\n  /** If true, undefined env vars resolve to empty string instead of throwing */\n  allowUndefined?: boolean;\n}\n\n/**\n * Resolve environment variable references in a string\n *\n * Syntax: ${VAR_NAME}\n * Escape: \\${VAR_NAME} (will not be resolved)\n *\n * @param value - String containing ${VAR} references\n * @param options - Resolution options\n * @returns String with env vars resolved\n * @throws Error if env var is undefined and allowUndefined is false\n */\nexport function resolveEnvVars(value: string, options: ResolveEnvOptions = {}): string {\n  const { allowUndefined = false } = options;\n\n  if (!value) {\n    return value;\n  }\n\n  // First, handle escaped env vars (replace \\${ with a placeholder)\n  const ESCAPE_PLACEHOLDER = \"\\x00ESCAPED_ENV\\x00\";\n  let result = value.replace(/\\\\\\$\\{/g, ESCAPE_PLACEHOLDER);\n\n  // Match ${VAR_NAME} pattern\n  const envVarPattern = /\\$\\{([^}]+)\\}/g;\n\n  result = result.replace(envVarPattern, (_match, varName: string) => {\n    const envValue = process.env[varName];\n\n    if (envValue === undefined) {\n      if (allowUndefined) {\n        return \"\";\n      }\n      throw new Error(`Environment variable ${varName} is not defined`);\n    }\n\n    return envValue;\n  });\n\n  // Restore escaped env vars\n  result = result.replace(new RegExp(ESCAPE_PLACEHOLDER, \"g\"), \"${\");\n\n  return result;\n}\n\n/**\n * Resolve environment variables in all string fields of an object (deep)\n */\nexport function resolveEnvVarsInObject<T>(obj: T, options: ResolveEnvOptions = {}): T {\n  if (obj === null || obj === undefined) {\n    return obj;\n  }\n\n  if (typeof obj === \"string\") {\n    return resolveEnvVars(obj, options) as T;\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map((item) => resolveEnvVarsInObject(item, options)) as T;\n  }\n\n  if (typeof obj === \"object\") {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(obj)) {\n      result[key] = resolveEnvVarsInObject(value, options);\n    }\n    return result as T;\n  }\n\n  return obj;\n}\n"],"mappings":";;;;;;;;;;;;AAmBA,SAAgB,eAAe,OAAe,UAA6B,EAAE,EAAU;CACrF,MAAM,EAAE,iBAAiB,UAAU;AAEnC,KAAI,CAAC,MACH,QAAO;CAIT,MAAM,qBAAqB;CAC3B,IAAI,SAAS,MAAM,QAAQ,WAAW,mBAAmB;AAKzD,UAAS,OAAO,QAFM,mBAEkB,QAAQ,YAAoB;EAClE,MAAM,WAAW,QAAQ,IAAI;AAE7B,MAAI,aAAa,QAAW;AAC1B,OAAI,eACF,QAAO;AAET,SAAM,IAAI,MAAM,wBAAwB,QAAQ,iBAAiB;;AAGnE,SAAO;GACP;AAGF,UAAS,OAAO,QAAQ,IAAI,OAAO,oBAAoB,IAAI,EAAE,KAAK;AAElE,QAAO;;;;;AAMT,SAAgB,uBAA0B,KAAQ,UAA6B,EAAE,EAAK;AACpF,KAAI,QAAQ,QAAQ,QAAQ,OAC1B,QAAO;AAGT,KAAI,OAAO,QAAQ,SACjB,QAAO,eAAe,KAAK,QAAQ;AAGrC,KAAI,MAAM,QAAQ,IAAI,CACpB,QAAO,IAAI,KAAK,SAAS,uBAAuB,MAAM,QAAQ,CAAC;AAGjE,KAAI,OAAO,QAAQ,UAAU;EAC3B,MAAM,SAAkC,EAAE;AAC1C,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,CAC5C,QAAO,OAAO,uBAAuB,OAAO,QAAQ;AAEtD,SAAO;;AAGT,QAAO"}

package/dist/config/loader.cjs

@@ -0,0 +1,171 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_env = require('./env.cjs');
+const require_schema = require('./schema.cjs');
+let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
+let smol_toml = require("smol-toml");
+let node_os = require("node:os");
+
+//#region src/config/loader.ts
+const CONFIG_DIR_NAME = ".afs-config";
+const CONFIG_FILE_NAME = "config.toml";
+/**
+* Loads and merges AFS configuration from multiple layers
+*
+* Layer priority (lowest to highest):
+* 1. User-level: ~/.afs-config/config.toml
+* 2. All intermediate directories from project root to cwd
+*
+* Example: if cwd is /project/packages/cli, configs are merged from:
+*   ~/.afs-config/config.toml (user)
+*   /project/.afs-config/config.toml (project root, has .git)
+*   /project/packages/.afs-config/config.toml (intermediate)
+*   /project/packages/cli/.afs-config/config.toml (cwd)
+*/
+var ConfigLoader = class {
+	userConfigDir;
+	constructor(options = {}) {
+		this.userConfigDir = options.userConfigDir ?? (0, node_path.join)((0, node_os.homedir)(), CONFIG_DIR_NAME);
+	}
+	/**
+	* Load and merge configuration from all layers
+	*
+	* @param cwd - Current working directory (defaults to process.cwd())
+	* @returns Merged configuration
+	* @throws Error on invalid config, TOML parse error, or duplicate mount paths
+	*/
+	async load(cwd = process.cwd()) {
+		const configPaths = await this.getConfigPaths(cwd);
+		const configs = [];
+		for (const configPath of configPaths) {
+			const config = await this.loadSingleConfig(configPath);
+			configs.push(config);
+		}
+		return this.mergeConfigs(configs);
+	}
+	/**
+	* Get paths to all existing config files
+	*
+	* Collects configs from:
+	* 1. User-level: ~/.afs-config/config.toml
+	* 2. Project root (or topmost .afs-config dir) to cwd: all .afs-config/config.toml files
+	*/
+	async getConfigPaths(cwd = process.cwd()) {
+		const paths = [];
+		const userConfigPath = (0, node_path.join)(this.userConfigDir, CONFIG_FILE_NAME);
+		if (await this.fileExists(userConfigPath)) paths.push(userConfigPath);
+		const startDir = await this.findProjectRoot(cwd) ?? await this.findTopmostAfsDir(cwd) ?? cwd;
+		const intermediatePaths = await this.collectConfigsFromTo(startDir, cwd);
+		paths.push(...intermediatePaths);
+		return paths;
+	}
+	/**
+	* Find the topmost directory containing .afs-config from startDir going up
+	*/
+	async findTopmostAfsDir(startDir) {
+		let currentDir = startDir;
+		let topmostAfsDir = null;
+		while (true) {
+			if (await this.fileExists((0, node_path.join)(currentDir, CONFIG_DIR_NAME))) topmostAfsDir = currentDir;
+			const parentDir = (0, node_path.dirname)(currentDir);
+			if (parentDir === currentDir) break;
+			currentDir = parentDir;
+		}
+		return topmostAfsDir;
+	}
+	/**
+	* Collect all config files from startDir to endDir (inclusive)
+	* Returns paths in order from startDir to endDir (parent to child)
+	*/
+	async collectConfigsFromTo(startDir, endDir) {
+		const paths = [];
+		const dirs = [];
+		let current = endDir;
+		while (true) {
+			dirs.unshift(current);
+			if (current === startDir) break;
+			const parent = (0, node_path.dirname)(current);
+			if (parent === current) break;
+			current = parent;
+		}
+		for (const dir of dirs) {
+			const configPath = (0, node_path.join)(dir, CONFIG_DIR_NAME, CONFIG_FILE_NAME);
+			if (await this.fileExists(configPath)) paths.push(configPath);
+		}
+		return paths;
+	}
+	/**
+	* Load a single config file
+	*/
+	async loadSingleConfig(configPath) {
+		const content = await (0, node_fs_promises.readFile)(configPath, "utf-8");
+		let parsed;
+		try {
+			parsed = (0, smol_toml.parse)(content);
+		} catch (error) {
+			throw new Error(`Failed to parse TOML config at ${configPath}: ${error instanceof Error ? error.message : String(error)}`);
+		}
+		const resolved = require_env.resolveEnvVarsInObject(parsed);
+		const result = require_schema.ConfigSchema.safeParse(resolved);
+		if (!result.success) {
+			const errors = result.error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join("; ");
+			throw new Error(`Invalid config at ${configPath}: ${errors}`);
+		}
+		return result.data;
+	}
+	/**
+	* Merge multiple configs, checking for duplicate mount paths
+	* For serve config, later (more specific) configs override earlier ones
+	*/
+	mergeConfigs(configs) {
+		const allMounts = [];
+		const seenPaths = /* @__PURE__ */ new Map();
+		let mergedServe;
+		for (const config of configs) {
+			for (const mount of config.mounts) {
+				if (seenPaths.has(mount.path)) throw new Error(`Duplicate mount path "${mount.path}" found in configuration. Mount paths must be unique across all config files.`);
+				seenPaths.set(mount.path, mount.uri);
+				allMounts.push(mount);
+			}
+			if (config.serve) mergedServe = mergedServe ? {
+				...mergedServe,
+				...config.serve
+			} : config.serve;
+		}
+		return {
+			mounts: allMounts,
+			serve: mergedServe
+		};
+	}
+	/**
+	* Find project root by looking for .git
+	* Note: Only .git is used as project root marker, not .afs-config,
+	* because .afs-config can exist at multiple levels for hierarchical config
+	*/
+	async findProjectRoot(startDir) {
+		let currentDir = startDir;
+		while (true) {
+			if (await this.fileExists((0, node_path.join)(currentDir, ".git"))) return currentDir;
+			const parentDir = (0, node_path.dirname)(currentDir);
+			if (parentDir === currentDir) return null;
+			currentDir = parentDir;
+		}
+	}
+	/**
+	* Check if a file or directory exists
+	*/
+	async fileExists(path) {
+		try {
+			await (0, node_fs_promises.access)(path);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+};
+const configLoader = new ConfigLoader();
+
+//#endregion
+exports.CONFIG_DIR_NAME = CONFIG_DIR_NAME;
+exports.CONFIG_FILE_NAME = CONFIG_FILE_NAME;
+exports.ConfigLoader = ConfigLoader;

package/dist/config/loader.mjs

@@ -0,0 +1,169 @@
+import { resolveEnvVarsInObject } from "./env.mjs";
+import { ConfigSchema } from "./schema.mjs";
+import { access, readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { parse } from "smol-toml";
+import { homedir } from "node:os";
+
+//#region src/config/loader.ts
+const CONFIG_DIR_NAME = ".afs-config";
+const CONFIG_FILE_NAME = "config.toml";
+/**
+* Loads and merges AFS configuration from multiple layers
+*
+* Layer priority (lowest to highest):
+* 1. User-level: ~/.afs-config/config.toml
+* 2. All intermediate directories from project root to cwd
+*
+* Example: if cwd is /project/packages/cli, configs are merged from:
+*   ~/.afs-config/config.toml (user)
+*   /project/.afs-config/config.toml (project root, has .git)
+*   /project/packages/.afs-config/config.toml (intermediate)
+*   /project/packages/cli/.afs-config/config.toml (cwd)
+*/
+var ConfigLoader = class {
+	userConfigDir;
+	constructor(options = {}) {
+		this.userConfigDir = options.userConfigDir ?? join(homedir(), CONFIG_DIR_NAME);
+	}
+	/**
+	* Load and merge configuration from all layers
+	*
+	* @param cwd - Current working directory (defaults to process.cwd())
+	* @returns Merged configuration
+	* @throws Error on invalid config, TOML parse error, or duplicate mount paths
+	*/
+	async load(cwd = process.cwd()) {
+		const configPaths = await this.getConfigPaths(cwd);
+		const configs = [];
+		for (const configPath of configPaths) {
+			const config = await this.loadSingleConfig(configPath);
+			configs.push(config);
+		}
+		return this.mergeConfigs(configs);
+	}
+	/**
+	* Get paths to all existing config files
+	*
+	* Collects configs from:
+	* 1. User-level: ~/.afs-config/config.toml
+	* 2. Project root (or topmost .afs-config dir) to cwd: all .afs-config/config.toml files
+	*/
+	async getConfigPaths(cwd = process.cwd()) {
+		const paths = [];
+		const userConfigPath = join(this.userConfigDir, CONFIG_FILE_NAME);
+		if (await this.fileExists(userConfigPath)) paths.push(userConfigPath);
+		const startDir = await this.findProjectRoot(cwd) ?? await this.findTopmostAfsDir(cwd) ?? cwd;
+		const intermediatePaths = await this.collectConfigsFromTo(startDir, cwd);
+		paths.push(...intermediatePaths);
+		return paths;
+	}
+	/**
+	* Find the topmost directory containing .afs-config from startDir going up
+	*/
+	async findTopmostAfsDir(startDir) {
+		let currentDir = startDir;
+		let topmostAfsDir = null;
+		while (true) {
+			if (await this.fileExists(join(currentDir, CONFIG_DIR_NAME))) topmostAfsDir = currentDir;
+			const parentDir = dirname(currentDir);
+			if (parentDir === currentDir) break;
+			currentDir = parentDir;
+		}
+		return topmostAfsDir;
+	}
+	/**
+	* Collect all config files from startDir to endDir (inclusive)
+	* Returns paths in order from startDir to endDir (parent to child)
+	*/
+	async collectConfigsFromTo(startDir, endDir) {
+		const paths = [];
+		const dirs = [];
+		let current = endDir;
+		while (true) {
+			dirs.unshift(current);
+			if (current === startDir) break;
+			const parent = dirname(current);
+			if (parent === current) break;
+			current = parent;
+		}
+		for (const dir of dirs) {
+			const configPath = join(dir, CONFIG_DIR_NAME, CONFIG_FILE_NAME);
+			if (await this.fileExists(configPath)) paths.push(configPath);
+		}
+		return paths;
+	}
+	/**
+	* Load a single config file
+	*/
+	async loadSingleConfig(configPath) {
+		const content = await readFile(configPath, "utf-8");
+		let parsed;
+		try {
+			parsed = parse(content);
+		} catch (error) {
+			throw new Error(`Failed to parse TOML config at ${configPath}: ${error instanceof Error ? error.message : String(error)}`);
+		}
+		const resolved = resolveEnvVarsInObject(parsed);
+		const result = ConfigSchema.safeParse(resolved);
+		if (!result.success) {
+			const errors = result.error.errors.map((e) => `${e.path.join(".")}: ${e.message}`).join("; ");
+			throw new Error(`Invalid config at ${configPath}: ${errors}`);
+		}
+		return result.data;
+	}
+	/**
+	* Merge multiple configs, checking for duplicate mount paths
+	* For serve config, later (more specific) configs override earlier ones
+	*/
+	mergeConfigs(configs) {
+		const allMounts = [];
+		const seenPaths = /* @__PURE__ */ new Map();
+		let mergedServe;
+		for (const config of configs) {
+			for (const mount of config.mounts) {
+				if (seenPaths.has(mount.path)) throw new Error(`Duplicate mount path "${mount.path}" found in configuration. Mount paths must be unique across all config files.`);
+				seenPaths.set(mount.path, mount.uri);
+				allMounts.push(mount);
+			}
+			if (config.serve) mergedServe = mergedServe ? {
+				...mergedServe,
+				...config.serve
+			} : config.serve;
+		}
+		return {
+			mounts: allMounts,
+			serve: mergedServe
+		};
+	}
+	/**
+	* Find project root by looking for .git
+	* Note: Only .git is used as project root marker, not .afs-config,
+	* because .afs-config can exist at multiple levels for hierarchical config
+	*/
+	async findProjectRoot(startDir) {
+		let currentDir = startDir;
+		while (true) {
+			if (await this.fileExists(join(currentDir, ".git"))) return currentDir;
+			const parentDir = dirname(currentDir);
+			if (parentDir === currentDir) return null;
+			currentDir = parentDir;
+		}
+	}
+	/**
+	* Check if a file or directory exists
+	*/
+	async fileExists(path) {
+		try {
+			await access(path);
+			return true;
+		} catch {
+			return false;
+		}
+	}
+};
+const configLoader = new ConfigLoader();
+
+//#endregion
+export { CONFIG_DIR_NAME, CONFIG_FILE_NAME, ConfigLoader };
+//# sourceMappingURL=loader.mjs.map

package/dist/config/loader.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.mjs","names":[],"sources":["../../src/config/loader.ts"],"sourcesContent":["import { access, readFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport { parse } from \"smol-toml\";\nimport { resolveEnvVarsInObject } from \"./env.js\";\nimport { type AFSConfig, ConfigSchema, type MountConfig, type ServeConfig } from \"./schema.js\";\n\nexport const CONFIG_DIR_NAME = \".afs-config\";\nexport const CONFIG_FILE_NAME = \"config.toml\";\n\nexport interface ConfigLoaderOptions {\n  /** Custom path to user-level config directory (for testing) */\n  userConfigDir?: string;\n}\n\n/**\n * Loads and merges AFS configuration from multiple layers\n *\n * Layer priority (lowest to highest):\n * 1. User-level: ~/.afs-config/config.toml\n * 2. All intermediate directories from project root to cwd\n *\n * Example: if cwd is /project/packages/cli, configs are merged from:\n *   ~/.afs-config/config.toml (user)\n *   /project/.afs-config/config.toml (project root, has .git)\n *   /project/packages/.afs-config/config.toml (intermediate)\n *   /project/packages/cli/.afs-config/config.toml (cwd)\n */\nexport class ConfigLoader {\n  private userConfigDir: string;\n\n  constructor(options: ConfigLoaderOptions = {}) {\n    this.userConfigDir = options.userConfigDir ?? join(homedir(), CONFIG_DIR_NAME);\n  }\n\n  /**\n   * Load and merge configuration from all layers\n   *\n   * @param cwd - Current working directory (defaults to process.cwd())\n   * @returns Merged configuration\n   * @throws Error on invalid config, TOML parse error, or duplicate mount paths\n   */\n  async load(cwd: string = process.cwd()): Promise<AFSConfig> {\n    const configPaths = await this.getConfigPaths(cwd);\n    const configs: AFSConfig[] = [];\n\n    for (const configPath of configPaths) {\n      const config = await this.loadSingleConfig(configPath);\n      configs.push(config);\n    }\n\n    return this.mergeConfigs(configs);\n  }\n\n  /**\n   * Get paths to all existing config files\n   *\n   * Collects configs from:\n   * 1. User-level: ~/.afs-config/config.toml\n   * 2. Project root (or topmost .afs-config dir) to cwd: all .afs-config/config.toml files\n   */\n  async getConfigPaths(cwd: string = process.cwd()): Promise<string[]> {\n    const paths: string[] = [];\n\n    // 1. User-level config\n    const userConfigPath = join(this.userConfigDir, CONFIG_FILE_NAME);\n    if (await this.fileExists(userConfigPath)) {\n      paths.push(userConfigPath);\n    }\n\n    // 2. Find project root (look for .git going up)\n    const projectRoot = await this.findProjectRoot(cwd);\n\n    // 3. Determine start directory\n    // If project root found, use it; otherwise find topmost .afs-config directory\n    const startDir = projectRoot ?? (await this.findTopmostAfsDir(cwd)) ?? cwd;\n\n    // 4. Collect all config files from start to cwd\n    const intermediatePaths = await this.collectConfigsFromTo(startDir, cwd);\n    paths.push(...intermediatePaths);\n\n    return paths;\n  }\n\n  /**\n   * Find the topmost directory containing .afs-config from startDir going up\n   */\n  private async findTopmostAfsDir(startDir: string): Promise<string | null> {\n    let currentDir = startDir;\n    let topmostAfsDir: string | null = null;\n\n    while (true) {\n      if (await this.fileExists(join(currentDir, CONFIG_DIR_NAME))) {\n        topmostAfsDir = currentDir;\n      }\n\n      const parentDir = dirname(currentDir);\n      if (parentDir === currentDir) {\n        // Reached filesystem root\n        break;\n      }\n      currentDir = parentDir;\n    }\n\n    return topmostAfsDir;\n  }\n\n  /**\n   * Collect all config files from startDir to endDir (inclusive)\n   * Returns paths in order from startDir to endDir (parent to child)\n   */\n  private async collectConfigsFromTo(startDir: string, endDir: string): Promise<string[]> {\n    const paths: string[] = [];\n\n    // Build list of directories from startDir to endDir\n    const dirs: string[] = [];\n    let current = endDir;\n\n    while (true) {\n      dirs.unshift(current); // prepend to maintain parent-to-child order\n\n      if (current === startDir) {\n        break;\n      }\n\n      const parent = dirname(current);\n      if (parent === current) {\n        // Reached filesystem root without finding startDir\n        // This shouldn't happen if startDir is an ancestor of endDir\n        break;\n      }\n      current = parent;\n    }\n\n    // Check each directory for config file\n    for (const dir of dirs) {\n      const configPath = join(dir, CONFIG_DIR_NAME, CONFIG_FILE_NAME);\n      if (await this.fileExists(configPath)) {\n        paths.push(configPath);\n      }\n    }\n\n    return paths;\n  }\n\n  /**\n   * Load a single config file\n   */\n  private async loadSingleConfig(configPath: string): Promise<AFSConfig> {\n    const content = await readFile(configPath, \"utf-8\");\n\n    let parsed: unknown;\n    try {\n      parsed = parse(content);\n    } catch (error) {\n      throw new Error(\n        `Failed to parse TOML config at ${configPath}: ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n\n    // Resolve environment variables\n    const resolved = resolveEnvVarsInObject(parsed);\n\n    // Validate against schema\n    const result = ConfigSchema.safeParse(resolved);\n    if (!result.success) {\n      const errors = result.error.errors.map((e) => `${e.path.join(\".\")}: ${e.message}`).join(\"; \");\n      throw new Error(`Invalid config at ${configPath}: ${errors}`);\n    }\n\n    return result.data;\n  }\n\n  /**\n   * Merge multiple configs, checking for duplicate mount paths\n   * For serve config, later (more specific) configs override earlier ones\n   */\n  private mergeConfigs(configs: AFSConfig[]): AFSConfig {\n    const allMounts: MountConfig[] = [];\n    const seenPaths = new Map<string, string>(); // path -> source file info\n    let mergedServe: ServeConfig | undefined;\n\n    for (const config of configs) {\n      // Merge mounts\n      for (const mount of config.mounts) {\n        if (seenPaths.has(mount.path)) {\n          throw new Error(\n            `Duplicate mount path \"${mount.path}\" found in configuration. ` +\n              `Mount paths must be unique across all config files.`,\n          );\n        }\n        seenPaths.set(mount.path, mount.uri);\n        allMounts.push(mount);\n      }\n\n      // Merge serve config (later configs override earlier ones)\n      if (config.serve) {\n        mergedServe = mergedServe ? { ...mergedServe, ...config.serve } : config.serve;\n      }\n    }\n\n    return { mounts: allMounts, serve: mergedServe };\n  }\n\n  /**\n   * Find project root by looking for .git\n   * Note: Only .git is used as project root marker, not .afs-config,\n   * because .afs-config can exist at multiple levels for hierarchical config\n   */\n  private async findProjectRoot(startDir: string): Promise<string | null> {\n    let currentDir = startDir;\n\n    while (true) {\n      // Check for .git directory\n      if (await this.fileExists(join(currentDir, \".git\"))) {\n        return currentDir;\n      }\n\n      const parentDir = dirname(currentDir);\n      if (parentDir === currentDir) {\n        // Reached filesystem root\n        return null;\n      }\n      currentDir = parentDir;\n    }\n  }\n\n  /**\n   * Check if a file or directory exists\n   */\n  private async fileExists(path: string): Promise<boolean> {\n    try {\n      await access(path);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n\n// Default singleton instance\nexport const configLoader = new ConfigLoader();\n"],"mappings":";;;;;;;;AAOA,MAAa,kBAAkB;AAC/B,MAAa,mBAAmB;;;;;;;;;;;;;;AAoBhC,IAAa,eAAb,MAA0B;CACxB,AAAQ;CAER,YAAY,UAA+B,EAAE,EAAE;AAC7C,OAAK,gBAAgB,QAAQ,iBAAiB,KAAK,SAAS,EAAE,gBAAgB;;;;;;;;;CAUhF,MAAM,KAAK,MAAc,QAAQ,KAAK,EAAsB;EAC1D,MAAM,cAAc,MAAM,KAAK,eAAe,IAAI;EAClD,MAAM,UAAuB,EAAE;AAE/B,OAAK,MAAM,cAAc,aAAa;GACpC,MAAM,SAAS,MAAM,KAAK,iBAAiB,WAAW;AACtD,WAAQ,KAAK,OAAO;;AAGtB,SAAO,KAAK,aAAa,QAAQ;;;;;;;;;CAUnC,MAAM,eAAe,MAAc,QAAQ,KAAK,EAAqB;EACnE,MAAM,QAAkB,EAAE;EAG1B,MAAM,iBAAiB,KAAK,KAAK,eAAe,iBAAiB;AACjE,MAAI,MAAM,KAAK,WAAW,eAAe,CACvC,OAAM,KAAK,eAAe;EAQ5B,MAAM,WAJc,MAAM,KAAK,gBAAgB,IAAI,IAIlB,MAAM,KAAK,kBAAkB,IAAI,IAAK;EAGvE,MAAM,oBAAoB,MAAM,KAAK,qBAAqB,UAAU,IAAI;AACxE,QAAM,KAAK,GAAG,kBAAkB;AAEhC,SAAO;;;;;CAMT,MAAc,kBAAkB,UAA0C;EACxE,IAAI,aAAa;EACjB,IAAI,gBAA+B;AAEnC,SAAO,MAAM;AACX,OAAI,MAAM,KAAK,WAAW,KAAK,YAAY,gBAAgB,CAAC,CAC1D,iBAAgB;GAGlB,MAAM,YAAY,QAAQ,WAAW;AACrC,OAAI,cAAc,WAEhB;AAEF,gBAAa;;AAGf,SAAO;;;;;;CAOT,MAAc,qBAAqB,UAAkB,QAAmC;EACtF,MAAM,QAAkB,EAAE;EAG1B,MAAM,OAAiB,EAAE;EACzB,IAAI,UAAU;AAEd,SAAO,MAAM;AACX,QAAK,QAAQ,QAAQ;AAErB,OAAI,YAAY,SACd;GAGF,MAAM,SAAS,QAAQ,QAAQ;AAC/B,OAAI,WAAW,QAGb;AAEF,aAAU;;AAIZ,OAAK,MAAM,OAAO,MAAM;GACtB,MAAM,aAAa,KAAK,KAAK,iBAAiB,iBAAiB;AAC/D,OAAI,MAAM,KAAK,WAAW,WAAW,CACnC,OAAM,KAAK,WAAW;;AAI1B,SAAO;;;;;CAMT,MAAc,iBAAiB,YAAwC;EACrE,MAAM,UAAU,MAAM,SAAS,YAAY,QAAQ;EAEnD,IAAI;AACJ,MAAI;AACF,YAAS,MAAM,QAAQ;WAChB,OAAO;AACd,SAAM,IAAI,MACR,kCAAkC,WAAW,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,GACxG;;EAIH,MAAM,WAAW,uBAAuB,OAAO;EAG/C,MAAM,SAAS,aAAa,UAAU,SAAS;AAC/C,MAAI,CAAC,OAAO,SAAS;GACnB,MAAM,SAAS,OAAO,MAAM,OAAO,KAAK,MAAM,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,KAAK;AAC7F,SAAM,IAAI,MAAM,qBAAqB,WAAW,IAAI,SAAS;;AAG/D,SAAO,OAAO;;;;;;CAOhB,AAAQ,aAAa,SAAiC;EACpD,MAAM,YAA2B,EAAE;EACnC,MAAM,4BAAY,IAAI,KAAqB;EAC3C,IAAI;AAEJ,OAAK,MAAM,UAAU,SAAS;AAE5B,QAAK,MAAM,SAAS,OAAO,QAAQ;AACjC,QAAI,UAAU,IAAI,MAAM,KAAK,CAC3B,OAAM,IAAI,MACR,yBAAyB,MAAM,KAAK,+EAErC;AAEH,cAAU,IAAI,MAAM,MAAM,MAAM,IAAI;AACpC,cAAU,KAAK,MAAM;;AAIvB,OAAI,OAAO,MACT,eAAc,cAAc;IAAE,GAAG;IAAa,GAAG,OAAO;IAAO,GAAG,OAAO;;AAI7E,SAAO;GAAE,QAAQ;GAAW,OAAO;GAAa;;;;;;;CAQlD,MAAc,gBAAgB,UAA0C;EACtE,IAAI,aAAa;AAEjB,SAAO,MAAM;AAEX,OAAI,MAAM,KAAK,WAAW,KAAK,YAAY,OAAO,CAAC,CACjD,QAAO;GAGT,MAAM,YAAY,QAAQ,WAAW;AACrC,OAAI,cAAc,WAEhB,QAAO;AAET,gBAAa;;;;;;CAOjB,MAAc,WAAW,MAAgC;AACvD,MAAI;AACF,SAAM,OAAO,KAAK;AAClB,UAAO;UACD;AACN,UAAO;;;;AAMb,MAAa,eAAe,IAAI,cAAc"}

package/dist/config/provider-factory.cjs

@@ -0,0 +1,92 @@
+const require_uri_parser = require('./uri-parser.cjs');
+
+//#region src/config/provider-factory.ts
+/**
+* Create an AFS provider from a mount configuration
+*
+* @param mount - Mount configuration with URI and options
+* @returns Provider instance
+* @throws Error if scheme is unknown or not implemented
+*/
+async function createProvider(mount) {
+	const parsed = require_uri_parser.parseURI(mount.uri);
+	switch (parsed.scheme) {
+		case "fs": return createAFSFSProvider(mount, parsed.path);
+		case "git": return createGitProvider(mount, parsed.path, parsed.params, parsed.host);
+		case "sqlite": return createSQLiteProvider(mount, parsed.path);
+		case "json": return createJSONProvider(mount, parsed.path);
+		case "http":
+		case "https": return createHttpProvider(mount);
+		default: throw new Error(`Unknown URI scheme: ${parsed.scheme}`);
+	}
+}
+async function createAFSFSProvider(mount, localPath) {
+	const { AFSFS } = await import("@aigne/afs-fs");
+	return new AFSFS({
+		localPath,
+		name: mount.path.slice(1).replace(/\//g, "-") || "fs",
+		description: mount.description,
+		accessMode: mount.access_mode,
+		...mount.options
+	});
+}
+async function createGitProvider(mount, repoPath, params, host) {
+	const { AFSGit } = await import("@aigne/afs-git");
+	if (host) return new AFSGit({
+		remoteUrl: `git@${host}:${repoPath}`,
+		name: mount.path.slice(1).replace(/\//g, "-") || "git",
+		description: mount.description,
+		accessMode: mount.access_mode ?? "readonly",
+		branches: params.branch ? [params.branch] : void 0,
+		...mount.options
+	});
+	if (repoPath.startsWith("https://") || repoPath.startsWith("http://")) return new AFSGit({
+		remoteUrl: repoPath,
+		name: mount.path.slice(1).replace(/\//g, "-") || "git",
+		description: mount.description,
+		accessMode: mount.access_mode ?? "readonly",
+		branches: params.branch ? [params.branch] : void 0,
+		...mount.options
+	});
+	return new AFSGit({
+		repoPath,
+		name: mount.path.slice(1).replace(/\//g, "-") || "git",
+		description: mount.description,
+		accessMode: mount.access_mode ?? "readonly",
+		branches: params.branch ? [params.branch] : void 0,
+		...mount.options
+	});
+}
+async function createSQLiteProvider(mount, dbPath) {
+	const { SQLiteAFS } = await import("@aigne/afs-sqlite");
+	return new SQLiteAFS({
+		url: `file:${dbPath}`,
+		name: mount.path.slice(1).replace(/\//g, "-") || "sqlite",
+		description: mount.description,
+		accessMode: mount.access_mode,
+		...mount.options
+	});
+}
+async function createJSONProvider(mount, jsonPath) {
+	const { AFSJSON } = await import("@aigne/afs-json");
+	return new AFSJSON({
+		jsonPath,
+		name: mount.path.slice(1).replace(/\//g, "-") || "json",
+		description: mount.description,
+		accessMode: mount.access_mode,
+		...mount.options
+	});
+}
+async function createHttpProvider(mount) {
+	const { AFSHttpClient } = await import("@aigne/afs-http");
+	return new AFSHttpClient({
+		url: mount.uri,
+		name: mount.path.slice(1).replace(/\//g, "-") || "http",
+		description: mount.description,
+		accessMode: mount.access_mode,
+		...mount.options
+	});
+}
+
+//#endregion
+exports.createProvider = createProvider;