moai-adk 0.32.8__py3-none-any.whl → 0.41.0__py3-none-any.whl

moai_adk/templates/.moai/config/questions/_schema.yaml

@@ -1,9 +1,9 @@
 # MoAI-ADK Question Schema Definition
-# Version: 1.0.0
+# Version: 1.1.0
 # Language: English only (runtime translation via conversation_language)
 
-schema_version: "1.0.0"
-last_updated: "2025-12-04"
+schema_version: "1.1.0"
+last_updated: "2025-12-22"
 
 # AskUserQuestion Constraints (Claude Code)
 constraints:
@@ -18,28 +18,63 @@ question_types:
   select_single:
     description: "Single selection from options"
     multi_select: false
+    # UX Guidelines:
+    # - Provide clear, distinct options (max 4 per question)
+    # - Include descriptive text for each option
+    # - Use "(recommended)" suffix for default/preferred options
   select_multiple:
     description: "Multiple selection from options"
     multi_select: true
+    # UX Guidelines:
+    # - Clearly indicate "multiple selections allowed" in question text
+    # - Limit to 4 options maximum
   text_input:
-    description: "Text input via 'Other' option"
+    description: "Text input via 'Type something' field (auto-added by AskUserQuestion tool)"
     use_other_for_input: true
+    # UX Guidelines for text_input questions:
+    # - Only include 'Keep Current Value' option for existing values
+    # - DO NOT include 'Change' or 'Other' options - they confuse users
+    # - Include guidance in question text: "To change, type in the text field below"
+    # - The 'Type something...' input field is automatically added by the tool
+    # - Users type directly in this auto-added field for custom values
+    # IMPORTANT: Never use {{prompt_user}} - it is DEPRECATED
   number_input:
-    description: "Number input via 'Other' option or predefined values"
+    description: "Number input via 'Type something' field or predefined numeric values"
     use_other_for_input: true
+    # UX Guidelines for number_input questions:
+    # - Provide common preset values as options (max 4)
+    # - Include guidance in question text: "To enter a custom number, type in the text field below"
+    # - DO NOT include 'Other' option with {{prompt_user}} - it is DEPRECATED
+    # - Users type custom numbers directly in the auto-added 'Type something...' field
+    # - Include valid range in question text if applicable (e.g., "0-100", "1-168")
+    # IMPORTANT: Never use {{prompt_user}} - it is DEPRECATED
 
 # Conditional Logic Operators
 condition_operators:
-  - equals
-  - not_equals
-  - in
-  - not_in
+  basic:
+    - equals
+    - not_equals
+    - in
+    - not_in
+  compound:
+    - and           # All conditions must be true
+    - or            # At least one condition must be true
+  usage_notes:
+    simple_condition: "condition: {field: 'git_strategy.mode', operator: 'equals', value: 'personal'}"
+    compound_condition: |
+      condition:
+        operator: and
+        conditions:
+          - {field: 'git_strategy.mode', operator: 'not_equals', value: 'manual'}
+          - {field: 'git_strategy.{mode}.auto_branch', operator: 'equals', value: true}
 
 # Special Values
 special_values:
   "{{current}}": "Keep current value from config"
-  "{{prompt_user}}": "Prompt user via 'Other' option"
   "{{field_path}}": "Reference another field value"
+  # DEPRECATED: "{{prompt_user}}" - DO NOT USE
+  # Reason: For text_input, users type directly in 'Type something' field
+  # Instead of a 'Change' option, include guidance in the question text
 
 # Auto-Update Rules
 auto_update_patterns:
@@ -77,3 +112,63 @@ priorities:
   REQUIRED: "Must complete before proceeding"
   RECOMMENDED: "Strongly suggested to configure"
   OPTIONAL: "Configure if needed"
