@shaykec/app-agent 1.0.8 → 1.0.10

package/README.md

@@ -36,6 +36,8 @@ AI-powered mobile app generator that turns a natural language description into a
 - **Quick build mode** -- skeleton template + fast inline customization + smoke test, no analysis overhead
 - **App management** -- list all previously built apps and re-launch any of them on a simulator/emulator
 - **Standalone UI testing** -- re-run UI testing on a previously built app without rebuilding from scratch
+- **Deep testing pipeline** -- code-analysis test planning + screenshot/accessibility-driven exploratory testing + structured test execution + detailed bug reports
+- **Standalone bug fixing** -- auto-fix bugs from a previous deep-test run without re-running the full test suite
 
 ## Installation
 
@@ -146,6 +148,9 @@ npm start -- -d "A pet grooming booking app called PawSpa"
 | `-s`, `--scratch` | Build from scratch using templates as reference instead of cloning (slower, more flexible) |
 | `-q`, `--quick` | Quick build -- skeleton template, fast inline customization, smoke test only |
 | `-u`, `--update <source>` | Update an existing app from a GitHub URL, local path, or app name. Creates a branch and PR. |
+| `--deep-test <name>` | Deep test: code analysis, exploratory + structured testing, bug report |
+| `--deep-test <name> --fix` | Deep test + auto-fix discovered bugs |
+| `--fix <name>` | Fix bugs from a previous deep-test bug report |
 
 Defaults can also be set via environment variables: `APPAGENT_ENGINE=cursor` or `APPAGENT_PLATFORM=android`.
 
@@ -183,7 +188,7 @@ $ npm run dev
 ●  [0s]   Model: claude-sonnet-4-5-20250929
 ●  [3s]   SUBAGENT dispatched: Select best iOS template
 ●  [3s]   SUBAGENT dispatched: Select best design brand
-●  [10s]  Report: 02-template-selection.md
+●  [10s]  Report: 02-catalog-analysis.md
 ●  [11s]  SHELL: cp -r templates/ios/ShopTemplate/ output/vinylvault-ios/
 ●  [30s]  Report: 05-content-brief.md
 ●  [60s]  Progress: 48 tool calls, 15 writes, 28 reads
@@ -270,6 +275,57 @@ The `--test` command reads the app's `summary.json` and `customization-manifest.
 
 If the build artifact has been cleaned (e.g., DerivedData was deleted), the agent will automatically rebuild the app before testing.
 
+### Deep test a previously built app
+
+The `--deep-test` command runs a comprehensive 4-phase testing pipeline that goes far beyond the standard `--test` command:
+
+1. **Phase 1: Test Plan Generation** (offline) -- analyzes source code (Views, ViewModels, AppConfig, MockDataProvider) to build a structured test matrix with per-screen checklists, edge cases, and regression checks
+2. **Phase 2: Exploratory Testing** -- an AI tester explores the app using only screenshots and the accessibility tree (does NOT read source code), finding visual bugs, accessibility issues, UX problems, and template leftovers
+3. **Phase 3: Structured Testing** -- follows the test plan from Phase 1, systematically verifying each test case
+4. **Phase 4: Auto-Fix** (optional) -- reads the bug report and fixes each bug, rebuilds, and verifies
+
+Phases 2 and 3 run in **parallel** on separate simulators -- the exploratory tester discovers issues code analysis can't predict, while the structured tester verifies known requirements.
+
+```bash
+# Deep test only (generates test plan + bug report)
+npm start -- --deep-test vinylvault-ios
+
+# Deep test + auto-fix discovered bugs
+npm start -- --deep-test vinylvault-ios --fix
+
+# With npx
+npx @shaykec/app-agent --deep-test vinylvault-ios
+npx @shaykec/app-agent --deep-test vinylvault-ios --fix
+
+# Specify engine and model
+npx @shaykec/app-agent --deep-test vinylvault-ios --engine claude --model sonnet-4.5
+```
+
+**Reports generated:**
+- `reports/10-test-plan.md` -- structured test matrix with per-screen checklists
+- `reports/11-bug-report.md` -- merged bug report from exploratory + structured testing
+- `reports/12-fix-report.md` -- fix details with root causes and verification results (only with `--fix`)
+
+**How it differs from `--test`:**
+- Generates a test plan before testing (visibility into what will be tested)
+- Adds exploratory testing driven by screenshots + accessibility tree
+- Produces a structured bug report with severity classifications (P0-P3)
+- Supports standalone fix mode
+
+### Fix bugs from a deep test
+
+The `--fix` command is a standalone mode that reads an existing bug report from a previous `--deep-test` run and fixes the documented bugs without re-running the full test suite.
+
+```bash
+# Fix bugs from a previous deep-test
+npm start -- --fix vinylvault-ios
+
+# With npx
+npx @shaykec/app-agent --fix vinylvault-ios
+```
+
+The agent reads `reports/11-bug-report.md`, prioritizes bugs (P0 Critical → P3 Low), applies minimal fixes, rebuilds, and verifies each fix on a simulator. The fix report is written to `reports/12-fix-report.md`.
+
 ### Build from scratch
 
 By default, AppAgent clones a template and customizes it. The `--scratch` flag enables a from-scratch mode where the agent reads templates as architectural reference and writes all code itself. This is useful when:
