v0.15.0
govctl v0.15.0
0.15.0 introduces first-class Conformance Cases for tracing versioned RFC
requirements to project-owned scenarios and reusable verification guards. It
also establishes a canonical-only compatibility baseline ahead of 1.0, adds
low-noise agent introspection, and refreshes the read-only governance TUI.
Added
- Added
conformanceas a first-class resource withnew,list,get,
show,edit, anddeletecommands. Cases declare a stable relationship
between versioned RFC Clauses, project scenarios, and reusable Guards without
becoming normative authority or a test runner. - Added
govctl conformance tracewith deterministic table and JSON output,
requirement and Guard filters, and provisional, candidate, current, and stale
applicability states. - Added project schema version 4 for Conformance Case storage and validation,
including transactional migration from schema version 3. - Integrated Conformance Cases into validation, search, tags, status, command
discovery, shell completion, and the TUI. - Added repository-owned Conformance Cases that exercise the traceability model
against representative govctl integration scenarios.
Changed
govctl describenow emits versioned, parser-owned command metadata and can
include concise actionable project context with--context.- Bundled skills and reviewer agents now use compact policy-and-discovery
guidance. Heavyweight Guards are selected per Work Item unless they are truly
universal project defaults. - Misrouted Clause operations now fail with the corresponding canonical
govctl clausecommand instead of leaving agents to guess the namespace. - The TUI now presents aligned lifecycle matrices, separate execution and
diagnostic regions, a dedicated filter strip, stable scroll indicators, and
consistent wide and narrow layouts. - Project status now includes rejected ADRs, Verification Guard totals, and
release totals.
Removed
- Removed compatibility command aliases, field-path aliases, wire-layout
prefixes such ascontent.,govctl., andcheck., and resource-specific
mutation flags superseded by the canonicaleditinterface. - Removed legacy flat RFC and Clause TOML readers, ignored legacy fields,
obsolete migration steps, and pre-schema-3 signature inference. - Removed the unsupported
govctl adr deprecatecommand.
Fixed
- Project discovery, explicit configuration, and forced initialization no longer
fall through to an ancestor project when local governance state is incomplete
or incompatible. - RFC loading, Clause loading, and amendment signatures now cover every stored
Clause while rejecting dangling and storage-escaping paths. - Artifact creation, deletion, migration, and dry-run paths perform equivalent
validation and preserve prior state when a multi-file operation fails. - Conformance Case mutations validate the target and direct dependencies
without making unrelated invalid Cases impossible to repair. - Invalid edit paths now list valid fields, and unsupported operations identify
the permitted operations for the addressed path. - TUI filtering, lifecycle styling, navigation hints, search navigation, and
narrow-layout rendering now remain consistent across supported resources.
Security
- RFC and Clause creation and loading reject path traversal and any Clause
storage that resolves outside its containing RFC directory before mutation.
Upgrade Notes
- Run
govctl migrateto upgrade a schema version 3 repository to schema
version 4, then rungovctl check. - Repositories below schema version 3 must first be upgraded with a compatible
earlier govctl release. Legacy RFC or Clause JSON storage is now rejected
explicitly instead of being ignored. - Replace removed mutation aliases and storage-layout paths with
govctl <resource> edit <id> <path> <operation>. Clause operations always use
the rootgovctl clausenamespace.
Full Changelog: v0.14.2...v0.15.0