eduevidence 5.2.0

package/schemas/report-spec.schema.json

@@ -0,0 +1,130 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://github.com/37chengshan/eduevidence/schemas/report-spec.schema.json",
+  "title": "ReportSpec",
+  "description": "report_spec.json — the Visualization Planner output (v5 方案 §9-10, §36). Declares sections and components from the frozen Component Catalog; the deterministic renderer turns it into HTML. No free-form DOM. 扩展字段一律放在各对象 extensions 内。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "title",
+    "theme",
+    "sections"
+  ],
+  "properties": {
+    "title": {
+      "type": "string"
+    },
+    "theme": {
+      "type": "string",
+      "enum": [
+        "claude",
+        "academic",
+        "datalab",
+        "datalab-dark",
+        "presentation"
+      ]
+    },
+    "mode": {
+      "type": "string",
+      "enum": [
+        "research",
+        "demo"
+      ],
+      "default": "research"
+    },
+    "generated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "sections": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "title",
+          "component"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "examples": [
+              "01-executive-decision"
+            ]
+          },
+          "title": {
+            "type": "string"
+          },
+          "component": {
+            "type": "string",
+            "enum": [
+              "ReportShell",
+              "Section",
+              "DecisionCard",
+              "ConfidenceBadge",
+              "OutcomeSummary",
+              "InteractiveChart",
+              "AcademicFigure",
+              "InfographicBlock",
+              "EvidenceMatrix",
+              "EvidenceRow",
+              "TribunalView",
+              "MethodologyPanel",
+              "ConflictCard",
+              "ClaimTrace",
+              "ApplicabilityCard",
+              "InterventionTimeline",
+              "EvaluationFlow",
+              "BenchmarkPanel",
+              "SourceList",
+              "ProvenancePanel",
+              "Footnote"
+            ]
+          },
+          "data_ref": {
+            "type": "string",
+            "description": "Pointer into result.json (e.g. 'decision', 'evidence', 'sources')."
+          },
+          "props": {
+            "type": "object",
+            "additionalProperties": true,
+            "description": "Component props (theme-agnostic)."
+          }
+        }
+      }
+    },
+    "charts": {
+      "type": "array",
+      "description": "Chart declarations (see chart-spec.schema.json).",
+      "items": {
+        "$ref": "chart-spec.schema.json"
+      }
+    },
+    "integrity": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Scientific Integrity Gate result (v5 方案 §27).",
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": [
+            "VALID",
+            "REPORT_INVALID"
+          ]
+        },
+        "checks": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "extensions": {
+      "type": "object",
+      "description": "结构化扩展字段的统一容器（P1-01）。未列入本 schema 的字段必须放在这里，禁止在顶层新增属性。",
+      "additionalProperties": true
+    }
+  }
+}

package/schemas/source.schema.json

