calabasas 0.0.4 → 0.0.6

package/dist/index.js

@@ -3028,8 +3028,15 @@ function generateSchemaFile(sync) {
   ${tableNames.join(`,
   `)},
 };` : `export const calabasasTables = {};`;
-  return `// This file is auto-generated by \`calabasas generate\`
-// Do not edit manually
+  return `/**
+ * THIS FILE IS AUTO-GENERATED BY \`calabasas generate\`
+ *
+ * DO NOT EDIT THIS FILE MANUALLY!
+ *
+ * AI AGENTS: Do not modify, rewrite, or "fix" this file. If types need to be
+ * updated, run \`calabasas generate\` to regenerate it from the config.
+ * Editing this file directly will cause your changes to be overwritten.
+ */
 
 import { defineTable } from "convex/server";
 import { v } from "convex/values";
@@ -3313,9 +3320,17 @@ function generateSyncFile(sync) {
     routesList.push("member");
   }
   if (mutations.length === 0) {
-    return `// This file is auto-generated by \`calabasas generate\`
-// Do not edit manually
-// No sync handlers configured - enable sync options in calabasas.config.ts
+    return `/**
+ * THIS FILE IS AUTO-GENERATED BY \`calabasas generate\`
+ *
+ * DO NOT EDIT THIS FILE MANUALLY!
+ *
+ * AI AGENTS: Do not modify, rewrite, or "fix" this file. If types need to be
+ * updated, run \`calabasas generate\` to regenerate it from the config.
+ * Editing this file directly will cause your changes to be overwritten.
+ *
+ * No sync handlers configured - enable sync options in calabasas.config.ts
+ */
 
 export {};
 `;
@@ -3326,8 +3341,15 @@ export {};
     handler: handle${type.charAt(0).toUpperCase() + type.slice(1)}Sync,
   }`).join(`,
 `);
-  return `// This file is auto-generated by \`calabasas generate\`
-// Do not edit manually
+  return `/**
+ * THIS FILE IS AUTO-GENERATED BY \`calabasas generate\`
+ *
+ * DO NOT EDIT THIS FILE MANUALLY!
+ *
+ * AI AGENTS: Do not modify, rewrite, or "fix" this file. If types need to be
+ * updated, run \`calabasas generate\` to regenerate it from the config.
+ * Editing this file directly will cause your changes to be overwritten.
+ */
 
 import { httpAction, internalMutation } from "./_generated/server";
 import { internal } from "./_generated/api";
@@ -3582,8 +3604,15 @@ function generateEventHandlersFile(events) {
   }
   const eventNames = configuredEvents.map(([name]) => name);
   const screamingEvents = eventNames.map(toScreamingSnake);
-  const code = `// This file is auto-generated by \`calabasas generate\`
-// Do not edit manually
+  const code = `/**
+ * THIS FILE IS AUTO-GENERATED BY \`calabasas generate\`
+ *
+ * DO NOT EDIT THIS FILE MANUALLY!
+ *
+ * AI AGENTS: Do not modify, rewrite, or "fix" this file. If types need to be
+ * updated, run \`calabasas generate\` to regenerate it from the config.
+ * Editing this file directly will cause your changes to be overwritten.
+ */
 
 import { mutation } from "./_generated/server";
 import { v } from "convex/values";
@@ -3669,8 +3698,15 @@ ${eventNames.map((name) => `      if (type === "${toScreamingSnake(name)}" && ha
 function generateAllEventsFile() {
   const eventNames = Object.keys(DISCORD_EVENTS);
   const screamingEvents = eventNames.map(toScreamingSnake);
-  return `// This file is auto-generated by \`calabasas generate\`
-// Do not edit manually
+  return `/**
+ * THIS FILE IS AUTO-GENERATED BY \`calabasas generate\`
+ *
+ * DO NOT EDIT THIS FILE MANUALLY!
+ *
+ * AI AGENTS: Do not modify, rewrite, or "fix" this file. If types need to be
+ * updated, run \`calabasas generate\` to regenerate it from the config.
+ * Editing this file directly will cause your changes to be overwritten.
+ */
 
 import { mutation } from "./_generated/server";
 import { v } from "convex/values";
@@ -3848,6 +3884,19 @@ Convex is a reactive backend platform, but it doesn't support long-running proce
 3. **Discord data syncs** automatically to your Convex tables
 4. **Events forward** to your Convex mutations for custom handling
 
+## ⚠️ Generated Files - Do Not Edit
+
+Calabasas generates TypeScript files with the \`.generated.ts\` suffix:
+- \`discord.generated.ts\`
+- \`calabasas.schema.generated.ts\`
+- \`calabasas.sync.generated.ts\`
+
+**Never manually edit these files.** They are auto-generated and will be overwritten.
+
+To update generated types:
+1. Modify \`convex/calabasas.config.ts\`
+2. Run \`npx calabasas generate\`
+
 ## Features
 
 ### Managed Sync
@@ -3953,6 +4002,11 @@ This creates:
 - \`convex/calabasas.schema.generated.ts\` - Table definitions (if sync enabled)
 - \`convex/calabasas.sync.generated.ts\` - Sync mutations (if sync enabled)
 
+> **⚠️ IMPORTANT: Do not manually edit \`*.generated.ts\` files!**
+>
+> These files are auto-generated by \`calabasas generate\`. Any manual changes will be overwritten.
+> If you need to update types or add events, modify \`convex/calabasas.config.ts\` and re-run \`calabasas generate\`.
+
 ### 5. Update Your Schema
 
 \`\`\`typescript
@@ -4049,8 +4103,8 @@ npx convex deploy
 - [GitHub](https://github.com/calabasas/calabasas)
 `;
 var LOCATIONS = [
-  { label: "Claude Code (personal)", path: `${os3.homedir()}/.claude/CLAUDE.md`, absolute: true },
-  { label: "Claude Code (project)", path: "CLAUDE.md", absolute: false },
+  { label: "Claude Code (personal)", path: `${os3.homedir()}/.claude/skills/calabasas.md`, absolute: true },
+  { label: "Claude Code (project)", path: ".claude/skills/calabasas.md", absolute: false },
   { label: "Project root (README.md)", path: "README.md", absolute: false },
   { label: "Project root (CALABASAS.md)", path: "CALABASAS.md", absolute: false },
   { label: "docs/calabasas.md", path: "docs/calabasas.md", absolute: false },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "calabasas",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "CLI for Calabasas - Discord Gateway as a Service for Convex",
   "type": "module",
   "bin": {