@fragments-sdk/cli 0.13.0 → 0.13.1

package/dist/{scan-CHQHXWVD.js → scan-LE2JEIJ4.js}

@@ -1,14 +1,14 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
 import {
   scan
-} from "./chunk-FO6EBJWP.js";
-import "./chunk-3SOAPJDX.js";
-import "./chunk-SM674YAS.js";
-import "./chunk-4K7EAQ5L.js";
+} from "./chunk-Z5BUXIFJ.js";
+import "./chunk-55KERLWL.js";
+import "./chunk-ZKTFKHWN.js";
+import "./chunk-7K3VROEP.js";
 import "./chunk-D2CDBRNU.js";
-import "./chunk-QM7SVOGF.js";
+import "./chunk-I34BC3CU.js";
 import "./chunk-Z7EY4VHE.js";
 export {
   scan
 };
-//# sourceMappingURL=scan-CHQHXWVD.js.map
+//# sourceMappingURL=scan-LE2JEIJ4.js.map

package/dist/{scan-generate-U3RFVDTX.js → scan-generate-TFZVL3BT.js}

@@ -2,14 +2,14 @@ import { createRequire as __banner_createRequire } from 'module'; const require
 import {
   createComponentExtractor
 } from "./chunk-EYXVAMEX.js";
-import "./chunk-3SOAPJDX.js";
+import "./chunk-55KERLWL.js";
 import {
   discoverAllComponents
-} from "./chunk-SM674YAS.js";
+} from "./chunk-ZKTFKHWN.js";
 import "./chunk-D2CDBRNU.js";
 import {
   BRAND
-} from "./chunk-QM7SVOGF.js";
+} from "./chunk-I34BC3CU.js";
 import "./chunk-Z7EY4VHE.js";
 
 // src/commands/scan-generate.ts
@@ -1112,4 +1112,4 @@ export {
   parseEnrichmentResponse,
   scanGenerate
 };
-//# sourceMappingURL=scan-generate-U3RFVDTX.js.map
+//# sourceMappingURL=scan-generate-TFZVL3BT.js.map

package/dist/{service-MMEKG4MZ.js → service-S5LXPKV4.js}

@@ -97,12 +97,12 @@ import {
   shutdownSharedPool,
   sleep,
   summarizePatternsForPrompt
-} from "./chunk-4K7EAQ5L.js";
+} from "./chunk-7K3VROEP.js";
 import "./chunk-D2CDBRNU.js";
 import {
   BRAND,
   DEFAULTS
-} from "./chunk-QM7SVOGF.js";
+} from "./chunk-I34BC3CU.js";
 import "./chunk-Z7EY4VHE.js";
 export {
   BRAND,
@@ -206,4 +206,4 @@ export {
   sleep,
   summarizePatternsForPrompt
 };
-//# sourceMappingURL=service-MMEKG4MZ.js.map
+//# sourceMappingURL=service-S5LXPKV4.js.map

package/dist/{snapshot-53TUR3HW.js → snapshot-C5DYIGIV.js}

@@ -2,7 +2,7 @@ import { createRequire as __banner_createRequire } from 'module'; const require
 import "./chunk-D2CDBRNU.js";
 import {
   BRAND
-} from "./chunk-QM7SVOGF.js";
+} from "./chunk-I34BC3CU.js";
 import "./chunk-Z7EY4VHE.js";
 
 // src/commands/snapshot.ts
@@ -136,4 +136,4 @@ ${BRAND.name} Visual Snapshots
 export {
   snapshot
 };
-//# sourceMappingURL=snapshot-53TUR3HW.js.map
+//# sourceMappingURL=snapshot-C5DYIGIV.js.map

package/dist/{static-viewer-KKCR4KXR.js → static-viewer-DUVC4UIM.js}

@@ -2,12 +2,12 @@ import { createRequire as __banner_createRequire } from 'module'; const require
 import {
   generateStaticViewer,
   generateViewerFromJson
-} from "./chunk-UV5JQV3R.js";
+} from "./chunk-TXFCEDOC.js";
 import "./chunk-D2CDBRNU.js";
