@getvitops/cli 0.9.0 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,231 @@
 # @getvitops/cli
 
+## 1.0.0
+
+### Major Changes
+
+- bb92a14: **The colour system is rebuilt on a target-prefixed grammar and a shared lightness ladder.**
+  This is a breaking change to every colour token and utility class.
+
+  ## Why
+
+  Two axes shared one class namespace — functional _planes_ (`--<role>-bg-muted`) and
+  appearance-relative _stops_ (`--color-<role>-muted`) — arbitrated by a "plane wins" rule. The
+  result was not a scale. On the shipped palette, light mode:
+
+  | class                              | resolved to  | step                                          |
+  | ---------------------------------- | ------------ | --------------------------------------------- |
+  | `bg-ui-accent-x-muted`             | stop         | 100                                           |
+  | `bg-ui-accent-muted`               | plane        | 100 — identical, so `x-muted` was a dead rung |
+  | `bg-ui-accent`                     | plane        | 50 — _lighter_ than both its "muted" rungs    |
+  | `border-ui-accent-muted` / `-bold` | stop / plane | 300 / 300 — identical                         |
+  | `text-ui-accent-bold`              | stop         | 700 — _lighter_ than `text-…-muted` (800)     |
+
+  Every family was non-monotonic, two had duplicate rungs, and `--color-<role>-muted` was
+  unreachable through any `bg-` class.
+
+  ## The new grammar
+
+  ```
+  --color-<target>-<role>[-<variant>]        target ∈ bg | text | icon | border
+  ```
+
+  The target is **inside** the name, so `bg-danger-muted` and `text-danger-muted` are different
+  tokens and there is nothing left to arbitrate. **The class name is the token name minus
+  `--color-`** — one vocabulary instead of two.
+
+  Variants are ordinal (`xx-muted` < `x-muted` < `muted` < bare < `bold` < `x-bold`) and the
+  tables are sparse: only cells that hold their contrast target exist.
+
+  ## Role kinds
+
+  `colors.roles` values may now be `{ hue, kind }` as well as a bare hue string:
+
+  ```jsonc
+  "roles": {
+    "danger":  "rust",                             // shorthand => chromatic
+    "surface": { "hue": "navy", "kind": "surface" }
+  }
+  ```
+
+  - **`surface`** — a page/panel colour: `bg-<role>` is the card, `bg-<role>-muted` the page
+    behind it, `bg-<role>-x-muted` a well, `bg-<role>-bold` the inverse surface. Full text scale.
+  - **`chromatic`** (default) — a signal colour: tints (`bg-<role>-x-muted`/`-muted`) and solids
+    (`bg-<role>-solid[-bold|-x-bold]`), with **no bare `bg-<role>`** — say how loud you mean.
+    `text-on-<role>` is the guaranteed foreground for the solid family.
+
+  ## Palette generation
+
+  Every ramp now sits on one **fixed lightness ladder** (50 → L 0.98 … 950 → L 0.21); only chroma
+  and hue vary. That is what makes a step mean the same lightness in every hue. Previously each
+  seed transposed the curve, so relative luminance at step 300 ranged from 0.253 to 0.384 across
+  the shipped palette — the same variant read differently depending on the role.
+
+  Authored colours are still reproduced **exactly**. A `seed`, an `anchors` entry or a `tones`
+  value is pinned verbatim at its nearest step; every other step takes the ladder. Snapping brand
+  colours to the ladder was measured and rejected: 11 of 18 real brand hexes moved beyond a
+  just-noticeable difference (worst ΔE-OK 0.050 — Facebook's `#1877F2` → `#0067e1`) and six left
+  sRGB gamut. Deviation is now bounded and local to pinned steps, and warns past ~0.03 L.
+
+  Two tones that claim the same step now **error** instead of one silently overwriting the other;
+  the record form (`tones: { "600": "…", "700": "…" }`) is how you resolve it.
+
+  ## New
+  - **`icon-<role>`** — a non-text tier, so a glyph may run more vivid than text. `icon` is now a
+    default utility family alongside `bg`/`text`/`border`.
+  - **`--color-border-focus`** — the focus-ring tone, taken from `ui-primary`'s solid.
+  - **Contrast is enforced at build time**, not only in tests: text ≥ APCA Lc 75 on its primary
+    background, ≥ 60 on secondary planes, icons and surface boundaries ≥ 45, both appearances.
+    A violation now fails `generate`. Chromatic text is checked against the _surface_ planes it
+    actually sits on, not only its own tints. `text-<role>-x-muted` (placeholder) and `-xx-muted`
+    (disabled) are explicitly exempt; nothing else is.
+
+  ## Migrating
+
+  Rename `--<role>-<suffix>` → `--color-<target>-<role>[-<variant>]`, and the same for classes:
+
+  | before                                  | after                                                            |
+  | --------------------------------------- | ---------------------------------------------------------------- |
+  | `--<role>-bg` / `bg-<role>` (chromatic) | `--color-bg-<role>-x-muted` / `bg-<role>-x-muted`                |
+  | `--<role>-bg-muted`                     | `--color-bg-<role>-muted`                                        |
+  | `--<role>-solid` / `-solid-bold`        | `--color-bg-<role>-solid` / `-solid-bold`                        |
+  | `--<role>-on-solid` / `text-on-<role>`  | `--color-text-on-<role>` (class unchanged)                       |
+  | `--<role>-text` / `-text-muted`         | `--color-text-<role>` / `-muted`                                 |
+  | `--<role>-border` / `-border-bold`      | `--color-border-<role>` / `-bold`                                |
+  | `--color-<role>-muted` (stop)           | judge by use: `--color-bg-<role>-muted` or `--color-text-<role>` |
+
+  **`surface` background names rotate**, value-preserving: what was `--surface-bg` (the page) is
+  now `--color-bg-surface-muted`; what was `--surface-bg-bold` (raised) is now
+  `--color-bg-surface`. Elevation is expressed by which token you reach for — page `bg-muted`,
+  card `bg` — rather than a raised/sunken pair, which is what lets a future surfaces axis flatten
+  it without touching markup.
+
+  `vitops lint` reports role classes that no longer resolve, and now derives its suggestions from
+  what the generator actually emits rather than a hand-maintained list.
+
+### Minor Changes
+
+- bb92a14: Add a fourth output format, `design`, that emits `DESIGN.md` — the agent-facing brief in
+  [google-labs-code/design.md](https://github.com/google-labs-code/design.md) format.
+
+  ```sh
+  vitops generate --format design --out .     # DESIGN.md, and nothing else
+  vitops generate --format css,design         # compose it with a stylesheet
+  ```
+
+  The file is YAML front matter carrying the tokens (`colors`, `typography`, `rounded`,
+  `spacing`, `components`, cross-referenced with `{group.token}`) followed by a prose body
+  carrying the rationale — colour model, fluid scales, layout vocabulary, elevation, shape
+  cascade, component tiers, do's and don'ts. Every section is rendered from your config, so
+  it cannot describe a system the other formats don't build. Point a coding agent, a Figma
+  import, or a designer at this one file when they don't have the toolchain; `vitops docs`
+  remains the richer reference for those who do.
+
+  It is emitted with `--out .` in mind: DESIGN.md conventionally lives at a repo root beside
+  `AGENTS.md`, not in a build directory.
+
+  Three things the spec cannot express, handled the same way every time and explained in the
+  emitted prose so the file is self-describing:
+  - **Fluid `clamp()` sizes** → the maximum (desktop) value, since a spec `Dimension` is a
+    bare number plus px/em/rem.
+  - **Dark mode** → light values only, with the automatic functional flip explained. Role
+    tokens are emitted as `{colors.<hue>-<step>}` references into the raw ramps rather than
+    flattened hexes, so the role → ramp lineage survives the export — flattening them is
+    exactly what breaks dark mode downstream.
+  - **A `50%` radius** → dropped from `rounded` (it is not a `Dimension`) and named in the
+    Shapes prose instead, so nothing is silently lost.
+
+  **New:** an optional `meta` key in `design-system.json` (`{ name, description }`) supplies
+  the brand name and the Overview paragraph. It affects no other format.
+
+  **New:** `StylesheetFormat` (`Exclude<Format, 'design'>`), exported from
+  `@getvitops/generator`. `@getvitops/astro`'s `css.format` now takes that narrower type —
+  `design` produces no stylesheet to inject, so passing it there is a type error rather than
+  a missing-file failure at build time. `vitops lint --format` is likewise restricted to the
+  three CSS formats. No change for anyone already passing `tailwind`, `css` or `bricks`.
+
+- bb92a14: Generate legal documents from your site config
+
+  `vitops legal` renders a privacy policy, terms of service and cookie notice from a site
+  config, in markdown, HTML or EmDash Portable Text:
+
+  ```sh
+  vitops legal --out ./content                 # every enabled document, as markdown
+  vitops legal --doc privacy --format html     # one document, as an HTML fragment
+  ```
+
+  The documents are **derived from your config**, not filled into a form. The analytics
+  provider they name is the one whose ID you set; the personal information they list is what
+  your configured forms actually collect; the countries they name come from the providers you
+  use. So a provider swap updates the policy on the next build, and the fix for a wrong policy
+  is a corrected config — hand-editing the output is overwritten.
+
+  Enable documents under `legal`, which gains the facts the prose asserts:
+
+  ```jsonc
+  {
+    "legal": {
+      "jurisdiction": "ca", // only 'ca' (PIPEDA) ships today
+      "privacyPolicy": {
+        "enabled": true,
+        "lastUpdated": "2026-08-01",
+        "retention": "24 months after our last contact with you",
+        // Third parties the config cannot imply. Analytics, Turnstile and your
+        // deploy platform are detected automatically — list only the rest.
+        "processors": [
+          {
+            "name": "Stripe",
+            "purpose": "payment processing",
+            "country": "the United States",
+          },
+        ],
+      },
+      "termsOfService": { "enabled": true },
+      "cookieConsent": {
+        "enabled": true,
+        "type": "opt-in",
+        "categories": ["Essential", "Analytics"],
+      },
+    },
+  }
+  ```
+
+  Delivery, by stack:
+  - **Any stack** — `vitops legal`. No integration code; prints to stdout without `--out`.
+  - **WordPress/Bricks** — `vitops generate --site <path>` also writes `dist/legal/*.html`, and
+    the theme loader now registers `[vitops_legal doc="privacy"]` to render one in a page. The
+    document updates on the next deploy with no action in WordPress.
+  - **Astro** — `getvitops({ legal: { input: 'site.json', out: 'src/content/legal' } })` writes
+    markdown into a content collection and re-renders when the site config changes. It needs a
+    `css` config (that is what registers the Vite plugin); without one, use the CLI.
+  - **EmDash** — `--format portable-text`, pasted into the admin.
+
+  Also new on the public API: `generateLegal()`, `renderMarkdown()`, `renderNodes()`,
+  `derivePolicyVars()`, `parseMarkdown()` / `toHtmlFragment()` / `toPortableText()`, and
+  `resolvePrivacyContact()`.
+
+  Two things to know before you publish anything this produces:
+  - **It is not legal advice.** Every document opens with a review banner saying so. The
+    bundled terms-of-service prose in particular is generic website boilerplate and
+    deliberately does not cover sales, refunds, subscriptions, accounts or user-generated
+    content — a site doing any of those needs clauses drafted for it.
+  - **It is only as true as your config.** A policy asserting things your site does not do is
+    worse than no policy. Check that the config describes reality before you ship the output.
+
+  `validateSite` now rejects a config that enables a privacy policy without a contact for
+  privacy requests or a `domains.canonical`, since both are interpolated into sentences that
+  would otherwise render blank.
+
+### Patch Changes
+
+- Updated dependencies [bb92a14]
+- Updated dependencies [bb92a14]
+- Updated dependencies [bb92a14]
+- Updated dependencies [bb92a14]
+- Updated dependencies [eeb059f]
+  - @getvitops/generator@1.0.0
+  - @getvitops/utils@1.0.0
+
 ## 0.9.0
 
 ### Minor Changes

package/README.md

@@ -1,7 +1,7 @@
 # @getvitops/cli
 
-CLI for the Vitops design-system generator. Turn a `design-system.json` into Bricks, CSS, or
-Tailwind v4 output.
+CLI for the Vitops design-system generator. Turn a `design-system.json` into Tailwind v4,
+Bricks, `DESIGN.md`, or standalone CSS output.
 
 ```sh
 # scaffold a starter config (stamps a $schema for editor autocomplete)
@@ -17,14 +17,14 @@ npx vitops generate --format bricks,css --out dist
 
 ## Commands
 
-| command                                            | does                                          |
-| -------------------------------------------------- | --------------------------------------------- |
-| `vitops init [--out design-system.json] [--force]` | write a starter config with `$schema`         |
-| `vitops validate <file>`                           | schema-check (non-zero exit on error)         |
-| `vitops generate -i <file> -f <formats> -o <dir>`  | generate `bricks` / `css` / `tailwind` output |
-| `vitops favicon -i <svg\|png> -o <dir>`            | generate a favicon set from a source image    |
-| `vitops agents [-o AGENTS.md] [--docs-dir <dir>]`  | link the agent skill + AGENTS.md pointer      |
-| `vitops docs [topic] [--all]`                      | print live reference docs to stdout           |
+| command                                            | does                                            |
+| -------------------------------------------------- | ----------------------------------------------- |
+| `vitops init [--out design-system.json] [--force]` | write a starter config with `$schema`           |
+| `vitops validate <file>`                           | schema-check (non-zero exit on error)           |
+| `vitops generate -i <file> -f <formats> -o <dir>`  | `tailwind` / `bricks` / `design` / `css` output |
+| `vitops favicon -i <svg\|png> -o <dir>`            | generate a favicon set from a source image      |
+| `vitops agents [-o AGENTS.md] [--docs-dir <dir>]`  | link the agent skill + AGENTS.md pointer        |
+| `vitops docs [topic] [--all]`                      | print live reference docs to stdout             |
 
 ## Using the output
 
@@ -80,6 +80,19 @@ The CLI only writes files — how they reach WordPress is up to you:
 - **CI:** run `vitops generate --format bricks` in your pipeline and deploy the artifact the
   same way you deploy the rest of the theme.
 
+**Agent brief (`DESIGN.md`).** `--format design` emits a single `DESIGN.md` and **no CSS** — the
+portable brief in [design.md](https://github.com/google-labs-code/design.md) format (YAML token
+front matter, then prose) for a coding agent or design tool that doesn't have the toolchain
+installed. It conventionally lives at the repo root beside `AGENTS.md`:
+
+```sh
+vitops generate --input design-system.json --format design --out .
+```
+
+`--format` is comma-separated, but a run shares one `--out` — so keep the brief its own invocation
+whenever your stylesheet goes somewhere other than the repo root. Regenerate it with your CSS; it's
+derived from the same config, so it can't drift from what the browser gets.
+
 ## Teaching AI agents (`vitops agents` + `vitops docs`)
 
 This package **ships an agent skill** (`skill/SKILL.md`, the [Agent Skills](https://code.claude.com/docs/en/skills)

package/dist/cli.mjs

@@ -3,7 +3,8 @@ import { createRequire } from "node:module";
 import { parseArgs } from "node:util";
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
 import { dirname, extname, join, parse, relative, resolve } from "node:path";
-import { SCHEMA_URL, defaultConfig, expandPalette, functionalRole, generate, generateDocs, roleColorUtilities, validate } from "@getvitops/generator";
+import { pathToFileURL } from "node:url";
+import { NUMERIC_STEPS, SCHEMA_URL, defaultConfig, enabledDocs, expandPalette, functionalRole, generate, generateDocs, generateLegal, resolveSiteConfig, roleColorUtilities, roleHue, roleKind, validate } from "@getvitops/generator";
 import { generateFavicons } from "@getvitops/utils";
 
 //#region src/agents.ts
@@ -96,41 +97,57 @@ function linkSkill(linkPath, targetDir) {
 
 //#endregion
 //#region src/lint.ts
+/**
+* `vitops lint` — find framework classes in consumer source that resolve to
+* nothing in the format being built.
+*
+* The problem this exists for: an unknown utility class is indistinguishable
+* from a working one. Nothing errors, nothing warns, the element just doesn't
+* get the style. Two shapes of that were found in a real consumer site:
+*
+*   • `bg-navy-d` — a leftover from the named-step scale (`d`/`xd`/`xxd`)
+*     deleted in favour of numeric steps. The hue is real, the step is not.
+*     It appeared ~10× and looked fine only because the `.card` it sat on
+*     supplied its own background.
+*   • `md-flex-row` — the css/bricks spelling of a responsive variant, used in
+*     a `tailwind`-format project where that class is never emitted (Tailwind
+*     regenerates those on demand as `@md:`). Silently inert.
+*
+* DESIGN: this deliberately only inspects classes ANCHORED TO THE CONSUMER'S
+* OWN CONFIG — a hue name, a role name, a type role, a shadow, a pattern. It
+* never tries to enumerate "all valid classes", because in the tailwind format
+* that would mean knowing Tailwind's entire built-in vocabulary, and every
+* unknown would be a false positive. Anchoring means a finding is always
+* actionable: you named something from your design system, and it doesn't
+* resolve.
+*/
 const UTIL_FAMILIES = [
 	"bg",
 	"text",
+	"icon",
 	"border",
 	"outline",
 	"fill",
 	"stroke"
 ];
-const ROLE_MODIFIERS = [
-	"",
-	"muted",
-	"x-muted",
-	"bold",
-	"x-bold",
-	"solid",
-	"solid-bold",
-	"bg-bold"
-];
+/**
+* The modifiers actually emitted for one family + role, read back out of the
+* generator's own class list.
+*
+* This used to be a hand-maintained array, which is the wrong shape for a
+* suggestion: the two role kinds emit different modifiers (a chromatic role has
+* `solid` and no bare form; a surface role the reverse), so a single list was
+* wrong for one of them no matter what it said.
+*/
+const emittedModifiers = (roleClasses, fam, role) => {
+	const prefix = `${fam}-${role}`;
+	return [...roleClasses].filter((c) => c === prefix || c.startsWith(`${prefix}-`)).map((c) => c.slice(prefix.length + 1)).filter(Boolean).sort();
+};
 function vocabulary(ds, roleClasses) {
 	return {
 		roles: Object.keys(ds.colors?.roles ?? {}),
 		hues: Object.keys(ds.colors?.palette ?? {}),
-		steps: [
-			"50",
-			"100",
-			"200",
-			"300",
-			"400",
-			"500",
-			"600",
-			"700",
-			"800",
-			"900",
-			"950"
-		],
+		steps: [...NUMERIC_STEPS],
 		typeRoles: Object.keys(ds.typography?.roles ?? {}),
 		shadows: Object.keys(ds.shadows ?? {}),
 		patterns: Object.keys(ds.patterns?.items ?? {}),
@@ -166,10 +183,11 @@ function judge(raw, v, format) {
 		const role = prefix(v.roles);
 		if (role && (!hue || role.length > hue.length)) {
 			const mod = rest.slice(role.length + 1);
+			const valid = emittedModifiers(v.roleClasses, fam, role);
 			return {
 				cls: raw,
 				reason: `\`${fam}-${role}${mod ? `-${mod}` : ""}\` is not emitted for the \`${role}\` role`,
-				suggestion: `valid modifiers: ${ROLE_MODIFIERS.filter(Boolean).join(", ")}`
+				suggestion: valid.length ? `valid modifiers: ${valid.join(", ")}` : `the \`${role}\` role emits no \`${fam}-*\` utilities`
 			};
 		}
 		if (hue) {
@@ -242,22 +260,39 @@ function lintSource(files, v, format) {
 /**
 * `vitops` — CLI for the Vitops design-system generator.
 *
-*   vitops generate  --input <json> --format <bricks|css|tailwind[,…]> --out <dir>
+*   vitops generate  --input <json> --format <bricks|css|tailwind|design[,…]> --out <dir>
 *   vitops init      [--out design-system.json] [--force]
 *   vitops validate  <design-system.json>
 *   vitops favicon   --input <svg|png> --out <dir> [--low-res <svg|png>]
 *   vitops agents    [--input <json>] [--out AGENTS.md] [--docs-dir <dir>]
 *   vitops docs      [topic] [--input <json>] [--all]
 *   vitops lint      [--input <json>] [--format <fmt>] [--src <dir>]
+*   vitops legal     [--input <site.json>] [--doc <name>] [--format <md|html|portable-text>] [--out <dir>]
 *
 * Thin wrapper over @getvitops/generator (generation) and @getvitops/utils (favicons).
 * Every client brings their own consumer-editable design-system.json.
 */
 const FORMATS = new Set([
+	"bricks",
+	"css",
+	"tailwind",
+	"design"
+]);
+const LINT_FORMATS = new Set([
 	"bricks",
 	"css",
 	"tailwind"
 ]);
+const LEGAL_DOCS = new Set([
+	"privacy",
+	"terms",
+	"cookies"
+]);
+const LEGAL_OUTPUTS = new Set([
+	"md",
+	"html",
+	"portable-text"
+]);
 const HELP = `vitops — generate design-system outputs from a design-system.json
 
 Usage:
@@ -268,11 +303,17 @@ Usage:
   vitops agents [options]       Link the design-system agent skill + AGENTS.md pointer
   vitops docs [topic]           Print live design-system reference docs to stdout
   vitops lint [options]         Report framework classes in your source that resolve to nothing
+  vitops legal [options]        Render legal documents from a site config
 
 Generate options:
   -i, --input <path>    Config file (default: ./design-system.json)
-  -f, --format <list>   bricks | css | tailwind (comma-separated; default: bricks)
+  -f, --format <list>   bricks | css | tailwind | design (comma-separated; default: bricks)
+                        design emits DESIGN.md only (the agent-facing brief) — pair it
+                        with --out . to write it beside AGENTS.md, or compose:
+                        --format css,design
   -o, --out <dir>       Output directory (default: ./dist)
+      --site <path>     Site config; also emits legal/*.html into the output
+                        directory (see: vitops legal). Omitted: no legal files.
 
 Init options:
   -o, --out <path>      Where to write (default: ./design-system.json)
@@ -301,6 +342,20 @@ Lint options:
                         Responsive md-* classes are real in css/bricks, inert in tailwind.
   -s, --src <dir>       Directory to scan (default: ./src)
 
+Legal options:
+  -i, --input <path>    Site config: .json, or a .js/.ts module with a default
+                        export (default: ./site.json)
+  -d, --doc <name>      privacy | terms | cookies (repeatable; default: those
+                        enabled in the config)
+  -f, --format <fmt>    md | html | portable-text (default: md)
+                        html suits WordPress/Bricks and plain sites;
+                        portable-text suits EmDash
+  -o, --out <dir>       Write files here (default: print to stdout)
+      --site-env <env>  Environment whose A/B variant applies (default: production)
+
+  Generated from your config — a starting point, not legal advice. Review before
+  publishing, and make sure the config describes what your site actually does.
+
 Common:
   -h, --help            Show this help
 `;
@@ -326,19 +381,23 @@ async function cmdGenerate(argv) {
 				type: "string",
 				short: "o",
 				default: "dist"
-			}
+			},
+			site: { type: "string" }
 		},
 		allowPositionals: false
 	});
 	const input = resolve(values.input);
 	if (!existsSync(input)) fail(`config not found: ${input}`);
