Plans

Every feature in this project was designed before it was built.

This is the complete record of that discipline — design and implementation plans spanning the full development history of the project. Each plan started as a brainstorming session to explore the problem space, followed by a design document to lock in the approach, and finally a step-by-step implementation plan executed through test-driven development.

No feature shipped without a plan, no plan shipped without a design, and no design shipped without understanding the problem first.

2026-01-26 Checkers Test Suite Restructure Implementation Plan
2026-01-26 Notify App Test Restructure Plan
2026-01-28 Intelligence App Restructure Implementation Plan
2026-01-29 Reusable Pipelines Implementation Plan
2026-02-02 Run Pipeline Definitions CLI Implementation Plan
2026-02-02 Run Pipeline Definitions via CLI
2026-02-03 Sample Pipeline Definitions Implementation Plan
2026-02-06 Progress Messages for `get_recommendations` Command
2026-02-06 Spinner Progress for `get_recommendations` Command
2026-02-09 Interactive CLI for Server Maintenance
2026-02-10 Alerts App Test Restructure
2026-02-10 Orchestration App Test Restructure
2026-02-11 Disk Analysis Checkers
2026-02-13 Admin Ops Console Design
2026-02-14 Admin Ops Console Implementation Plan
2026-02-15 JSON Widget Design
2026-02-15 JSON Widget Implementation Plan
2026-02-15 README Badges Design
2026-02-15 README Badges Implementation Plan
2026-02-16 AnalysisRun Audit Logging Implementation Plan
2026-02-16 AnalysisRun Audit Logging via `BaseProvider.run()`
2026-02-17 CPU Multi-Sample Measurement Design
2026-02-17 CPU Multi-Sample Measurement Implementation Plan
2026-02-18 Architecture Documentation Restructure Design
2026-02-18 Architecture Documentation Restructure Implementation Plan
2026-02-19 Setup Instance Wizard — Implementation Plan
2026-02-19 Setup Instance — Pipeline Configuration Wizard
2026-02-22 Node Handlers Documentation Update — Design
2026-02-22 Node Handlers Documentation Update — Implementation Plan
2026-02-22 Real Node Handlers for Definition-Based Pipeline
2026-02-23 Add setup_aliases.sh to install.sh — Design
2026-02-23 Installation Docs Update — Design
2026-02-25 Database-Driven Intelligence Providers — Design
2026-02-25 Database-Driven Intelligence Providers — Implementation Plan
2026-03-01 Interactive test_notify Implementation Plan
2026-03-01 Interactive test_notify — Design
2026-03-01 Pipeline Inspector Implementation Plan
2026-03-01 Pipeline Inspector — Design
2026-03-02 System Checks Expansion — Design
2026-03-02 System Checks Expansion — Implementation Plan
2026-03-03 Notification Template Normalization — Design
2026-03-03 Notification Template Normalization — Implementation Plan
2026-03-05 Test Suite Speedup — Design
2026-03-05 Test Suite Speedup — Implementation Plan
2026-03-06 Env Cleanup Design
2026-03-06 Env Cleanup Implementation
2026-03-06 GitHub Pages Design
2026-03-06 GitHub Pages Implementation Plan
2026-03-07 Config Directory Cleanup Design
2026-03-07 Templating Test Coverage Design
2026-03-09 Management Commands Coverage Design
2026-03-09 Management Commands Coverage Implementation
2026-03-09 Orchestrator Coverage Design
2026-03-13 Remove check_and_alert Implementation Plan
2026-03-13 Remove check_and_alert, Absorb into run_pipeline
2026-03-15 Remove alerts/tasks.py Implementation Plan
2026-03-15 Remove apps/alerts/tasks.py — Route Async to Orchestration App
2026-03-17 Security Hardening Implementation Plan
2026-03-17 Security Hardening for Internet-Exposed Deployment
2026-03-22 Deployment Documentation Design
2026-03-22 Deployment Documentation Implementation
2026-03-26 Docker Install Automation
2026-03-26 Docker Install Automation — Implementation
2026-03-27 bin/ Re-engineering
2026-03-27 bin/ Re-engineering Phase 1 — Implementation
2026-03-27 bin/ Re-engineering Phase 2 — Implementation
2026-03-29 Cluster Alert Driver
2026-03-29 Cluster Alert Driver — Implementation
2026-03-29 Security CI Pipeline
2026-03-29 Unified Health Check
2026-03-29 Unified Health Check — Implementation
2026-03-30 Auto-Update Script Design
2026-03-30 Auto-Update Script Implementation Plan
2026-03-30 Security Check Script Design
2026-03-30 Security Check Script Implementation Plan
2026-03-31 Separate Environment from Deployment Method
2026-04-02 Cluster Setup Installer Implementation Plan
2026-04-02 Cluster Setup Installer Integration & Docs
2026-04-02 Set Production Helper Design
2026-04-04 Install Profile Design
2026-04-04 Install Profile Plan
2026-04-04 Installer Refactor Design
2026-04-04 Installer Refactor Plan
2026-04-05 Logging and Update History Design
2026-04-05 System Status Command Design
2026-04-05 System Status Command Implementation Plan
2026-04-05 Unified Preflight Design
2026-04-05 Unified Preflight Implementation Plan
2026-04-11 Path Traversal Prevention Design
2026-04-11 Path Traversal Prevention Implementation Plan
2026-04-12 SSRF Prevention Design
2026-04-12 SSRF Prevention Implementation Plan
2026-04-13 Auth Enabled by Default Design
2026-04-13 Auth Enabled by Default Implementation Plan
2026-04-13 Provider kwargs SSRF Prevention Design
2026-04-15 SSTI Notify Template Fix Design
2026-05-05 Reboot Debian Checker Implementation Plan
2026-05-05 Reboot Required Checker (Debian Family) Design
2026-05-06 Disk Checker Output Reconciliation Design
2026-05-06 Disk Checker Output Reconciliation Implementation Plan
2026-05-07 Disk Checkers: Global Sort Across Scan Targets Design
2026-05-07 Disk Checkers: Global Sort Implementation Plan
2026-05-07 run_check Disk Formatter Design
2026-05-07 run_check Disk Formatter Implementation Plan
2026-05-09 Disk Checker Consolidation Design
2026-05-09 Disk Checker Consolidation Implementation Plan
2026-05-09 Disk Cleanup Recommendations Implementation Plan
2026-05-09 Disk Cleanup Recommendations: Richer Format + More Rules Design
2026-05-10 Interactive CLI Restructure Design
2026-05-10 Interactive CLI Restructure Implementation Plan
2026-05-12 ISO 27003 Security Audit Notes
2026-05-24 CVE-2026-45409 idna 3.11 → 3.15 Bump
2026-05-24 CVE-2026-45409 idna 3.11 → 3.15 — Implementation
2026-05-25 Align Agentic MD Files (CLAUDE.md, AGENTS.md, GEMINI.md)
2026-05-25 Align Agentic MD Files — Implementation
2026-05-30 Cluster Topology — Deprecation Decision
2026-05-31 Observability Over-build — Post-mortem
Base Admin Hardening — Operations Surface
Enrich listening ports with owning process
Fix main: green CI + Security
Guided Cluster Setup — Design (Phase 3c)
Hub-side Per-Node Severity Re-evaluation
Hub-side Per-Node Severity Re-evaluation — Implementation Plan
Peer Node Model + Unified Control Plane — Architecture
Per-node listening_ports allowlist re-evaluation
Phase 2: Notify Content Decoupling — Implementation Plan
Phase 3a: Retire CLUSTER_ENABLED + conflict role — Implementation Plan
Phase A: Pipeline Routing Spine — Implementation Plan
Phase B: Pipeline Shape from Flags — Implementation Plan
Phase C: Durable Ingest + Inbox + Drain — Implementation Plan
Phase D: Retire the Graph Engine + Journey/Report Views — Implementation Plan
Pipeline Routing — North-Star Architecture
Push Log Summary (de-bloat push.log)
Push Log Summary Implementation Plan
RAID (mdadm) Health Checker Design
RAID (mdadm) Health Checker Implementation Plan
Re-evaluate Existing Alerts on Config Change — Implementation Plan
Re-evaluate Existing Alerts on Node Config Change
Re-pin vendored tuin to v0.1.0
Thermal & IO Checkers (disk_temp, cpu_temp, io_strain)
Unified Auth + Cluster-as-Driver — Design
Unified Auth + Cluster-as-Driver — Implementation Plan (Slice A)
Update Aliases Follow-up Implementation Plan
Update Aliases Follow-up: Remove Duplication, Cover Skip Paths Design
disk_temp Checker Implementation Plan
tuin as the bin/cli.sh UI
tuin as the bin/cli.sh UI — Implementation Plan

Plans

Table of contents