supaschema 0.1.0-rc.1

package/docs/benchmarks/xl-correctness.svg

@@ -0,0 +1,86 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="454" viewBox="0 0 1200 454" role="img">
+<defs>
+<linearGradient id="supaGradient" x1="0" y1="0" x2="1" y2="0">
+<stop offset="0%" stop-color="#059669" />
+<stop offset="100%" stop-color="#34d399" />
+</linearGradient>
+<linearGradient id="slateGradient" x1="0" y1="0" x2="1" y2="0">
+<stop offset="0%" stop-color="#3b4757" />
+<stop offset="100%" stop-color="#526079" />
+</linearGradient>
+</defs>
+<rect width="100%" height="100%" rx="14" fill="#0b1220" />
+<text x="36.0" y="46.0" fill="#f8fafc" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="21" font-weight="700">Verification &amp; accuracy — xl fixture (1,000 tables)</text>
+<text x="36.0" y="70.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12.5" font-weight="400">Each generated migration is applied in one transaction, applied again, and the catalog is fingerprinted against the target.</text>
+<text x="36.0" y="88.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12.5" font-weight="400">Output F1 scores generated SQL content against the fixture's ground-truth change manifest (1.000 = exact).</text>
+<text x="490.0" y="116.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">applies once</text>
+<text x="670.0" y="116.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">applies twice</text>
+<text x="850.0" y="116.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">matches target</text>
+<text x="1045.0" y="116.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">output F1</text>
+<circle cx="41" cy="143" r="4" fill="#34d399" />
+<text x="54.0" y="147.0" fill="#f8fafc" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="650">supaschema-db</text>
+<rect x="430" y="132" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="490.0" y="147.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="610" y="132" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="670.0" y="147.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="790" y="132" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="850.0" y="147.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="985" y="132" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="1045.0" y="147.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">1.000</text>
+<circle cx="41" cy="181" r="4" fill="#34d399" />
+<text x="54.0" y="185.0" fill="#f8fafc" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="650">supaschema-file</text>
+<rect x="430" y="170" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="490.0" y="185.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="610" y="170" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="670.0" y="185.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="790" y="170" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="850.0" y="185.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="985" y="170" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="1045.0" y="185.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">1.000</text>
+<text x="54.0" y="223.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-default</text>
+<rect x="430" y="208" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="490.0" y="223.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="610" y="208" width="120" height="23" rx="11.5" fill="rgba(239,68,68,0.12)" stroke="#ef4444" stroke-opacity="0.55" />
+<text x="670.0" y="223.5" fill="#f87171" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✗ 0/3</text>
+<rect x="790" y="208" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="850.0" y="223.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="985" y="208" width="120" height="23" rx="11.5" fill="rgba(251,191,36,0.12)" stroke="#fbbf24" stroke-opacity="0.55" />
+<text x="1045.0" y="223.5" fill="#fbbf24" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">0.999</text>
+<text x="54.0" y="261.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-migra</text>
+<rect x="430" y="246" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="490.0" y="261.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="610" y="246" width="120" height="23" rx="11.5" fill="rgba(239,68,68,0.12)" stroke="#ef4444" stroke-opacity="0.55" />
+<text x="670.0" y="261.5" fill="#f87171" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✗ 0/3</text>
+<rect x="790" y="246" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="850.0" y="261.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="985" y="246" width="120" height="23" rx="11.5" fill="rgba(251,191,36,0.12)" stroke="#fbbf24" stroke-opacity="0.55" />
+<text x="1045.0" y="261.5" fill="#fbbf24" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">0.999</text>
+<text x="54.0" y="299.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-pg-delta</text>
+<rect x="430" y="284" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="490.0" y="299.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="610" y="284" width="120" height="23" rx="11.5" fill="rgba(239,68,68,0.12)" stroke="#ef4444" stroke-opacity="0.55" />
+<text x="670.0" y="299.5" fill="#f87171" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✗ 0/3</text>
+<rect x="790" y="284" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="850.0" y="299.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="985" y="284" width="120" height="23" rx="11.5" fill="rgba(251,191,36,0.12)" stroke="#fbbf24" stroke-opacity="0.55" />
+<text x="1045.0" y="299.5" fill="#fbbf24" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">0.999</text>
+<text x="54.0" y="337.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-pg-schema</text>
+<rect x="430" y="322" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="490.0" y="337.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="610" y="322" width="120" height="23" rx="11.5" fill="rgba(239,68,68,0.12)" stroke="#ef4444" stroke-opacity="0.55" />
+<text x="670.0" y="337.5" fill="#f87171" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✗ 0/3</text>
+<rect x="790" y="322" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="850.0" y="337.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="985" y="322" width="120" height="23" rx="11.5" fill="rgba(251,191,36,0.12)" stroke="#fbbf24" stroke-opacity="0.55" />
+<text x="1045.0" y="337.5" fill="#fbbf24" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">0.999</text>
+<text x="54.0" y="375.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-pgadmin</text>
+<rect x="430" y="360" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="490.0" y="375.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="610" y="360" width="120" height="23" rx="11.5" fill="rgba(239,68,68,0.12)" stroke="#ef4444" stroke-opacity="0.55" />
+<text x="670.0" y="375.5" fill="#f87171" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✗ 0/3</text>
+<rect x="790" y="360" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="850.0" y="375.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 3/3</text>
+<rect x="985" y="360" width="120" height="23" rx="11.5" fill="rgba(251,191,36,0.12)" stroke="#fbbf24" stroke-opacity="0.55" />
+<text x="1045.0" y="375.5" fill="#fbbf24" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">0.999</text>
+<text x="36.0" y="432.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400">supaschema 0.1.0  ·  Supabase CLI 2.106.0  ·  Node v24.14.0  ·  Apple Silicon  ·  3 iterations</text>
+</svg>

