ai-text-check 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pritam Ghosh <contact.meghoshpritam@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/NOTICE

@@ -0,0 +1,36 @@
+ai-text-check
+Copyright (c) 2026 Pritam Ghosh <contact.meghoshpritam@gmail.com>
+
+This product is licensed under the MIT License. See LICENSE.
+
+The following third-party Vale styles are vendored under vale/styles/ and
+keep their upstream licenses. Copies of those licenses sit next to each style.
+
+Google
+  License: MIT
+  Copyright (c) 2018-2019 Joseph Kato
+  https://github.com/errata-ai/Google
+
+write-good
+  License: MIT
+  Copyright (c) 2019 errata.ai
+  Based on write-good by Brian Ford (Copyright (c) 2014 Brian Ford)
+  https://github.com/errata-ai/write-good
+
+ai-tells
+  License: MIT
+  Copyright (c) 2025-2026 Tony Burns
+  https://github.com/tbhb/vale-ai-tells
+
+signs-of-ai-writing
+  License: Creative Commons Attribution-ShareAlike 4.0 International
+  https://github.com/ammil-industries/vale-signs-of-ai-writing
+  Derived from Wikipedia, "Signs of AI writing"
+  https://creativecommons.org/licenses/by-sa/4.0/
+
+AiTextCheck
+  License: MIT
+  Copyright (c) 2026 Pritam Ghosh
+  Custom Vale rules extracted from mepritam-revamp-26
+
+Runtime npm dependencies retain their own licenses.

package/README.md

@@ -0,0 +1,174 @@
+# ai-text-check
+
+One-point checker for AI writing tells, grammar, and synthetic typography in any JavaScript or TypeScript project.
+
+It runs the mepritam.dev content-quality stack together with Vale, slop-gate, write-good, retext, is-this-ai-slop, Veldica, and clean-writing-lint, then returns a single scored report. See [SOURCES.md](./SOURCES.md) for the file-by-file map.
+
+## Install
+
+```bash
+npm install -D ai-text-check
+```
+
+Node.js 20+ is required. The package ships dual **ESM and CommonJS** builds with TypeScript types. Vale and slop-gate are regular dependencies, not optional peers.
+
+## What it checks
+
+| Engine              | What it catches                                                                                            |
+| ------------------- | ---------------------------------------------------------------------------------------------------------- |
+| **polish**          | Custom AI tells (`delve`, `in today's world`, antithesis), readability, markdown structure/SEO, typography |
+| **slop-gate**       | Vocabulary pack (`nestled`, `treasure trove`, `leverage`, …)                                               |
+| **write-good**      | Weasel words, clichés, wordy phrases, passive voice                                                        |
+| **retext**          | Passive voice, readability grade, simplify, repeated words                                                 |
+| **is-this-ai-slop** | Clichés, buzzwords, em-dash spam, antithesis, sycophancy                                                   |
+| **veldica**         | Stock LLM transitions and AI-style markers                                                                 |
+| **clean-writing**   | Banned constructions, marketing adjectives, filler, intensifiers                                           |
+| **vale**            | Vendored styles: write-good, Google, AiTextCheck, ai-tells, signs-of-ai-writing                            |
+
+Safe auto-fixes can strip filler openers and collapse extra whitespace without rewriting code fences.
+
+## TypeScript
+
+```ts
+import { checkText, defineConfig, personalizeText } from "ai-text-check";
+
+const config = defineConfig({
+  preset: "default",
+  failOn: "warn",
+  ignoreRules: ["leverage-utilize"],
+  engines: { vale: true },
+});
+
+const report = checkText(draft, {
+  format: "markdown",
+  applyFixes: true,
+  config,
+});
+
+if (report.score < 70) {
+  console.error(report.issues);
+}
+```
+
+## JavaScript (CJS or ESM)
+
+```js
+const { checkText, sanitizeText } = require("ai-text-check");
+
+const report = checkText("In today's fast-paced world, we leverage synergy.");
+console.log(report.score, report.issues, report.enginesRun);
+
+const cleaned = sanitizeText("Wait—what? “Hello” …");
+```
+
+```js
+import { checkText } from "ai-text-check";
+```
+
+## Node file API
+
+```ts
+import { checkFile, checkFiles, loadConfig } from "ai-text-check/node";
+
+const config = await loadConfig();
+const summary = checkFiles(["content", "README.md"], {
+  config,
+  writeFixes: true,
+});
+
+if (summary.failed) process.exit(1);
+```
+
+`loadConfig()` reads, in order:
+
+1. `ai-text-check.config.json` / `.js` / `.mjs` / `.cjs`
+2. `package.json` → `"ai-text-check"`
+
+Unknown keys and invalid types fail with a validation error. Vale findings are merged into the same `issues` array (use `--no-vale` or `engines.vale: false` to skip).
+
+## CLI
+
+```bash
+npx ai-text-check
+npx ai-text-check content README.md
+npx ai-text-check --fix --min-score 70 docs
+npx ai-text-check --preset ai --json
+npx ai-text-check --sanitize
+npx ai-text-check --no-vale
+npx ai-text-check init
+```
+
+| Flag                                    | Meaning                            |
+| --------------------------------------- | ---------------------------------- |
+| `--fix`                                 | Apply safe automatic fixes         |
+| `--sanitize`                            | Normalize AI typography on disk    |
+| `--json`                                | Machine-readable report            |
+| `--fail-on error\|warn\|info`           | CI threshold (default `warn`)      |
+| `--min-score N`                         | Fail if any file scores below N    |
+| `--preset default\|strict\|ai\|grammar` | Rule pack                          |
+| `--format auto\|plain\|markdown`        | Input format                       |
+| `--no-vale`                             | Skip Vale                          |
+| `--no-slop`                             | Skip slop-gate and is-this-ai-slop |
+| `--no-write-good`                       | Skip write-good                    |
+| `--no-retext`                           | Skip retext                        |
+| `--ignore-rule ID`                      | Skip a rule (repeatable)           |
+
+Exit code `1` when issues meet the fail threshold.
+
+## Config
+
+`ai-text-check.config.json`:
+
+```json
+{
+  "preset": "default",
+  "failOn": "warn",
+  "minScore": 0,
+  "extensions": [".md", ".mdx", ".markdown", ".txt"],
+  "ignoreRules": [],
+  "checks": {
+    "ai": true,
+    "grammar": true,
+    "readability": true,
+    "structure": true,
+    "seo": true,
+    "typography": true
+  },
+  "engines": {
+    "polish": true,
+    "slopGate": true,
+    "writeGood": true,
+    "retext": true,
+    "isThisAiSlop": true,
+    "veldica": true,
+    "cleanWriting": true,
+    "vale": true
+  }
+}
+```
+
+Presets:
+
+- `default`: every check and every engine
+- `strict`: default plus extra slop-gate punctuation
+- `ai`: AI tells + typography (polish, slop-gate, is-this-ai-slop, Veldica, clean-writing, Vale)
+- `grammar`: grammar + readability (write-good, retext, clean-writing, Vale)
+
+## Scripts
+
+```bash
+npm run test
+npm run lint
+npm run typecheck
+npm run format:check
+npm run check
+npm run build
+```
+
+## License
+
+[MIT](./LICENSE) © 2026 Pritam Ghosh.
+
+The checker itself, including the custom `AiTextCheck` Vale rules, is MIT. Vendored Vale styles keep their upstream licenses; see [NOTICE](./NOTICE).
+
+`vale/styles/signs-of-ai-writing` is [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).

