fantasy-cli 1.2.6

data/lib/gsd/config.rb

@@ -0,0 +1,183 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'fileutils'
+
+module Gsd
+  # Config operations for .planning/config.json
+  class Config
+    class << self
+      # Load config.json
+      #
+      # @param cwd [String] Working directory
+      # @return [Hash] Config hash
+      def load(cwd: nil)
+        cwd ||= Dir.pwd
+        config_path = File.join(cwd, '.planning', 'config.json')
+
+        return default_config unless File.exist?(config_path)
+
+        JSON.parse(File.read(config_path))
+      end
+
+      # Get specific key
+      #
+      # @param key [String] Config key
+      # @param cwd [String] Working directory
+      # @return [Object] Config value or nil
+      def get(key, cwd: nil)
+        load(cwd: cwd)[key]
+      end
+
+      # Set specific key
+      #
+      # @param key [String] Config key
+      # @param value [Object] Config value
+      # @param cwd [String] Working directory
+      def set(key, value, cwd: nil)
+        config = load(cwd: cwd)
+        config[key] = value
+        write(config, cwd: cwd)
+      end
+
+      # Ensure section exists
+      #
+      # @param section [String] Section name
+      # @param cwd [String] Working directory
+      # @return [Hash] Section hash
+      def ensure_section(section, cwd: nil)
+        config = load(cwd: cwd)
+        config[section] ||= {}
+        write(config, cwd: cwd)
+        config[section]
+      end
+
+      # Get model profile for agent type
+      #
+      # @param agent_type [String] Agent type (optional)
+      # @param cwd [String] Working directory
+      # @return [String] Model profile name
+      def model_profile(agent_type = nil, cwd: nil)
+        profiles = load(cwd: cwd)['model_profiles'] || {}
+        return profiles['default'] unless agent_type
+
+        profiles[agent_type] || profiles['default']
+      end
+
+      # Set model profile for agent type
+      #
+      # @param agent_type [String] Agent type
+      # @param profile [String] Model profile name
+      # @param cwd [String] Working directory
+      def set_model_profile(agent_type, profile, cwd: nil)
+        config = load(cwd: cwd)
+        config['model_profiles'] ||= {}
+        config['model_profiles'][agent_type] = profile
+        write(config, cwd: cwd)
+      end
+
+      # Get sub-repos list
+      #
+      # @param cwd [String] Working directory
+      # @return [Array<String>] Sub-repo names
+      def sub_repos(cwd: nil)
+        load(cwd: cwd)['sub_repos'] || []
+      end
+
+      # Add sub-repo to config
+      #
+      # @param repo [String] Sub-repo name
+      # @param cwd [String] Working directory
+      def add_sub_repo(repo, cwd: nil)
+        config = load(cwd: cwd)
+        config['sub_repos'] ||= []
+        config['sub_repos'] << repo unless config['sub_repos'].include?(repo)
+        write(config, cwd: cwd)
+      end
+
+      # Get commit docs setting
+      #
+      # @param cwd [String] Working directory
+      # @return [Boolean] Commit docs enabled
+      def commit_docs(cwd: nil)
+        load(cwd: cwd)['commit_docs'] != false
+      end
+
+      # Get branching strategy
+      #
+      # @param cwd [String] Working directory
+      # @return [String] Branching strategy
+      def branching_strategy(cwd: nil)
+        load(cwd: cwd)['branching_strategy'] || 'feature'
+      end
+
+      # Get parallelization setting
+      #
+      # @param cwd [String] Working directory
+      # @return [Boolean] Parallelization enabled
+      def parallelization(cwd: nil)
+        load(cwd: cwd)['parallelization'] != false
+      end
+
+      # Get research setting
+      #
+      # @param cwd [String] Working directory
+      # @return [Boolean] Research enabled
+      def research(cwd: nil)
+        load(cwd: cwd)['research'] != false
+      end
+
+      # Get plan checker setting
+      #
+      # @param cwd [String] Working directory
+      # @return [Boolean] Plan checker enabled
+      def plan_checker(cwd: nil)
+        load(cwd: cwd)['plan_checker'] != false
+      end
+
+      # Get verifier setting
+      #
+      # @param cwd [String] Working directory
+      # @return [Boolean] Verifier enabled
+      def verifier(cwd: nil)
+        load(cwd: cwd)['verifier'] != false
+      end
+
+      # Initialize config with defaults
+      #
+      # @param cwd [String] Working directory
+      # @return [Hash] Initial config
+      def init(cwd: nil)
+        config = default_config
+        write(config, cwd: cwd)
+        config
+      end
+
+      private
+
+      def default_config
+        {
+          'model_profile' => 'default',
+          'model_profiles' => {
+            'default' => 'claude-sonnet-4-5-20250929'
+          },
+          'commit_docs' => true,
+          'branching_strategy' => 'feature',
+          'phase_branch_template' => 'phase-{phase}',
+          'milestone_branch_template' => 'milestone-{version}',
+          'parallelization' => true,
+          'research' => true,
+          'plan_checker' => true,
+          'verifier' => true,
+          'sub_repos' => []
+        }
+      end
+
+      def write(config, cwd: nil)
+        config_path = File.join(cwd, '.planning', 'config.json')
+        FileUtils.mkdir_p(File.dirname(config_path))
+        File.write(config_path, JSON.pretty_generate(config))
+      end
+    end
+  end
+end

