schwarm-cli 0.1.3 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5ad711fe3997e1d3b3c18cee54f6621ecc3d895f01f7c09916e5bb1f217ea6c4
-  data.tar.gz: 3c0b5c575b1ee49423a547eeadc5a7310109e5ff294f718ee0e3cbd016f25dda
+  metadata.gz: f86723cf9675bb0de813b11efa16be17bd2b8bfa74bd9af1203130cdf7fda0f0
+  data.tar.gz: 479a9e83426d1fb675b79dd5780b14264d7a6c8454ee30404c104743aed30fdd
 SHA512:
-  metadata.gz: a1650f63cca311d44de2f6c6b351a4bb1f81958ec5ce3093ac0a6745f5f1104ae632bcb38386bac177dd03e1274052bb47dd7967f2a0a689de1b9e28dd8227eb
-  data.tar.gz: b5696799424c27eb8a7808ff225a461e1573e28ffb4cb2261ecd541687344293e5f115fa743605273b612db9639c61ba1eb1ee70113deaca8f9e5dd26b70dc5d
+  metadata.gz: 9e473284f4c066af2f5ed3a77cc365448574acd73a55e1f72e5d2eb94d1b11db5a95fc4fdaf23c498ecb721ef0f2f596ff753c1c869726446a66d6ae622cf167
+  data.tar.gz: b3d2498b0dcea13e9ed75ea1ee865fdf25658a31a5552059cfb617efcead48600f46008fbd4f580766250daa6b99f38619412a4c4cfa32175f6736b7f45e7c3e

data/lib/schwarm_cli/commands/agents.rb

@@ -4,13 +4,13 @@ module SchwarmCli
   module Commands
     class Agents < Base
       desc "list", "List repository agents"
-      option :repo, type: :string, desc: "Filter by repository ID"
+      option :repo, type: :string, desc: "Filter by repository ID, owner/repo, or GitHub URL"
       option :query, type: :string, desc: "Search by name"
       pagination_options
       def list
         handle_errors do
           data = fetch_paged do |page_params|
-            client.agents.list(repository_id: options[:repo], query: options[:query], **page_params)
+            client.agents.list(repository_id: resolve_repo(options[:repo]), query: options[:query], **page_params)
           end
           output_list(data, columns: [%w[ID id], %w[NAME name], %w[REPO github_repository_name],
                                       %w[ENABLED enabled], %w[SCHEDULE schedule]])
@@ -31,15 +31,12 @@ module SchwarmCli
 
       desc "create", "Create a repository agent"
       option :name, type: :string, required: true, desc: "Agent name"
-      option :repo, type: :string, required: true, desc: "Repository ID"
+      option :repo, type: :string, required: true, desc: "Repository ID, owner/repo, or GitHub URL"
       option :prompt, type: :string, required: true, desc: "Agent prompt"
       option :schedule, type: :string, desc: "Cron schedule"
       def create
         handle_errors do
-          attrs = { name: options[:name], github_repository_id: options[:repo], prompt: options[:prompt] }
-          attrs[:schedule] = options[:schedule] if options[:schedule]
-
-          data = client.agents.create(**attrs)
+          data = client.agents.create(**create_attrs)
           output_record(data, fields: { "ID" => "id", "Name" => "name", "Enabled" => "enabled" })
         end
       end
@@ -83,6 +80,15 @@ module SchwarmCli
 
       private
 
+      def create_attrs
+        attrs = {
+          name: options[:name], github_repository_id: resolve_repo(options[:repo]),
+          prompt: options[:prompt]
+        }
+        attrs[:schedule] = options[:schedule] if options[:schedule]
+        attrs
+      end
+
       def update_attrs
         {}.tap do |attrs|
           attrs[:name] = options[:name] if options[:name]

data/lib/schwarm_cli/commands/base.rb

@@ -25,6 +25,13 @@ module SchwarmCli
         @client ||= SchwarmCli::Client.new(url: options[:url], api_key: options[:token])
       end
 
+      # Resolves --repo input (ID, owner/repo, or GitHub URL) to a schwarm repo ID.
+      def resolve_repo(ref)
+        SchwarmCli::RepositoryResolver.new(client: client).resolve(ref)
+      rescue SchwarmCli::RepositoryResolver::ResolutionError => e
+        abort "Error: #{e.message}"
+      end
+
       def output_list(data, columns:)
         if options[:json]
           Formatters::Json.format(data)

