semvec/pypi-packages huggingface dataset:
sprint-forecast 0.1.0
Exact-state sprint success forecasting for small agile teams
Requires Python: >=3.11
Keywords: agile, bayesian, forecasting, monte-carlo, sprint

# Sprint forecast (exact-state, simulation-first)

This repository contains a reference implementation of the amended model:

- **Supply / capacity**: daily capacity is a product of planned hours, Bernoulli
  availability, an enumerated blocked/disruption state, and an **unbounded**
  lognormal productivity multiplier.
- **Demand / workload**: remaining work is modelled from **three-point
  estimates** with **global + per-engineer bias correction** on the log scale,
  then mapped to unbounded lognormal item-effort distributions.
- **AI attribution**: AI usage can be introduced as a covariate in both the
  demand-side (bias model / workload) and the supply-side (focus multipliers).
  The implementation computes **counterfactual success probabilities** with AI
  turned off.
- **Bayesian pooling**: conjugate pooling utilities (Beta--Binomial,
  Dirichlet--Multinomial) and linear-Gaussian shrinkage estimators for bias and
  focus parameters.

The core API is `SprintSuccessForecaster`.

## Quickstart

Install:

```bash
python -m pip install sprint-forecast
```

Run the demo:

```bash
python -m sprint_forecast.demo
```

## Zenhub sprint forecast

`run_forecast.py` supports pulling per-issue three-point estimates for the current open Zenhub sprint:

- Set `workload_source.type` to `zenhub_sprint_issues` (see `config.example.json`)
- Provide `ZENHUB_API_TOKEN`
- Export `.scarf/pert-hours.json` from the PERT Hours Tracker (or disable `workload_source.pert.require_*`)

## Sprint process

See `docs/sprint-process.md` for the recommended workflow (assignments, PERT in effective hours, actual tracking, required fields, and AI assumptions).

## Structure

- `sprint_forecast/` – library code
- `examples/` – runnable example
- `tests/` – unit tests (`python -m unittest`)

## Notes

- The implementation targets Python 3.11+.
- Randomness is handled via NumPy's `Generator`.
umbi 0.2.0
Library for input/output of transition systems in a unified Markov binary (UMB) format.
Requires Python: >=3.11

# umbi

Library for input/output of transition systems in a *unified Markov binary (UMB)* format.

## Installation:

(optional) create and activate a python environment:

```
$ python -m venv venv
$ source venv/bin/activate
```

Install `umbi` via
```
(venv) $ pip install umbi
```

## Running umbi

Examples:
```
(venv) $ umbi --import-umb /path/to/input.umb
(venv) $ umbi --import-umb /path/to/input.umb --export-umb /path/to/output.umb
(venv) $ umbi --import-umb /path/to/input.umb --export-umb /path/to/output.umb --log-level=DEBUG
```

## Development

### Installing Development Tools
Run the following command to install all development dependencies:

```bash
pip install .[dev]
```

This will install tools for testing, linting, and other development tasks.


### Setting Up Pre-Commit Hooks
To ensure code quality and consistency, this repository uses `pre-commit` hooks. Developers should set up the hooks by running the following command:

```bash
pre-commit install
```

This will configure `pre-commit` to automatically run checks (e.g., linting, formatting) before each commit. To manually run the hooks on all files, use:

```bash
pre-commit run --all-files
```