prd

type APIEndpoint struct {
	ID          string   `json:"id,omitempty"`
	Method      string   `json:"method"`
	Path        string   `json:"path"`
	Description string   `json:"description,omitempty"`
	RequestBody string   `json:"requestBody,omitempty"`
	Response    string   `json:"response,omitempty"`
	Auth        string   `json:"auth,omitempty"`
	Tags        []string `json:"tags,omitempty"`
}

type APISpec struct {
	ID           string        `json:"id,omitempty"`
	ServiceID    string        `json:"serviceId,omitempty"`
	Name         string        `json:"name"`
	Protocol     Protocol      `json:"protocol"`
	BasePath     string        `json:"basePath,omitempty"`
	Version      string        `json:"version,omitempty"`
	Description  string        `json:"description,omitempty"`
	Endpoints    []APIEndpoint `json:"endpoints,omitempty"`
	OpenAPISpec  string        `json:"openApiSpec,omitempty"`
	ProtobufSpec string        `json:"protobufSpec,omitempty"`
}

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:"testingApproach,omitempty"`
}

type AlertingSpec struct {
	Channels          []string `json:"channels"` // PagerDuty, Slack, Email
	EscalationPolicy  string   `json:"escalationPolicy,omitempty"`
	OnCallIntegration bool     `json:"onCallIntegration,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:"whyNotChosen,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:"contentString,omitempty"`

	// ContentTable is structured table data.
	// Rendered after ContentString if both are set.
	ContentTable *AppendixTable `json:"contentTable,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:"referencedBy,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 = common.Assumption

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:"currentValue"`

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

	// MeasurementMethod describes how this is measured.
	MeasurementMethod string `json:"measurementMethod,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:"maxScore"`
	Justification  string  `json:"justification"`
	Evidence       string  `json:"evidence"`
	BelowThreshold bool    `json:"belowThreshold"`
}

type CategoryWeight struct {
	Category string
	Weight   float64
}

type CompletenessReport struct {
	OverallScore     float64          `json:"overallScore"`     // 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:"requiredComplete"` // Count of complete required sections
	RequiredTotal    int              `json:"requiredTotal"`    // Total required sections
	OptionalComplete int              `json:"optionalComplete"` // Count of complete optional sections
	OptionalTotal    int              `json:"optionalTotal"`    // Total optional sections
}

type Constraint = common.Constraint

type ConstraintType = common.ConstraintType

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:"affectedUsers,omitempty"`

	// RelatedIDs links to related requirements or risks.
	RelatedIDs []string `json:"relatedIds,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:"targetState"`

	// 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 = common.CustomSection

