Add VedAstro parity matrix

This commit is contained in:
732642856
2026-06-28 16:33:32 +08:00
parent 5b49967f65
commit 76525ac09b
7 changed files with 856 additions and 0 deletions
+3
View File
@@ -39,8 +39,11 @@ This file is the small index for the current engineering fronts that still drive
## VedAstro Adapter MVP
- `/Users/wuyongnaren/Documents/印度占星/docs/research/vedastro_parity_matrix_latest.md`
- `/Users/wuyongnaren/Documents/印度占星/docs/research/vedastro_parity_matrix_latest.json`
- `/Users/wuyongnaren/Documents/印度占星/scripts/vedastro_service_adapter.py`
- follow only after the Jaimini marriage bridge v1 regression loop is closed
- Use the parity matrix before adding or claiming VedAstro-equivalent capability.
## Dignity / Role Guardrails
@@ -0,0 +1,243 @@
{
"scope": "vedastro_parity_matrix",
"schema_version": 1,
"generated_at": "2026-06-28T08:31:52.958980+00:00",
"summary": {
"row_count": 13,
"p0_count": 11,
"status_counts": {
"partial": 8,
"covered": 4,
"missing": 1
},
"recommended_path_counts": {
"hybrid_local_plus_vedastro": 7,
"local_native": 4,
"new_local_impl": 1,
"external_evidence_only": 1
},
"local_registry_technique_count": 89
},
"boundary": {
"not_a_clone_claim": true,
"external_outputs_are_adapter_evidence_until_promoted": true,
"local_adjudicator_remains_final_reasoning_layer": true
},
"rows": [
{
"vedastro_capability": "Tajika Annual",
"category": "annual_prediction",
"local_status": "partial",
"local_assets": [
"tajika.py",
"varshaphala.py",
"sahams",
"solar_return"
],
"can_call_vedastro": true,
"recommended_path": "hybrid_local_plus_vedastro",
"priority": "P0",
"license_boundary": "local_native_or_external_oracle",
"adjudicator_use": "secondary",
"gap_notes": "Annual modules exist; yearly career/wealth/month windows need stronger strict-workflow integration."
},
{
"vedastro_capability": "Ayanamsa Selection",
"category": "ephemeris_policy",
"local_status": "partial",
"local_assets": [
"ayanamsa_utils",
"ephemeris_adapter_contract"
],
"can_call_vedastro": true,
"recommended_path": "hybrid_local_plus_vedastro",
"priority": "P0",
"license_boundary": "external_service_or_clean_room_only",
"adjudicator_use": "oracle_only",
"gap_notes": "Local Lahiri path is usable, but broad ayanamsa parity and public comparison artifacts remain incomplete."
},
{
"vedastro_capability": "Prashna / Horary",
"category": "horary",
"local_status": "covered",
"local_assets": [
"prashna.py",
"kp_system.py",
"upagraha_gulika_maandi",
"sphuta_trisphuta_family"
],
"can_call_vedastro": true,
"recommended_path": "local_native",
"priority": "P0",
"license_boundary": "local_native_or_clean_room",
"adjudicator_use": "secondary",
"gap_notes": "Horary modules exist but are not yet a first-class question adjudicator route."
},
{
"vedastro_capability": "Jaimini / Chara Dasha",
"category": "jaimini",
"local_status": "covered",
"local_assets": [
"jaimini.py",
"AK",
"DK",
"UL",
"Chara Dasha",
"Jaimini marriage bridge v1"
],
"can_call_vedastro": true,
"recommended_path": "local_native",
"priority": "P0",
"license_boundary": "local_native_mit_attribution_for_reused_parts",
"adjudicator_use": "secondary",
"gap_notes": "Core Jaimini exists; mission/career/marriage quality adjudicator folding is not yet exhaustive."
},
{
"vedastro_capability": "Report Rendering",
"category": "presentation",
"local_status": "partial",
"local_assets": [
"report_artifact API",
"report_builder.py",
"chart_renderer.py",
"jyotish-app export"
],
"can_call_vedastro": false,
"recommended_path": "new_local_impl",
"priority": "P0",
"license_boundary": "local_native",
"adjudicator_use": "not_used",
"gap_notes": "HTML/PDF artifact path exists; polished SVG/PDF chart rendering and cloud-scale report production are not finished."
},
{
"vedastro_capability": "Synastry / Ashtakoot",
"category": "relationship_matching",
"local_status": "covered",
"local_assets": [
"synastry.py",
"ashtakoot.py",
"36-point Ashtakoot",
"16-factor compatibility"
],
"can_call_vedastro": true,
"recommended_path": "local_native",
"priority": "P0",
"license_boundary": "local_native_mit_attribution_for_reused_parts",
"adjudicator_use": "secondary",
"gap_notes": "Matching modules exist and API-backed; relationship adjudicator still needs a formal bridge."
},
{
"vedastro_capability": "MCP / API Surface",
"category": "service_surface",
"local_status": "partial",
"local_assets": [
"mcp_server.py",
"jyotish_api_server.py",
"strict workflows",
"vedastro_service_adapter.py"
],
"can_call_vedastro": true,
"recommended_path": "hybrid_local_plus_vedastro",
"priority": "P0",
"license_boundary": "external_service_or_local_native",
"adjudicator_use": "primary",
"gap_notes": "Local API/MCP surfaces exist; VedAstro live adapter needs endpoint-backed smoke tests and provenance capture."
},
{
"vedastro_capability": "Ashtakavarga",
"category": "strength",
"local_status": "partial",
"local_assets": [
"ashtakavarga",
"ashtakavarga_pav",
"ashtakavarga_sodhita",
"finance_ashtakavarga_bridge"
],
"can_call_vedastro": true,
"recommended_path": "hybrid_local_plus_vedastro",
"priority": "P0",
"license_boundary": "local_native_or_external_oracle",
"adjudicator_use": "secondary",
"gap_notes": "SAV/BAV is in production; PAV/Sodhita/Kakshya bridges need continued regression before being dominant labels."
},
{
"vedastro_capability": "Shadbala",
"category": "strength",
"local_status": "partial",
"local_assets": [
"shadbala",
"shadbala_advanced",
"shadbala_component_cap",
"oracle_shadbala_queue"
],
"can_call_vedastro": true,
"recommended_path": "hybrid_local_plus_vedastro",
"priority": "P0",
"license_boundary": "local_native_or_external_oracle",
"adjudicator_use": "secondary",
"gap_notes": "Local component-aware cap exists; absolute external oracle closure is still incomplete."
},
{
"vedastro_capability": "EventsAtRange / Life Event Graph",
"category": "timing_range_scan",
"local_status": "partial",
"local_assets": [
"transit_trigger",
"dasha",
"narayana_dasha",
"vedastro_service_adapter.range_scan"
],
"can_call_vedastro": true,
"recommended_path": "hybrid_local_plus_vedastro",
"priority": "P0",
"license_boundary": "external_service_or_clean_room_only",
"adjudicator_use": "oracle_only",
"gap_notes": "Local timing modules exist, but a high-frequency day/hour event graph is not yet a local productized radar."
},
{
"vedastro_capability": "D1-D60 Divisional Charts",
"category": "varga",
"local_status": "covered",
"local_assets": [
"varga",
"varga_full",
"shodasavarga",
"divisional_charts_extended"
],
"can_call_vedastro": true,
"recommended_path": "local_native",
"priority": "P0",
"license_boundary": "local_native_or_clean_room",
"adjudicator_use": "primary",
"gap_notes": "Local varga coverage is strong; keep VedAstro/PyJHora as benchmark evidence rather than replacing local math."
},
{
"vedastro_capability": "Birth Time ML / Rectification Assistant",
"category": "birth_time_rectification",
"local_status": "partial",
"local_assets": [
"birth_time_rectifier.py",
"rectification_gate",
"jyotish-app rectification"
],
"can_call_vedastro": true,
"recommended_path": "hybrid_local_plus_vedastro",
"priority": "P1",
"license_boundary": "external_service_or_local_native",
"adjudicator_use": "secondary",
"gap_notes": "Local rectification exists; ML parity with VedAstro-style service behavior is not established."
},
{
"vedastro_capability": "Numerology / Non-Jyotish Tools",
"category": "adjacent_tools",
"local_status": "missing",
"local_assets": [],
"can_call_vedastro": true,
"recommended_path": "external_evidence_only",
"priority": "P2",
"license_boundary": "external_service_only",
"adjudicator_use": "not_used",
"gap_notes": "Adjacent product feature; not required for Jyotish adjudicator depth."
}
]
}
@@ -0,0 +1,41 @@
# VedAstro Parity Matrix
- Generated: `2026-06-28T08:31:52.958980+00:00`
- Rows: `13`
- P0 rows: `11`
- Local registry technique count: `89`
## Honesty Boundary
VedAstro calls are external adapter evidence until a capability is promoted by local tests, oracle artifacts, or strict workflow integration. This matrix does not claim clone-level parity.
## Summary
- Local status counts: `{"covered": 4, "missing": 1, "partial": 8}`
- Recommended path counts: `{"external_evidence_only": 1, "hybrid_local_plus_vedastro": 7, "local_native": 4, "new_local_impl": 1}`
## Matrix
| VedAstro capability | Category | Local status | Path | Priority | Adjudicator use | Local assets | Gap notes |
|---|---|---:|---|---:|---|---|---|
| Tajika Annual | annual_prediction | partial | hybrid_local_plus_vedastro | P0 | secondary | tajika.py, varshaphala.py, sahams, solar_return | Annual modules exist; yearly career/wealth/month windows need stronger strict-workflow integration. |
| Ayanamsa Selection | ephemeris_policy | partial | hybrid_local_plus_vedastro | P0 | oracle_only | ayanamsa_utils, ephemeris_adapter_contract | Local Lahiri path is usable, but broad ayanamsa parity and public comparison artifacts remain incomplete. |
| Prashna / Horary | horary | covered | local_native | P0 | secondary | prashna.py, kp_system.py, upagraha_gulika_maandi, sphuta_trisphuta_family | Horary modules exist but are not yet a first-class question adjudicator route. |
| Jaimini / Chara Dasha | jaimini | covered | local_native | P0 | secondary | jaimini.py, AK, DK, UL, Chara Dasha, Jaimini marriage bridge v1 | Core Jaimini exists; mission/career/marriage quality adjudicator folding is not yet exhaustive. |
| Report Rendering | presentation | partial | new_local_impl | P0 | not_used | report_artifact API, report_builder.py, chart_renderer.py, jyotish-app export | HTML/PDF artifact path exists; polished SVG/PDF chart rendering and cloud-scale report production are not finished. |
| Synastry / Ashtakoot | relationship_matching | covered | local_native | P0 | secondary | synastry.py, ashtakoot.py, 36-point Ashtakoot, 16-factor compatibility | Matching modules exist and API-backed; relationship adjudicator still needs a formal bridge. |
| MCP / API Surface | service_surface | partial | hybrid_local_plus_vedastro | P0 | primary | mcp_server.py, jyotish_api_server.py, strict workflows, vedastro_service_adapter.py | Local API/MCP surfaces exist; VedAstro live adapter needs endpoint-backed smoke tests and provenance capture. |
| Ashtakavarga | strength | partial | hybrid_local_plus_vedastro | P0 | secondary | ashtakavarga, ashtakavarga_pav, ashtakavarga_sodhita, finance_ashtakavarga_bridge | SAV/BAV is in production; PAV/Sodhita/Kakshya bridges need continued regression before being dominant labels. |
| Shadbala | strength | partial | hybrid_local_plus_vedastro | P0 | secondary | shadbala, shadbala_advanced, shadbala_component_cap, oracle_shadbala_queue | Local component-aware cap exists; absolute external oracle closure is still incomplete. |
| EventsAtRange / Life Event Graph | timing_range_scan | partial | hybrid_local_plus_vedastro | P0 | oracle_only | transit_trigger, dasha, narayana_dasha, vedastro_service_adapter.range_scan | Local timing modules exist, but a high-frequency day/hour event graph is not yet a local productized radar. |
| D1-D60 Divisional Charts | varga | covered | local_native | P0 | primary | varga, varga_full, shodasavarga, divisional_charts_extended | Local varga coverage is strong; keep VedAstro/PyJHora as benchmark evidence rather than replacing local math. |
| Birth Time ML / Rectification Assistant | birth_time_rectification | partial | hybrid_local_plus_vedastro | P1 | secondary | birth_time_rectifier.py, rectification_gate, jyotish-app rectification | Local rectification exists; ML parity with VedAstro-style service behavior is not established. |
| Numerology / Non-Jyotish Tools | adjacent_tools | missing | external_evidence_only | P2 | not_used | - | Adjacent product feature; not required for Jyotish adjudicator depth. |
## Next Actions
1. Promote `VedAstro adapter MVP` from contract to endpoint-backed smoke tests.
2. Add a relationship bridge for `Synastry / Ashtakoot` before using matching scores as primary labels.
3. Build `Life Event Graph v1` from local monthly/day scan plus optional VedAstro range-scan evidence.
4. Keep ayanamsa and Shadbala parity under oracle closure before claiming production tuning.
@@ -0,0 +1,55 @@
# VedAstro Parity Matrix v1 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:** Build a repeatable VedAstro parity matrix that maps public VedAstro capability areas to local assets, external adapter options, and implementation priorities.
**Architecture:** Add one focused generator script that consumes local capability audit output and a curated VedAstro seed list, then writes JSON and Markdown snapshots. Keep the matrix separate from strict adjudicator runtime so it cannot accidentally assert unverified production parity.
**Tech Stack:** Python 3 standard library, existing `scripts/audit_capabilities.py`, existing research markdown conventions.
## Global Constraints
- Do not copy VedAstro implementation code.
- Treat VedAstro results as external adapter evidence unless promoted by local tests or oracle artifacts.
- Do not modify strict workflow scoring in this task.
- Do not stage unrelated untracked workspace residue.
---
### Task 1: Generator And Tests
**Files:**
- Create: `scripts/vedastro_parity_matrix.py`
- Create: `tests/test_vedastro_parity_matrix.py`
- Modify: `docs/research/ACTIVE_FRONTS.md`
**Interfaces:**
- Produces: `build_matrix(audit: dict | None = None) -> dict`
- Produces: `render_markdown(matrix: dict) -> str`
- Produces CLI: `python3 scripts/vedastro_parity_matrix.py --format json|markdown --write`
- [ ] **Step 1: Write tests for P0 rows and contracts**
Run: `python3 -m pytest tests/test_vedastro_parity_matrix.py -q`
- [ ] **Step 2: Implement the generator**
Create the matrix with deterministic row ordering and explicit allowed values.
- [ ] **Step 3: Generate snapshots**
Run: `python3 scripts/vedastro_parity_matrix.py --write`
- [ ] **Step 4: Verify**
Run:
```bash
python3 -m pytest tests/test_vedastro_parity_matrix.py -q
python3 scripts/vedastro_parity_matrix.py --format json >/tmp/vedastro_parity_matrix.json
```
- [ ] **Step 5: Commit**
Stage only the parity matrix files, tests, and Active Fronts update.
@@ -0,0 +1,47 @@
# VedAstro Parity Matrix v1 Design
## Goal
Create a repeatable parity matrix that compares public VedAstro capability areas with this repository's local assets and recommends the safest integration path for each area.
## Boundary
The matrix is a planning and audit artifact. It does not claim that local behavior equals VedAstro behavior unless the local registry, tests, and external oracle status support that claim.
## Inputs
- `scripts/audit_capabilities.py --mode validate`
- `scripts/vedastro_service_adapter.py` schema and supported range-scan domains
- A curated public VedAstro capability seed list kept in the generator script
- Existing research indexes under `docs/research/ACTIVE_FRONTS.md`
## Output Contract
Each row includes:
- `vedastro_capability`
- `category`
- `local_status`
- `local_assets`
- `can_call_vedastro`
- `recommended_path`
- `priority`
- `license_boundary`
- `adjudicator_use`
- `gap_notes`
Allowed `recommended_path` values:
- `local_native`
- `vedastro_adapter`
- `new_local_impl`
- `external_evidence_only`
- `hybrid_local_plus_vedastro`
## v1 Priorities
P0 rows cover: range scanning, ayanamsa parity, D1-D60/varga parity, Ashtakavarga/Shadbala oracle checks, Jaimini/Chara Dasha, Synastry/Ashtakoot, Tajika annual, Prashna, report rendering, and MCP/API parity.
## Honesty Rule
External VedAstro output must be marked as adapter evidence unless it is independently promoted through local tests or an oracle artifact. Local adjudicators remain the final reasoning layer.