prd

type AcceptanceCriterion struct {
	ID          string `json:"id"`
	Description string `json:"description"`
	Given       string `json:"given,omitempty"` // Precondition
	When        string `json:"when,omitempty"`  // Action
	Then        string `json:"then,omitempty"`  // Expected result
}

type AccessControl struct {
	// Model is the access control model (RBAC, ABAC, ReBAC, etc.).
	Model string `json:"model"`

	// Description provides details on the access control approach.
	Description string `json:"description,omitempty"`

	// Layers describes access control at different layers.
	Layers []AccessControlLayer `json:"layers,omitempty"`

	// Roles defines available roles and permissions.
	Roles []SecurityRole `json:"roles,omitempty"`

	// Policies describes policy enforcement (e.g., Cedar, OPA).
	Policies string `json:"policies,omitempty"`
}

type AccessControlLayer struct {
	// Layer name (e.g., "API Gateway", "Application", "Data").
	Layer string `json:"layer"`

	// Controls implemented at this layer.
	Controls []string `json:"controls"`

	// Description provides additional context.
	Description string `json:"description,omitempty"`
}

type AccessibilitySpec struct {
	Standard        string   `json:"standard"` // WCAG 2.1 AA
	Requirements    []string `json:"requirements,omitempty"`
	TestingApproach string   `json:"testing_approach,omitempty"`
}

type AlertingSpec struct {
	Channels          []string `json:"channels"` // PagerDuty, Slack, Email
	EscalationPolicy  string   `json:"escalation_policy,omitempty"`
	OnCallIntegration bool     `json:"on_call_integration,omitempty"`
}

type Alternative struct {
	// ID is the unique identifier for this alternative.
	ID string `json:"id"`

	// Name is the name of the alternative.
	Name string `json:"name"`

	// Type categorizes the alternative.
	Type AlternativeType `json:"type"`

	// Description provides details about the alternative.
	Description string `json:"description,omitempty"`

	// Strengths are advantages of this alternative.
	Strengths []string `json:"strengths,omitempty"`

	// Weaknesses are disadvantages of this alternative.
	Weaknesses []string `json:"weaknesses,omitempty"`

	// WhyNotChosen explains why this alternative was not selected.
	WhyNotChosen string `json:"why_not_chosen,omitempty"`
}

type AlternativeSnapshot struct {
	Name       string   `json:"name"`
	Weaknesses []string `json:"weaknesses"`
}

type AlternativeType string

type Appendix struct {
	// ID is the unique identifier for this appendix.
	ID string `json:"id"`

	// Title is the appendix title.
	Title string `json:"title"`

	// Description provides context for this appendix.
	Description string `json:"description,omitempty"`

	// Type indicates the primary content type (hint for rendering).
	Type AppendixType `json:"type"`

	// ContentString is Markdown text content.
	// Rendered before ContentTable if both are set.
	ContentString string `json:"content_string,omitempty"`

	// ContentTable is structured table data.
	// Rendered after ContentString if both are set.
	ContentTable *AppendixTable `json:"content_table,omitempty"`

	// Schema is the standard schema type (for validation and rendering hints).
	Schema AppendixSchema `json:"schema,omitempty"`

	// Tags for filtering and categorization.
	Tags []string `json:"tags,omitempty"`

	// ReferencedBy lists IDs of items that reference this appendix.
	// This is typically computed, not manually set.
	ReferencedBy []string `json:"referenced_by,omitempty"`
}

type AppendixSchema string

type AppendixTable struct {
	// Headers are column headers.
	Headers []string `json:"headers,omitempty"`

	// Rows are table rows.
	Rows [][]string `json:"rows"`

	// Caption provides optional table description/footer.
	Caption string `json:"caption,omitempty"`
}

type AppendixType string

type Approver = common.Approver

type Assumption struct {
	ID          string `json:"id"`
	Description string `json:"description"`
	Rationale   string `json:"rationale,omitempty"`
	Risk        string `json:"risk,omitempty"` // What happens if assumption is wrong
	Validated   bool   `json:"validated,omitempty"`
}

type AssumptionsConstraints struct {
	Assumptions  []Assumption `json:"assumptions"`
	Constraints  []Constraint `json:"constraints"`
	Dependencies []Dependency `json:"dependencies,omitempty"`
}

type AuditLogging struct {
	// Scope describes what is logged.
	Scope string `json:"scope"`

	// Events lists specific events that are logged.
	Events []string `json:"events,omitempty"`

	// Format is the log format (e.g., "OCSF", "JSON", "CEF").
	Format string `json:"format,omitempty"`

	// Retention is how long logs are retained.
	Retention string `json:"retention"`

	// Immutability describes tamper-proofing approach.
	Immutability string `json:"immutability,omitempty"`

	// Destination is where logs are stored.
	Destination string `json:"destination,omitempty"`
}

type BaselineMetric struct {
	// ID is the unique identifier for this metric.
	ID string `json:"id,omitempty"`

	// Name of the metric.
	Name string `json:"name"`

	// CurrentValue is the baseline value.
	CurrentValue string `json:"current_value"`

	// TargetValue is the desired value after implementation.
	TargetValue string `json:"target_value,omitempty"`

	// MeasurementMethod describes how this is measured.
	MeasurementMethod string `json:"measurement_method,omitempty"`

	// Source is where the current value was obtained.
	Source string `json:"source,omitempty"`
}

type Blocker struct {
	// ID is the unique identifier for this blocker.
	ID string `json:"id"`

	// Category is the scoring category related to this blocker.
	Category string `json:"category"`

	// Description describes the blocking issue.
	Description string `json:"description"`
}

type CategoryScore struct {
	Category       string  `json:"category"`
	Weight         float64 `json:"weight"`
	Score          float64 `json:"score"`
	MaxScore       float64 `json:"max_score"`
	Justification  string  `json:"justification"`
	Evidence       string  `json:"evidence"`
	BelowThreshold bool    `json:"below_threshold"`
}

type CategoryWeight struct {
	Category string
	Weight   float64
}

type CompletenessReport struct {
	OverallScore     float64          `json:"overall_score"`     // 0-100
	Grade            string           `json:"grade"`             // A, B, C, D, F
	Sections         []SectionScore   `json:"sections"`          // Per-section scores
	Recommendations  []Recommendation `json:"recommendations"`   // Improvement suggestions
	Summary          string           `json:"summary"`           // Human-readable summary
	RequiredComplete int              `json:"required_complete"` // Count of complete required sections
	RequiredTotal    int              `json:"required_total"`    // Total required sections
	OptionalComplete int              `json:"optional_complete"` // Count of complete optional sections
	OptionalTotal    int              `json:"optional_total"`    // Total optional sections
}

type Constraint struct {
	ID          string         `json:"id"`
	Type        ConstraintType `json:"type"`
	Description string         `json:"description"`
	Impact      string         `json:"impact,omitempty"`
	Mitigation  string         `json:"mitigation,omitempty"`
}

