plan_my_stuff 0.3.0 → 0.5.0

data/lib/plan_my_stuff/webhook_replayer.rb

@@ -0,0 +1,280 @@
+# frozen_string_literal: true
+
+require 'fileutils'
+require 'json'
+require 'net/http'
+require 'uri'
+
+module PlanMyStuff
+  # Dev helper: fetch recent GitHub webhook deliveries via the GitHub API
+  # and POST each one to a local endpoint, so a webhook flow can be
+  # reproduced against a running server without waiting for GitHub to
+  # re-deliver.
+  #
+  # Intended for use via +plan_my_stuff:webhooks:replay+, not production
+  # code paths.
+  module WebhookReplayer
+    module_function
+
+    # POST a single webhook delivery to a local endpoint.
+    #
+    # @param headers [Hash]
+    # @param payload [String, Hash, Array]
+    # @param endpoint_url [String] full URL including path
+    #
+    # @return [Net::HTTPResponse]
+    #
+    def post(headers:, payload:, endpoint_url:)
+      uri = URI(endpoint_url)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == 'https'
+      http.open_timeout = 3_600
+      http.read_timeout = 3_600
+
+      body = payload.is_a?(String) ? JSON.parse(payload).to_json : JSON.generate(payload)
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      headers.each { |key, value| request[key.to_s] = value.to_s }
+      request['Content-Type'] ||= 'application/json'
+      request.body = body
+
+      $stdout.puts("POST #{endpoint_url}")
+      $stdout.puts("Headers: #{headers.keys.join(', ')}")
+      $stdout.puts('---')
+
+      response = http.request(request)
+      $stdout.puts("HTTP #{response.code} #{response.message}")
+      $stdout.puts(response.body) if response.body.present?
+      response
+    end
+
+    # Fetch deliveries for a hook and replay unseen ones.
+    #
+    # @param endpoint_url [String] local URL to POST replays to
+    # @param webhook_url [String] remote config.url used to resolve hook id
+    # @param scope [Symbol, String] :org or :repo
+    # @param repo [String, nil] required when scope is :repo
+    # @param processed_file [String] state file tracking replayed delivery ids
+    # @param interactive [Boolean] prompt after each successful delivery
+    #
+    # @return [void]
+    #
+    def fetch_and_replay(endpoint_url:, webhook_url:, processed_file:, scope: :org, repo: nil, interactive: true)
+      scope = scope.to_sym
+      hook_id = resolve_hook_id(scope: scope, repo: repo, webhook_url: webhook_url)
+      deliveries_path = "#{hooks_base_path(scope: scope, repo: repo)}/#{hook_id}/deliveries"
+      $stdout.puts("Using #{scope} hook #{hook_id} -> #{webhook_url}")
+
+      processed = load_processed(processed_file)
+      $stdout.puts("Already processed: #{processed.size}")
+
+      deliveries = gh_get(deliveries_path, per_page: 50).sort_by { |d| d['delivered_at'].to_s }
+      to_process = deliveries.reject { |d| processed.include?(d['id'].to_s) }
+      $stdout.puts("Fetched #{deliveries.size} deliveries, #{to_process.size} new")
+      if to_process.empty?
+        $stdout.puts('Nothing to do.')
+        return
+      end
+
+      replay_each(to_process, deliveries_path, endpoint_url, processed_file, interactive: interactive)
+    end
+
+    # Polls one or more webhooks on an interval and auto-replays new
+    # deliveries as they arrive. Resolves hook ids once up front, then
+    # loops forever until Ctrl-C.
+    #
+    # @param targets [Array<Hash>] one hash per hook, each with
+    #   +:scope+ (:org / :repo), +:webhook_url+, and +:repo+ (for :repo scope)
+    # @param endpoint_url [String] local URL to POST replays to
+    # @param processed_file_for [#call] lambda taking a target hash,
+    #   returns the state file path for that target
+    # @param interval [Integer] seconds between polls (default 15)
+    #
+    # @return [void]
+    #
+    def listen(targets:, endpoint_url:, processed_file_for:, interval: 30)
+      resolved = targets.map { |t| resolve_target(t, processed_file_for) }
+      $stdout.puts("Listening on #{resolved.size} hook(s) every #{interval}s. Ctrl-C to stop.")
+      resolved.each do |r|
+        $stdout.puts("  #{r[:scope]} hook #{r[:hook_id]} -> #{r[:webhook_url]}")
+      end
+
+      loop do
+        poll_all(resolved, endpoint_url)
+        $stdout.puts('=============')
+        $stdout.puts('  Sleeping...')
+        $stdout.puts('=============')
+        sleep(interval)
+      end
+    rescue Interrupt
+      $stdout.puts("\nStopped.")
+    end
+
+    # Resolves a listen target's hook id and precomputes its deliveries
+    # path + processed-file location.
+    #
+    # @return [Hash]
+    #
+    def resolve_target(target, processed_file_for)
+      scope = target.fetch(:scope).to_sym
+      repo = target[:repo]
+      webhook_url = target.fetch(:webhook_url)
+      hook_id = resolve_hook_id(scope: scope, repo: repo, webhook_url: webhook_url)
+
+      {
+        scope: scope,
+        repo: repo,
+        webhook_url: webhook_url,
+        hook_id: hook_id,
+        deliveries_path: "#{hooks_base_path(scope: scope, repo: repo)}/#{hook_id}/deliveries",
+        processed_file: processed_file_for.call(target),
+      }
+    end
+
+    # Collects unprocessed deliveries across every resolved target,
+    # merges them into a single list sorted by +delivered_at+, then
+    # replays them one-by-one in true chronological order. Transient
+    # API errors per target are logged and swallowed so the listen
+    # loop survives.
+    #
+    # @param resolved [Array<Hash>]
+    # @param endpoint_url [String]
+    #
+    # @return [void]
+    #
+    def poll_all(resolved, endpoint_url)
+      pending = []
+      resolved.each do |target|
+        processed = load_processed(target[:processed_file])
+        deliveries = gh_get(target[:deliveries_path], per_page: 50)
+        deliveries.each do |summary|
+          next if processed.include?(summary['id'].to_s)
+
+          pending << { target: target, summary: summary }
+        end
+      rescue Octokit::Error => e
+        warn("[#{target[:scope]}] poll failed: #{e.message}")
+      end
+
+      return if pending.empty?
+
+      pending.sort_by! { |item| item[:summary]['delivered_at'].to_s }
+      $stdout.puts("Replaying #{pending.size} delivery(ies) in delivered_at order")
+      replay_pending(pending, endpoint_url)
+    end
+
+    # Replays a pre-sorted, multi-target pending list one delivery at
+    # a time. Stops on the first non-success so state can be
+    # investigated without skipping ahead.
+    #
+    # @return [void]
+    #
+    def replay_pending(pending, endpoint_url)
+      pending.each.with_index(1) do |item, index|
+        target = item[:target]
+        summary = item[:summary]
+        id = summary['id']
+        delivery = gh_get("#{target[:deliveries_path]}/#{id}")
+        request_data = delivery.fetch('request')
+        github_delivery_id = request_data.dig('headers', 'X-GitHub-Delivery') || id
+
+        event = "#{summary['event']}.#{summary['action']}"
+        $stdout.puts(
+          "[#{index}/#{pending.size}] #{target[:scope]} #{id} #{event} " \
+            "@ #{summary['delivered_at']} - #{github_delivery_id}",
+        )
+
+        response = post(
+          headers: request_data.fetch('headers') || {},
+          payload: request_data.fetch('payload'),
+          endpoint_url: endpoint_url,
+        )
+
+        unless response.is_a?(Net::HTTPSuccess)
+          raise('  ! non-success; stopping so you can investigate')
+        end
+
+        mark_processed(target[:processed_file], id)
+      end
+    end
+
+    # @return [String]
+    def hooks_base_path(scope:, repo:)
+      case scope
+      when :org
+        "/orgs/#{PlanMyStuff.configuration.organization}/hooks"
+      when :repo
+        raise(ArgumentError, 'repo is required for :repo scope') if repo.nil? || repo.to_s.empty?
+
+        "/repos/#{repo}/hooks"
+      else
+        raise(ArgumentError, "Unknown scope #{scope.inspect}; expected :org or :repo")
+      end
+    end
+
+    # @return [Integer]
+    def resolve_hook_id(scope:, repo:, webhook_url:)
+      hooks = gh_get(hooks_base_path(scope: scope, repo: repo), per_page: 100)
+      match = hooks.find { |h| h.dig('config', 'url') == webhook_url }
+      return match['id'] if match.present?
+
+      available = hooks.map { |h| "  id=#{h['id']} url=#{h.dig('config', 'url')}" }.join("\n")
+      raise(PlanMyStuff::Error, "No #{scope} webhook with config.url == #{webhook_url}. Visible:\n#{available}")
+    end
+
+    # Calls +octokit.get+ and returns the parsed JSON body (string-keyed
+    # Hash/Array) rather than Sawyer::Resource, so delivery payload and
+    # headers are easy to re-serialize.
+    #
+    # @return [Array, Hash]
+    #
+    def gh_get(path, **params)
+      client = PlanMyStuff.client.octokit
+      client.get(path, params)
+      JSON.parse(client.last_response.body)
+    end
+
+    # @return [Set<String>]
+    def load_processed(path)
+      return Set.new unless File.exist?(path)
+
+      File.readlines(path, chomp: true).reject(&:empty?).to_set
+    end
+
+    # @return [void]
+    def mark_processed(path, id)
+      FileUtils.mkdir_p(File.dirname(path))
+      File.open(path, 'a') { |f| f.puts(id) }
+    end
+
+    # @return [void]
+    def replay_each(to_process, deliveries_path, endpoint_url, processed_file, interactive:)
+      to_process.each.with_index(1) do |summary, index|
+        id = summary['id']
+        delivery = gh_get("#{deliveries_path}/#{id}")
+        request_data = delivery.fetch('request')
+        github_delivery_id = request_data.dig('headers', 'X-GitHub-Delivery') || id
+
+        event = "#{summary['event']}.#{summary['action']}"
+        $stdout.puts("[#{index}/#{to_process.size}] #{id} #{event} - #{github_delivery_id}")
+
+        response = post(
+          headers: request_data.fetch('headers') || {},
+          payload: request_data.fetch('payload'),
+          endpoint_url: endpoint_url,
+        )
+
+        unless response.is_a?(Net::HTTPSuccess)
+          raise('  ! non-success; stopping so you can investigate')
+        end
+
+        mark_processed(processed_file, id)
+        next unless interactive
+
+        $stdout.puts("Processed #{github_delivery_id} - Continue? (y/n)")
+        answer = $stdin.gets
+        break unless answer&.downcase&.start_with?('y')
+      end
+    end
+  end
+end

