daedalus 0.4.0: bash script interface (help() dispatch) + hello_bash

- bash/daedalus_common.sh (new): the shared interface for bash scripts
  (SPEC item 6.10) - a script sources its sibling helper, defines help()
  (usage) and main(), and ends with daedalus_bash_dispatch "$@" which
  routes help/-h/--help to help() and everything else to main()
  unchanged (clear fallback errors when a script forgets either)
- completion for bash scripts (SPEC item 3.13.5.2): after a completed
  script name daedalus offers --help, -h, help, prefix-filtered, written
  itself on the fd-8 argcomplete protocol - no script runs on TAB;
  scripts without the interface get the shell default
- bash/hello_bash.sh (new, category test): sample script through the
  interface, the bash twin of hello, with tests; registry entry, README
  row, CHANGELOG bullet
- tests: bash/tests/test_bash_interface.py (helper behavior, bash -n,
  enforcement of the interface for every registered .sh),
  test_hello_bash.py (direct and daedalus runs, help routing, SPEC 3.1
  pass-through, completion probes including the user's
  daedalus hello_bash<TAB><TAB> case), completions units + e2e harness
- README/INSTALL/SPEC updated (6.10, 3.13.5.2, tree, boilerplate with
  shellcheck directive); autotest green (212 tests)

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
This commit is contained in:
2026-11-18 22:35:11 +01:00
parent c210e17661
commit ec9848b169
14 changed files with 433 additions and 20 deletions
+19
View File
@@ -10,6 +10,25 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
- Nothing yet.
## [0.4.0] - 2026-11-18
### Added in 0.4.0
- `bash/daedalus_common.sh`: the shared interface for bash scripts (SPEC
item 6.10) — a script sources its sibling helper, defines `help()`
(usage) and `main()`, and ends with `daedalus_bash_dispatch "$@"`,
which routes `help` / `-h` / `--help` to `help()` and everything else
to `main()` unchanged.
- Bash script completion (SPEC item 3.13.5.2): `daedalus <name> <TAB>`
completes `--help`, `-h`, and `help` for scripts implementing the
interface; no script runs on TAB. Scripts without the interface get
the shell default.
- `bash/hello_bash.sh`: sample bash script (category `test`) through the
shared interface, the bash twin of `hello`, with tests.
- `bash/tests/`: the interface tests — helper behavior through a
sample script and enforcement of the interface for every registered
`.sh` script.
## [0.3.0] - 2026-11-18
### Added in 0.3.0