Skip to content

chore: fix the tier glossary, and drop the py2mcp workaround - #14

Merged
thorwhalen merged 1 commit into
mainfrom
docs/tier-glossary
Sep 23, 2026
Merged

thorwhalen merged 1 commit into
mainfrom
docs/tier-glossary

Conversation

@thorwhalen

Copy link
Copy Markdown
Owner

Two follow-ups. No behaviour change in either.

The tier glossary was stale

tells.yaml still defined tiers as confidence that a model wrote it — E near-certain artifact of a model having written it. That stopped being true when the per-rule weight: was split out in #5. The two axes now mean different things:

  • tier — how firmly a rule is worth enforcing as writing advice. acquaint reads it and never reads weight.
  • weight — how much a hit is worth as evidence about who wrote the text. ductus reads it; acquaint never does.

Measuring 350 human-written documents falsified the old reading for several rules while leaving them worth fixing as advice, which is exactly why the axes were split rather than the rules demoted. The header now says that. Comments only.

This settles the open summary-closer question

It keeps tier E. I went in expecting to demote it — it trips 25 of 350 human documents and matched machine ground truth zero times, which makes "near-certain artifact" plainly false. But that argument rests on the stale definition. Once tier means "worth fixing whoever is reading", there is nothing to demote: as style advice, "In conclusion," is worth flagging even for a reader who tolerates AI-sounding prose. Its weight of 0.15 already carries the measured finding.

The contradiction was in the glossary, not in the rule.

The py2mcp workaround is gone

_resolve_annotations existed because fastmcp < 3.2 dropped every keyword-only default under from __future__ import annotations, which made every verb on the MCP surface uncallable. i2mint/py2mcp#14 pins fastmcp>=3.2,<4, so there is nothing left to work around.

The pin here moves to py2mcp>=0.1.12. The unit test that pinned the workaround goes with it; test_the_optional_arguments_really_are_optional stays, and it passing with the workaround removed is the evidence that removing it was safe rather than an assumption.

309 tests pass, ruff and mypy clean. acquaint's 555 also pass against the changed catalogue.

Two follow-ups from the surface work.

The catalogue header still defined tiers as confidence that a model wrote it
-- E as "near-certain artifact". That stopped being true when the per-rule
`weight:` was split out: tier is now how firmly a rule is worth enforcing as
writing advice (which `acquaint` reads), and weight is how much a hit is worth
as evidence about authorship (which `ductus` reads). Measurement against 350
human-written documents falsified the old reading for several rules while
leaving them worth fixing as advice, which is why the axes were split rather
than the rules demoted. Comments only; both suites unchanged.

That also settles the open question about `summary-closer`. It keeps tier E:
the case for demoting it rested on the stale definition, and once tier means
"worth fixing whoever is reading" there is nothing to demote. Its weight of
0.15 already carries the measured finding that it is near-worthless evidence.

`_resolve_annotations` is gone. py2mcp 0.1.12 requires fastmcp>=3.2, where
keyword-only defaults survive `from __future__ import annotations`, so the
workaround has nothing left to work around. The unit test that pinned it goes
with it; `test_the_optional_arguments_really_are_optional` stays and is the
real guard -- it passes with the workaround removed, which is the evidence that
removing it was safe.
@thorwhalen
thorwhalen merged commit 64854f1 into main Sep 23, 2026
12 checks passed
@thorwhalen
thorwhalen deleted the docs/tier-glossary branch September 23, 2026 15:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant