loopwork 0.3.0 → 0.3.1

package/src/plugins/index.ts

@@ -8,14 +8,15 @@ import type {
   LoopworkConfig,
   LoopworkPlugin,
   ConfigWrapper,
-  TelegramConfig,
-  DiscordConfig,
-  AsanaConfig,
-  EverhourConfig,
-  TodoistConfig,
-  CostTrackingConfig,
 } from '../contracts'
 import { DEFAULT_CONFIG } from '../contracts'
+import { withJSONBackend, withGitHubBackend } from '../backends/plugin'
+
+// ============================================================================
+// Re-exports from backends
+// ============================================================================
+
+export { withJSONBackend, withGitHubBackend }
 
 // ============================================================================
 // Config Helpers
@@ -49,8 +50,8 @@ export function defineConfigAsync(
  *
  * @example
  * export default compose(
- *   withTelegram(),
- *   withCostTracking(),
+ *   withPlugin(myPlugin),
+ *   withJSONBackend(),
  * )(defineConfig({ ... }))
  */
 export function compose(...wrappers: ConfigWrapper[]): ConfigWrapper {
@@ -71,129 +72,6 @@ export function withPlugin(plugin: LoopworkPlugin): ConfigWrapper {
   })
 }
 
-/**
- * Add Telegram notifications
- */
-export function withTelegram(options: TelegramConfig = {}): ConfigWrapper {
-  return (config) => ({
-    ...config,
-    telegram: {
-      notifications: true,
-      silent: false,
-      ...options,
-      botToken: options.botToken || process.env.TELEGRAM_BOT_TOKEN,
-      chatId: options.chatId || process.env.TELEGRAM_CHAT_ID,
-    },
-  })
-}
-
-/**
- * Add Discord notifications
- */
-export function withDiscord(options: DiscordConfig = {}): ConfigWrapper {
-  return (config) => ({
-    ...config,
-    discord: {
-      webhookUrl: options.webhookUrl || process.env.DISCORD_WEBHOOK_URL,
-      username: options.username || 'Loopwork',
-      avatarUrl: options.avatarUrl,
-      notifyOnStart: options.notifyOnStart ?? false,
-      notifyOnComplete: options.notifyOnComplete ?? true,
-      notifyOnFail: options.notifyOnFail ?? true,
-      notifyOnLoopEnd: options.notifyOnLoopEnd ?? true,
-      mentionOnFail: options.mentionOnFail,
-    },
-  })
-}
-
-/**
- * Add Asana integration
- */
-export function withAsana(options: AsanaConfig = {}): ConfigWrapper {
-  return (config) => ({
-    ...config,
-    asana: {
-      accessToken: options.accessToken || process.env.ASANA_ACCESS_TOKEN,
-      projectId: options.projectId || process.env.ASANA_PROJECT_ID,
-      workspaceId: options.workspaceId,
-      autoCreate: options.autoCreate ?? false,
-      syncStatus: options.syncStatus ?? true,
-    },
-  })
-}
-
-/**
- * Add Everhour time tracking
- */
-export function withEverhour(options: EverhourConfig = {}): ConfigWrapper {
-  return (config) => ({
-    ...config,
-    everhour: {
-      apiKey: options.apiKey || process.env.EVERHOUR_API_KEY,
-      autoStartTimer: options.autoStartTimer ?? true,
-      autoStopTimer: options.autoStopTimer ?? true,
-      projectId: options.projectId,
-      dailyLimit: options.dailyLimit ?? 8,
-    },
-  })
-}
-
-/**
- * Add Todoist integration
- */
-export function withTodoist(options: TodoistConfig = {}): ConfigWrapper {
-  return (config) => ({
-    ...config,
-    todoist: {
-      apiToken: options.apiToken || process.env.TODOIST_API_TOKEN,
-      projectId: options.projectId || process.env.TODOIST_PROJECT_ID,
-      syncStatus: options.syncStatus ?? true,
-      addComments: options.addComments ?? true,
-    },
-  })
-}
-
-/**
- * Add cost tracking
- */
-export function withCostTracking(options: CostTrackingConfig = {}): ConfigWrapper {
-  return (config) => ({
-    ...config,
-    costTracking: {
-      enabled: true,
-      defaultModel: 'claude-3.5-sonnet',
-      ...options,
-    },
-  })
-}
-
-/**
- * Use GitHub Issues as backend
- */
-export function withGitHub(options: { repo?: string } = {}): ConfigWrapper {
-  return (config) => ({
-    ...config,
-    backend: {
-      type: 'github',
-      repo: options.repo,
-    },
-  })
-}
-
-/**
- * Use JSON files as backend
- */
-export function withJSON(options: { tasksFile?: string; tasksDir?: string } = {}): ConfigWrapper {
-  return (config) => ({
-    ...config,
-    backend: {
-      type: 'json',
-      tasksFile: options.tasksFile || '.specs/tasks/tasks.json',
-      tasksDir: options.tasksDir,
-    },
-  })
-}
-
 // ============================================================================
 // Plugin Registry
 // ============================================================================

