ccus-cli 0.1.13 → 0.1.15

package/dist/cli.js

@@ -61,7 +61,7 @@ const update_check_1 = require("./lib/update-check");
 const version_1 = require("./lib/version");
 /** CLI 帮助信息保持简洁，方便直接挂到 README 或终端里查看。 */
 function printHelp() {
-    process.stdout.write(`ccus\n\nCommands:\n  ccus install [--settings PATH] [--command CMD] [--data-dir PATH]\n  ccus statusline emit [--data-dir PATH] [--input FILE] [--no-store]\n  ccus dashboard build [--range today|this-week|last-week|5h] [--out FILE] [--data-dir PATH]\n  ccus dashboard open [--range today|this-week|last-week|5h] [--out FILE] [--data-dir PATH]\n  ccus dashboard serve [--range today|this-week|last-week|5h] [--port 0] [--host 127.0.0.1] [--open] [--data-dir PATH]\n  ccus export [RANGE] [--out FILE] [--data-dir PATH]   (RANGE: this-week|tw, last-week|lw, today, 5h; e.g. ccus export lw)\n  ccus aggregate --input-dir DIR [--out-dir DIR]\n  ccus aggregate serve --input-dir DIR [--port 0] [--host 127.0.0.1]\n  ccus sync [--data-dir PATH]\n  ccus sync config [--target DIR] [--interval 3h|daily|<N>h|<N>m] [--range this-week] [--suffix NAME | --no-suffix] [--data-dir PATH]\n  ccus sync install [--print] [--data-dir PATH]   (注册每周五 18:00 的系统调度器)\n  ccus sync uninstall [--print]   (卸载系统调度器)\n  ccus sync status [--data-dir PATH]\n  ccus open [--data-dir PATH] [--print]\n  ccus update [--data-dir PATH]\n  ccus --version\n\nGlobal flags:\n  --verbose | --debug | -v   输出详细调试日志到 stderr（等价于设置 CCUS_DEBUG=1），方便排查问题\n`);
+    process.stdout.write(`ccus\n\nCommands:\n  ccus install [--settings PATH] [--command CMD] [--data-dir PATH]\n  ccus statusline emit [--data-dir PATH] [--input FILE] [--no-store]\n  ccus dashboard build [--range today|this-week|last-week|5h] [--out FILE] [--data-dir PATH]\n  ccus dashboard open [--range today|this-week|last-week|5h] [--out FILE] [--data-dir PATH]\n  ccus dashboard serve [--range today|this-week|last-week|5h] [--port 0] [--host 127.0.0.1] [--open] [--data-dir PATH]\n  ccus export [RANGE] [--out FILE] [--data-dir PATH]   (RANGE: this-week|tw, last-week|lw, today, 5h; e.g. ccus export lw)\n  ccus sessions [RANGE] [--out FILE] [--data-dir PATH]   (把 ~/.claude/projects 本周活跃 session 打包成 zip，名如 projects_<dates>_<user>.zip)\n  ccus aggregate --input-dir DIR [--out-dir DIR]\n  ccus aggregate serve --input-dir DIR [--port 0] [--host 127.0.0.1]\n  ccus sync [--data-dir PATH]\n  ccus sync config [--target DIR] [--interval 3h|daily|<N>h|<N>m] [--range this-week] [--suffix NAME | --no-suffix] [--data-dir PATH]\n  ccus sync install [--print] [--data-dir PATH]   (注册每周五 18:00 的系统调度器)\n  ccus sync uninstall [--print]   (卸载系统调度器)\n  ccus sync status [--data-dir PATH]\n  ccus open [--data-dir PATH] [--print]\n  ccus update [--data-dir PATH]\n  ccus --version\n\nGlobal flags:\n  --verbose | --debug | -v   输出详细调试日志到 stderr（等价于设置 CCUS_DEBUG=1），方便排查问题\n`);
 }
 /** 一个轻量的参数解析器，当前命令面不复杂，没必要引入额外依赖。 */
 function parseOptions(args) {
@@ -563,6 +563,53 @@ function resolveExportOptions(action, args, rest) {
     }
     return options;
 }
