[Improvement] `README.md` does not describe the current broken state of the lint, type and test gates

[RUKAYAT-CODER]

Overview

README.md is 9.7 KB of setup and feature documentation. A contributor following it will run npm test (190 suites fail), npm run lint (configuration error) and npm run build (blocked by validate-env requiring an undocumented variable) with no warning that any of these is expected to fail. CI_FIXES_COMPLETE.md at the repository root actively asserts the opposite. Getting a new contributor productive is currently a matter of luck.

Specifications

Features:

• A "Known issues" section listing the broken gates and linking to their tracking issues
• A verified quickstart that works on a clean checkout
• The stale CI_FIXES_COMPLETE.md removed

Tasks:

• Walk through the README on a clean clone and record every step that fails
• Add a "Known issues" section with links to the relevant issues
• Correct the quickstart, including the required environment variables
• Remove or rewrite CI_FIXES_COMPLETE.md

Impacted Files:

• README.md
• CI_FIXES_COMPLETE.md
• CONTRIBUTING.md
• .env.example

Acceptance Criteria

• A clean checkout can be set up by following the README exactly
• Known broken gates are disclosed and linked
• No document claims CI is healthy while it is not

[Peculiarr7]

Hi! I came across this issue and would love to work on it. I have experience with similar tasks and I'm confident I can investigate, implement a clean solution, and thoroughly test it before submitting a PR. If the issue is still open, I would appreciate it if you could assign it to me. I’ll prioritize this immediately and ensure a reliable solution is delivered as soon as possible. Thank you!

[bobo-24]

Hi! I’m a full-stack developer with a strong blockchain background, and I’m confident I can resolve this issue quickly and effectively. I’ll deliver a clean, reliable solution with immediate attention to detail, ensuring it’s completed as soon as possible. Please assign it to me—I’m ready to get started right away.