type CustomerProblemSection struct {
	Statement           string                `json:"statement"`
	Impact              string                `json:"impact"`
	Personas            []PersonaSnapshot     `json:"personas"`
	CurrentAlternatives []AlternativeSnapshot `json:"currentAlternatives"`
	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 = common.DecisionRecord

type DecisionStatus = common.DecisionStatus

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

type Deliverable = roadmap.Deliverable

type DeliverableStatus = roadmap.DeliverableStatus

type DeliverableType = roadmap.DeliverableType

type Demographics struct {
	AgeRange    string `json:"ageRange,omitempty"`
	Location    string `json:"location,omitempty"`
	Industry    string `json:"industry,omitempty"`
	CompanySize string `json:"companySize,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:"dueDate,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:"executiveSummary"`
	Objectives       Objectives       `json:"objectives"`
	Personas         []Persona        `json:"personas"`
	UserStories      []UserStory      `json:"userStories"`
	Requirements     Requirements     `json:"requirements"`
	Roadmap          Roadmap          `json:"roadmap"`

	// ProductGoals contains the product goals using the framework-agnostic Goals wrapper.
	// This supports either OKR or V2MOM frameworks. When set, this takes precedence
	// over the legacy Objectives field for roadmap rendering and other goal-related features.
	ProductGoals *Goals `json:"productGoals,omitempty"`

	// Optional sections
	Assumptions      *AssumptionsConstraints `json:"assumptions,omitempty"`
	InScope          []string                `json:"inScope,omitempty"`
	OutOfScope       []string                `json:"outOfScope,omitempty"`
	TechArchitecture *TechnicalArchitecture  `json:"technicalArchitecture,omitempty"`

	// RelatedDocuments lists related requirements documents.
	RelatedDocuments []RelatedDocument `json:"relatedDocuments,omitempty"`
	UXRequirements   *UXRequirements   `json:"uxRequirements,omitempty"`
	Risks            []Risk            `json:"risks,omitempty"`
	Glossary         []GlossaryTerm    `json:"glossary,omitempty"`

	// Custom sections for project-specific needs
	CustomSections []CustomSection `json:"customSections,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:"openItems,omitempty"`

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

	// RevisionHistory tracks changes to the PRD over time.
	RevisionHistory []RevisionRecord `json:"revisionHistory,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:"currentState,omitempty"`

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

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

	// NonGoals contains structured non-goals with rationale.
	// More structured than OutOfScope for explicit exclusions.
	NonGoals []NonGoal `json:"nonGoals,omitempty"`

	// SuccessMetrics contains structured success metrics organized by type.
	SuccessMetrics *SuccessMetrics `json:"successMetrics,omitempty"`
}

type DocumentType string

type EffortLevel = common.EffortLevel

type EncryptionModel string

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

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

	// FieldLevel describes field-level encryption if applicable.
	FieldLevel *EncryptionSpec `json:"fieldLevel,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:"keyManagement"`

	// 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:"sampleSize,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:"prdId"`
	Title           string  `json:"title"`
	OverallDecision string  `json:"overallDecision"`
	ConfidenceLevel string  `json:"confidenceLevel"`
	OverallScore    float64 `json:"overallScore"`
}

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:"requiredActions"`
	TopRisks              []ExecRisk   `json:"topRisks"`
	RecommendationSummary string       `json:"recommendationSummary"`
}

type ExecutiveSummary struct {
	ProblemStatement string   `json:"problemStatement"`
	ProposedSolution string   `json:"proposedSolution"`
	ExpectedOutcomes []string `json:"expectedOutcomes"`
	TargetAudience   string   `json:"targetAudience,omitempty"`
	ValueProposition string   `json:"valueProposition,omitempty"`
}

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

type FAQSection struct {
	CustomerFAQs  []FAQ `json:"customerFaqs"`
	InternalFAQs  []FAQ `json:"internalFaqs"`
	TechnicalFAQs []FAQ `json:"technicalFaqs,omitempty"`
}

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

type Framework = goals.Framework

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:"userStoryIds"` // Related user stories
	AcceptanceCriteria []AcceptanceCriterion `json:"acceptanceCriteria"`
	PhaseID            string                `json:"phaseId"` // 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:"appendixRefs,omitempty"`
}

type GitOpsConfig struct {
	Enabled        bool            `json:"enabled"`
	Provider       string          `json:"provider,omitempty"`
	Workflow       string          `json:"workflow,omitempty"`
	SourcesOfTruth []SourceOfTruth `json:"sourcesOfTruth,omitempty"`
}

type GlossaryTerm = common.GlossaryTerm

type GoalItem = goals.GoalItem

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 Goals = goals.Goals

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:"okrRef,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:"alignedObjectives,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:"authMethod,omitempty"`
	DataFormat    string `json:"dataFormat,omitempty"` // JSON, XML, Protobuf
	RateLimit     string `json:"rateLimit,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:"diagramUrl,omitempty"`
}

type IsolationModel string

type KeyResult = okr.KeyResult

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

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

type LoggingSpec struct {
	Format                string   `json:"format"`          // JSON, structured
	RetentionPeriod       string   `json:"retentionPeriod"` // e.g., "90 days"
	LogLevels             []string `json:"logLevels"`
	CorrelationID         bool     `json:"correlationId"` // Include trace/correlation IDs
	SensitiveDataHandling string   `json:"sensitiveDataHandling,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
	// UseTextIcons uses ASCII text instead of emoji for status icons.
	// Enable this for Pandoc/LaTeX PDF generation compatibility.
	// This sets RoadmapTableOptions.UseTextIcons and affects open items rendering.
	UseTextIcons 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:"marketRisks,omitempty"`
}

