pwn 0.5.783 → 0.5.785

data/spec/lib/pwn/session_cleanup_recovery_spec.rb

@@ -0,0 +1,403 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require File.expand_path('../../../etc/default_cron/session_cleanup', __dir__)
+
+RSpec.describe PWN::SessionCleanup do
+  include_context 'pwn tmp sandbox'
+
+  let(:id) { '20200101_010203_abcdef12' }
+  let(:title) { "pwn-ai session #{id}" }
+  let(:path) { File.join(PWN::Sessions.sessions_dir, "#{id}.jsonl") }
+  let(:meta_path) { path.sub('.jsonl', '.meta.json') }
+
+  before do
+    allow(Dir).to receive(:home).and_return(File.join(@tmp, 'home'))
+    FileUtils.mkdir_p(File.join(Dir.home, '.pwn'))
+    stub_const('PWN::AI::Agent::Learning::LEARNING_FILE', File.join(Dir.home, '.pwn', 'learning.jsonl'))
+    PWN::Sessions.create(id: id)
+  end
+
+  def metadata(value)
+    File.write(meta_path, JSON.generate({ id: id, title: title, source: 'pwn-ai' }.merge(value)))
+  end
+
+  describe 'bounded housekeeping recovery' do
+    it 'restores legacy session bytes explicitly without overwriting newer sessions' do
+      allow(described_class).to receive(:legacy_owners).and_return([])
+      original = File.binread(path)
+      result = described_class.sweep(dry_run: false, proc_root: File.join(@tmp, 'no-proc'))
+      expect(result[:deleted_ids]).to include(id)
+      ledger = File.join(result[:archive_dir], 'ledger.json')
+      expect(described_class.recovery_status(ledger: ledger)[:actions]).to include('restore')
+      expect(described_class.recover(ledger: ledger, dry_run: false)[:restored]).to include(path)
+      expect(File.binread(path)).to eq(original)
+      File.write(path, 'newer bytes')
+      expect { described_class.recover(ledger: ledger, dry_run: false) }.to raise_error(IOError, /existing/)
+      expect(File.read(path)).to eq('newer bytes')
+    end
+
+    it 'rolls back a continuation retirement only while the post-retirement map is unchanged' do
+      root = File.join(Dir.home, '.pwn', 'swarm')
+      swarm = '20200101_010203_abcdef'
+      map = File.join(root, swarm, 'personas.json')
+      FileUtils.mkdir_p(File.dirname(map))
+      File.write(map, JSON.generate('analyst' => id))
+      result = described_class.retire_continuation(root: root, swarm_id: swarm, name: 'analyst')
+      ledger = File.join(File.dirname(result[:backup]), 'ledger.json')
+      expect(described_class.recover(ledger: ledger, action: 'rollback', dry_run: false)[:restored]).to eq([map])
+      expect(JSON.parse(File.read(map))).to eq('analyst' => id)
+      File.write(map, JSON.generate('changed' => id))
+      expect { described_class.recover(ledger: ledger, action: 'rollback', dry_run: false) }.to raise_error(IOError, /changed/)
+    end
+
+    it 'rolls back targeted dependency removal only after restoring source sessions and validating current bytes' do
+      store = File.join(Dir.home, '.pwn', 'mistakes.json')
+      original = JSON.generate(bad: { sessions: [id], verified_sessions: {} })
+      File.write(store, original)
+      allow(described_class).to receive(:legacy_owners).and_return([])
+      result = described_class.sweep(dry_run: false)
+      ledger = File.join(result[:archive_dir], 'ledger.json')
+      expect { described_class.recover(ledger: ledger, action: 'rollback_dependencies', dry_run: false) }.to raise_error(IOError, /source/)
+      described_class.recover(ledger: ledger, dry_run: false)
+      expect(described_class.recover(ledger: ledger, action: 'rollback_dependencies', dry_run: false)[:restored]).to eq([store])
+      expect(File.binread(store)).to eq(original.b)
+    end
+
+    it 'refuses a dependency store exceeding the read admission budget' do
+      described_class.install
+      config = described_class.policy.merge('work_bytes' => 1)
+      File.write(File.join(Dir.home, '.pwn', 'maintenance', 'policy.json'), JSON.generate(config))
+      File.write(PWN::AI::Agent::Learning::LEARNING_FILE, JSON.generate(session_id: id, outcome: 'fixture'))
+      report = described_class.maintain(dry_run: false, proc_root: File.join(@tmp, 'no-proc'))
+      expect(report).to include(state: 'interrupted', incomplete: true)
+      expect(report[:dependency_errors]).to include('incomplete_dependency_index')
+      expect(File.file?(path)).to be(true)
+    end
+
+    it 'stops between phases on the time budget without interrupting an admitted write' do
+      described_class.install
+      now = 100.0
+      allow(Process).to receive(:clock_gettime).with(Process::CLOCK_MONOTONIC).and_return(now)
+      allow(described_class).to receive(:maintenance_transaction).and_wrap_original do |method, **options|
+        result = method.call(**options)
+        allow(Process).to receive(:clock_gettime).with(Process::CLOCK_MONOTONIC).and_return(now + 60)
+        result
+      end
+      allow(described_class).to receive(:legacy_owners).and_return([])
+      report = described_class.maintain(dry_run: false)
+      expect(report).to include(state: 'interrupted', incomplete: true)
+      expect(JSON.parse(File.read(report[:transaction_ledger]))['state']).to eq('interrupted')
+    end
+
+    it 'keeps centralized copies out of the legacy compactor and retains learning rollback bytes' do
+      described_class.install
+      allow(described_class).to receive(:legacy_owners).and_return([])
+      original = File.binread(path)
+      results = 2.times.map do
+        File.binwrite(path, original)
+        described_class.sweep(dry_run: false, proc_root: File.join(@tmp, 'no-proc'))
+      end
+      backups = results.map { |row| File.join(row[:archive_dir], "#{id}.jsonl") }
+      PWN::Sessions.create(id: id)
+      PWN::Sessions.append(session_id: id, role: 'user', content: 'evidence')
+      File.write(PWN::AI::Agent::Learning::LEARNING_FILE, JSON.generate(session_id: id, outcome: 'fixture'))
+      migration = PWN::AI::Agent::Learning.migrate_evidence(dry_run: false)
+      learning_backup = JSON.parse(File.read(migration[:ledger])).fetch('backup')
+      inventory = described_class.legacy_backups.map { |row| row[:path] }
+      expect(inventory & (backups + [learning_backup])).to be_empty
+      config = described_class.policy
+      config['retention_days']['maintenance'] = 0
+      File.write(File.join(Dir.home, '.pwn', 'maintenance', 'policy.json'), JSON.generate(config))
+      result = described_class.prune_legacy_backups(dry_run: false)
+      expect(result[:compacted] & backups).to be_empty
+      expect(backups.map { |file| File.binread(file) }).to eq([original, original])
+      expect(File.file?(learning_backup)).to be(true)
+      record = JSON.parse(File.read(migration[:ledger])).merge('state' => 'prepared')
+      File.write(migration[:ledger], JSON.generate(record))
+      expect(described_class.legacy_backups.map { |row| row[:path] }).not_to include(learning_backup)
+    end
+
+    it 'upgrades the inventory v1 without changing operator policy or unknown layouts' do
+      described_class.install
+      directory = File.join(Dir.home, '.pwn', 'maintenance')
+      config = File.binread(File.join(directory, 'policy.json'))
+      layout = File.join(directory, 'layout.json')
+      File.write(layout, JSON.generate(version: 1, categories: { learning: ['learning_evidence'] }))
+      described_class.install
+      expect(JSON.parse(File.read(layout))).to include('version' => 3, 'categories' => described_class::STORAGE)
+      expect(File.binread(File.join(directory, 'policy.json'))).to eq(config)
+      File.write(layout, JSON.generate(version: 2, categories: { 'tmp' => ['tmp'] }))
+      described_class.install
+      expect(JSON.parse(File.read(layout))).to include('version' => 3, 'categories' => described_class::STORAGE)
+      File.write(layout, JSON.generate(version: 99, categories: {}))
+      expect { described_class.install }.to raise_error(IOError, /inventory/)
+    end
+
+    it 'halts admission on a partial dependency index without deleting unique or active evidence' do
+      described_class.install
+      config = described_class.policy.merge('work_items' => 1, 'work_seconds' => 60)
+      File.write(File.join(Dir.home, '.pwn', 'maintenance', 'policy.json'), JSON.generate(config))
+      bytes = File.binread(path)
+      lease = PWN::Sessions.activate(session_id: id)
+      report = described_class.maintain(dry_run: false, proc_root: File.join(@tmp, 'no-proc'))
+      expect(report[:state]).to eq('interrupted')
+      expect(report[:incomplete]).to be(true)
+      expect(File.binread(path)).to eq(bytes)
+      expect(Thread.current[:pwn_maintenance_admission]).to be_nil
+    ensure
+      lease&.close
+    end
+
+    it 'preserves centralized continuation recovery and does not run a competing compactor' do
+      described_class.install
+      root = File.join(Dir.home, '.pwn', 'swarm')
+      swarm = '20200101_010203_abcdef'
+      map = File.join(root, swarm, 'personas.json')
+      FileUtils.mkdir_p(File.dirname(map))
+      backups = 2.times.map do
+        File.write(map, JSON.generate('analyst' => id))
+        described_class.retire_continuation(root: root, swarm_id: swarm, name: 'analyst').fetch(:backup)
+      end
+      config = described_class.policy
+      config['retention_days']['maintenance'] = 0
+      File.write(File.join(Dir.home, '.pwn', 'maintenance', 'policy.json'), JSON.generate(config))
+      original = File.binread(backups.first)
+      config['retention_days']['maintenance'] = 90
+      config['budget_bytes']['maintenance'] = 0
+      File.write(File.join(Dir.home, '.pwn', 'maintenance', 'policy.json'), JSON.generate(config))
+      expect(File.identical?(*backups)).to be(false)
+      report = described_class.prune_legacy_backups(dry_run: false)
+      expect(report[:compacted]).to be_empty
+      expect(File.identical?(*backups)).to be(false)
+      expect(backups.map { |file| File.binread(file) }).to eq([original, original])
+      ledger = File.join(File.dirname(backups.last), 'ledger.json')
+      expect(described_class.recover(ledger: ledger, action: 'rollback', dry_run: false)[:restored]).to eq([map])
+      expect(File.binread(map)).to eq(original)
+    end
+
+    it 'owns actual festival input through use and removes it without a global tmp sweep' do
+      observed = nil
+      allow(PWN::Plugins::Voice).to receive(:text_to_speech) do |opts|
+        observed = opts[:text_path]
+        expect(observed).to start_with("#{described_class.disposable_directory('tmp')}/")
+        expect(File.read(observed)).to eq('fixture speech')
+        expect(described_class.clean_disposables(dry_run: false)[:deleted]).to be_empty
+      end
+      result = PWN::AI::Agent::Extrospection.send(:voice_tts, text: 'fixture speech', engine: :festival, out: File.join(@tmp, 'speech.wav'))
+      expect(result.first).to be(true)
+      expect(File.exist?(observed)).to be(false)
+    end
+
+    it 'recovers a killed atomic cache producer using its ownership journal, never its filename' do
+      described_class.install
+      cache = File.join(Dir.home, '.pwn', 'cache', 'killed')
+      described_class.cache(path: cache, bytes: 'old')
+      child = fork do
+        allow(File).to receive(:rename).and_call_original
+        allow(File).to receive(:rename).with(anything, cache) { exit! 0 }
+        described_class.cache(path: cache, bytes: 'new')
+        exit! 1
+      end
+      _, child_status = Process.wait2(child)
+      expect(child_status.exitstatus).to eq(0)
+      unknown = "#{cache}.unknown.tmp"
+      File.write(unknown, 'unknown')
+      atomic = Dir.glob(File.join(Dir.home, '.pwn', 'maintenance', 'atomic', '*.json')).fetch(0)
+      owned = JSON.parse(File.read(atomic)).fetch('path')
+      File.write(owned, 'changed')
+      expect(described_class.recover_atomic_temps(dry_run: false)[:deleted]).to be_empty
+      File.write(owned, 'new')
+      report = described_class.recover_atomic_temps(dry_run: false)
+      expect(report[:deleted].length).to eq(1)
+      expect(File.read(cache)).to eq('old')
+      expect(File.read(unknown)).to eq('unknown')
+      expect(described_class.recover_atomic_temps(dry_run: false)[:deleted]).to be_empty
+    end
+
+    it 'resumes expiry_prepared after an interruption between backup unlinks' do
+      described_class.install
+      config = described_class.policy
+      config['retention_days']['maintenance'] = 0
+      File.write(File.join(Dir.home, '.pwn', 'maintenance', 'policy.json'), JSON.generate(config))
+      2.times do |index|
+        file = File.join(described_class.disposable_directory('tmp'), "expiry-#{index}")
+        File.write(file, "bytes-#{index}")
+        described_class.register_disposable(path: file, category: 'tmp', expires_at: 0)
+      end
+      result = described_class.clean_disposables(dry_run: false)
+      # Exercise the retained legacy recovery reader with a genuine old layout.
+      old_directory = File.dirname(result[:ledger])
+      legacy_directory = File.join(Dir.home, '.pwn', 'maintenance', 'quarantine', 'legacy-expiry')
+      FileUtils.mkdir_p(File.dirname(legacy_directory))
+      FileUtils.mv(old_directory, legacy_directory)
+      result = JSON.parse(JSON.generate(result).gsub(old_directory, legacy_directory), symbolize_names: true)
+      data = JSON.parse(File.read(result[:ledger]).gsub(old_directory, legacy_directory))
+      File.write(result[:ledger], JSON.generate(data))
+      result[:records] = data.fetch('records')
+      backups = result[:records].map { |row| row['backup'] }
+      allow(File).to receive(:unlink).and_call_original
+      allow(File).to receive(:unlink).with(backups.last).and_raise(Interrupt)
+      expect { described_class.prune_quarantine(dry_run: false) }.to raise_error(Interrupt)
+      expect(JSON.parse(File.read(result[:ledger]))['state']).to eq('expiry_prepared')
+      expect(File.exist?(backups.first)).to be(false)
+      allow(File).to receive(:unlink).with(backups.last).and_call_original
+      expect(described_class.prune_quarantine(dry_run: false)[:deleted]).to eq([backups.last])
+      expect(JSON.parse(File.read(result[:ledger]))['state']).to eq('expired')
+    end
+
+    it 'explicitly delegates learning recovery to validated store rollback without pretending broad rollback' do
+      PWN::Sessions.append(session_id: id, role: 'user', content: '証拠')
+      file = PWN::AI::Agent::Learning::LEARNING_FILE
+      original = JSON.generate(session_id: id, outcome: 'fixture')
+      File.write(file, original)
+      migration = PWN::AI::Agent::Learning.migrate_evidence(dry_run: false)
+      expect(described_class.recovery_status(ledger: migration[:ledger])[:actions]).to include('rollback')
+      expect(described_class.recover(ledger: migration[:ledger], action: 'rollback', dry_run: true)[:dry_run]).to be(true)
+      expect(File.read(file)).not_to eq(original)
+      expect(described_class.recover(ledger: migration[:ledger], action: 'rollback', dry_run: false)[:restored]).to be(true)
+      expect(File.binread(file)).to eq(original.b)
+    end
+  end
+end
+
+RSpec.describe PWN::SessionCleanup, 'disposable admission and scan progress' do
+  include_context 'pwn tmp sandbox'
+
+  before do
+    allow(Dir).to receive(:home).and_return(File.join(@tmp, 'home'))
+    FileUtils.mkdir_p(File.join(Dir.home, '.pwn'))
+    stub_const('PWN::AI::Agent::Learning::LEARNING_FILE', File.join(Dir.home, '.pwn', 'learning.jsonl'))
+  end
+
+  it 'admits disposable payload IO before hashing or backing up through maintain' do
+    described_class.install
+    allow(described_class).to receive(:legacy_owners).and_return([])
+    cache = File.join(Dir.home, '.pwn', 'cache', 'large')
+    described_class.cache(path: cache, bytes: 'x' * 1_048_576)
+    described_class.register_disposable(path: cache, category: 'cache', expires_at: 0)
+    allow(Digest::SHA256).to receive(:file).and_call_original
+    allow(File).to receive(:binread).and_call_original
+    expect(Digest::SHA256).not_to receive(:file).with(cache)
+    expect(File).not_to receive(:binread).with(cache, any_args)
+    config = described_class.policy.merge('work_bytes' => 1024)
+    File.write(File.join(Dir.home, '.pwn', 'maintenance', 'policy.json'), JSON.generate(config))
+    report = described_class.maintain(dry_run: false, proc_root: File.join(@tmp, 'no-proc'))
+    expect(report).to include(state: 'interrupted', incomplete: true)
+    expect(File.size(cache)).to eq(1_048_576)
+    expect(report[:storage][:deleted]).to be_empty
+    expect(Dir.glob(File.join(Dir.home, '.pwn', 'maintenance', 'quarantine', '*', '*.bin'))).to be_empty
+  end
+
+  it 'advances bounded scans past completed and normally removed temporary manifests' do
+    described_class.install
+    allow(described_class).to receive(:legacy_owners).and_return([])
+    described_class.temporary(bytes: 'normal producer') { |_file| nil }
+    files = 2.times.map do |index|
+      file = File.join(Dir.home, '.pwn', 'cache', "expire-#{index}")
+      described_class.cache(path: file, bytes: "cache-#{index}")
+      described_class.register_disposable(path: file, category: 'cache', expires_at: 0)
+      file
+    end
+    config = described_class.policy.merge('scan_limit' => 1)
+    File.write(File.join(Dir.home, '.pwn', 'maintenance', 'policy.json'), JSON.generate(config))
+    reports = 6.times.map { described_class.maintain(dry_run: false, proc_root: File.join(@tmp, 'no-proc')) }
+    expect(reports.flat_map { |report| report[:storage][:deleted] }).to contain_exactly(*files)
+    expect(files.none? { |file| File.exist?(file) }).to be(true)
+    expect(Dir.glob(File.join(Dir.home, '.pwn', 'maintenance', 'disposable', '*.json')).length).to eq(3)
+    expect(reports.all? { |report| report[:storage][:deleted].length <= 1 }).to be(true)
+  end
+
+  it 'does not hash or expire oversized quarantine backups through maintain' do
+    described_class.install
+    allow(described_class).to receive(:legacy_owners).and_return([])
+    cache = File.join(Dir.home, '.pwn', 'cache', 'quarantined')
+    described_class.cache(path: cache, bytes: 'q' * 1_048_576)
+    described_class.register_disposable(path: cache, category: 'cache', expires_at: 0)
+    removed = described_class.clean_disposables(dry_run: false)
+    old_directory = File.dirname(removed[:ledger])
+    legacy_directory = File.join(Dir.home, '.pwn', 'maintenance', 'quarantine', 'legacy-budget')
+    FileUtils.mkdir_p(File.dirname(legacy_directory))
+    FileUtils.mv(old_directory, legacy_directory)
+    removed = JSON.parse(JSON.generate(removed).gsub(old_directory, legacy_directory), symbolize_names: true)
+    data = JSON.parse(File.read(removed[:ledger]).gsub(old_directory, legacy_directory))
+    File.write(removed[:ledger], JSON.generate(data))
+    removed[:records] = data.fetch('records')
+    backup = removed[:records].first.fetch('backup')
+    config = described_class.policy.merge('work_bytes' => 8192)
+    config['retention_days']['maintenance'] = 0
+    File.write(File.join(Dir.home, '.pwn', 'maintenance', 'policy.json'), JSON.generate(config))
+    report = described_class.maintain(dry_run: false, proc_root: File.join(@tmp, 'no-proc'))
+    expect(report).to include(state: 'interrupted', incomplete: true)
+    expect(File.size(backup)).to eq(1_048_576)
+    expect(JSON.parse(File.read(removed[:ledger]))['state']).to eq('committed')
+  end
+
+  it 'revisits active and mutated entries without losing a later re-registration' do
+    described_class.install
+    allow(described_class).to receive(:legacy_owners).and_return([])
+    files = %w[active mutated ready].map do |name|
+      file = File.join(Dir.home, '.pwn', 'cache', name)
+      described_class.cache(path: file, bytes: name)
+      described_class.register_disposable(path: file, category: 'cache', expires_at: 0)
+      file
+    end
+    File.write(files[1], 'mutated payload')
+    lease = File.open("#{files[0]}.lease", File::RDWR) # rubocop:disable Style/FileOpen -- lifetime spans repeated maintenance calls
+    lease.flock(File::LOCK_SH)
+    config = described_class.policy.merge('scan_limit' => 1)
+    File.write(File.join(Dir.home, '.pwn', 'maintenance', 'policy.json'), JSON.generate(config))
+    reports = 3.times.map { described_class.maintain(dry_run: false, proc_root: File.join(@tmp, 'no-proc')) }
+    expect(reports.flat_map { |report| report[:storage][:deleted] }).to eq([files[2]])
+    expect(File.read(files[0])).to eq('active')
+    expect(File.read(files[1])).to eq('mutated payload')
+    lease.close
+    described_class.cache(path: files[2], bytes: 'new registration')
+    3.times { described_class.maintain(dry_run: false, proc_root: File.join(@tmp, 'no-proc')) }
+    expect(File.exist?(files[0])).to be(false)
+    expect(File.read(files[1])).to eq('mutated payload')
+    expect(File.read(files[2])).to eq('new registration')
+  ensure
+    lease&.close unless lease&.closed?
+  end
+
+  it 'finishes an admitted disposable commit when the deadline expires during backup' do
+    described_class.install
+    allow(described_class).to receive(:legacy_owners).and_return([])
+    cache = File.join(Dir.home, '.pwn', 'cache', 'admitted')
+    described_class.cache(path: cache, bytes: 'exact recoverable payload')
+    described_class.register_disposable(path: cache, category: 'cache', expires_at: 0)
+    allow(described_class).to receive(:publish).and_wrap_original do |method, target, bytes|
+      result = method.call(target, bytes)
+      Thread.current[:pwn_maintenance_budget][:deadline] = 0 if target.end_with?('.bin')
+      result
+    end
+    report = described_class.maintain(dry_run: false, proc_root: File.join(@tmp, 'no-proc'))
+    expect(report).to include(state: 'interrupted', incomplete: true)
+    expect(report[:storage][:deleted]).to eq([cache])
+    record = report[:storage][:records].first
+    expect(record['state']).to eq('committed')
+    expect(File.binread(record['backup'])).to eq('exact recoverable payload')
+    expect(JSON.parse(File.read(report[:storage][:ledger]))['records'].first['state']).to eq('committed')
+  end
+
+  it 'retains a manifest re-registered after discovery but before its lease' do
+    described_class.install
+    allow(described_class).to receive(:legacy_owners).and_return([])
+    cache = File.join(Dir.home, '.pwn', 'cache', 'renewed')
+    described_class.cache(path: cache, bytes: 'same payload')
+    described_class.register_disposable(path: cache, category: 'cache', expires_at: 0)
+    renewed = false
+    allow(described_class).to receive(:disposable_reason).and_wrap_original do |method, row, **options|
+      reason = method.call(row, **options)
+      if !options[:verify] && !renewed
+        renewed = true
+        described_class.register_disposable(path: cache, category: 'cache', expires_at: Time.now.to_i + 3600)
+      end
+      reason
+    end
+    report = described_class.maintain(dry_run: false, proc_root: File.join(@tmp, 'no-proc'))
+    expect(report[:storage][:deleted]).to be_empty
+    expect(File.read(cache)).to eq('same payload')
+  end
+end

