viepilot 1.0.0

package/workflows/resume-work.md

@@ -0,0 +1,226 @@
+<purpose>
+Restore complete project context và resume work seamlessly từ previous session.
+</purpose>
+
+<process>
+
+<step name="check_project">
+## 1. Check Project Exists
+
+```bash
+if [ ! -f ".viepilot/TRACKER.md" ]; then
+  echo "No ViePilot project found"
+  exit 1
+fi
+```
+
+If not exists → Error and suggest `/vp-crystallize`
+</step>
+
+<step name="load_state">
+## 2. Load State
+
+### Try HANDOFF.json first (preferred)
+```bash
+if [ -f ".viepilot/HANDOFF.json" ]; then
+  cat .viepilot/HANDOFF.json
+fi
+```
+
+Parse:
+- phase, phase_name
+- task, task_name, total_tasks
+- status
+- next_action
+- context_notes
+- blockers
+- human_actions_pending
+
+### Fallback to TRACKER.md
+```bash
+cat .viepilot/TRACKER.md
+```
+Extract current state from file.
+
+### Load .continue-here.md if exists
+```bash
+phase_dir=$(cat .viepilot/HANDOFF.json | jq -r '.phase_dir')
+if [ -f "${phase_dir}/.continue-here.md" ]; then
+  cat "${phase_dir}/.continue-here.md"
+fi
+```
+</step>
+
+<step name="check_uncommitted">
+## 3. Check Uncommitted Changes
+
+```bash
+git status --porcelain
+```
+
+If changes exist:
+```
+⚠ Uncommitted changes detected:
+{list files}
+
+Options:
+1. Continue with changes
+2. Stash changes first
+3. Review changes
+```
+</step>
+
+<step name="rebuild_context">
+## 4. Rebuild Context
+
+Following AI-GUIDE.md strategy:
+
+### Minimal Load (always)
+```bash
+cat .viepilot/AI-GUIDE.md
+cat .viepilot/TRACKER.md
+```
+
+### Phase Load
+```bash
+cat .viepilot/phases/{phase}/PHASE-STATE.md
+cat .viepilot/phases/{phase}/SPEC.md
+```
+
+### Task Load
+```bash
+cat .viepilot/phases/{phase}/tasks/{task}-*.md
+```
+
+### Context Required
+Read `context_required` section from task file.
+Load referenced files.
+</step>
+
+<step name="display_summary">
+## 5. Display State Summary
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT ► RESUME
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ Project: {project_name}
+ Last Activity: {timestamp from HANDOFF}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ CURRENT STATE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ Phase: {phase_number} - {phase_name}
+ Task:  {task_number}/{total} - {task_name}
+ Status: {status}
+
+ Progress: [████████░░] {percent}%
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ CONTEXT
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ {context_notes from HANDOFF.json}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ NEXT ACTION
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ {next_action from HANDOFF.json}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+If blockers exist:
+```
+ ⚠ BLOCKERS
+ - {blocker 1}
+ - {blocker 2}
+```
+
+If human actions pending:
+```
+ 📋 HUMAN ACTIONS NEEDED
+ - {action 1}
+ - {action 2}
+```
+</step>
+
+<step name="offer_options">
+## 6. Offer Options
+
+```
+How would you like to proceed?
+
+1. Continue from task {task} (recommended)
+2. Restart current task from beginning
+3. Skip to next task
+4. View current task details
+5. Run /vp-status for full overview
+6. Start /vp-auto for autonomous mode
+```
+
+Wait for user choice.
+</step>
+
+<step name="route_action">
+## 7. Route to Action
+
+Based on user choice:
+
+**1. Continue:**
+- Context already loaded
+- Display task objective
+- Start working
+
+**2. Restart:**
+- Reset task state in PHASE-STATE.md
+- Rollback if needed
+- Start fresh
+
+**3. Skip:**
+- Ask for skip reason
+- Mark task skipped
+- Move to next
+
+**4. View details:**
+```bash
+cat .viepilot/phases/{phase}/tasks/{task}-*.md
+```
+Display with syntax highlighting
+Return to options
+
+**5. Status:**
+```
+Skill(skill="vp-status")
+```
+
+**6. Auto:**
+```
+Skill(skill="vp-auto", args="--from {phase}")
+```
+</step>
+
+<step name="update_session">
+## 8. Update Session
+
+```bash
+# Update TRACKER.md with session start
+# Mark HANDOFF.json as active (or clear it)
+```
+
+Ready to work.
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] HANDOFF.json or TRACKER.md loaded
+- [ ] Context rebuilt efficiently
+- [ ] State summary displayed clearly
+- [ ] Blockers and human actions shown
+- [ ] User offered appropriate options
+- [ ] Routed to correct next action
+</success_criteria>

