aias 0.1.0

data/example_prompts/code_health_check.md

@@ -0,0 +1,51 @@
+---
+description: Weekly code health review — runs checks and reports findings
+schedule: "every friday at 9am"
+---
+You are a pragmatic software quality engineer. Do not generate checklists. Run the
+actual commands, read the actual files, and report what you find. Flag problems
+clearly. Confirm what is healthy. Be specific — file names, line numbers, method
+names, exact gem versions.
+
+**Repository:** /Users/dewayne/sandbox/git_repos/madbomber/aias
+**Coverage target:** 95%
+
+Work through each section below. For each one, execute the relevant commands or
+read the relevant files, then write a short findings paragraph. Use "OK" when
+things are fine and "PROBLEM" when they are not.
+
+---
+
+## 1. Test Coverage
+
+Run `bundle exec rake test` from the repository root. Report:
+- The actual coverage percentage produced
+- Whether it meets the 95% target
+- Any test files that contain `skip` calls and why they are skipped
+
+## 2. Code Quality
+
+Scan the `lib/` directory. Report:
+- Every TODO or FIXME comment — quote it, give the file and line number
+- Every public method longer than 15 lines — name it, measure it, say whether it
+  is a candidate for extraction
+- Any method that takes more than 3 parameters (a sign of unclear interface)
+
+## 3. Dependencies
+
+Run `bundle outdated`. Report:
+- Every gem that is more than one minor version behind — current vs latest
+- Any gem with a known security advisory (check the output of `bundle audit` if
+  available, otherwise note that it was not checked)
+
+## 4. Documentation
+
+Read CHANGELOG.md and the git log for the current week. Report:
+- Whether CHANGELOG.md has been updated to reflect commits made since last Friday
+- Any public API change in `lib/` that is not reflected in README.md examples
+
+## 5. Summary
+
+End with a one-paragraph plain-English summary: overall health, the single most
+urgent problem (if any), and the one thing that would most improve the codebase
+this week.

data/example_prompts/daily_digest.md

@@ -0,0 +1,19 @@
+---
+description: Morning digest of Ruby and AI ecosystem news
+schedule: "every day at 7am"
+---
+You are a concise technical news editor. Today is <%= Time.now.strftime("%A, %B %-d, %Y") %>.
+
+Summarize the most significant developments from the past 24 hours in these areas:
+
+1. **Ruby ecosystem** — new gem releases, RubyGems stats, notable blog posts, Ruby core changes
+2. **AI/LLM landscape** — model releases, API changes, benchmark results, research papers worth noting
+3. **Developer tools** — anything relevant to CLI tooling, code generation, or developer productivity
+
+Format:
+- 3–5 bullet points per section
+- Each bullet under 25 words
+- Flag anything that is a breaking change or security issue with [!]
+- Total response under 400 words
+
+Skip anything that is purely speculative or marketing-focused.

data/example_prompts/morning_standup.md

@@ -0,0 +1,19 @@
+---
+description: Weekday morning standup prep — what to focus on today
+schedule: "every weekday at 8am"
+---
+You are a focused engineering coach helping me start the day clearly.
+
+**Project:** aias gem
+**Current priorities:** shipping v1, writing tests, documentation
+**Today is:** <%= Time.now.strftime("%A, %B %-d") %>
+
+Give me a crisp standup-style summary:
+
+**Yesterday:** Suggest 2–3 likely accomplishments based on the current priorities (I will edit as needed).
+
+**Today:** Recommend the 3 highest-leverage tasks I should tackle given the priorities above. Order them by impact. Each task should be specific and completable in a single work session.
+
+**Blockers:** List any common blockers or risks for a project at this stage that I should watch for today.
+
+Keep the entire response under 200 words. Use plain text, no markdown headers — this gets read aloud.

data/example_prompts/reports/monthly_review.md

