canicode 0.11.0 → 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.0";
+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,28 +1107,32 @@ 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>;
 
-/**
- * Acknowledgment marker — surfaced from a Figma Dev Mode annotation that
- * canicode itself wrote during a roundtrip. When the analysis pipeline
- * receives a list of acknowledgments, matching `(nodeId, ruleId)` issues are
- * flagged `acknowledged: true` and contribute half their normal weight to
- * the density score (#371).
- *
- * This contract is consumed by:
- * - The MCP `analyze` tool (`acknowledgments?: Acknowledgment[]` input)
- * - The CLI `analyze --acknowledgments <path>` flag
- * - `RuleEngineOptions.acknowledgments`
- *
- * It is produced by the Plugin-API helper
- * `extractAcknowledgmentsFromNode` / `readCanicodeAcknowledgments`
- * (see `src/core/roundtrip/read-acknowledgments.ts`).
- */
 declare const AcknowledgmentSchema: z.ZodObject<{
     nodeId: z.ZodString;
     ruleId: z.ZodString;
+    intent: z.ZodOptional<z.ZodObject<{
+        field: z.ZodString;
+        value: z.ZodUnknown;
+        scope: z.ZodEnum<{
+            instance: "instance";
+            definition: "definition";
+        }>;
+    }, z.core.$strip>>;
+    sceneWriteOutcome: z.ZodOptional<z.ZodObject<{
+        result: z.ZodEnum<{
+            unknown: "unknown";
+            succeeded: "succeeded";
+            "silent-ignored": "silent-ignored";
+            "api-rejected": "api-rejected";
+            "user-declined-propagation": "user-declined-propagation";
+        }>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    codegenDirective: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type Acknowledgment = z.infer<typeof AcknowledgmentSchema>;
 

package/dist/index.js

@@ -6,7 +6,7 @@ import 'crypto';
 import { homedir } from 'os';
 
 // package.json
-var version = "0.11.0";
+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
@@ -791,9 +809,27 @@ function defineRule(rule) {
   ruleRegistry.register(rule);
   return rule;
 }
+var AcknowledgmentIntentSchema = z.object({
+  field: z.string(),
+  value: z.unknown(),
+  scope: z.enum(["instance", "definition"])
+});
+var AcknowledgmentSceneWriteOutcomeSchema = z.object({
+  result: z.enum([
+    "succeeded",
+    "silent-ignored",
+    "api-rejected",
+    "user-declined-propagation",
+    "unknown"
+  ]),
+  reason: z.string().optional()
+});
 var AcknowledgmentSchema = z.object({
   nodeId: z.string(),
-  ruleId: z.string()
+  ruleId: z.string(),
+  intent: AcknowledgmentIntentSchema.optional(),
+  sceneWriteOutcome: AcknowledgmentSceneWriteOutcomeSchema.optional(),
+  codegenDirective: z.string().optional()
 });
 z.array(AcknowledgmentSchema);
 function normalizeNodeId(id) {