TelemetryĐo lường
Telemetry is the harness writing down what it did, so you can audit it later. It is deliberately modest: it records whether the machinery ran — which skills fired, whether a gate blocked, who acted — and it ends every report by naming what it cannot tell you. It never claims to measure whether the product is any good.Telemetry là việc harness ghi lại cái nó đã làm, để bạn audit sau. Nó cố tình khiêm tốn: ghi máy móc có chạy không — skill nào nổ, gate có chặn không, ai thao tác — và kết mỗi báo cáo bằng việc nêu cái nó không nói được. Nó không bao giờ tự nhận đo được sản phẩm có tốt hay không.
Two books, two lawsHai sổ, hai luật
Trace — the audit bookTrace — sổ audit
state/trace/trace-YYYYMMDD.jsonl records gate / approval / decision events and never rotates. In v3 each record is linked to the one before it by a chain_hash (a fingerprint of the previous record), so a deleted or altered line shows up as a broken chain. verify_trace_chain.py checks it.state/trace/trace-YYYYMMDD.jsonl ghi sự kiện gate / approval / quyết định và không xoay vòng. Ở v3 mỗi bản ghi nối với bản trước bằng chain_hash (dấu vân của bản trước), nên một dòng bị xoá hay sửa lộ ra dưới dạng chuỗi gãy. verify_trace_chain.py kiểm.
Telemetry — the usage bookTelemetry — sổ usage
state/telemetry/*.jsonl records counts, session shape, and outcomes across five sinks, and rotates at 8 MB so it never grows without bound. Both books stamp every record with an actor and a timestamp.state/telemetry/*.jsonl ghi đếm, hình phiên, và kết cục qua năm sink, và xoay ở 8 MB nên không phình vô hạn. Cả hai sổ đóng dấu mỗi bản ghi một actor và mốc thời gian.
Read it yourselfTự đọc
Everything is on the filesystem — no dashboard, no server. analyze_telemetry.py --lens all renders the read-only lenses. The workflow lens compares the skills a session declared against what actually ran; a perf-trend lens surfaces load/latency regressions as advisory (never a hard gate). Every report carries a mandatory ## NOT measured block so a partial read can never look like full coverage.Mọi thứ trên filesystem — không dashboard, không server. analyze_telemetry.py --lens all render các lens chỉ-đọc. Lens workflow so skill một phiên khai báo với cái thực sự chạy; lens perf-trend nêu hồi quy tải/độ-trễ dạng tư vấn (không bao giờ gate cứng). Mỗi báo cáo có khối bắt buộc ## NOT measured để một lần đọc một phần không bao giờ trông như phủ đủ.
What it will not pretend to knowCái nó không giả vờ biết
- token / dollar cost per skill or session — not attributedtoken / $ mỗi skill hay phiên — không quy được
- semantic correctness or quality — only "ran" / a coarse exit codeđúng-sai ngữ nghĩa hay chất lượng — chỉ "ran" / mã thoát thô
- human-review depth or plan-approval qualityđộ sâu review của người hay chất lượng plan-approval
- market or user outcome — usage is not effectivenesskết quả thị trường hay người dùng — mức dùng không phải hiệu quả
HARNESS_TELEMETRY_DISABLED=1. state/ is always gitignored and never enters git, and there is no network call in the gate path — telemetry stays on your disk.Tắt bằng một công tắc. Mọi quan sát dừng với HARNESS_TELEMETRY_DISABLED=1. state/ luôn gitignore và không bao giờ vào git, và không có network call ở đường gate — telemetry ở lại đĩa của bạn.