type ConstraintType string

type CurrentApproach struct {
	// ID is the unique identifier for this approach.
	ID string `json:"id,omitempty"`

	// Name is the identifier for this approach.
	Name string `json:"name"`

	// Description explains how this approach works.
	Description string `json:"description"`

	// Problems lists issues with this approach.
	Problems []string `json:"problems,omitempty"`

	// Usage indicates adoption level (e.g., "80% of customers").
	Usage string `json:"usage,omitempty"`

	// Owner is the team/person responsible for this approach.
	Owner string `json:"owner,omitempty"`
}

type CurrentProblem struct {
	// ID is the unique identifier for this problem.
	ID string `json:"id,omitempty"`

	// Description of the problem.
	Description string `json:"description"`

	// Impact on users or business.
	Impact string `json:"impact,omitempty"`

	// Frequency of occurrence.
	Frequency string `json:"frequency,omitempty"`

	// AffectedUsers describes who is impacted.
	AffectedUsers string `json:"affected_users,omitempty"`

	// RelatedIDs links to related requirements or risks.
	RelatedIDs []string `json:"related_ids,omitempty"`
}

type CurrentState struct {
	// Overview provides a high-level summary of the current state.
	Overview string `json:"overview"`

	// Approaches describes current approaches/solutions in use.
	Approaches []CurrentApproach `json:"approaches,omitempty"`

	// Problems lists specific problems with the current state.
	Problems []CurrentProblem `json:"problems,omitempty"`

	// TargetState describes the desired future state.
	TargetState string `json:"target_state"`

	// Metrics provides baseline metrics for comparison.
	Metrics []BaselineMetric `json:"metrics,omitempty"`

	// Diagrams provides links to architecture or flow diagrams.
	Diagrams []DiagramRef `json:"diagrams,omitempty"`
}

type CustomSection struct {
	ID          string `json:"id"`
	Title       string `json:"title"`
	Description string `json:"description,omitempty"`
	Content     any    `json:"content"`          // Flexible content structure
	Schema      string `json:"schema,omitempty"` // Optional JSON schema for validation
}

type CustomerProblemSection struct {
	Statement           string                `json:"statement"`
	Impact              string                `json:"impact"`
	Personas            []PersonaSnapshot     `json:"personas"`
	CurrentAlternatives []AlternativeSnapshot `json:"current_alternatives"`
	Evidence            []EvidenceSnapshot    `json:"evidence,omitempty"`
}

type DataClassification struct {
	// Level is the classification level (e.g., "public", "internal", "confidential", "restricted").
	Level string `json:"level"`

	// Description explains this classification level.
	Description string `json:"description"`

	// Examples of data at this level.
	Examples []string `json:"examples,omitempty"`

	// Handling requirements for this level.
	Handling string `json:"handling,omitempty"`
}

type DataSegregation string

type DecisionRecord struct {
	// ID is the unique identifier for this decision.
	ID string `json:"id"`

	// Decision is the decision that was made.
	Decision string `json:"decision"`

	// Rationale explains why this decision was made.
	Rationale string `json:"rationale,omitempty"`

	// AlternativesConsidered lists other options that were evaluated.
	AlternativesConsidered []string `json:"alternatives_considered,omitempty"`

	// MadeBy is the person or group who made the decision.
	MadeBy string `json:"made_by,omitempty"`

	// Date is when the decision was made.
	Date time.Time `json:"date,omitempty"`

	// Status is the current status of the decision.
	Status DecisionStatus `json:"status,omitempty"`

	// RelatedIDs are IDs of related items (requirements, risks, etc.).
	RelatedIDs []string `json:"related_ids,omitempty"`
}

type DecisionStatus string

type DecisionsDefinition struct {
	// Records are the decision records.
	Records []DecisionRecord `json:"records,omitempty"`
}

type Deliverable struct {
	ID          string            `json:"id"`
	Title       string            `json:"title"`
	Description string            `json:"description"`
	Type        DeliverableType   `json:"type"`
	Status      DeliverableStatus `json:"status,omitempty"`
	Tags        []string          `json:"tags,omitempty"` // For filtering by topic/domain
}

type DeliverableStatus string

type DeliverableType string

type Demographics struct {
	AgeRange    string `json:"age_range,omitempty"`
	Location    string `json:"location,omitempty"`
	Industry    string `json:"industry,omitempty"`
	CompanySize string `json:"company_size,omitempty"`
	Experience  string `json:"experience,omitempty"` // Years of experience
}

type Dependency struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	Description string `json:"description"`
	Type        string `json:"type,omitempty"` // API, Service, Team, Vendor
	Owner       string `json:"owner,omitempty"`
	Status      string `json:"status,omitempty"` // Available, Pending, Blocked
	DueDate     string `json:"due_date,omitempty"`
}

type DiagramRef struct {
	// Title is the diagram title.
	Title string `json:"title"`

	// URL is the link to the diagram.
	URL string `json:"url"`

	// Description provides context.
	Description string `json:"description,omitempty"`

	// Type is the diagram type (e.g., "architecture", "flow", "sequence").
	Type string `json:"type,omitempty"`
}

type Document struct {
	Metadata         Metadata         `json:"metadata"`
	ExecutiveSummary ExecutiveSummary `json:"executive_summary"`
	Objectives       Objectives       `json:"objectives"`
	Personas         []Persona        `json:"personas"`
	UserStories      []UserStory      `json:"user_stories"`
	Requirements     Requirements     `json:"requirements"`
	Roadmap          Roadmap          `json:"roadmap"`

	// Optional sections
	Assumptions      *AssumptionsConstraints `json:"assumptions,omitempty"`
	OutOfScope       []string                `json:"out_of_scope,omitempty"`
	TechArchitecture *TechnicalArchitecture  `json:"technical_architecture,omitempty"`
	UXRequirements   *UXRequirements         `json:"ux_requirements,omitempty"`
	Risks            []Risk                  `json:"risks,omitempty"`
	Glossary         []GlossaryTerm          `json:"glossary,omitempty"`

	// Custom sections for project-specific needs
	CustomSections []CustomSection `json:"custom_sections,omitempty"`

	// Problem provides detailed problem definition with evidence.
	Problem *ProblemDefinition `json:"problem,omitempty"`

	// Market contains market analysis and competitive landscape.
	Market *MarketDefinition `json:"market,omitempty"`

	// Solution contains solution options and selection rationale.
	Solution *SolutionDefinition `json:"solution,omitempty"`

	// Decisions contains decision records for the PRD.
	Decisions *DecisionsDefinition `json:"decisions,omitempty"`

	// OpenItems contains pending decisions that need resolution.
	OpenItems []OpenItem `json:"open_items,omitempty"`

	// Reviews contains review outcomes and quality assessments.
	Reviews *ReviewsDefinition `json:"reviews,omitempty"`

	// RevisionHistory tracks changes to the PRD over time.
	RevisionHistory []RevisionRecord `json:"revision_history,omitempty"`

	// Goals contains alignment with strategic goals (V2MOM, OKR).
	Goals *GoalsAlignment `json:"goals,omitempty"`

	// CurrentState documents the existing state before the proposed solution.
	CurrentState *CurrentState `json:"current_state,omitempty"`

	// SecurityModel documents security architecture and threat model.
	// This section is strongly recommended for all PRDs.
	SecurityModel *SecurityModel `json:"security_model,omitempty"`

	// Appendices contains supplementary information and domain-specific data.
	Appendices []Appendix `json:"appendices,omitempty"`
}

