docs(proposals): phase 2 reviewer persistence and reviewer graph

[JOY (JOY)]

Summary

• What changed? Adds Docs/Proposals/2026-10-16-reviewer-graph-phase2.html, a proposal for the owner to review. It covers:
  • Two private tables (rate.reviewers, rate.review_reviewer, service_role only) to persist the reviewer data that feat(reviews): reviewer metadata contract + real reviewer signals; fix /merchants row truncation #113 and DOS/Rate-Services#17 now extract.
  • A rate.merchant_list_stats() RPC so /merchants stops paging every product and review.
  • The reviewer-graph signals these enable (co-review rings, shop concentration, rating skew), gated on a labelled evaluation set.
  • The REVIEWER_KEY_SECRET the scraper now requires before it produces reviewer keys.
• Why? Reviewer data currently lives only for one crawl, so the same account cannot be linked across products. That link is the strongest seeding signal. The schema change belongs in DOS.Me and needs owner approval first.

Refs #112

Checklist

• Build passes: n/a (docs only)
• Type-check passes: n/a
• Lint/format: HTML parses; no em/en dashes
• Tests pass: n/a
• Docs updated
• No breaking API changes

Notes

• No migration is applied by this PR. The SQL in the proposal is a sketch for the DOS.Me PR, which follows only after approval.

🤖 Generated with Claude Code

https://claude.ai/code/session_01SJ8kEoAgmss5ZwS8ziunTj

---

Generated by Claude Code

[coderabbitai]

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 43 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

• Configuration used: Organization UI
• Review profile: CHILL
• Plan: Advanced
• Run ID: 810e342b-8e7e-425f-900c-14676aedce68

📥 Commits

Reviewing files that changed from the base of the PR and between 38fa019 and 1cd238a.

📒 Files selected for processing: 1

• Docs/Proposals/2026-10-16-reviewer-graph-phase2.html

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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