# grai: Full Technical Specification & Empirical Voice Architecture (v3.3.0) > The gatekeeper and proof engine for human voice. Input raw text, get a binary PASS or FAIL on eight mechanical rules plus the CV floor, and output clean text with an ECDSA signed audit card. Built by Adrian M. Peticila (`https://peticila.ro/#person`, Wikidata `Q140362129`, ORCID `0009-0005-9601-9527`). --- ## 1. Product Thesis: Why Banned-Word Lists Stopped Working Across 3.5 years of continuous publication, grai audited 134,522 organic LinkedIn posts across 1,499 verified founder profiles (LigoSocial dataset: continuous publishing over 3.5 years, minimum 2,000 followers, primary language English). | Metric | Q1 2023 | Q3 2026 | Observed Delta | |---|---:|---:|---:| | Opening Formula ("Here is why" / "The truth is") | 1.3% | 9.6% | +7.4x | | Forced Opposition ("Not X, but Y") | 1.2% | 5.9% | +4.9x | | Arrow & Emoji Bullet Cascades (`->`, `=>`, emoji bullets) | 0.6% | 12.3% | +20.5x | | Mocked Lexical Clichés | 4.2% | 0.5% | -88.1% | | Mean Sentence Burstiness (`CV = sigma / mu`) | 0.48 | 0.23 | -52.1% | Authors deleted the vocabulary everyone mocked and kept the syntactic rhythm that gives a language model away. Prompting an LLM to "sound human" fails because the model averages its training distribution. grai solves this using the **Harness over Fine-Tuning** architecture (aligned with Google Research Harness2): model weights remain frozen, while a deterministic local harness enforces quantitative cadence rules outside the model. --- ## 2. The Deterministic Signal Chain (Three Rooms) ### 01 CADENCE GATE (Deterministic Browser Engine) Runs locally in JavaScript in your browser. Every draft is stripped of invisible zero-width watermarks (`U+200B` through `U+200D`, `U+FEFF`) and scored from 4 to 100 against eight structural rule families plus a mathematical rhythm floor. `SMOOTH_BRIDGE` is a secondary check inside the cadence family, and `FLAT_BURSTINESS` is the floor: 1. `CONTRASTIVE_NEGATION` (First hit: -14 pts, Repeat: -8 pts): Catches synthetic antithesis formulas where a sentence negates a strawman before stating the point. 2. `LESS_MORE_SYMMETRY` (First hit: -10 pts, Repeat: -6 pts): Catches corporate symmetry cliches (`"Less X, more Y"`, `"Stop doing X. Start doing Y."`). 3. `EPIPHANY_OPENER` (First hit: -10 pts, Repeat: -7 pts): Catches throat-clearing hooks (`"Here is why"`, `"Here's why"`, `"The harsh truth is"`, `"Let that sink in"`, `"Read that again"`, `"Unpopular opinion:"`, `"Most people think X. They're wrong"`). 4. `ARROW_BULLET_SLOP` (First hit: -12 pts, Repeat: -4 pts): Catches template arrow cascades (`->`, `=>`, `1/`, arrow and emoji bullets) with full UTF-16 astral plane awareness (`/u`). 5. `TRIADIC_PADDING` (First hit: -12 pts, Repeat: -8 pts): Catches empty slogan triads (`"No fluff. No theory. Just results."`). 6. `LEXICAL_SLOP` (First hit: -6 pts, Repeat: -5 pts): Catches remaining synthetic vocabulary tells (`fast-paced world`, `ever-evolving`, `symphony of`, `navigating the complexities`, `paradigm shift`), with negative lookahead protecting legitimate domain nouns. 7. `VERDICT_COLON` (First hit: -8 pts, Repeat: -4 pts): Catches pompous summary colons (`"The reality is:"`, `"The takeaway:"`, `"The truth is:"`). 8. `PROSE_TRIAD` (First hit: -10 pts, Repeat: -5 pts): Catches rhetorical triplets in prose (three consecutive questions or triadic parallel noun/verb chains). 9. `SMOOTH_BRIDGE` (Trigger: >=3 consecutive or >=4 total; -12 pts base + -6 pts per excess): Catches chained explanatory transitions (`"that's why"`, `"in other words"`, `"this means that"`). 10. `FLAT_BURSTINESS` (Penalty: `round((0.32 - CV) * 65)` when `CV < 0.32`): Sentence tokenization protects decimals (`3.14`, `$1.5M`) and abbreviations (`Dr.`, `U.S.`, `e.g.`), then computes the Coefficient of Variation `CV = sigma / mu` across sentence word lengths. grai checks drafts against a burstiness floor at `CV = 0.32`. The gate highlights matching spans in the editor (``), displays the live score and `CV` in the HUD, and offers 1-click surgical span repair (`buildSurgicalTargets` & `applySurgicalReplacements`) while leaving the final decision to edit or copy (`#wbCopy`) with the user. This is a style gate, not an authorship detector. ### 02 THE WRITING DESK (3-Column Workbench & Backdrop Overlay Editor) - **Left Column (Client Drawer):** Multi-client voice switcher, voice targets, 1-click `.grai` profile backup and restore, and A4 certificate print trigger (`#xCert`). - **Center Column (Editor & Three Galleys):** - Premise Sparring challenges safe or unanchored ideas (`CLICHE_OR_SAFE`, `SOLID_BUT_UNANCHORED`) with three exit paths: `COUNTER_PUNCH`, `ADOPT_ANGLE`, or `BYPASS`. - Generates three distinct structural galleys simultaneously: 1. **THE SCALPEL:** Short hook, compressed argument, high impact. 2. **THE BROADSHEET:** Narrative arc, concrete scene first, lesson last. 3. **THE LEDGER:** Empirical evidence and hard numbers first, backed by a full audit trail. - Native `