Skip to content

Commit fec13c9

Browse files
kryptobaseddevclaude
kryptobaseddev
and
claude
committed
feat: Add history and show commands (v0.12.8)
## New Commands ### `history` command (T224) - Completion timeline with bar chart visualization - Phase distribution of completed tasks - Label breakdown of completions - Velocity metrics (average, peak tasks/day) - Options: --days N, --since DATE, --until DATE, --format json ### `show` command (T225) - Single task detail view with all fields - Dependency info (what blocks this, what this blocks) - --history flag to show task log entries - --related flag to show tasks with same labels - --include-archive to search archived tasks - JSON output support for scripting ## Documentation - docs/commands/history.md - docs/commands/show.md - Updated TODO_Task_Management.md with Task Inspection section - Updated CLAUDE-INJECTION.md template 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 43e3f07 commit fec13c9

File tree

10 files changed

+859
-5
lines changed

10 files changed

+859
-5
lines changed

‎CHANGELOG.md‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,33 @@ All notable changes to the claude-todo system will be documented in this file.
55
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
66
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
77

8+
## [0.12.8] - 2025-12-15
9+
10+
### Added
11+
- **`show` command**: Single task detail view (T225)
12+
- Full task details with all fields displayed
13+
- Dependency information (what this blocks, what blocks this)
14+
- `--history` flag to show task log entries
15+
- `--related` flag to show tasks with same labels
16+
- `--include-archive` to search archived tasks
17+
- JSON output support for scripting
18+
- Documentation: `docs/commands/show.md`
19+
20+
### Changed
21+
- Updated CLAUDE-INJECTION.md template with `show` command
22+
- Updated TODO_Task_Management.md with Task Inspection section
23+
24+
## [0.12.7] - 2025-12-15
25+
26+
### Added
27+
- **`history` command**: Completion timeline and analytics (T224)
28+
- Daily completion counts with bar chart visualization
29+
- Phase distribution of completed tasks
30+
- Label breakdown of completions
31+
- Velocity metrics (average, peak tasks/day)
32+
- Options: `--days N`, `--since DATE`, `--until DATE`, `--format json`
33+
- Documentation: `docs/commands/history.md`
34+
835
## [0.12.6] - 2025-12-15
936

