bugfix

internal/orchestrator/helpers.go

@@ -0,0 +1,56 @@
+package orchestrator
+
+import (
+	"context"
+	"time"
+
+	"github.com/google/uuid"
+
+	"github.com/yan1h/agent-coding-workflow/internal/project"
+)
+
+// StepEnqueuer 是建好 step 后入队其 orchestrator.step job 的窄接口（service 实现，
+// 包装 jobs.Repository.Enqueue）。导出以便 app.go 在启动恢复时直接调用 EnqueueStep。
+type StepEnqueuer interface {
+	EnqueueStep(ctx context.Context, runID, stepID uuid.UUID, scheduledAt time.Time) error
+}
+
+// AuditRecorder 是编排器写审计的窄接口（app 层用 audit.Recorder 适配）。导出以便
+// 外部包（app）的适配器可实现（unexported 方法的接口无法被跨包实现）。
+type AuditRecorder interface {
+	Record(ctx context.Context, userID uuid.UUID, action, targetID string, meta map[string]any)
+}
+
+// buildPhaseStep 为 run 在指定 phase 建一个新 step（pending 状态），解析 agent-kind
+// 与 prompt 后落库。parent 非 nil 时记录 parent_step_id（request_subtask fan-out）。
+// 解析失败（如缺 agent-kind）返回 error，调用方据此处理（标 run 失败 / 拒绝 subtask）。
+func buildPhaseStep(ctx context.Context, repo Repository, pm PMAccess, run *Run,
+	phase project.Phase, parentStepID *uuid.UUID, depth int,
+	defaults map[project.Phase]uuid.UUID) (*Step, error) {
+
+	akID, err := PhaseAgentKind(run.Config, phase, defaults)
+	if err != nil {
+		return nil, err
+	}
+
+	req, err := pm.GetRequirementByID(ctx, run.RequirementID)
+	if err != nil {
+		return nil, err
+	}
+	artifacts, _ := pm.ListLatestArtifacts(ctx, run.RequirementID)
+	override := run.Config.PromptOverrides[phase]
+	prompt := BuildPrompt(phase, req, artifacts, override)
+
+	step := &Step{
+		ID:           uuid.New(),
+		RunID:        run.ID,
+		Phase:        phase,
+		Attempt:      1,
+		ParentStepID: parentStepID,
+		Depth:        depth,
+		Status:       StepPending,
+		AgentKindID:  akID,
+		Prompt:       prompt,
+	}
+	return repo.InsertStep(ctx, step)
+}