1 files changed, 84 insertions, 0 deletions
diff --git a/docs/design/2026-07-14-undeclared-packages-evidence.org b/docs/design/2026-07-14-undeclared-packages-evidence.org
new file mode 100644
index 0000000..86fa0aa
--- /dev/null
+++ b/docs/design/2026-07-14-undeclared-packages-evidence.org
@@ -0,0 +1,84 @@
+#+TITLE: Undeclared ratio packages — include/ignore evidence
+#+AUTHOR: Craig Jennings
+#+DATE: 2026-07-14
+
+Evidence sweep for the "Review undeclared ratio packages for installer inclusion" task. Source: =make package-diff= run on ratio 2026-07-14 (64 explicit packages installed but not declared; the June run saw 62). Per package: pacman's description, what requires it (dependency vs standalone), and the install date. The include/ignore decisions are Craig's; the buckets below carry the default lean.
+
+Rerun =make package-diff= after any include pass to confirm the count drops.
+
+** Candidates to declare (30)
+Explicitly installed apps and tools with nothing requiring them. Each needs Craig's include/ignore call.
+- =aws-cli-v2= :: Universal Command Line Interface for Amazon Web Services (version 2) · installed 2026-04-25
+- =baobab= :: A graphical directory tree analyzer · installed 2026-07-08
+- =bats= :: Bash Automated Testing System · installed 2026-04-21
+- =blueman= :: GTK+ Bluetooth Manager · installed 2026-01-25
+- =drawio-desktop= :: Official Electron build of draw.io · installed 2026-07-08
+- =emacs= :: The extensible, customizable, self-documenting real-time display editor · installed 2026-05-03
+- =flatpak= :: Linux application sandboxing and distribution framework (formerly xdg-app) · installed 2026-06-13
+- =geeqie= :: Lightweight image viewer · installed 2026-07-13
+- =git-lfs= :: Git extension for versioning large files · installed 2026-04-24
+- =github-cli= :: The GitHub CLI · installed 2026-07-08
+- =hugo= :: Fast and Flexible Static Site Generator in Go · installed 2026-07-13
+- =imv= :: Image viewer for Wayland and X11 · installed 2026-07-13
+- =inform= :: The Inform 6 compiler · installed 2026-07-11
+- =lc0= :: UCI-compliant chess engine designed to play chess via neural network, specifically those of the LeelaChessZero project. · installed 2026-05-16
+- =ledger= :: Double-entry accounting system with a command-line reporting interface · installed 2026-04-25
+- =libreoffice-fresh= :: LibreOffice branch which contains new features and program enhancements · installed 2026-07-13
+- =minidlna= :: A DLNA/UPnP-AV Media server (aka ReadyDLNA) · installed 2026-05-16
+- =openai-codex= :: OpenAIs lightweight coding agent that runs in your terminal · installed 2026-07-13
+- =pacoloco= :: Pacman caching proxy server · installed 2026-07-08
+- =proton-vpn-gtk-app= :: ProtonVPN GTK app, Maintained by Community · installed 2026-07-08
+- =protontricks= :: Run Winetricks commands for Steam Play/Proton games among other common Wine features · installed 2026-05-09
+- =python-pip= :: The PyPA recommended tool for installing Python packages · installed 2026-06-04
+- =python-pipx= :: Install and Run Python Applications in Isolated Environments · installed 2026-07-08
+- =python-sphinx= :: Python documentation generator · installed 2026-04-29
+- =shortwave= :: Internet radio player · installed 2026-03-22
+- =spotify-launcher= :: Client for spotify's apt repository in Rust for Arch Linux · installed 2026-06-04
+- =tidal-dl-ng= :: A tool for downloading music and albums from TIDAL · installed 2026-01-30
+- =typescript-language-server= :: Language Server Protocol (LSP) implementation for TypeScript using tsserver · installed 2026-03-02
+- =whisper.cpp= :: Port of OpenAI's Whisper model in C/C++ · installed 2026-06-04
+- =zoom= :: Video Conferencing and Web Conferencing Service · installed 2026-07-08
+
+** Dependencies of other packages (6)
+Something installed requires these; leaving them to dependency resolution is the default lean.
+- =blas-openblas= :: An optimized BLAS library based on GotoBLAS2 1.13 BSD (Provides BLAS/CBLAS/LAPACK/LAPACKE system-wide) · required by: gsl  python-numpy  suitesparse · installed 2026-05-16
+- =lc0-network-sm= :: Small network for lc0 chess engine, requires ~1.6 GB of memory, recommended for CPU usage. · required by: lc0 · installed 2026-05-16
+- =openblas= :: An optimized BLAS library based on GotoBLAS2 1.13 BSD · required by: blas-openblas  lc0  libggml-git · installed 2026-04-25
+- =pkcs11-helper= :: A library that simplifies the interaction with PKCS11 providers for end-user applications using a simple API and optional OpenSSL engine · required by: openvpn · installed 2026-02-20
+- =proton-vpn-daemon= :: Daemons for Proton VPN Linux client (split tunneling service) · required by: proton-vpn-cli  proton-vpn-gtk-app · installed 2026-05-05
+- =python-lyricsgenius= :: A Python client for the Genius.com API, that provides a simple interface to the song, artist, and lyrics data stored on Genius.com · required by: tidal-dl · installed 2026-01-25
+
+** Libraries with no requirer (7)
+The task's library watchlist: likely former dependencies now orphaned, or toolchain pieces. Lean: ignore unless a build recipe needs them pinned.
+- =eigen= :: Lightweight C++ template library for vector and matrix math, a.k.a. linear algebra · installed 2026-04-05
+- =freerdp= :: Free implementation of the Remote Desktop Protocol (RDP) · installed 2026-07-08
+- =lib32-openal= :: Cross-platform 3D audio library, software implementation (32-bit) · installed 2026-05-12
+- =rust-bindgen= :: Automatically generates Rust FFI bindings to C (and some C++) libraries · installed 2026-07-08
+- =sane= :: Scanner Access Now Easy · installed 2026-02-24
+- =tk= :: A windowing toolkit for use with tcl · installed 2026-02-26
+- =webkit2gtk= :: Web content engine for GTK · installed 2026-05-03
+
+** Structural (pacstrap / VM harness / kernel) (21)
+Already excluded by the task's 2026-06-14 analysis; listed so the report matches the raw diff count.
+- =archiso= :: Tools for creating Arch Linux live and install iso images · installed 2026-04-05
+- =base= :: Minimal package set to define a basic Arch Linux installation · installed 2026-02-12
+- =bridge-utils= :: Utilities for configuring the Linux ethernet bridge · installed 2026-01-26
+- =btrfs-progs= :: Btrfs filesystem utilities · required by: archinstall  grub-btrfs  libguestfs  snap-pac  snapper · installed 2026-05-12
+- =dnsmasq= :: Lightweight, easy to configure DNS forwarder and DHCP server · installed 2026-06-08
+- =efibootmgr= :: Linux user-space application to modify the EFI Boot Manager · installed 2026-05-10
+- =ex-vi-compat= :: The ex and vi commands based on vim's compatibility modes · installed 2026-02-06
+- =grub= :: GNU GRand Unified Bootloader (2) · required by: grub-btrfs · installed 2026-01-25
+- =libguestfs= :: Access and modify virtual machine disk images · installed 2026-07-08
+- =linux= :: The Linux kernel and modules · installed 2026-07-13
+- =linux-headers= :: Headers and scripts for building modules for the Linux kernel · installed 2026-07-13
+- =linux-lts= :: The LTS Linux kernel and modules · installed 2026-07-13
+- =linux-lts-headers= :: Headers and scripts for building modules for the LTS Linux kernel · installed 2026-07-13
+- =linux-lts-strix= :: The LTS Linux with Strix Halo PMFW VPE-idle-pg workaround patch kernel and modules · installed 2026-04-30
+- =logrotate= :: Rotates system logs automatically · installed 2026-04-19
+- =qemu-full= :: A full QEMU setup · required by: libguestfs · installed 2026-07-13
+- =sudo= :: Give certain users the ability to run some commands as root · required by: base-devel  devtools · installed 2026-07-08
+- =virt-manager= :: Desktop user interface for managing virtual machines · installed 2026-01-26
+- =virt-viewer= :: A lightweight interface for interacting with the graphical display of virtualized guest OS. · installed 2026-01-26
+- =yay= :: Yet another yogurt. Pacman wrapper and AUR helper written in go. · installed 2026-07-08
+- =zram-generator= :: Systemd unit generator for zram devices · installed 2026-06-08
+