astroapi-io-client 0.2.6__tar.gz → 0.2.7__tar.gz

{astroapi_io_client-0.2.6 → astroapi_io_client-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astroapi-io-client
-Version: 0.2.6
+Version: 0.2.7
 Summary: Synchronous Python client for the AstroAPI.io calculation gateway
 License-Expression: ISC
 Classifier: Programming Language :: Python :: 3
@@ -14,13 +14,13 @@ Dynamic: license-file
 
 # AstroAPI.io Python client
 
-The R198 client `astroapi-io-client==0.2.6` covers all forty-six calculation routes: forty-five standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
+The R199 source client `astroapi-io-client==0.2.7` covers all forty-seven calculation routes: forty-six standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
 
 A synchronous client for Python 3.10+, with no runtime dependencies.
 The package import is `astroapi_client`; the distribution name is
-`astroapi-io-client`. Version 0.2.6 is the current published R198 client; package availability never implies that source-only R198 API capabilities are deployed.
+`astroapi-io-client`. Version 0.2.7 is the R199 client; package availability never implies that source-only R199 API capabilities are deployed.
 
-Install from PyPI with `python -m pip install astroapi-io-client==0.2.6`, or from a local checkout using `python -m pip install ./clients/python`.
+Install from PyPI with `python -m pip install astroapi-io-client==0.2.7`, or install the current source from a local checkout using `python -m pip install ./clients/python`.
 Building needs setuptools and wheel; the installed client uses only the standard
 library. Keep API credentials in trusted server or command-line environments.
 
@@ -99,6 +99,7 @@ Type hints describe the server contract and do not perform response validation.
 | `civil_time_audit` **beta** | `calculateCivilTimeAudit` | pinned place, local date/time, one explicit profile | both repeated-time chart candidates and exact 22-fact differences, or no shifted gap time |
 | `chart_input_readiness` **beta** | `calculateChartInputReadiness` | pinned place, exact/approximate/unknown time quality, explicit profile | route readiness plus resolved, candidate, or sampled evidence for 22 facts |
 | `house_system_readiness` **beta** | `calculateHouseSystemReadiness` | exact birth and explicit tropical/sidereal profile | fixed 25-system availability matrix with fingerprints and no fallback |
+| `house_placement_stability` **beta** | `calculateHousePlacementStability` | exact birth and explicit tropical/sidereal profile | exact assignments, unweighted agreement ratios, and deterministic equivalence groups across available 12-house systems |
 | `synastry_svg` **beta** | `calculateSynastrySvg` | two births; optional zodiac/houses/theme/aspects/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `transit_svg` **beta** | `calculateTransitSvg` | birth and transit date; optional display controls/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `natal_report` **beta** | `calculateNatalReport` | birth; optional zodiac/houses/theme/SVG/download | `result["html"]`, source-linked `result["facts"]`, optional `result["download"]` |

{astroapi_io_client-0.2.6 → astroapi_io_client-0.2.7}/README.md

@@ -1,12 +1,12 @@
 # AstroAPI.io Python client
 
-The R198 client `astroapi-io-client==0.2.6` covers all forty-six calculation routes: forty-five standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
+The R199 source client `astroapi-io-client==0.2.7` covers all forty-seven calculation routes: forty-six standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
 
 A synchronous client for Python 3.10+, with no runtime dependencies.
 The package import is `astroapi_client`; the distribution name is
-`astroapi-io-client`. Version 0.2.6 is the current published R198 client; package availability never implies that source-only R198 API capabilities are deployed.
+`astroapi-io-client`. Version 0.2.7 is the R199 client; package availability never implies that source-only R199 API capabilities are deployed.
 
-Install from PyPI with `python -m pip install astroapi-io-client==0.2.6`, or from a local checkout using `python -m pip install ./clients/python`.
+Install from PyPI with `python -m pip install astroapi-io-client==0.2.7`, or install the current source from a local checkout using `python -m pip install ./clients/python`.
 Building needs setuptools and wheel; the installed client uses only the standard
 library. Keep API credentials in trusted server or command-line environments.
 
@@ -85,6 +85,7 @@ Type hints describe the server contract and do not perform response validation.
 | `civil_time_audit` **beta** | `calculateCivilTimeAudit` | pinned place, local date/time, one explicit profile | both repeated-time chart candidates and exact 22-fact differences, or no shifted gap time |
 | `chart_input_readiness` **beta** | `calculateChartInputReadiness` | pinned place, exact/approximate/unknown time quality, explicit profile | route readiness plus resolved, candidate, or sampled evidence for 22 facts |
 | `house_system_readiness` **beta** | `calculateHouseSystemReadiness` | exact birth and explicit tropical/sidereal profile | fixed 25-system availability matrix with fingerprints and no fallback |
+| `house_placement_stability` **beta** | `calculateHousePlacementStability` | exact birth and explicit tropical/sidereal profile | exact assignments, unweighted agreement ratios, and deterministic equivalence groups across available 12-house systems |
 | `synastry_svg` **beta** | `calculateSynastrySvg` | two births; optional zodiac/houses/theme/aspects/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `transit_svg` **beta** | `calculateTransitSvg` | birth and transit date; optional display controls/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `natal_report` **beta** | `calculateNatalReport` | birth; optional zodiac/houses/theme/SVG/download | `result["html"]`, source-linked `result["facts"]`, optional `result["download"]` |

{astroapi_io_client-0.2.6 → astroapi_io_client-0.2.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "astroapi-io-client"
-version = "0.2.6"
+version = "0.2.7"
 description = "Synchronous Python client for the AstroAPI.io calculation gateway"
 readme = "README.md"
 license = "ISC"

{astroapi_io_client-0.2.6 → astroapi_io_client-0.2.7}/src/astroapi_client/__init__.py

@@ -17,7 +17,7 @@ from .types import (
     GeographicLocation, RelocationChartInput, AstrocartographyBody, AstrocartographyInput,
     EclipseType, EclipseGeometryInput, EclipseObserverSnapshot, EclipseEvent, EclipseGeometryResponse, MoonPhaseSector, ElectionalAspectFilter,
     ElectionalFilters, ElectionalSearchInput,
-    EventRule, EventRuleSearchInput, ConventionProfile, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput, CivilTimeAuditInput, ChartInputReadinessExactTime, ChartInputReadinessApproximateTime, ChartInputReadinessUnknownTime, ChartInputReadinessBirthTime, ChartInputReadinessInput,
+    EventRule, EventRuleSearchInput, ConventionProfile, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput, CivilTimeAuditInput, ChartInputReadinessExactTime, ChartInputReadinessApproximateTime, ChartInputReadinessUnknownTime, ChartInputReadinessBirthTime, ChartInputReadinessInput, HouseSystemReadinessInput, HousePlacementStabilityInput,
     NatalAnalysisAspectName, NatalAnalysisAspectOption, NatalAnalysisInput,
     AshtakootaInput, AshtakavargaInput, NumerologyInput, PlanetaryHoursInput,
     FixedStar, FixedStarsInput,
@@ -30,7 +30,7 @@ from .types import (
     PlaceSearchInput, TimezoneResolveInput, NatalContextInput,
 )
 
-__version__ = "0.2.6"
+__version__ = "0.2.7"
 __all__ = [
     "NumerologyInput", "verify_calculation_receipt",
     "AstroAPIClient", "AstroAPIError", "ClientBusyError", "HTTPError", "DavisonInput",
@@ -45,7 +45,7 @@ __all__ = [
     "GeographicLocation", "RelocationChartInput", "AstrocartographyBody", "AstrocartographyInput",
     "EclipseType", "EclipseGeometryInput", "EclipseObserverSnapshot", "EclipseEvent", "EclipseGeometryResponse", "MoonPhaseSector", "ElectionalAspectFilter",
     "ElectionalFilters", "ElectionalSearchInput",
-    "EventRule", "EventRuleSearchInput", "ConventionProfile", "ConventionCompareInput", "ReleaseCompareInput", "ChartRobustnessInput", "CivilTimeAuditInput", "ChartInputReadinessExactTime", "ChartInputReadinessApproximateTime", "ChartInputReadinessUnknownTime", "ChartInputReadinessBirthTime", "ChartInputReadinessInput",
+    "EventRule", "EventRuleSearchInput", "ConventionProfile", "ConventionCompareInput", "ReleaseCompareInput", "ChartRobustnessInput", "CivilTimeAuditInput", "ChartInputReadinessExactTime", "ChartInputReadinessApproximateTime", "ChartInputReadinessUnknownTime", "ChartInputReadinessBirthTime", "ChartInputReadinessInput", "HouseSystemReadinessInput", "HousePlacementStabilityInput",
     "NatalAnalysisAspectName", "NatalAnalysisAspectOption", "NatalAnalysisInput",
     "AshtakootaInput", "AshtakavargaInput", "PlanetaryHoursInput",
     "FixedStar", "FixedStarsInput",

{astroapi_io_client-0.2.6 → astroapi_io_client-0.2.7}/src/astroapi_client/_validation.py

@@ -702,7 +702,7 @@ def encode_request(route: str, payload: Any) -> bytes:
             _invalid("tropical profiles cannot include ayanamsa.")
         if profile["zodiac"] == "sidereal" and ("ayanamsa" not in profile or profile["ayanamsa"] not in _AYANAMSAS):
             _invalid("sidereal profiles require a supported ayanamsa.")
-    elif route == "house-system-readiness":
+    elif route in {"house-system-readiness", "house-placement-stability"}:
         _object(data, {"birth", "profile"}, {"birth", "profile"})
         birth = _object(data["birth"], {"date", "time", "timezone", "lat", "lon"}, {"date", "time", "timezone", "lat", "lon"})
         _birth(birth)

{astroapi_io_client-0.2.6 → astroapi_io_client-0.2.7}/src/astroapi_client/client.py

@@ -32,7 +32,7 @@ from .types import (
     MoonPhaseInput, MoonPhaseResponse, DavisonInput, PlanetaryEventsInput, PlanetaryEventsResponse,
     HouseIngressesInput, HouseIngressesResponse,
     AspectWindowsInput, AspectWindowsResponse,
-    EventRuleSearchInput, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput, CivilTimeAuditInput, ChartInputReadinessInput, HouseSystemReadinessInput,
+    EventRuleSearchInput, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput, CivilTimeAuditInput, ChartInputReadinessInput, HouseSystemReadinessInput, HousePlacementStabilityInput,
     EventCalendarInput, SynastrySvgInput, TransitSvgInput, NatalReportInput,
     BirthTimeSensitivityInput, RelocationChartInput, AstrocartographyInput,
     PlaceSearchInput, TimezoneResolveInput, NatalContextInput,
@@ -181,7 +181,7 @@ def _perform(
             "Content-Type": "application/json",
             "Accept": "application/json",
             "Accept-Encoding": "identity",
-            "User-Agent": "astroapi-io-client/0.2.6",
+            "User-Agent": "astroapi-io-client/0.2.7",
             "Connection": "close",
             **({"X-AstroAPI-Receipt": "v1"} if request_receipt else {}),
         })
@@ -285,7 +285,7 @@ class AstroAPIClient:
 
     def _request(self, route: str, payload: object) -> JSONResponse:
         body = encode_request(route, payload)
-        timeout = (self._timeline_timeout if route in {"nakshatra-timeline", "birth-time-sensitivity", "chart-robustness", "chart-input-readiness", "house-system-readiness"}
+        timeout = (self._timeline_timeout if route in {"nakshatra-timeline", "birth-time-sensitivity", "chart-robustness", "chart-input-readiness", "house-system-readiness", "house-placement-stability"}
                    else self._planetary_events_timeout if route in {"planetary-events", "house-ingresses", "eclipse-geometry", "electional-search", "event-rule-search"}
                    else self._aspect_windows_timeout if route == "aspect-windows"
                    else self._timeout)
@@ -440,6 +440,10 @@ class AstroAPIClient:
         """BETA: preflight the fixed 25-system inventory without fallback."""
         return self._request("house-system-readiness", payload)
 
+    def house_placement_stability(self, payload: HousePlacementStabilityInput) -> JSONResponse:
+        """BETA: quantify unweighted planet-house stability across comparable systems."""
+        return self._request("house-placement-stability", payload)
+
     def synastry_svg(self, payload: SynastrySvgInput) -> JSONResponse:
         """BETA: original deterministic double-wheel relationship SVG."""
         return self._request("synastry-svg", payload)

{astroapi_io_client-0.2.6 → astroapi_io_client-0.2.7}/src/astroapi_client/types.py

@@ -419,6 +419,9 @@ class HouseSystemReadinessInput(TypedDict):
     profile: HouseSystemReadinessProfile
 
 
+HousePlacementStabilityInput = HouseSystemReadinessInput
+
+
 class ReleaseCompareInput(TypedDict):
     releases: list[JSONResponse]
 

{astroapi_io_client-0.2.6 → astroapi_io_client-0.2.7}/src/astroapi_io_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astroapi-io-client
-Version: 0.2.6
+Version: 0.2.7
 Summary: Synchronous Python client for the AstroAPI.io calculation gateway
 License-Expression: ISC
 Classifier: Programming Language :: Python :: 3
@@ -14,13 +14,13 @@ Dynamic: license-file
 
 # AstroAPI.io Python client
 
-The R198 client `astroapi-io-client==0.2.6` covers all forty-six calculation routes: forty-five standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
+The R199 source client `astroapi-io-client==0.2.7` covers all forty-seven calculation routes: forty-six standard operations plus the separate Pro Nakshatra Timeline. Minor-body calculations are not part of the contract.
 
 A synchronous client for Python 3.10+, with no runtime dependencies.
 The package import is `astroapi_client`; the distribution name is
-`astroapi-io-client`. Version 0.2.6 is the current published R198 client; package availability never implies that source-only R198 API capabilities are deployed.
+`astroapi-io-client`. Version 0.2.7 is the R199 client; package availability never implies that source-only R199 API capabilities are deployed.
 
-Install from PyPI with `python -m pip install astroapi-io-client==0.2.6`, or from a local checkout using `python -m pip install ./clients/python`.
+Install from PyPI with `python -m pip install astroapi-io-client==0.2.7`, or install the current source from a local checkout using `python -m pip install ./clients/python`.
 Building needs setuptools and wheel; the installed client uses only the standard
 library. Keep API credentials in trusted server or command-line environments.
 
@@ -99,6 +99,7 @@ Type hints describe the server contract and do not perform response validation.
 | `civil_time_audit` **beta** | `calculateCivilTimeAudit` | pinned place, local date/time, one explicit profile | both repeated-time chart candidates and exact 22-fact differences, or no shifted gap time |
 | `chart_input_readiness` **beta** | `calculateChartInputReadiness` | pinned place, exact/approximate/unknown time quality, explicit profile | route readiness plus resolved, candidate, or sampled evidence for 22 facts |
 | `house_system_readiness` **beta** | `calculateHouseSystemReadiness` | exact birth and explicit tropical/sidereal profile | fixed 25-system availability matrix with fingerprints and no fallback |
+| `house_placement_stability` **beta** | `calculateHousePlacementStability` | exact birth and explicit tropical/sidereal profile | exact assignments, unweighted agreement ratios, and deterministic equivalence groups across available 12-house systems |
 | `synastry_svg` **beta** | `calculateSynastrySvg` | two births; optional zodiac/houses/theme/aspects/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `transit_svg` **beta** | `calculateTransitSvg` | birth and transit date; optional display controls/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `natal_report` **beta** | `calculateNatalReport` | birth; optional zodiac/houses/theme/SVG/download | `result["html"]`, source-linked `result["facts"]`, optional `result["download"]` |

{astroapi_io_client-0.2.6 → astroapi_io_client-0.2.7}/tests/test_client.py

@@ -65,6 +65,7 @@ CONVENTION_INPUT = {"birth": BIRTH, "profiles": [{"zodiac": "tropical", "house_s
 CIVIL_TIME_AUDIT_INPUT = {"place_id": "geonames:5128581:2026-10-02", "date": "2024-11-03", "time": "01:30", "profile": {"zodiac": "tropical", "house_system": "equal"}}
 CHART_INPUT_READINESS_INPUT = {"place_id": "geonames:5128581:2026-10-02", "birth_time": {"status": "exact", "date": "2024-11-03", "time": "01:30"}, "profile": {"zodiac": "tropical", "house_system": "equal"}}
 HOUSE_SYSTEM_READINESS_INPUT = {"birth": BIRTH, "profile": {"zodiac": "tropical"}}
+HOUSE_PLACEMENT_STABILITY_INPUT = HOUSE_SYSTEM_READINESS_INPUT
 CHART_ROBUSTNESS_INPUT = {"birth_time": {"status": "approximate", "date": "2000-01-01", "time": "12:00", "timezone": "UTC", "uncertainty_minutes": 30}, "lat": 0, "lon": 0, "profiles": [{"zodiac": "tropical", "house_system": "equal"}, {"zodiac": "sidereal", "ayanamsa": "lahiri", "house_system": "whole_sign"}]}
 ROUTES += [
     ("event_rule_search", "event-rule-search", RULE_INPUT, {"type": "event_rule_search", "status": "beta", "rule_analysis": {}, "matching_samples": [], "sampled_candidate_windows": [], "metadata": {}}),
@@ -73,6 +74,7 @@ ROUTES += [
     ("civil_time_audit", "civil-time-audit", CIVIL_TIME_AUDIT_INPUT, {"type": "civil_time_audit", "status": "beta", "resolution": {}, "profile": {}, "calculation_ready": False, "requires_selection": True, "candidates": [], "comparison": {}, "metadata": {}}),
     ("chart_input_readiness", "chart-input-readiness", CHART_INPUT_READINESS_INPUT, {"type": "chart_input_readiness", "status": "beta", "birth_time_status": "exact", "profile": {}, "resolution": {}, "exact_chart_ready": False, "next_action": "select_civil_time_candidate", "workflows": [{}, {}, {}, {}], "fact_evidence": [], "summary": {}, "evidence": {}, "metadata": {}}),
     ("house_system_readiness", "house-system-readiness", HOUSE_SYSTEM_READINESS_INPUT, {"type": "house_system_readiness", "status": "beta", "input": BIRTH, "profile": {}, "systems": [{} for _ in range(25)], "summary": {}, "fallback": {"performed": False, "selected_system": None}, "metadata": {}}),
+    ("house_placement_stability", "house-placement-stability", HOUSE_PLACEMENT_STABILITY_INPUT, {"type": "house_placement_stability", "status": "beta", "input": BIRTH, "profile": {}, "systems": [{} for _ in range(25)], "planets": [{} for _ in range(10)], "placement_groups": [], "summary": {}, "fallback": {"performed": False, "selected_system": None}, "metadata": {}}),
 ]
 
 @contextmanager
@@ -158,6 +160,7 @@ CONVENTION_INPUT = {"birth": BIRTH, "profiles": [{"zodiac": "tropical", "house_s
 CIVIL_TIME_AUDIT_INPUT = {"place_id": "geonames:5128581:2026-10-02", "date": "2024-11-03", "time": "01:30", "profile": {"zodiac": "tropical", "house_system": "equal"}}
 CHART_INPUT_READINESS_INPUT = {"place_id": "geonames:5128581:2026-10-02", "birth_time": {"status": "exact", "date": "2024-11-03", "time": "01:30"}, "profile": {"zodiac": "tropical", "house_system": "equal"}}
 HOUSE_SYSTEM_READINESS_INPUT = {"birth": BIRTH, "profile": {"zodiac": "tropical"}}
+HOUSE_PLACEMENT_STABILITY_INPUT = HOUSE_SYSTEM_READINESS_INPUT
 CHART_ROBUSTNESS_INPUT = {"birth_time": {"status": "approximate", "date": "2000-01-01", "time": "12:00", "timezone": "UTC", "uncertainty_minutes": 30}, "lat": 0, "lon": 0, "profiles": [{"zodiac": "tropical", "house_system": "equal"}, {"zodiac": "sidereal", "ayanamsa": "lahiri", "house_system": "whole_sign"}]}
 ROUTES += [
     ("event_rule_search", "event-rule-search", RULE_INPUT, {"type": "event_rule_search", "status": "beta", "rule_analysis": {}, "matching_samples": [], "sampled_candidate_windows": [], "metadata": {}}),
@@ -166,6 +169,7 @@ ROUTES += [
     ("civil_time_audit", "civil-time-audit", CIVIL_TIME_AUDIT_INPUT, {"type": "civil_time_audit", "status": "beta", "resolution": {}, "profile": {}, "calculation_ready": False, "requires_selection": True, "candidates": [], "comparison": {}, "metadata": {}}),
     ("chart_input_readiness", "chart-input-readiness", CHART_INPUT_READINESS_INPUT, {"type": "chart_input_readiness", "status": "beta", "birth_time_status": "exact", "profile": {}, "resolution": {}, "exact_chart_ready": False, "next_action": "select_civil_time_candidate", "workflows": [{}, {}, {}, {}], "fact_evidence": [], "summary": {}, "evidence": {}, "metadata": {}}),
     ("house_system_readiness", "house-system-readiness", HOUSE_SYSTEM_READINESS_INPUT, {"type": "house_system_readiness", "status": "beta", "input": BIRTH, "profile": {}, "systems": [{} for _ in range(25)], "summary": {}, "fallback": {"performed": False, "selected_system": None}, "metadata": {}}),
+    ("house_placement_stability", "house-placement-stability", HOUSE_PLACEMENT_STABILITY_INPUT, {"type": "house_placement_stability", "status": "beta", "input": BIRTH, "profile": {}, "systems": [{} for _ in range(25)], "planets": [{} for _ in range(10)], "placement_groups": [], "summary": {}, "fallback": {"performed": False, "selected_system": None}, "metadata": {}}),
 ]
 
 @contextmanager