5fb7bfb1de
- 伏笔账本：纯函数状态机(OPEN/PARTIAL/CLOSED/OVERDUE) + ForeshadowLedger repo；验收后到期扫描(BackgroundTask 自建 session 置 OVERDUE)；登记/状态变更端点 - 节奏 + 三审齐：foreshadow-analyst + pace-checker 并入 LangGraph 并行审(REVIEW_SPECS)，collect 分列落 chapter_reviews(conflicts/foreshadow_sug/pace)，review SSE 加 foreshadow/pace 事件 - 大纲：outliner Agent 产 OutlineResult(含 foreshadow_windows)，POST /outline 逐章 upsert outline 表；GET /foreshadow?status= 看板 - 前端：伏笔四泳道看板(OVERDUE 琥珀) + 大纲编辑器(窗口徽标) + 节奏节拍图(▁▃▅) + 审稿页消费 foreshadow/pace SSE - bugfix(T3.8)：并行三审共用请求 session 记账触发 'Session is already flushing' → foreshadow/pace 静默丢失；SqlAlchemyLedgerSink.record 改 add-only(靠端点/事务 commit)，加并发回归测试 - M3 E2E：真实 DB + mock 网关零 token 走通 埋设→进展→验收后扫描 OVERDUE→看板 + 大纲含窗口 + 三审齐 SSE/留痕；E2E 暴露并钉住上述 bug - 门禁绿：mypy 111 / pytest 228(0 xfailed) / alembic 无漂移；前端 gen:api/lint/tsc/vitest 69/build
90 lines
2.9 KiB
TypeScript
90 lines
2.9 KiB
TypeScript
// 审稿历史归一：把后端 ReviewHistoryItem 的松散 conflicts（dict[]）收紧成 ReviewConflict[]。
|
||
// 纯逻辑（可单测）；schema 把 conflicts 标成 {[k]:unknown}[]，这里安全收窄。
|
||
|
||
import type { ReviewHistoryItem } from "@/lib/api/types";
|
||
import type {
|
||
ForeshadowKind,
|
||
ForeshadowSuggestion,
|
||
PaceIssue,
|
||
PaceReport,
|
||
ReviewConflict,
|
||
} from "./sse";
|
||
|
||
function asString(v: unknown, fallback = ""): string {
|
||
return typeof v === "string" ? v : fallback;
|
||
}
|
||
|
||
function asOptionalString(v: unknown): string | null {
|
||
return typeof v === "string" ? v : null;
|
||
}
|
||
|
||
function asStringArray(v: unknown): string[] {
|
||
if (!Array.isArray(v)) return [];
|
||
return v.filter((x): x is string => typeof x === "string");
|
||
}
|
||
|
||
function asIntArray(v: unknown): number[] {
|
||
if (!Array.isArray(v)) return [];
|
||
return v.filter((x): x is number => typeof x === "number" && Number.isFinite(x));
|
||
}
|
||
|
||
// 把一条留痕的 conflicts 收紧（缺字段给安全默认；保持顺序=下标身份，对齐冲突 gate）。
|
||
export function normalizeConflicts(
|
||
item: ReviewHistoryItem | undefined,
|
||
): ReviewConflict[] {
|
||
const raw = item?.conflicts ?? [];
|
||
return raw.map((c) => ({
|
||
type: asString(c["type"], "未分类"),
|
||
where: asString(c["where"]),
|
||
refs: asStringArray(c["refs"]),
|
||
suggestion: asString(c["suggestion"]),
|
||
}));
|
||
}
|
||
|
||
// 把一条留痕的 foreshadow_sug（扁平 list，每条带 kind）收紧成建议（缺字段给安全默认）。
|
||
// 对齐 collect 列映射（C4 扩 T3.3）：planted/resolved 扁平成单 list、每条加 kind。
|
||
export function normalizeForeshadowSug(
|
||
item: ReviewHistoryItem | undefined,
|
||
): ForeshadowSuggestion[] {
|
||
const raw = item?.foreshadow_sug ?? [];
|
||
return raw.map((s) => ({
|
||
kind: asKind(s["kind"]),
|
||
code: asOptionalString(s["code"]),
|
||
title: asString(s["title"], "（未命名线索）"),
|
||
where: asOptionalString(s["where"]),
|
||
note: asOptionalString(s["note"]),
|
||
}));
|
||
}
|
||
|
||
function asKind(v: unknown): ForeshadowKind {
|
||
return v === "resolved" ? "resolved" : "planted";
|
||
}
|
||
|
||
// 把一条留痕的 pace（dict）收紧成节奏报告；缺失/非 dict → null（不渲染节拍图）。
|
||
export function normalizePace(
|
||
item: ReviewHistoryItem | undefined,
|
||
): PaceReport | null {
|
||
const raw = item?.pace;
|
||
if (typeof raw !== "object" || raw === null) return null;
|
||
const dict = raw as Record<string, unknown>;
|
||
const waterRaw = Array.isArray(dict["water"]) ? dict["water"] : [];
|
||
const water: PaceIssue[] = waterRaw
|
||
.filter((w): w is Record<string, unknown> => typeof w === "object" && w !== null)
|
||
.map((w) => ({
|
||
where: asString(w["where"]),
|
||
reason: asString(w["reason"]),
|
||
}));
|
||
return {
|
||
water,
|
||
hook: dict["hook"] === true,
|
||
beat_map: asIntArray(dict["beat_map"]),
|
||
};
|
||
}
|
||
|
||
// 最近一条留痕（GET .../reviews 已按新→旧排序）。
|
||
export function latestReview(
|
||
items: readonly ReviewHistoryItem[] | undefined,
|
||
): ReviewHistoryItem | undefined {
|
||
return items?.[0];
|
||
}
|