@yancyyu/openhermit 1.5.8

package/src/renderer/types/sessionReport.ts

@@ -0,0 +1,386 @@
+/**
+ * Session analysis report types.
+ * Output of analyzeSession() — one interface per report section.
+ */
+
+import type {
+  CacheAssessment,
+  CostAssessment,
+  IdleAssessment,
+  ModelMismatch,
+  OverheadAssessment,
+  RedundancyAssessment,
+  SubagentCostShareAssessment,
+  SwitchPattern,
+  ThrashingAssessment,
+  ToolHealthAssessment,
+} from '@renderer/utils/reportAssessments';
+
+// =============================================================================
+// Pricing
+// =============================================================================
+
+export type { DisplayPricing as ModelPricing } from '@shared/utils/pricing';
+
+// =============================================================================
+// Report Sections
+// =============================================================================
+
+export interface ReportOverview {
+  sessionId: string;
+  projectId: string;
+  projectPath: string;
+  firstMessage: string;
+  messageCount: number;
+  hasSubagents: boolean;
+  contextConsumption: number;
+  contextConsumptionPct: number | null;
+  contextAssessment: 'critical' | 'high' | 'moderate' | 'healthy' | null;
+  compactionCount: number;
+  gitBranch: string;
+  startTime: Date | null;
+  endTime: Date | null;
+  durationSeconds: number;
+  durationHuman: string;
+  totalMessages: number;
+}
+
+export interface ModelTokenStats {
+  apiCalls: number;
+  inputTokens: number;
+  outputTokens: number;
+  cacheCreation: number;
+  cacheRead: number;
+  costUsd: number;
+}
+
+export interface TokenTotals {
+  inputTokens: number;
+  outputTokens: number;
+  cacheCreation: number;
+  cacheRead: number;
+  grandTotal: number;
+  cacheReadPct: number;
+}
+
+export interface ReportTokenUsage {
+  byModel: Record<string, ModelTokenStats>;
+  totals: TokenTotals;
+}
+
+export interface ReportCostAnalysis {
+  parentCostUsd: number;
+  subagentCostUsd: number;
+  totalSessionCostUsd: number;
+  costByModel: Record<string, number>;
+  costPerCommit: number | null;
+  costPerLineChanged: number | null;
+  costPerCommitAssessment: CostAssessment | null;
+  costPerLineAssessment: CostAssessment | null;
+  subagentCostSharePct: number | null;
+  subagentCostShareAssessment: SubagentCostShareAssessment | null;
+}
+
+export interface ReportCacheEconomics {
+  cacheRead: number;
+  cacheEfficiencyPct: number;
+  coldStartDetected: boolean;
+  cacheReadToWriteRatio: number;
+  cacheEfficiencyAssessment: CacheAssessment | null;
+  cacheRatioAssessment: CacheAssessment | null;
+}
+
+export interface ToolSuccessRate {
+  totalCalls: number;
+  errors: number;
+  successRatePct: number;
+  assessment: ToolHealthAssessment;
+}
+
+export interface ReportToolUsage {
+  counts: Record<string, number>;
+  totalCalls: number;
+  successRates: Record<string, ToolSuccessRate>;
+  overallToolHealth: ToolHealthAssessment;
+}
+
+export interface SubagentEntry {
+  description: string;
+  subagentType: string;
+  model: string;
+  totalTokens: number;
+  totalDurationMs: number;
+  totalToolUseCount: number;
+  costUsd: number;
+  costNote?: string;
+  modelMismatch: ModelMismatch | null;
+}
+
+export interface ReportSubagentMetrics {
+  count: number;
+  totalTokens: number;
+  totalDurationMs: number;
+  totalToolUseCount: number;
+  totalCostUsd: number;
+  byAgent: SubagentEntry[];
+}
+
+export interface ToolError {
+  tool: string;
+  inputPreview: string;
+  error: string;
+  messageIndex: number;
+  isPermissionDenial: boolean;
+}
+
+export interface ReportErrors {
+  errors: ToolError[];
+  permissionDenials: {
+    count: number;
+    denials: ToolError[];
+    affectedTools: string[];
+  };
+}
+
+export interface GitCommit {
+  messagePreview: string;
+  messageIndex: number;
+}
+
+export interface ReportGitActivity {
+  commitCount: number;
+  commits: GitCommit[];
+  pushCount: number;
+  branchCreations: string[];
+  linesAdded: number;
+  linesRemoved: number;
+  linesChanged: number;
+}
+
+export interface FrictionCorrection {
+  messageIndex: number;
+  keyword: string;
+  preview: string;
+}
+
+export interface ReportFrictionSignals {
+  correctionCount: number;
+  corrections: FrictionCorrection[];
+  frictionRate: number;
+}
+
+export interface ReportThrashingSignals {
+  bashNearDuplicates: { prefix: string; count: number }[];
+  editReworkFiles: { filePath: string; editIndices: number[] }[];
+  thrashingAssessment: ThrashingAssessment;
+}
+
+export interface ReportConversationTree {
+  totalNodes: number;
+  maxDepth: number;
+  sidechainCount: number;
+  branchPoints: number;
+  branchDetails: {
+    parentUuid: string;
+    childCount: number;
+    parentMessageIndex: number | undefined;
+  }[];
+}
+
+export interface IdleGap {
+  gapSeconds: number;
+  gapHuman: string;
+  afterMessageIndex: number;
+}
+
+export interface ReportIdleAnalysis {
+  idleThresholdSeconds: number;
+  idleGapCount: number;
+  totalIdleSeconds: number;
+  totalIdleHuman: string;
+  wallClockSeconds: number;
+  activeWorkingSeconds: number;
+  activeWorkingHuman: string;
+  idlePct: number;
+  longestGaps: IdleGap[];
+  idleAssessment: IdleAssessment;
+}
+
+export interface ModelSwitch {
+  from: string;
+  to: string;
+  messageIndex: number;
+  timestamp: Date | null;
+}
+
+export interface ReportModelSwitches {
+  count: number;
+  switches: ModelSwitch[];
+  modelsUsed: string[];
+  switchPattern: SwitchPattern | null;
+}
+
+export interface ReportWorkingDirectories {
+  uniqueDirectories: string[];
+  directoryCount: number;
+  changes: { from: string; to: string; messageIndex: number }[];
+  changeCount: number;
+  isMultiDirectory: boolean;
+}
+
+export interface TestSnapshot {
+  messageIndex: number;
+  passed: number;
+  failed: number;
+  total: number;
+  raw: string;
+}
+
+export interface ReportTestProgression {
+  snapshotCount: number;
+  snapshots: TestSnapshot[];
+  trajectory: 'improving' | 'regressing' | 'stable' | 'insufficient_data';
+  firstSnapshot: TestSnapshot | null;
+  lastSnapshot: TestSnapshot | null;
+}
+
+export interface ReportStartupOverhead {
+  messagesBeforeFirstWork: number;
+  tokensBeforeFirstWork: number;
+  pctOfTotal: number;
+  overheadAssessment: OverheadAssessment;
+}
+
+export interface ReportTokenDensityTimeline {
+  quartiles: { q: number; avgTokens: number; messageCount: number }[];
+}
+
+export interface ReportPromptQuality {
+  firstMessageLengthChars: number;
+  userMessageCount: number;
+  correctionCount: number;
+  frictionRate: number;
+  assessment: 'underspecified' | 'verbose_but_unclear' | 'well_specified' | 'moderate_friction';
+  note: string;
+}
+
+export interface ThinkingBlockAnalysis {
+  messageIndex: number;
+  preview: string;
+  charLength: number;
+  signals: Record<string, boolean>;
+}
+
+export interface ReportThinkingBlocks {
+  count: number;
+  analyzedCount: number;
+  signalSummary: Record<string, number>;
+  notableBlocks: ThinkingBlockAnalysis[];
+}
+
+export interface KeyEvent {
+  timestamp: Date;
+  label: string;
+  deltaSeconds?: number;
+  deltaHuman?: string;
+}
+
+export interface ReportFileReadRedundancy {
+  totalReads: number;
+  uniqueFiles: number;
+  readsPerUniqueFile: number;
+  redundantFiles: Record<string, number>;
+  redundancyAssessment: RedundancyAssessment;
+}
+
+// =============================================================================
+// Missing Sections (ported from Python analyzer)
+// =============================================================================
+
+export interface SkillInvocation {
+  skill: string;
+  argsPreview: string;
+}
+
+export interface ReportBashCommands {
+  total: number;
+  unique: number;
+  repeated: Record<string, number>;
+}
+
+export interface UserQuestion {
+  question: string;
+  options: string[];
+}
+
+export interface OutOfScopeFindings {
+  keyword: string;
+  messageIndex: number;
+  snippet: string;
+}
+
+export interface AgentTreeNode {
+  agentId: string;
+  agentType: string;
+  teamName: string;
+  parentToolUseId: string;
+  messageIndex: number;
+}
+
+export interface ReportAgentTree {
+  agentCount: number;
+  agents: AgentTreeNode[];
+  hasTeamMode: boolean;
+  teamNames: string[];
+}
+
+export interface ReportCompaction {
+  count: number;
+  compactSummaryCount: number;
+  note: string;
+}
+
+export interface SubagentBasicEntry {
+  description: string;
+  subagentType: string;
+  model: string;
+  runInBackground: boolean;
+}
+
+// =============================================================================
+// Combined Report
+// =============================================================================
+
+export interface SessionReport {
+  overview: ReportOverview;
+  tokenUsage: ReportTokenUsage;
+  costAnalysis: ReportCostAnalysis;
+  cacheEconomics: ReportCacheEconomics;
+  toolUsage: ReportToolUsage;
+  subagentMetrics: ReportSubagentMetrics;
+  subagentsList: SubagentBasicEntry[];
+  errors: ReportErrors;
+  gitActivity: ReportGitActivity;
+  frictionSignals: ReportFrictionSignals;
+  thrashingSignals: ReportThrashingSignals;
+  conversationTree: ReportConversationTree;
+  idleAnalysis: ReportIdleAnalysis;
+  modelSwitches: ReportModelSwitches;
+  workingDirectories: ReportWorkingDirectories;
+  testProgression: ReportTestProgression;
+  startupOverhead: ReportStartupOverhead;
+  tokenDensityTimeline: ReportTokenDensityTimeline;
+  promptQuality: ReportPromptQuality;
+  thinkingBlocks: ReportThinkingBlocks;
+  keyEvents: KeyEvent[];
+  messageTypes: Record<string, number>;
+  fileReadRedundancy: ReportFileReadRedundancy;
+  compaction: ReportCompaction;
+  gitBranches: string[];
+  skillsInvoked: SkillInvocation[];
+  bashCommands: ReportBashCommands;
+  lifecycleTasks: string[];
+  userQuestions: UserQuestion[];
+  outOfScopeFindings: OutOfScopeFindings[];
+  agentTree: ReportAgentTree;
+}

