YOWAYOW Mind-Key Decision

Use this zero-AI preflight before heart_cast when the original question is ambiguous or unstructured. It rejects ordinary fact lookups, pure prophecy, fortune, hidden facts, traditional liuyao, and high-stakes professional replacement. It returns research_required, needs_detail, or out_of_scope, plus the autonomous agent's next step. A needs_detail response means the agent should extract or research objective, options, constraints, success criteria, and current evidence; it does not require a human reply when authorized sources are available.

{
  "type": "object",
  "properties": {
    "locale": {
      "default": "zh",
      "type": "string",
      "enum": [
        "zh",
        "en"
      ]
    },
    "question": {
      "type": "string",
      "minLength": 4,
      "maxLength": 1200,
      "description": "The user's original question before six-position evidence mapping."
    }
  },
  "required": [
    "question"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "research_required",
        "needs_detail",
        "out_of_scope"
      ]
    },
    "method_version": {
      "type": "string"
    },
    "ai_used": {
      "type": "boolean",
      "const": false
    }
  },
  "required": [
    "status",
    "method_version",
    "ai_used"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}

Deterministically cast a YOWAYOW Mind-Key hexagram from six evidence-grounded root/body/outcome positions. Use after an autonomous agent has researched a concrete action choice, structural diagnosis, experiment, or macro-structure question. Submit current facts and their manifestation verdicts; never submit yin/yang lines or a desired hexagram. The tool returns cast_ready, needs_evidence, or out_of_scope. It uses no LLM, no random/time casting, and never falls back to traditional liuyao. Do not use for fortune, luck, hidden facts, random outcomes, or as a substitute for high-stakes professional judgment.