data/lib/gsd/error.rb

@@ -0,0 +1,188 @@
+# frozen_string_literal: true
+
+module Gsd
+  # Base error class para todos os erros do GSD
+  class Error < StandardError; end
+
+  # ============================================================================
+  # State Errors
+  # ============================================================================
+
+  class StateError < Error; end
+  class StateNotFoundError < StateError; end
+  class StateInvalidError < StateError; end
+  class StateFieldError < StateError; end
+
+  # ============================================================================
+  # Phase Errors
+  # ============================================================================
+
+  class PhaseError < Error; end
+  class PhaseNotFoundError < PhaseError; end
+  class PhaseExistsError < PhaseError; end
+  class PhaseInvalidError < PhaseError; end
+
+  # ============================================================================
+  # Roadmap Errors
+  # ============================================================================
+
+  class RoadmapError < Error; end
+  class RoadmapNotFoundError < RoadmapError; end
+  class RoadmapInvalidError < RoadmapError; end
+
+  # ============================================================================
+  # Bridge Errors (Go communication)
+  # ============================================================================
+
+  class BridgeError < Error; end
+  class BridgeNotAvailableError < BridgeError; end
+  class BridgeTimeoutError < BridgeError; end
+  class BridgeExecutionError < BridgeError; end
+
+  # ============================================================================
+  # Validation Errors
+  # ============================================================================
+
+  class ValidationError < Error
+    attr_reader :field, :value
+
+    def initialize(field, value, message)
+      @field = field
+      @value = value
+      super(message)
+    end
+  end
+
+  # ============================================================================
+  # Not Found Errors
+  # ============================================================================
+
+  class NotFoundError < Error
+    attr_reader :resource, :id
+
+    def initialize(resource, id)
+      @resource = resource
+      @id = id
+      super("#{resource} not found: #{id}")
+    end
+  end
+
+  # ============================================================================
+  # File/Path Errors
+  # ============================================================================
+
+  class FileError < Error; end
+  class FileNotFoundError < FileError; end
+  class FileNotReadableError < FileError; end
+  class FileNotWritableError < FileError; end
+
+  class DirectoryError < Error; end
+  class DirectoryNotFoundError < DirectoryError; end
+
+  # ============================================================================
+  # Config Errors
+  # ============================================================================
+
+  class ConfigError < Error; end
+  class ConfigNotFoundError < ConfigError; end
+  class ConfigInvalidError < ConfigError; end
+
+  # ============================================================================
+  # Global Error Handler
+  # ============================================================================
+
+  class ErrorHandler
+    class << self
+      # Handle global de erros com mensagens amigáveis
+      #
+      # @param error [Exception] Error to handle
+      # @param verbose [Boolean] Show full backtrace
+      # @return [Integer] Exit code
+      def handle(error, verbose: false)
+        case error
+        when ValidationError
+          handle_validation_error(error)
+        when NotFoundError
+          handle_not_found_error(error)
+        when BridgeError
+          handle_bridge_error(error)
+        when StateError, PhaseError, RoadmapError
+          handle_domain_error(error)
+        when FileError, DirectoryError
+          handle_file_error(error)
+        when ConfigError
+          handle_config_error(error)
+        else
+          handle_unknown_error(error, verbose: verbose)
+        end
+
+        1
+      end
+
+      private
+
+      def handle_validation_error(error)
+        warn "⚠️  Validation Error"
+        warn "   Field: #{error.field}"
+        warn "   Value: #{error.value.inspect}"
+        warn "   Message: #{error.message}"
+      end
+
+      def handle_not_found_error(error)
+        warn "❌ Not Found"
+        warn "   Resource: #{error.resource}"
+        warn "   ID: #{error.id}"
+      end
+
+      def handle_bridge_error(error)
+        warn "🔌 Go Bridge Error"
+        warn "   #{error.class}: #{error.message}"
+        warn "\n   Tip: Make sure gsd-core binary is built and in PATH"
+        warn "   Run: make build"
+      end
+
+      def handle_domain_error(error)
+        warn "📄 #{error.class}"
+        warn "   #{error.message}"
+      end
+
+      def handle_file_error(error)
+        warn "📁 #{error.class}"
+        warn "   #{error.message}"
+      end
+
+      def handle_config_error(error)
+        warn "⚙️  Config Error"
+        warn "   #{error.message}"
+        warn "\n   Tip: Check .planning/config.json"
+      end
+
+      def handle_unknown_error(error, verbose: false)
+        warn "💥 Unexpected Error"
+        warn "   #{error.class}: #{error.message}"
+
+        if verbose
+          warn "\nBacktrace:"
+          error.backtrace.first(10).each { |line| warn "   #{line}" }
+        end
+      end
+    end
+  end
+
+  # ============================================================================
+  # Error Messages (centralized)
+  # ============================================================================
+
+  module ErrorMessages
+    STATE_NOT_FOUND = "STATE.md not found in .planning directory"
+    STATE_INVALID = "Invalid STATE.md format"
+    PHASE_NOT_FOUND = "Phase directory not found"
+    PHASE_EXISTS = "Phase already exists"
+    ROADMAP_NOT_FOUND = "ROADMAP.md not found in .planning directory"
+    CONFIG_NOT_FOUND = "config.json not found in .planning directory"
+    BINARY_NOT_FOUND = "gsd-core binary not found. Run `make build`"
+    PATH_NOT_FOUND = "Path does not exist"
+    FIELD_INVALID = "Invalid field name"
+    VALUE_INVALID = "Invalid value"
+  end
+end