data/lib/plan_my_stuff.rb

@@ -4,7 +4,13 @@ require 'active_support/core_ext/array/wrap'
 require 'active_support/core_ext/object/blank'
 
 require_relative 'plan_my_stuff/application_record'
+require_relative 'plan_my_stuff/approval'
+require_relative 'plan_my_stuff/archive'
 require_relative 'plan_my_stuff/base_metadata'
+require_relative 'plan_my_stuff/base_project'
+require_relative 'plan_my_stuff/base_project_item'
+require_relative 'plan_my_stuff/base_project_metadata'
+require_relative 'plan_my_stuff/cache'
 require_relative 'plan_my_stuff/client'
 require_relative 'plan_my_stuff/comment'
 require_relative 'plan_my_stuff/comment_metadata'
@@ -12,15 +18,24 @@ require_relative 'plan_my_stuff/configuration'
 require_relative 'plan_my_stuff/custom_fields'
 require_relative 'plan_my_stuff/engine' if defined?(Rails)
 require_relative 'plan_my_stuff/errors'
+require_relative 'plan_my_stuff/graphql/queries'
 require_relative 'plan_my_stuff/issue'
 require_relative 'plan_my_stuff/issue_metadata'
 require_relative 'plan_my_stuff/label'
+require_relative 'plan_my_stuff/link'
 require_relative 'plan_my_stuff/markdown'
 require_relative 'plan_my_stuff/metadata_parser'
