planflow-plugin 0.1.0

package/commands/pfCloudLink/SKILL.md

@@ -0,0 +1,192 @@
+---
+name: pfCloudLink
+description: Link local directory to a PlanFlow cloud project
+---
+
+# PlanFlow Cloud Link
+
+Link local directory to a PlanFlow cloud project with selection interface.
+
+## Usage
+
+```bash
+/pfCloudLink                # Interactive project selection
+/pfCloudLink <project-id>   # Link to specific project
+```
+
+## 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: Parse Arguments
+
+```javascript
+const projectIdArg = commandArgs.trim()  // project ID if provided
+```
+
+## Step 2: Validate Authentication
+
+If not authenticated, display error card:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.sync.notAuthenticated}                                          │
+│                                                                              │
+│  You must be logged in to link projects.                                     │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfLogin               Sign in to PlanFlow                             │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 3: Check Current Link
+
+**If already linked, display warning card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ⚠️  WARNING                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Already linked to: {projectName}                                            │
+│                                                                              │
+│  Project ID: {currentProjectId}                                              │
+│                                                                              │
+│  To switch projects, unlink first.                                           │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfCloudUnlink         Unlink current project                          │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 4: Select Project
+
+**If no ID provided, show selection card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  🔗 Link to Cloud Project                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ── Available Projects ──────────────────────────────────────────────────    │
+│                                                                              │
+│  [1] E-commerce App                                                          │
+│      ID: abc123 | 24/45 tasks | 53%                                          │
+│                                                                              │
+│  [2] Mobile API                                                              │
+│      ID: def456 | 12/18 tasks | 67%                                          │
+│                                                                              │
+│  [3] Dashboard                                                               │
+│      ID: ghi789 | 8/12 tasks | 75%                                           │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+Use AskUserQuestion to select:
+```javascript
+AskUserQuestion({
+  questions: [{
+    question: t.commands.cloud.selectProject,
+    header: "Project",
+    multiSelect: false,
+    options: projects.map(p => ({
+      label: p.name,
+      description: `ID: ${p.id} | ${p.tasksDone}/${p.tasksTotal} tasks`
+    }))
+  }]
+})
+```
+
+**If ID provided:**
+Verify project exists via API call.
+
+## Step 5: Save Link
+
+**Save to local config (`.plan-config.json`):**
+```json
+{
+  "cloud": {
+    "projectId": "selected-uuid"
+  }
+}
+```
+
+## Step 6: Show Success Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.cloud.linked}                                                   │
+│                                                                              │
+│  ── Project Details ─────────────────────────────────────────────────────    │
+│                                                                              │
+│  📁 Project:  E-commerce App                                                 │
+│  🆔 ID:       abc123                                                         │
+│  📊 Tasks:    24/45 (53%)                                                    │
+│                                                                              │
+│  ╭────────────────╮                                                          │
+│  │ ✓ Linked       │                                                          │
+│  ╰────────────────╯                                                          │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfSyncPull            Download cloud plan to local                    │
+│     • /pfSyncPush            Upload local plan to cloud                      │
+│     • /pfSyncStatus          Check sync status                               │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Error Handling
+
+**Project not found card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Project not found: {id}                                                     │
+│                                                                              │
+│  The project ID doesn't exist or you don't have access.                      │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfCloudList           View available projects                         │
+│     • /pfCloudNew            Create a new project                            │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```

package/commands/pfCloudList/SKILL.md

@@ -0,0 +1,222 @@
+---
+name: pfCloudList
+description: List all cloud projects in your PlanFlow account
+---
+
+# PlanFlow Cloud List
+
+List all cloud projects in your PlanFlow account with project cards grid.
+
+## Usage
+
+```bash
+/pfCloudList
+```
+
+## 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: Validate Authentication
+
+If not authenticated, display error card:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.sync.notAuthenticated}                                          │
+│                                                                              │
+│  You must be logged in to view cloud projects.                               │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfLogin               Sign in to PlanFlow                             │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 2: Fetch Projects (with Loading)
+
+**Loading Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ☁️  Cloud Projects                                                          │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ⠹ {t.ui.labels.fetching}                                                    │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**API Call:**
+```bash
+curl -s \
+  -H "Authorization: Bearer {TOKEN}" \
+  "https://api.planflow.tools/projects"
+```
+
+## Step 3: Display Projects Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ☁️  {t.commands.cloud.listProjects}                                          │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ── Your Projects ({count}) ─────────────────────────────────────────────    │
+│                                                                              │
+│  ┌─────────┬─────────────────────────┬─────────┬─────────────────────────┐   │
+│  │ ID      │ Name                    │ Tasks   │ Progress                │   │
+│  ├─────────┼─────────────────────────┼─────────┼─────────────────────────┤   │
+│  │ abc123  │ E-commerce App          │  24/45  │ ██████████░░░░░░░░ 53%  │   │
+│  │ def456  │ Mobile API              │  12/18  │ █████████████░░░░░ 67%  │   │
+│  │ ghi789  │ Dashboard               │   8/12  │ ███████████████░░░ 75%  │   │
+│  └─────────┴─────────────────────────┴─────────┴─────────────────────────┘   │
+│                                                                              │
+│  ── Current Link ────────────────────────────────────────────────────────    │
+│                                                                              │
+│  ╭─────────────────────────────────╮                                         │
+│  │ ✓ abc123 (E-commerce App)       │                                         │
+│  ╰─────────────────────────────────╯                                         │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.commands}                                                   │
+│     • /pfCloudLink <id>      Link to a project                               │
+│     • /pfCloudUnlink         Disconnect current                              │
+│     • /pfCloudNew            Create new project                              │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**Example Output (English):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ☁️  Cloud Projects                                                           │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ── Your Projects (3) ───────────────────────────────────────────────────    │
+│                                                                              │
+│  ┌─────────┬─────────────────────────┬─────────┬─────────────────────────┐   │
+│  │ ID      │ Name                    │ Tasks   │ Progress                │   │
+│  ├─────────┼─────────────────────────┼─────────┼─────────────────────────┤   │
+│  │ abc123  │ E-commerce App          │  24/45  │ ██████████░░░░░░░░ 53%  │   │
+│  │ def456  │ Mobile API              │  12/18  │ █████████████░░░░░ 67%  │   │
+│  │ ghi789  │ Dashboard               │   8/12  │ ███████████████░░░ 75%  │   │
+│  └─────────┴─────────────────────────┴─────────┴─────────────────────────┘   │
+│                                                                              │
+│  ── Current Link ────────────────────────────────────────────────────────    │
+│                                                                              │
+│  ╭─────────────────────────────────╮                                         │
+│  │ ✓ abc123 (E-commerce App)       │                                         │
+│  ╰─────────────────────────────────╯                                         │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Commands:                                                                │
+│     • /pfCloudLink <id>      Link to a project                               │
+│     • /pfCloudUnlink         Disconnect current                              │
+│     • /pfCloudNew            Create new project                              │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**No Projects Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ☁️  Cloud Projects                                                           │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ── Your Projects (0) ───────────────────────────────────────────────────    │
+│                                                                              │
+│  No cloud projects yet.                                                      │
+│                                                                              │
+│  Create your first project to start syncing your plans!                      │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Next Steps:                                                              │
+│     • /pfCloudNew            Create a new project                            │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**Example Output (Georgian):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ☁️  Cloud პროექტები                                                          │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ── თქვენი პროექტები (3) ────────────────────────────────────────────────    │
+│                                                                              │
+│  ┌─────────┬─────────────────────────┬─────────┬─────────────────────────┐   │
+│  │ ID      │ სახელი                  │ ამოცანები│ პროგრესი               │   │
+│  ├─────────┼─────────────────────────┼─────────┼─────────────────────────┤   │
+│  │ abc123  │ E-commerce App          │  24/45  │ ██████████░░░░░░░░ 53%  │   │
+│  │ def456  │ Mobile API              │  12/18  │ █████████████░░░░░ 67%  │   │
+│  │ ghi789  │ Dashboard               │   8/12  │ ███████████████░░░ 75%  │   │
+│  └─────────┴─────────────────────────┴─────────┴─────────────────────────┘   │
+│                                                                              │
+│  ── მიმდინარე კავშირი ───────────────────────────────────────────────────    │
+│                                                                              │
+│  ╭─────────────────────────────────╮                                         │
+│  │ ✓ abc123 (E-commerce App)       │                                         │
+│  ╰─────────────────────────────────╯                                         │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 ბრძანებები:                                                              │
+│     • /pfCloudLink <id>      პროექტთან დაკავშირება                           │
+│     • /pfCloudUnlink         გათიშვა                                         │
+│     • /pfCloudNew            ახალი პროექტის შექმნა                           │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Error Handling
+
+**Network Error Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Network error. Could not connect to PlanFlow API.                           │
+│                                                                              │
+│  Please check your internet connection and try again.                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```

