@wix/ditto-codegen-public 1.0.405 → 1.0.406

package/dist/out.js

@@ -11595,9 +11595,10 @@ Then summarize each error: message, file, root cause, fix. No diffs.
     var WIX_DOCS_DESCRIPTION = `Use ONLY to discover a Wix SDK you don't know and that the skills +
 KNOWN WIX APIS don't cover. Send ONE complete question; returns the import path
 + exported namespace/method + runtime context + full signature + any required
-scope/permission IDs + a short usage example (not a link). Don't fetch a doc you
-already identified, and don't split a lookup into separate search/signature
-calls. Read-only.`;
+scope/permission IDs + any user setup prerequisites (dependent app to install,
+dashboard setting to enable, template to create) + a short usage example (not a
+link). Don't fetch a doc you already identified, and don't split a lookup into
+separate search/signature calls. Read-only.`;
     var WIX_DOCS_PROMPT = `You research Wix SDK APIs via wix-mcp and report back \u2014 never write app code.
 The caller uses DIRECT imports inside an extension that already supplies
 auth/host: 'import { <namespace> } from "@wix/<pkg>"; await <namespace>.<method>(<optionsObject>)'
@@ -11608,12 +11609,17 @@ introduction ('SearchWixSDKDocumentation' \u2192 'ReadFullDocsArticle') to confi
 it's the RIGHT API and its runtime context \u2014 backend, the dashboard host, or the
 site/editor host (host modules like @wix/dashboard work ONLY in their own host);
 (2) read 'ReadFullDocsMethodSchema' for the exact exported name and its
