braidio.style

Style audit — flag the recycled rhetorical tics in commentary text.

The companion, in code, to misc/docs/style/anti-platitude-checklist.md: scan authored commentary for the empty structural platitudes a writing model falls back on, so a production can self-check (and measure) instead of eyeballing.

from braidio.style import audit_platitudes, platitude_rate findings = audit_platitudes(commentary_text) # [{pattern, match, start}, …] rate = platitude_rate(commentary_text) # flagged hits per 1000 words

Not every match is a crime — the guide says these moves are fine sparingly; the value is the RATE and which patterns dominate. Chiasmus (“the X that did Y is the X that does Z”) isn’t reliably regex-detectable and is intentionally omitted.

Module Attributes

PLATITUDE_PATTERNS	name → compiled pattern for the detectable overused moves.
TAG_RATE_FLOOR	Tags per 100 words.

Functions

audio_tag_rate(text, *[, per])	Inline audio tags per per words — the expressiveness dial.
audio_tags(text)	Every inline [audio tag] in text, in order.
audit_expressiveness(text)	Human-readable complaints about a script's written-in performance.
audit_platitudes(text)	Return every Finding in text, in document order.
platitude_rate(text, *[, per])	Flagged hits per per words (default 1000).

Classes

Finding(pattern, match, start)

One flagged platitude.

class braidio.style.Finding(pattern, match, start)

Bases: object

One flagged platitude.

braidio.style.PLATITUDE_PATTERNS: dict[str, Pattern] = {'director-cue': re.compile('\\b(?:listen to|notice|watch|catch)\\s+(?:how|what|the)\\b', re.IGNORECASE), 'heres-the': re.compile("\\bhere'?s the\\b", re.IGNORECASE), 'machinery-naming': re.compile('\\bthe (?:turn|tell|button|trick|move|thesis)\\b', re.IGNORECASE), 'negation-just': re.compile("\\bisn'?t just\\b", re.IGNORECASE), 'reduction': re.compile("\\b(?:that'?s the whole|the whole \\w+ in|in (?:two|three|four|five|six|seven|eight|nine|ten|\\d+) words)\\b", re.IGNORECASE)}

name → compiled pattern for the detectable overused moves.

braidio.style.TAG_RATE_FLOOR = 1.5

Tags per 100 words. Below the floor a v3 read goes flat; above the ceiling it starts performing every clause and reads as camp. Derived from the measured table above plus the “kitsch” complaint on a real episode.

braidio.style.audio_tag_rate(text, *, per=100)

Inline audio tags per per words — the expressiveness dial.

Only meaningful on a delivery whose model renders tags at all (braidio.delivery.Delivery.supports_audio_tags); on eleven_multilingual_v2 the tags are inert text and this number is a lie.

Return type:

float

braidio.style.audio_tags(text)

Every inline [audio tag] in text, in order.

Return type:

list[str]

braidio.style.audit_expressiveness(text)

Human-readable complaints about a script’s written-in performance.

Returns an empty list when the script sits in the target band. This is the gate audit_platitudes() is not: platitudes catch recycled phrases, this catches a script that will be read flatly however good the words are.

Return type:

list[str]

braidio.style.audit_platitudes(text)

Return every Finding in text, in document order.

Return type:

list[Finding]

braidio.style.platitude_rate(text, *, per=1000)

Flagged hits per per words (default 1000). 0.0 for empty text.

Return type:

float