ai-qakit 1.0.0

package/templates/.claude/skills/webdriverio/references/capabilities.md

@@ -0,0 +1,377 @@
+# WebdriverIO Capabilities Reference
+
+## Web Capabilities
+
+### Chrome
+
+```typescript
+{
+  browserName: 'chrome',
+  'goog:chromeOptions': {
+    args: [
+      '--window-size=1920,1080',
+      '--disable-gpu',
+      '--no-sandbox',
+      '--disable-dev-shm-usage',
+    ],
+  },
+}
+
+// Headless Chrome
+{
+  browserName: 'chrome',
+  'goog:chromeOptions': {
+    args: ['--headless', '--disable-gpu', '--window-size=1920,1080'],
+  },
+}
+```
+
+### Firefox
+
+```typescript
+{
+  browserName: 'firefox',
+  'moz:firefoxOptions': {
+    args: ['-width=1920', '-height=1080'],
+  },
+}
+
+// Headless Firefox
+{
+  browserName: 'firefox',
+  'moz:firefoxOptions': {
+    args: ['-headless', '-width=1920', '-height=1080'],
+  },
+}
+```
+
+### Safari
+
+```typescript
+{
+  browserName: 'safari',
+  'safari:automaticInspection': true,
+}
+```
+
+### Edge
+
+```typescript
+{
+  browserName: 'MicrosoftEdge',
+  'ms:edgeOptions': {
+    args: ['--window-size=1920,1080'],
+  },
+}
+```
+
+## Android Capabilities
+
+### Local Emulator
+
+```typescript
+{
+  platformName: 'Android',
+  'appium:deviceName': 'Pixel_5_API_31',
+  'appium:platformVersion': '12.0',
+  'appium:automationName': 'UiAutomator2',
+  'appium:app': './apps/android/app-debug.apk',
+  'appium:noReset': false,
+  'appium:fullReset': false,
+  'appium:newCommandTimeout': 240,
+  'appium:autoGrantPermissions': true,
+}
+```
+
+### Real Device
+
+```typescript
+{
+  platformName: 'Android',
+  'appium:deviceName': 'Samsung Galaxy S21',
+  'appium:udid': 'RF8M33XXXXX', // Device UDID
+  'appium:platformVersion': '12.0',
+  'appium:automationName': 'UiAutomator2',
+  'appium:app': './apps/android/app-debug.apk',
+  'appium:noReset': false,
+}
+```
+
+### Chrome Mobile (Web on Android)
+
+```typescript
+{
+  platformName: 'Android',
+  'appium:deviceName': 'Pixel_5_API_31',
+  'appium:platformVersion': '12.0',
+  'appium:automationName': 'UiAutomator2',
+  'appium:browserName': 'Chrome',
+}
+```
+
+## iOS Capabilities
+
+### Simulator
+
+```typescript
+{
+  platformName: 'iOS',
+  'appium:deviceName': 'iPhone 14',
+  'appium:platformVersion': '16.0',
+  'appium:automationName': 'XCUITest',
+  'appium:app': './apps/ios/App.app',
+  'appium:noReset': false,
+  'appium:fullReset': false,
+  'appium:newCommandTimeout': 240,
+}
+```
+
+### Real Device
+
+```typescript
+{
+  platformName: 'iOS',
+  'appium:deviceName': 'iPhone 14 Pro',
+  'appium:udid': '00008030-XXXXXXXXXXXX',
+  'appium:platformVersion': '16.0',
+  'appium:automationName': 'XCUITest',
+  'appium:app': './apps/ios/App.ipa',
+  'appium:xcodeOrgId': 'TEAM_ID',
+  'appium:xcodeSigningId': 'iPhone Developer',
+}
+```
+
+### Safari Mobile (Web on iOS)
+
+```typescript
+{
+  platformName: 'iOS',
+  'appium:deviceName': 'iPhone 14',
+  'appium:platformVersion': '16.0',
+  'appium:automationName': 'XCUITest',
+  'appium:browserName': 'Safari',
+}
+```
+
+## BrowserStack Capabilities
+
+### Web
+
+```typescript
+{
+  browserName: 'Chrome',
+  browserVersion: 'latest',
+  'bstack:options': {
+    os: 'Windows',
+    osVersion: '11',
+    projectName: 'Automation Tests',
+    buildName: `Build ${Date.now()}`,
+    sessionName: 'Chrome Tests',
+    local: false,
+    debug: true,
+    consoleLogs: 'info',
+    networkLogs: true,
+    seleniumVersion: '4.0.0',
+  },
+}
+```
+
+### Android
+
+```typescript
+{
+  platformName: 'Android',
+  'appium:deviceName': 'Samsung Galaxy S21',
+  'appium:platformVersion': '12.0',
+  'appium:app': process.env.BROWSERSTACK_ANDROID_APP_URL, // bs://xxxxx
+  'bstack:options': {
+    projectName: 'Mobile Automation',
+    buildName: `Android Build ${Date.now()}`,
+    sessionName: 'Android Tests',
+    debug: true,
+    networkLogs: true,
+    appiumVersion: '2.0.0',
+  },
+}
+```
+
+### iOS
+
+```typescript
+{
+  platformName: 'iOS',
+  'appium:deviceName': 'iPhone 14',
+  'appium:platformVersion': '16.0',
+  'appium:app': process.env.BROWSERSTACK_IOS_APP_URL, // bs://xxxxx
+  'bstack:options': {
+    projectName: 'Mobile Automation',
+    buildName: `iOS Build ${Date.now()}`,
+    sessionName: 'iOS Tests',
+    debug: true,
+    networkLogs: true,
+    appiumVersion: '2.0.0',
+  },
+}
+```
+
+## Sauce Labs Capabilities
+
+### Web
+
+```typescript
+{
+  browserName: 'chrome',
+  browserVersion: 'latest',
+  platformName: 'Windows 11',
+  'sauce:options': {
+    name: 'Chrome Tests',
+    build: `Build ${Date.now()}`,
+    screenResolution: '1920x1080',
+  },
+}
+```
+
+### Mobile
+
+```typescript
+{
+  platformName: 'Android',
+  'appium:deviceName': 'Samsung Galaxy S21',
+  'appium:platformVersion': '12',
+  'appium:app': 'storage:filename=app.apk',
+  'sauce:options': {
+    name: 'Android Tests',
+    build: `Build ${Date.now()}`,
+    appiumVersion: '2.0',
+  },
+}
+```
+
+## Capability Modules Pattern
+
+### capabilities/android.caps.ts
+
+```typescript
+export const androidCapabilities = {
+  local: {
+    platformName: 'Android',
+    'appium:deviceName': process.env.ANDROID_DEVICE_NAME || 'Pixel_5_API_31',
+    'appium:platformVersion': process.env.ANDROID_PLATFORM_VERSION || '12.0',
+    'appium:automationName': 'UiAutomator2',
+    'appium:app': process.env.ANDROID_APP_PATH || './apps/android/app.apk',
+    'appium:noReset': false,
+    'appium:newCommandTimeout': 240,
+  },
+
+  browserstack: {
+    platformName: 'Android',
+    'appium:deviceName': 'Samsung Galaxy S21',
+    'appium:platformVersion': '12.0',
+    'appium:app': process.env.BROWSERSTACK_ANDROID_APP_URL,
+    'bstack:options': {
+      userName: process.env.BROWSERSTACK_USERNAME,
+      accessKey: process.env.BROWSERSTACK_ACCESS_KEY,
+      projectName: 'Automation Tests',
+      buildName: `Android Build ${Date.now()}`,
+      debug: true,
+      networkLogs: true,
+    },
+  },
+};
+```
+
+### capabilities/ios.caps.ts
+
+```typescript
+export const iosCapabilities = {
+  local: {
+    platformName: 'iOS',
+    'appium:deviceName': process.env.IOS_DEVICE_NAME || 'iPhone 14',
+    'appium:platformVersion': process.env.IOS_PLATFORM_VERSION || '16.0',
+    'appium:automationName': 'XCUITest',
+    'appium:app': process.env.IOS_APP_PATH || './apps/ios/App.app',
+    'appium:noReset': false,
+    'appium:newCommandTimeout': 240,
+  },
+
+  browserstack: {
+    platformName: 'iOS',
+    'appium:deviceName': 'iPhone 14',
+    'appium:platformVersion': '16.0',
+    'appium:app': process.env.BROWSERSTACK_IOS_APP_URL,
+    'bstack:options': {
+      userName: process.env.BROWSERSTACK_USERNAME,
+      accessKey: process.env.BROWSERSTACK_ACCESS_KEY,
+      projectName: 'Automation Tests',
+      buildName: `iOS Build ${Date.now()}`,
+      debug: true,
+      networkLogs: true,
+    },
+  },
+};
+```
+
+### capabilities/web.caps.ts
+
+```typescript
+export const webCapabilities = {
+  chrome: {
+    browserName: 'chrome',
+    'goog:chromeOptions': {
+      args: process.env.HEADLESS === 'true'
+        ? ['--headless', '--disable-gpu', '--window-size=1920,1080']
+        : ['--window-size=1920,1080'],
+    },
+  },
+
+  firefox: {
+    browserName: 'firefox',
+    'moz:firefoxOptions': {
+      args: process.env.HEADLESS === 'true'
+        ? ['-headless', '-width=1920', '-height=1080']
+        : ['-width=1920', '-height=1080'],
+    },
+  },
+
+  browserstack: {
+    browserName: 'Chrome',
+    browserVersion: 'latest',
+    'bstack:options': {
+      os: 'Windows',
+      osVersion: '11',
+      userName: process.env.BROWSERSTACK_USERNAME,
+      accessKey: process.env.BROWSERSTACK_ACCESS_KEY,
+      projectName: 'Web Automation',
+      buildName: `Web Build ${Date.now()}`,
+      debug: true,
+      networkLogs: true,
+    },
+  },
+};
+```
+
+## Environment Variables
+
+```ini
+# .env.example
+
+# Android
+ANDROID_DEVICE_NAME=Pixel_5_API_31
+ANDROID_PLATFORM_VERSION=12.0
+ANDROID_APP_PATH=./apps/android/app.apk
+
+# iOS
+IOS_DEVICE_NAME=iPhone 14
+IOS_PLATFORM_VERSION=16.0
+IOS_APP_PATH=./apps/ios/App.app
+
+# BrowserStack
+BROWSERSTACK_USERNAME=your-username
+BROWSERSTACK_ACCESS_KEY=your-access-key
+BROWSERSTACK_ANDROID_APP_URL=bs://xxxxx
+BROWSERSTACK_IOS_APP_URL=bs://xxxxx
+
+# Web
+HEADLESS=false
+WEB_BASE_URL=https://staging.example.com
+```

