moai-adk 0.8.0__py3-none-any.whl → 0.34.0__py3-none-any.whl

moai_adk/templates/.github/ISSUE_TEMPLATE/spec.yml

@@ -1,176 +0,0 @@
-name: 📋 SPEC Document
-description: Create a new SPEC document for feature planning
-title: "[SPEC-] "
-labels: ["spec", "planning"]
-assignees: []
-
-body:
-  - type: markdown
-    attributes:
-      value: |
-        ## 📋 SPEC Metadata
-
-        Fill out the SPEC details below. This will be synchronized with the SPEC document and GitHub Issue.
-
-  - type: input
-    id: spec-id
-    attributes:
-      label: SPEC ID
-      description: "Format: DOMAIN-###. Example: AUTH-001, API-DESIGN-001"
-      placeholder: "AUTH-001"
-    validations:
-      required: true
-
-  - type: input
-    id: spec-title
-    attributes:
-      label: SPEC Title
-      description: "Brief description of the specification"
-      placeholder: "JWT-based authentication system"
-    validations:
-      required: true
-
-  - type: dropdown
-    id: priority
-    attributes:
-      label: Priority
-      description: "Feature priority level"
-      options:
-        - "critical"
-        - "high"
-        - "medium"
-        - "low"
-    validations:
-      required: true
-
-  - type: dropdown
-    id: category
-    attributes:
-      label: Category
-      description: "SPEC category"
-      options:
-        - "API"
-        - "Backend"
-        - "Frontend"
-        - "Infrastructure"
-        - "Security"
-        - "Testing"
-        - "DevOps"
-        - "Documentation"
-        - "Performance"
-        - "Other"
-    validations:
-      required: true
-
-  - type: textarea
-    id: ubiquitous-requirements
-    attributes:
-      label: "Ubiquitous Requirements"
-      description: "Statements that apply universally to the system"
-      placeholder: |
-        - The system must provide JWT-based authentication
-        - The system must support token expiration
-      value: "### Ubiquitous\n"
-    validations:
-      required: true
-
-  - type: textarea
-    id: event-requirements
-    attributes:
-      label: "Event-driven Requirements (WHEN)"
-      description: "Event-triggered requirements in EARS format"
-      placeholder: |
-        - WHEN the user submits login credentials, the system must validate them against the database
-        - WHEN credentials are valid, the system must issue a JWT token with expiration
-      value: "### Event-driven (WHEN)\n"
-    validations:
-      required: false
-
-  - type: textarea
-    id: state-requirements
-    attributes:
-      label: "State-driven Requirements (WHILE)"
-      description: "State-based requirements in EARS format"
-      placeholder: |
-        - WHILE the token is unexpired, the system must allow access to protected resources
-        - WHILE the user is logged in, the system must track the session
-      value: "### State-driven (WHILE)\n"
-    validations:
-      required: false
-
-  - type: textarea
-    id: optional-requirements
-    attributes:
-      label: "Optional Requirements (WHERE)"
-      description: "Optional features and capabilities"
-      placeholder: |
-        - WHERE the user requests token refresh, the system can issue a new token
-        - WHERE OAuth2 is available, the system can support social login
-      value: "### Optional (WHERE)\n"
-    validations:
-      required: false
-
-  - type: textarea
-    id: constraints
-    attributes:
-      label: "Constraints (IF)"
-      description: "System constraints and conditions"
-      placeholder: |
-        - IF the token has expired, the system must return 401 Unauthorized
-        - IF the password is incorrect, the system must reject the login attempt
-      value: "### Constraints (IF)\n"
-    validations:
-      required: false
-
-  - type: textarea
-    id: acceptance-criteria
-    attributes:
-      label: "Acceptance Criteria (Given-When-Then)"
-      description: "At least 2-3 test scenarios"
-      placeholder: |
-        **Scenario 1: Successful Login**
-        - Given a user with valid credentials exists
-        - When the user submits their credentials
-        - Then the system returns a valid JWT token
-
-        **Scenario 2: Token Expiration**
-        - Given a user with an expired token
-        - When the user tries to access a protected resource
-        - Then the system returns a 401 Unauthorized response
-      value: "## Acceptance Criteria\n\n"
-    validations:
-      required: true
-
-  - type: textarea
-    id: dependencies
-    attributes:
-      label: "Dependencies"
-      description: "Related SPECs, tasks, or blockers"
-      placeholder: |
-        - Related: SPEC-SECURITY-001
-        - Blocks: SPEC-API-DESIGN-001
-        - Depends on: SPEC-DATABASE-001
-    validations:
-      required: false
-
-  - type: textarea
-    id: notes
-    attributes:
-      label: "Additional Notes"
-      description: "Technical notes, assumptions, or context"
-      placeholder: |
-        - Consider token refresh token rotation
-        - JWT payload should be minimal for performance
-        - Consider rate limiting on login attempts
-    validations:
-      required: false
-
-  - type: markdown
-    attributes:
-      value: |
-        ## 📚 Reference
-
-        - **SPEC Metadata Guide**: See `.moai/memory/spec-metadata.md`
-        - **EARS Syntax Guide**: See `.moai/memory/development-guide.md`
-        - **Acceptance Criteria**: Use Given-When-Then (Gherkin) format
-        - **@TAG System**: @SPEC, @TEST, @CODE, @DOC traceability

moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,69 +0,0 @@
-# MoAI-ADK GitFlow PR
-
-> 🗿 Full GitFlow Transparency — the agent auto-fills information
-
-## 📝 SPEC Info
-
-- Related SPEC: `SPEC-AUTH-001` (e.g., JWT authentication system)
-- Directory: `.moai/specs/SPEC-AUTH-001/`
-- @TAG Links: @SPEC:AUTH-001 @CODE:AUTH-001 (auto-tagging)
-
-## ✅ SPEC Quality Checks
-
-- [ ] YAML Front Matter: 7 required fields (id, version, status, created, updated, author, priority)
-- [ ] HISTORY Section: Record versioned change log (include v0.0.1 INITIAL)
-- [ ] EARS Requirements: Ubiquitous, Event-driven, State-driven, Optional, Constraints
-- [ ] @SPEC:ID TAG: Include TAG in doc and check duplicates (`rg "@SPEC:<ID>" -n`)
-
-## 🤖 Automated Validation Status
-
-<!-- The checklist below is auto-updated by the agent -->
-<!-- /alfred:1-plan → create feature branch → Draft PR -->
-<!-- /alfred:2-run → implement via TDD → auto-check checkboxes -->
-<!-- /alfred:3-sync → synchronize documents → Ready for Review -->
-
-- [ ] spec-builder: Complete EARS spec and create feature branch
-- [ ] code-builder: Finish TDD RED-GREEN-REFACTOR
-- [ ] doc-syncer: Sync Living Documents and mark PR Ready
-
-## 📊 Quality Metrics (auto-calculated)
-
-- TRUST 5 Principles: ✅ Compliant
-- Test Coverage: XX% (target ≥ 85%)
-- @TAG Traceability: 100%
-
-## 🌍 Locale Settings
-
-- Project Language: <!-- ko/en/ja/zh -->
-- Commit Messages: <!-- generated automatically according to locale -->
-
-## 🎯 Changes
-
-<!-- code-builder auto-fills TDD results -->
-
-### 🔴 RED (Test Authoring)
-- Test File: `tests/auth/service.test.ts`
-- Test Description: [describe the failing test]
-
-### 🟢 GREEN (Implementation)
-- Implementation File: `src/auth/service.ts`
-- Implementation Done: [describe functionality]
-
-### ♻️ REFACTOR (Improvements)
-- Refactoring Details: [code quality improvements]
-
-## 📚 Documentation Sync
-
-<!-- auto-filled by doc-syncer -->
-
-- [ ] Update README
-- [ ] Sync API docs
-- [ ] Update TAG index
-- [ ] Update HISTORY section (SPEC docs)
-
----
-
-🚀 MoAI-ADK: Professional development without Git commands via a 3-stage pipeline!
-
-Reviewers: Check TRUST 5 compliance and SPEC metadata completeness only.
-

