Almirah 0.4.2 → 0.4.4

data/lib/almirah/doc_types/implementation.rb

@@ -1,104 +1,104 @@
 require_relative 'base_document'
 
 class Implementation < BaseDocument
-    attr_accessor :top_doc, :bottom_doc, :items, :is_agregated, :traced_items
-
-    def initialize(top_doc)
-        super()
-        @top_doc = top_doc
-
-        @is_agregated = true
-        @traced_items = {}
-
-        @id = if @is_agregated
-                top_doc.id + '-sources'
-              else
-                top_doc.id + '-' + bottom_doc.id
-              end
-
-        @title = 'Implementation Matrix: ' + @id
+  attr_accessor :top_doc, :bottom_doc, :items, :is_agregated, :traced_items
+
+  def initialize(top_doc)
+    super()
+    @top_doc = top_doc
+
+    @is_agregated = true
+    @traced_items = {}
+
+    @id = if @is_agregated
+            top_doc.id + '-sources'
+          else
+            top_doc.id + '-' + bottom_doc.id
+          end
+
+    @title = 'Implementation Matrix: ' + @id
+  end
+
+  def to_console
+    puts "\e[35m" + 'Implementation: ' + @id + "\e[0m"
+  end
+
+  def to_html(nav_pane, output_file_path)
+    html_rows = []
+
+    html_rows.append('')
+    s = "<h1>#{@title}</h1>\n"
+    s += "<table class=\"controlled\">\n"
+    s += "\t<thead>"
+    s += "\t\t<th>#</th>"
+    s += "\t\t<th style='font-weight: bold;'>#{@top_doc.title}</th>"
+    s += "\t\t<th>#</th>"
+    s += "\t\t<th style='font-weight: bold;'>Repository</th>"
+    s += "\t\t<th style='font-weight: bold;'>File Name</th>"
+    s += "\t\t<th style='font-weight: bold;'>Comment</th>"
+    s += "\t</thead>\n"
+    html_rows.append s
+
+    sorted_items = @top_doc.controlled_items.sort_by { |w| w.id }
+
+    sorted_items.each do |top_item|
+      row = render_table_row top_item
+      html_rows.append row
     end