data/spec/lib/pwn/sessions_spec.rb

@@ -7,6 +7,19 @@ require 'fileutils'
 describe PWN::Sessions do
   include_context 'pwn tmp sandbox'
 
+  it 'probes absent and compact-layout leases without filesystem writes' do
+    sid = '20261025_120000_12345678'
+    root = File.join(@tmp, 'absent-sessions')
+    stub_const('PWN::Sessions::SESSIONS_DIR', root)
+    expect(described_class.active?(session_id: sid)).to be(false)
+    expect(File.exist?(root)).to be(false)
+    FileUtils.mkdir_p(root)
+    File.write(File.join(root, '.layout-v2'), '2')
+    before = Dir.glob("#{root}/**/*", File::FNM_DOTMATCH).sort
+    expect(described_class.active?(session_id: sid)).to be(false)
+    expect(Dir.glob("#{root}/**/*", File::FNM_DOTMATCH).sort).to eq(before)
+  end
+
   it 'reconciles page size, filtered inventory and physical support entries' do
     allow(Dir).to receive(:home).and_return(@tmp)
     3.times { described_class.create }
@@ -104,6 +117,105 @@ describe PWN::Sessions do
   ensure
     Thread.current[:pwn_request_runtime] = previous
   end
+end
+
+describe PWN::Sessions, 'title refresh and persistence' do
+  include_context 'pwn tmp sandbox'
+
+  it 'summarizes Anthropic text blocks through the real adapter without stringifying Ruby containers' do
+    allow(Dir).to receive(:home).and_return(@tmp)
+    sid = described_class.create[:id]
+    described_class.append(session_id: sid, role: 'user', content: 'Repair login certificate')
+    config = { active: :anthropic, anthropic: { model: 'fixture-model', key: 'fixture-key' } }
+    allow(PWN::AI::Router).to receive(:summarize).and_call_original
+    allow(PWN::AI::Anthropic).to receive(:anthropic_rest_call).and_return(JSON.generate(
+                                                                            content: [{ type: 'thinking', thinking: 'private fixture reasoning' },
+                                                                                      { type: 'text', text: JSON.generate(title: 'Certificate recovery', summary: 'Repaired login certificates.') }]
+                                                                          ))
+    failures = []
+    result = described_class.refresh_title(session_id: sid, ai_config: config, on_error: failures.method(:push))
+    expect(failures).to be_empty
+    expect(result).to include(title: 'Certificate recovery', title_source: 'summary', summary_turns: 1)
+  end
+
+  it 'reports the original provider failure class and preserves exact metadata bytes' do
+    allow(Dir).to receive(:home).and_return(@tmp)
+    sid = described_class.create[:id]
+    described_class.append(session_id: sid, role: 'user', content: 'Fixture request')
+    config = { active: :openai, openai: { model: 'fixture', key: 'fixture-key' } }
+    path = described_class.support_path(kind: :metadata, session_id: sid)
+    before = File.binread(path)
+    allow(PWN::AI::Router).to receive(:summarize).and_call_original
+    allow(PWN::AI::OpenAI).to receive(:chat).and_raise(Errno::EACCES, 'private fixture path')
+    failures = []
+    described_class.refresh_title(session_id: sid, ai_config: config, on_error: failures.method(:push))
+    expect(failures).to eq(['Errno::EACCES'])
+    expect(File.binread(path)).to eq(before)
+  end
+
+  it 'accepts whitespace around a complete fenced JSON title response' do
+    sid = described_class.create[:id]
+    described_class.append(session_id: sid, role: 'user', content: 'Fixture request')
+    allow(PWN::AI::Router).to receive(:summarize).and_return(" \n```json\n#{JSON.generate(title: 'Certificate recovery', summary: 'Repaired certificates.')}\n```\n ")
+    failures = []
+    result = described_class.refresh_title(session_id: sid, on_error: failures.method(:push))
+    expect(failures).to be_empty
+    expect(result[:title_source]).to eq('summary')
+  end
+
+  it 'keeps the loaded session store independent of a later mismatched inaccessible home' do
+    sid = described_class.create[:id]
+    described_class.append(session_id: sid, role: 'user', content: 'Fixture request')
+    home = File.join(@tmp, 'inaccessible-home')
+    Dir.mkdir(home, 0o000)
+    allow(Dir).to receive(:home).and_return(home)
+    # Model a changed HOME after store constants loaded, without touching any
+    # real account home or relying on the runner being unprivileged.
+    allow(File).to receive(:open).and_call_original
+    allow(File).to receive(:open).with(home, any_args).and_raise(Errno::EACCES, home)
+    config = { active: :openai, openai: { model: 'fixture', key: 'fixture-key' } }
+    allow(PWN::AI::Router).to receive(:summarize).and_call_original
+    allow(PWN::AI::OpenAI).to receive(:chat).and_return(choices: [{ content: JSON.generate(title: 'Fixture recovery', summary: 'Fixture repaired.') }])
+    failures = []
+    result = described_class.refresh_title(session_id: sid, ai_config: config, on_error: failures.method(:push))
+    expect(failures).to be_empty
+    expect(result[:title_source]).to eq('summary')
+    expect(File).not_to have_received(:open).with(home, any_args)
+  ensure
+    File.chmod(0o700, home) if home && File.directory?(home)
+  end
+
+  it 'retains provenance and removes its exact temporary artifact on denied metadata replacement' do
+    sid = described_class.create[:id]
+    described_class.append(session_id: sid, role: 'user', content: 'Fixture request')
+    path = described_class.support_path(kind: :metadata, session_id: sid)
+    before = File.binread(path)
+    allow(PWN::AI::Router).to receive(:summarize).and_return(JSON.generate(title: 'Fixture repair', summary: 'Repaired fixture.'))
+    temporary = nil
+    allow(File).to receive(:rename).and_call_original
+    allow(File).to receive(:rename).with(anything, path) do |source, _target|
+      temporary = source
+      expect(File.file?(source)).to be(true)
+      raise Errno::EACCES, path
+    end
+    failures = []
+    described_class.refresh_title(session_id: sid, on_error: failures.method(:push))
+    expect(failures).to eq(['Errno::EACCES'])
+    expect(File.binread(path)).to eq(before)
+    expect(temporary).not_to be_nil
+    expect(File.exist?(temporary)).to be(false)
+  end
+
+  it 'does not mislabel an unavailable provider response as malformed JSON' do
+    sid = described_class.create[:id]
+    described_class.append(session_id: sid, role: 'user', content: 'Fixture request')
+    original = described_class.metadata(session_id: sid)
+    allow(PWN::AI::Router).to receive(:summarize).and_return('')
+    failures = []
+    expect(described_class.refresh_title(session_id: sid, on_error: failures.method(:push))).to eq(original)
+    expect(failures).to eq(['IOError'])
+    expect(described_class.metadata(session_id: sid)).to eq(original)
+  end
 
   it 'rejects provider echoed placeholder titles without advancing summary provenance' do
     session = described_class.create

