feat(postgres)!: own status families, storage split, one introspect question per family

.github/workflows/test.yml

@@ -61,16 +61,16 @@ jobs:
         with:
           python-version: "3.15"
 
+      - name: Install activerecord and testsuite
+        run: |
+          pip install "rhosocial-activerecord @ git+https://github.com/rhosocial/python-activerecord.git@release/v1.0.0.dev30"
+          pip install "rhosocial-activerecord-testsuite @ git+https://github.com/rhosocial/python-activerecord-testsuite.git@release/v1.0.0.dev17"
+
       - name: Install dependencies
         run: |
           pip install -r requirements.txt
           pip install -r requirements-dev.txt
 
-      - name: Install activerecord and testsuite
-        run: |
-          pip install "rhosocial-activerecord @ git+https://github.com/rhosocial/python-activerecord.git@release/v1.0.0.dev30"
-          pip install "rhosocial-activerecord-testsuite @ git+https://github.com/rhosocial/python-activerecord-testsuite.git@fix/column-constraint-gates"
-
       - name: Create postgres scenario config
         run: |
           cat > postgres_scenarios.yaml << EOF
@@ -276,16 +276,16 @@ jobs:
           python-version: ${{ matrix.python-version }}
           freethreaded: ${{ matrix.freethreaded }}
 
+      - name: Install activerecord and testsuite
+        run: |
+          pip install "rhosocial-activerecord @ git+https://github.com/rhosocial/python-activerecord.git@release/v1.0.0.dev30"
+          pip install "rhosocial-activerecord-testsuite @ git+https://github.com/rhosocial/python-activerecord-testsuite.git@release/v1.0.0.dev17"
+
       - name: Install dependencies
         run: |
           pip install -r requirements.txt
           pip install -r requirements-dev.txt
 
-      - name: Install activerecord and testsuite
-        run: |
-          pip install "rhosocial-activerecord @ git+https://github.com/rhosocial/python-activerecord.git@release/v1.0.0.dev30"
-          pip install "rhosocial-activerecord-testsuite @ git+https://github.com/rhosocial/python-activerecord-testsuite.git@fix/column-constraint-gates"
-
       - name: Create postgres scenario config
         run: |
           cat > postgres_scenarios.yaml << EOF
@@ -383,6 +383,11 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
+      - name: Install activerecord and testsuite
+        run: |
+          pip install "rhosocial-activerecord @ git+https://github.com/rhosocial/python-activerecord.git@release/v1.0.0.dev30"
+          pip install "rhosocial-activerecord-testsuite @ git+https://github.com/rhosocial/python-activerecord-testsuite.git@release/v1.0.0.dev17"
+
       - name: Install dependencies
         run: |
           if [ "${{ matrix.python-version }}" == "3.8" ]; then
@@ -393,11 +398,6 @@ jobs:
             pip install -r requirements-dev.txt
           fi
 
-      - name: Install activerecord and testsuite
-        run: |
-          pip install "rhosocial-activerecord @ git+https://github.com/rhosocial/python-activerecord.git@release/v1.0.0.dev30"
-          pip install "rhosocial-activerecord-testsuite @ git+https://github.com/rhosocial/python-activerecord-testsuite.git@fix/column-constraint-gates"
-
       - name: Create postgres scenario config
         run: |
           cat > postgres_scenarios.yaml << EOF
@@ -486,16 +486,16 @@ jobs:
         with:
           python-version: "3.14"
 
+      - name: Install activerecord and testsuite
+        run: |
+          pip install "rhosocial-activerecord @ git+https://github.com/rhosocial/python-activerecord.git@release/v1.0.0.dev30"
+          pip install "rhosocial-activerecord-testsuite @ git+https://github.com/rhosocial/python-activerecord-testsuite.git@release/v1.0.0.dev17"
+
       - name: Install dependencies
         run: |
           pip install -r requirements.txt
           pip install -r requirements-dev.txt
 
