executor

package module
v0.4.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 31, 2026 License: MIT Imports: 1 Imported by: 0

Documentation

Overview

Package executor is the public facade over the pluggable-execution module (ADR-0016): the Executor interface, Registry, and the built-in executors (sh, HTTP, headless agent, review, status, dlqfix, prioritize). The implementation stays internal; this package pins the names.

Index

Constants

View Source 
const (
	VerifyGateDead          = internalexecutor.VerifyGateDead
	VerifyGateSlow          = internalexecutor.VerifyGateSlow
	VerifyGateEnvironmental = internalexecutor.VerifyGateEnvironmental
	VerifyGateEnvCode       = internalexecutor.VerifyGateEnvCode
)

Verify-gate failure classes (see VerifyGateError).

View Source 
const (
	VerifyStageGofmt      = internalexecutor.VerifyStageGofmt
	VerifyStageTest       = internalexecutor.VerifyStageTest
	VerifyStageE2ETimeout = internalexecutor.VerifyStageE2ETimeout
	VerifyStageRun        = internalexecutor.VerifyStageRun
)

Verify-gate death classes stamped into FailureEvidence.VerifyStage (see verifyDeathStage).

View Source 
const (
	FailureClassTransient      = internalexecutor.FailureClassTransient
	FailureClassPermanent      = internalexecutor.FailureClassPermanent
	FailureClassProviderWindow = internalexecutor.FailureClassProviderWindow
	FailureClassEnvironment    = internalexecutor.FailureClassEnvironment
)
View Source 
const (
	TaskTypeAgent      = internalexecutor.TaskTypeAgent
	TaskTypeReview     = internalexecutor.TaskTypeReview
	TaskTypeStatus     = internalexecutor.TaskTypeStatus
	TaskTypeDLQFix     = internalexecutor.TaskTypeDLQFix
	TaskTypePrioritize = internalexecutor.TaskTypePrioritize
	TaskTypeDepBump    = internalexecutor.TaskTypeDepBump
)

Task-type keys.

View Source 
const (
	DefaultAgentBinary    = internalexecutor.DefaultAgentBinary
	DefaultCloseoutPrompt = internalexecutor.DefaultCloseoutPrompt
	EvidenceTailBytes     = internalexecutor.EvidenceTailBytes
	GoEnvExperiment       = internalexecutor.GoEnvExperiment
	RedactMarker          = internalexecutor.RedactMarker
	ScopedGofmtStage      = internalexecutor.ScopedGofmtStage
	TaskTrailer           = internalexecutor.TaskTrailer
	WorktreeBranchPrefix  = internalexecutor.WorktreeBranchPrefix
)

Defaults and knobs.

View Source 
const (
	VerdictApprove        = internalexecutor.VerdictApprove
	VerdictRequestChanges = internalexecutor.VerdictRequestChanges
	VerdictFixed          = internalexecutor.VerdictFixed
	VerdictWontFix        = internalexecutor.VerdictWontFix
)

Verdicts.

View Source 
const (
	RiskLow    = internalexecutor.RiskLow
	RiskMedium = internalexecutor.RiskMedium
	RiskHigh   = internalexecutor.RiskHigh
)

Review-finding vocabulary (internal finding.go): review/dlqfix results carry findings, so the facade mirrors the scale and the merge seam.

View Source 
const EnvStreakCode = internalexecutor.EnvStreakCode

EnvStreakCode marks breaker-burned attempts in the journal: a consecutive environmental-death streak escalating into attempt burn.

Variables

View Source 
var (
	LastFailureEvidence          = internalexecutor.LastFailureEvidence
	LastFailureEvidenceFromTrail = internalexecutor.LastFailureEvidenceFromTrail
	MatchesEvidenceStageSet      = internalexecutor.MatchesEvidenceStageSet
	MatchesEvidenceStage         = internalexecutor.MatchesEvidenceStage
)
View Source 
var (
	MergeWorktreeBranch  = internalexecutor.MergeWorktreeBranch
	ScanWorktreeOrphans  = internalexecutor.ScanWorktreeOrphans
	ReapWorktreeOrphans  = internalexecutor.ReapWorktreeOrphans
	DeleteWorktreeBranch = internalexecutor.DeleteWorktreeBranch
	RemoveWorktree       = internalexecutor.RemoveWorktree
	ResolveRepoDir       = internalexecutor.ResolveRepoDir
)

Worktree merge/reap seams (worktree-per-agent delivery).

