random_name_generator 4.0.2 → 4.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e3511685f7df265b945b6254e889eac64d5857309623a5c09f91f309f9fc52d
-  data.tar.gz: bc756891b8f9adda7c154aed1b6865f3e4746f6d57ca87c2c01357ea9d9912c4
+  metadata.gz: d87857214e4e8fc700351d66eaf1c4858b8b3eff7149d00355abdfc7d2388f2a
+  data.tar.gz: d8ef37050bbdd23e0be3dd44f708b840033da928a6db157e7e73237cc4d2201c
 SHA512:
-  metadata.gz: dced56da054f6c842dc74cb2ac40baae325b2edea5645494fdadf6f3243259137e89fb32924f50052487c14d4d151944efc5d923ed1bef2698effb7f306c6357
-  data.tar.gz: 25b9619caf21f3e0e04561eed930839d2f599564e77ea194c43f76944a191220732851f8e6e961cf2da8a8568f9f5102b49751c1e866c021a224ed8fb34acd0c
+  metadata.gz: 8eafd322e156f87f867941204975a214686cb24fee1dbdd676e2a3b2d3ddb58ba596f04d27b35437eb9d3baf13456a0a0fc164fb34b60037c5cc351b405b0ffe
+  data.tar.gz: df1c293f18705b8eac7d46c8f3beac17f7d9fedd312a9fd2ab0f12a57c25d5af5ce9c0cc3b7523999a1072e2e0f6ee2b4e81e94921104e6f9da83ae0a0eef289

data/AI-BOM.md

@@ -0,0 +1,85 @@
+# AI Bill of Materials — random_name_generator
+
+_Last updated: 2026-07-19 · random_name_generator v4.0.2_
+
+An inventory of every AI component associated with this repository — development
+tools used to build it, AI-generated content shipped within it, and external AI
+services it integrates with (current or planned). Modeled on the SBOM concept
+applied to AI systems.
+
+**AI was first used in the `4.0.0` release.** Everything through the `3.x` line
+was authored without AI assistance.
+
+---
+
+## 1. Development Tools
+
+AI tools used to author this codebase. Not part of the shipped gem, but relevant
+to provenance.
+
+| Tool | Vendor | Role | Notes |
+|------|--------|------|-------|
+| Claude Code | Anthropic | AI coding assistant | Introduced in 4.0.0; drives the [`lang-gen`](./.claude/skills/lang-gen/SKILL.md) skill and general maintenance |
+
+---
+
+## 2. AI Audits
+
+Formal code reviews performed by AI models. Full reports in `docs/`.
+
+| Date | Model | Report | Version |
+|------|-------|--------|---------|
+| 2026-07-19 | Claude Fable 5 | [`docs/AUDIT_Fable_5.md`](./docs/AUDIT_Fable_5.md) | v4.0.2 |
+
+---
+
+## 3. AI-Generated Content
+
+Syllable data and tooling produced with AI assistance and shipped in the gem.
+All output was human-reviewed before commit.
+
+| Artifact | Type | Tool | Notes |
+|----------|------|------|-------|
+| [`lang-gen`](./.claude/skills/lang-gen/SKILL.md) | Claude Code skill | — | Generates a fully integrated language from a plain-English theme |
+| [German Curse](./lib/languages/experimental/german-curse.txt) (`GERMAN_CURSE`) | Language syllable file | `lang-gen` | Experimental; seeded from real roots, extended with invented syllables |
+| [Demonic](./lib/languages/experimental/demonic.txt) (`DEMONIC`) | Language syllable file | `lang-gen` | Experimental; completed from infernal-name source lists |
+| [Portable lang-gen prompt](./docs/superpowers/specs/2026-07-19-lang-gen-portable-prompt.md) | Text prompt | — | LLM-agnostic version of the skill |
+
+---
+
+## 4. Algorithms Implemented
+
+Generative logic built directly into the gem. **No machine-learning models and
+no external ML dependencies** — all name generation is deterministic,
+in-process, and driven by plain syllable-adjacency rules.
+
+| Algorithm | Location | Notes |
+|-----------|----------|-------|
+| Probabilistic syllable composition | `RandomNameGenerator::Generator` | Random prefix/middle/suffix assembly honoring `+v`/`+c`/`-v`/`-c` adjacency flags |
+| Syllable parsing / classification | `RandomNameGenerator::Syllable` | Parses each language-file line into a flagged syllable |
+
+This is a rules-based random generator, not an AI/ML system. It is listed here
+for completeness so the boundary between "AI-assisted authoring" and "AI at
+runtime" is explicit.
+
+---
+
+## 5. External AI Integrations
+
+random_name_generator ships **zero external AI service dependencies**. It makes
+no network calls and requires no API keys. None are planned.
+
+| Service | Type | Status |
+|---------|------|--------|
+| — | — | None (current or planned) |
+
+---
+
+## 6. References
+
+| Document | Purpose |
+|----------|---------|
+| [`docs/AUDIT_Fable_5.md`](./docs/AUDIT_Fable_5.md) | Full-codebase audit with empirically verified findings |
+| [`.claude/skills/lang-gen/SKILL.md`](./.claude/skills/lang-gen/SKILL.md) | The lang-gen language-generation skill |
+| [`README.md`](./README.md) | Project overview, including the lang-gen workflow |
+| [`docs/superpowers/specs/2026-07-19-lang-gen-portable-prompt.md`](./docs/superpowers/specs/2026-07-19-lang-gen-portable-prompt.md) | Paste-into-any-LLM version of the prompt |

