Release v0.5.0

Changelog

v0.5.0 (2026-04-17)

Linear document sync, project lifecycle management, and estimate/story points support.

New Features

• Linear document sync: Keep Linear documents in sync with local Markdown files via linear_doc_sync command
• Project lifecycle: Full project lifecycle support including archive/unarchive, updates, and milestones
• Estimate (story points): Support for estimate/story points field on issue create/update
• Issue activity history: View complete issue activity with linear_issue_activity tool
• Batch sync: sync-doc --all for batch syncing all configured document targets

Bug Fixes

• Fixed project name lookup for UUID-like project names
• Fixed milestone name lookup for view/update/delete operations
• Replaced 'order' with 'sortOrder' for ProjectMilestone queries
• Fixed sync-doc first-run check/run parity
• Fixed sync-doc drift detection and target matching
• Fixed project archive and update validation
• Fixed archived project resolution for project updates
• Fixed sync-doc marker position preservation when position is 'top'
• Fixed default limit for executeIssueActivity (now 25)

Improvements

• Reduced expensive Linear API issue reads
• Better CLI help for issue and project workflows
• Improved sync-doc examples and guidance
• Added promptSnippet to all Linear tools for consistent LLM context
• Removed redundant action lists from tool descriptions

Cleanup

• Removed planning artifacts and documentation files
• Stopped tracking plan files in git

v0.4.2 (2026-03-26)

Rate-limit resilience and API usage diagnostics release.

Bug Fixes

• Hardened issue update flow when post-mutation refresh is rate-limited
• Added explicit user-facing note when update succeeded but refresh is partial due to rate limits
• Fixed per-command API usage metric keying so usage deltas report correctly

Performance / API Usage

• Added short-lived in-memory caches for viewer, project list, team list, and team workflow states
• Added direct-ID fast paths for project/team resolution to avoid full list fetches

Diagnostics

• Added optional per-command usage summary output via PI_LINEAR_TOOLS_USAGE_SUMMARY=true
• Added debug-level per-command request delta logging across issue/project/team/milestone tools

Documentation / Tests

• Documented new diagnostics flag and cache behavior
• Added regression tests for rate-limit fallback and API usage caching

v0.4.0 (2026-03-23)

Comprehensive error handling and file-first logging release.

New Features

• File-first logging: Structured JSON logs written to ~/.config/pi-linear-tools/ instead of stdout (TUI-safe)
• Request metrics tracking: Monitor total/success/failed/rate-limited requests per client
• Periodic usage summaries: Logged every 50 requests or 15 seconds

Bug Fixes

• All tool execute() functions now wrapped with comprehensive try/catch
• Never let raw SDK errors propagate to users
• Extension initialization protected with safety wrapper

Improvements

• Clear user-facing error messages for:
  • Rate limit errors (with reset times)
  • Authentication/authorization failures
  • Network errors
  • Server errors (5xx)
• Graceful handling when pi.registerTool is unavailable
• Better error context for debugging

v0.3.0 (2026-03-22)

Rate limit optimization and crash prevention release.

Bug Fixes

• Fixed rate limit crashes by eliminating N+1 API queries (root cause)
• Added global rate limit tracking to prevent repeated API calls
• Added comprehensive error handling to prevent extension crashes

Performance

• Replaced SDK lazy-loading with optimized GraphQL queries
• API requests per issue listing: ~251 → 1
• Listings before hitting rate limit: ~50 → ~5000

Improvements

• Reduced default pagination limit (50 → 20) to reduce API load
• Better user-friendly error messages for rate limit errors
• Rate limit pre-check before making API calls

v0.2.0 (2026-02-28)

OAuth 2.0 authentication and Markdown rendering release.

New Features

• OAuth 2.0 authentication with PKCE (INN-242)
• Markdown rendering for tool outputs (INN-241)

Improvements

• Improved milestone list/delete usability
• Fixed pi-tui/pi-coding-agent imports when installed from npm or source
• Better error messages for OAuth scope issues
• Fallback token storage when keychain is unavailable

Notes

• npm package: @fink-andreas/pi-linear-tools
• git tag: v0.2.0
• GitHub release notes source: RELEASE_NOTES_v0.2.0.md

v0.1.0 (2026-02-25)

Initial public release of @fink-andreas/pi-linear-tools.

Included

• Linear issue/project/team/milestone tools for pi
• Extension commands for configuration/help
• Local CLI for settings and tool operations
• Project/team/milestone and assignee handling improvements covered by test suite

Notes

• npm package: @fink-andreas/pi-linear-tools
• Planned git tag: v0.1.0
• GitHub release notes source: RELEASE_NOTES_v0.1.0.md