-import "./chunk-QM7SVOGF.js";
+import "./chunk-I34BC3CU.js";
 import "./chunk-Z7EY4VHE.js";
 export {
   generateStaticViewer,
   generateViewerFromJson
 };
-//# sourceMappingURL=static-viewer-KKCR4KXR.js.map
+//# sourceMappingURL=static-viewer-DUVC4UIM.js.map

package/dist/{test-5UCKXYSC.js → test-JW7JIDFG.js}

@@ -1,11 +1,11 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
 import {
   parseFragmentFile
-} from "./chunk-3SOAPJDX.js";
+} from "./chunk-55KERLWL.js";
 import {
   discoverFragmentFiles
-} from "./chunk-SM674YAS.js";
-import "./chunk-QM7SVOGF.js";
+} from "./chunk-ZKTFKHWN.js";
+import "./chunk-I34BC3CU.js";
 import "./chunk-Z7EY4VHE.js";
 
 // src/test/index.ts
@@ -1071,4 +1071,4 @@ export {
   listTests,
   runTestCommand
 };
-//# sourceMappingURL=test-5UCKXYSC.js.map
+//# sourceMappingURL=test-JW7JIDFG.js.map

package/dist/{tokens-L46MK5AW.js → tokens-OPVTVITP.js}

@@ -1,15 +1,15 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
 import {
   loadConfig
-} from "./chunk-3SOAPJDX.js";
-import "./chunk-SM674YAS.js";
+} from "./chunk-55KERLWL.js";
+import "./chunk-ZKTFKHWN.js";
 import {
   parseTokenFiles
-} from "./chunk-4K7EAQ5L.js";
+} from "./chunk-7K3VROEP.js";
 import "./chunk-D2CDBRNU.js";
 import {
   BRAND
-} from "./chunk-QM7SVOGF.js";
+} from "./chunk-I34BC3CU.js";
 import "./chunk-Z7EY4VHE.js";
 
 // src/commands/tokens.ts
@@ -172,4 +172,4 @@ export {
   tokens_default as default,
   tokens
 };
-//# sourceMappingURL=tokens-L46MK5AW.js.map
+//# sourceMappingURL=tokens-OPVTVITP.js.map

package/dist/{viewer-M2EQQSGE.js → viewer-OBTEPVY7.js}

@@ -5,16 +5,16 @@ import {
   generatePreviewModule,
   loadConfig,
   parseFragmentFile
-} from "./chunk-3SOAPJDX.js";
+} from "./chunk-55KERLWL.js";
 import {
   discoverFragmentFiles,
   discoverInstalledFragments
-} from "./chunk-SM674YAS.js";
+} from "./chunk-ZKTFKHWN.js";
 import "./chunk-D2CDBRNU.js";
 import {
   BRAND,
   generateContext
-} from "./chunk-QM7SVOGF.js";
+} from "./chunk-I34BC3CU.js";
 import "./chunk-Z7EY4VHE.js";
 
 // src/viewer/server.ts
@@ -373,7 +373,7 @@ var sharedRenderPool = null;
 var browserPoolModule = null;
 async function getSharedRenderPool() {
   if (!browserPoolModule) {
-    browserPoolModule = await import("./service-MMEKG4MZ.js");
+    browserPoolModule = await import("./service-S5LXPKV4.js");
   }
   if (!sharedRenderPool) {
     sharedRenderPool = new browserPoolModule.BrowserPool({
@@ -616,7 +616,7 @@ function fragmentsPlugin(options) {
             const address = _server.httpServer?.address();
             const port = typeof address === "object" && address ? address.port : 6006;
             const renderViewport = viewport || { width: 800, height: 600 };
-            const { FigmaClient, bufferToBase64Url } = await import("./service-MMEKG4MZ.js");
+            const { FigmaClient, bufferToBase64Url } = await import("./service-S5LXPKV4.js");
             const figmaClient = new FigmaClient({
               accessToken: figmaToken
             });
@@ -707,7 +707,7 @@ function fragmentsPlugin(options) {
               );
               return;
             }
-            const { FigmaClient } = await import("./service-MMEKG4MZ.js");
+            const { FigmaClient } = await import("./service-S5LXPKV4.js");
             const figmaClient = new FigmaClient({ accessToken: figmaToken });
             const { fileKey, nodeId } = figmaClient.parseUrl(figmaUrl);
             const figmaDesignProps = await figmaClient.getNodeProperties(
@@ -748,7 +748,7 @@ function fragmentsPlugin(options) {
               }));
               return;
             }
-            const { getSharedTokenRegistry } = await import("./service-MMEKG4MZ.js");
+            const { getSharedTokenRegistry } = await import("./service-S5LXPKV4.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -808,7 +808,7 @@ function fragmentsPlugin(options) {
               }));
               return;
             }
