trackerctl 0.4.0 → 0.4.2

package/README.md

@@ -90,7 +90,9 @@ Read commands serve from a local sqlite cache that auto-syncs when older than
 | `tracker close <id> [--reason <text>]` | Close (clears assignee + in-progress label) |
 | `tracker comment <id> <text>` | Post a comment on an item |
 | `tracker attach <id> <file...> [-m <msg>]` | Upload files, reference them from one comment; prints markdown |
+| `tracker label <id> [--add a,b] [--remove c,d]` | Add/remove labels without clobbering the rest |
 | `tracker spend <id> <duration>` | Add time spent (`1h30m`, `2d`; `-30m` subtracts) |
+| `tracker spend <id> --since-claim` | Log wall-clock elapsed since the latest 🔒 claim note (claim-to-done timing) |
 | `tracker estimate <id> <duration>` | Set the time estimate (`0` clears it) |
 | `tracker dep <id> --blocked-by <o> \| --blocks <o>` | Add a dependency edge |
 | `tracker parent <child> <parent>` | Re-parent an item |
@@ -175,8 +177,9 @@ domain refusal (e.g. lost a claim race) — pick different work, don't retry.
 - Land it:          `tracker pr merge <id> --close-issues` — also closes the `-i` issues
                     with a comment explaining why; never rely on provider auto-close
 
-- Track time:       `tracker spend <id> 1h30m` after finishing work (estimate vs spent
-                    feeds later evaluations; durations use 1d=8h, -30m subtracts)
+- Track time:       `tracker spend <id> --since-claim` after landing work — logs the
+                    elapsed claim-to-done wall clock from server timestamps (or an
+                    explicit `tracker spend <id> 1h30m`; durations use 1d=8h, -30m subtracts)
 - Project memory:   `tracker remember <key> "<fact>"`, `tracker memories --json`,
                     `tracker forget <key>`
 

package/dist/tracker.js

@@ -1003,6 +1003,17 @@ function electWinner(comments, nowMs, ttlMs) {
   live.sort((a, b) => a.ts - b.ts || compareCommentIds(a.commentId, b.commentId));
   return live[0] ?? null;
 }
