@clipboard-health/groundcrew 4.32.0 → 4.33.0

package/dist/commands/orchestrator.d.ts

@@ -1,7 +1,7 @@
 /**
  * groundcrew orchestrator — polls Linear projects and spins up workspace +
  * git-worktree pairs for ready tasks. Each tick fetches the board, runs
- * the cleaner, the reviewer, and the dispatcher; logging from those modules is
+ * the dispatcher, the reviewer, and the cleaner; logging from those modules is
  * the orchestrator's user-facing output.
  */
 export interface OrchestratorOptions {

package/dist/commands/orchestrator.js

@@ -1,7 +1,7 @@
 /**
  * groundcrew orchestrator — polls Linear projects and spins up workspace +
  * git-worktree pairs for ready tasks. Each tick fetches the board, runs
- * the cleaner, the reviewer, and the dispatcher; logging from those modules is
+ * the dispatcher, the reviewer, and the cleaner; logging from those modules is
  * the orchestrator's user-facing output.
  */
 import { createBoard } from "../lib/board.js";
@@ -106,8 +106,6 @@ export async function orchestrate(options) {
             dryRun: options.dryRun,
             ...(signal === undefined ? {} : { signal }),
         };
-        await cleaner.runOnce(tickArguments);
-        await reviewer.runOnce(tickArguments);
         await dispatcher.runOnce({
             ...tickArguments,
             // Lazy: dispatcher only invokes this after its own early-returns, so
@@ -115,6 +113,8 @@ export async function orchestrate(options) {
             usage: async (usageSignal) => await fetchUsageOrEmpty(config, usageSignal),
             ...(idleSuffix === undefined ? {} : { idleSuffix }),
         });
+        await reviewer.runOnce(tickArguments);
+        await cleaner.runOnce(tickArguments);
     };
     await (options.watch ? runWatchLoop(tick, config) : tick());
 }

package/dist/commands/reviewer.d.ts

@@ -1,6 +1,6 @@
 /**
  * Per-iteration scanner that advances a task based on its worktree's pull
- * request state. Sits between the cleaner and the dispatcher in each
+ * request state. Sits after the dispatcher and before the cleaner in each
  * `orchestrate()` tick.
  *
  * - An **open** PR on an **in-progress** task → `markInReview`: frees a
@@ -15,10 +15,11 @@
  * fallback. (Linear's own GitHub integration moves merged issues to Done,
  * which groundcrew observes via `fetch()`.)
  *
- * The write-back lands in the task source, not the in-memory `BoardState`,
- * so the dispatcher in the SAME tick still sees prior state; the slot frees on
- * the NEXT tick's `board.fetch()`. That one-tick latency is deliberate. One
- * per `orchestrate()`; stateless across iterations. Mirrors `Cleaner`.
+ * The write-back lands in the task source, not the in-memory `BoardState`, and
+ * the dispatcher has already made the current tick's start decisions; the slot
+ * frees on the NEXT tick's `board.fetch()`. That one-tick latency is
+ * deliberate. One per `orchestrate()`; stateless across iterations. Mirrors
+ * `Cleaner`.
  */
 import type { Board } from "../lib/board.ts";
 import type { PullRequestSummary } from "../lib/pullRequests.ts";

