dangernoodle-io / TaipanMiner / 28217298791

90%

push

github

feat: ad-hoc API access — fleet call + describe (#573)

* feat: fleet describe (endpoint + schema introspection)

- adds `./fleet describe` subcommand to list all endpoints served by
  a device's GET /api/openapi.json
- `./fleet describe PATH` shows request/response schemas for every
  method on that path, rendered as a human-readable field table
  (field name, type, required, enum/min/max, description)
- `./fleet describe PATH METHOD` narrows to one operation
- `--json` flag dumps the raw schema JSON instead of the table
- warns when a given path is not in the spec and suggests listing
- notes briefly if multiple devices have differing path sets
- adds _render_schema/_schema_type_str/_schema_notes helpers
- adds offline unit tests (test_cmd_describe.py — 17 tests)
- adds describe to README subcommands section + ad-hoc API access
  workflow guide

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat: fleet call (arbitrary spec-aware API requests)

- add call subcommand: call METHOD PATH with optional --json/--json-file body
- mutating methods (POST/PUT/PATCH/DELETE) routed through Guard (identity-verify,
  dry-run, --yes confirmation) matching the rest of the harness
- body validated against served request schema (jsonschema) before sending;
  --no-validate bypasses; mismatch prints field errors + describe hint
- unknown paths warn but allow the call (arbitrary-access intent)
- --fields dotted extraction from GET responses; --out-json writes structured results
- 17 offline unit tests covering GET, guard enforcement, body validation,
  fields extraction, --out-json, and unknown-path warning

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix: accept --log-level after the subcommand

- move --log-level registration into _add_common_flags (shared) with
  default=argparse.SUPPRESS so subparser value wins without clobbering
  a pre-subcommand value
- root parser sets_defaults(log_level='WARNING') to preserve the existing
  defaul... (continued)

2886 of 3627 branches covered (79.57%)

Branch coverage included in aggregate %.

5385 of 5540 relevant lines covered (97.2%)

149095.44 hits per line