Audit against the live repo after 0.11.0-0.13.1:
- preamble, item 1.2, and section 4 no longer claim "empty
template" (five scripts registered; the registry is the truth)
- item 2.1 tree: MANIFEST.in shown, requirements.txt comment
says test/lint/release tools
- item 9.1 install table: pipx install daedalus-tools from PyPI
and pipx upgrade daedalus-tools rows; public Gitea URL
- new item 9.9 Releasing: version bump, changelog, annotated
v<version> tag, latest follows, stable pinned, daedalus
publish as the guarded one-command flow (cites the publish
spec; a published version is immutable by design)
- items 7.11 and 9.6 include the build/twine release tooling
SPEC.md ships in the repo only (never in sdist/wheel), so no
version bump; docs-only commit on main after the v0.13.1 tag.
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
PyPI policy-blocks the plain name: the 0.12.1 upload was rejected
with "The name 'daedalus' isn't allowed" (near the existing
daedalus-cli and pydaedalus projects). The distribution is now
daedalus-tools; command, imports, registry, and the repository
name stay daedalus. hello's installed-version lookup follows.
publish now derives artifact file names from the PEP 625
normalized name (daedalus_tools-<version>.tar.gz) - with a
hyphenated project name the previously constructed names would
have missed what setuptools writes to dist/ (publish spec 3.2,
new regression test).
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
- new script python/src/publish/publish.py: guards (clean tree,
HEAD exactly tagged v<version>, version not yet on PyPI,
build+twine present), then the chained python -m build (the
sdist must rebuild the wheel, SPEC 9.2.1) and twine check;
--upload sends exactly this version's sdist+wheel, credentials
stay with twine (~/.pypirc or prompt, __token__)
- spec python/src/publish/spec.md (sections 1-7) first, then
tests (13) in python/tests/test_publish.py, then code
(SPEC 6.12)
- fix release-blocking sdist defect (SPEC 9.2.1): empty
powershell/ and batch/ folders now carry README placeholders
and MANIFEST.in ships them, so an sdist installs again
- release tooling in requirements.txt; registry entry, README
row + section, CHANGELOG 0.12.0, version pins
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
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>
- 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>
- cli.py rewritten on argparse (build_parser, REMAINDER pass-through: everything
after the script name still belongs to the script); help/errors are
argparse-rendered, exit code 2 kept for all daedalus errors
- completions.py (new): category-aware candidates for argcomplete - script names
+ unused labels narrowed by typed labels (daedalus test h<TAB> -> hello);
--path completes scripts; after a completed script name daedalus offers
nothing of its own and delegates .py scripts to their own parser via the
run_python_script child with a rewritten COMP_LINE (daedalus hello -<TAB> ->
hello's -h --help); SPEC 6.9 documents the autocomplete(parser) opt-in
- SPEC: item 1.5 reuse-first third-party policy, 3.8/3.10/3.11 argparse texts,
3.13 completion catalog, 6.9 script opt-in, 9.6 argcomplete dependency
- argcomplete>=3.3 as runtime dep (guarded import: CLI runs without it);
register-python-argcomplete line for ~/.bashrc; PYTHON_ARGCOMPLETE_OK marker
in bin/daedalus; README/INSTALL/CHANGELOG updated; hello opts in
- tests: argparse CLI suites, completer units, end-to-end argcomplete probes
through the bash fd-8 protocol and the delegation exec chain (autotest green,
coverage 97%)
Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
Sanitized open-source starter: renamed to daedalus, Norse-free of
internal references, AI attribution stripped, skill merged into
AGENTS.md, CI converted to Gitea Actions. No registered scripts yet.