@clipboard-health/groundcrew 4.26.1 → 4.27.0

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

@@ -18,5 +18,5 @@ export interface NormalizeOptions {
     updatedAt: string;
 }
 export declare function normalizeToIssue(options: NormalizeOptions): Issue | undefined;
-export declare function isActiveForFetch(parsed: ParsedTodoLine): boolean;
+export declare function isActiveForFetch(parsed: ParsedTodoLine, todayIsoDate: 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,EAA8C,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9F,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,GAAG,OAAO,CAShE"}
+{"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"}

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 { getMetadataAll, getMetadataFirst, hashLine } from "./parser.js";
+import { DATE_RE, getMetadataAll, getMetadataFirst, hashLine, } from "./parser.js";
 function derivedCanonicalStatus(parsed) {
     if (parsed.completed) {
         return "done";
@@ -90,7 +90,7 @@ export function normalizeToIssue(options) {
         sourceRef,
     };
 }
-export function isActiveForFetch(parsed) {
+export function isActiveForFetch(parsed, todayIsoDate) {
     if (parsed.completed) {
         return false;
     }
@@ -98,5 +98,28 @@ export function isActiveForFetch(parsed) {
         return false;
     }
     const statusValue = getMetadataFirst(parsed, "status");
-    return statusValue === "todo" || statusValue === "in-progress" || statusValue === "in-review";
+    if (statusValue === "todo") {
+        return !isDeferredByThreshold(parsed, todayIsoDate);
+    }
+    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) {
+    const threshold = getMetadataFirst(parsed, "t");
+    if (threshold === undefined || !DATE_RE.test(threshold) || !isCalendarDate(threshold)) {
+        return false;
+    }
+    // ISO YYYY-MM-DD dates order lexicographically
+    return threshold > todayIsoDate;
+}
+// DATE_RE is format-only; non-calendar values like 2026-99-99 would compare
+// greater than any real date and defer the task forever.
+function isCalendarDate(value) {
+    const monthIndex = Number(value.slice(5, 7)) - 1;
+    const day = Number(value.slice(8, 10));
+    const date = new Date(Date.UTC(Number(value.slice(0, 4)), monthIndex, day));
+    return date.getUTCMonth() === monthIndex && date.getUTCDate() === day;
 }

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

@@ -12,6 +12,7 @@ export interface ParsedTodoLine {
     /** True when the final meaningful whitespace-delimited token is a `status:X` field. */
     readonly isStatusFinalToken: boolean;
 }
+export declare const DATE_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;AAQD,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;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"}

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

@@ -1,5 +1,5 @@
 import { createHash } from "node:crypto";
-const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+export const DATE_RE = /^\d{4}-\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;AA0RxD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,cAAc,GACtB,UAAU,CAqJZ"}
+{"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"}

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

@@ -5,9 +5,8 @@ import { AGENT_ANY } from "../../config.js";
 import { toCanonicalId, } from "../../taskSource.js";
 import { readEnvironmentVariable } from "../../util.js";
 import { isActiveForFetch, normalizeToIssue } from "./normalizer.js";
-import { getMetadataFirst, parseAllLines } from "./parser.js";
+import { DATE_RE, getMetadataFirst, parseAllLines } from "./parser.js";
 import { copyPromptFile, updateTaskStatus, validateTodoFile, withLock } from "./writeback.js";
-const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
 const RECURRENCE_RE = /^\+?\d+[dwmy]$/;
 function readPromptFile(promptPath) {
     try {
@@ -95,7 +94,7 @@ function metadataToken(key, value) {
     assertToken(`${key}: value`, value);
     return `${key}:${value}`;
 }
-function datePartFor(timeZone, now) {
+function isoDateFor(timeZone, now) {
     const parts = new Intl.DateTimeFormat("en-CA", {
         timeZone,
         year: "numeric",
@@ -109,7 +108,10 @@ function datePartFor(timeZone, now) {
     if (year === undefined || month === undefined || day === undefined) {
         throw new Error(`todo-txt: could not format date in timezone "${timeZone}"`);
     }
-    return `${year}${month}${day}`;
+    return `${year}-${month}-${day}`;
+}
+function datePartFor(timeZone, now) {
+    return isoDateFor(timeZone, now).replaceAll("-", "");
 }
 /* v8 ignore next @preserve -- Covered in source tests; full-suite V8 coverage remaps this helper inconsistently. */
 function nextGeneratedId(config, parsedAll) {
@@ -256,6 +258,7 @@ export function createTodoTxtTaskSource(config, context) {
     ]);
     function listTasks() {
         const updatedAt = fileUpdatedAt(todoPath);
+        const todayIsoDate = isoDateFor(config.timezone, new Date());
         const { parsedAll } = readAndParseTodo(todoPath);
         const issues = [];
         for (let i = 0; i < parsedAll.length; i++) {
@@ -263,7 +266,7 @@ export function createTodoTxtTaskSource(config, context) {
             if (parsed === null || parsed === undefined) {
                 continue;
             }
-            if (!isActiveForFetch(parsed)) {
+            if (!isActiveForFetch(parsed, todayIsoDate)) {
                 continue;
             }
             const issue = buildIssue({

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;AAoKD,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;AA6E3D,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,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"}

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

@@ -1,7 +1,6 @@
 import { closeSync, mkdirSync, openSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
 import path from "node:path";
-import { hashLine, parseAllLines } from "./parser.js";
-const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+import { DATE_RE, hashLine, parseAllLines } from "./parser.js";
 function isoDate(date) {
     return date.toISOString().slice(0, 10);
 }
@@ -181,9 +180,11 @@ function buildRecurResult(parsed, parsedAll, originalLine, ref, completionDateSt
     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);
-    // Compute new date for id advancement
-    /* v8 ignore next @preserve -- newDue undefined when no due: field; rare edge case */
-    const newDateForId = newDue === undefined ? now : new Date(`${newDue}T00:00:00Z`);
+    // Compute new date for id advancement: prefer due:, then t:, so ids stay
+    // schedule-aligned for t:-only recurring tasks
+    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 baseNewId = advanceId(ref.id, newDateForId);
     const newId = buildUniqueId(baseNewId, existingIds);
     const newTodoLine = buildRecurringLine(originalLine, ref.id, newId, oldDue, newDue, oldT, newT);

package/package.json

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