issuer 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b9bb7bb2f93928b8bd959ce8e27f2989748f99be01e1ca3b9b95ca8a9bd6beb1
-  data.tar.gz: b64d1378586049efc2649da8babd304677c60d7db392a2dcf9988881a2ff5572
+  metadata.gz: 1b9eef4a9d197d93d73741916ac3b33667eeedbd8f2bdc4bb7efc15a81bace2f
+  data.tar.gz: d638d611dfece68b9a9492be2a8355b14603aabf4f70e6d2212b9b73b3085775
 SHA512:
-  metadata.gz: 4cdf05b9e8493b342cf80ff6d1919f50e1b5b6e62c7d704a7f7c2648320c53a2cc4a9918506d3d25557e337d5bbd623245e610ced06337ea3d7770d9936fe153
-  data.tar.gz: 198a9cf0ca4a0ad8ee13a084bae3a755ede3ebfbda9a7723f67d6552fa0dff05820cbc6a62c64934b820134aa6f93acfb112339245974815b3fdebd62f1633f7
+  metadata.gz: 5dd29f7a22ef465afa9888dd4342c46f838298598d79ef0008f0567103030ea45a4fb3882c47460730486a4d5da4794d321fd25db9fc588e4e0a64c023fd67c4
+  data.tar.gz: 1d47716be2e67809b08dee0e11a65ef32f87f8ba1a61291759b958c6f7ab9f357fbad8b80ea5a567cf643e9f6721527c9b57e6ee5bbc9f0c373dff306cc609ed

data/README.adoc

@@ -1,7 +1,7 @@
 = Issuer: Bulk GitHub Issue Creator
 :toc: macro
 :toclevels: 3
-:this_prod_vrsn: 0.1.0
+:this_prod_vrsn: 0.1.1
 :next_prod_vrsn: 0.2.0
 :docker_base_command: docker run -it --rm -v $(pwd):/workdir -e GITHUB_TOKEN=$ISSUER_API_TOKEN docopslab/issuer
 :append_or_impose: Prepend items with `+` to indicate they should be appended to existing labels. Items without `+` will only be used for issues with no `tags` designated.

data/issuer.gemspec

@@ -17,17 +17,13 @@ Gem::Specification.new do |spec|
   spec.metadata["changelog_uri"] = "https://github.com/DocOps/issuer/blob/main/CHANGELOG.md"
 
   # Specify which files should be added to the gem when it is released.
-  spec.files = Dir.chdir(__dir__) do
-    `git ls-files -z`.split("\x0").reject do |f|
-      (File.expand_path(f) == __FILE__) ||
-        f.start_with?(*%w[test/ spec/ features/ .git .circleci appveyor Gemfile pkg/]) ||
-        f.match?(/\.gem$/) ||
-        f.match?(/test_.*\.rb$/)
-    end
-  end
+  spec.files = Dir['lib/**/*.rb'] +
+               ['exe/issuer'] +
+               ['README.adoc', 'LICENSE', 'issuer.gemspec'] +
+               Dir['examples/*.yml']
   
   spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.executables = ["issuer"]
   spec.require_paths = ["lib"]
 
   # Runtime dependencies

data/lib/issuer/cli.rb

@@ -17,7 +17,7 @@ module Issuer
     class_option :user, type: :string, desc: 'Default assignee (GitHub username)'
     class_option :tags, type: :string, desc: 'Comma-separated extra labels for all issues'
     class_option :stub, type: :boolean, desc: 'Enable stub mode for all issues'
-    class_option :dry, type: :boolean, default: false, desc: 'Print issues, don\'t post'
+    class_option :dry, type: :boolean, default: false, aliases: ['--dry-run'], desc: 'Print issues, don\'t post'
     class_option :tokenv, type: :string, desc: 'Name of environment variable containing GitHub token'
 
     # Resource automation options
