ig-human

1# ig-human
2 
3Two tools live in this folder and they both actually run. Use them. Do not
4eyeball this.
5 
6```bash
7python3 humanize.py draft.txt --report        # clean it, show what changed
8python3 detect.py draft.txt                    # score it, five checks
9python3 detect.py before.txt after.txt         # prove the delta
10```
11 
12Both read `slop.json`: 154 stock words and phrases with plain-English
13replacements, 18 invisible character classes, 11 typographic substitutions and
1416 structural tells. The last block of each list is Instagram-specific, the
15vocabulary that only shows up in captions and voiceovers. It is meant to be
16edited. If the user has a word they always use that the lexicon strips, take it
17out of the file.
18 
19## Why this matters more on Instagram than it looks
20 
21Captions are short and scripts get said out loud. A written-sounding line in a
22600-character caption is a larger share of the text than the same line in an
23essay, and a voiceover that nobody could say naturally is obvious in the first
24take. The tell here is not a detector flagging the post. The tell is a person
25scrolling past something that reads like a brand, or a creator stumbling over
26their own script.
27 
28## What gets fixed automatically
29 
30**1. Invisible characters.** Zero-width spaces and joiners, word joiners, soft
31hyphens, byte-order marks, Unicode tag characters, invisible separators,
32non-breaking and narrow spaces. A keyboard does not produce these. They survive
33…