moai_adk/templates/.github/workflows/moai-gitflow.yml

@@ -1,256 +0,0 @@
-name: MoAI-ADK GitFlow Automation
-
-# MoAI-ADK 3-stage pipeline: spec → build → sync
-# Full GitFlow transparency — no Git expertise needed
-
-on:
-  push:
-    branches: [develop, "feature/**"]
-  pull_request:
-    types: [opened, ready_for_review, converted_to_draft]
-
-jobs:
-  moai-pipeline:
-    name: 🗿 MoAI-ADK Pipeline
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      # Multi-language toolchains (conditional)
-      - name: Setup Python
-        if: ${{ hashFiles('requirements.txt') != '' || hashFiles('pyproject.toml') != '' || hashFiles('setup.py') != '' }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.13"
-
-      - name: Setup Node.js
-        if: ${{ hashFiles('package.json') != '' }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: "22"
-
-      - name: Setup Bun
-        if: ${{ hashFiles('bun.lockb') != '' }}
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: "latest"
-
-      - name: Setup Go
-        if: ${{ hashFiles('go.mod') != '' }}
-        uses: actions/setup-go@v5
-        with:
-          go-version: "1.23"
-
-      - name: Setup Rust
-        if: ${{ hashFiles('Cargo.toml') != '' }}
-        uses: dtolnay/rust-toolchain@stable
-
-      - name: Setup Java
-        if: ${{ hashFiles('pom.xml') != '' || hashFiles('build.gradle') != '' || hashFiles('build.gradle.kts') != '' }}
-        uses: actions/setup-java@v4
-        with:
-          distribution: "temurin"
-          java-version: "21"
-
-      - name: Setup .NET
-        if: ${{ hashFiles('**/*.sln') != '' || hashFiles('**/*.csproj') != '' }}
-        uses: actions/setup-dotnet@v4
-        with:
-          dotnet-version: "8.0.x"
-
-      - name: Setup Ruby
-        if: ${{ hashFiles('Gemfile') != '' }}
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: "3.3"
-          bundler-cache: true
-
-      - name: Setup Flutter
-        if: ${{ hashFiles('pubspec.yaml') != '' }}
-        uses: subosito/flutter-action@v2
-        with:
-          flutter-version: "3.24.x"
-          channel: "stable"
-
-      - name: Setup Swift (Xcode)
-        if: ${{ hashFiles('Package.swift') != '' || hashFiles('**/*.xcodeproj') != '' || hashFiles('**/*.xcworkspace') != '' }}
-        uses: maxim-lobanov/setup-xcode@v1
-        with:
-          xcode-version: "latest-stable"
-
-      - name: Setup Kotlin
-        if: ${{ hashFiles('build.gradle.kts') != '' || hashFiles('settings.gradle.kts') != '' }}
-        uses: actions/setup-java@v4
-        with:
-          distribution: "temurin"
-          java-version: "21"
-
-      # TRUST 5 Principles — automated validation
-      # Note: Validation is handled by TypeScript-based tools
-      - name: 🧭 TRUST 5 Principles Check
-        run: |
-          echo "✅ TRUST validation is performed by TypeScript-based tools"
-          echo "   - Uses @agent-trust-checker"
-          echo "   - Leverages TypeScript hook system"
-
-      # Ignore test failures on Draft PRs; fail CI on Ready PRs
-      - name: Run language-aware tests
-        run: |
-          set -e
-          ALLOW_FAILURE="${{ github.event.pull_request.draft == true }}"
-          echo "🔎 Running language-aware tests (Draft PR: allow failure = $ALLOW_FAILURE)"
-
-          # Python tests
-          if [ -f "requirements.txt" ] || [ -f "pyproject.toml" ] || [ -f "setup.py" ]; then
-            echo "➡️  Python tests"
-            pip install -q pytest pytest-cov 2>/dev/null || true
-            if [ "$ALLOW_FAILURE" = "true" ]; then
-              pytest --cov --cov-report=term-missing || true
-            else
-              pytest --cov --cov-report=term-missing
-            fi
-          fi
-
-          # Node.js/Bun tests
-          if [ -f "package.json" ]; then
-            echo "➡️  Node.js/Bun tests"
-            if [ -f "bun.lockb" ]; then
-              bun install --frozen-lockfile || bun install
-              if [ "$ALLOW_FAILURE" = "true" ]; then
-                bun test || true
-              else
-                bun test
-              fi
-            else
-              npm ci --prefer-offline || npm install
-              if [ "$ALLOW_FAILURE" = "true" ]; then
-                npm test --if-present -- --coverage || true
-              else
-                npm test --if-present -- --coverage
-              fi
-            fi
-          fi
-
-          # Go tests
-          if [ -f "go.mod" ]; then
-            echo "➡️  Go tests"
-            if [ "$ALLOW_FAILURE" = "true" ]; then
-              go test -v -cover ./... || true
-            else
-              go test -v -cover ./...
-            fi
-          fi
-
-          # Rust tests
-          if [ -f "Cargo.toml" ]; then
-            echo "➡️  Rust tests"
-            if [ "$ALLOW_FAILURE" = "true" ]; then
-              cargo test --all --locked || cargo test || true
-            else
-              cargo test --all --locked || cargo test
-            fi
-          fi
-
-          # Java tests (Maven)
-          if [ -f "pom.xml" ]; then
-            echo "➡️  Java tests (Maven)"
-            if [ "$ALLOW_FAILURE" = "true" ]; then
-              mvn -q -DskipTests=false test || true
-            else
-              mvn -q -DskipTests=false test
-            fi
-          fi
-
-          # Java/Kotlin tests (Gradle)
-          if [ -f "build.gradle" ] || [ -f "build.gradle.kts" ]; then
-            echo "➡️  Java/Kotlin tests (Gradle)"
-            if [ "$ALLOW_FAILURE" = "true" ]; then
-              ./gradlew test || gradle test || true
-            else
-              ./gradlew test || gradle test
-            fi
-          fi
-
-          # .NET tests
-          if compgen -G "**/*.sln" > /dev/null || compgen -G "**/*.csproj" > /dev/null; then
-            echo "➡️  .NET tests"
-            if [ "$ALLOW_FAILURE" = "true" ]; then
-              dotnet test || true
-            else
-              dotnet test
-            fi
-          fi
-
-          # Ruby tests
-          if [ -f "Gemfile" ]; then
-            echo "➡️  Ruby tests"
-            if [ "$ALLOW_FAILURE" = "true" ]; then
-              bundle exec rspec || bundle exec rake test || true
-            else
-              bundle exec rspec || bundle exec rake test
-            fi
-          fi
-
-          # Flutter tests
-          if [ -f "pubspec.yaml" ]; then
-            echo "➡️  Flutter tests"
-            flutter pub get
-            if [ "$ALLOW_FAILURE" = "true" ]; then
-              flutter test || true
-            else
-              flutter test
-            fi
-          fi
-
-          # Swift tests
-          if [ -f "Package.swift" ]; then
-            echo "➡️  Swift tests (SPM)"
-            if [ "$ALLOW_FAILURE" = "true" ]; then
-              swift test || true
-            else
-              swift test
-            fi
-          elif compgen -G "**/*.xcodeproj" > /dev/null || compgen -G "**/*.xcworkspace" > /dev/null; then
-            echo "➡️  Swift tests (Xcode)"
-            # Xcode projects require a scheme; run conditionally
-            if [ "$ALLOW_FAILURE" = "true" ]; then
-              echo "⚠️  Xcode tests require a configured scheme"
-            else
-              echo "⚠️  Xcode tests require a configured scheme"
-            fi
-          fi
-
-      # TAG system validation (code files only)
-      - name: 🏷️ TAG System Validation
-        run: |
-          echo "✅ TAG validation is handled automatically in the tag_validator.py hook"
-
-      # Run per-branch stages
-      - name: 📝 SPEC Stage (feature branch)
-        if: startsWith(github.ref, 'refs/heads/feature/')
-        run: |
-          echo "🌿 Feature branch: SPEC validation stage"
-          echo "- spec-builder agent authors EARS spec"
-          echo "- Draft PR is created automatically"
-
-      - name: 🔴🟢🔄 BUILD Stage (Draft PR)
-        if: github.event.pull_request.draft == true
-        run: |
-          echo "📝 Draft PR: TDD implementation stage"
-          echo "- code-builder agent runs RED-GREEN-REFACTOR"
-          echo "- Validate TRUST 5 Principles compliance"
-
-      - name: 📚 SYNC Stage (Ready PR)
-        if: github.event.pull_request.draft == false && github.event.action == 'ready_for_review'
-        run: |
-          echo "✅ Ready PR: documentation sync stage"
-          echo "- doc-syncer agent synchronizes Living Documents"
-          echo "- PR is ready for review"
-
-      # Final result report
-      - name: 📊 MoAI Pipeline Complete
-        run: |
-          echo "🗿 MoAI-ADK GitFlow automation complete"
-          echo "✨ Professional workflow without needing to know Git"
-

moai_adk/templates/.moai/config.json

@@ -1,96 +0,0 @@
-{
-  "_meta": {
-    "@CODE:CONFIG-STRUCTURE-001": "@DOC:JSON-CONFIG-001",
-    "@SPEC:PROJECT-CONFIG-001": "@SPEC:MOAI-CONFIG-001"
-  },
-  "moai": {
-    "version": "{{MOAI_VERSION}}"
-  },
-  "constitution": {
-    "enforce_tdd": true,
-    "principles": {
-      "simplicity": {
-        "max_projects": 5,
-        "notes": "Default recommendation. Adjust in .moai/config.json or via SPEC/ADR with documented rationale based on project size."
-      }
-    },
-    "require_tags": true,
-    "simplicity_threshold": 5,
-    "test_coverage_target": 85
-  },
-  "git_strategy": {
-    "personal": {
-      "auto_checkpoint": "event-driven",
-      "checkpoint_events": [
-        "delete",
-        "refactor",
-        "merge",
-        "script",
-        "critical-file"
-      ],
-      "checkpoint_type": "local-branch",
-      "max_checkpoints": 10,
-      "cleanup_days": 7,
-      "push_to_remote": false,
-      "auto_commit": true,
-      "branch_prefix": "feature/",
-      "develop_branch": "develop",
-      "main_branch": "main"
-    },
-    "team": {
-      "auto_pr": true,
-      "develop_branch": "develop",
-      "draft_pr": true,
-      "feature_prefix": "feature/SPEC-",
-      "main_branch": "main",
-      "use_gitflow": true
-    }
-  },
-  "pipeline": {
-    "available_commands": [
-      "/alfred:0-project",
-      "/alfred:1-plan",
-      "/alfred:2-run",
-      "/alfred:3-sync"
-    ],
-    "current_stage": "initialized"
-  },
-  "language": {
-    "conversation_language": "{{CONVERSATION_LANGUAGE}}",
-    "conversation_language_name": "{{CONVERSATION_LANGUAGE_NAME}}"
-  },
-  "project": {
-    "name": "{{PROJECT_NAME}}",
-    "description": "{{PROJECT_DESCRIPTION}}",
-    "mode": "{{PROJECT_MODE}}",
-    "locale": "{{CONVERSATION_LANGUAGE}}",
-    "language": "{{CODEBASE_LANGUAGE}}",
-    "created_at": "{{CREATION_TIMESTAMP}}",
-    "initialized": true,
-    "optimized": false
-  },
-  "tags": {
-    "auto_sync": true,
-    "storage_type": "code_scan",
-    "categories": [
-      "REQ",
-      "DESIGN",
-      "TASK",
-      "TEST",
-      "FEATURE",
-      "API",
-      "UI",
-      "DATA"
-    ],
-    "code_scan_policy": {
-      "no_intermediate_cache": true,
-      "realtime_validation": true,
-      "scan_tools": [
-        "rg",
-        "grep"
-      ],
-      "scan_command": "rg '@TAG' -n",
-      "philosophy": "The source of truth for TAGs lives in the code itself"
-    }
-  }
-}