wiki: describe the latest release only — drop older-version notes
Removes "new in X", "(X+)", "since X", "fixed in X", "in X and earlier"
notes, "Requires: qsv X+" lines and per-release changelog sections
across 43 pages. Facts a 29.0.0 reader still needs are restated in the
present tense; 29.0.0 breaking changes stay, minus older backstory.
Adds a "Describe the latest release only" convention to
Contributing-to-the-Wiki, with *(unreleased)* for master-only features.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Installation: match the README's installation section
- qsv-client (Python) tip; Tool definitions section
- direct download links for qsv pro, prebuilt ZIPs, Easy Installer and
shell completions (qsv.dathere.com/download itself is a 404)
- PGO / CPU-optimization wording, sudo xattr, Homebrew completions
- cargo install builds the portable baseline, not a CPU-tuned binary
- s390x in the Linux list (ships in 28.0.0)
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Release 25.0.0: replace the Unreleased (after 24.0.0) markers
wiki: note 24.0.0 Apple Silicon non-PGO build and its fix (#4740, #4757, #4795)
wiki: update for 24.0.0 "Evidence Act" release
- Home: 24.0.0 headline, 80 commands, 24.0.0 breaking-changes box
- Flip all "Unreleased (after 23.0.1)" markers to 24.0.0 across ~28 pages
- New: writestat section, readstat --dictionary/--select/--offset/--limit/--sample,
--help --format json|md and --export-tool-definitions, aarch64 musl and
Windows ARM64 gnullvm prebuilts, MSRV 1.99
- Variant counts: qsv 80, qsvpy 81, qsvmcp 70; 57 MCP tools
- frequency/stats fixes and speedups, symlinked moarstats fix, #4603 fixed
- Visualization: "Recent viz changes (24.0.0)"; earlier section retitled 23.0.1
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
wiki: warn that the next release's x86_64 prebuilts require AVX2
Marked Unreleased (after 23.0.1). Adds the x86-64-v3 requirement (#4649),
the qsvdp exemption, the /proc/cpuinfo check and - most urgently - the
warning not to qsv --update on a non-AVX2 CPU, next to the SIGILL text
that is still true for 23.0.1 (Installation, Troubleshooting,
Binary-Variants, FAQ, Performance-Tuning, MCP-Server).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
wiki: fix claims that are wrong for the released 23.0.1
- The 23.0.0 tag and release no longer exist; "Context is King" is 23.0.1,
so every releases/tag/23.0.0 link 404'd. Relabel 23.0.0 -> 23.0.1.
- moarstats count: 55 / 25+ -> 56 (73 on master, marked unreleased).
- moarstats example: `> file` captured 0 bytes (moarstats updates the stats
CSV in place); use -o.
- FAQ: MSRV is 1.98; linux-aarch64 is not built with target-cpu=native.
- Binary-Variants: target-cpu=native also survives on Windows-on-ARM,
ppc64le and s390x, not just Apple Silicon.
- Date recipes: julianday / SQLite-order strftime fail on Polars SQL;
rewritten with STRPTIME/STRFTIME/EXTRACT, verified on 23.0.1 and master.
- Environment-Variables: add the 5 MCP/Cowork vars missing vs docs.
- SQL-and-Polars: an IN subquery was mislabeled "correlated".
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
docs: 23.0.0 breaking changes, retired portable binaries & installer warning
The highest-consequence half of the 23.0.0 catch-up, landed first.
Breaking in 23.0.0 (qsvmcp only): qsvmcp no longer ships `get`, no longer
accepts `dc:` cache-prefix inputs, and no longer reads cloud (s3://, gs://,
az://) sources. Noted on Binary-Variants, MCP-Server and Get-and-Disk-Cache,
each scoped so a `qsv`/`qsvdp` user doesn't think they lost cloud support.
Stale since 22.0.1, not 23.0.0: the "portable" binaries (qsvp, qsvplite,
qsvpdp, qsvpmcp) were dropped a day before the wiki's last update, so three
pages still told users to switch to a binary no release ships. They were
redundant — `-C target-cpu=native` had already been removed from the x86_64
publish targets, so the regular prebuilts are the portable ones. Rewritten as
a retirement note with the measured evidence, and the SIGILL advice on
Installation/Troubleshooting/Performance-Tuning now points at building from
source instead.
That retirement is also why the Windows Easy Installer breaks: v1.1.1 and
earlier extract a hardcoded qsvp.exe and report success anyway. Added the
upgrade-to-v1.1.2-first warning to Installation and Troubleshooting.
Also: the `--output`-truncates-its-own-input data-loss bug (fixed in 23.0.0)
as a Troubleshooting entry, and `get cache-list`'s new age/staleness reporting
with the TTL-driven (not policy-driven) definition of "stale".
Counts re-derived by running `--list` on each freshly built binary rather than
incremented: qsv 78->79, qsvpy 79->80, qsvmcp 69 (68 + readstat, `get` gone),
qsvlite 51, qsvdp 44->43 (was wrong), MCP skills 55->56. Dropped the
`qsv_fetch`/`qsv_fetchpost` tool bullet from MCP-Server — those skills do not
exist and fetch is not in the qsvmcp binary at all.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
docs: catch the wiki up for the 22.0.1 "Data Schematic" release
Wiki was last updated Jul 23, mid-cycle; 22.0.1 shipped Aug 8.
- Home: new 22.0.1 release blurb (was still 21.1.0 "Leaner & Faster")
- Visualization: introduce the Data Schematic as the ARTIFACT `viz smart`
produces (command stays "auto-dashboard", matching viz.rs/FEATURES.md);
new data-viewer-drawer + cross-linking + localized-schematics sections;
dictionary-declared pipeline funnel panel; funnel chart example;
viz shipping/big-endian caveat
- Transform-and-Reshape: new `fixedwidth` section (help declares this page
as its wiki home)
- Indexing-Compression-Diff: new `clean` section (Command-Reference linked
a page with no such section)
- Breaking changes documented: minijinja 2.23 True/False/None rendering,
cached 2->3 sled->redb (incl. the TTL=0 inversion), describegpt prompt
file 8.0.0 -> 9.0.0
- describegpt: document local whatlang content-language auto-detection and
the dual-typed --language flag
- Binary-Variants: per-variant command counts verified against 22.0.1
(qsv 78 / qsvpy 79 / qsvmcp 69 / qsvlite 51 / qsvdp 44)
- MCP-Server: replace "~65 tools" with 69 commands / 55 skill-based tools
Fixes found en route:
- `describegpt --lang` does not exist (rejected by docopt); corrected to
`--language` in 2 places
- 5 broken anchors into "(cross-reference)" headings in Command-Reference
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
docs: catch the wiki up on changes since Jul 12
Audited the wiki against qsv master (~50 non-dependency commits since the
last content update). Most of that window was viz work.
Added:
- Visualization: `splom` + `parcats` subcommands (decision table + examples);
a new "Animation, range & annotation" section for `--slider`,
`--slider-speed`, `--slider-cumulative`, `--rangeslider`, `--y-range` and
`--annotation`; `viz smart` sections for skew-aware encoding (Gini/Lorenz,
log-scale boxes), judicious animated panels, and `--photos` hover imagery;
the `--dict-info` sidecar download row
- Aggregation-and-Statistics: `stats --jsonl` / `--pretty-json` stdout output
- Validation-and-Schema: `validate --split-ragged`, incl. QSV_COMMENT_CHAR
- Installation: the twice-a-month background update check and its opt-out
Fixed stale facts:
- Visualization said the smart downsample cap was 50,000 points in three
places; it is 150,000, which the wiki's own Environment-Variables page
already stated correctly
- FAQ gave the MSRV as 1.96; it is 1.97
- Security-and-Dependencies listed forks qsv no longer patches (`sled`,
`calamine`) and a stale plotly pin, and omitted `self_update`; added a note
on the sled -> redb migration that dropped the forked crate entirely
- Command-Reference's viz chart list was missing 8 subcommands
Every added example was executed against a current build before documenting;
that caught an animated-bar example using a column sales_sample.csv lacks.
docs: update for v21.1.0 release
- Home: new "Leaner & Faster" 21.1.0 release banner (no MSRV/Polars bump)
- get: delimiter sniffing, --sample/--offset/--random preview, glob/dir batch fetch
- diff: --drop-equal-columns
- compression: transparent local+remote auto-decompression; tabular-first zip selection
- conversion: special-format failures now error (QSV_SKIP_FORMAT_CHECK to opt back in)
- describegpt: --context-file, localhost timeout auto-disable
- apply: new summarize subcommand
- safenames: safer s/S modes + --collapse/--unicode
- perf: stats speedups, qsv-tune profiler, PGO-optimized prebuilt binaries
- Binary-Variants: qsvlite no longer bundles describegpt
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
wiki: adopt GitHub Alerts for callouts across the wiki
Convert advisory blockquotes and inline callouts to semantic GitHub
Alerts (NOTE/TIP/IMPORTANT/CAUTION):
- [!NOTE] for the standard category-page "workflow layer" ledes and
other top-of-page orientation / "canonical reference" notes
- [!IMPORTANT] for behavior-affecting gotchas (auto approx-stats on OOM,
group-by unsupported aggs, MiniJinja filter-errors-as-values,
synthesize cross-column correlation, profile always-warn RFC4180)
- [!TIP] for the Binary-Variants TL;DR and Why-qsv "why it matters"
- [!CAUTION] for foreach shell-injection risk and joinp --cross blowup
Also update the Contributing-to-the-Wiki category template to use the
[!NOTE] lede so new pages follow the convention.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
wiki: scaffold tiered IA + Phase A foundation pages
Adds the new wiki information architecture: Home as a discoverability hub
with a "Where things live" table, a tiered sidebar (Beginner/Intermediate/
Advanced), and the 9 foundation pages of Phase A.
- Home rewritten as a hub with three CTAs, tier-grouped page lists, and
pointers to anchor datasets used across the wiki.
- _Sidebar groups pages by Get Started / Command Reference / Cookbook /
Tuning / Ecosystem / Reference / Legacy.
- _Footer adds universal links (Discussions, qsv pro, benchmarks, license).
- Tier-Legend explains the Beginner/Intermediate/Advanced badges.
- Installation covers prebuilt binaries, package managers, cargo install,
source builds, SIGILL/portable variants, MSI installer, self-update, and
signature verification.
- Getting-Started walks through count/headers/stats/sample/search/slice/
flatten/select/sort/table/lens/clipboard/index against wcp.csv (verified
end-to-end against the actual dataset; outputs match qsv 20.0.0).
- Why-qsv is the elevator pitch: speed numbers (with deep-links to
BENCHMARKS.md), composability, batteries-included list, ecosystem.
- Binary-Variants explains qsv vs qsvlite vs qsvdp vs qsvmcp vs qsvpy with
a decision tree.
Plan: /Users/joelnatividad/.claude/plans/the-wiki-is-a-typed-dragon.md
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>