@fragments-sdk/cli 0.13.0 → 0.14.0

package/dist/bin.js

@@ -7,7 +7,7 @@ import {
 } from "./chunk-SXTKFDCR.js";
 import {
   setup
-} from "./chunk-DXX6HADE.js";
+} from "./chunk-PJT5IZ37.js";
 import {
   buildFragments,
   buildFragmentsDir,
@@ -22,21 +22,21 @@ import {
   validateDrift,
   validateSchema,
   validateSnippets
-} from "./chunk-RF3C6LGA.js";
+} from "./chunk-FZLPVN32.js";
 import {
   createComponentExtractor
 } from "./chunk-EYXVAMEX.js";
 import {
   scan
-} from "./chunk-FO6EBJWP.js";
+} from "./chunk-Z5BUXIFJ.js";
 import {
   loadConfig,
   loadFragmentFile,
   parseFragmentFile
-} from "./chunk-3SOAPJDX.js";
+} from "./chunk-55KERLWL.js";
 import {
   discoverFragmentFiles
-} from "./chunk-SM674YAS.js";
+} from "./chunk-ZKTFKHWN.js";
 import {
   FigmaClient,
   StorageManager,
@@ -52,7 +52,7 @@ import {
   renderAllComponentVariants,
   scanCodebase,
   shutdownSharedPool
-} from "./chunk-4K7EAQ5L.js";
+} from "./chunk-7K3VROEP.js";
 import "./chunk-D2CDBRNU.js";
 import {
   BRAND,
@@ -60,7 +60,7 @@ import {
   formatBytes,
   generateContext,
   resolvePerformanceConfig
-} from "./chunk-QM7SVOGF.js";
+} from "./chunk-I34BC3CU.js";
 import "./chunk-Z7EY4VHE.js";
 
 // src/bin.ts
@@ -1901,7 +1901,7 @@ ${BRAND.name} Dev Server
       }
     }
   }
-  const { createDevServer } = await import("./viewer-M2EQQSGE.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 {
@@ -6049,12 +6049,140 @@ 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 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(`
@@ -6480,7 +6608,7 @@ 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-KKCR4KXR.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);
@@ -6543,9 +6671,19 @@ program.command("setup").description("Configure @fragments-sdk/ui in a consumer
     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) => {
+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("--cloud", "Set up Fragments Cloud governance (zero-config browser auth)").option("--cloud-url <url>", "Cloud dashboard URL (default: https://app.usefragments.com)").option("--port <port>", "Localhost port for auth callback (default: 9876)").option("--auth-only", "Only authenticate, skip project setup").option("--skip-check", "Skip running the first governance check").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-XK6PRUE5.js");
+    if (options.cloud) {
+      const { initCloud } = await import("./init-cloud-REQ3XLHO.js");
+      await initCloud({
+        url: options.cloudUrl,
+        port: options.port ? Number(options.port) : void 0,
+        authOnly: options.authOnly,
+        skipCheck: options.skipCheck
+      });
+      return;
+    }
+    const { init } = await import("./init-U6534EMZ.js");
     const result = await init({
       projectRoot: process.cwd(),
       force: options.force,
@@ -6572,7 +6710,7 @@ program.command("init").description("Initialize fragments in a project (zero-con
 });
 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-53TUR3HW.js");
+    const { snapshot } = await import("./snapshot-C5DYIGIV.js");
     const result = await snapshot({
       port: options.port,
       update: options.update,
@@ -6590,7 +6728,7 @@ program.command("snapshot").description("Run visual snapshot tests per component
 });
 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-L46MK5AW.js");
+    const { tokens } = await import("./tokens-OPVTVITP.js");
     const result = await tokens({
       config: options.config,
       json: options.json,
@@ -6609,7 +6747,7 @@ program.command("tokens").description("Discover and list design tokens from CSS/
 });
 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-QZXOXYFW.js");
+    const { generate } = await import("./generate-RYWIPDN2.js");
     const result = await generate({
       projectRoot: process.cwd(),
       component,
@@ -6654,7 +6792,7 @@ program.command("perf").description("Profile component bundle sizes and performa
 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-5UCKXYSC.js");
+    const { runTestCommand, listTests } = await import("./test-JW7JIDFG.js");
     if (options.list) {
       await listTests(config, configDir, {
         component: options.component,
@@ -6721,7 +6859,7 @@ governCmd.command("check").description("Validate a UISpec against governance pol
     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) => {
+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) {
@@ -6737,5 +6875,13 @@ governCmd.command("report").description("Summarize governance audit log").action
     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);
+  }
+});
 program.parse();
 //# sourceMappingURL=bin.js.map