@wix/ditto-codegen-public 1.0.272 → 1.0.274

package/dist/opencode-tools/batch-read.ts

@@ -0,0 +1,28 @@
+import { tool } from "@opencode-ai/plugin";
+import { readFile } from "fs/promises";
+import { join, isAbsolute } from "path";
+
+export default tool({
+  description:
+    "Read multiple files at once and return their contents. " +
+    "Use this instead of calling read multiple times sequentially.",
+  args: {
+    paths: tool.schema
+      .array(tool.schema.string())
+      .describe("Array of file paths (relative to project root) to read"),
+  },
+  async execute(args, context) {
+    const results: string[] = [];
+    for (const filePath of args.paths) {
+      const fullPath = isAbsolute(filePath) ? filePath : join(context.directory, filePath);
+      try {
+        const content = await readFile(fullPath, "utf-8");
+        results.push(`--- ${filePath} ---\n${content}`);
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        results.push(`--- ${filePath} ---\nERROR: ${msg}`);
+      }
+    }
+    return results.join("\n\n");
+  },
+});

package/dist/opencode-tools/batch-write.ts

@@ -0,0 +1,38 @@
+import { tool } from "@opencode-ai/plugin";
+import { writeFile, mkdir } from "fs/promises";
+import { join, dirname, isAbsolute } from "path";
+
+export default tool({
+  description:
+    "Write multiple files at once. Creates directories as needed. " +
+    "Use this instead of calling write/edit multiple times for new files.",
+  args: {
+    files: tool.schema
+      .array(
+        tool.schema.object({
+          path: tool.schema
+            .string()
+            .describe("File path relative to project root"),
+          content: tool.schema.string().describe("Full file content"),
+        }),
+      )
+      .describe("Array of { path, content } objects to write"),
+  },
+  async execute(args, context) {
+    const results: string[] = [];
+    for (const f of args.files) {
+      const fullPath = isAbsolute(f.path)
+        ? f.path
+        : join(context.directory, f.path);
+      try {
+        await mkdir(dirname(fullPath), { recursive: true });
+        await writeFile(fullPath, f.content, "utf-8");
+        results.push(`OK: ${f.path}`);
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        results.push(`FAILED: ${f.path} - ${msg}`);
+      }
+    }
+    return results.join("\n");
+  },
+});

package/dist/opencode-tools/uuid.ts

@@ -0,0 +1,19 @@
+import { tool } from "@opencode-ai/plugin";
+import { randomUUID } from "crypto";
+
+export default tool({
+  description:
+    "Generate one or more UUID v4s. Use this instead of bash commands. " +
+    "Set count to generate multiple UUIDs in a single call.",
+  args: {
+    count: tool.schema
+      .number()
+      .min(1)
+      .max(10)
+      .default(1)
+      .describe("Number of UUIDs to generate."),
+  },
+  async execute(args) {
+    return Array.from({ length: args.count }, () => randomUUID()).join("\n");
+  },
+});

package/dist/opencode-tools/validate.ts

@@ -0,0 +1,51 @@
+import { tool } from "@opencode-ai/plugin";
+
+export default tool({
+  description:
+    "Run full project validation: install deps (if needed), TypeScript check, and build. " +
+    "Use this instead of running npm install, tsc, and wix build separately.",
+  args: {
+    installDeps: tool.schema
+      .boolean()
+      .optional()
+      .describe(
+        "Run npm install first (default: false, set true if you added new deps)",
+      ),
+  },
+  async execute(args, context) {
+    const steps: string[] = [];
+    const cwd = context.directory;
+
+    if (args.installDeps) {
+      const install = await Bun.$`npm install`.cwd(cwd).nothrow().quiet();
+      if (install.exitCode !== 0) {
+        return `FAILED at npm install (exit ${install.exitCode}):\n${install.stderr.toString()}`;
+      }
+      steps.push("npm install: OK");
+    }
+
+    const tsc = await Bun.$`npx tsc --noEmit`.cwd(cwd).nothrow().quiet();
+    if (tsc.exitCode !== 0) {
+      return [
+        ...steps,
+        `FAILED at tsc --noEmit (exit ${tsc.exitCode}):`,
+        tsc.stdout.toString(),
+        tsc.stderr.toString(),
+      ].join("\n");
+    }
+    steps.push("tsc --noEmit: OK");
+
+    const build = await Bun.$`npx wix build`.cwd(cwd).nothrow().quiet();
+    if (build.exitCode !== 0) {
+      return [
+        ...steps,
+        `FAILED at wix build (exit ${build.exitCode}):`,
+        build.stdout.toString(),
+        build.stderr.toString(),
+      ].join("\n");
+    }
+    steps.push("wix build: OK");
+
+    return steps.join("\n");
+  },
+});

package/dist/opencode-tools/wds-lookup.ts