-
-    def to_console
-        puts "\e[35m" + 'Implementation: ' + @id + "\e[0m"
-    end
-
-    def to_html(nav_pane, output_file_path)
-        html_rows = []
-
-        html_rows.append('')
-        s = "<h1>#{@title}</h1>\n"
-        s += "<table class=\"controlled\">\n"
-        s += "\t<thead>"
-        s += "\t\t<th>#</th>"
-        s += "\t\t<th style='font-weight: bold;'>#{@top_doc.title}</th>"
-        s += "\t\t<th>#</th>"
-        s += "\t\t<th style='font-weight: bold;'>Repository</th>"
-        s += "\t\t<th style='font-weight: bold;'>File Name</th>"
-        s += "\t\t<th style='font-weight: bold;'>Comment</th>"
-        s += "\t</thead>\n"
-        html_rows.append s
-
-        sorted_items = @top_doc.controlled_items.sort_by { |w| w.id }
-
-        sorted_items.each do |top_item|
-            row = render_table_row top_item
-            html_rows.append row
-        end
-        html_rows.append "</table>\n"
-
-        save_html_to_file(html_rows, nav_pane, output_file_path)
-    end
-
-    def render_table_row(top_item)
-        s = ''
-        top_f_text = top_item.format_string(top_item.text)
-        id_color = ''
-
-        if top_item.source_code_links && top_item.source_code_links.length.positive?
-
-            top_item_rendered = false
-
-            top_item.source_code_links.each do |bottom_item|
-                id_color = "style='background-color: #cff4d2;'"
-                bottom_f_text = bottom_item.format_string(bottom_item.text)
-                file_name = bottom_item.parent_doc.id
-                repository = bottom_item.parent_doc.repository
-
-                p = bottom_item.parent_doc.html_file_path.split('/build/source_files/').last
-                html_source_file_relative_path = "./../../source_files/#{p}"
-
-                s += "\t<tr>\n"
-                s += "\t\t<td class=\"item_id\"><a href=\"./../#{top_item.parent_doc.id}/#{top_item.parent_doc.id}.html##{top_item.id}\" class=\"external\">#{top_item.id}</a></td>\n"
-                s += "\t\t<td class=\"item_text\" style='width: 28%;'>#{top_f_text}</td>\n"
-                s += "\t\t<td class=\"item_id\"><a href=\"#{html_source_file_relative_path}##{bottom_item.id}\" class=\"external\">#{bottom_item.id}</a></td>\n"
-                s += "\t\t<td class=\"item_text\" style='width: 16%;'>#{repository}</td>\n"
-                s += "\t\t<td class=\"item_text\" style='width: 16%;'>#{file_name}</td>\n"
-                s += "\t\t<td class=\"item_text\" style='width: 28%;'>#{bottom_f_text}</td>\n"
-                s += "\t</tr>\n"
-                top_item_rendered = true
-                @traced_items[top_item.id.to_s.downcase] = top_item
-            end
-            unless top_item_rendered
-                s += "\t<tr>\n"
-                s += "\t\t<td class=\"item_id\"><a href=\"./../#{top_item.parent_doc.id}/#{top_item.parent_doc.id}.html##{top_item.id}\" class=\"external\">#{top_item.id}</a></td>\n"
-                s += "\t\t<td class=\"item_text\" style='width: 28%;'>#{top_f_text}</td>\n"
-                s += "\t\t<td class=\"item_id\"></td>\n"
-                s += "\t\t<td class=\"item_text\" style='width: 16%;'></td>\n"
-                s += "\t\t<td class=\"item_text\" style='width: 16%;'></td>\n"
-                s += "\t\t<td class=\"item_text\" style='width: 28%;'></td>\n"
-                s += "\t</tr>\n"
-            end
-        else
-            s += "\t<tr>\n"
-            s += "\t\t<td class=\"item_id\"><a href=\"./../#{top_item.parent_doc.id}/#{top_item.parent_doc.id}.html##{top_item.id}\" class=\"external\">#{top_item.id}</a></td>\n"
-            s += "\t\t<td class=\"item_text\" style='width: 28%;'>#{top_f_text}</td>\n"
-            s += "\t\t<td class=\"item_id\"></td>\n"
-            s += "\t\t<td class=\"item_text\" style='width: 16%;'></td>\n"
-            s += "\t\t<td class=\"item_text\" style='width: 16%;'></td>\n"
-            s += "\t\t<td class=\"item_text\" style='width: 28%;'></td>\n"
-            s += "\t</tr>\n"
-        end
-        s
+    html_rows.append "</table>\n"
+
+    save_html_to_file(html_rows, nav_pane, output_file_path)
+  end
+
+  def render_table_row(top_item)
+    s = ''
+    top_f_text = top_item.format_string(top_item.text)
+    id_color = ''
+
+    if top_item.source_code_links && top_item.source_code_links.length.positive?
+
+      top_item_rendered = false
+
+      top_item.source_code_links.each do |bottom_item|
+        id_color = "style='background-color: #cff4d2;'"
+        bottom_f_text = bottom_item.format_string(bottom_item.text)
+        file_name = bottom_item.parent_doc.id
+        repository = bottom_item.parent_doc.repository
+
+        p = bottom_item.parent_doc.html_file_path.split('/build/source_files/').last
+        html_source_file_relative_path = "./../../source_files/#{p}"
+
+        s += "\t<tr>\n"
+        s += "\t\t<td class=\"item_id\"><a href=\"./../#{top_item.parent_doc.id}/#{top_item.parent_doc.id}.html##{top_item.id}\" class=\"external\">#{top_item.id}</a></td>\n"
+        s += "\t\t<td class=\"item_text\" style='width: 28%;'>#{top_f_text}</td>\n"
+        s += "\t\t<td class=\"item_id\"><a href=\"#{html_source_file_relative_path}##{bottom_item.id}\" class=\"external\">#{bottom_item.id}</a></td>\n"
+        s += "\t\t<td class=\"item_text\" style='width: 16%;'>#{repository}</td>\n"
+        s += "\t\t<td class=\"item_text\" style='width: 16%;'>#{file_name}</td>\n"
+        s += "\t\t<td class=\"item_text\" style='width: 28%;'>#{bottom_f_text}</td>\n"
+        s += "\t</tr>\n"
+        top_item_rendered = true
+        @traced_items[top_item.id.to_s.downcase] = top_item
+      end
+      unless top_item_rendered
+        s += "\t<tr>\n"
+        s += "\t\t<td class=\"item_id\"><a href=\"./../#{top_item.parent_doc.id}/#{top_item.parent_doc.id}.html##{top_item.id}\" class=\"external\">#{top_item.id}</a></td>\n"
+        s += "\t\t<td class=\"item_text\" style='width: 28%;'>#{top_f_text}</td>\n"
+        s += "\t\t<td class=\"item_id\"></td>\n"
+        s += "\t\t<td class=\"item_text\" style='width: 16%;'></td>\n"
+        s += "\t\t<td class=\"item_text\" style='width: 16%;'></td>\n"
+        s += "\t\t<td class=\"item_text\" style='width: 28%;'></td>\n"
+        s += "\t</tr>\n"
+      end
+    else
+      s += "\t<tr>\n"
+      s += "\t\t<td class=\"item_id\"><a href=\"./../#{top_item.parent_doc.id}/#{top_item.parent_doc.id}.html##{top_item.id}\" class=\"external\">#{top_item.id}</a></td>\n"
+      s += "\t\t<td class=\"item_text\" style='width: 28%;'>#{top_f_text}</td>\n"
+      s += "\t\t<td class=\"item_id\"></td>\n"
+      s += "\t\t<td class=\"item_text\" style='width: 16%;'></td>\n"
+      s += "\t\t<td class=\"item_text\" style='width: 16%;'></td>\n"
+      s += "\t\t<td class=\"item_text\" style='width: 28%;'></td>\n"
+      s += "\t</tr>\n"
     end
