planflow-plugin 0.1.0

package/commands/pfLogin/SKILL.md

@@ -0,0 +1,249 @@
+---
+name: pfLogin
+description: PlanFlow Login
+---
+
+# PlanFlow Login
+
+Authenticate with PlanFlow project management service with login card UI and spinner.
+
+**IMPORTANT:** This is ONLY for PlanFlow (planflow.tools) - NOT for Claude or Claude Code authentication.
+
+## Usage
+
+```bash
+/pfLogin                    # Interactive - prompts for token
+/pfLogin pf_abc123...       # Direct token input
+```
+
+## Step 0: Load Configuration
+
+```javascript
+function getConfig() {
+  const localConfigPath = "./.plan-config.json"
+  if (fileExists(localConfigPath)) {
+    try {
+      return JSON.parse(readFile(localConfigPath))
+    } catch (error) {}
+  }
+  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 Current Auth Status
+
+If already authenticated, display warning card:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ⚠️  WARNING                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Already logged in as {email}                                                │
+│                                                                              │
+│  To switch accounts, run /pfLogout first.                                    │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.options}                                                    │
+│     • /pfLogout              Sign out and switch accounts                    │
+│     • /pfWhoami              View current user info                          │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 2: Get Token
+
+If token provided as argument, use it. Otherwise, display prompt card:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  🔐 PlanFlow Login                                                           │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.login.enterToken}                                               │
+│                                                                              │
+│  ── Get Your Token ──────────────────────────────────────────────────────    │
+│                                                                              │
+│  1. Visit: https://planflow.tools/settings/api-tokens                        │
+│  2. Click "Generate New Token"                                               │
+│  3. Copy the token (starts with pf_)                                         │
+│  4. Paste below or run: /pfLogin pf_your_token                               │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 3: Validate Token (with Spinner)
+
+**Loading Card (during validation):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  🔐 PlanFlow Login                                                           │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ⠹ {t.ui.labels.validating}                                                  │
+│                                                                              │
+│  Connecting to api.planflow.tools...                                         │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**API Call:**
+```bash
+curl -s -X POST \
+  -H "Content-Type: application/json" \
+  -d '{"token": "{TOKEN}"}' \
+  "https://api.planflow.tools/api-tokens/verify"
+```
+
+**IMPORTANT:** The token must be passed in the **request body** as JSON, NOT in the Authorization header!
+
+**Success Response (HTTP 200):**
+```json
+{
+  "success": true,
+  "data": {
+    "user": {
+      "id": "uuid",
+      "email": "user@example.com",
+      "name": "John Doe"
+    },
+    "tokenName": "My CLI Token"
+  }
+}
+```
+
+## Step 4: Save Credentials
+
+Save to global config (`~/.config/claude/plan-plugin-config.json`):
+
+**IMPORTANT:**
+- Create the directory if it doesn't exist: `mkdir -p ~/.config/claude`
+- Use the Write tool to save the config file
+
+```json
+{
+  "language": "en",
+  "cloud": {
+    "apiUrl": "https://api.planflow.tools",
+    "apiToken": "pf_xxx...",
+    "savedAt": "2026-02-02T12:00:00Z",
+    "verified": true,
+    "userId": "uuid-from-response",
+    "userEmail": "email-from-response",
+    "userName": "name-from-response"
+  }
+}
+```
+
+## Step 5: Show Success Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.login.success}                                                  │
+│                                                                              │
+│  ── Account Info ────────────────────────────────────────────────────────    │
+│                                                                              │
+│  👤 Name:   {response.data.user.name}                                        │
+│  📧 Email:  {response.data.user.email}                                       │
+│  🔑 Token:  {response.data.tokenName}                                        │
+│                                                                              │
+│  ╭────────────────╮                                                          │
+│  │ ✓ Connected    │                                                          │
+│  ╰────────────────╯                                                          │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.commands.login.nowYouCan}                                             │
+│     • /pfCloudList           View your projects                              │
+│     • /pfCloudLink           Link to a project                               │
+│     • /pfSyncPush            Push local to cloud                             │
+│     • /pfSyncPull            Pull from cloud                                 │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**Example Output (English):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Successfully logged in!                                                     │
+│                                                                              │
+│  ── Account Info ────────────────────────────────────────────────────────    │
+│                                                                              │
+│  👤 Name:   John Doe                                                         │
+│  📧 Email:  john@example.com                                                 │
+│  🔑 Token:  My CLI Token                                                     │
+│                                                                              │
+│  ╭────────────────╮                                                          │
+│  │ ✓ Connected    │                                                          │
+│  ╰────────────────╯                                                          │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Now you can:                                                             │
+│     • /pfCloudList           View your projects                              │
+│     • /pfCloudLink           Link to a project                               │
+│     • /pfSyncPush            Push local to cloud                             │
+│     • /pfSyncPull            Pull from cloud                                 │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Error Handling
+
+**Invalid Token Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.login.invalidToken}                                             │
+│                                                                              │
+│  The token you provided is invalid or expired.                               │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     1. Visit: https://planflow.tools/settings/api-tokens                     │
+│     2. Generate a new token                                                  │
+│     3. Run: /pfLogin <new_token>                                             │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Network Error Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Network error. Could not connect to PlanFlow API.                           │
+│                                                                              │
+│  Please check your internet connection and try again.                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```

package/commands/pfLogout/SKILL.md