@@ -0,0 +1,311 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://github.com/37chengshan/eduevidence/schemas/source.schema.json",
+  "title": "SourceObject",
+  "description": "Unified source registry entry (总体实施计划 §11 / v3 方案 §14). Evidence Objects reference only source_id. Fetch provider is a reading path, never the citation target. 扩展字段一律放在 extensions 内。",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "source_id",
+    "title",
+    "canonical_url",
+    "authority_level"
+  ],
+  "properties": {
+    "source_id": {
+      "type": "string",
+      "examples": [
+        "S-2023-kazemitabaar"
+      ]
+    },
+    "title": {
+      "type": "string"
+    },
+    "authors": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "year": {
+      "type": [
+        "integer",
+        "null"
+      ]
+    },
+    "doi": {
+      "type": "string",
+      "examples": [
+        "10.1145/3544548.3580919"
+      ]
+    },
+    "canonical_url": {
+      "type": "string",
+      "format": "uri"
+    },
+    "source_location": {
+      "type": "string",
+      "format": "uri",
+      "description": "Legacy alias of the canonical citation pointer (kept for backward compatibility)."
+    },
+    "source_type": {
+      "type": "string",
+      "enum": [
+        "paper",
+        "journal_article",
+        "conference_paper",
+        "report",
+        "institution_page",
+        "dataset",
+        "thesis",
+        "news",
+        "web_page",
+        "pdf",
+        "other"
+      ]
+    },
+    "authority_level": {
+      "type": "string",
+      "enum": [
+        "tier1_paper_doi",
+        "tier2_academic_database",
+        "tier3_professional_institution",
+        "tier4_news_secondary",
+        "tier5_general_web"
+      ],
+      "description": "学术来源优先级（v3 方案 §9）：Tier 1-5。fetch provider 不能提升此值。"
+    },
+    "discovered_by": {
+      "type": "string",
+      "examples": [
+        "scholar_search",
+        "web_search"
+      ]
+    },
+    "discovery_provider": {
+      "type": "string",
+      "examples": [
+        "SCP",
+        "Scholar-KG",
+        "bing"
+      ]
+    },
+    "source_locator": {
+      "type": "object",
+      "description": "精确定位引用内容在源中的位置（P1-03）。type/page/section/paragraph/quote_hash 均可选，但至少应能据此复核原文。",
+      "additionalProperties": false,
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "page",
+            "section",
+            "paragraph",
+            "quote",
+            "supplement",
+            "other"
+          ]
+        },
+        "page": {
+          "type": [
+            "string",
+            "integer",
+            "null"
+          ]
+        },
+        "section": {
+          "type": "string"
+        },
+        "paragraph": {
+          "type": [
+            "string",
+            "integer",
+            "null"
+          ]
+        },
+        "quote_hash": {
+          "type": "string",
+          "description": "SHA-256 或等价指纹，对引用的原文片段计算。"
+        }
+      }
+    },
+    "fetch": {
+      "$ref": "#/definitions/fetchProvenance"
+    },
+    "content_hash": {
+      "type": "string"
+    },
+    "dedupe_keys": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "去重键（v3 方案 §13）：canonical_url / doi / title fingerprint / content_hash",
+      "properties": {
+        "canonical_url": {
+          "type": "string"
+        },
+        "doi": {
+          "type": "string"
+        },
+        "title_fingerprint": {
+          "type": "string"
+        },
+        "content_hash": {
+          "type": "string"
+        }
+      }
+    },
+    "status": {
+      "type": "string",
+      "enum": [
+        "DISCOVERED",
+        "FETCHED",
+        "VALID",
+        "PARTIAL",
+        "FAILED",
+        "DUPLICATE",
+        "INVALID"
+      ]
+    },
+    "extensions": {
+      "type": "object",
+      "description": "结构化扩展字段的统一容器（P1-01）。未列入本 schema 的字段必须放在这里，禁止在顶层新增属性。",
+      "additionalProperties": true
+    },
+    "doi_verified": {
+      "type": "boolean",
+      "description": "True when the DOI resolved against Crossref/DataCite and the registered title matches (engine.citation_check)."
+    },
+    "retracted": {
+      "type": "boolean",
+      "description": "True when the registry marks this work as retracted."
+    }
+  },
+  "definitions": {
+    "fetchProvenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Fetch Provenance（v3 方案 §6，P1-06）：清洗服务只是读取路径，真正的证据来源仍是原始 URL/论文。fetch_status 必填：只有 FETCH_VALID（或规则确认的 FETCH_PARTIAL）可进入证据提取。",
+      "required": [
+        "fetch_status"
+      ],
+      "properties": {
+        "original_url": {
+          "type": "string",
+          "format": "uri"
+        },
+        "resolved_url": {
+          "type": "string",
+          "format": "uri"
+        },
+        "fetch_method": {
+          "type": "string",
+          "enum": [
+            "native",
+            "smart_web_fetch"
+          ]
+        },
+        "fetch_provider": {
+          "type": "string",
+          "enum": [
+            "builtin",
+            "jina_reader",
+            "markdown_new",
+            "defuddle",
+            "raw_html",
+            "pdf_parser"
+          ]
+        },
+        "fetch_status": {
+          "type": "string",
+          "enum": [
+            "FETCH_VALID",
+            "FETCH_PARTIAL",
+            "FETCH_FAILED"
+          ]
+        },
+        "fetched_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "content_hash": {
+          "type": "string"
+        },
+        "content_length": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "raw_size": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "clean_size": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "compression_ratio": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1
+        },
+        "fallback_used": {
+          "type": "boolean",
+          "default": false
+        },
+        "fallback_chain": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "实际尝试过的 provider 降级链（按顺序）。"
+        },
+        "content": {
+          "type": "string",
+          "description": "清洗后的正文（Markdown/文本），仅 FETCH_VALID/PARTIAL 时携带。"
+        },
+        "status_code": {
+          "type": "integer",
+          "description": "最终响应 HTTP 状态码（含 redirect 后）。"
+        },
+        "content_type": {
+          "type": "string",
+          "description": "最终响应的 Content-Type，如 text/html; charset=utf-8、application/pdf。"
+        },
+        "charset": {
+          "type": "string"
+        },
+        "response_headers": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          },
+          "description": "最终响应头（供审计，不参与证据判断）。"
+        },
+        "validation": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Fetch Validation Gate 结果（validate_fetch_result 输出）。",
+          "properties": {
+            "passed": {
+              "type": "boolean"
+            },
+            "checks": {
+              "type": "object",
+              "additionalProperties": {
+                "type": [
+                  "boolean",
+                  "null"
+                ]
+              }
+            },
+            "issues": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/v2/analysis-plan.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://eduevidence.dev/schemas/v2/analysis-plan.schema.json",
+  "title": "AnalysisPlan",
+  "description": "Separately versioned analysis plan owning design_id (the StudyDesign does NOT reference the plan, avoiding a circular Design↔AnalysisPlan reference).",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "analysis_plan_id", "design_id", "dataset_ids", "primary_analysis",
+    "secondary_analyses", "assumption_checks", "preregistered",
+    "created_at", "extensions"
+  ],
+  "properties": {
+    "analysis_plan_id": { "type": "string", "pattern": "^APL-" },
+    "design_id": { "type": "string", "pattern": "^DSN-" },
+    "dataset_ids": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^DAT-" },
+      "uniqueItems": true
+    },
+    "primary_analysis": { "type": "string", "minLength": 1 },
+    "secondary_analyses": { "type": "array", "items": { "type": "string" } },
+    "assumption_checks": { "type": "array", "items": { "type": "string" } },
+    "preregistered": { "type": "boolean" },
+    "created_at": { "type": "string", "format": "date-time" },
+    "extensions": { "type": "object" }
+  }
+}