type Metadata struct {
	ID        string     `json:"id"`
	Title     string     `json:"title"`
	Version   string     `json:"version"`
	Status    Status     `json:"status"`
	CreatedAt time.Time  `json:"createdAt"`
	UpdatedAt time.Time  `json:"updatedAt"`
	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:"semanticVersioning,omitempty"`

	// PRDType determines the section ordering template for markdown generation.
	// Options: "", "strategy", "feature", "technical"
	// If empty, uses default order for backward compatibility.
	PRDType PRDType `json:"prdType,omitempty"`

	// SectionOrder specifies a custom section order for markdown generation.
	// If provided, overrides the template order from PRDType.
	// Sections not listed are appended in template order.
	// Use section IDs like "executiveSummary", "problem", "market", etc.
	SectionOrder []string `json:"sectionOrder,omitempty"`
}

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

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

	// Description provides details about what this metric measures.
	Description string `json:"description,omitempty"`

	// Baseline is the current or starting value of this metric.
	Baseline string `json:"baseline,omitempty"`

	// Target is the goal value for this metric.
	Target string `json:"target"`

	// MeasurementMethod describes how this metric is measured.
	MeasurementMethod string `json:"measurementMethod,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:"collectionInterval"` // e.g., "15s"
	RetentionPeriod    string   `json:"retentionPeriod"`
	CustomMetrics      []string `json:"customMetrics,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:"isolationModel"`
	DataSegregation         DataSegregation  `json:"dataSegregation"`
	EncryptionModel         EncryptionModel  `json:"encryptionModel,omitempty"`
	NetworkIsolation        NetworkIsolation `json:"networkIsolation,omitempty"`
	NoisyNeighborProtection string           `json:"noisyNeighborProtection,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:"measurementMethod,omitempty"`
	Priority          MoSCoW      `json:"priority"`
	PhaseID           string      `json:"phaseId"`
	CurrentBaseline   string      `json:"currentBaseline,omitempty"`
	Notes             string      `json:"notes,omitempty"`

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

	// Multi-tenancy specific fields
	MultiTenancy *MultiTenancySpec `json:"multiTenancy,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:"appendixRefs,omitempty"`
}

type NonGoal = common.NonGoal

type OKR = okr.OKR

type Objective = okr.Objective

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 = common.OpenItem

type OpenItemResolution = common.OpenItemResolution

type OpenItemStatus = common.OpenItemStatus

type Option = common.Option

type OrchestrationConfig struct {
	ShortLived  *OrchestrationEngine `json:"shortLived,omitempty"`
	LongRunning *OrchestrationEngine `json:"longRunning,omitempty"`
	Description string               `json:"description,omitempty"`
}

type OrchestrationEngine struct {
	Name      string   `json:"name"`
	UseCases  []string `json:"useCases,omitempty"`
	Language  string   `json:"language,omitempty"`
	Rationale string   `json:"rationale,omitempty"`
}

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

type PRDType string

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

	// The two main sections
	PressRelease PressReleaseSection `json:"pressRelease"`
	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:"painPoints"`          // Current frustrations
	Behaviors            []string             `json:"behaviors,omitempty"` // Typical patterns
	TechnicalProficiency TechnicalProficiency `json:"technicalProficiency,omitempty"`
	Demographics         *Demographics        `json:"demographics,omitempty"`
	Motivations          []string             `json:"motivations,omitempty"`
	Frustrations         []string             `json:"frustrations,omitempty"`
	PreferredChannels    []string             `json:"preferredChannels,omitempty"` // How they prefer to interact
	Quote                string               `json:"quote,omitempty"`             // Representative quote
	ImageURL             string               `json:"imageUrl,omitempty"`
	IsPrimary            bool                 `json:"isPrimary,omitempty"`  // Is this the primary persona?
	LibraryRef           string               `json:"libraryRef,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:"schemaVersion"`
	Personas      []LibraryPersona `json:"personas"`
	Metadata      LibraryMetadata  `json:"metadata,omitempty"`
}

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

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

type Phase = roadmap.Phase

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

type PhaseStatus = roadmap.PhaseStatus

type PhaseTarget = okr.PhaseTarget

type PhaseType = roadmap.PhaseType

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

type Priority = common.Priority

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:"userImpact,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:"rootCauses,omitempty"`

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

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

type Protocol string

