Skip to content

feat(boatstack): non-breaking versioned configuration schema migration system - #69

Merged
bigboateng merged 1 commit into
mainfrom
feat/boatstack-config-migration
Jul 20, 2026
Merged

feat(boatstack): non-breaking versioned configuration schema migration system#69
bigboateng merged 1 commit into
mainfrom
feat/boatstack-config-migration

Conversation

@bigboateng

Copy link
Copy Markdown
Contributor

Implement a non-breaking versioned configuration migration system for .boatstack-project.json.

  • migrate.go: Core migration registry and MigrateConfigBytes helper.
  • export.go: Relax SchemaVersion check in ValidateConfig to accept <= CurrentConfigSchemaVersion and emit behind/ahead instructions. Embed config-schema.md.
  • init.go: Run config schema migration on load during update path and report vN->vM upgrade status.
  • update.go: Add schema conformance validation check inside ValidateUpdateWorkspace.
  • planning.go: Map behind/ahead schema errors to custom remediation hints in DoctorRepairHint.
  • cmd/boatstack-helper/main.go: Add structured migrate-config CLI command.
  • references/config-schema.md: Create canonical config schema reference document.
  • boatstack-distribution/release-notes: Add release notes fragment.
  • migrate_test.go: Exhaustive unit test suite.

…n system

Implement a non-breaking versioned configuration migration system for .boatstack-project.json.

- migrate.go: Core migration registry and MigrateConfigBytes helper.
- export.go: Relax SchemaVersion check in ValidateConfig to accept <= CurrentConfigSchemaVersion and emit behind/ahead instructions. Embed config-schema.md.
- init.go: Run config schema migration on load during update path and report vN->vM upgrade status.
- update.go: Add schema conformance validation check inside ValidateUpdateWorkspace.
- planning.go: Map behind/ahead schema errors to custom remediation hints in DoctorRepairHint.
- cmd/boatstack-helper/main.go: Add structured migrate-config CLI command.
- references/config-schema.md: Create canonical config schema reference document.
- boatstack-distribution/release-notes: Add release notes fragment.
- migrate_test.go: Exhaustive unit test suite.
@bigboateng
bigboateng merged commit aefd940 into main Jul 20, 2026
4 checks passed
@bigboateng
bigboateng deleted the feat/boatstack-config-migration branch July 20, 2026 08:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant