The six advanced SQL DML/query forms (SELECT, WITH, SQL_INSERT, SQL_UPDATE, SQL_DELETE, EXPLAIN_SQL) carried help_id: None, so `help select`/`help with` resolved to nothing and `help insert` showed only the simple form. Give each its own distinct help_id (data.select, data.sql_insert, …) with a hand-curated help.data.* page. Distinct strings keep the dedup invariant intact, and note_help_topic needs no change — `help insert` now shows the simple block and the sql_insert block (like `help create` already did), and the advanced-only forms resolve. note_help now groups the list by CommandCategory: app-lifecycle commands first (unlabelled), then "Simple-mode commands:" and "Advanced-mode (SQL) commands:" sections — replacing the old single "DSL data commands (in simple mode):" header, which used the banned "DSL" term and mis-labelled the advanced SQL forms it already contained. Four new help_command tests (red→green). Recorded as ADR-0024 Amendment 1; CHANGELOG updated.
61 lines
2.7 KiB
Markdown
61 lines
2.7 KiB
Markdown
# Changelog
|
|
|
|
All notable, user-facing changes to RDBMS Playground are documented here.
|
|
|
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0/).
|
|
|
|
## [Unreleased]
|
|
|
|
### Added
|
|
- `help` now covers the advanced-mode SQL commands: `help select`, `help with`,
|
|
and the SQL forms of `insert` / `update` / `delete` / `explain` show their own
|
|
syntax, and the full command list is grouped into "Simple-mode commands" and
|
|
"Advanced-mode (SQL) commands" sections.
|
|
- Install via **Scoop**, **Homebrew**, and **winget** in addition to the
|
|
existing channels.
|
|
- Tier-4 end-to-end test suite that exercises the real application in a
|
|
terminal (cold launch, save/reopen, export/import, undo) — guards against
|
|
regressions the unit and render tests can't see.
|
|
- Automated colour-accessibility checks: every theme now has its
|
|
foreground/background contrast and its syntax-colour distinctness verified
|
|
on each build.
|
|
|
|
### Fixed
|
|
- Pasting or scripting several commands at once no longer occasionally
|
|
rejects a valid simple-mode `insert` — submitted right after adding a
|
|
column — as though it were advanced-mode SQL.
|
|
- **Light theme:** string-literal and flag colours in syntax highlighting
|
|
were below the WCAG-AA contrast bar; both are now legible. Two dark-theme
|
|
token colours that were hard to tell apart have been separated.
|
|
- Windows `install.ps1` now works on the in-box Windows PowerShell 5.1 and
|
|
updates `PATH` for the current session.
|
|
|
|
## [0.2.0] - 2026-06-17
|
|
|
|
### Added
|
|
- **Version surfaces:** a `--version` / `-V` command-line flag and an in-app
|
|
`version` command, both reporting the build's exact version.
|
|
- **Installation options:** publish to crates.io (`cargo install
|
|
rdbms-playground`), `cargo binstall` support, a one-line `curl | sh`
|
|
installer, and a Windows `install.ps1` — so you no longer have to hand-pick
|
|
a release asset.
|
|
- **Documentation & landing site** at <https://relplay.org> — the canonical
|
|
user guide plus screencast demos.
|
|
- A demonstration-mode key alias (Ctrl-G acting as F1) so screencasts can
|
|
show the in-app help/hint key.
|
|
|
|
### Fixed
|
|
- Corrected several errors in the contextual-hint help text.
|
|
|
|
## [0.1.0] - 2026-06-15
|
|
|
|
First public release: the cross-platform terminal sandbox for learning
|
|
relational-database concepts — tables, keys, relationships, indexes, queries
|
|
and query plans — in a guided simple mode or a full advanced (SQL) mode, with
|
|
projects, undo, and export/import.
|
|
|
|
[Unreleased]: https://git.lazyeval.net/oli/rdbms-playground/compare/v0.2.0...HEAD
|
|
[0.2.0]: https://git.lazyeval.net/oli/rdbms-playground/compare/v0.1.0...v0.2.0
|
|
[0.1.0]: https://git.lazyeval.net/oli/rdbms-playground/releases/tag/v0.1.0
|