The Linux and Windows tabs of the landing-page quick example used
trailing comments (`# ...`) on each line that ended with a line-
continuation character (\` for bash/zsh, backtick for PowerShell).
The shell parser consumes the continuation as part of the comment, so
each example broke into multiple top-level commands — vizb got an
empty-string file arg and the rest became `command not found` errors.

Move the descriptions to a single comment block at the top of each tab
so the continuations only ever sit at the end of real command lines.
Add a short note inside each block explaining the gotcha so future
edits don't regress it.

Keep the bash/PowerShell command lines as bare commands — no inline
comments that could collide with the line-continuation characters
(` for bash/zsh, backtick for PowerShell). Describe the flags once
in a bullet list above the OS tabs, and let each tab show only the
shell-specific command. The Linux/macOS bash tab remains the first
and default-selected tab.

The example is more than a generic '3D interactive chart' — the
z/Month/x/Date pattern with `vizb bar` produces a stacked 3D bar
chart where each year is a layer and each day is a column. That
matches the 'GitHub contribution skyline' framing, so say so
explicitly in the intro and hint at the year/day structure.

Rewrite the README intro around CSV/JSON tables with benchmark support
as a secondary capability. Fix 5D→4D framing, rename assests/ to assets/,
and streamline doc links. Add a troubleshooting page, collapse advanced
grouping examples, and ship contributor onboarding (CONTRIBUTING, CoC,
SECURITY, issue templates).

- Remove deprecated scale input (BREAKING; use chart input instead)
- Add select, json-path, stat, chart, and enable-3d inputs
- Update cmd, group, charts, parser, tag-axis, data-url descriptions
- Deprecate sort and show-labels inputs in action descriptions
- Add vizb-binary input to install a pre-built binary, skipping release download
- Merge install/download step with bash-level vizb-binary guard
- Update act tests to build and use local vizb binary
- Ensure act test tasks depend on build:cli

- Add warnDeprecatedRootFlags() in cmd/root.go; called at start of runBenchmark
- Print stderr warning recommending --chart equivalent
- Add resetChanged() helper in cmd/testing.go to clear pflag Changed state
- Add tests for sort/show-labels deprecation warnings and no-warning cases
- Update TestRunBenchmarkGlobalSortApplied to capture stderr

…ions

- Rewrite GitHub Action inputs table: remove scale, add select/json-path/stat/chart/enable-3d/vizb-binary, mark sort/show-labels deprecated
- Add examples for CSV select, JSON path, chart overrides, stats, 3D, and testing local builds
- Update data-url Aside and description to reflect vizb JSON scope
- Update root command flags table: remove scale, deprecate sort/show-labels, update log-scale example
- Add [Unreleased] changelog entry with additions, removals, and deprecations

…izb action

- AutoValueColumns helper picks first 2-3 all-numeric cols as value axes
- CSV/JSON parsers integrate auto-value when auto-group fails (all-numeric)
- deriveAxesFromData detects value mode (empty Stats) -> Axis.Type:value
- --axes flag removed from scatter cmd; hybrid mode deleted
- IsHybridMode/HybridAxes/ParseAxesFlag deleted
- parseCSVHybridMode/parseJSONHybridMode deleted
- Swap validation moved from scatter Run to pipeline after assembly
- SwapString() added to ChartConfig interface + all 6 configs
- Full test suite green (27 packages)

…ad code (UI)

Part A (Go):
- Add ChartTypes []string field to parser.Config
- Populate ChartTypes from chart configs in pipeline
- Add AutoValueEligible helper (scatter/bar/line only)
- Gate auto-value-mode in csv/json parsers with AutoValueEligible
- Tests: unit tests for AutoValueEligible + integration tests

Part B (UI):
- Delete isHybridMode, buildHybridScatterChart, hybridZStatType
- Remove hybrid mode detection/state/branches from worker
- Remove __hybrid_mode__ skeleton slot from pipeline
- Clean up imports, comments, tests
- 322/322 UI tests pass, all Go tests pass

Auto-value mode (all-numeric CSV/JSON):
- Infer first 2–3 numeric columns as x/y[/z] value axes without --axes
- Respect --select when narrowing which columns participate in auto-detect
- Auto-enable --3d on bar/line/scatter when three value axes are present
- Add noise-grid and noise-surface example datasets for 3D value charts

Parser simplification:
- Extract FinalizeGroupConfig and AutoDetectTabularConfig into group_spec.go
- Replace nested if/else in csv/json parsers with early-return helpers
- Drop WantsBothXY: auto-group always picks a single categorical x column
- Flatten chart-column resolution (default then override) and nil-safe label maps

UI 3D improvements:
- Centralize 3D box sizing, band fill, and camera distance in shared/3d.ts
- Add continuous value-mode 3D builders for bar3D, line3D, and scatter3D
- Remove hybrid mode dead code; unify value-mode line/scatter symbol defaults
- Regenerate embedded UI template

Docs:
- Document auto-value mode; remove --axes and hybrid scatter references
- Update bar, line, scatter, 3d, grouping, and UI guides accordingly

Parse optional 4th numeric column as metric in CSV/JSON parsers and
append a metric axis in the CLI pipeline. Auto-enable 3D scatter and
visualMap when metric data is present.

Apply visualMap symbolSize and colorAlpha only when series points carry
a metric dimension; preserve category-grouped 3D behavior otherwise.
Consolidate 4-tuple transforms and pipeline flag helpers.

Update deploy example workflows, docs, and add noise-grid CSV example.

Add targeted Go tests for AutoDetectTabularConfig orchestration,
pipeline auto-3D/metric paths, csv/json value-mode fatal branches,
SwapString helpers, and metric axis swap identity.

Rename ci.yml to cli.yml with lint → format → test → build gates
for Go (golangci-lint, gofmt, tests + Codecov, binary build). Add
ui.yml with the same pipeline for Vue (typecheck, prettier, vitest,
embed build + vizb-ui.gen.go sync). Fix pre-existing errcheck lint
findings so the new lint layer passes on main.

Run gofmt inside embed-ui after codegen so task build:ui and CI compare
formatted output directly. Drop the redundant gofmt step from build:ui
and normalize both sides in the UI workflow gen.go sync check.

Run UI workflow on pushes to any branch (not only main) when ui/,
vizb-ui.gen.go, or ui.yml change. Omit Taskfile.yml from path filters.

readdir order differs across filesystems, so VizbChunks entry order
changed between local builds and ubuntu-slim CI even when chunk content
was identical. Sort chunk files and emitted map keys/refs in embed
codegen, then regenerate vizb-ui.gen.go.

Node zlib can gzip identical JS to different base64 across versions,
so byte-diffing vizb-ui.gen.go failed on ubuntu-slim even when chunk
payloads matched. Compare gunzipped chunk sources plus import graph,
chart roots, entry key, and HTML template instead. Keep sorted map
emission for stable formatting.