Changeset 0.35.0 (#209)

Co-authored-by: Jeffrey Smith <jasafpro@gmail.com>
Co-committed-by: Jeffrey Smith <jasafpro@gmail.com>

server/sandbox/workflow_module.go

@@ -20,6 +20,7 @@ import (
 	"go.starlark.net/starlarkstruct"
 
 	"chat-switchboard/store"
+	"chat-switchboard/workflow"
 )
 
 // BuildWorkflowModule creates the "workflow" Starlark module for a package.
@@ -30,6 +31,7 @@ func BuildWorkflowModule(ctx context.Context, stores store.Stores) *starlarkstru
 		"get_stage_data": starlark.NewBuiltin("workflow.get_stage_data", workflowGetStageData(ctx, stores)),
 		"advance":        starlark.NewBuiltin("workflow.advance", workflowAdvance(ctx, stores)),
 		"reject":         starlark.NewBuiltin("workflow.reject", workflowReject(ctx, stores)),
+		"route":          starlark.NewBuiltin("workflow.route", workflowRoute(ctx, stores)),
 	})
 }
 
@@ -129,7 +131,10 @@ func workflowAdvance(ctx context.Context, stores store.Stores) func(*starlark.Th
 			return starlark.None, fmt.Errorf("workflow.advance: %w", err)
 		}
 
-		nextStage := ws.CurrentStage + 1
+		nextStage, err := workflow.ResolveNextStage(stages, ws.CurrentStage, ws.StageData)
+		if err != nil {
+			return starlark.None, fmt.Errorf("workflow.advance: routing error: %w", err)
+		}
 		if nextStage >= len(stages) {
 			// Complete the workflow
 			if err := stores.Channels.CompleteWorkflow(ctx, channelID, ws.CurrentStage, ws.StageData); err != nil {
@@ -168,3 +173,44 @@ func workflowReject(ctx context.Context, stores store.Stores) func(*starlark.Thr
 		return starlark.String("rejected"), nil
 	}
 }
+
+// workflowRoute routes the workflow to a named stage (v0.35.0).
+// Starlark: workflow.route(channel_id, target_stage, reason)
+func workflowRoute(ctx context.Context, stores store.Stores) func(*starlark.Thread, *starlark.Builtin, starlark.Tuple, []starlark.Tuple) (starlark.Value, error) {
+	return func(_ *starlark.Thread, _ *starlark.Builtin, args starlark.Tuple, kwargs []starlark.Tuple) (starlark.Value, error) {
+		var channelID, targetStage, reason string
+		if err := starlark.UnpackPositionalArgs("workflow.route", args, kwargs, 3, &channelID, &targetStage, &reason); err != nil {
+			return nil, err
+		}
+
+		ws, err := stores.Channels.GetWorkflowStatus(ctx, channelID)
+		if err != nil || ws == nil || ws.WorkflowID == nil {
+			return starlark.None, fmt.Errorf("workflow.route: channel not found or not a workflow")
+		}
+		if ws.Status != "active" {
+			return starlark.None, fmt.Errorf("workflow.route: workflow is %s", ws.Status)
+		}
+
+		stages, err := stores.Workflows.ListStages(ctx, *ws.WorkflowID)
+		if err != nil {
+			return starlark.None, fmt.Errorf("workflow.route: %w", err)
+		}
+
+		targetOrdinal, err := workflow.ResolveStageByName(stages, targetStage)
+		if err != nil {
+			return starlark.None, fmt.Errorf("workflow.route: %w", err)
+		}
+
+		if targetOrdinal >= len(stages) {
+			if err := stores.Channels.CompleteWorkflow(ctx, channelID, targetOrdinal, ws.StageData); err != nil {
+				return starlark.None, fmt.Errorf("workflow.route: %w", err)
+			}
+			return starlark.String("completed"), nil
+		}
+
+		if err := stores.Channels.AdvanceWorkflowStage(ctx, channelID, targetOrdinal, ws.StageData); err != nil {
+			return starlark.None, fmt.Errorf("workflow.route: %w", err)
+		}
+		return starlark.String("routed"), nil
+	}
+}