Documentation
¶
Overview ¶
Package currentstatecoord coordinates current-state operations over explicitly selected immutable repository universes.
Index ¶
- func NormalizeAuthorityPath(root, value string) (string, error)
- func QueryTopic(root string, repo *awfgit.Repo, ctx context.Context, selector string, ...) (topic.QueryResult, error)
- func ResolveTopics(root string, repo *awfgit.Repo, ctx context.Context, paths []string) (presentation.Detail, error)
- func UncoveredPaths(root string, repo *awfgit.Repo, ctx context.Context) (presentation.Detail, error)
- type CurrentStateReport
- type OutputPreparation
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func NormalizeAuthorityPath ¶ added in v0.43.0
normalizeAuthorityPath makes a command argument repository-relative and lexical. Absolute paths outside root and upward traversal are refused.
func QueryTopic ¶
func QueryTopic(root string, repo *awfgit.Repo, ctx context.Context, selector string, opts topic.QueryOptions) (topic.QueryResult, error)
QueryTopic selects one working topic-authority universe before delegating topic query semantics to topic. Historical decisions are not current-state authority and are therefore not loaded or validated here.
func ResolveTopics ¶ added in v0.43.0
func ResolveTopics(root string, repo *awfgit.Repo, ctx context.Context, paths []string) (presentation.Detail, error)
ResolveTopics reports lexical path attribution from the working current-state universe. It intentionally does not require paths to exist.
func UncoveredPaths ¶ added in v0.43.0
func UncoveredPaths(root string, repo *awfgit.Repo, ctx context.Context) (presentation.Detail, error)
UncoveredPaths reports the whole-working-tree unowned census. It is an informational query, separate from enforcement coverage and its exclusions.
Types ¶
type CurrentStateReport ¶
type CurrentStateReport struct {
Coverage []topic.CoverageFinding
CurrentResult checkresult.Result
OwnerResult checkresult.Result
}
CurrentStateReport is the current-state coverage and fan-out outcome.
func CheckStaged ¶
CheckStaged validates the lock boundary and evaluates coverage and fan-out over exactly the staged index universe. Dirty working bytes never participate.
func CheckStagedRoot ¶
func CheckStagedRoot(ctx context.Context, root string) (CurrentStateReport, error)
CheckStagedRoot validates staged current state without opening working-tree project configuration. The staged command must remain operable when a valid adopted index deliberately deletes or lacks the working config.
func CheckWorking ¶
CheckWorking loads one working-tree universe and evaluates current-state coverage and fan-out independently of historical decisions.
func (CurrentStateReport) Result ¶
func (r CurrentStateReport) Result() checkresult.Result
Result returns the coverage and fan-out result.
type OutputPreparation ¶ added in v0.43.0
type OutputPreparation struct {
State *projectstate.ProjectState
Config *config.Config
Reader outputplan.TreeReader
// contains filtered or unexported fields
}
OutputPreparation selects the index universe used exclusively by staged generated-output drift. It carries output-plan inputs, not authority context.
func PrepareStagedOutput ¶ added in v0.43.0
func PrepareStagedOutput(ctx context.Context, root string) (*OutputPreparation, error)
PrepareStagedOutput selects only the index universe for staged output drift. It never consults working-tree configuration or locks.
func (*OutputPreparation) Lock ¶ added in v0.43.0
func (p *OutputPreparation) Lock() *manifest.Lock
func (*OutputPreparation) Tree ¶ added in v0.43.0
func (p *OutputPreparation) Tree() *snapshot.Tree
Source Files