package/workflows/rollback.md

@@ -0,0 +1,202 @@
+<purpose>
+Safe rollback to any ViePilot checkpoint với backup và state preservation.
+</purpose>
+
+<process>
+
+<step name="list_checkpoints">
+## 1. List Available Checkpoints
+
+```bash
+git tag -l "vp-*" --sort=-creatordate | head -20
+```
+
+For each tag, get info:
+```bash
+git log -1 --format="%h %ci %s" {tag}
+```
+
+Display formatted list:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ VIEPILOT CHECKPOINTS
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ #  TAG                 DATE        DESCRIPTION
+ 1  vp-p2-t1            2026-03-30  Start Phase 2 Task 1
+ 2  vp-p1-complete      2026-03-30  Phase 1 complete
+ 3  vp-p1-t1-done       2026-03-30  Task 1.1-1.4 complete
+ 4  vp-p1-t1            2026-03-30  Start Phase 1 Task 1
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+If `--list` flag, stop here.
+</step>
+
+<step name="select_target">
+## 2. Select Rollback Target
+
+**If --to specified:**
+Validate tag exists.
+
+**If --latest:**
+Select most recent vp-* tag.
+
+**Otherwise:**
+Ask user to select from list or enter tag name.
+</step>
+
+<step name="preview_changes">
+## 3. Preview Changes
+
+Show what will happen:
+```bash
+# Commits to undo
+git log --oneline {tag}..HEAD
+
+# Files that will change
+git diff --stat {tag}
+```
+
+Display:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ ROLLBACK PREVIEW
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ Target: {tag}
+ Current: {HEAD}
+ 
+ Commits to undo: {count}
+ {commit list}
+ 
+ Files affected: {count}
+ {file list}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+If `--dry-run`, stop here.
+</step>
+
+<step name="confirm_rollback">
+## 4. Confirm Rollback
+
+If not `--force`:
+```
+⚠ WARNING: This will undo {count} commits.
+
+Are you sure you want to rollback to {tag}? [y/N]
+```
+
+Wait for confirmation.
+</step>
+
+<step name="create_backup">
+## 5. Create Backup
+
+```bash
+# Create backup tag
+BACKUP_TAG="vp-backup-$(date +%Y%m%d-%H%M%S)"
+git tag $BACKUP_TAG
+
+# Backup state files
+cp .viepilot/HANDOFF.json .viepilot/HANDOFF.backup.json 2>/dev/null
+cp .viepilot/TRACKER.md .viepilot/TRACKER.backup.md 2>/dev/null
+```
+
+Log backup tag for undo.
+</step>
+
+<step name="execute_rollback">
+## 6. Execute Rollback
+
+```bash
+# Hard reset to target
+git reset --hard {tag}
+```
+
+Verify success:
+```bash
+git log -1 --oneline
+```
+</step>
+
+<step name="update_state">
+## 7. Update State Files
+
+Parse tag to determine phase/task:
+- `vp-p{N}-t{M}` → Phase N, Task M, status: in_progress
+- `vp-p{N}-t{M}-done` → Phase N, Task M+1, status: not_started
+- `vp-p{N}-complete` → Phase N+1, Task 1, status: not_started
+
+Update HANDOFF.json accordingly.
+Update TRACKER.md progress.
+</step>
+
+<step name="confirm_success">
+## 8. Confirm Success
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ ROLLBACK COMPLETE ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+ Rolled back to: {tag}
+ Commits undone: {count}
+ 
+ Backup created: {backup_tag}
+ 
+ Current state:
+   Phase: {phase}
+   Task: {task}
+   Status: {status}
+
+ To undo this rollback:
+   /vp-rollback --to {backup_tag}
+   
+   Or manually:
+   git reset --hard {backup_tag}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+</step>
+
+</process>
+
+<error_handling>
+**If tag doesn't exist:**
+```
+✖ Error: Checkpoint "{tag}" not found
+  Hint: Run /vp-rollback --list to see available checkpoints
+```
+
+**If uncommitted changes:**
+```
+⚠ Warning: You have uncommitted changes
+  
+Options:
+1. Stash changes: git stash
+2. Commit changes: git commit
+3. Discard changes: git checkout -- .
+4. Cancel rollback
+```
+
+**If rollback fails:**
+```
+✖ Rollback failed: {error}
+  
+Recovery:
+  git reset --hard {backup_tag}
+```
+</error_handling>
+
+<success_criteria>
+- [ ] Checkpoints listed correctly
+- [ ] Preview shown before execution
+- [ ] Backup created successfully
+- [ ] Rollback executed cleanly
+- [ ] State files updated
+- [ ] Undo instructions provided
+</success_criteria>