1037
### Added

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
> **A production-grade task management system for Claude Code with automatic archiving, comprehensive validation, and anti-hallucination protection.**
44
55
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6-
[![Version](https://img.shields.io/badge/version-0.12.6-blue.svg)](CHANGELOG.md)
6+
[![Version](https://img.shields.io/badge/version-0.12.8-blue.svg)](CHANGELOG.md)
77
[![Bash](https://img.shields.io/badge/bash-4.0%2B-green.svg)](https://www.gnu.org/software/bash/)
88
[![Tests](https://img.shields.io/badge/tests-passing-brightgreen.svg)](tests/)
99

‎VERSION‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
0.12.6
1+
0.12.8

‎docs/INDEX.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,8 @@
4949
| **[commands/backup.md](commands/backup.md)** | Backup command documentation | Creating and listing backups |
5050
| **[commands/restore.md](commands/restore.md)** | Restore command documentation | Restoring from backups |
5151
| **[commands/exists.md](commands/exists.md)** | Task existence validation documentation | Validating task IDs in scripts and CI/CD pipelines |
52+
| **[commands/history.md](commands/history.md)** | Completion history and timeline analytics | Reviewing productivity trends and completion metrics |
53+
| **[commands/show.md](commands/show.md)** | Single task detail view documentation | Viewing full task details, dependencies, and history |
5254

5355
### 🔬 Technical Reference
5456

‎docs/TODO_Task_Management.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@ claude-todo add "Task title" [OPTIONS] # Create task
2222
claude-todo update <id> [OPTIONS] # Update task fields
2323
claude-todo complete <id> # Mark done
2424
claude-todo list [--status STATUS] # View tasks
25+
claude-todo show <id> # View single task details
2526
```
2627

2728
### Focus & Session
@@ -54,6 +55,15 @@ claude-todo blockers # Show blocked tasks
5455
claude-todo blockers analyze # Critical path analysis
5556
```
5657

58+
### Task Inspection
59+
```bash
60+
claude-todo show <id> # Full task details view
61+
claude-todo show <id> --history # Include task history from log
62+
claude-todo show <id> --related # Show related tasks (same labels)
63+
claude-todo show <id> --include-archive # Search archive if not found
64+
claude-todo show <id> --format json # JSON output for scripting
65+
```
66+
5767
### Maintenance
5868
```bash
5969
claude-todo validate # Check file integrity

‎docs/commands/history.md‎

Lines changed: 162 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,162 @@
1+
# history Command
2+
3+
Show completion history timeline with analytics and velocity metrics.
4+
5+
## Usage
6+
7+
```bash
8+
claude-todo history [OPTIONS]
9+
```
10+
11+
## Description
12+
13+
The `history` command provides a timeline view of task completions with analytics including:
14+
- Daily completion counts with sparkline visualization
15+
- Phase distribution of completed tasks
16+
- Label breakdown of completions
17+
- Velocity metrics (tasks/day average and peak)
18+
19+
This command is ideal for:
20+
- Reviewing productivity trends over time
21+
- Understanding which phases have the most completions
22+
- Identifying productive periods and patterns
23+
- Generating completion reports for stakeholders
24+
25+
## Options
26+
27+
| Option | Short | Description | Default |
28+
|--------|-------|-------------|---------|
29+
| `--days N` | | Show last N days | `30` |
30+
| `--since DATE` | | Show completions since date (YYYY-MM-DD) | |
31+
| `--until DATE` | | Show completions until date (YYYY-MM-DD) | |
32+
| `--format FORMAT` | `-f` | Output format: `text` or `json` | `text` |
33+
| `--no-chart` | | Disable sparkline and bar charts | Show charts |
34+
| `--help` | `-h` | Show help message | |
35+
36+
## Examples
37+
38+
### Basic Usage
39+
40+
```bash
41+
# Show last 30 days of completions
42+
claude-todo history
43+
44+
# Show last week
45+
claude-todo history --days 7
46+
47+
# Show specific date range
48+
claude-todo history --since 2025-12-01 --until 2025-12-15
49+
```
50+
51+
### Output Format
52+
53+
```bash
54+
# JSON output for scripting
55+
claude-todo history --format json
56+
57+
# Text output without charts (for terminals without Unicode)
58+
claude-todo history --no-chart
59+
```
60+
61+
## Sample Output
62+
63+
### Text Format
64+
65+
```
66+
╭─────────────────────────────────────────────────────────────────╮
67+
│ COMPLETION HISTORY │
68+
│ Last 30 days │
69+
╰─────────────────────────────────────────────────────────────────╯
70+
71+
TIMELINE (Daily Completions)
72+
────────────────────────────────────────────────────────────────
73+
Dec 01 ▁▁▁▃▅▇▅▃▁▁▁▁▃▅▇█▇▅▃▁▁▁▃▅▇▅▃▁▁▁
74+
75+
VELOCITY METRICS
76+
────────────────────────────────────────────────────────────────
77+
Total Completed: 87 tasks
78+
Average Rate: 2.9 tasks/day
79+
Peak Day: Dec 15 (32 tasks)
80+
81+
PHASE DISTRIBUTION
82+
────────────────────────────────────────────────────────────────
83+
core [████████████████████] 51 (59%)
84+
polish [████████████░░░░░░░░] 21 (24%)
85+
setup [██████░░░░░░░░░░░░░░] 8 (9%)
86+
87+
TOP LABELS
88+
────────────────────────────────────────────────────────────────
89+
consensus-framework (38) backup-system (12) cli (8)
90+
```
91+
92+
### JSON Format
93+
94+
```json
95+
{
96+
"_meta": {
97+
"command": "history",
98+
"generated": "2025-12-15T16:30:00Z",
99+
"period": {
100+
"days": 30,
101+
"since": "2025-11-15",
102+
"until": "2025-12-15"
103+
}
104+
},
105+
"velocity": {
106+
"total_completed": 87,
107+
"average_per_day": 2.9,
108+
"peak_day": "2025-12-15",
109+
"peak_count": 32
110+
},
111+
"timeline": [
112+
{"date": "2025-12-15", "count": 32},
113+
{"date": "2025-12-14", "count": 5},
114+
...
115+
],
116+
"phases": {
117+
"core": 51,
118+
"polish": 21,
119+
"setup": 8
120+
},
121+
"labels": {
122+
"consensus-framework": 38,
123+
"backup-system": 12,
124+
"cli": 8
125+
}
126+
}
127+
```
128+
129+
## Use Cases
130+
131+
### Sprint Retrospective
132+
133+
```bash
134+
# Get completion stats for a 2-week sprint
135+
claude-todo history --since 2025-12-01 --until 2025-12-14 --format json
136+
```
137+
138+
### Productivity Analysis
139+
140+
```bash
141+
# Analyze completion patterns over the last month
142+
claude-todo history --days 30
143+
```
144+
145+
### CI/CD Integration
146+
147+
```bash
148+
# Export completion metrics for reporting
149+
claude-todo history --format json | jq '.velocity'
150+
```
151+
152+
## Related Commands
153+
154+
- `dash` - Project dashboard with current status
155+
- `stats` - Overall task statistics
156+
- `phases` - Phase management and progress
157+
- `labels` - Label analytics
158+
159+
## See Also
160+
161+
- [Dashboard Command](dash.md) - Real-time project overview
162+
- [Stats Command](../reference/stats.md) - Task statistics

0 commit comments

Comments
 (0)