-      - name: Install activerecord and testsuite
-        run: |
-          pip install "rhosocial-activerecord @ git+https://github.com/rhosocial/python-activerecord.git@release/v1.0.0.dev30"
-          pip install "rhosocial-activerecord-testsuite @ git+https://github.com/rhosocial/python-activerecord-testsuite.git@fix/column-constraint-gates"
-
       - name: Create postgres scenario config
         run: |
           cat > postgres_scenarios.yaml << EOF

CLAUDE.md

@@ -35,6 +35,30 @@ This project is under active development. Key features implemented:
 
 This project adheres to the same version control, branching, commit message, and changelog management standards as the main `python-activerecord` project.
 
+## Async Backend and the Windows Event Loop
+
+psycopg's async mode waits on the libpq socket with `loop.add_reader` /
+`loop.add_writer`, which on Windows the platform default event loop
+(`ProactorEventLoop`, since 3.8) does not implement. Therefore:
+
+- The sync path is unaffected everywhere.
+- `AsyncPostgresBackend` requires a selector-based event loop on Windows
+  (`SelectorEventLoop(SelectSelector())`). psycopg 3.3+ detects the
+  mismatch at connect time and raises with the fix named; older versions
+  surface asyncio's raw `NotImplementedError`.
+- To run async code on Windows, use the helper this backend ships:
+  `run_coroutine(coro)` from
+  `rhosocial.activerecord.backend.impl.postgres.async_support` -- it
+  constructs the required loop and gives it `asyncio.run`-grade
+  lifecycle (cancel on `KeyboardInterrupt`, shutdown of async generators,
+  close, detach). It may only be called when no loop is running.
+- The CLI's `--async` modes (`introspect`, `query`, `status`) already use
+  it, so they work on Windows out of the box.
+- Do NOT "fix" this by switching the global event loop policy:
+  `WindowsSelectorEventLoopPolicy` is deprecated for removal in Python
+  3.16, and a selector loop on Windows cannot serve asyncio subprocess or
+  pipe I/O, which would break other parts of the process.
+
 ## Search Scope
 
 - Use `rg` for repository searches; never use `grep`.

changelog.d/64.added.md

@@ -0,0 +1 @@
+Own the status families core moved out -- `WALInfo`, `ReplicationInfo`, `ArchiveInfo` and `SecurityInfo` -- beside `PostgreSQLServerOverview`, keeping `get_overview()`'s signature through a covariant return. Render `pg_relation_size` and `pg_indexes_size` as expression nodes bound to the listing row's oid so the total rides the table listing; a row count prefers `reltuples`, falls back to `n_live_tup` and normalizes `-1` to `None`; `table-storage` becomes a CLI type because the capability had to be askable. Answer the operational families from `pg_stat_user_indexes`, `pg_stat_user_tables`, `pg_stat_activity` and `pg_depend` (`pg_stat_statements` is deliberately not read), and profile columns and samples from `pg_stats`, labelled `ESTIMATE` or `UNKNOWN` by vintage, with arrays through `to_jsonb` and exact join coverage. DDL extraction is declared but answers without text: `get_ddl_statement` returns `None`, the CLI exits 1 with "no DDL available", and `supports_ddl_extraction_native()` is `False`. Ten CLI types derive from `_TYPE_CAPABILITIES`, `supports_extensions` delegates so one capability is one answer, and `async_support.py` supplies `run_coroutine()` for the CLI's three `--async` modes on Windows.

changelog.d/64.removed.md

@@ -0,0 +1 @@
+Rename `SyncPostgreSQLIntrospector` to `PostgreSQLIntrospector` and `SyncPostgreSQLStatusIntrospector` to `PostgreSQLStatusIntrospector`. Backend developers subclassing the old names must attach to core's `AbstractIntrospector` and `AbstractStatusIntrospector` through `IntrospectorExecutor`.