wad-lab 1.2.2 → 1.2.3

package/bin/index.js

@@ -4,457 +4,407 @@ const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
 
-function copyDirRecursive(src, dest) {
-  if (typeof fs.cpSync === 'function') {
-    fs.cpSync(src, dest, { recursive: true });
-    return;
-  }
+// ============================================================================
+// WAD LAB TEMPLATES CLI - STRICT ASCII (ZERO EMOJIS)
+// ============================================================================
 
-  if (!fs.existsSync(dest)) {
-    fs.mkdirSync(dest, { recursive: true });
-  }
-
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-
-    if (entry.isDirectory()) {
-      copyDirRecursive(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-const frontendOptions = [
-  { name: 'all (Include all 10 Vue variants inside frontend/)', value: 'all' },
-  { name: 'vue-axios-basic (Vue 3 + Axios Direct CRUD)', value: 'vue-axios-basic' },
-  { name: 'vue-axios-props-emits (Vue 3 + Axios + Props & Emits)', value: 'vue-axios-props-emits' },
-  { name: 'vue-axios-router (Vue 3 + Axios + Router Views)', value: 'vue-axios-router' },
-  { name: 'vue-axios-pinia (Vue 3 + Axios + Pinia Centralized Store)', value: 'vue-axios-pinia' },
-  { name: 'vue-axios-router-props (Vue 3 + Axios + Router + Props/Emits)', value: 'vue-axios-router-props' },
-  { name: 'vue-axios-pinia-props (Vue 3 + Axios + Pinia + Props/Emits)', value: 'vue-axios-pinia-props' },
-  { name: 'vue-axios-router-pinia (Vue 3 + Axios + Router + Pinia)', value: 'vue-axios-router-pinia' },
-  { name: 'vue-axios-router-pinia-props (The Kitchen Sink — Router + Pinia + Props + Emits)', value: 'vue-axios-router-pinia-props' },
-  { name: 'vue-axios-router-children (Vue 3 + Axios + Router Nested Children)', value: 'vue-axios-router-children' },
-  { name: 'vue-axios-interceptor (Vue 3 + Axios Interceptors + Toast Alerts)', value: 'vue-axios-interceptor' }
-];
-
-const featuredTemplates = [
+const categories = [
   {
+    id: 'servlet',
     key: '1',
-    value: 'fullstack-springboot-vue',
-    name: '[1] fullstack-springboot-vue (Spring Boot 2-Model API + Selectable Vue Frontend)',
-    desc: 'Complete stack: 2-model Spring Boot backend + matching Vue frontend (Router/Pinia/Props)'
+    title: 'Java Servlets & Tomcat 9',
+    desc: '5 Classic Tomcat Servlets, JDBC, Sessions, Voter Eligibility & script.sh'
   },
   {
+    id: 'springboot',
     key: '2',
-    value: 'springboot-2model-1controller-api',
-    name: '[2] springboot-2model-1controller-api (2 Models Dept & Emp, 2 Repos, 1 Service)',
-    desc: 'Extensible 2-model Spring Boot architecture (Department + Employee) with full CRUD & PATCH'
+    title: 'Spring Boot Backend APIs',
+    desc: '10 Pure-Lombok REST APIs: CRUD, Aggregations, Join, 2-Model & MockMvc'
   },
   {
+    id: 'vue',
     key: '3',
-    value: 'springboot-mongo-aggregation-join',
-    name: '[3] springboot-mongo-aggregation-join ($lookup JOIN, @Query, @Aggregation)',
-    desc: 'MongoDB $lookup multi-collection JOIN, pipeline stages ($match/$group), and @Query filters'
+    title: 'Frontend (Vue 3)',
+    desc: '28 Modular Vue 3 Frontends: 2-Model CRUD+PATCH, Axios, Router & Pinia'
   },
   {
+    id: 'html-css',
     key: '4',
-    value: 'vue-axios-router-pinia-props',
-    name: '[4] vue-axios-router-pinia-props (Matching Frontend: Router + Pinia + Props/Emits)',
-    desc: 'Matching frontend for 2-model backend: Vue Router + Pinia centralized store + Props/Emits'
+    title: 'HTML5 & CSS3 Foundations',
+    desc: 'Form Validation, DOM Manipulation & 50 CSS Properties'
   },
   {
+    id: 'games',
     key: '5',
-    value: 'vue-axios-router-props',
-    name: '[5] vue-axios-router-props (Matching Frontend: Router Views + Props/Emits)',
-    desc: 'Matching frontend for 2-model backend: Vue Router pages + reusable components with Props/Emits'
-  },
-  {
-    key: '6',
-    value: 'servlet-jdbc',
-    name: '[6] servlet-jdbc (Tomcat 9 + MySQL Database Connection via JDBC)',
-    desc: 'Tomcat Servlet with MySQL Driver, JDBC connection, SQL statement execution, and HTML table'
-  },
-  {
-    key: '7',
-    value: 'servlet-flow',
-    name: '[7] servlet-flow (Tomcat 9 Execution Flow with GET/POST Form — No DB)',
-    desc: 'Pure servlet without DB: HTML form submission, doGet / doPost processing, and response render'
+    title: 'Interactive Browser Games',
+    desc: '9 Web Games: Bingo, Tic-Tac-Toe, RPS, Whack-a-Mole, Memory'
   }
 ];
 
-const categories = [
-  {
-    id: 'fullstack',
-    title: 'Fullstack Web Applications',
-    desc: 'Integrated Spring Boot + MongoDB + Vue 3 apps'
-  },
+const templates = [
+  // 1. Java Servlets (5)
   {
-    id: 'springboot',
-    title: 'Spring Boot Backend APIs',
-    desc: 'REST APIs, MongoDB, Aggregations, Join & MockMvc'
+    category: 'servlet',
+    value: 'servlet-basic',
+    name: 'servlet-basic (Basic GET/POST Servlet + Form)',
+    desc: 'Classic doGet / doPost request processing with HTML form submission and Tomcat script.sh'
   },
   {
-    id: 'servlet',
-    title: 'Java Servlets & Tomcat 9',
-    desc: 'Classic Tomcat Servlets, JDBC, Sessions & Web.xml'
+    category: 'servlet',
+    value: 'servlet-flow',
+    name: 'servlet-flow (RequestDispatcher Forward & Include Flow - No DB)',
+    desc: 'Request dispatching between servlets, forward/include execution flow, and Tomcat script.sh'
   },
   {
-    id: 'vue-axios',
-    title: 'Vue 3 + Axios HTTP Variants',
-    desc: 'All 10+ architectural combinations of Vue 3 with Axios'
+    category: 'servlet',
+    value: 'servlet-jdbc',
+    name: 'servlet-jdbc (Tomcat 9 + MySQL JDBC Connection & CRUD)',
+    desc: 'Servlet with MySQL Driver, JDBC connection, SQL statement execution, HTML table and script.sh'
   },
   {
-    id: 'vue-core',
-    title: 'Vue 3 Core Portals & State',
-    desc: 'Router, Pinia, Native Fetch & Complete UI Portals'
+    category: 'servlet',
+    value: 'servlet-session-tracking',
+    name: 'servlet-session-tracking (HttpSession, Cookies, URL Rewriting, Hidden Fields)',
+    desc: 'All 4 session tracking mechanisms in Java Servlets with Tomcat script.sh'
   },
   {
-    id: 'games',
-    title: 'Interactive Games (JS & Vue)',
-    desc: 'Logic, DOM & State Management Games'
+    category: 'servlet',
+    value: 'servlet-voter-eligibility',
+    name: 'servlet-voter-eligibility (Form Validation & Age Check Logic)',
+    desc: 'Server-side input validation, voter eligibility verification, and Tomcat script.sh'
   },
-  {
-    id: 'html-css',
-    title: 'HTML5 & CSS3 Foundations',
-    desc: 'Form Validation, DOM Manipulation & 50 CSS Properties'
-  }
-];
 
-const templates = [
-  // Fullstack (4)
-  {
-    category: 'fullstack',
-    value: 'fullstack-springboot-vue',
-    name: 'fullstack-springboot-vue (Spring Boot 2-Model API + Selectable Vue 3 Frontend)'
-  },
-  {
-    category: 'fullstack',
-    value: 'vue-springboot-mongo-crud',
-    name: 'vue-springboot-mongo-crud (Spring Boot + MongoDB + Vue 3 Direct CRUD)'
-  },
+  // 2. Spring Boot Backends (10)
   {
-    category: 'fullstack',
-    value: 'vue-springboot-mongo-aggregation',
-    name: 'vue-springboot-mongo-aggregation (Spring Boot Aggregation + Vue 3 Dashboard)'
+    category: 'springboot',
+    value: 'springboot-2model-aggregation-join',
+    name: 'springboot-2model-aggregation-join (Department + Employee, CRUD + PATCH, $lookup Join, $group Stats)',
+    desc: 'Pure Lombok (@Data, @NoArgsConstructor, @AllArgsConstructor), @Autowired injection, CRUD+PATCH, $lookup join & stats'
   },
   {
-    category: 'fullstack',
-    value: 'vue-router-pinia-springboot',
-    name: 'vue-router-pinia-springboot (Fullstack Enterprise: Router + Pinia + Spring Boot)'
+    category: 'springboot',
+    value: 'springboot-2model-1controller-api',
+    name: 'springboot-2model-1controller-api (Department + Employee REST API, 2 Repos, 1 Controller)',
+    desc: 'Spring Boot 2-model REST API with Department and Employee endpoints in a unified controller'
   },
-
-  // Spring Boot (9)
   {
     category: 'springboot',
-    value: 'springboot-mongo-crud',
-    name: 'springboot-mongo-crud (4-Layer REST API: Controller -> Service -> Repo -> Mongo)'
+    value: 'springboot-mongo-aggregation-join',
+    name: 'springboot-mongo-aggregation-join (Customer + Order, $lookup Join Pipeline)',
+    desc: 'Order and Customer MongoDB aggregation join using $lookup, $unwind, and projected DTO'
   },
   {
     category: 'springboot',
     value: 'springboot-mongo-aggregation',
-    name: 'springboot-mongo-aggregation (Aggregation Pipeline: $group, $sum, $avg, $sort)'
+    name: 'springboot-mongo-aggregation (Standalone Pipeline: $group, $sum, $avg, $sort)',
+    desc: 'Single collection aggregation analytics with MongoTemplate and aggregation stages'
   },
   {
     category: 'springboot',
-    value: 'springboot-mongo-aggregation-join',
-    name: 'springboot-mongo-aggregation-join (MongoDB $lookup JOIN, @Query, @Aggregation)'
+    value: 'springboot-mongo-crud',
+    name: 'springboot-mongo-crud (4-Layer REST API: Controller -> Service -> Repo -> Mongo)',
+    desc: 'Standard MongoRepository CRUD starter with clean layers and full HTTP methods'
   },
   {
     category: 'springboot',
     value: 'springboot-mockmvc',
-    name: 'springboot-mockmvc (Controller Unit Testing with MockMvc)'
+    name: 'springboot-mockmvc (Controller Tests with MockMvc, Mockito & AssertJ)',
+    desc: 'Unit and integration testing for Spring Boot REST endpoints using MockMvc'
   },
   {
     category: 'springboot',
     value: 'springboot-mongo-aggregation-mockmvc',
-    name: 'springboot-mongo-aggregation-mockmvc (Full Testing Lab: MockMvc + Aggregation)'
-  },
-  {
-    category: 'springboot',
-    value: 'springboot-2model-1controller-api',
-    name: 'springboot-2model-1controller-api (2 Models Dept & Emp, 2 Repos, 1 Service, 1 Controller)'
+    name: 'springboot-mongo-aggregation-mockmvc (Aggregation Controller Covered by MockMvc Tests)',
+    desc: 'MongoDB aggregation API with complete test suite covering pipelines and projections'
   },
   {
     category: 'springboot',
     value: 'springboot-course-registration',
-    name: 'springboot-course-registration (Exercise 5 — Course Registration REST API)'
+    name: 'springboot-course-registration (Student & Course Enrollment REST API)',
+    desc: 'Domain REST API for university student registration, courses, and enrollments'
   },
   {
     category: 'springboot',
     value: 'springboot-hospital-api',
-    name: 'springboot-hospital-api (Hospital OPD Appointments & Doctors API)'
+    name: 'springboot-hospital-api (Doctor & Patient Appointment Scheduling API)',
+    desc: 'Domain REST API for hospital appointment booking and patient record management'
   },
   {
     category: 'springboot',
     value: 'springboot-library-api',
-    name: 'springboot-library-api (Library Catalog, Loans & Analytics API)'
+    name: 'springboot-library-api (Book Catalog & Borrowing Transaction API)',
+    desc: 'Domain REST API for book lending, borrowing tracking, and member management'
   },
 
-  // Servlets (5)
+  // 3. Frontend (Vue 3) (28)
   {
-    category: 'servlet',
-    value: 'servlet-basic',
-    name: 'servlet-basic (Tomcat GET + POST Basic Servlet)'
+    category: 'vue',
+    value: 'vue-2model-crud-patch',
+    name: 'vue-2model-crud-patch (2-Model Modular UI: Department & Employee, CRUD + PATCH + Join)',
+    desc: 'Vite + Vue 3 + Pinia + Router: Modular components (Tables, FormModals, PatchModals, AnalyticsBoard)'
   },
   {
-    category: 'servlet',
-    value: 'servlet-flow',
-    name: 'servlet-flow (HelloServlet Execution Flow with GET/POST Form)'
+    category: 'vue',
+    value: 'vue-axios-router-pinia-props',
+    name: 'vue-axios-router-pinia-props (Full Enterprise: Router + Pinia + Axios + Props/Emits)',
+    desc: 'Complete standard stack with multi-view routes, Pinia store, and modular child components'
   },
   {
-    category: 'servlet',
-    value: 'servlet-jdbc',
-    name: 'servlet-jdbc (Tomcat + MySQL JDBC Database Connection)'
+    category: 'vue',
+    value: 'vue-axios-router-props',
+    name: 'vue-axios-router-props (Router Navigation + Modular Child Components with Props/Emits)',
+    desc: 'Multi-page routing passing state down via props and events up via emits'
   },
   {
-    category: 'servlet',
-    value: 'servlet-session-tracking',
-    name: 'servlet-session-tracking (HttpSession, Cookies, Redirect & URL Rewriting)'
+    category: 'vue',
+    value: 'vue-axios-pinia-props',
+    name: 'vue-axios-pinia-props (Pinia Store Passed Down to Child Components via Props)',
+    desc: 'Central store feeding child component sections with props and actions'
   },
   {
-    category: 'servlet',
-    value: 'servlet-voter-eligibility',
-    name: 'servlet-voter-eligibility (Voting Eligibility Check: Name & Age Validation)'
+    category: 'vue',
+    value: 'vue-axios-props-emits',
+    name: 'vue-axios-props-emits (Component Hierarchy: Form & List with Props Down and Emits Up)',
+    desc: 'Clean component isolation communicating purely via props and emit events'
   },
-
-  // Vue + Axios (11)
   {
-    category: 'vue-axios',
+    category: 'vue',
     value: 'vue-axios-basic',
-    name: 'vue-axios-basic (Vue 3 + Axios Direct CRUD in Single View)'
+    name: 'vue-axios-basic (Direct Axios CRUD with Modular Table, Form & Patch Modals)',
+    desc: 'Modular Vue 3 component CRUD with Axios HTTP client and partial PATCH modal'
   },
   {
-    category: 'vue-axios-props-emits',
-    value: 'vue-axios-props-emits',
-    name: 'vue-axios-props-emits (Vue 3 + Axios + Parent/Child Props & Emits)'
+    category: 'vue',
+    value: 'vue-axios',
+    name: 'vue-axios (Service-Layer Axios CRUD with Modular Components & PATCH)',
+    desc: 'ItemService abstraction layer with modular table and patch dialog'
   },
   {
-    category: 'vue-axios-router',
-    value: 'vue-axios-router',
-    name: 'vue-axios-router (Vue 3 + Axios + Router Views Dashboard & Details)'
+    category: 'vue',
+    value: 'vue-axios-interceptor',
+    name: 'vue-axios-interceptor (Axios Request/Response Interceptors + Toast Notifications)',
+    desc: 'Global HTTP error catching, loading spinners, and toast alerts'
   },
   {
-    category: 'vue-axios-pinia',
+    category: 'vue',
     value: 'vue-axios-pinia',
-    name: 'vue-axios-pinia (Vue 3 + Axios + Pinia Centralized State Store)'
+    name: 'vue-axios-pinia (Pinia Store with Axios HTTP Actions & Stats)',
+    desc: 'Centralized state store managing async CRUD requests with stats component'
   },
   {
-    category: 'vue-axios-router-props',
-    value: 'vue-axios-router-props',
-    name: 'vue-axios-router-props (Vue 3 + Axios + Router + Component Props/Emits)'
-  },
-  {
-    category: 'vue-axios-pinia-props',
-    value: 'vue-axios-pinia-props',
-    name: 'vue-axios-pinia-props (Vue 3 + Axios + Pinia Store + Props/Emits)'
-  },
-  {
-    category: 'vue-axios-router-pinia',
-    value: 'vue-axios-router-pinia',
-    name: 'vue-axios-router-pinia (Vue 3 + Axios + Router Views + Pinia Store)'
-  },
-  {
-    category: 'vue-axios-router-pinia-props',
-    value: 'vue-axios-router-pinia-props',
-    name: 'vue-axios-router-pinia-props (The Complete Stack: Router + Pinia + Props + Emits)'
+    category: 'vue',
+    value: 'vue-axios-router',
+    name: 'vue-axios-router (Vue Router Multi-View Navigation + Axios API)',
+    desc: 'Page views with navigation bar and modular table/form components'
   },
   {
-    category: 'vue-axios-router-children',
+    category: 'vue',
     value: 'vue-axios-router-children',
-    name: 'vue-axios-router-children (Vue 3 + Axios + Router Nested Children Layouts)'
+    name: 'vue-axios-router-children (Nested Routes: Sidebar + Child Detail Views)',
+    desc: 'Nested <router-view> routes with sidebar navigation and detail components'
   },
   {
-    category: 'vue-axios-interceptor',
-    value: 'vue-axios-interceptor',
-    name: 'vue-axios-interceptor (Vue 3 + Axios Interceptors + Toast Notifications)'
-  },
-  {
-    category: 'vue-axios',
-    value: 'vue-axios',
-    name: 'vue-axios (Classic Vue 3 Axios Service Layer CRUD)'
+    category: 'vue',
+    value: 'vue-axios-router-pinia',
+    name: 'vue-axios-router-pinia (Standard SPA: Router + Pinia + Axios Service + PATCH)',
+    desc: 'Full SPA architecture with modular tables, modals, and patch actions'
   },
-
-  // Vue Core & Portals (16)
   {
-    category: 'vue-core',
+    category: 'vue',
     value: 'vue-basics',
-    name: 'vue-basics (Core Reactivity: ref, reactive, computed, v-model, watch)'
+    name: 'vue-basics (Template Syntax, v-model, CounterCard, UserForm & ItemList)',
+    desc: 'Core Vue 3 reactivity and directives divided into modular components'
   },
   {
-    category: 'vue-props-emits',
+    category: 'vue',
     value: 'vue-props-emits',
-    name: 'vue-props-emits (Parent/Child Component Communication & Custom Events)'
+    name: 'vue-props-emits (Pure Component Communication: ItemCard & ItemForm)',
+    desc: 'Parent-child communication without Axios or external libraries'
   },
   {
-    category: 'vue-router',
+    category: 'vue',
     value: 'vue-router',
-    name: 'vue-router (Vue Router Parent Layout & Nested Children)'
+    name: 'vue-router (Vue Router 4 Setup: NavBar, HomeHero & ItemsLayout)',
+    desc: 'Clean routing configuration with modular view components'
   },
   {
-    category: 'vue-pinia',
+    category: 'vue',
     value: 'vue-pinia',
-    name: 'vue-pinia (Pinia State Store: State, Getters, Actions)'
+    name: 'vue-pinia (Pinia State Management: ItemForm, ItemList & State Actions)',
+    desc: 'Reactive store getters, actions, and state modifications'
   },
   {
-    category: 'vue-router-pinia',
+    category: 'vue',
     value: 'vue-router-pinia',
-    name: 'vue-router-pinia (Router Multi-Page Views + Pinia Store)'
+    name: 'vue-router-pinia (Router + Pinia: NavBar, Store Table & Modal Dialogs)',
+    desc: 'Integration of routing and global state without external HTTP'
   },
   {
-    category: 'vue-router-pinia-props',
+    category: 'vue',
     value: 'vue-router-pinia-props',
-    name: 'vue-router-pinia-props (Router + Pinia Store + Component Props/Emits)'
+    name: 'vue-router-pinia-props (Router + Pinia + Child Props/Emits Architecture)',
+    desc: 'Hybrid architecture combining global store with prop-driven child components'
   },
   {
-    category: 'vue-fetch',
+    category: 'vue',
     value: 'vue-fetch',
-    name: 'vue-fetch (Native Fetch API CRUD without Axios)'
+    name: 'vue-fetch (Native fetch() API with Modular Table, Form & Patch Modals)',
+    desc: 'Native browser fetch without Axios dependency, modular components included'
   },
   {
-    category: 'vue-todo-pinia',
-    value: 'vue-todo-pinia',
-    name: 'vue-todo-pinia (Pinia Task & Todo Manager)'
+    category: 'vue',
+    value: 'vue-banking-app',
+    name: 'vue-banking-app (Account Overview, Transaction Form & History Table)',
+    desc: 'Banking UI with deposit, withdrawal, transaction ledger, and balance tracking'
   },
   {
-    category: 'vue-todo-router',
-    value: 'vue-todo-router',
-    name: 'vue-todo-router (Router Multi-View Task Application)'
+    category: 'vue',
+    value: 'vue-cart-router-pinia',
+    name: 'vue-cart-router-pinia (E-Commerce Cart: Products, Cart Drawer & Badge)',
+    desc: 'Shopping cart with product listing, quantity updates, and cart calculations'
   },
   {
-    category: 'vue-cart-router-pinia',
-    value: 'vue-cart-router-pinia',
-    name: 'vue-cart-router-pinia (E-Commerce Shopping Cart with Router & Pinia)'
+    category: 'vue',
+    value: 'vue-employee-system',
+    name: 'vue-employee-system (Employee Directory: Department Filter & Modal)',
+    desc: 'Staff management with department filtering, payroll calculator, and modals'
   },
   {
-    category: 'vue-food-ordering',
+    category: 'vue',
     value: 'vue-food-ordering',
-    name: 'vue-food-ordering (Exercise 7 — Online Food Ordering Application)'
+    name: 'vue-food-ordering (Restaurant App: Food Menu, Cart Summary & Order Modal)',
+    desc: 'Menu catalog with category filters, cart tally, tax computation, and checkout'
+  },
+  {
+    category: 'vue',
+    value: 'vue-hospital-portal',
+    name: 'vue-hospital-portal (Healthcare Portal: Doctor Cards, Admissions & Patients)',
+    desc: 'Patient admission portal with vitals scoring, doctor bookings, and discharge'
+  },
+  {
+    category: 'vue',
+    value: 'vue-library-system',
+    name: 'vue-library-system (Library Catalog: Book Table, Inventory Form & Borrow Modal)',
+    desc: 'Book catalog with borrowing records, due date tracking, and fine calculation'
   },
   {
-    category: 'vue-symposium-system',
+    category: 'vue',
     value: 'vue-symposium-system',
-    name: 'vue-symposium-system (Exercise 6 — College Symposium Management System)'
+    name: 'vue-symposium-system (Event Manager: Event Cards, Registration & Attendees)',
+    desc: 'College symposium event registration and attendee roster tracking'
   },
   {
-    category: 'vue-banking-app',
-    value: 'vue-banking-app',
-    name: 'vue-banking-app (Banking Portal & Transaction Ledger System)'
+    category: 'vue',
+    value: 'vue-todo-pinia',
+    name: 'vue-todo-pinia (Task Manager: Todo Input, Filter Controls & List)',
+    desc: 'Todo tracker with Pinia actions, completion toggles, and badge counters'
   },
   {
-    category: 'vue-employee-system',
-    value: 'vue-employee-system',
-    name: 'vue-employee-system (Employee HR, Payroll & Records System)'
+    category: 'vue',
+    value: 'vue-todo-router',
+    name: 'vue-todo-router (Multi-Page Todo: Todo NavBar, Task List & Form View)',
+    desc: 'Multi-route todo manager with parameter passing and task creation'
   },
+
+  // 4. HTML5 & CSS3 Foundations (2)
   {
-    category: 'vue-hospital-portal',
-    value: 'vue-hospital-portal',
-    name: 'vue-hospital-portal (Hospital OPD & Patient Vitals Portal)'
+    category: 'html-css',
+    value: 'html-css-js',
+    name: 'html-css-js (HTML5 Semantic Layout, Form Validation & DOM Manipulation)',
+    desc: 'Pure vanilla web fundamentals with modern semantic HTML, CSS Flexbox/Grid, and JS validation'
   },
   {
-    category: 'vue-library-system',
-    value: 'vue-library-system',
-    name: 'vue-library-system (Library Catalog & Book Circulation System)'
+    category: 'html-css',
+    value: 'html-css-styles',
+    name: 'html-css-styles (50 Core CSS Properties Showcase & Playground)',
+    desc: '50 CSS properties reference: Flexbox, CSS Grid, Transitions, Keyframe Animations & Shadows'
   },
 
-  // Games (9)
+  // 5. Interactive Browser Games (9)
   {
     category: 'games',
     value: 'game-bingo',
-    name: 'game-bingo (Exercise 3 — Two-Player JavaScript Bingo Game)'
+    name: 'game-bingo (5x5 Randomized Bingo Grid with Win-Line Detection)',
+    desc: 'Classic 5x5 Bingo board with random number draw and winning line checks'
   },
   {
     category: 'games',
-    value: 'game-rock-paper-scissors',
-    name: 'game-rock-paper-scissors (Player vs Computer Rock Paper Scissors — Vanilla JS)'
+    value: 'game-memory-cards',
+    name: 'game-memory-cards (Card-Flip Pattern Matching Game in Vanilla JS)',
+    desc: 'Memory card matching with flip animations, move count, and match detection'
   },
   {
     category: 'games',
-    value: 'game-tic-tac-toe',
-    name: 'game-tic-tac-toe (3x3 Turn Grid with Win Detection — Vanilla JS)'
+    value: 'game-rock-paper-scissors',
+    name: 'game-rock-paper-scissors (Classic Rock-Paper-Scissors with Score Tracker)',
+    desc: 'RPS game against computer AI with streak counting and score history'
   },
   {
     category: 'games',
-    value: 'game-whack-a-mole',
-    name: 'game-whack-a-mole (3x3 Mole Whack with Timer & Score — Vanilla JS)'
+    value: 'game-tic-tac-toe',
+    name: 'game-tic-tac-toe (2-Player Turn-Based Tic-Tac-Toe with Win Logic)',
+    desc: 'Classic 3x3 grid with turn toggling, win condition scanning, and reset'
   },
   {
     category: 'games',
-    value: 'game-memory-cards',
-    name: 'game-memory-cards (3x4 Flashcard Matching Game — Vanilla JS)'
+    value: 'game-whack-a-mole',
+    name: 'game-whack-a-mole (Timed Click-Reaction Game with Score Counter)',
+    desc: 'Reaction game with randomized mole pops, timer countdown, and high scores'
   },
   {
     category: 'games',
     value: 'vue-game-rps',
-    name: 'vue-game-rps (Rock Paper Scissors with Vue 3 + Pinia Scoreboard)'
+    name: 'vue-game-rps (Vue 3 Rock-Paper-Scissors with Reactive Scoreboard)',
+    desc: 'Vue 3 reactive game with computer AI choice and round history'
   },
   {
     category: 'games',
     value: 'vue-game-tictactoe',
-    name: 'vue-game-tictactoe (Tic Tac Toe with Vue 3 + Pinia Move History)'
+    name: 'vue-game-tictactoe (Vue 3 Reactive Tic-Tac-Toe with Board State)',
+    desc: 'Vue 3 component game with computed winning lines and reset action'
   },
   {
     category: 'games',
     value: 'vue-game-whackamole',
-    name: 'vue-game-whackamole (Whack-A-Mole with Vue 3 + Pinia Countdown)'
+    name: 'vue-game-whackamole (Vue 3 Whack-a-Mole with Reactive Timer & Score)',
+    desc: 'Vue 3 reactive game loop with timer interval and hit detection'
   },
   {
     category: 'games',
     value: 'vue-memory-game',
-    name: 'vue-memory-game (Card Matching Game with Vue 3 + Pinia Flips)'
-  },
-
-  // HTML / CSS (2)
-  {
-    category: 'html-css',
-    value: 'html-css-js',
-    name: 'html-css-js (Form Validation Regex, Required & Dynamic DOM)'
-  },
-  {
-    category: 'html-css',
-    value: 'html-css-styles',
-    name: 'html-css-styles (50 CSS Properties Showcase: Box Model, Flex, Grid, Animations)'
+    name: 'vue-memory-game (Vue 3 Card Match Game with Pinia State Store)',
+    desc: 'Vue 3 memory card flip game backed by Pinia store actions and timers'
   }
 ];
 
-const PAGE_SIZE = 12;
 const templatesRoot = path.join(__dirname, '..', 'templates');
 
-let currentView = 'MAIN'; // 'MAIN' | 'CATEGORY_LIST' | 'CATEGORY' | 'SEARCH' | 'ALL'
+let currentView = 'MAIN'; // 'MAIN' | 'CATEGORY' | 'SEARCH' | 'ALL'
 let activeCategory = null;
 let searchQuery = '';
 let selectedIndex = 0;
 const selectedValues = new Set();
 let isPrompting = false;
 
+// ============================================================================
+// MULTI-WORD SEARCH & ACTIVE ITEM RETRIEVAL
+// ============================================================================
+
 function getActiveItemList() {
   if (currentView === 'MAIN') {
-    const list = featuredTemplates.map(f => ({
-      type: 'featured',
-      id: f.value,
-      name: f.name,
-      desc: f.desc
-    }));
-    list.push({ type: 'action', id: 'categories', name: '[C] Browse by Category (7 Groups, 56 Templates)', desc: 'Explore all 56 templates categorized into 7 groups' });
-    list.push({ type: 'action', id: 'search', name: '[S] Search by keyword across all 56 templates', desc: 'Type any keyword to find templates instantly' });
-    list.push({ type: 'action', id: 'all_view', name: '[L] View all 56 templates (grouped catalog)', desc: 'Browse the entire catalog with section dividers' });
-    list.push({ type: 'action', id: 'unpack_all', name: '[A] Unpack all 56 templates in 1-click', desc: 'Copy every single template into target folder' });
-    return list;
-  }
-
-  if (currentView === 'CATEGORY_LIST') {
-    return categories.map((cat, idx) => {
+    const list = categories.map((cat, idx) => {
       const count = templates.filter(t => t.category === cat.id).length;
       return {
-        type: 'cat_entry',
+        type: 'category',
         id: cat.id,
+        key: String(idx + 1),
         name: `[${idx + 1}] ${cat.title} (${count} templates)`,
         desc: cat.desc
       };
     });
+    list.push({ type: 'action', id: 'search', key: 'S', name: '[S] Search Templates (Supports multi-word: e.g. "mongo join")', desc: 'Search across all templates with multiple keywords' });
+    list.push({ type: 'action', id: 'unpack_all', key: 'A', name: '[A] Unpack All 58 Templates in 1-Click', desc: 'Extract the entire catalog into target directory' });
+    return list;
   }
 
   if (currentView === 'CATEGORY') {
@@ -464,11 +414,12 @@ function getActiveItemList() {
   if (currentView === 'SEARCH') {
     const q = searchQuery.toLowerCase().trim();
     if (!q) return [];
-    return templates.filter(t =>
-      t.value.toLowerCase().includes(q) ||
-      t.name.toLowerCase().includes(q) ||
-      t.category.toLowerCase().includes(q)
-    );
+    // Tokenized multi-word search
+    const tokens = q.split(/\s+/).filter(Boolean);
+    return templates.filter(t => {
+      const text = (t.value + ' ' + t.name + ' ' + (t.desc || '') + ' ' + t.category).toLowerCase();
+      return tokens.every(token => text.includes(token));
+    });
   }
 
   if (currentView === 'ALL') {
@@ -478,46 +429,21 @@ function getActiveItemList() {
   return [];
 }
 
+// ============================================================================
+// TERMINAL SCREEN RENDERING (ZERO EMOJIS)
+// ============================================================================
+
 function renderScreen() {
   console.clear();
 
   if (currentView === 'MAIN') {
     console.log('========================================================');
-    console.log('              WAD LAB STARTER TEMPLATES                 ');
-    console.log('         Exam Quick-Start & 56 Ready Templates          ');
+    console.log('              WAD LAB TEMPLATES CLI                     ');
+    console.log('        54 Clean Starter Templates + Tomcat Deploy      ');
     console.log('========================================================\n');
-    console.log('CORE EXAM STARTERS:');
-    console.log('  Press [1-7] for instant pick, or navigate with [UP / DOWN]');
-    console.log('  [SPACE] Select | [ENTER] Confirm | [C] Categories | [S] Search | [A] All\n');
-
-    const items = getActiveItemList();
-    items.forEach((item, idx) => {
-      if (item.id === 'categories') {
-        console.log('\nFULL CATALOG & EXPLORATION:');
-      }
-      const isCursor = idx === selectedIndex;
-      const isChecked = selectedValues.has(item.id);
-      const box = item.type === 'featured' ? (isChecked ? '[x] ' : '[ ] ') : '';
-      const prefix = isCursor ? ' > ' : '   ';
-      console.log(prefix + box + item.name);
-    });
-
-    const activeItem = items[selectedIndex];
-    if (activeItem && activeItem.desc) {
-      console.log('\n  Info: ' + activeItem.desc);
-    }
-    if (selectedValues.size > 0) {
-      console.log(`\n  Selected: ${selectedValues.size} template(s) [Press ENTER to proceed]`);
-    }
-    return;
-  }
-
-  if (currentView === 'CATEGORY_LIST') {
-    console.log('========================================================');
-    console.log('  Browse Templates by Category (56 Total)');
-    console.log('========================================================\n');
-    console.log('  Press [1-7] or [ENTER] to open category');
-    console.log('  [B / ESC] Back to Main Menu\n');
+    console.log('MAIN MENU:');
+    console.log('  Press [1-5] to open category, [S] to Search, [A] for All');
+    console.log('  Navigate with [UP / DOWN], [ENTER] to confirm\n');
 
     const items = getActiveItemList();
     items.forEach((item, idx) => {
@@ -530,279 +456,216 @@ function renderScreen() {
     if (activeItem && activeItem.desc) {
       console.log('\n  Info: ' + activeItem.desc);
     }
+    console.log('\n  [1] Servlets | [2] Spring Boot | [3] Vue 3 | [4] HTML/CSS | [5] Games | [S] Search | [Q] Quit');
     return;
   }
 
   if (currentView === 'CATEGORY') {
+    const items = getActiveItemList();
     console.log('========================================================');
-    console.log(`  ${activeCategory.title}`);
-    console.log(`  ${activeCategory.desc}`);
+    console.log(`  ${activeCategory.title} (${items.length} templates)`);
     console.log('========================================================\n');
-    console.log('  [SPACE] Select / Deselect (multi-select supported)');
-    console.log('  [ENTER] Confirm selection and proceed');
-    console.log('  [B / ESC] Back to Categories Menu\n');
+    console.log('  [SPACE] Select | [ENTER] Unpack | [B / ESC] Back to Main Menu\n');
 
-    const items = getActiveItemList();
+    const PAGE_SIZE = 12;
     const total = items.length;
-
     let start = selectedIndex - Math.floor(PAGE_SIZE / 2);
     if (start < 0) start = 0;
-    if (start + PAGE_SIZE > total) {
-      start = Math.max(0, total - PAGE_SIZE);
-    }
-    const end = Math.min(start + PAGE_SIZE, total);
+    if (start + PAGE_SIZE > total) start = Math.max(0, total - PAGE_SIZE);
+    const visibleItems = items.slice(start, start + PAGE_SIZE);
 
-    if (start > 0) {
-      console.log(`     ^ (${start} more above)`);
-    }
+    if (start > 0) console.log('    ... (scroll up)');
 
-    for (let i = start; i < end; i++) {
-      const t = items[i];
-      const isCursor = i === selectedIndex;
+    visibleItems.forEach((t, i) => {
+      const realIndex = start + i;
+      const isCursor = realIndex === selectedIndex;
       const isChecked = selectedValues.has(t.value);
-      const box = isChecked ? '[x]' : '[ ]';
+      const box = isChecked ? '[x] ' : '[ ] ';
       const prefix = isCursor ? ' > ' : '   ';
-      console.log(prefix + box + ' ' + t.name);
-    }
+      console.log(prefix + box + `[${realIndex + 1}] ` + t.name);
+    });
 
-    if (end < total) {
-      console.log(`     v (${total - end} more below)`);
-    }
+    if (start + PAGE_SIZE < total) console.log('    ... (scroll down)');
 
-    const selCount = selectedValues.size;
-    console.log(`\n  Selected: ${selCount} template(s) [${selectedIndex + 1}/${total}]`);
+    const activeItem = items[selectedIndex];
+    if (activeItem && activeItem.desc) {
+      console.log('\n  Info: ' + activeItem.desc);
+    }
+    if (selectedValues.size > 0) {
+      console.log(`\n  Selected: ${selectedValues.size} template(s) [Press ENTER to proceed]`);
+    }
     return;
   }
 
   if (currentView === 'SEARCH') {
     console.log('========================================================');
-    console.log('  Instant Template Search');
-    console.log('========================================================');
-    console.log(`  Query: "${searchQuery}" (type letters/numbers, Backspace to delete)`);
-    console.log('  [SPACE] Select | [ENTER] Confirm | [ESC] Back\n');
+    console.log('  Multi-Word Template Search');
+    console.log('========================================================\n');
+    console.log(`  Query: "${searchQuery}" (Supports multi-word: e.g. "mongo join", "servlet jdbc")`);
+    console.log('  [SPACE] Select | [ENTER] Unpack | [ESC] Back to Main Menu\n');
 
     const items = getActiveItemList();
     if (!searchQuery.trim()) {
-      console.log('  Start typing to search across all 56 templates...');
-      console.log('  Try keywords: "join", "2model", "props", "servlet", "pinia", "mongo"\n');
+      console.log('  Start typing keywords to search across all templates...');
+      console.log('  Try queries:');
+      console.log('    - "mongo join"');
+      console.log('    - "2model"');
+      console.log('    - "servlet jdbc"');
+      console.log('    - "vue pinia router"');
+      console.log('    - "patch"');
+      console.log('    - "aggregation"\n');
       return;
     }
 
     if (items.length === 0) {
-      console.log(`  No templates matched "${searchQuery}".`);
+      console.log(`  No templates matched all tokens in "${searchQuery}".`);
       return;
     }
 
     const total = items.length;
+    const PAGE_SIZE = 12;
     let start = selectedIndex - Math.floor(PAGE_SIZE / 2);
     if (start < 0) start = 0;
-    if (start + PAGE_SIZE > total) {
-      start = Math.max(0, total - PAGE_SIZE);
-    }
-    const end = Math.min(start + PAGE_SIZE, total);
+    if (start + PAGE_SIZE > total) start = Math.max(0, total - PAGE_SIZE);
+    const visibleItems = items.slice(start, start + PAGE_SIZE);
 
-    if (start > 0) {
-      console.log(`     ^ (${start} more above)`);
-    }
+    if (start > 0) console.log('    ... (scroll up)');
 
-    for (let i = start; i < end; i++) {
-      const t = items[i];
-      const isCursor = i === selectedIndex;
+    visibleItems.forEach((t, i) => {
+      const realIndex = start + i;
+      const isCursor = realIndex === selectedIndex;
       const isChecked = selectedValues.has(t.value);
-      const box = isChecked ? '[x]' : '[ ]';
+      const box = isChecked ? '[x] ' : '[ ] ';
       const prefix = isCursor ? ' > ' : '   ';
-      console.log(prefix + box + ' ' + t.name);
-    }
+      console.log(prefix + box + t.name + ` [${t.category}]`);
+    });
 
-    if (end < total) {
-      console.log(`     v (${total - end} more below)`);
-    }
+    if (start + PAGE_SIZE < total) console.log('    ... (scroll down)');
 
-    console.log(`\n  Matches: ${total} | Selected: ${selectedValues.size}`);
+    const activeItem = items[selectedIndex];
+    if (activeItem && activeItem.desc) {
+      console.log('\n  Info: ' + activeItem.desc);
+    }
+    if (selectedValues.size > 0) {
+      console.log(`\n  Selected: ${selectedValues.size} template(s) [Press ENTER to proceed]`);
+    }
     return;
   }
+}
 
-  if (currentView === 'ALL') {
-    console.log('========================================================');
-    console.log('  Full Catalog: All 56 Templates');
-    console.log('========================================================\n');
-    console.log('  [SPACE] Select / Deselect | [ENTER] Confirm | [ESC] Back\n');
+// ============================================================================
+// COPY & EXTRACTION ENGINE
+// ============================================================================
 
-    const items = getActiveItemList();
-    const total = items.length;
+function copyDirectorySync(src, dest) {
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
 
-    let start = selectedIndex - Math.floor(PAGE_SIZE / 2);
-    if (start < 0) start = 0;
-    if (start + PAGE_SIZE > total) {
-      start = Math.max(0, total - PAGE_SIZE);
-    }
-    const end = Math.min(start + PAGE_SIZE, total);
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
 
-    if (start > 0) {
-      console.log(`     ^ (${start} more above)`);
+    if (entry.name === 'node_modules' || entry.name === 'target' || entry.name === '.git' || entry.name === 'dist') {
+      continue;
     }
 
-    let lastCat = null;
-    for (let i = start; i < end; i++) {
-      const t = items[i];
-      if (t.category !== lastCat) {
-        const catObj = categories.find(c => c.id === t.category);
-        if (catObj) {
-          console.log(`  --- ${catObj.title} ---`);
-        }
-        lastCat = t.category;
+    if (entry.isDirectory()) {
+      copyDirectorySync(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+      if (entry.name === 'script.sh' || entry.name === 'mvnw') {
+        try { fs.chmodSync(destPath, 0o755); } catch (e) {}
       }
-      const isCursor = i === selectedIndex;
-      const isChecked = selectedValues.has(t.value);
-      const box = isChecked ? '[x]' : '[ ]';
-      const prefix = isCursor ? ' > ' : '   ';
-      console.log(prefix + box + ' ' + t.name);
+    }
+  }
+}
+
+function unpackTemplates(selected, folderName) {
+  const currentDir = process.cwd();
+  const targetDir = folderName && folderName !== '.'
+    ? path.join(currentDir, folderName)
+    : currentDir;
+
+  console.log('\n--------------------------------------------------------');
+  console.log(`Extracting templates into: ${targetDir}`);
+  console.log('--------------------------------------------------------\n');
+
+  let listToUnpack = [];
+
+  if (selected.includes('all')) {
+    const allDirs = fs.readdirSync(templatesRoot).filter(f =>
+      fs.statSync(path.join(templatesRoot, f)).isDirectory()
+    );
+    listToUnpack = allDirs;
+  } else {
+    listToUnpack = selected;
+  }
+
+  let count = 0;
+  for (const tName of listToUnpack) {
+    const sourcePath = path.join(templatesRoot, tName);
+    if (!fs.existsSync(sourcePath)) {
+      console.log(`[SKIPPED] Template not found: ${tName}`);
+      continue;
     }
 
-    if (end < total) {
-      console.log(`     v (${total - end} more below)`);
+    let destPath = targetDir;
+    if (listToUnpack.length > 1) {
+      destPath = path.join(targetDir, tName);
     }
 
-    console.log(`\n  [${selectedIndex + 1}/${total}] Selected: ${selectedValues.size}`);
+    try {
+      copyDirectorySync(sourcePath, destPath);
+      console.log(`[COPIED] ${tName} -> ${destPath}`);
+      count++;
+    } catch (err) {
+      console.error(`[ERROR] Failed to copy ${tName}: ${err.message}`);
+    }
   }
+
+  console.log('\n========================================================');
+  console.log(`SUCCESS: ${count} template(s) unpacked cleanly.`);
+  console.log('========================================================');
+  console.log('Ready for development.\n');
+  process.exit(0);
 }
 
-function promptFolderName(choices) {
+function promptFolderName(selected) {
   isPrompting = true;
-  process.stdin.removeAllListeners('keypress');
   if (process.stdin.isTTY) {
     process.stdin.setRawMode(false);
   }
 
+  const defaultFolder = selected.length === 1 && selected[0] !== 'all' ? selected[0] : '.';
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout
   });
 
-  function askFrontendIfRequired(done) {
-    if (choices.includes('fullstack-springboot-vue')) {
-      console.log('\n=== SELECT FRONTEND FOR FULLSTACK TEMPLATE ===');
-      frontendOptions.forEach((opt, idx) => {
-        console.log(`  [${idx + 1}] ${opt.name}`);
-      });
-      rl.question('\nChoose frontend (1-11, default: 1 [all]): ', (ans) => {
-        const val = ans.trim();
-        let selectedFrontend = 'all';
-        const num = parseInt(val, 10);
-        if (!isNaN(num) && num >= 1 && num <= frontendOptions.length) {
-          selectedFrontend = frontendOptions[num - 1].value;
-        } else {
-          const directMatch = frontendOptions.find(f => f.value === val);
-          if (directMatch) {
-            selectedFrontend = directMatch.value;
-          }
-        }
-        done(selectedFrontend);
-      });
-    } else {
-      done(null);
-    }
-  }
-
-  askFrontendIfRequired((selectedFrontend) => {
-    const isAll = choices.includes('all');
-    const defaultFolder = isAll || choices.length > 1 ? 'wad-templates' : choices[0];
-
-    console.log('\nSelected to unpack: ' + choices.join(', '));
-    if (selectedFrontend) {
-      console.log('Selected frontend variant: ' + selectedFrontend);
-    }
-
-    rl.question(`Enter destination folder name (default: "${defaultFolder}"): `, (answer) => {
-      rl.close();
-      const folder = answer.trim() || defaultFolder;
-      const destDir = path.resolve(process.cwd(), folder);
-
-      if (!fs.existsSync(destDir)) {
-        fs.mkdirSync(destDir, { recursive: true });
-      }
-
-      if (isAll) {
-        copyDirRecursive(templatesRoot, destDir);
-        console.log('\nSuccessfully unpacked ALL 56 templates into: ' + destDir);
-      } else {
-        choices.forEach(c => {
-          if (c === 'fullstack-springboot-vue') {
-            const targetFullstack = choices.length === 1 ? destDir : path.join(destDir, c);
-            if (!fs.existsSync(targetFullstack)) {
-              fs.mkdirSync(targetFullstack, { recursive: true });
-            }
-            const backendSrc = path.join(templatesRoot, 'springboot-2model-1controller-api');
-            const backendDest = path.join(targetFullstack, 'backend');
-            copyDirRecursive(backendSrc, backendDest);
-            console.log('Unpacked [backend] (Spring Boot 2-Model API) into: ' + backendDest);
-
-            const frontendDest = path.join(targetFullstack, 'frontend');
-            if (selectedFrontend === 'all') {
-              const fullstackTemplateFrontendSrc = path.join(templatesRoot, 'fullstack-springboot-vue', 'frontend');
-              copyDirRecursive(fullstackTemplateFrontendSrc, frontendDest);
-              console.log('Unpacked [frontend] (All 10 Vue variants) into: ' + frontendDest);
-            } else {
-              const singleFrontendSrc = path.join(templatesRoot, selectedFrontend);
-              copyDirRecursive(singleFrontendSrc, frontendDest);
-              console.log('Unpacked [frontend] (' + selectedFrontend + ') into: ' + frontendDest);
-            }
-          } else {
-            const src = path.join(templatesRoot, c);
-            const dest = path.join(destDir, c);
-            copyDirRecursive(src, dest);
-            console.log('Unpacked [' + c + '] into: ' + dest);
-          }
-        });
-        console.log('\nSuccessfully unpacked all chosen templates into: ' + destDir);
-      }
-      process.exit(0);
-    });
+  console.log('\n');
+  rl.question(`Enter destination directory (default: "${defaultFolder}"): `, (answer) => {
+    rl.close();
+    const folder = answer.trim() || defaultFolder;
+    unpackTemplates(selected, folder);
   });
 }
 
-// Check command-line arguments for direct non-interactive use
-if (process.argv[2]) {
-  const arg = process.argv[2].trim();
-  if (arg === 'all' || arg === '--all' || arg === '-a') {
-    promptFolderName(['all']);
-  } else if (arg === '--cat' && process.argv[3]) {
-    const catId = process.argv[3].trim().toLowerCase();
-    const foundCat = categories.find(c => c.id === catId);
-    if (foundCat) {
-      activeCategory = foundCat;
-      currentView = 'CATEGORY';
-      selectedIndex = 0;
-      startInteractive();
-    } else {
-      console.error(`Unknown category: "${catId}". Available: ${categories.map(c => c.id).join(', ')}`);
-      process.exit(1);
-    }
-  } else if (arg === '--search' && process.argv[3]) {
-    searchQuery = process.argv.slice(3).join(' ');
-    currentView = 'SEARCH';
-    selectedIndex = 0;
-    startInteractive();
-  } else {
-    const found = templates.find(t => t.value === arg);
-    if (found) {
-      promptFolderName([found.value]);
-    } else {
-      console.error('Unknown template: ' + arg);
-      console.error(`Available templates (56 total) or run without arguments for the interactive menu.`);
-      process.exit(1);
-    }
-  }
-} else {
-  startInteractive();
-}
+// ============================================================================
+// INTERACTIVE INPUT HANDLER
+// ============================================================================
 
 function startInteractive() {
-  readline.emitKeypressEvents(process.stdin);
-  if (process.stdin.isTTY) {
-    process.stdin.setRawMode(true);
+  if (!process.stdin.isTTY) {
+    console.log('Interactive mode requires a TTY terminal. Usage: npx wad-lab [template-name]');
+    process.exit(1);
   }
 
+  readline.emitKeypressEvents(process.stdin);
+  process.stdin.setRawMode(true);
+  process.stdin.resume();
+
   renderScreen();
 
   process.stdin.on('keypress', (str, key) => {
@@ -812,20 +675,18 @@ function startInteractive() {
       process.exit(0);
     }
 
-    const items = getActiveItemList();
-
     // MAIN VIEW INPUT
     if (currentView === 'MAIN') {
+      const items = getActiveItemList();
+
       if (key.name === 'up') {
         selectedIndex = (selectedIndex - 1 + items.length) % items.length;
         renderScreen();
       } else if (key.name === 'down') {
         selectedIndex = (selectedIndex + 1) % items.length;
         renderScreen();
-      } else if (str === 'c' || str === 'C') {
-        currentView = 'CATEGORY_LIST';
-        selectedIndex = 0;
-        renderScreen();
+      } else if (str === 'q' || str === 'Q') {
+        process.exit(0);
       } else if (str === 's' || str === 'S') {
         currentView = 'SEARCH';
         searchQuery = '';
@@ -833,47 +694,28 @@ function startInteractive() {
         renderScreen();
       } else if (str === 'a' || str === 'A') {
         promptFolderName(['all']);
-      } else if (str === 'l' || str === 'L') {
-        currentView = 'ALL';
-        selectedIndex = 0;
-        renderScreen();
-      } else if (str >= '1' && str <= '7') {
+      } else if (str >= '1' && str <= '5') {
         const num = parseInt(str, 10);
-        const target = featuredTemplates[num - 1];
-        if (target) {
-          promptFolderName([target.value]);
-        }
-      } else if (key.name === 'space') {
-        const item = items[selectedIndex];
-        if (item.type === 'featured') {
-          if (selectedValues.has(item.id)) {
-            selectedValues.delete(item.id);
-          } else {
-            selectedValues.add(item.id);
-          }
+        activeCategory = categories[num - 1];
+        if (activeCategory) {
+          currentView = 'CATEGORY';
+          selectedIndex = 0;
+          selectedValues.clear();
           renderScreen();
         }
       } else if (key.name === 'return' || key.name === 'enter') {
         const item = items[selectedIndex];
-        if (selectedValues.size > 0) {
-          promptFolderName(Array.from(selectedValues));
-          return;
-        }
-        if (item.type === 'featured') {
-          promptFolderName([item.id]);
-        } else if (item.id === 'categories') {
-          currentView = 'CATEGORY_LIST';
+        if (item.type === 'category') {
+          activeCategory = categories.find(c => c.id === item.id);
+          currentView = 'CATEGORY';
           selectedIndex = 0;
+          selectedValues.clear();
           renderScreen();
         } else if (item.id === 'search') {
           currentView = 'SEARCH';
           searchQuery = '';
           selectedIndex = 0;
           renderScreen();
-        } else if (item.id === 'all_view') {
-          currentView = 'ALL';
-          selectedIndex = 0;
-          renderScreen();
         } else if (item.id === 'unpack_all') {
           promptFolderName(['all']);
         }
@@ -881,8 +723,10 @@ function startInteractive() {
       return;
     }
 
-    // CATEGORY_LIST VIEW INPUT
-    if (currentView === 'CATEGORY_LIST') {
+    // CATEGORY VIEW INPUT
+    if (currentView === 'CATEGORY') {
+      const items = getActiveItemList();
+
       if (key.name === 'escape' || key.name === 'left' || str === 'b' || str === 'B') {
         currentView = 'MAIN';
         selectedIndex = 0;
@@ -895,23 +739,28 @@ function startInteractive() {
       } else if (key.name === 'down') {
         selectedIndex = (selectedIndex + 1) % items.length;
         renderScreen();
-      } else if (str >= '1' && str <= '7') {
-        const num = parseInt(str, 10);
-        activeCategory = categories[num - 1];
-        currentView = 'CATEGORY';
-        selectedIndex = 0;
-        renderScreen();
+      } else if (key.name === 'space') {
+        const t = items[selectedIndex];
+        if (t) {
+          if (selectedValues.has(t.value)) {
+            selectedValues.delete(t.value);
+          } else {
+            selectedValues.add(t.value);
+          }
+          renderScreen();
+        }
       } else if (key.name === 'return' || key.name === 'enter') {
-        const item = items[selectedIndex];
-        activeCategory = categories.find(c => c.id === item.id);
-        currentView = 'CATEGORY';
-        selectedIndex = 0;
-        renderScreen();
+        if (selectedValues.size > 0) {
+          promptFolderName(Array.from(selectedValues));
+        } else {
+          const t = items[selectedIndex];
+          if (t) promptFolderName([t.value]);
+        }
       }
       return;
     }
 
-    // SEARCH VIEW INPUT
+    // SEARCH VIEW INPUT (MULTI-WORD)
     if (currentView === 'SEARCH') {
       if (key.name === 'escape') {
         currentView = 'MAIN';
@@ -920,43 +769,31 @@ function startInteractive() {
         return;
       }
 
-      if (key.name === 'up') {
-        if (items.length > 0) {
-          selectedIndex = (selectedIndex - 1 + items.length) % items.length;
-          renderScreen();
-        }
-        return;
-      }
+      const items = getActiveItemList();
 
-      if (key.name === 'down') {
-        if (items.length > 0) {
-          selectedIndex = (selectedIndex + 1) % items.length;
-          renderScreen();
-        }
+      if (key.name === 'up' && items.length > 0) {
+        selectedIndex = (selectedIndex - 1 + items.length) % items.length;
+        renderScreen();
         return;
       }
-
-      if (key.name === 'space') {
-        if (items.length > 0) {
-          const currentVal = items[selectedIndex].value;
-          if (selectedValues.has(currentVal)) {
-            selectedValues.delete(currentVal);
-          } else {
-            selectedValues.add(currentVal);
-          }
-          renderScreen();
-        }
+      if (key.name === 'down' && items.length > 0) {
+        selectedIndex = (selectedIndex + 1) % items.length;
+        renderScreen();
         return;
       }
 
       if (key.name === 'return' || key.name === 'enter') {
-        let chosen = Array.from(selectedValues);
-        if (chosen.length === 0 && items.length > 0) {
-          chosen = [items[selectedIndex].value];
+        if (selectedValues.size > 0) {
+          promptFolderName(Array.from(selectedValues));
+          return;
         }
-        if (chosen.length > 0) {
-          promptFolderName(chosen);
+        if (items.length > 0) {
+          promptFolderName([items[selectedIndex].value]);
+          return;
         }
+      }
+
+      if (key.name === 'space' && key.ctrl) {
         return;
       }
 
@@ -973,63 +810,67 @@ function startInteractive() {
         return;
       }
 
-      // Typing search query
-      if (str && str.length === 1 && !key.ctrl && !key.meta) {
+      // Typing characters into search (allows spaces for multi-word search!)
+      if (str && !key.ctrl && !key.meta) {
         searchQuery += str;
         selectedIndex = 0;
         renderScreen();
         return;
       }
-      return;
     }
+  });
+}
 
-    // CATEGORY / ALL VIEW INPUT
-    if (currentView === 'CATEGORY' || currentView === 'ALL') {
-      if (key.name === 'escape' || key.name === 'left' || str === 'b' || str === 'B') {
-        currentView = currentView === 'CATEGORY' ? 'CATEGORY_LIST' : 'MAIN';
-        selectedIndex = 0;
-        renderScreen();
-        return;
-      }
+// ============================================================================
+// CLI ARGUMENT DISPATCHER
+// ============================================================================
 
-      if (key.name === 'up') {
-        if (items.length > 0) {
-          selectedIndex = (selectedIndex - 1 + items.length) % items.length;
-          renderScreen();
-        }
-        return;
-      }
+function runCli() {
+  const arg = process.argv[2];
 
-      if (key.name === 'down') {
-        if (items.length > 0) {
-          selectedIndex = (selectedIndex + 1) % items.length;
-          renderScreen();
-        }
-        return;
-      }
+  if (!arg) {
+    startInteractive();
+    return;
+  }
 
-      if (key.name === 'space') {
-        if (items.length > 0) {
-          const currentVal = items[selectedIndex].value;
-          if (selectedValues.has(currentVal)) {
-            selectedValues.delete(currentVal);
-          } else {
-            selectedValues.add(currentVal);
-          }
-          renderScreen();
-        }
-        return;
-      }
+  if (arg === '--help' || arg === '-h') {
+    console.log('WAD Lab Templates CLI (Zero Emojis)');
+    console.log('Usage:');
+    console.log('  npx wad-lab                        Launch interactive UI');
+    console.log('  npx wad-lab [template-name]        Directly unpack a template');
+    console.log('  npx wad-lab --list                 List all available templates');
+    console.log('  npx wad-lab --search [words...]    Search templates with multi-word filter');
+    process.exit(0);
+  }
 
-      if (key.name === 'return' || key.name === 'enter') {
-        let chosen = Array.from(selectedValues);
-        if (chosen.length === 0 && items.length > 0) {
-          chosen = [items[selectedIndex].value];
-        }
-        if (chosen.length > 0) {
-          promptFolderName(chosen);
-        }
-      }
-    }
-  });
+  if (arg === '--list' || arg === '-l') {
+    console.log('Available WAD Lab Templates (54 Standalone):');
+    categories.forEach(cat => {
+      console.log(`\n=== ${cat.title} ===`);
+      templates.filter(t => t.category === cat.id).forEach(t => {
+        console.log(`  - ${t.value.padEnd(38)} : ${t.desc}`);
+      });
+    });
+    process.exit(0);
+  }
+
+  if (arg === '--search' && process.argv[3]) {
+    searchQuery = process.argv.slice(3).join(' ');
+    currentView = 'SEARCH';
+    selectedIndex = 0;
+    startInteractive();
+    return;
+  }
+
+  const found = templates.find(t => t.value === arg);
+  if (found) {
+    const dest = process.argv[3] || found.value;
+    unpackTemplates([found.value], dest);
+  } else {
+    console.log(`Unknown template or command: "${arg}".`);
+    console.log('Run "npx wad-lab --list" to view all available templates.');
+    process.exit(1);
+  }
 }
+
+runCli();