@wowok/agent-mcp 2.7.2 → 2.7.3

package/dist/schemas/trust_score.output.json

@@ -1,718 +1,809 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://wowok.net/schemas/trust_score.json",
+  "$id": "https://wowok.net/schemas/trust_score.output.json",
   "title": "Trust Score - Service Risk & Trust Assessment",
   "description": "Proactively query the trust score (0-100, 5 dimensions) and risk assessment (4 dimensions, 100-point) of a Service object. Parameters: service (required), order_amount (optional), depth (optional: browse/evaluate/preorder).",
-  "$ref": "#/definitions/trust_score",
-  "definitions": {
-    "trust_score": {
+  "type": "object",
+  "properties": {
+    "result": {
       "type": "object",
       "properties": {
-        "result": {
+        "service_id": {
+          "type": "string",
+          "description": "The Service object ID or local_mark that was evaluated."
+        },
+        "service_name": {
+          "type": "string",
+          "description": "Service display name (falls back to service_id if unnamed)."
+        },
+        "service_basics": {
           "type": "object",
           "properties": {
-            "service_id": {
+            "bPublished": {
+              "type": "boolean",
+              "description": "Whether the Service is published (open for orders)."
+            },
+            "bPaused": {
+              "type": "boolean",
+              "description": "Whether the Service is temporarily paused."
+            },
+            "sales_count": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991,
+              "description": "Number of active (non-suspended) sale entries."
+            },
+            "has_machine": {
+              "type": "boolean",
+              "description": "Whether a Machine workflow is attached."
+            },
+            "has_buy_guard": {
+              "type": "boolean",
+              "description": "Whether a buy-side Guard is configured."
+            },
+            "has_um_contact": {
+              "type": "boolean",
+              "description": "Whether a Messenger (um) contact is configured."
+            },
+            "arbitrations_count": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 9007199254740991,
+              "description": "Number of arbitration entries attached to the Service."
+            }
+          },
+          "required": [
+            "bPublished",
+            "bPaused",
+            "sales_count",
+            "has_machine",
+            "has_buy_guard",
+            "has_um_contact",
+            "arbitrations_count"
+          ],
+          "additionalProperties": false,
+          "description": "Service snapshot — basic on-chain state."
+        },
+        "trust_score": {
+          "type": "object",
+          "properties": {
+            "score": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100,
+              "description": "Overall trust score (0-100, higher = more trustworthy)."
+            },
+            "level": {
               "type": "string",
-              "description": "The Service object ID or local_mark that was evaluated."
+              "enum": [
+                "high_risk",
+                "caution",
+                "moderate",
+                "trusted"
+              ],
+              "description": "Trust level label derived from the score."
             },
-            "service_name": {
+            "summary": {
               "type": "string",
-              "description": "Service display name (falls back to service_id if unnamed)."
+              "description": "One-line human-readable trust summary."
             },
-            "service_basics": {
-              "type": "object",
-              "properties": {
-                "bPublished": {
-                  "type": "boolean",
-                  "description": "Whether the Service is published (open for orders)."
-                },
-                "bPaused": {
-                  "type": "boolean",
-                  "description": "Whether the Service is temporarily paused."
-                },
-                "sales_count": {
-                  "type": "integer",
-                  "minimum": 0,
-                  "description": "Number of active (non-suspended) sale entries."
-                },
-                "has_machine": {
-                  "type": "boolean",
-                  "description": "Whether a Machine workflow is attached."
-                },
-                "has_buy_guard": {
-                  "type": "boolean",
-                  "description": "Whether a buy-side Guard is configured."
-                },
-                "has_um_contact": {
-                  "type": "boolean",
-                  "description": "Whether a Messenger (um) contact is configured."
+            "warnings": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Trust warnings (e.g. low arbitration dimension score)."
+            },
+            "breakdown": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "score": {
+                    "type": "number",
+                    "description": "Dimension score achieved."
+                  },
+                  "maxScore": {
+                    "type": "number",
+                    "description": "Dimension max possible score."
+                  },
+                  "description": {
+                    "type": "string",
+                    "description": "Dimension name / description."
+                  },
+                  "humanReadable": {
+                    "type": "string",
+                    "description": "Human-readable dimension explanation."
+                  }
                 },
-                "arbitrations_count": {
-                  "type": "integer",
-                  "minimum": 0,
-                  "description": "Number of arbitration entries attached to the Service."
-                }
+                "required": [
+                  "score",
+                  "maxScore",
+                  "description",
+                  "humanReadable"
+                ],
+                "additionalProperties": false
               },
-              "required": [
-                "bPublished",
-                "bPaused",
-                "sales_count",
-                "has_machine",
-                "has_buy_guard",
-                "has_um_contact",
-                "arbitrations_count"
+              "description": "5-dimension breakdown: arbitration / reviews / fulfillment / fund_safety / transparency."
+            }
+          },
+          "required": [
+            "score",
+            "level",
+            "summary",
+            "warnings",
+            "breakdown"
+          ],
+          "additionalProperties": false,
+          "description": "ServiceTrustScore — 0-100 score across 5 trust dimensions."
+        },
+        "order_amount": {
+          "type": "string",
+          "description": "Order amount used for fund-safety assessment, in smallest token unit (bigint as string)."
+        },
+        "depth": {
+          "type": "string",
+          "enum": [
+            "browse",
+            "evaluate",
+            "preorder"
+          ],
+          "description": "Actual InfoPuzzle collection depth used (defaults to 'evaluate')."
+        },
+        "risk_score": {
+          "description": "RiskScore — present only when depth >= 'evaluate'.",
+          "type": "object",
+          "properties": {
+            "total": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 100,
+              "description": "Overall risk score (0-100, higher = riskier)."
+            },
+            "level": {
+              "type": "string",
+              "enum": [
+                "low",
+                "medium_low",
+                "medium_high",
+                "high"
               ],
-              "additionalProperties": false,
-              "description": "Service snapshot — basic on-chain state."
+              "description": "Risk level label derived from the total score."
+            },
+            "red_flags": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Critical risk red flags detected."
+            },
+            "advice": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Risk mitigation advice."
+            },
+            "dimensions": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "enum": [
+                      "workflow",
+                      "fund",
+                      "trust",
+                      "behavior"
+                    ],
+                    "description": "Risk dimension name."
+                  },
+                  "score": {
+                    "type": "number",
+                    "description": "Dimension score achieved."
+                  },
+                  "max_score": {
+                    "type": "number",
+                    "description": "Dimension max possible score."
+                  },
+                  "checks": {
+                    "type": "array",
+                    "items": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "string",
+                          "description": "Check identifier."
+                        },
+                        "dimension": {
+                          "type": "string",
+                          "enum": [
+                            "workflow",
+                            "fund",
+                            "trust",
+                            "behavior"
+                          ],
+                          "description": "Dimension this check belongs to."
+                        },
+                        "description": {
+                          "type": "string",
+                          "description": "Check description."
+                        },
+                        "weight": {
+                          "type": "number",
+                          "description": "Check weight within its dimension (percentage)."
+                        },
+                        "passed": {
+                          "type": "boolean",
+                          "description": "Whether the check passed."
+                        },
+                        "advice": {
+                          "description": "Advice when the check failed.",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "dimension",
+                        "description",
+                        "weight",
+                        "passed"
+                      ],
+                      "additionalProperties": false
+                    },
+                    "description": "Individual risk checks within this dimension."
+                  }
+                },
+                "required": [
+                  "name",
+                  "score",
+                  "max_score",
+                  "checks"
+                ],
+                "additionalProperties": false
+              },
+              "description": "4-dimension breakdown: workflow / fund / trust / behavior."
+            }
+          },
+          "required": [
+            "total",
+            "level",
+            "red_flags",
+            "advice",
+            "dimensions"
+          ],
+          "additionalProperties": false
+        },
+        "info_puzzle": {
+          "description": "InfoPuzzle summary — present only when depth >= 'evaluate'.",
+          "type": "object",
+          "properties": {
+            "completeness": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1,
+              "description": "InfoPuzzle completeness ratio (0-1)."
             },
-            "trust_score": {
+            "gaps": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Missing key puzzle pieces."
+            },
+            "assembled_at": {
+              "type": "number",
+              "description": "Assembly timestamp (ms since epoch)."
+            }
+          },
+          "required": [
+            "completeness",
+            "gaps",
+            "assembled_at"
+          ],
+          "additionalProperties": false
+        },
+        "preorder_advice": {
+          "description": "PreorderAdvice (GLM6/94 §3) — present only when depth = 'preorder'. AI presents evidence and options; the USER decides whether to order.",
+          "type": "object",
+          "properties": {
+            "confidence": {
               "type": "object",
               "properties": {
                 "score": {
                   "type": "number",
                   "minimum": 0,
                   "maximum": 100,
-                  "description": "Overall trust score (0-100, higher = more trustworthy)."
+                  "description": "Composite order confidence (0-100, higher = safer to order)."
                 },
-                "level": {
-                  "type": "string",
-                  "enum": [
-                    "high_risk",
-                    "caution",
-                    "moderate",
-                    "trusted"
-                  ],
-                  "description": "Trust level label derived from the score."
+                "base": {
+                  "type": "number",
+                  "description": "Base confidence = 100 - risk.total."
                 },
-                "summary": {
-                  "type": "string",
-                  "description": "One-line human-readable trust summary."
+                "user_adjustment": {
+                  "type": "number",
+                  "description": "User-controllable adjustment from user_metrics (±cap)."
                 },
-                "warnings": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  },
-                  "description": "Trust warnings (e.g. low arbitration dimension score)."
+                "preference_nudge": {
+                  "type": "number",
+                  "description": "Preference-match nudge (±5, only when preferences were provided)."
                 },
-                "breakdown": {
-                  "type": "array",
-                  "items": {
-                    "type": "object",
-                    "properties": {
-                      "score": {
-                        "type": "number",
-                        "description": "Dimension score achieved."
-                      },
-                      "maxScore": {
-                        "type": "number",
-                        "description": "Dimension max possible score."
-                      },
-                      "description": {
-                        "type": "string",
-                        "description": "Dimension name / description."
-                      },
-                      "humanReadable": {
-                        "type": "string",
-                        "description": "Human-readable dimension explanation."
-                      }
-                    },
-                    "required": [
-                      "score",
-                      "maxScore",
-                      "description",
-                      "humanReadable"
-                    ],
-                    "additionalProperties": false
-                  },
-                  "description": "5-dimension breakdown: arbitration / reviews / fulfillment / fund_safety / transparency."
+                "explanation": {
+                  "type": "string",
+                  "description": "Transparent breakdown of the confidence components."
                 }
               },
               "required": [
                 "score",
-                "level",
-                "summary",
-                "warnings",
-                "breakdown"
+                "base",
+                "user_adjustment",
+                "preference_nudge",
+                "explanation"
               ],
               "additionalProperties": false,
-              "description": "ServiceTrustScore — 0-100 score across 5 trust dimensions."
+              "description": "ConfidenceScore — user-controllable composite order confidence."
             },
-            "order_amount": {
-              "type": "string",
-              "description": "Order amount used for fund-safety assessment, in smallest token unit (bigint as string)."
-            },
-            "depth": {
+            "industry": {
+              "description": "Industry used for the industry-specific risk checks (explicit input or inferred).",
               "type": "string",
               "enum": [
-                "browse",
-                "evaluate",
-                "preorder"
-              ],
-              "description": "Actual InfoPuzzle collection depth used (defaults to 'evaluate')."
+                "freelance",
+                "rental",
+                "education",
+                "travel",
+                "subscription",
+                "retail"
+              ]
+            },
+            "strategies": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "scenario": {
+                    "type": "string",
+                    "enum": [
+                      "info_asymmetry",
+                      "fund_safety",
+                      "refund_dispute",
+                      "arbitration_fairness",
+                      "pricing",
+                      "delivery_sla",
+                      "quality_verification",
+                      "after_sales"
+                    ],
+                    "description": "Game scenario detected from the puzzle."
+                  },
+                  "merchant_tactic": {
+                    "type": "string",
+                    "description": "Merchant's potential tactic in this scenario."
+                  },
+                  "user_strategy": {
+                    "type": "string",
+                    "description": "Recommended user-side strategy (protection/mitigation)."
+                  },
+                  "nash_equilibrium": {
+                    "type": "string",
+                    "description": "Win-win equilibrium the strategy pushes toward."
+                  },
+                  "confidence": {
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 1,
+                    "description": "Strategy confidence (0-1)."
+                  },
+                  "fallback": {
+                    "description": "Alternative when the user rejects the main strategy.",
+                    "type": "string"
+                  },
+                  "rationale": {
+                    "type": "string",
+                    "description": "Trigger-condition explanation from puzzle evidence."
+                  }
+                },
+                "required": [
+                  "scenario",
+                  "merchant_tactic",
+                  "user_strategy",
+                  "nash_equilibrium",
+                  "confidence",
+                  "rationale"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Top merchant-vs-user game strategies (user side, max 3)."
             },
-            "risk_score": {
+            "preference_match": {
+              "description": "PreferenceMatchResult — present when preferences (input or profile) were available.",
               "type": "object",
               "properties": {
-                "total": {
+                "score": {
                   "type": "number",
                   "minimum": 0,
                   "maximum": 100,
-                  "description": "Overall risk score (0-100, higher = riskier)."
+                  "description": "Preference match score (0-100)."
                 },
-                "level": {
-                  "type": "string",
-                  "enum": [
-                    "low",
-                    "medium_low",
-                    "medium_high",
-                    "high"
-                  ],
-                  "description": "Risk level label derived from the total score."
-                },
-                "red_flags": {
+                "matches": {
                   "type": "array",
                   "items": {
                     "type": "string"
                   },
-                  "description": "Critical risk red flags detected."
+                  "description": "Aspects matching the user's preferences."
                 },
-                "advice": {
+                "mismatches": {
                   "type": "array",
                   "items": {
                     "type": "string"
                   },
-                  "description": "Risk mitigation advice."
-                },
-                "dimensions": {
-                  "type": "array",
-                  "items": {
-                    "type": "object",
-                    "properties": {
-                      "name": {
-                        "type": "string",
-                        "enum": [
-                          "workflow",
-                          "fund",
-                          "trust",
-                          "behavior"
-                        ],
-                        "description": "Risk dimension name."
-                      },
-                      "score": {
-                        "type": "number",
-                        "description": "Dimension score achieved."
-                      },
-                      "max_score": {
-                        "type": "number",
-                        "description": "Dimension max possible score."
-                      },
-                      "checks": {
-                        "type": "array",
-                        "items": {
-                          "type": "object",
-                          "properties": {
-                            "id": {
-                              "type": "string",
-                              "description": "Check identifier."
-                            },
-                            "dimension": {
-                              "type": "string",
-                              "enum": [
-                                "workflow",
-                                "fund",
-                                "trust",
-                                "behavior"
-                              ],
-                              "description": "Dimension this check belongs to."
-                            },
-                            "description": {
-                              "type": "string",
-                              "description": "Check description."
-                            },
-                            "weight": {
-                              "type": "number",
-                              "description": "Check weight within its dimension (percentage)."
-                            },
-                            "passed": {
-                              "type": "boolean",
-                              "description": "Whether the check passed."
-                            },
-                            "advice": {
-                              "type": "string",
-                              "description": "Advice when the check failed."
-                            }
-                          },
-                          "required": [
-                            "id",
-                            "dimension",
-                            "description",
-                            "weight",
-                            "passed"
-                          ],
-                          "additionalProperties": false
-                        },
-                        "description": "Individual risk checks within this dimension."
-                      }
-                    },
-                    "required": [
-                      "name",
-                      "score",
-                      "max_score",
-                      "checks"
-                    ],
-                    "additionalProperties": false
-                  },
-                  "description": "4-dimension breakdown: workflow / fund / trust / behavior."
-                }
-              },
-              "required": [
-                "total",
-                "level",
-                "red_flags",
-                "advice",
-                "dimensions"
-              ],
-              "additionalProperties": false,
-              "description": "RiskScore — present only when depth >= 'evaluate'."
-            },
-            "info_puzzle": {
-              "type": "object",
-              "properties": {
-                "completeness": {
-                  "type": "number",
-                  "minimum": 0,
-                  "maximum": 1,
-                  "description": "InfoPuzzle completeness ratio (0-1)."
+                  "description": "Aspects mismatching the user's preferences."
                 },
-                "gaps": {
+                "warnings": {
                   "type": "array",
                   "items": {
                     "type": "string"
                   },
-                  "description": "Missing key puzzle pieces."
-                },
-                "assembled_at": {
-                  "type": "number",
-                  "description": "Assembly timestamp (ms since epoch)."
+                  "description": "Match warnings (e.g. budget stretch)."
                 }
               },
               "required": [
-                "completeness",
-                "gaps",
-                "assembled_at"
+                "score",
+                "matches",
+                "mismatches",
+                "warnings"
               ],
-              "additionalProperties": false,
-              "description": "InfoPuzzle summary — present only when depth >= 'evaluate'."
+              "additionalProperties": false
+            },
+            "preference_issues": {
+              "description": "Validation issues found in the merged preferences (e.g. budget min > max).",
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
             },
-            "preorder_advice": {
+            "industry_risks": {
+              "description": "IndustryRiskResult — industry pain-point checks (needs met / risks triggered).",
               "type": "object",
               "properties": {
-                "confidence": {
-                  "type": "object",
-                  "properties": {
-                    "score": {
-                      "type": "number",
-                      "minimum": 0,
-                      "maximum": 100,
-                      "description": "Composite order confidence (0-100, higher = safer to order)."
-                    },
-                    "base": {
-                      "type": "number",
-                      "description": "Base confidence = 100 - risk.total."
-                    },
-                    "user_adjustment": {
-                      "type": "number",
-                      "description": "User-controllable adjustment from user_metrics (±cap)."
-                    },
-                    "preference_nudge": {
-                      "type": "number",
-                      "description": "Preference-match nudge (±5, only when preferences were provided)."
-                    },
-                    "explanation": {
-                      "type": "string",
-                      "description": "Transparent breakdown of the confidence components."
-                    }
-                  },
-                  "required": [
-                    "score",
-                    "base",
-                    "user_adjustment",
-                    "preference_nudge",
-                    "explanation"
-                  ],
-                  "additionalProperties": false,
-                  "description": "ConfidenceScore — user-controllable composite order confidence."
+                "score_adjustment": {
+                  "type": "number",
+                  "description": "Industry risk adjustment applied to the base risk score (-10 to +10)."
                 },
-                "industry": {
+                "summary": {
                   "type": "string",
-                  "enum": [
-                    "freelance",
-                    "rental",
-                    "education",
-                    "travel",
-                    "subscription",
-                    "retail"
-                  ],
-                  "description": "Industry used for the industry-specific risk checks (explicit input or inferred)."
+                  "description": "Industry risk assessment summary."
                 },
-                "strategies": {
+                "checks": {
                   "type": "array",
                   "items": {
                     "type": "object",
                     "properties": {
-                      "scenario": {
-                        "type": "string",
-                        "enum": [
-                          "info_asymmetry",
-                          "fund_safety",
-                          "refund_dispute",
-                          "arbitration_fairness",
-                          "pricing",
-                          "delivery_sla",
-                          "quality_verification",
-                          "after_sales"
-                        ],
-                        "description": "Game scenario detected from the puzzle."
-                      },
-                      "merchant_tactic": {
+                      "id": {
                         "type": "string",
-                        "description": "Merchant's potential tactic in this scenario."
+                        "description": "Check identifier."
                       },
-                      "user_strategy": {
+                      "dimension": {
                         "type": "string",
-                        "description": "Recommended user-side strategy (protection/mitigation)."
+                        "enum": [
+                          "workflow",
+                          "fund",
+                          "trust",
+                          "behavior"
+                        ],
+                        "description": "Dimension this check belongs to."
                       },
-                      "nash_equilibrium": {
+                      "description": {
                         "type": "string",
-                        "description": "Win-win equilibrium the strategy pushes toward."
+                        "description": "Check description."
                       },
-                      "confidence": {
+                      "weight": {
                         "type": "number",
-                        "minimum": 0,
-                        "maximum": 1,
-                        "description": "Strategy confidence (0-1)."
+                        "description": "Check weight within its dimension (percentage)."
                       },
-                      "fallback": {
-                        "type": "string",
-                        "description": "Alternative when the user rejects the main strategy."
+                      "passed": {
+                        "type": "boolean",
+                        "description": "Whether the check passed."
                       },
-                      "rationale": {
-                        "type": "string",
-                        "description": "Trigger-condition explanation from puzzle evidence."
+                      "advice": {
+                        "description": "Advice when the check failed.",
+                        "type": "string"
                       }
                     },
                     "required": [
-                      "scenario",
-                      "merchant_tactic",
-                      "user_strategy",
-                      "nash_equilibrium",
-                      "confidence",
-                      "rationale"
+                      "id",
+                      "dimension",
+                      "description",
+                      "weight",
+                      "passed"
                     ],
                     "additionalProperties": false
                   },
-                  "description": "Top merchant-vs-user game strategies (user side, max 3)."
-                },
-                "preference_match": {
-                  "type": "object",
-                  "properties": {
-                    "score": {
-                      "type": "number",
-                      "minimum": 0,
-                      "maximum": 100,
-                      "description": "Preference match score (0-100)."
-                    },
-                    "matches": {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      },
-                      "description": "Aspects matching the user's preferences."
-                    },
-                    "mismatches": {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      },
-                      "description": "Aspects mismatching the user's preferences."
-                    },
-                    "warnings": {
-                      "type": "array",
-                      "items": {
-                        "type": "string"
-                      },
-                      "description": "Match warnings (e.g. budget stretch)."
-                    }
-                  },
-                  "required": [
-                    "score",
-                    "matches",
-                    "mismatches",
-                    "warnings"
-                  ],
-                  "additionalProperties": false,
-                  "description": "PreferenceMatchResult — present when preferences (input or profile) were available."
-                },
-                "preference_issues": {
-                  "type": "array",
-                  "items": {
-                    "type": "string"
-                  },
-                  "description": "Validation issues found in the merged preferences (e.g. budget min > max)."
-                },
-                "industry_risks": {
-                  "type": "object",
-                  "properties": {
-                    "score_adjustment": {
-                      "type": "number",
-                      "description": "Industry risk adjustment applied to the base risk score (-10 to +10)."
-                    },
-                    "summary": {
-                      "type": "string",
-                      "description": "Industry risk assessment summary."
-                    },
-                    "checks": {
-                      "type": "array",
-                      "items": {
-                        "$ref": "#/definitions/trust_score/properties/result/properties/risk_score/properties/dimensions/items/properties/checks/items"
-                      },
-                      "description": "Industry-specific risk checks."
-                    },
-                    "unmet_needs": {
-                      "type": "array",
-                      "items": {
-                        "type": "object",
-                        "properties": {
-                          "id": {
-                            "type": "string",
-                            "description": "Need identifier."
-                          },
-                          "tier": {
-                            "type": "string",
-                            "enum": [
-                              "common",
-                              "personalized",
-                              "advanced"
-                            ],
-                            "description": "Need tier."
-                          },
-                          "description": {
-                            "type": "string",
-                            "description": "Need description."
-                          },
-                          "advice": {
-                            "type": "string",
-                            "description": "Advice for fulfilling the need."
-                          }
-                        },
-                        "required": [
-                          "id",
-                          "tier",
-                          "description"
-                        ],
-                        "additionalProperties": false
-                      },
-                      "description": "Industry needs not satisfied by this Service."
-                    }
-                  },
-                  "required": [
-                    "score_adjustment",
-                    "summary",
-                    "checks",
-                    "unmet_needs"
-                  ],
-                  "additionalProperties": false,
-                  "description": "IndustryRiskResult — industry pain-point checks (needs met / risks triggered)."
+                  "description": "Industry-specific risk checks."
                 },
-                "reminders": {
+                "unmet_needs": {
                   "type": "array",
                   "items": {
                     "type": "object",
                     "properties": {
                       "id": {
                         "type": "string",
-                        "description": "Reminder rule identifier."
-                      },
-                      "stage": {
-                        "type": "string",
-                        "enum": [
-                          "browse",
-                          "evaluate",
-                          "preorder",
-                          "in_progress",
-                          "complete",
-                          "after_sale"
-                        ],
-                        "description": "Workflow stage this reminder belongs to."
+                        "description": "Need identifier."
                       },
-                      "priority": {
+                      "tier": {
                         "type": "string",
                         "enum": [
-                          "required",
-                          "recommended",
-                          "info",
-                          "reminder"
+                          "common",
+                          "personalized",
+                          "advanced"
                         ],
-                        "description": "Priority: required = blocking, recommended = strongly suggested."
+                        "description": "Need tier."
                       },
-                      "message": {
+                      "description": {
                         "type": "string",
-                        "description": "Human-readable reminder message."
+                        "description": "Need description."
                       },
-                      "action": {
-                        "type": "string",
-                        "description": "Suggested follow-up action, if any."
+                      "advice": {
+                        "description": "Advice for fulfilling the need.",
+                        "type": "string"
                       }
                     },
                     "required": [
                       "id",
-                      "stage",
-                      "priority",
-                      "message"
+                      "tier",
+                      "description"
                     ],
                     "additionalProperties": false
                   },
-                  "description": "Transaction-safety reminders at the preorder stage (sorted, capped)."
-                },
-                "blocking_reminders": {
-                  "type": "array",
-                  "items": {
-                    "$ref": "#/definitions/trust_score/properties/result/properties/preorder_advice/properties/reminders/items"
-                  },
-                  "description": "Blocking (priority=required) reminders — resolve these before ordering."
-                },
-                "summary": {
-                  "type": "string",
-                  "description": "AI-ready paragraph summarizing the whole preorder report."
+                  "description": "Industry needs not satisfied by this Service."
                 }
               },
               "required": [
-                "confidence",
-                "strategies",
-                "reminders",
-                "blocking_reminders",
-                "summary"
+                "score_adjustment",
+                "summary",
+                "checks",
+                "unmet_needs"
               ],
-              "additionalProperties": false,
-              "description": "PreorderAdvice (GLM6/94 §3) — present only when depth = 'preorder'. AI presents evidence and options; the USER decides whether to order."
+              "additionalProperties": false
             },
-            "comparison": {
-              "type": "object",
-              "properties": {
-                "rows": {
-                  "type": "array",
-                  "items": {
-                    "type": "object",
-                    "properties": {
-                      "service_id": {
-                        "type": "string"
-                      },
-                      "service_name": {
-                        "type": "string"
-                      },
-                      "error": {
-                        "type": "string",
-                        "description": "Per-service evaluation failure (row excluded from best-per-metric)."
-                      },
-                      "industry": {
-                        "$ref": "#/definitions/trust_score/properties/result/properties/preorder_advice/properties/industry"
-                      },
-                      "confidence": {
-                        "type": "number",
-                        "description": "Order confidence 0-100 (higher = safer)."
-                      },
-                      "risk_total": {
-                        "type": "number",
-                        "description": "Risk score 0-100 (lower = safer)."
-                      },
-                      "risk_level": {
-                        "type": "string"
-                      },
-                      "trust_score": {
-                        "type": "number",
-                        "description": "Trust score 0-100 (higher = more trustworthy)."
-                      },
-                      "trust_level": {
-                        "type": "string"
-                      },
-                      "preference_match": {
-                        "type": "number",
-                        "description": "Preference match 0-100 (higher = better fit)."
-                      },
-                      "reputation_like_ratio": {
-                        "type": "number",
-                        "description": "likes/(likes+dislikes); 1 when no votes."
-                      },
-                      "reputation_votes": {
-                        "type": "number"
-                      },
-                      "red_flags_count": {
-                        "type": "number"
-                      },
-                      "blocking_reminders_count": {
-                        "type": "number"
-                      },
-                      "info_gaps_count": {
-                        "type": "number"
-                      }
-                    },
-                    "required": [
-                      "service_id",
-                      "service_name"
+            "reminders": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "Reminder rule identifier."
+                  },
+                  "stage": {
+                    "type": "string",
+                    "enum": [
+                      "browse",
+                      "evaluate",
+                      "preorder",
+                      "in_progress",
+                      "complete",
+                      "after_sale"
                     ],
-                    "additionalProperties": false
+                    "description": "Workflow stage this reminder belongs to."
                   },
-                  "description": "One row per evaluated service (primary first, then compare_with candidates)."
+                  "priority": {
+                    "type": "string",
+                    "enum": [
+                      "required",
+                      "recommended",
+                      "info",
+                      "reminder"
+                    ],
+                    "description": "Priority: required = blocking, recommended = strongly suggested."
+                  },
+                  "message": {
+                    "type": "string",
+                    "description": "Human-readable reminder message."
+                  },
+                  "action": {
+                    "description": "Suggested follow-up action, if any.",
+                    "type": "string"
+                  }
                 },
-                "best_per_metric": {
-                  "type": "object",
-                  "additionalProperties": {
-                    "type": "array",
-                    "items": {
-                      "type": "string"
-                    }
+                "required": [
+                  "id",
+                  "stage",
+                  "priority",
+                  "message"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Transaction-safety reminders at the preorder stage (sorted, capped)."
+            },
+            "blocking_reminders": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "Reminder rule identifier."
+                  },
+                  "stage": {
+                    "type": "string",
+                    "enum": [
+                      "browse",
+                      "evaluate",
+                      "preorder",
+                      "in_progress",
+                      "complete",
+                      "after_sale"
+                    ],
+                    "description": "Workflow stage this reminder belongs to."
                   },
-                  "description": "metric name → service_ids with the best value (ties all listed). Per-metric ONLY."
+                  "priority": {
+                    "type": "string",
+                    "enum": [
+                      "required",
+                      "recommended",
+                      "info",
+                      "reminder"
+                    ],
+                    "description": "Priority: required = blocking, recommended = strongly suggested."
+                  },
+                  "message": {
+                    "type": "string",
+                    "description": "Human-readable reminder message."
+                  },
+                  "action": {
+                    "description": "Suggested follow-up action, if any.",
+                    "type": "string"
+                  }
                 },
-                "evaluated_metrics": {
-                  "type": "array",
-                  "items": {
+                "required": [
+                  "id",
+                  "stage",
+                  "priority",
+                  "message"
+                ],
+                "additionalProperties": false
+              },
+              "description": "Blocking (priority=required) reminders — resolve these before ordering."
+            },
+            "summary": {
+              "type": "string",
+              "description": "AI-ready paragraph summarizing the whole preorder report."
+            }
+          },
+          "required": [
+            "confidence",
+            "strategies",
+            "reminders",
+            "blocking_reminders",
+            "summary"
+          ],
+          "additionalProperties": false
+        },
+        "comparison": {
+          "description": "Deterministic multi-service comparison (GLM6/94 L6) — present only when depth='preorder' and compare_with is provided. Per-metric bests ONLY, no overall ranking — the buyer decides.",
+          "type": "object",
+          "properties": {
+            "rows": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "service_id": {
+                    "type": "string"
+                  },
+                  "service_name": {
+                    "type": "string"
+                  },
+                  "error": {
+                    "description": "Per-service evaluation failure (row excluded from best-per-metric).",
+                    "type": "string"
+                  },
+                  "industry": {
+                    "type": "string",
+                    "enum": [
+                      "freelance",
+                      "rental",
+                      "education",
+                      "travel",
+                      "subscription",
+                      "retail"
+                    ]
+                  },
+                  "confidence": {
+                    "description": "Order confidence 0-100 (higher = safer).",
+                    "type": "number"
+                  },
+                  "risk_total": {
+                    "description": "Risk score 0-100 (lower = safer).",
+                    "type": "number"
+                  },
+                  "risk_level": {
+                    "type": "string"
+                  },
+                  "trust_score": {
+                    "description": "Trust score 0-100 (higher = more trustworthy).",
+                    "type": "number"
+                  },
+                  "trust_level": {
                     "type": "string"
                   },
-                  "description": "Metrics actually compared (skipped when fewer than 2 rows have data)."
+                  "preference_match": {
+                    "description": "Preference match 0-100 (higher = better fit).",
+                    "type": "number"
+                  },
+                  "reputation_like_ratio": {
+                    "description": "likes/(likes+dislikes); 1 when no votes.",
+                    "type": "number"
+                  },
+                  "reputation_votes": {
+                    "type": "number"
+                  },
+                  "red_flags_count": {
+                    "type": "number"
+                  },
+                  "blocking_reminders_count": {
+                    "type": "number"
+                  },
+                  "info_gaps_count": {
+                    "type": "number"
+                  }
                 },
-                "note": {
-                  "type": "string",
-                  "description": "Neutrality note: no overall ranking; metric weights belong to the buyer."
+                "required": [
+                  "service_id",
+                  "service_name"
+                ],
+                "additionalProperties": false
+              },
+              "description": "One row per evaluated service (primary first, then compare_with candidates)."
+            },
+            "best_per_metric": {
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "type": "array",
+                "items": {
+                  "type": "string"
                 }
               },
-              "required": [
-                "rows",
-                "best_per_metric",
-                "evaluated_metrics",
-                "note"
-              ],
-              "additionalProperties": false,
-              "description": "Deterministic multi-service comparison (GLM6/94 L6) — present only when depth='preorder' and compare_with is provided. Per-metric bests ONLY, no overall ranking — the buyer decides."
+              "description": "metric name → service_ids with the best value (ties all listed). Per-metric ONLY."
+            },
+            "evaluated_metrics": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Metrics actually compared (skipped when fewer than 2 rows have data)."
+            },
+            "note": {
+              "type": "string",
+              "description": "Neutrality note: no overall ranking; metric weights belong to the buyer."
             }
           },
           "required": [
-            "service_id",
-            "service_name",
-            "service_basics",
-            "trust_score",
-            "order_amount",
-            "depth"
+            "rows",
+            "best_per_metric",
+            "evaluated_metrics",
+            "note"
           ],
-          "additionalProperties": false,
-          "description": "Trust score result. Contains: trust_score (ServiceTrustScore), risk_score (RiskScore, when depth >= evaluate), info_puzzle summary, preorder_advice (PreorderAdvice, when depth = preorder), comparison (PreorderComparison, when depth = preorder and compare_with given), and service_basics snapshot."
+          "additionalProperties": false
         }
       },
       "required": [
-        "result"
+        "service_id",
+        "service_name",
+        "service_basics",
+        "trust_score",
+        "order_amount",
+        "depth"
       ],
-      "additionalProperties": false
+      "additionalProperties": false,
+      "description": "Trust score result. Contains: trust_score (ServiceTrustScore), risk_score (RiskScore, when depth >= evaluate), info_puzzle summary, preorder_advice (PreorderAdvice, when depth = preorder), comparison (PreorderComparison, when depth = preorder and compare_with given), and service_basics snapshot."
     }
-  }
+  },
+  "required": [
+    "result"
+  ],
+  "additionalProperties": false
 }