issuer 0.1.0 → 0.2.1

data/lib/issuer/sites/github.rb

@@ -2,16 +2,20 @@
 
 require 'octokit'
 require_relative 'base'
+require_relative '../apis/github/client'
 
 module Issuer
   module Sites
     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'
           @client = nil
+          @octokit_client = nil
           return
         end
 
@@ -20,8 +24,11 @@ module Issuer
           raise Issuer::Error, "GitHub token not found. Set #{env_vars.join(', ')} environment variable."
         end
 
-        @client = Octokit::Client.new(access_token: @token)
-        @client.auto_paginate = true
+        # Create our enhanced API client that supports GraphQL
+        @client = Issuer::APIs::GitHub::Client.new(token: @token)
+        # Keep the Octokit client for non-issue operations
+        @octokit_client = Octokit::Client.new(access_token: @token)
+        @octokit_client.auto_paginate = true
       end
 
       def site_name
@@ -39,6 +46,7 @@ module Issuer
           milestone: 'milestone', # site_params[:milestone] displays as "milestone:"
           labels: 'labels',      # site_params[:labels] displays as "labels:"
           assignee: 'assignee',  # site_params[:assignee] displays as "assignee:"
+          type: 'type',          # site_params[:type] displays as "type:"
           project_name: 'repo'   # For summary messages: "repo: owner/name"
         }
       end
@@ -71,11 +79,22 @@ 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
+
+        # Handle type
+        if issue_params[:type]
+          params[:type] = issue_params[:type]
         end
 
-        created_issue = @client.create_issue(proj, params[:title], params[:body], params)
+        created_issue = @client.create_issue(proj, params)
 
         # Extract relevant data for potential cleanup tracking
         issue_data = {
@@ -93,13 +112,13 @@ module Issuer
       end
 
       def get_versions proj
-        @client.milestones(proj, state: 'all')
+        @octokit_client.milestones(proj, state: 'all')
       rescue Octokit::Error => e
         raise Issuer::Error, "Failed to fetch milestones: #{e.message}"
       end
 
       def get_tags proj
-        @client.labels(proj)
+        @octokit_client.labels(proj)
       rescue Octokit::Error => e
         raise Issuer::Error, "Failed to fetch labels: #{e.message}"
       end
@@ -108,7 +127,11 @@ module Issuer
         description = options[:description] || "Created by issuer CLI"
 
         # Call create_milestone with proper parameters
-        created_milestone = @client.create_milestone(proj, version_name, description: description)
+        created_milestone = @octokit_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
         {
@@ -130,7 +153,7 @@ module Issuer
         description = options[:description]
 
         # Call add_label with proper parameters
-        created_label = @client.add_label(proj, tag_name, color, description: description)
+        created_label = @octokit_client.add_label(proj, tag_name, color, description: description)
 
         # Return tracking data
         {
@@ -149,26 +172,26 @@ module Issuer
 
       # Cleanup methods
       def close_issue proj, issue_number
-        @client.close_issue(proj, issue_number)
+        @octokit_client.close_issue(proj, issue_number)
       rescue Octokit::Error => e
         raise Issuer::Error, "Failed to close issue ##{issue_number}: #{e.message}"
       end
 
       def delete_milestone proj, milestone_number
-        @client.delete_milestone(proj, milestone_number)
+        @octokit_client.delete_milestone(proj, milestone_number)
       rescue Octokit::Error => e
         raise Issuer::Error, "Failed to delete milestone ##{milestone_number}: #{e.message}"
       end
 
       def delete_label proj, label_name
-        @client.delete_label!(proj, label_name)
+        @octokit_client.delete_label!(proj, label_name)
       rescue Octokit::Error => e
         raise Issuer::Error, "Failed to delete label '#{label_name}': #{e.message}"
       end
 
       def validate_configuration
         # Test API access
-        @client.user
+        @octokit_client.user
         true
       rescue Octokit::Error => e
         raise Issuer::Error, "GitHub authentication failed: #{e.message}"
@@ -179,7 +202,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,10 +226,21 @@ 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
 
+        # Handle type
+        if issue.type && !issue.type.strip.empty?
+          params[:type] = issue.type.strip
+        end
+
         params
       end
 
@@ -240,6 +274,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

data/lib/issuer.rb

@@ -25,7 +25,7 @@ require_relative "issuer/cli"
 # * Configurable defaults and label application logic
 # * Environment variable support for authentication
 # * Issue validation with helpful error messages
-# * Extensible architecture for multiple platforms (GitHub, JIRA, GitLab, etc.)
+# * Extensible architecture for multiple platforms (GitHub, Jira, GitLab, etc.)
 # * Run logging and artifact tracking for cleanup operations
 #
 # == Quick Start
@@ -81,7 +81,7 @@ module Issuer
     # @param site [Issuer::Sites::Base, nil] Custom site adapter. If nil, will auto-detect.
     # @param cache [Boolean] Whether to enable run tracking and caching (default: true)
     #
-    def initialize(site: nil, cache: true)
+    def initialize site: nil, cache: true
       @site = site
       @cache_enabled = cache
     end
@@ -107,7 +107,7 @@ module Issuer
     #                                    automation_options: { auto_metadata: true })
     #   puts "Created #{results[:issues_created]} issues"
     #
-    def process_file(file_path, proj: nil, dry_run: false, automation_options: {})
+    def process_file file_path, proj: nil, dry_run: false, automation_options: {}
       require 'yaml'
 
       unless File.exist?(file_path)
@@ -134,7 +134,7 @@ module Issuer
     # @return [Hash] Results including created issues, milestones, labels, and run metadata
     # @raise [Issuer::Error] If data is invalid or processing fails
     #
-    def process_data(data, proj: nil, dry_run: false, automation_options: {})
+    def process_data data, proj: nil, dry_run: false, automation_options: {}
       # Extract metadata and issues
       meta = data['$meta'] || {}
       issues_data = data['issues'] || data
@@ -176,7 +176,7 @@ module Issuer
       @site ||= Sites::Factory.create(Sites::Factory.default_site)
     end
 
-    def perform_dry_run(issues, repo)
+    def perform_dry_run issues, repo
       site = Sites::Factory.create('github', token: 'dry-run-token')
 
       puts "🧪 DRY RUN - No issues will be created"
@@ -201,7 +201,7 @@ module Issuer
       }
     end
 
-    def perform_live_run(issues, repo, automation_options)
+    def perform_live_run issues, repo, automation_options
       site = get_site
 
       # Start run tracking if caching enabled

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: issuer
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - DocOps Lab
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-13 00:00:00.000000000 Z
+date: 2025-08-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: octokit
@@ -118,22 +118,13 @@ 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
 - examples/new-project-issues.yml
+- examples/tag-removal-example.yml
 - examples/validation-test.yml
 - exe/issuer
 - issuer.gemspec
@@ -147,30 +138,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
@@ -178,6 +145,7 @@ metadata:
   homepage_uri: https://github.com/DocOps/issuer
   source_code_uri: https://github.com/DocOps/issuer
   changelog_uri: https://github.com/DocOps/issuer/blob/main/CHANGELOG.md
+  documentation_uri: https://gemdocs.org/gems/issuer/0.2.1
 post_install_message:
 rdoc_options: []
 require_paths:

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"