type EffortLevel string

type EncryptionModel string

type EncryptionRequirements struct {
	// AtRest describes encryption at rest.
	AtRest EncryptionSpec `json:"at_rest"`

	// InTransit describes encryption in transit.
	InTransit EncryptionSpec `json:"in_transit"`

	// FieldLevel describes field-level encryption if applicable.
	FieldLevel *EncryptionSpec `json:"field_level,omitempty"`
}

type EncryptionSpec struct {
	// Method is the encryption method (e.g., "AES-256-GCM").
	Method string `json:"method"`

	// KeyManagement describes key management approach.
	KeyManagement string `json:"key_management"`

	// Rotation describes key rotation policy.
	Rotation string `json:"rotation,omitempty"`

	// Provider is the encryption provider (e.g., "AWS KMS", "HashiCorp Vault").
	Provider string `json:"provider,omitempty"`
}

type EvaluationCategory struct {
	ID          string  // Category identifier
	Name        string  // Human-readable name
	Description string  // What this category evaluates
	Weight      float64 // Weight in overall score (0.0-1.0)
	Owner       string  // Suggested agent/team owner
}

type Evidence struct {
	// Type categorizes the evidence source.
	Type EvidenceType `json:"type"`

	// Source identifies where the evidence came from.
	Source string `json:"source"`

	// Summary describes what the evidence shows.
	Summary string `json:"summary,omitempty"`

	// SampleSize is the number of data points (for quantitative evidence).
	SampleSize int `json:"sample_size,omitempty"`

	// Strength indicates how strong the evidence is.
	Strength EvidenceStrength `json:"strength,omitempty"`

	// Date is when the evidence was collected.
	Date string `json:"date,omitempty"`
}

type EvidenceSnapshot struct {
	Type        string `json:"type"`
	Description string `json:"description"`
	Strength    string `json:"strength"`
}

type EvidenceStrength string

type EvidenceType string

type ExecAction struct {
	Action    string `json:"action"`
	Owner     string `json:"owner"`
	Priority  string `json:"priority"`
	Rationale string `json:"rationale"`
}

type ExecHeader struct {
	PRDID           string  `json:"prd_id"`
	Title           string  `json:"title"`
	OverallDecision string  `json:"overall_decision"`
	ConfidenceLevel string  `json:"confidence_level"`
	OverallScore    float64 `json:"overall_score"`
}

type ExecRisk struct {
	Risk       string `json:"risk"`
	Impact     string `json:"impact"`
	Mitigation string `json:"mitigation"`
	Confidence string `json:"confidence"`
}

type ExecView struct {
	Header                ExecHeader   `json:"header"`
	Strengths             []string     `json:"strengths"`
	Blockers              []string     `json:"blockers"`
	RequiredActions       []ExecAction `json:"required_actions"`
	TopRisks              []ExecRisk   `json:"top_risks"`
	RecommendationSummary string       `json:"recommendation_summary"`
}

type ExecutiveSummary struct {
	ProblemStatement string   `json:"problem_statement"`
	ProposedSolution string   `json:"proposed_solution"`
	ExpectedOutcomes []string `json:"expected_outcomes"`
	TargetAudience   string   `json:"target_audience,omitempty"`
	ValueProposition string   `json:"value_proposition,omitempty"`
}

type FAQ struct {
	Question string `json:"question"`
	Answer   string `json:"answer"`
}

type FAQSection struct {
	CustomerFAQs  []FAQ `json:"customer_faqs"`
	InternalFAQs  []FAQ `json:"internal_faqs"`
	TechnicalFAQs []FAQ `json:"technical_faqs,omitempty"`
}

type FeatureSnapshot struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Priority    string `json:"priority"`
}

type FunctionalRequirement struct {
	ID                 string                `json:"id"` // e.g., FR-001
	Title              string                `json:"title"`
	Description        string                `json:"description"`
	Category           string                `json:"category"` // Feature category
	Priority           MoSCoW                `json:"priority"`
	UserStoryIDs       []string              `json:"user_story_ids"` // Related user stories
	AcceptanceCriteria []AcceptanceCriterion `json:"acceptance_criteria"`
	PhaseID            string                `json:"phase_id"` // Target roadmap phase
	Dependencies       []string              `json:"dependencies,omitempty"`
	Assumptions        []string              `json:"assumptions,omitempty"`
	Tags               []string              `json:"tags,omitempty"` // For filtering by topic/domain
	Notes              string                `json:"notes,omitempty"`

	// AppendixRefs references appendices with additional details for this requirement.
	AppendixRefs []string `json:"appendix_refs,omitempty"`
}

type GlossaryTerm struct {
	Term       string   `json:"term"`
	Definition string   `json:"definition"`
	Acronym    string   `json:"acronym,omitempty"`
	Context    string   `json:"context,omitempty"`
	Related    []string `json:"related,omitempty"` // Related terms
}

type GoalReference struct {
	// ID is the unique identifier of the goals document.
	ID string `json:"id"`

	// Path is the file path to the goals document.
	Path string `json:"path,omitempty"`

	// URL is a URL to the goals document (e.g., Confluence, Notion).
	URL string `json:"url,omitempty"`

	// Version is the version of the goals document this PRD aligns with.
	Version string `json:"version,omitempty"`
}

type GoalsAlignment struct {
	// V2MOMRef is a reference to an external V2MOM document.
	V2MOMRef *GoalReference `json:"v2mom_ref,omitempty"`

	// V2MOM is an embedded V2MOM document.
	V2MOM *v2mom.V2MOM `json:"v2mom,omitempty"`

	// OKRRef is a reference to an external OKR document.
	OKRRef *GoalReference `json:"okr_ref,omitempty"`

	// OKR is an embedded OKR document.
	OKR *okr.OKRDocument `json:"okr,omitempty"`

	// AlignedObjectives maps PRD objectives to goal IDs.
	// Key is the PRD objective ID, value is the goal/method/objective ID.
	AlignedObjectives map[string]string `json:"aligned_objectives,omitempty"`
}