-options-object parameters. Reply with: the import path + exported
-namespace/method, the runtime context, the full TypeScript signature, and a
-short usage example \u2014 never a bare link, never 'as any' or a guessed method. If
-the API is limited to one context, say so. For a required scope/permission,
-return the EXACT scope-ID string from the docs (never a guessed format); if none
-is documented, say so.`;
+options-object parameters; (3) capture any user SETUP prerequisites the docs
+call out (often a 'Before you begin' section) \u2014 a dependent app that must be
+installed (e.g. Wix Stores, Members Area), a dashboard setting that must be
+enabled (e.g. Automations for back-in-stock notifications), or a template/config
+the user must create first (e.g. a triggered email). Reply with: the import path
++ exported namespace/method, the runtime context, the full TypeScript signature,
+a short usage example \u2014 never a bare link, never 'as any' or a guessed method \u2014
+and a SETUP STEPS list of the prerequisites from (3) so the main agent can relay
+them to the user (say 'none' if there are none). If the API is limited to one
+context, say so. For a required scope/permission, return the EXACT scope-ID
+string from the docs (never a guessed format); if none is documented, say so.`;
     var WDS_DOCS_DESCRIPTION = `Use ONLY when building dashboard UI and you need a Wix Design System
 component/prop/example you don't know and the skills don't cover.
 Returns the component name + props + a short usage example. Not for layouts the
@@ -12029,6 +12035,7 @@ var require_dist5 = __commonJS({
       return check_site_ui_decision_1.createCheckSiteUIDecision;
     } });
     exports2.appBuilderCodegenConfig = {
+      environmentIdentity: "You generate a Wix CLI app (a code-first Wix app) on a dev machine. The user previews it on a dev site and releases it from the product UI.",
       codegenRules: [],
       askRules: [],
       gitConflictsRules: [],
@@ -14370,6 +14377,7 @@ var require_dist8 = __commonJS({
     var codegen_checkpoint_plugin_1 = require_dist6();
     var codegen_common_logic_1 = require_dist7();
     exports2.studio2CodegenConfig = {
+      environmentIdentity: "You generate code for the user's own live Wix site \u2014 to the user it's just their site, not a separate app they're aware of. Your changes are saved and applied to the site automatically; there is no separate release step.",
       codegenRules: [
         { filename: "site-data-layer-rules.md", content: codegen_common_logic_1.SITE_DATA_LAYER_RULES },
         { filename: "studio-2-site-ui-rules.md", content: codegen_common_logic_1.STUDIO_2_SITE_UI_RULES }
@@ -14723,6 +14731,7 @@ var require_dist10 = __commonJS({
     var codegen_feature_vibe_plugin_1 = require_dist9();
     var codegen_common_logic_1 = require_dist7();
     exports2.harmonyCodegenConfig = {
+      environmentIdentity: "You generate code for the user's own live Wix site \u2014 to the user it's just their site, not a separate app they're aware of. Your changes are saved and applied to the site automatically; there is no separate release step.",
       codegenRules: [
         { filename: "site-data-layer-rules.md", content: codegen_common_logic_1.SITE_DATA_LAYER_RULES }
       ],
@@ -14735,13 +14744,36 @@ var require_dist10 = __commonJS({
   }
 });
 
+// dist/opencode-integration/rules/shared-rules.js
+var require_shared_rules = __commonJS({
+  "dist/opencode-integration/rules/shared-rules.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.OUTPUT_MESSAGE_RULES = exports2.BOUNDARY_RULES = void 0;
+    exports2.buildEnvironmentRules = buildEnvironmentRules;
+    function buildEnvironmentRules(environmentIdentity) {
+      return `ENVIRONMENT:
+${environmentIdentity}`;
+    }
+    exports2.BOUNDARY_RULES = `YOUR BOUNDARIES:
+- You only write code. You cannot release, publish, upload/download files, or do other product/platform actions for the user \u2014 those are the user's to do in the UI, not yours.
+- If asked how to do such a product/platform action (download/upload files, release, manage app info, use git or the IDE, etc.), do NOT explain the steps or name specific tools, surfaces, or locations \u2014 it varies by environment and you may be wrong. Just say it's outside what you do (you only write code) and that it's done in the UI, not through code.
+- Don't mention internal/sandbox details (e.g. paths like \`/user-code\`) \u2014 the user can't see them.`;
+    exports2.OUTPUT_MESSAGE_RULES = `OUTPUT MESSAGE (shown to the user):
+- Match their technical level: include code/technical detail only if their request was technical; otherwise describe the outcome in plain language (no code, file/type names, or internals).
+- List any manual setup the user must still do for the feature to work, as short "next steps" (e.g. installing a dependent app or enabling a dashboard setting).
+- Be honest: if you didn't fully build what was asked (e.g. stored data but didn't send it), say so. Keep it short.`;
+  }
+});
+
 // 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:
+    exports2.buildCodegenRules = buildCodegenRules;
+    var shared_rules_1 = require_shared_rules();
+    var CODEGEN_CORE_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.
@@ -14781,7 +14813,7 @@ IMPLEMENTATION WORKFLOW:
 4. **Register**: Register all extensions in \`src/extensions.ts\`.
 5. **Validate**: Dispatch ONE \`task({ subagent: "codegen-validator", prompt: "Run validate({ runBuild: true }) \u2014 it typechecks AND builds in a single pass (tsc runs first and fails fast before the build). Fix any errors and re-run until it passes. Pass installDeps: true only if package.json changed and npm install was not already run in this session." })\`. Wait for the subagent to return. Do NOT call \`validate\` directly from the primary agent, and do NOT make a separate tsc-only call first \u2014 the single runBuild pass already fails fast on type errors. VERIFY the subagent actually FINISHED with a clean build: read its returned summary and confirm it converged. If it reports remaining/unresolved errors or was cut off before finishing (e.g. "Maximum steps reached"), do NOT treat it as success \u2014 re-dispatch \`codegen-validator\` to finish the remaining errors before moving on.
 6. **Declare permissions**: If the generated code requires Wix app permissions, call \`required-permissions\` ONCE with their SCOPE IDs (see PERMISSIONS below). Skip this step entirely if no permissions are needed.
-7. **Final message**: Your last message is returned to the user as the codegen output \u2014 keep it short and plain (a sentence or two on what the app now does).
+7. **Final message**: Your last message is returned to the user as the codegen output \u2014 keep it short and plain (a sentence or two on what the app now does). Do NOT mention permissions/scopes here (see PERMISSIONS) and follow OUTPUT MESSAGE below.
 8. **Stop**: STOP immediately. Do NOT refactor, clean up, or verify.
 
 FILE CREATION:
@@ -14798,7 +14830,16 @@ When you call \`required-permissions\` (see workflow step 6 for when), use SCOPE
 - Embedded scripts \u2192 "SCOPE.DC-APPS.MANAGE-EMBEDDED-SCRIPTS"
 
 CRITICAL: Only include permissions you have explicitly seen in the Wix SDK documentation (via MCP or loaded skills) \u2014 NEVER guess or infer a scope ID. If you cannot point to where you saw it, do NOT include it. When in doubt, skip the call entirely. A fabricated scope ID will show an error to the user and confuse them; a missing permission is just a warning the user can fix.
-`;
+
+The \`required-permissions\` tool records and surfaces permissions to the user automatically \u2014 NEVER mention permissions/scopes (IDs or names) in your output, or tell the user to grant them.`;
+    function buildCodegenRules(environmentIdentity) {
+      return [
+        (0, shared_rules_1.buildEnvironmentRules)(environmentIdentity),
+        shared_rules_1.BOUNDARY_RULES,
+        CODEGEN_CORE_RULES,
+        shared_rules_1.OUTPUT_MESSAGE_RULES
+      ].join("\n\n");
+    }
   }
 });
 
