eduevidence 6.0.0 → 6.3.0

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."
+    }
+  }
+}

package/domains/education/copy/framing_enums.json

@@ -0,0 +1,167 @@
+{
+  "domain": "education",
+  "purpose": "education frame enum display labels (framing_lexicon part 2).",
+  "frame_enums": {
+    "zh": {
+      "teaching_decision": "教学决策",
+      "evidence_review": "证据评审",
+      "pilot_design": "试点设计",
+      "evaluation_design": "评价设计",
+      "undergraduate_year_1": "大学一年级",
+      "undergraduate_year_2": "大学二年级",
+      "undergraduate_year_3": "大学三年级",
+      "undergraduate_year_4": "大学四年级",
+      "postgraduate": "研究生",
+      "high_school": "高中",
+      "middle_school": "初中",
+      "primary_school": "小学",
+      "workplace_adult": "在职成人",
+      "computer_science": "计算机科学与技术",
+      "information_systems": "信息管理",
+      "software_engineering": "软件工程",
+      "data_science": "数据科学",
+      "mathematics": "数学",
+      "medicine": "医学",
+      "humanities": "人文",
+      "social_sciences": "社会科学",
+      "business": "商科",
+      "C_programming": "C 语言程序设计",
+      "introductory_programming": "程序设计入门",
+      "data_structures": "数据结构",
+      "algorithms": "算法",
+      "database_systems": "数据库系统",
+      "machine_learning": "机器学习",
+      "academic_writing": "学术写作",
+      "tesol": "英语教学",
+      "compulsory_core_course": "必修核心课程",
+      "elective_course": "选修课程",
+      "lecture_lab": "讲授 + 实验课",
+      "seminar": "研讨课",
+      "online_course": "在线课程",
+      "blended_learning": "混合式教学",
+      "professional_training": "职业培训",
+      "enterprise_customer_support": "企业客户支持",
+      "software_development": "软件开发",
+      "knowledge_work": "知识型工作",
+      "primary": "主要结果",
+      "secondary": "次要结果",
+      "risk": "风险结果",
+      "adopt": "采纳",
+      "modify": "修改",
+      "terminate": "终止",
+      "maintain": "维持",
+      "evaluate_impact": "评估影响",
+      "rct": "随机对照试验",
+      "quasi_experimental": "准实验",
+      "observational": "观察性研究",
+      "meta_analysis": "元分析",
+      "systematic_review": "系统综述",
+      "qualitative": "质性研究",
+      "mixed_methods": "混合方法",
+      "survey": "调查研究",
+      "case_study": "案例研究",
+      "literature_review": "文献综述",
+      "online": "线上",
+      "offline": "线下",
+      "hybrid": "混合",
+      "under_design_pending_evidence_review": "设计中（待证据评审）",
+      "human_supervised_customer_support_assistant": "人工监督的客服助手",
+      "approved_knowledge_base_and_agent_review": "已批准知识库 + 坐席复核",
+      "institutional_reform": "机构改革",
+      "enterprise_customer_support_staff": "企业客服人员",
+      "autonomous_agents_and_high_stakes_specialist_advice": "自主代理与高风险专业建议",
+      "lecture_with_lab_exercises": "讲授 + 实验练习",
+      "generative_ai_coding_assistant": "生成式 AI 编程助手",
+      "first_programming_course_no_prior_text_based_programming": "首次程序设计课程，无文本编程基础",
+      "mixed_ability_large_class_60_students": "混合能力大班（60 人）",
+      "weekly_lab_sessions": "每周实验课",
+      "one_semester": "一学期",
+      "16_weeks_one_semester": "16 周（一学期）",
+      "60_students": "60 名学生",
+      "TA_supported_two_TAs": "助教支持（2 名助教）",
+      "daily": "每日",
+      "weekly": "每周",
+      "monthly": "每月"
+    },
+    "en": {
+      "teaching_decision": "Teaching decision",
+      "evidence_review": "Evidence review",
+      "pilot_design": "Pilot design",
+      "evaluation_design": "Evaluation design",
+      "undergraduate_year_1": "First-year undergraduate",
+      "undergraduate_year_2": "Second-year undergraduate",
+      "undergraduate_year_3": "Third-year undergraduate",
+      "undergraduate_year_4": "Fourth-year undergraduate",
+      "postgraduate": "Postgraduate",
+      "high_school": "High school",
+      "middle_school": "Middle school",
+      "primary_school": "Primary school",
+      "workplace_adult": "Working adults",
+      "computer_science": "Computer science",
+      "information_systems": "Information systems",
+      "software_engineering": "Software engineering",
+      "data_science": "Data science",
+      "mathematics": "Mathematics",
+      "medicine": "Medicine",
+      "humanities": "Humanities",
+      "social_sciences": "Social sciences",
+      "business": "Business",
+      "C_programming": "C programming",
+      "introductory_programming": "Introductory programming",
+      "data_structures": "Data structures",
+      "algorithms": "Algorithms",
+      "database_systems": "Database systems",
+      "machine_learning": "Machine learning",
+      "academic_writing": "Academic writing",
+      "tesol": "TESOL",
+      "compulsory_core_course": "Compulsory core course",
+      "elective_course": "Elective course",
+      "lecture_lab": "Lecture + lab",
+      "seminar": "Seminar",
+      "online_course": "Online course",
+      "blended_learning": "Blended learning",
+      "professional_training": "Professional training",
+      "enterprise_customer_support": "Enterprise customer support",
+      "software_development": "Software development",
+      "knowledge_work": "Knowledge work",
+      "primary": "Primary outcomes",
+      "secondary": "Secondary outcomes",
+      "risk": "Risk outcomes",
+      "adopt": "Adopt",
+      "modify": "Modify",
+      "terminate": "Terminate",
+      "maintain": "Maintain",
+      "evaluate_impact": "Evaluate impact",
+      "rct": "Randomised controlled trial",
+      "quasi_experimental": "Quasi-experimental",
+      "observational": "Observational",
+      "meta_analysis": "Meta-analysis",
+      "systematic_review": "Systematic review",
+      "qualitative": "Qualitative",
+      "mixed_methods": "Mixed methods",
+      "survey": "Survey",
+      "case_study": "Case study",
+      "literature_review": "Literature review",
+      "online": "Online",
+      "offline": "Offline",
+      "hybrid": "Hybrid",
+      "under_design_pending_evidence_review": "Under design (pending evidence review)",
+      "approved_knowledge_base_and_agent_review": "Approved knowledge base + agent review",
+      "institutional_reform": "Institutional reform",
+      "enterprise_customer_support_staff": "Customer-support staff",
+      "autonomous_agents_and_high_stakes_specialist_advice": "Autonomous agents and high-stakes specialist advice",
+      "lecture_with_lab_exercises": "Lecture with lab exercises",
+      "generative_ai_coding_assistant": "Generative AI coding assistant",
+      "first_programming_course_no_prior_text_based_programming": "First programming course, no prior text-based programming",
+      "mixed_ability_large_class_60_students": "Mixed-ability large class (60 students)",
+      "weekly_lab_sessions": "Weekly lab sessions",
+      "one_semester": "One semester",
+      "16_weeks_one_semester": "16 weeks (one semester)",
+      "60_students": "60 students",
+      "TA_supported_two_TAs": "TA supported (2 TAs)",
+      "daily": "Daily",
+      "weekly": "Weekly",
+      "monthly": "Monthly"
+    }
+  }
+}