package/examples/README.md

@@ -1,70 +0,0 @@
-# Loopwork Examples
-
-This directory contains example projects demonstrating different ways to use Loopwork.
-
-## Available Examples
-
-### 1. Basic JSON Backend
-**Directory**: `basic-json-backend/`
-
-A simple example using the JSON backend with 3 basic coding tasks:
-- Create a Hello World function
-- Add a sum function
-- Write README documentation
-
-**Best for**: Learning the basics, local development, small projects
-
-**Key Features**:
-- Simple task structure
-- Local file-based task management
-- Easy to understand and modify
-
-[View Example →](./basic-json-backend/)
-
----
-
-## Coming Soon
-
-### GitHub Backend Example
-Using GitHub Issues as a task backend with labels and milestones.
-
-### Advanced Plugins Example
-Demonstrating Telegram notifications, cost tracking, and custom plugins.
-
-### Multi-Feature Project
-Complex project with multiple features, sub-tasks, and dependencies.
-
----
-
-## Quick Start
-
-1. Choose an example directory
-2. Read the README in that directory
-3. Run the example:
-
-```bash
-cd basic-json-backend
-bun run start
-```
-
-## Example Structure
-
-Each example includes:
-- `README.md` - Detailed instructions
-- `loopwork.config.ts` - Configuration file
-- `.specs/tasks/` - Task definitions (for JSON backend)
-- Sample tasks and PRDs
-
-## Learning Path
-
-We recommend following this order:
-
-1. **Start here**: `basic-json-backend/` - Learn core concepts
-2. **Next**: GitHub backend example - Learn backend integration
-3. **Advanced**: Plugins example - Learn extensibility
-
-## Need Help?
-
-- Read the [main documentation](../README.md)
-- Check [troubleshooting guide](../docs/troubleshooting.md)
-- Open an issue on GitHub

package/examples/basic-json-backend/.specs/tasks/TASK-001.md

@@ -1,22 +0,0 @@
-# TASK-001: Create Hello World Function
-
-## Goal
-Create a simple function that returns "Hello, World!"
-
-## Requirements
-- Create a file called `hello.ts`
-- Export a function named `sayHello`
-- The function should return the string "Hello, World!"
-- Add a simple test to verify it works
-
-## Example
-```typescript
-export function sayHello(): string {
-  return "Hello, World!"
-}
-```
-
-## Success Criteria
-- File `hello.ts` exists
-- Function returns correct string
-- Test passes

package/examples/basic-json-backend/.specs/tasks/TASK-002.md

@@ -1,23 +0,0 @@
-# TASK-002: Add a Sum Function
-
-## Goal
-Create a function that adds two numbers together
-
-## Requirements
-- Create a file called `math.ts`
-- Export a function named `sum`
-- The function should take two numbers and return their sum
-- Add tests for the function
-
-## Example
-```typescript
-export function sum(a: number, b: number): number {
-  return a + b
-}
-```
-
-## Success Criteria
-- File `math.ts` exists
-- Function correctly adds two numbers
-- Tests pass
-- Function handles decimal numbers

package/examples/basic-json-backend/.specs/tasks/TASK-003.md

@@ -1,37 +0,0 @@
-# TASK-003: Create README Documentation
-
-## Goal
-Write a simple README.md file for the project
-
-## Requirements
-- Create a `README.md` file in the project root
-- Include a project title
-- Add a brief description
-- List the functions available
-- Show usage examples
-
-## Example Structure
-```markdown
-# My Project
-
-A simple TypeScript project with basic utility functions.
-
-## Functions
-
-### sayHello()
-Returns a greeting message.
-
-### sum(a, b)
-Adds two numbers together.
-
-## Usage
-
-`npm install`
-`npm test`
-```
-
-## Success Criteria
-- README.md exists
-- Contains all required sections
-- Examples are clear and accurate
-- Proper markdown formatting

package/examples/basic-json-backend/.specs/tasks/tasks.json