@@ -432,17 +488,18 @@ Two speed tiers:
 │   ├── agent-prompt.md           # Template-mode build prompt (default)
 │   ├── scratch-agent-prompt.md   # From-scratch build prompt (used by --scratch)
 │   ├── quick-agent-prompt.md     # Quick build prompt (used by --quick)
-│   ├── update-agent-prompt.md   # Update mode prompt (used by --update)
-│   └── test-agent-prompt.md      # UI testing prompt template (used by --test)
+│   ├── update-agent-prompt.md    # Update mode prompt (used by --update)
+│   ├── test-agent-prompt.md      # UI testing prompt template (used by --test)
+│   ├── deep-test-agent-prompt.md # Deep testing prompt (used by --deep-test)
+│   └── fix-agent-prompt.md       # Bug fix prompt (used by --fix)
 │
 ├── CLAUDE.md                     # Claude Code always-applied rules (workflow + safety)
 │
 ├── .cursor/                      # Cursor CLI engine configuration
 │   ├── skills/                   # Skills (step-by-step procedures the agent follows)
 │   │   ├── prompt-validator/     # Step 0: Validate prompt for injection/malice
-│   │   ├── template-selector/    # Step 0: Pick the best template
+│   │   ├── catalog-analyzer/     # Step 0: Pick the best template + shared modules
 │   │   ├── design-selector/      # Step 0: Pick the best design brand
-│   │   ├── module-selector/      # Step 0: Pick shared modules by keyword
 │   │   ├── module-integrator/    # Step 4: Read module references and write adapted code
 │   │   ├── app-renaming/         # Step 2: Rename app consistently
 │   │   ├── customization-planner/ # Step 3: Produce customization manifest
@@ -455,7 +512,10 @@ Two speed tiers:
 │   │   ├── build-tester/         # Step 6: Compile and report errors
 │   │   ├── code-auditor/         # Step 7: Security code audit
 │   │   ├── output-validator/     # Step 7: Completeness/consistency check
-│   │   └── ui-tester/            # Steps 8-10: Simulator testing + Maestro
+│   │   ├── ui-tester/            # Steps 8-10: Simulator testing + Maestro
+│   │   ├── test-planner/         # Deep-test Phase 1: Code analysis → test plan
+│   │   ├── exploratory-tester/   # Deep-test Phase 2: Screenshot + a11y testing
+│   │   └── bug-fixer/            # Deep-test Phase 4: Fix bugs from report
 │   │
 │   ├── agents/                   # Subagent definitions (read inline by Cursor)
 │   ├── rules/                    # Agent rules (always-on guardrails)
@@ -508,8 +568,7 @@ Two speed tiers:
         ├── {app source files}
         ├── reports/              # Audit trail from each workflow step
         │   ├── 01-prompt-validation.md
-        │   ├── 02-template-selection.md
-        │   ├── 02b-module-selection.md
+        │   ├── 02-catalog-analysis.md
         │   ├── 03-design-brand.md
         │   ├── customization-manifest.md
         │   ├── 04-content-brief.md
@@ -539,9 +598,8 @@ flowchart TD
 
     subgraph Step0 ["Step 0 PARALLEL — 4 Subagents"]
         PV[["prompt-validator"]]
-        TS[["template-selector"]]
+        CA[["catalog-analyzer"]]
         DS[["design-selector"]]
