exploremyprofile 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fbb95d414e36bede8a58108431a36c0a439a4bb56e92afbf6a62f866021a5a74
+  data.tar.gz: 3e5a41439c7d2e4cb7e640d632aa178731b4dd5ac9a19e872b1aec44982b6cad
+SHA512:
+  metadata.gz: 7a46d662af6e8926a4d591ed975a748b9c34bc81c3b8567f1a77b274b085d79bb8b4f7555d7ccfa5dc58449884dd6a8b402a90f5aee5b16a546335af506102cc
+  data.tar.gz: e552159bd69ebc39cb17a99c83b2be30fd231ac82fd1cc96f953d3adc742928d158d469da83d328bb4f30699a4365ce2081f08b9ad8bfea6e70a03ffc46d3ca4

data/exe/explore

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+
+require "explore"
+
+exit Explore::CLI::Runner.new(
+  argv: ARGV,
+  env: ENV,
+  stdout: $stdout,
+  stderr: $stderr
+).call

data/lib/explore/cli.rb

@@ -0,0 +1,349 @@
+require "json"
+require "net/http"
+require "optparse"
+require "uri"
+
+module Explore
+  module Cli
+    class Error < StandardError
+      attr_reader :exit_code
+
+      def initialize(message, exit_code: 1)
+        super(message)
+        @exit_code = exit_code
+      end
+    end
+
+    class Client
+      OWNER_ONLY_PATH_PREFIXES = [
+        "/api/agent/v1/drafts",
+        "/api/agent/v1/onboarding/status",
+        "/api/agent/v1/manifest/next_actions",
+        "/api/agent/v1/notion/sync_status",
+        "/api/agent/v1/publish/preview",
+        "/api/agent/v1/content/create_draft",
+        "/api/agent/v1/content/propose_update"
+      ].freeze
+
+      def initialize(base_url:, api_key: nil)
+        @base_url = base_url
+        @api_key = api_key
+      end
+
+      def get(path, params: {})
+        request(Net::HTTP::Get, path, params:)
+      end
+
+      def post(path, params: {}, json: nil)
+        request(Net::HTTP::Post, path, params:, json:)
+      end
+
+      def patch(path, params: {}, json: nil)
+        request(Net::HTTP::Patch, path, params:, json:)
+      end
+
+      private
+
+      attr_reader :base_url, :api_key
+
+      def request(klass, path, params:, json: nil)
+        uri = URI.join(base_url, path)
+        uri.query = URI.encode_www_form(params.compact) if params.compact.any?
+
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = uri.scheme == "https"
+
+        request = klass.new(uri)
+        request["Accept"] = "application/json"
+        request["Content-Type"] = "application/json" if json
+        request["X-API-Key"] = api_key if api_key.to_s != ""
+        request.body = JSON.generate(json) if json
+
+        response = http.request(request)
+        parsed = response.body.to_s.empty? ? {} : JSON.parse(response.body)
+        return parsed if response.code.to_i.between?(200, 299)
+
+        message = error_message_for(response:, parsed:, path:)
+        raise Error.new(message, exit_code: 1)
+      end
+
+      def error_message_for(response:, parsed:, path:)
+        return owner_only_unauthorized_message if response.code.to_i == 401 && owner_only_path?(path)
+
+        parsed.dig("error", "message") || "Request failed"
+      end
+
+      def owner_only_path?(path)
+        OWNER_ONLY_PATH_PREFIXES.any? { |prefix| path.start_with?(prefix) }
+      end
+
+      def owner_only_unauthorized_message
+        "Unauthorized: this is an owner-only command. Use a signed-in session or pass EXPLORE_API_KEY/--api-key. " \
+          "The key is app-level, not account-specific, and lives in Rails credentials at api.v1_key."
+      end
+    end
+
+    class Runner
+      DEFAULT_BASE_URL = "http://127.0.0.1:3000".freeze
+
+      def initialize(argv:, env:, stdout:, stderr:, client_class: Client)
+        @argv = argv.dup
+        @env = env
+        @stdout = stdout
+        @stderr = stderr
+        @client_class = client_class
+      end
+
+      def call
+        command = argv.shift
+        return emit_version if version_flag?(command)
+        raise Error.new(usage, exit_code: 2) if blank_value?(command)
+
+        case command
+        when "version"
+          emit_version
+        when "whoami"
+          options = parse_options(argv, require_input: false)
+          response = client(options).get("/api/agent/v1/profile", params: scope_params(options))
+          emit(output_for_whoami(response, options))
+        when "profile"
+          execute_read(argv.shift, "/api/agent/v1/profile")
+        when "content"
+          subcommand = argv.shift
+          return execute_read(subcommand, "/api/agent/v1/content") if subcommand == "list"
+          return execute_create_draft if subcommand == "create-draft"
+          return execute_propose_update if subcommand == "propose-update"
+          raise Error.new(usage, exit_code: 2)
+        when "drafts"
+          subcommand = argv.shift
+          return execute_read(subcommand, "/api/agent/v1/drafts") if subcommand == "list"
+          return execute_draft_inspect if subcommand == "inspect"
+          return execute_draft_apply if subcommand == "apply"
+          return execute_draft_apply_preview if subcommand == "apply-preview"
+          return execute_draft_update if subcommand == "update"
+          return execute_draft_archive if subcommand == "archive"
+          raise Error.new(usage, exit_code: 2)
+        when "onboarding"
+          execute_read(argv.shift, "/api/agent/v1/onboarding/status")
+        when "manifest"
+          execute_read(argv.shift, "/api/agent/v1/manifest/next_actions")
+        when "notion"
+          execute_read(argv.shift, "/api/agent/v1/notion/sync_status")
+        when "publish"
+          execute_read(argv.shift, "/api/agent/v1/publish/preview")
+        else
+          raise Error.new(usage, exit_code: 2)
+        end
+
+        0
+      rescue Error => e
+        stderr.puts(e.message)
+        e.exit_code
+      end
+
+      private
+
+      attr_reader :argv, :env, :stdout, :stderr, :client_class
+
+      def execute_read(subcommand, path)
+        expected = {
+          "/api/agent/v1/profile" => "inspect",
+          "/api/agent/v1/onboarding/status" => "status",
+          "/api/agent/v1/manifest/next_actions" => "next-actions",
+          "/api/agent/v1/notion/sync_status" => "sync-status",
+          "/api/agent/v1/publish/preview" => "preview",
+          "/api/agent/v1/content" => "list",
+          "/api/agent/v1/drafts" => "list"
+        }.fetch(path)
+        raise Error.new(usage, exit_code: 2) unless subcommand == expected
+
+        options = parse_options(argv, require_input: false)
+        response = client(options).get(path, params: scope_params(options))
+        emit(format_output(response, options))
+        0
+      end
+
+      def execute_propose_update
+        options = parse_options(argv, require_input: true)
+        input_path = options.fetch(:input)
+        payload = JSON.parse(File.read(input_path))
+        response = client(options).post(
+          "/api/agent/v1/content/propose_update",
+          params: scope_params(options),
+          json: payload
+        )
+        emit(format_output(response, options))
+        0
+      end
+
+      def execute_create_draft
+        options = parse_options(argv, require_input: true)
+        input_path = options.fetch(:input)
+        payload = JSON.parse(File.read(input_path))
+        response = client(options).post(
+          "/api/agent/v1/content/create_draft",
+          params: scope_params(options),
+          json: payload
+        )
+        emit(format_output(response, options))
+        0
+      end
+
+      def execute_draft_inspect
+        options = parse_options(argv, require_input: false, require_draft_id: true)
+        response = client(options).get(
+          "/api/agent/v1/drafts/#{options.fetch(:draft_id)}",
+          params: scope_params(options)
+        )
+        emit(format_output(response, options))
+        0
+      end
+
+      def execute_draft_archive
+        options = parse_options(argv, require_input: false, require_draft_id: true)
+        response = client(options).post(
+          "/api/agent/v1/drafts/#{options.fetch(:draft_id)}/archive",
+          params: scope_params(options)
+        )
+        emit(format_output(response, options))
+        0
+      end
+
+      def execute_draft_apply
+        options = parse_options(argv, require_input: false, require_draft_id: true)
+        response = client(options).post(
+          "/api/agent/v1/drafts/#{options.fetch(:draft_id)}/apply",
+          params: scope_params(options)
+        )
+        emit(format_output(response, options))
+        0
+      end
+
+      def execute_draft_apply_preview
+        options = parse_options(argv, require_input: false, require_draft_id: true)
+        response = client(options).get(
+          "/api/agent/v1/drafts/#{options.fetch(:draft_id)}/apply_preview",
+          params: scope_params(options)
+        )
+        emit(format_output(response, options))
+        0
+      end
+
+      def execute_draft_update
+        options = parse_options(argv, require_input: true, require_draft_id: true)
+        payload = JSON.parse(File.read(options.fetch(:input)))
+        response = client(options).patch(
+          "/api/agent/v1/drafts/#{options.fetch(:draft_id)}",
+          params: scope_params(options),
+          json: payload
+        )
+        emit(format_output(response, options))
+        0
+      end
+
+      def parse_options(arguments, require_input:, require_draft_id: false)
+        options = {
+          base_url: env.fetch("EXPLORE_BASE_URL", DEFAULT_BASE_URL),
+          api_key: env["EXPLORE_API_KEY"],
+          account: env["EXPLORE_ACCOUNT"],
+          slug: env["EXPLORE_SLUG"],
+          json: false
+        }
+
+        parser = OptionParser.new do |opts|
+          opts.on("--base-url URL") { |value| options[:base_url] = value }
+          opts.on("--api-key TOKEN") { |value| options[:api_key] = value }
+          opts.on("--account ACCOUNT") { |value| options[:account] = value }
+          opts.on("--slug SLUG") { |value| options[:slug] = value }
+          opts.on("--draft ID") { |value| options[:draft_id] = value }
+          opts.on("--input PATH") { |value| options[:input] = value }
+          opts.on("--json") { options[:json] = true }
+        end
+
+        parser.parse!(arguments)
+        raise Error.new("Missing --input", exit_code: 2) if require_input && blank_value?(options[:input])
+        raise Error.new("Missing --draft", exit_code: 2) if require_draft_id && blank_value?(options[:draft_id])
+
+        options
+      end
+
+      def client(options)
+        client_class.new(base_url: options.fetch(:base_url), api_key: options[:api_key])
+      end
+
+      def scope_params(options)
+        if present_value?(options[:slug])
+          { slug: options[:slug] }
+        elsif options[:account].to_s.match?(/\A\d+\z/)
+          { account_id: options[:account] }
+        elsif present_value?(options[:account])
+          { account: options[:account] }
+        else
+          {}
+        end
+      end
+
+      def format_output(response, options)
+        return JSON.pretty_generate(response) if options[:json]
+
+        JSON.pretty_generate(response)
+      end
+
+      def output_for_whoami(response, options)
+        return JSON.pretty_generate(response) if options[:json]
+
+        [
+          "Account: #{response.dig("profile", "name")}",
+          "Slug: #{response["account_slug"]}",
+          "Context: #{response.dig("context", "mode")}",
+          "Profile: #{response.dig("profile", "public_url")}"
+        ].join("\n")
+      end
+
+      def emit(message)
+        stdout.puts(message)
+      end
+
+      def emit_version
+        stdout.puts(Explore::VERSION)
+        0
+      end
+
+      def blank_value?(value)
+        value.nil? || value.respond_to?(:empty?) && value.empty?
+      end
+
+      def present_value?(value)
+        !blank_value?(value)
+      end
+
+      def version_flag?(value)
+        %w[--version -v].include?(value)
+      end
+
+      def usage
+        <<~TEXT
+          Usage:
+            explore version
+            explore whoami [--account <id-or-slug>] [--slug <slug>] [--json]
+            explore profile inspect [--account <id-or-slug>] [--slug <slug>] [--json]
+            explore content list [--account <id-or-slug>] [--slug <slug>] [--json]
+            explore content create-draft --account <id-or-slug> --input <file.json> [--json]
+            explore drafts list --account <id-or-slug> [--json]
+            explore drafts inspect --account <id-or-slug> --draft <id> [--json]
+            explore drafts apply --account <id-or-slug> --draft <id> [--json]
+            explore drafts apply-preview --account <id-or-slug> --draft <id> [--json]
+            explore drafts update --account <id-or-slug> --draft <id> --input <file.json> [--json]
+            explore drafts archive --account <id-or-slug> --draft <id> [--json]
+            explore onboarding status [--account <id-or-slug>] [--json]
+            explore manifest next-actions [--account <id-or-slug>] [--json]
+            explore notion sync-status [--account <id-or-slug>] [--json]
+            explore publish preview [--account <id-or-slug>] [--json]
+            explore content propose-update --account <id-or-slug> --input <file.json> [--json]
+        TEXT
+      end
+    end
+  end
+
+  CLI = Cli
+end

data/lib/explore/version.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Explore
+  module Version
+    STRING = "0.1.0"
+  end
+
+  VERSION = Version::STRING
+end

data/lib/explore.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "explore/version"
+require_relative "explore/cli"

metadata

@@ -0,0 +1,50 @@
+--- !ruby/object:Gem::Specification
+name: exploremyprofile
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Johnny Butler
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Explore provides a terminal-friendly CLI for public-safe profile inspection
+  and owner draft workflows.
+email:
+- johnnybutler@example.com
+executables:
+- explore
+extensions: []
+extra_rdoc_files: []
+files:
+- exe/explore
+- lib/explore.rb
+- lib/explore/cli.rb
+- lib/explore/version.rb
+homepage: https://exploremyprofile.com/agent-setup
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://exploremyprofile.com/agent-setup
+  documentation_uri: https://exploremyprofile.com/agents
+  source_code_uri: https://github.com/johnnybutler7/johnnybutler-com
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Terminal CLI for the Explore agent API
+test_files: []