《互联网产品的 AI 架构·平台化与治理》13.1 治理基线：回声的平台化清单

// file: src/gov/baseline.ts
// tier: L2
// verify: node --test test/gov/baseline.test.ts

export type BaselineDomain =
  | "objects"
  | "catalog"
  | "versions"
  | "quota"
  | "evaluation"
  | "quality"
  | "cost"
  | "compliance"
  | "security"
  | "platform"
  | "ownership";

export type CheckState = "pass" | "partial" | "fail";
export type ItemReason = "no-owner" | "no-criterion" | "no-evidence" | "missing-evidence";

export interface BaselineItem {
  id: string;
  domain: BaselineDomain;
  /** 判据必须能回答“看什么、算不算过”，不能写“已治理”。 */
  criterion: string;
  /** 能做出发布与退役决定的责任主体；空串表示无人负责。 */
  owner: string;
  /** 判据要求的证据 id；一条判据可以对应多份证据。 */
  requiredEvidence: readonly string[];
  /** 当前已经拿到的证据 id。 */
  evidence: readonly string[];
  /** true 表示未通过就否决任何放量；false 只进入条件清单。 */
  blocking: boolean;
}

export interface ItemJudgement {
  id: string;
  state: CheckState;
  reason?: ItemReason;
  missingEvidence: string[];
}

/**
 * 单条判定只回答三件事：有没有人负责、判据是否可查、证据是否齐。
 * 判定不读外部系统，输入什么就判什么，保证同一快照每次结论一致。
 */
export function judgeItem(item: BaselineItem): ItemJudgement {
  if (item.owner.trim() === "") {
    return { id: item.id, state: "fail", reason: "no-owner", missingEvidence: [...item.requiredEvidence] };
  }
  if (item.requiredEvidence.length === 0) {
    return { id: item.id, state: "fail", reason: "no-criterion", missingEvidence: [] };
  }
  const present = new Set(item.evidence);
  const missing = item.requiredEvidence.filter((id) => !present.has(id));
  if (missing.length === item.requiredEvidence.length) {
    return { id: item.id, state: "fail", reason: "no-evidence", missingEvidence: missing };
  }
  if (missing.length > 0) {
    return { id: item.id, state: "partial", reason: "missing-evidence", missingEvidence: missing };
  }
  return { id: item.id, state: "pass", missingEvidence: [] };
}

export type BaselineConclusion = "pass" | "conditional" | "blocked";

export interface BaselineResult {
  total: number;
  passed: number;
  partial: number;
  failed: number;
  blockingFailures: string[];
  conditions: string[];
  conclusion: BaselineConclusion;
}

/**
 * 总体结论按两道闸门：先看 blocking 项是否全过，再看是否存在非 blocking 缺口。
 * “conditional”不是模糊地带，它带一份必须关闭的条件清单。
 */
export function evaluateBaseline(items: readonly BaselineItem[]): BaselineResult {
  const seen = new Set<string>();
  for (const item of items) {
    if (seen.has(item.id)) throw new Error(`baseline: duplicate item ${item.id}`);
    seen.add(item.id);
  }
  const judged = items.map((item) => ({ item, judgement: judgeItem(item) }));
  const passed = judged.filter((entry) => entry.judgement.state === "pass").length;
  const partial = judged.filter((entry) => entry.judgement.state === "partial").length;
  const failed = judged.filter((entry) => entry.judgement.state === "fail").length;
  const blockingFailures = judged
    .filter((entry) => entry.item.blocking && entry.judgement.state !== "pass")
    .map((entry) => entry.item.id);
  const conditions = judged
    .filter((entry) => entry.judgement.state !== "pass")
    .map((entry) => entry.item.id);
  const conclusion: BaselineConclusion =
    blockingFailures.length > 0 ? "blocked" : conditions.length > 0 ? "conditional" : "pass";
  return { total: items.length, passed, partial, failed, blockingFailures, conditions, conclusion };
}