+require_relative 'plan_my_stuff/notifications'
+require_relative 'plan_my_stuff/pipeline'
 require_relative 'plan_my_stuff/project'
 require_relative 'plan_my_stuff/project_item'
+require_relative 'plan_my_stuff/project_item_metadata'
 require_relative 'plan_my_stuff/project_metadata'
+require_relative 'plan_my_stuff/reminders'
 require_relative 'plan_my_stuff/repo'
+require_relative 'plan_my_stuff/testing_project'
+require_relative 'plan_my_stuff/testing_project_item'
+require_relative 'plan_my_stuff/testing_project_metadata'
 require_relative 'plan_my_stuff/user_resolver'
 require_relative 'plan_my_stuff/verifier'
 require_relative 'plan_my_stuff/version'

data/lib/tasks/plan_my_stuff.rake

@@ -1,6 +1,185 @@
 # frozen_string_literal: true
 
 namespace :plan_my_stuff do
+  desc 'Run the plan_my_stuff install generator (alias for `rails g plan_my_stuff:install`)'
+  task install: :environment do
+    require 'rails/generators'
+
+    require 'generators/plan_my_stuff/install/install_generator'
+    PlanMyStuff::Generators::InstallGenerator.start([])
+  end
+
+  desc 'Copy plan_my_stuff view templates (alias for `rails g plan_my_stuff:views`)'
+  task views: :environment do
+    require 'rails/generators'
+
+    require 'generators/plan_my_stuff/views/views_generator'
+    PlanMyStuff::Generators::ViewsGenerator.start([])
+  end
+
+  namespace :webhooks do
+    desc 'Create an organization webhook (URL=... [EVENTS=ev1,ev2])'
+    task create_org: :environment do
+      url = ENV.fetch('URL') { raise('URL env var is required') }
+      events = %w[projects_v2 projects_v2_item projects_v2_status_update]
+      config = PlanMyStuff.configuration
+      raise('PlanMyStuff.configuration.webhook_secret is blank') if config.webhook_secret.blank?
+
+      hook = PlanMyStuff.client.rest(
+        :create_org_hook,
+        config.organization,
+        { url: url, content_type: 'json', secret: config.webhook_secret, insecure_ssl: '0' },
+        { events: events, active: true },
+      )
+
+      puts("Created org hook #{hook.id} on #{config.organization} -> #{url}")
+      puts("Events: #{events.join(', ')}")
+    end
+
+    desc 'Create a repo webhook (REPO=owner/name URL=... [EVENTS=ev1,ev2])'
+    task create_repo: :environment do
+      url = ENV.fetch('URL') { raise('URL env var is required') }
+      repo = ENV.fetch('REPO') do
+        PlanMyStuff.client.resolve_repo ||
+          raise('REPO env var is required or configured (e.g. BrandsInsurance/PlanMyStuff)')
+      end
+      events = %w[pull_request issues]
+      config = PlanMyStuff.configuration
+      raise('PlanMyStuff.configuration.webhook_secret is blank') if config.webhook_secret.blank?
+
+      hook = PlanMyStuff.client.rest(
+        :create_hook,
+        repo,
+        'web',
+        { url: url, content_type: 'json', secret: config.webhook_secret, insecure_ssl: '0' },
+        { events: events, active: true },
+      )
+
+      puts("Created repo hook #{hook.id} on #{repo} -> #{url}")
+      puts("Events: #{events.join(', ')}")
+    end
+
+    desc 'Replay recent deliveries to a local endpoint (ENDPOINT_URL=... WEBHOOK_URL=... ' \
+      '[SCOPE=org|repo] [REPO=owner/name] [PROCESSED_FILE=...] [NON_INTERACTIVE=1])'
+    task replay: :environment do
+      require 'plan_my_stuff/webhook_replayer'
+
+      endpoint_url = ENV.fetch('ENDPOINT_URL') { raise('ENDPOINT_URL env var is required') }
+      webhook_url = ENV.fetch('WEBHOOK_URL') { raise('WEBHOOK_URL env var is required') }
+      scope = ENV.fetch('SCOPE', 'org').to_sym
+      repo = ENV.fetch('REPO', nil)
+      processed_file =
+        ENV.fetch('PROCESSED_FILE') do
+          Rails.root.join('tmp', 'plan_my_stuff', "webhook_replay_#{scope}_processed.txt").to_s
+        end
+      interactive = ENV['NON_INTERACTIVE'].to_s.strip.empty?
+
+      PlanMyStuff::WebhookReplayer.fetch_and_replay(
+        endpoint_url: endpoint_url,
+        webhook_url: webhook_url,
+        scope: scope,
+        repo: repo,
+        processed_file: processed_file,
+        interactive: interactive,
+      )
+    end
+
+    desc 'Continuously poll org + repo hooks and auto-replay new deliveries ' \
+      '(ENDPOINT_URL=... [ORG_WEBHOOK_URL=...] [REPO_WEBHOOK_URL=... REPO=owner/name] [INTERVAL=15])'
+    task listen: :environment do
+      require 'plan_my_stuff/webhook_replayer'
+
+      endpoint_url = ENV.fetch('ENDPOINT_URL') { raise('ENDPOINT_URL env var is required') }
+      org_webhook_url = ENV.fetch('ORG_WEBHOOK_URL', nil)
+      repo_webhook_url = ENV.fetch('REPO_WEBHOOK_URL', nil)
+      repo = ENV.fetch('REPO', nil)
+      interval = ENV.fetch('INTERVAL', '30').to_i
+
+      targets = []
+      targets << { scope: :org, webhook_url: org_webhook_url } if org_webhook_url.present?
+      if repo_webhook_url.present?
+        raise('REPO env var required when REPO_WEBHOOK_URL is set') if repo.blank?
+
+        targets << { scope: :repo, webhook_url: repo_webhook_url, repo: repo }
+      end
+      raise('Set at least one of ORG_WEBHOOK_URL or REPO_WEBHOOK_URL') if targets.empty?
+
+      processed_file_for = -> (target) {
+        Rails.root.join('tmp', 'plan_my_stuff', "webhook_listen_#{target[:scope]}_processed.txt").to_s
+      }
+
+      PlanMyStuff::WebhookReplayer.listen(
+        targets: targets,
+        endpoint_url: endpoint_url,
+        processed_file_for: processed_file_for,
+        interval: interval,
+      )
+    end
+
+    desc 'Simulate an AWS SNS deployment webhook to a local endpoint ' \
+      '(ENDPOINT_URL=... [EVENT=SERVICE_DEPLOYMENT_COMPLETED])'
+    task simulate_aws: :environment do
+      require 'plan_my_stuff/aws_sns_simulator'
+
+      endpoint_url = ENV.fetch('ENDPOINT_URL') { raise('ENDPOINT_URL env var is required') }
+      event_name = ENV.fetch('EVENT', PlanMyStuff::AwsSnsSimulator::DEFAULT_EVENT)
+
+      PlanMyStuff::AwsSnsSimulator.post(
+        endpoint_url: endpoint_url,
+        event_name: event_name,
+      )
+    end
+  end
+
+  namespace :reminders do
+    desc 'Enqueue a RemindersSweepJob per configured repo ' \
+      '([REPO=<key>] to target a single repo)'
+    task sweep: :environment do
+      config = PlanMyStuff.configuration
+      repo_keys =
+        if ENV['REPO'].present?
+          [ENV['REPO'].to_sym]
+        else
+          config.repos.keys
+        end
+
+      raise('No repos configured (set config.repos or pass REPO=<key>)') if repo_keys.empty?
+
+      repo_keys.each do |key|
+        PlanMyStuff::RemindersSweepJob.requeue(key)
+        puts("Scheduled RemindersSweepJob for #{key.inspect} " \
+          "(#{config.repos[key] || '<unknown>'}) at #{PlanMyStuff::RemindersSweepJob.next_run.iso8601}")
+      end
+    end
+  end
+
+  namespace :testing do
+    desc 'Create a TestingProject template in the configured organization. ' \
+      'Bootstraps all testing custom fields. Set the returned project number as ' \
+      'config.testing_template_project_number, then configure its board view ' \
+      'and "Column by: Test Status" manually in the GitHub UI. ' \
+      'Options: TITLE="My Template" (default: "PMS Testing Template")'
+    task create_template: :environment do
+      title = ENV.fetch('TITLE', '[TEMPLATE] Testing Feature')
+
+      puts("Creating testing project template '#{title}' in " \
+        "#{PlanMyStuff.configuration.organization}...")
+
+      project = PlanMyStuff::TestingProject.create!(title: title)
+
+      puts
+      puts("\e[32mTemplate created successfully.\e[0m")
+      puts("  Title:   #{project.title}")
+      puts("  Number:  #{project.number}")
+      puts("  URL:     #{project.url}")
+      puts
+      puts('Next steps:')
+      puts('  1. Open the project in GitHub and set the board view to "Column by: Test Status"')
+      puts('  2. Add to your PlanMyStuff initializer:')
+      puts("       config.testing_template_project_number = #{project.number}")
+    end
+  end
+
   desc 'Verify PlanMyStuff configuration: token, org, repos, and project access'
   task verify: :environment do
     require 'plan_my_stuff/verifier'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: plan_my_stuff
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Brands Insurance
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-06 00:00:00.000000000 Z
+date: 2026-04-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -56,17 +56,34 @@ files:
 - README.md
 - app/controllers/plan_my_stuff/application_controller.rb
 - app/controllers/plan_my_stuff/comments_controller.rb
