384 lines
11 KiB
TypeScript
384 lines
11 KiB
TypeScript
//! TypeScript 类型定义 — 与 Rust Record 结构体严格对齐
|
||
|
||
// ============================================================
|
||
// 灵感
|
||
// ============================================================
|
||
|
||
export interface IdeaRecord {
|
||
id: string
|
||
title: string
|
||
description: string
|
||
status: string // draft | pending_review | approved | rejected | promoted | archived
|
||
priority: number
|
||
score: number | null
|
||
tags: string | null // JSON 数组字符串
|
||
source: string | null
|
||
promoted_to: string | null
|
||
ai_analysis: string | null
|
||
scores: string | null
|
||
created_at: string
|
||
updated_at: string
|
||
}
|
||
|
||
export interface CreateIdeaInput {
|
||
title: string
|
||
description?: string
|
||
priority?: number
|
||
tags?: string
|
||
source?: string
|
||
}
|
||
|
||
// ============================================================
|
||
// 项目
|
||
// ============================================================
|
||
|
||
export interface ProjectRecord {
|
||
id: string
|
||
name: string
|
||
description: string
|
||
status: string // planning | in_progress | testing | releasing | completed | paused
|
||
idea_id: string | null
|
||
/** 绑定的本地代码目录绝对路径(null=未绑定) */
|
||
path: string | null
|
||
/** 技术栈 JSON 数组字符串(如 ["rust","vue"],null=未探测) */
|
||
stack: string | null
|
||
created_at: string
|
||
updated_at: string
|
||
}
|
||
|
||
export interface CreateProjectInput {
|
||
name: string
|
||
description?: string
|
||
idea_id?: string
|
||
/** 绑定的本地代码目录(可选) */
|
||
path?: string
|
||
/** 技术栈 JSON 数组字符串(可选,空则后端自动探测) */
|
||
stack?: string
|
||
}
|
||
|
||
/** AI 扫描项目结果(预览用,用户确认后填入) */
|
||
export interface AiScanResult {
|
||
/** 项目摘要(空=LLM 未得出,需手填) */
|
||
description: string
|
||
/** 技术栈(规则 ∪ LLM,去重小写) */
|
||
stack: string[]
|
||
/** 项目类型(web/api/cli/library/desktop/mobile/monorepo/other) */
|
||
project_type: string | null
|
||
/** LLM 原始返回(降级时含错误信息) */
|
||
raw: string | null
|
||
}
|
||
|
||
/** 灵感晋升结果（后端 promote_idea 返回） */
|
||
export interface PromotionResult {
|
||
idea_id: string
|
||
project_id: string
|
||
promoted: boolean
|
||
reason: string
|
||
}
|
||
|
||
// ============================================================
|
||
// 任务
|
||
// ============================================================
|
||
|
||
export interface TaskRecord {
|
||
id: string
|
||
project_id: string
|
||
title: string
|
||
description: string
|
||
status: string // todo | in_progress | in_review | testing | done | blocked | cancelled
|
||
priority: number // 0=critical, 1=high, 2=medium, 3=low
|
||
branch_name: string | null
|
||
assignee: string | null
|
||
workflow_def_id: string | null
|
||
base_branch: string | null
|
||
/** review 退回累计轮数(in_review→in_progress / testing→in_review 各 +1) */
|
||
review_rounds: number
|
||
created_at: string
|
||
updated_at: string
|
||
}
|
||
|
||
export interface CreateTaskInput {
|
||
project_id: string
|
||
title: string
|
||
description?: string
|
||
priority?: number
|
||
branch_name?: string
|
||
assignee?: string
|
||
}
|
||
|
||
// ============================================================
|
||
// 工作流
|
||
// ============================================================
|
||
|
||
export interface WorkflowRecord {
|
||
id: string
|
||
name: string
|
||
dag_json: string
|
||
status: string // running | completed | failed | cancelled
|
||
triggered_by: string | null
|
||
project_id: string | null
|
||
task_id: string | null
|
||
created_at: string
|
||
completed_at: string | null
|
||
}
|
||
|
||
/** 工作流事件载荷（后端 emit 的结构） */
|
||
/** 工作流事件类型字面量联合(对应后端 WorkflowEvent serde tag=type rename_all=snake_case，R7收窄防写错 type 字符串) */
|
||
export type WorkflowEventType =
|
||
| 'node_started' | 'node_progress' | 'node_output' | 'node_completed' | 'node_failed' | 'node_cancelled'
|
||
| 'workflow_paused' | 'workflow_completed' | 'workflow_failed'
|
||
| 'human_approval_request' | 'human_approval_response'
|
||
|
||
export interface WorkflowEventPayload {
|
||
execution_id: string
|
||
event: {
|
||
type: WorkflowEventType
|
||
[key: string]: unknown
|
||
}
|
||
}
|
||
|
||
// ============================================================
|
||
// 通用
|
||
// ============================================================
|
||
|
||
export type UpdateField = {
|
||
id: string
|
||
field: string
|
||
value: string
|
||
}
|
||
|
||
// ============================================================
|
||
// 数据变更联动刷新(AR-11 方案A)
|
||
// ============================================================
|
||
|
||
/**
|
||
* 后端 AI 工具(create/update/delete/restore/purge/bind_directory 等)执行成功后
|
||
* emit 的 "df-data-changed" 事件负载。前端 store listen 后按 entity 调对应 load 刷新列表。
|
||
*/
|
||
export interface DfDataChangedPayload {
|
||
/** 变更实体:project / task / idea */
|
||
entity: 'project' | 'task' | 'idea'
|
||
/** 变更动作:create / update / delete */
|
||
action: 'create' | 'update' | 'delete'
|
||
}
|
||
|
||
// ============================================================
|
||
// AI 聊天
|
||
// ============================================================
|
||
|
||
export interface AiProviderConfig {
|
||
id: string
|
||
name: string
|
||
provider_type: string
|
||
api_key: string
|
||
base_url: string
|
||
default_model: string
|
||
models: string | null
|
||
is_default: boolean
|
||
config: string | null
|
||
created_at: string
|
||
updated_at: string
|
||
}
|
||
|
||
/**
|
||
* AI 错误分类字面量集(B-260615-42)。
|
||
* 与后端 `commands::ai::ErrorType` 的 serde(rename_all = "snake_case") 严格对齐。
|
||
* 前端消费方 switch 于此常量集做差异化提示(auth 引导填 key / network 提示连接 / 等)。
|
||
*/
|
||
export type AiErrorType = 'auth' | 'network' | 'timeout' | 'provider_config' | 'unknown'
|
||
|
||
/** AI 聊天事件（后端 emit 的结构，conversation_id 用于多对话流式路由） */
|
||
export type AiChatEvent = ({
|
||
type: 'AiTextDelta'; delta: string
|
||
} | {
|
||
type: 'AiToolCallStarted'; id: string; name: string; args: unknown
|
||
} | {
|
||
type: 'AiToolCallCompleted'; id: string; result: unknown
|
||
} | {
|
||
type: 'AiApprovalRequired'; id: string; name: string; args: unknown; reason: string
|
||
} | {
|
||
type: 'AiApprovalResult'; id: string; approved: boolean
|
||
} | {
|
||
// UX-2025-04 / CR-30-2 / 决策 F-260616-07 a1: incomplete 标记流中途失败保文(网络中断),
|
||
// 前端据此差异化展示(如系统提示「⚠ 响应因网络中断不完整」)。正常完成/停止均为 undefined。
|
||
type: 'AiCompleted'; total_tokens: number; prompt_tokens: number; completion_tokens: number; incomplete?: boolean
|
||
} | {
|
||
type: 'AiError'; error: string; error_type?: AiErrorType
|
||
} | {
|
||
type: 'AiAgentRound'; round: number
|
||
} | {
|
||
type: 'AiHeartbeat'
|
||
} | {
|
||
// F-260616-03: 达 max_iterations 暂停态(后端仍 generating=true),前端展示操作卡询问继续/停止
|
||
type: 'AiMaxRoundsReached'
|
||
} | {
|
||
// F-260616-07: 流式调用自动重试提示(前端可在错误气泡内显示「重试 n/m」)
|
||
type: 'AiStreamRetry'; attempt: number; max_attempts: number
|
||
}) & {
|
||
conversation_id?: string
|
||
}
|
||
|
||
/** AI 消息（前端渲染用，isError 标记错误消息用于差异化样式） */
|
||
export interface AiMessage {
|
||
id: string
|
||
role: 'user' | 'assistant' | 'tool'
|
||
content: string
|
||
isError?: boolean
|
||
toolCalls?: AiToolCallInfo[]
|
||
/** 生成该消息的 model(仅 assistant 消息,历史消息从 DB 读) */
|
||
model?: string
|
||
timestamp: number
|
||
}
|
||
|
||
/** 工具调用信息 */
|
||
export interface AiToolCallInfo {
|
||
id: string
|
||
name: string
|
||
args: unknown
|
||
status: 'running' | 'pending_approval' | 'completed' | 'rejected'
|
||
result?: unknown
|
||
/** 审批风险说明（AiApprovalRequired 时填充） */
|
||
reason?: string
|
||
}
|
||
|
||
/** 对话列表摘要 */
|
||
export interface AiConversationSummary {
|
||
id: string
|
||
title: string | null
|
||
provider_id: string | null
|
||
model: string | null
|
||
archived: boolean
|
||
pinned?: boolean
|
||
prompt_tokens?: number | null
|
||
completion_tokens?: number | null
|
||
created_at: string
|
||
updated_at: string
|
||
}
|
||
|
||
/** 审批选择类型(F-260615-01: single=单选默认,multiple=多选) */
|
||
export type ApprovalSelectType = 'single' | 'multiple'
|
||
|
||
/** 人工审批请求 */
|
||
export interface HumanApprovalRequest {
|
||
execution_id: string
|
||
node_id: string
|
||
title: string
|
||
description: string
|
||
options: string[]
|
||
/** F-260615-01: 缺省 single(向后兼容),multiple 时允许多选 */
|
||
select_type?: ApprovalSelectType
|
||
}
|
||
|
||
/** 人工审批响应 */
|
||
export interface HumanApprovalResponse {
|
||
execution_id: string
|
||
node_id: string
|
||
decision: string
|
||
/** F-260615-01: 多选结果(single 时长度=1,multiple 时长度≥1) */
|
||
decisions?: string[]
|
||
comment?: string
|
||
}
|
||
|
||
/** 切换对话返回（含 messages JSON） */
|
||
export interface AiConversationDetail {
|
||
id: string
|
||
title: string | null
|
||
messages: string // JSON string of ChatMessage[]
|
||
/** 生成中返回 true(后端 ai_conversation_switch 在 generating 时置)，前端据此禁编辑(FR-C5) */
|
||
readonly?: boolean
|
||
}
|
||
|
||
/** 技能信息（本机 Claude skill，供 `/` 联想 + 注入） */
|
||
export interface SkillInfo {
|
||
name: string
|
||
description: string
|
||
argument_hint?: string
|
||
/** skill | command | plugin */
|
||
source: string
|
||
/** SKILL.md 绝对路径（后端注入时读全文） */
|
||
path: string
|
||
}
|
||
|
||
// ============================================================
|
||
// 知识库
|
||
// ============================================================
|
||
|
||
/** 知识条目（与 Rust KnowledgeRecord 严格对齐） */
|
||
export interface KnowledgeRecord {
|
||
id: string
|
||
kind: string // review_rule | prompt_template | pitfall | architecture_pattern | diagnosis | deployment_note | workflow_optimization
|
||
title: string
|
||
content: string
|
||
tags: string | null // JSON 数组字符串
|
||
status: string // candidate | pending_review | published | archived
|
||
confidence: string | null // high | medium | low
|
||
reuse_count: number
|
||
verified: boolean
|
||
source_project: string | null
|
||
source_ref: string | null
|
||
/** AI 提炼判断依据("为何值得沉淀"),手动录入为 null */
|
||
reasoning: string | null
|
||
created_at: string
|
||
updated_at: string
|
||
}
|
||
|
||
/** 创建知识入参 */
|
||
export interface CreateKnowledgeInput {
|
||
kind: string
|
||
title: string
|
||
content: string
|
||
tags?: string
|
||
source_project?: string
|
||
source_ref?: string
|
||
confidence?: string
|
||
}
|
||
|
||
/** 检索知识入参 */
|
||
export interface KnowledgeSearchInput {
|
||
query: string
|
||
kind?: string
|
||
limit?: number
|
||
}
|
||
|
||
/** 知识生命线事件记录(产生/审核/引用/归档审计) */
|
||
export interface KnowledgeEventRecord {
|
||
id: string
|
||
knowledge_id: string
|
||
/** created | extracted | status_changed | referenced */
|
||
event_type: string
|
||
source_ref: string | null
|
||
/** JSON 字符串,内容因 event_type 而异(见后端 KnowledgeTimeline) */
|
||
context_json: string | null
|
||
timestamp: string
|
||
}
|
||
|
||
/** 知识详情聚合负载(基本信息 + 全部生命线事件) */
|
||
export interface KnowledgeDetailPayload {
|
||
knowledge: KnowledgeRecord
|
||
events: KnowledgeEventRecord[]
|
||
}
|
||
|
||
/** 编辑知识入参(部分更新,仅传需改字段) */
|
||
export interface UpdateKnowledgeInput {
|
||
title?: string
|
||
content?: string
|
||
tags?: string
|
||
confidence?: string
|
||
reasoning?: string
|
||
}
|
||
|
||
/** 知识库行为配置（提取 + 注入 + 向量检索） */
|
||
export interface KnowledgeConfig {
|
||
auto_extract: boolean
|
||
trigger_mode: 'on_complete' | 'on_idle' | 'manual_only'
|
||
min_messages: number
|
||
idle_timeout_ms: number
|
||
auto_inject: boolean
|
||
/** 语义检索(向量)开关,默认 false——关闭时纯 LIKE 零外部依赖 */
|
||
vector_enabled: boolean
|
||
/** embedding 用的 provider id(仅 openai_compat 类型) */
|
||
embedding_provider_id: string | null
|
||
/** embedding 模型名(如 embedding-3) */
|
||
embedding_model: string | null
|
||
}
|