@fragments-sdk/cli 0.15.10 → 0.16.0

package/dist/{service-QJGWUIVL.js → service-VELQHEWV.js}

@@ -23,6 +23,7 @@ import {
   checkStorybookRunning,
   clearSharedRegistry,
   computeHash,
+  containsTailwindV4Theme,
   convertToFragmentProps,
   createCaptureEngine,
   createDeferred,
@@ -60,35 +61,32 @@ import {
   getSharedPool,
   getSharedTokenRegistry,
   getStorybookStoryIds,
+  hexToRgb,
   initializeSharedRegistry,
   isBoilerplate,
   mergeStorybookIntoDoc,
+  normalizeColor,
   parseAllStories,
+  parseRgb,
   parseStoryFile,
   parseStorySource,
+  parseTailwindV4File,
+  parseTailwindV4Theme,
+  parseTokenFile,
+  parseTokenFiles,
   renderAllComponentVariants,
   renderVariants,
   retry,
+  rgbToHex,
   sanitizeFilename,
   shutdownSharedPool,
   sleep
-} from "./chunk-6SQPP47U.js";
+} from "./chunk-77AAP6R6.js";
 import "./chunk-D2CDBRNU.js";
 import {
   BRAND,
   DEFAULTS
-} from "./chunk-32LIWN2P.js";
-import {
-  containsTailwindV4Theme,
-  hexToRgb,
-  normalizeColor,
-  parseRgb,
-  parseTailwindV4File,
-  parseTailwindV4Theme,
-  parseTokenFile,
-  parseTokenFiles,
-  rgbToHex
-} from "./chunk-MHIBEEW4.js";
+} from "./chunk-SJFSG7QF.js";
 import {
   aggregateAllUsages,
   aggregateComponentUsages,
@@ -217,4 +215,4 @@ export {
   sleep,
   summarizePatternsForPrompt
 };
-//# sourceMappingURL=service-QJGWUIVL.js.map
+//# sourceMappingURL=service-VELQHEWV.js.map

package/dist/{snapshot-WIJMEIFT.js → snapshot-DT4B6DPR.js}

@@ -2,7 +2,7 @@ import { createRequire as __banner_createRequire } from 'module'; const require
 import "./chunk-D2CDBRNU.js";
 import {
   BRAND
-} from "./chunk-32LIWN2P.js";
+} from "./chunk-SJFSG7QF.js";
 
 // src/commands/snapshot.ts
 import { resolve } from "path";
@@ -135,4 +135,4 @@ ${BRAND.name} Visual Snapshots
 export {
   snapshot
 };
-//# sourceMappingURL=snapshot-WIJMEIFT.js.map
+//# sourceMappingURL=snapshot-DT4B6DPR.js.map

package/dist/{static-viewer-7QIBQZRC.js → static-viewer-E4OJWFDJ.js}

@@ -2,11 +2,11 @@ import { createRequire as __banner_createRequire } from 'module'; const require
 import {
   generateStaticViewer,
   generateViewerFromJson
-} from "./chunk-2WXKALIG.js";
+} from "./chunk-OZZ4SVZX.js";
 import "./chunk-D2CDBRNU.js";
-import "./chunk-32LIWN2P.js";
+import "./chunk-SJFSG7QF.js";
 export {
   generateStaticViewer,
   generateViewerFromJson
 };
-//# sourceMappingURL=static-viewer-7QIBQZRC.js.map
+//# sourceMappingURL=static-viewer-E4OJWFDJ.js.map

package/dist/{test-64Z5BKBA.js → test-QJY2QO4X.js}

@@ -2,8 +2,8 @@ import { createRequire as __banner_createRequire } from 'module'; const require
 import {
   discoverFragmentFiles,
   parseFragmentFile
-} from "./chunk-HQ6A6DTV.js";
-import "./chunk-32LIWN2P.js";
+} from "./chunk-XRADMHMV.js";
+import "./chunk-SJFSG7QF.js";
 
 // src/test/index.ts
 import { resolve as resolve2, join as join2 } from "path";
@@ -1068,4 +1068,4 @@ export {
   listTests,
   runTestCommand
 };
-//# sourceMappingURL=test-64Z5BKBA.js.map
+//# sourceMappingURL=test-QJY2QO4X.js.map

