Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .secrets.baseline

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

22 changes: 20 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Changelog
last_updated: 2026-10-27
last_updated: 2026-11-05
owner: TBD
audience: all
status: active
Expand All @@ -10,21 +10,36 @@ status: active

## [Unreleased]

## [8.0.0] - 2026-11-05

### Added

- **Zero Trust Developer Workstation Baseline**: Published `docs/security/DEVELOPER_WORKSTATION_GUIDE.md` establishing a vendor-agnostic Zero Trust client architecture (NIST SP 800-207) with full-disk encryption (FileVault, BitLocker, LUKS), hardware-backed keys (`ed25519-sk`), and MFA-enforced perimeter access.
- **Deterministic Make Toolchain Contract**: Standardized developer and automation entrypoints with `make doctor`, `make tools`, `make test-security`, and `make release-ready`.
- **Operational Scale & Sizing Boundaries**: Documented capacity ceilings for Bare Metal / VPS topologies (Brain: 1–3 High-Spec, 3–5 Low-Spec; Muscle: 50–100 workers) prior to hyperscale K8s orchestration.
- **Operational Scale & Sizing Boundaries**: Documented capacity ceilings for Bare Metal / VPS topologies (Brain: 1–3 High-Spec, 3–5 Low-Spec; Muscle: 50–100 workers) prior to hyperscale K8s orchestration in `docs/architecture/ARCHITECTURE.md`.
- **Automated Tailscale Serve UI Activation**: Integrated dynamic Tailscale Serve activation for Caddy WAF UI based on host group membership (`muscle`), eliminating per-host variable configuration.

### Changed

- **Unified NFTables Firewall Engine (Breaking)**: Standardized entire cluster exclusively on native `nftables`, completely purging legacy `ufw` and iptables wrappers across L1 OS baseline and L2 compliance. Added strict Molecule TDD assertions verifying `ufw` package removal and active `nftables.service`.
- **Ingress & Secrets Decoupling**: Decoupled `ingress_services` catalog from SOPS encryption into tracked `ingress.yml.example` and gitignored `ingress.yml` to prevent merge conflict friction and protect client domain confidentiality without encrypting non-secret routing topology.
- **Unified Caddyfile SSOT**: Removed `.example.j2` copy requirement in favor of a single tracked `Caddyfile.j2` incorporating global `metrics` directive aligned with upstream.
- **Upstream Caddy WAF Upgrade**: Pinned `ghcr.io/developmi/caddy-waf:v3.6.2` (Coraza v3.8.1, CRS v4) with cryptographic multi-arch sha256 digest validation.
- **Tailscale Configuration Centralization**: Consolidated Tailscale variables strictly under `inventory/group_vars/all/tailscale.yml` and SOPS secrets, eliminating redundant per-host overrides.

### Removed

- **Local Endpoint Hardening & Pop!\_OS Conditioning (Breaking)**: Completely purged `playbooks/ops/local-devices.yml` (-596 lines), `make deploy-local` target, `[local]` inventory groups, and Pop!\_OS desktop normalization hacks (`_os_family`) across Docker, Tailscale, and firewall rules in accordance with YAGNI and server-only scope.

### Fixed

- **Preflight Toolchain Compliance**: Replaced legacy `pip` reference in roadmap with `uv tool run` and documented upstream container entrypoint requirement in Twenty CRM compose worker.
- **Ansible Facts Consistency**: Standardized `ansible_date_time` references in Caddy roles to prevent undefined variable evaluations under gathered facts.

## [7.0.0] - 2026-10-27

### Added

- **Platform Hardening v2**:
- Configured post-quantum SSH key exchange algorithms (`sntrup761x25519-sha512@openssh.com`) alongside strict Curve25519 primitives.
- Implemented passwordless `sudo` privileges scoped strictly to `dev_admin`.
Expand Down Expand Up @@ -55,6 +70,7 @@ status: active
- Native Makefile targets: `sops-init`, `sops-edit`, `sops-encrypt`, and `sops-view`.

