bacon-tracker 1.1.0 → 1.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3745eb09dd23fb800b9cccac6561f493e68e732fc03a3a58c4c2b5e30ccc424c
-  data.tar.gz: c8d4a8b7b14f29d9217e28102480d5304e90d7199a1127c577837ff253306150
+  metadata.gz: 322d2ee34076ea624f44901ff5f2a67ced37ddc3e0d0677ead1cf40c39fc4a94
+  data.tar.gz: 1501ba1a4b4aea4e4cd7d6c7e3e8e8bb565e4b99d18624765e06e374e2982dc2
 SHA512:
-  metadata.gz: 4a534b8159e6d1498bf9a1cceb51198714bbdc426448d1df087e9b2b51727e723d6874eba65cd9f2175c7e7b513a01ebb5b4144edcddcc08b68e626c076da0f3
-  data.tar.gz: a2f9f2594a12b8fbaaf58f25052553fbf9d84075dcd90697960656204f7580918fa717edd96df8fc31fba532ecd9e568dd39a3a847c0b5f27101a70f576349cf
+  metadata.gz: 6a3ea03b467fb292aec46df928970edf1949b21aa6f8cf1a5d8c76b6426ebc931bec202a07a02985c83620d369aea37e45a21eff7b0f373d80d0a9b0b3bea899
+  data.tar.gz: ead2444ec10dd2fd5d16f22e1c243b9f98de2b0b614db513b08d5e7b92cf92e5403b782bbc55841f999b0c9c42f89ba1a0c7f8359c58d7f8d481f37850b201ae

data/CHANGELOG.md

@@ -3,6 +3,24 @@
 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.2] - 2026-10-23
+
+### Fixed
+
+- Docs pages and decision records no longer all show "could not load" after the first page with a fenced code block. kramdown required Rouge to highlight the block whenever Rouge was installed, and Rouge loaded a second copy of `strscan`, which broke every markdown render after it until the server restarted. Code blocks are now rendered plain, without a syntax highlighter, which is how the page already showed them.
+
+## [1.1.1] - 2026-10-21
+
+### Fixed
+
+- `rake story:commit` (and every other path that adds a line to `backlog.md`) writes the story's own title to the line, the same one the board shows, instead of the humanized filename slug. The slug is the fallback only when the file has neither a title line nor an opening heading. Retitling a committed story rewrites its line even when the filename does not change. `stats.next_task` follows.
+- `rake story:lint` reports a `backlog.md` line whose title is not the story's (`title-drift`), on the line in `backlog.md`, and fails on it - the same comparison the shared CI lint makes, so the local check and CI agree on the same tree.
+- A story created from a `_template.md` or `_template.feature` that starts with a header block of its own (`id`, `type`, `status` with a placeholder id) now has exactly one header and the title as typed. It used to carry both headers, the template's placeholder id and the template's placeholder title; the typed title reached only the filename. The title is filled into the template's first `Title:`/`Feature:` line wherever it sits, and a template without one gets the line added. `rake story:lint` points out such a template (`template-header`) as a notice, so the project can drop the block.
+- `rake story:feature|bug|chore` with an unknown `size=` (say `XS`) is refused before a story is created, like the API and the board already were. It used to create the story, spend its number, and only then report "could not set fields", leaving an unsized story behind. One list of sizes (`S`, `M`, `L`) now backs creating, editing, showing and linting.
+- `rake story:lint` reports a story whose file carries a size the tracker does not know (`unknown-size`), naming the story and its `size:` line. It is a notice, not a failure: the board shows such a story without a size, and old files are not made to be swept. With `LINT_FORMAT=github` it is a `::notice` annotation.
+- A bug or chore with no `Title:` line that opens with a markdown heading now takes the heading as its title on the board, the dashboard and the API, the way decision records do. It used to fall back to the humanized filename slug, which loses dashes, punctuation, capitals and umlauts ("# Fix the Ä-key — today" showed as "fix the ae key today"). Retitling such a story rewrites the heading. The slug remains the fallback when there is neither.
+
 ## [1.1.0] - 2026-10-01
 
 ### Changed