package/dist/{token-normalizer-TEPOVBPV.js → token-normalizer-56H4242J.js}

@@ -1,7 +1,7 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
 import {
   parseColor
-} from "./chunk-32LIWN2P.js";
+} from "./chunk-SJFSG7QF.js";
 
 // src/service/token-normalizer.ts
 import { existsSync } from "fs";
@@ -309,4 +309,4 @@ export {
   normalizeCSSVarTokens,
   normalizeTailwindTheme
 };
-//# sourceMappingURL=token-normalizer-TEPOVBPV.js.map
+//# sourceMappingURL=token-normalizer-56H4242J.js.map

package/dist/{tokens-NZWFQIAB.js → tokens-K6URXFPK.js}

@@ -1,15 +1,14 @@
 import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
-import "./chunk-6SQPP47U.js";
-import "./chunk-D2CDBRNU.js";
 import {
   loadConfig
-} from "./chunk-HQ6A6DTV.js";
-import {
-  BRAND
-} from "./chunk-32LIWN2P.js";
+} from "./chunk-XRADMHMV.js";
 import {
   parseTokenFiles
-} from "./chunk-MHIBEEW4.js";
+} from "./chunk-77AAP6R6.js";
+import "./chunk-D2CDBRNU.js";
+import {
+  BRAND
+} from "./chunk-SJFSG7QF.js";
 import "./chunk-QCN35LJU.js";
 import "./chunk-7DZC4YEV.js";
 
@@ -173,4 +172,4 @@ export {
   tokens_default as default,
   tokens
 };
-//# sourceMappingURL=tokens-NZWFQIAB.js.map
+//# sourceMappingURL=tokens-K6URXFPK.js.map