### Changed

- **Toolchain Modernization**: Upgraded runtime floor to Python `>=3.14`, pinned `ansible-core==2.21.1`, and aligned `ansible-lint==26.6.0`.
- **Backup Stack Pinning**: Pinned Restic binary and container image to `0.19.1` with per-architecture sha256 verification on AMD64 and ARM64.
- **CI/CD Hardening**:
Expand All @@ -64,12 +80,14 @@ status: active
- Pinned Gitleaks scanner to license-safe release `v8.23.3` with verified SHA256 checksums.

### Security

- **Supply Chain Vulnerability Eradication**:
- Regenerated lockfile dependencies (`uv.lock`) resolving 17 known vulnerabilities (1 CRITICAL, 6 HIGH) across transitive dependencies (`certifi`, `black`, `filelock`, `virtualenv`).
- Integrated `pip-audit==2.10.1` into `dev` dependency group and aligned local validation with GitHub Actions (`uv run pip-audit --path .venv`).
- Enforced pre-commit and CI secrets scanning baseline to guarantee zero plaintext credentials or unencrypted `.sops.yml` files enter version control.

### Removed

- Retired legacy `backup-db` role in favor of the unified L6 backup engine.
- Purged dead and orphaned secrets from templates and inventories (`portainer_url`, `portainer_username`, `portainer_password`, redundant observability network keys).
- Eliminated legacy unpinned `uvx` invocations in security workflows.
Expand Down
5 changes: 4 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

_A layered infrastructure stack built with Ansible, Docker and Zero Trust principles._

