Repository navigation
Conversation
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
commit: |
The Postgres guide walks a pg project through draft, migrate, generate and runtime use, verified end to end against the docker-compose Postgres in packages/pg/test. It lists the gaps found while verifying: the simplified schema reader in packages/pg/src/impl/schema.ts drops serial/identity, enums, domains, functions, triggers, matviews, extensions, non-public schemas and generated columns, and pg typegen differs from SQLite for limit 1, returning, and nullable params. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The docs called Postgres a runtime adapter with toolchain docs 'still in progress'. Postgres has a working dialect (draft, migrate, check, generate, format, UI), so: README documents the dialect config key and points limitations at the guide's known gaps; adapters, errors, formatter, lint plugin and schema-diff pages say what's true for pg today (including that pg errors are always kind 'unknown'); the intro blog post links the guide; @sqlfu/pg gets a README so its npm page isn't empty. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Main added a celld guide alongside the Postgres guides here. Both sides appended to the Guides description in sync-docs.mjs; kept both and regenerated llms.txt. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
PR SummaryLow Risk Overview The Postgres guide walks through install, config ( READMEs (root and Reviewed by Cursor Bugbot for commit 32e0905. Bugbot is set up for automated code reviews on this repo. Configure here. |
Postgres works today via
@sqlfu/pg, but the docs called it a runtime adapter with "toolchain docs still in progress", and thedialectconfig key wasn't documented anywhere. This adds two pages to Guides and fixes the Postgres wording elsewhere.New docs pages:
draft→migrate→generate, runtime use, how it differs from SQLite, and Known gaps.I ran the guide end to end against the docker-compose Postgres in
packages/pg/test. That turned up real bugs. They're documented, not fixed, in the guide's Known gaps and intasks/pg.mdstep three:serialbreaksgenerate(relation "posts_id_seq" does not exist). Identity columns get re-added by every laterdraft. Enums, domains, functions, triggers, matviews, extensions and non-publicschemas either error or get redrafted every time. The cause is the simplified schema renderer inpackages/pg/src/impl/schema.ts. The guide usesuuid default gen_random_uuid()ids because those work.limit 1returns an array,insert ... returningwrappers return no rows, and= :paramparams are typed nullable.kind: 'unknown'.Fixes for these are in progress in #159.
packages/sqlfu/docs/guides/postgres.mdpackages/sqlfu/docs/guides/pgkit.mdwebsite/astro.config.mjs,website/scripts/sync-docs.mjs,website/scripts/sync-llms.mjs,website/public/llms.txt,docs/guides.md,docs/adapters.mdguide tablepackages/sqlfu/README.md(+ regenerated rootREADME.md)dialectis documented under Configuration. Limitations point at Known gaps instead of "docs in progress". Errors and prior-art lines are corrected.docs/adapters.md,docs/errors.md,docs/formatter.md,docs/lint-plugin.md,docs/schema-diff-model.mdsqlfu formatfollows the config, but the lint rule needs{dialect: 'postgresql'}. pg errors aren't classified. The SQLite diff engine isn't the pg one.website/src/content/blog/introducing-sqlfu.mdpackages/pg/README.md,packages/pg/package.jsondescription@sqlfu/pg's npm page was empty.tasks/pg.md,tasks/complete/2026-10-29-pg-docs.mdtasks/pg.mdstill said step one was in review with step two unticked. It now has a current status and a step-three bug list.Verified:
astro build,node --test website/test/, and the rendereddist/links for the new pages.Claude Code session: "Postgres support status" (
local_d8095ac3-f355-44e4-a174-578140e5095e, CLI403039a7-59d0-4757-851e-4d2a4e778da2)🤖 Generated with Claude Code
Package size — packed 280.7 kB (+142 B, 0)
Package size
dist/vendor/*.jsbundlesvendor/sha256.jsvendor/sql-formatter/*.jsvendor/sqlfu-sqlite-parser/*.jsvendor/standard-schema/*.jsvendor/typesql/*.jsMeasured with
npm pack --dry-run --jsononsqlfu(0.0.0-dev on main vs 0.0.0-dev on this PR).