@smicolon/ai-kit 0.0.1 → 0.1.1

package/packs/flutter/commands/flutter-deploy.md

@@ -0,0 +1,133 @@
+---
+name: flutter-deploy
+description: Deploy Flutter app to App Store or Google Play using Fastlane
+argument-hint: "[ios|android] [testflight|appstore|internal|beta|production]"
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Glob
+  - Grep
+---
+
+# Flutter Deploy Command
+
+Deploy the Flutter application to app stores using Fastlane.
+
+## Parse Arguments
+
+Extract from user input:
+- **platform**: `ios` or `android` (required)
+- **target**:
+  - iOS: `testflight` (default) or `appstore`
+  - Android: `internal` (default), `beta`, or `production`
+
+## Pre-Deploy Validation
+
+Before deploying, verify:
+
+1. **Version Check**: Confirm version bumped in `pubspec.yaml`
+2. **Changelog**: Verify CHANGELOG.md updated
+3. **Tests**: Run `flutter test` and ensure passing
+4. **Fastlane Setup**: Verify Fastlane configured (`ios/fastlane/` or `android/fastlane/`)
+5. **Code Signing**:
+   - iOS: Match configured and certificates valid
+   - Android: Keystore configured in `key.properties`
+
+## iOS Deployment
+
+### TestFlight
+```bash
+# Build Flutter
+flutter build ios --release
+
+# Deploy via Fastlane
+cd ios && bundle exec fastlane beta
+```
+
+### App Store
+```bash
+# Build Flutter
+flutter build ipa --release
+
+# Deploy via Fastlane
+cd ios && bundle exec fastlane release
+```
+
+## Android Deployment
+
+### Internal Testing
+```bash
+# Build AAB
+flutter build appbundle --release
+
+# Deploy via Fastlane
+cd android && bundle exec fastlane internal
+```
+
+### Beta Track
+```bash
+cd android && bundle exec fastlane beta
+```
+
+### Production
+```bash
+cd android && bundle exec fastlane release
+```
+
+## Execution Steps
+
+1. **Validate Prerequisites**
+   - Check Fastlane installation
+   - Verify credentials/secrets configured
+   - Confirm version and changelog
+
+2. **Build Application**
+   - Run appropriate `flutter build` command
+   - Verify build succeeds
+
+3. **Execute Fastlane Lane**
+   - Navigate to platform directory
+   - Run `bundle exec fastlane <lane>`
+   - Monitor upload progress
+
+4. **Post-Deploy Actions**
+   - Report deployment status
+   - Provide store console links
+   - Suggest next steps (submit for review, promote track)
+
+## Environment Variables Required
+
+### iOS (App Store Connect)
+- `MATCH_PASSWORD`
+- `APP_STORE_CONNECT_API_KEY_ID`
+- `APP_STORE_CONNECT_API_ISSUER_ID`
+- `APP_STORE_CONNECT_API_KEY_CONTENT`
+
+### Android (Google Play)
+- `PLAY_STORE_JSON_KEY`
+
+## Error Handling
+
+Common issues and fixes:
+- **Code signing failed**: Run `/signing-setup`
+- **Version already exists**: Bump version in `pubspec.yaml`
+- **Missing metadata**: Update store metadata in `fastlane/metadata/`
+- **API credentials invalid**: Check environment variables
+
+## Output
+
+Report to user:
+- Deployment status
+- Build number uploaded
+- Store console URL
+- Estimated review time (if applicable)
+- Next steps
+
+## Post-Deploy Checklist
+
+- [ ] Verify build appears in store console
+- [ ] Check release notes are correct
+- [ ] Monitor for processing completion
+- [ ] Submit for review (if App Store)
+- [ ] Promote to wider audience (if Play Store)

package/packs/flutter/commands/flutter-test.md

