OpenSpec v1.3.1: Artifact Path & JSON Output Fixes

OpenSpec v1.3.1 fixes symlink handling in artifact paths, cleans up JSON output for AI agents, and silences telemetry errors in firewalled networks.

OpenSpec v1.3.1: Artifact Path & JSON Output Fixes

TL;DR

  • Symlinks and case-insensitive filesystems now handled correctly in artifact paths
  • JSON output no longer polluted with spinner text in stderr
  • PostHog telemetry errors silenced in firewalled networks

Fixed

  • Canonical artifact paths — Workflow artifact paths now resolve via native realpath, eliminating mismatches from symlinks and case-insensitive filesystems during apply and archive.
  • Glob apply instructions — Apply instructions with glob artifact outputs now resolve correctly; literal outputs are enforced as file paths.
  • Hidden main spec requirements — Requirements nested in fenced code blocks or otherwise hidden in main specs are now detected during validation.
  • Clean --json output — Spinner progress text no longer leaks into stderr when --json is passed, so AI agents parsing combined stdout/stderr can handle JSON reliably.
  • Silent telemetry in firewalled environments — PostHog network errors are now swallowed with 1s timeout and retries disabled, preventing PostHogFetchNetworkError in locked-down networks. Telemetry opt-out is documented in README, installation guide, and CLI reference.

Update: npm install openspec@1.3.1

Source: OpenSpec