opengrammar-server 2.0.644277

package/src/rules/ruleset-part1-cj-pu-sp.json

@@ -0,0 +1,657 @@
+{
+  "version": "1.0.0",
+  "generated_for": "OpenGrammar Engine",
+  "part": "1C_of_3",
+  "categories": [
+    {
+      "code": "CJ",
+      "name": "Conjunctions & Connectors",
+      "rules": [
+        {
+          "rule_id": "CJ_CRD_001",
+          "category": "Conjunctions & Connectors",
+          "subcategory": "Coordinating Conjunctions",
+          "title": "Missing comma before FANBOYS joining independent clauses",
+          "description": "When a coordinating conjunction (for, and, nor, but, or, yet, so) joins two independent clauses, a comma is needed before it.",
+          "severity": "warning",
+          "language_register": "both",
+          "pattern_description": "Detect two clauses (each with subject+verb) joined by FANBOYS without a preceding comma. Requires NLP clause boundary detection.",
+          "examples": {
+            "incorrect": [
+              "She likes coffee but he prefers tea.",
+              "I went to the store and I bought milk.",
+              "It was raining so we stayed inside."
+            ],
+            "correct": [
+              "She likes coffee, but he prefers tea.",
+              "I went to the store, and I bought milk.",
+              "It was raining, so we stayed inside."
+            ]
+          },
+          "exceptions": [
+            "Short closely related clauses: 'I came and I saw.' — comma optional.",
+            "When joining only subjects/objects: 'She likes coffee and tea.' — NO comma."
+          ],
+          "fix_hint": "Add a comma before the coordinating conjunction when joining two independent clauses.",
+          "british_variant": "No significant difference."
+        },
+        {
+          "rule_id": "CJ_RED_001",
+          "category": "Conjunctions & Connectors",
+          "subcategory": "Redundant Conjunctions",
+          "title": "'Although...but' redundancy",
+          "description": "Using both a subordinating conjunction and a coordinating conjunction for the same contrast is redundant.",
+          "severity": "warning",
+          "language_register": "both",
+          "pattern_description": "Regex: /\\b(although|though|even though)\\b[^.]*\\bbut\\b/i, /\\bbecause\\b[^.]*\\bso\\b/i, /\\b(despite|in spite of)\\b[^.]*\\bbut\\b/i",
+          "examples": {
+            "incorrect": [
+              "Although she was tired, but she kept working.",
+              "Because it was raining, so we stayed inside.",
+              "Despite the delay, but we arrived on time."
+            ],
+            "correct": [
+              "Although she was tired, she kept working.",
+              "Because it was raining, we stayed inside.",
+              "Despite the delay, we arrived on time."
+            ]
+          },
+          "exceptions": [],
+          "fix_hint": "Remove one of the two conjunctions — keep the subordinating one or the coordinating one, not both.",
+          "british_variant": "No significant difference."
+        },
+        {
+          "rule_id": "CJ_COR_001",
+          "category": "Conjunctions & Connectors",
+          "subcategory": "Correlative Conjunctions",
+          "title": "Correlative conjunction verb agreement",
+          "description": "With either...or, neither...nor, the verb agrees with the subject nearest to it.",
+          "severity": "error",
+          "language_register": "both",
+          "pattern_description": "Detect (neither|either) ... (nor|or) patterns and check verb agreement with nearest subject.",
+          "examples": {
+            "incorrect": [
+              "Neither the teacher nor the students was ready.",
+              "Either John or the boys has left.",
+              "Neither she nor I is going."
+            ],
+            "correct": [
+              "Neither the teacher nor the students were ready.",
+              "Either John or the boys have left.",
+              "Neither she nor I am going."
+            ]
+          },
+          "exceptions": [],
+          "fix_hint": "Make the verb agree with the subject nearest to it (after nor/or).",
+          "british_variant": "No significant difference."
+        },
+        {
+          "rule_id": "CJ_ADV_001",
+          "category": "Conjunctions & Connectors",
+          "subcategory": "Conjunctive Adverbs",
+          "title": "Conjunctive adverb with only a comma",
+          "description": "Conjunctive adverbs joining two independent clauses require a semicolon before them (or period + new sentence), plus a comma after.",
+          "severity": "error",
+          "language_register": "both",
+          "pattern_description": "Detect independent clause + comma + conjunctive adverb (however|therefore|moreover|furthermore|consequently|nevertheless|nonetheless|meanwhile|thus|hence|thereby|otherwise|accordingly|similarly|likewise|indeed|instead|still) + independent clause.",
+          "examples": {
+            "incorrect": [
+              "She was tired, however she kept working.",
+              "He failed the test, therefore he studied harder.",
+              "It rained, consequently we stayed home."
+            ],
+            "correct": [
+              "She was tired; however, she kept working.",
+              "He failed the test; therefore, he studied harder.",
+              "It rained; consequently, we stayed home."
+            ]
+          },
+          "exceptions": [
+            "When used parenthetically mid-sentence: 'She, however, kept working.' (commas are correct)."
+          ],
+          "fix_hint": "Replace the comma before the conjunctive adverb with a semicolon or period, and add a comma after it.",
+          "british_variant": "No significant difference."
+        },
+        {
+          "rule_id": "CJ_RSN_001",
+          "category": "Conjunctions & Connectors",
+          "subcategory": "Common Conjunction Errors",
+          "title": "'The reason is because' redundancy",
+          "description": "'The reason is because' is redundant — 'reason' already implies 'because'.",
+          "severity": "warning",
+          "language_register": "formal",
+          "pattern_description": "Regex: /\\bthe\\s+reason\\s+(is|was|being)\\s+because\\b/i",
+          "examples": {
+            "incorrect": [
+              "The reason is because he was late.",
+              "The reason was because the system crashed.",
+              "The main reason is because costs increased."
+            ],
+            "correct": [
+              "The reason is that he was late.",
+              "He was late because of the system crash.",
+              "The main reason is that costs increased."
+            ]
+          },
+          "exceptions": ["Widely used in informal speech. Flag only in formal register."],
+          "fix_hint": "Replace 'because' with 'that' after 'the reason is'.",
+          "british_variant": "No significant difference."
+        },
+        {
+          "rule_id": "CJ_WRD_001",
+          "category": "Conjunctions & Connectors",
+          "subcategory": "Wordy Conjunctions",
+          "title": "Wordy conjunction replacement",
+          "description": "Replace verbose conjunctive phrases with simpler equivalents.",
+          "severity": "suggestion",
+          "language_register": "both",
+          "pattern_description": "Regex: /\\bdue to the fact that\\b/i → 'because', /\\bin spite of the fact that\\b/i → 'although', /\\bregardless of the fact that\\b/i → 'although', /\\bfor the purpose of\\b/i → 'to', /\\bin order to\\b/i → 'to', /\\bin the event that\\b/i → 'if', /\\bin light of the fact that\\b/i → 'because', /\\bwith the exception of\\b/i → 'except'",
+          "examples": {
+            "incorrect": [
+              "Due to the fact that it rained, we stayed.",
+              "In spite of the fact that she was tired, she worked.",
+              "In the event that you fail, try again."
+            ],
+            "correct": [
+              "Because it rained, we stayed.",
+              "Although she was tired, she worked.",
+              "If you fail, try again."
+            ]
+          },
+          "exceptions": ["Some verbose forms are appropriate in legal or very formal writing."],
+          "fix_hint": "Replace the verbose phrase with the simpler equivalent.",
+          "british_variant": "No significant difference."
+        }
+      ]
+    },
+    {
+      "code": "PU",
+      "name": "Punctuation",
+      "rules": [
+        {
+          "rule_id": "PU_COM_001",
+          "category": "Punctuation",
+          "subcategory": "Comma Rules",
+          "title": "Missing comma after introductory element",
+          "description": "Place a comma after introductory words, phrases, or clauses.",
+          "severity": "warning",
+          "language_register": "both",
+          "pattern_description": "Match sentence-initial introductory adverbs (However, Therefore, Furthermore, Moreover, Nevertheless, Meanwhile, Consequently, Additionally, Similarly, Accordingly, Unfortunately, Fortunately, Finally, Obviously, Clearly, Actually, Basically, Certainly, Generally, Honestly, Naturally, Personally, Seriously, Technically, Typically, Ultimately) NOT followed by a comma.",
+          "examples": {
+            "incorrect": [
+              "However the plan failed.",
+              "Therefore she left early.",
+              "Unfortunately we lost.",
+              "Meanwhile the storm continued."
+            ],
+            "correct": [
+              "However, the plan failed.",
+              "Therefore, she left early.",
+              "Unfortunately, we lost.",
+              "Meanwhile, the storm continued."
+            ]
+          },
+          "exceptions": [
+            "'However' meaning 'in whatever way': 'However you do it, be careful.' (no comma after however, comma after clause)."
+          ],
+          "fix_hint": "Add a comma after the introductory element.",
+          "british_variant": "No significant difference."
+        },
+        {
+          "rule_id": "PU_COM_002",
+          "category": "Punctuation",
+          "subcategory": "Comma Rules",
+          "title": "Missing comma in direct address",
+          "description": "Use a comma to set off names or titles when directly addressing someone.",
+          "severity": "warning",
+          "language_register": "both",
+          "pattern_description": "Match greeting/address word (Thanks, Thank you, Hi, Hello, Hey, Dear, Excuse me, Good morning, Good afternoon, Good evening, Please, Sorry, Yes, No, Well, OK, Okay) + proper noun without comma.",
+          "examples": {
+            "incorrect": [
+              "Thanks John.",
+              "Hello Mary how are you?",
+              "Please Doctor can you help?",
+              "Hey Mike come here."
+            ],
+            "correct": [
+              "Thanks, John.",
+              "Hello, Mary, how are you?",
+              "Please, Doctor, can you help?",
+              "Hey, Mike, come here."
+            ]
+          },
+          "exceptions": [],
+          "fix_hint": "Add commas around the name/title being addressed.",
+          "british_variant": "No significant difference."
+        },
+        {
+          "rule_id": "PU_APO_001",
+          "category": "Punctuation",
+          "subcategory": "Apostrophe Errors",
+          "title": "its vs it's confusion",
+          "description": "'It's' = 'it is' or 'it has'. 'Its' = possessive (belonging to it). Never use 'its'' (with trailing apostrophe).",
+          "severity": "error",
+          "language_register": "both",
+          "pattern_description": "Detect 'its' before a verb (been, is, going, raining, etc.) where 'it's' is needed. Detect 'it's' before a noun where possessive 'its' is needed: 'it's color', 'it's purpose', 'it's role'.",
+          "examples": {
+            "incorrect": [
+              "Its raining outside.",
+              "Its been a long day.",
+              "The dog wagged it's tail.",
+              "It's color is blue."
+            ],
+            "correct": [
+              "It's raining outside.",
+              "It's been a long day.",
+              "The dog wagged its tail.",
+              "Its color is blue."
+            ]
+          },
+          "exceptions": [],
+          "fix_hint": "If you can replace with 'it is' or 'it has', use 'it's'. Otherwise, use 'its' (no apostrophe).",
+          "british_variant": "No significant difference."
+        },
+        {
+          "rule_id": "PU_APO_002",
+          "category": "Punctuation",
+          "subcategory": "Apostrophe Errors",
+          "title": "your vs you're confusion",
+          "description": "'You're' = 'you are'. 'Your' = possessive (belonging to you).",
+          "severity": "error",
+          "language_register": "both",
+          "pattern_description": "Detect 'your' before adjective/adverb describing the listener ('your welcome', 'your right', 'your wrong', 'your amazing', 'your going'). Detect 'you're' before a noun where 'your' is needed ('you're house', 'you're car', 'you're book').",
+          "examples": {
+            "incorrect": [
+              "Your welcome.",
+              "Your going to love this.",
+              "Your the best.",
+              "You're house is nice."
+            ],
+            "correct": [
+              "You're welcome.",
+              "You're going to love this.",
+              "You're the best.",
+              "Your house is nice."
+            ]
+          },
+          "exceptions": [],
+          "fix_hint": "If you can replace with 'you are', use 'you're'. Otherwise 'your'.",
+          "british_variant": "No significant difference."
+        },
+        {
+          "rule_id": "PU_APO_003",
+          "category": "Punctuation",
+          "subcategory": "Apostrophe Errors",
+          "title": "their/they're/there confusion",
+          "description": "'They're' = 'they are'. 'Their' = possessive. 'There' = location/existential.",
+          "severity": "error",
+          "language_register": "both",
+          "pattern_description": "Detect 'their' + verb (going, coming, working) → 'they're'. Detect 'there' + possessive context ('there house') → 'their'. Detect 'they're' + noun ('they're house') → 'their'.",
+          "examples": {
+            "incorrect": [
+              "Their going to the store.",
+              "There house is big.",
+              "They're car is red.",
+              "Look over their."
+            ],
+            "correct": [
+              "They're going to the store.",
+              "Their house is big.",
+              "Their car is red.",
+              "Look over there."
+            ]
+          },
+          "exceptions": [],
+          "fix_hint": "'they are' = they're, 'belonging to them' = their, 'that place' = there.",
+          "british_variant": "No significant difference."
+        },
+        {
+          "rule_id": "PU_APO_004",
+          "category": "Punctuation",
+          "subcategory": "Apostrophe Errors",
+          "title": "Apostrophe in simple plurals",
+          "description": "Never use an apostrophe to form a regular plural noun.",
+          "severity": "error",
+          "language_register": "both",
+          "pattern_description": "Regex: /\\b([A-Za-z]+)'s\\b/ where the word is a regular plural context (not possessive). Detect patterns like 'apple's for sale', 'the dog's are barking', 'DVD's', '1990's'.",
+          "examples": {
+            "incorrect": [
+              "Apple's for sale.",
+              "The dog's are barking.",
+              "She has many CD's.",
+              "I love the 1990's."
+            ],
+            "correct": [
+              "Apples for sale.",
+              "The dogs are barking.",
+              "She has many CDs.",
+              "I love the 1990s."
+            ]
+          },
+          "exceptions": [
+            "Apostrophes in plurals of single letters: 'Mind your p's and q's.' Decades: '1990's' is acceptable in some style guides."
+          ],
+          "fix_hint": "Remove the apostrophe — use plain -s for plurals.",
+          "british_variant": "No significant difference."
+        },
+        {
+          "rule_id": "PU_SEM_001",
+          "category": "Punctuation",
+          "subcategory": "Semicolon",
+          "title": "Semicolon joining independent clauses",
+          "description": "A semicolon joins two closely related independent clauses without a conjunction.",
+          "severity": "suggestion",
+          "language_register": "formal",
+          "pattern_description": "Detect two independent clauses separated by a period where a semicolon might improve flow, or comma splices that should use a semicolon.",
+          "examples": {
+            "incorrect": [
+              "She likes coffee, he prefers tea.",
+              "The project failed, the budget was exceeded."
+            ],
+            "correct": [
+              "She likes coffee; he prefers tea.",
+              "The project failed; the budget was exceeded."
+            ]
+          },
+          "exceptions": ["When clauses are not closely related, use a period instead."],
+          "fix_hint": "Replace the comma with a semicolon, or add a coordinating conjunction after the comma.",
+          "british_variant": "No significant difference."
+        },
+        {
+          "rule_id": "PU_HYP_001",
+          "category": "Punctuation",
+          "subcategory": "Hyphenation",
+          "title": "Missing hyphen in compound adjective before noun",
+          "description": "Compound adjectives before a noun should be hyphenated.",
+          "severity": "suggestion",
+          "language_register": "formal",
+          "pattern_description": "Match common compound adjectives without hyphens: 'well known author'→'well-known author', 'high quality product'→'high-quality product', 'long term plan'→'long-term plan', 'full time job'→'full-time job', 'part time work'→'part-time work', 'state of the art technology'→'state-of-the-art technology', 'up to date information'→'up-to-date information', 'real time data'→'real-time data'.",
+          "examples": {
+            "incorrect": [
+              "A well known author.",
+              "A high quality product.",
+              "A long term plan.",
+              "A full time job."
+            ],
+            "correct": [
+              "A well-known author.",
+              "A high-quality product.",
+              "A long-term plan.",
+              "A full-time job."
+            ]
+          },
+          "exceptions": [
+            "After the noun: 'The author is well known.' (no hyphen). Adverb ending -ly: 'a beautifully designed room' (no hyphen)."
+          ],
+          "fix_hint": "Add hyphens between the words forming the compound adjective when it precedes the noun.",
+          "british_variant": "No significant difference."
+        }
+      ]
+    },
+    {
+      "code": "SP",
+      "name": "Spelling Rules",
+      "rules": [
+        {
+          "rule_id": "SP_COM_001",
+          "category": "Spelling Rules",
+          "subcategory": "Commonly Misspelled Words",
+          "title": "Top 100 misspelled words",
+          "description": "A dictionary of the most commonly misspelled English words.",
+          "severity": "error",
+          "language_register": "both",
+          "pattern_description": "Word-boundary regex match for each misspelling → correct form. Includes: accommodate, acquire, argument, beginning, believe, bizarre, calendar, Caribbean, cemetery, committee, conscious, conscience, definitely, dilemma, embarrass, equivalent, exaggerate, existence, foreign, guarantee, harass, hierarchy, humorous, immediately, independent, indispensable, liaison, maintenance, millennium, miniature, miscellaneous, necessary, noticeable, occasionally, occurrence, parallel, perceive, perseverance, personnel, possession, privilege, receive, recommend, referred, relevant, resistance, restaurant, rhythm, schedule, separate, sergeant, similar, sincerely, subtle, supersede, surprise, tendency, threshold, tomorrow, unnecessary, vacuum, Wednesday, weird.",
+          "examples": {
+            "incorrect": [
+              "accomodate",
+              "arguement",
+              "bizzare",
+              "calender",
+              "cemetary",
+              "committie",
+              "concious",
+              "definately",
+              "embarass",
+              "existance",
+              "foriegn",
+              "guarentee",
+              "harrass",
+              "hierarcy",
+              "independant",
+              "liason",
+              "maintainance",
+              "millenium",
+              "neccessary",
+              "occassion",
+              "paralell",
+              "percieve",
+              "possesion",
+              "priviledge",
+              "recieve",
+              "recomend",
+              "relevent",
+              "restuarant",
+              "rythm",
+              "seperate"
+            ],
+            "correct": [
+              "accommodate",
+              "argument",
+              "bizarre",
+              "calendar",
+              "cemetery",
+              "committee",
+              "conscious",
+              "definitely",
+              "embarrass",
+              "existence",
+              "foreign",
+              "guarantee",
+              "harass",
+              "hierarchy",
+              "independent",
+              "liaison",
+              "maintenance",
+              "millennium",
+              "necessary",
+              "occasion",
+              "parallel",
+              "perceive",
+              "possession",
+              "privilege",
+              "receive",
+              "recommend",
+              "relevant",
+              "restaurant",
+              "rhythm",
+              "separate"
+            ]
+          },
+          "exceptions": [],
+          "fix_hint": "Replace with correct spelling.",
+          "british_variant": "See SP_BRA_001 for British/American spelling differences."
+        },
+        {
+          "rule_id": "SP_BRA_001",
+          "category": "Spelling Rules",
+          "subcategory": "British vs American Spelling",
+          "title": "British/American spelling variant detection",
+          "description": "Detect and flag when British and American spellings are mixed within the same document.",
+          "severity": "suggestion",
+          "language_register": "both",
+          "pattern_description": "Track occurrences of variant pairs: -our/-or (colour/color, favour/favor, honour/honor, humour/humor, labour/labor, neighbour/neighbor, behaviour/behavior), -re/-er (centre/center, theatre/theater, metre/meter, fibre/fiber, litre/liter, lustre/luster, sombre/somber), -ise/-ize (organise/organize, realise/realize, recognise/recognize, specialise/specialize, analyse/analyze), -ence/-ense (defence/defense, licence/license, offence/offense, pretence/pretense), -ogue/-og (catalogue/catalog, dialogue/dialog, analogue/analog), double/single consonant (travelled/traveled, cancelled/canceled, modelling/modeling, labelled/labeled, counsellor/counselor, jewellery/jewelry), -ae/-e (anaemia/anemia, orthopaedic/orthopedic, paediatric/pediatric). Flag when document contains both variants.",
+          "examples": {
+            "incorrect": [
+              "The colour of the center was nice.",
+              "She travelled to the theater.",
+              "He organised the defense plan."
+            ],
+            "correct": [
+              "The color of the center was nice. (AmE)",
+              "The colour of the centre was nice. (BrE)",
+              "He organized the defense plan. (AmE)"
+            ]
+          },
+          "exceptions": [
+            "Proper nouns: 'Defence Ministry' or 'Department of Defense' — preserve as-is. Direct quotes preserve original spelling."
+          ],
+          "fix_hint": "Maintain consistency: detect which variant is dominant in the document and flag exceptions.",
+          "british_variant": "This rule specifically handles British/American differences."
+        },
+        {
+          "rule_id": "SP_DBL_001",
+          "category": "Spelling Rules",
+          "subcategory": "Doubling Consonants",
+          "title": "Incorrect consonant doubling",
+          "description": "When adding a vowel suffix, double the final consonant only if the word ends CVC AND has stress on the final syllable.",
+          "severity": "error",
+          "language_register": "both",
+          "pattern_description": "Wrong doubles: writting→writing, begining→beginning, occured→occurred, refered→referred, comming→coming, openning→opening, happenning→happening, developped→developed, occuring→occurring, prefered→preferred, benefitting→benefiting (AmE), cancelling→canceling (AmE). Wrong singles: runing→running, siting→sitting, planing→planning, stoping→stopping, shoping→shopping, droping→dropping, geting→getting, puting→putting, cuting→cutting, hiting→hitting.",
+          "examples": {
+            "incorrect": [
+              "She was writting a letter.",
+              "The event is occuring now.",
+              "He refered to the manual.",
+              "She is runing fast.",
+              "They are planing a trip."
+            ],
+            "correct": [
+              "She was writing a letter.",
+              "The event is occurring now.",
+              "He referred to the manual.",
+              "She is running fast.",
+              "They are planning a trip."
+            ]
+          },
+          "exceptions": [
+            "British English doubles more consonants: travelled, cancelled, modelling (vs American: traveled, canceled, modeling)."
+          ],
+          "fix_hint": "Check the stress pattern and final consonant to determine whether to double.",
+          "british_variant": "British English doubles final consonant in more words: travelled, modelled, cancelled."
+        },
+        {
+          "rule_id": "SP_IEE_001",
+          "category": "Spelling Rules",
+          "subcategory": "IE/EI Rule",
+          "title": "I before E rule violations",
+          "description": "I before E except after C, or when sounded as 'ay' (as in neighbor, weigh).",
+          "severity": "error",
+          "language_register": "both",
+          "pattern_description": "Match common errors: recieve→receive, beleive→believe, acheive→achieve, concieve→conceive, decieve→deceive, percieve→perceive, wierd→weird, nieghbor→neighbor, foriegn→foreign, seize (correct, exception to rule), their (correct, 'ay' sound).",
+          "examples": {
+            "incorrect": [
+              "I beleive you.",
+              "She will recieve it.",
+              "They acheived their goals.",
+              "That's wierd.",
+              "Don't decieve me."
+            ],
+            "correct": [
+              "I believe you.",
+              "She will receive it.",
+              "They achieved their goals.",
+              "That's weird.",
+              "Don't deceive me."
+            ]
+          },
+          "exceptions": [
+            "weird, seize, either, neither, foreign, leisure, protein, caffeine, species, science, sufficient, ancient, glacier, society — numerous exceptions exist."
+          ],
+          "fix_hint": "Apply i-before-e rule, but check the exceptions list.",
+          "british_variant": "No significant difference."
+        },
+        {
+          "rule_id": "SP_SIL_001",
+          "category": "Spelling Rules",
+          "subcategory": "Silent E Rule",
+          "title": "Silent E errors with suffixes",
+          "description": "Drop silent 'e' before a vowel suffix (-ing, -able, -ous, -ation), keep before consonant suffix (-ment, -ful, -less, -ness).",
+          "severity": "error",
+          "language_register": "both",
+          "pattern_description": "Wrong: makeing→making, hopeing→hoping, useing→using, moveing→moving, liveing→living, writeing→writing, loveable→lovable, arguement→argument, truely→truly, nineth→ninth, judgement→judgment (AmE). Correct: hopeful (keep e), movement (keep e), useful (keep e), barely (keep e).",
+          "examples": {
+            "incorrect": [
+              "She is makeing dinner.",
+              "They were hopeing for rain.",
+              "That is truely amazing.",
+              "She is useing the computer."
+            ],
+            "correct": [
+              "She is making dinner.",
+              "They were hoping for rain.",
+              "That is truly amazing.",
+              "She is using the computer."
+            ]
+          },
+          "exceptions": [
+            "Keep 'e' after soft c/g: noticeable, changeable, manageable, courageous. 'Judgement' accepted in British English."
+          ],
+          "fix_hint": "Drop the 'e' before vowel suffixes; keep before consonant suffixes (with noted exceptions).",
+          "british_variant": "'Judgement' is standard in British English. 'Ageing' (BrE) vs 'aging' (AmE)."
+        },
+        {
+          "rule_id": "SP_YTI_001",
+          "category": "Spelling Rules",
+          "subcategory": "Y to I Rule",
+          "title": "Y to I conversion errors",
+          "description": "When a word ends in consonant + y, change y to i before most suffixes (but keep y before -ing).",
+          "severity": "error",
+          "language_register": "both",
+          "pattern_description": "Wrong: happyer→happier, easyer→easier, beautyfull→beautiful, partys→parties, familys→families, carryed→carried, tryed→tried, studyed→studied, cryed→cried, replyed→replied, applyed→applied. Keep y: studying (not studing), carrying (not carriing), trying (not triing), playing (not plaiing — vowel + y stays).",
+          "examples": {
+            "incorrect": [
+              "She is happyer now.",
+              "Those are the best partys.",
+              "He carryed the box.",
+              "She tryed her best.",
+              "The babys are sleeping."
+            ],
+            "correct": [
+              "She is happier now.",
+              "Those are the best parties.",
+              "He carried the box.",
+              "She tried her best.",
+              "The babies are sleeping."
+            ]
+          },
+          "exceptions": [
+            "Vowel + y: stays as is (played, keys, donkeys). Before -ing: keep y (studying, carrying). Proper nouns (the Kennedys, not Kennedies)."
+          ],
+          "fix_hint": "Change consonant + y to i before suffixes other than -ing.",
+          "british_variant": "No significant difference."
+        }
+      ]
+    }
+  ],
+  "implementation_notes": {
+    "CJ": {
+      "tokenization": "Conjunction errors are mix of regex (redundancy, wordy) and NLP (clause boundary detection for comma rules).",
+      "nlp_requirements": "CJ_CRD_001 needs clause boundary detection. CJ_COR_001 needs nearest-subject agreement checking.",
+      "regex_applicability": "CJ_RED_001, CJ_RSN_001, CJ_WRD_001 are purely regex-based. CJ_ADV_001 can use regex with clause heuristics.",
+      "performance": "Combine wordy conjunction patterns into a single alternation regex for efficiency."
+    },
+    "PU": {
+      "tokenization": "Punctuation checks operate at character level. Split text preserving all whitespace and punctuation.",
+      "nlp_requirements": "Comma rules need clause detection. Apostrophe rules are regex-based with POS context.",
+      "regex_applicability": "Most PU rules are regex-based. PU_COM_001, PU_APO_001-004 are excellent regex candidates.",
+      "performance": "Apostrophe checks should run early — they're fast and high-value for user satisfaction."
+    },
+    "SP": {
+      "tokenization": "Spelling checks use word-boundary matching. Build a HashMap<misspelling, correction> for O(1) lookup.",
+      "nlp_requirements": "SP_BRA_001 needs document-level analysis to detect dominant spelling variant. All others are word-level.",
+      "regex_applicability": "All SP rules are regex-based. SP_COM_001 should use a compiled map of 200+ entries.",
+      "performance": "Compile all misspellings into a single Trie or Set for efficient scanning. For long documents, process in chunks."
+    },
+    "general_architecture": {
+      "rule_loading": "Load all JSON rules at startup, compile regex patterns once, store in typed Rule[] arrays.",
+      "priority_order": "Process rules in order: spelling > grammar > clarity > style. Within each, errors before warnings before suggestions.",
+      "deduplication": "When multiple rules flag the same text span, keep the highest-severity match only.",
+      "codebase_mapping": {
+        "regex_rules": "Use createRegexRule() helper from types.ts for all pattern-based rules.",
+        "nlp_rules": "Use NLPRule interface with compromise doc parameter for POS-dependent rules.",
+        "custom_check_rules": "Use RegexRule with custom check() function for complex logic (article a/an, comma splices, sentence fragments).",
+        "category_files": "Create new files in src/rules/categories/ for each code: sentence-structure.ts, verb-tense.ts, nouns-pronouns.ts, articles-determiners.ts, adjectives-adverbs.ts, prepositions.ts, conjunctions.ts, punctuation.ts, spelling-patterns.ts"
+      }
+    }
+  }
+}