Skip to content

Releases: Coastal-Programs/notion-cli

v5.7.0 - Update Notifications & Production Polish

26 Oct 10:44

Choose a tag to compare

🎯 What's New

This release brings automatic update notifications, production-grade security improvements, and automated npm publishing.

🔔 Update Notifications

  • Checks npm once per day for new versions
  • Non-intrusive yellow notification box when updates available
  • Respects NO_UPDATE_NOTIFIER environment variable
  • Automatic in CI environments and test suites
  • 24-hour cache to minimize npm registry calls
  • Users stay in full control - updates never automatic

🔒 Security Improvements

  • Token masking - Console output now masks tokens to prevent leakage
    • Format: secret_***...***abc (prefix + last 3 chars only)
    • Protects against accidental exposure in screen recordings/demos
    • Secure handling for unknown token prefixes
  • Token length validation - 20 character minimum catches incomplete copies
  • 11 comprehensive unit tests for maskToken() security function

✨ UX Enhancements

  • Token input - notion-cli init accepts tokens with OR without "secret_" prefix
  • Auto-prepending - Adds "secret_" automatically if user pastes just token value
  • Deferred notifications - Updates shown after command completes (industry standard)
  • DEBUG mode - Set DEBUG=1 to see verbose update check errors

🚀 Developer Experience

  • Automated npm publishing via GitHub Actions
  • Publishes automatically when GitHub Release is created
  • Runs tests, builds, and verifies before publishing
  • Prevents duplicate versions
  • Supply chain security with provenance attestations

📦 Dependencies

  • Added: update-notifier (industry-standard, used by npm/Yarn/1000+ CLIs)

📊 Quality Metrics

  • Production excellence: 98/100
  • All tests passing
  • Zero security vulnerabilities in production dependencies
  • Comprehensive documentation

🔗 Related PRs

  • #63 - Update notifications and UX improvements
  • #64 - Production polish (tests, docs, security fixes)

Install/Update:

npm install -g @coastal-programs/notion-cli@latest
# or
npm update -g @coastal-programs/notion-cli

Disable Update Notifications:

export NO_UPDATE_NOTIFIER=1

🤖 Generated with Claude Code