data/lib/schwarm_cli/commands/recurring.rb

@@ -4,13 +4,13 @@ module SchwarmCli
   module Commands
     class Recurring < Base
       desc "list", "List recurring tasks"
-      option :repo, type: :string, desc: "Filter by repository ID"
+      option :repo, type: :string, desc: "Filter by repository ID, owner/repo, or GitHub URL"
       option :query, type: :string, desc: "Search by name"
       pagination_options
       def list
         handle_errors do
           data = fetch_paged do |page_params|
-            client.recurring.list(repository_id: options[:repo], query: options[:query], **page_params)
+            client.recurring.list(repository_id: resolve_repo(options[:repo]), query: options[:query], **page_params)
           end
           output_list(data, columns: [%w[ID id], %w[NAME name], %w[REPO github_repository_name],
                                       %w[ENABLED enabled], %w[SCHEDULE schedule]])
@@ -31,13 +31,13 @@ module SchwarmCli
 
       desc "create", "Create a recurring task"
       option :name, type: :string, required: true, desc: "Task name"
-      option :repo, type: :string, required: true, desc: "Repository ID"
+      option :repo, type: :string, required: true, desc: "Repository ID, owner/repo, or GitHub URL"
       option :prompt, type: :string, required: true, desc: "Task prompt"
       option :schedule, type: :string, required: true, desc: "Cron schedule"
       def create
         handle_errors do
           attrs = {
-            name: options[:name], github_repository_id: options[:repo],
+            name: options[:name], github_repository_id: resolve_repo(options[:repo]),
             prompt: options[:prompt], schedule: options[:schedule]
           }
 

data/lib/schwarm_cli/commands/repo_skills.rb

@@ -4,13 +4,15 @@ module SchwarmCli
   module Commands
     class RepoSkills < Base
       desc "list", "List repository-skill associations"
-      option :repo, type: :string, desc: "Filter by repository ID"
+      option :repo, type: :string, desc: "Filter by repository ID, owner/repo, or GitHub URL"
       option :skill, type: :string, desc: "Filter by skill ID"
       pagination_options
       def list
         handle_errors do
           data = fetch_paged do |page_params|
-            client.repo_skills.list(repository_id: options[:repo], skill_id: options[:skill], **page_params)
+            client.repo_skills.list(
+              repository_id: resolve_repo(options[:repo]), skill_id: options[:skill], **page_params
+            )
           end
           output_list(data, columns: [%w[ID id], %w[REPO github_repository_name],
                                       %w[SKILL skill_name]])
@@ -29,12 +31,12 @@ module SchwarmCli
       end
 
       desc "create", "Associate a skill with a repository"
-      option :repo, type: :string, required: true, desc: "Repository ID"
+      option :repo, type: :string, required: true, desc: "Repository ID, owner/repo, or GitHub URL"
       option :skill, type: :string, required: true, desc: "Skill ID"
       def create
         handle_errors do
           data = client.repo_skills.create(
-            github_repository_id: options[:repo], skill_id: options[:skill]
+            github_repository_id: resolve_repo(options[:repo]), skill_id: options[:skill]
           )
           output_record(data, fields: { "ID" => "id", "Repository" => "github_repository_id",
                                         "Skill" => "skill_id" })

data/lib/schwarm_cli/commands/secrets.rb

@@ -4,12 +4,12 @@ module SchwarmCli
   module Commands
     class Secrets < Base
       desc "list", "List secret files"
-      option :repo, type: :string, desc: "Filter by repository ID"
+      option :repo, type: :string, desc: "Filter by repository ID, owner/repo, or GitHub URL"
       pagination_options
       def list
         handle_errors do
           data = fetch_paged do |page_params|
-            client.secrets.list(repository_id: options[:repo], **page_params)
+            client.secrets.list(repository_id: resolve_repo(options[:repo]), **page_params)
           end
           output_list(data, columns: [%w[ID id], %w[NAME name], %w[REPO github_repository_name],
                                       %w[PATH path]])