@@ -0,0 +1,44 @@
+---
+description: First-of-month retrospective and planning prompt
+schedule: "every month on the 1st at 8am"
+---
+You are a reflective technical mentor helping me run a monthly review on the first of each month.
+
+**Review month:** <%= Date.today.prev_month.strftime("%B %Y") %>
+**Focus area:** gem development and open source contributions
+**Rating scale:** 1 to 5
+
+Structure the review as follows:
+
+---
+
+### Retrospective — <%= Date.today.prev_month.strftime("%B") %>
+
+**Momentum** (rate 1 to 5)
+Prompt me to score the overall momentum of gem development and open source contributions last month and briefly explain why.
+
+**Highlight**
+Ask me: what is the single most satisfying thing completed or learned last month?
+
+**What slipped**
+Ask me: what did I plan to do that did not happen, and why?
+
+**Surprise**
+Ask me: what was unexpected — good or bad?
+
+---
+
+### Planning — <%= Date.today.strftime("%B %Y") %>
+
+**Top 3 outcomes for this month**
+Help me define 3 specific, measurable outcomes for gem development and open source contributions this month. Make each outcome completable within 30 days.
+
+**Risk**
+Name the single most likely thing that will derail this month's plan. Suggest one mitigation.
+
+**First step**
+What is the smallest concrete action I can take today to start the month with momentum?
+
+---
+
+Keep questions direct and brief. Leave space for my answers after each prompt.

data/example_prompts/reports/weekly_summary.md

@@ -0,0 +1,22 @@
+---
+description: Monday morning weekly summary of the previous week's work
+schedule: "every monday at 7:30am"
+---
+You are a thoughtful technical writer composing a personal weekly review.
+
+**Week ending:** <%= (Date.today - 3).strftime("%B %-d, %Y") %>
+**Focus areas:** Ruby gems, AI tooling, open source
+**Output format:** brief narrative
+
+Write a concise weekly summary covering:
+
+**What moved forward**
+Describe 3–4 meaningful things that likely progressed in the focus areas this past week. Base this on known release cadences, typical open-source activity patterns, and industry trends.
+
+**What to carry into next week**
+Identify 2–3 themes or threads that deserve continued attention in the coming week.
+
+**One insight**
+Offer a single, specific observation or pattern that is worth sitting with — something non-obvious that connects two or more of the focus areas.
+
+Keep it under 300 words. Write in first-person as if I authored it. Avoid bullet points — this is a narrative format meant to be read, not scanned.

data/example_prompts/you_are_good.md

@@ -0,0 +1,22 @@
+---
+flags:
+  debug: true
+  verbose: true
+provider: ollama
+models: 
+  - name: gpt-oss:latest
+    role:
+schedule: every 2 minutes
+required: ['shared_tools']
+tools:
+  rejected: ['browser_tool']
+---
+You are a supportive coding mentor. Generate a single, original positive affirmation sentence about my Ruby programming skills. The affirmation should be encouraging, specific to Ruby development, and make me feel motivated about my coding abilities.
+
+After generating the affirmation, use the eval tool with the shell action to execute the following command:
+
+say "[YOUR_AFFIRMATION_HERE]"
+
+Replace [YOUR_AFFIRMATION_HERE] with the affirmation you just created. This will speak the positive message aloud to me.
+
+Provide only the affirmation and execute the command - nothing else.

data/exe/aias

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "aias"
+Aias::CLI.start(ARGV)

data/lib/aias/block_parser.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Aias
+  # Shared block-parsing logic for classes that manage BEGIN/END marker blocks
+  # inside text files (crontab, env.sh).  Both CrontabManager and EnvFile
+  # include this module and pass their own marker constants.
+  module BlockParser
+    private
+
+    # Returns lines between open_marker and close_marker (markers excluded).
+    def extract_block(content, open_marker, close_marker)
+      in_block = false
+      lines    = []
+      content.each_line do |line|
+        if line.chomp == open_marker
+          in_block = true
+        elsif line.chomp == close_marker
+          in_block = false
+        elsif in_block
+          lines << line
+        end
+      end
+      lines.join
+    end
+
+    # Returns content with every line from open_marker through close_marker
+    # (inclusive) removed.  Lines outside the block are preserved as-is.
+    def strip_block(content, open_marker, close_marker)
+      in_block = false
+      content.each_line.reject do |line|
+        if line.chomp == open_marker
+          in_block = true
+        elsif line.chomp == close_marker
+          in_block = false
+        else
+          next in_block
+        end
+        true
+      end.join
+    end
+  end
+end