+	const site = values.site ? resolve(values.site) : void 0;
+	if (site && !existsSync(site)) fail(`site config not found: ${site}`);
 	const formats = values.format.split(",").map((f) => f.trim()).filter(Boolean);
-	for (const f of formats) if (!FORMATS.has(f)) fail(`unknown format "${f}" (expected: bricks | css | tailwind)`);
+	for (const f of formats) if (!FORMATS.has(f)) fail(`unknown format "${f}" (expected: bricks | css | tailwind | design)`);
 	for (const format of formats) try {
 		const res = await generate({
 			input,
 			format,
-			outDir: values.out
+			outDir: values.out,
+			...site ? { site } : {}
 		});
 		console.log(`✓ ${format} → ${res.outDir} (${res.written.length} paths)`);
 	} catch (err) {
@@ -443,6 +502,95 @@ function loadConfig(path) {
 	for (const w of result.warnings) console.warn(`  ! ${w}`);
 	return result.data;
 }
+/**
+* Read + resolve a site config, or exit with a message.
+*
+* Accepts JSON, or a JS/TS module with a default export — deliberately not YAML,
+* which would mean a parser dependency for one command. `resolveSiteConfig` is
+* documented as taking an already-parsed object precisely so the loader is the
+* consumer's choice; anyone on YAML can convert it or export from a module.
+*/
+async function loadSiteConfig(path, siteEnv) {
+	if (!existsSync(path)) fail(`site config not found: ${path}`);
+	let raw;
+	if (/\.(json)$/.test(path)) try {
+		raw = JSON.parse(readFileSync(path, "utf8"));
+	} catch (err) {
+		fail(`could not parse JSON: ${err.message}`);
+	}
+	else {
+		try {
+			raw = (await import(pathToFileURL(path).href)).default;
+		} catch (err) {
+			fail(`could not import ${path}: ${err.message}`);
+		}
+		if (raw == null) fail(`${path} has no default export`);
+	}
+	try {
+		return resolveSiteConfig(raw, siteEnv);
+	} catch (err) {
+		fail(err.message);
+	}
+}
+/**
+* Render the site's legal documents.
+*
+* The universal delivery path: every consumer has this CLI regardless of stack,
+* so a WordPress theme, an Eleventy build or a hand-written HTML site all get
+* the same documents without any integration code. Prints to stdout like
+* `vitops docs`, or writes files when given `--out`.
+*/
+async function cmdLegal(argv) {
+	const { values } = parseArgs({
+		args: argv,
+		options: {
+			input: {
+				type: "string",
+				short: "i",
+				default: "site.json"
+			},
+			doc: {
+				type: "string",
+				short: "d",
+				multiple: true
+			},
+			format: {
+				type: "string",
+				short: "f",
+				default: "md"
+			},
+			out: {
+				type: "string",
+				short: "o"
+			},
+			"site-env": {
+				type: "string",
+				default: "production"
+			}
+		},
+		allowPositionals: false
+	});
+	const output = values.format;
+	if (!LEGAL_OUTPUTS.has(output)) fail(`unknown format "${output}" (expected: ${[...LEGAL_OUTPUTS].join(" | ")})`);
+	const requested = values.doc ?? [];
+	for (const d of requested) if (!LEGAL_DOCS.has(d)) fail(`unknown doc "${d}" (expected: ${[...LEGAL_DOCS].join(" | ")})`);
+	const site = await loadSiteConfig(resolve(values.input), values["site-env"]);
+	const docs = requested.length ? requested : enabledDocs(site);
+	if (docs.length === 0) fail("no legal documents are enabled — set legal.privacyPolicy.enabled (or termsOfService / cookieConsent) in your site config, or name one with --doc");
+	const files = generateLegal(site, {
+		docs,
+		output
+	});
+	if (!values.out) {
+		process.stdout.write(Object.values(files).join("\n"));
+		return;
+	}
+	const outDir = resolve(values.out);
+	mkdirSync(outDir, { recursive: true });
+	for (const [name, content] of Object.entries(files)) writeFileSync(join(outDir, name), content);
+	console.log(`✓ legal → ${outDir} (${Object.keys(files).length} files)`);
+	console.log("  These are generated from your config and are not legal advice — review them before publishing.");
+}
 function cliVersion() {
 	try {
 		return JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version ?? "0.0.0";
@@ -541,13 +689,15 @@ function cmdLint(argv) {
 		allowPositionals: false
 	});
 	const format = values.format;
-	if (!FORMATS.has(format)) fail(`unknown format "${format}" (expected: bricks | css | tailwind)`);
+	if (!LINT_FORMATS.has(format)) fail(`unknown format "${format}" (expected: bricks | css | tailwind)`);
 	const ds = loadConfig(resolve(values.input));
 	const srcDir = resolve(values.src);
 	if (!existsSync(srcDir)) fail(`source directory not found: ${srcDir}`);
-	const roleClasses = roleColorUtilities(Object.entries(ds.colors.roles).map(([role, hue]) => functionalRole(role, hue, expandPalette(ds.colors.palette)[hue])), ds.colors.utilities ?? [
+	const palette = expandPalette(ds.colors.palette);
+	const roleClasses = roleColorUtilities(Object.entries(ds.colors.roles).map(([role, spec]) => functionalRole(role, roleHue(spec), palette[roleHue(spec)], roleKind(spec))), ds.colors.utilities ?? [
 		"bg",
 		"text",
+		"icon",
 		"border"
 	]).map((u) => u.cls);
 	const files = scanFiles(srcDir);
@@ -641,6 +791,7 @@ function cmdAgents(argv) {
 		"- `vitops generate --format tailwind --out src/styles` — Tailwind v4 / Astro",
 		"- `vitops generate --format css --out dist` — standalone CSS",
 		"- `vitops generate --format bricks --out <theme>/dist` — WordPress / Bricks",
+		"- `vitops generate --format design --out .` — `DESIGN.md`, the agent-facing brief",
 		"- `vitops init` · `vitops validate` · `vitops favicon`",
 		"",
 		...pointer,
@@ -684,7 +835,8 @@ async function main() {
 		case "agents": return cmdAgents(rest);
 		case "docs": return cmdDocs(rest);
 		case "lint": return cmdLint(rest);
-		default: fail(`unknown command "${command}" (expected: generate | init | validate | favicon | agents | docs | lint). Try: vitops --help`);
+		case "legal": return cmdLegal(rest);
+		default: fail(`unknown command "${command}" (expected: generate | init | validate | favicon | agents | docs | lint | legal). Try: vitops --help`);
 	}
 }
 main().catch((err) => fail(err.message));

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../src/agents.ts","../src/lint.ts","../src/cli.ts"],"sourcesContent":["/**\n * Side-effect-free helpers for the `vitops agents` / `vitops docs` commands.\n * Kept out of cli.ts (which runs main() on import) so they are unit-testable.\n */\nimport {\n  existsSync,\n  lstatSync,\n  mkdirSync,\n  readFileSync,\n  readlinkSync,\n  rmSync,\n  symlinkSync,\n} from 'node:fs';\nimport { dirname, join, parse, relative, resolve } from 'node:path';\n\nexport const SKILL_NAME = 'vitops-design-system';\n\n/** Marker the 0.5.0-era generated skill carried; lets us migrate that layout. */\nexport const GENERATED_MARKER = '<!-- GENERATED by @getvitops/cli';\n\n/**\n * `vitops docs` topics → docs-bundle paths (as returned by `generateDocs`).\n * Order is the `--all` concatenation order.\n */\nexport const TOPICS: Record<string, { path: string; summary: string }> = {\n  classes: {\n    path: 'css/classes.md',\n    summary: 'CSS framework class vocabulary (colour, type, space, layout, animation, patterns)',\n  },\n  authoring: {\n    path: 'authoring.md',\n    summary: 'every design-system.json field, rendered from the JSON Schema',\n  },\n  formats: {\n    path: 'formats.md',\n    summary: \"tailwind vs css vs bricks: what's emitted vs what the platform provides\",\n  },\n  color: {\n    path: 'concepts/color.md',\n    summary: 'seeded OKLCH scales, functional tokens, automatic dark mode',\n  },\n  scales: {\n    path: 'concepts/scales.md',\n    summary: 'fluid modular type & space scales',\n  },\n  patterns: {\n    path: 'concepts/patterns.md',\n    summary: 'pattern CSS: token cascade, override hooks, states, role variants',\n  },\n  elements: {\n    path: 'bricks/elements.md',\n    summary: 'Bricks Builder custom elements, controls, defaults',\n  },\n};\n\n/**\n * Find the installed package's skill directory by walking up from `cwd` looking\n * for `node_modules/@getvitops/cli/skill/SKILL.md`. Returns the LOGICAL path\n * (through the `node_modules/@getvitops/cli` link, unresolved) or null.\n *\n * Deliberately not derived from import.meta.url: under pnpm the running module's\n * URL is the realpath in `node_modules/.pnpm/@getvitops+cli@<version>/…`, which\n * changes on every version bump — a symlink to it would dangle after upgrades.\n * The logical path is recreated by the package manager on every install, so a\n * link through it always resolves to the currently installed version.\n */\nexport function findSkillTarget(cwd: string): string | null {\n  let dir = resolve(cwd);\n  const { root } = parse(dir);\n  for (;;) {\n    const skillDir = join(dir, 'node_modules', '@getvitops', 'cli', 'skill');\n    if (existsSync(join(skillDir, 'SKILL.md'))) return skillDir;\n    if (dir === root) return null;\n    dir = dirname(dir);\n  }\n}\n\n/**\n * Idempotently symlink `linkPath` → `targetDir` (relative target). Replaces a\n * stale symlink; migrates a real directory left by the old emitting `vitops\n * agents` (identified by GENERATED_MARKER in its SKILL.md); refuses to clobber\n * anything else. Returns a warning string, or null on success / no-op.\n */\nexport function linkSkill(linkPath: string, targetDir: string): string | null {\n  const target = relative(dirname(linkPath), resolve(targetDir));\n  try {\n    const st = lstatSync(linkPath, { throwIfNoEntry: false });\n    if (st && !st.isSymbolicLink()) {\n      const oldSkill = join(linkPath, 'SKILL.md');\n      const isGenerated =\n        st.isDirectory() &&\n        existsSync(oldSkill) &&\n        readFileSync(oldSkill, 'utf8').includes(GENERATED_MARKER);\n      if (!isGenerated)\n        return `left ${linkPath} alone (exists and is not a symlink) — link it to ${targetDir} yourself if wanted`;\n      rmSync(linkPath, { recursive: true }); // old generated skill layout → replace\n    } else if (st) {\n      if (readlinkSync(linkPath) === target) return null;\n      rmSync(linkPath);\n    } else {\n      mkdirSync(dirname(linkPath), { recursive: true });\n    }\n    symlinkSync(target, linkPath);\n    return null;\n  } catch (err) {\n    return `could not symlink ${linkPath}: ${(err as Error).message}`;\n  }\n}\n","/**\n * `vitops lint` — find framework classes in consumer source that resolve to\n * nothing in the format being built.\n *\n * The problem this exists for: an unknown utility class is indistinguishable\n * from a working one. Nothing errors, nothing warns, the element just doesn't\n * get the style. Two shapes of that were found in a real consumer site:\n *\n *   • `bg-navy-d` — a leftover from the named-step scale (`d`/`xd`/`xxd`)\n *     deleted in favour of numeric steps. The hue is real, the step is not.\n *     It appeared ~10× and looked fine only because the `.card` it sat on\n *     supplied its own background.\n *   • `md-flex-row` — the css/bricks spelling of a responsive variant, used in\n *     a `tailwind`-format project where that class is never emitted (Tailwind\n *     regenerates those on demand as `@md:`). Silently inert.\n *\n * DESIGN: this deliberately only inspects classes ANCHORED TO THE CONSUMER'S\n * OWN CONFIG — a hue name, a role name, a type role, a shadow, a pattern. It\n * never tries to enumerate \"all valid classes\", because in the tailwind format\n * that would mean knowing Tailwind's entire built-in vocabulary, and every\n * unknown would be a false positive. Anchoring means a finding is always\n * actionable: you named something from your design system, and it doesn't\n * resolve.\n */\nimport type { DesignSystem, Format } from '@getvitops/generator';\n\nexport interface LintFinding {\n  file: string;\n  line: number;\n  cls: string;\n  reason: string;\n  suggestion?: string;\n}\n\nconst UTIL_FAMILIES = ['bg', 'text', 'border', 'outline', 'fill', 'stroke'];\nconst BREAKPOINTS = ['sm', 'md', 'lg', 'xl'];\nconst ROLE_MODIFIERS = ['', 'muted', 'x-muted', 'bold', 'x-bold', 'solid', 'solid-bold', 'bg-bold'];\n\n/** Everything the config makes namable, so we only judge classes we can judge. */\ninterface Vocabulary {\n  roles: string[];\n  hues: string[];\n  steps: string[];\n  typeRoles: string[];\n  shadows: string[];\n  patterns: string[];\n  /** Every role utility the generator actually emits, e.g. `bg-surface-x-muted`. */\n  roleClasses: Set<string>;\n}\n\nexport function vocabulary(ds: DesignSystem, roleClasses: Iterable<string>): Vocabulary {\n  return {\n    roles: Object.keys(ds.colors?.roles ?? {}),\n    hues: Object.keys(ds.colors?.palette ?? {}),\n    steps: ['50', '100', '200', '300', '400', '500', '600', '700', '800', '900', '950'],\n    typeRoles: Object.keys(ds.typography?.roles ?? {}),\n    shadows: Object.keys(ds.shadows ?? {}),\n    patterns: Object.keys(ds.patterns?.items ?? {}),\n    roleClasses: new Set(roleClasses),\n  };\n}\n\n/** Strip Tailwind variant prefixes (`@md:`, `hover:`, `dark:`) from a candidate. */\nconst stripVariants = (cls: string): string => {\n  let out = cls;\n  while (/^@?[a-zA-Z0-9_-]+:/.test(out)) out = out.slice(out.indexOf(':') + 1);\n  return out;\n};\n\nconst nearest = (want: string, pool: string[]): string | undefined =>\n  pool.find((p) => p.startsWith(want) || want.startsWith(p));\n\n/**\n * Judge one class token. Returns null when the class is none of our business —\n * which is the common case and the whole reason this is low-noise.\n */\nexport function judge(\n  raw: string,\n  v: Vocabulary,\n  format: Format,\n): Omit<LintFinding, 'file' | 'line'> | null {\n  const cls = stripVariants(raw);\n\n  // ── the `<bp>-` responsive spelling ────────────────────────────────────────\n  const bp = /^(sm|md|lg|xl)-(.+)$/.exec(cls);\n  if (bp && format === 'tailwind')\n    return {\n      cls: raw,\n      reason: `\\`${bp[1]}-\\` responsive classes are not emitted in the tailwind format`,\n      suggestion: `@${bp[1]}:${bp[2]} (framework breakpoints) or ${bp[1]}:${bp[2]} (Tailwind's)`,\n    };\n  // In css/bricks the bare-prefix form is real; fall through and judge the base\n  // against the rest of the vocabulary.\n  const base = bp && format !== 'tailwind' ? (bp[2] as string) : cls;\n\n  // ── <util>-<hue>-<step> ────────────────────────────────────────────────────\n  const util = new RegExp(`^(${UTIL_FAMILIES.join('|')})-(.+)$`).exec(base);\n  if (util) {\n    const [, fam, rest] = util as unknown as [string, string, string];\n    // Anything the generator actually emits is valid, full stop. Checking this\n    // first also settles the ambiguity below for every well-formed class.\n    if (v.roleClasses.has(base)) return null;\n\n    // Role and hue names can share a prefix — `defaultConfig()` has the hue\n    // `brand` and the role `brand-primary`, so matching hues first would read\n    // `bg-brand-primary-x-muted` as hue `brand` + step `primary-x-muted` and\n    // report a bogus bad step. Take the LONGEST match across both vocabularies.\n    const prefix = (names: string[]) =>\n      names\n        .filter((n) => rest === n || rest.startsWith(`${n}-`))\n        .sort((a, b) => b.length - a.length)[0];\n    const hue = prefix(v.hues);\n    const role = prefix(v.roles);\n    const useRole = role && (!hue || role.length > hue.length);\n\n    if (useRole) {\n      const mod = rest.slice((role as string).length + 1);\n      return {\n        cls: raw,\n        reason: `\\`${fam}-${role}${mod ? `-${mod}` : ''}\\` is not emitted for the \\`${role}\\` role`,\n        suggestion: `valid modifiers: ${ROLE_MODIFIERS.filter(Boolean).join(', ')}`,\n      };\n    }\n    if (hue) {\n      const step = rest.slice(hue.length + 1);\n      if (step === '')\n        return {\n          cls: raw,\n          reason: `\\`${fam}-${hue}\\` names a palette hue with no step`,\n          suggestion: `${fam}-${hue}-500, or a role such as ${fam}-${v.roles[0] ?? 'neutral'}`,\n        };\n      if (!v.steps.includes(step))\n        return {\n          cls: raw,\n          reason: `\\`${step}\\` is not a step on the \\`${hue}\\` scale (steps are 50…950)`,\n          suggestion: `${fam}-${hue}-500, or a role such as ${fam}-${v.roles[0] ?? 'neutral'} which also flips in dark mode`,\n        };\n      return null; // valid raw step\n    }\n    return null; // not anchored to this config — not ours to judge\n  }\n\n  // ── font-<type-role> ───────────────────────────────────────────────────────\n  const font = /^font-(.+)$/.exec(base);\n  if (font && v.typeRoles.length && !v.typeRoles.includes(font[1] as string)) {\n    const near = nearest(font[1] as string, v.typeRoles);\n    // Only complain when it looks like a type role attempt, not e.g. font-bold.\n    if (near)\n      return {\n        cls: raw,\n        reason: `\\`${font[1]}\\` is not a typography role`,\n        suggestion: `font-${near}`,\n      };\n  }\n\n  // ── drop-shadow-<name> ─────────────────────────────────────────────────────\n  const ds = /^drop-shadow-(.+)$/.exec(base);\n  if (ds && v.shadows.length && !v.shadows.includes(ds[1] as string))\n    return {\n      cls: raw,\n      reason: `\\`${ds[1]}\\` is not a defined shadow`,\n      suggestion: `drop-shadow-${v.shadows[0]}`,\n    };\n\n  return null;\n}\n\nconst CLASS_ATTR = /(?:class|className|:class)\\s*=\\s*(?:\"([^\"]*)\"|'([^']*)'|\\{`([^`]*)`\\})/g;\n\n/** Extract class tokens from a source file, with line numbers. */\nexport function extractClasses(src: string): { cls: string; line: number }[] {\n  const out: { cls: string; line: number }[] = [];\n  for (const m of src.matchAll(CLASS_ATTR)) {\n    const value = m[1] ?? m[2] ?? m[3] ?? '';\n    const line = src.slice(0, m.index).split('\\n').length;\n    for (const tok of value.split(/\\s+/))\n      // Skip template holes and dynamic fragments — a partial token would be\n      // judged as a typo and this must not cry wolf.\n      if (tok && !tok.includes('${') && !tok.includes('{') && /^[@\\w:[\\]().%/-]+$/.test(tok))\n        out.push({ cls: tok, line });\n  }\n  return out;\n}\n\nexport function lintSource(\n  files: { path: string; text: string }[],\n  v: Vocabulary,\n  format: Format,\n): LintFinding[] {\n  const findings: LintFinding[] = [];\n  const seen = new Set<string>();\n  for (const f of files)\n    for (const { cls, line } of extractClasses(f.text)) {\n      const verdict = judge(cls, v, format);\n      if (!verdict) continue;\n      const key = `${f.path}:${line}:${cls}`;\n      if (seen.has(key)) continue;\n      seen.add(key);\n      findings.push({ file: f.path, line, ...verdict });\n    }\n  return findings;\n}\n","#!/usr/bin/env node\n/**\n * `vitops` — CLI for the Vitops design-system generator.\n *\n *   vitops generate  --input <json> --format <bricks|css|tailwind[,…]> --out <dir>\n *   vitops init      [--out design-system.json] [--force]\n *   vitops validate  <design-system.json>\n *   vitops favicon   --input <svg|png> --out <dir> [--low-res <svg|png>]\n *   vitops agents    [--input <json>] [--out AGENTS.md] [--docs-dir <dir>]\n *   vitops docs      [topic] [--input <json>] [--all]\n *   vitops lint      [--input <json>] [--format <fmt>] [--src <dir>]\n *\n * Thin wrapper over @getvitops/generator (generation) and @getvitops/utils (favicons).\n * Every client brings their own consumer-editable design-system.json.\n */\nimport { parseArgs } from 'node:util';\nimport { writeFileSync, existsSync, readFileSync, mkdirSync, readdirSync } from 'node:fs';\nimport { resolve, join, dirname, extname } from 'node:path';\nimport { createRequire } from 'node:module';\nimport {\n  generate,\n  validate,\n  defaultConfig,\n  generateDocs,\n  roleColorUtilities,\n  functionalRole,\n  expandPalette,\n  SCHEMA_URL,\n  type Format,\n  type DesignSystem,\n} from '@getvitops/generator';\nimport { generateFavicons } from '@getvitops/utils';\nimport { findSkillTarget, linkSkill, SKILL_NAME, TOPICS } from './agents.ts';\nimport { lintSource, vocabulary } from './lint.ts';\n\nconst FORMATS = new Set<Format>(['bricks', 'css', 'tailwind']);\n\nconst HELP = `vitops — generate design-system outputs from a design-system.json\n\nUsage:\n  vitops generate [options]     Generate platform output from a config\n  vitops init [options]         Scaffold a starter design-system.json\n  vitops validate <file>        Validate a config against the schema\n  vitops favicon [options]      Generate a favicon set from a source image\n  vitops agents [options]       Link the design-system agent skill + AGENTS.md pointer\n  vitops docs [topic]           Print live design-system reference docs to stdout\n  vitops lint [options]         Report framework classes in your source that resolve to nothing\n\nGenerate options:\n  -i, --input <path>    Config file (default: ./design-system.json)\n  -f, --format <list>   bricks | css | tailwind (comma-separated; default: bricks)\n  -o, --out <dir>       Output directory (default: ./dist)\n\nInit options:\n  -o, --out <path>      Where to write (default: ./design-system.json)\n      --force           Overwrite an existing file\n\nFavicon options:\n  -i, --input <path>    Source SVG or PNG (required)\n  -o, --out <dir>       Output directory (default: ./public)\n      --low-res <path>  Optional simplified source for the 16px icon\n\nAgents options:\n  -i, --input <path>    Config file (default: ./design-system.json; validated if present)\n  -o, --out <path>      Doc file to update, idempotently (default: ./AGENTS.md)\n      --docs-dir <dir>  Legacy layout: write the docs bundle as files to this dir\n                        instead of linking the packaged skill\n\nDocs options:\n  <topic>               classes | authoring | formats | color | scales | patterns | elements\n                        (no topic: list topics with summaries)\n  -i, --input <path>    Config file (default: ./design-system.json)\n      --all             Print every topic, concatenated\n\nLint options:\n  -i, --input <path>    Config file (default: ./design-system.json)\n  -f, --format <fmt>    Format you build (bricks | css | tailwind; default: bricks).\n                        Responsive md-* classes are real in css/bricks, inert in tailwind.\n  -s, --src <dir>       Directory to scan (default: ./src)\n\nCommon:\n  -h, --help            Show this help\n`;\n\nfunction fail(msg: string): never {\n  console.error(`✖ ${msg}`);\n  process.exit(1);\n}\n\nasync function cmdGenerate(argv: string[]) {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      input: { type: 'string', short: 'i', default: 'design-system.json' },\n      format: { type: 'string', short: 'f', default: 'bricks' },\n      out: { type: 'string', short: 'o', default: 'dist' },\n    },\n    allowPositionals: false,\n  });\n  const input = resolve(values.input as string);\n  if (!existsSync(input)) fail(`config not found: ${input}`);\n  const formats = (values.format as string)\n    .split(',')\n    .map((f) => f.trim())\n    .filter(Boolean);\n  for (const f of formats)\n    if (!FORMATS.has(f as Format))\n      fail(`unknown format \"${f}\" (expected: bricks | css | tailwind)`);\n\n  for (const format of formats as Format[]) {\n    try {\n      const res = await generate({ input, format, outDir: values.out as string });\n      console.log(`✓ ${format} → ${res.outDir} (${res.written.length} paths)`);\n    } catch (err) {\n      fail((err as Error).message);\n    }\n  }\n}\n\nfunction cmdInit(argv: string[]) {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      out: { type: 'string', short: 'o', default: 'design-system.json' },\n      force: { type: 'boolean', default: false },\n    },\n    allowPositionals: false,\n  });\n  const out = resolve(values.out as string);\n  if (existsSync(out) && !values.force) fail(`${out} already exists (use --force to overwrite)`);\n  writeFileSync(out, JSON.stringify(defaultConfig(), null, 2) + '\\n');\n  console.log(`✓ wrote ${out}`);\n  console.log(\n    `  Edit it, then: vitops generate --input ${values.out} --format tailwind --out src/styles`,\n  );\n  console.log(`  Editors read the \"$schema\" (${SCHEMA_URL}) for autocomplete + validation.`);\n}\n\nfunction cmdValidate(argv: string[]) {\n  const { values, positionals } = parseArgs({\n    args: argv,\n    options: { input: { type: 'string', short: 'i' } },\n    allowPositionals: true,\n  });\n  const path = resolve((positionals[0] ?? values.input ?? 'design-system.json') as string);\n  if (!existsSync(path)) fail(`config not found: ${path}`);\n  let raw: unknown;\n  try {\n    raw = JSON.parse(readFileSync(path, 'utf8'));\n  } catch (err) {\n    fail(`could not parse JSON: ${(err as Error).message}`);\n  }\n  const result = validate(raw);\n  for (const w of result.warnings) console.warn(`  ! ${w}`);\n  if (result.ok) {\n    console.log(`✓ ${path} is valid`);\n    return;\n  }\n  console.error(`✖ ${path} is invalid:`);\n  for (const e of result.errors) console.error(`  • ${e.path.join('.') || '(root)'}: ${e.message}`);\n  process.exit(1);\n}\n\nasync function cmdFavicon(argv: string[]) {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      input: { type: 'string', short: 'i' },\n      out: { type: 'string', short: 'o', default: 'public' },\n      'low-res': { type: 'string' },\n    },\n    allowPositionals: false,\n  });\n  if (!values.input) fail('favicon: --input <svg|png> is required');\n  const source = resolve(values.input as string);\n  if (!existsSync(source)) fail(`source not found: ${source}`);\n  try {\n    const written = await generateFavicons({\n      source,\n      outputDir: values.out as string,\n      ...(values['low-res'] ? { lowResSource: resolve(values['low-res'] as string) } : {}),\n    });\n    console.log(`✓ favicons → ${values.out} (${written.length} files)`);\n  } catch (err) {\n    fail((err as Error).message);\n  }\n}\n\n// Read + parse + validate a design-system.json, or exit with a message.\nfunction loadConfig(path: string): DesignSystem {\n  if (!existsSync(path)) fail(`config not found: ${path}`);\n  let raw: unknown;\n  try {\n    raw = JSON.parse(readFileSync(path, 'utf8'));\n  } catch (err) {\n    fail(`could not parse JSON: ${(err as Error).message}`);\n  }\n  const result = validate(raw);\n  if (!result.ok) {\n    console.error(`✖ ${path} is invalid:`);\n    for (const e of result.errors)\n      console.error(`  • ${e.path.join('.') || '(root)'}: ${e.message}`);\n    process.exit(1);\n  }\n  // Warnings go to stderr, not stdout: `vitops docs <topic>` is designed to be\n  // piped, so anything here must not land in the piped document. They used to\n  // be dropped entirely on this path, which meant `docs` and `agents` stayed\n  // silent about collisions that `generate` and `validate` both reported.\n  for (const w of result.warnings) console.warn(`  ! ${w}`);\n  return result.data;\n}\n\n// This CLI's own version (dist/cli.mjs → package-root package.json).\nfunction cliVersion(): string {\n  try {\n    return (\n      JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version ??\n      '0.0.0'\n    );\n  } catch {\n    return '0.0.0';\n  }\n}\n\n// The framework asset root shipped inside @getvitops/generator (holds the Bricks\n// PHP that generateDocs reads for the element reference).\nfunction generatorAssetsDir(): string {\n  const pkg = createRequire(import.meta.url).resolve('@getvitops/generator/package.json');\n  return join(dirname(pkg), 'assets');\n}\n\nconst AGENTS_START = '<!-- vitops:start -->';\nconst AGENTS_END = '<!-- vitops:end -->';\n\n/** Print a live reference doc (rendered from the project's config) to stdout. */\nfunction cmdDocs(argv: string[]) {\n  const { values, positionals } = parseArgs({\n    args: argv,\n    options: {\n      input: { type: 'string', short: 'i', default: 'design-system.json' },\n      all: { type: 'boolean', default: false },\n    },\n    allowPositionals: true,\n  });\n  const topic = positionals[0];\n  const topicList = () =>\n    Object.entries(TOPICS)\n      .map(([name, t]) => `  ${name.padEnd(10)} ${t.summary}`)\n      .join('\\n');\n  if (!topic && !values.all) {\n    console.log(\n      `vitops docs <topic> — print a live design-system reference to stdout\\n\\nTopics:\\n${topicList()}\\n\\nAlso: vitops docs --all (every topic, concatenated)`,\n    );\n    return;\n  }\n  if (topic && !TOPICS[topic]) fail(`unknown topic \"${topic}\". Valid topics:\\n${topicList()}`);\n  const ds = loadConfig(resolve(values.input as string));\n  const docs = generateDocs(ds, generatorAssetsDir());\n  const paths = values.all\n    ? Object.values(TOPICS).map((t) => t.path)\n    : [TOPICS[topic as string]!.path];\n  process.stdout.write(paths.map((p) => docs[p]).join('\\n'));\n}\n\nconst SCAN_EXT = new Set([\n  '.astro',\n  '.html',\n  '.htm',\n  '.js',\n  '.jsx',\n  '.ts',\n  '.tsx',\n  '.vue',\n  '.svelte',\n  '.php',\n  '.md',\n  '.mdx',\n]);\nconst SCAN_SKIP = new Set(['node_modules', 'dist', '.git', '.astro', 'build', 'coverage']);\n\nfunction scanFiles(dir: string, acc: { path: string; text: string }[] = []) {\n  for (const e of readdirSync(dir, { withFileTypes: true })) {\n    if (e.name.startsWith('.') && e.name !== '.') continue;\n    const p = join(dir, e.name);\n    if (e.isDirectory()) {\n      if (!SCAN_SKIP.has(e.name)) scanFiles(p, acc);\n    } else if (SCAN_EXT.has(extname(e.name))) {\n      acc.push({ path: p, text: readFileSync(p, 'utf8') });\n    }\n  }\n  return acc;\n}\n\nfunction cmdLint(argv: string[]) {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      input: { type: 'string', short: 'i', default: 'design-system.json' },\n      format: { type: 'string', short: 'f', default: 'bricks' },\n      src: { type: 'string', short: 's', default: 'src' },\n    },\n    allowPositionals: false,\n  });\n  const format = values.format as Format;\n  if (!FORMATS.has(format)) fail(`unknown format \"${format}\" (expected: bricks | css | tailwind)`);\n  const ds = loadConfig(resolve(values.input as string));\n  const srcDir = resolve(values.src as string);\n  if (!existsSync(srcDir)) fail(`source directory not found: ${srcDir}`);\n\n  // Ask the generator what it actually emits rather than re-deriving the rules\n  // here — a linter that models the vocabulary separately just drifts into\n  // reporting classes that do exist.\n  const roleClasses = roleColorUtilities(\n    Object.entries(ds.colors.roles).map(([role, hue]) =>\n      functionalRole(role, hue, expandPalette(ds.colors.palette)[hue]!),\n    ),\n    ds.colors.utilities ?? ['bg', 'text', 'border'],\n  ).map((u) => u.cls);\n\n  const files = scanFiles(srcDir);\n  const findings = lintSource(files, vocabulary(ds, roleClasses), format);\n\n  if (!findings.length) {\n    console.log(\n      `✓ no unresolvable framework classes in ${values.src} ` +\n        `(${files.length} file${files.length === 1 ? '' : 's'} scanned)`,\n    );\n    return;\n  }\n  for (const f of findings) {\n    console.error(`${f.file}:${f.line}  ${f.cls}`);\n    console.error(`    ${f.reason}`);\n    if (f.suggestion) console.error(`    try: ${f.suggestion}`);\n  }\n  const n = findings.length;\n  console.error(\n    `\\n✖ ${n} unresolvable class${n === 1 ? '' : 'es'} in ` +\n      `${files.length} file${files.length === 1 ? '' : 's'}`,\n  );\n  process.exit(1);\n}\n\nfunction cmdAgents(argv: string[]) {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      input: { type: 'string', short: 'i', default: 'design-system.json' },\n      out: { type: 'string', short: 'o', default: 'AGENTS.md' },\n      'docs-dir': { type: 'string' },\n    },\n    allowPositionals: false,\n  });\n  const inputRel = values.input as string;\n  // The command is pure wiring: validate the config when present (fail on an\n  // invalid one), but don't require it — docs are rendered live by `vitops docs`.\n  let ds: DesignSystem | null = null;\n  if (existsSync(resolve(inputRel))) ds = loadConfig(resolve(inputRel));\n  else console.warn(`  ⚠ ${inputRel} not found — run \\`vitops init\\` to scaffold one`);\n\n  // Explicit --docs-dir = legacy layout: write the docs bundle as files, no skill.\n  const legacyDocsDir = values['docs-dir'] as string | undefined;\n  let summary: string;\n  let pointer: string[];\n\n  if (legacyDocsDir) {\n    if (!ds) fail(`--docs-dir needs a config to render docs from (${inputRel} not found)`);\n    let docs: Record<string, string> = {};\n    try {\n      docs = generateDocs(ds, generatorAssetsDir());\n    } catch (err) {\n      fail(`could not generate docs: ${(err as Error).message}`);\n    }\n    for (const [rel, content] of Object.entries(docs)) {\n      const p = resolve(legacyDocsDir, rel);\n      mkdirSync(dirname(p), { recursive: true });\n      writeFileSync(p, content);\n    }\n    summary = `wrote ${Object.keys(docs).length} docs to ${legacyDocsDir}/`;\n    pointer = [\n      'Prefer the framework’s utility + component classes over hand-written CSS.',\n      `Reference docs (regenerate with \\`vitops agents --docs-dir ${legacyDocsDir}\\`): \\`${legacyDocsDir}/css/classes.md\\`,`,\n      `\\`${legacyDocsDir}/authoring.md\\`, \\`${legacyDocsDir}/formats.md\\`, \\`${legacyDocsDir}/bricks/elements.md\\`.`,\n    ];\n  } else {\n    // Link the packaged skill (ships inside @getvitops/cli) into the agent\n    // discovery locations; nothing is generated into the repo.\n    const target = findSkillTarget(process.cwd());\n    if (target) {\n      for (const dir of ['.agents', '.claude']) {\n        const warn = linkSkill(resolve(dir, 'skills', SKILL_NAME), target);\n        if (warn) console.warn(`  ⚠ ${warn}`);\n      }\n      summary = `linked {.agents,.claude}/skills/${SKILL_NAME} → ${target}`;\n    } else {\n      console.warn(\n        `  ⚠ could not find node_modules/@getvitops/cli/skill — install @getvitops/cli as a devDependency, then re-run \\`vitops agents\\``,\n      );\n      summary = 'no skill linked';\n    }\n    pointer = [\n      'Prefer the framework’s utility + component classes over hand-written CSS.',\n      `Full design-system context lives in the \\`${SKILL_NAME}\\` skill (linked from`,\n      '`.agents/skills/` and `.claude/skills/` into the installed `@getvitops/cli`;',\n      're-link with `vitops agents` if the links are deleted — they survive version',\n      'bumps). Reference docs print live, from this project’s config, via:',\n      '',\n      ...Object.entries(TOPICS).map(([name, t]) => `- \\`vitops docs ${name}\\` — ${t.summary}`),\n    ];\n  }\n\n  const block = [\n    AGENTS_START,\n    '## Vitops design system',\n    '',\n    `Styled with the Vitops design system (\\`@getvitops/*\\`); tokens live in \\`${inputRel}\\`.`,\n    'Generate output with the CLI:',\n    '',\n    '- `vitops generate --format tailwind --out src/styles` — Tailwind v4 / Astro',\n    '- `vitops generate --format css --out dist` — standalone CSS',\n    '- `vitops generate --format bricks --out <theme>/dist` — WordPress / Bricks',\n    '- `vitops init` · `vitops validate` · `vitops favicon`',\n    '',\n    ...pointer,\n    '',\n    `<!-- regenerate: vitops agents · @getvitops/cli@${cliVersion()} -->`,\n    AGENTS_END,\n  ].join('\\n');\n\n  const outPath = resolve(values.out as string);\n  let next: string;\n  let action: string;\n  if (existsSync(outPath)) {\n    const cur = readFileSync(outPath, 'utf8');\n    const s = cur.indexOf(AGENTS_START);\n    const e = cur.indexOf(AGENTS_END);\n    if (s !== -1 && e !== -1 && e > s) {\n      next = cur.slice(0, s) + block + cur.slice(e + AGENTS_END.length);\n      action = 'updated block in';\n    } else {\n      next = cur.replace(/\\s*$/, '') + '\\n\\n' + block + '\\n';\n      action = 'appended block to';\n    }\n  } else {\n    mkdirSync(dirname(outPath), { recursive: true });\n    next = block + '\\n';\n    action = 'created';\n  }\n  writeFileSync(outPath, next);\n  console.log(`✓ ${action} ${values.out} + ${summary}`);\n}\n\nasync function main() {\n  const [command, ...rest] = process.argv.slice(2);\n  if (!command || command === '-h' || command === '--help' || command === 'help') {\n    console.log(HELP);\n    return;\n  }\n  switch (command) {\n    case 'generate':\n      return cmdGenerate(rest);\n    case 'init':\n      return cmdInit(rest);\n    case 'validate':\n      return cmdValidate(rest);\n    case 'favicon':\n      return cmdFavicon(rest);\n    case 'agents':\n      return cmdAgents(rest);\n    case 'docs':\n      return cmdDocs(rest);\n    case 'lint':\n      return cmdLint(rest);\n    default:\n      fail(\n        `unknown command \"${command}\" (expected: generate | init | validate | favicon | agents | docs | lint). Try: vitops --help`,\n      );\n  }\n}\n\nmain().catch((err) => fail((err as Error).message));\n"],"mappings":"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"}
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/agents.ts","../src/lint.ts","../src/cli.ts"],"sourcesContent":["/**\n * Side-effect-free helpers for the `vitops agents` / `vitops docs` commands.\n * Kept out of cli.ts (which runs main() on import) so they are unit-testable.\n */\nimport {\n  existsSync,\n  lstatSync,\n  mkdirSync,\n  readFileSync,\n  readlinkSync,\n  rmSync,\n  symlinkSync,\n} from 'node:fs';\nimport { dirname, join, parse, relative, resolve } from 'node:path';\n\nexport const SKILL_NAME = 'vitops-design-system';\n\n/** Marker the 0.5.0-era generated skill carried; lets us migrate that layout. */\nexport const GENERATED_MARKER = '<!-- GENERATED by @getvitops/cli';\n\n/**\n * `vitops docs` topics → docs-bundle paths (as returned by `generateDocs`).\n * Order is the `--all` concatenation order.\n */\nexport const TOPICS: Record<string, { path: string; summary: string }> = {\n  classes: {\n    path: 'css/classes.md',\n    summary: 'CSS framework class vocabulary (colour, type, space, layout, animation, patterns)',\n  },\n  authoring: {\n    path: 'authoring.md',\n    summary: 'every design-system.json field, rendered from the JSON Schema',\n  },\n  formats: {\n    path: 'formats.md',\n    summary: \"tailwind vs css vs bricks: what's emitted vs what the platform provides\",\n  },\n  color: {\n    path: 'concepts/color.md',\n    summary: 'seeded OKLCH scales, functional tokens, automatic dark mode',\n  },\n  scales: {\n    path: 'concepts/scales.md',\n    summary: 'fluid modular type & space scales',\n  },\n  patterns: {\n    path: 'concepts/patterns.md',\n    summary: 'pattern CSS: token cascade, override hooks, states, role variants',\n  },\n  elements: {\n    path: 'bricks/elements.md',\n    summary: 'Bricks Builder custom elements, controls, defaults',\n  },\n};\n\n/**\n * Find the installed package's skill directory by walking up from `cwd` looking\n * for `node_modules/@getvitops/cli/skill/SKILL.md`. Returns the LOGICAL path\n * (through the `node_modules/@getvitops/cli` link, unresolved) or null.\n *\n * Deliberately not derived from import.meta.url: under pnpm the running module's\n * URL is the realpath in `node_modules/.pnpm/@getvitops+cli@<version>/…`, which\n * changes on every version bump — a symlink to it would dangle after upgrades.\n * The logical path is recreated by the package manager on every install, so a\n * link through it always resolves to the currently installed version.\n */\nexport function findSkillTarget(cwd: string): string | null {\n  let dir = resolve(cwd);\n  const { root } = parse(dir);\n  for (;;) {\n    const skillDir = join(dir, 'node_modules', '@getvitops', 'cli', 'skill');\n    if (existsSync(join(skillDir, 'SKILL.md'))) return skillDir;\n    if (dir === root) return null;\n    dir = dirname(dir);\n  }\n}\n\n/**\n * Idempotently symlink `linkPath` → `targetDir` (relative target). Replaces a\n * stale symlink; migrates a real directory left by the old emitting `vitops\n * agents` (identified by GENERATED_MARKER in its SKILL.md); refuses to clobber\n * anything else. Returns a warning string, or null on success / no-op.\n */\nexport function linkSkill(linkPath: string, targetDir: string): string | null {\n  const target = relative(dirname(linkPath), resolve(targetDir));\n  try {\n    const st = lstatSync(linkPath, { throwIfNoEntry: false });\n    if (st && !st.isSymbolicLink()) {\n      const oldSkill = join(linkPath, 'SKILL.md');\n      const isGenerated =\n        st.isDirectory() &&\n        existsSync(oldSkill) &&\n        readFileSync(oldSkill, 'utf8').includes(GENERATED_MARKER);\n      if (!isGenerated)\n        return `left ${linkPath} alone (exists and is not a symlink) — link it to ${targetDir} yourself if wanted`;\n      rmSync(linkPath, { recursive: true }); // old generated skill layout → replace\n    } else if (st) {\n      if (readlinkSync(linkPath) === target) return null;\n      rmSync(linkPath);\n    } else {\n      mkdirSync(dirname(linkPath), { recursive: true });\n    }\n    symlinkSync(target, linkPath);\n    return null;\n  } catch (err) {\n    return `could not symlink ${linkPath}: ${(err as Error).message}`;\n  }\n}\n","/**\n * `vitops lint` — find framework classes in consumer source that resolve to\n * nothing in the format being built.\n *\n * The problem this exists for: an unknown utility class is indistinguishable\n * from a working one. Nothing errors, nothing warns, the element just doesn't\n * get the style. Two shapes of that were found in a real consumer site:\n *\n *   • `bg-navy-d` — a leftover from the named-step scale (`d`/`xd`/`xxd`)\n *     deleted in favour of numeric steps. The hue is real, the step is not.\n *     It appeared ~10× and looked fine only because the `.card` it sat on\n *     supplied its own background.\n *   • `md-flex-row` — the css/bricks spelling of a responsive variant, used in\n *     a `tailwind`-format project where that class is never emitted (Tailwind\n *     regenerates those on demand as `@md:`). Silently inert.\n *\n * DESIGN: this deliberately only inspects classes ANCHORED TO THE CONSUMER'S\n * OWN CONFIG — a hue name, a role name, a type role, a shadow, a pattern. It\n * never tries to enumerate \"all valid classes\", because in the tailwind format\n * that would mean knowing Tailwind's entire built-in vocabulary, and every\n * unknown would be a false positive. Anchoring means a finding is always\n * actionable: you named something from your design system, and it doesn't\n * resolve.\n */\nimport { NUMERIC_STEPS, type DesignSystem, type Format } from '@getvitops/generator';\n\nexport interface LintFinding {\n  file: string;\n  line: number;\n  cls: string;\n  reason: string;\n  suggestion?: string;\n}\n\nconst UTIL_FAMILIES = ['bg', 'text', 'icon', 'border', 'outline', 'fill', 'stroke'];\nconst BREAKPOINTS = ['sm', 'md', 'lg', 'xl'];\n\n/**\n * The modifiers actually emitted for one family + role, read back out of the\n * generator's own class list.\n *\n * This used to be a hand-maintained array, which is the wrong shape for a\n * suggestion: the two role kinds emit different modifiers (a chromatic role has\n * `solid` and no bare form; a surface role the reverse), so a single list was\n * wrong for one of them no matter what it said.\n */\nconst emittedModifiers = (roleClasses: Set<string>, fam: string, role: string): string[] => {\n  const prefix = `${fam}-${role}`;\n  return [...roleClasses]\n    .filter((c) => c === prefix || c.startsWith(`${prefix}-`))\n    .map((c) => c.slice(prefix.length + 1))\n    .filter(Boolean)\n    .sort();\n};\n\n/** Everything the config makes namable, so we only judge classes we can judge. */\ninterface Vocabulary {\n  roles: string[];\n  hues: string[];\n  steps: string[];\n  typeRoles: string[];\n  shadows: string[];\n  patterns: string[];\n  /** Every role utility the generator actually emits, e.g. `bg-surface-x-muted`. */\n  roleClasses: Set<string>;\n}\n\nexport function vocabulary(ds: DesignSystem, roleClasses: Iterable<string>): Vocabulary {\n  return {\n    roles: Object.keys(ds.colors?.roles ?? {}),\n    hues: Object.keys(ds.colors?.palette ?? {}),\n    steps: [...NUMERIC_STEPS],\n    typeRoles: Object.keys(ds.typography?.roles ?? {}),\n    shadows: Object.keys(ds.shadows ?? {}),\n    patterns: Object.keys(ds.patterns?.items ?? {}),\n    roleClasses: new Set(roleClasses),\n  };\n}\n\n/** Strip Tailwind variant prefixes (`@md:`, `hover:`, `dark:`) from a candidate. */\nconst stripVariants = (cls: string): string => {\n  let out = cls;\n  while (/^@?[a-zA-Z0-9_-]+:/.test(out)) out = out.slice(out.indexOf(':') + 1);\n  return out;\n};\n\nconst nearest = (want: string, pool: string[]): string | undefined =>\n  pool.find((p) => p.startsWith(want) || want.startsWith(p));\n\n/**\n * Judge one class token. Returns null when the class is none of our business —\n * which is the common case and the whole reason this is low-noise.\n */\nexport function judge(\n  raw: string,\n  v: Vocabulary,\n  format: Format,\n): Omit<LintFinding, 'file' | 'line'> | null {\n  const cls = stripVariants(raw);\n\n  // ── the `<bp>-` responsive spelling ────────────────────────────────────────\n  const bp = /^(sm|md|lg|xl)-(.+)$/.exec(cls);\n  if (bp && format === 'tailwind')\n    return {\n      cls: raw,\n      reason: `\\`${bp[1]}-\\` responsive classes are not emitted in the tailwind format`,\n      suggestion: `@${bp[1]}:${bp[2]} (framework breakpoints) or ${bp[1]}:${bp[2]} (Tailwind's)`,\n    };\n  // In css/bricks the bare-prefix form is real; fall through and judge the base\n  // against the rest of the vocabulary.\n  const base = bp && format !== 'tailwind' ? (bp[2] as string) : cls;\n\n  // ── <util>-<hue>-<step> ────────────────────────────────────────────────────\n  const util = new RegExp(`^(${UTIL_FAMILIES.join('|')})-(.+)$`).exec(base);\n  if (util) {\n    const [, fam, rest] = util as unknown as [string, string, string];\n    // Anything the generator actually emits is valid, full stop. Checking this\n    // first also settles the ambiguity below for every well-formed class.\n    if (v.roleClasses.has(base)) return null;\n\n    // Role and hue names can share a prefix — `defaultConfig()` has the hue\n    // `brand` and the role `brand-primary`, so matching hues first would read\n    // `bg-brand-primary-x-muted` as hue `brand` + step `primary-x-muted` and\n    // report a bogus bad step. Take the LONGEST match across both vocabularies.\n    const prefix = (names: string[]) =>\n      names\n        .filter((n) => rest === n || rest.startsWith(`${n}-`))\n        .sort((a, b) => b.length - a.length)[0];\n    const hue = prefix(v.hues);\n    const role = prefix(v.roles);\n    const useRole = role && (!hue || role.length > hue.length);\n\n    if (useRole) {\n      const mod = rest.slice((role as string).length + 1);\n      const valid = emittedModifiers(v.roleClasses, fam as string, role as string);\n      return {\n        cls: raw,\n        reason: `\\`${fam}-${role}${mod ? `-${mod}` : ''}\\` is not emitted for the \\`${role}\\` role`,\n        suggestion: valid.length\n          ? `valid modifiers: ${valid.join(', ')}`\n          : `the \\`${role}\\` role emits no \\`${fam}-*\\` utilities`,\n      };\n    }\n    if (hue) {\n      const step = rest.slice(hue.length + 1);\n      if (step === '')\n        return {\n          cls: raw,\n          reason: `\\`${fam}-${hue}\\` names a palette hue with no step`,\n          suggestion: `${fam}-${hue}-500, or a role such as ${fam}-${v.roles[0] ?? 'neutral'}`,\n        };\n      if (!v.steps.includes(step))\n        return {\n          cls: raw,\n          reason: `\\`${step}\\` is not a step on the \\`${hue}\\` scale (steps are 50…950)`,\n          suggestion: `${fam}-${hue}-500, or a role such as ${fam}-${v.roles[0] ?? 'neutral'} which also flips in dark mode`,\n        };\n      return null; // valid raw step\n    }\n    return null; // not anchored to this config — not ours to judge\n  }\n\n  // ── font-<type-role> ───────────────────────────────────────────────────────\n  const font = /^font-(.+)$/.exec(base);\n  if (font && v.typeRoles.length && !v.typeRoles.includes(font[1] as string)) {\n    const near = nearest(font[1] as string, v.typeRoles);\n    // Only complain when it looks like a type role attempt, not e.g. font-bold.\n    if (near)\n      return {\n        cls: raw,\n        reason: `\\`${font[1]}\\` is not a typography role`,\n        suggestion: `font-${near}`,\n      };\n  }\n\n  // ── drop-shadow-<name> ─────────────────────────────────────────────────────\n  const ds = /^drop-shadow-(.+)$/.exec(base);\n  if (ds && v.shadows.length && !v.shadows.includes(ds[1] as string))\n    return {\n      cls: raw,\n      reason: `\\`${ds[1]}\\` is not a defined shadow`,\n      suggestion: `drop-shadow-${v.shadows[0]}`,\n    };\n\n  return null;\n}\n\nconst CLASS_ATTR = /(?:class|className|:class)\\s*=\\s*(?:\"([^\"]*)\"|'([^']*)'|\\{`([^`]*)`\\})/g;\n\n/** Extract class tokens from a source file, with line numbers. */\nexport function extractClasses(src: string): { cls: string; line: number }[] {\n  const out: { cls: string; line: number }[] = [];\n  for (const m of src.matchAll(CLASS_ATTR)) {\n    const value = m[1] ?? m[2] ?? m[3] ?? '';\n    const line = src.slice(0, m.index).split('\\n').length;\n    for (const tok of value.split(/\\s+/))\n      // Skip template holes and dynamic fragments — a partial token would be\n      // judged as a typo and this must not cry wolf.\n      if (tok && !tok.includes('${') && !tok.includes('{') && /^[@\\w:[\\]().%/-]+$/.test(tok))\n        out.push({ cls: tok, line });\n  }\n  return out;\n}\n\nexport function lintSource(\n  files: { path: string; text: string }[],\n  v: Vocabulary,\n  format: Format,\n): LintFinding[] {\n  const findings: LintFinding[] = [];\n  const seen = new Set<string>();\n  for (const f of files)\n    for (const { cls, line } of extractClasses(f.text)) {\n      const verdict = judge(cls, v, format);\n      if (!verdict) continue;\n      const key = `${f.path}:${line}:${cls}`;\n      if (seen.has(key)) continue;\n      seen.add(key);\n      findings.push({ file: f.path, line, ...verdict });\n    }\n  return findings;\n}\n","#!/usr/bin/env node\n/**\n * `vitops` — CLI for the Vitops design-system generator.\n *\n *   vitops generate  --input <json> --format <bricks|css|tailwind|design[,…]> --out <dir>\n *   vitops init      [--out design-system.json] [--force]\n *   vitops validate  <design-system.json>\n *   vitops favicon   --input <svg|png> --out <dir> [--low-res <svg|png>]\n *   vitops agents    [--input <json>] [--out AGENTS.md] [--docs-dir <dir>]\n *   vitops docs      [topic] [--input <json>] [--all]\n *   vitops lint      [--input <json>] [--format <fmt>] [--src <dir>]\n *   vitops legal     [--input <site.json>] [--doc <name>] [--format <md|html|portable-text>] [--out <dir>]\n *\n * Thin wrapper over @getvitops/generator (generation) and @getvitops/utils (favicons).\n * Every client brings their own consumer-editable design-system.json.\n */\nimport { parseArgs } from 'node:util';\nimport { writeFileSync, existsSync, readFileSync, mkdirSync, readdirSync } from 'node:fs';\nimport { resolve, join, dirname, extname } from 'node:path';\nimport { createRequire } from 'node:module';\nimport { pathToFileURL } from 'node:url';\nimport {\n  generate,\n  validate,\n  defaultConfig,\n  generateDocs,\n  generateLegal,\n  enabledDocs,\n  resolveSiteConfig,\n  roleColorUtilities,\n  functionalRole,\n  expandPalette,\n  roleHue,\n  roleKind,\n  SCHEMA_URL,\n  type Format,\n  type StylesheetFormat,\n  type DesignSystem,\n  type LegalDoc,\n  type LegalOutput,\n  type SiteConfig,\n} from '@getvitops/generator';\nimport { generateFavicons } from '@getvitops/utils';\nimport { findSkillTarget, linkSkill, SKILL_NAME, TOPICS } from './agents.ts';\nimport { lintSource, vocabulary } from './lint.ts';\n\nconst FORMATS = new Set<Format>(['bricks', 'css', 'tailwind', 'design']);\n// `lint` judges class names against what a build emits, and the `design` format\n// emits no CSS at all — so it is a valid target for `generate` and a category\n// error for `lint`.\nconst LINT_FORMATS = new Set<StylesheetFormat>(['bricks', 'css', 'tailwind']);\n\n// `legal` reads a *site* config, not a design-system.json, and has its own\n// output set — it renders documents, not stylesheets.\nconst LEGAL_DOCS = new Set<LegalDoc>(['privacy', 'terms', 'cookies']);\nconst LEGAL_OUTPUTS = new Set<LegalOutput>(['md', 'html', 'portable-text']);\n\nconst HELP = `vitops — generate design-system outputs from a design-system.json\n\nUsage:\n  vitops generate [options]     Generate platform output from a config\n  vitops init [options]         Scaffold a starter design-system.json\n  vitops validate <file>        Validate a config against the schema\n  vitops favicon [options]      Generate a favicon set from a source image\n  vitops agents [options]       Link the design-system agent skill + AGENTS.md pointer\n  vitops docs [topic]           Print live design-system reference docs to stdout\n  vitops lint [options]         Report framework classes in your source that resolve to nothing\n  vitops legal [options]        Render legal documents from a site config\n\nGenerate options:\n  -i, --input <path>    Config file (default: ./design-system.json)\n  -f, --format <list>   bricks | css | tailwind | design (comma-separated; default: bricks)\n                        design emits DESIGN.md only (the agent-facing brief) — pair it\n                        with --out . to write it beside AGENTS.md, or compose:\n                        --format css,design\n  -o, --out <dir>       Output directory (default: ./dist)\n      --site <path>     Site config; also emits legal/*.html into the output\n                        directory (see: vitops legal). Omitted: no legal files.\n\nInit options:\n  -o, --out <path>      Where to write (default: ./design-system.json)\n      --force           Overwrite an existing file\n\nFavicon options:\n  -i, --input <path>    Source SVG or PNG (required)\n  -o, --out <dir>       Output directory (default: ./public)\n      --low-res <path>  Optional simplified source for the 16px icon\n\nAgents options:\n  -i, --input <path>    Config file (default: ./design-system.json; validated if present)\n  -o, --out <path>      Doc file to update, idempotently (default: ./AGENTS.md)\n      --docs-dir <dir>  Legacy layout: write the docs bundle as files to this dir\n                        instead of linking the packaged skill\n\nDocs options:\n  <topic>               classes | authoring | formats | color | scales | patterns | elements\n                        (no topic: list topics with summaries)\n  -i, --input <path>    Config file (default: ./design-system.json)\n      --all             Print every topic, concatenated\n\nLint options:\n  -i, --input <path>    Config file (default: ./design-system.json)\n  -f, --format <fmt>    Format you build (bricks | css | tailwind; default: bricks).\n                        Responsive md-* classes are real in css/bricks, inert in tailwind.\n  -s, --src <dir>       Directory to scan (default: ./src)\n\nLegal options:\n  -i, --input <path>    Site config: .json, or a .js/.ts module with a default\n                        export (default: ./site.json)\n  -d, --doc <name>      privacy | terms | cookies (repeatable; default: those\n                        enabled in the config)\n  -f, --format <fmt>    md | html | portable-text (default: md)\n                        html suits WordPress/Bricks and plain sites;\n                        portable-text suits EmDash\n  -o, --out <dir>       Write files here (default: print to stdout)\n      --site-env <env>  Environment whose A/B variant applies (default: production)\n\n  Generated from your config — a starting point, not legal advice. Review before\n  publishing, and make sure the config describes what your site actually does.\n\nCommon:\n  -h, --help            Show this help\n`;\n\nfunction fail(msg: string): never {\n  console.error(`✖ ${msg}`);\n  process.exit(1);\n}\n\nasync function cmdGenerate(argv: string[]) {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      input: { type: 'string', short: 'i', default: 'design-system.json' },\n      format: { type: 'string', short: 'f', default: 'bricks' },\n      out: { type: 'string', short: 'o', default: 'dist' },\n      site: { type: 'string' },\n    },\n    allowPositionals: false,\n  });\n  const input = resolve(values.input as string);\n  if (!existsSync(input)) fail(`config not found: ${input}`);\n  const site = values.site ? resolve(values.site as string) : undefined;\n  if (site && !existsSync(site)) fail(`site config not found: ${site}`);\n  const formats = (values.format as string)\n    .split(',')\n    .map((f) => f.trim())\n    .filter(Boolean);\n  for (const f of formats)\n    if (!FORMATS.has(f as Format))\n      fail(`unknown format \"${f}\" (expected: bricks | css | tailwind | design)`);\n\n  for (const format of formats as Format[]) {\n    try {\n      const res = await generate({\n        input,\n        format,\n        outDir: values.out as string,\n        ...(site ? { site } : {}),\n      });\n      console.log(`✓ ${format} → ${res.outDir} (${res.written.length} paths)`);\n    } catch (err) {\n      fail((err as Error).message);\n    }\n  }\n}\n\nfunction cmdInit(argv: string[]) {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      out: { type: 'string', short: 'o', default: 'design-system.json' },\n      force: { type: 'boolean', default: false },\n    },\n    allowPositionals: false,\n  });\n  const out = resolve(values.out as string);\n  if (existsSync(out) && !values.force) fail(`${out} already exists (use --force to overwrite)`);\n  writeFileSync(out, JSON.stringify(defaultConfig(), null, 2) + '\\n');\n  console.log(`✓ wrote ${out}`);\n  console.log(\n    `  Edit it, then: vitops generate --input ${values.out} --format tailwind --out src/styles`,\n  );\n  console.log(`  Editors read the \"$schema\" (${SCHEMA_URL}) for autocomplete + validation.`);\n}\n\nfunction cmdValidate(argv: string[]) {\n  const { values, positionals } = parseArgs({\n    args: argv,\n    options: { input: { type: 'string', short: 'i' } },\n    allowPositionals: true,\n  });\n  const path = resolve((positionals[0] ?? values.input ?? 'design-system.json') as string);\n  if (!existsSync(path)) fail(`config not found: ${path}`);\n  let raw: unknown;\n  try {\n    raw = JSON.parse(readFileSync(path, 'utf8'));\n  } catch (err) {\n    fail(`could not parse JSON: ${(err as Error).message}`);\n  }\n  const result = validate(raw);\n  for (const w of result.warnings) console.warn(`  ! ${w}`);\n  if (result.ok) {\n    console.log(`✓ ${path} is valid`);\n    return;\n  }\n  console.error(`✖ ${path} is invalid:`);\n  for (const e of result.errors) console.error(`  • ${e.path.join('.') || '(root)'}: ${e.message}`);\n  process.exit(1);\n}\n\nasync function cmdFavicon(argv: string[]) {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      input: { type: 'string', short: 'i' },\n      out: { type: 'string', short: 'o', default: 'public' },\n      'low-res': { type: 'string' },\n    },\n    allowPositionals: false,\n  });\n  if (!values.input) fail('favicon: --input <svg|png> is required');\n  const source = resolve(values.input as string);\n  if (!existsSync(source)) fail(`source not found: ${source}`);\n  try {\n    const written = await generateFavicons({\n      source,\n      outputDir: values.out as string,\n      ...(values['low-res'] ? { lowResSource: resolve(values['low-res'] as string) } : {}),\n    });\n    console.log(`✓ favicons → ${values.out} (${written.length} files)`);\n  } catch (err) {\n    fail((err as Error).message);\n  }\n}\n\n// Read + parse + validate a design-system.json, or exit with a message.\nfunction loadConfig(path: string): DesignSystem {\n  if (!existsSync(path)) fail(`config not found: ${path}`);\n  let raw: unknown;\n  try {\n    raw = JSON.parse(readFileSync(path, 'utf8'));\n  } catch (err) {\n    fail(`could not parse JSON: ${(err as Error).message}`);\n  }\n  const result = validate(raw);\n  if (!result.ok) {\n    console.error(`✖ ${path} is invalid:`);\n    for (const e of result.errors)\n      console.error(`  • ${e.path.join('.') || '(root)'}: ${e.message}`);\n    process.exit(1);\n  }\n  // Warnings go to stderr, not stdout: `vitops docs <topic>` is designed to be\n  // piped, so anything here must not land in the piped document. They used to\n  // be dropped entirely on this path, which meant `docs` and `agents` stayed\n  // silent about collisions that `generate` and `validate` both reported.\n  for (const w of result.warnings) console.warn(`  ! ${w}`);\n  return result.data;\n}\n\n/**\n * Read + resolve a site config, or exit with a message.\n *\n * Accepts JSON, or a JS/TS module with a default export — deliberately not YAML,\n * which would mean a parser dependency for one command. `resolveSiteConfig` is\n * documented as taking an already-parsed object precisely so the loader is the\n * consumer's choice; anyone on YAML can convert it or export from a module.\n */\nasync function loadSiteConfig(path: string, siteEnv: string): Promise<SiteConfig> {\n  if (!existsSync(path)) fail(`site config not found: ${path}`);\n  let raw: unknown;\n  if (/\\.(json)$/.test(path)) {\n    try {\n      raw = JSON.parse(readFileSync(path, 'utf8'));\n    } catch (err) {\n      fail(`could not parse JSON: ${(err as Error).message}`);\n    }\n  } else {\n    try {\n      raw = (await import(pathToFileURL(path).href)).default;\n    } catch (err) {\n      fail(`could not import ${path}: ${(err as Error).message}`);\n    }\n    if (raw == null) fail(`${path} has no default export`);\n  }\n  try {\n    return resolveSiteConfig(raw, siteEnv);\n  } catch (err) {\n    // resolveSiteConfig already formats one issue per line.\n    fail((err as Error).message);\n  }\n}\n\n/**\n * Render the site's legal documents.\n *\n * The universal delivery path: every consumer has this CLI regardless of stack,\n * so a WordPress theme, an Eleventy build or a hand-written HTML site all get\n * the same documents without any integration code. Prints to stdout like\n * `vitops docs`, or writes files when given `--out`.\n */\nasync function cmdLegal(argv: string[]) {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      input: { type: 'string', short: 'i', default: 'site.json' },\n      doc: { type: 'string', short: 'd', multiple: true },\n      format: { type: 'string', short: 'f', default: 'md' },\n      out: { type: 'string', short: 'o' },\n      'site-env': { type: 'string', default: 'production' },\n    },\n    allowPositionals: false,\n  });\n\n  const output = values.format as LegalOutput;\n  if (!LEGAL_OUTPUTS.has(output))\n    fail(`unknown format \"${output}\" (expected: ${[...LEGAL_OUTPUTS].join(' | ')})`);\n\n  const requested = (values.doc ?? []) as string[];\n  for (const d of requested)\n    if (!LEGAL_DOCS.has(d as LegalDoc))\n      fail(`unknown doc \"${d}\" (expected: ${[...LEGAL_DOCS].join(' | ')})`);\n\n  const site = await loadSiteConfig(resolve(values.input as string), values['site-env'] as string);\n  const docs = requested.length ? (requested as LegalDoc[]) : enabledDocs(site);\n  if (docs.length === 0)\n    fail(\n      'no legal documents are enabled — set legal.privacyPolicy.enabled (or termsOfService / cookieConsent) in your site config, or name one with --doc',\n    );\n\n  const files = generateLegal(site, { docs, output });\n\n  if (!values.out) {\n    process.stdout.write(Object.values(files).join('\\n'));\n    return;\n  }\n  const outDir = resolve(values.out as string);\n  mkdirSync(outDir, { recursive: true });\n  for (const [name, content] of Object.entries(files)) writeFileSync(join(outDir, name), content);\n  console.log(`✓ legal → ${outDir} (${Object.keys(files).length} files)`);\n  console.log(\n    '  These are generated from your config and are not legal advice — review them before publishing.',\n  );\n}\n\n// This CLI's own version (dist/cli.mjs → package-root package.json).\nfunction cliVersion(): string {\n  try {\n    return (\n      JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version ??\n      '0.0.0'\n    );\n  } catch {\n    return '0.0.0';\n  }\n}\n\n// The framework asset root shipped inside @getvitops/generator (holds the Bricks\n// PHP that generateDocs reads for the element reference).\nfunction generatorAssetsDir(): string {\n  const pkg = createRequire(import.meta.url).resolve('@getvitops/generator/package.json');\n  return join(dirname(pkg), 'assets');\n}\n\nconst AGENTS_START = '<!-- vitops:start -->';\nconst AGENTS_END = '<!-- vitops:end -->';\n\n/** Print a live reference doc (rendered from the project's config) to stdout. */\nfunction cmdDocs(argv: string[]) {\n  const { values, positionals } = parseArgs({\n    args: argv,\n    options: {\n      input: { type: 'string', short: 'i', default: 'design-system.json' },\n      all: { type: 'boolean', default: false },\n    },\n    allowPositionals: true,\n  });\n  const topic = positionals[0];\n  const topicList = () =>\n    Object.entries(TOPICS)\n      .map(([name, t]) => `  ${name.padEnd(10)} ${t.summary}`)\n      .join('\\n');\n  if (!topic && !values.all) {\n    console.log(\n      `vitops docs <topic> — print a live design-system reference to stdout\\n\\nTopics:\\n${topicList()}\\n\\nAlso: vitops docs --all (every topic, concatenated)`,\n    );\n    return;\n  }\n  if (topic && !TOPICS[topic]) fail(`unknown topic \"${topic}\". Valid topics:\\n${topicList()}`);\n  const ds = loadConfig(resolve(values.input as string));\n  const docs = generateDocs(ds, generatorAssetsDir());\n  const paths = values.all\n    ? Object.values(TOPICS).map((t) => t.path)\n    : [TOPICS[topic as string]!.path];\n  process.stdout.write(paths.map((p) => docs[p]).join('\\n'));\n}\n\nconst SCAN_EXT = new Set([\n  '.astro',\n  '.html',\n  '.htm',\n  '.js',\n  '.jsx',\n  '.ts',\n  '.tsx',\n  '.vue',\n  '.svelte',\n  '.php',\n  '.md',\n  '.mdx',\n]);\nconst SCAN_SKIP = new Set(['node_modules', 'dist', '.git', '.astro', 'build', 'coverage']);\n\nfunction scanFiles(dir: string, acc: { path: string; text: string }[] = []) {\n  for (const e of readdirSync(dir, { withFileTypes: true })) {\n    if (e.name.startsWith('.') && e.name !== '.') continue;\n    const p = join(dir, e.name);\n    if (e.isDirectory()) {\n      if (!SCAN_SKIP.has(e.name)) scanFiles(p, acc);\n    } else if (SCAN_EXT.has(extname(e.name))) {\n      acc.push({ path: p, text: readFileSync(p, 'utf8') });\n    }\n  }\n  return acc;\n}\n\nfunction cmdLint(argv: string[]) {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      input: { type: 'string', short: 'i', default: 'design-system.json' },\n      format: { type: 'string', short: 'f', default: 'bricks' },\n      src: { type: 'string', short: 's', default: 'src' },\n    },\n    allowPositionals: false,\n  });\n  const format = values.format as StylesheetFormat;\n  if (!LINT_FORMATS.has(format))\n    fail(`unknown format \"${format}\" (expected: bricks | css | tailwind)`);\n  const ds = loadConfig(resolve(values.input as string));\n  const srcDir = resolve(values.src as string);\n  if (!existsSync(srcDir)) fail(`source directory not found: ${srcDir}`);\n\n  // Ask the generator what it actually emits rather than re-deriving the rules\n  // here — a linter that models the vocabulary separately just drifts into\n  // reporting classes that do exist.\n  const palette = expandPalette(ds.colors.palette);\n  const roleClasses = roleColorUtilities(\n    Object.entries(ds.colors.roles).map(([role, spec]) =>\n      functionalRole(role, roleHue(spec), palette[roleHue(spec)]!, roleKind(spec)),\n    ),\n    ds.colors.utilities ?? ['bg', 'text', 'icon', 'border'],\n  ).map((u) => u.cls);\n\n  const files = scanFiles(srcDir);\n  const findings = lintSource(files, vocabulary(ds, roleClasses), format);\n\n  if (!findings.length) {\n    console.log(\n      `✓ no unresolvable framework classes in ${values.src} ` +\n        `(${files.length} file${files.length === 1 ? '' : 's'} scanned)`,\n    );\n    return;\n  }\n  for (const f of findings) {\n    console.error(`${f.file}:${f.line}  ${f.cls}`);\n    console.error(`    ${f.reason}`);\n    if (f.suggestion) console.error(`    try: ${f.suggestion}`);\n  }\n  const n = findings.length;\n  console.error(\n    `\\n✖ ${n} unresolvable class${n === 1 ? '' : 'es'} in ` +\n      `${files.length} file${files.length === 1 ? '' : 's'}`,\n  );\n  process.exit(1);\n}\n\nfunction cmdAgents(argv: string[]) {\n  const { values } = parseArgs({\n    args: argv,\n    options: {\n      input: { type: 'string', short: 'i', default: 'design-system.json' },\n      out: { type: 'string', short: 'o', default: 'AGENTS.md' },\n      'docs-dir': { type: 'string' },\n    },\n    allowPositionals: false,\n  });\n  const inputRel = values.input as string;\n  // The command is pure wiring: validate the config when present (fail on an\n  // invalid one), but don't require it — docs are rendered live by `vitops docs`.\n  let ds: DesignSystem | null = null;\n  if (existsSync(resolve(inputRel))) ds = loadConfig(resolve(inputRel));\n  else console.warn(`  ⚠ ${inputRel} not found — run \\`vitops init\\` to scaffold one`);\n\n  // Explicit --docs-dir = legacy layout: write the docs bundle as files, no skill.\n  const legacyDocsDir = values['docs-dir'] as string | undefined;\n  let summary: string;\n  let pointer: string[];\n\n  if (legacyDocsDir) {\n    if (!ds) fail(`--docs-dir needs a config to render docs from (${inputRel} not found)`);\n    let docs: Record<string, string> = {};\n    try {\n      docs = generateDocs(ds, generatorAssetsDir());\n    } catch (err) {\n      fail(`could not generate docs: ${(err as Error).message}`);\n    }\n    for (const [rel, content] of Object.entries(docs)) {\n      const p = resolve(legacyDocsDir, rel);\n      mkdirSync(dirname(p), { recursive: true });\n      writeFileSync(p, content);\n    }\n    summary = `wrote ${Object.keys(docs).length} docs to ${legacyDocsDir}/`;\n    pointer = [\n      'Prefer the framework’s utility + component classes over hand-written CSS.',\n      `Reference docs (regenerate with \\`vitops agents --docs-dir ${legacyDocsDir}\\`): \\`${legacyDocsDir}/css/classes.md\\`,`,\n      `\\`${legacyDocsDir}/authoring.md\\`, \\`${legacyDocsDir}/formats.md\\`, \\`${legacyDocsDir}/bricks/elements.md\\`.`,\n    ];\n  } else {\n    // Link the packaged skill (ships inside @getvitops/cli) into the agent\n    // discovery locations; nothing is generated into the repo.\n    const target = findSkillTarget(process.cwd());\n    if (target) {\n      for (const dir of ['.agents', '.claude']) {\n        const warn = linkSkill(resolve(dir, 'skills', SKILL_NAME), target);\n        if (warn) console.warn(`  ⚠ ${warn}`);\n      }\n      summary = `linked {.agents,.claude}/skills/${SKILL_NAME} → ${target}`;\n    } else {\n      console.warn(\n        `  ⚠ could not find node_modules/@getvitops/cli/skill — install @getvitops/cli as a devDependency, then re-run \\`vitops agents\\``,\n      );\n      summary = 'no skill linked';\n    }\n    pointer = [\n      'Prefer the framework’s utility + component classes over hand-written CSS.',\n      `Full design-system context lives in the \\`${SKILL_NAME}\\` skill (linked from`,\n      '`.agents/skills/` and `.claude/skills/` into the installed `@getvitops/cli`;',\n      're-link with `vitops agents` if the links are deleted — they survive version',\n      'bumps). Reference docs print live, from this project’s config, via:',\n      '',\n      ...Object.entries(TOPICS).map(([name, t]) => `- \\`vitops docs ${name}\\` — ${t.summary}`),\n    ];\n  }\n\n  const block = [\n    AGENTS_START,\n    '## Vitops design system',\n    '',\n    `Styled with the Vitops design system (\\`@getvitops/*\\`); tokens live in \\`${inputRel}\\`.`,\n    'Generate output with the CLI:',\n    '',\n    '- `vitops generate --format tailwind --out src/styles` — Tailwind v4 / Astro',\n    '- `vitops generate --format css --out dist` — standalone CSS',\n    '- `vitops generate --format bricks --out <theme>/dist` — WordPress / Bricks',\n    '- `vitops generate --format design --out .` — `DESIGN.md`, the agent-facing brief',\n    '- `vitops init` · `vitops validate` · `vitops favicon`',\n    '',\n    ...pointer,\n    '',\n    `<!-- regenerate: vitops agents · @getvitops/cli@${cliVersion()} -->`,\n    AGENTS_END,\n  ].join('\\n');\n\n  const outPath = resolve(values.out as string);\n  let next: string;\n  let action: string;\n  if (existsSync(outPath)) {\n    const cur = readFileSync(outPath, 'utf8');\n    const s = cur.indexOf(AGENTS_START);\n    const e = cur.indexOf(AGENTS_END);\n    if (s !== -1 && e !== -1 && e > s) {\n      next = cur.slice(0, s) + block + cur.slice(e + AGENTS_END.length);\n      action = 'updated block in';\n    } else {\n      next = cur.replace(/\\s*$/, '') + '\\n\\n' + block + '\\n';\n      action = 'appended block to';\n    }\n  } else {\n    mkdirSync(dirname(outPath), { recursive: true });\n    next = block + '\\n';\n    action = 'created';\n  }\n  writeFileSync(outPath, next);\n  console.log(`✓ ${action} ${values.out} + ${summary}`);\n}\n\nasync function main() {\n  const [command, ...rest] = process.argv.slice(2);\n  if (!command || command === '-h' || command === '--help' || command === 'help') {\n    console.log(HELP);\n    return;\n  }\n  switch (command) {\n    case 'generate':\n      return cmdGenerate(rest);\n    case 'init':\n      return cmdInit(rest);\n    case 'validate':\n      return cmdValidate(rest);\n    case 'favicon':\n      return cmdFavicon(rest);\n    case 'agents':\n      return cmdAgents(rest);\n    case 'docs':\n      return cmdDocs(rest);\n    case 'lint':\n      return cmdLint(rest);\n    case 'legal':\n      return cmdLegal(rest);\n    default:\n      fail(\n        `unknown command \"${command}\" (expected: generate | init | validate | favicon | agents | docs | lint | legal). Try: vitops --help`,\n      );\n  }\n}\n\nmain().catch((err) => fail((err as Error).message));\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getvitops/cli",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "description": "CLI for the Vitops design-system generator: generate, init, and validate a design-system.json.",
   "license": "MIT",
   "bin": {
@@ -22,8 +22,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@getvitops/generator": "0.9.0",
-    "@getvitops/utils": "0.9.0"
+    "@getvitops/generator": "1.0.0",
+    "@getvitops/utils": "1.0.0"
   },
   "devDependencies": {
     "vitest": "^4.1.9"

package/skill/SKILL.md

@@ -40,7 +40,23 @@ never stale and always names the project's actual tokens. (If `vitops` isn't on
 ## Other commands
 
 - `vitops generate --format <tailwind|css|bricks>` — generate the platform output.
+- `vitops generate --format design --out .` — write `DESIGN.md`, the agent-facing brief
+  (google-labs-code/design.md format: YAML token front matter + prose rationale). It
+  emits no CSS, so it composes: `--format css,design`. The live reference above is
+  richer; DESIGN.md is for handing the identity to a tool that doesn't have this skill.
 - `vitops init` / `vitops validate` — scaffold / check a `design-system.json`.
+- `vitops legal` — render the site's privacy policy, terms of service and cookie notice
+  from a **site config** (not a `design-system.json`). `--format md|html|portable-text`
+  covers Astro content collections, WordPress/Bricks fragments and EmDash respectively;
+  `--out <dir>` writes files, otherwise it prints to stdout.
+  The documents are **derived from the config**: the analytics provider it names is the
+  one whose ID is set, the personal information it lists is what the configured forms
+  collect, the countries it names come from the providers in use. So the fix for a wrong
+  policy is a corrected config, never hand-editing the output — the next build overwrites
+  it. Declare processors the config cannot imply (payment, CRM, mail) under
+  `legal.privacyPolicy.processors`.
+  Generated from config, not legal advice — always tell the user to have it reviewed
+  before publishing.
 - `vitops agents` — (re-)link this skill into `.agents/skills/` + `.claude/skills/` and
   refresh the AGENTS.md pointer block. The links point into the installed package and
   survive version bumps; re-run only if they were deleted.