plan_my_stuff 0.1.0 → 1.0.0

data/lib/tasks/plan_my_stuff.rake

@@ -1,6 +1,337 @@
 # 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]). ' \
+      'Raises PlanMyStuff::ConfigurationError if config.webhook_secret is blank.'
+    task create_org: :environment do
+      url = ENV.fetch('URL') { raise(ArgumentError, 'URL env var is required') }
+      default_events = %w[projects_v2 projects_v2_item projects_v2_status_update]
+      events = ENV['EVENTS'].present? ? ENV['EVENTS'].split(',').map(&:strip).compact_blank : default_events
+      config = PlanMyStuff.configuration
+      if config.webhook_secret.blank?
+        raise(PlanMyStuff::ConfigurationError, 'PlanMyStuff.configuration.webhook_secret is blank')
+      end
+
+      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]). ' \
+      'Raises PlanMyStuff::ConfigurationError if config.webhook_secret is blank.'
+    task create_repo: :environment do
+      url = ENV.fetch('URL') { raise(ArgumentError, 'URL env var is required') }
+      repo = ENV.fetch('REPO') do
+        PlanMyStuff.client.resolve_repo!
+      rescue PlanMyStuff::ConfigurationError, ArgumentError
+        raise(ArgumentError, 'REPO env var is required or configured (e.g. BrandsInsurance/PlanMyStuff)')
+      end
+      default_events = %w[pull_request issues]
+      events = ENV['EVENTS'].present? ? ENV['EVENTS'].split(',').map(&:strip).compact_blank : default_events
+      config = PlanMyStuff.configuration
+      if config.webhook_secret.blank?
+        raise(PlanMyStuff::ConfigurationError, 'PlanMyStuff.configuration.webhook_secret is blank')
+      end
+
+      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(ArgumentError, 'ENDPOINT_URL env var is required') }
+      webhook_url = ENV.fetch('WEBHOOK_URL') { raise(ArgumentError, '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=30]). ' \
+      'At least one of ORG_WEBHOOK_URL or REPO_WEBHOOK_URL is required (raises ArgumentError if both absent).'
+    task listen: :environment do
+      require 'plan_my_stuff/webhook_replayer'
+
+      endpoint_url = ENV.fetch('ENDPOINT_URL') { raise(ArgumentError, '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(ArgumentError, '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(ArgumentError, '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(ArgumentError, '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). ' \
+      'Raises PlanMyStuff::ConfigurationError when no repos are configured (config.repos empty and REPO unset).'
+    task sweep: :environment do
+      config = PlanMyStuff.configuration
+      repo_keys =
+        if ENV['REPO'].present?
+          [ENV['REPO'].to_sym]
+        else
+          config.repos.keys
+        end
+
+      if repo_keys.empty?
+        raise(PlanMyStuff::ConfigurationError, 'No repos configured (set config.repos or pass REPO=<key>)')
+      end
+
+      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 'Print all GitHub primary rate-limit buckets for the configured token. ' \
+    'Note: secondary/abuse limits and content-creation limits are NOT surfaced by GitHub ' \
+    'until you hit them, so a healthy report here does not guarantee writes will succeed.'
+  task rate_limit: :environment do
+    data = PlanMyStuff.client.rest(:get, '/rate_limit').to_h
+    resources = data[:resources] || {}
+
+    width = resources.keys.map { |k| k.to_s.length }.max || 0
+    resources.sort.each do |name, bucket|
+      next if bucket[:used].zero?
+
+      reset_at = Time.at(bucket[:reset]).utc
+      reset_in = [bucket[:reset] - Time.now.to_i, 0].max
+      puts(format(
+        '%-*s  used=%-5d remaining=%-5d limit=%-5d resets_at=%s (in %ds)',
+        width,
+        name,
+        bucket[:used],
+        bucket[:remaining],
+        bucket[:limit],
+        reset_at.iso8601,
+        reset_in,
+      ))
+    end
+  end
+
+  namespace :debug do
+    desc 'Probe GitHub issue body size limit by creating issues of increasing size, then closing them. ' \
+      'Options: REPO=owner/name (default: config.default_repo) START=60000 MAX=70000 STEP=1000 ' \
+      'LABEL=body-size-probe KEEP=0 (set KEEP=1 to leave issues open for inspection)'
+    task body_size_limit: :environment do
+      client = PlanMyStuff.client
+      repo = client.resolve_repo!(ENV.fetch('REPO', nil))
+      start = Integer(ENV.fetch('START', '60000'))
+      max = Integer(ENV.fetch('MAX', '70000'))
+      step = Integer(ENV.fetch('STEP', '1000'))
+      keep = ENV.fetch('KEEP', '0') == '1'
+      label = 'pms-body-size-probe'
+
+      puts("Probing #{repo} body limit: sizes #{start}..#{max} step #{step} " \
+        "label=#{label.inspect} (KEEP=#{keep ? '1' : '0'})")
+      puts
+
+      PlanMyStuff::Label.ensure!(repo: repo, name: label) if label.present?
+
+      created_numbers = []
+
+      start.step(max, step) do |size|
+        header = "<details><summary>#{size} chars</summary>\n\n"
+        footer = "\n\n</details>"
+        inner = 'a' * [size - header.length - footer.length, 0].max
+        body = "#{header}#{inner}#{footer}"
+        title = "[PMS body-size probe] #{size} chars"
+        print(format('size=%-8d ', size))
+
+        begin
+          options = label.present? ? { labels: [label] } : {}
+          result = client.rest(:create_issue, repo, title, body, **options)
+          number = result.respond_to?(:number) ? result.number : result[:number]
+          created_numbers << number
+          puts("OK   ##{number}")
+        rescue Octokit::Error => e
+          puts("FAIL #{e.class}: #{e.message.to_s[0, 200]}")
+          break
+        end
+      end
+
+      puts
+      if keep || created_numbers.empty?
+        puts("Created #{created_numbers.size} issue(s); leaving open (KEEP=1).") if keep
+      else
+        puts("Closing #{created_numbers.size} probe issue(s)...")
+        created_numbers.each do |n|
+          PlanMyStuff::Issue.update!(number: n, repo: repo, state: 'closed')
+        rescue Octokit::Error => e
+          puts("  ##{n}: close failed (#{e.class})")
+        end
+      end
+    end
+
+    desc 'Probe GitHub issue comment body size limit by posting comments of increasing size on a single ' \
+      'bootstrap issue, then closing it. ' \
+      'Options: START=60000 MAX=70000 STEP=1000 KEEP=0 (set KEEP=1 to leave the bootstrap issue open)'
+    task comment_size_limit: :environment do
+      client = PlanMyStuff.client
+      repo = client.resolve_repo!
+      start = Integer(ENV.fetch('START', '60000'))
+      max = Integer(ENV.fetch('MAX', '70000'))
+      step = Integer(ENV.fetch('STEP', '1000'))
+      keep = ENV.fetch('KEEP', '0') == '1'
+      label = 'pms-comment-size-probe'
+
+      puts("Probing #{repo} comment body limit: sizes #{start}..#{max} step #{step} " \
+        "label=#{label.inspect} (KEEP=#{keep ? '1' : '0'})")
+      puts
+
+      PlanMyStuff::Label.ensure!(repo: repo, name: label)
+
+      issue = client.rest(
+        :create_issue,
+        repo,
+        '[PMS comment-size probe] bootstrap',
+        'Bootstrap issue for comment-size probing.',
+        labels: [label],
+      )
+      issue_number = issue.respond_to?(:number) ? issue.number : issue[:number]
+      puts("Bootstrap issue: ##{issue_number}")
+      puts
+
+      start.step(max, step) do |size|
+        header = "<details><summary>#{size} chars</summary>\n\n"
+        footer = "\n\n</details>"
+        inner = 'a' * [size - header.length - footer.length, 0].max
+        body = "#{header}#{inner}#{footer}"
+        print(format('size=%-8d ', size))
+
+        begin
+          client.rest(:add_comment, repo, issue_number, body)
+          puts('OK')
+        rescue Octokit::Error => e
+          puts("FAIL #{e.class}: #{e.message.to_s[0, 200]}")
+          break
+        end
+      end
+
+      puts
+      if keep
+        puts("Leaving bootstrap issue ##{issue_number} open (KEEP=1).")
+      else
+        puts("Closing bootstrap issue ##{issue_number}...")
+        begin
+          PlanMyStuff::Issue.update!(number: issue_number, repo: repo, state: 'closed')
+        rescue Octokit::Error => e
+          puts("  close failed (#{e.class})")
+        end
+      end
+    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.1.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Brands Insurance
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-01 00:00:00.000000000 Z
+date: 2026-05-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -51,32 +51,75 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
+- CONFIGURATION.md
 - LICENSE
 - 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/testings_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/partials/_flash.html.erb
+- app/views/plan_my_stuff/projects/edit.html.erb
 - app/views/plan_my_stuff/projects/index.html.erb
+- 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/attachment.rb
+- lib/plan_my_stuff/attachment_uploader.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_extractions/graphql_hydration.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
@@ -84,17 +127,43 @@ 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_extractions/approvals.rb
+- lib/plan_my_stuff/issue_extractions/links.rb
+- lib/plan_my_stuff/issue_extractions/viewers.rb
+- lib/plan_my_stuff/issue_extractions/waiting.rb
+- lib/plan_my_stuff/issue_field.rb
+- lib/plan_my_stuff/issue_field_translation.rb
+- lib/plan_my_stuff/issue_field_value_set.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/completed_sweep.rb
+- lib/plan_my_stuff/pipeline/issue_linker.rb
+- lib/plan_my_stuff/pipeline/status.rb
+- lib/plan_my_stuff/pipeline/testing.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:
@@ -103,8 +172,34 @@ metadata:
   rubygems_mfa_required: 'true'
   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.adoc
-post_install_message:
+  changelog_uri: https://github.com/brandsinsurance/PlanMyStuff/blob/main/CHANGELOG.md
+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