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

docs: refresh CLAUDE.md + IDEA.md for design-approved phase

Browse Source 
Reflects state changes from this session:
- Phase moved from "ideation, no upstream pull" to "design-approved,
  pre-implementation"
- Repo confirmed live at git.sethpc.xyz/Seth/sethLabels (was TBD)
- Qt6 6.2 confirmed (was Qt5-or-Qt6 TBD)
- Target framing corrected: Debian-family generic + macOS via brew tap;
  steel141 is a build host, NOT the install target
- Strict-zero source-patch policy spelled out (replaces vague "keep
  diffs surgical")
- Versioning scheme noted (<upstream-tag>-seth<N>)
- Eventual-public flip on GitHub captured

Pointer to spec at sethlabels-docs/specs/2026-04-29-packaging-design.md
added to CLAUDE.md "Current State".
This commit is contained in:
Seth Freiberg
2026-04-29 09:55:07 -04:00
parent 8e272c0bd8
commit d3e14c63c0
2 changed files with 16 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
IDEA.md
+7 -6
View File
@@ -12,9 +12,10 @@ Need a reliable, scriptable label designer/printer for homelab + household use (
## Constraints / preferences
- **Upstream:** https://github.com/j-evins/glabels-qt (track this, don't drift)
- **Stack:** Qt (5 or 6 — TBD based on upstream's current state), CMake, C++
- **Target hosts:** steel141 primarily (Debian 13). Maybe a CT for headless print serving later.
- **Branding/customization:** minimal — this is for personal use, not a product
- **License:** glabels-qt is GPL-3.0 — preserve it; any contributions stay GPL-3.0
- **Repo:** Gitea at `git.sethpc.xyz/Seth/sethLabels` (TBD until first push)
- **Upstream:** https://github.com/j-evins/glabels-qt (track this, don't drift). The glabels.org team are the real authors — strict-zero source-patch policy preserves their attribution end-to-end.
- **Stack:** Qt6 6.2 + CMake + C++ (confirmed by reading upstream `CMakeLists.txt:119`).
- **Target install hosts:** any Debian-family Linux (Debian 13 / Ubuntu LTS) for `.deb` + AppImage; any macOS for Homebrew tap. Steel141 is a *build host*, not a deploy target. CT for headless print serving optional/later. Windows deferred.
- **Branding/customization:** zero — this is a packaging fork, not a rebrand. Strict-zero policy forbids icon/string/UI edits.
- **License:** glabels-qt is GPL-3.0 — preserved automatically (we never touch upstream files).
- **Repo:** live at `git.sethpc.xyz/Seth/sethLabels`. Eventually-public on GitHub once the build/release pipeline is battle-tested.
- **Eventual public-flip:** when promoted to a formal public fork on GitHub, brew tap source URL flips Gitea→GitHub (one-line tap formula edit), and CI is added via GitHub Actions calling the same `scripts/` shell scripts unmodified.