planflow-plugin 0.1.0

package/commands/pfUnassign/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: pfUnassign
+description: Remove assignment from a task in the current PlanFlow project
+---
+
+# PlanFlow Task Unassignment
+
+Remove the assignee from a task in the linked cloud project with unassignment card.
+
+## Usage
+
+```bash
+/pfUnassign <task-id>        # Remove assignment from task
+/pfUnassign T2.1             # Example
+```
+
+## Step 0: Load Configuration
+
+```javascript
+// ... standard config loading ...
+```
+
+## Step 1: Show Usage Card (if no arguments)
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  📋 Task Unassignment                                                        │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ── Usage ───────────────────────────────────────────────────────────────    │
+│                                                                              │
+│  /pfUnassign <task-id>    Remove assignment from task                        │
+│                                                                              │
+│  ── Example ────────────────────────────────────────────────────────────     │
+│                                                                              │
+│  /pfUnassign T2.1                                                            │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 2: Display Success Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Assignment removed!                                                         │
+│                                                                              │
+│  ── Unassignment Details ───────────────────────────────────────────────     │
+│                                                                              │
+│  📋 Task:         T2.1: Implement login API                                  │
+│  👤 Removed from: Jane Smith (jane@company.com)                              │
+│  📁 Project:      Planflow Plugin                                            │
+│                                                                              │
+│  ╭───────────────────╮                                                       │
+│  │ ✓ Unassigned      │                                                       │
+│  ╰───────────────────╯                                                       │
+│                                                                              │
+│  The task is now available for anyone to pick up.                            │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.commands}                                                   │
+│     • /pfAssign T2.1 <email>      Reassign to someone                        │
+│     • /pfAssign T2.1 me           Assign to yourself                         │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Error Handling
+
+**Task Not Found Card (404):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Task not found: T2.1                                                        │
+│                                                                              │
+│  Make sure the task exists in the cloud project.                             │
+│                                                                              │
+│  💡 Run /pfSyncPush to sync your local tasks first.                          │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Task Not Assigned Card (400):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ⚠️  WARNING                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Task T2.1 has no assignee.                                                  │
+│                                                                              │
+│  This task is not currently assigned to anyone.                              │
+│                                                                              │
+│  💡 To assign it:                                                            │
+│     • /pfAssign T2.1 <email>                                                 │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Permission Denied Card (403):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  You don't have permission to unassign tasks.                                │
+│                                                                              │
+│  Only editors and above can modify task assignments.                         │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Invalid Task ID Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Invalid task ID format.                                                     │
+│                                                                              │
+│  Task ID should be like: T1.1, T2.3, T10.5                                   │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+

package/commands/pfWhoami/SKILL.md