-            const { getSharedTokenRegistry } = await import("./service-MMEKG4MZ.js");
+            const { getSharedTokenRegistry } = await import("./service-S5LXPKV4.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -870,7 +870,7 @@ function fragmentsPlugin(options) {
               res.end(JSON.stringify({ error: "Could not resolve fragment file path" }));
               return;
             }
-            const { getSharedTokenRegistry } = await import("./service-MMEKG4MZ.js");
+            const { getSharedTokenRegistry } = await import("./service-S5LXPKV4.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -1048,7 +1048,7 @@ function fragmentsPlugin(options) {
             }
             if (!config.tokens || !config.tokens.include || config.tokens.include.length === 0) {
               try {
-                const { discoverTokenFiles } = await import("./discovery-VSGC76JN.js");
+                const { discoverTokenFiles } = await import("./discovery-VDANZAJ2.js");
                 const discovered = await discoverTokenFiles(projectRoot);
                 if (discovered.length > 0) {
                   config.tokens = {
@@ -1085,7 +1085,7 @@ function fragmentsPlugin(options) {
             const {
               getSharedTokenRegistry,
               generateTokenPatches
-            } = await import("./service-MMEKG4MZ.js");
+            } = await import("./service-S5LXPKV4.js");
             const registry = getSharedTokenRegistry();
             if (!registry.isInitialized()) {
               await registry.initialize(config.tokens, projectRoot);
@@ -2194,7 +2194,7 @@ async function loadFullFragmentForCompare(_server, _fragmentFiles, componentName
   }
 }
 async function compareImages(image1Base64, image2Base64, threshold) {
-  const { DiffEngine, base64UrlToBuffer, bufferToBase64Url } = await import("./service-MMEKG4MZ.js");
+  const { DiffEngine, base64UrlToBuffer, bufferToBase64Url } = await import("./service-S5LXPKV4.js");
   const { PNG } = await import("pngjs");
   const buffer1 = base64UrlToBuffer(image1Base64);
   const buffer2 = base64UrlToBuffer(image2Base64);
@@ -2727,4 +2727,4 @@ export {
   createDevServer,
   fragmentsPlugin
 };
-//# sourceMappingURL=viewer-M2EQQSGE.js.map
+//# sourceMappingURL=viewer-OBTEPVY7.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragments-sdk/cli",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "license": "FSL-1.1-MIT",
   "description": "CLI, MCP server, and dev tools for Fragments design system",
   "author": "Conan McNicholl",
@@ -80,11 +80,11 @@
     "vite": "^6.0.0",
     "vite-plugin-svgr": "^4.5.0",
     "zod": "^3.24.1",
-    "@fragments-sdk/context": "0.5.0",
-    "@fragments-sdk/core": "1.0.0",
-    "@fragments-sdk/viewer": "0.2.4",
-    "@fragments-sdk/webmcp": "2.0.0",
-    "@fragments-sdk/govern": "^0.2.0"
+    "@fragments-sdk/context": "0.5.1",
+    "@fragments-sdk/core": "1.0.1",
+    "@fragments-sdk/govern": "^0.2.1",
+    "@fragments-sdk/viewer": "0.2.5",
+    "@fragments-sdk/webmcp": "2.0.1"
   },
   "devDependencies": {
     "@types/babel__generator": "^7.6.8",

package/src/bin.ts

@@ -40,7 +40,7 @@ import { perf } from './commands/perf.js';
 import { doctor } from './commands/doctor.js';
 import { setup } from './commands/setup.js';
 import { sync } from './commands/sync.js';
-import { governCheck, governInit, governReport } from './commands/govern.js';
+import { governCheck, governInit, governReport, governConnect } from './commands/govern.js';
 
 // Import existing commands that were already extracted
 import { runScreenshotCommand } from './screenshot.js';
@@ -1147,8 +1147,8 @@ governCmd
 
 governCmd
   .command('init')
-  .description('Generate a govern.config.ts template')
-  .option('-o, --output <path>', 'Output path', 'govern.config.ts')
+  .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 });
@@ -1170,5 +1170,17 @@ governCmd
     }
   });
 
