package intent

import (
	"time"
)

// IntentType 核心意图类别定义
type IntentType string

const (
	IntentQueryProgress      IntentType = "QUERY_PROGRESS"      // 查询进度、成熟度、风险研判或沟通话术
	IntentSupplementInfo     IntentType = "SUPPLEMENT_INFO"     // 补充/修改材料、事实信息或参数
	IntentAdvanceStage       IntentType = "ADVANCE_STAGE"       // 确认推进到下一成熟度阶段 (如 V0.1 -> V0.5)
	IntentTriggerTask        IntentType = "TRIGGER_TASK"        // 显式生成或重新执行特定交付物任务 (如 intake, quote)
	IntentTriggerAdhocTask   IntentType = "TRIGGER_ADHOC_TASK"  // 将对话中的复杂自由任务升级为小队受控执行（路由层 R1 升级建议兑现）
	IntentCasualChat         IntentType = "CASUAL_CHAT"         // 问候、闲聊或通用帮助引导
	IntentDeclineExpectation IntentType = "DECLINE_EXPECTATION" // 用户明确暂缓/不采纳上轮建议 (非阻塞放弃)

	// 法定文档治理流转
	IntentDocGovClaim          IntentType = "DOCGOV_CLAIM"
	IntentDocGovSubmitReview   IntentType = "DOCGOV_SUBMIT_REVIEW"
	IntentDocGovReviewApprove  IntentType = "DOCGOV_REVIEW_APPROVE"
	IntentDocGovReviewReject   IntentType = "DOCGOV_REVIEW_REJECT"
	IntentDocGovFinalApprove   IntentType = "DOCGOV_FINAL_APPROVE"
	IntentDocGovFinalReject    IntentType = "DOCGOV_FINAL_REJECT"
	IntentDocGovProposalDecide IntentType = "DOCGOV_PROPOSAL_DECIDE"

	// 决策与合规查询
	IntentQueryRegulations  IntentType = "QUERY_REGULATIONS"
	IntentQuerySimilarCases IntentType = "QUERY_SIMILAR_CASES"
	IntentQueryUserRights   IntentType = "QUERY_USER_RIGHTS"
	IntentQueryRejectReason IntentType = "QUERY_REJECT_REASON" // 查询受控文档驳回/退回原因

	// 协同拍板与阶段执行动作
	IntentConfirmAction       IntentType = "CONFIRM_ACTION"        // 用户拍板确认交互卡片
	IntentExecuteStageAdvance IntentType = "EXECUTE_STAGE_ADVANCE" // 推进工作流阶段执行

	// 安全与权限红线拦截
	IntentSecurityForbidden IntentType = "SECURITY_FORBIDDEN"

	// 工作流控制（Phase 3 产品能力对齐）
	IntentSwitchWorkflow      IntentType = "SWITCH_WORKFLOW"
	IntentTriggerWorkflow     IntentType = "TRIGGER_WORKFLOW"
	IntentQueryWorkflowStatus IntentType = "QUERY_WORKFLOW_STATUS"

	// 文档/运行态只读查询
	IntentQueryDocStatus IntentType = "QUERY_DOC_STATUS"

	// 对话修复：帮助 / 暂不支持
	IntentHelpCapabilities  IntentType = "HELP_CAPABILITIES"
	IntentUnsupportedAction IntentType = "UNSUPPORTED_ACTION"

	// 长任务运行控制（Phase 4）
	IntentRunStatusQuery IntentType = "RUN_STATUS_QUERY"
	IntentRunResume      IntentType = "RUN_RESUME"
	IntentRunRestart     IntentType = "RUN_RESTART"

	// 影响分析与修订提案。分析只读；提案确认后才写。
	IntentImpactAnalyze IntentType = "IMPACT_ANALYZE"
	IntentRevisePropose IntentType = "REVISE_PROPOSE"
)

// ResolutionBranch 三分支意图消解类别
type ResolutionBranch string

const (
	BranchExpectationHit    ResolutionBranch = "EXPECTATION_HIT"    // 分支 1: 命中历史轮次挂起预期 (肯定/选择/带补丁/取消)
	BranchNewIntentPreempt  ResolutionBranch = "NEW_INTENT_PREEMPT" // 分支 2: 独立新意图抢占 (用户意图最高优先级)
	BranchAmbiguousFallback ResolutionBranch = "AMBIGUOUS_FALLBACK" // 分支 3: 模糊/无实际意义兜底 (参谋主动分析引导)
)

