# Changelog

This file tracks the changes introduced by gittuf versions.

## v0.14.1

This release ships some small improvements, and fixes security vulnerabilities
in dependencies. See the release notes on GitHub for more information.

### Added

- Added unit tests for the TUI

### Updated

- Increased testing coverage for remote policy synchronization and gitinterface
- Fixed issue with git-remote-gittuf and pruning remote branches
- Updated various dependencies

## v0.14.0

This release improves our testing coverage, makes various improvements across
the codebase, and removes support for the legacy securesystemslib key format.
This release also fixes security vulnerabilities, see the advisories on GitHub
for more information. 

### Added

- Added support for filtering the RSL by target reference of entries
- Added testing for gittuf in CI on FreeBSD
- Added fixes to prevent policy rollback attacks via RSL
- Added missing validation when loading first policy state 

### Updated

- Improved checks for invalid thresholds
- Improved reliability of integration with the gittuf GitHub app
- Improved CLI documentation
- Increased testing coverage significantly across multiple packages
- Updated various dependencies and CI workflows

### Removed

- Removed support for legacy securesystemslib key formats, used in early alpha
  builds of gittuf

## v0.13.1

This release is a follow-up to v0.13.0 to fix our releasing pipeline. Starting
with this release, gittuf releases now ship with attested SBOMs and build
provenance.

### Updated

- Updated a test for invalid RSL recovery
- Updated various dependencies and CI workflows

## v0.13.0

### Added

- Added support for signing gittuf metadata with GPG keys
- Added a new read-only mode to the TUI to allow viewing gittuf metadata
- Added support for listing propagation directives and a duplicate check
- Added documentation on extracting gittuf attestations data from the repository

### Updated

- Updated Sigstore dependency
- Fixed Git GPG key configuration parsing issue
- Added check to prevent reinitializing gittuf metadata when it already exists
- Updated documentation for OSPS Baseline compliance
- Updated the getting started guide
- Updated documentation with various quality fixes
- Updated various dependencies and CI workflows

### Removed

- Removed support for online verification from Sigstore, as it was removed
  upstream

## v0.12.0

### Added

- Added CLI documentation for various commands
- Added support for updating propagation directives
- Added support for updating persons in gittuf metadata
- Added support for resetting gittuf's persistent cache

### Updated

- Moved various functionality out of developer mode
- Fixed issue with gittuf verification and propagation entries
- Fixed color gittuf output in some environments
- Updated various dependencies and CI workflows

## v0.11.0

### Added

- Added support for verifying policy status of repository's network for a
  controller
- Added long descriptions for various gittuf CLI commands
- Added support for shallow fetches in gitinterface
- Added support for propagating specified subtree from upstream repository
- Added CI workflow to verify repository's gittuf policy

### Updated

- Improved test coverage for GitHub attestations
- Moved persistent caching out of developer mode
- Updated security insights documentation with project's dependency policy
- Updated documentation to indicate promotion to incubating status
- Updated documentation to indicate Go setup requirements
- Updated various dependencies and CI workflows

## v0.10.2

### Updated

- Updated how GitHub API tokens are loaded to prevent issues with expiry
- Updated release workflow to replace deprecated option

## v0.10.1

### Added

- Added a `HasPolicy` API to check if a repository has gittuf policy defined
- Added documentation on how to inspect gittuf metadata
- Added `gittuf trust inspect-root` to pretty-print repository's root of trust
  metadata
- Added long documentation for some gittuf commands
- Added global rules support to TUI

### Updated

- Updated tests and generic set implementation used internally
- Updated documentation with typo fixes and Slack information
- Updated release workflow to automatically bump gittuf's Winget package
- Updated various dependencies and CI workflows

## v0.10.0

Starting with this release, gittuf is now in beta!

### Added

- Added a sync workflow that updates gittuf metadata as needed before making
  policy changes
- Added functionality to list and update global rules
- Added support to the API for loading repositories in a specified directory
- Added features and workflows to support deploying gittuf over multiple
  repositories