+- app/controllers/plan_my_stuff/issues/approvals_controller.rb
+- app/controllers/plan_my_stuff/issues/closures_controller.rb
+- app/controllers/plan_my_stuff/issues/links_controller.rb
+- app/controllers/plan_my_stuff/issues/takes_controller.rb
+- app/controllers/plan_my_stuff/issues/viewers_controller.rb
+- app/controllers/plan_my_stuff/issues/waitings_controller.rb
 - app/controllers/plan_my_stuff/issues_controller.rb
 - app/controllers/plan_my_stuff/labels_controller.rb
+- app/controllers/plan_my_stuff/project_items/assignments_controller.rb
+- app/controllers/plan_my_stuff/project_items/statuses_controller.rb
 - app/controllers/plan_my_stuff/project_items_controller.rb
 - app/controllers/plan_my_stuff/projects_controller.rb
+- app/controllers/plan_my_stuff/testing_project_items/results_controller.rb
+- app/controllers/plan_my_stuff/testing_project_items_controller.rb
+- app/controllers/plan_my_stuff/testing_projects_controller.rb
+- app/controllers/plan_my_stuff/webhooks/aws_controller.rb
+- app/controllers/plan_my_stuff/webhooks/github_controller.rb
+- app/jobs/plan_my_stuff/application_job.rb
+- app/jobs/plan_my_stuff/reminders_sweep_job.rb
 - app/views/plan_my_stuff/comments/edit.html.erb
 - app/views/plan_my_stuff/comments/partials/_form.html.erb
 - app/views/plan_my_stuff/issues/edit.html.erb
 - app/views/plan_my_stuff/issues/index.html.erb
 - app/views/plan_my_stuff/issues/new.html.erb