@@ -0,0 +1,155 @@
+---
+name: pfLogout
+description: PlanFlow Logout
+---
+
+# PlanFlow Logout
+
+Clear PlanFlow credentials and disconnect from cloud with confirmation card.
+
+**IMPORTANT:** This is ONLY for PlanFlow (planflow.tools) - NOT for Claude or Claude Code logout.
+
+## Usage
+
+```bash
+/pfLogout                   # Clear credentials
+```
+
+## 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 t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Check Auth Status
+
+If not authenticated, display info card:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ℹ️  INFO                                                                     │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.logout.notLoggedIn}                                             │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfLogin               Sign in to PlanFlow                             │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Example (English):**
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ℹ️  INFO                                                                     │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  You are not currently logged in.                                            │
+│                                                                              │
+│  💡 Next Steps:                                                              │
+│     • /pfLogin               Sign in to PlanFlow                             │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 2: Clear Credentials
+
+Remove from global config (`~/.config/claude/plan-plugin-config.json`):
+- `cloud.apiToken`
+- `cloud.userId`
+- `cloud.userEmail`
+
+Keep other settings like `language` and `cloud.apiUrl`.
+
+## Step 3: Show Success Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.logout.success}                                                 │
+│                                                                              │
+│  {t.commands.logout.cleared}                                                 │
+│                                                                              │
+│  ── What's Changed ──────────────────────────────────────────────────────    │
+│                                                                              │
+│  • API token removed                                                         │
+│  • Cloud sync disabled                                                       │
+│  • Local settings preserved                                                  │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfLogin               Sign in again                                   │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**Example Output (English):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Successfully logged out from PlanFlow.                                      │
+│                                                                              │
+│  Credentials cleared from global config.                                     │
+│                                                                              │
+│  ── What's Changed ──────────────────────────────────────────────────────    │
+│                                                                              │
+│  • API token removed                                                         │
+│  • Cloud sync disabled                                                       │
+│  • Local settings preserved                                                  │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Next Steps:                                                              │
+│     • /pfLogin               Sign in again                                   │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**Example Output (Georgian):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ წარმატება                                                                │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  წარმატებით გამოხვედით PlanFlow-დან.                                         │
+│                                                                              │
+│  კრედენციალები წაიშალა გლობალური კონფიგურაციიდან.                            │
+│                                                                              │
+│  ── რა შეიცვალა ─────────────────────────────────────────────────────────    │
+│                                                                              │
+│  • API ტოკენი წაშლილია                                                       │
+│  • Cloud სინქრონიზაცია გამორთულია                                            │
+│  • ლოკალური პარამეტრები შენარჩუნებულია                                       │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 შემდეგი ნაბიჯები:                                                        │
+│     • /pfLogin               ხელახლა შესვლა                                  │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```

package/commands/pfMyTasks/SKILL.md

@@ -0,0 +1,198 @@
+---
+name: pfMyTasks
+description: View tasks assigned to you in the current PlanFlow project
+---
+
+# PlanFlow My Tasks
+
+View all tasks assigned to you in the linked cloud project with task list cards.
+
+## Usage
+
+```bash
+/pfMyTasks                    # Show all your assigned tasks
+/pfMyTasks --status todo      # Filter by status (todo, in_progress, done, blocked)
+/pfMyTasks --all              # Include completed tasks (hidden by default)
+```
+
+## 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 My Tasks Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  📋 My Assigned Tasks                                                        │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  📁 Project: Planflow Plugin                                                 │
+│                                                                              │
+│  ── In Progress (1) ────────────────────────────────────────────────────     │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  🔄 T2.1 - Implement login API                                         │  │
+│  │     🔴 High complexity                                                 │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ── To Do (2) ──────────────────────────────────────────────────────────     │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  ○ T2.3 - Add validation                                               │  │
+│  │     🟡 Medium complexity                                               │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  ○ T3.1 - Create dashboard                                             │  │
+│  │     🟢 Low complexity                                                  │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Quick actions:                                                           │
+│     • /planUpdate T2.1 done       Mark current task as done                  │
+│     • /pfMyTasks --all            Include completed tasks                    │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**With Blocked Tasks:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  📋 My Assigned Tasks                                                        │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  📁 Project: Planflow Plugin                                                 │
+│                                                                              │
+│  ── In Progress (1) ────────────────────────────────────────────────────     │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  🔄 T2.1 - Implement login API                                         │  │
+│  │     🔴 High complexity                                                 │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ── Blocked (1) ────────────────────────────────────────────────────────     │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  🚫 T2.5 - Setup database                                              │  │
+│  │     🟡 Medium complexity                                               │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ── To Do (1) ──────────────────────────────────────────────────────────     │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  ○ T2.3 - Add validation                                               │  │
+│  │     🟡 Medium complexity                                               │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Quick actions:                                                           │
+│     • /planUpdate T2.1 done       Mark current task as done                  │
+│     • /planUpdate T2.5 unblock    Unblock task                               │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Step 2: No Tasks Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  📋 My Assigned Tasks                                                        │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  📁 Project: Planflow Plugin                                                 │
+│                                                                              │
+│  ╭─────────────────────────────────────────────────────────────────────╮     │
+│  │                                                                     │     │
+│  │  📭 You don't have any assigned tasks.                              │     │
+│  │                                                                     │     │
+│  ╰─────────────────────────────────────────────────────────────────────╯     │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Get started:                                                             │
+│     • /planNext                   Find tasks to work on                      │
+│     • /pfAssign T1.1 me           Assign yourself a task                     │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Error Handling
+
+**Not Authenticated Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.sync.notAuthenticated}                                          │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfLogin               Sign in to PlanFlow                             │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Not Linked Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.sync.notLinked}                                                 │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfCloudLink           Link to a cloud project                         │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Invalid Status Filter Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Invalid status filter.                                                      │
+│                                                                              │
+│  Valid statuses: todo, in_progress, done, blocked                            │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+