@fragments-sdk/cli 0.15.10 → 0.16.0

package/dist/tokens-push-HY3KO36V.js

@@ -1,148 +0,0 @@
-import { createRequire as __banner_createRequire } from 'module'; const require = __banner_createRequire(import.meta.url);
-
-// src/commands/tokens-push.ts
-import { resolve } from "path";
-import pc from "picocolors";
-async function tokensPush(options) {
-  const startTime = Date.now();
-  const apiKey = process.env.FRAGMENTS_API_KEY;
-  const baseUrl = process.env.FRAGMENTS_URL || "https://app.usefragments.com";
-  if (!apiKey && !options.dryRun) {
-    console.error(pc.red("Error: FRAGMENTS_API_KEY environment variable is required"));
-    console.error(pc.dim("Get your API key from https://app.usefragments.com/api-keys"));
-    process.exit(1);
-  }
-  const flatMap = {};
-  if (options.tailwindV4) {
-    const { parseTailwindV4File } = await import("./token-parser-32KOIOFN.js");
-    const filePath = resolve(process.cwd(), options.tailwindV4);
-    const result = parseTailwindV4File(filePath);
-    if (result.errors.length > 0) {
-      for (const err of result.errors) {
-        console.error(pc.red(`  Error: ${err.message}`));
-      }
-    }
-    if (options.verbose && result.warnings.length > 0) {
-      for (const warn of result.warnings) {
-        console.warn(pc.yellow(`  Warning: ${warn}`));
-      }
-    }
-    for (const token of result.tokens) {
-      flatMap[token.name] = token.resolvedValue;
-    }
-    if (options.verbose) {
-      console.log(
-        pc.dim(`  Parsed ${result.tokens.length} tokens from ${options.tailwindV4} (${result.parseTimeMs.toFixed(1)}ms)`)
-      );
-    }
-  } else if (options.config) {
-    try {
-      const { loadConfig } = await import("./node-37AUE74M.js");
-      const { parseTokenFiles } = await import("./service-QJGWUIVL.js");
-      const { config, configDir } = await loadConfig(options.config);
-      if (config.tokens?.include?.length) {
-        const result = await parseTokenFiles(config.tokens, configDir);
-        for (const token of result.tokens) {
-          flatMap[token.name] = token.resolvedValue;
-        }
-        if (options.verbose) {
-          console.log(
-            pc.dim(`  Parsed ${result.tokens.length} tokens from config (${result.parseTimeMs.toFixed(1)}ms)`)
-          );
-        }
-      } else {
-        console.error(pc.red("Error: Config file has no tokens.include patterns"));
-        process.exit(1);
-      }
-    } catch (error) {
-      console.error(pc.red("Error loading config:"), error instanceof Error ? error.message : error);
-      process.exit(1);
-    }
-  } else {
-    try {
-      const { loadConfig } = await import("./node-37AUE74M.js");
-      const { parseTokenFiles } = await import("./service-QJGWUIVL.js");
-      const { config, configDir } = await loadConfig();
-      if (config.tokens?.include?.length) {
-        const result = await parseTokenFiles(config.tokens, configDir);
-        for (const token of result.tokens) {
-          flatMap[token.name] = token.resolvedValue;
-        }
-        if (options.verbose) {
-          console.log(
-            pc.dim(`  Parsed ${result.tokens.length} tokens from auto-detected config (${result.parseTimeMs.toFixed(1)}ms)`)
-          );
-        }
-      }
-    } catch {
-    }
-    if (Object.keys(flatMap).length === 0) {
-      console.error(pc.red("Error: No token source specified"));
-      console.error(pc.dim("Provide one of:"));
-      console.error(pc.dim("  --tailwind-v4 <path>  Path to Tailwind v4 CSS file with @theme block"));
-      console.error(pc.dim("  --config <path>       Path to fragments config with tokens.include"));
-      console.error(pc.dim("\nExample: fragments tokens push --tailwind-v4 ./app.css"));
-      process.exit(1);
-    }
-  }
-  const tokenCount = Object.keys(flatMap).length;
-  if (tokenCount === 0) {
-    console.log(pc.yellow("No tokens found."));
-    return;
-  }
-  console.log(pc.cyan(`Found ${tokenCount} tokens`));
-  if (options.dryRun) {
-    console.log(pc.dim("\nDry run \u2014 tokens that would be pushed:\n"));
-    const entries = Object.entries(flatMap);
-    for (const [name, value] of entries.slice(0, 20)) {
-      console.log(`  ${pc.bold(name)}: ${value}`);
-    }
-    if (entries.length > 20) {
-      console.log(pc.dim(`  ... and ${entries.length - 20} more`));
-    }
-    return;
-  }
-  try {
-    const response = await fetch(`${baseUrl}/api/ingest`, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "Authorization": `Bearer ${apiKey}`
-      },
-      body: JSON.stringify({
-        codeTokens: JSON.stringify(flatMap)
-      })
-    });
-    if (!response.ok) {
-      const errorText = await response.text();
-      console.error(pc.red(`Error: API returned ${response.status}`));
-      console.error(pc.dim(errorText));
-      process.exit(1);
-    }
-    const result = await response.json();
-    console.log(pc.green(`
-Pushed ${tokenCount} tokens to Fragments Cloud`));
-    if (result.tokenDrift) {
-      const drift = result.tokenDrift;
-      const summary = drift.summary;
-      if (summary) {
-        console.log(pc.cyan("\nDrift Summary:"));
-        if (summary.total !== void 0) console.log(pc.dim(`  Total issues: ${summary.total}`));
-        if (summary.missingInCode > 0) console.log(pc.yellow(`  Missing in code: ${summary.missingInCode}`));
-        if (summary.missingInFigma > 0) console.log(pc.yellow(`  Missing in Figma: ${summary.missingInFigma}`));
-        if (summary.valueMismatch > 0) console.log(pc.yellow(`  Value mismatches: ${summary.valueMismatch}`));
-        if (summary.score !== void 0) console.log(`  Health score: ${summary.score}%`);
-      }
-    }
-    console.log(pc.dim(`
-View dashboard: ${baseUrl}/tokens`));
-    console.log(pc.dim(`Completed in ${Date.now() - startTime}ms`));
-  } catch (error) {
-    console.error(pc.red("Error pushing tokens:"), error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-}
-export {
-  tokensPush
-};
-//# sourceMappingURL=tokens-push-HY3KO36V.js.map

package/dist/tokens-push-HY3KO36V.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/commands/tokens-push.ts"],"sourcesContent":["/**\n * fragments tokens push — Push code tokens to Fragments Cloud for drift comparison.\n *\n * Extracts CSS custom properties from Tailwind v4 @theme blocks (or config-based\n * token files) and POSTs them to the Fragments Cloud /api/ingest endpoint.\n * Supports --dry-run for local inspection without pushing.\n */\n\nimport { resolve } from 'node:path';\nimport pc from 'picocolors';\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\nexport interface TokensPushOptions {\n  /** Path to fragments config file */\n  config?: string;\n  /** Path to Tailwind v4 CSS file with @theme block */\n  tailwindV4?: string;\n  /** Parse and display tokens without pushing */\n  dryRun?: boolean;\n  /** Show detailed output */\n  verbose?: boolean;\n}\n\n// ---------------------------------------------------------------------------\n// tokensPush\n// ---------------------------------------------------------------------------\n\nexport async function tokensPush(options: TokensPushOptions): Promise<void> {\n  const startTime = Date.now();\n\n  // 1. Resolve API credentials\n  const apiKey = process.env.FRAGMENTS_API_KEY;\n  const baseUrl = process.env.FRAGMENTS_URL || 'https://app.usefragments.com';\n\n  if (!apiKey && !options.dryRun) {\n    console.error(pc.red('Error: FRAGMENTS_API_KEY environment variable is required'));\n    console.error(pc.dim('Get your API key from https://app.usefragments.com/api-keys'));\n    process.exit(1);\n  }\n\n  // 2. Token extraction\n  const flatMap: Record<string, string> = {};\n\n  if (options.tailwindV4) {\n    // Use @theme parser for Tailwind v4 CSS files\n    const { parseTailwindV4File } = await import('../service/token-parser.js');\n\n    const filePath = resolve(process.cwd(), options.tailwindV4);\n    const result = parseTailwindV4File(filePath);\n\n    if (result.errors.length > 0) {\n      for (const err of result.errors) {\n        console.error(pc.red(`  Error: ${err.message}`));\n      }\n    }\n\n    if (options.verbose && result.warnings.length > 0) {\n      for (const warn of result.warnings) {\n        console.warn(pc.yellow(`  Warning: ${warn}`));\n      }\n    }\n\n    for (const token of result.tokens) {\n      flatMap[token.name] = token.resolvedValue;\n    }\n\n    if (options.verbose) {\n      console.log(\n        pc.dim(`  Parsed ${result.tokens.length} tokens from ${options.tailwindV4} (${result.parseTimeMs.toFixed(1)}ms)`),\n      );\n    }\n  } else if (options.config) {\n    // Use config-based token extraction\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(options.config);\n      if (config.tokens?.include?.length) {\n        const result = await parseTokenFiles(config.tokens, configDir);\n        for (const token of result.tokens) {\n          flatMap[token.name] = token.resolvedValue;\n        }\n\n        if (options.verbose) {\n          console.log(\n            pc.dim(`  Parsed ${result.tokens.length} tokens from config (${result.parseTimeMs.toFixed(1)}ms)`),\n          );\n        }\n      } else {\n        console.error(pc.red('Error: Config file has no tokens.include patterns'));\n        process.exit(1);\n      }\n    } catch (error) {\n      console.error(pc.red('Error loading config:'), error instanceof Error ? error.message : error);\n      process.exit(1);\n    }\n  } else {\n    // No source specified — try auto-detection\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();\n      if (config.tokens?.include?.length) {\n        const result = await parseTokenFiles(config.tokens, configDir);\n        for (const token of result.tokens) {\n          flatMap[token.name] = token.resolvedValue;\n        }\n\n        if (options.verbose) {\n          console.log(\n            pc.dim(`  Parsed ${result.tokens.length} tokens from auto-detected config (${result.parseTimeMs.toFixed(1)}ms)`),\n          );\n        }\n      }\n    } catch {\n      // No config found — fall through to error\n    }\n\n    if (Object.keys(flatMap).length === 0) {\n      console.error(pc.red('Error: No token source specified'));\n      console.error(pc.dim('Provide one of:'));\n      console.error(pc.dim('  --tailwind-v4 <path>  Path to Tailwind v4 CSS file with @theme block'));\n      console.error(pc.dim('  --config <path>       Path to fragments config with tokens.include'));\n      console.error(pc.dim('\\nExample: fragments tokens push --tailwind-v4 ./app.css'));\n      process.exit(1);\n    }\n  }\n\n  const tokenCount = Object.keys(flatMap).length;\n\n  if (tokenCount === 0) {\n    console.log(pc.yellow('No tokens found.'));\n    return;\n  }\n\n  console.log(pc.cyan(`Found ${tokenCount} tokens`));\n\n  // 3. Dry run — display tokens and exit\n  if (options.dryRun) {\n    console.log(pc.dim('\\nDry run — tokens that would be pushed:\\n'));\n    const entries = Object.entries(flatMap);\n    for (const [name, value] of entries.slice(0, 20)) {\n      console.log(`  ${pc.bold(name)}: ${value}`);\n    }\n    if (entries.length > 20) {\n      console.log(pc.dim(`  ... and ${entries.length - 20} more`));\n    }\n    return;\n  }\n\n  // 4. POST to Fragments Cloud\n  try {\n    const response = await fetch(`${baseUrl}/api/ingest`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${apiKey}`,\n      },\n      body: JSON.stringify({\n        codeTokens: JSON.stringify(flatMap),\n      }),\n    });\n\n    if (!response.ok) {\n      const errorText = await response.text();\n      console.error(pc.red(`Error: API returned ${response.status}`));\n      console.error(pc.dim(errorText));\n      process.exit(1);\n    }\n\n    const result = await response.json() as Record<string, unknown>;\n\n    console.log(pc.green(`\\nPushed ${tokenCount} tokens to Fragments Cloud`));\n\n    if (result.tokenDrift) {\n      const drift = result.tokenDrift as Record<string, unknown>;\n      const summary = drift.summary as Record<string, number> | undefined;\n      if (summary) {\n        console.log(pc.cyan('\\nDrift Summary:'));\n        if (summary.total !== undefined) console.log(pc.dim(`  Total issues: ${summary.total}`));\n        if (summary.missingInCode > 0) console.log(pc.yellow(`  Missing in code: ${summary.missingInCode}`));\n        if (summary.missingInFigma > 0) console.log(pc.yellow(`  Missing in Figma: ${summary.missingInFigma}`));\n        if (summary.valueMismatch > 0) console.log(pc.yellow(`  Value mismatches: ${summary.valueMismatch}`));\n        if (summary.score !== undefined) console.log(`  Health score: ${summary.score}%`);\n      }\n    }\n\n    console.log(pc.dim(`\\nView dashboard: ${baseUrl}/tokens`));\n    console.log(pc.dim(`Completed in ${Date.now() - startTime}ms`));\n  } catch (error) {\n    console.error(pc.red('Error pushing tokens:'), error instanceof Error ? error.message : error);\n    process.exit(1);\n  }\n}\n"],"mappings":"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","names":[]}

package/src/commands/init-cloud.ts

@@ -1,382 +0,0 @@
-/**
- * fragments init --cloud
- *
- * Zero-config cloud setup: opens browser for auth, receives API key
- * via localhost callback, detects project, installs deps, creates config,
- * runs first check.
- */
-
-import { createServer, type IncomingMessage, type ServerResponse } from 'node:http';
-import { randomBytes } from 'node:crypto';
-import { execSync, exec } from 'node:child_process';
-import { readFileSync, writeFileSync, existsSync, appendFileSync } from 'node:fs';
-import { resolve, join } from 'node:path';
-import { platform } from 'node:os';
-import pc from 'picocolors';
-import { BRAND } from '../core/index.js';
-
-// ─── Types ──────────────────────────────────────────────────────────────────
-
-interface AuthResult {
-  apiKey: string;
-  orgName: string;
-}
-
-export interface InitCloudOptions {
-  /** Cloud dashboard URL */
-  url?: string;
-  /** Port for localhost callback server */
-  port?: number;
-  /** Timeout in ms for auth */
-  timeout?: number;
-  /** Skip project detection and setup */
-  authOnly?: boolean;
-  /** Skip the first governance check */
-  skipCheck?: boolean;
-}
-
-// ─── Utilities ──────────────────────────────────────────────────────────────
-
-function detectPackageManager(): 'pnpm' | 'yarn' | 'bun' | 'npm' {
-  // Check current dir and parent dirs (for monorepos)
-  let dir = process.cwd();
-  const root = resolve('/');
-  while (dir !== root) {
-    if (existsSync(join(dir, 'bun.lockb')) || existsSync(join(dir, 'bun.lock'))) return 'bun';
-    if (existsSync(join(dir, 'pnpm-lock.yaml'))) return 'pnpm';
-    if (existsSync(join(dir, 'yarn.lock'))) return 'yarn';
-    const parent = resolve(dir, '..');
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return 'npm';
-}
-
-function detectFramework(): string {
-  try {
-    const pkg = JSON.parse(readFileSync(resolve('package.json'), 'utf-8'));
-    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
-
-    if (allDeps['next']) return 'Next.js';
-    if (allDeps['nuxt']) return 'Nuxt';
-    if (allDeps['@sveltejs/kit']) return 'SvelteKit';
-    if (allDeps['svelte']) return 'Svelte';
-    if (allDeps['vue']) return 'Vue';
-    if (allDeps['astro']) return 'Astro';
-    if (allDeps['react']) return 'React';
-    return 'Unknown';
-  } catch {
-    return 'Unknown';
-  }
-}
-
-function inferInputGlob(framework: string): string | string[] {
-  switch (framework) {
-    case 'Next.js':
-      return ['./app/**/*.{tsx,jsx}', './components/**/*.{tsx,jsx}'];
-    case 'Nuxt':
-    case 'Vue':
-      return ['./**/*.vue'];
-    case 'SvelteKit':
-    case 'Svelte':
-      return ['./src/**/*.svelte'];
-    case 'Astro':
-      return ['./src/**/*.{astro,tsx,jsx}'];
-    default:
-      return './src/**/*.{tsx,jsx}';
-  }
-}
-
-function openBrowser(url: string): void {
-  const os = platform();
-  const cmd =
-    os === 'darwin' ? 'open' :
-    os === 'win32' ? 'start ""' :
-    'xdg-open';
-
-  exec(`${cmd} "${url}"`);
-}
-
-function installCommand(pm: string): string {
-  switch (pm) {
-    case 'pnpm': return 'pnpm add';
-    case 'yarn': return 'yarn add';
-    case 'bun': return 'bun add';
-    default: return 'npm install';
-  }
-}
-
-function isMonorepoWorkspaceDep(): boolean {
-  try {
-    const pkg = JSON.parse(readFileSync(resolve('package.json'), 'utf-8'));
-    const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
-    return (
-      allDeps['@fragments-sdk/govern']?.startsWith('workspace:') ||
-      allDeps['@fragments-sdk/cli']?.startsWith('workspace:')
-    );
-  } catch {
-    return false;
-  }
-}
-
-// ─── Localhost Auth Server ──────────────────────────────────────────────────
-
-function waitForAuth(
-  cloudUrl: string,
-  port: number,
-  timeoutMs: number,
-): Promise<AuthResult> {
-  const nonce = randomBytes(16).toString('hex');
-
-  return new Promise<AuthResult>((resolve, reject) => {
-    const timeout = setTimeout(() => {
-      server.close();
-      reject(new Error('Authentication timed out. Please try again.'));
-    }, timeoutMs);
-
-    const server = createServer((req: IncomingMessage, res: ServerResponse) => {
-      const url = new URL(req.url!, `http://localhost:${port}`);
-
-      if (url.pathname === '/callback') {
-        const key = url.searchParams.get('key');
-        const org = url.searchParams.get('org');
-        const returnedNonce = url.searchParams.get('nonce');
-
-        if (returnedNonce !== nonce) {
-          res.writeHead(400, { 'Content-Type': 'text/plain' });
-          res.end('Nonce mismatch — please try again.');
-          return;
-        }
-
-        if (!key) {
-          res.writeHead(400, { 'Content-Type': 'text/plain' });
-          res.end('Missing API key in callback.');
-          return;
-        }
-
-        // Show "you can close this tab" page
-        res.writeHead(200, { 'Content-Type': 'text/html' });
-        res.end(`<!DOCTYPE html>
-<html><head><title>Fragments CLI</title>
-<style>body{font-family:system-ui,sans-serif;display:flex;align-items:center;justify-content:center;min-height:100vh;margin:0;background:#0a0a0f;color:#e5e5e5}
-.box{text-align:center;padding:48px}.check{font-size:48px;margin-bottom:16px}p{color:#888;margin-top:8px}</style>
-</head><body><div class="box"><div class="check">&#10003;</div><h2>CLI Authorized</h2><p>You can close this tab and return to your terminal.</p></div>
-<script>setTimeout(()=>window.close(),3000)</script>
-</body></html>`);
-
-        clearTimeout(timeout);
-        server.close();
-        resolve({ apiKey: key, orgName: org ?? 'your organization' });
-      } else {
-        res.writeHead(404);
-        res.end();
-      }
-    });
-
-    server.on('error', (err: NodeJS.ErrnoException) => {
-      if (err.code === 'EADDRINUSE') {
-        clearTimeout(timeout);
-        reject(new Error(`Port ${port} is in use. Try: fragments init --cloud --port ${port + 1}`));
-      } else {
-        clearTimeout(timeout);
-        reject(err);
-      }
-    });
-
-    server.listen(port, '127.0.0.1', () => {
-      const authUrl = `${cloudUrl}/cli-auth?port=${port}&nonce=${nonce}`;
-      openBrowser(authUrl);
-    });
-  });
-}
-
-// ─── Save to .env ───────────────────────────────────────────────────────────
-
-function saveApiKey(apiKey: string, cloudUrl: string): void {
-  const envPath = resolve('.env');
-  const entry = `FRAGMENTS_API_KEY=${apiKey}`;
-
-  if (existsSync(envPath)) {
-    const content = readFileSync(envPath, 'utf-8');
-    if (content.includes('FRAGMENTS_API_KEY=')) {
-      const updated = content.replace(/^FRAGMENTS_API_KEY=.*$/m, entry);
-      writeFileSync(envPath, updated, 'utf-8');
-    } else {
-      appendFileSync(envPath, `\n${entry}\n`, 'utf-8');
-    }
-  } else {
-    writeFileSync(envPath, `${entry}\n`, 'utf-8');
-  }
-
-  // Add FRAGMENTS_URL if non-default
-  if (cloudUrl !== 'https://app.usefragments.com') {
-    const content = readFileSync(envPath, 'utf-8');
-    if (!content.includes('FRAGMENTS_URL=')) {
-      appendFileSync(envPath, `FRAGMENTS_URL=${cloudUrl}\n`, 'utf-8');
-    }
-  }
-
-  // Ensure .env is in .gitignore
-  const gitignorePath = resolve('.gitignore');
-  if (existsSync(gitignorePath)) {
-    const gitignore = readFileSync(gitignorePath, 'utf-8');
-    if (!gitignore.split('\n').some((line) => line.trim() === '.env')) {
-      appendFileSync(gitignorePath, '\n.env\n', 'utf-8');
-    }
-  } else {
-    writeFileSync(gitignorePath, '.env\n', 'utf-8');
-  }
-}
-
-// ─── Write governance config ────────────────────────────────────────────────
-
-function writeGovernConfig(input: string | string[]): void {
-  const configPath = resolve(BRAND.configFile);
-  if (existsSync(configPath)) return; // Don't overwrite
-
-  const inputStr = Array.isArray(input)
-    ? `[${input.map((p) => `'${p}'`).join(', ')}]`
-    : `'${input}'`;
-
-  const template = `import { defineConfig } from '@fragments-sdk/govern';
-
-export default defineConfig({
-  cloud: true,
-  checks: ['accessibility', 'consistency', 'responsive'],
-  input: ${inputStr},
-});
-`;
-
-  writeFileSync(configPath, template, 'utf-8');
-}
-
-// ─── Main ───────────────────────────────────────────────────────────────────
-
-export async function initCloud(options: InitCloudOptions = {}): Promise<void> {
-  const cloudUrl = options.url ?? process.env.FRAGMENTS_URL ?? 'https://app.usefragments.com';
-  const port = options.port ?? 9876;
-  const timeoutMs = options.timeout ?? 120_000;
-
-  console.log(pc.bold(`\n  ${BRAND.name}\n`));
-
-  // ── 1. Detect project ─────────────────────────────────────────────
-  if (!options.authOnly) {
-    if (!existsSync(resolve('package.json'))) {
-      console.log(pc.red('  No package.json found. Run this from a project directory.\n'));
-      process.exit(1);
-    }
-
-    const pm = detectPackageManager();
-    const framework = detectFramework();
-    console.log(pc.dim(`  Project: ${framework}`));
-    console.log(pc.dim(`  Package manager: ${pm}\n`));
-  }
-
-  // ── 2. Authenticate ───────────────────────────────────────────────
-  console.log(pc.dim('  Opening browser to sign in...\n'));
-
-  let auth: AuthResult;
-  try {
-    auth = await waitForAuth(cloudUrl, port, timeoutMs);
-  } catch (err) {
-    console.log(pc.red(`\n  ${err instanceof Error ? err.message : 'Auth failed'}\n`));
-    process.exit(1);
-  }
-
-  console.log(pc.green(`  ✓ Authenticated — ${auth.orgName}\n`));
-
-  // ── 3. Save API key ──────────────────────────────────────────────
-  saveApiKey(auth.apiKey, cloudUrl);
-  console.log(pc.green('  ✓ API key saved to .env'));
-
-  if (options.authOnly) {
-    console.log(pc.green('\n  ✓ All set!\n'));
-    console.log(pc.dim(`  Dashboard: ${cloudUrl}\n`));
-    return;
-  }
-
-  // ── 4. Install dependencies ───────────────────────────────────────
-  const pm = detectPackageManager();
-
-  if (!isMonorepoWorkspaceDep()) {
-    const deps = '@fragments-sdk/govern @fragments-sdk/cli';
-    console.log(pc.dim(`\n  Installing ${deps}...`));
-    try {
-      execSync(`${installCommand(pm)} ${deps}`, {
-        stdio: 'pipe',
-        cwd: process.cwd(),
-      });
-      console.log(pc.green('  ✓ Dependencies installed'));
-    } catch (err) {
-      console.log(pc.yellow('  ⚠ Install failed — you may need to install manually:'));
-      console.log(pc.dim(`    ${installCommand(pm)} ${deps}\n`));
-    }
-  } else {
-    console.log(pc.dim('\n  Workspace deps detected — skipping install'));
-  }
-
-  // ── 5. Create governance config ───────────────────────────────────
-  const framework = detectFramework();
-  const input = inferInputGlob(framework);
-  const configPath = resolve(BRAND.configFile);
-
-  if (existsSync(configPath)) {
-    console.log(pc.dim(`  Config already exists: ${BRAND.configFile}`));
-  } else {
-    writeGovernConfig(input);
-    console.log(pc.green(`  ✓ Created ${BRAND.configFile}`));
-  }
-
-  // ── 6. Push contracts if available ──────────────────────────────────
-  const fragmentsJsonPath = resolve('fragments.json');
-  if (existsSync(fragmentsJsonPath)) {
-    console.log(pc.dim('\n  Found fragments.json — pushing contracts to Cloud...'));
-    try {
-      const { pushContracts } = await import('@fragments-sdk/govern');
-      const raw = readFileSync(fragmentsJsonPath, 'utf-8');
-      const parsed = JSON.parse(raw);
-      if (parsed.fragments && Array.isArray(parsed.fragments)) {
-        const result = await pushContracts({
-          contractRegistry: JSON.stringify({ fragments: parsed.fragments }),
-          apiKey: auth.apiKey,
-          url: cloudUrl,
-        });
-        if (result.ok) {
-          console.log(pc.green(`  ✓ Pushed ${parsed.fragments.length} component contracts`));
-        } else {
-          console.log(pc.yellow(`  ⚠ Contract push failed: ${result.error}`));
-        }
-      }
-    } catch {
-      console.log(pc.yellow('  ⚠ Could not push contracts'));
-    }
-  } else {
-    console.log(pc.dim('\n  No fragments.json found — run `fragments scan` or `fragments build` to generate contracts'));
-  }
-
-  // ── 7. Run first check ────────────────────────────────────────────
-  if (!options.skipCheck) {
-    console.log(pc.dim('\n  Running first governance check...\n'));
-    try {
-      const output = execSync('npx fragments govern check --cloud', {
-        stdio: 'pipe',
-        cwd: process.cwd(),
-        env: { ...process.env, FRAGMENTS_API_KEY: auth.apiKey },
-      });
-      console.log(output.toString());
-    } catch (err: any) {
-      // Check may "fail" with violations — that's OK
-      if (err.stdout) {
-        console.log(err.stdout.toString());
-      }
-      console.log(pc.dim('  (check completed with violations — see dashboard for details)'));
-    }
-  }
-
-  // ── 8. Done ───────────────────────────────────────────────────────
-  console.log(pc.green('\n  ✓ All set!') + ' Your project is connected to Fragments Cloud.\n');
-  console.log(pc.dim(`  Dashboard: ${cloudUrl}`));
-  console.log(pc.dim('  Run checks:      fragments govern scan'));
-  console.log(pc.dim('  Push contracts:  fragments govern push-contracts'));
-  console.log(pc.dim('  View config:     fragments.config.ts\n'));
-}

package/src/commands/push-contracts.ts

@@ -1,112 +0,0 @@
-/**
- * fragments push-contracts
- *
- * Push compiled component contracts to Fragments Cloud.
- * Reads fragments.json from the project root (or builds it from .contract.json files)
- * and posts the contract registry to the Cloud ingest endpoint.
- */
-
-import { readFileSync, existsSync } from 'node:fs';
-import { resolve } from 'node:path';
-import pc from 'picocolors';
-import { BRAND } from '../core/index.js';
-
-export interface PushContractsOptions {
-  /** Path to fragments.json or directory containing .contract.json files */
-  input?: string;
-  /** Fragments Cloud URL */
-  url?: string;
-  /** API key (defaults to FRAGMENTS_API_KEY env var) */
-  apiKey?: string;
-  /** Suppress output */
-  quiet?: boolean;
-}
-
-export async function pushContracts(
-  options: PushContractsOptions = {},
-): Promise<{ exitCode: number }> {
-  const quiet = options.quiet ?? false;
-  const apiKey = options.apiKey ?? process.env.FRAGMENTS_API_KEY;
-
-  if (!apiKey) {
-    console.error(
-      pc.red('No API key found. Set FRAGMENTS_API_KEY or pass --api-key.'),
-    );
-    return { exitCode: 1 };
-  }
-
-  if (!quiet) {
-    console.log(pc.cyan(`\n${BRAND.name} Push Contracts\n`));
-  }
-
-  // 1. Find contract registry
-  const inputPath = options.input
-    ? resolve(options.input)
-    : resolve('fragments.json');
-
-  if (!existsSync(inputPath)) {
-    console.error(
-      pc.red(`Contract registry not found at ${inputPath}`),
-    );
-    console.error(
-      pc.dim('Run `fragments build` or `fragments scan` to generate fragments.json first.'),
-    );
-    return { exitCode: 1 };
-  }
-
-  // 2. Parse and validate
-  let contractRegistry: string;
-  let componentCount = 0;
-
-  try {
-    const raw = readFileSync(inputPath, 'utf-8');
-    const parsed = JSON.parse(raw);
-    const fragments = parsed.fragments ?? parsed;
-
-    if (!Array.isArray(fragments)) {
-      console.error(pc.red('Invalid contract registry: expected fragments array'));
-      return { exitCode: 1 };
-    }
-
-    componentCount = fragments.length;
-    contractRegistry = JSON.stringify({ fragments });
-  } catch (error) {
-    console.error(
-      pc.red('Failed to parse contract registry:'),
-      error instanceof Error ? error.message : 'unknown error',
-    );
-    return { exitCode: 1 };
-  }
-
-  if (componentCount === 0) {
-    console.warn(pc.yellow('No components found in contract registry. Nothing to push.'));
-    return { exitCode: 0 };
-  }
-
-  if (!quiet) {
-    console.log(pc.dim(`  Found ${componentCount} component contracts\n`));
-    console.log(pc.dim('  Pushing to Fragments Cloud...\n'));
-  }
-
-  // 3. Push to Cloud
-  const { pushContracts: push } = await import('@fragments-sdk/govern');
-
-  const result = await push({
-    contractRegistry,
-    url: options.url,
-    apiKey,
-  });
-
-  if (!result.ok) {
-    console.error(pc.red(`Failed to push contracts: ${result.error}`));
-    return { exitCode: 1 };
-  }
-
-  if (!quiet) {
-    console.log(
-      pc.green(`  ✓ Pushed ${componentCount} component contracts to Fragments Cloud\n`),
-    );
-  }
-
-  return { exitCode: 0 };
-}