+- app/views/plan_my_stuff/issues/partials/_approvals.html.erb
 - app/views/plan_my_stuff/issues/partials/_form.html.erb
 - app/views/plan_my_stuff/issues/partials/_labels.html.erb
+- app/views/plan_my_stuff/issues/partials/_links.html.erb
 - app/views/plan_my_stuff/issues/partials/_viewers.html.erb
 - app/views/plan_my_stuff/issues/show.html.erb
 - app/views/plan_my_stuff/projects/edit.html.erb
@@ -74,13 +91,29 @@ files:
 - app/views/plan_my_stuff/projects/new.html.erb
 - app/views/plan_my_stuff/projects/partials/_form.html.erb
 - app/views/plan_my_stuff/projects/show.html.erb
+- app/views/plan_my_stuff/testing_project_items/new.html.erb
+- app/views/plan_my_stuff/testing_project_items/results/new.html.erb
+- app/views/plan_my_stuff/testing_projects/edit.html.erb
+- app/views/plan_my_stuff/testing_projects/new.html.erb
+- app/views/plan_my_stuff/testing_projects/partials/_form.html.erb
+- app/views/plan_my_stuff/testing_projects/partials/_item.html.erb
+- app/views/plan_my_stuff/testing_projects/partials/items/_form.html.erb
+- app/views/plan_my_stuff/testing_projects/show.html.erb
 - config/routes.rb
 - lib/generators/plan_my_stuff/install/install_generator.rb
 - lib/generators/plan_my_stuff/install/templates/initializer.rb
 - lib/generators/plan_my_stuff/views/views_generator.rb
 - lib/plan_my_stuff.rb
 - lib/plan_my_stuff/application_record.rb