@@ -127,8 +127,8 @@ module Issuer
         site_options[:token_env_var] = options[:tokenv] if options[:tokenv]
         site = Issuer::Sites::Factory.create('github', **site_options)
         automation_options = {
-          auto_versions: options[:auto_versions] || options[:auto_metadata],
-          auto_tags: options[:auto_tags] || options[:auto_metadata]
+          auto_versions: !!options[:auto_versions] || !!options[:auto_metadata],
+          auto_tags: !!options[:auto_tags] || !!options[:auto_metadata]
         }
 
         # Start run tracking for live operations
@@ -175,7 +175,7 @@ module Issuer
         --tokenv VAR_NAME        #{self.class_options[:tokenv].description}
 
       Mode Options:
-        --dry                    #{self.class_options[:dry].description}
+        --dry, --dry-run         #{self.class_options[:dry].description}
         --auto-versions          #{self.class_options[:auto_versions].description}
         --auto-milestones        (alias for --auto-versions)
         --auto-tags              #{self.class_options[:auto_tags].description}
@@ -228,7 +228,7 @@ module Issuer
         puts "Would process #{valid_count} issues, skip #{invalid_count}"
       else
         puts "\n✅ Completed: #{valid_count} issues processed, #{invalid_count} skipped"
-        puts "Run ID: #{Issuer::Cache.current_run_id}" if Issuer::Cache.current_run_id
+        # Note: Run ID is already displayed in the main flow, no need to repeat it here
       end
       
     end

data/lib/issuer/issue.rb

@@ -61,14 +61,19 @@ module Issuer
     #
     def initialize issue_data, defaults={}
       @raw_data = issue_data || {}
-      @merged_data = defaults.merge(@raw_data)
-
-      @summ = @merged_data['summ']
-      @body = @merged_data['body'] || @merged_data['desc'] || '' # Support both body and desc (legacy)
-      @tags = Array(@merged_data['tags'])
-      @user = @merged_data['user']
-      @vrsn = @merged_data['vrsn']
-      @stub = @merged_data['stub']
+      @defaults = defaults
+      
+      # For most fields, issue data overrides defaults
+      @summ = @raw_data['summ'] || defaults['summ']
+      @body = @raw_data['body'] || @raw_data['desc'] || defaults['body'] || defaults['desc'] || '' # Support both body and desc (legacy)
+      @user = @raw_data['user'] || defaults['user']
+      @vrsn = @raw_data['vrsn'] || defaults['vrsn']
+      @stub = @raw_data.key?('stub') ? @raw_data['stub'] : defaults['stub']
+      
+      # For tags, we need special handling - combine defaults and issue tags for later processing
+      defaults_tags = Array(defaults['tags'])
+      issue_tags = Array(@raw_data['tags'])
+      @tags = defaults_tags + issue_tags
     end
 
     ##
@@ -182,14 +187,22 @@ module Issuer
         end
       end
 
-      # Start with append tags (always applied)
-      final_tags = append_tags + cli_append_tags
+      # Start with append tags from both defaults and CLI (always applied)
+      defaults_append_tags = Array(@defaults['tags']).select { |tag| tag.to_s.start_with?('+') }.map { |tag| tag[1..] }
+      final_tags = append_tags + defaults_append_tags + cli_append_tags
+
+      # For regular tags, add issue's own tags, otherwise use default tags
+      issue_regular_tags = Array(@raw_data['tags']).reject { |tag| tag.to_s.start_with?('+') }
 
-      # Add regular tags if the issue has them, otherwise add CLI default tags
-      if !regular_tags.empty?
-        final_tags.concat(regular_tags)
+      if !issue_regular_tags.empty?
+        # Issue has its own regular tags, use them
+        final_tags.concat(issue_regular_tags)
       else
+        # Issue has no regular tags, use defaults from CLI
         final_tags.concat(cli_default_tags)
+        # Also add non-append defaults tags
+        defaults_regular_tags = Array(@defaults['tags']).reject { |tag| tag.to_s.start_with?('+') }
+        final_tags.concat(defaults_regular_tags)
       end
 
       # Set the final tags (removing duplicates)

