humanizer-ru 3.19.0 → 3.19.1

package/README.en.md

@@ -5,9 +5,10 @@
 Claude Code / Cowork plugin. Kills AI smell in Russian text. The English [humanizer](https://github.com/blader/humanizer) won't help here. Russian AI markers are their own beast: bureaucratic noun-chains (канцелярит), English-syntax calques, missing particles like "же" and "ведь" that make Russian sound alive.
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-3.19.0-blueviolet)](https://github.com/ilyautov/humanizer-ru/blob/main/CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-3.19.1-blueviolet)](https://github.com/ilyautov/humanizer-ru/blob/main/CHANGELOG.md)
 [![Stars](https://img.shields.io/github/stars/ilyautov/humanizer-ru?style=social)](https://github.com/ilyautov/humanizer-ru/stargazers)
 [![skills.sh](https://skills.sh/b/ilyautov/humanizer-ru)](https://skills.sh/ilyautov/humanizer-ru/humanizer-ru)
+[![npm](https://img.shields.io/npm/v/humanizer-ru?label=npm%20%C2%B7%20dsh)](https://www.npmjs.com/package/humanizer-ru)
 
 <p align="center">
   <a href="https://humanizer-ru.aifrontier.tech/">
@@ -59,7 +60,7 @@ Workspace admins can roll the skill out to the whole team via **Admin Console
 npx skills add https://github.com/ilyautov/humanizer-ru/tree/main/skills/humanizer-ru
 ```
 
-The CLI drops `SKILL.md` into `~/.claude/skills/humanizer-ru/` and registers the skill on [skills.sh](https://skills.sh/ilyautov/humanizer-ru/humanizer-ru). Point at the full skill-folder path: the short `ilyautov/humanizer-ru` form resolves to the repo root, which has no `SKILL.md` (removed in v3.14.2), so the install either fails or pulls in the whole repository.
+The CLI drops `SKILL.md` into `~/.claude/skills/humanizer-ru/` and registers the skill on [skills.sh](https://skills.sh/ilyautov/humanizer-ru/humanizer-ru). The short form works too: `npx skills add ilyautov/humanizer-ru` discovers the skill inside the repository and offers it for install; add `--skill humanizer-ru` to install without prompts.
 
 **API (`/v1/messages` and equivalents):** pass the skill via the `container.skills` parameter. See your client's docs.
 
@@ -129,12 +130,14 @@ Generic path for native readers: drop the skill folder into the directory the ag
 
 DeepSeek Harness reads the same Agent Skills format. Two ways to install.
 
-As a bundle, one command into the profile you use (`web`, `tui` or `headless`):
+As an npm bundle, one command into the profile you use (`web`, `tui` or `headless`):
 
 ```bash
-dsh plugin --profile web add github:ilyautov/humanizer-ru
+dsh plugin --profile web add humanizer-ru
 ```
 
+The same bundle straight from GitHub, for a specific branch or the freshest main: `dsh plugin --profile web add github:ilyautov/humanizer-ru`.
+
 The bundle is text only: `package.json` with a `dsh.bundle` field and `cordis.patch.yml`, which mounts the stock `dsh-skill-filesystem` provider on the package's `skills/` folder. No executable code, no build step. Verify without running a model: `dsh --profile web --dump-config` shows a `# == humanizer-ru` layer. Remove with `dsh plugin --profile web remove humanizer-ru`.
 
 As a copy into the user skill root:
@@ -167,7 +170,7 @@ Triggers: "очеловечь", "убери следы нейросети", "с
 Before:
 > В современном мире искусственный интеллект играет всё более важную роль в различных сферах деятельности. Стоит отметить, что данная технология является мощным инструментом для оптимизации рабочих процессов.
 
-After:
+After (author's facts):
 > За последний год я внедрил AI-инструменты в три проекта. Два ускорились вдвое. Третий развалился, потому что команда перестала проверять то, что выдаёт модель. AI работает, когда понимаешь его ограничения.
 
 Five hard bans triggered in two sentences. Typical.

package/README.md

@@ -5,9 +5,10 @@
 > [English version](README.en.md)
 
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![Версия](https://img.shields.io/badge/версия-3.19.0-blueviolet)](https://github.com/ilyautov/humanizer-ru/blob/main/CHANGELOG.md)
+[![Версия](https://img.shields.io/badge/версия-3.19.1-blueviolet)](https://github.com/ilyautov/humanizer-ru/blob/main/CHANGELOG.md)
 [![Звёзды](https://img.shields.io/github/stars/ilyautov/humanizer-ru?style=social)](https://github.com/ilyautov/humanizer-ru/stargazers)
 [![skills.sh](https://skills.sh/b/ilyautov/humanizer-ru)](https://skills.sh/ilyautov/humanizer-ru/humanizer-ru)
+[![npm](https://img.shields.io/npm/v/humanizer-ru?label=npm%20%C2%B7%20dsh)](https://www.npmjs.com/package/humanizer-ru)
 
 <p align="center">
   <a href="https://humanizer-ru.aifrontier.tech/">
@@ -100,7 +101,7 @@
 npx skills add https://github.com/ilyautov/humanizer-ru/tree/main/skills/humanizer-ru
 ```
 
-CLI кладёт `SKILL.md` в `~/.claude/skills/humanizer-ru/` и регистрирует скилл в индексе [skills.sh](https://skills.sh/ilyautov/humanizer-ru/humanizer-ru). Указывайте полный путь к папке скилла: короткая форма `ilyautov/humanizer-ru` смотрит в корень репозитория, где `SKILL.md` нет (убран в v3.14.2), и установка либо падает, либо тащит весь репозиторий.
+CLI кладёт `SKILL.md` в `~/.claude/skills/humanizer-ru/` и регистрирует скилл в индексе [skills.sh](https://skills.sh/ilyautov/humanizer-ru/humanizer-ru). Короткая форма тоже работает: `npx skills add ilyautov/humanizer-ru` находит скилл в репозитории и предлагает его к установке, а с флагом `--skill humanizer-ru` ставит без вопросов.
 
 **Через API (`/v1/messages` и аналоги):** передайте скилл параметром `container.skills`. Детали в документации вашего клиента.
 
@@ -176,12 +177,14 @@ RESULT: PASS install-smoke
 
 DeepSeek Harness читает тот же формат Agent Skills, и скилл ставится двумя способами.
 
-Бандлом, одной командой в нужный профиль (`web`, `tui` или `headless`):
+Бандлом из npm, одной командой в нужный профиль (`web`, `tui` или `headless`):
 
 ```bash
-dsh plugin --profile web add github:ilyautov/humanizer-ru
+dsh plugin --profile web add humanizer-ru
 ```
 
+Тот же бандл прямо из GitHub, если нужна конкретная ветка или свежий main: `dsh plugin --profile web add github:ilyautov/humanizer-ru`.
+
 Бандл текстовый: `package.json` с полем `dsh.bundle` и `cordis.patch.yml`, который монтирует штатный провайдер `dsh-skill-filesystem` на папку `skills/` пакета. Исполняемого кода в бандле нет, сборка при установке не нужна. Проверить без запуска модели: `dsh --profile web --dump-config` покажет слой `# == humanizer-ru`. Удаление: `dsh plugin --profile web remove humanizer-ru`.
 
 Копией в пользовательский корень скиллов:
@@ -242,7 +245,7 @@ python skills/humanizer-ru/scripts/scan.py статья.txt --genre academic  #
 До:
 > В современном мире искусственный интеллект играет всё более важную роль в различных сферах деятельности. Стоит отметить, что данная технология является мощным инструментом для оптимизации рабочих процессов.
 
-После:
+После (факты автора):
 > За последний год я внедрил AI-инструменты в три проекта. Два ускорились вдвое. Третий развалился, потому что команда перестала проверять то, что выдаёт модель. AI работает, когда понимаешь его ограничения.
 
 Пять жёстких банов сработали в двух предложениях. Типичная картина.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "humanizer-ru",
-  "version": "3.19.0",
+  "version": "3.19.1",
   "description": "Agent skill for DeepSeek Harness: rewrites Russian text to remove 64 markers of AI generation (bureaucratese, calques, ChatGPT fingerprints), with a corpus-calibrated scanner, audit mode and author-voice calibration.",
   "license": "MIT",
   "author": "Ilya Utov",

package/skills/humanizer-ru/SKILL.md

@@ -4,7 +4,7 @@ description: "Скилл для очеловечивания русскоязы
 license: MIT
 ---
 
-# Humanizer-RU v3.19.0
+# Humanizer-RU v3.19.1
 
 Ты редактор. Превращаешь стерильный AI-текст в живую русскую речь. Убираешь маркеры нейросети и возвращаешь в текст автора: мнение, ритм, характер.
 
@@ -291,7 +291,7 @@ license: MIT
 Было:
 > В современном мире искусственный интеллект играет всё более важную роль в различных сферах деятельности. Стоит отметить, что данная технология является мощным инструментом для оптимизации рабочих процессов. Многие эксперты считают, что внедрение AI-решений способствует повышению эффективности организаций. Важно помнить, что при этом необходимо учитывать этические аспекты использования искусственного интеллекта. Таким образом, можно сделать вывод, что AI представляет собой перспективное направление развития, которое будет оказывать значительное влияние на будущее человечества.
 
-Стало:
+Стало (факты автора):
 > За последний год я внедрил AI-инструменты в три проекта. Два ускорились вдвое. Третий развалился, потому что команда перестала проверять то, что выдаёт модель. Вот что я вынес: AI работает, когда понимаешь его ограничения. Не работает, когда веришь на слово.
 
 ### Описание продукта

package/skills/humanizer-ru/scripts/humanizer_metrics/__init__.py

@@ -11,6 +11,7 @@
 
 from __future__ import annotations
 
+import re
 from dataclasses import dataclass
 
 from .burstiness import RhythmStats, rhythm, rhythm_verdict
@@ -69,12 +70,58 @@ class Report:
         }
 
 
+# --- Код и цитаты не текст автора ------------------------------------------
+# Сканер считал баны внутри блоков кода и внутри коротких цитат в ёлочках:
+# статья про сам скилл с фразой «в современном мире» в кавычках получала
+# «рерайт», а технический пост с примером кода терял баллы за чужой листинг.
+# Код вырезается целиком (тройные и одиночные обратные кавычки). Цитата
+# вырезается, только если она короткая: так цитируют слово или оборот. Длинная
+# цитата в ёлочках это прямая речь или пересказ, её маркеры на совести автора,
+# и в художественном тексте диалоги остаются под сканером.
+#
+# Замена сохраняет длину и переводы строк, чтобы номера строк в отчёте
+# совпадали с файлом; заглушка не буква, поэтому фразовые регексы через неё
+# не склеиваются («От «В современном мире…» до клише» не станет «От до»).
+GAP = "·"
+QUOTE_MAX_WORDS = 12
+_FENCED = re.compile(r"(?s)```.*?```")
+_INLINE_CODE = re.compile(r"`[^`\n]*`")
+_QUOTE = re.compile(r"«[^«»]*»")
+
+
+def _blank(match: re.Match[str]) -> str:
+    return re.sub(r"[^\n]", GAP, match.group(0))
+
+
+def _blank_short_quote(match: re.Match[str]) -> str:
+    inner = match.group(0)[1:-1]
+    if len(inner.split()) <= QUOTE_MAX_WORDS:
+        return _blank(match)
+    return match.group(0)
+
+
+def mask_code_and_quotes(text: str) -> str:
+    """Текст для лексического сканера: код и короткие цитаты заглушены,
+    смещения и номера строк сохранены."""
+    text = _FENCED.sub(_blank, text)
+    text = _INLINE_CODE.sub(_blank, text)
+    return _QUOTE.sub(_blank_short_quote, text)
+
+
+def strip_code(text: str) -> str:
+    """Текст для ритма и морфологии: код удалён, проза оставлена как есть."""
+    text = _FENCED.sub("", text)
+    return _INLINE_CODE.sub("", text)
+
+
 def analyze(text: str) -> Report:
     """Полный детерминированный прогон текста."""
+    lexical = mask_code_and_quotes(text)
+    prose = strip_code(text)
     return Report(
-        hard_bans=scan_hard_bans(text),
-        markers=scan_markers(text),
-        rhythm=rhythm(text),
-        morph=morph_stats(text),
-        structure=structure_stats(text),
+        hard_bans=scan_hard_bans(lexical),
+        markers=scan_markers(lexical),
+        rhythm=rhythm(prose),
+        morph=morph_stats(prose),
+        structure=structure_stats(prose),
     )