// ExpectationOption 供用户挑选或单字快速兑现的具体选项
type ExpectationOption struct {
	OptionID    string            `json:"option_id"`             // 选项代号 (如 "1", "2", "advance_v05")
	Title       string            `json:"title"`                 // 选项简述 (如 "推进到 V0.5 方案成型与法规对齐")
	Description string            `json:"description,omitempty"` // 参谋为用户做的工作说明与收益分析
	Intent      IntentType        `json:"intent"`                // 对应绑定的业务意图
	Slots       map[string]string `json:"slots,omitempty"`       // 预设槽位键值对
}

// PendingExpectation 挂起预期草稿（非阻塞桌角备忘贴纸）
type PendingExpectation struct {
	ExpectationID    string              `json:"expectation_id,omitempty"`
	ExpectedIntent   IntentType          `json:"expected_intent,omitempty"`
	TargetAction     string              `json:"target_action,omitempty"`
	Prompt           string              `json:"prompt,omitempty"`
	AffirmativeWord  string              `json:"affirmative_word,omitempty"`
	DeclineWord      string              `json:"decline_word,omitempty"`
	ExpiresAt        time.Time           `json:"expires_at,omitempty"`
	Payload          map[string]string   `json:"payload,omitempty"`
	ContextSnippet   string              `json:"context_snippet,omitempty"` // 上一轮建议的业务背景简述
	DefaultOption    *ExpectationOption  `json:"default_option,omitempty"`  // 参谋最推荐的基准选项（用户说“好/行”时默认执行）
	Options          []ExpectationOption `json:"options,omitempty"`         // 供用户挑选的备选选项列表
	AllowAffirmative bool                `json:"allow_affirmative"`         // 是否允许用单字肯定（好/行/可以）触发
	CreatedAt        time.Time           `json:"created_at"`                // 挂起时间
}

// CandidateIntent 候选意图提案（L1 对话层输出，由 L2 协调层终审）
type CandidateIntent struct {
	Intent                IntentType         `json:"intent"`
	Confidence            float64            `json:"confidence"` // 置信度 0.0 - 1.0
	Branch                ResolutionBranch   `json:"branch"`     // 归属的三分支判定
	FilledSlots           map[string]string  `json:"filled_slots"`
	MissingSlots          []string           `json:"missing_slots,omitempty"`
	Reasoning             string             `json:"reasoning"`                        // 判断依据与文本佐证
	ClarificationQuestion string             `json:"clarification_question,omitempty"` // 槽位缺失时的澄清追问
	MatchedOption         *ExpectationOption `json:"matched_option,omitempty"`         // 分支 1 命中的具体选项
	PatchSlots            map[string]string  `json:"patch_slots,omitempty"`            // 分支 1 复合输入的增量槽位补丁
	IsDecline             bool               `json:"is_decline,omitempty"`             // 是否为明确暂缓/放弃
}

// IntentRecognitionResult 意图识别完整输出（多输出策略）
type IntentRecognitionResult struct {
	RawInput           string            `json:"raw_input"`
	TopIntent          *CandidateIntent  `json:"top_intent"`
	Candidates         []CandidateIntent `json:"candidates"`
	ContextSnapshotID  string            `json:"context_snapshot_id,omitempty"`
	RequiresClarifying bool              `json:"requires_clarifying"`
	Branch             ResolutionBranch  `json:"branch"` // 顶层分支标记

	// Shadow* 观测字段：只记录、不参与 Router/Coordinator 路由裁决。
	ShadowScore        float64 `json:"shadow_score,omitempty"`
	ShadowMargin       float64 `json:"shadow_margin,omitempty"`
	ShadowDialogueAct  string  `json:"shadow_dialogue_act,omitempty"`
	ShadowDecisionHint string  `json:"shadow_decision_hint,omitempty"`

	// V2 双写：迁移期与 TopIntent 并存，Router/Coordinator 默认仍消费 TopIntent。
	IntentFrameV2 *IntentFrameV2    `json:"intent_frame_v2,omitempty"`
	RankedFrames  *RankedIntentSet  `json:"ranked_frames,omitempty"`
	IntentPlan    *IntentPlan       `json:"intent_plan,omitempty"`
	PlanProposal  *PlanProposal     `json:"plan_proposal,omitempty"`
	PlanShadow    *PlanShadowReport `json:"plan_shadow,omitempty"`

	// V2Shadow Phase 5 影子比对（intent_v2_shadow / intent_v2_decision 开启时填充）
	V2Shadow *V2ShadowReport `json:"v2_shadow,omitempty"`
}

