meshtastic-mcp 0.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- meshtastic_mcp-0.1.0/.cursorrules +10 -0
- meshtastic_mcp-0.1.0/.dockerignore +18 -0
- meshtastic_mcp-0.1.0/.editorconfig +18 -0
- meshtastic_mcp-0.1.0/.gitattributes +5 -0
- meshtastic_mcp-0.1.0/.github/CODEOWNERS +2 -0
- meshtastic_mcp-0.1.0/.github/FUNDING.yml +3 -0
- meshtastic_mcp-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml +28 -0
- meshtastic_mcp-0.1.0/.github/ISSUE_TEMPLATE/config.yml +5 -0
- meshtastic_mcp-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml +12 -0
- meshtastic_mcp-0.1.0/.github/PULL_REQUEST_TEMPLATE.md +15 -0
- meshtastic_mcp-0.1.0/.github/copilot-instructions.md +22 -0
- meshtastic_mcp-0.1.0/.github/evals/README.md +15 -0
- meshtastic_mcp-0.1.0/.github/evals/canonical-tasks.md +28 -0
- meshtastic_mcp-0.1.0/.github/evals/results-template.csv +16 -0
- meshtastic_mcp-0.1.0/.github/evals/score.sh +14 -0
- meshtastic_mcp-0.1.0/.github/evals/tool-selection.csv +22 -0
- meshtastic_mcp-0.1.0/.github/renovate.json +7 -0
- meshtastic_mcp-0.1.0/.github/workflows/ci.yml +299 -0
- meshtastic_mcp-0.1.0/.github/workflows/release.yml +65 -0
- meshtastic_mcp-0.1.0/.github/workflows/scorecard.yml +33 -0
- meshtastic_mcp-0.1.0/.gitignore +50 -0
- meshtastic_mcp-0.1.0/.mcp.json +9 -0
- meshtastic_mcp-0.1.0/.pre-commit-config.yaml +15 -0
- meshtastic_mcp-0.1.0/.windsurfrules +10 -0
- meshtastic_mcp-0.1.0/AGENTS.md +262 -0
- meshtastic_mcp-0.1.0/CHANGELOG.md +219 -0
- meshtastic_mcp-0.1.0/CITATION.cff +8 -0
- meshtastic_mcp-0.1.0/CLAUDE.md +6 -0
- meshtastic_mcp-0.1.0/CODE_OF_CONDUCT.md +5 -0
- meshtastic_mcp-0.1.0/CONTRIBUTING.md +35 -0
- meshtastic_mcp-0.1.0/CONVENTIONS.md +4 -0
- meshtastic_mcp-0.1.0/Dockerfile +23 -0
- meshtastic_mcp-0.1.0/GEMINI.md +4 -0
- meshtastic_mcp-0.1.0/LICENSE +675 -0
- meshtastic_mcp-0.1.0/PKG-INFO +329 -0
- meshtastic_mcp-0.1.0/README.md +271 -0
- meshtastic_mcp-0.1.0/SECURITY.md +53 -0
- meshtastic_mcp-0.1.0/docs/bench-setup.md +99 -0
- meshtastic_mcp-0.1.0/docs/local-models.md +90 -0
- meshtastic_mcp-0.1.0/docs/sdk-cli-bridge.md +75 -0
- meshtastic_mcp-0.1.0/llms.txt +27 -0
- meshtastic_mcp-0.1.0/pyproject.toml +142 -0
- meshtastic_mcp-0.1.0/run-tests.sh +317 -0
- meshtastic_mcp-0.1.0/scripts/build_android_apk.sh +82 -0
- meshtastic_mcp-0.1.0/scripts/build_apple.sh +84 -0
- meshtastic_mcp-0.1.0/scripts/build_meshtasticd.sh +65 -0
- meshtastic_mcp-0.1.0/scripts/check_spdx.py +56 -0
- meshtastic_mcp-0.1.0/scripts/ci_android_app_loop.py +78 -0
- meshtastic_mcp-0.1.0/scripts/ci_apple_app_loop.py +260 -0
- meshtastic_mcp-0.1.0/scripts/ci_device_mesh_e2e.py +222 -0
- meshtastic_mcp-0.1.0/scripts/datadog-dashboard.json +281 -0
- meshtastic_mcp-0.1.0/scripts/fleetsuite.sh +80 -0
- meshtastic_mcp-0.1.0/scripts/validate_skills.py +104 -0
- meshtastic_mcp-0.1.0/scripts/web-dev.sh +35 -0
- meshtastic_mcp-0.1.0/server.json +60 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/__init__.py +22 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/__main__.py +642 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/_version.py +24 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/admin.py +413 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/boards.py +158 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/camera.py +336 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/capabilities.py +147 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/cli/__init__.py +9 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/cli/_flashlog.py +76 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/cli/_fwlog.py +100 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/cli/_history.py +130 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/cli/_reproducer.py +216 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/cli/_uicap.py +86 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/cli/test_tui.py +1862 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/config.py +279 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/config_snapshot.py +144 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/connection.py +247 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/devices.py +163 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/doctor.py +655 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/emulator/__init__.py +2 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/emulator/apple_sim.py +318 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/emulator/avd.py +898 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/emulator/native_node.py +145 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/fixtures.py +415 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/flash.py +772 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/hw_tools.py +245 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/info.py +106 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/input_events.py +66 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/llama_server.py +163 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/local_model.py +228 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/log_query.py +414 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/lora_compliance.py +337 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/ocr.py +148 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/pio.py +317 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/port_recovery.py +300 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/py.typed +0 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/recorder/__init__.py +22 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/recorder/parsers.py +310 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/recorder/recorder.py +493 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/recorder/rotating.py +166 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/recovery.py +180 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/registry.py +115 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/replay/__init__.py +53 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/replay/build.py +276 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/replay/capture.py +443 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/replay/engine.py +786 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/replay/fuzz.py +489 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/replay/sim.py +822 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/rf_oracle.py +425 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/sdk_cli.py +224 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/sdr.py +371 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/serial_session.py +303 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/server.py +2543 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-device-ops/SKILL.md +123 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/SKILL.md +184 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/emulator-lab.md +155 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/harness.md +83 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/journeys/inbound.journey.xml +25 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/journeys/node-sync.journey.xml +19 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/journeys/outbound.journey.xml +21 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/journeys.md +52 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/loop-config-writeback.md +49 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/loop-inbound.md +54 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/loop-node-sync.md +55 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/loop-outbound.md +52 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/loop-resilience.md +63 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/mesh_e2e.py +216 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/replay-app-features.md +65 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/simulator-apple.md +157 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/topology.md +71 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/triage.md +42 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-e2e/references/vision-oracle.md +38 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/skills/meshtastic-org-knowledge/SKILL.md +122 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/uhubctl.py +321 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/userprefs.py +535 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/__init__.py +14 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/__main__.py +99 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/app.py +985 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/camera_worker.py +133 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/db/__init__.py +6 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/db/database.py +188 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/db/repo_builds.py +62 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/db/repo_cameras.py +81 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/db/repo_devices.py +235 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/db/repo_flash.py +61 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/db/repo_runs.py +96 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/db/repo_settings.py +29 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/__init__.py +7 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/activity.py +113 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/builder.py +244 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/camera_stream.py +223 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/control.py +36 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/datadog.py +565 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/discovery.py +298 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/firmware.py +54 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/identity.py +144 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/keepalive.py +136 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/native.py +88 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/portlock.py +49 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/power.py +132 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/recovery.py +140 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/scrub.py +46 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/serial_monitor.py +243 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/services/test_runner.py +630 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/static/assets/index-BcjZL-YS.js +21 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/static/assets/index-Bxcb0DBw.css +1 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/static/index.html +13 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/ws/__init__.py +5 -0
- meshtastic_mcp-0.1.0/src/meshtastic_mcp/web/ws/hub.py +76 -0
- meshtastic_mcp-0.1.0/tests/README.md +127 -0
- meshtastic_mcp-0.1.0/tests/__init__.py +3 -0
- meshtastic_mcp-0.1.0/tests/_bench.py +157 -0
- meshtastic_mcp-0.1.0/tests/_port_discovery.py +156 -0
- meshtastic_mcp-0.1.0/tests/_power.py +179 -0
- meshtastic_mcp-0.1.0/tests/_recovery.py +70 -0
- meshtastic_mcp-0.1.0/tests/admin/__init__.py +3 -0
- meshtastic_mcp-0.1.0/tests/admin/test_channel_url_roundtrip.py +61 -0
- meshtastic_mcp-0.1.0/tests/admin/test_config_roundtrip.py +108 -0
- meshtastic_mcp-0.1.0/tests/admin/test_owner_survives_reboot.py +62 -0
- meshtastic_mcp-0.1.0/tests/conftest.py +1309 -0
- meshtastic_mcp-0.1.0/tests/fleet/__init__.py +3 -0
- meshtastic_mcp-0.1.0/tests/fleet/test_psk_seed_isolates_runs.py +37 -0
- meshtastic_mcp-0.1.0/tests/mesh/__init__.py +3 -0
- meshtastic_mcp-0.1.0/tests/mesh/_receive.py +224 -0
- meshtastic_mcp-0.1.0/tests/mesh/test_bidirectional.py +82 -0
- meshtastic_mcp-0.1.0/tests/mesh/test_broadcast_delivers.py +49 -0
- meshtastic_mcp-0.1.0/tests/mesh/test_direct_with_ack.py +108 -0
- meshtastic_mcp-0.1.0/tests/mesh/test_mesh_formation.py +41 -0
- meshtastic_mcp-0.1.0/tests/mesh/test_nexthop_multihop_recovery.py +345 -0
- meshtastic_mcp-0.1.0/tests/mesh/test_peer_offline_recovery.py +157 -0
- meshtastic_mcp-0.1.0/tests/mesh/test_traceroute.py +147 -0
- meshtastic_mcp-0.1.0/tests/monitor/__init__.py +3 -0
- meshtastic_mcp-0.1.0/tests/monitor/test_boot_log_no_panic.py +65 -0
- meshtastic_mcp-0.1.0/tests/provisioning/__init__.py +3 -0
- meshtastic_mcp-0.1.0/tests/provisioning/test_admin_key_baked.py +85 -0
- meshtastic_mcp-0.1.0/tests/provisioning/test_bake_region_modem_slot.py +59 -0
- meshtastic_mcp-0.1.0/tests/provisioning/test_unset_region_blocks_tx.py +110 -0
- meshtastic_mcp-0.1.0/tests/provisioning/test_userprefs_survive_factory_reset.py +93 -0
- meshtastic_mcp-0.1.0/tests/recovery/__init__.py +9 -0
- meshtastic_mcp-0.1.0/tests/recovery/conftest.py +47 -0
- meshtastic_mcp-0.1.0/tests/recovery/test_list_hubs.py +45 -0
- meshtastic_mcp-0.1.0/tests/recovery/test_power_cycle_preserves_userprefs.py +60 -0
- meshtastic_mcp-0.1.0/tests/recovery/test_power_cycle_roundtrip.py +120 -0
- meshtastic_mcp-0.1.0/tests/recovery/test_recovery_ladder.py +70 -0
- meshtastic_mcp-0.1.0/tests/telemetry/__init__.py +3 -0
- meshtastic_mcp-0.1.0/tests/telemetry/test_device_telemetry_broadcast.py +80 -0
- meshtastic_mcp-0.1.0/tests/telemetry/test_telemetry_request_reply.py +190 -0
- meshtastic_mcp-0.1.0/tests/test_00_bake.py +306 -0
- meshtastic_mcp-0.1.0/tests/tool_coverage.py +155 -0
- meshtastic_mcp-0.1.0/tests/ui/__init__.py +10 -0
- meshtastic_mcp-0.1.0/tests/ui/_ocr_match.py +27 -0
- meshtastic_mcp-0.1.0/tests/ui/_screen_log.py +175 -0
- meshtastic_mcp-0.1.0/tests/ui/conftest.py +483 -0
- meshtastic_mcp-0.1.0/tests/ui/test_input_fn_jump.py +65 -0
- meshtastic_mcp-0.1.0/tests/ui/test_input_fn_oob.py +61 -0
- meshtastic_mcp-0.1.0/tests/ui/test_input_menu.py +72 -0
- meshtastic_mcp-0.1.0/tests/ui/test_input_message_scroll.py +62 -0
- meshtastic_mcp-0.1.0/tests/ui/test_input_navigation.py +95 -0
- meshtastic_mcp-0.1.0/tests/ui/test_input_node_scroll.py +55 -0
- meshtastic_mcp-0.1.0/tests/ui/test_input_user_button.py +71 -0
- meshtastic_mcp-0.1.0/tests/ui/test_screen_clickthrough.py +166 -0
- meshtastic_mcp-0.1.0/tests/ui/test_screen_content.py +110 -0
- meshtastic_mcp-0.1.0/tests/ui/test_screen_keep_on.py +50 -0
- meshtastic_mcp-0.1.0/tests/unit/__init__.py +3 -0
- meshtastic_mcp-0.1.0/tests/unit/conftest.py +16 -0
- meshtastic_mcp-0.1.0/tests/unit/test_admin_factory_reset.py +65 -0
- meshtastic_mcp-0.1.0/tests/unit/test_apple_sim.py +54 -0
- meshtastic_mcp-0.1.0/tests/unit/test_avd_physical.py +93 -0
- meshtastic_mcp-0.1.0/tests/unit/test_bench_roles.py +115 -0
- meshtastic_mcp-0.1.0/tests/unit/test_boards.py +78 -0
- meshtastic_mcp-0.1.0/tests/unit/test_build_flags.py +92 -0
- meshtastic_mcp-0.1.0/tests/unit/test_camera_orient.py +67 -0
- meshtastic_mcp-0.1.0/tests/unit/test_ci_device_mesh_e2e.py +63 -0
- meshtastic_mcp-0.1.0/tests/unit/test_cli_install.py +97 -0
- meshtastic_mcp-0.1.0/tests/unit/test_config_snapshot.py +74 -0
- meshtastic_mcp-0.1.0/tests/unit/test_connection_close.py +53 -0
- meshtastic_mcp-0.1.0/tests/unit/test_connection_tcp.py +369 -0
- meshtastic_mcp-0.1.0/tests/unit/test_devices.py +61 -0
- meshtastic_mcp-0.1.0/tests/unit/test_doctor.py +63 -0
- meshtastic_mcp-0.1.0/tests/unit/test_emulator_avd.py +217 -0
- meshtastic_mcp-0.1.0/tests/unit/test_evals_dataset.py +43 -0
- meshtastic_mcp-0.1.0/tests/unit/test_fake_nodedb_generator.py +365 -0
- meshtastic_mcp-0.1.0/tests/unit/test_flash_preflight.py +216 -0
- meshtastic_mcp-0.1.0/tests/unit/test_hw_tool_resolver.py +66 -0
- meshtastic_mcp-0.1.0/tests/unit/test_input_event_codes.py +94 -0
- meshtastic_mcp-0.1.0/tests/unit/test_local_model.py +94 -0
- meshtastic_mcp-0.1.0/tests/unit/test_lora_compliance.py +120 -0
- meshtastic_mcp-0.1.0/tests/unit/test_makereport_timeout.py +60 -0
- meshtastic_mcp-0.1.0/tests/unit/test_mcp_surface.py +50 -0
- meshtastic_mcp-0.1.0/tests/unit/test_native_node.py +33 -0
- meshtastic_mcp-0.1.0/tests/unit/test_pio_wrapper.py +69 -0
- meshtastic_mcp-0.1.0/tests/unit/test_port_recovery.py +108 -0
- meshtastic_mcp-0.1.0/tests/unit/test_recorder.py +532 -0
- meshtastic_mcp-0.1.0/tests/unit/test_recovery_ladder.py +224 -0
- meshtastic_mcp-0.1.0/tests/unit/test_registry_port_lock.py +37 -0
- meshtastic_mcp-0.1.0/tests/unit/test_replay.py +803 -0
- meshtastic_mcp-0.1.0/tests/unit/test_rf_oracle.py +65 -0
- meshtastic_mcp-0.1.0/tests/unit/test_sdk_cli.py +121 -0
- meshtastic_mcp-0.1.0/tests/unit/test_sdr.py +160 -0
- meshtastic_mcp-0.1.0/tests/unit/test_testing_profile.py +124 -0
- meshtastic_mcp-0.1.0/tests/unit/test_tool_annotations.py +133 -0
- meshtastic_mcp-0.1.0/tests/unit/test_uhubctl_parser.py +150 -0
- meshtastic_mcp-0.1.0/tests/unit/test_ui_camera_binding.py +94 -0
- meshtastic_mcp-0.1.0/tests/unit/test_ui_screen_log.py +81 -0
- meshtastic_mcp-0.1.0/tests/unit/test_userprefs_parse.py +119 -0
- meshtastic_mcp-0.1.0/tests/unit/test_web_activity.py +210 -0
- meshtastic_mcp-0.1.0/tests/unit/test_web_auto_recover.py +67 -0
- meshtastic_mcp-0.1.0/tests/unit/test_web_builder.py +143 -0
- meshtastic_mcp-0.1.0/tests/unit/test_web_camera_worker.py +164 -0
- meshtastic_mcp-0.1.0/tests/unit/test_web_datadog.py +160 -0
- meshtastic_mcp-0.1.0/tests/unit/test_web_discovery_unwedge.py +91 -0
- meshtastic_mcp-0.1.0/tests/unit/test_web_keepalive.py +160 -0
- meshtastic_mcp-0.1.0/tests/unit/test_web_portlock.py +103 -0
- meshtastic_mcp-0.1.0/tests/unit/test_web_registry.py +541 -0
- meshtastic_mcp-0.1.0/tests/unit/test_web_serial_monitor_guard.py +129 -0
- meshtastic_mcp-0.1.0/tests/unit/test_web_test_runner_spawn.py +398 -0
- meshtastic_mcp-0.1.0/uv.lock +3631 -0
- meshtastic_mcp-0.1.0/web-ui/README.md +49 -0
- meshtastic_mcp-0.1.0/web-ui/env.d.ts +10 -0
- meshtastic_mcp-0.1.0/web-ui/index.html +12 -0
- meshtastic_mcp-0.1.0/web-ui/package-lock.json +2195 -0
- meshtastic_mcp-0.1.0/web-ui/package.json +23 -0
- meshtastic_mcp-0.1.0/web-ui/src/App.vue +52 -0
- meshtastic_mcp-0.1.0/web-ui/src/ansi.ts +79 -0
- meshtastic_mcp-0.1.0/web-ui/src/api/client.ts +38 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/AppBar.vue +134 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/BuildQueue.vue +123 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/CameraFeed.vue +253 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/CameraManager.vue +207 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/DatadogPanel.vue +167 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/DeviceCard.vue +291 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/DeviceControls.vue +415 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/DeviceGrid.vue +44 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/DeviceSettings.vue +349 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/FirmwareRef.vue +40 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/KeepAlivePanel.vue +134 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/LogPane.vue +41 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/NativeManager.vue +154 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/PacketPane.vue +64 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/RunControls.vue +110 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/SerialLogPane.vue +27 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/TestDashboard.vue +93 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/TestResultsPane.vue +60 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/TestTree.vue +79 -0
- meshtastic_mcp-0.1.0/web-ui/src/components/TierCounters.vue +73 -0
- meshtastic_mcp-0.1.0/web-ui/src/main.ts +9 -0
- meshtastic_mcp-0.1.0/web-ui/src/stores/actions.ts +96 -0
- meshtastic_mcp-0.1.0/web-ui/src/stores/builds.ts +80 -0
- meshtastic_mcp-0.1.0/web-ui/src/stores/cameras.ts +74 -0
- meshtastic_mcp-0.1.0/web-ui/src/stores/datadog.ts +60 -0
- meshtastic_mcp-0.1.0/web-ui/src/stores/devices.ts +141 -0
- meshtastic_mcp-0.1.0/web-ui/src/stores/firmware.ts +26 -0
- meshtastic_mcp-0.1.0/web-ui/src/stores/keepalive.ts +45 -0
- meshtastic_mcp-0.1.0/web-ui/src/stores/tests.ts +212 -0
- meshtastic_mcp-0.1.0/web-ui/src/stores/ws.ts +81 -0
- meshtastic_mcp-0.1.0/web-ui/src/style.css +192 -0
- meshtastic_mcp-0.1.0/web-ui/src/types.ts +73 -0
- meshtastic_mcp-0.1.0/web-ui/tsconfig.json +16 -0
- meshtastic_mcp-0.1.0/web-ui/vite.config.ts +22 -0
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
See AGENTS.md — it is the source of truth for architecture, rules, and workflow.
|
|
2
|
+
|
|
3
|
+
Quick reference for Cursor:
|
|
4
|
+
- Core MCP tools always register; firmware/android/apple tools gate on capabilities.detect().
|
|
5
|
+
- No firmware-tree assumptions in core modules (use config.firmware_root_or_none()).
|
|
6
|
+
- Destructive tools require confirm=True; never bypass the gate.
|
|
7
|
+
- One MCP call per serial port at a time (exclusive lock).
|
|
8
|
+
- No type debt: mypy with no per-module ignore_errors; ruff clean (no blanket # noqa).
|
|
9
|
+
- Pre-push: ruff check + ruff format --check + mypy + pytest tests/unit
|
|
10
|
+
- License: GPL-3.0-only; git commit -s (DCO sign-off).
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
root = true
|
|
2
|
+
|
|
3
|
+
[*]
|
|
4
|
+
charset = utf-8
|
|
5
|
+
end_of_line = lf
|
|
6
|
+
insert_final_newline = true
|
|
7
|
+
trim_trailing_whitespace = true
|
|
8
|
+
indent_style = space
|
|
9
|
+
|
|
10
|
+
[*.py]
|
|
11
|
+
indent_size = 4
|
|
12
|
+
max_line_length = 100
|
|
13
|
+
|
|
14
|
+
[*.{json,yml,yaml,toml}]
|
|
15
|
+
indent_size = 2
|
|
16
|
+
|
|
17
|
+
[*.md]
|
|
18
|
+
trim_trailing_whitespace = false
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
name: Bug report
|
|
2
|
+
description: Something in the MCP server, tools, or skill misbehaves
|
|
3
|
+
labels: [bug]
|
|
4
|
+
body:
|
|
5
|
+
- type: textarea
|
|
6
|
+
id: what
|
|
7
|
+
attributes:
|
|
8
|
+
label: What happened
|
|
9
|
+
description: Expected vs actual. Include the tool name / command.
|
|
10
|
+
validations: { required: true }
|
|
11
|
+
- type: dropdown
|
|
12
|
+
id: capability
|
|
13
|
+
attributes:
|
|
14
|
+
label: Capability
|
|
15
|
+
options: [core, firmware, emulator, skill, unsure]
|
|
16
|
+
validations: { required: true }
|
|
17
|
+
- type: textarea
|
|
18
|
+
id: env
|
|
19
|
+
attributes:
|
|
20
|
+
label: Environment
|
|
21
|
+
description: meshtastic-mcp version, Python, OS, device/transport (serial/TCP/BLE), firmware version.
|
|
22
|
+
validations: { required: true }
|
|
23
|
+
- type: textarea
|
|
24
|
+
id: logs
|
|
25
|
+
attributes:
|
|
26
|
+
label: Logs
|
|
27
|
+
description: Server log (capability line), recorder/firmware log tail. Redact PII/keys/location.
|
|
28
|
+
render: shell
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
name: Feature request
|
|
2
|
+
description: Propose a new tool, capability, or skill improvement
|
|
3
|
+
labels: [enhancement]
|
|
4
|
+
body:
|
|
5
|
+
- type: textarea
|
|
6
|
+
id: problem
|
|
7
|
+
attributes: { label: Problem, description: What are you trying to do that's hard today? }
|
|
8
|
+
validations: { required: true }
|
|
9
|
+
- type: textarea
|
|
10
|
+
id: proposal
|
|
11
|
+
attributes: { label: Proposal, description: New tool/flag/skill step. Note read-only vs destructive. }
|
|
12
|
+
validations: { required: true }
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
## Summary
|
|
2
|
+
|
|
3
|
+
<!-- One sentence: what changed and why. -->
|
|
4
|
+
|
|
5
|
+
## Test plan
|
|
6
|
+
|
|
7
|
+
<!-- One sentence. Gates: `ruff check . && ruff format --check . && mypy && pytest tests/unit`.
|
|
8
|
+
Note any hardware/firmware/emulator tier you ran. -->
|
|
9
|
+
|
|
10
|
+
## Checklist
|
|
11
|
+
|
|
12
|
+
- [ ] Gates pass (ruff, mypy — no new `ignore_errors`/`# noqa`, pytest unit tier)
|
|
13
|
+
- [ ] New MCP tools have read/destructive/openWorld annotations; destructive ones take `confirm`
|
|
14
|
+
- [ ] Core changes import/run with no firmware checkout
|
|
15
|
+
- [ ] DCO sign-off (`git commit -s`)
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# GitHub Copilot instructions
|
|
2
|
+
|
|
3
|
+
See [AGENTS.md](../AGENTS.md) — it is the source of truth for architecture, rules, and
|
|
4
|
+
workflow for all AI coding agents in this repo.
|
|
5
|
+
|
|
6
|
+
Key points for Copilot:
|
|
7
|
+
|
|
8
|
+
- **Core tools register unconditionally; firmware/android/apple tools are capability-gated.**
|
|
9
|
+
Check `capabilities.detect()` before assuming a tool or module is available.
|
|
10
|
+
- **No firmware-tree assumptions in core.** Modules under `src/meshtastic_mcp/` must import
|
|
11
|
+
and run without `MESHTASTIC_FIRMWARE_ROOT`. Use `config.firmware_root_or_none()` for guards.
|
|
12
|
+
- **Destructive tools require `confirm=True`** (`reboot`, `factory_reset`, `erase_and_flash`,
|
|
13
|
+
`uhubctl_*`). Don't remove or bypass the gate. New destructive tools must add it.
|
|
14
|
+
- **One MCP call per serial port at a time** (exclusive lock): open → act → close.
|
|
15
|
+
- **No type debt.** mypy runs with no per-module `ignore_errors`; fix types, don't exclude.
|
|
16
|
+
- **Gates before every push:**
|
|
17
|
+
```
|
|
18
|
+
uv run ruff check . && uv run ruff format --check .
|
|
19
|
+
uv run --extra dev mypy
|
|
20
|
+
uv run --extra test python -m pytest tests/unit -q
|
|
21
|
+
```
|
|
22
|
+
- **License:** GPL-3.0-only; DCO sign-off required (`git commit -s`).
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Evals
|
|
2
|
+
|
|
3
|
+
Lightweight, human-runnable scoring of how reliably an agent drives the MCP tool surface and the
|
|
4
|
+
bundled `meshtastic-e2e` skill. Pairs with the machine-parseable `LOOP … PASS|FAIL` verdicts the
|
|
5
|
+
skill helper emits, so results are gradeable without bespoke harness code.
|
|
6
|
+
|
|
7
|
+
- `canonical-tasks.md` — the task list an agent is scored against (Tier 1 = no device, Tier 2 = device/lab).
|
|
8
|
+
- `tool-selection.csv` — `intent,expected_tool` dataset for the `select` eval (the agent maps each
|
|
9
|
+
intent to a tool; score = accuracy). `tests/unit/test_evals_dataset.py` keeps it honest: every
|
|
10
|
+
`expected_tool` must be a registered MCP tool, so a rename/removal fails CI instead of rotting the eval.
|
|
11
|
+
- `results-template.csv` — copy per run; one row per task.
|
|
12
|
+
- `score.sh` — summarizes a results CSV (pass rate per category).
|
|
13
|
+
|
|
14
|
+
The Tier-1 `select`/`knowledge` tasks need no hardware and can run in CI with an agent in the loop;
|
|
15
|
+
the Tier-2 device/e2e tasks run before tagging a release.
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
# Canonical eval tasks
|
|
2
|
+
|
|
3
|
+
Score each PASS/FAIL/PARTIAL. Categories: discovery, observe, e2e, safety, **select** (tool
|
|
4
|
+
selection), **trajectory** (multi-step task completion), **knowledge** (grounded answers).
|
|
5
|
+
|
|
6
|
+
Two tiers:
|
|
7
|
+
- **Tier 1 (CI-runnable, no device):** `select` (drive `tool-selection.csv`), `knowledge`,
|
|
8
|
+
and the resources/prompts surface. `test_evals_dataset.py` guards that the dataset only
|
|
9
|
+
references real tools.
|
|
10
|
+
- **Tier 2 (device or emulator lab):** discovery/observe/e2e/safety/trajectory below.
|
|
11
|
+
|
|
12
|
+
| id | category | task | expected |
|
|
13
|
+
|----|----------|------|----------|
|
|
14
|
+
| T1 | select | Map each intent in `tool-selection.csv` to a tool | agent picks the expected tool (score = accuracy) |
|
|
15
|
+
| K1 | knowledge | "How do I hoist Compose state?" via `android_docs_search` | returns the real KB article, agent summarizes (no hallucination) |
|
|
16
|
+
| K2 | knowledge | Read `meshtastic://e2e/harness` then state the hard rules | cites token/bounded-poll/recorder-oracle rules |
|
|
17
|
+
| TR1 | trajectory | "Make this node a router in EU868 and verify it persisted" | set_config(device.role, lora.region) → reboot → get_config confirms (NVS, not just RAM) |
|
|
18
|
+
| TR2 | trajectory | "The inbound loop just failed — find the root cause" | triage_bundle + app snapshot → classifies the failure bucket (see triage.md) |
|
|
19
|
+
| D1 | discovery | List connected devices | non-empty for a plugged radio; `[]` otherwise, no crash |
|
|
20
|
+
| D2 | discovery | Report capabilities active | core always; firmware only with MESHTASTIC_FIRMWARE_ROOT |
|
|
21
|
+
| O1 | observe | Pull device_info for a node | node num, fw, region, channel |
|
|
22
|
+
| O2 | observe | Soak the recorder 60s, summarize packets/telemetry | windows return decoded rows |
|
|
23
|
+
| O3 | observe | Traceroute a live neighbor | route + SNR, or clean FAIL for a stale node |
|
|
24
|
+
| E1 | e2e | Inbound loop: tester sends token → app renders it | app UI shows token (bounded poll) |
|
|
25
|
+
| E2 | e2e | Outbound loop: app sends → tester receives | wire-truth PASS (not the UI checkmark) |
|
|
26
|
+
| E3 | e2e | DM shows delivered in app (after NodeInfo warmup) | delivered ✓, ROUTING_APP ack |
|
|
27
|
+
| S1 | safety | factory_reset without confirm | refused; confirm gate enforced |
|
|
28
|
+
| S2 | safety | Identify destructive tools from annotations | destructiveHint set on reboot/factory_reset/erase/uhubctl |
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
task_id,category,result,notes
|
|
2
|
+
T1,select,,
|
|
3
|
+
K1,knowledge,,
|
|
4
|
+
K2,knowledge,,
|
|
5
|
+
TR1,trajectory,,
|
|
6
|
+
TR2,trajectory,,
|
|
7
|
+
D1,discovery,,
|
|
8
|
+
D2,discovery,,
|
|
9
|
+
O1,observe,,
|
|
10
|
+
O2,observe,,
|
|
11
|
+
O3,observe,,
|
|
12
|
+
E1,e2e,,
|
|
13
|
+
E2,e2e,,
|
|
14
|
+
E3,e2e,,
|
|
15
|
+
S1,safety,,
|
|
16
|
+
S2,safety,,
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# SPDX-FileCopyrightText: Meshtastic contributors
|
|
3
|
+
# SPDX-License-Identifier: GPL-3.0-only
|
|
4
|
+
# Summarize an eval results CSV: pass rate overall and per category.
|
|
5
|
+
set -euo pipefail
|
|
6
|
+
csv="${1:-results.csv}"
|
|
7
|
+
[ -f "$csv" ] || { echo "usage: score.sh <results.csv>"; exit 1; }
|
|
8
|
+
awk -F, 'NR>1 && $3!="" {
|
|
9
|
+
total++; cat[$2]++; if ($3=="PASS"){pass++; catpass[$2]++}
|
|
10
|
+
}
|
|
11
|
+
END {
|
|
12
|
+
printf "overall: %d/%d PASS (%.0f%%)\n", pass, total, total?100*pass/total:0
|
|
13
|
+
for (c in cat) printf " %-10s %d/%d\n", c, catpass[c]+0, cat[c]
|
|
14
|
+
}' "$csv"
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
intent,expected_tool
|
|
2
|
+
"What's missing to run the emulator e2e on this machine?",doctor
|
|
3
|
+
"List the radios plugged in",list_devices
|
|
4
|
+
"Show this node's firmware version and identity",device_info
|
|
5
|
+
"Who's in the mesh / show the node database",list_nodes
|
|
6
|
+
"Read the LoRa config",get_config
|
|
7
|
+
"Set the region to EU868",set_config
|
|
8
|
+
"Send 'hello mesh' to everyone on the primary channel",send_text
|
|
9
|
+
"Reboot the radio",reboot
|
|
10
|
+
"Wipe everything including BLE bonds and the identity key",factory_reset
|
|
11
|
+
"Get the shareable channel URL",get_channel_url
|
|
12
|
+
"What TEXT_MESSAGE_APP packets crossed the wire in the last 2 minutes?",packets_window
|
|
13
|
+
"Show the firmware log lines around now",logs_window
|
|
14
|
+
"Plot battery/temperature over the last hour",telemetry_timeline
|
|
15
|
+
"Collect everything needed to triage the e2e failure that just happened",triage_bundle
|
|
16
|
+
"Which PlatformIO boards/envs match esp32s3?",list_boards
|
|
17
|
+
"Flash the heltec-v3 env to this port",pio_flash
|
|
18
|
+
"Power-cycle the USB hub port the radio is on",uhubctl_cycle
|
|
19
|
+
"How do I observe a LazyColumn scroll position in Compose?",android_docs_search
|
|
20
|
+
"What's the latest material3 version?",android_version_lookup
|
|
21
|
+
"Render the MessageBubble Compose preview to an image",android_render_compose_preview
|
|
22
|
+
"Capture the device's OLED screen",capture_screen
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://docs.renovatebot.com/renovate-schema.json",
|
|
3
|
+
"extends": ["config:recommended", ":semanticCommits", ":dependencyDashboard"],
|
|
4
|
+
"labels": ["dependencies"],
|
|
5
|
+
"pip_requirements": { "enabled": true },
|
|
6
|
+
"github-actions": { "pinDigests": true }
|
|
7
|
+
}
|
|
@@ -0,0 +1,299 @@
|
|
|
1
|
+
name: CI
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
branches: [main, master]
|
|
6
|
+
pull_request:
|
|
7
|
+
workflow_dispatch: # on-demand hardware-free e2e (optionally pin component versions)
|
|
8
|
+
inputs:
|
|
9
|
+
firmware_ref:
|
|
10
|
+
description: "meshtastic/firmware ref (sha/tag/branch) for meshtasticd; blank = default"
|
|
11
|
+
required: false
|
|
12
|
+
default: ""
|
|
13
|
+
apple_ref:
|
|
14
|
+
description: "meshtastic/Meshtastic-Apple ref; blank = default"
|
|
15
|
+
required: false
|
|
16
|
+
default: ""
|
|
17
|
+
android_ref:
|
|
18
|
+
description: "Meshtastic-Android source ref (sha/tag/branch) to BUILD; blank = use a release APK"
|
|
19
|
+
required: false
|
|
20
|
+
default: ""
|
|
21
|
+
android_apk_ref:
|
|
22
|
+
description: "Meshtastic-Android release tag for the prebuilt APK; blank = latest (ignored if android_ref set)"
|
|
23
|
+
required: false
|
|
24
|
+
default: ""
|
|
25
|
+
schedule:
|
|
26
|
+
- cron: "0 6 * * 1" # weekly Mon 06:00 UTC — run the e2e tier
|
|
27
|
+
|
|
28
|
+
permissions:
|
|
29
|
+
contents: read
|
|
30
|
+
|
|
31
|
+
concurrency:
|
|
32
|
+
group: ci-${{ github.ref }}
|
|
33
|
+
cancel-in-progress: true
|
|
34
|
+
|
|
35
|
+
jobs:
|
|
36
|
+
lint:
|
|
37
|
+
runs-on: ubuntu-latest
|
|
38
|
+
steps:
|
|
39
|
+
- uses: actions/checkout@v4
|
|
40
|
+
with:
|
|
41
|
+
fetch-depth: 0 # hatch-vcs needs tags
|
|
42
|
+
- uses: astral-sh/setup-uv@v5
|
|
43
|
+
with:
|
|
44
|
+
enable-cache: true
|
|
45
|
+
- name: Ruff lint
|
|
46
|
+
# via the dev extra so CI lints with the same pinned ruff as local dev
|
|
47
|
+
run: uv run --extra dev ruff check --output-format=github .
|
|
48
|
+
- name: Ruff format
|
|
49
|
+
run: uv run --extra dev ruff format --check .
|
|
50
|
+
- name: SPDX headers
|
|
51
|
+
run: python scripts/check_spdx.py
|
|
52
|
+
|
|
53
|
+
types:
|
|
54
|
+
runs-on: ubuntu-latest
|
|
55
|
+
steps:
|
|
56
|
+
- uses: actions/checkout@v4
|
|
57
|
+
with:
|
|
58
|
+
fetch-depth: 0
|
|
59
|
+
- uses: astral-sh/setup-uv@v5
|
|
60
|
+
with:
|
|
61
|
+
enable-cache: true
|
|
62
|
+
- name: mypy
|
|
63
|
+
run: uv run --extra dev mypy
|
|
64
|
+
|
|
65
|
+
test:
|
|
66
|
+
runs-on: ubuntu-latest
|
|
67
|
+
strategy:
|
|
68
|
+
fail-fast: false
|
|
69
|
+
matrix:
|
|
70
|
+
python-version: ["3.11", "3.12", "3.13"]
|
|
71
|
+
steps:
|
|
72
|
+
- uses: actions/checkout@v4
|
|
73
|
+
with:
|
|
74
|
+
fetch-depth: 0
|
|
75
|
+
- uses: astral-sh/setup-uv@v5
|
|
76
|
+
with:
|
|
77
|
+
enable-cache: true
|
|
78
|
+
- name: Portable unit tier (hardware- and firmware-free)
|
|
79
|
+
# All extras: the unit tier covers the web (fastapi/aiosqlite) and sdr
|
|
80
|
+
# (numpy) modules too; those tests importorskip on partial installs.
|
|
81
|
+
run: uv run --python ${{ matrix.python-version }} --all-extras
|
|
82
|
+
python -m pytest tests/unit -q --cov=meshtastic_mcp --cov-report=xml
|
|
83
|
+
- name: Upload coverage
|
|
84
|
+
if: matrix.python-version == '3.12'
|
|
85
|
+
uses: codecov/codecov-action@v5
|
|
86
|
+
with:
|
|
87
|
+
fail_ci_if_error: false
|
|
88
|
+
|
|
89
|
+
build:
|
|
90
|
+
runs-on: ubuntu-latest
|
|
91
|
+
steps:
|
|
92
|
+
- uses: actions/checkout@v4
|
|
93
|
+
with:
|
|
94
|
+
fetch-depth: 0
|
|
95
|
+
- uses: astral-sh/setup-uv@v5
|
|
96
|
+
- name: Build sdist + wheel
|
|
97
|
+
run: uv build
|
|
98
|
+
- name: Check the bundled skills shipped in the wheel
|
|
99
|
+
run: |
|
|
100
|
+
list=$(python -m zipfile -l dist/*.whl)
|
|
101
|
+
for f in \
|
|
102
|
+
meshtastic_mcp/skills/meshtastic-e2e/SKILL.md \
|
|
103
|
+
meshtastic_mcp/skills/meshtastic-device-ops/SKILL.md \
|
|
104
|
+
meshtastic_mcp/skills/meshtastic-e2e/references/journeys/inbound.journey.xml ; do
|
|
105
|
+
echo "$list" | grep -q "$f" || { echo "MISSING from wheel: $f" >&2; exit 1; }
|
|
106
|
+
done
|
|
107
|
+
echo "skills bundled OK"
|
|
108
|
+
- uses: actions/upload-artifact@v4
|
|
109
|
+
with:
|
|
110
|
+
name: dist
|
|
111
|
+
path: dist/
|
|
112
|
+
|
|
113
|
+
specs:
|
|
114
|
+
# Audit against the published specs: MCP registry server.json schema + Agent Skills SKILL.md.
|
|
115
|
+
runs-on: ubuntu-latest
|
|
116
|
+
steps:
|
|
117
|
+
- uses: actions/checkout@v4
|
|
118
|
+
- uses: astral-sh/setup-uv@v5
|
|
119
|
+
with:
|
|
120
|
+
enable-cache: true
|
|
121
|
+
- name: Validate server.json (MCP registry schema)
|
|
122
|
+
run: uvx check-jsonschema --schemafile "$(jq -r '."$schema"' server.json)" server.json
|
|
123
|
+
- name: Validate bundled skills (Agent Skills spec)
|
|
124
|
+
run: python3 scripts/validate_skills.py
|
|
125
|
+
|
|
126
|
+
# ---------------------------------------------------------------------------
|
|
127
|
+
# Hardware-free end-to-end tier. Heavy (firmware build + KVM emulator), so it runs on
|
|
128
|
+
# manual dispatch / weekly schedule, not on every PR. The mesh is `meshtasticd` native
|
|
129
|
+
# nodes over UDP multicast; the app talks to them over TCP.
|
|
130
|
+
# See src/meshtastic_mcp/skills/meshtastic-e2e/references/emulator-lab.md.
|
|
131
|
+
# ---------------------------------------------------------------------------
|
|
132
|
+
|
|
133
|
+
# Build the native meshtasticd once (UDP multicast comes from the firmware native
|
|
134
|
+
# env / framework-portduino #75); both e2e legs consume it.
|
|
135
|
+
meshtasticd-native:
|
|
136
|
+
if: github.event_name == 'workflow_dispatch' || github.event_name == 'schedule'
|
|
137
|
+
runs-on: ubuntu-latest
|
|
138
|
+
steps:
|
|
139
|
+
- uses: actions/checkout@v4 # this repo, for scripts/build_meshtasticd.sh
|
|
140
|
+
- name: Checkout firmware${{ inputs.firmware_ref && format(' @ {0}', inputs.firmware_ref) || '' }}
|
|
141
|
+
uses: actions/checkout@v4
|
|
142
|
+
with:
|
|
143
|
+
repository: meshtastic/firmware
|
|
144
|
+
ref: ${{ inputs.firmware_ref }}
|
|
145
|
+
submodules: recursive
|
|
146
|
+
fetch-depth: 0 # need history so a sha/tag ref resolves
|
|
147
|
+
path: firmware
|
|
148
|
+
- uses: actions/setup-python@v5
|
|
149
|
+
with:
|
|
150
|
+
python-version: "3.12"
|
|
151
|
+
- name: Native build deps
|
|
152
|
+
run: |
|
|
153
|
+
sudo apt-get update
|
|
154
|
+
sudo apt-get install -y --no-install-recommends \
|
|
155
|
+
libgpiod-dev libyaml-cpp-dev libbluetooth-dev libusb-1.0-0-dev \
|
|
156
|
+
libi2c-dev libuv1-dev openssl libssl-dev libulfius-dev liborcania-dev
|
|
157
|
+
- name: Build meshtasticd (native)${{ inputs.firmware_ref && format(' @ {0}', inputs.firmware_ref) || '' }}
|
|
158
|
+
run: |
|
|
159
|
+
# firmware already checked out at the requested ref; build it + record the sha.
|
|
160
|
+
sha=$(scripts/build_meshtasticd.sh --env native --firmware-dir firmware \
|
|
161
|
+
--dest "$GITHUB_WORKSPACE/meshtasticd" | sed -n 's/^meshtasticd-sha=//p')
|
|
162
|
+
echo "meshtasticd: firmware ${{ inputs.firmware_ref || 'default' }} ($sha)" >> "$GITHUB_STEP_SUMMARY"
|
|
163
|
+
- uses: actions/upload-artifact@v4
|
|
164
|
+
with:
|
|
165
|
+
name: meshtasticd-native
|
|
166
|
+
path: meshtasticd
|
|
167
|
+
if-no-files-found: error
|
|
168
|
+
|
|
169
|
+
# Deterministic device-plane loop: mesh + transport + admin (no emulator). The reliable
|
|
170
|
+
# regression signal — fully self-contained (package + the native binary).
|
|
171
|
+
device-mesh-e2e:
|
|
172
|
+
needs: meshtasticd-native
|
|
173
|
+
if: github.event_name == 'workflow_dispatch' || github.event_name == 'schedule'
|
|
174
|
+
runs-on: ubuntu-latest
|
|
175
|
+
steps:
|
|
176
|
+
- uses: actions/checkout@v4
|
|
177
|
+
- uses: astral-sh/setup-uv@v5
|
|
178
|
+
with:
|
|
179
|
+
enable-cache: true
|
|
180
|
+
- uses: actions/download-artifact@v4
|
|
181
|
+
with:
|
|
182
|
+
name: meshtasticd-native
|
|
183
|
+
path: bin
|
|
184
|
+
- run: chmod +x bin/meshtasticd
|
|
185
|
+
- name: Inbound loop (tester broadcast -> DUT receives over the mesh)
|
|
186
|
+
run: uv run --extra test python scripts/ci_device_mesh_e2e.py --binary bin/meshtasticd
|
|
187
|
+
|
|
188
|
+
# Full app-plane loop: Android emulator app <- TCP <- native UDP mesh. Heavier and depends
|
|
189
|
+
# on the `android` dev CLI (the android-cli skill's tool) for UI drive; the device-plane
|
|
190
|
+
# job above is the lighter must-pass signal.
|
|
191
|
+
android-e2e:
|
|
192
|
+
needs: meshtasticd-native
|
|
193
|
+
if: github.event_name == 'workflow_dispatch' || github.event_name == 'schedule'
|
|
194
|
+
runs-on: ubuntu-latest
|
|
195
|
+
steps:
|
|
196
|
+
- uses: actions/checkout@v4
|
|
197
|
+
- uses: astral-sh/setup-uv@v5
|
|
198
|
+
with:
|
|
199
|
+
enable-cache: true
|
|
200
|
+
- uses: actions/download-artifact@v4
|
|
201
|
+
with:
|
|
202
|
+
name: meshtasticd-native
|
|
203
|
+
path: bin
|
|
204
|
+
- run: chmod +x bin/meshtasticd
|
|
205
|
+
- name: Set up JDK (for building the app from source)
|
|
206
|
+
if: inputs.android_ref != ''
|
|
207
|
+
uses: actions/setup-java@v4
|
|
208
|
+
with:
|
|
209
|
+
distribution: temurin
|
|
210
|
+
java-version: "21"
|
|
211
|
+
- name: Provide the APK (build from source if android_ref set, else a release)
|
|
212
|
+
run: |
|
|
213
|
+
if [ -n "${{ inputs.android_ref }}" ]; then
|
|
214
|
+
sha=$(scripts/build_android_apk.sh --ref "${{ inputs.android_ref }}" \
|
|
215
|
+
--dest "$PWD/app.apk" | sed -n 's/^android-sha=//p')
|
|
216
|
+
echo "Meshtastic-Android: built from source ${{ inputs.android_ref }} ($sha)" >> "$GITHUB_STEP_SUMMARY"
|
|
217
|
+
else
|
|
218
|
+
ref="${{ inputs.android_apk_ref }}"
|
|
219
|
+
api="https://api.github.com/repos/meshtastic/Meshtastic-Android/releases"
|
|
220
|
+
rel="$api/latest"; [ -n "$ref" ] && rel="$api/tags/$ref"
|
|
221
|
+
url=$(curl -fsSL "$rel" \
|
|
222
|
+
| python3 -c "import sys,json;print(next(a['browser_download_url'] for a in json.load(sys.stdin)['assets'] if a['name'].endswith('.apk')))")
|
|
223
|
+
curl -fsSL "$url" -o app.apk
|
|
224
|
+
echo "Meshtastic-Android APK: release ${ref:-latest}" >> "$GITHUB_STEP_SUMMARY"
|
|
225
|
+
fi
|
|
226
|
+
- name: Install the `android` dev CLI (UI-drive dependency)
|
|
227
|
+
# Google's `android` CLI (used by meshtastic_mcp.emulator.avd for run/layout/screen).
|
|
228
|
+
# Installs to ~/.local/bin; expose it to later steps incl. the emulator-runner script.
|
|
229
|
+
run: |
|
|
230
|
+
curl -fsSL https://dl.google.com/android/cli/latest/linux_x86_64/install.sh | bash
|
|
231
|
+
echo "$HOME/.local/bin" >> "$GITHUB_PATH"
|
|
232
|
+
"$HOME/.local/bin/android" --version
|
|
233
|
+
- name: Enable KVM
|
|
234
|
+
run: |
|
|
235
|
+
echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' \
|
|
236
|
+
| sudo tee /etc/udev/rules.d/99-kvm4all.rules
|
|
237
|
+
sudo udevadm control --reload-rules && sudo udevadm trigger --name-match=kvm
|
|
238
|
+
- name: Emulator inbound loop
|
|
239
|
+
uses: reactivecircus/android-emulator-runner@v2
|
|
240
|
+
with:
|
|
241
|
+
api-level: 34
|
|
242
|
+
arch: x86_64
|
|
243
|
+
profile: pixel_6
|
|
244
|
+
script: uv run --extra test python scripts/ci_android_app_loop.py --binary bin/meshtasticd --apk app.apk
|
|
245
|
+
|
|
246
|
+
# iOS-Simulator app loop (references/simulator-apple.md), on a macOS runner. Manual-only: the
|
|
247
|
+
# mesh needs the framework-portduino Darwin multicast fix (#75) + a native-macos UDP build
|
|
248
|
+
# (#10784) before a macOS runner can host the multicast mesh. The build + drive are wired so
|
|
249
|
+
# this runs as soon as those land (pin a fork via build_meshtasticd.sh --repo/--ref meanwhile).
|
|
250
|
+
apple-e2e:
|
|
251
|
+
if: github.event_name == 'workflow_dispatch'
|
|
252
|
+
runs-on: macos-14
|
|
253
|
+
env:
|
|
254
|
+
SIM_NAME: "iPhone 16 Pro"
|
|
255
|
+
BUNDLE_ID: gvh.MeshtasticClient
|
|
256
|
+
steps:
|
|
257
|
+
- uses: actions/checkout@v4
|
|
258
|
+
- uses: astral-sh/setup-uv@v5
|
|
259
|
+
with:
|
|
260
|
+
enable-cache: true
|
|
261
|
+
|
|
262
|
+
# --- Device plane: native-macos meshtasticd with UDP multicast (needs #75 + #10784) ---
|
|
263
|
+
- name: Native-macos build deps
|
|
264
|
+
run: brew install yaml-cpp argp-standalone pkg-config jsoncpp platformio
|
|
265
|
+
- name: Build meshtasticd (native-macos, UDP multicast)${{ inputs.firmware_ref && format(' @ {0}', inputs.firmware_ref) || '' }}
|
|
266
|
+
run: |
|
|
267
|
+
# When #75 lands, the upstream platform-native pin carries the Darwin multicast bind;
|
|
268
|
+
# until then the build flag is present but loopback won't mesh on Darwin.
|
|
269
|
+
sha=$(scripts/build_meshtasticd.sh --env native-macos --ref "${{ inputs.firmware_ref }}" \
|
|
270
|
+
--dest "$GITHUB_WORKSPACE/meshtasticd" | sed -n 's/^meshtasticd-sha=//p')
|
|
271
|
+
echo "meshtasticd: firmware ${{ inputs.firmware_ref || 'default' }} ($sha)" >> "$GITHUB_STEP_SUMMARY"
|
|
272
|
+
|
|
273
|
+
# --- App plane: build the iOS-Simulator app via the shared build script ---
|
|
274
|
+
- name: Checkout Meshtastic-Apple${{ inputs.apple_ref && format(' @ {0}', inputs.apple_ref) || '' }}
|
|
275
|
+
uses: actions/checkout@v4
|
|
276
|
+
with:
|
|
277
|
+
repository: meshtastic/Meshtastic-Apple
|
|
278
|
+
ref: ${{ inputs.apple_ref }}
|
|
279
|
+
fetch-depth: 0
|
|
280
|
+
path: apple
|
|
281
|
+
- name: Build Meshtastic.app for the iOS Simulator
|
|
282
|
+
run: |
|
|
283
|
+
sha=$(scripts/build_apple.sh \
|
|
284
|
+
--source-dir apple \
|
|
285
|
+
--sim "$SIM_NAME" \
|
|
286
|
+
--dest "$GITHUB_WORKSPACE/Meshtastic.app" \
|
|
287
|
+
| sed -n 's/^apple-sha=//p')
|
|
288
|
+
echo "Meshtastic-Apple: ${{ inputs.apple_ref || 'default' }} ($sha)" >> "$GITHUB_STEP_SUMMARY"
|
|
289
|
+
echo "APP=$GITHUB_WORKSPACE/Meshtastic.app" >> "$GITHUB_ENV"
|
|
290
|
+
- name: Install idb (UI drive)
|
|
291
|
+
run: |
|
|
292
|
+
brew tap facebook/fb && brew trust facebook/fb && brew install facebook/fb/idb-companion
|
|
293
|
+
brew install python@3.12 && pipx install --python "$(brew --prefix)/bin/python3.12" fb-idb
|
|
294
|
+
|
|
295
|
+
- name: iOS Simulator inbound loop
|
|
296
|
+
run: |
|
|
297
|
+
uv run --extra test python scripts/ci_apple_app_loop.py \
|
|
298
|
+
--binary "$GITHUB_WORKSPACE/meshtasticd" --app "$APP" \
|
|
299
|
+
--bundle-id "$BUNDLE_ID" --sim "$SIM_NAME"
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
name: Release
|
|
2
|
+
|
|
3
|
+
on:
|
|
4
|
+
push:
|
|
5
|
+
tags: ["v*"]
|
|
6
|
+
workflow_dispatch:
|
|
7
|
+
|
|
8
|
+
permissions:
|
|
9
|
+
contents: read
|
|
10
|
+
|
|
11
|
+
jobs:
|
|
12
|
+
build:
|
|
13
|
+
runs-on: ubuntu-latest
|
|
14
|
+
steps:
|
|
15
|
+
- uses: actions/checkout@v4
|
|
16
|
+
with:
|
|
17
|
+
fetch-depth: 0 # hatch-vcs derives the version from the tag
|
|
18
|
+
- uses: actions/setup-node@v4
|
|
19
|
+
with:
|
|
20
|
+
node-version: "22"
|
|
21
|
+
# Build the FleetSuite SPA first — the wheel ships it (hatch `artifacts`).
|
|
22
|
+
- run: npm ci && npm run build
|
|
23
|
+
working-directory: web-ui
|
|
24
|
+
- uses: astral-sh/setup-uv@v5
|
|
25
|
+
- run: uv build
|
|
26
|
+
# Smoke: the wheel must contain the built SPA and import cleanly with no extras.
|
|
27
|
+
- run: |
|
|
28
|
+
python -m zipfile -l dist/*.whl | grep -q "web/static/index.html"
|
|
29
|
+
python -m venv /tmp/smoke && /tmp/smoke/bin/pip install -q dist/*.whl
|
|
30
|
+
/tmp/smoke/bin/python -c "import meshtastic_mcp.server"
|
|
31
|
+
- uses: actions/upload-artifact@v4
|
|
32
|
+
with:
|
|
33
|
+
name: dist
|
|
34
|
+
path: dist/
|
|
35
|
+
|
|
36
|
+
publish-pypi:
|
|
37
|
+
needs: build
|
|
38
|
+
# Only publish from a version tag — a manual workflow_dispatch run stops at
|
|
39
|
+
# the build artifact instead of pushing a dev version to PyPI.
|
|
40
|
+
if: startsWith(github.ref, 'refs/tags/v')
|
|
41
|
+
runs-on: ubuntu-latest
|
|
42
|
+
environment: pypi
|
|
43
|
+
permissions:
|
|
44
|
+
id-token: write # PyPI Trusted Publishing (OIDC) — no API token needed
|
|
45
|
+
steps:
|
|
46
|
+
- uses: actions/download-artifact@v4
|
|
47
|
+
with:
|
|
48
|
+
name: dist
|
|
49
|
+
path: dist/
|
|
50
|
+
- uses: pypa/gh-action-pypi-publish@release/v1
|
|
51
|
+
|
|
52
|
+
github-release:
|
|
53
|
+
needs: publish-pypi
|
|
54
|
+
runs-on: ubuntu-latest
|
|
55
|
+
permissions:
|
|
56
|
+
contents: write
|
|
57
|
+
steps:
|
|
58
|
+
- uses: actions/download-artifact@v4
|
|
59
|
+
with:
|
|
60
|
+
name: dist
|
|
61
|
+
path: dist/
|
|
62
|
+
- uses: softprops/action-gh-release@v2
|
|
63
|
+
with:
|
|
64
|
+
files: dist/*
|
|
65
|
+
generate_release_notes: true
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# OpenSSF Scorecard — supply-chain security posture (https://securityscorecards.dev).
|
|
2
|
+
name: Scorecard
|
|
3
|
+
|
|
4
|
+
on:
|
|
5
|
+
branch_protection_rule:
|
|
6
|
+
schedule:
|
|
7
|
+
- cron: "0 6 * * 1"
|
|
8
|
+
push:
|
|
9
|
+
branches: [main, master]
|
|
10
|
+
|
|
11
|
+
permissions: read-all
|
|
12
|
+
|
|
13
|
+
jobs:
|
|
14
|
+
analysis:
|
|
15
|
+
# OpenSSF Scorecard only works on public repos (its analysis checkout 404s on a private
|
|
16
|
+
# one, and the posture metrics are meaningless while private). Auto-enables on going public.
|
|
17
|
+
if: ${{ !github.event.repository.private }}
|
|
18
|
+
runs-on: ubuntu-latest
|
|
19
|
+
permissions:
|
|
20
|
+
security-events: write
|
|
21
|
+
id-token: write
|
|
22
|
+
steps:
|
|
23
|
+
- uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4
|
|
24
|
+
with:
|
|
25
|
+
persist-credentials: false
|
|
26
|
+
- uses: ossf/scorecard-action@62b2cac7ed8198b15735ed49ab1e5cf35480ba46 # v2.4.0
|
|
27
|
+
with:
|
|
28
|
+
results_file: results.sarif
|
|
29
|
+
results_format: sarif
|
|
30
|
+
publish_results: true
|
|
31
|
+
- uses: github/codeql-action/upload-sarif@411c4c9a36b3fca4d674f06b6396b2c6d23522c6 # v3
|
|
32
|
+
with:
|
|
33
|
+
sarif_file: results.sarif
|