85e8342a74
Every script gets a complete spec.md sectionized like SPEC.md (python/src/<name>/spec.md, <name>.spec.md for shell scripts). Change order becomes spec -> tests -> code. Specs added for gpgtools, hello, hello_bash; CHANGELOG under Unreleased. Generated by Mistral Vibe. Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
141 lines
5.9 KiB
Markdown
141 lines
5.9 KiB
Markdown
# Changelog
|
|
|
|
Notable changes are listed here. Release numbers match
|
|
[`pyproject.toml`](./pyproject.toml). Newest entries are first.
|
|
|
|
Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
|
|
[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
|
|
## [Unreleased]
|
|
|
|
### Added
|
|
|
|
- Per-script local specs (SPEC items 6.11, 6.12): every script gets a
|
|
spec that completely describes it — `spec.md` in a Python script's
|
|
folder, `<name>.spec.md` beside bash/PowerShell/batch scripts — in
|
|
the sectionized format of SPEC.md. Script work is spec first, then
|
|
tests, then code (SPEC item 6.12). First specs added:
|
|
`gpgtools`, `hello`, `hello_bash`.
|
|
|
|
## [0.6.0] - 2026-11-18
|
|
|
|
### Added in 0.6.0
|
|
|
|
- `gpgtools send_pubkey` (guide steps 5-6): resolves an SSH public key
|
|
from one of four sources — `--yubikey` (gpg-agent ssh socket),
|
|
`--url` (armored OpenPGP key, converted with `gpg --export-ssh-key`
|
|
in a throwaway GNUPGHOME), `--fingerprint` (store chain: local
|
|
keyring, keys.openpgp.org VKS, keyserver.ubuntu.com, each
|
|
fingerprint-checked), or `--pubkey` (literal line, format-validated).
|
|
Before anything is stored, proof of possession: a random challenge is
|
|
signed by the private half through the agent (`ssh-keygen -Y sign
|
|
-U`; PIN prompts reach the user) and verified against the candidate
|
|
line (`ssh-keygen -Y verify`). Only then is the line appended to the
|
|
target's `authorized_keys` — idempotent (grep before append), perms
|
|
enforced. `--no-verify` skips the check explicitly; `--dry-run`
|
|
resolves and prints without side effects. 22 new tests.
|
|
|
|
## [0.5.0] - 2026-11-18
|
|
|
|
### Added in 0.5.0
|
|
|
|
- `gpgtools` (Python, category `gpg`): YubiKey GPG/SSH helpers.
|
|
`daedalus gpgtools initialize_yubikey` runs the fresh-machine flow
|
|
(steps 1-4 of the wiki guide): installs gnupg when missing (apt-get,
|
|
dnf, pacman), checks the card, fetches the public key from the card's
|
|
URL field with `gpg --fetch-keys`, and writes the gpg-agent SSH
|
|
config (`enable-ssh-support`, cache TTLs) with the GNUPGHOME
|
|
directory at mode 700. `--dry-run` prints the plan; steps 5-7
|
|
(derive and deploy the SSH key per host) are server-specific and
|
|
intentionally out of scope.
|
|
|
|
## [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
|
|
|
|
- Shell completion via [argcomplete](https://github.com/kislyuk/argcomplete)
|
|
(new dependency): `daedalus hel<TAB>` completes `hello`, category
|
|
labels complete together with the scripts they filter (`daedalus test
|
|
h<TAB>`), options complete after `-`, and `--path <name>` completes
|
|
script names. Activate with
|
|
`eval "$(register-python-argcomplete daedalus)"` (INSTALL.md).
|
|
- Script arguments complete from the script's own parser (SPEC item
|
|
3.13.5.1): once the script name is typed, daedalus delegates the rest
|
|
of the line to the script — `daedalus hello -<TAB>` offers hello's
|
|
`-h` / `--help`, never daedalus's options. A Python script opts in
|
|
with `argcomplete.autocomplete(parser)` (SPEC item 6.9).
|
|
- `daedalus/completions.py`: the candidate functions argcomplete calls.
|
|
|
|
### Changed in 0.3.0
|
|
|
|
- The CLI argument handling now uses `argparse`
|
|
(`daedalus.cli.build_parser`): `-h/--help` prints the argparse
|
|
rendering, and parser-level errors keep the argparse messages (exit
|
|
code 2 stays). Options are parsed anywhere before the script words;
|
|
everything after the script name still goes to the script (SPEC item
|
|
3.1 unchanged).
|
|
- SPEC item 1.5 policy: reuse a popular, tested, trusted third-party
|
|
package when it exists instead of writing our own; argcomplete is
|
|
the first such dependency (SPEC item 9.6).
|
|
|
|
## [0.2.0] - 2026-11-18
|
|
|
|
### Added in 0.2.0
|
|
|
|
- `hello`: sample Python script (category `test`) that prints a hello
|
|
line and the daedalus version; first registered script, with tests and
|
|
an installed package entry (`daedalus.hello`).
|
|
|
|
## [0.1.0] - 2026-11-18
|
|
|
|
### Added in 0.1.0
|
|
|
|
- Categories: `Script.categories` (default `general`),
|
|
`daedalus <category>` listing (AND when several) and
|
|
`daedalus <category>… <name>` runs; script names and category labels
|
|
never collide.
|
|
- New listing format: `Daedalus Version:` line, `script` / `type` /
|
|
`categories` table, descriptions wrapped to the terminal width and
|
|
indented, colors via `NO_COLOR` / `FORCE_COLOR`.
|
|
- `daedalus/run_python_script.py`: `.py` scripts run through a child
|
|
entry that sets up `sys.path`, logging, `sys.argv`, and exit codes.
|
|
- `daedalus.daedalus_logging`: file logging to `~/.daedalus/debug.log`
|
|
plus a colored stderr console handler (`DAEDALUS_LOGLEVEL`,
|
|
`DAEDALUS_NO_LOGGING`).
|
|
- Library imports: shared code imports as `daedalus.<folder>`; the
|
|
checkout registers `python/src/<folder>` as packages on import and the
|
|
child gets `REPO_ROOT` on `PYTHONPATH`.
|
|
- Exact error messages for every usage failure, with close matches after
|
|
a category prefix.
|
|
|
|
### Changed in 0.1.0
|
|
|
|
- `SPEC.md` rewritten with stable item numbers (`SPEC item 3.7.1`), in
|
|
lockstep with the upstream scriptman specification.
|
|
|
|
## [0.0.0] - 2026-11-11
|
|
|
|
### Added in 0.0.0
|
|
|
|
- Empty template: CLI, CI, packaging, and script-integration guide with no
|
|
registered scripts.
|