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.
This commit is contained in:
@@ -8,6 +8,10 @@ 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
|
||||
|
||||
Reference in New Issue
Block a user