package/templates/.claude/statusline.cjs

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+/**
+ * Claude Code Statusline - Cross-platform runner
+ * Detects user platform and executes the appropriate statusline script.
+ *
+ * Usage: This script reads JSON from stdin and outputs a formatted statusline.
+ * - Windows: Uses statusline.ps1 (PowerShell)
+ * - Unix/macOS: Uses statusline.sh (Bash)
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const os = require('os');
+
+const SCRIPT_DIR = __dirname;
+const IS_WINDOWS = os.platform() === 'win32';
+
+/**
+ * Get the appropriate script path and command based on platform
+ * @returns {{ command: string, args: string[] }}
+ */
+function getScriptConfig() {
+  if (IS_WINDOWS) {
+    const scriptPath = path.join(SCRIPT_DIR, 'statusline.ps1');
+    return {
+      command: 'powershell.exe',
+      args: [
+        '-ExecutionPolicy', 'Bypass',
+        '-NoProfile',
+        '-File', scriptPath
+      ]
+    };
+  }
+
+  const scriptPath = path.join(SCRIPT_DIR, 'statusline.sh');
+  return {
+    command: 'bash',
+    args: [scriptPath]
+  };
+}
+
+/**
+ * Collect all stdin data
+ * @returns {Promise<string>}
+ */
+function readStdin() {
+  return new Promise((resolve, reject) => {
+    let data = '';
+
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => {
+      data += chunk;
+    });
+    process.stdin.on('end', () => {
+      resolve(data);
+    });
+    process.stdin.on('error', reject);
+  });
+}
+
+/**
+ * Execute the platform-specific statusline script
+ * @param {string} stdinData - JSON data to pass to the script
+ * @returns {Promise<void>}
+ */
+function runStatuslineScript(stdinData) {
+  return new Promise((resolve, reject) => {
+    const config = getScriptConfig();
+
+    const proc = spawn(config.command, config.args, {
+      stdio: ['pipe', 'inherit', 'inherit'],
+      env: process.env
+    });
+
+    proc.stdin.write(stdinData);
+    proc.stdin.end();
+
+    proc.on('close', (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`Script exited with code ${code}`));
+      }
+    });
+
+    proc.on('error', (err) => {
+      reject(err);
+    });
+  });
+}
+
+/**
+ * Main entry point
+ */
+async function main() {
+  try {
+    const stdinData = await readStdin();
+    await runStatuslineScript(stdinData);
+  } catch (err) {
+    // Silent failure - statusline should not break the terminal
+    process.exit(1);
+  }
+}
+
+main();

