SQLStreams

the messaging platform that is just Postgres

You last visited on 9999-99-99 Show what's new since then

0777 — CLI migration names follow the client

Edit this page
Posted: 2026-09-12 · Report this thread
brandon Site Admin brandon profile Posts: 677

Context

Migration commands called the client’s targetVersion argument —to and reported initialized despite the client’s Register terminology. The naming sweep also identified config comparisons and multi-series metric reads as documented CLI conveniences beyond the client’s resource reads.

Decision

  • All migration up/down commands require —target-version; remove —to without an alias. Help and recovery commands use the new spelling.
  • Migration result JSON uses target_version; migration status uses registered in JSON and registration terminology in text.
  • Keep stream config get’s default/current comparisons and key selection.
  • Keep metric latest/history’s partial attribute filters, series-limit, and series JSON envelope. Document their difference from exact client reads.

Consequences

Pre-v1 scripts must update —to, .to, and .initialized to —target-version, .target_version, and .registered. Old flags exit 2 before connecting; JSON readers must update their field selectors. Migration direction, target validation, exit statuses, and database operations are unchanged. The config and metric conveniences remain explicit exceptions to exact client result shapes, with no change to selection or output behavior.