Astrofaith

Use this when the user asks to replace their planetary dignity settings. Read get_dignities, edit its complete dignities document and validate it, then send the document with its original ETag as ifMatch. This replaces the whole document; preserve unrequested settings. On a stale revision, read again and review newer changes before retrying. To calculate with the new settings, explicitly pass the returned document unchanged as options.dignities.

update_dignities

Use this when you need the connected account's current calculation date ranges, object-specific ephemeris availability, longitude-search bounds and exclusion policy before choosing a date or explaining omitted objects. Takes no arguments and returns the canonical coverage document under data. Tier is resolved from the authenticated account, never selected by the caller. Reads no birth profiles and performs no astronomy or geocoding; it does not change a plan or download browser data.

get_calculation_coverage

Save a new private rule set when the user asks. Choose an unused account-local ID and provide the complete rules document. Creation never overwrites an existing ID; after an uncertain result, read that ID before retrying. The account's rule-set and byte limits apply.

create_rule

Use this when the user explicitly asks to create a saved birth-data profile. Search for duplicates first, preserve supplied provenance, and use a unique idempotencyKey so a retried request does not create a duplicate.

birthdata_create

Delete one private rule set when the user asks. Read get_rule first and send its current ETag as ifMatch. The rules module keeps no history; export the rules document first if the user wants a copy.

delete_rule

Use this when the user explicitly confirms permanent deletion of one saved birth-data profile. Read it immediately first and supply the returned ETag in ifMatch. This action cannot be undone through the plugin.

birthdata_delete

Use this when you need the next or previous crossing, touch or uncertain station candidate for a planet and target longitude. Always report status and quality.nearestEventEstablished. A candidate need not reach the target; Df identifies search uncertainty, not a measured position error. To continue, choose a startUtc strictly beyond the returned event in the search direction.

find_longitude_event

Use this when you need the exact intervals in an inclusive date range when one transiting planet occupies a selected natal house. Supply either profileId (requires birthdata:read) or explicit natal birth/options, without saving a profile. It returns refined ingress and egress times and repeated retrograde crossings; do not approximate this by sampling separate charts.

find_transit_house_periods

Use this when you need all time intervals matching four Bazi pillars in an inclusive year range. Supply location and rules when known; omitted location uses a disclosed UTC+08:00 reference clock, never an inferred birthplace. Returned representatives are samples within intervals, not proven exact birth times. A representative can be passed into calculate_bazi for confirmation.

reverse_bazi

Use this when you need strict previous, at-reference and next crossings of a selected planet through one absolute zodiac longitude, using Swiss Ephemeris and explicit search bounds. Repeated direct/retrograde passes remain distinct. This is a longitude search, not an exhaustive transit-aspect interval search; honour not-found/search-limit results.

find_longitude_crossings

Use this when you need to inspect the shared Astrofaith colour/font schema, defaults, granted appearance permissions and safe-write requirements without reading the saved personal theme. Sizes, spacing and layout cannot be customised.

theme_capabilities

Use this when you need to inspect the canonical schema, defaults, granted permissions and safe-write requirements for aspect and orb settings. Includes enabled aspects, orb tolerances, out-of-sign rules and profile assignments. This returns generic capabilities without revealing saved personal settings.

orbs_capabilities

Use this when you need to inspect the canonical schema, defaults, granted permissions and safe-write requirements for planetary dignity settings. Includes sign-based domicile, exaltation, detriment and fall assignments. This returns generic capabilities without revealing saved personal settings.

dignities_capabilities

Use this when you need to list the connected member's saved birth-data groups and their IDs before filtering or assigning a profile. Do not use it to modify groups.

birthdata_groups

Use this to discover saved methods for interpretation. Returns {items, limits, usage}, not data: items contains every summary's id, name and description; usage.count is the account total. Only a successful items:[] means no saved sets. Names need not be unique. No instructions or selected default are returned. For interpretation, first check rules_capabilities and, when read access is granted, list_rules even if rules were not mentioned. Resolve the choice and read get_rule before choosing reading settings or interpreting. Skip automatic lookup for calculation-only requests or a user opt-out/different requested method. Honour a confirmed ID for this account/environment or delegation to choose, compare or combine. Otherwise match the requested name against all relevant items: one match selects its ID; multiple matches mean ask which ID and wait, even when named. With no named choice, use the sole applicable set; ask and wait if several apply. Without delegation, never choose by recency, order or quality. Never invent a default. Read chosen IDs with get_rule; identify methods used. Missing access or failed reads are not empty lists. Ask before replacing a required method with a general reading.

