model

type File ¶

type File struct {
	ImportPath  string
	PackageName string
	Path        string
	Source      []byte
}

File is one generated, formatted Go source file.

type FinalStamp ¶

type FinalStamp struct {
	GenerationDigest   string
	GeneratorVersion   string
	TemplateABIVersion string
}

type Manifest ¶

type Manifest struct {
	Symbols []Symbol
}

Manifest is sorted by package, namespace, name, and kind.

type PackageSpec ¶

type PackageSpec struct {
	ImportPath  string
	PackageName string
	Directory   string
}

PackageSpec supplies the Go package information that is intentionally absent from the canonical compiler IR. Directory may be empty when callers only need source; set it when Result.Overlay will be passed to go/packages.

type Request ¶

type Request struct {
	Compilation     ir.CompilationIR
	Packages        []PackageSpec
	GolemImportPath string
	FinalStamp      *FinalStamp
}

Request describes one deterministic bootstrap emission.

type Result ¶

type Result struct {
	Files    []File
	Manifest Manifest
}

Result contains generated files and their stable symbol map.

func Emit(request Request) (Result, error)

func (r Result) Overlay() map[string][]byte

type Symbol ¶

type Symbol struct {
	PackagePath string
	Namespace   string
	Name        string
	Kind        SymbolKind

	ModelID    ir.ModelID
	FieldID    ir.FieldID
	RelationID ir.RelationID
	KeyID      ir.KeyID
	Fields     []ir.FieldID
}

Symbol maps a generated Go symbol back to the canonical stable identifier consumed by later typed interpretation. Namespace is empty for package-level symbols; Name is the member name for namespace fields.

type SymbolKind ¶

type SymbolKind string

SymbolKind classifies a generated public symbol.

const (
	SymbolModelDescriptor SymbolKind = "model_descriptor"
	SymbolNamespace       SymbolKind = "namespace"
	SymbolField           SymbolKind = "field"
	SymbolRelation        SymbolKind = "relation"
	SymbolSelector        SymbolKind = "selector"
)