predictability-engine 0.6.6

data/lib/predictability_engine.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+require 'active_support/all'
+require 'zeitwerk'
+require 'csv'
+require 'dotenv'
+require 'json'
+require 'langchain'
+
+Dotenv.load
+
+require_relative 'predictability_engine/logger'
+
+loader = Zeitwerk::Loader.for_gem
+loader.ignore("#{__dir__}/predictability_engine/logger.rb") # Manual require
+loader.setup
+
+# Auto-inject SemanticLogger::Loggable into every class/module defined under
+# PredictabilityEngine:: so each gains its own named `logger` / `self.logger`
+# without polluting Object.
+TracePoint.new(:end) do |tp|
+  mod = tp.self
+  next unless mod.is_a?(Module)
+  next unless mod.name&.start_with?('PredictabilityEngine::')
+  next if mod.ancestors.include?(SemanticLogger::Loggable)
+
+  mod.include(SemanticLogger::Loggable)
+end.enable
+
+module PredictabilityEngine
+  class Error < StandardError; end
+  DEFAULT_PERCENTILES = [50, 75, 85, 95, 98].freeze
+
+  def self.completed_items(items)
+    items.select(&:completed?)
+  end
+
+  def self.active_items(items)
+    items.reject(&:completed?)
+  end
+
+  def self.today
+    ENV['MOCK_TODAY'] ? Date.parse(ENV['MOCK_TODAY']) : Date.current
+  end
+
+  def self.cycle_time_percentile(items, percentile)
+    Calculators::CycleTime.percentile(items, percentile)
+  end
+
+  def self.mapped_percentiles(work_items, percentiles = DEFAULT_PERCENTILES)
+    percentiles.map do |p|
+      val = cycle_time_percentile(work_items, p)
+      { val: val, label: "#{p}% Percentile", p: p } if val
+    end.compact
+  end
+
+  def self.load_items(spec, **)
+    manager = DataManager.new
+    manager.load(spec, **)
+    manager.work_items
+  end
+
+  def self.run_report(file, format, **)
+    ReportGenerator.run_report(file, format, **)
+  end
+
+  def self.write_report(input_file, format, content, output, type: :all)
+    ReportGenerator.write_report(input_file, format, content, output, type: type)
+  end
+
+  def self.run_and_print_report(file, format, options, items: nil, **extra)
+    output = extra.delete(:output)
+    opts = options.to_h.symbolize_keys.merge(output: output)
+    message = run_report(file, format, items: items, **opts, **extra)
+    logger.info { message }
+  end
+
+  def self.format_date(date)
+    return nil unless date
+
+    date.to_date.to_s
+  end
+
+  def self.format_year_week(date)
+    return nil unless date
+
+    date.to_date.strftime('%G-W%V')
+  end
+
+  def self.format_year_month(date)
+    return nil unless date
+
+    date.to_date.strftime('%Y-%m')
+  end
+
+  def self.format_datetime(time)
+    return nil unless time
+
+    time.to_time.strftime('%Y-%m-%d %H:%M')
+  end
+
+  def self.warn_chart_failure(error, context:)
+    logger.warn { "Chart image generation failed: #{error.message}. #{context}" }
+  end
+
+  def self.write_file(path, content)
+    FileUtils.mkdir_p(File.dirname(path))
+    File.write(path, content)
+  end
+
+  def self.sample_data_path(name = 'sample_data.csv')
+    path = File.join(File.expand_path('..', __dir__), 'data', 'samples', name)
+    raise Error, "Sample data not found: #{path}" unless File.exist?(path)
+
+    path
+  end
+end

metadata

