agent-device 0.6.3 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +55 -7
- package/dist/src/bin.js +43 -34
- package/dist/src/daemon.js +29 -26
- package/ios-runner/AgentDeviceRunner/AgentDeviceRunner.xcodeproj/project.pbxproj +14 -6
- package/ios-runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests.swift +104 -4
- package/package.json +4 -2
- package/skills/agent-device/SKILL.md +24 -2
- package/skills/agent-device/references/logs-and-debug.md +5 -0
- package/skills/agent-device/references/perf-metrics.md +53 -0
- package/skills/dogfood/SKILL.md +183 -0
- package/skills/dogfood/references/issue-taxonomy.md +83 -0
- package/skills/dogfood/templates/dogfood-report-template.md +52 -0
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
# Issue Taxonomy (Mobile)
|
|
2
|
+
|
|
3
|
+
Reference for categorizing issues found during mobile dogfooding.
|
|
4
|
+
|
|
5
|
+
## Severity Levels
|
|
6
|
+
|
|
7
|
+
| Severity | Definition |
|
|
8
|
+
|----------|------------|
|
|
9
|
+
| **critical** | Blocks a core workflow, causes data loss, or crashes/freeze loops the app |
|
|
10
|
+
| **high** | Major feature broken or unusable, no practical workaround |
|
|
11
|
+
| **medium** | Feature works with notable friction or partial failure; workaround exists |
|
|
12
|
+
| **low** | Minor cosmetic or polish issue |
|
|
13
|
+
|
|
14
|
+
## Categories
|
|
15
|
+
|
|
16
|
+
### Visual / UI
|
|
17
|
+
|
|
18
|
+
- Layout broken, clipped, overlapped, or unreadable text
|
|
19
|
+
- Safe-area/notch overlap issues
|
|
20
|
+
- Incorrect dark/light appearance rendering
|
|
21
|
+
- Missing assets/icons
|
|
22
|
+
- Animation glitches or flicker
|
|
23
|
+
|
|
24
|
+
### Functional
|
|
25
|
+
|
|
26
|
+
- Buttons/controls do nothing or trigger wrong action
|
|
27
|
+
- Flows fail (create/edit/delete/submit)
|
|
28
|
+
- Navigation dead-ends or wrong destination
|
|
29
|
+
- State loss after background/foreground transitions
|
|
30
|
+
- Deep link opens wrong screen or fails
|
|
31
|
+
|
|
32
|
+
### UX
|
|
33
|
+
|
|
34
|
+
- Confusing hierarchy or navigation labels
|
|
35
|
+
- Missing loading/progress feedback
|
|
36
|
+
- Unclear error handling or no recovery affordance
|
|
37
|
+
- Excessive steps for common tasks
|
|
38
|
+
- Inconsistent behavior between similar screens
|
|
39
|
+
|
|
40
|
+
### Content
|
|
41
|
+
|
|
42
|
+
- Typos, incorrect copy, placeholder text
|
|
43
|
+
- Wrong labels/help text
|
|
44
|
+
- Truncated text with no affordance
|
|
45
|
+
- Inconsistent terminology across screens
|
|
46
|
+
|
|
47
|
+
### Performance
|
|
48
|
+
|
|
49
|
+
- Slow startup or route transitions
|
|
50
|
+
- Input lag or gesture jank
|
|
51
|
+
- Scroll hitches/frame drops
|
|
52
|
+
- Notable battery/thermal symptoms during basic usage
|
|
53
|
+
|
|
54
|
+
### Diagnostics / Logs
|
|
55
|
+
|
|
56
|
+
- Native crashes or repeated fatal exceptions
|
|
57
|
+
- Repeated warnings correlated with broken behavior
|
|
58
|
+
- Unhandled runtime errors visible during repro
|
|
59
|
+
|
|
60
|
+
### Permissions / Platform
|
|
61
|
+
|
|
62
|
+
- Permission prompt flow broken or loops forever
|
|
63
|
+
- Denied permissions not handled gracefully
|
|
64
|
+
- Platform-specific regressions (iOS-only or Android-only)
|
|
65
|
+
- Background/foreground lifecycle regressions
|
|
66
|
+
|
|
67
|
+
### Accessibility
|
|
68
|
+
|
|
69
|
+
- Missing labels or incorrect accessibility names
|
|
70
|
+
- Focus order/navigation issues for assistive tech
|
|
71
|
+
- Low contrast or unreadable text scaling
|
|
72
|
+
- Touch targets too small for reliable interaction
|
|
73
|
+
|
|
74
|
+
## Exploration Checklist
|
|
75
|
+
|
|
76
|
+
1. Visual scan: capture screenshot; verify layout/safe areas/text/icon rendering.
|
|
77
|
+
2. Interactions: press controls, open menus/modals, validate expected response.
|
|
78
|
+
3. Forms/input: test valid/invalid/empty/boundary input.
|
|
79
|
+
4. Navigation: traverse all top-level sections and return paths.
|
|
80
|
+
5. App states: loading/empty/error/offline/permission-denied/background-resume.
|
|
81
|
+
6. Logs/diagnostics: inspect app logs when behavior is suspicious.
|
|
82
|
+
7. Platform parity: verify critical flows on each requested platform.
|
|
83
|
+
8. Accessibility basics: labels, touch target sizes, readability/contrast.
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Dogfood Report: {APP_NAME}
|
|
2
|
+
|
|
3
|
+
| Field | Value |
|
|
4
|
+
|-------|-------|
|
|
5
|
+
| **Date** | {DATE} |
|
|
6
|
+
| **Platform** | {PLATFORM} |
|
|
7
|
+
| **Target App** | {TARGET_APP} |
|
|
8
|
+
| **Session** | {SESSION_NAME} |
|
|
9
|
+
| **Scope** | {SCOPE} |
|
|
10
|
+
|
|
11
|
+
## Summary
|
|
12
|
+
|
|
13
|
+
| Severity | Count |
|
|
14
|
+
|----------|-------|
|
|
15
|
+
| Critical | 0 |
|
|
16
|
+
| High | 0 |
|
|
17
|
+
| Medium | 0 |
|
|
18
|
+
| Low | 0 |
|
|
19
|
+
| **Total** | **0** |
|
|
20
|
+
|
|
21
|
+
## Issues
|
|
22
|
+
|
|
23
|
+
<!-- Copy this block for each issue found. Interactive issues need video + step screenshots. Static issues can be screenshot-only (Repro Video = N/A). -->
|
|
24
|
+
|
|
25
|
+
### ISSUE-001: {Short title}
|
|
26
|
+
|
|
27
|
+
| Field | Value |
|
|
28
|
+
|-------|-------|
|
|
29
|
+
| **Severity** | critical / high / medium / low |
|
|
30
|
+
| **Category** | visual / functional / ux / content / performance / diagnostics / permissions / accessibility |
|
|
31
|
+
| **Screen / Route** | {screen where issue was found} |
|
|
32
|
+
| **Repro Video** | {path to video, or N/A for static issues} |
|
|
33
|
+
|
|
34
|
+
**Description**
|
|
35
|
+
|
|
36
|
+
{What is wrong, what was expected, and what actually happened.}
|
|
37
|
+
|
|
38
|
+
**Repro Steps**
|
|
39
|
+
|
|
40
|
+
1. Open {screen/entry point}
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
2. {Action}
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
3. {Action}
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
4. **Observe:** {broken behavior}
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
---
|