Documentation
¶
Index ¶
- func ActionKey(kind string, spec any, inputs, dependencies []string) (string, error)
- type ActionResult
- type Cache
- func (c *Cache) BeginObservationSession()
- func (c *Cache) HasReceipt(actionKey, marker string) bool
- func (c *Cache) InvalidateObservations()
- func (c *Cache) Lookup(actionKey, output string) (LookupStatus, string, error)
- func (c *Cache) Peek(actionKey, output string) (LookupStatus, string, error)
- func (c *Cache) RecordAction(actionKey, output string) (string, error)
- func (c *Cache) RecordReceipt(actionKey string) error
- func (c *Cache) ResetStats()
- func (c *Cache) Save() error
- func (c *Cache) Snapshot(options SnapshotOptions) (string, error)
- func (c *Cache) SnapshotFiles(label string, paths ...string) (string, error)
- func (c *Cache) SnapshotGoAPI(options SnapshotOptions) (string, error)
- func (c *Cache) Stats() SnapshotStats
- type FileRecord
- type LookupStatus
- type SnapshotOptions
- type SnapshotStats
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
Types ¶
type ActionResult ¶
type ActionResult struct {
Artifact string `json:"artifact"`
Output string `json:"output"`
OutputMetadata FileRecord `json:"output_metadata,omitempty"`
}
type Cache ¶
type Cache struct {
// contains filtered or unexported fields
}
func OpenCacheReadOnly ¶
OpenCacheReadOnly opens existing cache metadata without creating project state. Snapshot updates remain in memory and are never saved by inspection.
func (*Cache) BeginObservationSession ¶
func (c *Cache) BeginObservationSession()
BeginObservationSession lets a finite executor share tree traversal across related snapshots. Direct Cache callers retain fresh-per-call semantics.
func (*Cache) HasReceipt ¶
func (*Cache) InvalidateObservations ¶
func (c *Cache) InvalidateObservations()
InvalidateObservations starts a new filesystem-observation boundary. The executor calls this before running a handler, so snapshots within an unchanged no-op graph share one consistent tree view while generated or user-modified files are always rediscovered after actual work.
func (*Cache) Lookup ¶
func (c *Cache) Lookup(actionKey, output string) (LookupStatus, string, error)
func (*Cache) Peek ¶
func (c *Cache) Peek(actionKey, output string) (LookupStatus, string, error)
Peek reports what Lookup would do without restoring or modifying files.
func (*Cache) RecordReceipt ¶
func (*Cache) ResetStats ¶
func (c *Cache) ResetStats()
func (*Cache) SnapshotFiles ¶
func (*Cache) SnapshotGoAPI ¶
func (c *Cache) SnapshotGoAPI(options SnapshotOptions) (string, error)
SnapshotGoAPI fingerprints binding-relevant Go syntax while ignoring method bodies. Free-function bodies remain inputs because main may delegate Wails service registration to helpers. Per-file semantic digests use the same metadata fast path as content Snapshots, so an unchanged tree is not reparsed.
func (*Cache) Stats ¶
func (c *Cache) Stats() SnapshotStats
type FileRecord ¶
type LookupStatus ¶
type LookupStatus string
const ( LookupMiss LookupStatus = "miss" LookupHit LookupStatus = "hit" LookupRestored LookupStatus = "restored" LookupDirty LookupStatus = "dirty" )