@obsfx/trekker 1.2.2 → 1.4.1

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 (3) hide show
  1. package/README.md +51 -1
  2. package/dist/index.js +1386 -12
  3. package/package.json +2 -1
package/README.md CHANGED
@@ -24,6 +24,8 @@ My concerns about the future and security of that project led me here. Trekker i
24
24
 
25
25
  What you get:
26
26
  - Task and epic tracking with dependencies
27
+ - Full-text search across tasks, epics, subtasks, and comments
28
+ - Unified list view with filtering by type, status, priority, and custom sorting
27
29
  - Optional kanban board UI available as a [separate package](https://github.com/obsfx/trekker-dashboard)
28
30
  - No special directory required. The .trekker folder stays local to your project.
29
31
  - No hook integrations. Just task management.
@@ -83,6 +85,7 @@ trekker epic create -t <title> [-d <desc>] [-p <0-5>] [-s <status>]
83
85
  trekker epic list [--status <status>]
84
86
  trekker epic show <epic-id>
85
87
  trekker epic update <epic-id> [options]
88
+ trekker epic complete <epic-id> # Complete epic and archive all tasks/subtasks
86
89
  trekker epic delete <epic-id>
87
90
  ```
88
91
 
@@ -122,6 +125,53 @@ trekker dep remove <task-id> <depends-on-id>
122
125
  trekker dep list <task-id>
123
126
  ```
124
127
 
128
+ ### Search
129
+
130
+ Full-text search across epics, tasks, subtasks, and comments using FTS5:
131
+
132
+ ```bash
133
+ trekker search <query> [--type <types>] [--status <status>] [--limit <n>] [--page <n>]
134
+ ```
135
+
136
+ Examples:
137
+ ```bash
138
+ trekker search "authentication" # Search all entities
139
+ trekker search "bug fix" --type task,subtask # Search only tasks and subtasks
140
+ trekker search "login" --type comment --status completed # Search comments in completed items
141
+ ```
142
+
143
+ ### History
144
+
145
+ View audit log of all changes (creates, updates, deletes):
146
+
147
+ ```bash
148
+ trekker history [--entity <id>] [--type <types>] [--action <actions>] [--since <date>] [--until <date>]
149
+ ```
150
+
151
+ Examples:
152
+ ```bash
153
+ trekker history # All events
154
+ trekker history --entity TREK-1 # Events for specific entity
155
+ trekker history --type task --action update # Only task updates
156
+ trekker history --since 2025-01-01 --limit 20 # Events after date
157
+ ```
158
+
159
+ ### List
160
+
161
+ Unified view of all epics, tasks, and subtasks:
162
+
163
+ ```bash
164
+ trekker list [--type <types>] [--status <statuses>] [--priority <levels>] [--sort <fields>]
165
+ ```
166
+
167
+ Examples:
168
+ ```bash
169
+ trekker list # All items, newest first
170
+ trekker list --type task --status in_progress # Active tasks only
171
+ trekker list --priority 0,1 --sort priority:asc # Critical/high priority first
172
+ trekker list --sort title:asc,created:desc # Sort by title, then by date
173
+ ```
174
+
125
175
  ### Web Interface
126
176
 
127
177
  For a visual kanban board, install the separate dashboard package:
@@ -148,7 +198,7 @@ See [trekker-claude-code](https://github.com/obsfx/trekker-claude-code) for more
148
198
 
149
199
  ## TOON Output
150
200
 
151
- Add the `--toon` flag to any command for structured output in [TOON format](https://github.com/tooners/toon). TOON is a token-efficient serialization format designed for AI agents, using fewer tokens than JSON while remaining machine-readable:
201
+ Add the `--toon` flag to any command for structured output in [TOON format](https://github.com/toon-format/toon). TOON is a token-efficient serialization format designed for AI agents, using fewer tokens than JSON while remaining machine-readable:
152
202
 
153
203
  ```bash
154
204
  trekker --toon task list