NeoSyntropyFramework

Framework / KPI

Measure quality without changing policy

KPI nodes score node, group, or complete workflow outcomes and always continue unless you add a separate validation gate.

KPI result contract

  • Every KPI returns KpiResult with name, score, and reason.
  • Functional KPI nodes can write the score and reason into state and state['kpis'].
  • Semantic KPI nodes return output without silently blocking execution.
  • Place a functional validation node after the KPI when a score threshold is policy.

Score deterministically

Pythonpython
from neosyntropy.core.kpi import functional_kpi_node
from neosyntropy.core.node.schemas import KpiResult

@functional_kpi_node(id="Completeness", input_schema=OpenInput, output_key="completeness")
def completeness(ctx):
    present = sum(key in ctx.state for key in ("name", "email", "topic"))
    return KpiResult(
        name="completeness",
        score=present / 3,
        reason=f"present={present}/3",
    )