data/Gemfile

@@ -7,14 +7,13 @@ gemspec
 
 gem "pry"
 gem "rake", "~> 13.4"
-gem "slop", "~> 4.10.1"
 
 group :development do
+  gem "logger" # logger leaves the default gems in Ruby 4.0; Reek (via dry-core) requires it implicitly.
   gem "reek"
   gem "rspec", "~> 3.12.0"
   gem "rubocop"
   gem "rubocop-rake", require: false
   gem "rubocop-rspec", require: false
-  # tsort left the default gems in Ruby 4.1; RuboCop requires it implicitly.
-  gem "tsort"
+  gem "tsort" # tsort left the default gems in Ruby 4.1; RuboCop requires it implicitly.
 end

data/Gemfile.lock

@@ -1,7 +1,8 @@
 PATH
   remote: .
   specs:
-    random_name_generator (4.0.2)
+    random_name_generator (4.0.4)
+      slop (~> 4.10)
 
 GEM
   remote: https://rubygems.org/
@@ -40,6 +41,7 @@ GEM
       zeitwerk (~> 2.6)
     json (2.7.2)
     language_server-protocol (3.17.0.3)
+    logger (1.7.0)
     method_source (1.1.0)
     parallel (1.26.3)
     parser (3.3.5.0)
@@ -100,6 +102,7 @@ PLATFORMS
   x86_64-linux
 
 DEPENDENCIES
+  logger
   pry
   rake (~> 13.4)
   random_name_generator!
@@ -108,7 +111,6 @@ DEPENDENCIES
   rubocop
   rubocop-rake
   rubocop-rspec
-  slop (~> 4.10.1)
   tsort
 
 BUNDLED WITH

data/README.md

