opencode-metrics-plugin 0.3.5 → 0.4.2

package/dist/metrics/upload/uploadManager.js

@@ -353,11 +353,17 @@ function dedupePaths(paths) {
  * 启动清扫暂存目录顶层：崩溃遗留的完整三件套（tar.gz + json + meta.json）
  * 移入 failed/ 同构目录并入队重传；孤立文件与组装目录直接删除。
  *
+ * 两遍扫描：第一遍只处理 .tar.gz（三件套校验 → rescue 或删 tar.gz，并标记
+ * 三个文件名已处理）。字母序下 .json/.meta.json 先于 .tar.gz 迭代，若单遍
+ * 边迭代边删 .json，会在 tar.gz 校验前破坏三件套——完整崩溃遗留包必然被
+ * 误判"不完整"而销毁（曾连续销毁终态包）。第二遍才清理无 tar.gz 对应的
+ * 孤儿 .json/meta 与组装残留。
+ *
  * @param stagingDir    暂存目录
  * @param rescueEnabled 失败保留开关（false 时完整三件套也直接删除，旧行为）
  * @returns             可补偿重传的包列表（顶层遗留部分）
  */
-function sweepStagingDirectory(stagingDir, rescueEnabled) {
+export function sweepStagingDirectory(stagingDir, rescueEnabled) {
     const rescued = [];
     try {
         const entries = fs.readdirSync(stagingDir);
@@ -365,26 +371,31 @@ function sweepStagingDirectory(stagingDir, rescueEnabled) {
         const handled = new Set(["failed"]);
         let removed = 0;
         const removedNames = [];
+        // 第一遍：.tar.gz 三件套判定（必须先于 .json 清理，见函数注释）
         for (const entry of entries) {
             if (handled.has(entry))
                 continue;
-            if (entry.endsWith(".tar.gz")) {
-                const base = entry.slice(0, -".tar.gz".length);
-                const pkg = rescueEnabled ? loadIntactPackage(stagingDir, base, names) : undefined;
-                if (pkg) {
-                    movePackageIntoFailed(stagingDir, pkg, path.join(stagingDir, `${base}.meta.json`));
-                    rescued.push(pkg);
-                }
-                else {
-                    fs.rmSync(path.join(stagingDir, entry), { force: true });
-                    removed++;
-                    removedNames.push(entry);
-                }
-                handled.add(entry);
-                handled.add(`${base}.json`);
-                handled.add(`${base}.meta.json`);
+            if (!entry.endsWith(".tar.gz"))
                 continue;
+            const base = entry.slice(0, -".tar.gz".length);
+            const pkg = rescueEnabled ? loadIntactPackage(stagingDir, base, names) : undefined;
+            if (pkg) {
+                movePackageIntoFailed(stagingDir, pkg, path.join(stagingDir, `${base}.meta.json`));
+                rescued.push(pkg);
+            }
+            else {
+                fs.rmSync(path.join(stagingDir, entry), { force: true });
+                removed++;
+                removedNames.push(entry);
             }
+            handled.add(entry);
+            handled.add(`${base}.json`);
+            handled.add(`${base}.meta.json`);
+        }
+        // 第二遍：清理剩余孤儿（无对应 tar.gz 的快照副本/meta、组装残留目录）
+        for (const entry of entries) {
+            if (handled.has(entry))
+                continue;
             if (entry.endsWith(".json") || entry.startsWith(".assembly-")) {
                 fs.rmSync(path.join(stagingDir, entry), { recursive: true, force: true });
                 removed++;
@@ -560,6 +571,8 @@ function removeQuietly(filePath) {
 // ─── 孤儿快照补传（§13 失败补偿链路） ─────────────────────────────────────────
 /** 已传终态标记目录名（metrics/.sent/<sessionId>） */
 const SENT_MARKER_DIR = ".sent";
+/** 已传标记时效缓冲：快照 mtime 超出标记时间该值仍视为"标记后更新过"需补传 */
+const SENT_NEWER_GRACE_MS = 60_000;
 /**
  * 记录会话终态包已成功上云。
  * 快照原件（metrics/<sessionId>.json）会永久保留为本地记录，
@@ -578,9 +591,23 @@ export function markSessionUploaded(metricsDir, sessionId) {
 export function isSessionUploaded(metricsDir, sessionId) {
     return fs.existsSync(path.join(metricsDir, SENT_MARKER_DIR, sessionId));
 }
+/** 读取已传标记时间戳（内容为上传完成时刻的毫秒值）；无标记/内容非法返回 null */
+function sentTimestamp(metricsDir, sessionId) {
+    try {
+        const content = fs.readFileSync(path.join(metricsDir, SENT_MARKER_DIR, sessionId), "utf-8").trim();
+        const time = Number(content);
+        return Number.isFinite(time) && time > 0 ? time : null;
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * 扫描目录选出孤儿快照候选：mtime 静默 [idleMs, maxAgeMs] 且不在活跃集的快照。
- * 上传成功后快照即被删除，"文件仍在"天然等价于"终态未传出"。
+ * 快照原件永久保留为本地记录，"已传标记"是防重复上传的依据。
+ * 时效判断：标记只证明"标记时刻之前的快照已上云"——会话在中途终态触发
+ * （task 完成/session.deleted）上传后仍可能继续运行并更新快照，因此快照
+ * mtime 晚于标记时间（超出 60s 缓冲）仍视为孤儿，补传最终态。
  *
  * @param metricsDir 快照目录
  * @param idleMs     静默下限（毫秒）
@@ -602,11 +629,14 @@ export async function selectOrphanSnapshots(metricsDir, idleMs, maxAgeMs, isActi
         if (!entry.endsWith(".json"))
             continue;
         const sessionId = entry.slice(0, -".json".length);
-        if (isSessionUploaded(metricsDir, sessionId))
-            continue;
         const filePath = path.join(metricsDir, entry);
         try {
             const stats = await fs.promises.stat(filePath);
+            // 已传标记时效判断：标记只证明"标记时刻之前的快照已上云"，快照 mtime
+            // 晚于标记时间（超出 60s 缓冲）说明会话其后仍更新过，最终态未上云，仍补传
+            const sentAt = sentTimestamp(metricsDir, sessionId);
+            if (sentAt !== null && stats.mtimeMs <= sentAt + SENT_NEWER_GRACE_MS)
+                continue;
             const age = now - stats.mtimeMs;
             if (age < idleMs || age > maxAgeMs)
                 continue;

package/dist/plugin.js

@@ -23,6 +23,7 @@ export const MetricsPlugin = async (input, options) => {
         eventsDir: runtime.dirs.eventsDir,
         enabled: config.enabled !== false,
         upload: Boolean(runtime.uploadManager),
+        agents: runtime.sessionFilter.active ? config.agents : null,
         configSource: source,
     });
     const hooks = {
@@ -31,11 +32,13 @@ export const MetricsPlugin = async (input, options) => {
                 event: event,
             });
         },
-        // 记录各模型 system prompt（只读不改写、不返回；子代理跳过）
+        // 记录各模型 system prompt（只读不改写、不返回；子代理跳过；agents 过滤外的会话跳过）
         "experimental.chat.system.transform": async (input, output) => {
             const sessionId = input.sessionID;
             if (!sessionId)
                 return;
+            if (!runtime.sessionFilter.shouldTrackSession(sessionId))
+                return;
             if (runtime.eventLogger?.isSubAgent(sessionId))
                 return;
             const modelId = input.model?.id ?? "unknown";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-metrics-plugin",
-  "version": "0.3.5",
+  "version": "0.4.2",
   "description": "opencode plugin: auto-records every session's metrics (tokens/rounds/steps/sub-agents/hvigor builds) to snapshot JSON. Zero DB, zero config. Pair with session-viewer for visualization.",
   "type": "module",
   "license": "MIT",