feat(workflows): enhance track selection with question and options

refactor workflow templates to support structured track configuration with a question and options
update types and UI components to handle new tracks configuration
add conditional logic for research options in bmad workflow

Author: moazbuilds

src/cli/tui/app-shell.tsx

@@ -26,7 +26,7 @@ import { resolvePackageJson } from "../../shared/runtime/root.js"
 import { getSelectedTrack, setSelectedTrack, hasSelectedConditions, setSelectedConditions, getProjectName, setProjectName, getControllerAgents, initControllerAgent, loadControllerConfig } from "../../shared/workflows/index.js"
 import { loadTemplate } from "../../workflows/templates/loader.js"
 import { getTemplatePathFromTracking } from "../../shared/workflows/template.js"
-import type { TrackConfig, ConditionGroup } from "../../workflows/templates/types"
+import type { TracksConfig, ConditionGroup } from "../../workflows/templates/types"
 import type { AgentDefinition } from "../../shared/agents/config/types"
 import type { InitialToast } from "./app"
 
@@ -125,7 +125,7 @@ export function App(props: { initialToast?: InitialToast }) {
   let ctrlCTimeout: NodeJS.Timeout | null = null
   const [view, setView] = createSignal<"home" | "onboard" | "workflow">("home")
   const [workflowEventBus, setWorkflowEventBus] = createSignal<WorkflowEventBus | null>(null)
-  const [templateTracks, setTemplateTracks] = createSignal<Record<string, TrackConfig> | null>(null)
+  const [templateTracks, setTemplateTracks] = createSignal<TracksConfig | null>(null)
   const [templateConditionGroups, setTemplateConditionGroups] = createSignal<ConditionGroup[] | null>(null)
   const [initialProjectName, setInitialProjectName] = createSignal<string | null>(null)
   const [controllerAgents, setControllerAgents] = createSignal<AgentDefinition[] | null>(null)
@@ -151,7 +151,7 @@ export function App(props: { initialToast?: InitialToast }) {
       const conditionsSelected = await hasSelectedConditions(cmRoot)
       const existingProjectName = await getProjectName(cmRoot)
 
-      const hasTracks = template.tracks && Object.keys(template.tracks).length > 0
+      const hasTracks = template.tracks && Object.keys(template.tracks.options).length > 0
       const hasConditionGroups = template.conditionGroups && template.conditionGroups.length > 0
       const needsTrackSelection = hasTracks && !selectedTrack
       const needsConditionsSelection = hasConditionGroups && !conditionsSelected

src/cli/tui/routes/onboard/index.tsx

@@ -8,11 +8,11 @@
 import { createSignal, For, onMount, Show, createEffect, createMemo } from "solid-js"
 import { useKeyboard, useTerminalDimensions } from "@opentui/solid"
 import { useTheme } from "@tui/shared/context/theme"
-import type { TrackConfig, ConditionGroup, ConditionConfig } from "../../../../workflows/templates/types"
+import type { TracksConfig, ConditionGroup, ConditionConfig } from "../../../../workflows/templates/types"
 import type { AgentDefinition } from "../../../../shared/agents/config/types"
 
 export interface OnboardProps {
-  tracks?: Record<string, TrackConfig>
+  tracks?: TracksConfig
   conditionGroups?: ConditionGroup[]
   controllerAgents?: AgentDefinition[] // Available controller agents
   initialProjectName?: string | null // If set, skip project name input
@@ -50,7 +50,7 @@ export function Onboard(props: OnboardProps) {
   // Track selections within current group (for multi-select groups)
   const [currentGroupSelections, setCurrentGroupSelections] = createSignal<Set<string>>(new Set())
 
-  const hasTracks = () => props.tracks && Object.keys(props.tracks).length > 0
+  const hasTracks = () => props.tracks && Object.keys(props.tracks.options).length > 0
   const hasControllers = () => props.controllerAgents && props.controllerAgents.length > 0
 
   // Filter condition groups by selected track
@@ -90,10 +90,10 @@ export function Onboard(props: OnboardProps) {
   })
 
   const projectNameQuestion = "What is your project name?"
-  const trackQuestion = "What is your project size?"
+  const trackQuestion = () => props.tracks?.question ?? "Select a track:"
   const controllerQuestion = "Select a controller agent for autonomous mode:"
 
-  const trackEntries = () => props.tracks ? Object.entries(props.tracks) : []
+  const trackEntries = () => props.tracks ? Object.entries(props.tracks.options) : []
   const controllerEntries = () => props.controllerAgents ? props.controllerAgents.map(a => [a.id, a] as const) : []
 
   // Current condition entries (for group or child)
@@ -113,7 +113,7 @@ export function Onboard(props: OnboardProps) {
     const step = currentStep()
     switch (step) {
       case 'project_name': return projectNameQuestion
-      case 'tracks': return trackQuestion
+      case 'tracks': return trackQuestion()
       case 'condition_group': return currentGroup()?.question ?? ""
       case 'condition_child': return currentChildContext()?.question ?? ""
       case 'controller': return controllerQuestion

src/workflows/templates/types.ts

@@ -56,11 +56,16 @@ export function isModuleStep(step: WorkflowStep): step is ModuleStep {
   return step.type === 'module';
 }
 
-export interface TrackConfig {
+export interface TrackOption {
   label: string;
   description?: string;
 }
 
+export interface TracksConfig {
+  question: string;
+  options: Record<string, TrackOption>;
+}
+
 export interface ConditionConfig {
   label: string;
   description?: string;
@@ -85,7 +90,7 @@ export interface WorkflowTemplate {
   name: string;
   steps: WorkflowStep[];
   subAgentIds?: string[];
-  tracks?: Record<string, TrackConfig>;
+  tracks?: TracksConfig; // Track selection with question and options
   conditionGroups?: ConditionGroup[]; // Grouped conditions with optional nested children
   controller?: boolean; // Enables autonomous mode with controller agent selection
 }

templates/workflows/bmad.workflow.js

@@ -2,7 +2,41 @@ export default {
   name: 'BMAD Method',
   controller: true,
 
+  tracks: {
+    question: 'What is your project size? (only greenfield is tested)',
+    options: {
+      small: {
+        label: 'Small Project',
+        description: 'Quick start with minimal planning overhead'
+      },
+      medium: {
+        label: 'Medium Project',
+        description: 'Balanced approach with optional research phase'
+      },
+      enterprise: {
+        label: 'Enterprise Project',
+        description: 'Full methodology with comprehensive analysis'
+      },
+    },
+  },
+
   conditionGroups: [
+    {
+      id: 'research_options',
+      question: 'What research approach do you prefer?',
+      multiSelect: false,
+      tracks: ['medium', 'enterprise'], // Only show for medium/enterprise tracks
+      conditions: {
+        know_project: {
+          label: 'I know my project',
+          description: 'Skip research phase - I have clear requirements ready'
+        },
+        use_analyst: {
+          label: 'Use Analyst',
+          description: 'Let the analyst research and gather requirements'
+        },
+      },
+    },
     {
       id: 'features',
       question: 'What features does your project have?',
@@ -17,7 +51,7 @@ export default {
   ],
 
   steps: [
-    resolveStep('bmad-analyst', {engine: 'codex'}),
+    resolveStep('bmad-analyst', {engine: 'codex', conditions: ['use_analyst']}),
     resolveStep('bmad-pm', {engine: 'codex'}),
     resolveStep('bmad-ux', {engine: 'codex', conditions: ['has_ui']}),
     resolveStep('bmad-architect', {engine: 'codex'}),

templates/workflows/test.workflow.js

@@ -2,13 +2,16 @@ export default {
   name: 'Test Workflow',
   controller: true,
   tracks: {
-    quick: {
-      label: 'Small Project',
-      description: 'Fast iteration, minimal documentation'
-    },
-    bmad: {
-      label: 'Enterprise',
-      description: 'Full BMAD methodology with all phases'
+    question: 'What type of project workflow do you want?',
+    options: {
+      quick: {
+        label: 'Small Project',
+        description: 'Fast iteration, minimal documentation'
+      },
+      bmad: {
+        label: 'Enterprise',
+        description: 'Full BMAD methodology with all phases'
+      },
     },
   },
   conditionGroups: [