Skip to content

docs(repo): #415 Phase-2 execution plan — cluster-coordinated filter-repo playbook (gated) - #702

Merged
jsboige merged 1 commit into
masterfrom
docs/415-execution-plan
Jul 5, 2026
Merged

docs(repo): #415 Phase-2 execution plan — cluster-coordinated filter-repo playbook (gated)#702
jsboige merged 1 commit into
masterfrom
docs/415-execution-plan

Conversation

@jsboige

@jsboige jsboige commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

#415 Phase-2 — .git reduction EXECUTION PLAN (gated, read-only)

Base: 70bd1605 · Dispatch: ka7vl5 (PRIMAIRE) · Status: PROPOSAL/PLAN ONLY — 0 history mutation, 0 force-push, 0 Cards/ write.

What this adds vs the existing proposal

The Phase-2 proposal (merged) gave the analysis + costing + the filter-repo strip set. This PR turns it into a concrete, cluster-coordinated execution playbook ready to run when jsboige green-lights:

Section Content
§1 Empirical inventory Fresh on 70bd1605: .git 2.2 GB, top-5 blobs resolved to paths (Print&Play.zip 93.6 MB, Published/*.zip ×4 ~83 MB), 4 open PRs
§1 Strip target 1.8 GB regenerable: Published/ 1.2 GB + Mindmapper/Published/ 187 MB + DNN Downloads 205 MB + .resources 150 MB. Design sources (Packaging/Sketch/SVGs) preserved
§2 Projection .git 2.2 GB → ~0.45–0.5 GB (~75 % reduction, ~1.7 GB saved per clone)
§3 Playbook Pre-flight (go/no-go, 4 PRs merged/closed, tag-before-vs-after, re-clone window) → exact git filter-repo strip set (incl. the 2 Mindmapper entries from the 2026-07-03 affinement) → local verify (du/git fsck/git-weight-audit.py) → re-add origin → coordinated force-push → post-rewrite re-clone for every cluster machine
§4 Risks Refreshed (4 open PRs not 3; SHA-shift cascade; tag integrity; filter-repo removes origin)
§5 Gate Explicit: execution = jsboige. Reco unchanged = DEFER to post-v0.9.0-tag

What this does NOT do

  • ❌ No git filter-repo / BFG run, no clone, no force-push, no history mutation.
  • ❌ No design-source deletion (Packaging, Sketch — LFS is a separate non-rewrite decision).
  • ❌ No .gitignore change (companion PR, orthogonal, can proceed independently now).

Reproducibility

All inventory numbers re-derivable via python tools/git-weight-audit.py (Phase-1, merged #621) + the read-only git verify-pack/rev-list --objects commands documented inline.

Relates #415, #621. Dispatch ka7vl5 PRIMAIRE.

🤖 Generated with Claude Code

…repo playbook (gated)

Turns the Phase-2 proposal (analysis + costing) into a concrete, step-by-step EXECUTION
playbook ready to run when jsboige green-lights. Read-only: 0 history mutation, 0 force-push,
0 Cards/ write.

Adds vs the proposal:
- Fresh empirical inventory on master 70bd160 (.git 2.2 GB, top blobs resolved to paths,
  4 open PRs counted) confirming the bloat source is unchanged.
- Strip-target table (1.8 GB regenerable: Published/ 1.2 GB + Mindmapper/Published/ 187 MB +
  DNNPlatform Downloads/ 205 MB + .resources 150 MB), design sources preserved.
- Post-purge projection (~0.45-0.5 GB, ~75% reduction).
- Pre-flight checklist (jsboige go/no-go, 4 open PRs merged/closed, timing tag-before-vs-after,
  cluster re-clone window announced).
- Exact git filter-repo strip set (including the 2 Mindmapper/Published entries from the
  2026-07-03 affinement), local verification (du, git fsck, git-weight-audit.py), re-add origin,
  coordinated force-push, post-rewrite re-clone for every cluster machine.
- Risks refreshed (4 open PRs not 3), gate explicit (DEFER to post-v0.9.0-tag, unchanged reco).

No filter-repo/BFG run. No .gitignore change (companion PR, orthogonal).

Dispatch ka7vl5 (PRIMAIRE). Base 70bd160.

Co-Authored-By: Claude <noreply@anthropic.com>
@jsboige
jsboige merged commit d2d00d7 into master Jul 5, 2026
3 checks passed
@jsboige
jsboige deleted the docs/415-execution-plan branch July 5, 2026 17:09
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