Jyotisha/docs/superpowers/plans/2026-07-01-monthly-adjudication-structure.md

Monthly Adjudication Structure Implementation Plan

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

Goal: Replace the old month-facing "opportunity / pressure" simplification with a route-aware monthly adjudication structure for career, relationship, and finance that reuses existing strict workflow evidence.

Architecture: Reuse mcp_server.py strict workflow evidence as the single source, derive a lightweight monthly_adjudication_summary from existing promise/activation/manifestation layers plus VedAstro official day signals, then surface it through prompt-pack, guided topics, AI chat context, and frontend cards. Keep official_day_signal_summary as a compatibility layer during the transition.

Tech Stack: Python, existing strict workflow builders, pytest, current guided-topic/frontend consumers.

Global Constraints

• Reuse current strict workflow collectors before adding new collectors.
• Reuse current event_judgement, adjudication_stages, and official_day_signal_summary outputs.
• Do not add new heavy VedAstro calls for this task.
• Keep Functional Benefic/Malefic, relevant vargas, and Vimshottari + Narayana hard gates visible.
• Preserve blocked, conflicts, and confidence_cap honesty boundaries.

---

Task 1: Define and test the new contract

• Add failing backend tests for monthly_adjudication_summary in career/relationship/finance strict workflow tests.
• Add failing guided-topic and frontend tests asserting the new field is carried and displayed.

Task 2: Implement route-aware monthly adjudication

• Add helper builders in <repo>/mcp_server.py.
• Attach monthly_adjudication_summary to strict workflow contracts.
• Keep official_day_signal_summary unchanged for compatibility.

Task 3: Surface the contract through consumers

• Add monthly_adjudication_summary to compact prompt-pack contracts in <repo>/scripts/jyotish_engine.py.
• Add it to guided topics in <repo>/scripts/guided_topic_discovery.py.
• Expose it in <repo>/jyotish-app/main.js and <repo>/jyotish-app/ai-chat.js.

Task 4: Verify targeted regressions

• Run the strict workflow tests for career/relationship/finance.
• Run the guided-topic smoke test.
• Run the targeted frontend productization assertions.