- Added gittuf hooks, which enable support for user-defined checks in gittuf
  metadata that are run in a sandboxed lua environment

### Updated

- Set v02 of gittuf's metadata as the default
- Made Fulcio support no longer restricted to developer mode
- Updated the policy staging and apply workflows to now use the sync workflow
- Updated gitinterface to now support systems with different locales than en_US
- Updated gittuf's roadmap
- Updated various dependencies and CI workflows

## v0.9.0

### Added

- Added a terminal UI (TUI) to enable managing gittuf policy interactively
- Added global rules to set thresholds and prohibit force pushes to help set
  security baselines in repositories with gittuf
- Added workflows to support synchronizing/propagating policy and RSL changes
  across multiple repositories
- Added local persistent cache functionality to reduce the time taken for
  verification of a repository after successful initial verification
- Added functionality to set a repository's canonical location in gittuf
  metadata
- Added a control for RSL recording to skip checking for duplicates
- Added the gittuf Augmentation Process (GAP) for formalizing changes to gittuf
- Added color output for various gittuf logging flows
- Added functionality to discard currently staged changes to policy
- Added functionality to remove principals and keys no longer used by rules in
  the metadata

### Updated

- Updated RSL printing to now use buffered output, improving performance
- Improved testing coverage of `gitinterface`
- Updated the design document for clarity and to reflect recent changes to
  gittuf
- Updated various dependencies and CI workflows

## v0.8.1

- Fixed loading of legacy ECDSA key format
- Replaced `show` with `rev-parse` in some gitinterface APIs
- Added gittuf/demo run to CI
- Updated various dependencies and CI workflows

## v0.8.0

- Added an experimental gittuf Go API
- Added an experimental version (`v0.2`) of policy metadata, which adds support
  for "principals" in gittuf
- Added an experimental flow to determine a feature ref's mergeability
- Optimized some preprocessing flows in the `policy` package
- Improved gittuf's design documentation
- Improved testing coverage of `gittuf` and `rsl`
- Fixed an internal issue with git-remote-gittuf and Go's builtin max
- Fixed issue with `git-remote-gittuf` with server responses on push
- Fixed issue with `git-remote-gittuf` when pushing to a remote repository
  without gittuf enabled
- Fixed issue with `git-remote-gittuf` freezing upon failure to authenticate
  with the remote repository when using HTTP
- Updated various dependencies and CI workflows

## v0.7.0

- Added support for metadata signing using Sigstore (currently `GITTUF_DEV`
  only)
- Removed use of legacy custom securesystemslib key formats in gittuf's tests
- Removed vendored signerverifier library
- Unified SSH signature verification for Git commits and tags
- Refactored `policy` and `tuf` packages to support versioning policy metadata
- Updated various dependencies and CI workflows

## v0.6.2

- Added `git-remote-gittuf` to the release workflow's pre-built artifacts
- Updated CI workflow dependency

## v0.6.1

- Added a counter to RSL entries to support persistent caching
- Added experimental support for signature extensions to vendored DSSE library
- Refactored `GetLatestReferenceEntry` RSL API
- Fixed Makefile build on Windows
- Moved `update-root-threshold` and `update-policy-threshold` out of developer
  mode
- Fixed issue with git-remote-gittuf using the wrong transport when fetching the
  RSL
- Fixed issue with git-remote-gittuf when explicitly pushing the RSL
- Fixed issue with git-remote-gittuf and `curl` fetches and pushes on Windows
- Increased testing coverage of `policy` and `gitinterface`
- Improved documentation for getting started with gittuf, especially on Windows
  platforms
- Added copyright notices to code files
- Updated various dependencies and CI workflows

## v0.6.0

- Added command to reorder policy rules
- Added support for older Git versions
- Added support for GitHub pull request approval attestations
- Added support for using enterprise GitHub instances
- Added caching for the RSL APIs `GetEntry` and `GetParentForEntry`
- Added parallelization for some unit tests
- Removed some deprecated flows such as `FindPublicKeysForPath` and refactored
  verification APIs
