orfeas_lyra 0.6.0

data/lib/tasks/public_release.rake

@@ -0,0 +1,351 @@
+# frozen_string_literal: true
+
+# Rake tasks for extracting public files to lyra-engine repo
+#
+# Usage:
+#   rake public:build          # Build lyra-engine directory
+#   rake public:sync           # Sync changes to existing lyra-engine
+#   rake public:init           # Initialize lyra-engine as git repo
+#   rake public:clean          # Remove lyra-engine directory
+#   rake public:release[tag]   # Full release workflow
+
+require "fileutils"
+
+namespace :public do
+  LYRA_ROOT = File.expand_path("../..", __dir__)
+  PUBLIC_DIR = File.join(LYRA_ROOT, "lyra-engine")
+
+  # Files and directories to include in public release
+  PUBLIC_INCLUDES = %w[
+    app/
+    bin/
+    config/
+    docs/
+    examples/blog_app/
+    examples/privacy_examples.rb
+    examples/privacy_policy_usage.rb
+    examples/usage_examples.rb
+    gems/
+    lib/
+    test/
+    .gitignore
+    .ruby-version
+    docker-compose.yml
+    Gemfile
+    Gemfile.lock
+    LICENSE
+    lyra.gemspec
+    Rakefile
+    README.md
+    CHANGELOG.md
+  ].freeze
+
+  # Patterns to exclude from public release (applied after includes)
+  PUBLIC_EXCLUDES = %w[
+    .DS_Store
+    *.log
+    /coverage/
+    /tmp/
+    /log/
+    /vendor/bundle/
+    /gems/*/.bundle/
+    /gems/*/coverage/
+    /test/dummy/db/*.sqlite3
+    /test/reports/
+    /lib/tasks/gems.rake
+    /lib/tasks/public_release.rake
+    /lib/tasks/testbed.rake
+    /lib/tasks/stats.rake
+    /lib/tasks/dist.rake
+  ].freeze
+
+  # Files that need sanitization (remove internal references)
+  SANITIZE_FILES = %w[
+    README.md
+  ].freeze
+
+  desc "Build lyra-engine directory with public files"
+  task :build => :clean do
+    puts "=" * 60
+    puts "Building lyra-engine public release"
+    puts "=" * 60
+
+    FileUtils.mkdir_p(PUBLIC_DIR)
+
+    PUBLIC_INCLUDES.each do |item|
+      src = File.join(LYRA_ROOT, item)
+      next unless File.exist?(src)
+
+      dest = File.join(PUBLIC_DIR, item)
+      if File.directory?(src)
+        sync_directory_public(src, dest)
+        puts "  + #{item}"
+      else
+        FileUtils.mkdir_p(File.dirname(dest))
+        FileUtils.cp(src, dest)
+        puts "  + #{item}"
+      end
+    end
+
+    # Sanitize files for public release
+    sanitize_readme
+    sanitize_changelog
+    sanitize_gitignore
+    sanitize_gemspec
+    remove_internal_rake_tasks
+
+    puts ""
+    puts "=" * 60
+    puts "lyra-engine built successfully!"
+    puts "Location: #{PUBLIC_DIR}"
+    puts "=" * 60
+  end
+
+  desc "Sync changes to existing lyra-engine directory"
+  task :sync do
+    unless File.directory?(PUBLIC_DIR)
+      puts "lyra-engine directory not found. Run 'rake public:build' first."
+      exit 1
+    end
+
+    puts "Syncing changes to lyra-engine..."
+    Rake::Task["public:build"].invoke
+  end
+
+  desc "Initialize lyra-engine as a git repository"
+  task :init => :build do
+    Dir.chdir(PUBLIC_DIR) do
+      unless File.directory?(".git")
+        system("git init")
+        system("git add .")
+        system("git commit -m 'Initial commit - Lyra Engine v#{lyra_version}'")
+        puts ""
+        puts "Git repository initialized."
+        puts "Add remote with: git remote add origin <url>"
+      else
+        puts "Git repository already initialized."
+      end
+    end
+  end
+
+  desc "Clean lyra-engine directory"
+  task :clean do
+    if File.directory?(PUBLIC_DIR)
+      # Preserve .git directory if it exists
+      git_dir = File.join(PUBLIC_DIR, ".git")
+      git_backup = File.join(LYRA_ROOT, ".lyra-engine-git-backup")
+
+      if File.directory?(git_dir)
+        FileUtils.mv(git_dir, git_backup)
+      end
+
+      # Remove all other contents
+      Dir.glob("#{PUBLIC_DIR}/*", File::FNM_DOTMATCH).each do |item|
+        next if item.end_with?(".", "..")
+        FileUtils.rm_rf(item)
+      end
+
+      # Restore .git directory
+      if File.directory?(git_backup)
+        FileUtils.mv(git_backup, git_dir)
+        puts "Cleaned lyra-engine (preserved .git)"
+      else
+        puts "Cleaned lyra-engine"
+      end
+    end
+  end
+
+  desc "Full release workflow: build, init, tag"
+  task :release, [:tag] => :init do |t, args|
+    tag = args[:tag] || "v#{lyra_version}"
+
+    Dir.chdir(PUBLIC_DIR) do
+      # Stage any new changes
+      system("git add .")
+
+      # Check if there are changes to commit
+      changes = `git status --porcelain`.strip
+      if changes.empty?
+        puts "No changes to commit."
+      else
+        system("git commit -m 'Release #{tag}'")
+      end
+
+      # Create tag
+      system("git tag -a #{tag} -m 'Release #{tag}'")
+      puts ""
+      puts "=" * 60
+      puts "Release #{tag} prepared!"
+      puts ""
+      puts "To push to remote:"
+      puts "  cd lyra-engine"
+      puts "  git remote add origin git@github.com:mpantel/lyra-engine.git"
+      puts "  git push -u origin main"
+      puts "  git push origin #{tag}"
+      puts "=" * 60
+    end
+  end
+
+  desc "Show what would be included in public release"
+  task :preview do
+    puts "Files to be included in lyra-engine:"
+    puts "-" * 40
+
+    PUBLIC_INCLUDES.each do |item|
+      src = File.join(LYRA_ROOT, item)
+      if File.exist?(src)
+        if File.directory?(src)
+          count = Dir.glob("#{src}/**/*").count { |f| File.file?(f) }
+          puts "  #{item} (#{count} files)"
+        else
+          puts "  #{item}"
+        end
+      else
+        puts "  #{item} (not found)"
+      end
+    end
+
+    puts ""
+    puts "Excluded patterns:"
+    PUBLIC_EXCLUDES.each { |p| puts "  - #{p}" }
+  end
+
+  # Helper methods
+
+  def sync_directory_public(src, dest)
+    FileUtils.mkdir_p(dest)
+
+    Dir.glob("#{src}/**/*", File::FNM_DOTMATCH).each do |path|
+      next if path.end_with?(".", "..")
+      next if File.directory?(path)
+      next if excluded_public?(path)
+
+      rel_path = path.sub("#{src}/", "")
+      dest_path = File.join(dest, rel_path)
+
+      FileUtils.mkdir_p(File.dirname(dest_path))
+      FileUtils.cp(path, dest_path)
+    end
+  end
+
+  def excluded_public?(path)
+    relative = path.sub(LYRA_ROOT, "")
+
+    PUBLIC_EXCLUDES.any? do |pattern|
+      if pattern.include?("*")
+        File.fnmatch(pattern, relative, File::FNM_PATHNAME)
+      else
+        relative.include?(pattern)
+      end
+    end
+  end
+
+  def lyra_version
+    # Extract version from lyra.gemspec or version file
+    version_file = File.join(LYRA_ROOT, "lib/lyra/version.rb")
+    if File.exist?(version_file)
+      content = File.read(version_file)
+      if content =~ /VERSION\s*=\s*["']([^"']+)["']/
+        return $1
+      end
+    end
+    "0.6.0"
+  end
+
+  def sanitize_readme
+    readme_path = File.join(PUBLIC_DIR, "README.md")
+    return unless File.exist?(readme_path)
+
+    content = File.read(readme_path)
+
+    # Remove aegean-epay-testbed section (case insensitive)
+    content.gsub!(/^##+ .*aegean.?e?pay.?testbed.*?(?=^##|\z)/mi, "")
+
+    # Remove solidus case study section (case insensitive)
+    content.gsub!(/^##+ .*solidus.*?(?=^##|\z)/mi, "")
+
+    # Remove any references to private examples
+    content.gsub!(/examples\/aegean_epay_testbed\/?/, "examples/blog_app/")
+    content.gsub!(/examples\/solidus_case_study\/?/, "examples/blog_app/")
+
+    # Clean up multiple consecutive blank lines
+    content.gsub!(/\n{3,}/, "\n\n")
+
+    File.write(readme_path, content)
+    puts "  Sanitized README.md"
+  end
+
+  def sanitize_changelog
+    changelog_path = File.join(PUBLIC_DIR, "CHANGELOG.md")
+    return unless File.exist?(changelog_path)
+
+    content = File.read(changelog_path)
+
+    # Remove lines referencing private examples
+    lines = content.lines.reject do |line|
+      line =~ /aegean.?epay.?testbed|solidus.?case.?study/i
+    end
+
+    # Replace references in remaining text
+    content = lines.join
+    content.gsub!(/aegean.?epay.?testbed/i, "blog_app")
+    content.gsub!(/solidus.?case.?study/i, "blog_app")
+
+    # Clean up multiple consecutive blank lines
+    content.gsub!(/\n{3,}/, "\n\n")
+
+    File.write(changelog_path, content)
+    puts "  Sanitized CHANGELOG.md"
+  end
+
+  def sanitize_gitignore
+    gitignore_path = File.join(PUBLIC_DIR, ".gitignore")
+    return unless File.exist?(gitignore_path)
+
+    content = File.read(gitignore_path)
+
+    # Remove lines referencing private directories
+    lines = content.lines.reject do |line|
+      line =~ /aegean.?epay.?testbed|solidus|docs-site|paper|papertse|papersp|thesis|proposal|research/i
+    end
+
+    File.write(gitignore_path, lines.join)
+    puts "  Sanitized .gitignore"
+  end
+
+  def sanitize_gemspec
+    gemspec_path = File.join(PUBLIC_DIR, "lyra.gemspec")
+    return unless File.exist?(gemspec_path)
+
+    content = File.read(gemspec_path)
+
+    # Update homepage to public repo
+    content.gsub!(
+      /spec\.homepage\s*=\s*["'][^"']*["']/,
+      'spec.homepage = "https://github.com/mpantel/lyra-engine"'
+    )
+
+    # Update metadata URLs
+    content.gsub!(
+      /github\.com\/mpantel\/lyra(?!-engine)/,
+      "github.com/mpantel/lyra-engine"
+    )
+
+    File.write(gemspec_path, content)
+    puts "  Sanitized lyra.gemspec"
+  end
+
+  def remove_internal_rake_tasks
+    tasks_dir = File.join(PUBLIC_DIR, "lib/tasks")
+    return unless File.directory?(tasks_dir)
+
+    internal_tasks = %w[gems.rake public_release.rake testbed.rake stats.rake dist.rake]
+    internal_tasks.each do |task|
+      task_path = File.join(tasks_dir, task)
+      if File.exist?(task_path)
+        FileUtils.rm(task_path)
+      end
+    end
+    puts "  Removed internal rake tasks"
+  end
+end

data/lib/tasks/stats.rake

@@ -0,0 +1,175 @@
+# frozen_string_literal: true
+
+namespace :lyra do
+  desc "Display code statistics for Lyra and its components"
+  task :stats do
+    class CodeStats
+      COMPONENTS = {
+        "Lyra Core (lib/)" => "lib",
+        "Controllers (app/)" => "app",
+        "Tests (test/)" => "test",
+        "PetriFlow Gem" => "gems/petri_flow",
+        "PAM DSL Gem" => "gems/pam_dsl",
+        "Examples" => "examples"
+      }.freeze
+
+      def initialize
+        @stats = {}
+      end
+
+      def run
+        print_header
+        calculate_all_stats
+        print_stats_table
+        print_summary
+      end
+
+      private
+
+      def print_header
+        puts "\n" + "=" * 70
+        puts "Lyra Code Statistics"
+        puts "=" * 70
+        puts "Generated: #{Time.now.strftime('%Y-%m-%d %H:%M:%S')}"
+        puts "=" * 70
+      end
+
+      def calculate_all_stats
+        COMPONENTS.each do |name, path|
+          next unless Dir.exist?(path)
+
+          @stats[name] = calculate_stats(path)
+        end
+      end
+
+      def calculate_stats(path)
+        ruby_files = Dir.glob("#{path}/**/*.rb")
+
+        total_lines = 0
+        code_lines = 0
+        comment_lines = 0
+        blank_lines = 0
+
+        ruby_files.each do |file|
+          File.readlines(file).each do |line|
+            total_lines += 1
+            stripped = line.strip
+
+            if stripped.empty?
+              blank_lines += 1
+            elsif stripped.start_with?("#")
+              comment_lines += 1
+            else
+              code_lines += 1
+            end
+          end
+        end
+
+        {
+          files: ruby_files.count,
+          total_lines: total_lines,
+          code_lines: code_lines,
+          comment_lines: comment_lines,
+          blank_lines: blank_lines
+        }
+      end
+
+      def print_stats_table
+        puts "\n%-25s %8s %10s %10s %10s %10s" % ["Component", "Files", "Total", "Code", "Comments", "Blank"]
+        puts "-" * 75
+
+        @stats.each do |name, data|
+          puts "%-25s %8d %10d %10d %10d %10d" % [
+            name,
+            data[:files],
+            data[:total_lines],
+            data[:code_lines],
+            data[:comment_lines],
+            data[:blank_lines]
+          ]
+        end
+
+        puts "-" * 75
+      end
+
+      def print_summary
+        totals = @stats.values.reduce({
+          files: 0, total_lines: 0, code_lines: 0, comment_lines: 0, blank_lines: 0
+        }) do |sum, data|
+          sum.each_key { |k| sum[k] += data[k] }
+          sum
+        end
+
+        puts "%-25s %8d %10d %10d %10d %10d" % [
+          "TOTAL",
+          totals[:files],
+          totals[:total_lines],
+          totals[:code_lines],
+          totals[:comment_lines],
+          totals[:blank_lines]
+        ]
+
+        # Additional metrics
+        puts "\n" + "=" * 70
+        puts "Summary Metrics"
+        puts "=" * 70
+
+        lib_stats = @stats["Lyra Core (lib/)"] || { code_lines: 0 }
+        test_stats = @stats["Tests (test/)"] || { code_lines: 0 }
+
+        if lib_stats[:code_lines] > 0
+          ratio = (test_stats[:code_lines].to_f / lib_stats[:code_lines]).round(2)
+          puts "Test to Code Ratio: #{ratio}:1"
+        end
+
+        if totals[:code_lines] > 0
+          comment_ratio = ((totals[:comment_lines].to_f / totals[:code_lines]) * 100).round(1)
+          puts "Comment Density: #{comment_ratio}%"
+        end
+
+        puts "Total Ruby Files: #{totals[:files]}"
+        puts "Total Lines of Code: #{totals[:code_lines]}"
+        puts "=" * 70 + "\n\n"
+      end
+    end
+
+    CodeStats.new.run
+  end
+
+  desc "Display detailed stats for a specific component"
+  task :stats_detail, [:component] do |_t, args|
+    component = args[:component] || "lib"
+
+    puts "\n" + "=" * 70
+    puts "Detailed Stats for: #{component}"
+    puts "=" * 70
+
+    ruby_files = Dir.glob("#{component}/**/*.rb").sort
+
+    if ruby_files.empty?
+      puts "No Ruby files found in #{component}"
+      next
+    end
+
+    puts "\n%-60s %8s" % ["File", "Lines"]
+    puts "-" * 70
+
+    total = 0
+    ruby_files.each do |file|
+      lines = File.readlines(file).count
+      total += lines
+      relative_path = file.sub("#{component}/", "")
+      puts "%-60s %8d" % [relative_path.truncate(60), lines]
+    end
+
+    puts "-" * 70
+    puts "%-60s %8d" % ["TOTAL (#{ruby_files.count} files)", total]
+    puts "=" * 70 + "\n\n"
+  end
+end
+
+class String
+  def truncate(max)
+    length > max ? "...#{self[-(max-3)..]}" : self
+  end
+end