@@ -0,0 +1,134 @@
+import { tool } from "@opencode-ai/plugin";
+import { readFile, readdir } from "fs/promises";
+import { join } from "path";
+const MAX_EXAMPLE_LINES = 80;
+
+const stripBlankLines = (s: string): string =>
+  s.split("\n").filter((l) => l.trim().length > 0).join("\n");
+
+function parseComponentNames(files: string[]): string[] {
+  const names = new Set<string>();
+  for (const f of files) {
+    const m = f.match(/^(.+?)(Props|Examples)\.md$/);
+    if (m) names.add(m[1]);
+  }
+  return [...names].sort();
+}
+
+function trimExamples(raw: string): string {
+  const lines = raw.split("\n");
+  const headers: number[] = [];
+  lines.forEach((l, i) => {
+    if (l.startsWith("### ")) headers.push(i);
+  });
+  const end =
+    headers.length > 2
+      ? headers[2]
+      : Math.min(lines.length, MAX_EXAMPLE_LINES);
+  return lines.slice(0, end).join("\n");
+}
+
+export default tool({
+  description:
+    "Look up Wix Design System (WDS) component props, examples, and icons. " +
+    "Use this INSTEAD of the wds-docs skill. " +
+    "Pass component names to get their props (lightweight). " +
+    "Pass example names ONLY for complex components where you need usage patterns. " +
+    "Set listAll/listIcons to discover available components/icons. " +
+    "Combine all in one call. NEVER look up the same component twice.",
+  args: {
+    listAll: tool.schema
+      .boolean()
+      .optional()
+      .describe("List all available WDS component names."),
+    components: tool.schema
+      .array(tool.schema.string())
+      .optional()
+      .describe(
+        "Component names to get PROPS for, e.g. ['Table', 'Input'].",
+      ),
+    examples: tool.schema
+      .array(tool.schema.string())
+      .optional()
+      .describe(
+        "Component names to get EXAMPLES for. Only use for complex/unfamiliar components.",
+      ),
+    listIcons: tool.schema
+      .boolean()
+      .optional()
+      .describe("List all available WDS icon names."),
+  },
+  async execute(args, context) {
+    const docsPath = join(
+      context.directory,
+      "node_modules",
+      "@wix",
+      "design-system",
+      "dist",
+      "docs",
+    );
+    const compsDir = join(docsPath, "components");
+    const sections: string[] = [];
+
+    if (args.listAll) {
+      try {
+        const files = await readdir(compsDir);
+        const names = parseComponentNames(files);
+        sections.push(
+          `## Available WDS Components (${names.length})\n${names.join(", ")}`,
+        );
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        sections.push(`ERROR listing components: ${msg}`);
+      }
+    }
+
+    if (args.components?.length) {
+      for (const comp of args.components) {
+        try {
+          const raw = await readFile(
+            join(compsDir, `${comp}Props.md`),
+            "utf-8",
+          );
+          sections.push(`## ${comp} Props\n${raw}`);
+        } catch {
+          sections.push(`## ${comp} Props\nNot found: ${comp}Props.md`);
+        }
+      }
+    }
+
+    if (args.examples?.length) {
+      for (const comp of args.examples) {
+        try {
+          const raw = await readFile(
+            join(compsDir, `${comp}Examples.md`),
+            "utf-8",
+          );
+          sections.push(`## ${comp} Examples\n${trimExamples(raw)}`);
+        } catch {
+          sections.push(`## ${comp} Examples\nNot found: ${comp}Examples.md`);
+        }
+      }
+    }
+
+    if (args.listIcons) {
+      try {
+        const iconsMd = await readFile(join(docsPath, "icons.md"), "utf-8");
+        sections.push(iconsMd);
+      } catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        sections.push(`ERROR reading icons.md: ${msg}`);
+      }
+    }
+
+    if (!sections.length) {
+      return "No query provided. Pass listAll, components, examples, or listIcons.";
+    }
+
+    return stripBlankLines(
+      "IMPORTS: Components from '@wix/design-system', icons from '@wix/wix-ui-icons-common'.\n" +
+      "CSS: import '@wix/design-system/styles.global.css';\n\n" +
+      sections.join("\n\n"),
+    );
+  },
+});

package/dist/out.js

