From 4459b339ff72c7f4aed3bdb30261178f8a705ce8 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Mon, 3 Nov 2025 21:23:41 +0000
Subject: [PATCH] Add output examples to CLI usage sections
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Enhanced CLI Usage Examples in Phase 1 and Phase 2 with realistic
output examples showing:

Phase 1 (Core & CLI):
- Init command with success messages
- Add tasks with UUID confirmation and due date display
- List command showing task status, counts, and due dates
- Complete/edit/delete with confirmation messages
- Config and sort commands with feedback

Phase 2 (WebDAV Sync):
- Interactive setup with prompts and keychain confirmation
- Push/pull with file upload/download progress
- Automatic two-way sync with change indicators
- Status command showing connection, last sync, and pending changes

All examples now show:
- Command prompts ($)
- Realistic UUIDs
- Success indicators (✓)
- Progress/status information
- Colored output representation (checkmarks, arrows)
- Helpful feedback messages

Makes it much clearer what users can expect from the CLI.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
---
 PLAN.md | 103 ++++++++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 85 insertions(+), 18 deletions(-)

diff --git a/PLAN.md b/PLAN.md
index 42a389a..38a1c4e 100644
--- a/PLAN.md
+++ b/PLAN.md
@@ -283,25 +283,64 @@ tokio = { workspace = true }
 
 ```bash
 # First run: initialize tasks folder
-bevy-tasks init ~/Documents/Tasks
+$ bevy-tasks init ~/Documents/Tasks
+✓ Initialized tasks folder at ~/Documents/Tasks
+✓ Created default list "My Tasks"
 
 # Or use a cloud-synced folder
-bevy-tasks init ~/Dropbox/Tasks
+$ bevy-tasks init ~/Dropbox/Tasks
+✓ Initialized tasks folder at ~/Dropbox/Tasks
+✓ Created default list "My Tasks"
 
-# Then use normally
-bevy-tasks add "Buy groceries" --list "Personal"
-bevy-tasks list
-bevy-tasks list --list "Work"
-bevy-tasks complete <task-id>
-bevy-tasks edit <task-id>
-bevy-tasks delete <task-id>
+# Add tasks
+$ bevy-tasks add "Buy groceries" --list "Personal"
+✓ Created task "Buy groceries" (550e8400-e29b-41d4-a716-446655440000)
+
+$ bevy-tasks add "Review PR #123" --list "Work" --due "2025-11-15"
+✓ Created task "Review PR #123" (7f3a9c21-b8d2-4e5f-9a1c-3d8e7f6a2b1c)
+  Due: 2025-11-15
+
+# List all tasks
+$ bevy-tasks list
+My Tasks (3 tasks)
+  [ ] Buy groceries
+  [ ] Call dentist
+  [✓] Pay bills
+
+Work (2 tasks)
+  [ ] Review PR #123 (due: 2025-11-15)
+  [ ] Team meeting prep
+
+# List tasks in specific list
+$ bevy-tasks list --list "Work"
+Work (2 tasks)
+  [ ] Review PR #123 (due: 2025-11-15)
+  [ ] Team meeting prep
+
+# Complete a task
+$ bevy-tasks complete 550e8400-e29b-41d4-a716-446655440000
+✓ Completed task "Buy groceries"
+
+# Edit a task
+$ bevy-tasks edit 7f3a9c21-b8d2-4e5f-9a1c-3d8e7f6a2b1c
+# Opens editor with task file
+✓ Updated task "Review PR #123"
+
+# Delete a task
+$ bevy-tasks delete 550e8400-e29b-41d4-a716-446655440000
+✓ Deleted task "Buy groceries"
 
 # Change folder location later
-bevy-tasks config set-folder ~/new/location
+$ bevy-tasks config set-folder ~/new/location
+✓ Updated tasks folder location to ~/new/location
+✓ Migrated 15 tasks from ~/Documents/Tasks
 
 # Sort order
-bevy-tasks sort manual --list "Work"
-bevy-tasks sort by-due-date --list "Personal"
+$ bevy-tasks sort manual --list "Work"
+✓ Set sort order to "manual" for list "Work"
+
+$ bevy-tasks sort by-due-date --list "Personal"
+✓ Set sort order to "by due date" for list "Personal"
 ```
 
 ### Deliverables
@@ -399,15 +438,43 @@ keyring = "3.0"
 
 ```bash
 # Setup WebDAV
-bevy-tasks sync --setup
-# Prompts for: URL, username, password (stored in keychain)
+$ bevy-tasks sync --setup
+WebDAV URL: https://nextcloud.example.com/remote.php/dav/files/username/Tasks
+Username: myuser
+Password: ********
+✓ WebDAV credentials saved to system keychain
+✓ Connection verified
 
-# Manual sync
-bevy-tasks sync --push
-bevy-tasks sync --pull
+# Push local changes to WebDAV server
+$ bevy-tasks sync --push
+Syncing to https://nextcloud.example.com/...
+  Uploading My Tasks/.listdata.json
+  Uploading My Tasks/Buy groceries.md
+  Uploading Work/Review PR #123.md
+✓ Pushed 3 files to WebDAV server
+
+# Pull changes from WebDAV server
+$ bevy-tasks sync --pull
+Syncing from https://nextcloud.example.com/...
+  Downloading Work/Team meeting notes.md
+  Downloading Personal/Call mom.md
+✓ Pulled 2 files from WebDAV server
+
+# Automatic two-way sync
+$ bevy-tasks sync
+Syncing with https://nextcloud.example.com/...
+  ↑ Uploading My Tasks/New task.md
+  ↓ Downloading Work/Updated task.md
+  = No changes for 15 files
+✓ Sync complete
 
 # Check sync status
-bevy-tasks sync --status
+$ bevy-tasks sync --status
+WebDAV Server: https://nextcloud.example.com/remote.php/dav/files/username/Tasks
+Status: Connected
+Last sync: 2025-10-27 14:32:15
+Local changes: 2 files modified
+Remote changes: 0 files modified
 ```
 
 ### Deliverables