@fragments-sdk/cli 0.12.1 → 0.13.1

package/dist/bin.js

@@ -7,7 +7,7 @@ import {
 } from "./chunk-SXTKFDCR.js";
 import {
   setup
-} from "./chunk-T5OMVL7E.js";
+} from "./chunk-PJT5IZ37.js";
 import {
   buildFragments,
   buildFragmentsDir,
@@ -22,21 +22,21 @@ import {
   validateDrift,
   validateSchema,
   validateSnippets
-} from "./chunk-GVDSFQ4E.js";
+} from "./chunk-FZLPVN32.js";
 import {
   createComponentExtractor
-} from "./chunk-JJ2VRTBU.js";
+} from "./chunk-EYXVAMEX.js";
 import {
   scan
-} from "./chunk-TPWGL2XS.js";
+} from "./chunk-Z5BUXIFJ.js";
 import {
   loadConfig,
   loadFragmentFile,
   parseFragmentFile
-} from "./chunk-AM4MRTMN.js";
+} from "./chunk-55KERLWL.js";
 import {
   discoverFragmentFiles
-} from "./chunk-OQKMEFOS.js";
+} from "./chunk-ZKTFKHWN.js";
 import {
   FigmaClient,
   StorageManager,
@@ -52,7 +52,7 @@ import {
   renderAllComponentVariants,
   scanCodebase,
   shutdownSharedPool
-} from "./chunk-LVWFOLUZ.js";
+} from "./chunk-7K3VROEP.js";
 import "./chunk-D2CDBRNU.js";
 import {
   BRAND,
@@ -60,12 +60,12 @@ import {
   formatBytes,
   generateContext,
   resolvePerformanceConfig
-} from "./chunk-WFS63PCW.js";
+} from "./chunk-I34BC3CU.js";
 import "./chunk-Z7EY4VHE.js";
 
 // src/bin.ts
 import { Command } from "commander";
-import pc24 from "picocolors";
+import pc25 from "picocolors";
 import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
 import { dirname as dirname4, join as join11 } from "path";
@@ -1901,7 +1901,7 @@ ${BRAND.name} Dev Server
       }
     }
   }