-        MS[["module-selector"]]
     end
 
     Step0 -->|"Validation FAIL"| Abort(["ABORT"])
@@ -597,7 +655,7 @@ flowchart TD
 
 | Step | Action | Parallelism | Skill | Report |
 |------|--------|-------------|-------|--------|
-| 0 | Validate prompt + select template + select design + select modules | **4 parallel tasks** | `prompt-validator`, `template-selector`, `design-selector`, `module-selector` | `01-prompt-validation.md`, `02-template-selection.md`, `03-design-brand.md`, `02b-module-selection.md` |
+| 0 | Validate prompt + catalog analysis + select design | **3 parallel tasks** | `prompt-validator`, `catalog-analyzer`, `design-selector` | `01-prompt-validation.md`, `02-catalog-analysis.md`, `03-design-brand.md` |
 | 1 | Clone template to `output/` | -- | -- | -- |
 | 4 | Integrate shared modules | -- | `module-integrator` | -- |
 | 2 | Rename the app | -- | `app-renaming` | -- |
@@ -629,6 +687,14 @@ Every skill writes a markdown report to `output/{app-name}/reports/`. A `summary
 }
 ```
 
+The `--deep-test` pipeline generates additional reports:
+
+| Report | Generated By | Description |
+|--------|-------------|-------------|
+| `10-test-plan.md` | `test-planner` skill | Structured test matrix with per-screen checklists, edge cases, regression checks |
+| `11-bug-report.md` | `exploratory-tester` + `ui-tester` | Merged bug report with severity (P0-P3) and category tags |
+| `12-fix-report.md` | `bug-fixer` skill | Fix details, root causes, files modified, verification results (only with `--fix`) |
+
 ## Template Catalog
 
 14 production-ready templates, each available for both iOS (Swift/SwiftUI) and Android (Kotlin/Jetpack Compose):

package/designs/DESIGN_CATALOG.md

@@ -8,21 +8,23 @@
 
 ## Decision Matrix
 
-| Brand | Tone | Best-For Keywords |
-|-------|------|------------------|
-| ModernMinimal | minimal | clean, simple, productivity, tools, notes, tasks, utilities, dev tools, calculator, scanner, minimalist |
-| VibrantPlayful | playful | fun, colorful, kids, pets, games, social, casual food, party, events, birthday, rewards, stickers |
-| CorporateProfessional | professional | business, finance, legal, medical, enterprise, B2B, insurance, banking, consulting, HR, compliance |
-| DarkLuxe | bold | luxury, premium, nightlife, music, fashion, high-end retail, VIP, concierge, wine, jewelry, watches |
-| NatureOrganic | playful | nature, eco, organic, wellness, outdoor, garden, farm, hiking, sustainability, herbal, plant-based |
-| NeoBrutalist | bold | creative, media, agency, youth, raw, edgy, art, magazine, portfolio, streetwear, punk, indie |
-| SoftGradient | playful | calm, meditation, weather, dating, lifestyle, sleep, mood, journal, affirmations, self-care, astrology |
-| TechDynamic | bold | fitness, sport, automotive, gaming, tech, fast, performance, racing, esports, crypto, dashboard |
-| KidsPlayful | fun | children, kids, toddler, education, learning, ABCs, math, family, safe, COPPA, parenting, school, ages 3-12 |
-| MedicalClinical | clinical | health, medical, telemedicine, patient, hospital, pharmacy, symptoms, HIPAA, clinical, doctor, nurse, wellness |
-| RetroVintage | nostalgic | vintage, retro, coffee, artisan, handmade, bookstore, analog, nostalgia, craft, antique, journal, photography |
-| SportAthletic | energetic | athletic, sport, training, competition, running, cycling, gym, Nike-like, Adidas-like, race, team, coach |
-| AccessibleHighContrast | inclusive | accessible, high contrast, WCAG AAA, elderly, vision, inclusive, government, public service, universal design |
+| Brand | Tone | Energy | Best-For Keywords |
+|-------|------|--------|------------------|
+| ModernMinimal | minimal | 1 | clean, simple, productivity, tools, notes, tasks, utilities, dev tools, calculator, scanner, minimalist |
+| VibrantPlayful | playful | 5 | fun, colorful, kids, pets, games, social, casual food, party, events, birthday, rewards, stickers |
+| CorporateProfessional | professional | 1 | business, finance, legal, medical, enterprise, B2B, insurance, banking, consulting, HR, compliance |
+| DarkLuxe | bold | 3 | luxury, premium, nightlife, music, fashion, high-end retail, VIP, concierge, wine, jewelry, watches |
+| NatureOrganic | playful | 2 | nature, eco, organic, wellness, outdoor, garden, farm, hiking, sustainability, herbal, plant-based |
+| NeoBrutalist | bold | 4 | creative, media, agency, youth, raw, edgy, art, magazine, portfolio, streetwear, punk, indie |
+| SoftGradient | playful | 3 | calm, meditation, weather, dating, lifestyle, sleep, mood, journal, affirmations, self-care, astrology |
+| TechDynamic | bold | 4 | fitness, sport, automotive, gaming, tech, fast, performance, racing, esports, crypto, dashboard |
+| KidsPlayful | fun | 5 | children, kids, toddler, education, learning, ABCs, math, family, safe, COPPA, parenting, school, ages 3-12 |
+| MedicalClinical | clinical | 1 | health, medical, telemedicine, patient, hospital, pharmacy, symptoms, HIPAA, clinical, doctor, nurse, wellness |
+| RetroVintage | nostalgic | 2 | vintage, retro, coffee, artisan, handmade, bookstore, analog, nostalgia, craft, antique, journal, photography |
+| SportAthletic | energetic | 4 | athletic, sport, training, competition, running, cycling, gym, Nike-like, Adidas-like, race, team, coach |
+| AccessibleHighContrast | inclusive | 1 | accessible, high contrast, WCAG AAA, elderly, vision, inclusive, government, public service, universal design |
+
+> **Energy** (1-5): How visually dynamic and animated the brand feels. Higher = more shadows, gradients, animations, micro-interactions. When brands tie on match score, prefer higher energy. For ambiguous domains, bias toward Energy >= 3.
 
 ---
 

