Files

T

claude@clouddev1 3ad4affef2 feat(help): distinct help for advanced-mode SQL forms; split list by mode (#36 )

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.

2026-06-22 19:01:27 +00:00

Changelog

All notable, user-facing changes to RDBMS Playground are documented here.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

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.

2.7 KiB Raw Blame History

Changelog

Unreleased

Added

Fixed

0.2.0 - 2026-06-17

Added

Fixed

0.1.0 - 2026-06-15

2.7 KiB

Raw Blame History