@@ -29,14 +29,17 @@ module SchwarmCli
 
       desc "create", "Create a secret file"
       option :name, type: :string, required: true, desc: "Secret name"
-      option :repo, type: :string, required: true, desc: "Repository ID"
+      option :repo, type: :string, required: true, desc: "Repository ID, owner/repo, or GitHub URL"
       option :path, type: :string, required: true, desc: "File path in workspace"
       option :content, type: :string, desc: "Secret content"
       option :file, type: :string, desc: "Read content from file"
       def create
         handle_errors do
           content = read_content
-          attrs = { name: options[:name], github_repository_id: options[:repo], path: options[:path], content: }
+          attrs = {
+            name: options[:name], github_repository_id: resolve_repo(options[:repo]),
+            path: options[:path], content:
+          }
 
           data = client.secrets.create(**attrs)
           output_record(data, fields: { "ID" => "id", "Name" => "name", "Path" => "path" })

data/lib/schwarm_cli/commands/tasks.rb

@@ -5,7 +5,7 @@ module SchwarmCli
     class Tasks < Base
       desc "list", "List tasks (excludes archived by default)"
       option :status, type: :string, desc: "Filter by status"
-      option :repo, type: :string, desc: "Filter by repository ID"
+      option :repo, type: :string, desc: "Filter by repository ID, owner/repo, or GitHub URL"
       option :query, type: :string, desc: "Search by name"
       pagination_options
       def list
@@ -32,8 +32,7 @@ module SchwarmCli
       desc "create", "Create a new task"
       option :name, type: :string, required: true, desc: "Task name"
       option :prompt, type: :string, desc: "Task prompt"
-      option :prompt_file, type: :string, desc: "Read prompt from file"
-      option :repo, type: :string, desc: "Repository ID"
+      option :repo, type: :string, desc: "Repository ID, owner/repo, or GitHub URL"
       option :status, type: :string, desc: "Initial status (draft/waiting)"
       option :template, type: :string, desc: "Template ID"
       option :depends_on, type: :array, desc: "Dependency task IDs"
@@ -47,8 +46,7 @@ module SchwarmCli
       desc "update ID", "Update a task"
       option :name, type: :string, desc: "Task name"
       option :prompt, type: :string, desc: "Task prompt"
-      option :prompt_file, type: :string, desc: "Read prompt from file"
-      option :repo, type: :string, desc: "Repository ID"
+      option :repo, type: :string, desc: "Repository ID, owner/repo, or GitHub URL"
       option :depends_on, type: :array, desc: "Dependency task IDs"
       def update(id)
         handle_errors do
@@ -116,16 +114,15 @@ module SchwarmCli
 
       desc "handoff", "Hand off the current local branch to schwarm as a ready task"
       option :prompt, type: :string, desc: "Task prompt"
-      option :prompt_file, type: :string, desc: "Read prompt from file"
-      option :repo, type: :string, desc: "Repository ID (skips origin auto-detect)"
+      option :repo, type: :string, desc: "Repository ID, owner/repo, or GitHub URL (skips origin auto-detect)"
       option :name, type: :string, desc: "Task name (defaults to the branch name)"
       def handoff
-        prompt = read_prompt
-        abort "Error: --prompt or --prompt-file is required." if prompt.nil? || prompt.strip.empty?
+        prompt = options[:prompt]
+        abort "Error: --prompt is required." if prompt.nil? || prompt.strip.empty?
 
         handle_errors do
           result = SchwarmCli::HandsOffTask.new(client: client).call(
-            prompt: prompt, repo_override: options[:repo], name_override: options[:name]
+            prompt: prompt, repo_override: resolve_repo(options[:repo]), name_override: options[:name]
           )
           print_handoff_result(result)
         end
@@ -136,7 +133,7 @@ module SchwarmCli
       def list_attrs
         exclude_archived = options[:status].nil? && !options[:all]
         {
-          status: options[:status], repository_id: options[:repo], query: options[:query],
+          status: options[:status], repository_id: resolve_repo(options[:repo]), query: options[:query],
           archived: exclude_archived ? false : nil
         }
       end