data/lib/gsd/frontmatter.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+require_relative 'go/bridge'
+require 'json'
+
+module Gsd
+  # Frontmatter - Wrapper Ruby para operações CRUD de frontmatter via Go
+  module Frontmatter
+    class << self
+      # Extrai frontmatter de um arquivo
+      #
+      # @param file [String] Caminho para o arquivo
+      # @param field [String] Campo específico para extrair (opcional)
+      # @param cwd [String] Diretório de trabalho
+      # @return [Hash] Frontmatter data
+      def get(file:, field: nil, cwd: nil)
+        cwd ||= Dir.pwd
+        args = { 'get' => file }
+        args['field'] = field if field
+        result = Go::Bridge.call('frontmatter', args, cwd: cwd)
+        
+        if result['success']
+          result['data']
+        else
+          raise FrontmatterError, result['error']
+        end
+      end
+
+      # Atualiza um campo no frontmatter
+      #
+      # @param file [String] Caminho para o arquivo
+      # @param field [String] Campo para atualizar
+      # @param value [String] Valor para definir
+      # @param cwd [String] Diretório de trabalho
+      # @return [Hash] Resultado da operação
+      def set(file:, field:, value:, cwd: nil)
+        cwd ||= Dir.pwd
+        args = { 'set' => file, 'field' => field, 'value' => value }
+        result = Go::Bridge.call('frontmatter', args, cwd: cwd)
+        
+        if result['success']
+          result['data']
+        else
+          raise FrontmatterError, result['error']
+        end
+      end
+
+      # Mescla dados JSON no frontmatter
+      #
+      # @param file [String] Caminho para o arquivo
+      # @param data [Hash] Dados para mesclar
+      # @param cwd [String] Diretório de trabalho
+      # @return [Hash] Resultado da operação
+      def merge(file:, data:, cwd: nil)
+        cwd ||= Dir.pwd
+        args = { 'merge' => file, 'data' => data.to_json }
+        result = Go::Bridge.call('frontmatter', args, cwd: cwd)
+        
+        if result['success']
+          result['data']
+        else
+          raise FrontmatterError, result['error']
+        end
+      end
+
+      # Valida frontmatter contra um schema
+      #
+      # @param file [String] Caminho para o arquivo
+      # @param schema [String] Schema para validar (plan, summary, verification)
+      # @param cwd [String] Diretório de trabalho
+      # @return [Hash] Resultado da validação
+      def validate(file:, schema:, cwd: nil)
+        cwd ||= Dir.pwd
+        args = { 'validate' => file, 'schema' => schema }
+        result = Go::Bridge.call('frontmatter', args, cwd: cwd)
+        
+        if result['success']
+          result['data']
+        else
+          raise FrontmatterError, result['error']
+        end
+      end
+
+      # Extrai frontmatter e campos específicos
+      #
+      # @param file [String] Caminho para o arquivo
+      # @param fields [Array<String>] Campos para extrair
+      # @param cwd [String] Diretório de trabalho
+      # @return [Hash] Frontmatter data
+      def extract(file:, fields: [], cwd: nil)
+        cwd ||= Dir.pwd
+        args = { 'extract' => file }
+        args['fields'] = fields.join(',') unless fields.empty?
+        result = Go::Bridge.call('frontmatter', args, cwd: cwd)
+        
+        if result['success']
+          result['data']
+        else
+          raise FrontmatterError, result['error']
+        end
+      end
+
+      # Helper: Verifica se frontmatter é válido
+      #
+      # @param result [Hash] Resultado da validação
+      # @return [Boolean] true se válido
+      def valid?(result)
+        result.is_a?(Hash) && result['valid'] == true
+      end
+
+      # Helper: Obtém erros da validação
+      #
+      # @param result [Hash] Resultado da validação
+      # @return [Array<String>] Lista de erros
+      def errors(result)
+        return [] unless result.is_a?(Hash)
+        result['errors'] || result['data']&.dig('errors') || []
+      end
+    end
+
+    class FrontmatterError < StandardError; end
+  end
+end