+governCmd
+  .command('connect')
+  .description('Connect your project to the Fragments Govern cloud dashboard')
+  .action(async () => {
+    try {
+      await governConnect();
+    } catch (error) {
+      console.error(pc.red('Error:'), error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
 // Parse command line arguments
 program.parse();

package/src/commands/govern.ts

@@ -65,13 +65,170 @@ export async function governInit(options: GovernInitOptions = {}): Promise<void>
   const { resolve } = await import('node:path');
   const { generateConfigTemplate } = await import('@fragments-sdk/govern');
 
-  const outputPath = resolve(options.output ?? 'govern.config.ts');
+  const outputPath = resolve(options.output ?? 'fragments.config.ts');
   const template = generateConfigTemplate();
 
   await writeFile(outputPath, template, 'utf-8');
   console.log(pc.green(`✓ Created ${outputPath}\n`));
 }
 
+// ---------------------------------------------------------------------------
+// connect
+// ---------------------------------------------------------------------------
+
+export async function governConnect(): Promise<void> {
+  const { readFile, writeFile, appendFile } = await import('node:fs/promises');
+  const { existsSync } = await import('node:fs');
+  const { resolve } = await import('node:path');
+  const { platform } = await import('node:os');
+  const { exec } = await import('node:child_process');
+  const { password, confirm } = await import('@inquirer/prompts');
+
+  const cloudUrl = process.env.FRAGMENTS_URL ?? 'https://app.usefragments.com';
+
+  console.log(pc.cyan(`\n  ${BRAND.name} — Connect to Cloud\n`));
+  console.log(
+    pc.dim('  This will connect your project to the Fragments dashboard\n') +
+    pc.dim('  for centralized audit tracking and team visibility.\n'),
+  );
+
+  // ── Step 1: Get API key ──────────────────────────────────────────────────
+  console.log(pc.bold('  Step 1 of 3: Get your API key\n'));
+
+  const dashboardUrl = `${cloudUrl}/dashboard/settings`;
+  console.log(pc.dim(`  → Opening the dashboard in your browser...`));
+  console.log(pc.dim(`    Copy your API key from Settings → API Keys\n`));
+
+  // Open browser (best-effort)
+  const os = platform();
+  const openCmd = os === 'darwin'
+    ? `open "${dashboardUrl}"`
+    : os === 'win32'
+      ? `start "" "${dashboardUrl}"`
+      : `xdg-open "${dashboardUrl}"`;
+  exec(openCmd);
+
+  let apiKey: string;
+  let orgName: string;
+
+  // eslint-disable-next-line no-constant-condition
+  while (true) {
+    apiKey = await password({
+      message: 'Paste your API key:',
+      mask: '*',
+    });
+
+    if (!apiKey.trim()) {
+      console.log(pc.yellow('\n  API key cannot be empty. Please try again.\n'));
+      continue;
+    }
+
+    // Verify key against cloud
+    console.log(pc.dim('\n  Verifying...'));
+    try {
+      const response = await fetch(`${cloudUrl}/api/verify`, {
+        headers: { Authorization: `Bearer ${apiKey.trim()}` },
+      });
+
+      if (!response.ok) {
+        console.log(pc.red(`\n  ✗ Invalid API key (HTTP ${response.status}). Please try again.\n`));
+        continue;
+      }
+
+      const data = (await response.json()) as { valid: boolean; orgName?: string };
+      if (!data.valid) {
+        console.log(pc.red('\n  ✗ API key not recognized. Please try again.\n'));
+        continue;
+      }
+
+      orgName = data.orgName ?? 'your organization';
+      console.log(pc.green(`\n  ✓ Connected to "${orgName}" (verified)\n`));
+      break;
+    } catch (error) {
+      console.log(
+        pc.red('\n  ✗ Could not reach the dashboard.'),
+      );
+      console.log(
+        pc.dim(`    ${error instanceof Error ? error.message : 'Network error'}\n`),
+      );
+      continue;
+    }
+  }
+
+  // ── Step 2: Save configuration ──────────────────────────────────────────
+  console.log(pc.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 = resolve('.env');
+    const envEntry = `FRAGMENTS_API_KEY=${apiKey.trim()}`;
+
+    if (existsSync(envPath)) {
+      const envContent = await readFile(envPath, 'utf-8');
+      if (envContent.includes('FRAGMENTS_API_KEY=')) {
+        // Replace existing entry
+        const updated = envContent.replace(
+          /^FRAGMENTS_API_KEY=.*$/m,
+          envEntry,
+        );
+        await writeFile(envPath, updated, 'utf-8');
+        console.log(pc.green('  ✓ Updated FRAGMENTS_API_KEY in .env'));
+      } else {
+        await appendFile(envPath, `\n${envEntry}\n`, 'utf-8');
+        console.log(pc.green('  ✓ Added FRAGMENTS_API_KEY to .env'));
+      }
+    } else {
+      await writeFile(envPath, `${envEntry}\n`, 'utf-8');
+      console.log(pc.green('  ✓ Created .env with FRAGMENTS_API_KEY'));
+    }
+
+    // Write FRAGMENTS_URL only if non-default
+    if (cloudUrl !== 'https://app.usefragments.com') {
+      const envContent = await readFile(envPath, 'utf-8');
+      if (!envContent.includes('FRAGMENTS_URL=')) {
+        await appendFile(envPath, `FRAGMENTS_URL=${cloudUrl}\n`, 'utf-8');
+        console.log(pc.green(`  ✓ Added FRAGMENTS_URL to .env`));
+      }
+    }
+
+    // Ensure .env is in .gitignore
+    const gitignorePath = resolve('.gitignore');
+    if (existsSync(gitignorePath)) {
+      const gitignore = await readFile(gitignorePath, 'utf-8');
+      if (!gitignore.split('\n').some((line) => line.trim() === '.env')) {
+        await appendFile(gitignorePath, '\n.env\n', 'utf-8');
+        console.log(pc.green('  ✓ Added .env to .gitignore'));
+      }
+    } else {
+      await writeFile(gitignorePath, '.env\n', 'utf-8');
+      console.log(pc.green('  ✓ Created .gitignore with .env entry'));
+    }
+  }
+
+  // ── Step 3: Config check ────────────────────────────────────────────────
+  console.log(pc.bold('\n  Step 3 of 3: Config check\n'));
+
+  const { findGovernConfig } = await import('@fragments-sdk/govern');
+  const configPath = findGovernConfig();
+
+  if (configPath) {
+    console.log(pc.green(`  ✓ Found govern config: ${configPath}`));
+  } else {
+    console.log(
+      pc.yellow('  No govern config found — run `fragments govern init` to create one'),
+    );
+  }
+
+  // ── Done ────────────────────────────────────────────────────────────────
+  console.log(pc.dim('\n  ─────────────────────────────────────\n'));
+  console.log(pc.green('  ✓ All set!') + ' Run `fragments govern check` to send your first audit.\n');
+  console.log(pc.dim(`  Dashboard: ${cloudUrl}/dashboard\n`));
+}
+
 // ---------------------------------------------------------------------------
 // report
 // ---------------------------------------------------------------------------