planflow-plugin 0.1.0

package/commands/planSettingsAutoSync/SKILL.md

@@ -0,0 +1,199 @@
+---
+name: planSettingsAutoSync
+description: Manage automatic synchronization after planUpdate commands
+---
+
+# Plan Settings Auto-Sync
+
+Manage automatic synchronization after /planUpdate commands with toggle card.
+
+## Usage
+
+```bash
+/planSettingsAutoSync           # Show auto-sync status
+/planSettingsAutoSync on        # Enable auto-sync
+/planSettingsAutoSync off       # Disable auto-sync
+```
+
+## 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 autoSync = cloudConfig.autoSync || false
+
+const t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Parse Arguments
+
+```javascript
+const autoSyncValue = commandArgs.trim().toLowerCase() || null  // "on", "off", or null
+```
+
+## Step 2: Check Authentication
+
+**If not authenticated, display error card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.settings.autoSyncNotAuthenticated}                              │
+│                                                                              │
+│  Auto-sync requires a cloud connection.                                      │
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /pfLogin               Sign in first                                   │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+## Step 3: Handle Based on Value
+
+### If null (show status)
+
+Display status card:
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  🔄 {t.commands.settings.autoSyncTitle}                                      │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  ── Current Status ──────────────────────────────────────────────────────    │
+│                                                                              │
+│  ╭─────────────────────╮                                                     │
+│  │ {autoSync ? "✓ Enabled" : "✕ Disabled"} │                                 │
+│  ╰─────────────────────╯                                                     │
+│                                                                              │
+│  ── What is Auto-Sync? ──────────────────────────────────────────────────    │
+│                                                                              │
+│  When enabled, changes from /planUpdate commands are automatically           │
+│  synced to cloud without running /pfSyncPush.                                │
+│                                                                              │
+│  Example:                                                                    │
+│    /planUpdate T1.1 done  →  Updates cloud automatically                     │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.commands}                                                   │
+│     • /planSettingsAutoSync on      Enable auto-sync                         │
+│     • /planSettingsAutoSync off     Disable auto-sync                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+### If "on" (enable)
+
+1. Read `./.plan-config.json`
+2. Set `cloud.autoSync = true`
+3. Update `lastUsed`
+4. Write back
+
+**Success Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.settings.autoSyncEnabledSuccess}                                │
+│                                                                              │
+│  ── Auto-Sync Status ────────────────────────────────────────────────────    │
+│                                                                              │
+│  ╭─────────────────╮                                                         │
+│  │ ✓ Enabled       │                                                         │
+│  ╰─────────────────╯                                                         │
+│                                                                              │
+│  ── What Happens Now ────────────────────────────────────────────────────    │
+│                                                                              │
+│  /planUpdate commands will automatically sync to cloud:                      │
+│                                                                              │
+│  /planUpdate T1.1 done                                                       │
+│       ↓                                                                      │
+│  ✓ Local PROJECT_PLAN.md updated                                             │
+│  ✓ Cloud synced automatically                                                │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 To disable: /planSettingsAutoSync off                                    │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+### If "off" (disable)
+
+1. Read `./.plan-config.json`
+2. Set `cloud.autoSync = false`
+3. Update `lastUsed`
+4. Write back
+
+**Success Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.settings.autoSyncDisabledSuccess}                               │
+│                                                                              │
+│  ── Auto-Sync Status ────────────────────────────────────────────────────    │
+│                                                                              │
+│  ╭──────────────────╮                                                        │
+│  │ ✕ Disabled       │                                                        │
+│  ╰──────────────────╯                                                        │
+│                                                                              │
+│  ── Manual Sync Required ────────────────────────────────────────────────    │
+│                                                                              │
+│  Changes will only be saved locally.                                         │
+│  To sync to cloud, run:                                                      │
+│                                                                              │
+│     /pfSyncPush                                                              │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 To enable: /planSettingsAutoSync on                                      │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+### If invalid value
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ❌ ERROR                                                                    │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t.commands.settings.autoSyncInvalidValue}                                  │
+│                                                                              │
+│  Invalid value: "{autoSyncValue}"                                            │
+│                                                                              │
+│  Valid options: on, off                                                      │
+│                                                                              │
+│  💡 {t.ui.labels.commands}                                                   │
+│     • /planSettingsAutoSync on                                               │
+│     • /planSettingsAutoSync off                                              │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```

package/commands/planSettingsLanguage/SKILL.md

@@ -0,0 +1,201 @@
+---
+name: planSettingsLanguage
+description: Change language preference for the plugin
+---
+
+# Plan Settings Language
+
+Change language preference for the plugin with language selector card.
+
+## Usage
+
+```bash
+/planSettingsLanguage           # Change global language
+/planSettingsLanguage --local   # Change language for this project only
+```
+
+## Step 0: Load Configuration
+
+```javascript
+function getConfig() {
+  const localConfigPath = "./.plan-config.json"
+  if (fileExists(localConfigPath)) {
+    try {
+      const config = JSON.parse(readFile(localConfigPath))
+      config._source = "local"
+      return config
+    } catch {}
+  }
+
+  const globalConfigPath = expandPath("~/.config/claude/plan-plugin-config.json")
+  if (fileExists(globalConfigPath)) {
+    try {
+      const config = JSON.parse(readFile(globalConfigPath))
+      config._source = "global"
+      return config
+    } catch {}
+  }
+
+  return { "language": "en", "_source": "default" }
+}
+
+const config = getConfig()
+const language = config.language || "en"
+const t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Parse Arguments
+
+```javascript
+const isLocal = commandArgs.includes("--local")
+const scope = isLocal ? "local" : "global"
+```
+
+## Step 2: Show Language Selection Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  🌍 Language Settings                                                        │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Select your preferred language:                                             │
+│                                                                              │
+│  ── Available Languages ─────────────────────────────────────────────────    │
+│                                                                              │
+│  [1] English                    {currentLang === "en" ? "✓ Current" : ""}    │
+│      Full support for all features                                           │
+│                                                                              │
+│  [2] ქართული (Georgian)         {currentLang === "ka" ? "✓ Current" : ""}    │
+│      სრული მხარდაჭერა                                                        │
+│                                                                              │
+│  [3] Русский (Russian)          {currentLang === "ru" ? "✓ Current" : ""}    │
+│      Полная поддержка                                                        │
+│                                                                              │
+│  ── Scope ───────────────────────────────────────────────────────────────    │
+│                                                                              │
+│  {scope === "local" ? "📁 Project-specific" : "🌐 Global"}                   │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+Use AskUserQuestion to present language options:
+
+```javascript
+const currentLang = config.language || "en"
+
+AskUserQuestion({
+  questions: [{
+    question: t.commands.settings.selectLanguage,
+    header: t.commands.settings.languageHeader,
+    multiSelect: false,
+    options: [
+      {
+        label: t.commands.settings.englishOption + (currentLang === "en" ? " ✓" : ""),
+        description: t.commands.settings.englishDesc
+      },
+      {
+        label: t.commands.settings.georgianOption + (currentLang === "ka" ? " ✓" : ""),
+        description: t.commands.settings.georgianDesc
+      },
+      {
+        label: t.commands.settings.russianOption + (currentLang === "ru" ? " ✓" : ""),
+        description: t.commands.settings.russianDesc
+      }
+    ]
+  }]
+})
+```
+
+## Step 3: Map Selection to Language Code
+
+```javascript
+let newLanguage = "en"
+if (userSelection.includes("English")) newLanguage = "en"
+else if (userSelection.includes("Georgian") || userSelection.includes("ქართული")) newLanguage = "ka"
+else if (userSelection.includes("Russian") || userSelection.includes("Русский")) newLanguage = "ru"
+```
+
+## Step 4: Save to Config
+
+**For local scope:**
+- Path: `./.plan-config.json`
+- Read existing, update language, write back
+
+**For global scope:**
+- Path: `~/.config/claude/plan-plugin-config.json`
+- Ensure directory exists: `mkdir -p ~/.config/claude`
+- Read existing, update language, write back
+
+**IMPORTANT:** Preserve existing fields! Only update `language` and `lastUsed`.
+
+## Step 5: Show Success Card
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t_new.commands.settings.settingsUpdated}                                   │
+│                                                                              │
+│  ── Language Changed ────────────────────────────────────────────────────    │
+│                                                                              │
+│  {fromName} → {toName}                                                       │
+│                                                                              │
+│  ╭─────────────────────────────╮                                             │
+│  │ ✓ {toName}                  │                                             │
+│  ╰─────────────────────────────╯                                             │
+│                                                                              │
+│  Scope: {scope === "local" ? "📁 Project-specific" : "🌐 Global"}            │
+│                                                                              │
+│  ── What's Affected ─────────────────────────────────────────────────────    │
+│                                                                              │
+│  {t_new.commands.settings.newLanguageUsedFor}                                │
+│  • {t_new.commands.settings.commandOutputs}                                  │
+│  • {t_new.commands.settings.wizardQuestions}                                 │
+│  • {t_new.commands.settings.generatedPlans}                                  │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t_new.commands.settings.tryIt}                                          │
+│     • /planNext              See the new language in action                  │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**Example Output (Switching to Georgian):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ წარმატება                                                                │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  პარამეტრები განახლდა!                                                       │
+│                                                                              │
+│  ── ენა შეიცვალა ────────────────────────────────────────────────────────    │
+│                                                                              │
+│  English → ქართული                                                           │
+│                                                                              │
+│  ╭─────────────────────────────╮                                             │
+│  │ ✓ ქართული                   │                                             │
+│  ╰─────────────────────────────╯                                             │
+│                                                                              │
+│  ფარგლები: 🌐 გლობალური                                                      │
+│                                                                              │
+│  ── რა იცვლება ──────────────────────────────────────────────────────────    │
+│                                                                              │
+│  ახალი ენა გამოიყენება:                                                      │
+│  • ბრძანებების გამოსავალში                                                   │
+│  • ვიზარდის კითხვებში                                                        │
+│  • გენერირებულ გეგმებში                                                      │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 სცადეთ ახლავე:                                                           │
+│     • /planNext              ნახეთ ახალი ენა მოქმედებაში                     │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**IMPORTANT:** Use NEW language translations (t_new) for the success message!

