eduevidence 6.0.0 → 6.3.0

package/domains/policy/copy/framing_lexicon.json

@@ -0,0 +1,174 @@
+{
+  "domain": "policy",
+  "purpose": "policy frame field/subfield labels (framing_lexicon part 1).",
+  "frame_fields": {
+    "zh": {
+      "question": "研究问题",
+      "decision_object": "决策对象",
+      "intervention": "干预方案",
+      "population": "目标人群",
+      "stakeholders": "利益相关者",
+      "outcomes": "结果构念",
+      "context": "政策情境",
+      "scope": "研究范围",
+      "comparison": "比较条件",
+      "success": "决策成功条件",
+      "success_condition": "决策成功条件",
+      "learner": "目标人群",
+      "course": "适用情境"
+    },
+    "en": {
+      "question": "Research question",
+      "decision_object": "Decision object",
+      "intervention": "Intervention plan",
+      "population": "Target population",
+      "stakeholders": "Stakeholders",
+      "outcomes": "Outcome constructs",
+      "context": "Policy context",
+      "scope": "Research scope",
+      "comparison": "Comparison",
+      "success": "Decision success condition",
+      "success_condition": "Decision success condition",
+      "learner": "Target population",
+      "course": "Operating context"
+    }
+  },
+  "frame_subfields": {
+    "zh": {
+      "learner": {
+        "education_level": "覆盖层级",
+        "major": "岗位序列",
+        "prior_knowledge": "先验经验",
+        "special_characteristics": "人群特征"
+      },
+      "course": {
+        "subject": "业务域",
+        "course_type": "组织形态",
+        "duration": "实施周期"
+      },
+      "intervention": {
+        "teaching_method": "干预方式",
+        "ai_tool": "技术工具",
+        "allowed_usage": "允许使用",
+        "frequency": "使用频率",
+        "duration": "干预周期",
+        "policy_name": "政策名称",
+        "policy_type": "政策类型",
+        "jurisdiction": "适用辖区",
+        "mechanism": "作用机制"
+      },
+      "population": {
+        "definition": "人群定义",
+        "size": "覆盖规模",
+        "vulnerability": "脆弱性"
+      },
+      "scope": {
+        "time_range": "时间范围",
+        "geography": "地域",
+        "study_types": "研究设计"
+      }
+    },
+    "en": {
+      "learner": {
+        "education_level": "Coverage level",
+        "major": "Role track",
+        "prior_knowledge": "Prior experience",
+        "special_characteristics": "Population characteristics"
+      },
+      "course": {
+        "subject": "Domain",
+        "course_type": "Organisation type",
+        "duration": "Rollout window"
+      },
+      "intervention": {
+        "teaching_method": "Method",
+        "ai_tool": "Technology",
+        "allowed_usage": "Allowed usage",
+        "frequency": "Frequency",
+        "duration": "Duration",
+        "policy_name": "Policy",
+        "policy_type": "Policy type",
+        "jurisdiction": "Jurisdiction",
+        "mechanism": "Mechanism"
+      },
+      "population": {
+        "definition": "Definition",
+        "size": "Scale",
+        "vulnerability": "Vulnerability"
+      },
+      "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": "Coverage level",
+      "population": "Population",
+      "sample_size": "Sample size",
+      "intervention": "Intervention plan",
+      "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"
+    }
+  }
+}

package/domains/policy/copy/module_labels.json

