agentilda 1.0.3

data/lib/dry/cli/banner.rb

@@ -0,0 +1,293 @@
+# frozen_string_literal: true
+
+require "dry/cli/program_name"
+require "pastel"
+
+module Dry
+  class CLI
+    # Utility module for wrapping text to a given width
+    module WordWrap
+      def wrap_description(text, width: 55, prefix: "  ")
+        text.split("\n", -1).map { |para|
+          para.scan(/\S.{0,#{width - 1}}(?=\s|\z)|\S{#{width},}/).join("\n#{prefix}")
+        }.join("\n")
+      end
+
+      alias_method :wrap, :wrap_description
+    end
+
+    # The command list `agentilda -h` prints.
+    #
+    # Upstream renders a description on one line however long it is, so a
+    # long `desc` runs off the terminal and a two-line one drops its second
+    # line to column zero. Descriptions are wrapped here instead, hung under
+    # the `#` the way {Banner} already hangs an option's.
+    module Usage
+      extend WordWrap
+
+      # Narrowest description column worth wrapping to. Below this the
+      # hanging indent leaves no room for words.
+      MIN_DESCRIPTION_WIDTH = 24
+
+      # @param result [Dry::CLI::CommandRegistry::LookupResult]
+      # @return [String]
+      def self.call(result)
+        max_length, commands = commands_and_arguments(result)
+        column = max_length + max_length / 2
+
+        by_depth(commands).filter_map { |banner, node|
+          next if node.hidden
+
+          usage = description(node.command, column) if node.leaf?
+          "#{justify(banner, max_length, usage)}#{usage}"
+        }.unshift("Commands:").join("\n")
+      end
+
+      # A command that owns subcommands is the heading for a whole area of the
+      # tool, so it belongs above the flat commands rather than filed
+      # alphabetically among them. Alphabetical order is kept inside each group.
+      #
+      # `children?` is the direct question, `children.any?`. `leaf?` asks
+      # something else — whether the node carries a runnable command — and the
+      # two are independent: a command that also takes subcommands is both, and
+      # sorting on `leaf?` would file it with the flat commands.
+      #
+      # @param commands [Hash{String => Dry::CLI::CommandRegistry::Node}]
+      # @return [Array<Array(String, Dry::CLI::CommandRegistry::Node)>]
+      def self.by_depth(commands)
+        commands.sort_by { |banner, node| [node.children? ? 0 : 1, banner] }
+      end
+
+      # @param command [Dry::CLI::Command]
+      # @param column [Integer] the width the banner is padded to; the `#`
+      #   sits one past it, so continuation lines do too
+      # @return [String, nil]
+      def self.description(command, column = 0)
+        return unless CLI.command?(command)
+        return if command.description.nil?
+
+        prefix = "#{" " * (column + 1)}# "
+        width = [86 - prefix.length, MIN_DESCRIPTION_WIDTH].max
+        text = command.description.gsub(/\s+/, " ").strip
+
+        " # #{wrap_description(text, width: width, prefix: prefix)}"
+      end
+    end
+
+    # Command banner
+    #
+    # @since 0.1.0
+    # @api private
+    module Banner
+      extend WordWrap
+
+      @color_enabled = true
+
+      module ColorMethods
+        @pastel = nil
+
+        COLOR_METHODS = %i[
+          yellow
+          green
+          red
+          blue
+          magenta
+          cyan
+          white
+          black
+          gray
+          bright_white
+          bright_black
+          bright_red
+          bright_green
+          bright_blue
+          bright_magenta
+          bright_cyan
+          bright_gray
+        ].freeze
+
+        # Pastel answers a colour two ways: `yellow("text")` decorates in one
+        # call, `yellow.bold("text")` returns a chain to decorate further. The
+        # colourless stand-in has to answer both shapes, so given text it hands
+        # the text straight back and given nothing it hands back itself.
+        DECORATIONS = %i[bold dim italic underline inverse strikethrough blink].freeze
+
+        class NoColorPastel
+          (COLOR_METHODS + DECORATIONS).each do |name|
+            define_method(name) { |*args| args.empty? ? self : args.join }
+          end
+        end
+
+        def pastel
+          @pastel ||= if Banner.color_enabled?
+            Pastel.new
+          else
+            NoColorPastel.new
+          end
+        end
+
+        extend Forwardable
+
+        def_delegators :pastel, *COLOR_METHODS
+      end
+
+      extend ColorMethods
+
+      def self.color_enabled?
+        @color_enabled
+      end
+
+      def self.enable_color!
+        @pastel = nil
+        @color_enabled = true
+      end
+
+      def self.disable_color!
+        @pastel = nil
+        @color_enabled = false
+      end
+
+      def self.color_header(string)
+        color_enabled? ? bright_blue.bold(string.upcase) : string.upcase
+      end
+
+      def self.color_command(string)
+        color_enabled? ? green.bold(string) : string
+      end
+
+      def self.color_arguments(string)
+        color_enabled? ? yellow.italic(string) : string
+      end
+
+      # Prints command banner
+      #
+      # @param command [Dry::CLI::Command] the command
+      # @param out [IO] standard output
+      #
+      # @since 0.1.0
+      # @api private
+      def self.call(command, name)
+        [
+          command_name(name),
+          command_name_and_arguments(command, name),
+          command_description(command),
+          command_subcommands(command),
+          command_arguments(command),
+          command_options(command),
+          command_examples(command, name)
+        ].compact.join("\n")
+      end
+
+      # @since 0.1.0
+      # @api private
+      def self.command_name(name)
+        color_header("Command:\n") + "  #{yellow(name)}"
+      end
+
+      # @since 0.1.0
+      # @api private
+      def self.command_name_and_arguments(command, name)
+        usage = "\n#{color_header("Usage")}:\n  #{color_command(name)}#{color_arguments(arguments(command))}"
+
+        return usage + " | #{name} SUBCOMMAND" if command.subcommands.any?
+
+        usage
+      end
+
+      # @since 0.1.0
+      # @api private
+      def self.command_examples(command, name)
+        return if command.examples.empty?
+
+        "\n#{color_header("Examples")}:\n" + command.examples.map do |example|
+          args, desc = example.split("#")
+          comment_line = (desc.nil? || desc.empty?) ? "" : "  #{bright_black("##{desc}")}\n"
+          comment_line + "  #{color_command(name)} #{color_arguments(args)}"
+        end.join("\n\n")
+      end
+
+      # @since 0.1.0
+      # @api private
+      def self.command_description(command)
+        return if command.description.nil?
+
+        "\n#{color_header("Description")}:\n  #{command.description}"
+      end
+
+      def self.command_subcommands(command)
+        return if command.subcommands.empty?
+
+        "\n#{color_header("Subcommands")}:\n#{build_subcommands_list(command.subcommands)}"
+      end
+
+      # @since 0.1.0
+      # @api private
+      def self.command_arguments(command)
+        return if command.arguments.empty?
+
+        "\n#{color_header("Arguments")}:\n#{extended_command_arguments(command)}"
+      end
+
+      # @since 0.1.0
+      # @api private
+      def self.command_options(command)
+        "\n#{color_header("Options")}:\n#{extended_command_options(command)}"
+      end
+
+      # @since 0.1.0
+      # @api private
+      def self.arguments(command)
+        required_arguments = command.required_arguments
+        optional_arguments = command.optional_arguments
+
+        required = required_arguments.map { |arg| arg.name.upcase }.join(" ") if required_arguments.any?
+        optional = optional_arguments.map { |arg| "[#{arg.name.upcase}]" }.join(" ") if optional_arguments.any?
+        result = [required, optional].compact
+
+        " #{result.join(" ")}" unless result.empty?
+      end
+
+      DESCRIPTION_START = 25
+
+      # @since 0.1.0
+      # @api private
+      def self.extended_command_arguments(command)
+        command.arguments.map do |argument|
+          "    #{argument.name.to_s.upcase.ljust(DESCRIPTION_START)}  # #{"REQUIRED " if argument.required?}#{wrap_description(argument.desc, prefix: " " * 31 + "# ")}"
+        end.join("\n")
+      end
+
+      # @since 0.1.0
+      # @api private
+      #
+      def self.extended_command_options(command)
+        result = command.options.map do |option|
+          name = Inflector.dasherize(option.name)
+          name = if option.boolean?
+            "[no-]#{name}"
+          elsif option.flag?
+            name
+          elsif option.array?
+            "#{name}=VALUE1,VALUE2,.."
+          else
+            "#{name}=VALUE"
+          end
+          name = "#{name}, #{option.alias_names.join(", ")}" if option.aliases.any?
+          name = "  --#{name.ljust(DESCRIPTION_START)}"
+          name = "#{name}  # #{wrap_description(option.desc, prefix: " " * 31 + "# ")}"
+          name = "#{name}, default: #{option.default.inspect}" unless option.default.nil?
+          name
+        end
+
+        result << "  --#{"help, -h".ljust(DESCRIPTION_START)}  # Print this help"
+        result.join("\n")
+      end
+
+      def self.build_subcommands_list(subcommands)
+        subcommands.map do |subcommand_name, subcommand|
+          "  #{yellow(subcommand_name.ljust(12))}  # #{red(wrap_description(subcommand.command.description))}`"
+        end.join("\n")
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,349 @@
+--- !ruby/object:Gem::Specification
+name: agentilda
+version: !ruby/object:Gem::Version
+  version: 1.0.3
+platform: ruby
+authors:
+- Konstantin Gredeskoul
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: aasm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dry-cli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dry-cli-autocomplete
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dry-inflector
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: dry-monads
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fuzzy-string-match
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: parallel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pastel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: strings
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-box
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-command
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-progressbar
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-screen
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: tty-spinner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: unicode-display_width
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |
+  Keeps a project's specifications, plans and pull requests joined up, and
+  drives specialist agents over them in parallel. A feature's state is its
+  folder name under .plans, so a transition renames a directory rather than
+  updating a row, and nothing can claim a phase whose document is missing.
+email:
+- kigster@gmail.com
+executables:
+- agentilda
+- tilda
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- agentilda.gemspec
+- agents/hansolo-reviewer.md
+- agents/lando-broker.md
+- agents/leah-researcher.md
+- agents/luke-backend.md
+- agents/palpatine-planner.md
+- agents/rey-frontend.md
+- agents/yoda-writer.md
+- bin/create-plan-folder
+- bin/plan-number
+- exe/agentilda
+- exe/tilda
+- lib/agentilda.rb
+- lib/agentilda/adoption.rb
+- lib/agentilda/agent.rb
+- lib/agentilda/brief.rb
+- lib/agentilda/cli.rb
+- lib/agentilda/cli/agents/subcommands/describe.rb
+- lib/agentilda/cli/agents/subcommands/list.rb
+- lib/agentilda/cli/base.rb
+- lib/agentilda/cli/create/create.rb
+- lib/agentilda/cli/docs/docs.rb
+- lib/agentilda/cli/index/index.rb
+- lib/agentilda/cli/linear/linear.rb
+- lib/agentilda/cli/linear/subcommands/import.rb
+- lib/agentilda/cli/linear/subcommands/projects.rb
+- lib/agentilda/cli/list_plans/list_plans.rb
+- lib/agentilda/cli/resync/subcommands/dirs.rb
+- lib/agentilda/cli/resync/subcommands/prs.rb
+- lib/agentilda/cli/run/run.rb
+- lib/agentilda/cli/states/states.rb
+- lib/agentilda/cli/unblock/unblock.rb
+- lib/agentilda/cli/version/version.rb
+- lib/agentilda/config.rb
+- lib/agentilda/control.rb
+- lib/agentilda/creator.rb
+- lib/agentilda/dev_work.rb
+- lib/agentilda/diagram.rb
+- lib/agentilda/documentation.rb
+- lib/agentilda/executor.rb
+- lib/agentilda/feature.rb
+- lib/agentilda/frontmatter.rb
+- lib/agentilda/github.rb
+- lib/agentilda/index.rb
+- lib/agentilda/keyboard.rb
+- lib/agentilda/linear.rb
+- lib/agentilda/linear/api.rb
+- lib/agentilda/linear/attribution.rb
+- lib/agentilda/linear/fuzzy.rb
+- lib/agentilda/linear/import.rb
+- lib/agentilda/linear/issue.rb
+- lib/agentilda/linear/mapping.rb
+- lib/agentilda/linear/push.rb
+- lib/agentilda/linear/survey.rb
+- lib/agentilda/linear/unit.rb
+- lib/agentilda/markdown.rb
+- lib/agentilda/ordinal.rb
+- lib/agentilda/progress_log.rb
+- lib/agentilda/publisher.rb
+- lib/agentilda/pull_request.rb
+- lib/agentilda/reporter.rb
+- lib/agentilda/resync.rb
+- lib/agentilda/roster.rb
+- lib/agentilda/runner.rb
+- lib/agentilda/state_machine.rb
+- lib/agentilda/status.rb
+- lib/agentilda/tally.rb
+- lib/agentilda/transcript.rb
+- lib/agentilda/tree.rb
+- lib/agentilda/ui.rb
+- lib/agentilda/unblocker.rb
+- lib/agentilda/version.rb
+- lib/agentilda/viewer.rb
+- lib/agentilda/worktree.rb
+- lib/dry/cli/banner.rb
+homepage: https://github.com/kigster/agentilda
+licenses: []
+metadata:
+  homepage_uri: https://github.com/kigster/agentilda
+  source_code_uri: https://github.com/kigster/agentilda
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '4.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.19
+specification_version: 4
+summary: 'Agentic specification-driven development: spec, plan, build, review'
+test_files: []