Skip to content

docs(maintenance): audit and rehabilitate repository ownership and contributor entry points - #52

Merged
mAsyamJ merged 21 commits into
mainfrom
refactor/monorepo-rehabilitation
Nov 9, 2026
Merged

mAsyamJ merged 21 commits into
mainfrom
refactor/monorepo-rehabilitation

Conversation

@mAsyamJ

@mAsyamJ mAsyamJ commented Nov 9, 2026

Copy link
Copy Markdown
Contributor

Scope

Non-destructive first deliverable for RetroPick Monorepo Rehabilitation, based on main@ccad6e32109d03337b560c3c876848665d9d157a.

This PR does not claim completion of the whole monorepo refactor. It establishes an auditable inventory, documents canonical ownership and compatibility boundaries, improves maintainer onboarding, and adds a reproducible inventory checker. Source-code and financial-logic refactors are expressly gated on separate baseline and regression evidence.

Delivered

  • Complete non-truncated recursive Git-tree census: 15,333 blobs + 2 submodule gitlinks; per-path SHA, committed size, provisional ownership class and reference-tracing status in docs/maintenance/TRACKED_FILE_CENSUS.tsv.
  • New docs/maintenance/{README,REPOSITORY_AUDIT,CLEANUP_DECISIONS,DEPENDENCY_MAP,VALIDATION_REPORT}.md: canonical vs legacy / historical vs research boundaries, detailed non-deletion decisions, declarative workspace dependency map, and honest gate status.
  • Root README.md, CONTRIBUTING.md and docs/README.md link to canonical Vite apps/retro-ui and distinguish frozen historical Kuru Monad V2 deployment from actively developed contracts and research.
  • scripts/maintenance/git_inventory.py: read-only, stdlib-only, deterministic Git inventory / workspace-manifest graph generator.
  • scripts/maintenance/test_git_inventory.py: regressions for Gitlinks, unusual paths, duplicate blob handling, manifest dependency extraction, repeatability, and worktree non-mutation.
  • Existing GitHub Actions V2 fullstack job now runs the maintenance inventory unit tests before dependency installation.

Verified before PR

  • GitHub audit baseline pinned and main unchanged.
  • Branch cleanly based on main, zero behind.
  • 2/2 maintenance unit tests PASS in an isolated local Git fixture; Python syntax compilation PASS.
  • 89/89 referenced local Markdown targets resolve across eight audited documentation files.
  • Scope check: no changes under apps/, contracts/, deployments/, packages/, or any license/provenance files.
  • All files retained; no deletion, no forced push, no history rewrite, no production deploy.

Blocked / required before ready for review and merge

  • GitHub Actions fullstack/browser and Foundry V2 qualifications on this PR PASS, or blockers reproducibly characterized.
  • pnpm install --frozen-lockfile, pnpm check:app, pnpm check:services, canonical Playwright fixture smoke.
  • Foundry format/build/unit/fuzz/invariant/fork suites and frozen deployment source verification.
  • Maintainer and Solidity-security review for any future source/contract refactors.
  • Code-level import and runtime reference graph before any duplicate/dead-code removal.

Why draft: The tool environment could verify the complete Git tree and execute isolated Python regression tests, but could not clone the full repository (network/DNS blocked) or run npm/Foundry/browser suites. The historical CI record contains mixed passes and failures on older commits, so these are not represented as current-main passes or known pre-existing failures.

Safety invariants: apps/web/** stays zero-write; contracts/legacy-v2/** is immutable; ABI/storage/selectors/CREATE2/financial accounting unchanged; PRISM remains research-gated. No automatic merge.

See Validation Report and Cleanup Decisions.

@vercel

vercel Bot commented Nov 9, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
retropick-metropolis-retro-ui-staging Ready Ready Preview Nov 9, 2026 4:21pm UTC

@mAsyamJ
mAsyamJ marked this pull request as ready for review November 9, 2026 16:22
@mAsyamJ
mAsyamJ merged commit 9e4196c into main Nov 9, 2026
3 of 4 checks passed

This branch was successfully deployed

1 active deployment
Preview — 4a65f8e6 Deployed Nov 9, 2026 by vercel[bot]
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