@@ -0,0 +1,168 @@
+{
+  "domain": "policy",
+  "purpose": "Domain-sensitive module/UI labels (policy voice). target_learners displays as 目标人群; intervention is 干预方案.",
+  "labels": {
+    "outcome_separation_title": {
+      "zh": "结果分离 · 过程产出 ≠ 政策效果",
+      "en": "Outcome Separation · Process output ≠ policy effect"
+    },
+    "outcome_sep_note": {
+      "zh": "将不同结果类型分开裁决，避免把试点期产出或效率提升直接等同于真实政策效果。",
+      "en": "Outcomes are adjudicated separately so pilot throughput or efficiency gains are not silently treated as real policy effects."
+    },
+    "outcome_group_task": {
+      "zh": "过程 / 近端产出",
+      "en": "Process / proximal output"
+    },
+    "outcome_group_learning": {
+      "zh": "效果 / 目标结果",
+      "en": "Effect / target outcome"
+    },
+    "outcome_group_risk": {
+      "zh": "风险 / 实施风险",
+      "en": "Risk / implementation risk"
+    },
+    "outcome_group_other": {
+      "zh": "其他结果",
+      "en": "Other outcomes"
+    },
+    "method_guard": {
+      "zh": "产出 vs 效果护栏",
+      "en": "Output vs effect guard"
+    },
+    "applicability": {
+      "zh": [
+        "适用于谁",
+        "适用辖区",
+        "适用结果",
+        "适用条件",
+        "目标人群",
+        "目标情境"
+      ],
+      "en": [
+        "Suitable for",
+        "Jurisdiction",
+        "Outcomes",
+        "Conditions",
+        "Target population",
+        "Target context"
+      ]
+    },
+    "intervention_learners": {
+      "zh": "目标人群",
+      "en": "Target population"
+    },
+    "intervention_population": {
+      "zh": "目标人群",
+      "en": "Target population"
+    },
+    "intervention_duration": {
+      "zh": "试点时长",
+      "en": "Pilot duration"
+    },
+    "intervention_policy": {
+      "zh": "干预使用规则",
+      "en": "Intervention usage policy"
+    },
+    "intervention_rule": {
+      "zh": "干预规则",
+      "en": "Intervention rule"
+    },
+    "intervention_activities": {
+      "zh": "活动",
+      "en": "Activities"
+    },
+    "intervention_check": {
+      "zh": "结果检查",
+      "en": "Outcome check"
+    },
+    "intervention_stop": {
+      "zh": "停止条件",
+      "en": "Stop conditions"
+    },
+    "intervention_timeline": {
+      "zh": "干预方案时间线信息图",
+      "en": "Intervention plan timeline infographic"
+    },
+    "evaluation_measures": {
+      "zh": [
+        "基线",
+        "试点结束",
+        "持续监测",
+        "扩展评估"
+      ],
+      "en": [
+        "Baseline",
+        "Pilot end",
+        "Durability",
+        "Scale-out"
+      ]
+    },
+    "evaluation_metrics": {
+      "zh": [
+        "过程指标",
+        "效果指标",
+        "风险指标"
+      ],
+      "en": [
+        "Process metrics",
+        "Effect metrics",
+        "Risk metrics"
+      ]
+    },
+    "evaluation_question": {
+      "zh": "研究问题",
+      "en": "Research question"
+    },
+    "evaluation_threshold": {
+      "zh": "成功阈值",
+      "en": "Success threshold"
+    },
+    "evaluation_plan": {
+      "zh": "分析计划",
+      "en": "Analysis plan"
+    },
+    "evaluation_figure": {
+      "zh": "评价设计信息图",
+      "en": "Evaluation design infographic"
+    },
+    "svg_intervention_title": {
+      "zh": "干预方案时间线",
+      "en": "Intervention plan timeline"
+    },
+    "svg_intervention_desc": {
+      "zh": "各试点阶段的短名称与活动数量；完整干预使用规则见阶段说明块。",
+      "en": "Short phase names and activity counts; full intervention usage rules are in the phase blocks."
+    },
+    "svg_evaluation_title": {
+      "zh": "评价设计流程",
+      "en": "Evaluation design flow"
+    },
+    "svg_evaluation_desc": {
+      "zh": "基线、试点结束、持续监测与扩展评估的评价流程；完整指标与分析计划见评估章节。",
+      "en": "Evaluation flow across baseline, pilot end, durability and scale-out; full metrics and analysis plan are in the evaluation section."
+    },
+    "svg_workflow_desc": {
+      "zh": "从问题框架、检索、抓取验证、证据抽取、反方质疑、方法审计、裁决到适用性与干预评价的完整流程。",
+      "en": "Research flow from framing, retrieval, fetch/verify, extraction, challenge, method audit and adjudication to applicability and intervention evaluation."
+    },
+    "decision_kpi": {
+      "zh": [
+        "决策",
+        "置信度",
+        "证据最充分的结果",
+        "最不确定的结果",
+        "主要风险",
+        "来源数量"
+      ],
+      "en": [
+        "Decision",
+        "Confidence",
+        "Best-supported outcome",
+        "Most uncertain outcome",
+        "Main risk",
+        "Sources"
+      ]
+    }
+  }
+}

