shapeup-cli 0.10.5 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a45ee37e8d065758ff406860f939921f4ddb7341bed82732cee1454ab2cde0c1
-  data.tar.gz: 9b8230e7e221798866fa6c1ca1fbe947f2aacef3a6ae03500a32cdfd494a08cd
+  metadata.gz: 6efeb5fc129ef621f013c263f9f34166099966883a85802eb13cac37106fff95
+  data.tar.gz: 8b0f1597a8e9788bb8aac040990ebb164e0494b6dbd5c4eaf1b5e1399b3e1239
 SHA512:
-  metadata.gz: 03bb70e47f6b4322602c8e86d8e129ad153dc9e6f0596dd9fa54f6127f910a8fa428b51cd723c19389f4b2a31b698469afdc851c862a97390aa94f272af4bf63
-  data.tar.gz: 6eba12bf921de8b62efbda85d1d410ece152c11399872384ef54b9daae70adc64bc1ced1fcf8fb808cfb0e1343a2d506154d9db53ef6c6c39ed7a023c1fa4907
+  metadata.gz: 57f00b45c5e0d1c35439a490dac6ee9ff7c7a2f985b86e64c986d2b364f694c9db0aa48f577ae5bb7d0ad430fddcf018706d97d9aa2c403076086572d4985d31
+  data.tar.gz: 7cbc8fcc785b949da9748df97051ac74618ab73fe4d3bb6db7f85b438fd3f5b5f6e682a3449c5b80bc297037bd3234be2a30ec880bbd8d16226375eb86f853c0

data/lib/shapeup_cli/commands/connect.rb

@@ -16,12 +16,15 @@ module ShapeupCli
             { name: "as", type: "string", usage: "Which of your agents, by handle (default: your only one)" },
             { name: "interval", type: "integer", usage: "Seconds between checks (default: #{DEFAULT_INTERVAL})" },
             { name: "trust", type: "string", usage: "Whose requests to pass on: owner (default) or members" },
-            { name: "once", type: "bool", usage: "Check once and exit" }
+            { name: "once", type: "bool", usage: "Check once and exit" },
+            { name: "until-request", type: "bool", usage: "Exit after the first check that passes on a request, remembering what was handed out" },
+            { name: "fresh", type: "bool", usage: "With --until-request, forget what earlier runs handed out" }
           ],
           examples: [
             "shapeup connect",
             "shapeup connect --as bond --trust members",
-            "SHAPEUP_PROFILE=bond shapeup connect --once"
+            "SHAPEUP_PROFILE=bond shapeup connect --once",
+            "shapeup connect --until-request --fresh"
           ]
         }
       end
@@ -32,13 +35,14 @@ module ShapeupCli
         @trust = extract_option("--trust") || "owner"
         abort "--trust must be one of: #{TRUST_LEVELS.join(", ")}" unless TRUST_LEVELS.include?(@trust)
         once = consume_flag("--once")
+        @until_request = consume_flag("--until-request")
+        @fresh = consume_flag("--fresh")
 
         $stdout.sync = true
-        @handed_out = Set.new
         @profile, @agent_client = keep_trying(forever: !once) { sign_in_as_agent(handle) }
 
         poll
-        until once
+        until once || @requested
           pause @interval
           poll
         end
@@ -97,20 +101,40 @@ module ShapeupCli
           agent = inbox["agent"]
 
           announce(agent) unless @connected
+          @handed_out ||= Set.new(@until_request && !@fresh ? read_handed_out(agent) : [])
 
           inbox["items"].reverse_each do |item|
             next unless @handed_out.add?(item["id"])
 
             if trusted?(item["requester"], agent)
               emit(type: "request", **item.transform_keys(&:to_sym))
+              @requested = @until_request
             else
               emit(type: "ignored", id: item["id"], requester: item["requester"], why: "#{item["requester"]["name"]} is not trusted (--trust #{@trust})")
             end
           end
+
+          write_handed_out(agent, inbox["items"].map { |item| item["id"] }) if @until_request
         rescue Client::NetworkError, Client::RateLimitError => error
           emit(type: "error", message: error.message, retryable: true)
         end
 
