codex-session-insights 0.1.0 → 0.2.1

package/README.md

@@ -108,8 +108,8 @@ npx codex-session-insights --provider openai --api-key $OPENAI_API_KEY
 Current default analysis plan:
 
 - `days`: `30`
-- `limit`: `50`
-- `facet-limit`: `20`
+- `limit`: `200`
+- `facet-limit`: `50`
 - `provider`: `codex-cli`
 - `facet-model`: `gpt-5.4-mini`
 - `fast-section-model`: `gpt-5.4-mini`
@@ -120,6 +120,8 @@ Current default analysis plan:
 
 Important behavior defaults:
 
+- `limit` means the target number of substantive threads to include in the report, not just the first 50 indexed threads
+- `facet-limit` means the max number of uncached per-thread facet analyses to run in a single report
 - Report language follows a best-effort system locale check
 - Main-thread analysis is the default; sub-agent threads are excluded unless you pass `--include-subagents`
 - The CLI shows an estimate before running in interactive terminals

package/lib/cli.js

@@ -141,7 +141,7 @@ function parseArgs(argv) {
     jsonPath: null,
     htmlPath: null,
     days: 30,
-    limit: 50,
+    limit: 200,
     preview: 50,
     provider: 'codex-cli',
     codexBin: null,
@@ -154,7 +154,7 @@ function parseArgs(argv) {
     insightModel: null,
     insightEffort: null,
     cacheDir: null,
-    facetLimit: 20,
+    facetLimit: 50,
     lang: detectSystemLanguage(),
     includeArchived: false,
     includeSubagents: false,
@@ -330,7 +330,7 @@ Options:
   --json-path <path>        Exact path for report.json
   --html-path <path>        Exact path for report.html
   --days <n>                Only include threads updated in the last N days (default: 30)
-  --limit <n>               Max threads to scan from the thread registry (default: 50)
+  --limit <n>               Target number of substantive threads to include (default: 200)
   --preview <n>             Number of threads to embed in the HTML report (default: 50)
   --provider <name>         Model provider: codex-cli or openai (default: codex-cli)
   --codex-bin <path>        Override the Codex CLI binary path for provider=codex-cli
@@ -344,7 +344,7 @@ Options:
                             Reasoning effort for lower-risk sections
   --insight-model <name>    Model for final report generation
   --insight-effort <level>  Reasoning effort for higher-risk sections
-  --facet-limit <n>         Max uncached substantive threads to analyze (default: 20)
+  --facet-limit <n>         Max uncached thread facets to analyze (default: 50)
   --cache-dir <path>        Cache directory for session-meta and facet caches
   --lang <code>             Report language: en or zh-CN (default: system language)
   --include-archived        Include archived threads
@@ -657,8 +657,8 @@ function inferScopePreset(days) {
 
 function inferDepthPreset(options) {
   if (options.limit === 20 && options.facetLimit === 8) return 'conservative'
-  if (options.limit === 50 && options.facetLimit === 20) return 'standard'
-  if (options.limit === 200 && options.facetLimit === 50) return 'deep'
+  if (options.limit === 200 && options.facetLimit === 50) return 'standard'
+  if (options.limit === 400 && options.facetLimit === 50) return 'deep'
   return 'custom'
 }
 
@@ -682,8 +682,8 @@ function inferQualityPreset(options) {
 
 function applyScopePreset(options, preset) {
   if (preset === 'conservative') return { ...options, limit: 20, facetLimit: 8 }
-  if (preset === 'deep') return { ...options, limit: 200, facetLimit: 50 }
-  return { ...options, limit: 50, facetLimit: 20 }
+  if (preset === 'deep') return { ...options, limit: 400, facetLimit: 50 }
+  return { ...options, limit: 200, facetLimit: 50 }
 }
 
 function applyQualityPreset(options, preset) {
@@ -833,17 +833,17 @@ function getUiText(lang) {
       scopeCustom: '自定义天数',
       customDaysQuestion: '输入要分析的天数',
       depthQuestion: '选择分析深度：',
-      depthConservative: '保守（20 threads / 8 facets）',
-      depthStandard: '标准（50 threads / 20 facets）',
-      depthDeep: '深度（200 threads / 50 facets）',
+      depthConservative: '保守（20 个有效线程 / 8 个 facets）',
+      depthStandard: '标准（200 个有效线程 / 50 个 facets）',
+      depthDeep: '深度（400 个有效线程 / 50 个 facets）',
       depthCustom: '自定义',
-      limitQuestion: '输入最大 thread 数',
-      facetLimitQuestion: '输入最大 facet 提取数',
+      limitQuestion: '输入目标有效线程数',
+      facetLimitQuestion: '输入最大新增 facet 数',
       languageQuestion: '选择报告语言：',
       outputDirQuestion: '输出目录',
       openBrowserQuestion: '生成后自动打开浏览器？',
       qualityQuestion: '选择分析质量预设：',
-      qualityCheaper: '更省（尽量用 spark）',
+      qualityCheaper: '更省（尽量用 gpt-5.4-mini）',
       qualityBalanced: '平衡',
       qualityHigher: '更高质量（更多使用 gpt-5.4）',
       yesDefault: '[Y/n]',
@@ -860,7 +860,7 @@ function getUiText(lang) {
       toWord: '到',
       likelyWord: '左右',
       plannedCallsLabel: '预计调用数',
-      substantiveThreadsLabel: '有效线程',
+      substantiveThreadsLabel: '纳入报告线程',
       uncachedFacetsLabel: '未缓存 facets',
       longTranscriptsLabel: '长 transcript',
       inputEstimateLabel: '输入',
@@ -891,17 +891,17 @@ function getUiText(lang) {
     scopeCustom: 'Custom days',
     customDaysQuestion: 'Enter number of days to analyze',
     depthQuestion: 'Choose analysis depth:',
-    depthConservative: 'Conservative (20 threads / 8 facets)',
-    depthStandard: 'Standard (50 threads / 20 facets)',
-    depthDeep: 'Deep (200 threads / 50 facets)',
+    depthConservative: 'Conservative (20 substantive threads / 8 facets)',
+    depthStandard: 'Standard (200 substantive threads / 50 facets)',
+    depthDeep: 'Deep (400 substantive threads / 50 facets)',
     depthCustom: 'Custom',
-    limitQuestion: 'Enter max thread count',
-    facetLimitQuestion: 'Enter max facet extraction count',
+    limitQuestion: 'Enter target substantive thread count',
+    facetLimitQuestion: 'Enter max new facet extraction count',
     languageQuestion: 'Choose report language:',
     outputDirQuestion: 'Output directory',
     openBrowserQuestion: 'Open the report in your browser after generation?',
     qualityQuestion: 'Choose quality preset:',
-    qualityCheaper: 'Cheaper (more spark)',
+    qualityCheaper: 'Cheaper (more gpt-5.4-mini)',
     qualityBalanced: 'Balanced',
     qualityHigher: 'Higher quality (more gpt-5.4)',
     yesDefault: '[Y/n]',
@@ -918,7 +918,7 @@ function getUiText(lang) {
     toWord: 'to',
     likelyWord: 'likely',
     plannedCallsLabel: 'planned calls',
-    substantiveThreadsLabel: 'substantive threads',
+    substantiveThreadsLabel: 'threads in report',
     uncachedFacetsLabel: 'uncached facets',
     longTranscriptsLabel: 'long transcripts',
     inputEstimateLabel: 'input',

package/lib/codex-data.js

@@ -44,6 +44,7 @@ export async function loadThreads({
   codexHome,
   sinceEpochSeconds,
   limit,
+  offset,
   includeArchived,
   includeSubagents,
 }) {
@@ -66,6 +67,7 @@ export async function loadThreads({
     where.length ? `where ${where.join(' and ')}` : '',
     'order by updated_at desc',
     limit ? `limit ${Number(limit)}` : '',
+    offset ? `offset ${Number(offset)}` : '',
     ';',
   ]
     .filter(Boolean)
@@ -115,11 +117,15 @@ export async function loadRolloutEvents(rolloutPath) {
   return events
 }
 
+export function isSubstantiveThread(thread) {
+  if (thread.userMessages < 2) return false
+  if (thread.durationMinutes < 1) return false
+  return Boolean(String(thread.transcriptForAnalysis || '').trim())
+}
+
 export function filterSubstantiveThreads(threadSummaries) {
   return [...threadSummaries]
-    .filter(thread => thread.userMessages >= 2)
-    .filter(thread => thread.durationMinutes >= 1)
-    .filter(thread => Boolean(String(thread.transcriptForAnalysis || '').trim()))
+    .filter(isSubstantiveThread)
     .sort((a, b) => Date.parse(b.updatedAt) - Date.parse(a.updatedAt))
 }
 
@@ -440,14 +446,43 @@ export function summarizeThread(thread, events) {
 }
 
 export async function collectThreadSummaries(options) {
-  const threads = await loadThreads(options)
   const cacheDir = resolveSessionMetaCacheDir(options.cacheDir)
   await fs.mkdir(cacheDir, { recursive: true })
 
+  const substantiveTarget = Number(options.limit ?? 0)
+  const pageSize = substantiveTarget > 0 ? substantiveTarget : 200
   const summaries = []
-  for (const thread of threads) {
-    const summary = await loadCachedOrFreshSummary(thread, cacheDir)
-    summaries.push(summary)
+  let offset = 0
+  let substantiveCount = 0
+
+  while (true) {
+    const threads = await loadThreads({
+      ...options,
+      limit: pageSize,
+      offset,
+    })
+    if (!threads.length) break
+
+    for (const thread of threads) {
+      const summary = await loadCachedOrFreshSummary(thread, cacheDir)
+      summaries.push(summary)
+      if (isSubstantiveThread(summary)) {
+        substantiveCount += 1
+      }
+    }
+
+    if (substantiveTarget > 0 && substantiveCount >= substantiveTarget) {
+      break
+    }
+    if (threads.length < pageSize) {
+      break
+    }
+
+    offset += threads.length
+  }
+
+  if (substantiveTarget > 0) {
+    return filterSubstantiveThreads(summaries).slice(0, substantiveTarget)
   }
   return summaries
 }

package/lib/llm-insights.js

@@ -276,24 +276,27 @@ const SECTION_DEFS = [
     contextKind: 'project_areas',
     schemaName: 'codex_project_areas',
     schema: PROJECT_AREAS_SCHEMA,
-    prompt: `Analyze this Codex usage data and identify project areas.
+    prompt: `Analyze this Codex usage data and identify the user's main workstreams.
 
 RESPOND WITH ONLY A VALID JSON OBJECT:
 {
   "areas": [
-    {"name": "Area name", "session_count": 0, "description": "2-3 sentences about what was worked on and how Codex was used."}
+    {"name": "Area name", "session_count": 0, "description": "2-3 sentences describing the workstream, its recurring tasks, and why it matters."}
   ]
 }
 
-Include 4-5 areas. Skip Codex self-hosting/meta work unless it is a dominant project area.
+Include 3-4 areas. Skip Codex self-hosting/meta work unless it is a dominant project area.
 
 Guardrails:
 - Use concrete project or workstream names, not generic labels like "coding" or "development"
 - Base areas on repeated evidence across summaries, not one-off threads
 - Prefer project + task framing over tool-centric framing
-- Group related tasks into a coherent workstream instead of listing each task separately
-- Each description should sound like a mini report paragraph: what kinds of work clustered together, then how Codex contributed
-- Prefer descriptions that mention representative tasks or artifacts instead of vague labels`,
+- Group related tasks into a coherent long-running workstream instead of listing each task separately
+- Prefer fewer, broader areas that still feel accurate over a more complete but fragmented list
+- Do not turn recent sub-tasks, bugfixes, or cleanup passes into separate areas unless they clearly form their own repeated stream
+- Each description should read like a workstream summary, not a changelog
+- Mention representative tasks, artifacts, or decisions so the area feels concrete without enumerating every thread
+- Keep the focus on what the user was trying to accomplish; mention Codex only lightly when it clarifies the shape of the work`,
   },
   {
     name: 'interaction_style',
@@ -311,9 +314,12 @@ RESPOND WITH ONLY A VALID JSON OBJECT:
 
 Guardrails:
 - Focus on stable interaction patterns, not isolated moments
-- Talk about how the user scopes work, interrupts, redirects, or trusts execution
+- Talk about how the user scopes work, redirects goals, sets acceptance bars, or trusts execution
+- Prefer evidence from user requests, follow-up corrections, repeated constraints, and outcome patterns over implementation telemetry
 - Do not infer user preference from Codex's default tool mix or harness behavior; high exec/tool usage can reflect the agent's operating style rather than the user's instructions
 - Treat shell usage, file reads, and verification commands as weak evidence unless the user explicitly asked for that working style
+- Do not infer style from repository type, documentation volume, or language mix alone
+- Avoid turning a single repo's workflow shape into a personality claim about the user
 - If evidence is mixed, describe the tension instead of forcing one clean story`,
   },
   {
@@ -360,6 +366,7 @@ Include 3 friction categories with 2 examples each.
 Guardrails:
 - Separate model-side friction from user/workflow-side friction when useful
 - Examples must be concrete and tied to the supplied evidence
+- Treat overlap or concurrency metrics as weak supporting evidence unless the summaries or friction details also show real switching pain
 - Do not invent root causes that are not visible in the data`,
   },
   {
@@ -401,6 +408,9 @@ Guardrails:
 - Suggest only actions that clearly connect to repeated evidence
 - Avoid generic advice like "give more context" unless it is overwhelmingly justified
 - Prefer changes with strong leverage: repo memory, repeatable workflows, automation, or parallelism
+- Do not recommend first-time adoption of AGENTS.md, Skills, codex exec, Sub-agents, or MCP Servers when the capability_adoption evidence shows the user already uses them in a moderate or strong way
+- When a capability is already adopted, suggest a deeper refinement or a tighter operating pattern instead of basic adoption
+- Distinguish "you should start using this" from "you should formalize or deepen how you already use this"
 - Write AGENTS.md additions as directly pasteable instruction lines, not commentary about instructions
 - Make feature examples immediately usable; avoid placeholders like "insert your repo path here" unless unavoidable
 - Make usage pattern suggestions sound like concrete next actions the user can try today, not abstract best practices`,
@@ -989,6 +999,8 @@ function buildInsightContext(report, threadSummaries, facets) {
     ),
   ).slice(0, MAX_USER_INSTRUCTIONS)
 
+  const capabilityAdoption = summarizeCapabilityAdoption(report, threadSummaries, facets)
+
   return {
     metadata: {
       generated_at: report.metadata.generatedAt,
@@ -1025,6 +1037,7 @@ function buildInsightContext(report, threadSummaries, facets) {
       friction,
       success,
     },
+    capability_adoption: capabilityAdoption,
     session_summaries: sortedFacets.slice(0, MAX_CONTEXT_FACETS).map(facet => ({
       thread_id: facet.threadId,
       title: truncateForContext(facet.title, 80),
@@ -1051,6 +1064,69 @@ function buildInsightContext(report, threadSummaries, facets) {
   }
 }
 
+function summarizeCapabilityAdoption(report, threadSummaries, facets) {
+  const textByThread = new Map()
+  for (const thread of threadSummaries) {
+    textByThread.set(
+      thread.id,
+      [thread.title, thread.firstUserMessage]
+        .map(value => String(value || ''))
+        .join('\n')
+        .toLowerCase(),
+    )
+  }
+
+  for (const facet of facets) {
+    const existing = textByThread.get(facet.threadId) || ''
+    const facetText = [
+      facet.underlying_goal,
+      facet.brief_summary,
+      ...(facet.user_instructions || []),
+    ]
+      .map(value => String(value || ''))
+      .join('\n')
+      .toLowerCase()
+    textByThread.set(facet.threadId, `${existing}\n${facetText}`.trim())
+  }
+
+  const detectMentionedThreads = regex => {
+    let count = 0
+    for (const text of textByThread.values()) {
+      if (regex.test(text)) count += 1
+    }
+    return count
+  }
+
+  const totalThreads = Math.max(1, Number(report.metadata.threadCount || threadSummaries.length || 0))
+  const signals = {
+    agents_md: detectMentionedThreads(/\bagents\.md\b/i),
+    skills: detectMentionedThreads(/\bskills?\b/i),
+    codex_exec: detectMentionedThreads(/\bcodex exec\b/i),
+    subagents: Number(report.summary.sessionsUsingTaskAgent || 0),
+    mcp_servers: Number(report.summary.sessionsUsingMcp || 0),
+    web_search: Number(report.summary.sessionsUsingWebSearch || 0),
+    web_fetch: Number(report.summary.sessionsUsingWebFetch || 0),
+  }
+
+  return Object.fromEntries(
+    Object.entries(signals).map(([key, count]) => [
+      key,
+      {
+        count,
+        status: classifyCapabilityAdoption(count, totalThreads),
+      },
+    ]),
+  )
+}
+
+function classifyCapabilityAdoption(count, totalThreads) {
+  const share = Number(count || 0) / Math.max(1, Number(totalThreads || 0))
+  if (count >= 10 || share >= 0.25) return 'strong'
+  if (count >= 4 || share >= 0.1) return 'moderate'
+  if (count > 0) return 'light'
+  return 'none'
+}
+
 function buildAtAGlancePrompt(context, insights) {
   return `You are writing an "At a Glance" summary for a Codex usage insights report.
 

package/lib/report.js

@@ -1,3 +1,4 @@
+import os from 'node:os'
 import path from 'node:path'
 import { promises as fs } from 'node:fs'
 
@@ -6,6 +7,9 @@ export function buildReport(threadSummaries, options = {}) {
   const modelCounts = {}
   const toolCounts = {}
   const commandKindCounts = {}
+  const capabilityCounts = {}
+  const outcomeCounts = {}
+  const sessionTypeCounts = {}
   const toolFailureCounts = {}
   const activeHourCounts = {}
   const responseTimes = []
@@ -81,8 +85,20 @@ export function buildReport(threadSummaries, options = {}) {
     if (thread.usesMcp) sessionsUsingMcp += 1
     if (thread.usesWebSearch) sessionsUsingWebSearch += 1
     if (thread.usesWebFetch) sessionsUsingWebFetch += 1
+    if (thread.filesModified > 0) increment(capabilityCounts, 'Repo edits')
+    if (thread.gitCommits > 0 || thread.gitPushes > 0) increment(capabilityCounts, 'Git activity')
   }
 
+  for (const facet of options.facets || []) {
+    if (facet.outcome) increment(outcomeCounts, facet.outcome)
+    if (facet.session_type) increment(sessionTypeCounts, facet.session_type)
+  }
+
+  if (sessionsUsingTaskAgent > 0) increment(capabilityCounts, 'Sub-agents', sessionsUsingTaskAgent)
+  if (sessionsUsingMcp > 0) increment(capabilityCounts, 'MCP servers', sessionsUsingMcp)
+  if (sessionsUsingWebSearch > 0) increment(capabilityCounts, 'Web search', sessionsUsingWebSearch)
+  if (sessionsUsingWebFetch > 0) increment(capabilityCounts, 'Web fetch', sessionsUsingWebFetch)
+
   const sortedThreads = [...threadSummaries].sort(
     (a, b) => Date.parse(b.updatedAt) - Date.parse(a.updatedAt),
   )
@@ -130,6 +146,9 @@ export function buildReport(threadSummaries, options = {}) {
       models: topEntries(modelCounts, 10),
       tools: topEntries(toolCounts, 12),
       commandKinds: topEntries(commandKindCounts, 12),
+      capabilities: topEntries(capabilityCounts, 8),
+      outcomes: topEntries(outcomeCounts, 8),
+      sessionTypes: topEntries(sessionTypeCounts, 8),
       toolFailures: topEntries(toolFailureCounts, 8),
       toolErrorCategories: topEntries(toolErrorCategoryCounts, 8),
       activeHours: buildHourSeries(activeHourCounts),
@@ -176,13 +195,13 @@ export function renderTerminalSummary(report) {
     lines.push(`${report.metadata.dateRange.start} -> ${report.metadata.dateRange.end}`)
   }
   lines.push('')
-  lines.push(`${text.topTools}:`)
-  for (const item of report.charts.tools.slice(0, 5)) {
-    lines.push(`  ${item.label}: ${item.value}`)
-  }
-  lines.push('')
   lines.push(`${text.topProjects}:`)
   for (const item of report.charts.projects.slice(0, 5)) {
+    lines.push(`  ${formatProjectLabel(item.label)}: ${item.value}`)
+  }
+  lines.push('')
+  lines.push(`${text.modelMix}:`)
+  for (const item of report.charts.models.slice(0, 5)) {
     lines.push(`  ${item.label}: ${item.value}`)
   }
   return lines.join('\n')
@@ -193,9 +212,11 @@ function renderHtmlReport(report) {
   const insights = report.insights
   if (insights && !insights.__lang) insights.__lang = report.metadata.language
   const analysisUsage = report.analysisUsage || null
-  const topTools = renderBarList(report.charts.tools)
-  const topProjects = renderBarList(report.charts.projects)
-  const commandKinds = renderBarList(report.charts.commandKinds)
+  const topProjects = renderBarList(report.charts.projects, { formatLabel: formatProjectLabel })
+  const modelMix = renderBarList(report.charts.models)
+  const sessionTypes = renderBarList(report.charts.sessionTypes)
+  const outcomes = renderBarList(report.charts.outcomes)
+  const capabilitySignals = renderBarList(report.charts.capabilities)
   const toolFailures = renderBarList(report.charts.toolFailures)
   const toolErrorCategories = renderBarList(report.charts.toolErrorCategories)
   const activeHours = renderHourHistogram(report.charts.activeHours)
@@ -639,7 +660,7 @@ function renderHtmlReport(report) {
       <section class="hero">
         <span class="eyebrow">${escapeHtml(text.eyebrow)}</span>
         <h1>${escapeHtml(text.reportTitle)}</h1>
-        <p class="meta">${escapeHtml(text.generatedLabel)} ${escapeHtml(report.metadata.generatedAt)} ${escapeHtml(text.generatedFrom)} ${report.metadata.threadCount} ${escapeHtml(text.substantiveThreads)} ${escapeHtml(text.inCodexHome)} ${escapeHtml(report.metadata.codexHome)}.</p>
+        <p class="meta">${escapeHtml(text.generatedLabel)} ${escapeHtml(report.metadata.generatedAt)} ${escapeHtml(text.generatedFrom)} ${report.metadata.threadCount} ${escapeHtml(text.substantiveThreads)} ${escapeHtml(text.inCodexHome)} ${escapeHtml(formatCodexHome(report.metadata.codexHome))}.</p>
         <div class="summary-grid">
           ${renderStat(text.userMessages, formatNumber(report.summary.totalUserMessages))}
           ${renderStat(text.toolCalls, formatNumber(report.summary.totalToolCalls))}
@@ -672,17 +693,25 @@ function renderHtmlReport(report) {
           ${renderOnTheHorizon(insights)}
         </div>
         <aside class="side-column">
-          <section class="chart-panel">
-            <h2>${escapeHtml(text.topTools)}</h2>
-            ${topTools}
-          </section>
           <section class="chart-panel">
             <h2>${escapeHtml(text.topProjects)}</h2>
             ${topProjects}
           </section>
           <section class="chart-panel">
-            <h2>${escapeHtml(text.commandKinds)}</h2>
-            ${commandKinds}
+            <h2>${escapeHtml(text.modelMix)}</h2>
+            ${modelMix}
+          </section>
+          <section class="chart-panel">
+            <h2>${escapeHtml(text.sessionTypes)}</h2>
+            ${sessionTypes}
+          </section>
+          <section class="chart-panel">
+            <h2>${escapeHtml(text.outcomes)}</h2>
+            ${outcomes}
+          </section>
+          <section class="chart-panel">
+            <h2>${escapeHtml(text.capabilitySignals)}</h2>
+            ${capabilitySignals}
           </section>
           <section class="chart-panel">
             <h2>${escapeHtml(text.failureHotspots)}</h2>
@@ -1054,15 +1083,16 @@ function renderStat(label, value) {
   return `<div class="stat"><div class="value">${escapeHtml(String(value))}</div><div>${escapeHtml(label)}</div></div>`
 }
 
-function renderBarList(items) {
+function renderBarList(items, options = {}) {
   if (!items.length) return '<p class="meta">No data available.</p>'
+  const formatLabel = options.formatLabel || (value => value)
   const maxValue = Math.max(...items.map(item => item.value), 1)
   return `<div class="bar-list">${items
     .map(
       item => `
         <div class="bar-row">
           <div class="bar-label">
-            <span>${escapeHtml(item.label)}</span>
+            <span>${escapeHtml(formatLabel(item.label))}</span>
             <strong>${formatNumber(item.value)}</strong>
           </div>
           <div class="bar-track"><div class="bar-fill" style="width:${Math.max(6, (item.value / maxValue) * 100)}%"></div></div>
@@ -1133,6 +1163,36 @@ function topEntries(map, limit) {
     .map(([label, value]) => ({ label, value }))
 }
 
+function formatCodexHome(value) {
+  return formatDisplayPath(value, { tailSegments: 2, preferHomeAlias: true, ellipsis: false })
+}
+
+function formatProjectLabel(value) {
+  return formatDisplayPath(value, { tailSegments: 2, preferHomeAlias: false, ellipsis: true })
+}
+
+function formatDisplayPath(value, options = {}) {
+  const text = String(value || '').trim()
+  if (!text) return '(unknown)'
+
+  const normalized = text.replace(/\\/g, '/')
+  const home = os.homedir().replace(/\\/g, '/')
+  if (options.preferHomeAlias !== false && normalized === home) return '~'
+  if (options.preferHomeAlias !== false && normalized.startsWith(`${home}/`)) {
+    return `~/${normalized.slice(home.length + 1)}`
+  }
+
+  const parts = normalized.split('/').filter(Boolean)
+  const tailSegments = Math.max(1, Number(options.tailSegments || 2))
+  if (parts.length <= tailSegments) {
+    return normalized.startsWith('/') ? `/${parts.join('/')}` : parts.join('/')
+  }
+
+  const tail = parts.slice(-tailSegments).join('/')
+  if (options.ellipsis === false) return tail
+  return `…/${tail}`
+}
+
 function buildHourSeries(hourMap) {
   return Array.from({ length: 24 }, (_, hour) => ({
     hour,
@@ -1244,9 +1304,11 @@ function getReportText(lang) {
       filesModified: '修改文件',
       toolErrors: '工具错误',
       avgResponse: '平均响应',
-      topTools: 'Top Tools',
       topProjects: 'Top Projects',
-      commandKinds: '命令类型',
+      modelMix: '模型分布',
+      sessionTypes: '会话类型',
+      outcomes: '结果分布',
+      capabilitySignals: '能力信号',
       failureHotspots: '失败热点',
       errorCategories: '错误分类',
       timeOfDay: '活跃时段',
@@ -1321,9 +1383,11 @@ function getReportText(lang) {
     filesModified: 'Files Modified',
     toolErrors: 'Tool Errors',
     avgResponse: 'Avg Response',
-    topTools: 'Top Tools',
     topProjects: 'Top Projects',
-    commandKinds: 'Command Kinds',
+    modelMix: 'Model Mix',
+    sessionTypes: 'Session Types',
+    outcomes: 'Outcomes',
+    capabilitySignals: 'Capability Signals',
     failureHotspots: 'Failure Hotspots',
     errorCategories: 'Error Categories',
     timeOfDay: 'Time of Day',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-session-insights",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Generate a report analyzing your Codex sessions.",
   "type": "module",
   "bin": {