oh-my-knowledge 0.51.2 → 0.52.0

package/dist/observability/conversation-view-model.js

@@ -0,0 +1,100 @@
+import { loadLatestObservationInboxReports } from './inbox.js';
+import { durationMsBetween } from '../shared/time.js';
+export function buildConversationIndexViewModel(observationsDir) {
+    const groups = new Map();
+    const reports = loadLatestObservationInboxReports(observationsDir);
+    for (const report of reports) {
+        for (const session of report.experience?.sessions ?? []) {
+            const group = groups.get(session.threadId) ?? {
+                threadId: session.threadId,
+                sourceThreadId: session.sourceThreadId,
+                sourceKind: session.sourceKind,
+                sessions: [],
+                tasks: new Map(),
+                relatedSkills: new Set(),
+            };
+            group.sessions.push(session);
+            group.relatedSkills.add(session.skillName);
+            const attributedIds = new Set(session.attributedEventIds);
+            for (const turn of session.turns) {
+                const related = turn.eventIds.some((id) => attributedIds.has(id));
+                const existing = group.tasks.get(turn.turnId);
+                if (!existing || turn.eventIds.length > existing.turn.eventIds.length) {
+                    group.tasks.set(turn.turnId, {
+                        turn,
+                        experienceSessionId: session.id,
+                        relatedSkills: new Set(existing?.relatedSkills ?? []),
+                    });
+                }
+                if (related) {
+                    const task = group.tasks.get(turn.turnId);
+                    task?.relatedSkills.add(session.skillName);
+                    if (task && task.experienceSessionId !== session.id) {
+                        task.experienceSessionId = session.id;
+                    }
+                }
+            }
+            groups.set(session.threadId, group);
+        }
+    }
+    const conversations = Array.from(groups.values())
+        .map(finalizeConversation)
+        .filter((conversation) => conversation.tasks.length > 0)
+        .sort((left, right) => ((right.endTimestamp ?? '').localeCompare(left.endTimestamp ?? '')
+        || left.threadId.localeCompare(right.threadId)));
+    return {
+        conversations,
+        totalTurnCount: conversations.reduce((sum, item) => sum + (item.turnCount ?? 0), 0),
+        totalToolCallCount: conversations.reduce((sum, item) => sum + (item.toolCallCount ?? 0), 0),
+        totalToolFailureCount: conversations.reduce((sum, item) => sum + (item.toolFailureCount ?? 0), 0),
+    };
+}
+/** Test/compatibility adapter for persisted observe reports. */
+export function createObservationConversationCatalog(observationsDir) {
+    return {
+        async listConversations() {
+            return buildConversationIndexViewModel(observationsDir);
+        },
+        async getConversation(threadId) {
+            return buildConversationIndexViewModel(observationsDir).conversations.find((item) => item.threadId === threadId);
+        },
+        async loadTaskTrajectory() {
+            return undefined;
+        },
+    };
+}
+function finalizeConversation(group) {
+    const tasks = Array.from(group.tasks.values())
+        .map(({ turn, experienceSessionId, relatedSkills }) => ({
+        turnId: turn.turnId,
+        sourceTurnId: turn.sourceTurnId,
+        experienceSessionId,
+        title: turn.title,
+        startTimestamp: turn.startTimestamp,
+        endTimestamp: turn.endTimestamp,
+        durationMs: durationMsBetween(turn.startTimestamp, turn.endTimestamp),
+        status: turn.status,
+        eventCount: turn.eventIds.length,
+        toolCallCount: turn.toolCallCount,
+        toolFailureCount: turn.toolFailureCount,
+        relatedSkillNames: Array.from(relatedSkills).sort(),
+    }))
+        .sort((left, right) => ((left.startTimestamp ?? '').localeCompare(right.startTimestamp ?? '')
+        || left.turnId.localeCompare(right.turnId)));
+    const firstTask = tasks[0];
+    const lastTask = tasks.at(-1);
+    return {
+        threadId: group.threadId,
+        sourceThreadId: group.sourceThreadId,
+        sourceKind: group.sourceKind,
+        title: firstTask?.title ?? '未命名对话',
+        startTimestamp: firstTask?.startTimestamp,
+        endTimestamp: lastTask?.endTimestamp ?? lastTask?.startTimestamp,
+        durationMs: durationMsBetween(firstTask?.startTimestamp, lastTask?.endTimestamp ?? lastTask?.startTimestamp),
+        turnCount: tasks.length,
+        toolCallCount: tasks.reduce((sum, task) => sum + task.toolCallCount, 0),
+        toolFailureCount: tasks.reduce((sum, task) => sum + task.toolFailureCount, 0),
+        relatedSkillNames: Array.from(group.relatedSkills).sort(),
+        tasks,
+    };
+}