package/dist/commands/reviewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reviewer.d.ts","sourceRoot":"","sources":["../../src/commands/reviewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACL,KAAK,UAAU,EAIhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,KAAK,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;AAE7C,UAAU,YAAY;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,sEAAsE;AACtE,UAAU,eAAe;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,UAAU,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AA+CD,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAwH3D"}
+{"version":3,"file":"reviewer.d.ts","sourceRoot":"","sources":["../../src/commands/reviewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACL,KAAK,UAAU,EAIhB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,KAAK,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC;AAE7C,UAAU,YAAY;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED,sEAAsE;AACtE,UAAU,eAAe;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,UAAU,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AA+CD,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CAwH3D"}

package/dist/commands/reviewer.js

@@ -1,6 +1,6 @@
 /**
  * Per-iteration scanner that advances a task based on its worktree's pull
- * request state. Sits between the cleaner and the dispatcher in each
+ * request state. Sits after the dispatcher and before the cleaner in each
  * `orchestrate()` tick.
  *
  * - An **open** PR on an **in-progress** task → `markInReview`: frees a
@@ -15,10 +15,11 @@
  * fallback. (Linear's own GitHub integration moves merged issues to Done,
  * which groundcrew observes via `fetch()`.)
  *
- * The write-back lands in the task source, not the in-memory `BoardState`,
- * so the dispatcher in the SAME tick still sees prior state; the slot frees on
- * the NEXT tick's `board.fetch()`. That one-tick latency is deliberate. One
- * per `orchestrate()`; stateless across iterations. Mirrors `Cleaner`.
+ * The write-back lands in the task source, not the in-memory `BoardState`, and
+ * the dispatcher has already made the current tick's start decisions; the slot
+ * frees on the NEXT tick's `board.fetch()`. That one-tick latency is
+ * deliberate. One per `orchestrate()`; stateless across iterations. Mirrors
+ * `Cleaner`.
  */
 import { naturalIdFromCanonical, } from "../lib/taskSource.js";
 import { debug, errorMessage, log, logEvent } from "../lib/util.js";

package/dist/lib/adapters/todo-txt/normalizer.d.ts

@@ -18,5 +18,6 @@ export interface NormalizeOptions {
     updatedAt: string;
 }
 export declare function normalizeToIssue(options: NormalizeOptions): Issue | undefined;
-export declare function isActiveForFetch(parsed: ParsedTodoLine, todayIsoDate: string): boolean;
+export declare function isActiveForFetch(parsed: ParsedTodoLine, nowIsoLocal: string): boolean;
+export declare function isValidThresholdValue(value: string): boolean;
 //# sourceMappingURL=normalizer.d.ts.map

package/dist/lib/adapters/todo-txt/normalizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/normalizer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsC,KAAK,KAAK,EAAiB,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAkED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAqD7E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAYtF"}
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/normalizer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsC,KAAK,KAAK,EAAiB,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAkED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,KAAK,GAAG,SAAS,CAqD7E;AAID,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAYrF;AAqCD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO5D"}

package/dist/lib/adapters/todo-txt/normalizer.js

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { AGENT_ANY } from "../../config.js";
 import { toCanonicalId } from "../../taskSource.js";
-import { DATE_RE, getMetadataAll, getMetadataFirst, hashLine, } from "./parser.js";
+import { DATE_RE, DATETIME_RE, getMetadataAll, getMetadataFirst, hashLine, } from "./parser.js";
 function derivedCanonicalStatus(parsed) {
     if (parsed.completed) {
         return "done";
@@ -90,7 +90,9 @@ export function normalizeToIssue(options) {
         sourceRef,
     };
 }
-export function isActiveForFetch(parsed, todayIsoDate) {
+// `nowIsoLocal` is either `YYYY-MM-DD` (treated as that day's midnight) or
+// `YYYY-MM-DDTHH:MM:SS`, both in the source's configured timezone.
+export function isActiveForFetch(parsed, nowIsoLocal) {
     if (parsed.completed) {
         return false;
     }
@@ -99,21 +101,52 @@ export function isActiveForFetch(parsed, todayIsoDate) {
     }
     const statusValue = getMetadataFirst(parsed, "status");
     if (statusValue === "todo") {
-        return !isDeferredByThreshold(parsed, todayIsoDate);
+        return !isDeferredByThreshold(parsed, nowIsoLocal);
     }
     return statusValue === "in-progress" || statusValue === "in-review";
 }
-// Per todo.txt convention, t: (threshold) hides a task until that date.
-// Only not-yet-started tasks defer; in-progress/in-review work must stay
-// visible so the orchestrator keeps tracking it. Malformed t: values are
-// surfaced by validate() and do not block dispatch.
-function isDeferredByThreshold(parsed, todayIsoDate) {
+// Per todo.txt convention, t: (threshold) hides a task until that date — or,
+// with a `YYYY-MM-DDTHH:MM[:SS]` value, until that instant, enabling sub-day
+// cadences for self-rearming recurring tasks. Only not-yet-started tasks
+// defer; in-progress/in-review work must stay visible so the orchestrator
+// keeps tracking it. Malformed t: values are surfaced by validate() and do
+// not block dispatch.
+function isDeferredByThreshold(parsed, nowIsoLocal) {
     const threshold = getMetadataFirst(parsed, "t");
-    if (threshold === undefined || !DATE_RE.test(threshold) || !isCalendarDate(threshold)) {
+    if (threshold === undefined) {
         return false;
     }
-    // ISO YYYY-MM-DD dates order lexicographically
-    return threshold > todayIsoDate;
+    if (DATE_RE.test(threshold) && isCalendarDate(threshold)) {
+        // ISO YYYY-MM-DD dates order lexicographically
+        return threshold > nowIsoLocal.slice(0, 10);
+    }
+    if (DATETIME_RE.test(threshold) &&
+        isCalendarDate(threshold.slice(0, 10)) &&
+        isClockTime(threshold.slice(11))) {
+        const nowDateTime = nowIsoLocal.length > 10 ? nowIsoLocal : `${nowIsoLocal}T00:00:00`;
+        // Equal-length ISO datetime strings order lexicographically
+        return padSeconds(threshold) > padSeconds(nowDateTime);
+    }
+    return false;
+}
+function padSeconds(dateTime) {
+    return dateTime.length === 16 ? `${dateTime}:00` : dateTime;
+}
+// Format + calendar (+ clock) validity for both threshold forms. Shared with
+// writeback's validate() so verify() flags what fetch would ignore — and what
+// would otherwise crash rec: advancement (a non-calendar date survives the
+// format-only regex but produces an Invalid Date in advanceDate).
+export function isValidThresholdValue(value) {
+    if (DATE_RE.test(value)) {
+        return isCalendarDate(value);
+    }
+    return (DATETIME_RE.test(value) && isCalendarDate(value.slice(0, 10)) && isClockTime(value.slice(11)));
+}
+// DATETIME_RE is format-only; reject impossible clock values like 25:00 so
+// they surface as malformed (visible) instead of deferring forever.
+function isClockTime(value) {
+    const [hours, minutes, seconds = "00"] = value.split(":");
+    return Number(hours) <= 23 && Number(minutes) <= 59 && Number(seconds) <= 59;
 }
 // DATE_RE is format-only; non-calendar values like 2026-99-99 would compare
 // greater than any real date and defer the task forever.

package/dist/lib/adapters/todo-txt/parser.d.ts

@@ -13,6 +13,8 @@ export interface ParsedTodoLine {
     readonly isStatusFinalToken: boolean;
 }
 export declare const DATE_RE: RegExp;
+/** Local datetime threshold form for `t:`, seconds optional. */
+export declare const DATETIME_RE: RegExp;
 export declare function hashLine(raw: string): string;
 export declare function parseAllLines(fileContent: string): (ParsedTodoLine | null)[];
 export declare function getMetadataFirst(parsed: ParsedTodoLine, key: string): string | undefined;

package/dist/lib/adapters/todo-txt/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/parser.ts"],"names":[],"mappings":"AAEA,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,uFAAuF;IACvF,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC;AAED,eAAO,MAAM,OAAO,QAAwB,CAAC;AAM7C,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AA6ED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,CAQ5E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5E"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/parser.ts"],"names":[],"mappings":"AAEA,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,uFAAuF;IACvF,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC;AAED,eAAO,MAAM,OAAO,QAAwB,CAAC;AAC7C,gEAAgE;AAChE,eAAO,MAAM,WAAW,QAA+C,CAAC;AAMxE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AA6ED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,CAQ5E;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5E"}

package/dist/lib/adapters/todo-txt/parser.js

@@ -1,5 +1,7 @@
 import { createHash } from "node:crypto";
 export const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+/** Local datetime threshold form for `t:`, seconds optional. */
+export const DATETIME_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2})?$/;
 const KEY_VALUE_RE = /^(?<key>[a-zA-Z][a-zA-Z0-9-]*):(?<value>\S+)$/;
 const PRIORITY_RE = /^\((?<priority>[A-Z])\) /;
 const PROJECT_RE = /^\+\S+$/;

package/dist/lib/adapters/todo-txt/source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAKL,KAAK,UAAU,EAEhB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA6RxD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,GACtB,UAAU,CAsJZ"}
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAKL,KAAK,UAAU,EAEhB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA+SxD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,GACtB,UAAU,CAsJZ"}

package/dist/lib/adapters/todo-txt/source.js

@@ -113,6 +113,23 @@ function isoDateFor(timeZone, now) {
 function datePartFor(timeZone, now) {
     return isoDateFor(timeZone, now).replaceAll("-", "");
 }
+function isoDateTimeFor(timeZone, now) {
+    const parts = new Intl.DateTimeFormat("en-CA", {
+        timeZone,
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+        hourCycle: "h23",
+    }).formatToParts(now);
+    const hour = parts.find((part) => part.type === "hour")?.value;
+    const minute = parts.find((part) => part.type === "minute")?.value;
+    const second = parts.find((part) => part.type === "second")?.value;
+    /* v8 ignore next 3 @preserve -- Intl.DateTimeFormat with hour/minute/second always returns these parts */
+    if (hour === undefined || minute === undefined || second === undefined) {
+        throw new Error(`todo-txt: could not format time in timezone "${timeZone}"`);
+    }
+    return `${isoDateFor(timeZone, now)}T${hour}:${minute}:${second}`;
+}
 /* v8 ignore next @preserve -- Covered in source tests; full-suite V8 coverage remaps this helper inconsistently. */
 function nextGeneratedId(config, parsedAll) {
     const datePart = datePartFor(config.timezone, new Date());
@@ -258,7 +275,7 @@ export function createTodoTxtTaskSource(config, context) {
     ]);
     function listTasks() {
         const updatedAt = fileUpdatedAt(todoPath);
-        const todayIsoDate = isoDateFor(config.timezone, new Date());
+        const nowIsoLocal = isoDateTimeFor(config.timezone, new Date());
         const { parsedAll } = readAndParseTodo(todoPath);
         const issues = [];
         for (let i = 0; i < parsedAll.length; i++) {
@@ -266,7 +283,7 @@ export function createTodoTxtTaskSource(config, context) {
             if (parsed === null || parsed === undefined) {
                 continue;
             }
-            if (!isActiveForFetch(parsed, todayIsoDate)) {
+            if (!isActiveForFetch(parsed, nowIsoLocal)) {
                 continue;
             }
             const issue = buildIssue({

package/dist/lib/adapters/todo-txt/writeback.d.ts

@@ -1,4 +1,4 @@
-import type { TodoTxtSourceRef } from "./normalizer.ts";
+import { type TodoTxtSourceRef } from "./normalizer.ts";
 export interface RecurResult {
     newId: string;
     newTodoLine: string;

package/dist/lib/adapters/todo-txt/writeback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeback.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/writeback.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAkKD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,gBAAgB,CAAC;IACtB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQxF;AAED,KAAK,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;AAgF3D,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAsElC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQrE;AAgGD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAChC,MAAM,EAAE,CA0CV"}
+{"version":3,"file":"writeback.d.ts","sourceRoot":"","sources":["../../../../src/lib/adapters/todo-txt/writeback.ts"],"names":[],"mappings":"AAYA,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AA2KD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,gBAAgB,CAAC;IACtB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAQxF;AAED,KAAK,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;AAiF3D,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAsElC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQrE;AAwGD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAChC,MAAM,EAAE,CA0CV"}

package/dist/lib/adapters/todo-txt/writeback.js

@@ -1,6 +1,7 @@
 import { closeSync, mkdirSync, openSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
 import path from "node:path";
 import { DATE_RE, hashLine, parseAllLines } from "./parser.js";
+import { isValidThresholdValue } from "./normalizer.js";
 function isoDate(date) {
     return date.toISOString().slice(0, 10);
 }
@@ -53,6 +54,14 @@ function advanceDate(dateStr, rec) {
     }
     return addMonths(dateStr, amount * 12);
 }
+// t: may carry a datetime threshold; advance its date part and keep the time
+// component so a recurring task stays scheduled at the same instant of day.
+function advanceThreshold(threshold, rec) {
+    const [datePart, timePart] = threshold.split("T");
+    /* v8 ignore next @preserve -- split always yields a first element */
+    const nextDate = advanceDate(datePart ?? threshold, rec);
+    return timePart === undefined ? nextDate : `${nextDate}T${timePart}`;
+}
 function advanceId(id, newDate) {
     const dateCompact = compactDate(newDate);
     // Replace the first 8-digit run (compact date) in the id
@@ -179,12 +188,13 @@ function buildRecurResult(parsed, parsedAll, originalLine, ref, completionDateSt
     /* v8 ignore next @preserve -- oldDue undefined means skip due advancement */
     const newDue = oldDue === undefined ? undefined : advanceDate(dueBase, rec);
     // t: always advances from its own current value by the same period
-    const newT = oldT === undefined ? undefined : advanceDate(oldT, rec);
+    const newT = oldT === undefined ? undefined : advanceThreshold(oldT, rec);
     // Compute new date for id advancement: prefer due:, then t:, so ids stay
-    // schedule-aligned for t:-only recurring tasks
+    // schedule-aligned for t:-only recurring tasks. Slice to the date part —
+    // t: may carry a datetime.
     const newScheduleDate = newDue ?? newT;
     /* v8 ignore next @preserve -- rec: without due: or t: is unusual; id falls back to completion date */
-    const newDateForId = newScheduleDate === undefined ? now : new Date(`${newScheduleDate}T00:00:00Z`);
+    const newDateForId = newScheduleDate === undefined ? now : new Date(`${newScheduleDate.slice(0, 10)}T00:00:00Z`);
     const baseNewId = advanceId(ref.id, newDateForId);
     const newId = buildUniqueId(baseNewId, existingIds);
     const newTodoLine = buildRecurringLine(originalLine, ref.id, newId, oldDue, newDue, oldT, newT);
@@ -286,11 +296,16 @@ function validateDepsAndDates(parsed, parsedAll, id, prefix, errors) {
             errors.push(`${prefix}: unresolved dep "${depId}" for task "${id}"`);
         }
     }
-    for (const dateField of ["due", "t"]) {
-        const dateVal = parsed.metadata[dateField]?.[0];
-        if (dateVal !== undefined && !DATE_RE.test(dateVal)) {
-            errors.push(`${prefix}: malformed ${dateField}: date "${dateVal}" for task "${id}" (expected YYYY-MM-DD)`);
-        }
+    const dueVal = parsed.metadata["due"]?.[0];
+    if (dueVal !== undefined && !DATE_RE.test(dueVal)) {
+        errors.push(`${prefix}: malformed due: date "${dueVal}" for task "${id}" (expected YYYY-MM-DD)`);
+    }
+    // t: also accepts a datetime threshold for sub-day recurring tasks.
+    // Calendar/clock validity is enforced for both forms — a non-calendar value
+    // would otherwise crash rec: advancement during markDone.
+    const tVal = parsed.metadata["t"]?.[0];
+    if (tVal !== undefined && !isValidThresholdValue(tVal)) {
+        errors.push(`${prefix}: malformed t: date "${tVal}" for task "${id}" (expected YYYY-MM-DD or YYYY-MM-DDTHH:MM[:SS])`);
     }
     const recVal = parsed.metadata["rec"]?.[0];
     if (recVal !== undefined && parseRecurrence(recVal) === undefined) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clipboard-health/groundcrew",
-  "version": "4.32.0",
+  "version": "4.33.0",
   "description": "Linear-driven orchestrator that launches AI coding agents in git worktrees, with workspace lifecycle and usage tracking.",
   "keywords": [
     "agent",