Honor Scattermind metric hints in ranking

README.md

@@ -47,6 +47,8 @@ Ranker's continuation job is narrow:
 
 `POST /api/rank-feedback` accepts a `prioritix-feature-set-v1`-style payload from Scattermind and returns ranked items plus `buildOrder.doFirst / validateNext / defer / park`. Keep this contract action-first; do not use it as a reason to add generic dashboard, auth, billing, or workspace layers before the bridge has proof.
 
+Feature items may include optional 1–10 `rankerHints` (`value`, `effort`, `confidence`, `urgency`, `revenue`, `novelty`, `risk`). Ranker blends those explicit Scattermind hints with text heuristics; `effort` is inverted into feasibility. Hints improve the defended order, but `recommendedLane: "defer"` or `"park"` remains a safety rail so dashboard-swamp items do not get promoted by flashy wording.
+
 Recommended payload shape:
 
 ```json
@@ -69,6 +71,15 @@ Recommended payload shape:
         "userValue": "A tired builder sees the next move without opening a dashboard.",
         "evidenceNeeded": "Can 3 non-AI-native users understand the first recommended action?",
         "proofSteps": ["Show a static result screen to 3 people"],
+        "rankerHints": {
+          "value": 8,
+          "effort": 3,
+          "confidence": 7,
+          "urgency": 6,
+          "revenue": 4,
+          "novelty": 5,
+          "risk": 3
+        },
         "dependencies": [],
         "risk": "May become generic roadmap UI if the source context is lost.",
         "recommendedLane": "validate-next",