package/commands/planSettingsReset/SKILL.md

@@ -0,0 +1,237 @@
+---
+name: planSettingsReset
+description: Reset plugin settings to defaults
+---
+
+# Plan Settings Reset
+
+Reset plugin settings to defaults with confirmation card.
+
+## Usage
+
+```bash
+/planSettingsReset              # Reset global settings to defaults
+/planSettingsReset --local      # Remove project-specific settings
+```
+
+## Step 0: Load Configuration
+
+```javascript
+function getConfig() {
+  const localConfigPath = "./.plan-config.json"
+  if (fileExists(localConfigPath)) {
+    try {
+      const config = JSON.parse(readFile(localConfigPath))
+      config._source = "local"
+      return config
+    } catch {}
+  }
+
+  const globalConfigPath = expandPath("~/.config/claude/plan-plugin-config.json")
+  if (fileExists(globalConfigPath)) {
+    try {
+      const config = JSON.parse(readFile(globalConfigPath))
+      config._source = "global"
+      return config
+    } catch {}
+  }
+
+  return { "language": "en", "_source": "default" }
+}
+
+const config = getConfig()
+const language = config.language || "en"
+const t = JSON.parse(readFile(`locales/${language}.json`))
+```
+
+## Step 1: Parse Arguments
+
+```javascript
+const isLocal = commandArgs.includes("--local")
+const scope = isLocal ? "local" : "global"
+```
+
+## Step 2: Execute Reset
+
+### For local scope (--local)
+
+1. Check if `./.plan-config.json` exists
+2. If exists, remove it: `rm ./.plan-config.json`
+3. Re-read config with hierarchy (will fall back to global or default)
+4. Load new effective language translations
+
+**Success Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t_new.commands.settings.settingsUpdated}                                   │
+│                                                                              │
+│  📁 {t_new.commands.settings.projectSettingsRemoved}                         │
+│                                                                              │
+│  ── What's Changed ──────────────────────────────────────────────────────    │
+│                                                                              │
+│  • Removed:  ./.plan-config.json                                             │
+│  • Now using: {newConfig._source === "global" ? "Global settings" : "Defaults"} │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 {t.ui.labels.nextSteps}                                                  │
+│     • /planSettingsShow              View current settings                   │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**If no local config exists:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ℹ️  INFO                                                                     │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  No project-specific settings found.                                         │
+│                                                                              │
+│  The file ./.plan-config.json does not exist in this directory.              │
+│                                                                              │
+│  💡 {t.ui.labels.tips}                                                       │
+│     • Use /planSettingsReset (without --local) to reset global settings      │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```
+
+### For global scope (no flag)
+
+1. Create default config:
+```json
+{
+  "language": "en",
+  "lastUsed": "2026-01-27T15:30:00Z"
+}
+```
+
+2. Ensure directory exists: `mkdir -p ~/.config/claude`
+3. Write default config to `~/.config/claude/plan-plugin-config.json`
+4. Load English translations
+
+**Success Card:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  {t_en.commands.settings.settingsUpdated}                                    │
+│                                                                              │
+│  🌐 {t_en.commands.settings.globalSettingsReset}                             │
+│                                                                              │
+│  ── Reset to Defaults ───────────────────────────────────────────────────    │
+│                                                                              │
+│  🌍 Language:          English                                               │
+│  ☁️  Cloud:             Disconnected                                          │
+│  🔄 Auto-sync:         Disabled                                              │
+│                                                                              │
+│  ── What's Changed ──────────────────────────────────────────────────────    │
+│                                                                              │
+│  • Reset:  ~/.config/claude/plan-plugin-config.json                          │
+│  • Cleared: Cloud credentials (if any)                                       │
+│  • Preserved: Local project settings (if any)                                │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Next Steps:                                                              │
+│     • /planSettingsShow              View current settings                   │
+│     • /pfLogin                       Connect to cloud                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**Example Output (English - Global Reset):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ SUCCESS                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Settings updated!                                                           │
+│                                                                              │
+│  🌐 Global settings reset to defaults                                        │
+│                                                                              │
+│  ── Reset to Defaults ───────────────────────────────────────────────────    │
+│                                                                              │
+│  🌍 Language:          English                                               │
+│  ☁️  Cloud:             Disconnected                                          │
+│  🔄 Auto-sync:         Disabled                                              │
+│                                                                              │
+│  ── What's Changed ──────────────────────────────────────────────────────    │
+│                                                                              │
+│  • Reset:  ~/.config/claude/plan-plugin-config.json                          │
+│  • Cleared: Cloud credentials (if any)                                       │
+│  • Preserved: Local project settings (if any)                                │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 Next Steps:                                                              │
+│     • /planSettingsShow              View current settings                   │
+│     • /pfLogin                       Connect to cloud                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+**Example Output (Georgian):**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ✅ წარმატება                                                                │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  პარამეტრები განახლდა!                                                       │
+│                                                                              │
+│  🌐 გლობალური პარამეტრები საწყის მნიშვნელობებზე დაბრუნდა                     │
+│                                                                              │
+│  ── საწყისი პარამეტრები ─────────────────────────────────────────────────    │
+│                                                                              │
+│  🌍 ენა:                English                                              │
+│  ☁️  Cloud:              გათიშული                                             │
+│  🔄 ავტო-სინქრონიზაცია: გამორთული                                            │
+│                                                                              │
+│  ── რა შეიცვალა ─────────────────────────────────────────────────────────    │
+│                                                                              │
+│  • დაბრუნდა:  ~/.config/claude/plan-plugin-config.json                       │
+│  • წაიშალა:   Cloud კრედენციალები (თუ იყო)                                   │
+│  • შენარჩუნდა: ლოკალური პროექტის პარამეტრები (თუ იყო)                        │
+│                                                                              │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  💡 შემდეგი ნაბიჯები:                                                        │
+│     • /planSettingsShow              მიმდინარე პარამეტრების ნახვა            │
+│     • /pfLogin                       Cloud-თან დაკავშირება                   │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+```
+
+## Error Handling
+
+**Cannot delete/write file:**
+
+```
+╭──────────────────────────────────────────────────────────────────────────────╮
+│  ⚠️  WARNING                                                                  │
+├──────────────────────────────────────────────────────────────────────────────┤
+│                                                                              │
+│  Couldn't save settings.                                                     │
+│                                                                              │
+│  Settings will apply for this session only.                                  │
+│                                                                              │
+│  Possible causes:                                                            │
+│  • Insufficient permissions                                                  │
+│  • Disk full                                                                 │
+│  • Directory doesn't exist                                                   │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+```