+    s
+  end
 end

data/lib/almirah/doc_types/index.rb

@@ -2,7 +2,7 @@
 
 require_relative 'base_document'
 
-class Index < BaseDocument # rubocop:disable Metrics/ClassLength,Style/Documentation
+class Index < BaseDocument
   attr_accessor :project
 
   def initialize(project)
@@ -16,11 +16,10 @@ class Index < BaseDocument # rubocop:disable Metrics/ClassLength,Style/Documenta
     puts "\e[36mIndex: #{@id}\e[0m"
   end
 
-  def to_html(output_file_path) # rubocop:disable Metrics/AbcSize,Metrics/CyclomaticComplexity,Metrics/MethodLength,Metrics/PerceivedComplexity
+  def to_html(output_file_path)
     html_rows = []
 
     html_rows.append('')
-    s = "<h1>#{@title}</h1>\n"
 
     # Specifications
     s = "<h2>Specifications</h2>\n"
@@ -41,7 +40,7 @@ class Index < BaseDocument # rubocop:disable Metrics/ClassLength,Style/Documenta
 
     sorted_items = @project.project_data.specifications.sort_by(&:id)
 
-    sorted_items.each do |doc| # rubocop:disable Metrics/BlockLength
+    sorted_items.each do |doc|
       s = "\t<tr>\n"
       s += "\t\t<td class=\"item_text\" style='padding: 5px;'><a href=\"./specifications/#{doc.id}/#{doc.id}.html\" class=\"external\"><i class=\"fa fa-file-text-o\" style='background-color: ##{doc.color};'> </i>&nbsp#{doc.title}</a></td>\n"
       s += "\t\t<td class=\"item_id\" style='width: 7%;'>#{doc.controlled_items.length}</td>\n"
