things-api 0.11.0 → 0.13.0

package/dist/cli/read-driver.js

@@ -8,8 +8,46 @@
 import { getInvocation } from "./resolve-invocation.js";
 import { dim } from "./style.js";
 import { viewHeaderLines } from "./render.js";
-import { candidatesJson, DidYouMeanError, renderDidYouMean } from "./did-you-mean.js";
-import { ClockError, DEFAULT_LIST_LIMIT, errorEnvelope, ExitCode, okEnvelope, omitEmpty, openThings, ReferenceResolutionError, schemaWarnings, ThingsDbNotFoundError, ThingsDbOpenError, } from "../index.js";
+import { setRenderRefPromoter } from "./ref-render.js";
+import { candidatesJson, DidYouMeanError, didYouMeanMessage, renderDidYouMean, } from "./did-you-mean.js";
+import { ClockError, DEFAULT_LIST_LIMIT, errorEnvelope, ExitCode, okEnvelope, omitEmpty, openThings, shapeReadPayload, ReferenceResolutionError, schemaWarnings, ThingsDbNotFoundError, ThingsDbOpenError, } from "../index.js";
+/**
+ * Kinds whose read payload is a flat list; their envelope `data` is the R1
+ * `{ items: [...] }` wrapper (data is ALWAYS a JSON object, never a bare array).
+ */
+const ITEMS_WRAPPER_KINDS = new Set([
+    "inbox",
+    "today",
+    "upcoming",
+    "logbook",
+    "trash",
+    "changes",
+    "search",
+    "projects",
+    "areas",
+    "tags",
+]);
+/**
+ * Shape a read payload into its envelope `data` object (the 1.0 contract, R1/R2):
+ * `data` is always an object. Flat lists (incl. `today`, one flat `items[]` of
+ * Today members) become `{ items }`; the sectioned catalogues (anytime/someday)
+ * become `{ sections }`; the composite cards become `{ view }`; a single-entity
+ * detail becomes `{ item }`. Everything already object-shaped (open/snapshot/…)
+ * passes through. The human-render path keeps the raw inner payload — this
+ * transform is the JSON emit boundary only. `today`'s whole-view `counts`
+ * aggregate rides `meta.counts`, not `data` (runRead), so `data` stays pure rows.
+ */
+export function wrapEnvelopeData(kind, data) {
+    if (ITEMS_WRAPPER_KINDS.has(kind))
+        return { items: data };
+    if (kind === "anytime" || kind === "someday")
+        return { sections: data };
+    if (kind === "area-view" || kind === "project-view")
+        return { view: data };
+    if (kind === "detail")
+        return { item: data };
+    return data;
+}
 /**
  * The single usage-error emitter every command surface routes flag/argument
  * errors through, so `--json` is honored uniformly: under `--json` a
@@ -21,7 +59,7 @@ import { ClockError, DEFAULT_LIST_LIMIT, errorEnvelope, ExitCode, okEnvelope, om
 export function usageError(opts, message, details) {
     if (opts.json === true) {
         const meta = { dbVersion: null, fingerprint: "unknown", elapsedMs: 0 };
-        process.stdout.write(`${JSON.stringify(errorEnvelope({ code: "usage", message, ...(details !== undefined && { details }) }, meta))}\n`);
+        process.stdout.write(`${JSON.stringify(errorEnvelope({ code: "usage", message, ...(details !== undefined && { detail: details }) }, meta))}\n`);
     }
     else {
         process.stderr.write(`error: ${message}\n`);
@@ -47,11 +85,20 @@ export function runRead(opts, kind, fn, render, hintBase, header) {
     let client = null;
     try {
         client = openThings(opts.db ? { dbPath: opts.db } : {});
+        // Arm the render-time ref promoter so human list rows can promote an inline
+        // container hint's uuid prefix (TTY only — the JSON path never calls the
+        // renderers). Grouped views render inside `fn`, so this must precede it;
+        // cleared in `finally`. The `--json` envelope shapes its own refs separately.
+        if (!opts.json)
+            setRenderRefPromoter(client.refPromoter());
         const fp = client.fingerprint();
         // Reads never block on a schema change — they warn (design decision). The
         // note reuses the same cached fingerprint the write path gates on.
-        const warnings = schemaWarnings(client.schemaStatus());
-        const { data, truncation, grouped, lines: precomputed } = fn(client);
+        const { data, truncation, kind: kindOverride, filter, counts, warnings: readWarnings, lines: precomputed, } = fn(client);
+        // Schema-drift advisories plus any read-specific advisories (e.g. the loose
+        // pseudo-area resolution-shadow disclosure).
+        const warnings = [...schemaWarnings(client.schemaStatus()), ...(readWarnings ?? [])];
+        const effectiveKind = kindOverride ?? kind;
         // The canonical command a sugar invocation normalized to — known now that
         // `fn` has resolved any reference. Present only for the routing sugars
         // (bare noun, keyword-in-show, uuid/share-link routing); null otherwise.
@@ -59,15 +106,20 @@ export function runRead(opts, kind, fn, render, hintBase, header) {
         // The clock honesty field: present only when a consumer zone / pinned now
         // is in effect (absent = host clock, so the wire shape is unchanged).
         const clock = client.clockMeta();
+        // The active container scope (additive): present only when the client is
+        // jailed, so an agent knows its own jail (not an oracle for what's outside).
+        const scope = client.scope;
         const meta = {
             dbVersion: fp.observation.databaseVersion,
             fingerprint: fp.kind === "ok" ? "ok" : fp.kind === "drift" ? "drift" : "unknown",
             elapsedMs: Date.now() - started,
             ...(truncation !== undefined && { truncation }),
-            ...(grouped !== undefined && { grouped }),
             ...(resolvedCommand !== null && { resolvedCommand }),
             ...(warnings.length > 0 && { warnings }),
             ...(clock !== undefined && { clock }),
+            ...(filter !== undefined && { filter }),
+            ...(counts !== undefined && { counts }),
+            ...(scope !== undefined && { scope }),
         };
         // Human output gets the note once on STDERR (never mixed into the piped
         // stdout rows); the --json envelope carries it in meta.warnings instead.
@@ -79,7 +131,8 @@ export function runRead(opts, kind, fn, render, hintBase, header) {
             // Omit-empty applies to the entity/data payload only (contracts.md); the
             // envelope meta/truncation is untouched, and the human render below keeps
             // the full, unpruned `data`.
-            process.stdout.write(`${JSON.stringify(okEnvelope(kind, omitEmpty(data), meta))}\n`);
+            const shaped = shapeReadPayload(effectiveKind, data, opts.full === true, client.refPromoter());
+            process.stdout.write(`${JSON.stringify(okEnvelope(effectiveKind, omitEmpty(wrapEnvelopeData(effectiveKind, shaped)), meta))}\n`);
         }
         else {
             const lines = precomputed ?? render(data);
@@ -97,9 +150,16 @@ export function runRead(opts, kind, fn, render, hintBase, header) {
             // sugar invocation resolved to, adjacent to the header. Same gates as the
             // preamble (TTY-only, never in --json) — canonical invocations echo
             // nothing because `resolvedCommand` is null for them.
-            const out = resolvedCommand !== null && process.stdout.isTTY === true
-                ? [dim(`≡ ${resolvedCommand}`), ...withHeader]
-                : withHeader;
+            // The scope banner: one dim line naming the active jail, so a scoped
+            // read is never silently partial (TTY-only, never in --json). A
+            // stored-config scope must not be a mystery jail.
+            const scopeBanner = scope !== undefined && process.stdout.isTTY === true
+                ? [dim(`scoped to ${scope.kind} "${scope.title}"`)]
+                : [];
+            const normalized = resolvedCommand !== null && process.stdout.isTTY === true
+                ? [dim(`≡ ${resolvedCommand}`)]
+                : [];
+            const out = [...scopeBanner, ...normalized, ...withHeader];
             process.stdout.write(`${out.join("\n")}\n`);
         }
         process.exitCode = ExitCode.Ok;
@@ -117,8 +177,8 @@ export function runRead(opts, kind, fn, render, hintBase, header) {
             if (opts.json) {
                 process.stdout.write(`${JSON.stringify(errorEnvelope({
                     code: "not-found",
-                    message: err.message,
-                    details: { candidates: candidatesJson(err) },
+                    message: didYouMeanMessage(err),
+                    detail: { candidates: candidatesJson(err) },
                 }, meta))}\n`);
             }
             else {
@@ -131,7 +191,7 @@ export function runRead(opts, kind, fn, render, hintBase, header) {
         // usage-class failure carrying machine-readable candidates.
         if (err instanceof ReferenceResolutionError) {
             if (opts.json) {
-                process.stdout.write(`${JSON.stringify(errorEnvelope({ code: err.code, message: err.message, details: { candidates: err.candidates } }, meta))}\n`);
+                process.stdout.write(`${JSON.stringify(errorEnvelope({ code: err.code, message: err.message, detail: { candidates: err.candidates } }, meta))}\n`);
             }
             else {
                 process.stderr.write(`error: ${err.message}\n`);
@@ -156,6 +216,7 @@ export function runRead(opts, kind, fn, render, hintBase, header) {
         process.exitCode = isEnv ? ExitCode.Environment : ExitCode.Unexpected;
     }
     finally {
+        setRenderRefPromoter(null); // never leak a closed-DB promoter past this read
         client?.close();
     }
 }
@@ -164,8 +225,14 @@ export function runRead(opts, kind, fn, render, hintBase, header) {
  * turns it into human lines. Generic so `fn`'s return type flows into
  * `render`'s parameter — the compiler verifies the renderer matches the data.
  */
