feat: Add maintain command (catalog discovery + per-table extend + CDC-readiness guard)

[codybswaney]

Summary

Adds a maintain command: discover every managed partitioned table from the catalog and extend each in one run, so a scheduler runs a single command and newly-partitioned tables are picked up automatically with no per-table configuration.

• Discovery — finds top-level partitioned parents (relkind = 'p', not themselves partitions) that carry a valid pgslice settings comment; optional --schema filter.
• Per-table extend — runs add_partitions for each discovered table; native (parent-owned PK) and classic-pgslice (per-child PK) tables are handled automatically.
• Per-table isolation — one table's failure is recorded and does not stop the rest of the fleet; the command exits non-zero if any table failed.
• CDC-readiness guard — after extending, verifies every leaf has a replica identity usable for logical replication (a PK under the default identity, or FULL / USING INDEX); surfaces a CDC-unsafe table loudly. Read-only — no replica-identity DDL.

Test plan

• src/maintain.test.ts — e2e against real Postgres (13.20): discovery (exactly the settings-commented parents; unmanaged/plain tables excluded), native-vs-classic classification, bounds-anchored extension with expected names, idempotent re-run, --schema restriction, PK + grant inheritance on new partitions, REPLICA IDENTITY USING INDEX propagation, a CDC-unsafe leaf flagged, and per-table failure isolation (a DEFAULT-blocked table fails alone while the rest still extend).
• src/commands/maintain.test.ts — command-level: exit 0 + per-table summary on a healthy fleet, exit 1 when a leaf has no usable replica identity, and the "no managed tables" message.
• Full suite green on PG 13.20; build + typecheck + prettier clean.

Notes

Targets feature/pgslice-partition-shapes so the diff is maintain-only — review/merge after that branch lands.

🤖 Generated with Claude Code

[greptile-apps]

Greptile Summary

This PR adds a fleet-wide maintain command for managed partitioned tables. The main changes are:

• Catalog discovery for top-level partitioned parents with valid pgslice settings comments.
• Per-table partition extension with period-specific future horizons.
• Per-table result reporting with failure isolation across the fleet.
• CDC readiness checks for leaf partitions after maintenance.
• Command and end-to-end tests for discovery, extension, idempotency, grants, schema filtering, and replica identity handling.

Confidence Score: 5/5

Safe to merge with minimal risk.

The change is well-scoped to the new maintain command and supporting catalog checks. Tests cover discovery, per-period extension, idempotency, grants, CDC readiness, and per-table failure isolation. No blocking correctness or security issues were found in the changed paths.

No files require special attention.

T-Rex Logs

What T-Rex did

• Checked the base state for the maintain discovery extension; the before log shows the base build succeeds, pgslice --help lacks maintain, pgslice maintain --help exits 1 as an unknown command, and the test path src/commands/maintain.test.ts did not exist.
• Observed the after state for the maintain discovery extension; the after log shows the head build succeeds, pgslice --help includes maintain, pgslice maintain --help documents automatic catalog discovery plus --schema and per-period future options, and maintain tests start but fail because PGSLICE_URL cannot resolve a usable database.
• Identified a blocker: no local psql, postgres, initdb, pg_ctl, Docker, or usable database URL was available to create and query the fleet.
• Viewed the before state for maintain-isolation-exit; the base checkout shows a cc38013 and npm test -- src/commands/maintain.test.ts --run reported No test files found.
• Viewed the after state for maintain-isolation-exit; the head checkout fc71924 is used with a local PostgreSQL startup, and the Vitest run across the maintain tests passes all 15 tests.
• Noted that the after state includes a PostgreSQL server log error for blocked_202602 about partition constraints, while the Vitest case passes for the rest of the fleet.
• Checked the before state for the maintain CLI guard; the base artifact shows there is no maintain command guard in place yet.
• Reviewed the after state for the maintain CLI guard; MAINTAIN_EXIT=1 outputs appear with unsafe_default_p2026w01 and unsafe_nothing_p2026w01 only, while stdout reports safe FULL, USING INDEX, and default-identity states, and no replica-identity DDL is issued.
• Examined the before state for maintain-models; the base checkout shows src/maintain.test.ts is absent and Vitest reports no test files.
• Reviewed the after state for maintain-models; head checkout with local Postgres shows MAINTAIN_FIRST creating trex_classic_2026w04/w05 and trex_native creating trex_native_202602/202603, MAINTAIN_SECOND creates no partitions, CATALOG_PK shows primary-key constraints on all children, and the full maintain suite passes 12/12.

_{Ran code and verified through T-Rex}

Important Files Changed

Filename	Overview
src/commands/maintain.ts	Implements the maintain CLI options, per-table reporting, and non-zero exit on failures.
src/pgslice.ts	Adds catalog discovery and per-table maintain orchestration using addPartitions plus replica-identity validation.
src/table.ts	Adds catalog inspection for direct child partitions without usable replica identity.
src/types.ts	Defines maintain option/result types and partition model metadata.
src/maintain.test.ts	Adds end-to-end fleet coverage for discovery, partition extension, idempotency, CDC readiness, grants, and failure isolation.
src/commands/maintain.test.ts	Adds command-level tests for success, CDC guard failure, and empty discovery output.
src/cli.ts	Registers the new maintain command with the CLI.

Sequence Diagram

%%{init: {'theme': 'neutral'}}%%
sequenceDiagram
actor Scheduler
participant CLI as MaintainCommand
participant P as Pgslice.maintain
participant Catalog as Postgres catalog
participant Add as addPartitions
participant Table as Table helpers

Scheduler->>CLI: Run pgslice maintain
CLI->>P: Call maintain with horizons and schema
P->>Catalog: Discover managed partitioned parents
Catalog-->>P: Return tables and periods
loop each managed table
    P->>Add: Extend table for period horizon
    Add-->>P: Return created partition names
    P->>Table: Inspect primary keys partitions and replica identity
    Table-->>P: Return model counts and unsafe leaves
    P-->>CLI: Return MaintainResult
end
CLI-->>Scheduler: Print summaries and exit status

Loading

%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
sequenceDiagram
actor Scheduler
participant CLI as MaintainCommand
participant P as Pgslice.maintain
participant Catalog as Postgres catalog
participant Add as addPartitions
participant Table as Table helpers

Scheduler->>CLI: Run pgslice maintain
CLI->>P: Call maintain with horizons and schema
P->>Catalog: Discover managed partitioned parents
Catalog-->>P: Return tables and periods
loop each managed table
    P->>Add: Extend table for period horizon
    Add-->>P: Return created partition names
    P->>Table: Inspect primary keys partitions and replica identity
    Table-->>P: Return model counts and unsafe leaves
    P-->>CLI: Return MaintainResult
end
CLI-->>Scheduler: Print summaries and exit status

Loading

_{Reviews (2): Last reviewed commit: "feat: Give maintain per-period future ho..." | Re-trigger Greptile}

[greptile-apps]

T-Rex pricing update — T-Rex was free through June 2026. Effective July 1, 2026, T-Rex adds 2 credits on top of the standard 1-credit review (3 total). T-Rex settings