From 192d81b6002aa5666315c8bed1d22e2fa95e92e5 Mon Sep 17 00:00:00 2001
From: Paul Buetow <paul@buetow.org>
Date: Sun, 22 Mar 2026 07:45:17 +0200
Subject: Add delete, export, and list filter/sort/limit to ask wrapper plan

Amp-Thread-ID: https://ampcode.com/threads/T-019d1407-6145-7534-b780-29a2559d06c5
Co-authored-by: Amp <amp@ampcode.com>
---
 docs/plan-ask-uuid-wrapper.md | 27 ++++++++++++++++++++++++---
 1 file changed, 24 insertions(+), 3 deletions(-)

diff --git a/docs/plan-ask-uuid-wrapper.md b/docs/plan-ask-uuid-wrapper.md
index d6ca3ce..f7425c6 100644
--- a/docs/plan-ask-uuid-wrapper.md
+++ b/docs/plan-ask-uuid-wrapper.md
@@ -25,6 +25,22 @@ The existing `project:<repo> +agent` auto-injection is preserved.
 | `ask dep rm <uuid> <dep-uuid>` | remove dependency | `task uuid:<uuid> modify depends:-<dep-uuid>` |
 | `ask dep list <uuid>` | show dependencies | `task uuid:<uuid> export` → `depends` field |
 | `ask urgency` | list by urgency | `task project:P +agent export` → sort by urgency |
+| `ask delete <uuid>` | delete task | `task uuid:<uuid> delete` |
+| `ask export` | raw JSON dump | `task project:P +agent export` → pass through |
+
+### List filters, sort, and limit
+
+`ask list` accepts optional filters, sort, and limit arguments:
+
+| Example | Taskwarrior equivalent |
+|---|---|
+| `ask list` | `task project:P +agent status:pending export` (default sort: priority-, urgency-) |
+| `ask list +READY` | `task project:P +agent +READY export` |
+| `ask list +BLOCKED` | `task project:P +agent +BLOCKED export` |
+| `ask list +frontend` | `task project:P +agent +frontend export` |
+| `ask list started` | `task project:P +agent start.any: export` |
+| `ask list limit:3` | show only first 3 results |
+| `ask list +READY limit:1` | next ready task |
 
 ## Data Retrieval: `task export`
 
@@ -78,7 +94,9 @@ internal/askcli/             — NEW package
   ├── command_priority.go    — set priority
   ├── command_tag.go         — add/remove tags
   ├── command_dep.go         — dep add/rm/list
-  └── command_urgency.go     — urgency-sorted list
+  ├── command_urgency.go     — urgency-sorted list
+  ├── command_delete.go      — delete task
+  └── command_export.go      — raw JSON export
 ```
 
 Each `command_*.go` file gets a corresponding `command_*_test.go`.
@@ -101,5 +119,8 @@ Each `command_*.go` file gets a corresponding `command_*_test.go`.
 9. Implement `ask tag <uuid> +/-tag`
 10. Implement `ask dep add/rm/list`
 11. Implement `ask urgency`
-12. Wire `cmd/ask/main.go` to `askcli.Dispatch`, remove old pass-through
-13. Update docs and README
+12. Implement `ask delete <uuid>`
+13. Implement `ask export` (raw JSON)
+14. Add filter/sort/limit support to `ask list` (+READY, +BLOCKED, +tag, started, limit:N)
+15. Wire `cmd/ask/main.go` to `askcli.Dispatch`, remove old pass-through
+16. Update docs and README
-- 
cgit v1.2.3