@roughen/core 0.3.0

package/dist/editorial.js

@@ -0,0 +1,252 @@
+import { baselines } from './baselines.js';
+/**
+ * Density detectors for structural habits. One instance is ordinary writing;
+ * the tell is repetition above what human documents do. Patterns run over the
+ * parser's masked prose view, so code, quotations and syntax are already blank.
+ * Single source of truth for both the rules below and the baseline research script.
+ */
+const A = "['’]";
+const family = {
+    contrast: new RegExp([
+        `,\\s+not\\s+(?:a|an|the|just|only|because|by|for|from|to|in|on|about|as|what|how|who|your|their|our|more|less|every|all)\\b`,
+        `\\b(?:isn${A}t|is not|aren${A}t|are not|wasn${A}t|doesn${A}t|don${A}t|won${A}t)\\b[^.!?\\n]{0,80}[.;]\\s+(?:it${A}s|they${A}re|that${A}s|it is|this is|you${A}re)\\b`,
+        `\\b(?:it${A}s|this is|that${A}s|it is)\\s+not\\s+(?:just|only|merely|simply)\\b`,
+        `\\bnot\\s+only\\b[^.!?\\n]{1,80}\\bbut\\b`,
+    ].join('|'), 'giu'),
+    reveal: new RegExp([
+        `(?<![\\p{L}\\p{N}])the\\s+(?:real|key|biggest|main|hard|simple|honest|short)\\s+(?:question|issue|problem|difference|mistake|reason|risk|thing|answer|lesson|test|tradeoff|trade-off|point)\\b`,
+        `\\bthe\\s+(?:difference|catch|reality|truth|trick|takeaway)\\s+is\\b`,
+        `\\bhere${A}s\\s+(?:the thing|the kicker|the catch|the truth|what (?:matters|that means|you need to know))\\b`,
+        `,\\s+which\\s+is\\s+why\\b`,
+        `\\bin\\s+other\\s+words\\b`,
+        `\\blet${A}s\\s+(?:dive|delve|unpack|break (?:it|this|that) down)\\b`,
+    ].join('|'), 'giu'),
+    generalizer: /\b(?:usually|often|typically|generally|in most cases|most of the time|tends? to|commonly|frequently)\b/giu,
+    emDash: /—/gu,
+    semicolon: /;/gu,
+    // A second item opening with a function word is a clause ("development, on its own budget and…"), not an item.
+    series: /(?<![\p{L}\p{N}])[\p{L}\p{N}$’'-]+(?:\s[\p{L}\p{N}$’'-]+){0,3},\s+(?!(?:on|in|at|for|to|with|by|from|of|as|so|but|and|or|nor|yet|because|when|while|if|though|although|which|who|whom|whose|that|this|these|those|it|its|we|you|they|he|she|i|there|then|than|not)\b)[\p{L}\p{N}$’'-]+(?:\s[\p{L}\p{N}$’'-]+){0,3},?\s+(?:and|or)\s+[\p{L}\p{N}$’'-]+/giu,
+};
+/**
+ * Editable body prose: paragraphs and list items. Headings are deliberate
+ * (question headings match search queries), so they're never measured.
+ * Single source of truth for what the density rules and their baselines count.
+ */
+export function bodyBlocks(document) {
+    return document.blocks.filter((block) => !block.skip && (block.kind === 'paragraph' || block.kind === 'listItem'));
+}
+/** Words are the body sentences' word counts, the same measure the metrics report. */
+export function densityProfile(document, sentences) {
+    const instances = { series: [], contrast: [], generalizer: [], reveal: [], emDash: [], semicolon: [] };
+    for (const block of bodyBlocks(document)) {
+        for (const name of Object.keys(family)) {
+            // A bulleted item is already a structured inventory: where the series rule says lists belong.
+            if (name === 'series' && block.kind === 'listItem')
+                continue;
+            for (const match of block.text.matchAll(family[name])) {
+                const start = block.sourceRange[0] + match.index;
+                instances[name].push([start, start + match[0].length]);
+            }
+        }
+    }
+    return { words: sentences.reduce((sum, sentence) => sum + sentence.wordCount, 0), instances };
+}
+const describe = {
+    contrast: {
+        id: 'structure/contrast-frame', severity: 'warn', label: 'contrast frames ("X, not Y", "isn\'t X. It\'s Y")',
+        why: 'Setting every point against a straw alternative makes each sentence sound like a correction. Repeated, it reads as a formula rather than an argument.',
+        advice: 'State the point directly. Keep a contrast only where the reader genuinely holds the mistaken view.',
+    },
+    reveal: {
+        id: 'structure/reveal-frame', severity: 'info', label: 'reveal frames ("The real question is…", ", which is why")',
+        why: 'Announcing that the key point is coming delays the point. Repeated, the announcements become the voice.',
+        advice: 'Delete the announcement and lead with the claim itself.',
+    },
+    generalizer: {
+        id: 'hedge/generalizer', severity: 'warn', label: 'generalizing hedges (usually, often, typically)',
+        why: 'Qualifying most claims with "usually" or "typically" makes the writing sound unsure of its own experience and hides the specifics readers came for.',
+        advice: 'Replace the hedge with the actual condition, number or example. Keep it only where the exception matters.',
+    },
+    emDash: {
+        id: 'punctuation/em-dash', severity: 'warn', label: 'em dashes',
+        why: "Em dashes are a good tool, and plenty of human writers use them. When they carry most of a piece's asides and pivots, though, they become its rhythm, and readers notice the tic.",
+        advice: 'Keep the ones that mark a real interruption. Turn the rest into commas, parentheses, a colon, or two sentences.',
+    },
+    semicolon: {
+        id: 'punctuation/semicolon', severity: 'warn', label: 'semicolons',
+        why: 'Semicolons join clauses into long, formal sentences. In copy read on a screen they slow the reader down and sound academic.',
+        advice: 'Split the clauses into two sentences, or join them with a comma and "and", "but" or "so".',
+    },
+    series: {
+        id: 'structure/list-saturation', severity: 'warn', label: 'comma series ("A, B, and C")',
+        why: 'When most sentences enumerate three or more items, prose turns into inventory. Readers skim lists and remember none of the items.',
+        advice: 'Pick the one or two items that matter for this sentence and say something specific about them. Move genuine inventories into a bulleted list.',
+    },
+};
+/** Rule id for each density family, for callers that measure instances with profileText. */
+export const densityRuleIds = Object.fromEntries(Object.entries(describe).map(([name, meta]) => [name, meta.id]));
+/** Shorter bodies are too small to measure a rate. */
+export const densityMinimumWords = 300;
+/** One or two instances are ordinary writing whatever the rate; repetition is the tell. */
+export const densityMinimumInstances = 3;
+/**
+ * The human baseline a density family is measured against in a register:
+ * the register's own threshold where one was fit, otherwise the article one.
+ */
+export function densityBaseline(name, register = 'article') {
+    if (register !== 'article') {
+        const fitted = baselines.registers[register];
+        const override = fitted.density[name];
+        if (override)
+            return { p95: override.p95, documents: fitted.corpus.measured, register };
+    }
+    return { p95: baselines.density[name].p95, documents: baselines.corpus.documents, register: 'article' };
+}
+/**
+ * Single source of truth for when a density rule fires, used by the rules and
+ * by the baseline report so the published exceedance matches what ships.
+ */
+export function densityVerdict(profile, name, register = 'article') {
+    const count = profile.instances[name].length;
+    const per1k = profile.words ? (count / profile.words) * 1000 : 0;
+    const threshold = densityBaseline(name, register).p95;
+    const fires = profile.words >= densityMinimumWords && count >= densityMinimumInstances && per1k > threshold;
+    // Rewriting down to the baseline rate, but never below the instance floor, clears the finding.
+    const allowed = Math.max(densityMinimumInstances - 1, Math.floor((threshold * profile.words) / 1000));
+    return { count, per1k, threshold, fires, rewriteAtLeast: Math.max(0, count - allowed) };
+}
+// A banned character is reported at every occurrence, so its density rule would only repeat the ban.
+const familyCharacter = { emDash: '—', semicolon: ';' };
+/** Characters the project bans outright, normalized from the voice config. Single source of truth for the ban rule and the density rules it supersedes. */
+export function bannedCharacters(config) {
+    return (config.voice?.bannedCharacters ?? []).map((entry) => typeof entry === 'string' ? { character: entry } : entry).filter((entry) => entry.character.length > 0);
+}
+function densityRule(name) {
+    const meta = describe[name];
+    return {
+        id: meta.id,
+        severity: meta.severity,
+        description: `Flag ${meta.label} above the human-writing baseline.`,
+        check({ profile, config, register }) {
+            const character = familyCharacter[name];
+            if (character && bannedCharacters(config).some((entry) => entry.character === character))
+                return [];
+            const verdict = densityVerdict(profile, name, register);
+            if (!verdict.fires)
+                return [];
+            const found = profile.instances[name];
+            const per1k = verdict.per1k;
+            const baseline = densityBaseline(name, register);
+            const population = baseline.register === 'marketing' ? `human marketing pages in Roughen's marketing baseline` : `human documents in Roughen's baseline`;
+            return found.map((range) => ({
+                range,
+                message: `One of ${found.length} ${meta.label} (${per1k.toFixed(1)} per 1,000 words).`,
+                why: `${meta.why} ${baseline.p95 ? `${population[0].toUpperCase()}${population.slice(1)} stay at or below ${baseline.p95.toFixed(1)} per 1,000 words` : `Most ${population} use none`} (95th percentile, ${baseline.documents} ${baseline.register === 'marketing' ? 'pages' : 'documents'}). ${meta.advice}`,
+                fixSafety: 'manual',
+                confidence: baseline.p95 ? Math.min(1, 0.5 + (per1k - baseline.p95) / (2 * baseline.p95)) : 0.75,
+                evidence: { count: found.length, per1k: Number(per1k.toFixed(2)), baselineP95: baseline.p95, rewriteAtLeast: verdict.rewriteAtLeast, words: profile.words, ...(baseline.register === 'article' ? {} : { register: baseline.register }) },
+            }));
+        },
+    };
+}
+/** Longest run of consecutive sentences within ±25% of the run's mean: the metronome. */
+function uniformRun(lengths) {
+    let best = [0, 0];
+    for (let i = 0; i < lengths.length; i++) {
+        if (lengths.length - 1 - i <= best[1] - best[0])
+            break; // no longer run can start here
+        let lo = lengths[i];
+        let hi = lengths[i];
+        for (let j = i + 1; j < lengths.length; j++) {
+            lo = Math.min(lo, lengths[j]);
+            hi = Math.max(hi, lengths[j]);
+            const mean = (lo + hi) / 2;
+            if (hi - mean > 0.25 * mean)
+                break;
+            if (j - i > best[1] - best[0])
+                best = [i, j];
+        }
+    }
+    return best;
+}
+const lowVariance = {
+    id: 'rhythm/low-variance',
+    severity: 'info',
+    description: 'Flag sentence lengths that vary less than human writing does.',
+    check({ sentences }) {
+        const lengths = sentences.map((sentence) => sentence.wordCount);
+        if (lengths.length < 8)
+            return [];
+        const mean = lengths.reduce((sum, value) => sum + value, 0) / lengths.length;
+        const cv = Math.sqrt(lengths.reduce((sum, value) => sum + (value - mean) ** 2, 0) / lengths.length) / mean;
+        const threshold = baselines.rhythm.cvP5;
+        if (cv >= threshold)
+            return [];
+        const [first, last] = uniformRun(lengths);
+        const range = [sentences[first].range[0], sentences[last].range[1]];
+        return [{
+                range,
+                message: `Sentence lengths barely vary (coefficient of variation ${cv.toFixed(2)}).`,
+                why: `Sentences ${first + 1} through ${last + 1} run ${Math.min(...lengths.slice(first, last + 1))} to ${Math.max(...lengths.slice(first, last + 1))} words each. Human documents in Roughen's baseline vary more than ${threshold.toFixed(2)} in 95% of cases, and the evenness reads as a metronome. Combine two short related sentences, or break a long one where the thought turns.`,
+                fixSafety: 'manual', confidence: Math.min(1, 0.5 + (threshold - cv) / threshold),
+                evidence: { cv: Number(cv.toFixed(3)), baselineP5: threshold, sentences: lengths.length, meanWords: Number(mean.toFixed(1)) },
+            }];
+    },
+};
+/** Sentences longer than 90% of human sentences, the ones a split helps most. */
+export function longSentences(sentences) {
+    return sentences.filter((sentence) => sentence.wordCount > baselines.sentences.longWords);
+}
+/** Single source of truth for when the long-sentence rule fires, shared with the baseline report. */
+export function longSentenceVerdict(words, sentences) {
+    const { meanWordsP95 } = baselines.sentences;
+    const long = longSentences(sentences);
+    const mean = sentences.length ? words / sentences.length : 0;
+    const fires = words >= densityMinimumWords && sentences.length >= 8 && mean > meanWordsP95 && long.length >= densityMinimumInstances;
+    // Splitting a sentence adds one; this many splits brings the mean back to the baseline.
+    const rewriteAtLeast = Math.min(long.length, Math.max(1, Math.ceil(words / meanWordsP95 - sentences.length)));
+    return { mean, long, fires, rewriteAtLeast };
+}
+const longSentenceRule = {
+    id: 'rhythm/long-sentences',
+    severity: 'warn',
+    description: 'Flag documents whose sentences run longer than human writing does.',
+    check({ sentences, profile }) {
+        const { mean, long, fires, rewriteAtLeast } = longSentenceVerdict(profile.words, sentences);
+        if (!fires)
+            return [];
+        const { meanWordsP95, longWords } = baselines.sentences;
+        return long.map((sentence) => ({
+            range: sentence.range,
+            message: `One of ${long.length} long sentences (${sentence.wordCount} words; this document averages ${mean.toFixed(1)}).`,
+            why: `Long sentences make readers hold several ideas at once. Human documents in Roughen's baseline average ${meanWordsP95.toFixed(1)} words a sentence or fewer (95th percentile, ${baselines.corpus.documents} documents), and only 1 human sentence in 10 runs past ${longWords} words. Split this one where the thought turns.`,
+            fixSafety: 'manual', confidence: Math.min(1, 0.5 + (mean - meanWordsP95) / meanWordsP95),
+            evidence: { count: long.length, meanWords: Number(mean.toFixed(1)), baselineMeanP95: meanWordsP95, longWords, words: sentence.wordCount, rewriteAtLeast },
+        }));
+    },
+};
+/**
+ * Instances of the given rules' habits in a text, whether or not they fire.
+ * Single source of truth for "did a rewrite reduce what was flagged", used by
+ * Signal's revision gate and anything else that compares a before and after.
+ */
+export function flaggedInstances(profile, sentences, ruleIds) {
+    let total = 0;
+    for (const [name, meta] of Object.entries(describe))
+        if (ruleIds.includes(meta.id))
+            total += profile.instances[name].length;
+    if (ruleIds.includes('rhythm/long-sentences'))
+        total += longSentences(sentences).length;
+    return total;
+}
+export const editorialRules = [
+    densityRule('series'),
+    densityRule('contrast'),
+    densityRule('generalizer'),
+    densityRule('reveal'),
+    densityRule('emDash'),
+    densityRule('semicolon'),
+    longSentenceRule,
+    lowVariance,
+];
+//# sourceMappingURL=editorial.js.map

