tf-drift

Documentation Index

Project

Document Description
Changelog Tracks notable user-facing changes by release.
Contributing Explains local development, test expectations, and contribution rules.
Security Policy Explains supported versions and private vulnerability reporting.

Specs

Document Description
CLI Drift Detection Tool Defines the main CLI architecture, scan modes, drift classification, TUI behavior, and decision log.
Example Terraform Status Fixtures Defines the local Terraform examples used to demonstrate clean, planned, and error statuses.
Scheduled Release Automation Defines daily release automation, SemVer tag selection, GoReleaser behavior, and release edge cases.
Terraform Config Selection Defines interactive checkbox selection and CLI include/exclude filters for discovered configs.
TUI Style System Defines selectable modern, classic, minimal, and accessible TUI styles for interactive views.

Stories

Document Description
Config Selection Workflow Workflow story for narrowing detected configs before the worker pool runs.
CI Annotations and Rule Predicates Success Success story for SARIF output, predicate-based severity rules, OpenTofu fixtures, and monorepo docs.
Drift Classification Success Success story for separating external drift from normal pending Terraform/OpenTofu plan changes.
Example Status Fixtures Workflow Workflow story for providerless examples that validate mixed-status reporting.
Home Path Display Success Success story for shortening home-directory paths with ~ in human-facing output.
OpenTofu Engine Selection Success Success story for resolving Terraform or OpenTofu once before scanning layers.
Scheduled Release Automation Workflow Workflow story for daily release automation and the GitHub Actions failure modes it avoids.
TUI Style System Success Success story for centralizing TUI styling while preserving readable status labels and current controls.
Version Reporting Success Success story for consistent release and source-build version output through -version and -v.