docs(stats-cache): document the .stats.csv.json args/version signature file Add the <csv>.stats.csv.json cache-signature file (arguments + qsv version used to build the cache, checked on the next run for invalidation) to the sidecar-files table and the cache layout diagram. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

jqnatividad committed Jun 7, 2026

wiki: Phase D batch 2 - Stats-Cache-and-Caching + Lookup-Tables Stats-Cache-and-Caching: complete cache architecture map. Sidecar file layout (.idx, .stats.csv, .stats.csv.data.jsonl, .freq.csv.data.jsonl, .schema.json, .pschema.json), what each command produces vs consumes, QSV_STATSCACHE_MODE auto/force/none, four HTTP cache backends (memory/ disk/Redis/none), TTLs and refresh-on-hit, cache-busting cheatsheet, CI gotchas (commit .stats.jsonl + .pschema.json, don't commit .idx). Lookup-Tables: file://, http(s)://, dathere://, ckan:// URL schemes. qsv_register_lookup in luau (NTA enrichment example), dynamicEnum in validate (against local/HTTP/CKAN/dathere CSVs), register_lookup in template (MiniJinja form letters). Lookup CSV format requirements, qsv-lookup-tables curated repo pointer, caching and performance notes. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

jqnatividad committed May 13, 2026

wiki: add stubs for Phase B/C/D/E pages so sidebar links resolve Adds 39 placeholder pages so every sidebar entry resolves to real content rather than a 404. Each stub declares its tier, the phase it will be filled in, and a one-paragraph preview of what's coming. They link back to Home / Getting-Started / Command-Reference / Cookbook for navigation. Pages added: - Phase B (Command Reference, 13): Command-Reference, Selection-and- Inspection, Transform-and-Reshape, Aggregation-and-Statistics, Joins- and-Set-Ops, SQL-and-Polars, Validation-and-Schema, Conversion-and-IO, Geospatial, HTTP-and-Web, Scripting-Luau-Python, Indexing-Compression- Diff, AI-and-Documentation - Phase C (Cookbook recipes, 12): Recipe-Inspect-Unknown-CSV, Recipe- Clean-and-Normalize, Recipe-Geographic-Enrichment, Recipe-Date- Enrichment, Recipe-CKAN-Integration, Recipe-JSON-Schema-Validate, Recipe-Build-a-Data-Pipeline, Recipe-Stats-to-Insights, Recipe-Fetch- and-Cache, Recipe-Larger-than-RAM, Recipe-Diff-and-Audit, Recipe-Multi- Table-Joins - Phase D (Tuning + ecosystem, 8): Performance-Tuning, Environment- Variables, Stats-Cache-and-Caching, Lookup-Tables, Claude-Cowork-Plugin, MCP-Server, qsv-pro-Spotlight, Integrations - Phase E (Polish, 6): Troubleshooting, FAQ, Comparison, Glossary, External-Resources, Contributing-to-the-Wiki Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

jqnatividad committed May 13, 2026