project

package

v2.219.0 Latest Latest Go to latest Published: Oct 28, 2026 License: MIT Imports: 13 Imported by: 0

Details

Rendered for

Package project places bundle content at harness load points. The harness names and paths come from the layouts table, so this package holds none.

View Source

const (
	ScopeRepo = "repo"
	ScopeHome = "home"
)

This section is empty.

func Registries() (repo, home map[string]Layout, err error)

Registries splits the layouts table into its repo- and home-scoped views.

func Validate(targetDir string) error

Validate reports whether the target holds a complete previous projection, so a failed refresh can fall back to it as last-known-good.

type Layout = layouts.Layout

type LoadPoints = layouts.LoadPoints

type Projection struct {
	Layout string   `json:"layout"`
	Bundle string   `json:"bundle"`
	Files  []string `json:"files"`
}

Projection records the immutable bundle and files owned at one target.

func FindProjection(start string) (Projection, string)

FindProjection walks from start toward the filesystem root and returns the nearest recorded projection plus the target directory that owns it.

func ReadProjection(targetDir string) Projection

ReadProjection loads the ownership sidecar at targetDir. An absent or malformed sidecar returns an empty projection for existing callers.

type Result struct {
	Layout string
	Files  []string
}

func ApplyOwned(targetDir string, files map[string][]byte, label, origin string) (*Result, error)

ApplyOwned writes a file set under target with the projection ownership rules: sidecar-tracked, never clobbering foreign files, replacing stale.

func Project(bundleDir, layoutName, targetDir string) (*Result, error)

func ProjectScoped(bundleDir, layoutName, targetDir, scope string) (*Result, error)

ProjectScoped selects repo-relative or home-relative load points; home scope treats targetDir as the home root.