type Integration struct {
	ID            string `json:"id"`
	Name          string `json:"name"`
	Type          string `json:"type"` // REST API, GraphQL, Event, Database
	Description   string `json:"description"`
	Protocol      string `json:"protocol,omitempty"`
	AuthMethod    string `json:"auth_method,omitempty"`
	DataFormat    string `json:"data_format,omitempty"` // JSON, XML, Protobuf
	RateLimit     string `json:"rate_limit,omitempty"`
	Documentation string `json:"documentation,omitempty"` // URL to docs
}

type InteractionFlow struct {
	ID          string   `json:"id"`
	Title       string   `json:"title"`
	Description string   `json:"description"`
	Steps       []string `json:"steps"`
	DiagramURL  string   `json:"diagram_url,omitempty"`
}

type IsolationModel string

type KeyResult struct {
	ID                string        `json:"id"`
	Description       string        `json:"description"`
	Metric            string        `json:"metric"`                       // What is measured (e.g., "Monthly Active Users")
	Baseline          string        `json:"baseline,omitempty"`           // Starting value
	Target            string        `json:"target"`                       // Target value to achieve
	Current           string        `json:"current,omitempty"`            // Current value (for tracking)
	Unit              string        `json:"unit,omitempty"`               // e.g., "%", "users", "$"
	MeasurementMethod string        `json:"measurement_method,omitempty"` // How it's measured
	Owner             string        `json:"owner,omitempty"`              // Person or team responsible
	Confidence        float64       `json:"confidence,omitempty"`         // 0.0-1.0 confidence score
	PhaseTargets      []PhaseTarget `json:"phase_targets,omitempty"`      // Per-phase targets for roadmap alignment
	Tags              []string      `json:"tags,omitempty"`               // For filtering by topic/domain
}

type LibraryMetadata struct {
	Name        string    `json:"name,omitempty"`
	Description string    `json:"description,omitempty"`
	CreatedAt   time.Time `json:"created_at,omitempty"`
	UpdatedAt   time.Time `json:"updated_at,omitempty"`
}

type LibraryPersona struct {
	Persona
	CreatedAt   time.Time `json:"created_at,omitempty"`
	UpdatedAt   time.Time `json:"updated_at,omitempty"`
	UsedInPRDs  []string  `json:"used_in_prds,omitempty"`        // Track which PRDs use this persona
	Tags        []string  `json:"tags,omitempty"`                // For organization/filtering
	Description string    `json:"library_description,omitempty"` // Additional context for library
}

type LoggingSpec struct {
	Format                string   `json:"format"`           // JSON, structured
	RetentionPeriod       string   `json:"retention_period"` // e.g., "90 days"
	LogLevels             []string `json:"log_levels"`
	CorrelationID         bool     `json:"correlation_id"` // Include trace/correlation IDs
	SensitiveDataHandling string   `json:"sensitive_data_handling,omitempty"`
}

type MarkdownOptions struct {
	// IncludeFrontmatter adds YAML frontmatter for Pandoc
	IncludeFrontmatter bool
	// Margin sets the page margin (e.g., "2cm")
	Margin string
	// MainFont sets the main font family
	MainFont string
	// SansFont sets the sans-serif font family
	SansFont string
	// MonoFont sets the monospace font family
	MonoFont string
	// FontFamily sets the LaTeX font family (e.g., "helvet")
	FontFamily string
	// DescriptionMaxLen sets the max length for description fields in tables (default: 0, no limit)
	DescriptionMaxLen int
	// IncludeSwimlaneTable adds a swimlane view of the roadmap (phases as columns, deliverable types as rows)
	IncludeSwimlaneTable bool
	// RoadmapTableOptions configures the swimlane/roadmap table generation
	RoadmapTableOptions *RoadmapTableOptions
	// IncludeTOC adds a Table of Contents with internal links (default: true)
	IncludeTOC *bool
}

type MarketDefinition struct {
	// Alternatives are competing products, workarounds, or alternative approaches.
	Alternatives []Alternative `json:"alternatives,omitempty"`

	// Differentiation describes how this solution differs from alternatives.
	Differentiation []string `json:"differentiation,omitempty"`

	// MarketRisks are risks related to market conditions or competition.
	MarketRisks []string `json:"market_risks,omitempty"`
}

type Metadata struct {
	ID        string     `json:"id"`
	Title     string     `json:"title"`
	Version   string     `json:"version"`
	Status    Status     `json:"status"`
	CreatedAt time.Time  `json:"created_at"`
	UpdatedAt time.Time  `json:"updated_at"`
	Authors   []Person   `json:"authors"`
	Reviewers []Person   `json:"reviewers,omitempty"`
	Approvers []Approver `json:"approvers,omitempty"`
	Tags      []string   `json:"tags,omitempty"`

	// SemanticVersioning indicates the Version field follows Semantic Versioning (semver.org).
	SemanticVersioning bool `json:"semantic_versioning,omitempty"`
}

type MetricSnapshot struct {
	Name        string `json:"name"`
	Target      string `json:"target"`
	Baseline    string `json:"baseline,omitempty"`
	Measurement string `json:"measurement,omitempty"`
}

type MetricsSpec struct {
	Format             string   `json:"format"`              // Prometheus, OpenTelemetry
	CollectionInterval string   `json:"collection_interval"` // e.g., "15s"
	RetentionPeriod    string   `json:"retention_period"`
	CustomMetrics      []string `json:"custom_metrics,omitempty"`
}

type MetricsSummary struct {
	Primary    string   `json:"primary,omitempty"`
	Supporting []string `json:"supporting,omitempty"`
	Guardrails []string `json:"guardrails,omitempty"`
}

type MoSCoW string

type MultiTenancySpec struct {
	IsolationModel          IsolationModel   `json:"isolation_model"`
	DataSegregation         DataSegregation  `json:"data_segregation"`
	EncryptionModel         EncryptionModel  `json:"encryption_model,omitempty"`
	NetworkIsolation        NetworkIsolation `json:"network_isolation,omitempty"`
	NoisyNeighborProtection string           `json:"noisy_neighbor_protection,omitempty"`
}

type NFRCategory string

type NetworkIsolation string

type NonFunctionalRequirement struct {
	ID                string      `json:"id"` // e.g., NFR-001
	Category          NFRCategory `json:"category"`
	Title             string      `json:"title"`
	Description       string      `json:"description"`
	Metric            string      `json:"metric"` // What is measured
	Target            string      `json:"target"` // Target value (e.g., "P95 < 200ms")
	MeasurementMethod string      `json:"measurement_method,omitempty"`
	Priority          MoSCoW      `json:"priority"`
	PhaseID           string      `json:"phase_id"`
	CurrentBaseline   string      `json:"current_baseline,omitempty"`
	Notes             string      `json:"notes,omitempty"`

	// SLO-specific fields (for observability/reliability)
	SLO *SLOSpec `json:"slo,omitempty"`

	// Multi-tenancy specific fields
	MultiTenancy *MultiTenancySpec `json:"multi_tenancy,omitempty"`

	// Security specific fields
	Security *SecuritySpec `json:"security,omitempty"`

	Tags []string `json:"tags,omitempty"` // For filtering by topic/domain

	// AppendixRefs references appendices with additional details for this requirement.
	AppendixRefs []string `json:"appendix_refs,omitempty"`
}

