{"openapi":"3.1.0","info":{"title":"四家照见知识库 · FFCKK Runtime API","version":"1.1.0","description":"四家照见知识库（FFCKK，Fourfold Classics Knowledge Kernel）V1.1 Context Understanding & Illumination Engine：/api/classics/v1/illuminate（Context→Question Focus→四家照见→共识差异→照见 Insight→反思/行动，protocol=FFCKK-Illumination-1.1）+ V1.0 Trusted Knowledge Protocol（/trusted-query，Evidence→Trust→Expression，protocol=FFCKK-TKP-1.0）。延续 V0.9 Knowledge Evolution Engine（已获生产授权）+ V0.8 Discovery + V0.7 演化治理 + V0.6 智能编排 + V0.5 统一 Knowledge Runtime + Graph API V3 + Runtime 遥测。只读知识服务；不预测、不起卦、不用经典替代专业服务；Gate 对全部路由经典生效；治理写操作需 X-Actor 头（AI/system 被拒）。"},"servers":[{"url":"https://ffckk.halfwaylab.cn"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"请求头 Authorization: Bearer <token>（服务级 token：CLASSICS_SERVICE_TOKEN；外部产品经 MCP 使用每用户独立 key）"},"xActor":{"type":"apiKey","in":"header","name":"X-Actor","description":"演化治理写操作（triage/review/approve/transition/migrate/freeze/revoke/policy 激活）必填操作者身份；ai/system 被拒"}},"schemas":{"TrustedQueryRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"用户问题（如：什么是知行合一？）"},"knowledge_scope":{"type":"array","items":{"type":"string"},"description":"知识范围（默认 [\"ffckk\"]）"},"expression_mode":{"type":"string","enum":["conversation","explain","study","professional","citation_first"],"description":"表达模式（协议 §21 Mode A–E；默认 conversation）"}}},"KnowledgeClaim":{"type":"object","required":["claim_id","statement","claim_type","trust_level"],"properties":{"claim_id":{"type":"string"},"statement":{"type":"string"},"claim_type":{"type":"string","enum":["TEXT","FACT","INTERPRETATION","INFERENCE","OPINION","ACTION"]},"evidence_ids":{"type":"array","items":{"type":"string"}},"source_ids":{"type":"array","items":{"type":"string"}},"perspective":{"type":"string"},"trust_level":{"type":"string","enum":["T0","T1","T2","T3","T4"]},"conflict_status":{"type":"string","enum":["none","minor","significant","unresolved"]},"truth_boundary":{"type":"string","enum":["direct","inferred","applied"]}}},"Citation":{"type":"object","required":["citation_id","claim_id","evidence_id","source_id"],"properties":{"citation_id":{"type":"string"},"claim_id":{"type":"string"},"evidence_id":{"type":"string"},"source_id":{"type":"string"},"display_label":{"type":"string"},"locator":{"type":"string"},"quote":{"type":"string"},"trust_level":{"type":"string"}}},"TrustedAnswer":{"type":"object","required":["query_id","answer","trust","protocol"],"properties":{"query_id":{"type":"string"},"answer_mode":{"type":"string"},"answer":{"type":"string"},"trust":{"type":"string","enum":["T0","T1","T2","T3","T4"]},"trust_label":{"type":"string"},"claims":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeClaim"}},"citations":{"type":"array","items":{"$ref":"#/components/schemas/Citation"}},"rendered_answer":{"type":"string"},"has_conflict":{"type":"boolean"},"has_uncertainty":{"type":"boolean"},"abstention":{"type":"object","nullable":true,"properties":{"reason":{"type":"string"},"message":{"type":"string"}}},"protocol":{"type":"string","enum":["FFCKK-TKP-1.0"]}}},"IlluminateRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"用户问题"},"minimal_context":{"type":"string","description":"可选最小语境补充"}}},"IlluminateAnswer":{"type":"object","required":["query_id","protocol","context","focused_question","perspectives","insight"],"properties":{"query_id":{"type":"string"},"protocol":{"type":"string","enum":["FFCKK-Illumination-1.1"]},"context":{"type":"object","description":"Context Model（surface_question/tension/context_confidence C1–C3）"},"focused_question":{"type":"object"},"perspectives":{"type":"array","items":{"type":"object"},"description":"四家照见（道/儒/佛/阳明，每家 50–100 字）"},"contrast":{"type":"object","description":"共识与差异"},"insight":{"type":"object","description":"聚焦洞见 + 反思问题 + 可选小行动"},"claims":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeClaim"}},"citations":{"type":"array","items":{"$ref":"#/components/schemas/Citation"}},"evidence_drawer":{"type":"array","items":{"type":"object"}},"overall_trust":{"type":"string","enum":["T0","T1","T2","T3","T4"]},"has_conflict":{"type":"boolean"}}},"InsightRequest":{"type":"object","required":["productId","scenario","privacyMode"],"properties":{"productId":{"type":"string","description":"产品标识（如 half-atlas-voice-staging）"},"scenario":{"type":"string","description":"场景（如 stage_report / reflection）"},"privacyMode":{"type":"string","enum":["private","public"],"description":"隐私模式"},"userText":{"type":"string","description":"用户输入/处境描述（≤4000 字符）"},"contextSummary":{"type":"string","description":"上下文摘要（userText 为空时使用）"},"knowledgePackIds":{"type":"array","items":{"type":"string"},"description":"指定 Pack（fckk:lunyu:pack:main 等）；缺省按产品投影路由"},"maxInsights":{"type":"integer","minimum":1,"maximum":4,"description":"照见条数上限（四家各一条）"},"maxActions":{"type":"integer","minimum":0,"maximum":5,"description":"行动条数上限"},"synthesize":{"type":"boolean","description":"为 true 时在响应中附加 synthesized 综合回答（含跨家整合 traditions 与行动方案）"},"evidenceFragments":{"type":"array","items":{"type":"object","properties":{"fragmentId":{"type":"string"}}}},"structuredContext":{"type":"object","properties":{"detectedTopics":{"type":"array","items":{"type":"string"}},"detectedChanges":{"type":"array","items":{"type":"string"}},"detectedQuestions":{"type":"array","items":{"type":"string"}}}},"userDisabledClassics":{"type":"boolean","description":"用户关闭经典模块"},"projectionId":{"type":"string"}}},"InsightBundle":{"type":"object","properties":{"requestId":{"type":"string"},"productId":{"type":"string"},"situationSummary":{"type":"string"},"situationIds":{"type":"array","items":{"type":"string"}},"situationConfidence":{"type":"string"},"classicModuleUsed":{"type":"boolean"},"noUseReason":{"type":"string","nullable":true},"intentType":{"type":"string"},"riskLevel":{"type":"string"},"insights":{"type":"array","items":{"type":"object"}},"actions":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"packVersions":{"type":"object","additionalProperties":{"type":"string"}},"releaseIds":{"type":"array","items":{"type":"string"}},"outputSnapshotId":{"type":"string"},"synthesized":{"$ref":"#/components/schemas/SynthesizedAnswer","description":"仅当请求 synthesize=true 时返回"},"dimensionMaterialsCount":{"type":"integer","description":"综合回答引用的关系维度材料数"},"integratedPacks":{"type":"array","items":{"type":"string"},"description":"本次整合的经典名称（如 道德经/金刚经）"}}},"SynthesizedAnswer":{"type":"object","properties":{"overview":{"type":"string","description":"总览：处境的根本张力"},"layers":{"type":"array","description":"三个关系层解读（self/relational/cosmic）","items":{"type":"object","properties":{"layer":{"type":"string","enum":["self","relational","cosmic"]},"title":{"type":"string"},"insight":{"type":"string"},"axes":{"type":"array","items":{"type":"string"}}}}},"traditions":{"type":"object","description":"跨家整合：本次整合了哪些传统、相通处与不同处","properties":{"names":{"type":"array","items":{"type":"string"}},"convergence":{"type":"string"},"divergence":{"type":"string"}}},"schools":{"type":"object","description":"四家照见覆盖：道/佛/儒/阳明逐家立场，缺哪家如实列出","properties":{"engaged":{"type":"array","items":{"type":"string"},"description":"有直接材料支撑的家（单个字：道/佛/儒/阳明）"},"missing":{"type":"array","items":{"type":"string"},"description":"无材料支撑且无法合理推演的家"},"perSchool":{"type":"array","items":{"type":"object","properties":{"school":{"type":"string"},"stance":{"type":"string"},"inferred":{"type":"boolean","description":"true 表示该家为跨家推演立场（非原文材料）"}}}}}},"singleTraditionNote":{"type":"string","nullable":true,"description":"仅命中一家时的提示"},"nonEquivalences":{"type":"array","items":{"type":"string"},"description":"不能等同推断"},"actionPlan":{"type":"object","properties":{"steps":{"type":"array","items":{"type":"string"}},"path":{"type":"string"},"cadence":{"type":"string"}}},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"lensId":{"type":"string"}}}}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"severity":{"type":"string"},"traceId":{"type":"string"},"retryable":{"type":"boolean"}}}}}},"responses":{"Unauthorized":{"description":"缺少/无效 token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/api/classics/v1/ready":{"get":{"summary":"就绪检查（公开，无需鉴权）","security":[],"responses":{"200":{"description":"服务就绪"},"503":{"description":"未就绪或生产安全闸未解除"}}}},"/api/classics/v1/trusted-query":{"post":{"summary":"V1.0 Trusted Query（协议 §42 P0 API Contract）","description":"13 步管道：Intent→Retrieve→Evidence(MSES)→Claim→Binding→Trust(T0–T4)→Conflict→Filter→Expression(Mode A–E)→Citation Validate→Answer→Audit。返回 answer/trust/claims/citations/has_conflict/protocol=FFCKK-TKP-1.0；无证据/重大冲突/超范围时 abstention 明确拒答，不伪造知识。","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrustedQueryRequest"}}}},"responses":{"200":{"description":"TrustedAnswer（协议 Contract）"},"400":{"description":"INVALID_REQUEST（query 缺失）"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/classics/v1/trusted-query/audit":{"get":{"summary":"V1.0 Trusted Query 审计链（协议 §31，append-only）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ protocol, events, count }"}}}},"/api/classics/v1/trusted-query/sources":{"get":{"summary":"V1.0 Source Registry（协议 §3–§4，按 source_grade 列出）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ protocol, sources, count, by_grade }"}}}},"/api/classics/v1/illuminate":{"post":{"summary":"V1.1 语境理解与照见（Context→Focus→四家照见→Insight→反思/行动）","description":"先理解用户语境（Context Model + C1/C2/C3），聚焦真问题，四家精简照见（50–100 字），共识与差异，最后聚焦为一个洞见 + 一个问题 + 可选一小步；Evidence 退到最后仍可回溯。返回 protocol=FFCKK-Illumination-1.1。","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IlluminateRequest"}}}},"responses":{"200":{"description":"IlluminateAnswer（协议 Contract）"},"400":{"description":"INVALID_REQUEST（query 缺失）"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/classics/v1/insights":{"post":{"summary":"经典照见（核心）","description":"输入处境，返回道德经/易经/论语/金刚经的结构化照见与行动。误读/越界输入会被 Gate 阻断（classicModuleUsed=false，noUseReason=GATE_BLOCKED）。","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InsightRequest"}}}},"responses":{"200":{"description":"照见 Bundle","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InsightBundle"}}}},"400":{"description":"请求校验失败","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"缺少/无效 token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/classics/v1/runtime":{"post":{"summary":"统一 Knowledge Runtime（V0.5）","description":"六种正式模式：lookup（对象查找）/ explore（处境照见扩展）/ compare（关系比较，含相似/差异/非等同维度）/ source（来源投影）/ path（正式路径读取）/ report_support（报告支持，含综合回答）。Bearer 鉴权。","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"runtimeMode":{"type":"string","enum":["lookup","explore","compare","source","path","report_support"]},"productId":{"type":"string"},"productVersion":{"type":"string"},"releaseId":{"type":"string"},"locale":{"type":"string"},"viewerClassId":{"type":"string"},"rightsContextId":{"type":"string"},"safetyProfileId":{"type":"string"},"query":{"type":"string"},"objectId":{"type":"string"},"relationId":{"type":"string"},"pathId":{"type":"string"},"sourceId":{"type":"string"},"synthesize":{"type":"boolean"},"knowledgePackIds":{"type":"array","items":{"type":"string"}}},"required":["runtimeMode","productId"]}}}},"responses":{"200":{"description":"Runtime Result（按 mode 承载 object/insights/compare/source/path/synthesized）"},"400":{"description":"请求校验失败"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/classics/v1/runtime/adapters":{"get":{"summary":"Product Adapter Fixtures 列表（V0.5，FRA/FPP/FRC/Half Atlas/Voice）","responses":{"200":{"description":"适配器清单"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/classics/v1/runtime/adapters/{adapterId}/execute":{"post":{"summary":"Product Adapter 端到端执行（产品请求 → Runtime → 响应投影）","parameters":[{"name":"adapterId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"投影后的响应"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"适配器不存在"}}}},"/api/classics/v1/runtime/observations":{"get":{"summary":"Runtime Observation（进程内遥测：按模式汇总 + 最近记录）","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200}}],"responses":{"200":{"description":"观测汇总与记录"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/classics/v1/packs":{"get":{"summary":"知识包列表","responses":{"200":{"description":"Pack 注册列表"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/classics/v1/releases/{id}":{"get":{"summary":"Release 详情","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Release"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"未找到"}}}},"/api/classics/v1/feedback":{"post":{"summary":"反馈（不直接改知识，进入 Issue 流程）","responses":{"200":{"description":"已受理"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/classics/v2/graph/nodes/{id}":{"get":{"summary":"图谱节点","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"releaseId","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"节点"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"未找到"}}}},"/api/classics/v2/graph/nodes/{id}/neighbors":{"get":{"summary":"节点邻居","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"releaseId","in":"query","required":false,"schema":{"type":"string"}},{"name":"depth","in":"query","required":false,"schema":{"type":"integer","maximum":3}}],"responses":{"200":{"description":"邻居节点"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/classics/v2/graph/subgraph":{"post":{"summary":"子图查询","responses":{"200":{"description":"子图"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/classics/v3/workbench/candidates":{"get":{"summary":"Workbench 候选收件箱（draft/reviewed 维度与 Patch，需鉴权）","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"kind","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"候选列表"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/classics/v3/workbench/candidates/batch-review":{"post":{"summary":"Workbench 批量审校（draft→reviewed/withdrawn，机器审校记录+审计，需鉴权）","responses":{"200":{"description":"已更新数量"},"400":{"description":"请求无效"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/classics/v3/workbench/objects/{id}/withdraw":{"post":{"summary":"Workbench 对象 Withdraw（需鉴权）","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"已撤回"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"未找到"}}}},"/api/classics/v3/workbench/releases/{id}/withdraw":{"post":{"summary":"候选 Release Withdraw（需鉴权）","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"已撤回"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"未找到"}}}},"/api/classics/v3/workbench/releases/{id}/supersede":{"post":{"summary":"候选 Release Supersede（需鉴权，body: replacementReleaseId）","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"已取代"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"未找到"}}}},"/api/personal-graph/v1/references":{"post":{"summary":"保存个人图谱引用（需鉴权）","responses":{"200":{"description":"已保存"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"get":{"summary":"列出个人图谱引用","responses":{"200":{"description":"引用列表"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/classics/v1/orchestrate":{"post":{"summary":"V0.6 知识智能编排（Intent→Route→Plan→Select→Assemble→Trace + explanation）","security":[{"bearerAuth":[]}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["question","productId"],"properties":{"question":{"type":"string"},"productId":{"type":"string"},"personalContextRef":{"type":"string"},"historicalSnapshotId":{"type":"string"}}}}}},"responses":{"200":{"description":"编排结果（intent/routePlan/selection/assembled/trace/explanation）"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/classics/v1/evolution/signals":{"post":{"summary":"V0.7 Signal → Issue Candidate（dedupe/cluster）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"Issue Candidate"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/classics/v1/evolution/triage":{"post":{"summary":"V0.7 Triage → Issue（P0 需 humanReviewed；需 X-Actor）","security":[{"bearerAuth":[]},{"xActor":[]}],"responses":{"200":{"description":"Issue / 分流结果"},"422":{"description":"TRIAGE_REJECTED"}}}},"/api/classics/v1/evolution/candidates":{"post":{"summary":"V0.7 创建 Evolution Candidate（AI 提议自动 review_required）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"Candidate"},"422":{"description":"CANDIDATE_REJECTED"}}},"get":{"summary":"V0.7 列出 Evolution Candidate","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Candidate 列表"}}}},"/api/classics/v1/evolution/review/decisions":{"post":{"summary":"V0.7 提交 Review Decision（需 X-Actor，AI 被拒）","security":[{"bearerAuth":[]},{"xActor":[]}],"responses":{"201":{"description":"Review"},"422":{"description":"REVIEW_DECISION_REJECTED"}}}},"/api/classics/v1/evolution/approvals":{"post":{"summary":"V0.7 提交 Approval（pin revision；需 X-Actor，AI 被拒）","security":[{"bearerAuth":[]},{"xActor":[]}],"responses":{"201":{"description":"Approval"},"422":{"description":"APPROVAL_REJECTED"}}}},"/api/classics/v1/evolution/regression/blocked":{"get":{"summary":"V0.7 回归阻断检查（critical 无回归/NOT_RUN/FLAKY 阻断）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ blocked, reasons }"}}}},"/api/classics/v1/evolution/historical/replay":{"get":{"summary":"V0.7 历史快照精确回放（MISS 保持 MISS，无 current fallback）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Replay 结果"}}}},"/api/classics/v1/evolution/manifests/{id}/ready":{"get":{"summary":"V0.7 Release Impact Manifest 就绪校验","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"{ valid, errors }"}}}},"/api/classics/v1/evolution/products/pins":{"post":{"summary":"V0.7 五产品 Exact Pin（不自动升级）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"Product Reference"},"422":{"description":"PIN_REJECTED"}}}},"/api/classics/v1/evolution/drift":{"get":{"summary":"V0.7.1 Drift 查询（只读：已检测 Drift 信号 + Issue 引用）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ total, drifts, issueRefs }"}}}},"/api/classics/v1/discovery/sources":{"get":{"summary":"V0.8 Discovery Source Registry 列表（默认 untrusted）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ total, sources }"}}},"post":{"summary":"V0.8 注册外部发现来源（web 等默认 untrusted，不能直接作为 Formal Evidence）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"Source"},"422":{"description":"DISCOVERY_SOURCE_REJECTED"}}}},"/api/classics/v1/discovery/signals":{"post":{"summary":"V0.8 Signal → Candidate（Dedup；Candidate ≠ Evolution Candidate）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"{ candidate, duplicate }"},"422":{"description":"DISCOVERY_SIGNAL_REJECTED"}}}},"/api/classics/v1/discovery/candidates":{"get":{"summary":"V0.8 Discovery Candidate 列表（按 state 过滤）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ total, candidates }"}}}},"/api/classics/v1/discovery/candidates/{id}/transition":{"post":{"summary":"V0.8 Candidate 状态转移（状态机白名单；AI 不能到 accepted_for_governance）","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"{ candidate }"},"422":{"description":"DISCOVERY_TRANSITION_DENIED"}}}},"/api/classics/v1/discovery/qualifications":{"post":{"summary":"V0.8 创建来源资质（默认未合格；验证后才 qualified）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"{ qualification }"},"422":{"description":"QUALIFICATION_REJECTED"}}}},"/api/classics/v1/discovery/qualifications/{id}/verify":{"post":{"summary":"V0.8 人工验证资质（AI/system 被拒；web snippet 不能作 Formal Evidence）","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"{ qualification }"},"422":{"description":"VERIFY_DENIED"}}}},"/api/classics/v1/discovery/engine/relation":{"post":{"summary":"V0.8 关系提案（Similarity ≠ Formal Relation；difference/nonEquivalence 必带）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ proposal }"},"422":{"description":"RELATION_PROPOSAL_REJECTED"}}}},"/api/classics/v1/discovery/engine/conflict":{"post":{"summary":"V0.8 冲突提案（Conflict ≠ Error；仅标记不消解）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ proposal }"}}}},"/api/classics/v1/discovery/engine/gap":{"post":{"summary":"V0.8 空白提案（Gap ≠ Missing Truth；仅标注不补写）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ proposal }"}}}},"/api/classics/v1/discovery/handoff":{"post":{"summary":"V0.8 Discovery → V0.7 Governance Handoff（缺治理引用拒绝）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"{ handoff }"},"422":{"description":"HANDOFF_DENIED"}}}},"/api/classics/v1/discovery/auto-handoff":{"post":{"summary":"V0.8 自动交接：accepted_for_governance 候选 → Issue Candidate + Handoff（auto-handoff ≠ auto-issue；triage 仍需人工，P0 强制 humanReviewed）","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"discoveryCandidateRef":{"type":"string"}},"required":["discoveryCandidateRef"]}}}},"responses":{"201":{"description":"{ candidate, issueCandidate, handoff, note }"},"422":{"description":"AUTO_HANDOFF_DENIED"}}}},"/api/classics/v1/discovery/trust/injection-check":{"post":{"summary":"V0.8 Prompt Injection 标记（只标记，不阻断内容）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ result }"}}}},"/api/classics/v1/discovery/open-web/search":{"post":{"summary":"V0.8 Open Web 结果摄取（Candidate-only，永不 Formal）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"{ result }"},"422":{"description":"WEB_RESULT_REJECTED"}}}},"/api/classics/v1/discovery/external-packs":{"post":{"summary":"V0.8 External Pack 注册（永不 Formal）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"{ pack }"},"422":{"description":"EXTERNAL_PACK_REJECTED"}}}},"/api/classics/v1/discovery/agent/verify-tool":{"post":{"summary":"V0.8 Discovery Agent 工具校验（只读提议，AI 无治理写权）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ decision }"}}}},"/api/classics/v1/discovery/products/matrix":{"get":{"summary":"V0.8 五产品 Discovery 能力矩阵","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"FIVE_PRODUCT_DISCOVERY_MATRIX"}}}},"/api/classics/v1/discovery/observation":{"get":{"summary":"V0.8 Discovery Observation 汇总（持久化 JSONL 恢复）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ summary }"}}}},"/api/classics/v1/evolution/change-signals":{"post":{"summary":"V0.9 Change Detection：变化 → Change Signal（假变化过滤/资格四问/优先级；检测 ≠ 决策）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"{ signal, accepted }"},"422":{"description":"CHANGE_DETECTION_REJECTED"}}},"get":{"summary":"V0.9 Change Signal 列表（按 status 过滤）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ total, signals }"}}}},"/api/classics/v1/evolution/change-signals/{id}/handoff":{"post":{"summary":"V0.9 Change Signal → V0.7 Issue Candidate（系统通道；triage 仍需人工）","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"{ signal, issueCandidate, note }"},"422":{"description":"CHANGE_HANDOFF_DENIED"}}}},"/api/classics/v1/evolution/state":{"post":{"summary":"V0.9 Knowledge State：创建初始状态（v1；Current State ≠ Complete Knowledge）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"{ state }"},"422":{"description":"STATE_REJECTED"}}}},"/api/classics/v1/evolution/state/{id}/evolve":{"post":{"summary":"V0.9 Knowledge State 演化（Update ≠ Replacement；需 X-Actor 人工 + approvalRef；AI 被拒）","security":[{"bearerAuth":[],"xActor":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"{ previous, next }"},"422":{"description":"STATE_EVOLVE_DENIED"}}}},"/api/classics/v1/evolution/state/{id}/rollback":{"post":{"summary":"V0.9 回滚 = 生成新版本（rolledBackToVersion），不删除历史；需 X-Actor 人工","security":[{"bearerAuth":[],"xActor":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"{ previous, rolledBack }"},"422":{"description":"STATE_ROLLBACK_DENIED"}}}},"/api/classics/v1/evolution/state/{id}/history":{"get":{"summary":"V0.9 Knowledge State 版本历史（不可变）","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"{ objectId, history }"}}}},"/api/classics/v1/evolution/state/compare":{"get":{"summary":"V0.9 Knowledge State 版本对比（changed/removed/unchanged keys）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ diff }"}}}},"/api/classics/v1/evolution/semantic-drift":{"post":{"summary":"V0.9 Semantic Drift 检测（四层 + 六类漂移；Similarity ≠ Meaning 拒收；文化/哲学强制人工）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"{ signal, accepted }"},"422":{"description":"DRIFT_DETECTION_REJECTED"}}},"get":{"summary":"V0.9 Semantic Drift Signal 列表","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ total, signals }"}}}},"/api/classics/v1/evolution/semantic-drift/{id}/handoff":{"post":{"summary":"V0.9 Drift → V0.7 Issue Candidate（文化/哲学语义需人工审校）","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"{ signal, issueCandidate, note }"},"422":{"description":"DRIFT_HANDOFF_DENIED"}}}},"/api/classics/v1/evolution/graph-evolution/node":{"post":{"summary":"V0.9 Graph Evolution：节点生命周期创建（需 X-Actor 人工；Create ≠ Truth）","security":[{"bearerAuth":[],"xActor":[]}],"responses":{"201":{"description":"{ node }"},"422":{"description":"GRAPH_NODE_DENIED"}}}},"/api/classics/v1/evolution/graph-evolution/correction":{"post":{"summary":"V0.9 Graph Correction 提案（AI 可提议；不直接改正式图）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ proposal }"}}}},"/api/classics/v1/evolution/graph-evolution/expansion":{"post":{"summary":"V0.9 Graph Expansion 提案（新节点/隐藏关系/缺失连接）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ proposal }"}}}},"/api/classics/v1/evolution/graph-evolution/proposals":{"get":{"summary":"V0.9 Graph Evolution Proposal 列表","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ total, proposals }"}}}},"/api/classics/v1/evolution/graph-evolution/proposals/{id}/handoff":{"post":{"summary":"V0.9 Graph Proposal → V0.7 Issue Candidate","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"{ proposal, issueCandidate }"},"422":{"description":"GRAPH_PROPOSAL_HANDOFF_DENIED"}}}},"/api/classics/v1/evolution/conflicts":{"post":{"summary":"V0.9 Knowledge Conflict 注册（Conflict ≠ Error；AI 可识别冲突不可裁决）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"{ conflict }"},"422":{"description":"CONFLICT_REGISTER_REJECTED"}}},"get":{"summary":"V0.9 Knowledge Conflict 列表","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ total, conflicts }"}}}},"/api/classics/v1/evolution/conflicts/{id}/perspectives":{"post":{"summary":"V0.9 添加视角（Perspective 必须带证据 + 限制条件）","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"{ conflict }"},"422":{"description":"PERSPECTIVE_REJECTED"}}}},"/api/classics/v1/evolution/conflicts/{id}/resolve":{"post":{"summary":"V0.9 Conflict Resolution（需 X-Actor 人工/editorial；AI 不能强制结论；KEEP_MULTIPLE 允许）","security":[{"bearerAuth":[],"xActor":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"{ conflict }"},"422":{"description":"CONFLICT_RESOLVE_DENIED"}}}},"/api/classics/v1/evolution/agents/run":{"post":{"summary":"V0.9 Evolution Agent 多角色协作（只读分析 → Evolution Proposal；无证据无提案；approved 恒 false）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ run }"}}}},"/api/classics/v1/evolution/agents/proposals":{"get":{"summary":"V0.9 Evolution Agent Proposal 列表","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ total, proposals }"}}}},"/api/classics/v1/evolution/agents/proposals/{id}/handoff":{"post":{"summary":"V0.9 Agent Proposal → V0.7 Issue Candidate（AI 建议 ≠ 决策）","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"{ proposal, issueCandidate }"},"422":{"description":"AGENT_PROPOSAL_HANDOFF_DENIED"}}}},"/api/classics/v1/evolution/events":{"post":{"summary":"V0.9 Evolution Event 入总线（无证据拒收；Event ≠ Approval；自动路由到对应引擎）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"{ event, accepted }"},"422":{"description":"EVENT_EMIT_REJECTED"}}},"get":{"summary":"V0.9 Evolution Event 列表（按 status/queueState 过滤）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ total, events }"}}}},"/api/classics/v1/evolution/events/{id}/transition":{"post":{"summary":"V0.9 Event 队列流转（approved 仅人工 + approvalRef）","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"{ event }"},"422":{"description":"EVENT_TRANSITION_DENIED"}}}},"/api/classics/v1/evolution/audit":{"post":{"summary":"V0.9 Evolution Audit 记录（operation/decision/evidence/version；只追加不可改）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"{ record }"},"422":{"description":"AUDIT_REJECTED"}}},"get":{"summary":"V0.9 Evolution Audit 查询（按 logType 过滤）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ total, records }"}}}},"/api/classics/v1/evolution/personal-evolution":{"post":{"summary":"V0.9 Personal Evolution 事件（隐私边界：owner/permission/sharingScope 必填；不存 raw transcript）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"{ event }"},"422":{"description":"PERSONAL_EVENT_REJECTED"}}},"get":{"summary":"V0.9 Personal Evolution 列表（按 owner/privacyStatus 过滤）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ total, events }"}}}},"/api/classics/v1/evolution/personal-evolution/behavior-change":{"post":{"summary":"V0.9 用户行为变化检测（interest/demand/learning pattern；需证据）","security":[{"bearerAuth":[]}],"responses":{"201":{"description":"{ signal }"},"422":{"description":"BEHAVIOR_CHANGE_REJECTED"}}}},"/api/classics/v1/evolution/personal-evolution/behavior-signals/{id}/handoff":{"post":{"summary":"V0.9 行为变化信号 → V0.7 Issue Candidate","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"201":{"description":"{ signal, issueCandidate }"},"422":{"description":"BEHAVIOR_HANDOFF_DENIED"}}}},"/api/classics/v1/evolution/metrics":{"get":{"summary":"V0.9 Evolution Metrics（freshness/acceptance/conflict resolution/trust stability；Score ≠ Truth）","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"{ metrics }"}}}}}}