+/**
+ * `ccus sessions`：把 ~/.claude/projects 中在指定时间范围内有活动的 session 文件打包成 zip。
+ *
+ * zip 内部结构保持 <projectDir>/<sessionId>.jsonl 层级（路径分隔符统一用 /）。
+ * 文件名格式：projects_<start>_<end>_<gitUserName>.zip。
+ * 默认输出到 <data-dir>/sessions/，加 --out 可指定完整路径。
+ * 位置参数作为 range 简写，例如 `ccus sessions lw` 等价于 `--range last-week`。
+ */
+async function handleSessions(options) {
+    const dataDir = getDataDir(options);
+    const range = getStringOption(options, "range") ?? "this-week";
+    const out = getStringOption(options, "out");
+    const now = new Date();
+    const window = (0, time_1.expandToFullWeekWindow)((0, time_1.resolveRange)(range, now));
+    (0, debug_1.debugLog)("sessions", "range resolved", { range, label: window.label, start: window.start.toISOString(), end: window.end.toISOString() });
+    const sessions = await (0, claude_1.findActiveSessionFiles)(window.start, window.end);
+    (0, debug_1.debugLog)("sessions", "active sessions found", { count: sessions.length });
+    const fsRead = (await Promise.resolve().then(() => __importStar(require("node:fs/promises")))).readFile;
+    const { buildZipBuffer } = await Promise.resolve().then(() => __importStar(require("./lib/zip")));
+    const entries = await Promise.all(sessions.map(async (session) => ({
+        name: `${session.projectDir.replaceAll("\\", "/")}/${session.sessionId}.jsonl`,
+        data: await fsRead(session.filePath),
+    })));
+    const zipBuffer = await buildZipBuffer(entries);
+    const gitIdentity = await (0, git_1.readGitIdentity)();
+    const userName = (0, time_1.formatGitEmailFilePrefix)(gitIdentity.userEmail) ?? "unknown";
+    const fileLabel = (0, time_1.formatRangeFileLabel)(window.start, window.end);
+    const defaultFileName = `projects_${fileLabel}_${userName}.zip`;
+    const outputPath = node_path_1.default.resolve(out ?? node_path_1.default.join(dataDir, "sessions", defaultFileName));
+    const fsNode = await Promise.resolve().then(() => __importStar(require("node:fs/promises")));
+    await fsNode.mkdir(node_path_1.default.dirname(outputPath), { recursive: true });
+    await fsNode.writeFile(outputPath, zipBuffer);
+    process.stdout.write(`${outputPath}\n`);
+}
+/**
+ * 解析 sessions 命令的参数，支持 RANGE 作为位置参数简写。
+ */
+function resolveSessionsOptions(action, args, rest) {
+    if (!action || action.startsWith("--")) {
+        return parseOptions(args.slice(1));
+    }
+    const options = parseOptions(rest);
+    if (typeof options.range !== "string") {
+        options.range = action;
+    }
+    return options;
+}
 /** 用 readline 向用户提问，返回用户输入的一行文本。 */
 async function prompt(question) {
     const rl = (await Promise.resolve().then(() => __importStar(require("node:readline")))).createInterface({
@@ -851,6 +898,11 @@ async function main(args = process.argv.slice(2)) {
         await handleExport(exportOptions);
         return;
     }
+    if (group === "sessions") {
+        const sessionsOptions = resolveSessionsOptions(action, args, rest);
+        await handleSessions(sessionsOptions);
+        return;
+    }
     if (group === "aggregate") {
         if (action === "serve") {
             await handleAggregateServe(parseOptions(rest));

package/dist/lib/aggregate.js

@@ -122,14 +122,26 @@ async function loadWeeklyExportBundles(inputDir) {
 function bundlePersonKey(bundle) {
     return toPersonKey(bundle.identity.gitUserEmail, bundle.identity.gitUserName);
 }
-/** 某天 daySummary 是否承载真实数据（用于优先选中有数据的那份 bundle，而非占位空天）。 */
-function dayHasData(day) {
-    return day.sampleCount > 0 || day.userMessageCount > 0 || day.apiRequestCount > 0;
+/**
+ * 某天 daySummary 的数据质量等级（越高越优先）：
+ * 2 = 有 transcript 数据（userMessageCount / apiRequestCount > 0）
+ * 1 = 仅有 statusline 采样（sampleCount > 0，但 transcript 字段全为 0）
+ * 0 = 全空占位天
+ *
+ * transcript 级别优先于纯 sampleCount 级别，避免只有采样事件但无消息数的 bundle
+ * 抢走有真实 transcript 数据的 bundle 的 winner 位置。
+ */
+function dayDataTier(day) {
+    if (day.userMessageCount > 0 || day.apiRequestCount > 0)
+        return 2;
+    if (day.sampleCount > 0)
+        return 1;
+    return 0;
 }
-/** winner 比较：有数据优先，其次 generatedAt 较新，最后用 filePath 做稳定 tie-break。 */
-function isBetterCandidate(nextHasData, nextGeneratedAt, nextFilePath, currentHasData, currentGeneratedAt, currentFilePath) {
-    if (nextHasData !== currentHasData) {
-        return nextHasData;
+/** winner 比较：数据质量等级高优先，同级别内 generatedAt 较新优先，最后用 filePath 做稳定 tie-break。 */
+function isBetterCandidate(nextTier, nextGeneratedAt, nextFilePath, currentTier, currentGeneratedAt, currentFilePath) {
+    if (nextTier !== currentTier) {
+        return nextTier > currentTier;
     }
     if (nextGeneratedAt !== currentGeneratedAt) {
         return nextGeneratedAt > currentGeneratedAt;
@@ -145,7 +157,7 @@ function selectDailyWinners(bundles) {
         for (const day of bundle.dailySummaries) {
             const key = `${personKey}|${day.date}`;
             const current = winners.get(key);
-            if (!current || isBetterCandidate(dayHasData(day), generatedAt, filePath, dayHasData(current.day), current.generatedAt, current.filePath)) {
+            if (!current || isBetterCandidate(dayDataTier(day), generatedAt, filePath, dayDataTier(current.day), current.generatedAt, current.filePath)) {
                 winners.set(key, { personKey, date: day.date, day, bundle, generatedAt, filePath });
             }
         }

package/dist/lib/claude.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.summarizeClaudeProjectUsage = summarizeClaudeProjectUsage;
+exports.findActiveSessionFiles = findActiveSessionFiles;
 exports.summarizeClaudeProjectUsageByDay = summarizeClaudeProjectUsageByDay;
 const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -142,6 +143,49 @@ async function summarizeClaudeProjectUsage(start, end) {
     }
     return totals;
 }
+/**
+ * 找出 ~/.claude/projects 中在指定时间范围内有活动的 session 文件，返回文件路径及结构信息。
+ *
+ * 只判断文件里是否存在范围内的记录，不过滤内容，导出时完整复制原始文件。
+ */
+async function findActiveSessionFiles(start, end) {
+    const claudeDataDir = (0, paths_1.getClaudeDataDir)();
+    const projectsDir = node_path_1.default.join(claudeDataDir, "projects");
+    const files = await collectProjectJsonlFiles(projectsDir);
+    const result = [];
+    for (const filePath of files) {
+        try {
+            const content = await promises_1.default.readFile(filePath, "utf8");
+            const lines = content.split(/\r?\n/).map((l) => l.trim()).filter((l) => l.length > 0);
+            let hasInRange = false;
+            for (const line of lines) {
+                try {
+                    const record = JSON.parse(line);
+                    if (!isRecord(record))
+                        continue;
+                    if (timestampInRange(getString(record.timestamp), start, end)) {
+                        hasInRange = true;
+                        break;
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+            if (hasInRange) {
+                result.push({
+                    filePath,
+                    projectDir: node_path_1.default.relative(projectsDir, node_path_1.default.dirname(filePath)),
+                    sessionId: node_path_1.default.basename(filePath, ".jsonl"),
+                });
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return result;
+}
 /**
  * 按天汇总 Claude project transcript 中的消息数、请求数和 token 用量。
  */

package/dist/lib/zip.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildZipBuffer = buildZipBuffer;
+const node_zlib_1 = __importDefault(require("node:zlib"));
+const node_util_1 = require("node:util");
+const deflateRawAsync = (0, node_util_1.promisify)(node_zlib_1.default.deflateRaw);
+function crc32(buf) {
+    const table = new Uint32Array(256);
+    for (let i = 0; i < 256; i++) {
+        let c = i;
+        for (let j = 0; j < 8; j++)
+            c = c & 1 ? (0xedb88320 ^ (c >>> 1)) : c >>> 1;
+        table[i] = c;
+    }
+    let crc = 0xffffffff;
+    for (let i = 0; i < buf.length; i++)
+        crc = (crc >>> 8) ^ table[(crc ^ buf[i]) & 0xff];
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/**
+ * 把一组内存文件打包成合法的 ZIP 格式 Buffer。
+ *
+ * 使用 deflate 压缩，文件名按 UTF-8 编码（flags bit 11 置位），不写时间戳。
+ * 只依赖 Node.js 内置的 zlib，无外部依赖。
+ */
+async function buildZipBuffer(entries) {
+    const locals = [];
+    const centrals = [];
+    let offset = 0;
+    for (const entry of entries) {
+        const name = Buffer.from(entry.name, "utf8");
+        const crc = crc32(entry.data);
+        const uncompressedSize = entry.data.length;
+        const compressed = await deflateRawAsync(entry.data);
+        const compressedSize = compressed.length;
+        const local = Buffer.alloc(30 + name.length);
+        local.writeUInt32LE(0x04034b50, 0); // local file header signature
+        local.writeUInt16LE(20, 4); // version needed
+        local.writeUInt16LE(0x0800, 6); // general purpose bit flag: UTF-8
+        local.writeUInt16LE(8, 8); // compression method: deflate
+        local.writeUInt16LE(0, 10); // last mod time
+        local.writeUInt16LE(0, 12); // last mod date
+        local.writeUInt32LE(crc, 14);
+        local.writeUInt32LE(compressedSize, 18);
+        local.writeUInt32LE(uncompressedSize, 22);
+        local.writeUInt16LE(name.length, 26);
+        local.writeUInt16LE(0, 28); // extra field length
+        name.copy(local, 30);
+        const central = Buffer.alloc(46 + name.length);
+        central.writeUInt32LE(0x02014b50, 0); // central directory signature
+        central.writeUInt16LE(20, 4); // version made by
+        central.writeUInt16LE(20, 6); // version needed
+        central.writeUInt16LE(0x0800, 8); // general purpose bit flag: UTF-8
+        central.writeUInt16LE(8, 10); // compression method: deflate
+        central.writeUInt16LE(0, 12); // last mod time
+        central.writeUInt16LE(0, 14); // last mod date
+        central.writeUInt32LE(crc, 16);
+        central.writeUInt32LE(compressedSize, 20);
+        central.writeUInt32LE(uncompressedSize, 24);
+        central.writeUInt16LE(name.length, 28);
+        central.writeUInt16LE(0, 30); // extra field length
+        central.writeUInt16LE(0, 32); // file comment length
+        central.writeUInt16LE(0, 34); // disk number start
+        central.writeUInt16LE(0, 36); // internal file attributes
+        central.writeUInt32LE(0, 38); // external file attributes
+        central.writeUInt32LE(offset, 42); // relative offset of local header
+        name.copy(central, 46);
+        locals.push(local, compressed);
+        centrals.push(central);
+        offset += local.length + compressedSize;
+    }
+    const centralSize = centrals.reduce((sum, c) => sum + c.length, 0);
+    const eocd = Buffer.alloc(22);
+    eocd.writeUInt32LE(0x06054b50, 0); // end of central dir signature
+    eocd.writeUInt16LE(0, 4); // disk number
+    eocd.writeUInt16LE(0, 6); // disk with central dir
+    eocd.writeUInt16LE(entries.length, 8);
+    eocd.writeUInt16LE(entries.length, 10);
+    eocd.writeUInt32LE(centralSize, 12);
+    eocd.writeUInt32LE(offset, 16);
+    eocd.writeUInt16LE(0, 20); // zip file comment length
+    return Buffer.concat([...locals, ...centrals, eocd]);
+}
+//# sourceMappingURL=zip.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccus-cli",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Claude Code statusline usage logger and dashboard CLI",
   "type": "commonjs",
   "bin": {