canicode 0.11.0 → 0.11.2

package/dist/mcp/server.js

@@ -671,9 +671,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) {
@@ -1845,7 +1863,7 @@ function computeApplyContext(violation, instanceContext) {
 }
 
 // package.json
-var version = "0.11.0";
+var version = "0.11.2";
 
 // src/core/engine/scoring.ts
 function computeTotalScorePerCategory(configs) {
@@ -2215,7 +2233,13 @@ var BATCHABLE_RULE_IDS = [
   "no-auto-layout",
   "fixed-size-in-auto-layout"
 ];
+var OPT_IN_BATCHABLE_RULE_IDS = [
+  "missing-prototype"
+];
 var BATCHABLE_SET = new Set(BATCHABLE_RULE_IDS);
+var OPT_IN_BATCHABLE_SET = new Set(
+  OPT_IN_BATCHABLE_RULE_IDS
+);
 var NO_SOURCE_SENTINEL = "_no-source";
 function groupAndBatchSurveyQuestions(questions) {
   if (questions.length === 0) {
@@ -2256,20 +2280,25 @@ function sourceComponentKey(question) {
 }
 function pushIntoBatch(group, question) {
   const sceneWeight = Math.max(question.replicas ?? 1, 1);
-  const isBatchable = BATCHABLE_SET.has(question.ruleId);
+  const batchMode = resolveBatchMode(question.ruleId);
   const last = group.batches.at(-1);
-  if (last !== void 0 && last.ruleId === question.ruleId && isBatchable && last.batchable) {
+  if (last !== void 0 && last.ruleId === question.ruleId && batchMode !== "none" && last.batchMode === batchMode) {
     last.questions.push(question);
     last.totalScenes += sceneWeight;
     return;
   }
   group.batches.push({
     ruleId: question.ruleId,
-    batchable: isBatchable,
+    batchMode,
     questions: [question],
     totalScenes: sceneWeight
   });
 }
+function resolveBatchMode(ruleId) {
+  if (BATCHABLE_SET.has(ruleId)) return "safe";
+  if (OPT_IN_BATCHABLE_SET.has(ruleId)) return "opt-in";
+  return "none";
+}
 
 // src/core/gotcha/survey-generator.ts
 var NODE_PATH_SEPARATOR = " > ";
@@ -2288,12 +2317,18 @@ function generateGotchaSurvey(result, scores, options = {}) {
   const mapped = sorted.map((issue) => mapToQuestion(issue, result.file)).filter((q) => q !== null);
   const questions = deduplicateBySourceComponent(mapped);
   const groupedQuestions = groupAndBatchSurveyQuestions(questions);
+  const PROPAGATION_CANDIDATE_THRESHOLD = 3;
+  const propagationCandidates = questions.filter(
+    (q) => q.isInstanceChild
+  ).length;
+  const suggestedDefaultApply = propagationCandidates >= PROPAGATION_CANDIDATE_THRESHOLD;
   return {
     designGrade: grade,
     isReadyForCodeGen: isReadyForCodeGen(grade),
     questions,
     groupedQuestions,
-    designKey: options.designKey ?? ""
+    designKey: options.designKey ?? "",
+    suggestedDefaultApply
   };
 }
 function deduplicateSiblingIssues(issues) {
@@ -3611,7 +3646,9 @@ var EVENTS = {
   // cannot import `core/monitoring` directly, so the event fires through a
   // caller-supplied callback. Define the typed name here so a future consumer
   // has a single place to wire it up.
-  ROUNDTRIP_DEFINITION_WRITE_SKIPPED: `${EVENT_PREFIX}roundtrip_definition_write_skipped`
+  ROUNDTRIP_DEFINITION_WRITE_SKIPPED: `${EVENT_PREFIX}roundtrip_definition_write_skipped`,
+  /** CLI `canicode roundtrip-tally` completed successfully. */
+  ROUNDTRIP_TALLY: `${EVENT_PREFIX}roundtrip_tally`
 };
 
 // src/core/monitoring/capture.ts
@@ -5157,7 +5194,7 @@ Provide a Figma URL or fixture path via the input parameter. Requires FIGMA_TOKE
     targetNodeId: z.string().optional().describe("Scope analysis to a specific node ID"),
     configPath: z.string().optional().describe("Path to config JSON file for rule overrides"),
     openReport: z.boolean().optional().describe("Open the generated HTML report in the user's browser. Defaults to false \u2014 opt in only when a visible report is the explicit user request (#365). The HTML file is always written to disk regardless."),
-    acknowledgments: z.array(AcknowledgmentSchema).optional().describe("(#371) Pre-resolved [{ nodeId, ruleId }] pairs harvested from canicode-authored Figma annotations (e.g. via the `readCanicodeAcknowledgments` Plugin helper inside a use_figma batch). Matching issues are flagged `acknowledged: true` and contribute half weight to the density score so re-analyze surfaces movement after a roundtrip even under ADR-012's annotate-by-default policy."),
+    acknowledgments: z.array(AcknowledgmentSchema).optional().describe("(#371 / ADR-019) Pre-resolved acknowledgments from canicode-authored Figma annotations (e.g. via readCanicodeAcknowledgments in a use_figma batch). Each entry includes nodeId and ruleId; newer annotations may also carry intent, sceneWriteOutcome, and codegenDirective from a canicode-json fenced block (#444). Matching issues are flagged acknowledged and contribute half weight to the density score."),
     scope: z.enum(["page", "component"]).optional().describe("(#404) Override analysis scope \u2014 `page` (screen/section where container bounds are required) or `component` (standalone reusable unit where root FILL is the design contract). Defaults to auto-detection from the root node type: `COMPONENT` / `COMPONENT_SET` / `INSTANCE` roots resolve to `component`, everything else to `page`.")
   },
   {