Add Coding Assistant selection step between Getting Started and Prerequisites

Insert a new wizard stage (Stage 1) where users choose their AI coding assistant
(Cursor, GitHub Copilot, VS Code — with CoDA and Genie Code as Coming Soon).
The selection is persisted in session_parameters JSONB and restored on session
load. Existing sessions with progress beyond this step are unaffected thanks to
the priority-based deriveWizardStage waterfall. Removes the old "Install Code
Assistant" prerequisite and its YouTube embed since the new dedicated section
replaces it.

Author: varunrao

src/App.tsx

@@ -70,6 +70,7 @@ export default function App() {
   const [completedSteps, setCompletedSteps] = useState<Set<number>>(new Set());
   const [skippedSteps, setSkippedSteps] = useState<Set<number>>(new Set());
   const [prerequisitesCompleted, setPrerequisitesCompleted] = useState(false);
+  const [codingAssistant, setCodingAssistant] = useState<string | null>(null);
   // Default to end-to-end which includes all chapters (complete workshop)
   const [workshopLevel, setWorkshopLevel] = useState<WorkshopLevel>('end-to-end');
   const [levelExplicitlySelected, setLevelExplicitlySelected] = useState(false);
@@ -203,6 +204,7 @@ export default function App() {
         setCustomDescription(sessionParams.custom_use_case_description || '');
         setLevelExplicitlySelected(!!sessionParams.level_explicitly_selected);
         setBrandUrl(sessionParams.company_brand_url || '');
+        setCodingAssistant(sessionParams.coding_assistant || null);
 
         // Find the next incomplete step using the actual section order for this workshop level
         const nextStep = getNextIncompleteStep(Array.from(restoredCompleted), skippedStepsArray, restoredLevel);
@@ -240,6 +242,7 @@ export default function App() {
       setCompletedSteps(new Set());
       setSkippedSteps(new Set());
       setPrerequisitesCompleted(false);
+      setCodingAssistant(null);
       setLevelExplicitlySelected(false);
       setUseCaseLockedLevel(null);
       setWorkshopLevel('end-to-end');
@@ -326,6 +329,7 @@ export default function App() {
         setCustomDescription(sessionParams.custom_use_case_description || '');
         setLevelExplicitlySelected(!!sessionParams.level_explicitly_selected);
         setBrandUrl(sessionParams.company_brand_url || '');
+        setCodingAssistant(sessionParams.coding_assistant || null);
 
         // Navigate to the next incomplete step using the actual section order
         const nextStep = getNextIncompleteStep(Array.from(loadedCompleted), loadedSkippedSteps, loadedLevel);
@@ -428,6 +432,17 @@ export default function App() {
     }
   }, [sessionId, workshopLevel]);
 
+  // Handle coding assistant selection
+  const handleCodingAssistantChange = useCallback((assistantId: string) => {
+    setCodingAssistant(assistantId);
+    if (sessionId) {
+      apiClient.updateSessionMetadata({
+        session_id: sessionId,
+        coding_assistant: assistantId,
+      }).catch(err => console.error('Error saving coding assistant:', err));
+    }
+  }, [sessionId]);
+
   const handleSaveSession = async (name: string, description: string, rating?: 'thumbs_up' | 'thumbs_down', comment?: string) => {
     if (!sessionId) return;
 
@@ -965,6 +980,8 @@ export default function App() {
                     initialExpandedStep={initialExpandedStep}
                     prerequisitesCompleted={prerequisitesCompleted}
                     onPrerequisitesComplete={handlePrerequisitesComplete}
+                    codingAssistant={codingAssistant}
+                    onCodingAssistantChange={handleCodingAssistantChange}
                     isSessionLoaded={!isSessionLoading}
                     currentUser={currentUser}
                     defaultCatalog={defaultCatalog}

src/api/client.ts

@@ -304,6 +304,7 @@ export interface UpdateSessionMetadataRequest {
   custom_use_case_description?: string;
   level_explicitly_selected?: boolean;
   company_brand_url?: string;
+  coding_assistant?: string;
 }
 
 export interface SessionListItem {

src/backend/api/routes.py

@@ -4462,6 +4462,7 @@ class SessionUpdateMetadataRequest(BaseModel):
     custom_use_case_description: Optional[str] = Field(None, description="User-edited use case description override")
     level_explicitly_selected: Optional[bool] = Field(None, description="Whether the user explicitly clicked a level button")
     company_brand_url: Optional[str] = Field(None, description="URL to company brand colors/assets page")
+    coding_assistant: Optional[str] = Field(None, description="Selected coding assistant: cursor, copilot, or vscode")
 
 
 @router.post("/session/update-metadata")
@@ -4518,6 +4519,8 @@ async def update_session_metadata_endpoint(request_body: SessionUpdateMetadataRe
             _session_param_patch['level_explicitly_selected'] = request_body.level_explicitly_selected
         if request_body.company_brand_url is not None:
             _session_param_patch['company_brand_url'] = request_body.company_brand_url
+        if request_body.coding_assistant is not None:
+            _session_param_patch['coding_assistant'] = request_body.coding_assistant
 
         # Derive user_schema_prefix from email + use case name (or source schema for accelerator)
         # Triggered when use case is selected, custom label is edited, or workshop_level changes

src/backend/prompts_config.yaml

@@ -107,28 +107,6 @@ use_cases:
 # -----------------------------------------------------------------------------
 prerequisites:
   - id: 1
-    title: "Install Code Assistant"
-    description: |
-      Install a code editor with AI-assisted coding capabilities.
-      
-      **Cursor:** A powerful AI-first code editor built on VS Code.
-      
-      **GitHub Copilot:** AI pair programmer that works with VS Code and other editors.
-    icon: "code"
-    icon_color: "blue"
-    is_optional: false
-    links:
-      - label: "Download Cursor"
-        url: "https://cursor.com"
-        color: "blue"
-      - label: "GitHub Copilot"
-        url: "https://github.com/features/copilot"
-        color: "purple"
-      - label: "VS Code (for Copilot)"
-        url: "https://code.visualstudio.com"
-        color: "green"
-
-  - id: 2
     title: "Install Package Manager"
     description: |
       **macOS:** Homebrew is required to install the tools below. If you already have it, run the upgrade command to ensure it is up to date.
@@ -158,7 +136,7 @@ prerequisites:
         url: "https://learn.microsoft.com/en-us/windows/package-manager/winget/"
         color: "blue"
 
-  - id: 3
+  - id: 2
     title: "Install Git"
     description: |
       Git is required for version control and cloning the workshop repository.
@@ -189,7 +167,7 @@ prerequisites:
         url: "https://git-scm.com/book/en/v2/Getting-Started-Installing-Git"
         color: "blue"
 
-  - id: 4
+  - id: 3
     title: "Install Python"
     description: |
       Python 3.8+ is required for the Databricks CLI and backend services.
@@ -224,7 +202,7 @@ prerequisites:
         url: "https://docs.databricks.com/en/dev-tools/cli/install.html#requirements"
         color: "green"
 
-  - id: 5
+  - id: 4
     title: "Install Databricks CLI"
     description: |
       The Databricks CLI is used for workspace management and deployment.
@@ -255,7 +233,7 @@ prerequisites:
         url: "https://docs.databricks.com/en/dev-tools/cli/index.html"
         color: "blue"
 
-  - id: 6
+  - id: 5
     title: "Install Node.js"
     description: |
       Node.js is required for building and running the frontend application.
@@ -291,7 +269,7 @@ prerequisites:
         url: "https://docs.npmjs.com/troubleshooting/common-errors"
         color: "orange"
 
-  - id: 7
+  - id: 6
     title: "(Optional) Access to Figma"
     description: "For Option B (Rich UI Design), you'll need access to Figma for creating polished UI designs. This is optional if you plan to use Option A (Basic UI with AI Coding Assistant)."
     icon: "figma"