package/SOURCES.md

@@ -0,0 +1,34 @@
+# Rule sources
+
+The default checker combines the mepritam.dev content-quality stack with extra
+local, deterministic packages. Nothing here calls a hosted detector or needs an
+API key. Vale (`@vvago/vale`) is the prose engine the user referred to as Vale
+(sometimes heard as “VILE”).
+
+| Library piece                                                                          | Source                                                                                                   |
+| -------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| Custom AI tells, auto-fixes, readability, structure, SEO                               | `mepritam-revamp-26/scripts/lib/content-polish.ts`                                                       |
+| Special-character sanitizer                                                            | `mepritam-revamp-26/lib/sanitize-special-chars.ts`                                                       |
+| `personalizeText()`                                                                    | `mepritam-revamp-26/lib/personalize-text.ts`                                                             |
+| slop-gate vocabulary / punctuation JSON                                                | `slop-gate` 0.4.3 packs copied from mepritam; CLI from `slop-gate`                                       |
+| Vale styles (`write-good`, `ai-tells`, `signs-of-ai-writing`, `Google`, `AiTextCheck`) | `mepritam-revamp-26/.vale/styles`                                                                        |
+| Vale runner                                                                            | `@vvago/vale` native binary + bundled `vale/vale.ini`                                                    |
+| write-good                                                                             | `write-good` npm (same So/ThereIs disables as `.vale.ini`)                                               |
+| retext                                                                                 | `retext-english` + `retext-passive` + `retext-readability` + `retext-simplify` + `retext-repeated-words` |
+| is-this-ai-slop                                                                        | `is-this-ai-slop` (`analyze()`)                                                                          |
+| Veldica AI markers                                                                     | `@veldica/prose-linter` (`inventoryMarkers()`)                                                           |
+| Clean Writing / STE subset                                                             | `clean-writing-lint` (`lint()`), with contraction and 20-word sentence rules off                         |
+
+Skipped after research (not a fit for Node 20 in-process checks):
+
+- `slopsift` / WritingLint — requires Node 24+
+- `slopless` — textlint-only, async
+- `wsc-lint` / `tacheles` — CLI-only, no stable in-process API
+- Hosted classifiers (GPTZero, Originality, etc.) — need secrets / upload text
+
+Default `checkFiles` order: polish + slop-gate JSON + write-good + retext +
+is-this-ai-slop + Veldica + clean-writing, then Vale JSON merged onto the same
+report.
+
+Licenses for this package and the vendored Vale styles are in [LICENSE](./LICENSE)
+and [NOTICE](./NOTICE).