fix(analytics): un-binary usage-ledger.js — escape the NUL separator

[oratis]

问题

server/usage-ledger.js 里有 2 个裸字节 0x00 直接写在源码文本中，而不是转义序列 \u0000。位置：summarize() 中复合键的注释，以及 cellKey 模板字符串。

分隔符的选择本身没问题 —— NUL 不可能与 YYYY-MM 月份或任何 agent_id 冲突。错的只是编码方式。

但因为 NUL 落在文件前 8000 字节内，git 把整个文件判成二进制，后果有两层：

第一层：从 review 里消失

命令	修复前
git diff	Bin 9679 -> 10779 bytes
git blame	完全失效
file	data，而非 UTF-8 文本

这是 #17 带进来的，而它能活到 merge，恰恰是因为文件不可 diff。

第二层：文件无法合并（本 PR 过程中现场撞到）

本分支第一版基于 #21 时的 main，而 #23 在 main 上也改了这个文件。GitHub 直接报 CONFLICTING —— git 对二进制文件没有三方合并策略，任何并发修改都是死锁。已 rebase 到当前 main，冲突按「取 main 版本 + 重新施加同一处转义」解决。

改动

两处裸 0x00 替换为 \u0000 转义。运行时行为零变化 —— 模板字面量里的 \u0000 求值仍是 U+0000，getWorkspaceUsage / getPlatformUsage 的分组结果逐字节一致。

验证

检查	结果
文件 NUL 计数	0
file server/usage-ledger.js	Unicode text, UTF-8 text（原 data）
npm test	678/678 通过
usage-ledger.test.js 单跑	29/29 通过
全仓受跟踪文件扫描	仅此一个文件受影响
CI	全绿

除既有测试外，额外做了一次对抗性分组检查：agent_id 07-x 在 - 分隔符下会与 2026-08-07 + x 撞键，改用 NUL 分隔后仍正确分桶（同月同 agent 合并、不同 agent 分离、总计正确）。

Reviewer 请注意

本 PR 的 diff 在 GitHub 上仍会显示为二进制。 这不是修复失败 —— git 只要 diff 任意一侧是二进制就走二进制路径，而旧 blob 确实含 NUL。把两侧分开检测就清楚了：

新内容（空 -> 文件）:  1 file changed, 258 insertions(+)   ← 文本
旧内容（HEAD）:        Bin 0 -> 9679 bytes                 ← 二进制

想看真实 diff 用 git diff --text，只有两行变化。合并之后该文件的 git diff / git blame 恢复正常。

配套的 #29 加了 .gitattributes，让这类 diff 即使跨 NUL blob 也强制按文本渲染（已实测对本 PR 的 blob 有效：Bin 9679 -> 9689 bytes → 4 ++--）。两个 PR 互相独立，但 #29 先合的话，本 PR 的 diff 就直接可读了。

🤖 Generated with Claude Code

[oratis]

Superseded by #30, which applies the same two-byte fix on current main.

This branch was cut before #23 landed, so merging it as-is would have reverted that PR's documentation block on server/usage-ledger.js — the file-level diff looked clean only because git was still treating the file as binary.

The find itself was right and the write-up was the useful part: the reason nobody caught the raw NUL in #17 is the bug itself, since an undiffable file gives review nothing to look at. #29 turns that into a systemic guard (.gitattributes forces textual diffs), which is the half a one-file fix can't cover. Thanks — both merged.