package/schemas/v2/analysis-run.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://eduevidence.dev/schemas/v2/analysis-run.schema.json",
+  "title": "AnalysisRun",
+  "description": "One auditable analysis execution. Advanced results enter only with explicit provider/software/parameter provenance; Native Core never fabricates p-values or effect estimates it cannot compute.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "analysis_run_id", "analysis_plan_id", "dataset_ids", "status",
+    "outputs", "assumption_checks", "created_at", "extensions"
+  ],
+  "properties": {
+    "analysis_run_id": { "type": "string", "pattern": "^ANL-" },
+    "analysis_plan_id": { "type": "string", "pattern": "^APL-" },
+    "dataset_ids": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^DAT-" },
+      "uniqueItems": true
+    },
+    "status": { "type": "string", "enum": ["completed", "validated", "failed", "capability_unavailable"] },
+    "outputs": { "type": "object" },
+    "assumption_checks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": true,
+        "required": ["check", "result"]
+      }
+    },
+    "created_at": { "type": "string", "format": "date-time" },
+    "extensions": { "type": "object" }
+  }
+}

package/schemas/v2/claim.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://eduevidence.dev/schemas/v2/claim.schema.json",
+  "title": "Claim",
+  "description": "A project-local interpretive statement. Claims keep stable Project-local IDs across edits; supersession is recorded via status, never silent re-identification.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "claim_id", "text", "claim_type", "primary_outcome_ids", "scope",
+    "created_in_revision", "status", "extensions"
+  ],
+  "properties": {
+    "claim_id": { "type": "string", "pattern": "^(CLM-|C-)" },
+    "text": { "type": "string", "minLength": 1 },
+    "claim_type": { "type": "string", "minLength": 1 },
+    "primary_outcome_ids": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^OUT-" },
+      "uniqueItems": true
+    },
+    "scope": { "type": "string", "minLength": 1 },
+    "created_in_revision": { "type": "integer", "minimum": 1 },
+    "status": { "type": "string", "enum": ["active", "superseded", "retired"] },
+    "extensions": { "type": "object" }
+  }
+}