+
+# Mode Conditions (Tab visibility control)
+mode_conditions:
+  INITIALIZATION: "Tab shown only during first-time project setup"
+  SETTINGS: "Tab shown only in settings management mode"
+  ALL: "Tab shown in all modes (default)"
+
+# Tab 0 Special Features (Smart Question System)
+tab0_features:
+  trigger_web_search:
+    description: "After collecting questions, trigger WebSearch for best practices"
+    enabled: true
+  generate_proposal:
+    description: "Generate smart technology proposal based on web search"
+    enabled: true
+  complexity_detection:
+    description: "Auto-detect project complexity from description keywords"
+    levels:
+      - simple
+      - medium
+      - complex
+
+# Validation Types (Extended)
+validation_types_extended:
+  min_length:
+    description: "Minimum string length validation"
+  range:
+    description: "Numeric value must be within range"
+    parameters:
+      - min
+      - max
+
+# Question Properties (Extended for Tab 0)
+question_properties:
+  tech_hint:
+    description: "Technology hint for project type options"
+  validation:
+    description: "Field validation rules"
+    properties:
+      - type
+      - pattern
+      - min_length
+      - error_message
+
+# Workflow Properties (Tab 0 specific)
+workflow_properties:
+  steps:
+    description: "Sequential workflow steps after question collection"
+    actions:
+      - collect_essential_info
+      - web_search
+      - generate_proposal
+      - user_approval
+      - delegate_to_agent
+  post_collection:
+    description: "Actions to perform after collecting all answers"
+    sections:
+      - web_search
+      - proposal
+      - approval

moai_adk/templates/.moai/config/questions/tab0-init.yaml