+function secondsSinceClaim(comments, nowMs) {
+  let latest = null;
+  for (const c of comments) {
+    if (!c.body.startsWith(CLAIM_MARK))
+      continue;
+    const ts = Date.parse(c.createdAt);
+    if (Number.isFinite(ts) && (latest === null || ts > latest))
+      latest = ts;
+  }
+  return latest === null ? null : Math.max(0, Math.round((nowMs - latest) / 1000));
+}
 var realClaimDeps = {
   now: () => Date.now(),
   sleep: (ms) => new Promise((r) => setTimeout(r, ms)),
@@ -1354,9 +1365,12 @@ write commands:
   release <id>               clear assignee/label, tombstone live claim tokens
   close <id> [--reason <text>]
   comment <id> <text>        post a comment on an item
+  label <id> [--add a,b] [--remove c,d]
+                             add/remove labels without touching the others
   attach <id> <file...> [-m <message>]
                              upload files and attach them via a comment
   spend <id> <duration>      add time spent (1h30m, 45m, 2d; -30m subtracts)
+  spend <id> --since-claim   log elapsed time since the latest claim note
   estimate <id> <duration>   set the time estimate (0 clears it)
   dep <id> --blocked-by <other> | --blocks <other>
   parent <child-id> <parent-id>
@@ -1430,6 +1444,14 @@ Posts a comment on the item. Everything after the id is joined into one
 comment body, so quoting multi-word text is optional.
 
 example: tracker comment 42 "blocked on the design review, see thread"`,
+  label: `usage: tracker label <id> [--add <a,b>] [--remove <c,d>]
+
+Adds and/or removes labels (comma-separated) without clobbering the rest.
+At least one of --add/--remove is required.
+
+examples:
+  tracker label 42 --add status::agent-blocked
+  tracker label 42 --remove status::agent-blocked --add meta::human-only`,
   attach: `usage: tracker attach <id> <file...> [-m <message>] [--json]
 
 Uploads each file to the provider and posts ONE comment on the item containing
@@ -1472,14 +1494,19 @@ Lists the item's comments oldest-first (system notes are filtered out). Claim
 notes (\uD83D\uDD12/\uD83D\uDD13) and memory entries (\uD83D\uDCCC) appear here too \u2014 useful for debugging.
 
 example: tracker comments 42 --json`,
-  spend: `usage: tracker spend <id> <duration>
+  spend: `usage: tracker spend <id> <duration> | tracker spend <id> --since-claim
 
 Adds to the item's time spent. Durations use GitLab conventions:
 units w/d/h/m/s with 1d = 8h and 1w = 5d. A leading "-" subtracts.
 
+--since-claim logs the wall-clock elapsed since the latest \uD83D\uDD12 claim note
+(rounded to whole minutes, minimum 1m) \u2014 claim-to-done ticket timing with
+no client-side clock needed. Exit 2 if the item was never claimed.
+
 examples:
   tracker spend 42 1h30m
-  tracker spend 42 -30m     # logged too much, take 30m back`,
+  tracker spend 42 -30m         # logged too much, take 30m back
+  tracker spend 42 --since-claim`,
   estimate: `usage: tracker estimate <id> <duration>
 
 Sets the item's time estimate (same duration format as spend). 0 clears it.
@@ -1794,9 +1821,21 @@ async function cmdSpend(ctx, args) {
   requireTimeTracking(ctx);
   const [idArg, durationArg] = args.positionals;
   const id = normalizeId(idArg);
-  if (!durationArg)
+  const sinceClaim = args.flags.get("--since-claim") === true;
+  if (sinceClaim && durationArg) {
+    throw new UsageError("pass either a duration or --since-claim, not both");
+  }
+  if (!sinceClaim && !durationArg)
     throw new UsageError(commandHelp("spend"));
-  const seconds = parseDuration(durationArg);
+  let seconds;
+  if (sinceClaim) {
+    const elapsed = secondsSinceClaim(await ctx.adapter.listComments(id), Date.now());
+    if (elapsed === null)
+      throw new DomainError(`#${id} has no claim note to measure from`);
+    seconds = Math.max(60, Math.round(elapsed / 60) * 60);
+  } else {
+    seconds = parseDuration(durationArg);
+  }
   if (seconds === 0)
     throw new UsageError("spend needs a non-zero duration (e.g. 1h30m or -30m)");
   await ctx.adapter.addTimeSpent(id, seconds);
@@ -1826,6 +1865,25 @@ async function cmdComment(ctx, args) {
   await ctx.adapter.comment(id, body);
   console.log(`commented on #${id}`);
 }
+async function cmdLabel(ctx, args) {
+  const id = normalizeId(args.positionals[0]);
+  const csv = (name) => (str(args, name) ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+  const addLabels = csv("--add");
+  const removeLabels = csv("--remove");
+  if (addLabels.length === 0 && removeLabels.length === 0) {
+    throw new UsageError(commandHelp("label"));
+  }
+  await ctx.adapter.update(id, {
+    ...addLabels.length ? { addLabels } : {},
+    ...removeLabels.length ? { removeLabels } : {}
+  });
+  invalidate(ctx);
+  const parts = [
+    ...addLabels.length ? [`+${addLabels.join(" +")}`] : [],
+    ...removeLabels.length ? [`-${removeLabels.join(" -")}`] : []
+  ];
+  console.log(`#${id} labels: ${parts.join(" ")}`);
+}
 async function cmdAttach(ctx, args) {
   const [idArg, ...paths] = args.positionals;
   const id = normalizeId(idArg);
@@ -2164,6 +2222,7 @@ var VALUE_FLAGS = {
   comment: {},
   comments: { "--json": "bool" },
   attach: { "--message": "value", "--json": "bool" },
+  label: { "--add": "value", "--remove": "value" },
   pr: {
     "--title": "value",
     "--description": "value",
@@ -2175,7 +2234,7 @@ var VALUE_FLAGS = {
     "--message": "value",
     "--json": "bool"
   },
-  spend: {},
+  spend: { "--since-claim": "bool" },
   estimate: {},
   sync: {},
   claim: {},
@@ -2240,6 +2299,7 @@ ${HELP}`);
     comment: cmdComment,
     comments: cmdComments,
     attach: cmdAttach,
+    label: cmdLabel,
     pr: cmdPr,
     spend: cmdSpend,
     estimate: cmdEstimate,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trackerctl",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Multi-backend issue-tracking CLI for humans and AI agents — claim races, dependencies, hierarchy, local FTS search, project memory. GitLab adapter first.",
   "license": "MIT",
   "author": "refo",