eduevidence 6.2.0 → 6.3.0

package/domains/_neutral/copy/module_labels_summary.json

@@ -0,0 +1,98 @@
+{
+  "domain": "_neutral",
+  "purpose": "Neutral UI labels — module_labels_summary.",
+  "labels": {
+    "summary_title": {
+      "zh": "一句话结论",
+      "en": "Bottom line"
+    },
+    "summary_question": {
+      "zh": "问题",
+      "en": "Question"
+    },
+    "summary_evidence": {
+      "zh": "依据",
+      "en": "Evidence"
+    },
+    "summary_action": {
+      "zh": "行动",
+      "en": "Action"
+    },
+    "outcome_table": {
+      "zh": [
+        "结果类型",
+        "正向效应",
+        "负向效应",
+        "零效应",
+        "证据"
+      ],
+      "en": [
+        "Outcome",
+        "Positive effect",
+        "Negative effect",
+        "Null effect",
+        "Evidence"
+      ]
+    },
+    "figure1_caption": {
+      "zh": "图 1. 各结果类型的正向 / 负向 / 零效应证据数量（基于 effect_direction，不等同于 Claim 是否被支持）。",
+      "en": "Fig. 1. Positive / negative / null effect counts per outcome (based on effect_direction, not claim support)."
+    },
+    "hero_action": {
+      "zh": "建议决策",
+      "en": "Recommended decision"
+    },
+    "hero_confidence": {
+      "zh": "置信度",
+      "en": "Confidence"
+    },
+    "hero_supported": {
+      "zh": "最强支持结论",
+      "en": "Strongest supported conclusion"
+    },
+    "hero_uncertain": {
+      "zh": "关键不确定性 / 反例",
+      "en": "Key uncertainty / contradiction"
+    },
+    "hero_risk": {
+      "zh": "主要风险",
+      "en": "Main risk"
+    },
+    "hero_next": {
+      "zh": "下一步",
+      "en": "Next action"
+    },
+    "hero_provenance": {
+      "zh": "证据 / 来源",
+      "en": "Evidence / sources"
+    },
+    "effect_positive": {
+      "zh": "正向效应",
+      "en": "Positive effect"
+    },
+    "effect_negative": {
+      "zh": "负向效应",
+      "en": "Negative effect"
+    },
+    "effect_null": {
+      "zh": "零效应",
+      "en": "Null effect"
+    },
+    "summary_tag_support": {
+      "zh": "支持",
+      "en": "Support"
+    },
+    "summary_tag_contradict": {
+      "zh": "反驳",
+      "en": "Contradict"
+    },
+    "summary_confidence_prefix": {
+      "zh": "（置信度：",
+      "en": " (confidence: "
+    },
+    "summary_confidence_suffix": {
+      "zh": "）",
+      "en": ")"
+    }
+  }
+}

package/domains/_neutral/copy/module_labels_tables.json

