All notable changes to polygres-cli are documented in this file.
- Human-readable durable Context operation failures now include the stable error code, failure stage, and operation ID when those recovery fields are available.
- Updated the bundled public error catalog for actionable collection sync, timeout, connection, memory, storage, and index failures.
- Added one-step
polygres projects create sync <name>orchestration for source inspection, table selection, admission, and project provisioning without exposing internal attempt IDs. - Sync source credentials are accepted only through named environment variables or hidden interactive prompts; mutations expose resumable idempotency keys.
- Synchronized PostgreSQL projects now reject database connection CLI surfaces
with the stable
SYNCED_PROJECT_SURFACE_UNAVAILABLEpermission contract before any database client is started. Public readiness and vector commands remain available.
- Added
polygres rows validate,insert,upsert, andignorefor one JSON object from a file or standard input. - Added explicit pgContext reconciliation with generated or supplied resume
keys, default durable-operation waiting, and
--no-waitsupport.
- Row mutations never automatically retry after authentication, transport, or server uncertainty. Ambiguous outcomes use stable exit code 8.
- Added commands to inspect, update, diagnose, rebuild, and remove text-search configurations.
- Added one-step TSVector setup for creating a generated column, index, and configuration from one or more source columns.
- Text-search commands now support compound row keys, metadata and filter columns, configured result limits, and both generated and existing TSVector columns.
- Added
polygres context initfor reusing eligible pgvector embedding columns with pgContext. - Bundled Runtime API contracts now cover multiple named vectors per Context collection.
polygres vector configs createnow returns a migration error directing users topolygres context collections create.
- Project status commands now consistently honor the global
--projectoption. - Release validation now supports Python 3.10 through its compatible TOML parser.
- Added
polygres contextcommands for configuring, managing, and querying pgContext collections. - Added
polygres api routesandpolygres api requestfor exploring and calling supported Runtime API routes. - Added CLI notices for product updates and important service information.
- Added
polygres vector configs set-default <config-id>for selecting the default vector configuration from the CLI.
- Graph status now explains activation failures and configuration differences.
- Graph configuration now uses
id_columnswhile remaining compatible with existingid_columnconfigurations.
- Graph and vector activation failures now return nonzero exit codes.
- Authentication errors no longer expose internal service details.
- CSV imports now work with destination tables protected by row-level security.
- CSV imports now upload directly to blob staging for improved reliability.
- CSV upload limits now follow the storage allowance of the selected project tier.
- Initial standalone
polygres-clipackage. - Added browser authentication, project management, connection information, Runtime API key management, CSV imports, migrations, graph/vector/text configuration, readiness checks, JSON output, and stable exit codes.