@@ -0,0 +1,117 @@
+---
+name: flutter-test
+description: Run Flutter tests with coverage reporting (unit, widget, integration)
+argument-hint: "[unit|widget|integration|all] [--coverage] [--update-goldens]"
+allowed-tools:
+  - Bash
+  - Read
+  - Glob
+  - Grep
+---
+
+# Flutter Test Command
+
+Run Flutter tests with optional coverage reporting.
+
+## Parse Arguments
+
+Extract from user input:
+- **type**: `unit`, `widget`, `integration`, or `all` (default: all)
+- **coverage**: Include `--coverage` flag
+- **update-goldens**: Include `--update-goldens` for golden tests
+- **filter**: Optional test file pattern
+
+## Test Discovery
+
+Locate tests based on type:
+- **unit**: `test/unit/**/*_test.dart` or `test/**/*_test.dart` (excluding integration)
+- **widget**: `test/widget/**/*_test.dart` or tests with `testWidgets`
+- **integration**: `integration_test/**/*_test.dart`
+
+## Test Commands
+
+### Run All Tests
+```bash
+flutter test
+```
+
+### Run with Coverage
+```bash
+flutter test --coverage
+```
+
+### Run Specific Test File
+```bash
+flutter test test/unit/auth_test.dart
+```
+
+### Run Integration Tests
+```bash
+flutter test integration_test/app_test.dart
+```
+
+### Update Golden Files
+```bash
+flutter test --update-goldens
+```
+
+## Coverage Report
+
+When `--coverage` is requested:
+
+1. Run tests with coverage:
+```bash
+flutter test --coverage
+```
+
+2. Generate HTML report (if lcov installed):
+```bash
+genhtml coverage/lcov.info -o coverage/html
+```
+
+3. Report coverage summary:
+```bash
+lcov --summary coverage/lcov.info
+```
+
+## Execution Steps
+
+1. Display test configuration
+2. Run `flutter pub get` if needed
+3. Execute test command(s)
+4. Parse and display results:
+   - Total tests run
+   - Passed/Failed/Skipped counts
+   - Failed test details
+   - Coverage percentage (if enabled)
+
+## Coverage Analysis
+
+If coverage enabled, analyze:
+- Overall line coverage percentage
+- Files with low coverage (<80%)
+- Uncovered critical paths
+
+## Error Handling
+
+If tests fail:
+1. Show failed test names and locations
+2. Display assertion messages
+3. Suggest fixes if patterns detected
+
+## Output Format
+
+```
+Flutter Tests Summary
+=====================
+Total:   150
+Passed:  145
+Failed:  3
+Skipped: 2
+
+Failed Tests:
+- test/unit/auth_service_test.dart: 'should handle invalid credentials'
+- test/widget/login_form_test.dart: 'shows error on empty email'
+
+Coverage: 87.3% (target: 80%)
+```

package/packs/flutter/commands/signing-setup.md

