trackerctl 0.4.1 → 0.4.2

package/README.md

@@ -92,6 +92,7 @@ Read commands serve from a local sqlite cache that auto-syncs when older than
 | `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 |
@@ -176,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)),
@@ -1359,6 +1370,7 @@ write commands:
   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>
@@ -1482,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.
@@ -1804,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);
@@ -2205,7 +2234,7 @@ var VALUE_FLAGS = {
     "--message": "value",
     "--json": "bool"
   },
-  spend: {},
+  spend: { "--since-claim": "bool" },
   estimate: {},
   sync: {},
   claim: {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trackerctl",
-  "version": "0.4.1",
+  "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",