chore(archive): name archive folders like their tags; fix the archive pointer #204

Merged
peterswimm merged 1 commit from chore/archive-naming-convention into main 2026-10-09 17:43:35 +00:00
Owner

Scope

This is a follow-up to #202. It adopts one archive naming convention and fixes a pointer to a repo that never existed.

The convention. It isn't new: the spel repo already has 25 tags in this form, and #202's tags already used it.

Retiring Canonical home Name
a branch or commit annotated tag in the same repo archive/<slug>-<YYYYMMDD>
a whole repo Forgejo's "archived" flag the repo keeps its name (as toilville-brand and azure-learning-dojo already do)
files people need to browse the tag plus an in-tree copy archive/<slug>-<YYYYMMDD>/, named exactly like its tag

Changes:

  • Renamed the archive folders to match their tags:

    • archive/design-system-superset-2026-06-28/ → archive/design-system-superset-20260628/
    • archive/ds-bundle-snapshot-2026-10-07/ → archive/ds-bundle-snapshot-20261007/

    All 169 are pure renames with unchanged content.

  • CLAUDE.md twice said the cut-over material went "off-repo to toilville-brand-archive/", but no repo by that name exists. It now points at the cut-over commit ec376b1 in this repo's history and at the archived Toilville/toilville-brand. That repo is a partial copy: it has Brand/design_system, Brand/Icons and generator/, but not Brand/Logos.

  • CLAUDE.md and archive/README.md now state the convention. It is also recorded in forge lore as archive-naming-convention.

Testing

  • Renamed pairs come out at 169, with only new paths, so no content changed.
  • test_archive_inert.py:
    • the reference pattern now matches archive/<slug>-<YYYYMMDD>;
    • a new test fails if any folder isn't named <slug>-<YYYYMMDD>, or if its tag isn't listed in archive/README.md.
    • Control: restoring the old dashed folder name made the new test fail. Renaming it back passed.
  • The full suite passes (343) and just check passes.
  • The toilville-brand contents were checked through the Forgejo API (200 or 404 per path).

Impact Statement

  • Existing features: no expected impact. Nothing reads archive/.
  • Public APIs / contracts: no expected impact.
  • Schemas: no expected impact.
  • Data / artifacts: archive folders renamed. No content or dist/ changes.
  • Integrations: no expected impact.
  • Mappings: no expected impact.
  • Backward compatibility: links to the dashed folder paths from #202, made in the last day, will 404. The tags are unchanged.

Docs

CLAUDE.md and archive/README.md.

## Scope This is a follow-up to #202. It adopts one archive naming convention and fixes a pointer to a repo that never existed. **The convention.** It isn't new: the `spel` repo already has 25 tags in this form, and #202's tags already used it. | Retiring | Canonical home | Name | |---|---|---| | a branch or commit | annotated tag in the same repo | `archive/<slug>-<YYYYMMDD>` | | a whole repo | Forgejo's "archived" flag | the repo keeps its name (as `toilville-brand` and `azure-learning-dojo` already do) | | files people need to browse | the tag plus an in-tree copy | `archive/<slug>-<YYYYMMDD>/`, named exactly like its tag | **Changes:** - Renamed the archive folders to match their tags: - `archive/design-system-superset-2026-06-28/` → `archive/design-system-superset-20260628/` - `archive/ds-bundle-snapshot-2026-10-07/` → `archive/ds-bundle-snapshot-20261007/` All 169 are pure renames with unchanged content. - `CLAUDE.md` twice said the cut-over material went "off-repo to `toilville-brand-archive/`", but no repo by that name exists. It now points at the cut-over commit `ec376b1` in this repo's history and at the archived `Toilville/toilville-brand`. That repo is a partial copy: it has `Brand/design_system`, `Brand/Icons` and `generator/`, but not `Brand/Logos`. - `CLAUDE.md` and `archive/README.md` now state the convention. It is also recorded in forge lore as `archive-naming-convention`. ## Testing - Renamed pairs come out at 169, with only new paths, so no content changed. - `test_archive_inert.py`: - the reference pattern now matches `archive/<slug>-<YYYYMMDD>`; - a new test fails if any folder isn't named `<slug>-<YYYYMMDD>`, or if its tag isn't listed in `archive/README.md`. - Control: restoring the old dashed folder name made the new test fail. Renaming it back passed. - The full suite passes (343) and `just check` passes. - The `toilville-brand` contents were checked through the Forgejo API (200 or 404 per path). ## Impact Statement - Existing features: no expected impact. Nothing reads `archive/`. - Public APIs / contracts: no expected impact. - Schemas: no expected impact. - Data / artifacts: archive folders renamed. No content or `dist/` changes. - Integrations: no expected impact. - Mappings: no expected impact. - Backward compatibility: links to the dashed folder paths from #202, made in the last day, will 404. The tags are unchanged. ## Docs `CLAUDE.md` and `archive/README.md`.
chore(archive): name archive folders like their tags; fix the archive pointer
All checks were successful
PR policy check / policy-gate (pull_request) Successful in 0s
Security Scans / Trivy filesystem scan (pull_request) Successful in 37s
Block Validation / validate (pull_request) Successful in 1m4s
Security Scans / Gitleaks secret scan (pull_request) Successful in 26s
Test Generator / lint-workflows (pull_request) Successful in 16s
Test Generator / lint-prose (pull_request) Successful in 26s
Copy coverage / Design copy reaching rendered HTML (pull_request) Successful in 41s
UDG dist drift gate / dist/ matches dtcg + udg sources (pull_request) Successful in 16s
Test Generator / test (pull_request) Successful in 3m40s
69958d75dc
Adopt the org archive convention (already used by spel's 25 archive/* tags):
retired branch/commit -> tag archive/<slug>-<YYYYMMDD>; retired repo ->
Forgejo archived flag; in-tree copy -> archive/<slug>-<YYYYMMDD>/, named
exactly like its tag.

- Rename archive/design-system-superset-2026-06-28 -> ...-20260628 and
  archive/ds-bundle-snapshot-2026-10-07 -> ...-20261007 (pure renames).
- test_archive_inert: match the new names; new test fails a folder not
  named <slug>-<YYYYMMDD> or without its tag in archive/README.md.
- CLAUDE.md: 'toilville-brand-archive/' never existed; point at the
  cut-over commit ec376b1 and the archived Toilville/toilville-brand.
peterswimm deleted branch chore/archive-naming-convention 2026-10-09 17:43:35 +00:00
Sign in to join this conversation.
No description provided.