Toilville/toilville-design
Watch
5
1
Fork
You've already forked toilville-design
 0
Code Issues 21 Pull requests Projects Releases Packages Wiki Activity Actions

chore(archive): preserve the recovered design-system superset and ds-bundle snapshot #202

Merged
peterswimm merged 1 commit from chore/archive-recovered-design-work into main 2026-10-09 00:10:34 +00:00
Conversation 0 Commits 1 Files changed 173 +11614 -3
peterswimm commented 2026-10-09 00:03:15 +00:00
Owner
Copy link

Scope

This PR preserves two pieces of earlier design work that existed only on one Mac. Forgejo returned 404 for both commits before this PR.

Folder Source What it is
archive/design-system-superset-2026-06-28/ (109 files) f5c7411, 2026-06-28 The authored design system imported from the claude.ai Design project: tokens, themes, components, ui_kits, guidelines cards, icons, illustrations, SKILL.md, DESIGN-SYSTEM.md. CLAUDE.md called this superset lost; it survived as an unpushed branch.
archive/ds-bundle-snapshot-2026-10-07/ (60 files) e746ae0, 2026-10-07 The last DesignSync bundle (six products), generated from dist/. It includes DM Mono fonts.

Both are frozen reference, not live. Their values are stale (primary #CC5C37; DM Mono was dropped 2026-09-11), and nothing builds from them. The original commits are also kept as annotated tags, archive/design-system-superset-20260628 and archive/ds-bundle-snapshot-20261007. Both tags are already pushed, and the commits now resolve on Forgejo.

Also in this PR:

  • archive/README.md: provenance and rules (read-only, never import, salvage by rebuilding in the live tree with Keff and leadership sign-off).
  • .gitattributes: marks archive/** as vendored and generated, so it stays out of language stats.
  • CLAUDE.md: the "lost … never recovered" line now points at the recovered copy, and archive/ is added to "Submodule Rules" and "Where things live".

The salvage review (an inventory of what's worth rebuilding into the live system) is a separate follow-up PR. This PR makes no brand or token changes.

Testing

  • Byte parity: 169 of 169 staged blobs match the blob at the source commit's path, with 0 mismatches. They were checked after git add, so * text=auto changed nothing.
  • New guard, generator/tests/unit/test_archive_inert.py:
    • It fails if any build input (udg/, tools/, .forgejo/, generator/, justfile, pre-commit, .mcp.json) names a dated archive/<name>-YYYY-MM-DD folder.
    • It also checks that archive/ holds no *.forgeblock.json and has a README.
    • Control: a reference planted in udg/generators/_miniyaml.py made it fail.
    • It deliberately ignores the WordPress "archive/detail" prose and udg/generators/archive. A first, broader pattern caught both, and I narrowed it.
  • Gates: the full suite passes (342) and just check passes.
  • Reachability: the scans that walk the tree were checked: the forgeblock glob, the seed roots in assets.py, the sibling-repo scan in align_check, Vale (limited to docs and non-fatal), and the path-scoped pre-commit hooks. None of them reach archive/.
  • Secrets: a local grep found nothing (the only hit was mask-type in an SVG). Gitleaks and Trivy run in CI on this PR.

Impact Statement

  • Existing features: no expected impact. Nothing reads archive/.
  • Public APIs / contracts: no expected impact.
  • Schemas: no expected impact.
  • Data / artifacts: about 170 frozen files, roughly 0.8 MB. No dist/ changes.
  • Integrations: no expected impact.
  • Mappings: no expected impact.
  • Backward compatibility: no expected impact.

Docs

archive/README.md (new) and CLAUDE.md.

Separately, CLAUDE.md still says the 2026-06-27 cut-over was "archived off-repo to toilville-brand-archive/". No repo by that name exists on Forgejo. The archived predecessor is Toilville/toilville-brand. I left that wording alone; it's worth a decision.

## Scope This PR preserves two pieces of earlier design work that existed only on one Mac. Forgejo returned 404 for both commits before this PR. | Folder | Source | What it is | |---|---|---| | `archive/design-system-superset-2026-06-28/` (109 files) | `f5c7411`, 2026-06-28 | The authored design system imported from the claude.ai Design project: tokens, themes, components, ui_kits, guidelines cards, icons, illustrations, SKILL.md, DESIGN-SYSTEM.md. CLAUDE.md called this superset lost; it survived as an unpushed branch. | | `archive/ds-bundle-snapshot-2026-10-07/` (60 files) | `e746ae0`, 2026-10-07 | The last DesignSync bundle (six products), generated from `dist/`. It includes DM Mono fonts. | Both are **frozen reference, not live**. Their values are stale (primary `#CC5C37`; DM Mono was dropped 2026-09-11), and nothing builds from them. The original commits are also kept as annotated tags, `archive/design-system-superset-20260628` and `archive/ds-bundle-snapshot-20261007`. Both tags are already pushed, and the commits now resolve on Forgejo. Also in this PR: - `archive/README.md`: provenance and rules (read-only, never import, salvage by rebuilding in the live tree with Keff and leadership sign-off). - `.gitattributes`: marks `archive/**` as vendored and generated, so it stays out of language stats. - `CLAUDE.md`: the "lost … never recovered" line now points at the recovered copy, and `archive/` is added to "Submodule Rules" and "Where things live". The salvage review (an inventory of what's worth rebuilding into the live system) is a separate follow-up PR. This PR makes no brand or token changes. ## Testing - **Byte parity:** 169 of 169 staged blobs match the blob at the source commit's path, with 0 mismatches. They were checked after `git add`, so `* text=auto` changed nothing. - **New guard, `generator/tests/unit/test_archive_inert.py`:** - It fails if any build input (`udg/`, `tools/`, `.forgejo/`, `generator/`, `justfile`, pre-commit, `.mcp.json`) names a dated `archive/<name>-YYYY-MM-DD` folder. - It also checks that `archive/` holds no `*.forgeblock.json` and has a README. - Control: a reference planted in `udg/generators/_miniyaml.py` made it fail. - It deliberately ignores the WordPress "archive/detail" prose and `udg/generators/archive`. A first, broader pattern caught both, and I narrowed it. - **Gates:** the full suite passes (342) and `just check` passes. - **Reachability:** the scans that walk the tree were checked: the forgeblock glob, the seed roots in `assets.py`, the sibling-repo scan in `align_check`, Vale (limited to docs and non-fatal), and the path-scoped pre-commit hooks. None of them reach `archive/`. - **Secrets:** a local grep found nothing (the only hit was `mask-type` in an SVG). Gitleaks and Trivy run in CI on this PR. ## Impact Statement - Existing features: no expected impact. Nothing reads `archive/`. - Public APIs / contracts: no expected impact. - Schemas: no expected impact. - Data / artifacts: about 170 frozen files, roughly 0.8 MB. No `dist/` changes. - Integrations: no expected impact. - Mappings: no expected impact. - Backward compatibility: no expected impact. ## Docs `archive/README.md` (new) and `CLAUDE.md`. Separately, `CLAUDE.md` still says the 2026-06-27 cut-over was "archived off-repo to `toilville-brand-archive/`". No repo by that name exists on Forgejo. The archived predecessor is `Toilville/toilville-brand`. I left that wording alone; it's worth a decision.
chore(archive): preserve the recovered design-system superset and ds-bundle snapshot
Some checks failed
PR policy check / policy-gate (pull_request) Successful in 0s
Details
Security Scans / Trivy filesystem scan (pull_request) Failing after 33s
Details
Security Scans / Gitleaks secret scan (pull_request) Successful in 28s
Details
Block Validation / validate (pull_request) Successful in 1m6s
Details
Test Generator / lint-workflows (pull_request) Successful in 16s
Details
Test Generator / lint-prose (pull_request) Successful in 18s
Details
Test Generator / test (pull_request) Failing after 58s
Details
Copy coverage / Design copy reaching rendered HTML (pull_request) Successful in 27s
Details
UDG dist drift gate / dist/ matches dtcg + udg sources (pull_request) Successful in 13s
Details
815071d638 
Two branches existed only on one Mac (both commits 404 on Forgejo):
- f5c7411 (2026-06-28): the authored design-system superset imported from
  the claude.ai Design project, which CLAUDE.md had called lost.
- e746ae0 (2026-10-07): the last DesignSync bundle, generated from dist/.

Copied byte-exact (169 files, blob-verified) into archive/ as frozen
reference. Stale values; nothing builds from it. archive/README.md has
provenance and rules; test_archive_inert.py fails if a build input ever
names an archived folder. CLAUDE.md now points at the recovered copy.
Original commits are kept on Forgejo via archive/* tags.
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
build-dist
Ask the UDG build bot to run just build and commit generated files to this PR

  
priority
P1
 Urgent — no working icon yet (custom art pending) or a shipping asset

  
priority
P2
 High — has an accessible stand-in; bespoke art wanted

  
priority
P3
 Medium — stage visual headers

  
priority
P4
 Low — behavioral dimension family

  
bug
Something is not working

  
duplicate
This issue or pull request already exists

  
enhancement
New feature

  
help wanted
Need some help

  
invalid
Something is wrong

  
question
More information is needed

  
wontfix
This won't be fixed

No labels
build-dist
priority
P1
priority
P2
priority
P3
priority
P4
bug
duplicate
enhancement
help wanted
invalid
question
wontfix
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
Toilville/toilville-design!202
No description provided.