- Added CodeQL scanning for the repository
- Updated various dependencies and CI workflows

## v0.5.2

- Fixed issue with git-remote-gittuf when force pushing 
- Fixed issue with git-remote-gittuf not fetching RSL before adding new entries
- Updated various dependencies

## v0.5.1

- Updated release workflow to support GoReleaser v2

## v0.5.0

- Added support for `ssh-keygen` based signer and verifier
- Added support for overriding reference name when local and remote reference
  names differ
- Added initial (alpha) implementation of git-remote-gittuf
- Added command to display RSL
- Added support for automatically skipping RSL entries that point to rebased
  commits
- Updated policy verification pattern matching to use `fnmatch`
- Updated to use Git binary for various operations on underlying repository
- Updated various dependencies and CI workflows
- Updated docs to make command snippets easier to copy
- Removed extraneous fields from gittuf policy metadata
- Removed `verify-commit` and `verify-tag` workflows in favor of `verify-ref`
  (BREAKING CHANGE)
- Governance: added Patrick Zielinski and Neil Naveen as gittuf maintainers

## v0.4.0

- Added support for `policy-staging` for sequential signing of metadata to meet
  a threshold
- Added support for minimum required signatures for rules
- Added support for profiling with pprof
- Added `--from-entry` to `verify-ref`
- Added debug statements for `--verbose` flag
- Added caching of verifiers for each verified namespace (reference or file
  path) to avoid repeated searches of the same policy state
- Added separated `add-rule` and `update-rule` workflows for policy
- Added dogfooding plan
- Added CI workflows for phase 1 of dogfooding
- Added OpenSSF Scorecard for the repository
- Updated policy to require each rule name to be unique across all rule files
- Updated file rules verification to use same policy as branch protection rules
  verification
- Update reference authorization attestations to use merge tree for the change
  being authorized
- Updated design document with definitions and a diagram
- Updated tag verification to check the tag's RSL entry points to either the tag
  object or the tag's target object
- Updated roadmap to indicate status for each item
- Updated minimum Go version to 1.22
- Updated pointer to gittuf community details
- Updated various dependencies and CI workflows

## v0.3.0

- Added check to prevent duplicate RSL entries for the same ref and target
- Added a formal developer mode for new early-stage gittuf features
- Added early support for attestations with one type for approving reference
  changes (developer mode only)
- Added support for gittuf-specific Git hooks with a pre-push hook to fetch /
  create / push RSL entries
- Updated `verify-ref` to perform full verification by default (BREAKING CHANGE)
- Updated identification of trusted keys in policy to support varying threshold
  values between delegations
- Added verification tests for delegated policies
- Added root key management commands to the CLI
- Added command to list rules in gittuf policy
- Added support for standard encoding of private and public keys
- Added support for verifying SSH Git commit and tag signatures
- Added check for cycles when walking policy graph during verification
- Added autogenerated CLI docs
- Removed file rule verification when no file rules exist in the policy for
  efficiency
- Added command to sign existing policy file with no other changes
- Added get started guide and gittuf logo to docs
- Removed CLI usage message for gittuf errors
- Updated various dependencies

## v0.2.0

- Added support to RSL to find unskipped entries
- Added `Get*` functions to gitinterface to compartmentalize choice of Git
  library
- Added support in RSL and policy functions for RSL annotation entries
- Added recovery mode for policy verification workflow
- Added `go fmt` as Makefile target
- Updated length of refspecs slice to account for doubled entries
- Added support for merge commits in gitinterface
- Updated CLI to check if Git signing is viable to abort early
- Fixed bug in CLI that required an unnecessary signing key argument
- Fixed `clone`'s ability to handle trailing slashes
- Improved testing for in policy verification for delegations
- Added plumbing for better logging
- Updated various dependencies
- Updated installation instructions to include Sigstore verification of binaries

## v0.1.0

- Implemented reference state log (RSL)
- Added support for Git reference policies using RSL entry signatures
- Added support for file policies using commit signatures
- Added support for basic gittuf sync operations