@@ -4,6 +4,7 @@
 [![Build and Test](https://github.com/folkengine/random_name_generator/actions/workflows/ruby.yml/badge.svg)](https://github.com/folkengine/random_name_generator/actions/workflows/ruby.yml)
 [![Code Climate](https://codeclimate.com/github/folkengine/random_name_generator/badges/gpa.svg)](https://codeclimate.com/github/folkengine/random_name_generator)
 [![Inline docs](http://inch-ci.org/github/folkengine/random_name_generator.svg?branch=master)](http://inch-ci.org/github/folkengine/random_name_generator)
+[![AI BOM](https://img.shields.io/badge/AI--BOM-tracked-blueviolet)](./AI-BOM.md)
 
 Ruby port of
 [java-random-name-generator](https://github.com/folkengine/java-random-name-generator),
@@ -40,7 +41,7 @@ Or install it yourself as:
 generate a first and last name for you:
 
 ```shell
-$> exe/random_name_generator [-egrkfcxdß?]
+$> exe/random_name_generator [-egrkbfcxdß?]
 ```
 
 You can also install it so that it's instantly available to you:
@@ -58,12 +59,14 @@ RandomNameGenerator comes with several styles of syllable files:
 [Fantasy](https://github.com/folkengine/random_name_generator/blob/master/lib/languages/fantasy.txt),
 [Goblin](https://github.com/folkengine/random_name_generator/blob/master/lib/languages/goblin.txt),
 [Roman](https://github.com/folkengine/random_name_generator/blob/master/lib/languages/roman.txt),
+[Klingon](https://github.com/folkengine/random_name_generator/blob/master/lib/languages/klingon.txt),
+[Welsh](https://github.com/folkengine/random_name_generator/blob/master/lib/languages/welsh.txt),
 and
-[Klingon](https://github.com/folkengine/random_name_generator/blob/master/lib/languages/klingon.txt).
+[Belter](https://github.com/folkengine/random_name_generator/blob/master/lib/languages/belter.txt).
 By default it uses Fantasy. Instantiate RandomNameGenerator and then
 call compose on the object to generate a random name. If you don't pass
 in the number of syllables you want for your name to compose, it will
-randomly pick between 3 and 6.
+randomly pick between 2 and 5.
 
 ```ruby
 require 'random_name_generator'
@@ -152,9 +155,9 @@ https://github.com/folkengine/random_name_generator.
 This ships with a skill designed to work with [Claude Code](https://claude.com/claude-code) 
 and other LLMs under `.claude/skills/`.
 
-- [lang-gen](.claude/skills/lang-gen/SKILL.md) — Generate a new random_name_generator language from a free-text theme (e.g. "german curse words") — assembles flagged pre/mid/sur syllable collections, registers the File constant, adds a smoke spec and README entry, and samples names to verify.
+- [lang-gen](.claude/skills/lang-gen/SKILL.md): Generate a new random_name_generator language from a free-text theme (e.g. "german curse words"), assembles flagged pre/mid/sur syllable collections, registers the File constant, adds a smoke spec and README entry, and samples names to verify.
 
-There is also [a text version](docs/superpowers/specs/2026-07-19-lang-gen-portable-prompt.md) of the prompt that can be pasted into an LLM. 
+There is also [a text version](docs/superpowers/specs/2026-07-19-lang-gen-portable-prompt.md) of the prompt that can be pasted into an LLM.
 
 ### lang-gen
 

data/docs/AUDIT_Fable_5.md

@@ -0,0 +1,151 @@
+# random_name_generator Repository Audit — Claude Fable 5
+
+_Date:_ 2026-07-19
+_Repo:_ `random_name_generator` v4.0.2 (working tree, including the in-flight Demonic language and CLI additions)
+_Model:_ Claude Fable 5 (`claude-fable-5`)
+_Audit basis:_ Full codebase read + empirical verification — every defect below was reproduced with a live repro before being reported.
+
+> **Remediation:** all nine findings were fixed on 2026-07-19, immediately following
+> this audit, with regression specs added for each (suite grew from 61 to 168
+> examples). The findings below describe the codebase as audited.
+
+---
+
+## Executive Summary
+
+`random_name_generator` is a small, clean, dependency-light gem that does what it says: green test suite (61 examples, 0 failures), RuboCop clean at repo settings (11 files, no offenses), no runtime gem dependencies, and a simple two-class core (`Generator`, `Syllable`) that is easy to hold in your head.
+
+The audit found **3 high-severity defects** — one packaging, two runtime — and a cluster of medium/low issues concentrated in `Syllable`'s letter classification and error paths. None affect the happy path exercised by the specs, which is precisely why they have survived: the suite tests that names compose, not what happens at the edges.
+
+| # | Finding | Severity | Effort to fix |
+|---|---------|----------|---------------|
+| 1 | CLI requires `slop`, but the gemspec declares no runtime dependency on it | High | Low |
+| 2 | `compose(1)` crashes (`String#map`) despite documented single-syllable support | High | Low |
+| 3 | Unsatisfiable adjacency flags hang the process in an infinite loop | High | Medium |
+| 4 | Blank line in a language file crashes `Generator#refresh` | Medium | Low |
+| 5 | Documented `Syllable` clone constructor crashes | Medium | Low |
+| 6 | Cyrillic letters are in neither letter set — all flags in the four `-ru` files are silent no-ops | Medium | Medium |
+| 7 | Empty-syllable guard is doubly broken (unreachable + malformed `raise`) | Low | Low |
+| 8 | `y` classified as both vowel and consonant | Low | Low |
+| 9 | Documentation drift on syllable-count range (README vs code vs spec) | Low | Low |
+
+---
+
+## Scope and Method
+
+**Verified by direct read (complete files):**
+
+- `lib/random_name_generator.rb`
+- `lib/random_name_generator/syllable.rb`
+- `lib/random_name_generator/version.rb`
+- `exe/random_name_generator`
+- `spec/random_name_generator_spec.rb` and both spec fixture languages
+- `random_name_generator.gemspec`, `Gemfile`, `Rakefile`
+- `.github/workflows/ruby.yml`
+- All 13 language files (curated, `-ru`, and experimental)
+
+**Verified empirically:** every High/Medium finding was reproduced by executing the failing call under the bundle, including a `Timeout`-guarded repro for the infinite loop and a crafted two-line language file for the blank-line crash (which was also hit organically during this session, completing the WIP `demonic.txt`).
+
+**Health signals:**
+
+- `bundle exec rspec`: **61 examples, 0 failures**
+- `bundle exec rubocop`: **11 files inspected, no offenses**
+- `bundle exec rake` (default: spec + rubocop): green
+- Runtime dependencies: none declared (see Finding 1 for the catch)
+
+---
+
+## Findings
+
+### 1. Missing runtime dependency: the installed CLI cannot start (High)
+
+`exe/random_name_generator` line 6 does `require "slop"`, but `slop` is declared only in the **Gemfile** (`gem "slop", "~> 4.10.1"`), which end users never see. The gemspec's dependency section is an empty template comment.
+
+Consequence: after `gem install random_name_generator`, running `random_name_generator` raises `LoadError: cannot load such file -- slop` on any machine that doesn't coincidentally have slop installed. Every CI run and local dev invocation goes through Bundler, so this is invisible to the test suite by construction.
+
+**Fix (low effort):** add `spec.add_dependency "slop", "~> 4.10"` to the gemspec and remove it from the Gemfile.
+
+### 2. `compose(1)` crashes despite documented support (High)
+
+`syllable.rb`'s header documentation states: *"In case of 1 syllable, name will be chosen from amongst the prefixes."* The code disagrees:
+
+- `Generator#compose_array` (`lib/random_name_generator.rb:89`) returns a **String** (`@pre.to_s.capitalize`) when `count < 2`, an Array otherwise.
+- `Generator#compose` (`lib/random_name_generator.rb:97`) unconditionally calls `.map` on that result.
+
+Repro: `RandomNameGenerator.new(ELVEN).compose(1)` → `NoMethodError: undefined method 'map' for an instance of String`.
+
+The type-splitting return also makes `compose_array(1)` a misnomer — callers get a String from a method named `_array`. **Fix:** have `compose_array` return `[@pre]` for `count < 2`; both bugs disappear and the return type becomes honest.
+
+### 3. Unsatisfiable flag combinations hang the process (High)
+
+`Generator#determine_next_syllable` (`lib/random_name_generator.rb:126-133`) is a bare `loop` that resamples until it draws a compatible syllable. If **no** syllable in the target bucket is compatible, it spins forever.
+
+Repro (hangs, killed by timeout): a language whose only prefix is `-ba +v` (next must start with a vowel) and whose only suffix is `+kar`. Since the README explicitly invites users to supply their own syllable files, this is reachable input, not just an authoring mistake — one bad file freezes the host application with no diagnostic.
+
+**Fix (medium effort):** track attempts (or pre-filter the bucket by compatibility) and raise a descriptive error when no compatible syllable exists.
+
+### 4. Blank lines in language files crash loading (Medium)
+
+`Generator#refresh` (`lib/random_name_generator.rb:138`) guards with `line.empty?`, but lines from `readlines` retain `"\n"`, so the guard never fires; `Syllable#parse_args` then splits the whitespace-only string into `[]` and calls `nil.empty?` (`syllable.rb:137`) → `NoMethodError`.
+
+This is not hypothetical: the committed WIP `demonic.txt` used blank lines as bucket separators and crashed on load — likely part of why that file sat unfinished. **Fix:** `line.strip.empty?` in `refresh` (one word), or skip whitespace-only lines in `Syllable`.
+
+### 5. Documented `Syllable` clone constructor crashes (Medium)
+
+The `Syllable` header advertises `Syllable.new(syllable)` as a cloning idiom, and `initialize` has an explicit `args.is_a?(Syllable)` branch for it (`syllable.rb:56-60`). But line 49 — `@raw = args.strip` — executes first, and `Syllable` defines no `strip`.
+
+Repro: `Syllable.new(Syllable.new("-foo +c"))` → `NoMethodError: undefined method 'strip' for an instance of RandomNameGenerator::Syllable`. The clone path is dead code; nothing in the gem or specs exercises it. **Fix:** `@raw = args.to_s.strip` (Syllable already implements `to_s`), plus a spec.
+
+### 6. Adjacency flags are silent no-ops for Cyrillic (Medium)
+
+`Syllable::VOWELS` and `CONSONANTS` (`syllable.rb:45-46`) contain only Latin/IPA characters. For a Cyrillic syllable, `vowel_first?`, `consonant_first?`, `vowel_last?`, and `consonant_last?` are all **false** (verified: `-анг` reports neither vowel- nor consonant-final).
+
+Consequence: in `next_incompatible?`/`previous_incompatible?`, nothing can ever be incompatible, so every `+v/+c/-v/-c` flag in the four `-ru` language files — and all four carry them — is dead weight. Names still generate; they just ignore constraints the language authors wrote, silently. **Fix:** add Cyrillic vowels (а е ё и о у ы э ю я) and consonants to the sets, or classify by Unicode-aware rules.
+
+### 7. The empty-syllable guard is doubly broken (Low)
+
+`syllable.rb:137`: `raise ArgumentError "Empty String is not allowed." if syll.empty?`
+
+- **Unreachable as intended:** an empty or whitespace input produces `args[0] == nil`, so `syll.empty?` raises `NoMethodError` on `nil` before the guard can act (this is the crash surfacing in Findings 4 and the `Syllable.new("")` repro).
+- **Malformed if it were reached:** the missing comma means `ArgumentError "…"` is parsed as a method call, which would itself raise `NoMethodError`, not the intended `ArgumentError`.
+
+**Fix:** `raise ArgumentError, "…" if syll.nil? || syll.empty?`.
+
+### 8. `y` is both a vowel and a consonant (Low)
+
+`y` appears in both letter sets, so `+v` and `+c` flags each accept y-initial syllables. Linguistically defensible for a semivowel, but it's undocumented and asymmetric (no other letter is dual-classified). Worth a comment if intentional.
+
+### 9. Documentation drift on syllable counts (Low)
+
+Three sources disagree with the code (`pick_number_of_syllables` samples from a weighted 2–5 distribution):
+
+- README: "it will randomly pick between 3 and 6"
+- Module doc in `random_name_generator.rb`: "between 2 and 5" ✓ (correct)
+- Spec title: "returns an integer between 1 and 6" (assertion actually checks 1..5)
+
+Also cosmetic: the CLI help text spells "syllable" as "eyllable" in four option descriptions.
+
+---
+
+## Test Coverage Assessment
+
+The suite is a smoke suite: it proves every bundled language loads and composes, and that syllable counts come out right. It does **not** cover:
+
+- Adjacency-flag semantics (no spec would catch Finding 6 — the flags could be deleted entirely and the suite stays green)
+- Any error path (Findings 2, 4, 5, 7 are all crashes in paths with zero coverage)
+- The CLI (`exe/` has no test at all; Finding 1 ships silently)
+
+The fixture languages (`test-micro.txt`, `test-tiny.txt`) are well-designed for flag testing — `test-tiny.txt` deliberately exercises every flag combination — but no assertion actually inspects flag behavior.
+
+---
+
+## Recommendations (priority order)
+
+1. **Gemspec:** declare the `slop` runtime dependency. One line; unbreaks the installed CLI.
+2. **`compose_array`:** return `[@pre]` for `count < 2`. Fixes `compose(1)` and the return-type lie.
+3. **`refresh`:** strip lines before the empty check. Fixes blank-line crashes and makes hand-authored files forgiving.
+4. **`determine_next_syllable`:** bound the retry loop with a clear error. Turns a hang into a diagnosis.
+5. **Letter sets:** add Cyrillic ranges so the `-ru` flags do what their authors intended; add a flag-behavior spec pinned to `test-tiny.txt`.
+6. **Cleanups:** fix the `raise` syntax and clone constructor, correct the README/spec-title ranges, fix "eyllable".
+
+None of these threaten the gem's architecture, which is sound for its size. The pattern across all findings is the same: the edges were never walked. A dozen targeted specs would lock in every fix above.

data/exe/random_name_generator

@@ -8,10 +8,11 @@ require "slop"
 lang = RandomNameGenerator::FANTASY
 
 opts = Slop.parse do |o|
-  o.bool "-e", "--elven", "Use Elven eyllable file"
-  o.bool "-g", "--goblin", "Use Goblin eyllable file"
-  o.bool "-r", "--roman", "Use Roman eyllable file"
-  o.bool "-k", "--klingon", "Use Klingon eyllable file"
+  o.bool "-e", "--elven", "Use Elven syllable file"
+  o.bool "-g", "--goblin", "Use Goblin syllable file"
+  o.bool "-r", "--roman", "Use Roman syllable file"
+  o.bool "-k", "--klingon", "Use Klingon syllable file"
+  o.bool "-b", "--belter", "Use Belter syllable file"
   o.bool "-f", "--flipmode", "Flip mode in effect"
   o.bool "-c", "--cyrillic", "Use Cyrillic mode"
   o.bool "-x", "--xrated", "Generate Curse words [NEEDS WORK]"
@@ -30,6 +31,7 @@ else
   lang = RandomNameGenerator::GOBLIN if opts.goblin?
   lang = RandomNameGenerator::ROMAN if opts.roman?
   lang = RandomNameGenerator::KLINGON if opts.klingon?
+  lang = RandomNameGenerator::BELTER if opts.belter?
   lang = RandomNameGenerator::CURSE if opts.xrated?
   lang = RandomNameGenerator::DEMONIC if opts.demonic?
   lang = RandomNameGenerator::GERMAN_CURSE if opts.german_curse?

data/lib/languages/belter.txt

@@ -0,0 +1,102 @@
+-bel
+-ber
+-bos
+-che
+-da +c
+-du
+-fel
+-gut
+-im
+-ka
+-kep
+-ko
+-kop
+-kow
+-mal
+-mi +c
+-nak
+-oye
+-pash
+-pel
+-pom
+-sa +c
+-sab
+-sha
+-shu
+-ta
+-teng
+-tich
+-to
+-tu
+-wel
+-xa
+-xi
+-ya +c
+-ze
+al
+ang
+at
+be
+da
+deng
+do
+eng
+ere -c
+ga
+im -c
+ka
+ken
+la
+lom
+low
+lu
+ma
+mang
+mi
+na
+nga
+ok
+ol
+pa
+ra
+sa
+se
+sha
+shi
+ta
+teng
+ti
+to
+tu
+un
+wa
+we
+xa
+ya
++a -c
++ang
++atna
++da
++deng
++eng -c
++im -c
++ing
++kang
++lowda
++mang
++na
++nya
++owda -c
++pa
++ra
++sa
++shang
++ta
++teng
++tim
++to
++tu
++wa
++wala
++xa
++ya

data/lib/languages/welsh.txt

@@ -0,0 +1,91 @@
+-ang +c
+-bled
+-bran
+-bryn
+-cad
+-caer
+-car
+-cyn
+-del
+-dyf
+-dyl
+-eir
+-em +c
+-ffion
+-gar
+-ger
+-gla +c
+-glyn
+-gru +c
+-gwen
+-gwyn
+-hedd
+-idr +v
+-llan
+-llew
+-mab
+-mor
+-myr +c
+-ol +c
+-ow +v
+-rhi +c
+-rhos
+-rhys
+-tal
+-tre +c
+a -c
+ad
+ael
+af
+an
+ar
+aw
+del
+dwr
+ed
+el
+ell
+en
+er
+es
+gar
+goll
+gwa
+ha
+i -c
+ian
+lan
+lod
+lyn
+mai
+o -c
+on
+rhy
+ron
+si
+wal
+wy
++ain -c
++aint -c
++an
++ddyn -v
++dwr
++dydd
++dys
++ed -c
++ell -c
++eth
++in
++ion
++lys
++og -c
++on
++rad
++ri
++rys
++ur -c
++wen
++wyn
++wyr
++ydd -c
++ys

data/lib/random_name_generator/syllable.rb

@@ -42,10 +42,15 @@ module RandomNameGenerator
   class Syllable
     attr_reader :raw, :syllable, :next_syllable_requirement, :previous_syllable_requirement
 
-    VOWELS = %w[i y ɨ ʉ ɯ u ɪ ʏ ʊ ɯ ʊ e ø ɘ ɵ ɤ o ø ə ɵ ɤ o ɛ œ ɜ ɞ ʌ ɔ æ ɐ ɞ a ɶ ä ɒ ɑ].freeze
-    CONSONANTS = %w[b ɓ ʙ β c d ɗ ɖ ð f g h j k l ł m ɱ n ɳ p q r s t v w x y z].freeze
+    # "y" appears in both sets deliberately: as a semivowel it satisfies
+    # either a +v or a +c adjacency requirement.
+    VOWELS = %w[i y ɨ ʉ ɯ u ɪ ʏ ʊ ɯ ʊ e ø ɘ ɵ ɤ o ø ə ɵ ɤ o ɛ œ ɜ ɞ ʌ ɔ æ ɐ ɞ a ɶ ä ɒ ɑ ö ü
+                а е ё и о у ы э ю я].freeze
+    CONSONANTS = %w[b ɓ ʙ β c d ɗ ɖ ð f g h j k l ł m ɱ n ɳ p q r s t v w x y z ß
+                    б в г д ж з й к л м н п р с т ф х ц ч ш щ ь].freeze
 
     def initialize(args)
+      args = args.raw if args.is_a?(Syllable)
       @raw = args.strip
       @syllable = ""
       @is_prefix = false
@@ -53,11 +58,7 @@ module RandomNameGenerator
       @next_syllable_requirement = :letter
       @previous_syllable_requirement = :letter
 
-      if args.is_a?(Syllable)
-        parse_args(args.raw)
-      else
-        parse_args(args)
-      end
+      parse_args(args)
     end
 
     def incompatible?(next_syllable)
@@ -134,7 +135,7 @@ module RandomNameGenerator
     end
 
     def parse_syllable(syll)
-      raise ArgumentError "Empty String is not allowed." if syll.empty?
+      raise ArgumentError, "Empty String is not allowed." if syll.to_s.empty?
 
       captures = /([+-]?)(.+)/.match(syll).captures
       parse_prefix(captures[0])

data/lib/random_name_generator/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RandomNameGenerator
-  VERSION = "4.0.2"
+  VERSION = "4.0.4"
 end

data/lib/random_name_generator.rb

@@ -31,7 +31,9 @@ module RandomNameGenerator
   GOBLIN_RU = File.new("#{dirname}/languages/goblin-ru.txt")
   ROMAN_RU = File.new("#{dirname}/languages/roman-ru.txt")
 
+  BELTER = File.new("#{dirname}/languages/belter.txt")
   KLINGON = File.new("#{dirname}/languages/klingon.txt")
+  WELSH = File.new("#{dirname}/languages/welsh.txt")
 
   # Experimental
   CURSE = File.new("#{dirname}/languages/experimental/curse.txt")
@@ -87,7 +89,7 @@ module RandomNameGenerator
     # Returns the composed name as an array of Syllables.
     def compose_array(count = RandomNameGenerator.pick_number_of_syllables)
       @pre = pre_syllables.sample(random: @rnd)
-      return @pre.to_s.capitalize if count < 2
+      return [@pre] if count < 2
 
       name = determine_middle_syllables(count - 2, @pre)
       name << determine_last_syllable(name.last)
@@ -125,18 +127,18 @@ module RandomNameGenerator
     end
 
     def determine_next_syllable(this_syllable, sampler)
-      next_syllable = ""
-      loop do
-        next_syllable = sampler.sample(random: @rnd)
-        break unless this_syllable.incompatible?(next_syllable)
+      candidates = sampler.select { |syllable| this_syllable.compatible?(syllable) }
+      if candidates.empty?
+        raise ArgumentError,
+              "No syllable in #{@language.path} is compatible with \"#{this_syllable}\" — check its +v/+c/-v/-c flags"
       end
-      next_syllable
+      candidates.sample(random: @rnd)
     end
 
     # Loops through the language file, and pushes each syllable into the correct array.
     def refresh
       @language.readlines.each do |line|
-        push(RandomNameGenerator::Syllable.new(line)) unless line.empty?
+        push(RandomNameGenerator::Syllable.new(line)) unless line.strip.empty?
       end
       @language.rewind
     end

data/random_name_generator.gemspec

@@ -28,8 +28,9 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  # Uncomment to register a new dependency of your gem
-  # spec.add_dependency "example-gem", "~> 1.0"
+  # The CLI in exe/ parses its options with slop, so it must ship as a
+  # runtime dependency — a Gemfile entry is invisible to installed gems.
+  spec.add_dependency "slop", "~> 4.10"
 
   # For more information and examples about making a new gem, checkout our
   # guide at: https://bundler.io/guides/creating_gem.html

metadata

@@ -1,15 +1,28 @@
 --- !ruby/object:Gem::Specification
 name: random_name_generator
 version: !ruby/object:Gem::Version
-  version: 4.0.2
+  version: 4.0.4
 platform: ruby
 authors:
 - folkengine
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-19 00:00:00.000000000 Z
-dependencies: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: slop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.10'
 description: Generates random names based upon custom collections of syllables. Styles
   include Elvish, Fantasy, Goblin, and Roman.
 email:
@@ -29,6 +42,7 @@ files:
 - ".rspec"
 - ".rubocop.yml"
 - ".tool-versions"
+- AI-BOM.md
 - CHANGELOG.md
 - Gemfile
 - Gemfile.lock
@@ -39,10 +53,12 @@ files:
 - bin/run
 - bin/setup
 - config.reek
+- docs/AUDIT_Fable_5.md
 - docs/superpowers/plans/2026-07-18-lang-gen-skill.md
 - docs/superpowers/specs/2026-07-18-lang-gen-skill-design.md
 - docs/superpowers/specs/2026-07-19-lang-gen-portable-prompt.md
 - exe/random_name_generator
+- lib/languages/belter.txt
 - lib/languages/elven-ru.txt
 - lib/languages/elven.txt
 - lib/languages/experimental/curse.txt
@@ -55,6 +71,7 @@ files:
 - lib/languages/klingon.txt
 - lib/languages/roman-ru.txt
 - lib/languages/roman.txt
+- lib/languages/welsh.txt
 - lib/random_name_generator.rb
 - lib/random_name_generator/syllable.rb
 - lib/random_name_generator/version.rb
@@ -67,7 +84,6 @@ metadata:
   homepage_uri: https://github.com/folkengine/random_name_generator
   source_code_uri: https://github.com/folkengine/random_name_generator
   changelog_uri: https://github.com/folkengine/random_name_generator/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -82,8 +98,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Random Name Generator
 test_files: []