# Skewcheck: ⛔ UNSAFE — reproducible compatibility regression

> **Question:** does the previous application version still work against the proposed database schema?

The previous application version reproducibly fails against the proposed schema, and the failure is linked to a specific schema change.

| | |
|---|---|
| Project | fixture/I-type-change |
| Execution | `example-I-type-change` |
| Baseline (old app) | `shop-v1` |
| Candidate | `I-type-change` |
| PostgreSQL | 16.15 (Debian 16.15-1.pgdg12+2) |
| Proposed migration(s) | `002_status_enum.sql` |
| Gate | **blocking** (exit 1) |
| Experiment complete | yes |

## Why
- test/orders.test.js: SQLSTATE 22P02 (invalid_text_representation) linked to column_type_changed:orders.status by R6 type error ↔ changed column type.

## Recommended next action
Make the migration backward compatible (expand/contract: keep the old shape until the old version is retired), then re-run the gate.

## Evidence
### regression — `test/orders.test.js`
**Observed:**
- test/orders.test.js passes on the baseline schema and fails in all 2 candidate runs.
- New in every candidate run, absent from the control run: SQLSTATE 22P02 (invalid_text_representation): invalid input value for enum order_status: "shipped" — statement: UPDATE orders SET status = 'shipped' WHERE id = $1
**Interpretation:** The failing statement uses orders.status (text → order_status).
**Correlation rule:** R6 type error ↔ changed column type (strong)
**Linked change(s):** `column_type_changed:orders.status`

## Schema changes (catalog diff)
| Change | Risk | Exercised by old app | Tests |
|---|---|---|---|
| Column orders.status type text → order_status | breaking | yes (4 stmt) | `test/orders.test.js` |
| Column orders.status default 'new'::text → 'new'::order_status | behavioral | yes (2 stmt) | `test/orders.test.js` |

**Coverage:** 2 of 2 risk-bearing schema change(s) were exercised by the old application's tests in the control run.

## Runs
| Run | Migrations | Tests (pass/fail/other) | DB errors | Statements |
|---|---|---|---|---|
| control (old app × baseline schema) | 1/1 applied | 2/0/0 | 0 | 7 |
| candidate #1 (old app × proposed schema) | 2/2 applied | 1/1/0 | 1 (22P02 invalid_text_representation) | 4 |
| candidate #2 (old app × proposed schema) | 2/2 applied | 1/1/0 | 1 (22P02 invalid_text_representation) | 4 |

## Skipped checks
- Current application × proposed schema (no current app configured).
- Performance / lock-time analysis (out of scope).

## Limitations
- Skewcheck only observes code paths that the old application's tests execute; untested paths are reported as coverage gaps, not as safe.
- Coverage is identifier-level: a statement "touches" a changed object when it names the table (and column, or uses *). It is not a SQL parser.
- Correlation between an error and a schema change uses a fixed set of deterministic rules (R1–R6). Anything else is reported as ADVISORY, never UNSAFE.
- Performance, locking and migration runtime on production-sized data are not evaluated.
- Test files of one run share a database and run sequentially; ordering effects are identical across runs but are not isolated.
- Data-only migration effects are detected only when a test asserts on the affected data.

<sub>skewcheck 0.1.0 · report schema v1 · 2026-10-24T18:30:06.114Z</sub>