Enforce external-truth Yogi finance boundary

2026-06-28 10:32:10 +08:00
parent 0bee529579
commit ba867a4b8c
4 changed files with 259 additions and 23 deletions
@@ -0,0 +1,70 @@
+# Git Execution Card - Finance Yogi Boundary Only
+
+日期：2026-06-28
+目标：只提交 finance adjudicator 的外部真值 Yogi 边界修复，不混入其他工作树噪音。
+
+## 目标文件
+
+1. `mcp_server.py`
+2. `tests/test_mcp_strict_workflow_finance.py`
+3. `docs/research/wealth_adjudicator_fifth_pass_external_truth_boundary_2026_06_28.md`
+
+## 执行顺序
+
+### Step 1 - 确认暂存范围
+
+```bash
+git -C /Users/wuyongnaren/Documents/印度占星 reset
+git -C /Users/wuyongnaren/Documents/印度占星 add -- \
+  mcp_server.py \
+  tests/test_mcp_strict_workflow_finance.py \
+  docs/research/wealth_adjudicator_fifth_pass_external_truth_boundary_2026_06_28.md
+```
+
+### Step 2 - 检查暂存区
+
+```bash
+git -C /Users/wuyongnaren/Documents/印度占星 diff --cached --name-only
+git -C /Users/wuyongnaren/Documents/印度占星 diff --cached --stat
+git -C /Users/wuyongnaren/Documents/印度占星 diff --cached --check
+```
+
+预期：只看到上述 3 个文件。
+
+### Step 3 - 回归验证
+
+```bash
+python3 -m pytest /Users/wuyongnaren/Documents/印度占星/tests/test_mcp_strict_workflow_finance.py -q
+```
+
+预期：
+
+- `12 passed`
+
+### Step 4 - 独立提交
+
+建议提交语义：
+
+```bash
+git -C /Users/wuyongnaren/Documents/印度占星 commit -m "Enforce external-truth Yogi finance boundary"
+```
+
+### Step 5 - 推送当前分支
+
+```bash
+git -C /Users/wuyongnaren/Documents/印度占星 push origin codex/release-hygiene-ci
+```
+
+## 禁止事项
+
+这次提交不要混入：
+
+- `docs/research/public_benchmark_dashboard_latest.md`
+- `references/oracle/artifacts/pyjhora_oracle_artifact_manifest.json`
+- 任意 `patch_*.py`
+- 任意本地试验脚本
+- 未整理的 sidecar 研究包
+
+## 一句话判断
+
+**这是一张“只交 finance Yogi 真实性边界，不交别的”的推送卡。**
@@ -0,0 +1,74 @@
+# Wealth Adjudicator Fifth Pass External Truth Boundary (2026-06-28)
+
+## What Was Fixed
+
+This pass closed a structural contradiction in the finance adjudicator:
+
+- one branch of the codebase was already moving toward `external_truth.yogi_planet`
+- another branch was still internally deriving Yogi from Sun/Moon degrees and letting that influence finance promise folding
+
+That violated the new high-rigor boundary.
+
+## Boundary Now Enforced
+
+The finance adjudicator now follows this rule:
+
+1. No external `yogi_planet` -> no Yogi contribution
+2. External `yogi_planet` present -> lightweight D1 gate only
+3. Only then may Yogi enter:
+   - `wealth_promise_strength.supporting_sources`
+   - `source_diversity`
+   - `secondary_context` as `yogi_active`
+
+## Removed Risk
+
+The following behavior is no longer allowed:
+
+- deriving Yogi from internal Sun/Moon degrees
+- upgrading `dhana_yogas` to `dhana_yogi_hooks` without upstream truth
+- creating `yogi_support_only` from local chart math
+
+## Regression Contract
+
+The finance regression suite now locks these four truths:
+
+1. `dhana` alone must stay `dhana_yogas` without external truth
+2. `dhana + lakshmi` must stay `dhana_lakshmi_hooks` without external truth
+3. Yogi-only local chart inputs must not produce a finance promise
+4. External truth + valid Kendra/Trikona placement may promote to `dhana_yogi_hooks`
+
+## Verification
+
+Command:
+
+```bash
+python3 -m pytest tests/test_mcp_strict_workflow_finance.py -q
+```
+
+Observed:
+
+- `12 passed`
+
+Manual probe confirmed:
+
+- `NO_EXTERNAL` -> no Yogi source in promise folding
+- `WITH_EXTERNAL` -> `supporting_sources = ["dhana", "yogi"]`
+- `secondary_context` includes `yogi_active`
+
+## Why This Matters
+
+This is not just a bug fix. It restores honesty at the adjudication layer.
+
+The finance engine can now say:
+
+- "Yogi affected this judgement because an upstream truth source supplied it"
+
+but can no longer silently smuggle Yogi into the result from local chart math.
+
+## Next Step
+
+Keep the same discipline for all future high-order promise hooks:
+
+1. external truth first
+2. lightweight downstream gating second
+3. no hidden internal recomputation