lpc-forge 1.0.0 → 1.0.1

package/dist/assets/manager.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Asset manager — downloads, caches, and verifies LPC sprite assets
+ * for npm-installed CLI users who don't have the full repo checkout.
+ */
+export interface AssetManifest {
+    version: string;
+    generatedAt: string;
+    chunks: AssetChunk[];
+    totalSize: number;
+}
+export interface AssetChunk {
+    name: string;
+    filename: string;
+    url: string;
+    size: number;
+    sha256: string;
+    required: boolean;
+}
+/** Platform-aware asset cache directory */
+export declare function getAssetDir(): string;
+/**
+ * Resolve the root directory where `spritesheets/` and `sheet_definitions/` live.
+ *
+ * Priority:
+ *  1. LPC_FORGE_ASSETS env var
+ *  2. Local repo checkout (spritesheets/ next to package root)
+ *  3. Cached asset directory (~/.lpc-forge/assets or platform equivalent)
+ */
+export declare function resolveAssetRoot(packageRoot: string): string;
+/** Check if assets are installed and match the expected version */
+export declare function isAssetsInstalled(version?: string): Promise<{
+    installed: boolean;
+    version?: string;
+    chunks?: string[];
+    path: string;
+}>;
+/** Fetch the remote asset manifest from the latest GitHub release */
+export declare function fetchRemoteManifest(version?: string): Promise<AssetManifest>;
+export interface DownloadOptions {
+    /** Only download required chunks (body + definitions) */
+    minimal?: boolean;
+    /** Custom asset directory (overrides default) */
+    path?: string;
+    /** Callback for progress updates */
+    onProgress?: (state: DownloadProgress) => void;
+    /** Skip interactive prompts */
+    nonInteractive?: boolean;
+}
+export interface DownloadProgress {
+    phase: 'fetching-manifest' | 'downloading' | 'verifying' | 'extracting' | 'done';
+    currentChunk?: string;
+    chunkIndex?: number;
+    totalChunks?: number;
+    bytesDownloaded?: number;
+    bytesTotal?: number | null;
+    overallDownloaded?: number;
+    overallTotal?: number;
+}
+export declare function downloadAssets(options?: DownloadOptions): Promise<void>;
+export declare function cleanAssets(assetDir?: string): Promise<void>;
+/** Ask user yes/no in the terminal. Returns true for yes. */
+export declare function promptYesNo(question: string): Promise<boolean>;
+/**
+ * Ensures assets are available. If missing, prompts the user to download them.
+ * Returns the resolved asset root path.
+ * Throws if assets are unavailable and user declines download.
+ */
+export declare function ensureAssets(packageRoot: string): Promise<string>;
+export declare function downloadWithProgress(options?: DownloadOptions): Promise<void>;

package/dist/assets/manager.js