package/domains/policy/copy/risk_constructs.json

@@ -0,0 +1,33 @@
+{
+  "domain": "policy",
+  "purpose": "Outcome grouping + separation guard constructs (process output is not policy effect). No teaching vocabulary.",
+  "outcome_groups": {
+    "task": [
+      "cost_effectiveness",
+      "feasibility"
+    ],
+    "learning": [
+      "policy_effectiveness",
+      "equity"
+    ],
+    "risk": [
+      "implementation_risk"
+    ]
+  },
+  "separation_title": {
+    "zh": "结果分离 · 过程产出 ≠ 政策效果",
+    "en": "Outcome Separation · Process output ≠ policy effect"
+  },
+  "separation_note": {
+    "zh": "将不同结果类型分开裁决，避免把试点期产出或效率提升直接等同于真实政策效果。",
+    "en": "Outcomes are adjudicated separately so pilot throughput or efficiency gains are not silently treated as real policy effects."
+  },
+  "method_guard": {
+    "zh": "产出 vs 效果护栏",
+    "en": "Output vs effect guard"
+  },
+  "guard_principle": {
+    "zh": "过程产出提升 ≠ 政策效果实现；ADOPT 需要独立效果、持续性与公平证据。",
+    "en": "Process output is not policy effect; ADOPT requires independent effect, durability and equity evidence."
+  }
+}

package/domains/policy/copy/section_titles.json