data/lib/issuer/sites/base.rb

@@ -67,7 +67,8 @@ module Issuer
         issues.each do |issue|
           begin
             # Convert IMYML issue to site-specific parameters
-            site_params = convert_issue_to_site_params(issue, proj)
+            # Pass run_id to enable post-validation milestone lookup
+            site_params = convert_issue_to_site_params(issue, proj, dry_run: false, post_validation: true)
             result = create_issue(proj, site_params)
 
             # Extract the created issue object (for backwards compatibility)

data/lib/issuer/sites/github.rb

@@ -8,6 +8,8 @@ module Issuer
     class GitHub < Base
       def initialize token: nil, token_env_var: nil
         @token = token || self.class.detect_github_token(custom_env_var: token_env_var)
+        @milestone_cache = {}  # Cache for milestones by project
+        @label_cache = {}      # Cache for labels by project
 
         # Skip authentication validation for dry-run mode
         if @token == 'dry-run-token'
@@ -71,8 +73,14 @@ module Issuer
 
         # Handle milestone - only if milestone exists
         if issue_params[:milestone]
-          milestone = find_milestone(proj, issue_params[:milestone])
-          params[:milestone] = milestone.number if milestone
+          # If milestone is already a number (from convert_issue_to_site_params), use it directly
+          if issue_params[:milestone].is_a?(Integer)
+            params[:milestone] = issue_params[:milestone]
+          else
+            # If it's a string name, look it up
+            milestone = find_milestone(proj, issue_params[:milestone])
+            params[:milestone] = milestone.number if milestone
+          end
         end
 
         created_issue = @client.create_issue(proj, params[:title], params[:body], params)
@@ -110,6 +118,10 @@ module Issuer
         # Call create_milestone with proper parameters
         created_milestone = @client.create_milestone(proj, version_name, description: description)
 
