things-api 0.9.0 → 0.11.0

package/dist/model/entities.d.ts

@@ -12,6 +12,27 @@ export type TaskType = "to-do" | "project" | "heading";
 export interface Ref {
     uuid: string;
     title: string;
+    /**
+     * Set (and only ever `true`) when this ref points at a repeating-template
+     * PROJECT — the blueprint row whose `rt1_recurrenceRule`/`repeater` is
+     * non-null (probe-verified: the template's CHILDREN are plain rows, so the
+     * fact lives on the parent project). Only container/project refs ever carry
+     * it — area and heading refs never do — so a consumer reads its absence as
+     * "not a template". It disambiguates the two identical-looking same-title
+     * copies a project conversion leaves behind (the template blueprint vs. its
+     * spawned instance; see RepeatingInfo). Omitted when false (never `false`).
+     */
+    isRepeatingTemplate?: true;
+}
+/**
+ * A surfaced tag: its NAME only. Tag uuids are a fully internal implementation
+ * detail (like checklist item ids) — names are app-enforced-unique (TAGW1-c),
+ * so a name is a sufficient reference, and no surface emits or accepts a tag
+ * uuid. Nested-tag context, where it matters, is conveyed by the tag listing's
+ * `parent` field, not here on the pill.
+ */
+export interface TagRef {
+    title: string;
 }
 export interface RepeatingInfo {
     /** This row is a repeating template (rt1_recurrenceRule / repeater present). Invisible in normal lists. */
@@ -51,19 +72,29 @@ interface TaskCommon {
     /** The "When" date (packed int in DB), null when unscheduled. */
     startDate: IsoDate | null;
     /**
-     * Raw This-Evening assignment (startBucket). Effective only while
-     * startDate == today — the UI rolls stale evening items back into Today
-     * proper. Use TodayView.evening for UI-faithful placement.
+     * Today-view section ("today" | "evening"), emitted ONLY for items actually
+     * in Today under the evaluation clock: start=active, dated, and not
+     * future-scheduled (overdue rows stay in Today). Anytime (undated) and
+     * Upcoming (future startDate) rows carry a raw startBucket in the DB but are
+     * NOT in Today, so the field is null (omitted) for them. Use
+     * TodayView.evening for UI-faithful placement.
      */
     todaySection: TodaySection | null;
     deadline: IsoDate | null;
     /** Time-of-day reminder (`HH:mm`, 24h); requires a scheduled startDate. */
     reminder: ReminderTime | null;
     area: Ref | null;
-    /** Direct tags only — mirrors DB truth (inherited tags are computed; see inheritedTags). */
-    tags: Ref[];
-    /** Opt-in: tags inherited from ancestor area/project (native UI filtering includes these). */
-    inheritedTags?: Ref[];
+    /** Direct tags only, by name — mirrors DB truth (inherited tags are computed; see inheritedTags). */
+    tags: TagRef[];
+    /**
+     * Tags inherited from an ancestor project/area, by NAME — a plain list
+     * parallel to {@link tags} (native UI tag filtering includes these — T18).
+     * Populated on the detail/card reads (`todo show`, `project show`) as an
+     * array (empty when there are none); the emit-time omit-empty transform (#163)
+     * drops it from JSON when empty, and it is absent (undefined) on list rows,
+     * which surface direct tags only. Never merged into {@link tags}.
+     */
+    inheritedTags?: TagRef[];
     repeating: RepeatingInfo;
     created: Date;
     modified: Date;
@@ -102,13 +133,20 @@ export interface Area {
     uuid: string;
     title: string;
     visible: boolean;
-    tags: Ref[];
+    tags: TagRef[];
 }
+/**
+ * A tag in the `things tags` taxonomy listing. Uuid-free (an internal detail):
+ * the tree is conveyed by `parent` — the parent tag's NAME (null for a root) —
+ * so a consumer can reconstruct the hierarchy, and by indentation in the human
+ * render. Names are globally unique (TAGW1-c), so the leaf name alone is a
+ * usable tag reference.
+ */
 export interface Tag {
-    uuid: string;
     title: string;
     shortcut: string | null;
-    parent: Ref | null;
+    /** Parent tag's NAME, or null for a root tag. */
+    parent: string | null;
 }
 /**
  * A checklist item as the API surfaces it: title + status only. The DB uuid

package/dist/model/entities.js.map

@@ -1 +1 @@
-{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/model/entities.ts"],"names":[],"mappings":"AA+IA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAA6B;IACzD,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,SAAS;CACb,CAAC;AACF,MAAM,CAAC,MAAM,mBAAmB,GAA+B;IAC7D,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,WAAW;CACf,CAAC;AACF,MAAM,CAAC,MAAM,mBAAmB,GAA+B;IAC7D,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,SAAS;CACb,CAAC;AACF,MAAM,CAAC,MAAM,qBAAqB,GAAiC;IACjE,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,SAAS;CACb,CAAC"}
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/model/entities.ts"],"names":[],"mappings":"AAsLA,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAA6B;IACzD,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,SAAS;CACb,CAAC;AACF,MAAM,CAAC,MAAM,mBAAmB,GAA+B;IAC7D,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,UAAU;IACb,CAAC,EAAE,WAAW;CACf,CAAC;AACF,MAAM,CAAC,MAAM,mBAAmB,GAA+B;IAC7D,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,SAAS;CACb,CAAC;AACF,MAAM,CAAC,MAAM,qBAAqB,GAAiC;IACjE,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,SAAS;CACb,CAAC"}

package/dist/model/mappers.d.ts

@@ -22,6 +22,13 @@ export interface TaskRow {
     index: number | null;
     todayIndex: number | null;
     area: string | null;
+    /**
+     * The row's EFFECTIVE area (queries.ts EFFECTIVE_AREA): its own `area`, else
+     * its project's, else its heading's project's. Equals `area` for projects and
+     * for area-direct to-dos; resolves the container's area for nested to-dos
+     * (whose own `area` is NULL). Surfaced as the entity's `area` Ref.
+     */
+    effectiveArea: string | null;
     project: string | null;
     heading: string | null;
     untrashedLeafActionsCount: number | null;
@@ -49,7 +56,7 @@ export type RefResolver = (uuid: string | null) => Ref | null;
 export declare class EnumDomainError extends RangeError {
     constructor(field: string, value: unknown, uuid: string);
 }
-export declare function mapTodo(row: TaskRow, refs: RefResolver, tags: Ref[]): Todo;
-export declare function mapProject(row: TaskRow, refs: RefResolver, tags: Ref[]): Project;
+export declare function mapTodo(row: TaskRow, refs: RefResolver, tags: Ref[], packedToday: number): Todo;
+export declare function mapProject(row: TaskRow, refs: RefResolver, tags: Ref[], packedToday: number): Project;
 export declare function mapHeading(row: TaskRow, refs: RefResolver): Heading;
 export declare function mapChecklistItem(row: ChecklistRow): ChecklistItem;

package/dist/model/mappers.js

@@ -23,12 +23,30 @@ function mapStart(row) {
         throw new EnumDomainError("start", row.start, row.uuid);
     return start;
 }
-function mapTodaySection(row) {
+/**
+ * `todaySection` is meaningful ONLY for items actually in the Today view. The
+ * DB stores a raw `startBucket` (0/1) on EVERY active row — prod carries
+ * startBucket=0 on every undated Anytime to-do, and future-scheduled
+ * (Upcoming) rows carry it too — so the raw bucket cannot be surfaced as-is:
+ * emitting "today" for an Anytime/Upcoming item wrongly implies Today
+ * membership (architecture.md; the MCP server note). We gate on the injected
+ * clock's `packedToday`: the field is emitted only when the row is active,
+ * dated, and not future-scheduled ("evening" via startBucket=1, else "today");
+ * overdue scheduled rows (startDate < today) stay in Today and keep it.
+ * Undated or future-dated rows OMIT the field (null).
+ */
+function mapTodaySection(row, packedToday) {
     if (row.startBucket === null)
         return null;
     const section = TODAY_SECTION_FROM_DB[row.startBucket];
     if (!section)
         throw new EnumDomainError("startBucket", row.startBucket, row.uuid);
+    if ((row.start ?? 0) !== 1)
+        return null; // not start=active → not in Today
+    if (row.startDate === null)
+        return null; // undated (Anytime)
+    if (row.startDate > packedToday)
+        return null; // future startDate (Upcoming)
     return section;
 }
 function mapRepeating(row) {
@@ -47,7 +65,7 @@ function mapRepeating(row) {
     }
     return info;
 }
-function commonFields(row, refs, tags) {
+function commonFields(row, refs, tags, packedToday) {
     return {
         uuid: row.uuid,
         title: row.title ?? "",
@@ -60,7 +78,7 @@ function commonFields(row, refs, tags) {
         trashed: row.trashed === 1,
         start: mapStart(row),
         startDate: decodePackedDate(row.startDate),
-        todaySection: mapTodaySection(row),
+        todaySection: mapTodaySection(row, packedToday),
         // A template's own `deadline` column is not a real date: it is NULL
         // (deadline-less) or a far-future sentinel (4001-01-01, deadlined) that
         // flags whether spawned instances deadline. Surface it via
@@ -69,17 +87,22 @@ function commonFields(row, refs, tags) {
             ? null
             : decodePackedDate(row.deadline),
         reminder: decodeReminderTime(row.reminderTime),
-        area: refs(row.area),
-        tags,
+        // The EFFECTIVE area: a to-do nested in a project (own `area` NULL) reports
+        // its container's area, restoring useful area info omit-empty (#163) would
+        // otherwise hide. Projects and area-direct to-dos are unaffected (effective
+        // == direct). Direct-vs-inherited stays derivable from project/heading.
+        area: refs(row.effectiveArea),
+        // Surface tags by NAME only — tag uuids are an internal detail (TAGW1-c).
+        tags: tags.map((t) => ({ title: t.title })),
         repeating: mapRepeating(row),
         created: decodeEpochReal(row.creationDate) ?? new Date(0),
         modified: decodeEpochReal(row.userModificationDate) ?? new Date(0),
         stopped: decodeEpochReal(row.stopDate),
     };
 }
-export function mapTodo(row, refs, tags) {
+export function mapTodo(row, refs, tags, packedToday) {
     return {
-        ...commonFields(row, refs, tags),
+        ...commonFields(row, refs, tags, packedToday),
         type: "to-do",
         project: refs(row.project),
         heading: refs(row.heading),
@@ -87,9 +110,9 @@ export function mapTodo(row, refs, tags) {
         openChecklistItemsCount: row.openChecklistItemsCount ?? 0,
     };
 }
-export function mapProject(row, refs, tags) {
+export function mapProject(row, refs, tags, packedToday) {
     return {
-        ...commonFields(row, refs, tags),
+        ...commonFields(row, refs, tags, packedToday),
         type: "project",
         untrashedLeafActionsCount: row.untrashedLeafActionsCount ?? 0,
         openUntrashedLeafActionsCount: row.openUntrashedLeafActionsCount ?? 0,

package/dist/model/mappers.js.map

@@ -1 +1 @@
-{"version":3,"file":"mappers.js","sourceRoot":"","sources":["../../src/model/mappers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mappers.js","sourceRoot":"","sources":["../../src/model/mappers.ts"],"names":[],"mappings":"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"}

package/dist/model/serialize.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The emit-time omit-empty transform for entity/data payloads (the "Omit-empty"
+ * contract in docs/design/contracts.md). Applied at the JSON emit boundary of
+ * the read surfaces ONLY — the CLI `--json` read envelope (src/cli/read-driver.ts)
+ * and the MCP read tool results (src/mcp/server.ts) — never to the in-memory
+ * entities the library returns, and never to the error envelope.
+ *
+ * The rule: an ENTITY object omits any optional field whose value is empty —
+ * null, undefined, "" (empty string), or [] (empty array). A consumer MUST
+ * read an absent key as unset/empty/default and MUST NOT distinguish absent
+ * from empty. Values that are semantically meaningful when "empty" are kept:
+ * booleans (a real `false`) and numbers (a `0` count) are never omitted, and
+ * the identity keys ({@link IDENTITY_KEYS}) are always present.
+ *
+ * Why entity-scoped, not a blanket deep prune: the same key means opposite
+ * things on different shapes. A to-do's `area: null` is "no area" (omit), but a
+ * sidebar section's `area: null` is the load-bearing "top-level/loose block"
+ * discriminant (keep). So pruning is gated to the recognized entity shapes;
+ * the view scaffolding that CARRIES entities (today/evening split, project/area
+ * card sections, grouped blocks) is structural and passes through untouched —
+ * only its nested entities are pruned.
+ */
+/**
+ * Return a deep copy of `payload` with every entity's empty optional fields
+ * omitted (the "Omit-empty" contract). Pure — the input is never mutated, so
+ * the human-render path keeps the full entity beside the JSON emit.
+ */
+export declare function omitEmpty<T>(payload: T): T;

package/dist/model/serialize.js

@@ -0,0 +1,80 @@
+/**
+ * The emit-time omit-empty transform for entity/data payloads (the "Omit-empty"
+ * contract in docs/design/contracts.md). Applied at the JSON emit boundary of
+ * the read surfaces ONLY — the CLI `--json` read envelope (src/cli/read-driver.ts)
+ * and the MCP read tool results (src/mcp/server.ts) — never to the in-memory
+ * entities the library returns, and never to the error envelope.
+ *
+ * The rule: an ENTITY object omits any optional field whose value is empty —
+ * null, undefined, "" (empty string), or [] (empty array). A consumer MUST
+ * read an absent key as unset/empty/default and MUST NOT distinguish absent
+ * from empty. Values that are semantically meaningful when "empty" are kept:
+ * booleans (a real `false`) and numbers (a `0` count) are never omitted, and
+ * the identity keys ({@link IDENTITY_KEYS}) are always present.
+ *
+ * Why entity-scoped, not a blanket deep prune: the same key means opposite
+ * things on different shapes. A to-do's `area: null` is "no area" (omit), but a
+ * sidebar section's `area: null` is the load-bearing "top-level/loose block"
+ * discriminant (keep). So pruning is gated to the recognized entity shapes;
+ * the view scaffolding that CARRIES entities (today/evening split, project/area
+ * card sections, grouped blocks) is structural and passes through untouched —
+ * only its nested entities are pruned.
+ */
+/**
+ * Keys never omitted from an entity even when empty: the identity a consumer
+ * always keys on. `uuid`/`type` are never empty in practice; `title`/`name`
+ * can be "" (an untitled to-do) and MUST still be present.
+ */
+const IDENTITY_KEYS = new Set(["uuid", "type", "title", "name"]);
+/** A to-do/project/heading row: uuid + a task-type discriminant. */
+function isTaskEntity(o) {
+    return (typeof o["uuid"] === "string" &&
+        (o["type"] === "to-do" || o["type"] === "project" || o["type"] === "heading"));
+}
+/** An area: uuid + the `visible` flag (distinguishes it from a bare Ref). */
+function isAreaEntity(o) {
+    return typeof o["uuid"] === "string" && typeof o["visible"] === "boolean";
+}
+/** A taxonomy tag row (uuid-free): a title plus the parent/shortcut columns. */
+function isTagEntity(o) {
+    return (o["uuid"] === undefined && typeof o["title"] === "string" && "parent" in o && "shortcut" in o);
+}
+/** Whether this object's empty optional fields should be omitted. */
+function prunesEmpties(o) {
+    return isTaskEntity(o) || isAreaEntity(o) || isTagEntity(o);
+}
+/** null | undefined | "" | [] — the values an entity omits the key for. */
+function isEmpty(v) {
+    return v === null || v === undefined || v === "" || (Array.isArray(v) && v.length === 0);
+}
+function prune(value) {
+    if (value === null || value === undefined)
+        return value;
+    // Dates serialize to ISO strings via JSON.stringify — never recurse into them.
+    if (value instanceof Date)
+        return value;
+    if (Array.isArray(value))
+        return value.map(prune);
+    if (typeof value === "object") {
+        const o = value;
+        const omitEmpties = prunesEmpties(o);
+        const out = {};
+        for (const key of Object.keys(o)) {
+            const v = o[key];
+            if (omitEmpties && !IDENTITY_KEYS.has(key) && isEmpty(v))
+                continue;
+            out[key] = prune(v);
+        }
+        return out;
+    }
+    return value;
+}
+/**
+ * Return a deep copy of `payload` with every entity's empty optional fields
+ * omitted (the "Omit-empty" contract). Pure — the input is never mutated, so
+ * the human-render path keeps the full entity beside the JSON emit.
+ */
+export function omitEmpty(payload) {
+    return prune(payload);
+}
+//# sourceMappingURL=serialize.js.map

package/dist/model/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../src/model/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;GAIG;AACH,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAItF,oEAAoE;AACpE,SAAS,YAAY,CAAC,CAAM;IAC1B,OAAO,CACL,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ;QAC7B,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,CAC9E,CAAC;AACJ,CAAC;AAED,6EAA6E;AAC7E,SAAS,YAAY,CAAC,CAAM;IAC1B,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,SAAS,CAAC;AAC5E,CAAC;AAED,gFAAgF;AAChF,SAAS,WAAW,CAAC,CAAM;IACzB,OAAO,CACL,CAAC,CAAC,MAAM,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,QAAQ,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,CAC9F,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,SAAS,aAAa,CAAC,CAAM;IAC3B,OAAO,YAAY,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,2EAA2E;AAC3E,SAAS,OAAO,CAAC,CAAU;IACzB,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,KAAK,CAAC,KAAc;IAC3B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,+EAA+E;IAC/E,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,KAAY,CAAC;QACvB,MAAM,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,GAAG,GAAQ,EAAE,CAAC;QACpB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YACjB,IAAI,WAAW,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC;gBAAE,SAAS;YACnE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAI,OAAU;IACrC,OAAO,KAAK,CAAC,OAAO,CAAM,CAAC;AAC7B,CAAC"}

package/dist/model/when-sugar.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The `<when>@<time>` scheduling sugar, shared by every consumer surface. A
+ * single string like `2026-07-05@09:00` (or `today@evening`-style keyword +
+ * time) carries BOTH the schedule and its reminder; this splits it into the
+ * separate `when` + `reminder` the write pipeline expects, or reports the one
+ * usage error. Extracted from the CLI so the CLI and MCP validate the suffix
+ * identically instead of each re-deriving it — see docs/design/architecture.md
+ * (Consumer boundary).
+ *
+ * Pure: it neither mutates its input nor validates the DATE/TIME values (the
+ * pipeline does that downstream) — it only owns the `@` split and the two
+ * usage messages. The flag/parameter LABELS are injected so each surface keeps
+ * its own vocabulary (`--when`/`--reminder` vs `when`/`reminder`).
+ */
+/** The surface's spelling of the two parameters, interpolated into usage copy. */
+export interface WhenSugarLabels {
+    when: string;
+    reminder: string;
+}
+/** CLI flag spellings — the default, since the sugar originated there. */
+export declare const CLI_WHEN_LABELS: WhenSugarLabels;
+/** MCP tool-parameter spellings. */
+export declare const MCP_WHEN_LABELS: WhenSugarLabels;
+/**
+ * The result of inspecting a `when` value for the `@time` suffix:
+ * - `unchanged` — no suffix; pass `when` through as-is.
+ * - `split` — a valid suffix; use the split `when` + `reminder`.
+ * - `error` — a malformed suffix, or a suffix given ALONGSIDE a separate
+ *   reminder; emit `message` as a usage error.
+ */
+export type WhenSugar = {
+    kind: "unchanged";
+} | {
+    kind: "split";
+    when: string;
+    reminder: string;
+} | {
+    kind: "error";
+    message: string;
+};
+/**
+ * Split a `when` value on its `@time` suffix. `reminderProvided` reflects
+ * whether the caller ALSO passed a separate reminder — a suffix plus an
+ * explicit reminder is ambiguous and rejected. A non-string or suffix-free
+ * `when` is `unchanged`.
+ */
+export declare function splitWhenSugar(when: unknown, reminderProvided: boolean, labels?: WhenSugarLabels): WhenSugar;

package/dist/model/when-sugar.js

@@ -0,0 +1,45 @@
+/**
+ * The `<when>@<time>` scheduling sugar, shared by every consumer surface. A
+ * single string like `2026-07-05@09:00` (or `today@evening`-style keyword +
+ * time) carries BOTH the schedule and its reminder; this splits it into the
+ * separate `when` + `reminder` the write pipeline expects, or reports the one
+ * usage error. Extracted from the CLI so the CLI and MCP validate the suffix
+ * identically instead of each re-deriving it — see docs/design/architecture.md
+ * (Consumer boundary).
+ *
+ * Pure: it neither mutates its input nor validates the DATE/TIME values (the
+ * pipeline does that downstream) — it only owns the `@` split and the two
+ * usage messages. The flag/parameter LABELS are injected so each surface keeps
+ * its own vocabulary (`--when`/`--reminder` vs `when`/`reminder`).
+ */
+/** CLI flag spellings — the default, since the sugar originated there. */
+export const CLI_WHEN_LABELS = { when: "--when", reminder: "--reminder" };
+/** MCP tool-parameter spellings. */
+export const MCP_WHEN_LABELS = { when: "when", reminder: "reminder" };
+/**
+ * Split a `when` value on its `@time` suffix. `reminderProvided` reflects
+ * whether the caller ALSO passed a separate reminder — a suffix plus an
+ * explicit reminder is ambiguous and rejected. A non-string or suffix-free
+ * `when` is `unchanged`.
+ */
+export function splitWhenSugar(when, reminderProvided, labels = CLI_WHEN_LABELS) {
+    if (typeof when !== "string" || !when.includes("@"))
+        return { kind: "unchanged" };
+    const at = when.indexOf("@");
+    const date = when.slice(0, at);
+    const time = when.slice(at + 1);
+    if (date === "" || time === "" || time.includes("@")) {
+        return {
+            kind: "error",
+            message: `invalid ${labels.when} "${when}" — expected today | evening | anytime | someday | YYYY-MM-DD (set a reminder with ${labels.reminder} HH:mm)`,
+        };
+    }
+    if (reminderProvided) {
+        return {
+            kind: "error",
+            message: `${labels.when} "${when}" carries an @time suffix and ${labels.reminder} was also given — use one`,
+        };
+    }
+    return { kind: "split", when: date, reminder: time };
+}
+//# sourceMappingURL=when-sugar.js.map

package/dist/model/when-sugar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"when-sugar.js","sourceRoot":"","sources":["../../src/model/when-sugar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAoB,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;AAE3F,oCAAoC;AACpC,MAAM,CAAC,MAAM,eAAe,GAAoB,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAcvF;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAa,EACb,gBAAyB,EACzB,SAA0B,eAAe;IAEzC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAClF,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAChC,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO;YACL,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,WAAW,MAAM,CAAC,IAAI,KAAK,IAAI,sFAAsF,MAAM,CAAC,QAAQ,SAAS;SACvJ,CAAC;IACJ,CAAC;IACD,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO;YACL,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,KAAK,IAAI,iCAAiC,MAAM,CAAC,QAAQ,2BAA2B;SAC5G,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AACvD,CAAC"}

package/dist/read/area-view.d.ts

@@ -6,6 +6,7 @@
  */
 import type { DatabaseSync } from "node:sqlite";
 import type { Area, IsoDateGroup, Project, Todo } from "../model/entities.ts";
+import { type ViewFilter } from "./views.ts";
 export interface AreaView {
     area: Area;
     /** Open, unscheduled/current direct to-dos, by index. */
@@ -22,5 +23,11 @@ export interface AreaView {
     logged: Todo[];
     trashed: Todo[];
 }
+/** A someday project row: open, incubated, no start date. */
+export declare const isSomedayProjectRow: (p: Project) => boolean;
+/** A future-scheduled project row (start date strictly after `todayIso`). */
+export declare const isScheduledProjectRow: (p: Project, todayIso: string) => boolean;
+/** An active project row — everything that is neither someday nor future-scheduled. */
+export declare const isActiveProjectRow: (p: Project, todayIso: string) => boolean;
 /** Resolves by uuid or unique (case-insensitive) title; throws like the ref resolvers. */
-export declare function areaView(db: DatabaseSync, ref: string, now?: Date): AreaView;
+export declare function areaView(db: DatabaseSync, ref: string, now?: Date, filter?: ViewFilter, zone?: string): AreaView;

package/dist/read/area-view.js

@@ -2,9 +2,25 @@ import { encodePackedDate, localToday, decodePackedDate } from "../model/dates.j
 import { mapProject, mapTodo } from "../model/mappers.js";
 import { fetchTagsForTasks, fetchTaskRows, makeRefResolver, resolveAreaUuid } from "./queries.js";
 import { logBoundary, markLogged } from "./log-boundary.js";
+import { OVERDUE } from "./predicates.js";
 import { areaTags } from "./tags.js";
+import { tagFilter } from "./views.js";
+// The area card splits its open projects into three display buckets by their
+// own schedule (the card mirrors the GUI: active projects as rows, scheduled
+// ones under Upcoming, someday ones under Someday). Closed-but-unswept projects
+// stay "active" (checked in place) — start/startDate only classify OPEN rows.
+// Shared by the bounding layer (capAreaSections keeps scheduled/someday whole
+// while capping the active rows) and the human renderer, so the split is
+// defined ONCE and the two never drift.
+/** A someday project row: open, incubated, no start date. */
+export const isSomedayProjectRow = (p) => p.status === "open" && p.start === "someday" && p.startDate === null;
+/** A future-scheduled project row (start date strictly after `todayIso`). */
+export const isScheduledProjectRow = (p, todayIso) => p.status === "open" && p.startDate !== null && p.startDate > todayIso;
+/** An active project row — everything that is neither someday nor future-scheduled. */
+export const isActiveProjectRow = (p, todayIso) => !isSomedayProjectRow(p) && !isScheduledProjectRow(p, todayIso);
 /** Resolves by uuid or unique (case-insensitive) title; throws like the ref resolvers. */
-export function areaView(db, ref, now) {
+export function areaView(db, ref, now, filter = {}, zone) {
+    const overdue = filter.overdue === true;
     const uuid = resolveAreaUuid(db, ref);
     const row = db
         .prepare(`SELECT uuid, title, visible, "index" FROM TMArea WHERE uuid = ?`)
@@ -15,33 +31,55 @@ export function areaView(db, ref, now) {
         uuid: row.uuid,
         title: row.title ?? "",
         visible: row.visible !== 0,
-        tags: areaTags(db, uuid),
+        // Area tags by NAME only (tag uuids are internal).
+        tags: areaTags(db, uuid).map((t) => ({ title: t.title })),
     };
     const refs = makeRefResolver(db);
     const tagsOf = (rows) => fetchTagsForTasks(db, rows.map((r) => r.uuid));
-    const boundary = logBoundary(db, now);
+    const boundary = logBoundary(db, now, zone);
+    // The view's injected clock — gates `todaySection` to Today members in the
+    // mapper AND drives the scheduled/overdue bucketing below.
+    const packedToday = encodePackedDate(localToday(now, zone));
+    // OWN-DEADLINE UNIFORM: `--overdue` filters BOTH displayed row kinds by each
+    // row's OWN deadline (open, strictly before today) via the shared OVERDUE
+    // predicate — the area's child PROJECTS by the project's own deadline AND the
+    // loose to-dos by theirs. There is NO descent into project contents (an
+    // overdue to-do inside a non-overdue project never surfaces here — that is
+    // `project show --overdue`). Sections with no surviving rows collapse.
+    const overdueSql = overdue ? ` AND ${OVERDUE}` : "";
+    const overdueBinds = overdue ? [encodePackedDate(localToday(now, zone))] : [];
+    // Tag scope (§9a): BOTH displayed row kinds — the child PROJECTS and the
+    // loose to-dos — are filtered by a tag carried DIRECTLY on the row (the
+    // container semantics). The area's own tags are inherited by every row it
+    // holds, so an inheritance-inclusive `--tag` would be vacuous; suppressing the
+    // container hop makes `--tag` mean "rows with this tag on themselves" (still
+    // descendant-expanded) and `--untagged` "rows with no direct tag". Computed
+    // once, spliced into both queries; NO descent into project contents (a child
+    // of a matching project is never inspected here). The tag binds trail each
+    // query's own binds.
+    const tf = tagFilter(db, filter, { container: true });
     // Open projects PLUS closed ones the log-move sweep has not passed — the
-    // GUI keeps those checked in place (completion ≠ logged).
+    // GUI keeps those checked in place (completion ≠ logged). Under --overdue the
+    // OVERDUE predicate's own `status = 0` narrows this to open overdue projects.
     const projectRows = fetchTaskRows(db, `t.type = 1 AND t.area = ? AND t.trashed = 0
-     AND (t.status = 0 OR t.stopDate > ?) ORDER BY t."index" ASC`, [uuid, boundary.getTime() / 1000]);
+     AND (t.status = 0 OR t.stopDate > ?)${overdueSql}${tf.sql} ORDER BY t."index" ASC`, [uuid, boundary.getTime() / 1000, ...overdueBinds, ...tf.binds]);
     const projectTags = tagsOf(projectRows);
-    const projects = markLogged(projectRows.map((r) => mapProject(r, refs, projectTags.get(r.uuid) ?? [])), boundary);
-    const todoRows = fetchTaskRows(db, `t.type = 0 AND t.area = ? ORDER BY t."index" ASC`, [uuid]);
+    const projects = markLogged(projectRows.map((r) => mapProject(r, refs, projectTags.get(r.uuid) ?? [], packedToday)), boundary);
+    const todoRows = fetchTaskRows(db, `t.type = 0 AND t.area = ?${overdueSql}${tf.sql} ORDER BY t."index" ASC`, [uuid, ...overdueBinds, ...tf.binds]);
     const todoTags = tagsOf(todoRows);
     const todos = todoRows.map((r) => ({
         row: r,
-        todo: mapTodo(r, refs, todoTags.get(r.uuid) ?? []),
+        todo: mapTodo(r, refs, todoTags.get(r.uuid) ?? [], packedToday),
     }));
     markLogged(todos.map((t) => t.todo), boundary);
-    const packedToday = encodePackedDate(localToday(now));
     const active = [];
     const scheduledRows = [];
     const repeating = [];
     const someday = [];
     const logged = [];
     const trashed = [];
-    for (const { row, todo } of todos) {
-        if (row.trashed === 1) {
+    for (const { row: todoRow, todo } of todos) {
+        if (todoRow.trashed === 1) {
             trashed.push(todo);
             continue;
         }
@@ -49,7 +87,7 @@ export function areaView(db, ref, now) {
             repeating.push(todo);
             continue;
         }
-        if (row.status !== 0) {
+        if (todoRow.status !== 0) {
             // Completion ≠ logged: closed-but-unswept items stay checked in the
             // active block, like the GUI.
             if (todo.logged)
@@ -58,14 +96,14 @@ export function areaView(db, ref, now) {
                 active.push(todo);
             continue;
         }
-        if (row.start === 2 && row.startDate === null) {
+        if (todoRow.start === 2 && todoRow.startDate === null) {
             someday.push(todo);
             continue;
         }
-        if (row.startDate !== null && row.startDate > packedToday) {
+        if (todoRow.startDate !== null && todoRow.startDate > packedToday) {
             scheduledRows.push({
-                date: decodePackedDate(row.startDate) ?? "",
-                ti: row.todayIndex ?? 0,
+                date: decodePackedDate(todoRow.startDate) ?? "",
+                ti: todoRow.todayIndex ?? 0,
                 todo,
             });
             continue;
@@ -75,7 +113,7 @@ export function areaView(db, ref, now) {
     logged.sort((a, b) => (b.stopped?.getTime() ?? 0) - (a.stopped?.getTime() ?? 0));
     const scheduled = [];
     // Within a day the UI sorts by todayIndex ASC (Upcoming drag order).
-    for (const { date, todo } of scheduledRows.sort((a, b) => a.date.localeCompare(b.date) || a.ti - b.ti)) {
+    for (const { date, todo } of scheduledRows.toSorted((a, b) => a.date.localeCompare(b.date) || a.ti - b.ti)) {
         const last = scheduled[scheduled.length - 1];
         if (last && last.date === date)
             last.items.push(todo);

package/dist/read/area-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"area-view.js","sourceRoot":"","sources":["../../src/read/area-view.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEnF,OAAO,EAAE,UAAU,EAAE,OAAO,EAAgB,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAClG,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAmBrC,0FAA0F;AAC1F,MAAM,UAAU,QAAQ,CAAC,EAAgB,EAAE,GAAW,EAAE,GAAU;IAChE,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CAAC,iEAAiE,CAAC;SAC1E,GAAG,CAAC,IAAI,CAEE,CAAC;IACd,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;IACpE,MAAM,IAAI,GAAS;QACjB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;QACtB,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,CAAC;QAC1B,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;KACzB,CAAC;IAEF,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,CAAC,IAAe,EAAE,EAAE,CACjC,iBAAiB,CACf,EAAE,EACF,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACxB,CAAC;IAEJ,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACtC,yEAAyE;IACzE,0DAA0D;IAC1D,MAAM,WAAW,GAAG,aAAa,CAC/B,EAAE,EACF;iEAC6D,EAC7D,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAClC,CAAC;IACF,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,UAAU,CACzB,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,EAC1E,QAAQ,CACT,CAAC;IAEF,MAAM,QAAQ,GAAG,aAAa,CAAC,EAAE,EAAE,kDAAkD,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/F,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjC,GAAG,EAAE,CAAC;QACN,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;KACnD,CAAC,CAAC,CAAC;IACJ,UAAU,CACR,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EACxB,QAAQ,CACT,CAAC;IAEF,MAAM,WAAW,GAAG,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,MAAM,GAAW,EAAE,CAAC;IAC1B,MAAM,aAAa,GAAoD,EAAE,CAAC;IAC1E,MAAM,SAAS,GAAW,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAW,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAW,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAW,EAAE,CAAC;IAE3B,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QAClC,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;YAC9B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,oEAAoE;YACpE,8BAA8B;YAC9B,IAAI,IAAI,CAAC,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;gBAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,IAAI,GAAG,CAAC,SAAS,GAAG,WAAW,EAAE,CAAC;YAC1D,aAAa,CAAC,IAAI,CAAC;gBACjB,IAAI,EAAE,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE;gBAC3C,EAAE,EAAE,GAAG,CAAC,UAAU,IAAI,CAAC;gBACvB,IAAI;aACL,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACjF,MAAM,SAAS,GAAyB,EAAE,CAAC;IAC3C,qEAAqE;IACrE,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,aAAa,CAAC,IAAI,CAC7C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CACtD,EAAE,CAAC;QACF,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7C,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YACjD,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC/F,CAAC"}
+{"version":3,"file":"area-view.js","sourceRoot":"","sources":["../../src/read/area-view.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEnF,OAAO,EAAE,UAAU,EAAE,OAAO,EAAgB,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAClG,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAmB,MAAM,YAAY,CAAC;AAmBxD,6EAA6E;AAC7E,6EAA6E;AAC7E,gFAAgF;AAChF,8EAA8E;AAC9E,8EAA8E;AAC9E,yEAAyE;AACzE,wCAAwC;AAExC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAU,EAAW,EAAE,CACzD,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC;AAEvE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAU,EAAE,QAAgB,EAAW,EAAE,CAC7E,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,GAAG,QAAQ,CAAC;AAExE,uFAAuF;AACvF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAU,EAAE,QAAgB,EAAW,EAAE,CAC1E,CAAC,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AAEjE,0FAA0F;AAC1F,MAAM,UAAU,QAAQ,CACtB,EAAgB,EAChB,GAAW,EACX,GAAU,EACV,SAAqB,EAAE,EACvB,IAAa;IAEb,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;IACxC,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CAAC,iEAAiE,CAAC;SAC1E,GAAG,CAAC,IAAI,CAEE,CAAC;IACd,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;IACpE,MAAM,IAAI,GAAS;QACjB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;QACtB,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,CAAC;QAC1B,mDAAmD;QACnD,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;KAC1D,CAAC;IAEF,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,CAAC,IAAe,EAAE,EAAE,CACjC,iBAAiB,CACf,EAAE,EACF,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CACxB,CAAC;IAEJ,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC5C,2EAA2E;IAC3E,2DAA2D;IAC3D,MAAM,WAAW,GAAG,gBAAgB,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5D,6EAA6E;IAC7E,0EAA0E;IAC1E,8EAA8E;IAC9E,wEAAwE;IACxE,2EAA2E;IAC3E,uEAAuE;IACvE,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,yEAAyE;IACzE,wEAAwE;IACxE,0EAA0E;IAC1E,+EAA+E;IAC/E,6EAA6E;IAC7E,4EAA4E;IAC5E,6EAA6E;IAC7E,2EAA2E;IAC3E,qBAAqB;IACrB,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,yEAAyE;IACzE,8EAA8E;IAC9E,8EAA8E;IAC9E,MAAM,WAAW,GAAG,aAAa,CAC/B,EAAE,EACF;2CACuC,UAAU,GAAG,EAAE,CAAC,GAAG,yBAAyB,EACnF,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAChE,CAAC;IACF,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,UAAU,CACzB,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC,EACvF,QAAQ,CACT,CAAC;IAEF,MAAM,QAAQ,GAAG,aAAa,CAC5B,EAAE,EACF,4BAA4B,UAAU,GAAG,EAAE,CAAC,GAAG,yBAAyB,EACxE,CAAC,IAAI,EAAE,GAAG,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CACrC,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjC,GAAG,EAAE,CAAC;QACN,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC;KAChE,CAAC,CAAC,CAAC;IACJ,UAAU,CACR,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EACxB,QAAQ,CACT,CAAC;IAEF,MAAM,MAAM,GAAW,EAAE,CAAC;IAC1B,MAAM,aAAa,GAAoD,EAAE,CAAC;IAC1E,MAAM,SAAS,GAAW,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAW,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAW,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAW,EAAE,CAAC;IAE3B,KAAK,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QAC3C,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;YAC9B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,oEAAoE;YACpE,8BAA8B;YAC9B,IAAI,IAAI,CAAC,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;gBAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,KAAK,CAAC,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,IAAI,OAAO,CAAC,SAAS,GAAG,WAAW,EAAE,CAAC;YAClE,aAAa,CAAC,IAAI,CAAC;gBACjB,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE;gBAC/C,EAAE,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;gBAC3B,IAAI;aACL,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACjF,MAAM,SAAS,GAAyB,EAAE,CAAC;IAC3C,qEAAqE;IACrE,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,aAAa,CAAC,QAAQ,CACjD,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CACtD,EAAE,CAAC;QACF,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC7C,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YACjD,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC/F,CAAC"}

package/dist/read/detail.d.ts

@@ -4,5 +4,5 @@
  */
 import type { DatabaseSync } from "node:sqlite";
 import type { AnyTask, ChecklistItem } from "../model/entities.ts";
-export declare function byUuid(db: DatabaseSync, uuid: string): AnyTask | null;
+export declare function byUuid(db: DatabaseSync, uuid: string, now?: Date, zone?: string): AnyTask | null;
 export declare function checklistFor(db: DatabaseSync, taskUuid: string): ChecklistItem[];