@soda-gql/cli 0.7.0 → 0.8.2

package/dist/index.cjs

@@ -26,16 +26,292 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
+let neverthrow = require("neverthrow");
+let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
-let __soda_gql_codegen = require("@soda-gql/codegen");
+let __soda_gql_builder = require("@soda-gql/builder");
 let __soda_gql_config = require("@soda-gql/config");
-let neverthrow = require("neverthrow");
+let __soda_gql_codegen = require("@soda-gql/codegen");
 let zod = require("zod");
-let node_fs_promises = require("node:fs/promises");
 let fast_glob = require("fast-glob");
 fast_glob = __toESM(fast_glob);
 let node_fs = require("node:fs");
 
+//#region packages/cli/src/errors.ts
+/**
+* Error constructor helpers for concise error creation.
+* Each function returns a specific error type for better type inference.
+*/
+const cliErrors = {
+	argsInvalid: (command, message) => ({
+		category: "cli",
+		code: "CLI_ARGS_INVALID",
+		message,
+		command
+	}),
+	unknownCommand: (command) => ({
+		category: "cli",
+		code: "CLI_UNKNOWN_COMMAND",
+		message: `Unknown command: ${command}`,
+		command
+	}),
+	unknownSubcommand: (parent, subcommand) => ({
+		category: "cli",
+		code: "CLI_UNKNOWN_SUBCOMMAND",
+		message: `Unknown subcommand: ${subcommand}`,
+		parent,
+		subcommand
+	}),
+	fileExists: (filePath, message) => ({
+		category: "cli",
+		code: "CLI_FILE_EXISTS",
+		message: message ?? `File already exists: ${filePath}. Use --force to overwrite.`,
+		filePath
+	}),
+	fileNotFound: (filePath, message) => ({
+		category: "cli",
+		code: "CLI_FILE_NOT_FOUND",
+		message: message ?? `File not found: ${filePath}`,
+		filePath
+	}),
+	writeFailed: (filePath, message, cause) => ({
+		category: "cli",
+		code: "CLI_WRITE_FAILED",
+		message: message ?? `Failed to write file: ${filePath}`,
+		filePath,
+		cause
+	}),
+	readFailed: (filePath, message, cause) => ({
+		category: "cli",
+		code: "CLI_READ_FAILED",
+		message: message ?? `Failed to read file: ${filePath}`,
+		filePath,
+		cause
+	}),
+	noPatterns: (message) => ({
+		category: "cli",
+		code: "CLI_NO_PATTERNS",
+		message: message ?? "No patterns provided and config not found. Usage: soda-gql format [patterns...] [--check]"
+	}),
+	formatterNotInstalled: (message) => ({
+		category: "cli",
+		code: "CLI_FORMATTER_NOT_INSTALLED",
+		message: message ?? "@soda-gql/formatter is not installed. Run: bun add @soda-gql/formatter"
+	}),
+	parseError: (message, filePath) => ({
+		category: "cli",
+		code: "CLI_PARSE_ERROR",
+		message,
+		filePath
+	}),
+	formatError: (message, filePath) => ({
+		category: "cli",
+		code: "CLI_FORMAT_ERROR",
+		message,
+		filePath
+	}),
+	unexpected: (message, cause) => ({
+		category: "cli",
+		code: "CLI_UNEXPECTED",
+		message,
+		cause
+	}),
+	fromCodegen: (error) => ({
+		category: "codegen",
+		error
+	}),
+	fromBuilder: (error) => ({
+		category: "builder",
+		error
+	}),
+	fromArtifact: (error) => ({
+		category: "artifact",
+		error
+	}),
+	fromConfig: (error) => ({
+		category: "config",
+		error
+	})
+};
+
+//#endregion
+//#region packages/cli/src/commands/artifact/build.ts
+const BUILD_HELP = `Usage: soda-gql artifact build [options]
+
+Build and validate soda-gql artifacts.
+
+Options:
+  --config <path>    Path to soda-gql.config.ts
+  --output, -o       Output file path (default: ./soda-gql-artifact.json)
+  --version, -v      Custom version string for the artifact (default: package version)
+  --dry-run          Validate only, don't write output
+  --help, -h         Show this help message
+
+Examples:
+  soda-gql artifact build
+  soda-gql artifact build --output ./dist/artifact.json
+  soda-gql artifact build --version "1.0.0"
+  soda-gql artifact build --dry-run
+  soda-gql artifact build --config ./soda-gql.config.ts
+`;
+const DEFAULT_OUTPUT_PATH = "./soda-gql-artifact.json";
+/**
+* Parse build command arguments.
+*/
+const parseBuildArgs = (argv) => {
+	const args = {
+		configPath: void 0,
+		outputPath: DEFAULT_OUTPUT_PATH,
+		version: void 0,
+		dryRun: false,
+		help: false
+	};
+	for (let i = 0; i < argv.length; i++) {
+		const arg = argv[i];
+		if (arg === "--config" || arg === "-c") args.configPath = argv[++i];
+		else if (arg === "--output" || arg === "-o") args.outputPath = argv[++i] ?? DEFAULT_OUTPUT_PATH;
+		else if (arg === "--version" || arg === "-v") args.version = argv[++i];
+		else if (arg === "--dry-run") args.dryRun = true;
+		else if (arg === "--help" || arg === "-h") args.help = true;
+	}
+	return args;
+};
+const formatSuccess$3 = (data) => {
+	const { artifact, outputPath, dryRun } = data;
+	const fragmentCount = Object.values(artifact.elements).filter((e) => e.type === "fragment").length;
+	const operationCount = Object.values(artifact.elements).filter((e) => e.type === "operation").length;
+	const lines = [];
+	if (dryRun) lines.push(`Validation passed: ${fragmentCount} fragments, ${operationCount} operations`);
+	else lines.push(`Build complete: ${fragmentCount} fragments, ${operationCount} operations`);
+	if (artifact.meta?.version) lines.push(`  Version: ${artifact.meta.version}`);
+	if (outputPath && !dryRun) lines.push(`Artifact written to: ${outputPath}`);
+	return lines.join("\n");
+};
+/**
+* Build command - builds and validates soda-gql artifacts.
+*/
+const buildCommand = async (argv) => {
+	const args = parseBuildArgs(argv);
+	if (args.help) return (0, neverthrow.ok)({ message: BUILD_HELP });
+	const configResult = (0, __soda_gql_config.loadConfig)(args.configPath);
+	if (configResult.isErr()) return (0, neverthrow.err)(cliErrors.fromConfig(configResult.error));
+	const config = configResult.value;
+	const buildResult = await (0, __soda_gql_builder.createBuilderService)({ config }).buildAsync();
+	if (buildResult.isErr()) return (0, neverthrow.err)(cliErrors.fromBuilder(buildResult.error));
+	const artifact = buildResult.value;
+	const meta = args.version ? {
+		version: args.version,
+		createdAt: (/* @__PURE__ */ new Date()).toISOString()
+	} : void 0;
+	const artifactWithMeta = {
+		...meta ? { meta } : {},
+		...artifact
+	};
+	if (args.dryRun) {
+		const data$1 = {
+			artifact: artifactWithMeta,
+			dryRun: true
+		};
+		return (0, neverthrow.ok)({
+			message: formatSuccess$3(data$1),
+			data: data$1
+		});
+	}
+	const outputPath = (0, node_path.resolve)(process.cwd(), args.outputPath);
+	const outputDir = (0, node_path.dirname)(outputPath);
+	try {
+		await (0, node_fs_promises.mkdir)(outputDir, { recursive: true });
+		await (0, node_fs_promises.writeFile)(outputPath, JSON.stringify(artifactWithMeta, null, 2));
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		return (0, neverthrow.err)(cliErrors.writeFailed(outputPath, `Failed to write artifact: ${message}`, error));
+	}
+	const data = {
+		artifact: artifactWithMeta,
+		outputPath,
+		dryRun: false
+	};
+	return (0, neverthrow.ok)({
+		message: formatSuccess$3(data),
+		data
+	});
+};
+
+//#endregion
+//#region packages/cli/src/commands/artifact/validate.ts
+const VALIDATE_HELP = `Usage: soda-gql artifact validate [options] <path>
+
+Validate a pre-built soda-gql artifact file.
+
+Arguments:
+  <path>              Path to artifact JSON file
+
+Options:
+  --help, -h          Show this help message
+
+Examples:
+  soda-gql artifact validate ./soda-gql-artifact.json
+  soda-gql artifact validate ./dist/artifact.json
+`;
+/**
+* Parse validate command arguments.
+*/
+const parseValidateArgs = (argv) => {
+	const args = {
+		artifactPath: void 0,
+		help: false
+	};
+	for (const arg of argv) if (arg === "--help" || arg === "-h") args.help = true;
+	else if (!arg.startsWith("-")) args.artifactPath = arg;
+	return args;
+};
+const formatSuccess$2 = (artifact) => {
+	const lines = [`Artifact valid: ${Object.values(artifact.elements).filter((e) => e.type === "fragment").length} fragments, ${Object.values(artifact.elements).filter((e) => e.type === "operation").length} operations`];
+	if (artifact.meta) {
+		lines.push(`  Version: ${artifact.meta.version}`);
+		lines.push(`  Created: ${artifact.meta.createdAt}`);
+	} else lines.push(`  (No metadata - legacy artifact format)`);
+	return lines.join("\n");
+};
+/**
+* Validate command - validates a pre-built artifact file.
+*/
+const validateCommand = async (argv) => {
+	const args = parseValidateArgs(argv);
+	if (args.help) return (0, neverthrow.ok)({ message: VALIDATE_HELP });
+	if (!args.artifactPath) return (0, neverthrow.err)(cliErrors.argsInvalid("artifact validate", "Missing artifact path argument"));
+	const result = await (0, __soda_gql_builder.loadArtifact)((0, node_path.resolve)(process.cwd(), args.artifactPath));
+	if (result.isErr()) return (0, neverthrow.err)(cliErrors.fromArtifact(result.error));
+	return (0, neverthrow.ok)({
+		message: formatSuccess$2(result.value),
+		data: result.value
+	});
+};
+
+//#endregion
+//#region packages/cli/src/commands/artifact/index.ts
+const ARTIFACT_HELP = `Usage: soda-gql artifact <subcommand> [options]
+
+Manage soda-gql artifacts.
+
+Subcommands:
+  build        Build artifacts (validate definitions)
+  validate     Validate a pre-built artifact file
+
+Run 'soda-gql artifact <subcommand> --help' for more information.
+`;
+/**
+* Dispatcher for artifact subcommands.
+*/
+const artifactCommand = async (argv) => {
+	const [subcommand, ...rest] = argv;
+	if (!subcommand || subcommand === "--help" || subcommand === "-h") return (0, neverthrow.ok)({ message: ARTIFACT_HELP });
+	if (subcommand === "build") return buildCommand(rest);
+	if (subcommand === "validate") return validateCommand(rest);
+	return (0, neverthrow.err)(cliErrors.unknownSubcommand("artifact", subcommand));
+};
+
+//#endregion
 //#region packages/cli/src/schemas/args.ts
 const CodegenArgsSchema = zod.z.object({
 	config: zod.z.string().optional(),
@@ -82,28 +358,16 @@ const parseArgs = (args, schema) => {
 //#region packages/cli/src/commands/codegen.ts
 const parseCodegenArgs = (argv) => {
 	const parsed = parseArgs([...argv], CodegenArgsSchema);
-	if (!parsed.isOk()) return (0, neverthrow.err)({
-		code: "EMIT_FAILED",
-		message: parsed.error,
-		outPath: ""
-	});
+	if (!parsed.isOk()) return (0, neverthrow.err)(cliErrors.argsInvalid("codegen", parsed.error));
 	const args = parsed.value;
 	if (args["emit-inject-template"]) return (0, neverthrow.ok)({
 		kind: "emitInjectTemplate",
 		outPath: args["emit-inject-template"]
 	});
 	const configResult = (0, __soda_gql_config.loadConfig)(args.config);
-	if (configResult.isErr()) return (0, neverthrow.err)({
-		code: "EMIT_FAILED",
-		message: `Failed to load config: ${configResult.error.message}`,
-		outPath: ""
-	});
+	if (configResult.isErr()) return (0, neverthrow.err)(cliErrors.fromConfig(configResult.error));
 	const config = configResult.value;
-	if (!config.schemas || Object.keys(config.schemas).length === 0) return (0, neverthrow.err)({
-		code: "EMIT_FAILED",
-		message: "schemas configuration is required in soda-gql.config.ts",
-		outPath: ""
-	});
+	if (!config.schemas || Object.keys(config.schemas).length === 0) return (0, neverthrow.err)(cliErrors.argsInvalid("codegen", "schemas configuration is required in soda-gql.config.ts"));
 	const schemas = {};
 	for (const [name, schemaConfig] of Object.entries(config.schemas)) schemas[name] = {
 		schema: schemaConfig.schema,
@@ -125,20 +389,6 @@ const formatSuccess$1 = (success) => {
 const formatTemplateSuccess = (outPath) => {
 	return `Created inject template → ${outPath}`;
 };
-const errorHints = {
-	SCHEMA_NOT_FOUND: "Verify the schema path in soda-gql.config.ts",
-	SCHEMA_INVALID: "Check your GraphQL schema for syntax errors",
-	INJECT_MODULE_NOT_FOUND: "Run: soda-gql codegen --emit-inject-template <path>",
-	INJECT_MODULE_REQUIRED: "Add inject configuration to your schema in soda-gql.config.ts",
-	INJECT_TEMPLATE_EXISTS: "Delete the existing file to regenerate, or use a different path",
-	EMIT_FAILED: "Check write permissions and that the output directory exists"
-};
-const formatCodegenError = (error) => {
-	const message = "message" in error ? error.message : "Unknown error";
-	const hint = errorHints[error.code];
-	const hintLine = hint ? `\n  Hint: ${hint}` : "";
-	return `${error.code}: ${message}${hintLine}`;
-};
 const CODEGEN_HELP = `Usage: soda-gql codegen [options]
 
 Generate graphql-system runtime module from GraphQL schema.
@@ -153,58 +403,37 @@ Examples:
   soda-gql codegen --emit-inject-template ./src/graphql/scalars.ts
 `;
 const codegenCommand = async (argv) => {
-	if (argv.includes("--help") || argv.includes("-h")) {
-		process.stdout.write(CODEGEN_HELP);
-		return 0;
-	}
-	try {
-		const parsed = parseCodegenArgs(argv);
-		if (parsed.isErr()) {
-			process.stderr.write(`${formatCodegenError(parsed.error)}\n`);
-			return 1;
-		}
-		const command = parsed.value;
-		if (command.kind === "emitInjectTemplate") {
-			const outPath = (0, node_path.resolve)(command.outPath);
-			const result$1 = (0, __soda_gql_codegen.writeInjectTemplate)(outPath);
-			if (result$1.isErr()) {
-				process.stderr.write(`${formatCodegenError(result$1.error)}\n`);
-				return 1;
-			}
-			process.stdout.write(`${formatTemplateSuccess(outPath)}\n`);
-			return 0;
-		}
-		const resolvedSchemas = {};
-		for (const [name, schemaConfig] of Object.entries(command.schemas)) resolvedSchemas[name] = {
-			schema: (0, node_path.resolve)(schemaConfig.schema),
-			inject: {
-				scalars: (0, node_path.resolve)(schemaConfig.inject.scalars),
-				...schemaConfig.inject.adapter ? { adapter: (0, node_path.resolve)(schemaConfig.inject.adapter) } : {}
-			},
-			defaultInputDepth: schemaConfig.defaultInputDepth,
-			inputDepthOverrides: schemaConfig.inputDepthOverrides
-		};
-		const result = await (0, __soda_gql_codegen.runCodegen)({
-			schemas: resolvedSchemas,
-			outPath: (0, node_path.resolve)(command.outPath),
-			format: "human",
-			importExtension: command.importExtension
-		});
-		if (result.isErr()) {
-			process.stderr.write(`${formatCodegenError(result.error)}\n`);
-			return 1;
-		}
-		process.stdout.write(`${formatSuccess$1(result.value)}\n`);
-		return 0;
-	} catch (error) {
-		const unexpectedError = {
-			code: "EMIT_FAILED",
-			message: error instanceof Error ? error.message : String(error),
-			outPath: ""
-		};
-		process.stderr.write(`${formatCodegenError(unexpectedError)}\n`);
-		return 1;
+	if (argv.includes("--help") || argv.includes("-h")) return (0, neverthrow.ok)({ message: CODEGEN_HELP });
+	const parsed = parseCodegenArgs(argv);
+	if (parsed.isErr()) return (0, neverthrow.err)(parsed.error);
+	const command = parsed.value;
+	if (command.kind === "emitInjectTemplate") {
+		const outPath = (0, node_path.resolve)(command.outPath);
+		const result$1 = (0, __soda_gql_codegen.writeInjectTemplate)(outPath);
+		if (result$1.isErr()) return (0, neverthrow.err)(cliErrors.fromCodegen(result$1.error));
+		return (0, neverthrow.ok)({ message: formatTemplateSuccess(outPath) });
 	}
+	const resolvedSchemas = {};
+	for (const [name, schemaConfig] of Object.entries(command.schemas)) resolvedSchemas[name] = {
+		schema: (0, node_path.resolve)(schemaConfig.schema),
+		inject: {
+			scalars: (0, node_path.resolve)(schemaConfig.inject.scalars),
+			...schemaConfig.inject.adapter ? { adapter: (0, node_path.resolve)(schemaConfig.inject.adapter) } : {}
+		},
+		defaultInputDepth: schemaConfig.defaultInputDepth,
+		inputDepthOverrides: schemaConfig.inputDepthOverrides
+	};
+	const result = await (0, __soda_gql_codegen.runCodegen)({
+		schemas: resolvedSchemas,
+		outPath: (0, node_path.resolve)(command.outPath),
+		format: "human",
+		importExtension: command.importExtension
+	});
+	if (result.isErr()) return (0, neverthrow.err)(cliErrors.fromCodegen(result.error));
+	return (0, neverthrow.ok)({
+		message: formatSuccess$1(result.value),
+		data: result.value
+	});
 };
 
 //#endregion
@@ -216,22 +445,19 @@ const loadFormatter = async () => {
 		return null;
 	}
 };
-const formatFormatError = (error) => {
-	return `${error.code}: ${error.message}`;
-};
-const formatResult = (result) => {
-	if (result.mode === "check") {
-		if (result.unformatted.length > 0) {
-			const files = result.unformatted.map((f) => `  ${f}`).join("\n");
-			return `${result.unformatted.length} file(s) need formatting:\n${files}`;
+const formatResultMessage = (data) => {
+	if (data.mode === "check") {
+		if (data.unformatted.length > 0) {
+			const files = data.unformatted.map((f) => `  ${f}`).join("\n");
+			return `${data.unformatted.length} file(s) need formatting:\n${files}`;
 		}
-		return `All ${result.total} file(s) are properly formatted`;
+		return `All ${data.total} file(s) are properly formatted`;
 	}
 	const parts = [];
-	if (result.modified > 0) parts.push(`${result.modified} formatted`);
-	if (result.unchanged > 0) parts.push(`${result.unchanged} unchanged`);
-	if (result.errors > 0) parts.push(`${result.errors} errors`);
-	return `${result.total} file(s) checked: ${parts.join(", ")}`;
+	if (data.modified > 0) parts.push(`${data.modified} formatted`);
+	if (data.unchanged > 0) parts.push(`${data.unchanged} unchanged`);
+	if (data.errors > 0) parts.push(`${data.errors} errors`);
+	return `${data.total} file(s) checked: ${parts.join(", ")}`;
 };
 const isGlobPattern = (pattern) => {
 	return /[*?[\]{}]/.test(pattern);
@@ -269,19 +495,9 @@ Examples:
   soda-gql format --check             # Check mode with config
 `;
 const formatCommand = async (argv) => {
-	if (argv.includes("--help") || argv.includes("-h")) {
-		process.stdout.write(FORMAT_HELP);
-		return 0;
-	}
+	if (argv.includes("--help") || argv.includes("-h")) return (0, neverthrow.ok)({ message: FORMAT_HELP });
 	const parsed = parseArgs([...argv], FormatArgsSchema);
-	if (!parsed.isOk()) {
-		const error = {
-			code: "PARSE_ERROR",
-			message: parsed.error
-		};
-		process.stderr.write(`${formatFormatError(error)}\n`);
-		return 1;
-	}
+	if (!parsed.isOk()) return (0, neverthrow.err)(cliErrors.argsInvalid("format", parsed.error));
 	const args = parsed.value;
 	const isCheckMode = args.check === true;
 	const explicitPatterns = args._ ?? [];
@@ -290,36 +506,27 @@ const formatCommand = async (argv) => {
 	if (explicitPatterns.length > 0) targetPatterns = explicitPatterns;
 	else {
 		const configResult = (0, __soda_gql_config.loadConfig)(args.config);
-		if (configResult.isErr()) {
-			process.stderr.write(`${formatFormatError({
-				code: "NO_PATTERNS",
-				message: "No patterns provided and config not found. Usage: soda-gql format [patterns...] [--check]"
-			})}\n`);
-			return 1;
-		}
+		if (configResult.isErr()) return (0, neverthrow.err)(cliErrors.noPatterns());
 		targetPatterns = configResult.value.include;
 		excludePatterns = configResult.value.exclude;
 	}
 	const formatter = await loadFormatter();
-	if (!formatter) {
-		process.stderr.write(`${formatFormatError({
-			code: "FORMATTER_NOT_INSTALLED",
-			message: "@soda-gql/formatter is not installed. Run: npm install @soda-gql/formatter"
-		})}\n`);
-		return 1;
-	}
+	if (!formatter) return (0, neverthrow.err)(cliErrors.formatterNotInstalled());
 	const files = await expandGlobPatterns(targetPatterns, excludePatterns);
 	if (files.length === 0) {
-		const result$1 = {
+		const data$1 = {
 			mode: isCheckMode ? "check" : "format",
 			total: 0,
 			modified: 0,
 			unchanged: 0,
 			errors: 0,
-			unformatted: []
+			unformatted: [],
+			hasFormattingIssues: false
 		};
-		process.stdout.write(`${formatResult(result$1)}\n`);
-		return 0;
+		return (0, neverthrow.ok)({
+			message: formatResultMessage(data$1),
+			data: data$1
+		});
 	}
 	let modified = 0;
 	let unchanged = 0;
@@ -328,44 +535,46 @@ const formatCommand = async (argv) => {
 	for (const filePath of files) {
 		const sourceCode = await (0, node_fs_promises.readFile)(filePath, "utf-8");
 		if (isCheckMode) {
-			const result$1 = formatter.needsFormat({
+			const result = formatter.needsFormat({
 				sourceCode,
 				filePath
 			});
-			if (result$1.isErr()) {
+			if (result.isErr()) {
 				errors++;
 				continue;
 			}
-			if (result$1.value) {
+			if (result.value) {
 				unformatted.push(filePath);
 				modified++;
 			} else unchanged++;
 		} else {
-			const result$1 = formatter.format({
+			const result = formatter.format({
 				sourceCode,
 				filePath
 			});
-			if (result$1.isErr()) {
+			if (result.isErr()) {
 				errors++;
 				continue;
 			}
-			if (result$1.value.modified) {
-				await (0, node_fs_promises.writeFile)(filePath, result$1.value.sourceCode, "utf-8");
+			if (result.value.modified) {
+				await (0, node_fs_promises.writeFile)(filePath, result.value.sourceCode, "utf-8");
 				modified++;
 			} else unchanged++;
 		}
 	}
-	const result = {
+	const data = {
 		mode: isCheckMode ? "check" : "format",
 		total: files.length,
 		modified,
 		unchanged,
 		errors,
-		unformatted
+		unformatted,
+		hasFormattingIssues: isCheckMode && unformatted.length > 0 || errors > 0
 	};
-	process.stdout.write(`${formatResult(result)}\n`);
-	if (isCheckMode && unformatted.length > 0) return 1;
-	return errors > 0 ? 1 : 0;
+	return (0, neverthrow.ok)({
+		message: formatResultMessage(data),
+		data
+	});
 };
 
 //#endregion
@@ -439,11 +648,7 @@ Generated files:
 `;
 const checkFilesExist = (files, force) => {
 	if (force) return (0, neverthrow.ok)(void 0);
-	for (const file of files) if ((0, node_fs.existsSync)(file.path)) return (0, neverthrow.err)({
-		code: "FILE_EXISTS",
-		message: `File already exists: ${file.path}. Use --force to overwrite.`,
-		filePath: file.path
-	});
+	for (const file of files) if ((0, node_fs.existsSync)(file.path)) return (0, neverthrow.err)(cliErrors.fileExists(file.path));
 	return (0, neverthrow.ok)(void 0);
 };
 const writeFiles = (files) => {
@@ -454,11 +659,7 @@ const writeFiles = (files) => {
 		createdPaths.push(file.path);
 	} catch (error) {
 		const message = error instanceof Error ? error.message : String(error);
-		return (0, neverthrow.err)({
-			code: "WRITE_FAILED",
-			message: `Failed to write ${file.description}: ${message}`,
-			filePath: file.path
-		});
+		return (0, neverthrow.err)(cliErrors.writeFailed(file.path, `Failed to write ${file.description}: ${message}`, error));
 	}
 	return (0, neverthrow.ok)({ filesCreated: createdPaths });
 };
@@ -475,23 +676,10 @@ const formatSuccess = (result) => {
 	lines.push("  3. Import gql from ./graphql-system");
 	return lines.join("\n");
 };
-const formatInitError = (error) => {
-	return `${error.code}: ${error.message}`;
-};
 const initCommand = async (argv) => {
-	if (argv.includes("--help") || argv.includes("-h")) {
-		process.stdout.write(INIT_HELP);
-		return 0;
-	}
+	if (argv.includes("--help") || argv.includes("-h")) return (0, neverthrow.ok)({ message: INIT_HELP });
 	const parsed = parseArgs([...argv], InitArgsSchema);
-	if (!parsed.isOk()) {
-		const error = {
-			code: "PARSE_ERROR",
-			message: parsed.error
-		};
-		process.stderr.write(`${formatInitError(error)}\n`);
-		return 1;
-	}
+	if (!parsed.isOk()) return (0, neverthrow.err)(cliErrors.argsInvalid("init", parsed.error));
 	const force = parsed.value.force === true;
 	const cwd = process.cwd();
 	const files = [
@@ -517,52 +705,180 @@ const initCommand = async (argv) => {
 		}
 	];
 	const existsCheck = checkFilesExist(files, force);
-	if (existsCheck.isErr()) {
-		process.stderr.write(`${formatInitError(existsCheck.error)}\n`);
-		return 1;
-	}
+	if (existsCheck.isErr()) return (0, neverthrow.err)(existsCheck.error);
 	const writeResult = writeFiles(files);
-	if (writeResult.isErr()) {
-		process.stderr.write(`${formatInitError(writeResult.error)}\n`);
-		return 1;
-	}
-	process.stdout.write(`${formatSuccess(writeResult.value)}\n`);
-	return 0;
+	if (writeResult.isErr()) return (0, neverthrow.err)(writeResult.error);
+	return (0, neverthrow.ok)({
+		message: formatSuccess(writeResult.value),
+		data: writeResult.value
+	});
 };
 
 //#endregion
 //#region packages/cli/src/utils/format.ts
-const formatError = (error, format = "human") => {
-	if (format === "json") return JSON.stringify({ error }, null, 2);
-	return error instanceof Error ? error.message : String(error);
+/**
+* CLI-specific error hints to help users fix issues.
+*/
+const cliErrorHints = {
+	CLI_ARGS_INVALID: "Check command usage with --help",
+	CLI_UNKNOWN_COMMAND: "Run 'soda-gql --help' for available commands",
+	CLI_UNKNOWN_SUBCOMMAND: "Run the parent command with --help for available subcommands",
+	CLI_FILE_EXISTS: "Use --force flag to overwrite existing files",
+	CLI_FILE_NOT_FOUND: "Verify the file path exists",
+	CLI_WRITE_FAILED: "Check write permissions and disk space",
+	CLI_READ_FAILED: "Check file permissions and verify the file is not locked",
+	CLI_NO_PATTERNS: "Provide file patterns or create soda-gql.config.ts",
+	CLI_FORMATTER_NOT_INSTALLED: "Install with: bun add @soda-gql/formatter",
+	CLI_PARSE_ERROR: "Check the file for syntax errors",
+	CLI_FORMAT_ERROR: "Verify the file contains valid soda-gql code",
+	CLI_UNEXPECTED: "This is an unexpected error. Please report at https://github.com/soda-gql/soda-gql/issues"
+};
+/**
+* Codegen-specific error hints.
+*/
+const codegenErrorHints = {
+	SCHEMA_NOT_FOUND: "Verify the schema path in soda-gql.config.ts",
+	SCHEMA_INVALID: "Check your GraphQL schema for syntax errors",
+	INJECT_MODULE_NOT_FOUND: "Run: soda-gql codegen --emit-inject-template <path>",
+	INJECT_MODULE_REQUIRED: "Add inject configuration to your schema in soda-gql.config.ts",
+	INJECT_TEMPLATE_EXISTS: "Delete the existing file to regenerate, or use a different path",
+	EMIT_FAILED: "Check write permissions and that the output directory exists",
+	INJECT_TEMPLATE_FAILED: "Check write permissions for the output path"
+};
+/**
+* Config-specific error hints.
+*/
+const configErrorHints = {
+	CONFIG_NOT_FOUND: "Create a soda-gql.config.ts file in your project root",
+	CONFIG_LOAD_FAILED: "Check your configuration file for syntax errors",
+	CONFIG_VALIDATION_FAILED: "Verify your configuration matches the expected schema",
+	CONFIG_INVALID_PATH: "Verify the path in your configuration exists"
+};
+/**
+* Artifact-specific error hints.
+*/
+const artifactErrorHints = {
+	ARTIFACT_NOT_FOUND: "Verify the artifact file path exists",
+	ARTIFACT_PARSE_ERROR: "Check that the artifact file is valid JSON",
+	ARTIFACT_VALIDATION_ERROR: "Verify the artifact was built with a compatible version of soda-gql"
+};
+/**
+* Get hint for any error type.
+*/
+const getErrorHint = (error) => {
+	if (error.category === "cli") return cliErrorHints[error.code];
+	if (error.category === "codegen") return codegenErrorHints[error.error.code];
+	if (error.category === "config") return configErrorHints[error.error.code];
+	if (error.category === "artifact") return artifactErrorHints[error.error.code];
+};
+/**
+* Format CliError to human-readable string with hints.
+*/
+const formatCliErrorHuman = (error) => {
+	if (error.category === "builder") return (0, __soda_gql_builder.formatBuilderErrorForCLI)(error.error);
+	const lines = [];
+	if (error.category === "codegen") {
+		const codegenError = error.error;
+		lines.push(`Error [${codegenError.code}]: ${codegenError.message}`);
+		if ("schemaPath" in codegenError) lines.push(`  Schema: ${codegenError.schemaPath}`);
+		if ("outPath" in codegenError && codegenError.outPath) lines.push(`  Output: ${codegenError.outPath}`);
+		if ("injectPath" in codegenError) lines.push(`  Inject: ${codegenError.injectPath}`);
+	} else if (error.category === "config") {
+		const configError = error.error;
+		lines.push(`Error [${configError.code}]: ${configError.message}`);
+		if (configError.filePath) lines.push(`  Config: ${configError.filePath}`);
+	} else if (error.category === "artifact") {
+		const artifactError = error.error;
+		lines.push(`Error [${artifactError.code}]: ${artifactError.message}`);
+		if (artifactError.filePath) lines.push(`  Artifact: ${artifactError.filePath}`);
+	} else {
+		lines.push(`Error [${error.code}]: ${error.message}`);
+		if ("filePath" in error && error.filePath) lines.push(`  File: ${error.filePath}`);
+		if ("command" in error && error.code !== "CLI_UNKNOWN_COMMAND") lines.push(`  Command: ${error.command}`);
+		if ("parent" in error) lines.push(`  Parent: ${error.parent}`);
+	}
+	const hint = getErrorHint(error);
+	if (hint) {
+		lines.push("");
+		lines.push(`  Hint: ${hint}`);
+	}
+	return lines.join("\n");
+};
+/**
+* Format CliError to JSON string.
+*/
+const formatCliErrorJson = (error) => {
+	if (error.category === "cli") {
+		const { category: _category, ...rest } = error;
+		return JSON.stringify({ error: rest }, null, 2);
+	}
+	return JSON.stringify({ error: error.error }, null, 2);
+};
+/**
+* Format CliError with output format preference.
+*/
+const formatCliError = (error, format = "human") => {
+	return format === "json" ? formatCliErrorJson(error) : formatCliErrorHuman(error);
 };
 
 //#endregion
 //#region packages/cli/src/index.ts
+const MAIN_HELP = `Usage: soda-gql <command> [options]
+
+Commands:
+  init       Initialize a new soda-gql project
+  codegen    Generate graphql-system runtime module
+  format     Format soda-gql field selections
+  artifact   Manage soda-gql artifacts
+
+Run 'soda-gql <command> --help' for more information on a specific command.
+`;
+/**
+* Parse output format from argv.
+* Returns "json" if --format=json or --json flag is present, otherwise "human".
+*/
+const getOutputFormat = (argv) => {
+	for (const arg of argv) {
+		if (arg === "--format=json" || arg === "--json") return "json";
+		if (arg === "--format=human") return "human";
+	}
+	return "human";
+};
 const dispatch = async (argv) => {
 	const [command, ...rest] = argv;
-	if (!command || command === "--help" || command === "-h") {
-		process.stdout.write(`Usage: soda-gql <command> [options]\n`);
-		process.stdout.write(`\nCommands:\n`);
-		process.stdout.write(`  init       Initialize a new soda-gql project\n`);
-		process.stdout.write(`  codegen    Generate graphql-system runtime module\n`);
-		process.stdout.write(`  format     Format soda-gql field selections\n`);
-		return 0;
-	}
+	if (!command || command === "--help" || command === "-h") return (0, neverthrow.ok)({ message: MAIN_HELP });
 	if (command === "init") return initCommand(rest);
 	if (command === "codegen") return codegenCommand(rest);
-	if (command === "format") return formatCommand(rest);
-	process.stderr.write(`Unknown command: ${command}\n`);
-	return 1;
-};
-dispatch(process.argv.slice(2)).then((exitCode) => {
-	process.exitCode = exitCode;
-}).catch((error) => {
-	const unexpectedError = {
-		code: "UNEXPECTED_ERROR",
-		message: error instanceof Error ? error.message : String(error)
-	};
-	process.stderr.write(`${formatError(unexpectedError, "json")}\n`);
+	if (command === "format") {
+		const result = await formatCommand(rest);
+		if (result.isOk()) {
+			const exitCode = result.value.data?.hasFormattingIssues ? 1 : 0;
+			return (0, neverthrow.ok)({
+				...result.value,
+				exitCode
+			});
+		}
+		return (0, neverthrow.err)(result.error);
+	}
+	if (command === "artifact") return artifactCommand(rest);
+	return (0, neverthrow.err)(cliErrors.unknownCommand(command));
+};
+const main = async () => {
+	const argv = process.argv.slice(2);
+	const format = getOutputFormat(argv);
+	const result = await dispatch(argv);
+	if (result.isOk()) {
+		process.stdout.write(`${result.value.message}\n`);
+		process.exitCode = result.value.exitCode ?? 0;
+	} else {
+		process.stderr.write(`${formatCliError(result.error, format)}\n`);
+		process.exitCode = 1;
+	}
+};
+main().catch((error) => {
+	const unexpectedError = cliErrors.unexpected(error instanceof Error ? error.message : String(error), error);
+	const format = getOutputFormat(process.argv.slice(2));
+	process.stderr.write(`${formatCliError(unexpectedError, format)}\n`);
 	process.exitCode = 1;
 });
 

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["z","parsed: Record<string, unknown>","positional: string[]","schemas: Record<string, CodegenSchemaConfig>","formatSuccess","errorHints: Record<string, string>","result","resolvedSchemas: Record<string, CodegenSchemaConfig>","unexpectedError: CodegenError","parts: string[]","files: string[]","error: FormatError","targetPatterns: readonly string[]","excludePatterns: readonly string[]","result: FormatResult","result","unformatted: string[]","createdPaths: string[]","error: InitError","files: FileToGenerate[]"],"sources":["../src/schemas/args.ts","../src/utils/parse-args.ts","../src/commands/codegen.ts","../src/commands/format.ts","../src/templates/config.template.ts","../src/templates/gitignore.template.ts","../src/templates/inject.template.ts","../src/templates/schema.template.ts","../src/commands/init.ts","../src/utils/format.ts","../src/index.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const CodegenArgsSchema = z.object({\n  config: z.string().optional(),\n  \"emit-inject-template\": z.string().optional(),\n});\n\nexport const BuilderArgsSchema = z.object({\n  mode: z.enum([\"runtime\", \"zero-runtime\"]),\n  entry: z.string(),\n  out: z.string(),\n  format: z.enum([\"human\", \"json\"]).optional().default(\"human\"),\n});\n\nexport const FormatArgsSchema = z.object({\n  _: z.array(z.string()).optional(),\n  config: z.string().optional(),\n  check: z.boolean().optional(),\n});\n\nexport const InitArgsSchema = z.object({\n  force: z.boolean().optional(),\n});\n\nexport type CodegenArgs = z.infer<typeof CodegenArgsSchema>;\nexport type BuilderArgs = z.infer<typeof BuilderArgsSchema>;\nexport type FormatArgs = z.infer<typeof FormatArgsSchema>;\nexport type InitArgs = z.infer<typeof InitArgsSchema>;\n","import { err, ok, type Result } from \"neverthrow\";\nimport type { z } from \"zod\";\n\nexport const parseArgs = <T extends z.ZodType>(args: string[], schema: T): Result<z.infer<T>, string> => {\n  const parsed: Record<string, unknown> = {};\n  const positional: string[] = [];\n\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n    if (!arg) continue;\n\n    if (arg.startsWith(\"--\")) {\n      const key = arg.slice(2);\n      const nextArg = args[i + 1];\n\n      if (!nextArg || nextArg.startsWith(\"--\")) {\n        parsed[key] = true;\n      } else {\n        parsed[key] = nextArg;\n        i++;\n      }\n    } else {\n      positional.push(arg);\n    }\n  }\n\n  if (positional.length > 0) {\n    parsed._ = positional;\n  }\n\n  const result = schema.safeParse(parsed);\n  if (!result.success) {\n    return err(result.error.issues.map((e) => e.message).join(\", \"));\n  }\n\n  return ok(result.data);\n};\n","import { resolve } from \"node:path\";\nimport type { CodegenError, CodegenSchemaConfig, CodegenSuccess } from \"@soda-gql/codegen\";\nimport { runCodegen, writeInjectTemplate } from \"@soda-gql/codegen\";\nimport { loadConfig } from \"@soda-gql/config\";\nimport { err, ok, type Result } from \"neverthrow\";\nimport { CodegenArgsSchema } from \"../schemas/args\";\nimport { parseArgs } from \"../utils/parse-args\";\n\ntype ParsedCommand =\n  | {\n      kind: \"emitInjectTemplate\";\n      outPath: string;\n    }\n  | {\n      kind: \"generate\";\n      schemas: Record<string, CodegenSchemaConfig>;\n      outPath: string;\n      importExtension: boolean;\n    };\n\nconst parseCodegenArgs = (argv: readonly string[]): Result<ParsedCommand, CodegenError> => {\n  const parsed = parseArgs([...argv], CodegenArgsSchema);\n\n  if (!parsed.isOk()) {\n    return err<ParsedCommand, CodegenError>({\n      code: \"EMIT_FAILED\",\n      message: parsed.error,\n      outPath: \"\",\n    });\n  }\n\n  const args = parsed.value;\n\n  // Handle emit inject template\n  if (args[\"emit-inject-template\"]) {\n    return ok<ParsedCommand, CodegenError>({\n      kind: \"emitInjectTemplate\",\n      outPath: args[\"emit-inject-template\"],\n    });\n  }\n\n  // Load config from @soda-gql/config\n  const configResult = loadConfig(args.config);\n  if (configResult.isErr()) {\n    return err<ParsedCommand, CodegenError>({\n      code: \"EMIT_FAILED\",\n      message: `Failed to load config: ${configResult.error.message}`,\n      outPath: \"\",\n    });\n  }\n\n  const config = configResult.value;\n\n  // Check if schemas config exists\n  if (!config.schemas || Object.keys(config.schemas).length === 0) {\n    return err<ParsedCommand, CodegenError>({\n      code: \"EMIT_FAILED\",\n      message: \"schemas configuration is required in soda-gql.config.ts\",\n      outPath: \"\",\n    });\n  }\n\n  // Build schemas config with resolved paths\n  const schemas: Record<string, CodegenSchemaConfig> = {};\n\n  for (const [name, schemaConfig] of Object.entries(config.schemas)) {\n    schemas[name] = {\n      schema: schemaConfig.schema,\n      inject: schemaConfig.inject,\n      defaultInputDepth: schemaConfig.defaultInputDepth,\n      inputDepthOverrides: schemaConfig.inputDepthOverrides,\n    };\n  }\n\n  // Derive output path from outdir (default to index.ts)\n  const outPath = resolve(config.outdir, \"index.ts\");\n\n  return ok<ParsedCommand, CodegenError>({\n    kind: \"generate\",\n    schemas,\n    outPath,\n    importExtension: config.styles.importExtension,\n  });\n};\n\nconst formatSuccess = (success: CodegenSuccess): string => {\n  const schemaNames = Object.keys(success.schemas).join(\", \");\n  const totalObjects = Object.values(success.schemas).reduce((sum, s) => sum + s.objects, 0);\n  return `Generated ${totalObjects} objects from schemas: ${schemaNames}\\n  TypeScript: ${success.outPath}\\n  CommonJS: ${success.cjsPath}`;\n};\n\nconst formatTemplateSuccess = (outPath: string): string => {\n  return `Created inject template → ${outPath}`;\n};\n\nconst errorHints: Record<string, string> = {\n  SCHEMA_NOT_FOUND: \"Verify the schema path in soda-gql.config.ts\",\n  SCHEMA_INVALID: \"Check your GraphQL schema for syntax errors\",\n  INJECT_MODULE_NOT_FOUND: \"Run: soda-gql codegen --emit-inject-template <path>\",\n  INJECT_MODULE_REQUIRED: \"Add inject configuration to your schema in soda-gql.config.ts\",\n  INJECT_TEMPLATE_EXISTS: \"Delete the existing file to regenerate, or use a different path\",\n  EMIT_FAILED: \"Check write permissions and that the output directory exists\",\n};\n\nconst formatCodegenError = (error: CodegenError): string => {\n  const message = \"message\" in error ? error.message : \"Unknown error\";\n  const hint = errorHints[error.code];\n  const hintLine = hint ? `\\n  Hint: ${hint}` : \"\";\n  return `${error.code}: ${message}${hintLine}`;\n};\n\nconst CODEGEN_HELP = `Usage: soda-gql codegen [options]\n\nGenerate graphql-system runtime module from GraphQL schema.\n\nOptions:\n  --config <path>                Path to soda-gql.config.ts\n  --emit-inject-template <path>  Create inject template file\n  --help, -h                     Show this help message\n\nExamples:\n  soda-gql codegen --config ./soda-gql.config.ts\n  soda-gql codegen --emit-inject-template ./src/graphql/scalars.ts\n`;\n\nexport const codegenCommand = async (argv: readonly string[]): Promise<number> => {\n  if (argv.includes(\"--help\") || argv.includes(\"-h\")) {\n    process.stdout.write(CODEGEN_HELP);\n    return 0;\n  }\n\n  try {\n    const parsed = parseCodegenArgs(argv);\n\n    if (parsed.isErr()) {\n      process.stderr.write(`${formatCodegenError(parsed.error)}\\n`);\n      return 1;\n    }\n\n    const command = parsed.value;\n\n    if (command.kind === \"emitInjectTemplate\") {\n      const outPath = resolve(command.outPath);\n      const result = writeInjectTemplate(outPath);\n      if (result.isErr()) {\n        process.stderr.write(`${formatCodegenError(result.error)}\\n`);\n        return 1;\n      }\n      process.stdout.write(`${formatTemplateSuccess(outPath)}\\n`);\n      return 0;\n    }\n\n    // Resolve all paths in schemas config\n    const resolvedSchemas: Record<string, CodegenSchemaConfig> = {};\n    for (const [name, schemaConfig] of Object.entries(command.schemas)) {\n      resolvedSchemas[name] = {\n        schema: resolve(schemaConfig.schema),\n        inject: {\n          scalars: resolve(schemaConfig.inject.scalars),\n          ...(schemaConfig.inject.adapter ? { adapter: resolve(schemaConfig.inject.adapter) } : {}),\n        },\n        defaultInputDepth: schemaConfig.defaultInputDepth,\n        inputDepthOverrides: schemaConfig.inputDepthOverrides,\n      };\n    }\n\n    const result = await runCodegen({\n      schemas: resolvedSchemas,\n      outPath: resolve(command.outPath),\n      format: \"human\",\n      importExtension: command.importExtension,\n    });\n\n    if (result.isErr()) {\n      process.stderr.write(`${formatCodegenError(result.error)}\\n`);\n      return 1;\n    }\n\n    process.stdout.write(`${formatSuccess(result.value)}\\n`);\n    return 0;\n  } catch (error) {\n    // Catch unexpected errors and convert to structured format\n    const unexpectedError: CodegenError = {\n      code: \"EMIT_FAILED\",\n      message: error instanceof Error ? error.message : String(error),\n      outPath: \"\",\n    };\n    process.stderr.write(`${formatCodegenError(unexpectedError)}\\n`);\n    return 1;\n  }\n};\n","import { access, readFile, writeFile } from \"node:fs/promises\";\nimport { loadConfig } from \"@soda-gql/config\";\nimport fg from \"fast-glob\";\nimport { FormatArgsSchema } from \"../schemas/args\";\nimport { parseArgs } from \"../utils/parse-args\";\n\ntype FormatterModule = typeof import(\"@soda-gql/formatter\");\n\nconst loadFormatter = async (): Promise<FormatterModule | null> => {\n  try {\n    return await import(\"@soda-gql/formatter\");\n  } catch {\n    return null;\n  }\n};\n\ntype FormatError = {\n  code: \"PARSE_ERROR\" | \"NO_PATTERNS\" | \"FORMAT_ERROR\" | \"FORMATTER_NOT_INSTALLED\";\n  message: string;\n};\n\ntype FormatResult = {\n  mode: \"format\" | \"check\";\n  total: number;\n  modified: number;\n  unchanged: number;\n  errors: number;\n  unformatted: string[];\n};\n\nconst formatFormatError = (error: FormatError): string => {\n  return `${error.code}: ${error.message}`;\n};\n\nconst formatResult = (result: FormatResult): string => {\n  if (result.mode === \"check\") {\n    if (result.unformatted.length > 0) {\n      const files = result.unformatted.map((f) => `  ${f}`).join(\"\\n\");\n      return `${result.unformatted.length} file(s) need formatting:\\n${files}`;\n    }\n    return `All ${result.total} file(s) are properly formatted`;\n  }\n\n  const parts: string[] = [];\n  if (result.modified > 0) {\n    parts.push(`${result.modified} formatted`);\n  }\n  if (result.unchanged > 0) {\n    parts.push(`${result.unchanged} unchanged`);\n  }\n  if (result.errors > 0) {\n    parts.push(`${result.errors} errors`);\n  }\n  return `${result.total} file(s) checked: ${parts.join(\", \")}`;\n};\n\nconst isGlobPattern = (pattern: string): boolean => {\n  return /[*?[\\]{}]/.test(pattern);\n};\n\nconst expandGlobPatterns = async (patterns: readonly string[], excludePatterns: readonly string[] = []): Promise<string[]> => {\n  const files: string[] = [];\n\n  for (const pattern of patterns) {\n    if (!isGlobPattern(pattern)) {\n      // Direct file path - check if it exists\n      try {\n        await access(pattern);\n        files.push(pattern);\n      } catch {\n        // File doesn't exist, skip it\n      }\n      continue;\n    }\n\n    // Glob pattern - use fast-glob with ignore\n    const matches = await fg(pattern, {\n      absolute: true,\n      ignore: [...excludePatterns],\n    });\n    files.push(...matches);\n  }\n\n  return [...new Set(files)];\n};\n\nconst FORMAT_HELP = `Usage: soda-gql format [patterns...] [options]\n\nFormat soda-gql field selections by inserting empty comments.\n\nOptions:\n  --config <path>  Path to soda-gql.config.ts (auto-detected if omitted)\n  --check          Check if files need formatting (exit 1 if unformatted)\n  --help, -h       Show this help message\n\nExamples:\n  soda-gql format                     # Use config include/exclude\n  soda-gql format \"src/**/*.ts\"       # Override with explicit patterns\n  soda-gql format --check             # Check mode with config\n`;\n\nexport const formatCommand = async (argv: readonly string[]): Promise<number> => {\n  if (argv.includes(\"--help\") || argv.includes(\"-h\")) {\n    process.stdout.write(FORMAT_HELP);\n    return 0;\n  }\n\n  const parsed = parseArgs([...argv], FormatArgsSchema);\n\n  if (!parsed.isOk()) {\n    const error: FormatError = {\n      code: \"PARSE_ERROR\",\n      message: parsed.error,\n    };\n    process.stderr.write(`${formatFormatError(error)}\\n`);\n    return 1;\n  }\n\n  const args = parsed.value;\n  const isCheckMode = args.check === true;\n  const explicitPatterns = args._ ?? [];\n\n  // Determine patterns: use explicit patterns or load from config\n  let targetPatterns: readonly string[];\n  let excludePatterns: readonly string[] = [];\n\n  if (explicitPatterns.length > 0) {\n    targetPatterns = explicitPatterns;\n  } else {\n    // Try to load patterns from config\n    const configResult = loadConfig(args.config);\n    if (configResult.isErr()) {\n      const error: FormatError = {\n        code: \"NO_PATTERNS\",\n        message: \"No patterns provided and config not found. Usage: soda-gql format [patterns...] [--check]\",\n      };\n      process.stderr.write(`${formatFormatError(error)}\\n`);\n      return 1;\n    }\n    targetPatterns = configResult.value.include;\n    excludePatterns = configResult.value.exclude;\n  }\n\n  // Load formatter lazily - it's an optional dependency\n  const formatter = await loadFormatter();\n  if (!formatter) {\n    const error: FormatError = {\n      code: \"FORMATTER_NOT_INSTALLED\",\n      message: \"@soda-gql/formatter is not installed. Run: npm install @soda-gql/formatter\",\n    };\n    process.stderr.write(`${formatFormatError(error)}\\n`);\n    return 1;\n  }\n\n  const files = await expandGlobPatterns(targetPatterns, excludePatterns);\n\n  if (files.length === 0) {\n    const result: FormatResult = {\n      mode: isCheckMode ? \"check\" : \"format\",\n      total: 0,\n      modified: 0,\n      unchanged: 0,\n      errors: 0,\n      unformatted: [],\n    };\n    process.stdout.write(`${formatResult(result)}\\n`);\n    return 0;\n  }\n\n  let modified = 0;\n  let unchanged = 0;\n  let errors = 0;\n  const unformatted: string[] = [];\n\n  for (const filePath of files) {\n    const sourceCode = await readFile(filePath, \"utf-8\");\n\n    if (isCheckMode) {\n      const result = formatter.needsFormat({ sourceCode, filePath });\n      if (result.isErr()) {\n        errors++;\n        continue;\n      }\n      if (result.value) {\n        unformatted.push(filePath);\n        modified++;\n      } else {\n        unchanged++;\n      }\n    } else {\n      const result = formatter.format({ sourceCode, filePath });\n      if (result.isErr()) {\n        errors++;\n        continue;\n      }\n      if (result.value.modified) {\n        await writeFile(filePath, result.value.sourceCode, \"utf-8\");\n        modified++;\n      } else {\n        unchanged++;\n      }\n    }\n  }\n\n  const result: FormatResult = {\n    mode: isCheckMode ? \"check\" : \"format\",\n    total: files.length,\n    modified,\n    unchanged,\n    errors,\n    unformatted,\n  };\n\n  process.stdout.write(`${formatResult(result)}\\n`);\n\n  if (isCheckMode && unformatted.length > 0) {\n    return 1;\n  }\n\n  return errors > 0 ? 1 : 0;\n};\n","export const getConfigTemplate = (): string => `\\\nimport { defineConfig } from \"@soda-gql/config\";\n\nexport default defineConfig({\n  outdir: \"./graphql-system\",\n  include: [\"./src/**/*.ts\"],\n  schemas: {\n    default: {\n      schema: \"./schema.graphql\",\n      inject: \"./graphql-system/default.inject.ts\",\n    },\n  },\n});\n`;\n","export const getGitignoreTemplate = (): string => `\\\n/index.ts\n/index.cjs\n`;\n","export const getInjectTemplate = (): string => `\\\nimport { defineAdapter, defineScalar } from \"@soda-gql/core/adapter\";\n\nexport const scalar = {\n  ...defineScalar<\"ID\", string, string>(\"ID\"),\n  ...defineScalar<\"String\", string, string>(\"String\"),\n  ...defineScalar<\"Int\", number, number>(\"Int\"),\n  ...defineScalar<\"Float\", number, number>(\"Float\"),\n  ...defineScalar<\"Boolean\", boolean, boolean>(\"Boolean\"),\n} as const;\n\nexport const adapter = defineAdapter({\n  helpers: {},\n  metadata: {\n    aggregateFragmentMetadata: (fragments) => fragments.map((m) => m.metadata),\n  },\n});\n`;\n","export const getSchemaTemplate = (): string => `\\\ntype Query {\n  hello: String!\n}\n`;\n","import { existsSync, mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport { err, ok, type Result } from \"neverthrow\";\n\nimport { InitArgsSchema } from \"../schemas/args\";\nimport { getConfigTemplate } from \"../templates/config.template\";\nimport { getGitignoreTemplate } from \"../templates/gitignore.template\";\nimport { getInjectTemplate } from \"../templates/inject.template\";\nimport { getSchemaTemplate } from \"../templates/schema.template\";\nimport { parseArgs } from \"../utils/parse-args\";\n\ntype InitErrorCode = \"FILE_EXISTS\" | \"WRITE_FAILED\" | \"PARSE_ERROR\";\n\ntype InitError = {\n  readonly code: InitErrorCode;\n  readonly message: string;\n  readonly filePath?: string;\n};\n\ntype FileToGenerate = {\n  readonly path: string;\n  readonly content: string;\n  readonly description: string;\n};\n\ntype InitSuccess = {\n  readonly filesCreated: readonly string[];\n};\n\nconst INIT_HELP = `Usage: soda-gql init [options]\n\nInitialize a new soda-gql project with starter configuration.\n\nOptions:\n  --force       Overwrite existing files\n  --help, -h    Show this help message\n\nGenerated files:\n  soda-gql.config.ts                Configuration file\n  schema.graphql                    Sample GraphQL schema\n  graphql-system/default.inject.ts  Scalars, helpers, and metadata adapter\n  graphql-system/.gitignore         Ignore generated files\n`;\n\nconst checkFilesExist = (files: readonly FileToGenerate[], force: boolean): Result<void, InitError> => {\n  if (force) {\n    return ok(undefined);\n  }\n\n  for (const file of files) {\n    if (existsSync(file.path)) {\n      return err({\n        code: \"FILE_EXISTS\",\n        message: `File already exists: ${file.path}. Use --force to overwrite.`,\n        filePath: file.path,\n      });\n    }\n  }\n\n  return ok(undefined);\n};\n\nconst writeFiles = (files: readonly FileToGenerate[]): Result<InitSuccess, InitError> => {\n  const createdPaths: string[] = [];\n\n  for (const file of files) {\n    try {\n      const dir = dirname(file.path);\n      mkdirSync(dir, { recursive: true });\n      writeFileSync(file.path, file.content);\n      createdPaths.push(file.path);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return err({\n        code: \"WRITE_FAILED\",\n        message: `Failed to write ${file.description}: ${message}`,\n        filePath: file.path,\n      });\n    }\n  }\n\n  return ok({ filesCreated: createdPaths });\n};\n\nconst formatSuccess = (result: InitSuccess): string => {\n  const lines = [\"soda-gql project initialized successfully!\", \"\", \"Created files:\"];\n  for (const file of result.filesCreated) {\n    lines.push(`  ${file}`);\n  }\n  lines.push(\"\", \"Next steps:\");\n  lines.push(\"  1. Edit schema.graphql with your GraphQL types\");\n  lines.push(\"  2. Run: soda-gql codegen\");\n  lines.push(\"  3. Import gql from ./graphql-system\");\n  return lines.join(\"\\n\");\n};\n\nconst formatInitError = (error: InitError): string => {\n  return `${error.code}: ${error.message}`;\n};\n\nexport const initCommand = async (argv: readonly string[]): Promise<number> => {\n  if (argv.includes(\"--help\") || argv.includes(\"-h\")) {\n    process.stdout.write(INIT_HELP);\n    return 0;\n  }\n\n  const parsed = parseArgs([...argv], InitArgsSchema);\n\n  if (!parsed.isOk()) {\n    const error: InitError = {\n      code: \"PARSE_ERROR\",\n      message: parsed.error,\n    };\n    process.stderr.write(`${formatInitError(error)}\\n`);\n    return 1;\n  }\n\n  const args = parsed.value;\n  const force = args.force === true;\n  const cwd = process.cwd();\n\n  const files: FileToGenerate[] = [\n    {\n      path: resolve(cwd, \"soda-gql.config.ts\"),\n      content: getConfigTemplate(),\n      description: \"configuration file\",\n    },\n    {\n      path: resolve(cwd, \"schema.graphql\"),\n      content: getSchemaTemplate(),\n      description: \"GraphQL schema\",\n    },\n    {\n      path: resolve(cwd, \"graphql-system/default.inject.ts\"),\n      content: getInjectTemplate(),\n      description: \"inject module\",\n    },\n    {\n      path: resolve(cwd, \"graphql-system/.gitignore\"),\n      content: getGitignoreTemplate(),\n      description: \"gitignore file\",\n    },\n  ];\n\n  const existsCheck = checkFilesExist(files, force);\n  if (existsCheck.isErr()) {\n    process.stderr.write(`${formatInitError(existsCheck.error)}\\n`);\n    return 1;\n  }\n\n  const writeResult = writeFiles(files);\n  if (writeResult.isErr()) {\n    process.stderr.write(`${formatInitError(writeResult.error)}\\n`);\n    return 1;\n  }\n\n  process.stdout.write(`${formatSuccess(writeResult.value)}\\n`);\n  return 0;\n};\n","export const formatters = {\n  json: (data: unknown) => JSON.stringify(data, null, 2),\n  human: (data: unknown) => {\n    if (typeof data === \"string\") return data;\n    if (data instanceof Error) return data.message;\n    return JSON.stringify(data, null, 2);\n  },\n} as const;\n\nexport type OutputFormat = keyof typeof formatters;\n\nexport const formatOutput = (data: unknown, format: OutputFormat = \"human\"): string => {\n  return formatters[format](data);\n};\n\nexport const formatError = (error: unknown, format: OutputFormat = \"human\"): string => {\n  if (format === \"json\") {\n    return JSON.stringify(\n      {\n        error: error,\n      },\n      null,\n      2,\n    );\n  }\n  return error instanceof Error ? error.message : String(error);\n};\n","import { codegenCommand } from \"./commands/codegen\";\nimport { formatCommand } from \"./commands/format\";\nimport { initCommand } from \"./commands/init\";\nimport { formatError } from \"./utils/format\";\n\nconst dispatch = async (argv: readonly string[]): Promise<number> => {\n  const [command, ...rest] = argv;\n\n  if (!command || command === \"--help\" || command === \"-h\") {\n    process.stdout.write(`Usage: soda-gql <command> [options]\\n`);\n    process.stdout.write(`\\nCommands:\\n`);\n    process.stdout.write(`  init       Initialize a new soda-gql project\\n`);\n    process.stdout.write(`  codegen    Generate graphql-system runtime module\\n`);\n    process.stdout.write(`  format     Format soda-gql field selections\\n`);\n    return 0;\n  }\n\n  if (command === \"init\") {\n    return initCommand(rest);\n  }\n\n  if (command === \"codegen\") {\n    return codegenCommand(rest);\n  }\n\n  if (command === \"format\") {\n    return formatCommand(rest);\n  }\n\n  process.stderr.write(`Unknown command: ${command}\\n`);\n  return 1;\n};\n\n// Run CLI when executed directly\ndispatch(process.argv.slice(2))\n  .then((exitCode) => {\n    process.exitCode = exitCode;\n  })\n  .catch((error) => {\n    const message = error instanceof Error ? error.message : String(error);\n    const unexpectedError = {\n      code: \"UNEXPECTED_ERROR\",\n      message,\n    };\n    process.stderr.write(`${formatError(unexpectedError, \"json\")}\\n`);\n    process.exitCode = 1;\n  });\n\nexport { dispatch };\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["args: BuildArgs","formatSuccess","lines: string[]","meta: BuilderArtifactMeta | undefined","artifactWithMeta: BuilderArtifact","data: BuildData","data","args: ValidateArgs","formatSuccess","lines: string[]","z","parsed: Record<string, unknown>","positional: string[]","schemas: Record<string, CodegenSchemaConfig>","formatSuccess","result","resolvedSchemas: Record<string, CodegenSchemaConfig>","parts: string[]","files: string[]","targetPatterns: readonly string[]","excludePatterns: readonly string[]","data: FormatData","data","unformatted: string[]","createdPaths: string[]","files: FileToGenerate[]","cliErrorHints: Partial<Record<CliErrorCode, string>>","codegenErrorHints: Record<string, string>","configErrorHints: Record<string, string>","artifactErrorHints: Record<string, string>","lines: string[]"],"sources":["../src/errors.ts","../src/commands/artifact/build.ts","../src/commands/artifact/validate.ts","../src/commands/artifact/index.ts","../src/schemas/args.ts","../src/utils/parse-args.ts","../src/commands/codegen.ts","../src/commands/format.ts","../src/templates/config.template.ts","../src/templates/gitignore.template.ts","../src/templates/inject.template.ts","../src/templates/schema.template.ts","../src/commands/init.ts","../src/utils/format.ts","../src/index.ts"],"sourcesContent":["/**\n * Unified CLI error types and constructors.\n * @module\n */\n\nimport type { ArtifactLoadError, BuilderError } from \"@soda-gql/builder\";\nimport type { CodegenError } from \"@soda-gql/codegen\";\nimport type { ConfigError } from \"@soda-gql/config\";\nimport { err, type Result } from \"neverthrow\";\n\n/**\n * CLI-specific error codes.\n */\nexport type CliErrorCode =\n  // Argument parsing errors\n  | \"CLI_ARGS_INVALID\"\n  | \"CLI_UNKNOWN_COMMAND\"\n  | \"CLI_UNKNOWN_SUBCOMMAND\"\n  // File operation errors\n  | \"CLI_FILE_EXISTS\"\n  | \"CLI_FILE_NOT_FOUND\"\n  | \"CLI_WRITE_FAILED\"\n  | \"CLI_READ_FAILED\"\n  // Format command specific\n  | \"CLI_NO_PATTERNS\"\n  | \"CLI_FORMATTER_NOT_INSTALLED\"\n  | \"CLI_PARSE_ERROR\"\n  | \"CLI_FORMAT_ERROR\"\n  // Unexpected errors\n  | \"CLI_UNEXPECTED\";\n\n/**\n * Unified CLI error discriminated union.\n * Wraps external errors (codegen, builder, config) and defines CLI-specific errors.\n */\nexport type CliError =\n  // Wrapped external errors (preserve original structure)\n  | { readonly category: \"codegen\"; readonly error: CodegenError }\n  | { readonly category: \"builder\"; readonly error: BuilderError }\n  | { readonly category: \"artifact\"; readonly error: ArtifactLoadError }\n  | { readonly category: \"config\"; readonly error: ConfigError }\n  // CLI-specific errors\n  | {\n      readonly category: \"cli\";\n      readonly code: \"CLI_ARGS_INVALID\";\n      readonly message: string;\n      readonly command: string;\n    }\n  | {\n      readonly category: \"cli\";\n      readonly code: \"CLI_UNKNOWN_COMMAND\";\n      readonly message: string;\n      readonly command: string;\n    }\n  | {\n      readonly category: \"cli\";\n      readonly code: \"CLI_UNKNOWN_SUBCOMMAND\";\n      readonly message: string;\n      readonly parent: string;\n      readonly subcommand: string;\n    }\n  | {\n      readonly category: \"cli\";\n      readonly code: \"CLI_FILE_EXISTS\";\n      readonly message: string;\n      readonly filePath: string;\n    }\n  | {\n      readonly category: \"cli\";\n      readonly code: \"CLI_FILE_NOT_FOUND\";\n      readonly message: string;\n      readonly filePath: string;\n    }\n  | {\n      readonly category: \"cli\";\n      readonly code: \"CLI_WRITE_FAILED\";\n      readonly message: string;\n      readonly filePath: string;\n      readonly cause?: unknown;\n    }\n  | {\n      readonly category: \"cli\";\n      readonly code: \"CLI_READ_FAILED\";\n      readonly message: string;\n      readonly filePath: string;\n      readonly cause?: unknown;\n    }\n  | {\n      readonly category: \"cli\";\n      readonly code: \"CLI_NO_PATTERNS\";\n      readonly message: string;\n    }\n  | {\n      readonly category: \"cli\";\n      readonly code: \"CLI_FORMATTER_NOT_INSTALLED\";\n      readonly message: string;\n    }\n  | {\n      readonly category: \"cli\";\n      readonly code: \"CLI_PARSE_ERROR\";\n      readonly message: string;\n      readonly filePath?: string;\n    }\n  | {\n      readonly category: \"cli\";\n      readonly code: \"CLI_FORMAT_ERROR\";\n      readonly message: string;\n      readonly filePath?: string;\n    }\n  | {\n      readonly category: \"cli\";\n      readonly code: \"CLI_UNEXPECTED\";\n      readonly message: string;\n      readonly cause?: unknown;\n    };\n\n/**\n * Result type for CLI operations.\n */\nexport type CliResult<T> = Result<T, CliError>;\n\n// Extract CLI-specific error types for type-safe constructors\ntype CliArgsInvalidError = Extract<CliError, { code: \"CLI_ARGS_INVALID\" }>;\ntype CliUnknownCommandError = Extract<CliError, { code: \"CLI_UNKNOWN_COMMAND\" }>;\ntype CliUnknownSubcommandError = Extract<CliError, { code: \"CLI_UNKNOWN_SUBCOMMAND\" }>;\ntype CliFileExistsError = Extract<CliError, { code: \"CLI_FILE_EXISTS\" }>;\ntype CliFileNotFoundError = Extract<CliError, { code: \"CLI_FILE_NOT_FOUND\" }>;\ntype CliWriteFailedError = Extract<CliError, { code: \"CLI_WRITE_FAILED\" }>;\ntype CliReadFailedError = Extract<CliError, { code: \"CLI_READ_FAILED\" }>;\ntype CliNoPatternsError = Extract<CliError, { code: \"CLI_NO_PATTERNS\" }>;\ntype CliFormatterNotInstalledError = Extract<CliError, { code: \"CLI_FORMATTER_NOT_INSTALLED\" }>;\ntype CliParseErrorError = Extract<CliError, { code: \"CLI_PARSE_ERROR\" }>;\ntype CliFormatErrorError = Extract<CliError, { code: \"CLI_FORMAT_ERROR\" }>;\ntype CliUnexpectedError = Extract<CliError, { code: \"CLI_UNEXPECTED\" }>;\ntype CliCodegenError = Extract<CliError, { category: \"codegen\" }>;\ntype CliBuilderError = Extract<CliError, { category: \"builder\" }>;\ntype CliArtifactError = Extract<CliError, { category: \"artifact\" }>;\ntype CliConfigError = Extract<CliError, { category: \"config\" }>;\n\n/**\n * Error constructor helpers for concise error creation.\n * Each function returns a specific error type for better type inference.\n */\nexport const cliErrors = {\n  argsInvalid: (command: string, message: string): CliArgsInvalidError => ({\n    category: \"cli\",\n    code: \"CLI_ARGS_INVALID\",\n    message,\n    command,\n  }),\n\n  unknownCommand: (command: string): CliUnknownCommandError => ({\n    category: \"cli\",\n    code: \"CLI_UNKNOWN_COMMAND\",\n    message: `Unknown command: ${command}`,\n    command,\n  }),\n\n  unknownSubcommand: (parent: string, subcommand: string): CliUnknownSubcommandError => ({\n    category: \"cli\",\n    code: \"CLI_UNKNOWN_SUBCOMMAND\",\n    message: `Unknown subcommand: ${subcommand}`,\n    parent,\n    subcommand,\n  }),\n\n  fileExists: (filePath: string, message?: string): CliFileExistsError => ({\n    category: \"cli\",\n    code: \"CLI_FILE_EXISTS\",\n    message: message ?? `File already exists: ${filePath}. Use --force to overwrite.`,\n    filePath,\n  }),\n\n  fileNotFound: (filePath: string, message?: string): CliFileNotFoundError => ({\n    category: \"cli\",\n    code: \"CLI_FILE_NOT_FOUND\",\n    message: message ?? `File not found: ${filePath}`,\n    filePath,\n  }),\n\n  writeFailed: (filePath: string, message?: string, cause?: unknown): CliWriteFailedError => ({\n    category: \"cli\",\n    code: \"CLI_WRITE_FAILED\",\n    message: message ?? `Failed to write file: ${filePath}`,\n    filePath,\n    cause,\n  }),\n\n  readFailed: (filePath: string, message?: string, cause?: unknown): CliReadFailedError => ({\n    category: \"cli\",\n    code: \"CLI_READ_FAILED\",\n    message: message ?? `Failed to read file: ${filePath}`,\n    filePath,\n    cause,\n  }),\n\n  noPatterns: (message?: string): CliNoPatternsError => ({\n    category: \"cli\",\n    code: \"CLI_NO_PATTERNS\",\n    message: message ?? \"No patterns provided and config not found. Usage: soda-gql format [patterns...] [--check]\",\n  }),\n\n  formatterNotInstalled: (message?: string): CliFormatterNotInstalledError => ({\n    category: \"cli\",\n    code: \"CLI_FORMATTER_NOT_INSTALLED\",\n    message: message ?? \"@soda-gql/formatter is not installed. Run: bun add @soda-gql/formatter\",\n  }),\n\n  parseError: (message: string, filePath?: string): CliParseErrorError => ({\n    category: \"cli\",\n    code: \"CLI_PARSE_ERROR\",\n    message,\n    filePath,\n  }),\n\n  formatError: (message: string, filePath?: string): CliFormatErrorError => ({\n    category: \"cli\",\n    code: \"CLI_FORMAT_ERROR\",\n    message,\n    filePath,\n  }),\n\n  unexpected: (message: string, cause?: unknown): CliUnexpectedError => ({\n    category: \"cli\",\n    code: \"CLI_UNEXPECTED\",\n    message,\n    cause,\n  }),\n\n  // Wrappers for external errors\n  fromCodegen: (error: CodegenError): CliCodegenError => ({\n    category: \"codegen\",\n    error,\n  }),\n\n  fromBuilder: (error: BuilderError): CliBuilderError => ({\n    category: \"builder\",\n    error,\n  }),\n\n  fromArtifact: (error: ArtifactLoadError): CliArtifactError => ({\n    category: \"artifact\",\n    error,\n  }),\n\n  fromConfig: (error: ConfigError): CliConfigError => ({\n    category: \"config\",\n    error,\n  }),\n} as const;\n\n/**\n * Convenience helper to create an err Result from CliError.\n */\nexport const cliErr = <T = never>(error: CliError): CliResult<T> => err(error);\n\n/**\n * Type guard to check if error is a CLI-specific error.\n */\nexport const isCliError = (error: CliError): error is CliError & { category: \"cli\" } => {\n  return error.category === \"cli\";\n};\n\n/**\n * Extract error code from any CliError variant.\n */\nexport const getErrorCode = (error: CliError): string => {\n  if (error.category === \"cli\") {\n    return error.code;\n  }\n  // codegen, builder, artifact, config all have error.code\n  return error.error.code;\n};\n\n/**\n * Extract error message from any CliError variant.\n */\nexport const getErrorMessage = (error: CliError): string => {\n  if (error.category === \"cli\") {\n    return error.message;\n  }\n  return error.error.message;\n};\n","import { mkdir, writeFile } from \"node:fs/promises\";\nimport { dirname, resolve } from \"node:path\";\nimport type { BuilderArtifact, BuilderArtifactMeta } from \"@soda-gql/builder\";\nimport { createBuilderService } from \"@soda-gql/builder\";\nimport { loadConfig } from \"@soda-gql/config\";\nimport { err, ok } from \"neverthrow\";\nimport { cliErrors } from \"../../errors\";\nimport type { CommandResult, CommandSuccess } from \"../../types\";\n\nconst BUILD_HELP = `Usage: soda-gql artifact build [options]\n\nBuild and validate soda-gql artifacts.\n\nOptions:\n  --config <path>    Path to soda-gql.config.ts\n  --output, -o       Output file path (default: ./soda-gql-artifact.json)\n  --version, -v      Custom version string for the artifact (default: package version)\n  --dry-run          Validate only, don't write output\n  --help, -h         Show this help message\n\nExamples:\n  soda-gql artifact build\n  soda-gql artifact build --output ./dist/artifact.json\n  soda-gql artifact build --version \"1.0.0\"\n  soda-gql artifact build --dry-run\n  soda-gql artifact build --config ./soda-gql.config.ts\n`;\n\ntype BuildArgs = {\n  configPath?: string;\n  outputPath: string;\n  version?: string;\n  dryRun: boolean;\n  help: boolean;\n};\n\nconst DEFAULT_OUTPUT_PATH = \"./soda-gql-artifact.json\";\n\n/**\n * Parse build command arguments.\n */\nconst parseBuildArgs = (argv: readonly string[]): BuildArgs => {\n  const args: BuildArgs = {\n    configPath: undefined,\n    outputPath: DEFAULT_OUTPUT_PATH,\n    version: undefined,\n    dryRun: false,\n    help: false,\n  };\n\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i];\n    if (arg === \"--config\" || arg === \"-c\") {\n      args.configPath = argv[++i];\n    } else if (arg === \"--output\" || arg === \"-o\") {\n      args.outputPath = argv[++i] ?? DEFAULT_OUTPUT_PATH;\n    } else if (arg === \"--version\" || arg === \"-v\") {\n      args.version = argv[++i];\n    } else if (arg === \"--dry-run\") {\n      args.dryRun = true;\n    } else if (arg === \"--help\" || arg === \"-h\") {\n      args.help = true;\n    }\n  }\n\n  return args;\n};\n\ntype BuildData = {\n  artifact: BuilderArtifact;\n  outputPath?: string;\n  dryRun: boolean;\n};\n\nconst formatSuccess = (data: BuildData): string => {\n  const { artifact, outputPath, dryRun } = data;\n  const fragmentCount = Object.values(artifact.elements).filter((e) => e.type === \"fragment\").length;\n  const operationCount = Object.values(artifact.elements).filter((e) => e.type === \"operation\").length;\n\n  const lines: string[] = [];\n  if (dryRun) {\n    lines.push(`Validation passed: ${fragmentCount} fragments, ${operationCount} operations`);\n  } else {\n    lines.push(`Build complete: ${fragmentCount} fragments, ${operationCount} operations`);\n  }\n\n  if (artifact.meta?.version) {\n    lines.push(`  Version: ${artifact.meta.version}`);\n  }\n\n  if (outputPath && !dryRun) {\n    lines.push(`Artifact written to: ${outputPath}`);\n  }\n\n  return lines.join(\"\\n\");\n};\n\ntype BuildCommandResult = CommandResult<CommandSuccess & { data?: BuildData }>;\n\n/**\n * Build command - builds and validates soda-gql artifacts.\n */\nexport const buildCommand = async (argv: readonly string[]): Promise<BuildCommandResult> => {\n  const args = parseBuildArgs(argv);\n\n  if (args.help) {\n    return ok({ message: BUILD_HELP });\n  }\n\n  // Load config\n  const configResult = loadConfig(args.configPath);\n  if (configResult.isErr()) {\n    return err(cliErrors.fromConfig(configResult.error));\n  }\n\n  const config = configResult.value;\n\n  // Create builder service and build\n  const service = createBuilderService({ config });\n  const buildResult = await service.buildAsync();\n\n  if (buildResult.isErr()) {\n    return err(cliErrors.fromBuilder(buildResult.error));\n  }\n\n  const artifact = buildResult.value;\n\n  // Create artifact with metadata (only if version is specified)\n  const meta: BuilderArtifactMeta | undefined = args.version\n    ? {\n        version: args.version,\n        createdAt: new Date().toISOString(),\n      }\n    : undefined;\n  const artifactWithMeta: BuilderArtifact = {\n    ...(meta ? { meta } : {}),\n    ...artifact,\n  };\n\n  if (args.dryRun) {\n    const data: BuildData = { artifact: artifactWithMeta, dryRun: true };\n    return ok({ message: formatSuccess(data), data });\n  }\n\n  // Write artifact to output file\n  const outputPath = resolve(process.cwd(), args.outputPath);\n  const outputDir = dirname(outputPath);\n  try {\n    await mkdir(outputDir, { recursive: true });\n    await writeFile(outputPath, JSON.stringify(artifactWithMeta, null, 2));\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    return err(cliErrors.writeFailed(outputPath, `Failed to write artifact: ${message}`, error));\n  }\n\n  const data: BuildData = { artifact: artifactWithMeta, outputPath, dryRun: false };\n  return ok({ message: formatSuccess(data), data });\n};\n","import { resolve } from \"node:path\";\nimport type { BuilderArtifact } from \"@soda-gql/builder\";\nimport { loadArtifact } from \"@soda-gql/builder\";\nimport { err, ok } from \"neverthrow\";\nimport { cliErrors } from \"../../errors\";\nimport type { CommandResult, CommandSuccess } from \"../../types\";\n\nconst VALIDATE_HELP = `Usage: soda-gql artifact validate [options] <path>\n\nValidate a pre-built soda-gql artifact file.\n\nArguments:\n  <path>              Path to artifact JSON file\n\nOptions:\n  --help, -h          Show this help message\n\nExamples:\n  soda-gql artifact validate ./soda-gql-artifact.json\n  soda-gql artifact validate ./dist/artifact.json\n`;\n\ntype ValidateArgs = {\n  artifactPath?: string;\n  help: boolean;\n};\n\n/**\n * Parse validate command arguments.\n */\nconst parseValidateArgs = (argv: readonly string[]): ValidateArgs => {\n  const args: ValidateArgs = {\n    artifactPath: undefined,\n    help: false,\n  };\n\n  for (const arg of argv) {\n    if (arg === \"--help\" || arg === \"-h\") {\n      args.help = true;\n    } else if (!arg.startsWith(\"-\")) {\n      args.artifactPath = arg;\n    }\n  }\n\n  return args;\n};\n\nconst formatSuccess = (artifact: BuilderArtifact): string => {\n  const fragmentCount = Object.values(artifact.elements).filter((e) => e.type === \"fragment\").length;\n  const operationCount = Object.values(artifact.elements).filter((e) => e.type === \"operation\").length;\n  const lines: string[] = [`Artifact valid: ${fragmentCount} fragments, ${operationCount} operations`];\n\n  if (artifact.meta) {\n    lines.push(`  Version: ${artifact.meta.version}`);\n    lines.push(`  Created: ${artifact.meta.createdAt}`);\n  } else {\n    lines.push(`  (No metadata - legacy artifact format)`);\n  }\n\n  return lines.join(\"\\n\");\n};\n\ntype ValidateCommandResult = CommandResult<CommandSuccess & { data?: BuilderArtifact }>;\n\n/**\n * Validate command - validates a pre-built artifact file.\n */\nexport const validateCommand = async (argv: readonly string[]): Promise<ValidateCommandResult> => {\n  const args = parseValidateArgs(argv);\n\n  if (args.help) {\n    return ok({ message: VALIDATE_HELP });\n  }\n\n  if (!args.artifactPath) {\n    return err(cliErrors.argsInvalid(\"artifact validate\", \"Missing artifact path argument\"));\n  }\n\n  const artifactPath = resolve(process.cwd(), args.artifactPath);\n  const result = await loadArtifact(artifactPath);\n\n  if (result.isErr()) {\n    return err(cliErrors.fromArtifact(result.error));\n  }\n\n  return ok({ message: formatSuccess(result.value), data: result.value });\n};\n","import { err, ok } from \"neverthrow\";\nimport { cliErrors } from \"../../errors\";\nimport type { CommandResult, CommandSuccess } from \"../../types\";\nimport { buildCommand } from \"./build\";\nimport { validateCommand } from \"./validate\";\n\nconst ARTIFACT_HELP = `Usage: soda-gql artifact <subcommand> [options]\n\nManage soda-gql artifacts.\n\nSubcommands:\n  build        Build artifacts (validate definitions)\n  validate     Validate a pre-built artifact file\n\nRun 'soda-gql artifact <subcommand> --help' for more information.\n`;\n\ntype ArtifactCommandResult = CommandResult<CommandSuccess>;\n\n/**\n * Dispatcher for artifact subcommands.\n */\nexport const artifactCommand = async (argv: readonly string[]): Promise<ArtifactCommandResult> => {\n  const [subcommand, ...rest] = argv;\n\n  if (!subcommand || subcommand === \"--help\" || subcommand === \"-h\") {\n    return ok({ message: ARTIFACT_HELP });\n  }\n\n  if (subcommand === \"build\") {\n    return buildCommand(rest);\n  }\n\n  if (subcommand === \"validate\") {\n    return validateCommand(rest);\n  }\n\n  return err(cliErrors.unknownSubcommand(\"artifact\", subcommand));\n};\n","import { z } from \"zod\";\n\nexport const CodegenArgsSchema = z.object({\n  config: z.string().optional(),\n  \"emit-inject-template\": z.string().optional(),\n});\n\nexport const BuilderArgsSchema = z.object({\n  mode: z.enum([\"runtime\", \"zero-runtime\"]),\n  entry: z.string(),\n  out: z.string(),\n  format: z.enum([\"human\", \"json\"]).optional().default(\"human\"),\n});\n\nexport const FormatArgsSchema = z.object({\n  _: z.array(z.string()).optional(),\n  config: z.string().optional(),\n  check: z.boolean().optional(),\n});\n\nexport const InitArgsSchema = z.object({\n  force: z.boolean().optional(),\n});\n\nexport type CodegenArgs = z.infer<typeof CodegenArgsSchema>;\nexport type BuilderArgs = z.infer<typeof BuilderArgsSchema>;\nexport type FormatArgs = z.infer<typeof FormatArgsSchema>;\nexport type InitArgs = z.infer<typeof InitArgsSchema>;\n","import { err, ok, type Result } from \"neverthrow\";\nimport type { z } from \"zod\";\n\nexport const parseArgs = <T extends z.ZodType>(args: string[], schema: T): Result<z.infer<T>, string> => {\n  const parsed: Record<string, unknown> = {};\n  const positional: string[] = [];\n\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n    if (!arg) continue;\n\n    if (arg.startsWith(\"--\")) {\n      const key = arg.slice(2);\n      const nextArg = args[i + 1];\n\n      if (!nextArg || nextArg.startsWith(\"--\")) {\n        parsed[key] = true;\n      } else {\n        parsed[key] = nextArg;\n        i++;\n      }\n    } else {\n      positional.push(arg);\n    }\n  }\n\n  if (positional.length > 0) {\n    parsed._ = positional;\n  }\n\n  const result = schema.safeParse(parsed);\n  if (!result.success) {\n    return err(result.error.issues.map((e) => e.message).join(\", \"));\n  }\n\n  return ok(result.data);\n};\n","import { resolve } from \"node:path\";\nimport type { CodegenSchemaConfig, CodegenSuccess } from \"@soda-gql/codegen\";\nimport { runCodegen, writeInjectTemplate } from \"@soda-gql/codegen\";\nimport { loadConfig } from \"@soda-gql/config\";\nimport { err, ok } from \"neverthrow\";\nimport { type CliResult, cliErrors } from \"../errors\";\nimport { CodegenArgsSchema } from \"../schemas/args\";\nimport type { CommandResult, CommandSuccess } from \"../types\";\nimport { parseArgs } from \"../utils/parse-args\";\n\ntype ParsedCommand =\n  | {\n      kind: \"emitInjectTemplate\";\n      outPath: string;\n    }\n  | {\n      kind: \"generate\";\n      schemas: Record<string, CodegenSchemaConfig>;\n      outPath: string;\n      importExtension: boolean;\n    };\n\nconst parseCodegenArgs = (argv: readonly string[]): CliResult<ParsedCommand> => {\n  const parsed = parseArgs([...argv], CodegenArgsSchema);\n\n  if (!parsed.isOk()) {\n    return err(cliErrors.argsInvalid(\"codegen\", parsed.error));\n  }\n\n  const args = parsed.value;\n\n  // Handle emit inject template\n  if (args[\"emit-inject-template\"]) {\n    return ok({\n      kind: \"emitInjectTemplate\",\n      outPath: args[\"emit-inject-template\"],\n    });\n  }\n\n  // Load config from @soda-gql/config\n  const configResult = loadConfig(args.config);\n  if (configResult.isErr()) {\n    return err(cliErrors.fromConfig(configResult.error));\n  }\n\n  const config = configResult.value;\n\n  // Check if schemas config exists\n  if (!config.schemas || Object.keys(config.schemas).length === 0) {\n    return err(cliErrors.argsInvalid(\"codegen\", \"schemas configuration is required in soda-gql.config.ts\"));\n  }\n\n  // Build schemas config with resolved paths\n  const schemas: Record<string, CodegenSchemaConfig> = {};\n\n  for (const [name, schemaConfig] of Object.entries(config.schemas)) {\n    schemas[name] = {\n      schema: schemaConfig.schema,\n      inject: schemaConfig.inject,\n      defaultInputDepth: schemaConfig.defaultInputDepth,\n      inputDepthOverrides: schemaConfig.inputDepthOverrides,\n    };\n  }\n\n  // Derive output path from outdir (default to index.ts)\n  const outPath = resolve(config.outdir, \"index.ts\");\n\n  return ok({\n    kind: \"generate\",\n    schemas,\n    outPath,\n    importExtension: config.styles.importExtension,\n  });\n};\n\nconst formatSuccess = (success: CodegenSuccess): string => {\n  const schemaNames = Object.keys(success.schemas).join(\", \");\n  const totalObjects = Object.values(success.schemas).reduce((sum, s) => sum + s.objects, 0);\n  return `Generated ${totalObjects} objects from schemas: ${schemaNames}\\n  TypeScript: ${success.outPath}\\n  CommonJS: ${success.cjsPath}`;\n};\n\nconst formatTemplateSuccess = (outPath: string): string => {\n  return `Created inject template → ${outPath}`;\n};\n\nconst CODEGEN_HELP = `Usage: soda-gql codegen [options]\n\nGenerate graphql-system runtime module from GraphQL schema.\n\nOptions:\n  --config <path>                Path to soda-gql.config.ts\n  --emit-inject-template <path>  Create inject template file\n  --help, -h                     Show this help message\n\nExamples:\n  soda-gql codegen --config ./soda-gql.config.ts\n  soda-gql codegen --emit-inject-template ./src/graphql/scalars.ts\n`;\n\ntype CodegenCommandResult = CommandResult<CommandSuccess & { data?: CodegenSuccess }>;\n\nexport const codegenCommand = async (argv: readonly string[]): Promise<CodegenCommandResult> => {\n  if (argv.includes(\"--help\") || argv.includes(\"-h\")) {\n    return ok({ message: CODEGEN_HELP });\n  }\n\n  const parsed = parseCodegenArgs(argv);\n\n  if (parsed.isErr()) {\n    return err(parsed.error);\n  }\n\n  const command = parsed.value;\n\n  if (command.kind === \"emitInjectTemplate\") {\n    const outPath = resolve(command.outPath);\n    const result = writeInjectTemplate(outPath);\n    if (result.isErr()) {\n      return err(cliErrors.fromCodegen(result.error));\n    }\n    return ok({ message: formatTemplateSuccess(outPath) });\n  }\n\n  // Resolve all paths in schemas config\n  const resolvedSchemas: Record<string, CodegenSchemaConfig> = {};\n  for (const [name, schemaConfig] of Object.entries(command.schemas)) {\n    resolvedSchemas[name] = {\n      schema: resolve(schemaConfig.schema),\n      inject: {\n        scalars: resolve(schemaConfig.inject.scalars),\n        ...(schemaConfig.inject.adapter ? { adapter: resolve(schemaConfig.inject.adapter) } : {}),\n      },\n      defaultInputDepth: schemaConfig.defaultInputDepth,\n      inputDepthOverrides: schemaConfig.inputDepthOverrides,\n    };\n  }\n\n  const result = await runCodegen({\n    schemas: resolvedSchemas,\n    outPath: resolve(command.outPath),\n    format: \"human\",\n    importExtension: command.importExtension,\n  });\n\n  if (result.isErr()) {\n    return err(cliErrors.fromCodegen(result.error));\n  }\n\n  return ok({ message: formatSuccess(result.value), data: result.value });\n};\n","import { access, readFile, writeFile } from \"node:fs/promises\";\nimport { loadConfig } from \"@soda-gql/config\";\nimport fg from \"fast-glob\";\nimport { err, ok } from \"neverthrow\";\nimport { cliErrors } from \"../errors\";\nimport { FormatArgsSchema } from \"../schemas/args\";\nimport type { CommandResult, CommandSuccess } from \"../types\";\nimport { parseArgs } from \"../utils/parse-args\";\n\ntype FormatterModule = typeof import(\"@soda-gql/formatter\");\n\nconst loadFormatter = async (): Promise<FormatterModule | null> => {\n  try {\n    return await import(\"@soda-gql/formatter\");\n  } catch {\n    return null;\n  }\n};\n\ntype FormatData = {\n  mode: \"format\" | \"check\";\n  total: number;\n  modified: number;\n  unchanged: number;\n  errors: number;\n  unformatted: string[];\n  hasFormattingIssues: boolean;\n};\n\nconst formatResultMessage = (data: FormatData): string => {\n  if (data.mode === \"check\") {\n    if (data.unformatted.length > 0) {\n      const files = data.unformatted.map((f) => `  ${f}`).join(\"\\n\");\n      return `${data.unformatted.length} file(s) need formatting:\\n${files}`;\n    }\n    return `All ${data.total} file(s) are properly formatted`;\n  }\n\n  const parts: string[] = [];\n  if (data.modified > 0) {\n    parts.push(`${data.modified} formatted`);\n  }\n  if (data.unchanged > 0) {\n    parts.push(`${data.unchanged} unchanged`);\n  }\n  if (data.errors > 0) {\n    parts.push(`${data.errors} errors`);\n  }\n  return `${data.total} file(s) checked: ${parts.join(\", \")}`;\n};\n\nconst isGlobPattern = (pattern: string): boolean => {\n  return /[*?[\\]{}]/.test(pattern);\n};\n\nconst expandGlobPatterns = async (patterns: readonly string[], excludePatterns: readonly string[] = []): Promise<string[]> => {\n  const files: string[] = [];\n\n  for (const pattern of patterns) {\n    if (!isGlobPattern(pattern)) {\n      // Direct file path - check if it exists\n      try {\n        await access(pattern);\n        files.push(pattern);\n      } catch {\n        // File doesn't exist, skip it\n      }\n      continue;\n    }\n\n    // Glob pattern - use fast-glob with ignore\n    const matches = await fg(pattern, {\n      absolute: true,\n      ignore: [...excludePatterns],\n    });\n    files.push(...matches);\n  }\n\n  return [...new Set(files)];\n};\n\nconst FORMAT_HELP = `Usage: soda-gql format [patterns...] [options]\n\nFormat soda-gql field selections by inserting empty comments.\n\nOptions:\n  --config <path>  Path to soda-gql.config.ts (auto-detected if omitted)\n  --check          Check if files need formatting (exit 1 if unformatted)\n  --help, -h       Show this help message\n\nExamples:\n  soda-gql format                     # Use config include/exclude\n  soda-gql format \"src/**/*.ts\"       # Override with explicit patterns\n  soda-gql format --check             # Check mode with config\n`;\n\ntype FormatCommandResult = CommandResult<CommandSuccess & { data?: FormatData }>;\n\nexport const formatCommand = async (argv: readonly string[]): Promise<FormatCommandResult> => {\n  if (argv.includes(\"--help\") || argv.includes(\"-h\")) {\n    return ok({ message: FORMAT_HELP });\n  }\n\n  const parsed = parseArgs([...argv], FormatArgsSchema);\n\n  if (!parsed.isOk()) {\n    return err(cliErrors.argsInvalid(\"format\", parsed.error));\n  }\n\n  const args = parsed.value;\n  const isCheckMode = args.check === true;\n  const explicitPatterns = args._ ?? [];\n\n  // Determine patterns: use explicit patterns or load from config\n  let targetPatterns: readonly string[];\n  let excludePatterns: readonly string[] = [];\n\n  if (explicitPatterns.length > 0) {\n    targetPatterns = explicitPatterns;\n  } else {\n    // Try to load patterns from config\n    const configResult = loadConfig(args.config);\n    if (configResult.isErr()) {\n      return err(cliErrors.noPatterns());\n    }\n    targetPatterns = configResult.value.include;\n    excludePatterns = configResult.value.exclude;\n  }\n\n  // Load formatter lazily - it's an optional dependency\n  const formatter = await loadFormatter();\n  if (!formatter) {\n    return err(cliErrors.formatterNotInstalled());\n  }\n\n  const files = await expandGlobPatterns(targetPatterns, excludePatterns);\n\n  if (files.length === 0) {\n    const data: FormatData = {\n      mode: isCheckMode ? \"check\" : \"format\",\n      total: 0,\n      modified: 0,\n      unchanged: 0,\n      errors: 0,\n      unformatted: [],\n      hasFormattingIssues: false,\n    };\n    return ok({ message: formatResultMessage(data), data });\n  }\n\n  let modified = 0;\n  let unchanged = 0;\n  let errors = 0;\n  const unformatted: string[] = [];\n\n  for (const filePath of files) {\n    const sourceCode = await readFile(filePath, \"utf-8\");\n\n    if (isCheckMode) {\n      const result = formatter.needsFormat({ sourceCode, filePath });\n      if (result.isErr()) {\n        errors++;\n        continue;\n      }\n      if (result.value) {\n        unformatted.push(filePath);\n        modified++;\n      } else {\n        unchanged++;\n      }\n    } else {\n      const result = formatter.format({ sourceCode, filePath });\n      if (result.isErr()) {\n        errors++;\n        continue;\n      }\n      if (result.value.modified) {\n        await writeFile(filePath, result.value.sourceCode, \"utf-8\");\n        modified++;\n      } else {\n        unchanged++;\n      }\n    }\n  }\n\n  const data: FormatData = {\n    mode: isCheckMode ? \"check\" : \"format\",\n    total: files.length,\n    modified,\n    unchanged,\n    errors,\n    unformatted,\n    hasFormattingIssues: (isCheckMode && unformatted.length > 0) || errors > 0,\n  };\n\n  return ok({ message: formatResultMessage(data), data });\n};\n","export const getConfigTemplate = (): string => `\\\nimport { defineConfig } from \"@soda-gql/config\";\n\nexport default defineConfig({\n  outdir: \"./graphql-system\",\n  include: [\"./src/**/*.ts\"],\n  schemas: {\n    default: {\n      schema: \"./schema.graphql\",\n      inject: \"./graphql-system/default.inject.ts\",\n    },\n  },\n});\n`;\n","export const getGitignoreTemplate = (): string => `\\\n/index.ts\n/index.cjs\n`;\n","export const getInjectTemplate = (): string => `\\\nimport { defineAdapter, defineScalar } from \"@soda-gql/core/adapter\";\n\nexport const scalar = {\n  ...defineScalar<\"ID\", string, string>(\"ID\"),\n  ...defineScalar<\"String\", string, string>(\"String\"),\n  ...defineScalar<\"Int\", number, number>(\"Int\"),\n  ...defineScalar<\"Float\", number, number>(\"Float\"),\n  ...defineScalar<\"Boolean\", boolean, boolean>(\"Boolean\"),\n} as const;\n\nexport const adapter = defineAdapter({\n  helpers: {},\n  metadata: {\n    aggregateFragmentMetadata: (fragments) => fragments.map((m) => m.metadata),\n  },\n});\n`;\n","export const getSchemaTemplate = (): string => `\\\ntype Query {\n  hello: String!\n}\n`;\n","import { existsSync, mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\nimport { err, ok, type Result } from \"neverthrow\";\n\nimport { type CliError, cliErrors } from \"../errors\";\nimport { InitArgsSchema } from \"../schemas/args\";\nimport { getConfigTemplate } from \"../templates/config.template\";\nimport { getGitignoreTemplate } from \"../templates/gitignore.template\";\nimport { getInjectTemplate } from \"../templates/inject.template\";\nimport { getSchemaTemplate } from \"../templates/schema.template\";\nimport type { CommandResult, CommandSuccess } from \"../types\";\nimport { parseArgs } from \"../utils/parse-args\";\n\ntype FileToGenerate = {\n  readonly path: string;\n  readonly content: string;\n  readonly description: string;\n};\n\ntype InitSuccess = {\n  readonly filesCreated: readonly string[];\n};\n\nconst INIT_HELP = `Usage: soda-gql init [options]\n\nInitialize a new soda-gql project with starter configuration.\n\nOptions:\n  --force       Overwrite existing files\n  --help, -h    Show this help message\n\nGenerated files:\n  soda-gql.config.ts                Configuration file\n  schema.graphql                    Sample GraphQL schema\n  graphql-system/default.inject.ts  Scalars, helpers, and metadata adapter\n  graphql-system/.gitignore         Ignore generated files\n`;\n\nconst checkFilesExist = (files: readonly FileToGenerate[], force: boolean): Result<void, CliError> => {\n  if (force) {\n    return ok(undefined);\n  }\n\n  for (const file of files) {\n    if (existsSync(file.path)) {\n      return err(cliErrors.fileExists(file.path));\n    }\n  }\n\n  return ok(undefined);\n};\n\nconst writeFiles = (files: readonly FileToGenerate[]): Result<InitSuccess, CliError> => {\n  const createdPaths: string[] = [];\n\n  for (const file of files) {\n    try {\n      const dir = dirname(file.path);\n      mkdirSync(dir, { recursive: true });\n      writeFileSync(file.path, file.content);\n      createdPaths.push(file.path);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return err(cliErrors.writeFailed(file.path, `Failed to write ${file.description}: ${message}`, error));\n    }\n  }\n\n  return ok({ filesCreated: createdPaths });\n};\n\nconst formatSuccess = (result: InitSuccess): string => {\n  const lines = [\"soda-gql project initialized successfully!\", \"\", \"Created files:\"];\n  for (const file of result.filesCreated) {\n    lines.push(`  ${file}`);\n  }\n  lines.push(\"\", \"Next steps:\");\n  lines.push(\"  1. Edit schema.graphql with your GraphQL types\");\n  lines.push(\"  2. Run: soda-gql codegen\");\n  lines.push(\"  3. Import gql from ./graphql-system\");\n  return lines.join(\"\\n\");\n};\n\ntype InitCommandResult = CommandResult<CommandSuccess & { data?: InitSuccess }>;\n\nexport const initCommand = async (argv: readonly string[]): Promise<InitCommandResult> => {\n  if (argv.includes(\"--help\") || argv.includes(\"-h\")) {\n    return ok({ message: INIT_HELP });\n  }\n\n  const parsed = parseArgs([...argv], InitArgsSchema);\n\n  if (!parsed.isOk()) {\n    return err(cliErrors.argsInvalid(\"init\", parsed.error));\n  }\n\n  const args = parsed.value;\n  const force = args.force === true;\n  const cwd = process.cwd();\n\n  const files: FileToGenerate[] = [\n    {\n      path: resolve(cwd, \"soda-gql.config.ts\"),\n      content: getConfigTemplate(),\n      description: \"configuration file\",\n    },\n    {\n      path: resolve(cwd, \"schema.graphql\"),\n      content: getSchemaTemplate(),\n      description: \"GraphQL schema\",\n    },\n    {\n      path: resolve(cwd, \"graphql-system/default.inject.ts\"),\n      content: getInjectTemplate(),\n      description: \"inject module\",\n    },\n    {\n      path: resolve(cwd, \"graphql-system/.gitignore\"),\n      content: getGitignoreTemplate(),\n      description: \"gitignore file\",\n    },\n  ];\n\n  const existsCheck = checkFilesExist(files, force);\n  if (existsCheck.isErr()) {\n    return err(existsCheck.error);\n  }\n\n  const writeResult = writeFiles(files);\n  if (writeResult.isErr()) {\n    return err(writeResult.error);\n  }\n\n  return ok({ message: formatSuccess(writeResult.value), data: writeResult.value });\n};\n","import { formatBuilderErrorForCLI } from \"@soda-gql/builder\";\nimport type { CliError, CliErrorCode } from \"../errors\";\nimport type { OutputFormat } from \"../types\";\n\nexport type { OutputFormat } from \"../types\";\n\n/**\n * CLI-specific error hints to help users fix issues.\n */\nconst cliErrorHints: Partial<Record<CliErrorCode, string>> = {\n  CLI_ARGS_INVALID: \"Check command usage with --help\",\n  CLI_UNKNOWN_COMMAND: \"Run 'soda-gql --help' for available commands\",\n  CLI_UNKNOWN_SUBCOMMAND: \"Run the parent command with --help for available subcommands\",\n  CLI_FILE_EXISTS: \"Use --force flag to overwrite existing files\",\n  CLI_FILE_NOT_FOUND: \"Verify the file path exists\",\n  CLI_WRITE_FAILED: \"Check write permissions and disk space\",\n  CLI_READ_FAILED: \"Check file permissions and verify the file is not locked\",\n  CLI_NO_PATTERNS: \"Provide file patterns or create soda-gql.config.ts\",\n  CLI_FORMATTER_NOT_INSTALLED: \"Install with: bun add @soda-gql/formatter\",\n  CLI_PARSE_ERROR: \"Check the file for syntax errors\",\n  CLI_FORMAT_ERROR: \"Verify the file contains valid soda-gql code\",\n  CLI_UNEXPECTED: \"This is an unexpected error. Please report at https://github.com/soda-gql/soda-gql/issues\",\n};\n\n/**\n * Codegen-specific error hints.\n */\nconst codegenErrorHints: Record<string, string> = {\n  SCHEMA_NOT_FOUND: \"Verify the schema path in soda-gql.config.ts\",\n  SCHEMA_INVALID: \"Check your GraphQL schema for syntax errors\",\n  INJECT_MODULE_NOT_FOUND: \"Run: soda-gql codegen --emit-inject-template <path>\",\n  INJECT_MODULE_REQUIRED: \"Add inject configuration to your schema in soda-gql.config.ts\",\n  INJECT_TEMPLATE_EXISTS: \"Delete the existing file to regenerate, or use a different path\",\n  EMIT_FAILED: \"Check write permissions and that the output directory exists\",\n  INJECT_TEMPLATE_FAILED: \"Check write permissions for the output path\",\n};\n\n/**\n * Config-specific error hints.\n */\nconst configErrorHints: Record<string, string> = {\n  CONFIG_NOT_FOUND: \"Create a soda-gql.config.ts file in your project root\",\n  CONFIG_LOAD_FAILED: \"Check your configuration file for syntax errors\",\n  CONFIG_VALIDATION_FAILED: \"Verify your configuration matches the expected schema\",\n  CONFIG_INVALID_PATH: \"Verify the path in your configuration exists\",\n};\n\n/**\n * Artifact-specific error hints.\n */\nconst artifactErrorHints: Record<string, string> = {\n  ARTIFACT_NOT_FOUND: \"Verify the artifact file path exists\",\n  ARTIFACT_PARSE_ERROR: \"Check that the artifact file is valid JSON\",\n  ARTIFACT_VALIDATION_ERROR: \"Verify the artifact was built with a compatible version of soda-gql\",\n};\n\n/**\n * Get hint for any error type.\n */\nconst getErrorHint = (error: CliError): string | undefined => {\n  if (error.category === \"cli\") {\n    return cliErrorHints[error.code];\n  }\n  if (error.category === \"codegen\") {\n    return codegenErrorHints[error.error.code];\n  }\n  if (error.category === \"config\") {\n    return configErrorHints[error.error.code];\n  }\n  if (error.category === \"artifact\") {\n    return artifactErrorHints[error.error.code];\n  }\n  // Builder errors use their own hints via formatBuilderErrorForCLI\n  return undefined;\n};\n\n/**\n * Format CliError to human-readable string with hints.\n */\nexport const formatCliErrorHuman = (error: CliError): string => {\n  // Delegate to builder's formatter for builder errors\n  if (error.category === \"builder\") {\n    return formatBuilderErrorForCLI(error.error);\n  }\n\n  const lines: string[] = [];\n\n  if (error.category === \"codegen\") {\n    const codegenError = error.error;\n    lines.push(`Error [${codegenError.code}]: ${codegenError.message}`);\n\n    // Add context based on error type\n    if (\"schemaPath\" in codegenError) {\n      lines.push(`  Schema: ${codegenError.schemaPath}`);\n    }\n    if (\"outPath\" in codegenError && codegenError.outPath) {\n      lines.push(`  Output: ${codegenError.outPath}`);\n    }\n    if (\"injectPath\" in codegenError) {\n      lines.push(`  Inject: ${codegenError.injectPath}`);\n    }\n  } else if (error.category === \"config\") {\n    const configError = error.error;\n    lines.push(`Error [${configError.code}]: ${configError.message}`);\n    if (configError.filePath) {\n      lines.push(`  Config: ${configError.filePath}`);\n    }\n  } else if (error.category === \"artifact\") {\n    const artifactError = error.error;\n    lines.push(`Error [${artifactError.code}]: ${artifactError.message}`);\n    if (artifactError.filePath) {\n      lines.push(`  Artifact: ${artifactError.filePath}`);\n    }\n  } else {\n    // CLI errors\n    lines.push(`Error [${error.code}]: ${error.message}`);\n\n    if (\"filePath\" in error && error.filePath) {\n      lines.push(`  File: ${error.filePath}`);\n    }\n    if (\"command\" in error && error.code !== \"CLI_UNKNOWN_COMMAND\") {\n      lines.push(`  Command: ${error.command}`);\n    }\n    if (\"parent\" in error) {\n      lines.push(`  Parent: ${error.parent}`);\n    }\n  }\n\n  const hint = getErrorHint(error);\n  if (hint) {\n    lines.push(\"\");\n    lines.push(`  Hint: ${hint}`);\n  }\n\n  return lines.join(\"\\n\");\n};\n\n/**\n * Format CliError to JSON string.\n */\nexport const formatCliErrorJson = (error: CliError): string => {\n  if (error.category === \"cli\") {\n    const { category: _category, ...rest } = error;\n    return JSON.stringify({ error: rest }, null, 2);\n  }\n  return JSON.stringify({ error: error.error }, null, 2);\n};\n\n/**\n * Format CliError with output format preference.\n */\nexport const formatCliError = (error: CliError, format: OutputFormat = \"human\"): string => {\n  return format === \"json\" ? formatCliErrorJson(error) : formatCliErrorHuman(error);\n};\n\n// ---- Legacy formatters (kept for backward compatibility) ----\n\nexport const formatters = {\n  json: (data: unknown) => JSON.stringify(data, null, 2),\n  human: (data: unknown) => {\n    if (typeof data === \"string\") return data;\n    if (data instanceof Error) return data.message;\n    return JSON.stringify(data, null, 2);\n  },\n} as const;\n\nexport const formatOutput = (data: unknown, format: OutputFormat = \"human\"): string => {\n  return formatters[format](data);\n};\n\n/**\n * @deprecated Use formatCliError instead for CliError types.\n */\nexport const formatError = (error: unknown, format: OutputFormat = \"human\"): string => {\n  if (format === \"json\") {\n    return JSON.stringify(\n      {\n        error: error,\n      },\n      null,\n      2,\n    );\n  }\n  return error instanceof Error ? error.message : String(error);\n};\n","import { err, ok } from \"neverthrow\";\nimport { artifactCommand } from \"./commands/artifact\";\nimport { codegenCommand } from \"./commands/codegen\";\nimport { formatCommand } from \"./commands/format\";\nimport { initCommand } from \"./commands/init\";\nimport { cliErrors } from \"./errors\";\nimport type { CommandResult, CommandSuccess, OutputFormat } from \"./types\";\nimport { formatCliError } from \"./utils/format\";\n\nconst MAIN_HELP = `Usage: soda-gql <command> [options]\n\nCommands:\n  init       Initialize a new soda-gql project\n  codegen    Generate graphql-system runtime module\n  format     Format soda-gql field selections\n  artifact   Manage soda-gql artifacts\n\nRun 'soda-gql <command> --help' for more information on a specific command.\n`;\n\n/**\n * Parse output format from argv.\n * Returns \"json\" if --format=json or --json flag is present, otherwise \"human\".\n */\nconst getOutputFormat = (argv: readonly string[]): OutputFormat => {\n  for (const arg of argv) {\n    if (arg === \"--format=json\" || arg === \"--json\") {\n      return \"json\";\n    }\n    if (arg === \"--format=human\") {\n      return \"human\";\n    }\n  }\n  return \"human\";\n};\n\ntype DispatchResult = CommandResult<CommandSuccess & { exitCode?: number }>;\n\nconst dispatch = async (argv: readonly string[]): Promise<DispatchResult> => {\n  const [command, ...rest] = argv;\n\n  if (!command || command === \"--help\" || command === \"-h\") {\n    return ok({ message: MAIN_HELP });\n  }\n\n  if (command === \"init\") {\n    return initCommand(rest);\n  }\n\n  if (command === \"codegen\") {\n    return codegenCommand(rest);\n  }\n\n  if (command === \"format\") {\n    const result = await formatCommand(rest);\n    if (result.isOk()) {\n      // Format command uses exit 1 for unformatted files in check mode or errors\n      const exitCode = result.value.data?.hasFormattingIssues ? 1 : 0;\n      return ok({ ...result.value, exitCode });\n    }\n    return err(result.error);\n  }\n\n  if (command === \"artifact\") {\n    return artifactCommand(rest);\n  }\n\n  return err(cliErrors.unknownCommand(command));\n};\n\n// Run CLI when executed directly\nconst main = async () => {\n  const argv = process.argv.slice(2);\n  const format = getOutputFormat(argv);\n\n  const result = await dispatch(argv);\n\n  if (result.isOk()) {\n    process.stdout.write(`${result.value.message}\\n`);\n    process.exitCode = result.value.exitCode ?? 0;\n  } else {\n    process.stderr.write(`${formatCliError(result.error, format)}\\n`);\n    process.exitCode = 1;\n  }\n};\n\nmain().catch((error) => {\n  const unexpectedError = cliErrors.unexpected(error instanceof Error ? error.message : String(error), error);\n  const format = getOutputFormat(process.argv.slice(2));\n  process.stderr.write(`${formatCliError(unexpectedError, format)}\\n`);\n  process.exitCode = 1;\n});\n\nexport { dispatch };\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -1,5 +1,106 @@
+import { Result } from "neverthrow";
+import { ArtifactLoadError, BuilderError } from "@soda-gql/builder";
+import { CodegenError } from "@soda-gql/codegen";
+import { ConfigError } from "@soda-gql/config";
+
+//#region packages/cli/src/errors.d.ts
+
+/**
+ * Unified CLI error discriminated union.
+ * Wraps external errors (codegen, builder, config) and defines CLI-specific errors.
+ */
+type CliError = {
+  readonly category: "codegen";
+  readonly error: CodegenError;
+} | {
+  readonly category: "builder";
+  readonly error: BuilderError;
+} | {
+  readonly category: "artifact";
+  readonly error: ArtifactLoadError;
+} | {
+  readonly category: "config";
+  readonly error: ConfigError;
+} | {
+  readonly category: "cli";
+  readonly code: "CLI_ARGS_INVALID";
+  readonly message: string;
+  readonly command: string;
+} | {
+  readonly category: "cli";
+  readonly code: "CLI_UNKNOWN_COMMAND";
+  readonly message: string;
+  readonly command: string;
+} | {
+  readonly category: "cli";
+  readonly code: "CLI_UNKNOWN_SUBCOMMAND";
+  readonly message: string;
+  readonly parent: string;
+  readonly subcommand: string;
+} | {
+  readonly category: "cli";
+  readonly code: "CLI_FILE_EXISTS";
+  readonly message: string;
+  readonly filePath: string;
+} | {
+  readonly category: "cli";
+  readonly code: "CLI_FILE_NOT_FOUND";
+  readonly message: string;
+  readonly filePath: string;
+} | {
+  readonly category: "cli";
+  readonly code: "CLI_WRITE_FAILED";
+  readonly message: string;
+  readonly filePath: string;
+  readonly cause?: unknown;
+} | {
+  readonly category: "cli";
+  readonly code: "CLI_READ_FAILED";
+  readonly message: string;
+  readonly filePath: string;
+  readonly cause?: unknown;
+} | {
+  readonly category: "cli";
+  readonly code: "CLI_NO_PATTERNS";
+  readonly message: string;
+} | {
+  readonly category: "cli";
+  readonly code: "CLI_FORMATTER_NOT_INSTALLED";
+  readonly message: string;
+} | {
+  readonly category: "cli";
+  readonly code: "CLI_PARSE_ERROR";
+  readonly message: string;
+  readonly filePath?: string;
+} | {
+  readonly category: "cli";
+  readonly code: "CLI_FORMAT_ERROR";
+  readonly message: string;
+  readonly filePath?: string;
+} | {
+  readonly category: "cli";
+  readonly code: "CLI_UNEXPECTED";
+  readonly message: string;
+  readonly cause?: unknown;
+};
+//#endregion
+//#region packages/cli/src/types.d.ts
+/**
+ * Result type for all CLI commands.
+ */
+type CommandResult<T = CommandSuccess> = Result<T, CliError>;
+/**
+ * Standard success response for commands.
+ */
+type CommandSuccess = {
+  readonly message: string;
+};
+//#endregion
 //#region packages/cli/src/index.d.ts
-declare const dispatch: (argv: readonly string[]) => Promise<number>;
+type DispatchResult = CommandResult<CommandSuccess & {
+  exitCode?: number;
+}>;
+declare const dispatch: (argv: readonly string[]) => Promise<DispatchResult>;
 //#endregion
 export { dispatch };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";cAKM,uCAA4C"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/errors.ts","../src/types.ts","../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;ACWA,CAAA,CAAA;AAA8B,IAAA,CDwBlB,QAAA,CAAA,CAAA,CCxBkB;EAAyB,QAAA,CAAA,QAAA,CAAA,CAAA,CAAA,OAAA,CAAA;EAAG,QAAA,CAAA,KAAA,CAAA,CD0BN,YC1BM;CAAV,CAAA,CAAA,CAAA;EAAM,QAAA,CAAA,QAAA,CAAA,CAAA,CAAA,OAAA,CAAA;EAK1C,QAAA,CAAA,KAAA,CAAA,CDsBwC,YCtB1B;;;kBDuB2B;AEjCsB,CAAA,CAAA,CAAA,CA8BtE;EAEC,QAAA,CAAA,QA8BL,CAAA,CAAA,CAAA,MAAA,CA9ByD;kBFEP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AALnD,CAAA,CAAA;;;AAIqD,IAAA,CC5BzC,aD4ByC,CAAA,CAAA,CAAA,CAAA,CC5BvB,cD4BuB,CAAA,CAAA,CAAA,CC5BL,MD4BK,CC5BE,CD4BF,CAAA,CC5BK,QD4BL,CAAA;;;;KCvBzC,cAAA,CAAA,CAAA;;AALZ,CAAA;;;KCyBK,cAAA,CAAA,CAAA,CAAiB,cAAc;;;cAE9B,uCAA4C,QAAQ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soda-gql/cli",
-  "version": "0.7.0",
+  "version": "0.8.2",
   "description": "Command-line interface for soda-gql",
   "type": "module",
   "private": false,
@@ -48,8 +48,8 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@soda-gql/codegen": "~0.7.0",
-    "@soda-gql/builder": "~0.7.0",
+    "@soda-gql/codegen": "~0.8.0",
+    "@soda-gql/builder": "~0.8.0",
     "fast-glob": "^3.3.3",
     "neverthrow": "^8.1.1",
     "zod": "^4.1.11"
@@ -57,6 +57,6 @@
   "devDependencies": {},
   "peerDependencies": {},
   "optionalDependencies": {
-    "@soda-gql/formatter": "~0.7.0"
+    "@soda-gql/formatter": "~0.8.0"
   }
 }