@@ -0,0 +1,566 @@
+--- !ruby/object:Gem::Specification
+name: predictability-engine
+version: !ruby/object:Gem::Version
+  version: 0.6.6
+platform: ruby
+authors:
+- cbp-org
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: caxlsx
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jira-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: langchainrb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: matrix
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: playwright-ruby-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: powerpoint
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: prawn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: roo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rotp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: semantic_logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: unicode_plot
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: vega
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: benchmark-ips
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler-audit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: gem-release
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake-gem-maintenance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+executables:
+- predictability-engine
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/predictability-engine
+- bin/predictability-engine.bat
+- bin/setup
+- data/samples/sample_data.csv
+- data/samples/sample_data_large.csv
+- data/samples/wip_data.csv
+- lib/predictability_engine.rb
+- lib/predictability_engine/agents/assistant.rb
+- lib/predictability_engine/agents/tools.rb
+- lib/predictability_engine/calculators/aging.rb
+- lib/predictability_engine/calculators/cfd.rb
+- lib/predictability_engine/calculators/cfd_forecaster.rb
+- lib/predictability_engine/calculators/cycle_time.rb
+- lib/predictability_engine/calculators/throughput.rb
+- lib/predictability_engine/cli.rb
+- lib/predictability_engine/config.rb
+- lib/predictability_engine/data_generator.rb
+- lib/predictability_engine/data_manager.rb
+- lib/predictability_engine/data_sources/base.rb
+- lib/predictability_engine/data_sources/csv.rb
+- lib/predictability_engine/data_sources/excel.rb
+- lib/predictability_engine/data_sources/factory.rb
+- lib/predictability_engine/data_sources/jira.rb
+- lib/predictability_engine/data_sources/jira_yaml.rb
+- lib/predictability_engine/duration.rb
+- lib/predictability_engine/excel_exporter.rb
+- lib/predictability_engine/html_style.rb
+- lib/predictability_engine/html_templates.rb
+- lib/predictability_engine/jira_auth.rb
+- lib/predictability_engine/jira_auth/base.rb
+- lib/predictability_engine/jira_auth/basic.rb
+- lib/predictability_engine/jira_auth/bearer.rb
+- lib/predictability_engine/jira_auth/cookie.rb
+- lib/predictability_engine/jira_auth/mfa_api.rb
+- lib/predictability_engine/jira_auth/mfa_browser.rb
+- lib/predictability_engine/jira_config_prompter.rb
+- lib/predictability_engine/jira_workflow.rb
+- lib/predictability_engine/logger.rb
+- lib/predictability_engine/mermaid_visualizer.rb
+- lib/predictability_engine/models/work_item.rb
+- lib/predictability_engine/pdf_visualizer.rb
+- lib/predictability_engine/pdf_visualizer/primitives.rb
+- lib/predictability_engine/raw_data_exporter.rb
+- lib/predictability_engine/report.rb
+- lib/predictability_engine/report/constants.rb
+- lib/predictability_engine/report/image_generator.rb
+- lib/predictability_engine/report/text_renderer.rb
+- lib/predictability_engine/report_generator.rb
+- lib/predictability_engine/setup_manager.rb
+- lib/predictability_engine/simulators/monte_carlo.rb
+- lib/predictability_engine/simulators/monte_carlo_validator.rb
+- lib/predictability_engine/summary_visualizer.rb
+- lib/predictability_engine/summary_visualizer/helpers.rb
+- lib/predictability_engine/summary_visualizer/renderer.rb
+- lib/predictability_engine/terminal_visualizer.rb
+- lib/predictability_engine/terminal_visualizer/cfd_renderer.rb
+- lib/predictability_engine/vega_visualizer.rb
+- lib/predictability_engine/vega_visualizer/aging_wip_visualizer.rb
+- lib/predictability_engine/vega_visualizer/basic_charts.rb
+- lib/predictability_engine/vega_visualizer/cfd_charts.rb
+- lib/predictability_engine/vega_visualizer/cfd_layout.rb
+- lib/predictability_engine/vega_visualizer/tooltip_helpers.rb
+- lib/predictability_engine/version.rb
+- lib/predictability_engine/visualizer.rb
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message: |
+  ─────────────────────────────────────────────────────────────────
+  predictability-engine installed.
+
+  Requires Ruby >= 4.0.3. If not installed yet:
+    macOS:   brew install rbenv && rbenv install 4.0.3
+    Linux:   curl -fsSL https://mise.run | sh && mise install
+    Windows: https://rubyinstaller.org
+
+  Run the idempotent setup to install Node.js, Playwright, and
+  Chromium (required for PDF, PNG, and PPTX report generation):
+
+    predictability-engine setup
+
+  Re-run at any time to upgrade dependencies.
+  ─────────────────────────────────────────────────────────────────
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 4.0.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Actionable Agile Metrics and Monte Carlo forecasting engine
+test_files: []