Skip to content

v1.0.0

Latest
Latest

Choose a tag to compare

View all tags
@zamdevio zamdevio released this 09 Jul 04:44
v1.0.0
3eeb5cf

expgov v1.0.0

First stable release of export-governance for TypeScript SDK barrels — inventory, diff, validate, trend, timeline, and graph. Read-only by default except init.

Docs: https://expgov.pages.dev

Install

# CLI (devDependency — command is still `expgov`)
pnpm add -D @expgov/cli

# SDK only — programmatic runExports* APIs
pnpm add -D @expgov/core
expgov init
expgov validate
expgov inventory

npm packages (both 1.0.0)

Package Role
@expgov/cli expgov binary + @expgov/cli/core config types
@expgov/core SDK engine without the CLI binary

Config authors:

import { defineConfig, type ExpgovConfig } from '@expgov/cli/core';

Why @expgov/cli (not expgov)?

npm rejected the unscoped name expgov as too similar to expo. The CLI publishes under the @expgov org scope; the command name stays expgov.

Details: https://expgov.pages.dev/install

What’s in v1.0.0

  • Full CLI: init, inventory, diff, validate, doctor, suggest, trend, timeline, graph, version, help
  • Tier governance — @sdkTier JSDoc + nested tiers.* config buckets
  • tsconfig paths ↔ npm exports parity checks
  • Per-SHA cache (.expgov/cache/) with worktree freshness gate
  • Stable --json envelopes for CI
  • VitePress docs site at expgov.pages.dev
  • Example SDK fixture in examples/sdk/

Fixes since 0.0.1

  • expgov version --check queries @expgov/cli on the npm registry (not unscoped expgov)
  • Update install hints use pnpm add -g @expgov/cli@latest
  • expgov init scaffolds import from '@expgov/cli/core'

v1 contract

  • Stable: CLI argv, --json envelope shape, exit codes
  • Additive minors OK: new commands, flags, and @expgov/core exports
  • Major bump required for breaking CLI or SDK contract changes

Backlog items (graph filters, multibarrel, fix, issues) are planned as additive layers on top of this surface.

Publish (maintainer)

cd packages/core && pnpm publish --access public   # @expgov/core@1.0.0
cd ../.. && pnpm publish --access public            # @expgov/cli@1.0.0

Links

Assets 2
Loading