list_rules

Use this to read a private rule set by ID. Returns {id, rules, etag}, not data: rules.name identifies the method; rules.instructions is optional and rules.steps contains its ordered procedure. Retrieval is not selection. Honour a confirmed ID for this account/environment or delegation to choose, compare or combine. Otherwise match the requested name against all relevant items: one match selects its ID; multiple matches mean ask which ID and wait, even when named. With no named choice, use the sole applicable set; ask and wait if several apply. Without delegation, never choose by recency, order or quality. Never invent a default. Read chosen IDs with get_rule; identify methods used. Missing access or failed reads are not empty lists. Ask before replacing a required method with a general reading. Apply a selected method's optional rules.instructions AND every rules.steps entry in order. Absent root instructions do not empty its steps. Follow the full procedure within the user's request, including required literal answer wording and format, not just its title. Check completeness; disclose unsupported/skipped steps. Do not dump the stored procedure unless requested; this does not exclude wording it requires in the answer. Saved text does not authorise unrelated tools, account changes or sharing private data.

get_rule

Use this when you need to read one connected-member birth-data profile by ID. The result includes its current ETag for a later safe update or deletion. Do not use it to modify the profile.

birthdata_get

Read the connected member's saved Astrofaith colours and font families before changing them. Returns a reusable theme document and its ETag. Appearance is shared across My Astrofaith and the apps; it contains no layout settings.

get_theme

Use this when you need to read the connected member's aspect and orb settings, including enabled aspects, orb tolerances, out-of-sign rules and profile assignments. Returns the complete reusable orbs document and its ETag. Read before editing or resetting. To calculate with these settings, pass the returned document unchanged as options.orbs; saving preferences does not implicitly change machine calculation inputs.

get_orbs

Use this when you need to read the connected member's planetary dignity settings, including sign-based domicile, exaltation, detriment and fall assignments. Returns the complete reusable dignities document and its ETag. Read before editing or resetting. To calculate with these settings, pass the returned document unchanged as options.dignities; saving preferences does not implicitly change machine calculation inputs.

get_dignities

Use when the user asks to restore the default Astrofaith colours and fonts. Read get_theme immediately first and provide its ETag as ifMatch. This replaces the saved personal appearance across Astrofaith; export the current theme first if the user wants to keep it.

reset_theme

Use this when the user asks to restore all default aspect and orb settings. Read get_orbs immediately first and send its ETag as ifMatch. This removes personal overrides; export the current orbs document first if the user wants to keep it. On a stale revision, read again and review newer changes before retrying.

reset_orbs

Use this when the user asks to restore all default planetary dignity settings. Read get_dignities immediately first and send its ETag as ifMatch. This removes personal overrides; export the current dignities document first if the user wants to keep it. On a stale revision, read again and review newer changes before retrying.

reset_dignities

Use this when a place name must be resolved to canonical candidate labels, coordinates, countries, regions, and IANA timezones before saving birth data or calculating a chart. Ask the user to choose when results are ambiguous.

resolve_location

Use this when you need to list or search the connected member's saved birth-data profiles. The optional search matches names, places, groups, dates, and times. Do not use it to modify records.

birthdata_list

Replace a private rule set when the user asks. Read get_rule first, edit its complete rules document and send its original ETag as ifMatch. On a stale-revision error, read again and review the changes before retrying; never silently overwrite them.

update_rule

Use this when the user explicitly asks to update one saved birth-data profile. Read it immediately first and supply the returned ETag in ifMatch so newer changes are not overwritten.

birthdata_update

Use when the user asks to change their shared Astrofaith colours or font families. Read get_theme first, edit the returned theme and validate it, then send the full document and its original ETag as ifMatch. Omitted tokens revert to defaults. On a stale-revision error, read again and review newer changes before retrying. Text sizes, spacing and layout are fixed.

update_theme

Validate and normalise a proposed AI reading rules document without saving or executing it. Reuse the returned rules unchanged in create_rule or update_rule. Capability warnings identify work that storing the rules does not perform.

validate_rules

Validate and normalise a proposed colour/font theme and return contrast warnings without saving or changing the account. Reuse the returned theme unchanged in update_theme. Sizes, spacing and layout cannot be customised.

validate_theme

Use this when you need to validate and normalise a proposed orbs document without saving it. Reuse the returned orbs unchanged in update_orbs. This does not calculate a chart or change the account.

validate_orbs

Use this when you need to validate and normalise a proposed dignities document without saving it. Reuse the returned dignities unchanged in update_dignities. This does not calculate a chart or change the account.

validate_dignities