@wix/web50-cli 0.1.0 → 0.1.1

package/dist/esm/commands/logout.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Command","logout","error","logoutCommand","description","action","err_","Error","message","String","process","exit"],"sources":["../../../src/commands/logout.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { logout } from '../auth';\nimport { error } from '../utils/print';\n\nexport const logoutCommand = new Command('logout')\n  .description('Sign out and remove stored credentials')\n  .action(async () => {\n    try {\n      await logout();\n    } catch (err_) {\n      error(err_ instanceof Error ? err_.message : String(err_));\n      process.exit(1);\n    }\n  });\n"],"mappings":"AAAA,SAASA,OAAO,QAAQ,WAAW;AACnC,SAASC,MAAM,QAAQ,SAAS;AAChC,SAASC,KAAK,QAAQ,gBAAgB;AAEtC,OAAO,MAAMC,aAAa,GAAG,IAAIH,OAAO,CAAC,QAAQ,CAAC,CAC/CI,WAAW,CAAC,wCAAwC,CAAC,CACrDC,MAAM,CAAC,YAAY;EAClB,IAAI;IACF,MAAMJ,MAAM,CAAC,CAAC;EAChB,CAAC,CAAC,OAAOK,IAAI,EAAE;IACbJ,KAAK,CAACI,IAAI,YAAYC,KAAK,GAAGD,IAAI,CAACE,OAAO,GAAGC,MAAM,CAACH,IAAI,CAAC,CAAC;IAC1DI,OAAO,CAACC,IAAI,CAAC,CAAC,CAAC;EACjB;AACF,CAAC,CAAC","ignoreList":[]}

package/dist/esm/commands/serve.js

