planflow-plugin 0.1.0

package/commands/pfSyncStatus/SKILL.md

@@ -0,0 +1,212 @@
+---
+name: pfSyncStatus
+description: Show synchronization status between local and PlanFlow cloud
+---
+
+# PlanFlow Sync Status
+
+Show synchronization status between local PROJECT_PLAN.md and PlanFlow cloud with comparison card.
+
+## Usage
+
+```bash
+/pfSyncStatus
+```
+
+## Step 0: Load Configuration
+
+```javascript
+function getConfig() {
+  const localConfigPath = "./.plan-config.json"
+  let localConfig = {}
+  if (fileExists(localConfigPath)) {
+    try { localConfig = JSON.parse(readFile(localConfigPath)) } catch {}
+  }
+
+  const globalConfigPath = expandPath("~/.config/claude/plan-plugin-config.json")
+  let globalConfig = {}
+  if (fileExists(globalConfigPath)) {
+    try { globalConfig = JSON.parse(readFile(globalConfigPath)) } catch {}
+  }
+
+  return { ...globalConfig, ...localConfig }
+}
+
+const config = getConfig()
+const language = config.language || "en"
+const cloudConfig = config.cloud || {}
+const isAuthenticated = !!cloudConfig.apiToken
+const projectId = cloudConfig.projectId
+const apiUrl = cloudConfig.apiUrl || "https://api.planflow.tools"
+
+const t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Validate Prerequisites
+
+**Not authenticated card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.sync.notAuthenticated}                                          │
+│                                                                              │
+│  You must be logged in to check sync status.                                 │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfLogin               Sign in to PlanFlow                             │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Not linked card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.sync.notLinked}                                                 │
+│                                                                              │
+│  This project is not linked to any cloud project.                            │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfCloudLink           Link to a cloud project                         │
+│     • /pfCloudList           View available projects                         │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 2: Fetch and Compare Status
+
+**Loading Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  📊 Sync Status                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ⠹ {t.ui.labels.fetching}                                                    │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 3: Display Sync Status Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  📊 {t.commands.sync.status}                                                 │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ── Local vs Cloud ──────────────────────────────────────────────────────    │
+│                                                                              │
+│  ┌─────────────────────────────────┬─────────────────────────────────────┐   │
+│  │ 📁 LOCAL                        │ ☁️  CLOUD                            │   │
+│  ├─────────────────────────────────┼─────────────────────────────────────┤   │
+│  │ PROJECT_PLAN.md                 │ {projectName}                       │   │
+│  │ Modified: 5 min ago             │ Synced: 2 hours ago                 │   │
+│  │ Tasks: 15 done, 5 in progress   │ Tasks: 13 done, 7 in progress       │   │
+│  └─────────────────────────────────┴─────────────────────────────────────┘   │
+│                                                                              │
+│  ── Sync Status ─────────────────────────────────────────────────────────    │
+│                                                                              │
+│  ╭───────────────────╮                                                       │
+│  │ ⚠️  Local Ahead    │                                                       │
+│  ╰───────────────────╯                                                       │
+│                                                                              │
+│  ── Changes Detected ────────────────────────────────────────────────────    │
+│                                                                              │
+│  Local changes (not synced):                                                 │
+│  • ✅ T2.1 marked as done                                                    │
+│  • ✅ T2.2 marked as done                                                    │
+│  • 📝 T3.1 description changed                                               │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfSyncPush            Push local changes to cloud                     │
+│     • /pfSyncPull            Pull cloud changes (overwrites local)           │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**In Sync Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  📊 Sync Status                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ── Local vs Cloud ──────────────────────────────────────────────────────    │
+│                                                                              │
+│  ┌─────────────────────────────────┬─────────────────────────────────────┐   │
+│  │ 📁 LOCAL                        │ ☁️  CLOUD                            │   │
+│  ├─────────────────────────────────┼─────────────────────────────────────┤   │
+│  │ PROJECT_PLAN.md                 │ E-commerce App                      │   │
+│  │ Modified: 30 min ago            │ Synced: 30 min ago                  │   │
+│  │ Tasks: 15 done, 5 in progress   │ Tasks: 15 done, 5 in progress       │   │
+│  └─────────────────────────────────┴─────────────────────────────────────┘   │
+│                                                                              │
+│  ── Sync Status ─────────────────────────────────────────────────────────    │
+│                                                                              │
+│  ╭──────────────────╮                                                        │
+│  │ ✓ In Sync        │                                                        │
+│  ╰──────────────────╯                                                        │
+│                                                                              │
+│  Local and cloud are synchronized. No action needed.                         │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Cloud Ahead Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  📊 Sync Status                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ── Local vs Cloud ──────────────────────────────────────────────────────    │
+│                                                                              │
+│  ┌─────────────────────────────────┬─────────────────────────────────────┐   │
+│  │ 📁 LOCAL                        │ ☁️  CLOUD                            │   │
+│  ├─────────────────────────────────┼─────────────────────────────────────┤   │
+│  │ PROJECT_PLAN.md                 │ E-commerce App                      │   │
+│  │ Modified: 2 hours ago           │ Synced: 15 min ago                  │   │
+│  │ Tasks: 13 done, 7 in progress   │ Tasks: 15 done, 5 in progress       │   │
+│  └─────────────────────────────────┴─────────────────────────────────────┘   │
+│                                                                              │
+│  ── Sync Status ─────────────────────────────────────────────────────────    │
+│                                                                              │
+│  ╭───────────────────╮                                                       │
+│  │ ☁️  Cloud Ahead    │                                                       │
+│  ╰───────────────────╯                                                       │
+│                                                                              │
+│  Cloud has newer changes from team members.                                  │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Next Steps:                                                              │
+│     • /pfSyncPull            Pull cloud changes to local                     │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Error Handling
+
+**Network Error Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Network error. Could not connect to PlanFlow API.                           │
+│                                                                              │
+│  Please check your internet connection and try again.                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```