package/dist/observability/experience.d.ts

@@ -15,7 +15,7 @@ export type PersistedExperienceSessionStory = Omit<ExperienceSessionStory, 'cont
 export type PersistedExperienceReviewerReport = Omit<ExperienceReviewerReport, 'sessionStory' | 'sessionStoryRef'> & {
     sessionStoryRef: 'session';
 };
-export type PersistedExperienceSession = Omit<ExperienceSessionSummary, 'timelineRef' | 'timelinePreviewEventIds' | 'timelinePreview' | 'fullSessionTimeline' | 'timelineTree' | 'sessionStory' | 'reviewerReport'> & {
+export type PersistedExperienceSession = Omit<ExperienceSessionSummary, 'timelineRef' | 'timelinePreviewEventIds' | 'attributedEventIds' | 'timelinePreview' | 'fullSessionTimeline' | 'timelineTree' | 'sessionStory' | 'reviewerReport'> & {
     timelineRef: string;
     timelinePreviewEventIds: string[];
     sessionStory?: PersistedExperienceSessionStory;
@@ -41,6 +41,8 @@ export declare function normalizeObservationExperienceReport(value: unknown): Ob
  * invocation/session views through normalizeObservationExperienceReport().
  */
 export declare function compactObservationExperienceReport(report: ObservationExperienceReport): PersistedObservationExperienceReport;
+/** Project one source-neutral Trace IR session into Studio's semantic timeline. */
+export declare function projectTraceSessionTimeline(session: TraceSession): ExperienceTimelineEvent[];
 export declare function isExperienceTraceInProgress(session: ExperienceSessionSummary): boolean;
 export declare function hasRecognizableUserGoalText(value: string | undefined): boolean;
 export declare function foldExperienceChecklistItems(items: ExperienceChecklistItem[]): {

package/dist/observability/experience.js

@@ -6,6 +6,7 @@ import { observationMetricAnnotationVerdict, observationReviewStateKey } from '.
 import { correlateTraceToolEvents, normalizeTraceTimestamp, } from './trace-ir.js';
 import { skillSegmentTimestampObserved, UNOBSERVED_TRACE_TIMESTAMP, } from './trace-segmenter.js';
 import { createTraceSessionIndex, traceSessionRefIdentity } from './trace-session-index.js';
+import { reconstructExperienceTurns } from './turn-index.js';
 import { extractCommandEnvelopeText, stripCommandEnvelopeText } from './trace-attribution.js';
 import { hasAssistantDeliverableArtifactText, hasAssistantDeliverySignalText, hasUserHardRuleText, isAssistantProgressUpdateText, isAssistantProtocolReplyText, isSyntheticUserMessageText, isToolResultFailureText, isUserInteractionMetricText } from './text-signals.js';
 import { durationMsBetween } from '../shared/time.js';
@@ -290,6 +291,8 @@ function normalizeExperienceSessionShells(values, strict) {
         return null;
     if (records.some((value) => typeof value.id !== 'string'
         || typeof value.skillName !== 'string'
+        || !isOptionalString(value.threadId)
+        || !isOptionalString(value.sourceThreadId)
         || typeof value.sessionId !== 'string'
         || typeof value.sourceTrace !== 'string'
         || !isObservationSourceKind(value.sourceKind)
@@ -326,6 +329,7 @@ function normalizeExperienceSessionShells(values, strict) {
         || !isExperienceAssistiveInference(value.assistiveInference)
         || !isExperienceProblemPatternArray(value.problemPatterns)
         || !isStringArray(value.relatedObservationIds)
+        || (value.turns !== undefined && !isExperienceTurnSummaryArray(value.turns))
         || !(strict
             ? isExperienceTimelineScope(value.timelineScope)
             : isLegacyExperienceTimelineScope(value.timelineScope))
@@ -350,6 +354,14 @@ function normalizeExperienceSessionShells(values, strict) {
             && !isExperienceReviewerReport(value.reviewerReport, strict))))
         return null;
     return records.map((value) => {
+        const sourceThreadId = typeof value.sourceThreadId === 'string'
+            ? value.sourceThreadId
+            : typeof value.threadId === 'string'
+                ? value.threadId
+                : value.sessionId;
+        const threadId = typeof value.threadId === 'string'
+            ? value.threadId
+            : hashParts('thread', sourceThreadId);
         const sessionStory = isObjectRecord(value.sessionStory)
             ? {
                 ...value.sessionStory,
@@ -362,7 +374,10 @@ function normalizeExperienceSessionShells(values, strict) {
             : undefined;
         return {
             ...value,
+            threadId,
+            sourceThreadId,
             invocationIds: Array.isArray(value.invocationIds) ? value.invocationIds : [],
+            turns: isExperienceTurnSummaryArray(value.turns) ? value.turns : [],
             timelinePreview: Array.isArray(value.timelinePreview) ? value.timelinePreview : [],
             fullSessionTimeline: Array.isArray(value.fullSessionTimeline) ? value.fullSessionTimeline : [],
             sessionStory,
@@ -491,10 +506,13 @@ function isExperienceEvidenceKind(value) {
         'user_message',
         'synthetic_user_event',
         'assistant_message',
+        'model_activity',
+        'agent_activity',
         'tool_use',
         'tool_result',
         'skill_context',
         'runtime_context',
+        'lifecycle',
         'observation',
     ]);
 }
@@ -511,13 +529,26 @@ function isExperienceEvidenceRef(value) {
     if (value.traceRole !== undefined
         && !isEnumValue(value.traceRole, ['standalone', 'main', 'subagent']))
         return false;
+    if (value.modelActivityKind !== undefined && value.modelActivityKind !== 'reasoning')
+        return false;
+    if (value.contentVisibility !== undefined
+        && !isEnumValue(value.contentVisibility, ['plaintext', 'opaque']))
+        return false;
+    if (value.contentSource !== undefined
+        && !isEnumValue(value.contentSource, ['summary', 'content', 'text']))
+        return false;
+    if (value.runtimeKind !== undefined
+        && !isEnumValue(value.runtimeKind, ['session_context', 'execution_context', 'settings', 'goal', 'context_compaction', 'usage']))
+        return false;
     if (value.role !== undefined
         && !isEnumValue(value.role, ['user', 'assistant', 'tool', 'other']))
         return false;
     return [
         value.traceLabel,
         value.traceId,
+        value.turnId,
         value.messageUuid,
+        value.sourceType,
         value.callInstanceId,
         value.toolUseId,
         value.label,
@@ -880,10 +911,13 @@ function isTimelineEvent(value) {
             'user_message',
             'synthetic_user_event',
             'assistant_message',
+            'model_activity',
+            'agent_activity',
             'tool_use',
             'tool_result',
             'skill_context',
             'runtime_context',
+            'lifecycle',
             'observation',
         ].includes(String(value.kind))
         || typeof value.sourceTrace !== 'string'
@@ -914,10 +948,32 @@ function isTimelineEvent(value) {
         && value.toolStatus !== 'cancelled'
         && value.toolStatus !== 'unknown')
         return false;
+    if (value.modelActivityKind !== undefined && value.modelActivityKind !== 'reasoning')
+        return false;
+    if (value.contentVisibility !== undefined
+        && value.contentVisibility !== 'plaintext'
+        && value.contentVisibility !== 'opaque')
+        return false;
+    if (value.contentSource !== undefined
+        && value.contentSource !== 'summary'
+        && value.contentSource !== 'content'
+        && value.contentSource !== 'text')
+        return false;
+    if (value.runtimeKind !== undefined
+        && value.runtimeKind !== 'session_context'
+        && value.runtimeKind !== 'execution_context'
+        && value.runtimeKind !== 'settings'
+        && value.runtimeKind !== 'goal'
+        && value.runtimeKind !== 'context_compaction'
+        && value.runtimeKind !== 'usage')
+        return false;
     const optionalStrings = [
         value.traceId,
         value.traceLabel,
+        value.turnId,
         value.messageUuid,
+        value.sourceType,
+        value.model,
         value.callInstanceId,
         value.toolUseId,
         value.label,
@@ -937,6 +993,29 @@ function isTimelineEvent(value) {
 function isTimelineEventArray(value) {
     return Array.isArray(value) && value.every(isTimelineEvent);
 }
+function isExperienceTurnSummaryArray(value) {
+    return Array.isArray(value) && value.every((turn) => (isObjectRecord(turn)
+        && typeof turn.turnId === 'string'
+        && isOptionalString(turn.sourceTurnId)
+        && (turn.boundaryBasis === 'turn_id'
+            || turn.boundaryBasis === 'turn_lifecycle'
+            || turn.boundaryBasis === 'user_message')
+        && isOptionalString(turn.traceId)
+        && typeof turn.sourceTrace === 'string'
+        && isOptionalTimestamp(turn.startTimestamp)
+        && isOptionalTimestamp(turn.endTimestamp)
+        && (turn.status === 'completed'
+            || turn.status === 'aborted'
+            || turn.status === 'interrupted'
+            || turn.status === 'open'
+            || turn.status === 'unknown')
+        && typeof turn.title === 'string'
+        && isStringArray(turn.eventIds)
+        && isNonNegativeInteger(turn.userMessageCount)
+        && isNonNegativeInteger(turn.assistantMessageCount)
+        && isNonNegativeInteger(turn.toolCallCount)
+        && isNonNegativeInteger(turn.toolFailureCount)));
+}
 function isTimelineTree(value) {
     if (!isObjectRecord(value)
         || typeof value.sessionId !== 'string'
@@ -1455,6 +1534,7 @@ export function compactObservationExperienceReport(report) {
         sessions: hydrated.sessions.map((session) => {
             const { timelinePreview, sessionStory, reviewerReport } = session;
             const persisted = omitProperties(session, [
+                'attributedEventIds',
                 'timelinePreview',
                 'fullSessionTimeline',
                 'timelineTree',
@@ -1533,11 +1613,18 @@ function hydrateExperienceTimelines(report) {
         const fullSessionTimeline = storedTimeline
             ? flattenedTimeline(timelineRef)
             : session.fullSessionTimeline;
+        const turns = session.turns.length > 0
+            ? session.turns
+            : reconstructExperienceTurns(fullSessionTimeline);
         const timelinePreviewEventIds = session.timelinePreviewEventIds
             ?? session.timelinePreview.map((event) => event.id);
         const timelinePreview = timelinePreviewEventIds.length > 0
             ? selectEvents(timelineRef, timelinePreviewEventIds, session.timelinePreview)
             : fullSessionTimeline.slice(0, TIMELINE_PREVIEW_EVENT_LIMIT);
+        const attributedEventIds = unique(session.invocationIds.flatMap((id) => {
+            const invocation = invocationById.get(id);
+            return invocation?.timelineEventIds ?? invocation?.timeline.map((event) => event.id) ?? [];
+        }));
         const contextRef = session.sessionStory?.contextRef
             ?? storyContextRefForSessionGroup(firstInvocation?.sessionGroupKey ?? session.sessionId);
         const storyContext = storyContextById.get(contextRef);
@@ -1554,9 +1641,11 @@ function hydrateExperienceTimelines(report) {
         return {
             ...session,
             timelineRef,
+            attributedEventIds,
             timelinePreviewEventIds: timelinePreview.map((event) => event.id),
             timelinePreview,
             fullSessionTimeline,
+            turns,
             timelineTree: storedTimeline?.tree ?? session.timelineTree,
             sessionStory,
             reviewerReport: session.reviewerReport && sessionStory
@@ -1962,7 +2051,8 @@ function timelineScopeMatches(session, invocations, timeline) {
         ? events.length - 1 - Math.max(...previewPositions)
         : 0;
     const scope = session.timelineScope;
-    return scope.segmentEventCount === invocationEventIds.size
+    return sameStringSet(session.attributedEventIds, invocationEventIds)
+        && scope.segmentEventCount === invocationEventIds.size
         && scope.previewEventCount === previewEventIds.length
         && scope.fullSessionEventCount === events.length
         && traceRecordRangesEqual(scope.segmentRecordRanges, traceRecordRanges(invocationEvents))
@@ -2138,6 +2228,11 @@ function countRecordsEqual(left, right) {
 function sameStringArray(left, right) {
     return left.length === right.length && left.every((value, index) => value === right[index]);
 }
+function sameStringSet(left, right) {
+    return left.length === right.size
+        && new Set(left).size === left.length
+        && left.every((value) => right.has(value));
+}
 function storyContextsFromSessions(sessions, invocations) {
     const invocationById = new Map(invocations.map((invocation) => [invocation.id, invocation]));
     const contexts = new Map();
@@ -2386,6 +2481,10 @@ function buildTimelineWindow(session, start, end) {
     }
     return events.sort((a, b) => a.order - b.order);
 }
+/** Project one source-neutral Trace IR session into Studio's semantic timeline. */
+export function projectTraceSessionTimeline(session) {
+    return buildTimelineWindow(session, 0, session.events.length);
+}
 function timelineEventsFromTraceEvent(session, event, eventIndex) {
     const messageIndex = event.sourceIndex;
     const base = {
@@ -2398,6 +2497,8 @@ function timelineEventsFromTraceEvent(session, event, eventIndex) {
         logicalMessageIndex: messageIndex,
         sourceLineIndex: messageIndex,
         messageUuid: event.sourceEventId ?? event.eventId,
+        sourceType: event.sourceType,
+        turnId: event.turnId,
         timestamp: event.timestamp,
     };
     const order = eventIndex * 10;
@@ -2422,11 +2523,27 @@ function timelineEventsFromTraceEvent(session, event, eventIndex) {
                 kind: protocolReply ? 'runtime_context' : 'assistant_message',
                 role: 'assistant',
                 order,
+                model: event.model,
                 snippet: snippet(event.text, 700),
                 fullText: fullText(event.text),
                 label: protocolReply ? 'assistant protocol reply' : 'assistant message',
             })];
     }
+    if (event.eventKind === 'model_activity') {
+        return [timelineEvent({
+                ...base,
+                kind: 'model_activity',
+                role: 'assistant',
+                order,
+                model: event.model,
+                modelActivityKind: event.activityKind,
+                contentVisibility: event.contentVisibility,
+                contentSource: event.contentSource,
+                snippet: snippet(event.text, 700),
+                fullText: fullText(event.text),
+                label: 'model reasoning',
+            })];
+    }
     if (event.eventKind === 'tool_call') {
         const inputText = JSON.stringify(event.input);
         return [timelineEvent({
@@ -2464,7 +2581,7 @@ function timelineEventsFromTraceEvent(session, event, eventIndex) {
     if (event.eventKind === 'lifecycle') {
         return [timelineEvent({
                 ...base,
-                kind: 'runtime_context',
+                kind: 'lifecycle',
                 role: 'other',
                 order,
                 snippet: snippet(`${event.phase}${event.reason ? `: ${event.reason}` : ''}`, 700),
@@ -2472,6 +2589,111 @@ function timelineEventsFromTraceEvent(session, event, eventIndex) {
                 label: event.phase,
             })];
     }
+    if (event.eventKind === 'runtime_context') {
+        const details = JSON.stringify({
+            runtimeName: event.runtimeName,
+            runtimeVersion: event.runtimeVersion,
+            cwd: event.cwd,
+            workspaceRoots: event.workspaceRoots,
+            currentDate: event.currentDate,
+            timezone: event.timezone,
+            model: event.model,
+            modelProvider: event.modelProvider,
+            serviceTier: event.serviceTier,
+            reasoningEffort: event.reasoningEffort,
+            reasoningSummary: event.reasoningSummary,
+            personality: event.personality,
+            approvalPolicy: event.approvalPolicy,
+            approvalReviewer: event.approvalReviewer,
+            permissionProfile: event.permissionProfile,
+            sandboxMode: event.sandboxMode,
+            collaborationMode: event.collaborationMode,
+            realtimeActive: event.realtimeActive,
+            multiAgentMode: event.multiAgentMode,
+            multiAgentVersion: event.multiAgentVersion,
+            memoryMode: event.memoryMode,
+            historyMode: event.historyMode,
+            contextWindowId: event.contextWindowId,
+            availableTools: event.availableTools,
+            instructions: event.instructions,
+            goal: event.goal,
+            goalStatus: event.goalStatus,
+            summary: event.summary,
+        });
+        const visible = event.summary
+            ?? event.goal
+            ?? event.instructions
+            ?? [event.runtimeName, event.runtimeVersion, event.cwd, event.model, event.reasoningEffort, event.collaborationMode]
+                .filter(Boolean)
+                .join(' · ');
+        return [timelineEvent({
+                ...base,
+                kind: 'runtime_context',
+                role: 'other',
+                order,
+                model: event.model,
+                runtimeKind: event.runtimeKind,
+                snippet: snippet(visible, 700),
+                fullText: fullText(details),
+                label: event.runtimeKind,
+            })];
+    }
+    if (event.eventKind === 'context_compaction') {
+        return [timelineEvent({
+                ...base,
+                kind: 'runtime_context',
+                role: 'other',
+                order,
+                runtimeKind: 'context_compaction',
+                snippet: snippet(event.summary ?? 'context compacted', 700),
+                fullText: fullText(JSON.stringify(event)),
+                label: 'context compacted',
+            })];
+    }
+    if (event.eventKind === 'agent_activity') {
+        const visible = event.text
+            ?? [event.activity, event.author, event.recipient, event.agentPath, event.agentId]
+                .filter(Boolean)
+                .join(' · ');
+        return [timelineEvent({
+                ...base,
+                kind: 'agent_activity',
+                role: 'other',
+                order,
+                snippet: snippet(visible, 700),
+                fullText: fullText(JSON.stringify({
+                    activityKind: event.activityKind,
+                    activity: event.activity,
+                    author: event.author,
+                    recipient: event.recipient,
+                    agentId: event.agentId,
+                    agentPath: event.agentPath,
+                    text: event.text,
+                })),
+                label: event.activityKind === 'communication' ? 'agent communication' : 'agent status',
+            })];
+    }
+    if (event.eventKind === 'usage') {
+        const usageText = JSON.stringify({
+            model: event.model,
+            inputTokens: event.inputTokens,
+            outputTokens: event.outputTokens,
+            cacheReadTokens: event.cacheReadTokens,
+            cacheCreationTokens: event.cacheCreationTokens,
+            reasoningTokens: event.reasoningTokens,
+        });
+        return [timelineEvent({
+                ...base,
+                kind: 'runtime_context',
+                role: 'other',
+                order,
+                model: event.model,
+                runtimeKind: 'usage',
+                snippet: snippet(usageText, 700),
+                fullText: fullText(usageText),
+                label: 'token usage',
+            })];
+    }
     if (event.eventKind === 'unknown') {
         const rawText = safeRecordText(event.raw);
         if (!hasAssistantTurnFailedText(rawText))
@@ -2503,7 +2725,12 @@ function userTimelineEvents(event, base, order) {
         }));
     }
     const text = commandEnvelope ? stripCommandEnvelopeText(event.text) : event.text;
-    if (!text.trim())
+    const displayedSourceText = event.displayText?.trim() || event.text;
+    const displayText = commandEnvelope
+        ? stripCommandEnvelopeText(displayedSourceText)
+        : displayedSourceText;
+    const semanticText = event.origin === 'human' ? displayText : text;
+    if (!semanticText.trim())
         return events;
     const kind = event.origin === 'human'
         ? 'user_message'
@@ -2517,8 +2744,8 @@ function userTimelineEvents(event, base, order) {
         kind,
         role: kind === 'user_message' ? 'user' : kind === 'synthetic_user_event' ? 'other' : 'tool',
         order: order + (commandEnvelope ? 1 : 0),
-        snippet: snippet(text, 700),
-        fullText: fullText(text),
+        snippet: snippet(semanticText, 700),
+        fullText: fullText(semanticText),
         label: userTextEventLabel(kind),
     }));
     return events;
@@ -2585,6 +2812,11 @@ function evidenceRefFromTimeline(event) {
         toolUseId: event.toolUseId,
         timestamp: event.timestamp,
         role: event.role,
+        modelActivityKind: event.modelActivityKind,
+        contentVisibility: event.contentVisibility,
+        contentSource: event.contentSource,
+        sourceType: event.sourceType,
+        runtimeKind: event.runtimeKind,
         label: event.label,
         snippet: event.snippet,
     };
@@ -2841,12 +3073,19 @@ function summarizeExperienceSessions(invocations, sessionGroupsByKey, generatedA
         const ruleFindings = ruleFindingsForEvidence(indicators, timeline, observationRefs, evidenceChain, metricScopeId);
         const assistiveInference = assistiveInferenceForEvidence(indicators, evidenceChain, ruleFindings);
         const problemPatterns = mergeExperienceProblemPatterns(group.flatMap((invocation) => invocation.problemPatterns));
+        const sourceThreadId = sessionGroup.find((session) => session.role === 'main')?.rootRunId
+            ?? sessionGroup[0]?.rootRunId
+            ?? first.sessionId;
+        const threadId = hashParts('thread', first.sessionGroupKey);
+        const turns = reconstructExperienceTurns(fullSessionTimeline);
         const storyInvocations = invocations
             .filter((invocation) => invocation.sessionGroupKey === first.sessionGroupKey)
             .sort(compareStoryInvocations);
         const baseSession = {
             id: metricScopeId,
             skillName: first.skillName,
+            threadId,
+            sourceThreadId,
             sessionId: first.sessionId,
             sourceTrace: first.sourceTrace,
             sourceKind: first.sourceKind,
@@ -2873,6 +3112,8 @@ function summarizeExperienceSessions(invocations, sessionGroupsByKey, generatedA
             relatedObservationIds,
             timelineRef: timelineRefForSessionGroup(first.sessionGroupKey),
             timelinePreviewEventIds: previewEvents.map((event) => event.id),
+            attributedEventIds: timeline.map((event) => event.id),
+            turns,
             timelinePreview: previewEvents,
             fullSessionTimeline,
             timelineTree,
@@ -3591,7 +3832,7 @@ function dispatchTerminalLifecycle(session, dispatch) {
         || candidate.traceId === dispatch.traceId
         || candidate.sourceTrace === dispatch.sourceTrace);
     const event = branch?.events.at(-1);
-    if (event?.kind !== 'runtime_context')
+    if (event?.kind !== 'lifecycle' && event?.kind !== 'runtime_context')
         return undefined;
     if (event.label === 'turn_completed' || event.label === 'session_ended') {
         return { status: 'completed', evidenceRef: evidenceRefFromTimeline(event) };
@@ -5104,7 +5345,7 @@ function userFeedbackStepText(session, reviewState) {
         feedbackCounts.positiveFeedbackCount > 0 ? `正向反馈 ${feedbackCounts.positiveFeedbackCount} 次` : '',
         session.indicators.userGoalShiftCount > 0 ? `目标切换 ${session.indicators.userGoalShiftCount} 次` : '',
     ].filter(Boolean);
-    return parts.length > 0 ? `用户反馈信号：${parts.join('，')}。` : '原始记录里没有看到人工追问、纠正、负向反馈或目标切换。';
+    return parts.length > 0 ? `用户反馈信号：${parts.join('，')}。` : '原始日志里没有看到人工追问、纠正、负向反馈或目标切换。';
 }
 function userFeedbackStepStatus(session, reviewState) {
     const feedbackCounts = canonicalFeedbackCountsForSession(session, reviewState);

package/dist/observability/inbox.js

@@ -18,6 +18,7 @@ import { parseTraceIngestionSummary } from './trace-ingestion.js';
 import { createTraceSessionIndex, traceSessionRefIdentity } from './trace-session-index.js';
 import { isInstalledSkillAssetPath } from './trace-attribution.js';
 import { writeJsonFileAtomic } from '../shared/atomic-json.js';
+import { writeObservationSourceRecordArchives } from './source-record-archive.js';
 // observe inbox（观测收件箱）产物根目录。导出名沿用 *_OBSERVATIONS_DIR 以少动 importer,
 // 但落盘目录已统一到 observe-inbox 词根(命令 omk observe inbox / kind observe-inbox)。
 // 项目级 .omk/observe-inbox 优先、全局兜底 —— 这套 project/global 归属是既有正常行为,本次只改名不改归属。
@@ -700,7 +701,14 @@ export function saveObservationInboxReport(report, outDir = DEFAULT_OBSERVATIONS
     // 例: '2026-05-07T12:00:00.999Z' → '2026-05-07T12-00-00-999'
     const stamp = report.meta.generatedAt.replace(/[:.]/g, '-').replace(/Z$/, '');
     const path = reportFilePath(outDir, `${stamp}-${randomRunToken()}`);
-    writeJsonFileAtomic(path, compact);
+    const sourceRecordArchives = writeObservationSourceRecordArchives(report, outDir, path);
+    const persisted = sourceRecordArchives.length > 0
+        ? { ...compact, meta: { ...compact.meta, sourceRecordArchives } }
+        : compact;
+    if (!normalizeObservationInboxReport(persisted)) {
+        throw new Error('拒绝写入原始日志引用无效的 observe inbox 报告。');
+    }
+    writeJsonFileAtomic(path, persisted);
     return path;
 }
 export function compactObservationInboxReport(report) {
@@ -790,6 +798,11 @@ function normalizeObservationInboxReport(value) {
     };
 }
 function observationInboxReferencesAreConsistent(meta, items, experience) {
+    const archiveRefs = meta.sourceRecordArchives ?? [];
+    const experienceSessionIds = new Set(experience?.sessions.map((session) => session.id) ?? []);
+    if (new Set(archiveRefs.map((ref) => ref.experienceSessionId)).size !== archiveRefs.length
+        || archiveRefs.some((ref) => !experienceSessionIds.has(ref.experienceSessionId)))
+        return false;
     const itemIds = new Set(items.map((item) => item.id));
     if (itemIds.size !== items.length)
         return false;
@@ -888,7 +901,10 @@ function isObservationInboxMeta(value) {
             && !isInboxTimestampRecord(value.skillInvocationLastSeen))
         || (value.skillToolCallCounts !== undefined
             && (!isInboxRecord(value.skillToolCallCounts)
-                || !Object.values(value.skillToolCallCounts).every(isInboxCountRecord))))
+                || !Object.values(value.skillToolCallCounts).every(isInboxCountRecord)))
+        || (value.sourceRecordArchives !== undefined
+            && (!Array.isArray(value.sourceRecordArchives)
+                || !value.sourceRecordArchives.every(isObservationSourceRecordArchiveRef))))
         return false;
     if (value.sessionTimeRange !== undefined
         && (!isInboxRecord(value.sessionTimeRange)
@@ -914,6 +930,28 @@ function isObservationInboxMeta(value) {
         || (Array.isArray(value.sessionTimeRanges)
             && value.sessionTimeRanges.every(isObservationSessionTimeRange));
 }
+function isObservationSourceRecordArchiveRef(value) {
+    if (!isInboxRecord(value)
+        || typeof value.experienceSessionId !== 'string'
+        || !['available', 'partial', 'unavailable'].includes(String(value.status))
+        || (value.relativePath !== undefined && typeof value.relativePath !== 'string')
+        || !isInboxCount(value.recordCount)
+        || !isInboxCount(value.omittedRecordCount)
+        || !isInboxCount(value.byteCount)
+        || typeof value.truncated !== 'boolean')
+        return false;
+    if (value.status === 'unavailable' && value.relativePath !== undefined)
+        return false;
+    if (value.status !== 'unavailable' && typeof value.relativePath !== 'string')
+        return false;
+    return value.reason === undefined || [
+        'no_record_ranges',
+        'source_missing',
+        'unsupported_source',
+        'read_failed',
+        'archive_limit',
+    ].includes(String(value.reason));
+}
 function isObservationSessionTimeRange(value) {
     return isInboxRecord(value)
         && typeof value.sessionId === 'string'

package/dist/observability/knowledge-debugger.d.ts

@@ -0,0 +1,4 @@
+import type { DebugKnowledgeEvidence, ExperienceTimelineEvent, KnowledgeDebuggerViewModel, ObservationSourceRecordArchiveView, TaskTrajectorySession, TaskReplayStep, TraceIngestionSummary } from '../types/index.js';
+export declare function buildKnowledgeDebuggerViewModel(session: TaskTrajectorySession, targetTurnId: string, ingestion?: TraceIngestionSummary, sourceRecords?: ObservationSourceRecordArchiveView): KnowledgeDebuggerViewModel;
+export declare function buildTaskReplaySteps(session: TaskTrajectorySession, timeline: ExperienceTimelineEvent[], knowledgeEvidence: DebugKnowledgeEvidence[]): TaskReplayStep[];
+export declare function projectKnowledgeEvidence(timeline: ExperienceTimelineEvent[]): DebugKnowledgeEvidence[];