merge: maestro/tsk_JKAzHuXvSw7h [tsk_JKAzHuXvSw7h]

test/budget.test.ts

@@ -42,6 +42,46 @@ test('store: setRunUsage 累加成本 + costSummary 聚合', () => {
   s.close();
 });
 
+test('store: usageDetail/costSummary 按 daemon 本地时区分桶（UTC+8 跨日不再偏移一天）', () => {
+  const origTZ = process.env.TZ;
+  process.env.TZ = 'Asia/Shanghai'; // 固定 UTC+8，制造 UTC 日 != 本地日
+  try {
+    const s = new Store(':memory:');
+    const p = s.createProject({ name: 'tz', repoPath: '/tmp/tz-' + Math.random() });
+    const t = s.createTask({ projectId: p.id, title: 'x', complexity: 'easy' });
+
+    // —— 按天分桶：近 2 天内 UTC 18:00 的 run → 本地为次日 02:00，本地日应比 UTC 日晚一天 ——
+    const r1 = s.startRun(t.id, 'executor');
+    s.setRunUsage(r1.id, { input: 1_000_000, output: 0, cacheRead: 0, cacheWrite: 0 }, 'claude-opus-4-8');
+    const base = new Date();
+    base.setUTCDate(base.getUTCDate() - 2);
+    base.setUTCHours(18, 0, 0, 0);
+    const startedAt = base.toISOString();
+    s.db.prepare('UPDATE runs SET started_at = ? WHERE id = ?').run(startedAt, r1.id);
+
+    const utcDay = startedAt.slice(0, 10);
+    const ld = new Date(startedAt);
+    const localDay = `${ld.getFullYear()}-${String(ld.getMonth() + 1).padStart(2, '0')}-${String(ld.getDate()).padStart(2, '0')}`;
+    assert.notEqual(localDay, utcDay, 'UTC+8 下 18:00Z 应跨到本地次日，前提才成立');
+
+    const detail = s.usageDetail('day');
+    assert.ok(detail.series.some((b) => b.bucket === localDay), `应分桶到本地日 ${localDay}`);
+    assert.equal(detail.series.some((b) => b.bucket === utcDay), false, `不应再用 UTC 日 ${utcDay}`);
+
+    // —— 当天窗口：本地今天 02:00（UTC 仍为昨天 18:00）的 run 应计入「今天」 ——
+    const r2 = s.startRun(t.id, 'executor');
+    s.setRunUsage(r2.id, { input: 0, output: 1_000_000, cacheRead: 0, cacheWrite: 0 }, 'claude-opus-4-8'); // $75
+    const today2am = new Date();
+    today2am.setHours(2, 0, 0, 0); // 本地今天 02:00
+    s.db.prepare('UPDATE runs SET started_at = ? WHERE id = ?').run(today2am.toISOString(), r2.id);
+    assert.ok(s.costSummary('day').total >= 75, '本地 00:00–08:00 的 run 应计入今天（旧 UTC 口径会漏算）');
+
+    s.close();
+  } finally {
+    if (origTZ === undefined) delete process.env.TZ; else process.env.TZ = origTZ;
+  }
+});
+
 test('store: enforceBudget 超额 → 暂停项目 + 广播 budget.exceeded', () => {
   const s = new Store(':memory:');
   const p = s.createProject({ name: 'b', repoPath: '/tmp/b-' + Math.random() });