Skip to content

v0.15.0

Choose a tag to compare

@github-actions github-actions released this 27 Jul 12:52
· 7 commits to main since this release

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 conformance as a first-class resource with new, list, get,
    show, edit, and delete commands. 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 trace with 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 describe now 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 clause command 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 as content., govctl., and check., and resource-specific
    mutation flags superseded by the canonical edit interface.
  • 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 deprecate command.

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 migrate to upgrade a schema version 3 repository to schema
    version 4, then run govctl 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 root govctl clause namespace.

Full Changelog: v0.14.2...v0.15.0