planflow-plugin 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 PlanFlow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+# PlanFlow Plugin for Claude Code
+
+Slash commands for AI-native project management directly in Claude Code.
+
+## Installation
+
+```bash
+npm install -g planflow-plugin
+```
+
+The installation automatically sets up all slash commands in `~/.claude/commands/`.
+
+## Manual Setup
+
+If automatic setup didn't work, run:
+
+```bash
+planflow-plugin install
+```
+
+## Available Commands
+
+### Planning Commands
+- `/planNew` - Create a new project plan
+- `/planUpdate` - Update task status
+- `/planNext` - Get next task recommendation
+- `/planSpec` - Analyze specification documents
+
+### Cloud Sync Commands
+- `/pfLogin` - Login to PlanFlow cloud
+- `/pfLogout` - Logout from PlanFlow
+- `/pfWhoami` - Check your account info
+- `/pfSyncPush` - Push plan to cloud
+- `/pfSyncPull` - Pull plan from cloud
+- `/pfSyncStatus` - Check sync status
+- `/pfCloudLink` - Link local directory to cloud project
+- `/pfCloudUnlink` - Disconnect from cloud project
+- `/pfCloudList` - List cloud projects
+- `/pfCloudNew` - Create new cloud project
+
+### Team Commands
+- `/team` - View and manage team members
+- `/pfTeamList` - List team members
+- `/pfTeamInvite` - Invite a team member
+- `/pfTeamRemove` - Remove a team member
+- `/pfTeamRole` - Change member role
+- `/pfMyTasks` - View tasks assigned to you
+- `/pfAssign` - Assign a task
+- `/pfUnassign` - Remove assignment
+- `/pfWorkload` - View team workload
+
+### Collaboration Commands
+- `/pfComment` - Add comment to a task
+- `/pfComments` - View task comments
+- `/pfReact` - Add emoji reaction
+- `/pfActivity` - View recent activity
+- `/pfNotifications` - View notifications
+- `/pfNotificationsClear` - Clear notifications
+- `/pfNotificationSettings` - Manage notification preferences
+
+### Export Commands
+- `/planExportJson` - Export as JSON
+- `/planExportCsv` - Export as CSV
+- `/planExportSummary` - Export as summary
+- `/planExportGithub` - Export to GitHub Issues
+
+### Settings Commands
+- `/planSettingsShow` - Show current settings
+- `/planSettingsReset` - Reset to defaults
+- `/planSettingsLanguage` - Change language
+- `/planSettingsAutoSync` - Configure auto-sync
+
+## CLI Commands
+
+```bash
+planflow-plugin install    # Install/reinstall commands
+planflow-plugin uninstall  # Remove all commands
+planflow-plugin list       # List installed commands
+planflow-plugin help       # Show help
+```
+
+## Requirements
+
+- Node.js 18+
+- Claude Code CLI
+
+## Documentation
+
+Visit [planflow.tools/docs](https://planflow.tools/docs) for full documentation.
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,169 @@
+#!/usr/bin/env node
+
+/**
+ * PlanFlow Plugin CLI
+ *
+ * Usage:
+ *   planflow-plugin install   - Install/reinstall commands
+ *   planflow-plugin uninstall - Remove all commands
+ *   planflow-plugin list      - List installed commands
+ *   planflow-plugin help      - Show help
+ */
+
+import { existsSync, mkdirSync, readdirSync, symlinkSync, unlinkSync, lstatSync, readlinkSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { homedir } from 'node:os'
+import { fileURLToPath } from 'node:url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+const COMMANDS_SOURCE = join(__dirname, '..', 'commands')
+const CLAUDE_COMMANDS_DIR = join(homedir(), '.claude', 'commands')
+
+const VERSION = '0.1.0'
+
+function install() {
+  console.log('\n🔧 Installing PlanFlow commands...\n')
+
+  if (!existsSync(CLAUDE_COMMANDS_DIR)) {
+    mkdirSync(CLAUDE_COMMANDS_DIR, { recursive: true })
+    console.log(`📁 Created ${CLAUDE_COMMANDS_DIR}`)
+  }
+
+  if (!existsSync(COMMANDS_SOURCE)) {
+    console.error('❌ Commands directory not found.')
+    process.exit(1)
+  }
+
+  const commands = readdirSync(COMMANDS_SOURCE, { withFileTypes: true })
+    .filter(dirent => dirent.isDirectory())
+    .map(dirent => dirent.name)
+
+  let count = 0
+  for (const cmd of commands) {
+    const source = join(COMMANDS_SOURCE, cmd)
+    const target = join(CLAUDE_COMMANDS_DIR, cmd)
+
+    try {
+      if (existsSync(target)) {
+        const stats = lstatSync(target)
+        if (stats.isSymbolicLink()) {
+          unlinkSync(target)
+        }
+      }
+      symlinkSync(source, target)
+      count++
+    } catch (error) {
+      console.error(`❌ Failed: ${cmd} - ${error.message}`)
+    }
+  }
+
+  console.log(`✅ Installed ${count} commands to ${CLAUDE_COMMANDS_DIR}`)
+  console.log('\n💡 Restart Claude Code to use the commands.')
+}
+
+function uninstall() {
+  console.log('\n🗑️  Uninstalling PlanFlow commands...\n')
+
+  if (!existsSync(CLAUDE_COMMANDS_DIR)) {
+    console.log('Nothing to uninstall.')
+    return
+  }
+
+  const items = readdirSync(CLAUDE_COMMANDS_DIR, { withFileTypes: true })
+  let count = 0
+
+  for (const item of items) {
+    const name = item.name
+    // Only remove planflow-related commands
+    if (name.startsWith('plan') || name.startsWith('pf')) {
+      const target = join(CLAUDE_COMMANDS_DIR, name)
+      try {
+        if (lstatSync(target).isSymbolicLink()) {
+          unlinkSync(target)
+          count++
+        }
+      } catch (error) {
+        console.error(`❌ Failed to remove ${name}: ${error.message}`)
+      }
+    }
+  }
+
+  console.log(`✅ Removed ${count} commands.`)
+}
+
+function list() {
+  console.log('\n📋 PlanFlow Commands:\n')
+
+  if (!existsSync(CLAUDE_COMMANDS_DIR)) {
+    console.log('No commands installed.')
+    return
+  }
+
+  const items = readdirSync(CLAUDE_COMMANDS_DIR, { withFileTypes: true })
+  const planflowCmds = items
+    .filter(item => item.name.startsWith('plan') || item.name.startsWith('pf'))
+
+  if (planflowCmds.length === 0) {
+    console.log('No PlanFlow commands installed.')
+    return
+  }
+
+  for (const item of planflowCmds) {
+    const target = join(CLAUDE_COMMANDS_DIR, item.name)
+    const isSymlink = lstatSync(target).isSymbolicLink()
+    const status = isSymlink ? '✓' : '?'
+    console.log(`  ${status} /${item.name}`)
+  }
+
+  console.log(`\nTotal: ${planflowCmds.length} commands`)
+}
+
+function help() {
+  console.log(`
+PlanFlow Plugin v${VERSION}
+
+Usage:
+  planflow-plugin <command>
+
+Commands:
+  install     Install or reinstall all commands
+  uninstall   Remove all PlanFlow commands
+  list        List installed commands
+  help        Show this help message
+
+Examples:
+  planflow-plugin install
+  planflow-plugin list
+
+Documentation: https://planflow.tools/docs/plugin-commands
+`)
+}
+
+// Main
+const args = process.argv.slice(2)
+const command = args[0]
+
+switch (command) {
+  case 'install':
+    install()
+    break
+  case 'uninstall':
+    uninstall()
+    break
+  case 'list':
+    list()
+    break
+  case 'help':
+  case '--help':
+  case '-h':
+    help()
+    break
+  default:
+    if (command) {
+      console.error(`Unknown command: ${command}`)
+    }
+    help()
+    break
+}

package/bin/postinstall.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+
+/**
+ * PlanFlow Plugin - Post-install script
+ *
+ * Creates symlinks in ~/.claude/commands/ for all plugin commands.
+ */
+
+import { existsSync, mkdirSync, readdirSync, symlinkSync, unlinkSync, lstatSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { homedir } from 'node:os'
+import { fileURLToPath } from 'node:url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+const COMMANDS_SOURCE = join(__dirname, '..', 'commands')
+const CLAUDE_COMMANDS_DIR = join(homedir(), '.claude', 'commands')
+
+function setup() {
+  console.log('\n🔧 PlanFlow Plugin - Setting up commands...\n')
+
+  // Create ~/.claude/commands if it doesn't exist
+  if (!existsSync(CLAUDE_COMMANDS_DIR)) {
+    mkdirSync(CLAUDE_COMMANDS_DIR, { recursive: true })
+    console.log(`📁 Created ${CLAUDE_COMMANDS_DIR}`)
+  }
+
+  // Check if commands source exists
+  if (!existsSync(COMMANDS_SOURCE)) {
+    console.log('⚠️  Commands directory not found. Skipping symlink creation.')
+    console.log('   You may need to run: planflow-plugin install')
+    return
+  }
+
+  // Get all command directories
+  const commands = readdirSync(COMMANDS_SOURCE, { withFileTypes: true })
+    .filter(dirent => dirent.isDirectory())
+    .map(dirent => dirent.name)
+
+  let created = 0
+  let skipped = 0
+  let updated = 0
+
+  for (const cmd of commands) {
+    const source = join(COMMANDS_SOURCE, cmd)
+    const target = join(CLAUDE_COMMANDS_DIR, cmd)
+
+    try {
+      // Check if target already exists
+      if (existsSync(target)) {
+        const stats = lstatSync(target)
+        if (stats.isSymbolicLink()) {
+          // Remove old symlink and create new one
+          unlinkSync(target)
+          symlinkSync(source, target)
+          updated++
+        } else {
+          // Not a symlink, skip to avoid overwriting user files
+          skipped++
+        }
+      } else {
+        // Create new symlink
+        symlinkSync(source, target)
+        created++
+      }
+    } catch (error) {
+      console.error(`❌ Failed to create symlink for ${cmd}: ${error.message}`)
+    }
+  }
+
+  console.log(`✅ Setup complete!`)
+  console.log(`   • ${created} commands installed`)
+  if (updated > 0) console.log(`   • ${updated} commands updated`)
+  if (skipped > 0) console.log(`   • ${skipped} commands skipped (already exist)`)
+  console.log(`\n📍 Commands installed to: ${CLAUDE_COMMANDS_DIR}`)
+  console.log('\n🚀 Available commands:')
+  console.log('   /planNew      - Create a new project plan')
+  console.log('   /planUpdate   - Update task status')
+  console.log('   /planNext     - Get next task recommendation')
+  console.log('   /pfLogin      - Login to PlanFlow cloud')
+  console.log('   /pfSyncPush   - Push plan to cloud')
+  console.log('\n💡 Restart Claude Code to use the new commands.')
+  console.log('')
+}
+
+setup()