mirror of
https://github.com/kevinveenbirkenbach/computer-playbook.git
synced 2026-11-11 21:26:44 +00:00
kevinveenbirkenbachandClaude Opus 5
5137465c6f
3529 invalid comments in 528 files, grandfathered in while the linter only saw the working-tree diff. Removal ran through the linter's own collectors, so detection and deletion cannot drift: a comment whose opener line is blank before it and whose closer line is blank after it loses all its lines, anything else loses only the comment region, and a line left holding a bare delimiter goes with it. Five files keep their comments behind a nocheck marker instead. Four are upstream configs whose inline docs are upstream's own (mautrix, systemd journald, nextcloud-oidc-login, MediaWiki). In littlejs the commented-out entries ARE the deactivation mechanism for an example tile, so deleting them would delete configuration. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Apps Deploy Flows 📦
This directory holds the local deploy flows for one or more applications. For the higher-level overview, prerequisites, and naming rationale, see README.md.
Layout 🗂️
The subtree splits by user intent (the verb) and scope:
| Verb folder | Inventory | Stack cycle | Entity purge |
|---|---|---|---|
initialize/ |
fresh | no | no |
reinstall/ |
fresh | yes (down + up) | yes (shared entities) |
update/ |
reuse | no | no |
Each verb folder MUST contain all.sh for every discovered application and MAY contain selection.sh for one or more apps passed via apps (or as a positional argument where supported).
Conventions 📐
- The verb folder name expresses the deploy intent. The script name expresses the scope.
all.shdiscovers applications on the host viascripts/meta/resolve/apps.shand runs against the full list.selection.shrequires the caller to supply the application set explicitly.- Stack state (containers, volumes) and the inventory directory stay on disk after every flow in this subtree.