package/templates/.claude/statusline.ps1

@@ -0,0 +1,187 @@
+# Custom Claude Code statusline - Windows PowerShell version
+# Theme: minimal | Colors: true | Features: git, model, devkit
+
+# Read input from stdin
+$input_data = $input | Out-String
+
+# ---- color helpers (force colors for Claude Code) ----
+$use_color = if ($env:NO_COLOR) { $false } else { $true }
+
+# ---- modern sleek colors ----
+function model_color { if ($use_color) { "`e[38;5;147m" } else { "" } }    # light purple
+function devkit_version_color { if ($use_color) { "`e[38;5;214m" } else { "" } } # orange
+function git_color { if ($use_color) { "`e[38;5;150m" } else { "" } }      # git green
+function update_color { if ($use_color) { "`e[38;5;208m" } else { "" } }   # bright orange
+function label_color { if ($use_color) { "`e[38;5;150m" } else { "" } }    # label color for session info
+function rst { if ($use_color) { "`e[0m" } else { "" } }
+
+# ---- extract data from JSON ----
+$model_name = "Claude"
+
+try {
+    $json_data = $input_data | ConvertFrom-Json -ErrorAction Stop
+    if ($json_data.model.display_name) {
+        $model_name = $json_data.model.display_name
+    }
+} catch {
+    # Fallback to regex parsing if JSON parsing fails
+    if ($input_data -match '"display_name"\s*:\s*"([^"]*)"') {
+        $model_name = $Matches[1]
+    }
+}
+
+# ---- git ----
+$git_branch = ""
+try {
+    $null = git rev-parse --git-dir 2>$null
+    if ($LASTEXITCODE -eq 0) {
+        $git_branch = git branch --show-current 2>$null
+        if (-not $git_branch) {
+            $git_branch = git rev-parse --short HEAD 2>$null
+        }
+    }
+} catch { }
+
+# ---- ensure ccusage is installed ----
+if (-not (Get-Command ccusage -ErrorAction SilentlyContinue)) {
+    # Install ccusage silently in background if npm is available
+    if (Get-Command npm -ErrorAction SilentlyContinue) {
+        Start-Job -ScriptBlock {
+            npm install -g ccusage *>$null
+        } | Out-Null
+    }
+}
+
+# ---- get plan usage from ccusage ----
+$session_reset = ""
+$session_pct = 0
+$session_cost = ""
+
+if (Get-Command ccusage -ErrorAction SilentlyContinue) {
+    try {
+        # Fetch blocks data with timeout
+        $blocks_output = ""
+        $job = Start-Job -ScriptBlock {
+            ccusage blocks --json 2>$null
+        }
+
+        # Wait up to 3 seconds
+        $completed = Wait-Job $job -Timeout 3
+        if ($completed) {
+            $blocks_output = Receive-Job $job
+        }
+        Remove-Job $job -Force -ErrorAction SilentlyContinue
+
+        if ($blocks_output) {
+            $blocks_data = $blocks_output | ConvertFrom-Json -ErrorAction SilentlyContinue
+            $active_block = $blocks_data.blocks | Where-Object { $_.isActive -eq $true } | Select-Object -First 1
+
+            if ($active_block) {
+                # Session timing
+                $end_time_str = $active_block.endTime
+                $start_time_str = $active_block.startTime
+                $block_cost = $active_block.costUSD
+                $block_tokens = $active_block.totalTokens
+
+                if ($end_time_str -and $start_time_str) {
+                    $now_sec = [int][double]::Parse((Get-Date -UFormat %s))
+                    $end_sec = [int][double]::Parse((Get-Date $end_time_str -UFormat %s))
+                    $remaining = $end_sec - $now_sec
+
+                    if ($remaining -gt 0) {
+                        $rh = [math]::Floor($remaining / 3600)
+                        $rm = [math]::Floor(($remaining % 3600) / 60)
+                        $session_reset = "${rh}h ${rm}m"
+                    } else {
+                        $session_reset = "expired"
+                    }
+                }
+            }
+        }
+    } catch {
+        # Silently fail if ccusage errors
+    }
+}
+
+# ---- version check (cached, once per hour) ----
+$update_available = ""
+if ($env:AI_DEVKIT_VERSION) {
+    $CACHE_FILE = Join-Path $env:TEMP ".ai-devkit-version-cache"
+    $CACHE_MAX_AGE = 3600  # 1 hour in seconds
+
+    # Check if cache exists and is fresh
+    $cache_valid = $false
+    if (Test-Path $CACHE_FILE) {
+        $cache_age = (Get-Date) - (Get-Item $CACHE_FILE).LastWriteTime
+        if ($cache_age.TotalSeconds -lt $CACHE_MAX_AGE) {
+            $cache_valid = $true
+        }
+    }
+
+    $latest_version = ""
+    if ($cache_valid) {
+        $latest_version = (Get-Content $CACHE_FILE -ErrorAction SilentlyContinue).Trim()
+    } else {
+        # Fetch latest version in background (non-blocking)
+        Start-Job -ScriptBlock {
+            param($CacheFile)
+            try {
+                $version = npm view @enouvo/ai-devkit version 2>$null
+                if ($version) {
+                    $version | Out-File -FilePath $CacheFile -NoNewline
+                }
+            } catch { }
+        } -ArgumentList $CACHE_FILE | Out-Null
+    }
+
+    # Compare versions if we have latest
+    if ($latest_version -and $latest_version -ne $env:AI_DEVKIT_VERSION) {
+        # Simple version comparison using [version] type
+        try {
+            $current = [version]$env:AI_DEVKIT_VERSION
+            $latest = [version]$latest_version
+            if ($latest -gt $current) {
+                $update_available = " $(update_color)(New version available!)$(rst)"
+            }
+        } catch {
+            # Fallback: string comparison if version parsing fails
+            if ($latest_version -gt $env:AI_DEVKIT_VERSION) {
+                $update_available = " $(update_color)(New version available!)$(rst)"
+            }
+        }
+    }
+}
+
+# ---- render: git, model, devkit ----
+$output = ""
+
+if ($git_branch) {
+    $output += "  `u{1F33F} $(git_color)$git_branch$(rst)"
+}
+$output += "  `u{1F916} $(model_color)$model_name$(rst)"
+if ($env:AI_DEVKIT_VERSION) {
+    $output += "  `u{1F9F0} $(devkit_version_color)DevKit v$($env:AI_DEVKIT_VERSION)$(rst)$update_available"
+}
+
+# ---- check if model is Claude (not GPT or Gemini) ----
+$is_claude_model = $true
+$model_lower = $model_name.ToLower()
+if ($model_lower -match "gpt|gemini") {
+    $is_claude_model = $false
+}
+
+# ---- render Line 2: session usage (Claude models only) ----
+$has_usage = $false
+
+# Session info from ccusage (only for Claude models)
+if ($is_claude_model -and $session_reset) {
+    if (-not $has_usage) {
+        $output += "`n    "
+        $has_usage = $true
+    }
+    $output += "`u{23F1}`u{FE0F}  Resets in $(label_color)$session_reset$(rst)"
+}
+
+$output += "`n"
+
+Write-Host -NoNewline $output