@@ -0,0 +1,259 @@
+# Tab 0: Project Initialization (INITIALIZATION Mode Only)
+# Priority: REQUIRED
+# Questions: 3
+# Mode Condition: INITIALIZATION only (first-time setup)
+
+metadata:
+  id: tab_0_initialization
+  label: "Tab 0: Project Initialization"
+  description: "Essential project setup with minimal questions and smart recommendations"
+  priority: REQUIRED
+  order: 0
+  setting_count: 3
+  mode_condition: INITIALIZATION
+  special_features:
+    trigger_web_search: true
+    generate_proposal: true
+
+# Target files for storing collected data
+target_sections:
+  - sections/project.yaml
+
+# Smart Question System Workflow
+workflow:
+  description: "Collect 3 essential questions, perform web search, generate smart proposal"
+  steps:
+    - step: 1
+      action: collect_essential_info
+      description: "Collect project name, type, and description"
+    - step: 2
+      action: web_search
+      description: "Search for best practices based on project type"
+      queries:
+        - pattern: "{project_type} best practices 2025"
+        - pattern: "{project_type} recommended tech stack 2025"
+        - pattern: "{project_type} {project_description_keywords} architecture patterns"
+    - step: 3
+      action: generate_proposal
+      description: "Create smart proposal with technology recommendations"
+    - step: 4
+      action: user_approval
+      description: "Present proposal and get user approval"
+    - step: 5
+      action: delegate_to_agent
+      description: "Pass approved configuration to manager-project agent"
+
+batches:
+  - batch_id: "0.1"
+    label: "Essential Project Information"
+    conditional: false
+    questions:
+      # Q1: Project Name
+      - id: init_project_name
+        question: "Choose a project name. Use only lowercase letters and hyphens (-)."
+        header: "Project Name"
+        field: "project.name"
+        type: text_input
+        multi_select: false
+        required: true
+        options:
+          - label: "Example: snake-game"
+            description: "A game project"
+            value: "snake-game"
+          - label: "Example: my-first-app"
+            description: "First application"
+            value: "my-first-app"
+          - label: "Example: todo-list"
+            description: "Task management app"
+            value: "todo-list"
+        target:
+          file: "sections/project.yaml"
+          path: "project.name"
+        validation:
+          type: pattern
+          pattern: "^[a-z][a-z0-9-]*$"
+          error_message: "Project name must be lowercase, start with letter, use only letters, numbers, and hyphens"
+
+      # Q2: Project Type
+      - id: init_project_type
+        question: "What kind of project would you like to create?"
+        header: "Project Type"
+        field: "project.type"
+        type: select_single
+        multi_select: false
+        required: true
+        options:
+          - label: "Web Browser App"
+            description: "Programs that open in Chrome, Safari (games, websites, etc.)"
+            value: "web_browser_app"
+            tech_hint: "HTML, CSS, JavaScript or React, Vue"
+          - label: "Mobile App"
+            description: "Apps installed on iPhone or Android"
+            value: "mobile_app"
+            tech_hint: "React Native, Flutter"
+          - label: "Command Line Tool"
+            description: "Programs that run in terminal (automation scripts, etc.)"
+            value: "cli_tool"
+            tech_hint: "Python, Node.js, Go"
+          - label: "Backend API"
+            description: "Server programs that store and process data"
+            value: "backend_api"
+            tech_hint: "FastAPI, Express, Django"
+        target:
+          file: "sections/project.yaml"
+          path: "project.type"
+
+      # Q3: Project Description
+      - id: init_project_description
+        question: "Describe what you want to build in one sentence. Type your description in the text field below."
+        header: "Description"
+        field: "project.description"
+        type: text_input
+        multi_select: false
+        required: true
+        # UX Note: For text_input, the 'Type something...' field is auto-added by AskUserQuestion tool.
+        # Users type directly in that field. Options are examples only, not required selections.
+        options:
+          - label: "Example: A game where you control a snake to eat food"
+            description: "Game project example"
+            value: ""
+          - label: "Example: A todo app with calendar integration"
+            description: "Productivity app example"
+            value: ""
+          - label: "Example: REST API for user authentication"
+            description: "Backend API example"
+            value: ""
+        target:
+          file: "sections/project.yaml"
+          path: "project.description"
+        validation:
+          type: required
+          min_length: 10
+          error_message: "Please provide a description of at least 10 characters"
+
+# Complexity Detection for Smart Proposal
+complexity_detection:
+  simple:
+    keywords:
+      - "game"
+      - "simple"
+      - "first"
+      - "practice"
+      - "learning"
+    project_types:
+      - "Browser games"
+      - "Simple utilities"
+      - "Learning projects"
+    recommended_stack:
+      framework: "None - Pure HTML5 + CSS3 + Vanilla JavaScript"
+      ui: "CSS only (Canvas for games)"
+      testing: "Browser developer tools"
+      build: "None - Open files directly in browser"
+    rationale: "No framework needed, basic technologies are sufficient for quick development"
+
+  medium:
+    keywords:
+      - "blog"
+      - "portfolio"
+      - "landing"
+      - "website"
+    recommended_stack:
+      framework: "Next.js or Astro with minimal dependencies"
+      ui: "Tailwind CSS"
+      testing: "Vitest"
+      build: "Vite"
+    rationale: "Lightweight framework for moderate complexity"
+
+  complex:
+    keywords:
+      - "dashboard"
+      - "admin"
+      - "SaaS"
+      - "platform"
+      - "enterprise"
+    recommended_stack:
+      framework: "Full framework with state management"
+      ui: "Component library (shadcn/ui, HeroUI)"
+      testing: "Vitest + Playwright"
+      build: "Vite or Turbopack"
+    rationale: "Full framework stack for complex applications"
+
+# Post-Collection Actions
+post_collection:
+  # Web Search Configuration
+  web_search:
+    enabled: true
+    parallel_queries: 3
+    query_templates:
+      - template: "{project_type} best practices 2025"
+        extract: "Design patterns, architecture recommendations, common pitfalls"
+      - template: "{project_type} recommended tech stack 2025"
+        extract: "Framework comparisons, library recommendations, version requirements"
+      - template: "{project_type} {description_keywords} architecture patterns"
+        extract: "Domain-specific patterns, similar project architectures"
+    analysis_output:
+      - "Recommended Frameworks: Top 2-3 options with pros/cons"
+      - "UI Library: Best options for project type"
+      - "Testing Framework: Industry standard for project type"
+      - "Build Tools: Current best practices"
+      - "Deployment Target: Common deployment platforms"
+
+  # Proposal Generation
+  proposal:
+    structure:
+      - section: "Technology Stack"
+        fields:
+          - "Framework with rationale"
+          - "UI Library with rationale"
+          - "Testing framework"
+          - "Build tools"
+      - section: "Architecture"
+        fields:
+          - "Directory structure"
+          - "Key patterns"
+          - "Data flow"
+      - section: "Quality Standards"
+        fields:
+          - "Test coverage target"
+          - "TRUST 5 level"
+          - "Accessibility level"
+
+  # User Approval
+  approval:
+    question: "Do you approve this configuration? You can modify specific parts or request a different approach."
+    header: "Approval"
+    options:
+      - label: "Approve and Continue"
+        description: "Create project with these settings"
+        value: "approve"
+      - label: "Modify Tech Stack"
+        description: "Keep architecture, change framework/libraries"
+        value: "modify_tech"
+      - label: "Modify Architecture"
+        description: "Keep tech stack, change structure/patterns"
+        value: "modify_arch"
+      - label: "Start Over"
+        description: "Re-run search with different criteria"
+        value: "restart"
+
+validation:
+  checkpoint: "after_tab_0"
+  rules:
+    - name: "validate_project_name"
+      description: "Project name must be valid directory name"
+      field: "project.name"
+      validation: "pattern"
+      pattern: "^[a-z][a-z0-9-]*$"
+    - name: "validate_project_type"
+      description: "Project type must be one of allowed values"
+      field: "project.type"
+      validation: "enum"
+      allowed_values:
+        - "web_browser_app"
+        - "mobile_app"
+        - "cli_tool"
+        - "backend_api"
+    - name: "validate_project_description"
+      description: "Project description must not be empty"
+      field: "project.description"
+      validation: "required"