View Source 
var (
	ErrUnknownType                = internalexecutor.ErrUnknownType
	ErrDLQFixSummaryMissing       = internalexecutor.ErrDLQFixSummaryMissing
	ErrPrioritizeEmptyPayload     = internalexecutor.ErrPrioritizeEmptyPayload
	ErrPrioritizeSparsePayload    = internalexecutor.ErrPrioritizeSparsePayload
	ErrPrioritizeUnknownItem      = internalexecutor.ErrPrioritizeUnknownItem
	ErrPrioritizeDuplicateVerdict = internalexecutor.ErrPrioritizeDuplicateVerdict
	ErrPrioritizeMissingVerdict   = internalexecutor.ErrPrioritizeMissingVerdict
	ErrPrioritizeScoreRange       = internalexecutor.ErrPrioritizeScoreRange
	ErrDepBumpEmptyPayload        = internalexecutor.ErrDepBumpEmptyPayload
	ErrDepBumpNoWork              = internalexecutor.ErrDepBumpNoWork
	ErrDepBumpBadVersion          = internalexecutor.ErrDepBumpBadVersion
)

Sentinel errors.

View Source 
var (
	NewRegistry              = internalexecutor.NewRegistry
	NewCommandExecutor       = internalexecutor.NewCommandExecutor
	NewHTTPExecutor          = internalexecutor.NewHTTPExecutor
	NewAgentExecutor         = internalexecutor.NewAgentExecutor
	AgentVersion             = internalexecutor.AgentVersion
	CommandFromPayload       = internalexecutor.CommandFromPayload
	DetectRateLimit          = internalexecutor.DetectRateLimit
	DetectVerify             = internalexecutor.DetectVerify
	Excerpt                  = internalexecutor.Excerpt
	ExtractResultPayload     = internalexecutor.ExtractResultPayload
	ExtractSessionID         = internalexecutor.ExtractSessionID
	Permanent                = internalexecutor.Permanent
	QuestionPending          = internalexecutor.QuestionPending
	RateLimited              = internalexecutor.RateLimited
	ReadTQVerify             = internalexecutor.ReadTQVerify
	RenderAgentPayload       = internalexecutor.RenderAgentPayload
	ResultLine               = internalexecutor.ResultLine
	RedactSecrets            = internalexecutor.RedactSecrets
	SecretHits               = internalexecutor.SecretHits
	SetFailureEvidence       = internalexecutor.SetFailureEvidence
	SetVerifyFailureEvidence = internalexecutor.SetVerifyFailureEvidence
	SetResultDetail          = internalexecutor.SetResultDetail
	StaleVerifyReasons       = internalexecutor.StaleVerifyReasons
	SweepSidecars            = internalexecutor.SweepSidecars
	SweepSidecarsByBytes     = internalexecutor.SweepSidecarsByBytes
	ParseResult              = internalexecutor.ParseResult
	ParseDLQFixResult        = internalexecutor.ParseDLQFixResult
	ParsePrioritizeResult    = internalexecutor.ParsePrioritizeResult
	NewSink                  = internalexecutor.NewSink
	NewDepBumpExecutor       = internalexecutor.NewDepBumpExecutor
	IsStableSemver           = internalexecutor.IsStableSemver
)

Functions.

View Source 
var ClassifyFailure = internalexecutor.ClassifyFailure

ClassifyFailure maps a failed run's error onto the retry taxonomy.

View Source 
var ErrDirtyTree = internalexecutor.ErrDirtyTree

ErrDirtyTree rides a dirty-tree preflight refusal's cause chain so the worker can park the task instead of burning it via the env-streak breaker (foreign concurrent-agent dirt must not spend attempts).

View Source 
var IsEnvironmentalDeath = internalexecutor.IsEnvironmentalDeath

IsEnvironmentalDeath reports whether a terminal failure is an environmental death (rate limits, provider windows, breaker burns, red-at-base, gate-slow deadline-before-verdict) — unfixable from inside the repository, so autopsies can only rule wontfix.

View Source 
var IsGateArtifactDeath = internalexecutor.IsGateArtifactDeath

IsGateArtifactDeath classifies a stored verify failure as the unscoped-gofmt artifact (the vendor-gofmt death class).

View Source 
var MergeFindings = internalexecutor.MergeFindings

Functions

This section is empty.

Types

type AgentExecutor 

type AgentExecutor = internalexecutor.AgentExecutor

Built-in executors.

type AgentPayload 

type AgentPayload = internalexecutor.AgentPayload

Payloads, results, and verdicts.

type AgentResult 

type AgentResult = internalexecutor.AgentResult

Payloads, results, and verdicts.

type CommandExecutor 

type CommandExecutor = internalexecutor.CommandExecutor

Built-in executors.

type Commit added in v0.3.1 

type Commit = internalexecutor.Commit

Commit-attribution scanner (gitscan.go): which commits carry a git footer `key: value`.

type DLQFixExecutor 

type DLQFixExecutor = internalexecutor.DLQFixExecutor

Built-in executors.

type DLQFixPayload 

type DLQFixPayload = internalexecutor.DLQFixPayload

Payloads, results, and verdicts.

type DLQFixResult 

type DLQFixResult = internalexecutor.DLQFixResult

Payloads, results, and verdicts.

type DLQFixVerdict 

type DLQFixVerdict = internalexecutor.DLQFixVerdict

Payloads, results, and verdicts.

type DepBump added in v0.3.1 