type QualityScores struct {
	ProblemDefinition    float64 `json:"problemDefinition"`
	UserUnderstanding    float64 `json:"userUnderstanding"`
	MarketAwareness      float64 `json:"marketAwareness"`
	SolutionFit          float64 `json:"solutionFit"`
	ScopeDiscipline      float64 `json:"scopeDiscipline"`
	RequirementsQuality  float64 `json:"requirementsQuality"`
	UXCoverage           float64 `json:"uxCoverage"`
	TechnicalFeasibility float64 `json:"technicalFeasibility"`
	MetricsQuality       float64 `json:"metricsQuality"`
	RiskManagement       float64 `json:"riskManagement"`
	OverallScore         float64 `json:"overallScore"`
}

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 RelatedDocument struct {
	ID           string           `json:"id"`
	Title        string           `json:"title"`
	Type         DocumentType     `json:"type"`
	Relationship RelationshipType `json:"relationship"`
	Path         string           `json:"path,omitempty"`
	URL          string           `json:"url,omitempty"`
	Description  string           `json:"description,omitempty"`
}

type RelationshipType string

type ReliabilitySpec struct {
	TargetUptime         string `json:"targetUptime"`   // 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:"failoverStrategy,omitempty"`
	BackupFrequency      string `json:"backupFrequency,omitempty"`
	DisasterRecoveryPlan bool   `json:"disasterRecoveryPlan,omitempty"`
}

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

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

type ResultItem = goals.ResultItem

type ReviewDecision string

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

	// QualityScores contains scores across quality dimensions.
	QualityScores *QualityScores `json:"qualityScores,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:"revisionTriggers,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:"issueId"`

	// 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:"recommendedOwner,omitempty"`
}

type RevisionTriggerType string

type Risk = common.Risk

type RiskImpact = common.RiskImpact

type RiskLevel = common.RiskLevel

type RiskProbability = common.RiskProbability

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

type RiskStatus = common.RiskStatus

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

type Roadmap = roadmap.Roadmap

type RoadmapTableOptions = roadmap.TableOptions

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

type ScopeSnapshot struct {
	InScope    []string `json:"inScope"`
	OutOfScope []string `json:"outOfScope"`
}

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

type SectionID string

type SectionScore struct {
	Name        string   `json:"name"`
	Score       float64  `json:"score"`     // 0-100
	MaxPoints   float64  `json:"maxPoints"` // 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:"threatModel"`

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

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

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

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

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

	// AppendixRefs references appendices with additional security details.
	AppendixRefs []string `json:"appendixRefs,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:"authenticationMethods,omitempty"` // OAuth2, SAML, MFA
	AuthorizationModel     string   `json:"authorizationModel,omitempty"`    // RBAC, ABAC
	EncryptionAtRest       bool     `json:"encryptionAtRest,omitempty"`
	EncryptionInTransit    bool     `json:"encryptionInTransit,omitempty"`
	ComplianceStandards    []string `json:"complianceStandards,omitempty"` // SOC2, GDPR, HIPAA
	VulnerabilityScanning  bool     `json:"vulnerabilityScanning,omitempty"`
	PenetrationTesting     bool     `json:"penetrationTesting,omitempty"`
	SecurityAuditFrequency string   `json:"securityAuditFrequency,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:"relatedIds,omitempty"`
}

type Service struct {
	ID                string       `json:"id"`
	Name              string       `json:"name"`
	Description       string       `json:"description"`
	Responsibilities  []string     `json:"responsibilities,omitempty"`
	Language          string       `json:"language,omitempty"`
	LanguageRationale string       `json:"languageRationale,omitempty"`
	Layer             ServiceLayer `json:"layer,omitempty"`
	Protocol          Protocol     `json:"protocol,omitempty"`
	Owner             string       `json:"owner,omitempty"`
	Dependencies      []string     `json:"dependencies,omitempty"`
	Tags              []string     `json:"tags,omitempty"`
}

type ServiceLayer string

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

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

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

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

	// SolutionRationale explains why the selected solution was chosen.
	SolutionRationale string `json:"solutionRationale,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:"problemsAddressed,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:"estimatedEffort,omitempty"`
}

