ruby_raider 4.0.1 → 4.1.0

data/spec/utilities/flows/schedule_store_spec.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+require 'tmpdir'
+require_relative '../../../lib/utilities/flows/schedule_store'
+
+# Flow specs live under spec/utilities/flows, next to the code in lib/utilities/flows
+RSpec.describe RubyRaider::Flows::ScheduleStore do # rubocop:disable RSpec/FilePath
+  let(:dir) { File.realpath(Dir.mktmpdir('flows-store')) }
+  let(:project) { RubyRaider::Flows::Project.new(dir) }
+  let(:store) { described_class.new(project) }
+  let(:file) { File.join(dir, '.raider/flows/schedules.yml') }
+
+  def schedule(name, at = '08:00')
+    RubyRaider::Flows::Schedule.build(project: project, name: name, every: 'day', at: at)
+  end
+
+  after { FileUtils.rm_rf(dir) }
+
+  it 'is empty without a file' do
+    expect([store.all, store.find('report')]).to eq([[], nil])
+  end
+
+  it 'saves entries sorted by name and reads them back' do
+    %w[zeta alpha mid].each { |name| store.save(schedule(name)) }
+
+    expect([store.all.map(&:name), YAML.safe_load_file(file)['schedules'].map { |entry| entry['name'] }]).to eq([%w[alpha mid zeta]] * 2)
+  end
+
+  it 'replaces an entry by name' do
+    store.save(schedule('report'))
+    store.save(schedule('report', '09:30'))
+
+    expect([store.all.size, store.find('report').at]).to eq([1, '09:30'])
+  end
+
+  it 'deletes every entry with the name, and returns the name and os_id of one it could not read' do
+    FileUtils.mkdir_p(File.dirname(file))
+    File.write(file, { 'schedules' => [{ 'name' => 'report', 'every' => 'yearly' }, { 'name' => 'report' }, schedule('other').to_h] }.to_yaml)
+    removed = store.delete('report')
+
+    expect([removed.class, removed.name, removed.os_id]).to eq([described_class::Removed, 'report', RubyRaider::Flows::Schedule.os_id_for(dir, 'report')])
+    expect(YAML.safe_load_file(file)['schedules'].map { |entry| entry['name'] }).to eq(%w[other])
+  end
+
+  it 'returns the readable schedule when a broken entry shares its name' do
+    store.save(schedule('report'))
+    entries = YAML.safe_load_file(file)['schedules']
+    File.write(file, { 'schedules' => [{ 'name' => 'report' }, *entries] }.to_yaml)
+
+    expect([store.delete('report').class, store.all]).to eq([RubyRaider::Flows::Schedule, []])
+  end
+
+  it 'deletes an entry and returns it, or nil when it is not there' do
+    store.save(schedule('report'))
+
+    expect([store.delete('report').name, store.delete('report'), store.all]).to eq(['report', nil, []])
+  end
+
+  it 'skips invalid entries and keeps them when it writes' do
+    FileUtils.mkdir_p(File.dirname(file))
+    File.write(file, { 'schedules' => [{ 'name' => 'broken', 'every' => 'yearly' }, 'junk'] }.to_yaml)
+    store.save(schedule('report'))
+
+    expect([store.all.map(&:name), YAML.safe_load_file(file)['schedules'].size]).to eq([%w[report], 3])
+  end
+
+  it 'reads a file that is not YAML as empty but will not overwrite it' do
+    FileUtils.mkdir_p(File.dirname(file))
+    File.write(file, "schedules: [\n")
+
+    expect(store.all).to eq([])
+    expect { store.save(schedule('report')) }.to raise_error(RubyRaider::Flows::Error, /schedules.yml/)
+    expect { store.delete('report') }.to raise_error(RubyRaider::Flows::Error, /schedules.yml/)
+    expect(File.read(file)).to eq("schedules: [\n")
+  end
+
+  it 'says whether it could write, before anything else is changed' do
+    expect(store.writable!).to be_nil
+    FileUtils.mkdir_p(File.dirname(file))
+    File.write(file, "schedules: [\n")
+
+    expect { store.writable! }
+      .to raise_error(RubyRaider::Flows::Error, '.raider/flows/schedules.yml is not a schedules file: fix or remove it, then try again')
+  end
+
+  it 'will not overwrite a file it cannot read' do
+    store.save(schedule('report'))
+    before = File.read(file)
+    File.chmod(0o000, file)
+
+    expect(store.all).to eq([])
+    expect { store.save(schedule('other')) }.to raise_error(RubyRaider::Flows::Error, /schedules.yml/)
+    File.chmod(0o600, file)
+    expect(File.read(file)).to eq(before)
+  end
+
+  it 'does not load Ruby objects' do
+    FileUtils.mkdir_p(File.dirname(file))
+    File.write(file, "--- !ruby/object:OpenStruct\ntable: {}\n")
+
+    expect(store.all).to eq([])
+  end
+
+  it 'writes through a temp file and a rename in the same folder' do
+    allow(File).to receive(:rename).and_call_original
+    store.save(schedule('report'))
+
+    expect(File).to have_received(:rename).with(%r{\A#{Regexp.escape(File.dirname(file))}/}, file)
+    expect(Dir.children(File.dirname(file))).to eq(['schedules.yml'])
+  end
+
+  it 'makes the flows folder private' do
+    store.save(schedule('report'))
+
+    expect(File.stat(File.dirname(file)).mode & 0o777).to eq(0o700)
+  end
+
+  it 'refuses a linked flows folder' do
+    FileUtils.mkdir_p(File.join(dir, 'elsewhere'))
+    FileUtils.mkdir_p(File.join(dir, '.raider'))
+    File.symlink(File.join(dir, 'elsewhere'), File.join(dir, '.raider/flows'))
+
+    expect { store.save(schedule('report')) }.to raise_error(RubyRaider::Flows::Error, /not a link/)
+  end
+
+  it 'does not read or replace a linked schedules file' do
+    FileUtils.mkdir_p(File.dirname(file))
+    target = File.join(dir, 'other.yml')
+    File.write(target, { 'schedules' => [schedule('report').to_h] }.to_yaml)
+    before = File.read(target)
+    File.symlink(target, file)
+
+    expect(store.all).to eq([])
+    expect { store.save(schedule('other')) }.to raise_error(RubyRaider::Flows::Error, /schedules.yml/)
+    expect([File.symlink?(file), File.read(target)]).to eq([true, before])
+  end
+end

data/spec/utilities/flows/scheduler_spec.rb

@@ -0,0 +1,329 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'stringio'
+require 'tmpdir'
+require_relative '../../../lib/utilities/flows/scheduler'
+
+# Flow specs live under spec/utilities/flows, next to the code in lib/utilities/flows
+# The fake adapter, store and streams sit next to the project and scheduler
+# rubocop:disable RSpec/MultipleMemoizedHelpers
+RSpec.describe RubyRaider::Flows::Scheduler do # rubocop:disable RSpec/FilePath
+  # Stands in for an OS scheduler: records every call, keeps the installed os_ids
+  let(:fake_adapter) do
+    Class.new do
+      attr_reader :calls, :installed
+      attr_accessor :fail_present
+
+      def initialize
+        @calls = []
+        @installed = []
+      end
+
+      def label = 'fakeos'
+
+      def install(schedule)
+        @calls << [:install, schedule.os_id]
+        @installed |= [schedule.os_id]
+        true
+      end
+
+      def remove(os_id)
+        @calls << [:remove, os_id]
+        !@installed.delete(os_id).nil?
+      end
+
+      def present?(os_id)
+        raise RubyRaider::Flows::Error, 'task list unreadable' if fail_present
+
+        @installed.include?(os_id)
+      end
+    end
+  end
+
+  let(:dir) { File.realpath(Dir.mktmpdir('flows-scheduler')) }
+  let(:project) { RubyRaider::Flows::Project.new(dir) }
+  let(:adapter) { fake_adapter.new }
+  let(:store) { RubyRaider::Flows::ScheduleStore.new(project) }
+  let(:out) { StringIO.new }
+  let(:err) { StringIO.new }
+  # Sun 8 Nov 2026 12:00 local
+  let(:now) { Time.local(2026, 11, 8, 12, 0) }
+  let(:scheduler) { described_class.new(project, adapter: adapter, store: store, out: out, err: err, now: -> { now }) }
+  let(:os_id) { RubyRaider::Flows::Schedule.os_id_for(dir, 'report') }
+
+  before do
+    %w[flows/flow_helper.rb flows/support/run.rb flows/report_flow.rb].each do |file|
+      FileUtils.mkdir_p(File.dirname(File.join(dir, file)))
+      File.write(File.join(dir, file), '')
+    end
+  end
+
+  after { FileUtils.rm_rf(dir) }
+
+  def log_run(name, line)
+    file = File.join(dir, ".raider/flows/#{name}/runs.jsonl")
+    FileUtils.mkdir_p(File.dirname(file))
+    File.write(file, "#{JSON.generate(line)}\n", mode: 'a')
+  end
+
+  describe '.adapter' do
+    let(:runner) { instance_double(RubyRaider::Flows::Os::CommandRunner) }
+
+    def result(success)
+      RubyRaider::Flows::Os::CommandRunner::Result.new(stdout: '', stderr: '', exitstatus: success ? 0 : 1)
+    end
+
+    it 'picks launchd on macOS and Task Scheduler on Windows without calling them' do
+      picked = %w[darwin25 mingw32 mswin64 cygwin].map { |host| described_class.adapter(runner: runner, host_os: host).class }
+
+      expect(picked).to eq([RubyRaider::Flows::Os::Launchd] + ([RubyRaider::Flows::Os::TaskScheduler] * 3))
+    end
+
+    it 'picks the Linux adapter, which labels itself by the scheduler that answers' do
+      allow(runner).to receive(:call).and_return(result(true), result(false))
+
+      picked = 2.times.map { described_class.adapter(runner: runner, host_os: 'linux-gnu') }
+
+      expect(picked.map { |adapter| [adapter.class, adapter.label] })
+        .to eq([[RubyRaider::Flows::Os::Linux, 'systemd'], [RubyRaider::Flows::Os::Linux, 'cron']])
+    end
+
+    it 'refuses another OS' do
+      expect { described_class.adapter(runner: runner, host_os: 'solaris2') }
+        .to raise_error(RubyRaider::Flows::Error, 'Scheduling flows is not supported on solaris2')
+    end
+  end
+
+  describe '#schedule' do
+    it 'installs the OS entry, then writes the yml, and says when it next runs' do
+      allow(store).to receive(:save).and_wrap_original do |original, schedule|
+        expect(adapter.installed).to include(schedule.os_id)
+        original.call(schedule)
+      end
+
+      scheduler.schedule('report', every: 'weekday', at: '08:00')
+
+      expect(out.string).to eq("Scheduled report: every weekday at 08:00. Next run Mon 9 Nov 08:00.\n")
+      expect([adapter.calls, store.find('report').rule_text]).to eq([[[:install, os_id]], 'every weekday at 08:00'])
+    end
+
+    it 'stores notify and adds --notify to the OS entry' do
+      allow(adapter).to receive(:install).and_wrap_original do |original, schedule|
+        expect(schedule.argv).to include('--notify')
+        original.call(schedule)
+      end
+      scheduler.schedule('report', every: 'day', at: '08:00', notify: true)
+
+      expect([store.find('report').notify, out.string]).to eq([true, "Scheduled report: every day at 08:00 (notify). Next run Mon 9 Nov 08:00.\n"])
+    end
+
+    it 'says Replaced when the flow already had a schedule' do
+      scheduler.schedule('report', every: 'day', at: '08:00')
+      scheduler.schedule('report', every: 'week', at: '09:30', on: 'wed')
+
+      expect(out.string.lines.last).to eq("Replaced the schedule for report: every week on wed at 09:30. Next run Wed 11 Nov 09:30.\n")
+      expect(store.all.map(&:rule_text)).to eq(['every week on wed at 09:30'])
+    end
+
+    it 'removes the OS entry again when the yml cannot be written' do
+      allow(store).to receive(:save).and_raise(RubyRaider::Flows::Error, 'disk full')
+
+      expect { scheduler.schedule('report', every: 'day', at: '08:00') }
+        .to raise_error(RubyRaider::Flows::Error, 'disk full: the fakeos entry was removed too, so report is not scheduled')
+      expect([adapter.calls, adapter.installed]).to eq([[[:install, os_id], [:remove, os_id]], []])
+    end
+
+    it 'needs the flow file and flows set up, and checks the rule, before touching the OS' do
+      expect { scheduler.schedule('nope', every: 'day', at: '08:00') }.to raise_error(RubyRaider::Flows::Error, /No flow nope/)
+      expect { scheduler.schedule('report', every: 'day') }.to raise_error(RubyRaider::Flows::Error, /needs at/)
+      File.delete(File.join(dir, 'flows/support/run.rb'))
+      expect { scheduler.schedule('report', every: 'day', at: '08:00') }
+        .to raise_error(RubyRaider::Flows::Error, 'Flows are not set up in this project: run raider flow init')
+      expect(adapter.calls).to be_empty
+    end
+
+    it 'checks schedules.yml can be written before installing the OS entry' do
+      FileUtils.mkdir_p(File.join(dir, '.raider/flows'))
+      File.write(File.join(dir, '.raider/flows/schedules.yml'), "schedules: [\n")
+
+      expect { scheduler.schedule('report', every: 'day', at: '08:00') }
+        .to raise_error(RubyRaider::Flows::Error, /schedules.yml is not a schedules file/)
+      expect(adapter.calls).to be_empty
+    end
+
+    it 'refuses with a Flows::Error when the flow folder cannot be made' do
+      File.write(File.join(dir, '.raider'), '')
+
+      expect { scheduler.schedule('report', every: 'day', at: '08:00') }
+        .to raise_error(RubyRaider::Flows::Error, %r{\ACould not make \.raider/flows: })
+      expect(adapter.calls).to be_empty
+    end
+
+    it 'makes .raider/flows/<name> a 0700 folder and refuses a link there' do
+      scheduler.schedule('report', every: 'day', at: '08:00')
+      expect(File.stat(File.join(dir, '.raider/flows/report')).mode & 0o777).to eq(0o700)
+
+      FileUtils.rm_rf(File.join(dir, '.raider/flows/report'))
+      File.symlink(FileUtils.mkdir_p(File.join(dir, 'elsewhere')).first, File.join(dir, '.raider/flows/report'))
+      expect { scheduler.schedule('report', every: 'day', at: '08:00') }
+        .to raise_error(RubyRaider::Flows::Error, '.raider/flows/report must be a folder, not a link')
+      expect(adapter.calls).to eq([[:install, os_id]])
+    end
+  end
+
+  describe '#unschedule' do
+    it 'keeps the yml entry when the OS scheduler refuses the removal' do
+      scheduler.schedule('report', every: 'day', at: '08:00')
+      allow(adapter).to receive(:remove).and_raise(RubyRaider::Flows::Error, 'systemd units found')
+
+      expect { scheduler.unschedule('report') }.to raise_error(RubyRaider::Flows::Error, 'systemd units found')
+      expect(store.find('report')).not_to be_nil
+    end
+
+    it 'removes the yml entry and the OS entry' do
+      scheduler.schedule('report', every: 'day', at: '08:00')
+      scheduler.unschedule('report')
+
+      expect([out.string.lines.last, store.all, adapter.installed]).to eq(["Unscheduled report\n", [], []])
+    end
+
+    it 'says when the OS entry was already gone' do
+      scheduler.schedule('report', every: 'day', at: '08:00')
+      adapter.installed.clear
+      scheduler.unschedule('report')
+
+      expect([out.string.lines.last, store.all]).to eq(["Unscheduled report (it was already gone from fakeos)\n", []])
+    end
+
+    it 'removes an OS entry with no yml entry, even for a deleted flow' do
+      adapter.installed << RubyRaider::Flows::Schedule.os_id_for(dir, 'gone')
+      scheduler.unschedule('gone')
+
+      expect([out.string, adapter.installed]).to eq(["Unscheduled gone\n", []])
+    end
+
+    it 'refuses a flow with no schedule anywhere, and an invalid name' do
+      expect { scheduler.unschedule('report') }.to raise_error(RubyRaider::Flows::Error, 'No schedule for report')
+      expect { scheduler.unschedule('Bad-Name') }.to raise_error(RubyRaider::Flows::Error, /Invalid flow name/)
+    end
+
+    it 'says the OS entry was already removed when schedules.yml can not be written' do
+      scheduler.schedule('report', every: 'day', at: '08:00')
+      allow(store).to receive(:delete).and_raise(Errno::EACCES, 'schedules.yml')
+
+      expect { scheduler.unschedule('report') }.to raise_error(RubyRaider::Flows::Error) do |error|
+        expect([error.message, error.exit_code]).to eq(
+          ['Permission denied - schedules.yml: the fakeos entry was already removed, but schedules.yml still lists report', 2]
+        )
+      end
+      expect(adapter.installed).to eq([])
+    end
+
+    it 'warns that an OS entry from another project path may remain when the yml entry was unreadable' do
+      FileUtils.mkdir_p(File.join(dir, '.raider/flows'))
+      File.write(File.join(dir, '.raider/flows/schedules.yml'), { 'schedules' => [{ 'name' => 'report' }] }.to_yaml)
+      scheduler.unschedule('report')
+
+      expect(out.string).to eq("Unscheduled report (it was already gone from fakeos)\n")
+      expect(err.string).to include('could not be read', 'fakeos entry made from a different project path may remain')
+    end
+  end
+
+  describe '#schedules' do
+    it 'lists each schedule with its rule, next run, last result and OS state' do
+      scheduler.schedule('report', every: 'hour', at: ':15', retries: 2, inputs: ['who=me'], notify: true)
+      log_run('report', 'status' => 'failed', 'finished_at' => "2026-11-09T08:00:12Z\e[2J", 'trigger' => 'schedule',
+                        'failed_step' => 'Open', 'results_dir' => 'flow-results/report/x', 'run_id' => 'abc')
+      out.truncate(0)
+      out.rewind
+      scheduler.schedules
+
+      expect(out.string).to eq("#{'report'.ljust(30)}  every hour at :15 (notify)  next Sun 8 Nov 12:15  failed  2026-11-09T08:00:12Z?[2J  ok\n")
+    end
+
+    it 'prints the JSON the desktop app reads' do
+      scheduler.schedule('report', every: 'week', at: '08:00', on: 'mon', inputs: ['who=me'], notify: true)
+      log_run('report', 'status' => 'completed', 'finished_at' => 'f', 'trigger' => 't', 'failed_step' => nil, 'results_dir' => 'r', 'run_id' => 'x')
+      out.truncate(0)
+      out.rewind
+      scheduler.schedules(json: true)
+
+      expect(JSON.parse(out.string)).to eq(
+        [{ 'name' => 'report', 'every' => 'week', 'at' => '08:00', 'on' => 'mon', 'retries' => 0, 'inputs' => ['who=me'], 'notify' => true,
+           'next_run_at' => Time.local(2026, 11, 9, 8, 0).iso8601, 'os_state' => 'ok',
+           'last' => { 'status' => 'completed', 'finished_at' => 'f', 'trigger' => 't', 'failed_step' => nil, 'results_dir' => 'r' } }]
+      )
+    end
+
+    it 'says Ruby not found when the stored ruby is gone, and missing when the OS entry is gone' do
+      scheduler.schedule('report', every: 'day', at: '08:00')
+      FileUtils.touch(File.join(dir, 'flows/other_flow.rb'))
+      fields = store.find('report').to_h.transform_keys(&:to_sym)
+      other = { name: 'other', os_id: RubyRaider::Flows::Schedule.os_id_for(dir, 'other'), ruby: '/nonexistent/ruby' }
+      store.save(RubyRaider::Flows::Schedule.new(**fields, **other, project_root: dir))
+      adapter.installed.clear
+      out.truncate(0)
+      out.rewind
+      scheduler.schedules(json: true)
+
+      expect(JSON.parse(out.string).map { |row| [row['name'], row['os_state'], row['last']] })
+        .to eq([['other', 'Ruby not found: re-schedule', nil], ['report', 'missing from fakeos', nil]])
+    end
+
+    it 'says flow not found when the flow file is gone, after Ruby not found and before the OS state' do
+      scheduler.schedule('report', every: 'day', at: '08:00')
+      FileUtils.touch(File.join(dir, 'flows/other_flow.rb'))
+      fields = store.find('report').to_h.transform_keys(&:to_sym)
+      other = { name: 'other', os_id: RubyRaider::Flows::Schedule.os_id_for(dir, 'other'), ruby: '/nonexistent/ruby' }
+      store.save(RubyRaider::Flows::Schedule.new(**fields, **other, project_root: dir))
+      %w[report other].each { |name| File.delete(File.join(dir, "flows/#{name}_flow.rb")) }
+      adapter.fail_present = true
+      scheduler.schedules(json: true)
+
+      expect(JSON.parse(out.string.lines.last).map { |row| [row['name'], row['os_state']] })
+        .to eq([['other', 'Ruby not found: re-schedule'], ['report', 'flow not found: unschedule']])
+    end
+
+    it 'adds a row for a flow the OS still schedules with no yml entry' do
+      adapter.installed << os_id
+      scheduler.schedules(json: true)
+
+      expect(JSON.parse(out.string)).to eq(
+        [{ 'name' => 'report', 'every' => nil, 'at' => nil, 'on' => nil, 'retries' => nil, 'inputs' => nil, 'notify' => nil,
+           'next_run_at' => nil, 'os_state' => 'missing from schedules.yml', 'last' => nil }]
+      )
+    end
+
+    it 'shows unknown when the OS state cannot be read' do
+      scheduler.schedule('report', every: 'day', at: '08:00')
+      adapter.fail_present = true
+      out.truncate(0)
+      out.rewind
+      scheduler.schedules
+
+      expect(out.string).to end_with("  never run  unknown (task list unreadable)\n")
+    end
+
+    it 'prints the missed runs note of an adapter that has one, once' do
+      adapter.define_singleton_method(:missed_runs_note) { '(fakeos: missed runs are skipped)' }
+      %w[report other].each do |name|
+        FileUtils.touch(File.join(dir, "flows/#{name}_flow.rb"))
+        scheduler.schedule(name, every: 'day', at: '08:00')
+      end
+      out.truncate(0)
+      out.rewind
+      scheduler.schedules
+
+      expect(out.string.lines.size).to eq(3)
+      expect(out.string.lines.last).to eq("(fakeos: missed runs are skipped)\n")
+    end
+
+    it 'says how to add one when there are none' do
+      scheduler.schedules
+
+      expect(out.string).to eq("No schedules yet: raider flow schedule <name> --every day --at 08:00\n")
+    end
+  end
+end
+# rubocop:enable RSpec/MultipleMemoizedHelpers

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_raider
 version: !ruby/object:Gem::Version
-  version: 4.0.1
+  version: 4.1.0
 platform: ruby
 authors:
 - Agustin Pequeno
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-11-08 00:00:00.000000000 Z
+date: 2026-11-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler-audit
@@ -260,6 +260,7 @@ files:
 - assets/ruby_raider_logo.svg
 - bin/raider
 - bin/release
+- lib/commands/flow_commands.rb
 - lib/commands/scaffolding_commands.rb
 - lib/commands/utility_commands.rb
 - lib/generators/automation/automation_generator.rb
@@ -305,6 +306,8 @@ files:
 - lib/generators/templates/common/reek.tt
 - lib/generators/templates/common/rspec.tt
 - lib/generators/templates/common/rubocop.tt
+- lib/generators/templates/flows/flow_helper.tt
+- lib/generators/templates/flows/run.tt
 - lib/generators/templates/helpers/appium_helper.tt
 - lib/generators/templates/helpers/driver_helper.tt
 - lib/generators/templates/helpers/gesture_helper.tt
@@ -352,12 +355,27 @@ files:
 - lib/scaffolding/templates/page_object.tt
 - lib/scaffolding/templates/spec.tt
 - lib/utilities/desktop_downloader.rb
+- lib/utilities/flows/next_run.rb
+- lib/utilities/flows/notifier.rb
+- lib/utilities/flows/os/command_runner.rb
+- lib/utilities/flows/os/cron.rb
+- lib/utilities/flows/os/launchd.rb
+- lib/utilities/flows/os/linux.rb
+- lib/utilities/flows/os/systemd.rb
+- lib/utilities/flows/os/task_scheduler.rb
+- lib/utilities/flows/project.rb
+- lib/utilities/flows/run_log.rb
+- lib/utilities/flows/runner.rb
+- lib/utilities/flows/schedule.rb
+- lib/utilities/flows/schedule_store.rb
+- lib/utilities/flows/scheduler.rb
 - lib/utilities/logger.rb
 - lib/utilities/logo.rb
 - lib/utilities/utilities.rb
 - lib/version
 - plugins.yml
 - ruby_raider.gemspec
+- sig/commands/flow_commands.rbs
 - sig/commands/scaffolding_commands.rbs
 - sig/commands/utility_commands.rbs
 - sig/generators/automation/automation_generator.rbs
@@ -398,18 +416,34 @@ files:
 - sig/scaffolding/project_detector.rbs
 - sig/scaffolding/scaffolding.rbs
 - sig/utilities/desktop_downloader.rbs
+- sig/utilities/flows/next_run.rbs
+- sig/utilities/flows/notifier.rbs
+- sig/utilities/flows/os/command_runner.rbs
+- sig/utilities/flows/os/cron.rbs
+- sig/utilities/flows/os/launchd.rbs
+- sig/utilities/flows/os/linux.rbs
+- sig/utilities/flows/os/systemd.rbs
+- sig/utilities/flows/os/task_scheduler.rbs
+- sig/utilities/flows/project.rbs
+- sig/utilities/flows/run_log.rbs
+- sig/utilities/flows/runner.rbs
+- sig/utilities/flows/schedule.rbs
+- sig/utilities/flows/schedule_store.rbs
+- sig/utilities/flows/scheduler.rbs
 - sig/utilities/logger.rbs
 - sig/utilities/logo.rbs
 - sig/utilities/utilities.rbs
 - sig/vendor/selenium_webdriver.rbs
 - sig/vendor/thor.rbs
 - sig/vendor/tty_prompt.rbs
+- spec/commands/flow_commands_spec.rb
 - spec/commands/raider_commands_spec.rb
 - spec/commands/scaffolding_commands_spec.rb
 - spec/commands/utility_commands_spec.rb
 - spec/generators/fixtures/templates/test.tt
 - spec/generators/fixtures/templates/test_partial.tt
 - spec/generators/fixtures/video_helper_stubs/selenium-webdriver.rb
+- spec/generators/flow_helper_spec.rb
 - spec/generators/gesture_helper_spec.rb
 - spec/generators/network_helper_spec.rb
 - spec/generators/screenshot_helper_spec.rb
@@ -434,6 +468,9 @@ files:
 - spec/integration/content/test_content_spec.rb
 - spec/integration/end_to_end_features_spec.rb
 - spec/integration/end_to_end_spec.rb
+- spec/integration/flows/flow_project.rb
+- spec/integration/flows/run_command_spec.rb
+- spec/integration/flows/run_lifecycle_spec.rb
 - spec/integration/frozen_string_literal_matcher.rb
 - spec/integration/generators/automation_generator_spec.rb
 - spec/integration/generators/axe_addon_spec.rb
@@ -489,6 +526,20 @@ files:
 - spec/system/support/system_test_helper.rb
 - spec/utilities/desktop_downloader_spec.rb
 - spec/utilities/ffmpeg_spec.rb
+- spec/utilities/flows/next_run_spec.rb
+- spec/utilities/flows/notifier_spec.rb
+- spec/utilities/flows/os/command_runner_spec.rb
+- spec/utilities/flows/os/cron_spec.rb
+- spec/utilities/flows/os/launchd_spec.rb
+- spec/utilities/flows/os/linux_spec.rb
+- spec/utilities/flows/os/systemd_spec.rb
+- spec/utilities/flows/os/task_scheduler_spec.rb
+- spec/utilities/flows/project_spec.rb
+- spec/utilities/flows/run_log_spec.rb
+- spec/utilities/flows/runner_spec.rb
+- spec/utilities/flows/schedule_spec.rb
+- spec/utilities/flows/schedule_store_spec.rb
+- spec/utilities/flows/scheduler_spec.rb
 - spec/utilities/headless_config_spec.rb
 - spec/utilities/trace_command_spec.rb
 - spec/utilities/utilities_spec.rb