package/workflows/ui-components.md

@@ -0,0 +1,109 @@
+<purpose>
+Curate, classify, and store reusable UI components for future brainstorm and implementation.
+</purpose>
+
+<process>
+
+<step name="prepare_store">
+## 1. Prepare Component Stores
+
+Ensure both stores exist:
+
+```bash
+mkdir -p "$HOME/.viepilot/ui-components"
+mkdir -p ".viepilot/ui-components"
+```
+
+Use:
+- Global store (`$HOME/.viepilot/ui-components`) for cross-project reuse
+- Local store (`.viepilot/ui-components`) for project-specific variants
+</step>
+
+<step name="collect_input">
+## 2. Collect Source Input
+
+Accept sources:
+- 21st.dev prompt/link/snippet
+- Existing component markup
+- User-written constraints and style notes
+
+Capture metadata:
+- source
+- intent
+- target contexts (landing, dashboard, form, etc.)
+</step>
+
+<step name="classify_component">
+## 3. Classify and Normalize
+
+Classify component under one of:
+- base
+- navigation
+- marketing
+- form
+- feedback
+- data-display
+- composite
+
+Normalize naming:
+- kebab-case component id
+- minimal README with usage and constraints
+- keep "raw inspiration" and "adapted draft" clearly separated
+</step>
+
+<step name="write_artifacts">
+## 4. Write Artifacts
+
+For each component, create:
+
+```text
+{store}/{category}/{component-id}/
+  README.md
+  SOURCE.md
+  component.html
+  component.css
+  metadata.json
+```
+
+`metadata.json` minimum fields:
+- `id`
+- `category`
+- `source`
+- `tags`
+- `stack_notes`
+- `status` (`raw` | `adapted` | `approved`)
+</step>
+
+<step name="sync_index">
+## 5. Update Index
+
+Update:
+- `$HOME/.viepilot/ui-components/INDEX.md`
+- `.viepilot/ui-components/INDEX.md`
+
+Each entry includes:
+- component id
+- category
+- status
+- source link/reference
+- last updated date
+</step>
+
+<step name="integration_notes">
+## 6. Integration with Brainstorm/Crystallize
+
+When relevant:
+- Recommend curated components during `/vp-brainstorm --ui`
+- Reference selected component IDs in brainstorm session files
+- Ensure `/vp-crystallize` can map selected IDs to implementation decisions
+</step>
+
+</process>
+
+<success_criteria>
+- [ ] Global and local stores exist
+- [ ] Component classified with consistent taxonomy
+- [ ] README + SOURCE + metadata created
+- [ ] Global/local indexes updated
+- [ ] Component is reusable in future UI direction sessions
+</success_criteria>