+        # Add the newly created milestone to our cache for immediate availability
+        @milestone_cache[proj] ||= []
+        @milestone_cache[proj] << created_milestone
+
         # Return tracking data
         {
           object: created_milestone,
@@ -179,7 +191,7 @@ module Issuer
       end
 
       # Convert IMYML issue to GitHub-specific parameters
-      def convert_issue_to_site_params issue, proj, dry_run: false
+      def convert_issue_to_site_params issue, proj, dry_run: false, post_validation: false
         params = {
           title: issue.summ,
           body: issue.body || ''
@@ -203,7 +215,13 @@ module Issuer
           else
             # In normal mode, resolve milestone name to number
             milestone = find_milestone(proj, issue.vrsn)
-            params[:milestone] = milestone.number if milestone
+            if milestone
+              params[:milestone] = milestone.number
+            elsif post_validation
+              # If we're in post-validation mode and milestone still not found,
+              # this indicates a serious problem with the validation flow
+              puts "⚠️  Warning: Milestone '#{issue.vrsn}' not found even after validation for issue '#{issue.summ}'"
+            end
           end
         end
 
@@ -240,6 +258,13 @@ module Issuer
       end
 
       def find_milestone proj, milestone_name
+        # First check newly created milestones in cache
+        if @milestone_cache[proj]
+          cached_milestone = @milestone_cache[proj].find { |m| m.title == milestone_name.to_s }
+          return cached_milestone if cached_milestone
+        end
+        
+        # Fall back to API lookup for existing milestones
         milestones = get_versions(proj)
         milestones.find { |m| m.title == milestone_name.to_s }
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: issuer
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - DocOps Lab
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-13 00:00:00.000000000 Z
+date: 2025-07-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: octokit
@@ -118,18 +118,8 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".rspec"
-- ".vale.ini"
-- ".vale/config/vocabularies/issuer/accept.txt"
-- ".vale/config/vocabularies/issuer/reject.txt"
-- Dockerfile
 - LICENSE
 - README.adoc
-- Rakefile
-- bin/console
-- bin/issuer
-- bin/setup
-- examples/README.adoc
 - examples/advanced-stub-example.yml
 - examples/basic-example.yml
 - examples/minimal-example.yml
@@ -147,30 +137,6 @@ files:
 - lib/issuer/sites/factory.rb
 - lib/issuer/sites/github.rb
 - lib/issuer/version.rb
-- scripts/build.sh
-- scripts/lint-docs.sh
-- scripts/manage-runs.rb
-- scripts/pre-commit-template.sh
-- scripts/publish.sh
-- scripts/setup-vale.sh
-- specs/tests/README.adoc
-- specs/tests/check-github-connectivity.sh
-- specs/tests/cleanup-github-tests.sh
-- specs/tests/github-api/01-auth-connection.yml
-- specs/tests/github-api/02-basic-issues.yml
-- specs/tests/github-api/03-milestone-tests.yml
-- specs/tests/github-api/04-label-tests.yml
-- specs/tests/github-api/05-assignment-tests.yml
-- specs/tests/github-api/06-automation-tests.yml
-- specs/tests/github-api/07-error-tests.yml
-- specs/tests/github-api/08-complex-tests.yml
-- specs/tests/github-api/config.yml.example
-- specs/tests/rspec/cli_spec.rb
-- specs/tests/rspec/issue_spec.rb
-- specs/tests/rspec/issuer_spec.rb
-- specs/tests/rspec/ops_spec.rb
-- specs/tests/rspec/spec_helper.rb
-- specs/tests/run-github-api-tests.sh
 homepage: https://github.com/DocOps/issuer
 licenses:
 - MIT

data/.rspec

@@ -1,3 +0,0 @@
---format documentation
---color
---pattern 'specs/tests/rspec/**/*_spec.rb'

data/.vale/config/vocabularies/issuer/accept.txt

@@ -1,63 +0,0 @@
-# Project-specific vocabulary for issuer
-# These terms are accepted and won't be flagged by spell checkers
-
-# Project name and variations
-issuer
-Issuer
-IMYML
-imyml
-
-# Technical terms
-GitHub
-GitLab
-Octokit
-AsciiDoc
-asciidoc
-YAML
-JSON
-APIs
-API
-CLI
-summ
-vrsn
-proj
-metadata
-milestones
-assignee
-repos
-repo
-
-# Common tech abbreviations
-dev
-config
-async
-auth
-env
-vars
-bool
-bool
-bool
-timestamp
-username
-workflow
-workflows
-
-# Ruby/gem specific
-Gemfile
-gemspec
-rspec
-RSpec
-bundler
-Bundler
-
-# Docker terms
-dockerfile
-Dockerfile
-DocOps
-docopslab
-
-# Proper nouns
-JIRA
-OAuth
-README
-roadmap

data/.vale/config/vocabularies/issuer/reject.txt

@@ -1,21 +0,0 @@
-# Terms to reject/flag in the issuer project
-# These will always be flagged as errors
-
-# Common misspellings in tech docs
-seperately
-seperate
-recieve
-definately
-occured
-teh
-hte
-thier
-there own
-there job
-
-# Discouraged terms
-simply
-just
-obviously
-clearly
-easily

data/.vale.ini

@@ -1,42 +0,0 @@
-# Vale configuration for issuer project
-StylesPath = .vale/styles
-
-# Minimum alert level (suggestion, warning, error)
-MinAlertLevel = suggestion
-
-# Packages to install
-Packages = Microsoft, proselint, write-good
-
-# Global settings
-IgnoredScopes = code, tt, script.go, script.python
-SkippedScopes = script, style, pre, figure
-WordTemplate = \b(?:%s)\b
-
-# File type associations - All documentation files
-[*.{md,adoc,asciidoc,txt}]
-BasedOnStyles = Microsoft, proselint, write-good
-# Disable rules per user preferences
-Microsoft.Headings = NO
-Microsoft.Contractions = NO
-Microsoft.FirstPerson = NO
-Microsoft.Acronyms = NO
-Microsoft.Auto = NO
-Microsoft.Vocab = NO
-Microsoft.We = NO
-Microsoft.Dashes = NO
-write-good.E-Prime = NO
-write-good.Passive = NO
-write-good.TooWordy = NO
-write-good.Weasel = NO
-# Global ignores for all markup files
-TokenIgnores = (\$[A-Z_]+), (`[^`]+`), (:[a-z-]+:), (\{[^}]+\}), (https?://[^\s]+), \bJIRA\b
-
-# Ruby files for comments
-[*.rb]
-BasedOnStyles = Microsoft, write-good
-TokenIgnores = (`[^`]+`), (\$[A-Z_]+), (:[a-z_]+), \bJIRA\b
-
-# YAML files
-[*.{yml,yaml}]
-BasedOnStyles = Microsoft, write-good
-TokenIgnores = (`[^`]+`), (\$[A-Z_]+), (:[a-z_]+:), \bJIRA\b

data/Dockerfile

@@ -1,43 +0,0 @@
-FROM ruby:3.2-slim
-
-ARG ISSUER_VERSION
-ARG ISSUER_SOURCE=repo
-LABEL org.opencontainers.image.version=$ISSUER_VERSION
-
-# Install necessary build tools and dependencies (minimal footprint)
-RUN apt-get update -qq && \
-    apt-get upgrade -y && \
-    apt-get install -y --no-install-recommends \
-    build-essential \
-    git && \
-    rm -rf /var/lib/apt/lists/*
-
-# Install issuer gem based on ISSUER_SOURCE
-RUN if [ "$ISSUER_SOURCE" = "published" ]; then \
-      echo "Installing issuer from RubyGems..." && \
-      gem install issuer; \
-    else \
-      echo "Will install issuer from repository source..."; \
-    fi
-
-# Set app directory for build context (only needed for repo builds)
-WORKDIR /app
-
-# Copy repository source and build gem (only when ISSUER_SOURCE=repo)
-COPY . .
-RUN if [ "$ISSUER_SOURCE" = "repo" ]; then \
-      gem install rake && \
-      gem build issuer.gemspec && \
-      gem install issuer-*.gem && \
-      rm -rf /app/*; \
-    fi
-
-# Ensure gem executables are in PATH
-ENV PATH="/usr/local/bundle/bin:$PATH"
-
-# Set runtime working dir to isolated mount point
-WORKDIR /workdir
-
-# Default entrypoint and fallback command
-ENTRYPOINT ["issuer"]
-CMD ["help"]

data/Rakefile

@@ -1,70 +0,0 @@
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
-require "yaml"
-
-RSpec::Core::RakeTask.new(:spec) do |t|
-  t.pattern = 'specs/tests/rspec/**/*_spec.rb'
-end
-
-task :default => :spec
-
-desc "Setup Vale styles"
-task :vale_setup do
-  sh "vale sync"
-end
-
-desc "Run documentation quality checks"
-task :quality => :vale_setup do
-  sh "vale --no-exit --output=line *.adoc examples/*.adoc specs/tests/*.adoc || true"
-end
-
-desc "Run CLI tests"
-task :cli_test do
-  puts "Testing CLI functionality..."
-  sh "ruby -Ilib exe/issuer --version"
-  sh "ruby -Ilib exe/issuer --help"
-  sh "ruby -Ilib exe/issuer examples/minimal-example.yml --dry"
-end
-
-desc "Validate YAML examples"
-task :yaml_test do
-  puts "Validating YAML examples..."
-  Dir.glob("examples/*.yml").each do |file|
-    puts "Validating #{file}"
-    begin
-      YAML.load_file(file)
-      puts "✓ #{file} is valid"
-    rescue => e
-      puts "✗ #{file} failed: #{e.message}"
-      exit 1
-    end
-  end
-end
-
-desc "Run bundle install"
-task :install do
-  sh "bundle install"
-end
-
-desc "Run all PR tests locally (same as GitHub Actions)"
-task :pr_test do
-  puts "🔍 Running all PR tests locally..."
-  puts "\n=== RSpec Tests ==="
-  Rake::Task[:spec].invoke
-  
-  puts "\n=== CLI Tests ==="
-  Rake::Task[:cli_test].invoke
-  
-  puts "\n=== YAML Validation ==="
-  Rake::Task[:yaml_test].invoke
-  
-  puts "\n=== Documentation Quality ==="
-  Rake::Task[:quality].invoke
-  
-  puts "\n✅ All PR tests passed!"
-end
-
-desc "Build and install gem locally"
-task :install_local => :build do
-  sh "gem install pkg/issuer-*.gem"
-end

data/bin/issuer

@@ -1,13 +0,0 @@
-#!/usr/bin/env ruby
-
-# Development setup script for issuer gem
-# This script helps set up the development environment
-
-require 'bundler/setup'
-require_relative '../lib/issuer'
-
-# Add the lib directory to the load path for development
-$LOAD_PATH.unshift File.join(__dir__, '..', 'lib')
-
-# Run the CLI
-Issuer::CLI.start(ARGV)

data/examples/README.adoc

@@ -1,56 +0,0 @@
-= IMYML Examples
-
-This directory contains example IMYML (Issue YAML) files demonstrating various features of the issuer CLI tool.
-
-== Files
-
-=== `basic-example.yml`
-Demonstrates core IMYML features:
-
-* Basic meta configuration
-* Issue properties (summ, body, tags, user, vrsn)
-* Default values and overrides
-
-=== `advanced-stub-example.yml`
-Shows advanced features:
-
-* Stub functionality with head/tail/body composition
-* Tag logic with `+` prefix for append-to-all behavior
-* Mixed scalar string and structured issues
-* Conditional stub application
-
-=== `minimal-example.yml`
-Minimal example for quick testing:
-
-* Minimal meta configuration
-* Mix of structured and string issues
-
-=== `validation-test.yml`
-For testing milestone and label validation:
-
-* Issues with non-existent milestones
-* Issues with non-existent labels
-* Triggers interactive validation prompts
-
-=== `new-project-issues.yml`
-Comprehensive bootstrap issues for new software projects:
-
-* Repository and infrastructure setup tasks
-* Development environment configuration
-* Testing and security framework setup
-* Common project management tasks
-* Mix of detailed and simple issue definitions
-
-== Usage
-
-Test any example with a dry run:
-
- issuer examples/basic-example.yml --dry
-
-Or with the Docker image:
-
- docker run -it --rm -v $(pwd):/workdir docopslab/issuer issuer examples/basic-example.yml --dry
-
-== Creating Your Own
-
-Copy and modify any of these examples as a starting point for your own project's issue definitions.

data/scripts/build.sh

@@ -1,40 +0,0 @@
-#!/bin/bash
-# Release automation script for Ruby gem projects
-
-set -e
-
-# Load common build functions
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-source "$SCRIPT_DIR/lib/build-common.sh"
-
-# Project-specific configuration
-PROJECT_NAME="issuer"
-DOCKER_ORG="docopslab"
-
-echo -e "${GREEN}🚀 ${PROJECT_NAME} Release Build Script${NC}"
-echo "=================================="
-
-# Validation
-check_project_root
-check_git_clean
-check_main_branch
-check_bundle_installed
-
-# Run tests
-run_rspec_tests
-test_cli_functionality
-
-# Get current version
-current_version=$(get_current_version)
-echo -e "${GREEN}📋 Current version: $current_version${NC}"
-
-# Build and test gem
-build_gem
-gem_file=$(test_built_gem)
-
-# Build Docker image using the docker-specific script
-echo -e "${YELLOW}🐳 Building Docker image...${NC}"
-"$SCRIPT_DIR/build-docker.sh" 2>&1 | grep -E "(Building|Testing|successfully|Docker image:)" || true
-
-# Show final success message
-show_build_success "$current_version" "$gem_file"