qfai 1.7.13 → 1.7.14

package/assets/init/.qfai/evidence/README.md

@@ -38,14 +38,23 @@ Optional:
 
 ## Obligation matrix
 
-| surface / mode            | specs    | runtimeGate | uiFidelity                    | render evidence | browser QA | fullHarness |
-| ------------------------- | -------- | ----------- | ----------------------------- | --------------- | ---------- | ----------- |
-| non-ui / low-cost         | required | optional    | n/a                           | n/a             | n/a        | absent      |
-| non-ui / standard         | required | optional    | n/a                           | n/a             | n/a        | absent      |
-| non-ui / full-harness     | required | optional    | n/a                           | n/a             | n/a        | required    |
-| ui-bearing / low-cost     | required | optional    | optional (`skeleton` allowed) | optional        | optional   | absent      |
-| ui-bearing / standard     | required | optional    | required                      | optional        | optional   | absent      |
-| ui-bearing / full-harness | required | required    | required                      | required        | required   | required    |
+| surface / mode         | specs    | runtimeGate | uiFidelity                    | render evidence | browser QA | fullHarness |
+| ---------------------- | -------- | ----------- | ----------------------------- | --------------- | ---------- | ----------- |
+| web / low-cost         | required | optional    | optional (`skeleton` allowed) | optional        | optional   | absent      |
+| web / standard         | required | optional    | required                      | optional        | optional   | absent      |
+| web / full-harness     | required | required    | required                      | required        | required   | required    |
+| mobile / low-cost      | required | optional    | optional (`skeleton` allowed) | optional        | optional   | absent      |
+| mobile / standard      | required | optional    | required                      | optional        | optional   | absent      |
+| mobile / full-harness  | required | required    | required                      | required        | required   | required    |
+| desktop / low-cost     | required | optional    | optional (`skeleton` allowed) | optional        | optional   | absent      |
+| desktop / standard     | required | optional    | required                      | optional        | optional   | absent      |
+| desktop / full-harness | required | required    | required                      | required        | required   | required    |
+| cli / low-cost         | required | optional    | n/a                           | n/a             | n/a        | absent      |
+| cli / standard         | required | optional    | n/a                           | n/a             | n/a        | absent      |
+| cli / full-harness     | required | optional    | n/a                           | n/a             | n/a        | required    |
+| mixed / low-cost       | required | optional    | optional (`skeleton` allowed) | optional        | optional   | absent      |
+| mixed / standard       | required | optional    | required                      | optional        | optional   | absent      |
+| mixed / full-harness   | required | required    | required                      | required        | required   | required    |
 
 Interpretation:
 
@@ -53,16 +62,16 @@ Interpretation:
 - `optional`: if present, schema must be valid
 - `n/a`: absent is normal success
 
-## non-ui canonical semantics
+## cli surface canonical semantics
 
-For `surface: non-ui`, the following are normal success when absent:
+For `cli` surface, the following are normal success when absent:
 
 - `uiFidelity`
 - render evidence bundle
 - browser QA bundle
 - `runtimeGate.ui`
 
-Contradictory UI-only payloads on `non-ui` are validation errors.
+`ui_bearing: false` specs are not prototyping execution targets. Contradictory UI-only payloads on `cli` surface are validation errors.
 
 ## uiFidelity notes
 