package/dist/editorial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorial.js","sourceRoot":"","sources":["../src/editorial.ts"],"names":[],"mappings":"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"}

package/dist/fixes.d.ts

@@ -0,0 +1,8 @@
+import type { Finding } from './types.js';
+export interface FixOptions {
+    careful?: boolean;
+}
+/** Single source of truth for fix safety and overlap selection on every surface. */
+export declare function selectFixes(source: string, findings: readonly Finding[], options?: FixOptions): Finding[];
+/** Splices original-source ranges in one pass; never rewrites a parsed document. */
+export declare function applyFixes(source: string, findings: readonly Finding[], options?: FixOptions): string;

package/dist/fixes.js

@@ -0,0 +1,53 @@
+import { rules } from './rules.js';
+import { firstEndingAfter, fixRangesConflict } from './ranges.js';
+const fixRange = (finding) => finding.fix.range;
+function validRange(range, length) {
+    return Number.isInteger(range[0]) && Number.isInteger(range[1]) &&
+        range[0] >= 0 && range[0] <= range[1] && range[1] <= length;
+}
+/** Single source of truth for fix safety and overlap selection on every surface. */
+export function selectFixes(source, findings, options = {}) {
+    const rulePriority = new Map(rules.map((rule, index) => [rule.id, index]));
+    const candidates = findings.map((finding, index) => ({ finding, priority: rulePriority.get(finding.ruleId) ?? rules.length + index })).filter(({ finding }) => {
+        if (!finding.fix || finding.fixSafety === 'manual')
+            return false;
+        if (finding.fixSafety === 'careful' && !options.careful)
+            return false;
+        if (!validRange(finding.fix.range, source.length))
+            throw new RangeError(`Invalid fix range for ${finding.ruleId}`);
+        if (!Number.isFinite(finding.confidence) || finding.confidence < 0 || finding.confidence > 1) {
+            throw new RangeError(`Invalid fix confidence for ${finding.ruleId}`);
+        }
+        return source.slice(...finding.fix.range) !== finding.fix.text;
+    });
+    candidates.sort((a, b) => b.finding.confidence - a.finding.confidence || a.priority - b.priority);
+    // Selections never conflict, so ordered by start they are ordered by end too:
+    // a candidate can only conflict with the selections around its own position.
+    const selected = [];
+    for (const { finding } of candidates) {
+        const range = fixRange(finding);
+        let index = firstEndingAfter(selected, range[0] - 1, fixRange);
+        let conflict = false;
+        for (let i = index; !conflict && i < selected.length && fixRange(selected[i])[0] <= range[1]; i++) {
+            conflict = fixRangesConflict(fixRange(selected[i]), range);
+        }
+        if (conflict)
+            continue;
+        while (index < selected.length && fixRange(selected[index])[0] < range[0])
+            index++;
+        selected.splice(index, 0, finding);
+    }
+    return selected;
+}
+/** Splices original-source ranges in one pass; never rewrites a parsed document. */
+export function applyFixes(source, findings, options = {}) {
+    const parts = [];
+    let last = 0;
+    for (const { fix } of selectFixes(source, findings, options)) {
+        parts.push(source.slice(last, fix.range[0]), fix.text);
+        last = fix.range[1];
+    }
+    parts.push(source.slice(last));
+    return parts.join('');
+}
+//# sourceMappingURL=fixes.js.map