@@ -1,19 +0,0 @@
-{
-  "tasks": [
-    {
-      "id": "TASK-001",
-      "status": "completed",
-      "priority": "high"
-    },
-    {
-      "id": "TASK-002",
-      "status": "completed",
-      "priority": "medium"
-    },
-    {
-      "id": "TASK-003",
-      "status": "completed",
-      "priority": "low"
-    }
-  ]
-}

package/examples/basic-json-backend/README.md

@@ -1,32 +0,0 @@
-# Basic JSON Backend
-
-A simple TypeScript project with basic utility functions.
-
-## Functions
-
-### sayHello()
-Returns a greeting message.
-
-### sum(a, b)
-Adds two numbers together.
-
-## Usage
-
-### Install dependencies
-```bash
-bun install
-```
-
-### Run tests
-```bash
-bun test
-```
-
-## Example
-```typescript
-import { sayHello } from './hello'
-import { sum } from './math'
-
-console.log(sayHello()) // 'Hello, World!'
-console.log(sum(2, 3))  // 5
-```

package/examples/basic-json-backend/TESTING.md

@@ -1,184 +0,0 @@
-# Testing Guide
-
-This document explains how to test the loopwork example.
-
-## Quick Start
-
-### Option 1: Interactive Menu
-
-```bash
-./quick-start.sh
-```
-
-Choose from:
-1. **Dry Run** - Preview tasks without executing
-2. **Run Loopwork** - Execute tasks with AI
-3. **Reset tasks** - Reset all tasks to pending status
-4. **View task details** - See task descriptions
-
-### Option 2: Direct Commands
-
-```bash
-# Dry run (preview)
-bun run dry-run
-
-# Actually execute
-bun run start
-
-# With explicit flags
-bun ../../src/index.ts --dry-run
-bun ../../src/index.ts --cli claude --timeout 600
-```
-
-## Testing Checklist
-
-### 1. Config Loading
-
-```bash
-bun ../../src/index.ts --dry-run 2>&1 | grep "CLI:"
-# Should show: CLI: claude (from config)
-
-bun ../../src/index.ts --dry-run 2>&1 | grep "Max Iterations:"
-# Should show: Max Iterations: 10 (from config)
-```
-
-### 2. Dry Run Mode
-
-```bash
-bun ../../src/index.ts --dry-run 2>&1 | grep "Dry Run:"
-# Should show: Dry Run: true
-
-bun ../../src/index.ts 2>&1 | grep "Dry Run:"
-# Should show: Dry Run: false
-```
-
-### 3. Task Priority
-
-```bash
-bun ../../src/index.ts --dry-run 2>&1 | grep "Task:" | head -1
-# Should show: Task: TASK-001 (high priority first)
-```
-
-### 4. Config Override
-
-```bash
-bun ../../src/index.ts --cli opencode --dry-run 2>&1 | grep "CLI:"
-# Should show: CLI: opencode (CLI arg overrides config)
-```
-
-## Manual Testing
-
-### Test 1: Complete Workflow
-
-1. Reset tasks: `echo "3" | ./quick-start.sh`
-2. Check status: `cat .specs/tasks/tasks.json`
-3. Run dry-run: `bun run dry-run`
-4. Verify output shows all 3 tasks
-
-### Test 2: Task Execution
-
-⚠️ **Warning**: This will actually execute AI commands!
-
-```bash
-# Make sure you want to run this
-bun run start
-
-# Monitor in another terminal
-tail -f loopwork-runs/basic-example/*/logs/iteration-*.txt
-```
-
-### Test 3: State Management
-
-```bash
-# Start execution
-bun run start
-
-# In another terminal, send SIGINT
-kill -INT <pid>
-
-# Should save state and show:
-# "State saved. Resume with: --resume"
-
-# Resume
-bun ../../src/index.ts --resume
-```
-
-## Debugging
-
-### Enable Debug Mode
-
-```bash
-# Method 1: Environment variable
-LOOPWORK_DEBUG=true bun ../../src/index.ts --dry-run
-
-# Method 2: CLI flag
-bun ../../src/index.ts --debug --dry-run
-```
-
-### Check Command Being Executed
-
-```bash
-bun ../../src/index.ts --debug --dry-run 2>&1 | grep "Executing:"
-# Shows: [model-name] Executing: <command>
-```
-
-### Verify Config File Loading
-
-```bash
-# Should NOT show warning about failed config load
-bun ../../src/index.ts --dry-run 2>&1 | head -5
-```
-
-## Common Issues
-
-### "No pending tasks found"
-
-Tasks have been completed. Reset them:
-```bash
-echo "3" | ./quick-start.sh
-```
-
-### "Another loopwork is running"
-
-Remove the lock file:
-```bash
-rm -rf .loopwork-*.lock
-```
-
-### Config not loading
-
-Make sure you're in the correct directory:
-```bash
-pwd
-# Should be: .../examples/basic-json-backend
-
-ls loopwork.config.js
-# Should exist
-```
-
-### --dry-run not working
-
-This was a known issue that's now fixed. Update to latest code:
-```bash
-git pull origin main
-```
-
-## Success Criteria
-
-All of these should pass:
-
-- ✅ `./quick-start.sh` shows interactive menu
-- ✅ `bun run dry-run` shows 3 pending tasks
-- ✅ Config values are loaded (claude CLI, 10 max iterations, 300s timeout)
-- ✅ `--dry-run` flag shows "Dry Run: true"
-- ✅ Tasks are shown in priority order (TASK-001 first)
-- ✅ Command being executed is displayed
-
-## Next Steps
-
-After testing the basic example:
-
-1. Try modifying the config (change CLI, timeouts, etc.)
-2. Create your own tasks in `.specs/tasks/`
-3. Experiment with task dependencies
-4. Add plugins (Telegram, cost tracking, etc.)