@@ -121,11 +120,11 @@ class Index < BaseDocument # rubocop:disable Metrics/ClassLength,Style/Documenta
       s += "\t\t<td class=\"item_text\" style='padding: 5px;'><a href=\"./specifications/#{doc.id}/#{doc.id}.html\" class=\"external\">#{doc.title}</a></td>\n"
       s += "\t\t<td class=\"item_id\" style='width: 7%;'>#{'%.2f' % coverage}%</td>\n"
       s += "\t\t<td class=\"item_text\" style='width: 25%; padding: 5px;'><i class=\"fa fa-file-text-o\" style='background-color: ##{doc.top_doc.color};'> </i>&nbsp#{doc.top_doc.title}</td>\n"
-      if doc.bottom_doc
-        s += "\t\t<td class=\"item_text\" style='width: 25%; padding: 5px;'><i class=\"fa fa-file-text-o\" style='background-color: ##{doc.bottom_doc.color};'> </i>&nbsp#{doc.bottom_doc.title}</td>\n"
-      else
-        s += "\t\t<td class=\"item_text\" style='width: 25%; padding: 5px;'><i class=\"fa fa-circle-o\"'> </i>&nbspAll References</td>\n"
-      end
+      s += if doc.bottom_doc
+             "\t\t<td class=\"item_text\" style='width: 25%; padding: 5px;'><i class=\"fa fa-file-text-o\" style='background-color: ##{doc.bottom_doc.color};'> </i>&nbsp#{doc.bottom_doc.title}</td>\n"
+           else
+             "\t\t<td class=\"item_text\" style='width: 25%; padding: 5px;'><i class=\"fa fa-circle-o\"'> </i>&nbspAll References</td>\n"
+           end
       s += "</tr>\n"
       html_rows.append s
     end
@@ -158,7 +157,7 @@ class Index < BaseDocument # rubocop:disable Metrics/ClassLength,Style/Documenta
                           end
 
         s += "\t\t<td class=\"item_text\" style='padding: 5px;'><a href=\"./specifications/#{doc.id}/#{doc.id}.html\" class=\"external\">#{doc.title}</a></td>\n"
-        s += "\t\t<td class=\"item_id\" style='width: 7%;'>#{'%.2f' % coverage}%</td>\n" # rubocop:disable Style/FormatString
+        s += "\t\t<td class=\"item_id\" style='width: 7%;'>#{'%.2f' % coverage}%</td>\n"
         s += "\t\t<td class=\"item_id\" style='width: 7%; #{test_step_color}' title='pass/fail'> #{doc.passed_steps_number}/#{doc.failed_steps_number} </td>\n"
         s += "\t\t<td class=\"item_text\" style='width: 25%; padding: 5px;'>\
                     <i class=\"fa fa-file-text-o\" style='background-color: ##{doc.top_doc.color};'> </i>\
@@ -187,13 +186,13 @@ class Index < BaseDocument # rubocop:disable Metrics/ClassLength,Style/Documenta
 
         implemented_items = 0
         doc.top_doc.controlled_items.each do |i|
-          implemented_items += 1 if i.source_code_links && i.source_code_links.length.positive? # rubocop:disable Style/SafeNavigation
+          implemented_items += 1 if i.source_code_links && i.source_code_links.length.positive?
         end
 
         coverage = implemented_items.to_f / doc.top_doc.controlled_items.length * 100.0
 
         s += "\t\t<td class=\"item_text\" style='padding: 5px;'><a href=\"./specifications/#{doc.id}/#{doc.id}.html\" class=\"external\">#{doc.title}</a></td>\n"
