refactor: remove legacy data compatibility

src/results/resolver.ts

@@ -1,10 +1,11 @@
-import { atomicWriteJson, readJsonFile } from "../utils/fileStore.js";
+import { readJsonFile } from "../utils/fileStore.js";
 import {
   type ResultReferenceKind,
   type ResultReferenceRecord,
   type ResultReferenceSource,
   type RetrievalContext,
   RESULT_REFERENCE_KIND,
+  RESULT_REFERENCE_SOURCE,
   type ResultReferenceStore,
 } from "./store.js";
 
@@ -34,6 +35,7 @@ export type RenderJunctionPayload = {
 export class ResultReferenceResolver {
   constructor(private readonly store: ResultReferenceStore) {}
 
+  // Resolver 负责按结果类型做结构校验，Store 只关心授权和落盘。
   async register(input: RegisterResultReferenceInput) {
     const normalizedData = normalizeDataForKind(
       input.kind,
@@ -66,15 +68,12 @@ export class ResultReferenceResolver {
       throw new Error(`render payload file not found: ${filePath}`);
     }
 
-    const payloadCandidate = normalizeRenderPayloadFile(raw, {
-      filePath,
-      projectId: input.projectId,
-    });
-    if (payloadCandidate.repaired) {
-      await atomicWriteJson(filePath, payloadCandidate.file);
+    const wrapper = normalizeRenderPayloadFile(raw, filePath);
+    if (!wrapper) {
+      throw new Error("render payload file must use the wrapped { metadata, location, data } format");
     }
 
-    const payload = extractRenderJunctionPayload(payloadCandidate.data);
+    const payload = extractRenderJunctionPayload(wrapper.data);
     if (!payload) {
       throw new Error("render payload file does not contain a valid junction render payload");
     }
@@ -84,6 +83,7 @@ export class ResultReferenceResolver {
       data: payload,
       kind: RESULT_REFERENCE_KIND.renderJunctionsPayload,
       schemaVersion: 1,
+      source: RESULT_REFERENCE_SOURCE.agentGenerated,
     });
   }
 
@@ -144,6 +144,7 @@ export const extractRenderJunctionPayload = (
     return null;
   }
 
+  // 节点渲染结果只保留前端真正需要的映射字段，剔除空值并统一转为字符串。
   const nodeAreaMap = normalizeStringRecord(candidate.node_area_map);
   if (Object.keys(nodeAreaMap).length === 0) {
     return null;
@@ -182,35 +183,18 @@ const normalizeDataForKind = (
 
 const normalizeRenderPayloadFile = (
   value: unknown,
-  context: { filePath: string; projectId?: string },
-): { data: unknown; file: Record<string, unknown>; repaired: boolean } => {
+  filePath: string,
+): { data: unknown } | null => {
   if (!isRecord(value) || !("data" in value)) {
-    return {
-      data: value,
-      file: {
-        metadata: buildWrapperMetadata({}, value, context.projectId),
-        location: buildWrapperLocation(undefined, context.filePath),
-        data: value,
-      },
-      repaired: false,
-    };
+    return null;
   }
-
-  const metadata = buildWrapperMetadata(value.metadata, value, context.projectId);
-  const location = buildWrapperLocation(value.location, context.filePath);
-  const next: Record<string, unknown> = {
-    ...value,
-    metadata,
-    location,
-  };
-
-  return {
-    data: next.data,
-    file: next,
-    repaired:
-      JSON.stringify(metadata) !== JSON.stringify(value.metadata ?? null) ||
-      JSON.stringify(location) !== JSON.stringify(value.location ?? null),
-  };
+  if (!isRecord(value.metadata) || !isRecord(value.location)) {
+    return null;
+  }
+  if (value.location.file_path !== filePath) {
+    return null;
+  }
+  return { data: value.data };
 };
 
 const unwrapReferencePayload = (value: unknown): Record<string, unknown> | null => {
@@ -232,48 +216,3 @@ const normalizeStringRecord = (value: Record<string, unknown>) =>
 
 const isRecord = (value: unknown): value is Record<string, unknown> =>
   typeof value === "object" && value !== null && !Array.isArray(value);
-
-const buildWrapperMetadata = (
-  value: unknown,
-  root: unknown,
-  fallbackProjectId?: string,
-) => {
-  const metadata = isRecord(value) ? { ...value } : {};
-  const source = isRecord(root) ? root : {};
-
-  if (typeof metadata.createdAt !== "string" || metadata.createdAt.trim().length === 0) {
-    const createdAt =
-      typeof source.createdAt === "string" && source.createdAt.trim().length > 0
-        ? source.createdAt.trim()
-        : new Date().toISOString();
-    metadata.createdAt = createdAt;
-  }
-
-  if (
-    typeof metadata.projectId !== "string" ||
-    metadata.projectId.trim().length === 0
-  ) {
-    const projectId =
-      typeof source.projectId === "string" && source.projectId.trim().length > 0
-        ? source.projectId.trim()
-        : fallbackProjectId;
-    if (projectId) {
-      metadata.projectId = projectId;
-    }
-  }
-
-  return metadata;
-};
-
-const buildWrapperLocation = (value: unknown, filePath: string) => {
-  if (isRecord(value)) {
-    return {
-      ...value,
-      file_path: filePath,
-    };
-  }
-
-  return {
-    file_path: filePath,
-  };
-};