-export function withClient(opts, kind, fn, render) {
-    runRead(opts, kind, (client) => ({ data: fn(client) }), render);
+export function withClient(opts, kind, fn, render, 
+/** Optional read-specific advisories (merged into `meta.warnings` + stderr). */
+warnings) {
+    runRead(opts, kind, (client) => {
+        const data = fn(client);
+        const w = warnings?.(client);
+        return { data, ...(w !== undefined && w.length > 0 && { warnings: w }) };
+    }, render);
 }
 /**
  * Resolve the shared `--limit`/`--all` pair (flat views) into a row cap

package/dist/cli/read-driver.js.map

@@ -1 +1 @@
-{"version":3,"file":"read-driver.js","sourceRoot":"","sources":["../../src/cli/read-driver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EACV,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,GAKlB,MAAM,aAAa,CAAC;AAOrB;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CACxB,IAAwB,EACxB,OAAe,EACf,OAA4D;IAE5D,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAiB,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;QACrF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,CAAC,SAAS,CACf,aAAa,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAC3F,IAAI,CACN,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC;AACpC,CAAC;AAgBD;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CACrB,IAAoB,EACpB,IAAY,EACZ,EAA4C,EAC5C,MAA6B,EAC7B,QAAiB,EACjB,MAAe;IAEf,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,2EAA2E;IAC3E,yEAAyE;IACzE,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,UAAU,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IACD,IAAI,MAAM,GAAwB,IAAI,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxD,MAAM,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAChC,0EAA0E;QAC1E,mEAAmE;QACnE,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QACvD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;QACrE,0EAA0E;QAC1E,uEAAuE;QACvE,yEAAyE;QACzE,MAAM,eAAe,GAAG,aAAa,EAAE,EAAE,SAAS,IAAI,IAAI,CAAC;QAC3D,0EAA0E;QAC1E,sEAAsE;QACtE,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,IAAI,GAAiB;YACzB,SAAS,EAAE,EAAE,CAAC,WAAW,CAAC,eAAe;YACzC,WAAW,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YAChF,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;YAC/B,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,CAAC;YAC/C,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;YACzC,GAAG,CAAC,eAAe,KAAK,IAAI,IAAI,EAAE,eAAe,EAAE,CAAC;YACpD,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;YACxC,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;SACtC,CAAC;QACF,wEAAwE;QACxE,yEAAyE;QACzE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,MAAM,OAAO,IAAI,QAAQ;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,IAAI,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,yEAAyE;YACzE,0EAA0E;YAC1E,6BAA6B;YAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QACvF,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,UAAU,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACvD,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;gBAClD,IAAI,IAAI,KAAK,IAAI;oBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC1C,CAAC;YACD,0EAA0E;YAC1E,0EAA0E;YAC1E,MAAM,UAAU,GACd,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;gBACnD,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC;gBACxC,CAAC,CAAC,KAAK,CAAC;YACZ,wEAAwE;YACxE,0EAA0E;YAC1E,oEAAoE;YACpE,sDAAsD;YACtD,MAAM,GAAG,GACP,eAAe,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;gBACvD,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,eAAe,EAAE,CAAC,EAAE,GAAG,UAAU,CAAC;gBAC9C,CAAC,CAAC,UAAU,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAiB;YACzB,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,SAAS;YACtB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;SAChC,CAAC;QACF,0EAA0E;QAC1E,0EAA0E;QAC1E,2BAA2B;QAC3B,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,CAAC,SAAS,CACf,aAAa,CACX;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,OAAO,EAAE,EAAE,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE;iBAC7C,EACD,IAAI,CACL,CACF,IAAI,CACN,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChE,CAAC;YACD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC;YAClC,OAAO;QACT,CAAC;QACD,qEAAqE;QACrE,4DAA4D;QAC5D,IAAI,GAAG,YAAY,wBAAwB,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,CAAC,SAAS,CACf,aAAa,CACX,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,EAAE,EACjF,IAAI,CACL,CACF,IAAI,CACN,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC;YAClC,OAAO;QACT,CAAC;QACD,0EAA0E;QAC1E,uEAAuE;QACvE,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;YAC9B,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,YAAY,qBAAqB,IAAI,GAAG,YAAY,iBAAiB,CAAC;QACvF,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC,IAAI,CACpG,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;IACxE,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,KAAK,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,IAAoB,EACpB,IAAY,EACZ,EAA+B,EAC/B,MAA6B;IAE7B,OAAO,CAAI,IAAI,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AACrE,CAAC;AAKD;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,IAI1B;IACC,OAAO,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,EAAE,kBAAkB,EAAE,IAAI,CAAC,GAAG,KAAK,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACpG,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,KAAyB,EACzB,YAAoB,EACpB,GAAY,EACZ,IAAI,GAAG,KAAK;IAEZ,MAAM,CAAC,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1D,sEAAsE;IACtE,8EAA8E;IAC9E,MAAM,QAAQ,GACZ,GAAG,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC;IACzE,4EAA4E;IAC5E,4DAA4D;IAC5D,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,mCAAmC,CAAC,CAAC;QACjE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IACvB,CAAC;IACD,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;QACvD,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,6BAA6B,CAAC,CAAC;QAC3D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IACvB,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACvC,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,wEAAwE;AACxE,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAwC;IAC/E,OAAO;QACL,QAAQ;QACR,IAAI;QACJ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;KACvE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,UAAsB;IACjE,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACpE,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;IACjD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC;IACpC,OAAO,GAAG,CACR,MAAM,IAAI,aAAa,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,kBAAkB,IAAI,YAAY,MAAM,UAAU,IAAI,aAAa,CAChH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"read-driver.js","sourceRoot":"","sources":["../../src/cli/read-driver.ts"],"names":[],"mappings":"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"}

package/dist/cli/ref-render.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The CLI's process-wide render-time ref promoter — the same module-state
+ * pattern the render clock (./clock.ts) and width fit (./width.ts) use. The read
+ * driver sets it (from `client.refPromoter()`) before rendering human output and
+ * clears it after, so the pure renderers can decide whether an INLINE container
+ * hint should promote its uuid prefix — `(Family)` → `(Family [TC9yozLk])` —
+ * using the SAME round-trip predicate the JSON `*Uuid` promotion uses (no fork).
+ * Unset (the default, and in unit tests that import the renderers directly) it is
+ * null, so a container hint stays the bare `(title)` — byte-identical output.
+ */
+import type { RefPromoter } from "../index.ts";
+export declare function setRenderRefPromoter(p: RefPromoter | null): void;
+/** The active render-time promoter, or null (host default — no inline promotion). */
+export declare function renderRefPromoter(): RefPromoter | null;

package/dist/cli/ref-render.js

@@ -0,0 +1,9 @@
+let promoter = null;
+export function setRenderRefPromoter(p) {
+    promoter = p;
+}
+/** The active render-time promoter, or null (host default — no inline promotion). */
+export function renderRefPromoter() {
+    return promoter;
+}
+//# sourceMappingURL=ref-render.js.map

package/dist/cli/ref-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-render.js","sourceRoot":"","sources":["../../src/cli/ref-render.ts"],"names":[],"mappings":"AAYA,IAAI,QAAQ,GAAuB,IAAI,CAAC;AAExC,MAAM,UAAU,oBAAoB,CAAC,CAAqB;IACxD,QAAQ,GAAG,CAAC,CAAC;AACf,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,iBAAiB;IAC/B,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/cli/render.d.ts

@@ -7,7 +7,7 @@
  * (agents and humans both need stable references); colors engage on a TTY only
  * (../cli/style.ts).
  */
-import { type GroupedLimits, type GroupedTruncation, type ListItem, type SectionCount, type SidebarSection, type TodayView } from "../index.ts";
+import { type GroupedLimits, type ListItem, type SectionCount, type SidebarSection, type TodayView, type Truncation } from "../index.ts";
 import { stripSgr } from "./width.ts";
 /**
  * A view's TTY-only title preamble: bold view name + its dim Things deep link,
@@ -39,6 +39,14 @@ export interface FormatOpts {
     /** Container uuids already implied by surrounding output — their context suffix is dropped. */
     suppressProject?: string | null;
     suppressArea?: string | null;
+    /**
+     * Hint the row's HEADING (muted `(Heading)`) instead of its container — the
+     * project-view LOGBOOK rows, where a swept child of an OPEN heading labels its
+     * heading (the two-view asymmetry, HEADARC2-B: the in-project logged toggle
+     * labels the heading; the global Logbook labels the project). No-op on a row
+     * with no heading (falls back to the normal container/area hint).
+     */
+    headingContext?: boolean;
     /** Reference instant for date-relative tokens (tests pin this; defaults to now). */
     now?: Date;
     /** Pre-styled Today/Evening mark (★/⏾), rendered right after the box — GUI position. */
@@ -81,7 +89,7 @@ export declare function formatItem(item: ListItem, uuidWidth?: number, opts?: Fo
  * effective This-Evening members (raw evening assignment counts only while
  * startDate is exactly today — the UI's daily expiry), null otherwise.
  */
-export declare function todayMark(item: ListItem, now?: Date): string | null;
+export declare function todayMark(item: ListItem): string | null;
 /** Minimum displayed-prefix length: shorter prefixes collide across the DB. */
 export declare const UUID_DISPLAY_MIN = 8;
 /** The full-form TTY row floor — worst-case furniture + full deadline. See {@link computeFitFloors}. */
@@ -104,12 +112,28 @@ export declare function uuidDisplayWidth(items: Array<{
 export declare function uuidCol(uuid: string, width: number): string;
 export declare function renderList(items: ListItem[]): string[];
 /**
- * The `things today` split. The membership glyph lives in the SECTION HEADER,
- * not on every row — a yellow ★ in the Today header (which also carries the
- * sidebar badge split) and a blue ⏾ in the This Evening header — so the rows
- * drop the redundant per-item marker (the same convention that suppresses a
- * `(project)` context inside that project's own view). Every OTHER view keeps
- * the per-row ★/⏾, where the marker still carries information.
+ * The `things today` view. The wire is one flat `items[]` of Today members; the
+ * TTY re-projects the GUI's two render sections from each row's `when` — a
+ * Today-proper block (`when: "today"`) and a This-Evening block
+ * (`when: "evening"`). The whole-view `counts` aggregate (the app's sidebar
+ * count) renders at the TOP as card-style metadata lines (indented `key: value`,
+ * the same convention `things project show` / `things area show` use), so the
+ * section header itself stays clean (`── ★ Today ──`).
+ *
+ * The membership glyph lives in the SECTION HEADER, not on every row — a yellow ★
+ * in the Today header and a blue ⏾ in the This Evening header — so the rows drop
+ * the redundant per-item marker (the same convention that suppresses a
+ * `(project)` context inside that project's own view). Every OTHER view keeps the
+ * per-row ★/⏾, where the marker still carries information.
+ *
+ * A PROVISIONAL Today member (the wire's presence-keyed `provisional`, BANNER1
+ * law — a Today entrant the app has not yet materialized, banner-counted until
+ * acknowledged) gets a yellow `•` in the freed mark slot, mirroring the GUI's
+ * yellow "new item" pip. It is per-row (it distinguishes rows within a section,
+ * so it is NOT header-deduped like the ★) and — per the GUI — renders ONLY here,
+ * never in anytime or any other view. Derived through {@link entityProvisional},
+ * the SAME law the wire emit boundary uses, so the pip can never disagree with
+ * the emitted `provisional`.
  *
  * This Evening mirrors the GUI: it renders ONLY when evening items exist —
  * a truly-empty evening has no header at all. `view` is the rows that survived
@@ -131,10 +155,12 @@ export declare function renderToday(view: TodayView, sections: SectionCount[] |
     eveningOnly?: boolean;
 }): string[];
 /**
- * Search rows: a standard list row, plus — for a project surfaced by a HEADING
- * title match — a muted `(via heading "…")` suffix crediting the heading whose
- * text matched (the parent project row stands in for the heading; the GUI has
- * no bare heading row). Ordinary title/notes matches render as plain rows.
+ * Search rows: a standard list row, plus — for a hit surfaced by something OTHER
+ * than its title — an indented muted matched-on line crediting WHERE the query
+ * matched (`  ⤷ heading: "…"` / `  ⤷ notes: "…snippet…"` / `  ⤷ checklist: "…"`).
+ * A title match renders as a plain row with no indicator (matched where you'd
+ * expect). A heading match credits the parent project, a checklist match the
+ * parent to-do (the GUI has no bare heading/checklist row).
  */
 export declare function renderSearch(items: ListItem[]): string[];
 /** Hidden-later counts per sidebar group (null area = the loose block). */
@@ -230,7 +256,7 @@ export declare function disclosureHint(count: number, noun: string | {
  * (`limits` supplies the doubling). Today members are starred. Mirrors
  * renderSections' layout exactly.
  */
-export declare function renderAnytimePreview(sections: SidebarSection[], grouped: GroupedTruncation, limits: GroupedLimits, base: string): string[];
+export declare function renderAnytimePreview(sections: SidebarSection[], grouped: Truncation, limits: GroupedLimits, base: string): string[];
 /**
  * The someday preview, mirroring the GUI (side-by-side, 2026-07-12): inside
  * each group the project rows render as PLAIN items — `(~)` circle, count
@@ -243,4 +269,4 @@ export declare function renderAnytimePreview(sections: SidebarSection[], grouped
  * When the toggle is off and such items exist, a muted bottom hint counts
  * them and names the flag.
  */
-export declare function renderSomedayPreview(sections: SidebarSection[], grouped: GroupedTruncation, limits: GroupedLimits, base: string, showActive: boolean, hiddenActiveItems: number): string[];
+export declare function renderSomedayPreview(sections: SidebarSection[], grouped: Truncation, limits: GroupedLimits, base: string, showActive: boolean, hiddenActiveItems: number): string[];

package/dist/cli/render.js

@@ -7,10 +7,11 @@
  * (agents and humans both need stable references); colors engage on a TTY only
  * (../cli/style.ts).
  */
-import { isTodayMember, localToday, partitionSomedaySection, splitSectionBlocks, templateStatus, } from "../index.js";
+import { entityProvisional, entityWhen, localToday, partitionSomedaySection, splitSectionBlocks, templateStatus, REF_PREFIX_LEN, } from "../index.js";
 import { renderNow, renderZone } from "./clock.js";
+import { renderRefPromoter } from "./ref-render.js";
 import { bold, dim, strike, underline } from "./style.js";
-import { areaMark, CHECKLIST_MARK, containerLabel, countChip, dateChip, deadlineToken, eveningMoon, LEGEND, LEGEND_GROUPS, loggedDate, NOTES_MARK, projectCircle, projectTitleAccent, REMINDER_MARK, todayStar, todoBox, } from "./glyphs.js";
+import { areaMark, CHECKLIST_MARK, containerLabel, countChip, dateChip, deadlineToken, eveningMoon, LEGEND, LEGEND_GROUPS, loggedDate, NOTES_MARK, projectCircle, projectTitleAccent, provisionalPip, REMINDER_MARK, todayStar, todoBox, } from "./glyphs.js";
 import { FULL_MONTHS, upcomingBucket } from "./period.js";
 import { fitRow, getFitWidth, resolveFit, stripSgr, TITLE_MIN, visibleWidth, } from "./width.js";
 /**
@@ -52,6 +53,19 @@ export function renderLegend() {
 }
 /** Wraps a `#a #b` tag form in the row's dim styling (incl. its leading space). */
 const styleTags = (form) => ` ${dim(form)}`;
+/**
+ * The inline `[8charPrefix]` a container hint promotes when its bare title would
+ * NOT round-trip — the SAME predicate the JSON `*Uuid` promotion uses (the render
+ * promoter, ./ref-render.ts). Empty (bare `(title)`) when the promoter is unset
+ * (non-TTY / tests / no DB) or the title resolves back cleanly. A project/area
+ * container never carries a heading scope, so `projectUuid` stays undefined.
+ */
+function promotedRefBracket(ref, kind) {
+    const p = renderRefPromoter();
+    if (p === null || p.roundTrips(kind, ref.title, ref.uuid))
+        return "";
+    return ` [${ref.uuid.slice(0, REF_PREFIX_LEN)}]`;
+}
 /**
  * One item line:
  * `<uuid-prefix>  <box> [★|⏾] [logged-date] [‹chip›] <title> [‹n›] [⍾] [≡] [≔] (container) #tags [⚑ deadline]`.
@@ -127,18 +141,27 @@ export function formatItem(item, uuidWidth = 0, opts = {}) {
                 ? ` ${bold(dim("⚑"))}`
                 : "";
     const container = item.type === "to-do" ? (item.project ?? item.headingProject ?? null) : null;
-    const context = container !== null
-        ? container.uuid === opts.suppressProject
-            ? ""
-            : // The ↻ prefix (containerLabel) marks a container that is a repeating
-                // TEMPLATE project — the whole `(…)` run is dimmed below, so the mark
-                // rides the muted container styling. Areas never carry the flag.
-                ` (${containerLabel(container.title, container.isRepeatingTemplate === true)})`
-        : item.area
-            ? item.area.uuid === opts.suppressArea
+    // A project-view LOGBOOK row hints its HEADING (the in-project logged toggle
+    // labels the heading — HEADARC2-B) rather than the suppressed project.
+    const headingHint = opts.headingContext === true && item.type === "to-do" && item.heading !== null
+        ? ` (${item.heading.title})`
+        : null;
+    const context = headingHint !== null
+        ? headingHint
+        : container !== null
+            ? container.uuid === opts.suppressProject
                 ? ""
-                : ` (${item.area.title})`
-            : "";
+                : // The ↻ prefix (containerLabel) marks a container that is a repeating
+                    // TEMPLATE project — the whole `(…)` run is dimmed below, so the mark
+                    // rides the muted container styling. Areas never carry the flag. The
+                    // fused uuid-prefix rides when the title would not round-trip (shared
+                    // promotion predicate — the same one JSON `*Uuid` promotion uses).
+                    ` (${containerLabel(container.title, container.isRepeatingTemplate === true)}${promotedRefBracket(container, "project")})`
+            : item.area
+                ? item.area.uuid === opts.suppressArea
+                    ? ""
+                    : ` (${item.area.title}${promotedRefBracket(item.area, "area")})`
+                : "";
     // width 0 (the default) means "no column" — show the full uuid untouched.
     const shownUuid = uuidWidth > 0 ? uuidCol(item.uuid, uuidWidth) : item.uuid;
     // Title styling composes four independent channels (docs/design/render-
@@ -167,10 +190,13 @@ export function formatItem(item, uuidWidth = 0, opts = {}) {
             t = underline(t);
         return t;
     };
-    // GUI indicator order after the title: bell, document, checklist.
+    // GUI indicator order after the title: bell, document, checklist. The bell
+    // rides the presence-keyed `reminderLive` marker (§9n) — the SAME materialize-
+    // time gate the JSON wire's `reminder` key uses, so a stale reminder (past
+    // startDate, bell hidden in the GUI) shows no chip here either.
     const tail = [
         ...(item.type === "project" ? [countChip(item)] : []),
-        ...(item.reminder !== null ? [dim(REMINDER_MARK)] : []),
+        ...(item.reminderLive === true ? [dim(REMINDER_MARK)] : []),
         ...(item.notes !== "" ? [dim(NOTES_MARK)] : []),
         ...(item.type === "to-do" && item.checklistItemsCount > 0 ? [dim(CHECKLIST_MARK)] : []),
     ];
@@ -208,13 +234,17 @@ export function formatItem(item, uuidWidth = 0, opts = {}) {
  * effective This-Evening members (raw evening assignment counts only while
  * startDate is exactly today — the UI's daily expiry), null otherwise.
  */
-export function todayMark(item, now) {
-    const instant = now ?? renderNow();
-    const zone = renderZone();
-    if (!isTodayMember(item, instant, zone))
-        return null;
-    const evening = item.todaySection === "evening" && item.startDate === localToday(instant, zone);
-    return evening ? eveningMoon() : todayStar();
+export function todayMark(item) {
+    // Consume the ONE derived `when` (the same value the wire emits) so a row's
+    // ★/⏾ can never disagree with the emitted `when` — never re-derive membership
+    // or evening from `todaySection`/`startBucket`/`startDate`. Projects carry the
+    // Today markers exactly like to-dos (probe O12), so they pip identically.
+    const when = entityWhen(item);
+    if (when === "evening")
+        return eveningMoon();
+    if (when === "today")
+        return todayStar();
+    return null;
 }
 /** Minimum displayed-prefix length: shorter prefixes collide across the DB. */
 export const UUID_DISPLAY_MIN = 8;
@@ -319,12 +349,36 @@ export function renderList(items) {
     return items.length === 0 ? ["(empty)"] : items.map((i) => formatItem(i, w));
 }
 /**
- * The `things today` split. The membership glyph lives in the SECTION HEADER,
- * not on every row — a yellow ★ in the Today header (which also carries the
- * sidebar badge split) and a blue ⏾ in the This Evening header — so the rows
- * drop the redundant per-item marker (the same convention that suppresses a
- * `(project)` context inside that project's own view). Every OTHER view keeps
- * the per-row ★/⏾, where the marker still carries information.
+ * The Today-view per-row mark: a provisional Today member fills the after-the-box
+ * mark slot with a yellow `•` (see {@link renderToday}). Derived through
+ * {@link entityProvisional}, the SAME law the wire emit boundary uses.
+ */
+const provisionalRowOpts = (i) => entityProvisional(i) ? { mark: provisionalPip() } : {};
+/** A today row's This-Evening membership — the SAME `when` axis the wire carries. */
+const isEveningRow = (i) => entityWhen(i) === "evening";
+/**
+ * The `things today` view. The wire is one flat `items[]` of Today members; the
+ * TTY re-projects the GUI's two render sections from each row's `when` — a
+ * Today-proper block (`when: "today"`) and a This-Evening block
+ * (`when: "evening"`). The whole-view `counts` aggregate (the app's sidebar
+ * count) renders at the TOP as card-style metadata lines (indented `key: value`,
+ * the same convention `things project show` / `things area show` use), so the
+ * section header itself stays clean (`── ★ Today ──`).
+ *
+ * The membership glyph lives in the SECTION HEADER, not on every row — a yellow ★
+ * in the Today header and a blue ⏾ in the This Evening header — so the rows drop
+ * the redundant per-item marker (the same convention that suppresses a
+ * `(project)` context inside that project's own view). Every OTHER view keeps the
+ * per-row ★/⏾, where the marker still carries information.
+ *
+ * A PROVISIONAL Today member (the wire's presence-keyed `provisional`, BANNER1
+ * law — a Today entrant the app has not yet materialized, banner-counted until
+ * acknowledged) gets a yellow `•` in the freed mark slot, mirroring the GUI's
+ * yellow "new item" pip. It is per-row (it distinguishes rows within a section,
+ * so it is NOT header-deduped like the ★) and — per the GUI — renders ONLY here,
+ * never in anytime or any other view. Derived through {@link entityProvisional},
+ * the SAME law the wire emit boundary uses, so the pip can never disagree with
+ * the emitted `provisional`.
  *
  * This Evening mirrors the GUI: it renders ONLY when evening items exist —
  * a truly-empty evening has no header at all. `view` is the rows that survived
@@ -343,30 +397,39 @@ export function renderList(items) {
  * because that section is deliberately filtered out, not merely empty.
  */
 export function renderToday(view, sections, base, options) {
-    // Pre-cap totals from the truncation metadata; fall back to the shown view's
+    // The two render sections are re-projected from each row's `when` (the SAME
+    // axis the wire carries), so the TTY split can never disagree with the JSON.
+    const todayRows = view.items.filter((i) => !isEveningRow(i));
+    const eveningRows = view.items.filter(isEveningRow);
+    // Pre-cap totals from the truncation metadata; fall back to the shown rows'
     // own lengths when a caller hands an unbounded view with no section counts.
-    const todayTotal = sections?.find((s) => s.key === "today")?.total ?? view.today.length;
-    const eveningTotal = sections?.find((s) => s.key === "evening")?.total ?? view.evening.length;
-    const w = uuidDisplayWidth([...view.today, ...view.evening]);
+    const todayTotal = sections?.find((s) => s.key === "today")?.total ?? todayRows.length;
+    const eveningTotal = sections?.find((s) => s.key === "evening")?.total ?? eveningRows.length;
+    const w = uuidDisplayWidth(view.items);
     const eveningOnly = options?.eveningOnly === true;
-    const lines = eveningOnly
-        ? []
-        : [
-            `${bold("──")} ${todayStar()} ${bold(`Today (badge: ${view.badge.dueOrOverdue} due/overdue · ${view.badge.other} other) ──`)}`,
-            ...(view.today.length === 0 ? ["(empty)"] : view.today.map((i) => formatItem(i, w))),
-        ];
+    // The whole-view counts, at the TOP as card-style metadata lines (the
+    // project/area-show header convention). A `0` is meaningful, so both always show.
+    const lines = [
+        `  ${dim("due/overdue:")} ${view.counts.dueOrOverdue}`,
+        `  ${dim("other:")} ${view.counts.other}`,
+    ];
+    if (!eveningOnly) {
+        lines.push(`${bold("──")} ${todayStar()} ${bold("Today ──")}`, ...(todayRows.length === 0
+            ? ["(empty)"]
+            : todayRows.map((i) => formatItem(i, w, provisionalRowOpts(i)))));
+    }
     if (eveningTotal > 0) {
         // A blank line before the header matches every other grouped renderer's
         // section spacing — but only when the Today section rendered above it. In
-        // --evening mode the header is the first line, so no leading blank.
+        // --evening mode the header follows the count lines directly, no blank.
         if (!eveningOnly)
             lines.push("");
         lines.push(`${bold("──")} ${eveningMoon()} ${bold("This Evening ──")}`);
-        for (const i of view.evening)
-            lines.push(formatItem(i, w));
-        const hidden = eveningTotal - view.evening.length;
+        for (const i of eveningRows)
+            lines.push(formatItem(i, w, provisionalRowOpts(i)));
+        const hidden = eveningTotal - eveningRows.length;
         if (hidden > 0) {
-            const more = view.evening.length > 0 ? "more " : "";
+            const more = eveningRows.length > 0 ? "more " : "";
             const count = `${hidden} ${more}evening item${hidden === 1 ? "" : "s"}`;
             // Normal Today view: the global truncation footer already carries the
             // quantity levers (a bigger --limit / --all), so this hint is a pure
@@ -390,20 +453,25 @@ export function renderToday(view, sections, base, options) {
     return lines;
 }
 /**
- * Search rows: a standard list row, plus — for a project surfaced by a HEADING
- * title match — a muted `(via heading "…")` suffix crediting the heading whose
- * text matched (the parent project row stands in for the heading; the GUI has
- * no bare heading row). Ordinary title/notes matches render as plain rows.
+ * Search rows: a standard list row, plus — for a hit surfaced by something OTHER
+ * than its title — an indented muted matched-on line crediting WHERE the query
+ * matched (`  ⤷ heading: "…"` / `  ⤷ notes: "…snippet…"` / `  ⤷ checklist: "…"`).
+ * A title match renders as a plain row with no indicator (matched where you'd
+ * expect). A heading match credits the parent project, a checklist match the
+ * parent to-do (the GUI has no bare heading/checklist row).
  */
 export function renderSearch(items) {
     if (items.length === 0)
         return ["(empty)"];
     const w = uuidDisplayWidth(items);
-    return items.map((i) => {
-        const via = i.matchedVia;
-        const row = formatItem(i, w);
-        return via === undefined ? row : `${row} ${dim(`(via heading "${via.title}")`)}`;
-    });
+    const lines = [];
+    for (const i of items) {
+        lines.push(formatItem(i, w));
+        const match = i.match;
+        if (match !== undefined)
+            lines.push(`  ${dim(`⤷ ${match.field}: "${match.text}"`)}`);
+    }
+    return lines;
 }
 /**
  * The sidebar mirror for `things projects`: loose projects first (the GUI
@@ -445,7 +513,12 @@ export function renderProjectsSidebar(items, hints) {
                 lines.push("");
             lines.push(`${bold("──")} ${areaMark()} ${bold(`${group.area.title} ──`)}`);
         }
-        lines.push(...rows.map((item) => formatItem(item, w, { suppressArea: group.area?.uuid ?? null })));
+        lines.push(...rows.map((item) => formatItem(item, w, {
+            suppressArea: group.area?.uuid ?? null,
+            // Projects can live in Today/This-Evening (probe O12) — pip them
+            // exactly like a to-do row would be in a today-aware view.
+            mark: todayMark(item),
+        })));
         // A per-group locator count (not a standalone disclosure): it marks WHERE
         // the hidden later projects sit; the single reveal command rides the
         // whole-view placeholder below.
@@ -638,11 +711,11 @@ function mixedMoreLine(projects, todos, drill) {
 function areaBlockFor(grouped, area) {
     const kind = area === null ? "loose" : "area";
     const ref = area?.uuid ?? null;
-    return grouped.blocks.find((b) => b.kind === kind && b.ref === ref);
+    return (grouped.blocks ?? []).find((b) => b.kind === kind && b.ref === ref);
 }
 /** A nested project block anywhere in the grouped metadata, matched by project uuid. */
 function projectBlockFor(grouped, projectUuid) {
-    for (const b of grouped.blocks) {
+    for (const b of grouped.blocks ?? []) {
         const hit = b.children?.find((c) => c.kind === "project" && c.ref === projectUuid);
         if (hit !== undefined)
             return hit;