+- lib/plan_my_stuff/approval.rb
+- lib/plan_my_stuff/archive.rb
+- lib/plan_my_stuff/archive/sweep.rb
+- lib/plan_my_stuff/aws_sns_simulator.rb
 - lib/plan_my_stuff/base_metadata.rb
+- lib/plan_my_stuff/base_project.rb
+- lib/plan_my_stuff/base_project_item.rb
+- lib/plan_my_stuff/base_project_metadata.rb
+- lib/plan_my_stuff/cache.rb
 - lib/plan_my_stuff/client.rb
 - lib/plan_my_stuff/comment.rb
 - lib/plan_my_stuff/comment_metadata.rb
@@ -88,19 +121,34 @@ files:
 - lib/plan_my_stuff/custom_fields.rb
 - lib/plan_my_stuff/engine.rb
 - lib/plan_my_stuff/errors.rb
+- lib/plan_my_stuff/graphql/queries.rb
 - lib/plan_my_stuff/issue.rb
 - lib/plan_my_stuff/issue_metadata.rb
 - lib/plan_my_stuff/label.rb
+- lib/plan_my_stuff/link.rb
 - lib/plan_my_stuff/markdown.rb
 - lib/plan_my_stuff/metadata_parser.rb
+- lib/plan_my_stuff/notifications.rb
+- lib/plan_my_stuff/pipeline.rb
+- lib/plan_my_stuff/pipeline/issue_linker.rb
+- lib/plan_my_stuff/pipeline/status.rb
 - lib/plan_my_stuff/project.rb
 - lib/plan_my_stuff/project_item.rb