@@ -0,0 +1,117 @@
+import { Command } from 'commander';
+import * as path from 'path';
+import * as fs from 'fs';
+import * as http from 'http';
+import { spawn } from 'child_process';
+import { success, error, info, isJsonMode } from '../utils/print';
+import { findProjectRoot } from '../utils/project';
+import { runBundle } from './bundle';
+const DEFAULT_PORT = 4001;
+const MIME_TYPES = {
+  '.js': 'application/javascript',
+  '.css': 'text/css',
+  '.json': 'application/json',
+  '.map': 'application/json'
+};
+function startServer(distDir, corsOrigin) {
+  const server = http.createServer((req, res) => {
+    res.setHeader('Access-Control-Allow-Origin', corsOrigin);
+    res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');
+    res.setHeader('Access-Control-Allow-Headers', '*');
+    if (req.method === 'OPTIONS') {
+      res.writeHead(204);
+      res.end();
+      return;
+    }
+    const urlPath = req.url === '/' ? '' : req.url ?? '';
+    const filePath = path.join(distDir, urlPath);
+
+    // Prevent path traversal outside distDir
+    if (!filePath.startsWith(distDir)) {
+      res.writeHead(403);
+      res.end('Forbidden');
+      return;
+    }
+    if (!fs.existsSync(filePath) || fs.statSync(filePath).isDirectory()) {
+      res.writeHead(404);
+      res.end('Not found');
+      return;
+    }
+    const ext = path.extname(filePath);
+    const contentType = MIME_TYPES[ext] ?? 'application/octet-stream';
+    res.setHeader('Content-Type', contentType);
+    res.writeHead(200);
+    fs.createReadStream(filePath).pipe(res);
+  });
+  return server;
+}
+export const serveCommand = new Command('serve').description('Bundle components and serve them on http://localhost:<port> with CORS enabled').option('--port <n>', 'Port to listen on', String(DEFAULT_PORT)).option('--no-bundle', 'Serve existing dist/cdn/ without rebuilding').option('--watch', 'Re-bundle on source changes (starts vite --watch alongside server)').option('--open', 'Open the served URL in your browser after start').option('--cors-origin <origin>', 'Restrict CORS Allow-Origin header', '*').action(async opts => {
+  try {
+    const projectRoot = findProjectRoot(process.cwd());
+    if (!projectRoot) {
+      error('No web5.config.json found. Run this command from within a Web5 project.');
+      process.exit(1);
+    }
+    const port = parseInt(opts.port, 10);
+    if (isNaN(port) || port < 1 || port > 65535) {
+      error(`Invalid port: ${opts.port}`);
+      process.exit(1);
+    }
+    const distDir = path.join(projectRoot, 'dist', 'cdn');
+
+    // ── Bundle (unless --no-bundle) ─────────────────────────────────────────
+    if (opts.bundle !== false) {
+      await runBundle(projectRoot);
+    }
+    if (!fs.existsSync(distDir)) {
+      error(`Bundle output not found at ${distDir}. Run \`web5 bundle\` first or remove --no-bundle.`);
+      process.exit(1);
+    }
+
+    // ── Watch mode: spawn vite --watch in background ────────────────────────
+    if (opts.watch) {
+      const viteBin = path.join(projectRoot, 'node_modules', '.bin', 'vite');
+      if (!fs.existsSync(viteBin)) {
+        error('vite not found. Run `npm install` in your project first.');
+        process.exit(1);
+      }
+      const watcher = spawn(`"${viteBin}"`, ['build', '--config', 'src/vite.cdn.config.ts', '--watch'], {
+        cwd: projectRoot,
+        shell: true,
+        stdio: 'inherit'
+      });
+      watcher.on('error', err_ => error(`Watch process error: ${err_.message}`));
+    }
+
+    // ── Start HTTP server ───────────────────────────────────────────────────
+    const server = startServer(distDir, opts.corsOrigin);
+    const url = `http://localhost:${port}`;
+    server.listen(port, async () => {
+      const files = fs.readdirSync(distDir);
+      if (isJsonMode()) {
+        console.log(JSON.stringify({
+          url,
+          port,
+          files: files.map(f => `${url}/${f}`)
+        }));
+      } else {
+        success(`Serving on ${url}`);
+        for (const file of files) {
+          info(`  ${url}/${file}`);
+        }
+        if (opts.watch) {
+          info('Watch mode active — rebuilds automatically on file changes.');
+        }
+        info('Press Ctrl+C to stop.');
+      }
+      if (opts.open) {
+        const openPkg = (await import('open')).default;
+        await openPkg(url);
+      }
+    });
+  } catch (err_) {
+    error(err_ instanceof Error ? err_.message : String(err_));
+    process.exit(1);
+  }
+});
+//# sourceMappingURL=serve.js.map

