feat(examples): seed_marine.py + sensor field guides for the Aeolian Fortune demo

[tsangiotis]

What

SDK-side companion to the Aeolian Fortune marine demo (mechbase-web PR). Two additive parts — no SDK source (src/mechbase) changes:

field-guides/ — technician working guides

• vibration.md — TE Connectivity WVS sensor (with the product photo embedded); mounting decision tree (stud/epoxy → flat-magnet-on-flat → two-pole on curved → target-on-painted); load-zone/bearing-housing placement; align the X-axis to the shaft; surface prep; what to avoid.
• thermography.md — FLIR Edge: emissivity & the matte default, view angle, distance/spot-size, ΔT severity, electrical vs bearing targets.
• ultrasound.md — bearing / leak / electrical-PD applications; handheld dB-trend interpretation.

These mirror the in-app per-sensor instructions that bootstrap_marine injects onto route measurement items.

examples/seed_marine.py — standalone SDK example

Demonstrates the full client flow against any Mechbase instance using only the public SDK surface: discover the structure, batch-push readings (chunked under the 1000-item API cap, per-reading external_id for idempotency), and run + complete route executions — with a --dry-run and an installation-name guard.

Note: the demo itself is now seeded entirely by mechbase-web's bootstrap_marine command (consolidated to one step, no token hand-off). This script is retained purely as a reusable, runnable SDK example.

Validation

Pure reading-generator functions are unit-tested (bands verified within ISO/rule bounds for all seeds; 4 tests). Reviewed READY TO MERGE (no Critical/Important).

Notes

• Field guides live in field-guides/ (the repo's docs/ is git-ignored, so shipped guides go here).

🤖 Generated with Claude Code