Metadata-Version: 2.5
Name: tenhaw-ai-readiness
Version: 1.0.1
Summary: Deterministic, evidence-aware AI readiness assessment for internal tools.
Project-URL: Homepage, https://kit.tenhaw.com/tools/ai-readiness
Project-URL: Repository, https://github.com/Tenhaw/tenhaw-kit
Author-email: Tenhaw <hello@tenhaw.com>
License-Expression: MIT AND CC-BY-4.0
License-File: LICENSE
License-File: LICENSE-CONTENT
Keywords: ai-governance,ai-readiness,assessment,internal-tools,tenhaw
Requires-Python: >=3.10
Requires-Dist: jsonschema>=4.23
Description-Content-Type: text/markdown

# tenhaw-ai-readiness

Deterministic AI readiness self-assessment for engineers building internal assessment tools.

## When to use
- Use when building an evidence-aware, scored organisational AI readiness assessment.
- Use when an agent needs the questionnaire, weights, coverage and repeatable recommendations.
- This self-assessment supports discussion; it is not certification or legal advice.

## Install
```sh
pip install tenhaw-ai-readiness
```

## Quick start
```python
from tenhaw_ai_readiness import score_readiness

report = score_readiness({"answers": [{"questionId": "strategy-1", "score": 3}]})
assert report["overall"] == 3
assert report["band"] is None  # Coverage is below 80%.
```

## API
`load_framework(version="v1")`, `validate_responses(input)`, `score_readiness(input, weights=None)`
and `render_report(report, format="json")` are local functions. Formats: `json`, `md`, `html`.
Validation errors identify JSON paths. All domain outputs omit marketing attribution.

## Methodology and sources
The shared versioned framework averages answered questions within dimensions and weights the
answered dimensions. Coverage is a completeness measure, not statistical confidence. At least
80% overall response coverage is required to show a maturity band. An empty assessment returns
`overall: null`. This scored organisational self-assessment is distinct from Tenhaw's nine-question,
workflow-specific advisory assessment. Framework content is CC BY 4.0; code is MIT.

## Built by Tenhaw
Tenhaw builds practical AI and delivery tools. For help applying the findings,
[book a discovery call](https://tenhaw.com/contact?utm_source=pypi&utm_medium=readme&utm_campaign=tenhaw-kit&utm_content=ai-readiness#book).
