Documentation
¶
Overview ¶
Package migrate owns supported live schema upgrades. Historical schema decoding belongs to internal/audit and retired layouts are recognized only for refusal, never parsed or relocated here.
Index ¶
- Constants
- func CheckLive(root string) (int, error)
- func CheckLiveGeneration(gen int) error
- func Current() int
- func CurrentAuthorityPresence(root string) (currentConfig, currentLock bool, returnErr error)
- func GateState(root string) (string, int, error)
- func GateStateForGeneration(gen int) string
- func Generation(root string) (int, error)
- func IsRetiredLayout(err error) bool
- func LiveSchemaRange() (int, int)
- func ProjectPresent(root string) (present bool, returnErr error)
- func ProjectPresentFromFiles(has func(string) bool) bool
- type Change
- type Changes
- type Result
- type RetiredLayoutError
- type UpgradeRequiredError
Constants ¶
const LiveSchemaFloor = 50
LiveSchemaFloor is the oldest source generation this binary can operate on.
Variables ¶
This section is empty.
Functions ¶
func CheckLiveGeneration ¶ added in v0.40.0
func CurrentAuthorityPresence ¶ added in v0.49.0
CurrentAuthorityPresence inspects the two current control entries without following their final path components.
func GateStateForGeneration ¶ added in v0.22.0
func Generation ¶
Generation reads only a current-layout lock schema. Retired layouts receive a typed refusal before their authority representation can be decoded.
func IsRetiredLayout ¶ added in v0.40.0
IsRetiredLayout makes presentation boundaries distinguish layout refusal from a below-floor current lock without retaining a layout reader.
func LiveSchemaRange ¶ added in v0.40.0
func ProjectPresent ¶ added in v0.11.0
ProjectPresent recognizes current control files and retired layouts without interpreting content or following final path components.
func ProjectPresentFromFiles ¶ added in v0.22.0
Types ¶
type Change ¶ added in v0.30.0
type Change struct {
Text string
}
Change is one ordered semantic fact produced by a migration. It is data for the upgrade owner, not terminal output.
func CurrentSchemaChange ¶ added in v0.30.0
func CurrentSchemaChange() Change
CurrentSchemaChange reports the migration domain's proven no-migration state to its terminal owner.
type Changes ¶ added in v0.30.0
type Changes struct {
// contains filtered or unexported fields
}
Changes is the fact collector passed through the supported migration seam.
type Result ¶ added in v0.50.0
type Result struct {
Planned []string
Applied []string
Changes []Change
Touched []string
Pending []string
}
Result is the semantic and path-level evidence from one straight-line run. Touched contains successful filesystem operations; Pending contains the current failed path and every operation that was not attempted.
type RetiredLayoutError ¶ added in v0.40.0
type RetiredLayoutError struct{ Layout string }
RetiredLayoutError identifies a removed layout without decoding its config.
func (*RetiredLayoutError) Error ¶ added in v0.40.0
func (e *RetiredLayoutError) Error() string
func (*RetiredLayoutError) Is ¶ added in v0.40.0
func (e *RetiredLayoutError) Is(target error) bool
type UpgradeRequiredError ¶ added in v0.40.0
type UpgradeRequiredError struct{ Generation, Current int }
func (*UpgradeRequiredError) Error ¶ added in v0.40.0
func (e *UpgradeRequiredError) Error() string
Source Files