package/docs/benchmarks/xl-latency.svg

@@ -0,0 +1,60 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="410" viewBox="0 0 1200 410" role="img">
+<defs>
+<linearGradient id="supaGradient" x1="0" y1="0" x2="1" y2="0">
+<stop offset="0%" stop-color="#059669" />
+<stop offset="100%" stop-color="#34d399" />
+</linearGradient>
+<linearGradient id="slateGradient" x1="0" y1="0" x2="1" y2="0">
+<stop offset="0%" stop-color="#3b4757" />
+<stop offset="100%" stop-color="#526079" />
+</linearGradient>
+</defs>
+<rect width="100%" height="100%" rx="14" fill="#0b1220" />
+<text x="36.0" y="46.0" fill="#f8fafc" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="21" font-weight="700">Diff latency — xl fixture (1,000 tables)</text>
+<text x="36.0" y="70.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12.5" font-weight="400">Median seconds per diff, log scale · whisker marks p95 · lower is better</text>
+<line x1="300.0" y1="94" x2="300.0" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="300.0" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">1.00s</text>
+<line x1="399.3" y1="94" x2="399.3" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="399.3" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">2.00s</text>
+<line x1="530.7" y1="94" x2="530.7" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="530.7" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">5.00s</text>
+<line x1="630.0" y1="94" x2="630.0" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="630.0" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">10.0s</text>
+<line x1="729.3" y1="94" x2="729.3" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="729.3" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">20.0s</text>
+<line x1="860.7" y1="94" x2="860.7" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="860.7" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">50.0s</text>
+<line x1="960.0" y1="94" x2="960.0" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="960.0" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">100s</text>
+<circle cx="41" cy="117" r="4" fill="#34d399" />
+<text x="54.0" y="121.0" fill="#f8fafc" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="650">supaschema-file</text>
+<rect x="300" y="108" width="48.7" height="18" rx="4" fill="url(#supaGradient)" />
+<line x1="354.8" y1="105" x2="354.8" y2="129" stroke="#f8fafc" stroke-opacity="0.55" stroke-width="2" />
+<text x="1164.0" y="121.0" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" font-weight="650" text-anchor="end">1.41s  ·  p95 1.47s</text>
+<circle cx="41" cy="151" r="4" fill="#34d399" />
+<text x="54.0" y="155.0" fill="#f8fafc" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="650">supaschema-db</text>
+<rect x="300" y="142" width="73.0" height="18" rx="4" fill="url(#supaGradient)" />
+<line x1="436.1" y1="139" x2="436.1" y2="163" stroke="#f8fafc" stroke-opacity="0.55" stroke-width="2" />
+<text x="1164.0" y="155.0" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" font-weight="650" text-anchor="end">1.66s  ·  p95 2.58s</text>
+<text x="54.0" y="189.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-migra</text>
+<rect x="300" y="176" width="525.7" height="18" rx="4" fill="url(#slateGradient)" />
+<line x1="830.6" y1="173" x2="830.6" y2="197" stroke="#f8fafc" stroke-opacity="0.55" stroke-width="2" />
+<text x="1164.0" y="189.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" font-weight="450" text-anchor="end">39.2s  ·  p95 40.5s</text>
+<text x="54.0" y="223.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-pg-schema</text>
+<rect x="300" y="210" width="531.9" height="18" rx="4" fill="url(#slateGradient)" />
+<line x1="838.4" y1="207" x2="838.4" y2="231" stroke="#f8fafc" stroke-opacity="0.55" stroke-width="2" />
+<text x="1164.0" y="223.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" font-weight="450" text-anchor="end">40.9s  ·  p95 42.8s</text>
+<text x="54.0" y="257.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-pg-delta</text>
+<rect x="300" y="244" width="532.1" height="18" rx="4" fill="url(#slateGradient)" />
+<line x1="832.6" y1="241" x2="832.6" y2="265" stroke="#f8fafc" stroke-opacity="0.55" stroke-width="2" />
+<text x="1164.0" y="257.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" font-weight="450" text-anchor="end">41.0s  ·  p95 41.1s</text>
+<text x="54.0" y="291.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-pgadmin</text>
+<rect x="300" y="278" width="535.3" height="18" rx="4" fill="url(#slateGradient)" />
+<line x1="839.5" y1="275" x2="839.5" y2="299" stroke="#f8fafc" stroke-opacity="0.55" stroke-width="2" />
+<text x="1164.0" y="291.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" font-weight="450" text-anchor="end">41.9s  ·  p95 43.1s</text>
+<text x="54.0" y="325.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-default</text>
+<rect x="300" y="312" width="539.2" height="18" rx="4" fill="url(#slateGradient)" />
+<line x1="856.6" y1="309" x2="856.6" y2="333" stroke="#f8fafc" stroke-opacity="0.55" stroke-width="2" />
+<text x="1164.0" y="325.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" font-weight="450" text-anchor="end">43.1s  ·  p95 48.6s</text>
+<text x="36.0" y="388.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400">supaschema 0.1.0  ·  Supabase CLI 2.106.0  ·  Node v24.14.0  ·  Apple Silicon  ·  3 iterations</text>
+</svg>