type OKR struct {
	Objective  Objective   `json:"objective"`
	KeyResults []KeyResult `json:"key_results"` // Must have 1+ Key Results
}

type Objective struct {
	ID          string   `json:"id"`
	Description string   `json:"description"`
	Rationale   string   `json:"rationale,omitempty"`
	AlignedWith string   `json:"aligned_with,omitempty"` // Parent strategy/OKR
	Category    string   `json:"category,omitempty"`     // Business, Product, Team, etc.
	Owner       string   `json:"owner,omitempty"`        // Person or team responsible
	Timeframe   string   `json:"timeframe,omitempty"`    // e.g., "Q1 2026", "H1 2026", "FY2026"
	Tags        []string `json:"tags,omitempty"`         // For filtering by topic/domain
}

type Objectives struct {
	// OKRs contains Objectives and Key Results in nested OKR format.
	OKRs []OKR `json:"okrs"`
}

type ObservabilitySpec struct {
	Logging    LoggingSpec  `json:"logging"`
	Metrics    MetricsSpec  `json:"metrics"`
	Tracing    TracingSpec  `json:"tracing"`
	Alerting   AlertingSpec `json:"alerting"`
	Dashboards []string     `json:"dashboards,omitempty"`
}

type OpenItem struct {
	// ID is the unique identifier for this open item.
	ID string `json:"id"`

	// Title is a brief summary of the decision needed.
	Title string `json:"title"`

	// Description provides detailed context about what needs to be decided.
	Description string `json:"description,omitempty"`

	// Context explains the background and why this decision is needed.
	Context string `json:"context,omitempty"`

	// Options are the available choices with their tradeoffs.
	Options []Option `json:"options,omitempty"`

	// Status is the current status of this open item.
	Status OpenItemStatus `json:"status,omitempty"`

	// Priority indicates how urgent this decision is.
	Priority Priority `json:"priority,omitempty"`

	// Owner is the person or group responsible for making this decision.
	Owner string `json:"owner,omitempty"`

	// Stakeholders are people who should be consulted.
	Stakeholders []string `json:"stakeholders,omitempty"`

	// DueDate is when this decision needs to be made.
	DueDate *time.Time `json:"due_date,omitempty"`

	// CreatedAt is when this open item was created.
	CreatedAt *time.Time `json:"created_at,omitempty"`

	// Resolution documents the final decision once made.
	Resolution *OpenItemResolution `json:"resolution,omitempty"`

	// RelatedIDs links to related requirements, risks, or other items.
	RelatedIDs []string `json:"related_ids,omitempty"`

	// Tags for filtering by topic/domain.
	Tags []string `json:"tags,omitempty"`
}

type OpenItemResolution struct {
	// ChosenOptionID is the ID of the option that was selected.
	ChosenOptionID string `json:"chosen_option_id,omitempty"`

	// Decision summarizes the final decision.
	Decision string `json:"decision"`

	// Rationale explains why this decision was made.
	Rationale string `json:"rationale,omitempty"`

	// DecidedBy is who made the final decision.
	DecidedBy string `json:"decided_by,omitempty"`

	// DecidedAt is when the decision was made.
	DecidedAt *time.Time `json:"decided_at,omitempty"`

	// Notes captures any additional context.
	Notes string `json:"notes,omitempty"`
}

type OpenItemStatus string

type Option struct {
	// ID is the unique identifier for this option.
	ID string `json:"id"`

	// Title is a brief name for this option.
	Title string `json:"title"`

	// Description explains this option in detail.
	Description string `json:"description,omitempty"`

	// Pros lists the benefits and advantages of this option.
	Pros []string `json:"pros,omitempty"`

	// Cons lists the drawbacks and disadvantages of this option.
	Cons []string `json:"cons,omitempty"`

	// Effort estimates the implementation effort.
	Effort EffortLevel `json:"effort,omitempty"`

	// Risk estimates the risk level of this option.
	Risk RiskLevel `json:"risk,omitempty"`

	// Cost provides cost estimate or impact.
	Cost string `json:"cost,omitempty"`

	// Timeline provides time estimate or impact.
	Timeline string `json:"timeline,omitempty"`

	// Recommended indicates if this is the recommended option.
	Recommended bool `json:"recommended,omitempty"`

	// RecommendationRationale explains why this option is recommended (if applicable).
	RecommendationRationale string `json:"recommendation_rationale,omitempty"`
}

type PMView struct {
	Title          string           `json:"title"`
	Status         string           `json:"status"`
	Owner          string           `json:"owner"`
	Version        string           `json:"version"`
	ProblemSummary string           `json:"problem_summary"`
	Personas       []PersonaSummary `json:"personas"`
	Goals          []string         `json:"goals"`
	NonGoals       []string         `json:"non_goals"`
	Solution       SolutionSummary  `json:"solution"`
	Requirements   RequirementsList `json:"requirements"`
	Metrics        MetricsSummary   `json:"metrics"`
	Risks          []RiskSummary    `json:"risks"`
	OpenQuestions  []string         `json:"open_questions,omitempty"`
}

type PRFAQView struct {
	// Metadata
	Title   string `json:"title"`
	Version string `json:"version"`
	Author  string `json:"author"`
	Date    string `json:"date"`
	PRDID   string `json:"prd_id"`

	// The two main sections
	PressRelease PressReleaseSection `json:"press_release"`
	FAQ          FAQSection          `json:"faq"`
}

type Person = common.Person

type Persona struct {
	ID                   string               `json:"id"`
	Name                 string               `json:"name"`                // e.g., "Developer Dan"
	Role                 string               `json:"role"`                // Job title
	Description          string               `json:"description"`         // Background and context
	Goals                []string             `json:"goals"`               // What they want to achieve
	PainPoints           []string             `json:"pain_points"`         // Current frustrations
	Behaviors            []string             `json:"behaviors,omitempty"` // Typical patterns
	TechnicalProficiency TechnicalProficiency `json:"technical_proficiency,omitempty"`
	Demographics         *Demographics        `json:"demographics,omitempty"`
	Motivations          []string             `json:"motivations,omitempty"`
	Frustrations         []string             `json:"frustrations,omitempty"`
	PreferredChannels    []string             `json:"preferred_channels,omitempty"` // How they prefer to interact
	Quote                string               `json:"quote,omitempty"`              // Representative quote
	ImageURL             string               `json:"image_url,omitempty"`
	IsPrimary            bool                 `json:"is_primary,omitempty"`  // Is this the primary persona?
	LibraryRef           string               `json:"library_ref,omitempty"` // Reference to persona in library (for tracking origin)
	Tags                 []string             `json:"tags,omitempty"`        // For filtering by topic/domain
}

