issuer 0.1.0 → 0.1.1

data/scripts/lint-docs.sh

@@ -1,64 +0,0 @@
-#!/usr/bin/env bash
-# Vale linting script for the issuer project
-
-set -e
-
-echo "🔍 Running Vale linter on issuer project..."
-
-# Colors for output
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m' # No Color
-
-# Check if Vale is installed
-if ! command -v vale &> /dev/null; then
-  echo -e "${RED}❌ Vale is not installed. Please install Vale first.${NC}"
-  echo "   You can install it from: https://github.com/errata-ai/vale"
-  exit 1
-fi
-
-# Check if .vale.ini exists
-if [[ ! -f ".vale.ini" ]]; then
-  echo -e "${RED}❌ .vale.ini not found in current directory${NC}"
-  echo "   Please run this script from the project root."
-  exit 1
-fi
-
-# Default to checking all relevant files if no arguments provided
-if [[ $# -eq 0 ]]; then
-  FILES=(
-    "README.adoc"
-    "lib/examples/*.md"
-    "specs/tests/*.md" 
-    "*.adoc"
-    "docs/*.adoc"
-  )
-else
-  FILES=("$@")
-fi
-
-echo "📁 Files to check: ${FILES[*]}"
-echo ""
-
-# Run Vale
-EXIT_CODE=0
-for pattern in "${FILES[@]}"; do
-  # Use find to expand patterns and handle missing files gracefully
-  while IFS= read -r -d '' file; do
-    if [[ -f "$file" ]]; then
-      echo -e "${YELLOW}📄 Checking: $file${NC}"
-      if ! vale "$file"; then
-        EXIT_CODE=1
-      fi
-    fi
-  done < <(find . -name "$pattern" -print0 2>/dev/null)
-done
-
-if [[ $EXIT_CODE -eq 0 ]]; then
-  echo -e "${GREEN}✅ Vale linting completed successfully!${NC}"
-else
-  echo -e "${RED}❌ Vale found issues. Please review and fix them.${NC}"
-fi
-
-exit $EXIT_CODE

data/scripts/manage-runs.rb

@@ -1,175 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-# Run management utility for issuer CLI
-# Lists and manages cached runs in .issuer/logs/
-
-require 'bundler/setup'
-$LOAD_PATH.unshift(File.expand_path('../lib', __dir__))
-require 'issuer/cache'
-
-def show_help
-  puts <<~HELP
-  Issuer Run Management Utility
-  
-  Usage:
-    ruby scripts/manage-runs.rb [command]
-  
-  Commands:
-    list                 List all cached runs
-    list --recent        List recent runs only (last 10)
-    show RUN_ID          Show detailed information for a specific run
-    clean-logs           Remove all log files (use with caution)
-    
-  Examples:
-    ruby scripts/manage-runs.rb list
-    ruby scripts/manage-runs.rb show run_20250711_180124_97d1f1f3
-    ruby scripts/manage-runs.rb list --recent
-  HELP
-end
-
-def list_runs recent_only = false
-  runs = Issuer::Cache.list_runs
-  runs = runs.take(10) if recent_only
-  
-  if runs.empty?
-    puts "No cached runs found."
-    return
-  end
-  
-  puts "Cached Runs#{recent_only ? ' (Recent)' : ''}:"
-  puts "=" * 60
-  
-  runs.each do |run|
-    puts "#{run[:run_id]} - #{run[:status].upcase}"
-    puts "  Started: #{run[:started_at]}"
-    
-    if run[:metadata] && run[:metadata][:issues_planned]
-      puts "  Issues planned: #{run[:metadata][:issues_planned]}"
-    end
-    
-    if run[:status] == 'completed'
-      puts "  Completed: #{run[:completed_at]}"
-      puts "  Artifacts: #{run[:summary][:issues_created]} issues, #{run[:summary][:milestones_created]} milestones, #{run[:summary][:labels_created]} labels"
-      puts "  Processed: #{run[:summary][:issues_processed]} issues"
-    elsif run[:status] == 'failed'
-      puts "  Failed: #{run[:failed_at] || 'unknown time'}"
-      puts "  Error: #{run[:error] || 'no error message'}"
-    end
-    puts ""
-  end
-  
-  puts "Total: #{runs.length} runs"
-  puts "Use 'ruby scripts/manage-runs.rb show RUN_ID' for detailed view"
-end
-
-def show_run run_id
-  run_data = Issuer::Cache.get_run(run_id)
-  unless run_data
-    puts "Error: Run #{run_id} not found."
-    return
-  end
-  
-  puts "Run Details: #{run_id}"
-  puts "=" * 60
-  puts "Status: #{run_data[:status]}"
-  puts "Started: #{run_data[:started_at]}"
-  
-  if run_data[:completed_at]
-    puts "Completed: #{run_data[:completed_at]}"
-  end
-  
-  if run_data[:failed_at]
-    puts "Failed: #{run_data[:failed_at]}"
-    puts "Error: #{run_data[:error]}" if run_data[:error]
-  end
-  
-  if run_data[:metadata]
-    puts ""
-    puts "Metadata:"
-    run_data[:metadata].each do |key, value|
-      puts "  #{key}: #{value}"
-    end
-  end
-  
-  if run_data[:artifacts]
-    puts ""
-    puts "Artifacts Created:"
-    
-    [:issues, :milestones, :labels].each do |type|
-      artifacts = run_data[:artifacts][type.to_s] || run_data[:artifacts][type] || []
-      next if artifacts.empty?
-      
-      puts "  #{type.to_s.capitalize} (#{artifacts.length}):"
-      artifacts.each do |artifact|
-        case type
-        when :issues
-          puts "    ##{artifact[:number] || artifact['number']} - #{artifact[:title] || artifact['title']}"
-          puts "      #{artifact[:url] || artifact['url']}"
-        when :milestones
-          puts "    ##{artifact[:number] || artifact['number']} - #{artifact[:title] || artifact['title']}"
-          puts "      #{artifact[:url] || artifact['url']}"
-        when :labels
-          puts "    #{artifact[:name] || artifact['name']} (#{artifact[:color] || artifact['color']})"
-          puts "      #{artifact[:url] || artifact['url']}"
-        end
-        puts ""
-      end
-    end
-  end
-  
-  if run_data[:summary]
-    puts "Summary:"
-    run_data[:summary].each do |key, value|
-      puts "  #{key}: #{value}"
-    end
-  end
-end
-
-def clean_logs
-  logs_dir = Issuer::Cache.logs_dir
-  unless Dir.exist?(logs_dir)
-    puts "No logs directory found."
-    return
-  end
-  
-  log_files = Dir.glob(File.join(logs_dir, '*.json'))
-  if log_files.empty?
-    puts "No log files found."
-    return
-  end
-  
-  puts "Found #{log_files.length} log files."
-  print "Are you sure you want to delete all log files? [y/N]: "
-  response = STDIN.gets.chomp.downcase
-  
-  unless ['y', 'yes'].include?(response)
-    puts "Cancelled."
-    return
-  end
-  
-  log_files.each { |f| File.delete(f) }
-  puts "Deleted #{log_files.length} log files."
-end
-
-# Main execution
-case ARGV[0]
-when 'list'
-  recent_only = ARGV.include?('--recent')
-  list_runs(recent_only)
-when 'show'
-  if ARGV[1]
-    show_run(ARGV[1])
-  else
-    puts "Error: Please specify a run ID"
-    puts "Usage: ruby scripts/manage-runs.rb show RUN_ID"
-  end
-when 'clean-logs'
-  clean_logs
-when nil, '--help', '-h'
-  show_help
-else
-  puts "Error: Unknown command '#{ARGV[0]}'"
-  puts ""
-  show_help
-end

data/scripts/pre-commit-template.sh

@@ -1,54 +0,0 @@
-#!/usr/bin/env bash
-# Pre-commit hook for Vale linting
-
-set -e
-
-echo "🔍 Running Vale pre-commit check..."
-
-# Check if Vale is installed
-if ! command -v vale &> /dev/null; then
-  echo "⚠️  Vale not found. Skipping documentation linting."
-  echo "   Install Vale to enable documentation quality checks."
-  exit 0
-fi
-
-# Get list of staged files that we care about (excluding copilot instructions)
-STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(md|adoc|asciidoc)$' | grep -v '^\.github/copilot-instructions\.md$' || true)
-
-if [[ -z "$STAGED_FILES" ]]; then
-  echo "ℹ️  No documentation files staged for commit."
-  exit 0
-fi
-
-echo "📄 Checking staged documentation files:"
-echo "$STAGED_FILES"
-
-# Run Vale on staged files
-TEMP_DIR=$(mktemp -d)
-EXIT_CODE=0
-
-for file in $STAGED_FILES; do
-  if [[ -f "$file" ]]; then
-    # Copy staged version to temp location
-    git show :"$file" > "$TEMP_DIR/$(basename "$file")"
-    
-    echo "🔍 Linting: $file"
-    if ! vale "$TEMP_DIR/$(basename "$file")"; then
-        EXIT_CODE=1
-    fi
-  fi
-done
-
-# Cleanup
-rm -rf "$TEMP_DIR"
-
-if [[ $EXIT_CODE -ne 0 ]]; then
-  echo ""
-  echo "❌ Vale found documentation issues in staged files."
-  echo "   Please fix the issues above before committing."
-  echo "   Or use 'git commit --no-verify' to bypass this check."
-  exit 1
-fi
-
-echo "✅ Documentation quality check passed!"
-exit 0

data/scripts/publish.sh

@@ -1,92 +0,0 @@
-#!/bin/bash
-# Manual publishing script for Ruby gem projects
-
-set -e
-
-# Parse command line arguments
-DRY_RUN=false
-while [[ $# -gt 0 ]]; do
-  case $1 in
-    --dry-run)
-      DRY_RUN=true
-      shift
-      ;;
-    *)
-      echo "Unknown option: $1"
-      echo "Usage: $0 [--dry-run]"
-      exit 1
-      ;;
-  esac
-done
-
-# 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} Publishing Script${NC}"
-echo "=============================="
-
-# Check for required environment variables (skip in dry-run mode)
-if [ "$DRY_RUN" = false ]; then
-    if [ -z "$RUBYGEMS_API_KEY" ]; then
-        echo -e "${RED}❌ Error: RUBYGEMS_API_KEY environment variable not set${NC}"
-        echo "Get your API key from https://rubygems.org/profile/edit"
-        echo "Then run: export RUBYGEMS_API_KEY=your_key_here"
-        exit 1
-    fi
-
-    if [ -z "$DOCKERHUB_USERNAME" ] || [ -z "$DOCKERHUB_TOKEN" ]; then
-        echo -e "${RED}❌ Error: Docker Hub credentials not set${NC}"
-        echo "Set DOCKERHUB_USERNAME and DOCKERHUB_TOKEN environment variables"
-        exit 1
-    fi
-fi
-
-# Get current version
-current_version=$(get_current_version)
-gem_file="pkg/${PROJECT_NAME}-$current_version.gem"
-
-# Check if gem file exists
-if [ ! -f "$gem_file" ]; then
-    echo -e "${RED}❌ Error: Gem file $gem_file not found${NC}"
-    echo "Run ./scripts/build.sh first"
-    exit 1
-fi
-
-if [ "$DRY_RUN" = true ]; then
-  echo -e "${YELLOW}🔍 Dry run mode enabled. The following actions would be performed:${NC}"
-  echo "- Publish to RubyGems: gem push $gem_file"
-  echo "- Login to Docker Hub and push Docker images"
-else
-  # Publish to RubyGems
-  echo -e "${YELLOW}💎 Publishing to RubyGems...${NC}"
-  mkdir -p ~/.gem
-  echo ":rubygems_api_key: $RUBYGEMS_API_KEY" > ~/.gem/credentials
-  chmod 0600 ~/.gem/credentials
-  gem push "$gem_file"
-  echo -e "${GREEN}✅ Published to RubyGems successfully${NC}"
-
-  # Login to Docker Hub
-  echo -e "${YELLOW}🐳 Logging in to Docker Hub...${NC}"
-  echo "$DOCKERHUB_TOKEN" | docker login -u "$DOCKERHUB_USERNAME" --password-stdin
-
-  # Push Docker images
-  echo -e "${YELLOW}🐳 Pushing Docker images...${NC}"
-  docker push ${DOCKER_ORG}/${PROJECT_NAME}:$current_version
-  docker push ${DOCKER_ORG}/${PROJECT_NAME}:latest
-  echo -e "${GREEN}✅ Pushed Docker images successfully${NC}"
-fi
-
-echo
-echo -e "${GREEN}🎉 Publishing completed successfully!${NC}"
-echo "=============================="
-echo -e "Gem: ${YELLOW}https://rubygems.org/gems/${PROJECT_NAME}/versions/$current_version${NC}"
-echo -e "Docker: ${YELLOW}https://hub.docker.com/r/${DOCKER_ORG}/${PROJECT_NAME}${NC}"
-echo
-echo "Verify installation:"
-echo "  gem install ${PROJECT_NAME}"
-echo "  docker pull ${DOCKER_ORG}/${PROJECT_NAME}:$current_version"

data/scripts/setup-vale.sh

@@ -1,59 +0,0 @@
-#!/usr/bin/env bash
-# Vale setup script for new developers
-# This sets up Vale documentation linting for this project
-
-set -e
-
-echo "🔧 Setting up Vale for issuer project..."
-
-# Check if Vale is installed, install if needed
-if ! command -v vale &> /dev/null; then
-    echo "📦 Installing Vale..."
-    
-    if command -v brew &> /dev/null; then
-        echo "   Using Homebrew..."
-        brew install vale
-    elif command -v wget &> /dev/null; then
-        echo "   Downloading Vale binary..."
-        wget -O /tmp/vale.tar.gz https://github.com/errata-ai/vale/releases/download/v3.12.0/vale_3.12.0_Linux_64-bit.tar.gz
-        cd /tmp && tar -xzf vale.tar.gz
-        sudo mv vale /usr/local/bin/
-        rm vale.tar.gz
-    else
-        echo "❌ Please install Vale manually:"
-        echo "   https://github.com/errata-ai/vale/releases"
-        echo "   Or install Homebrew/wget and run this script again"
-        exit 1
-    fi
-    
-    echo "✅ Vale installed successfully!"
-else
-    echo "✅ Vale already installed ($(vale --version))"
-fi
-
-# Sync Vale style packages
-echo "🔄 Syncing Vale style packages..."
-vale sync
-
-# Install pre-commit hook if it doesn't exist
-HOOK_FILE=".git/hooks/pre-commit"
-if [[ ! -f "$HOOK_FILE" ]]; then
-    echo "🪝 Installing pre-commit hook..."
-    cp "scripts/pre-commit-template.sh" "$HOOK_FILE"
-    chmod +x "$HOOK_FILE"
-    echo "✅ Pre-commit hook installed!"
-else
-    echo "ℹ️  Pre-commit hook already exists"
-fi
-
-echo ""
-echo "🎉 Vale setup complete!"
-echo ""
-echo "📖 Available commands:"
-echo "   vale README.adoc           # Lint a specific file"
-echo "   rake lint_docs             # Lint all documentation"
-echo "   rake lint_readme           # Lint README only"
-echo "   ./scripts/lint-docs.sh     # Run comprehensive linting"
-echo ""
-echo "🔍 Pre-commit hook will automatically check documentation on commit"
-echo "   Use 'git commit --no-verify' to skip if needed"