Nitya Yoga disposition

personal.nitya-yoga-disposition

Each of the 27 Nitya Yogas is classified for slot scoring and partial-window cautions.

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

Classify the active Nitya Yoga, then apply a hard defer, fixed score, or time-bounded penalty according to the candidate slot and activity policy.

Process

1. Map Vyatipata and Vaidhriti to hard-avoid.
2. Map six named Yogas to partial-avoid windows of 3, 5, 6, or 9 fixed 24-minute Ghatis from Yoga start.
3. Map seventeen named Yogas to auspicious and Vajra/Variyan or unknown values to neutral.
4. For a hard-avoid Yoga, defer when the activity enables samskara skips or otherwise score -2.
5. For a partial Yoga, score -1 only when slot start is within its configured window; score auspicious +1 and neutral 0.

Worked example

Shobhana at a candidate slot

Inputs

• Active Nitya Yoga: Shobhana

Calculation

1. Shobhana is in NITYA_AUSPICIOUS.
2. Apply the auspicious slot adjustment.

Result

• Disposition: auspicious
• Score adjustment: +1
• Defer: false

Method notes

• Partial windows use fixed civil minutes in current code; they do not use the proportional Ghati clock documented on the Ghati page.

Contract

Owning layer: personal
Claim kind: textual-rule
Time basis: Active Yoga and candidate slot instant.

Inputs

• Nitya Yoga name
• slot start
• Yoga span

Outputs

• disposition
• score adjustment
• hard/partial caution

References and evidence

Evidence classes: textual
Verification states: needs_locator

Disposition and partial-window behavior are tested; exact claim locators remain open.

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_muhurta_finder.py

Run the linked tests, then the complete offline contract:

python tools/verify_project.py

Public surfaces

• python-library
• mcp
• website

Limitations

• Disposition is one input to Muhurta ranking, not a standalone election verdict; partial-dosha windows currently use a fixed 24 civil minutes per Ghati rather than the proportional sunrise-to-sunrise Ghati clock.

Implementation

• owner: telugu_panchangam/personal/nitya_yoga.py — nitya_disposition
• owner: telugu_panchangam/personal/slot_scorers.py — score_nitya_yoga

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