Document geocode OpenCage, describegpt JSON Schema & sample VarOpt - Geospatial: new "Online geocoding with OpenCage" section, decision-table rows, updated geocode intro & subcommand count (7 -> 9) - Selection & Inspection: sample VarOpt + mergeable-reservoir + sketch I/O examples, method count 8 -> 10 - AI & Documentation: describegpt --format jsonschema section, x-qsv annotations, --allow-extra-cols / --strict-dates - Command Reference: refreshed sample, geocode & describegpt rows - Environment Variables: QSV_OPENCAGE_API_KEY - Recipes: OpenCage variation in Geographic Enrichment; describegpt JSON Schema variation in JSON Schema Validation Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

jqnatividad committed May 20, 2026

docs(wiki): re-home color and pro to their natural categories color and pro lived on the AI & Documentation page for historical reasons, but neither has any LLM/AI surface — color is just a colorized table renderer, and pro is a desktop-app bridge. Now that synthesize has joined describegpt on the AI page, the mis-categorization stood out more. - AI & Documentation: drop the color and pro sections; trim the decision-table rows and the "color is the colorized cousin..." sentence in the intro; leave a redirect note pointing readers to the new homes - Selection & Inspection: add color right after table (its uncolored cousin); decision-table row; cross-link both directions - Integrations: add a "qsv pro Bridge" section covering the pro subcommands (lens, workflow) - Command Reference: move the color row into Selection & Inspection; add an "Integrations & Bridges" mini-section housing pro - Environment-Variables, Recipe-Inspect-Unknown-CSV, qsv-pro-Spotlight: rewrite stale AI-and-Documentation#color / #pro anchors to point at the new homes Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

jqnatividad committed May 18, 2026

docs(wiki): update for qsv 20.1.0 — "Synthetic Data" release - AI & Documentation: add synthesize section; expand describegpt with Content Types (47-token vocab), --two-pass cross-field refinement, deterministic unique_id tag, --markdown-template, lower-LLM-cost notes - Aggregation & Statistics: document auto-fallback to approximate modes on OOM (stats: --quantile/cardinality-method approx; frequency: --sketch-method frequent_items) with little-endian gating - Recipe-Larger-than-RAM: reframe explicit approx flags as auto-on-OOM (override-to-lock semantics) with stats cache mode-key note - SQL & Polars: pivotp --agg quantile@<p> / q@<p> with p95 example - Command Reference: add synthesize row in AI & Documentation table - Cookbook: new "Generate" section; new Recipe-Synthesize-Fake-Data.md with end-to-end describegpt --two-pass --infer-content-type → synthesize walkthrough, locale switching, --consistent-fakes variant, caveats - Sidebar: link the new Synthesize Fake Data recipe - Home: bump "70+ commands" → "73 commands across four binary variants"; add 20.1.0 highlight strip with deep-links - FAQ: refresh MSRV anchor 20.0.0 → 20.1.0 (Rust 1.95 unchanged) - Troubleshooting: link both 20.0.0 and 20.1.0 changelogs in excel section Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

jqnatividad committed May 18, 2026

wiki: add lint script + example CI workflow scripts/lint.sh runs two checks against the wiki: 1. Every `qsv <command>` reference in a code context (fenced block or inline backtick) is a real command per `qsv --list`. The script merges `qsv --list` with a known feature-gated set (clipboard, prompt, py, lens, color, etc.) so a lite-build qsv still validates the full wiki. 2. When QSV_REPO_PATH points at a checkout of dathere/qsv, every `/docs/help/<X>.md` reference resolves to a real file in that checkout's docs/help/ directory. Exit codes: 0=clean, 1=stale references, 2=setup error. Allowlist files under scripts/lint.allowlist (per-token) and a built-in HELP_ALLOWLIST for template placeholders (cmd1, cmd2, X, etc.). scripts/wiki-lint-workflow.yml is a ready-to-copy GitHub Actions workflow for the MAIN qsv repo. GitHub Actions doesn't run on *.wiki repos, so the workflow file must live there. It runs nightly + on PRs that touch src/cmd/, src/main.rs, or docs/help/, and opens a sticky `wiki-lint` issue on scheduled failure. Also fixes the only real bug the lint caught: Command-Reference linked to a non-existent /docs/help/help.md. Reworded the row to describe `qsv help` without a broken link. Contributing-to-the-Wiki gets a new "Linting" section documenting both the local run and the CI setup. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

jqnatividad committed May 13, 2026

wiki: remove the removed `generate` command + correct command count The `generate` command was removed from qsv but still appeared in Command-Reference under "Generators & Utility". Drop the row and rename the section to "Utility" (now containing just `help`). Also corrects the stale "81 commands" claim used across several pages. README's command catalog currently has 71 entries; the standard `qsv` binary reports 68 from `qsv --list`. Replaced fixed counts with "70+" or "every command" / "every qsv command" where a specific number was not load-bearing, plus a Command-Reference note that the exact set depends on the binary variant and feature flags. Pages touched: Command-Reference, Home, Getting-Started, Why-qsv, Selection-and- Inspection, Comparison. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

jqnatividad committed May 13, 2026

wiki: flesh out Command-Reference index + Selection-and-Inspection Command-Reference is now the canonical index of all 81 commands, grouped by category, with the README legend symbols inline. Every row deep-links to both the wiki category page (workflow context) and /docs/help/<cmd>.md (flag reference). Selection-and-Inspection covers the 12 daily-driver commands with one or two non-trivial real-world examples each, anchored on wcp.csv and NYC 311. Examples verified against /docs/help/ flag tables — no invented flags. 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