issuer 0.1.0 → 0.1.1

data/specs/tests/github-api/06-automation-tests.yml

@@ -1,102 +0,0 @@
-$meta:
-  proj: DocOps/issuer-test              # Test repository  # Update this with your test repository
-  
-issues:
-  - summ: "[TEST] Auto-metadata flag test"
-    body: |
-      # Automation Flag Test
-      
-      This issue tests the `--auto-metadata` flag functionality.
-      
-      **What this tests:**
-      - Automatic milestone creation without user prompts
-      - Automatic label creation without user prompts  
-      - Combined automation of both milestones and labels
-      
-      **Expected behavior when run with `--auto-metadata`:**
-      1. A new milestone "auto-test-milestone-v1.0" should be created automatically
-      2. New labels should be created automatically without prompts
-      3. No interactive confirmations should appear
-      4. The issue should be created with all metadata properly assigned
-      
-      **Test commands:**
-      ```bash
-      # This should prompt for milestone/label creation
-      issuer 06-automation-tests.yml
-      
-      # This should create everything automatically without prompts
-      issuer 06-automation-tests.yml --auto-metadata
-      
-      # Individual automation flags
-      issuer 06-automation-tests.yml --auto-versions --auto-tags
-      issuer 06-automation-tests.yml --auto-milestones --auto-labels
-      ```
-      
-      **Expected milestones/labels created:**
-      - Milestone: auto-test-milestone-v1.0
-      - Labels: auto-test-label-1, auto-test-label-2
-    vrsn: auto-test-milestone-v1.0
-    tags: [auto-test-label-1, auto-test-label-2]
-    
-  - summ: "[TEST] Individual automation flags test"
-    body: |
-      # Individual Automation Flags Test
-      
-      This issue tests the individual automation flags:
-      - `--auto-versions` / `--auto-milestones`
-      - `--auto-tags` / `--auto-labels`
-      
-      **Test scenarios:**
-      
-      1. **Only milestone automation:**
-         ```bash
-         issuer 06-automation-tests.yml --auto-versions
-         ```
-         Should create milestone automatically but prompt for labels.
-      
-      2. **Only label automation:**
-         ```bash
-         issuer 06-automation-tests.yml --auto-tags  
-         ```
-         Should create labels automatically but prompt for milestone.
-      
-      3. **Both flags together:**
-         ```bash
-         issuer 06-automation-tests.yml --auto-versions --auto-tags
-         ```
-         Should work the same as `--auto-metadata`.
-      
-      **Expected resources:**
-      - Milestone: individual-test-milestone-v2.0
-      - Labels: individual-test-label-1, individual-test-label-2
-    vrsn: individual-test-milestone-v2.0
-    tags: [individual-test-label-1, individual-test-label-2]
-    
-  - summ: "[TEST] Alias flag compatibility test"
-    body: |
-      # Alias Flag Compatibility Test
-      
-      This issue tests that the alias flags work correctly:
-      
-      **Milestone aliases:**
-      - `--auto-versions` (primary)
-      - `--auto-milestones` (alias)
-      
-      **Label aliases:**
-      - `--auto-tags` (primary) 
-      - `--auto-labels` (alias)
-      
-      **Test commands that should work identically:**
-      ```bash
-      issuer 06-automation-tests.yml --auto-versions --auto-tags
-      issuer 06-automation-tests.yml --auto-milestones --auto-labels  
-      issuer 06-automation-tests.yml --auto-metadata
-      ```
-      
-      All three commands should produce the same result with no user prompts.
-      
-      **Expected resources:**
-      - Milestone: alias-test-milestone-v3.0
-      - Labels: alias-test-label-1, alias-test-label-2
-    vrsn: alias-test-milestone-v3.0
-    tags: [alias-test-label-1, alias-test-label-2]

data/specs/tests/github-api/07-error-tests.yml

