openwriter 0.35.1 → 0.35.2

package/dist/plugins/authors-voice/skill/catalog/author-hints.md

@@ -0,0 +1,119 @@
+# Author Hints
+
+> Curated list of authors with heavy training-data representation across registers.
+> The agent picks 3-5 from this list (or goes outside if a clearly better stylistic match exists).
+> Goal: high consistency, broad coverage of style modes.
+>
+> Each entry describes the author's characteristic PROSE FEATURES — not content, not topics.
+
+## Literary stylists — sentence as instrument
+
+- **Ernest Hemingway** — iceberg theory, short declarative, almost no adjectives, hard nouns and verbs
+- **Cormac McCarthy** — no commas in dialogue, long unpunctuated runs, biblical cadence
+- **Joan Didion** — measured precision, lists of three, the specific over the general
+- **David Foster Wallace** — maximalist sentences, footnote energy, recursive parentheticals, vocabulary
+- **Toni Morrison** — rhythmic repetition, sensory specificity, vernacular weaved with formal
+- **James Baldwin** — long balanced sentences, moral urgency in clause stacking, semicolons used as breath marks
+- **Annie Dillard** — observational compression, present-tense immediacy, sentence as image
+- **Marilynne Robinson** — theological cadence in plain words, long meditative sentences, Calvinist patience
+
+## Essayists / analytical
+
+- **Paul Graham** — thinking out loud, simple words, short sentences mixed with one long earned conclusion
+- **Patrick McKenzie** — long discursive sentences with parenthetical asides, domain-specific precision, dry humor
+- **Tim Urban** — extended metaphors, conversational asides, building up frameworks with named characters
+- **Scott Alexander** — rationalist sectioning, exhaustive enumeration of possibilities, fair-witness analysis
+- **Ben Thompson** — business-strategy decomposition, recurring framework names, lots of "this is why"
+- **Tyler Cowen** — compressed, list-heavy, blogger-shorthand, range of references in one paragraph
+- **Malcolm Gladwell** — narrative anchor → general principle → reversal, three-act essay structure
+- **Adam Grant** — research-anchored, paired contrasts, gentle prescriptive framing
+
+## Self-help / instructional / productivity
+
+- **Mark Manson** — period-heavy clean prose, "Your X is Y" definitional moves, profane confidence, direct second-person
+- **James Clear** — concept-coinage backbone, numbered enumeration, clean instructional cadence, named laws/frameworks
+- **Ryan Holiday** — Stoic-instructional, drawing concepts from antiquity, clean delivery, repetition for emphasis
+- **Tim Ferriss** — list-heavy, hack/protocol framing, second-person direct, capitalized concept names
+- **Cal Newport** — academic-instructional, named frameworks, research-backed prescriptions, sober register
+- **Greg McKeown** — one-idea-per-page rhythm, named principles, short paragraphs, prescriptive minimalism
+- **Brené Brown** — vulnerability-as-rhetoric, personal anecdotes anchoring research, conversational warmth
+- **Atomic Habits voice** — short-paragraph instruction, principle-then-example, mechanical-cause-and-effect language
+
+## Polemicists / contrarians / philosophical-provocative
+
+- **Nassim Nicholas Taleb** — concept-coinage (Black Swan, antifragile), aphoristic stabs, attacking IYI, ancient-thinker citations
+- **Jordan Peterson** — lecture cadence, biological-evolutionary framing, religious overlay, definitional pivots
+- **Bronze Age Pervert** — baroque Nietzschean, mock-archaic spelling, vitalist anti-modernity, ironic register
+- **Curtis Yarvin** — reactionary historical, concept-naming as branding, sneering wit, long allusive sentences
+- **Camille Paglia** — punchy contrarian, aesthetic-biological frame, dense allusion, no hedging
+- **Bryan Caplan** — libertarian-economic, direct refutation, hypothetical thought experiments, plain professorial prose
+
+## Tech / startup
+
+- **Naval Ravikant** — aphoristic, tweet-shaped, concept-as-brand, distilled-wisdom cadence
+- **Marc Andreessen** — manifesto-mode, accumulating short declarative lines, exhortation register
+- **Sam Altman** — short, contrarian, "obvious in hindsight" framing, blog-post brevity
+- **Peter Thiel** — paradox-as-thesis, philosophical-tech crossover, Strauss-influenced indirection
+- **Joel Spolsky** — conversational tech-blog, anecdote-then-principle, signposting humor
+- **Steve Yegge** — long discursive rants, programmer-culture inside jokes, accumulating digressions
+
+## Narrative non-fiction / journalism
+
+- **Michael Lewis** — character-first reporting, scene-as-argument, clean unobtrusive prose
+- **Sebastian Junger** — documentary precision, anthropological framing, present-tense narrative
+- **Jon Krakauer** — present-tense urgency, sensory immediacy, restraint in adjective use
+- **John McPhee** — list-as-paragraph, structural patterning, long sentences with specific detail
+- **Ta-Nehisi Coates** — meditative-historical, repetition as emphasis, address as form of argument
+- **Tom Wolfe** — New Journalism, exclamation, capitalization, italics for sound, voice-jumping
+- **Joan Didion (essays)** — see literary; her journalism has the same compressed precision
+
+## Memoirists / personal voice
+
+- **David Sedaris** — comic understatement, family scenes, deadpan one-liners as paragraph closers
+- **Anne Lamott** — confessional warmth, self-deprecating humor, sentence fragments for emphasis
+- **Anthony Bourdain** — profane confidence, food as window, baroque vocabulary mixed with kitchen-slang
+- **Rick Bragg** — Southern oral cadence, specific-detail compression, sentence rhythms from speech
+- **Mary Karr** — lyric memoir, line-break-tight sentences, Catholic-rural register
+
+## Aphorists / brief-form
+
+- **La Rochefoucauld** — epigrammatic, paired antithesis, cynical wit in one breath
+- **Friedrich Nietzsche** — aphoristic, hammer-blows of declaration, philosophical provocation
+- **E.M. Cioran** — pessimistic aphorism, paradoxical brevity, polished despair
+- **Eric Hoffer** — longshoreman intellectual, declarative wisdom, sociological observation
+
+## Academics-for-public
+
+- **Steven Pinker** — cognitive-science precision, numbered argument, defending Enlightenment, ironic asides
+- **Richard Dawkins** — precise zoological prose, metaphor as scaffolding, polemical clarity
+- **Robert Sapolsky** — neuroendocrine framing, dense citation, jokes nested in dense paragraphs
+- **Carl Sagan** — cosmic-scale lyric, science-as-wonder cadence, accessible majesty
+- **Daniel Kahneman** — System 1 / System 2 framing, dispassionate exposition, named cognitive biases
+- **Yuval Noah Harari** — sweeping historical synthesis, declarative simplification, "imagined orders" type concepts
+- **Jared Diamond** — continent-scale comparison, geographic-determinist framing, list of factors enumeration
+
+## Religious / philosophical (modern)
+
+- **C.S. Lewis** — clear analogical prose, common-sense apologetics, "imagine that" framing
+- **G.K. Chesterton** — paradox-as-rhetoric, joyful contrarian, accumulating images per sentence
+- **Thomas Merton** — contemplative prose, slow paragraphs, Catholic-Buddhist hybrid
+
+## Business / leadership
+
+- **Peter Drucker** — dry analytical, principle-then-example, professorial calm
+- **Andy Grove** — engineering-direct management, framework-naming, lean instructional
+- **Ben Horowitz** — war-stories anchored to lessons, hip-hop epigraphs, conversational toughness
+
+## Short-form / Twitter native
+
+- **Visakan Veerasamy** — thread-shaped, hyperlinked references, generous tone, recursive callbacks
+- **Hari Kondabolu / Twitter-essayist** — one-liner punch followed by longer unpacking, comic timing
+
+## Genre-specific (modern poetic / lyric prose)
+
+- **Ocean Vuong** — lyric memoir, line-conscious paragraphs, image-as-argument
+- **Maggie Nelson** — theory-personal hybrid, numbered fragments, citations interleaved
+
+## Reminder
+
+These style notes describe **prose features only**. When matching the user's corpus against an author from this list, cite the author's prose feature — not their content or topic. If you find yourself matching "the user writes about topic X therefore resembles author Y," stop and re-do the match. The correct framing is "the user uses period-heavy declarative cadence with definitional pivots, which matches Peterson's lecture-cadence prose pattern."

