Skip to content

Releases

v0.9.0

Choose a tag to compare

@github-actions github-actions released this 17 Nov 12:37
eb436b3

Changed

  • The PostHog MCP SDK path no longer sends tool argument values ($mcp_parameters), tool results ($mcp_response), error text ($mcp_error_message) or $exception events. A before_send filter removes them, so remote events hold what the README lists (#34, thanks electron-rare).
  • Agent-written intent text (the injected context argument) and get_more_tools missing-capability reports are off by default. Set PLATFORMIO_MCP_ANALYTICS_INTENT=1 to send them. Without it, $mcp_intent is Invoking <tool name>.

v0.8.0

Choose a tag to compare

@github-actions github-actions released this 16 Nov 13:39
5d19c5e

Added

  • pio_decode_backtrace unwinds RISC-V ESP32 panics (C2, C3, C5, C6, C61, H2, H4, P4, S31) into a full call chain. The register dump and Stack memory: block go to the toolchain's riscv32-esp-elf-gdb through Espressif's esp-idf-panic-decoder, now a dependency. pio_flash_and_verify gets the same decoding on a crash. Results carry arch, method (gdb_unwind, stack_scan or addr2line) and the crashed core. Prompted by Jason2866's ESP-Decoder; see docs/adr/0001-riscv-unwinding-via-esp-idf-panic-decoder.md for why the code comes from Espressif.
  • Without GDB, RISC-V decoding symbolizes MEPC, RA and stack words that point into code (role: stack_scan), and the summary gives the command that installs GDB.
  • README section on pioarduino: tested tools, the Python 3.10 to 3.14 requirement, and the ESP32-C2 hybrid-compile rebuild.
  • Multi-core RISC-V panic output is cut down to the core named in Core N panic'ed. A serial buffer holding several crashes decodes the last one, with that crash's registers, cause and reset reason only.

Fixed

  • pio_partition_table finds the framework's default partition CSV on pioarduino, which splits the Arduino framework into framework-arduinoespressif32 and framework-arduinoespressif32-libs.
  • A0 in a RISC-V register dump is no longer reported as a return address. It is the first function argument on RISC-V and usually points at data.

Changed

  • Release workflow uses actions/upload-artifact v7 and actions/download-artifact v8.

Security

  • opentelemetry-api 1.45.2 in the lock file fixes quadratic-time traceparent parsing that allowed denial of service (Dependabot alert 5).

v0.7.0

Choose a tag to compare

@github-actions github-actions released this 14 Nov 13:29
87b7ae5

Added

  • pio_system_info lists globally installed platforms and tool packages (name, version, path), so an agent can inspect the toolchain without a project.
  • pio_build accepts envs=[...] to build several environments in one call. Envs build one after another, a failing env does not stop the rest, and the result reports status, errors and memory per env.

Changed

  • pio_monitor_read returns ok:false with error: pattern_timeout (or session_closed) when wait_for never matches, with the lines seen so far and a cursor to continue from. Reads without wait_for are unchanged.

v0.6.2

Choose a tag to compare

@github-actions github-actions released this 10 Nov 19:57
133dd45

Changed

  • Enable PostHog SDK intent context and missing-capability reporting using the release ingestion key by default, preserving token overrides, opt-outs, and a single remote sender.
  • Ask agents to describe goals in context and report unsupported capabilities through get_more_tools; document agent participation and context delivery.

v0.6.1

Choose a tag to compare

@github-actions github-actions released this 10 Nov 19:31
f41d483

Added

  • Report available model and reasoning-effort metadata with provenance on both analytics paths, with explicit environment fallbacks. Expose the running release as platformio_mcp_version alongside $mcp_server_version.
  • Optional original prompt capture from explicit host metadata, disabled by default and bounded to 2,000 characters when users enable PLATFORMIO_MCP_CAPTURE_PROMPTS=1.
  • Codex marketplace and compatibility manifest, portable MCP configuration, and documented Claude/Codex plugin installation. Plugin installs bundle PlatformIO Core through the existing extra.
  • Enable the PostHog SDK's missing-capability reporting tool.

Fixed

  • Wait for the GDB prompt following the initial stop before accepting commands, preventing a delayed startup prompt from making a running command appear complete on macOS.

v0.6.0

Choose a tag to compare

@github-actions github-actions released this 10 Nov 18:58
550131e

Changed

  • Add the PostHog MCP SDK when POSTHOG_PROJECT_TOKEN is set and remote analytics are allowed. The built-in recorder retains the local log and custom endpoint while the SDK handles PostHog delivery, preventing duplicate events.
  • Allow PostHog SDK updates within >=7.86.6,<8.

Fixed

  • Explicitly enable SDK context capture and infer intent from registered tool names when agents omit context or send an empty value. Preserve non-empty agent context and label fallback intent as inferred.
  • Respect analytics opt-outs and CI before creating the SDK client. Importing the server no longer creates a PostHog client or emits a missing-token warning.
  • Flush and close the SDK client during normal shutdown, ignoring cleanup failures. Remove the SDK SIGTERM handler and forced process exit.

v0.5.0

Choose a tag to compare

@github-actions github-actions released this 10 Nov 16:32
602c095

Added

  • PostHog events carry $session_id (the per-process session), $mcp_source, $lib_version, and $mcp_protocol_version, so PostHog's MCP analytics Sessions tab and per-tool session counts work.
  • $mcp_initialize and $mcp_tools_list (with $mcp_listed_tool_names) go to PostHog once per process each. Tools listed and never called become visible.
  • Tool-call events keep the board and platform argument values when they are PlatformIO registry ids such as esp32dev or espressif32. Paths and URLs in those arguments are dropped. All other argument values stay out.

Changed

  • PostHog events go out through /batch/ in batches of up to 20 events or every 5 seconds, in place of one POST per event. Server shutdown flushes the open batch for up to 2 seconds. The local log and PLATFORMIO_MCP_ANALYTICS_URL are unchanged.

v0.4.1

Choose a tag to compare

@github-actions github-actions released this 09 Nov 15:57
59fb841

Changed

  • PostHog usage events are now $mcp_tool_call with PostHog's MCP property names ($mcp_tool_name, $mcp_is_error, $mcp_error_type, $mcp_duration_ms, $mcp_client_name, ...). PostHog's MCP analytics views now break calls down by tool and client. 0.4.0 sent the same data as tool_call.

v0.4.0

Choose a tag to compare

@github-actions github-actions released this 09 Nov 12:32
02eaae3

Added

  • Usage analytics: one JSON line per tool call in ~/.platformio-mcp/analytics/usage.jsonl with tool, ok, error code, duration, argument names, and MCP client. Argument values, paths, ports, and serial output are never recorded. PLATFORMIO_MCP_ANALYTICS=off disables it, and PLATFORMIO_MCP_ANALYTICS_URL also POSTs each event to your own endpoint.
  • Anonymous usage events to PostHog EU Cloud, keyed by a random install id with no person profile. Off under DO_NOT_TRACK=1, PLATFORMIO_MCP_ANALYTICS=local, or when CI is set. The first sending run prints a notice on stderr.
  • platformio.mcp stats summarises the usage log: calls, ok rate, and p50/p95 duration per tool, top errors, and clients.

Changed

  • Releases tag themselves: merging a pull request that bumps the version makes publish.yml create the vX.Y.Z tag, publish to PyPI, and create the GitHub release. A release no longer needs a separate PR or a manual tag push.

v0.3.1

Choose a tag to compare

@github-actions github-actions released this 09 Nov 10:47
fb0270e

Security

  • CI and release workflows now default the GITHUB_TOKEN to contents: read. Only the PyPI job (id-token: write) and the GitHub release job (contents: write) get more.