Skip to content

Refresh developer onboarding and retire the legacy skill - #102

Merged
JimCollinson merged 9 commits into
mainfrom
docs/adr-0016-overnight-refresh
Sep 25, 2026
Merged

JimCollinson merged 9 commits into
mainfrom
docs/adr-0016-overnight-refresh

Conversation

@JimCollinson

@JimCollinson JimCollinson commented Sep 23, 2026 •

Copy link
Copy Markdown
Member

Summary

  • Rewrite developer onboarding around practical tasks, with flatter navigation and clearer CLI, SDK, Direct Rust, and Agent Tools entry points.
  • Add native Python, Node.js, and .NET library references; distinguish direct libraries from antd clients; simplify MCP setup with Claude Code, Cursor, and OpenCode tabs.
  • Refresh API, payment, configuration, and language-reference content, including concrete limitations and safer wallet/file handling.
  • Add npm (@withautonomi/ant) as a CLI installation and update method alongside the shell and PowerShell installers, and replace installer-supplied bootstrap assumptions with the CLI's built-in peers.
  • Move release-bearing pages to ant-cli 0.3.8, ant-core 0.10.0, and ant-node 0.20.0. Direct Rust now uses one ant-core version for direct-network and LocalDevnet examples.
  • Retire the old developer skill and plugin distribution, remove skill-only scanner/guard/registry/routine responsibilities, and add regression tests for retained documentation safeguards.
  • Run the full repository test suite (governance, documentation-guard, and scanner tests) in CI through a new Repository Tests workflow.
  • Accept ADR-0017 (interface-accurate documentation design, superseding ADR-0011) and ADR-0018 (retire the beta developer skill in favor of the general skill in WithAutonomi/skills). Jim Collinson accepted both as decision owner on 2026-09-25; the superseded Accepted ADRs are unchanged.

Local previews, snapshots, working patches, and session audit reports are intentionally excluded.

Validation

Checked head 25c9fd78ebe2e635afcf71c7b2c6d7d391db401f:

  • All 53 repository tests pass locally and in the new Repository Tests CI job; ADR governance passes; git diff --check passes. All 108 existing verification blocks are unchanged, and 93 relative links across the 15 pages changed since eb00ced resolve.
  • All ten Rust examples in the Direct Rust and Embed a Node pages compile against the published ant-core 0.10.0 and ant-node 0.20.0 crates, including the two direct-network examples without the devnet feature.
  • Both embedded-node examples run and produce their documented output on Linux with ipv4_only set (the check host has no IPv6).
  • The six LocalDevnet examples compile but were not run: LocalDevnet in ant-core 0.10.0 cannot start on a host without IPv6, and product source was not patched to force it. The Library Reference states this limitation.
  • npm install @withautonomi/ant@0.3.8 installs and reports ant 0.3.8 on macOS ARM64 and Linux x64. The free Lucky download passed on macOS; the Linux check host blocks outbound UDP, so no public-network read ran there.
  • Test Your Application's integration steps install pytest into the local-network environment and activate it at $WORK_DIR/.venv. Both corrected steps were rehearsed in a pinned ant-sdk v0.12.0 environment (pytest install and run; ant dev example from the checkout); the local network itself was not started.
  • Published crate provenance: ant-core 0.10.0 and ant-cli-v0.3.8 resolve to 9112d683; ant-node 0.20.0 and tag v0.20.0 resolve to 2b4ab3c5. Native SDKs (0.0.9) and antd clients (0.1.0) have no newer releases; ant-sdk has no release after v0.13.0.
  • Independent re-reviews (Hermes panel) on 5b815f9 and bccb6da found no confirmed content defect and gave an advisory approval, with reduced panel coverage disclosed; the remaining items are dispositioned below.

All seven PR checks pass on 25c9fd7. These greens do not establish release verification or product-runtime success.

GitBook preview

Open items and dispositions