package/designs/DESIGN_PRINCIPLES.md

@@ -264,3 +264,56 @@
 - Tab bar / Bottom navigation: 49-80pt (plus safe area)
 - Content top padding: 16pt below navigation bar
 - Content bottom padding: 16pt above tab bar (before safe area)
+
+## Visual Effects Tokens
+
+These tokens control visual depth, motion, and polish. Every brand MUST define values for these categories.
+
+### Shadow System
+
+All apps MUST use shadows for visual depth. Cards, elevated surfaces, FABs, and modals should have appropriate shadow levels.
+
+| Token | Blur | Y-Offset | Opacity | Usage |
+|-------|------|----------|---------|-------|
+| shadowSmall | 4pt/dp | 2pt/dp | 6% | Chips, badges, subtle elevation |
+| shadowMedium | 8pt/dp | 4pt/dp | 8% | Cards, list items, elevated surfaces |
+| shadowLarge | 16pt/dp | 8pt/dp | 12% | FABs, floating elements, modals |
+
+Shadow color: neutral (black) by default. Brands may override with primary-tinted shadows (e.g., primary at 10% opacity) for a more vibrant look. Colored shadows are preferred for playful/bold brands.
+
+### Gradient System
+
+Gradients add visual richness. Use sparingly on key surfaces — hero sections, primary CTAs, onboarding backgrounds.
+
+| Token | Direction | Usage |
+|-------|-----------|-------|
+| primaryGradient | 135deg (top-left to bottom-right) | Hero sections, prominent CTAs, onboarding |
+| accentGradient | 135deg | Secondary actions, badges, decorative elements |
+| subtleGradient | 180deg (top to bottom) | Section backgrounds, surface variation |
+
+Gradient stops derived from brand palette: primaryGradient uses primary → secondary, accentGradient uses secondary → tertiary, subtleGradient uses surfaceVariant → background. Brands define their own stop colors.
+
+### Animation Presets
+
+Motion brings interfaces to life. All apps should have entrance animations, press feedback, and state change animations.
+
+| Token | Response | Damping | Usage |
+|-------|----------|---------|-------|
+| springBouncy | 0.4s | 0.65 | Playful brands, toggles, celebrations, exaggerated feedback |
+| springSmooth | 0.5s | 0.85 | Professional brands, navigation transitions, subtle fades |
+| springSnappy | 0.3s | 0.75 | Bold/tech brands, press feedback, quick responses |
+| staggerDelay | 50ms | — | Delay between consecutive list item entrance animations |
+| pressScale | 0.95 | — | Button/card scale factor on press (springs back to 1.0) |
+
+Each brand selects which spring preset to use as its default. All animations MUST respect system Reduce Motion preferences.
+
+### Elevation System
+
+Consistent elevation creates visual hierarchy. Higher elevation = more prominent.
+
+| Level | iOS Shadow | Android Elevation | React Native |
+|-------|-----------|-------------------|-------------|
+| elevationNone | no shadow | 0dp | elevation: 0 |
+| elevationLow | shadow(radius: 2, y: 1) | 2dp | elevation: 2 |
+| elevationMedium | shadow(radius: 8, y: 4) | 4dp | elevation: 4 |
+| elevationHigh | shadow(radius: 16, y: 8) | 8dp | elevation: 8 |

