publisher

type Backup ¶

type Backup struct {
	Path  string // project-relative file that was overwritten
	Bak   string // project-relative backup copy (.awf-bak[.N])
	Index bool   // the file is the generated ADR/domain index (ownership-takeover note)
}

Backup records a foreign file preserved before sync overwrote its path.

type Change ¶

type Change struct {
	Path  string
	Cause string
}

Change records a sync-written file whose rendered bytes differ from the prior lock's or whose required mode was corrected, with the cause the lock's hashes able to attribute: "template" (the upstream template source moved), "config" (the project's effective inputs - vars, sidecar, parts - moved), "template+config" (both), "internal" (hashes unmoved: a non-hashed input such as the binary's version stamp), "regenerated" (a generated index, which carries no hashes to attribute), or "added" (no prior entry). The provenance triage signal for reviewing a large sync diff - upstream churn vs the project's own inputs.

type ConfigKeyRow ¶

type ConfigKeyRow struct {
	Path, Type, Default, Description, Availability, Current string
}

ConfigKeyRow renders one config.yaml key or sidecar field in the config reference: a `configKeys` row always carries a resolved Current value, a `sidecarFields` row never does (there is no project-relative live value for a sidecar's own field), and the static catalog-only model leaves Current empty on every row.

type ConfigReference ¶

type ConfigReference struct {
	ConfigKeys    []ConfigKeyRow
	VarEntries    []VarRow
	SidecarFields []ConfigKeyRow
	DataKeys      []DataKeyRow
}

ConfigReference is the typed presentation model for `awf config`: the four dedicated collections PrintConfigReference renders, produced either with live project state (ConfigReferenceModel) or catalog-only (StaticConfigReference). It is the typed counterpart to the map[string]any shape configReferenceData still builds for the doc generator - a renamed field here is a compile error, never a silently empty render.

func StaticConfigReference() (ConfigReference, error)

type DataKeyRow ¶

type DataKeyRow struct {
	Artifact, Key, Description, State string
}

DataKeyRow renders one per-artifact data key. State reports its observable catalog/project layering state.

type Effect ¶ added in v0.41.0

type Effect struct {
	Kind     string
	Path     string
	Recovery string
}

Effect is one committed filesystem fact and its stable retry or recovery action.

type InitAuthority ¶

type InitAuthority struct{ InitializedWithVersion string }

InitAuthority is the explicit provenance supplied only by first adoption.

type Layout ¶

type Layout struct {
	DocsDir    string
	Docs       map[string]string // catalog name -> output path (inv: layout-docs-full-catalog)
	Singletons map[string]string // template key -> output path
	DomainsDir string
}

Layout is the fixed, awf-given docs layout in typed form for Go consumers. These paths are not configurable through the project tree. templateMap projects it into the .layout template namespace (templates read a map, not unexported struct fields) and into the per-file ConfigHash. The mandatory-singleton paths are not struct fields: they derive from the catalog doc collection in templateMap (ADR-0061).

type OutputInput ¶

type OutputInput struct {
	Path string
	Role outputplan.ArtifactRole
}

OutputInput records one semantic input consumed by a declared output.

type OutputNode ¶

type OutputNode struct {
	Path                string
	Recipe              OutputRecipe
	Policy              outputplan.Policy
	Declarers           []string
	DeclarerProjections []string
	DependsOn           []string
	ConsumedInputs      []OutputInput
	ObservedTemplateID  string
	// contains filtered or unexported fields
}

OutputNode is one path in the deterministic internal output plan.

type OutputPlan ¶

type OutputPlan struct {
	Nodes []OutputNode
}

OutputPlan is the single desired-output authority consumed by rendering, sync, manifest/prune, checks, and planned-output reporting.

type OutputRecipe ¶

type OutputRecipe struct {
	TemplateID, TemplateHash, ConfigHash string
	Policy                               outputplan.Policy
	Encoder                              artifactregistry.AgentDialect
	Provenance                           string
}

OutputRecipe is the normalized, output-affecting declaration used for collision diagnostics and configuration hashes. Target identity is kept on OutputNode declarers rather than here, so compatible shared outputs coalesce.

type PartialError ¶ added in v0.41.0

type PartialError struct {
	Result Result
	Cause  error
}

PartialError reports a failed publication after one or more committed effects.

func (e *PartialError) Error() string

func (e *PartialError) Unwrap() error

type ProjectSession ¶ added in v0.46.0

type ProjectSession interface {
	Root() string
	Roots() resident.Roots
	Config() *config.Config
	Reader() outputplan.TreeReader
	Catalog() *catalog.Catalog
	Targets() []artifactregistry.Target
}

ProjectSession is the read-only project selection consumed by Publisher. The concrete authority owner is project.Session.

type Publisher ¶

type Publisher struct {
	// contains filtered or unexported fields
}

Publisher is the sole output-plan construction and rendering coordinator. One Publisher is one immutable operation: all readers share its one derived universe, and publication may be attempted only once.

func New(session ProjectSession, version string) *Publisher

func (p *Publisher) BuildConfigReference() (ConfigReference, error)

func (p *Publisher) EffectiveSkills() (map[string]bool, error)

func (p *Publisher) GeneratedOutput() (generatedcheck.AdditionalInput, error)

func (p *Publisher) Glossary() (glossarycheck.Input, error)

func (p *Publisher) InitCollisions() ([]string, error)

func (p *Publisher) InitCollisionsAt(root string) ([]string, error)

func (p *Publisher) Initialize(seed InitAuthority) (Result, error)

func (p *Publisher) InitializeLeased(ctx context.Context, lease *filesystem.Lease, seed InitAuthority) (Result, error)

func (p *Publisher) Pitfalls() (pitfall.Corpus, error)

func (p *Publisher) Plan() (outputplan.Plan, error)

func (p *Publisher) PreflightLocalDoc(doc config.LocalDoc) error

func (p *Publisher) ResidentMarker(name string) (outputplan.Output, error)

func (p *Publisher) SyncLeased(ctx context.Context, lease *filesystem.Lease) (Result, error)

type RenderedFile ¶

type RenderedFile struct {
	Path         string
	Content      string
	TemplateID   string
	TemplateHash string
	ConfigHash   string
	// RegenChecked excludes this file from the frozen-OutputHash compare; its
	// drift is checked by regeneration instead (ADR-0100). Set on the generated
	// indexes and on any file carrying an in-place-editable section.
	RegenChecked bool
	// Policy declares all lifecycle checks for this path. It replaces
	// template-name and filename inference at plan consumers.
	Policy outputplan.Policy
	// Declarer identifies the producer requesting this output.
	Declarer           string
	DeclarerProjection string
	Encoder            artifactregistry.AgentDialect
	Provenance         render.CommentStyle

	// ConsumedInputs records provenance at the render seam. Definitions own
	// output identity and dependencies; observed inputs stay coupled to the
	// closure that actually consumed them.
	ConsumedInputs     []OutputInput
	ObservedTemplateID string
	// contains filtered or unexported fields
}

type Result ¶

type Result struct {
	// contains filtered or unexported fields
}

Result records only mutations committed before the terminal outcome.

func (r Result) Backups() []Backup

func (r Result) Changes() []Change

func (r Result) Effects() []Effect

func (r Result) HasCommittedEffects() bool

func (r Result) Mutation() (presentation.Mutation, error)

func (r Result) PartialMutation() (presentation.Mutation, error)

func (r Result) Pruned() []string

type VarRow ¶

type VarRow struct {
	Key, Description, Availability, State, Consumers string
}

VarRow renders one catalog var. State is the three-way live var state (set, empty, absent); it is empty in the static catalog-only model.