design-constraint-validator 2.1.0 → 2.2.0

package/cli/cross-axis-loader.ts

@@ -9,7 +9,9 @@
  */
 
 import { existsSync, readFileSync } from 'node:fs';
+import { z } from 'zod';
 import type { CrossAxisRule } from '../core/constraints/cross-axis.js';
+import type { ConstraintIssue } from '../core/engine.js';
 
 /**
  * Raw rule format as stored in JSON files.
@@ -71,27 +73,132 @@ export type LoadCrossAxisOptions = {
  * @param path Path to cross-axis rules JSON file
  * @returns Parsed rules or undefined if file missing/invalid
  */
-export function loadCrossAxisRulesFromFile(path: string): RawCrossAxisRule[] | undefined {
-  if (!existsSync(path)) {
-    return undefined;
-  }
+/**
+ * Outcome of reading a cross-axis rules file, distinguishing the three cases a
+ * validator must not collapse (TASK-037): a *missing* file (no rules, fine) vs.
+ * a *present-but-unusable* file (bad JSON / wrong shape — must be surfaced, never
+ * silently treated as "no rules → green") vs. a successfully read rule array.
+ */
+export type RawCrossAxisFileResult =
+  | { status: 'missing' }
+  | { status: 'invalid'; reason: string }
+  | { status: 'ok'; rules: RawCrossAxisRule[] };
 
+export function readCrossAxisRulesFile(path: string): RawCrossAxisFileResult {
+  if (!existsSync(path)) return { status: 'missing' };
+  let data: unknown;
   try {
-    const data = JSON.parse(readFileSync(path, 'utf8')) as { rules: RawCrossAxisRule[] };
-    return data.rules || [];
-  } catch {
-    // Return undefined on parse errors (consistent with silent failure behavior)
-    return undefined;
+    data = JSON.parse(readFileSync(path, 'utf8'));
+  } catch (e: any) {
+    return { status: 'invalid', reason: `invalid JSON (${e?.message ?? e})` };
+  }
+  const rules = (data as { rules?: unknown } | null)?.rules;
+  if (!Array.isArray(rules)) {
+    return { status: 'invalid', reason: 'expected a top-level "rules" array' };
+  }
+  return { status: 'ok', rules: rules as RawCrossAxisRule[] };
+}
+
+/**
+ * Back-compat shim: returns the rule array, or `undefined` for both missing and
+ * present-but-unusable files. Prefer {@link readCrossAxisRulesFile} when the
+ * caller needs to surface the unusable case.
+ */
+export function loadCrossAxisRulesFromFile(path: string): RawCrossAxisRule[] | undefined {
+  const res = readCrossAxisRulesFile(path);
+  return res.status === 'ok' ? res.rules : undefined;
+}
+
+// ---------------------------------------------------------------------------
+// Rule shape validation (TASK-037)
+//
+// A cross-axis rule that fails to compile must be SKIPPED WITH A REASON, never
+// compiled into an always-true predicate or a NaN comparison. Examples the old
+// code admitted silently: a `when` missing `op`/`value` (always-true), a
+// `require` with no RHS (compared against 0), a non-numeric `fallback` (NaN).
+// ---------------------------------------------------------------------------
+
+const opEnum = z.enum(['<=', '>=', '<', '>', '==', '!=']);
+const sizeConst = z.union([z.number(), z.string()]);
+
+const RawCrossAxisRuleSchema = z
+  .object({
+    id: z.string(),
+    level: z.enum(['error', 'warn']).optional(),
+    where: z.string().optional(),
+    bp: z.string().optional(),
+    when: z.object({ id: z.string(), op: opEnum, value: z.number().finite() }).strict().optional(),
+    require: z
+      .object({ id: z.string(), op: opEnum, ref: z.string().optional(), fallback: sizeConst.optional() })
+      .strict()
+      .optional(),
+    compare: z.object({ a: z.string(), op: opEnum, b: z.string(), delta: sizeConst.optional() }).strict().optional(),
+  })
+  .strict();
+
+export type RuleValidation =
+  | { ok: true; rule: RawCrossAxisRule }
+  | { ok: false; id?: string; reason: string };
+
+export function validateRawRule(raw: unknown): RuleValidation {
+  const parsed = RawCrossAxisRuleSchema.safeParse(raw);
+  if (!parsed.success) {
+    const id =
+      raw && typeof raw === 'object' && 'id' in raw && typeof (raw as any).id === 'string'
+        ? (raw as any).id
+        : undefined;
+    const reason = parsed.error.issues.map((e) => `${e.path.join('.') || '<root>'}: ${e.message}`).join('; ');
+    return { ok: false, id, reason };
+  }
+  const rule = parsed.data as RawCrossAxisRule;
+  const hasWhenReq = !!(rule.when && rule.require);
+  const hasCompare = !!rule.compare;
+  if (!hasWhenReq && !hasCompare) {
+    return { ok: false, id: rule.id, reason: 'must define when+require or compare' };
+  }
+  if (hasWhenReq && hasCompare) {
+    return { ok: false, id: rule.id, reason: 'must define exactly one of when+require or compare' };
+  }
+  // Size constants must parse, or the compiled predicate degrades to NaN/0.
+  if (rule.require?.fallback !== undefined && px(rule.require.fallback) === null) {
+    return { ok: false, id: rule.id, reason: `require.fallback is not a parseable size: ${JSON.stringify(rule.require.fallback)}` };
+  }
+  if (rule.compare?.delta !== undefined && px(rule.compare.delta) === null) {
+    return { ok: false, id: rule.id, reason: `compare.delta is not a parseable size: ${JSON.stringify(rule.compare.delta)}` };
   }
+  return { ok: true, rule };
+}
+
+/**
+ * Whether a rule is active for a given breakpoint scope. Shared by rule
+ * compilation and coverage enumeration so the two never drift (TASK-037): a
+ * rule that did not run must not be able to make coverage look "matched".
+ */
+export function ruleMatchesBp(r: { bp?: string }, bp?: string): boolean {
+  if (r?.bp && bp && r.bp !== bp) return false; // targets a different bp
+  if (r?.bp && !bp) return false; // bp-specific rule in a global run
+  return true;
 }
 
 // ============================================================================
 // Rule Parsing and Validation
 // ============================================================================
 
-// Helper functions (copied from core/cross-axis-config.ts)
-const px = (v: string | number) =>
-  typeof v === 'number' ? v : parseFloat(String(v)) * (String(v).trim().endsWith('rem') ? 16 : 1);
+// Parse a cross-axis size CONSTANT (rule `fallback`/`delta`), not a token value.
+// Mirrors the hardened finite-size policy (TASK-037): real numbers only, `rem`/
+// `em` 16px-relative, non-finite rejected — but allows a leading `-` because a
+// `compare.delta` is a signed offset (e.g. "-560px"). Returns null on garbage so
+// callers reject the rule instead of silently degrading to NaN/0.
+const px = (v: string | number): number | null => {
+  if (typeof v === 'number') return Number.isFinite(v) ? v : null;
+  if (typeof v !== 'string') return null;
+  const m = v.trim().match(/^(-?\d*\.?\d+)\s*(px|rem|em)?$/i);
+  if (!m) return null;
+  const n = parseFloat(m[1]);
+  if (!Number.isFinite(n)) return null;
+  const unit = (m[2] || 'px').toLowerCase();
+  return unit === 'rem' || unit === 'em' ? n * 16 : n;
+};
 
 const cmp = (a: number, b: number, op: '<=' | '>=' | '<' | '>' | '==' | '!=') =>
   op === '>=' ? a >= b : op === '>' ? a > b : op === '<=' ? a <= b : op === '<' ? a < b : op === '==' ? a === b : a !== b;
@@ -105,7 +212,10 @@ function valueOrRef(ctx: any, ref?: string, fallback?: string | number) {
     const v = ctx.getPx(ref);
     if (v != null) return v;
   }
-  return typeof fallback === 'number' ? fallback : px(fallback ?? 0);
+  if (typeof fallback === 'number') return fallback;
+  // `?? 0` is defensive only: validateRawRule rejects rules whose fallback does
+  // not parse, so a compiled rule never reaches here with garbage.
+  return px(fallback ?? 0) ?? 0;
 }
 
 function makeOp(op: '<=' | '>=' | '<' | '>' | '==' | '!=', rhs: number) {
@@ -169,15 +279,18 @@ export function parseCrossAxisRules(rawRules: RawCrossAxisRule[], opts: LoadCros
     return true;
   };
 
-  for (const r of rawRules) {
-    // Filter by breakpoint
-    if (r.bp && bp && r.bp !== bp) {
-      continue;
-    }
-    if (r.bp && !bp) {
-      // Rule targets specific breakpoint; skip in global run
+  for (const raw of rawRules) {
+    // Filter by breakpoint (shared with coverage enumeration so they never drift).
+    if (!ruleMatchesBp(raw as RawCrossAxisRule, bp)) continue;
+
+    // Validate shape BEFORE compiling: an invalid rule is skipped with a reason,
+    // never compiled into an always-true or NaN predicate (TASK-037).
+    const valid = validateRawRule(raw);
+    if (!valid.ok) {
+      skipped.push({ id: valid.id, reason: valid.reason });
       continue;
     }
+    const r = valid.rule;
 
     try {
       if (r.when && r.require) {
@@ -217,20 +330,18 @@ export function parseCrossAxisRules(rawRules: RawCrossAxisRule[], opts: LoadCros
             test: (_: number, ctx: any) => {
               const a = ctx.getPx(r.compare!.a) ?? NaN;
               const b = ctx.getPx(r.compare!.b) ?? NaN;
-              const delta = px(r.compare!.delta ?? 0);
+              const delta = px(r.compare!.delta ?? 0) ?? 0;
               if (Number.isNaN(a) || Number.isNaN(b)) return true; // skip check if missing
               return cmp(a, b + delta, r.compare!.op);
             },
             msg: (_: number, ctx: any) => {
               const a = ctx.getPx(r.compare!.a);
               const b = ctx.getPx(r.compare!.b);
-              const delta = px(r.compare!.delta ?? 0);
+              const delta = px(r.compare!.delta ?? 0) ?? 0;
               return `${r.compare!.a} ${prettyFail(r.compare!.op)} ${fmt((b ?? 0) + delta)} (was ${fmt(a ?? NaN)})`;
             },
           },
         });
-      } else {
-        skipped.push({ id: r.id, reason: 'neither when+require nor compare present' });
       }
     } catch (e: any) {
       skipped.push({ id: r.id, reason: `exception: ${e?.message ?? e}` });
@@ -287,3 +398,67 @@ export function loadCrossAxisRules(path: string, opts: LoadCrossAxisOptions = {}
   const result = parseCrossAxisRules(rawRules, opts);
   return result.rules;
 }
+
+/**
+ * Load + parse cross-axis rules AND return notices to surface (TASK-037).
+ *
+ * Unlike {@link loadCrossAxisRules}, a present-but-unusable file or a skipped
+ * (invalid) rule produces a `warn`-level {@link ConstraintIssue} so it appears
+ * in the validation result instead of vanishing into a silent "no rules → green".
+ */
+export function loadCrossAxisRulesDetailed(
+  path: string,
+  opts: LoadCrossAxisOptions = {},
+): { rules: CrossAxisRule[]; notices: ConstraintIssue[] } {
+  const file = readCrossAxisRulesFile(path);
+  if (file.status === 'missing') return { rules: [], notices: [] };
+  if (file.status === 'invalid') {
+    return {
+      rules: [],
+      notices: [
+        {
+          id: 'cross-axis',
+          rule: 'cross-axis',
+          level: 'warn',
+          where: path,
+          message: `Cross-axis rules file present but unusable: ${file.reason}`,
+        },
+      ],
+    };
+  }
+  const result = parseCrossAxisRules(file.rules, opts);
+  const notices: ConstraintIssue[] = result.skipped.map((s) => ({
+    id: `cross-axis:${s.id ?? '(no id)'}`,
+    rule: 'cross-axis',
+    level: 'warn' as const,
+    message: `Cross-axis rule ${s.id ? `"${s.id}" ` : ''}skipped: ${s.reason}`,
+  }));
+  return { rules: result.rules, notices };
+}
+
+/**
+ * Token ids a cross-axis file contributes to constraint coverage for a given
+ * breakpoint scope (TASK-037). Mirrors compilation exactly: the SAME bp filter
+ * and the SAME shape validation, so a rule that did not run cannot make coverage
+ * look "matched" (which would suppress the "nothing was checked" note).
+ *
+ * `coverageKnown` is false only when the file is present-but-unusable.
+ */
+export function referencedIdsForFile(path: string, bp?: string): { ids: string[]; coverageKnown: boolean } {
+  const file = readCrossAxisRulesFile(path);
+  if (file.status === 'missing') return { ids: [], coverageKnown: true };
+  if (file.status === 'invalid') return { ids: [], coverageKnown: false };
+  const ids: string[] = [];
+  for (const raw of file.rules) {
+    if (!ruleMatchesBp(raw as RawCrossAxisRule, bp)) continue;
+    const v = validateRawRule(raw);
+    if (!v.ok) continue; // invalid rule did not compile → contributes no coverage
+    const r = v.rule;
+    if (r.when?.id) ids.push(r.when.id);
+    if (r.require?.id) ids.push(r.require.id);
+    if (r.require?.ref) ids.push(r.require.ref);
+    if (r.compare?.a) ids.push(r.compare.a);
+    if (r.compare?.b) ids.push(r.compare.b);
+  }
+  return { ids, coverageKnown: true };
+}

package/cli/dcv.js

@@ -3,12 +3,21 @@
 import yargs from 'yargs/yargs';
 import { hideBin } from 'yargs/helpers';
 import { setCommand, buildCommand, validateCommand, graphCommand, whyCommand, patchCommand, patchApplyCommand } from './commands/index.js';
+import { getVersionInfo } from './version-banner.js';
 const cli = yargs(hideBin(process.argv))
     .scriptName('dcv')
+    // camel-case-expansion is intentionally OFF, so the CLI delivers flags only
+    // under their kebab key (e.g. argv['dry-run'], never argv.dryRun). Commands
+    // read BOTH forms — `options['dry-run'] ?? options.dryRun` — so the same handler
+    // works whether invoked by the CLI (kebab) or programmatically/tests (camelCase).
+    // Reading only one form silently no-ops for the other caller (TASK-024).
     .parserConfiguration({ 'camel-case-expansion': false })
     .option('quiet', { type: 'boolean' })
     .option('config', { type: 'string', describe: 'Path to JSON config file' });
-cli.command('set <expressions..>', 'Set token values', y => y
+// `[expressions..]` is OPTIONAL: batch mode (--json / `-` stdin) and unset-only
+// mode (--unset) take no positional, and a mandatory positional made yargs abort
+// before the handler (TASK-032).
+cli.command('set [expressions..]', 'Set token values', y => y
     .positional('expressions', { type: 'string', array: true })
     .option('dry-run', { type: 'boolean', default: false })
     .option('write', { type: 'boolean' })
@@ -17,6 +26,7 @@ cli.command('set <expressions..>', 'Set token values', y => y
     .option('format', { type: 'string', choices: ['json', 'css', 'js'], default: 'json' })
     .option('output', { type: 'string' })
     .option('theme', { type: 'string' })
+    .option('debug-set', { type: 'boolean', hidden: true }) // hidden debug aid (also DCV_DEBUG_SET=1)
     .option('tokens', { type: 'string', default: 'tokens/tokens.example.json' }), a => setCommand(a));
 cli.command('build', 'Build token outputs', y => y
     .option('format', { type: 'string', choices: ['css', 'json', 'js'], default: 'css' })
@@ -38,6 +48,7 @@ cli.command('validate [tokens-path]', 'Validate constraints', y => y
     .option('theme', { type: 'string', describe: 'Apply named theme tokens before validation' })
     .option('breakpoint', { type: 'string' })
     .option('all-breakpoints', { type: 'boolean' })
+    .option('cross-axis-debug', { type: 'boolean', hidden: true }) // hidden debug aid
     .option('perf', { type: 'boolean', describe: 'Print timing info' })
     .option('budget-total-ms', { type: 'number', describe: 'Fail if total validation exceeds this (ms)' })
     .option('budget-per-bp-ms', { type: 'number', describe: 'Fail if any single breakpoint exceeds this (ms)' }), a => validateCommand(a));
@@ -45,6 +56,10 @@ cli.command('graph', 'Generate dependency / constraint graph', y => y
     .option('format', { type: 'string', choices: ['json', 'mermaid', 'dot', 'svg', 'png'], default: 'json' })
     .option('bundle', { type: 'boolean', describe: 'When used with --hasse export mermaid+dot (+image if svg/png requested)' })
     .option('hasse', { type: 'string' })
+    .option('constraints-dir', { type: 'string', describe: 'Directory holding order / cross-axis constraint files (default: themes). Used with --hasse.' })
+    .option('filter', { type: 'string', describe: 'Filter dependency-graph edges by regex (matches either endpoint)' })
+    .option('breakpoint', { type: 'string', choices: ['sm', 'md', 'lg'] })
+    .option('all-breakpoints', { type: 'boolean' })
     .option('filter-prefix', { type: 'string' })
     .option('exclude-prefix', { type: 'string' })
     .option('only-violations', { type: 'boolean' })
@@ -52,12 +67,15 @@ cli.command('graph', 'Generate dependency / constraint graph', y => y
     .option('label-violations', { type: 'boolean' })
     .option('label-truncate', { type: 'number', default: 0 })
     .option('min-severity', { type: 'string', choices: ['warn', 'error'], default: 'warn' })
+    .option('violation-color', { type: 'string', describe: 'Hex color for highlighted violations (default: #ff2d55)' })
+    .option('image-from', { type: 'string', choices: ['mermaid', 'dot'], describe: 'Source format for svg/png export (default: mermaid)' })
     .option('focus', { type: 'string' })
     .option('radius', { type: 'number', default: 1 })
     .option('tokens', { type: 'string', describe: 'Path to a tokens file (defaults to tokens/tokens.example.json)' }), a => graphCommand(a));
 cli.command('why <tokenId>', 'Explain token provenance', y => y
     .positional('tokenId', { type: 'string', demandOption: true })
     .option('format', { type: 'string', choices: ['json', 'table'], default: 'json' })
+    .option('constraints-dir', { type: 'string', describe: 'Directory holding order / cross-axis constraint files for the constraint summary (default: themes)' })
     .option('tokens', { type: 'string', default: 'tokens/tokens.example.json' }), a => whyCommand(a));
 cli.command('patch', 'Export patch (diff) from overrides', y => y
     .option('overrides', { type: 'string', describe: 'Path or inline JSON of flat overrides' })
@@ -69,6 +87,10 @@ cli.command('patch:apply <patch>', 'Apply patch document to tokens', y => y
     .option('tokens', { type: 'string', default: 'tokens/tokens.example.json' })
     .option('output', { type: 'string', describe: 'Write updated tokens to this file' })
     .option('dry-run', { type: 'boolean', default: false }), a => patchApplyCommand(a));
+// Wire `--version` to the real package version (same source as the banner).
+// Without this, yargs can't locate package.json from the installed bin and
+// prints "unknown" (TASK-021 release smoke-test finding).
+cli.version(getVersionInfo().version);
 cli.help().alias('h', 'help').strict().wrap(cli.terminalWidth());
 cli.parse();
 // EOF

package/cli/dcv.ts

@@ -4,14 +4,23 @@ import yargs from 'yargs/yargs';
 import { hideBin } from 'yargs/helpers';
 import { type SetOptions, type BuildOptions, type ValidateOptions, type GraphOptions, type WhyOptions, type PatchOptions, type PatchApplyOptions } from './types.js';
 import { setCommand, buildCommand, validateCommand, graphCommand, whyCommand, patchCommand, patchApplyCommand } from './commands/index.js';
+import { getVersionInfo } from './version-banner.js';
 
 const cli = yargs(hideBin(process.argv))
   .scriptName('dcv')
+  // camel-case-expansion is intentionally OFF, so the CLI delivers flags only
+  // under their kebab key (e.g. argv['dry-run'], never argv.dryRun). Commands
+  // read BOTH forms — `options['dry-run'] ?? options.dryRun` — so the same handler
+  // works whether invoked by the CLI (kebab) or programmatically/tests (camelCase).
+  // Reading only one form silently no-ops for the other caller (TASK-024).
   .parserConfiguration({ 'camel-case-expansion': false })
   .option('quiet', { type: 'boolean' })
   .option('config', { type: 'string', describe: 'Path to JSON config file' });
 
-cli.command<SetOptions>('set <expressions..>', 'Set token values', y => y
+// `[expressions..]` is OPTIONAL: batch mode (--json / `-` stdin) and unset-only
+// mode (--unset) take no positional, and a mandatory positional made yargs abort
+// before the handler (TASK-032).
+cli.command<SetOptions>('set [expressions..]', 'Set token values', y => y
   .positional('expressions', { type: 'string', array: true })
   .option('dry-run', { type: 'boolean', default: false })
   .option('write', { type: 'boolean' })
@@ -20,6 +29,7 @@ cli.command<SetOptions>('set <expressions..>', 'Set token values', y => y
   .option('format', { type: 'string', choices: ['json','css','js'], default: 'json' })
   .option('output', { type: 'string' })
   .option('theme', { type: 'string' })
+  .option('debug-set', { type: 'boolean', hidden: true }) // hidden debug aid (also DCV_DEBUG_SET=1)
   .option('tokens', { type: 'string', default: 'tokens/tokens.example.json' }),
   a => setCommand(a)
 );
@@ -47,6 +57,7 @@ cli.command<ValidateOptions>('validate [tokens-path]', 'Validate constraints', y
   .option('theme', { type: 'string', describe: 'Apply named theme tokens before validation' })
   .option('breakpoint', { type: 'string' })
   .option('all-breakpoints', { type: 'boolean' })
+  .option('cross-axis-debug', { type: 'boolean', hidden: true }) // hidden debug aid
   .option('perf', { type: 'boolean', describe: 'Print timing info' })
   .option('budget-total-ms', { type: 'number', describe: 'Fail if total validation exceeds this (ms)' })
   .option('budget-per-bp-ms', { type: 'number', describe: 'Fail if any single breakpoint exceeds this (ms)' }),
@@ -57,6 +68,10 @@ cli.command<GraphOptions>('graph', 'Generate dependency / constraint graph', y =
   .option('format', { type: 'string', choices: ['json','mermaid','dot','svg','png'], default: 'json' })
   .option('bundle', { type: 'boolean', describe: 'When used with --hasse export mermaid+dot (+image if svg/png requested)' })
   .option('hasse', { type: 'string' })
+  .option('constraints-dir', { type: 'string', describe: 'Directory holding order / cross-axis constraint files (default: themes). Used with --hasse.' })
+  .option('filter', { type: 'string', describe: 'Filter dependency-graph edges by regex (matches either endpoint)' })
+  .option('breakpoint', { type: 'string', choices: ['sm','md','lg'] })
+  .option('all-breakpoints', { type: 'boolean' })
   .option('filter-prefix', { type: 'string' })
   .option('exclude-prefix', { type: 'string' })
   .option('only-violations', { type: 'boolean' })
@@ -64,6 +79,8 @@ cli.command<GraphOptions>('graph', 'Generate dependency / constraint graph', y =
   .option('label-violations', { type: 'boolean' })
   .option('label-truncate', { type: 'number', default: 0 })
   .option('min-severity', { type: 'string', choices: ['warn','error'], default: 'warn' })
+  .option('violation-color', { type: 'string', describe: 'Hex color for highlighted violations (default: #ff2d55)' })
+  .option('image-from', { type: 'string', choices: ['mermaid','dot'], describe: 'Source format for svg/png export (default: mermaid)' })
   .option('focus', { type: 'string' })
   .option('radius', { type: 'number', default: 1 })
   .option('tokens', { type: 'string', describe: 'Path to a tokens file (defaults to tokens/tokens.example.json)' }),
@@ -73,6 +90,7 @@ cli.command<GraphOptions>('graph', 'Generate dependency / constraint graph', y =
 cli.command<WhyOptions>('why <tokenId>', 'Explain token provenance', y => y
   .positional('tokenId', { type: 'string', demandOption: true })
   .option('format', { type: 'string', choices: ['json','table'], default: 'json' })
+  .option('constraints-dir', { type: 'string', describe: 'Directory holding order / cross-axis constraint files for the constraint summary (default: themes)' })
   .option('tokens', { type: 'string', default: 'tokens/tokens.example.json' }),
   a => whyCommand(a)
 );
@@ -93,6 +111,10 @@ cli.command<PatchApplyOptions>('patch:apply <patch>', 'Apply patch document to t
   a => patchApplyCommand(a)
 );
 
+// Wire `--version` to the real package version (same source as the banner).
+// Without this, yargs can't locate package.json from the installed bin and
+// prints "unknown" (TASK-021 release smoke-test finding).
+cli.version(getVersionInfo().version);
 cli.help().alias('h','help').strict().wrap(cli.terminalWidth());
 cli.parse();
 

package/cli/types.d.ts

@@ -32,6 +32,8 @@ export interface SetOptions extends GlobalOptions {
     write?: boolean;
     json?: string;
     unset?: string[];
+    dryRun?: boolean;
+    'dry-run'?: boolean;
 }
 export interface BuildOptions extends GlobalOptions {
     output?: string;
@@ -40,7 +42,9 @@ export interface BuildOptions extends GlobalOptions {
     theme?: string;
     mapper?: string;
     dryRun?: boolean;
+    'dry-run'?: boolean;
     allFormats?: boolean;
+    'all-formats'?: boolean;
 }
 export interface ValidateOptions extends GlobalOptions {
     strict?: boolean;
@@ -49,33 +53,38 @@ export interface ValidateOptions extends GlobalOptions {
     'constraints-dir'?: string;
     perf?: boolean;
     budgetTotalMs?: number;
+    'budget-total-ms'?: number;
     budgetPerBpMs?: number;
+    'budget-per-bp-ms'?: number;
     format?: 'text' | 'json';
     output?: string;
     receipt?: string;
     failOn?: 'off' | 'warn' | 'error';
+    'fail-on'?: 'off' | 'warn' | 'error';
     summary?: 'none' | 'table' | 'json';
 }
 export interface GraphOptions extends GlobalOptions {
     output?: string;
+    'constraints-dir'?: string;
     format?: 'dot' | 'mermaid' | 'json' | 'svg' | 'png';
-    imageFrom?: 'mermaid' | 'dot';
     filter?: string;
     hasse?: string;
-    filterPrefix?: string;
-    excludePrefix?: string;
-    onlyViolations?: boolean;
-    highlightViolations?: boolean;
-    violationColor?: string;
-    labelViolations?: boolean;
-    labelTruncate?: number;
-    minSeverity?: 'warn' | 'error';
+    'image-from'?: 'mermaid' | 'dot';
+    'filter-prefix'?: string;
+    'exclude-prefix'?: string;
+    'only-violations'?: boolean;
+    'highlight-violations'?: boolean;
+    'violation-color'?: string;
+    'label-violations'?: boolean;
+    'label-truncate'?: number;
+    'min-severity'?: 'warn' | 'error';
     focus?: string;
     radius?: number;
     tokens?: string;
 }
 export interface WhyOptions extends GlobalOptions {
     tokenId: string;
+    'constraints-dir'?: string;
     format?: 'json' | 'table';
 }
 export interface PatchOptions extends GlobalOptions {
@@ -89,6 +98,7 @@ export interface PatchApplyOptions extends GlobalOptions {
     output?: string;
     tokens?: string;
     dryRun?: boolean;
+    'dry-run'?: boolean;
 }
 export type { Breakpoint };
 //# sourceMappingURL=types.d.ts.map

package/cli/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,cAAc;IAAG,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;AAChH,MAAM,MAAM,SAAS,GAAG,eAAe,CAAC;AACxC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACrD,MAAM,WAAW,aAAa;IAAG,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAAE;AAClE,MAAM,MAAM,aAAa,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,CAAA;CAAE,GAAG,aAAa,CAAC;AAE3F,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AACD,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AACD,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AACD,MAAM,WAAW,eAAgB,SAAQ,aAAa;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CACrC;AACD,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IACpD,SAAS,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3B;AACD,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,iBAAkB,SAAQ,aAAa;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AACD,YAAY,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"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"}

package/cli/types.ts

@@ -25,6 +25,10 @@ export interface SetOptions extends GlobalOptions {
   write?: boolean;
   json?: string;
   unset?: string[];
+  // CLI delivers the kebab key (camel-case-expansion off); programmatic callers
+  // pass camelCase. Commands read both (TASK-024).
+  dryRun?: boolean;
+  'dry-run'?: boolean;
 }
 export interface BuildOptions extends GlobalOptions {
   output?: string;
@@ -33,7 +37,9 @@ export interface BuildOptions extends GlobalOptions {
   theme?: string;
   mapper?: string;
   dryRun?: boolean;
+  'dry-run'?: boolean;
   allFormats?: boolean;
+  'all-formats'?: boolean;
 }
 export interface ValidateOptions extends GlobalOptions {
   strict?: boolean;
@@ -42,33 +48,39 @@ export interface ValidateOptions extends GlobalOptions {
   'constraints-dir'?: string;
   perf?: boolean;
   budgetTotalMs?: number;
+  'budget-total-ms'?: number;
   budgetPerBpMs?: number;
+  'budget-per-bp-ms'?: number;
   format?: 'text' | 'json';
   output?: string;
   receipt?: string;
   failOn?: 'off' | 'warn' | 'error';
+  'fail-on'?: 'off' | 'warn' | 'error';
   summary?: 'none' | 'table' | 'json';
 }
 export interface GraphOptions extends GlobalOptions {
   output?: string;
+  'constraints-dir'?: string;
   format?: 'dot' | 'mermaid' | 'json' | 'svg' | 'png';
-  imageFrom?: 'mermaid' | 'dot';
   filter?: string;
   hasse?: string;
-  filterPrefix?: string;
-  excludePrefix?: string;
-  onlyViolations?: boolean;
-  highlightViolations?: boolean;
-  violationColor?: string;
-  labelViolations?: boolean;
-  labelTruncate?: number;
-  minSeverity?: 'warn' | 'error';
+  // Kebab keys: the CLI parser runs with camel-case-expansion off.
+  'image-from'?: 'mermaid' | 'dot';
+  'filter-prefix'?: string;
+  'exclude-prefix'?: string;
+  'only-violations'?: boolean;
+  'highlight-violations'?: boolean;
+  'violation-color'?: string;
+  'label-violations'?: boolean;
+  'label-truncate'?: number;
+  'min-severity'?: 'warn' | 'error';
   focus?: string;
   radius?: number;
   tokens?: string;
 }
 export interface WhyOptions extends GlobalOptions {
   tokenId: string;
+  'constraints-dir'?: string;
   format?: 'json' | 'table';
 }
 export interface PatchOptions extends GlobalOptions {
@@ -81,6 +93,7 @@ export interface PatchApplyOptions extends GlobalOptions {
   patch: string; // path or inline patch JSON
   output?: string; // where to write updated tokens (if omitted, prints result)
   tokens?: string; // source tokens file (baseline)
-  dryRun?: boolean; // if true do not write
+  dryRun?: boolean; // if true do not write (programmatic callers)
+  'dry-run'?: boolean; // CLI key (camel-case-expansion off)
 }
 export type { Breakpoint };

package/cli/validate-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate-api.d.ts","sourceRoot":"","sources":["validate-api.ts"],"names":[],"mappings":"AAYA,OAAO,EAAiB,KAAK,SAAS,EAAkB,MAAM,oBAAoB,CAAC;AAEnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,8FAA8F;IAC9F,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kHAAkH;IAClH,WAAW,CAAC,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;IACvC,wHAAwH;IACxH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAyBD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,GAAE,aAAkB,GAAG,cAAc,CAkDlE"}
+{"version":3,"file":"validate-api.d.ts","sourceRoot":"","sources":["validate-api.ts"],"names":[],"mappings":"AAYA,OAAO,EAAiB,KAAK,SAAS,EAAkB,MAAM,oBAAoB,CAAC;AAEnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIzD,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,8FAA8F;IAC9F,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kHAAkH;IAClH,WAAW,CAAC,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;IACvC,wHAAwH;IACxH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qFAAqF;IACrF,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA6BD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,GAAE,aAAkB,GAAG,cAAc,CAkDlE"}

package/cli/validate-api.js

@@ -13,6 +13,7 @@ import fs from 'node:fs';
 import { flattenTokens } from '../core/flatten.js';
 import { Engine } from '../core/engine.js';
 import { loadConfig } from './config.js';
+import { validateConfig } from './config-schema.js';
 import { setupConstraints, collectReferencedIds } from './constraint-registry.js';
 import { formatViolation } from './json-output.js';
 function readTokensFile(p) {
@@ -29,7 +30,11 @@ function readTokensFile(p) {
 }
 function resolveConfig(input) {
     if (input.constraints !== undefined) {
-        return { constraints: input.constraints };
+        const { value, errors } = validateConfig({ constraints: input.constraints });
+        if (errors) {
+            throw new Error(`Inline constraints validation failed:\n  - ${errors.join('\n  - ')}`);
+        }
+        return value;
     }
     const res = loadConfig(input.configPath);
     if (!res.ok) {