moai_adk/templates/.moai/config/questions/tab1-user.yaml

@@ -21,8 +21,10 @@ batches:
     conditional: false
     questions:
       # Q1: User Name
+      # UX Note: For text_input, only show "Keep Current" option.
+      # Users should type directly in "Type something" field to enter new value.
       - id: user_name
-        question: "What is your name?"
+        question: "What is your name? To change, type your name in the text field below."
         header: "User Name"
         field: "user.name"
         type: text_input
@@ -30,11 +32,8 @@ batches:
         required: true
         options:
           - label: "Keep Current Value"
-            description: "Continue using current name"
+            description: "Continue using current name (to change, type in the field below)"
             value: "{{current}}"
-          - label: "Change"
-            description: "Select Other to enter new name"
-            value: "{{prompt_user}}"
         target:
           file: "sections/user.yaml"
           path: "user.name"

moai_adk/templates/.moai/config/questions/tab2-project.yaml

@@ -1,14 +1,14 @@
-# Tab 2: Project & GitHub Settings
+# Tab 2: Project Settings
 # Priority: RECOMMENDED
-# Questions: 4 + auto-processing
+# Questions: 2 + auto-processing
 
 metadata:
   id: tab_2_project_info
   label: "Tab 2: Project Basic Information"
-  description: "Configure project name, description, owner, mode"
+  description: "Configure project name (GitHub Profile moved to Tab 3, Project Mode removed)"
   priority: RECOMMENDED
   order: 2
-  setting_count: 4
+  setting_count: 2
 
 target_sections:
   - sections/project.yaml
@@ -19,8 +19,10 @@ batches:
     conditional: false
     questions:
       # Q1: Project Name
+      # UX Note: For text_input, only show "Keep Current" option.
+      # Users should type directly in "Type something" field to enter new value.
       - id: project_name
-        question: "What is the project name?"
+        question: "What is the project name? To change, type the new name in the text field below."
         header: "Project Name"
         field: "project.name"
         type: text_input
@@ -28,18 +30,17 @@ batches:
         required: true
         options:
           - label: "Keep Current Value"
-            description: "Continue using current name"
+            description: "Continue using current name (to change, type in the field below)"
             value: "{{current}}"
-          - label: "Change"
-            description: "Select Other to enter new name"
-            value: "{{prompt_user}}"
         target:
           file: "sections/project.yaml"
           path: "project.name"
 
       # Q2: Project Description
+      # UX Note: For text_input, only show "Keep Current" option.
+      # Users should type directly in "Type something" field to enter new value.
       - id: project_description
-        question: "What is the project description?"
+        question: "What is the project description? To change, type the new description in the text field below."
         header: "Description"
         field: "project.description"
         type: text_input
@@ -47,56 +48,12 @@ batches:
         required: true
         options:
           - label: "Keep Current Value"
-            description: "Continue using current description"
+            description: "Continue using current description (to change, type in the field below)"
             value: "{{current}}"
-          - label: "Change"
-            description: "Select Other to enter new description"
-            value: "{{prompt_user}}"
         target:
           file: "sections/project.yaml"
           path: "project.description"
 
-      # Q3: GitHub Profile Name
-      - id: github_profile_name
-        question: "What is your GitHub profile name?"
-        header: "GitHub Profile"
-        field: "github.profile_name"
-        type: text_input
-        multi_select: false
-        required: true
-        options:
-          - label: "Keep Current Value"
-            description: "Continue using current profile"
-            value: "{{current}}"
-          - label: "Change"
-            description: "Select Other to enter GitHub username (e.g., @GoosLab)"
-            value: "{{prompt_user}}"
-        target:
-          file: "sections/project.yaml"
-          path: "github.profile_name"
-
-      # Q4: Project Mode
-      - id: project_mode
-        question: "What is the project mode?"
-        header: "Mode"
-        field: "project.mode"
-        type: select_single
-        multi_select: false
-        required: true
-        options:
-          - label: "Development"
-            description: "Active development phase"
-            value: "development"
-          - label: "Production"
-            description: "Stable production phase"
-            value: "production"
-          - label: "Maintenance"
-            description: "Maintenance/bug fix phase"
-            value: "maintenance"
-        target:
-          file: "sections/project.yaml"
-          path: "project.mode"
-
   - batch_id: "2.2"
     label: "Auto-processed Locale Settings"
     conditional: false