@@ -1,29 +0,0 @@
-$meta:
-  proj: nonexistent/repository  # This should fail - testing error handling
-  
-issues:
-  - summ: "[TEST] This should fail gracefully"
-    body: |
-      # Error Handling Test
-      
-      This issue should **NOT** be created successfully because the repository doesn't exist.
-      
-      **What this tests:**
-      - Error handling for invalid repository names
-      - Graceful failure with informative error messages
-      - No crashes or unexpected behavior
-      
-      **Expected behavior:**
-      - The CLI should detect that the repository doesn't exist
-      - A clear error message should be displayed
-      - The program should exit gracefully without creating any issues
-      - No partial state should be left behind
-      
-      **Test commands:**
-      ```bash
-      # This should fail with a clear error message
-      issuer 07-error-tests.yml --dry    # Should fail even in dry-run
-      issuer 07-error-tests.yml          # Should fail with repository error
-      ```
-      
-      If you're seeing this issue in GitHub, something went wrong with the test!

data/specs/tests/github-api/08-complex-tests.yml

@@ -1,197 +0,0 @@
-$meta:
-  proj: DocOps/issuer-test              # Test repository  # Update this with your test repository
-  defaults:
-    vrsn: complex-test-v1.0
-    user: briandominick               # GitHub username  # Update this with your GitHub username
-    tags: [+comprehensive-test, test-suite]
-    stub: true
-    head: |
-      ## 🧪 Comprehensive Test Issue
-      This issue tests multiple features simultaneously.
-      
-      **Test run timestamp:** $(date)
-      **Test type:** Complex integration test
-      
-      ---
-    tail: |
-      ---
-      
-      **Generated by:** issuer comprehensive test suite  
-      **Features tested:** Multiple milestones, labels, assignments, stubs, markdown
-      **Cleanup:** This issue can be closed after test verification
-    body: |
-      Default body for comprehensive testing scenario.
-      
-      This text should appear in issues that don't override the body,
-      surrounded by the head and tail content above and below.
-      
-issues:
-  - summ: "[TEST] Everything combined - kitchen sink test"
-    body: |
-      # Kitchen Sink Integration Test 🚀
-      
-      This issue tests the maximum number of features in a single issue:
-      
-      ## Features Being Tested
-      
-      ### ✅ Issue Creation
-      - [x] Custom title and body
-      - [x] Markdown formatting
-      - [x] Complex content structure
-      
-      ### ✅ Milestone Management  
-      - [x] Custom milestone (different from default)
-      - [x] Milestone creation if not exists
-      
-      ### ✅ Label Management
-      - [x] Multiple custom labels
-      - [x] Mix of new and potentially existing labels
-      - [x] Label creation if not exists
-      
-      ### ✅ Assignment
-      - [x] Issue assignment to specific user
-      
-      ### ✅ Content Features
-      - [x] Headers and subheaders
-      - [x] Lists and checkboxes
-      - [x] **Bold** and *italic* text
-      - [x] `inline code`
-      - [x] Code blocks
-      - [x] Tables
-      - [x] Links
-      - [x] Emojis 🎯 📊 ⚡
-      
-      ## Code Examples
-      
-      ```yaml
-      # IMYML example
-      $meta:
-        proj: user/repo
-        defaults:
-          vrsn: v1.0.0
-          tags: [enhancement]
-      
-      issues:
-        - summ: Complex issue
-          body: Advanced content
-          vrsn: v1.1.0
-          tags: [feature, testing]
-          user: developer
-      ```
-      
-      ```javascript
-      // JavaScript example
-      function createIssue(data) {
-        return fetch('/api/issues', {
-          method: 'POST',
-          body: JSON.stringify(data),
-          headers: { 'Content-Type': 'application/json' }
-        });
-      }
-      ```
-      
-      ## Data Table
-      
-      | Component | Status | Notes |
-      |-----------|---------|-------|
-      | Authentication | ✅ | Working |
-      | Issue Creation | ✅ | Working |
-      | Milestone Creation | ✅ | Working |
-      | Label Creation | ✅ | Working |
-      | Assignment | ✅ | Working |
-      | Markdown Support | ✅ | Working |
-      | Error Handling | 🧪 | Testing |
-      
-      ## External References
-      
-      - [GitHub Issues API](https://docs.github.com/en/rest/issues)
-      - [issuer CLI Documentation](https://github.com/DocOps/issuer)
-      - [IMYML Format Specification](https://github.com/DocOps/issuer#imyml-format)
-      
-      ## Completion Criteria
-      
-      This test is successful if:
-      
-      1. ✅ This issue is created without errors
-      2. ✅ The milestone "complex-test-v1.1" is created
-      3. ✅ All specified labels are created and applied
-      4. ✅ The issue is assigned to the specified user
-      5. ✅ All markdown formatting renders correctly
-      6. ✅ No errors occur during the creation process
-      
-      > **Important:** This is a test issue and can be closed after verification.
-      
-    vrsn: complex-test-v1.1
-    tags: [enhancement, test-complex, high-priority, integration-test]
-    user: briandominick               # GitHub username  # Update this with your GitHub username
-    
-  - summ: "[TEST] Stub functionality with defaults"
-    # This issue should use the default body with head/tail from metadata
-    vrsn: complex-test-v1.0
-    tags: [test-stub, automation]
-    
-  - summ: "[TEST] Mixed content and overrides"
-    body: |
-      # Override Test
-      
-      This issue tests overriding defaults while keeping some:
-      
-      - ✅ Custom body (overrides default)
-      - ✅ Custom milestone (overrides default) 
-      - ✅ Custom labels (combined with defaults)
-      - ✅ Custom user (overrides default)
-      
-      **Expected behavior:**
-      - Should NOT use the default body/head/tail (because custom body provided)
-      - Should use custom milestone instead of default
-      - Should combine custom labels with default labels
-      - Should be assigned to the custom user
-      
-      This tests the precedence rules in the IMYML processing.
-    vrsn: complex-test-override
-    tags: [test-override, custom-behavior]
-    user: briandominick               # GitHub username  # Update this with your GitHub username
-    
-  - summ: "[TEST] Edge case - very long title with special characters and unicode 🌟 αβγδε ñáéíóú 中文"
-    body: |
-      # Edge Case Testing 🎯
-      
-      This issue tests edge cases and boundary conditions:
-      
-      ## Long Title Testing
-      The title of this issue is intentionally long and contains:
-      - Special characters
-      - Unicode characters  
-      - Emojis
-      - Mixed languages
-      
-      ## Large Content Testing
-      This body contains a substantial amount of content to test handling of larger payloads.
-      
-      ### Lorem Ipsum Content
-      Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
-      
-      Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt.
-      
-      ### Technical Content
-      ```json
-      {
-        "test": {
-          "edge_cases": true,
-          "unicode_support": "🌟 αβγδε ñáéíóú 中文 العربية",
-          "special_chars": "!@#$%^&*()_+-=[]{}|;':\",./<>?",
-          "long_strings": "This is a very long string that tests the handling of substantial content in issue bodies and ensures that the GitHub API can handle larger payloads without truncation or encoding issues.",
-          "nested_data": {
-            "level_1": {
-              "level_2": {
-                "level_3": "Deep nesting test"
-              }
-            }
-          }
-        }
-      }
-      ```
-      
-      This issue should be created successfully despite its complex content.
-    vrsn: complex-test-edge-cases
-    tags: [test-edge-cases, unicode-test, large-content]

data/specs/tests/github-api/config.yml.example

@@ -1,17 +0,0 @@
-# GitHub API Test Configuration
-# Copy this file to config.yml and customize for your test repository
-
-# Test repository configuration
-test_repo: "your-username/issuer-test-repo"  # Replace with your test repository
-test_username: "your-username"               # Replace with your GitHub username
-
-# Test configuration
-cleanup_after_tests: true                   # Whether to clean up test issues after running
-max_test_issues: 50                          # Maximum number of test issues to create
-test_label_prefix: "test-"                   # Prefix for test labels
-test_milestone_prefix: "test-milestone-"     # Prefix for test milestones
-
-# Advanced options
-dry_run_first: true                          # Always do a dry run before actual posting
-create_cleanup_script: true                  # Generate cleanup script after tests
-verbose_output: true                         # Show detailed output during tests

data/specs/tests/rspec/cli_spec.rb

@@ -1,127 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "spec_helper"
-
-RSpec.describe Issuer::CLI do
-  # Mock the GitHub site methods to avoid actual API calls during testing
-  before do
-    allow_any_instance_of(Issuer::Sites::GitHub).to receive(:get_versions).and_return([])
-    allow_any_instance_of(Issuer::Sites::GitHub).to receive(:find_milestone).and_return(nil)
-    allow_any_instance_of(Issuer::Sites::GitHub).to receive(:convert_issue_to_site_params).and_wrap_original do |method, *args|
-      issue, repo = args
-      {
-        title: issue.summ,
-        body: issue.body,
-        labels: issue.tags || [],
-        assignee: issue.user,
-        milestone: issue.vrsn
-      }
-    end
-  end
-
-  describe 'file argument handling' do
-    let(:sample_file) { create_temp_yaml_file(sample_imyml_content) }
-
-    after { File.unlink(sample_file) if File.exist?(sample_file) }
-
-    it 'accepts positional file argument' do
-      # Capture output to avoid cluttering test output
-      expect {
-        cli = Issuer::CLI.new
-        cli.invoke(:main, [sample_file], {dry: true})
-      }.to output(/Would process 2 issues/).to_stdout
-    end
-
-    it 'accepts --file option' do
-      expect {
-        cli = Issuer::CLI.new
-        cli.invoke(:main, [], {file: sample_file, dry: true})
-      }.to output(/Would process 2 issues/).to_stdout
-    end
-
-    it 'gives precedence to --file over positional argument' do
-      nonexistent_file = '/tmp/nonexistent.yml'
-
-      expect {
-        cli = Issuer::CLI.new
-        cli.invoke(:main, [nonexistent_file], {file: sample_file, dry: true})
-      }.to output(/Would process 2 issues/).to_stdout
-    end
-
-    it 'shows error when no file is specified' do
-      expect {
-        cli = Issuer::CLI.new
-        cli.invoke(:main, [], {})
-      }.to raise_error(SystemExit).and output(/No IMYML file specified/).to_stderr
-    end
-
-    it 'shows error when file does not exist' do
-      expect {
-        cli = Issuer::CLI.new
-        cli.invoke(:main, ['/tmp/nonexistent.yml'], {})
-      }.to raise_error(SystemExit).and output(/File not found/).to_stderr
-    end
-  end
-
-  describe 'option handling' do
-    let(:sample_file) { create_temp_yaml_file(sample_imyml_content) }
-
-    after { File.unlink(sample_file) if File.exist?(sample_file) }
-
-    it 'handles --proj option' do
-      expect {
-        cli = Issuer::CLI.new
-        cli.invoke(:main, [sample_file], {proj: 'custom/repo', dry: true})
-      }.to output(/repo:\s+custom\/repo/).to_stdout
-    end
-
-    it 'handles --tags option with append and default logic' do
-      expect {
-        cli = Issuer::CLI.new
-        cli.invoke(:main, [sample_file], {tags: '+urgent,docs', dry: true})
-      }.to output(/- urgent/).to_stdout
-    end
-
-    it 'handles --stub option' do
-      expect {
-        cli = Issuer::CLI.new
-        cli.invoke(:main, [sample_file], {stub: true, dry: true})
-      }.to output(/Would process 2 issues/).to_stdout
-    end
-
-    it 'handles --tokenv option' do
-      ENV['MY_GITHUB_TOKEN'] = 'ghp_xxxxx'
-
-      # Mock the Factory to capture the site_options passed to it
-      allow(Issuer::Sites::Factory).to receive(:create).and_call_original
-
-      cli = Issuer::CLI.new
-      cli.invoke(:main, [sample_file], {tokenv: 'MY_GITHUB_TOKEN', dry: true})
-
-      # Verify that Factory.create was called with the correct token_env_var
-      expect(Issuer::Sites::Factory).to have_received(:create).with(
-        'github',
-        hash_including(token_env_var: 'MY_GITHUB_TOKEN')
-      )
-
-      ENV.delete('MY_GITHUB_TOKEN')
-    end
-
-  end
-
-  describe 'version and help' do
-    it 'shows version with --version' do
-      expect {
-        cli = Issuer::CLI.new
-        cli.invoke(:main, [], {version: true})
-      }.to output(/Issuer version/).to_stdout
-    end
-
-    it 'shows help with --help' do
-      expect {
-        cli = Issuer::CLI.new
-        cli.invoke(:main, [], {help: true})
-      }.to output(/Usage:/).to_stdout
-    end
-  end
-end

data/specs/tests/rspec/issue_spec.rb

@@ -1,184 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "spec_helper"
-
-RSpec.describe Issuer::Issue do
-  let(:issue_data) do
-    {
-      'summ' => 'Test issue title',
-      'desc' => 'Test issue description',
-      'tags' => ['bug', 'high-priority'],
-      'user' => 'testuser',
-      'vrsn' => '1.0.0'
-    }
-  end
-
-  let(:defaults) do
-    {
-      'user' => 'defaultuser',
-      'tags' => ['default-tag']
-    }
-  end
-
-  describe '#initialize' do
-    it 'initializes with issue data and defaults' do
-      issue = described_class.new(issue_data, defaults)
-      
-      expect(issue.summ).to eq('Test issue title')
-      expect(issue.body).to eq('Test issue description')
-      expect(issue.tags).to eq(['bug', 'high-priority'])
-      expect(issue.user).to eq('testuser')
-      expect(issue.vrsn).to eq('1.0.0')
-    end
-
-    it 'merges defaults with issue data, preferring issue data' do
-      issue = described_class.new(issue_data, defaults)
-      
-      # Issue data should override defaults
-      expect(issue.user).to eq('testuser')
-      expect(issue.tags).to eq(['bug', 'high-priority'])
-    end
-
-    it 'uses defaults when issue data is missing fields' do
-      minimal_data = { 'summ' => 'Title only' }
-      issue = described_class.new(minimal_data, defaults)
-      
-      expect(issue.summ).to eq('Title only')
-      expect(issue.user).to eq('defaultuser')
-      expect(issue.tags).to eq(['default-tag'])
-    end
-  end
-
-  describe '#valid?' do
-    it 'returns true for issues with a title' do
-      issue = described_class.new(issue_data)
-      expect(issue).to be_valid
-    end
-
-    it 'returns false for issues without a title' do
-      invalid_data = { 'desc' => 'Description only' }
-      issue = described_class.new(invalid_data)
-      expect(issue).not_to be_valid
-    end
-
-    it 'returns false for issues with empty title' do
-      invalid_data = { 'summ' => '   ' }
-      issue = described_class.new(invalid_data)
-      expect(issue).not_to be_valid
-    end
-  end
-
-  describe '#add_tags' do
-    it 'adds additional tags to existing ones' do
-      issue = described_class.new(issue_data)
-      issue.add_tags(['new-label', 'another-label'])
-      
-      expect(issue.tags).to include('bug', 'high-priority', 'new-label', 'another-label')
-    end
-
-    it 'removes duplicates when adding tags' do
-      issue = described_class.new(issue_data)
-      issue.add_tags(['bug', 'new-label'])
-      
-      expect(issue.tags.count('bug')).to eq(1)
-      expect(issue.tags).to include('new-label')
-    end
-  end
-
-  describe 'site integration' do
-    let(:github_site) do
-      # Mock the Octokit client to avoid real API calls
-      mock_client = double('client')
-      allow(mock_client).to receive(:auto_paginate=)
-      
-      # Mock milestone for version conversion
-      mock_milestone = double('milestone', title: '1.0.0', number: 1)
-      allow(mock_client).to receive(:milestones).with(any_args).and_return([mock_milestone])
-      allow(Octokit::Client).to receive(:new).and_return(mock_client)
-      allow_any_instance_of(Issuer::Sites::GitHub).to receive(:detect_github_token).and_return('test-token')
-      Issuer::Sites::GitHub.new(token: 'test-token')
-    end
-    
-    it 'can be translated to GitHub API parameters via site' do
-      issue = described_class.new(issue_data)
-      params = github_site.convert_issue_to_site_params(issue, "test/repo")
-      
-      expect(params[:title]).to eq('Test issue title')
-      expect(params[:body]).to eq('Test issue description')
-      expect(params[:labels]).to eq(['bug', 'high-priority'])
-      expect(params[:assignee]).to eq('testuser')
-      expect(params[:milestone]).to eq(1)
-    end
-
-    it 'handles missing optional fields when translated via site' do
-      minimal_data = { 'summ' => 'Title only' }
-      issue = described_class.new(minimal_data)
-      params = github_site.convert_issue_to_site_params(issue, "test/repo")
-      
-      expect(params[:title]).to eq('Title only')
-      expect(params[:body]).to eq('')
-      expect(params).not_to have_key(:labels)
-      expect(params).not_to have_key(:assignee)
-      expect(params).not_to have_key(:milestone)
-    end
-  end
-
-  describe '.from_array' do
-    it 'creates multiple Issue objects from array' do
-      issues_array = [
-        { 'summ' => 'First issue' },
-        { 'summ' => 'Second issue' }
-      ]
-      
-      issues = described_class.from_array(issues_array, defaults)
-      
-      expect(issues.length).to eq(2)
-      expect(issues.first.summ).to eq('First issue')
-      expect(issues.last.summ).to eq('Second issue')
-    end
-  end
-
-  describe '.valid_issues_from_array' do
-    it 'returns only valid issues' do
-      issues_array = [
-        { 'summ' => 'Valid issue' },
-        { 'desc' => 'Invalid - no title' },
-        { 'summ' => 'Another valid issue' }
-      ]
-      
-      valid_issues = described_class.valid_issues_from_array(issues_array)
-      
-      expect(valid_issues.length).to eq(2)
-      expect(valid_issues.map(&:summ)).to eq(['Valid issue', 'Another valid issue'])
-    end
-  end
-
-  describe 'new properties support' do
-    it 'supports body field instead of desc (legacy support)' do
-      new_format = { 'summ' => 'Title', 'body' => 'New body format' }
-      issue = described_class.new(new_format)
-      
-      expect(issue.body).to eq('New body format')
-    end
-
-    it 'prefers body over desc when both are present' do
-      mixed_format = { 'summ' => 'Title', 'body' => 'New body', 'desc' => 'Old desc' }
-      issue = described_class.new(mixed_format)
-      
-      expect(issue.body).to eq('New body')
-    end
-
-    it 'supports stub property' do
-      stub_data = { 'summ' => 'Title', 'stub' => true }
-      issue = described_class.new(stub_data)
-      
-      expect(issue.stub).to be true
-    end
-
-    it 'allows body to be modified' do
-      issue = described_class.new(issue_data)
-      expect { issue.body = 'Modified body' }.not_to raise_error
-      expect(issue.body).to eq('Modified body')
-    end
-  end
-end

data/specs/tests/rspec/issuer_spec.rb

@@ -1,5 +0,0 @@
-RSpec.describe Issuer do
-  it "has a version number" do
-    expect(Issuer::VERSION).not_to be nil
-  end
-end