@harborppm/cli 0.62.0 → 0.64.0

package/README.md

@@ -135,8 +135,11 @@ harbor hill [--program P]                   where each project is on its hill
 harbor hill PROJECT --at 0-100|top|done     move it: up to 50 is figuring it out,
                                             past 50 is getting it done
 harbor mine                                 what's on you, late first
+harbor clock [NAME] [--zone ZONE|here|none] [--hours 9-17]
+                                            who's working now; set your (or NAME's) time zone and hours
 harbor tasks [words] [--project P] [--assignee me|none|NAME] [--late] [--status S,S] [--all]
-harbor show TASK                            one task in full, with its web link
+harbor show TASK                            one task in full, with its web link and the
+                                            date its owner's queue suggests (pilotDue in --json)
 harbor open [TASK|PROJECT]                  open it on the website (or Today)
 harbor invite EMAIL [--viewer]              invite someone to your harbor by email
 harbor calendar [--program P] [--new|--off] your private calendar link (.ics)
@@ -154,8 +157,11 @@ harbor project "NAME" --program P [--lead me|NAME] [--starts DATE]
 harbor add "TITLE" --project P [--assignee me|NAME] [--due DATE|pilot]
                    [--priority low|medium|high|urgent] [--status S] [--comment TEXT]
                    [--over-limit]               no TITLE: one title a line from stdin
-                                            --due pilot takes the date the owner's queue suggests;
-                                            a date that won't hold says so
+                                            --due pilot takes the earliest day the owner's queue
+                                            suggests (their open work due first, weekly pace, time
+                                            away, what it waits on, how long their similar tasks
+                                            took); it needs an owner, and an empty queue gives
+                                            their next working day. A date that won't hold says so
 harbor start TASK | submit TASK | done TASK [--confirm] [--over-limit]
 harbor edit TASK [--title T] [--assignee me|none|NAME] [--due DATE|pilot|none]
                  [--priority P] [--status S] [--notes TEXT]
@@ -223,7 +229,7 @@ harbor agent report TASK "WHAT YOU DID" [--start] [--agent NAME]
 
 `harbor fog` lists the open tasks nobody has opened, moved, edited or commented on for three weeks, longest first. `harbor fog --sweep` walks through them one at a time in a terminal: `k` still needed (clears the fog), `d` a new date, `x` drop it, `s` skip, `q` stop. On the board, in the app and on the website, those cards show dimmed.
 
-`harbor watch` turns a narrow split or a tmux pane into a live ticker of your harbor: cards moving, comments, health changes, a line each as they happen, over the same live updates the website uses. Lines about your own work (your tasks, mentions of you, what you lead) are bright and the rest dim; `--bell` rings the terminal's bell when something of yours changes, and `--project` keeps to one project. It starts with the latest few changes and the time it began listening; `--since 14:30` (or a date) starts from then instead. `q` stops; piped or with `--json` (one JSON object a line) it runs until it's killed, and `--once` prints what's there and returns, for scripts.
+`harbor watch` turns a narrow split or a tmux pane into a live ticker of your harbor: cards moving, comments, health changes, a line each as they happen, over the same live updates the website uses. Lines about your own work (your tasks, mentions of you, what you lead) are bright and the rest dim; `--bell` rings the terminal's bell when something of yours changes, and `--project` keeps to one project. It starts with the latest few changes and the time it began listening; `--since 14:30` (or a date) starts from then instead, on this computer's clock (`14:30Z` or `14:30 UTC` for UTC); the header names the time zone the ticker's times are in, and Harbor says "Nothing since 14:30 BST." when nothing has. A change the GitHub link made reads "Finished RR-4 … via GitHub", as History does. `q` stops; piped or with `--json` (one JSON object a line) it runs until it's killed, and `--once` prints what's there and returns, for scripts.
 
 `harbor lifeboats` lists the work only one person has touched (a project, their corner of one, a task others wait on, their serious risks), numbered, each with someone who has room this week and already works nearby. `harbor lifeboats 2` puts that person on line 2 as a second pair of hands (`--person NAME` for someone else); `harbor follow RR-4 --person Sam` does it for one task. Following doesn't take the work over. `harbor raid "DECISION" --still-stands "WHY"` says a decision that came back for a look still stands.