featureparity 0.0.8 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c622199401f105760e517583ace2bb9ec9da7f6f125d960144783ec82e2922b4
-  data.tar.gz: ab0b372febeff5b863f46d80d093ff8ac789bb4fdd2ae9ceab443f81a8b9a2f5
+  metadata.gz: 20c34d118adff460a3de1eaaa15f66718593100ae0261f9dc064f63b65d8b3f2
+  data.tar.gz: e14ab1bf7bbf6c646f42e0b9a9291653e072f47055b8dff8ccf2294d10effa7a
 SHA512:
-  metadata.gz: ed416b54e77e1aa6e9ce490283811ac5b81443f34aef97cf9b47987719bc5b5497456c4fd3bb74b1f308b735ab07bc5682a06a4d13548cd48272135160692cd2
-  data.tar.gz: 6316ceda063c279ad46dd763c5ab9b1366a27cd00c1eb8d6f52b7ce21995c203040f86667e76a4a921e77d7a14c380ec85aaedb1ad0c4468e8284b185cf69a5c
+  metadata.gz: 248bf8d80901ed3a4075e44e501169bd37803dc4fad78b3b342cfd79307a4649b824664a0b7ce5013f3fd323b2f64ed7deaa2318813389604e21d8c212cd2c36
+  data.tar.gz: 1e22a8d5b38f77581693dd4cb0d912aedb0d09afa8cdffaa96332eca3afc1d9c62893ff2c0a09e9ca7f4d44d46fd6126d71b915cb3bfa357099c2a3726ce2006

data/lib/fp/client.rb

@@ -27,6 +27,31 @@ module Fp
       get("/api/projects/#{project_id}/surfaces")
     end
 
+    # GET /projects/:id/surfaces/:surface_id
+    def get_surface(project_id, surface_id)
+      get("/api/projects/#{project_id}/surfaces/#{surface_id}")
+    end
+
+    # Find a single surface by its key within a project.
+    #
+    # Agents speak surface *keys* ("customer_android"), not the KSUID the surface is
+    # stored under, so — the same way find_requirement_by_slug resolves a slug — list the
+    # project's surfaces and match on key. Returns the same { ok:, data: } envelope the
+    # rest of the client speaks, with a 404 when no surface has that key.
+    def find_surface_by_key(project_id, key)
+      result = list_surfaces(project_id)
+      return result unless result[:ok]
+
+      surfaces = result[:data]['surfaces'] || []
+      surface = surfaces.find { |s| s['key'] == key }
+
+      if surface
+        { ok: true, data: { 'surface' => surface }, status: 200 }
+      else
+        { ok: false, error: "Surface '#{key}' not found in project", status: 404 }
+      end
+    end
+
     # POST /projects/:id/surfaces
     def create_surface(project_id, params)
       post("/api/projects/#{project_id}/surfaces", params)

data/lib/fp/commands/help.rb

@@ -15,6 +15,7 @@ module Fp
             init --project <slug>             Onboard this repo: config, CI gate, agent docs
             projects                          List projects you have access to
             surfaces --project <slug>         List surfaces for a project
+            surfaces show <key> --project ... View a single surface's details
             surfaces add <key> --project ...  Create a surface
             list --project <slug>             List active requirements
             show <slug> --project <slug>      Show requirement details
@@ -121,6 +122,9 @@ module Fp
             # List the surfaces a project tracks (requirements may only name these)
             fp surfaces --project stowzilla
 
+            # View a single surface's details (owner, repo, kind, test globs)
+            fp surfaces show customer_android --project stowzilla
+
             # Create a surface (agents can do this — no need to wait on the web app)
             fp surfaces add customer_android --project stowzilla \\
               --name "Customer Android App" \\

data/lib/fp/commands/surfaces.rb

@@ -1,8 +1,11 @@
 # frozen_string_literal: true
 
+require 'json'
+
 module Fp
   module Commands
     # fp surfaces --project <slug>              - list available surfaces for a project
+    # fp surfaces show <key> --project <slug>   - view a single surface's details
     # fp surfaces add <key> --project <slug>    - create a surface
     #
     # `add` exists because a requirement can only name surfaces that already exist, so an
@@ -24,8 +27,11 @@ module Fp
       def run(args)
         # Subcommand dispatch. Bare `fp surfaces --project X` stays a list, so existing
         # callers (and the docs) keep working.
-        if args.first == 'add'
+        case args.first
+        when 'add'
           add(args[1..])
+        when 'show'
+          show(args[1..])
         else
           list(args)
         end
@@ -59,6 +65,31 @@ module Fp
         end
       end
 
+      def show(args)
+        opts, positional = parse_flags(args)
+        require_project!(opts)
+
+        key = positional.first
+        if key.nil? || key.strip.empty?
+          output.error('Usage: fp surfaces show <key> --project <slug>')
+          exit 1
+        end
+
+        project_id = resolve_project_id(opts[:project])
+        result = client.find_surface_by_key(project_id, key)
+
+        unless result[:ok]
+          output.error(result[:error], status: result[:status])
+          exit 1
+        end
+
+        surface = result[:data]['surface'] || {}
+
+        output.success(result[:data]) do
+          print_surface(surface, project: opts[:project])
+        end
+      end
+
       def add(args)
         opts, positional = parse_flags(args, ADD_FLAGS)
         require_project!(opts)
@@ -108,6 +139,54 @@ module Fp
         output.error("Invalid #{flag} '#{value}'. Must be one of: #{allowed.join(', ')}")
         exit 1
       end
+
+      # Human-readable detail view for a single surface. Mirrors the shape of
+      # `fp show` for requirements: title underline, then the fields that matter.
+      def print_surface(surface, project:)
+        name = surface['name'] || surface['key'].to_s
+        puts name
+        puts '=' * name.length
+        puts
+        puts "Key:      #{surface['key']}"
+        puts "Project:  #{project}"
+        puts "Kind:     #{surface['kind'] || '(none)'}"
+        puts "Audience: #{surface['audience'] || '(none)'}"
+        puts "Repo:     #{surface['repo'] || '(none)'}"
+        puts "Branch:   #{surface['default_branch'] || '(none)'}" if surface.key?('default_branch')
+
+        owner = surface['owner_id']
+        team = surface['team']
+        puts "Owner:    #{owner && !owner.to_s.empty? ? owner : '(unassigned)'}"
+        puts "Team:     #{team && !team.to_s.empty? ? team : '(none)'}"
+
+        globs = normalize_test_globs(surface['test_globs'])
+        unless globs.empty?
+          puts
+          puts 'Test Globs:'
+          globs.each { |g| puts "  - #{g}" }
+        end
+
+        puts
+        puts "ID:       #{surface['id']}" if surface['id']
+        puts "Created:  #{surface['created_at']}" if surface['created_at']
+        puts "Updated:  #{surface['updated_at']}" if surface['updated_at']
+      end
+
+      # test_globs may arrive as a JSON string or an array; normalize to an array for
+      # display. Blank/unparseable → empty (the server falls back to kind defaults).
+      def normalize_test_globs(value)
+        case value
+        when Array then value
+        when String
+          stripped = value.strip
+          return [] if stripped.empty?
+
+          parsed = JSON.parse(stripped) rescue nil
+          parsed.is_a?(Array) ? parsed : []
+        else
+          []
+        end
+      end
     end
   end
 end

data/lib/fp/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: featureparity
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.9
 platform: ruby
 authors:
 - Stowzilla
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-17 00:00:00.000000000 Z
+date: 2026-09-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http