package/docs/benchmarks/xxl-correctness.svg

@@ -0,0 +1,86 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="454" viewBox="0 0 1200 454" role="img">
+<defs>
+<linearGradient id="supaGradient" x1="0" y1="0" x2="1" y2="0">
+<stop offset="0%" stop-color="#059669" />
+<stop offset="100%" stop-color="#34d399" />
+</linearGradient>
+<linearGradient id="slateGradient" x1="0" y1="0" x2="1" y2="0">
+<stop offset="0%" stop-color="#3b4757" />
+<stop offset="100%" stop-color="#526079" />
+</linearGradient>
+</defs>
+<rect width="100%" height="100%" rx="14" fill="#0b1220" />
+<text x="36.0" y="46.0" fill="#f8fafc" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="21" font-weight="700">Verification &amp; accuracy — xxl fixture (2,500 tables)</text>
+<text x="36.0" y="70.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12.5" font-weight="400">Each generated migration is applied in one transaction, applied again, and the catalog is fingerprinted against the target.</text>
+<text x="36.0" y="88.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12.5" font-weight="400">Output F1 scores generated SQL content against the fixture's ground-truth change manifest (1.000 = exact).</text>
+<text x="490.0" y="116.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">applies once</text>
+<text x="670.0" y="116.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">applies twice</text>
+<text x="850.0" y="116.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">matches target</text>
+<text x="1045.0" y="116.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">output F1</text>
+<circle cx="41" cy="143" r="4" fill="#34d399" />
+<text x="54.0" y="147.0" fill="#f8fafc" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="650">supaschema-db</text>
+<rect x="430" y="132" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="490.0" y="147.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="610" y="132" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="670.0" y="147.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="790" y="132" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="850.0" y="147.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="985" y="132" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="1045.0" y="147.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">1.000</text>
+<circle cx="41" cy="181" r="4" fill="#34d399" />
+<text x="54.0" y="185.0" fill="#f8fafc" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="650">supaschema-file</text>
+<rect x="430" y="170" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="490.0" y="185.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="610" y="170" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="670.0" y="185.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="790" y="170" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="850.0" y="185.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="985" y="170" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="1045.0" y="185.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">1.000</text>
+<text x="54.0" y="223.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-default</text>
+<rect x="430" y="208" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="490.0" y="223.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="610" y="208" width="120" height="23" rx="11.5" fill="rgba(239,68,68,0.12)" stroke="#ef4444" stroke-opacity="0.55" />
+<text x="670.0" y="223.5" fill="#f87171" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✗ 0/1</text>
+<rect x="790" y="208" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="850.0" y="223.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="985" y="208" width="120" height="23" rx="11.5" fill="rgba(251,191,36,0.12)" stroke="#fbbf24" stroke-opacity="0.55" />
+<text x="1045.0" y="223.5" fill="#fbbf24" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">0.999</text>
+<text x="54.0" y="261.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-migra</text>
+<rect x="430" y="246" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="490.0" y="261.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="610" y="246" width="120" height="23" rx="11.5" fill="rgba(239,68,68,0.12)" stroke="#ef4444" stroke-opacity="0.55" />
+<text x="670.0" y="261.5" fill="#f87171" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✗ 0/1</text>
+<rect x="790" y="246" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="850.0" y="261.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="985" y="246" width="120" height="23" rx="11.5" fill="rgba(251,191,36,0.12)" stroke="#fbbf24" stroke-opacity="0.55" />
+<text x="1045.0" y="261.5" fill="#fbbf24" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">0.999</text>
+<text x="54.0" y="299.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-pg-delta</text>
+<rect x="430" y="284" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="490.0" y="299.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="610" y="284" width="120" height="23" rx="11.5" fill="rgba(239,68,68,0.12)" stroke="#ef4444" stroke-opacity="0.55" />
+<text x="670.0" y="299.5" fill="#f87171" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✗ 0/1</text>
+<rect x="790" y="284" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="850.0" y="299.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="985" y="284" width="120" height="23" rx="11.5" fill="rgba(251,191,36,0.12)" stroke="#fbbf24" stroke-opacity="0.55" />
+<text x="1045.0" y="299.5" fill="#fbbf24" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">0.999</text>
+<text x="54.0" y="337.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-pg-schema</text>
+<rect x="430" y="322" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="490.0" y="337.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="610" y="322" width="120" height="23" rx="11.5" fill="rgba(239,68,68,0.12)" stroke="#ef4444" stroke-opacity="0.55" />
+<text x="670.0" y="337.5" fill="#f87171" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✗ 0/1</text>
+<rect x="790" y="322" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="850.0" y="337.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="985" y="322" width="120" height="23" rx="11.5" fill="rgba(251,191,36,0.12)" stroke="#fbbf24" stroke-opacity="0.55" />
+<text x="1045.0" y="337.5" fill="#fbbf24" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">0.999</text>
+<text x="54.0" y="375.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-pgadmin</text>
+<rect x="430" y="360" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="490.0" y="375.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="610" y="360" width="120" height="23" rx="11.5" fill="rgba(239,68,68,0.12)" stroke="#ef4444" stroke-opacity="0.55" />
+<text x="670.0" y="375.5" fill="#f87171" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✗ 0/1</text>
+<rect x="790" y="360" width="120" height="23" rx="11.5" fill="rgba(16,185,129,0.14)" stroke="#10b981" stroke-opacity="0.55" />
+<text x="850.0" y="375.5" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">✓ 1/1</text>
+<rect x="985" y="360" width="120" height="23" rx="11.5" fill="rgba(251,191,36,0.12)" stroke="#fbbf24" stroke-opacity="0.55" />
+<text x="1045.0" y="375.5" fill="#fbbf24" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11.5" font-weight="600" text-anchor="middle">0.999</text>
+<text x="36.0" y="432.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400">supaschema 0.1.0  ·  Supabase CLI 2.106.0  ·  Node v24.14.0  ·  Apple Silicon  ·  1 iteration</text>
+</svg>