@@ -11422,62 +11422,11 @@ var require_codegen_prompt = __commonJS({
     exports2.buildIterationPrompt = buildIterationPrompt;
     exports2.buildRecoveryPrompt = buildRecoveryPrompt;
     var prompt_utils_1 = require_prompt_utils();
-    var BASE_PROMPT_INSTRUCTIONS = `CORE PRINCIPLES:
-- Do NOT invent or assume new types, modules, functions, props, events, or imports
-- NEVER use mocks, placeholders, debugging, or TODOs in any code
-- ALWAYS implement complete, production-ready functionality
-- Follow Wix patterns and best practices precisely
-- Handle all edge cases and error scenarios appropriately
-
-IMPORTANT INSTRUCTIONS:
-- NEVER run preview, dev, release, or promote commands. Preview/deployment is handled separately.
-- You MUST run \`npm install\` when you are adding new dependencies to package.json.
-- You SHOULD run \`npx tsc --noEmit\` to check for TypeScript errors after generating code.
-- You SHOULD run \`npm run build\` or \`wix build\` to verify the build succeeds.
-- CRITICAL: After creating any new extension (dashboard page, widget, embedded script, etc.), you MUST update \`src/extensions.ts\` to register it. Every extension needs to be exported from this file or it won't work.
-- UUID GENERATION: To generate UUIDs, use Node.js: \`node -e "console.log(require('crypto').randomUUID())"\`. Do NOT use \`uuidgen\` as it may not be installed.
-
-TYPESCRIPT ENVIRONMENT:
-- The project extends \`astro/tsconfigs/base\` which enables \`verbatimModuleSyntax\`. Type-only imports MUST use the \`type\` keyword (e.g. \`import type { MyType } from './types';\`).
-
-EFFICIENCY - AVOID UNNECESSARY FIX CYCLES:
-- Once validation (tsc + build) passes, do NOT refactor or "clean up" code. Move on immediately.
-- When fixing multiple occurrences of the same pattern, use a single edit that covers all instances instead of separate edits for each occurrence.
-
-FILE CREATION - CRITICAL RULES:
-- NEVER rewrite the same file twice. Once a file is written successfully, move on to the next file immediately.
-
-OUTPUT SIZE LIMITS - CRITICAL:
-- Keep each file under 200 lines. If a component would be larger, split it into multiple files (e.g., separate types.ts, utils.ts, styles).
-- Do NOT output excessive comments or documentation in code.
-- When writing a file, write it IMMEDIATELY after deciding to create it. Do not repeat "Now let me create..." multiple times - just create it.
-- If you find yourself repeating the same text without making progress, STOP and write the file with whatever content you have ready.
-
-PERMISSIONS REQUIREMENT:
-At the end of your response, output the required Wix app permissions as a JSON block.
-Use the SCOPE ID format (not human-readable names). Examples:
-- \`@wix/data\` read operations (query, get) require "SCOPE.DC-DATA.READ"
-- \`@wix/data\` write operations (insert, update, remove) require "SCOPE.DC-DATA.WRITE"
-- Embedded scripts require "SCOPE.DC-APPS.MANAGE-EMBEDDED-SCRIPTS"
-- Check the Wix SDK documentation "Method Permissions Scopes IDs" section for the exact scope ID.
-
-IMPORTANT: Use scope IDs like "SCOPE.DC-DATA.READ", NOT human-readable names like "Read Data Items".
-
-Use this exact format (no newlines inside the array):
-
-\`\`\`json:required-permissions
-["SCOPE.DC-DATA.READ", "SCOPE.DC-DATA.WRITE"]
-\`\`\`
-
-If no permissions are required, output an empty array:
-\`\`\`json:required-permissions
-[]
-\`\`\``;
     function buildPrompt(...sections) {
-      return [...sections, (0, prompt_utils_1.buildAppContext)(), BASE_PROMPT_INSTRUCTIONS].filter(Boolean).join("\n\n");
+      return [...sections, (0, prompt_utils_1.buildAppContext)()].filter(Boolean).join("\n\n");
     }
     function buildInitPrompt(blueprint, history) {
-      const blueprintJson = JSON.stringify({ blueprint }, null, 2);
+      const blueprintJson = JSON.stringify({ blueprint });
       return buildPrompt(`Generate the extensions from this blueprint.
 
 ${blueprintJson}`, (0, prompt_utils_1.formatChatHistory)(history, "CONVERSATION HISTORY"));
@@ -11531,29 +11480,15 @@ var require_ask_prompt = __commonJS({
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.buildAskPrompt = buildAskPrompt;
     var prompt_utils_1 = require_prompt_utils();
-    var ASK_PROMPT_INSTRUCTIONS = `CORE PRINCIPLES:
-- You are a READ-ONLY assistant. You MUST NOT modify, create, or delete any files.
-- Your job is to answer questions about the codebase and Wix platform by reading code and fetching documentation.
-- Use the read tool to explore the codebase and find relevant code.
-- Use the wix-mcp tools to fetch Wix SDK/API documentation when needed.
-- Provide clear, accurate, and well-structured answers.
-
-IMPORTANT INSTRUCTIONS:
-1. Do NOT edit, write, or create any files.
-2. Do NOT run any bash commands.
-3. READ the codebase to understand the code structure and find answers.
-4. Use MCP tools to look up Wix documentation when the question involves Wix APIs, SDKs, or platform features.
-5. If you cannot find a definitive answer, say so clearly and explain what you found.`;
     function buildAskPrompt(chatHistory) {
       const { currentUserRequest } = (0, prompt_utils_1.extractUserRequestAndFilteredHistory)(chatHistory);
       if (!currentUserRequest) {
-        return [ASK_PROMPT_INSTRUCTIONS, (0, prompt_utils_1.buildAppContext)()].filter(Boolean).join("\n\n");
+        return (0, prompt_utils_1.buildAppContext)() || "Answer questions about the codebase and Wix platform.";
       }
       const recentHistory = chatHistory.slice(-5);
       const sections = [
         `QUESTION: "${currentUserRequest}"`,
         (0, prompt_utils_1.formatChatHistory)(recentHistory, "CONVERSATION CONTEXT"),
-        ASK_PROMPT_INSTRUCTIONS,
         (0, prompt_utils_1.buildAppContext)()
       ];
       return sections.filter(Boolean).join("\n\n");
@@ -11612,8 +11547,18 @@ var require_constants5 = __commonJS({
       }
       return null;
     }
-    exports2.CODE_SEARCH_TOOLS = /* @__PURE__ */ new Set(["read", "grep", "glob", "list"]);
-    exports2.WRITE_TOOLS = /* @__PURE__ */ new Set(["write", "edit"]);
+    exports2.CODE_SEARCH_TOOLS = /* @__PURE__ */ new Set([
+      "read",
+      "grep",
+      "glob",
+      "list",
+      "batch-read"
+    ]);
+    exports2.WRITE_TOOLS = /* @__PURE__ */ new Set([
+      "write",
+      "edit",
+      "batch-write"
+    ]);
     exports2.BUILDER_TO_EXTENSION_LABEL = {
       dashboardPage: "dashboard page",
       dashboardModal: "dashboard modal",
@@ -11673,6 +11618,286 @@ var require_constants5 = __commonJS({
   }
 });
 
+// dist/opencode-integration/rules/orchestrator-rules.js
+var require_orchestrator_rules = __commonJS({
+  "dist/opencode-integration/rules/orchestrator-rules.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.ORCHESTRATOR_RULES = void 0;
+    exports2.ORCHESTRATOR_RULES = `# Wix CLI Extension Orchestrator
+
+## Quick Decision Helper
+
+Answer these questions to find the right extension:
+
+1. **What are you trying to build?**
+   - Admin interface \u2192 Dashboard Extensions
+   - Backend logic \u2192 Backend Extensions
+   - Data storage / CMS collections \u2192 Data Collection
+   - Site component \u2192 Site Extensions (app projects only)
+
+2. **Who will see it?**
+   - Admin users only \u2192 Dashboard Extensions
+   - Site visitors \u2192 Site Extensions
+   - Server-side only \u2192 Backend Extensions
+
+3. **Where will it appear?**
+   - Dashboard sidebar/page \u2192 Dashboard Page or Modal
+   - Existing Wix app dashboard (widget) \u2192 Dashboard Plugin
+   - Existing Wix app dashboard (menu item) \u2192 Dashboard Menu Plugin
+   - Anywhere on site \u2192 Site Widget
+   - Anywhere on site (with editor manifest) \u2192 Site Component
+   - Wix business solution page \u2192 Site Plugin
+   - During business flow \u2192 Service Plugin
+   - After event occurs \u2192 Event Extension
+
+## Decision Flow
+
+- **Admin:** Need full-page UI? \u2192 Dashboard Page. Need popup/form? \u2192 Dashboard Modal. Extending Wix app dashboard with a visual widget? \u2192 Dashboard Plugin. Adding a menu item to a Wix app dashboard's more-actions or bulk-actions menu? \u2192 Dashboard Menu Plugin. **Modal constraint:** Dashboard Pages cannot use \`<Modal />\`; use a separate Dashboard Modal extension and \`dashboard.openModal()\`.
+- **Backend:** During business flow (checkout/shipping/tax)? \u2192 Service Plugin. After event (webhooks/sync)? \u2192 Event Extension. Custom HTTP endpoints? \u2192 Backend Endpoints. Need CMS collections for app data? \u2192 Data Collection.
+- **Site:** User places anywhere (standalone)? \u2192 Site Widget. React component with editor manifest (styling, content, elements)? \u2192 Site Component. Fixed slot on Wix app page? \u2192 Site Plugin. Scripts/analytics only? \u2192 Embedded Script.
+
+## Extension Type \u2192 Skill Reference
+
+| Extension Type        | Category  | Visibility  | Use When                      | Skill                     |
+| --------------------- | --------- | ----------- | ----------------------------- | ------------------------- |
+| Dashboard Page        | Dashboard | Admin only  | Full admin pages              | \`wix-cli-dashboard-page\`   |
+| Dashboard Modal       | Dashboard | Admin only  | Popup dialogs                 | \`wix-cli-dashboard-modal\` |
+| Dashboard Plugin      | Dashboard | Admin only  | Extend Wix app dashboards     | \`wix-cli-dashboard-plugin\` |
+| Dashboard Menu Plugin | Dashboard | Admin only  | Add menu items to Wix app dashboards | \`wix-cli-dashboard-menu-plugin\` |
+| Service Plugin        | Backend   | Server-side | Customize business flows      | \`wix-cli-service-plugin\`   |
+| Event Extension       | Backend   | Server-side | React to events               | \`wix-cli-backend-event\`   |
+| Backend Endpoints     | Backend   | API         | Custom HTTP handlers          | \`wix-cli-backend-api\`     |
+| Data Collection       | Backend   | Data        | CMS collections for app data  | \`wix-cli-data-collection\` |
+| Site Component        | Site      | Public      | React components with editor manifests | \`wix-cli-site-component\`  |
+| Site Widget           | Site      | Public      | Standalone widgets            | \`wix-cli-site-widget\`     |
+| Site Plugin           | Site      | Public      | Extend Wix business solutions | \`wix-cli-site-plugin\`     |
+| Embedded Script       | Site      | Public      | Inject scripts/analytics      | \`wix-cli-embedded-script\` |
+
+| Site Widget vs Site Component vs Site Plugin | Dashboard Page vs Modal | Service Plugin vs Event |
+| -------------------------------------------- | ----------------------- | ----------------------- |
+| Widget: standalone interactive component. Component: React with editor manifest (CSS/data/elements). Plugin: fixed slot in Wix app page. | Page: full page. Modal: overlay; use for popups. | Service: during flow. Event: after event. |
+
+## Data Collection Inference
+
+**CRITICAL:** Data collections are often needed implicitly \u2014 don't wait for the user to explicitly say "create a CMS collection." Infer the need automatically.
+
+**Skip this section if the user provides a collection ID directly** (e.g., an existing site-level collection). In that case, use the provided ID as-is \u2014 no Data Collection extension or namespace scoping needed.
+
+**Always include a Data Collection extension when ANY of these are true:**
+
+| Indicator | Example |
+| --- | --- |
+| User mentions saving/storing/persisting app-specific data | "save the fee amount", "store product recommendations" |
+| A dashboard page will **manage** (CRUD) domain entities | "dashboard to manage fees", "admin page to edit rules" |
+| A service plugin reads app-configured data at runtime | "fetch fee rules at checkout", "look up shipping rates" |
+| User mentions "dedicated database/collection" | "save in a dedicated database collection" |
+| Multiple extensions reference the same custom data | Dashboard manages fees + service plugin reads fees |
+
+**Why this matters:** Without the Data Collection extension, the collection won't be created when the app is installed, the Wix Data APIs may not work (code editor not enabled), and collection IDs won't be properly scoped to the app namespace.
+
+When creating a Data Collection, the user MUST provide their app namespace from Wix Dev Center. Collection IDs must be scoped: \`<app-namespace>/<idSuffix>\` \u2014 pass the full ID to all extensions that reference the collection.
+
+## Wix Stores Versioning Requirement
+
+**Applies when ANY Wix Stores API is used** (products, inventory, orders, etc.):
+
+1. Load the \`wix-stores-versioning\` skill
+2. All Stores operations must check catalog version first using \`getCatalogVersion()\`
+3. Use the correct module based on version: \`productsV3\` (V3) vs \`products\` (V1)
+
+This is non-negotiable \u2014 V1 and V3 are NOT backwards compatible.
+
+## API Reference Discovery
+
+**Workflow: Check skill references first, use MCP only for gaps.**
+
+1. Identify required APIs from user requirements
+2. Check relevant reference files in the loaded skill
+3. ONLY use MCP if the API is NOT found in reference files
+
+**Platform APIs (always in skill references \u2014 skip MCP):**
+- Wix Data, Dashboard SDK, Event SDK (common events), Service Plugin SPIs
+
+**Vertical APIs (use MCP if needed):**
+- Wix Stores (\u26A0\uFE0F MUST use \`wix-stores-versioning\` skill), Wix Bookings, Wix Members, Wix Pricing Plans
+
+| User Requirement | MCP Needed? | Reason |
+| --- | --- | --- |
+| "Display store products" | \u2705 YES | Wix Stores API \u2014 also load \`wix-stores-versioning\` skill |
+| "Show booking calendar" | \u2705 YES | Wix Bookings API not in reference files |
+| "Send emails to users" | \u2705 YES | Wix Triggered Emails not in reference files |
+| "Get member info" | \u2705 YES | Wix Members API not in reference files |
+| "Listen for cart events" | Check \`COMMON-EVENTS.md\` | MCP only if event missing in reference |
+| "Store data in collection" | \u274C NO | Covered by \`WIX_DATA.md\` in skill refs |
+| "Show dashboard toast" | \u274C NO | Covered by \`DASHBOARD_API.md\` in skill refs |
+| "UI only (forms, inputs)" | \u274C NO | No external API needed |
+
+**MCP Tools to use for discovery:**
+- \`SearchWixSDKDocumentation\` - SDK methods and APIs (**Always use maxResults: 5**)
+- \`ReadFullDocsArticle\` - Full documentation when needed (only if search results need more detail)
+- \`ReadFullDocsMethodSchema\` - **Always call this** for any SDK method you plan to use. The schema is the source of truth for parameter shapes. Code examples may have incorrect call signatures.`;
+  }
+});
+
+// dist/opencode-integration/rules/codegen-rules.js
+var require_codegen_rules = __commonJS({
+  "dist/opencode-integration/rules/codegen-rules.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.CODEGEN_RULES = void 0;
+    exports2.CODEGEN_RULES = `CORE PRINCIPLES:
+- Do NOT invent or assume new types, modules, functions, props, events, or imports.
+- NEVER use mocks, placeholders, debugging, or TODOs in any code.
+- ALWAYS implement complete, production-ready functionality.
+
+MINIMIZE TEXT OUTPUT \u2014 CRITICAL:
+- Do NOT narrate your actions. No "Let me now...", "Perfect!", "Now I'll...", "Excellent!", "Great!".
+- Do NOT explain what you just did. The tool output speaks for itself.
+- Do NOT read back files you just wrote. Trust the write succeeded.
+- Every text token costs money. Use tools, not words.
+
+TOOL USAGE:
+- \`validate\` for all validation (tsc + build). Do NOT load the \`wix-cli-app-validation\` skill.
+- \`uuid\` to generate UUIDs (supports count param for multiple). Do NOT use bash.
+- \`wds-lookup\` for WDS component props, examples, and icons. Do NOT load the \`wds-docs\` skill.
+- \`batch-write\` to create new files. NEVER use \`write\` for new files (corrupts newlines).
+- \`batch-read\` to read multiple files at once.
+- \`multiedit\` to apply multiple edits across files. Use \`edit\` only for a single edit to one file.
+- Before calling MCP tools, check if loaded skills already cover the API. Only use MCP for gaps.
+- When using MCP to look up a Wix SDK method, ALWAYS call \`ReadFullDocsMethodSchema\` (not just \`ReadFullDocsArticle\`). The schema is the source of truth for parameter shapes. Code examples in docs may use incorrect call signatures.
+- NEVER run preview, dev, release, or promote commands.
+
+IMPLEMENTATION WORKFLOW:
+1. **Plan**: Determine extension types using the orchestrator rule. Generate ALL UUIDs upfront.
+2. **Load skills**: Load ALL needed extension skills + call \`wds-lookup\` \u2014 all in a SINGLE step.
+3. **Build**: Create each extension using \`batch-write\`. Build all extensions before registering.
+4. **Register**: Register all extensions in \`src/extensions.ts\`.
+5. **Validate**: Run \`validate\` with installDeps: true ONCE. Fix any errors and re-validate.
+6. **Stop**: Once validation passes, STOP. Do NOT refactor, clean up, or verify.
+
+EFFICIENCY:
+- Batch ALL tool calls that can run in parallel into the same step.
+- Use \`multiedit\` to fix multiple errors at once.
+
+FILE CREATION:
+- NEVER rewrite the same file twice. Once written, move on.
+- Keep each file under 200 lines. Split into types.ts, utils.ts if needed.
+- Do NOT output comments in code unless they explain non-obvious logic.
+
+TYPESCRIPT:
+- The project enables \`verbatimModuleSyntax\`. Type-only imports MUST use \`import type\`.
+
+PERMISSIONS:
+At the end of your response, output the required Wix app permissions as a JSON block.
+Use SCOPE ID format (not human-readable names). Examples:
+- \`@wix/data\` read \u2192 "SCOPE.DC-DATA.READ", write \u2192 "SCOPE.DC-DATA.WRITE"
+- Embedded scripts \u2192 "SCOPE.DC-APPS.MANAGE-EMBEDDED-SCRIPTS"
+
+\`\`\`json:required-permissions
+["SCOPE.DC-DATA.READ", "SCOPE.DC-DATA.WRITE"]
+\`\`\`
+
+If no permissions are required, output an empty array:
+\`\`\`json:required-permissions
+[]
+\`\`\``;
+  }
+});
+
+// dist/opencode-integration/rules/ask-rules.js
+var require_ask_rules = __commonJS({
+  "dist/opencode-integration/rules/ask-rules.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.ASK_RULES = void 0;
+    exports2.ASK_RULES = `CORE PRINCIPLES:
+- You are a READ-ONLY assistant. You MUST NOT modify, create, or delete any files.
+- Your job is to answer questions about the codebase and Wix platform by reading code and fetching documentation.
+- Use the read tool to explore the codebase and find relevant code.
+- Use the wix-mcp tools to fetch Wix SDK/API documentation when needed.
+- Provide clear, accurate, and well-structured answers.
+
+IMPORTANT INSTRUCTIONS:
+1. Do NOT edit, write, or create any files.
+2. Do NOT run any bash commands.
+3. READ the codebase to understand the code structure and find answers.
+4. Use MCP tools to look up Wix documentation when the question involves Wix APIs, SDKs, or platform features.
+5. If you cannot find a definitive answer, say so clearly and explain what you found.`;
+  }
+});
+
+// dist/opencode-integration/rules-writer.js
+var require_rules_writer = __commonJS({
+  "dist/opencode-integration/rules-writer.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.ASK_RULES_PATH = exports2.ORCHESTRATOR_RULES_PATH = exports2.CODEGEN_RULES_PATH = void 0;
+    exports2.writeRuleFiles = writeRuleFiles;
+    var promises_1 = require("fs/promises");
+    var os_1 = require("os");
+    var path_1 = require("path");
+    var orchestrator_rules_1 = require_orchestrator_rules();
+    var codegen_rules_1 = require_codegen_rules();
+    var ask_rules_1 = require_ask_rules();
+    var logger_12 = require_logger();
+    var GLOBAL_RULES_DIR = (0, path_1.join)((0, os_1.homedir)(), ".config", "opencode", "rules");
+    exports2.CODEGEN_RULES_PATH = (0, path_1.join)(GLOBAL_RULES_DIR, "codegen-instructions.md");
+    exports2.ORCHESTRATOR_RULES_PATH = (0, path_1.join)(GLOBAL_RULES_DIR, "orchestrator.md");
+    exports2.ASK_RULES_PATH = (0, path_1.join)(GLOBAL_RULES_DIR, "ask-instructions.md");
+    async function writeRuleFiles() {
+      await (0, promises_1.mkdir)(GLOBAL_RULES_DIR, { recursive: true });
+      await Promise.all([
+        (0, promises_1.writeFile)(exports2.CODEGEN_RULES_PATH, codegen_rules_1.CODEGEN_RULES, "utf-8"),
+        (0, promises_1.writeFile)(exports2.ORCHESTRATOR_RULES_PATH, orchestrator_rules_1.ORCHESTRATOR_RULES, "utf-8"),
+        (0, promises_1.writeFile)(exports2.ASK_RULES_PATH, ask_rules_1.ASK_RULES, "utf-8")
+      ]);
+      logger_12.logger.info("[OpenCode] Wrote global rule files", { dir: GLOBAL_RULES_DIR });
+    }
+  }
+});
+
+// dist/experiments.js
+var require_experiments = __commonJS({
+  "dist/experiments.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.isExperimentEnabled = isExperimentEnabled;
+    exports2.isUserDecisionsEnabled = isUserDecisionsEnabled;
+    exports2.isUseWixAiGatewayEnabled = isUseWixAiGatewayEnabled;
+    var logger_12 = require_logger();
+    var parsedExperiments = null;
+    function getExperiments() {
+      if (parsedExperiments !== null) {
+        return parsedExperiments;
+      }
+      const raw = process.env.CODEGEN_EXPERIMENTS;
+      if (!raw) {
+        parsedExperiments = {};
+        return parsedExperiments;
+      }
+      try {
+        parsedExperiments = JSON.parse(raw);
+      } catch (error) {
+        logger_12.logger.error("[Experiments] Failed to parse CODEGEN_EXPERIMENTS", {
+          error: error instanceof Error ? error.message : String(error)
+        });
+        parsedExperiments = {};
+      }
+      return parsedExperiments;
+    }
+    function isExperimentEnabled(specName) {
+      return getExperiments()[specName] === "true";
+    }
+    function isUserDecisionsEnabled() {
+      return isExperimentEnabled("specs.ditto.CodegenUserDecisions");
+    }
+    function isUseWixAiGatewayEnabled() {
+      return isExperimentEnabled("specs.ditto.CodegenUseWixAiGateway");
+    }
+  }
+});
+
 // dist/opencode-integration/config.js
 var require_config = __commonJS({
   "dist/opencode-integration/config.js"(exports2) {
@@ -11684,10 +11909,15 @@ var require_config = __commonJS({
     exports2.getOpenCodeAskEnv = getOpenCodeAskEnv;
     var os_1 = require("os");
     var constants_1 = require_constants5();
+    var rules_writer_12 = require_rules_writer();
+    var experiments_1 = require_experiments();
     exports2.DEFAULT_TIMEOUT_MS = 20 * 60 * 1e3;
     exports2.DEFAULT_MODEL = "anthropic/claude-sonnet-4-6";
     var AI_PROXY_BASE_URL = process.env.CODEGEN_AI_PROXY_BASE_URL || "http://localhost:3001";
     function getAnthropicBaseUrl(projectId) {
+      if ((0, experiments_1.isUseWixAiGatewayEnabled)()) {
+        return `${AI_PROXY_BASE_URL}/projects/${projectId}/wix-ai-gateway/anthropic`;
+      }
       return `${AI_PROXY_BASE_URL}/projects/${projectId}/anthropic`;
     }
     function getProviderConfig() {
@@ -11721,33 +11951,34 @@ var require_config = __commonJS({
         model: exports2.DEFAULT_MODEL,
         provider: getProviderConfig(),
         permission: {
-          edit: "allow",
-          // NOTE: Per-command deny patterns are unreliable — opencode may
-          // ignore them or fail to match compound commands (e.g. `cd /path && npx wix preview`).
-          // See: https://github.com/anomalyco/opencode/issues/16331
-          // Primary blocking is enforced via the system prompt and validation skill.
-          bash: {
-            "*wix preview*": "deny",
-            "*wix dev*": "deny",
-            "*wix release*": "deny",
-            "*wix promote*": "deny",
-            "*npm run preview*": "deny",
-            "*npm run dev*": "deny",
-            "*npm run release*": "deny",
-            "*npm run promote*": "deny",
-            "*": "allow"
+          [
+            "skill"
+            /* OpenCodeTool.Skill */
+          ]: {
+            "*": "allow",
+            "wix-cli-orchestrator": "deny",
+            "wix-cli-app-validation": "deny",
+            "wds-docs": "deny"
           },
-          webfetch: "allow",
-          skill: "allow",
           task: "deny",
-          todowrite: "deny",
-          todoread: "deny",
+          doom_loop: "allow",
+          [
+            "todowrite"
+            /* OpenCodeTool.TodoWrite */
+          ]: "deny",
+          [
+            "todoread"
+            /* OpenCodeTool.TodoRead */
+          ]: "deny",
           external_directory: {
             "/root/.agents/**": "allow",
             "/root/.claude/**": "allow",
             "/root/.opencode/**": "allow"
           }
         },
+        instructions: [rules_writer_12.CODEGEN_RULES_PATH, rules_writer_12.ORCHESTRATOR_RULES_PATH],
+        autoupdate: false,
+        share: "disabled",
         lsp: false,
         mcp: WIX_MCP_CONFIG
       };
@@ -11757,10 +11988,29 @@ var require_config = __commonJS({
         model: exports2.DEFAULT_MODEL,
         provider: getProviderConfig(),
         permission: {
-          edit: "deny",
-          bash: "deny",
-          task: "deny"
+          [
+            "edit"
+            /* OpenCodeTool.Edit */
+          ]: "deny",
+          [
+            "bash"
+            /* OpenCodeTool.Bash */
+          ]: "deny",
+          task: "deny",
+          [
+            "batch-write"
+            /* OpenCodeTool.BatchWrite */
+          ]: "deny",
+          [
+            "validate"
+            /* OpenCodeTool.Validate */
+          ]: "deny",
+          [
+            "uuid"
+            /* OpenCodeTool.Uuid */
+          ]: "deny"
         },
+        instructions: [rules_writer_12.ASK_RULES_PATH],
         lsp: false,
         mcp: WIX_MCP_CONFIG
       };
@@ -11966,6 +12216,35 @@ var require_parser = __commonJS({
   }
 });
 
+// dist/opencode-integration/cost-tracker.js
+var require_cost_tracker = __commonJS({
+  "dist/opencode-integration/cost-tracker.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.fetchOpenCodeStats = fetchOpenCodeStats;
+    var child_process_1 = require("child_process");
+    var util_1 = require("util");
+    var logger_12 = require_logger();
+    var execAsync = (0, util_1.promisify)(child_process_1.exec);
+    var CLI_TIMEOUT_MS = 15e3;
+    async function fetchOpenCodeStats(cwd, env) {
+      try {
+        const { stdout } = await execAsync("opencode stats --models", {
+          cwd,
+          env,
+          timeout: CLI_TIMEOUT_MS
+        });
+        return stdout.trim() || null;
+      } catch (error) {
+        logger_12.logger.warn("[OpenCode] Could not fetch opencode stats", {
+          error: error instanceof Error ? error.message : String(error)
+        });
+        return null;
+      }
+    }
+  }
+});
+
 // dist/opencode-integration/task-tracker/extension-handler.js
 var require_extension_handler = __commonJS({
   "dist/opencode-integration/task-tracker/extension-handler.js"(exports2) {
@@ -12176,10 +12455,7 @@ var require_task_tracker = __commonJS({
         if (!tool || !callID || !state)
           return;
         if (constants_1.WRITE_TOOLS.has(tool)) {
-          this.collectFileChange(tool, state);
-          const ctx = this.handlerContext;
-          await this.extensionHandler.handle(tool, state, ctx);
-          this.taskCounter = ctx.taskCounter;
+          await this.handleWriteEvent(tool, state);
         }
         if (tool === "skill" && state.status === "completed") {
           this.handleSkillEvent(state);
@@ -12190,10 +12466,26 @@ var require_task_tracker = __commonJS({
           this.taskCounter = ctx.taskCounter;
         }
       }
-      /** Records a unique file change (INSERT/EDIT) from a completed write/edit tool call. */
-      collectFileChange(tool, state) {
+      async handleWriteEvent(tool, state) {
         if (state.status !== "completed")
           return;
+        const fileStates = tool === "batch-write" ? this.expandBatchWrite(state) : [state];
+        const effectiveTool = tool === "batch-write" ? "write" : tool;
+        for (const fileState of fileStates) {
+          this.trackFileChange(effectiveTool, fileState);
+          const ctx = this.handlerContext;
+          await this.extensionHandler.handle(effectiveTool, fileState, ctx);
+          this.taskCounter = ctx.taskCounter;
+        }
+      }
+      expandBatchWrite(state) {
+        return (state.input?.files ?? []).map((f) => ({
+          status: "completed",
+          input: { filePath: f.path, content: f.content },
+          metadata: { exists: false }
+        }));
+      }
+      trackFileChange(tool, state) {
         const filePath = state.input?.filePath || state.title;
         const operation = (0, constants_1.resolveFileOperation)(tool, state.metadata);
         if (!filePath || !operation)
@@ -12497,6 +12789,7 @@ var require_executor = __commonJS({
     var job_context_storage_12 = require_job_context_storage();
     var parser_1 = require_parser();
     var prompts_1 = require_prompts();
+    var cost_tracker_1 = require_cost_tracker();
     var task_tracker_1 = require_task_tracker2();
     var process_manager_1 = require_process_manager();
     var process_handlers_1 = require_process_handlers();
@@ -12531,6 +12824,7 @@ var require_executor = __commonJS({
             extensionsCreated: accumulatedExtensions
           };
           logger_12.logger.info((0, parser_1.formatUsageStats)(finalResult2.usage));
+          await logOpenCodeStats(options);
           return finalResult2;
         }
         lastResult = result;
@@ -12550,8 +12844,18 @@ var require_executor = __commonJS({
         extensionsCreated: accumulatedExtensions
       };
       logger_12.logger.info((0, parser_1.formatUsageStats)(finalResult.usage));
+      await logOpenCodeStats(options);
       return finalResult;
     }
+    async function logOpenCodeStats(options) {
+      const isAsk = job_context_storage_12.jobContextStorage.getStore()?.kind === ditto_codegen_types_12.TaskKind.ASK_CODEGEN;
+      const env = isAsk ? (0, config_1.getOpenCodeAskEnv)(options.projectId) : (0, config_1.getOpenCodeEnv)(options.projectId);
+      const stats = await (0, cost_tracker_1.fetchOpenCodeStats)(options.outputPath, env);
+      if (stats) {
+        logger_12.logger.info(`[OpenCode] Stats:
+${stats}`);
+      }
+    }
     function buildArgs(prompt) {
       return ["run", "--format", "json", prompt];
     }
@@ -14690,43 +14994,6 @@ var require_pre_run_decision = __commonJS({
   }
 });
 
-// dist/experiments.js
-var require_experiments = __commonJS({
-  "dist/experiments.js"(exports2) {
-    "use strict";
-    Object.defineProperty(exports2, "__esModule", { value: true });
-    exports2.isExperimentEnabled = isExperimentEnabled;
-    exports2.isUserDecisionsEnabled = isUserDecisionsEnabled;
-    var logger_12 = require_logger();
-    var parsedExperiments = null;
-    function getExperiments() {
-      if (parsedExperiments !== null) {
-        return parsedExperiments;
-      }
-      const raw = process.env.CODEGEN_EXPERIMENTS;
-      if (!raw) {
-        parsedExperiments = {};
-        return parsedExperiments;
-      }
-      try {
-        parsedExperiments = JSON.parse(raw);
-      } catch (error) {
-        logger_12.logger.error("[Experiments] Failed to parse CODEGEN_EXPERIMENTS", {
-          error: error instanceof Error ? error.message : String(error)
-        });
-        parsedExperiments = {};
-      }
-      return parsedExperiments;
-    }
-    function isExperimentEnabled(specName) {
-      return getExperiments()[specName] === "true";
-    }
-    function isUserDecisionsEnabled() {
-      return isExperimentEnabled("specs.ditto.CodegenUserDecisions");
-    }
-  }
-});
-
 // dist/flows/opencode-init.js
 var require_opencode_init = __commonJS({
   "dist/flows/opencode-init.js"(exports2) {
@@ -15264,6 +15531,31 @@ var require_skills_installer = __commonJS({
   }
 });
 
+// dist/opencode-integration/tools-writer.js
+var require_tools_writer = __commonJS({
+  "dist/opencode-integration/tools-writer.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.writeToolFiles = writeToolFiles;
+    var promises_1 = require("fs/promises");
+    var os_1 = require("os");
+    var path_1 = require("path");
+    var logger_12 = require_logger();
+    var GLOBAL_TOOLS_DIR = (0, path_1.join)((0, os_1.homedir)(), ".config", "opencode", "tools");
+    async function writeToolFiles() {
+      await (0, promises_1.mkdir)(GLOBAL_TOOLS_DIR, { recursive: true });
+      const sourceToolsDir = (0, path_1.join)(__dirname, "opencode-tools");
+      const files = await (0, promises_1.readdir)(sourceToolsDir);
+      const toolFiles = files.filter((f) => f.endsWith(".ts"));
+      await Promise.all(toolFiles.map((file) => (0, promises_1.copyFile)((0, path_1.join)(sourceToolsDir, file), (0, path_1.join)(GLOBAL_TOOLS_DIR, file))));
+      logger_12.logger.info("[OpenCode] Wrote global tool files", {
+        targetDir: GLOBAL_TOOLS_DIR,
+        tools: toolFiles
+      });
+    }
+  }
+});
+
 // dist/index.js
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.processJob = processJob;
@@ -15281,6 +15573,8 @@ var crypto_1 = require("crypto");
 var ditto_codegen_types_1 = require_dist4();
 var logger_1 = require_logger();
 var skills_installer_1 = require_skills_installer();
+var rules_writer_1 = require_rules_writer();
+var tools_writer_1 = require_tools_writer();
 var sessionId = process.env.CODEGEN_SESSION_ID || (0, crypto_1.randomUUID)();
 process.env.CODEGEN_SESSION_ID = sessionId;
 (0, logger_1.initLogger)(sessionId);
@@ -15326,10 +15620,18 @@ var alwaysOnLoop = async () => {
     context_1.ctx.resetJobs();
   }
 };
+async function initOpenCode() {
+  await Promise.all([
+    (0, skills_installer_1.installSkills)((0, codegen_flow_helpers_1.getOutputPath)(), logger_1.logger),
+    (0, rules_writer_1.writeRuleFiles)(),
+    (0, tools_writer_1.writeToolFiles)()
+  ]);
+}
 async function main(ctx) {
   logger_1.logger.info("[Startup] CodeGen CLI starting", {
     projectId: ctx.projectId
   });
+  await initOpenCode();
   await alwaysOnLoop();
 }
 var getFirstTask = (job) => {
@@ -15353,10 +15655,6 @@ async function processJob(job) {
   jobTimeoutMonitor.start(jobId);
   try {
     jobLog.debug("Task Payload", { payload: task.payload });
-    jobLog.debug("INSTALL_INTERNAL_SKILLS", {
-      value: process.env.INSTALL_INTERNAL_SKILLS
-    });
-    await (0, skills_installer_1.installSkills)((0, codegen_flow_helpers_1.getOutputPath)(), jobLog);
     await job_context_storage_1.jobContextStorage.run({ jobId, taskId: task.id, kind: task.kind }, async () => {
       const payload = task.payload ?? {};
       const history = payload.history ?? [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/ditto-codegen-public",
-  "version": "1.0.272",
+  "version": "1.0.274",
   "description": "AI-powered Wix CLI app generator - standalone executable",
   "scripts": {
     "build": "node build.mjs",
@@ -27,5 +27,5 @@
     "@wix/ditto-codegen": "1.0.0",
     "esbuild": "^0.27.2"
   },
-  "falconPackageHash": "f331461af69f80088614bd1bc150cb8f3bc267d38018a7221434bfd9"
+  "falconPackageHash": "77ff9c8c2d7c0c3fd5d4c767a1048f35f75ea0aad65d48272cc7fccc"
 }