type PersonaLibrary struct {
	SchemaVersion string           `json:"schema_version"`
	Personas      []LibraryPersona `json:"personas"`
	Metadata      LibraryMetadata  `json:"metadata,omitempty"`
}

type PersonaSnapshot struct {
	Name       string   `json:"name"`
	Role       string   `json:"role"`
	PainPoints []string `json:"pain_points"`
}

type PersonaSummary struct {
	Name       string   `json:"name"`
	Role       string   `json:"role"`
	PainPoints []string `json:"pain_points"`
	IsPrimary  bool     `json:"is_primary"`
}

type Phase struct {
	ID              string        `json:"id"`   // e.g., "phase-1", "q1-2026"
	Name            string        `json:"name"` // e.g., "MVP", "Q1 2026"
	Type            PhaseType     `json:"type"`
	StartDate       *time.Time    `json:"start_date,omitempty"`
	EndDate         *time.Time    `json:"end_date,omitempty"`
	Goals           []string      `json:"goals"`
	Deliverables    []Deliverable `json:"deliverables"`
	SuccessCriteria []string      `json:"success_criteria"`
	Dependencies    []string      `json:"dependencies,omitempty"` // Dependent phase IDs
	Risks           []Risk        `json:"risks,omitempty"`
	Status          PhaseStatus   `json:"status,omitempty"`
	Progress        *int          `json:"progress,omitempty"` // 0-100 percentage
	Tags            []string      `json:"tags,omitempty"`     // For filtering by topic/domain
	Notes           string        `json:"notes,omitempty"`
}

type PhaseSnapshot struct {
	Name         string   `json:"name"`
	Description  string   `json:"description"`
	Deliverables []string `json:"deliverables"`
	Status       string   `json:"status,omitempty"`
}

type PhaseStatus string

type PhaseTarget struct {
	PhaseID string `json:"phase_id"`         // Reference to roadmap phase
	Target  string `json:"target"`           // Target value for this phase
	Status  string `json:"status,omitempty"` // not_started, in_progress, achieved, missed
	Actual  string `json:"actual,omitempty"` // Actual value achieved
	Notes   string `json:"notes,omitempty"`  // Commentary on progress
}

type PhaseType string

type PressReleaseSection struct {
	Headline      string   `json:"headline"`
	Subheadline   string   `json:"subheadline"`
	Summary       string   `json:"summary"`
	ProblemSolved string   `json:"problem_solved"`
	Solution      string   `json:"solution"`
	Quote         Quote    `json:"quote,omitempty"`
	CustomerQuote Quote    `json:"customer_quote,omitempty"`
	CallToAction  string   `json:"call_to_action"`
	Benefits      []string `json:"benefits"`
}

type Priority string

type ProblemDefinition struct {
	// ID is the unique identifier for this problem.
	ID string `json:"id,omitempty"`

	// Statement is the problem statement.
	Statement string `json:"statement"`

	// UserImpact describes how users are affected by this problem.
	UserImpact string `json:"user_impact,omitempty"`

	// Evidence supports the existence and severity of the problem.
	Evidence []Evidence `json:"evidence,omitempty"`

	// Confidence is the confidence level in the problem definition (0.0-1.0).
	Confidence float64 `json:"confidence,omitempty"`

	// RootCauses are the underlying causes of the problem.
	RootCauses []string `json:"root_causes,omitempty"`

	// AffectedSegments are user segments affected by this problem.
	AffectedSegments []string `json:"affected_segments,omitempty"`

	// SecondaryProblems are related or secondary problems.
	SecondaryProblems []ProblemDefinition `json:"secondary_problems,omitempty"`
}

type QualityScores struct {
	ProblemDefinition    float64 `json:"problem_definition"`
	UserUnderstanding    float64 `json:"user_understanding"`
	MarketAwareness      float64 `json:"market_awareness"`
	SolutionFit          float64 `json:"solution_fit"`
	ScopeDiscipline      float64 `json:"scope_discipline"`
	RequirementsQuality  float64 `json:"requirements_quality"`
	UXCoverage           float64 `json:"ux_coverage"`
	TechnicalFeasibility float64 `json:"technical_feasibility"`
	MetricsQuality       float64 `json:"metrics_quality"`
	RiskManagement       float64 `json:"risk_management"`
	OverallScore         float64 `json:"overall_score"`
}

type Quote struct {
	Speaker string `json:"speaker"`
	Role    string `json:"role,omitempty"`
	Text    string `json:"text"`
}

type RecommendPriority string

type Recommendation struct {
	Section  string            `json:"section"`
	Priority RecommendPriority `json:"priority"` // critical, high, medium, low
	Message  string            `json:"message"`
	Guidance string            `json:"guidance,omitempty"`
}

type ReliabilitySpec struct {
	TargetUptime         string `json:"target_uptime"`  // e.g., "99.9%"
	MTBF                 string `json:"mtbf,omitempty"` // Mean Time Between Failures
	MTTR                 string `json:"mttr,omitempty"` // Mean Time To Recovery
	RTO                  string `json:"rto,omitempty"`  // Recovery Time Objective
	RPO                  string `json:"rpo,omitempty"`  // Recovery Point Objective
	FailoverStrategy     string `json:"failover_strategy,omitempty"`
	BackupFrequency      string `json:"backup_frequency,omitempty"`
	DisasterRecoveryPlan bool   `json:"disaster_recovery_plan,omitempty"`
}

type Requirements struct {
	Functional    []FunctionalRequirement    `json:"functional"`
	NonFunctional []NonFunctionalRequirement `json:"non_functional"`
}

type RequirementsList struct {
	Must   []string `json:"must"`
	Should []string `json:"should"`
	Could  []string `json:"could"`
}

type ReviewDecision string

type ReviewsDefinition struct {
	// ReviewBoardSummary is a summary from the review board.
	ReviewBoardSummary string `json:"review_board_summary,omitempty"`

	// QualityScores contains scores across quality dimensions.
	QualityScores *QualityScores `json:"quality_scores,omitempty"`

	// Decision is the review decision.
	Decision ReviewDecision `json:"decision,omitempty"`

	// Blockers are issues that block approval.
	Blockers []Blocker `json:"blockers,omitempty"`

	// RevisionTriggers are issues requiring revision.
	RevisionTriggers []RevisionTrigger `json:"revision_triggers,omitempty"`
}

type RevisionRecord struct {
	// Version is the version number after this revision.
	Version string `json:"version"`

	// Changes lists what changed in this revision.
	Changes []string `json:"changes"`

	// Trigger indicates what triggered this revision.
	Trigger RevisionTriggerType `json:"trigger"`

	// Date is when this revision was made.
	Date time.Time `json:"date"`

	// Author is who made this revision.
	Author string `json:"author,omitempty"`
}

