@forloop-cc/forloop-opencode-plugin-planner 2.2.1

package/plugins/tools/user-tools.ts

@@ -0,0 +1,146 @@
+import { tool } from '@opencode-ai/plugin';
+import { ForLoopAPIClient } from '../capabilities/api-client';
+import { validateToken } from '../capabilities/auth';
+
+export function createUserProfileTool(client: ForLoopAPIClient) {
+  return tool({
+    description: 'Get current user profile information (name, email, tier)',
+    args: {},
+    async execute(_args, _context) {
+      const tokenResult = await validateToken();
+      if (!tokenResult.valid) {
+        return tokenResult.error;
+      }
+      client.setToken?.(tokenResult.token);
+
+      try {
+        const profile = await client.getUserProfile();
+        
+        const lines: string[] = [
+          `👤 User Profile`,
+          '',
+          `**Name**: ${profile.name || 'Not set'}`,
+          `**Email**: ${profile.email}`,
+          `**Tier**: ${profile.tier || 'free'}`,
+        ];
+        
+        if (profile.bio) {
+          lines.push(`**Bio**: ${profile.bio}`);
+        }
+        
+        if (profile.avatarUrl) {
+          lines.push(`**Avatar**: ${profile.avatarUrl}`);
+        }
+        
+        return lines.join('\n');
+      } catch (error: any) {
+        return `❌ Error: ${error.message}`;
+      }
+    },
+  });
+}
+
+export function createUserQuotasTool(client: ForLoopAPIClient) {
+  return tool({
+    description: 'Check user quota limits and usage (organizations, sprints, storage)',
+    args: {},
+    async execute(_args, _context) {
+      const tokenResult = await validateToken();
+      if (!tokenResult.valid) {
+        return tokenResult.error;
+      }
+      client.setToken?.(tokenResult.token);
+
+      try {
+        const quotas = await client.getUserQuotas();
+        
+        const formatBytes = (bytes: string) => {
+          const num = parseInt(bytes, 10);
+          if (num === 0) return '0 Bytes';
+          const k = 1024;
+          const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+          const i = Math.floor(Math.log(num) / Math.log(k));
+          return parseFloat((num / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+        };
+        
+        const lines: string[] = [
+          `📊 Quota Usage (${quotas.tier || 'free'} tier)`,
+          '',
+        ];
+        
+        // Organizations
+        lines.push(`**Organizations**: ${quotas.remaining?.ownedOrganizations ?? '?'}/${quotas.limits?.maxOwnedOrganizations ?? '?'}`);
+        
+        // System Sprints
+        lines.push(`**System Sprints**: ${quotas.remaining?.systemSpaces ?? '?'}/${quotas.limits?.maxSystemSprints ?? '?'}`);
+        
+        // Storage
+        const storageUsed = formatBytes(quotas.usage?.storageUsedBytes || '0');
+        const storageLimit = formatBytes(quotas.limits?.maxStorageBytes || '0');
+        lines.push(`**Storage**: ${storageUsed} / ${storageLimit}`);
+        
+        // Free tier stories
+        if (quotas.tier === 'free') {
+          lines.push(`**Free Stories**: ${quotas.remaining?.freeStories ?? '?'}/${quotas.limits?.maxStoriesPerFreeSystemSprint ?? '?'}`);
+        }
+        
+        // Owned organizations usage
+        if (quotas.ownedOrgsUsage && quotas.ownedOrgsUsage.length > 0) {
+          lines.push('');
+          lines.push('**Owned Organizations:**');
+          for (const org of quotas.ownedOrgsUsage) {
+            lines.push(`  - ${org.name}: ${org.spacesUsed}/${org.spacesLimit} sprints`);
+          }
+        }
+        
+        return lines.join('\n');
+      } catch (error: any) {
+        return `❌ Error: ${error.message}`;
+      }
+    },
+  });
+}
+
+export function createOrganizationQuotasTool(client: ForLoopAPIClient) {
+  return tool({
+    description: 'Get quota information for a specific organization',
+    args: {
+      organizationId: tool.schema.number()
+        .describe('Organization ID to check quotas for'),
+    },
+    async execute(args, _context) {
+      const tokenResult = await validateToken();
+      if (!tokenResult.valid) {
+        return tokenResult.error;
+      }
+      client.setToken?.(tokenResult.token);
+
+      try {
+        const quotas = await client.getOrganizationQuotas(args.organizationId);
+        
+        const lines: string[] = [
+          `📊 Organization Quotas`,
+          '',
+          `**Organization**: ${quotas.organization?.name || `#${quotas.organization?.id}`}`,
+          `**Type**: ${quotas.organization?.type || 'user'}`,
+        ];
+        
+        if (quotas.limits) {
+          lines.push('');
+          lines.push('**Limits:**');
+          lines.push(`  - Storage: ${parseInt(quotas.limits.maxStorageBytes).toLocaleString()} bytes`);
+        }
+        
+        if (quotas.usage) {
+          lines.push('');
+          lines.push('**Usage:**');
+          lines.push(`  - Sprints: ${quotas.usage.spacesUsed}`);
+        }
+        
+        return lines.join('\n');
+      } catch (error: any) {
+        return `❌ Error: ${error.message}`;
+      }
+    },
+  });
+}

package/scripts/migrate-tokens.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+/**
+ * ForLoop Token Migration Script
+ * 
+ * Migrates tokens from old location (~/.config/opencode/tokens.json)
+ * to new location (~/.config/forloop/tokens.json)
+ */
+
+import { promises as fs } from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const OLD_TOKEN_PATH = path.join(
+  process.env.HOME || process.env.USERPROFILE || '.',
+  '.config',
+  'opencode',
+  'tokens.json'
+);
+
+const NEW_TOKEN_PATH = path.join(
+  process.env.HOME || process.env.USERPROFILE || '.',
+  '.config',
+  'forloop',
+  'tokens.json'
+);
+
+async function migrate() {
+  console.log('🔄 ForLoop Token Migration');
+  console.log('=========================\n');
+  
+  // Check if old file exists
+  try {
+    await fs.access(OLD_TOKEN_PATH);
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      console.log('✅ No old token file found - nothing to migrate');
+      console.log(`\nTokens will be stored at: ${NEW_TOKEN_PATH}`);
+      return;
+    }
+    throw error;
+  }
+  
+  console.log(`📂 Old location: ${OLD_TOKEN_PATH}`);
+  console.log(`📂 New location: ${NEW_TOKEN_PATH}`);
+  console.log('');
+  
+  // Read old tokens
+  const content = await fs.readFile(OLD_TOKEN_PATH, 'utf-8');
+  const oldTokens = JSON.parse(content);
+  
+  // Create new token structure
+  const newTokens = {
+    version: '1.0',
+    note: 'ForLoop API tokens - do not share',
+    default: oldTokens.default,
+    profiles: oldTokens.profiles || {},
+    lastUpdated: oldTokens.lastUpdated || new Date().toISOString(),
+  };
+  
+  // Create new directory
+  const newDir = path.dirname(NEW_TOKEN_PATH);
+  await fs.mkdir(newDir, { recursive: true });
+  
+  // Write new file with secure permissions
+  await fs.writeFile(NEW_TOKEN_PATH, JSON.stringify(newTokens, null, 2), {
+    mode: 0o600, // Owner read/write only
+  });
+  
+  console.log('✅ Migration successful!');
+  console.log('');
+  console.log('📊 Migrated:');
+  if (newTokens.default) {
+    const masked = newTokens.default.slice(0, 10) + '...';
+    console.log(`   - Default token: ${masked}`);
+  }
+  if (newTokens.profiles && Object.keys(newTokens.profiles).length > 0) {
+    console.log(`   - Profiles: ${Object.keys(newTokens.profiles).join(', ')}`);
+  }
+  console.log('');
+  console.log('📝 You can safely delete the old file:');
+  console.log(`   rm ${OLD_TOKEN_PATH}`);
+  console.log('');
+}
+
+migrate().catch(error => {
+  console.error('❌ Migration failed:', error.message);
+  process.exit(1);
+});

package/scripts/use-prod.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+# Quick script to switch to production environment
+
+rm -f .env
+
+echo "✅ Production environment configured"
+echo ""
+echo "API URL: https://api.forloop.cc (default)"
+echo ""
+echo "To test: opencode"
+echo "Or restart opencode to use default config"

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": ".",
+    "resolveJsonModule": true,
+    "allowSyntheticDefaultImports": true
+  },
+  "include": ["./plugins/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/update.sh

@@ -0,0 +1,172 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# ForLoop Plugin Updater
+# https://github.com/forloop-cc/forloop-opencode-plugin-planner
+#
+# opencode auto-updates plugins on startup. This script verifies the plugin
+# is registered and shows the latest changelog.
+#
+# Usage:
+#   bash update.sh
+#   bash update.sh --changelog
+
+# ── Colors ───────────────────────────────────────────────────────────────────
+PLATFORM="$(uname -s)"
+if [[ "$PLATFORM" =~ MINGW|MSYS|CYGWIN ]] && [ -z "$WT_SESSION" ] && [ -z "$ConEmuPID" ]; then
+    RED=''; GREEN=''; YELLOW=''; BLUE=''; CYAN=''; BOLD=''; NC=''
+else
+    RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'
+    BLUE='\033[0;34m'; CYAN='\033[0;36m'; BOLD='\033[1m'; NC='\033[0m'
+fi
+
+# ── Configuration ────────────────────────────────────────────────────────────
+NPM_PACKAGE="@forloop-cc/forloop-opencode-plugin-planner"
+GIT_URL="forloop-planner@git+https://github.com/forloop-cc/forloop-opencode-plugin-planner.git"
+PLUGIN_DIRNAME="forloop-planner"
+
+SHOW_CHANGELOG=false
+
+print_success() { echo -e "${GREEN}✓${NC} $1"; }
+print_info()    { echo -e "${BLUE}ℹ${NC} $1"; }
+print_warning() { echo -e "${YELLOW}⚠${NC} $1"; }
+print_error()   { echo -e "${RED}✗${NC} $1" >&2; }
+
+show_help() {
+    cat << 'HELPEOF'
+Usage: update.sh [OPTIONS]
+
+opencode auto-updates plugins from git/npm on startup. This script:
+  - Verifies the plugin is registered in opencode.json
+  - Shows the latest changelog from the plugin source
+
+Options:
+  -c, --changelog  Show recent changelog after verification
+  -h, --help       Show this help
+
+Auto-detection order:
+  1. ./opencode.json (project config)
+  2. ~/.config/opencode/opencode.json (global config)
+HELPEOF
+}
+
+# ── Dependency checks ────────────────────────────────────────────────────────
+
+check_jq() {
+    if ! command -v jq &>/dev/null; then
+        print_error "jq is required but not installed"
+        return 1
+    fi
+    return 0
+}
+
+# ── Config lookup ────────────────────────────────────────────────────────────
+
+find_config() {
+    local candidates=("./opencode.json" "$HOME/.config/opencode/opencode.json")
+    for config in "${candidates[@]}"; do
+        if [ -f "$config" ]; then
+            echo "$config"
+            return 0
+        fi
+    done
+    return 1
+}
+
+find_plugin_entry() {
+    local config_file="$1"
+    jq -r '.plugin[]? // empty' "$config_file" | grep -E "forloop-opencode-plugin-planner|$NPM_PACKAGE" | head -1
+}
+
+# ── Changelog ────────────────────────────────────────────────────────────────
+
+show_changelog_from_repo() {
+    local changelog_url="https://raw.githubusercontent.com/forloop-cc/forloop-opencode-plugin-planner/main/CHANGELOG.md"
+    echo ""
+    print_info "Recent changes:"
+    echo "────────────────────────────────────────────"
+    curl -fsSL "$changelog_url" 2>/dev/null | head -40 || {
+        echo "  (could not fetch changelog — check https://github.com/forloop-cc/forloop-opencode-plugin-planner/releases)"
+    }
+    echo "────────────────────────────────────────────"
+}
+
+show_changelog_from_cache() {
+    local cache_dir="$HOME/.cache/opencode/node_modules"
+    local plugin_paths=(
+        "$cache_dir/$NPM_PACKAGE/CHANGELOG.md"
+        "$cache_dir/$NPM_PACKAGE/plugins/forloop-plugin.ts"
+    )
+    for candidate in "${plugin_paths[@]}"; do
+        local changelog="$(dirname "$candidate")/CHANGELOG.md"
+        if [ -f "$changelog" ]; then
+            echo ""
+            print_info "Recent changes:"
+            echo "────────────────────────────────────────────"
+            head -40 "$changelog"
+            echo "────────────────────────────────────────────"
+            return 0
+        fi
+    done
+    return 1
+}
+
+# ── Main ─────────────────────────────────────────────────────────────────────
+
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        -c|--changelog) SHOW_CHANGELOG=true; shift ;;
+        -h|--help)      show_help; exit 0 ;;
+        *)              print_error "Unknown option: $1"; show_help; exit 1 ;;
+    esac
+done
+
+echo ""
+echo -e "${BLUE}${BOLD}╔══════════════════════════════════════════╗"
+echo -e "║       ForLoop Plugin Updater             ║"
+echo -e "╚══════════════════════════════════════════╝${NC}"
+echo ""
+
+check_jq || exit 1
+
+local config_file
+config_file="$(find_config)" || {
+    print_error "No opencode.json found"
+    echo ""
+    echo "  Checked:"
+    echo "    1. ./opencode.json"
+    echo "    2. ~/.config/opencode/opencode.json"
+    echo ""
+    echo "  Install first: curl -fsSL .../install.sh | bash"
+    exit 1
+}
+
+local plugin_entry
+plugin_entry="$(find_plugin_entry "$config_file")"
+
+if [ -z "$plugin_entry" ]; then
+    print_error "ForLoop plugin not registered in $config_file"
+    echo ""
+    echo "  Install first: curl -fsSL .../install.sh | bash"
+    exit 1
+fi
+
+print_success "Plugin registered in: $config_file"
+print_info "Entry: $plugin_entry"
+echo ""
+
+# Detect source type
+if echo "$plugin_entry" | grep -q "git+https://"; then
+    print_info "Source: Git (opencode will pull latest on startup)"
+elif echo "$plugin_entry" | grep -q "@forloop-cc/"; then
+    print_info "Source: npm (opencode will check for updates on startup)"
+fi
+
+echo ""
+print_success "To update: restart opencode — it auto-fetches the latest plugin version"
+
+if [ "$SHOW_CHANGELOG" = true ]; then
+    show_changelog_from_cache || show_changelog_from_repo
+fi
+
+echo ""