canicode 0.11.1 → 0.11.2

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import { GetFileResponse, Node } from '@figma/rest-api-spec';
 
-var version = "0.11.1";
+var version = "0.11.2";
 
 declare const SeveritySchema: z.ZodEnum<{
     blocking: "blocking";
@@ -798,7 +798,11 @@ type GotchaSurveyQuestion = z.infer<typeof GotchaSurveyQuestionSchema>;
  */
 declare const SurveyQuestionBatchSchema: z.ZodObject<{
     ruleId: z.ZodString;
-    batchable: z.ZodBoolean;
+    batchMode: z.ZodEnum<{
+        safe: "safe";
+        "opt-in": "opt-in";
+        none: "none";
+    }>;
     questions: z.ZodArray<z.ZodObject<{
         nodeId: z.ZodString;
         nodeName: z.ZodString;
@@ -857,7 +861,11 @@ declare const SurveyQuestionGroupSchema: z.ZodObject<{
     }, z.core.$strip>>;
     batches: z.ZodArray<z.ZodObject<{
         ruleId: z.ZodString;
-        batchable: z.ZodBoolean;
+        batchMode: z.ZodEnum<{
+            safe: "safe";
+            "opt-in": "opt-in";
+            none: "none";
+        }>;
         questions: z.ZodArray<z.ZodObject<{
             nodeId: z.ZodString;
             nodeName: z.ZodString;
@@ -918,7 +926,11 @@ declare const GroupedSurveySchema: z.ZodObject<{
         }, z.core.$strip>>;
         batches: z.ZodArray<z.ZodObject<{
             ruleId: z.ZodString;
-            batchable: z.ZodBoolean;
+            batchMode: z.ZodEnum<{
+                safe: "safe";
+                "opt-in": "opt-in";
+                none: "none";
+            }>;
             questions: z.ZodArray<z.ZodObject<{
                 nodeId: z.ZodString;
                 nodeName: z.ZodString;
@@ -1039,7 +1051,11 @@ declare const GotchaSurveySchema: z.ZodObject<{
             }, z.core.$strip>>;
             batches: z.ZodArray<z.ZodObject<{
                 ruleId: z.ZodString;
-                batchable: z.ZodBoolean;
+                batchMode: z.ZodEnum<{
+                    safe: "safe";
+                    "opt-in": "opt-in";
+                    none: "none";
+                }>;
                 questions: z.ZodArray<z.ZodObject<{
                     nodeId: z.ZodString;
                     nodeName: z.ZodString;
@@ -1091,6 +1107,7 @@ declare const GotchaSurveySchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>;
     designKey: z.ZodString;
+    suggestedDefaultApply: z.ZodBoolean;
 }, z.core.$strip>;
 type GotchaSurvey = z.infer<typeof GotchaSurveySchema>;
 

package/dist/index.js

@@ -6,7 +6,7 @@ import 'crypto';
 import { homedir } from 'os';
 
 // package.json
-var version = "0.11.1";
+var version = "0.11.2";
 var SeveritySchema = z.enum([
   "blocking",
   "risk",
@@ -411,13 +411,17 @@ var GotchaSurveyQuestionSchema = z.object({
 var SurveyQuestionBatchSchema = z.object({
   ruleId: z.string(),
   /**
-   * `true` when every member shares an answer-shape uniformly applicable to
-   * all of them (e.g. one `min-width` value covers all FILL children).
-   * The SKILL renders one shared prompt for `batchable: true` batches with
-   * `questions.length >= 2`; everything else falls through to the
-   * single-question template.
+   * Rendering mode for this batch (see `BatchMode` in
+   * `src/core/gotcha/group-and-batch-questions.ts` — the authoritative
+   * whitelists `BATCHABLE_RULE_IDS` and `OPT_IN_BATCHABLE_RULE_IDS` live
+   * there):
+   * - `"safe"` — one answer uniformly applies to every member (#369).
+   * - `"opt-in"` — one shared answer is a suggested default; the user may
+   *   reply `split` for per-node override (#426).
+   * - `"none"` — single-member batch, renders the standard per-question
+   *   template.
    */
-  batchable: z.boolean(),
+  batchMode: z.enum(["safe", "opt-in", "none"]),
   questions: z.array(GotchaSurveyQuestionSchema),
   /**
    * Sum of `max(question.replicas, 1)` across `questions`. Counts the
@@ -451,7 +455,21 @@ var GotchaSurveySchema = z.object({
    * this directly when upserting the per-design section, so the SKILL.md
    * prose no longer parses URLs (per ADR-016).
    */
-  designKey: z.string()
+  designKey: z.string(),
+  /**
+   * #428 — threshold hint for the `allowDefinitionWrite` picker in the
+   * `canicode-roundtrip` skill. `true` when `propagationCandidates >= 3`
+   * (i.e. three or more questions target instance children that could
+   * benefit from definition-level writes). When `false`, the skill silently
+   * uses the annotation default (ADR-012) without surfacing the picker —
+   * the opt-in flow is over-engineered for tiny surveys.
+   *
+   * Computed server-side from `questions` so the skill doesn't have to
+   * count `isInstanceChild` manually; the skill may still override this
+   * hint when it has additional context (e.g. all candidates are
+   * read-only per probe result).
+   */
+  suggestedDefaultApply: z.boolean()
 });
 
 // src/core/rules/rule-config.ts