-        s += "\t\t<td class=\"item_id\" style='width: 7%;'>#{'%.2f' % coverage}%</td>\n" # rubocop:disable Style/FormatString
+        s += "\t\t<td class=\"item_id\" style='width: 7%;'>#{'%.2f' % coverage}%</td>\n"
         s += "\t\t<td class=\"item_text\" style='width: 25%; padding: 5px;'>\
                     <i class=\"fa fa-file-text-o\" style='background-color: ##{doc.top_doc.color};'> </i>\
                     #{doc.top_doc.title}</td>\n"

data/lib/almirah/doc_types/persistent_document.rb

@@ -2,7 +2,7 @@
 
 require_relative 'base_document'
 
-class PersistentDocument < BaseDocument # rubocop:disable Style/Documentation
+class PersistentDocument < BaseDocument
   attr_accessor :path, :items, :controlled_items, :headings, :up_link_docs, :frontmatter
 
   def initialize(fele_path)

data/lib/almirah/doc_types/planning_dates.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require 'date'
+
+# Shared date bucketing for the planning views (ADR-182): the recent Fridays a
+# time-series trail is sampled on. Used by the overview's velocity chart and the
+# Critical Chain page's fever-chart trail (ADR-196).
+module PlanningDates
+  # `count` Fridays ending at the Friday on or before `reference_date`, oldest
+  # first.
+  def recent_fridays(reference_date, count)
+    friday_wday = 5
+    days_back = (reference_date.wday - friday_wday) % 7
+    most_recent = reference_date - days_back
+    (0...count).to_a.reverse.map { |i| most_recent - (7 * i) }
+  end
+end

data/lib/almirah/doc_types/protocol.rb

@@ -1,28 +1,24 @@
-require_relative "persistent_document"
+require_relative 'persistent_document'
 
 class Protocol < PersistentDocument
+  attr_accessor :specifications_path
 
-    attr_accessor :specifications_path
+  def initialize(fele_path)
+    super
+    @id = File.basename(fele_path, File.extname(fele_path)).downcase
+    @specifications_path = './../../../specifications/'
+  end
 
-    def initialize(fele_path)
-        super
-        @id = File.basename(fele_path, File.extname(fele_path)).downcase
-        @specifications_path = './../../../specifications/'
-    end
-
-    def to_html(nav_pane, output_file_path)
-
-        html_rows = Array.new
-
-        html_rows.append('')
+  def to_html(nav_pane, output_file_path)
+    html_rows = []
 
-        @items.each do |item|    
-            a = item.to_html
-            html_rows.append a
-        end
+    html_rows.append('')
 
-        self.save_html_to_file(html_rows, nav_pane, output_file_path)
-        
+    @items.each do |item|
+      a = item.to_html
+      html_rows.append a
     end
 
-end
+    save_html_to_file(html_rows, nav_pane, output_file_path)
+  end
+end

