Seth/sethLabels
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 1 Wiki Activity

docs: update CLAUDE.md + DECISIONS.md for macOS .app launcher addition

Browse Source 
CLAUDE.md: removed stale "(to be implemented per spec §5.5)" wording for
check-no-upstream-edits.sh (script is implemented and battle-tested), added
tests-impl/ to the dirs-list, expanded the guardrail description.

DECISIONS.md: appended the .app launcher decision (stub bundle synthesized
in brew formula def install — sethLabels-side fix, no upstream patch).
This commit is contained in:
Seth Freiberg
2026-04-29 12:19:20 -04:00
parent f6c30f2fe8
commit 4172a30487
2 changed files with 3 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CLAUDE.md
+2 -2
View File
@@ -22,8 +22,8 @@ sethLabels is a thin deployment fork of [glabels-qt](https://github.com/j-evins/
## Conventions
- This is a **deployment fork**, not a real fork. The discipline is **strict zero source patches** — no upstream-tracked file is ever edited. All sethLabels content lives in NEW top-level dirs (`scripts/`, `packaging/`, `sethlabels-docs/`, `.claude/`). Allowlist exception: `.gitignore` (one-time scaffold-time touch).
- Enforced by `scripts/check-no-upstream-edits.sh` (to be implemented per spec §5.5).
- This is a **deployment fork**, not a real fork. The discipline is **strict zero source patches** — no upstream-tracked file is ever edited. All sethLabels content lives in NEW top-level dirs (`scripts/`, `packaging/`, `sethlabels-docs/`, `tests-impl/`, `.claude/`). Allowlist exception: `.gitignore` (one-time scaffold-time touch).
- Enforced by `scripts/check-no-upstream-edits.sh` — runs as the first step of every build script, also catches working-tree drift, aborts if `upstream/master` ref is missing.
- Preserve upstream license (GPL-3.0) and copyright headers — strict-zero handles this automatically by never touching upstream files.
- Versioning: `<upstream-tag>-seth<N>` (e.g., `3.99-master618-seth1`). See spec §D4 + §5.4.
- See `~/bin/CLAUDE.md` for global homelab conventions (gitea CLI, conventional commits, credentials handling).