bacon-tracker 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69adddc52e57d700e447f7090e300ff58cf74c3ca9881eb54c19b488f39222d7
-  data.tar.gz: 5efcc62978f6d2aeb3689649298956be52ab3fba0bef0ac3ae55603c2afc584f
+  metadata.gz: 3745eb09dd23fb800b9cccac6561f493e68e732fc03a3a58c4c2b5e30ccc424c
+  data.tar.gz: c8d4a8b7b14f29d9217e28102480d5304e90d7199a1127c577837ff253306150
 SHA512:
-  metadata.gz: 202a6ab1a3974e6a303d6571500c230a968114e85003db38c9206908701a51472566f01523637ee032507a1d060df5c2b1272dec001d0a4b76275d64c374628a
-  data.tar.gz: 9c33747da78d15551c351a884c81ff3a1ef1284079fc6dd627d0284ec6fada9f5ba3f4ec3586f06bf6a56ac958e87a63b066d0a303b7445d60a94f8572b88487
+  metadata.gz: 4a534b8159e6d1498bf9a1cceb51198714bbdc426448d1df087e9b2b51727e723d6874eba65cd9f2175c7e7b513a01ebb5b4144edcddcc08b68e626c076da0f3
+  data.tar.gz: a2f9f2594a12b8fbaaf58f25052553fbf9d84075dcd90697960656204f7580918fa717edd96df8fc31fba532ecd9e568dd39a3a847c0b5f27101a70f576349cf

