Method CreateChildTask

internal/task/manager.go:373–400

CreateChildTask creates one child task beneath the supplied parent and emits an additional parent-scoped audit event.

(
	ctx context.Context,
	parentTaskID string,
	spec CreateTask,
	actor ActorContext,
)

// CreateChildTask creates one child task beneath the supplied parent and emits
// an additional parent-scoped audit event.
func (m *Service) CreateChildTask(
	ctx context.Context,
	parentTaskID string,
	spec CreateTask,
	actor ActorContext,
) (*Task, error) {
	trimmedParentID := strings.TrimSpace(parentTaskID)
	if trimmedParentID == "" {
		return nil, fmt.Errorf("%w: child parent task id is required", ErrValidation)
	}
	if strings.TrimSpace(spec.ParentTaskID) != "" && strings.TrimSpace(spec.ParentTaskID) != trimmedParentID {
		return nil, fmt.Errorf("%w: create_task.parent_task_id must match child parent task id", ErrValidation)
	}

	spec.ParentTaskID = trimmedParentID
	child, err := m.CreateTask(ctx, spec, actor)
	if err != nil {
		return nil, err
	}
	if err := m.recordTaskEvent(ctx, trimmedParentID, "", taskEventChildCreated, actor, childCreatedTaskPayload{
		ChildTaskID:      child.ID,
		ChildScope:       child.Scope,
		ChildWorkspaceID: child.WorkspaceID,
	}); err != nil {
		return nil, err
	}
	return child, nil
}

// DeleteTask removes one task after verifying it is not still in use by child
// tasks or non-terminal runs, then reconciles any dependents unblocked by the