@@ -0,0 +1,452 @@
+/**
+ * Asset manager — downloads, caches, and verifies LPC sprite assets
+ * for npm-installed CLI users who don't have the full repo checkout.
+ */
+import { createHash } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, writeFile, rm, } from 'node:fs/promises';
+import { get as httpsGet } from 'node:https';
+import { get as httpGet } from 'node:http';
+import { homedir, platform } from 'node:os';
+import { join, resolve } from 'node:path';
+import { createReadStream, createWriteStream } from 'node:fs';
+import { pipeline } from 'node:stream/promises';
+import { createInterface } from 'node:readline';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+// ──────────────────────────────────────────────
+// Constants
+// ──────────────────────────────────────────────
+const GITHUB_REPO = 'LiberatedPixelCup/Universal-LPC-Spritesheet-Character-Generator';
+const MANIFEST_FILENAME = 'assets-manifest.json';
+const LOCAL_MANIFEST = '.lpc-forge-manifest.json';
+// ──────────────────────────────────────────────
+// Asset directory resolution
+// ──────────────────────────────────────────────
+/** Platform-aware asset cache directory */
+export function getAssetDir() {
+    if (process.env.LPC_FORGE_ASSETS) {
+        return resolve(process.env.LPC_FORGE_ASSETS);
+    }
+    const p = platform();
+    if (p === 'darwin') {
+        return join(homedir(), 'Library', 'Application Support', 'lpc-forge', 'assets');
+    }
+    if (p === 'win32') {
+        return join(process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local'), 'lpc-forge', 'assets');
+    }
+    // Linux / other — respect XDG
+    return join(process.env.XDG_DATA_HOME || join(homedir(), '.local', 'share'), 'lpc-forge', 'assets');
+}
+/**
+ * Resolve the root directory where `spritesheets/` and `sheet_definitions/` live.
+ *
+ * Priority:
+ *  1. LPC_FORGE_ASSETS env var
+ *  2. Local repo checkout (spritesheets/ next to package root)
+ *  3. Cached asset directory (~/.lpc-forge/assets or platform equivalent)
+ */
+export function resolveAssetRoot(packageRoot) {
+    if (process.env.LPC_FORGE_ASSETS) {
+        return resolve(process.env.LPC_FORGE_ASSETS);
+    }
+    // Check if running from a git clone / dev checkout
+    if (existsSync(join(packageRoot, 'spritesheets'))) {
+        return packageRoot;
+    }
+    return getAssetDir();
+}
+// ──────────────────────────────────────────────
+// Status checks
+// ──────────────────────────────────────────────
+/** Check if assets are installed and match the expected version */
+export async function isAssetsInstalled(version) {
+    const assetDir = getAssetDir();
+    const manifestPath = join(assetDir, LOCAL_MANIFEST);
+    if (!existsSync(manifestPath)) {
+        return { installed: false, path: assetDir };
+    }
+    try {
+        const raw = await readFile(manifestPath, 'utf-8');
+        const manifest = JSON.parse(raw);
+        // Check if critical directories actually exist
+        const hasSpritesheets = existsSync(join(assetDir, 'spritesheets'));
+        const hasDefinitions = existsSync(join(assetDir, 'sheet_definitions'));
+        if (!hasSpritesheets || !hasDefinitions) {
+            return { installed: false, path: assetDir };
+        }
+        // Version mismatch check
+        if (version && manifest.version !== version) {
+            return {
+                installed: false,
+                version: manifest.version,
+                chunks: manifest.chunks,
+                path: assetDir,
+            };
+        }
+        return {
+            installed: true,
+            version: manifest.version,
+            chunks: manifest.chunks,
+            path: assetDir,
+        };
+    }
+    catch {
+        return { installed: false, path: assetDir };
+    }
+}
+// ──────────────────────────────────────────────
+// Download helpers
+// ──────────────────────────────────────────────
+function followRedirects(url, maxRedirects = 5) {
+    return new Promise((resolve, reject) => {
+        if (maxRedirects <= 0) {
+            reject(new Error('Too many redirects'));
+            return;
+        }
+        const getter = url.startsWith('https') ? httpsGet : httpGet;
+        const req = getter(url, {
+            headers: { 'User-Agent': 'lpc-forge-cli' },
+        }, (res) => {
+            if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+                res.resume(); // drain the response
+                followRedirects(res.headers.location, maxRedirects - 1).then(resolve, reject);
+                return;
+            }
+            if (res.statusCode && res.statusCode >= 400) {
+                res.resume();
+                reject(new Error(`HTTP ${res.statusCode} fetching ${url}`));
+                return;
+            }
+            resolve(res);
+        });
+        req.on('error', reject);
+    });
+}
+async function downloadToFile(url, destPath, onProgress) {
+    const res = await followRedirects(url);
+    const total = res.headers['content-length'] ? parseInt(res.headers['content-length'], 10) : null;
+    await mkdir(join(destPath, '..'), { recursive: true });
+    const tmpPath = destPath + '.tmp';
+    const ws = createWriteStream(tmpPath);
+    let downloaded = 0;
+    res.on('data', (chunk) => {
+        downloaded += chunk.length;
+        onProgress?.(downloaded, total);
+    });
+    try {
+        await pipeline(res, ws);
+        // Atomic rename from tmp to final
+        const { rename } = await import('node:fs/promises');
+        await rename(tmpPath, destPath);
+    }
+    catch (err) {
+        // Clean up partial file
+        await rm(tmpPath, { force: true });
+        throw err;
+    }
+}
+async function computeSha256(filePath) {
+    const hash = createHash('sha256');
+    const stream = createReadStream(filePath);
+    for await (const chunk of stream) {
+        hash.update(chunk);
+    }
+    return hash.digest('hex');
+}
+// ──────────────────────────────────────────────
+// Manifest fetching
+// ──────────────────────────────────────────────
+async function fetchJson(url) {
+    const res = await followRedirects(url);
+    const chunks = [];
+    for await (const chunk of res) {
+        chunks.push(typeof chunk === 'string' ? Buffer.from(chunk) : chunk);
+    }
+    return JSON.parse(Buffer.concat(chunks).toString('utf-8'));
+}
+/** Fetch the remote asset manifest from the latest GitHub release */
+export async function fetchRemoteManifest(version) {
+    const tag = version || 'latest';
+    // For 'latest', use the GitHub API to resolve the actual tag
+    if (tag === 'latest') {
+        const releaseUrl = `https://api.github.com/repos/${GITHUB_REPO}/releases/latest`;
+        const release = await fetchJson(releaseUrl);
+        const manifestAsset = release.assets.find(a => a.name === MANIFEST_FILENAME);
+        if (!manifestAsset) {
+            throw new Error(`No ${MANIFEST_FILENAME} found in latest release (${release.tag_name}). ` +
+                `The release may not have been packaged correctly.`);
+        }
+        return fetchJson(manifestAsset.browser_download_url);
+    }
+    const url = `https://github.com/${GITHUB_REPO}/releases/download/${tag}/${MANIFEST_FILENAME}`;
+    return fetchJson(url);
+}
+export async function downloadAssets(options = {}) {
+    const assetDir = options.path ? resolve(options.path) : getAssetDir();
+    // Check available disk space (best-effort)
+    await checkDiskSpace(assetDir);
+    // 1. Fetch manifest
+    options.onProgress?.({ phase: 'fetching-manifest' });
+    const manifest = await fetchRemoteManifest();
+    // 2. Filter chunks
+    let chunks = manifest.chunks;
+    if (options.minimal) {
+        chunks = chunks.filter(c => c.required);
+    }
+    const totalSize = chunks.reduce((s, c) => s + c.size, 0);
+    let overallDownloaded = 0;
+    // 3. Download and extract each chunk
+    await mkdir(assetDir, { recursive: true });
+    const downloadedChunks = [];
+    for (let i = 0; i < chunks.length; i++) {
+        const chunk = chunks[i];
+        const archivePath = join(assetDir, chunk.filename);
+        // Download
+        options.onProgress?.({
+            phase: 'downloading',
+            currentChunk: chunk.name,
+            chunkIndex: i,
+            totalChunks: chunks.length,
+            bytesDownloaded: 0,
+            bytesTotal: chunk.size,
+            overallDownloaded,
+            overallTotal: totalSize,
+        });
+        await downloadToFile(chunk.url, archivePath, (downloaded, total) => {
+            options.onProgress?.({
+                phase: 'downloading',
+                currentChunk: chunk.name,
+                chunkIndex: i,
+                totalChunks: chunks.length,
+                bytesDownloaded: downloaded,
+                bytesTotal: total ?? chunk.size,
+                overallDownloaded: overallDownloaded + downloaded,
+                overallTotal: totalSize,
+            });
+        });
+        overallDownloaded += chunk.size;
+        // Verify checksum
+        options.onProgress?.({
+            phase: 'verifying',
+            currentChunk: chunk.name,
+            chunkIndex: i,
+            totalChunks: chunks.length,
+        });
+        const actualHash = await computeSha256(archivePath);
+        if (actualHash !== chunk.sha256) {
+            await rm(archivePath, { force: true });
+            throw new Error(`Checksum mismatch for ${chunk.filename}. ` +
+                `Expected ${chunk.sha256}, got ${actualHash}. ` +
+                `The file may be corrupted — try again.`);
+        }
+        // Extract
+        options.onProgress?.({
+            phase: 'extracting',
+            currentChunk: chunk.name,
+            chunkIndex: i,
+            totalChunks: chunks.length,
+        });
+        await execFileAsync('tar', ['xzf', archivePath, '-C', assetDir]);
+        // Remove archive after extraction to save space
+        await rm(archivePath, { force: true });
+        downloadedChunks.push(chunk.name);
+    }
+    // 4. Write local manifest
+    const localManifest = {
+        version: manifest.version,
+        installedAt: new Date().toISOString(),
+        chunks: downloadedChunks,
+    };
+    await writeFile(join(assetDir, LOCAL_MANIFEST), JSON.stringify(localManifest, null, 2));
+    options.onProgress?.({ phase: 'done' });
+}
+// ──────────────────────────────────────────────
+// Disk space check (best-effort)
+// ──────────────────────────────────────────────
+async function checkDiskSpace(dir) {
+    // Ensure parent exists for statvfs
+    await mkdir(dir, { recursive: true });
+    try {
+        // Use df on Unix-like systems
+        if (platform() !== 'win32') {
+            const { stdout } = await execFileAsync('df', ['-k', dir]);
+            const lines = stdout.trim().split('\n');
+            if (lines.length >= 2) {
+                const parts = lines[1].split(/\s+/);
+                const availKB = parseInt(parts[3], 10);
+                if (!isNaN(availKB)) {
+                    const availMB = availKB / 1024;
+                    if (availMB < 2000) { // Less than 2GB available
+                        throw new Error(`Insufficient disk space: ${Math.round(availMB)} MB available, ` +
+                            `but assets require ~1.3 GB. Free up space or use --path to specify a different location.`);
+                    }
+                }
+            }
+        }
+    }
+    catch (err) {
+        // If it's our own insufficient space error, re-throw
+        if (err instanceof Error && err.message.includes('Insufficient disk space')) {
+            throw err;
+        }
+        // Otherwise ignore — best-effort check
+    }
+}
+// ──────────────────────────────────────────────
+// Clean up
+// ──────────────────────────────────────────────
+export async function cleanAssets(assetDir) {
+    const dir = assetDir || getAssetDir();
+    if (existsSync(dir)) {
+        await rm(dir, { recursive: true, force: true });
+    }
+}
+// ──────────────────────────────────────────────
+// Interactive prompt
+// ──────────────────────────────────────────────
+/** Ask user yes/no in the terminal. Returns true for yes. */
+export async function promptYesNo(question) {
+    // Non-interactive / CI environments
+    if (process.env.LPC_FORGE_AUTO_DOWNLOAD === 'true') {
+        return true;
+    }
+    if (!process.stdin.isTTY) {
+        return false;
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            const a = answer.trim().toLowerCase();
+            resolve(a === '' || a === 'y' || a === 'yes');
+        });
+    });
+}
+// ──────────────────────────────────────────────
+// Ensure assets (called before sprite commands)
+// ──────────────────────────────────────────────
+/**
+ * Ensures assets are available. If missing, prompts the user to download them.
+ * Returns the resolved asset root path.
+ * Throws if assets are unavailable and user declines download.
+ */
+export async function ensureAssets(packageRoot) {
+    const assetRoot = resolveAssetRoot(packageRoot);
+    // If we found a local checkout with spritesheets, we're good
+    if (existsSync(join(assetRoot, 'spritesheets')) && existsSync(join(assetRoot, 'sheet_definitions'))) {
+        return assetRoot;
+    }
+    // Assets not found — need to download
+    const chalk = (await import('chalk')).default;
+    console.log('');
+    console.log(chalk.yellow('⚠️  LPC Forge assets not found.') + ' These are required for sprite generation.');
+    console.log('');
+    console.log(`   Total download: ${chalk.bold('~1.3 GB')} (305,680 sprite files)`);
+    console.log(`   Install location: ${chalk.gray(getAssetDir())}`);
+    console.log('');
+    const proceed = await promptYesNo(`   Download now? (Y/n): `);
+    if (!proceed) {
+        console.log('');
+        console.log(chalk.gray('   Run ') + chalk.cyan('lpc-forge setup') + chalk.gray(' when ready to download.'));
+        console.log(chalk.gray('   Run ') + chalk.cyan('lpc-forge setup --help') + chalk.gray(' for more options.'));
+        console.log('');
+        process.exit(1);
+    }
+    // Download with progress display
+    await downloadWithProgress();
+    return getAssetDir();
+}
+// ──────────────────────────────────────────────
+// Progress display
+// ──────────────────────────────────────────────
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(0)} MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GB`;
+}
+function progressBar(fraction, width = 20) {
+    const filled = Math.round(fraction * width);
+    const empty = width - filled;
+    return '[' + '#'.repeat(filled) + '-'.repeat(empty) + ']';
+}
+export async function downloadWithProgress(options = {}) {
+    const chalk = (await import('chalk')).default;
+    const ora = (await import('ora')).default;
+    let manifest;
+    const manifestSpinner = ora('Fetching asset manifest...').start();
+    try {
+        manifest = await fetchRemoteManifest();
+        manifestSpinner.succeed('Asset manifest fetched');
+    }
+    catch (err) {
+        manifestSpinner.fail('Failed to fetch asset manifest');
+        throw err;
+    }
+    let chunks = manifest.chunks;
+    if (options.minimal) {
+        chunks = chunks.filter(c => c.required);
+    }
+    const totalSize = chunks.reduce((s, c) => s + c.size, 0);
+    const assetDir = options.path ? resolve(options.path) : getAssetDir();
+    console.log('');
+    console.log(chalk.bold('📦 Downloading LPC Forge assets...'));
+    console.log('');
+    await mkdir(assetDir, { recursive: true });
+    await checkDiskSpace(assetDir);
+    const downloadedChunks = [];
+    let overallDownloaded = 0;
+    for (let i = 0; i < chunks.length; i++) {
+        const chunk = chunks[i];
+        const archivePath = join(assetDir, chunk.filename);
+        // Show which chunk we're downloading
+        const spinner = ora({
+            text: `${chunk.name} (${formatBytes(chunk.size)})`,
+            prefixText: '  ',
+        }).start();
+        try {
+            // Download
+            await downloadToFile(chunk.url, archivePath, (downloaded, total) => {
+                const t = total ?? chunk.size;
+                const pct = Math.round((downloaded / t) * 100);
+                spinner.text = `${chunk.name} (${formatBytes(chunk.size)})  ${progressBar(downloaded / t)}  ${pct}%`;
+            });
+            // Verify
+            spinner.text = `${chunk.name} — verifying checksum...`;
+            const actualHash = await computeSha256(archivePath);
+            if (actualHash !== chunk.sha256) {
+                await rm(archivePath, { force: true });
+                spinner.fail(`${chunk.name} — checksum mismatch`);
+                throw new Error(`Checksum mismatch for ${chunk.filename}. ` +
+                    `Expected ${chunk.sha256}, got ${actualHash}.`);
+            }
+            // Extract
+            spinner.text = `${chunk.name} — extracting...`;
+            await execFileAsync('tar', ['xzf', archivePath, '-C', assetDir]);
+            await rm(archivePath, { force: true });
+            overallDownloaded += chunk.size;
+            spinner.succeed(`${chunk.name} (${formatBytes(chunk.size)})`);
+            downloadedChunks.push(chunk.name);
+        }
+        catch (err) {
+            spinner.fail(`${chunk.name} — failed`);
+            throw err;
+        }
+    }
+    // Write local manifest
+    const localManifest = {
+        version: manifest.version,
+        installedAt: new Date().toISOString(),
+        chunks: downloadedChunks,
+    };
+    await writeFile(join(assetDir, LOCAL_MANIFEST), JSON.stringify(localManifest, null, 2));
+    console.log('');
+    console.log(chalk.green(`✅ Assets installed (${formatBytes(overallDownloaded)}) → ${assetDir}`));
+    console.log('');
+}
+//# sourceMappingURL=manager.js.map

package/dist/assets/manager.js.map

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

package/dist/cli.js

@@ -3,8 +3,10 @@ import { Command } from 'commander';
 import { resolve, join } from 'node:path';
 import { mkdir, writeFile } from 'node:fs/promises';
 import { fileURLToPath } from 'node:url';
+import { resolveAssetRoot, ensureAssets } from './assets/manager.js';
 const __dirname = fileURLToPath(new URL('.', import.meta.url));
-const REPO_ROOT = resolve(__dirname, '..');
+const PACKAGE_ROOT = resolve(__dirname, '..');
+const REPO_ROOT = resolveAssetRoot(PACKAGE_ROOT);
 const program = new Command();
 program
     .name('lpc-forge')
@@ -29,8 +31,9 @@ program
     const chalk = (await import('chalk')).default;
     const ora = (await import('ora')).default;
     if (opts.listLayers) {
+        const assetRoot = await ensureAssets(PACKAGE_ROOT);
         const { loadDefinitions, listLayers } = await import('./character/definitions.js');
-        const registry = await loadDefinitions(REPO_ROOT);
+        const registry = await loadDefinitions(assetRoot);
         const layers = listLayers(registry);
         for (const [category, items] of Object.entries(layers)) {
             console.log(chalk.bold.cyan(`\n${category}`));
@@ -40,6 +43,7 @@ program
         }
         return;
     }
+    const assetRoot = await ensureAssets(PACKAGE_ROOT);
     const spinner = ora('Composing character...').start();
     try {
         const { composeCharacter } = await import('./character/composer.js');
@@ -76,7 +80,7 @@ program
                 layers,
             };
         }
-        const buffer = await composeCharacter(spec, REPO_ROOT);
+        const buffer = await composeCharacter(spec, assetRoot);
         const outputDir = resolve(opts.output);
         await mkdir(outputDir, { recursive: true });
         await writeFile(join(outputDir, 'spritesheet.png'), buffer);
@@ -111,8 +115,9 @@ program
     const chalk = (await import('chalk')).default;
     const ora = (await import('ora')).default;
     const { runBatch } = await import('./character/batch.js');
+    const assetRoot = await ensureAssets(PACKAGE_ROOT);
     const spinner = ora('Running batch generation...').start();
-    const results = await runBatch(resolve(configPath), REPO_ROOT, resolve(opts.output));
+    const results = await runBatch(resolve(configPath), assetRoot, resolve(opts.output));
     const succeeded = results.filter(r => r.success).length;
     const failed = results.filter(r => !r.success).length;
     spinner.succeed(`Batch complete: ${succeeded} succeeded, ${failed} failed`);
@@ -134,8 +139,9 @@ program
     .option('--json', 'Output as JSON')
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     .action(async (opts) => {
+    const assetRoot = await ensureAssets(PACKAGE_ROOT);
     const { loadDefinitions, listLayers } = await import('./character/definitions.js');
-    const registry = await loadDefinitions(REPO_ROOT);
+    const registry = await loadDefinitions(assetRoot);
     const layers = listLayers(registry);
     if (opts.category) {
         const filtered = {};
@@ -335,7 +341,8 @@ program
             charSpinner.fail(`Unknown preset: ${opts.character}`);
             process.exit(1);
         }
-        const charBuffer = await composeCharacter(preset.spec, REPO_ROOT);
+        const assetRoot = await ensureAssets(PACKAGE_ROOT);
+        const charBuffer = await composeCharacter(preset.spec, assetRoot);
         await exportCharacterToGodot(charBuffer, outputDir, opts.character);
         charSpinner.succeed(`${preset.name} character generated`);
         // 3. Generate map
@@ -420,7 +427,7 @@ program
             let enemyCount = 0;
             for (const enemyPreset of enemyPresets) {
                 if (PRESETS[enemyPreset]) {
-                    const enemyBuffer = await composeCharacter(PRESETS[enemyPreset].spec, REPO_ROOT);
+                    const enemyBuffer = await composeCharacter(PRESETS[enemyPreset].spec, assetRoot);
                     await exportCharacterToGodot(enemyBuffer, outputDir, enemyPreset, { isPlayer: false });
                     enemyCount++;
                 }
@@ -432,7 +439,7 @@ program
             let npcCount = 0;
             for (const npcPreset of npcPresets) {
                 if (PRESETS[npcPreset] && npcPreset !== 'guard') {
-                    const npcBuffer = await composeCharacter(PRESETS[npcPreset].spec, REPO_ROOT);
+                    const npcBuffer = await composeCharacter(PRESETS[npcPreset].spec, assetRoot);
                     await exportCharacterToGodot(npcBuffer, outputDir, `npc_${npcPreset}`, { isPlayer: false });
                     npcCount++;
                 }
@@ -934,5 +941,51 @@ program
         process.exit(1);
     }
 });
+// === SETUP COMMAND ===
+program
+    .command('setup')
+    .description('Download and install LPC sprite assets (~1.3 GB)')
+    .option('--minimal', 'Download only required assets (body + definitions, ~200 MB)')
+    .option('--check', 'Check if assets are installed and up to date')
+    .option('--clean', 'Remove cached assets')
+    .option('--path <dir>', 'Custom asset directory (also set via LPC_FORGE_ASSETS env var)')
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    .action(async (opts) => {
+    const chalk = (await import('chalk')).default;
+    const { isAssetsInstalled, getAssetDir, cleanAssets, downloadWithProgress, } = await import('./assets/manager.js');
+    if (opts.check) {
+        const status = await isAssetsInstalled();
+        if (status.installed) {
+            console.log(chalk.green('✅ Assets installed'));
+            console.log(chalk.gray(`   Version: ${status.version}`));
+            console.log(chalk.gray(`   Location: ${status.path}`));
+            if (status.chunks) {
+                console.log(chalk.gray(`   Chunks: ${status.chunks.join(', ')}`));
+            }
+        }
+        else {
+            console.log(chalk.yellow('⚠️  Assets not installed'));
+            console.log(chalk.gray(`   Expected at: ${status.path}`));
+            if (status.version) {
+                console.log(chalk.gray(`   Found version: ${status.version} (may need update)`));
+            }
+            console.log(chalk.gray('\n   Run: lpc-forge setup'));
+        }
+        return;
+    }
+    if (opts.clean) {
+        const dir = opts.path || getAssetDir();
+        const ora = (await import('ora')).default;
+        const spinner = ora('Removing cached assets...').start();
+        await cleanAssets(dir);
+        spinner.succeed(`Assets removed from ${dir}`);
+        return;
+    }
+    // Download
+    await downloadWithProgress({
+        minimal: opts.minimal,
+        path: opts.path,
+    });
+});
 program.parse();
 //# sourceMappingURL=cli.js.map

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "lpc-forge",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Complete 2D RPG asset pipeline — character compositor, procedural map generator, and Godot 4.6 exporter. Built on Liberated Pixel Cup sprites.",
   "type": "module",
   "bin": {
-    "lpc-forge": "./dist/cli.js"
+    "lpc-forge": "dist/cli.js"
   },
   "files": [
     "dist/cli.js",
@@ -16,6 +16,7 @@
     "dist/utils/**",
     "dist/license.js",
     "dist/license.d.ts",
+    "dist/assets/**",
     "assets/**",
     "README.md",
     "LICENSE",