@@ -167,7 +176,7 @@ Rules:
 
 ```json
 {
-  "surface": "web-ui",
+  "surface": "web",
   "specs": [
     {
       "specId": "spec-0001",

package/assets/uix-rev/comparison-review.md

@@ -1,6 +1,6 @@
 # UIX-REV: Comparison Review
 
-Review option comparison and selected anchor screen as independent artifacts.
+Review only `30_option_comparison.md` as the option comparison artifact.
 
 ## Comparison Quality (30_option_comparison.md)
 
@@ -9,22 +9,10 @@ Review option comparison and selected anchor screen as independent artifacts.
 - Evaluation criteria must reference the 3-layer evaluation family
 - Rejected/deferred options must have explicit rationale
 - Reconsideration conditions must be documented for deferred options
+- Do not move selected anchor ownership back into `30_option_comparison.md`
 
 ### Trend-derived conversion check
 
 - Trend scan results are converted to comparison axes
 - Stale / overused AI slop avoidance is reflected in comparison criteria
-
-## Selected Direction Quality (31_selected_anchor_screen.md)
-
-- `selected_option` must reference one of the compared options in `30_option_comparison.md`
-- `why_selected` must provide rationale aligned with 3-layer evaluation family
-- Anchor screen must represent the canonical visual direction
-- Downstream strategy (`10_implementation_strategy.md`) must align with selected direction
-- Downstream contracts (`40_screen_contracts.md`) must be consistent with selected direction
-- Deferred options must document reconsideration conditions
-
-### Trend-derived conversion check
-
-- Trend scan results are reflected in selected direction rationale
-- Stale / overused AI slop avoidance is reflected in selection
+- Keep selected-anchor ownership in `31_selected_anchor_screen.md` and scoring-ready field ownership in `50_review_input_bundle.md`

package/assets/uix-rev/contracts-review.md

@@ -1,4 +1,4 @@
-# UIX-REV: Screen Contracts Review (40_screen_contracts.md)
+# UIX-REV: Screen Contracts Review (`40_screen_contracts.md`)
 
 Review screen contracts for canonical 11-field schema completeness.
 
@@ -22,4 +22,7 @@ Review screen contracts for canonical 11-field schema completeness.
 - Routes must be unique across all contracts
 - Required states must include `default`, `loading`, `empty`, and `error`
 - All 11 fields must be present and non-empty for each screen
-- Screen contracts must be consistent with 50_review_input_bundle.md
+- Screen contracts must stay consistent with `31_selected_anchor_screen.md`
+- Screen contracts must stay consistent with Browser QA findings and screen-linked evidence
+- Do not reference legacy filenames such as `40_contracts.md`
+- Keep wording aligned with scoring-ready canonical fields and avoid stale migration vocabulary

package/assets/uix-rev/scoring-review.md

@@ -25,9 +25,11 @@ Each evaluation axis must include:
 
 ## Evaluation Axes Quality
 
-- Each trend-derived row must include source_translation
 - Axes must be measurable and verifiable
 - No generic/boilerplate axes without taste/trend derivation
+- Each axis must define `origin`, `intent`, `why_it_matters`, `score_scale`, `score_anchors.low/mid/high`
+- Each axis must define `positive_signals`, `negative_signals`, `anti_patterns`, `evidence_required`, `minimum_floor`
+- Each axis must define `source_refs`, `goal_refs`, and `review_questions`
 
 ## Aggregate Scoring Rules
 
@@ -46,5 +48,11 @@ Canonical field names (must match `23_design_eval_aggregate.md`):
 ### Trend-derived conversion check
 
 - Trend scan results are converted to scoring axes
-- Trend scan results are reflected in selected direction
+- Trend scan results are reflected in selected anchor
 - Stale / overused AI slop avoidance is reflected in comparison and selection
+
+## Aggregate Review Focus
+
+- Review axis quality, overlap, and minimum floors as a single aggregate system
+- Review `source_refs` and `goal_refs` linkage for every scored axis
+- Remove old aggregate vocabulary and keep wording aligned with `23_design_eval_aggregate.md`

package/assets/uix-rev/strategy-review.md

@@ -2,22 +2,26 @@
 
 Review the UI/UX strategy document (`10_implementation_strategy.md`) for completeness and quality.
 
-This review is scoped to strategy completeness only. Selected direction evaluation belongs to `comparison-review.md`.
+This review is scoped to strategy completeness only. Selected anchor evaluation belongs to `comparison-review.md`.
 
 ## Required Fields
 
 - `surface`
+- `selection_required`
 - `decision`
-- `why_this_strategy`
-- `expected_strengths`
-- `known_risks`
-- `fit_for_this_product`
-- enum validity for `surface` and `decision`
+- `candidate_options`
+- `chosen_option`
+- `rationale`
+- `verification_expectations`
+- `notes_for_reviewer`
 
 ## Alignment Check
 
-- Strategy `decision` must be consistent with the selected direction in `31_selected_anchor_screen.md` (cross-reference only; SSOT judgment is in comparison-review)
+- `chosen_option` must exist in `candidate_options`
+- `decision` and `chosen_option` should use coherent vocabulary
+- Strategy `decision` must be consistent with the selected anchor in `31_selected_anchor_screen.md` (cross-reference only; SSOT judgment is in comparison-review)
 - Strategy must not contradict screen contracts in `40_screen_contracts.md`
+- `selection_required=false` with multiple `candidate_options` should be treated as a warning
 
 ## Verdict