weichen
a4ea66c41d
Why: Contract foundation for the inbox/command-bus/workspaces phase (proposal D28/D30): ActivityCard as the first-class state object behind the right-rail inbox, card.* stream events, inline-confirm anchoring (anchorMessageId + blocked/blockReason) on HITL, seven new UI schema vocabularies, plugin provides.commands/workspaces, workflow card step and workspace declarations. Evidence: go vet clean; conformance goldens regenerated and verified — new activity_card / hitl_card_blocked / event_card_created / event_card_resolved / ui_vocabularies samples plus extended plugin_manifest; CardStatus.Terminal helper unit-covered via build; ts/types.ts mirrors all additions. Impact: Additive only (omitempty fields, new types, new event types) — existing consumers ignore unknown values per forward-compat rule; vocabulary spec types carry a Spec suffix to avoid const-name collisions. Refs: modules/documents docs/proposals/2026-09-30-ui-inbox-command-workspace.md
57 lines
2.9 KiB
Go
57 lines
2.9 KiB
Go
package core
|
|
|
|
import "time"
|
|
|
|
// ActivityCard：异步任务/待确认事项的统一状态对象——右栏收件箱的条目。
|
|
// 与一次性消息相对：卡片是有生命周期的状态（进行中→完成/待办→已决/失败/弃置），
|
|
// 由服务端权威维护，经 card.* 事件驱动前端投影；确认动作回写对话时间线并留审计。
|
|
//
|
|
// 生命周期：active → done | action_required → resolved | failed | dismissed。
|
|
// Kind 决定卡身的默认内容组合（progress 流式区 / compare 对比 / review-list 裁决清单…），
|
|
// Body 用 UI 有限词汇渲染；插件可扩展 Kind（前端按未知 kind 走通用卡渲染）。
|
|
type ActivityCard struct {
|
|
ID ID `json:"id"`
|
|
// ProjectID/ConversationID 定位归属；ConversationID 为空表示项目级卡片（远期跨会话收件箱）。
|
|
ProjectID ID `json:"projectId"`
|
|
ConversationID ID `json:"conversationId,omitempty"`
|
|
SourceRunID ID `json:"sourceRunId,omitempty"` // 溯源：产生卡片的 run
|
|
AnchorMessageID ID `json:"anchorMessageId,omitempty"` // 互定位：出生消息（↙ 定位到对话）
|
|
Kind CardKind `json:"kind"`
|
|
Title string `json:"title"`
|
|
Status CardStatus `json:"status"`
|
|
Tone string `json:"tone,omitempty"` // ok | warn | danger | info
|
|
Body []UINode `json:"body,omitempty"`
|
|
Actions []UIAction `json:"actions,omitempty"` // 走命令总线；未绑定 command 降级为发消息
|
|
Pinned bool `json:"pinned,omitempty"`
|
|
CreatedAt time.Time `json:"createdAt"`
|
|
UpdatedAt time.Time `json:"updatedAt"`
|
|
}
|
|
|
|
type CardKind string
|
|
|
|
const (
|
|
CardKindProgress CardKind = "progress" // 后台任务进度（流式区 + 进度行）
|
|
CardKindConfirm CardKind = "confirm" // 待确认（相关性/冲突/门禁/投影）
|
|
CardKindCompare CardKind = "compare" // 左右对比（基线 vs 新内容）
|
|
CardKindReviewList CardKind = "review-list" // 逐条裁决清单（候选边/缺项）
|
|
CardKindResult CardKind = "result" // 结果与产物（结论 + 来源 + 打开入口）
|
|
CardKindError CardKind = "error" // 失败显式呈现（可重试/可取回）
|
|
CardKindStatus CardKind = "status" // 常态状态卡（文档进度等）
|
|
)
|
|
|
|
type CardStatus string
|
|
|
|
const (
|
|
CardActive CardStatus = "active" // 进行中
|
|
CardActionRequired CardStatus = "action_required" // 待用户处理
|
|
CardDone CardStatus = "done" // 完成（未读结果）
|
|
CardResolved CardStatus = "resolved" // 已确认/已处理（盖章留痕）
|
|
CardFailed CardStatus = "failed"
|
|
CardDismissed CardStatus = "dismissed" // 用户关闭（非确认语义）
|
|
)
|
|
|
|
// Terminal 报告卡片是否处于终态（终态卡进入"已完成"可收纳区）。
|
|
func (s CardStatus) Terminal() bool {
|
|
return s == CardResolved || s == CardFailed || s == CardDismissed
|
|
}
|