[codex] docs: add Postgres function scalability gate

[riderx]

Summary (AI generated)

• Added a mandatory PostgreSQL function scalability gate to AGENTS.md.
• Documented required execution-model analysis for SQL functions used in RLS, views, triggers, RPCs, PostgREST paths, and hot backend endpoints.
• Added explicit guardrails against broad-table allowed-list helpers and per-row calls to check_min_rights / get_identity* wrappers.

Motivation (AI generated)

A previous mitigation pattern could pass correctness checks while still scaling poorly in production. These instructions make production-scale query planning, cardinality review, index verification, and concurrency validation mandatory before shipping function or RLS-policy changes.

Business Impact (AI generated)

This reduces the risk of database performance regressions that can degrade Capgo availability, customer-facing APIs, and critical PostgREST/Supabase paths.

Test Plan (AI generated)

• Verified the change is limited to AGENTS.md.
• Ran git diff --check -- AGENTS.md.
• Commit hook passed bun run cli:build && vue-tsc --noEmit.

Generated with AI

Summary by CodeRabbit

• Documentation
  • Added PostgreSQL Function Scalability Gate guidance with mandatory review requirements for PostgreSQL functions, including execution analysis, cardinality documentation, performance testing with EXPLAIN ANALYZE, and optimization rules to prevent unbounded operations and ensure stable latency.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 8d0b98a9-4793-4e35-a0db-b911f5bd5834

📥 Commits

Reviewing files that changed from the base of the PR and between db92c9c and e140512.

📒 Files selected for processing (1)

• AGENTS.md

---

📝 Walkthrough

Walkthrough

A new "PostgreSQL Function Scalability Gate" section is added to AGENTS.md, establishing mandatory documentation and verification requirements for any PostgreSQL function reachable from RLS policies, views, triggers, PostgREST queries, or hot endpoints. The guidance specifies execution model documentation, cardinality bounds analysis, forbidden unbounded patterns, and EXPLAIN-based acceptance criteria.

Changes

PostgreSQL Scalability Gate Documentation

Layer / File(s)	Summary
Scalability Gate Guidance AGENTS.md	Adds required execution model documentation, cardinality analysis, unbounded pattern prevention rules, and EXPLAIN (ANALYZE, BUFFERS) verification checklist for PostgreSQL functions in critical execution paths. Defines acceptance criteria for index-bounded plans and stable latency.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Poem

📋 A scalability gate now stands so tall,
With checklists and EXPLAIN calls,
No unbounded loops shall pass the wall—
PostgreSQL performance answers the call! 🐇✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely describes the main change: adding PostgreSQL function scalability documentation to AGENTS.md.
Description check	✅ Passed	The description includes summary, motivation, business impact, and test plan sections. However, it lacks formal checklist items and appears to be AI-generated, missing some template structure.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/add-postgres-function-scalability-gate

---

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

[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

[codspeed-hq]

Merging this PR will not alter performance

✅ 28 untouched benchmarks

---

_{Comparing codex/add-postgres-function-scalability-gate (e140512) with main (db92c9c)}