featureparity 0.0.14 → 0.0.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7fc65a33008ccbd43f9b8ec10f7e3c013ab3ed502980f97b64c55e14ff1d2eb5
-  data.tar.gz: a841a639236c27ea6bf7c30ba1a7f4a5710176bc0fd4bb153daac009d89e90db
+  metadata.gz: dd15c5892d88c0202433fd6e11993440f45cd3cb8c754c0c7138309008190cbb
+  data.tar.gz: 356c8c54af360a47639e2dfc6313774247ff93534eb02b6666656f738d69ce70
 SHA512:
-  metadata.gz: df0c381690d9fa55e189e3a057eddd35c979bb970fac56b9294ad426d758613374c483c5f4317829cedd5a85d3ff3443a543e8dbcfdff99a146a82c7de831c53
-  data.tar.gz: f2d8dd3a182c74e6e7ef5e4395803eaf86a62b510532227c2b7ec4c3bf4a3fe06db62c8866280d016c7cb4d1cb6a786b2b5c2dcb731f5f0ada518de288eb3714
+  metadata.gz: d0d96204c4cf14ff9c7f5bbf1930f1ad6f170b11be67651df1cda342c2ad41e53e1a09ea93bed84db620d2c867f26ffbc313fa2d132f7b5b8b474026b4ea9ee8
+  data.tar.gz: c43e169274e9c6484b6e41c2bcb1c5748eaee9dabad8c39f523c7ed30a08f0edaeae3df7637edc799d2089165624108e72fdb517c95d580cc51c1b747064726b

data/lib/fp/cli.rb

@@ -12,6 +12,7 @@ module Fp
       'propose' => Commands::Propose,
       'propose-change' => Commands::ProposeChange,
       'history' => Commands::History,
+      'changes' => Commands::Changes,
       'report' => Commands::Report,
       'ci-report' => Commands::CiReport,
       'check' => Commands::Check,
@@ -23,7 +24,10 @@ module Fp
       'setup' => Commands::Setup,
       'whoami' => Commands::Whoami,
       'version' => Commands::Version,
-      'help' => Commands::Help
+      'help' => Commands::Help,
+      'attach' => Commands::Attach,
+      'attachments' => Commands::Attachments,
+      'conversation' => Commands::Conversation
     }.freeze
 
     class << self

data/lib/fp/client.rb

@@ -98,6 +98,14 @@ module Fp
       put("/api/requirements/#{id}", params)
     end
 
+    # GET /projects/:project_id/requirement_changes — project-wide audit activity,
+    # optionally narrowed to the exact work-item URL that prompted it.
+    def list_project_requirement_changes(project_id, source_url: nil)
+      params = {}
+      params[:source_url] = source_url if source_url
+      get("/api/projects/#{project_id}/requirement_changes", params)
+    end
+
     # GET /requirements/:id/changes
     #
     # A requirement's change history: what it was, what changed, who changed it, and
@@ -203,6 +211,84 @@ module Fp
       post("/api/projects/#{project_id}/parity/preview", body)
     end
 