@@ -14807,8 +14848,9 @@ 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:
+    exports2.buildAskRules = buildAskRules;
+    var shared_rules_1 = require_shared_rules();
+    var ASK_CORE_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.
@@ -14828,6 +14870,14 @@ DEBUGGING GUIDANCE:
   - Browser DevTools: the Console, Network, and Sources tabs.
   - \`console.log\` statements, then read the output in the already-running server logs.
   - Inspecting network requests in the browser, without starting a new server.`;
+    function buildAskRules(environmentIdentity) {
+      return [
+        (0, shared_rules_1.buildEnvironmentRules)(environmentIdentity),
+        shared_rules_1.BOUNDARY_RULES,
+        ASK_CORE_RULES,
+        shared_rules_1.OUTPUT_MESSAGE_RULES
+      ].join("\n\n");
+    }
   }
 });
 
@@ -14988,24 +15038,26 @@ var require_environments = __commonJS({
     var git_conflicts_rules_1 = require_git_conflicts_rules();
     var job_decision_manager_1 = require_job_decision_manager();
     var logger_12 = require_logger();
-    var SHARED_CODEGEN_RULE = {
-      filename: "codegen-instructions.md",
-      content: codegen_rules_1.CODEGEN_RULES
-    };
-    var SHARED_ASK_RULE = {
-      filename: "ask-instructions.md",
-      content: ask_rules_1.ASK_RULES
-    };
     var SHARED_GIT_CONFLICTS_RULE = {
       filename: "git-conflicts-instructions.md",
       content: git_conflicts_rules_1.GIT_CONFLICTS_RULES
     };
-    var withSharedRules = (env) => ({
-      ...env,
-      codegenRules: [SHARED_CODEGEN_RULE, ...env.codegenRules],
-      askRules: [SHARED_ASK_RULE, ...env.askRules],
-      gitConflictsRules: [SHARED_GIT_CONFLICTS_RULE, ...env.gitConflictsRules]
-    });
+    var withSharedRules = (env) => {
+      const sharedCodegenRule = {
+        filename: "codegen-instructions.md",
+        content: (0, codegen_rules_1.buildCodegenRules)(env.environmentIdentity)
+      };
+      const sharedAskRule = {
+        filename: "ask-instructions.md",
+        content: (0, ask_rules_1.buildAskRules)(env.environmentIdentity)
+      };
+      return {
+        ...env,
+        codegenRules: [sharedCodegenRule, ...env.codegenRules],
+        askRules: [sharedAskRule, ...env.askRules],
+        gitConflictsRules: [SHARED_GIT_CONFLICTS_RULE, ...env.gitConflictsRules]
+      };
+    };
     function getCodegenEnvironmentConfig() {
       switch (process.env.CODEGEN_ENVIRONMENT) {
         case types_1.Environment.STUDIO_2:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/ditto-codegen-public",
-  "version": "1.0.405",
+  "version": "1.0.406",
   "description": "AI-powered Wix CLI app generator - standalone executable",
   "scripts": {
     "build": "node build.mjs",
@@ -29,5 +29,5 @@
     "esbuild": "^0.27.2",
     "vitest": "^4.0.16"
   },
-  "falconPackageHash": "7a15f5850d6a383ca1193b0a3473908455ef8cba130c912beb4ee409"
+  "falconPackageHash": "9524fe7789f8c47fddc924848695ccae0c7bf2bc332a8d29bfcdc0e5"
 }