{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "house_system": {
      "type": "string",
      "default": "placidus",
      "description": "House system (default placidus). Case- and spacing-insensitive; valid: placidus, whole_sign, equal, porphyry, koch, regiomontanus, campanus, alcabitius, morinus, meridian, polich_page, vehlow (aliases like \"whole sign\" also work)."
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    },
    "separation": {
      "type": "string",
      "enum": [
        "longitude",
        "spatial"
      ],
      "default": "longitude",
      "description": "Aspect separation: 'longitude' (default, the zodiacal aspect) or 'spatial' (true great-circle separation accounting for ecliptic latitude — differs for the Moon, Pluto, and bodies far off the ecliptic)"
    },
    "output": {
      "type": "string",
      "enum": [
        "float",
        "canonical"
      ],
      "default": "float",
      "description": "'float' (default) returns the usual floating-point payload. 'canonical' returns integers on a declared grid plus a sha256 digest: stable across machines/browsers/languages, hashable for caching and dedupe, precision-honest, with sign/house/aspects re-derived from the quantized values so displayed numbers and facts always agree"
    },
    "grid": {
      "type": "string",
      "enum": [
        "arcsec",
        "milliarcsec",
        "centideg",
        "dms",
        "accuracy"
      ],
      "default": "arcsec",
      "description": "Canonical grid (with output:'canonical'): arcsec (default), milliarcsec, centideg, dms ([deg,min,sec] triples), or accuracy (each body snapped to its measured validated accuracy — the most portable choice for cross-platform content addressing)"
    },
    "remainders": {
      "type": "string",
      "enum": [
        "auto",
        "arcsec",
        "milliarcsec"
      ],
      "description": "With output:'canonical': also return the remainder set — the integer sub-quantum residues quantization discarded, keyed by leaf path and bound to the payload digest. 'auto' picks one grid finer than the base; or name the refinement grid (must be strictly finer). Residues telescope: composeRemainders(payload, remainders) rebuilds the finer-grid payload exactly. Time residues are integer microseconds, distance residues integer nano-AU"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC ISO date-time (convert from local first); omit for now"
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive; default 0 makes houses nominal",
      "default": 0
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative); default 0 makes houses nominal",
      "default": 0
    },
    "house_system": {
      "type": "string",
      "default": "placidus",
      "description": "House system (default placidus). Case- and spacing-insensitive; valid: placidus, whole_sign, equal, porphyry, koch, regiomontanus, campanus, alcabitius, morinus, meridian, polich_page, vehlow (aliases like \"whole sign\" also work)."
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    },
    "separation": {
      "type": "string",
      "enum": [
        "longitude",
        "spatial"
      ],
      "default": "longitude",
      "description": "Aspect separation: 'longitude' (default, the zodiacal aspect) or 'spatial' (true great-circle separation accounting for ecliptic latitude — differs for the Moon, Pluto, and bodies far off the ecliptic)"
    },
    "output": {
      "type": "string",
      "enum": [
        "float",
        "canonical"
      ],
      "default": "float",
      "description": "'float' (default) returns the usual floating-point payload. 'canonical' returns integers on a declared grid plus a sha256 digest: stable across machines/browsers/languages, hashable for caching and dedupe, precision-honest, with sign/house/aspects re-derived from the quantized values so displayed numbers and facts always agree"
    },
    "grid": {
      "type": "string",
      "enum": [
        "arcsec",
        "milliarcsec",
        "centideg",
        "dms",
        "accuracy"
      ],
      "default": "arcsec",
      "description": "Canonical grid (with output:'canonical'): arcsec (default), milliarcsec, centideg, dms ([deg,min,sec] triples), or accuracy (each body snapped to its measured validated accuracy — the most portable choice for cross-platform content addressing)"
    },
    "remainders": {
      "type": "string",
      "enum": [
        "auto",
        "arcsec",
        "milliarcsec"
      ],
      "description": "With output:'canonical': also return the remainder set — the integer sub-quantum residues quantization discarded, keyed by leaf path and bound to the payload digest. 'auto' picks one grid finer than the base; or name the refinement grid (must be strictly finer). Residues telescope: composeRemainders(payload, remainders) rebuilds the finer-grid payload exactly. Time residues are integer microseconds, distance residues integer nano-AU"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC ISO date-time (convert from local first); omit for now"
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "elevation_m": {
      "type": "number",
      "description": "Eye height above ground in meters (e.g. 9 for a third-floor window)"
    },
    "azimuth": {
      "type": [
        "number",
        "string"
      ],
      "description": "Center compass direction: degrees from true north (east positive) or a 16-point name like \"W\" or \"WNW\""
    },
    "altitude": {
      "type": "number",
      "minimum": -10,
      "maximum": 90,
      "default": 5,
      "description": "Center altitude in degrees: 0 looks at the horizon, positive tilts up"
    },
    "lens": {
      "type": "string",
      "enum": [
        "ultrawide",
        "wide",
        "standard",
        "normal",
        "portrait",
        "telephoto",
        "supertele"
      ],
      "default": "normal",
      "description": "Lens preset; sets field of view and projection (ultrawide is fisheye, the rest rectilinear)"
    },
    "width": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "default": 1024,
      "description": "Output image width in pixels"
    },
    "height": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "default": 683,
      "description": "Output image height in pixels"
    },
    "bortle": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9,
      "description": "Dark-sky class, 1 (pristine) to 9 (inner city). Sets the night naked-eye limit and drives background star density and Milky Way visibility. Omit for a suburban default"
    },
    "deep_field": {
      "type": "boolean",
      "default": false,
      "description": "Pin the complete deep naked-eye star field (thousands of stars at exact pixels) instead of the bright catalog. Larger response; great for control images"
    },
    "overlays": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "ecliptic",
          "signs",
          "houses",
          "constellations"
        ]
      },
      "description": "Reference-frame overlays to project (annotations, not photoreal): the ecliptic line, the zodiac signs, house cusps and angles, and constellation figures. Exact pixels returned in `overlays`"
    },
    "include_stars": {
      "type": "boolean",
      "default": true,
      "description": "Include bright catalog stars when a star catalog is loaded"
    },
    "max_star_mag": {
      "type": "number",
      "description": "Brightest-magnitude cutoff for stars (smaller is brighter); default 2.5, or the limiting magnitude when bortle is set"
    }
  },
  "required": [
    "lat",
    "lon",
    "azimuth"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "First frame, UTC ISO date-time; omit for now"
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "azimuth": {
      "type": [
        "number",
        "string"
      ],
      "description": "Center direction: degrees from true north or a compass name like \"W\""
    },
    "altitude": {
      "type": "number",
      "minimum": -10,
      "maximum": 90,
      "default": 20,
      "description": "Center altitude in degrees"
    },
    "lens": {
      "type": "string",
      "enum": [
        "ultrawide",
        "wide",
        "standard",
        "normal",
        "portrait",
        "telephoto",
        "supertele"
      ],
      "default": "normal"
    },
    "frames": {
      "type": "integer",
      "minimum": 2,
      "maximum": 60,
      "description": "Number of frames (2-60)"
    },
    "step_minutes": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Minutes between frames"
    },
    "bortle": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9,
      "description": "Dark-sky class 1-9"
    },
    "width": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "default": 1024
    },
    "height": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "default": 683
    }
  },
  "required": [
    "lat",
    "lon",
    "azimuth",
    "frames",
    "step_minutes"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "system": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "bodies": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "mode": {
                    "type": "string",
                    "const": "placement"
                  },
                  "lonDeg": {
                    "type": "number"
                  }
                },
                "required": [
                  "id",
                  "mode",
                  "lonDeg"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "mode": {
                    "type": "string",
                    "const": "periodic"
                  },
                  "periodDays": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  },
                  "phaseDeg": {
                    "type": "number"
                  },
                  "epoch": {
                    "type": "number"
                  }
                },
                "required": [
                  "id",
                  "mode",
                  "periodDays",
                  "phaseDeg"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "mode": {
                    "type": "string",
                    "const": "kepler"
                  },
                  "a": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  },
                  "e": {
                    "type": "number",
                    "minimum": 0,
                    "exclusiveMaximum": 1
                  },
                  "i": {
                    "type": "number"
                  },
                  "node": {
                    "type": "number"
                  },
                  "peri": {
                    "type": "number"
                  },
                  "M0": {
                    "type": "number"
                  },
                  "periodDays": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  },
                  "epoch": {
                    "type": "number"
                  }
                },
                "required": [
                  "id",
                  "mode",
                  "a",
                  "e",
                  "i",
                  "node",
                  "peri",
                  "M0",
                  "periodDays"
                ],
                "additionalProperties": false
              }
            ]
          },
          "minItems": 1
        },
        "observer": {
          "type": "string"
        },
        "render": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "sizeDeg": {
                "type": "number"
              },
              "magnitude": {
                "type": "number"
              },
              "color": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        }
      },
      "required": [
        "id",
        "bodies"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "system"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "system": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "bodies": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "mode": {
                    "type": "string",
                    "const": "placement"
                  },
                  "lonDeg": {
                    "type": "number"
                  }
                },
                "required": [
                  "id",
                  "mode",
                  "lonDeg"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "mode": {
                    "type": "string",
                    "const": "periodic"
                  },
                  "periodDays": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  },
                  "phaseDeg": {
                    "type": "number"
                  },
                  "epoch": {
                    "type": "number"
                  }
                },
                "required": [
                  "id",
                  "mode",
                  "periodDays",
                  "phaseDeg"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "mode": {
                    "type": "string",
                    "const": "kepler"
                  },
                  "a": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  },
                  "e": {
                    "type": "number",
                    "minimum": 0,
                    "exclusiveMaximum": 1
                  },
                  "i": {
                    "type": "number"
                  },
                  "node": {
                    "type": "number"
                  },
                  "peri": {
                    "type": "number"
                  },
                  "M0": {
                    "type": "number"
                  },
                  "periodDays": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  },
                  "epoch": {
                    "type": "number"
                  }
                },
                "required": [
                  "id",
                  "mode",
                  "a",
                  "e",
                  "i",
                  "node",
                  "peri",
                  "M0",
                  "periodDays"
                ],
                "additionalProperties": false
              }
            ]
          },
          "minItems": 1
        },
        "observer": {
          "type": "string"
        },
        "render": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "sizeDeg": {
                "type": "number"
              },
              "magnitude": {
                "type": "number"
              },
              "color": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        }
      },
      "required": [
        "id",
        "bodies"
      ],
      "additionalProperties": false
    },
    "date": {
      "type": "string",
      "description": "UT instant as ISO 8601; used as t when t_days is omitted"
    },
    "t_days": {
      "type": "number",
      "description": "Time in the same day units as each body's periodDays/epoch (abstract world frame)"
    }
  },
  "required": [
    "system"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "system": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "bodies": {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "mode": {
                    "type": "string",
                    "const": "placement"
                  },
                  "lonDeg": {
                    "type": "number"
                  }
                },
                "required": [
                  "id",
                  "mode",
                  "lonDeg"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "mode": {
                    "type": "string",
                    "const": "periodic"
                  },
                  "periodDays": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  },
                  "phaseDeg": {
                    "type": "number"
                  },
                  "epoch": {
                    "type": "number"
                  }
                },
                "required": [
                  "id",
                  "mode",
                  "periodDays",
                  "phaseDeg"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "mode": {
                    "type": "string",
                    "const": "kepler"
                  },
                  "a": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  },
                  "e": {
                    "type": "number",
                    "minimum": 0,
                    "exclusiveMaximum": 1
                  },
                  "i": {
                    "type": "number"
                  },
                  "node": {
                    "type": "number"
                  },
                  "peri": {
                    "type": "number"
                  },
                  "M0": {
                    "type": "number"
                  },
                  "periodDays": {
                    "type": "number",
                    "exclusiveMinimum": 0
                  },
                  "epoch": {
                    "type": "number"
                  }
                },
                "required": [
                  "id",
                  "mode",
                  "a",
                  "e",
                  "i",
                  "node",
                  "peri",
                  "M0",
                  "periodDays"
                ],
                "additionalProperties": false
              }
            ]
          },
          "minItems": 1
        },
        "observer": {
          "type": "string"
        },
        "render": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "properties": {
              "sizeDeg": {
                "type": "number"
              },
              "magnitude": {
                "type": "number"
              },
              "color": {
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        }
      },
      "required": [
        "id",
        "bodies"
      ],
      "additionalProperties": false
    },
    "date": {
      "type": "string",
      "description": "UTC ISO date-time; omit for now"
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "elevation_m": {
      "type": "number",
      "description": "Eye height above ground in meters"
    },
    "azimuth": {
      "type": [
        "number",
        "string"
      ],
      "description": "Center direction: degrees from true north or a compass name"
    },
    "altitude": {
      "type": "number",
      "minimum": -10,
      "maximum": 90,
      "default": 5,
      "description": "Center altitude in degrees"
    },
    "lens": {
      "type": "string",
      "enum": [
        "ultrawide",
        "wide",
        "standard",
        "normal",
        "portrait",
        "telephoto",
        "supertele"
      ],
      "default": "normal"
    },
    "width": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "default": 1024
    },
    "height": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "default": 683
    },
    "bortle": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9
    },
    "bodies": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Body ids to draw; defaults to Sun, Moon, planets, and every synthetic body"
    },
    "include_stars": {
      "type": "boolean",
      "default": false,
      "description": "Include catalog stars (usually off for fictional skies)"
    }
  },
  "required": [
    "system",
    "lat",
    "lon",
    "azimuth"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "transit_date": {
      "type": "string",
      "description": "UTC ISO date-time of transit moment (convert from local first); omit for now"
    },
    "orb": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 10,
      "default": 3,
      "description": "Max orb in degrees"
    },
    "house_system": {
      "type": "string",
      "default": "placidus",
      "description": "House system (default placidus). Case- and spacing-insensitive; valid: placidus, whole_sign, equal, porphyry, koch, regiomontanus, campanus, alcabitius, morinus, meridian, polich_page, vehlow (aliases like \"whole sign\" also work)."
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "a": {
      "type": "object",
      "properties": {
        "date": {
          "type": "string",
          "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
        },
        "lat": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "description": "Latitude, north positive"
        },
        "lon": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "description": "Longitude, EAST positive (Americas are negative)"
        }
      },
      "required": [
        "date",
        "lat",
        "lon"
      ],
      "additionalProperties": false,
      "description": "Person A birth data (UTC date, lat, lon)"
    },
    "b": {
      "type": "object",
      "properties": {
        "date": {
          "$ref": "#/properties/a/properties/date"
        },
        "lat": {
          "$ref": "#/properties/a/properties/lat"
        },
        "lon": {
          "$ref": "#/properties/a/properties/lon"
        }
      },
      "required": [
        "date",
        "lat",
        "lon"
      ],
      "additionalProperties": false,
      "description": "Person B birth data (UTC date, lat, lon)"
    },
    "orb": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 10,
      "default": 4,
      "description": "Max orb in degrees"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "required": [
    "a",
    "b"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "body": {
      "type": "string",
      "enum": [
        "sun",
        "moon",
        "mercury",
        "venus",
        "mars",
        "jupiter",
        "saturn",
        "uranus",
        "neptune",
        "pluto",
        "chiron",
        "mean_node",
        "true_node"
      ],
      "description": "Transiting body (snake_case, e.g. saturn, true_node)"
    },
    "aspect": {
      "type": "string",
      "enum": [
        "conjunction",
        "sextile",
        "square",
        "trine",
        "opposition"
      ]
    },
    "target_lon": {
      "type": "number",
      "minimum": 0,
      "maximum": 360,
      "description": "Fixed natal longitude in degrees. Provide this OR target_body, not both."
    },
    "target_body": {
      "type": "string",
      "enum": [
        "sun",
        "moon",
        "mercury",
        "venus",
        "mars",
        "jupiter",
        "saturn",
        "uranus",
        "neptune",
        "pluto",
        "chiron",
        "mean_node",
        "true_node"
      ],
      "description": "Another transiting body. Provide this OR target_lon, not both."
    },
    "start": {
      "type": "string",
      "description": "UTC ISO start date (convert from local first)"
    },
    "end": {
      "type": "string",
      "description": "UTC ISO end date (convert from local first); range <= 50 years"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "Zodiac for body and target_lon longitudes; tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "required": [
    "body",
    "aspect",
    "start",
    "end"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Birth DATE (UTC) as ISO; only the calendar date is used, the time portion is ignored (the window_*_hour fields set the times swept)"
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "window_start_hour": {
      "type": "number",
      "minimum": 0,
      "maximum": 24,
      "default": 0,
      "description": "First UTC hour of the date to sweep"
    },
    "window_end_hour": {
      "type": "number",
      "minimum": 0,
      "maximum": 24,
      "default": 24,
      "description": "Last UTC hour of the date to sweep"
    },
    "step_minutes": {
      "type": "number",
      "minimum": 5,
      "maximum": 120,
      "default": 20,
      "description": "Minutes between grid rows"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "start": {
      "type": "string",
      "description": "UTC ISO start date (convert from local first)"
    },
    "end": {
      "type": "string",
      "description": "UTC ISO end date; range <= 370 days"
    },
    "kinds": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "rise",
          "set",
          "mtransit",
          "itransit",
          "phase",
          "station",
          "crossing",
          "solar_eclipse",
          "lunar_eclipse"
        ]
      },
      "minItems": 1,
      "description": "Event kinds to include"
    },
    "body": {
      "type": "string",
      "enum": [
        "sun",
        "moon",
        "mercury",
        "venus",
        "mars",
        "jupiter",
        "saturn",
        "uranus",
        "neptune",
        "pluto",
        "chiron",
        "mean_node",
        "true_node"
      ],
      "description": "Required for rise/set/transit/station/crossing"
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Required for rise/set/transit"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Required for rise/set/transit"
    },
    "target_lon": {
      "type": "number",
      "minimum": 0,
      "maximum": 360,
      "description": "Zodiac longitude for 'crossing', degrees"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "Zodiac for 'crossing' longitudes"
    }
  },
  "required": [
    "start",
    "end",
    "kinds"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC ISO date-time (convert from local first); omit for now"
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    }
  },
  "required": [
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC ISO date-time (convert from local first); omit for now"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "body": {
      "type": "string",
      "enum": [
        "sun",
        "moon"
      ],
      "description": "sun for the solar return, moon for the lunar return"
    },
    "search_start": {
      "type": "string",
      "description": "UTC ISO start of the window to search for returns"
    },
    "search_end": {
      "type": "string",
      "description": "UTC ISO end of the window; range <= 2 years"
    },
    "return_lat": {
      "$ref": "#/properties/lat",
      "description": "Latitude for the return chart; defaults to the birth latitude"
    },
    "return_lon": {
      "$ref": "#/properties/lon",
      "description": "Longitude (EAST positive) for the return chart; defaults to the birth longitude"
    },
    "house_system": {
      "type": "string",
      "default": "placidus",
      "description": "House system (default placidus). Case- and spacing-insensitive; valid: placidus, whole_sign, equal, porphyry, koch, regiomontanus, campanus, alcabitius, morinus, meridian, polich_page, vehlow (aliases like \"whole sign\" also work)."
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    },
    "output": {
      "type": "string",
      "enum": [
        "float",
        "canonical"
      ],
      "default": "float",
      "description": "'float' (default) returns the usual floating-point payload. 'canonical' returns integers on a declared grid plus a sha256 digest: stable across machines/browsers/languages, hashable for caching and dedupe, precision-honest, with sign/house/aspects re-derived from the quantized values so displayed numbers and facts always agree"
    },
    "grid": {
      "type": "string",
      "enum": [
        "arcsec",
        "milliarcsec",
        "centideg",
        "dms",
        "accuracy"
      ],
      "default": "arcsec",
      "description": "Canonical grid (with output:'canonical'): arcsec (default), milliarcsec, centideg, dms ([deg,min,sec] triples), or accuracy (each body snapped to its measured validated accuracy — the most portable choice for cross-platform content addressing)"
    },
    "remainders": {
      "type": "string",
      "enum": [
        "auto",
        "arcsec",
        "milliarcsec"
      ],
      "description": "With output:'canonical': also return the remainder set — the integer sub-quantum residues quantization discarded, keyed by leaf path and bound to the payload digest. 'auto' picks one grid finer than the base; or name the refinement grid (must be strictly finer). Residues telescope: composeRemainders(payload, remainders) rebuilds the finer-grid payload exactly. Time residues are integer microseconds, distance residues integer nano-AU"
    }
  },
  "required": [
    "date",
    "lat",
    "lon",
    "body",
    "search_start",
    "search_end"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "target_date": {
      "type": "string",
      "description": "UTC ISO date to progress/direct to (convert from local first)"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "required": [
    "date",
    "target_date"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "a": {
      "type": "object",
      "properties": {
        "date": {
          "type": "string",
          "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
        },
        "lat": {
          "type": "number",
          "minimum": -90,
          "maximum": 90,
          "description": "Latitude, north positive"
        },
        "lon": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "description": "Longitude, EAST positive (Americas are negative)"
        }
      },
      "required": [
        "date",
        "lat",
        "lon"
      ],
      "additionalProperties": false,
      "description": "Person A birth data (UTC date, lat, lon)"
    },
    "b": {
      "type": "object",
      "properties": {
        "date": {
          "$ref": "#/properties/a/properties/date"
        },
        "lat": {
          "$ref": "#/properties/a/properties/lat"
        },
        "lon": {
          "$ref": "#/properties/a/properties/lon"
        }
      },
      "required": [
        "date",
        "lat",
        "lon"
      ],
      "additionalProperties": false,
      "description": "Person B birth data (UTC date, lat, lon)"
    },
    "house_system": {
      "type": "string",
      "default": "placidus",
      "description": "House system (default placidus). Case- and spacing-insensitive; valid: placidus, whole_sign, equal, porphyry, koch, regiomontanus, campanus, alcabitius, morinus, meridian, polich_page, vehlow (aliases like \"whole sign\" also work)."
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "required": [
    "a",
    "b"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "target_date": {
      "type": "string",
      "description": "UTC ISO date to profect to (convert from local first)"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "required": [
    "date",
    "lat",
    "lon",
    "target_date"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "target_date": {
      "type": "string",
      "description": "UTC ISO date to look up the active period for; omit for the timeline only"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "target_date": {
      "type": "string",
      "description": "UTC ISO date to read the active L1..L4 periods for; omit for the timeline only"
    },
    "lot": {
      "type": "string",
      "enum": [
        "spirit",
        "fortune"
      ],
      "description": "the Lot to release from (default spirit)"
    },
    "max_level": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4,
      "description": "deepest sub-period level in the timeline, 1..4 (default 2)"
    },
    "horizon_years": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "timeline length in 360-day years from birth (default 100)"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "key": {
      "type": "string",
      "enum": [
        "naibod",
        "ptolemy"
      ],
      "description": "time key: naibod (0.9856473°/yr, default) or ptolemy (1°/yr)"
    },
    "max_years": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "only directions reached within this many years of life (default 90)"
    },
    "include_mundane": {
      "type": "boolean",
      "description": "also return inter-planetary (promissor → significator) directions (default false)"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "sidereal:lahiri",
      "description": "sidereal ayanamsa (default sidereal:lahiri); these are sidereal techniques"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "system": {
      "type": "string",
      "enum": [
        "vimshottari",
        "yogini",
        "ashtottari"
      ],
      "default": "vimshottari",
      "description": "dasha system: vimshottari (120y), yogini (36y), or ashtottari (108y)"
    },
    "target_date": {
      "type": "string",
      "description": "UTC ISO date to read the active lords for; omit for the timeline only"
    },
    "levels": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2,
      "description": "deepest timeline level: 1 (maha) or 2 (maha+antar, default)"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "sidereal:lahiri",
      "description": "sidereal ayanamsa (default sidereal:lahiri); these are sidereal techniques"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "divisions": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "subset of 1/2/3/9/10/12/30 (default all)"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "sidereal:lahiri",
      "description": "sidereal ayanamsa (default sidereal:lahiri); these are sidereal techniques"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "sidereal:lahiri",
      "description": "sidereal ayanamsa (default sidereal:lahiri); these are sidereal techniques"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "house_system": {
      "type": "string",
      "default": "placidus",
      "description": "House system (default placidus). Case- and spacing-insensitive; valid: placidus, whole_sign, equal, porphyry, koch, regiomontanus, campanus, alcabitius, morinus, meridian, polich_page, vehlow (aliases like \"whole sign\" also work)."
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC ISO date-time; the 24-hour window starts here. Omit for now"
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "bodies": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Bodies to consider; default the seven classical planets"
    },
    "tolerance_min": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 120,
      "default": 30,
      "description": "Paran window in minutes: the two angle crossings must fall within this gap"
    },
    "output": {
      "type": "string",
      "enum": [
        "float",
        "canonical"
      ],
      "default": "float",
      "description": "'float' (default) returns the usual floating-point payload. 'canonical' returns integers on a declared grid plus a sha256 digest: stable across machines/browsers/languages, hashable for caching and dedupe, precision-honest, with sign/house/aspects re-derived from the quantized values so displayed numbers and facts always agree"
    }
  },
  "required": [
    "lat"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "house_system": {
      "type": "string",
      "default": "placidus",
      "description": "House system (default placidus). Case- and spacing-insensitive; valid: placidus, whole_sign, equal, porphyry, koch, regiomontanus, campanus, alcabitius, morinus, meridian, polich_page, vehlow (aliases like \"whole sign\" also work)."
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "Exact UTC instant, ISO 8601 (e.g. 1990-06-10T14:30:00Z); convert local to UTC first"
    },
    "earliest": {
      "type": "string",
      "description": "Start of an uncertain-time range (UTC ISO); use with `latest` instead of `date`"
    },
    "latest": {
      "type": "string",
      "description": "End of an uncertain-time range (UTC ISO)"
    },
    "when": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "instant"
            },
            "utc": {
              "type": "string"
            }
          },
          "required": [
            "kind",
            "utc"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "range"
            },
            "earliest": {
              "type": "string"
            },
            "latest": {
              "type": "string"
            }
          },
          "required": [
            "kind",
            "earliest",
            "latest"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "relative"
            },
            "relation": {
              "type": "string",
              "enum": [
                "before",
                "after",
                "during"
              ]
            },
            "anchorId": {
              "type": "string"
            },
            "offset": {
              "type": "string"
            }
          },
          "required": [
            "kind",
            "relation",
            "anchorId"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "narrative"
            },
            "calendar": {
              "type": "string"
            },
            "value": {
              "type": "string"
            },
            "sequence": {
              "type": "number"
            }
          },
          "required": [
            "kind",
            "value"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "symbolic"
            },
            "rationale": {
              "type": "string"
            }
          },
          "required": [
            "kind",
            "rationale"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "none"
            },
            "reason": {
              "type": "string",
              "enum": [
                "atemporal",
                "time_irrelevant",
                "intentionally_unset"
              ]
            }
          },
          "required": [
            "kind",
            "reason"
          ],
          "additionalProperties": false
        }
      ],
      "description": "Full structured temporal anchor; overrides date/earliest/latest. Use for relative or narrative time."
    },
    "anchors": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Reference instants for a `relative` when: { anchorId: UTC ISO }"
    },
    "calendars": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "additionalProperties": {
          "type": "string"
        }
      },
      "description": "Calendar lookups for a `narrative` when: { calendarName: { value: UTC ISO } }. The caller owns the mapping (a regnal year, a story epoch, a game calendar) — the engine resolves through it, never invents it"
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "place": {
      "type": "string",
      "description": "Named place, e.g. \"Paris\" or \"Springfield, US\" — resolved to a city centroid via the bundled gazetteer (GeoNames) when lat/lon are not given. Resolution is approximate by construction and reported as such"
    },
    "where": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "geo"
            },
            "lat": {
              "$ref": "#/properties/lat"
            },
            "lonEast": {
              "$ref": "#/properties/lon"
            },
            "altM": {
              "type": "number"
            }
          },
          "required": [
            "kind",
            "lat",
            "lonEast"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "named"
            },
            "placeId": {
              "type": "string"
            }
          },
          "required": [
            "kind",
            "placeId"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "region"
            },
            "lat": {
              "$ref": "#/properties/lat"
            },
            "lonEast": {
              "$ref": "#/properties/lon"
            },
            "radiusKm": {
              "type": "number",
              "exclusiveMinimum": 0
            }
          },
          "required": [
            "kind",
            "lat",
            "lonEast",
            "radiusKm"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "fictional"
            },
            "value": {
              "type": "string"
            }
          },
          "required": [
            "kind",
            "value"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "relative"
            },
            "relation": {
              "type": "string",
              "enum": [
                "near",
                "at"
              ]
            },
            "anchorId": {
              "type": "string"
            }
          },
          "required": [
            "kind",
            "relation",
            "anchorId"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "kind": {
              "type": "string",
              "const": "none"
            },
            "reason": {
              "type": "string",
              "enum": [
                "heliocentric",
                "atemporal",
                "intentionally_unset"
              ]
            }
          },
          "required": [
            "kind",
            "reason"
          ],
          "additionalProperties": false
        }
      ],
      "description": "Full structured spatial anchor; overrides lat/lon and place. `fictional` carries the narrative value only — a fictional place never resolves to coordinates (the chart reads on the planetary layer, houseless), by design"
    },
    "realm": {
      "type": "string",
      "enum": [
        "observed",
        "reported",
        "planned",
        "forecast",
        "fictional",
        "mythic",
        "counterfactual",
        "archetypal",
        "conceptual"
      ],
      "default": "observed",
      "description": "What the chart is; frames the interpretation (default observed)"
    },
    "constraints": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "aspect"
              },
              "a": {
                "type": "string"
              },
              "b": {
                "type": "string"
              },
              "angle": {
                "type": "number"
              },
              "weight": {
                "type": "number"
              }
            },
            "required": [
              "kind",
              "a",
              "b",
              "angle"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "sign"
              },
              "body": {
                "type": "string"
              },
              "sign": {
                "type": "integer",
                "minimum": 0,
                "maximum": 11
              },
              "weight": {
                "type": "number"
              }
            },
            "required": [
              "kind",
              "body",
              "sign"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "degree"
              },
              "body": {
                "type": "string"
              },
              "degree": {
                "type": "number"
              },
              "weight": {
                "type": "number"
              }
            },
            "required": [
              "kind",
              "body",
              "degree"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "declination"
              },
              "body": {
                "type": "string"
              },
              "degree": {
                "type": "number",
                "minimum": -90,
                "maximum": 90
              },
              "weight": {
                "type": "number"
              }
            },
            "required": [
              "kind",
              "body",
              "degree"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "parallel"
              },
              "a": {
                "type": "string"
              },
              "b": {
                "type": "string"
              },
              "contra": {
                "type": "boolean"
              },
              "weight": {
                "type": "number"
              }
            },
            "required": [
              "kind",
              "a",
              "b"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "const": "separation3d"
              },
              "a": {
                "type": "string"
              },
              "b": {
                "type": "string"
              },
              "angle": {
                "type": "number",
                "minimum": 0,
                "maximum": 180
              },
              "weight": {
                "type": "number"
              }
            },
            "required": [
              "kind",
              "a",
              "b",
              "angle"
            ],
            "additionalProperties": false
          }
        ]
      },
      "description": "Geometric constraints for an archetypal/conceptual chart with no time (compiler synthesis). Longitude kinds (aspect/sign/degree) plus the latitude-aware kinds: declination (via the fixed J2000 obliquity), parallel/contraparallel of declination, and separation3d (true great-circle separation)"
    },
    "house_system": {
      "type": "string",
      "default": "placidus",
      "description": "House system (default placidus). Case- and spacing-insensitive; valid: placidus, whole_sign, equal, porphyry, koch, regiomontanus, campanus, alcabitius, morinus, meridian, polich_page, vehlow (aliases like \"whole sign\" also work)."
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    },
    "target_date": {
      "type": "string",
      "description": "UTC ISO instant for transits and time-lords vs this natal chart; omit for natal-only facts"
    },
    "include_vedic": {
      "type": "boolean",
      "description": "With target_date: project nakshatra/varga/yoga (default true when zodiac is sidereal)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "default": 24,
      "description": "max facts to return, highest salience first (default 24)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC date-time, ISO 8601, e.g. 1990-06-10T14:30:00Z. Convert local birth time to UTC first."
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude, north positive"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude, EAST positive (Americas are negative)"
    },
    "shift_time": {
      "type": "string",
      "description": "Duration to shift the instant: '1h', '-30m', 'P1Y'"
    },
    "move_lat": {
      "$ref": "#/properties/lat",
      "description": "Recompute at this latitude instead of the birth latitude"
    },
    "move_lon": {
      "$ref": "#/properties/lon",
      "description": "Recompute at this longitude instead of the birth longitude"
    },
    "set_longitudes": {
      "type": "object",
      "additionalProperties": {
        "type": "number"
      },
      "description": "Move bodies to these ecliptic longitudes in degrees, e.g. { \"mars\": 45 }"
    },
    "house_system": {
      "type": "string",
      "default": "placidus",
      "description": "House system (default placidus). Case- and spacing-insensitive; valid: placidus, whole_sign, equal, porphyry, koch, regiomontanus, campanus, alcabitius, morinus, meridian, polich_page, vehlow (aliases like \"whole sign\" also work)."
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "required": [
    "date",
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "reference_date": {
      "type": "string",
      "description": "UTC ISO date whose sky is the target to match"
    },
    "start": {
      "type": "string",
      "description": "UTC ISO start of the search window"
    },
    "end": {
      "type": "string",
      "description": "UTC ISO end of the search window"
    },
    "step_days": {
      "type": "number",
      "exclusiveMinimum": 0,
      "default": 1,
      "description": "sampling step in days (default 1)"
    },
    "limit": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "default": 10,
      "description": "max matches to return (default 10)"
    }
  },
  "required": [
    "reference_date",
    "start",
    "end"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "start": {
      "type": "string",
      "description": "UTC ISO start of the window"
    },
    "end": {
      "type": "string",
      "description": "UTC ISO end of the window"
    },
    "wanted": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "a": {
            "type": "string",
            "description": "first body, snake_case"
          },
          "b": {
            "type": "string",
            "description": "second body, snake_case"
          },
          "aspect": {
            "type": "string",
            "enum": [
              "conjunction",
              "sextile",
              "square",
              "trine",
              "opposition"
            ]
          }
        },
        "required": [
          "a",
          "b",
          "aspect"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "description": "aspects to reward when close to exact"
    },
    "step_hours": {
      "type": "number",
      "exclusiveMinimum": 0,
      "default": 6,
      "description": "sampling step in hours (default 6)"
    },
    "avoid_void_moon": {
      "type": "boolean",
      "default": false,
      "description": "penalize a void-of-course Moon"
    },
    "limit": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "default": 10,
      "description": "max moments to return (default 10)"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "required": [
    "start",
    "end",
    "wanted"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC ISO date"
    },
    "window_days": {
      "type": "number",
      "exclusiveMinimum": 0,
      "default": 7,
      "description": "days either side to scan for stations (default 7)"
    },
    "zodiac": {
      "type": "string",
      "enum": [
        "tropical",
        "sidereal:lahiri",
        "sidereal:fagan_bradley",
        "sidereal:krishnamurti",
        "sidereal:raman",
        "sidereal:yukteshwar",
        "sidereal:galcent_0sag",
        "sidereal:true_citra"
      ],
      "default": "tropical",
      "description": "tropical (default) or sidereal:<ayanamsa>"
    }
  },
  "required": [
    "date"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}