codex-work-receipt 0.8.1 → 0.10.0

package/src/core/receipt-record.mjs

@@ -21,6 +21,30 @@ const SCHEMA_VERSION = 2;
 const SOURCE_VERSION = "cwr2";
 const COLLECTOR_VERSION = "0.6.0";
 
+function fallbackInsights(metrics) {
+  const completedTurns = Math.max(0, Number(metrics.completedTurns || 0));
+  const ratio = (value) => completedTurns ? Number(value || 0) / completedTurns : 0;
+  const inputTokens = Math.max(0, Number(metrics.tokens?.input_tokens || 0));
+  return {
+    cache_hit_rate: inputTokens
+      ? Math.min(1, Math.max(0, Number(metrics.tokens?.cached_input_tokens || 0) / inputTokens))
+      : 0,
+    per_turn: {
+      total_tokens: ratio(metrics.tokens?.total_tokens),
+      output_tokens: ratio(metrics.tokens?.output_tokens),
+      tool_calls: ratio(metrics.toolCalls),
+      work_duration_ms: Math.round(ratio(metrics.workDurationMs)),
+    },
+    latency_ms: {
+      first_token: { sample_count: 0, p50: 0, p90: 0 },
+      turn: { sample_count: 0, p50: 0, p90: 0 },
+    },
+    activity_by_hour: Array(24).fill(0),
+    model_usage: (metrics.models || []).map((model) => ({ model, count: 0 })),
+    tool_usage: metrics.toolCalls ? [{ category: "other", count: metrics.toolCalls }] : [],
+  };
+}
+
 function fingerprintSessionIds(sessionIds) {
   return crypto.createHash("sha256").update([...sessionIds].sort().join("|")).digest("hex").slice(0, 16);
 }
@@ -28,7 +52,9 @@ function fingerprintSessionIds(sessionIds) {
 export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = DEFAULT_LOCALE, canonical = {}) {
   const sessionFingerprint = fingerprintSessionIds(metrics.sessionIds);
   const logicalKey = buildLogicalReceiptKey(metrics);
-  const summaryOnly = metrics.mode === "last-hours";
+  const summaryOnly = metrics.mode === "last-hours"
+    || (metrics.mode === "custom-range" && metrics.boundaryKind === "exact-time");
+  const insights = metrics.insights || fallbackInsights(metrics);
   const schemaVersion = summaryOnly ? 1 : SCHEMA_VERSION;
   const sourceVersion = summaryOnly ? "cwr1" : SOURCE_VERSION;
   const id = summaryOnly
@@ -41,11 +67,14 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
     tools: metrics.toolCalls,
     turns: metrics.completedTurns,
     interruptions: metrics.interruptions,
+    insights,
     scope: metrics.mode,
     rangeStartDate: metrics.rangeStartDate,
     rangeEndDate: metrics.rangeEndDate,
     windowStartAt: metrics.windowStartAt?.toISOString() || null,
     windowEndAt: metrics.windowEndAt?.toISOString() || null,
+    boundaryKind: metrics.boundaryKind || null,
+    projectFiltered: Boolean(metrics.projectId),
   });
   const workProfileId = metrics.workProfileId || "temporary-hire";
   const workProfile = getWorkProfileCopy(workProfileId, locale);
@@ -82,6 +111,8 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
       version: sourceVersion,
       scope: metrics.mode,
       hours: metrics.windowHours || null,
+      range_kind: metrics.boundaryKind || null,
+      filter_kind: metrics.projectId ? "project" : null,
       collector_version: COLLECTOR_VERSION,
       logical_key: logicalKey,
       session_fingerprint: sessionFingerprint,
@@ -104,6 +135,7 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
       average_first_token_ms: Math.round(metrics.averageFirstTokenMs),
       tokens: { ...metrics.tokens },
       models: [...metrics.models],
+      insights,
       receipt_work_points: metrics.workPoints,
       receipt_formula_version: "receipt_work_points_v1",
     },
@@ -120,6 +152,9 @@ export function buildReceiptRecord(metrics, defaultTheme = "classic", locale = D
       contains_code: false,
       contains_paths: false,
       contains_filenames: false,
+      contains_tool_names: false,
+      contains_tool_arguments: false,
+      contains_tool_output: false,
     },
   };
   if (!summaryOnly) {

package/src/core/selector.mjs

@@ -1,5 +1,7 @@
 import { createInterface } from "node:readline/promises";
 
+import { parseCustomRange } from "./range.mjs";
+
 function formatSessionDate(value, timezone, locale) {
   return new Intl.DateTimeFormat(locale === "en" ? "en-US" : "zh-CN", {
     timeZone: timezone,
@@ -21,6 +23,15 @@ function sessionLine(session, index, timezone, locale) {
   return `${index + 1}. ${start}–${end} · ${session.completedTurns} 轮 · ${session.toolCalls} 次工具调用 · ${model}`;
 }
 
+function projectLine(project, index, timezone, locale) {
+  const latest = formatSessionDate(project.endAt, timezone, locale);
+  const suffix = project.projectId.slice(-6).toUpperCase();
+  if (locale === "en") {
+    return `${index + 1}. ${project.projectLabel} · ${project.sessionCount} sessions · latest ${latest} · ${suffix}`;
+  }
+  return `${index + 1}. ${project.projectLabel} · ${project.sessionCount} 个会话 · 最近 ${latest} · ${suffix}`;
+}
+
 async function askForNumber(readline, prompt, minimum, maximum, fallback = null) {
   while (true) {
     const answer = (await readline.question(prompt)).trim();
@@ -30,11 +41,135 @@ async function askForNumber(readline, prompt, minimum, maximum, fallback = null)
   }
 }
 
-export async function promptForRange({ locale, timezone, loadRecentSessions }) {
+async function askForValue(readline, prompt) {
+  while (true) {
+    const answer = (await readline.question(prompt)).trim();
+    if (answer) return answer;
+  }
+}
+
+async function chooseSession(readline, { locale, timezone, loadRecentSessions }) {
   const isEnglish = locale === "en";
-  const readline = createInterface({ input: process.stdin, output: process.stdout });
+  const sessions = await loadRecentSessions();
+  if (!sessions.length) throw new Error(isEnglish ? "No Codex sessions found" : "没有找到可选择的 Codex 会话");
+
+  console.log(isEnglish ? "\nRecent sessions:\n" : "\n最近的会话：\n");
+  sessions.forEach((session, index) => console.log(sessionLine(session, index, timezone, locale)));
+  const choice = await askForNumber(
+    readline,
+    isEnglish ? `\nEnter 1–${sessions.length}: ` : `\n请输入 1–${sessions.length}：`,
+    1,
+    sessions.length,
+  );
+  return { mode: "session", sessionId: sessions[choice - 1].sessionId };
+}
+
+async function chooseCustomRange(readline, { locale, timezone }) {
+  const isEnglish = locale === "en";
+  console.log(isEnglish ? "\nChoose custom range precision:\n" : "\n请选择自定义区间精度：\n");
+  console.log(isEnglish
+    ? "1. Calendar dates (accountable cwr2 facts)"
+    : "1. 按自然日（生成可计入供销社的 cwr2 事实）");
+  console.log(isEnglish
+    ? "2. Exact date and time (private cwr1 summary)"
+    : "2. 精确到时间（生成不计入供销社的私人 cwr1 摘要）");
+  const precision = await askForNumber(
+    readline,
+    isEnglish ? "\nEnter 1–2 (default 1): " : "\n请输入 1–2（默认 1）：",
+    1,
+    2,
+    1,
+  );
+  const dateOnly = precision === 1;
+  const format = dateOnly ? "YYYY-MM-DD" : "YYYY-MM-DDTHH:mm";
+  while (true) {
+    const from = await askForValue(
+      readline,
+      isEnglish ? `Start (${format}, ${timezone}): ` : `开始（${format}，${timezone}）：`,
+    );
+    const to = await askForValue(
+      readline,
+      isEnglish ? `End (${format}, ${timezone}): ` : `结束（${format}，${timezone}）：`,
+    );
+    try {
+      parseCustomRange(from, to, timezone);
+    } catch (error) {
+      console.log(isEnglish ? `Invalid range: ${error.message}` : `区间无效：${error.message}`);
+      continue;
+    }
+    const confirmation = (await readline.question(isEnglish
+      ? `Use ${from} to ${to} in ${timezone}? [Y/n]: `
+      : `确认统计 ${timezone} 的 ${from} 至 ${to}？[Y/n]：`)).trim().toLowerCase();
+    if (!confirmation || confirmation === "y" || confirmation === "yes") {
+      return { mode: "custom-range", sessionId: null, from, to };
+    }
+  }
+}
+
+async function chooseProjectRange(readline, { locale, timezone, loadRecentProjects }) {
+  const isEnglish = locale === "en";
+  const projects = await loadRecentProjects();
+  if (!projects.length) throw new Error(isEnglish ? "No projects found in recent Codex sessions" : "最近的 Codex 会话中没有找到项目");
 
+  console.log(isEnglish ? "\nRecent projects:\n" : "\n最近的项目：\n");
+  projects.forEach((project, index) => console.log(projectLine(project, index, timezone, locale)));
+  const projectChoice = await askForNumber(
+    readline,
+    isEnglish ? `\nEnter 1–${projects.length}: ` : `\n请输入 1–${projects.length}：`,
+    1,
+    projects.length,
+  );
+
+  console.log(isEnglish ? "\nChoose a range for this project:\n" : "\n请选择该项目的统计范围：\n");
+  console.log(isEnglish ? "1. Today (recommended)" : "1. 今天（推荐）");
+  console.log(isEnglish ? "2. Last 3 hours" : "2. 最近 3 小时");
+  console.log(isEnglish ? "3. Last 7 calendar days" : "3. 最近 7 个自然日");
+  console.log(isEnglish ? "4. This week" : "4. 本周");
+  console.log(isEnglish ? "5. Custom range" : "5. 自定义时间区间");
+  const rangeChoice = await askForNumber(
+    readline,
+    isEnglish ? "\nEnter 1–5 (default 1): " : "\n请输入 1–5（默认 1）：",
+    1,
+    5,
+    1,
+  );
+  const projectId = projects[projectChoice - 1].projectId;
+  if (rangeChoice === 1) return { mode: "today", projectId };
+  if (rangeChoice === 2) return { mode: "last-hours", hours: 3, projectId };
+  if (rangeChoice === 3) return { mode: "last-7-days", projectId };
+  if (rangeChoice === 4) return { mode: "this-week", projectId };
+  return { ...(await chooseCustomRange(readline, { locale, timezone })), projectId };
+}
+
+async function withReadline(callback) {
+  const readline = createInterface({ input: process.stdin, output: process.stdout });
   try {
+    return await callback(readline);
+  } finally {
+    readline.close();
+  }
+}
+
+export function promptForSpecificSession(options) {
+  return withReadline((readline) => chooseSession(readline, options));
+}
+
+export function promptForCustomRange(options) {
+  return withReadline((readline) => chooseCustomRange(readline, options));
+}
+
+export function promptForProjectRange(options) {
+  return withReadline((readline) => chooseProjectRange(readline, options));
+}
+
+export async function promptForRange({
+  locale,
+  timezone,
+  loadRecentSessions,
+  loadRecentProjects,
+}) {
+  const isEnglish = locale === "en";
+  return withReadline(async (readline) => {
     console.log(isEnglish ? "\nChoose a receipt range:\n" : "\n请选择小票统计范围：\n");
     console.log(isEnglish ? "1. All activity today (recommended)" : "1. 今天全部活动（推荐）");
     console.log(isEnglish
@@ -42,13 +177,15 @@ export async function promptForRange({ locale, timezone, loadRecentSessions }) {
       : "2. 最近 3 小时（私人滚动摘要，不计入供销社）");
     console.log(isEnglish ? "3. Last 7 calendar days" : "3. 最近 7 个自然日");
     console.log(isEnglish ? "4. This week (Monday to now)" : "4. 本周（周一至今）");
-    console.log(isEnglish ? "5. Choose a specific session" : "5. 选择一个具体会话");
+    console.log(isEnglish ? "5. Custom date or time range" : "5. 自定义日期或时间区间");
+    console.log(isEnglish ? "6. Choose a specific session" : "6. 选择一个具体会话");
+    console.log(isEnglish ? "7. Choose a project" : "7. 选择一个项目");
 
     const choice = await askForNumber(
       readline,
-      isEnglish ? "\nEnter 1–5 (default 1): " : "\n请输入 1–5（默认 1）：",
+      isEnglish ? "\nEnter 1–7 (default 1): " : "\n请输入 1–7（默认 1）：",
       1,
-      5,
+      7,
       1,
     );
 
@@ -56,20 +193,8 @@ export async function promptForRange({ locale, timezone, loadRecentSessions }) {
     if (choice === 2) return { mode: "last-hours", sessionId: null, hours: 3 };
     if (choice === 3) return { mode: "last-7-days", sessionId: null };
     if (choice === 4) return { mode: "this-week", sessionId: null };
-
-    const sessions = await loadRecentSessions();
-    if (!sessions.length) throw new Error(isEnglish ? "No Codex sessions found" : "没有找到可选择的 Codex 会话");
-
-    console.log(isEnglish ? "\nRecent sessions:\n" : "\n最近的会话：\n");
-    sessions.forEach((session, index) => console.log(sessionLine(session, index, timezone, locale)));
-    const sessionChoice = await askForNumber(
-      readline,
-      isEnglish ? `\nEnter 1–${sessions.length}: ` : `\n请输入 1–${sessions.length}：`,
-      1,
-      sessions.length,
-    );
-    return { mode: "session", sessionId: sessions[sessionChoice - 1].sessionId };
-  } finally {
-    readline.close();
-  }
+    if (choice === 5) return chooseCustomRange(readline, { locale, timezone });
+    if (choice === 6) return chooseSession(readline, { locale, timezone, loadRecentSessions });
+    return chooseProjectRange(readline, { locale, timezone, loadRecentProjects });
+  });
 }

package/src/lib/tool-category.mjs

@@ -0,0 +1,36 @@
+const TOOL_CATEGORIES = new Set([
+  "terminal",
+  "file-edit",
+  "browser",
+  "research",
+  "media",
+  "agents",
+  "planning",
+  "integrations",
+  "other",
+]);
+
+export function normalizeToolCategory(value) {
+  return TOOL_CATEGORIES.has(value) ? value : "other";
+}
+
+export function classifyToolName(value) {
+  const name = String(value || "").trim().toLowerCase();
+  if (!name) return "other";
+  if (/(^|[_.-])(apply[_-]?patch|edit(?:[_-]?file)?|write(?:[_-]?file)?)$/.test(name)) return "file-edit";
+  if (/browser|playwright|computer|chrome|navigate|screenshot/.test(name)) return "browser";
+  if (/web[_-]?search|search[_-]?docs|fetch[_-]?doc|openai.*docs/.test(name)) return "research";
+  if (/image|audio|video|canvas|view[_-]?image/.test(name)) return "media";
+  if (/spawn[_-]?agent|send[_-]?message|followup[_-]?task|wait[_-]?agent|collaboration/.test(name)) return "agents";
+  if (/update[_-]?plan|request[_-]?user[_-]?input|create[_-]?goal|update[_-]?goal/.test(name)) return "planning";
+  if (/exec|shell|bash|terminal|write[_-]?stdin|command/.test(name)) return "terminal";
+  if (/^mcp__|connector|plugin|slack|github|notion|linear|figma/.test(name)) return "integrations";
+  return "other";
+}
+
+export function toolCategoryForRow(row) {
+  if (row?.type !== "response_item") return null;
+  const payloadType = row.payload?.type;
+  if (payloadType !== "custom_tool_call" && payloadType !== "function_call") return null;
+  return normalizeToolCategory(row.payload?.tool_category);
+}

package/src/parsers/codex.mjs

@@ -4,6 +4,8 @@ import os from "node:os";
 import path from "node:path";
 
 import { rowDate } from "../lib/time.mjs";
+import { classifyToolName } from "../lib/tool-category.mjs";
+import { projectDescriptorFromSessionMeta } from "../core/project-identity.mjs";
 
 const READ_CHUNK_BYTES = 256 * 1024;
 const MAX_JSONL_ROW_BYTES = 64 * 1024 * 1024;
@@ -70,6 +72,11 @@ function compactPayload(rowType, value) {
     if (firstTokenMs !== null) payload.time_to_first_token_ms = firstTokenMs;
     const totalTokenUsage = compactTokenUsage(value.info?.total_token_usage);
     if (totalTokenUsage) payload.info = { total_token_usage: totalTokenUsage };
+  } else if (
+    rowType === "response_item" &&
+    (value.type === "custom_tool_call" || value.type === "function_call")
+  ) {
+    payload.tool_category = classifyToolName(value.name);
   }
 
   return Object.keys(payload).length ? payload : null;
@@ -109,7 +116,7 @@ function sessionReadError(file, error) {
   );
 }
 
-function readJsonl(file) {
+function readJsonl(file, projectSecret = null) {
   const rows = [];
   const buffer = Buffer.allocUnsafe(READ_CHUNK_BYTES);
   const lineParts = [];
@@ -119,6 +126,7 @@ function readJsonl(file) {
   let tail = Buffer.alloc(0);
   let skippingOversizedLine = false;
   let fileDescriptor = null;
+  let project = null;
 
   const resetLine = () => {
     lineParts.length = 0;
@@ -154,7 +162,11 @@ function readJsonl(file) {
     const line = lineBuffer.toString("utf8").replace(/\r$/, "");
     if (line.trim()) {
       try {
-        const compact = compactRow(JSON.parse(line), lineIndex);
+        const parsed = JSON.parse(line);
+        if (!project && parsed?.type === "session_meta" && projectSecret) {
+          project = projectDescriptorFromSessionMeta(parsed.payload, projectSecret);
+        }
+        const compact = compactRow(parsed, lineIndex);
         if (compact) rows.push(compact);
       } catch {
         console.warn(`跳过无法解析的记录：${file.filePath}:${lineIndex}`);
@@ -194,11 +206,12 @@ function readJsonl(file) {
     rows,
     byteLength: offset,
     tailHash: crypto.createHash("sha256").update(tail).digest("hex"),
+    project,
   };
 }
 
-function sessionFromFile(file) {
-  const { rows, byteLength, tailHash } = readJsonl(file);
+function sessionFromFile(file, projectSecret = null) {
+  const { rows, byteLength, tailHash, project } = readJsonl(file, projectSecret);
   const meta = rows.find((row) => row.type === "session_meta")?.payload || {};
   const metadataSessionId = meta.session_id || meta.id || null;
   const timestamps = rows.map(rowDate).filter(Boolean).sort((left, right) => left - right);
@@ -209,6 +222,8 @@ function sessionFromFile(file) {
     modifiedAt: file.modifiedAt,
     sessionId: metadataSessionId || path.basename(file.filePath, ".jsonl"),
     identityQuality: metadataSessionId ? "metadata" : "filename_fallback",
+    projectId: project?.projectId || null,
+    projectLabel: project?.projectLabel || null,
     sourceRevision: {
       kind: "append-only-jsonl-v1",
       row_count: rows.length,
@@ -275,12 +290,16 @@ export function deduplicateCodexSessions(sessions) {
   return [...selected.values()];
 }
 
-export function loadCodexSessions(range, { codexHome = null } = {}) {
+export function loadCodexSessions(range, { codexHome = null, projectSecret = null } = {}) {
   const files = codexSessionFiles(codexHome);
   let candidates = files;
   let scanMode = "none";
 
-  if (range.scope === "latest") {
+  if (range.projectId) {
+    const fullScan = process.env.CODEX_WORK_RECEIPT_FULL_SCAN === "1";
+    candidates = range.startDate && !fullScan ? calendarCandidates(files, range.startDate) : files;
+    scanMode = fullScan ? "full" : "best_effort";
+  } else if (range.scope === "latest") {
     candidates = files.slice(0, 40);
   } else if (range.scope === "session" && range.sessionId) {
     const filenameMatches = files.filter((file) => path.basename(file.filePath).includes(range.sessionId));
@@ -291,7 +310,8 @@ export function loadCodexSessions(range, { codexHome = null } = {}) {
     scanMode = fullScan ? "full" : "best_effort";
   }
 
-  const sessions = deduplicateCodexSessions(candidates.map(sessionFromFile))
+  const sessions = deduplicateCodexSessions(candidates.map((file) => sessionFromFile(file, projectSecret)))
+    .filter((session) => !range.projectId || session.projectId === range.projectId)
     .sort((left, right) => right.endAt - left.endAt);
 
   if (range.scope === "latest") {
@@ -340,3 +360,34 @@ export function listRecentCodexSessions(limit = 10, { codexHome = null } = {}) {
     };
   });
 }
+
+export function listRecentCodexProjects(
+  limit = 10,
+  { codexHome = null, projectSecret = null } = {},
+) {
+  if (!projectSecret) throw new Error("列出项目时缺少本地项目身份密钥");
+  const sessions = deduplicateCodexSessions(codexSessionFiles(codexHome)
+    .slice(0, Math.max(120, limit * 20))
+    .map((file) => sessionFromFile(file, projectSecret))
+    .filter((session) => session.rows.length && session.projectId));
+  const projects = new Map();
+  for (const session of sessions) {
+    const current = projects.get(session.projectId);
+    if (!current) {
+      projects.set(session.projectId, {
+        projectId: session.projectId,
+        projectLabel: session.projectLabel,
+        sessionCount: 1,
+        startAt: session.startAt,
+        endAt: session.endAt,
+      });
+      continue;
+    }
+    current.sessionCount += 1;
+    if (session.startAt < current.startAt) current.startAt = session.startAt;
+    if (session.endAt > current.endAt) current.endAt = session.endAt;
+  }
+  return [...projects.values()]
+    .sort((left, right) => right.endAt - left.endAt)
+    .slice(0, limit);
+}