@ducky7go/ducky-cli 0.0.1

package/README.md

@@ -0,0 +1,241 @@
+# ducky-cli
+
+A command-line tool for packaging and publishing game mods to NuGet servers. `ducky-cli` brings the functionality of `action-ducky-nuget` GitHub Action to local development environments, enabling game mod developers to package and publish their mods directly from the command line.
+
+## Features
+
+- **NuGet Packaging**: Create `.nupkg` packages from mod directories
+- **NuGet Publishing**: Publish packages to nuget.org or custom NuGet servers
+- **Validation**: Validate mods against the [NuGet Mod Packaging Specification v1.0](https://github.com/ducky7go/dukcy-package-spec)
+- **Cross-Platform**: Works on Windows, macOS, and Linux
+- **Namespace Design**: Organized commands for future support of other package formats
+
+## Installation
+
+```bash
+npm install -g ducky-cli
+```
+
+Or use directly with npx:
+
+```bash
+npx ducky-cli --help
+```
+
+## Quick Start
+
+### Package a Mod
+
+```bash
+ducky nuget pack ./mods/MyMod
+```
+
+This creates a `.nupkg` file in the mod directory.
+
+### Publish to NuGet
+
+```bash
+# Set your API key
+export NUGET_API_KEY=your-api-key
+
+# Push a .nupkg file
+ducky nuget push ./mods/MyMod.1.0.0.nupkg
+
+# Or pack and push in one step
+ducky nuget push ./mods/MyMod --pack
+```
+
+### Validate a Mod
+
+```bash
+ducky nuget validate ./mods/MyMod
+```
+
+## Commands
+
+### `ducky nuget pack`
+
+Package a mod directory into a `.nupkg` file.
+
+```bash
+ducky nuget pack <path> [options]
+```
+
+**Arguments:**
+- `<path>` - Path to the mod directory
+
+**Options:**
+- `-o, --output <path>` - Output directory for the `.nupkg` file (default: same as input)
+- `-v, --verbose` - Enable verbose output
+
+**Example:**
+```bash
+ducky nuget pack ./mods/MyMod -o ./output
+```
+
+### `ducky nuget push`
+
+Publish a `.nupkg` file to a NuGet server.
+
+```bash
+ducky nuget push <path> [options]
+```
+
+**Arguments:**
+- `<path>` - Path to the `.nupkg` file or mod directory (with `--pack`)
+
+**Options:**
+- `-p, --pack` - Package the mod before pushing
+- `-s, --server <url>` - NuGet server URL (default: `https://api.nuget.org/v3/index.json`)
+- `-k, --api-key <key>` - NuGet API key
+- `-o, --output <path>` - Output directory for `.nupkg` file (when using `--pack`)
+- `-v, --verbose` - Enable verbose output
+
+**Examples:**
+```bash
+# Push an existing .nupkg file
+ducky nuget push ./mods/MyMod.1.0.0.nupkg
+
+# Pack and push in one step
+ducky nuget push ./mods/MyMod --pack
+
+# Use a custom NuGet server
+ducky nuget push ./mods/MyMod.1.0.0.nupkg --server https://my-nuget-server.com/v3/index.json
+```
+
+### `ducky nuget validate`
+
+Validate a mod directory against the NuGet Mod Packaging Specification.
+
+```bash
+ducky nuget validate <path> [options]
+```
+
+**Arguments:**
+- `<path>` - Path to the mod directory
+
+**Options:**
+- `-v, --verbose` - Enable verbose output
+
+**Example:**
+```bash
+ducky nuget validate ./mods/MyMod
+```
+
+## Configuration
+
+Configuration can be provided via:
+1. Command-line flags (highest priority)
+2. Environment variables
+3. Default values (lowest priority)
+
+### Environment Variables
+
+- `NUGET_API_KEY` - API key for NuGet authentication
+- `NUGET_SERVER` - Default NuGet server URL
+- `NUGET_VERBOSE` - Enable verbose output
+
+## Mod Directory Structure
+
+A valid mod directory should contain:
+
+```
+MyMod/
+├── info.ini              # Mod metadata (required)
+├── MyMod.dll             # Main DLL (required, name must match info.ini name field)
+├── preview.png           # Optional preview image
+└── ...other files        # Any other mod files
+```
+
+### info.ini Format
+
+```ini
+name=MyMod
+version=1.0.0
+description=My awesome game mod
+author=Your Name
+projectUrl=https://github.com/yourname/mymod
+license=MIT
+tags=game,mod,example
+
+[dependencies]
+OtherMod=1.0.0
+```
+
+**Required fields:**
+- `name` - NuGet package ID (must start with letter or underscore, max 100 chars)
+- `version` - SemVer 2.0 version (e.g., `1.0.0`, `2.1.0-beta`)
+
+**Optional fields:**
+- `description` - Package description
+- `author` - Package author
+- `projectUrl` - Project URL
+- `license` - License identifier
+- `tags` - Comma-separated list of tags
+- `dependencies` - Comma-separated list of dependencies with optional versions
+
+## Validation Rules
+
+The tool validates mods against these rules:
+
+1. **DLL Name Matching**: At least one DLL file must have a base name matching the `name` field in `info.ini`
+2. **SemVer 2.0 Version**: Version must follow semantic versioning 2.0 format
+3. **Valid NuGet ID**: Package name must be a valid NuGet identifier
+4. **Required Fields**: `name` and `version` fields are required
+
+## Examples
+
+### Complete Workflow
+
+```bash
+# 1. Create your mod directory with info.ini and DLL files
+mkdir -p ./mods/MyMod
+
+# 2. Validate your mod
+ducky nuget validate ./mods/MyMod
+
+# 3. Package your mod
+ducky nuget pack ./mods/MyMod
+
+# 4. Publish to NuGet
+export NUGET_API_KEY=your-api-key
+ducky nuget push ./mods/MyMod.1.0.0.nupkg
+```
+
+### Using Custom NuGet Server
+
+```bash
+export NUGET_SERVER=https://my-nuget-server.com/v3/index.json
+export NUGET_API_KEY=your-api-key
+ducky nuget push ./mods/MyMod.1.0.0.nupkg
+```
+
+## Error Handling
+
+The tool provides helpful error messages with suggestions:
+
+```
+✖ Invalid version format: 1.0
+
+Suggestions:
+  • Version must follow SemVer 2.0 format
+  • Examples: 1.0.0, 2.1.0-beta, 3.0.0-rc.1
+```
+
+## Contributing
+
+Contributions are welcome! Please read our contributing guidelines before submitting PRs.
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Related Projects
+
+- [action-ducky-nuget](https://github.com/ducky7go/action-ducky-nuget) - GitHub Action for CI/CD
+- [NuGet Mod Packaging Specification](https://github.com/ducky7go/dukcy-package-spec) - Specification for mod packaging
+
+## Support
+
+- Report bugs: [GitHub Issues](https://github.com/ducky7go/ducky-cli/issues)
+- Documentation: [GitHub Wiki](https://github.com/ducky7go/ducky-cli/wiki)

package/bin/ducky

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Run the CLI with tsx in development, or compiled JS in production
+const isDev = process.env.NODE_ENV !== 'production';
+const scriptPath = isDev
+  ? join(__dirname, '..', 'src', 'cli.ts')
+  : join(__dirname, '..', 'dist', 'cli.js');
+
+const args = process.argv.slice(2);
+const runner = isDev ? 'tsx' : 'node';
+
+const child = spawn(runner, [scriptPath, ...args], {
+  stdio: 'inherit',
+  env: process.env,
+});
+
+child.on('exit', (code) => {
+  process.exit(code ?? 0);
+});

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+declare const program: Command;
+export { program };
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAkB9B,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { registerNuGetCommands } from './commands/nuget/index.js';
+// Create the main program
+const program = new Command();
+program
+    .name('ducky')
+    .description('CLI tool for packaging and publishing game mods')
+    .version('0.1.0');
+// Register format namespaces
+registerNuGetCommands(program);
+// Future formats can be registered here:
+// registerZipCommands(program);
+// registerTarCommands(program);
+// Parse arguments
+program.parse(process.argv);
+// Export for testing
+export { program };
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,0BAA0B;AAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,iDAAiD,CAAC;KAC9D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,6BAA6B;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAE/B,yCAAyC;AACzC,gCAAgC;AAChC,gCAAgC;AAEhC,kBAAkB;AAClB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5B,qBAAqB;AACrB,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/commands/nuget/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerNuGetCommands(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/nuget/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/nuget/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsB5D"}

package/dist/commands/nuget/index.js

@@ -0,0 +1,23 @@
+import { Command } from 'commander';
+import { nugetPackCommand } from './pack.js';
+import { nugetPushCommand } from './push.js';
+import { nugetValidateCommand } from './validate.js';
+export function registerNuGetCommands(program) {
+    // Create the nuget namespace command
+    const nugetCommand = new Command('nuget')
+        .description('NuGet package format commands')
+        .addHelpText('beforeAll', `
+NuGet commands for packaging and publishing game mods.
+
+Examples:
+  $ ducky nuget pack ./mods/MyMod
+  $ ducky nuget push ./mods/MyMod.nupkg
+  $ ducky nuget validate ./mods/MyMod
+`);
+    // Register subcommands (T19: Create command registry)
+    nugetCommand.addCommand(nugetPackCommand);
+    nugetCommand.addCommand(nugetPushCommand);
+    nugetCommand.addCommand(nugetValidateCommand);
+    program.addCommand(nugetCommand);
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/nuget/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/nuget/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,qCAAqC;IACrC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;SACtC,WAAW,CAAC,+BAA+B,CAAC;SAC5C,WAAW,CACV,WAAW,EACX;;;;;;;CAOL,CACI,CAAC;IAEJ,sDAAsD;IACtD,YAAY,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC1C,YAAY,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC1C,YAAY,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAE9C,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACnC,CAAC"}

package/dist/commands/nuget/pack.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * T16: Implement nuget pack command
+ * Creates a .nupkg package from a mod directory
+ */
+export declare const nugetPackCommand: Command;
+//# sourceMappingURL=pack.d.ts.map

package/dist/commands/nuget/pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../../src/commands/nuget/pack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,SAuEzB,CAAC"}

package/dist/commands/nuget/pack.js

@@ -0,0 +1,78 @@
+import { Command } from 'commander';
+import { resolve, join, basename } from 'path';
+import { writeFile, mkdir } from 'fs/promises';
+import { createLogger, LogLevel } from '../../utils/index.js';
+import { parseInfoIni, generateNuspec, collectFilesForPackage, validateMod, } from '../../formats/nuget/index.js';
+import { NuGetCliManager } from '../../formats/nuget/client.js';
+import { FileSystemError, ValidationError } from '../../utils/errors.js';
+const logger = createLogger();
+/**
+ * T16: Implement nuget pack command
+ * Creates a .nupkg package from a mod directory
+ */
+export const nugetPackCommand = new Command('pack')
+    .description('Package a mod into a .nupkg file')
+    .argument('<path>', 'Path to mod directory')
+    .option('-o, --output <path>', 'Output directory for .nupkg file')
+    .option('-v, --verbose', 'Enable verbose output')
+    .action(async (path, options) => {
+    try {
+        // Configure logger
+        if (options.verbose) {
+            logger.setLevel(LogLevel.DEBUG);
+        }
+        const modPath = resolve(path);
+        const outputPath = options.output ? resolve(options.output) : modPath;
+        logger.header('NuGet Pack');
+        logger.info(`Mod path: ${modPath}`);
+        logger.info(`Output path: ${outputPath}`);
+        // Parse metadata
+        logger.info('Parsing info.ini...');
+        const metadata = await parseInfoIni(modPath);
+        logger.success(`Parsed: ${metadata.name} v${metadata.version}`);
+        // Validate mod
+        logger.info('Validating mod...');
+        const validation = await validateMod(modPath, metadata);
+        if (!validation.valid) {
+            logger.error('Validation failed:');
+            for (const error of validation.errors) {
+                logger.error(error);
+            }
+            throw new ValidationError('Mod validation failed');
+        }
+        logger.success('Validation passed');
+        // Generate .nuspec
+        logger.info('Generating .nuspec file...');
+        const nuspecContent = generateNuspec(metadata);
+        const nuspecPath = join(modPath, `${metadata.name}.nuspec`);
+        await writeFile(nuspecPath, nuspecContent, 'utf-8');
+        logger.success(`Generated: ${basename(nuspecPath)}`);
+        // Collect files
+        logger.info('Collecting files...');
+        const files = await collectFilesForPackage({
+            modPath,
+            outputPath,
+            recursive: true,
+        });
+        logger.success(`Found ${files.length} files`);
+        // Ensure output directory exists
+        await mkdir(outputPath, { recursive: true });
+        // Pack using NuGet CLI
+        const client = new NuGetCliManager();
+        const nupkgPath = await client.pack(nuspecPath, outputPath);
+        logger.blank();
+        logger.success(`Package created: ${nupkgPath}`);
+    }
+    catch (error) {
+        if (error instanceof FileSystemError || error instanceof ValidationError) {
+            logger.error(error);
+            process.exit(1);
+        }
+        else if (error instanceof Error) {
+            logger.error(error.message);
+            process.exit(1);
+        }
+        throw error;
+    }
+});
+//# sourceMappingURL=pack.js.map

package/dist/commands/nuget/pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../../src/commands/nuget/pack.ts"],"names":[],"mappings":"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"}

package/dist/commands/nuget/push.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * T17: Implement nuget push command
+ * Publishes a .nupkg file to a NuGet server
+ */
+export declare const nugetPushCommand: Command;
+//# sourceMappingURL=push.d.ts.map

package/dist/commands/nuget/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../../src/commands/nuget/push.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,SAgHzB,CAAC"}

package/dist/commands/nuget/push.js

@@ -0,0 +1,110 @@
+import { Command } from 'commander';
+import { resolve } from 'path';
+import { fileExists } from '../../utils/fs.js';
+import { createLogger, resolveConfig, getApiKey, getServerUrl, LogLevel } from '../../utils/index.js';
+import { parseInfoIni, validateMod } from '../../formats/nuget/index.js';
+import { NuGetCliManager } from '../../formats/nuget/client.js';
+import { FileSystemError, ValidationError, ConfigError } from '../../utils/errors.js';
+const logger = createLogger();
+/**
+ * T17: Implement nuget push command
+ * Publishes a .nupkg file to a NuGet server
+ */
+export const nugetPushCommand = new Command('push')
+    .description('Publish a .nupkg file to a NuGet server')
+    .argument('<path>', 'Path to .nupkg file or mod directory (with --pack)')
+    .option('-p, --pack', 'Package the mod before pushing')
+    .option('-s, --server <url>', 'NuGet server URL')
+    .option('-k, --api-key <key>', 'NuGet API key')
+    .option('-o, --output <path>', 'Output directory for .nupkg file (when using --pack)')
+    .option('-v, --verbose', 'Enable verbose output')
+    .action(async (path, options) => {
+    try {
+        // Configure logger
+        if (options.verbose) {
+            logger.setLevel(LogLevel.DEBUG);
+        }
+        let nupkgPath;
+        // If --pack flag is used, first pack the mod
+        if (options.pack) {
+            logger.header('NuGet Push (with Pack)');
+            const modPath = resolve(path);
+            const outputPath = options.output ? resolve(options.output) : modPath;
+            logger.info(`Mod path: ${modPath}`);
+            logger.info(`Output path: ${outputPath}`);
+            // Parse metadata
+            logger.info('Parsing info.ini...');
+            const metadata = await parseInfoIni(modPath);
+            logger.success(`Parsed: ${metadata.name} v${metadata.version}`);
+            // Validate mod
+            logger.info('Validating mod...');
+            const validation = await validateMod(modPath, metadata);
+            if (!validation.valid) {
+                logger.error('Validation failed:');
+                for (const error of validation.errors) {
+                    logger.error(error);
+                }
+                throw new ValidationError('Mod validation failed');
+            }
+            logger.success('Validation passed');
+            // Generate .nuspec
+            logger.info('Generating .nuspec file...');
+            const { generateNuspec } = await import('../../formats/nuget/nuspec.js');
+            const nuspecContent = generateNuspec(metadata);
+            const { writeFile } = await import('fs/promises');
+            const { join } = await import('path');
+            const nuspecPath = join(modPath, `${metadata.name}.nuspec`);
+            await writeFile(nuspecPath, nuspecContent, 'utf-8');
+            logger.success('Generated .nuspec file');
+            // Pack using NuGet CLI
+            const { mkdir } = await import('fs/promises');
+            await mkdir(outputPath, { recursive: true });
+            const client = new NuGetCliManager();
+            nupkgPath = await client.pack(nuspecPath, outputPath);
+            logger.success(`Package created: ${nupkgPath}`);
+        }
+        else {
+            // Verify .nupkg file exists
+            nupkgPath = resolve(path);
+            if (!(await fileExists(nupkgPath))) {
+                throw new FileSystemError(`.nupkg file not found: ${nupkgPath}`, [
+                    'Check that the path is correct',
+                    'Use --pack flag to package a mod directory before pushing',
+                ]);
+            }
+            logger.header('NuGet Push');
+            logger.info(`Package path: ${nupkgPath}`);
+        }
+        // Load configuration
+        const config = resolveConfig({
+            server: options.server,
+            apiKey: options.apiKey,
+            verbose: options.verbose,
+        });
+        const server = getServerUrl(config);
+        const apiKey = getApiKey(config);
+        logger.info(`Server: ${server}`);
+        logger.info(`API Key: ${apiKey ? '***' + apiKey.slice(-4) : '(none)'}`);
+        // Push using NuGet CLI
+        logger.blank();
+        logger.info('Pushing package...');
+        const client = new NuGetCliManager();
+        await client.push(nupkgPath, server, apiKey);
+        logger.blank();
+        logger.success('Package pushed successfully!');
+    }
+    catch (error) {
+        if (error instanceof FileSystemError ||
+            error instanceof ValidationError ||
+            error instanceof ConfigError) {
+            logger.error(error);
+            process.exit(1);
+        }
+        else if (error instanceof Error) {
+            logger.error(error.message);
+            process.exit(1);
+        }
+        throw error;
+    }
+});
+//# sourceMappingURL=push.js.map

package/dist/commands/nuget/push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../../src/commands/nuget/push.ts"],"names":[],"mappings":"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"}

package/dist/commands/nuget/validate.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * T18: Implement nuget validate command
+ * Validates a mod directory against the NuGet Mod Packaging Specification
+ */
+export declare const nugetValidateCommand: Command;
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/nuget/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/commands/nuget/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC;;;GAGG;AACH,eAAO,MAAM,oBAAoB,SA2E7B,CAAC"}

package/dist/commands/nuget/validate.js

@@ -0,0 +1,78 @@
+import { Command } from 'commander';
+import { resolve } from 'path';
+import { createLogger, LogLevel } from '../../utils/index.js';
+import { parseInfoIni, validateMod } from '../../formats/nuget/index.js';
+import { FileSystemError } from '../../utils/errors.js';
+const logger = createLogger();
+/**
+ * T18: Implement nuget validate command
+ * Validates a mod directory against the NuGet Mod Packaging Specification
+ */
+export const nugetValidateCommand = new Command('validate')
+    .description('Validate a mod directory')
+    .argument('<path>', 'Path to mod directory')
+    .option('-v, --verbose', 'Enable verbose output')
+    .action(async (path, options) => {
+    try {
+        // Configure logger
+        if (options.verbose) {
+            logger.setLevel(LogLevel.DEBUG);
+        }
+        const modPath = resolve(path);
+        logger.header('NuGet Validate');
+        logger.info(`Mod path: ${modPath}`);
+        // Parse metadata
+        logger.info('Parsing info.ini...');
+        const metadata = await parseInfoIni(modPath);
+        logger.success(`Parsed: ${metadata.name} v${metadata.version}`);
+        // Display metadata
+        logger.blank();
+        logger.info('Metadata:');
+        if (metadata.description) {
+            logger.info(`  Description: ${metadata.description}`);
+        }
+        if (metadata.author) {
+            logger.info(`  Author: ${metadata.author}`);
+        }
+        if (metadata.projectUrl) {
+            logger.info(`  Project URL: ${metadata.projectUrl}`);
+        }
+        if (metadata.tags && metadata.tags.length > 0) {
+            logger.info(`  Tags: ${metadata.tags.join(', ')}`);
+        }
+        // Validate mod
+        logger.blank();
+        logger.info('Running validation checks...');
+        const validation = await validateMod(modPath, metadata);
+        // Display results
+        logger.blank();
+        if (validation.valid) {
+            logger.success('✓ All validation checks passed!');
+            logger.blank();
+            logger.info('Your mod is ready to be packaged.');
+        }
+        else {
+            logger.error('Validation failed:');
+            logger.blank();
+            for (const error of validation.errors) {
+                logger.error(error);
+                logger.blank();
+            }
+            if (validation.warnings.length > 0) {
+                logger.warn('Warnings:');
+                for (const warning of validation.warnings) {
+                    logger.warn(`  • ${warning}`);
+                }
+            }
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        if (error instanceof FileSystemError || error instanceof Error) {
+            logger.error(error);
+            process.exit(1);
+        }
+        throw error;
+    }
+});
+//# sourceMappingURL=validate.js.map

package/dist/commands/nuget/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/commands/nuget/validate.ts"],"names":[],"mappings":"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"}