@@ -0,0 +1,186 @@
+{
+  "domain": "policy",
+  "purpose": "Section titles/leads + default full-report chapter plan (policy voice; no teaching vocabulary).",
+  "section_titles": {
+    "zh": {
+      "01": "01 执行决策",
+      "02": "02 结果证据概览",
+      "03": "03 证据矩阵",
+      "04": "04 证据裁决",
+      "05": "05 方法学审计",
+      "06": "06 冲突分析",
+      "07": "07 主张-证据追溯",
+      "08": "08 适用性",
+      "09": "09 干预方案",
+      "10": "10 评价方案",
+      "11": "11 基准测试",
+      "12": "12 来源与溯源"
+    },
+    "en": {
+      "01": "01 Executive Decision",
+      "02": "02 Outcome Evidence Overview",
+      "03": "03 Evidence Matrix",
+      "04": "04 Evidence Tribunal",
+      "05": "05 Methodology Audit",
+      "06": "06 Conflict Analysis",
+      "07": "07 Claim-Evidence Trace",
+      "08": "08 Applicability",
+      "09": "09 Intervention Plan",
+      "10": "10 Evaluation Plan",
+      "11": "11 Benchmark",
+      "12": "12 Sources & Provenance"
+    }
+  },
+  "section_leads": {
+    "zh": {
+      "01": "本节先给结论：最终怎么裁决、置信度多高、靠哪几条证据。",
+      "02": "一图看清：哪些政策效果有支持证据、哪些被反驳。",
+      "03": "每条证据来自哪项研究、测了什么、方向与质量如何；可筛选、可搜索。",
+      "04": "证据允许主张什么、不允许主张什么；缺失的关键证据是什么。",
+      "05": "研究质量可靠吗？哪些方法学问题让结论打折。",
+      "06": "不同研究为何结论不同；分歧出在哪一环。",
+      "07": "从结论到证据到原始来源，每一步都可追查。",
+      "08": "结论适用于谁、什么人群与效果、需要什么条件。",
+      "09": "试点怎么分阶段放开干预规则；什么情况必须叫停。",
+      "10": "如何验证效果：指标、对照、成功阈值。",
+      "11": "EduEvidence 自身基准表现：引用精度与成本。",
+      "12": "每篇文献是谁、出自哪里、如何获取。"
+    },
+    "en": {
+      "01": "The verdict first: what we decide, at what confidence, on which evidence.",
+      "02": "At a glance: which policy outcomes have supporting evidence, which are contradicted.",
+      "03": "Where each piece of evidence comes from, what it measures, its direction and quality — filterable and searchable.",
+      "04": "What the evidence lets us claim, what it does not, and what is still missing.",
+      "05": "How reliable are these studies, and which methodological concerns discount the conclusions.",
+      "06": "Why studies disagree — and where exactly they diverge.",
+      "07": "Every step from conclusion to evidence to source stays traceable.",
+      "08": "Who the conclusion applies to, for which population and outcomes, under what conditions.",
+      "09": "How intervention rules phase in during a pilot, and when we must stop.",
+      "10": "How we verify real effects: metrics, comparison, success threshold.",
+      "11": "How EduEvidence itself performs: citation precision and cost.",
+      "12": "Who wrote each cited study, where it came from, how it was fetched."
+    }
+  },
+  "default_chapters": [
+    {
+      "key": "decision",
+      "title_zh": "结论、裁决与研究边界",
+      "title_en": "Decision, Adjudication & Research Boundary",
+      "lead_zh": "先明确最终裁决与研究边界，再解释为什么。",
+      "lead_en": "State the final adjudication and research boundary before explaining why.",
+      "modules": [
+        "decision",
+        "scope"
+      ]
+    },
+    {
+      "key": "evidence",
+      "title_zh": "关键证据与结果分离",
+      "title_en": "Key Evidence & Outcome Separation",
+      "lead_zh": "把过程产出、真实效果、持续性与风险放在同一证据地图中，但不混为一谈。",
+      "lead_en": "Place process outputs, real effects, durability and risk on one evidence map without conflating them.",
+      "modules": [
+        "retrieval",
+        "outcomes",
+        "evidence"
+      ]
+    },
+    {
+      "key": "quality",
+      "title_zh": "证据可信度、反证与方法审计",
+      "title_en": "Evidence Quality, Counterevidence & Method Audit",
+      "lead_zh": "检查证据为什么可信、哪里冲突，以及哪些结论必须降级。",
+      "lead_en": "Examine why evidence is credible, where it conflicts, and which conclusions require downgrading.",
+      "modules": [
+        "quality",
+        "conflicts",
+        "trace"
+      ]
+    },
+    {
+      "key": "action",
+      "title_zh": "适用范围与政策行动",
+      "title_en": "Applicability & Policy Action",
+      "lead_zh": "把可外推范围、护栏和政策动作连接到具体证据。",
+      "lead_en": "Connect applicability, guardrails and policy actions to specific evidence.",
+      "modules": [
+        "applicability",
+        "intervention"
+      ]
+    },
+    {
+      "key": "evaluation",
+      "title_zh": "试点设计、评估与停止条件",
+      "title_en": "Pilot, Evaluation & Stop Conditions",
+      "lead_zh": "用独立效果测量验证试点，并预先写清停止条件。",
+      "lead_en": "Validate the pilot with independent effect measures and pre-specified stop conditions.",
+      "modules": [
+        "evaluation"
+      ]
+    },
+    {
+      "key": "sources",
+      "title_zh": "来源、溯源与附录",
+      "title_en": "Sources, Traceability & Appendix",
+      "lead_zh": "保留原始来源、URL、证据 ID 和获取信息，确保可回查。",
+      "lead_en": "Preserve original sources, URLs, evidence IDs and retrieval metadata for auditability.",
+      "modules": [
+        "sources"
+      ]
+    }
+  ],
+  "brief_blocks": {
+    "zh": {
+      "decision": [
+        "先看结论",
+        "该不该做、置信度多高、最关键的证据边界在哪。"
+      ],
+      "lieflat": [
+        "Lieflat 实证手作画廊",
+        "AI 按数据形状从 Lieflat 目录选型编排；每张图的数字都可溯源到 result.json。"
+      ],
+      "outcomes": [
+        "过程产出 ≠ 政策效果",
+        "只展示真正有解释力的结果分离；正向、负向与零效应按 effect_direction 编码。"
+      ],
+      "tribunal": [
+        "证据裁决",
+        "支持、不确定、被反驳与缺失证据分开放置，不把长段落平铺在同一层。"
+      ],
+      "action": [
+        "从证据到行动",
+        "适用性、护栏、停止条件与评价连成一条可执行路径。"
+      ],
+      "sources": [
+        "关键来源",
+        "摘要页只列最关键的来源；完整溯源在完整报告中展开。"
+      ]
+    },
+    "en": {
+      "decision": [
+        "Decision first",
+        "What to do, how confident we are, and the most important evidence boundary."
+      ],
+      "lieflat": [
+        "Lieflat Editorial Gallery",
+        "Charts selected and composed by AI from the Lieflat catalog; every number traces back to result.json."
+      ],
+      "outcomes": [
+        "Process output ≠ policy effect",
+        "Only informative outcome separation; positive, negative and null effects use effect_direction."
+      ],
+      "tribunal": [
+        "Evidence tribunal",
+        "Supported, uncertain, contradicted and missing evidence stay separated instead of flattened into long prose."
+      ],
+      "action": [
+        "Evidence to action",
+        "Applicability, guardrails, stop conditions and evaluation form one executable path."
+      ],
+      "sources": [
+        "Key sources",
+        "Only the key sources in the brief; full traceability expands in the full report."
+      ]
+    }
+  }
+}

