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