@@ -153,28 +150,18 @@ module SchwarmCli
 
       def create_attrs
         {
-          name: options[:name], prompt: read_prompt,
-          github_repository_id: options[:repo], status: options[:status],
+          name: options[:name], prompt: options[:prompt],
+          github_repository_id: resolve_repo(options[:repo]), status: options[:status],
           task_template_id: options[:template], dependency_ids: options[:depends_on]
         }.compact
       end
 
       def update_attrs
         {
-          name: options[:name], github_repository_id: options[:repo],
+          name: options[:name], github_repository_id: resolve_repo(options[:repo]),
           dependency_ids: options[:depends_on]
         }.compact.tap do |attrs|
-          attrs[:prompt] = read_prompt if options[:prompt] || options[:prompt_file]
-        end
-      end
-
-      def read_prompt
-        if options[:prompt_file]
-          file_path = File.expand_path(options[:prompt_file])
-          abort "Error: File not found: #{file_path}" unless File.exist?(file_path)
-          File.read(file_path)
-        else
-          options[:prompt]
+          attrs[:prompt] = options[:prompt] if options[:prompt]
         end
       end
     end

data/lib/schwarm_cli/hands_off_task.rb

@@ -84,28 +84,17 @@ module SchwarmCli
     end
 
     def resolve_repository(origin:, override:)
-      if override
-        begin
-          return @client.repositories.find(override)["data"]
-        rescue Faraday::ResourceNotFound
-          return nil
-        end
-      end
-
-      slug = origin_slug(origin)
-      response = @client.repositories.list(query: slug)
-      Array(response["data"]).find { |r| normalize_url(r["github_url"]) == normalize_url(origin) }
-    end
+      return find_by_id(override) if override
 