package/dist/{tokens-NZWFQIAB.js.map → tokens-K6URXFPK.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/commands/tokens.ts"],"sourcesContent":["/**\n * CLI Tokens Command\n *\n * Discover and list design tokens from CSS/SCSS files.\n *\n * Usage:\n *   fragments tokens              # List all tokens\n *   fragments tokens --json       # Output as JSON\n *   fragments tokens --categories # Group by category\n *   fragments tokens --theme dark # Filter by theme\n */\n\nimport pc from \"picocolors\";\nimport { BRAND } from \"../core/index.js\";\nimport type { DesignToken, TokenCategory, TokenConfig } from \"../core/index.js\";\nimport { loadConfig } from \"../core/node.js\";\nimport { parseTokenFiles, createTokenRegistry } from \"../service/index.js\";\n\nexport interface TokensCommandOptions {\n  config?: string;\n  json?: boolean;\n  categories?: boolean;\n  theme?: string;\n  category?: string;\n  verbose?: boolean;\n}\n\nexport interface TokensCommandResult {\n  success: boolean;\n  tokenCount: number;\n  errors: string[];\n}\n\n/**\n * Run the tokens command\n */\nexport async function tokens(\n  options: TokensCommandOptions\n): Promise<TokensCommandResult> {\n  const errors: string[] = [];\n\n  try {\n    console.log(pc.cyan(`\\n${BRAND.name} Token Discovery\\n`));\n\n    // Load config\n    const { config, configDir } = await loadConfig(options.config);\n\n    // Check for token configuration\n    if (!config.tokens || !config.tokens.include || config.tokens.include.length === 0) {\n      console.log(pc.yellow(\"No token configuration found.\\n\"));\n      console.log(pc.dim(\"Add 'tokens' config to fragments.config.ts:\"));\n      console.log(pc.dim(`\n  tokens: {\n    include: ['src/styles/theme.scss', 'src/styles/variables.css'],\n    themeSelectors: {\n      ':root': 'default',\n      '[data-theme=\"dark\"]': 'dark',\n    },\n  },\n`));\n      return { success: false, tokenCount: 0, errors: [\"No token configuration\"] };\n    }\n\n    console.log(pc.dim(`Scanning files: ${config.tokens.include.join(\", \")}\\n`));\n\n    // Parse token files\n    const parseResult = await parseTokenFiles(config.tokens, configDir);\n\n    if (parseResult.errors.length > 0) {\n      console.log(pc.yellow(\"Parse errors:\"));\n      for (const err of parseResult.errors) {\n        console.log(pc.red(`  ${err.file}: ${err.message}`));\n        errors.push(`${err.file}: ${err.message}`);\n      }\n      console.log();\n    }\n\n    if (parseResult.warnings.length > 0 && options.verbose) {\n      console.log(pc.yellow(\"Warnings:\"));\n      for (const warning of parseResult.warnings) {\n        console.log(pc.dim(`  ${warning}`));\n      }\n      console.log();\n    }\n\n    let tokens = parseResult.tokens;\n\n    // Filter by theme if specified\n    if (options.theme) {\n      tokens = tokens.filter(\n        (t) => t.theme === options.theme || t.theme === \"default\"\n      );\n    }\n\n    // Filter by category if specified\n    if (options.category) {\n      tokens = tokens.filter((t) => t.category === options.category);\n    }\n\n    if (tokens.length === 0) {\n      console.log(pc.yellow(\"No tokens found.\\n\"));\n      console.log(pc.dim(\"Make sure your CSS files contain CSS custom properties (--token-name: value;)\"));\n      return { success: true, tokenCount: 0, errors };\n    }\n\n    // Output based on format\n    if (options.json) {\n      outputJson(tokens, parseResult.parseTimeMs);\n    } else if (options.categories) {\n      outputByCategory(tokens, parseResult.parseTimeMs);\n    } else {\n      outputList(tokens, parseResult.parseTimeMs, options.verbose);\n    }\n\n    return { success: true, tokenCount: tokens.length, errors };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : \"Unknown error\";\n    console.error(pc.red(\"Error:\"), message);\n    errors.push(message);\n    return { success: false, tokenCount: 0, errors };\n  }\n}\n\n/**\n * Output tokens as JSON\n */\nfunction outputJson(tokens: DesignToken[], parseTimeMs: number): void {\n  const output = {\n    tokens,\n    meta: {\n      totalTokens: tokens.length,\n      parseTimeMs,\n      discoveredAt: new Date().toISOString(),\n    },\n  };\n\n  console.log(JSON.stringify(output, null, 2));\n}\n\n/**\n * Output tokens grouped by category\n */\nfunction outputByCategory(tokens: DesignToken[], parseTimeMs: number): void {\n  // Group by category\n  const byCategory = new Map<TokenCategory, DesignToken[]>();\n\n  for (const token of tokens) {\n    const list = byCategory.get(token.category) || [];\n    list.push(token);\n    byCategory.set(token.category, list);\n  }\n\n  // Sort categories alphabetically\n  const categories = Array.from(byCategory.keys()).sort();\n\n  for (const category of categories) {\n    const categoryTokens = byCategory.get(category) || [];\n    console.log(pc.bold(`${category} (${categoryTokens.length})`));\n    console.log(pc.dim(\"─\".repeat(40)));\n\n    for (const token of categoryTokens.slice(0, 10)) {\n      const levelLabel = token.level === 1 ? \"base\" : token.level === 2 ? \"semantic\" : \"component\";\n      console.log(`  ${pc.cyan(token.name)}`);\n      console.log(`    ${pc.dim(\"Value:\")} ${token.resolvedValue}`);\n      console.log(`    ${pc.dim(\"Level:\")} ${levelLabel} ${pc.dim(`(${token.theme})`)}`);\n    }\n\n    if (categoryTokens.length > 10) {\n      console.log(pc.dim(`  ... and ${categoryTokens.length - 10} more`));\n    }\n    console.log();\n  }\n\n  // Summary\n  console.log(pc.dim(\"─\".repeat(40)));\n  console.log(pc.green(`✓ Found ${tokens.length} token(s) in ${categories.length} categories`));\n  console.log(pc.dim(`  Parsed in ${parseTimeMs.toFixed(1)}ms\\n`));\n}\n\n/**\n * Output tokens as a simple list\n */\nfunction outputList(tokens: DesignToken[], parseTimeMs: number, verbose?: boolean): void {\n  // Group by theme first\n  const byTheme = new Map<string, DesignToken[]>();\n\n  for (const token of tokens) {\n    const list = byTheme.get(token.theme) || [];\n    list.push(token);\n    byTheme.set(token.theme, list);\n  }\n\n  const themes = Array.from(byTheme.keys()).sort();\n\n  for (const theme of themes) {\n    const themeTokens = byTheme.get(theme) || [];\n\n    if (themes.length > 1) {\n      console.log(pc.bold(`Theme: ${theme} (${themeTokens.length} tokens)`));\n      console.log(pc.dim(\"─\".repeat(50)));\n    }\n\n    // Sort tokens by name\n    themeTokens.sort((a, b) => a.name.localeCompare(b.name));\n\n    // Table header\n    console.log(\n      pc.dim(\n        `${\"Token Name\".padEnd(32)} ${\"Value\".padEnd(20)} ${\"Category\".padEnd(12)}`\n      )\n    );\n    console.log(pc.dim(\"─\".repeat(70)));\n\n    const displayTokens = verbose ? themeTokens : themeTokens.slice(0, 30);\n\n    for (const token of displayTokens) {\n      const name = token.name.length > 30 ? token.name.slice(0, 27) + \"...\" : token.name;\n      const value = token.resolvedValue.length > 18 ? token.resolvedValue.slice(0, 15) + \"...\" : token.resolvedValue;\n\n      console.log(\n        `${pc.cyan(name.padEnd(32))} ${value.padEnd(20)} ${pc.dim(token.category.padEnd(12))}`\n      );\n    }\n\n    if (!verbose && themeTokens.length > 30) {\n      console.log(pc.dim(`\\n  ... and ${themeTokens.length - 30} more (use --verbose to show all)`));\n    }\n\n    console.log();\n  }\n\n  // Summary\n  console.log(pc.dim(\"─\".repeat(50)));\n  console.log(pc.green(`✓ Found ${tokens.length} token(s)`));\n\n  // Category breakdown\n  const categoryCounts: Record<string, number> = {};\n  for (const token of tokens) {\n    categoryCounts[token.category] = (categoryCounts[token.category] || 0) + 1;\n  }\n\n  const breakdown = Object.entries(categoryCounts)\n    .sort((a, b) => b[1] - a[1])\n    .map(([cat, count]) => `${cat}: ${count}`)\n    .join(\", \");\n\n  console.log(pc.dim(`  ${breakdown}`));\n  console.log(pc.dim(`  Parsed in ${parseTimeMs.toFixed(1)}ms\\n`));\n}\n\nexport default tokens;\n"],"mappings":"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","names":["tokens"]}
+{"version":3,"sources":["../src/commands/tokens.ts"],"sourcesContent":["/**\n * CLI Tokens Command\n *\n * Discover and list design tokens from CSS/SCSS files.\n *\n * Usage:\n *   fragments tokens              # List all tokens\n *   fragments tokens --json       # Output as JSON\n *   fragments tokens --categories # Group by category\n *   fragments tokens --theme dark # Filter by theme\n */\n\nimport pc from \"picocolors\";\nimport { BRAND } from \"../core/index.js\";\nimport type { DesignToken, TokenCategory, TokenConfig } from \"../core/index.js\";\nimport { loadConfig } from \"../core/node.js\";\nimport { parseTokenFiles, createTokenRegistry } from \"../service/index.js\";\n\nexport interface TokensCommandOptions {\n  config?: string;\n  json?: boolean;\n  categories?: boolean;\n  theme?: string;\n  category?: string;\n  verbose?: boolean;\n}\n\nexport interface TokensCommandResult {\n  success: boolean;\n  tokenCount: number;\n  errors: string[];\n}\n\n/**\n * Run the tokens command\n */\nexport async function tokens(\n  options: TokensCommandOptions\n): Promise<TokensCommandResult> {\n  const errors: string[] = [];\n\n  try {\n    console.log(pc.cyan(`\\n${BRAND.name} Token Discovery\\n`));\n\n    // Load config\n    const { config, configDir } = await loadConfig(options.config);\n\n    // Check for token configuration\n    if (!config.tokens || !config.tokens.include || config.tokens.include.length === 0) {\n      console.log(pc.yellow(\"No token configuration found.\\n\"));\n      console.log(pc.dim(\"Add 'tokens' config to fragments.config.ts:\"));\n      console.log(pc.dim(`\n  tokens: {\n    include: ['src/styles/theme.scss', 'src/styles/variables.css'],\n    themeSelectors: {\n      ':root': 'default',\n      '[data-theme=\"dark\"]': 'dark',\n    },\n  },\n`));\n      return { success: false, tokenCount: 0, errors: [\"No token configuration\"] };\n    }\n\n    console.log(pc.dim(`Scanning files: ${config.tokens.include.join(\", \")}\\n`));\n\n    // Parse token files\n    const parseResult = await parseTokenFiles(config.tokens, configDir);\n\n    if (parseResult.errors.length > 0) {\n      console.log(pc.yellow(\"Parse errors:\"));\n      for (const err of parseResult.errors) {\n        console.log(pc.red(`  ${err.file}: ${err.message}`));\n        errors.push(`${err.file}: ${err.message}`);\n      }\n      console.log();\n    }\n\n    if (parseResult.warnings.length > 0 && options.verbose) {\n      console.log(pc.yellow(\"Warnings:\"));\n      for (const warning of parseResult.warnings) {\n        console.log(pc.dim(`  ${warning}`));\n      }\n      console.log();\n    }\n\n    let tokens = parseResult.tokens;\n\n    // Filter by theme if specified\n    if (options.theme) {\n      tokens = tokens.filter(\n        (t) => t.theme === options.theme || t.theme === \"default\"\n      );\n    }\n\n    // Filter by category if specified\n    if (options.category) {\n      tokens = tokens.filter((t) => t.category === options.category);\n    }\n\n    if (tokens.length === 0) {\n      console.log(pc.yellow(\"No tokens found.\\n\"));\n      console.log(pc.dim(\"Make sure your CSS files contain CSS custom properties (--token-name: value;)\"));\n      return { success: true, tokenCount: 0, errors };\n    }\n\n    // Output based on format\n    if (options.json) {\n      outputJson(tokens, parseResult.parseTimeMs);\n    } else if (options.categories) {\n      outputByCategory(tokens, parseResult.parseTimeMs);\n    } else {\n      outputList(tokens, parseResult.parseTimeMs, options.verbose);\n    }\n\n    return { success: true, tokenCount: tokens.length, errors };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : \"Unknown error\";\n    console.error(pc.red(\"Error:\"), message);\n    errors.push(message);\n    return { success: false, tokenCount: 0, errors };\n  }\n}\n\n/**\n * Output tokens as JSON\n */\nfunction outputJson(tokens: DesignToken[], parseTimeMs: number): void {\n  const output = {\n    tokens,\n    meta: {\n      totalTokens: tokens.length,\n      parseTimeMs,\n      discoveredAt: new Date().toISOString(),\n    },\n  };\n\n  console.log(JSON.stringify(output, null, 2));\n}\n\n/**\n * Output tokens grouped by category\n */\nfunction outputByCategory(tokens: DesignToken[], parseTimeMs: number): void {\n  // Group by category\n  const byCategory = new Map<TokenCategory, DesignToken[]>();\n\n  for (const token of tokens) {\n    const list = byCategory.get(token.category) || [];\n    list.push(token);\n    byCategory.set(token.category, list);\n  }\n\n  // Sort categories alphabetically\n  const categories = Array.from(byCategory.keys()).sort();\n\n  for (const category of categories) {\n    const categoryTokens = byCategory.get(category) || [];\n    console.log(pc.bold(`${category} (${categoryTokens.length})`));\n    console.log(pc.dim(\"─\".repeat(40)));\n\n    for (const token of categoryTokens.slice(0, 10)) {\n      const levelLabel = token.level === 1 ? \"base\" : token.level === 2 ? \"semantic\" : \"component\";\n      console.log(`  ${pc.cyan(token.name)}`);\n      console.log(`    ${pc.dim(\"Value:\")} ${token.resolvedValue}`);\n      console.log(`    ${pc.dim(\"Level:\")} ${levelLabel} ${pc.dim(`(${token.theme})`)}`);\n    }\n\n    if (categoryTokens.length > 10) {\n      console.log(pc.dim(`  ... and ${categoryTokens.length - 10} more`));\n    }\n    console.log();\n  }\n\n  // Summary\n  console.log(pc.dim(\"─\".repeat(40)));\n  console.log(pc.green(`✓ Found ${tokens.length} token(s) in ${categories.length} categories`));\n  console.log(pc.dim(`  Parsed in ${parseTimeMs.toFixed(1)}ms\\n`));\n}\n\n/**\n * Output tokens as a simple list\n */\nfunction outputList(tokens: DesignToken[], parseTimeMs: number, verbose?: boolean): void {\n  // Group by theme first\n  const byTheme = new Map<string, DesignToken[]>();\n\n  for (const token of tokens) {\n    const list = byTheme.get(token.theme) || [];\n    list.push(token);\n    byTheme.set(token.theme, list);\n  }\n\n  const themes = Array.from(byTheme.keys()).sort();\n\n  for (const theme of themes) {\n    const themeTokens = byTheme.get(theme) || [];\n\n    if (themes.length > 1) {\n      console.log(pc.bold(`Theme: ${theme} (${themeTokens.length} tokens)`));\n      console.log(pc.dim(\"─\".repeat(50)));\n    }\n\n    // Sort tokens by name\n    themeTokens.sort((a, b) => a.name.localeCompare(b.name));\n\n    // Table header\n    console.log(\n      pc.dim(\n        `${\"Token Name\".padEnd(32)} ${\"Value\".padEnd(20)} ${\"Category\".padEnd(12)}`\n      )\n    );\n    console.log(pc.dim(\"─\".repeat(70)));\n\n    const displayTokens = verbose ? themeTokens : themeTokens.slice(0, 30);\n\n    for (const token of displayTokens) {\n      const name = token.name.length > 30 ? token.name.slice(0, 27) + \"...\" : token.name;\n      const value = token.resolvedValue.length > 18 ? token.resolvedValue.slice(0, 15) + \"...\" : token.resolvedValue;\n\n      console.log(\n        `${pc.cyan(name.padEnd(32))} ${value.padEnd(20)} ${pc.dim(token.category.padEnd(12))}`\n      );\n    }\n\n    if (!verbose && themeTokens.length > 30) {\n      console.log(pc.dim(`\\n  ... and ${themeTokens.length - 30} more (use --verbose to show all)`));\n    }\n\n    console.log();\n  }\n\n  // Summary\n  console.log(pc.dim(\"─\".repeat(50)));\n  console.log(pc.green(`✓ Found ${tokens.length} token(s)`));\n\n  // Category breakdown\n  const categoryCounts: Record<string, number> = {};\n  for (const token of tokens) {\n    categoryCounts[token.category] = (categoryCounts[token.category] || 0) + 1;\n  }\n\n  const breakdown = Object.entries(categoryCounts)\n    .sort((a, b) => b[1] - a[1])\n    .map(([cat, count]) => `${cat}: ${count}`)\n    .join(\", \");\n\n  console.log(pc.dim(`  ${breakdown}`));\n  console.log(pc.dim(`  Parsed in ${parseTimeMs.toFixed(1)}ms\\n`));\n}\n\nexport default tokens;\n"],"mappings":"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","names":["tokens"]}