package/domains/education/copy/framing_lexicon.json

@@ -0,0 +1,166 @@
+{
+  "domain": "education",
+  "purpose": "education frame field/subfield labels (framing_lexicon part 1).",
+  "frame_fields": {
+    "zh": {
+      "question": "研究问题",
+      "decision_target": "决策目标",
+      "learner": "目标学习者",
+      "course": "课程情境",
+      "intervention": "AI 干预",
+      "comparison": "比较条件",
+      "outcomes": "结果构念",
+      "context": "研究情境",
+      "scope": "研究范围",
+      "success": "决策成功条件",
+      "success_condition": "决策成功条件",
+      "population": "目标人群",
+      "decision_object": "决策对象",
+      "stakeholders": "利益相关者"
+    },
+    "en": {
+      "question": "Research question",
+      "decision_target": "Decision target",
+      "learner": "Target learners",
+      "course": "Course context",
+      "intervention": "AI intervention",
+      "comparison": "Comparison",
+      "outcomes": "Outcome constructs",
+      "context": "Research context",
+      "scope": "Research scope",
+      "success": "Decision success condition",
+      "success_condition": "Decision success condition",
+      "population": "Target population",
+      "decision_object": "Decision object",
+      "stakeholders": "Stakeholders"
+    }
+  },
+  "frame_subfields": {
+    "zh": {
+      "learner": {
+        "education_level": "教育阶段",
+        "major": "专业",
+        "prior_knowledge": "先验知识",
+        "special_characteristics": "学习者特征"
+      },
+      "course": {
+        "subject": "课程",
+        "course_type": "课程类型",
+        "duration": "课程周期"
+      },
+      "intervention": {
+        "teaching_method": "干预方式",
+        "ai_tool": "AI 工具",
+        "allowed_usage": "允许使用",
+        "frequency": "使用频率",
+        "duration": "干预周期",
+        "policy_name": "政策名称",
+        "policy_type": "政策类型",
+        "jurisdiction": "适用辖区",
+        "mechanism": "作用机制"
+      },
+      "scope": {
+        "time_range": "时间范围",
+        "geography": "地域",
+        "study_types": "研究设计"
+      }
+    },
+    "en": {
+      "learner": {
+        "education_level": "Education level",
+        "major": "Major",
+        "prior_knowledge": "Prior knowledge",
+        "special_characteristics": "Learner characteristics"
+      },
+      "course": {
+        "subject": "Subject",
+        "course_type": "Course type",
+        "duration": "Duration"
+      },
+      "intervention": {
+        "teaching_method": "Method",
+        "ai_tool": "AI tool",
+        "allowed_usage": "Allowed usage",
+        "frequency": "Frequency",
+        "duration": "Duration",
+        "policy_name": "Policy",
+        "policy_type": "Policy type",
+        "jurisdiction": "Jurisdiction",
+        "mechanism": "Mechanism"
+      },
+      "scope": {
+        "time_range": "Time range",
+        "geography": "Geography",
+        "study_types": "Study designs"
+      }
+    }
+  },
+  "evidence_detail_labels": {
+    "zh": {
+      "study_id": "研究 ID",
+      "sample_id": "样本 ID",
+      "title": "研究标题",
+      "year": "年份",
+      "study_type": "研究设计",
+      "education_level": "教育阶段",
+      "population": "研究人群",
+      "sample_size": "样本量",
+      "intervention": "干预",
+      "comparison": "对照 / 比较条件",
+      "outcome_measure": "结果测量",
+      "claim": "完整主张",
+      "effect": "效应 / 结果",
+      "effect_direction": "效应方向",
+      "relation_to_claim": "与主张关系",
+      "duration": "干预时长",
+      "method": "方法",
+      "strengths": "优势",
+      "limitations": "局限",
+      "confounders": "混杂因素",
+      "quality_dimensions": "质量维度",
+      "quality_score": "质量分",
+      "evidence_level": "证据等级",
+      "directness": "直接性",
+      "applicability": "适用性",
+      "confidence": "置信度",
+      "status": "证据状态",
+      "source_location": "来源位置",
+      "source_title": "来源标题",
+      "source_url": "可验证链接",
+      "claim_id": "Claim ID"
+    },
+    "en": {
+      "study_id": "Study ID",
+      "sample_id": "Sample ID",
+      "title": "Study title",
+      "year": "Year",
+      "study_type": "Study design",
+      "education_level": "Education level",
+      "population": "Population",
+      "sample_size": "Sample size",
+      "intervention": "Intervention",
+      "comparison": "Comparison",
+      "outcome_measure": "Outcome measure",
+      "claim": "Full claim",
+      "effect": "Effect / result",
+      "effect_direction": "Effect direction",
+      "relation_to_claim": "Relation to claim",
+      "duration": "Duration",
+      "method": "Method",
+      "strengths": "Strengths",
+      "limitations": "Limitations",
+      "confounders": "Confounders",
+      "quality_dimensions": "Quality dimensions",
+      "quality_score": "Quality score",
+      "evidence_level": "Evidence level",
+      "directness": "Directness",
+      "applicability": "Applicability",
+      "confidence": "Confidence",
+      "status": "Evidence status",
+      "source_location": "Source location",
+      "source_title": "Source title",
+      "source_url": "Verifiable URL",
+      "claim_id": "Claim ID"
+    }
+  }
+}