{
  "type": "object",
  "properties": {
    "locale": {
      "default": "zh",
      "type": "string",
      "enum": [
        "zh",
        "en"
      ]
    },
    "question": {
      "type": "string",
      "minLength": 8,
      "maxLength": 1200,
      "description": "A concrete structural or action question. Not a fortune, luck, hidden-fact, or pure prophecy question."
    },
    "purpose": {
      "type": "string",
      "enum": [
        "choose_action",
        "diagnose_structure",
        "plan_experiment",
        "analyze_macro_structure"
      ],
      "description": "Why the agent needs the cast. This MCP does not support fortune-telling or traditional liuyao."
    },
    "decision_context": {
      "type": "object",
      "properties": {
        "objective": {
          "type": "string",
          "minLength": 4,
          "maxLength": 800,
          "description": "The concrete objective or decision to be improved."
        },
        "options": {
          "default": [],
          "description": "Existing options. choose_action requires at least two distinct options.",
          "maxItems": 8,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 2,
            "maxLength": 300
          }
        },
        "time_horizon": {
          "description": "Decision horizon, not a divination time seed. Example: next 90 days.",
          "type": "string",
          "maxLength": 160
        },
        "success_criteria": {
          "default": [],
          "description": "Observable criteria that would show the decision worked.",
          "maxItems": 10,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 2,
            "maxLength": 400
          }
        },
        "constraints": {
          "default": [],
          "description": "Known boundaries such as budget, regulation, capacity, deadlines, or risk limits.",
          "maxItems": 12,
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 2,
            "maxLength": 400
          }
        }
      },
      "required": [
        "objective"
      ],
      "additionalProperties": false
    },
    "subject": {
      "type": "object",
      "properties": {
        "label": {
          "type": "string",
          "minLength": 2,
          "maxLength": 300,
          "description": "Concrete identity of this side. Subject is the controllable/action side; environment is the dominant external constraint."
        },
        "root": {
          "description": "Root: underlying drive, foundation, long-term pressure, or prerequisite.",
          "type": "object",
          "properties": {
            "focus": {
              "type": "string",
              "minLength": 2,
              "maxLength": 300,
              "description": "What this causal position represents in this case."
            },
            "evidence": {
              "default": [],
              "description": "Evidence for whether this position is currently manifested. Do not submit yin/yang or a desired hexagram.",
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "claim": {
                    "type": "string",
                    "minLength": 4,
                    "maxLength": 800,
                    "description": "A concrete current fact. Do not put a forecast, recommendation, or hexagram judgment here."
                  },
                  "verdict": {
                    "type": "string",
                    "enum": [
                      "manifested",
                      "not_manifested",
                      "uncertain"
                    ],
                    "description": "manifested = currently active or observable; not_manifested = verified not yet active or observable; uncertain = not established."
                  },
                  "source_type": {
                    "type": "string",
                    "enum": [
                      "public_source",
                      "internal_record",
                      "direct_observation",
                      "principal_statement",
                      "analysis_assumption"
                    ],
                    "description": "Where the fact came from. analysis_assumption is allowed for transparency but can never settle a line."
                  },
                  "source_ref": {
                    "description": "Public URL or an authorized internal record identifier. Required for public_source and internal_record.",
                    "type": "string",
                    "maxLength": 1000
                  },
                  "observed_at": {
                    "description": "ISO-8601 date/time or a precise observation period when freshness matters.",
                    "type": "string",
                    "maxLength": 80
                  },
                  "confidence": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1,
                    "description": "Confidence in this evidence item. At least 0.65 is required to settle a line."
                  }
                },
                "required": [
                  "claim",
                  "verdict",
                  "source_type",
                  "confidence"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "focus"
          ],
          "additionalProperties": false
        },
        "body": {
          "description": "Body: current mechanism, coordination, resource flow, or control point.",
          "type": "object",
          "properties": {
            "focus": {
              "type": "string",
              "minLength": 2,
              "maxLength": 300,
              "description": "What this causal position represents in this case."
            },
            "evidence": {
              "default": [],
              "description": "Evidence for whether this position is currently manifested. Do not submit yin/yang or a desired hexagram.",
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "claim": {
                    "type": "string",
                    "minLength": 4,
                    "maxLength": 800,
                    "description": "A concrete current fact. Do not put a forecast, recommendation, or hexagram judgment here."
                  },
                  "verdict": {
                    "type": "string",
                    "enum": [
                      "manifested",
                      "not_manifested",
                      "uncertain"
                    ],
                    "description": "manifested = currently active or observable; not_manifested = verified not yet active or observable; uncertain = not established."
                  },
                  "source_type": {
                    "type": "string",
                    "enum": [
                      "public_source",
                      "internal_record",
                      "direct_observation",
                      "principal_statement",
                      "analysis_assumption"
                    ],
                    "description": "Where the fact came from. analysis_assumption is allowed for transparency but can never settle a line."
                  },
                  "source_ref": {
                    "description": "Public URL or an authorized internal record identifier. Required for public_source and internal_record.",
                    "type": "string",
                    "maxLength": 1000
                  },
                  "observed_at": {
                    "description": "ISO-8601 date/time or a precise observation period when freshness matters.",
                    "type": "string",
                    "maxLength": 80
                  },
                  "confidence": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1,
                    "description": "Confidence in this evidence item. At least 0.65 is required to settle a line."
                  }
                },
                "required": [
                  "claim",
                  "verdict",
                  "source_type",
                  "confidence"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "focus"
          ],
          "additionalProperties": false
        },
        "outcome": {
          "description": "Outcome: current observable action, result, metric, or already-manifested consequence.",
          "type": "object",
          "properties": {
            "focus": {
              "type": "string",
              "minLength": 2,
              "maxLength": 300,
              "description": "What this causal position represents in this case."
            },
            "evidence": {
              "default": [],
              "description": "Evidence for whether this position is currently manifested. Do not submit yin/yang or a desired hexagram.",
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "claim": {
                    "type": "string",
                    "minLength": 4,
                    "maxLength": 800,
                    "description": "A concrete current fact. Do not put a forecast, recommendation, or hexagram judgment here."
                  },
                  "verdict": {
                    "type": "string",
                    "enum": [
                      "manifested",
                      "not_manifested",
                      "uncertain"
                    ],
                    "description": "manifested = currently active or observable; not_manifested = verified not yet active or observable; uncertain = not established."
                  },
                  "source_type": {
                    "type": "string",
                    "enum": [
                      "public_source",
                      "internal_record",
                      "direct_observation",
                      "principal_statement",
                      "analysis_assumption"
                    ],
                    "description": "Where the fact came from. analysis_assumption is allowed for transparency but can never settle a line."
                  },
                  "source_ref": {
                    "description": "Public URL or an authorized internal record identifier. Required for public_source and internal_record.",
                    "type": "string",
                    "maxLength": 1000
                  },
                  "observed_at": {
                    "description": "ISO-8601 date/time or a precise observation period when freshness matters.",
                    "type": "string",
                    "maxLength": 80
                  },
                  "confidence": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1,
                    "description": "Confidence in this evidence item. At least 0.65 is required to settle a line."
                  }
                },
                "required": [
                  "claim",
                  "verdict",
                  "source_type",
                  "confidence"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "focus"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "label"
      ],
      "additionalProperties": false,
      "description": "Lower trigram: the controllable, acting, or focal side."
    },
    "environment": {
      "type": "object",
      "properties": {
        "label": {
          "type": "string",
          "minLength": 2,
          "maxLength": 300,
          "description": "Concrete identity of this side. Subject is the controllable/action side; environment is the dominant external constraint."
        },
        "root": {
          "description": "Root: underlying drive, foundation, long-term pressure, or prerequisite.",
          "type": "object",
          "properties": {
            "focus": {
              "type": "string",
              "minLength": 2,
              "maxLength": 300,
              "description": "What this causal position represents in this case."
            },
            "evidence": {
              "default": [],
              "description": "Evidence for whether this position is currently manifested. Do not submit yin/yang or a desired hexagram.",
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "claim": {
                    "type": "string",
                    "minLength": 4,
                    "maxLength": 800,
                    "description": "A concrete current fact. Do not put a forecast, recommendation, or hexagram judgment here."
                  },
                  "verdict": {
                    "type": "string",
                    "enum": [
                      "manifested",
                      "not_manifested",
                      "uncertain"
                    ],
                    "description": "manifested = currently active or observable; not_manifested = verified not yet active or observable; uncertain = not established."
                  },
                  "source_type": {
                    "type": "string",
                    "enum": [
                      "public_source",
                      "internal_record",
                      "direct_observation",
                      "principal_statement",
                      "analysis_assumption"
                    ],
                    "description": "Where the fact came from. analysis_assumption is allowed for transparency but can never settle a line."
                  },
                  "source_ref": {
                    "description": "Public URL or an authorized internal record identifier. Required for public_source and internal_record.",
                    "type": "string",
                    "maxLength": 1000
                  },
                  "observed_at": {
                    "description": "ISO-8601 date/time or a precise observation period when freshness matters.",
                    "type": "string",
                    "maxLength": 80
                  },
                  "confidence": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1,
                    "description": "Confidence in this evidence item. At least 0.65 is required to settle a line."
                  }
                },
                "required": [
                  "claim",
                  "verdict",
                  "source_type",
                  "confidence"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "focus"
          ],
          "additionalProperties": false
        },
        "body": {
          "description": "Body: current mechanism, coordination, resource flow, or control point.",
          "type": "object",
          "properties": {
            "focus": {
              "type": "string",
              "minLength": 2,
              "maxLength": 300,
              "description": "What this causal position represents in this case."
            },
            "evidence": {
              "default": [],
              "description": "Evidence for whether this position is currently manifested. Do not submit yin/yang or a desired hexagram.",
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "claim": {
                    "type": "string",
                    "minLength": 4,
                    "maxLength": 800,
                    "description": "A concrete current fact. Do not put a forecast, recommendation, or hexagram judgment here."
                  },
                  "verdict": {
                    "type": "string",
                    "enum": [
                      "manifested",
                      "not_manifested",
                      "uncertain"
                    ],
                    "description": "manifested = currently active or observable; not_manifested = verified not yet active or observable; uncertain = not established."
                  },
                  "source_type": {
                    "type": "string",
                    "enum": [
                      "public_source",
                      "internal_record",
                      "direct_observation",
                      "principal_statement",
                      "analysis_assumption"
                    ],
                    "description": "Where the fact came from. analysis_assumption is allowed for transparency but can never settle a line."
                  },
                  "source_ref": {
                    "description": "Public URL or an authorized internal record identifier. Required for public_source and internal_record.",
                    "type": "string",
                    "maxLength": 1000
                  },
                  "observed_at": {
                    "description": "ISO-8601 date/time or a precise observation period when freshness matters.",
                    "type": "string",
                    "maxLength": 80
                  },
                  "confidence": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1,
                    "description": "Confidence in this evidence item. At least 0.65 is required to settle a line."
                  }
                },
                "required": [
                  "claim",
                  "verdict",
                  "source_type",
                  "confidence"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "focus"
          ],
          "additionalProperties": false
        },
        "outcome": {
          "description": "Outcome: current observable action, result, metric, or already-manifested consequence.",
          "type": "object",
          "properties": {
            "focus": {
              "type": "string",
              "minLength": 2,
              "maxLength": 300,
              "description": "What this causal position represents in this case."
            },
            "evidence": {
              "default": [],
              "description": "Evidence for whether this position is currently manifested. Do not submit yin/yang or a desired hexagram.",
              "maxItems": 8,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "claim": {
                    "type": "string",
                    "minLength": 4,
                    "maxLength": 800,
                    "description": "A concrete current fact. Do not put a forecast, recommendation, or hexagram judgment here."
                  },
                  "verdict": {
                    "type": "string",
                    "enum": [
                      "manifested",
                      "not_manifested",
                      "uncertain"
                    ],
                    "description": "manifested = currently active or observable; not_manifested = verified not yet active or observable; uncertain = not established."
                  },
                  "source_type": {
                    "type": "string",
                    "enum": [
                      "public_source",
                      "internal_record",
                      "direct_observation",
                      "principal_statement",
                      "analysis_assumption"
                    ],
                    "description": "Where the fact came from. analysis_assumption is allowed for transparency but can never settle a line."
                  },
                  "source_ref": {
                    "description": "Public URL or an authorized internal record identifier. Required for public_source and internal_record.",
                    "type": "string",
                    "maxLength": 1000
                  },
                  "observed_at": {
                    "description": "ISO-8601 date/time or a precise observation period when freshness matters.",
                    "type": "string",
                    "maxLength": 80
                  },
                  "confidence": {
                    "type": "number",
                    "minimum": 0,
                    "maximum": 1,
                    "description": "Confidence in this evidence item. At least 0.65 is required to settle a line."
                  }
                },
                "required": [
                  "claim",
                  "verdict",
                  "source_type",
                  "confidence"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "focus"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "label"
      ],
      "additionalProperties": false,
      "description": "Upper trigram: the dominant external constraint or interaction environment."
    }
  },
  "required": [
    "question",
    "purpose",
    "decision_context",
    "subject",
    "environment"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "cast_ready",
        "needs_evidence",
        "out_of_scope"
      ]
    },
    "method_version": {
      "type": "string"
    },
    "mode": {
      "type": "string",
      "const": "heart_structure_only"
    },
    "ai_used": {
      "type": "boolean",
      "const": false
    },
    "fallback_used": {
      "type": "boolean",
      "const": false
    }
  },
  "required": [
    "status",
    "method_version",
    "mode",
    "ai_used",
    "fallback_used"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}