@agent-scope/cli 1.16.0 → 1.17.1

package/dist/cli.js

@@ -3,7 +3,7 @@
 // src/program.ts
 import { readFileSync as readFileSync11 } from "fs";
 import { generateTest, loadTrace } from "@agent-scope/playwright";
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 
 // src/browser.ts
 import { writeFileSync } from "fs";
@@ -1174,9 +1174,9 @@ function createRL() {
   });
 }
 async function ask(rl, question) {
-  return new Promise((resolve16) => {
+  return new Promise((resolve17) => {
     rl.question(question, (answer) => {
-      resolve16(answer.trim());
+      resolve17(answer.trim());
     });
   });
 }
@@ -1326,7 +1326,7 @@ function createInitCommand() {
 
 // src/instrument/renders.ts
 import { resolve as resolve7 } from "path";
-import { BrowserPool as BrowserPool3 } from "@agent-scope/render";
+import { BrowserPool as BrowserPool2 } from "@agent-scope/render";
 import { Command as Command5 } from "commander";
 
 // src/manifest-commands.ts
@@ -1507,6 +1507,7 @@ function createManifestCommand() {
 
 // src/instrument/hooks.ts
 import { resolve as resolve4 } from "path";
+import { getBrowserEntryScript as getBrowserEntryScript2 } from "@agent-scope/playwright";
 import { Command as Cmd } from "commander";
 import { chromium as chromium2 } from "playwright";
 var MANIFEST_PATH2 = ".reactscope/manifest.json";
@@ -1764,6 +1765,7 @@ async function runHooksProfiling(componentName, filePath, props) {
   try {
     const context = await browser.newContext();
     const page = await context.newPage();
+    await page.addInitScript({ content: getBrowserEntryScript2() });
     const htmlHarness = await buildComponentHarness(filePath, componentName, props, 1280);
     await page.setContent(htmlHarness, { waitUntil: "load" });
     await page.waitForFunction(
@@ -2152,30 +2154,12 @@ Available: ${available}`
 
 // src/instrument/tree.ts
 import { resolve as resolve6 } from "path";
-import { getBrowserEntryScript as getBrowserEntryScript2 } from "@agent-scope/playwright";
-import { BrowserPool as BrowserPool2 } from "@agent-scope/render";
+import { getBrowserEntryScript as getBrowserEntryScript3 } from "@agent-scope/playwright";
 import { Command as Command4 } from "commander";
+import { chromium as chromium4 } from "playwright";
 var MANIFEST_PATH4 = ".reactscope/manifest.json";
 var DEFAULT_VIEWPORT_WIDTH = 375;
 var DEFAULT_VIEWPORT_HEIGHT = 812;
-var _pool2 = null;
-async function getPool2() {
-  if (_pool2 === null) {
-    _pool2 = new BrowserPool2({
-      size: { browsers: 1, pagesPerBrowser: 1 },
-      viewportWidth: DEFAULT_VIEWPORT_WIDTH,
-      viewportHeight: DEFAULT_VIEWPORT_HEIGHT
-    });
-    await _pool2.init();
-  }
-  return _pool2;
-}
-async function shutdownPool2() {
-  if (_pool2 !== null) {
-    await _pool2.close();
-    _pool2 = null;
-  }
-}
 function mapNodeType(node) {
   if (node.type === "forward_ref") return "forwardRef";
   if (node.type === "host") return "host";
@@ -2387,11 +2371,13 @@ function formatInstrumentTree(root, showProviderDepth = false) {
 }
 async function runInstrumentTree(options) {
   const { componentName, filePath } = options;
-  const pool = await getPool2();
-  const slot = await pool.acquire();
-  const { page } = slot;
+  const browser = await chromium4.launch({ headless: true });
   try {
-    await page.addInitScript({ content: getBrowserEntryScript2() });
+    const context = await browser.newContext({
+      viewport: { width: DEFAULT_VIEWPORT_WIDTH, height: DEFAULT_VIEWPORT_HEIGHT }
+    });
+    const page = await context.newPage();
+    await page.addInitScript({ content: getBrowserEntryScript3() });
     const htmlHarness = await buildComponentHarness(
       filePath,
       componentName,
@@ -2444,7 +2430,7 @@ async function runInstrumentTree(options) {
     }
     return instrumentRoot;
   } finally {
-    pool.release(slot);
+    await browser.close();
   }
 }
 function createInstrumentTreeCommand() {
@@ -2484,7 +2470,6 @@ Available: ${available}`
         providerDepth: opts.providerDepth,
         wastedRenders: opts.wastedRenders
       });
-      await shutdownPool2();
       const fmt2 = resolveFormat2(opts.format);
       if (fmt2 === "json") {
         process.stdout.write(`${JSON.stringify(instrumentRoot, null, 2)}
@@ -2495,7 +2480,6 @@ Available: ${available}`
 `);
       }
     } catch (err) {
-      await shutdownPool2();
       process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
 `);
       process.exit(1);
@@ -2815,22 +2799,22 @@ async function replayInteraction2(page, steps) {
     }
   }
 }
-var _pool3 = null;
-async function getPool3() {
-  if (_pool3 === null) {
-    _pool3 = new BrowserPool3({
+var _pool2 = null;
+async function getPool2() {
+  if (_pool2 === null) {
+    _pool2 = new BrowserPool2({
       size: { browsers: 1, pagesPerBrowser: 2 },
       viewportWidth: 1280,
       viewportHeight: 800
     });
-    await _pool3.init();
+    await _pool2.init();
   }
-  return _pool3;
+  return _pool2;
 }
-async function shutdownPool3() {
-  if (_pool3 !== null) {
-    await _pool3.close();
-    _pool3 = null;
+async function shutdownPool2() {
+  if (_pool2 !== null) {
+    await _pool2.close();
+    _pool2 = null;
   }
 }
 async function analyzeRenders(options) {
@@ -2847,7 +2831,7 @@ Available: ${available}`
   const rootDir = process.cwd();
   const filePath = resolve7(rootDir, descriptor.filePath);
   const htmlHarness = await buildComponentHarness(filePath, options.componentName, {}, 1280);
-  const pool = await getPool3();
+  const pool = await getPool2();
   const slot = await pool.acquire();
   const { page } = slot;
   const startMs = performance.now();
@@ -2955,7 +2939,7 @@ function createInstrumentRendersCommand() {
           interaction,
           manifestPath: opts.manifest
         });
-        await shutdownPool3();
+        await shutdownPool2();
         if (opts.json || !isTTY()) {
           process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
@@ -2964,7 +2948,7 @@ function createInstrumentRendersCommand() {
 `);
         }
       } catch (err) {
-        await shutdownPool3();
+        await shutdownPool2();
         process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -2989,7 +2973,7 @@ import { resolve as resolve8 } from "path";
 import {
   ALL_CONTEXT_IDS,
   ALL_STRESS_IDS,
-  BrowserPool as BrowserPool4,
+  BrowserPool as BrowserPool3,
   contextAxis,
   RenderMatrix,
   SatoriRenderer,
@@ -2999,22 +2983,22 @@ import {
 import { Command as Command6 } from "commander";
 var MANIFEST_PATH6 = ".reactscope/manifest.json";
 var DEFAULT_OUTPUT_DIR = ".reactscope/renders";
-var _pool4 = null;
-async function getPool4(viewportWidth, viewportHeight) {
-  if (_pool4 === null) {
-    _pool4 = new BrowserPool4({
+var _pool3 = null;
+async function getPool3(viewportWidth, viewportHeight) {
+  if (_pool3 === null) {
+    _pool3 = new BrowserPool3({
       size: { browsers: 1, pagesPerBrowser: 4 },
       viewportWidth,
       viewportHeight
     });
-    await _pool4.init();
+    await _pool3.init();
   }
-  return _pool4;
+  return _pool3;
 }
-async function shutdownPool4() {
-  if (_pool4 !== null) {
-    await _pool4.close();
-    _pool4 = null;
+async function shutdownPool3() {
+  if (_pool3 !== null) {
+    await _pool3.close();
+    _pool3 = null;
   }
 }
 function buildRenderer(filePath, componentName, viewportWidth, viewportHeight) {
@@ -3025,7 +3009,7 @@ function buildRenderer(filePath, componentName, viewportWidth, viewportHeight) {
     _satori: satori,
     async renderCell(props, _complexityClass) {
       const startMs = performance.now();
-      const pool = await getPool4(viewportWidth, viewportHeight);
+      const pool = await getPool3(viewportWidth, viewportHeight);
       const htmlHarness = await buildComponentHarness(
         filePath,
         componentName,
@@ -3161,7 +3145,7 @@ Available: ${available}`
             }
           }
         );
-        await shutdownPool4();
+        await shutdownPool3();
         if (outcome.crashed) {
           process.stderr.write(`\u2717 Render failed: ${outcome.error.message}
 `);
@@ -3209,7 +3193,7 @@ Available: ${available}`
           );
         }
       } catch (err) {
-        await shutdownPool4();
+        await shutdownPool3();
         process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -3294,7 +3278,7 @@ Available: ${available}`
           concurrency
         });
         const result = await matrix.render();
-        await shutdownPool4();
+        await shutdownPool3();
         process.stderr.write(
           `Done. ${result.stats.totalCells} cells, avg ${result.stats.avgRenderTimeMs.toFixed(1)}ms
 `
@@ -3339,7 +3323,7 @@ Available: ${available}`
           process.stdout.write(formatMatrixCsv(componentName, result));
         }
       } catch (err) {
-        await shutdownPool4();
+        await shutdownPool3();
         process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -3436,13 +3420,13 @@ function registerRenderAll(renderCmd) {
           workers.push(worker());
         }
         await Promise.all(workers);
-        await shutdownPool4();
+        await shutdownPool3();
         process.stderr.write("\n");
         const summary = formatSummaryText(results, outputDir);
         process.stderr.write(`${summary}
 `);
       } catch (err) {
-        await shutdownPool4();
+        await shutdownPool3();
         process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
 `);
         process.exit(1);
@@ -3488,29 +3472,29 @@ function createRenderCommand() {
 import { existsSync as existsSync6, mkdirSync as mkdirSync4, rmSync, writeFileSync as writeFileSync6 } from "fs";
 import { resolve as resolve9 } from "path";
 import { generateManifest as generateManifest3 } from "@agent-scope/manifest";
-import { BrowserPool as BrowserPool5, safeRender as safeRender3 } from "@agent-scope/render";
+import { BrowserPool as BrowserPool4, safeRender as safeRender3 } from "@agent-scope/render";
 import { ComplianceEngine as ComplianceEngine2, TokenResolver as TokenResolver2 } from "@agent-scope/tokens";
 var DEFAULT_BASELINE_DIR = ".reactscope/baseline";
-var _pool5 = null;
-async function getPool5(viewportWidth, viewportHeight) {
-  if (_pool5 === null) {
-    _pool5 = new BrowserPool5({
+var _pool4 = null;
+async function getPool4(viewportWidth, viewportHeight) {
+  if (_pool4 === null) {
+    _pool4 = new BrowserPool4({
       size: { browsers: 1, pagesPerBrowser: 4 },
       viewportWidth,
       viewportHeight
     });
-    await _pool5.init();
+    await _pool4.init();
   }
-  return _pool5;
+  return _pool4;
 }
-async function shutdownPool5() {
-  if (_pool5 !== null) {
-    await _pool5.close();
-    _pool5 = null;
+async function shutdownPool4() {
+  if (_pool4 !== null) {
+    await _pool4.close();
+    _pool4 = null;
   }
 }
 async function renderComponent2(filePath, componentName, props, viewportWidth, viewportHeight) {
-  const pool = await getPool5(viewportWidth, viewportHeight);
+  const pool = await getPool4(viewportWidth, viewportHeight);
   const htmlHarness = await buildComponentHarness(filePath, componentName, props, viewportWidth);
   const slot = await pool.acquire();
   const { page } = slot;
@@ -3760,7 +3744,7 @@ async function runBaseline(options = {}) {
     workers.push(worker());
   }
   await Promise.all(workers);
-  await shutdownPool5();
+  await shutdownPool4();
   if (isTTY()) {
     process.stderr.write("\n");
   }
@@ -3814,7 +3798,7 @@ function registerBaselineSubCommand(reportCmd) {
 import { existsSync as existsSync7, readFileSync as readFileSync6, writeFileSync as writeFileSync7 } from "fs";
 import { resolve as resolve10 } from "path";
 import { generateManifest as generateManifest4 } from "@agent-scope/manifest";
-import { BrowserPool as BrowserPool6, safeRender as safeRender4 } from "@agent-scope/render";
+import { BrowserPool as BrowserPool5, safeRender as safeRender4 } from "@agent-scope/render";
 import { ComplianceEngine as ComplianceEngine3, TokenResolver as TokenResolver3 } from "@agent-scope/tokens";
 var DEFAULT_BASELINE_DIR2 = ".reactscope/baseline";
 function loadBaselineCompliance(baselineDir) {
@@ -3828,26 +3812,26 @@ function loadBaselineRenderJson2(baselineDir, componentName) {
   if (!existsSync7(jsonPath)) return null;
   return JSON.parse(readFileSync6(jsonPath, "utf-8"));
 }
-var _pool6 = null;
-async function getPool6(viewportWidth, viewportHeight) {
-  if (_pool6 === null) {
-    _pool6 = new BrowserPool6({
+var _pool5 = null;
+async function getPool5(viewportWidth, viewportHeight) {
+  if (_pool5 === null) {
+    _pool5 = new BrowserPool5({
       size: { browsers: 1, pagesPerBrowser: 4 },
       viewportWidth,
       viewportHeight
     });
-    await _pool6.init();
+    await _pool5.init();
   }
-  return _pool6;
+  return _pool5;
 }
-async function shutdownPool6() {
-  if (_pool6 !== null) {
-    await _pool6.close();
-    _pool6 = null;
+async function shutdownPool5() {
+  if (_pool5 !== null) {
+    await _pool5.close();
+    _pool5 = null;
   }
 }
 async function renderComponent3(filePath, componentName, props, viewportWidth, viewportHeight) {
-  const pool = await getPool6(viewportWidth, viewportHeight);
+  const pool = await getPool5(viewportWidth, viewportHeight);
   const htmlHarness = await buildComponentHarness(filePath, componentName, props, viewportWidth);
   const slot = await pool.acquire();
   const { page } = slot;
@@ -4096,7 +4080,7 @@ async function runDiff(options = {}) {
     }
     await Promise.all(workers);
   }
-  await shutdownPool6();
+  await shutdownPool5();
   if (isTTY() && total > 0) {
     process.stderr.write("\n");
   }
@@ -4702,9 +4686,140 @@ function buildStructuredReport(report) {
   };
 }
 
+// src/site-commands.ts
+import { createReadStream, existsSync as existsSync9, statSync } from "fs";
+import { createServer } from "http";
+import { extname, join as join3, resolve as resolve12 } from "path";
+import { buildSite } from "@agent-scope/site";
+import { Command as Command7 } from "commander";
+var MIME_TYPES = {
+  ".html": "text/html; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".js": "application/javascript; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".svg": "image/svg+xml",
+  ".ico": "image/x-icon"
+};
+function registerBuild(siteCmd) {
+  siteCmd.command("build").description("Build a static HTML gallery from .reactscope/ output").option("-i, --input <path>", "Path to .reactscope input directory", ".reactscope").option("-o, --output <path>", "Output directory for generated site", ".reactscope/site").option("--base-path <path>", "Base URL path prefix for subdirectory deployment", "/").option("--compliance <path>", "Path to compliance batch report JSON").option("--title <text>", "Site title", "Scope \u2014 Component Gallery").action(
+    async (opts) => {
+      try {
+        const inputDir = resolve12(process.cwd(), opts.input);
+        const outputDir = resolve12(process.cwd(), opts.output);
+        if (!existsSync9(inputDir)) {
+          throw new Error(
+            `Input directory not found: ${inputDir}
+Run \`scope manifest generate\` and \`scope render\` first.`
+          );
+        }
+        const manifestPath = join3(inputDir, "manifest.json");
+        if (!existsSync9(manifestPath)) {
+          throw new Error(
+            `Manifest not found at ${manifestPath}
+Run \`scope manifest generate\` first.`
+          );
+        }
+        process.stderr.write(`Building site from ${inputDir}\u2026
+`);
+        await buildSite({
+          inputDir,
+          outputDir,
+          basePath: opts.basePath,
+          ...opts.compliance !== void 0 && {
+            compliancePath: resolve12(process.cwd(), opts.compliance)
+          },
+          title: opts.title
+        });
+        process.stderr.write(`Site written to ${outputDir}
+`);
+        process.stdout.write(`${outputDir}
+`);
+      } catch (err) {
+        process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
+`);
+        process.exit(1);
+      }
+    }
+  );
+}
+function registerServe(siteCmd) {
+  siteCmd.command("serve").description("Serve the built static site locally").option("-p, --port <number>", "Port to listen on", "3000").option("-d, --dir <path>", "Directory to serve", ".reactscope/site").action((opts) => {
+    try {
+      const port = Number.parseInt(opts.port, 10);
+      if (Number.isNaN(port) || port < 1 || port > 65535) {
+        throw new Error(`Invalid port: ${opts.port}`);
+      }
+      const serveDir = resolve12(process.cwd(), opts.dir);
+      if (!existsSync9(serveDir)) {
+        throw new Error(
+          `Serve directory not found: ${serveDir}
+Run \`scope site build\` first.`
+        );
+      }
+      const server = createServer((req, res) => {
+        const rawUrl = req.url ?? "/";
+        const urlPath = decodeURIComponent(rawUrl.split("?")[0] ?? "/");
+        const filePath = join3(serveDir, urlPath.endsWith("/") ? `${urlPath}index.html` : urlPath);
+        if (!filePath.startsWith(serveDir)) {
+          res.writeHead(403, { "Content-Type": "text/plain" });
+          res.end("Forbidden");
+          return;
+        }
+        if (existsSync9(filePath) && statSync(filePath).isFile()) {
+          const ext = extname(filePath).toLowerCase();
+          const contentType = MIME_TYPES[ext] ?? "application/octet-stream";
+          res.writeHead(200, { "Content-Type": contentType });
+          createReadStream(filePath).pipe(res);
+          return;
+        }
+        const htmlPath = `${filePath}.html`;
+        if (existsSync9(htmlPath) && statSync(htmlPath).isFile()) {
+          res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+          createReadStream(htmlPath).pipe(res);
+          return;
+        }
+        res.writeHead(404, { "Content-Type": "text/plain" });
+        res.end(`Not found: ${urlPath}`);
+      });
+      server.listen(port, () => {
+        process.stderr.write(`Scope site running at http://localhost:${port}
+`);
+        process.stderr.write(`Serving ${serveDir}
+`);
+        process.stderr.write("Press Ctrl+C to stop.\n");
+      });
+      server.on("error", (err) => {
+        if (err.code === "EADDRINUSE") {
+          process.stderr.write(`Error: Port ${port} is already in use.
+`);
+        } else {
+          process.stderr.write(`Server error: ${err.message}
+`);
+        }
+        process.exit(1);
+      });
+    } catch (err) {
+      process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
+`);
+      process.exit(1);
+    }
+  });
+}
+function createSiteCommand() {
+  const siteCmd = new Command7("site").description(
+    "Build and serve the static component gallery site"
+  );
+  registerBuild(siteCmd);
+  registerServe(siteCmd);
+  return siteCmd;
+}
+
 // src/tokens/commands.ts
-import { existsSync as existsSync11, readFileSync as readFileSync10 } from "fs";
-import { resolve as resolve15 } from "path";
+import { existsSync as existsSync12, readFileSync as readFileSync10 } from "fs";
+import { resolve as resolve16 } from "path";
 import {
   parseTokenFileSync as parseTokenFileSync2,
   TokenParseError,
@@ -4712,19 +4827,19 @@ import {
   TokenValidationError,
   validateTokenFile
 } from "@agent-scope/tokens";
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 
 // src/tokens/compliance.ts
-import { existsSync as existsSync9, readFileSync as readFileSync8 } from "fs";
-import { resolve as resolve12 } from "path";
+import { existsSync as existsSync10, readFileSync as readFileSync8 } from "fs";
+import { resolve as resolve13 } from "path";
 import {
   ComplianceEngine as ComplianceEngine4,
   TokenResolver as TokenResolver4
 } from "@agent-scope/tokens";
 var DEFAULT_STYLES_PATH = ".reactscope/compliance-styles.json";
 function loadStylesFile(stylesPath) {
-  const absPath = resolve12(process.cwd(), stylesPath);
-  if (!existsSync9(absPath)) {
+  const absPath = resolve13(process.cwd(), stylesPath);
+  if (!existsSync10(absPath)) {
     throw new Error(
       `Compliance styles file not found at ${absPath}.
 Run \`scope render all\` first to generate component styles, or use --styles to specify a path.
@@ -4891,38 +5006,38 @@ function registerCompliance(tokensCmd) {
 }
 
 // src/tokens/export.ts
-import { existsSync as existsSync10, readFileSync as readFileSync9, writeFileSync as writeFileSync9 } from "fs";
-import { resolve as resolve13 } from "path";
+import { existsSync as existsSync11, readFileSync as readFileSync9, writeFileSync as writeFileSync9 } from "fs";
+import { resolve as resolve14 } from "path";
 import {
   exportTokens,
   parseTokenFileSync,
   ThemeResolver,
   TokenResolver as TokenResolver5
 } from "@agent-scope/tokens";
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 var DEFAULT_TOKEN_FILE = "reactscope.tokens.json";
 var CONFIG_FILE = "reactscope.config.json";
 var SUPPORTED_FORMATS = ["css", "ts", "scss", "tailwind", "flat-json", "figma"];
 function resolveTokenFilePath2(fileFlag) {
   if (fileFlag !== void 0) {
-    return resolve13(process.cwd(), fileFlag);
+    return resolve14(process.cwd(), fileFlag);
   }
-  const configPath = resolve13(process.cwd(), CONFIG_FILE);
-  if (existsSync10(configPath)) {
+  const configPath = resolve14(process.cwd(), CONFIG_FILE);
+  if (existsSync11(configPath)) {
     try {
       const raw = readFileSync9(configPath, "utf-8");
       const config = JSON.parse(raw);
       if (typeof config === "object" && config !== null && "tokens" in config && typeof config.tokens === "object" && config.tokens !== null && typeof config.tokens?.file === "string") {
         const file = config.tokens.file;
-        return resolve13(process.cwd(), file);
+        return resolve14(process.cwd(), file);
       }
     } catch {
     }
   }
-  return resolve13(process.cwd(), DEFAULT_TOKEN_FILE);
+  return resolve14(process.cwd(), DEFAULT_TOKEN_FILE);
 }
 function createTokensExportCommand() {
-  return new Command7("export").description("Export design tokens to a downstream format").requiredOption("--format <fmt>", `Output format: ${SUPPORTED_FORMATS.join(", ")}`).option("--file <path>", "Path to token file (overrides config)").option("--out <path>", "Write output to file instead of stdout").option("--prefix <prefix>", "CSS/SCSS: prefix for variable names (e.g. 'scope')").option("--selector <selector>", "CSS: custom root selector (default: ':root')").option(
+  return new Command8("export").description("Export design tokens to a downstream format").requiredOption("--format <fmt>", `Output format: ${SUPPORTED_FORMATS.join(", ")}`).option("--file <path>", "Path to token file (overrides config)").option("--out <path>", "Write output to file instead of stdout").option("--prefix <prefix>", "CSS/SCSS: prefix for variable names (e.g. 'scope')").option("--selector <selector>", "CSS: custom root selector (default: ':root')").option(
     "--theme <name>",
     "Include theme overrides for the named theme (applies to css, ts, scss, tailwind, figma)"
   ).action(
@@ -4938,7 +5053,7 @@ Supported formats: ${SUPPORTED_FORMATS.join(", ")}
       const format = opts.format;
       try {
         const filePath = resolveTokenFilePath2(opts.file);
-        if (!existsSync10(filePath)) {
+        if (!existsSync11(filePath)) {
           throw new Error(
             `Token file not found at ${filePath}.
 Create a reactscope.tokens.json file or use --file to specify a path.`
@@ -4983,7 +5098,7 @@ Available themes: ${themeNames.join(", ")}`
           themes: themesMap
         });
         if (opts.out !== void 0) {
-          const outPath = resolve13(process.cwd(), opts.out);
+          const outPath = resolve14(process.cwd(), opts.out);
           writeFileSync9(outPath, output, "utf-8");
           process.stderr.write(`Exported ${tokens.length} tokens to ${outPath}
 `);
@@ -5099,8 +5214,8 @@ ${formatImpactSummary(report)}
 
 // src/tokens/preview.ts
 import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync10 } from "fs";
-import { resolve as resolve14 } from "path";
-import { BrowserPool as BrowserPool7, SpriteSheetGenerator } from "@agent-scope/render";
+import { resolve as resolve15 } from "path";
+import { BrowserPool as BrowserPool6, SpriteSheetGenerator } from "@agent-scope/render";
 import { ComplianceEngine as ComplianceEngine6, ImpactAnalyzer as ImpactAnalyzer2, TokenResolver as TokenResolver7 } from "@agent-scope/tokens";
 var DEFAULT_STYLES_PATH3 = ".reactscope/compliance-styles.json";
 var DEFAULT_MANIFEST_PATH = ".reactscope/manifest.json";
@@ -5115,7 +5230,7 @@ async function renderComponentWithCssOverride(filePath, componentName, cssOverri
     cssOverride
     // injected as <style>
   );
-  const pool = new BrowserPool7({
+  const pool = new BrowserPool6({
     size: { browsers: 1, pagesPerBrowser: 1 },
     viewportWidth: vpWidth,
     viewportHeight: vpHeight
@@ -5280,8 +5395,8 @@ function registerPreview(tokensCmd) {
         });
         const spriteResult = await generator.generate(matrixResult);
         const tokenLabel = tokenPath.replace(/\./g, "-");
-        const outputPath = opts.output ?? resolve14(process.cwd(), DEFAULT_OUTPUT_DIR2, `preview-${tokenLabel}.png`);
-        const outputDir = resolve14(outputPath, "..");
+        const outputPath = opts.output ?? resolve15(process.cwd(), DEFAULT_OUTPUT_DIR2, `preview-${tokenLabel}.png`);
+        const outputDir = resolve15(outputPath, "..");
         mkdirSync5(outputDir, { recursive: true });
         writeFileSync10(outputPath, spriteResult.png);
         const useJson = opts.format === "json" || opts.format !== "text" && !isTTY();
@@ -5342,24 +5457,24 @@ function buildTable2(headers, rows) {
 }
 function resolveTokenFilePath(fileFlag) {
   if (fileFlag !== void 0) {
-    return resolve15(process.cwd(), fileFlag);
+    return resolve16(process.cwd(), fileFlag);
   }
-  const configPath = resolve15(process.cwd(), CONFIG_FILE2);
-  if (existsSync11(configPath)) {
+  const configPath = resolve16(process.cwd(), CONFIG_FILE2);
+  if (existsSync12(configPath)) {
     try {
       const raw = readFileSync10(configPath, "utf-8");
       const config = JSON.parse(raw);
       if (typeof config === "object" && config !== null && "tokens" in config && typeof config.tokens === "object" && config.tokens !== null && typeof config.tokens?.file === "string") {
         const file = config.tokens.file;
-        return resolve15(process.cwd(), file);
+        return resolve16(process.cwd(), file);
       }
     } catch {
     }
   }
-  return resolve15(process.cwd(), DEFAULT_TOKEN_FILE2);
+  return resolve16(process.cwd(), DEFAULT_TOKEN_FILE2);
 }
 function loadTokens(absPath) {
-  if (!existsSync11(absPath)) {
+  if (!existsSync12(absPath)) {
     throw new Error(
       `Token file not found at ${absPath}.
 Create a reactscope.tokens.json file or use --file to specify a path.`
@@ -5579,7 +5694,7 @@ function registerValidate(tokensCmd) {
   ).option("--file <path>", "Path to token file (overrides config)").option("--format <fmt>", "Output format: json or text (default: auto-detect)").action((opts) => {
     try {
       const filePath = resolveTokenFilePath(opts.file);
-      if (!existsSync11(filePath)) {
+      if (!existsSync12(filePath)) {
         throw new Error(
           `Token file not found at ${filePath}.
 Create a reactscope.tokens.json file or use --file to specify a path.`
@@ -5653,7 +5768,7 @@ function outputValidationResult(filePath, errors, useJson) {
   }
 }
 function createTokensCommand() {
-  const tokensCmd = new Command8("tokens").description(
+  const tokensCmd = new Command9("tokens").description(
     "Query and validate design tokens from a reactscope.tokens.json file"
   );
   registerGet2(tokensCmd);
@@ -5670,7 +5785,7 @@ function createTokensCommand() {
 
 // src/program.ts
 function createProgram(options = {}) {
-  const program2 = new Command9("scope").version(options.version ?? "0.1.0").description("Scope \u2014 React instrumentation toolkit");
+  const program2 = new Command10("scope").version(options.version ?? "0.1.0").description("Scope \u2014 React instrumentation toolkit");
   program2.command("capture <url>").description("Capture a React component tree from a live URL and output as JSON").option("-o, --output <path>", "Write JSON to file instead of stdout").option("--pretty", "Pretty-print JSON output (default: minified)", false).option("--timeout <ms>", "Max wait time for React to mount (ms)", "10000").option("--wait <ms>", "Additional wait after page load before capture (ms)", "0").action(
     async (url, opts) => {
       try {
@@ -5764,6 +5879,7 @@ function createProgram(options = {}) {
     registerDiffSubCommand(existingReportCmd);
     registerPrCommentSubCommand(existingReportCmd);
   }
+  program2.addCommand(createSiteCommand());
   return program2;
 }