Class: Textus::Doctor::Check::OrphanedPublishTargets

Inherits:
Textus::Doctor::Check show all
Defined in:
lib/textus/doctor/check/orphaned_publish_targets.rb

Overview

Flags published files whose recorded source no longer exists in the store. Per-leaf prune (ADR 0046) reconciles within a still-present leaf; a renamed or removed whole leaf orphans its entire target directory, which a per-entry build won’t revisit. This check catches that drift without making ‘build` scan globally.

Instance Method Summary collapse

Methods inherited from Textus::Doctor::Check

#initialize, name_key

Constructor Details

This class inherits a constructor from Textus::Doctor::Check

Instance Method Details

#call ⇒ Object 



10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
 
# File 'lib/textus/doctor/check/orphaned_publish_targets.rb', line 10

def call
  sdir = File.join(root, Textus::Ports::SentinelStore::DIR)
  return [] unless File.directory?(sdir)

  repo_root = File.dirname(root)
  store = Textus::Ports::SentinelStore.new
  glob = File.join(sdir, "**", "*#{Textus::Ports::SentinelStore::SUFFIX}")
  Dir.glob(glob).filter_map do |spath|
    sentinel = store.load(spath, repo_root)
    next nil if sentinel.nil? || sentinel.source.nil?
    next nil if File.exist?(sentinel.source)

    {
      "code" => "publish.orphaned_target",
      "level" => "warning",
      "subject" => sentinel.target,
      "message" => "published file #{sentinel.target} has no source in the store " \
                   "(recorded source #{sentinel.source} is gone) — likely a renamed or removed leaf",
      "fix" => "remove the stale copy and its sentinel: rm '#{sentinel.target}' '#{spath}'",
    }
  end
end