package/docs/benchmarks/xxl-latency.svg

@@ -0,0 +1,66 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="410" viewBox="0 0 1200 410" role="img">
+<defs>
+<linearGradient id="supaGradient" x1="0" y1="0" x2="1" y2="0">
+<stop offset="0%" stop-color="#059669" />
+<stop offset="100%" stop-color="#34d399" />
+</linearGradient>
+<linearGradient id="slateGradient" x1="0" y1="0" x2="1" y2="0">
+<stop offset="0%" stop-color="#3b4757" />
+<stop offset="100%" stop-color="#526079" />
+</linearGradient>
+</defs>
+<rect width="100%" height="100%" rx="14" fill="#0b1220" />
+<text x="36.0" y="46.0" fill="#f8fafc" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="21" font-weight="700">Diff latency — xxl fixture (2,500 tables)</text>
+<text x="36.0" y="70.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12.5" font-weight="400">Median seconds per diff, log scale · whisker marks p95 · lower is better</text>
+<line x1="300.0" y1="94" x2="300.0" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="300.0" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">1.00s</text>
+<line x1="366.2" y1="94" x2="366.2" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="366.2" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">2.00s</text>
+<line x1="453.8" y1="94" x2="453.8" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="453.8" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">5.00s</text>
+<line x1="520.0" y1="94" x2="520.0" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="520.0" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">10.0s</text>
+<line x1="586.2" y1="94" x2="586.2" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="586.2" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">20.0s</text>
+<line x1="673.8" y1="94" x2="673.8" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="673.8" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">50.0s</text>
+<line x1="740.0" y1="94" x2="740.0" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="740.0" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">100s</text>
+<line x1="806.2" y1="94" x2="806.2" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="806.2" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">200s</text>
+<line x1="893.8" y1="94" x2="893.8" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="893.8" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">500s</text>
+<line x1="960.0" y1="94" x2="960.0" y2="336" stroke="#1e293b" stroke-width="1" />
+<text x="960.0" y="358.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400" text-anchor="middle">1000s</text>
+<circle cx="41" cy="117" r="4" fill="#34d399" />
+<text x="54.0" y="121.0" fill="#f8fafc" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="650">supaschema-db</text>
+<rect x="300" y="108" width="92.9" height="18" rx="4" fill="url(#supaGradient)" />
+<line x1="392.9" y1="105" x2="392.9" y2="129" stroke="#f8fafc" stroke-opacity="0.55" stroke-width="2" />
+<text x="1164.0" y="121.0" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" font-weight="650" text-anchor="end">2.64s  ·  p95 2.64s</text>
+<circle cx="41" cy="151" r="4" fill="#34d399" />
+<text x="54.0" y="155.0" fill="#f8fafc" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="650">supaschema-file</text>
+<rect x="300" y="142" width="110.2" height="18" rx="4" fill="url(#supaGradient)" />
+<line x1="410.2" y1="139" x2="410.2" y2="163" stroke="#f8fafc" stroke-opacity="0.55" stroke-width="2" />
+<text x="1164.0" y="155.0" fill="#34d399" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" font-weight="650" text-anchor="end">3.17s  ·  p95 3.17s</text>
+<text x="54.0" y="189.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-pg-delta</text>
+<rect x="300" y="176" width="509.4" height="18" rx="4" fill="url(#slateGradient)" />
+<line x1="809.4" y1="173" x2="809.4" y2="197" stroke="#f8fafc" stroke-opacity="0.55" stroke-width="2" />
+<text x="1164.0" y="189.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" font-weight="450" text-anchor="end">207s  ·  p95 207s</text>
+<text x="54.0" y="223.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-migra</text>
+<rect x="300" y="210" width="509.5" height="18" rx="4" fill="url(#slateGradient)" />
+<line x1="809.5" y1="207" x2="809.5" y2="231" stroke="#f8fafc" stroke-opacity="0.55" stroke-width="2" />
+<text x="1164.0" y="223.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" font-weight="450" text-anchor="end">207s  ·  p95 207s</text>
+<text x="54.0" y="257.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-pgadmin</text>
+<rect x="300" y="244" width="511.5" height="18" rx="4" fill="url(#slateGradient)" />
+<line x1="811.5" y1="241" x2="811.5" y2="265" stroke="#f8fafc" stroke-opacity="0.55" stroke-width="2" />
+<text x="1164.0" y="257.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" font-weight="450" text-anchor="end">211s  ·  p95 211s</text>
+<text x="54.0" y="291.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-default</text>
+<rect x="300" y="278" width="513.7" height="18" rx="4" fill="url(#slateGradient)" />
+<line x1="813.7" y1="275" x2="813.7" y2="299" stroke="#f8fafc" stroke-opacity="0.55" stroke-width="2" />
+<text x="1164.0" y="291.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" font-weight="450" text-anchor="end">216s  ·  p95 216s</text>
+<text x="54.0" y="325.0" fill="#e2e8f0" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="13" font-weight="450">supabase-pg-schema</text>
+<rect x="300" y="312" width="513.9" height="18" rx="4" fill="url(#slateGradient)" />
+<line x1="813.9" y1="309" x2="813.9" y2="333" stroke="#f8fafc" stroke-opacity="0.55" stroke-width="2" />
+<text x="1164.0" y="325.0" fill="#94a3b8" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="12" font-weight="450" text-anchor="end">217s  ·  p95 217s</text>
+<text x="36.0" y="388.0" fill="#64748b" font-family="ui-sans-serif, system-ui, 'Segoe UI', Helvetica, Arial, sans-serif" font-size="11" font-weight="400">supaschema 0.1.0  ·  Supabase CLI 2.106.0  ·  Node v24.14.0  ·  Apple Silicon  ·  1 iteration</text>
+</svg>

