scaffoldrite 2.0.7 → 2.1.0

package/dist/cli.js

@@ -17,7 +17,10 @@ function warnLegacyConfig() {
     const legacyStructure = path_1.default.join(cwd, "structure.sr");
     const legacyIgnore = path_1.default.join(cwd, ".scaffoldignore");
     const newConfigDir = path_1.default.join(cwd, ".scaffoldrite");
-    const hasLegacy = fs_1.default.existsSync(legacyStructure) || fs_1.default.existsSync(legacyIgnore);
+    const scaffoldriteProjectConfig = path_1.default.join(newConfigDir, "scaffoldrite-project.json");
+    const scaffoldriteGlobalConfig = path_1.default.join(newConfigDir, "scaffoldrite.json");
+    const hasLegacy = fs_1.default.existsSync(legacyStructure) || fs_1.default.existsSync(legacyIgnore)
+        || fs_1.default.existsSync(scaffoldriteProjectConfig) || fs_1.default.existsSync(scaffoldriteGlobalConfig);
     const hasNewConfig = fs_1.default.existsSync(newConfigDir);
     if (hasLegacy && hasNewConfig && !(0, utils_2.hasFlag)('--migrate')) {
         console.log(data_1.theme.warning(`${data_1.icons.warning} Detected legacy Scaffoldrite config in project root.\n` +

package/dist/library/commandHandler.js

@@ -28,7 +28,6 @@ const index_7 = require("../utils/index");
 const index_8 = require("../utils/index");
 const index_9 = require("../utils/index");
 const index_10 = require("../utils/index");
-const checkpackage_1 = require("./checkpage/checkpackage");
 const args = process.argv.slice(3).filter((a) => !a.startsWith("--"));
 const arg3 = args[0];
 const arg4 = args[1];
@@ -131,7 +130,6 @@ exports.commandHandlers = {
     //   return;
     // }
     // },
-    "check-packages": checkpackage_1.checkAndReportPackages,
     init: async () => {
         const shouldOverwrite = force;
         const sDir = path_1.default.join(index_7.baseDir, ".scaffoldrite");
@@ -139,27 +137,26 @@ exports.commandHandlers = {
         if (!fs_1.default.existsSync(sDir)) {
             fs_1.default.mkdirSync(sDir, { recursive: true });
         }
+        const projectConfig = path_1.default.join(sDir, "project.json");
         const legacyStructure = path_1.default.join(index_7.baseDir, "structure.sr");
         const legacyIgnore = path_1.default.join(index_7.baseDir, ".scaffoldignore");
         const structureExists = fs_1.default.existsSync(index_6.STRUCTURE_PATH);
         const ignoreExists = fs_1.default.existsSync(index_6.IGNORE_PATH);
-        /* ===============================
-         * OVERWRITE GUARDS
-         * =============================== */
+        const projectExists = fs_1.default.existsSync(projectConfig);
         const existingConfigs = [];
         if (structureExists)
             existingConfigs.push("structure.sr");
         if (ignoreExists)
             existingConfigs.push(".scaffoldignore");
+        if (projectExists)
+            existingConfigs.push("project.json");
         if (!shouldOverwrite && existingConfigs.length > 0) {
             console.error(index_4.theme.error.bold(`${index_4.icons.error} The following files already exist:\n`) +
                 existingConfigs.map(f => index_4.theme.muted(`  - ${f}`)).join("\n") +
                 index_4.theme.warning(`\n\nUse --force to overwrite everything.`));
             (0, index_8.exit)(1);
         }
-        /* ===============================
-         * HANDLE MIGRATION
-         * =============================== */
+        /* =============================== HANDLE MIGRATION =============================== */
         if (migrate) {
             let migrated = false;
             if (fs_1.default.existsSync(legacyStructure)) {
@@ -172,58 +169,62 @@ exports.commandHandlers = {
                 console.log(index_4.theme.success(`${index_4.icons.check} Moved .scaffoldignore → .scaffoldrite/.scaffoldignore`));
                 migrated = true;
             }
-            if (!migrated) {
+            if (!migrated)
                 console.log(index_4.theme.info(`${index_4.icons.info} No legacy config found to migrate.`));
-            }
             return;
         }
-        /* ===============================
-         * EMPTY INIT
-         * =============================== */
+        /* =============================== EMPTY INIT =============================== */
         if (empty) {
-            const root = {
-                type: "folder",
-                name: ".",
-                children: [],
-            };
+            const root = { type: "folder", name: ".", children: [] };
             (0, index_3.saveStructure)(root, parsed.rawConstraints, index_6.STRUCTURE_PATH);
             if (shouldOverwrite || !fs_1.default.existsSync(index_6.IGNORE_PATH)) {
-                if (shouldOverwrite && (fs_1.default.existsSync(index_6.IGNORE_PATH) || fs_1.default.existsSync(index_6.STRUCTURE_PATH))) {
-                    console.warn(index_4.theme.warning(`${index_4.icons.warning} Overwriting existing due to --force`));
-                }
                 fs_1.default.writeFileSync(index_6.IGNORE_PATH, index_1.DEFAULT_IGNORE_TEMPLATE);
             }
             console.log(index_4.theme.success(`${index_4.icons.success} Empty structure.sr created`));
-            return;
         }
-        /* ===============================
-         * INIT FROM FILESYSTEM
-         * =============================== */
-        if (fromFs) {
+        else if (fromFs) {
+            /* =============================== INIT FROM FILESYSTEM =============================== */
             const targetDir = path_1.default.resolve(arg3 ?? index_7.baseDir);
             const ignoreList = (0, index_2.getIgnoreList)();
             const ast = (0, fsToAst_1.buildASTFromFS)(targetDir, ignoreList);
             (0, index_3.saveStructure)(ast, parsed.rawConstraints, index_6.STRUCTURE_PATH);
             if (shouldOverwrite || !fs_1.default.existsSync(index_6.IGNORE_PATH)) {
-                if (shouldOverwrite && (fs_1.default.existsSync(index_6.IGNORE_PATH) || fs_1.default.existsSync(index_6.STRUCTURE_PATH))) {
-                    console.warn(index_4.theme.warning(`${index_4.icons.warning} Overwriting existing due to --force`));
-                }
                 fs_1.default.writeFileSync(index_6.IGNORE_PATH, index_1.DEFAULT_IGNORE_TEMPLATE);
             }
             console.log(index_4.theme.success(`${index_4.icons.success} structure.sr generated from filesystem: `) + index_4.theme.light(targetDir));
-            return;
         }
-        /* ===============================
-         * DEFAULT INIT (TEMPLATE)
-         * =============================== */
-        (0, index_3.saveStructure)(parsed.root, parsed.rawConstraints, index_6.STRUCTURE_PATH);
-        if (shouldOverwrite || !fs_1.default.existsSync(index_6.IGNORE_PATH)) {
-            if (shouldOverwrite && (fs_1.default.existsSync(index_6.IGNORE_PATH) || fs_1.default.existsSync(index_6.STRUCTURE_PATH))) {
-                console.warn(index_4.theme.warning(`${index_4.icons.warning} Overwriting existing due to --force`));
+        else {
+            /* =============================== DEFAULT INIT (TEMPLATE) =============================== */
+            (0, index_3.saveStructure)(parsed.root, parsed.rawConstraints, index_6.STRUCTURE_PATH);
+            if (shouldOverwrite || !fs_1.default.existsSync(index_6.IGNORE_PATH)) {
+                fs_1.default.writeFileSync(index_6.IGNORE_PATH, index_1.DEFAULT_IGNORE_TEMPLATE);
             }
-            fs_1.default.writeFileSync(index_6.IGNORE_PATH, index_1.DEFAULT_IGNORE_TEMPLATE);
+            console.log(index_4.theme.success(`${index_4.icons.success} structure.sr created`));
+        }
+        /* =============================== CREATE GLOBAL JSON =============================== */
+        if (shouldOverwrite || !fs_1.default.existsSync(projectConfig)) {
+            fs_1.default.writeFileSync(projectConfig, JSON.stringify({
+                framework: "",
+                language: "",
+                version: "1.0.0",
+                author: "",
+                conventions: {
+                    description: "",
+                    folderStructure: [],
+                    namingRules: [],
+                    folderDepthLimits: [],
+                    userNotes: []
+                },
+                additionalInfo: {
+                    stateManagement: "",
+                    styling: "",
+                    testing: "",
+                    routing: "",
+                    apiClient: ""
+                },
+            }, null, 2));
+            console.log(index_4.theme.info(`${index_4.icons.info} Created project config: project.json`));
         }
-        console.log(index_4.theme.success(`${index_4.icons.success} structure.sr created`));
         return;
     },
     update: async () => {
@@ -379,6 +380,56 @@ exports.commandHandlers = {
         }
         return;
     },
+    find: async () => {
+        const searchQuery = arg3;
+        if (!searchQuery) {
+            console.error(index_4.theme.error.bold(`${index_4.icons.error} Please provide a file, folder, or path to find.`));
+            (0, index_3.printUsage)("find");
+            (0, index_8.exit)(1);
+        }
+        const results = [];
+        const ignoreList = (0, index_2.getIgnoreList)();
+        const searchStructure = isStructure || (!isStructure && !isFS); // default searches both
+        const searchFilesystem = isFS || (!isStructure && !isFS);
+        // 1️⃣ Search in structure.sr
+        if (searchStructure && fs_1.default.existsSync(index_6.STRUCTURE_PATH)) {
+            const structure = (0, index_3.loadAST)();
+            function searchAST(node, currentPath = "") {
+                for (const child of node.children) {
+                    const childPath = path_1.default.posix.join(currentPath, child.name);
+                    if (child.name.includes(searchQuery) || childPath.includes(searchQuery)) {
+                        results.push(`${index_4.icons.file} [structure] ${childPath}`);
+                    }
+                    if (child.type === "folder") {
+                        searchAST(child, childPath);
+                    }
+                }
+            }
+            searchAST(structure.root);
+        }
+        // 2️⃣ Search in filesystem
+        if (searchFilesystem) {
+            const fsAst = (0, fsToAst_1.buildASTFromFS)(index_7.baseDir, ignoreList);
+            function searchFSAST(node, currentPath = "") {
+                for (const child of node.children) {
+                    const childPath = path_1.default.posix.join(currentPath, child.name);
+                    if (child.name.includes(searchQuery) || childPath.includes(searchQuery)) {
+                        results.push(`${index_4.icons.folder} [fs] ${childPath}`);
+                    }
+                    if (child.type === "folder") {
+                        searchFSAST(child, childPath);
+                    }
+                }
+            }
+            searchFSAST(fsAst);
+        }
+        if (results.length === 0) {
+            console.log(index_4.theme.warning(`${index_4.icons.warning} Could not find '${searchQuery}' in the selected scope.`));
+            return;
+        }
+        console.log(index_4.theme.primary.bold(`\nFound ${results.length} match(es) for '${searchQuery}':`));
+        results.forEach(r => console.log(index_4.theme.light(`  ${r}`)));
+    },
     generate: async () => {
         const structure = (0, index_3.loadAST)();
         (0, validator_1.validateConstraints)(structure.root, structure.constraints);

package/dist/library/fsToAst.js

@@ -9,8 +9,8 @@ const path_1 = __importDefault(require("path"));
 const data_1 = require("../data");
 function buildASTFromFS(dir, ignoreList = []) {
     if (!fs_1.default.existsSync(dir)) {
-        throw new Error(`${data_1.icons.error} ${data_1.theme.error('Directory not found:')} ${data_1.theme.highlight(dir)}\n` +
-            `${data_1.theme.info('Tip:')} Make sure the directory exists or create it with ${data_1.theme.primary(`mkdir -p "${dir}"`)}`);
+        throw new Error(`${data_1.icons.error} ${data_1.theme.error("Directory not found:")} ${data_1.theme.highlight(dir)}\n` +
+            `${data_1.theme.info("Tip:")} Make sure the directory exists or create it with ${data_1.theme.primary(`mkdir -p "${dir}"`)}`);
     }
     const root = {
         type: "folder",
@@ -23,26 +23,46 @@ function buildASTFromFS(dir, ignoreList = []) {
     };
     function scan(folderPath, node) {
         const items = fs_1.default.readdirSync(folderPath);
-        for (const item of items) {
-            if (ignoreList.includes(item))
-                continue;
+        // 🔥 SORTING LOGIC (folders first, then alphabetical)
+        const sortedItems = items
+            .map((item) => {
             const itemPath = path_1.default.join(folderPath, item);
-            if (isScaffoldriteInternal(itemPath))
-                continue;
             const stat = fs_1.default.statSync(itemPath);
-            if (stat.isDirectory()) {
+            return {
+                name: item,
+                path: itemPath,
+                isDirectory: stat.isDirectory(),
+            };
+        })
+            .sort((a, b) => {
+            // 1️⃣ Folders first
+            if (a.isDirectory && !b.isDirectory)
+                return -1;
+            if (!a.isDirectory && b.isDirectory)
+                return 1;
+            // 2️⃣ Alphabetical (case-insensitive)
+            return a.name.localeCompare(b.name, undefined, {
+                sensitivity: "base",
+            });
+        });
+        for (const item of sortedItems) {
+            if (ignoreList.includes(item.name))
+                continue;
+            if (isScaffoldriteInternal(item.path))
+                continue;
+            if (item.isDirectory) {
                 const childFolder = {
                     type: "folder",
-                    name: item,
+                    name: item.name,
                     children: [],
                 };
                 node.children.push(childFolder);
-                scan(itemPath, childFolder);
+                scan(item.path, childFolder);
             }
             else {
                 const childFile = {
                     type: "file",
-                    name: item,
+                    name: item.name,
                 };
                 node.children.push(childFile);
             }

package/dist/library/plot/ai.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env ts-node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ai = void 0;
+const child_process_1 = require("child_process");
+const data_1 = require("../../data");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+require("dotenv/config");
+const ai_workflow_1 = require("@scaffoldrite/ai-workflow");
+const readline_1 = __importDefault(require("readline"));
+// ─────────────────────────────────────────────
+// 1️⃣ LLM Adapter Setup
+// ─────────────────────────────────────────────
+const llmAdapter = (0, ai_workflow_1.createAdapter)("groq", {
+    apiKey: process.env.GROQ_API_KEY || "",
+    model: "llama-3.1-8b-instant",
+    maxTokens: 1200,
+    temperature: 0.2,
+});
+// ─────────────────────────────────────────────
+// 2️⃣ sanitize AI output
+// ─────────────────────────────────────────────
+function sanitizeStructureSR(input) {
+    return input
+        .split("\n")
+        .filter((line) => {
+        const t = line.trim();
+        return (t === "" ||
+            t === "{" ||
+            t === "}" ||
+            /^(folder|file|constraints)/.test(t));
+    })
+        .join("\n")
+        .trim();
+}
+// ─────────────────────────────────────────────
+// 3️⃣ create readline
+// ─────────────────────────────────────────────
+function createRL() {
+    return readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        terminal: true,
+    });
+}
+// ─────────────────────────────────────────────
+// 4️⃣ collect multi-line input
+// ─────────────────────────────────────────────
+async function collectInput(rl) {
+    console.log(`
+📝 Describe what you want.
+
+ENTER → new line  
+CTRL + D → submit  
+CTRL + C → exit
+`);
+    const lines = [];
+    return new Promise((resolve) => {
+        const onLine = (line) => {
+            lines.push(line);
+        };
+        rl.on("line", onLine);
+        // CTRL+D → readline closes → we capture and resolve
+        rl.once("close", () => {
+            rl.removeListener("line", onLine);
+            console.log("\n🚀 Submitting...\n");
+            resolve(lines.join(" "));
+        });
+    });
+}
+// ─────────────────────────────────────────────
+// 5️⃣ Main AI CLI
+// ─────────────────────────────────────────────
+const ai = async () => {
+    try {
+        const projectPath = path_1.default.resolve(process.cwd());
+        (0, child_process_1.execSync)("sr init --from-fs . --force", {
+            cwd: projectPath,
+            stdio: "inherit",
+            shell: process.platform === "win32" ? "cmd.exe" : "/bin/sh",
+        });
+        // exit nicely
+        process.on("SIGINT", () => {
+            console.log("\n👋 Exiting AI assistant...");
+            process.exit(0);
+        });
+        // 🔥 infinite assistant loop
+        while (true) {
+            const rl = createRL(); // recreate every round (EOF safe)
+            const description = await collectInput(rl);
+            if (!description.trim()) {
+                console.log("⚠️ Please enter a request.\n");
+                continue;
+            }
+            const structurePath = path_1.default.join(projectPath, ".scaffoldrite", "structure.sr");
+            const existingStructure = fs_1.default.readFileSync(structurePath, "utf-8");
+            const result = await (0, ai_workflow_1.runWorkflow)({
+                existingStructure,
+                userRequest: description,
+                llmAdapter,
+                onProgress: (step, message) => console.log(`Step ${step}: ${message}`),
+            });
+            // ─────────────────────────
+            // Handle results
+            // ─────────────────────────
+            if (result.type === "clarify") {
+                console.log("\n🤖 AI requires clarification:\n");
+                console.log(result.message);
+                console.log("Options:", result.options.join(", "));
+                continue;
+            }
+            if (result.type === "answer") {
+                console.log("\n🤖 AI Answer:\n");
+                console.log(result.message);
+                continue;
+            }
+            if (result.type === "improve") {
+                const suggestions = result.suggestions.map((s) => {
+                    if (typeof s === "string")
+                        return s;
+                    if (s.description && s.path)
+                        return `${s.description} (${s.path})`;
+                    if (s.description)
+                        return s.description;
+                    return JSON.stringify(s);
+                });
+                console.log("\n💡 AI Suggestions for improvement:");
+                suggestions.forEach((s, i) => console.log(`${i + 1}. ${s}`));
+                continue;
+            }
+            if (["create", "delete", "move", "rename"].includes(result.type)) {
+                const clean = sanitizeStructureSR(JSON.stringify(result, null, 2));
+                fs_1.default.writeFileSync(structurePath, clean);
+                (0, child_process_1.execSync)("sr merge --from-fs .", { cwd: projectPath, stdio: "inherit" });
+                (0, child_process_1.execSync)("sr generate .", { cwd: projectPath, stdio: "inherit" });
+                (0, child_process_1.execSync)("sr list --sr --with-icon", { cwd: projectPath, stdio: "inherit" });
+            }
+        }
+    }
+    catch (err) {
+        console.error(data_1.theme.error(`❌ Failed: ${err.message}`));
+    }
+};
+exports.ai = ai;

package/dist/library/plot/aiClient.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callAI = callAI;
+const axios_1 = __importDefault(require("axios"));
+const axios_retry_1 = __importDefault(require("axios-retry"));
+const client = axios_1.default.create({
+    baseURL: "https://api.groq.com/openai/v1",
+    timeout: 25000,
+    headers: {
+        Authorization: `Bearer ${process.env.GROQ_API_KEY}`,
+        "Content-Type": "application/json",
+    },
+});
+(0, axios_retry_1.default)(client, {
+    retries: 3,
+    retryDelay: axios_retry_1.default.exponentialDelay,
+    retryCondition: (error) => {
+        return (axios_retry_1.default.isNetworkOrIdempotentRequestError(error) ||
+            error.code === "ECONNRESET");
+    },
+});
+async function callAI(system, user, temperature) {
+    const res = await client.post("/chat/completions", {
+        model: "llama-3.1-8b-instant",
+        temperature,
+        max_tokens: 1200,
+        messages: [
+            { role: "system", content: system },
+            { role: "user", content: user },
+        ],
+    });
+    return res.data.choices[0].message.content.trim();
+}

package/dist/library/plot/generateStructure.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateStructureStream = generateStructureStream;
+const eventsource_1 = require("eventsource");
+function generateStructureStream({ existingStructure, description, framework, language, }) {
+    return new Promise((resolve, reject) => {
+        let finalResult = "";
+        const url = `http://localhost:3000/generate-structure-stream?existingStructure=${encodeURIComponent(existingStructure)}&description=${encodeURIComponent(description)}&framework=${encodeURIComponent(framework)}&language=${encodeURIComponent(language)}`;
+        const es = new eventsource_1.EventSource(url);
+        es.onmessage = (event) => {
+            const data = JSON.parse(event.data);
+            if (data.message) {
+                console.log(data.message);
+            }
+            if (data.done) {
+                finalResult = data.result;
+                es.close();
+                resolve(finalResult);
+            }
+            if (data.error) {
+                es.close();
+                reject(new Error(data.error));
+            }
+        };
+        es.onerror = (err) => {
+            es.close();
+            reject(err || new Error("Unknown SSE error"));
+        };
+    });
+}

package/dist/library/plot/lis.js

@@ -0,0 +1,158 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ai = void 0;
+const child_process_1 = require("child_process");
+const data_1 = require("../../data");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const generateStructure_1 = require("./generateStructure");
+const readline_1 = __importDefault(require("readline"));
+// ─────────────────────────────────────────────
+// HELPER: readline wrapper
+// ─────────────────────────────────────────────
+function createAsk() {
+    const rl = readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const ask = (q) => new Promise((res) => rl.question(q, res));
+    return { ask, close: () => rl.close(), rl };
+}
+// ─────────────────────────────────────────────
+// HELPER: sanitize AI output for ScaffoldRite
+// ─────────────────────────────────────────────
+function sanitizeStructureSR(input) {
+    return input
+        .split("\n")
+        .filter((line) => {
+        const t = line.trim();
+        return (t === "" ||
+            t === "{" ||
+            t === "}" ||
+            /^(folder|file|constraints)/.test(t));
+    })
+        .join("\n")
+        .trim();
+}
+// ─────────────────────────────────────────────
+// MAIN AI FUNCTION
+// ─────────────────────────────────────────────
+const ai = async () => {
+    try {
+        // ─────────────────────────────────────────────
+        // 1️⃣ INITIAL QUESTIONS
+        // ─────────────────────────────────────────────
+        let { ask, close, rl } = createAsk();
+        const projectName = await ask("Project name: ");
+        const framework = await ask("Framework (react, vue): ");
+        const language = await ask("Language (js, ts): ");
+        close(); // ❗ Close before running execSync
+        // ─────────────────────────────────────────────
+        // 2️⃣ CREATE VITE PROJECT
+        // ─────────────────────────────────────────────
+        let template = framework.toLowerCase();
+        if (framework === "react" && language === "ts")
+            template = "react-ts";
+        if (framework === "vue" && language === "ts")
+            template = "vue-ts";
+        (0, child_process_1.execSync)(`npx create-vite@latest "${projectName}" --template ${template} --no-rolldown --no-immediate`, {
+            stdio: "inherit",
+            shell: process.platform === "win32" ? "cmd.exe" : "/bin/sh",
+        });
+        const projectPath = path_1.default.resolve(process.cwd(), projectName);
+        // ─────────────────────────────────────────────
+        // 3️⃣ INIT SCAFFOLDRITE
+        // ─────────────────────────────────────────────
+        (0, child_process_1.execSync)("sr init --from-fs .", {
+            cwd: projectPath,
+            stdio: "inherit",
+            shell: process.platform === "win32" ? "cmd.exe" : "/bin/sh",
+        });
+        // ─────────────────────────────────────────────
+        // 4️⃣ ASK FOR AI ASSISTANCE
+        // ─────────────────────────────────────────────
+        ({ ask, close, rl } = createAsk());
+        const wantAI = await ask("\n🤖 Do you want AI assistance in scaffolding the structure of your app? (yes/no): ");
+        if (wantAI.toLowerCase() === "yes") {
+            while (true) {
+                console.log("\n📝 Paste your project description below. Press ENTER on an empty line when done:\n");
+                const descriptionLines = [];
+                // 🧠 FIX: controlled single listener, auto removed
+                await new Promise((res) => {
+                    const onLine = (line) => {
+                        if (line.trim() === "") {
+                            rl.removeListener("line", onLine);
+                            res();
+                        }
+                        else {
+                            descriptionLines.push(line);
+                        }
+                    };
+                    // extra safety
+                    rl.removeAllListeners("line");
+                    rl.on("line", onLine);
+                });
+                const description = descriptionLines.join(" ");
+                const structurePath = path_1.default.join(projectPath, ".scaffoldrite", "structure.sr");
+                const existingStructure = fs_1.default.readFileSync(structurePath, "utf-8");
+                // Stream AI output with progress
+                const result = await (0, generateStructure_1.generateStructureStream)({
+                    existingStructure,
+                    description,
+                    framework,
+                    language,
+                });
+                // 🧠 CLARIFICATION MODE
+                if (result.startsWith("CLARIFICATION_REQUIRED")) {
+                    console.log("\n🤖 I need clarification:\n");
+                    console.log(result);
+                    const confirm = await ask("\nIs this what you meant? (yes/no): ");
+                    if (confirm.toLowerCase() === "yes") {
+                        console.log("\n✏️ Please rephrase clearly what you want:\n");
+                        continue;
+                    }
+                    else {
+                        console.log("\n🔁 Okay, please describe what you want again.\n");
+                        continue;
+                    }
+                }
+                // ✅ STRUCTURE MODE
+                const clean = sanitizeStructureSR(result);
+                fs_1.default.writeFileSync(structurePath, clean);
+                // SAFETY STEP — NON-NEGOTIABLE
+                (0, child_process_1.execSync)("sr merge --from-fs .", {
+                    cwd: projectPath,
+                    stdio: "inherit",
+                });
+                (0, child_process_1.execSync)("sr generate .", {
+                    cwd: projectPath,
+                    stdio: "inherit",
+                });
+                (0, child_process_1.execSync)("sr list --sr --with-icon", {
+                    cwd: projectPath,
+                    stdio: "inherit",
+                });
+                close(); // 🔥 close the previous interface first
+                ({ ask, close, rl } = createAsk());
+                const satisfied = await ask("\n✅ Are you satisfied with the structure? (yes/no): ");
+                if (satisfied.toLowerCase() === "yes")
+                    break;
+            }
+        }
+        close();
+        // ─────────────────────────────────────────────
+        // 5️⃣ FINISH
+        // ─────────────────────────────────────────────
+        console.log(data_1.theme.success(`\n🎉 Project ${projectName} is ready!\n`));
+        console.log(data_1.theme.muted(`  cd ${projectName}`));
+        console.log(data_1.theme.muted("  npm install"));
+        console.log(data_1.theme.muted("  npm run dev"));
+    }
+    catch (err) {
+        console.error(data_1.theme.error(`❌ Failed: ${err.message}`));
+    }
+};
+exports.ai = ai;