@bbhunter/project-sync

CLI tool to sync project roadmaps to BBHunter platform using JSON format.

Installation

npm install -g @bbhunter/project-sync

Quick Start

# Initialize project with sample templates
bbhunter init

# Configure webhook
bbhunter config --url YOUR_WEBHOOK_URL --secret YOUR_SECRET

# Sync to platform
bbhunter sync

# Watch for changes (auto-sync)
bbhunter watch

Project Structure

After running bbhunter init, you'll have:

your-project/
├── project.json          # Project metadata & dashboard
├── phases/              # Phase definitions
│   ├── phase-1.json
│   ├── phase-2.json
│   └── phase-3.json
└── .bbhunter.json       # Webhook configuration

JSON Format

project.json

{
  "project_name": "Sample Project",
  "description": "Project description",
  "dashboard": {
    "total_phases": 3,
    "completed_phases": 0,
    "total_tasks": 9,
    "completed_tasks": 0,
    "total_hours": 72,
    "start_date": "2025-02-01",
    "target_end_date": "2025-03-01",
    "status": "not-started"
  },
  "team": {
    "project_manager": "Your Name",
    "lead_developer": "Developer Name",
    "developers": ["Dev 1", "Dev 2"]
  },
  "milestones": [
    {
      "name": "Phase 1 Complete",
      "target_date": "2025-02-10",
      "status": "pending"
    }
  ]
}

phases/phase-1.json

{
  "phase_number": 1,
  "name": "Foundation & Setup",
  "status": "not-started",
  "progress": 0,
  "duration_days": 10,
  "start_date": "2025-02-01",
  "target_end_date": "2025-02-10",
  "tasks": [
    {
      "task_number": "1.1",
      "name": "Project Initialization",
      "description": "Setup project structure",
      "priority": "high",
      "status": "not-started",
      "progress": 0,
      "estimated_hours": 8,
      "due_date": "2025-02-03",
      "subtasks": [
        {
          "subtask_number": "1.1.1",
          "name": "Initialize repository",
          "status": "not-started",
          "completed": false,
          "estimated_hours": 2
        }
      ]
    }
  ]
}

Commands

bbhunter init

Initialize project with sample JSON templates.

bbhunter config

Configure webhook URL and secret.

Options:

• --url - Webhook URL
• --secret - Webhook secret

bbhunter sync

Sync project data to BBHunter platform.

bbhunter watch

Watch for changes and auto-sync.

Features

✅ JSON-based - No parsing, direct data structure
✅ Type-safe - Exact field types
✅ Easy to edit - Simple JSON format
✅ Auto-sync - Watch mode for real-time updates
✅ Dashboard data - Project metrics included
✅ Team management - Team member tracking
✅ Milestones - Project milestone tracking

Version 2.0.0

Breaking Changes:

• Switched from Markdown to JSON format
• No more parsing or regex issues
• Direct webhook sync
• Simpler, more reliable

License

MIT