type RevisionTrigger struct {
	// IssueID is the unique identifier for this issue.
	IssueID string `json:"issue_id"`

	// Category is the scoring category related to this issue.
	Category string `json:"category"`

	// Severity indicates how severe the issue is (blocker, major, minor).
	Severity string `json:"severity"`

	// Description describes the issue.
	Description string `json:"description"`

	// RecommendedOwner suggests who should address this issue.
	RecommendedOwner string `json:"recommended_owner,omitempty"`
}

type RevisionTriggerType string

type Risk struct {
	ID          string          `json:"id"`
	Description string          `json:"description"`
	Probability RiskProbability `json:"probability"`
	Impact      RiskImpact      `json:"impact"`
	Mitigation  string          `json:"mitigation"`
	Owner       string          `json:"owner,omitempty"`
	Status      RiskStatus      `json:"status,omitempty"`
	DueDate     string          `json:"due_date,omitempty"`
	Tags        []string        `json:"tags,omitempty"` // For filtering by topic/domain
	Notes       string          `json:"notes,omitempty"`

	// AppendixRefs references appendices with additional details for this risk.
	AppendixRefs []string `json:"appendix_refs,omitempty"`
}

type RiskImpact string

type RiskLevel string

type RiskProbability string

type RiskSnapshot struct {
	Description string `json:"description"`
	Impact      string `json:"impact"`
	Mitigation  string `json:"mitigation"`
}

type RiskStatus string

type RiskSummary struct {
	Description string `json:"description"`
	Impact      string `json:"impact"`
	Mitigation  string `json:"mitigation"`
}

type Roadmap struct {
	Phases []Phase `json:"phases"`
}

type RoadmapTableOptions struct {
	// IncludeStatus adds status indicators to deliverables
	IncludeStatus bool
	// IncludeEmptySwimlanes shows rows even if no deliverables of that type exist
	IncludeEmptySwimlanes bool
	// SwimlaneOrder specifies the order of swimlanes (nil = alphabetical)
	SwimlaneOrder []DeliverableType
	// MaxTitleLen truncates deliverable titles (0 = no limit)
	MaxTitleLen int
	// IncludeOKRs adds Objectives and Key Results swimlanes derived from PhaseTargets
	IncludeOKRs bool
}

type SLOSpec struct {
	SLI            string `json:"sli"`        // Service Level Indicator
	SLOTarget      string `json:"slo_target"` // e.g., "99.9%"
	Window         string `json:"window"`     // e.g., "30 days rolling"
	ErrorBudget    string `json:"error_budget,omitempty"`
	Consequences   string `json:"consequences,omitempty"` // What happens on breach
	AlertThreshold string `json:"alert_threshold,omitempty"`
}

type ScopeSnapshot struct {
	InScope    []string `json:"in_scope"`
	OutOfScope []string `json:"out_of_scope"`
}

type ScoringResult struct {
	CategoryScores   []CategoryScore   `json:"category_scores"`
	WeightedScore    float64           `json:"weighted_score"`
	Decision         string            `json:"decision"`
	Blockers         []string          `json:"blockers"`
	RevisionTriggers []RevisionTrigger `json:"revision_triggers"`
	Summary          string            `json:"summary"`
}

type SectionScore struct {
	Name        string   `json:"name"`
	Score       float64  `json:"score"`      // 0-100
	MaxPoints   float64  `json:"max_points"` // Weight in overall score
	Required    bool     `json:"required"`
	Status      string   `json:"status"` // complete, partial, missing
	Issues      []string `json:"issues,omitempty"`
	Suggestions []string `json:"suggestions,omitempty"`
}

type SecurityModel struct {
	// Overview provides a high-level summary of the security approach.
	Overview string `json:"overview"`

	// ThreatModel identifies assets, threat actors, and threats.
	ThreatModel ThreatModel `json:"threat_model"`

	// AccessControl defines access control strategy.
	AccessControl AccessControl `json:"access_control"`

	// Encryption specifies encryption requirements.
	Encryption EncryptionRequirements `json:"encryption"`

	// AuditLogging defines audit logging requirements.
	AuditLogging AuditLogging `json:"audit_logging"`

	// ComplianceControls maps to compliance frameworks.
	// Key is framework name (e.g., "SOC2", "GDPR"), value is list of controls.
	ComplianceControls map[string][]string `json:"compliance_controls,omitempty"`

	// DataClassification defines data sensitivity levels.
	DataClassification []DataClassification `json:"data_classification,omitempty"`

	// AppendixRefs references appendices with additional security details.
	AppendixRefs []string `json:"appendix_refs,omitempty"`
}

type SecurityRole struct {
	// ID is the unique identifier for this role.
	ID string `json:"id,omitempty"`

	// Role name.
	Role string `json:"role"`

	// Description of the role.
	Description string `json:"description,omitempty"`

	// Permissions granted to this role.
	Permissions []string `json:"permissions"`

	// Scope defines where this role applies.
	Scope string `json:"scope,omitempty"`
}

type SecuritySpec struct {
	AuthenticationMethods  []string `json:"authentication_methods,omitempty"` // OAuth2, SAML, MFA
	AuthorizationModel     string   `json:"authorization_model,omitempty"`    // RBAC, ABAC
	EncryptionAtRest       bool     `json:"encryption_at_rest,omitempty"`
	EncryptionInTransit    bool     `json:"encryption_in_transit,omitempty"`
	ComplianceStandards    []string `json:"compliance_standards,omitempty"` // SOC2, GDPR, HIPAA
	VulnerabilityScanning  bool     `json:"vulnerability_scanning,omitempty"`
	PenetrationTesting     bool     `json:"penetration_testing,omitempty"`
	SecurityAuditFrequency string   `json:"security_audit_frequency,omitempty"`
}

type SecurityThreat struct {
	// ID is the unique identifier for this threat.
	ID string `json:"id,omitempty"`

	// Threat description.
	Threat string `json:"threat"`

	// Category is the threat category (e.g., "STRIDE" categories).
	Category string `json:"category,omitempty"`

	// Mitigation strategy.
	Mitigation string `json:"mitigation"`

	// Severity level (critical, high, medium, low).
	Severity string `json:"severity,omitempty"`

	// Status of mitigation (planned, implemented, verified).
	Status string `json:"status,omitempty"`

	// RelatedIDs links to related requirements or risks.
	RelatedIDs []string `json:"related_ids,omitempty"`
}

type SixPagerView struct {
	// Metadata
	Title   string `json:"title"`
	Version string `json:"version"`
	Author  string `json:"author"`
	Date    string `json:"date"`
	PRDID   string `json:"prd_id"`

	// The six sections
	PressRelease    PressReleaseSection    `json:"press_release"`
	FAQ             FAQSection             `json:"faq"`
	CustomerProblem CustomerProblemSection `json:"customer_problem"`
	Solution        SolutionSection        `json:"solution"`
	SuccessMetrics  SuccessMetricsSection  `json:"success_metrics"`
	Timeline        TimelineSection        `json:"timeline"`
}