package/commands/pfTeamInvite/SKILL.md

@@ -0,0 +1,161 @@
+---
+name: pfTeamInvite
+description: Invite a team member to the current PlanFlow project
+---
+
+# PlanFlow Team Invite
+
+Send an invitation to add a new team member to the linked cloud project with invite card.
+
+## Usage
+
+```bash
+/pfTeamInvite <email>                # Invite with default role (editor)
+/pfTeamInvite <email> <role>         # Invite with specific role
+```
+
+## Available Roles
+
+| Role | Permissions |
+|------|-------------|
+| `admin` | Full access, can manage team members |
+| `editor` | Can edit tasks and plan (default) |
+| `viewer` | Read-only access |
+
+## Step 0: Load Configuration
+
+```javascript
+function getConfig() {
+  // ... standard config loading ...
+}
+
+const config = getConfig()
+const language = config.language || "en"
+const cloudConfig = config.cloud || {}
+const isAuthenticated = !!cloudConfig.apiToken
+const projectId = cloudConfig.projectId
+const apiUrl = cloudConfig.apiUrl || "https://api.planflow.tools"
+
+const t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Show Usage Card (if no arguments)
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  📨 Team Invite                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ── Usage ───────────────────────────────────────────────────────────────    │
+│                                                                              │
+│  /pfTeamInvite <email>           Invite with default role (editor)           │
+│  /pfTeamInvite <email> <role>    Invite with specific role                   │
+│                                                                              │
+│  ── Available Roles ─────────────────────────────────────────────────────    │
+│                                                                              │
+│  admin   - Full access, can manage team members                              │
+│  editor  - Can edit tasks and plan (default)                                 │
+│  viewer  - Read-only access                                                  │
+│                                                                              │
+│  ── Examples ────────────────────────────────────────────────────────────    │
+│                                                                              │
+│  /pfTeamInvite alice@company.com                                             │
+│  /pfTeamInvite bob@company.com admin                                         │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 2: Validate & Send Invitation
+
+**Loading Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  📨 Team Invite                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ⠹ Sending invitation...                                                     │
+│                                                                              │
+│  To: {email}                                                                 │
+│  Role: {role}                                                                │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 3: Display Success Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Invitation sent!                                                            │
+│                                                                              │
+│  ── Invitation Details ──────────────────────────────────────────────────    │
+│                                                                              │
+│  📧 To:      alice@company.com                                               │
+│  🔑 Role:    Editor                                                          │
+│  📁 Project: Planflow Plugin                                                 │
+│                                                                              │
+│  ╭────────────────────╮                                                      │
+│  │ ✓ Invitation Sent  │                                                      │
+│  ╰────────────────────╯                                                      │
+│                                                                              │
+│  They'll receive an email with instructions to join.                         │
+│  The invitation expires in 7 days.                                           │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.commands}                                                   │
+│     • /pfTeamList            View pending invitations                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Error Handling
+
+**Invalid Email Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Invalid email format.                                                       │
+│                                                                              │
+│  Example: alice@company.com                                                  │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Already Member Card (409):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ⚠️  WARNING                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  User is already a team member.                                              │
+│                                                                              │
+│  alice@company.com is already part of this project.                          │
+│                                                                              │
+│  💡 To change their role:                                                    │
+│     • /pfTeamRole alice@company.com admin                                    │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Permission Denied Card (403):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  You don't have permission to invite team members.                           │
+│                                                                              │
+│  Only project owners and admins can send invitations.                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```

package/commands/pfTeamList/SKILL.md

