Metadata-Version: 2.5
Name: narrativetrace-clarity
Version: 0.1.0
Summary: Naming-clarity analysis and CI gate for narrativetrace
Project-URL: Homepage, https://github.com/narrativetrace/narrativetrace-python
Project-URL: Source, https://github.com/narrativetrace/narrativetrace-python
Author: narrativetrace contributors
License-Expression: BUSL-1.1
License-File: LICENSE
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: narrativetrace
Description-Content-Type: text/markdown

# narrativetrace-clarity

Naming-clarity analysis and CI gate for [narrativetrace](../narrativetrace).

The clarity engine, with dictionaries byte-identical across runtimes: 828 domain verbs (1053 total across
34 categories), 187 abbreviations, 35 collocation maps, and role-suffix dictionaries feed five
weighted scorers (method 0.30, class 0.20, parameter 0.25, structural 0.15, cohesion 0.10).

* `analyze(tree)` — score any core `TraceTree`.
* `narrativetrace-clarity <paths…>` — scan Python sources, write `clarity-report.md` /
  `clarity-results.json`, and gate the build with `--min-score` / `--max-high-issues`.
