Skip to content

Pro-repo pass: README overhaul, cleanliness audit, submodules, CI#1

Merged
gamween merged 11 commits into
mainfrom
docs/readme-overhaul
Jun 16, 2026
Merged

Pro-repo pass: README overhaul, cleanliness audit, submodules, CI#1
gamween merged 11 commits into
mainfrom
docs/readme-overhaul

Conversation

@gamween

@gamween gamween commented Jun 16, 2026

Copy link
Copy Markdown
Owner

A pass to make the repo clean, professional, and convention-following — no functional changes to the product, all suites green.

README

  • Dev-focused rewrite (technical, problem-first; it's a niche CLI security tool, not a consumer app). No image clutter (logo only), minimal emoji, ASCII architecture diagram, TOC, tables, badges.
  • Honest live vs. roadmap: Aave/GMX framed as "built & ready, ships when they're live on Robinhood Chain" (real reason — not deployed there yet), not as a demo "mock".
  • Arbitrum Open House London buildathon context (facts adversarially verified), live URL, sponsor tech actually used.

Cleanliness audit (multi-agent, adversarially verified)

  • Dead code: unused deposits mapping (mock), amount propagation (watcher), 2 unused Remotion components, dead SectionHeading align branch, unused DEPLOY_PROOF keys / TermTone export.
  • Old-impl residue: GUARDIAN_IMPL is now required from env (removed the hard-coded superseded 0x6671… fallback — no stale impl address in source); stale demo addresses refreshed to the live deployment.
  • Residual French → English; duplicates<CommandCard> + <PageHeader>; 11 unused video PNGs (~12 MB) removed.

Repo footprint (~1,220 → ~190 tracked files)

  • Removed internal process docs (~12 MB): docs/superpowers/, docs/SUBMISSION.md, docs/brand/. Reworded the references so nothing dangles (code is the design-token source of truth).
  • Vendored Foundry deps → git submodules (forge-std v1.16.1, OpenZeppelin v5.6.1, pinned via foundry.lock). Clone is now --recursive.

Pro-repo standards

  • CI (.github/workflows/ci.yml): contracts forge test · watcher vitest · site build + lint, on push to main and PRs.
  • SECURITY.md (private disclosure) + CONTRIBUTING.md.

Verification

forge test 64 pass / 1 skip · watcher 25 · site build + lint · video typecheck — all green.

gamween added 10 commits June 16, 2026 07:52
…uilt, verified buildathon context

- Modern structure: hero + badges + nav, status table, Mermaid architecture,
  live deployment + addresses, quickstart, repo tree, security model, roadmap.
- Brand DA showcased via optimized images (docs/readme/, ~1.8MB total).
- Honest framing: Aave exit is fork-verified but runs vs a mock on Robinhood →
  real Aave/GMX integration moved to roadmap; experimental/unaudited disclaimer.
- Arbitrum Open House London context (adversarially verified facts), live URL,
  sponsor tech actually used (Robinhood Chain, Alchemy, OpenZeppelin).
…ns, not 'mock')

Aave/GMX aren't live because they're not deployed on Robinhood Chain yet — the
exit engine is built & verified against real Aave V3 and ships the day they land.
Drop 'mock for the demo' framing; engaging, honest, reason-led roadmap.
Technical/niche framing (CLI guardian for a non-atomic-exploit failure mode, not
a consumer app). Drop inline images (logo only) and heading emojis; keep status
emojis in tables. ASCII architecture diagram, GitHub alert callouts, tables, TOC,
5 flat-square badges. Problem-first, dense, low-fluff.
…nglish-only

Verified by a multi-agent audit (adversarially filtered). Changes:
- contracts: drop unused 'deposits' mapping from MockVulnerableProtocol.
- watcher: GUARDIAN_IMPL is now required from env (removed the hard-coded
  superseded 0x6671… fallback constant) → no stale impl address in source;
  drop unused 'amount' propagation from DrainedLog; tests updated (still 25).
- watcher: translate the one residual French comment to English.
- video: delete unused components (BevelCard, Caption) and 11 unreferenced
  PNGs (~12 MB); point LIVE_URL at coincoin-five.vercel.app.
- site: dedupe the command card into <CommandCard>; drop dead SectionHeading
  'align' branch; trim unused DEPLOY_PROOF keys + TermTone export; refresh
  stale demo addresses to the live deployment.
- docs/.env.example: RULES_ENGINE parity, fix GUARDIAN_IMPL comment, check
  done submission boxes. (local .env tidied to English; gitignored.)

forge 64/1skip · watcher 25 · site build+lint clean · video typecheck+render OK.
Drop docs/superpowers (AI design specs/plans), docs/SUBMISSION.md (internal
pre-submission notes), and docs/brand (build-in-public brand kit + 6 large
master PNGs ~12MB). The design tokens' source of truth is the code
(tailwind.config.js, video/src/theme.ts). Reworded the handful of comments/README
lines that pointed at the removed files so nothing dangles. Keeps docs/readme/logo.png.
…OZ v5.6.1)

contracts/lib held 1033 committed third-party files. Convert to standard Foundry
submodules: tree now tracks 2 gitlinks + .gitmodules + foundry.lock (pinned commits)
instead of vendored sources. Remappings unchanged; forge build + 64/1-skip tests pass.
README clone updated to --recursive (with the submodule-update fallback).
…build+lint) + SECURITY.md

Standard pro-repo files: CI runs the test/build matrix on push to main and on PRs
(submodule-aware checkout for Foundry deps; the real-Aave fork test self-skips
without ARBITRUM_ONE_RPC). SECURITY.md documents private vulnerability disclosure.
…et with the runbook

- Dedupe the sticky header across Dashboard/Docs/License/Contact into one
  <PageHeader breadcrumb maxWidthClass> with the per-page actions as children.
- Update the /docs deploy snippet to the canonical runbook (unset CHAIN,
  --skip-simulation, DeployRules + RULES_ENGINE + DEMO_AAVE_POOL).
Copilot AI review requested due to automatic review settings June 16, 2026 20:12
@vercel

vercel Bot commented Jun 16, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
coincoin Ready Ready Preview, Comment Jun 16, 2026 8:14pm

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot wasn't able to review this pull request because it exceeds the maximum number of files (300). Try reducing the number of changed files and requesting a review from Copilot again.

@gamween gamween merged commit 591fbfb into main Jun 16, 2026
5 checks passed
@gamween gamween deleted the docs/readme-overhaul branch June 16, 2026 20:43
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.

2 participants