data/lib/almirah/doc_types/risk_record.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require_relative 'decision'
+require_relative '../doc_items/controlled_table'
+
+# A risk record (ADR-215): one Markdown file per risk, collected from the
+# first-level subfolders of the project's risks/ folder, each subfolder being
+# a risk registry. The record format is the decision-record format — filename
+# letters-digits id, frontmatter title, Status table with a "*" current-state
+# marker — so the type reuses Decision wholesale.
+class RiskRecord < Decision
+  # The first-level risks/ subfolder the record was collected from.
+  attr_accessor :registry
+
+  def to_console
+    puts "\e[36mRisk Record: #{@id}\e[0m"
+  end
+
+  # The rendered HTML of the record section whose heading text equals
+  # `section_name` (ADR-216). Empty when there is no such section — the
+  # register renders it as an empty cell.
+  def section_html(section_name)
+    section_items(section_name).map(&:to_html).join
+  end
+
+  # The numeric value of the named section (ADR-217): its items' plain text
+  # parsed as a Float. nil when the section is missing, empty, or not numeric —
+  # the RPN cell renders blank rather than computing a broken record as safe.
+  def section_numeric(section_name)
+    texts = section_items(section_name).filter_map { |i| i.text if i.respond_to?(:text) }
+    Float(texts.join(' ').strip, exception: false)
+  end
+
+  # The record's value for an RPN group (ADR-217): the product of its numeric
+  # input sections. nil when any input is missing or not numeric — such a
+  # record renders a blank cell and is ignored by the summary aggregates.
+  def rpn_value(group)
+    factors = group[:inputs].map { |input| section_numeric(input) }
+    return nil if factors.any?(&:nil?)
+
+    factors.reduce(:*)
+  end
+
+  # The distinct controlled-paragraph IDs the record's Affected Documents
+  # Req-ID column links to (ADR-218), in the section's row order — the
+  # IDs-only content of the register cell. Empty when the record carries no
+  # Affected Documents section or its rows link nothing.
+  def affected_document_ids
+    table = section_items('Affected Documents').find { |i| i.is_a?(ControlledTable) }
+    return [] if table.nil?
+
+    table.rows.flat_map { |row| row.up_link_ids || [] }.uniq
+  end
+
+  private
+
+  # The items between the heading whose text equals `section_name` and the
+  # next heading of the same or a higher level; empty when no heading matches.
+  def section_items(section_name)
+    in_section = false
+    section_level = nil
+    collected = []
+    @items.each do |item|
+      if item.is_a?(Heading) && !in_section
+        next unless item.text.strip == section_name
+
+        in_section = true
+        section_level = item.level
+      elsif in_section
+        break if item.is_a?(Heading) && item.level <= section_level
+
+        collected.append item
+      end
+    end
+    collected
+  end
+end