package/examples/basic-json-backend/hello.test.ts

@@ -1,9 +0,0 @@
-import { describe, it, expect } from 'bun:test'
-import { sayHello } from './hello'
-
-describe('sayHello', () => {
-  it('should return "Hello, World!"', () => {
-    const result = sayHello()
-    expect(result).toBe('Hello, World!')
-  })
-})

package/examples/basic-json-backend/hello.ts

@@ -1,3 +0,0 @@
-export function sayHello(): string {
-  return 'Hello, World!'
-}

package/examples/basic-json-backend/loopwork.config.js

@@ -1,35 +0,0 @@
-/**
- * Basic Loopwork Configuration Example
- *
- * This is a minimal configuration for testing loopwork with JSON backend.
- * Tasks are stored in .specs/tasks/tasks.json
- */
-
-export default {
-  // Backend configuration
-  backend: {
-    type: 'json',
-    tasksFile: '.specs/tasks/tasks.json',
-    tasksDir: '.specs/tasks',
-  },
-
-  // CLI tool to use: 'opencode' or 'claude'
-  cli: 'claude',
-
-  // Loop settings
-  maxIterations: 10,
-  timeout: 300, // 5 minutes per task
-
-  // Optional settings
-  // dryRun: false,       // Set to true to test without executing (use --dry-run flag instead)
-  debug: true,         // Enable debug logging
-  // autoConfirm: false,  // Set to true to skip confirmations (use -y flag instead)
-
-  // Retry settings
-  maxRetries: 2,
-  retryDelay: 3000,    // Wait 3 seconds before retry
-  taskDelay: 2000,     // Wait 2 seconds between tasks
-
-  // Namespace for concurrent runs
-  namespace: 'basic-example',
-}

package/examples/basic-json-backend/math.test.ts

@@ -1,29 +0,0 @@
-import { describe, it, expect } from 'bun:test'
-import { sum } from './math'
-
-describe('sum', () => {
-  it('should add two positive integers', () => {
-    const result = sum(2, 3)
-    expect(result).toBe(5)
-  })
-
-  it('should add two negative integers', () => {
-    const result = sum(-2, -3)
-    expect(result).toBe(-5)
-  })
-
-  it('should add positive and negative integers', () => {
-    const result = sum(5, -3)
-    expect(result).toBe(2)
-  })
-
-  it('should handle decimal numbers', () => {
-    const result = sum(2.5, 3.7)
-    expect(result).toBe(6.2)
-  })
-
-  it('should handle zero', () => {
-    const result = sum(0, 5)
-    expect(result).toBe(5)
-  })
-})

package/examples/basic-json-backend/math.ts

@@ -1,3 +0,0 @@
-export function sum(a: number, b: number): number {
-  return a + b
-}

package/examples/basic-json-backend/package.json

@@ -1,15 +0,0 @@
-{
-  "name": "loopwork-example-basic",
-  "version": "1.0.0",
-  "private": true,
-  "type": "module",
-  "description": "Basic example of using Loopwork with JSON backend",
-  "scripts": {
-    "start": "bun run ../../src/index.ts",
-    "dry-run": "bun run ../../src/index.ts --dry-run",
-    "build": "echo 'No build needed for example'"
-  },
-  "devDependencies": {
-    "@types/bun": "latest"
-  }
-}