fmd 0.1.0

Find Markdown files by metadata - Search by tags, frontmatter, and custom fields
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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

# fmd Feature Roadmap

This document outlines planned features and improvements for fmd.

---

## Planned Features

### 1. Sorting Options ⭐⭐⭐⭐
**Status**: TBD
**Impact**: High - Improves usability
**Complexity**: Low

#### Proposed API
```bash
# Sort by different fields
fmd -t Work --sort date         # By frontmatter date
fmd -t Work --sort title        # Alphabetically by title
fmd -t Work --sort modified     # By file modification time
fmd -t Work --sort path         # By file path
fmd -t Work --sort created      # By file creation time

# Reverse order
fmd -t Work --sort date --reverse
```

#### Implementation Notes
- Add `--sort` enum argument: `Date`, `Title`, `Modified`, `Path`, `Created`
- Add `--reverse` boolean flag
- Sort results before output
- Use file system metadata for `modified` and `created`

---

### 2. Content Search ⭐⭐⭐
**Status**: TBD
**Impact**: Medium
**Complexity**: Medium

#### Proposed API
```bash
# Search file content (in addition to metadata)
fmd -t Finance --content "Apple stock"

# Regex search in content
fmd --content-regex "TODO|FIXME"

# Show matching context
fmd --content "Docker" --show-context 3
```

#### Implementation Notes
- Search within file content after metadata filtering
- Use existing `regex` crate
- Option to show surrounding lines (like `grep -C`)
- Respect `--head` limit or search full file

---

### 3. Exclusion Filters (NOT logic) ⭐⭐⭐
**Status**: TBD
**Impact**: Medium
**Complexity**: Low

#### Proposed API
```bash
# Exclude tags
fmd --exclude-tag Archive --exclude-tag Draft

# Exclude file patterns
fmd --exclude-name "private*"

# Exclude directories
fmd --exclude-dir ".git" --exclude-dir "archive"
```

#### Implementation Notes
- Add `exclude_tags`, `exclude_names`, `exclude_dirs` to Args
- Apply exclusion filters after inclusion filters
- Useful for filtering out archived/draft files

---

### 4. Advanced Regex Support ⭐⭐⭐
**Status**: Future
**Impact**: Medium
**Complexity**: Low

#### Enhancements
- Regex caching for repeated patterns
- Better error messages for invalid regex
- Case-insensitive regex flag
- Multi-line regex matching

#### Example
```bash
# OR matching in title
fmd -T "Meeting|Discussion|Standup"

# Strict filename matching
fmd -n "^2025-\d{2}-\d{2}\.md$"
```

---

## 🛠 Technical Improvements

### Performance Optimizations
- [ ] Memory-mapped file I/O for large files
- [ ] Lazy evaluation of metadata
- [ ] SIMD-accelerated string matching
- [ ] Profile-guided optimization (PGO)

### Code Quality
- [ ] Comprehensive test suite
- [ ] Benchmarking suite
- [ ] Documentation improvements
- [ ] Error handling improvements
- [ ] Logging support (`env_logger`)

### Distribution
- [ ] Pre-built binaries for Linux, macOS, Windows
- [ ] Package for Homebrew
- [ ] Package for AUR (Arch Linux)
- [ ] Snap/Flatpak package
- [ ] Docker image

### Shell Integration
- [ ] Bash completion
- [ ] Zsh completion
- [ ] Fish completion
- [ ] PowerShell completion