loopwork 0.3.0 → 0.3.1

package/examples/basic-json-backend/quick-start.sh

@@ -1,80 +0,0 @@
-#!/bin/bash
-# Quick Start Script for Basic JSON Backend Example
-
-set -e
-
-echo "🚀 Loopwork Basic Example - Quick Start"
-echo "========================================"
-echo ""
-
-# Check if we're in the right directory
-if [ ! -f "loopwork.config.js" ] && [ ! -f "loopwork.config.ts" ]; then
-    echo "❌ Error: Please run this script from the examples/basic-json-backend directory"
-    exit 1
-fi
-
-echo "📋 Current Tasks:"
-cat .specs/tasks/tasks.json | grep -A 2 '"id"'
-echo ""
-
-echo "Choose an option:"
-echo "1) Dry Run (preview without executing)"
-echo "2) Run Loopwork (execute tasks)"
-echo "3) Reset tasks to pending"
-echo "4) View task details"
-echo ""
-
-read -p "Enter your choice (1-4): " choice
-
-case $choice in
-    1)
-        echo ""
-        echo "🔍 Running dry-run..."
-        bun run ../../src/index.ts --dry-run
-        ;;
-    2)
-        echo ""
-        echo "⚡ Running Loopwork..."
-        bun run ../../src/index.ts
-        ;;
-    3)
-        echo ""
-        echo "🔄 Resetting all tasks to pending..."
-        cat > .specs/tasks/tasks.json << 'EOF'
-{
-  "tasks": [
-    {
-      "id": "TASK-001",
-      "status": "pending",
-      "priority": "high"
-    },
-    {
-      "id": "TASK-002",
-      "status": "pending",
-      "priority": "medium"
-    },
-    {
-      "id": "TASK-003",
-      "status": "pending",
-      "priority": "low"
-    }
-  ]
-}
-EOF
-        echo "✅ Tasks reset!"
-        ;;
-    4)
-        echo ""
-        echo "📄 Task Details:"
-        echo ""
-        for task in .specs/tasks/TASK-*.md; do
-            echo "----------------------------------------"
-            head -5 "$task"
-            echo ""
-        done
-        ;;
-    *)
-        echo "❌ Invalid choice"
-        exit 1
-        ;;
-esac

package/loopwork.config.ts

