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.
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
--jsonoutput — Spinner progress text no longer leaks into stderr when--jsonis 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
PostHogFetchNetworkErrorin locked-down networks. Telemetry opt-out is documented in README, installation guide, and CLI reference.
Update: npm install openspec@1.3.1
Source: OpenSpec