docs: refresh project and contributor guides

[rohittcodes]

Summary

• align the project README with the shipped durable workflow, public application, and Connections capabilities
• refresh contributor setup, environment variables, commands, and package ownership
• replace the stale repository map and distinguish the current product from future RAG, sandbox, MCP, and multi-agent work
• update the SDK README to reflect its server and end-user entry points

Verification

• pnpm format:check — passed
• pnpm lint — passed
• git diff --check — passed
• repository-relative documentation links — verified
• pnpm typecheck — blocked by the existing @linea/sdk-react inability to resolve react/jsx-runtime; this documentation-only change does not touch TypeScript or package configuration

Closes #179

Summary by CodeRabbit

• Documentation
  • Updated project and setup guidance to reflect current platform capabilities, architecture, package responsibilities, environment configuration, and local startup steps.
  • Added instructions for contract checks, launch gates, and optional provider smoke tests.
  • Clarified the roadmap’s distinction between shipped work and future capabilities.
  • Updated SDK guidance on its entry points, supported runtime environments, and current limitations.

[vercel]

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

1 Skipped Deployment

Project	Deployment	Actions	Updated
getlinea-docs	Ignored	Preview	Sep 23, 2026 11:42pm UTC

[coderabbitai]

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: 1e21f09f-3c43-4109-98e0-7473d707a221

📥 Commits

Reviewing files that changed from the base of the PR and between 649136f and d79112b.

⛔ Files ignored due to path filters (1)

• .github/assets/linea-dashboard.png is excluded by !**/*.png

📒 Files selected for processing (5)

• CONTRIBUTING.md
• README.md
• docs/repo-structure.md
• docs/roadmap.md
• packages/sdk/README.md

Included review availability: Your plan provides up to 10 included reviews per hour; 8 remain after this review.

---

📝 Walkthrough

Walkthrough

The documentation now describes Linea’s current capabilities, architecture, setup, repository boundaries, and SDK entry points. It also distinguishes shipped work from future work and updates contributor validation commands.

Changes

Documentation refresh

Layer / File(s)	Summary
Product overview and architecture README.md, docs/roadmap.md	The README describes Linea, its documented capabilities, and architecture. The roadmap identifies shipped capabilities and future work, and points to sources for current implementation status.
Developer setup and verification CONTRIBUTING.md, README.md	The setup guidance covers shared environment variables, local services, and development commands. The docs add contract verification and launch-gate commands, and identify optional provider smoke tests.
Repository and package boundaries CONTRIBUTING.md, README.md, docs/repo-structure.md, packages/sdk/README.md	The docs describe app and package responsibilities, dependency boundaries, and execution flows. The SDK README describes its entry points and runtime guidance.

Priority: ⬇️ Low

Estimated code review effort: 2 (Simple) | ~12 minutes

Change: Other

Merge Risk: ⚪ Minimal · up to d7911

No actionable issue has been established that would prevent merging this documentation update.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely describes the documentation updates to the project, contributor, repository, and SDK guides.
Linked Issues check	✅ Passed	PR #180 addresses issue #179 with documentation-only changes. README.md covers the shipped workflow, public applications, Connections, Action Consent, SDKs, durable execution, replay and regression te…
Out of Scope Changes check	✅ Passed	The changed files remain within issue #179 documentation scope. README.md, CONTRIBUTING.md, docs/repo-structure.md, and packages/sdk/README.md directly update the requested project, contributor, repos…
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Commit to this branch
• Create a new PR

---

_{Comment @coderabbitai help to get the list of available commands.}

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud