@clipboard-health/groundcrew 4.32.1 → 4.34.0

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,CAyJZ"}

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

@@ -7,7 +7,7 @@ import { readEnvironmentVariable } from "../../util.js";
 import { isActiveForFetch, normalizeToIssue } from "./normalizer.js";
 import { DATE_RE, getMetadataFirst, parseAllLines } from "./parser.js";
 import { copyPromptFile, updateTaskStatus, validateTodoFile, withLock } from "./writeback.js";
-const RECURRENCE_RE = /^\+?\d+[dwmy]$/;
+const RECURRENCE_RE = /^\+?\d+[dwmyh]$/;
 function readPromptFile(promptPath) {
     try {
         return readFileSync(promptPath, "utf8");
@@ -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());
@@ -180,7 +197,7 @@ function buildTodoLine(id, input) {
     }
     if (input.recurrence !== undefined) {
         if (!RECURRENCE_RE.test(input.recurrence)) {
-            throw new Error("todo-txt: recurrence must look like 1d, 1w, 1m, 1y, or +1m");
+            throw new Error("todo-txt: recurrence must look like 1d, 1w, 1m, 1y, 2h, or +1m");
         }
         tokens.push(metadataToken("rec", input.recurrence));
     }
@@ -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({
@@ -363,7 +380,7 @@ export function createTodoTxtTaskSource(config, context) {
         async markDone(issue) {
             // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- TodoTxtTaskSource always writes TodoTxtSourceRef
             const ref = issue.sourceRef;
-            const recurResult = await updateTaskStatus({ todoPath, ref }, "done");
+            const recurResult = await updateTaskStatus({ todoPath, ref, timezone: config.timezone }, "done");
             if (recurResult !== undefined) {
                 copyPromptFile(recurResult.oldPromptPath, recurResult.newPromptPath);
             }

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;
@@ -9,6 +9,8 @@ export interface UpdateOptions {
     todoPath: string;
     ref: TodoTxtSourceRef;
     now?: Date;
+    /** Source timezone for hour-unit recurrence wall-clock math. Defaults to UTC. */
+    timezone?: string;
 }
 export declare function withLock<T>(lockPath: string, fn: () => T | Promise<T>): Promise<T>;
 type StatusMutation = "in-progress" | "in-review" | "done";

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;AAqOD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,gBAAgB,CAAC;IACtB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;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;AAwF3D,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA+ElC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQrE;AA8GD,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);
 }
@@ -22,15 +23,15 @@ function addMonths(dateStr, months) {
     const d = new Date(Date.UTC(year, month - 1 + months, day));
     return isoDate(d);
 }
-const REC_RE = /^(?<strict>\+?)(?<amount>\d+)(?<unit>[dwmy])$/;
+const REC_RE = /^(?<strict>\+?)(?<amount>\d+)(?<unit>[dwmyh])$/;
 function parseRecurrence(rec) {
     const m = REC_RE.exec(rec);
     if (m === null) {
         return undefined;
     }
     const [, strictStr, amountStr, unit] = m;
-    /* v8 ignore next @preserve -- regex [dwmy] guarantees unit is always one of d/w/m/y */
-    if (unit !== "d" && unit !== "w" && unit !== "m" && unit !== "y") {
+    /* v8 ignore next @preserve -- regex [dwmyh] guarantees unit is always one of d/w/m/y/h */
+    if (unit !== "d" && unit !== "w" && unit !== "m" && unit !== "y" && unit !== "h") {
         return undefined;
     }
     return {
@@ -53,11 +54,73 @@ function advanceDate(dateStr, rec) {
     }
     return addMonths(dateStr, amount * 12);
 }
+// Add hours to a (timezone-naive wall-clock) datetime, minute precision.
+function addHours(dateTime, hours) {
+    const padded = dateTime.length === 16 ? `${dateTime}:00` : dateTime;
+    const ms = Date.parse(`${padded}Z`);
+    return new Date(ms + hours * 60 * 60 * 1000).toISOString().slice(0, 16);
+}
+// 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.
+//
+// Hour units advance differently: non-strict rec:Nh advances from the
+// completion instant (the source-timezone wall clock), so a task that sat
+// through daemon downtime re-arms N hours from now instead of stampeding
+// through every missed slot. Strict rec:+Nh keeps schedule-aligned
+// advancement from the previous threshold, matching due:'s strict semantics.
+function advanceThreshold(threshold, rec, completionWall) {
+    if (rec.unit === "h") {
+        let base = completionWall;
+        if (rec.strict) {
+            base = threshold.length === 10 ? `${threshold}T00:00` : threshold;
+        }
+        return addHours(base, rec.amount);
+    }
+    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}`;
+}
+// "YYYY-MM-DDTHH:MM" wall-clock time for `now` in the given timezone.
+function wallClockDateTime(timeZone, now) {
+    const parts = new Intl.DateTimeFormat("en-CA", {
+        timeZone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        hourCycle: "h23",
+    }).formatToParts(now);
+    const get = (type) => parts.find((part) => part.type === type)?.value;
+    const year = get("year");
+    const month = get("month");
+    const day = get("day");
+    const hour = get("hour");
+    const minute = get("minute");
+    /* v8 ignore next 3 @preserve -- Intl.DateTimeFormat with these options always returns the parts */
+    if (year === undefined ||
+        month === undefined ||
+        day === undefined ||
+        hour === undefined ||
+        minute === undefined) {
+        throw new Error(`todo-txt: could not format datetime in timezone "${timeZone}"`);
+    }
+    return `${year}-${month}-${day}T${hour}:${minute}`;
+}
 function advanceId(id, newDate) {
     const dateCompact = compactDate(newDate);
     // Replace the first 8-digit run (compact date) in the id
     const replaced = id.replace(/\d{8}/, dateCompact);
-    return replaced === id ? `${id}-${dateCompact}` : replaced;
+    if (replaced !== id) {
+        return replaced;
+    }
+    // Unchanged: either the id has no date run (append one), or the date run
+    // already equals the new date — same-day hourly recurrence. For the latter,
+    // strip any prior collision suffixes and let buildUniqueId number this
+    // cycle (-002, -003, …) instead of growing a suffix chain.
+    const base = id.replace(/(?:-\d{3})+$/, "");
+    return base.includes(dateCompact) ? base : `${id}-${dateCompact}`;
 }
 function buildUniqueId(baseNewId, existingIds) {
     if (existingIds.has(baseNewId.toLowerCase())) {
@@ -157,7 +220,7 @@ function assertValidTransition(newStatus, currentStatus, id) {
         throw new Error(`todo-txt: cannot mark done: task "${id}" has status "${s}"`);
     }
 }
-function buildRecurResult(parsed, parsedAll, originalLine, ref, completionDateStr, now) {
+function buildRecurResult(parsed, parsedAll, originalLine, ref, completionDateStr, completionWallStr, now) {
     const recStr = parsed.metadata["rec"]?.[0];
     if (recStr === undefined) {
         return undefined;
@@ -173,18 +236,25 @@ function buildRecurResult(parsed, parsedAll, originalLine, ref, completionDateSt
         .filter((id) => id !== undefined));
     const oldDue = parsed.metadata["due"]?.[0];
     const oldT = parsed.metadata["t"]?.[0];
-    // due: advances from old due (strict) or completion date (normal)
+    // due: advances from old due (strict) or completion date (normal). Hour
+    // units never advance due: — validate() rejects the combination, and a line
+    // that bypassed verify carries its due forward unchanged rather than
+    // feeding an hour recurrence into date-only math.
     /* v8 ignore next @preserve -- oldDue undefined with rec: is unusual; callers typically pair rec: with due: */
     const dueBase = rec.strict ? (oldDue ?? completionDateStr) : completionDateStr;
-    /* 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);
+    let newDue;
+    if (oldDue !== undefined) {
+        newDue = rec.unit === "h" ? oldDue : advanceDate(dueBase, rec);
+    }
+    // t: advances from its own current value by the same period (hour units:
+    // see advanceThreshold for strict vs non-strict base)
+    const newT = oldT === undefined ? undefined : advanceThreshold(oldT, rec, completionWallStr);
     // 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);
@@ -237,8 +307,9 @@ export async function updateTaskStatus(options, newStatus) {
         let updatedLine;
         if (newStatus === "done") {
             const completionDateStr = isoDate(now);
+            const completionWallStr = wallClockDateTime(options.timezone ?? "UTC", now);
             updatedLine = buildDoneLine(originalLine, completionDateStr);
-            recurResult = buildRecurResult(parsed, parsedAll, originalLine, ref, completionDateStr, now);
+            recurResult = buildRecurResult(parsed, parsedAll, originalLine, ref, completionDateStr, completionWallStr, now);
         }
         else {
             updatedLine = replaceStatusToken(originalLine, newStatus);
@@ -286,15 +357,24 @@ 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) {
-        errors.push(`${prefix}: malformed rec: "${recVal}" for task "${id}" (expected e.g. 1d, 1w, +1m)`);
+    const recParsed = recVal === undefined ? undefined : parseRecurrence(recVal);
+    if (recParsed?.unit === "h" && (tVal === undefined || dueVal !== undefined)) {
+        errors.push(`${prefix}: hourly rec: "${recVal}" for task "${id}" requires a t: threshold and is incompatible with due:`);
+    }
+    if (recVal !== undefined && recParsed === undefined) {
+        errors.push(`${prefix}: malformed rec: "${recVal}" for task "${id}" (expected e.g. 1d, 1w, +1m, 2h)`);
     }
 }
 function validateActiveTaskLine(parsed, parsedAll, tasksDir, id, prefix, errors, knownAgents) {

package/package.json

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