Skip to content

CHANGELOG.md

Latest commit

 

History

History
71 lines (50 loc) · 6.08 KB

CHANGELOG.md

File metadata and controls

71 lines (50 loc) · 6.08 KB
Raw

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.1.1 — 2026-04-08

Packaging, hygiene, and discoverability pass. No changes to the skill's detection logic or check catalog — v0.1.0 behavior is unchanged.

Added

  • SECURITY.md — vulnerability reporting policy. Explicitly scopes "security" for a docs-only skill: prompt-injection payloads in content, instructions that could leak data, malicious dictionary/example PRs, typosquatting of companion tools. Reports go through GitHub security advisories.
  • .github/ISSUE_TEMPLATE/ — four YAML issue forms (bug report, new dictionary entry, new trigger word, config). Enforces the CONTRIBUTING.md source-link and false-positive-check requirements at issue creation time. Blank issues disabled; terminology debates and how-to questions routed to Discussions. (Added via PR #2 shortly after v0.1.0.)
  • README badges — license, release, stars, issues, discussions, Claude Code, i18n frameworks, CLDR. Visual discoverability pass.
  • Security section in README pointing to SECURITY.md.

Removed

  • docs/habr-post-draft.md — marketing draft was never meant to ship in the public product repo. The Habr post will be published separately when ready.

Changed

  • CHANGELOG 0.1.0 note rephrased: "verified via manual subagent dispatch" → "verified with manual fixture testing". Same fact, less meta-confessional phrasing.

0.1.0 — 2026-04-07

Initial public release.

Added

  • Skill manifest (SKILL.md) — activation logic, 5-check catalog, output format, workflow, explicit non-goals.
  • Check #1 — Plural structure. Detection for i18next (v4 suffix convention), ICU MessageFormat (FormatJS / react-intl), and vue-i18n (pipe-separated). Includes Step 2.5: flags locale values containing {{count}}/{count}/%{count}/{n} placeholders when the key has no plural siblings, with an ICU-guard to avoid false positives inside {count, plural, ...} blocks. See references/plural-rules.md.
  • Check #2 — Terminology drift. Auto-detection via normalized value comparison across locale files; optional user glossary at .claude/russian-glossary.yml. Simple suffix-stripping normalization (no morphology engine in v1). Template provided at .claude/russian-glossary.example.yml.
  • Check #3 — Concatenation case bug. Heuristic regex detection over a closed trigger list of ~30 Russian prepositions, transitive verbs, and gender-coupling adjectives. Always Warning severity, never Error. See references/concatenation-triggers.md.
  • Check #4 — Language mixing. Per-file comment-language ratio check (25% minority + minimum-2 threshold) plus inline-Russian-literal detection outside the i18n layer (≥3 literals threshold). See references/mixing-and-transliteration.md.
  • Check #5 — Transliterated identifiers. Three-tier detection: dictionary hit + (phonotactic signal OR file-level Russian content). Always Info severity. Seed dictionary of ~130 entries at references/transliteration-dict.yml.
  • Activation guard. Dual-condition trigger: ≥10 total Cyrillic characters + ≥1 five-character Cyrillic cluster across code and locale files. Zero noise on English-only projects. See references/activation-logic.md.
  • Examples (references/examples.md) — 16 before/after cases sourced from real projects (Badoo, Kaspersky, VK, ua-hosting, VC.ru, GitHub). No invented examples. Weak categories flagged honestly.
  • README.md — English-facing landing with install instructions, check overview, limitations, and acknowledgments.
  • CONTRIBUTING.md — contribution rules with mandatory source-link and false-positive-check requirements.
  • LICENSE — MIT.
  • Habr post draft at docs/habr-post-draft.md, self-audited against the skill's own rules.

Explicit non-goals in v0.1.0

These areas are covered by other tools and are not in scope for this skill:

  • Russian typography (« », em-dash, non-breaking spaces) → delegated to talkstream/ru-text.
  • Russian spelling → delegated to yaspeller.
  • ё/е restoration → delegated to eyo.
  • UX writing quality, machine-translation artifacts → partially covered by ru-text; not duplicated here.
  • Morphology-based analysis (pymorphy3 integration) → deferred to a future version.
  • i18next v3 (key_plural format) → only v4 suffix conventions are supported.
  • Languages other than Russian → out of scope.
  • Automated test suite → deferred to v0.2 (v0.1 was verified with manual fixture testing).

Known limitations

  • vue-i18n pipe detection is heuristic. Prose with literal | can cause false positives. Findings are emitted as Warning, never Error.
  • Concatenation check #3 is a regex heuristic over a closed trigger list. Expected false-positive rate: ~10–15%. All findings are Warning, never Error.
  • Transliteration check #5 has thin public evidence — the dictionary is seeded from common Russian dev vocabulary, because live GitHub permalinks for transliterated identifiers are rare (the problem lives primarily in private corporate codebases). All findings are Info, never Warning.
  • Terminology normalization uses simple suffix-stripping. Over-stemming is possible; recommend providing a glossary via .claude/russian-glossary.yml for precise control.
  • Nested ICU plurals (plural inside select) may be missed by the v1 regex-based parser.
  • .claude-plugin/plugin.json is intentionally NOT included in v0.1.0 — the plugin manifest schema should be verified against the current Claude Code plugin spec before submission to the Anthropic plugin marketplace.