@@ -0,0 +1,258 @@
+---
+name: pfWhoami
+description: PlanFlow Who Am I
+---
+
+# PlanFlow Who Am I
+
+Display current PlanFlow user information and connection status with modern card UI.
+
+## Usage
+
+```bash
+/pfWhoami                   # Show current user info
+```
+
+## Step 0: Load Configuration
+
+```javascript
+function getConfig() {
+  const globalConfigPath = expandPath("~/.config/claude/plan-plugin-config.json")
+  if (fileExists(globalConfigPath)) {
+    try {
+      return JSON.parse(readFile(globalConfigPath))
+    } catch (error) {}
+  }
+  return { "language": "en" }
+}
+
+const config = getConfig()
+const language = config.language || "en"
+const cloudConfig = config.cloud || {}
+const isAuthenticated = !!cloudConfig.apiToken
+const apiUrl = cloudConfig.apiUrl || "https://api.planflow.tools"
+
+const t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Check Auth Status
+
+If not authenticated, display error card:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ {t.ui.alerts.error}                                                      │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.whoami.notLoggedIn}                                             │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfLogin                                                               │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 2: Get User Info from API
+
+**API Call:**
+```bash
+curl -s \
+  -H "Authorization: Bearer {TOKEN}" \
+  "https://api.planflow.tools/auth/me"
+```
+
+**Response:**
+```json
+{
+  "success": true,
+  "data": {
+    "id": "uuid",
+    "email": "user@example.com",
+    "name": "John Doe",
+    "projectCount": 5
+  }
+}
+```
+
+## Step 3: Display User Info Card
+
+**Output Format:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  👤 {t.commands.whoami.title}                                                │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.whoami.name}    John Doe                                        │
+│  {t.commands.whoami.email}   user@example.com                                │
+│  {t.commands.whoami.userId}  uuid-1234-5678-abcd                             │
+│  {t.commands.whoami.apiUrl}  https://api.planflow.tools                      │
+│                                                                              │
+│  ── {t.commands.whoami.status} ──────────────────────────────────────────    │
+│                                                                              │
+│  ╭────────────────╮                                                          │
+│  │ ✓ {t.commands.whoami.connected} │                                         │
+│  ╰────────────────╯                                                          │
+│                                                                              │
+│  ── {t.commands.whoami.cloudStats} ─────────────────────────────────────     │
+│                                                                              │
+│  {t.commands.whoami.projects}  5                                             │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.quickActions}                                               │
+│     • /pfCloudList           View your projects                              │
+│     • /pfSyncStatus          Check sync status                               │
+│     • /pfLogout              Sign out                                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**Example Output (English):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  👤 Current User                                                             │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Name:     John Doe                                                          │
+│  Email:    user@example.com                                                  │
+│  User ID:  uuid-1234-5678-abcd                                               │
+│  API URL:  https://api.planflow.tools                                        │
+│                                                                              │
+│  ── Status ──────────────────────────────────────────────────────────────    │
+│                                                                              │
+│  ╭────────────────╮                                                          │
+│  │ ✓ Connected    │                                                          │
+│  ╰────────────────╯                                                          │
+│                                                                              │
+│  ── Cloud Stats ─────────────────────────────────────────────────────────    │
+│                                                                              │
+│  Projects:  5                                                                │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Quick Actions:                                                           │
+│     • /pfCloudList           View your projects                              │
+│     • /pfSyncStatus          Check sync status                               │
+│     • /pfLogout              Sign out                                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**Example Output (Georgian):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  👤 მიმდინარე მომხმარებელი                                                   │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  სახელი:           John Doe                                                  │
+│  ელ-ფოსტა:         user@example.com                                          │
+│  მომხმარებლის ID:  uuid-1234-5678-abcd                                       │
+│  API URL:          https://api.planflow.tools                                │
+│                                                                              │
+│  ── სტატუსი ─────────────────────────────────────────────────────────────    │
+│                                                                              │
+│  ╭─────────────────────╮                                                     │
+│  │ ✓ დაკავშირებულია    │                                                     │
+│  ╰─────────────────────╯                                                     │
+│                                                                              │
+│  ── Cloud სტატისტიკა ────────────────────────────────────────────────────    │
+│                                                                              │
+│  პროექტები:  5                                                               │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 სწრაფი მოქმედებები:                                                      │
+│     • /pfCloudList           პროექტების ნახვა                                │
+│     • /pfSyncStatus          სინქრონიზაციის სტატუსი                          │
+│     • /pfLogout              გამოსვლა                                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Error Handling
+
+**Token Expired Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Session expired. Please login again.                                        │
+│                                                                              │
+│  💡 Next Steps:                                                              │
+│     • /pfLogin               Re-authenticate                                 │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Network Error Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Could not connect to PlanFlow API.                                          │
+│                                                                              │
+│  Please check your internet connection and try again.                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Pseudo-code for Rendering
+
+```javascript
+function renderWhoamiCard(userData, t) {
+  const width = 80
+  const innerWidth = width - 4
+
+  let output = ""
+
+  // Top border
+  output += "╭" + "─".repeat(width - 2) + "╮\n"
+
+  // Title
+  const title = `👤 ${t.commands.whoami.title}`
+  output += "│  " + title.padEnd(innerWidth) + "│\n"
+
+  // Divider
+  output += "├" + "─".repeat(width - 2) + "┤\n"
+
+  // Empty line
+  output += "│" + " ".repeat(width - 2) + "│\n"
+
+  // User info
+  const labelWidth = 12
+  output += `│  ${t.commands.whoami.name.padEnd(labelWidth)} ${userData.name.padEnd(innerWidth - labelWidth - 2)}│\n`
+  output += `│  ${t.commands.whoami.email.padEnd(labelWidth)} ${userData.email.padEnd(innerWidth - labelWidth - 2)}│\n`
+  output += `│  ${t.commands.whoami.userId.padEnd(labelWidth)} ${userData.id.padEnd(innerWidth - labelWidth - 2)}│\n`
+  output += `│  ${t.commands.whoami.apiUrl.padEnd(labelWidth)} ${apiUrl.padEnd(innerWidth - labelWidth - 2)}│\n`
+
+  // Empty line
+  output += "│" + " ".repeat(width - 2) + "│\n"
+
+  // Status section header
+  output += `│  ── ${t.commands.whoami.status} ${"─".repeat(innerWidth - t.commands.whoami.status.length - 6)}│\n`
+  output += "│" + " ".repeat(width - 2) + "│\n"
+
+  // Status badge
+  const statusText = `✓ ${t.commands.whoami.connected}`
+  output += `│  ╭${"─".repeat(statusText.length + 2)}╮${"".padEnd(innerWidth - statusText.length - 6)}│\n`
+  output += `│  │ ${statusText} │${"".padEnd(innerWidth - statusText.length - 6)}│\n`
+  output += `│  ╰${"─".repeat(statusText.length + 2)}╯${"".padEnd(innerWidth - statusText.length - 6)}│\n`
+
+  // ... continue with cloud stats and actions
+
+  // Shadow
+  output += " " + "░".repeat(width - 1) + "\n"
+
+  return output
+}
+```

package/commands/pfWorkload/SKILL.md

@@ -0,0 +1,219 @@
+---
+name: pfWorkload
+description: View team workload distribution for the current PlanFlow project
+---
+
+# PlanFlow Team Workload
+
+Display team workload distribution with visual progress bars for each team member.
+
+## Usage
+
+```bash
+/pfWorkload                    # Show team workload overview
+/pfWorkload --details          # Show detailed task breakdown per member
+```
+
+## Step 0: Load Configuration
+
+```javascript
+// ... standard config loading ...
+```
+
+## Step 0.5: Show Notification Badge (v1.6.0+)
+
+**Purpose:** Display unread notification count to keep users informed of team activity.
+
+**When to Execute:** Only if authenticated AND linked to a project.
+
+```bash
+# Only proceed if authenticated and linked
+if [ -n "$TOKEN" ] && [ -n "$PROJECT_ID" ]; then
+  RESPONSE=$(curl -s --connect-timeout 3 --max-time 5 \
+    -X GET \
+    -H "Accept: application/json" \
+    -H "Authorization: Bearer $TOKEN" \
+    "${API_URL}/projects/${PROJECT_ID}/notifications?limit=1&unread=true" 2>/dev/null)
+
+  if [ $? -eq 0 ]; then
+    UNREAD_COUNT=$(echo "$RESPONSE" | grep -o '"unreadCount":[0-9]*' | grep -o '[0-9]*')
+    if [ -n "$UNREAD_COUNT" ] && [ "$UNREAD_COUNT" -gt 0 ]; then
+      echo "🔔 $UNREAD_COUNT unread notification(s) — /pfNotifications to view"
+      echo ""
+    fi
+  fi
+fi
+```
+
+See: `skills/notification-badge/SKILL.md` for full implementation details.
+
+## Step 1: Display Workload Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  📊 Team Workload                                                            │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  📁 Project: Planflow Plugin                                                 │
+│  📋 Total Tasks: 24                                                          │
+│                                                                              │
+│  ── Workload Distribution ──────────────────────────────────────────────     │
+│                                                                              │
+│  John         ████████████████████░░░░░░░░░░  8 tasks (2 in progress)        │
+│  Jane         ██████████████░░░░░░░░░░░░░░░░  6 tasks (1 in progress)        │
+│  Bob          ████████░░░░░░░░░░░░░░░░░░░░░░  4 tasks                        │
+│                                                                              │
+│  ── Unassigned ─────────────────────────────────────────────────────────     │
+│                                                                              │
+│  📭 12 tasks are not assigned                                                │
+│                                                                              │
+│  ── Summary ────────────────────────────────────────────────────────────     │
+│                                                                              │
+│  Average per member: 6.0 tasks                                               │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.commands}                                                   │
+│     • /pfAssign <task-id> <email>    Assign unassigned tasks                 │
+│     • /pfWorkload --details          View detailed breakdown                 │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Step 2: Detailed Workload Card (--details)
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  📊 Team Workload                                                            │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  📁 Project: Planflow Plugin                                                 │
+│  📋 Total Tasks: 24                                                          │
+│                                                                              │
+│  ── Workload Distribution ──────────────────────────────────────────────     │
+│                                                                              │
+│  John         ████████████████████░░░░░░░░░░  8 tasks (2 in progress)        │
+│  Jane         ██████████████░░░░░░░░░░░░░░░░  6 tasks (1 in progress)        │
+│  Bob          ████████░░░░░░░░░░░░░░░░░░░░░░  4 tasks                        │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ── Detailed Breakdown ─────────────────────────────────────────────────     │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  👤 John Doe (john@company.com)                                        │  │
+│  │     🔄 In Progress:                                                    │  │
+│  │        T2.1 - API endpoints                                            │  │
+│  │        T2.4 - Database schema                                          │  │
+│  │     ○ To Do:                                                           │  │
+│  │        T2.3 - Validation                                               │  │
+│  │        T2.5 - Error handling                                           │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  👤 Jane Smith (jane@company.com)                                      │  │
+│  │     🔄 In Progress:                                                    │  │
+│  │        T3.5 - Dashboard                                                │  │
+│  │     ○ To Do:                                                           │  │
+│  │        T3.6 - Charts                                                   │  │
+│  │        T3.7 - Reports                                                  │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  👤 Bob Wilson (bob@company.com)                                       │  │
+│  │     ○ To Do:                                                           │  │
+│  │        T4.1 - Testing                                                  │  │
+│  │        T4.2 - Documentation                                            │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ── Unassigned Tasks ───────────────────────────────────────────────────     │
+│                                                                              │
+│  📭 T5.1 - Deployment                                                        │
+│  📭 T5.2 - CI/CD setup                                                       │
+│  📭 T5.3 - Monitoring                                                        │
+│     ... and 9 more                                                           │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.commands}                                                   │
+│     • /pfAssign T5.1 bob@company.com    Assign a task                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Step 3: Only Owner Card (Empty Team)
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  📊 Team Workload                                                            │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  📁 Project: Planflow Plugin                                                 │
+│  📋 Total Tasks: 15                                                          │
+│                                                                              │
+│  ── Workload Distribution ──────────────────────────────────────────────     │
+│                                                                              │
+│  You          ██████████████░░░░░░░░░░░░░░░░  7 tasks (1 in progress)        │
+│                                                                              │
+│  📭 Unassigned: 8 tasks                                                      │
+│                                                                              │
+│  ℹ️  You're the only team member.                                             │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 To distribute workload:                                                  │
+│     • /pfTeamInvite <email>          Invite team members                     │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Workload Imbalance Warning
+
+When workload is significantly unbalanced:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ⚠️  Workload Imbalance Detected                                             │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  John has 12 tasks while Bob has only 2 tasks.                               │
+│                                                                              │
+│  Consider redistributing tasks for better balance.                           │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Error Handling
+
+**Not Authenticated Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.sync.notAuthenticated}                                          │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfLogin               Sign in to PlanFlow                             │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Network Error Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Network error. Could not fetch workload data.                               │
+│                                                                              │
+│  Please check your connection and try again.                                 │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+