planflow-plugin 0.1.0

package/commands/pfCloudUnlink/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: pfCloudUnlink
+description: Disconnect from current PlanFlow cloud project
+---
+
+# PlanFlow Cloud Unlink
+
+Disconnect from current PlanFlow cloud project with confirmation card.
+
+## Usage
+
+```bash
+/pfCloudUnlink
+```
+
+## 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, _localConfig: localConfig, _globalConfig: globalConfig }
+}
+
+const config = getConfig()
+const language = config.language || "en"
+const cloudConfig = config.cloud || {}
+const isAuthenticated = !!cloudConfig.apiToken
+const currentProjectId = cloudConfig.projectId
+const apiUrl = cloudConfig.apiUrl || "https://api.planflow.tools"
+
+const t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Check if Linked
+
+**If not linked, display info card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ℹ️  INFO                                                                     │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.cloud.notLinked}                                                │
+│                                                                              │
+│  Not currently linked to any cloud project.                                  │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfCloudLink           Link to a cloud project                         │
+│     • /pfCloudList           View available projects                         │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 2: Remove Link
+
+**Remove from local config:**
+Remove `cloud.projectId` from `.plan-config.json`
+
+## Step 3: Show Success Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.cloud.unlinkSuccess}                                            │
+│                                                                              │
+│  {t.commands.cloud.unlinkDetails}                                            │
+│                                                                              │
+│  ── What's Changed ──────────────────────────────────────────────────────    │
+│                                                                              │
+│  • Project unlinked from cloud                                               │
+│  • LOCAL PROJECT_PLAN.md is now independent                                  │
+│  • Cloud project data NOT deleted                                            │
+│  • Auto-sync disabled for this project                                       │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfCloudLink           Link to a different project                     │
+│     • /pfCloudList           View your cloud projects                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**Example Output (English):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Project unlinked.                                                           │
+│                                                                              │
+│  Local project is no longer linked to cloud.                                 │
+│                                                                              │
+│  ── What's Changed ──────────────────────────────────────────────────────    │
+│                                                                              │
+│  • Project unlinked from cloud                                               │
+│  • LOCAL PROJECT_PLAN.md is now independent                                  │
+│  • Cloud project data NOT deleted                                            │
+│  • Auto-sync disabled for this project                                       │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Next Steps:                                                              │
+│     • /pfCloudLink           Link to a different project                     │
+│     • /pfCloudList           View your cloud projects                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**Example Output (Georgian):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ წარმატება                                                                │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  პროექტი გაითიშა.                                                            │
+│                                                                              │
+│  ლოკალური პროექტი აღარ არის დაკავშირებული cloud-თან.                         │
+│                                                                              │
+│  ── რა შეიცვალა ─────────────────────────────────────────────────────────    │
+│                                                                              │
+│  • პროექტი გათიშულია cloud-დან                                               │
+│  • ლოკალური PROJECT_PLAN.md დამოუკიდებელია                                   │
+│  • Cloud პროექტის მონაცემები არ წაშლილა                                      │
+│  • ავტო-სინქრონიზაცია გამორთულია                                             │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 შემდეგი ნაბიჯები:                                                        │
+│     • /pfCloudLink           სხვა პროექტთან დაკავშირება                      │
+│     • /pfCloudList           Cloud პროექტების ნახვა                          │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```

package/commands/pfComment/SKILL.md

@@ -0,0 +1,227 @@
+---
+name: pfComment
+description: Add a comment to a task in the current PlanFlow project
+---
+
+# PlanFlow Task Comment
+
+Add a comment to a task in the linked cloud project with comment card. Supports @mentions to notify team members.
+
+## Usage
+
+```bash
+/pfComment <task-id> <comment>           # Add comment to task
+/pfComment T2.1 "Ready for review"       # Simple comment
+/pfComment T2.1 "@jane Please check"     # Comment with @mention
+```
+
+## Step 0: Load Configuration
+
+```javascript
+// ... standard config loading ...
+```
+
+## Step 1: Show Usage Card (if no arguments)
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  💬 Task Comment                                                             │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ── Usage ───────────────────────────────────────────────────────────────    │
+│                                                                              │
+│  /pfComment <task-id> <comment>    Add comment to task                       │
+│                                                                              │
+│  ── Examples ────────────────────────────────────────────────────────────    │
+│                                                                              │
+│  /pfComment T2.1 "Ready for review"                                          │
+│  /pfComment T2.1 "@jane Please check the validation"                         │
+│                                                                              │
+│  💡 Use @email to mention and notify team members                            │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 2: Display Success Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Comment added!                                                              │
+│                                                                              │
+│  ── Comment Details ────────────────────────────────────────────────────     │
+│                                                                              │
+│  📋 Task:     T2.1: Implement login API                                      │
+│  👤 Author:   John Doe                                                       │
+│  🕐 Time:     just now                                                       │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │                                                                        │  │
+│  │  "Ready for review **@jane@company.com**"                              │  │
+│  │                                                                        │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ── Notifications Sent ─────────────────────────────────────────────────     │
+│                                                                              │
+│  ✉️  Jane Smith (jane@company.com)                                           │
+│                                                                              │
+│  They will receive an email notification.                                    │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 View all comments:                                                       │
+│     • /pfComments T2.1                                                       │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**Success Card (without mentions):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Comment added!                                                              │
+│                                                                              │
+│  ── Comment Details ────────────────────────────────────────────────────     │
+│                                                                              │
+│  📋 Task:     T2.1: Implement login API                                      │
+│  👤 Author:   John Doe                                                       │
+│  🕐 Time:     just now                                                       │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │                                                                        │  │
+│  │  "Started working on this task"                                        │  │
+│  │                                                                        │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 View all comments:                                                       │
+│     • /pfComments T2.1                                                       │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Step 3: Success Card with Unresolved Mentions
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Comment added!                                                              │
+│                                                                              │
+│  ── Comment Details ────────────────────────────────────────────────────     │
+│                                                                              │
+│  📋 Task:     T2.1: Implement login API                                      │
+│  👤 Author:   John Doe                                                       │
+│  🕐 Time:     just now                                                       │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │                                                                        │  │
+│  │  "Hey **@bob** and **@unknown@test.com**, please review"               │  │
+│  │                                                                        │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ── Notifications Sent ─────────────────────────────────────────────────     │
+│                                                                              │
+│  ✉️  Bob Wilson (bob@company.com)                                            │
+│                                                                              │
+│  ── Undelivered Mentions ───────────────────────────────────────────────     │
+│                                                                              │
+│  ❌ @unknown@test.com - not a team member                                    │
+│                                                                              │
+│  💡 Invite them first: /pfTeamInvite <email>                                 │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 View all comments:                                                       │
+│     • /pfComments T2.1                                                       │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Error Handling
+
+**Invalid Task ID Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Invalid task ID format.                                                     │
+│                                                                              │
+│  Task ID should be like: T1.1, T2.3, T10.5                                   │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Empty Comment Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Comment cannot be empty.                                                    │
+│                                                                              │
+│  Please provide a comment message.                                           │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**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.                          │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Permission Denied Card (403):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  You don't have permission to comment.                                       │
+│                                                                              │
+│  Only editors and above can add comments.                                    │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## @Mention Support
+
+| Input | Resolution | Notes |
+|-------|------------|-------|
+| @jane@company.com | jane@company.com | Direct email match |
+| @jane | jane@company.com | Match by first name |
+| @jane.smith | jane.smith@company.com | Match by full name |
+| @unknown | (invalid) | Show warning, skip |
+
+## Notes
+
+- Comments support @mentions using email (@jane@company.com) or username (@jane)
+- Mentioned users receive email notifications (if enabled)
+- Task IDs are case-insensitive (t2.1 becomes T2.1)
+- Maximum comment length is 2000 characters
+- View comments with /pfComments <task-id>
+

package/commands/pfComments/SKILL.md

@@ -0,0 +1,159 @@
+---
+name: pfComments
+description: View comments on a task in the current PlanFlow project
+---
+
+# PlanFlow View Task Comments
+
+View all comments on a task in the linked cloud project with comment thread cards.
+
+## Usage
+
+```bash
+/pfComments <task-id>           # View comments on task
+/pfComments T2.1                # View comments on T2.1
+/pfComments T2.1 --all          # Include resolved/old comments
+```
+
+## Step 0: Load Configuration
+
+```javascript
+// ... standard config loading ...
+```
+
+## Step 1: Show Usage Card (if no arguments)
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  💬 View Task Comments                                                       │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ── Usage ───────────────────────────────────────────────────────────────    │
+│                                                                              │
+│  /pfComments <task-id>          View comments on task                        │
+│  /pfComments <task-id> --all    Include all comments                         │
+│                                                                              │
+│  ── Example ────────────────────────────────────────────────────────────     │
+│                                                                              │
+│  /pfComments T2.1                                                            │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 2: Display Comments Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  💬 Comments - T2.1                                                          │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  📋 Task: Implement login API                                                │
+│  📝 3 comments                                                               │
+│                                                                              │
+│  ── Comment Thread ─────────────────────────────────────────────────────     │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  👤 John Doe                                           2 hours ago     │  │
+│  │                                                                        │  │
+│  │  "Started working on this task"                                        │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+│  ┌────────────────────────────────────────────────────────────────────────┐  │
+│  │  👤 John Doe                                           30 min ago      │  │
+│  │                                                                        │  │
+│  │  "Ready for review **@jane@company.com**"                              │  │
+│  │  📧 → Jane Smith                                                       │  │
+│  │                                                                        │  │
+│  │  └── 👤 Jane Smith                                     15 min ago      │  │
+│  │      "Looks good! Just one small fix needed."                          │  │
+│  └────────────────────────────────────────────────────────────────────────┘  │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Add a comment:                                                           │
+│     • /pfComment T2.1 "Your message"                                         │
+│     • /pfComment T2.1 "@teammate Check this"                                 │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Step 3: No Comments Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  💬 Comments - T2.1                                                          │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  📋 Task: Implement login API                                                │
+│                                                                              │
+│  ╭─────────────────────────────────────────────────────────────────────╮     │
+│  │                                                                     │     │
+│  │  📭 No comments yet.                                                │     │
+│  │                                                                     │     │
+│  ╰─────────────────────────────────────────────────────────────────────╯     │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Be the first to comment:                                                 │
+│     • /pfComment T2.1 "Your message"                                         │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Error Handling
+
+**Invalid Task ID Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Invalid task ID format.                                                     │
+│                                                                              │
+│  Task ID should be like: T1.1, T2.3, T10.5                                   │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**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.                          │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Permission Denied Card (403):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  You don't have permission to view comments.                                 │
+│                                                                              │
+│  Only project members can view comments.                                     │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Notes
+
+- Comments are displayed in chronological order (oldest first)
+- Replies are indented under their parent comment
+- Time is shown relative to now (e.g., "2 hours ago")
+- **@mentions are highlighted** in bold in the comment text
+- Mentioned team members are shown with 📧 indicator
+- Use --all flag to include older/resolved comments
+- Maximum 50 comments returned by default
+