feat(dispatcher,gateway): Eino 采纳 Phase D —— 任务生命周期状态机

submitted → running → done / failed / timeout 显式状态机，根治"卡运行中
看不出来"（此前 Task.Status 只写死 submitted、从不流转）。

- contract：新增 SubjectTaskStatus 主题 + TaskStatusEvent + 状态常量
- shared/bus：PublishTaskStatus / SubscribeTaskStatus（core NATS pub-sub）
- dispatcher：StatusSink 接口 + Orchestrator.Handle 状态钩子——进入执行
  →running、收尾 finishStatus→done/failed、整体超时上限 taskExecTimeout
  =3min→timeout；经 sub 回写
- gateway：SubscribeTaskStatus 落 PG（Task 增 Detail 字段，AutoMigrate）；
  新增 GET /api/v1/tasks/:id 供 UI 轮询状态

验收：实测 submitted→running→done 流转 + PG 持久化 + 端点查询闭环；
make test-go 全绿。HITL 中断恢复 / 多智能体仍按场景待做。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

sundynix-gateway/cmd/server/main.go

@@ -46,6 +46,15 @@ func main() {
 		}
 	}
 
+	// 任务生命周期：订阅 dispatcher 回写的状态流转（running/done/failed/timeout），落 PG 供 UI 查询。
+	if _, err := bus.SubscribeTaskStatus(func(ev *contract.TaskStatusEvent) {
+		if err := db.UpdateTaskStatus(context.Background(), ev.TaskID, ev.Status, ev.Detail); err != nil {
+			log.Printf("[gateway] 更新任务状态 %s=%s 失败: %v", ev.TaskID, ev.Status, err)
+		}
+	}); err != nil {
+		log.Printf("[gateway] subscribe task status: %v", err)
+	}
+
 	r := router.New(db, cache, bus, blobStore)
 	addr := envOr("GATEWAY_ADDR", ":8080")
 	log.Printf("[gateway] listening on %s", addr)

sundynix-gateway/internal/handler/task_handler.go

@@ -56,6 +56,17 @@ func (h *Handler) SubmitTask(c *gin.Context) {
 	c.JSON(http.StatusAccepted, gin.H{"task_id": task.ID})
 }
 
+// TaskStatus: GET /api/v1/tasks/:id —— 返回任务生命周期状态（供 UI 轮询，根治"卡运行中看不出来"）。
+func (h *Handler) TaskStatus(c *gin.Context) {
+	id := c.Param("id")
+	status, detail := h.db.GetTaskStatus(c.Request.Context(), id)
+	if status == "" {
+		c.JSON(http.StatusNotFound, gin.H{"error": "task not found"})
+		return
+	}
+	c.JSON(http.StatusOK, gin.H{"task_id": id, "status": status, "detail": detail})
+}
+
 // StreamTask: 订阅 sundynix.streams.<task_id>，以 SSE 把零拷贝 Token Stream 推给客户端。
 func (h *Handler) StreamTask(c *gin.Context) {
 	taskID := c.Param("id")

sundynix-gateway/internal/nats/publisher.go

@@ -59,6 +59,11 @@ func (b *Bus) Ping(ctx context.Context, subject string) ([]byte, error) {
 	return b.inner.Ping(ctx, subject)
 }
 
+// SubscribeTaskStatus 订阅 dispatcher 回写的任务生命周期状态（落 PG）。
+func (b *Bus) SubscribeTaskStatus(onEvent func(*contract.TaskStatusEvent)) (func() error, error) {
+	return b.inner.SubscribeTaskStatus(onEvent)
+}
+
 // ServeConfig 让网关作为配置控制面，响应某 kind 的配置请求。
 func (b *Bus) ServeConfig(kind string, provide func() *contract.ModelConfig) (func() error, error) {
 	return b.inner.ServeConfig(kind, provide)

sundynix-gateway/internal/router/router.go

@@ -49,6 +49,7 @@ func New(db *store.Postgres, cache *store.Redis, bus *nats.Bus, blobStore *blob.
 		p := api.Group("", middleware.RequireAuth())
 		{
 			p.POST("/tasks", h.SubmitTask)        // 解析 DSL 并 Publish 到 NATS（带已验证 uid）
+			p.GET("/tasks/:id", h.TaskStatus)     // 任务生命周期状态（UI 轮询 submitted/running/done/failed/timeout）
 			p.PUT("/memory", h.SetMemory)         // 偏好记忆登记（→ mcp-go memory_upsert）
 			p.GET("/memory", h.ListMemory)        // 列出当前用户偏好（记忆面板）
 			p.DELETE("/memory", h.DeleteMemory)   // 软删一条偏好（?key=）

sundynix-gateway/internal/store/models.go

@@ -19,5 +19,6 @@ type Task struct {
 	BaseModel
 	TaskID string `gorm:"uniqueIndex;size:64"` // task_xxx
 	Graph  string `gorm:"type:jsonb"`          // React Flow 导出的 DSL 原文
-	Status string `gorm:"size:32"`             // submitted / done / failed
+	Status string `gorm:"size:32"`             // submitted / running / done / failed / timeout
+	Detail string `gorm:"type:text"`           // 失败/超时原因等（状态机回写）
 }

sundynix-gateway/internal/store/pgsql.go

@@ -9,6 +9,8 @@ import (
 	"gorm.io/driver/postgres"
 	"gorm.io/gorm"
 	"gorm.io/gorm/schema"
+
+	"github.com/sundynix/sundynix-shared/contract"
 )
 
 // errStoreDisabled 表示 Postgres 处于降级（未连接）模式，写操作无法进行。
@@ -93,7 +95,29 @@ func (p *Postgres) SaveTask(ctx context.Context, id, graph string) error {
 	if p.db == nil {
 		return nil
 	}
-	return p.db.WithContext(ctx).Create(&Task{TaskID: id, Graph: graph, Status: "submitted"}).Error
+	return p.db.WithContext(ctx).Create(&Task{TaskID: id, Graph: graph, Status: contract.TaskSubmitted}).Error
+}
+
+// UpdateTaskStatus 流转任务状态（running/done/failed/timeout），由 dispatcher 经 NATS 回写驱动。
+func (p *Postgres) UpdateTaskStatus(ctx context.Context, id, status, detail string) error {
+	if p.db == nil {
+		return nil
+	}
+	return p.db.WithContext(ctx).Model(&Task{}).
+		Where("task_id = ?", id).
+		Updates(map[string]any{"status": status, "detail": detail}).Error
+}
+
+// GetTaskStatus 取一条任务的当前状态（供 UI 轮询；不存在返回空串）。
+func (p *Postgres) GetTaskStatus(ctx context.Context, id string) (status, detail string) {
+	if p.db == nil {
+		return "", ""
+	}
+	var t Task
+	if err := p.db.WithContext(ctx).Select("status", "detail").Where("task_id = ?", id).First(&t).Error; err != nil {
+		return "", ""
+	}
+	return t.Status, t.Detail
 }
 
 // CountTasks 返回已提交任务数（降级模式返回 0）。