codex-work-receipt 0.8.1 → 0.10.0

package/src/core/presentation.mjs

@@ -93,6 +93,58 @@ const RECEIPT_COPY = {
       changelogLink: "查看更新日志 →",
       sponsorLabel: "赞助伙伴",
       sponsorAlt: "ModelFlare 标志",
+      features: {
+        title: "更多小票功能",
+        countLabel: "{count} 项",
+        description: "复制命令后，在终端中运行即可。",
+        copyLabel: "复制",
+        copiedLabel: "已复制",
+        copyErrorLabel: "复制失败",
+        copiedStatus: "命令已复制到剪贴板",
+        copyErrorStatus: "无法自动复制，请手动选择命令",
+        tabAria: "小票功能分类",
+        groups: [
+          {
+            id: "time",
+            title: "时间范围",
+            commands: [
+              { label: "生成最近一次小票", args: "--latest" },
+              { label: "生成最近 3 小时小票", args: "--hours 3" },
+              { label: "生成今日小票", args: "--today" },
+              { label: "生成最近 7 天小票", args: "--range last-7-days" },
+              { label: "生成本周小票", args: "--range this-week" },
+              { label: "自定义时间区间", args: "--custom-range" },
+            ],
+          },
+          {
+            id: "selection",
+            title: "会话与项目",
+            commands: [
+              { label: "选择指定会话", args: "--select-session" },
+              { label: "选择指定项目", args: "--select-project" },
+            ],
+          },
+          {
+            id: "automation",
+            title: "自动与手动",
+            commands: [
+              { label: "重新选择工作模式", args: "--setup" },
+              { label: "开启自动保存", args: "--enable-auto" },
+              { label: "切换为仅手动", args: "--disable-auto" },
+              { label: "查看自动保存状态", args: "--auto-status" },
+            ],
+          },
+          {
+            id: "companion",
+            title: "票仔与对话开票",
+            commands: [
+              { label: "安装票仔和对话开票", args: "--install-companion" },
+              { label: "仅安装票仔", args: "--install-pet" },
+              { label: "仅安装对话开票", args: "--install-skill" },
+            ],
+          },
+        ],
+      },
     },
     themes: {
       classic: "经典白票",
@@ -103,6 +155,9 @@ const RECEIPT_COPY = {
       latest: "最近一次会话",
       session: "指定会话",
       "last-hours": "最近 {hours} 小时",
+      "custom-range-calendar-days": "自定义日期",
+      "custom-range-exact-time": "自定义时间",
+      "custom-range": "自定义区间",
       today: "今日全部会话",
       "last-7-days": "最近 7 个自然日",
       "this-week": "本周全部会话",
@@ -135,6 +190,36 @@ const RECEIPT_COPY = {
       interruptions: ["次", "次"],
       seconds: ["秒", "秒"],
     },
+    insights: {
+      title: "效率与工作结构",
+      cacheHit: "缓存命中率",
+      perTurn: "每轮效率",
+      totalTokens: "总 Token",
+      outputTokens: "输出 Token",
+      toolCalls: "工具调用",
+      firstTokenLatency: "首次响应延迟",
+      turnLatency: "整轮耗时",
+      p50: "P50",
+      p90: "P90",
+      noSamples: "暂无样本",
+      heatmap: "工作时间热力图",
+      heatmapCell: "{hour}:00 · {count} 轮",
+      models: "模型结构",
+      tools: "工具结构",
+      turnsUnit: "轮",
+      callsUnit: "次",
+      toolCategories: {
+        terminal: "终端命令",
+        "file-edit": "文件编辑",
+        browser: "浏览器操作",
+        research: "检索研究",
+        media: "图像与媒体",
+        agents: "多代理协作",
+        planning: "规划与确认",
+        integrations: "外部集成",
+        other: "其他工具",
+      },
+    },
     footerThanks: "谢谢惠顾，欢迎明天继续改需求",
     transferAria: "微信小程序导入联",
     transferTitle: "导入到微信小程序",
@@ -166,6 +251,8 @@ const RECEIPT_COPY = {
     placeholderAria: "小程序码待接入",
     transferNote: "导入文件和可选数据码只包含时间、轮次、Token 和工具调用等统计，不包含 Prompt、回复正文、代码、项目路径或文件名。",
     rollingSummaryNotice: "最近 {hours} 小时属于滚动摘要，只保存到私人历史，不参与 AI 供销社统计。需要统计时请生成“今日 / 本周 / 近 7 日 / 指定会话”小票。",
+    customSummaryNotice: "精确时间区间属于私人摘要，不参与 AI 供销社统计。按自然日选择自定义区间时可以生成可去重的规范事实。",
+    projectScopeTemplate: "指定项目 · {scope}",
     privacy: "结构数据和微信导入文件同时保存在本机；只有你主动发送文件或扫码时，脱敏统计才会离开电脑。",
   },
   en: {
@@ -186,6 +273,58 @@ const RECEIPT_COPY = {
       changelogLink: "View the changelog →",
       sponsorLabel: "Sponsored by",
       sponsorAlt: "ModelFlare logo",
+      features: {
+        title: "More receipt features",
+        countLabel: "{count} commands",
+        description: "Copy a command, then run it in your terminal.",
+        copyLabel: "Copy",
+        copiedLabel: "Copied",
+        copyErrorLabel: "Copy failed",
+        copiedStatus: "Command copied to the clipboard",
+        copyErrorStatus: "Could not copy automatically. Select the command manually.",
+        tabAria: "Receipt feature categories",
+        groups: [
+          {
+            id: "time",
+            title: "Time ranges",
+            commands: [
+              { label: "Generate the latest receipt", args: "--latest" },
+              { label: "Generate the last 3 hours", args: "--hours 3" },
+              { label: "Generate today's receipt", args: "--today" },
+              { label: "Generate the last 7 days", args: "--range last-7-days" },
+              { label: "Generate this week's receipt", args: "--range this-week" },
+              { label: "Choose a custom range", args: "--custom-range" },
+            ],
+          },
+          {
+            id: "selection",
+            title: "Sessions and projects",
+            commands: [
+              { label: "Choose a specific session", args: "--select-session" },
+              { label: "Choose a specific project", args: "--select-project" },
+            ],
+          },
+          {
+            id: "automation",
+            title: "Automatic and manual",
+            commands: [
+              { label: "Choose a working mode", args: "--setup" },
+              { label: "Enable automatic saving", args: "--enable-auto" },
+              { label: "Switch to manual only", args: "--disable-auto" },
+              { label: "Check automatic saving", args: "--auto-status" },
+            ],
+          },
+          {
+            id: "companion",
+            title: "Ticket Buddy and chat commands",
+            commands: [
+              { label: "Install Ticket Buddy and chat commands", args: "--install-companion" },
+              { label: "Install Ticket Buddy only", args: "--install-pet" },
+              { label: "Install chat commands only", args: "--install-skill" },
+            ],
+          },
+        ],
+      },
     },
     themes: {
       classic: "Classic White",
@@ -196,6 +335,9 @@ const RECEIPT_COPY = {
       latest: "Latest session",
       session: "Selected session",
       "last-hours": "Last {hours} hours",
+      "custom-range-calendar-days": "Custom dates",
+      "custom-range-exact-time": "Custom time range",
+      "custom-range": "Custom range",
       today: "All sessions today",
       "last-7-days": "Last 7 calendar days",
       "this-week": "All sessions this week",
@@ -228,6 +370,36 @@ const RECEIPT_COPY = {
       interruptions: ["time", "times"],
       seconds: ["sec", "sec"],
     },
+    insights: {
+      title: "Efficiency & work structure",
+      cacheHit: "Cache hit rate",
+      perTurn: "Per-turn efficiency",
+      totalTokens: "total Tokens",
+      outputTokens: "output Tokens",
+      toolCalls: "tool calls",
+      firstTokenLatency: "First-token latency",
+      turnLatency: "Full-turn duration",
+      p50: "P50",
+      p90: "P90",
+      noSamples: "No samples",
+      heatmap: "Work-time heatmap",
+      heatmapCell: "{hour}:00 · {count} turns",
+      models: "Model structure",
+      tools: "Tool structure",
+      turnsUnit: "turns",
+      callsUnit: "calls",
+      toolCategories: {
+        terminal: "Terminal",
+        "file-edit": "File editing",
+        browser: "Browser",
+        research: "Research",
+        media: "Image & media",
+        agents: "Multi-agent",
+        planning: "Planning",
+        integrations: "Integrations",
+        other: "Other tools",
+      },
+    },
     footerThanks: "Thanks for your business. More revisions welcome tomorrow.",
     transferAria: "WeChat mini-program import stub",
     transferTitle: "IMPORT INTO WECHAT",
@@ -259,6 +431,8 @@ const RECEIPT_COPY = {
     placeholderAria: "Mini-program code pending",
     transferNote: "The import file and optional data code contain only statistics such as time, turns, Tokens, and tool calls. They do not contain prompts, responses, code, project paths, or file names.",
     rollingSummaryNotice: "The last {hours} hours is a rolling summary for private history only. It does not participate in AI Work Cooperative accounting. Use today, this week, the last seven days, or a specific session for accountable facts.",
+    customSummaryNotice: "An exact time range is a private summary and does not participate in AI Work Cooperative accounting. Choose whole calendar dates to create deduplicated canonical facts.",
+    projectScopeTemplate: "Selected project · {scope}",
     privacy: "Structured data and the WeChat import file stay on this computer until you explicitly send the file or scan its data code.",
   },
 };
@@ -268,6 +442,7 @@ const COMPENSATION_COPY = {
     latest: "本单工资",
     session: "本单工资",
     "last-hours": "本段工资",
+    "custom-range": "区间工资",
     today: "本日工资",
     "last-7-days": "近七日工资",
     "this-week": "本周工资",
@@ -278,6 +453,7 @@ const COMPENSATION_COPY = {
     latest: "SHIFT PAY",
     session: "SHIFT PAY",
     "last-hours": "WINDOW PAY",
+    "custom-range": "RANGE PAY",
     today: "TODAY'S PAY",
     "last-7-days": "7-DAY PAY",
     "this-week": "THIS WEEK'S PAY",
@@ -306,15 +482,26 @@ export function getReceiptCopy(locale = DEFAULT_LOCALE) {
   return RECEIPT_COPY[SUPPORTED_LOCALES.has(locale) ? locale : DEFAULT_LOCALE];
 }
 
-export function getScopeLabel(scope, locale = DEFAULT_LOCALE, hours = null) {
-  const template = getReceiptCopy(locale).scope[scope] || getReceiptCopy(locale).scope.latest;
-  return String(template).replaceAll("{hours}", String(hours || 3));
+export function getScopeLabel(scope, locale = DEFAULT_LOCALE, hours = null, options = {}) {
+  const copy = getReceiptCopy(locale);
+  const scopeKey = scope === "custom-range" && options.rangeKind
+    ? `custom-range-${options.rangeKind}`
+    : scope;
+  const template = copy.scope[scopeKey] || copy.scope[scope] || copy.scope.latest;
+  const label = String(template).replaceAll("{hours}", String(hours || 3));
+  return options.filterKind === "project"
+    ? String(copy.projectScopeTemplate).replaceAll("{scope}", label)
+    : label;
 }
 
 export function getRollingSummaryNotice(locale = DEFAULT_LOCALE, hours = null) {
   return String(getReceiptCopy(locale).rollingSummaryNotice).replaceAll("{hours}", String(hours || 3));
 }
 
+export function getCustomSummaryNotice(locale = DEFAULT_LOCALE) {
+  return getReceiptCopy(locale).customSummaryNotice;
+}
+
 export function buildCompensation(scope, amount, locale = DEFAULT_LOCALE) {
   const copy = COMPENSATION_COPY[SUPPORTED_LOCALES.has(locale) ? locale : DEFAULT_LOCALE];
   return {

package/src/core/project-identity.mjs

@@ -0,0 +1,132 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+
+import { writeFileAtomicSync } from "../lib/files.mjs";
+
+const PROJECT_KEY_FILENAME = "project-identity.key";
+const PROJECT_ID_DOMAIN = "codex-work-receipt/project/v1";
+
+function workReceiptHome(requestedDataDir = null) {
+  return path.resolve(
+    requestedDataDir || process.env.CODEX_WORK_RECEIPT_HOME || path.join(os.homedir(), ".codex-work-receipt"),
+  );
+}
+
+function normalizeRepositoryUrl(value) {
+  return String(value || "")
+    .trim()
+    .replace(/\\/g, "/")
+    .replace(/^git@([^:]+):/i, "$1/")
+    .replace(/^[a-z][a-z0-9+.-]*:\/\/(?:[^@/]+@)?/i, "")
+    .replace(/\.git\/?$/i, "")
+    .replace(/\/+$/, "")
+    .toLowerCase();
+}
+
+function projectLabelFromRepositoryUrl(value) {
+  const normalized = String(value || "").trim().replace(/\\/g, "/").replace(/\.git\/?$/i, "");
+  const segment = normalized.split(/[/:]/).filter(Boolean).at(-1);
+  return segment || null;
+}
+
+function normalizeWorkingDirectory(value) {
+  const resolved = path.resolve(String(value || "").trim());
+  return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+}
+
+function projectIdForIdentity(identity, secret) {
+  const digest = crypto
+    .createHmac("sha256", secret)
+    .update(`${PROJECT_ID_DOMAIN}\0${identity}`)
+    .digest("hex");
+  return `cwp_${digest}`;
+}
+
+function gitDirectoryForProject(projectPath) {
+  let current = projectPath;
+  while (true) {
+    const candidate = path.join(current, ".git");
+    if (fs.existsSync(candidate)) {
+      const stats = fs.statSync(candidate);
+      if (stats.isDirectory()) return candidate;
+      if (stats.isFile()) {
+        const match = /^gitdir:\s*(.+)$/im.exec(fs.readFileSync(candidate, "utf8"));
+        if (match) return path.resolve(current, match[1].trim());
+      }
+    }
+    const parent = path.dirname(current);
+    if (parent === current) return null;
+    current = parent;
+  }
+}
+
+function repositoryUrlFromConfig(gitDirectory) {
+  if (!gitDirectory) return null;
+  let configPath = path.join(gitDirectory, "config");
+  if (!fs.existsSync(configPath)) {
+    const commonDirPath = path.join(gitDirectory, "commondir");
+    if (fs.existsSync(commonDirPath)) {
+      configPath = path.join(path.resolve(gitDirectory, fs.readFileSync(commonDirPath, "utf8").trim()), "config");
+    }
+  }
+  if (!fs.existsSync(configPath)) return null;
+  const config = fs.readFileSync(configPath, "utf8");
+  const origin = /\[remote\s+"origin"\]([\s\S]*?)(?=\n\s*\[|$)/i.exec(config)?.[1] || "";
+  return /^\s*url\s*=\s*(.+)$/im.exec(origin)?.[1]?.trim() || null;
+}
+
+export function getProjectIdentitySecret({ dataDir = null } = {}) {
+  const directory = workReceiptHome(dataDir);
+  const keyPath = path.join(directory, PROJECT_KEY_FILENAME);
+  fs.mkdirSync(directory, { recursive: true });
+  if (fs.existsSync(keyPath)) {
+    const value = fs.readFileSync(keyPath, "utf8").trim();
+    if (/^[a-f0-9]{64}$/i.test(value)) return Buffer.from(value, "hex");
+    throw new Error(`项目身份密钥无效：${keyPath}`);
+  }
+
+  const secret = crypto.randomBytes(32);
+  writeFileAtomicSync(keyPath, `${secret.toString("hex")}\n`);
+  try { fs.chmodSync(keyPath, 0o600); } catch {}
+  return secret;
+}
+
+export function projectDescriptorFromSessionMeta(payload, secret) {
+  if (!secret || !payload || typeof payload !== "object") return null;
+  const repositoryUrl = typeof payload.git?.repository_url === "string"
+    ? payload.git.repository_url
+    : null;
+  const cwd = typeof payload.cwd === "string" ? payload.cwd : null;
+  if (!repositoryUrl && !cwd) return null;
+
+  const identity = repositoryUrl
+    ? `repository:${normalizeRepositoryUrl(repositoryUrl)}`
+    : `directory:${normalizeWorkingDirectory(cwd)}`;
+  const label = repositoryUrl
+    ? projectLabelFromRepositoryUrl(repositoryUrl)
+    : path.basename(normalizeWorkingDirectory(cwd));
+  return {
+    projectId: projectIdForIdentity(identity, secret),
+    projectLabel: label || "Codex project",
+  };
+}
+
+export function projectDescriptorFromPath(value, secret) {
+  if (!secret) throw new Error("指定项目时缺少本地项目身份密钥");
+  const projectPath = normalizeWorkingDirectory(value);
+  if (!fs.existsSync(projectPath) || !fs.statSync(projectPath).isDirectory()) {
+    throw new Error(`项目目录不存在：${value}`);
+  }
+  const repositoryUrl = repositoryUrlFromConfig(gitDirectoryForProject(projectPath));
+  const identity = repositoryUrl
+    ? `repository:${normalizeRepositoryUrl(repositoryUrl)}`
+    : `directory:${projectPath}`;
+  return {
+    projectId: projectIdForIdentity(identity, secret),
+    projectLabel: repositoryUrl
+      ? projectLabelFromRepositoryUrl(repositoryUrl)
+      : path.basename(projectPath),
+  };
+}

package/src/core/range.mjs

@@ -4,6 +4,7 @@ export const RECEIPT_SCOPES = new Set([
   "latest",
   "session",
   "last-hours",
+  "custom-range",
   "today",
   "last-7-days",
   "this-week",
@@ -14,6 +15,8 @@ const SCOPE_ALIASES = new Map([
   ["session", "session"],
   ["hours", "last-hours"],
   ["last-hours", "last-hours"],
+  ["custom", "custom-range"],
+  ["custom-range", "custom-range"],
   ["today", "today"],
   ["7d", "last-7-days"],
   ["last-7-days", "last-7-days"],
@@ -47,7 +50,125 @@ function floorToMinute(value) {
   return date;
 }
 
-export function resolveRange(scope, timezone, now = new Date(), sessionId = null, hours = null) {
+function parseDateParts(value) {
+  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(String(value || "").trim());
+  if (!match) return null;
+  return { year: Number(match[1]), month: Number(match[2]), day: Number(match[3]) };
+}
+
+function parseDateTimeParts(value) {
+  const match = /^(\d{4})-(\d{2})-(\d{2})[T\s](\d{2}):(\d{2})$/.exec(String(value || "").trim());
+  if (!match) return null;
+  return {
+    year: Number(match[1]),
+    month: Number(match[2]),
+    day: Number(match[3]),
+    hour: Number(match[4]),
+    minute: Number(match[5]),
+  };
+}
+
+function validCalendarParts(parts, includeTime = false) {
+  if (!parts) return false;
+  const probe = new Date(Date.UTC(parts.year, parts.month - 1, parts.day));
+  if (
+    probe.getUTCFullYear() !== parts.year ||
+    probe.getUTCMonth() + 1 !== parts.month ||
+    probe.getUTCDate() !== parts.day
+  ) return false;
+  if (!includeTime) return true;
+  return parts.hour >= 0 && parts.hour <= 23 && parts.minute >= 0 && parts.minute <= 59;
+}
+
+function zonedParts(date, timezone) {
+  const parts = new Intl.DateTimeFormat("en-CA", {
+    timeZone: timezone,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hourCycle: "h23",
+  }).formatToParts(date);
+  return Object.fromEntries(parts.filter((part) => part.type !== "literal").map((part) => [part.type, Number(part.value)]));
+}
+
+function zonedDateTime(parts, timezone) {
+  const target = Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour || 0, parts.minute || 0, 0, 0);
+  let result = new Date(target);
+  for (let index = 0; index < 3; index += 1) {
+    const displayed = zonedParts(result, timezone);
+    const displayedUtc = Date.UTC(
+      displayed.year,
+      displayed.month - 1,
+      displayed.day,
+      displayed.hour,
+      displayed.minute,
+      displayed.second,
+    );
+    result = new Date(result.getTime() + target - displayedUtc);
+  }
+  const displayed = zonedParts(result, timezone);
+  if (
+    displayed.year !== parts.year ||
+    displayed.month !== parts.month ||
+    displayed.day !== parts.day ||
+    displayed.hour !== (parts.hour || 0) ||
+    displayed.minute !== (parts.minute || 0)
+  ) throw new Error("自定义时间在所选时区中不存在，请检查夏令时切换或输入格式");
+  return result;
+}
+
+export function parseCustomRange(from, to, timezone) {
+  const fromDate = parseDateParts(from);
+  const toDate = parseDateParts(to);
+  const fromDateTime = parseDateTimeParts(from);
+  const toDateTime = parseDateTimeParts(to);
+
+  if (fromDate && toDate) {
+    if (!validCalendarParts(fromDate) || !validCalendarParts(toDate)) throw new Error("自定义日期无效");
+    const startDate = String(from).trim();
+    const endDate = String(to).trim();
+    if (startDate > endDate) throw new Error("自定义区间的开始日期不能晚于结束日期");
+    const nextDate = shiftDateKey(endDate, 1);
+    return {
+      boundaryKind: "calendar-days",
+      startDate,
+      endDate,
+      startAt: zonedDateTime({ ...fromDate, hour: 0, minute: 0 }, timezone),
+      endAt: zonedDateTime({ ...parseDateParts(nextDate), hour: 0, minute: 0 }, timezone),
+    };
+  }
+
+  if (fromDateTime && toDateTime) {
+    if (!validCalendarParts(fromDateTime, true) || !validCalendarParts(toDateTime, true)) {
+      throw new Error("自定义时间无效");
+    }
+    const startAt = zonedDateTime(fromDateTime, timezone);
+    const endAt = zonedDateTime(toDateTime, timezone);
+    if (startAt >= endAt) throw new Error("自定义区间的开始时间必须早于结束时间");
+    return {
+      boundaryKind: "exact-time",
+      startDate: dateKey(startAt, timezone),
+      endDate: dateKey(endAt, timezone),
+      startAt,
+      endAt,
+    };
+  }
+
+  throw new Error("自定义区间请统一使用 YYYY-MM-DD，或 YYYY-MM-DDTHH:mm 格式");
+}
+
+export function resolveRange(
+  scope,
+  timezone,
+  now = new Date(),
+  sessionId = null,
+  hours = null,
+  customRange = null,
+  projectId = null,
+) {
   const normalizedScope = normalizeScope(scope);
   if (!normalizedScope || !RECEIPT_SCOPES.has(normalizedScope)) {
     throw new Error(`不支持的统计范围：${scope}`);
@@ -59,6 +180,7 @@ export function resolveRange(scope, timezone, now = new Date(), sessionId = null
   let startAt = null;
   let endAt = null;
   let windowHours = null;
+  let boundaryKind = null;
 
   if (normalizedScope === "last-hours") {
     windowHours = Number(hours ?? 3);
@@ -69,6 +191,15 @@ export function resolveRange(scope, timezone, now = new Date(), sessionId = null
     startAt = new Date(endAt.getTime() - windowHours * 60 * 60 * 1000);
     startDate = dateKey(startAt, timezone);
     endDate = dateKey(endAt, timezone);
+    boundaryKind = "exact-time";
+  } else if (normalizedScope === "custom-range") {
+    if (!customRange?.from || !customRange?.to) throw new Error("自定义区间需要开始和结束时间");
+    const parsed = parseCustomRange(customRange.from, customRange.to, timezone);
+    startDate = parsed.startDate;
+    endDate = parsed.endDate;
+    startAt = parsed.startAt;
+    endAt = parsed.endAt;
+    boundaryKind = parsed.boundaryKind;
   } else if (normalizedScope === "today") {
     startDate = targetDate;
     endDate = targetDate;
@@ -90,23 +221,27 @@ export function resolveRange(scope, timezone, now = new Date(), sessionId = null
     endAt,
     hours: windowHours,
     sessionId: sessionId || null,
+    boundaryKind,
+    projectId: projectId || null,
   };
 }
 
-export function isCalendarScope(scope) {
-  return scope === "today" || scope === "last-7-days" || scope === "this-week";
+export function isCalendarRange(range) {
+  return range?.scope === "today" || range?.scope === "last-7-days" || range?.scope === "this-week"
+    || (range?.scope === "custom-range" && range?.boundaryKind === "calendar-days");
 }
 
-export function isTimeWindowScope(scope) {
-  return scope === "last-hours";
+export function isTimeWindowRange(range) {
+  return range?.scope === "last-hours"
+    || (range?.scope === "custom-range" && range?.boundaryKind === "exact-time");
 }
 
 export function isDateInRange(date, range) {
   if (!date) return false;
-  if (isTimeWindowScope(range.scope)) {
-    return date >= range.startAt && date <= range.endAt;
+  if (isTimeWindowRange(range)) {
+    return date >= range.startAt && (range.scope === "custom-range" ? date < range.endAt : date <= range.endAt);
   }
-  if (!isCalendarScope(range.scope)) return true;
+  if (!isCalendarRange(range)) return true;
   const key = dateKey(date, range.timezone);
   return key >= range.startDate && key <= range.endDate;
 }
@@ -145,6 +280,18 @@ export function outputSlugForRange(range, receiptId = "") {
       : endAt.toISOString().replace(/[-:]/g, "").slice(0, 13);
     return `last-${Number(range?.hours || 3)}-hours-${safeSlugSegment(endStamp, "window")}`;
   }
+  if (scope === "custom-range") {
+    if (range?.boundaryKind === "calendar-days") {
+      const dateSpan = startDate === endDate ? endDate : `${startDate}-to-${endDate}`;
+      return `custom-${safeSlugSegment(dateSpan, "range")}`;
+    }
+    const startAt = range?.startAt instanceof Date ? range.startAt : new Date(range?.startAt || 0);
+    const endAt = range?.endAt instanceof Date ? range.endAt : new Date(range?.endAt || 0);
+    const stamp = (value) => Number.isNaN(value.getTime())
+      ? "time"
+      : value.toISOString().replace(/[-:]/g, "").slice(0, 13);
+    return `custom-${safeSlugSegment(`${stamp(startAt)}-to-${stamp(endAt)}`, "range")}`;
+  }
   if (scope === "last-7-days" || scope === "this-week") {
     const dateSpan = startDate === endDate ? endDate : `${startDate}-to-${endDate}`;
     return `${scope}-${safeSlugSegment(dateSpan, scope)}`;