kanban-cli 0.1.12

Command-line interface for the kanban project management tool
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

# kanban-cli

Command-line interface for the kanban project management tool.

## Features

- 🚀 **CLI Entry Point**: Main binary for launching the application
- 📝 **File Management**: JSON import/export with auto-save
- 🔧 **Argument Parsing**: Clean command-line interface with clap
- 📊 **Logging**: Structured logging with tracing
- ⚡ **Async Runtime**: Tokio-powered async execution

## Purpose

This crate serves as the application entry point:

- Command-line argument parsing
- Logging and tracing initialization
- TUI application launch
- File path handling and validation

## Architecture

The CLI is the top-level crate that coordinates all other layers:

```
kanban-core
    ↑
    ├── kanban-domain
    │       ↑
    │       └── kanban-tui
    │               ↑
    │               └── kanban-cli (entry point)
```

## Usage

```bash
# Launch interactive TUI
kanban

# Launch with specific file
kanban boards.json

# Launch with file import
kanban myproject.json
```

## Command-Line Arguments

- `[FILE]` - Optional path to JSON file for import/export
  - If file exists, boards are loaded on startup
  - If file doesn't exist, it's created with empty structure
  - Changes are auto-saved on exit (`q`)

## File Format

The CLI works with JSON files in this format:

```json
{
  "boards": [
    {
      "board": { "id": "...", "name": "My Board", ... },
      "columns": [ { "id": "...", "name": "Todo", ... } ],
      "cards": [ { "id": "...", "title": "Task", ... } ],
      "sprints": [ { "id": "...", "sprint_number": 1, ... } ]
    }
  ]
}
```

## Logging

Structured logging with tracing:
- Info level for normal operation
- Debug level for detailed diagnostics
- Error level for failures

Set log level with `RUST_LOG` environment variable:
```bash
RUST_LOG=debug kanban
```

## Design Pattern

- Entry point coordination
- Dependency injection setup
- Error handling with anyhow
- Async/await with tokio runtime

## Building

```bash
# Development build
cargo build

# Release build
cargo build --release

# Install locally
cargo install --path .
```

## Binary Name

The CLI produces a binary named `kanban` (configured in `Cargo.toml`).

## License

Apache 2.0 - See [LICENSE.md](../../LICENSE.md) for details