refactor: remove legacy data compatibility

src/results/store.ts

@@ -10,7 +10,6 @@ import {
   listJsonFiles,
   readJsonFile,
   removeFileIfExists,
-  toProjectKey,
 } from "../utils/fileStore.js";
 
 export const RESULT_REF_PATTERN = /^res-[a-f0-9-]{8,64}$/;
@@ -22,8 +21,6 @@ export const RESULT_REFERENCE_KIND = {
 
 export const RESULT_REFERENCE_SOURCE = {
   agentGenerated: "agent_generated",
-  legacy: "legacy",
-  migration: "migration",
 } as const;
 
 export type ResultReferenceKind =
@@ -133,6 +130,7 @@ export class ResultReferenceStore {
       source: input.source,
       traceId: input.traceId,
     };
+    // result_ref 对外暴露短引用，完整数据落盘；这样可以避免大结果直接塞进模型上下文。
     await atomicWriteJson(this.filePath(resultRef), record);
     return record;
   }
@@ -143,13 +141,13 @@ export class ResultReferenceStore {
       return null;
     }
 
-    const rawRecord = await readJsonFile<unknown>(this.filePath(normalizedResultRef));
-    const record =
-      normalizeResultReferenceRecord(rawRecord) ??
-      normalizeLegacyRenderReferenceRecord(rawRecord, normalizedResultRef, context);
+    const record = normalizeResultReferenceRecord(
+      await readJsonFile<unknown>(this.filePath(normalizedResultRef)),
+    );
     if (!record) {
       return null;
     }
+    // 读取 result_ref 时按用户、项目和可选会话三层校验，防止跨项目/跨用户取数。
     if (record.actorKey !== context.actorKey) {
       return null;
     }
@@ -202,6 +200,7 @@ export class ResultReferenceStore {
       if (!stats) {
         continue;
       }
+      // TTL 以文件修改时间为准，清理长期无人访问的 result_ref 文件。
       if (now - stats.mtimeMs > this.ttlMs) {
         await removeFileIfExists(filePath);
       }
@@ -303,60 +302,6 @@ const normalizeResultRef = (value: string) => {
   return match?.[1] ?? null;
 };
 
-const normalizeLegacyRenderReferenceRecord = (
-  value: unknown,
-  resultRef: string,
-  context: RetrievalContext,
-): ResultReferenceRecord | null => {
-  const data = extractLegacyRenderPayload(value);
-  if (!data) {
-    return null;
-  }
-
-  const root = isRecord(value) ? value : {};
-  const metadata = isRecord(root.metadata) ? root.metadata : {};
-  const projectId = firstNonEmptyString(root.projectId, metadata.projectId);
-  const createdAt =
-    firstNonEmptyString(root.createdAt, metadata.createdAt) ?? new Date().toISOString();
-
-  return {
-    resultRef,
-    actorKey: context.actorKey,
-    clientSessionId: context.clientSessionId ?? "",
-    createdAt,
-    data,
-    kind: RESULT_REFERENCE_KIND.renderJunctionsPayload,
-    preview: buildPreview(data),
-    projectId,
-    projectKey: toProjectKey(projectId),
-    schemaVersion: 1,
-    sessionId: context.clientSessionId ?? resultRef,
-    sizeBytes: estimateBytes(data),
-    source: RESULT_REFERENCE_SOURCE.legacy,
-    traceId: "legacy-render-ref",
-  };
-};
-
-const extractLegacyRenderPayload = (value: unknown) => {
-  if (!isRecord(value)) {
-    return null;
-  }
-  const candidate = isRecord(value.data) ? value.data : value;
-  if (!isRecord(candidate.node_area_map)) {
-    return null;
-  }
-  return candidate;
-};
-
-const firstNonEmptyString = (...values: unknown[]) => {
-  for (const value of values) {
-    if (typeof value === "string" && value.trim().length > 0) {
-      return value.trim();
-    }
-  }
-  return undefined;
-};
-
 const isResultPreview = (value: unknown): value is ResultPreview =>
   isRecord(value) &&
   typeof value.count === "number" &&