Understanding: IEEE/ISO 표준 기반 요구사항 품질 분석 도구

uv tool install git+https://github.com/Testimonial/understanding.git \
  --with "spacy>=3.0.0" \
  --with "graphviz>=0.20.0"

# Download spaCy language model
uv pip install --python ~/.local/share/uv/tools/understanding/bin/python \
  en-core-web-sm@https://github.com/explosion/spacy-models/releases/download/en_core_web_sm-3.8.0/en_core_web_sm-3.8.0-py3-none-any.whl

# Scan a spec (NLP + entity extraction enabled by default)
understanding spec.md

# Enforce quality gates (exit code 1 on failure)
understanding spec.md --validate

# JSON for CI/CD
understanding spec.md --json --validate

from understanding import analyze_with_enhanced_metrics

result = analyze_with_enhanced_metrics(text)
metrics = result["enhanced_metrics"]
overall = metrics["overall_weighted_average"]
categories = metrics["category_averages"]

print(f"Overall: {overall:.2%}")
print(f"Structure: {categories['structure']:.2%}")
print(f"Testability: {categories['testability']:.2%}")

from understanding import analyze_energy
# Requires: pip install understanding[energy]

result = analyze_energy("The system must validate user email format before saving.")
print(f"Composite: {result.composite_score:.2%}")
for token, energy in result.hotspot_tokens:
    print(f"  {token}: {energy:.2f}")