package/designs/brands/accessible-high-contrast.md

@@ -93,6 +93,20 @@
 
 ---
 
+## Motion & Effects
+
+| Token | Value | Notes |
+|-------|-------|-------|
+| Default spring | `springSmooth` | Gentle transitions; must respect `prefers-reduced-motion` |
+| Press scale | 0.96 | Subtle feedback — not disorienting |
+| Stagger delay | 60ms | Slow, trackable entrance for cognitive accessibility |
+| Shadow style | neutral | Visible shadows paired with 2pt borders |
+| Gradient usage | none | NO gradients — high contrast requires flat colors |
+| Depth approach | borders | Thick 2pt borders are the primary depth indicator |
+| Haptic | key actions only | On confirmations, errors — never decorative |
+
+---
+
 ## Do's and Don'ts
 
 ### Do

package/designs/brands/corporate-professional.md

@@ -81,6 +81,20 @@
 
 ---
 
+## Motion & Effects
+
+| Token | Value | Notes |
+|-------|-------|-------|
+| Default spring | `springSmooth` | Professional, predictable transitions |
+| Press scale | 0.96 | Subtle, restrained feedback |
+| Stagger delay | 50ms | Measured list entrance |
+| Shadow style | neutral | Standard gray shadows — nothing decorative |
+| Gradient usage | none | NO gradients — solid, trustworthy surfaces |
+| Depth approach | elevation | Standard Material-style elevation system |
+| Haptic | key actions only | On confirmations, form submissions |
+
+---
+
 ## Do's and Don'ts
 
 ### Do

package/designs/brands/dark-luxe.md

@@ -83,6 +83,20 @@ Note: This brand is dark-first. The "light mode" is a warm gray variant, not pur
 
 ---
 
+## Motion & Effects
+
+| Token | Value | Notes |
+|-------|-------|-------|
+| Default spring | `springSmooth` | Elegant, unhurried transitions |
+| Press scale | 0.96 | Barely perceptible — luxury is subtle |
+| Stagger delay | 50ms | Measured, graceful cascade |
+| Shadow style | colored (gold at 8%) | Warm gold-tinted shadows in dark mode |
+| Gradient usage | hero + CTA | Subtle gold-to-champagne on premium surfaces |
+| Depth approach | shadows + glow | Subtle glow in dark mode, soft shadows in light |
+| Haptic | key actions only | On premium interactions — purchases, favorites |
+
+---
+
 ## Do's and Don'ts
 
 ### Do

package/designs/brands/kids-playful.md

@@ -88,6 +88,20 @@
 
 ---
 
+## Motion & Effects
+
+| Token | Value | Notes |
+|-------|-------|-------|
+| Default spring | `springBouncy` | High bounce (0.6+) for fun, exaggerated motion |
+| Press scale | 0.90 | Big squish — satisfying for small hands |
+| Stagger delay | 50ms | Visible cascade that children can follow |
+| Shadow style | colored (primary at 12%) | Bright, friendly colored shadows |
+| Gradient usage | everywhere | Backgrounds, cards, buttons — color is fun |
+| Depth approach | shadows | Soft, colorful shadows define layers |
+| Haptic | all taps | Every tap gives feedback for children |
+
+---
+
 ## Do's and Don'ts
 
 ### Do

package/designs/brands/medical-clinical.md

@@ -91,6 +91,20 @@
 
 ---
 
+## Motion & Effects
+
+| Token | Value | Notes |
+|-------|-------|-------|
+| Default spring | `springSmooth` | Calm, ease-in-out only — no bounce or spring |
+| Press scale | 0.97 | Near-invisible — clinical precision |
+| Stagger delay | 50ms | Gentle, non-distracting entrance |
+| Shadow style | neutral | Minimal, clean shadows |
+| Gradient usage | none | NO gradients — clinical clarity |
+| Depth approach | elevation | Standard subtle elevation |
+| Haptic | none | No haptic — avoid sensory surprises in medical context |
+
+---
+
 ## Do's and Don'ts
 
 ### Do

package/designs/brands/modern-minimal.md

@@ -81,6 +81,20 @@
 
 ---
 
+## Motion & Effects
+
+| Token | Value | Notes |
+|-------|-------|-------|
+| Default spring | `springSmooth` | Subtle, barely-there transitions |
+| Press scale | 0.97 | Near-invisible press — motion is minimal |
+| Stagger delay | 50ms | Gentle fade-in, not bouncy cascade |
+| Shadow style | neutral (faint) | Near-invisible shadows; prefer borders |
+| Gradient usage | none | NO gradients — solid colors only |
+| Depth approach | flat / borders | Thin borders and spacing define hierarchy |
+| Haptic | none | No haptic — minimal sensory footprint |
+
+---
+
 ## Do's and Don'ts
 
 ### Do

package/designs/brands/nature-organic.md

@@ -82,6 +82,20 @@
 
 ---
 
+## Motion & Effects
+
+| Token | Value | Notes |
+|-------|-------|-------|
+| Default spring | `springSmooth` | Organic, flowing motion |
+| Press scale | 0.96 | Gentle press — soft, not aggressive |
+| Stagger delay | 60ms | Natural, unhurried cascade |
+| Shadow style | colored (warm brown at 6%) | Warm earth-tinted shadows |
+| Gradient usage | subtle | Subtle warm gradients on section backgrounds only |
+| Depth approach | shadows | Soft, warm shadows (no borders) |
+| Haptic | key actions only | On plant watering, check-in, save actions |
+
+---
+
 ## Do's and Don'ts
 
 ### Do

package/designs/brands/neo-brutalist.md

@@ -81,6 +81,20 @@
 
 ---
 
+## Motion & Effects
+
+| Token | Value | Notes |
+|-------|-------|-------|
+| Default spring | `springSnappy` | Quick, raw, no-frills motion |
+| Press scale | 0.94 | Firm, deliberate press feedback |
+| Stagger delay | 40ms | Snappy cascade |
+| Shadow style | none | NO shadows — thick borders define structure |
+| Gradient usage | none | NO gradients — raw, flat aesthetic |
+| Depth approach | borders | 3pt borders define all edges and layers |
+| Haptic | key actions only | On submit, delete, key structural interactions |
+
+---
+
 ## Do's and Don'ts
 
 ### Do

package/designs/brands/retro-vintage.md

@@ -82,6 +82,20 @@
 
 ---
 
+## Motion & Effects
+
+| Token | Value | Notes |
+|-------|-------|-------|
+| Default spring | `springSmooth` | Gentle, unhurried — nothing flashy |
+| Press scale | 0.95 | Subtle press feedback |
+| Stagger delay | 60ms | Leisurely cascade, relaxed feel |
+| Shadow style | colored (warm brown at 8%) | Warm sepia-tinted shadows |
+| Gradient usage | none | No gradients — this brand is about texture, not effects |
+| Depth approach | shadows | Warm-tinted soft shadows only |
+| Haptic | key actions only | On saves, favorites, key confirmations |
+
+---
+
 ## Do's and Don'ts
 
 ### Do

package/designs/brands/soft-gradient.md

@@ -96,6 +96,20 @@ All gradients flow **top-left to bottom-right** (135 degrees).
 
 ---
 
+## Motion & Effects
+
+| Token | Value | Notes |
+|-------|-------|-------|
+| Default spring | `springSmooth` | Gentle, flowing transitions match the dreamy tone |
+| Press scale | 0.95 | Subtle press — nothing jarring |
+| Stagger delay | 60ms | Slow, graceful cascade |
+| Shadow style | colored (primary at 8%) | Soft violet-tinted shadows |
+| Gradient usage | hero + CTA + sections | Signature element — gradients everywhere appropriate |
+| Depth approach | shadows | Soft, diffused shadows (no borders) |
+| Haptic | key actions only | Subtle — only on submit, favorite, important taps |
+
+---
+
 ## Do's and Don'ts
 
 ### Do