package/docs/case-study-anilize.md

@@ -0,0 +1,51 @@
+# Case study: a production multi-tenant Supabase platform
+
+supaschema was built while developing a production multi-tenant SaaS on Supabase: roughly **30 schemas, ~8,300 schema objects, and hundreds of RLS policies** (tenant isolation is enforced in the database, so almost every table carries policies). The pain that motivated the project was concrete: every schema edit meant waiting on the Supabase CLI's shadow-database diff before a migration — and its generated types — could catch up. That wait is a tax on every change, and it grows with the schema.
+
+All numbers below are reproducible. Object names are kept generic; the measurements are from the real tree.
+
+## Speed: the whole tree, no database, in under two seconds
+
+Extracting and planning the entire declarative tree (8,271 modeled objects) runs on the parser alone — no Docker, no shadow database, no introspection:
+
+```
+extract-from 1012ms · extract-to 876ms · plan 5ms
+```
+
+A full diff is two extractions plus a plan — **~1.9 seconds over the entire production tree.** The equivalent Supabase CLI diff replays all 8,300 objects into a fresh Docker shadow database on every run, which is minutes at this scale (see the [scaling benchmark](../README.md#speed)).
+
+The 8,271 figure is what supaschema models; the tree also produced 91 expected fail-closed diagnostics, concentrated in the bootstrap layer (managed-schema declarations for `extensions`/`vault`/roles, which a real adoption excludes via `schemas.exclude`) plus normalize-fidelity warnings. None are engine errors.
+
+## Head-to-head on real schema (bounded slice)
+
+A 282-object slice of the real tree (three schemas: identity, calculators, messaging — 73 RLS policies among them) was diffed against itself plus a small additive change, supaschema versus the default Supabase CLI engine, one iteration, both applied to a throwaway Postgres and re-applied:
+
+|  | supaschema | Supabase CLI (default) |
+| --- | --- | --- |
+| Diff latency | **361 ms** | 35,293 ms (~**98× slower**) |
+| Migration applies once → target catalog | yes | yes |
+| Migration applies **twice** (crash-safe re-run) | **yes** | **no** |
+| Reaches the target catalog after re-run | **yes** | **no** |
+
+The Supabase engine emitted an unguarded `CREATE TABLE public.…(…)` (no `IF NOT EXISTS`) and an unguarded `CREATE INDEX`, so the second apply fails with `relation "…" already exists`. supaschema's output is guarded by construction (`IF NOT EXISTS`, catalog-checked `DO` blocks), so a crashed or retried deploy simply runs the file again.
+
+Reproduce against any declarative tree:
+
+```bash
+node benchmarks/tools/build-project-fixture.mjs --tree <your supabase/schemas> --out benchmarks/fixtures/project
+SUPASCHEMA_COMPARE_FIXTURES=project \
+SUPASCHEMA_COMPARE_TOOLS=supaschema-file,supabase-default \
+SUPASCHEMA_COMPARE_ITERATIONS=1 \
+SUPASCHEMA_COMPARE_DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:54322/postgres \
+node benchmarks/compare.js
+```
+
+## Security: the miss that speed hides
+
+Speed is the felt pain; the more dangerous gap is correctness on RLS. On a multi-tenant platform, a policy's `USING` predicate **is** the tenant boundary. Tightening `USING (true)` to `USING (tenant_id = current_tenant())` is a one-line change that closes an isolation hole — and every Supabase CLI diff engine measured here silently drops that policy change (it diffs policies by name, not by body). See the [functions-policies](../README.md#accuracy) and realistic fixtures, where each engine scores F1 0.982–0.999 on exactly that miss while supaschema scores 1.000, and the missed-policy migration provably fails to reach the target catalog.
+
+A slow diff costs seconds. An unreplayable diff costs a deploy. A silently dropped policy change ships a tenant-isolation hole that review, CI, and the migration runner all wave through — which on this platform's hundreds of policies is the failure mode that actually matters.
+
+## Why both speed and security
+
+The two are the same wedge from different ends. The parser-based, no-database design is what makes supaschema fast; that same AST-based identity is what lets it compare policy bodies structurally instead of by name, which is what catches the isolation regression. You do not trade one for the other.

package/docs/ci-gate.md

@@ -0,0 +1,44 @@
+# CI gate: drift, replay-safety, and the policy-isolation check
+
+supaschema already ships the pieces of a CI gate. This document describes the free layer that exists today and the paid layer it is designed to become.
+
+## Free: the GitHub Action and reporters
+
+The committed composite action runs supaschema against a declarative tree on every push or PR:
+
+```yaml
+- uses: jmclaughlin724/supaschema@<tag>
+  with:
+    args: diff --from database:$DATABASE_URL --to dir:supabase/schemas --fail-on-diff --quiet
+```
+
+Three gates compose from existing commands, no service required:
+
+- **Drift** — `diff --fail-on-diff` exits 3 when the declarative tree and the database disagree, failing the build on un-migrated schema.
+- **Replay-safety** — `check --reporter github` annotates the PR diff, or `check --reporter sarif` uploads to the GitHub **code-scanning / Security** tab, flagging unguarded DDL, `CASCADE`, session `search_path`, and lock hazards.
+- **Policy isolation** — because the diff plan classifies an RLS policy-body change as its own operation, a tightened `USING` predicate surfaces as a reviewable change instead of being dropped. This is the differentiator: the engines a team would otherwise rely on miss it.
+
+This layer is AGPL and free. It is the funnel.
+
+## Paid: the hosted policy-isolation gate
+
+The free Action runs in the customer's CI and reports per-run. The paid layer is a hosted GitHub App that turns the same engine into an org-level security control:
+
+- **PR + Security-tab surface** — SARIF findings posted to every PR and aggregated in the org's code-scanning dashboard, with a dedicated **tenant-isolation policy change** finding class (a policy `USING`/`WITH CHECK` predicate changed, was removed, or weakened) that requires explicit review acknowledgement before merge.
+- **History and drift over time** — per-repo migration lineage, drift trend, and a record of every policy change shipped, so an isolation regression has an audit trail.
+- **Org policy** — required-check enforcement, allowed-hint review (no `hints.destructive: "*"` reaching `main`), and per-environment gates (`staging`/`production`) wired to named `environments`.
+- **No-CI-config onboarding** — install the App, point it at `supabase/schemas`, done; no workflow YAML, no `DATABASE_URL` plumbing in the customer's Actions.
+
+The engine is unchanged; the paid surface is hosting, the Security-tab integration, the policy-change finding class, and org administration. That is a per-repo or per-seat SaaS, not a CLI license — far higher ARPU, and the security framing (a tenant-isolation gate) carries the willingness to pay.
+
+## Sequencing
+
+1. Publish the package so the Action resolves (`npx supaschema@<tag>`).
+2. Ship the free Action + SARIF reporter as the funnel; instrument adoption.
+3. Build the hosted App once there is adoption signal and at least one reference customer (the case study is the first).
+
+## Open pricing decisions (founder)
+
+- Per-repo vs per-seat vs per-org-tier.
+- Whether the tenant-isolation finding class is the free hook or a paid-only gate.
+- Self-serve vs sales-assisted for the commercial license (see `LICENSE-COMMERCIAL.md`).

package/docs/ci.md

@@ -0,0 +1,68 @@
+# CI Recipe
+
+A minimal GitHub Actions job that diffs a pull request's declarative tree against the base branch, checks the rendered migration, and proves it against a disposable PostgreSQL service:
+
+```yaml
+name: schema-diff
+on: pull_request
+
+jobs:
+  supaschema:
+    runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: postgres:17
+        env:
+          POSTGRES_PASSWORD: postgres
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready --health-interval 5s --health-timeout 5s --health-retries 10
+
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - run: npm install --no-save supaschema
+      - name: Render migration from the PR diff
+        run: |
+          npx supaschema diff \
+            --from "git:origin/${{ github.base_ref }}" \
+            --to dir:supabase/schemas \
+            --out /tmp/migration.sql
+      - name: Check replay safety
+        run: npx supaschema check /tmp/migration.sql
+      - name: Verify apply-twice and catalog parity
+        run: |
+          npx supaschema verify \
+            --from "git:origin/${{ github.base_ref }}" \
+            --to dir:supabase/schemas \
+            --migration /tmp/migration.sql \
+            --database-url postgresql://postgres:postgres@localhost:5432/postgres
+```
+
+Notes:
+
+- `fetch-depth: 0` is required so `git:` sources can read the base ref.
+- `verify` creates and drops temporary databases on the service; the role must have `CREATEDB`. Add `--ensure-roles` when migrations grant to roles (e.g. `authenticated`) that a bare PostgreSQL service does not have.
+- `verify` refuses non-local database hosts by default (it creates and force-drops databases). GitHub Actions service containers are `localhost`, so CI recipes work unchanged; set `SUPASCHEMA_VERIFY_ALLOW_REMOTE=1` only when verifying against intentionally disposable remote infrastructure.
+- For a standalone drift gate, `supaschema diff --fail-on-diff --quiet` exits 3 when the live database and the declarative tree have diverged (`--from` defaults to the resolved database and `--to` to the config schema tree; spell them explicitly when the job's defaults are ambiguous).
+- `SUPASCHEMA_DATABASE_URL` can replace per-command `--database-url` flags; without either, supaschema discovers the local Supabase stack from `supabase/config.toml`.
+- Set `SUPASCHEMA_BENCHMARK_DATABASE_URL` (or rely on `SUPASCHEMA_DATABASE_URL`) when running `npm run benchmark` in package CI so `database:`, shadow-style round trip, replay verification, and end-to-end migration timings are enforced instead of skipped.
+- Exit code `2` means diagnostics contained errors — fail the job and read the stderr output.
+- Pin a PostgreSQL service major that matches production; run a matrix over 15/16/17 for libraries.
+- `supaschema check <dir>/*.sql` accepts multiple files, so one step can gate every new migration in a PR for replay safety — including migrations generated by other tools (shadow-database engines routinely emit unguarded `CREATE FUNCTION` / bare `DROP`). Add `--reporter github` for inline PR annotations on each finding, or `--reporter sarif` to upload into GitHub code scanning (`github/codeql-action/upload-sarif`).
+- The committed composite action wraps any invocation: `uses: jmclaughlin724/supaschema@v0.1.0` with `args: "diff --fail-on-diff --quiet"` and `SUPASCHEMA_DATABASE_URL` in the step env (always pin a tag; the action runs `npx supaschema@<version>` with `version` defaulting to `latest`).
+- Husky pre-commit recipe — gate staged migrations locally before CI sees them:
+
+  ```sh
+  # .husky/pre-commit
+  staged=$(git diff --cached --name-only --diff-filter=ACM -- 'supabase/migrations/*.sql')
+  [ -z "$staged" ] || npx supaschema check $staged
+  ```
+
+- `npm run corpus:check` runs the corpus oracle (replay a dirty-real migrations corpus, diff against its tree, apply twice, require reconvergence to zero) against the same service container; it prints a skip notice and exits 0 when no database URL resolves. Background and the regression-corpus discipline live in `docs/corpus.md`.

package/docs/commands.md

@@ -0,0 +1,35 @@
+# Command reference
+
+Every command, with full flags. Global options on every command: `--config <path>` (explicit `.json`/`.mjs`/`.js` config file), `--env <name>` (database URL from a named `environments` entry in the config), `--quiet` (suppress stderr diagnostics).
+
+Zero-flag defaults, applied wherever a flag is omitted and printed to stderr when used: `--from` resolves to `database:<resolved URL>` (the applied state) and falls back to `git:HEAD`; `--to` resolves to `dir:<config.schemaPaths[0]>` (`supabase/schemas`); migrations write to `config.migrationsDir` (`supabase/migrations`) as `<UTC timestamp>_<name>.sql` with the name derived from the planned operations; `check` with no arguments gates every `.sql` in the migrations directory; `verify --migration` defaults to the newest pending file there.
+
+Exit codes: `0` success · `1` runtime error · `2` diagnostics contained at least one error · `3` `--fail-on-diff` found operations.
+
+## Generation and planning
+
+- `supaschema diff [--from <source>] [--to <target>] [--out <file|stdout>] [--name <snake_case>] [--migrations-dir <dir>] [--schema <names>] [--dry-run] [--json] [--fail-on-diff] [--no-check-chain] [--summary] [--write-hints <file>] [--timing] [--watch]` renders the migration into the migrations directory (zero-flag: applied state → schema tree → `<migrations-dir>/<UTC timestamp>_<derived name>.sql`; an empty plan writes nothing and prints `no schema changes`). `--out stdout` prints instead of writing; `--json` prints a machine-readable payload; `--fail-on-diff` exits 3 when the plan contains operations (the CI drift gate); `--summary` prints a drift report (operation and diagnostic counts grouped by kind and schema) even when the plan is blocked; `--write-hints` writes the gated destructive object keys as a `hints.destructive` skeleton for review; `--timing` prints extract/plan/render phase timings to stderr; `--watch` re-prints the drift summary whenever a `dir:` source changes (editor loop — forces dry-run, never writes files).
+- `supaschema types [--from <source>] [--out <file|stdout>]` generates Supabase-compatible TypeScript types (`Database`, table `Row`/`Insert`/`Update`, views, enums, relationships, `Constants`, and helper generics) plus runtime Zod validators straight from the schema tree — no database, no introspection, no applied migrations. Defaults: `--from` the config schema tree, TypeScript to `config.typesFile` (`database.types.ts`), Zod validators to `config.zodFile` (`database.zod.ts`; requires `zod` in the consuming project); `--out stdout` prints the TypeScript artifact only. Once a generated file exists, every `diff` that writes a migration refreshes it automatically, so types never wait on a deploy. View columns are typed by resolving direct column references (and `SELECT *`) through their source table; expressions fall back to `unknown`.
+- `supaschema plan [--from <source>] [--to <target>] [--schema <names>] [--timing]` prints the object-level diff plan as JSON; use `diff` to render SQL.
+- `supaschema inspect [--from <source>] [--schema <names>]` prints the extracted schema model as JSON (default source: the config schema tree; save it for `catalog:` sources).
+- `supaschema fingerprint --from <source>` prints only the model fingerprint — two sources with equal fingerprints have identical schemas.
+
+## Validation and proof
+
+- `supaschema check [migrations...] [--reporter text|github|sarif|json]` validates replay-safety, lock hazards, and parser diagnostics. Zero arguments gates every `.sql` in `config.migrationsDir`; named files and shell globs gate exactly those, including migrations generated by other tools; `-` reads stdin (`other-tool | supaschema check -`); `--reporter github` emits inline PR annotations and `--reporter sarif` feeds GitHub code scanning.
+- `supaschema verify [--from <source>] [--to <target>] [--migration <file>] [--migrations-dir <dir>] [--database-url <url>] [--ensure-roles] [--ensure-environment] [--keep-databases]` (zero-flag: applied state → schema tree, newest pending migration) applies the migration twice in disposable databases, compares catalog fingerprints, then cross-lane diffs the migrated catalog against the target model and requires zero residual operations (`SUPA_VERIFY_RECONVERGENCE`). The URL auto-resolves when omitted; non-local hosts are refused without `SUPASCHEMA_VERIFY_ALLOW_REMOTE=1`. A capability preflight fails fast when the role lacks `CREATEDB`. `--ensure-roles` pre-creates referenced NOLOGIN roles; `--ensure-environment` (default under adapter `supabase-auto`) stubs Supabase-provisioned surfaces (`auth.uid()`-family helpers, `auth.users`, the cron schema) so real-world trees verify against bare PostgreSQL; `--keep-databases` preserves the temporary databases for inspection after a failed run.
+- `supaschema selfcheck [--database-url <url>]` re-extracts the live catalog's rendered SQL through the source pipeline and reports any object whose identity diverges — the regression net for cross-lane false changes.
+- `supaschema corpus [--corpus-dir <dir>] [--database-url <url>] [--json]` runs the corpus oracle: replays the committed dirty-real migrations corpus into a disposable database, cross-lane diffs it against the corpus tree, applies the rendered reconciliation twice, and requires the re-diff to converge to zero (`SUPA_CORPUS_RECONVERGENCE`). See [corpus.md](corpus.md).
+
+## Migration-state operations
+
+- `supaschema migrations [--migrations-dir <dir>] [--database-url <url>] [--history-table <schema.table>] [--json]` reconciles migration files on disk against a target's applied history (`supabase_migrations.schema_migrations` by default): applied, pending (supaschema-generated files flagged via their lineage marker), ghost versions (applied with no file on disk), and out-of-order pending files. Ghosts and out-of-order are errors (exit 2). Run once per target to compare worktree, local, and remote.
+- `supaschema sync [--migrations-dir <dir>] [--database-url <url>] [--local] [--remote]` is the opt-in auto-sync orchestrator: reconciles disk vs applied history, refuses on ghost/out-of-order history, runs the replay-safety check on every pending migration, then — only with explicit flags — executes the Supabase CLI (`--local` → `supabase migration up`, `--remote` → `supabase db push`, runner prompts intact). Without flags it is a dry run; the runner keeps sole ownership of the history table.
+
+## Setup and tooling
+
+- `supaschema init` writes `supaschema.config.json` with the defaults (including the `$schema` pointer for editor autocomplete).
+- `supaschema audit --from <source> [--json]` reports support-matrix coverage: objects modeled by kind/schema plus every statement outside the contract grouped by diagnostic code (exit 2 when any exist) — the adoption question answered from the same extraction the diff engine uses.
+- `supaschema doctor [--database-url <url>] [--json]` diagnoses the environment in one paste-able report: Node version, parser load, config, which URL-resolution lane fired, database reachability, `CREATEDB` capability, migrations-history health, and the declarative tree.
+- `supaschema completion <bash|zsh|fish>` prints a shell completion script.
+- `supaschema explain <code>` explains a diagnostic code offline.