Fengshui Calculator

Chinese calendar for a date: lunar date (with leap month), zodiac, day officer 建除, yellow/black path, six-day cycle — computed on Beijing time

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD, 1901–2199; defaults to today (Beijing)"
    }
  },
  "required": []
}

Four pillars (BaZi) for a date+hour, returned under BOTH year conventions (Lichun vs Lunar New Year) × BOTH day boundaries (midnight vs 23:00) — differences are shown, not hidden

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "hour": {
      "type": "integer",
      "description": "0–23; defaults to noon"
    }
  },
  "required": []
}

All 24 solar terms of a year with exact Beijing instants (DE441-based), ΔT, and midnight-margin uncertainty flags

{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "description": "1901–2199"
    }
  },
  "required": []
}

Ming Gua (Kua number) from birth date + gender, with the Lichun year boundary computed astronomically, five-yellow substitution conventions, and eight favourable/unfavourable directions

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "birth date YYYY-MM-DD"
    },
    "hour": {
      "type": "integer"
    },
    "minute": {
      "type": "integer"
    },
    "gender": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ]
    },
    "convention": {
      "type": "string",
      "enum": [
        "standard",
        "gen"
      ],
      "description": "five-yellow substitution: standard = male Kun/female Gen; gen = both Gen"
    }
  },
  "required": [
    "gender"
  ]
}

Xuan Kong flying star natal chart: nine palaces with mountain/facing/period stars plus classical pattern labels (e.g. 旺山旺向). Period from a construction date, or explicit yun

{
  "type": "object",
  "properties": {
    "yun": {
      "type": "integer",
      "description": "period 1–9; omit to use the period of the reference date"
    },
    "sitting": {
      "type": "string",
      "description": "sitting mountain: index 0–23 or Chinese name 子癸丑艮寅甲卯乙辰巽巳丙午丁未坤申庚酉辛戌乾亥壬"
    },
    "kind": {
      "type": "string",
      "enum": [
        "xiagua",
        "tigua"
      ]
    },
    "date": {
      "type": "string",
      "description": "when yun is omitted: the construction date whose period is used"
    }
  },
  "required": [
    "sitting"
  ]
}

San Yuan period (三元九运, 1–9) for a date; periods switch at Lichun, anchored 1984 = start of Period 7

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string"
    }
  },
  "required": []
}

List the rule sets the kernel actually implements, with parameters and honest review_state — nothing not implemented is advertised

{
  "type": "object",
  "properties": {},
  "required": []
}

Indoor form-sha from a floor-plan wireframe: 穿堂煞 (door-window alignment), 缺角 (nine-palace missing corners), 厕占中宫 (toilet at centre) — plus optional fusion with the Eight Mansions house stars and Ming Gua. Grade B verdicts, no aggregate score

{
  "type": "object",
  "properties": {
    "plan": {
      "type": "object",
      "description": "floor-plan wireframe: { exterior: [[x,y]...], rooms: [{kind, polygon}], openings: [{kind, a, b, is_entry}], walls: [[a,b]...] } in meters (y axis = north by drafting convention)"
    },
    "rotation_deg": {
      "type": "number",
      "description": "plan y-axis deviation from true north, clockwise — must come from compass measurement"
    },
    "sitting_index": {
      "type": "integer",
      "description": "sitting mountain index 0–23 (0 = 子), enables Eight Mansions fusion"
    },
    "birth_year": {
      "type": "integer",
      "description": "birth year for Ming Gua (enables personal palace stars + 宅命配)"
    },
    "gender": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ]
    },
    "minggua_convention": {
      "type": "string",
      "enum": [
        "standard",
        "gen"
      ]
    }
  },
  "required": [
    "plan"
  ]
}

White tiger elevation check (白虎抬头) from a DEM-derived 360-bin skyline: compares the right (white tiger) vs left (azure dragon) sector elevation within ±45° of the sitting direction

{
  "type": "object",
  "properties": {
    "skyline_360": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "360 elevation angles (degrees), one per azimuth degree"
    },
    "sitting_azimuth_deg": {
      "type": "number",
      "description": "sitting direction azimuth (0 = north, clockwise)"
    }
  },
  "required": [
    "skyline_360",
    "sitting_azimuth_deg"
  ]
}

Verifiability as an API call: recompute a stored request and compare its SHA-256 input digest (JCS-canonicalised) against an expected value — byte-identical reproduction or honest mismatch

{
  "type": "object",
  "properties": {
    "request": {
      "type": "object",
      "description": "the original kernel request JSON"
    },
    "expected_input_digest": {
      "type": "string",
      "description": "64-hex SHA-256 from the report being verified"
    },
    "engine_version": {
      "type": "string",
      "description": "snapshot engine version; mismatch → 409-style error"
    }
  },
  "required": [
    "request"
  ]
}