+- lib/plan_my_stuff/project_item_metadata.rb
 - lib/plan_my_stuff/project_metadata.rb
+- lib/plan_my_stuff/reminders.rb
+- lib/plan_my_stuff/reminders/closer.rb
+- lib/plan_my_stuff/reminders/fire.rb
+- lib/plan_my_stuff/reminders/sweep.rb
 - lib/plan_my_stuff/repo.rb
 - lib/plan_my_stuff/test_helpers.rb
+- lib/plan_my_stuff/testing_project.rb
+- lib/plan_my_stuff/testing_project_item.rb
+- lib/plan_my_stuff/testing_project_metadata.rb
 - lib/plan_my_stuff/user_resolver.rb
 - lib/plan_my_stuff/verifier.rb
 - lib/plan_my_stuff/version.rb
+- lib/plan_my_stuff/webhook_replayer.rb
 - lib/tasks/plan_my_stuff.rake
 homepage: https://github.com/brandsinsurance/PlanMyStuff/
 licenses:
@@ -110,7 +158,33 @@ metadata:
   homepage_uri: https://github.com/brandsinsurance/PlanMyStuff/
   source_code_uri: https://github.com/brandsinsurance/PlanMyStuff
   changelog_uri: https://github.com/brandsinsurance/PlanMyStuff/blob/main/CHANGELOG.md
-post_install_message:
+post_install_message: |
+  Thanks for installing plan_my_stuff!
+
+  Getting started:
+
+    rake plan_my_stuff:install
+      Generates config/initializers/plan_my_stuff.rb and mounts the engine
+
+    rake plan_my_stuff:views
+      Copies view templates to app/views/plan_my_stuff/ (optional)
+
+  Available rake tasks:
+
+    plan_my_stuff:verify
+      Verify token, org, repos, and project access
+
+    plan_my_stuff:webhooks:create_org       URL=... [EVENTS=...]
+    plan_my_stuff:webhooks:create_repo      URL=... [REPO=owner/name] [EVENTS=...]
+    plan_my_stuff:webhooks:replay           ENDPOINT_URL=... WEBHOOK_URL=... [SCOPE=org|repo]
+    plan_my_stuff:webhooks:listen           ENDPOINT_URL=... [ORG_WEBHOOK_URL=...] [REPO_WEBHOOK_URL=... REPO=...]
+    plan_my_stuff:webhooks:simulate_aws     ENDPOINT_URL=... [EVENT=...]
+
+    plan_my_stuff:reminders:sweep           [REPO=<key>]
+
+    plan_my_stuff:testing:create_template   [TITLE=...]
+
+  Run `rake -D plan_my_stuff` for full descriptions.
 rdoc_options: []
 require_paths:
 - lib