Skip to content

Releases: mentatzoe/nunchi

nunchi v0.2.0

Choose a tag to compare

@mentatzoe mentatzoe released this 02 Jul 13:17

First PyPI release: pip install nunchi.

nunchi (눈치, NOON-chee): the art of reading the room and knowing whether it is your turn to speak. This library gives your agent that.

Renamed from TurnAware (never published; clean break — NUNCHI_* env vars, nunchi/nunchi-channel scripts, NunchiError).

Social core prompt — the classifier now poses the read-the-room question judged as a socially competent participant would, instead of a baked-in rulebook. Room doctrine from the open-floor pilot survives as profiles/open-floor.md, supplied via pinned_rules by rooms that want it, applied with precedence over plain social sense.

Tolerant reference bookkeeping — near-miss context_checked references normalise instead of failing the evaluation; pinned-rules references no longer count as corroboration for require_pass_corroboration.

Published via PyPI Trusted Publishing (OIDC) — no API token exists anywhere. See CHANGELOG.md and specs/003-classifier-test-suite/evidence/social-core-2026-07-02.md for the live-evidence record.

TurnAware v0.1.0

Choose a tag to compare

@mentatzoe mentatzoe released this 16 Jun 02:31

First release of TurnAware — a portable, stdlib-only pre-reply admission gate for turn-aware agents. It decides, before an agent replies on a shared surface, whether to PASS / ACK / ASK / SPEAK.

Highlights

  • Provider-backed classifier (default google/gemini-3.1-flash-lite; qwen/qwen3-235b-a22b-2507 as an open-weight alternative), security-hardened config, bounded retry/backoff on transient provider errors.
  • Deterministic fast-path cuts per-turn cost/latency — resolves @mention-elsewhere and self-echo to PASS with no LLM call; everything ambiguous escalates to the model.
  • Transport-neutral channel adapter (verdict + silent); cc-connect is an opt-in preset, not a dependency. Generic --silent-token for any transport.
  • Opt-in PASS-corroboration mode for surfaces that must challenge unverified "done" claims.
  • CI matrix (3.11/3.12/3.13) + clean-install packaging; docs/STABILITY.md contract; scheduled live drift-eval.
  • Install: pip install/uvx from git. PyPI publishing is wired into the release workflow — add a PYPI_API_TOKEN secret to enable it.

See CHANGELOG.md and docs/integration.md for full details.