package/dist/{tokens-generate-5JQSJ27E.js → tokens-generate-EL6IN536.js}

@@ -5,7 +5,7 @@ import {
   generateFigmaVariables,
   generateSCSSVariables,
   generateTailwindConfig
-} from "./chunk-32LIWN2P.js";
+} from "./chunk-SJFSG7QF.js";
 
 // src/commands/tokens-generate.ts
 import { readFile, writeFile, mkdir } from "fs/promises";
@@ -82,4 +82,4 @@ export default ${JSON.stringify(config, null, 2)};
 export {
   tokensGenerate
 };
-//# sourceMappingURL=tokens-generate-5JQSJ27E.js.map
+//# sourceMappingURL=tokens-generate-EL6IN536.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragments-sdk/cli",
-  "version": "0.15.10",
+  "version": "0.16.0",
   "license": "FSL-1.1-MIT",
   "description": "CLI, MCP server, and dev tools for Fragments design system",
   "author": "Conan McNicholl",
@@ -70,6 +70,7 @@
     "chokidar": "^4.0.3",
     "commander": "^12.1.0",
     "esbuild": "^0.24.0",
+    "fflate": "^0.8.2",
     "fast-glob": "^3.3.3",
     "jiti": "^2.6.1",
     "openai": "^6.16.0",
