feat: upstream COMMENT ON statements, inflection improvements, and other changes from constructive-db

[pyramation]

Summary

Bulk upstream of changes that accumulated in constructive-io/constructive-db/pgpm-modules/ but were never synced back to this repo. The changes fall into three categories:

1. COMMENT ON statements (~294 additions): Adds PostgreSQL COMMENT ON documentation to tables, columns, domains, constraints, and procedures across 11 modules: achievements, database-jobs, encrypted-secrets-table, jobs, measurements, uuid, types, geotypes, metaschema-schema, metaschema-modules, and services.

2. Inflection module improvements: Fixes octopi → octopuses, adds uncountable word handling (sheep, equipment, information, etc.), adds Latin suffix overrides (schemata → schema, phenomena → phenomenon, etc.), and introduces a new should_skip_uncountable procedure. Tests expanded accordingly.

3. Schema/structural changes:

   • jwt-claims: New current_session_id procedure, version bumped to 0.15.5
   • metaschema-modules: New relation_provision table (deploy/revert/verify), @omit/@fieldName constraint annotations
   • metaschema-schema: object_category type changes, pgpm.plan updates, test snapshots added
   • types: New pgpm-types--0.15.5.sql, version control file changed, test rewrites

Review & Testing Checklist for Human

• types version downgrade: pgpm-types.control changes default_version from 0.16.0 → 0.15.5. The repo already has a pgpm-types--0.16.0.sql file. Verify this is intentional and won't break consumers expecting 0.16.0.
• types test coverage reduction: domains.test.ts and domains.pgutils.test.ts were substantially rewritten to simpler versions. The origin column was removed from the test table, and origin-specific tests were dropped. Verify the reduced test surface is acceptable.
• Inflection behavioral changes: Plural/singular rules changed (octopi → octopuses, new uncountable words, Latin suffixes). Verify downstream consumers are compatible with these linguistic corrections.
• metaschema-modules structural changes: New relation_provision table added; field_module revert/verify files modified; large diff in compiled metaschema-modules--0.15.5.sql. Verify these schema changes are safe for existing deployments.
• Spot-check COMMENT ON accuracy: Pick a few modules and verify the comments accurately describe the columns/tables (e.g., check jobs.jobs table comments against actual schema).

Test Plan

1. Deploy to a test database and verify migrations apply cleanly
2. Run test suites for modified packages (especially inflection, types, metaschema-modules)
3. Verify no breaking changes for downstream consumers (e.g., check if any apps depend on pgpm-types@0.16.0)

Notes

• Changes were bulk-copied from constructive-db/pgpm-modules/ to pgpm-modules/packages/ after verifying no remaining diffs (excluding node_modules, package.json, and files only in upstream)
• Some files only in upstream (secure_table_provision, rls_function, services/__tests__, pgpm-types--0.16.0.sql) were intentionally left untouched
• Link to Devin run: https://app.devin.ai/sessions/462ca0fe097045f58a173180575d4a27
• Requested by: @pyramation

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment and CI monitoring