Item Disposition
Verification blocks still record August default-branch commits; six new pages have none Follow-up: #104. Blocks are unrendered provenance metadata. Page content was checked against the released artifacts listed above; restamping requires the release-baseline stamp format from #103, and stamps are not changed without the corresponding verification.
Authoring rules, verification workflow, and daily sweep still implement merged truth Follow-up: #103 (ADR-0016 implementation spec and tooling change). The daily sweep routine was paused on 2026-09-25; keep it paused until #103 lands.
ant-node v0.20.0 archive signatures fail against sign/release-signing-key.pub Documented limitation; not blocking. Source Repositories tells readers not to rely on manual verification with that key. The file differs from the RELEASE_SIGNING_KEY compiled into the node's upgrade verifier; the question is with the ant-node maintainer.
RUSTSEC-2026-0285 Resolved for the CLI and node on lockfile evidence: ant-cli 0.3.8 and ant-node 0.20.0 pin rustls 0.23.45, inside the patched range (>= 0.23.45); the antd 0.13.0 lockfile was already patched. The native SDK 0.0.9 dependency graph is tracked in #104.
33 guard and scanner tests ran locally only Resolved: the Repository Tests workflow runs all 53 tests on every PR and on pushes to main.
Two Test Your Application setup errors Resolved in 5b815f9.
ADR-0017 and ADR-0018 Resolved: accepted by Jim Collinson on 2026-09-25. ADR-0018's rationale and notice clause were revised first to match the approved retirement notice.
Official clean-context review Waived by Jim Collinson on 2026-09-25 for this PR, relying on the Hermes panel re-reviews above. The earlier attempt stopped before inference because its prerequisites were missing.

Non-blocking review observations: the scanner's source/registry snapshot assertions may be too restrictive for future maintenance; the prompt-led external-skill installation delegates trust to mutable third-party instructions.

Merging publishes to docs.autonomi.com/developers through GitBook Git Sync.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Ah5ndGUY5mie6MUzFT9cor

JimCollinson and others added 5 commits September 23, 2026 17:30
Update the release-bearing pages to ant-cli 0.3.8, ant-core 0.10.0,
and ant-node 0.20.0, the published releases at ant-client 9112d68 and
ant-node 2b4ab3c.

- Direct Rust uses ant-core 0.10.0 for both direct-network and
  LocalDevnet examples; its devnet feature now depends on ant-node
  0.20.0, so the separate 0.8.0 local pin is no longer needed. Note the
  Rust 1.91 minimum and the new quic bootstrap-list format.
- Embed a Node pins ant-node 0.20.0 and documents the default
  webrtc-direct feature and webrtc_direct config field.
- Source Repositories, System Overview, and Post-Quantum Cryptography
  list the shared CLI/node dependency versions; the node signing-key
  limitation now names v0.20.0.
- Fix leftover CLI 0.3.6 references and the stale shared saorsa
  versions left by the npm follow-up.
- Add verified IPv6-less and no-peers errors to Use the CLI, and the
  IPv6-less error to Embed a Node.

All ten Rust examples compile against the published crates; both
embedded-node examples run with ipv4_only set on an IPv6-less host.
Verification stamps are unchanged pending release-baseline promotion.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ah5ndGUY5mie6MUzFT9cor
Add three verified Direct Rust notes to the Library Reference:
Client::connect returns before any bootstrap peer responds, ipv6: false
lets the client start on hosts without IPv6, and LocalDevnet in
ant-core 0.10.0 has no IPv4-only option.

Record the September 24 release-check results in planning/STATE.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ah5ndGUY5mie6MUzFT9cor
The integration environment created by Set Up a Local Network does not
include pytest, so step 4 failed with pytest not found on a clean
runner; install it before running the test. Step 5 activated a .venv
inside the ant-sdk checkout, but that environment lives at
$WORK_DIR/.venv; activate it there and change into the checkout.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ah5ndGUY5mie6MUzFT9cor
@JimCollinson
JimCollinson marked this pull request as ready for review September 24, 2026 17:51
The ADR Governance workflow runs only test_adr_governance.py, so the
documentation-guard and scanner tests had local evidence only. Add a
Repository Tests workflow that runs all tests in scripts/tests on every
pull request and on pushes to main, with the PyYAML pin duplicated
literally as in sweep-sha-reachability.yml.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ah5ndGUY5mie6MUzFT9cor
Describe the retirement as a move to one general Autonomi skill and its
supporting processes in WithAutonomi/skills, and record why: more
flexibility and a better experience for agents and users than several
skills in different locations, and one findable home that supports
distribution and installation of this and future skills. Drop the
"prototype" description, which would quickly go stale, and align the
notice clause with the published retirement notice, which links to the
general skill without installation commands.

The ADR remains Proposed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ah5ndGUY5mie6MUzFT9cor
The literal PyYAML pin keeps the workflow in step with the other
workflow; it is not a security boundary, since the tests themselves come
from the pull request.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ah5ndGUY5mie6MUzFT9cor
Jim Collinson, as decision owner, accepted both ADRs after review of
PR #102 on 2026-09-25. Record the Accepted status, prospective
acceptance basis, and reviewer, following ADR-0016's format. The
superseded Accepted ADRs are unchanged; supersession is recorded in the
new records.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ah5ndGUY5mie6MUzFT9cor
@JimCollinson
JimCollinson merged commit ecbc1f8 into main Sep 25, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants