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

8.4 KiB

Changelog

Notable changes are listed here. Release numbers match pyproject.toml. Newest entries are first.

Format follows Keep a Changelog and Semantic Versioning.

[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 (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.