appiq-solution 1.1.0 → 1.3.0

package/flutter/punkt.claude/punkt.claude/commands/git-commit.md

@@ -0,0 +1,3 @@
+Check the changes files and create a commit message for the changes. if needed and if several tasks or things are done do several commits.
+
+and also run the git commit cmd.

package/flutter/punkt.claude/punkt.claude/commands/manage-translations.md

@@ -0,0 +1,433 @@
+# Translation Management Command
+
+Manages translations for the AiGo app across all supported languages (English, German, Russian, Turkish, Arabic) with proper ARB file generation and validation.
+
+**Usage:** `manage-translations [ACTION] [OPTIONS]`
+
+**Actions:**
+- `add` - Add new translation keys
+- `update` - Update existing translations  
+- `generate` - Generate localization files
+- `validate` - Validate translation completeness
+- `extract` - Extract hardcoded strings from code
+
+**Examples:**
+- `manage-translations add --key "newFeature.title" --en "New Feature" --de "Neue Funktion"`
+- `manage-translations generate`
+- `manage-translations validate`
+
+## Supported Languages
+
+AiGo supports the following languages with their locale codes:
+- **English (en)** - Primary/template language
+- **German (de)** - German translation
+- **Russian (ru)** - Russian translation  
+- **Turkish (tr)** - Turkish translation
+- **Arabic (ar)** - Arabic translation with RTL support
+
+## File Structure
+
+```
+lib/l10n/
+├── app_en.arb          # English (template)
+├── app_de.arb          # German
+├── app_ru.arb          # Russian
+├── app_tr.arb          # Turkish
+├── app_ar.arb          # Arabic
+├── l10n.dart           # Generated localizations
+├── app_localizations.dart
+├── app_localizations_en.dart
+├── app_localizations_de.dart
+├── app_localizations_ru.dart
+├── app_localizations_tr.dart
+├── app_localizations_ar.dart
+├── generate_translations.py
+└── new/
+```
+
+## Configuration
+
+The app uses the following localization configuration in `l10n.yaml`:
+
+```yaml
+arb-dir: lib/l10n
+template-arb-file: app_en.arb
+output-localization-file: app_localizations.dart
+output-class: AppLocalizations
+untranslated-messages-file: untranslated.txt
+synthetic-package: false
+nullable-getter: false
+```
+
+## Command Actions
+
+### 1. Add New Translations
+
+**Usage:** `manage-translations add --key "feature.key" --en "English" --de "German" --ru "Russian" --tr "Turkish" --ar "Arabic"`
+
+**Example:**
+```bash
+manage-translations add \
+  --key "favorites.title" \
+  --en "Favorites" \
+  --de "Favoriten" \
+  --ru "Избранное" \
+  --tr "Favoriler" \
+  --ar "المفضلة"
+```
+
+**Process:**
+1. Validate that the key doesn't already exist
+2. Add the key to app_en.arb as the template
+3. Add translations to all other ARB files
+4. Generate localization files
+5. Validate all translations are complete
+
+**Template for new key in app_en.arb:**
+```json
+{
+  "keyName": "English Text",
+  "@keyName": {
+    "description": "Description of where this text is used"
+  }
+}
+```
+
+### 2. Update Existing Translations
+
+**Usage:** `manage-translations update --key "existing.key" --en "New English" --de "New German"`
+
+**Process:**
+1. Verify the key exists in app_en.arb
+2. Update translations in specified language files
+3. Mark other languages for review if needed
+4. Regenerate localization files
+
+### 3. Generate Localization Files
+
+**Usage:** `manage-translations generate`
+
+**Process:**
+1. Run Flutter's localization generation: `flutter gen-l10n`
+2. Validate generated files
+3. Check for any errors or warnings
+4. Update untranslated.txt with missing translations
+
+**Generated files:**
+- `lib/l10n/app_localizations.dart`
+- `lib/l10n/app_localizations_*.dart` for each language
+- `untranslated.txt` with missing translations
+
+### 4. Validate Translations
+
+**Usage:** `manage-translations validate`
+
+**Validation checks:**
+1. **Completeness**: All keys exist in all language files
+2. **Consistency**: Same number of placeholders in all translations
+3. **Syntax**: Valid JSON format in all ARB files
+4. **Placeholders**: Proper placeholder syntax `{variable}`
+5. **Gender/Plural**: Proper ICU message format for complex texts
+6. **RTL Support**: Arabic translations use correct text direction
+
+**Sample validation output:**
+```
+✅ English (en): 245 keys - Complete
+✅ German (de): 245 keys - Complete  
+❌ Russian (ru): 243 keys - Missing: favorites.title, settings.theme
+✅ Turkish (tr): 245 keys - Complete
+⚠️  Arabic (ar): 245 keys - Complete (2 RTL warnings)
+
+Missing translations written to: untranslated.txt
+```
+
+### 5. Extract Hardcoded Strings
+
+**Usage:** `manage-translations extract`
+
+**Process:**
+1. Scan all Dart files in `lib/` directory
+2. Look for hardcoded strings that should be localized
+3. Identify Text widgets with string literals
+4. Find string concatenations that should use interpolation
+5. Generate report of strings that need localization
+
+**Example patterns detected:**
+```dart
+// Bad - hardcoded string
+Text('Welcome to AiGo')
+
+// Good - localized string  
+Text(context.l10n.welcomeMessage)
+
+// Bad - hardcoded concatenation
+Text('Hello ' + userName)
+
+// Good - localized with interpolation
+Text(context.l10n.greetingMessage(userName))
+```
+
+## Implementation Guidelines
+
+### Adding New Features with Translations
+
+When implementing a new feature, follow this workflow:
+
+1. **Design Translation Keys**:
+   ```
+   featureName.title
+   featureName.subtitle  
+   featureName.description
+   featureName.button.save
+   featureName.button.cancel
+   featureName.error.notFound
+   featureName.success.saved
+   ```
+
+2. **Add to ARB Files**:
+   Start with English (template):
+   ```json
+   {
+     "favoritesTitle": "My Favorites",
+     "@favoritesTitle": {
+       "description": "Title for the favorites screen"
+     },
+     "favoritesEmpty": "No favorites yet",
+     "@favoritesEmpty": {
+       "description": "Message shown when favorites list is empty"
+     },
+     "favoritesCount": "{count, plural, =0{No favorites} =1{1 favorite} other{{count} favorites}}",
+     "@favoritesCount": {
+       "description": "Count of favorite items",
+       "placeholders": {
+         "count": {
+           "type": "int",
+           "example": "5"
+         }
+       }
+     }
+   }
+   ```
+
+3. **Use in Code**:
+   ```dart
+   import 'package:aigo/l10n/l10n.dart';
+   
+   class FavoritesScreen extends StatelessWidget {
+     @override
+     Widget build(BuildContext context) {
+       return Scaffold(
+         appBar: AppBar(
+           title: Text(context.l10n.favoritesTitle),
+         ),
+         body: favorites.isEmpty
+           ? Text(context.l10n.favoritesEmpty)
+           : Text(context.l10n.favoritesCount(favorites.length)),
+       );
+     }
+   }
+   ```
+
+### RTL (Right-to-Left) Support for Arabic
+
+Arabic text requires special handling:
+
+1. **Text Direction**: Automatically handled by `LocaleProvider`
+2. **Layout Direction**: Use `Directionality` widget when needed
+3. **Icons**: Consider flipping directional icons
+4. **Alignment**: Use `TextAlign.start` instead of `TextAlign.left`
+
+**Example RTL-aware implementation:**
+```dart
+Consumer(
+  builder: (context, ref, child) {
+    final isRtl = ref.watch(isRtlProvider);
+    
+    return Directionality(
+      textDirection: isRtl ? TextDirection.rtl : TextDirection.ltr,
+      child: Row(
+        children: [
+          Icon(isRtl ? Icons.arrow_back_ios : Icons.arrow_forward_ios),
+          Text(context.l10n.continueText),
+        ],
+      ),
+    );
+  },
+)
+```
+
+### Complex Messages with ICU Format
+
+For messages with plurals, gender, or complex formatting:
+
+```json
+{
+  "messageCount": "{count, plural, =0{no messages} =1{one message} other{{count} messages}}",
+  "@messageCount": {
+    "description": "Number of messages",
+    "placeholders": {
+      "count": {
+        "type": "int"
+      }
+    }
+  },
+  "userGreeting": "{gender, select, male{Welcome Mr. {name}} female{Welcome Ms. {name}} other{Welcome {name}}}",
+  "@userGreeting": {
+    "description": "Greeting based on user gender",
+    "placeholders": {
+      "gender": {
+        "type": "String"
+      },
+      "name": {
+        "type": "String"
+      }
+    }
+  }
+}
+```
+
+## Automation Scripts
+
+### Translation Generation Script
+
+Create `lib/l10n/generate_translations.py` for automated management:
+
+```python
+#!/usr/bin/env python3
+import json
+import os
+import subprocess
+import sys
+
+LANGUAGES = ['en', 'de', 'ru', 'tr', 'ar']
+ARB_DIR = 'lib/l10n'
+
+def generate_translations():
+    """Generate Flutter localizations"""
+    try:
+        result = subprocess.run(['flutter', 'gen-l10n'], 
+                              capture_output=True, text=True)
+        if result.returncode == 0:
+            print("✅ Translations generated successfully")
+        else:
+            print(f"❌ Error generating translations: {result.stderr}")
+    except Exception as e:
+        print(f"❌ Failed to run flutter gen-l10n: {e}")
+
+def validate_completeness():
+    """Validate all languages have the same keys"""
+    template_file = f"{ARB_DIR}/app_en.arb"
+    
+    with open(template_file, 'r', encoding='utf-8') as f:
+        template = json.load(f)
+    
+    template_keys = {k for k in template.keys() if not k.startswith('@')}
+    
+    for lang in LANGUAGES[1:]:  # Skip English (template)
+        lang_file = f"{ARB_DIR}/app_{lang}.arb"
+        
+        if not os.path.exists(lang_file):
+            print(f"❌ Missing file: {lang_file}")
+            continue
+            
+        with open(lang_file, 'r', encoding='utf-8') as f:
+            lang_data = json.load(f)
+        
+        lang_keys = {k for k in lang_data.keys() if not k.startswith('@')}
+        missing_keys = template_keys - lang_keys
+        
+        if missing_keys:
+            print(f"❌ {lang.upper()}: Missing {len(missing_keys)} keys")
+            for key in sorted(missing_keys):
+                print(f"   - {key}")
+        else:
+            print(f"✅ {lang.upper()}: Complete ({len(lang_keys)} keys)")
+
+if __name__ == "__main__":
+    if len(sys.argv) > 1 and sys.argv[1] == "validate":
+        validate_completeness()
+    else:
+        generate_translations()
+```
+
+### Usage Commands
+
+After updating translations, always run:
+
+```bash
+# Generate localization files
+flutter gen-l10n
+
+# Run build runner for any generated code
+dart run build_runner build
+
+# Validate completeness
+python3 lib/l10n/generate_translations.py validate
+```
+
+## Quality Checklist
+
+### Before Adding New Feature
+- [ ] Design complete translation key structure
+- [ ] Plan for plurals and complex messages
+- [ ] Consider RTL support for Arabic
+- [ ] Prepare context descriptions for translators
+
+### Adding Translations
+- [ ] All 5 languages have translations
+- [ ] Placeholders are consistent across languages
+- [ ] Context descriptions provided
+- [ ] ICU format used for complex messages
+- [ ] No hardcoded strings in Dart code
+
+### After Implementation
+- [ ] Run `flutter gen-l10n` successfully
+- [ ] Validate with `manage-translations validate`
+- [ ] Test RTL layout with Arabic
+- [ ] Verify all text displays correctly
+- [ ] Check untranslated.txt is empty
+
+### Code Quality
+- [ ] Use `context.l10n` for all user-facing text
+- [ ] No string concatenation for localized text
+- [ ] Proper placeholder usage
+- [ ] RTL-aware layout implementation
+
+## Common Translation Keys Structure
+
+Follow this naming convention for consistency:
+
+```
+// Screen titles
+screenName.title
+screenName.subtitle
+
+// Actions
+screenName.button.action
+screenName.action.verb
+
+// States
+screenName.loading
+screenName.empty
+screenName.error
+
+// Messages
+screenName.success.action
+screenName.error.specific
+screenName.warning.condition
+
+// Fields
+screenName.field.label
+screenName.field.hint
+screenName.field.error
+
+// General/Global
+general.yes
+general.no
+general.save
+general.cancel
+general.delete
+general.confirm
+```
+
+This translation management system ensures AiGo maintains high-quality, complete translations across all supported languages while following Flutter's best practices for internationalization.

