@md2do/cli 0.2.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/CHANGELOG.md +42 -0
  2. package/README.md +176 -0
  3. package/coverage/coverage-final.json +9 -9
  4. package/coverage/index.html +7 -7
  5. package/coverage/lcov-report/index.html +7 -7
  6. package/coverage/lcov-report/src/cli.ts.html +53 -5
  7. package/coverage/lcov-report/src/commands/index.html +5 -5
  8. package/coverage/lcov-report/src/commands/index.ts.html +1 -1
  9. package/coverage/lcov-report/src/commands/list.ts.html +49 -10
  10. package/coverage/lcov-report/src/commands/stats.ts.html +1 -1
  11. package/coverage/lcov-report/src/commands/todoist.ts.html +1 -1
  12. package/coverage/lcov-report/src/formatters/index.html +1 -1
  13. package/coverage/lcov-report/src/formatters/json.ts.html +1 -1
  14. package/coverage/lcov-report/src/formatters/pretty.ts.html +1 -1
  15. package/coverage/lcov-report/src/index.html +5 -5
  16. package/coverage/lcov-report/src/index.ts.html +1 -1
  17. package/coverage/lcov-report/src/scanner.ts.html +1 -1
  18. package/coverage/lcov.info +31 -2
  19. package/coverage/src/cli.ts.html +53 -5
  20. package/coverage/src/commands/index.html +5 -5
  21. package/coverage/src/commands/index.ts.html +1 -1
  22. package/coverage/src/commands/list.ts.html +49 -10
  23. package/coverage/src/commands/stats.ts.html +1 -1
  24. package/coverage/src/commands/todoist.ts.html +1 -1
  25. package/coverage/src/formatters/index.html +1 -1
  26. package/coverage/src/formatters/json.ts.html +1 -1
  27. package/coverage/src/formatters/pretty.ts.html +1 -1
  28. package/coverage/src/index.html +5 -5
  29. package/coverage/src/index.ts.html +1 -1
  30. package/coverage/src/scanner.ts.html +1 -1
  31. package/dist/cli.js +7 -6
  32. package/dist/index.js +7 -6
  33. package/package.json +15 -5
  34. package/src/commands/list.ts +19 -6
package/CHANGELOG.md CHANGED
@@ -1,5 +1,47 @@
1
1
  # @md2do/cli
2
2
 