+    # GET /conversations/:id — read a conversation by id alone, regardless of whether
+    # it is project- or account-scoped. The server resolves the owner from the record
+    # and authorizes the caller; the CLI (and the agent using it) never needs to know
+    # or pass the scope. A conversation is just a record.
+    def get_conversation(conversation_id)
+      get("/api/conversations/#{conversation_id}")
+    end
+
+    # --- Attachments ---
+
+    # GET /requirements/:requirement_id/attachments
+    # List all attachments for a requirement.
+    def list_attachments(requirement_id)
+      get("/api/requirements/#{requirement_id}/attachments")
+    end
+
+    # POST /requirements/:requirement_id/attachments/presign
+    # Get a presigned URL for uploading a file.
+    def presign_attachment(requirement_id, filename:, content_type:, size_bytes:)
+      post("/api/requirements/#{requirement_id}/attachments/presign", {
+        filename: filename,
+        content_type: content_type,
+        size_bytes: size_bytes
+      })
+    end
+
+    # POST /requirements/:requirement_id/attachments
+    # Confirm an upload and create the attachment record.
+    def create_attachment(requirement_id, attachment_id:, s3_key:, filename:, content_type:, size_bytes:)
+      post("/api/requirements/#{requirement_id}/attachments", {
+        attachment_id: attachment_id,
+        s3_key: s3_key,
+        filename: filename,
+        content_type: content_type,
+        size_bytes: size_bytes
+      })
+    end
+
+    # GET /requirements/:requirement_id/attachments/:id
+    # Get a presigned download URL for an attachment.
+    def get_attachment(requirement_id, attachment_id)
+      get("/api/requirements/#{requirement_id}/attachments/#{attachment_id}")
+    end
+
+    # DELETE /requirements/:requirement_id/attachments/:id
+    # Delete an attachment.
+    def delete_attachment(requirement_id, attachment_id)
+      delete("/api/requirements/#{requirement_id}/attachments/#{attachment_id}")
+    end
+
+    # Upload a file to S3 using a presigned URL.
+    # This is called after presign_attachment returns the upload_url.
+    def upload_to_presigned_url(url, file_path, content_type)
+      uri = URI.parse(url)
+      file_content = File.binread(file_path)
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == 'https'
+      http.open_timeout = 30
+      http.read_timeout = 120 # Allow longer for file upload
+
+      request = Net::HTTP::Put.new(uri)
+      request.body = file_content
+      request['Content-Type'] = content_type
+      request['Content-Length'] = file_content.bytesize.to_s
+
+      response = http.request(request)
+      status = response.code.to_i
+
+      if status >= 200 && status < 300
+        { ok: true, status: status }
+      else
+        { ok: false, error: "S3 upload failed: HTTP #{status}", status: status }
+      end
+    rescue StandardError => e
+      { ok: false, error: "Upload failed: #{e.message}", status: 0 }
+    end
+
     private
 
     def get(path, params = {})
@@ -227,6 +313,12 @@ module Fp
       execute(uri, request)
     end
 
+    def delete(path)
+      uri = build_uri(path)
+      request = Net::HTTP::Delete.new(uri)
+      execute(uri, request)
+    end
+
     def build_uri(path, params = {})
       uri = URI.parse("#{@base_url}#{path}")
       uri.query = URI.encode_www_form(params) unless params.empty?

data/lib/fp/commands/attach.rb

@@ -0,0 +1,190 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Fp
+  module Commands
+    # Upload, list, and manage attachments on requirements.
+    #
+    # Usage:
+    #   fp attach <slug> <file>       Upload a file to a requirement
+    #   fp attachments <slug>         List attachments for a requirement
+    #   fp attachment <slug> <id>     Get download URL for an attachment
+    #   fp attachment rm <slug> <id>  Delete an attachment
+    class Attach < Base
+      # Allowed content types and their file extensions
+      CONTENT_TYPES = {
+        'png' => 'image/png',
+        'jpg' => 'image/jpeg',
+        'jpeg' => 'image/jpeg',
+        'gif' => 'image/gif',
+        'webp' => 'image/webp',
+        'svg' => 'image/svg+xml',
+        'pdf' => 'application/pdf',
+        'txt' => 'text/plain',
+        'md' => 'text/markdown'
+      }.freeze
+
+      MAX_FILE_SIZE = 10 * 1024 * 1024 # 10 MB
+
+      def run(args)
+        case args[0]
+        when 'rm', 'delete'
+          delete_attachment(args[1..])
+        else
+          upload_attachment(args)
+        end
+      end
+
+      private
+
+      def upload_attachment(args)
+        slug = args[0]
+        file_path = args[1]
+
+        if slug.nil? || slug.empty?
+          Output.error('Missing requirement slug. Usage: fp attach <slug> <file>')
+          return 1
+        end
+
+        if file_path.nil? || file_path.empty?
+          Output.error('Missing file path. Usage: fp attach <slug> <file>')
+          return 1
+        end
+
+        unless File.exist?(file_path)
+          Output.error("File not found: #{file_path}")
+          return 1
+        end
+
+        project_id = require_project_id!
+        return 1 unless project_id
+
+        # Validate file
+        filename = File.basename(file_path)
+        ext = File.extname(filename).delete('.').downcase
+        content_type = CONTENT_TYPES[ext]
+
+        unless content_type
+          Output.error("Unsupported file type: .#{ext}")
+          Output.info("Allowed: #{CONTENT_TYPES.keys.join(', ')}")
+          return 1
+        end
+
+        file_size = File.size(file_path)
+        if file_size > MAX_FILE_SIZE
+          Output.error("File too large: #{format_size(file_size)} (max #{format_size(MAX_FILE_SIZE)})")
+          return 1
+        end
+
+        # Resolve requirement
+        result = client.find_requirement_by_slug(project_id, slug)
+        unless result[:ok]
+          Output.error(result[:error])
+          return 1
+        end
+
+        requirement = result[:data]['requirement']
+        requirement_id = requirement['id']
+
+        # Step 1: Get presigned URL
+        Output.info("Requesting upload URL for #{filename}...")
+        presign_result = client.presign_attachment(
+          requirement_id,
+          filename: filename,
+          content_type: content_type,
+          size_bytes: file_size
+        )
+
+        unless presign_result[:ok]
+          Output.error("Failed to get upload URL: #{presign_result[:error]}")
+          return 1
+        end
+
+        presign_data = presign_result[:data]['presign']
+        upload_url = presign_data['upload_url']
+        attachment_id = presign_data['attachment_id']
+        s3_key = presign_data['s3_key']
+
+        # Step 2: Upload to S3
+        Output.info("Uploading #{filename} (#{format_size(file_size)})...")
+        upload_result = client.upload_to_presigned_url(upload_url, file_path, content_type)
+
+        unless upload_result[:ok]
+          Output.error("Upload failed: #{upload_result[:error]}")
+          return 1
+        end
+
+        # Step 3: Confirm upload
+        Output.info('Confirming upload...')
+        create_result = client.create_attachment(
+          requirement_id,
+          attachment_id: attachment_id,
+          s3_key: s3_key,
+          filename: filename,
+          content_type: content_type,
+          size_bytes: file_size
+        )
+
+        unless create_result[:ok]
+          Output.error("Failed to confirm upload: #{create_result[:error]}")
+          return 1
+        end
+
+        attachment = create_result[:data]['attachment']
+        Output.success("Uploaded #{filename} to requirement '#{slug}'")
+        Output.info("  ID: #{attachment['id']}")
+        0
+      end
+
+      def delete_attachment(args)
+        slug = args[0]
+        attachment_id = args[1]
+
+        if slug.nil? || slug.empty?
+          Output.error('Missing requirement slug. Usage: fp attachment rm <slug> <id>')
+          return 1
+        end
+
+        if attachment_id.nil? || attachment_id.empty?
+          Output.error('Missing attachment ID. Usage: fp attachment rm <slug> <id>')
+          return 1
+        end
+
+        project_id = require_project_id!
+        return 1 unless project_id
+
+        # Resolve requirement
+        result = client.find_requirement_by_slug(project_id, slug)
+        unless result[:ok]
+          Output.error(result[:error])
+          return 1
+        end
+
+        requirement = result[:data]['requirement']
+        requirement_id = requirement['id']
+
+        # Delete attachment
+        delete_result = client.delete_attachment(requirement_id, attachment_id)
+
+        unless delete_result[:ok]
+          Output.error("Failed to delete attachment: #{delete_result[:error]}")
+          return 1
+        end
+
+        Output.success("Deleted attachment #{attachment_id}")
+        0
+      end
+
+      def format_size(bytes)
+        if bytes >= 1024 * 1024
+          format('%.1f MB', bytes.to_f / (1024 * 1024))
+        elsif bytes >= 1024
+          format('%.1f KB', bytes.to_f / 1024)
+        else
+          "#{bytes} bytes"
+        end
+      end
+    end
+  end
+end

