trello-cli-unofficial 0.12.1 → 0.13.1

package/CHANGELOG.md

@@ -1,3 +1,52 @@
+## [0.13.1](https://github.com/JaegerCaiser/trello-cli-unofficial/compare/v0.13.0...v0.13.1) (2025-11-24)
+
+
+### Bug Fixes
+
+* attempt 10 to publish with OIDC ([c24ef45](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/c24ef45562e729848a18f570d9a6ca4d238553e0))
+* attempt 10 to publish with OIDC ([ca4dc2a](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/ca4dc2a26c93d5c57fb845e4ac94fc0c00e77926))
+* attempt 5 to publish with OIDC ([8dcf722](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/8dcf72288cc27fb33ffd19c7583d48bf3a16f5c0))
+* attempt 6 to publish with OIDC ([05e37f2](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/05e37f2b460252019a3a761476e23deb07e1671a))
+* attempt 7 to publish with OIDC ([1d74aac](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/1d74aac30902ef81f2ac7122e44a3aca7faf5d7a))
+* attempt 8 to publish with OIDC ([3e88f2c](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/3e88f2c89d9f8a4f599d0e97489dbc299c7a08d8))
+* attempt 8 to publish with OIDC ([6939975](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/69399754cdec285383fb3082bc3bfb4467c47c74))
+* attempt 9 to publish with OIDC ([cf6191e](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/cf6191ee93e77f2da388bd6cca67e4445a3b0ba7))
+* connection debug ([607a07a](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/607a07a13b5d445f5e2e4767c0b7a46df56d3c68))
+* connection debug 2 ([2da5c89](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/2da5c89804c16a14477a31c156c921571ca56966))
+* debug oidc ([7cca10d](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/7cca10d39b2a351d6c1a7bc018f563f1e50cbf33))
+* debug oidc 2 ([29ac283](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/29ac283da5556f0276294255861b25d055493570))
+* empty commit ([b968807](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/b968807120c2a87f4f5459d7b4a22ebba89b3145))
+* now its going works ([d3faea3](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/d3faea36197422ae90de9ee6a77d136760497740))
+* now its going works 10 ([841949c](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/841949cd92c13b0c532f8eef64c5893ef5db8cb9))
+* now its going works 11 ([af43ff8](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/af43ff841c778777394ff3a02e34bc4e27d35557))
+* now its going works 12 ([d681336](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/d681336f3a76c38c4d7ca20de2ca479a939c5b6a))
+* now its going works 13 ([b70a7d8](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/b70a7d8e49784a04b9146fa96fbd778bc48fbd4c))
+* now its going works 2 ([ffc1f78](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/ffc1f78b4ef74f83260f77e69d1dd730cedb3077))
+* now its going works 3 ([567105b](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/567105b8cb0106ec43aaadbd614d063f0e360e1d))
+* now its going works 4 ([fb6a98f](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/fb6a98f9df60779d3c33bd5ac2c3c09f664b06fe))
+* now its going works 5 ([e7c444a](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/e7c444a7f46bdef8abc858fd27ca2ba06da58aa0))
+* now its going works 6 ([4db4220](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/4db422042b0fde77fde998113fee8776dbc192d0))
+* now its going works 7 ([2a6522f](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/2a6522f63ba5fc57eff08228e8402dbf1ec6e43c))
+* now its going works 8 ([99451bc](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/99451bcbfb003f005455109958fbc1b30a9a2a96))
+* now its going works 9 ([408e4da](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/408e4da53bb3799d8e9789b13127b46ad397e2f2))
+* release workflow must work it with publisher token ([6a4e894](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/6a4e894529148fa9dd015252359cd599f1d33078))
+* removing debug ([9a1a2d0](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/9a1a2d0e496847a97a9cae68af88aafbff3c3bff))
+* removing NPM_TOKEN expecting that use the publisher token ([0933afa](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/0933afa873fdabbf0d85a1d394a307e1726c0010))
+* set empty token to skip ([f161747](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/f161747b78bd0046040ebedb0f6a05ad6fff8f9d))
+* set empty token to skip ([66189a0](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/66189a04ec4d6e0ea29ace6a62f5b46d7d8e6f63))
+
+# [0.13.0](https://github.com/JaegerCaiser/trello-cli-unofficial/compare/v0.12.1...v0.13.0) (2025-11-19)
+
+
+### Bug Fixes
+
+* make tests multilingual to support CI environment ([39db26a](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/39db26ae871eabf5fe43970182217e56b94189b7))
+
+
+### Features
+
+* implement card 1.12 - migration & backward compatibility ([adc668b](https://github.com/JaegerCaiser/trello-cli-unofficial/commit/adc668b961f8ae8bed6244b4fad2f70b104dbb46))
+
 ## [0.12.1](https://github.com/JaegerCaiser/trello-cli-unofficial/compare/v0.12.0...v0.12.1) (2025-11-17)
 
 

package/README.md

@@ -4,7 +4,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![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)
+[![Tests](https://img.shields.io/badge/tests-195%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)
 
@@ -16,9 +16,12 @@ An unofficial Trello CLI using Power-Up authentication, built with Bun for maxim
 - 🔐 **Power-Up Authentication**: Compatible with Trello's newer authentication system
 - 💾 **Persistent Configuration**: Automatically saves your token
 - 🎯 **Interactive Interface**: Intuitive menu with interactive prompts
-- 📋 **Complete Management**: Boards, lists, cards
+- 📋 **Complete Management**: Boards, lists, cards with detailed information
 - ✏️ **CRUD Operations**: Create, read, update, and delete cards
 - 📦 **Move Cards**: Between lists in the same board
+- 👀 **Detailed Views**: Show comprehensive board and card details
+- 📊 **Multiple Output Formats**: Table, JSON, CSV formats
+- 🏷️ **Rich Metadata**: Labels, members, checklists, and attachments support
 - 🛠️ **Traditional CLI**: Also works as a command-line tool
 - 🌍 **Internationalization**: Support for Portuguese (pt-BR) and English (en) with auto-detection
 - 🤖 **Automated CI/CD**: Semantic versioning and NPM publishing on every release
@@ -50,11 +53,9 @@ npm install -g trello-cli-unofficial
 tcu --version
 ```
 
-# Ready to use immediately!
+**Ready to use immediately!**
 
-tcu --version
-
-````
+`tcu --version`
 
 #### Windows Installation
 
@@ -213,7 +214,31 @@ Main menu options:
 
 ```bash
 # View all boards
-tcu boards
+tcu boards list
+
+# Show detailed board information
+tcu boards show <boardId>
+
+# View lists in a board
+tcu lists list <boardId>
+
+# View cards in a list
+tcu cards list <listId>
+
+# Show detailed card information
+tcu cards show <cardId>
+
+# Create a new card
+tcu cards create <listId> <name> [--desc "description"]
+
+# Update an existing card
+tcu cards update <cardId> --name "new name" [--desc "new description"]
+
+# Move a card to another list
+tcu cards move <cardId> --to <listId>
+
+# Delete a card
+tcu cards delete <cardId>
 
 # Start interactive mode
 tcu interactive
@@ -223,10 +248,110 @@ tcu setup
 
 # Show version
 tcu --version
+
+# Output format options (available for most commands)
+tcu boards list --format json
+tcu boards list --format csv
+tcu boards list --format table  # default
+```
+
+## 🏗️ Command Structure
+
+The CLI uses a hierarchical subcommand structure for better organization:
+
+```
+tcu [command] [subcommand] [options] [arguments]
+```
+
+### Main Commands
+
+- **`boards`** - Manage Trello boards
+  - `list` - List all boards
+  - `show <boardId>` - Show detailed board information
+  - `create <name>` - Create a new board
+  - `delete <boardId>` - Delete a board
+
+- **`lists`** - Manage Trello lists
+  - `list <boardId>` - List all lists in a board
+  - `create <boardId> <name>` - Create a new list
+  - `delete <listId>` - Delete a list
+  - `move <listId> <position>` - Move list to new position
+
+- **`cards`** - Manage Trello cards
+  - `list <listId>` - List all cards in a list
+  - `show <cardId>` - Show detailed card information
+  - `create <listId> <name>` - Create a new card
+  - `update <cardId>` - Update an existing card
+  - `move <cardId>` - Move card to another list
+  - `delete <cardId>` - Delete a card
+
+- **`config`** - Configuration management
+  - `setup` - Configure Trello token
+  - `show` - Display current configuration
+
+### Global Options
+
+- `--format <format>` - Output format: `table` (default), `json`, `csv`
+- `--help` - Show help for any command
+- `--version` - Show CLI version
+
+### Interactive Mode
+
+```bash
+# Start interactive menu
+tcu
+
+# Or explicitly
+tcu interactive
 ```
 
 ## 📚 Usage Examples
 
+### View Boards
+
+```bash
+# List all your boards
+tcu boards list
+
+# Show detailed information about a specific board
+tcu boards show 60d5ecb74e2b8c3b8c8c8c8c
+
+# Export boards to JSON
+tcu boards list --format json
+
+# Export boards to CSV
+tcu boards list --format csv
+```
+
+### Manage Lists
+
+```bash
+# List all lists in a board
+tcu lists list 60d5ecb74e2b8c3b8c8c8c8c
+```
+
+### Manage Cards
+
+```bash
+# List all cards in a list
+tcu cards list 60d5ecb74e2b8c3b8c8c8c8d
+
+# Show detailed information about a card
+tcu cards show 60d5ecb74e2b8c3b8c8c8c8e
+
+# Create a new card
+tcu cards create 60d5ecb74e2b8c3b8c8c8c8d "Implement new feature" --desc "Add support for card templates"
+
+# Update an existing card
+tcu cards update 60d5ecb74e2b8c3b8c8c8c8e --name "Updated feature name" --desc "Updated description"
+
+# Move a card to another list
+tcu cards move 60d5ecb74e2b8c3b8c8c8c8e --to 60d5ecb74e2b8c3b8c8c8c8f
+
+# Delete a card
+tcu cards delete 60d5ecb74e2b8c3b8c8c8c8e
+```
+
 ### Create a Card
 
 ```bash
@@ -246,12 +371,6 @@ tcu
 # Optionally: edit, delete, or move cards
 ```
 
-### Manage Cards
-
-- **Edit**: Change name and description
-- **Delete**: Confirm before removing
-- **Move**: Select destination list
-
 ### Show Card Details
 
 ```bash
@@ -259,6 +378,64 @@ tcu
 tcu cards show <cardId>
 ```
 
+### Output Formats
+
+```bash
+# Table format (default)
+tcu boards list
+
+# JSON format
+tcu boards list --format json
+
+# CSV format
+tcu boards list --format csv
+
+# All formats work with most commands
+tcu cards list <listId> --format json
+tcu lists list <boardId> --format csv
+```
+
+## 🔄 Backward Compatibility
+
+### Legacy Command Support
+
+During the transition period, the CLI maintains backward compatibility with older command formats. These legacy commands will show deprecation warnings but continue to work:
+
+```bash
+# Legacy commands (show deprecation warnings)
+tcu boards                    # → Use "tcu boards list" instead
+tcu lists legacy <boardName>  # → Use "tcu lists list <boardId>" instead
+tcu cards legacy <boardName> <listName>  # → Use "tcu cards list <listId>" instead
+
+# Legacy card management commands
+tcu create-card <boardName> <listName> <cardName>
+tcu move-card <cardId> <listName>
+tcu delete-card <cardId>
+```
+
+### Migration Guide
+
+| Old Command | New Command | Status |
+|-------------|-------------|--------|
+| `tcu boards` | `tcu boards list` | ⚠️ Deprecated |
+| `tcu lists <boardName>` | `tcu lists list <boardId>` | ⚠️ Deprecated |
+| `tcu cards <boardName> <listName>` | `tcu cards list <listId>` | ⚠️ Deprecated |
+| `tcu create-card <boardName> <listName> <name>` | `tcu cards create <listId> <name>` | ⚠️ Deprecated |
+| `tcu move-card <cardId> <listName>` | `tcu cards move <cardId> --to <listId>` | ⚠️ Deprecated |
+| `tcu delete-card <cardId>` | `tcu cards delete <cardId>` | ⚠️ Deprecated |
+
+**Migration Timeline:**
+- **Current:** Legacy commands work with deprecation warnings
+- **Future:** Legacy commands will be removed (TBD)
+
+### Why the Changes?
+
+The new command structure provides:
+- **Better organization** with hierarchical subcommands
+- **Improved discoverability** with `tcu <command> --help`
+- **Consistency** with modern CLI patterns
+- **Future extensibility** for additional subcommands
+
 ## 🤖 CI/CD & Automation
 
 This project uses automated CI/CD with semantic versioning based on **commit messages**:
@@ -357,6 +534,51 @@ bun run typecheck
 bun run lint
 ```
 
+## 🔧 Architecture & Extensibility
+
+### Domain-Driven Design Structure
+
+The CLI follows Domain-Driven Design principles with clear separation of concerns:
+
+```
+src/
+├── domain/           # Business logic & entities
+│   ├── entities/     # Board, List, Card entities
+│   ├── repositories/ # Repository interfaces
+│   └── services/     # Domain services (Authentication)
+├── application/      # Use cases & business logic
+│   └── use-cases/    # Business operations
+├── infrastructure/   # External implementations
+│   ├── repositories/ # Trello API, File system implementations
+│   └── external/     # External service integrations
+├── presentation/     # CLI interface layer
+│   └── cli/         # Command controllers & UI
+└── shared/          # Cross-cutting concerns
+    ├── ErrorHandler.ts
+    ├── OutputFormatter.ts
+    └── types.ts
+```
+
+### Adding New Commands
+
+To extend the CLI with new functionality:
+
+1. **Create a Use Case** in `src/application/use-cases/`
+2. **Implement Repository Interface** if needed
+3. **Add Controller Method** in appropriate CLI controller
+4. **Register Command** in `CommandController.ts`
+5. **Add Tests** following the existing pattern
+
+### Output Formatters
+
+The CLI supports multiple output formats through the `OutputFormatter` class:
+
+- **Table**: Human-readable tabular output (default)
+- **JSON**: Machine-readable structured data
+- **CSV**: Spreadsheet-compatible format
+
+All formatters handle complex nested data structures automatically.
+
 ## 🧪 Cross-Platform Development Testing
 
 This project includes tools for testing cross-platform compatibility during development:
@@ -552,12 +774,15 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ## 📊 Project Status
 
-- 🚀 57 tests passing
+- 🚀 195 tests passing (100% coverage)
 - 📦 Clean Domain-Driven Design architecture
 - 🎨 ESLint + TypeScript strict mode
 - ⚡ Performance optimized with Bun
 - 🤖 Automated CI/CD with semantic versioning
 - 🔒 Secure publishing with NPM provenance
+- 🌍 Internationalization (pt-BR/en)
+- 📊 Multiple output formats (table/json/csv)
+- 🏗️ Hierarchical command structure
 
 ---