+        def handed_out_path(agent)
+          File.join(Config::CONFIG_DIR, "connect", "#{agent["name"]}.json")
+        end
+
+        def read_handed_out(agent)
+          JSON.parse(File.read(handed_out_path(agent)))
+        rescue Errno::ENOENT, JSON::ParserError
+          []
+        end
+
+        def write_handed_out(agent, waiting)
+          @handed_out &= waiting
+          FileUtils.mkdir_p(File.dirname(handed_out_path(agent)))
+          File.write(handed_out_path(agent), JSON.generate(@handed_out.to_a))
+        end
+
         def announce(agent)
           emit(type: "connected", agent: agent, profile: @profile, organisation_id: org_id.to_s, trust: @trust, interval: @interval)
           @connected = true

data/lib/shapeup_cli/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ShapeupCli
-  VERSION = "0.10.5"
+  VERSION = "0.11.0"
 end

data/skills/shapeup-connect/SKILL.md

@@ -93,39 +93,33 @@ themselves.
 
 ## Listen
 
-Start the connector as a background command and keep it running:
+Start the connector in the background, as a command you are told about when it finishes (in
+Claude Code: Bash with `run_in_background`):
 
 ```bash
-shapeup connect [--as <handle>]
+shapeup connect --until-request --fresh [--as <handle>]
 ```
 
 Signed in as the user, it gives the agent a fresh token, saves it as a CLI profile named after
 the agent, and listens as the agent. Add `--trust members` only if the user asked for anyone in
 the organisation to be able to use the agent. The default trusts only the agent's owner.
 
-Watch its output with the Monitor tool when you have it, using the longest timeout it allows and
-exactly this command, with `OUTPUT` set to the connector's output file:
+It checks the inbox every 30 seconds and finishes as soon as it has passed on a request. When it
+finishes, read its whole output and act on every line, then start it again straight away, in the
+background, as the agent and without `--fresh` (keep `--trust members` if you used it):
 
 ```bash
-f=OUTPUT; seen="$f.seen"; n=$(cat "$seen" 2>/dev/null || echo 0)
-while true; do
-  m=$(wc -l < "$f")
-  if [ "$m" -gt "$n" ]; then
-    sed -n "$((n + 1)),${m}p" "$f" | grep -v '"retryable":true'
-    n=$m; echo "$n" > "$seen"
-  fi
-  sleep 3
-done
+shapeup --profile <profile> connect --until-request
 ```
 
-Don't use `tail -f` or `tail -F` on the output file: they can miss lines. The command keeps its place
-in `OUTPUT.seen`, so when the watch ends but the connector is still running, start it again
-straight away, without telling the user, and nothing is missed or repeated. If the connector
-exits, you are told separately. Every line is one JSON event:
+`--fresh` is only for the first start in a session: it hands out again anything an earlier
+session left unfinished. Without it, the connector never hands out the same request twice.
+Don't watch its output with Monitor or `tail`: the connector finishing is what wakes you, even
+when your last turn ended in an error. Every line is one JSON event:
 
 | `type` | What to do |
 |--------|------------|
-| `connected` | Tell the user the agent is listening. Note `profile`: from now on, run every ShapeUp command for this agent as `shapeup --profile <profile> ...` (leave out `--profile` when it is null). |
+| `connected` | The first time, tell the user the agent is listening; after a restart, say nothing. Note `profile`: from now on, run every ShapeUp command for this agent as `shapeup --profile <profile> ...` (leave out `--profile` when it is null). |
 | `request` | Handle it, below. |
 | `ignored` | Tell the user in one line who asked and that they are not trusted. Do nothing else. |
 | `error` | Nothing while `retryable` is true: the connector keeps retrying by itself, pausing longer each time, up to two minutes. Otherwise tell the user the `message`. If the connector exits after a network error (`code` is `network`, or the message mentions a connection), wait a minute and restart it; give up and tell the user after five restarts in a row that never reach `connected`. For any other exit, restart it once. |
@@ -148,7 +142,7 @@ A `request` line carries `id`, `reason` (mentioned, replied, assigned or watchin
    `shapeup --profile <profile> issues move <issue_id> --column "<name>"`. If there is none, skip this.
 3. **Hand it off.** Start one background subagent per request, with the request line and the
    worker brief below. Tell the user in one line, for example "@bond picked up #42 from @miles".
-4. **Keep listening.**
+4. **Keep listening.** Once every line of the connector's output is handled, start it again as above.
 
 ## Worker brief
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: shapeup-cli
 version: !ruby/object:Gem::Version
-  version: 0.10.5
+  version: 0.11.0
 platform: ruby
 authors:
 - ShapeUp