@@ -0,0 +1,253 @@
+---
+name: pfTeamList
+description: List team members for the current PlanFlow project
+---
+
+# PlanFlow Team List
+
+Display team members, their roles, and current activity for the linked cloud project with team member cards.
+
+## Usage
+
+```bash
+/pfTeamList                 # List all team members
+```
+
+## Step 0: Load Configuration
+
+```javascript
+function getConfig() {
+  const localConfigPath = "./.plan-config.json"
+  let localConfig = {}
+  if (fileExists(localConfigPath)) {
+    try { localConfig = JSON.parse(readFile(localConfigPath)) } catch {}
+  }
+
+  const globalConfigPath = expandPath("~/.config/claude/plan-plugin-config.json")
+  let globalConfig = {}
+  if (fileExists(globalConfigPath)) {
+    try { globalConfig = JSON.parse(readFile(globalConfigPath)) } catch {}
+  }
+
+  return {
+    ...globalConfig,
+    ...localConfig,
+    cloud: {
+      ...(globalConfig.cloud || {}),
+      ...(localConfig.cloud || {})
+    }
+  }
+}
+
+const config = getConfig()
+const language = config.language || "en"
+const cloudConfig = config.cloud || {}
+const isAuthenticated = !!cloudConfig.apiToken
+const projectId = cloudConfig.projectId
+const apiUrl = cloudConfig.apiUrl || "https://api.planflow.tools"
+
+const t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Validate Authentication
+
+If not authenticated, display error card:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.sync.notAuthenticated}                                          │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfLogin               Sign in to PlanFlow                             │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 2: Validate Project Link
+
+If no project is linked, display error card:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.sync.notLinked}                                                 │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfCloudLink           Link to a cloud project                         │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 3: Fetch Team Members
+
+**Loading Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  👥 Team Members                                                             │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ⠹ {t.ui.labels.fetching}                                                    │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**API Call:**
+```bash
+curl -s \
+  -H "Authorization: Bearer {TOKEN}" \
+  -H "Accept: application/json" \
+  "https://api.planflow.tools/projects/{PROJECT_ID}/team"
+```
+
+## Step 4: Display Team Members Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  👥 {t.commands.team.title}                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  📁 Project: {projectName}                                                   │
+│                                                                              │
+│  ── Active Members ({count}) ────────────────────────────────────────────    │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  🟢 John Doe (Owner)                                                   │  │
+│  │     john@company.com                                                   │  │
+│  │     Working on: T2.1 - API endpoints                                   │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  🟢 Jane Smith (Admin)                                                 │  │
+│  │     jane@company.com                                                   │  │
+│  │     Working on: T3.5 - Dashboard                                       │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  🔴 Bob Wilson (Editor)                                                │  │
+│  │     bob@company.com                                                    │  │
+│  │     Last seen: 2 hours ago                                             │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ── Pending Invites ({inviteCount}) ─────────────────────────────────────    │
+│                                                                              │
+│  ⏳ alice@company.com (Editor) - sent 2 days ago                             │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.commands}                                                   │
+│     • /pfTeamInvite <email>        Invite a team member                      │
+│     • /pfTeamRole <email> <role>   Change member role                        │
+│     • /pfTeamRemove <email>        Remove from team                          │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**Example Output (Georgian):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  👥 გუნდის წევრები                                                           │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  📁 პროექტი: Planflow Plugin                                                 │
+│                                                                              │
+│  ── აქტიური წევრები (3) ─────────────────────────────────────────────────    │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  🟢 John Doe (მფლობელი)                                                │  │
+│  │     john@company.com                                                   │  │
+│  │     მუშაობს: T2.1 - API endpoints                                      │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  🟢 Jane Smith (ადმინი)                                                │  │
+│  │     jane@company.com                                                   │  │
+│  │     მუშაობს: T3.5 - Dashboard                                          │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  🔴 Bob Wilson (რედაქტორი)                                             │  │
+│  │     bob@company.com                                                    │  │
+│  │     ბოლოს ნანახი: 2 საათის წინ                                          │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ── მოლოდინში მყოფი მოწვევები (1) ───────────────────────────────────────    │
+│                                                                              │
+│  ⏳ alice@company.com (რედაქტორი) - გაგზავნილი 2 დღის წინ                     │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 ბრძანებები:                                                              │
+│     • /pfTeamInvite <email>        მოიწვიე გუნდის წევრი                      │
+│     • /pfTeamRole <email> <role>   შეცვალე წევრის როლი                       │
+│     • /pfTeamRemove <email>        წაშალე გუნდიდან                           │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Step 5: Handle Empty Team
+
+If only the owner exists:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  👥 Team Members                                                             │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  📁 Project: Planflow Plugin                                                 │
+│                                                                              │
+│  ── Active Members (1) ──────────────────────────────────────────────────    │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  🟢 You (Owner)                                                        │  │
+│  │     your@email.com                                                     │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ℹ️  You're the only team member.                                            │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 To invite collaborators:                                                 │
+│     • /pfTeamInvite <email>                                                  │
+│     • /pfTeamInvite <email> admin    (with role)                             │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Error Handling
+
+**Network Error Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Network error. Could not fetch team information.                            │
+│                                                                              │
+│  Please check your connection and try again.                                 │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**API Error (403 Forbidden):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  You don't have permission to view team members.                             │
+│                                                                              │
+│  Only project members can view the team list.                                │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```