trello-cli-unofficial 0.5.0 → 0.6.0

package/README.md

@@ -5,8 +5,10 @@
 [![Bun](https://img.shields.io/badge/Bun-%23000000.svg?style=flat&logo=bun&logoColor=white)](https://bun.sh)
 [![TypeScript](https://img.shields.io/badge/TypeScript-%23007ACC.svg?style=flat&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![Tests](https://img.shields.io/badge/tests-57%20passing-brightgreen.svg)](./tests)
+[![CI/CD](https://img.shields.io/github/actions/workflow/status/JaegerCaiser/trello-cli-unofficial/ci.yml?branch=main&label=CI)](https://github.com/JaegerCaiser/trello-cli-unofficial/actions)
+[![Release](https://img.shields.io/github/actions/workflow/status/JaegerCaiser/trello-cli-unofficial/release.yml?branch=main&label=Release)](https://github.com/JaegerCaiser/trello-cli-unofficial/actions)
 
-An unofficial Trello CLI using Power-Up authentication, built with Bun for maximum performance.
+An unofficial Trello CLI using Power-Up authentication, built with Bun for maximum performance. Features automated CI/CD with semantic versioning and NPM publishing.
 
 ## 🚀 Features
 
@@ -18,51 +20,55 @@ An unofficial Trello CLI using Power-Up authentication, built with Bun for maxim
 - ✏️ **CRUD Operations**: Create, read, update, and delete cards
 - 📦 **Move Cards**: Between lists in the same board
 - 🛠️ **Traditional CLI**: Also works as a command-line tool
+- 🤖 **Automated CI/CD**: Semantic versioning and NPM publishing on every release
+- 🔒 **Secure Publishing**: NPM provenance with GitHub Actions OIDC
 
 ## 📦 Installation
 
 ### Prerequisites
 
-- [Bun](https://bun.sh/) installed
+- [Bun](https://bun.sh/) or Node.js installed
 - Trello account with Power-Up enabled
 
-### Global Installation (Recommended)
+### NPM Installation (Recommended)
 
 ```bash
-# Clone the repository
-git clone https://github.com/JaegerCaiser/trello-cli-unofficial.git
-cd trello-cli-unofficial
+# Install globally via NPM
+npm install -g trello-cli-unofficial
 
-# Install dependencies
-bun install
+# Or using Bun
+bun add -g trello-cli-unofficial
 
-# Install globally (optional)
-bun link
+# Verify installation
+tcu --version
 ```
 
-### Local Installation
+### Manual Installation (Development)
 
 ```bash
-# Clone and install
+# Clone the repository
 git clone https://github.com/JaegerCaiser/trello-cli-unofficial.git
 cd trello-cli-unofficial
+
+# Install dependencies
 bun install
+
+# Install globally (optional)
+bun link
 ```
 
 ## 🔧 Configuration
 
-### First Run
+### First Run Setup
 
 On first run, the CLI will guide you through setup:
 
 ```bash
 # Run the CLI
-bun run main.ts
-
-# Or if installed globally
-trello-cli-unofficial
-# or use the shortcut:
 tcu
+
+# Or if running from source
+bun run main.ts
 ```
 
 The CLI will ask for your Trello token. To get it:
@@ -75,7 +81,7 @@ The CLI will ask for your Trello token. To get it:
 ### Manual Configuration
 
 ```bash
-# Configure token
+# Configure token interactively
 tcu setup
 
 # View current configuration
@@ -98,11 +104,11 @@ The token is automatically saved in `~/.trello-cli-unofficial/config.json`:
 ### Interactive Mode (Recommended)
 
 ```bash
-# With global installation
+# Start interactive mode
 tcu
 
-# Or directly
-bun run main.ts
+# Or the full command name
+trello-cli-unofficial
 ```
 
 Main menu options:
@@ -116,14 +122,17 @@ Main menu options:
 ### Direct Commands
 
 ```bash
-# View boards
+# View all boards
 tcu boards
 
-# Interactive mode
+# Start interactive mode
 tcu interactive
 
 # Configure token
 tcu setup
+
+# Show version
+tcu --version
 ```
 
 ## 📚 Usage Examples
@@ -153,6 +162,38 @@ tcu
 - **Delete**: Confirm before removing
 - **Move**: Select destination list
 
+## 🤖 CI/CD & Automation
+
+This project uses automated CI/CD with semantic versioning:
+
+### Version Bumping
+
+- `feat:` commits → Minor version bump (0.5.0 → 0.6.0)
+- `fix:` commits → Patch version bump (0.5.0 → 0.5.1)
+- `BREAKING CHANGE:` → Major version bump (0.5.0 → 1.0.0)
+
+### Automated Publishing
+
+Every push to `main` branch triggers:
+1. **CI Pipeline**: Linting, type checking, tests, and build
+2. **Release Pipeline**: Version bump, NPM publish, GitHub release
+3. **Security**: NPM provenance with signed builds
+
+### Conventional Commits
+
+```bash
+# Feature commit (minor version)
+git commit -m "feat: add new card templates"
+
+# Bug fix (patch version)
+git commit -m "fix: handle network timeouts gracefully"
+
+# Breaking change (major version)
+git commit -m "feat!: redesign authentication flow
+
+BREAKING CHANGE: token format changed"
+```
+
 ## 🛠️ Development
 
 ### Project Structure
@@ -161,12 +202,13 @@ tcu
 trello-cli-unofficial/
 ├── src/
 │   ├── domain/           # Business logic & entities
-│   ├── application/      # Use cases
+│   ├── application/      # Use cases & orchestration
 │   ├── infrastructure/   # External implementations
-│   └── presentation/     # CLI controllers
-├── tests/                # Test suite
+│   └── presentation/     # CLI controllers & UI
+├── tests/                # Test suite (57 tests)
+├── .github/workflows/    # CI/CD pipelines
 ├── main.ts              # Entry point
-├── package.json         # Dependencies
+├── package.json         # Dependencies & scripts
 └── README.md           # This documentation
 ```
 
@@ -180,46 +222,64 @@ trello-cli-unofficial/
 ### Available Scripts
 
 ```bash
-# Run
+# Run locally
 bun run main.ts
 
-# Development
-bun run dev
+# Development with watch mode
+bun run --watch main.ts
 
-# Build
+# Build for production
 bun run build
 
-# Tests
+# Run tests
 bun test
 
+# Run tests with coverage
+bun test:coverage
+
 # Validation (lint + typecheck + test)
 bun run validate
+
+# Type checking only
+bun run typecheck
+
+# Linting only
+bun run lint
 ```
 
 ## 🔒 Security
 
-- Token saved locally in protected file
+- Token saved locally in protected file (`~/.trello-cli-unofficial/config.json`)
 - No data sent to external servers
-- Uses HTTPS for all Trello communications
+- Uses HTTPS for all Trello API communications
 - Compatible with Trello's Power-Up authentication
+- NPM packages published with provenance attestation
 
 ## 🐛 Troubleshooting
 
 ### 401 Unauthorized Error
 
-- Verify the token is correct
+- Verify the token is correct and starts with `ATTA`
 - Confirm the Power-Up has necessary permissions
-- Try generating a new token
+- Try generating a new token from [trello.com/power-ups/admin](https://trello.com/power-ups/admin)
 
 ### Network Error
 
 - Check your internet connection
-- Confirm api.trello.com is accessible
+- Confirm `api.trello.com` is accessible
+- Try again in a few minutes
 
 ### Configuration Not Saving
 
 - Check write permissions in `~/.trello-cli-unofficial/`
 - Run as user with appropriate permissions
+- Try running `tcu setup` again
+
+### Installation Issues
+
+- Ensure Bun or Node.js is installed
+- Try `npm install -g trello-cli-unofficial` if Bun fails
+- Check that `tcu` command is in your PATH
 
 ## 🤝 Contributing
 
@@ -227,29 +287,47 @@ Contributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md)
 
 1. Fork the project
 2. Create a feature branch (`git checkout -b feature/AmazingFeature`)
-3. Commit your changes (`git commit -m 'feat: add some amazing feature'`)
+3. Commit your changes using conventional commits (`git commit -m 'feat: add some amazing feature'`)
 4. Run the tests (`bun run validate`)
 5. Push to the branch (`git push origin feature/AmazingFeature`)
 6. Open a Pull Request
 
+### Development Setup
+
+```bash
+# Clone and setup
+git clone https://github.com/JaegerCaiser/trello-cli-unofficial.git
+cd trello-cli-unofficial
+bun install
+
+# Run tests
+bun test
+
+# Start development
+bun run --watch main.ts
+```
+
 ## 📜 License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
 ## 🙏 Acknowledgments
 
-- [Trello API](https://developer.atlassian.com/cloud/trello/) - Official Trello API
+- [Trello API](https://developer.atlassian.com/cloud/trello/) - Official Trello REST API
 - [Bun](https://bun.sh/) - Ultra-fast JavaScript runtime
 - [Inquirer](https://github.com/SBoudrias/Inquirer.js) - Interactive command-line interface
 - [Commander](https://github.com/tj/commander.js) - CLI framework for Node.js
+- [GitHub Actions](https://github.com/features/actions) - CI/CD automation
 
 ## 📊 Project Status
 
-- ✅ Initial release (v0.1.0)
+- ✅ Latest version: **v0.5.0**
 - 🚀 57 tests passing
-- 📦 Clean DDD architecture
-- 🎨 ESLint + TypeScript strict
+- 📦 Clean Domain-Driven Design architecture
+- 🎨 ESLint + TypeScript strict mode
 - ⚡ Performance optimized with Bun
+- 🤖 Automated CI/CD with semantic versioning
+- 🔒 Secure publishing with NPM provenance
 
 ---
 
@@ -257,7 +335,4 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
-**Made with ❤️ and Bun**
-# Test
-# Test commit for trusted publisher
-# Test trusted publisher
+**Made with ❤️, Bun, and automated CI/CD**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "trello-cli-unofficial",
   "type": "module",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "private": false,
   "description": "Unofficial Trello CLI using Power-Up authentication, built with Bun for maximum performance",
   "author": "Matheus Caiser <matheus.kaiser@gmail.com> (https://www.mrdeveloper.com.br/)",