tarsk 0.4.17 → 0.4.19

package/dist/index.js

@@ -638,6 +638,13 @@ async function runMigrations(db) {
       await db.execute(`ALTER TABLE projects ADD COLUMN testPrompt TEXT`);
       await db.execute(`ALTER TABLE projects ADD COLUMN reviewPrompt TEXT`);
     }
+    const hasValidationScript = projectsInfo.rows.some(
+      (col) => col.name === "validationScript"
+    );
+    if (!hasValidationScript) {
+      console.log("[db] Running migration: Adding validationScript column to projects");
+      await db.execute(`ALTER TABLE projects ADD COLUMN validationScript TEXT`);
+    }
     const projectScriptsExists = await db.execute(
       `SELECT name FROM sqlite_master WHERE type='table' AND name='project_scripts'`
     );
@@ -5701,7 +5708,7 @@ var devServerCache = new DevServerCache();
 // src/agent/agent.prompt-loader.ts
 function buildDefaultPrompt(tools) {
   const toolList = tools.map((t) => t.name).join(", ");
-  return `You are a helpful coding assistant. You have access to ${toolList} tools. Use them to explore and modify the codebase as needed. Skills are created and stored in .agents/skills/ . Use Mermaid for flowcharts, sequence diagrams, state diagrams, or graphs when appropriate`;
+  return `You are a helpful coding assistant. You have access to ${toolList} tools. Use them to explore and modify the codebase as needed. Skills are created and stored in .agents/skills/ . Use Mermaid for flowcharts, sequence diagrams, state diagrams, or graphs when appropriate. Do not use emojis.`;
 }
 var PLAN_MODE_INSTRUCTIONS = `
 
@@ -5722,6 +5729,7 @@ You are currently in PLAN MODE. You MUST follow these constraints strictly:
 - Do NOT create, delete, or modify any files
 - Do NOT run any commands that change system state (npm install, git commit, etc.)
 - You MAY use read-only tools (Read, Glob, Grep, Bash with read-only commands like ls, cat, git status, git log, git diff) to explore the codebase
+- Do NOT use emojis
 
 ## Output format:
 Structure your response as:
@@ -7361,7 +7369,225 @@ async function getAccountInfo(c) {
   }
 }
 
+// src/features/projects/projects.database.ts
+async function insertProject(db, project) {
+  try {
+    await db.execute(
+      `
+      INSERT INTO projects (id, name, gitUrl, path, createdAt, openWith, commands, setupScript, validationScript, runCommand, commitMethod, planPrompt, testPrompt, reviewPrompt)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `,
+      [
+        project.id,
+        project.name,
+        project.gitUrl,
+        project.path,
+        project.createdAt.toISOString(),
+        project.openWith ?? null,
+        project.commands ? JSON.stringify(project.commands) : null,
+        project.setupScript ?? null,
+        project.validationScript ?? null,
+        project.runCommand ?? null,
+        project.commitMethod ?? null,
+        project.planPrompt ?? null,
+        project.testPrompt ?? null,
+        project.reviewPrompt ?? null
+      ]
+    );
+  } catch (error) {
+    console.error("Failed to insert project:", error);
+    throw error;
+  }
+}
+async function updateProject(db, id, updates) {
+  try {
+    const fields = [];
+    const values = [];
+    if (updates.name !== void 0) {
+      fields.push("name = ?");
+      values.push(updates.name);
+    }
+    if (updates.gitUrl !== void 0) {
+      fields.push("gitUrl = ?");
+      values.push(updates.gitUrl);
+    }
+    if (updates.path !== void 0) {
+      fields.push("path = ?");
+      values.push(updates.path);
+    }
+    if (updates.openWith !== void 0) {
+      fields.push("openWith = ?");
+      values.push(updates.openWith ?? null);
+    }
+    if (updates.commands !== void 0) {
+      fields.push("commands = ?");
+      values.push(updates.commands ? JSON.stringify(updates.commands) : null);
+    }
+    if (updates.setupScript !== void 0) {
+      fields.push("setupScript = ?");
+      values.push(updates.setupScript ?? null);
+    }
+    if (updates.validationScript !== void 0) {
+      fields.push("validationScript = ?");
+      values.push(updates.validationScript ?? null);
+    }
+    if (updates.runCommand !== void 0) {
+      fields.push("runCommand = ?");
+      values.push(updates.runCommand ?? null);
+    }
+    if (updates.commitMethod !== void 0) {
+      fields.push("commitMethod = ?");
+      values.push(updates.commitMethod ?? null);
+    }
+    if (updates.planPrompt !== void 0) {
+      fields.push("planPrompt = ?");
+      values.push(updates.planPrompt ?? null);
+    }
+    if (updates.testPrompt !== void 0) {
+      fields.push("testPrompt = ?");
+      values.push(updates.testPrompt ?? null);
+    }
+    if (updates.reviewPrompt !== void 0) {
+      fields.push("reviewPrompt = ?");
+      values.push(updates.reviewPrompt ?? null);
+    }
+    if (fields.length === 0) {
+      return;
+    }
+    values.push(id);
+    const sql = `UPDATE projects SET ${fields.join(", ")} WHERE id = ?`;
+    await db.execute(sql, values);
+  } catch (error) {
+    console.error("Failed to update project:", error);
+    throw error;
+  }
+}
+async function deleteProject(db, id) {
+  try {
+    await db.execute("PRAGMA foreign_keys = OFF");
+    try {
+      await db.execute(
+        `
+        DELETE FROM conversation_history 
+        WHERE threadId IN (
+          SELECT threads.id FROM threads WHERE threads.projectId = ?
+        )
+      `,
+        [id]
+      );
+      await db.execute(
+        `
+        DELETE FROM todos 
+        WHERE threadId IN (
+          SELECT threads.id FROM threads WHERE threads.projectId = ?
+        )
+      `,
+        [id]
+      );
+      await db.execute("DELETE FROM threads WHERE projectId = ?", [id]);
+      await db.execute("DELETE FROM project_todos WHERE projectId = ?", [id]);
+      await db.execute("DELETE FROM projects WHERE id = ?", [id]);
+    } finally {
+      await db.execute("PRAGMA foreign_keys = ON");
+    }
+  } catch (error) {
+    console.error("Failed to delete project:", error);
+    throw error;
+  }
+}
+async function getProject(db, id) {
+  const result = await db.execute("SELECT * FROM projects WHERE id = ?", [id]);
+  const row = result.rows[0];
+  if (!row) {
+    return null;
+  }
+  return deserializeProject(db, row);
+}
+async function getAllProjects(db) {
+  try {
+    const result = await db.execute("SELECT * FROM projects ORDER BY createdAt DESC");
+    const rows = result.rows;
+    const threadResult = await db.execute(
+      "SELECT id, projectId FROM threads ORDER BY createdAt DESC"
+    );
+    const threadRows = threadResult.rows;
+    const threadIdsByProject = /* @__PURE__ */ new Map();
+    for (const row of threadRows) {
+      const ids = threadIdsByProject.get(row.projectId);
+      if (ids) {
+        ids.push(row.id);
+      } else {
+        threadIdsByProject.set(row.projectId, [row.id]);
+      }
+    }
+    return rows.map(
+      (row) => deserializeProjectWithThreads(row, threadIdsByProject.get(row.id) ?? [])
+    );
+  } catch (error) {
+    console.error("Failed to get all projects:", error);
+    throw error;
+  }
+}
+async function getProjectThreadIds(db, projectId) {
+  const result = await db.execute(
+    "SELECT id FROM threads WHERE projectId = ? ORDER BY createdAt DESC",
+    [projectId]
+  );
+  const rows = result.rows;
+  return rows.map((row) => row.id);
+}
+function deserializeProjectWithThreads(row, threadIds) {
+  return {
+    id: row.id,
+    name: row.name,
+    gitUrl: row.gitUrl,
+    path: row.path,
+    createdAt: new Date(row.createdAt),
+    threads: threadIds,
+    openWith: row.openWith ?? void 0,
+    commands: row.commands ? JSON.parse(row.commands) : void 0,
+    setupScript: row.setupScript ?? void 0,
+    validationScript: row.validationScript ?? void 0,
+    runCommand: row.runCommand ?? void 0,
+    commitMethod: row.commitMethod && isValidCommitMethod(row.commitMethod) ? row.commitMethod : void 0,
+    planPrompt: row.planPrompt ?? void 0,
+    testPrompt: row.testPrompt ?? void 0,
+    reviewPrompt: row.reviewPrompt ?? void 0
+  };
+}
+async function deserializeProject(db, row) {
+  return deserializeProjectWithThreads(row, await getProjectThreadIds(db, row.id));
+}
+
 // src/features/chat/chat-post.route.ts
+init_utils();
+function runValidationScript(script, cwd) {
+  return new Promise((resolve6) => {
+    const child = spawnShell(script, { cwd, stdio: ["pipe", "pipe", "pipe"] });
+    let output = "";
+    const stdoutDecoder = new TextDecoder();
+    const stderrDecoder = new TextDecoder();
+    child.stdout?.on("data", (data) => {
+      output += stdoutDecoder.decode(data, { stream: true });
+    });
+    child.stderr?.on("data", (data) => {
+      output += stderrDecoder.decode(data, { stream: true });
+    });
+    child.on("close", (code) => {
+      output += stdoutDecoder.decode();
+      output += stderrDecoder.decode();
+      resolve6({ exitCode: code ?? 1, output: output.trim() });
+    });
+    child.on("error", (err) => {
+      output += stdoutDecoder.decode();
+      output += stderrDecoder.decode();
+      resolve6({
+        exitCode: 1,
+        output: `${output}${output ? "\n" : ""}${err.message}`.trim()
+      });
+    });
+  });
+}
 async function postChatMessage(c, threadManager, agentExecutor, conversationManager, processingStateManager) {
   try {
     const body = await c.req.json();
@@ -7542,36 +7768,127 @@ async function postChatMessage(c, threadManager, agentExecutor, conversationMana
     }
     processingStateManager.setProcessing(threadId);
     processingStateManager.registerAbortController(threadId, abortController);
+    async function* executeAgent(prompt, ctx, signal, history2, captured) {
+      for await (const event of agentExecutor.execute(prompt, ctx, signal, history2)) {
+        captured.events.push(event);
+        if (event.type === "message" && event.content) {
+          captured.fullContent += event.content;
+        }
+        if (event.type === "message" && typeof event.content === "string" && (event.role === "tool" || isToolLikeContent(event.content))) {
+          const thinkingEvent = { type: "thinking", content: event.content };
+          processingStateManager.pushEvent(threadId, thinkingEvent);
+          yield thinkingEvent;
+          continue;
+        }
+        processingStateManager.pushEvent(threadId, event);
+        yield event;
+      }
+    }
     async function* chatExecutionGenerator() {
-      const capturedEvents = [];
-      let fullContent = "";
+      const captured = { events: [], fullContent: "" };
       try {
-        for await (const event of agentExecutor.execute(
+        yield* executeAgent(
           content,
           context,
           abortController.signal,
-          conversationHistory
-        )) {
-          capturedEvents.push(event);
-          if (event.type === "message" && event.content) {
-            fullContent += event.content;
-          }
-          if (event.type === "message" && typeof event.content === "string" && (event.role === "tool" || isToolLikeContent(event.content))) {
-            const thinkingEvent = { type: "thinking", content: event.content };
-            processingStateManager.pushEvent(threadId, thinkingEvent);
-            yield thinkingEvent;
-            continue;
-          }
-          processingStateManager.pushEvent(threadId, event);
-          yield event;
-        }
-        const finalContent = extractAssistantContent(capturedEvents, fullContent);
-        await conversationManager.completeMessage(messageId, finalContent, capturedEvents);
+          conversationHistory,
+          captured
+        );
+        const finalContent = extractAssistantContent(captured.events, captured.fullContent);
+        await conversationManager.completeMessage(messageId, finalContent, captured.events);
         console.log("[ChatRoute] Conversation captured:", {
           messageId,
-          eventCount: capturedEvents.length,
+          eventCount: captured.events.length,
           contentLength: finalContent.length
         });
+        const db = await getDatabase();
+        const project = await getProject(db, thread.projectId);
+        const validationScript = project?.validationScript;
+        if (validationScript) {
+          const MAX_VALIDATION_ATTEMPTS = 10;
+          let attempt = 0;
+          conversationHistory.push({ userMessage: content, assistantResponse: finalContent });
+          while (attempt < MAX_VALIDATION_ATTEMPTS) {
+            if (abortController.signal.aborted) break;
+            console.log(`[ChatRoute] Running validation script (attempt ${attempt + 1})`);
+            const runningEvent = {
+              type: "thinking",
+              content: `[Validating] Running validation script (attempt ${attempt + 1}):
+$ ${validationScript}`
+            };
+            processingStateManager.pushEvent(threadId, runningEvent);
+            yield runningEvent;
+            const result = await runValidationScript(validationScript, threadPath);
+            if (result.exitCode === 0) {
+              console.log("[ChatRoute] Validation script passed");
+              const passEvent = {
+                type: "thinking",
+                content: `[Validating] Validation passed (exit code 0)${result.output ? `
+${result.output}` : ""}`
+              };
+              processingStateManager.pushEvent(threadId, passEvent);
+              yield passEvent;
+              break;
+            }
+            console.log(`[ChatRoute] Validation script failed (exit code ${result.exitCode})`);
+            const failEvent = {
+              type: "thinking",
+              content: `[Validating] Validation failed (exit code ${result.exitCode})
+${result.output}`
+            };
+            processingStateManager.pushEvent(threadId, failEvent);
+            yield failEvent;
+            attempt++;
+            const validationPrompt = `The validation script failed with exit code ${result.exitCode}. Please fix the issues and try again.
+
+Validation script: ${validationScript}
+
+Output:
+${result.output}`;
+            const updatedHistory = [...conversationHistory];
+            const validationMessageId = await conversationManager.startMessage(
+              threadId,
+              threadPath,
+              conversationId,
+              validationPrompt,
+              model,
+              void 0,
+              planMode
+            );
+            const validationCaptured = { events: [], fullContent: "" };
+            yield* executeAgent(
+              validationPrompt,
+              context,
+              abortController.signal,
+              updatedHistory,
+              validationCaptured
+            );
+            const validationContent = extractAssistantContent(
+              validationCaptured.events,
+              validationCaptured.fullContent
+            );
+            await conversationManager.completeMessage(
+              validationMessageId,
+              validationContent,
+              validationCaptured.events
+            );
+            conversationHistory.push({
+              userMessage: validationPrompt,
+              assistantResponse: validationContent
+            });
+            decrementBalance().catch((err) => {
+              console.error("[ChatRoute] Failed to decrement balance:", err);
+            });
+          }
+          if (attempt >= MAX_VALIDATION_ATTEMPTS) {
+            const maxAttemptsEvent = {
+              type: "thinking",
+              content: `[Validating] Validation script still failing after ${MAX_VALIDATION_ATTEMPTS} attempts. Stopping.`
+            };
+            processingStateManager.pushEvent(threadId, maxAttemptsEvent);
+            yield maxAttemptsEvent;
+          }
+        }
       } catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         const errorEvent = {
@@ -7583,17 +7900,17 @@ async function postChatMessage(c, threadManager, agentExecutor, conversationMana
             details: error instanceof Error ? { stack: error.stack } : void 0
           }
         };
-        capturedEvents.push(errorEvent);
+        captured.events.push(errorEvent);
         yield errorEvent;
         try {
-          const finalContent = extractAssistantContent(capturedEvents, fullContent);
-          await conversationManager.completeMessage(messageId, finalContent, capturedEvents);
+          const finalContent = extractAssistantContent(captured.events, captured.fullContent);
+          await conversationManager.completeMessage(messageId, finalContent, captured.events);
         } catch (saveError) {
           console.error("[ChatRoute] Failed to save partial conversation:", saveError);
         }
       } finally {
         processingStateManager.clearProcessing(threadId);
-        const noResponse = capturedEvents.some(
+        const noResponse = captured.events.some(
           (e) => e.type === "error" && e.error?.code === "NO_CONTENT_NO_TOOLS"
         );
         if (!noResponse) {
@@ -8862,171 +9179,6 @@ function createConversationRoutes(conversationManager, threadManager) {
 // src/features/metadata/metadata.manager.ts
 init_database();
 
-// src/features/projects/projects.database.ts
-async function insertProject(db, project) {
-  try {
-    await db.execute(
-      `
-      INSERT INTO projects (id, name, gitUrl, path, createdAt, openWith, commands, setupScript, runCommand, commitMethod, planPrompt, testPrompt, reviewPrompt)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `,
-      [
-        project.id,
-        project.name,
-        project.gitUrl,
-        project.path,
-        project.createdAt.toISOString(),
-        project.openWith ?? null,
-        project.commands ? JSON.stringify(project.commands) : null,
-        project.setupScript ?? null,
-        project.runCommand ?? null,
-        project.commitMethod ?? null,
-        project.planPrompt ?? null,
-        project.testPrompt ?? null,
-        project.reviewPrompt ?? null
-      ]
-    );
-  } catch (error) {
-    console.error("Failed to insert project:", error);
-    throw error;
-  }
-}
-async function updateProject(db, id, updates) {
-  try {
-    const fields = [];
-    const values = [];
-    if (updates.name !== void 0) {
-      fields.push("name = ?");
-      values.push(updates.name);
-    }
-    if (updates.gitUrl !== void 0) {
-      fields.push("gitUrl = ?");
-      values.push(updates.gitUrl);
-    }
-    if (updates.path !== void 0) {
-      fields.push("path = ?");
-      values.push(updates.path);
-    }
-    if (updates.openWith !== void 0) {
-      fields.push("openWith = ?");
-      values.push(updates.openWith ?? null);
-    }
-    if (updates.commands !== void 0) {
-      fields.push("commands = ?");
-      values.push(updates.commands ? JSON.stringify(updates.commands) : null);
-    }
-    if (updates.setupScript !== void 0) {
-      fields.push("setupScript = ?");
-      values.push(updates.setupScript ?? null);
-    }
-    if (updates.runCommand !== void 0) {
-      fields.push("runCommand = ?");
-      values.push(updates.runCommand ?? null);
-    }
-    if (updates.commitMethod !== void 0) {
-      fields.push("commitMethod = ?");
-      values.push(updates.commitMethod ?? null);
-    }
-    if (updates.planPrompt !== void 0) {
-      fields.push("planPrompt = ?");
-      values.push(updates.planPrompt ?? null);
-    }
-    if (updates.testPrompt !== void 0) {
-      fields.push("testPrompt = ?");
-      values.push(updates.testPrompt ?? null);
-    }
-    if (updates.reviewPrompt !== void 0) {
-      fields.push("reviewPrompt = ?");
-      values.push(updates.reviewPrompt ?? null);
-    }
-    if (fields.length === 0) {
-      return;
-    }
-    values.push(id);
-    const sql = `UPDATE projects SET ${fields.join(", ")} WHERE id = ?`;
-    await db.execute(sql, values);
-  } catch (error) {
-    console.error("Failed to update project:", error);
-    throw error;
-  }
-}
-async function deleteProject(db, id) {
-  try {
-    await db.execute("PRAGMA foreign_keys = OFF");
-    try {
-      await db.execute(
-        `
-        DELETE FROM conversation_history 
-        WHERE threadId IN (
-          SELECT threads.id FROM threads WHERE threads.projectId = ?
-        )
-      `,
-        [id]
-      );
-      await db.execute(
-        `
-        DELETE FROM todos 
-        WHERE threadId IN (
-          SELECT threads.id FROM threads WHERE threads.projectId = ?
-        )
-      `,
-        [id]
-      );
-      await db.execute("DELETE FROM threads WHERE projectId = ?", [id]);
-      await db.execute("DELETE FROM project_todos WHERE projectId = ?", [id]);
-      await db.execute("DELETE FROM projects WHERE id = ?", [id]);
-    } finally {
-      await db.execute("PRAGMA foreign_keys = ON");
-    }
-  } catch (error) {
-    console.error("Failed to delete project:", error);
-    throw error;
-  }
-}
-async function getAllProjects(db) {
-  try {
-    const result = await db.execute("SELECT * FROM projects ORDER BY createdAt DESC");
-    const rows = result.rows;
-    const threadResult = await db.execute(
-      "SELECT id, projectId FROM threads ORDER BY createdAt DESC"
-    );
-    const threadRows = threadResult.rows;
-    const threadIdsByProject = /* @__PURE__ */ new Map();
-    for (const row of threadRows) {
-      const ids = threadIdsByProject.get(row.projectId);
-      if (ids) {
-        ids.push(row.id);
-      } else {
-        threadIdsByProject.set(row.projectId, [row.id]);
-      }
-    }
-    return rows.map(
-      (row) => deserializeProjectWithThreads(row, threadIdsByProject.get(row.id) ?? [])
-    );
-  } catch (error) {
-    console.error("Failed to get all projects:", error);
-    throw error;
-  }
-}
-function deserializeProjectWithThreads(row, threadIds) {
-  return {
-    id: row.id,
-    name: row.name,
-    gitUrl: row.gitUrl,
-    path: row.path,
-    createdAt: new Date(row.createdAt),
-    threads: threadIds,
-    openWith: row.openWith ?? void 0,
-    commands: row.commands ? JSON.parse(row.commands) : void 0,
-    setupScript: row.setupScript ?? void 0,
-    runCommand: row.runCommand ?? void 0,
-    commitMethod: row.commitMethod && isValidCommitMethod(row.commitMethod) ? row.commitMethod : void 0,
-    planPrompt: row.planPrompt ?? void 0,
-    testPrompt: row.testPrompt ?? void 0,
-    reviewPrompt: row.reviewPrompt ?? void 0
-  };
-}
-
 // src/features/threads/threads.database.ts
 async function insertThread(db, thread) {
   try {
@@ -10011,6 +10163,7 @@ async function handleListProjects(c, projectManager, threadManager, db) {
         openWith: project.openWith,
         commands: project.commands ?? [],
         setupScript: project.setupScript,
+        validationScript: project.validationScript,
         runCommand: project.runCommand,
         commitMethod: project.commitMethod,
         planPrompt: project.planPrompt,
@@ -10103,8 +10256,8 @@ function validateProgram(program) {
   return null;
 }
 var OpenWithHandler = class {
-  constructor(getProject, metadataManager) {
-    this.getProject = getProject;
+  constructor(getProject2, metadataManager) {
+    this.getProject = getProject2;
     this.metadataManager = metadataManager;
   }
   async openWith(projectId, program) {
@@ -10281,6 +10434,7 @@ async function handleUpdateProject(c, projectManager) {
     const {
       program,
       setupScript,
+      validationScript,
       name,
       runCommand,
       commitMethod,
@@ -10311,6 +10465,10 @@ async function handleUpdateProject(c, projectManager) {
         return streamAsyncGenerator(c, projectManager.runCommand(firstThreadId, scriptToSave));
       }
     }
+    if (validationScript !== void 0) {
+      const scriptToSave = validationScript === "" ? null : validationScript;
+      await projectManager.updateValidationScript(projectId, scriptToSave);
+    }
     if (runCommand !== void 0) {
       await projectManager.updateRunCommand(projectId, runCommand);
     }
@@ -11336,7 +11494,7 @@ import { access as access3, stat as stat3, readdir as readdir8 } from "fs/promis
 init_utils();
 import { existsSync as existsSync12 } from "fs";
 import { join as join16 } from "path";
-import { mkdir as mkdir2, readdir as readdir7, stat as stat2, rename, rm as rm2 } from "fs/promises";
+import { mkdir as mkdir2, readdir as readdir7, stat as stat2, rename, rm as rm2, writeFile as writeFile2 } from "fs/promises";
 import { createInterface as createInterface2 } from "readline";
 
 // src/scaffold-templates.json
@@ -11351,7 +11509,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "list",
-    variationName: "Ionic List"
+    variationName: "Ionic List",
+    agentsMd: "- Use the `inject()` function instead of constructor injection for dependencies.\n- Prefer standalone components; avoid NgModule declarations unless required by a library.\n- Use signals (`signal()`, `computed()`, `effect()`) for reactive state instead of RxJS Subjects where possible.\n- Always run `ng generate` for new components/services rather than creating files manually to ensure correct wiring.\n- Mark change detection as `OnPush` on every component by default to avoid unnecessary re-renders."
   },
   {
     id: "angular-standalone-blank",
@@ -11363,7 +11522,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "blank",
-    variationName: "Ionic Blank"
+    variationName: "Ionic Blank",
+    agentsMd: "- Use the `inject()` function instead of constructor injection for dependencies.\n- Prefer standalone components; avoid NgModule declarations unless required by a library.\n- Use signals (`signal()`, `computed()`, `effect()`) for reactive state instead of RxJS Subjects where possible.\n- Always run `ng generate` for new components/services rather than creating files manually to ensure correct wiring.\n- Mark change detection as `OnPush` on every component by default to avoid unnecessary re-renders."
   },
   {
     id: "angular-standalone-sidemenu",
@@ -11375,7 +11535,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "sidemenu",
-    variationName: "Ionic Side Menu"
+    variationName: "Ionic Side Menu",
+    agentsMd: "- Use the `inject()` function instead of constructor injection for dependencies.\n- Prefer standalone components; avoid NgModule declarations unless required by a library.\n- Use signals (`signal()`, `computed()`, `effect()`) for reactive state instead of RxJS Subjects where possible.\n- Always run `ng generate` for new components/services rather than creating files manually to ensure correct wiring.\n- Mark change detection as `OnPush` on every component by default to avoid unnecessary re-renders."
   },
   {
     id: "angular-standalone-tabs",
@@ -11387,7 +11548,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "tabs",
-    variationName: "Ionic Tabs"
+    variationName: "Ionic Tabs",
+    agentsMd: "- Use the `inject()` function instead of constructor injection for dependencies.\n- Prefer standalone components; avoid NgModule declarations unless required by a library.\n- Use signals (`signal()`, `computed()`, `effect()`) for reactive state instead of RxJS Subjects where possible.\n- Always run `ng generate` for new components/services rather than creating files manually to ensure correct wiring.\n- Mark change detection as `OnPush` on every component by default to avoid unnecessary re-renders."
   },
   {
     id: "react-tabs",
@@ -11399,7 +11561,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "tabs",
-    variationName: "Ionic Tabs"
+    variationName: "Ionic Tabs",
+    agentsMd: "- Extract stateful logic into custom hooks (`use*`) instead of keeping `useState`/`useEffect` directly in components.\n- Avoid adding `useEffect` for data that can be derived synchronously from existing state or props.\n- Wrap expensive child renders in `React.memo` and callbacks in `useCallback` only after profiling, not by default.\n- Use the `key` prop on list items with stable unique IDs \u2014 never array indices when the list can be reordered or filtered.\n- Prefer controlled components over uncontrolled ones so form state is always in sync with application state."
   },
   {
     id: "react-sidemenu",
@@ -11411,7 +11574,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "sidemenu",
-    variationName: "Ionic Side Menu"
+    variationName: "Ionic Side Menu",
+    agentsMd: "- Extract stateful logic into custom hooks (`use*`) instead of keeping `useState`/`useEffect` directly in components.\n- Avoid adding `useEffect` for data that can be derived synchronously from existing state or props.\n- Wrap expensive child renders in `React.memo` and callbacks in `useCallback` only after profiling, not by default.\n- Use the `key` prop on list items with stable unique IDs \u2014 never array indices when the list can be reordered or filtered.\n- Prefer controlled components over uncontrolled ones so form state is always in sync with application state."
   },
   {
     id: "react-list",
@@ -11423,7 +11587,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "list",
-    variationName: "Ionic List"
+    variationName: "Ionic List",
+    agentsMd: "- Extract stateful logic into custom hooks (`use*`) instead of keeping `useState`/`useEffect` directly in components.\n- Avoid adding `useEffect` for data that can be derived synchronously from existing state or props.\n- Wrap expensive child renders in `React.memo` and callbacks in `useCallback` only after profiling, not by default.\n- Use the `key` prop on list items with stable unique IDs \u2014 never array indices when the list can be reordered or filtered.\n- Prefer controlled components over uncontrolled ones so form state is always in sync with application state."
   },
   {
     id: "react-blank",
@@ -11435,7 +11600,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "blank",
-    variationName: "Ionic Blank"
+    variationName: "Ionic Blank",
+    agentsMd: "- Extract stateful logic into custom hooks (`use*`) instead of keeping `useState`/`useEffect` directly in components.\n- Avoid adding `useEffect` for data that can be derived synchronously from existing state or props.\n- Wrap expensive child renders in `React.memo` and callbacks in `useCallback` only after profiling, not by default.\n- Use the `key` prop on list items with stable unique IDs \u2014 never array indices when the list can be reordered or filtered.\n- Prefer controlled components over uncontrolled ones so form state is always in sync with application state."
   },
   {
     id: "vue-list",
@@ -11447,7 +11613,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "list",
-    variationName: "Ionic List"
+    variationName: "Ionic List",
+    agentsMd: "- Use the Composition API (`<script setup>`) for all components; avoid the Options API in new code.\n- Define props with `defineProps<TypedInterface>()` using TypeScript generics rather than runtime validators.\n- Never destructure reactive props directly \u2014 use `toRefs(props)` or access via `props.x` to preserve reactivity.\n- Use `provide`/`inject` with typed injection keys (a `InjectionKey<T>`) to avoid untyped cross-component coupling.\n- Prefix composables with `use` and keep them in a dedicated `composables/` directory, not inside component files."
   },
   {
     id: "vue-blank",
@@ -11459,7 +11626,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "blank",
-    variationName: "Ionic Blank"
+    variationName: "Ionic Blank",
+    agentsMd: "- Use the Composition API (`<script setup>`) for all components; avoid the Options API in new code.\n- Define props with `defineProps<TypedInterface>()` using TypeScript generics rather than runtime validators.\n- Never destructure reactive props directly \u2014 use `toRefs(props)` or access via `props.x` to preserve reactivity.\n- Use `provide`/`inject` with typed injection keys (a `InjectionKey<T>`) to avoid untyped cross-component coupling.\n- Prefix composables with `use` and keep them in a dedicated `composables/` directory, not inside component files."
   },
   {
     id: "vue-sidemenu",
@@ -11471,7 +11639,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "sidemenu",
-    variationName: "Ionic Side Menu"
+    variationName: "Ionic Side Menu",
+    agentsMd: "- Use the Composition API (`<script setup>`) for all components; avoid the Options API in new code.\n- Define props with `defineProps<TypedInterface>()` using TypeScript generics rather than runtime validators.\n- Never destructure reactive props directly \u2014 use `toRefs(props)` or access via `props.x` to preserve reactivity.\n- Use `provide`/`inject` with typed injection keys (a `InjectionKey<T>`) to avoid untyped cross-component coupling.\n- Prefix composables with `use` and keep them in a dedicated `composables/` directory, not inside component files."
   },
   {
     id: "vue-tabs",
@@ -11483,7 +11652,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "tabs",
-    variationName: "Ionic Tabs"
+    variationName: "Ionic Tabs",
+    agentsMd: "- Use the Composition API (`<script setup>`) for all components; avoid the Options API in new code.\n- Define props with `defineProps<TypedInterface>()` using TypeScript generics rather than runtime validators.\n- Never destructure reactive props directly \u2014 use `toRefs(props)` or access via `props.x` to preserve reactivity.\n- Use `provide`/`inject` with typed injection keys (a `InjectionKey<T>`) to avoid untyped cross-component coupling.\n- Prefix composables with `use` and keep them in a dedicated `composables/` directory, not inside component files."
   },
   {
     id: "plugin-starter",
@@ -11493,7 +11663,8 @@ var scaffold_templates_default = [
     url: "https://capacitorjs.com/docs/plugins/creating-plugins",
     handler: "capacitor-plugin",
     variation: "Starter",
-    variationName: "Capacitor Plugin Starter"
+    variationName: "Capacitor Plugin Starter",
+    agentsMd: "- Implement every method in the web fallback (`web.ts`) even if it just throws `unimplemented()` \u2014 never leave methods missing.\n- Declare all plugin events in the `addListener` overloads with explicit typed payloads, not generic `any` objects.\n- Use `Capacitor.isNativePlatform()` guards before calling native-only APIs rather than checking `platform === 'ios'`.\n- Always call `notifyListeners` with a consistent event-name constant shared between native and web implementations.\n- Run `npx cap sync` after any change to native code or package exports to keep the native bridge in sync."
   },
   {
     id: "custom-angular-starter",
@@ -11506,7 +11677,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Starter",
-    variationName: "Starter"
+    variationName: "Starter",
+    agentsMd: "- Use the `inject()` function instead of constructor injection for dependencies.\n- Prefer standalone components; avoid NgModule declarations unless required by a library.\n- Use signals (`signal()`, `computed()`, `effect()`) for reactive state instead of RxJS Subjects where possible.\n- Always run `ng generate` for new components/services rather than creating files manually to ensure correct wiring.\n- Mark change detection as `OnPush` on every component by default to avoid unnecessary re-renders."
   },
   {
     id: "custom-svelte-minimal",
@@ -11519,7 +11691,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Minimal",
-    variationName: "Minimal"
+    variationName: "Minimal",
+    agentsMd: "- Always reassign arrays/objects to trigger reactivity; never mutate in place (e.g. `arr = [...arr, item]` not `arr.push(item)`).\n- Use Svelte stores (`writable`, `readable`, `derived`) for cross-component reactive state rather than prop drilling.\n- Place reusable logic in plain `.ts` files rather than creating single-instance components just to share behaviour.\n- Scope CSS inside `<style>` blocks \u2014 avoid global styles unless intentionally applying app-wide resets.\n- Use `{#key expr}` blocks to force re-mounting a component when identity changes, rather than toggling with `{#if}`."
   },
   {
     id: "custom-svelte-demo",
@@ -11532,7 +11705,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Demo",
-    variationName: "Demo"
+    variationName: "Demo",
+    agentsMd: "- Always reassign arrays/objects to trigger reactivity; never mutate in place (e.g. `arr = [...arr, item]` not `arr.push(item)`).\n- Use Svelte stores (`writable`, `readable`, `derived`) for cross-component reactive state rather than prop drilling.\n- Place reusable logic in plain `.ts` files rather than creating single-instance components just to share behaviour.\n- Scope CSS inside `<style>` blocks \u2014 avoid global styles unless intentionally applying app-wide resets.\n- Use `{#key expr}` blocks to force re-mounting a component when identity changes, rather than toggling with `{#if}`."
   },
   {
     id: "custom-svelte-library",
@@ -11545,7 +11719,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Library",
-    variationName: "Library"
+    variationName: "Library",
+    agentsMd: "- Always reassign arrays/objects to trigger reactivity; never mutate in place (e.g. `arr = [...arr, item]` not `arr.push(item)`).\n- Use Svelte stores (`writable`, `readable`, `derived`) for cross-component reactive state rather than prop drilling.\n- Place reusable logic in plain `.ts` files rather than creating single-instance components just to share behaviour.\n- Scope CSS inside `<style>` blocks \u2014 avoid global styles unless intentionally applying app-wide resets.\n- Use `{#key expr}` blocks to force re-mounting a component when identity changes, rather than toggling with `{#if}`."
   },
   {
     id: "custom-ionic-svelte-starter",
@@ -11555,7 +11730,8 @@ var scaffold_templates_default = [
     url: "https://github.com/Tommertom/svelte-ionic-app",
     commands: ["npm create ionic-svelte-app@latest $(project-name)", "#$(project-folder)"],
     variation: "Starter",
-    variationName: "Starter"
+    variationName: "Starter",
+    agentsMd: "- Always reassign arrays/objects to trigger reactivity; never mutate in place (e.g. `arr = [...arr, item]` not `arr.push(item)`).\n- Use Svelte stores (`writable`, `readable`, `derived`) for cross-component reactive state rather than prop drilling.\n- Place reusable logic in plain `.ts` files rather than creating single-instance components just to share behaviour.\n- Scope CSS inside `<style>` blocks \u2014 avoid global styles unless intentionally applying app-wide resets.\n- Use `{#key expr}` blocks to force re-mounting a component when identity changes, rather than toggling with `{#if}`."
   },
   {
     id: "tanstack-start-basic",
@@ -11568,7 +11744,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Basic",
-    variationName: "Basic"
+    variationName: "Basic",
+    agentsMd: "- Define routes using the file-based routing convention (`routes/` directory) rather than programmatic route config where possible.\n- Use `createServerFn` for all server-side data fetching and mutations \u2014 never call APIs directly from client components.\n- Throw `redirect()` and `notFound()` inside loaders rather than returning them as data values.\n- Use `routeOptions.staleTime` to control cache lifetimes per route instead of relying on global defaults.\n- Validate search params with a schema (e.g. Zod via `validateSearch`) rather than trusting raw URL string values."
   },
   {
     id: "tanstack-start-auth",
@@ -11581,7 +11758,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Auth",
-    variationName: "Auth"
+    variationName: "Auth",
+    agentsMd: "- Define routes using the file-based routing convention (`routes/` directory) rather than programmatic route config where possible.\n- Use `createServerFn` for all server-side data fetching and mutations \u2014 never call APIs directly from client components.\n- Throw `redirect()` and `notFound()` inside loaders rather than returning them as data values.\n- Use `routeOptions.staleTime` to control cache lifetimes per route instead of relying on global defaults.\n- Validate search params with a schema (e.g. Zod via `validateSearch`) rather than trusting raw URL string values."
   },
   {
     id: "tanstack-start-counter",
@@ -11594,7 +11772,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Counter",
-    variationName: "Counter"
+    variationName: "Counter",
+    agentsMd: "- Define routes using the file-based routing convention (`routes/` directory) rather than programmatic route config where possible.\n- Use `createServerFn` for all server-side data fetching and mutations \u2014 never call APIs directly from client components.\n- Throw `redirect()` and `notFound()` inside loaders rather than returning them as data values.\n- Use `routeOptions.staleTime` to control cache lifetimes per route instead of relying on global defaults.\n- Validate search params with a schema (e.g. Zod via `validateSearch`) rather than trusting raw URL string values."
   },
   {
     id: "tanstack-start-react-query",
@@ -11607,7 +11786,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "React Query",
-    variationName: "React Query"
+    variationName: "React Query",
+    agentsMd: "- Define routes using the file-based routing convention (`routes/` directory) rather than programmatic route config where possible.\n- Use `createServerFn` for all server-side data fetching and mutations \u2014 never call APIs directly from client components.\n- Throw `redirect()` and `notFound()` inside loaders rather than returning them as data values.\n- Use `routeOptions.staleTime` to control cache lifetimes per route instead of relying on global defaults.\n- Validate search params with a schema (e.g. Zod via `validateSearch`) rather than trusting raw URL string values."
   },
   {
     id: "tanstack-start-clerk-auth",
@@ -11620,7 +11800,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Clerk Auth",
-    variationName: "Clerk Auth"
+    variationName: "Clerk Auth",
+    agentsMd: "- Define routes using the file-based routing convention (`routes/` directory) rather than programmatic route config where possible.\n- Use `createServerFn` for all server-side data fetching and mutations \u2014 never call APIs directly from client components.\n- Throw `redirect()` and `notFound()` inside loaders rather than returning them as data values.\n- Use `routeOptions.staleTime` to control cache lifetimes per route instead of relying on global defaults.\n- Validate search params with a schema (e.g. Zod via `validateSearch`) rather than trusting raw URL string values."
   },
   {
     id: "tanstack-start-supabase",
@@ -11633,7 +11814,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Supabase",
-    variationName: "Supabase"
+    variationName: "Supabase",
+    agentsMd: "- Define routes using the file-based routing convention (`routes/` directory) rather than programmatic route config where possible.\n- Use `createServerFn` for all server-side data fetching and mutations \u2014 never call APIs directly from client components.\n- Throw `redirect()` and `notFound()` inside loaders rather than returning them as data values.\n- Use `routeOptions.staleTime` to control cache lifetimes per route instead of relying on global defaults.\n- Validate search params with a schema (e.g. Zod via `validateSearch`) rather than trusting raw URL string values."
   },
   {
     id: "tanstack-start-trellaux",
@@ -11646,7 +11828,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Trellaux",
-    variationName: "Trellaux"
+    variationName: "Trellaux",
+    agentsMd: "- Define routes using the file-based routing convention (`routes/` directory) rather than programmatic route config where possible.\n- Use `createServerFn` for all server-side data fetching and mutations \u2014 never call APIs directly from client components.\n- Throw `redirect()` and `notFound()` inside loaders rather than returning them as data values.\n- Use `routeOptions.staleTime` to control cache lifetimes per route instead of relying on global defaults.\n- Validate search params with a schema (e.g. Zod via `validateSearch`) rather than trusting raw URL string values."
   },
   {
     id: "tanstack-start-material-ui",
@@ -11659,7 +11842,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Material UI",
-    variationName: "Material UI"
+    variationName: "Material UI",
+    agentsMd: "- Define routes using the file-based routing convention (`routes/` directory) rather than programmatic route config where possible.\n- Use `createServerFn` for all server-side data fetching and mutations \u2014 never call APIs directly from client components.\n- Throw `redirect()` and `notFound()` inside loaders rather than returning them as data values.\n- Use `routeOptions.staleTime` to control cache lifetimes per route instead of relying on global defaults.\n- Validate search params with a schema (e.g. Zod via `validateSearch`) rather than trusting raw URL string values."
   },
   {
     id: "vite-vue-vue",
@@ -11669,7 +11853,8 @@ var scaffold_templates_default = [
     url: "https://vite.dev/guide/",
     commands: ["npm create vite@latest $(project-name) -- --template vue", "#$(project-folder)"],
     variation: "Vue",
-    variationName: "Starter"
+    variationName: "Starter",
+    agentsMd: "- Use the Composition API (`<script setup>`) for all components; avoid the Options API in new code.\n- Define props with `defineProps<TypedInterface>()` using TypeScript generics rather than runtime validators.\n- Never destructure reactive props directly \u2014 use `toRefs(props)` or access via `props.x` to preserve reactivity.\n- Use `provide`/`inject` with typed injection keys (a `InjectionKey<T>`) to avoid untyped cross-component coupling.\n- Prefix composables with `use` and keep them in a dedicated `composables/` directory, not inside component files."
   },
   {
     id: "vite-react-react",
@@ -11682,7 +11867,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "React",
-    variationName: "Starter"
+    variationName: "Starter",
+    agentsMd: "- Extract stateful logic into custom hooks (`use*`) instead of keeping `useState`/`useEffect` directly in components.\n- Avoid adding `useEffect` for data that can be derived synchronously from existing state or props.\n- Wrap expensive child renders in `React.memo` and callbacks in `useCallback` only after profiling, not by default.\n- Use the `key` prop on list items with stable unique IDs \u2014 never array indices when the list can be reordered or filtered.\n- Prefer controlled components over uncontrolled ones so form state is always in sync with application state."
   },
   {
     id: "vite-preact-preact",
@@ -11695,7 +11881,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Preact",
-    variationName: "Starter"
+    variationName: "Starter",
+    agentsMd: "- Use Preact Signals (`@preact/signals`) for shared reactive state instead of `useState` + prop drilling.\n- Import from `preact/hooks` and `preact/jsx-runtime` explicitly \u2014 do not assume React aliases are configured.\n- Avoid mixing the compat layer (`preact/compat`) with native Preact APIs in the same file.\n- Keep components as small pure functions; Preact's VDOM diffing is fast but unnecessary re-renders still add up.\n- Test with `@preact/test-utils` rather than React Testing Library to avoid compat-layer edge cases."
   },
   {
     id: "vite-lit-lit",
@@ -11708,7 +11895,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Lit",
-    variationName: "Lit"
+    variationName: "Lit",
+    agentsMd: "- Always declare reactive properties with `@property` or `@state` decorators \u2014 never store component state in plain class fields.\n- Implement `disconnectedCallback` to clean up event listeners and timers added in `connectedCallback`.\n- Use `unsafeHTML` / `unsafeCSS` only when strictly necessary and sanitize any user-supplied content first.\n- Prefer CSS custom properties for theming so consumers can restyle elements without shadow-DOM piercing hacks.\n- Use `@query` / `@queryAll` decorators to access shadow DOM nodes rather than calling `this.shadowRoot.querySelector` inline."
   },
   {
     id: "vite-svelte-svelte",
@@ -11721,7 +11909,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Svelte",
-    variationName: "Svelte"
+    variationName: "Svelte",
+    agentsMd: "- Always reassign arrays/objects to trigger reactivity; never mutate in place (e.g. `arr = [...arr, item]` not `arr.push(item)`).\n- Use Svelte stores (`writable`, `readable`, `derived`) for cross-component reactive state rather than prop drilling.\n- Place reusable logic in plain `.ts` files rather than creating single-instance components just to share behaviour.\n- Scope CSS inside `<style>` blocks \u2014 avoid global styles unless intentionally applying app-wide resets.\n- Use `{#key expr}` blocks to force re-mounting a component when identity changes, rather than toggling with `{#if}`."
   },
   {
     id: "vite-solid-typescript",
@@ -11734,7 +11923,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Typescript",
-    variationName: "Typescript"
+    variationName: "Typescript",
+    agentsMd: "- Remember that components run only once \u2014 do not write logic that assumes repeated execution of the component body.\n- Access signal values inside JSX or effects (not in component scope) so tracking is active when the value is read.\n- Use `splitProps` to separate your own props from those forwarded to a DOM element; never spread all props blindly.\n- Wrap async data fetching in `createResource` rather than mixing `createSignal` + `createEffect` for loading state.\n- Use `<For>`, `<Show>`, and `<Switch>` primitives instead of `.map()` or ternary expressions for reactive control flow."
   },
   {
     id: "vite-solid-javascript",
@@ -11744,7 +11934,8 @@ var scaffold_templates_default = [
     url: "https://vite.dev/guide/#trying-vite-online",
     commands: ["npx degit solidjs/templates/js $(project-name)", "#$(project-folder)"],
     variation: "Javascript",
-    variationName: "Javascript"
+    variationName: "Javascript",
+    agentsMd: "- Remember that components run only once \u2014 do not write logic that assumes repeated execution of the component body.\n- Access signal values inside JSX or effects (not in component scope) so tracking is active when the value is read.\n- Use `splitProps` to separate your own props from those forwarded to a DOM element; never spread all props blindly.\n- Wrap async data fetching in `createResource` rather than mixing `createSignal` + `createEffect` for loading state.\n- Use `<For>`, `<Show>`, and `<Switch>` primitives instead of `.map()` or ternary expressions for reactive control flow."
   },
   {
     id: "vite-web-typescript",
@@ -11757,7 +11948,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Typescript",
-    variationName: "Typescript"
+    variationName: "Typescript",
+    agentsMd: "- Use ES modules (`import`/`export`) and rely on Vite's native module resolution instead of bundling everything into one file.\n- Target modern browser APIs; avoid polyfilling features that are natively supported in the browsers you ship to.\n- Keep DOM query selectors (`getElementById`, `querySelector`) at the top of the module, not inside event handlers.\n- Use CSS custom properties for theme tokens rather than hard-coding colour or spacing values in JavaScript.\n- Prefer `fetch` + `async/await` over XMLHttpRequest or callback-style patterns for all network calls."
   },
   {
     id: "vite-web-javascript",
@@ -11770,7 +11962,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Javascript",
-    variationName: "Javascript"
+    variationName: "Javascript",
+    agentsMd: "- Use ES modules (`import`/`export`) and rely on Vite's native module resolution instead of bundling everything into one file.\n- Target modern browser APIs; avoid polyfilling features that are natively supported in the browsers you ship to.\n- Keep DOM query selectors (`getElementById`, `querySelector`) at the top of the module, not inside event handlers.\n- Use CSS custom properties for theme tokens rather than hard-coding colour or spacing values in JavaScript.\n- Prefer `fetch` + `async/await` over XMLHttpRequest or callback-style patterns for all network calls."
   },
   {
     id: "vite-qwik-qwik",
@@ -11783,7 +11976,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Qwik",
-    variationName: "Qwik"
+    variationName: "Qwik",
+    agentsMd: "- Mark event handlers and async operations with `$` (e.g. `onClick$`) to define lazy-loadable boundaries \u2014 never inline complex logic.\n- Use `useStore` for mutable component state instead of `useSignal` when the object has multiple related fields.\n- Keep serializable data only in `useStore`/`useSignal` \u2014 functions, class instances, and closures cannot be serialized across resumability boundaries.\n- Run Qwik Insights or the bundle analyser to verify lazy-loading boundaries are correct before shipping.\n- Avoid importing large third-party libraries at the top level; wrap them in a `$` handler to keep initial JS to zero."
   },
   {
     id: "nuxt-nuxt",
@@ -11796,7 +11990,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Nuxt",
-    variationName: "Nuxt"
+    variationName: "Nuxt",
+    agentsMd: "- Use `useFetch` or `useAsyncData` for all data loading \u2014 never call `fetch` directly inside `<script setup>` as it breaks SSR hydration.\n- Put server-only code in the `server/` directory (API routes, middleware); it is never sent to the client.\n- Use `useState` for shared SSR-safe state across components instead of plain `ref` at module scope.\n- Register Nuxt modules in `nuxt.config.ts` rather than importing their Vue plugins manually.\n- Type server API responses by importing the inferred return type from the route file rather than duplicating the shape."
   },
   {
     id: "astro-astro",
@@ -11809,7 +12004,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Astro",
-    variationName: "Astro"
+    variationName: "Astro",
+    agentsMd: "- Default to zero client-side JavaScript; only add `client:load` / `client:visible` directives to components that genuinely need interactivity.\n- Use Astro's content collections (`src/content/`) with typed schemas for any structured data rather than loose markdown files.\n- Fetch data at build time in frontmatter (`---` blocks) rather than at runtime unless the page is explicitly server-rendered.\n- Keep shared layout logic in `src/layouts/` and avoid duplicating `<head>` or navigation markup across pages.\n- Use `Astro.locals` and middleware (`src/middleware.ts`) for request-scoped server data instead of passing it through props."
   },
   {
     id: "waku-waku",
@@ -11822,7 +12018,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Waku",
-    variationName: "Waku"
+    variationName: "Waku",
+    agentsMd: "- Mark components as server components by default; only add `'use client'` when the component needs browser APIs or event handlers.\n- Never pass non-serializable values (functions, class instances) across the server/client boundary as props.\n- Fetch data directly in server components using `async/await` \u2014 avoid additional data-fetching libraries for server-side data.\n- Use Waku's file-based routing (`pages/` directory) instead of configuring routes programmatically.\n- Test server component output by inspecting the RSC payload, not just the rendered HTML, to catch serialization issues early."
   },
   {
     id: "nextjs-nextjs",
@@ -11835,7 +12032,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Next.js",
-    variationName: "Next.js"
+    variationName: "Next.js",
+    agentsMd: "- Default every component to a Server Component; only add `'use client'` at the leaf level where interactivity is needed.\n- Use Server Actions (functions marked `'use server'`) for form submissions and mutations instead of separate API routes.\n- Avoid `useEffect` for data fetching \u2014 fetch directly in async Server Components or use `cache()` to deduplicate requests.\n- Set explicit `revalidate` or `dynamic` export values in each route segment so caching behaviour is intentional, not accidental.\n- Use `next/image` for all images and supply explicit `width`/`height` or `fill` to prevent layout shift."
   },
   {
     id: "hydrogen-tailwind",
@@ -11848,7 +12046,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Tailwind",
-    variationName: "Tailwind"
+    variationName: "Tailwind",
+    agentsMd: "- Use Hydrogen's `createStorefrontClient` and never call Shopify's Storefront API directly from client components.\n- Leverage Remix loaders and actions for all data fetching and cart mutations \u2014 avoid `useEffect`-driven fetches.\n- Cache Storefront API responses using the `CacheShort()` / `CacheLong()` strategies from `@shopify/hydrogen` rather than leaving caching implicit.\n- Use `<Money>`, `<Image>`, and `<AddToCartButton>` Hydrogen components instead of reimplementing currency formatting or Shopify CDN URLs.\n- Store session data (cart ID, customer token) via `session.set` in the Remix session rather than in client-side state or localStorage."
   },
   {
     id: "hydrogen-vanilla",
@@ -11861,7 +12060,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Vanilla",
-    variationName: "Vanilla"
+    variationName: "Vanilla",
+    agentsMd: "- Use Hydrogen's `createStorefrontClient` and never call Shopify's Storefront API directly from client components.\n- Leverage Remix loaders and actions for all data fetching and cart mutations \u2014 avoid `useEffect`-driven fetches.\n- Cache Storefront API responses using the `CacheShort()` / `CacheLong()` strategies from `@shopify/hydrogen` rather than leaving caching implicit.\n- Use `<Money>`, `<Image>`, and `<AddToCartButton>` Hydrogen components instead of reimplementing currency formatting or Shopify CDN URLs.\n- Store session data (cart ID, customer token) via `session.set` in the Remix session rather than in client-side state or localStorage."
   },
   {
     id: "hydrogen-css-modules",
@@ -11874,7 +12074,8 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "CSS Modules",
-    variationName: "CSS Modules"
+    variationName: "CSS Modules",
+    agentsMd: "- Use Hydrogen's `createStorefrontClient` and never call Shopify's Storefront API directly from client components.\n- Leverage Remix loaders and actions for all data fetching and cart mutations \u2014 avoid `useEffect`-driven fetches.\n- Cache Storefront API responses using the `CacheShort()` / `CacheLong()` strategies from `@shopify/hydrogen` rather than leaving caching implicit.\n- Use `<Money>`, `<Image>`, and `<AddToCartButton>` Hydrogen components instead of reimplementing currency formatting or Shopify CDN URLs.\n- Store session data (cart ID, customer token) via `session.set` in the Remix session rather than in client-side state or localStorage."
   },
   {
     id: "hydrogen-post-css",
@@ -11887,7 +12088,120 @@ var scaffold_templates_default = [
       "#$(project-folder)"
     ],
     variation: "Post CSS",
-    variationName: "Post CSS"
+    variationName: "Post CSS",
+    agentsMd: "- Use Hydrogen's `createStorefrontClient` and never call Shopify's Storefront API directly from client components.\n- Leverage Remix loaders and actions for all data fetching and cart mutations \u2014 avoid `useEffect`-driven fetches.\n- Cache Storefront API responses using the `CacheShort()` / `CacheLong()` strategies from `@shopify/hydrogen` rather than leaving caching implicit.\n- Use `<Money>`, `<Image>`, and `<AddToCartButton>` Hydrogen components instead of reimplementing currency formatting or Shopify CDN URLs.\n- Store session data (cart ID, customer token) via `session.set` in the Remix session rather than in client-side state or localStorage."
+  },
+  {
+    id: "vite-plus-vanilla-ts",
+    type: "vite-web",
+    typeName: "Web",
+    description: "A starter Web project with Vite Plus (vanilla-ts)",
+    url: "https://viteplus.dev/guide/create",
+    commands: [
+      "vp create vite --directory $(project-name) --no-interactive -- --template vanilla-ts",
+      "#$(project-folder)"
+    ],
+    variation: "vite-plus",
+    variationName: "Vite Plus",
+    agentsMd: "- Use ES modules (`import`/`export`) and rely on Vite's native module resolution instead of bundling everything into one file.\n- Target modern browser APIs; avoid polyfilling features that are natively supported in the browsers you ship to.\n- Keep DOM query selectors (`getElementById`, `querySelector`) at the top of the module, not inside event handlers.\n- Use CSS custom properties for theme tokens rather than hard-coding colour or spacing values in JavaScript.\n- Prefer `fetch` + `async/await` over XMLHttpRequest or callback-style patterns for all network calls."
+  },
+  {
+    id: "vite-plus-react-ts",
+    type: "vite-react",
+    typeName: "React",
+    description: "A starter React project with Vite Plus (react-ts)",
+    url: "https://viteplus.dev/guide/create",
+    commands: [
+      "vp create vite --directory $(project-name) --no-interactive -- --template react-ts",
+      "#$(project-folder)"
+    ],
+    variation: "vite-plus",
+    variationName: "Vite Plus",
+    agentsMd: "- Extract stateful logic into custom hooks (`use*`) instead of keeping `useState`/`useEffect` directly in components.\n- Avoid adding `useEffect` for data that can be derived synchronously from existing state or props.\n- Wrap expensive child renders in `React.memo` and callbacks in `useCallback` only after profiling, not by default.\n- Use the `key` prop on list items with stable unique IDs \u2014 never array indices when the list can be reordered or filtered.\n- Prefer controlled components over uncontrolled ones so form state is always in sync with application state."
+  },
+  {
+    id: "vite-plus-vue-ts",
+    type: "vite-vue",
+    typeName: "Vue",
+    description: "A starter Vue project with Vite Plus (vue-ts)",
+    url: "https://viteplus.dev/guide/create",
+    commands: [
+      "vp create vite --directory $(project-name) --no-interactive -- --template vue-ts",
+      "#$(project-folder)"
+    ],
+    variation: "vite-plus",
+    variationName: "Vite Plus",
+    agentsMd: "- Use the Composition API (`<script setup>`) for all components; avoid the Options API in new code.\n- Define props with `defineProps<TypedInterface>()` using TypeScript generics rather than runtime validators.\n- Never destructure reactive props directly \u2014 use `toRefs(props)` or access via `props.x` to preserve reactivity.\n- Use `provide`/`inject` with typed injection keys (a `InjectionKey<T>`) to avoid untyped cross-component coupling.\n- Prefix composables with `use` and keep them in a dedicated `composables/` directory, not inside component files."
+  },
+  {
+    id: "vite-plus-svelte-ts",
+    type: "vite-svelte",
+    typeName: "Svelte",
+    description: "A starter Svelte project with Vite Plus (svelte-ts)",
+    url: "https://viteplus.dev/guide/create",
+    commands: [
+      "vp create vite --directory $(project-name) --no-interactive -- --template svelte-ts",
+      "#$(project-folder)"
+    ],
+    variation: "vite-plus",
+    variationName: "Vite Plus",
+    agentsMd: "- Always reassign arrays/objects to trigger reactivity; never mutate in place (e.g. `arr = [...arr, item]` not `arr.push(item)`).\n- Use Svelte stores (`writable`, `readable`, `derived`) for cross-component reactive state rather than prop drilling.\n- Place reusable logic in plain `.ts` files rather than creating single-instance components just to share behaviour.\n- Scope CSS inside `<style>` blocks \u2014 avoid global styles unless intentionally applying app-wide resets.\n- Use `{#key expr}` blocks to force re-mounting a component when identity changes, rather than toggling with `{#if}`."
+  },
+  {
+    id: "vite-plus-solid-ts",
+    type: "vite-solid",
+    typeName: "Solid",
+    description: "A starter Solid project with Vite Plus (solid-ts)",
+    url: "https://viteplus.dev/guide/create",
+    commands: [
+      "vp create vite --directory $(project-name) --no-interactive -- --template solid-ts",
+      "#$(project-folder)"
+    ],
+    variation: "vite-plus",
+    variationName: "Vite Plus",
+    agentsMd: "- Remember that components run only once \u2014 do not write logic that assumes repeated execution of the component body.\n- Access signal values inside JSX or effects (not in component scope) so tracking is active when the value is read.\n- Use `splitProps` to separate your own props from those forwarded to a DOM element; never spread all props blindly.\n- Wrap async data fetching in `createResource` rather than mixing `createSignal` + `createEffect` for loading state.\n- Use `<For>`, `<Show>`, and `<Switch>` primitives instead of `.map()` or ternary expressions for reactive control flow."
+  },
+  {
+    id: "vite-plus-preact-ts",
+    type: "vite-preact",
+    typeName: "Preact",
+    description: "A starter Preact project with Vite Plus (preact-ts)",
+    url: "https://viteplus.dev/guide/create",
+    commands: [
+      "vp create vite --directory $(project-name) --no-interactive -- --template preact-ts",
+      "#$(project-folder)"
+    ],
+    variation: "vite-plus",
+    variationName: "Vite Plus",
+    agentsMd: "- Use Preact Signals (`@preact/signals`) for shared reactive state instead of `useState` + prop drilling.\n- Import from `preact/hooks` and `preact/jsx-runtime` explicitly \u2014 do not assume React aliases are configured.\n- Avoid mixing the compat layer (`preact/compat`) with native Preact APIs in the same file.\n- Keep components as small pure functions; Preact's VDOM diffing is fast but unnecessary re-renders still add up.\n- Test with `@preact/test-utils` rather than React Testing Library to avoid compat-layer edge cases."
+  },
+  {
+    id: "vite-plus-lit-ts",
+    type: "vite-lit",
+    typeName: "Lit",
+    description: "A starter Lit project with Vite Plus (lit-ts)",
+    url: "https://viteplus.dev/guide/create",
+    commands: [
+      "vp create vite --directory $(project-name) --no-interactive -- --template lit-ts",
+      "#$(project-folder)"
+    ],
+    variation: "vite-plus",
+    variationName: "Vite Plus",
+    agentsMd: "- Always declare reactive properties with `@property` or `@state` decorators \u2014 never store component state in plain class fields.\n- Implement `disconnectedCallback` to clean up event listeners and timers added in `connectedCallback`.\n- Use `unsafeHTML` / `unsafeCSS` only when strictly necessary and sanitize any user-supplied content first.\n- Prefer CSS custom properties for theming so consumers can restyle elements without shadow-DOM piercing hacks.\n- Use `@query` / `@queryAll` decorators to access shadow DOM nodes rather than calling `this.shadowRoot.querySelector` inline."
+  },
+  {
+    id: "vite-plus-qwik-ts",
+    type: "vite-qwik",
+    typeName: "Qwik",
+    description: "A starter Qwik project with Vite Plus (qwik-ts)",
+    url: "https://viteplus.dev/guide/create",
+    commands: [
+      "vp create vite --directory $(project-name) --no-interactive -- --template qwik-ts",
+      "#$(project-folder)"
+    ],
+    variation: "vite-plus",
+    variationName: "Vite Plus",
+    agentsMd: "- Mark event handlers and async operations with `$` (e.g. `onClick$`) to define lazy-loadable boundaries \u2014 never inline complex logic.\n- Use `useStore` for mutable component state instead of `useSignal` when the object has multiple related fields.\n- Keep serializable data only in `useStore`/`useSignal` \u2014 functions, class instances, and closures cannot be serialized across resumability boundaries.\n- Run Qwik Insights or the bundle analyser to verify lazy-loading boundaries are correct before shipping.\n- Avoid importing large third-party libraries at the top level; wrap them in a `$` handler to keep initial JS to zero."
   }
 ];
 
@@ -11899,6 +12213,12 @@ function registerScaffoldHandler(handlerName, callback) {
 function loadCatalog() {
   return scaffold_templates_default;
 }
+async function writeAgentsMd(projectPath, agentsMd) {
+  if (!agentsMd) return;
+  const agentsPath = join16(projectPath, "AGENTS.md");
+  if (existsSync12(agentsPath)) return;
+  await writeFile2(agentsPath, agentsMd, "utf-8");
+}
 function getProjectName(name) {
   return name.toLowerCase().replace(/\s/g, "-").replace(/[^a-z0-9-]/g, "").replace(/-(\d)/g, "-a$1");
 }
@@ -11933,7 +12253,10 @@ function substitutePlaceholders(command, options, template) {
 function applyPackageManagerSubstitution(command, pm) {
   const trimmed = command.trim();
   if (trimmed.startsWith("npm create ")) {
-    const rest = trimmed.slice("npm create ".length);
+    let rest = trimmed.slice("npm create ".length);
+    if (pm !== "npm") {
+      rest = rest.replace(" -- ", " ");
+    }
     switch (pm) {
       case "bun":
         return `bun create ${rest}`;
@@ -12115,6 +12438,8 @@ async function* createScaffoldedProjectStreaming(options) {
       continue;
     }
     const cmd = raw.startsWith("npm ") || raw.startsWith("npx ") ? applyPackageManagerSubstitution(raw, options.packageManager) : raw;
+    yield { type: "progress", message: `
+> ${cmd}` };
     for await (const event of runCommandStreaming(
       cwd === options.parentDir ? projectPath : cwd,
       cmd
@@ -12167,6 +12492,8 @@ async function* createScaffoldedProjectStreaming(options) {
   const installCwd = scaffoldOptions.projectPath;
   if (existsSync12(installCwd)) {
     const installCmd = getInstallCommand(options.packageManager);
+    yield { type: "progress", message: `
+> ${installCmd}` };
     for await (const event of runCommandStreaming(installCwd, installCmd)) {
       if (event.type === "output") {
         yield { type: "progress", message: event.line };
@@ -12185,6 +12512,7 @@ async function* createScaffoldedProjectStreaming(options) {
       }
     }
   }
+  await writeAgentsMd(scaffoldOptions.projectPath, template.agentsMd);
   yield { type: "result", result: { success: true, projectPath: scaffoldOptions.projectPath } };
 }
 function getScaffoldTemplates() {
@@ -13075,6 +13403,24 @@ var ProjectManagerImpl = class {
     }
     await this.metadataManager.saveProjects(projects);
   }
+  /**
+   * Updates the project's validation script
+   * @param projectId - The project ID
+   * @param validationScript - The validation script to run after chat responses (or null to clear)
+   */
+  async updateValidationScript(projectId, validationScript) {
+    const projects = await this.metadataManager.loadProjects();
+    const projectIndex = projects.findIndex((p) => p.id === projectId);
+    if (projectIndex === -1) {
+      throw new Error(`Project not found: ${projectId}`);
+    }
+    if (validationScript === null || validationScript === "") {
+      delete projects[projectIndex].validationScript;
+    } else {
+      projects[projectIndex].validationScript = validationScript;
+    }
+    await this.metadataManager.saveProjects(projects);
+  }
   /**
    * Updates the project's name
    * @param projectId - The project ID
@@ -13753,16 +14099,59 @@ async function postScaffold(c, projectManager) {
   }
 }
 
+// src/features/scaffold/scaffold-vp.route.ts
+init_utils();
+async function checkVp(c) {
+  try {
+    const { shell, args: args2 } = getShellConfig();
+    const result = spawnSyncProcess(shell, [...args2, "vp help"], {
+      env: getShellEnv(),
+      encoding: "utf-8"
+    });
+    const installed = result.status === 0;
+    return c.json({ installed });
+  } catch (error) {
+    console.error("Failed to check vp installation:", error);
+    return c.json({ installed: false });
+  }
+}
+async function installVp(c) {
+  const isWindows = process.platform === "win32";
+  const cmd = isWindows ? "irm https://vite.plus/ps1 | iex" : "curl -fsSL https://vite.plus | bash";
+  try {
+    const { shell, args: args2 } = getShellConfig();
+    const result = spawnSyncProcess(shell, [...args2, cmd], {
+      env: getShellEnv(),
+      encoding: "utf-8"
+    });
+    if (result.status === 0) {
+      return c.json({ success: true });
+    } else {
+      return c.json(
+        { success: false, error: result.stderr?.toString() || "Installation failed" },
+        500
+      );
+    }
+  } catch (error) {
+    return c.json(
+      { success: false, error: error instanceof Error ? error.message : String(error) },
+      500
+    );
+  }
+}
+
 // src/features/scaffold/scaffold.routes.ts
 function createScaffoldRoutes(projectManager) {
   const router = new Hono9();
   router.get("/templates", (c) => getScaffoldTemplatesRoute(c));
+  router.get("/check-vp", checkVp);
+  router.post("/install-vp", installVp);
   router.post("/", (c) => postScaffold(c, projectManager));
   return router;
 }
 
 // src/features/slash-commands/slash-commands.manager.ts
-import { readdir as readdir9, readFile as readFile11, mkdir as mkdir3, writeFile as writeFile2, unlink as unlink2 } from "fs/promises";
+import { readdir as readdir9, readFile as readFile11, mkdir as mkdir3, writeFile as writeFile3, unlink as unlink2 } from "fs/promises";
 import { join as join20, basename as basename3, extname as extname4 } from "path";
 import { existsSync as existsSync13 } from "fs";
 import { homedir as homedir7 } from "os";
@@ -13910,7 +14299,7 @@ var SlashCommandManager = class _SlashCommandManager {
       markdown += "---\n\n";
     }
     markdown += content;
-    await writeFile2(filePath, markdown, "utf-8");
+    await writeFile3(filePath, markdown, "utf-8");
     return {
       name,
       content,
@@ -13944,7 +14333,7 @@ var SlashCommandManager = class _SlashCommandManager {
       markdown += "---\n\n";
     }
     markdown += content;
-    await writeFile2(filePath, markdown, "utf-8");
+    await writeFile3(filePath, markdown, "utf-8");
   }
   /**
    * Delete a command
@@ -15535,7 +15924,25 @@ var buildStructuredContentFromEvents = (events, fallbackContent) => {
     if (event.type === "message" && event.role === "assistant" && typeof event.content === "string") {
       const assistantBlocks = parseAssistantContentBlocks(event.content);
       if (assistantBlocks && assistantBlocks.length > 0) {
-        return JSON.stringify(assistantBlocks);
+        const toolResultBlocks = [];
+        for (const ev of events) {
+          if (ev.type === "message" && ev.role === "tool" && typeof ev.content === "string") {
+            try {
+              const parsed = JSON.parse(ev.content.trim());
+              if (Array.isArray(parsed)) {
+                for (const item of parsed) {
+                  if (item && typeof item === "object" && "type" in item && item.type === "tool-result") {
+                    toolResultBlocks.push(item);
+                  }
+                }
+              } else if (parsed && typeof parsed === "object" && "type" in parsed && parsed.type === "tool-result") {
+                toolResultBlocks.push(parsed);
+              }
+            } catch {
+            }
+          }
+        }
+        return JSON.stringify([...assistantBlocks, ...toolResultBlocks]);
       }
     }
   }
@@ -15659,7 +16066,7 @@ async function handleListThreadFiles(c, threadManager) {
 }
 
 // src/features/threads/threads-explorer.route.ts
-import { readdir as readdir11, readFile as readFile13, rename as rename2, writeFile as writeFile3, mkdir as mkdir5, rm as rm5, access as access4 } from "fs/promises";
+import { readdir as readdir11, readFile as readFile13, rename as rename2, writeFile as writeFile4, mkdir as mkdir5, rm as rm5, access as access4 } from "fs/promises";
 import { join as join23 } from "path";
 import { spawn as spawn2 } from "child_process";
 var Utils3 = null;
@@ -15857,7 +16264,7 @@ async function handleCreateExplorerFile(c, threadManager) {
       absParent = validated;
     }
     await mkdir5(absParent, { recursive: true });
-    await writeFile3(join23(absParent, name), "", "utf-8");
+    await writeFile4(join23(absParent, name), "", "utf-8");
     const relPath = dirPath ? `${dirPath}/${name}` : name;
     return c.json({ success: true, path: relPath });
   } catch (error) {
@@ -16124,12 +16531,12 @@ async function handleFixComments(c, threadManager) {
 }
 
 // src/features/threads/threads-ai-files.route.ts
-import { readFile as readFile14, writeFile as writeFile5, mkdir as mkdir7, access as access5, rm as rm6 } from "fs/promises";
+import { readFile as readFile14, writeFile as writeFile6, mkdir as mkdir7, access as access5, rm as rm6 } from "fs/promises";
 import { join as join26 } from "path";
 import { existsSync as existsSync15 } from "fs";
 
 // src/features/git/git-download-folder.ts
-import { mkdir as mkdir6, writeFile as writeFile4 } from "fs/promises";
+import { mkdir as mkdir6, writeFile as writeFile5 } from "fs/promises";
 import { join as join25, dirname as dirname4 } from "path";
 async function downloadGithubFolder(repoUrl, srcPath, destPath, options = {}) {
   const { token, ref } = options;
@@ -16175,7 +16582,7 @@ async function downloadGithubFolder(repoUrl, srcPath, destPath, options = {}) {
       }
       let content = Buffer.from(await fileRes.arrayBuffer()).toString("utf8");
       content = content.replace(/Claude/gi, "Tarsk");
-      await writeFile4(localPath, content, "utf8");
+      await writeFile5(localPath, content, "utf8");
       console.log(`  \u2713 ${relativePath}`);
     })
   );
@@ -16298,7 +16705,7 @@ async function handleSaveThreadAIFile(c, threadManager) {
     }
     const parentDir = join26(absPath, "..");
     await mkdir7(parentDir, { recursive: true });
-    await writeFile5(absPath, content, "utf-8");
+    await writeFile6(absPath, content, "utf-8");
     return c.json({ success: true, path: filePath });
   } catch (error) {
     return errorResponse(
@@ -16399,7 +16806,7 @@ description: ${description}${toolsLine}
 
 Place your agent system prompt here as markdown. This will be used as the system prompt when this agent is invoked as a subagent.
 `;
-    await writeFile5(agentFileAbsPath, agentContent, "utf-8");
+    await writeFile6(agentFileAbsPath, agentContent, "utf-8");
     return c.json({
       success: true,
       path: agentFileRelPath,
@@ -16464,7 +16871,7 @@ description: ${description}
 
 Place your skill instructions here as markdown. This will be used when Tarsk is prompted with a request related to the description of this skill.
 `;
-    await writeFile5(skillFileAbsPath, skillContent, "utf-8");
+    await writeFile6(skillFileAbsPath, skillContent, "utf-8");
     return c.json({
       success: true,
       path: skillFileRelPath,
@@ -19833,7 +20240,7 @@ function createUpdateRoutes(updater) {
 
 // src/features/mcp/mcp.routes.ts
 import { Hono as Hono13 } from "hono";
-import { readFile as readFile15, writeFile as writeFile6, mkdir as mkdir9, access as access6 } from "fs/promises";
+import { readFile as readFile15, writeFile as writeFile7, mkdir as mkdir9, access as access6 } from "fs/promises";
 import { join as join28, dirname as dirname6 } from "path";
 
 // src/features/mcp/mcp.popular.json
@@ -19961,7 +20368,7 @@ async function writeMCPConfig(projectPath, config) {
   const existing = await readMCPConfig(projectPath);
   const targetPath = existing?.filePath ?? join28(projectPath, ".agents/mcp.json");
   await mkdir9(dirname6(targetPath), { recursive: true });
-  await writeFile6(targetPath, JSON.stringify(config, null, 2), "utf-8");
+  await writeFile7(targetPath, JSON.stringify(config, null, 2), "utf-8");
 }
 function createMCPRoutes() {
   const router = new Hono13();