hradvisor

package
v0.2.2 Latest Latest
Warning

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

Go to latest
Published: Apr 5, 2026 License: Apache-2.0 Imports: 5 Imported by: 0

Documentation

Index

Constants

View Source
const (
	ActivityTrendDocumentationDrift = "documentation_drift"
	ActivityTrendFailureBurst       = "failure_burst"
)

Variables

This section is empty.

Functions

This section is empty.

Types

type ActivateRecommendationInput

type ActivateRecommendationInput struct {
	ProjectID             uuid.UUID
	RoleSlug              string
	CreateBootstrapTicket bool
}

type ActivateRecommendationRequest

type ActivateRecommendationRequest struct {
	RoleSlug              string `json:"role_slug"`
	CreateBootstrapTicket *bool  `json:"create_bootstrap_ticket,omitempty"`
}

type ActivationTemplate

type ActivationTemplate struct {
	RoleSlug              string
	WorkflowName          string
	WorkflowType          string
	HarnessPath           string
	HarnessContent        string
	PickupStatusNames     []string
	FinishStatusNames     []string
	Summary               string
	PlatformAccessAllowed []string
	SkillNames            []string
}

func NormalizeActivationTemplate

func NormalizeActivationTemplate(template ActivationTemplate) (ActivationTemplate, error)

type ActivityTrendContext

type ActivityTrendContext struct {
	Kind     string
	Count    int
	Evidence []string
	LastSeen time.Time
}

ActivityTrendContext summarizes one parsed recent-activity trend.

type AgentContext

type AgentContext struct {
	Status string
}

AgentContext summarizes one agent for staffing analysis.

type Analysis

type Analysis struct {
	Summary         Summary
	Recommendations []Recommendation
	Staffing        StaffingPlan
}

Analysis is the staffing recommendation result produced by the advisor.

type ProjectContext

type ProjectContext struct {
	Name                string
	Description         string
	Status              string
	MaxConcurrentAgents int
}

ProjectContext summarizes the project-level planning signals.

type Recommendation

type Recommendation struct {
	RoleSlug                   string
	Priority                   string
	Reason                     string
	Evidence                   []string
	SuggestedHeadcount         int
	SuggestedWorkflowName      string
	SuggestedWorkflowTypeLabel string
	SuggestedWorkflowFamily    string
}

Recommendation suggests adding or adjusting one role workflow.

type Snapshot

type Snapshot struct {
	Project             ProjectContext
	Tickets             []TicketContext
	Workflows           []WorkflowContext
	Agents              []AgentContext
	RecentActivityCount int
	RecentTrends        []ActivityTrendContext
	ActiveRoleSlugs     []string
}

Snapshot is the project state analyzed by the HR advisor.

type StaffingPlan

type StaffingPlan struct {
	Developers int
	QA         int
	Docs       int
	Security   int
	Product    int
	Research   int
}

StaffingPlan estimates headcount split by role family.

type StatusBindingContext

type StatusBindingContext struct {
	Name  string
	Stage string
}

StatusBindingContext summarizes one workflow-bound status.

type Summary

type Summary struct {
	OpenTickets            int
	CodingTickets          int
	FailingTickets         int
	BlockedTickets         int
	ActiveAgents           int
	WorkflowCount          int
	RecentActivityCount    int
	ActiveWorkflowFamilies []string
}

Summary captures aggregate staffing signals from a snapshot.

type TicketContext

type TicketContext struct {
	Identifier        string
	Type              string
	StatusName        string
	StatusStage       string
	WorkflowType      string
	WorkflowTypeLabel string
	HasActiveRun      bool
	ConsecutiveErrors int
	RetryPaused       bool
}

TicketContext summarizes one ticket for staffing analysis.

type WorkflowContext

type WorkflowContext struct {
	Name           string
	Type           string
	TypeLabel      string
	RoleSlug       string
	IsActive       bool
	HarnessPath    string
	HarnessContent string
	PickupStatuses []StatusBindingContext
	FinishStatuses []StatusBindingContext
}

WorkflowContext summarizes one workflow for staffing analysis.

Jump to

Keyboard shortcuts

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