@@ -1,164 +0,0 @@
-import {
-  defineConfig,
-  withTelegram,
-  withCostTracking,
-  withJSON,
-  withGitHub,
-  withPlugin,
-  withAsana,
-  withEverhour,
-  withTodoist,
-  withDiscord,
-  compose,
-} from './src/loopwork-config-types'
-import { withJSONBackend, withGitHubBackend } from './src/backend-plugin'
-
-/**
- * Loopwork Configuration
- *
- * This file configures the Loopwork task runner.
- * Similar to next.config.js, you can use plugin wrappers to add functionality.
- *
- * Backends are now plugins:
- * - withJSONBackend({ tasksFile: 'tasks.json' })
- * - withGitHubBackend({ repo: 'owner/repo' })
- */
-
-// =============================================================================
-// Full Example with All Plugins
-// =============================================================================
-
-export default compose(
-  // Backend plugins (choose one)
-  withJSONBackend({ tasksFile: '.specs/tasks/tasks.json' }),
-  // withGitHubBackend({ repo: 'owner/repo' }),
-
-  // Legacy backend config (still supported)
-  // withJSON({ tasksFile: '.specs/tasks/tasks.json' }),
-  // withGitHub({ repo: 'owner/repo' }),
-
-  // Telegram notifications on task events
-  withTelegram({
-    botToken: process.env.TELEGRAM_BOT_TOKEN,
-    chatId: process.env.TELEGRAM_CHAT_ID,
-    silent: false,
-  }),
-
-  // Asana integration: sync task status to Asana project
-  // Tasks should have metadata.asanaGid set in the tasks file
-  // withAsana({
-  //   projectId: process.env.ASANA_PROJECT_ID,
-  //   syncStatus: true,
-  // }),
-
-  // Everhour time tracking: auto-track time spent on tasks
-  // Uses metadata.everhourId or metadata.asanaGid (auto-prefixed with 'as:')
-  // withEverhour({
-  //   autoStartTimer: true,
-  //   autoStopTimer: true,
-  // }),
-
-  // Todoist integration: sync task status to Todoist
-  // Tasks should have metadata.todoistId set
-  // withTodoist({
-  //   projectId: process.env.TODOIST_PROJECT_ID,
-  //   syncStatus: true,
-  //   addComments: true,
-  // }),
-
-  // Discord notifications via webhook
-  // withDiscord({
-  //   webhookUrl: process.env.DISCORD_WEBHOOK_URL,
-  //   username: 'Loopwork',
-  //   notifyOnComplete: true,
-  //   notifyOnFail: true,
-  //   mentionOnFail: '<@&123456>',  // mention role on failures
-  // }),
-
-  // Cost tracking for token usage
-  withCostTracking({
-    enabled: true,
-    defaultModel: 'claude-3.5-sonnet',
-  }),
-
-  // Dashboard TUI: live progress display
-  // Requires: bun add ink react @types/react
-  // withPlugin(createDashboardPlugin({ totalTasks: 10 })),
-
-  // Custom plugin: Log to console
-  withPlugin({
-    name: 'console-logger',
-    onLoopStart: (namespace) => {
-      console.log(`\n🚀 Loop starting in namespace: ${namespace}\n`)
-    },
-    onTaskStart: (task) => {
-      console.log(`📋 Starting: ${task.id} - ${task.title}`)
-    },
-    onTaskComplete: (task, result) => {
-      console.log(`✅ Completed: ${task.id} in ${result.duration}s`)
-    },
-    onTaskFailed: (task, error) => {
-      console.log(`❌ Failed: ${task.id} - ${error}`)
-    },
-    onLoopEnd: (stats) => {
-      console.log(`\n📊 Loop finished: ${stats.completed} completed, ${stats.failed} failed\n`)
-    },
-  }),
-
-  // Custom plugin: Slack webhook (example)
-  // withPlugin({
-  //   name: 'slack-notify',
-  //   onTaskComplete: async (task) => {
-  //     await fetch(process.env.SLACK_WEBHOOK_URL, {
-  //       method: 'POST',
-  //       headers: { 'Content-Type': 'application/json' },
-  //       body: JSON.stringify({
-  //         text: `✅ Task completed: ${task.id} - ${task.title}`,
-  //       }),
-  //     })
-  //   },
-  // }),
-)(defineConfig({
-  // AI CLI tool: 'opencode', 'claude', or 'gemini'
-  cli: 'opencode',
-
-  // Loop settings
-  maxIterations: 50,
-  timeout: 600,          // seconds per task
-  namespace: 'default',  // for concurrent loops
-
-  // Behavior
-  autoConfirm: false,    // -y flag
-  dryRun: false,
-  debug: false,
-
-  // Retry settings
-  maxRetries: 3,
-  circuitBreakerThreshold: 5,
-  taskDelay: 2000,       // ms between tasks
-  retryDelay: 3000,      // ms before retry
-}))
-
-// =============================================================================
-// Alternative: Backend Plugins Pattern (recommended)
-// =============================================================================
-
-// export default compose(
-//   withJSONBackend({ tasksFile: 'tasks.json' }),
-//   withTelegram(),
-//   withAsana(),
-//   withEverhour(),
-// )(defineConfig({ cli: 'opencode' }))
-
-// =============================================================================
-// Alternative: GitHub Backend Plugin
-// =============================================================================
-
-// export default compose(
-//   withGitHubBackend({ repo: 'myorg/myrepo' }),
-//   withTelegram(),
-//   withDiscord({ webhookUrl: process.env.DISCORD_WEBHOOK_URL }),
-// )(defineConfig({
-//   cli: 'claude',
-//   feature: 'auth',  // filter by feature label
-// }))

package/src/plugins/asana.ts

