root/Jyotisha
1
0
Fork 0
Code Issues 1 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

feat: sync gender interpretation boundaries

Browse Source
This commit is contained in:
732642856
2026-07-19 11:15:17 +08:00
parent f09efac5ff
commit 82f4862aef
7 changed files with 428 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/research/gender_interpretation_contract_2026_07_19.md
+72
View File
@@ -0,0 +1,72 @@
# Gender interpretation contract — 2026-07-19
本合同只管解释层；不改变星盘计算。
## 总原则
- 性别不改变 D1、分盘、Dasha、Shadbala、Ashtakavarga、Yoga、Ayanamsa、Node mode。
- 性别只能在婚恋/配偶/婚姻应期加权、生育语境表达里作为辅助层。
- 不能只靠“男金女木”下婚恋结论。
## 婚恋/配偶
基础栈性别中立：
- 7宫
- 7宫主
- D9
- UL
- Darakaraka
性别辅助层：
- 男命增强 Venus。
- 女命增强 Jupiter/Mars。
- `nonbinary`、`prefer_not_to_say` 或缺失时，使用性别中立栈，不强行套二元规则。
## 婚姻应期
基础仍需：
- 7宫主周期
- D9 激活
- UL 激活
- DK 周期
- Vimshottari + Narayana 交叉
性别只能增加权重：
- 男命：Venus 周期/过境激活可作为补充证据。
- 女命：Jupiter/Mars 周期/过境激活可作为补充证据。
禁止说：只因某个性别象征星激活，所以应期已验证。
## 子女/生育语境
基础仍是：
- 5宫
- 5宫主
- Jupiter
- D7
- Putrakaraka
性别只用于语言和现实语境；不得给医疗、生育、怀孕保证结论。
## 产品字段建议
```ts
gender: "male" | "female" | "nonbinary" | "prefer_not_to_say" | null
```
文案建议：
> 该信息仅用于传统婚恋/配偶象征星的解释加权，不改变星盘计算。
## 产品回答边界
如果 gender 缺失，不阻塞回答。只在婚恋/配偶问题里可轻问：
> 如果你愿意，也可以补充性别；我会用传统配偶象征星再校正一次。
若使用 gender，必须说明它只是传统辅助象征层，不是唯一判断。
frontend/src/mastra/index.ts
+1
View File
@@ -174,6 +174,7 @@ When reference_transparency is present:
- When similar_public_cases.coverage.requested_uncovered_domains is non-empty, say the current public-case catalog does not yet cover those themes; do not infer that no comparable real-world case exists.
- When method_variants applies, present parallel methods and their source paths rather than silently picking one result as the only truth.
- Treat Shadbala/Ashtakavarga component differences under production_tuning_allowed=false as method boundaries, not absolute calculation errors. Use no_majority_vote and method_variant_not_majority_vote: do not decide truth by engine count, and do not say one school is wrong unless a pinned authoritative worked example is present.
- If gender or sex is present in future profile context, use it only for relationship/spouse interpretation language and weighting: gender-specific spouse significators are supplements, not chart-calculation switches. For relationship questions, keep the core stack gender-neutral (7th house, 7th lord, D9, UL, Darakaraka); male charts may supplement Venus, female charts may supplement Jupiter/Mars, and unknown/nonbinary/prefer-not-to-say uses the gender-neutral stack.
- If should_lead_with_limitations is false, do not lead with limitations. If a limitation is relevant, put it in one short sentence at the end.
- Only say the chart calculation failed when hard_blockers is non-empty.
- Never claim D2, D11, D9, D10, A10, UL, or Narayana Dasha is missing when it appears in available_layers, chart, or local_layers.
frontend/tests/consultation-context.test.ts
+3
View File
@@ -22,6 +22,9 @@ test("passes transparent public-case references into the agent context", () => {
assert.match(source, /method_variant_not_majority_vote/);
assert.match(source, /Shadbala\/Ashtakavarga component differences/);
assert.match(source, /D2, D11/);
assert.match(source, /gender-specific spouse significators are supplements/);
assert.match(source, /male.*Venus/);
assert.match(source, /female.*Jupiter\/Mars/);
});
test("keeps strength, Ashtakavarga, and timing evidence available to the answer model", () => {
references/oracle/gender_interpretation_contract_2026_07_19.json
+83
View File
@@ -0,0 +1,83 @@
{
"contract_id": "gender_interpretation_contract_2026_07_19",
"status": "interpretation_boundary_registry",
"purpose": "Define where user gender may affect Vedic astrology interpretation without changing chart mathematics.",
"recommended_profile_field": {
"name": "gender",
"allowed_values": ["male", "female", "nonbinary", "prefer_not_to_say", null],
"product_copy": "Only used for traditional relationship/spouse significator weighting; it does not change the chart calculation."
},
"calculation_layer_policy": {
"changes_chart_math": false,
"gender_neutral_calculations": [
"rasi_chart",
"divisional_charts",
"vimshottari_dasha",
"narayana_dasha",
"ayanamsa",
"node_mode",
"shadbala",
"ashtakavarga",
"yoga_detection",
"functional_benefic_malefic"
]
},
"allowed_use_domains": [
"relationship_spouse_interpretation",
"marriage_timing_weighting",
"children_birth_context_language"
],
"forbidden_use_domains": [
"career",
"wealth",
"core_personality",
"dasha_boundary_calculation",
"shadbala_component_calculation",
"ashtakavarga_bindu_calculation",
"absolute_prediction_confidence"
],
"relationship_spouse_interpretation": {
"core_stack_gender_neutral": ["7th_house", "7th_lord", "D9", "UL", "Darakaraka"],
"gender_specific_supplements": {
"male": {
"spouse_karaka_focus": ["Venus"],
"language": "Male-chart traditional spouse significator weighting may emphasize Venus."
},
"female": {
"spouse_karaka_focus": ["Jupiter", "Mars"],
"language": "Female-chart traditional spouse/husband significator weighting may emphasize Jupiter, with Mars used by some lineages for partner dynamics."
},
"unknown_or_not_binary": {
"spouse_karaka_focus": [
"7th_lord",
"D9",
"UL",
"Darakaraka",
"Venus_as_general_relationship_karaka"
],
"language": "Use the gender-neutral relationship stack; do not force binary spouse significators."
}
},
"hard_boundary": "gender_specific_karakas_are_supplements_not_single_factor_truth"
},
"marriage_timing_weighting": {
"base_required": ["7th_lord_periods", "D9_activation", "UL_activation", "Darakaraka_periods", "Vimshottari_Narayana_crosscheck"],
"male_optional_weight": ["Venus_period_or_transit_activation"],
"female_optional_weight": ["Jupiter_or_Mars_period_or_transit_activation"],
"forbidden_claim": "Do not claim a marriage window is verified solely because a gender-specific karaka is active."
},
"children_birth_context_language": {
"base_required": ["5th_house", "5th_lord", "Jupiter", "D7", "Putrakaraka"],
"safety_boundary": "Use gender only for context language. Do not make medical, pregnancy, fertility, or guaranteed child-birth claims."
},
"answer_policy": {
"if_gender_missing": "Do not block. Answer from gender-neutral stack and optionally ask for gender only when relationship/spouse interpretation materially depends on traditional significator weighting.",
"if_nonbinary_or_prefer_not_to_say": "Do not force binary rules. Use gender-neutral relationship stack.",
"disclosure": "If used, say it is a traditional supplementary significator layer, not the only basis of judgment."
},
"evidence_status": {
"source_type": "traditional_rule_registry_plus_local_methodology",
"normative_strength": "medium",
"requires_lineage_disclosure": true
}
}
references/relationship_gender_role_technique_registry_2026_07_19.json
+158
View File
@@ -0,0 +1,158 @@
{
"scope": "relationship_gender_role_technique_registry",
"created_at": "2026-07-19",
"default_profile_policy": "neutral_partner_a_b",
"base_chart_requires_gender": false,
"production_tuning_allowed": false,
"truth_policy": "technique_registry_not_prediction_truth",
"boundary": "Gender/role fields may change relationship interpretation, role weighting, or traditional marriage-rule variants; they must not change core D1/D9/Dasha/Shadbala/AV calculation.",
"recommended_optional_fields": {
"gender": "female|male|nonbinary|unspecified",
"relationship_role_mode": "neutral_partner_a_b|traditional_gendered",
"partner_interest": "male|female|any|unspecified"
},
"web_oss_scan": [
{
"name": "Kerykeion",
"url": "https://github.com/g-battaglia/kerykeion",
"license": "AGPL-3.0",
"usable_boundary": "oracle/reference only unless AGPL obligations are acceptable; useful for western natal/synastry/transits/returns and relationship score surface comparison."
},
{
"name": "Astrologer-API",
"url": "https://github.com/g-battaglia/Astrologer-API",
"license": "repository license must be checked before reuse",
"usable_boundary": "hosted/API reference for western chart/synastry/composite/returns; do not copy code without license confirmation."
},
{
"name": "Amber-bisht/astro",
"url": "https://github.com/Amber-bisht/astro",
"license": "repository license must be checked before reuse",
"usable_boundary": "Vedic compatibility output-schema reference only until license and formula sources are verified."
},
{
"name": "RaviKarrii/Marriage-Compatibility-Asthakoot",
"url": "https://github.com/RaviKarrii/Marriage-Compatibility-Asthakoot",
"license": "MIT",
"usable_boundary": "possible permissive Ashtakoot comparison reference after formula/source audit."
},
{
"name": "VedAstro/VedAstro",
"url": "https://github.com/VedAstro/VedAstro",
"license": "MIT",
"usable_boundary": "Vedic API/oracle reference; hosted identity remains blocked separately."
}
],
"techniques": [
{
"id": "vedic_venus_jupiter_spouse_significators",
"system": "vedic",
"domain": "relationship",
"gender_dependency": "interpretation_only",
"what_changes": "Traditional readings often emphasize Venus as wife/relationship desire in male charts and Jupiter as husband/protective spouse factor in female charts; neutral mode treats Venus/Jupiter as partner-quality indicators without assigning gender.",
"local_status": "partially_present",
"integration_action": "add_interpretation_layer",
"license_boundary": "use local calculations; cite formula/source notes, do not copy AGPL prose/code.",
"claim_boundary": "interpretive weighting only; not a deterministic marriage outcome."
},
{
"id": "vedic_kuja_manglik_role_weighting",
"system": "vedic",
"domain": "relationship",
"gender_dependency": "role_weighting",
"what_changes": "Mangal/Kuja Dosha can be judged from Lagna/Moon/Venus and compared between partners; some traditional variants weight bride/groom roles differently, while neutral mode compares both charts symmetrically.",
"local_status": "partially_present",
"integration_action": "add_interpretation_layer",
"license_boundary": "local calculation preferred; external APIs only oracle/reference.",
"claim_boundary": "dosha compatibility signal, not a standalone marriage denial."
},
{
"id": "ashtakoot_yoni_energy_not_user_gender",
"system": "vedic",
"domain": "matching",
"gender_dependency": "traditional_rule_variant",
"what_changes": "Yoni Kuta contains male/female animal-energy assignments by nakshatra; this is not the user's biological gender and must not be mapped directly to profile gender.",
"local_status": "present",
"integration_action": "use_existing_local",
"license_boundary": "existing local Ashtakoot path; external articles only explanatory source evidence.",
"claim_boundary": "matching subscore only; do not infer gender identity."
},
{
"id": "ashtakoot_nadi_rajju_reproductive_safety",
"system": "vedic",
"domain": "matching",
"gender_dependency": "traditional_rule_variant",
"what_changes": "Nadi/Rajju are traditionally framed around health, longevity, and childbearing risk; modern neutral mode should describe them as traditional compatibility flags.",
"local_status": "present",
"integration_action": "use_existing_local",
"license_boundary": "existing local Ashtakoot path.",
"claim_boundary": "traditional risk flag, not medical advice."
},
{
"id": "jaimini_darakaraka_upapada_spouse_role",
"system": "vedic",
"domain": "relationship",
"gender_dependency": "interpretation_only",
"what_changes": "Darakaraka and Upapada calculations are gender-neutral; interpretive language can shift between spouse/partner role modes.",
"local_status": "present",
"integration_action": "add_interpretation_layer",
"license_boundary": "use local Jaimini implementation.",
"claim_boundary": "spouse/partner evidence layer, not exact event proof."
},
{
"id": "d9_navamsa_gendered_interpretation_layer",
"system": "vedic",
"domain": "relationship",
"gender_dependency": "interpretation_only",
"what_changes": "D9 calculation is identical for all users; relationship interpretation may emphasize partner significators differently under traditional_gendered mode.",
"local_status": "present",
"integration_action": "add_interpretation_layer",
"license_boundary": "use local varga calculation.",
"claim_boundary": "quality/structure signal; timing still needs Dasha/transit/holdout support."
},
{
"id": "adhana_conception_gender_sensitive_scaffold",
"system": "vedic",
"domain": "conception",
"gender_dependency": "traditional_rule_variant",
"what_changes": "Adhana/conception rules can involve gendered fertility and conception assumptions; current local module is scaffold only.",
"local_status": "scaffold",
"integration_action": "blocked_until_source_verified",
"license_boundary": "must verify classical source and avoid medical claims.",
"claim_boundary": "blocked for product interpretation; research-only."
},
{
"id": "western_venus_mars_sun_moon_partner_projection",
"system": "western",
"domain": "relationship",
"gender_dependency": "interpretation_only",
"what_changes": "Traditional western readings may map Venus/Moon or Mars/Sun to partner preference by gender; modern neutral mode treats them as affection, desire, identity, and safety signatures.",
"local_status": "not_integrated",
"integration_action": "oracle_only",
"license_boundary": "Kerykeion is AGPL-3.0; use as oracle/reference, not copied dependency for closed commercial runtime.",
"claim_boundary": "interpretive layer only; no deterministic compatibility claim."
},
{
"id": "western_synastry_composite_role_neutral_mode",
"system": "western",
"domain": "relationship",
"gender_dependency": "none",
"what_changes": "Synastry/composite math does not require gender; relationship role labels should be A/B unless user chooses traditional wording.",
"local_status": "partial",
"integration_action": "oracle_only",
"license_boundary": "Kerykeion/Astrologer API can guide schema; license/API boundaries required.",
"claim_boundary": "relationship dynamics map, not event proof."
},
{
"id": "western_progressed_angles_relationship_timing",
"system": "western",
"domain": "timing",
"gender_dependency": "none",
"what_changes": "Progressed angles and returns do not need gender; only interpretation voice changes.",
"local_status": "partial",
"integration_action": "add_interpretation_layer",
"license_boundary": "use local ephemeris where available; OSS only reference unless permissive.",
"claim_boundary": "candidate timing trigger; not a verified day/month prediction until holdout passes."
}
]
}
tests/test_gender_interpretation_contract.py
+57
View File
@@ -0,0 +1,57 @@
import json
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
CONTRACT = ROOT / "references" / "oracle" / "gender_interpretation_contract_2026_07_19.json"
REPORT = ROOT / "docs" / "research" / "gender_interpretation_contract_2026_07_19.md"
def test_gender_contract_exists_and_is_not_a_chart_calculation_switch() -> None:
data = json.loads(CONTRACT.read_text(encoding="utf-8"))
assert data["contract_id"] == "gender_interpretation_contract_2026_07_19"
assert data["calculation_layer_policy"]["changes_chart_math"] is False
assert "vimshottari_dasha" in data["calculation_layer_policy"]["gender_neutral_calculations"]
assert "shadbala" in data["calculation_layer_policy"]["gender_neutral_calculations"]
assert "ashtakavarga" in data["calculation_layer_policy"]["gender_neutral_calculations"]
def test_gender_contract_limits_gender_use_to_relationship_and_birth_contexts() -> None:
data = json.loads(CONTRACT.read_text(encoding="utf-8"))
assert data["allowed_use_domains"] == [
"relationship_spouse_interpretation",
"marriage_timing_weighting",
"children_birth_context_language",
]
assert "career" in data["forbidden_use_domains"]
assert "wealth" in data["forbidden_use_domains"]
assert "core_personality" in data["forbidden_use_domains"]
def test_gender_contract_keeps_core_marriage_stack_gender_neutral() -> None:
data = json.loads(CONTRACT.read_text(encoding="utf-8"))
marriage = data["relationship_spouse_interpretation"]
assert marriage["core_stack_gender_neutral"] == ["7th_house", "7th_lord", "D9", "UL", "Darakaraka"]
assert marriage["gender_specific_supplements"]["male"]["spouse_karaka_focus"] == ["Venus"]
assert marriage["gender_specific_supplements"]["female"]["spouse_karaka_focus"] == ["Jupiter", "Mars"]
assert marriage["gender_specific_supplements"]["unknown_or_not_binary"]["spouse_karaka_focus"] == [
"7th_lord",
"D9",
"UL",
"Darakaraka",
"Venus_as_general_relationship_karaka",
]
assert marriage["hard_boundary"] == "gender_specific_karakas_are_supplements_not_single_factor_truth"
def test_gender_contract_report_is_readable_and_product_safe() -> None:
text = REPORT.read_text(encoding="utf-8")
assert "不改变星盘计算" in text
assert "男命增强 Venus" in text
assert "女命增强 Jupiter/Mars" in text
assert "不能只靠“男金女木”" in text
assert "prefer_not_to_say" in text
tests/test_relationship_gender_role_technique_registry.py
+54
View File
@@ -0,0 +1,54 @@
from __future__ import annotations
import json
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
REGISTRY = ROOT / "references/relationship_gender_role_technique_registry_2026_07_19.json"
def test_relationship_gender_role_registry_keeps_gender_out_of_base_chart() -> None:
data = json.loads(REGISTRY.read_text(encoding="utf-8"))
assert data["scope"] == "relationship_gender_role_technique_registry"
assert data["default_profile_policy"] == "neutral_partner_a_b"
assert data["base_chart_requires_gender"] is False
assert data["production_tuning_allowed"] is False
assert data["truth_policy"] == "technique_registry_not_prediction_truth"
def test_relationship_gender_role_registry_covers_core_indian_and_western_methods() -> None:
data = json.loads(REGISTRY.read_text(encoding="utf-8"))
ids = {row["id"] for row in data["techniques"]}
for required in {
"vedic_venus_jupiter_spouse_significators",
"vedic_kuja_manglik_role_weighting",
"ashtakoot_yoni_energy_not_user_gender",
"ashtakoot_nadi_rajju_reproductive_safety",
"jaimini_darakaraka_upapada_spouse_role",
"d9_navamsa_gendered_interpretation_layer",
"adhana_conception_gender_sensitive_scaffold",
"western_venus_mars_sun_moon_partner_projection",
"western_synastry_composite_role_neutral_mode",
"western_progressed_angles_relationship_timing",
}:
assert required in ids
def test_relationship_gender_role_registry_marks_license_and_integration_boundaries() -> None:
data = json.loads(REGISTRY.read_text(encoding="utf-8"))
for row in data["techniques"]:
assert row["integration_action"] in {
"use_existing_local",
"add_interpretation_layer",
"oracle_only",
"blocked_until_source_verified",
}
assert row["gender_dependency"] in {
"none",
"interpretation_only",
"role_weighting",
"traditional_rule_variant",
}
assert row["license_boundary"]
assert row["claim_boundary"]