Activity Provenance States
Every Muhurtam activity has exactly one machine-readable provenance disposition. The disposition describes the authority of the activity-specific profile; it does not certify the astronomical engine or shared scoring layers.
| Rule field | Required ledger state | Meaning |
|---|---|---|
source_claim | verified | Implemented activity criteria match the precisely located source within the recorded scope |
audit_claim | contradicted | An inspected source exposes a rule or taxonomy conflict that remains visible pending an approval-gated correction |
heuristic_claim | heuristic | The behavior is intentionally project-defined or source-neutral and makes no claim of classical authority |
The fields are mutually exclusive. tools/check_activity_provenance.py fails for unknown claims, wrong surfaces, wrong states, duplicate claims or an activity with no disposition. tools/export_activity_rules.py carries the same field into the browser contract, while tool_find_muhurta returns it in activity_profile for MCP consumers. When a source-backed activity has a narrower meaning than its compatibility identifier, the optional source_scope field is exported on both surfaces so consumers do not silently broaden the claim.
The neutral any selector
Anything auspicious is the sole heuristic activity profile. It contributes no activity-specific admission rule or scoring preference. It is useful for exploring shared day and slot calculations, but it is not a classical election for an unspecified act. Once the user's purpose is known, the corresponding purpose-specific activity profile takes precedence.
Adding an activity
- Give the activity exactly one of the three claim fields.
- Add the corresponding ledger entry with scope, implementation and review metadata.
- For
source_claim, record an inspected edition and exact locator. - Export the browser rules and test both browser and MCP disclosure.
- Run
python tools/check_activity_provenance.pyand the full project verifier before review.