Files
daedalus/CHANGELOG.md
T
nvaldez e9b716b399 feat: gpgtools configure_ssh, store_publickey, --file source, initialize (v0.7.0-v0.9.0)
- configure_ssh (0.7.0): marker-managed per-host ssh client block in
  ~/.ssh/config, idempotent, unmanaged-alias guard (exit 11)
- store_publickey (0.8.0): on-site bootstrap mirror of send_pubkey -
  run on the machine access is granted to, installs the key into the
  local authorized_keys (multi-key preserving, material dedup, 700/600,
  no possession check by design); shared --file PATH source (USB
  stick) for both store subcommands; identity block printed before
  acting (line, source, SHA-256 material digest)
- initialize (0.9.0): gnupg readiness check + install, no card
  expectations; --dry-run; initialize_yubikey step 1 shares the flow
- spec-first per SPEC 6.11/6.12: gpgtools spec.md items 2.6/2.7,
  4.1.5, 4.8, sections 10-12; 91 tests in test_gpgtools.py;
  README/registry/CHANGELOG/version pins through 0.9.0

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
2026-11-19 08:57:30 +01:00

196 lines
8.4 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]
- Nothing yet.
## [0.9.0] - 2026-11-19
### Added in 0.9.0
- `gpgtools initialize`: checks that gnupg is ready on this machine
(`gpg --version`) and installs what is missing — the gnupg-only
half of `initialize_yubikey`, with no card expectations. Missing gpg
triggers the same manager detection and sudo install; the check
re-runs once after a successful install. `--dry-run` prints
`already ready` or the install command and changes nothing. Intended
as the on-site companion to `store_publickey --fingerprint` on a
bare server. Spec section 12 written first, then tests, then code
(SPEC 6.12); `initialize_yubikey` step 1 now runs the same shared
flow instead of its own inline copy.
## [0.8.0] - 2026-11-19
### Added in 0.8.0
- `gpgtools store_publickey`: the on-site bootstrap mirror of
`send_pubkey`. Run on the machine that access is being granted
**to** (a server with ssh password authentication disabled, no key
there yet, you at its console), it resolves one SSH public key and
appends it to this machine's `authorized_keys` — so the machine
holding the YubiKey can ssh in afterwards. Same five sources as
`send_pubkey`; by design there is no proof-of-possession (the
private half is elsewhere). Existing entries preserved verbatim,
idempotent by key material, `~/.ssh`/file modes forced to 700/600,
`--authorized-keys` override, `--dry-run`. Spec section 11 written
first, then tests, then code (SPEC 6.12).
- New shared source `--file PATH` for both `send_pubkey` and
`store_publickey`: a file holding the SSH public key line,
typically `yubikey_auth.pub` carried on a USB stick — no network,
no gpg needed. Several keys in one file refuse rather than guess.
- Both resolve-and-store subcommands now print an identity block (key
line, source, and the key material's SHA-256 digest) before acting,
so what was resolved can be compared across machines.
## [0.7.0] - 2026-11-19
### Added in 0.7.0
- `gpgtools configure_ssh` (guide step 7): writes a marker-managed
`Host <alias>` block into the ssh client config — YubiKey identity
first, fallback identity only when it exists, `IdentitiesOnly yes`.
Idempotent (re-runs replace the block; everything outside the
markers is preserved), `--dry-run`, and a guard that refuses when an
unmanaged `Host` with the same alias would shadow the block. Spec
items 2.5 and 10 written first, then tests, then code (SPEC 6.12).
- 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. First specs added:
`gpgtools`, `hello`, `hello_bash`.
### Fixed in 0.7.0
- Test fixtures no longer carry private values: the real server IP,
host alias, card serial, and public key fingerprint were replaced
with documentation-range placeholders.
## [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.