data/lib/aias/cli/add.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Aias
+  class CLI
+    desc "add PATH", "Add (or replace) a single scheduled prompt in the crontab"
+    def add(path)
+      absolute = File.expand_path(path)
+      unless File.file?(absolute) && absolute.end_with?(".md")
+        say_error "aias [error] '#{path}' must be an existing .md file"
+        exit(1)
+      end
+      prompts_dir = effective_prompts_dir_for(absolute)
+      result      = PromptScanner.new(prompts_dir: prompts_dir).scan_one(absolute)
+      vr          = validator.validate(result)
+
+      unless vr.valid?
+        say_error "aias [error] #{result.prompt_id}: #{vr.errors.join('; ')}"
+        exit(1)
+      end
+
+      cron_line = builder.build(result, prompts_dir: prompts_dir)
+      manager.ensure_log_directories([result.prompt_id])
+      manager.add_job(cron_line, result.prompt_id)
+      say "aias: added #{result.prompt_id} (#{CronDescriber.display(result.schedule)})"
+    rescue Aias::Error => e
+      say_error "aias [error] #{e.message}"
+      exit(1)
+    end
+  end
+end

data/lib/aias/cli/check.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Aias
+  class CLI
+    desc "check", "Diff view: scheduled prompts vs what is installed"
+    def check
+      results   = scanner.scan
+      installed = manager.installed_jobs
+      installed_ids = installed.map { |j| j[:prompt_id] }.to_set
+
+      valid, invalid = partition_results(results)
+      discovered_ids = valid.map { |r, _| r.prompt_id }.to_set
+
+      new_jobs      = discovered_ids - installed_ids
+      orphaned_jobs = installed_ids  - discovered_ids
+
+      say "=== aias check ==="
+      say ""
+
+      unless invalid.empty?
+        say "INVALID (would be skipped by update):"
+        invalid.each { |r, vr| say "  #{r.prompt_id}: #{vr.errors.join('; ')}" }
+        say ""
+      end
+
+      unless new_jobs.empty?
+        say "NEW (not yet installed — run `aias update`):"
+        new_jobs.each do |id|
+          r = valid.find { |result, _| result.prompt_id == id }&.first
+          sched = r ? "  #{CronDescriber.display(r.schedule)}" : ""
+          say "  + #{id}#{sched}"
+        end
+        say ""
+      end
+
+      unless orphaned_jobs.empty?
+        say "ORPHANED (installed but no longer scheduled):"
+        orphaned_jobs.each { |id| say "  - #{id}" }
+        say ""
+      end
+
+      if invalid.empty? && new_jobs.empty? && orphaned_jobs.empty?
+        say "OK — crontab is in sync with scheduled prompts"
+      end
+    rescue Aias::Error => e
+      say_error "aias [error] #{e.message}"
+      exit(1)
+    end
+  end
+end

data/lib/aias/cli/clear.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Aias
+  class CLI
+    desc "clear", "Remove all aias-managed crontab entries"
+    def clear
+      manager.clear
+      say "aias: all managed crontab entries removed"
+    end
+  end
+end