@@ -0,0 +1,164 @@
+{
+  "domain": "_neutral",
+  "purpose": "Neutral UI labels — module_labels_tables.",
+  "labels": {
+    "matrix_filter": {
+      "zh": "筛选 / 搜索",
+      "en": "Filter / Search"
+    },
+    "matrix_search_ph": {
+      "zh": "搜索证据…",
+      "en": "Search evidence…"
+    },
+    "matrix_all_dir": {
+      "zh": "全部效应",
+      "en": "All effects"
+    },
+    "matrix_all_outcome": {
+      "zh": "全部结果",
+      "en": "All outcomes"
+    },
+    "matrix_heads": {
+      "zh": [
+        "ID",
+        "结果",
+        "效应",
+        "质量",
+        "主张",
+        "来源"
+      ],
+      "en": [
+        "ID",
+        "Outcome",
+        "Effect",
+        "Quality",
+        "Claim",
+        "Source"
+      ]
+    },
+    "matrix_details": {
+      "zh": "查看完整证据",
+      "en": "View full evidence"
+    },
+    "matrix_detail_labels": {
+      "zh": [
+        "研究标题",
+        "研究设计",
+        "人群",
+        "干预",
+        "直接性"
+      ],
+      "en": [
+        "Study title",
+        "Design",
+        "Population",
+        "Intervention",
+        "Directness"
+      ]
+    },
+    "matrix_source_missing": {
+      "zh": "无可验证来源",
+      "en": "No verifiable source"
+    },
+    "matrix_search_label": {
+      "zh": "筛选 / 搜索证据",
+      "en": "Filter / search evidence"
+    },
+    "matrix_dir_filter": {
+      "zh": "按效应方向筛选",
+      "en": "Filter by effect direction"
+    },
+    "matrix_outcome_filter": {
+      "zh": "按结果类型筛选",
+      "en": "Filter by outcome type"
+    },
+    "method_audit_heads": {
+      "zh": [
+        "检查项",
+        "状态",
+        "说明"
+      ],
+      "en": [
+        "Item",
+        "Status",
+        "Note"
+      ]
+    },
+    "conflict_verdict": {
+      "zh": "裁决说明",
+      "en": "Tribunal note"
+    },
+    "trace_decision": {
+      "zh": "决策",
+      "en": "Decision"
+    },
+    "trace_claim_prefix": {
+      "zh": "主张",
+      "en": "Claim"
+    },
+    "trace_no_source": {
+      "zh": "无来源",
+      "en": "No source"
+    },
+    "sources_title": {
+      "zh": "来源列表",
+      "en": "Source list"
+    },
+    "sources_heads": {
+      "zh": [
+        "ID",
+        "标题",
+        "年份",
+        "权威级别",
+        "可验证位置"
+      ],
+      "en": [
+        "ID",
+        "Title",
+        "Year",
+        "Authority",
+        "Verifiable location"
+      ]
+    },
+    "provenance_title": {
+      "zh": "Fetch 溯源",
+      "en": "Fetch provenance"
+    },
+    "provenance_heads": {
+      "zh": [
+        "来源",
+        "Fetch 方式",
+        "状态",
+        "降级",
+        "时间"
+      ],
+      "en": [
+        "Source",
+        "Fetch method",
+        "Status",
+        "Fallback",
+        "Time"
+      ]
+    },
+    "provenance_search": {
+      "zh": "搜索提供方",
+      "en": "Search provider"
+    },
+    "provenance_time": {
+      "zh": "检索时间",
+      "en": "Fetched at"
+    },
+    "provenance_empty": {
+      "zh": "无逐条 fetch 记录（来源由研究管线直接提供）。",
+      "en": "No per-source fetch records (sources provided directly by the research pipeline)."
+    },
+    "applicability_not_suitable": {
+      "zh": "不适用于",
+      "en": "Not suitable for"
+    },
+    "applicability_conditions": {
+      "zh": "适用条件",
+      "en": "Conditions"
+    }
+  }
+}

package/domains/_neutral/copy/module_labels_v2.json

@@ -0,0 +1,90 @@
+{
+  "domain": "_neutral",
+  "purpose": "Neutral UI labels — module_labels_v2.",
+  "labels": {
+    "v2_project_title": {
+      "zh": "项目与研究历史",
+      "en": "Project & Research History"
+    },
+    "v2_project_id": {
+      "zh": "项目 ID",
+      "en": "Project ID"
+    },
+    "v2_graph_revision": {
+      "zh": "证据图版本",
+      "en": "Graph revision"
+    },
+    "v2_decision_snapshot": {
+      "zh": "决策快照",
+      "en": "Decision snapshot"
+    },
+    "v2_timeline": {
+      "zh": "项目时间线",
+      "en": "Project timeline"
+    },
+    "v2_gaps_title": {
+      "zh": "知识缺口",
+      "en": "Knowledge gaps"
+    },
+    "v2_gap_type": {
+      "zh": "缺口类型",
+      "en": "Gap type"
+    },
+    "v2_gap_priority": {
+      "zh": "优先级",
+      "en": "Priority"
+    },
+    "v2_gap_reasoning": {
+      "zh": "依据",
+      "en": "Reasoning"
+    },
+    "v2_design_title": {
+      "zh": "研究设计",
+      "en": "Study design"
+    },
+    "v2_design_type": {
+      "zh": "设计类型",
+      "en": "Design type"
+    },
+    "v2_design_question": {
+      "zh": "研究问题",
+      "en": "Research question"
+    },
+    "v2_provenance_title": {
+      "zh": "数据集与分析溯源",
+      "en": "Dataset & analysis provenance"
+    },
+    "v2_diff_title": {
+      "zh": "决策变更",
+      "en": "Decision diff"
+    },
+    "v2_diff_action": {
+      "zh": "决策动作",
+      "en": "Decision action"
+    },
+    "v2_diff_confidence": {
+      "zh": "置信度",
+      "en": "Confidence"
+    },
+    "v2_diff_claims": {
+      "zh": "变更的主张",
+      "en": "Changed claims"
+    },
+    "v2_diff_gaps": {
+      "zh": "已解决/新增缺口",
+      "en": "Resolved/new gaps"
+    },
+    "v2_revision": {
+      "zh": "版本",
+      "en": "Revision"
+    },
+    "v2_decision": {
+      "zh": "决策",
+      "en": "Decision"
+    },
+    "v2_no_v2_data": {
+      "zh": "（无 V2 项目数据）",
+      "en": "(no V2 project data)"
+    }
+  }
+}