-    def origin_slug(url)
-      # Accept both https://github.com/org/repo[.git] and git@github.com:org/repo.git
-      url.sub(%r{\Ahttps?://github\.com/}, "").sub(/\Agit@github\.com:/, "").sub(/\.git\z/, "")
+      RepositoryResolver.new(client: @client).resolve_record(origin)
+    rescue RepositoryResolver::ResolutionError
+      nil
     end
 
-    def normalize_url(url)
-      return nil if url.nil?
-
-      url.sub(/\.git\z/, "").sub(/\Agit@github\.com:/, "https://github.com/")
+    def find_by_id(id)
+      @client.repositories.find(id)["data"]
+    rescue Faraday::ResourceNotFound
+      nil
     end
 
     def create_task(repo:, branch:, prompt:, name_override:)

data/lib/schwarm_cli/repository_resolver.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  # Turns a user-provided `--repo` reference into a schwarm repository ID.
+  #
+  # Accepted inputs:
+  #   - a schwarm repository ID (returned as-is)
+  #   - "owner/repo"
+  #   - "https://github.com/owner/repo[.git]"
+  #   - "git@github.com:owner/repo[.git]"
+  class RepositoryResolver
+    class ResolutionError < StandardError; end
+
+    SLUG_PATTERNS = [
+      %r{\Ahttps?://github\.com/([^/\s]+/[^/\s]+?)(?:\.git)?/?\z},
+      %r{\Agit@github\.com:([^/\s:]+/[^/\s:]+?)(?:\.git)?\z},
+      %r{\A([^/\s:]+/[^/\s:]+?)(?:\.git)?\z}
+    ].freeze
+
+    def initialize(client:)
+      @client = client
+    end
+
+    def resolve(ref)
+      return nil if blank?(ref)
+
+      record = resolve_record(ref)
+      record ? record["id"] : ref
+    end
+
+    # Like `resolve`, but returns the full repo record when the ref is looked up
+    # via slug/URL. Returns nil when `ref` is blank or already a bare ID (caller
+    # should `find` by id directly in that case).
+    def resolve_record(ref)
+      return nil if blank?(ref)
+
+      slug = extract_slug(ref.strip)
+      slug ? lookup_by_slug(slug, ref) : nil
+    end
+
+    private
+
+    def blank?(ref)
+      ref.nil? || ref.to_s.strip.empty?
+    end
+
+    def extract_slug(ref)
+      SLUG_PATTERNS.filter_map { |pat| ref.match(pat)&.[](1) }.first
+    end
+
+    def lookup_by_slug(slug, original)
+      response = @client.repositories.list(query: slug)
+      match = Array(response["data"]).find { |r| slug_from_url(r["url"]) == slug }
+      raise ResolutionError, "no schwarm repository matches `#{original}`" if match.nil?
+
+      match
+    end
+
+    def slug_from_url(url)
+      return nil if url.nil?
+
+      url.sub(%r{\Ahttps?://github\.com/}, "").sub(/\Agit@github\.com:/, "").sub(/\.git\z/, "")
+    end
+  end
+end

data/lib/schwarm_cli/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SchwarmCli
-  VERSION = "0.1.3"
+  VERSION = "0.1.5"
 end

data/lib/schwarm_cli.rb

@@ -4,6 +4,7 @@ require_relative "schwarm_cli/version"
 require_relative "schwarm_cli/config"
 require_relative "schwarm_cli/client"
 require_relative "schwarm_cli/git"
+require_relative "schwarm_cli/repository_resolver"
 require_relative "schwarm_cli/hands_off_task"
 require_relative "schwarm_cli/formatters/json"
 require_relative "schwarm_cli/formatters/table"

data/schwarm-skill.md

@@ -32,7 +32,14 @@ The `schwarm` CLI is installed and configured (`schwarm configure`).
    ```bash
    schwarm tasks create --repo <REPO_ID> --name "Fix login bug" --prompt "The login form crashes when email is empty. Fix the validation in app/models/user.rb" --status ready
    ```
-   Use `--prompt-file ./prompt.md` for long prompts.
+   For a multi-line prompt, pipe via HEREDOC:
+   ```bash
+   schwarm tasks create --repo <REPO_ID> --name "Fix login bug" --status ready --prompt "$(cat <<'EOF'
+   The login form crashes when empty. Fix validation in app/models/user.rb
+   and add a regression test.
+   EOF
+   )"
+   ```
 3. Check the created task:
    ```bash
    schwarm tasks show <TASK_ID>
@@ -53,10 +60,24 @@ continues committing to it.
    ```bash
    schwarm tasks handoff --prompt "continue the validation logic, add tests"
    ```
-   Use `--prompt-file ./handoff.md` for long prompts.
 3. Take note of the task ID printed on success; you can monitor it like any
    other task.
 
+**Keep the prompt short.** The prompt is a pointer, not a spec. Before handing
+off, commit any detailed instructions, design notes, or TODOs into the repo
+(e.g. a `HANDOFF.md`, `AGENTS.md`, or inline comments) so the next agent reads
+them from the working tree. Then the `--prompt` just needs to say what to do
+next and where to look, e.g. `"continue per HANDOFF.md"`.
+
+For a multi-line prompt, use a HEREDOC rather than a file flag:
+```bash
+schwarm tasks handoff --prompt "$(cat <<'EOF'
+Continue the validation work. Start from the TODOs in app/models/user.rb
+and follow the plan in HANDOFF.md.
+EOF
+)"
+```
+
 **Watch for:**
 - The command refuses to hand off the base branch (`main`). Create a feature
   branch first.
@@ -223,7 +244,9 @@ for tasks in a repository.
 - Check task status before taking actions (e.g., only `retry` works on `error`
   tasks, only `start` works on `draft` tasks).
 - When building a DAG, create all tasks as drafts first, then start them all.
-- For long prompts, write them to a file and use `--prompt-file`.
+- Keep `--prompt` short — commit long-form instructions (plans, TODOs,
+  `HANDOFF.md`) into the repo and point the prompt at them. For multi-line
+  prompts, pipe via HEREDOC: `--prompt "$(cat <<'EOF' ... EOF)"`.
 - Run `schwarm <command> help` for full flag documentation on any command.
 - `schwarm tasks list` excludes archived tasks by default. Use `--all` to
   include them or `--status archived` to see only archived.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: schwarm-cli
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.5
 platform: ruby
 authors:
 - Vincent Garrigues
@@ -122,6 +122,7 @@ files:
 - lib/schwarm_cli/formatters/table.rb
 - lib/schwarm_cli/git.rb
 - lib/schwarm_cli/hands_off_task.rb
+- lib/schwarm_cli/repository_resolver.rb
 - lib/schwarm_cli/version.rb
 - schwarm-skill.md
 homepage: https://github.com/getdexter/schwarm