docs: consolidate design documentation and standardize crate English

2026-10-12 14:58:00 +09:00
parent a633a53274
commit 4efb0ace1f
404 changed files with 4556 additions and 11654 deletions
@@ -0,0 +1,10 @@
+# session-analytics
+
+`session-analytics` reads Session JSONL and aggregates observations of tool use and
+context changes. It neither runs Workers nor restores history, and reports omit
+message bodies and raw tool arguments/results.
+
+## Design entry points
+
+- [`analyze_session`]: reading and aggregation tolerant of storage-format differences
+- [`SessionReport`]: observation scope and limits on interpretation