package/commands/pfCloudNew/SKILL.md

@@ -0,0 +1,187 @@
+---
+name: pfCloudNew
+description: Create a new cloud project in PlanFlow
+---
+
+# PlanFlow Cloud New
+
+Create a new cloud project in PlanFlow with creation wizard.
+
+## Usage
+
+```bash
+/pfCloudNew                 # Create from local plan (uses plan name)
+/pfCloudNew "Project Name"  # Create with custom name
+```
+
+## 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 apiUrl = cloudConfig.apiUrl || "https://api.planflow.tools"
+
+const t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Parse Arguments
+
+```javascript
+const projectName = commandArgs.trim().replace(/^["']|["']$/g, '') || null
+```
+
+## Step 2: Validate Authentication
+
+If not authenticated, display error card:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.sync.notAuthenticated}                                          │
+│                                                                              │
+│  You must be logged in to create projects.                                   │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfLogin               Sign in to PlanFlow                             │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 3: Check for PROJECT_PLAN.md
+
+**If no PROJECT_PLAN.md:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.cloud.noPlan}                                                   │
+│                                                                              │
+│  No PROJECT_PLAN.md found in current directory.                              │
+│                                                                              │
+│  Create a project plan first before syncing to cloud.                        │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /planNew               Create a new project plan                       │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 4: Show Creation Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ☁️  Create Cloud Project                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ⠹ Creating project on cloud...                                              │
+│                                                                              │
+│  Project name: {projectName}                                                 │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+**API Call:**
+```bash
+curl -s -X POST \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer {TOKEN}" \
+  -d '{"name": "Project Name"}' \
+  "https://api.planflow.tools/projects"
+```
+
+## Step 5: Link and Push
+
+1. Link to new project (save projectId to config)
+2. Push current plan
+
+**Progress Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ☁️  Create Cloud Project                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ✓ Step 1: Project created                                                   │
+│  ✓ Step 2: Project linked                                                    │
+│  ⠹ Step 3: Uploading plan...                                                 │
+│                                                                              │
+│  Progress: ██████████████████████░░░░░░░░ 66%                                │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 6: Show Success Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.cloud.created}                                                  │
+│                                                                              │
+│  ── Project Details ─────────────────────────────────────────────────────    │
+│                                                                              │
+│  📁 Project:  My New Project                                                 │
+│  🆔 ID:       xyz789                                                         │
+│  📊 Tasks:    15                                                             │
+│                                                                              │
+│  ── Sync Status ─────────────────────────────────────────────────────────    │
+│                                                                              │
+│  ╭─────────────────╮                                                         │
+│  │ ✓ Synced        │                                                         │
+│  ╰─────────────────╯                                                         │
+│                                                                              │
+│  🔗 View at: https://app.planflow.tools/projects/xyz789                      │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfTeamInvite          Invite team members                             │
+│     • /planNext              Get task recommendation                         │
+│     • /planSettingsAutoSync  Enable auto-sync                                │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Error Handling
+
+**API Error Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Failed to create project.                                                   │
+│                                                                              │
+│  The server returned an error. Please try again.                             │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • Check your internet connection                                         │
+│     • Try again later                                                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```