{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Cognitive Model Card",
  "description": "机器可读认知模型卡 schema。字段名使用英文，中文来源的字段值应保持中文。",
  "type": "object",
  "required": [
    "model_id",
    "model_name",
    "model_type",
    "pipeline_position",
    "one_sentence_definition",
    "core_question",
    "core_mechanism",
    "status",
    "source_articles",
    "source_evidence",
    "input_types",
    "output_types",
    "call_when",
    "do_not_call_when",
    "trigger_keywords",
    "negative_triggers",
    "related_models",
    "conflicting_models",
    "disciplinary_anchors",
    "common_misuses",
    "failure_modes",
    "selection_priority",
    "confidence_level",
    "stability_profile",
    "regression_status",
    "example_inputs",
    "example_outputs",
    "output_contract",
    "productization_notes",
    "version",
    "last_updated"
  ],
  "properties": {
    "model_id": {
      "type": "string",
      "description": "稳定机器 ID，供 JSON、证据、回归测试、selector 和索引引用。"
    },
    "model_name": {
      "type": "string",
      "description": "模型中文名称。"
    },
    "model_type": {
      "type": "string",
      "description": "模型类型。",
      "enum": [
        "routing_model",
        "deep_modeling_model",
        "lens_model",
        "diagnostic_model",
        "evaluation_model",
        "generation_model",
        "conflict_resolution_model",
        "stabilization_model"
      ]
    },
    "pipeline_position": {
      "type": "string",
      "description": "模型在处理流程中的位置。",
      "enum": [
        "pre_analysis",
        "analysis",
        "deep_analysis",
        "synthesis",
        "red_team",
        "evaluation",
        "post_processing"
      ]
    },
    "one_sentence_definition": {
      "type": "string",
      "description": "一句话定义模型的用途和边界。"
    },
    "core_question": {
      "type": "string",
      "description": "模型主要回答的核心问题。"
    },
    "core_mechanism": {
      "type": "string",
      "description": "模型的核心运作机制。"
    },
    "status": {
      "type": "string",
      "description": "模型资产状态。状态升级必须由 owner / ChatGPT / CCRA 明确决定，不能由验证脚本自动升级。",
      "enum": ["draft", "review", "reviewed", "callable", "stable", "archived", "deprecated", "draft_pre_contract"]
    },
    "source_articles": {
      "type": "array",
      "description": "引用的 source article ID 列表。",
      "items": {"type": "string"}
    },
    "source_evidence": {
      "type": "array",
      "description": "引用的 source excerpt ID 列表。",
      "items": {"type": "string"}
    },
    "input_types": {
      "type": "array",
      "description": "模型可接受的输入类型。",
      "items": {"type": "string"}
    },
    "output_types": {
      "type": "array",
      "description": "模型应产出的输出类型。",
      "items": {"type": "string"}
    },
    "call_when": {
      "type": "array",
      "description": "应调用该模型的场景。",
      "items": {"type": "string"}
    },
    "do_not_call_when": {
      "type": "array",
      "description": "不应调用该模型的场景。",
      "items": {"type": "string"}
    },
    "trigger_keywords": {
      "type": "array",
      "description": "提示可能调用该模型的关键词或表达。",
      "items": {"type": "string"}
    },
    "negative_triggers": {
      "type": "array",
      "description": "提示不应调用该模型的关键词或表达。",
      "items": {"type": "string"}
    },
    "related_models": {
      "type": "array",
      "description": "可前置、后置或并行调用的相关模型 ID。",
      "items": {"type": "string"}
    },
    "conflicting_models": {
      "type": "array",
      "description": "可能与该模型冲突或需要仲裁的模型 ID。",
      "items": {"type": "string"}
    },
    "disciplinary_anchors": {
      "type": "array",
      "description": "模型关联的学科、理论或知识底座。",
      "items": {"type": "string"}
    },
    "common_misuses": {
      "type": "array",
      "description": "常见误用方式。",
      "items": {"type": "string"}
    },
    "failure_modes": {
      "type": "array",
      "description": "调用失败或输出失稳的信号。",
      "items": {"type": "string"}
    },
    "selection_priority": {
      "type": "integer",
      "description": "selector 选择优先级，范围 1-10。",
      "minimum": 1,
      "maximum": 10
    },
    "confidence_level": {
      "type": "string",
      "description": "当前可信度等级。",
      "enum": ["high", "medium", "low"]
    },
    "stability_profile": {
      "type": "object",
      "description": "稳固性评估。",
      "required": [
        "stability_level",
        "needs_stabilization",
        "main_risks",
        "reason",
        "next_stabilization_action"
      ],
      "properties": {
        "stability_level": {
          "type": "string",
          "description": "稳固性等级。",
          "enum": ["A", "B", "C", "D"]
        },
        "needs_stabilization": {
          "type": "boolean",
          "description": "是否仍需要稳定化。"
        },
        "main_risks": {
          "type": "array",
          "description": "主要风险。",
          "items": {"type": "string"}
        },
        "reason": {
          "type": "string",
          "description": "当前稳固性评级理由。"
        },
        "next_stabilization_action": {
          "type": "string",
          "description": "下一步稳定化动作。"
        },
        "stabilization_notes": {
          "type": "string",
          "description": "其他稳定化说明。"
        }
      }
    },
    "regression_status": {
      "type": "string",
      "description": "回归测试状态。",
      "enum": [
        "not_started",
        "pending",
        "in_progress",
        "passed",
        "failed",
        "needs_rebuild"
      ]
    },
    "example_inputs": {
      "type": "array",
      "description": "示例输入。",
      "items": {"type": "string"}
    },
    "example_outputs": {
      "type": "array",
      "description": "示例输出。",
      "items": {"type": "string"}
    },
    "output_contract": {
      "type": "array",
      "description": "输出必须包含的结构或要素。",
      "items": {"type": "string"}
    },
    "structured_output_contract": {
      "type": "object",
      "description": "模型专属运行输出契约。该字段允许每个模型声明自己的 required runtime output fields；字段是否完整由本地 validator 的模型专属检查负责，不进入全局顶层 required。"
    },
    "depth_control": {
      "type": "object",
      "description": "深度控制、停止条件或过度调用警告。"
    },
    "stabilization_path": {
      "type": "array",
      "description": "稳定化路径。",
      "items": {"type": "string"}
    },
    "productization_notes": {
      "type": "string",
      "description": "产品化、selector、workflow 或集成说明。"
    },
    "version": {
      "type": "string",
      "description": "模型卡版本。"
    },
    "last_updated": {
      "type": "string",
      "description": "最后更新日期。"
    }
  }
}