package/dist/plugins/authors-voice/skill/catalog/fingerprints.md

@@ -0,0 +1,175 @@
+# Fingerprints Catalog
+
+> Exact presentation choices the author makes consistently. LLMs default to training-data defaults for all of these unless explicitly told the user's choice. So we measure each one and emit a one-liner.
+> Use this when analyzing a user's corpus.
+
+## How to use this catalog
+
+For each fingerprint below:
+
+1. Read the user's corpus.
+2. Count the relevant variants.
+3. Apply the decision rule (mostly ≥3 total observations, then a ratio threshold).
+4. Emit a one-line fingerprint line if confidence ≥ medium. Skip if `n/a` (not enough signal).
+
+The output goes into `voice/fingerprints.md` as a bullet list, each line in the format `<Label>: <value>`.
+
+## Confidence rule (used by most binary fingerprints)
+
+Total observations = `a + b` where `a` is the count of one variant and `b` the other.
+
+- If total < 3 → **`n/a` (low confidence)**, skip emitting.
+- If `a / total ≥ 0.85` → **`a` wins, high confidence**, emit.
+- If `a / total ≤ 0.15` → **`b` wins, high confidence**, emit.
+- If `0.70 ≤ a / total < 0.85` → **`a` wins, medium confidence**, emit.
+- If `0.15 < a / total ≤ 0.30` → **`b` wins, medium confidence**, emit.
+- Otherwise (0.30 < ratio < 0.70) → **`mixed` (low confidence)**, emit as "inconsistent" only if the user explicitly wants to see mixed signals; otherwise skip.
+
+For the curious: this is asymmetric because we want either a clear choice (≥70%) or to skip. The 0.30-0.70 band is "the author isn't actually making a consistent choice" — emitting a fingerprint there would mislead.
+
+## The eight fingerprints
+
+### 1. Em-dash spacing
+
+What to measure:
+- `spaced` count = occurrences of `<whitespace>—<whitespace>` (e.g., `word — word`)
+- `unspaced` count = occurrences of `<non-whitespace>—<non-whitespace>` (e.g., `word—word`)
+
+Apply the binary confidence rule.
+
+Output map:
+- `spaced` → `Em-dash spacing: word — word`
+- `unspaced` → `Em-dash spacing: word—word`
+- `mixed` → `Em-dash spacing: inconsistent`
+
+Note: if the user is on a NEVER em-dashes rule (didn't clear the punctuation hurdle), skip this fingerprint entirely.
+
+### 2. Ellipsis style
+
+What to measure:
+- `three_dots` count = occurrences of `...` (three ASCII dots, not part of a longer run)
+- `unicode` count = occurrences of `…` (single Unicode character)
+- `spaced_dots` count = occurrences of `. . .` (dots separated by spaces)
+
+Decision:
+- If total < 3 → `n/a`, skip.
+- If max variant / total ≥ 0.85 → emit the winning style.
+- Otherwise → `mixed`.
+
+Output map:
+- `three_dots` → `Ellipsis style: ...`
+- `unicode` → `Ellipsis style: …`
+- `spaced_dots` → `Ellipsis style: . . .`
+- `mixed` → `Ellipsis style: inconsistent`
+
+### 3. Sentence-initial conjunction capitalization
+
+What to measure:
+- `caps` count = occurrences of `[.!?]<whitespace>(But|And|So|Or|Yet)\b` — i.e., starts a new sentence with capitalized conjunction
+- `lower` count = occurrences of `[.!?]<whitespace>(but|and|so|or|yet)\b` — same but lowercase (unusual, only if author uses a stylistic comma-after-period thing)
+
+Apply the binary confidence rule.
+
+Output map:
+- `caps` → `Sentence-initial "But/And/So": capitalized (". But")`
+- `lower` → `Sentence-initial "But/And/So": lowercase (", but")`
+- `mixed` → `Sentence-initial "But/And/So": inconsistent`
+
+### 4. Oxford comma
+
+What to measure (rough — accept some noise):
+- `withOxford` = sequences matching `<word>, <word>(...), and <word>` or `<word>, <word>(...), or <word>`
+- `withoutOxford` = sequences matching `<word>, <word>(...) and <word>` or `<word>, <word>(...) or <word>` (no comma before "and"/"or")
+
+Apply the binary confidence rule.
+
+Output map:
+- `yes` → `Oxford comma: yes`
+- `no` → `Oxford comma: no`
+- `mixed` → `Oxford comma: inconsistent`
+
+### 5. Quote style
+
+What to measure:
+- `straight` count = occurrences of `"`
+- `curly` count = occurrences of `"` or `"`
+
+Apply the binary confidence rule.
+
+Output map:
+- `straight` → `Quote style: straight "..."`
+- `curly` → `Quote style: curly "..."`
+- `mixed` → `Quote style: inconsistent`
+
+### 6. Capitalization after colon
+
+What to measure:
+- `upper` count = occurrences of `: <Uppercase letter>`
+- `lower` count = occurrences of `: <lowercase letter>`
+
+Apply the binary confidence rule. Require total ≥ 3.
+
+Output map:
+- `upper` → `Capitalization after colon: upper`
+- `lower` → `Capitalization after colon: lower`
+- `mixed` → `Capitalization after colon: inconsistent`
+
+### 7. Contractions
+
+What to measure:
+- `contracted` count = occurrences of `<word>'<s|re|ve|ll|d|t|m>` (e.g., `don't`, `I'm`, `we'll`)
+- `expanded` count = occurrences of the literal phrases `do not`, `does not`, `did not`, `is not`, `are not`, `was not`, `were not`, `cannot`, `will not`, `would not`, `should not`, `could not`, `have not`, `has not`, `had not`, `I am`, `you are`, `we are`, `they are`, `it is`, `that is`, `there is`, `let us`
+
+Apply the binary confidence rule.
+
+Output map:
+- `yes` → `Contractions: uses contractions`
+- `no` → `Contractions: avoids contractions`
+- `mixed` → `Contractions: mixed`
+
+### 8. Paragraph length
+
+What to measure:
+- Split the corpus on double-newlines (`\n\n+`) to get paragraphs.
+- For each paragraph, count sentences (split on `[.!?]<whitespace>`).
+- Compute the average sentences-per-paragraph.
+
+Require at least 3 paragraphs. Otherwise `n/a`, skip.
+
+Decision:
+- avg ≤ 2 → `short`, high confidence
+- 2 < avg ≤ 4 → `medium`, high confidence
+- avg ≥ 6 → `long`, high confidence
+- 4 < avg < 6 → `mixed`, medium confidence
+
+Output map:
+- `short` → `Paragraph length: 1–2 sentences`
+- `medium` → `Paragraph length: 3–4 sentences`
+- `long` → `Paragraph length: 5+ sentences`
+- `mixed` → `Paragraph length: varied`
+
+## Output structure
+
+The agent writes `voice/fingerprints.md` as:
+
+```markdown
+# Presentation Fingerprints
+
+> Auto-generated from `voice/corpus/`. Exact presentation choices the user makes consistently.
+> Match these in every generated response — LLMs default to training data otherwise.
+
+- Em-dash spacing: word — word
+- Oxford comma: yes
+- Quote style: straight "..."
+- Contractions: uses contractions
+- Paragraph length: 3–4 sentences
+
+## Manual Overrides
+
+<!-- Override any auto-detected fingerprint here. These win over the auto-detected ones above. -->
+<!-- Example: -->
+<!-- - Em-dash spacing: never use em-dashes at all. -->
+<!-- - Quote style: straight always. -->
+```
+
+The `## Manual Overrides` section MUST be preserved across regenerations.

package/dist/plugins/authors-voice/skill/catalog/hurdle.md

@@ -0,0 +1,76 @@
+# Authenticity Hurdle
+
+> The core decision rule: when does a pattern in the user's corpus count as "their voice" versus "AI contamination"?
+
+## The problem
+
+If we just emit NEVER rules for everything in the AI tells catalog, we'll strip out words the user actually likes and uses. Example: Mark Manson regularly uses "crucial" and "vital." Banning those flattens his voice.
+
+If we don't emit any rules unless the word appears zero times, we keep AI contamination. Example: an essay that the user originally drafted with ChatGPT help and then edited still contains stray "delves" and "valuable insights" — that's not their voice, that's leftover residue.
+
+The hurdle resolves this: a pattern is "authentic" only if it appears at signature frequency. Below that → contamination, ban it.
+
+## The thresholds
+
+| Category | Min count | Min rate per 1000 words | Why |
+|----------|-----------|-------------------------|-----|
+| `word` | 2 | 0.15 | Single words are noise-prone. Need at least 2 and a non-trivial rate. |
+| `transition` | 2 | 0.15 | Same as words. |
+| `phrase` | 2 | 0.05 | Phrases are more distinctive — a lower rate still signals deliberate use. |
+| `punctuation` | 15 | 1.5 | Punctuation is denser than diction. A few em-dashes is normal; signature use means many. |
+
+## The decision
+
+For each AI tell, given `count` (how many times it appears in the corpus) and `words` (total word count of the corpus):
+
+```
+rate_per_1k = (count / words) * 1000
+passes = count >= min_count AND rate_per_1k >= min_rate_per_1k
+```
+
+If `passes` → **preserve** (no NEVER rule). The user genuinely uses this.
+
+If not `passes` → **forbid** (emit NEVER rule). This includes:
+- Items that never appear (forbid because training data will push them back in)
+- Items that appear once or twice but below the rate threshold (forbid because it's likely contamination, not signature)
+
+## Worked examples
+
+**Word "delve" in a 2000-word corpus:**
+- count = 0 → fails (count < 2) → **forbid**: `NEVER "delve".`
+- count = 1 → fails (count < 2) → **forbid**: `NEVER "delve".` _(below hurdle — flagged in status.md as likely contamination)_
+- count = 2, rate = 1.0/1k → passes (count ≥ 2, rate ≥ 0.15) → **preserve**, no rule.
+
+**Em-dashes in a 5000-word corpus:**
+- count = 8, rate = 1.6/1k → fails (count < 15) → **forbid**: `NEVER "em-dashes".`
+- count = 20, rate = 4.0/1k → passes → **preserve**, no rule.
+
+The em-dash hurdle is intentionally hard. Most human writers don't clear it. The few who do (people with serious published-prose backgrounds) get to keep their em-dashes.
+
+## What this implies about tier progression
+
+The skill's tier system tracks corpus word count:
+- Tier 1 (300–1k words): too small to clear most hurdles. NEVER rules emit aggressively.
+- Tier 2 (1k–5k): some words start to pass. Most phrases still fail (they need ≥2 instances).
+- Tier 3 (5k–20k): phrases and many words can pass. Em-dash hurdle still hard.
+- Tier 4 (20k+): em-dash hurdle achievable. Profile is AV-grade.
+
+The hurdle stays the same across tiers. What changes is that more corpus means more chances for the user's signature patterns to clear it.
+
+## Status reporting
+
+For items that appear in the corpus but fail the hurdle (the "below_hurdle" set), flag them in `voice/status.md` under a "Below-Hurdle Detections" section. Format:
+
+```
+- `delve` — appears 1x, rate 0.5/1k
+- `however` — appears 1x, rate 0.5/1k
+```
+
+This is informational — the user can see what got flagged as contamination. It helps them notice "oh, I have a habit of letting AI drafts through" or alternatively "wait, I actually do use that word, let me add it to manual preserves."
+
+## Edge cases
+
+- **Count = 0**: always forbid. Don't list in below_hurdle (because it isn't "present in corpus").
+- **Tied counts in fingerprint binary**: if `a == b` (exactly equal), treat as `mixed`.
+- **Total < 3 in fingerprint**: skip entirely — not enough signal.
+- **Negative numbers, NaN, infinity**: shouldn't happen, but guard with `count = max(0, count)` if you implement defensively.

package/dist/plugins/authors-voice/skill/catalog/post-write-audit.md

@@ -0,0 +1,105 @@
+# Post-Write Audit
+
+> Distribution-level statistical checks the orchestrator runs against the minion's returned prose. Sits between step 6 (NEVER scan) and step 7 (integration) of the Apply Protocol. Catches statistical fingerprints the minion's prompt can't reasonably prevent without cognitively overloading the writing pass.
+
+## When this runs
+
+After step 6 (NEVER-violations scan + brief-error patching), before step 7 (integration). The orchestrator reads this file, applies each check to the minion's output, and surgically rewrites the smallest span that brings the failing metric back into range.
+
+## Why this layer exists
+
+The minion writes prose. The orchestrator polices distribution and lexicon. Anything mechanically detectable after the fact lives here, not in the writing-pass prompt — the minion's cognitive budget should go to channeling the anchor and hitting the commitments, not tracking 60 micro-bans.
+
+Two enforcement points still exist for the bans the minion DOES need to see (contrastive negation, sentence-opener repetition, em-dashes, etc.) — those live in `voice/never-rules.md` and get scanned at step 6. This audit is for the slop that's cheaper to scrub than to prevent.
+
+## Remediation principle
+
+For each failing check, rewrite the **smallest local span** that fixes the metric. Do not regenerate. Do not reach for stylistic improvement. The minion's voice IS the result — the audit only nudges the statistics.
+
+If a failing span is load-bearing (a specific image, a coined term, a structural beat the brief demanded), leave it. Audit findings are advisory at the boundary case. The minion's intent wins ties.
+
+Aim for the lightest touch: 5-10 small substitutions across a typical draft brings rates back in line. Heavier rewrites mean the audit is being misused.
+
+## Distribution checks
+
+### 1. Sentence-opener repetition
+
+**What to measure:** walk the output sentence by sentence. For each window of 3 consecutive sentences, check whether all three start with the same first word.
+
+**Threshold:** flag if >30% of windows trigger.
+
+**Why this number:** human writing sits at ~17% (DFT 2026 — mostly from intentional list structures like "How does X?... How does Y?... How does Z?"). SFT models at T=0.7 hit 53.3%. The 30% line cleanly separates human from AI.
+
+**Action:** locate the offending windows. For each, rewrite the second OR third sentence to start with a different word. If the window forms an intentional list, leave it — list structure is the human use case the 17% baseline reflects.
+
+### 2. Sentence-initial "The" frequency
+
+**What to measure:** percentage of sentences that begin with the word "The."
+
+**Threshold:** flag if >15% of all sentences.
+
+**Why this number:** "The" at sentence start is over-used by ~90% in SFT output vs human writing (DFT 2026, 14B SFT model). The +90% inflation puts AI rates well above the natural human range.
+
+**Action:** locate sentences starting with "The." Rewrite a portion to start with a different determiner ("A", "An", "These"), a pronoun, a prepositional phrase, or a different subject. Five to seven swaps across a typical paragraph is usually sufficient.
+
+### 3. Function-word over-use
+
+**What to read for:** the AI distribution-distance signal lives mostly in function words, not fancy diction. Top-10 tokens account for 87.2% of L2 distribution distance in SFT output (DFT 2026). Watch for:
+
+| Token | SFT inflation vs human |
+|---|---|
+| `is` | +44% |
+| `was` | +49% |
+| `are` | +31% |
+| `that` | +25% |
+| `a` | +15% |
+| `to` | +11% |
+| `.` (period) | +19% |
+
+**Heuristic check (no exact threshold):** scan the draft for clusters of short copular sentences ("X is Y. Z is W. P is Q.") and high period density (many short sentences in a row). Both are signatures of function-word inflation.
+
+**Action:** when noticed, merge two short copular sentences into one with a participial or relative clause; vary sentence structure to use action verbs instead of "is/was"; combine short sentences to drop period count. Three to five rewrites across a paragraph usually levels the distribution.
+
+### 4. Sentence-length variance
+
+**What to measure:** compute standard deviation of sentence length (in words) across the output. If the user has a `voice/stats.md`, compare to the user's own σ. Otherwise compare to baseline σ ≥ 8 words.
+
+**Threshold:** flag if σ < 6 words (low variance — uniform sentence length is an AI signature).
+
+**Action:** locate runs of similar-length sentences. Merge two short ones into a longer compound, or split a medium one. The goal is to restore length variance, not hit a specific number.
+
+## Lexical watch list
+
+Mechanical word-level scrubs. The minion doesn't see these — the audit handles them on the way out.
+
+### GPT-5 specific over-used tokens (DFT 2026)
+
+When the minion is a GPT-5-class model, these tokens are inflated vs human writing. Scan for them:
+
+| Token | Inflation vs human | Human baseline |
+|---|---|---|
+| `corridors` | +45.2% | 0.1% |
+| `norms` | +43.1% | 0.1% |
+| `align` / `aligns` / `alignment` | +36.0% | 0.2% |
+| `metrics` | +27.2% | 0.2% |
+| `engagement` | +26.5% | 0.2% |
+| `targeted` | +5.1% | 1.6% |
+| `identity` | +5.0% | 1.0% |
+| `trust` | +4.9% | 1.2% |
+
+**Action:** swap to a context-appropriate alternative when the word appears in surplus (3+ uses in a short piece, OR any use in a context where the word feels generic). If the user's corpus contains the word at signature frequency (in `voice/stats.md` or `voice/never-rules.md` exempts), leave it — they own that word.
+
+### Named-character defaults
+
+AI defaults to specific generated names in fiction. Known examples:
+
+- `Elara Voss` — documented in OpenAI's "goblin problem"
+- Add new defaults as documented.
+
+**Action:** if found in fiction output without explicit user specification, rename to something contextually appropriate or to a name the user has used in their corpus.
+
+## Source
+
+Distribution thresholds and over-use rates from "Fixing LLM Writing with Distribution Fine-Tuning," Rosmine 2026 (https://rosmine.ai/2026/05/18/fixing-llm-writing-with-distribution-fine-tuning/). Token over-use rates measured against 14B SFT vs human fineweb baseline. Sentence-opener repetition methodology: percent of texts containing 3+ consecutive sentences starting with the same first word.
+
+This file is a living checklist. New research that surfaces measurable thresholds for AI-vs-human writing belongs here, not in `voice/never-rules.md` — the writing pass stays lean.

package/dist/plugins/authors-voice/skill/docs/analysis.md

@@ -0,0 +1,31 @@
+# Analysis Protocol
+
+Regenerates the voice files from the corpus. Run any time the corpus changes (new samples added, samples removed, samples revised). Loaded only when triggered — not in context during normal writing sessions.
+
+## Protocol
+
+1. **Read inputs.** Concatenate every file in `voice/corpus/` (strip frontmatter). Count words. Read `catalog/ai-tells.md`, `catalog/fingerprints.md`, `catalog/hurdle.md`.
+
+2. **Compute deterministic tally** (best effort — counts may drift ±1 on long corpora):
+   - **Sentence distribution**: split on `[.!?]\s`, compute short/medium/long/very-long percentages, average length. Set `short_max` (25th-pct, clamped [6,12]) and `long_min` (75th-pct, clamped [18,28]). Do NOT emit a sentence-length cap in the apply directive — the corpus distribution carries the right ceiling and an arbitrary cap suppresses signature long sentences.
+   - **Punctuation density per 1k words** for em/en dash, colon, semicolon, question, exclamation, ellipsis, paren, bracket, straight/curly quotes. Categorize as `never` / `rare` / `low` / `strong`.
+   - **AI-tell tally**: count each item from `catalog/ai-tells.md`. Apply hurdle from `catalog/hurdle.md`: passes hurdle → preserve; fails → emit NEVER rule; below-hurdle but present → log to `below_hurdle`.
+   - **Fingerprints**: apply each detector from `catalog/fingerprints.md` with its decision rule.
+
+3. **Determine tier** by word count: <300 = 0 Empty; 300-999 = 1 Anchor; 1000-4999 = 2 Preliminary; 5000-19999 = 3 Full Coverage; ≥20000 = 4 AV-Grade. See `docs/tiers.md` for what unlocks at each tier.
+
+4. **Write `voice/stats.md`** — corpus stats, sentence distribution table, punctuation density table.
+
+5. **Write `voice/never-rules.md`** — preserve `## Manual Additions` section verbatim (anchored to start-of-line; the literal also appears in the intro blockquote — naive search will mis-grab it).
+
+6. **Write `voice/fingerprints.md`** — preserve `## Manual Overrides` section, same caution.
+
+7. **Write `voice/status.md`** — tier, words, active features, locked features, next milestone, file list, below-hurdle detections.
+
+8. **Report** — new tier, what changed in NEVER rules, what's locked next.
+
+For corpora >10k words, count in passes (words → phrases → transitions) rather than tracking 60 counters at once.
+
+## Adding Samples Later
+
+User says "add this to my voice profile" or pastes new writing. Append to next `voice/corpus/sample-NNN.md`, re-run Analysis Protocol, report tier change if any.