// 常见槽位 Key 常量定义
const (
	SlotTargetStage   = "target_stage"   // 目标阶段 (如 V0.1_triage, V0.5_feasibility, V1.0_quoting)
	SlotTargetTask    = "target_task"    // 目标任务 (如 intake, research, cdo_quote)
	SlotFactKey       = "fact_key"       // 事实键 (如 target_market, device_type)
	SlotFactValue     = "fact_value"     // 事实值
	SlotSupplementDoc = "supplement_doc" // 补充内容文本
	SlotQueryTopic    = "query_topic"    // 查询主题 (如 progress, risk, talk_script, quotation)

	// 法定文档治理与权限槽位
	SlotTargetDoc       = "target_doc"
	// TargetDocLatestUpload 是「刚刚/最近上传」指代的哨兵目标，由服务端解析为项目最新 CAS 资产。
	TargetDocLatestUpload = "@latest_upload"
	SlotRejectReason    = "reject_reason"
	SlotTargetSection   = "target_section"
	SlotProposalAction  = "proposal_action"
	SlotForbiddenTarget = "forbidden_target"

	// 路由层槽位
	SlotTaskBrief = "task_brief" // 自由任务简报（升级建议携带的用户原始诉求）

	// 工作流槽位
	SlotTargetWorkflow = "target_workflow" // product_manager | test_manager | main

	// 工作流作用域标记：填槽显式点名了非激活工作流的文档时打标引导切换，不误填 target_doc
	SlotWorkflowScopeMismatch = "workflow_scope_mismatch" // "true"
	SlotMismatchedWorkflow    = "mismatched_workflow"     // 文档归属工作流 key（多个用逗号连接）
	SlotMismatchedDoc         = "mismatched_doc"          // 被显式点名的他流文档标题
	SlotCrossWorkflowOwner    = "cross_workflow_owner"    // 只读跨流放行时的归属工作流 key

	// 长任务/运行槽位
	SlotWorkDir          = "work_dir"
	SlotRunAction        = "run_action"        // status | resume | restart
	SlotSupplementAction = "supplement_action" // add | correct | attach

	// 智能确认：弱写动词等场景由协调层下发 PendingExpectation，用户拍板后再执行
	SlotNeedsConfirmation = "needs_confirmation" // "true"
)

// CardAction 交互卡片按钮动作
type CardAction struct {
	ActionID             string            `json:"action_id"`
	Label                string            `json:"label"`
	Style                string            `json:"style"` // primary, danger, subtle
	Payload              map[string]string `json:"payload,omitempty"`
	IsAffirmativeDefault bool              `json:"is_affirmative_default,omitempty"`
}

// InteractiveCardPayload 对话交互卡片载荷
type InteractiveCardPayload struct {
	CardID          string       `json:"card_id"`
	CardType        string       `json:"card_type"` // CONFIRMATION, SLOT_FILLING, DIFF_PROPOSAL, REMINDER_NOTICE
	Title           string       `json:"title"`
	TargetDocID     string       `json:"target_doc_id,omitempty"`
	TargetDocTitle  string       `json:"target_doc_title,omitempty"`
	TargetSectionID string       `json:"target_section_id,omitempty"`
	SectionTitle    string       `json:"section_title,omitempty"`
	ProposedContent string       `json:"proposed_content,omitempty"`
	ImpactRisk      string       `json:"impact_risk,omitempty"`
	CurrentStatus   string       `json:"current_status"` // active, executing, resolved, cancelled, outdated, expired
	TTLTurns        int          `json:"ttl_turns"`
	CreatedAt       time.Time    `json:"created_at"`
	Actions         []CardAction `json:"actions,omitempty"`
}

// ContextSnapshot 传递给 L1 意图识别器的轻量上下文快照
type ContextSnapshot struct {
	SnapshotID         string              `json:"snapshot_id,omitempty"`
	ProjectName        string              `json:"project_name,omitempty"`
	CurrentStage       string              `json:"current_stage,omitempty"`
	ActiveWorkflowKey  string              `json:"active_workflow_key,omitempty"`
	ActiveDocID        string              `json:"active_doc_id,omitempty"`
	DocLifecycleState  string              `json:"doc_lifecycle_state,omitempty"`
	UserDocRole        string              `json:"user_doc_role,omitempty"`
	AvailableActions   []string            `json:"available_actions,omitempty"`
	PendingExpectation *PendingExpectation `json:"pending_expectation,omitempty"`
}