package/domains/policy/copy/terminology.json

@@ -0,0 +1,64 @@
+{
+  "domain": "policy",
+  "purpose": "Domain terminology (policy voice). target_learners → 目标人群; intervention → 干预方案; no teaching vocabulary.",
+  "methodology_labels": {
+    "zh": {
+      "evidence_level": "证据等级",
+      "causal_identification": "因果识别",
+      "external_validity": "外部效度",
+      "cost_evidence": "成本证据",
+      "stakeholder_representation": "利益相关者代表",
+      "implementation_evidence": "实施证据",
+      "equity_analysis": "公平性分析",
+      "effect_size_reported": "效应量报告",
+      "uncertainty_quantified": "不确定性量化",
+      "comparator_clarity": "对照与反事实清晰",
+      "publication_bias_risk": "发表偏倚风险",
+      "generalizability_claims": "可推广性声明"
+    },
+    "en": {
+      "evidence_level": "Evidence level",
+      "causal_identification": "Causal identification",
+      "external_validity": "External validity",
+      "cost_evidence": "Cost evidence",
+      "stakeholder_representation": "Stakeholder representation",
+      "implementation_evidence": "Implementation evidence",
+      "equity_analysis": "Equity analysis",
+      "effect_size_reported": "Effect size reported",
+      "uncertainty_quantified": "Uncertainty quantified",
+      "comparator_clarity": "Comparator clarity",
+      "publication_bias_risk": "Publication-bias risk",
+      "generalizability_claims": "Generalizability claims"
+    }
+  },
+  "field_labels": {
+    "zh": {
+      "target_learners": "目标人群",
+      "target_population": "目标人群",
+      "ai_usage_policy": "干预使用规则",
+      "ai_usage_rule": "干预规则",
+      "task_vs_learning_guard": "产出 vs 效果护栏",
+      "learning_metrics": "效果指标",
+      "process_metrics": "过程指标",
+      "risk_metrics": "风险指标",
+      "task_performance": "过程产出",
+      "learning_gain": "目标效果",
+      "retention": "持续性",
+      "transfer": "扩散效果"
+    },
+    "en": {
+      "target_learners": "Target population",
+      "target_population": "Target population",
+      "ai_usage_policy": "Intervention usage policy",
+      "ai_usage_rule": "Intervention rule",
+      "task_vs_learning_guard": "Output vs effect guard",
+      "learning_metrics": "Effect metrics",
+      "process_metrics": "Process metrics",
+      "risk_metrics": "Risk metrics",
+      "task_performance": "Process output",
+      "learning_gain": "Target effect",
+      "retention": "Durability",
+      "transfer": "Spillover"
+    }
+  }
+}

package/eduevidence_cli.py

@@ -8,6 +8,16 @@ only two intercepted command domains:
     eduevidence evolve ...
 """
 import sys
+
+MIN_PYTHON = (3, 10)
+
+if sys.version_info < MIN_PYTHON:
+    import platform
+    sys.stderr.write(
+        f"EduEvidence requires Python {MIN_PYTHON[0]}.{MIN_PYTHON[1]} or newer; "
+        f"this interpreter is {platform.python_version()}.\n"
+        "Install a supported Python and re-run, or set PYTHON to one.\n")
+    raise SystemExit(2)
 from pathlib import Path
 
 ROOT = Path(__file__).resolve().parent