AlgoScan

Per generated client crate, add tests/ (preserved across regeneration by the
src-only orphan sweep):
- models.rs: offline serde tests for the new extension-driven types
  (algokit_transact::Address, fixed [u8; N] arrays, box/holding/locals refs)
- integration_localnet.rs: #[ignore]'d smoke tests against a real localnet via
  the crates' .localnet() constructors, run with 'cargo test -- --ignored'

The unit tests run in the default offline suite; the integration scaffold is a
starting point for a fuller suite in a follow-up PR.

Instead of wiping the whole output directory before generation, overwrite the
generated files and sweep only orphaned .rs files under src/ (those no longer
produced by the current spec). Files outside the generated src/ tree -- e.g. a
hand-written tests/ directory -- are now preserved across regeneration.

Contains auto-generated code from specification file

Co-authored-by: Algorand Generation Bot <codegen@algorand.com>

Update api/README.md to describe fetching OAS3 specs from the pinned
algokit-oas-generator commit (and how to bump it), fix the convert-* command
descriptions in the contributing guide, and mark the legacy openapi_generators
research note as historical.

The OAS3 specs are now fetched from the pinned algokit-oas-generator commit
via 'cargo api convert-*', so the in-tree TypeScript converter and its npm
scaffolding are no longer needed. Drops the setup-node/npm ci steps from the
weekly api-openapi-sync workflow (its cargo api convert-* drift check stays).

Regenerated from the pinned upstream specs on top of the wasm32 http client.
Notable changes:
- Address fields now use algokit_transact::Address (indexer/kmd gain the
  algokit_transact dependency)
- 31 [u8; 32] and 11 [u8; 64] fixed-length byte arrays replace Vec<u8>
- box/holding/locals reference structs carry documenting markers
- upstream operationId/field renames and required-field changes

Specs now sourced from algokit-oas-generator @60ac9cc. Adds the upstream
vendor extensions our generator now honors (x-algokit-byte-length on 5 algod
+ 27 indexer fields; box/holding/locals-reference on 3 algod schemas) plus
upstream's operationId renames, field renames, and required-field strategies.

Bring the Rust OAS generator to extension parity with the utils-ts/-py
generators by honoring three vendor extensions it previously dropped:

- x-algorand-format: "Address" -> algokit_transact::Address
- x-algokit-byte-length: N -> fixed [u8; N] arrays (serde via Bytes)
- x-algokit-box/holding/locals-reference -> documenting struct markers

Pulls algokit_transact into generated clients that use Address even when
they have no msgpack operations (new has_address_fields spec flag).

Self-contained parser tests (via parse_dict) for the three newly honored
vendor extensions, independent of the regenerated specs.

Replace the in-tree npm convert-openapi calls in the convert-* commands with
a fetch of the published specs from a pinned algokit-oas-generator commit,
matching how algokit-utils-ts/-py consume the canonical converter. The pinned
SHA is recorded in api/specs/.oas-generator-sha and OAS_GENERATOR_SHA.

Port two remaining version-independent pieces from main:

- eslint.config.mjs: add eslint-plugin-unused-imports and switch to
  typescript-eslint projectService; unused vars/args are now warnings
  and unused imports are auto-removable (drops the examples-only ignore)
- add publish-devportal-docs.yml to publish docs to the AlgoKit devportal
  on push to main and version tags (complements GitHub Pages publishing)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>