data/lib/aias/cli/dry_run.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Aias
+  class CLI
+    desc "dry-run", "Show what `update` would write without touching the crontab"
+    def dry_run
+      results = scanner.scan
+      valid, invalid = partition_results(results)
+
+      invalid.each { |r, vr| $stderr.puts "aias [skip] #{r.prompt_id}: #{vr.errors.join('; ')}" }
+
+      if valid.empty?
+        say "aias: no valid scheduled prompts found"
+        return
+      end
+
+      cron_lines = valid.map { |r, _vr| builder.build(r) }
+      say manager.dry_run(cron_lines)
+    rescue Aias::Error => e
+      say_error "aias [error] #{e.message}"
+      exit(1)
+    end
+  end
+end

data/lib/aias/cli/install.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Aias
+  class CLI
+    desc "install [PATTERN...]", "Capture PATH, API keys, and env vars into ~/.config/aia/schedule/env.sh"
+    long_desc <<~DESC
+      Writes the current session's PATH, all *_API_KEY and AIA_PROMPTS__DIR
+      environment variables into ~/.config/aia/schedule/env.sh so scheduled
+      aia jobs have a correct PATH (including MCP server binaries) and can
+      authenticate with LLM APIs. This file is sourced by every cron entry.
+
+      Optional PATTERN arguments add extra env vars whose names match the given
+      glob pattern(s). Quote patterns to prevent shell expansion:
+
+        aias install 'AIA_*'
+        aias install 'AIA_*' 'OPENROUTER_*'
+    DESC
+    def install(*patterns)
+      env_vars = ENV.select { |k, _| k.end_with?("_API_KEY") || k.start_with?("AIA_") }
+      env_vars["PATH"]   = ENV["PATH"]
+      env_vars["LANG"]   = ENV["LANG"]   if ENV["LANG"]
+      env_vars["LC_ALL"] = ENV["LC_ALL"] if ENV["LC_ALL"]
+
+      patterns.flat_map(&:split).map(&:upcase).each do |pattern|
+        ENV.each { |k, v| env_vars[k] = v if File.fnmatch(pattern, k) }
+      end
+
+      env_file.install(env_vars)
+      installed = env_vars.keys.sort
+      say "aias: installed #{installed.join(', ')} into #{Paths::SCHEDULE_ENV}"
+
+      FileUtils.mkdir_p(AIA_SCHEDULE_DIR, mode: 0o700)
+
+      unless File.exist?(AIA_SCHEDULE_CFG)
+        if File.exist?(AIA_CONFIG_SRC)
+          FileUtils.cp(AIA_CONFIG_SRC, AIA_SCHEDULE_CFG)
+          say "aias: copied #{AIA_CONFIG_SRC} → #{AIA_SCHEDULE_CFG}"
+        else
+          say "aias: #{AIA_CONFIG_SRC} not found — create #{AIA_SCHEDULE_CFG} manually"
+        end
+        say ""
+        say "Review #{AIA_SCHEDULE_CFG} — these settings apply to all scheduled prompts."
+        say "Prompt frontmatter overrides any setting in that file."
+      end
+
+      if ENV["AIA_PROMPTS__DIR"]
+        dir = File.expand_path(ENV["AIA_PROMPTS__DIR"])
+        if ScheduleConfig.new.set_prompts_dir(dir)
+          say "aias: set prompts.dir=#{dir} in #{AIA_SCHEDULE_CFG}"
+        end
+      end
+    rescue Aias::Error => e
+      say_error "aias [error] #{e.message}"
+      exit(1)
+    end
+  end
+end

data/lib/aias/cli/last.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Aias
+  class CLI
+    desc "last [N]", "Show last-run time for installed jobs (default 5)"
+    def last_run(n = "5")
+      jobs = manager.installed_jobs.first(n.to_i)
+
+      if jobs.empty?
+        say "aias: no installed jobs"
+        return
+      end
+
+      jobs.each do |job|
+        log_stat = File.exist?(job[:log_path]) ? File.mtime(job[:log_path]).to_s : "never run"
+        say "#{job[:prompt_id]}"
+        say "  schedule : #{CronDescriber.display(job[:cron_expr])}"
+        say "  last run : #{log_stat}"
+        say "  log      : #{job[:log_path]}"
+        say ""
+      end
+
+      say "(Pass N as argument to show N entries. Last-run time is derived from the log file modification timestamp.)"
+    end
+  end
+end