![Version 7.0.0](https://img.shields.io/badge/Version-7.0.0-0A84FF?style=for-the-badge&logo=semver&logoColor=white)
![Version 8.0.0](https://img.shields.io/badge/Version-8.0.0-0A84FF?style=for-the-badge&logo=semver&logoColor=white)
![Python 3.14](https://img.shields.io/badge/Python-3.14-3776AB?style=for-the-badge&logo=python&logoColor=white)
![Ansible Core 2.21.1](https://img.shields.io/badge/Ansible_Core-2.21.1-EE0000?style=for-the-badge&logo=ansible&logoColor=white)
![Docker Ready](https://img.shields.io/badge/Docker-Ready-2496ED?style=for-the-badge&logo=docker&logoColor=white)
Expand Down Expand Up @@ -374,6 +374,7 @@ Current quality gates include:
This project enforces end-to-end quality and compliance verification through a multi-tiered test pipeline spanning static validation, pre-commit hygiene, idempotency checks, and automated role/layer integration testing via **Molecule**:

### 1. Quality Gates & Linting

Validate syntax, role structure, YAML formatting, and GitHub Actions security workflows locally:

```bash
Expand All @@ -388,6 +389,7 @@ make precommit-run
```

### 2. Integration Testing with Molecule

Automated role and layer testing is executed via [Molecule](https://molecule.readthedocs.io/) using the Docker driver against systemd-enabled Debian 12 (`bookworm`) and Ubuntu 22.04 (`jammy`) containers. Each scenario exercises the complete verification lifecycle (`dependency` → `destroy` → `syntax` → `create` → `prepare` → `converge` → `idempotence` → `verify` → `cleanup` → `destroy`):

```bash
Expand All @@ -403,6 +405,7 @@ make test-layer LAYER=L4_networking
```

### 3. CI/CD & Security Audit Pipelines

- **Pull Request Gates:** [GitHub Actions](.github/workflows/ci.yml) validates playbook syntax, role directories, `ansible-lint`, `yamllint`, `gitleaks` credential scans, and workflow security audits via `zizmor` on every commit.
- **Security Audit Gates:** A dedicated [security-audit.yml](.github/workflows/security-audit.yml) workflow runs on PRs and release tags (`v*`), executing credential pattern scans, SOPS value leak checks, and dependency vulnerability scans (`uv run pip-audit --path .venv`).

Expand Down
6 changes: 3 additions & 3 deletions docs/operations/DEVELOPER_SETUP.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@ title: Developer Onboarding
type: operations
owner: maintainers
audience: maintainer
version: v7.0.0
last-reviewed: 2026-10-27
version: v8.0.0
last-reviewed: 2026-11-05
status: active
project: developmi-hardened
repo: github.com/Developmi/hardened
---

# Developer Onboarding - Developmi Hardened v7.0.0
# Developer Onboarding - Developmi Hardened v8.0.0

5-step developer setup sequence to go from zero to running your first Ansible playbook.

Expand Down
6 changes: 3 additions & 3 deletions docs/project/RELEASE.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,16 +3,16 @@ title: Release Procedure
type: project
owner: maintainers
audience: maintainer
version: v7.0.0
last-reviewed: 2026-10-27
version: v8.0.0
last-reviewed: 2026-11-05
status: active
project: developmi-hardened
repo: github.com/Developmi/hardened
---

# Release Procedure

Current latest release: `v7.0.0` (see [CHANGELOG.md](../../CHANGELOG.md) for the full history).
Current latest release: `v8.0.0` (see [CHANGELOG.md](../../CHANGELOG.md) for the full history).

This document defines the standard process for all future releases.

Expand Down
6 changes: 3 additions & 3 deletions docs/project/ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,8 @@ title: Development Roadmap
type: project
owner: maintainers
audience: all
version: v6.0.0-dev
last-reviewed: 2026-07-23
version: v8.0.0
last-reviewed: 2026-11-05
status: active
project: developmi-hardened
repo: github.com/Developmi/hardened
Expand Down Expand Up @@ -182,7 +182,7 @@ This project starts at v6.0.0. Prior development history (v1.0.0 - v5.5.0) is ma

### Planned Release Target

- `v7.0.0` - Policy maturity, scale readiness, and automation infrastructure.
- `v8.0.0` - Production-ready bare metal & VPS hardening suite with native nftables, unified restic backup engine, decoupled ingress catalog, and zero-trust workstation baseline.

## Future Implementations (Backlog)

Expand Down
2 changes: 1 addition & 1 deletion inventory/group_vars/all/main.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
# Platform metadata
platform_name: "Developmi Hardened"
platform_version: "v7.0.0-dev"
platform_version: "v8.0.0"

# Shared external Docker network (L3 observability stack, L4 caddy, L6 portainer)
shared_network_name: "public_net"
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "developmi-hardened"
version = "7.0.0"
version = "8.0.0"
description = "Ansible-driven hardening suite for Bare Metal infrastructure"
readme = "README.md"
requires-python = ">=3.14"
Expand Down
2 changes: 1 addition & 1 deletion roles/L1_os_baseline/defaults/main.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ l1_apt_lock_timeout: 600
l1_file_mode: "0644"

platform_name: "Developmi Hardened"
platform_version: "v7.0.0-dev"
platform_version: "v8.0.0"
motd_clean_ads: true

systemd_nofile_soft: 1024
Expand Down
4 changes: 2 additions & 2 deletions roles/L1_os_baseline/general/tasks/motd_banner.yml
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@
content: |
==============================================================================
Stack Developmi
{{ platform_version | default('v7.0.0-dev') }}
{{ platform_version | default('v8.0.0') }}
==============================================================================
Authorized access only. All activities are monitored and logged.
mode: "0644"
Expand All @@ -55,7 +55,7 @@
content: |
******************************************************************************
* DEVELOPMI PLATFORM HARDENED *
* {{ platform_version | default('v7.0.0-dev') }} *
* {{ platform_version | default('v8.0.0') }} *
* *
* UNAUTHORIZED ACCESS TO THIS SYSTEM IS STRICTLY PROHIBITED BY LAW. *
* ALL CONNECTIONS AND ACTIVITIES ARE LOGGED AND MONITORED. *
Expand Down
2 changes: 1 addition & 1 deletion uv.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading