yam-flow 0.1.3 → 0.1.4
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/CHANGELOG.md +36 -0
- package/COMMANDS.md +28 -1
- package/README.md +17 -2
- package/ROADMAP.md +5 -5
- package/dist/bin/yam.js +579 -31
- package/package.json +3 -2
- package/references/current-docs.md +3 -3
- package/references/doctor-scan.md +19 -0
- package/references/final-report.md +21 -0
- package/references/hook-lite.md +1 -1
- package/references/memory.md +1 -1
- package/references/mission.md +25 -0
- package/references/runtime-orchestration.md +25 -1
- package/references/tool-trust-layer.md +100 -6
- package/references/ueye-proof.md +34 -5
- package/references/ueye.md +24 -2
- package/skills/question/SKILL.md +1 -1
- package/skills/ueye/SKILL.md +10 -5
- package/src/bin/yam.ts +577 -31
- package/templates/mission-plan.md +12 -0
- package/templates/runtime-proof.md +41 -2
- package/templates/tuning-log.md +11 -1
- package/templates/ueye-comparison.md +44 -0
- package/templates/ueye-review.md +44 -0
- package/templates/yam.project.md +2 -2
|
@@ -36,6 +36,18 @@ Patch envelope:
|
|
|
36
36
|
- verification_hint:
|
|
37
37
|
- truth_status: verified / partial / skipped / blocked / assumed
|
|
38
38
|
|
|
39
|
+
Patch queue lite:
|
|
40
|
+
- status: pending / applied / verified / reverted / blocked
|
|
41
|
+
- lane_id:
|
|
42
|
+
- depends_on:
|
|
43
|
+
- assigned_scope:
|
|
44
|
+
- changed_files:
|
|
45
|
+
- verification_hint:
|
|
46
|
+
- rollback_hint:
|
|
47
|
+
- truth_status:
|
|
48
|
+
- next_action:
|
|
49
|
+
- --out optional persistence path:
|
|
50
|
+
|
|
39
51
|
Rollback hint:
|
|
40
52
|
- touched_files:
|
|
41
53
|
- generated_files:
|
|
@@ -13,8 +13,11 @@
|
|
|
13
13
|
- Command:
|
|
14
14
|
- PID/session/pane:
|
|
15
15
|
- Port:
|
|
16
|
-
-
|
|
17
|
-
-
|
|
16
|
+
- URL:
|
|
17
|
+
- Screenshot id:
|
|
18
|
+
- Started at:
|
|
19
|
+
- Stopped at:
|
|
20
|
+
- Exit code:
|
|
18
21
|
- Exit/closure verified:
|
|
19
22
|
|
|
20
23
|
## tmux
|
|
@@ -32,6 +35,42 @@
|
|
|
32
35
|
- During:
|
|
33
36
|
- After:
|
|
34
37
|
|
|
38
|
+
## Runtime Evidence Mini
|
|
39
|
+
|
|
40
|
+
```json
|
|
41
|
+
{
|
|
42
|
+
"kind": "runtime_evidence_mini",
|
|
43
|
+
"route": "deep",
|
|
44
|
+
"required": true,
|
|
45
|
+
"command": "",
|
|
46
|
+
"target": "",
|
|
47
|
+
"pid": "unknown",
|
|
48
|
+
"port": "",
|
|
49
|
+
"url": "",
|
|
50
|
+
"exit_code": null,
|
|
51
|
+
"screenshot_id": "",
|
|
52
|
+
"started_at": "",
|
|
53
|
+
"stopped_at": "",
|
|
54
|
+
"process": {
|
|
55
|
+
"session": "",
|
|
56
|
+
"pane": ""
|
|
57
|
+
},
|
|
58
|
+
"observation": {
|
|
59
|
+
"before": "",
|
|
60
|
+
"after": ""
|
|
61
|
+
},
|
|
62
|
+
"cleanup": {
|
|
63
|
+
"status": "not-checked",
|
|
64
|
+
"evidence": ""
|
|
65
|
+
},
|
|
66
|
+
"truth_status": "partial",
|
|
67
|
+
"next_action": {
|
|
68
|
+
"kind": "",
|
|
69
|
+
"summary": ""
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
```
|
|
73
|
+
|
|
35
74
|
## Verification
|
|
36
75
|
|
|
37
76
|
- Command/check:
|
package/templates/tuning-log.md
CHANGED
|
@@ -25,7 +25,17 @@ Use this to tune route wording from real use.
|
|
|
25
25
|
- Seconds:
|
|
26
26
|
- Budget result:
|
|
27
27
|
|
|
28
|
-
##
|
|
28
|
+
## Benchmark Optimization Loop Lite
|
|
29
|
+
|
|
30
|
+
- Baseline command: yam measure <route> --files --commands --report-lines --seconds
|
|
31
|
+
- Baseline result:
|
|
32
|
+
- One route wording or doc change:
|
|
33
|
+
- Rerun command:
|
|
34
|
+
- Rerun result:
|
|
35
|
+
- Decision: keep / revert / retry once / stop
|
|
36
|
+
- Stop condition:
|
|
37
|
+
|
|
38
|
+
## Fix To yam
|
|
29
39
|
|
|
30
40
|
- Skill to edit:
|
|
31
41
|
- Proposed wording:
|
|
@@ -23,6 +23,8 @@
|
|
|
23
23
|
| source_hash | unknown |
|
|
24
24
|
| reference_id | |
|
|
25
25
|
| screenshot_id | |
|
|
26
|
+
| viewport | |
|
|
27
|
+
| state | |
|
|
26
28
|
| local_only | true / false |
|
|
27
29
|
| redacted | true / false |
|
|
28
30
|
| operator_provided | true / false |
|
|
@@ -56,6 +58,26 @@ Use `matched`, `similar`, `different`, `not-verified`, or `not-applicable`.
|
|
|
56
58
|
| Accessibility visuals | not-verified | | |
|
|
57
59
|
| Brand and mood fit | not-verified | | |
|
|
58
60
|
|
|
61
|
+
## Review Continuity
|
|
62
|
+
|
|
63
|
+
| Field | Value |
|
|
64
|
+
| --- | --- |
|
|
65
|
+
| previous_report_id/path | |
|
|
66
|
+
| previous_screenshot_id | |
|
|
67
|
+
| previous_source_hash | unknown |
|
|
68
|
+
| current_report_id/path | |
|
|
69
|
+
| current_screenshot_id | |
|
|
70
|
+
| current_source_hash | unknown |
|
|
71
|
+
| viewport | |
|
|
72
|
+
| state | |
|
|
73
|
+
| changed_surface | |
|
|
74
|
+
| continuity_result | improved / regressed / unchanged / not-verified |
|
|
75
|
+
| regression | true / false / not-verified |
|
|
76
|
+
| resolved_findings | |
|
|
77
|
+
| new_findings | |
|
|
78
|
+
| still_open_findings | |
|
|
79
|
+
| next_action | |
|
|
80
|
+
|
|
59
81
|
## Design Quality Review
|
|
60
82
|
|
|
61
83
|
Use `pass`, `needs-polish`, or `fails` for each relevant design dimension before listing actionable issues.
|
|
@@ -91,3 +113,25 @@ Use `pass`, `needs-polish`, or `fails` for each relevant design dimension before
|
|
|
91
113
|
## Truth Status
|
|
92
114
|
|
|
93
115
|
- verified / partial / skipped / blocked / assumed:
|
|
116
|
+
|
|
117
|
+
## Comparison Report JSON
|
|
118
|
+
|
|
119
|
+
```json
|
|
120
|
+
{
|
|
121
|
+
"kind": "ueye_comparison_report",
|
|
122
|
+
"previous_report_id": "",
|
|
123
|
+
"previous_screenshot_id": "",
|
|
124
|
+
"current_report_id": "",
|
|
125
|
+
"current_screenshot_id": "",
|
|
126
|
+
"viewport": "",
|
|
127
|
+
"state": "",
|
|
128
|
+
"comparison_result": "not-verified",
|
|
129
|
+
"regression": "not-verified",
|
|
130
|
+
"resolved_findings": [],
|
|
131
|
+
"new_findings": [],
|
|
132
|
+
"still_open": [],
|
|
133
|
+
"design_quality": "needs-polish",
|
|
134
|
+
"truth_status": "partial",
|
|
135
|
+
"next_action": ""
|
|
136
|
+
}
|
|
137
|
+
```
|
package/templates/ueye-review.md
CHANGED
|
@@ -34,6 +34,8 @@
|
|
|
34
34
|
| source_hash | unknown |
|
|
35
35
|
| reference_id | |
|
|
36
36
|
| screenshot_id | |
|
|
37
|
+
| viewport | |
|
|
38
|
+
| state | |
|
|
37
39
|
| local_only | true / false |
|
|
38
40
|
| redacted | true / false |
|
|
39
41
|
| operator_provided | true / false |
|
|
@@ -67,6 +69,26 @@
|
|
|
67
69
|
|
|
68
70
|
Status values: matched / similar / different / not-verified / not-applicable.
|
|
69
71
|
|
|
72
|
+
## Review Continuity
|
|
73
|
+
|
|
74
|
+
| Field | Value |
|
|
75
|
+
| --- | --- |
|
|
76
|
+
| previous_report_id/path | |
|
|
77
|
+
| previous_screenshot_id | |
|
|
78
|
+
| previous_source_hash | unknown |
|
|
79
|
+
| current_report_id/path | |
|
|
80
|
+
| current_screenshot_id | |
|
|
81
|
+
| current_source_hash | unknown |
|
|
82
|
+
| viewport | |
|
|
83
|
+
| state | |
|
|
84
|
+
| changed_surface | |
|
|
85
|
+
| continuity_result | improved / regressed / unchanged / not-verified |
|
|
86
|
+
| regression | true / false / not-verified |
|
|
87
|
+
| resolved_findings | |
|
|
88
|
+
| new_findings | |
|
|
89
|
+
| still_open_findings | |
|
|
90
|
+
| next_action | |
|
|
91
|
+
|
|
70
92
|
## Design Quality Review
|
|
71
93
|
|
|
72
94
|
| Dimension | Result | Evidence |
|
|
@@ -123,3 +145,25 @@ Result values: pass / needs-polish / fails.
|
|
|
123
145
|
## Truth Status
|
|
124
146
|
|
|
125
147
|
- verified / partial / skipped / blocked / assumed:
|
|
148
|
+
|
|
149
|
+
## Review Report JSON
|
|
150
|
+
|
|
151
|
+
```json
|
|
152
|
+
{
|
|
153
|
+
"kind": "ueye_review_report",
|
|
154
|
+
"previous_report_id": "",
|
|
155
|
+
"previous_screenshot_id": "",
|
|
156
|
+
"current_report_id": "",
|
|
157
|
+
"current_screenshot_id": "",
|
|
158
|
+
"viewport": "",
|
|
159
|
+
"state": "",
|
|
160
|
+
"comparison_result": "not-verified",
|
|
161
|
+
"regression": "not-verified",
|
|
162
|
+
"resolved_findings": [],
|
|
163
|
+
"new_findings": [],
|
|
164
|
+
"still_open": [],
|
|
165
|
+
"design_quality": "needs-polish",
|
|
166
|
+
"truth_status": "partial",
|
|
167
|
+
"next_action": ""
|
|
168
|
+
}
|
|
169
|
+
```
|
package/templates/yam.project.md
CHANGED
|
@@ -44,7 +44,7 @@
|
|
|
44
44
|
- UI changes:
|
|
45
45
|
- Feature changes:
|
|
46
46
|
- Risky changes:
|
|
47
|
-
- Public/release changes: scan for external
|
|
47
|
+
- Public/release changes: scan for external tool names, comparison wording, and attribution wording; remove those hits unless the user explicitly approves keeping them.
|
|
48
48
|
|
|
49
49
|
## Known Risks
|
|
50
50
|
|
|
@@ -62,7 +62,7 @@
|
|
|
62
62
|
|
|
63
63
|
- Do not:
|
|
64
64
|
- Avoid:
|
|
65
|
-
- Do not leave external
|
|
65
|
+
- Do not leave external tool/project comparison or attribution language in public-facing source, docs, npm metadata, release notes, or GitHub repository text.
|
|
66
66
|
|
|
67
67
|
## MD Management
|
|
68
68
|
|