@birdapi/velinstyle 1.2.1 → 1.3.0

package/cli/cli-manifest.json

@@ -1,161 +1,441 @@
-{
-  "version": "1.2.1",
-  "commands": [
-    {
-      "name": "init",
-      "summary": "Create velinstyle.config.js, optional vendor copy, and starter HTML with reveal/sprite defaults",
-      "flags": [],
-      "example": "velinstyle init"
-    },
-    {
-      "name": "build",
-      "summary": "Build custom CSS with selected layers from config",
-      "flags": ["--output", "-o", "--minify", "--preset"],
-      "example": "velinstyle build --preset lite -o ./lite.css"
-    },
-    {
-      "name": "themes",
-      "summary": "List available built-in themes",
-      "flags": [],
-      "example": "velinstyle themes"
-    },
-    {
-      "name": "add",
-      "summary": "Add a single component CSS file to your project",
-      "flags": [],
-      "example": "velinstyle add button"
-    },
-    {
-      "name": "icons",
-      "summary": "Manage icon providers (list, add, remove, build)",
-      "flags": ["--icons", "--variant"],
-      "subcommands": ["list", "add", "remove", "build"],
-      "example": "velinstyle icons add lucide --icons menu,search"
-    },
-    {
-      "name": "scan",
-      "summary": "Security, accessibility, CSS, and PII scanner (directory or single file)",
-      "flags": ["--format", "--severity", "--only", "--fix", "--fix-dry-run", "--fix-lang"],
-      "example": "velinstyle scan index.html"
-    },
-    {
-      "name": "prefix",
-      "summary": "Add missing velin- prefix to classes (dry-run; use --write)",
-      "flags": ["--write", "--map", "--bootstrap-display"],
-      "example": "velinstyle prefix src/ --write"
-    },
-    {
-      "name": "blueprint",
-      "summary": "Print HTML blueprint snippets; --strict fails on classes missing from CSS",
-      "flags": ["--output", "-o", "--strict"],
-      "subcommands": ["list"],
-      "example": "velinstyle blueprint modal -o snippet.html --strict"
-    },
-    {
-      "name": "create",
-      "summary": "Scaffold a runnable project: landing | dashboard | docs | auth",
-      "flags": ["--theme", "--no-copy"],
-      "subcommands": ["landing", "dashboard", "docs", "auth"],
-      "example": "velinstyle create landing ./my-site --theme earth"
-    },
-    {
-      "name": "serve",
-      "summary": "Serve a directory over HTTP (default port 4173)",
-      "flags": ["--port"],
-      "example": "velinstyle serve . --port 4173"
-    },
-    {
-      "name": "doctor",
-      "summary": "Check dist assets, themes, config, icons, and Windows ESM import hints",
-      "flags": [],
-      "example": "velinstyle doctor"
-    },
-    {
-      "name": "check",
-      "summary": "Aggregate gate: doctor + blueprint --strict + scan + review (alias: validate)",
-      "flags": ["--json", "--sarif", "--profile"],
-      "example": "velinstyle check . --profile marketing"
-    },
-    {
-      "name": "scaffold",
-      "summary": "Plan-first page HTML or recipe fragment from natural language",
-      "flags": ["--output", "-o", "--json"],
-      "subcommands": ["list-intents"],
-      "example": "velinstyle scaffold \"Steuerberater Landingpage mit Kontakt\""
-    },
-    {
-      "name": "plan",
-      "summary": "Emit page plan JSON from a prompt (no HTML)",
-      "flags": ["--output", "-o", "--json"],
-      "example": "velinstyle plan \"SaaS landing with pricing\""
-    },
-    {
-      "name": "review",
-      "summary": "Design / a11y / SEO / performance / conversion review gate",
-      "flags": ["--json", "--prompt", "--profile"],
-      "example": "velinstyle review out.html --profile marketing"
-    },
-    {
-      "name": "wc",
-      "summary": "Inspect Web Component APIs from source",
-      "flags": [],
-      "subcommands": ["api"],
-      "example": "velinstyle wc api velin-toast"
-    },
-    {
-      "name": "layout",
-      "summary": "Responsive layout audit (flex, grid, viewport)",
-      "flags": ["--json", "--write", "--dry-run"],
-      "subcommands": ["audit", "suggest", "fix"],
-      "example": "velinstyle layout suggest index.html"
-    },
-    {
-      "name": "perf",
-      "summary": "Performance audit for images and scripts (directory or .html file)",
-      "flags": ["--json", "--write", "--dry-run"],
-      "subcommands": ["audit", "suggest", "fix"],
-      "example": "velinstyle perf audit index.html"
-    },
-    {
-      "name": "tokens",
-      "summary": "Build or validate design tokens JSON",
-      "flags": ["--input", "--output", "-o"],
-      "subcommands": ["build", "validate"],
-      "example": "velinstyle tokens validate --input examples/tokens.full.json"
-    },
-    {
-      "name": "docs",
-      "summary": "Generate developer reference Markdown (alias: documentation)",
-      "flags": ["--scope", "--out"],
-      "subcommands": ["generate"],
-      "example": "velinstyle docs generate --scope all"
-    },
-    {
-      "name": "meta",
-      "summary": "Build Velin-Meta agent bundle; page --write merges curated goals/intent",
-      "flags": ["--out", "--llms-out", "--base-url", "--no-llms", "--write"],
-      "subcommands": ["page"],
-      "example": "velinstyle meta page index.html --write"
-    },
-    {
-      "name": "search",
-      "summary": "Build JSON search index for VelinSearch",
-      "flags": ["--out", "--extra-html"],
-      "subcommands": ["index"],
-      "example": "velinstyle search index --out dist/search-index.json"
-    },
-    {
-      "name": "skills",
-      "summary": "Registry-first AI skill catalog and install runner",
-      "flags": ["--capability", "--status", "--priority", "--origin", "--category", "--target", "--no-deps", "--json", "--human"],
-      "subcommands": ["list", "show", "install", "run", "validate", "doctor", "packs", "bundles", "templates", "projects", "graphs"],
-      "example": "velinstyle skills show scaffold.landing --human"
-    },
-    {
-      "name": "workflow",
-      "summary": "Resolve workflow graph or project workflow steps",
-      "flags": ["--json", "--dry-run", "--step"],
-      "example": "velinstyle workflow landingpage --json"
-    }
-  ]
-}
+{
+  "version": "1.3.0",
+  "commands": [
+    {
+      "name": "init",
+      "summary": "Create velinstyle.config.js, optional vendor copy, and starter HTML with reveal/sprite defaults",
+      "flags": [],
+      "example": "velinstyle init"
+    },
+    {
+      "name": "build",
+      "summary": "Build custom CSS with selected layers from config, or production output with --production",
+      "flags": [
+        "--output",
+        "-o",
+        "--out",
+        "--minify",
+        "--preset",
+        "--production",
+        "--explain",
+        "--watch",
+        "--report",
+        "--safelist"
+      ],
+      "example": "velinstyle build --production --explain -o ./dist/velin-production"
+    },
+    {
+      "name": "production",
+      "summary": "Content-aware production builder (CSS/JS/themes/icons/fonts/motion + report)",
+      "flags": [
+        "--out",
+        "-o",
+        "--explain",
+        "--watch",
+        "--report",
+        "--safelist",
+        "--no-js",
+        "--no-icons",
+        "--no-themes",
+        "--no-motion",
+        "--no-minify"
+      ],
+      "example": "velinstyle production . --explain --report ./report.json"
+    },
+    {
+      "name": "themes",
+      "summary": "List available built-in themes",
+      "flags": [],
+      "example": "velinstyle themes"
+    },
+    {
+      "name": "add",
+      "summary": "Add a single component CSS file to your project",
+      "flags": [],
+      "example": "velinstyle add button"
+    },
+    {
+      "name": "icons",
+      "summary": "Manage icon providers (list, add, remove, build)",
+      "flags": [
+        "--icons",
+        "--variant"
+      ],
+      "example": "velinstyle icons add lucide --icons menu,search",
+      "subcommands": [
+        "list",
+        "add",
+        "remove",
+        "build"
+      ]
+    },
+    {
+      "name": "scan",
+      "summary": "Security, accessibility, CSS, and PII scanner (directory or single file)",
+      "flags": [
+        "--format",
+        "--severity",
+        "--only",
+        "--fix",
+        "--fix-dry-run",
+        "--fix-lang"
+      ],
+      "example": "velinstyle scan index.html"
+    },
+    {
+      "name": "prefix",
+      "summary": "Add missing velin- prefix to classes (dry-run; use --write)",
+      "flags": [
+        "--write",
+        "--map",
+        "--bootstrap-display"
+      ],
+      "example": "velinstyle prefix src/ --write"
+    },
+    {
+      "name": "blueprint",
+      "summary": "Print HTML blueprint snippets; --strict fails on classes missing from CSS",
+      "flags": [
+        "--output",
+        "-o",
+        "--strict"
+      ],
+      "example": "velinstyle blueprint modal -o snippet.html --strict",
+      "subcommands": [
+        "list"
+      ]
+    },
+    {
+      "name": "create",
+      "summary": "Scaffold a runnable project: landing | dashboard | docs | auth",
+      "flags": [
+        "--theme",
+        "--no-copy"
+      ],
+      "example": "velinstyle create landing ./my-site --theme earth",
+      "subcommands": [
+        "landing",
+        "dashboard",
+        "docs",
+        "auth"
+      ]
+    },
+    {
+      "name": "serve",
+      "summary": "Serve a directory over HTTP (default port 4173)",
+      "flags": [
+        "--port"
+      ],
+      "example": "velinstyle serve . --port 4173"
+    },
+    {
+      "name": "doctor",
+      "summary": "Check dist assets, themes, config, icons, and Windows ESM import hints",
+      "flags": [],
+      "example": "velinstyle doctor"
+    },
+    {
+      "name": "check",
+      "summary": "Aggregate gate: doctor + blueprint --strict + scan + review (alias: validate)",
+      "flags": [
+        "--json",
+        "--sarif",
+        "--profile"
+      ],
+      "example": "velinstyle check . --profile marketing"
+    },
+    {
+      "name": "scaffold",
+      "summary": "Plan-first page HTML, recipe fragment, or Atelier Library compose (--atelier, beta)",
+      "flags": [
+        "--output",
+        "-o",
+        "--json",
+        "--atelier",
+        "--from",
+        "--base-url"
+      ],
+      "example": "velinstyle scaffold --atelier 04,07 -o compose.html --from ./atelier/library",
+      "subcommands": [
+        "list-intents"
+      ]
+    },
+    {
+      "name": "plan",
+      "summary": "Emit page plan JSON from a prompt or --atelier Library ids (beta)",
+      "flags": [
+        "--output",
+        "-o",
+        "--json",
+        "--atelier"
+      ],
+      "example": "velinstyle plan --atelier 04,07"
+    },
+    {
+      "name": "atelier",
+      "summary": "Pull curated Atelier Library showcase by number/id; blade/vue/react = wrappers only",
+      "flags": [
+        "--output",
+        "-o",
+        "--format",
+        "--from",
+        "--base-url",
+        "--rewrite-vendor"
+      ],
+      "example": "velinstyle atelier 36 -o ./velin-atelier/36-calendar --format html",
+      "subcommands": [
+        "list"
+      ]
+    },
+    {
+      "name": "review",
+      "summary": "Design / a11y / SEO / performance / conversion review gate",
+      "flags": [
+        "--json",
+        "--prompt",
+        "--profile"
+      ],
+      "example": "velinstyle review out.html --profile marketing"
+    },
+    {
+      "name": "wc",
+      "summary": "Inspect Web Component APIs from source",
+      "flags": [],
+      "example": "velinstyle wc api velin-toast",
+      "subcommands": [
+        "api"
+      ]
+    },
+    {
+      "name": "layout",
+      "summary": "Responsive layout audit (flex, grid, viewport)",
+      "flags": [
+        "--json",
+        "--write",
+        "--dry-run"
+      ],
+      "example": "velinstyle layout suggest index.html",
+      "subcommands": [
+        "audit",
+        "suggest",
+        "fix"
+      ]
+    },
+    {
+      "name": "perf",
+      "summary": "Performance audit for images and scripts (directory or .html file)",
+      "flags": [
+        "--json",
+        "--write",
+        "--dry-run"
+      ],
+      "example": "velinstyle perf audit index.html",
+      "subcommands": [
+        "audit",
+        "suggest",
+        "fix"
+      ]
+    },
+    {
+      "name": "tokens",
+      "summary": "Build or validate design tokens JSON",
+      "flags": [
+        "--input",
+        "--output",
+        "-o"
+      ],
+      "example": "velinstyle tokens validate --input examples/tokens.full.json",
+      "subcommands": [
+        "build",
+        "validate"
+      ]
+    },
+    {
+      "name": "docs",
+      "summary": "Generate developer reference Markdown (alias: documentation)",
+      "flags": [
+        "--scope",
+        "--out"
+      ],
+      "example": "velinstyle docs generate --scope all",
+      "subcommands": [
+        "generate"
+      ]
+    },
+    {
+      "name": "meta",
+      "summary": "Build Velin-Meta agent bundle; page --write merges curated goals/intent",
+      "flags": [
+        "--out",
+        "--llms-out",
+        "--base-url",
+        "--no-llms",
+        "--write"
+      ],
+      "example": "velinstyle meta page index.html --write",
+      "subcommands": [
+        "page"
+      ]
+    },
+    {
+      "name": "search",
+      "summary": "Build JSON search index for VelinSearch",
+      "flags": [
+        "--out",
+        "--extra-html"
+      ],
+      "example": "velinstyle search index --out dist/search-index.json",
+      "subcommands": [
+        "index"
+      ]
+    },
+    {
+      "name": "skills",
+      "summary": "Registry-first AI skill catalog and install runner",
+      "flags": [
+        "--capability",
+        "--status",
+        "--priority",
+        "--origin",
+        "--category",
+        "--target",
+        "--no-deps",
+        "--json",
+        "--human"
+      ],
+      "example": "velinstyle skills show scaffold.landing --human",
+      "subcommands": [
+        "list",
+        "show",
+        "install",
+        "run",
+        "validate",
+        "doctor",
+        "packs",
+        "bundles",
+        "templates",
+        "projects",
+        "graphs"
+      ]
+    },
+    {
+      "name": "workflow",
+      "summary": "Resolve workflow graph or project workflow steps",
+      "flags": [
+        "--json",
+        "--dry-run",
+        "--step"
+      ],
+      "example": "velinstyle workflow landingpage --json"
+    },
+    {
+      "name": "dashboard",
+      "summary": "Aggregate Production, Review, Accessibility, Transparency, Performance, Security",
+      "flags": [],
+      "example": "velinstyle dashboard"
+    },
+    {
+      "name": "replay",
+      "summary": "Replay a Velin Experience record.json through the same renderer",
+      "flags": [],
+      "example": "velinstyle replay record.json"
+    },
+    {
+      "name": "transparency",
+      "summary": "Transparency Framework doctor, validate, report, export, migrate",
+      "flags": [
+        "--policy",
+        "--json"
+      ],
+      "example": "velinstyle transparency doctor .",
+      "subcommands": [
+        "doctor",
+        "validate",
+        "report",
+        "export",
+        "migrate"
+      ]
+    },
+    {
+      "name": "motion",
+      "summary": "Velin Motion — page registry + clip pipeline (create, atelier, AI providers)",
+      "flags": [
+        "--json",
+        "--write",
+        "--out",
+        "--output",
+        "-o",
+        "--policy",
+        "--preset",
+        "--ai",
+        "--yes",
+        "-y",
+        "--provider",
+        "--model",
+        "--quality",
+        "--duration",
+        "--style",
+        "--prompt",
+        "--count",
+        "--dry-run",
+        "--clips"
+      ],
+      "example": "velinstyle motion create atelier.webp",
+      "subcommands": [
+        "list",
+        "presets",
+        "create",
+        "atelier",
+        "transition",
+        "sequence",
+        "export",
+        "usage",
+        "providers",
+        "setup",
+        "zoom",
+        "pan",
+        "rotate",
+        "particles",
+        "intro",
+        "outro",
+        "doctor",
+        "scan",
+        "policy",
+        "demo",
+        "analyze",
+        "review",
+        "report",
+        "optimize",
+        "blueprint"
+      ]
+    },
+    {
+      "name": "security",
+      "summary": "Velin Security Suite — Security Engine: doctor, scan, audit, publish, ci, deps, secrets, report",
+      "flags": [
+        "--json",
+        "--strict",
+        "--repo",
+        "--consumer",
+        "--ci",
+        "--publish",
+        "--deps",
+        "--secrets",
+        "--out",
+        "--output",
+        "-o"
+      ],
+      "example": "velinstyle security doctor .",
+      "subcommands": [
+        "doctor",
+        "scan",
+        "audit",
+        "publish",
+        "ci",
+        "deps",
+        "secrets",
+        "report"
+      ]
+    }
+  ]
+}

