moai-adk 0.35.1__py3-none-any.whl

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

@@ -0,0 +1,174 @@
+# MoAI-ADK Question Schema Definition
+# Version: 1.1.0
+# Language: English only (runtime translation via conversation_language)
+
+schema_version: "1.1.0"
+last_updated: "2025-12-22"
+
+# AskUserQuestion Constraints (Claude Code)
+constraints:
+  max_questions_per_call: 4
+  max_options_per_question: 4
+  supports_multi_select: true
+  auto_includes_other: true
+  no_emoji_allowed: true
+
+# Question Types
+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 '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 '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:
+  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"
+  "{{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:
+  conversation_language_name:
+    trigger_field: "language.conversation_language"
+    mapping:
+      ko: "Korean"
+      en: "English"
+      ja: "Japanese"
+      es: "Spanish"
+      zh: "Chinese"
+      fr: "French"
+      de: "German"
+  project_locale:
+    trigger_field: "language.conversation_language"
+    mapping:
+      ko: "ko_KR"
+      en: "en_US"
+      ja: "ja_JP"
+      es: "es_ES"
+
+# Validation Rules
+validation_types:
+  enum:
+    description: "Value must be in allowed list"
+  pattern:
+    description: "Value must match regex pattern"
+  required:
+    description: "Field must have a value"
+  type_check:
+    description: "Value must match expected type"
+
+# Tab Priorities
+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,251 @@
+# 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."
+        header: "Description"
+        field: "project.description"
+        type: text_input
+        multi_select: false
+        required: true
+        options:
+          - label: "Example description"
+            description: "A game where you control a snake to eat food"
+            value: "{{prompt_user}}"
+        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

@@ -0,0 +1,107 @@
+# Tab 1: User & Language Settings
+# Priority: REQUIRED (must complete first)
+# Questions: 3
+
+metadata:
+  id: tab_1_user_language
+  label: "Tab 1: User & Language"
+  description: "Configure user name, conversation language, agent prompt language"
+  priority: REQUIRED
+  order: 1
+  setting_count: 3
+
+# Target files for CLAUDE.md reference
+target_sections:
+  - sections/user.yaml
+  - sections/language.yaml
+
+batches:
+  - batch_id: "1.1"
+    label: "Basic Settings"
+    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? To change, type your name in the text field below."
+        header: "User Name"
+        field: "user.name"
+        type: text_input
+        multi_select: false
+        required: true
+        options:
+          - label: "Keep Current Value"
+            description: "Continue using current name (to change, type in the field below)"
+            value: "{{current}}"
+        target:
+          file: "sections/user.yaml"
+          path: "user.name"
+        env_sync: "MOAI_USER_NAME"
+
+      # Q2: Conversation Language
+      - id: conversation_language
+        question: "What language should Alfred use in conversations?"
+        header: "Language"
+        field: "language.conversation_language"
+        type: select_single
+        multi_select: false
+        required: true
+        options:
+          - label: "Korean (ko)"
+            description: "All content will be generated in Korean"
+            value: "ko"
+          - label: "English (en)"
+            description: "All content will be generated in English"
+            value: "en"
+          - label: "Japanese (ja)"
+            description: "All content will be generated in Japanese"
+            value: "ja"
+          - label: "Spanish (es)"
+            description: "All content will be generated in Spanish"
+            value: "es"
+        target:
+          file: "sections/language.yaml"
+          path: "language.conversation_language"
+        env_sync: "MOAI_CONVERSATION_LANG"
+        auto_update:
+          - field: "language.conversation_language_name"
+            mapping:
+              ko: "Korean"
+              en: "English"
+              ja: "Japanese"
+              es: "Spanish"
+
+      # Q3: Agent Prompt Language
+      - id: agent_prompt_language
+        question: "What language should agent prompts use?"
+        header: "Agent Language"
+        field: "language.agent_prompt_language"
+        type: select_single
+        multi_select: false
+        required: true
+        options:
+          - label: "Same as Conversation"
+            description: "Use conversation language for agent prompts"
+            value: "{{language.conversation_language}}"
+          - label: "English"
+            description: "Always use English for agent prompts (recommended)"
+            value: "en"
+        target:
+          file: "sections/language.yaml"
+          path: "language.agent_prompt_language"
+        env_sync: "MOAI_AGENT_PROMPT_LANG"
+
+validation:
+  checkpoint: "after_tab_1"
+  rules:
+    - name: "validate_conversation_language"
+      description: "Verify conversation_language is valid"
+      field: "language.conversation_language"
+      validation: "enum"
+      allowed_values: ["ko", "en", "ja", "es", "zh", "fr", "de"]
+    - name: "validate_agent_prompt_language"
+      description: "Verify agent_prompt_language consistency"
+      field: "language.agent_prompt_language"
+      validation: "enum"
+      allowed_values: ["ko", "en", "ja", "es", "zh", "fr", "de"]

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

@@ -0,0 +1,79 @@
+# Tab 2: Project Settings
+# Priority: RECOMMENDED
+# Questions: 2 + auto-processing
+
+metadata:
+  id: tab_2_project_info
+  label: "Tab 2: Project Basic Information"
+  description: "Configure project name (GitHub Profile moved to Tab 3, Project Mode removed)"
+  priority: RECOMMENDED
+  order: 2
+  setting_count: 2
+
+target_sections:
+  - sections/project.yaml
+
+batches:
+  - batch_id: "2.1"
+    label: "Project Metadata"
+    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? To change, type the new name in the text field below."
+        header: "Project Name"
+        field: "project.name"
+        type: text_input
+        multi_select: false
+        required: true
+        options:
+          - label: "Keep Current Value"
+            description: "Continue using current name (to change, type in the field below)"
+            value: "{{current}}"
+        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? To change, type the new description in the text field below."
+        header: "Description"
+        field: "project.description"
+        type: text_input
+        multi_select: false
+        required: true
+        options:
+          - label: "Keep Current Value"
+            description: "Continue using current description (to change, type in the field below)"
+            value: "{{current}}"
+        target:
+          file: "sections/project.yaml"
+          path: "project.description"
+
+  - batch_id: "2.2"
+    label: "Auto-processed Locale Settings"
+    conditional: false
+    questions: []
+    auto_processing:
+      enabled: true
+      description: "Automatically derived from language.conversation_language"
+      fields:
+        - field: "project.locale"
+          derivation: "auto-map from conversation_language"
+          mapping:
+            ko: "ko_KR"
+            en: "en_US"
+            ja: "ja_JP"
+            es: "es_ES"
+
+validation:
+  checkpoint: "after_tab_2"
+  rules:
+    - name: "validate_project_name"
+      description: "Project name must not be empty"
+      field: "project.name"
+      validation: "required"