type DepBump = internalexecutor.DepBump

Payloads, results, and verdicts.

type DepBumpExecutor added in v0.3.1 

type DepBumpExecutor = internalexecutor.DepBumpExecutor

Built-in executors.

type DepBumpPayload added in v0.3.1 

type DepBumpPayload = internalexecutor.DepBumpPayload

Payloads, results, and verdicts.

type DepBumpRelease added in v0.3.1 

type DepBumpRelease = internalexecutor.DepBumpRelease

Payloads, results, and verdicts.

type Executor 

type Executor = internalexecutor.Executor

Executor contract.

type FactTrailReader added in v0.4.1 

type FactTrailReader = internalexecutor.FactTrailReader

Failure-evidence surfaces (evidence.go): the trail seam the evidence functions read, and the matchers behind `tq dlq --evidence-stage`.

type FailureClass added in v0.3.1 

type FailureClass = internalexecutor.FailureClass

Retry-failure taxonomy (see FailureEvidence.Class): why a run failed, stamped by the worker so autopsies and forensics never re-derive it from output tails.

type FailureEvidence 

type FailureEvidence = internalexecutor.FailureEvidence

Payloads, results, and verdicts.

type Finding added in v0.3.4 

type Finding = internalexecutor.Finding

type Func 

type Func = internalexecutor.Func

Executor contract.

type GitLogScanner added in v0.3.1 

type GitLogScanner = internalexecutor.GitLogScanner

Commit-attribution scanner (gitscan.go): which commits carry a git footer `key: value`.

type GitScanner added in v0.3.1 

type GitScanner = internalexecutor.GitScanner

Commit-attribution scanner (gitscan.go): which commits carry a git footer `key: value`.

type GitScannerFunc added in v0.3.1 

type GitScannerFunc = internalexecutor.GitScannerFunc

Commit-attribution scanner (gitscan.go): which commits carry a git footer `key: value`.

type HTTPExecutor 

type HTTPExecutor = internalexecutor.HTTPExecutor

Built-in executors.

type LeaseLostError 

type LeaseLostError = internalexecutor.LeaseLostError

Typed errors.

type PermanentError 

type PermanentError = internalexecutor.PermanentError

Typed errors.

type PreflightError 

type PreflightError = internalexecutor.PreflightError

Typed errors.

type PrioritizeExecutor 

type PrioritizeExecutor = internalexecutor.PrioritizeExecutor

Built-in executors.

type PrioritizeItem 

type PrioritizeItem = internalexecutor.PrioritizeItem

Payloads, results, and verdicts.

type PrioritizePayload 

type PrioritizePayload = internalexecutor.PrioritizePayload

Payloads, results, and verdicts.

type PrioritizeResult 

type PrioritizeResult = internalexecutor.PrioritizeResult

Payloads, results, and verdicts.

type PrioritizeVerdict 

type PrioritizeVerdict = internalexecutor.PrioritizeVerdict

Payloads, results, and verdicts.

type QuestionPendingError added in v0.3.1 

type QuestionPendingError = internalexecutor.QuestionPendingError

Typed errors.

type RateLimitError 

type RateLimitError = internalexecutor.RateLimitError

Typed errors.

type Registry 

type Registry = internalexecutor.Registry

Executor contract.

type ReviewExecutor 

type ReviewExecutor = internalexecutor.ReviewExecutor

Built-in executors.

type ReviewFinding 

type ReviewFinding = internalexecutor.ReviewFinding

Payloads, results, and verdicts.

type ReviewPayload 

type ReviewPayload = internalexecutor.ReviewPayload

Payloads, results, and verdicts.

type ReviewResult 

type ReviewResult = internalexecutor.ReviewResult

Payloads, results, and verdicts.

type ReviewVerdict 

type ReviewVerdict = internalexecutor.ReviewVerdict

Payloads, results, and verdicts.

type Sink 

type Sink = internalexecutor.Sink

Sink carries failure/result detail through the context (error and result sinks).

type StatusCompletion 

type StatusCompletion = internalexecutor.StatusCompletion

Payloads, results, and verdicts.

type StatusExecutor 

type StatusExecutor = internalexecutor.StatusExecutor

Built-in executors.

type StatusPayload 

type StatusPayload = internalexecutor.StatusPayload

Payloads, results, and verdicts.

type StatusResult 

type StatusResult = internalexecutor.StatusResult

Payloads, results, and verdicts.

type VerifyGateClass added in v0.3.1 

type VerifyGateClass = internalexecutor.VerifyGateClass

Typed errors.

type VerifyGateError added in v0.3.1 

type VerifyGateError = internalexecutor.VerifyGateError

Typed errors.

type WorktreeOrphan added in v0.4.0 

type WorktreeOrphan = internalexecutor.WorktreeOrphan

Worktree delivery remnant scanning (worktreereap.go): the orphan reaper surfaces tq/* checkouts and branches whose task is no longer in-flight.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.