contextual

type EnvironmentContext struct {
	WorktreePath   string                 `json:"worktree_path,omitempty"`
	WorkdirPath    string                 `json:"workdir,omitempty"`
	ArtifactInbox  string                 `json:"inbox,omitempty"`
	ArtifactOutbox string                 `json:"outbox,omitempty"`
	Host           EnvironmentPathContext `json:"host,omitempty"`
	Op             EnvironmentPathContext `json:"op,omitempty"`
}

type EnvironmentPathContext struct {
	Workdir      string `json:"workdir,omitempty"`
	WorktreePath string `json:"worktree_path,omitempty"`
	Inbox        string `json:"inbox,omitempty"`
	Outbox       string `json:"outbox,omitempty"`
}

type GitBaseContext struct {
	BaseRepo         string `json:"repo,omitempty"`
	BaseRef          string `json:"ref,omitempty"`
	ResolvedBaseHash string `json:"resolved_hash,omitempty"`
	GitAuthor        string `json:"author,omitempty"`
}

type GitCommitContext struct {
	ParentRef   string `json:"parent_ref,omitempty"`  // ref carrying workspace state until a hash exists
	PersistHash string `json:"hash,omitempty"`        // materialized SHA after a commit is created
	ParentHash  string `json:"parent_hash,omitempty"` // resolved job parent/root SHA once materialized
}

type GitExecutionReferences struct {
	BaseHash string `json:"base_hash"`
	HeadHash string `json:"head_hash"`
}

type GitTask struct {
	Execution        GitExecutionReferences `json:"execution"`
	BaseRepo         string                 `json:"repo,omitempty"`
	BaseRef          string                 `json:"ref,omitempty"`
	ResolvedBaseHash string                 `json:"resolved_hash,omitempty"`
	GitAuthor        string                 `json:"author,omitempty"`
	ParentRef        string                 `json:"parent_ref,omitempty"`  // ref carrying workspace state until a hash exists
	PersistHash      string                 `json:"hash,omitempty"`        // materialized SHA after a commit is created
	ParentHash       string                 `json:"parent_hash,omitempty"` // resolved job parent/root SHA once materialized
}

type InlineBoundaryFrame struct {
	CallsitePath      string `json:"callsite_path,omitempty"`
	BoundaryNodePath  string `json:"boundary_node_path,omitempty"`
	RecipeID          string `json:"recipe_id,omitempty"`
	RecipeVersion     string `json:"recipe_version,omitempty"`
	SourceKind        string `json:"source_kind,omitempty"`
	SubmittedSelector string `json:"submitted_selector,omitempty"`
	ResolvedSelector  string `json:"resolved_selector,omitempty"`
	ResolvedCommit    string `json:"resolved_commit,omitempty"`
	ContentSHA256     string `json:"content_sha256,omitempty"`
}

type Invocation struct {
	NodePath  string `json:"path"`
	InvokeSeq int64  `json:"sequence"`
}

type InvocationCtx struct {
	Hash      string `json:"hash"`
	NodePath  string `json:"path"`
	InvokeSeq int64  `json:"sequence"`
}

type JobContext struct {
	InitialCommit   *GitCommitContext        `json:"initial_commit,omitempty"`
	RestoreArtifact *jobdb.ArtifactKey       `json:"restore_artifact,omitempty"`
	Workspace       *WorkspaceContext        `json:"workspace,omitempty"`
	CellResolution  *cellref.Context         `json:"cell_resolution,omitempty"`
	Environment     EnvironmentContext       `json:"environment,omitempty"`
	Artifacts       map[string]artifacts.Ref `json:"artifacts,omitempty"`
	Workflow        WorkflowContext          `json:"workflow,omitempty"`
	GitBase         GitBaseContext           `json:"git,omitempty"`
	RecipeSource    RecipeSourceContext      `json:"recipe_source,omitempty"`
}

type RecipeSourceContext struct {
	Repo     string `json:"repo,omitempty"`
	Ref      string `json:"ref,omitempty"`
	Path     string `json:"path,omitempty"`
	Selector string `json:"selector,omitempty"`
}

type RunOutput struct {
	Outputs   map[string]interface{}        `json:"outputs"`
	Artifacts map[string]artifacts.Ref      `json:"artifacts"`
	Jobs      jobcontext.StartedJobsContext `json:"jobs,omitempty"`
	RunID     string                        `json:"run_id"`
	Timestamp time.Time                     `json:"timestamp"`
}

type StepOutput struct {
	Outputs   map[string]interface{}        `json:"outputs"`
	Artifacts map[string]artifacts.Ref      `json:"artifacts"`
	Jobs      jobcontext.StartedJobsContext `json:"jobs,omitempty"`
	Runs      []RunOutput                   `json:"runs"` // Previous runs (state loops)
}

type TaskContext struct {
	// GitCommit is shared across entire ResolutionContext and often updated. Thus must be a pointer.
	GitCommit  *GitCommitContext
	Invocation Invocation
}

type TaskExecutionContext struct {
	Workspace      *WorkspaceContext `json:"workspace,omitempty"`
	CellResolution *cellref.Context  `json:"cell_resolution,omitempty"`
	// embed these directly from task and job contexts for easier resolution.
	Environment  EnvironmentContext       `json:"environment,omitempty"`
	Artifacts    map[string]artifacts.Ref `json:"artifacts,omitempty"`
	Workflow     WorkflowContext          `json:"workflow,omitempty"`
	RecipeSource RecipeSourceContext      `json:"recipe_source,omitempty"`
	GitTask      GitTask                  `json:"git,omitempty"`
	Invocation   InvocationCtx            `json:"invocation,omitempty"`
	InlineStack  []InlineBoundaryFrame    `json:"inline_stack,omitempty"`
}

type WorkflowContext struct {
	CellID    string `json:"cell_id,omitempty"`
	CellName  string `json:"cell,omitempty"`
	JobID     string `json:"job_id,omitempty"`
	ProjectId string `json:"project_id,omitempty"`
}

type WorkspaceContext struct {
	Cell          string `json:"cell,omitempty"`
	ScopeID       string `json:"scope_id,omitempty"`
	ParentScopeID string `json:"parent_scope_id,omitempty"`
	InitialHash   string `json:"initial_hash,omitempty"`
}