data/spec/lib/pwn/setup_native_yubikey_spec.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'ffi'
+
+RSpec.describe PWN::Setup, 'native library doctor' do
+  around do |example|
+    Dir.mktmpdir('native-library-doctor-') do |root|
+      @root = root
+      example.run
+    end
+  end
+
+  before do
+    allow(Dir).to receive(:home).and_return(@root)
+    stub_const('PWN::Env', {})
+    allow(PWN::Migrate).to receive(:check).and_return(incompatible: [])
+    allow(described_class).to receive(:pkg_manager).and_return(key: :apt, install: 'install-package')
+    allow(described_class).to receive(:which).and_return('/fixture/bin')
+    allow(described_class).to receive(:gem_loadable?).and_return(true)
+    allow(described_class).to receive(:detect_os_attr).with(attr: :type, fallback: anything).and_return(:linux)
+    allow(described_class).to receive(:detect_os_attr).with(attr: :arch, fallback: anything).and_return('fixture')
+    allow(FFI::DynamicLibrary).to receive(:open).and_raise(LoadError, 'fixture library missing')
+    device = double('untouched native device')
+    stub_const('PWN::Plugins::YubiKey', device)
+    %i[devices info command challenge_response oath_code].each { |method| expect(device).not_to receive(method) }
+  end
+
+  it 'reports missing optional libraries but gates only hardware and full profiles on them' do
+    %i[core hardware full].each do |profile|
+      io = StringIO.new
+      report = described_class.check(profile: profile, io: io)
+      expect(report[:ok]).to eq(profile == :core)
+      expect(report[:native_libraries_missing]).to eq(%w[hidapi pcsc])
+      expect(report[:native_gems_missing]).to eq([])
+      expect(report[:toolchain_missing]).to eq([])
+      expect(io.string).to include('Native libraries', 'hidapi', 'pcsc', 'no device discovery')
+    end
+  end
+
+  it 'loads only library handles and accepts the alternative HIDAPI libusb backend' do
+    flags = FFI::DynamicLibrary::RTLD_LAZY | FFI::DynamicLibrary::RTLD_LOCAL
+    allow(FFI::DynamicLibrary).to receive(:open).with('libhidapi-libusb.so.0', flags).and_return(double('HID library'))
+    allow(FFI::DynamicLibrary).to receive(:open).with('libpcsclite.so.1', flags).and_return(double('PCSC library'))
+    report = described_class.check(profile: :hardware, io: StringIO.new)
+    expect(report[:ok]).to be(true)
+    expect(report[:native_libraries_missing]).to eq([])
+    expect(FFI::DynamicLibrary).to have_received(:open).with('libhidapi-hidraw.so.0', flags)
+  end
+
+  it 'recognizes the built-in macOS PCSC framework and Homebrew HIDAPI path' do
+    allow(described_class).to receive(:detect_os_attr).with(attr: :type, fallback: anything).and_return(:osx)
+    flags = FFI::DynamicLibrary::RTLD_LAZY | FFI::DynamicLibrary::RTLD_LOCAL
+    allow(FFI::DynamicLibrary).to receive(:open).with('/System/Library/Frameworks/PCSC.framework/PCSC', flags).and_return(double('system PCSC framework'))
+    allow(FFI::DynamicLibrary).to receive(:open).with('/opt/homebrew/lib/libhidapi.dylib', flags).and_return(double('HID library'))
+    report = described_class.check(profile: :hardware, io: StringIO.new)
+    expect(report[:ok]).to be(true)
+    expect(report[:native_libraries_missing]).to eq([])
+  end
+
+  it 'lists optional native libraries in profile descriptions' do
+    io = StringIO.new
+    described_class.list_profiles(io: io)
+    expect(io.string).to include('libs: hidapi pcsc')
+  end
+end

data/spec/lib/pwn/setup_spec.rb

@@ -68,7 +68,7 @@ describe PWN::Setup do
     expect(res[:dry_run]).to be true
     expect(res[:ok]).to be true
   end
-  it 'ensure_cron enabled:false uninstalls the OS scheduler without spawning' do
+  it 'ensure_cron enabled:false disables only the internal worker without native changes' do
     tmp = Dir.mktmpdir('pwn-setup-nocron-')
     stub_const('PWN::Cron::CRON_DIR', tmp)
     stub_const('PWN::Cron::JOBS_FILE', File.join(tmp, 'jobs.yml'))
@@ -76,6 +76,8 @@ describe PWN::Setup do
     stub_const('PWN::Cron::WORKER_LOG', File.join(tmp, 'worker.log'))
     ENV['PWN_CRON_DIR'] = tmp
     io = StringIO.new
+    expect(PWN::Cron).not_to receive(:install_scheduler)
+    expect(PWN::Cron).not_to receive(:uninstall_scheduler)
     res = PWN::Setup.ensure_cron(enabled: false, apply: false, io: io)
     expect(res[:enabled]).to be false
     expect(res[:ok]).to be true