type SolutionDefinition struct {
	// SolutionOptions are the possible solutions considered.
	SolutionOptions []SolutionOption `json:"solution_options,omitempty"`

	// SelectedSolutionID is the ID of the chosen solution.
	SelectedSolutionID string `json:"selected_solution_id,omitempty"`

	// SolutionRationale explains why the selected solution was chosen.
	SolutionRationale string `json:"solution_rationale,omitempty"`

	// Confidence is the confidence level in the solution (0.0-1.0).
	Confidence float64 `json:"confidence,omitempty"`
}

type SolutionOption struct {
	// ID is the unique identifier for this solution option.
	ID string `json:"id"`

	// Name is the name of this solution option.
	Name string `json:"name"`

	// Description provides details about the solution.
	Description string `json:"description,omitempty"`

	// ProblemsAddressed lists problem IDs this solution addresses.
	ProblemsAddressed []string `json:"problems_addressed,omitempty"`

	// Benefits are advantages of this solution.
	Benefits []string `json:"benefits,omitempty"`

	// Tradeoffs are compromises or downsides of this solution.
	Tradeoffs []string `json:"tradeoffs,omitempty"`

	// Risks are potential risks of this solution.
	Risks []string `json:"risks,omitempty"`

	// EstimatedEffort is a high-level effort estimate.
	EstimatedEffort string `json:"estimated_effort,omitempty"`
}

type SolutionSection struct {
	Overview        string            `json:"overview"`
	HowItWorks      string            `json:"how_it_works"`
	KeyFeatures     []FeatureSnapshot `json:"key_features"`
	Differentiators []string          `json:"differentiators"`
	Scope           ScopeSnapshot     `json:"scope"`
}

type SolutionSummary struct {
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Rationale   string   `json:"rationale"`
	Tradeoffs   []string `json:"tradeoffs"`
}

type Status string

type SuccessMetricsSection struct {
	PrimaryMetric    MetricSnapshot   `json:"primary_metric"`
	SecondaryMetrics []MetricSnapshot `json:"secondary_metrics"`
	Guardrails       []MetricSnapshot `json:"guardrails,omitempty"`
	BusinessGoals    []string         `json:"business_goals"`
}

type TechnicalArchitecture struct {
	Overview          string          `json:"overview"`
	SystemDiagram     string          `json:"system_diagram,omitempty"` // URL or path to diagram
	DataModel         string          `json:"data_model,omitempty"`     // URL or path to ERD
	IntegrationPoints []Integration   `json:"integration_points,omitempty"`
	TechnologyStack   TechnologyStack `json:"technology_stack,omitempty"`
	SecurityDesign    string          `json:"security_design,omitempty"`
	ScalabilityDesign string          `json:"scalability_design,omitempty"`
}

type TechnicalProficiency string

type Technology struct {
	Name         string   `json:"name"`
	Version      string   `json:"version,omitempty"`
	Purpose      string   `json:"purpose,omitempty"`
	Rationale    string   `json:"rationale,omitempty"`
	Alternatives []string `json:"alternatives,omitempty"` // Considered alternatives
}

type TechnologyStack struct {
	Frontend       []Technology `json:"frontend,omitempty"`
	Backend        []Technology `json:"backend,omitempty"`
	Database       []Technology `json:"database,omitempty"`
	Infrastructure []Technology `json:"infrastructure,omitempty"`
	DevOps         []Technology `json:"devops,omitempty"`
	Monitoring     []Technology `json:"monitoring,omitempty"`
}

type ThreatModel struct {
	// Assets are the valuable resources to protect.
	Assets []string `json:"assets"`

	// ThreatActors are potential attackers.
	ThreatActors []string `json:"threat_actors"`

	// KeyThreats lists major threats with mitigations.
	KeyThreats []SecurityThreat `json:"key_threats"`

	// TrustBoundaries identifies trust boundaries in the system.
	TrustBoundaries []string `json:"trust_boundaries,omitempty"`
}

type TimelineSection struct {
	Phases       []PhaseSnapshot `json:"phases"`
	Dependencies []string        `json:"dependencies"`
	Risks        []RiskSnapshot  `json:"risks"`
	TeamNeeds    string          `json:"team_needs,omitempty"`
}

type TracingSpec struct {
	Enabled           bool   `json:"enabled"`
	SamplingRate      string `json:"sampling_rate"`      // e.g., "100%", "10%"
	PropagationFormat string `json:"propagation_format"` // W3C, B3
	ExportFormat      string `json:"export_format"`      // OTLP, Jaeger, Zipkin
}

type UXRequirements struct {
	DesignPrinciples []string          `json:"design_principles,omitempty"`
	Wireframes       []Wireframe       `json:"wireframes,omitempty"`
	InteractionFlows []InteractionFlow `json:"interaction_flows,omitempty"`
	Accessibility    AccessibilitySpec `json:"accessibility,omitempty"`
	BrandGuidelines  string            `json:"brand_guidelines,omitempty"` // URL or path
	DesignSystem     string            `json:"design_system,omitempty"`    // URL or path
}

type UserStory struct {
	ID                 string                `json:"id"`
	PersonaID          string                `json:"persona_id"` // Reference to persona
	Title              string                `json:"title"`
	AsA                string                `json:"as_a"`    // Persona role (e.g., "developer", "admin")
	IWant              string                `json:"i_want"`  // Desired action/feature
	SoThat             string                `json:"so_that"` // Benefit/reason
	AcceptanceCriteria []AcceptanceCriterion `json:"acceptance_criteria"`
	Priority           Priority              `json:"priority"`
	PhaseID            string                `json:"phase_id"` // Reference to roadmap phase
	StoryPoints        *int                  `json:"story_points,omitempty"`
	Dependencies       []string              `json:"dependencies,omitempty"` // Dependent story IDs
	Epic               string                `json:"epic,omitempty"`         // Parent epic
	Tags               []string              `json:"tags,omitempty"`         // For filtering by topic/domain
	Notes              string                `json:"notes,omitempty"`
}

type ValidationError struct {
	Field   string `json:"field"`
	Message string `json:"message"`
}

type ValidationResult struct {
	Valid    bool                `json:"valid"`
	Errors   []ValidationError   `json:"errors,omitempty"`
	Warnings []ValidationWarning `json:"warnings,omitempty"`
}

type ValidationWarning struct {
	Field   string `json:"field"`
	Message string `json:"message"`
}

type Wireframe struct {
	ID          string `json:"id"`
	Title       string `json:"title"`
	Description string `json:"description,omitempty"`
	URL         string `json:"url"`              // Link to wireframe
	Status      string `json:"status,omitempty"` // Draft, Approved
}