data/lib/aias/cli/list.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Aias
+  class CLI
+    desc "list", "List all installed aias cron jobs"
+    def list
+      jobs = manager.installed_jobs
+      if jobs.empty?
+        say "aias: no installed jobs"
+        return
+      end
+
+      say format("%-30s  %-40s  %s", "PROMPT ID", "SCHEDULE", "LOG")
+      say "-" * 100
+      jobs.each do |job|
+        say format("%-30s  %-40s  %s", job[:prompt_id], Aias::CronDescriber.display(job[:cron_expr]), job[:log_path])
+      end
+    end
+  end
+end

data/lib/aias/cli/next.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Aias
+  class CLI
+    desc "next [N]", "Show next scheduled run time for installed jobs (default 5)"
+    def upcoming(n = "5")
+      jobs = manager.installed_jobs.first(n.to_i)
+
+      if jobs.empty?
+        say "aias: no installed jobs"
+        return
+      end
+
+      now = Time.now
+      jobs.each do |job|
+        cron      = Fugit.parse_cronish(job[:cron_expr])
+        next_time = cron ? cron.next_time(now).localtime.to_s : "unknown (invalid cron expression)"
+        say "#{job[:prompt_id]}"
+        say "  schedule : #{CronDescriber.display(job[:cron_expr])}"
+        say "  next run : #{next_time}"
+        say "  log      : #{job[:log_path]}"
+        say ""
+      end
+
+      say "(Pass N as argument to show N entries.)"
+    end
+  end
+end

data/lib/aias/cli/remove.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Aias
+  class CLI
+    desc "remove PROMPT_ID", "Remove a single scheduled prompt from the crontab"
+    def remove(prompt_id)
+      manager.remove_job(prompt_id)
+      say "aias: removed #{prompt_id}"
+    rescue Aias::Error => e
+      say_error "aias [error] #{e.message}"
+      exit(1)
+    end
+  end
+end

data/lib/aias/cli/show.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Aias
+  class CLI
+    desc "show PROMPT_ID", "Show the installed crontab entry for a single prompt"
+    def show(prompt_id)
+      job = manager.installed_jobs.find { |j| j[:prompt_id] == prompt_id }
+      if job
+        say "prompt_id : #{job[:prompt_id]}"
+        say "schedule  : #{CronDescriber.display(job[:cron_expr])}"
+        say "log       : #{job[:log_path]}"
+      else
+        say "aias: '#{prompt_id}' is not currently installed"
+        exit(1)
+      end
+    end
+  end
+end

data/lib/aias/cli/uninstall.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Aias
+  class CLI
+    desc "uninstall", "Remove managed env block from ~/.config/aia/schedule/env.sh (schedule config preserved)"
+    def uninstall
+      env_file.uninstall
+      say "aias: env vars removed from #{Paths::SCHEDULE_ENV}"
+      say "      #{AIA_SCHEDULE_DIR} is unchanged"
+    rescue Aias::Error => e
+      say_error "aias [error] #{e.message}"
+      exit(1)
+    end
+  end
+end

data/lib/aias/cli/update.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Aias
+  class CLI
+    desc "update", "Scan prompts, regenerate all crontab entries, and install"
+    def update
+      results = scanner.scan
+      valid, invalid = partition_results(results)
+
+      invalid.each do |r, vr|
+        $stderr.puts "aias [skip] #{r.prompt_id}: #{vr.errors.join('; ')}"
+      end
+
+      if valid.empty?
+        say "aias: no valid scheduled prompts found — crontab not changed"
+        return
+      end
+
+      cron_lines = valid.map { |r, _vr| builder.build(r, prompts_dir: options[:prompts_dir]) }
+      manager.ensure_log_directories(valid.map { |r, _vr| r.prompt_id })
+      manager.install(cron_lines)
+
+      say "aias: installed #{valid.size} job(s)" \
+          "#{invalid.empty? ? '' : ", skipped #{invalid.size} invalid"}"
+    rescue Aias::Error => e
+      say_error "aias [error] #{e.message}"
+      exit(1)
+    end
+  end
+end

