helix-lang 11.0.0

package/dist/commands/preflight.js

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * Helix Pre-flight Validator (Architect Agent)
+ * Validates .helix blueprint files before generation to catch errors early.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preflight = preflight;
+exports.formatPreflightResult = formatPreflightResult;
+const parser_1 = require("../parser");
+const VALID_FIELD_TYPES = [
+    'String', 'Int', 'Float', 'Boolean', 'DateTime',
+    'Json', 'BigInt', 'Decimal', 'Bytes'
+];
+function preflight(blueprintContent) {
+    const result = {
+        passed: true,
+        score: 100,
+        errors: [],
+        warnings: [],
+        info: []
+    };
+    // 1. Try to parse
+    let ast;
+    try {
+        ast = (0, parser_1.parseHelix)(blueprintContent);
+    }
+    catch (e) {
+        result.errors.push({
+            severity: 'error',
+            code: 'PARSE_FAILURE',
+            message: `Blueprint failed to parse: ${e.message}`,
+            fix: 'Check .helix syntax — ensure all strands use format: strand Name { field: Type }'
+        });
+        result.passed = false;
+        result.score = 0;
+        return result;
+    }
+    // 2. Check for empty strands
+    if (ast.strands.length === 0) {
+        result.errors.push({
+            severity: 'error',
+            code: 'NO_STRANDS',
+            message: 'Blueprint contains no strands (data models)',
+            fix: 'Add at least one strand: strand User { name: String, email: String }'
+        });
+        result.passed = false;
+        result.score = 0;
+        return result;
+    }
+    const strandNames = ast.strands.map(s => s.name);
+    // 3. Check each strand
+    for (const strand of ast.strands) {
+        // Empty fields
+        if (!strand.fields || strand.fields.length === 0) {
+            result.errors.push({
+                severity: 'error',
+                code: 'EMPTY_STRAND',
+                message: `Strand "${strand.name}" has no fields`,
+                fix: `Add fields: strand ${strand.name} { name: String }`
+            });
+            result.score -= 20;
+        }
+        // Field type validation
+        if (strand.fields) {
+            for (const field of strand.fields) {
+                if (!VALID_FIELD_TYPES.includes(field.type) && !strandNames.includes(field.type)) {
+                    result.warnings.push({
+                        severity: 'warning',
+                        code: 'UNKNOWN_TYPE',
+                        message: `Field "${field.name}" in strand "${strand.name}" has unknown type "${field.type}"`,
+                        fix: `Valid types: ${VALID_FIELD_TYPES.join(', ')} or another strand name`
+                    });
+                    result.score -= 5;
+                }
+            }
+            // Duplicate fields
+            const fieldNames = strand.fields.map(f => f.name);
+            const duplicates = fieldNames.filter((name, i) => fieldNames.indexOf(name) !== i);
+            if (duplicates.length > 0) {
+                result.errors.push({
+                    severity: 'error',
+                    code: 'DUPLICATE_FIELD',
+                    message: `Strand "${strand.name}" has duplicate fields: ${[...new Set(duplicates)].join(', ')}`,
+                    fix: 'Remove or rename duplicate fields'
+                });
+                result.score -= 15;
+            }
+        }
+        // Naming convention
+        if (strand.name[0] !== strand.name[0].toUpperCase()) {
+            result.warnings.push({
+                severity: 'warning',
+                code: 'NAMING_CONVENTION',
+                message: `Strand "${strand.name}" should start with uppercase (PascalCase)`,
+                fix: `Rename to "${strand.name[0].toUpperCase() + strand.name.slice(1)}"`
+            });
+            result.score -= 3;
+        }
+        // Orphaned relations
+        if (strand.relations) {
+            for (const rel of strand.relations) {
+                const target = rel.target || rel.name;
+                if (!strandNames.includes(target)) {
+                    result.errors.push({
+                        severity: 'error',
+                        code: 'ORPHAN_RELATION',
+                        message: `Strand "${strand.name}" has relation to non-existent strand "${target}"`,
+                        fix: `Create the "${target}" strand or remove the relation`
+                    });
+                    result.score -= 15;
+                }
+            }
+        }
+    }
+    // 4. Duplicate strand names
+    const dupStrands = strandNames.filter((name, i) => strandNames.indexOf(name) !== i);
+    if (dupStrands.length > 0) {
+        result.errors.push({
+            severity: 'error',
+            code: 'DUPLICATE_STRAND',
+            message: `Duplicate strand names: ${[...new Set(dupStrands)].join(', ')}`,
+            fix: 'Each strand must have a unique name'
+        });
+        result.score -= 20;
+    }
+    // 5. Stats
+    const totalFields = ast.strands.reduce((sum, s) => sum + (s.fields?.length || 0), 0);
+    const totalRelations = ast.strands.reduce((sum, s) => sum + (s.relations?.length || 0), 0);
+    result.info.push({
+        severity: 'info',
+        code: 'BLUEPRINT_STATS',
+        message: `${ast.strands.length} strand(s), ${totalFields} field(s), ${totalRelations} relation(s)`
+    });
+    // Complexity warnings
+    if (ast.strands.length > 10) {
+        result.warnings.push({
+            severity: 'warning',
+            code: 'HIGH_COMPLEXITY',
+            message: `${ast.strands.length} strands is complex. Consider splitting into modules.`
+        });
+        result.score -= 5;
+    }
+    result.score = Math.max(0, Math.min(100, result.score));
+    result.passed = result.errors.length === 0;
+    return result;
+}
+function formatPreflightResult(result) {
+    const lines = [];
+    if (result.passed) {
+        lines.push(`  ✅ Pre-flight PASSED (confidence: ${result.score}%)`);
+    }
+    else {
+        lines.push(`  ❌ Pre-flight FAILED (confidence: ${result.score}%)`);
+    }
+    lines.push('');
+    if (result.errors.length > 0) {
+        lines.push('  🔴 Errors:');
+        for (const e of result.errors) {
+            lines.push(`    [${e.code}] ${e.message}`);
+            if (e.fix)
+                lines.push(`      💡 Fix: ${e.fix}`);
+        }
+        lines.push('');
+    }
+    if (result.warnings.length > 0) {
+        lines.push('  🟡 Warnings:');
+        for (const w of result.warnings) {
+            lines.push(`    [${w.code}] ${w.message}`);
+            if (w.fix)
+                lines.push(`      💡 Fix: ${w.fix}`);
+        }
+        lines.push('');
+    }
+    if (result.info.length > 0) {
+        lines.push('  ℹ️  Info:');
+        for (const i of result.info) {
+            lines.push(`    ${i.message}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=preflight.js.map

package/dist/commands/preflight.js.map

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

package/dist/commands/preview.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Helix Command: preview
+ * Interactive hot-reload preview with file watching
+ */
+/**
+ * Main preview function
+ */
+export declare function preview(): Promise<void>;
+/**
+ * Quick preview - just launch the server without watching
+ */
+export declare function quickPreview(): Promise<void>;
+//# sourceMappingURL=preview.d.ts.map

package/dist/commands/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/commands/preview.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgIH;;GAEG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA4F7C;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBlD"}

package/dist/commands/preview.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * Helix Command: preview
+ * Interactive hot-reload preview with file watching
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preview = preview;
+exports.quickPreview = quickPreview;
+const chalk_1 = __importDefault(require("chalk"));
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const execa = require("execa");
+const ora_1 = __importDefault(require("ora"));
+// We'll use a simple polling mechanism for file watching
+// to avoid adding chokidar as a dependency initially
+/**
+ * Detect project type from the current directory
+ */
+function detectProjectType() {
+    const cwd = process.cwd();
+    if (fs.existsSync(path.join(cwd, "pubspec.yaml"))) {
+        return "flutter";
+    }
+    if (fs.existsSync(path.join(cwd, "next.config.js")) ||
+        fs.existsSync(path.join(cwd, "next.config.mjs")) ||
+        fs.existsSync(path.join(cwd, "package.json"))) {
+        const pkgPath = path.join(cwd, "package.json");
+        if (fs.existsSync(pkgPath)) {
+            try {
+                const pkg = fs.readJSONSync(pkgPath);
+                if (pkg.dependencies?.next || pkg.devDependencies?.next) {
+                    return "nextjs";
+                }
+            }
+            catch { }
+        }
+    }
+    return "unknown";
+}
+/**
+ * Get preview configuration for a project type
+ */
+function getPreviewConfig(projectType) {
+    if (projectType === "flutter") {
+        return {
+            projectType: "flutter",
+            command: "flutter",
+            args: ["run", "-d", "chrome", "--web-port", "3000"],
+            watchPatterns: ["lib/**/*.dart", "*.helix"],
+            port: 3000,
+        };
+    }
+    return {
+        projectType: "nextjs",
+        command: "npm",
+        args: ["run", "dev"],
+        watchPatterns: ["src/**/*", "app/**/*", "pages/**/*", "*.helix"],
+        port: 3000,
+    };
+}
+/**
+ * Find .helix files in the current directory
+ */
+async function findHelixFiles() {
+    const cwd = process.cwd();
+    const files = [];
+    try {
+        const entries = await fs.readdir(cwd);
+        for (const entry of entries) {
+            if (entry.endsWith(".helix")) {
+                files.push(entry);
+            }
+        }
+    }
+    catch { }
+    return files;
+}
+/**
+ * Watch a file for changes using polling
+ */
+class FileWatcher {
+    lastMtime = new Map();
+    interval = null;
+    callback;
+    constructor(callback) {
+        this.callback = callback;
+    }
+    watch(files, intervalMs = 1000) {
+        // Initialize mtimes
+        for (const file of files) {
+            try {
+                const stat = fs.statSync(file);
+                this.lastMtime.set(file, stat.mtimeMs);
+            }
+            catch {
+                this.lastMtime.set(file, 0);
+            }
+        }
+        // Start polling
+        this.interval = setInterval(() => {
+            for (const file of files) {
+                try {
+                    const stat = fs.statSync(file);
+                    const lastMtime = this.lastMtime.get(file) || 0;
+                    if (stat.mtimeMs > lastMtime) {
+                        this.lastMtime.set(file, stat.mtimeMs);
+                        this.callback(file);
+                    }
+                }
+                catch { }
+            }
+        }, intervalMs);
+    }
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+    }
+}
+/**
+ * Main preview function
+ */
+async function preview() {
+    console.log(chalk_1.default.cyan("\n👁️  HELIX PREVIEW - Interactive Development\n"));
+    // Detect project type
+    const projectType = detectProjectType();
+    if (projectType === "unknown") {
+        console.error(chalk_1.default.red("❌ Could not detect project type"));
+        console.log(chalk_1.default.gray("Make sure you're in a Flutter or Next.js project directory"));
+        process.exit(1);
+    }
+    const config = getPreviewConfig(projectType);
+    console.log(chalk_1.default.white(`📦 Project Type: ${projectType}`));
+    console.log(chalk_1.default.white(`🌐 Server: http://localhost:${config.port}\n`));
+    // Find .helix files to watch
+    const helixFiles = await findHelixFiles();
+    if (helixFiles.length > 0) {
+        console.log(chalk_1.default.yellow(`📝 Watching ${helixFiles.length} .helix file(s) for changes:`));
+        for (const file of helixFiles) {
+            console.log(chalk_1.default.gray(`   • ${file}`));
+        }
+        console.log("");
+    }
+    // Start file watcher for .helix files
+    const watcher = new FileWatcher(async (file) => {
+        console.log(chalk_1.default.yellow(`\n🔄 Change detected in ${file}`));
+        console.log(chalk_1.default.gray("   Regenerating code..."));
+        // Trigger regeneration
+        try {
+            // Import and run generate command
+            const { generateStack } = await Promise.resolve().then(() => __importStar(require("./generate")));
+            await generateStack(file);
+            console.log(chalk_1.default.green("   ✅ Regeneration complete!\n"));
+        }
+        catch (error) {
+            console.log(chalk_1.default.red(`   ❌ Regeneration failed: ${error.message}\n`));
+        }
+    });
+    if (helixFiles.length > 0) {
+        watcher.watch(helixFiles, 1500);
+    }
+    // Start the development server
+    const spinner = (0, ora_1.default)(`Starting ${projectType} development server...`).start();
+    try {
+        spinner.succeed(`${projectType} server starting...`);
+        console.log(chalk_1.default.gray("─".repeat(50)));
+        console.log(chalk_1.default.cyan(`\n🚀 Preview available at http://localhost:${config.port}\n`));
+        console.log(chalk_1.default.gray("Press Ctrl+C to stop\n"));
+        console.log(chalk_1.default.gray("─".repeat(50)));
+        // Open browser after a delay
+        setTimeout(async () => {
+            try {
+                const url = `http://localhost:${config.port}`;
+                const platform = process.platform;
+                if (platform === "win32") {
+                    await execa("cmd", ["/c", "start", url], { stdio: "ignore" });
+                }
+                else if (platform === "darwin") {
+                    await execa("open", [url], { stdio: "ignore" });
+                }
+                else {
+                    await execa("xdg-open", [url], { stdio: "ignore" });
+                }
+            }
+            catch {
+                // Ignore browser open errors
+            }
+        }, 3000);
+        // Run the development server
+        await execa(config.command, config.args, {
+            stdio: "inherit",
+            cwd: process.cwd(),
+        });
+    }
+    catch (error) {
+        spinner.fail(`Server failed: ${error.message}`);
+        watcher.stop();
+        process.exit(1);
+    }
+    // Cleanup on exit
+    process.on("SIGINT", () => {
+        watcher.stop();
+        console.log(chalk_1.default.yellow("\n\n👋 Preview stopped\n"));
+        process.exit(0);
+    });
+}
+/**
+ * Quick preview - just launch the server without watching
+ */
+async function quickPreview() {
+    const projectType = detectProjectType();
+    if (projectType === "unknown") {
+        console.error(chalk_1.default.red("❌ Could not detect project type"));
+        process.exit(1);
+    }
+    const config = getPreviewConfig(projectType);
+    console.log(chalk_1.default.cyan(`\n🚀 Launching ${projectType} preview...\n`));
+    await execa(config.command, config.args, {
+        stdio: "inherit",
+        cwd: process.cwd(),
+    });
+}
+//# sourceMappingURL=preview.js.map

package/dist/commands/preview.js.map

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

package/dist/commands/run.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Helix Command: run
+ * Wraps npm run dev and opens the browser automatically
+ */
+export declare function runDevServer(): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAiDlD"}

package/dist/commands/run.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Helix Command: run
+ * Wraps npm run dev and opens the browser automatically
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDevServer = runDevServer;
+const chalk_1 = __importDefault(require("chalk"));
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const execa = require("execa");
+async function runDevServer() {
+    const configPath = path.join(process.cwd(), "helix.config.json");
+    // Check if we're in a Helix project
+    if (!fs.existsSync(configPath)) {
+        console.error(chalk_1.default.red("❌ Not a Helix project. Run 'helix new <name>' first."));
+        process.exit(1);
+    }
+    console.log(chalk_1.default.cyan("\n🚀 Starting Helix Dev Server...\n"));
+    // Check for package.json
+    const packagePath = path.join(process.cwd(), "package.json");
+    if (!fs.existsSync(packagePath)) {
+        console.error(chalk_1.default.red("❌ No package.json found"));
+        process.exit(1);
+    }
+    // Open browser after a delay
+    setTimeout(async () => {
+        try {
+            const url = "http://localhost:3000";
+            console.log(chalk_1.default.green(`\n🌐 Opening ${url}\n`));
+            // Cross-platform browser open
+            const platform = process.platform;
+            if (platform === "win32") {
+                await execa("cmd", ["/c", "start", url], { stdio: "ignore" });
+            }
+            else if (platform === "darwin") {
+                await execa("open", [url], { stdio: "ignore" });
+            }
+            else {
+                await execa("xdg-open", [url], { stdio: "ignore" });
+            }
+        }
+        catch {
+            console.log(chalk_1.default.yellow("⚠️ Could not open browser automatically"));
+            console.log(chalk_1.default.gray("  Open http://localhost:3000 manually"));
+        }
+    }, 3000);
+    // Run the dev server
+    try {
+        await execa("npm", ["run", "dev"], {
+            cwd: process.cwd(),
+            stdio: "inherit", // Stream output to terminal
+        });
+    }
+    catch (error) {
+        // User likely pressed Ctrl+C
+        console.log(chalk_1.default.gray("\n👋 Server stopped\n"));
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQH,oCAiDC;AAvDD,kDAA0B;AAC1B,6CAA+B;AAC/B,2CAA6B;AAC7B,+BAAgC;AAGzB,KAAK,UAAU,YAAY;IAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,mBAAmB,CAAC,CAAC;IAEjE,oCAAoC;IACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC,CAAC;IAE/D,yBAAyB;IACzB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IAC7D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,6BAA6B;IAC7B,UAAU,CAAC,KAAK,IAAI,EAAE;QAClB,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,uBAAuB,CAAC;YACpC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAC;YAElD,8BAA8B;YAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;YAClC,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACvB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAClE,CAAC;iBAAM,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC/B,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACJ,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACxD,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,yCAAyC,CAAC,CAAC,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC,CAAC;QACrE,CAAC;IACL,CAAC,EAAE,IAAI,CAAC,CAAC;IAET,qBAAqB;IACrB,IAAI,CAAC;QACD,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE;YAC/B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,KAAK,EAAE,SAAS,EAAE,4BAA4B;SACjD,CAAC,CAAC;IACP,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,6BAA6B;QAC7B,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC;IACrD,CAAC;AACL,CAAC"}

package/dist/commands/spawn.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Helix Command: spawn
+ * ONE-SHOT GENERATION - Full-stack app from natural language with ZERO intervention
+ * v11.0 - Clean Factory: All builds isolated to builds/{app_name}/
+ */
+import { type SpawnOptions } from "../utils/constitutional-validator";
+/**
+ * Spawn a complete full-stack application from a natural language prompt
+ */
+export declare function spawnApp(prompt: string, options?: SpawnOptions, constitution?: string, connectionString?: string): Promise<void>;
+//# sourceMappingURL=spawn.d.ts.map

package/dist/commands/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../src/commands/spawn.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,mCAAmC,CAAC;AAgB3C;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,YAAiB,EAC1B,YAAY,CAAC,EAAE,MAAM,EACrB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,CAklBf"}