@fragments-sdk/cli 0.14.3 → 0.15.1

package/dist/govern-scan-OYFZYOQW.js

@@ -0,0 +1,413 @@
+import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
+import "./chunk-D2CDBRNU.js";
+import {
+  BRAND
+} from "./chunk-32LIWN2P.js";
+
+// src/commands/govern-scan.ts
+import pc from "picocolors";
+import { resolve, relative } from "path";
+import { existsSync } from "fs";
+var SCAN_DEFAULT_RULES = {
+  "safety/no-dangerous-html": true,
+  "safety/sanitize-hrefs": true,
+  "safety/no-inline-scripts": true,
+  "safety/no-exposed-secrets": true,
+  "tokens/require-design-tokens": true
+};
+function detectRootDir(cwd) {
+  const candidates = ["src", "app", "pages", "components"];
+  for (const dir of candidates) {
+    if (existsSync(resolve(cwd, dir))) {
+      return cwd;
+    }
+  }
+  return cwd;
+}
+function groupByFile(usages) {
+  const grouped = /* @__PURE__ */ new Map();
+  for (const usage of usages) {
+    const existing = grouped.get(usage.filePath);
+    if (existing) {
+      existing.push(usage);
+    } else {
+      grouped.set(usage.filePath, [usage]);
+    }
+  }
+  return grouped;
+}
+async function governScan(options = {}) {
+  const {
+    loadPolicy,
+    createEngine,
+    buildAdaptersFromConfig,
+    createCloudAdapter,
+    formatVerdict,
+    computeComponentHealth
+  } = await import("@fragments-sdk/govern");
+  const { scanCodebase } = await import("./codebase-scanner-MQHUZC2G.js");
+  const { usagesToSpec } = await import("./converter-7XM3Y6NJ.js");
+  const format = options.format ?? "summary";
+  const quiet = options.quiet ?? false;
+  if (!quiet) {
+    console.log(pc.cyan(`
+${BRAND.name} Governance Scan
+`));
+  }
+  const rootDir = resolve(options.dir ?? detectRootDir(process.cwd()));
+  if (!quiet) {
+    console.log(pc.dim(`  Root: ${rootDir}
+`));
+  }
+  let policy = await loadPolicy(options.config);
+  const hasRules = Object.keys(policy.rules).length > 0;
+  if (!hasRules) {
+    policy = { ...policy, rules: SCAN_DEFAULT_RULES };
+    if (!quiet) {
+      console.log(pc.dim("  No config found \u2014 using scan defaults (safety + tokens)\n"));
+    }
+  }
+  let codeTokens;
+  if (process.env.FRAGMENTS_API_KEY) {
+    codeTokens = await extractCodeTokens(rootDir, options.config, quiet);
+  }
+  let contractRegistry;
+  let registryMap;
+  {
+    const { readFileSync, existsSync: existsSync2 } = await import("fs");
+    const fragmentsJsonPath = resolve(rootDir, "fragments.json");
+    if (existsSync2(fragmentsJsonPath)) {
+      try {
+        const raw = readFileSync(fragmentsJsonPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (parsed.fragments && Array.isArray(parsed.fragments)) {
+          const map = {};
+          for (const f of parsed.fragments) {
+            if (f.meta?.name) {
+              map[f.meta.name] = f;
+            }
+          }
+          registryMap = map;
+          if (process.env.FRAGMENTS_API_KEY) {
+            contractRegistry = JSON.stringify({ fragments: parsed.fragments });
+          }
+          if (!quiet) {
+            console.log(pc.dim(`  Contract registry loaded (${parsed.fragments.length} components)
+`));
+          }
+        }
+      } catch {
+      }
+    }
+  }
+  const adapters = buildAdaptersFromConfig(policy.audit);
+  const hasCloudAdapter = adapters.length > 0 && policy.audit?.cloud;
+  if (!hasCloudAdapter && process.env.FRAGMENTS_API_KEY) {
+    adapters.push(createCloudAdapter({ codeTokens, contractRegistry }));
+    if (!quiet) {
+      console.log(pc.dim("  Cloud audit enabled (FRAGMENTS_API_KEY detected)\n"));
+    }
+  }
+  const engine = createEngine(
+    policy,
+    adapters,
+    registryMap ? { registry: { fragments: registryMap } } : void 0
+  );
+  if (!quiet) {
+    console.log(pc.dim("  Scanning files...\n"));
+  }
+  const analysis = await scanCodebase({
+    rootDir,
+    useCache: true,
+    onProgress: quiet ? void 0 : (progress) => {
+      if (progress.phase === "scanning") {
+        process.stdout.write(
+          `\r  ${pc.dim(`[${progress.current}/${progress.total}]`)} ${pc.dim(relative(rootDir, progress.currentFile))}`
+        );
+      }
+    }
+  });
+  if (!quiet) {
+    process.stdout.write("\r" + " ".repeat(80) + "\r");
+    console.log(
+      pc.dim(`  Scanned ${analysis.totalFiles} files, found ${analysis.totalComponents} component types
+`)
+    );
+  }
+  const allUsages = [];
+  for (const comp of Object.values(analysis.components)) {
+    allUsages.push(...comp.usages);
+  }
+  if (allUsages.length === 0) {
+    if (!quiet) {
+      console.log(pc.yellow("  No component usages found.\n"));
+    }
+    return { exitCode: 0 };
+  }
+  const grouped = groupByFile(allUsages);
+  let totalFiles = 0;
+  let passedFiles = 0;
+  let totalViolations = 0;
+  const violationCounts = /* @__PURE__ */ new Map();
+  const allVerdicts = [];
+  const usageSnapshot = [];
+  for (const [filePath, usages] of grouped) {
+    const spec = usagesToSpec(usages, filePath, rootDir);
+    const relPath = relative(rootDir, filePath);
+    const verdict = await engine.check(spec, {
+      runner: "cli",
+      input: relPath
+    });
+    allVerdicts.push(verdict);
+    usageSnapshot.push({
+      file: relPath,
+      components: usages.map((u) => ({
+        name: u.componentName,
+        line: u.line,
+        props: {
+          static: u.props.static,
+          dynamic: u.props.dynamic
+        }
+      }))
+    });
+    totalFiles++;
+    if (verdict.passed) {
+      passedFiles++;
+    } else {
+      if (!quiet) {
+        console.log(pc.red(`  \u2717 ${relPath}`));
+        if (format === "summary") {
+          for (const result of verdict.results) {
+            for (const v of result.violations) {
+              const count = violationCounts.get(v.rule) ?? 0;
+              violationCounts.set(v.rule, count + 1);
+              totalViolations++;
+              console.log(
+                pc.dim(`    ${v.severity} `) + pc.yellow(v.rule) + pc.dim(` \u2014 ${v.message}`)
+              );
+              if (v.nodeId) {
+                console.log(pc.dim(`      at ${v.nodeId}`));
+              }
+            }
+          }
+        }
+      }
+    }
+    if (verdict.passed && !quiet && format === "summary") {
+      console.log(pc.green(`  \u2713 ${relPath}`) + pc.dim(` (${usages.length} components, score: ${verdict.score}/100)`));
+    }
+    if (format === "json" || format === "sarif") {
+      const output = formatVerdict(verdict, format);
+      console.log(output);
+    }
+  }
+  const health = computeComponentHealth(allVerdicts, registryMap ?? {});
+  if (!quiet && format === "summary") {
+    console.log(pc.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(`  Files checked:  ${totalFiles}`);
+    console.log(`  Passed:         ${passedFiles}/${totalFiles}`);
+    console.log(`  Violations:     ${totalViolations}`);
+    if (violationCounts.size > 0) {
+      console.log(pc.dim("\n  Top violations:"));
+      const sorted = [...violationCounts.entries()].sort((a, b) => b[1] - a[1]);
+      for (const [rule, count] of sorted.slice(0, 5)) {
+        console.log(pc.dim(`    ${count}\xD7 `) + pc.yellow(rule));
+      }
+    }
+    console.log(pc.dim("\n  Component Health:"));
+    console.log(`    Contract coverage:  ${health.contractCoverage}% (${health.contractedComponents}/${health.totalComponents})`);
+    console.log(`    Compliance rate:    ${health.overallCompliance}%`);
+    if (health.uncontracted.length > 0) {
+      console.log(pc.dim(`    Uncontracted:       ${health.uncontracted.slice(0, 5).join(", ")}${health.uncontracted.length > 5 ? ` (+${health.uncontracted.length - 5} more)` : ""}`));
+    }
+    console.log();
+    if (passedFiles === totalFiles) {
+      console.log(pc.green(`  \u2713 All files passed governance checks
+`));
+    } else {
+      console.log(
+        pc.red(`  \u2717 ${totalFiles - passedFiles} file(s) failed governance checks
+`)
+      );
+    }
+  }
+  if (process.env.FRAGMENTS_API_KEY && usageSnapshot.length > 0) {
+    try {
+      const apiKey = process.env.FRAGMENTS_API_KEY;
+      const url = process.env.FRAGMENTS_URL ?? "https://app.usefragments.com";
+      await fetch(`${url}/api/ingest`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${apiKey}`
+        },
+        body: JSON.stringify({
+          componentUsage: JSON.stringify(usageSnapshot),
+          componentHealth: JSON.stringify(health)
+        })
+      });
+    } catch {
+    }
+  }
+  return { exitCode: passedFiles === totalFiles ? 0 : 1 };
+}
+async function extractCodeTokens(rootDir, configPath, quiet) {
+  try {
+    try {
+      const { loadConfig } = await import("./node-37AUE74M.js");
+      const { parseTokenFiles } = await import("./service-QJGWUIVL.js");
+      const { config, configDir } = await loadConfig(configPath);
+      if (config.tokens?.include?.length) {
+        const result = await parseTokenFiles(config.tokens, configDir);
+        if (result.tokens.length > 0) {
+          const flat = {};
+          for (const token of result.tokens) {
+            flat[token.name] = token.resolvedValue;
+          }
+          if (!quiet) {
+            console.log(
+              pc.dim(`  Extracted ${result.tokens.length} code tokens from config
+`)
+            );
+          }
+          return JSON.stringify(flat);
+        }
+      }
+    } catch {
+    }
+    const {
+      findTailwindConfig,
+      loadTailwindConfig
+    } = await import("./token-normalizer-TEPOVBPV.js");
+    const tailwindPath = findTailwindConfig(rootDir);
+    if (tailwindPath) {
+      const tokens = await loadTailwindConfig(tailwindPath);
+      if (tokens.length > 0) {
+        const flat = {};
+        for (const token of tokens) {
+          flat[token.name] = token.value;
+        }
+        if (!quiet) {
+          console.log(
+            pc.dim(`  Extracted ${tokens.length} tokens from Tailwind config
+`)
+          );
+        }
+        return JSON.stringify(flat);
+      }
+    }
+  } catch (error) {
+    if (!quiet) {
+      console.log(
+        pc.dim(
+          `  Token extraction skipped: ${error instanceof Error ? error.message : "unknown error"}
+`
+        )
+      );
+    }
+  }
+  return void 0;
+}
+async function governWatch(options = {}) {
+  const {
+    loadPolicy,
+    createEngine,
+    buildAdaptersFromConfig,
+    createCloudAdapter,
+    formatVerdict
+  } = await import("@fragments-sdk/govern");
+  const { scanFile } = await import("./scanner-4KZNOXAK.js");
+  const { usagesToSpec } = await import("./converter-7XM3Y6NJ.js");
+  const quiet = options.quiet ?? false;
+  const debounceMs = options.debounce ?? 300;
+  const format = options.format ?? "summary";
+  console.log(pc.cyan(`
+${BRAND.name} Governance Watch
+`));
+  const { exitCode } = await governScan(options);
+  if (!quiet) {
+    console.log(
+      pc.dim(`  Initial scan ${exitCode === 0 ? "passed" : "completed with violations"}
+`)
+    );
+  }
+  const rootDir = resolve(options.dir ?? detectRootDir(process.cwd()));
+  let policy = await loadPolicy(options.config);
+  if (Object.keys(policy.rules).length === 0) {
+    policy = { ...policy, rules: SCAN_DEFAULT_RULES };
+  }
+  const adapters = buildAdaptersFromConfig(policy.audit);
+  if (!adapters.some(() => policy.audit?.cloud) && process.env.FRAGMENTS_API_KEY) {
+    adapters.push(createCloudAdapter());
+  }
+  const engine = createEngine(policy, adapters);
+  console.log(pc.dim("  Watching for changes... (Ctrl+C to stop)\n"));
+  const chokidar = await import("chokidar");
+  const watcher = chokidar.watch(
+    ["**/*.tsx", "**/*.ts", "**/*.jsx", "**/*.js"],
+    {
+      cwd: rootDir,
+      ignoreInitial: true,
+      ignored: [
+        "**/node_modules/**",
+        "**/dist/**",
+        "**/build/**",
+        "**/.next/**",
+        "**/*.test.*",
+        "**/*.spec.*",
+        "**/*.stories.*"
+      ],
+      awaitWriteFinish: { stabilityThreshold: debounceMs }
+    }
+  );
+  const handleChange = async (changedRelPath) => {
+    const absolutePath = resolve(rootDir, changedRelPath);
+    try {
+      const { usages } = await scanFile(absolutePath);
+      if (usages.length === 0) {
+        if (!quiet) {
+          console.log(pc.dim(`  \u25CB ${changedRelPath} \u2014 no component usages`));
+        }
+        return;
+      }
+      const spec = usagesToSpec(usages, absolutePath, rootDir);
+      const verdict = await engine.check(spec, {
+        runner: "cli",
+        input: changedRelPath
+      });
+      if (verdict.passed) {
+        console.log(
+          pc.green(`  \u2713 ${changedRelPath}`) + pc.dim(` (${usages.length} components, score: ${verdict.score}/100)`)
+        );
+      } else {
+        console.log(pc.red(`  \u2717 ${changedRelPath}`));
+        if (format === "summary") {
+          for (const result of verdict.results) {
+            for (const v of result.violations) {
+              console.log(
+                pc.dim(`    ${v.severity} `) + pc.yellow(v.rule) + pc.dim(` \u2014 ${v.message}`)
+              );
+            }
+          }
+        } else {
+          console.log(formatVerdict(verdict, format));
+        }
+      }
+    } catch (error) {
+      if (!quiet) {
+        console.log(
+          pc.dim(`  \u26A0 ${changedRelPath} \u2014 `) + pc.yellow(error instanceof Error ? error.message : "parse error")
+        );
+      }
+    }
+  };
+  watcher.on("change", handleChange);
+  watcher.on("add", handleChange);
+  await new Promise(() => {
+  });
+}
+export {
+  governScan,
+  governWatch
+};
+//# sourceMappingURL=govern-scan-OYFZYOQW.js.map

package/dist/govern-scan-OYFZYOQW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/govern-scan.ts"],"sourcesContent":["/**\n * govern scan / govern watch — Zero-config governance scanning\n *\n * Parses real JSX/TSX files via the existing codebase scanner, converts\n * component usages to UISpec, and runs governance checks per file.\n * Optionally submits results to Fragments Cloud.\n */\n\nimport pc from 'picocolors';\nimport { resolve, relative } from 'node:path';\nimport { existsSync } from 'node:fs';\nimport { BRAND } from '../core/index.js';\nimport type { ComponentUsage } from '../service/enhance/types.js';\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\nexport interface GovernScanOptions {\n  /** Root directory to scan (default: auto-detect) */\n  dir?: string;\n  /** Path to govern.config.ts */\n  config?: string;\n  /** Output format */\n  format?: 'summary' | 'json' | 'sarif';\n  /** Suppress non-error output */\n  quiet?: boolean;\n}\n\nexport interface GovernWatchOptions extends GovernScanOptions {\n  /** Debounce interval in ms (default: 300) */\n  debounce?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Scan defaults — applied when no config file exists\n// ---------------------------------------------------------------------------\n\nconst SCAN_DEFAULT_RULES: Record<string, boolean | object> = {\n  'safety/no-dangerous-html': true,\n  'safety/sanitize-hrefs': true,\n  'safety/no-inline-scripts': true,\n  'safety/no-exposed-secrets': true,\n  'tokens/require-design-tokens': true,\n};\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Auto-detect root directory by looking for common React project dirs\n */\nfunction detectRootDir(cwd: string): string {\n  const candidates = ['src', 'app', 'pages', 'components'];\n  for (const dir of candidates) {\n    if (existsSync(resolve(cwd, dir))) {\n      return cwd;\n    }\n  }\n  return cwd;\n}\n\n/**\n * Group component usages by their source file\n */\nfunction groupByFile(usages: ComponentUsage[]): Map<string, ComponentUsage[]> {\n  const grouped = new Map<string, ComponentUsage[]>();\n  for (const usage of usages) {\n    const existing = grouped.get(usage.filePath);\n    if (existing) {\n      existing.push(usage);\n    } else {\n      grouped.set(usage.filePath, [usage]);\n    }\n  }\n  return grouped;\n}\n\n// ---------------------------------------------------------------------------\n// governScan\n// ---------------------------------------------------------------------------\n\nexport async function governScan(\n  options: GovernScanOptions = {},\n): Promise<{ exitCode: number }> {\n  const {\n    loadPolicy,\n    createEngine,\n    buildAdaptersFromConfig,\n    createCloudAdapter,\n    formatVerdict,\n    computeComponentHealth,\n  } = await import('@fragments-sdk/govern');\n\n  const { scanCodebase } = await import(\n    '../service/enhance/codebase-scanner.js'\n  );\n  const { usagesToSpec } = await import(\n    '../service/enhance/converter.js'\n  );\n\n  const format = options.format ?? 'summary';\n  const quiet = options.quiet ?? false;\n\n  if (!quiet) {\n    console.log(pc.cyan(`\\n${BRAND.name} Governance Scan\\n`));\n  }\n\n  // 1. Resolve root directory\n  const rootDir = resolve(options.dir ?? detectRootDir(process.cwd()));\n  if (!quiet) {\n    console.log(pc.dim(`  Root: ${rootDir}\\n`));\n  }\n\n  // 2. Load policy — use scan defaults if no config exists\n  let policy = await loadPolicy(options.config);\n  const hasRules = Object.keys(policy.rules).length > 0;\n\n  if (!hasRules) {\n    policy = { ...policy, rules: SCAN_DEFAULT_RULES };\n    if (!quiet) {\n      console.log(pc.dim('  No config found — using scan defaults (safety + tokens)\\n'));\n    }\n  }\n\n  // 3. Extract code tokens for cloud ingest\n  let codeTokens: string | undefined;\n  if (process.env.FRAGMENTS_API_KEY) {\n    codeTokens = await extractCodeTokens(rootDir, options.config, quiet);\n  }\n\n  // 3b. Load contract registry for governance + cloud ingest (if fragments.json exists)\n  let contractRegistry: string | undefined;\n  let registryMap: Record<string, unknown> | undefined;\n  {\n    const { readFileSync, existsSync } = await import('node:fs');\n    const fragmentsJsonPath = resolve(rootDir, 'fragments.json');\n    if (existsSync(fragmentsJsonPath)) {\n      try {\n        const raw = readFileSync(fragmentsJsonPath, 'utf-8');\n        const parsed = JSON.parse(raw);\n        if (parsed.fragments && Array.isArray(parsed.fragments)) {\n          // Build name-keyed map for engine registry injection\n          const map: Record<string, unknown> = {};\n          for (const f of parsed.fragments) {\n            if (f.meta?.name) {\n              map[f.meta.name] = f;\n            }\n          }\n          registryMap = map;\n\n          if (process.env.FRAGMENTS_API_KEY) {\n            contractRegistry = JSON.stringify({ fragments: parsed.fragments });\n          }\n          if (!quiet) {\n            console.log(pc.dim(`  Contract registry loaded (${parsed.fragments.length} components)\\n`));\n          }\n        }\n      } catch {\n        // Invalid fragments.json — skip\n      }\n    }\n  }\n\n  // 4. Build adapters. Auto-add cloud if FRAGMENTS_API_KEY is set\n  const adapters = buildAdaptersFromConfig(policy.audit);\n  const hasCloudAdapter = adapters.length > 0 && policy.audit?.cloud;\n  if (!hasCloudAdapter && process.env.FRAGMENTS_API_KEY) {\n    adapters.push(createCloudAdapter({ codeTokens, contractRegistry }));\n    if (!quiet) {\n      console.log(pc.dim('  Cloud audit enabled (FRAGMENTS_API_KEY detected)\\n'));\n    }\n  }\n\n  // 5. Create engine (with registry for contract-aware validators)\n  const engine = createEngine(\n    policy,\n    adapters,\n    registryMap\n      ? { registry: { fragments: registryMap as Record<string, Record<string, unknown>> } }\n      : undefined,\n  );\n\n  // 6. Scan codebase\n  if (!quiet) {\n    console.log(pc.dim('  Scanning files...\\n'));\n  }\n\n  const analysis = await scanCodebase({\n    rootDir,\n    useCache: true,\n    onProgress: quiet\n      ? undefined\n      : (progress) => {\n          if (progress.phase === 'scanning') {\n            process.stdout.write(\n              `\\r  ${pc.dim(`[${progress.current}/${progress.total}]`)} ${pc.dim(relative(rootDir, progress.currentFile))}`,\n            );\n          }\n        },\n  });\n\n  if (!quiet) {\n    // Clear progress line\n    process.stdout.write('\\r' + ' '.repeat(80) + '\\r');\n    console.log(\n      pc.dim(`  Scanned ${analysis.totalFiles} files, found ${analysis.totalComponents} component types\\n`),\n    );\n  }\n\n  // 7. Collect all usages across components\n  const allUsages: ComponentUsage[] = [];\n  for (const comp of Object.values(analysis.components)) {\n    allUsages.push(...comp.usages);\n  }\n\n  if (allUsages.length === 0) {\n    if (!quiet) {\n      console.log(pc.yellow('  No component usages found.\\n'));\n    }\n    return { exitCode: 0 };\n  }\n\n  // 8. Group by file and run checks\n  const grouped = groupByFile(allUsages);\n  let totalFiles = 0;\n  let passedFiles = 0;\n  let totalViolations = 0;\n  const violationCounts = new Map<string, number>();\n  const allVerdicts: Awaited<ReturnType<typeof engine.check>>[] = [];\n\n  // Build per-file usage snapshot for cloud\n  const usageSnapshot: Array<{\n    file: string;\n    components: Array<{\n      name: string;\n      line: number;\n      props: { static: Record<string, unknown>; dynamic: string[] };\n    }>;\n  }> = [];\n\n  for (const [filePath, usages] of grouped) {\n    const spec = usagesToSpec(usages, filePath, rootDir);\n    const relPath = relative(rootDir, filePath);\n\n    const verdict = await engine.check(spec, {\n      runner: 'cli',\n      input: relPath,\n    });\n    allVerdicts.push(verdict);\n\n    // Collect per-file usage snapshot\n    usageSnapshot.push({\n      file: relPath,\n      components: usages.map((u) => ({\n        name: u.componentName,\n        line: u.line,\n        props: {\n          static: u.props.static,\n          dynamic: u.props.dynamic,\n        },\n      })),\n    });\n\n    totalFiles++;\n\n    if (verdict.passed) {\n      passedFiles++;\n    } else {\n      if (!quiet) {\n        console.log(pc.red(`  ✗ ${relPath}`));\n        if (format === 'summary') {\n          for (const result of verdict.results) {\n            for (const v of result.violations) {\n              const count = violationCounts.get(v.rule) ?? 0;\n              violationCounts.set(v.rule, count + 1);\n              totalViolations++;\n              console.log(\n                pc.dim(`    ${v.severity} `) +\n                pc.yellow(v.rule) +\n                pc.dim(` — ${v.message}`),\n              );\n              if (v.nodeId) {\n                console.log(pc.dim(`      at ${v.nodeId}`));\n              }\n            }\n          }\n        }\n      }\n    }\n\n    if (verdict.passed && !quiet && format === 'summary') {\n      console.log(pc.green(`  ✓ ${relPath}`) + pc.dim(` (${usages.length} components, score: ${verdict.score}/100)`));\n    }\n\n    // JSON/SARIF: print per-file\n    if (format === 'json' || format === 'sarif') {\n      const output = formatVerdict(verdict, format);\n      console.log(output);\n    }\n  }\n\n  // 8b. Compute component health\n  const health = computeComponentHealth(allVerdicts, registryMap ?? {});\n\n  // 9. Summary\n  if (!quiet && format === 'summary') {\n    console.log(pc.dim('\\n  ─────────────────────────────────────\\n'));\n    console.log(`  Files checked:  ${totalFiles}`);\n    console.log(`  Passed:         ${passedFiles}/${totalFiles}`);\n    console.log(`  Violations:     ${totalViolations}`);\n\n    if (violationCounts.size > 0) {\n      console.log(pc.dim('\\n  Top violations:'));\n      const sorted = [...violationCounts.entries()].sort((a, b) => b[1] - a[1]);\n      for (const [rule, count] of sorted.slice(0, 5)) {\n        console.log(pc.dim(`    ${count}× `) + pc.yellow(rule));\n      }\n    }\n\n    // Component health\n    console.log(pc.dim('\\n  Component Health:'));\n    console.log(`    Contract coverage:  ${health.contractCoverage}% (${health.contractedComponents}/${health.totalComponents})`);\n    console.log(`    Compliance rate:    ${health.overallCompliance}%`);\n\n    if (health.uncontracted.length > 0) {\n      console.log(pc.dim(`    Uncontracted:       ${health.uncontracted.slice(0, 5).join(', ')}${health.uncontracted.length > 5 ? ` (+${health.uncontracted.length - 5} more)` : ''}`));\n    }\n\n    console.log();\n\n    if (passedFiles === totalFiles) {\n      console.log(pc.green(`  ✓ All files passed governance checks\\n`));\n    } else {\n      console.log(\n        pc.red(`  ✗ ${totalFiles - passedFiles} file(s) failed governance checks\\n`),\n      );\n    }\n  }\n\n  // 10. Push component usage snapshot + health to Cloud (if API key set)\n  if (process.env.FRAGMENTS_API_KEY && usageSnapshot.length > 0) {\n    try {\n      const apiKey = process.env.FRAGMENTS_API_KEY;\n      const url = process.env.FRAGMENTS_URL ?? 'https://app.usefragments.com';\n      await fetch(`${url}/api/ingest`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          Authorization: `Bearer ${apiKey}`,\n        },\n        body: JSON.stringify({\n          componentUsage: JSON.stringify(usageSnapshot),\n          componentHealth: JSON.stringify(health),\n        }),\n      });\n    } catch {\n      // Non-critical — don't fail the scan\n    }\n  }\n\n  return { exitCode: passedFiles === totalFiles ? 0 : 1 };\n}\n\n// ---------------------------------------------------------------------------\n// Token extraction for cloud ingest\n// ---------------------------------------------------------------------------\n\n/**\n * Auto-detect and extract code tokens to send alongside governance verdicts.\n * Tries: 1) tokens config from fragments.config.ts, 2) Tailwind config.\n * Returns a flat JSON string of token name → value, or undefined if nothing found.\n */\nasync function extractCodeTokens(\n  rootDir: string,\n  configPath?: string,\n  quiet?: boolean,\n): Promise<string | undefined> {\n  try {\n    // 1. Try fragments.config.ts tokens config\n    try {\n      const { loadConfig } = await import('../core/node.js');\n      const { parseTokenFiles } = await import('../service/index.js');\n\n      const { config, configDir } = await loadConfig(configPath);\n      if (config.tokens?.include?.length) {\n        const result = await parseTokenFiles(config.tokens, configDir);\n        if (result.tokens.length > 0) {\n          const flat: Record<string, string> = {};\n          for (const token of result.tokens) {\n            flat[token.name] = token.resolvedValue;\n          }\n          if (!quiet) {\n            console.log(\n              pc.dim(`  Extracted ${result.tokens.length} code tokens from config\\n`),\n            );\n          }\n          return JSON.stringify(flat);\n        }\n      }\n    } catch {\n      // No config or no tokens section — fall through\n    }\n\n    // 2. Try Tailwind config\n    const {\n      findTailwindConfig,\n      loadTailwindConfig,\n    } = await import('../service/token-normalizer.js');\n\n    const tailwindPath = findTailwindConfig(rootDir);\n    if (tailwindPath) {\n      const tokens = await loadTailwindConfig(tailwindPath);\n      if (tokens.length > 0) {\n        const flat: Record<string, string> = {};\n        for (const token of tokens) {\n          flat[token.name] = token.value;\n        }\n        if (!quiet) {\n          console.log(\n            pc.dim(`  Extracted ${tokens.length} tokens from Tailwind config\\n`),\n          );\n        }\n        return JSON.stringify(flat);\n      }\n    }\n  } catch (error) {\n    if (!quiet) {\n      console.log(\n        pc.dim(\n          `  Token extraction skipped: ${error instanceof Error ? error.message : 'unknown error'}\\n`,\n        ),\n      );\n    }\n  }\n\n  return undefined;\n}\n\n// ---------------------------------------------------------------------------\n// governWatch\n// ---------------------------------------------------------------------------\n\nexport async function governWatch(\n  options: GovernWatchOptions = {},\n): Promise<void> {\n  const {\n    loadPolicy,\n    createEngine,\n    buildAdaptersFromConfig,\n    createCloudAdapter,\n    formatVerdict,\n  } = await import('@fragments-sdk/govern');\n\n  const { scanFile } = await import('../service/enhance/scanner.js');\n  const { usagesToSpec } = await import(\n    '../service/enhance/converter.js'\n  );\n\n  const quiet = options.quiet ?? false;\n  const debounceMs = options.debounce ?? 300;\n  const format = options.format ?? 'summary';\n\n  // 1. Run initial scan\n  console.log(pc.cyan(`\\n${BRAND.name} Governance Watch\\n`));\n\n  const { exitCode } = await governScan(options);\n  if (!quiet) {\n    console.log(\n      pc.dim(`  Initial scan ${exitCode === 0 ? 'passed' : 'completed with violations'}\\n`),\n    );\n  }\n\n  // 2. Set up engine for incremental checks\n  const rootDir = resolve(options.dir ?? detectRootDir(process.cwd()));\n  let policy = await loadPolicy(options.config);\n  if (Object.keys(policy.rules).length === 0) {\n    policy = { ...policy, rules: SCAN_DEFAULT_RULES };\n  }\n  const adapters = buildAdaptersFromConfig(policy.audit);\n  if (!adapters.some(() => policy.audit?.cloud) && process.env.FRAGMENTS_API_KEY) {\n    adapters.push(createCloudAdapter());\n  }\n  const engine = createEngine(policy, adapters);\n\n  // 3. Watch for changes\n  console.log(pc.dim('  Watching for changes... (Ctrl+C to stop)\\n'));\n\n  const chokidar = await import('chokidar');\n\n  const watcher = chokidar.watch(\n    ['**/*.tsx', '**/*.ts', '**/*.jsx', '**/*.js'],\n    {\n      cwd: rootDir,\n      ignoreInitial: true,\n      ignored: [\n        '**/node_modules/**',\n        '**/dist/**',\n        '**/build/**',\n        '**/.next/**',\n        '**/*.test.*',\n        '**/*.spec.*',\n        '**/*.stories.*',\n      ],\n      awaitWriteFinish: { stabilityThreshold: debounceMs },\n    },\n  );\n\n  const handleChange = async (changedRelPath: string) => {\n    const absolutePath = resolve(rootDir, changedRelPath);\n\n    try {\n      const { usages } = await scanFile(absolutePath);\n\n      if (usages.length === 0) {\n        if (!quiet) {\n          console.log(pc.dim(`  ○ ${changedRelPath} — no component usages`));\n        }\n        return;\n      }\n\n      const spec = usagesToSpec(usages, absolutePath, rootDir);\n      const verdict = await engine.check(spec, {\n        runner: 'cli',\n        input: changedRelPath,\n      });\n\n      if (verdict.passed) {\n        console.log(\n          pc.green(`  ✓ ${changedRelPath}`) +\n          pc.dim(` (${usages.length} components, score: ${verdict.score}/100)`),\n        );\n      } else {\n        console.log(pc.red(`  ✗ ${changedRelPath}`));\n        if (format === 'summary') {\n          for (const result of verdict.results) {\n            for (const v of result.violations) {\n              console.log(\n                pc.dim(`    ${v.severity} `) +\n                pc.yellow(v.rule) +\n                pc.dim(` — ${v.message}`),\n              );\n            }\n          }\n        } else {\n          console.log(formatVerdict(verdict, format));\n        }\n      }\n    } catch (error) {\n      if (!quiet) {\n        console.log(\n          pc.dim(`  ⚠ ${changedRelPath} — `) +\n          pc.yellow(error instanceof Error ? error.message : 'parse error'),\n        );\n      }\n    }\n  };\n\n  watcher.on('change', handleChange);\n  watcher.on('add', handleChange);\n\n  // Keep process alive\n  await new Promise(() => {});\n}\n"],"mappings":"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","names":["existsSync"]}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { FragmentsConfig, Theme, DiffResult, CompiledFragmentsFile } from '@fragments-sdk/core';
 export { FragmentsConfig, defineBlock, defineFragment } from '@fragments-sdk/core';
+export { BuildResult, buildFragments } from '@fragments-sdk/compiler';
 export { CLI_COMMANDS, CLI_COMMAND_CATEGORIES, CliCategoryInfo, CliCommandCategory, CliCommandDef, CliOptionDef } from '@fragments-sdk/context/cli-commands';
 
 /**
@@ -22,7 +23,8 @@ interface DiscoveredFile {
     relativePath: string;
 }
 /**
- * Discover fragment files matching the config patterns
+ * Discover fragment files matching the config patterns.
+ * Also discovers .contract.json files for framework-agnostic component contracts.
  */
 declare function discoverFragmentFiles(config: FragmentsConfig, configDir: string): Promise<DiscoveredFile[]>;
 /**
@@ -71,27 +73,6 @@ declare function validateAll(config: FragmentsConfig, configDir: string, options
  */
 declare function validateSnippets(config: FragmentsConfig, configDir: string, options?: ValidationRunOptions): Promise<ValidationResult>;
 
-interface BuildResult {
-    success: boolean;
-    outputPath: string;
-    fragmentCount: number;
-    errors: Array<{
-        file: string;
-        error: string;
-    }>;
-    warnings: Array<{
-        file: string;
-        warning: string;
-    }>;
-}
-/**
- * Build compiled fragments.json file for AI consumption.
- *
- * Uses AST parsing to extract metadata WITHOUT executing fragment files.
- * This means the build works without any project dependencies installed.
- */
-declare function buildFragments(config: FragmentsConfig, configDir: string): Promise<BuildResult>;
-
 /**
  * Options for the screenshot command
  */
@@ -399,4 +380,4 @@ declare function generateStaticViewer(data: CompiledFragmentsFile): string;
  */
 declare function generateViewerFromJson(jsonPath: string): Promise<string>;
 
-export { type AnalyzeOptions, type AnalyzeResult, type BuildResult, type DiffCommandOptions, type DiffCommandResult, type DiscoveredFile, type ScreenshotCommandOptions, type ScreenshotResult, type ValidationError, type ValidationResult, type ValidationRunOptions, type ValidationWarning, type VariantDiffResult, buildFragments, discoverComponentFiles, discoverFragmentFiles, extractComponentName, findConfigFile, generateStaticViewer, generateViewerFromJson, loadConfig, runAnalyzeCommand, runDiffCommand, runScreenshotCommand, validateAll, validateCoverage, validateSchema, validateSnippets };
+export { type AnalyzeOptions, type AnalyzeResult, type DiffCommandOptions, type DiffCommandResult, type DiscoveredFile, type ScreenshotCommandOptions, type ScreenshotResult, type ValidationError, type ValidationResult, type ValidationRunOptions, type ValidationWarning, type VariantDiffResult, discoverComponentFiles, discoverFragmentFiles, extractComponentName, findConfigFile, generateStaticViewer, generateViewerFromJson, loadConfig, runAnalyzeCommand, runDiffCommand, runScreenshotCommand, validateAll, validateCoverage, validateSchema, validateSnippets };

package/dist/index.js

@@ -2,9 +2,8 @@ import { createRequire as __banner_createRequire } from 'module'; const require
 import {
   generateStaticViewer,
   generateViewerFromJson
-} from "./chunk-TXFCEDOC.js";
+} from "./chunk-2WXKALIG.js";
 import {
-  buildFragments,
   runAnalyzeCommand,
   runDiffCommand,
   runScreenshotCommand,
@@ -12,24 +11,26 @@ import {
   validateCoverage,
   validateSchema,
   validateSnippets
-} from "./chunk-LOYS64QS.js";
-import "./chunk-EYXVAMEX.js";
-import {
-  findConfigFile,
-  loadConfig
-} from "./chunk-55KERLWL.js";
+} from "./chunk-5JF26E55.js";
+import "./chunk-6SQPP47U.js";
+import "./chunk-D2CDBRNU.js";
 import {
   discoverComponentFiles,
   discoverFragmentFiles,
-  extractComponentName
-} from "./chunk-ZKTFKHWN.js";
-import "./chunk-APTQIBS5.js";
-import "./chunk-D2CDBRNU.js";
+  extractComponentName,
+  findConfigFile,
+  loadConfig
+} from "./chunk-HQ6A6DTV.js";
 import {
   defineBlock,
   defineFragment
-} from "./chunk-I34BC3CU.js";
-import "./chunk-Z7EY4VHE.js";
+} from "./chunk-32LIWN2P.js";
+import "./chunk-MHIBEEW4.js";
+import "./chunk-QCN35LJU.js";
+import "./chunk-7DZC4YEV.js";
+
+// src/index.ts
+import { buildFragments } from "@fragments-sdk/compiler";
 
 // src/cli-commands.ts
 import {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli-commands.ts"],"sourcesContent":["/**\n * CLI command metadata — re-exported from @fragments-sdk/context for convenience.\n *\n * The source of truth lives in @fragments-sdk/context/cli-commands so that\n * browser-safe consumers (like the docs site) can import without pulling in\n * Node.js dependencies from the CLI package.\n */\nexport {\n  CLI_COMMANDS,\n  CLI_COMMAND_CATEGORIES,\n} from '@fragments-sdk/context/cli-commands';\n\nexport type {\n  CliCommandDef,\n  CliOptionDef,\n  CliCommandCategory,\n  CliCategoryInfo,\n} from '@fragments-sdk/context/cli-commands';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA;AAAA,EACE;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/cli-commands.ts"],"sourcesContent":["// Re-export from core/node (Node.js-only APIs)\nexport {\n  loadConfig,\n  findConfigFile,\n  discoverFragmentFiles,\n  discoverComponentFiles,\n  extractComponentName,\n} from \"./core/node.js\";\nexport type { DiscoveredFile } from \"./core/node.js\";\n\n// Validators\nexport { validateSchema, validateCoverage, validateAll, validateSnippets } from \"./validators.js\";\nexport type {\n  ValidationResult,\n  ValidationError,\n  ValidationWarning,\n  ValidationRunOptions,\n} from \"./validators.js\";\n\n// Build (delegated to @fragments-sdk/compiler)\nexport { buildFragments } from '@fragments-sdk/compiler';\nexport type { BuildResult } from '@fragments-sdk/compiler';\n\n// Screenshot\nexport { runScreenshotCommand } from \"./screenshot.js\";\nexport type {\n  ScreenshotCommandOptions,\n  ScreenshotResult,\n} from \"./screenshot.js\";\n\n// Diff\nexport { runDiffCommand } from \"./diff.js\";\nexport type {\n  DiffCommandOptions,\n  DiffCommandResult,\n  VariantDiffResult,\n} from \"./diff.js\";\n\n// Analyze\nexport { runAnalyzeCommand } from \"./analyze.js\";\nexport type { AnalyzeOptions, AnalyzeResult } from \"./analyze.js\";\n\n// Static Viewer\nexport { generateStaticViewer, generateViewerFromJson } from \"./static-viewer.js\";\n\n// Config type (used by generated fragments.config.ts)\nexport type { FragmentsConfig } from \"./core/index.js\";\n\n// Fragment definition API (used by generated .fragment.tsx files)\nexport { defineFragment, defineBlock } from \"./core/index.js\";\n\n// CLI Command metadata (for docs)\nexport { CLI_COMMANDS, CLI_COMMAND_CATEGORIES } from \"./cli-commands.js\";\nexport type { CliCommandDef, CliOptionDef, CliCommandCategory, CliCategoryInfo } from \"./cli-commands.js\";\n","/**\n * CLI command metadata — re-exported from @fragments-sdk/context for convenience.\n *\n * The source of truth lives in @fragments-sdk/context/cli-commands so that\n * browser-safe consumers (like the docs site) can import without pulling in\n * Node.js dependencies from the CLI package.\n */\nexport {\n  CLI_COMMANDS,\n  CLI_COMMAND_CATEGORIES,\n} from '@fragments-sdk/context/cli-commands';\n\nexport type {\n  CliCommandDef,\n  CliOptionDef,\n  CliCommandCategory,\n  CliCategoryInfo,\n} from '@fragments-sdk/context/cli-commands';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,SAAS,sBAAsB;;;ACb/B;AAAA,EACE;AAAA,EACA;AAAA,OACK;","names":[]}