jev-typed-decision 0.1.0__tar.gz

jev_typed_decision-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: jev-typed-decision
+Version: 0.1.0
+Summary: Typed decision records for small local models: parse, verify and route confidence instead of prose. Reference notes: https://jev001.org/
+Author: Jev001 maintainers
+License: MIT
+Project-URL: Homepage, https://jev001.org/
+Project-URL: Documentation, https://jev001.org/what-is-jev/
+Project-URL: Guide, https://jev001.org/jev-api/
+Project-URL: Examples, https://jev001.org/jev-use-cases/
+Keywords: llm,decision,confidence,routing,typed-output
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# jev-typed-decision
+
+Small models write convincing prose. Convincing prose is not a confidence
+signal. This package keeps a **typed decision record** instead: the answer, a
+numeric confidence, the evidence it leaned on, and what to do when confidence
+is low.
+
+```python
+from jev_typed_decision import record, needs_human
+
+rec = record("route to human", 0.42, evidence=["eval-2026-09"])
+needs_human(rec)   # True -> escalate instead of acting
+```
+
+## Why
+
+Reading the *shape* of a decision beats reading the *sound* of the answer.
+Details, background and worked examples:
+
+- [What Jev is](https://jev001.org/what-is-jev/)
+- [Jev API notes](https://jev001.org/jev-api/)
+- [Run Laya locally](https://jev001.org/run-laya-locally/)
+- [Use cases](https://jev001.org/jev-use-cases/)
+- [Home](https://jev001.org/)
+
+## Scope
+
+Reference helper, stdlib only, no runtime dependencies. Confidence clamping is
+deliberately blunt; calibrate per project.

jev_typed_decision-0.1.0/README.md

@@ -0,0 +1,29 @@
+# jev-typed-decision
+
+Small models write convincing prose. Convincing prose is not a confidence
+signal. This package keeps a **typed decision record** instead: the answer, a
+numeric confidence, the evidence it leaned on, and what to do when confidence
+is low.
+
+```python
+from jev_typed_decision import record, needs_human
+
+rec = record("route to human", 0.42, evidence=["eval-2026-09"])
+needs_human(rec)   # True -> escalate instead of acting
+```
+
+## Why
+
+Reading the *shape* of a decision beats reading the *sound* of the answer.
+Details, background and worked examples:
+
+- [What Jev is](https://jev001.org/what-is-jev/)
+- [Jev API notes](https://jev001.org/jev-api/)
+- [Run Laya locally](https://jev001.org/run-laya-locally/)
+- [Use cases](https://jev001.org/jev-use-cases/)
+- [Home](https://jev001.org/)
+
+## Scope
+
+Reference helper, stdlib only, no runtime dependencies. Confidence clamping is
+deliberately blunt; calibrate per project.

jev_typed_decision-0.1.0/jev_typed_decision.egg-info/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: jev-typed-decision
+Version: 0.1.0
+Summary: Typed decision records for small local models: parse, verify and route confidence instead of prose. Reference notes: https://jev001.org/
+Author: Jev001 maintainers
+License: MIT
+Project-URL: Homepage, https://jev001.org/
+Project-URL: Documentation, https://jev001.org/what-is-jev/
+Project-URL: Guide, https://jev001.org/jev-api/
+Project-URL: Examples, https://jev001.org/jev-use-cases/
+Keywords: llm,decision,confidence,routing,typed-output
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# jev-typed-decision
+
+Small models write convincing prose. Convincing prose is not a confidence
+signal. This package keeps a **typed decision record** instead: the answer, a
+numeric confidence, the evidence it leaned on, and what to do when confidence
+is low.
+
+```python
+from jev_typed_decision import record, needs_human
+
+rec = record("route to human", 0.42, evidence=["eval-2026-09"])
+needs_human(rec)   # True -> escalate instead of acting
+```
+
+## Why
+
+Reading the *shape* of a decision beats reading the *sound* of the answer.
+Details, background and worked examples:
+
+- [What Jev is](https://jev001.org/what-is-jev/)
+- [Jev API notes](https://jev001.org/jev-api/)
+- [Run Laya locally](https://jev001.org/run-laya-locally/)
+- [Use cases](https://jev001.org/jev-use-cases/)
+- [Home](https://jev001.org/)
+
+## Scope
+
+Reference helper, stdlib only, no runtime dependencies. Confidence clamping is
+deliberately blunt; calibrate per project.

jev_typed_decision-0.1.0/jev_typed_decision.egg-info/SOURCES.txt

@@ -0,0 +1,7 @@
+README.md
+jev_typed_decision.py
+pyproject.toml
+jev_typed_decision.egg-info/PKG-INFO
+jev_typed_decision.egg-info/SOURCES.txt
+jev_typed_decision.egg-info/dependency_links.txt
+jev_typed_decision.egg-info/top_level.txt

jev_typed_decision-0.1.0/jev_typed_decision.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

jev_typed_decision-0.1.0/jev_typed_decision.egg-info/top_level.txt

@@ -0,0 +1 @@
+jev_typed_decision

jev_typed_decision-0.1.0/jev_typed_decision.py

@@ -0,0 +1,47 @@
+"""Tiny helper: keep a typed decision record instead of scraping model prose.
+
+Notes and background: https://jev001.org/
+"""
+
+__version__ = "0.1.0"
+
+FIELDS = ("answer", "confidence", "evidence", "fallback")
+
+
+def record(answer, confidence, evidence=None, fallback=None):
+    """Build a validated decision record.
+
+    confidence is a float in [0, 1]; anything outside is clamped and flagged.
+    """
+    if not isinstance(answer, str) or not answer.strip():
+        raise ValueError("answer must be a non-empty string")
+    try:
+        confidence = float(confidence)
+    except (TypeError, ValueError):
+        raise ValueError("confidence must be a number")
+    clamped = min(1.0, max(0.0, confidence))
+    return {
+        "answer": answer.strip(),
+        "confidence": clamped,
+        "clamped": clamped != confidence,
+        "evidence": list(evidence or []),
+        "fallback": fallback,
+    }
+
+
+def needs_human(rec, threshold=0.6):
+    """Route low-confidence records to a human instead of acting on them."""
+    return rec["confidence"] < threshold
+
+
+if __name__ == "__main__":
+    r = record(" ship it ", 1.4, evidence=["eval-2026-09"])
+    assert r["confidence"] == 1.0 and r["clamped"] is True
+    assert needs_human(record("maybe", 0.31)) is True
+    assert needs_human(record("sure", 0.9)) is False
+    try:
+        record("", 0.5)
+        raise AssertionError("empty answer must raise")
+    except ValueError:
+        pass
+    print("self-check ok", r)

jev_typed_decision-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "jev-typed-decision"
+version = "0.1.0"
+description = "Typed decision records for small local models: parse, verify and route confidence instead of prose. Reference notes: https://jev001.org/"
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+authors = [{name = "Jev001 maintainers"}]
+keywords = ["llm", "decision", "confidence", "routing", "typed-output"]
+classifiers = ["Programming Language :: Python :: 3", "Topic :: Scientific/Engineering :: Artificial Intelligence"]
+
+[project.urls]
+Homepage = "https://jev001.org/"
+Documentation = "https://jev001.org/what-is-jev/"
+Guide = "https://jev001.org/jev-api/"
+Examples = "https://jev001.org/jev-use-cases/"
+
+[tool.setuptools]
+py-modules = ["jev_typed_decision"]

jev_typed_decision-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+