/** 回声 2026 年 11 月的基线快照，示例数据，不是生产实测。 */
export const ECHO_BASELINE: readonly BaselineItem[] = [
  {
    id: "objects.snapshot",
    domain: "objects",
    criterion: "能力、调用方、租户、版本四类对象可导出唯一 id 与归属",
    owner: "platform-governance",
    requiredEvidence: ["snapshot-2026-11"],
    evidence: ["snapshot-2026-11"],
    blocking: true,
  },
  {
    id: "catalog.fields",
    domain: "catalog",
    criterion: "在役能力目录含契约、默认档位、可覆盖参数、SLA 与退役日期",
    owner: "platform-catalog",
    requiredEvidence: ["catalog-2026-11"],
    evidence: ["catalog-2026-11"],
    blocking: true,
  },
  {
    id: "versions.matrix",
    domain: "versions",
    criterion: "契约、模型、提示三条版本线与弃用窗口可查",
    owner: "platform-release",
    requiredEvidence: ["version-matrix-2026-11", "deprecation-window"],
    evidence: ["version-matrix-2026-11", "deprecation-window"],
    blocking: true,
  },
  {
    id: "quota.three-tier",
    domain: "quota",
    criterion: "租户总额、团队份额、单次上限三层账本可对账",
    owner: "finance-platform",
    requiredEvidence: ["quota-ledger-2026-10"],
    evidence: ["quota-ledger-2026-10"],
    blocking: true,
  },
  {
    id: "evaluation.gate",
    domain: "evaluation",
    criterion: "跨团队评测集标注来源、隐私级别、有效期与责任人，回归门禁可复跑",
    owner: "eval-platform",
    requiredEvidence: ["eval-corpus-index", "privacy-labels", "regression-run-2026-11"],
    evidence: ["eval-corpus-index", "regression-run-2026-11"],
    blocking: false,
  },
  {
    id: "quality.ops",
    domain: "quality",
    criterion: "抽检比例、事故分级与季度复盘有执行记录",
    owner: "quality-ops",
    requiredEvidence: ["quality-review-2026-q3"],
    evidence: ["quality-review-2026-q3"],
    blocking: false,
  },
  {
    id: "cost.chargeback",
    domain: "cost",
    criterion: "成本分摊与月度对账统一用整数微元并写明分母",
    owner: "finance-platform",
    requiredEvidence: ["chargeback-2026-10"],
    evidence: ["chargeback-2026-10"],
    blocking: true,
  },
  {
    id: "compliance.retention",
    domain: "compliance",
    criterion: "数据分级、留存、删除与供应商通知有演练记录",
    owner: "compliance",
    requiredEvidence: ["retention-policy", "deletion-drill"],
    evidence: ["retention-policy"],
    blocking: false,
  },
  {
    id: "security.risk",
    domain: "security",
    criterion: "风险登记、红队与漏洞披露均有最近一次记录",
    owner: "security",
    requiredEvidence: ["risk-register-2026-10"],
    evidence: ["risk-register-2026-10"],
    blocking: true,
  },
  {
    id: "platform.self-service",
    domain: "platform",
    criterion: "平台 SLO、自助边界与升级通道写入对外文档",
    owner: "platform-eng",
    requiredEvidence: ["platform-slo", "self-service-boundary"],
    evidence: ["platform-slo", "self-service-boundary"],
    blocking: true,
  },
  {
    id: "ownership.active",
    domain: "ownership",
    criterion: "每个在役能力都有能决定发布与退役的 owner",
    owner: "platform-governance",
    requiredEvidence: ["ownership-map-2026-11"],
    evidence: ["ownership-map-2026-11"],
    blocking: true,
  },
  {
    id: "ownership.retired",
    domain: "ownership",
    criterion: "已退役能力有依赖清单与迁移完成签字",
    owner: "",
    requiredEvidence: ["retirement-list", "migration-signoff"],
    evidence: ["retirement-list"],
    blocking: false,
  },
];