package/src/renderer/types/tabs.ts

@@ -0,0 +1,249 @@
+/**
+ * Tab type definitions for the tabbed layout feature.
+ * Based on specs/001-tabbed-layout-dashboard/contracts/tab-state.ts
+ */
+
+import type { Session } from './data';
+import type { TriggerColor } from '@shared/constants/triggerColors';
+
+// =============================================================================
+// Navigation Request Types
+// =============================================================================
+
+/**
+ * Payload for error-based navigation (from notifications or trigger preview).
+ */
+export interface ErrorNavigationPayload {
+  /** Error ID for tracking */
+  errorId: string;
+  /** Error timestamp for finding the correct AI group */
+  errorTimestamp: number;
+  /** Tool use ID for precise tool item highlighting */
+  toolUseId?: string;
+  /** Subagent ID for subagent-aware group lookup */
+  subagentId?: string;
+  /** Line number (fallback) */
+  lineNumber?: number;
+}
+
+/**
+ * Payload for search-based navigation (from Command Palette).
+ */
+export interface SearchNavigationPayload {
+  /** The search query */
+  query: string;
+  /** Timestamp of the message containing the search match */
+  messageTimestamp: number;
+  /** The matched text */
+  matchedText: string;
+  /** Optional exact target group ID (e.g., "user-..." or "ai-...") */
+  targetGroupId?: string;
+  /** Optional exact match index within the target group's searchable text */
+  targetMatchIndexInItem?: number;
+  /** Optional character offset of the match in the searchable text */
+  targetMatchStartOffset?: number;
+  /** Optional source message UUID for diagnostics/fallback mapping */
+  targetMessageUuid?: string;
+}
+
+/**
+ * Unified tab navigation request.
+ * Each click/action creates a new request with a unique nonce (id).
+ * The nonce ensures repeated clicks produce new navigations.
+ */
+export interface TabNavigationRequest {
+  /** Unique nonce per click/action (crypto.randomUUID) */
+  id: string;
+  /** Kind of navigation */
+  kind: 'error' | 'search' | 'autoBottom';
+  /** Source of the navigation action */
+  source: 'notification' | 'triggerPreview' | 'commandPalette' | 'sessionOpen';
+  /** Highlight color to use */
+  highlight: TriggerColor | 'yellow' | 'none';
+  /** Navigation payload (depends on kind) */
+  payload: ErrorNavigationPayload | SearchNavigationPayload | Record<string, never>;
+}
+
+// =============================================================================
+// Core Types
+// =============================================================================
+
+/**
+ * Represents a single open tab in the main content area
+ */
+export interface Tab {
+  /** Unique identifier (UUID v4) */
+  id: string;
+
+  /** Type of content displayed in this tab */
+  type:
+    | 'session'
+    | 'dashboard'
+    | 'notifications'
+    | 'settings'
+    | 'teams'
+    | 'team'
+    | 'report'
+    | 'extensions'
+    | 'schedules'
+    | 'graph';
+
+  /** Session ID (required when type === 'session') */
+  sessionId?: string;
+
+  /** Project ID (required when type === 'session') */
+  projectId?: string;
+
+  /** Team name (required when type === 'team') */
+  teamName?: string;
+
+  /** Display name for the tab (max 50 chars) */
+  label: string;
+
+  /** Unix timestamp when tab was opened */
+  createdAt: number;
+
+  /** Whether this tab was opened from CommandPalette search */
+  fromSearch?: boolean;
+
+  /** Pending navigation request (replaces legacy deep-link fields) */
+  pendingNavigation?: TabNavigationRequest;
+
+  /** ID of the last consumed navigation request (prevents re-processing) */
+  lastConsumedNavigationId?: string;
+
+  /** Saved scroll position for restoring when tab becomes active again */
+  savedScrollTop?: number;
+
+  /** Whether the Context panel is shown (per-tab UI state) */
+  showContextPanel?: boolean;
+}
+
+/**
+ * Options for opening a tab
+ */
+export interface OpenTabOptions {
+  /** Force open in new tab even if session already exists (e.g., for Ctrl+click) */
+  forceNewTab?: boolean;
+  /** Replace the current active tab instead of creating a new one */
+  replaceActiveTab?: boolean;
+}
+
+/**
+ * Input type for creating a new tab (id and createdAt are auto-generated)
+ */
+export type TabInput = Omit<Tab, 'id' | 'createdAt'>;
+
+/**
+ * Categories for date-based session grouping
+ */
+export type DateCategory = 'Today' | 'Yesterday' | 'Previous 7 Days' | 'Older';
+
+/**
+ * Sessions grouped by relative date category
+ */
+export type DateGroupedSessions = Record<DateCategory, Session[]>;
+
+// =============================================================================
+// Constants
+// =============================================================================
+
+/** Maximum characters for tab label before truncation */
+const TAB_LABEL_MAX_LENGTH = 50;
+
+/** Date category order for rendering */
+export const DATE_CATEGORY_ORDER: DateCategory[] = [
+  'Today',
+  'Yesterday',
+  'Previous 7 Days',
+  'Older',
+];
+
+// =============================================================================
+// Validation Helpers
+// =============================================================================
+
+/**
+ * Find tab by session ID (for backwards compatibility)
+ * NOTE: Prefer findTabBySessionAndProject when projectId is available
+ */
+export function findTabBySession(tabs: Tab[], sessionId: string): Tab | undefined {
+  return tabs.find((t) => t.type === 'session' && t.sessionId === sessionId);
+}
+
+/**
+ * Find tab by both session ID AND project ID
+ * This prevents finding a tab with the same sessionId but different project
+ * (e.g., same filename in different repositories)
+ */
+export function findTabBySessionAndProject(
+  tabs: Tab[],
+  sessionId: string,
+  projectId: string
+): Tab | undefined {
+  return tabs.find(
+    (t) => t.type === 'session' && t.sessionId === sessionId && t.projectId === projectId
+  );
+}
+
+/**
+ * Truncate label to max length with ellipsis
+ */
+export function truncateLabel(label: string): string {
+  if (label.length <= TAB_LABEL_MAX_LENGTH) return label;
+  return label.slice(0, TAB_LABEL_MAX_LENGTH - 1) + '…';
+}
+
+// =============================================================================
+// Navigation Request Helpers
+// =============================================================================
+
+/**
+ * Create an error navigation request (from notification click or trigger preview).
+ */
+export function createErrorNavigationRequest(
+  payload: ErrorNavigationPayload,
+  source: 'notification' | 'triggerPreview' = 'notification',
+  highlightColor?: TriggerColor
+): TabNavigationRequest {
+  return {
+    id: crypto.randomUUID(),
+    kind: 'error',
+    source,
+    highlight: highlightColor ?? 'red',
+    payload,
+  };
+}
+
+/**
+ * Create a search navigation request (from Command Palette).
+ */
+export function createSearchNavigationRequest(
+  payload: SearchNavigationPayload
+): TabNavigationRequest {
+  return {
+    id: crypto.randomUUID(),
+    kind: 'search',
+    source: 'commandPalette',
+    highlight: 'yellow',
+    payload,
+  };
+}
+
+/**
+ * Type guard for error navigation payload.
+ */
+export function isErrorPayload(
+  request: TabNavigationRequest
+): request is TabNavigationRequest & { payload: ErrorNavigationPayload } {
+  return request.kind === 'error';
+}
+
+/**
+ * Type guard for search navigation payload.
+ */
+export function isSearchPayload(
+  request: TabNavigationRequest
+): request is TabNavigationRequest & { payload: SearchNavigationPayload } {
+  return request.kind === 'search';
+}

package/src/renderer/types/teamMessagesPanelMode.ts

@@ -0,0 +1 @@
+export type TeamMessagesPanelMode = 'sidebar' | 'inline' | 'bottom-sheet';