package/domains/_neutral/copy/risk_constructs.json

@@ -0,0 +1,20 @@
+{
+  "domain": "_neutral",
+  "outcome_groups": {},
+  "separation_title": {
+    "zh": "结果分离",
+    "en": "Outcome separation"
+  },
+  "separation_note": {
+    "zh": "将不同结果类型分开裁决。",
+    "en": "Outcomes are adjudicated separately."
+  },
+  "method_guard": {
+    "zh": "构念护栏",
+    "en": "Construct guard"
+  },
+  "guard_principle": {
+    "zh": "",
+    "en": ""
+  }
+}

package/domains/_neutral/copy/section_titles.json

@@ -0,0 +1,66 @@
+{
+  "domain": "_neutral",
+  "section_titles": {
+    "zh": {},
+    "en": {}
+  },
+  "section_leads": {
+    "zh": {},
+    "en": {}
+  },
+  "default_chapters": [],
+  "brief_blocks": {
+    "zh": {
+      "decision": [
+        "先看结论",
+        "该不该做、把握多高、证据边界在哪里。"
+      ],
+      "lieflat": [
+        "实证图表画廊",
+        "按数据形状选型编排；数字均可溯源到 result.json。"
+      ],
+      "outcomes": [
+        "结果分离",
+        "不同构念的结果分开呈现；正向、负向与零效应分别编码。"
+      ],
+      "tribunal": [
+        "证据裁决",
+        "支持、不确定、被反驳与缺失证据分开放置。"
+      ],
+      "action": [
+        "从证据到行动",
+        "适用性、护栏、停止条件与评价连成可执行路径。"
+      ],
+      "sources": [
+        "关键来源",
+        "摘要页只列最关键来源；完整溯源在完整报告展开。"
+      ]
+    },
+    "en": {
+      "decision": [
+        "Start with the decision",
+        "Whether to act, how confident, and where the evidence stops."
+      ],
+      "lieflat": [
+        "Evidence figure gallery",
+        "Charts selected from the catalog; every number traces to result.json."
+      ],
+      "outcomes": [
+        "Outcome separation",
+        "Distinct constructs shown separately; positive, negative, and null effects encoded apart."
+      ],
+      "tribunal": [
+        "Evidence tribunal",
+        "Supported, uncertain, contradicted, and missing evidence kept apart."
+      ],
+      "action": [
+        "Evidence to action",
+        "Applicability, guardrails, stop rules, and evaluation as one path."
+      ],
+      "sources": [
+        "Key sources",
+        "Summary lists only critical sources; full provenance in the full report."
+      ]
+    }
+  }
+}

package/domains/_neutral/copy/terminology.json

@@ -0,0 +1,11 @@
+{
+  "domain": "_neutral",
+  "methodology_labels": {
+    "zh": {},
+    "en": {}
+  },
+  "field_labels": {
+    "zh": {},
+    "en": {}
+  }
+}

package/domains/check_copy_packs.py

