Documentation
¶
Index ¶
- Constants
- type ActivateRecommendationInput
- type ActivateRecommendationRequest
- type ActivationTemplate
- type ActivityTrendContext
- type AgentContext
- type Analysis
- type ProjectContext
- type Recommendation
- type Snapshot
- type StaffingPlan
- type StatusBindingContext
- type Summary
- type TicketContext
- type WorkflowContext
Constants ¶
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
}
func ParseActivateRecommendation ¶
func ParseActivateRecommendation(projectID uuid.UUID, raw ActivateRecommendationRequest) (ActivateRecommendationInput, error)
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 ¶
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 ¶
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 ¶
StaffingPlan estimates headcount split by role family.
type StatusBindingContext ¶
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.