Architecture Decision Records

Architecture Decision Records

Architecture Decision Records preserve the reasoning behind consequential technical and process decisions in bashdeps. They document the constraints, tradeoffs, rejected alternatives, compatibility expectations, and failure models that shape both bashdeps.bash and manifest-manager.bash.

The repository uses several complementary documentation layers:

• ADRs explain why durable architectural decisions exist and what constraints follow from them.
• `doc/decisions.md` provides concise summaries and navigation for the decision corpus.
• `doc/bashdeps-spec.md` describes the accepted runtime behavior of bashdeps.bash.
• `doc/manifest-manager-spec.md` describes the accepted maintainer-facing behavior of manifest-manager.bash.
• `doc/standards/bash/documentation-standard.md` governs source documentation for new maintained Bash work in this repository.
• Doxygen reference pages preserve implementation-level contracts close to the maintained source.

The ADRs remain authoritative when a shorter summary or generated navigation surface appears to disagree with them.

Index

• ADR-000: Capability Scope, Epistemic Honesty, and Separation of Concerns
• ADR-001: Define bashdeps Scope and Trust Boundary
• ADR-002: Define the Dependency Manifest Grammar
• ADR-003: Define Install, Sync, and Verify Semantics
• ADR-004: Define Network Acquisition Policy
• ADR-005: Define Filesystem and Publication Safety
• ADR-006: Define Runtime Platform and Tool Capabilities
• ADR-007: Define CLI, Diagnostics, and Exit Statuses
• ADR-008: Define Bootstrap and Make Integration
• ADR-009: Define Build and Release Artifact Contract
• ADR-010: Define Development and Testing Workflow
• ADR-011: Define Public Interface Boundary
• ADR-012: Define Wget Capability Floor
• ADR-013: Default Destination Root with Explicit Override
• ADR-014: Documentation-First Source Code Commenting Standard
• ADR-015: Define Manifest Physical-Line Folding
• ADR-016: Define the Doxygen Reference Documentation Workflow
• ADR-017: Self-Host Build and Development Dependency Management
• ADR-018: Three-Flavor Release Artifacts with Bash-Minifier
• ADR-019: Standardize SHA-256 Checksum Companion Filenames
• ADR-020: Ship Manifest Manager and Define Surgical Updates
• ADR-021: Extend Manifest Manager with List, Add, and Remove
• ADR-022: Publish an Ephemeral Generated ADR Landing Page
• ADR-023: Add Supplemental Upstream SHA-256 Verification
• ADR-024: Adopt Shared Coding Standards
• ADR-025: Consolidate Scheduled GitHub Actions Dependency Updates

Related Documentation

For a shorter decision-oriented view, see `doc/decisions.md`. Product behavior is documented in `doc/bashdeps-spec.md` and `doc/manifest-manager-spec.md`.

This landing page is generated during documentation builds from maintained ADRs and these framing files. The generated README.md is intentionally not a maintained source artifact.