data/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented here.
 Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), [Semantic Versioning](https://semver.org/).
 
+## [1.1.0] - 2026-10-01
+
+### Changed
+
+- Filename slugs spell out `ä`, `ö`, `ü`, `ß` as `ae`, `oe`, `ue`, `ss` and drop accents from other letters, so "Datenschutzerklärung" becomes `datenschutzerklaerung` instead of `datenschutzerkl-rung`. Existing files keep their names until the story is retitled.
+- A title with nothing the slug rule keeps (all-CJK, all-punctuation) now slugs to `non-latin-REPLACE-ME` instead of `untitled`, for story files, decision records and dashboard project slugs alike. The dashboard used to get an empty project slug in that case.
+
+### Fixed
+
+- Story titles on the board and in the API now come from the in-file `Title:`/`Feature:` line, so umlauts, dots and capitals survive. They were humanized from the filename slug, which keeps only ASCII letters and digits ("Datenschutzerklärung" showed as "datenschutzerkl rung", "bybacon.com" as "bybacon com"). The slug remains the fallback when the line is missing.
+
 ## [1.0.0] - 2026-09-25
 
 First public release.

data/lib/bacon_tracker/commands/tracker.md

@@ -105,7 +105,7 @@ type must be `feature`, `bug`, or `chore`. The title is everything after the typ
 1. Determine N: read the integer from `$TRACKER_ROOT/.next-id`, then **floor it above the highest `<NS>-NNN` already on disk** (`N = max(read, highest + 1)`). A stale `.next-id` from a merge or hand edit must never reissue an existing ID. When `rake` is available, prefer `rake story:<type>['title',field=…]`, which allocates the ID atomically (with this floor, under a file lock).
 2. Write `N+1` back to `.next-id`
 3. Pad N to 3 digits: `NNN`
-4. Slugify the title: lowercase it, turn each run of characters that aren't `a-z` or `0-9` into a single hyphen, and trim hyphens from both ends. If nothing is left, the slug is `untitled`
+4. Slugify the title: spell out `ä`/`ö`/`ü`/`ß` as `ae`/`oe`/`ue`/`ss`, drop accents from other letters (`é` → `e`), lowercase it, turn each run of characters that aren't `a-z` or `0-9` into a single hyphen, and trim hyphens from both ends. If nothing is left, the slug is `non-latin-REPLACE-ME`
 5. Extension: `.feature` for features, `.md` for bugs and chores
 6. Create `$TRACKER_ROOT/<plural-type>/1_icebox/<NS>-<NNN>-<slug>.<ext>` (e.g. `features/1_icebox/...`). The body is the type's `_template.feature` / `_template.md` if one exists, with the title filled in (`Feature: <title>`, or `Title: <title>` on the first line for `.md`). Write frontmatter **in the file's format**: for `.md`, a YAML block `---` / `id: <NS>-<NNN>` / `type: <type>` / `status: icebox` / `---`; for `.feature`, comment-style header lines `# id: <NS>-<NNN>` / `# type: <type>` / `# status: icebox`. (A `.feature` file is parsed by its `# key:` lines **or** a leading YAML `---` block if one is present - but a file mixes only one style, so match the sibling files in the same tracker rather than introducing the other.)
 7. If any `field=value` tokens were given, set them in the frontmatter (same rules as `edit`)
@@ -183,7 +183,7 @@ Display a story's content:
 
 1. `find $TRACKER_ROOT -name "${ID}-*"` to locate the file
 2. Read it, strip the frontmatter block
-3. Print: ID, type, stage, title (humanised from filename), any set metadata fields, then body
+3. Print: ID, type, stage, title (the `Title:`/`Feature:` line; humanised from the filename if that line is missing), any set metadata fields, then body
 
 ```
 APP-003 - implement user auth
@@ -264,6 +264,6 @@ Report each finding with the ID and file path, or confirm all checks pass. Don't
 
 - Expand `~` in any paths using shell: `eval echo <path>` or `realpath`.
 - When editing frontmatter, match the existing format (comment-style for `.feature`, YAML for `.md`).
-- Slugify: `echo "$TITLE" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//'` - and use `untitled` if the result is empty
+- Slugify: `echo "$TITLE" | sed 's/ä/ae/g; s/ö/oe/g; s/ü/ue/g; s/ß/ss/g; s/Ä/Ae/g; s/Ö/Oe/g; s/Ü/Ue/g' | perl -CS -MUnicode::Normalize -pe '$_ = NFKD($_); s/\p{Mn}//g' | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//'` - and use `non-latin-REPLACE-ME` if the result is empty
 - `backlog.md` line format: `- <NS>-NNN <title>` (leading dash, single space - exactly what the gem writes; the stats and next-task parsers depend on it). Preserve this when adding/removing entries.
 - Keep output concise - one line per story, full content only for `show`.

data/lib/bacon_tracker/dashboard.rb

@@ -136,11 +136,15 @@ module BaconTracker
         return nil
       end
 
+      # A name with nothing the slug rule keeps gets the EMPTY_SLUG placeholder
+      # as its route (never an empty "/projects/"), but a namespace must not be
+      # guessed from it: stories are matched by "<NS>-NNN", so an explicit
+      # 'namespace:' is required.
       slug      = BaconTracker.slugify(item[:name])
-      namespace = item[:attrs]['namespace'] || slug.upcase.gsub('-', '_')
+      namespace = item[:attrs]['namespace'] || (slug == BaconTracker::EMPTY_SLUG ? '' : slug.upcase.gsub('-', '_'))
       if namespace.empty?
         warn "[BaconTracker] dashboard.md: skipping project #{item[:name].inspect} - " \
-             "empty namespace (its name has no letters/digits; add an explicit 'namespace:')"
+             "no usable namespace (its name has no letters/digits; add an explicit 'namespace:')"
         return nil
       end
 

data/lib/bacon_tracker/version.rb

@@ -1,3 +1,3 @@
 module BaconTracker
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

data/lib/bacon_tracker.rb

@@ -170,11 +170,32 @@ module BaconTracker
     @config || configure
   end
 
+  # German letters have a spelled-out ASCII form that readers expect in a
+  # filename ("datenschutzerklaerung", not "datenschutzerkl-rung"); every
+  # other accented letter loses its mark via NFKD decomposition (é -> e).
+  TRANSLITERATIONS = {
+    'ä' => 'ae', 'ö' => 'oe', 'ü' => 'ue', 'ß' => 'ss',
+    'Ä' => 'Ae', 'Ö' => 'Oe', 'Ü' => 'Ue', 'ẞ' => 'SS'
+  }.freeze
+
+  # What slugify returns when nothing of the title survives the ASCII rule
+  # (all-CJK, all-punctuation). Never "": an empty slug makes a dangling
+  # "<id>-.md" that is not a record (BT-095) and a dashboard route of
+  # "/projects/". The placeholder says what happened and asks for a hand-picked
+  # slug; the real title stays in the file's Title:/Feature: line.
+  EMPTY_SLUG = 'non-latin-REPLACE-ME'
+
   # Filesystem-safe slug from a human title - the single source shared by
   # Core (story filenames) and Dashboard (project slugs) so the two can never
-  # drift apart.
+  # drift apart. ASCII-only: the German letters are transliterated, other
+  # accents stripped, and whatever is still not [a-z0-9] becomes a hyphen.
+  # Never empty - see EMPTY_SLUG.
   def self.slugify(title)
-    title.downcase.gsub(/[^a-z0-9]+/, '-').gsub(/\A-|-\z/, '')
+    slug = title.to_s
+                .gsub(/[äöüßÄÖÜẞ]/, TRANSLITERATIONS)
+                .unicode_normalize(:nfkd).gsub(/\p{Mn}/, '')
+                .downcase.gsub(/[^a-z0-9]+/, '-').gsub(/\A-|-\z/, '')
+    slug.empty? ? EMPTY_SLUG : slug
   end
 
   class Core
@@ -313,16 +334,6 @@ module BaconTracker
       BaconTracker.slugify(title)
     end
 
-    # A non-empty slug for a filename. slugify keeps only [a-z0-9], so a title
-    # with no ASCII alphanumerics (all-CJK, all-punctuation) slugs to "" - fall
-    # back to 'untitled' so the file is "<id>-untitled.ext", not a dangling
-    # "<id>-.ext" with a blank humanized name (BT-095). The real title stays in
-    # the file's Title:/Feature: line.
-    def filename_slug(title)
-      slug = slugify(title)
-      slug.empty? ? 'untitled' : slug
-    end
-
     def story_dirs
       STORY_DIRS.flat_map do |dir, meta|
         STAGES.map do |stage|
@@ -404,6 +415,17 @@ module BaconTracker
       base.sub(/\A#{id_pattern}-/, '').gsub('-', ' ')
     end
 
+    # The in-file title: the "Feature:" line of a .feature, the "Title:" line
+    # of a .md. The filename slug is ASCII-only, so a humanized slug loses
+    # umlauts, dots and case ("Datenschutzerklärung" shows as
+    # "datenschutzerklaerung"); the in-file line is the title as typed. nil when
+    # the line is missing or blank, so callers fall back to the slug.
+    def story_title(body, ext)
+      line  = ext == '.feature' ? /^Feature:[ \t]*(.*)$/ : /^Title:[ \t]*(.*)$/
+      title = body[line, 1]&.strip
+      title unless title.nil? || title.empty?
+    end
+
     # Delegates to set_frontmatter_field: the substitution stays scoped to the
     # frontmatter block (a body line like "status: healthy" is never touched)
     # and a missing status field is added instead of silently skipped.
@@ -1324,7 +1346,7 @@ module BaconTracker
       with_decisions_lock do
         heal_proposed!
         id   = format_decision_id(consume_decision_id)
-        slug = filename_slug(title) # never "<id>-.md", which is not a record
+        slug = slugify(title) # never "<id>-.md", which is not a record (EMPTY_SLUG)
         template_path = File.join(root, '_template.md')
         body = File.exist?(template_path) ? File.read(template_path, encoding: 'utf-8') : Templates::DECISION
         today = Date.today.iso8601
@@ -1660,7 +1682,7 @@ module BaconTracker
       subtasks = subtask_counts(body, ext)
 
       { id: id, type: dir_meta[:type], stage: dir_meta[:stage], dir: dir_meta[:dir],
-        path: path, title: humanize_slug(path), body: body, size: size,
+        path: path, title: story_title(body, ext) || humanize_slug(path), body: body, size: size,
         blocked_by: blocked_by, linked_to: linked_to, assignee: assignee, subtasks: subtasks,
         # Body-line addresses of the subtasks - the client renders/toggles by
         # these instead of re-deriving fence rules (the BT-049 drift class).
@@ -1851,7 +1873,7 @@ module BaconTracker
       with_lock do
         id_num = consume_id
         id     = format_id(id_num)
-        slug   = filename_slug(title)
+        slug   = slugify(title)
 
         filename = "#{id}-#{slug}#{ext}"
         dest_dir = File.join(@config.tracker_root, dir, stage)
@@ -1975,7 +1997,7 @@ module BaconTracker
 
       if title || body || !size.nil? || !blocked_by.nil? || !linked_to.nil? || !assignee.nil?
         atomic_write(path, content)
-        new_path = title ? File.join(File.dirname(path), "#{id}-#{filename_slug(title)}#{ext}") : path
+        new_path = title ? File.join(File.dirname(path), "#{id}-#{slugify(title)}#{ext}") : path
         if path != new_path
           FileUtils.mv(path, new_path)
           path = new_path

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bacon-tracker
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Alex Berger