docs(postgres): cite code by name, not by line

[7487]

Description

docs/providers/postgres.md cited code by line number in 17 places on today's main (the issue counted 18; the factory.ts:62 one already went with #629). Every checkable one was stale, and not by a little: postgres.ts has grown by roughly 900 lines above the cited methods, so getCapabilities() cited :250 is declared at :955, validate() cited :264 at :1005, query() cited :378 at :1177, runMaintenance() cited :762 at :1696. The three sql-base.ts methods missed by -16, +3 and +3, and analyzeQuery() cited query-limiter.ts:88 is declared at :177.

Each citation now names the declaration and links the file without a coordinate, the shape mssql.md, mysql.md, oracle.md and mongodb.md already use. The two range citations (:86–177, :148–150) pointed into the schema SQL, which has since been hoisted to module scope, so they now name what they meant: the CTE_*_INFO consts for the AS MATERIALIZED claim, and CTE_FK_INFO for the two-column constraint_column_usage join. No sentence changed meaning.

The doc joins NAMED_CITATIONS in tests/unit/provider-docs-monitoring-citations.test.ts, with postgres.ts as its source and the nine methods that now stand where a line number used to. The list's two tests then assert the doc carries no .ts:<line> anywhere and that every name it cites is really declared.

---

Type of Change

• Documentation update
• Test addition or update

Related Issue

Fixes #589

---

Changes Made

• docs/providers/postgres.md: 17 citations rewritten, no product code
• tests/unit/provider-docs-monitoring-citations.test.ts: one NAMED_CITATIONS entry

---

Testing

• I have tested this locally
• I have added/updated tests
• All existing tests pass

Measured on this branch:

	pass	fail
bun test tests/unit/provider-docs-monitoring-citations.test.ts	29	0
same, with the doc change reverted and the list entry kept	28	1 (postgres.md cites no line number anywhere)

grep -oE '\.ts:[0-9]+' docs/providers/postgres.md returns nothing. bun run format, bun run lint (0 errors), bun run typecheck and bun run knip are clean. bun run test: the hooks, security, evals and components layers all pass; the unit/api/integration layer passes except the chart tests without helm on PATH (#570), sqlite-driver under Bun 1.3.11 (no node:sqlite; the repo pins 1.4.2) and packaging-standalone-zip without a standalone build. None of those touch these two files.

Test Environment

• LibreDB Studio Version: main @ f96d63b
• OS: macOS
• Node.js/Bun Version: Bun 1.3.11

---

Checklist

• My code follows the project's code style guidelines
• I have performed a self-review of my code
• I have updated the documentation accordingly
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

[cevheri]

Thanks @7487 great work