Jyotisha/docs/superpowers/plans/2026-07-16-rangacharya-phase2-source-cards.md

Rangacharya Phase 2 Source Cards Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Add formula-level source cards and wire Rangacharya runtime to them, so no screenshot/archive rule can be silently promoted into calculation or adjudication.

Architecture: Keep references/rangacharya_source_manifest.json as source inventory. Add references/rangacharya_source_cards.json as formula inventory. scripts/rangacharya.py loads cards and attaches card/status/blocker metadata to every experimental output.

Tech Stack: Python 3 stdlib JSON, existing scripts/rangacharya.py, pytest.

Tasks

Task 1: Source Card Tests

Files:

• Create tests/test_rangacharya_source_cards.py

• Create references/rangacharya_source_cards.json

• Write tests requiring schema, no secrets, no adjudication, and card ids for Phase 2 rule groups.

• Run tests and verify missing-card failure.

• Add minimal cards for core Arudha, Active/Effective Lagna, Sanmukha/Prakriti, special mappings, named yogas, UL family rules, and future article tracks.

• Run tests and verify pass.

Task 2: Runtime Card Loader

Files:

• Modify scripts/rangacharya.py

• Modify tests/test_rangacharya_variant.py

• Write tests requiring outputs to include source_card_id, source_card_status, and blocked_reason when not verified.

• Implement JSON loader with safe fallback.

• Attach card metadata to AL/A7/A10/UL, active lagna, and effective lagna.

• Run focused tests.

Task 3: Planning Sync And Verification

Files:

• Modify .planning/rangacharya_vedastro_design_20260716/task_plan.md

• Modify .planning/rangacharya_vedastro_design_20260716/progress.md

• Record Phase 2 source-card completion.

• Run focused Rangacharya tests.

• Run mandatory pre-work check.

• Run secret scan.