beads/cmd/bd/schema_skew.go
Jim Wordelman 7da4f7817d feat(schema): schema-skew guard — hard fail on forward DB drift (be-wwbsv)
Add SchemaSkewError type, checkSchemaSkew, CheckForwardDrift,
--ignore-schema-skew flag, and dedicated error handler in main.go.

- internal/storage/schema/schema.go: SchemaSkewError{DBVersion,BinaryVersion}
  with Error()/UserMessage()/EscapeHint(); IsSchemaSkewError helper;
  checkSchemaSkew (unexported, BD_IGNORE_SCHEMA_SKEW=1 escape hatch);
  CheckForwardDrift exported for read-only store path.
- internal/storage/dolt/store.go: ReadOnly branch calls CheckForwardDrift
  before the existing initSchema else-branch; returns *SchemaSkewError on
  forward drift.
- cmd/bd/schema_skew.go: handleSchemaSkewJSON writes structured JSON to stderr
  with schema_skew subobject (current_version, required_version, delta).
- cmd/bd/main.go: --ignore-schema-skew persistent flag (sets
  BD_IGNORE_SCHEMA_SKEW=1); SchemaSkewError errors.As check before
  FatalError("failed to open database") gives dedicated actionable UX.

Tests: schema_skew_test.go files from be-cdhvj (unit + dolt integration +
cmd/bd JSON shape + flag registration) — all 14 pass.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-24 19:56:33 -07:00

22 lines
541 B
Go

package main
import (
"encoding/json"
"os"
"github.com/steveyegge/beads/internal/storage/schema"
)
func handleSchemaSkewJSON(e *schema.SchemaSkewError) {
outer := buildJSONError(e.Error(), e.EscapeHint())
if m, ok := outer.(map[string]interface{}); ok {
m["schema_skew"] = map[string]interface{}{
"current_version": e.DBVersion,
"required_version": e.BinaryVersion,
"delta": e.DBVersion - e.BinaryVersion,
}
}
encoder := json.NewEncoder(os.Stderr)
encoder.SetIndent("", " ")
_ = encoder.Encode(outer)
}