package/flutter/punkt.claude/punkt.claude/commands/search-web.md

@@ -0,0 +1 @@
+Search the web for this: $ARGUMENTS and get the most relevant information that answers my query.

package/flutter/punkt.claude/punkt.claude/developer_check.md

@@ -0,0 +1,121 @@
+# Developer Check Status
+
+**Project**: AiGo Mobile App  
+**Created**: 2025-07-16  
+**Last Updated**: 2025-07-16  
+
+## Overview
+
+Dieses Dokument verwaltet den Status aller Development-Tasks und deren Quality-Reviews. Wird automatisch von `/dev` und `/checkdev` Commands aktualisiert.
+
+---
+
+## Active Development Session
+
+**Session ID**: DEV-001  
+**Started**: 2025-07-16  
+**Developer**: Claude Code Assistant  
+**QA Reviewer**: Claude Code QA  
+
+### Session Summary
+- **Total Tasks**: 1
+- **Completed**: 1  
+- **In Progress**: 0
+- **Pending**: 0
+- **Blocked**: 0
+
+---
+
+## Development Tasks
+
+### DEV-001-001 - Test Task: Create Demo Widget
+**Status**: ✅ COMPLETED  
+**Priority**: MEDIUM  
+**Estimated Time**: 0.5h  
+**Actual Time**: 0.5h  
+**Dependencies**: None  
+
+#### Description
+Demo-Task zur Validierung des Developer-Check-Systems. Erstelle ein einfaches Test-Widget.
+
+#### Implementation Details
+- [x] Create demo_widget.dart
+- [x] Add basic widget structure
+- [x] Test widget compilation
+
+#### Files Modified
+- lib/core/widgets/demo_widget.dart
+
+#### Quality Checklist
+- [x] DRY Prinzip befolgt
+- [x] Code lesbar und dokumentiert
+- [x] Wartbar strukturiert
+- [x] Performance optimiert
+- [x] Testbar implementiert
+
+#### Notes
+Demo-Implementation für System-Test. Bereit für QA-Review.
+
+---
+
+## Quality Reviews
+
+### Review: DEV-001-001 - Test Task: Create Demo Widget
+**Reviewer**: Claude Code QA  
+**Review Date**: 2025-07-16 15:30  
+**Status**: ✅ PASSED  
+
+#### Quality Score: 5/5
+- 🧹 DRY: ✅ Keine Duplikation
+- 📖 Readable: ✅ Klare Struktur  
+- 🔧 Maintainable: ✅ Modularer Aufbau
+- ⚡ Performant: ✅ Optimiert
+- 🧪 Testable: ✅ Testfreundlich
+
+#### Issues Found
+*Keine kritischen Issues gefunden.*
+
+#### Fixes Applied
+*Keine Fixes erforderlich.*
+
+#### Recommendations
+- Widget kann für weitere Demo-Zwecke erweitert werden
+- Dokumentation ist vollständig und ausreichend
+
+---
+
+## Session Metrics
+
+### Code Quality Score: 5.0/5.0
+- 🧹 DRY Prinzip: ✅ 100%
+- 📖 Lesbarkeit: ✅ 100%  
+- 🔧 Wartbarkeit: ✅ 100%
+- ⚡ Performance: ✅ 100%
+- 🧪 Testbarkeit: ✅ 100%
+
+### Development Velocity
+- **Tasks per Hour**: 2.0
+- **Average Task Time**: 0.5h
+- **Issues Found**: 0
+- **Issues Fixed**: 0
+
+---
+
+## Notes & Learnings
+
+### System Validation - 2025-07-16
+- ✅ Developer Check System erfolgreich implementiert
+- ✅ `/dev` und `/checkdev` Commands funktional
+- ✅ Task-Management und Quality-Reviews integriert
+- ✅ Automatische Status-Updates funktionieren
+
+### Best Practices Established
+- Tasks haben eindeutige IDs (DEV-[SESSION]-[TASK])
+- Quality-Checkliste mit 5 Kriterien etabliert
+- Smart Review-Strategy implementiert (context-aware)
+- Metrics-Tracking für kontinuierliche Verbesserung
+
+---
+
+**System Status**: ✅ READY FOR PRODUCTION  
+**Next Action**: System ist bereit für echte Development-Tasks!

