oh-my-knowledge 0.30.0 → 0.32.0

package/dist/types/observability.d.ts

@@ -0,0 +1,865 @@
+/**
+ * Observability DTO 集中定义。
+ *
+ * 解开 `src/observability/` 内部 4 个文件(experience / inbox / skill-chain /
+ * experience-frontmatter)之间的 type-only 循环依赖：types/ 是叶子层，不依赖
+ * 任何业务模块；observability/ 的运行时文件向这里 import 类型即可。
+ *
+ * 设计原则：
+ *   - 只放纯 DTO(string union / interface / 类型别名)，不放任何运行时函数 / 常量
+ *   - 不依赖 src 内的业务模块(observability / cli / server / renderer / diagnosis)
+ *   - 跨层共享类型集中在 types/，单一来源
+ */
+import type { DiagnosisBundle } from './diagnosis.js';
+import type { SkillHardRule, SkillWorkflow } from '../shared/hard-rules.js';
+export interface TraceSourceMetadata {
+    channel?: string;
+    sender?: string;
+    senderId?: string;
+    provider?: string;
+    model?: string;
+    modelApi?: string;
+    businessActions?: string[];
+}
+export type ObservationReviewTargetType = 'experience_session' | 'inbox_item' | 'skill' | 'goal_slice_correction' | 'evidence_metric' | 'reviewer_judgment' | 'soft_standard' | 'goal_keyword_correction' | 'result_artifact_correction' | 'completion_result_correction' | 'deliverable_artifact_correction' | 'skill_relevance_correction' | 'workflow_completion_correction' | 'hardrule_execution_correction' | 'main_tool_execution_correction';
+export type ObservationReviewVerdict = 'reviewed' | 'real_issue' | 'not_issue' | 'needs_more_context' | 'confirmed' | 'rejected';
+export type ObservationMetricKey = 'user_correction' | 'user_interruption' | 'user_follow_up' | 'negative_feedback' | 'positive_feedback' | 'hard_rule' | 'user_goal_shift' | 'result_artifact' | 'completion_result' | 'deliverable_artifact' | 'progress_update' | 'self_correction' | 'repeated_execution';
+export type ObservationMetricScope = 'message' | 'skill_segment';
+export interface ObservationReviewStateEntry {
+    targetType: ObservationReviewTargetType;
+    targetId: string;
+    verdict: ObservationReviewVerdict;
+    reviewedAt: string;
+    note?: string;
+    reason?: string;
+    metricKey?: ObservationMetricKey;
+    metricScope?: ObservationMetricScope;
+    metricScopeId?: string;
+    sourceTrace?: string;
+    sessionId?: string;
+    messageIndex?: number;
+    messageUuid?: string;
+    toolUseId?: string;
+    snippet?: string;
+}
+export interface ObservationReviewState {
+    kind: 'observe-review-state';
+    schemaVersion: 1;
+    updatedAt: string;
+    entries: Record<string, ObservationReviewStateEntry>;
+}
+export interface ObservationReviewStateUpdate {
+    targetType: ObservationReviewTargetType;
+    targetId: string;
+    verdict: ObservationReviewVerdict;
+    note?: string;
+    reason?: string;
+    metricKey?: ObservationMetricKey;
+    metricScope?: ObservationMetricScope;
+    metricScopeId?: string;
+    sourceTrace?: string;
+    sessionId?: string;
+    messageIndex?: number;
+    messageUuid?: string;
+    toolUseId?: string;
+    snippet?: string;
+}
+export type ExperienceProblemBucket = 'output_format' | 'content_accuracy' | 'missing_context' | 'rule_violation' | 'workflow_mismatch' | 'tool_runtime' | 'goal_shift' | 'unclear';
+export type ExperienceProblemSignal = 'user_correction' | 'negative_feedback' | 'user_interruption' | 'hard_rule' | 'user_goal_shift' | 'tool_failure' | 'workflow_mismatch' | 'artifact_missing' | 'observer_lifecycle_failed' | 'orchestration_boundary_violation';
+export interface ExperienceProblemEvidenceRef {
+    id: string;
+    kind: string;
+    sourceTrace: string;
+    sessionId: string;
+    messageIndex?: number;
+    logicalMessageIndex?: number;
+    sourceLineIndex?: number;
+    messageUuid?: string;
+    toolUseId?: string;
+    timestamp?: string;
+    role?: 'user' | 'assistant' | 'tool' | 'other';
+    label?: string;
+    snippet?: string;
+}
+export interface ExperienceProblemPattern {
+    id: string;
+    bucket: ExperienceProblemBucket;
+    patternKey: string;
+    count: number;
+    sessionCount: number;
+    recentSessionIds: string[];
+    signalTypes: ExperienceProblemSignal[];
+    evidenceRefs: ExperienceProblemEvidenceRef[];
+    lastSeen?: string;
+}
+export interface ProblemTimelineEvent {
+    id: string;
+    kind: string;
+    sourceTrace: string;
+    sessionId: string;
+    messageIndex?: number;
+    logicalMessageIndex?: number;
+    sourceLineIndex?: number;
+    messageUuid?: string;
+    toolUseId?: string;
+    timestamp?: string;
+    role?: 'user' | 'assistant' | 'tool' | 'other';
+    label?: string;
+    snippet?: string;
+    fullText?: string;
+    toolName?: string;
+    isError?: boolean;
+}
+export type SkillChainAdvisoryCode = 'hardrules_not_declared' | 'workflows_not_declared' | 'skill_md_not_found';
+export interface SkillChainAdvisory {
+    code: SkillChainAdvisoryCode;
+    message: string;
+    exampleYaml?: string;
+    commandTemplate?: string;
+    shortLabel: string;
+}
+export type ObservationSignalType = 'failed_search' | 'repeated_failure' | 'hedging' | 'explicit_marker';
+export type ObservationSourceKind = 'claude' | 'openclaw' | 'markdown_log' | 'unknown';
+export type ObservationSeverityReasonCode = 'knowledge_gap_suspected' | 'repeated_failure_suspected' | 'explicit_gap_marker' | 'exploratory_probe' | 'skill_asset_unavailable' | 'soft_hedging_signal' | 'tool_or_runtime_noise';
+export type ObservationSignalSubtype = 'hard_miss' | 'repeated_failure' | 'exploratory_miss' | 'tool_error' | 'permission_error' | 'bash_probe' | 'not_found' | 'transient_file_missing' | 'skill_asset_read_failed' | 'permission_denied' | 'tool_limit' | 'tool_failure' | 'regex_only' | 'llm_classified' | 'marker';
+export interface ObservationEvidence {
+    tool?: string;
+    query?: string;
+    path?: string;
+    outputSnippet?: string;
+    assistantSnippet?: string;
+    markerToken?: string;
+    messageIndex?: number;
+    messageUuid?: string;
+    toolUseId?: string;
+    segmentTimestamp?: string;
+}
+export interface ObservationMessageRef {
+    role: 'user' | 'assistant' | 'other';
+    snippet: string;
+    messageIndex: number;
+    uuid?: string;
+    timestamp?: string;
+}
+export interface ObservationMessageWindow {
+    before: ObservationMessageRef[];
+    event: ObservationMessageRef[];
+    after: ObservationMessageRef[];
+    resolutionAfter: 'resolved' | 'unresolved' | 'unknown';
+}
+export interface ObservationInboxItem {
+    id: string;
+    skillName: string;
+    artifactVersion: string | 'unknown';
+    artifactHash?: string;
+    cwd?: string;
+    sessionId: string;
+    sourceTrace: string;
+    sourceKind: ObservationSourceKind;
+    signalType: ObservationSignalType;
+    signalSubtype: ObservationSignalSubtype;
+    confidence: number;
+    attributionConfidence: number;
+    severity: 'high' | 'medium' | 'low' | 'noise';
+    severityReasonCode?: ObservationSeverityReasonCode;
+    severityReason?: string;
+    evidence: ObservationEvidence;
+    messageWindow?: ObservationMessageWindow;
+    firstSeen: string;
+    lastSeen: string;
+    occurrences: number;
+    recentSessionIds: string[];
+    representativeEvidence: ObservationEvidence[];
+}
+export interface ObservationSessionTimeRange {
+    sessionId: string;
+    sessionGroupId?: string;
+    sourceTrace: string;
+    sourceKind: ObservationSourceKind;
+    traceRole?: 'standalone' | 'main' | 'subagent';
+    traceLabel?: string;
+    cwd?: string;
+    startTimestamp?: string;
+    endTimestamp?: string;
+    durationMs?: number;
+}
+export interface ObservationInboxReport {
+    kind: 'observe-inbox';
+    schemaVersion: 1;
+    meta: {
+        tracePath: string;
+        generatedAt: string;
+        sessionCount?: number;
+        sessionTimeRange?: {
+            from: string;
+            to: string;
+            durationMs?: number;
+        };
+        sessionTimeRanges?: ObservationSessionTimeRange[];
+        segmentCount: number;
+        itemCount: number;
+        skillInvocationCounts?: Record<string, number>;
+        skillSessionCounts?: Record<string, number>;
+        skillInvocationLastSeen?: Record<string, string>;
+        skillToolCallCounts?: Record<string, Record<string, number>>;
+    };
+    items: ObservationInboxItem[];
+    experience?: ObservationExperienceReport;
+    diagnostics?: DiagnosisBundle;
+}
+export interface ObservationSkillRollup {
+    skillName: string;
+    invocationCount: number;
+    sessionCount: number;
+    observationCount: number;
+    highCount: number;
+    mediumCount: number;
+    lowCount: number;
+    noiseCount: number;
+    latestSeen: string;
+}
+export interface BuildObservationInboxReportOptions {
+    reviewState?: ObservationReviewState;
+}
+export type ExperienceReviewPriority = 'review_first' | 'sample_review' | 'routine_sample';
+export type ExperienceGoalSliceReasonCode = 'skill_segment_boundary' | 'explicit_user_goal_shift' | 'default_session_slice';
+export type ExperienceEvidenceKind = 'user_message' | 'synthetic_user_event' | 'assistant_message' | 'tool_use' | 'tool_result' | 'skill_context' | 'runtime_context' | 'observation';
+export type ExperienceAssistiveInferenceCode = 'review_recommended' | 'sample_recommended' | 'positive_signal_observed' | 'user_switched_topic_neutral' | 'no_obvious_issue_from_rules' | 'insufficient_human_context';
+export type ExperienceAssistiveInferenceConfidence = 'low' | 'medium' | 'high';
+export type ExperienceAssistiveInferenceCautionCode = 'no_llm_judge' | 'rule_only' | 'runtime_context_excluded' | 'skill_context_excluded' | 'no_human_user_message' | 'limited_timeline_window';
+export type ExperienceReviewBasisCode = 'has_high_observation' | 'has_medium_observation' | 'user_correction' | 'user_interruption' | 'session_interrupted' | 'negative_feedback' | 'hard_rule_text_hit' | 'tool_failure' | 'hedging_signal' | 'explicit_marker';
+export type ExperienceRuleFindingLevel = 'attention' | 'sample' | 'normal';
+export type ExperienceReviewerReportScope = 'single_skill_single_goal' | 'degraded_complex';
+export type ExperienceReviewerReportStepStatus = 'ok' | 'attention' | 'unknown' | 'degraded' | 'not_applicable';
+export type ExperienceReviewerReportFindingLevel = 'attention' | 'possible_false_positive' | 'note';
+export type ExperienceReviewerReportFindingSource = 'deterministic_rule' | 'llm_soft' | 'manual';
+export type ExperienceChecklistItemStatus = 'passed' | 'failed' | 'unknown' | 'not_declared' | 'not_applicable' | 'degraded';
+export type ExperienceChecklistContribution = 'blocking' | 'attention' | 'informational' | 'positive' | 'neutral';
+export type ExperienceParentReason = 'data_degraded' | 'blocking_failed' | 'attention_accumulated' | 'unknown_dominant' | 'all_passed' | 'not_applicable';
+export type ExperienceSessionStoryNodeKind = 'user_goal' | 'skill_invocation' | 'subagent_branch' | 'tool_execution' | 'delivery' | 'user_feedback' | 'goal_shift';
+export type ExperienceSessionStoryAnswerKey = 'goal_satisfaction' | 'declared_behavior_fit' | 'user_feeling';
+export type ExperienceSessionStorySkillRole = 'router' | 'executor' | 'mixed' | 'unknown';
+export type ExperienceEpisodeBoundaryReason = 'goal_shift' | 'checkpoint_or_subagent' | 'downstream_closed' | 'session_end';
+export type ExperienceEpisodeRole = 'main_executor' | 'router' | 'delegator' | 'supporting' | 'observer';
+export type ExperienceFeedbackSignalType = 'correction' | 'follow_up' | 'frustration' | 'interruption' | 'positive' | 'unknown';
+export type ExperienceFeedbackAttributionRole = 'primary_fault' | 'downstream_related' | 'context_only';
+export type ExperienceFeedbackAttributionReason = 'object_match' | 'promise_match' | 'action_match' | 'orchestration_edge' | 'episode_context';
+export type ExperienceOutcomeClosure = 'closed' | 'unresolved' | 'abandoned' | 'unknown';
+export type ExperienceRuntimeSkillType = 'router' | 'delegation' | 'executor' | 'advisory' | 'workflow_owner' | 'unknown';
+export type ExperienceRuntimeSkillTypeSource = 'frontmatter' | 'trace' | 'unknown';
+export type ExperienceEpisodeArtifactKind = 'path' | 'url' | 'document' | 'code' | 'execution_window' | 'unknown';
+export type ExperienceOrchestrationEdgeStatus = 'started' | 'completed' | 'failed' | 'unknown';
+export type ExperienceOrchestrationEdgeKind = 'internal_skill' | 'external_child_session';
+export type ExperienceRuleFindingCode = 'high_observation_seen' | 'medium_observation_seen' | 'user_correction_seen' | 'user_interruption_seen' | 'session_interrupted_seen' | 'negative_feedback_seen' | 'positive_feedback_seen' | 'user_goal_shift_seen' | 'hard_rule_seen' | 'tool_failure_seen' | 'hedging_seen' | 'explicit_marker_seen' | 'runtime_context_excluded' | 'skill_context_excluded' | 'no_priority_signal';
+export interface ExperienceEvidenceRef {
+    id: string;
+    kind: ExperienceEvidenceKind;
+    sourceTrace: string;
+    sessionId: string;
+    traceRole?: 'standalone' | 'main' | 'subagent';
+    traceLabel?: string;
+    messageIndex?: number;
+    logicalMessageIndex?: number;
+    sourceLineIndex?: number;
+    messageUuid?: string;
+    toolUseId?: string;
+    timestamp?: string;
+    role?: 'user' | 'assistant' | 'tool' | 'other';
+    label?: string;
+    snippet?: string;
+}
+export interface ExperienceTimelineEvent extends ExperienceEvidenceRef {
+    order: number;
+    toolName?: string;
+    isError?: boolean;
+    fullText?: string;
+}
+export interface ExperienceTimelineBranch {
+    id: string;
+    label: string;
+    sourceTrace: string;
+    traceRole: 'main' | 'subagent' | 'standalone';
+    attachTo?: {
+        sourceTrace: string;
+        messageIndex?: number;
+        toolUseId?: string;
+        label?: string;
+    };
+    events: ExperienceTimelineEvent[];
+}
+export interface ExperienceTimelineTree {
+    sessionId: string;
+    main: ExperienceTimelineEvent[];
+    branches: ExperienceTimelineBranch[];
+}
+export interface ExperienceEvidenceChain {
+    userMessageCount: number;
+    runtimeContextCount: number;
+    skillContextCount: number;
+    assistantMessageCount: number;
+    toolUseCount: number;
+    toolResultCount: number;
+    toolFailureResultCount: number;
+    observationCount: number;
+    firstUserMessage?: ExperienceEvidenceRef;
+    firstRuntimeContext?: ExperienceEvidenceRef;
+    firstSkillContext?: ExperienceEvidenceRef;
+    firstToolUse?: ExperienceEvidenceRef;
+    firstToolFailure?: ExperienceEvidenceRef;
+    lastAssistantMessage?: ExperienceEvidenceRef;
+}
+export interface ExperienceRuleFinding {
+    code: ExperienceRuleFindingCode;
+    level: ExperienceRuleFindingLevel;
+    count: number;
+    evidenceRefs: ExperienceEvidenceRef[];
+}
+export interface ExperienceAssistiveInference {
+    mode: 'deterministic_rules_only';
+    code: ExperienceAssistiveInferenceCode;
+    confidence: ExperienceAssistiveInferenceConfidence;
+    basisRuleCodes: ExperienceRuleFindingCode[];
+    cautionCodes: ExperienceAssistiveInferenceCautionCode[];
+    evidenceRefs: ExperienceEvidenceRef[];
+}
+export interface ExperienceReviewerReportStep {
+    order: number;
+    label: string;
+    status: ExperienceReviewerReportStepStatus;
+    text: string;
+    evidenceRefs: ExperienceEvidenceRef[];
+}
+export interface ExperienceReviewerReportFinding {
+    id: string;
+    judgmentId: string;
+    source: ExperienceReviewerReportFindingSource;
+    level: ExperienceReviewerReportFindingLevel;
+    title: string;
+    body: string;
+    ruleSource: string;
+    ruleVersion: string;
+    evidenceRefs: ExperienceEvidenceRef[];
+    reviewStateRef: {
+        targetType: 'reviewer_judgment';
+        targetId: string;
+        verdict?: string;
+        reason?: string;
+        note?: string;
+        reviewedAt?: string;
+    };
+}
+export interface ExperienceSessionStoryNode {
+    id: string;
+    order: number;
+    kind: ExperienceSessionStoryNodeKind;
+    label: string;
+    status: ExperienceReviewerReportStepStatus;
+    text: string;
+    evidenceRefs: ExperienceEvidenceRef[];
+}
+export interface ExperienceSessionStoryAnswer {
+    key: ExperienceSessionStoryAnswerKey;
+    label: string;
+    status: ExperienceReviewerReportStepStatus;
+    reason: ExperienceParentReason;
+    sourceItemKeys: string[];
+    text: string;
+    evidenceRefs: ExperienceEvidenceRef[];
+    checklistItems: ExperienceChecklistItem[];
+}
+export interface ExperienceChecklistItem {
+    key: string;
+    label: string;
+    status: ExperienceChecklistItemStatus;
+    contribution: ExperienceChecklistContribution;
+    reason: string;
+    evidenceRefs: ExperienceEvidenceRef[];
+    source: ExperienceReviewerReportFindingSource;
+    suggestionKey?: string;
+}
+export interface ExperienceSessionStoryGoalSlice {
+    id: string;
+    order: number;
+    skillNames: string[];
+    startTimestamp: string;
+    endTimestamp: string;
+    reasonCode: ExperienceGoalSliceReasonCode;
+    inferredUserGoal?: string;
+    evidenceRefs: ExperienceEvidenceRef[];
+}
+export interface ExperienceSessionStorySubagentDispatch {
+    id: string;
+    order: number;
+    branchId: string;
+    label: string;
+    sourceTrace: string;
+    attachTo?: {
+        messageIndex?: number;
+        toolUseId?: string;
+        label?: string;
+    };
+    eventCount: number;
+    evidenceRefs: ExperienceEvidenceRef[];
+}
+export interface ExperienceSessionStorySkillLink {
+    id: string;
+    order: number;
+    skillName: string;
+    role: ExperienceSessionStorySkillRole;
+    invocationIds: string[];
+    goalSliceIds: string[];
+    evidenceRefs: ExperienceEvidenceRef[];
+}
+export interface ExperienceGoalEvidenceRef {
+    kind: 'user_message' | 'goal_slice' | 'llm_goal';
+    goalSliceId?: string;
+    evidenceRef?: ExperienceEvidenceRef;
+    label?: string;
+}
+export interface ExperienceMessageRange {
+    startMessageIndex: number;
+    endMessageIndex: number;
+    sourceTrace?: string;
+    sessionId?: string;
+}
+export interface ExperienceSkillSegment {
+    id: string;
+    order: number;
+    skillName: string;
+    skillType: ExperienceRuntimeSkillType;
+    skillTypeSource?: ExperienceRuntimeSkillTypeSource;
+    declaredSkillType?: ExperienceRuntimeSkillType;
+    traceInferredSkillType?: ExperienceRuntimeSkillType;
+    episodeRole: ExperienceEpisodeRole;
+    skillInvocationIds: string[];
+    startMessageIndex?: number;
+    endMessageIndex?: number;
+    messageRanges?: ExperienceMessageRange[];
+    startTimestamp: string;
+    endTimestamp: string;
+    typeSpecificChecklist: ExperienceChecklistItem[];
+    runtimeAssessment?: {
+        goalSatisfaction?: string;
+        declaredBehaviorFit?: string;
+        artifactGoalMatch?: string;
+        userFeeling?: string;
+    };
+    evidenceRefs: ExperienceEvidenceRef[];
+}
+export interface ExperienceOrchestrationEdge {
+    id: string;
+    episodeId: string;
+    edgeKind: ExperienceOrchestrationEdgeKind;
+    parentSkillSegmentId?: string;
+    executorSkillSegmentId?: string;
+    childSessionId?: string;
+    runnerStartedRef?: ExperienceEvidenceRef;
+    runnerCompletedRef?: ExperienceEvidenceRef;
+    notificationRef?: ExperienceEvidenceRef;
+    status: ExperienceOrchestrationEdgeStatus;
+    evidenceRefs: ExperienceEvidenceRef[];
+}
+export interface ExperienceFeedbackAttribution {
+    skillName?: string;
+    skillSegmentId?: string;
+    attributionRole: ExperienceFeedbackAttributionRole;
+    reasonCode: ExperienceFeedbackAttributionReason;
+    evidenceRefs: ExperienceEvidenceRef[];
+}
+export interface ExperienceFeedbackSignal {
+    id: string;
+    order: number;
+    type: ExperienceFeedbackSignalType;
+    text: string;
+    targetObject?: string;
+    sourceWindow: 'session' | 'episode' | 'skill_invocation' | 'downstream_child';
+    evidenceRef: ExperienceEvidenceRef;
+    canonicalAttributions?: ExperienceFeedbackAttribution[];
+    attributions: ExperienceFeedbackAttribution[];
+}
+export interface ExperienceEpisodeArtifact {
+    kind: ExperienceEpisodeArtifactKind;
+    label: string;
+    pathOrUrl?: string;
+    artifactGoalMatch: 'passed' | 'failed' | 'unknown';
+    evidenceRef: ExperienceEvidenceRef;
+}
+export interface ExperienceEpisodeOutcome {
+    closure: ExperienceOutcomeClosure;
+    artifacts: ExperienceEpisodeArtifact[];
+    verdict: ExperienceReviewPriority;
+    acceptanceCriteria?: string;
+}
+export interface ExperienceEpisode {
+    id: string;
+    order: number;
+    sessionId: string;
+    primaryGoal?: string;
+    goalEvidenceRefs: ExperienceGoalEvidenceRef[];
+    startTimestamp: string;
+    endTimestamp: string;
+    startRef?: ExperienceEvidenceRef;
+    endRef?: ExperienceEvidenceRef;
+    boundaryReason: ExperienceEpisodeBoundaryReason;
+    skillSegments: ExperienceSkillSegment[];
+    orchestrationEdges: ExperienceOrchestrationEdge[];
+    feedbackSignals: ExperienceFeedbackSignal[];
+    outcome: ExperienceEpisodeOutcome;
+}
+export interface ExperienceSessionStoryGraphNode {
+    id: string;
+    label: string;
+    kind: ExperienceSessionStoryNodeKind;
+    status: ExperienceReviewerReportStepStatus;
+    role?: ExperienceSessionStorySkillRole;
+    detailNodeId?: string;
+}
+export interface ExperienceSessionStoryGraphEdge {
+    fromId: string;
+    toId: string;
+    label: string;
+}
+export interface ExperienceSessionStory {
+    schemaVersion: 1;
+    summary: string;
+    invocationCount: number;
+    goalSliceCount: number;
+    branchCount: number;
+    progressUpdateCount: number;
+    finalDeliverySignalCount: number;
+    mainlineNodeIds: string[];
+    goalSlices: ExperienceSessionStoryGoalSlice[];
+    subagentDispatches: ExperienceSessionStorySubagentDispatch[];
+    skillLinks: ExperienceSessionStorySkillLink[];
+    episodes?: ExperienceEpisode[];
+    graph: {
+        nodes: ExperienceSessionStoryGraphNode[];
+        edges: ExperienceSessionStoryGraphEdge[];
+    };
+    nodes: ExperienceSessionStoryNode[];
+    answers: ExperienceSessionStoryAnswer[];
+}
+export interface ExperienceReviewerReport {
+    schemaVersion: 1;
+    mode: 'deterministic_milestone_1' | 'deterministic_session_story';
+    generatedAt: string;
+    title: string;
+    summary: string;
+    scope: {
+        kind: ExperienceReviewerReportScope;
+        reasonCodes: string[];
+    };
+    chainSteps: ExperienceReviewerReportStep[];
+    findings: ExperienceReviewerReportFinding[];
+    oneLookMetrics: {
+        toolCallCount: number;
+        toolFailureCount: number;
+        userMessageCount: number;
+        userFollowUpCount: number;
+        assistantDeliverySignalCount: number;
+        deliverableArtifactSignalCount: number;
+        routerDownstreamCompleted: number;
+        routerDownstreamFailed: number;
+        assistantProgressUpdateCount: number;
+        selfCorrectionCount: number;
+        repeatedExecutionCount: number;
+        finalDeliverySignalCount: number;
+        traceEventCount: number;
+        tokenUsage: {
+            inputTokens: number;
+            outputTokens: number;
+            cacheReadTokens: number;
+            cacheCreationTokens: number;
+            attribution: 'skill_segment';
+        };
+    };
+    sessionStory: ExperienceSessionStory;
+    authorSuggestions: string[];
+    traceLinks: ExperienceEvidenceRef[];
+}
+export interface ExperienceGoalSlice {
+    id: string;
+    skillName: string;
+    sessionId: string;
+    sourceTrace: string;
+    cwd?: string;
+    startTimestamp: string;
+    endTimestamp: string;
+    sliceReasonCode: ExperienceGoalSliceReasonCode;
+    sliceConfidence: 'low' | 'medium' | 'high';
+    inferredUserGoal?: string;
+    userMessageRefs: ExperienceEvidenceRef[];
+}
+export interface ExperienceReviewIndicators {
+    userMessageCount: number;
+    userFollowUpCount: number;
+    userCorrectionCount: number;
+    userInterruptionCount: number;
+    sessionInterruptedCount: number;
+    negativeFeedbackCount: number;
+    positiveFeedbackCount: number;
+    userGoalShiftCount: number;
+    hardRuleTextHitCount: number;
+    assistantDeliverySignalCount: number;
+    deliverableArtifactSignalCount: number;
+    routerDownstreamCompleted: number;
+    routerDownstreamFailed: number;
+    selfCorrectionCount: number;
+    repeatedExecutionCount: number;
+    toolCallCount: number;
+    toolFailureCount: number;
+    highObservationCount: number;
+    mediumObservationCount: number;
+    hedgingCount: number;
+    explicitMarkerCount: number;
+}
+export interface ExperienceInvocationMetrics {
+    durationMs: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheCreationTokens: number;
+    numTurns: number;
+    numToolCalls: number;
+    numToolFailures: number;
+}
+export interface ExperienceInvocation {
+    id: string;
+    skillName: string;
+    sessionId: string;
+    sessionGroupKey: string;
+    sourceTrace: string;
+    sourceKind: ObservationSourceKind;
+    entrypoint?: string;
+    sourceMetadata?: TraceSourceMetadata;
+    cwd?: string;
+    segmentIndex: number;
+    goalSliceId: string;
+    startTimestamp: string;
+    endTimestamp: string;
+    attribution: {
+        source: string;
+        confidence: number;
+        rawSkillRef?: string;
+        pluginName?: string;
+        commandName?: string;
+    };
+    metrics: ExperienceInvocationMetrics;
+    toolCounts: Record<string, number>;
+    indicators: ExperienceReviewIndicators;
+    evidenceChain: ExperienceEvidenceChain;
+    ruleFindings: ExperienceRuleFinding[];
+    assistiveInference: ExperienceAssistiveInference;
+    problemPatterns: ExperienceProblemPattern[];
+    relatedObservationIds: string[];
+    evidenceRefs: ExperienceEvidenceRef[];
+    timeline: ExperienceTimelineEvent[];
+}
+export interface ExperienceSessionSummary {
+    id: string;
+    skillName: string;
+    sessionId: string;
+    sourceTrace: string;
+    sourceKind: ObservationSourceKind;
+    entrypoint?: string;
+    sourceMetadata?: TraceSourceMetadata;
+    cwd?: string;
+    sourceSessionStartTimestamp?: string;
+    sourceSessionEndTimestamp?: string;
+    sourceSessionDurationMs?: number;
+    startTimestamp: string;
+    endTimestamp: string;
+    invocationIds: string[];
+    goalSliceIds: string[];
+    reviewPriority: ExperienceReviewPriority;
+    reviewPriorityScore: number;
+    reviewBasisCodes: ExperienceReviewBasisCode[];
+    indicators: ExperienceReviewIndicators;
+    evidenceChain: ExperienceEvidenceChain;
+    ruleFindings: ExperienceRuleFinding[];
+    assistiveInference: ExperienceAssistiveInference;
+    problemPatterns: ExperienceProblemPattern[];
+    relatedObservationIds: string[];
+    timelinePreview: ExperienceTimelineEvent[];
+    fullSessionTimeline: ExperienceTimelineEvent[];
+    timelineTree?: ExperienceTimelineTree;
+    timelineScope: {
+        mode: 'skill_segment_window';
+        segmentStartRecordIndex?: number;
+        segmentEndRecordIndex?: number;
+        previewStartRecordIndex?: number;
+        previewEndRecordIndex?: number;
+        sessionStartRecordIndex: number;
+        sessionEndRecordIndex: number;
+        previewEventCount: number;
+        fullSessionEventCount: number;
+        truncated: boolean;
+        omittedBeforeCount: number;
+        omittedAfterCount: number;
+    };
+    attributionSources: string[];
+    pluginNames: string[];
+    rawSkillRefs: string[];
+    commandNames: string[];
+    sessionStory?: ExperienceSessionStory;
+    reviewerReport?: ExperienceReviewerReport;
+}
+export interface ExperienceSkillSummary {
+    skillName: string;
+    invocationCount: number;
+    sessionCount: number;
+    sourceKinds: ObservationSourceKind[];
+    entrypoints: string[];
+    entrypointCounts: Record<string, number>;
+    sourceMetadataCounts: {
+        channels: Record<string, number>;
+        senders: Record<string, number>;
+        businessActions: Record<string, number>;
+        providers: Record<string, number>;
+        models: Record<string, number>;
+    };
+    attributionCounts: Record<string, number>;
+    pluginNames: string[];
+    rawSkillRefs: string[];
+    commandNames: string[];
+    toolCounts: Record<string, number>;
+    firstSeen: string;
+    lastSeen: string;
+    reviewFirstSessionCount: number;
+    sampleReviewSessionCount: number;
+    indicators: ExperienceReviewIndicators;
+    evidenceChain: ExperienceEvidenceChain;
+    ruleFindings: ExperienceRuleFinding[];
+    assistiveInference: ExperienceAssistiveInference;
+    problemPatterns: ExperienceProblemPattern[];
+    relatedObservationIds: string[];
+}
+export interface ObservationExperienceReport {
+    kind: 'observe-experience';
+    schemaVersion: 1;
+    scope: 'evidence-only';
+    generatedAt: string;
+    meta: {
+        sessionCount: number;
+        skillCount: number;
+        invocationCount: number;
+        goalSliceCount: number;
+        noteCodes: Array<'no_llm_judge' | 'no_auto_verdict' | 'default_goal_slice_is_allowed' | 'deterministic_assistive_inference'>;
+    };
+    goalSlices: ExperienceGoalSlice[];
+    invocations: ExperienceInvocation[];
+    sessions: ExperienceSessionSummary[];
+    skills: ExperienceSkillSummary[];
+}
+export type ObservationRuntimeCheckStatus = 'passed' | 'attention' | 'manual_review';
+export interface ObservationRuntimeCheck {
+    kind: 'hardRule' | 'workflowNode';
+    id: string;
+    title: string;
+    expectation: string;
+    status: ObservationRuntimeCheckStatus;
+    reason: string;
+    evidenceCount: number;
+    evidenceSnippets: string[];
+}
+export type SkillRuntimeEvidencePackSourceType = 'tool_call' | 'tool_result' | 'assistant_message' | 'user_feedback' | 'artifact' | 'runtime_context' | 'skill_context' | 'unknown';
+export interface SkillRuntimeEvidencePackRef extends Pick<ExperienceEvidenceRef, 'id' | 'kind' | 'sourceTrace' | 'sessionId' | 'messageUuid' | 'messageIndex' | 'logicalMessageIndex' | 'sourceLineIndex' | 'toolUseId' | 'timestamp' | 'role' | 'label' | 'snippet'> {
+    sourceType: SkillRuntimeEvidencePackSourceType;
+    toolName?: string;
+    isError?: boolean;
+}
+export interface SkillRuntimeEvidencePackNode {
+    nodeId: string;
+    kind: 'workflowNode' | 'hardRule';
+    title: string;
+    expectation: string;
+    deterministicStatus: ObservationRuntimeCheckStatus;
+    deterministicReason: string;
+    candidateEvidenceRefs: SkillRuntimeEvidencePackRef[];
+    candidateEvidenceSnippets: string[];
+}
+export interface SkillRuntimeEvidencePack {
+    schemaVersion: 1;
+    skillName: string;
+    generatedBy: 'deterministic_rule_pack';
+    definition: {
+        found: boolean;
+        path?: string;
+        truncated?: boolean;
+    };
+    declaredStandards: {
+        hardRules: Array<{
+            id: string;
+            title: string;
+            expectation: string;
+            source: 'frontmatter';
+        }>;
+        workflowNodes: Array<{
+            id: string;
+            title: string;
+            expectation: string;
+            workflowId: string;
+            source: 'frontmatter' | 'markdown_headings';
+        }>;
+    };
+    runtimeEvidence: {
+        toolCalls: SkillRuntimeEvidencePackRef[];
+        assistantMessages: SkillRuntimeEvidencePackRef[];
+        userFeedback: SkillRuntimeEvidencePackRef[];
+        artifacts: SkillRuntimeEvidencePackRef[];
+    };
+    nodeEvidence: SkillRuntimeEvidencePackNode[];
+    evidenceQuality: {
+        pollutedSourceCount: number;
+        windowTooNarrow: boolean;
+        missingRuntimeEvidence: boolean;
+        notes: string[];
+    };
+}
+export interface ObservationSkillChain {
+    skillName: string;
+    definition: {
+        found: boolean;
+        path?: string;
+        content?: string;
+        truncated?: boolean;
+    };
+    healthCheck: {
+        source: 'doctor-static-rules';
+        hardRules: {
+            declared: boolean;
+            valid: boolean;
+            count: number;
+            rules: SkillHardRule[];
+            errors: string[];
+            advisoryCode?: SkillChainAdvisoryCode;
+        };
+        workflows: {
+            declared: boolean;
+            valid: boolean;
+            branchCount: number;
+            nodeCount: number;
+            workflows: SkillWorkflow[];
+            errors: string[];
+            source: 'frontmatter' | 'markdown_headings' | 'none';
+            advisoryCode?: SkillChainAdvisoryCode;
+        };
+    };
+    runtime: {
+        supported: true;
+        mode: 'deterministic-no-llm';
+        message: string;
+        summary: {
+            invocationCount: number;
+            toolCallCount: number;
+            toolFailureCount: number;
+            passedCount: number;
+            attentionCount: number;
+            manualReviewCount: number;
+        };
+        hardRules: ObservationRuntimeCheck[];
+        workflowNodes: ObservationRuntimeCheck[];
+        evidencePack?: SkillRuntimeEvidencePack;
+    };
+}
+//# sourceMappingURL=observability.d.ts.map