@@ -0,0 +1,209 @@
+---
+name: signing-setup
+description: Configure code signing for iOS (certificates/profiles with Match) and Android (keystore)
+argument-hint: "[ios|android|both]"
+allowed-tools:
+  - Bash
+  - Read
+  - Write
+  - Edit
+  - AskUserQuestion
+---
+
+# Code Signing Setup Command
+
+Configure code signing for iOS and/or Android deployment.
+
+## Parse Arguments
+
+Extract from user input:
+- **platform**: `ios`, `android`, or `both` (default: both)
+
+## iOS Code Signing with Match
+
+### Prerequisites
+- Apple Developer Program membership
+- Private Git repository for certificates
+- App Store Connect API Key (recommended) or Apple ID
+
+### Setup Steps
+
+1. **Initialize Match**
+```bash
+cd ios
+bundle exec fastlane match init
+```
+
+2. **Create Matchfile**
+```ruby
+# ios/fastlane/Matchfile
+git_url("git@github.com:company/certificates.git")
+storage_mode("git")
+type("appstore")
+app_identifier(["com.company.app"])
+username("developer@company.com")
+team_id("TEAM_ID")
+```
+
+3. **Generate Certificates and Profiles**
+```bash
+# Development
+bundle exec fastlane match development
+
+# App Store distribution
+bundle exec fastlane match appstore
+
+# Ad Hoc (for TestFlight alternatives)
+bundle exec fastlane match adhoc
+```
+
+4. **Configure Xcode Project**
+
+Update `ios/Runner.xcodeproj/project.pbxproj`:
+- Set "Signing Style" to "Manual"
+- Select Match-generated provisioning profiles
+- Set correct Team ID
+
+5. **CI Environment Variables**
+```bash
+# For GitHub Actions
+MATCH_PASSWORD=<encryption-password>
+MATCH_GIT_BASIC_AUTHORIZATION=<base64-encoded-credentials>
+
+# App Store Connect API (preferred for CI)
+APP_STORE_CONNECT_API_KEY_ID=<key-id>
+APP_STORE_CONNECT_API_ISSUER_ID=<issuer-id>
+APP_STORE_CONNECT_API_KEY_CONTENT=<key-content>
+```
+
+### Match Commands Reference
+```bash
+# Create new certificates (first time)
+fastlane match appstore
+
+# Use existing certificates (CI, readonly)
+fastlane match appstore --readonly
+
+# Revoke and regenerate (use with caution)
+fastlane match nuke distribution
+fastlane match appstore
+```
+
+## Android Code Signing
+
+### Setup Steps
+
+1. **Generate Upload Keystore**
+```bash
+keytool -genkey -v -keystore android/upload-keystore.jks \
+  -keyalg RSA -keysize 2048 -validity 10000 \
+  -alias upload \
+  -dname "CN=Company Name, OU=Mobile, O=Company, L=City, ST=State, C=US"
+```
+
+2. **Create key.properties**
+```properties
+# android/key.properties (DO NOT COMMIT)
+storePassword=<keystore-password>
+keyPassword=<key-password>
+keyAlias=upload
+storeFile=../upload-keystore.jks
+```
+
+3. **Update build.gradle**
+
+Edit `android/app/build.gradle`:
+```groovy
+def keystoreProperties = new Properties()
+def keystorePropertiesFile = rootProject.file('key.properties')
+if (keystorePropertiesFile.exists()) {
+    keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
+}
+
+android {
+    ...
+    signingConfigs {
+        release {
+            keyAlias keystoreProperties['keyAlias']
+            keyPassword keystoreProperties['keyPassword']
+            storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
+            storePassword keystoreProperties['storePassword']
+        }
+    }
+    buildTypes {
+        release {
+            signingConfig signingConfigs.release
+            ...
+        }
+    }
+}
+```
+
+4. **Add to .gitignore**
+```
+# Android signing
+android/key.properties
+android/*.jks
+android/*.keystore
+```
+
+5. **CI Environment Setup**
+
+Encode keystore for CI:
+```bash
+base64 -i android/upload-keystore.jks | pbcopy
+```
+
+GitHub Secrets:
+- `KEYSTORE_BASE64` - Base64 encoded keystore
+- `KEYSTORE_PASSWORD` - Keystore password
+- `KEY_PASSWORD` - Key password
+- `KEY_ALIAS` - Key alias (usually "upload")
+
+### Play App Signing (Recommended)
+
+Enable Play App Signing in Google Play Console:
+1. Upload your upload key (not signing key)
+2. Google manages the actual signing key
+3. More secure - signing key never leaves Google
+
+## Verification
+
+### iOS
+```bash
+# List installed certificates
+security find-identity -v -p codesigning
+
+# Verify Match setup
+cd ios && bundle exec fastlane match appstore --readonly
+```
+
+### Android
+```bash
+# Verify keystore
+keytool -list -v -keystore android/upload-keystore.jks
+
+# Test release build
+flutter build appbundle --release
+```
+
+## Security Best Practices
+
+1. **Never commit** signing credentials to Git
+2. **Use environment variables** for CI/CD
+3. **Rotate keys** periodically
+4. **Enable Play App Signing** for Android
+5. **Use Match** for iOS team certificate management
+6. **Store secrets** in secure vault (GitHub Secrets, 1Password, etc.)
+
+## Troubleshooting
+
+### iOS Issues
+- **"No signing certificate"**: Run `fastlane match appstore`
+- **"Profile doesn't include signing certificate"**: Run `fastlane match nuke` then regenerate
+- **Team ID mismatch**: Check Matchfile and Xcode project settings
+
+### Android Issues
+- **"Keystore was tampered with"**: Wrong password
+- **"Cannot recover key"**: Key password != store password
+- **Release build unsigned**: Check key.properties path

package/packs/flutter/hooks/hooks.json

@@ -0,0 +1,17 @@
+{
+  "description": "Flutter deployment validation hooks",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "pattern": "fastlane.*(?:beta|release|internal|production)",
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "Before deploying to stores, verify:\n\n1. **Version Check**: Has the version been bumped in pubspec.yaml?\n2. **Changelog**: Is CHANGELOG.md updated with release notes?\n3. **Tests**: Have all tests passed?\n4. **Code Signing**: Is signing properly configured?\n\nIf any of these are not done, stop and help the user complete them before proceeding with deployment.\n\nCheck pubspec.yaml for current version. Check CHANGELOG.md for recent entries. If issues found, explain what needs to be done."
+          }
+        ]
+      }
+    ]
+  }
+}

package/packs/flutter/skills/fastlane-knowledge/SKILL.md