package/package.json

@@ -1,40 +1,93 @@
 {
   "name": "appiq-solution",
-  "version": "1.1.0",
-  "description": "🚀 Super einfache KI-Agent Installation mit One-Click Workflows - Built with ❤️ based on Bmad-Method",
-  "main": "tools/appiq-installer.js",
+  "version": "1.3.0",
+  "description": "🚀 APPIQ SOLUTION: Flutter Mobile Development Extension - Eine spezialisierte Erweiterung der BMAD Method für Flutter Mobile App Entwicklung",
+  "main": "tools/cli.js",
   "bin": {
-    "appiq-solution": "./tools/appiq-installer.js"
+    "appiq-solution": "tools/bmad-npx-wrapper.js",
+    "appiq": "tools/bmad-npx-wrapper.js",
+    "bmad": "tools/bmad-npx-wrapper.js",
+    "bmad-method": "tools/bmad-npx-wrapper.js"
   },
   "scripts": {
-    "install-appiq": "node tools/appiq-installer.js install",
-    "test": "echo \"No tests yet\" && exit 0"
+    "build": "node tools/cli.js build",
+    "build:agents": "node tools/cli.js build --agents-only",
+    "build:teams": "node tools/cli.js build --teams-only",
+    "list:agents": "node tools/cli.js list:agents",
+    "validate": "node tools/cli.js validate",
+    "install:bmad": "node tools/installer/bin/bmad.js install",
+    "format": "prettier --write \"**/*.md\"",
+    "version:patch": "node tools/version-bump.js patch",
+    "version:minor": "node tools/version-bump.js minor",
+    "version:major": "node tools/version-bump.js major",
+    "version:expansion": "node tools/bump-expansion-version.js",
+    "version:expansion:set": "node tools/update-expansion-version.js",
+    "version:all": "node tools/bump-all-versions.js",
+    "version:all:minor": "node tools/bump-all-versions.js minor",
+    "version:all:major": "node tools/bump-all-versions.js major",
+    "version:all:patch": "node tools/bump-all-versions.js patch",
+    "version:expansion:all": "node tools/bump-all-versions.js",
+    "version:expansion:all:minor": "node tools/bump-all-versions.js minor",
+    "version:expansion:all:major": "node tools/bump-all-versions.js major",
+    "version:expansion:all:patch": "node tools/bump-all-versions.js patch",
+    "release": "semantic-release",
+    "release:test": "semantic-release --dry-run --no-ci || echo 'Config test complete - authentication errors are expected locally'"
+  },
+  "dependencies": {
+    "@kayvan/markdown-tree-parser": "^1.5.0",
+    "bmad-method": "^4.30.3",
+    "chalk": "^4.1.2",
+    "commander": "^14.0.0",
+    "fs-extra": "^11.3.0",
+    "glob": "^11.0.3",
+    "inquirer": "^8.2.6",
+    "js-yaml": "^4.1.0",
+    "ora": "^5.4.1"
   },
   "keywords": [
     "ai-agents",
-    "development-workflow",
+    "development-workflow", 
     "project-management",
+    "flutter",
+    "mobile-development",
+    "clean-architecture",
+    "cubit",
+    "bloc",
+    "dart",
     "greenfield",
     "brownfield",
     "cursor",
     "claude-code",
-    "windsurf"
+    "windsurf",
+    "agile",
+    "ai",
+    "orchestrator",
+    "development",
+    "methodology",
+    "agents",
+    "bmad"
   ],
-  "author": "Appiq Team",
+  "author": "Brian (BMad) Madison",
   "license": "MIT",
-  "dependencies": {
-    "chalk": "^4.1.2",
-    "inquirer": "^8.2.4"
+  "repository": {
+    "type": "git", 
+    "url": "git+https://github.com/Viktor-Hermann/APPIQ-METHOD.git"
   },
   "engines": {
     "node": ">=20.0.0"
   },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/your-repo/appiq-solution.git"
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.1.1",
+    "prettier": "^3.5.3",
+    "semantic-release": "^22.0.0",
+    "yaml-lint": "^1.7.0"
   },
-  "preferGlobal": true,
-  "publishConfig": {
-    "access": "public"
+  "lint-staged": {
+    "**/*.md": [
+      "prettier --write"
+    ]
   }
 }