data/lib/almirah/doc_types/risk_registry_page.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+require_relative 'base_document'
+require_relative 'rpn_rendering'
+require_relative '../doc_items/heading'
+
+# The registry page (ADR-216): build/risks/<registry>/overview.html holding
+# the rendered registry preface (overview.md), when present, followed by the
+# register table — one row per risk record with the implicit linked-ID and
+# Title columns first, then the configured columns filled from each record's
+# section matched by heading text. The Status column is reserved: it is filled
+# from the record's current lifecycle status, never from a section.
+class RiskRegistryPage < BaseDocument
+  include RpnRendering
+
+  STATUS_COLUMN = 'Status'
+  # The column rendered as bare linked IDs from the record's Affected
+  # Documents section (ADR-218), never as the section's prose.
+  AFFECTED_DOCUMENTS_COLUMN = 'Affected Documents'
+
+  attr_accessor :registry, :records, :preface, :columns, :rpn_groups
+
+  # `columns` is the configured per-registry list (ADR-216); nil means the
+  # registry is not configured and gets the implicit columns plus Status only.
+  # `rpn_groups` (ADR-217) appends one computed "<Name> RPN" column per group
+  # after the configured columns; empty appends nothing.
+  def initialize(registry, records, preface, columns, rpn_groups = [])
+    super()
+    @registry = registry
+    @records = records
+    @preface = preface
+    @columns = columns.nil? ? [STATUS_COLUMN] : columns
+    @rpn_groups = rpn_groups
+    @id = 'overview'
+    @title = preface_title || "Risk Registry: #{registry}"
+  end
+
+  def to_console
+    puts "\e[36mRisk Registry: #{@registry}\e[0m"
+  end
+
+  def to_html(output_file_path)
+    html_rows = ['']
+    html_rows.concat preface_html
+    html_rows.append render_register_table
+    save_html_to_file(html_rows, nil, output_file_path)
+  end
+
+  private
+
+  # The preface frontmatter title names the page; without it the registry does.
+  def preface_title
+    params = @preface&.frontmatter&.parameters
+    params && params['title']
+  end
+
+  # The rendered overview.md items. The parser-injected level-0 title heading
+  # is not authored preface content and is skipped.
+  def preface_html
+    return [] if @preface.nil?
+
+    @preface.items.reject { |i| i.is_a?(Heading) && i.level.zero? }.map(&:to_html)
+  end
+
+  def render_register_table
+    s = "<table class=\"controlled risk_register\">\n"
+    s += "\t<thead>\n"
+    s += "\t\t<th>#</th>\n"
+    s += "\t\t<th>Title</th>\n"
+    @columns.each { |c| s += "\t\t<th>#{c}</th>\n" }
+    @rpn_groups.each { |g| s += "\t\t<th>#{g[:name]} RPN</th>\n" }
+    s += "</thead>\n"
+    @records.each { |doc| s += render_record_row(doc) }
+    s + "</table>\n"
+  end
+
+  def render_record_row(doc)
+    href = "./#{record_href(doc)}"
+    s = "\t<tr>\n"
+    s += "\t\t<td class=\"item_id\">\n"
+    s += "\t\t\t<a name=\"#{doc.id}\" id=\"#{doc.id}\" href=\"#{href}\" title=\"Risk Record ID\">#{doc.id.upcase}</a>"
+    s += "\t\t</td>\n"
+    s += "\t\t<td class=\"item_text\" style='padding: 5px;'>\
+<a href=\"#{href}\" class=\"external\">#{record_title(doc)}</a></td>\n"
+    @columns.each { |c| s += render_column_cell(doc, c) }
+    @rpn_groups.each { |g| s += render_rpn_cell(doc, g) }
+    s + "\t</tr>\n"
+  end
+
+  # The Title cell (ENH-221): the frontmatter title with the record's own
+  # leading "ID:" prefix removed, case-insensitively — the ID column already
+  # carries it. A title not starting with the record's ID stays unchanged, and
+  # the record page keeps the full title. Display-only, like the uppercased ID:
+  # anchors and hrefs keep the canonical lowercase id.
+  def record_title(doc)
+    doc.title.to_s.sub(/\A#{Regexp.escape(doc.id)}\s*:\s*/i, '')
+  end
+
+  # The record page path relative to the registry page, which sits at the
+  # registry root: the record's html_rel_path minus its registry segment.
+  def record_href(doc)
+    doc.html_rel_path.split('/', 2).last
+  end
+
+  def render_column_cell(doc, column)
+    return "\t\t<td class=\"item_status\">#{doc.current_status}</td>\n" if column == STATUS_COLUMN
+    return render_affected_documents_cell(doc) if column == AFFECTED_DOCUMENTS_COLUMN
+
+    "\t\t<td class=\"item_text\">#{doc.section_html(column)}</td>\n"
+  end
+
+  # IDs only (ADR-218): each distinct linked controlled-paragraph ID as a
+  # clickable link in row order; a dangling ID renders in the existing
+  # broken-link style rather than being dropped. The Proposed Text stays on
+  # the record page.
+  def render_affected_documents_cell(doc)
+    links = doc.affected_document_ids.map { |id| affected_document_link(doc, id) }
+    "\t\t<td class=\"item_id\">#{links.join(', ')}</td>\n"
+  end
+
+  def affected_document_link(doc, item_id)
+    if doc.wrong_links_hash.key?(item_id)
+      %(<span class="broken_link" title="Unresolved reference">#{item_id}</span>)
+    else
+      spec = /^([a-zA-Z]+)-\d+/.match(item_id)&.[](1)&.downcase
+      href = "./../../specifications/#{spec}/#{spec}.html##{item_id}"
+      %(<a href="#{href}" class="external" title="Affected document">#{item_id}</a>)
+    end
+  end
+
+  # The computed group cell (ADR-217): the record's group value, blank when
+  # any input is missing or not numeric, coloured by the group's thresholds
+  # when configured.
+  def render_rpn_cell(doc, group)
+    value = doc.rpn_value(group)
+    return "\t\t<td class=\"item_rpn\"></td>\n" if value.nil?
+
+    classes = ['item_rpn', rpn_threshold_class(value, group)].compact.join(' ')
+    "\t\t<td class=\"#{classes}\">#{format_rpn(value)}</td>\n"
+  end
+end