data/lib/aias/cli/version.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Aias
+  class CLI
+    desc "version", "Print the aias version"
+    def version
+      say Aias::VERSION
+    end
+  end
+end

data/lib/aias/cli.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+require "yaml"
+
+module Aias
+  class CLI < Thor
+    def self.exit_on_failure? = true
+
+    class_option :prompts_dir,
+      type:    :string,
+      aliases: "-p",
+      desc:    "Prompts directory (overrides AIA_PROMPTS__DIR / AIA_PROMPTS_DIR env vars)"
+
+    AIA_CONFIG_SRC   = Paths::AIA_CONFIG
+    AIA_SCHEDULE_DIR = Paths::SCHEDULE_DIR
+    AIA_SCHEDULE_CFG = Paths::SCHEDULE_CFG
+
+    # Aliases
+    map "-v"        => :version
+    map "--version" => :version
+    map "ins"     => :install
+    map "unins"   => :uninstall
+    map "rm"      => :remove
+    map "delete"  => :remove
+    map "dry-run" => :dry_run
+    map "next"    => :upcoming
+    map "last"    => :last_run
+
+    # ---------------------------------------------------------------------------
+    # help — appends crontab reference when listing all commands
+    # ---------------------------------------------------------------------------
+
+    def help(command = nil, subcommand = false)
+      super
+      return if command
+
+      say ""
+      say "Crontab commands:"
+      say "  crontab -l               # view current crontab"
+      say "  crontab -e               # edit crontab in $EDITOR"
+      say "  EDITOR=nano crontab -e   # edit with a specific editor"
+      say "  crontab -r               # remove entire crontab"
+    end
+
+    private
+
+    # Lazy collaborator accessors — allows injection in tests via instance
+    # variable assignment before invoking a command.
+    def scanner   = @scanner   ||= PromptScanner.new(prompts_dir: options[:prompts_dir])
+    def validator = @validator ||= Validator.new
+    def builder   = @builder   ||= JobBuilder.new(config_file: AIA_SCHEDULE_CFG)
+    def manager   = @manager   ||= CrontabManager.new
+    def env_file  = @env_file  ||= EnvFile.new
+
+    # Splits results into [valid, invalid] where each element is [result, validation_result].
+    def partition_results(results)
+      pairs = results.map { |r| [r, validator.validate(r)] }
+      pairs.partition { |_r, vr| vr.valid? }
+    end
+
+    # Determines the effective prompts directory for `aias add`.
+    # See full description in cli/add.rb.
+    def effective_prompts_dir_for(absolute)
+      return File.expand_path(options[:prompts_dir]) if options[:prompts_dir]
+
+      env_dir = ENV[PromptScanner::PROMPTS_DIR_ENVVAR_NEW] ||
+                ENV[PromptScanner::PROMPTS_DIR_ENVVAR_OLD]
+      env_dir = File.expand_path(env_dir) if env_dir
+
+      if env_dir && absolute.start_with?("#{env_dir}/")
+        env_dir
+      else
+        File.dirname(absolute)
+      end
+    end
+  end
+end
+
+require_relative "cli/update"
+require_relative "cli/add"
+require_relative "cli/remove"
+require_relative "cli/install"
+require_relative "cli/uninstall"
+require_relative "cli/clear"
+require_relative "cli/list"
+require_relative "cli/check"
+require_relative "cli/dry_run"
+require_relative "cli/next"
+require_relative "cli/last"
+require_relative "cli/show"
+require_relative "cli/version"