Budi Task Manager

🚀 Project Overview

Budi Task Manager is a sophisticated, TypeScript-based task management library designed to streamline complex project workflows. Built with extensibility and advanced project management needs in mind, it provides a robust set of tools for tracking, analyzing, and optimizing task-based projects.

📦 Features

🔹 Advanced Task Management

• Comprehensive task creation with rich metadata
• Flexible task status tracking
• Intelligent dependency management
• Priority-based task handling

🔹 Dependency Tracking

• Create tasks with complex dependency relationships
• Prevent task completion when dependencies are unresolved
• Automatic dependency resolution

🔹 Resource Allocation

• Calculate project resource utilization
• Predictive capacity planning
• Detailed resource consumption insights

🔹 Project Analysis

• Comprehensive project progress tracking
• Advanced complexity scoring
• Predictive project completion estimations

🛠 Installation

npm install budi-task-manager

📘 Basic Usage
Creating Tasks:
import { TaskManager, TaskStatus } from 'budi-task-manager';

// Initialize task manager
const taskManager = new TaskManager();

// Create a task with priority and tags
const setupTask = taskManager.createTask(
  'Project Infrastructure', 
  'Set up development environment',
  { 
    priority: 5,
    tags: ['setup', 'initial']
  }
);

// Update task status
taskManager.updateTaskStatus(setupTask.id, TaskStatus.IN_PROGRESS);

Advanced Dependency Management:
// Create tasks with dependencies
const designTask = taskManager.createTask('System Design', 'Architectural planning', { priority: 4 });
const developmentTask = taskManager.createTask('Development', 'Implement core features', { 
  priority: 3, 
  dependencies: [designTask.id] 
});

Resource Allocation:
const resourceAllocation = taskManager.calculateResourceAllocation(100);
console.log(resourceAllocation);
// {
//   totalTasks: 2,
//   allocatedResources: 7,
//   remainingCapacity: 93,
//   utilizationPercentage: 7
// }

🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
📄 License
MIT License
🌟 Acknowledgements
Developed with ❤️ by The People's Secret Admire

## 3. Completing Your Tasks

### Run Comprehensive Tests

1. Execute all test suites with a single command:
   ```bash
   npm run test:all

2. For targeted testing:
# Run only core tests
npm test

# Run integration tests
npm run test:integration

# Run advanced feature tests
npm run test:advanced

# Run with coverage report
npm run test:coverage

3. To run the comprehensive test script:
npm run test:comprehensive

## 📚 Documentation

API documentation is available in the [docs](./docs) directory. Generate the latest documentation with:

```bash
npm run docs
EOF

## 2. Update GitHub Repository

```bash
# Add docs to gitignore
echo "docs/*" >> .gitignore

# Commit changes
git add README.md .gitignore
git commit -m "Add documentation information to README"
git push