@@ -0,0 +1,103 @@
+#!/usr/bin/env python3
+"""Assert domain copy packs stay in-domain.
+
+Requirement: the policy dictionary must not contain teaching vocabulary.
+Run: python3 domains/check_copy_packs.py
+Exit 0 = clean; exit 1 = violation (prints every hit).
+"""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+# Reuse the report-layer ban list so load-time and CLI checks cannot drift.
+sys.path.insert(0, str(Path(__file__).resolve().parents[1] / "visualization" / "eduevidence-report" / "scripts"))
+from report_copy_pack import load_copy_pack  # noqa: E402
+from report_copy_policy_guard import (  # noqa: E402
+    TEACHING_WORDS_EN,
+    TEACHING_WORDS_ZH,
+    assert_policy_copy_clean,
+)
+
+DOMAINS = Path(__file__).resolve().parent
+
+
+def _iter_strings(node, path="$"):
+    if isinstance(node, dict):
+        for key, value in node.items():
+            # Storage keys may be snake_case English (learning_metrics); the
+            # ban applies to reader-facing values.
+            yield from _iter_strings(value, f"{path}.{key}")
+    elif isinstance(node, list):
+        for index, value in enumerate(node):
+            yield from _iter_strings(value, f"{path}[{index}]")
+    elif isinstance(node, str):
+        yield path, node
+
+
+def load_pack(domain: str) -> dict:
+    return load_copy_pack(domain, strict=True)["files"]
+
+
+def find_teaching_hits(domain: str) -> list[str]:
+    pack = load_pack(domain)
+    hits: list[str] = []
+    for name, data in pack.items():
+        for path, text in _iter_strings(data):
+            for word in TEACHING_WORDS_ZH:
+                if word in text:
+                    hits.append(f"{domain}/{name} {path}: contains {word!r} in {text!r}")
+            lowered = text.lower()
+            for phrase in TEACHING_WORDS_EN:
+                if phrase.lower() in lowered:
+                    hits.append(f"{domain}/{name} {path}: contains {phrase!r} in {text!r}")
+    return hits
+
+
+def main() -> int:
+    failures = 0
+    # Hard requirement: policy dictionary free of teaching words.
+    try:
+        assert_policy_copy_clean(load_pack("policy"))
+        print("OK  policy copy pack: no teaching vocabulary")
+    except AssertionError as exc:
+        print(f"FAIL  {exc}")
+        failures += 1
+
+    # Soft inventory: education pack is expected to carry teaching voice.
+    edu_hits = find_teaching_hits("education")
+    print(f"INFO  education copy pack teaching-term hits: {len(edu_hits)}")
+
+    # Structural: every registered domain that has a copy/ dir is complete.
+    for domain_dir in sorted(DOMAINS.iterdir()):
+        if not domain_dir.is_dir() or domain_dir.name.startswith("_"):
+            continue
+        copy_dir = domain_dir / "copy"
+        if not copy_dir.is_dir():
+            continue
+        try:
+            pack = load_pack(domain_dir.name)
+        except FileNotFoundError as exc:
+            print(f"FAIL  {exc}")
+            failures += 1
+            continue
+        for name, data in pack.items():
+            if data.get("domain") != domain_dir.name:
+                print(f"FAIL  {domain_dir.name}/copy/{name}: domain field mismatch")
+                failures += 1
+        # four-state few-shots
+        states = set((pack.get("few_shots.json") or {}).get("states") or {})
+        required = {"adopt", "pilot", "reject", "insufficient_evidence"}
+        if not required <= states:
+            print(f"FAIL  {domain_dir.name}/copy/few_shots.json: missing states {sorted(required - states)}")
+            failures += 1
+
+    if failures:
+        print(f"FAILED ({failures} problem(s))")
+        return 1
+    print("ALL COPY PACK CHECKS PASSED")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/domains/education/copy/few_shots.json

@@ -0,0 +1,22 @@
+{
+  "domain": "education",
+  "purpose": "One written example per decision state (adopt / pilot / reject / insufficient_evidence), education voice.",
+  "states": {
+    "adopt": {
+      "zh": "延迟保持与迁移证据一致为正，独立后测无伤害信号 → 在目标课程中采用每周短时闭卷检索练习，并以统一延迟后测验收。",
+      "en": "Delayed retention and transfer evidence is consistently positive with no independent post-test harm → adopt weekly short closed-book retrieval practice in the target course, verified by a common delayed post-test."
+    },
+    "pilot": {
+      "zh": "任务表现证据强，但真实学习与保持证据不足或有护栏依赖 → 有界、分阶段、带独立后测的试点，而不是全面铺开。",
+      "en": "Task-performance evidence is strong, but independent learning and retention evidence is thin or guardrail-dependent → a bounded, phased pilot with independent post-tests rather than full rollout."
+    },
+    "reject": {
+      "zh": "无护栏使用已显示独立表现受损，且无补偿性学习收益证据 → 不建议采用，并明确替代方案的证据边界。",
+      "en": "Unguarded use already shows independent-performance harm with no compensatory learning gain → do not adopt, and state the evidence boundary of alternatives."
+    },
+    "insufficient_evidence": {
+      "zh": "现有研究未测量独立学习/保持/迁移，或人群与目标课程错位 → 证据不足，先补关键测量设计，再谈决策。",
+      "en": "Existing studies do not measure independent learning/retention/transfer, or the population mismatches the target course → insufficient evidence; fill the key measurement design before deciding."
+    }
+  }
+}