Metadata-Version: 2.4
Name: deadline-suggester
Version: 1.0.0
Summary: Deadline Suggester
License: MIT
Project-URL: Homepage, https://github.com/worksOnMyFridge/deadline-suggester
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: aiohttp>=3.9
Requires-Dist: requests>=2.31

# deadline-suggester

Realistic job deadline recommendations for freelance and contract workflows.

pip install deadline-suggester

**Python 3.9+**

---

## Overview

`deadline-suggester` analyzes job specifications and historical completion data to recommend achievable deadlines, accounting for agent availability and rush pricing.

---

## Quick Start

from deadline_suggester import DeadlineSuggesterClient, JobSpecification

client = DeadlineSuggesterClient()

job = JobSpecification(
    job_type="translation",
    complexity="medium",
    word_count=2000,
    attachments=1,
    budget_usd=150.0,
    preferred_deadline_hours=24.0,
)

recommendation = client.recommend(job)
print(recommendation.suggested_deadline)
print(recommendation.recommended_hours)

---

## API Reference

### `JobSpecification`

Describes the job to be evaluated.

| Parameter | Type | Description |
|---|---|---|
| `job_type` | `str` | Category of work |
| `complexity` | `str` | `low`, `medium`, or `high` |
| `word_count` | `int \| None` | Optional word count |
| `attachments` | `int` | Number of attachments |
| `budget_usd` | `float` | Job budget in USD |
| `preferred_deadline_hours` | `float \| None` | Client preferred deadline |

### `DeadlineSuggesterClient` Methods

| Method | Description |
|---|---|
| `recommend(job)` | Returns a `DeadlineRecommendation` for the given `JobSpecification` |
| `record_completion(job, actual_hours)` | Records actual completion time to improve future estimates |
| `estimate_availability()` | Returns an `AgentAvailability` snapshot |
| `rush_premium(job)` | Returns the rush multiplier for expedited delivery |

---

## License

MIT