@@ -0,0 +1,193 @@
+---
+name: fastlane-knowledge
+description: >-
+  Provides Fastlane configuration patterns for Flutter apps including iOS and Android lanes,
+  code signing with match, CI/CD integration with GitHub Actions, and environment management.
+  Use when user asks about Fastlane setup, deployment automation, code signing, or CI/CD for mobile.
+version: 1.0.0
+---
+
+# Fastlane for Flutter
+
+Configure and use Fastlane for automated Flutter app deployment.
+
+## Directory Structure
+
+```
+project/
+├── ios/
+│   └── fastlane/
+│       ├── Fastfile          # iOS lanes
+│       ├── Appfile           # App identifier config
+│       ├── Matchfile         # Code signing config
+│       └── metadata/         # App Store metadata
+├── android/
+│   └── fastlane/
+│       ├── Fastfile          # Android lanes
+│       ├── Appfile           # Package name config
+│       └── metadata/         # Play Store metadata
+└── Gemfile                   # Ruby dependencies
+```
+
+## Setup Commands
+
+```bash
+# Install Fastlane
+gem install fastlane
+
+# Initialize for iOS
+cd ios && fastlane init
+
+# Initialize for Android
+cd android && fastlane init
+
+# Initialize match (iOS code signing)
+cd ios && fastlane match init
+```
+
+## iOS Fastfile Template
+
+```ruby
+default_platform(:ios)
+
+platform :ios do
+  before_all do
+    setup_ci if ENV['CI']
+  end
+
+  desc "Build and upload to TestFlight"
+  lane :beta do
+    match(type: "appstore", readonly: true)
+
+    build_app(
+      workspace: "Runner.xcworkspace",
+      scheme: "Runner",
+      export_method: "app-store",
+      output_directory: "./build"
+    )
+
+    upload_to_testflight(
+      skip_waiting_for_build_processing: true
+    )
+  end
+
+  desc "Deploy to App Store"
+  lane :release do
+    match(type: "appstore", readonly: true)
+
+    build_app(
+      workspace: "Runner.xcworkspace",
+      scheme: "Runner",
+      export_method: "app-store"
+    )
+
+    upload_to_app_store(
+      submit_for_review: true,
+      automatic_release: false,
+      force: true
+    )
+  end
+end
+```
+
+## Android Fastfile Template
+
+```ruby
+default_platform(:android)
+
+platform :android do
+  desc "Deploy to internal testing"
+  lane :internal do
+    upload_to_play_store(
+      track: "internal",
+      aab: "../build/app/outputs/bundle/release/app-release.aab",
+      json_key_data: ENV["PLAY_STORE_JSON_KEY"]
+    )
+  end
+
+  desc "Promote to beta"
+  lane :beta do
+    upload_to_play_store(
+      track: "beta",
+      track_promote_to: "beta"
+    )
+  end
+
+  desc "Deploy to production"
+  lane :release do
+    upload_to_play_store(
+      track: "production",
+      aab: "../build/app/outputs/bundle/release/app-release.aab",
+      json_key_data: ENV["PLAY_STORE_JSON_KEY"]
+    )
+  end
+end
+```
+
+## Code Signing
+
+### iOS with Match
+```ruby
+# Matchfile
+git_url("git@github.com:company/certificates.git")
+storage_mode("git")
+type("appstore")
+app_identifier(["com.company.app"])
+```
+
+### Match Commands
+```bash
+# Create new certificates/profiles
+fastlane match appstore
+fastlane match development
+fastlane match adhoc
+
+# Use existing (CI)
+fastlane match appstore --readonly
+```
+
+### Android Keystore
+```bash
+# Generate upload keystore
+keytool -genkey -v -keystore upload-keystore.jks \
+  -keyalg RSA -keysize 2048 -validity 10000 -alias upload
+```
+
+## GitHub Actions Integration
+
+### Required Secrets
+- `MATCH_PASSWORD` - Match encryption password
+- `MATCH_GIT_AUTH` - Base64 encoded Git credentials
+- `ASC_KEY_ID` - App Store Connect API Key ID
+- `ASC_ISSUER_ID` - App Store Connect Issuer ID
+- `ASC_KEY_CONTENT` - App Store Connect API Key content
+- `PLAY_STORE_JSON_KEY` - Google Play service account JSON
+- `KEYSTORE_BASE64` - Base64 encoded Android keystore
+- `KEYSTORE_PASSWORD` - Android keystore password
+- `KEY_PASSWORD` - Android key password
+- `KEY_ALIAS` - Android key alias
+
+## Common Lanes
+
+| Lane | Platform | Description |
+|------|----------|-------------|
+| `beta` | iOS | TestFlight upload |
+| `release` | iOS | App Store submission |
+| `internal` | Android | Internal testing track |
+| `beta` | Android | Beta track |
+| `release` | Android | Production release |
+
+## Environment Variables
+
+```bash
+# iOS
+export MATCH_PASSWORD="your-match-password"
+export APP_STORE_CONNECT_API_KEY_ID="your-key-id"
+export APP_STORE_CONNECT_API_ISSUER_ID="your-issuer-id"
+export APP_STORE_CONNECT_API_KEY_CONTENT="-----BEGIN PRIVATE KEY-----\n..."
+
+# Android
+export PLAY_STORE_JSON_KEY='{"type":"service_account",...}'
+```
+
+For complete Fastlane configuration, use the `/fastlane-setup` command.