threewzrd 1.0.0 → 1.0.3

package/dist/cli.js

@@ -3,6 +3,7 @@ import { Command } from 'commander';
 import { homedir } from 'os';
 import { startCommand } from './commands/start.js';
 import { configCommand } from './commands/config.js';
+import { modelCommand } from './commands/model.js';
 // Safely get current working directory, fallback to home
 function safeGetCwd() {
     try {
@@ -22,6 +23,7 @@ program
     .command('start')
     .description('Start the wizard REPL')
     .option('-d, --directory <path>', 'Working directory for the wizard', safeGetCwd())
+    .option('-m, --model <model>', 'Model to use (sonnet, opus, haiku, opus-4.6)')
     .action(startCommand);
 program
     .command('config')
@@ -30,4 +32,8 @@ program
     .option('-d, --delete', 'Delete saved API key')
     .option('-p, --path', 'Show config file path')
     .action(configCommand);
+program
+    .command('model [name]')
+    .description('View or set the default model')
+    .action(modelCommand);
 program.parse();

package/dist/commands/model.d.ts

@@ -0,0 +1 @@
+export declare function modelCommand(name?: string): Promise<void>;

package/dist/commands/model.js

@@ -0,0 +1,62 @@
+import { homedir } from 'os';
+import { join } from 'path';
+import { mkdir, writeFile, readFile } from 'fs/promises';
+import chalk from 'chalk';
+import { MODEL_MAP, DEFAULT_MODEL } from '../core/types.js';
+const CONFIG_DIR = join(homedir(), '.threewzrd');
+const CONFIG_PATH = join(CONFIG_DIR, 'config.json');
+const VALID_MODELS = ['sonnet', 'opus', 'haiku', 'opus-4.6'];
+async function loadConfig() {
+    try {
+        const content = await readFile(CONFIG_PATH, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+async function saveConfig(config) {
+    await mkdir(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    await writeFile(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n', { mode: 0o600 });
+}
+export async function modelCommand(name) {
+    console.log();
+    if (!name) {
+        // Show current model
+        const config = await loadConfig();
+        const currentModel = config.model || DEFAULT_MODEL;
+        console.log(chalk.cyan('  Model Configuration'));
+        console.log(chalk.gray('  ─────────────────────────────────────────'));
+        console.log();
+        console.log(chalk.gray('  Current default: ') + chalk.green(currentModel));
+        console.log(chalk.gray('  Model ID: ') + chalk.gray(MODEL_MAP[currentModel]));
+        console.log();
+        console.log(chalk.gray('  Available models:'));
+        for (const model of VALID_MODELS) {
+            const marker = model === currentModel ? chalk.green(' (default)') : '';
+            console.log(chalk.gray('    - ') + chalk.white(model) + marker);
+        }
+        console.log();
+        console.log(chalk.gray('  To change: ') + chalk.cyan('threewzrd model <name>'));
+        console.log();
+        return;
+    }
+    // Set model
+    const modelName = name.toLowerCase();
+    if (!VALID_MODELS.includes(modelName)) {
+        console.log(chalk.red(`  Unknown model: ${name}`));
+        console.log();
+        console.log(chalk.gray('  Valid models:'));
+        for (const model of VALID_MODELS) {
+            console.log(chalk.gray('    - ') + chalk.white(model));
+        }
+        console.log();
+        return;
+    }
+    const config = await loadConfig();
+    config.model = modelName;
+    await saveConfig(config);
+    console.log(chalk.green(`  Default model set to: ${modelName}`));
+    console.log(chalk.gray(`  Model ID: ${MODEL_MAP[modelName]}`));
+    console.log();
+}

package/dist/commands/start.d.ts

@@ -1,5 +1,6 @@
 interface StartOptions {
     directory: string;
+    model?: string;
 }
 export declare function startCommand(options: StartOptions): Promise<void>;
 export {};

package/dist/commands/start.js

@@ -1,10 +1,25 @@
 import dotenv from 'dotenv';
 import { homedir } from 'os';
 import { join } from 'path';
-import { mkdir, writeFile } from 'fs/promises';
+import { mkdir, writeFile, readFile } from 'fs/promises';
 import * as readline from 'readline';
 import chalk from 'chalk';
 import { ThreeJsWizard } from '../core/ThreeJsWizard.js';
+const VALID_MODELS = ['sonnet', 'opus', 'haiku', 'opus-4.6'];
+async function getConfiguredModel() {
+    try {
+        const configPath = join(homedir(), '.threewzrd', 'config.json');
+        const content = await readFile(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        if (config.model && VALID_MODELS.includes(config.model)) {
+            return config.model;
+        }
+    }
+    catch {
+        // No config file or invalid config
+    }
+    return undefined;
+}
 function loadEnvFiles(workingDir) {
     // Load from multiple locations (later ones don't override earlier)
     // 1. Current working directory
@@ -128,8 +143,23 @@ export async function startCommand(options) {
             await saveApiKey(apiKey);
         }
     }
+    // Determine which model to use (CLI flag > config > default)
+    let model;
+    if (options.model) {
+        if (VALID_MODELS.includes(options.model)) {
+            model = options.model;
+        }
+        else {
+            console.error(chalk.red(`Invalid model: ${options.model}`));
+            console.error(chalk.gray(`Valid models: ${VALID_MODELS.join(', ')}`));
+            process.exit(1);
+        }
+    }
+    else {
+        model = await getConfiguredModel();
+    }
     // Create and start the wizard
-    const wizard = new ThreeJsWizard();
+    const wizard = new ThreeJsWizard({ model });
     // Handle graceful shutdown
     process.on('SIGINT', () => {
         console.log('\nShutting down...');

package/dist/core/AgentEngine.js

@@ -1,5 +1,5 @@
 import Anthropic from '@anthropic-ai/sdk';
-import { MODEL_MAP } from './types.js';
+import { MODEL_MAP, DEFAULT_MODEL } from './types.js';
 import { toolDefinitions } from '../tools/definitions.js';
 import { ToolExecutor } from '../tools/ToolExecutor.js';
 import { THREEJS_SYSTEM_PROMPT } from '../prompts/system.js';
@@ -10,7 +10,7 @@ const MAX_RETRIES = 3;
 const RETRY_DELAY_MS = 5000; // 5 seconds base delay
 export class AgentEngine {
     client;
-    model = 'sonnet';
+    model = DEFAULT_MODEL;
     conversationHistory = [];
     toolExecutor;
     ui;

package/dist/core/ThreeJsWizard.d.ts

@@ -1,3 +1,7 @@
+import { ModelId } from './types.js';
+export interface WizardOptions {
+    model?: ModelId;
+}
 export declare class ThreeJsWizard {
     private ui;
     private engine;
@@ -5,7 +9,7 @@ export declare class ThreeJsWizard {
     private workingDirectory;
     private isRunning;
     private hasOnboarded;
-    constructor();
+    constructor(options?: WizardOptions);
     start(): Promise<void>;
     private handleCommand;
     stop(): void;

package/dist/core/ThreeJsWizard.js

@@ -9,11 +9,14 @@ export class ThreeJsWizard {
     workingDirectory;
     isRunning = false;
     hasOnboarded = false;
-    constructor() {
+    constructor(options) {
         this.workingDirectory = process.cwd();
         this.ui = new TerminalUI();
         this.engine = new AgentEngine(this.ui, this.workingDirectory);
         this.projectManager = new ProjectManager(this.workingDirectory);
+        if (options?.model) {
+            this.engine.setModel(options.model);
+        }
     }
     async start() {
         this.isRunning = true;
@@ -100,16 +103,16 @@ export class ThreeJsWizard {
             case 'model':
                 if (args.length === 0) {
                     this.ui.printInfo(`Current model: ${this.engine.getModel()}`);
-                    this.ui.printInfo('Available models: sonnet, opus, haiku');
+                    this.ui.printInfo('Available models: sonnet, opus, haiku, opus-4.6');
                 }
                 else {
                     const modelName = args[0].toLowerCase();
-                    if (['sonnet', 'opus', 'haiku'].includes(modelName)) {
+                    if (['sonnet', 'opus', 'haiku', 'opus-4.6'].includes(modelName)) {
                         this.engine.setModel(modelName);
                         this.ui.printModelSwitch(modelName);
                     }
                     else {
-                        this.ui.printError(`Unknown model: ${modelName}. Use: sonnet, opus, or haiku`);
+                        this.ui.printError(`Unknown model: ${modelName}. Use: sonnet, opus, haiku, or opus-4.6`);
                     }
                 }
                 break;

package/dist/core/types.d.ts

@@ -1,6 +1,7 @@
 import Anthropic from '@anthropic-ai/sdk';
-export type ModelId = 'sonnet' | 'opus' | 'haiku';
+export type ModelId = 'sonnet' | 'opus' | 'haiku' | 'opus-4.6';
 export declare const MODEL_MAP: Record<ModelId, string>;
+export declare const DEFAULT_MODEL: ModelId;
 export type ProjectLanguage = 'javascript' | 'typescript';
 export type ProjectTarget = 'browser' | 'mobile' | 'desktop';
 export interface ProjectPreferences {
@@ -30,6 +31,7 @@ export type ToolName = 'write_file' | 'read_file' | 'run_command' | 'list_files'
 export interface WriteFileInput {
     path: string;
     content: string;
+    skipValidation?: boolean;
 }
 export interface ReadFileInput {
     path: string;

package/dist/core/types.js

@@ -2,4 +2,6 @@ export const MODEL_MAP = {
     sonnet: 'claude-sonnet-4-20250514',
     opus: 'claude-opus-4-20250514',
     haiku: 'claude-haiku-4-20250514',
+    'opus-4.6': 'claude-opus-4-6-20260201',
 };
+export const DEFAULT_MODEL = 'opus-4.6';

package/dist/prompts/system.d.ts

@@ -1 +1 @@
-export declare const THREEJS_SYSTEM_PROMPT = "\nYou are a senior-level Three.js engineer and 3D world architect.\n\nYour responsibility is to design and implement complete, working Three.js projects using modern best practices. You operate inside a CLI-based development agent with tool access.\n\nYou think carefully before acting. You plan when necessary. You modify incrementally. You do not guess APIs.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Core Identity\n\nYou are:\n- A production-grade Three.js developer\n- A 3D world designer (lighting, scale, composition matter)\n- Careful and methodical\n- Tool-disciplined\n- Architecture-aware\n\nYou do NOT:\n- Rewrite working code unnecessarily\n- Overwrite unrelated files\n- Guess unfamiliar APIs\n- Create partial or broken implementations\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Available Tools\n\nYou have access to:\n\n- write_file(path, content)\n- read_file(path)\n- list_files(path?, recursive?)\n- run_command(command, cwd?)\n\nUse them strategically and in the correct order.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Autonomous Execution Protocol\n\nYou operate in a structured execution loop.\n\nFor every user request:\n\n1. Analyze the task fully.\n2. Determine whether to use:\n   - Single-Shot Mode\n   - Planning Mode\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Execution Modes\n\n### 1. Single-Shot Mode\n\nUse when:\n- The request is small and self-contained\n- No major architecture decisions are required\n- Creating a simple new project\n\nIn this mode:\n- Plan internally\n- Create all required files\n- Install dependencies\n- Provide run instructions\n\nDo not output a formal plan in this mode.\n\n---\n\n### 2. Planning Mode (Multi-Step)\n\nUse when:\n- The project is complex\n- Multiple systems are involved (loaders, shaders, physics, post-processing, controls, etc.)\n- Modifying an existing project\n- Architectural decisions are required\n\nWhen using Planning Mode, you MUST output:\n\n## Implementation Plan\n\n### Architecture Overview\n(High-level design)\n\n### Dependencies\n(List npm packages required)\n\n### File Structure\n(project layout)\n\n### Execution Steps\n(Numbered steps)\n\nAfter producing the plan, begin executing step-by-step using tools.\n\nAfter each tool call:\n- Reassess the project state\n- Continue execution until complete\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Session Initialization Rule\n\nAt the beginning of a session or before modifying code:\n\n- Use list_files to inspect the current directory.\n- Determine whether this is:\n  - A new project\n  - An existing Three.js project\n  - A non-Three.js project\n\nNever assume project structure without inspecting it first.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Tool Usage Discipline\n\nBefore calling any tool:\n\n1. Understand the full scope of the change.\n2. Identify all files that will be affected.\n3. Determine dependencies.\n4. Confirm directory structure.\n\nRules:\n\n- Always use read_file before modifying a file.\n- Never overwrite unrelated files.\n- Only call run_command after files are written.\n- If run_command fails:\n  - Analyze the error\n  - Fix the issue\n  - Retry\n- Do not reinstall dependencies unnecessarily.\n- Do not recreate projects that already exist.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Modern Three.js Standards\n\nAlways follow current best practices:\n\n- Use ES modules.\n- Import from 'three'.\n- Use addons correctly (three/addons/...).\n- Avoid deprecated APIs (e.g., Geometry).\n- Use BufferGeometry.\n- Set renderer pixel ratio.\n- Handle window resize properly.\n- Use renderer.outputColorSpace = THREE.SRGBColorSpace.\n- Use physically correct lighting when appropriate.\n- Enable antialiasing.\n- Never create objects inside the render loop.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Required Scene Structure\n\nA standard scene should include:\n\n- Scene\n- PerspectiveCamera (unless otherwise required)\n- WebGLRenderer with antialias\n- AmbientLight + DirectionalLight (unless specified otherwise)\n- Animation loop using requestAnimationFrame\n- Resize handling\n- Clean object organization\n\nGroup related objects logically.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Performance & Memory Safety\n\n- Avoid allocations inside animation loop.\n- Use InstancedMesh for repeated geometry.\n- Dispose of geometries/materials when replacing them.\n- Avoid blocking the main thread.\n- Merge static geometries when appropriate.\n- Be mindful of texture sizes.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Shader Implementation Rules\n\nWhen creating custom shaders:\n\n- Use ShaderMaterial.\n- Separate complex shaders into /src/shaders/.\n- Use uniforms for time-based animation.\n- Pass varyings correctly.\n- Comment GLSL clearly.\n- Do not guess GLSL syntax.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## TypeScript Rules (When Requested)\n\nIf the user wants TypeScript:\n\n- Use .ts files.\n- Create tsconfig.json.\n- Add type annotations.\n- Import types from 'three'.\n- Ensure Vite supports TS.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## World Design Intelligence\n\nYou think like a 3D world architect.\n\nBefore implementing a scene, consider:\n\n- Scale realism\n- Camera ergonomics\n- Lighting mood\n- Visual composition\n- Performance trade-offs\n- Interactivity patterns\n\nDo not just place objects \u2014 design environments.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Completion Criteria\n\nA task is complete when:\n\n- All required files are created or updated\n- Dependencies are installed\n- The project runs successfully\n- Clear run instructions are provided\n\nEnd by telling the user exactly how to run the project:\n  npm install\n  npm run dev\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Your Goal\n\nTransform natural language ideas into clean, scalable, production-ready Three.js projects.\n\nBe precise.\nBe structured.\nBe architectural.\nBe reliable.\n";
+export declare const THREEJS_SYSTEM_PROMPT = "\nYou are a senior-level Three.js engineer and 3D world architect.\n\nYour responsibility is to design and implement complete, working Three.js projects using modern best practices. You operate inside a CLI-based development agent with tool access.\n\nYou think carefully before acting. You plan when necessary. You modify incrementally. You do not guess APIs.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Core Identity\n\nYou are:\n- A production-grade Three.js developer\n- A 3D world designer (lighting, scale, composition matter)\n- Careful and methodical\n- Tool-disciplined\n- Architecture-aware\n\nYou do NOT:\n- Rewrite working code unnecessarily\n- Overwrite unrelated files\n- Guess unfamiliar APIs\n- Create partial or broken implementations\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Available Tools\n\nYou have access to:\n\n- write_file(path, content)\n- read_file(path)\n- list_files(path?, recursive?)\n- run_command(command, cwd?)\n\nUse them strategically and in the correct order.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Autonomous Execution Protocol\n\nYou operate in a structured execution loop.\n\nFor every user request:\n\n1. Analyze the task fully.\n2. Determine whether to use:\n   - Single-Shot Mode\n   - Planning Mode\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Execution Modes\n\n### 1. Single-Shot Mode\n\nUse when:\n- The request is small and self-contained\n- No major architecture decisions are required\n- Creating a simple new project\n\nIn this mode:\n- Plan internally\n- Create all required files\n- Install dependencies\n- Provide run instructions\n\nDo not output a formal plan in this mode.\n\n---\n\n### 2. Planning Mode (Multi-Step)\n\nUse when:\n- The project is complex\n- Multiple systems are involved (loaders, shaders, physics, post-processing, controls, etc.)\n- Modifying an existing project\n- Architectural decisions are required\n\nWhen using Planning Mode, you MUST output:\n\n## Implementation Plan\n\n### Architecture Overview\n(High-level design)\n\n### Dependencies\n(List npm packages required)\n\n### File Structure\n(project layout)\n\n### Execution Steps\n(Numbered steps)\n\nAfter producing the plan, begin executing step-by-step using tools.\n\nAfter each tool call:\n- Reassess the project state\n- Continue execution until complete\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Session Initialization Rule\n\nAt the beginning of a session or before modifying code:\n\n- Use list_files to inspect the current directory.\n- Determine whether this is:\n  - A new project\n  - An existing Three.js project\n  - A non-Three.js project\n\nNever assume project structure without inspecting it first.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Tool Usage Discipline\n\nBefore calling any tool:\n\n1. Understand the full scope of the change.\n2. Identify all files that will be affected.\n3. Determine dependencies.\n4. Confirm directory structure.\n\nRules:\n\n- Always use read_file before modifying a file.\n- Never overwrite unrelated files.\n- Only call run_command after files are written.\n- If run_command fails:\n  - Analyze the error\n  - Fix the issue\n  - Retry\n- Do not reinstall dependencies unnecessarily.\n- Do not recreate projects that already exist.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Code Quality Requirements\n\nBefore writing any code file:\n1. Ensure all braces, brackets, and parentheses are balanced\n2. Ensure all strings and template literals are properly closed\n3. Verify import statements are correct and complete\n4. Double-check syntax before calling write_file\n\nThe system validates JavaScript, TypeScript, and JSON syntax automatically.\nIf validation fails, fix the errors and retry.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Modern Three.js Standards\n\nAlways follow current best practices:\n\n- Use ES modules.\n- Import from 'three'.\n- Use addons correctly (three/addons/...).\n- Avoid deprecated APIs (e.g., Geometry).\n- Use BufferGeometry.\n- Set renderer pixel ratio.\n- Handle window resize properly.\n- Use renderer.outputColorSpace = THREE.SRGBColorSpace.\n- Use physically correct lighting when appropriate.\n- Enable antialiasing.\n- Never create objects inside the render loop.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Required Scene Structure\n\nA standard scene should include:\n\n- Scene\n- PerspectiveCamera (unless otherwise required)\n- WebGLRenderer with antialias\n- AmbientLight + DirectionalLight (unless specified otherwise)\n- Animation loop using requestAnimationFrame\n- Resize handling\n- Clean object organization\n\nGroup related objects logically.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Performance & Memory Safety\n\n- Avoid allocations inside animation loop.\n- Use InstancedMesh for repeated geometry.\n- Dispose of geometries/materials when replacing them.\n- Avoid blocking the main thread.\n- Merge static geometries when appropriate.\n- Be mindful of texture sizes.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Shader Implementation Rules\n\nWhen creating custom shaders:\n\n- Use ShaderMaterial.\n- Separate complex shaders into /src/shaders/.\n- Use uniforms for time-based animation.\n- Pass varyings correctly.\n- Comment GLSL clearly.\n- Do not guess GLSL syntax.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## TypeScript Rules (When Requested)\n\nIf the user wants TypeScript:\n\n- Use .ts files.\n- Create tsconfig.json.\n- Add type annotations.\n- Import types from 'three'.\n- Ensure Vite supports TS.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## World Design Intelligence\n\nYou think like a 3D world architect.\n\nBefore implementing a scene, consider:\n\n- Scale realism\n- Camera ergonomics\n- Lighting mood\n- Visual composition\n- Performance trade-offs\n- Interactivity patterns\n\nDo not just place objects \u2014 design environments.\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Completion Criteria\n\nA task is complete when:\n\n- All required files are created or updated\n- Dependencies are installed\n- The project runs successfully\n- Clear run instructions are provided\n\nEnd by telling the user exactly how to run the project:\n  npm install\n  npm run dev\n\n\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n## Your Goal\n\nTransform natural language ideas into clean, scalable, production-ready Three.js projects.\n\nBe precise.\nBe structured.\nBe architectural.\nBe reliable.\n";

package/dist/prompts/system.js

@@ -130,6 +130,18 @@ Rules:
 - Do not reinstall dependencies unnecessarily.
 - Do not recreate projects that already exist.
 
+────────────────────────────────
+## Code Quality Requirements
+
+Before writing any code file:
+1. Ensure all braces, brackets, and parentheses are balanced
+2. Ensure all strings and template literals are properly closed
+3. Verify import statements are correct and complete
+4. Double-check syntax before calling write_file
+
+The system validates JavaScript, TypeScript, and JSON syntax automatically.
+If validation fails, fix the errors and retry.
+
 ────────────────────────────────
 ## Modern Three.js Standards
 

package/dist/tools/CodeValidator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Code Validator - Syntax validation for JavaScript, TypeScript, and JSON files
+ * Provides basic syntax checks before writing code files
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Checks if a file should be validated based on its extension
+ */
+export declare function shouldValidate(filePath: string): boolean;
+/**
+ * Validates file content based on file type
+ */
+export declare function validate(filePath: string, content: string): ValidationResult;
+/**
+ * Validates JSON syntax
+ */
+export declare function validateJSON(content: string): ValidationResult;
+/**
+ * Validates JavaScript/TypeScript syntax (basic checks)
+ */
+export declare function validateJavaScript(content: string): ValidationResult;
+/**
+ * Checks for balanced delimiters: {}, [], ()
+ */
+export declare function checkBalancedDelimiters(content: string): {
+    errors: string[];
+};
+/**
+ * Checks for unclosed string literals
+ */
+export declare function checkStrings(content: string): {
+    errors: string[];
+    warnings: string[];
+};
+/**
+ * Checks for unclosed template literals
+ */
+export declare function checkTemplateLiterals(content: string): {
+    errors: string[];
+};

package/dist/tools/CodeValidator.js

@@ -0,0 +1,286 @@
+/**
+ * Code Validator - Syntax validation for JavaScript, TypeScript, and JSON files
+ * Provides basic syntax checks before writing code files
+ */
+// File extensions that should be validated
+const VALIDATABLE_EXTENSIONS = new Set(['.js', '.ts', '.jsx', '.tsx', '.mjs', '.cjs', '.json']);
+/**
+ * Checks if a file should be validated based on its extension
+ */
+export function shouldValidate(filePath) {
+    const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();
+    return VALIDATABLE_EXTENSIONS.has(ext);
+}
+/**
+ * Validates file content based on file type
+ */
+export function validate(filePath, content) {
+    const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();
+    if (ext === '.json') {
+        return validateJSON(content);
+    }
+    if (['.js', '.ts', '.jsx', '.tsx', '.mjs', '.cjs'].includes(ext)) {
+        return validateJavaScript(content);
+    }
+    return { valid: true, errors: [], warnings: [] };
+}
+/**
+ * Validates JSON syntax
+ */
+export function validateJSON(content) {
+    const errors = [];
+    const warnings = [];
+    try {
+        JSON.parse(content);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            errors.push(`JSON syntax error: ${error.message}`);
+        }
+        else {
+            errors.push(`JSON parsing failed: ${String(error)}`);
+        }
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Validates JavaScript/TypeScript syntax (basic checks)
+ */
+export function validateJavaScript(content) {
+    const errors = [];
+    const warnings = [];
+    // Check balanced delimiters
+    const delimiterResult = checkBalancedDelimiters(content);
+    errors.push(...delimiterResult.errors);
+    // Check unclosed strings
+    const stringResult = checkStrings(content);
+    errors.push(...stringResult.errors);
+    warnings.push(...stringResult.warnings);
+    // Check template literals
+    const templateResult = checkTemplateLiterals(content);
+    errors.push(...templateResult.errors);
+    return { valid: errors.length === 0, errors, warnings };
+}
+/**
+ * Checks for balanced delimiters: {}, [], ()
+ */
+export function checkBalancedDelimiters(content) {
+    const errors = [];
+    const stack = [];
+    const pairs = { '{': '}', '[': ']', '(': ')' };
+    const closers = { '}': '{', ']': '[', ')': '(' };
+    let inString = null;
+    let inTemplateString = false;
+    let inLineComment = false;
+    let inBlockComment = false;
+    let lineNumber = 1;
+    let i = 0;
+    while (i < content.length) {
+        const char = content[i];
+        const nextChar = content[i + 1];
+        // Track line numbers
+        if (char === '\n') {
+            lineNumber++;
+            inLineComment = false;
+            i++;
+            continue;
+        }
+        // Handle comments
+        if (!inString && !inTemplateString && !inBlockComment && char === '/' && nextChar === '/') {
+            inLineComment = true;
+            i += 2;
+            continue;
+        }
+        if (!inString && !inTemplateString && !inLineComment && char === '/' && nextChar === '*') {
+            inBlockComment = true;
+            i += 2;
+            continue;
+        }
+        if (inBlockComment && char === '*' && nextChar === '/') {
+            inBlockComment = false;
+            i += 2;
+            continue;
+        }
+        // Skip if in comment
+        if (inLineComment || inBlockComment) {
+            i++;
+            continue;
+        }
+        // Handle escape sequences
+        if ((inString || inTemplateString) && char === '\\') {
+            i += 2;
+            continue;
+        }
+        // Handle string delimiters
+        if (char === '`') {
+            inTemplateString = !inTemplateString;
+            i++;
+            continue;
+        }
+        if ((char === '"' || char === "'") && !inTemplateString) {
+            if (inString === char) {
+                inString = null;
+            }
+            else if (!inString) {
+                inString = char;
+            }
+            i++;
+            continue;
+        }
+        // Skip if inside string
+        if (inString || inTemplateString) {
+            i++;
+            continue;
+        }
+        // Track delimiters
+        if (pairs[char]) {
+            stack.push({ char, line: lineNumber });
+        }
+        else if (closers[char]) {
+            const expected = closers[char];
+            if (stack.length === 0) {
+                errors.push(`Unexpected '${char}' at line ${lineNumber} - no matching '${expected}'`);
+            }
+            else {
+                const top = stack.pop();
+                if (top.char !== expected) {
+                    errors.push(`Mismatched delimiter: expected '${pairs[top.char]}' to close '${top.char}' from line ${top.line}, but found '${char}' at line ${lineNumber}`);
+                }
+            }
+        }
+        i++;
+    }
+    // Report unclosed delimiters
+    for (const unclosed of stack) {
+        errors.push(`Unclosed '${unclosed.char}' from line ${unclosed.line} - missing '${pairs[unclosed.char]}'`);
+    }
+    return { errors };
+}
+/**
+ * Checks for unclosed string literals
+ */
+export function checkStrings(content) {
+    const errors = [];
+    const warnings = [];
+    const lines = content.split('\n');
+    for (let lineIdx = 0; lineIdx < lines.length; lineIdx++) {
+        const line = lines[lineIdx];
+        const lineNumber = lineIdx + 1;
+        // Skip lines that are likely comments
+        const trimmed = line.trim();
+        if (trimmed.startsWith('//') || trimmed.startsWith('*') || trimmed.startsWith('/*')) {
+            continue;
+        }
+        let inString = null;
+        let stringStart = -1;
+        let i = 0;
+        while (i < line.length) {
+            const char = line[i];
+            // Handle escape sequences
+            if (inString && char === '\\') {
+                i += 2;
+                continue;
+            }
+            // Check for template literals - they can span multiple lines
+            if (char === '`') {
+                // Template literals are handled separately
+                i++;
+                continue;
+            }
+            if ((char === '"' || char === "'")) {
+                if (inString === char) {
+                    inString = null;
+                }
+                else if (!inString) {
+                    inString = char;
+                    stringStart = i;
+                }
+            }
+            i++;
+        }
+        // Check for unclosed string on this line (not template literals)
+        if (inString) {
+            // Check if this might be intentional (like a long string literal)
+            // or if it's clearly an error
+            const remainingContent = line.slice(stringStart);
+            if (remainingContent.length > 100) {
+                warnings.push(`Possibly unclosed string starting at line ${lineNumber}, column ${stringStart + 1}`);
+            }
+            else {
+                errors.push(`Unclosed string '${inString}' at line ${lineNumber}, column ${stringStart + 1}`);
+            }
+        }
+    }
+    return { errors, warnings };
+}
+/**
+ * Checks for unclosed template literals
+ */
+export function checkTemplateLiterals(content) {
+    const errors = [];
+    let inTemplate = false;
+    let templateStartLine = 0;
+    let lineNumber = 1;
+    let inLineComment = false;
+    let inBlockComment = false;
+    let inString = null;
+    for (let i = 0; i < content.length; i++) {
+        const char = content[i];
+        const nextChar = content[i + 1];
+        if (char === '\n') {
+            lineNumber++;
+            inLineComment = false;
+            continue;
+        }
+        // Handle comments
+        if (!inString && !inTemplate && !inBlockComment && char === '/' && nextChar === '/') {
+            inLineComment = true;
+            continue;
+        }
+        if (!inString && !inTemplate && !inLineComment && char === '/' && nextChar === '*') {
+            inBlockComment = true;
+            i++;
+            continue;
+        }
+        if (inBlockComment && char === '*' && nextChar === '/') {
+            inBlockComment = false;
+            i++;
+            continue;
+        }
+        if (inLineComment || inBlockComment) {
+            continue;
+        }
+        // Handle escape sequences
+        if ((inString || inTemplate) && char === '\\') {
+            i++;
+            continue;
+        }
+        // Handle regular strings
+        if ((char === '"' || char === "'") && !inTemplate) {
+            if (inString === char) {
+                inString = null;
+            }
+            else if (!inString) {
+                inString = char;
+            }
+            continue;
+        }
+        if (inString) {
+            continue;
+        }
+        // Handle template literals
+        if (char === '`') {
+            if (inTemplate) {
+                inTemplate = false;
+            }
+            else {
+                inTemplate = true;
+                templateStartLine = lineNumber;
+            }
+        }
+    }
+    if (inTemplate) {
+        errors.push(`Unclosed template literal starting at line ${templateStartLine}`);
+    }
+    return { errors };
+}

package/dist/tools/ToolExecutor.d.ts

@@ -27,8 +27,13 @@ export declare class ToolExecutor {
      * Validates ListFilesInput structure and types
      */
     private validateListFilesInput;
+    /**
+     * Tokenizes a single command (no pipes) into tokens respecting quotes
+     */
+    private tokenizeCommand;
     /**
      * Parses a command string into executable and arguments safely
+     * Supports piped commands (e.g., "grep foo | wc -l")
      */
     private parseCommand;
     execute(toolName: ToolName, input: unknown): Promise<ToolResult>;

package/dist/tools/ToolExecutor.js

@@ -1,26 +1,31 @@
 import * as fs from 'fs/promises';
 import * as path from 'path';
 import { spawn } from 'child_process';
+import { shouldValidate, validate } from './CodeValidator.js';
 // Whitelist of allowed commands for security
 const ALLOWED_COMMANDS = new Set([
-    'npm',
-    'npx',
-    'node',
-    'mkdir',
+    // Package managers
+    'npm', 'npx', 'pnpm', 'yarn', 'bun',
+    // Build tools & runtimes
+    'node', 'tsc', 'vite', 'esbuild', 'rollup', 'webpack',
+    // Version control
     'git',
-    'pnpm',
-    'yarn',
-    'bun',
-    'tsc',
-    'vite',
-    'esbuild',
-    'cat',
-    'ls',
-    'pwd',
-    'echo',
+    // File operations
+    'mkdir', 'touch', 'rm', 'cp', 'mv', 'chmod', 'ln',
+    // File inspection
+    'cat', 'ls', 'pwd', 'head', 'tail', 'wc', 'file', 'stat',
+    // Search and text processing
+    'grep', 'find', 'sed', 'awk', 'sort', 'uniq', 'diff', 'tr', 'cut',
+    // System utilities
+    'echo', 'which', 'whereis', 'env', 'basename', 'dirname', 'realpath',
+    // Archive tools
+    'tar', 'zip', 'unzip', 'gzip', 'gunzip',
+    // Testing
+    'jest', 'vitest', 'mocha', 'playwright', 'cypress',
 ]);
 // Dangerous shell metacharacters that indicate command injection attempts
-const DANGEROUS_PATTERNS = /[;&|`$(){}[\]<>!\\]/;
+// Note: | (pipe) is allowed and handled specially for piped commands
+const DANGEROUS_PATTERNS = /[;&`$(){}[\]<>!\\]/;
 export class ToolExecutor {
     workingDirectory;
     ui;
@@ -62,7 +67,11 @@ export class ToolExecutor {
         if (typeof obj.content !== 'string') {
             throw new Error('Invalid input: content must be a string');
         }
-        return { path: obj.path.trim(), content: obj.content };
+        return {
+            path: obj.path.trim(),
+            content: obj.content,
+            skipValidation: obj.skipValidation === true
+        };
     }
     /**
      * Validates ReadFileInput structure and types
@@ -116,14 +125,9 @@ export class ToolExecutor {
         };
     }
     /**
-     * Parses a command string into executable and arguments safely
+     * Tokenizes a single command (no pipes) into tokens respecting quotes
      */
-    parseCommand(cmdString) {
-        // Check for dangerous shell metacharacters
-        if (DANGEROUS_PATTERNS.test(cmdString)) {
-            throw new Error('Command contains dangerous shell metacharacters');
-        }
-        // Simple tokenization - split on whitespace, respecting quotes
+    tokenizeCommand(cmdString) {
         const tokens = [];
         let current = '';
         let inQuote = null;
@@ -156,12 +160,38 @@ export class ToolExecutor {
         if (inQuote) {
             throw new Error('Unclosed quote in command');
         }
-        if (tokens.length === 0) {
-            throw new Error('Empty command');
+        return tokens;
+    }
+    /**
+     * Parses a command string into executable and arguments safely
+     * Supports piped commands (e.g., "grep foo | wc -l")
+     */
+    parseCommand(cmdString) {
+        // Check for dangerous shell metacharacters (pipe is allowed)
+        if (DANGEROUS_PATTERNS.test(cmdString)) {
+            throw new Error('Command contains dangerous shell metacharacters');
+        }
+        // Check if command contains pipes
+        const pipeSegments = cmdString.split('|').map(s => s.trim()).filter(s => s.length > 0);
+        const isPiped = pipeSegments.length > 1;
+        // Validate each command in the pipeline against the whitelist
+        const pipeChain = [];
+        for (const segment of pipeSegments) {
+            const tokens = this.tokenizeCommand(segment);
+            if (tokens.length === 0) {
+                throw new Error('Empty command in pipeline');
+            }
+            const segmentCmd = tokens[0];
+            if (!ALLOWED_COMMANDS.has(segmentCmd)) {
+                throw new Error(`Command not allowed: ${segmentCmd}. Allowed commands: ${Array.from(ALLOWED_COMMANDS).join(', ')}`);
+            }
+            pipeChain.push(segment);
         }
-        const cmd = tokens[0];
-        const args = tokens.slice(1);
-        return { cmd, args };
+        // For the return value, use the first command's info
+        const firstTokens = this.tokenizeCommand(pipeSegments[0]);
+        const cmd = firstTokens[0];
+        const args = firstTokens.slice(1);
+        return { cmd, args, isPiped, pipeChain };
     }
     async execute(toolName, input) {
         switch (toolName) {
@@ -188,6 +218,27 @@ export class ToolExecutor {
             // Validate path doesn't escape working directory
             const fullPath = this.validatePath(validatedInput.path);
             const dir = path.dirname(fullPath);
+            // Run syntax validation for code files (unless skipped)
+            if (!validatedInput.skipValidation && shouldValidate(validatedInput.path)) {
+                const validationResult = validate(validatedInput.path, validatedInput.content);
+                // If there are errors, don't write the file
+                if (!validationResult.valid) {
+                    const errorDetails = validationResult.errors.join('\n  - ');
+                    this.ui.printToolCall('write_file', `Writing: ${validatedInput.path}`);
+                    this.ui.printToolResult(false, 'Syntax validation failed');
+                    return {
+                        success: false,
+                        output: '',
+                        error: `Syntax validation failed for ${validatedInput.path}:\n  - ${errorDetails}\n\nFix the syntax errors and try again.`,
+                    };
+                }
+                // Print warnings but continue
+                if (validationResult.warnings.length > 0) {
+                    for (const warning of validationResult.warnings) {
+                        this.ui.printWarning(warning);
+                    }
+                }
+            }
             // Create directory if it doesn't exist
             await fs.mkdir(dir, { recursive: true });
             // Write the file
@@ -243,17 +294,8 @@ export class ToolExecutor {
             // Validate input structure
             const validatedInput = this.validateRunCommandInput(input);
             // Parse command into executable and arguments
-            const { cmd, args } = this.parseCommand(validatedInput.command);
-            // Check if command is in whitelist
-            if (!ALLOWED_COMMANDS.has(cmd)) {
-                this.ui.printToolCall('run_command', `Command: ${validatedInput.command}`);
-                this.ui.printToolResult(false, `Command not allowed: ${cmd}`);
-                return {
-                    success: false,
-                    output: '',
-                    error: `Command not allowed: ${cmd}. Allowed commands: ${Array.from(ALLOWED_COMMANDS).join(', ')}`,
-                };
-            }
+            // This also validates all commands in a pipeline against the whitelist
+            const { cmd, args, isPiped, pipeChain } = this.parseCommand(validatedInput.command);
             // Validate and resolve cwd if provided
             let cwd = this.workingDirectory;
             if (validatedInput.cwd) {
@@ -270,14 +312,21 @@ export class ToolExecutor {
                     error: 'User declined to run this command',
                 };
             }
-            // Use spawn instead of exec for security (no shell interpretation)
+            // For piped commands, use shell with pre-validated command string
+            // For non-piped commands, use spawn without shell for security
             return new Promise((resolve) => {
-                const child = spawn(cmd, args, {
-                    cwd,
-                    stdio: ['inherit', 'pipe', 'pipe'],
-                    timeout: 60000, // 60 second timeout
-                    shell: false, // Explicitly disable shell for security
-                });
+                const child = isPiped
+                    ? spawn('sh', ['-c', pipeChain.join(' | ')], {
+                        cwd,
+                        stdio: ['inherit', 'pipe', 'pipe'],
+                        timeout: 60000, // 60 second timeout
+                    })
+                    : spawn(cmd, args, {
+                        cwd,
+                        stdio: ['inherit', 'pipe', 'pipe'],
+                        timeout: 60000, // 60 second timeout
+                        shell: false, // Explicitly disable shell for security
+                    });
                 let stdout = '';
                 let stderr = '';
                 child.stdout?.on('data', (data) => {

package/dist/ui/TerminalUI.js

@@ -110,6 +110,7 @@ export class TerminalUI {
             sonnet: 'Claude Sonnet 4',
             opus: 'Claude Opus 4',
             haiku: 'Claude Haiku 4',
+            'opus-4.6': 'Claude Opus 4.6',
         };
         console.log(chalk.green(`Switched to ${modelNames[model]}`));
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "threewzrd",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "AI-powered CLI for generating Three.js projects from natural language",
   "main": "dist/cli.js",
   "bin": {