docs: add CLAUDE.md, experiment configs, and parser test suite

Author: vanboompow

.experiments/log.jsonl

@@ -0,0 +1,5 @@
+{"id":"exp-msgvault-20260313-122433-01","brief":"search-perf.md","hypothesis":"Pre-compiling the regexp in parseRelativeDate as a package-level variable eliminates repeated regexp.MustCompile overhead on every call, reducing ns/op for relative-date and complex query benchmarks.","files_changed":["internal/search/parser.go"],"metric_before":{"pass_rate":1,"bench_search_ns_per_op":80.16,"coverage":99.2,"test_count":95},"metric_after":{"pass_rate":1,"bench_search_ns_per_op":78.71,"coverage":99.2,"test_count":95},"kept":true,"status":"success","duration_s":92,"token_cost_usd":0.03,"timestamp":"2026-03-13T12:26:05Z"}
+{"id":"exp-msgvault-20260313-122605-02","brief":"search-perf.md","hypothesis":"Using a package-level defaultParser in the Parse convenience function eliminates the &Parser{} struct allocation and closure allocation on every call to Parse, reducing ns/op uniformly across all benchmarks since every benchmark uses the Parse convenience function.","files_changed":["internal/search/parser.go"],"metric_before":{"pass_rate":1,"bench_search_ns_per_op":78.71,"coverage":99.2,"test_count":95},"metric_after":{"pass_rate":1,"bench_search_ns_per_op":85.30,"coverage":99.2,"test_count":95},"kept":false,"status":"success","duration_s":142,"token_cost_usd":0.03,"timestamp":"2026-03-13T12:28:27Z"}
+{"id":"exp-msgvault-20260313-122827-03","brief":"search-perf.md","hypothesis":"Agent timeout or crash","files_changed":[],"metric_before":{"pass_rate":1,"bench_search_ns_per_op":78.71,"coverage":99.2,"test_count":95},"metric_after":{},"kept":false,"status":"error","duration_s":600,"token_cost_usd":0,"timestamp":"2026-03-13T12:38:27Z"}
+{"id":"exp-msgvault-20260313-123827-04","brief":"search-perf.md","hypothesis":"Agent timeout or crash","files_changed":[],"metric_before":{"pass_rate":1,"bench_search_ns_per_op":78.71,"coverage":99.2,"test_count":95},"metric_after":{},"kept":false,"status":"error","duration_s":600,"token_cost_usd":0,"timestamp":"2026-03-13T12:48:27Z"}
+{"id":"exp-msgvault-20260313-124827-05","brief":"search-perf.md","hypothesis":"Agent timeout or crash","files_changed":[],"metric_before":{"pass_rate":1,"bench_search_ns_per_op":78.71,"coverage":99.2,"test_count":95},"metric_after":{},"kept":false,"status":"error","duration_s":600,"token_cost_usd":0,"timestamp":"2026-03-13T12:58:27Z"}

CLAUDE.md

@@ -249,3 +249,51 @@ client_secrets = "/path/to/client_secret.json"
 [sync]
 rate_limit_qps = 5
 ```
+
+## Current State (as of 2026-03)
+
+**Status:** Active — recent feature addition (web UI)
+**Last Active:** 2026 (web UI commit most recent)
+**Built:**
+- Full Gmail sync pipeline (full + incremental)
+- MIME parsing with charset detection
+- SQLite store (system of record) + FTS5
+- DuckDB/Parquet analytics engine (~3x faster than SQLite JOINs)
+- Bubble Tea TUI with drill-down navigation
+- React/TypeScript web SPA (Dashboard, Messages, Aggregate, Search, Deletions, Thread, Message detail)
+- Deletion staging + Gmail API execution (trash or permanent)
+- UTF-8 encoding repair tool
+- Pre-commit hooks (fmt + lint)
+
+**Not Yet Built:**
+- App-level encryption at rest (database + attachments)
+
+**Known Issues:**
+-  runs  first — requires  (run  once)
+-  skips frontend if you just need the binary fast
+- Binary requires CGO_ENABLED=1 (go-sqlite3 + go-duckdb are C-linked)
+
+
+## Current State (as of 2026-03)
+
+**Status:** Active - recent feature addition (web UI)
+**Last Active:** 2026 (web UI commit most recent)
+**Built:**
+- Full Gmail sync pipeline (full + incremental)
+- MIME parsing with charset detection
+- SQLite store (system of record) + FTS5
+- DuckDB/Parquet analytics engine (~3000x faster than SQLite JOINs)
+- Bubble Tea TUI with drill-down navigation
+- React/TypeScript web SPA (Dashboard, Messages, Aggregate, Search, Deletions, Thread, Message detail)
+- Deletion staging + Gmail API execution (trash or permanent)
+- UTF-8 encoding repair tool
+- Pre-commit hooks (fmt + lint)
+
+**Not Yet Built:**
+- App-level encryption at rest (database + attachments)
+
+**Known Issues:**
+- build target depends on web-build — requires node_modules (run web-install once before first build)
+- build-go skips frontend if you just need the binary fast
+- Binary requires CGO_ENABLED=1 (go-sqlite3 + go-duckdb are C-linked)
+- client_secret_ryanatquartermint.json is committed — do not leak