Skip to content

chore(repo): move v1/ → archive/v1/ + archive policy README#430

Merged
ruvnet merged 1 commit intomainfrom
chore/archive-v1
Apr 26, 2026
Merged

chore(repo): move v1/ → archive/v1/ + archive policy README#430
ruvnet merged 1 commit intomainfrom
chore/archive-v1

Conversation

@ruvnet
Copy link
Copy Markdown
Owner

@ruvnet ruvnet commented Apr 26, 2026

Why

The Rust port at v2/ has been the primary codebase since the rename in #427. The Python implementation at v1/ is no longer the active target; the only load-bearing path is the deterministic proof bundle at v1/data/proof/ (per ADR-011 / ADR-028 witness verification).

Move the whole Python tree into archive/v1/ so the repo's top level reflects what's actually maintained. Add archive/README.md to make the policy explicit so future contributors know what they can and can't do in there.

Scope

  • git mv v1 archive/v1 — preserves history for all 180+ files.
  • archive/README.md — new file, documents:
    • what counts as "archived"
    • bug-fix policy (allowed only when the bug affects a still-load-bearing path; currently just the Python proof)
    • quick reference for the load-bearing paths
    • rationale for keeping vs deleting (trust kill-switch, witness verification, ADR cross-references)
  • 26 files updated for path references (verify-pipeline.yml, CLAUDE.md, README.md, CHANGELOG.md, Dockerfile.python, 14 ADRs, build-guide, user-guide, witness-log, qe-reports, hf-readme).
  • 2 manual fixes for double-prefix archive/archive/v1/ typos in verify-pipeline.yml:79 and ADR-011:329.

What did NOT get rewritten

The sed pattern only matches v1/<known-child> patterns. It deliberately does NOT touch:

  • /api/v1/... URL paths (REST API versioning)
  • Version strings like 0.6.1, v0.X.Y
  • Bare v1 references that aren't paths

Validation

  • Python proof: python archive/v1/data/proof/verify.py imports cleanly at the new path. (CI installs numpy/scipy from archive/v1/requirements-lock.txt.)
  • Rust workspace: cargo test --workspace --no-default-features1,539 passed, 0 failed, 8 ignored (unaffected by Python tree relocation).
  • ESP32-S3 on COM7: untouched (no firmware paths changed).
  • verify-pipeline.yml paths-on filter updated (archive/v1/src/core/**, archive/v1/src/hardware/**, archive/v1/data/proof/**).
  • Dockerfile.python paths updated.

After-merge

Contributors with local checkouts should re-run any python v1/... commands as python archive/v1/.... CLAUDE.md and CHANGELOG already document the new paths.

Test plan

  • python archive/v1/data/proof/verify.py resolves at new path
  • cargo test --workspace --no-default-features → 1,539 / 0
  • CI workflow paths updated (verify-pipeline.yml on archive/v1/)
  • Dockerfile.python paths updated
  • CLAUDE.md, README.md, build-guide, user-guide all updated
  • No double-prefix archive/archive/ typos remain
  • CI: workspace tests + verify-pipeline pass on the new layout

🤖 Generated with claude-flow

The Rust port at v2/ has been the primary codebase since the rename
in #427. The Python implementation at v1/ is no longer the active
target; the only load-bearing path is the deterministic proof bundle
at v1/data/proof/ (per ADR-011 / ADR-028 witness verification).

Move the whole Python tree into archive/v1/ and document the policy
in archive/README.md: no new features, bug fixes only when they affect
a still-load-bearing path (currently just the proof), CI continues to
verify the proof on every push and PR.

Path references updated in 26 files via path-pattern sed (only
matches v1/<known-child> patterns, never bare v1 or API URLs like
/api/v1/). Two double-prefix typos (archive/archive/v1/) caught and
hand-fixed in verify-pipeline.yml and ADR-011.

Validated:
- Python proof verify.py imports cleanly at archive/v1/data/proof/
  (numpy/scipy still required; CI installs requirements-lock.txt
  from archive/v1/ now)
- cargo test --workspace --no-default-features → 1,539 passed,
  0 failed, 8 ignored (unaffected by Python tree relocation)
- ESP32-S3 on COM7 untouched (no firmware paths changed)

After-merge: contributors should re-run any local `python v1/...`
commands as `python archive/v1/...` (CLAUDE.md and CHANGELOG already
updated).

Co-Authored-By: claude-flow <ruv@ruv.net>
@ruvnet ruvnet merged commit 81cc241 into main Apr 26, 2026
1 check failed
@ruvnet ruvnet deleted the chore/archive-v1 branch April 26, 2026 03:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant