fix(docs): strip foreign-schema bleed from per-stack schema docs

[WhatIfWeDigDeeper]

Summary

Closes #303.

tbls's --include "\${schema}.*" filter has two limitations the script didn't compensate for:

• Filters tables, not enums — every per-schema README's ## Enums section listed the union of all 26+ Postgres enum types across every stack's schema. docs/schema/ruby-rails/README.md carried 24 foreign rows even though rails-api defines zero Postgres enums of its own.
• Treats the . in \${schema}.* as a regex match-any-char — schemas whose names share a prefix (react_nestjs vs react_nestjs_history) bleed each other's tables, schema.json entries, Mermaid entities, and per-table .md files.

This PR:

1. Adds a post-process pass to scripts/generate-schema-docs.sh that walks each per-schema dir and:
   • drops foreign-schema rows from ## Enums and ## Tables
   • drops Mermaid entity blocks and relation lines for foreign schemas
   • filters schema.json tables[] to own-schema entries only
   • removes leaked ${other_schema}.*.md files
   • drops the ## Enums heading entirely when no own-schema rows remain (rails has none)
2. Clears each schema dir before invoking tbls — otherwise stale .md files (tables dropped from the DB, like the old express_prisma._prisma_migrations) survive forever and the Mermaid column-swap toggles their content on every run, breaking idempotence.
3. Regenerates all 11 per-stack schema docs (the visible cleanup).
4. Adds pkey, fkey, nextval, regclass to cspell — these appear in constraint and sequence-default expressions tbls emits.

Acceptance criteria (per #303)

• Each docs/schema/<stack>/README.md ## Enums section lists only enums from that stack's schema.
• docs/schema/ruby-rails/README.md no longer has an ## Enums section.
• All 11 schema READMEs regenerated and committed in the same PR.
• scripts/generate-schema-docs.sh continues to be safe to re-run (idempotent).
• Each docs/schema/<stack>/README.md ## Tables section lists only tables from that stack's schema.
• Each docs/schema/<stack>/ directory contains only ${schema}.*.md files.
• Each docs/schema/<stack>/schema.json contains only its own schema's tables.
• Each docs/schema/<stack>/README.md Mermaid ## Relations diagram contains only its own schema's entities.

Test plan

• docker compose up -d postgres && npm run docs:schema re-runs cleanly.
• Re-running produces no diff (idempotent).
• docs/schema/ruby-rails/README.md has no ## Enums section.
• docs/schema/react-nestjs/README.md references no react_nestjs_history.* rows.
• docs/schema/lambda-api/README.md (hand-written DynamoDB docs, outside SCHEMAS) unchanged from main.

🤖 Generated with Claude Code

[Copilot]

Pull request overview

This PR fixes tbls per-schema documentation bleed by adding a cleanup pass to the schema-doc generation script and regenerating the committed docs/schema/<stack>/ outputs so each stack’s docs only reflect its own Postgres schema.

Changes:

• Clear each per-stack schema docs directory before running tbls doc to avoid stale .md files and non-idempotent Mermaid column swaps.
• Post-process generated READMEs to remove foreign-schema rows in ## Tables / ## Enums and foreign entities/relations in Mermaid ERDs; delete leaked ${other_schema}.*.md files; filter schema.json tables to own-schema entries.
• Update cspell dictionary to accept common constraint/sequence tokens emitted by tbls.

Reviewed changes

Copilot reviewed 24 out of 24 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
scripts/generate-schema-docs.sh	Clears per-stack docs dirs, scopes Mermaid column swap to generated dirs, and adds post-processing to strip foreign-schema leaks.
cspell.config.yaml	Adds schema/constraint-related terms to cspell allowlist.
docs/schema/vue-nuxt/README.md	Regenerated: removes foreign-schema enum rows from ## Enums.
docs/schema/svelte-hono/README.md	Regenerated: removes foreign-schema enum rows from ## Enums.
docs/schema/ruby-rails/schema.json	Regenerated: includes rails schema tables; (still includes cross-db enums in .enums).
docs/schema/ruby-rails/ruby_rails.schema_migrations.md	New generated table doc.
docs/schema/ruby-rails/ruby_rails.internal_metadata.md	New generated table doc.
docs/schema/ruby-rails/README.md	Regenerated: removes foreign-schema ## Enums section and includes rails-only tables/relations.
docs/schema/react-nestjs/schema.json	Regenerated: removes leaked react_nestjs_history.* table entries.
docs/schema/react-nestjs/README.md	Regenerated: removes leaked react_nestjs_history.* tables, enums, and Mermaid entities.
docs/schema/react-nestjs/react_nestjs_history.knex_migrations.md	Deleted leaked per-table doc from wrong schema directory.
docs/schema/react-nestjs/react_nestjs_history.knex_migrations_lock.md	Deleted leaked per-table doc from wrong schema directory.
docs/schema/react-nestjs/react_nestjs_history.application_history.md	Deleted leaked per-table doc from wrong schema directory.
docs/schema/react-nestjs-history/README.md	Regenerated: removes foreign-schema enum rows from ## Enums.
docs/schema/react-koa/schema.json	Regenerated output (includes normalized constraint expressions).
docs/schema/react-koa/README.md	Regenerated: removes foreign-schema enum rows from ## Enums.
docs/schema/python-fastapi/README.md	Regenerated: removes foreign-schema enum rows from ## Enums.
docs/schema/java-spring/schema.json	Regenerated output (includes normalized constraint expressions).
docs/schema/java-spring/README.md	Regenerated: removes foreign-schema enum rows from ## Enums.
docs/schema/graphql-yoga/README.md	Regenerated: removes foreign-schema enum rows from ## Enums.
docs/schema/go-gin/schema.json	Regenerated output (includes normalized constraint expressions).
docs/schema/go-gin/README.md	Regenerated: removes foreign-schema ## Enums section content.
docs/schema/express-prisma/README.md	Regenerated: removes foreign-schema enum rows from ## Enums.
docs/schema/express-prisma/express_prisma._prisma_migrations.md	Removed stale generated doc for a dropped table.

[Copilot]

Pull request overview

Copilot reviewed 30 out of 30 changed files in this pull request and generated no new comments.