type SolutionSection struct {
	Overview        string            `json:"overview"`
	HowItWorks      string            `json:"howItWorks"`
	KeyFeatures     []FeatureSnapshot `json:"keyFeatures"`
	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 SourceOfTruth struct {
	Artifact      string                `json:"artifact"`
	Location      SourceOfTruthLocation `json:"location"`
	Rationale     string                `json:"rationale,omitempty"`
	GitOpsEnabled bool                  `json:"gitOpsEnabled,omitempty"`
}

type SourceOfTruthLocation string

type Status = common.Status

type StorageCategory struct {
	ID         string              `json:"id,omitempty"`
	Category   StorageCategoryType `json:"category"`
	Purpose    string              `json:"purpose"`
	Technology string              `json:"technology"`
	Rationale  string              `json:"rationale,omitempty"`
	Encryption string              `json:"encryption,omitempty"`
	Retention  string              `json:"retention,omitempty"`
	PerTenant  bool                `json:"perTenant,omitempty"`
}

type StorageCategoryType string

type SuccessMetrics struct {
	// NorthStar contains the primary metrics that define success.
	// These are the most important metrics that the team focuses on.
	NorthStar []Metric `json:"northStar"`

	// Supporting contains metrics that support the north star metrics.
	// These help explain or contribute to north star metric performance.
	Supporting []Metric `json:"supporting,omitempty"`

	// Guardrail contains metrics that should not degrade.
	// These ensure that improvements to north star metrics don't come at
	// the expense of other important aspects of the product.
	Guardrail []Metric `json:"guardrail,omitempty"`
}

type SuccessMetricsSection struct {
	PrimaryMetric    MetricSnapshot   `json:"primaryMetric"`
	SecondaryMetrics []MetricSnapshot `json:"secondaryMetrics"`
	Guardrails       []MetricSnapshot `json:"guardrails,omitempty"`
	BusinessGoals    []string         `json:"businessGoals"`
}

type TechnicalArchitecture struct {
	Overview          string          `json:"overview"`
	SystemDiagram     string          `json:"systemDiagram,omitempty"` // URL or path to diagram
	DataModel         string          `json:"dataModel,omitempty"`     // URL or path to ERD
	IntegrationPoints []Integration   `json:"integrationPoints,omitempty"`
	TechnologyStack   TechnologyStack `json:"technologyStack,omitempty"`
	SecurityDesign    string          `json:"securityDesign,omitempty"`
	ScalabilityDesign string          `json:"scalabilityDesign,omitempty"`

	// Services lists the microservices in the architecture.
	Services []Service `json:"services,omitempty"`

	// APIs lists the API specifications.
	APIs []APISpec `json:"apis,omitempty"`

	// StorageArchitecture defines storage by category.
	StorageArchitecture []StorageCategory `json:"storageArchitecture,omitempty"`

	// GitOps defines GitOps configuration.
	GitOps *GitOpsConfig `json:"gitOps,omitempty"`

	// Orchestration defines workflow orchestration.
	Orchestration *OrchestrationConfig `json:"orchestration,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:"threatActors"`

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

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

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

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

type UXRequirements struct {
	DesignPrinciples []string          `json:"designPrinciples,omitempty"`
	Wireframes       []Wireframe       `json:"wireframes,omitempty"`
	InteractionFlows []InteractionFlow `json:"interactionFlows,omitempty"`
	Accessibility    AccessibilitySpec `json:"accessibility,omitempty"`
	BrandGuidelines  string            `json:"brandGuidelines,omitempty"` // URL or path
	DesignSystem     string            `json:"designSystem,omitempty"`    // URL or path
}

type UserStory struct {
	ID                 string                `json:"id"`
	PersonaID          string                `json:"personaId"` // Reference to persona
	Title              string                `json:"title"`
	AsA                string                `json:"asA"`    // Persona role (e.g., "developer", "admin")
	IWant              string                `json:"iWant"`  // Desired action/feature
	SoThat             string                `json:"soThat"` // Benefit/reason
	AcceptanceCriteria []AcceptanceCriterion `json:"acceptanceCriteria"`
	Priority           Priority              `json:"priority"`
	PhaseID            string                `json:"phaseId"` // Reference to roadmap phase
	StoryPoints        *int                  `json:"storyPoints,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
}