Metadata-Version: 2.4
Name: stakeholder-ask-ranker
Version: 0.1.0
Summary: Local CLI and desktop app for ranking messy stakeholder asks into a focused delivery queue.
Author: Haider Sattar
License-Expression: MIT
Project-URL: Homepage, https://github.com/iwaheedsattar/stakeholder-ask-ranker
Project-URL: Repository, https://github.com/iwaheedsattar/stakeholder-ask-ranker
Project-URL: Issues, https://github.com/iwaheedsattar/stakeholder-ask-ranker/issues
Keywords: product-management,prioritization,stakeholders,cli,desktop,productivity
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Environment :: MacOS X
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Information Technology
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Office/Business
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: llm
Requires-Dist: requests>=2.31; extra == "llm"
Dynamic: license-file

# Stakeholder Ask Ranker

![Stakeholder Ask Ranker preview](docs/screenshot.svg)

Stakeholder Ask Ranker turns pasted stakeholder requests, meeting scraps, and planning notes into a prioritized delivery queue. It runs locally as a CLI or a small Tkinter desktop app.

It is useful when product, support, sales, and leadership asks arrive in different formats and someone needs a quick first pass before grooming the work.

## Install

```bash
python3 -m pip install stakeholder-ask-ranker
```

## CLI

```bash
stakeholder-ask-ranker examples/stakeholder-notes.txt
stakeholder-ask-ranker examples/stakeholder-notes.txt --format json
stakeholder-ask-ranker examples/stakeholder-notes.txt --format csv --output queue.csv
```

The CLI also reads from stdin:

```bash
pbpaste | stakeholder-ask-ranker --format markdown
```

## Desktop App

```bash
stakeholder-ask-ranker-gui
```

Paste notes, rank the queue, switch between Markdown, JSON, and CSV, then copy or save the result.

## Optional Planning Briefs

For a short LLM-generated planning brief, choose a provider and set the matching environment variable:

```bash
OPENAI_API_KEY=... stakeholder-ask-ranker examples/stakeholder-notes.txt --llm openai
ANTHROPIC_API_KEY=... stakeholder-ask-ranker examples/stakeholder-notes.txt --llm anthropic
stakeholder-ask-ranker examples/stakeholder-notes.txt --llm ollama --model llama3.1
```

Provider calls are opt-in. Ranking works without network access or API keys.

## What It Scores

- Value signals such as customer, revenue, compliance, incident, and renewal risk
- Urgency signals such as today, tomorrow, urgent, blocked, deadline, and before launch
- Named requester, owner, stakeholder, due date, and impact fields
- Effort hints such as copy, report, dashboard, workflow, integration, migration, and rewrite
- Confidence based on how complete the ask is

## Development

```bash
python3 -m pytest
python3 -m build --no-isolation
python3 -m twine check dist/*
```

## License

MIT