package/designs/brands/sport-athletic.md

@@ -87,6 +87,20 @@
 
 ---
 
+## Motion & Effects
+
+| Token | Value | Notes |
+|-------|-------|-------|
+| Default spring | `springSnappy` | Fast, aggressive — 200ms or less |
+| Press scale | 0.93 | Firm press for competitive energy |
+| Stagger delay | 30ms | Rapid-fire list entrances |
+| Shadow style | neutral | Strong, defined shadows for depth |
+| Gradient usage | hero + CTA | Bold red-to-orange on key surfaces |
+| Depth approach | elevation | Strong elevation with visible shadows |
+| Haptic | all taps | Every interaction gets physical feedback |
+
+---
+
 ## Do's and Don'ts
 
 ### Do

package/designs/brands/tech-dynamic.md

@@ -98,6 +98,20 @@ This brand is data-heavy. Use these colors for charts, graphs, and metrics:
 
 ---
 
+## Motion & Effects
+
+| Token | Value | Notes |
+|-------|-------|-------|
+| Default spring | `springSnappy` | Fast, responsive — performance-oriented feel |
+| Press scale | 0.95 | Quick, controlled compression |
+| Stagger delay | 30ms | Rapid cascade for data-dense lists |
+| Shadow style | neutral | Clean shadows; glow effects in dark mode only |
+| Gradient usage | hero + CTA | Blue-to-cyan gradients on key surfaces |
+| Depth approach | elevation | Standard elevation system + dark mode glow |
+| Haptic | key actions only | On data refreshes, confirmations, key interactions |
+
+---
+
 ## Do's and Don'ts
 
 ### Do

package/designs/brands/vibrant-playful.md

@@ -81,6 +81,20 @@
 
 ---
 
+## Motion & Effects
+
+| Token | Value | Notes |
+|-------|-------|-------|
+| Default spring | `springBouncy` | Playful, exaggerated feedback on interactions |
+| Press scale | 0.92 | Noticeable squish on tap for tactile feel |
+| Stagger delay | 40ms | Quick cascade for energetic list entrances |
+| Shadow style | colored (primary at 10%) | Soft, primary-tinted shadows on cards |
+| Gradient usage | hero + CTA | Header backgrounds and primary action buttons |
+| Depth approach | shadows | Soft colored shadows define elevation |
+| Haptic | all taps | Every interactive element gets haptic feedback |
+
+---
+
 ## Do's and Don'ts
 
 ### Do

package/dist/cli.d.ts

@@ -13,14 +13,16 @@ export interface CliParseResult {
     input: UserInput;
     flags: CliFlags;
 }
-/** Result when a management command (--list, --run, --test, --preview, --screenshot, --configure) is detected */
+/** Result when a management command (--list, --run, --test, --deep-test, --fix, --preview, --screenshot, --configure) is detected */
 export interface ManagementCommand {
-    command: "list" | "run" | "test" | "preview" | "screenshot" | "configure";
+    command: "list" | "run" | "test" | "deep-test" | "fix" | "preview" | "screenshot" | "configure";
     appName?: string;
     engine?: Engine;
     model?: Model;
     keysFile?: string;
     skipVerify?: boolean;
+    /** Whether --fix flag was passed alongside --deep-test */
+    autoFix?: boolean;
 }
 /** Result from interactive mode: either a build input or a management command */
 export type InteractiveResult = {

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA2B,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIrF,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAE9B,mDAAmD;AACnD,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,iHAAiH;AACjH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,iFAAiF;AACjF,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,iBAAiB,GAAG,IAAI,CAgGjE;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,cAAc,GAAG,IAAI,CAyGpD;AAED;;;GAGG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CA4D/C;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CA4LnE;AAoHD,uEAAuE;AACvE,wBAAsB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAkDrE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA2B,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIrF,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAE9B,mDAAmD;AACnD,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,qIAAqI;AACrI,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,WAAW,GAAG,KAAK,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,iFAAiF;AACjF,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,iBAAiB,GAAG,IAAI,CAqKjE;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,cAAc,GAAG,IAAI,CAyGpD;AAED;;;GAGG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CA4D/C;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAoNnE;AAoHD,uEAAuE;AACvE,wBAAsB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAkDrE"}