@fragments-sdk/cli 0.12.1 → 0.13.0

package/dist/bin.js

@@ -7,7 +7,7 @@ import {
 } from "./chunk-SXTKFDCR.js";
 import {
   setup
-} from "./chunk-T5OMVL7E.js";
+} from "./chunk-DXX6HADE.js";
 import {
   buildFragments,
   buildFragmentsDir,
@@ -22,21 +22,21 @@ import {
   validateDrift,
   validateSchema,
   validateSnippets
-} from "./chunk-GVDSFQ4E.js";
+} from "./chunk-RF3C6LGA.js";
 import {
   createComponentExtractor
-} from "./chunk-JJ2VRTBU.js";
+} from "./chunk-EYXVAMEX.js";
 import {
   scan
-} from "./chunk-TPWGL2XS.js";
+} from "./chunk-FO6EBJWP.js";
 import {
   loadConfig,
   loadFragmentFile,
   parseFragmentFile
-} from "./chunk-AM4MRTMN.js";
+} from "./chunk-3SOAPJDX.js";
 import {
   discoverFragmentFiles
-} from "./chunk-OQKMEFOS.js";
+} from "./chunk-SM674YAS.js";
 import {
   FigmaClient,
   StorageManager,
@@ -52,7 +52,7 @@ import {
   renderAllComponentVariants,
   scanCodebase,
   shutdownSharedPool
-} from "./chunk-LVWFOLUZ.js";
+} from "./chunk-4K7EAQ5L.js";
 import "./chunk-D2CDBRNU.js";
 import {
   BRAND,
@@ -60,12 +60,12 @@ import {
   formatBytes,
   generateContext,
   resolvePerformanceConfig
-} from "./chunk-WFS63PCW.js";
+} from "./chunk-QM7SVOGF.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-M2EQQSGE.js");
   console.log(pc7.dim("\nStarting dev server..."));
   const parsedPort = typeof port === "string" ? parseInt(port, 10) : port;
   try {
@@ -6023,6 +6023,77 @@ 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 ?? "govern.config.ts");
+  const template = generateConfigTemplate();
+  await writeFile10(outputPath, template, "utf-8");
+  console.log(pc24.green(`\u2713 Created ${outputPath}
+`));
+}
+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 +6106,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 +6122,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 +6142,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 +6161,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 +6188,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 +6196,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 +6204,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 +6218,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 +6233,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 +6248,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 +6271,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 +6290,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 +6309,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 +6329,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 +6348,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 +6365,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 +6387,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 +6410,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 +6431,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 +6444,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 +6456,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 +6470,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 +6480,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-KKCR4KXR.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 +6509,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 +6522,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 +6539,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-XK6PRUE5.js");
     const result = await init({
       projectRoot: process.cwd(),
       force: options.force,
@@ -6488,20 +6559,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-53TUR3HW.js");
     const result = await snapshot({
       port: options.port,
       update: options.update,
@@ -6513,13 +6584,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-L46MK5AW.js");
     const result = await tokens({
       config: options.config,
       json: options.json,
@@ -6532,13 +6603,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-QZXOXYFW.js");
     const result = await generate({
       projectRoot: process.cwd(),
       component,
@@ -6546,11 +6617,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 +6629,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 +6647,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-5UCKXYSC.js");
     if (options.list) {
       await listTests(config, configDir, {
         component: options.component,
@@ -6616,7 +6687,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 +6702,38 @@ 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 govern.config.ts template").option("-o, --output <path>", "Output path", "govern.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);
   }
 });