featureparity 0.0.1

data/lib/fp/config.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require 'yaml'
+require 'fileutils'
+
+module Fp
+  # Handles configuration: profiles, API keys, API URL.
+  # Priority: FP_API_KEY env var > --profile flag > FP_PROFILE env var > default profile
+  class Config
+    DEFAULT_API_URL = 'https://api.featureparity.dev'
+    CONFIG_DIR = File.expand_path('~/.config/fp')
+    CONFIG_FILE = File.join(CONFIG_DIR, 'config.yml')
+
+    attr_reader :api_key, :api_url, :profile_name
+
+    def initialize(profile: nil)
+      @profile_name = resolve_profile_name(profile)
+      @api_key = resolve_api_key
+      @api_url = resolve_api_url
+    end
+
+    def valid?
+      !@api_key.nil? && !@api_key.empty?
+    end
+
+    def validation_error
+      return nil if valid?
+
+      <<~MSG
+        No API key found. Set FP_API_KEY environment variable or add a profile:
+          fp profile add <name> --api-key fp_...
+      MSG
+    end
+
+    class << self
+      def load_profiles
+        return {} unless File.exist?(CONFIG_FILE)
+
+        config = YAML.safe_load_file(CONFIG_FILE, permitted_classes: [Symbol]) || {}
+        config['profiles'] || {}
+      rescue StandardError => e
+        warn "Warning: Could not load config file: #{e.message}"
+        {}
+      end
+
+      def save_profile(name, api_key:, api_url: nil)
+        FileUtils.mkdir_p(CONFIG_DIR)
+
+        # Ensure config file has restricted permissions
+        unless File.exist?(CONFIG_FILE)
+          File.write(CONFIG_FILE, "---\nprofiles: {}\n")
+          File.chmod(0o600, CONFIG_FILE)
+        end
+
+        config = YAML.safe_load_file(CONFIG_FILE, permitted_classes: [Symbol]) || {}
+        config['profiles'] ||= {}
+        config['profiles'][name] = {
+          'api_key' => api_key
+        }
+        config['profiles'][name]['api_url'] = api_url if api_url
+
+        File.write(CONFIG_FILE, YAML.dump(config))
+        File.chmod(0o600, CONFIG_FILE)
+      end
+
+      def list_profiles
+        load_profiles.keys
+      end
+
+      def profile_exists?(name)
+        load_profiles.key?(name)
+      end
+    end
+
+    private
+
+    def resolve_profile_name(explicit_profile)
+      # Explicit --profile flag takes precedence over FP_PROFILE env var
+      explicit_profile || ENV['FP_PROFILE']
+    end
+
+    def resolve_api_key
+      # FP_API_KEY env var always wins
+      return ENV['FP_API_KEY'] if ENV['FP_API_KEY'] && !ENV['FP_API_KEY'].empty?
+
+      # Otherwise, use profile if specified
+      return nil unless @profile_name
+
+      profiles = self.class.load_profiles
+      profile = profiles[@profile_name]
+      return nil unless profile
+
+      profile['api_key']
+    end
+
+    def resolve_api_url
+      # FP_API_URL env var takes precedence
+      return ENV['FP_API_URL'] if ENV['FP_API_URL'] && !ENV['FP_API_URL'].empty?
+
+      # Then profile-specific URL
+      if @profile_name
+        profiles = self.class.load_profiles
+        profile = profiles[@profile_name]
+        return profile['api_url'] if profile && profile['api_url']
+      end
+
+      # Finally, default
+      DEFAULT_API_URL
+    end
+  end
+end

data/lib/fp/output.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'csv'
+
+module Fp
+  # Output formatting for CLI responses
+  # Follows Fizzy CLI conventions: { ok: true/false, data: ..., error: ... }
+  class Output
+    def initialize(json: false)
+      @json = json
+    end
+
+    def json?
+      @json
+    end
+
+    def success(data, summary: nil)
+      if @json
+        puts JSON.pretty_generate({ ok: true, data: data })
+      else
+        yield if block_given?
+        puts summary if summary
+      end
+    end
+
+    def error(message, status: nil)
+      if @json
+        result = { ok: false, error: message }
+        result[:status] = status if status
+        puts JSON.pretty_generate(result)
+      else
+        warn "Error: #{message}"
+      end
+    end
+
+    def table(headers, rows)
+      return if rows.empty?
+
+      if @json
+        # For JSON output, return data as array of hashes
+        data = rows.map { |row| headers.zip(row).to_h }
+        puts JSON.pretty_generate({ ok: true, data: data })
+      else
+        # ASCII table
+        widths = headers.map.with_index do |header, i|
+          [header.to_s.length, *rows.map { |r| r[i].to_s.length }].max
+        end
+
+        separator = '+' + widths.map { |w| '-' * (w + 2) }.join('+') + '+'
+        format_row = lambda do |row|
+          '| ' + row.map.with_index { |cell, i| cell.to_s.ljust(widths[i]) }.join(' | ') + ' |'
+        end
+
+        puts separator
+        puts format_row.call(headers)
+        puts separator
+        rows.each { |row| puts format_row.call(row) }
+        puts separator
+      end
+    end
+
+    def csv(headers, rows)
+      csv_string = CSV.generate do |csv|
+        csv << headers
+        rows.each { |row| csv << row }
+      end
+      puts csv_string
+    end
+  end
+end

data/lib/fp/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Fp
+  VERSION = '0.0.1'
+end

data/lib/fp.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative 'fp/version'
+require_relative 'fp/config'
+require_relative 'fp/client'
+require_relative 'fp/output'
+require_relative 'fp/commands'
+require_relative 'fp/cli'
+
+module Fp
+  class Error < StandardError; end
+  class AuthError < Error; end
+  class APIError < Error; end
+end

metadata

@@ -0,0 +1,139 @@
+--- !ruby/object:Gem::Specification
+name: featureparity
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Stowzilla
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-08-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: net-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: yaml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: uri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Command-line interface for FeatureParity - report evidence, propose requirements,
+  view parity matrix.
+email:
+- team@stowzilla.com
+executables:
+- fp
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/fp
+- lib/fp.rb
+- lib/fp/cli.rb
+- lib/fp/client.rb
+- lib/fp/commands.rb
+- lib/fp/commands/base.rb
+- lib/fp/commands/help.rb
+- lib/fp/commands/list.rb
+- lib/fp/commands/matrix.rb
+- lib/fp/commands/profile.rb
+- lib/fp/commands/projects.rb
+- lib/fp/commands/propose.rb
+- lib/fp/commands/report.rb
+- lib/fp/commands/setup.rb
+- lib/fp/commands/show.rb
+- lib/fp/commands/surfaces.rb
+- lib/fp/commands/version.rb
+- lib/fp/config.rb
+- lib/fp/output.rb
+- lib/fp/version.rb
+homepage: https://featureparity.dev
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+  homepage_uri: https://featureparity.dev
+  source_code_uri: https://github.com/stowzilla/feature_parity
+  changelog_uri: https://github.com/stowzilla/feature_parity/blob/master/cli/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: FeatureParity CLI
+test_files: []