package/cli/docgen/extract-cli.js

@@ -9,7 +9,8 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 export const REGISTERED_COMMANDS = [
   'init', 'build', 'themes', 'add', 'icons', 'blueprint', 'create', 'serve', 'doctor', 'check', 'tokens',
   'scan', 'prefix', 'scaffold', 'plan', 'review', 'layout', 'perf', 'docs', 'meta',
-  'search', 'skills', 'workflow', 'wc',
+  'search', 'skills', 'workflow', 'wc', 'production', 'atelier', 'transparency',
+  'dashboard', 'replay', 'motion', 'security',
 ];
 
 export function loadCliManifest() {

package/cli/docs-generate.js

@@ -92,6 +92,15 @@ export async function generateDocs(options = {}) {
 
   if (run('cli')) {
     mkdirSync(join(outDir, 'cli'), { recursive: true });
+    // Manifest bridge: Experience Registry → cli-manifest.json (single source of truth)
+    try {
+      const { toCliManifest } = await import('../packages/velinstyle-cli-registry/src/index.js');
+      const pkg = JSON.parse(readFileSync(join(PKG_ROOT, 'package.json'), 'utf-8'));
+      const bridged = toCliManifest(pkg.version);
+      writeFile(join(PKG_ROOT, 'cli', 'cli-manifest.json'), `${JSON.stringify(bridged, null, 2)}\n`);
+    } catch (err) {
+      console.warn(`Registry → manifest bridge skipped: ${err.message}`);
+    }
     const manifest = loadCliManifest();
     const errors = validateManifest(manifest);
     if (errors.length) {