-  const { createDevServer } = await import("./viewer-7ZEAFBVN.js");
+  const { createDevServer } = await import("./viewer-OBTEPVY7.js");
   console.log(pc7.dim("\nStarting dev server..."));
   const parsedPort = typeof port === "string" ? parseInt(port, 10) : port;
   try {
@@ -6023,6 +6023,205 @@ function escapeRegex(str) {
   return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 
+// src/commands/govern.ts
+import pc24 from "picocolors";
+async function governCheck(options = {}) {
+  console.log(pc24.cyan(`
+${BRAND.name} Governance Check
+`));
+  const { cliCheck, formatVerdict } = await import("@fragments-sdk/govern");
+  const result = await cliCheck(options);
+  const output = formatVerdict(result.verdict, options.format ?? "summary");
+  if (!options.quiet) {
+    console.log(output);
+    console.log();
+  }
+  if (result.verdict.passed) {
+    console.log(pc24.green(`\u2713 Governance check passed (score: ${result.verdict.score}/100)
+`));
+  } else {
+    console.log(pc24.red(`\u2717 Governance check failed (score: ${result.verdict.score}/100)
+`));
+  }
+  return { exitCode: result.exitCode };
+}
+async function governInit(options = {}) {
+  const { writeFile: writeFile10 } = await import("fs/promises");
+  const { resolve: resolve9 } = await import("path");
+  const { generateConfigTemplate } = await import("@fragments-sdk/govern");
+  const outputPath = resolve9(options.output ?? "fragments.config.ts");
+  const template = generateConfigTemplate();
+  await writeFile10(outputPath, template, "utf-8");
+  console.log(pc24.green(`\u2713 Created ${outputPath}
+`));
+}
+async function governConnect() {
+  const { readFile: readFile10, writeFile: writeFile10, appendFile } = await import("fs/promises");
+  const { existsSync: existsSync2 } = await import("fs");
+  const { resolve: resolve9 } = await import("path");
+  const { platform } = await import("os");
+  const { exec } = await import("child_process");
+  const { password, confirm } = await import("@inquirer/prompts");
+  const cloudUrl = process.env.FRAGMENTS_URL ?? "https://app.usefragments.com";
+  console.log(pc24.cyan(`
+  ${BRAND.name} \u2014 Connect to Cloud
+`));
+  console.log(
+    pc24.dim("  This will connect your project to the Fragments dashboard\n") + pc24.dim("  for centralized audit tracking and team visibility.\n")
+  );
+  console.log(pc24.bold("  Step 1 of 3: Get your API key\n"));
+  const dashboardUrl = `${cloudUrl}/dashboard/settings`;
+  console.log(pc24.dim(`  \u2192 Opening the dashboard in your browser...`));
+  console.log(pc24.dim(`    Copy your API key from Settings \u2192 API Keys
+`));
+  const os = platform();
+  const openCmd = os === "darwin" ? `open "${dashboardUrl}"` : os === "win32" ? `start "" "${dashboardUrl}"` : `xdg-open "${dashboardUrl}"`;
+  exec(openCmd);
+  let apiKey;
+  let orgName;
+  while (true) {
+    apiKey = await password({
+      message: "Paste your API key:",
+      mask: "*"
+    });
+    if (!apiKey.trim()) {
+      console.log(pc24.yellow("\n  API key cannot be empty. Please try again.\n"));
+      continue;
+    }
+    console.log(pc24.dim("\n  Verifying..."));
+    try {
+      const response = await fetch(`${cloudUrl}/api/verify`, {
+        headers: { Authorization: `Bearer ${apiKey.trim()}` }
+      });
+      if (!response.ok) {
+        console.log(pc24.red(`
+  \u2717 Invalid API key (HTTP ${response.status}). Please try again.
+`));
+        continue;
+      }
+      const data = await response.json();
+      if (!data.valid) {
+        console.log(pc24.red("\n  \u2717 API key not recognized. Please try again.\n"));
+        continue;
+      }
+      orgName = data.orgName ?? "your organization";
+      console.log(pc24.green(`
+  \u2713 Connected to "${orgName}" (verified)
+`));
+      break;
+    } catch (error) {
+      console.log(
+        pc24.red("\n  \u2717 Could not reach the dashboard.")
+      );
+      console.log(
+        pc24.dim(`    ${error instanceof Error ? error.message : "Network error"}
+`)
+      );
+      continue;
+    }
+  }
+  console.log(pc24.bold("  Step 2 of 3: Save configuration\n"));
+  const saveToEnv = await confirm({
+    message: "Save API key to .env file?",
+    default: true
+  });
+  if (saveToEnv) {
+    const envPath = resolve9(".env");
+    const envEntry = `FRAGMENTS_API_KEY=${apiKey.trim()}`;
+    if (existsSync2(envPath)) {
+      const envContent = await readFile10(envPath, "utf-8");
+      if (envContent.includes("FRAGMENTS_API_KEY=")) {
+        const updated = envContent.replace(
+          /^FRAGMENTS_API_KEY=.*$/m,
+          envEntry
+        );
+        await writeFile10(envPath, updated, "utf-8");
+        console.log(pc24.green("  \u2713 Updated FRAGMENTS_API_KEY in .env"));
+      } else {
+        await appendFile(envPath, `
+${envEntry}
+`, "utf-8");
+        console.log(pc24.green("  \u2713 Added FRAGMENTS_API_KEY to .env"));
+      }
+    } else {
+      await writeFile10(envPath, `${envEntry}
+`, "utf-8");
+      console.log(pc24.green("  \u2713 Created .env with FRAGMENTS_API_KEY"));
+    }
+    if (cloudUrl !== "https://app.usefragments.com") {
+      const envContent = await readFile10(envPath, "utf-8");
+      if (!envContent.includes("FRAGMENTS_URL=")) {
+        await appendFile(envPath, `FRAGMENTS_URL=${cloudUrl}
+`, "utf-8");
+        console.log(pc24.green(`  \u2713 Added FRAGMENTS_URL to .env`));
+      }
+    }
+    const gitignorePath = resolve9(".gitignore");
+    if (existsSync2(gitignorePath)) {
+      const gitignore = await readFile10(gitignorePath, "utf-8");
+      if (!gitignore.split("\n").some((line) => line.trim() === ".env")) {
+        await appendFile(gitignorePath, "\n.env\n", "utf-8");
+        console.log(pc24.green("  \u2713 Added .env to .gitignore"));
+      }
+    } else {
+      await writeFile10(gitignorePath, ".env\n", "utf-8");
+      console.log(pc24.green("  \u2713 Created .gitignore with .env entry"));
+    }
+  }
+  console.log(pc24.bold("\n  Step 3 of 3: Config check\n"));
+  const { findGovernConfig } = await import("@fragments-sdk/govern");
+  const configPath = findGovernConfig();
+  if (configPath) {
+    console.log(pc24.green(`  \u2713 Found govern config: ${configPath}`));
+  } else {
+    console.log(
+      pc24.yellow("  No govern config found \u2014 run `fragments govern init` to create one")
+    );
+  }
+  console.log(pc24.dim("\n  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n"));
+  console.log(pc24.green("  \u2713 All set!") + " Run `fragments govern check` to send your first audit.\n");
+  console.log(pc24.dim(`  Dashboard: ${cloudUrl}/dashboard
+`));
+}
+async function governReport() {
+  const { readFile: readFile10 } = await import("fs/promises");
+  console.log(pc24.cyan(`
+${BRAND.name} Governance Report
+`));
+  let raw;
+  try {
+    raw = await readFile10(".govern-audit.jsonl", "utf-8");
+  } catch {
+    console.log(pc24.yellow("No audit log found (.govern-audit.jsonl)\n"));
+    console.log(pc24.dim("Run `fragments govern check` to generate audit data.\n"));
+    return;
+  }
+  const lines = raw.trim().split("\n").filter(Boolean);
+  if (lines.length === 0) {
+    console.log(pc24.yellow("Audit log is empty.\n"));
+    return;
+  }
+  let totalScore = 0;
+  let passCount = 0;
+  let totalViolations = 0;
+  for (const line of lines) {
+    try {
+      const entry = JSON.parse(line);
+      totalScore += entry.score ?? 0;
+      if (entry.passed) passCount++;
+      totalViolations += entry.violationCount ?? 0;
+    } catch {
+    }
+  }
+  const avgScore = Math.round(totalScore / lines.length);
+  const passRate = Math.round(passCount / lines.length * 100);
+  console.log(`  Checks:     ${lines.length}`);
+  console.log(`  Pass rate:  ${passRate}%`);
+  console.log(`  Avg score:  ${avgScore}/100`);
+  console.log(`  Violations: ${totalViolations} total`);
+  console.log();
+}
+
 // src/bin.ts
 var __dirname = dirname4(fileURLToPath(import.meta.url));
 var pkg = JSON.parse(readFileSync(join11(__dirname, "../package.json"), "utf-8"));
@@ -6035,7 +6234,7 @@ program.command("validate").description("Validate fragment files").option("-c, -
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6051,7 +6250,7 @@ program.command("sync").description("Auto-update fragment files from component s
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6071,7 +6270,7 @@ program.command("build").description(`Build compiled ${BRAND.outFile} and ${BRAN
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6090,7 +6289,7 @@ program.command("context").description("Generate AI-ready context for your desig
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6117,7 +6316,7 @@ program.command("ai").description("Generate context optimized for AI assistants
       }
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6125,7 +6324,7 @@ program.command("list").description("List all discovered fragment files").option
   try {
     await list(options);
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6133,7 +6332,7 @@ program.command("reset").description("Reset to initial state (delete all generat
   try {
     await reset(options);
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6147,7 +6346,7 @@ linkCommand.command("figma").argument("[figma-url]", "Figma file URL to link com
       variants: options.variants
     });
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6162,7 +6361,7 @@ linkCommand.command("storybook").description("Bootstrap fragments from existing
       exclude: options.exclude
     });
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6177,9 +6376,9 @@ program.command("dev").description("Start the development server with live compo
       skipBuild: options.skipBuild
     });
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     if (error instanceof Error && error.stack) {
-      console.error(pc24.dim(error.stack));
+      console.error(pc25.dim(error.stack));
     }
     process.exit(1);
   }
@@ -6200,7 +6399,7 @@ program.command("screenshot").description("Capture screenshots of component vari
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6219,7 +6418,7 @@ program.command("diff").argument("[component]", "Component name to diff (optiona
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6238,8 +6437,8 @@ program.command("compare").argument("[component]", "Component name to compare").
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
-    console.log(pc24.dim(`
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
+    console.log(pc25.dim(`
 Make sure the dev server is running: ${BRAND.cliCommand} dev`));
     process.exit(1);
   }
@@ -6258,7 +6457,7 @@ program.command("analyze").description("Analyze design system and generate repor
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6277,7 +6476,7 @@ program.command("verify").argument("[component]", "Component name to verify (opt
     if (options.ci) {
       console.log(JSON.stringify({ error: error instanceof Error ? error.message : "Verification failed" }));
     } else {
-      console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -6294,7 +6493,7 @@ program.command("audit").description("Scan all fragments and show compliance met
     if (options.json) {
       console.log(JSON.stringify({ error: error instanceof Error ? error.message : "Audit failed" }));
     } else {
-      console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -6316,7 +6515,7 @@ program.command("a11y").description("Run accessibility checks on all component v
     if (options.json) {
       console.log(JSON.stringify({ error: error instanceof Error ? error.message : "A11y check failed" }));
     } else {
-      console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -6339,7 +6538,7 @@ program.command("enhance").description("AI-powered documentation generation from
     if (options.format === "json") {
       console.log(JSON.stringify({ success: false, error: error instanceof Error ? error.message : "Enhance failed" }));
     } else {
-      console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+      console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     }
     process.exit(1);
   }
@@ -6360,7 +6559,7 @@ program.command("scan").description(`Zero-config ${BRAND.outFile} generation fro
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6373,7 +6572,7 @@ program.command("storygen").description("Generate Storybook stories from fragmen
       format: options.format
     });
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6385,7 +6584,7 @@ program.command("metrics").argument("[component]", "Component name (optional, sh
       json: options.json
     });
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6399,9 +6598,9 @@ program.command("baseline").description("Manage visual regression baselines").ar
       port: options.port
     });
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     if (action === "update") {
-      console.log(pc24.dim(`
+      console.log(pc25.dim(`
 Make sure the dev server is running: ${BRAND.cliCommand} dev`));
     }
     process.exit(1);
@@ -6409,27 +6608,27 @@ Make sure the dev server is running: ${BRAND.cliCommand} dev`));
 });
 program.command("view").description(`Generate a static HTML viewer for ${BRAND.outFile}`).option("-i, --input <path>", `Path to ${BRAND.outFile}`, BRAND.outFile).option("-o, --output <path>", "Output HTML file path", BRAND.viewerHtmlFile).option("--open", "Open in browser after generation").action(async (options) => {
   try {
-    const { generateViewerFromJson } = await import("./static-viewer-5GXH2MGE.js");
+    const { generateViewerFromJson } = await import("./static-viewer-DUVC4UIM.js");
     const fs2 = await import("fs/promises");
     const path = await import("path");
     const inputPath = path.resolve(process.cwd(), options.input);
     const outputPath = path.resolve(process.cwd(), options.output);
-    console.log(pc24.cyan(`
+    console.log(pc25.cyan(`
 ${BRAND.name} Viewer Generator
 `));
     try {
       await fs2.access(inputPath);
     } catch {
-      console.log(pc24.red(`Error: ${options.input} not found.`));
-      console.log(pc24.dim(`
-Run ${pc24.cyan(`${BRAND.cliCommand} build`)} first to generate ${BRAND.outFile}
+      console.log(pc25.red(`Error: ${options.input} not found.`));
+      console.log(pc25.dim(`
+Run ${pc25.cyan(`${BRAND.cliCommand} build`)} first to generate ${BRAND.outFile}
 `));
       process.exit(1);
     }
-    console.log(pc24.dim(`Reading: ${options.input}`));
+    console.log(pc25.dim(`Reading: ${options.input}`));
     const html = await generateViewerFromJson(inputPath);
     await fs2.writeFile(outputPath, html);
-    console.log(pc24.green(`
+    console.log(pc25.green(`
 \u2713 Generated: ${options.output}
 `));
     if (options.open) {
@@ -6438,7 +6637,7 @@ Run ${pc24.cyan(`${BRAND.cliCommand} build`)} first to generate ${BRAND.outFile}
       exec(`${openCmd} "${outputPath}"`);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6451,7 +6650,7 @@ program.command("add").argument("[name]", 'Component name (e.g., "Button", "Text
       component: options.component
     });
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6468,13 +6667,13 @@ program.command("setup").description("Configure @fragments-sdk/ui in a consumer
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 program.command("init").description("Initialize fragments in a project (zero-config by default)").option("--force", "Overwrite existing config").option("-y, --yes", "Non-interactive mode (now the default)").option("--configure", "Interactive mode for theme seeds, snapshots, etc.").option("--scan <path>", "Scan a TypeScript component directory and generate fragment files").option("--enrich", "Use AI to fill knowledge fields during --scan (requires API key)").option("--dry-run", "Show what --enrich would generate without calling API").option("--provider <provider>", "AI provider for enrichment: anthropic or openai").option("--api-key <key>", "API key for AI enrichment").option("--model <model>", "Override AI model for enrichment").action(async (options) => {
   try {
-    const { init } = await import("./init-ZSX3NRCZ.js");
+    const { init } = await import("./init-U6534EMZ.js");
     const result = await init({
       projectRoot: process.cwd(),
       force: options.force,
@@ -6488,20 +6687,20 @@ program.command("init").description("Initialize fragments in a project (zero-con
       model: options.model
     });
     if (!result.success) {
-      console.error(pc24.red("\nInit failed with errors:"));
+      console.error(pc25.red("\nInit failed with errors:"));
       for (const error of result.errors) {
-        console.error(pc24.red(`  - ${error}`));
+        console.error(pc25.red(`  - ${error}`));
       }
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 program.command("snapshot").description("Run visual snapshot tests per component variant").option("-p, --port <port>", "Port of running dev server (skips starting one)").option("--update", "Update existing snapshots instead of comparing").option("--component <name>", "Filter to a specific component").option("--spec <path>", "Path to snapshot spec file").option("--ci", "CI mode - exit 1 on mismatch").action(async (options) => {
   try {
-    const { snapshot } = await import("./snapshot-XOISO2IS.js");
+    const { snapshot } = await import("./snapshot-C5DYIGIV.js");
     const result = await snapshot({
       port: options.port,
       update: options.update,
@@ -6513,13 +6712,13 @@ program.command("snapshot").description("Run visual snapshot tests per component
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 program.command("tokens").description("Discover and list design tokens from CSS/SCSS files").option("-c, --config <path>", "Path to config file").option("--json", "Output as JSON").option("--categories", "Group tokens by category").option("--theme <theme>", "Filter by theme name").option("--category <category>", "Filter by category (color, spacing, typography, etc.)").option("--verbose", "Show all tokens (no truncation)").action(async (options) => {
   try {
-    const { tokens } = await import("./tokens-T6SIVUT5.js");
+    const { tokens } = await import("./tokens-OPVTVITP.js");
     const result = await tokens({
       config: options.config,
       json: options.json,
@@ -6532,13 +6731,13 @@ program.command("tokens").description("Discover and list design tokens from CSS/
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 program.command("generate").description("Generate fragment files from component source code").argument("[component]", "Specific component name to generate (optional)").option("--force", "Overwrite existing fragment files").option("--pattern <glob>", "Pattern for component files", "src/components/**/*.tsx").action(async (component, options) => {
   try {
-    const { generate } = await import("./generate-RJFS2JWA.js");
+    const { generate } = await import("./generate-RYWIPDN2.js");
     const result = await generate({
       projectRoot: process.cwd(),
       component,
@@ -6546,11 +6745,11 @@ program.command("generate").description("Generate fragment files from component
       componentPattern: options.pattern
     });
     if (!result.success) {
-      console.error(pc24.red("\nGenerate completed with errors"));
+      console.error(pc25.red("\nGenerate completed with errors"));
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6558,7 +6757,7 @@ program.command("graph").description("Query the component relationship graph").a
   try {
     await graph(component, options);
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6576,14 +6775,14 @@ program.command("perf").description("Profile component bundle sizes and performa
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
 program.command("test").description("Run interaction tests for fragments with play functions").option("-c, --config <path>", "Path to config file").option("--component <name>", "Filter by component name").option("--tags <tags>", "Filter by tags (comma-separated)").option("--grep <pattern>", "Filter by variant name pattern").option("--exclude <pattern>", "Exclude tests matching pattern").option("--parallel <count>", "Number of parallel browser contexts", parseInt, 4).option("--timeout <ms>", "Timeout per test in milliseconds", parseInt, 3e4).option("--retries <count>", "Number of retries for failed tests", parseInt, 0).option("--bail", "Stop on first failure").option("--browser <name>", "Browser to use (chromium, firefox, webkit)", "chromium").option("--headed", "Run in headed mode (show browser)").option("--a11y", "Run accessibility checks with axe-core").option("--visual", "Capture screenshots for visual regression").option("--update-snapshots", "Update visual snapshots").option("--watch", "Watch mode - re-run on file changes").option("--reporters <names>", "Reporters to use (console, junit, json)", "console").option("-o, --output <dir>", "Output directory for results", "./test-results").option("--server-url <url>", "URL of running dev server (skips starting server)").option("-p, --port <port>", "Port for dev server", parseInt, 6006).option("--ci", "CI mode - non-interactive, exit with code 1 on failure").option("--list", "List available tests without running them").action(async (options) => {
   try {
     const { config, configDir } = await loadConfig(options.config);
-    const { runTestCommand, listTests } = await import("./test-SI4NSHQX.js");
+    const { runTestCommand, listTests } = await import("./test-JW7JIDFG.js");
     if (options.list) {
       await listTests(config, configDir, {
         component: options.component,
@@ -6616,7 +6815,7 @@ program.command("test").description("Run interaction tests for fragments with pl
     });
     process.exit(exitCode);
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });
@@ -6631,7 +6830,46 @@ program.command("doctor").description("Diagnose design system configuration issu
       process.exit(1);
     }
   } catch (error) {
-    console.error(pc24.red("Error:"), error instanceof Error ? error.message : error);
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
+var governCmd = program.command("govern").description("AI UI governance checks");
+governCmd.command("check").description("Validate a UISpec against governance policies").option("-i, --input <path>", "Path to UISpec JSON file (or - for stdin)").option("-c, --config <path>", "Path to govern.config.ts").option("-f, --format <format>", "Output format: summary, json, sarif", "summary").option("-q, --quiet", "Suppress non-error output").action(async (options) => {
+  try {
+    const { exitCode } = await governCheck({
+      input: options.input,
+      config: options.config,
+      format: options.format,
+      quiet: options.quiet
+    });
+    process.exit(exitCode);
+  } catch (error) {
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
+governCmd.command("init").description("Generate a fragments.config.ts with govern section").option("-o, --output <path>", "Output path", "fragments.config.ts").action(async (options) => {
+  try {
+    await governInit({ output: options.output });
+  } catch (error) {
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
+governCmd.command("report").description("Summarize governance audit log").action(async () => {
+  try {
+    await governReport();
+  } catch (error) {
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+});
+governCmd.command("connect").description("Connect your project to the Fragments Govern cloud dashboard").action(async () => {
+  try {
+    await governConnect();
+  } catch (error) {
+    console.error(pc25.red("Error:"), error instanceof Error ? error.message : error);
     process.exit(1);
   }
 });