Skip to content

Commit 8153419

Browse files
committed
docs(skills): cutover on v3 is phase-aware — exit 0 only when backfilled
Claude-Session: https://claude.ai/code/session_01MxTTPaPP16m6br7Hoab94w
1 parent c04ffe3 commit 8153419

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

skills/stash-cli/SKILL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -464,7 +464,7 @@ Backfill **auto-detects the target column's EQL version** from its Postgres doma
464464
stash encrypt cutover --table users --column email
465465
```
466466

467-
**EQL v2 only** — v3 has no cut-over: the application switches to `<col>_encrypted` by name, and running this command on a v3 column reports "not applicable" (exit 0) with the next step. For v2, the preconditions are: the column is in the `backfilled` phase, **and** a pending EQL configuration exists.
467+
**EQL v2 only** — v3 has no cut-over: the application switches to the encrypted column by name. Running this command on a **backfilled** v3 column reports "not applicable" (exit 0) with the next step; before backfill completes it exits 1 and says to finish the backfill (never "switch now" onto a half-populated column). For v2, the preconditions are: the column is in the `backfilled` phase, **and** a pending EQL configuration exists (on a v3-only database — no `eql_v2_configuration` table — it explains that and exits 1).
468468

469469
In one transaction it renames `<col>``<col>_plaintext` and `<col>_encrypted``<col>`, advances the pending config to `encrypting`, activates it, and appends a `cut_over` event. With a Proxy URL configured (`--proxy-url` or `CIPHERSTASH_PROXY_URL`) it then calls `eql_v2.reload_config()` so Proxy picks up the new shape.
470470

0 commit comments

Comments
 (0)