Nakshatra Mukha direction

derived.nakshatra-mukha

Nakshatras are classified as Adho, Urdhva, or Tiryan Mukha.

Assurance

Level	Current statement
Documented and traceable	Yes — the canonical record includes the process and a worked example.
Regression or reproduction checked	Linked to 1 repository test file(s).
Independently source-supported	Not recorded as independently verified. The disclosed provenance state remains authoritative.

Computation method

Method type: decision-table

Look up the active Nakshatra in the maintained Adho, Urdhva, and Tiryan Mukha classification table.

Process

1. Use the canonical engine spelling as the key.
2. Return the exact NAKSHATRA_MUKHA table value.
3. Return null for missing or unrecognized input.

Worked example

Revati classification

Inputs

• Nakshatra: Revati

Calculation

1. NAKSHATRA_MUKHA[Revati] = Tiryan.

Result

• Mukha: Tiryan

Method notes

• Activity code interprets the direction; this function does not grade the day by itself.

Contract

Owning layer: derived
Claim kind: textual-rule
Time basis: Active Nakshatra at the evaluated day or slot.

Inputs

• Nakshatra name

Outputs

• Mukha direction or null

References and evidence

Evidence classes: textual
Verification states: needs_locator

Classification behavior is tested; exact source locators remain incomplete.

panchangam.derived_classifications

Evidence class: textual
Verification state: needs_locator
Locator: No precise locator is registered.

Scope: Special Yogas, Panchaka labels, Khara month, Pitru Paksha, Simha-Stha, Maudhya, Anandadi Yoga, Disha Shoola, Nakshatra Mukha and Panchaka Rahita are separate traditional classifications. The group exists to expose evidence debt and grants no umbrella textual authority; each component needs its own inspected rule table and regional boundary.

Sources

• Muhurtha (Electional Astrology) — B. V. Raman; UBS Publishers' Distributors, 1993, ISBN 9788185674681, 181 catalogued pages; authority type: modern_synthesis
• Muhurta Chintamani — Rama Daivajna; Undated Sanskrit text with Hindi commentary, Internet Archive identifier muhurta-chintamani-hindi; authority type: primary_text_hindi_commentary

The complete machine-readable source registry is available in provenance.json. A regression fixture or same-code reproduction is not independent verification.

Reproduce and review

• tests/test_mukha_nakshatra.py

Run the linked tests, then the complete offline contract:

python tools/verify_project.py

Public surfaces

• python-library
• mcp
• website

Limitations

• The direction is an activity input, not a general day-quality score.

Implementation

• owner: telugu_panchangam/nakshatra_filters.py — nakshatra_mukha

This route is generated from computations.json. Edit the registry and canonical reference prose in the same pull request as a behavior change.