@@ -81,12 +82,12 @@
     "vite": "^6.0.0",
     "vite-plugin-svgr": "^4.5.0",
     "zod": "^3.24.1",
-    "@fragments-sdk/compiler": "0.2.0",
-    "@fragments-sdk/extract": "0.1.0",
-    "@fragments-sdk/context": "0.6.0",
-    "@fragments-sdk/core": "2.0.0",
+    "@fragments-sdk/compiler": "0.2.1",
+    "@fragments-sdk/extract": "0.1.1",
+    "@fragments-sdk/core": "2.1.0",
+    "@fragments-sdk/context": "0.6.1",
     "@fragments-sdk/govern": "^0.3.1",
-    "@fragments-sdk/viewer": "0.2.9",
+    "@fragments-sdk/viewer": "0.2.10",
     "@fragments-sdk/webmcp": "3.0.0"
   },
   "devDependencies": {

package/src/bin.ts

@@ -23,6 +23,10 @@ const EXPERIMENTAL = process.env.FRAGMENTS_EXPERIMENTAL === '1';
 import { validate } from './commands/validate.js';
 import { build } from './commands/build.js';
 import { context } from './commands/context.js';
+import {
+  contextInstallCloud,
+  contextStatusCloud,
+} from './commands/context-cloud.js';
 import { list } from './commands/list.js';
 import { reset } from './commands/reset.js';
 import { compare } from './commands/compare.js';
@@ -45,7 +49,7 @@ import { perf } from './commands/perf.js';
 type DoctorFn = typeof import('./commands/doctor.js')['doctor'];
 import { setup } from './commands/setup.js';
 import { sync } from './commands/sync.js';
-import { governCheck, governInit, governReport, governConnect } from './commands/govern.js';
+import { governCheck, governInit, governReport } from './commands/govern.js';
 import { migrateContract } from './commands/migrate-contract.js';
 
 // Import existing commands that were already extracted
@@ -157,8 +161,8 @@ program
 // CONTEXT COMMAND
 // ============================================================================
 program
-  .command('context')
-  .description('Generate AI-ready context for your design system')
+  .command('context [action]')
+  .description('Generate AI-ready context or install a Fragments Cloud bundle')
   .option('-c, --config <path>', 'Path to config file')
   .option('-i, --input <path>', `Path to ${BRAND.outFile} (builds if not provided)`)
   .option('-f, --format <format>', 'Output format (markdown/json)', 'markdown')
@@ -166,8 +170,47 @@ program
   .option('--code', 'Include code examples')
   .option('--relations', 'Include component relationships')
   .option('--tokens', 'Only output token estimate')
-  .action(async (options) => {
+  .option('--cloud', 'Use Fragments Cloud bundle endpoints')
+  .option('--api-key <key>', 'Fragments Cloud API key (or use FRAGMENTS_API_KEY)')
+  .option('--targets <list>', 'Comma-separated helper targets (cursor,agents,claude,copilot)')
+  .option('--cwd <path>', 'Project root for install/status')
+  .option('--dry-run', 'Preview file writes without modifying the repo')
+  .option('-y, --yes', 'Non-interactive mode')
+  .option('--root-files <mode>', 'Root instruction file mode (prompt|never|patch)')
+  .option('--gitignore-fragments', 'Add .fragments/ to .gitignore after install')
+  .action(async (action, options) => {
     try {
+      if (options.cloud && action === 'install') {
+        await contextInstallCloud({
+          apiKey: options.apiKey,
+          targets: options.targets,
+          cwd: options.cwd,
+          dryRun: options.dryRun,
+          yes: options.yes,
+          rootFiles: options.rootFiles,
+          gitignoreFragments: options.gitignoreFragments,
+        });
+        return;
+      }
+
+      if (options.cloud && action === 'status') {
+        await contextStatusCloud({
+          apiKey: options.apiKey,
+          cwd: options.cwd,
+        });
+        return;
+      }
+
+      if (action === 'install' || action === 'status') {
+        throw new Error(
+          `context ${action} requires --cloud`,
+        );
+      }
+
+      if (action && action !== 'install' && action !== 'status') {
+        throw new Error(`Unknown context action: ${action}`);
+      }
+
       const result = await context({
         config: options.config,
         input: options.input,
@@ -885,35 +928,8 @@ const initCmd = program
   .option('--api-key <key>', 'API key for AI enrichment')
   .option('--model <model>', 'Override AI model for enrichment');
 
-// Cloud governance flags — only visible with FRAGMENTS_EXPERIMENTAL=1
-if (EXPERIMENTAL) {
-  initCmd
-    .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');
-}
-
 initCmd.action(async (options) => {
     try {
-      // Cloud init — experimental, requires FRAGMENTS_EXPERIMENTAL=1
-      if (options.cloud) {
-        if (!EXPERIMENTAL) {
-          console.log(pc.yellow(`\n  Fragments Cloud is not yet publicly available.`));
-          console.log(pc.dim(`  Set FRAGMENTS_EXPERIMENTAL=1 to enable preview features.\n`));
-          process.exit(1);
-        }
-        const { initCloud } = await import('./commands/init-cloud.js');
-        await initCloud({
-          url: options.cloudUrl,
-          port: options.port ? Number(options.port) : undefined,
-          authOnly: options.authOnly,
-          skipCheck: options.skipCheck,
-        });
-        return;
-      }
-
       const { init } = await import('./commands/init.js');
       const result = await init({
         projectRoot: process.cwd(),
@@ -1036,28 +1052,6 @@ tokensCmd
     }
   });
 
-tokensCmd
-  .command('push')
-  .description('Push code tokens to Fragments Cloud for drift comparison')
-  .option('-c, --config <path>', 'Path to fragments config file')
-  .option('--tailwind-v4 <path>', 'Path to Tailwind v4 CSS file with @theme block')
-  .option('--dry-run', 'Parse and display tokens without pushing')
-  .option('--verbose', 'Show detailed output')
-  .action(async (options) => {
-    try {
-      const { tokensPush } = await import('./commands/tokens-push.js');
-      await tokensPush({
-        config: options.config,
-        tailwindV4: options.tailwindV4,
-        dryRun: options.dryRun,
-        verbose: options.verbose,
-      });
-    } catch (error) {
-      console.error(pc.red('Error:'), error instanceof Error ? error.message : error);
-      process.exit(1);
-    }
-  });
-
 // ============================================================================
 // GENERATE COMMAND
 // ============================================================================
@@ -1374,24 +1368,13 @@ 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);
-    }
-  });
-
 governCmd
   .command('scan')
   .description('Scan JSX/TSX codebase for governance violations')
   .option('-d, --dir <path>', 'Root directory (default: auto-detect)')
   .option('-c, --config <path>', 'Path to govern.config.ts')
   .option('-f, --format <format>', 'Output format: summary, json, sarif', 'summary')
+  .option('-r, --report <path>', 'Write an aggregated machine-readable JSON report')
   .option('-q, --quiet', 'Suppress non-error output')
   .action(async (options) => {
     try {
@@ -1400,6 +1383,7 @@ governCmd
         dir: options.dir,
         config: options.config,
         format: options.format,
+        report: options.report,
         quiet: options.quiet,
       });
       process.exit(exitCode);
@@ -1431,28 +1415,5 @@ governCmd
     }
   });
 
-governCmd
-  .command('push-contracts')
-  .description('Push component contracts to Fragments Cloud')
-  .option('-i, --input <path>', 'Path to fragments.json (default: ./fragments.json)')
-  .option('--url <url>', 'Fragments Cloud URL')
-  .option('--api-key <key>', 'API key (default: FRAGMENTS_API_KEY env var)')
-  .option('-q, --quiet', 'Suppress non-error output')
-  .action(async (options) => {
-    try {
-      const { pushContracts } = await import('./commands/push-contracts.js');
-      const { exitCode } = await pushContracts({
-        input: options.input,
-        url: options.url,
-        apiKey: options.apiKey,
-        quiet: options.quiet,
-      });
-      process.exit(exitCode);
-    } 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/__fixtures__/shadcn-label-wrapper/src/components/ui/label.contract.json

@@ -37,6 +37,6 @@
     "source": "extracted",
     "verified": false,
     "frameworkSupport": "native",
-    "extractedAt": "2026-03-26T14:38:30.456Z"
+    "extractedAt": "2026-04-01T21:45:25.486Z"
   }
 }

package/src/commands/__fixtures__/shadcn-label-wrapper/src/components/ui/primitive.contract.json

@@ -15,6 +15,6 @@
     "source": "extracted",
     "verified": false,
     "frameworkSupport": "native",
-    "extractedAt": "2026-03-26T14:38:30.457Z"
+    "extractedAt": "2026-04-01T21:45:25.487Z"
   }
 }