episode

Documentation

Index

• type EpisodeChainResult
  • func VerifyEpisodeChain(taskID, episodesDir string) (*EpisodeChainResult, error)
• type EpisodeFileHash
• type EpisodeHashes
• type EpisodeManifest
• type EpisodeValidationResult
  • func InspectEpisode(path string) (*EpisodeValidationResult, error)

Types

type EpisodeChainResult

type EpisodeChainResult struct {
	OK              bool     `json:"ok"`
	TaskID          string   `json:"task_id"`
	EpisodesChecked int      `json:"episodes_checked"`
	Errors          []string `json:"errors"`
	EpisodeIDs      []string `json:"episode_ids"`
}

EpisodeChainResult represents chain validation outcome.

func VerifyEpisodeChain

func VerifyEpisodeChain(taskID, episodesDir string) (*EpisodeChainResult, error)

VerifyEpisodeChain validates episode chain integrity for a task.

type EpisodeFileHash

type EpisodeFileHash struct {
	Path      string `json:"path"`
	SHA256    string `json:"sha256"`
	SizeBytes int    `json:"size_bytes"`
}

EpisodeFileHash represents a single file hash entry.

type EpisodeHashes

type EpisodeHashes struct {
	SchemaVersion string            `json:"schema_version"`
	Files         []EpisodeFileHash `json:"files"`
}

EpisodeHashes represents hashes.json structure.

type EpisodeManifest

type EpisodeManifest struct {
	SchemaVersion      string                 `json:"schema_version"`
	EpisodeID          string                 `json:"episode_id"`
	TaskID             string                 `json:"task_id"`
	CreatedAt          string                 `json:"created_at"`
	XHarnessVersion    string                 `json:"x_harness_version"`
	PreviousEpisodeID  *string                `json:"previous_episode_id"`
	Git                map[string]interface{} `json:"git"`
	PolicyHashes       map[string]interface{} `json:"policy_hashes"`
	SchemaHashes       map[string]interface{} `json:"schema_hashes"`
	Verdict            map[string]interface{} `json:"verdict"`
	MutationGuard      map[string]interface{} `json:"mutation_guard"`
	Signing            map[string]interface{} `json:"signing"`
	BundleRefs         map[string]interface{} `json:"bundle_refs"`
	AdmissionAuthority bool                   `json:"admission_authority"`
	HashesHash         string                 `json:"hashes_hash"`
	ManifestHash       string                 `json:"manifest_hash"`
}

EpisodeManifest represents manifest.json structure.

type EpisodeValidationResult

type EpisodeValidationResult struct {
	OK        bool             `json:"ok"`
	EpisodeID *string          `json:"episode_id"`
	TaskID    *string          `json:"task_id"`
	Errors    []string         `json:"errors"`
	Warnings  []string         `json:"warnings"`
	Manifest  *EpisodeManifest `json:"manifest,omitempty"`
	FileCount int              `json:"file_count"`
}

EpisodeValidationResult represents validation outcome.

func InspectEpisode

func InspectEpisode(path string) (*EpisodeValidationResult, error)

InspectEpisode validates an episode directory or bundle.