harness

package

v0.1.13 Latest Latest Go to latest Published: Aug 27, 2026 License: MIT Imports: 2 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/GrayCodeAI/hawk-core-contracts

Links

Open Source Insights

Documentation ¶

Index ¶

type AssetsDetected
type Dimension
type DimensionScore
type EvidenceState
type Finding
type Report
- func (r *Report) MaxSeverity() contracts.Severity

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type AssetsDetected ¶

type AssetsDetected struct {
	AgentsMD      bool     `json:"agents_md"`
	AgentsMDPath  string   `json:"agents_md_path,omitempty"`
	ZeroMD        bool     `json:"zero_md"`
	ZeroMDPath    string   `json:"zero_md_path,omitempty"`
	Skills        []string `json:"skills"`
	SpecsCount    int      `json:"specs_count"`
	Linters       []string `json:"linters"`
	TestRunners   []string `json:"test_runners"`
	Hooks         []string `json:"hooks"`
	SandboxPolicy string   `json:"sandbox_policy"`
	AutonomyTier  string   `json:"autonomy_tier"`
	InspectBridge bool     `json:"inspect_bridge"`
	SightBridge   bool     `json:"sight_bridge"`
}

AssetsDetected lists the project harness assets detected during evaluation.

type Dimension ¶

type Dimension string

Dimension represents one of the 5 core Agent Work Loop dimensions.

const (
	DimensionFeedforward       Dimension = "Feedforward Guidance"
	DimensionFeedback          Dimension = "Feedback Sensors"
	DimensionTaskUnderstanding Dimension = "Task Understanding"
	DimensionStepPlanning      Dimension = "Step Planning & Execution"
	DimensionVerification      Dimension = "Verification & Safeguards"
)

type DimensionScore ¶

type DimensionScore struct {
	Dimension     Dimension     `json:"dimension"`
	Score         int           `json:"score"` // 0 to 100
	State         EvidenceState `json:"state"`
	Summary       string        `json:"summary"`
	FindingsCount int           `json:"findings_count"`
}

DimensionScore holds aggregated scoring for a single Agent Work Loop dimension.

type EvidenceState ¶

type EvidenceState string

EvidenceState describes whether an evidence mechanism is Present, Partial, Missing, or Unobserved.

const (
	EvidenceStatePresent    EvidenceState = "Present"
	EvidenceStatePartial    EvidenceState = "Partial"
	EvidenceStateMissing    EvidenceState = "Missing"
	EvidenceStateUnobserved EvidenceState = "Unobserved"
)

type Finding ¶

type Finding struct {
	ID              string             `json:"id"`
	Dimension       Dimension          `json:"dimension"`
	Severity        contracts.Severity `json:"severity"`
	Title           string             `json:"title"`
	Description     string             `json:"description"`
	Impact          string             `json:"impact"`
	EvidenceSource  string             `json:"evidence_source"`
	EvidenceState   EvidenceState      `json:"evidence_state"`
	ExpectedOutcome string             `json:"expected_outcome"`
	ScopedRepair    string             `json:"scoped_repair"`
	ValidationRoute string             `json:"validation_route"`
}

Finding represents a single actionable evaluation discovery in the neutral harness contract.

type Report ¶

type Report struct {
	TargetPath    string                       `json:"target_path"`
	GeneratedAt   time.Time                    `json:"generated_at"`
	OverallScore  int                          `json:"overall_score"` // 0 to 100
	OverallStatus string                       `json:"overall_status"`
	Dimensions    map[Dimension]DimensionScore `json:"dimensions"`
	Findings      []Finding                    `json:"findings"`
	Assets        AssetsDetected               `json:"assets"`
	Summary       string                       `json:"summary"`
}

Report is the neutral cross-repo contract for Hawk Agent Harness evaluations.

func (*Report) MaxSeverity ¶

func (r *Report) MaxSeverity() contracts.Severity

MaxSeverity returns the highest severity finding in the harness report.

Source Files ¶

View all Source files

harness.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL