expgov

Appearance

validate ​

Governance checks on the working tree. Exits 0 on pass, 1 on fail.

bash
expgov validate
expgov validate -v
expgov validate -T 5
expgov validate -F
expgov validate --since v1.0.0
expgov validate --since v1.0.0 -j

Checks include:

  • tsconfig path ↔ package.json exports parity
  • Unclassified root flat exports
  • Internal/advanced symbols still flat on the root barrel

Compat baseline (--since / git.compatBaseline) ​

Compare the working tree against a git baseline (tag, branch, or SHA). Fail when:

  1. Any current-tree validate check fails (same as bare validate), or
  2. Any flat export was removed relative to that baseline (same gate as diff --fail-on-removed)

Additions are allowed. Prefer an immutable released tag.

Sources (CLI wins):

  1. --since <ref> on the command line
  2. Else git.compatBaseline in expgov.config.ts — a ref or 'latest-tag' (newest tag matching git.tagPattern)
ts
git: {
  tagPattern: 'v*',
  compatBaseline: 'v1.0.0', // or 'latest-tag'
},
bash
# One-command PR / CI gate (explicit)
expgov validate --since v1.0.0

# Same gate when config supplies compatBaseline — omit the flag
expgov validate

# Machine-readable
expgov validate --since v1.0.0 -j

JSON includes data.since, data.sinceLabel, data.added, data.removed, and removal issues use code expgov.diff.exports_removed (alongside expgov.validate.violation for other failures). See JSON output and workflows.

--since / compatBaseline require a commit ref — not worktree / wt.