data/lib/bacon_tracker/commands/tracker.md

@@ -107,7 +107,7 @@ type must be `feature`, `bug`, or `chore`. The title is everything after the typ
 3. Pad N to 3 digits: `NNN`
 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.)
+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 into its first `Feature:` / `Title:` line (add the line at the top if the template has none). If the template itself starts with a header block (`---` … `---`, or `# id:` lines), leave that block out - the new story gets exactly one header, written next. 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`)
 8. Confirm the new ID and file path
 
@@ -122,7 +122,7 @@ Move a story from icebox → backlog (committing to do it).
 1. Find the file: `find $TRACKER_ROOT -path "*/1_icebox/${ID}-*"`
 2. `mv` it to the corresponding `2_backlog/` directory
 3. Update `status:` in the frontmatter to `backlog`
-4. Append `- <ID> <title>` to `backlog.md`, where the title is the filename slug with hyphens as spaces (bottom = lowest priority, unless user specifies a position)
+4. Append `- <ID> <title>` to `backlog.md`, where the title is the story's own: its `Title:`/`Feature:` line, or the opening `#` heading of a `.md` without one, or the filename slug with hyphens as spaces when there is neither (bottom = lowest priority, unless user specifies a position)
 5. Confirm new stage
 
 ---
@@ -158,7 +158,7 @@ Update story fields in place. Fields: `title`, `size` (S/M/L), `assignee` (initi
 
 1. Find the file: `find $TRACKER_ROOT -name "${ID}-*"`
 2. Frontmatter fields: update the existing line, or add it if missing - matching the file's format (comment-style for `.feature`, YAML for `.md`). An empty value (`size=`) removes the line.
-3. `title`: re-slugify the new title, `mv` the file to `<ID>-<new-slug>.<ext>` in its current stage directory, and update the story's `backlog.md` line if it has one (keep the `- <ID> <title>` format)
+3. `title`: rewrite the `Title:`/`Feature:` line (or the opening `#` heading of a `.md` that has no `Title:` line), re-slugify the new title, `mv` the file to `<ID>-<new-slug>.<ext>` in its current stage directory, and update the story's `backlog.md` line if it has one (keep the `- <ID> <title>` format)
 4. Reject values containing newlines - the gem treats these as invalid everywhere
 5. Confirm what changed
 
@@ -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 (the `Title:`/`Feature:` line; humanised from the filename if that line is missing), any set metadata fields, then body
+3. Print: ID, type, stage, title (the `Title:`/`Feature:` line; for a `.md` without one, its opening `#` heading; humanised from the filename if there is neither), any set metadata fields, then body
 
 ```
 APP-003 - implement user auth

data/lib/bacon_tracker/tasks.rb

@@ -288,12 +288,13 @@ module BaconTracker
           puts lines.first.strip
         end
 
-        desc 'Check backlog.md against 2_backlog story files for drift, flag duplicate IDs across stages, check blocked_by/linked_to, and verify .next-id'
+        desc 'Check backlog.md against 2_backlog story files for drift (membership and titles), flag duplicate IDs across stages, check blocked_by/linked_to, sizes, templates and .next-id'
         task :lint do
           listed   = core.backlog_ids
           on_disk  = core.backlog_story_files.filter_map { |f| File.basename(f)[core.filename_id_pattern] }
           phantom  = listed - on_disk
           unlisted = on_disk - listed
+          titles   = core.backlog_title_drift
           dupes    = core.duplicate_id_stages
           drift    = core.status_drift
           max_id   = core.max_story_id
@@ -302,13 +303,15 @@ module BaconTracker
 
           rel = core.relationship_findings
           rel_warn, rel_err = rel.partition { |f| BaconTracker::Core::RELATIONSHIP_WARNINGS.include?(f[:kind]) }
+          sizes = core.unknown_sizes
+          templates = core.template_headers
 
           # Flow signals (rel_warn) are reported but never fail the build: a
           # started story waiting on a blocker is a legitimate state per
           # docs/flow.md, so failing CI on it would train people to ignore lint.
-          broken = !(phantom.empty? && unlisted.empty? && dupes.empty? && drift.empty? && rel_err.empty?) || stale_id
+          broken = !(phantom.empty? && unlisted.empty? && titles.empty? && dupes.empty? && drift.empty? && rel_err.empty?) || stale_id
 
-          if !broken && rel_warn.empty?
+          if !broken && rel_warn.empty? && sizes.empty? && templates.empty?
             puts "Backlog is clean - #{listed.size} stories."
           else
             # One list, two renderings. Each entry carries the text (identical
@@ -332,6 +335,12 @@ module BaconTracker
               add.call("unlisted: #{id} has file in 2_backlog/ but missing from backlog.md",
                        core.backlog_story_files.find { |f| File.basename(f).start_with?(id) } || backlog)
             end
+            # The estate's CI lint fails on this; reporting it here keeps the
+            # local check and CI in agreement on the same tree (BT-186).
+            titles.each do |t|
+              add.call("title-drift: #{t[:id]} is listed in backlog.md as '#{t[:listed]}' but the story is titled '#{t[:title]}'",
+                       backlog, t[:line])
+            end
             dupes.each do |id, paths|
               text = "duplicate: #{id} found in #{paths.map { |p| p.sub("#{core.config.tracker_root}/", '') }.join(' and ')}"
               paths.each { |dup| add.call(text, dup) }
@@ -351,6 +360,20 @@ module BaconTracker
                        BaconTracker::Tasks.line_matching(f[:path], /^#?\s*#{field}:/),
                        BaconTracker::Core::RELATIONSHIP_WARNINGS.include?(f[:kind]) ? :notice : :error)
             end
+            # A size the tracker does not know is reported, not failed (BT-184):
+            # the board shows the story without one, and a project is not made
+            # to sweep its old stories to get a green build.
+            sizes.each do |f|
+              add.call("unknown-size: #{f[:id]} says size '#{f[:size]}' - sizes are #{BaconTracker::Core::SIZES.join(', ')}, the board shows none",
+                       f[:path], BaconTracker::Tasks.line_matching(f[:path], /^#?\s*size:/), :notice)
+            end
+            # A template that starts with its own header (BT-185): the rake
+            # task and the API drop it, but a hand copy would not. Reported,
+            # not failed - nothing on the board is wrong.
+            templates.each do |f|
+              add.call("template-header: #{File.basename(f[:path])} in #{f[:dir]}/ starts with a header block - new stories get their own, take it out of the template",
+                       f[:path], 1, :notice)
+            end
 
             if ENV['LINT_FORMAT'] == 'github'
               # Duplicates share one text across two files; each still gets its
@@ -360,7 +383,7 @@ module BaconTracker
             else
               findings.uniq { |f| f[:text] }.each { |f| warn "  #{f[:text]}" }
             end
-            puts 'No integrity problems - the note above is a flow signal, not a failure.' if !broken && rel_warn.any?
+            puts 'No integrity problems - the note above does not fail the check.' if !broken && (rel_warn.any? || sizes.any? || templates.any?)
             exit 1 if broken
           end
         end

data/lib/bacon_tracker/version.rb

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

data/lib/bacon_tracker.rb

@@ -418,14 +418,39 @@ module BaconTracker
     # 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.
+    # "datenschutzerklaerung"); the in-file line is the title as typed. A .md
+    # story without a Title: line that opens with a markdown heading takes that
+    # heading, the way decision records do (BT-183) - a third of the stories
+    # across Ingo's projects are written that way. nil when the line is missing
+    # or blank and the story does not open with a heading, 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 = body[LEADING_HEADING, 'text']&.strip if (title.nil? || title.empty?) && ext != '.feature'
       title unless title.nil? || title.empty?
     end
 
+    # A markdown heading (any level) as the first non-blank line of a story
+    # body: the title of a .md story that has no Title: line (BT-183). Only the
+    # opening line counts, so a "## Description" section further down, or a
+    # "# comment" inside a code fence, is never mistaken for the title.
+    LEADING_HEADING = /\A(?<lead>\s*\#{1,6}[ \t]+)(?<text>.+?)(?<tail>[ \t#]*)$/
+
+    # Rewrite the opening heading of a .md story (see LEADING_HEADING) to
+    # `title`, leaving any YAML frontmatter untouched. Content without such a
+    # heading is returned as is.
+    def retitle_leading_heading(content, title)
+      fm, body =
+        if content.start_with?("---\n")
+          close = content.index(/^---\n/, 4)
+          close ? [content[0...(close + 4)], content[(close + 4)..]] : ['', content]
+        else
+          ['', content]
+        end
+      fm + body.sub(LEADING_HEADING) { "#{$~[:lead]}#{title}#{$~[:tail]}" }
+    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.
@@ -522,7 +547,14 @@ module BaconTracker
       raise
     end
 
-    # Normalize a T-shirt size to S/M/L (upcased), treating nil/"" as "unset"
+    # The T-shirt sizes the tracker knows. The one list behind creating,
+    # editing, showing and linting a story, so no entry point can accept a
+    # size another one hides (BT-184 - XS was refused on edit, created by the
+    # rake task, and shown as nothing by the board).
+    SIZES = %w[S M L].freeze
+    SIZE_RULE = "size must be #{SIZES[0...-1].join(', ')}, or #{SIZES.last}".freeze
+
+    # Normalize a T-shirt size to SIZES (upcased), treating nil/"" as "unset"
     # and raising on anything else - the one rule shared by create_story and
     # update_story so the two entry points can't disagree (BT-101).
     def normalized_size!(size)
@@ -531,11 +563,25 @@ module BaconTracker
       return nil if size.empty?
 
       up = size.upcase
-      raise ArgumentError, 'size must be S, M, or L' unless %w[S M L].include?(up)
+      raise ArgumentError, SIZE_RULE unless SIZES.include?(up)
 
       up
     end
 
+    # Stories whose size: is not one the tracker knows (BT-184). story:lint
+    # reports them as a notice, not a failure: the value came from a hand edit
+    # or an older tool, the board already shows the story without a size, and
+    # a project is not made to sweep its old stories for a green build. Done
+    # stories are a record and are skipped, as relationship_findings does.
+    def unknown_sizes
+      all_stories.reject { |s| s[:stage] == '4_done' }.sort_by { |s| s[:id] }.filter_map do |s|
+        declared = s[:declared_size]
+        next if declared.nil? || SIZES.include?(declared.upcase)
+
+        { id: s[:id], size: declared, path: s[:path] }
+      end
+    end
+
     def move_to_stage(result, new_stage)
       old_path = result[:file]
       new_dir  = File.join(@config.tracker_root, result[:dir], new_stage)
@@ -549,8 +595,44 @@ module BaconTracker
       new_path
     end
 
+    # The title a backlog.md line carries: the story's in-file title, the same
+    # one the board shows, so the line and the card never disagree (BT-186).
+    # The humanized slug is what parse_story_file falls back to when the file
+    # has no title line and no opening heading.
+    def backlog_title(path)
+      meta  = story_dirs.find { |d| d[:path] == File.dirname(path) }
+      story = meta && parse_story_file(path, meta)
+      story ? story[:title] : humanize_slug(path)
+    end
+
+    # The title part of a backlog ENTRY line ("- NS-123 title" -> "title"),
+    # nil for a non-entry line. Compared against backlog_title by story:lint.
+    def backlog_line_title(line)
+      m = line.match(/\A\s*-\s+#{id_pattern}[ \t]*(.*?)\s*\z/)
+      m && m[1]
+    end
+
+    # Backlog entry lines whose title is not the story's (BT-186): the same
+    # comparison the estate's CI lint makes, so a tree that passes locally
+    # passes there. Lines without a file are phantoms and reported as such.
+    def backlog_title_drift
+      return [] unless File.exist?(@config.backlog_path)
+
+      on_disk = backlog_story_files.to_h { |f| [File.basename(f)[filename_id_pattern], f] }
+      File.readlines(@config.backlog_path, encoding: 'utf-8').each_with_index.filter_map do |line, i|
+        id = backlog_line_id(line)
+        next unless id && on_disk.key?(id)
+
+        listed = backlog_line_title(line)
+        title  = backlog_title(on_disk[id])
+        next if listed == title
+
+        { id: id, listed: listed, title: title, path: on_disk[id], line: i + 1 }
+      end
+    end
+
     def backlog_add(id, filename)
-      title    = humanize_slug(filename)
+      title    = backlog_title(filename)
       existing = File.exist?(@config.backlog_path) ? File.read(@config.backlog_path, encoding: 'utf-8') : ''
       # Normalize the trailing newline first so a hand-edited backlog.md that
       # doesn't end in one doesn't glue the new entry onto the last line
@@ -576,7 +658,7 @@ module BaconTracker
       lines = File.exist?(@config.backlog_path) ? File.readlines(@config.backlog_path, encoding: 'utf-8') : []
       kept  = lines.select { |l| (id = backlog_line_id(l)).nil? || on_disk.key?(id) }
       listed    = kept.filter_map { |l| backlog_line_id(l) }
-      additions = (on_disk.keys - listed).map { |id| "- #{id} #{humanize_slug(on_disk[id])}\n" }
+      additions = (on_disk.keys - listed).map { |id| "- #{id} #{backlog_title(on_disk[id])}\n" }
       atomic_write(@config.backlog_path, (kept + additions).join) if kept != lines || additions.any?
     end
 
@@ -1090,8 +1172,15 @@ module BaconTracker
       }
     end
 
+    # No syntax highlighter: kramdown defaults to Rouge and requires it on the
+    # first fenced code block if it happens to be installed. Rouge activates
+    # the strscan gem over the already-loaded default one, two StringScanner
+    # types then live in the process, and every parse after that raises - the
+    # whole docs surface goes dark until a restart. Plain <pre><code> is all
+    # the page styles anyway.
     def render_markdown(text)
-      doc = Kramdown::Document.new(gfm_table_compat(text), input: 'GFM', hard_wrap: false)
+      doc = Kramdown::Document.new(gfm_table_compat(text), input: 'GFM', hard_wrap: false,
+                                                            syntax_highlighter: nil)
       sanitize_tree!(doc.root)
       doc.to_html
     end
@@ -1572,7 +1661,11 @@ module BaconTracker
     # same set the `story:edit` task parses. A field-validation failure is
     # reported against the just-created story so its ID isn't lost.
     def create(kind, title, fields = {})
-      story = create_story(kind, title)
+      fields = fields.dup
+      # The size goes through create_story, which validates it before an ID is
+      # consumed (BT-184): a refused size leaves no unsized story behind. The
+      # remaining fields are set afterwards, as before.
+      story = create_story(kind, title, size: fields.delete(:size))
       path  =
         if fields.empty?
           story[:path]
@@ -1669,8 +1762,11 @@ module BaconTracker
           [{}, content]
         end
 
-      raw_size = fm['size']&.to_s&.upcase
-      size = %w[S M L].include?(raw_size) ? raw_size : nil
+      # declared_size is the value as written; size is nil unless it is one
+      # the tracker knows, and story:lint reports the difference (BT-184).
+      declared_size = fm['size']&.to_s&.strip
+      declared_size = nil if declared_size&.empty?
+      size = declared_size && SIZES.include?(declared_size.upcase) ? declared_size.upcase : nil
 
       blocked_by = decision_refs(fm['blocked_by'])
       linked_to  = decision_refs(fm['linked_to'])
@@ -1687,7 +1783,7 @@ module BaconTracker
         # Body-line addresses of the subtasks - the client renders/toggles by
         # these instead of re-deriving fence rules (the BT-049 drift class).
         subtask_lines: st_lines.empty? ? nil : st_lines,
-        declared_status: fm['status']&.to_s }
+        declared_status: fm['status']&.to_s, declared_size: declared_size }
     end
 
     # Indices of body lines that are subtasks, skipping fenced content
@@ -1887,13 +1983,8 @@ module BaconTracker
                    else
                      Templates.for(ext, kind)
                    end
-        filled = if ext == '.feature'
-                   template.sub('Name the Feature') { title }
-                 else
-                   template.sub(/\ATitle:.*/) { "Title: #{title}" }
-                 end
         fm      = kind == 'feature' ? frontmatter_feature(id, kind, status) : frontmatter_md(id, kind, status)
-        content = fm + filled
+        content = fm + fill_template(template, ext, title)
 
         atomic_write(dest, content)
         backlog_add(id, dest) if stage == '2_backlog'
@@ -1903,6 +1994,52 @@ module BaconTracker
       end
     end
 
+    # The body of a new story: the template without any header block of its
+    # own, with the title filled into its first Title:/Feature: line. A
+    # template that starts with a header (id/type/status, a placeholder id)
+    # used to be copied as is, so the new story carried two headers and the
+    # template's placeholder title (BT-185). A template without a title line
+    # gets one, so the title as typed always reaches the file.
+    def fill_template(template, ext, title)
+      body = strip_template_header(template)
+      line = ext == '.feature' ? 'Feature' : 'Title'
+      if body.match?(/^#{line}:.*$/)
+        body.sub(/^#{line}:.*$/) { "#{line}: #{title}" }
+      else
+        "#{line}: #{title}\n\n#{body}"
+      end
+    end
+
+    # The header block a template starts with, if any - a YAML '---' block in
+    # either dialect, or the '# key: value' lines of a .feature. Returns the
+    # body after it (leading blank lines dropped), or the template unchanged.
+    def strip_template_header(template)
+      if template.start_with?("---\n")
+        close = template.index(/^---\n/, 4)
+        close ? template[(close + 4)..].lstrip : template
+      elsif template.match?(/\A#{FEATURE_HEADER}/)
+        template.lines.drop_while { |l| l.match?(FEATURE_HEADER) }.join.lstrip
+      else
+        template
+      end
+    end
+
+    # Story templates that start with a header block of their own (BT-185).
+    # create_story drops it, but the /tracker command's file steps and anyone
+    # copying the template by hand would not, so story:lint points it out and
+    # the project can take it out of the template.
+    def template_headers
+      STORY_DIRS.filter_map do |dir, m|
+        path = File.join(@config.tracker_root, dir, "_template#{m[:ext]}")
+        next unless File.exist?(path)
+
+        template = File.read(path, encoding: 'utf-8')
+        next if strip_template_header(template).equal?(template)
+
+        { path: path, dir: dir }
+      end
+    end
+
     def delete_story(id)
       with_lock do
         result = find_story(id)
@@ -1964,8 +2101,12 @@ module BaconTracker
       if title
         content = if ext == '.feature'
                     content.sub(/^Feature: .+/) { "Feature: #{title}" }
-                  else
+                  elsif content.match?(/^Title: .+/)
                     content.sub(/^Title: .+/) { "Title: #{title}" }
+                  else
+                    # A story titled by its opening heading (BT-183) is retitled
+                    # in that heading, so the card keeps following the file.
+                    retitle_leading_heading(content, title)
                   end
       end
 
@@ -2001,11 +2142,13 @@ module BaconTracker
         if path != new_path
           FileUtils.mv(path, new_path)
           path = new_path
-          if result[:stage] == '2_backlog' && File.exist?(@config.backlog_path)
-            lines = File.readlines(@config.backlog_path, encoding: 'utf-8')
-            atomic_write(@config.backlog_path,
-                         lines.map { |l| backlog_line_id(l) == id ? "- #{id} #{title}\n" : l }.join)
-          end
+        end
+        # The backlog line follows the title even when the slug, and so the
+        # filename, did not change ("Fix bug" -> "Fix bug!") - BT-186.
+        if title && result[:stage] == '2_backlog' && File.exist?(@config.backlog_path)
+          lines = File.readlines(@config.backlog_path, encoding: 'utf-8')
+          atomic_write(@config.backlog_path,
+                       lines.map { |l| backlog_line_id(l) == id ? "- #{id} #{title}\n" : l }.join)
         end
       end
 

metadata

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