package/schemas/v2/dataset-asset.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://eduevidence.dev/schemas/v2/dataset-asset.schema.json",
+  "title": "DatasetAsset",
+  "description": "Immutable project dataset asset. Raw bytes are copied once into datasets/raw/ and hashed; raw user data is never inserted into the Shared Research Library. Project datasets are Project-private by default.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "dataset_id", "project_id", "design_id", "source_type",
+    "path", "content_hash", "schema_summary", "row_count", "column_count",
+    "variable_dictionary", "privacy_classification", "consent_metadata",
+    "deidentification_status", "created_at", "extensions"
+  ],
+  "properties": {
+    "dataset_id": { "type": "string", "pattern": "^DAT-" },
+    "project_id": { "type": "string", "pattern": "^PRJ-" },
+    "design_id": { "type": "string", "pattern": "^DSN-" },
+    "source_type": { "type": "string", "minLength": 1 },
+    "path": { "type": "string", "minLength": 1 },
+    "content_hash": { "type": "string", "minLength": 1 },
+    "schema_summary": { "type": "object" },
+    "row_count": { "type": ["integer", "null"], "minimum": 0 },
+    "column_count": { "type": ["integer", "null"], "minimum": 0 },
+    "variable_dictionary": {
+      "type": ["object", "null"],
+      "additionalProperties": { "type": "string" }
+    },
+    "privacy_classification": {
+      "type": "string",
+      "enum": ["public", "internal", "confidential", "restricted"]
+    },
+    "consent_metadata": { "type": ["object", "null"] },
+    "deidentification_status": {
+      "type": "string",
+      "enum": ["not_done", "in_progress", "done", "not_required"]
+    },
+    "created_at": { "type": "string", "format": "date-time" },
+    "extensions": { "type": "object" }
+  }
+}

package/schemas/v2/decision-snapshot.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://eduevidence.dev/schemas/v2/decision-snapshot.schema.json",
+  "title": "DecisionSnapshot",
+  "description": "A revision-bound adjudication. Snapshots are immutable: changing the graph later never mutates an old snapshot file.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "decision_snapshot_id", "decision", "confidence_label",
+    "confidence_score_internal", "claim_assessments", "key_evidence_links",
+    "key_risks", "applicability_boundary", "missing_evidence",
+    "graph_revision", "policy_versions", "created_at", "extensions"
+  ],
+  "properties": {
+    "decision_snapshot_id": { "type": "string", "pattern": "^DEC-" },
+    "decision": {
+      "type": "string",
+      "enum": ["ADOPT", "PILOT", "REJECT", "INSUFFICIENT_EVIDENCE"]
+    },
+    "confidence_label": {
+      "type": "string",
+      "enum": ["High", "Moderate", "Low", "Insufficient"]
+    },
+    "confidence_score_internal": { "type": "number", "minimum": 0, "maximum": 1 },
+    "claim_assessments": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": true
+      }
+    },
+    "key_evidence_links": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "key_risks": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "applicability_boundary": { "type": "string", "minLength": 1 },
+    "missing_evidence": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "graph_revision": { "type": "integer", "minimum": 1 },
+    "policy_versions": {
+      "type": "object",
+      "additionalProperties": { "type": "string" }
+    },
+    "created_at": { "type": "string", "format": "date-time" },
+    "extensions": { "type": "object" }
+  }
+}

package/schemas/v2/evidence-link.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://eduevidence.dev/schemas/v2/evidence-link.schema.json",
+  "title": "EvidenceLink",
+  "description": "The contextual interpretation connecting a Finding to a Claim. relation_to_claim (does this result support the Claim?) and decision_implication (what does it mean for the current decision?) are strictly separate semantics.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "evidence_link_id", "finding_id", "claim_id", "relation_to_claim",
+    "decision_implication", "directness", "applicability",
+    "reasoning_note", "created_in_revision", "extensions"
+  ],
+  "properties": {
+    "evidence_link_id": { "type": "string", "pattern": "^LNK-" },
+    "finding_id": { "type": "string", "pattern": "^FND-" },
+    "claim_id": { "type": "string", "pattern": "^(CLM-|C-)" },
+    "relation_to_claim": { "type": "string", "enum": ["support", "contradict", "neutral"] },
+    "decision_implication": {
+      "type": "string",
+      "enum": ["support_adoption", "oppose_adoption", "conditional", "neutral"]
+    },
+    "directness": { "type": "integer", "minimum": 0, "maximum": 2 },
+    "applicability": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["scope_match"],
+      "properties": {
+        "scope_match": { "type": "string", "enum": ["direct", "partial", "mismatch"] },
+        "target_population": { "type": "string" },
+        "context_notes": { "type": "string" },
+        "extensions": { "type": "object" }
+      }
+    },
+    "reasoning_note": { "type": "string", "minLength": 1 },
+    "created_in_revision": { "type": "integer", "minimum": 1 },
+    "extensions": { "type": "object" }
+  }
+}