package/dist/esm/commands/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Command","path","fs","http","spawn","success","error","info","isJsonMode","findProjectRoot","runBundle","DEFAULT_PORT","MIME_TYPES","startServer","distDir","corsOrigin","server","createServer","req","res","setHeader","method","writeHead","end","urlPath","url","filePath","join","startsWith","existsSync","statSync","isDirectory","ext","extname","contentType","createReadStream","pipe","serveCommand","description","option","String","action","opts","projectRoot","process","cwd","exit","port","parseInt","isNaN","bundle","watch","viteBin","watcher","shell","stdio","on","err_","message","listen","files","readdirSync","console","log","JSON","stringify","map","f","file","open","openPkg","default","Error"],"sources":["../../../src/commands/serve.ts"],"sourcesContent":["import { Command } from 'commander';\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport * as http from 'http';\nimport { spawn } from 'child_process';\nimport { success, error, info, isJsonMode } from '../utils/print';\nimport { findProjectRoot } from '../utils/project';\nimport { runBundle } from './bundle';\n\nconst DEFAULT_PORT = 4001;\n\nconst MIME_TYPES: Record<string, string> = {\n  '.js': 'application/javascript',\n  '.css': 'text/css',\n  '.json': 'application/json',\n  '.map': 'application/json',\n};\n\nfunction startServer(\n  distDir: string,\n  corsOrigin: string,\n): http.Server {\n  const server = http.createServer((req, res) => {\n    res.setHeader('Access-Control-Allow-Origin', corsOrigin);\n    res.setHeader('Access-Control-Allow-Methods', 'GET, OPTIONS');\n    res.setHeader('Access-Control-Allow-Headers', '*');\n\n    if (req.method === 'OPTIONS') {\n      res.writeHead(204);\n      res.end();\n      return;\n    }\n\n    const urlPath = req.url === '/' ? '' : req.url ?? '';\n    const filePath = path.join(distDir, urlPath);\n\n    // Prevent path traversal outside distDir\n    if (!filePath.startsWith(distDir)) {\n      res.writeHead(403);\n      res.end('Forbidden');\n      return;\n    }\n\n    if (!fs.existsSync(filePath) || fs.statSync(filePath).isDirectory()) {\n      res.writeHead(404);\n      res.end('Not found');\n      return;\n    }\n\n    const ext = path.extname(filePath);\n    const contentType = MIME_TYPES[ext] ?? 'application/octet-stream';\n    res.setHeader('Content-Type', contentType);\n    res.writeHead(200);\n    fs.createReadStream(filePath).pipe(res);\n  });\n\n  return server;\n}\n\nexport const serveCommand = new Command('serve')\n  .description('Bundle components and serve them on http://localhost:<port> with CORS enabled')\n  .option('--port <n>', 'Port to listen on', String(DEFAULT_PORT))\n  .option('--no-bundle', 'Serve existing dist/cdn/ without rebuilding')\n  .option('--watch', 'Re-bundle on source changes (starts vite --watch alongside server)')\n  .option('--open', 'Open the served URL in your browser after start')\n  .option('--cors-origin <origin>', 'Restrict CORS Allow-Origin header', '*')\n  .action(async (opts: {\n    port: string;\n    bundle: boolean;\n    watch?: boolean;\n    open?: boolean;\n    corsOrigin: string;\n  }) => {\n    try {\n      const projectRoot = findProjectRoot(process.cwd());\n      if (!projectRoot) {\n        error(\n          'No web5.config.json found. Run this command from within a Web5 project.',\n        );\n        process.exit(1);\n      }\n\n      const port = parseInt(opts.port, 10);\n      if (isNaN(port) || port < 1 || port > 65535) {\n        error(`Invalid port: ${opts.port}`);\n        process.exit(1);\n      }\n\n      const distDir = path.join(projectRoot, 'dist', 'cdn');\n\n      // ── Bundle (unless --no-bundle) ─────────────────────────────────────────\n      if (opts.bundle !== false) {\n        await runBundle(projectRoot);\n      }\n\n      if (!fs.existsSync(distDir)) {\n        error(\n          `Bundle output not found at ${distDir}. Run \\`web5 bundle\\` first or remove --no-bundle.`,\n        );\n        process.exit(1);\n      }\n\n      // ── Watch mode: spawn vite --watch in background ────────────────────────\n      if (opts.watch) {\n        const viteBin = path.join(projectRoot, 'node_modules', '.bin', 'vite');\n        if (!fs.existsSync(viteBin)) {\n          error('vite not found. Run `npm install` in your project first.');\n          process.exit(1);\n        }\n        const watcher = spawn(\n          `\"${viteBin}\"`,\n          ['build', '--config', 'src/vite.cdn.config.ts', '--watch'],\n          { cwd: projectRoot, shell: true, stdio: 'inherit' },\n        );\n        watcher.on('error', (err_) => error(`Watch process error: ${err_.message}`));\n      }\n\n      // ── Start HTTP server ───────────────────────────────────────────────────\n      const server = startServer(distDir, opts.corsOrigin);\n      const url = `http://localhost:${port}`;\n\n      server.listen(port, async () => {\n        const files = fs.readdirSync(distDir);\n\n        if (isJsonMode()) {\n          console.log(JSON.stringify({ url, port, files: files.map((f) => `${url}/${f}`) }));\n        } else {\n          success(`Serving on ${url}`);\n          for (const file of files) {\n            info(`  ${url}/${file}`);\n          }\n          if (opts.watch) {\n            info('Watch mode active — rebuilds automatically on file changes.');\n          }\n          info('Press Ctrl+C to stop.');\n        }\n\n        if (opts.open) {\n          const openPkg = (await import('open')).default;\n          await openPkg(url);\n        }\n      });\n    } catch (err_) {\n      error(err_ instanceof Error ? err_.message : String(err_));\n      process.exit(1);\n    }\n  });\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/commands/storybook.js

@@ -0,0 +1,97 @@
+import { Command } from 'commander';
+import * as path from 'path';
+import * as fs from 'fs';
+import { cp, readFile, writeFile } from 'fs/promises';
+import { execSync } from 'child_process';
+import { success, error, info, warn } from '../utils/print';
+import { findProjectRoot } from '../utils/project';
+const DEFAULTS_DIR = path.join(__dirname, '../../../defaults');
+const STORYBOOK_DEPS = {
+  storybook: '^8.0.0',
+  '@storybook/react-vite': '^8.0.0',
+  '@storybook/addon-essentials': '^8.0.0'
+};
+const STORYBOOK_SCRIPTS = {
+  storybook: 'storybook dev -p 6006',
+  'build-storybook': 'storybook build'
+};
+export const storybookCommand = new Command('storybook').description('Add Storybook configuration and stories to a Web5 project').action(async () => {
+  try {
+    const projectRoot = findProjectRoot(process.cwd());
+    if (!projectRoot) {
+      error('No web5.config.json found. Run this command from within a Web5 project.');
+      process.exit(1);
+    }
+    info(`Adding Storybook to ${projectRoot}`);
+
+    // ── Copy .storybook/ config (overwrites on re-run — intentional) ──────
+    const storybookConfigSrc = path.join(DEFAULTS_DIR, '.storybook');
+    const storybookConfigDest = path.join(projectRoot, '.storybook');
+    await cp(storybookConfigSrc, storybookConfigDest, {
+      recursive: true
+    });
+
+    // ── Copy stories folder (overwrites on re-run — intentional) ──────────
+    const storiesSrc = path.join(DEFAULTS_DIR, 'src', 'components', 'storybook');
+    const storiesDest = path.join(projectRoot, 'src', 'components', 'storybook');
+    await cp(storiesSrc, storiesDest, {
+      recursive: true
+    });
+
+    // ── Update package.json (idempotent) ───────────────────────────────────
+    const pkgPath = path.join(projectRoot, 'package.json');
+    if (!fs.existsSync(pkgPath)) {
+      error('No package.json found in project root.');
+      process.exit(1);
+    }
+    const pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
+    let pkgChanged = false;
+
+    // Scripts
+    pkg.scripts ??= {};
+    for (const [name, cmd] of Object.entries(STORYBOOK_SCRIPTS)) {
+      if (!pkg.scripts[name]) {
+        pkg.scripts[name] = cmd;
+        pkgChanged = true;
+      } else {
+        warn(`Script "${name}" already exists — skipping`);
+      }
+    }
+
+    // devDependencies
+    pkg.devDependencies ??= {};
+    const missingDeps = [];
+    for (const [dep, version] of Object.entries(STORYBOOK_DEPS)) {
+      if (!pkg.devDependencies[dep]) {
+        pkg.devDependencies[dep] = version;
+        missingDeps.push(dep);
+        pkgChanged = true;
+      }
+    }
+    if (pkgChanged) {
+      await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf8');
+      info('Updated package.json');
+    } else {
+      info('package.json already up to date');
+    }
+
+    // ── Install dependencies ───────────────────────────────────────────────
+    if (missingDeps.length > 0) {
+      info(`Installing: ${missingDeps.join(', ')}`);
+    } else {
+      info('Running npm install to ensure dependencies are installed...');
+    }
+    execSync('npm install', {
+      cwd: projectRoot,
+      stdio: 'inherit'
+    });
+    success('Storybook is ready.');
+    console.log('');
+    info('Run it with:');
+    info('  npm run storybook');
+  } catch (err_) {
+    error(err_ instanceof Error ? err_.message : String(err_));
+    process.exit(1);
+  }
+});
+//# sourceMappingURL=storybook.js.map

package/dist/esm/commands/storybook.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Command","path","fs","cp","readFile","writeFile","execSync","success","error","info","warn","findProjectRoot","DEFAULTS_DIR","join","__dirname","STORYBOOK_DEPS","storybook","STORYBOOK_SCRIPTS","storybookCommand","description","action","projectRoot","process","cwd","exit","storybookConfigSrc","storybookConfigDest","recursive","storiesSrc","storiesDest","pkgPath","existsSync","pkg","JSON","parse","pkgChanged","scripts","name","cmd","Object","entries","devDependencies","missingDeps","dep","version","push","stringify","length","stdio","console","log","err_","Error","message","String"],"sources":["../../../src/commands/storybook.ts"],"sourcesContent":["import { Command } from 'commander';\nimport * as path from 'path';\nimport * as fs from 'fs';\nimport { cp, readFile, writeFile } from 'fs/promises';\nimport { execSync } from 'child_process';\nimport { success, error, info, warn } from '../utils/print';\nimport { findProjectRoot } from '../utils/project';\n\nconst DEFAULTS_DIR = path.join(__dirname, '../../../defaults');\n\nconst STORYBOOK_DEPS = {\n  storybook: '^8.0.0',\n  '@storybook/react-vite': '^8.0.0',\n  '@storybook/addon-essentials': '^8.0.0',\n};\n\nconst STORYBOOK_SCRIPTS = {\n  storybook: 'storybook dev -p 6006',\n  'build-storybook': 'storybook build',\n};\n\nexport const storybookCommand = new Command('storybook')\n  .description('Add Storybook configuration and stories to a Web5 project')\n  .action(async () => {\n    try {\n      const projectRoot = findProjectRoot(process.cwd());\n      if (!projectRoot) {\n        error(\n          'No web5.config.json found. Run this command from within a Web5 project.',\n        );\n        process.exit(1);\n      }\n\n      info(`Adding Storybook to ${projectRoot}`);\n\n      // ── Copy .storybook/ config (overwrites on re-run — intentional) ──────\n      const storybookConfigSrc = path.join(DEFAULTS_DIR, '.storybook');\n      const storybookConfigDest = path.join(projectRoot, '.storybook');\n      await cp(storybookConfigSrc, storybookConfigDest, { recursive: true });\n\n      // ── Copy stories folder (overwrites on re-run — intentional) ──────────\n      const storiesSrc = path.join(\n        DEFAULTS_DIR,\n        'src',\n        'components',\n        'storybook',\n      );\n      const storiesDest = path.join(\n        projectRoot,\n        'src',\n        'components',\n        'storybook',\n      );\n      await cp(storiesSrc, storiesDest, { recursive: true });\n\n      // ── Update package.json (idempotent) ───────────────────────────────────\n      const pkgPath = path.join(projectRoot, 'package.json');\n      if (!fs.existsSync(pkgPath)) {\n        error('No package.json found in project root.');\n        process.exit(1);\n      }\n\n      const pkg = JSON.parse(await readFile(pkgPath, 'utf8')) as {\n        scripts?: Record<string, string>;\n        devDependencies?: Record<string, string>;\n      };\n\n      let pkgChanged = false;\n\n      // Scripts\n      pkg.scripts ??= {};\n      for (const [name, cmd] of Object.entries(STORYBOOK_SCRIPTS)) {\n        if (!pkg.scripts[name]) {\n          pkg.scripts[name] = cmd;\n          pkgChanged = true;\n        } else {\n          warn(`Script \"${name}\" already exists — skipping`);\n        }\n      }\n\n      // devDependencies\n      pkg.devDependencies ??= {};\n      const missingDeps: string[] = [];\n      for (const [dep, version] of Object.entries(STORYBOOK_DEPS)) {\n        if (!pkg.devDependencies[dep]) {\n          pkg.devDependencies[dep] = version;\n          missingDeps.push(dep);\n          pkgChanged = true;\n        }\n      }\n\n      if (pkgChanged) {\n        await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\\n', 'utf8');\n        info('Updated package.json');\n      } else {\n        info('package.json already up to date');\n      }\n\n      // ── Install dependencies ───────────────────────────────────────────────\n      if (missingDeps.length > 0) {\n        info(`Installing: ${missingDeps.join(', ')}`);\n      } else {\n        info('Running npm install to ensure dependencies are installed...');\n      }\n\n      execSync('npm install', { cwd: projectRoot, stdio: 'inherit' });\n\n      success('Storybook is ready.');\n      console.log('');\n      info('Run it with:');\n      info('  npm run storybook');\n    } catch (err_) {\n      error(err_ instanceof Error ? err_.message : String(err_));\n      process.exit(1);\n    }\n  });\n"],"mappings":"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","ignoreList":[]}

package/dist/esm/commands/validate.js

@@ -1,7 +1,7 @@
 import { Command } from 'commander';
 import Ajv from 'ajv/dist/2020';
 import { load as yamlLoad } from 'js-yaml';
-import { readFileSync, existsSync, readdirSync } from 'fs';
+import { readFileSync, existsSync, readdirSync, watch as fsWatch } from 'fs';
 import * as path from 'path';
 import chalk from 'chalk';
 import { error, info } from '../utils/print';
@@ -666,27 +666,21 @@ function buildActionsDomain(root) {
   };
 }
 
-// ── Command ───────────────────────────────────────────────────────────────────
+// ── Rendering ─────────────────────────────────────────────────────────────────
 
-export const validateCommand = new Command('validate').description('Validate project config files against their schemas').action(() => {
-  const root = findProjectRoot(process.cwd());
-  if (!root) {
-    error('No web5.config.json found — run this command from inside a Web5 project');
-    process.exit(1);
-  }
-  info(`Project root: ${root}`);
-  console.log('');
-  const domains = [buildAiInstructionsDomain(root), buildCmsSchemaDomain(root), buildActionsDomain(root)];
-  let hasErrors = false;
-  for (const domain of domains) {
+function printDomain(domain, results, verbose) {
+  const failed = results.filter(r => !r.result.ok);
+  const domainOk = failed.length === 0;
+  if (verbose) {
     console.log(domain.name);
-    for (const check of domain.checks) {
-      const result = check.run();
+    for (const {
+      label,
+      result
+    } of results) {
       if (result.ok) {
-        console.log(chalk.green(`  \u2714  ${check.label}`));
+        console.log(chalk.green(`  \u2714  ${label}`));
       } else {
-        hasErrors = true;
-        process.stderr.write(chalk.red(`  \u2716  ${check.label}\n`));
+        process.stderr.write(chalk.red(`  \u2716  ${label}\n`));
         for (const e_ of result.errors) {
           process.stderr.write(`       ${e_.message}\n`);
           if (e_.fix) {
@@ -696,9 +690,265 @@ export const validateCommand = new Command('validate').description('Validate pro
       }
     }
     console.log('');
+    return domainOk;
+  }
+
+  // Slim mode
+  if (domainOk) {
+    console.log(chalk.green(`\u2714  ${domain.name} — valid`));
+    return true;
+  }
+  console.log(domain.name);
+  for (const {
+    label,
+    result
+  } of failed) {
+    process.stderr.write(chalk.red(`  \u2716  ${label}\n`));
+    for (const e_ of result.errors) {
+      process.stderr.write(`       ${e_.message}\n`);
+      if (e_.fix) {
+        process.stderr.write(`       Fix: ${e_.fix}\n`);
+      }
+    }
+  }
+  console.log('');
+  return false;
+}
+
+// ── JSON output ───────────────────────────────────────────────────────────────
+
+function collectDomainJson(domain, results) {
+  return {
+    name: domain.name,
+    ok: results.every(r => r.result.ok),
+    checks: results.map(_ref => {
+      let {
+        label,
+        result
+      } = _ref;
+      return {
+        label,
+        ok: result.ok,
+        errors: result.errors
+      };
+    })
+  };
+}
+
+// ── Build scripts domain ──────────────────────────────────────────────────────
+
+function buildScriptsDomain(root) {
+  const pkgPath = path.join(root, 'package.json');
+  let pkg = {};
+  let fileExists = false;
+  return {
+    name: 'Build Scripts',
+    checks: [{
+      label: 'package.json — file exists',
+      run() {
+        fileExists = existsSync(pkgPath);
+        if (!fileExists) {
+          return {
+            ok: false,
+            errors: [{
+              message: `File not found: ${pkgPath}`,
+              fix: `Create a 'package.json' at the root of your project.`
+            }]
+          };
+        }
+        try {
+          pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        } catch (e) {
+          fileExists = false;
+          return {
+            ok: false,
+            errors: [{
+              message: `Failed to parse package.json: ${e instanceof Error ? e.message : String(e)}`,
+              fix: `Fix the JSON syntax in your package.json.`
+            }]
+          };
+        }
+        return {
+          ok: true,
+          errors: []
+        };
+      }
+    }, {
+      label: 'package.json — bundle script defined',
+      run() {
+        var _pkg$scripts;
+        if (!fileExists) {
+          return {
+            ok: false,
+            errors: [{
+              message: 'skipped — package.json not readable'
+            }]
+          };
+        }
+        if (typeof ((_pkg$scripts = pkg.scripts) == null ? void 0 : _pkg$scripts.bundle) === 'string' && pkg.scripts.bundle.length > 0) {
+          return {
+            ok: true,
+            errors: []
+          };
+        }
+        return {
+          ok: false,
+          errors: [{
+            message: `Missing 'bundle' script in package.json`,
+            fix: `Add a 'bundle' script to your package.json scripts, e.g.:\n  "bundle": "vite build --config src/vite.cdn.config.ts"`
+          }]
+        };
+      }
+    }, {
+      label: 'package.json — build script defined',
+      run() {
+        var _pkg$scripts2;
+        if (!fileExists) {
+          return {
+            ok: false,
+            errors: [{
+              message: 'skipped — package.json not readable'
+            }]
+          };
+        }
+        if (typeof ((_pkg$scripts2 = pkg.scripts) == null ? void 0 : _pkg$scripts2.build) === 'string' && pkg.scripts.build.length > 0) {
+          return {
+            ok: true,
+            errors: []
+          };
+        }
+        return {
+          ok: false,
+          errors: [{
+            message: `Missing 'build' script in package.json`,
+            fix: `Add a 'build' script to your package.json scripts, e.g.:\n  "build": "tsc"`
+          }]
+        };
+      }
+    }]
+  };
+}
+
+// ── Domain selection ──────────────────────────────────────────────────────────
+
+function selectDomains(root, filter) {
+  const all = [buildAiInstructionsDomain(root), buildCmsSchemaDomain(root), buildActionsDomain(root), buildScriptsDomain(root)];
+  if (!filter) return all;
+  const map = {
+    ai: 'AI Instructions',
+    cms: 'CMS Schema',
+    scripts: 'Build Scripts',
+    actions: 'Actions'
+  };
+  return all.filter(d => d.name === map[filter]);
+}
+
+// ── Core runner ───────────────────────────────────────────────────────────────
+
+function runDomains(domains, verbose, format) {
+  let hasErrors = false;
+  const jsonResults = [];
+  for (const domain of domains) {
+    const results = domain.checks.map(check => ({
+      label: check.label,
+      result: check.run()
+    }));
+    let domainOk;
+    if (format === 'json') {
+      const jr = collectDomainJson(domain, results);
+      jsonResults.push(jr);
+      domainOk = jr.ok;
+    } else {
+      domainOk = printDomain(domain, results, verbose);
+    }
+    if (!domainOk) hasErrors = true;
+  }
+  return {
+    ok: !hasErrors,
+    jsonResults
+  };
+}
+
+// ── Programmatic API ─────────────────────────────────────────────────────────
+
+/**
+ * Runs all validation domains against the given project root.
+ * Prints results in slim mode and returns true if everything passes.
+ */
+export function runValidation(root) {
+  const domains = selectDomains(root);
+  const {
+    ok
+  } = runDomains(domains, false, 'text');
+  return ok;
+}
+
+// ── Watch mode ────────────────────────────────────────────────────────────────
+
+function startWatch(root, run) {
+  const watchDirs = [path.join(root, 'src', 'configuration'), path.join(root, 'src', 'actions')].filter(d => existsSync(d));
+  if (watchDirs.length === 0) {
+    error('No directories to watch found.');
+    return;
   }
-  if (hasErrors) {
+  let debounce = null;
+  const trigger = () => {
+    if (debounce) clearTimeout(debounce);
+    debounce = setTimeout(() => {
+      console.clear();
+      info(`[${new Date().toLocaleTimeString()}] Re-validating...`);
+      console.log('');
+      run();
+    }, 200);
+  };
+  for (const dir of watchDirs) {
+    fsWatch(dir, {
+      recursive: true
+    }, trigger);
+  }
+  info(`Watching for changes in ${watchDirs.map(d => path.relative(root, d)).join(', ')}...`);
+  info('Press Ctrl+C to stop.');
+  console.log('');
+}
+
+// ── Command ───────────────────────────────────────────────────────────────────
+
+export const validateCommand = new Command('validate').description('Validate project config files against their schemas').option('--verbose', 'Show all checks, including passing ones').option('--domain <domain>', 'Only validate one domain: ai, cms, actions, or scripts').option('--format <format>', 'Output format: text (default) or json', 'text').option('--watch', 'Re-validate on file changes (TTY only)').option('--strict', 'Exit with error even on warnings').option('--project <path>', 'Explicit project root (overrides cwd auto-detection)').action(opts => {
+  const verbose = Boolean(opts.verbose);
+  const format = opts.format ?? 'text';
+  const domainFilter = opts.domain;
+  const root = opts.project ? path.resolve(opts.project) : findProjectRoot(process.cwd());
+  if (!root) {
+    error('No web5.config.json found — run this command from inside a Web5 project');
     process.exit(1);
   }
+  if (format === 'text') {
+    info(`Project root: ${root}`);
+    console.log('');
+  }
+  const run = () => {
+    const domains = selectDomains(root, domainFilter);
+    const {
+      ok,
+      jsonResults
+    } = runDomains(domains, verbose, format);
+    if (format === 'json') {
+      console.log(JSON.stringify({
+        ok,
+        domains: jsonResults
+      }, null, 2));
+    }
+    if (!ok && !opts.watch) {
+      process.exit(1);
+    }
+  };
+  run();
+  if (opts.watch) {
+    if (!process.stdout.isTTY) {
+      error('--watch requires a TTY (interactive terminal).');
+      process.exit(1);
+    }
+    startWatch(root, run);
+  }
 });
 //# sourceMappingURL=validate.js.map