3
+ ## 0.2.3
4
+
5
+ ### Patch Changes
6
+
7
+ - [#17](https://github.com/TeamNickHart/md2do/pull/17) [`c12adb3`](https://github.com/TeamNickHart/md2do/commit/c12adb32b2b50ca89bf22cdab57ca63498ba3dee) Thanks [@nickhart](https://github.com/nickhart)! - ## Security & Tooling Updates
8
+
9
+ ### Security Fixes
10
+ - Fix esbuild security vulnerability (GHSA-67mh-4wv8-2f99) via pnpm override forcing esbuild >= 0.25.0
11
+
12
+ ### Developer Experience
13
+ - Add @vitest/coverage-v8 dependency to enable code coverage reporting
14
+ - Update prettier to latest patch version (3.1.0 → 3.8.1)
15
+ - Update @modelcontextprotocol/sdk (1.25.2 → 1.25.3)
16
+
17
+ ### Testing
18
+ - All 401 unit tests passing
19
+ - All 35 E2E tests passing
20
+ - Coverage reporting now enabled across all packages
21
+
22
+ No breaking changes or API changes in this release.
23
+
24
+ - Updated dependencies [[`c12adb3`](https://github.com/TeamNickHart/md2do/commit/c12adb32b2b50ca89bf22cdab57ca63498ba3dee)]:
25
+ - @md2do/core@0.2.3
26
+ - @md2do/config@0.2.3
27
+ - @md2do/todoist@0.2.3
28
+
29
+ ## 0.2.2
30
+
31
+ ### Patch Changes
32
+
33
+ - [#12](https://github.com/TeamNickHart/md2do/pull/12) [`f07ba4c`](https://github.com/TeamNickHart/md2do/commit/f07ba4c4f6f46b43129e1ebd2b8ea67800e21dee) Thanks [@nickhart](https://github.com/nickhart)! - Enhance npm package discoverability with comprehensive READMEs and improved keywords
34
+ - Add conversion-focused README for @md2do/cli with Quick Start and common use cases
35
+ - Add developer-focused README for @md2do/core with complete API reference
36
+ - Add npm badges (version, downloads, license) to all package READMEs
37
+ - Expand keywords across all packages for better npm search discoverability
38
+ - Update root README tagline and add npm badges
39
+
40
+ - Updated dependencies [[`f07ba4c`](https://github.com/TeamNickHart/md2do/commit/f07ba4c4f6f46b43129e1ebd2b8ea67800e21dee)]:
41
+ - @md2do/core@0.2.2
42
+ - @md2do/config@0.2.2
43
+ - @md2do/todoist@0.2.2
44
+
3
45
  ## 0.2.1
4
46
 
5
47
  ### Patch Changes
package/README.md ADDED
@@ -0,0 +1,176 @@
1
+ # md2do
2
+
3
+ [![npm version](https://badge.fury.io/js/%40md2do%2Fcli.svg)](https://www.npmjs.com/package/@md2do/cli)
4
+ [![npm downloads](https://img.shields.io/npm/dm/@md2do/cli.svg)](https://www.npmjs.com/package/@md2do/cli)
5
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
6
+
7
+ **Turn your markdown files into a powerful task management system.**
8
+
9
+ md2do scans your markdown notes for TODO items and gives you a CLI to filter, sort, and sync them with Todoist. Perfect for developers who live in plain text but want the power of a real task manager.
10
+
11
+ ## ⚡ Quick Start
12
+
13
+ ```bash
14
+ # Try it instantly (no install required)
15
+ npx @md2do/cli list
16
+
17
+ # Or install globally
18
+ npm install -g @md2do/cli
19
+ md2do list
20
+ ```
21
+
22
+ That's it! md2do will scan all `.md` files in your current directory and show you all your tasks.
23
+
24
+ ## ✨ Features
25
+
26
+ - 📝 **Markdown-native** - Works with standard `- [ ]` task syntax
27
+ - 🔍 **Smart parsing** - Extracts assignees (@user), priorities (!!!), tags (#tag), due dates
28
+ - 🎯 **Powerful filtering** - Filter by any metadata, combine multiple filters
29
+ - 📊 **Rich statistics** - View task breakdowns by assignee, priority, project
30
+ - 🎨 **Beautiful output** - Color-coded, clickable file paths, multiple formats (pretty/table/JSON)
31
+ - 🔄 **Todoist sync** - Two-way sync foundation with Todoist API
32
+ - 🤖 **AI-powered** - MCP server for Claude Code integration
33
+ - ⚡ **Fast** - Built with TypeScript and fast-glob
34
+
35
+ ## 📖 Task Format
36
+
37
+ md2do recognizes standard markdown tasks with optional metadata:
38
+
39
+ ```markdown
40
+ - [ ] Implement user authentication @nick !!! #backend #auth (2026-01-20)
41
+ - [x] Write documentation @jane !! #docs (2026-01-15)
42
+ - [ ] Fix bug in parser @alex ! #bug (2026-01-18)
43
+ ```
44
+
45
+ **Metadata:**
46
+
47
+ - `@username` - Assignee
48
+ - `!!!` / `!!` / `!` - Priority (urgent/high/normal)
49
+ - `#tag` - Tags
50
+ - `(YYYY-MM-DD)` - Due date
51
+ - `[todoist:ID]` - Todoist sync marker
52
+
53
+ ## 🎯 Common Use Cases
54
+
55
+ ### Filter tasks by assignee
56
+
57
+ ```bash
58
+ md2do list --assignee nick
59
+ ```
60
+
61
+ ### Show only urgent tasks
62
+
63
+ ```bash
64
+ md2do list --priority urgent
65
+ ```
66
+
67
+ ### Find overdue tasks
68
+
69
+ ```bash
70
+ md2do list --overdue
71
+ ```
72
+
73
+ ### Combine multiple filters
74
+
75
+ ```bash
76
+ md2do list --assignee nick --priority urgent --tag backend
77
+ ```
78
+
79
+ ### View task statistics
80
+
81
+ ```bash
82
+ # Overall stats
83
+ md2do stats
84
+
85
+ # Group by assignee
86
+ md2do stats --by assignee
87
+ ```
88
+
89
+ ### Different output formats
90
+
91
+ ```bash
92
+ # Pretty format (default)
93
+ md2do list
94
+
95
+ # Table format
96
+ md2do list --format table
97
+
98
+ # JSON for scripting
99
+ md2do list --format json
100
+ ```
101
+
102
+ ## 📁 Context-Aware
103
+
104
+ md2do automatically extracts context from your folder structure:
105
+
106
+ ```
107
+ projects/
108
+ acme-app/ # Project: acme-app
109
+ sprint-planning.md
110
+ bugs.md
111
+ 1-1s/
112
+ nick.md # Person: nick
113
+ jane.md # Person: jane
114
+ ```
115
+
116
+ Then filter by context:
117
+
118
+ ```bash
119
+ md2do list --project acme-app
120
+ md2do list --person jane
121
+ ```
122
+
123
+ ## 🔄 Todoist Integration
124
+
125
+ Sync your markdown tasks with Todoist:
126
+
127
+ ```bash
128
+ # Import a specific task to Todoist
129
+ md2do todoist import tasks.md:15
130
+
131
+ # Sync completion status (dry run first)
132
+ md2do todoist sync --dry-run
133
+ md2do todoist sync
134
+ ```
135
+
136
+ [Full Todoist setup guide →](https://github.com/TeamNickHart/md2do/blob/main/docs/integrations/todoist.md)
137
+
138
+ ## 🤖 AI Integration (MCP)
139
+
140
+ Use Claude Code or other AI assistants to query your tasks through the Model Context Protocol:
141
+
142
+ ```bash
143
+ # Build and configure the MCP server
144
+ npm install -g @md2do/mcp
145
+ ```
146
+
147
+ Then ask Claude:
148
+
149
+ - "What urgent tasks does @nick have?"
150
+ - "Generate my daily standup report"
151
+ - "Show me task breakdown by project"
152
+
153
+ [Full MCP setup guide →](https://github.com/TeamNickHart/md2do/blob/main/packages/mcp/README.md)
154
+
155
+ ## 📚 Full Documentation
156
+
157
+ This README covers the basics. For complete documentation:
158
+
159
+ - **[Full Documentation](https://md2do.com)** - Complete guide, examples, and tutorials
160
+ - **[GitHub Repository](https://github.com/TeamNickHart/md2do)** - Source code, issues, contributions
161
+ - **[CLI Reference](https://github.com/TeamNickHart/md2do/blob/main/docs/cli/overview.md)** - All commands and options
162
+ - **[Configuration Guide](https://github.com/TeamNickHart/md2do/blob/main/docs/guide/configuration.md)** - Config file setup
163
+
164
+ ## 🤝 Contributing
165
+
166
+ Contributions are welcome! Please see our [Contributing Guide](https://github.com/TeamNickHart/md2do/blob/main/docs/development/contributing.md).
167
+
168
+ ## 📄 License
169
+
170
+ MIT © [Nick Hart](https://github.com/TeamNickHart)
171
+
172
+ ---
173
+
174
+ **Made with ❤️ for developers who love markdown**
175
+
176
+ [Report Bug](https://github.com/TeamNickHart/md2do/issues) • [Request Feature](https://github.com/TeamNickHart/md2do/issues) • [Documentation](https://md2do.com)