fix(ant-dev): tooling cluster — flag alias, sys.executable, anvil preflight, README#83
Merged
Merged
Conversation
…flight, README Three small but user-visible papercuts that tripped up first-run setup: - #62: README documented --autonomi-dir but the CLI only accepted --ant-node-dir, so the literal command in the docs failed. Update the README to show --ant-node-dir, and accept --autonomi-dir as a back- compat alias so older scripts/blog-posts keep working without a deprecation period. - #63: ant dev example -l python shelled out to "python3" from PATH instead of sys.executable. Under PEP 668 distros (Ubuntu 24.04) where ant-dev has to live in a venv, the venv s python3 has antd installed and the system one does not, so the example fataled with ModuleNotFoundError. Use sys.executable, which is always the same interpreter that imported ant-dev. - #64: ant dev start needs anvil (Foundry) for the EVM testnet but neither the README nor any error message said so. The user only saw "Timed out waiting for devnet manifest". Add a shutil.which preflight with a clear install hint, and mention Foundry in the Required prerequisites section of the README. Closes #62, #63, #64
Nic-dorman
added a commit
that referenced
this pull request
May 14, 2026
Cuts v0.7.1 atop v0.7.0. Primarily refreshes the upstream `ant-core` pin to the `ant-cli-v0.2.3` release tag (no API change for antd consumers). Bundles a substantial round of cross-SDK example/build fixes, dispatcher improvements, and CI/release workflow hardening. ## antd - chore(antd): bump ant-core to v0.2.3 (#85) ## SDK example/build fixes - fix(antd-php): use cost-estimate fields in example 02 (#74) - fix(antd-elixir): print cost-estimate fields in examples (#75) - fix(antd-lua): add missing discover module to rockspec (#76) - fix(antd-kotlin): make put-response cost optional + ship gradle wrapper (#77) - fix(antd-zig): pass payment_mode to dataPutPublic/dataPutPrivate (#79) - fix(antd-java): make examples runnable via gradle :examples subproject (#80) - fix(antd-zig): align stdlib API to declared 0.14.x minimum (#82) - fix(antd-swift): port to Linux + populate cost-estimate fields (#87) ## ant-dev (developer CLI) - fix(ant-dev): clean up orphan anvil/antnode and stale node identities on stop (#81) - fix(ant-dev): tooling cluster — flag alias, sys.executable, anvil preflight, README (#83) - feat(ant-dev): expand `ant dev example` to dispatch all 15 SDKs (#84) - fix(ant-dev): dispatcher swift no-skip + lua LUA_PATH wrap (#86) - feat(ant-dev): expose --preset flag on `ant dev start` (default: small) (#88) ## CI / release - ci: authenticate arduino/setup-protoc on ci.yml too (#60) - feat(release): publish antd-linux-arm64 artifact (#89) ## Validation 15/15 SDKs round-tripped end-to-end against a daemon built from this commit on a Linux dev box (Ubuntu 24.04, 0.7.1 atop ant-core v0.2.3). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This was referenced May 14, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #62, #63, #64.
Three first-run papercuts in
ant-dev. Each is small in isolation; together they put new contributors through a frustrating setup loop.#62 — README's
--autonomi-dirdoes not match the CLI's--ant-node-dirThe README's CLI reference shows
ant dev start [--autonomi-dir PATH], butcli.pyonly declared--ant-node-dir, so the literal documented command fataled withunrecognized arguments. Two changes:--ant-node-dir.cli.pyaccepts--autonomi-diras a back-compat alias on the samedest, so any older scripts / docs / blog posts keep working. No deprecation noise.#63 —
ant dev example -l pythonignores the venvcmd_example.pyshelled out to"python3"fromPATHinstead ofsys.executable. Under PEP 668 (Ubuntu 24.04+) whereant-devlives in a venv, the venv'spython3hasantdinstalled and the system one doesn't, so the example crashed withModuleNotFoundError: No module named 'antd'. Switch tosys.executable— by construction the interpreter that's runningant-devhas access to the same dependency tree.#64 —
anvil(Foundry) is required but undocumentedant-devnetspawnsanvilfor the EVM testnet. Without Foundry installed,ant dev startwould just emitTimed out waiting for devnet manifestwith no hint at the actual cause.Two changes:
cmd_start.pydoes ashutil.which("anvil")preflight before launching the devnet, and prints a clear error + install hint when it's missing.Test plan
ant dev start --helpshows both forms:ant dev start --autonomi-dir ~/Projects/ant-nodeis accepted (alias) — verified by hitting the preflight error pathanvilremoved fromPATH:ant dev example -l pythonruns the Python example without the user having to. ~/.venvs/ant-dev/bin/activatefirst (verified by inspecting_run_one_pythonsource: now usessys.executable).