canicode 0.11.2 → 0.11.3

package/dist/cli/index.js

@@ -4245,9 +4245,11 @@ function computeApplyContext(violation, instanceContext) {
 }
 
 // package.json
-var version2 = "0.11.2";
+var version2 = "0.11.3";
 
 // src/core/engine/scoring.ts
+var GRADE_ORDER = ["S", "A+", "A", "B+", "B", "C+", "C", "D", "F"];
+var DEFAULT_CODEGEN_READY_MIN_GRADE = "A";
 function computeTotalScorePerCategory(configs) {
   const totals = Object.fromEntries(
     CATEGORIES.map((c) => [c, 0])
@@ -4274,8 +4276,9 @@ function calculateGrade(percentage) {
   if (percentage >= 50) return "D";
   return "F";
 }
-function isReadyForCodeGen(grade) {
-  return grade === "S" || grade === "A+" || grade === "A";
+function isReadyForCodeGen(grade, minGrade) {
+  const threshold = minGrade ?? DEFAULT_CODEGEN_READY_MIN_GRADE;
+  return GRADE_ORDER.indexOf(grade) <= GRADE_ORDER.indexOf(threshold);
 }
 function clamp(value, min, max) {
   return Math.max(min, Math.min(max, value));
@@ -4468,7 +4471,7 @@ function buildResultJson(fileName, result, scores, options) {
     scope: result.scope,
     issueCount: result.issues.length,
     acknowledgedCount: scores.summary.acknowledgedCount,
-    isReadyForCodeGen: isReadyForCodeGen(scores.overall.grade),
+    isReadyForCodeGen: isReadyForCodeGen(scores.overall.grade, options?.codegenReadyMinGrade),
     blockingIssueCount: scores.summary.blocking,
     scores: {
       overall: scores.overall,
@@ -4505,6 +4508,7 @@ var ConfigFileSchema = z.object({
   excludeNodeTypes: z.array(z.string()).optional(),
   excludeNodeNames: z.array(z.string()).optional(),
   gridBase: z.number().int().positive().optional(),
+  codegenReadyMinGrade: z.enum(["S", "A+", "A", "B+", "B", "C+", "C", "D", "F"]).optional(),
   rules: z.record(z.string(), RuleOverrideSchema).superRefine((rules, ctx) => {
     const unknown = Object.keys(rules).filter((id) => !VALID_RULE_IDS.has(id));
     if (unknown.length > 0) {
@@ -5731,13 +5735,14 @@ var AnalyzeOptionsSchema = z.object({
   noOpen: z.boolean().optional(),
   json: z.boolean().optional(),
   acknowledgments: z.string().optional(),
-  scope: z.enum(["page", "component"]).optional()
+  scope: z.enum(["page", "component"]).optional(),
+  readyMinGrade: z.enum(["S", "A+", "A", "B+", "B", "C+", "C", "D", "F"]).optional()
 });
 function registerAnalyze(cli2) {
   cli2.command("analyze <input>", "Analyze a Figma file or JSON fixture").option("--preset <preset>", "Analysis preset (relaxed | dev-friendly | ai-ready | strict)").option("--output <path>", "HTML report output path").option("--token <token>", "Figma API token (or use FIGMA_TOKEN env var)").option(
     "--api",
     "No-op for Figma URL inputs (file data is always fetched via REST). Accepted for CLI parity with `gotcha-survey` (#461)."
-  ).option("--screenshot", "Include screenshot comparison in report (requires ANTHROPIC_API_KEY)").option("--config <path>", "Path to config JSON file (override rule scores/settings)").option("--no-open", "Don't open report in browser after analysis").option("--json", "Output JSON results to stdout (same format as MCP)").option("--acknowledgments <path>", "(#371 / ADR-019) Path to JSON acknowledgments from canicode Figma annotations (nodeId, ruleId; optional intent / sceneWriteOutcome / codegenDirective per #444). Matching issues are flagged acknowledged and contribute half weight to density.").option("--scope <scope>", "(#404) Override analysis scope: `page` (screen/section \u2014 container bounds are required) or `component` (standalone reusable unit \u2014 root FILL is the design contract). Defaults to auto-detection from the root node type.").example("  canicode analyze https://www.figma.com/design/ABC123/MyDesign").example("  canicode analyze ./fixtures/my-design --output report.html").example("  canicode analyze ./fixtures/my-design --config ./my-config.json").action(async (input, rawOptions) => {
+  ).option("--screenshot", "Include screenshot comparison in report (requires ANTHROPIC_API_KEY)").option("--config <path>", "Path to config JSON file (override rule scores/settings)").option("--no-open", "Don't open report in browser after analysis").option("--json", "Output JSON results to stdout (same format as MCP)").option("--acknowledgments <path>", "(#371 / ADR-019) Path to JSON acknowledgments from canicode Figma annotations (nodeId, ruleId; optional intent / sceneWriteOutcome / codegenDirective per #444). Matching issues are flagged acknowledged and contribute half weight to density.").option("--scope <scope>", "(#404) Override analysis scope: `page` (screen/section \u2014 container bounds are required) or `component` (standalone reusable unit \u2014 root FILL is the design contract). Defaults to auto-detection from the root node type.").option("--ready-min-grade <grade>", "Minimum grade for code-gen readiness (S | A+ | A | B+ | B | C+ | C | D | F). Overrides configPath codegenReadyMinGrade. Default: A").example("  canicode analyze https://www.figma.com/design/ABC123/MyDesign").example("  canicode analyze ./fixtures/my-design --output report.html").example("  canicode analyze ./fixtures/my-design --config ./my-config.json").action(async (input, rawOptions) => {
     const parseResult = AnalyzeOptionsSchema.safeParse(rawOptions);
     if (!parseResult.success) {
       const msg = parseResult.error.issues.map((i) => `--${i.path.join(".")}: ${i.message}`).join("\n");
@@ -5800,13 +5805,16 @@ Analyzing: ${file.name}`);
       let configs = options.preset ? { ...getConfigsWithPreset(options.preset) } : { ...RULE_CONFIGS };
       let excludeNodeNames;
       let excludeNodeTypes;
+      let codegenReadyMinGrade;
       if (options.config) {
         const configFile = await loadConfigFile(options.config);
         configs = mergeConfigs(configs, configFile);
         excludeNodeNames = configFile.excludeNodeNames;
         excludeNodeTypes = configFile.excludeNodeTypes;
+        codegenReadyMinGrade = configFile.codegenReadyMinGrade;
         log(`Config loaded: ${options.config}`);
       }
+      const effectiveMinGrade = options.readyMinGrade ?? codegenReadyMinGrade;
       let acknowledgments;
       if (options.acknowledgments) {
         const ackPath = resolve(options.acknowledgments);
@@ -5832,7 +5840,7 @@ Analyzing: ${file.name}`);
       log(`Nodes: ${result.nodeCount} (max depth: ${result.maxDepth})`);
       const scores = calculateScores(result, configs);
       if (options.json) {
-        console.log(JSON.stringify(buildResultJson(file.name, result, scores, { fileKey: file.fileKey, designKey: computeDesignKey(input) }), null, 2));
+        console.log(JSON.stringify(buildResultJson(file.name, result, scores, { fileKey: file.fileKey, designKey: computeDesignKey(input), ...effectiveMinGrade ? { codegenReadyMinGrade: effectiveMinGrade } : {} }), null, 2));
         if (scores.overall.grade === "F") {
           process.exitCode = 1;
         }
@@ -6115,7 +6123,7 @@ function generateGotchaSurvey(result, scores, options = {}) {
   const suggestedDefaultApply = propagationCandidates >= PROPAGATION_CANDIDATE_THRESHOLD;
   return {
     designGrade: grade,
-    isReadyForCodeGen: isReadyForCodeGen(grade),
+    isReadyForCodeGen: isReadyForCodeGen(grade, options.codegenReadyMinGrade),
     questions,
     groupedQuestions,
     designKey: options.designKey ?? "",
@@ -6273,24 +6281,31 @@ var GotchaSurveyOptionsSchema = z.object({
   config: z.string().optional(),
   targetNodeId: z.string().optional(),
   json: z.boolean().optional(),
-  scope: z.enum(["page", "component"]).optional()
+  scope: z.enum(["page", "component"]).optional(),
+  readyMinGrade: z.enum(["S", "A+", "A", "B+", "B", "C+", "C", "D", "F"]).optional()
 });
 async function runGotchaSurvey(input, options) {
   void options.api;
   const { file, nodeId } = await loadFile(input, options.token);
   const effectiveNodeId = options.targetNodeId ?? nodeId;
   let configs = options.preset ? { ...getConfigsWithPreset(options.preset) } : { ...RULE_CONFIGS };
+  let codegenReadyMinGrade;
   if (options.config) {
     const configFile = await loadConfigFile(options.config);
     configs = mergeConfigs(configs, configFile);
+    codegenReadyMinGrade = configFile.codegenReadyMinGrade;
   }
+  const effectiveMinGrade = options.readyMinGrade ?? codegenReadyMinGrade;
   const result = analyzeFile(file, {
     configs,
     ...effectiveNodeId ? { targetNodeId: effectiveNodeId } : {},
     ...options.scope ? { scope: options.scope } : {}
   });
   const scores = calculateScores(result, configs);
-  return generateGotchaSurvey(result, scores, { designKey: computeDesignKey(input) });
+  return generateGotchaSurvey(result, scores, {
+    designKey: computeDesignKey(input),
+    ...effectiveMinGrade ? { codegenReadyMinGrade: effectiveMinGrade } : {}
+  });
 }
 function formatHumanSummary(survey) {
   const lines = [
@@ -6308,7 +6323,7 @@ function registerGotchaSurvey(cli2) {
   cli2.command("gotcha-survey <input>", "Generate a gotcha survey from a Figma design analysis").option("--preset <preset>", "Analysis preset (relaxed | dev-friendly | ai-ready | strict)").option("--token <token>", "Figma API token (or use FIGMA_TOKEN env var)").option(
     "--api",
     "No-op for Figma URL inputs (file data is always fetched via REST). Accepted for CLI parity with `analyze` (#461)."
-  ).option("--config <path>", "Path to config JSON file (override rule scores/settings)").option("--target-node-id <id>", "Scope analysis to a specific node ID").option("--scope <scope>", "(#404) Override analysis scope: `page` or `component`. Defaults to auto-detection from the root node type.").option("--json", "Output GotchaSurvey JSON to stdout (same format as MCP)").example("  canicode gotcha-survey https://www.figma.com/design/ABC123/MyDesign --json").example("  canicode gotcha-survey ./fixtures/my-design --json").action(async (input, rawOptions) => {
+  ).option("--config <path>", "Path to config JSON file (override rule scores/settings)").option("--target-node-id <id>", "Scope analysis to a specific node ID").option("--scope <scope>", "(#404) Override analysis scope: `page` or `component`. Defaults to auto-detection from the root node type.").option("--json", "Output GotchaSurvey JSON to stdout (same format as MCP)").option("--ready-min-grade <grade>", "Minimum grade for code-gen readiness (S | A+ | A | B+ | B | C+ | C | D | F). Overrides configPath codegenReadyMinGrade. Default: A").example("  canicode gotcha-survey https://www.figma.com/design/ABC123/MyDesign --json").example("  canicode gotcha-survey ./fixtures/my-design --json").action(async (input, rawOptions) => {
     const parseResult = GotchaSurveyOptionsSchema.safeParse(rawOptions);
     if (!parseResult.success) {
       const msg = parseResult.error.issues.map((i) => `--${i.path.join(".")}: ${i.message}`).join("\n");