data/lib/fp/commands/attachments.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+require_relative 'base'
+
+module Fp
+  module Commands
+    # List attachments for a requirement, or get a download URL for one.
+    #
+    # Usage:
+    #   fp attachments <slug>         List attachments for a requirement
+    #   fp attachments <slug> <id>    Get download URL for an attachment
+    class Attachments < Base
+      def run(args)
+        slug = args[0]
+        attachment_id = args[1]
+
+        if slug.nil? || slug.empty?
+          Output.error('Missing requirement slug. Usage: fp attachments <slug> [<id>]')
+          return 1
+        end
+
+        project_id = require_project_id!
+        return 1 unless project_id
+
+        # Resolve requirement
+        result = client.find_requirement_by_slug(project_id, slug)
+        unless result[:ok]
+          Output.error(result[:error])
+          return 1
+        end
+
+        requirement = result[:data]['requirement']
+        requirement_id = requirement['id']
+
+        if attachment_id
+          show_attachment(requirement_id, attachment_id, slug)
+        else
+          list_attachments(requirement_id, slug)
+        end
+      end
+
+      private
+
+      def list_attachments(requirement_id, slug)
+        result = client.list_attachments(requirement_id)
+
+        unless result[:ok]
+          Output.error(result[:error])
+          return 1
+        end
+
+        attachments = result[:data]['attachments'] || []
+
+        if json_output?
+          Output.json({ attachments: attachments })
+          return 0
+        end
+
+        if attachments.empty?
+          Output.info("No attachments for requirement '#{slug}'")
+          return 0
+        end
+
+        Output.info("Attachments for '#{slug}':\n")
+        attachments.each do |att|
+          puts "  #{att['id']}"
+          puts "    Filename: #{att['filename']}"
+          puts "    Type: #{att['content_type']}"
+          puts "    Size: #{format_size(att['size_bytes'])}"
+          puts "    Uploaded by: #{att['uploaded_by']}"
+          puts "    Uploaded at: #{att['created_at']}"
+          puts
+        end
+
+        0
+      end
+
+      def show_attachment(requirement_id, attachment_id, slug)
+        result = client.get_attachment(requirement_id, attachment_id)
+
+        unless result[:ok]
+          Output.error(result[:error])
+          return 1
+        end
+
+        data = result[:data]['attachment_response'] || result[:data]
+        attachment = data['attachment']
+        download_url = data['download_url']
+        expires_in = data['expires_in']
+
+        if json_output?
+          Output.json(data)
+          return 0
+        end
+
+        Output.info("Attachment: #{attachment['filename']}")
+        puts "  ID: #{attachment['id']}"
+        puts "  Type: #{attachment['content_type']}"
+        puts "  Size: #{format_size(attachment['size_bytes'])}"
+        puts "  Uploaded by: #{attachment['uploaded_by']}"
+        puts "  Uploaded at: #{attachment['created_at']}"
+        puts
+        puts "Download URL (expires in #{expires_in / 60} minutes):"
+        puts download_url
+
+        0
+      end
+
+      def format_size(bytes)
+        return '0 bytes' if bytes.nil? || bytes.zero?
+
+        if bytes >= 1024 * 1024
+          format('%.1f MB', bytes.to_f / (1024 * 1024))
+        elsif bytes >= 1024
+          format('%.1f KB', bytes.to_f / 1024)
+        else
+          "#{bytes} bytes"
+        end
+      end
+    end
+  end
+end