@@ -1,192 +0,0 @@
-/**
- * Asana Plugin for Loopwork
- *
- * Syncs task status with Asana projects.
- * Tasks should have metadata.asanaGid set to the Asana task GID.
- *
- * Setup:
- * 1. Get Personal Access Token from Asana Developer Console
- * 2. Set ASANA_ACCESS_TOKEN env var
- * 3. Set ASANA_PROJECT_ID env var (from project URL)
- * 4. Add asanaGid to task metadata in your tasks file
- */
-
-import type { LoopworkPlugin, PluginTask } from '../contracts'
-
-export interface AsanaConfig {
-  accessToken?: string
-  projectId?: string
-  workspaceId?: string
-  /** Create Asana tasks for new Loopwork tasks */
-  autoCreate?: boolean
-  /** Sync status changes to Asana */
-  syncStatus?: boolean
-}
-
-interface AsanaTask {
-  gid: string
-  name: string
-  completed: boolean
-  notes?: string
-}
-
-interface AsanaResponse<T> {
-  data: T
-}
-
-export class AsanaClient {
-  private baseUrl = 'https://app.asana.com/api/1.0'
-  private accessToken: string
-
-  constructor(accessToken: string) {
-    this.accessToken = accessToken
-  }
-
-  private async request<T>(
-    method: string,
-    endpoint: string,
-    body?: Record<string, unknown>
-  ): Promise<T> {
-    const url = `${this.baseUrl}${endpoint}`
-    const response = await fetch(url, {
-      method,
-      headers: {
-        'Authorization': `Bearer ${this.accessToken}`,
-        'Content-Type': 'application/json',
-      },
-      body: body ? JSON.stringify({ data: body }) : undefined,
-    })
-
-    if (!response.ok) {
-      const error = await response.text()
-      throw new Error(`Asana API error: ${response.status} - ${error}`)
-    }
-
-    const result = await response.json() as AsanaResponse<T>
-    return result.data
-  }
-
-  async getTask(taskGid: string): Promise<AsanaTask> {
-    return this.request('GET', `/tasks/${taskGid}`)
-  }
-
-  async createTask(projectId: string, name: string, notes?: string): Promise<AsanaTask> {
-    return this.request('POST', '/tasks', {
-      name,
-      notes,
-      projects: [projectId],
-    })
-  }
-
-  async updateTask(taskGid: string, updates: Partial<{ name: string; notes: string; completed: boolean }>): Promise<AsanaTask> {
-    return this.request('PUT', `/tasks/${taskGid}`, updates)
-  }
-
-  async completeTask(taskGid: string): Promise<AsanaTask> {
-    return this.updateTask(taskGid, { completed: true })
-  }
-
-  async addComment(taskGid: string, text: string): Promise<void> {
-    await this.request('POST', `/tasks/${taskGid}/stories`, { text })
-  }
-
-  async getProjectTasks(projectId: string): Promise<AsanaTask[]> {
-    return this.request('GET', `/projects/${projectId}/tasks?opt_fields=gid,name,completed,notes`)
-  }
-}
-
-/**
- * Create Asana plugin wrapper
- */
-export function withAsana(config: AsanaConfig = {}) {
-  const accessToken = config.accessToken || process.env.ASANA_ACCESS_TOKEN
-  const projectId = config.projectId || process.env.ASANA_PROJECT_ID
-
-  return (baseConfig: any) => ({
-    ...baseConfig,
-    asana: {
-      accessToken,
-      projectId,
-      autoCreate: config.autoCreate ?? false,
-      syncStatus: config.syncStatus ?? true,
-    },
-  })
-}
-
-/** Helper to get Asana GID from task metadata */
-function getAsanaGid(task: PluginTask): string | undefined {
-  return task.metadata?.asanaGid as string | undefined
-}
-
-/**
- * Create Asana hook plugin
- *
- * Tasks should have metadata.asanaGid set for Asana integration.
- */
-export function createAsanaPlugin(config: AsanaConfig = {}): LoopworkPlugin {
-  const accessToken = config.accessToken || process.env.ASANA_ACCESS_TOKEN || ''
-  const projectId = config.projectId || process.env.ASANA_PROJECT_ID || ''
-
-  if (!accessToken || !projectId) {
-    return {
-      name: 'asana',
-      onConfigLoad: (cfg) => {
-        console.warn('Asana plugin: Missing ASANA_ACCESS_TOKEN or ASANA_PROJECT_ID')
-        return cfg
-      },
-    }
-  }
-
-  const client = new AsanaClient(accessToken)
-
-  return {
-    name: 'asana',
-
-    async onTaskStart(task) {
-      const asanaGid = getAsanaGid(task)
-      if (!asanaGid) return
-
-      try {
-        await client.addComment(asanaGid, `🔄 Loopwork started working on this task`)
-      } catch (e: any) {
-        console.warn(`Asana: Failed to add comment: ${e.message}`)
-      }
-    },
-
-    async onTaskComplete(task, result) {
-      const asanaGid = getAsanaGid(task)
-      if (!asanaGid) return
-
-      try {
-        if (config.syncStatus !== false) {
-          await client.completeTask(asanaGid)
-        }
-        await client.addComment(
-          asanaGid,
-          `✅ Completed by Loopwork in ${Math.round(result.duration)}s`
-        )
-      } catch (e: any) {
-        console.warn(`Asana: Failed to update task: ${e.message}`)
-      }
-    },
-
-    async onTaskFailed(task, error) {
-      const asanaGid = getAsanaGid(task)
-      if (!asanaGid) return
-
-      try {
-        await client.addComment(
-          asanaGid,
-          `❌ Loopwork failed: ${error.slice(0, 200)}`
-        )
-      } catch (e: any) {
-        console.warn(`Asana: Failed to add comment: ${e.message}`)
-      }
-    },
-
-    async onLoopEnd(stats) {
-      // Could post a summary to a specific task or project
-      console.log(`📊 Asana sync: ${stats.completed} tasks synced`)
-    },
-  }
-}