data/lib/gsd/go/bridge.rb

@@ -0,0 +1,173 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'open3'
+
+module Gsd
+  module Go
+    # Bridge para comunicação com binário Go via subprocess
+    class Bridge
+      class << self
+        attr_accessor :binary_path
+
+        # Caminho para o binário gsd-core
+        def binary_path
+          @binary_path ||= find_binary
+        end
+
+        # Chama um comando no binário Go
+        #
+        # @param command [String] comando a executar
+        # @param args [Hash] argumentos nomeados
+        # @param cwd [String, nil] diretório de trabalho
+        # @return [Hash] resultado parseado como JSON
+        def call(command, args = {}, cwd: nil)
+          cmd = build_command(command, args)
+          
+          log_debug("Executing: #{cmd.join(' ')}")
+          
+          opts = cwd ? { chdir: cwd } : {}
+          stdout, stderr, status = Open3.capture3(*cmd, opts)
+
+          if status && !status.success?
+            raise BridgeError, "Command failed: #{stderr}"
+          end
+
+          begin
+            JSON.parse(stdout)
+          rescue JSON::ParserError => e
+            raise BridgeError, "Failed to parse JSON response: #{e.message}"
+          end
+        rescue Errno::ENOENT => e
+          raise BridgeError, "gsd-core binary not found: #{e.message}"
+        end
+
+        # Retorna a versão do gsd-core
+        def core_version
+          result = call('version')
+          result.dig('data', 'version') || 'unknown'
+        rescue BridgeError
+          'unknown'
+        end
+
+        # State commands
+        def state_load(cwd:)
+          call('state', { 'load' => true }, cwd: cwd)
+        end
+
+        def state_json(cwd:)
+          call('state', { 'json' => true }, cwd: cwd)
+        end
+
+        def state_update(field:, value:, cwd:)
+          call('state', { 'update' => true, 'field' => field, 'value' => value }, cwd: cwd)
+        end
+
+        def state_patch(fields:, cwd:)
+          args = { 'patch' => true }
+          fields.each { |k, v| args[k.to_s] = v.to_s }
+          call('state', args, cwd: cwd)
+        end
+
+        def state_get(section: nil, cwd:)
+          args = section ? { 'get' => section.to_s } : { 'get' => true }
+          call('state', args, cwd: cwd)
+        end
+
+        # Phase commands
+        def phase_find(phase, cwd:)
+          call('phase', { 'find' => phase.to_s }, cwd: cwd)
+        end
+
+        def phase_list(cwd:)
+          call('phase', { 'list' => true }, cwd: cwd)
+        end
+
+        def phase_next_decimal(phase, cwd:)
+          call('phase', { 'next-decimal' => phase.to_s }, cwd: cwd)
+        end
+
+        def phase_add(description, cwd:)
+          call('phase', { 'add' => true, 'description' => description }, cwd: cwd)
+        end
+
+        # Roadmap commands
+        def roadmap_get_phase(phase, cwd:)
+          call('roadmap', { 'get-phase' => phase.to_s }, cwd: cwd)
+        end
+
+        def roadmap_analyze(cwd:)
+          call('roadmap', { 'analyze' => true }, cwd: cwd)
+        end
+
+        private
+
+        # Constrói o comando para execução
+        def build_command(command, args)
+          cmd = [binary_path, command]
+
+          # Handle subcommands - move to front as positional arg
+          subcommand = nil
+          subcommand_keys = %w[load json update patch get find list next-decimal add analyze]
+          args.each do |key, value|
+            if subcommand_keys.include?(key.to_s)
+              subcommand = value.to_s if value != true
+              subcommand = key.to_s if value == true
+              break
+            end
+          end
+
+          cmd << subcommand if subcommand
+
+          # Add named arguments (excluding subcommand keys)
+          args.each do |key, value|
+            next if subcommand_keys.include?(key.to_s)
+            next if value.nil?
+
+            if value == true
+              cmd << "--#{key}"
+            elsif value.is_a?(String) && !value.empty?
+              cmd << "--#{key}=#{value}"
+            end
+          end
+
+          cmd
+        end
+
+        # Encontra o binário gsd-core
+        def find_binary
+          # Prioridade 1: bin/ no root do projeto (Windows e Unix)
+          # lib/gsd/go/bridge.rb -> ../../../bin/gsd-core
+          project_root = File.expand_path('../../../..', __dir__)
+          local_bin = File.join(project_root, 'bin', 'gsd-core')
+          local_bin_exe = "#{local_bin}.exe"
+
+          if File.executable?(local_bin)
+            return local_bin
+          elsif File.executable?(local_bin_exe)
+            return local_bin_exe
+          end
+
+          # Prioridade 2: bin/ relativo ao diretório atual
+          cwd_bin = File.join(Dir.pwd, 'bin', 'gsd-core')
+          cwd_bin_exe = "#{cwd_bin}.exe"
+          return cwd_bin if File.executable?(cwd_bin)
+          return cwd_bin_exe if File.executable?(cwd_bin_exe)
+
+          # Prioridade 3: PATH do sistema
+          in_path = `where gsd-core 2>nul`.strip
+          in_path = `which gsd-core 2>/dev/null`.strip if in_path.empty?
+          return in_path unless in_path.empty?
+
+          raise BridgeError, 'gsd-core binary not found. Run `make build` first.'
+        end
+
+        def log_debug(msg)
+          warn "[gsd-go] #{msg}" if ENV['GSD_DEBUG']
+        end
+      end
+
+      class BridgeError < StandardError; end
+    end
+  end
+end