npm Publishing Documentation
npm Publishing Documentation
Section titled “npm Publishing Documentation”This directory contains documentation for npm registry operations, authentication, and CI/CD publishing workflows.
Documents
Section titled “Documents”Comprehensive guide to setting up and maintaining npm authentication for CI/CD pipelines.
Topics covered:
- Granular Access Token setup (recommended)
- npm Provenance with GitHub OIDC
- Token permissions and security
- Troubleshooting authentication issues
When to read: Setting up automated publishing or when tokens expire
Quick reference guide for renewing expired npm tokens.
Topics covered:
- 5-minute token renewal process
- Step-by-step instructions
- Common error resolutions
- Quick verification steps
When to read: When publish workflow fails with authentication errors
Quick Links
Section titled “Quick Links”- npm Package: @pantheon-ai/opencode-warcraft-notifications
- Token Settings: npm Access Tokens
- GitHub Secrets: Repository Secrets
- Publish Workflow: .github/workflows/2-publish.yml
Common Tasks
Section titled “Common Tasks”Check Current Published Version
Section titled “Check Current Published Version”npm view @pantheon-ai/opencode-warcraft-notifications versionList All Published Versions
Section titled “List All Published Versions”npm view @pantheon-ai/opencode-warcraft-notifications versionsCheck GitHub Secret Status
Section titled “Check GitHub Secret Status”gh secret list | grep NPM_TOKENManually Trigger Publish
Section titled “Manually Trigger Publish”gh workflow run 2-publish.yml -f tag=v1.1.0Related Documentation
Section titled “Related Documentation”- Deployment Guide - Overall deployment and installation
- Pipeline Documentation - Complete CI/CD pipeline overview
- GitHub Workflows - Detailed workflow documentation
- Troubleshooting - General troubleshooting guide
Emergency Contacts
Section titled “Emergency Contacts”If you encounter critical publishing issues:
- Check Workflow Runs: https://github.com/pantheon-org/opencode-warcraft-notifications/actions
- Review npm Dashboard: https://www.npmjs.com/package/@pantheon-ai/opencode-warcraft-notifications
- Check Token Expiration: https://www.npmjs.com/settings/YOUR_USERNAME/tokens
Support
Section titled “Support”For npm-specific issues:
- Review authentication.md for token setup
- Check token-renewal.md for quick fixes
- Consult troubleshooting.md for general issues