package/dist/fixes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixes.js","sourceRoot":"","sources":["../src/fixes.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+import { parseDocument } from './document.js';
+import { segmentSentences } from './sentences.js';
+import { applyFixes } from './fixes.js';
+export { bodyBlocks, densityBaseline, densityMinimumWords, densityMinimumInstances, densityVerdict, densityRuleIds, longSentenceVerdict } from './editorial.js';
+import type { Config, Finding, Metrics, Register, Result, Sentence, Severity } from './types.js';
+export { parseDocument, segmentSentences, applyFixes };
+export { collectMarkdownLinkTargets } from './document.js';
+export { revisionBrief, scopeFindings } from './brief.js';
+export type { BriefItem, BriefOptions, RevisionBrief } from './brief.js';
+export { comparePreservation, revisionLengthTolerance } from './preserve.js';
+import { type PreservationReport } from './preserve.js';
+export type { PreservationOptions, PreservationReport } from './preserve.js';
+export { baselines } from './baselines.js';
+export type { FixOptions } from './fixes.js';
+export type * from './types.js';
+export declare const version = "0.3.0";
+/** Rule descriptions only. Consumers cannot mutate the engine's registry. */
+export declare function listRules(): {
+    id: string;
+    severity: Severity;
+    description: string;
+}[];
+/** Profile of a text as Roughen measures it: body words and density-rule instances. For baselines and reports. */
+export declare function profileText(source: string, format?: Config['format']): {
+    sentences: Sentence[];
+    metrics: Metrics;
+    words: number;
+    instances: Record<import("./types.js").DensityFamily, import("./types.js").Range[]>;
+};
+/** Occurrences of what the project bans outright (voice.bannedCharacters, voice.bannedPatterns). */
+export declare function countBanned(source: string, voice: Config['voice'], format?: Config['format']): number;
+/**
+ * How many instances of the given rules' habits `source` contains, whether or
+ * not the rules fire. Banned characters and patterns count when `voice` names them.
+ */
+export declare function countFlagged(source: string, ruleIds: readonly string[], format?: Config['format'], voice?: Config['voice']): number;
+/** Runs locally and deterministically. No network, model, locale, clock, or randomness. */
+export declare function lint(source: string, config?: Config | null): Result;
+export interface JudgeOptions {
+    format?: Config['format'];
+    /** Rules whose instances must decrease. Default: the rules that asked for a rewrite of the original. */
+    rules?: readonly string[];
+    /** The baseline those default rules are judged against. */
+    register?: Register;
+    /** Banned characters and patterns: a revision may not add any. */
+    voice?: Config['voice'];
+    /** Allowed body-length change, as a fraction. Default revisionLengthTolerance. */
+    lengthTolerance?: number;
+}
+export interface RevisionJudgment {
+    /** Use the revision: it kept every fact and reduced the flagged habits. */
+    accepted: boolean;
+    rules: string[];
+    flaggedBefore: number;
+    flaggedAfter: number;
+    /** Banned characters and patterns in each version (zero when the voice bans nothing). */
+    bannedBefore: number;
+    bannedAfter: number;
+    reasons: string[];
+    preservation: PreservationReport;
+}
+/** A finding that asks for a rewrite: manual, warn or error, with a rewrite target. Info findings stay in the review. */
+export declare function isRevisable(finding: Finding): boolean;
+/** Rules whose findings ask for a rewrite. */
+export declare function revisableRules(result: Pick<Result, 'findings'>): string[];
+/**
+ * Single source of truth for whether a rewrite should replace the original,
+ * used by Signal's revision gate and the MCP server. The revision must keep
+ * every figure, link, code sample, quotation and heading, add none, stay in
+ * length bounds, and reduce the flagged habits. `rules` defaults to the rules
+ * that asked for a rewrite of the original.
+ */
+export declare function judgeRevision(original: string, revised: string, options?: JudgeOptions): RevisionJudgment;