@polycode-projects/the-mechanical-code-talker 6.0.16 → 6.0.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polycode-projects/the-mechanical-code-talker",
-  "version": "6.0.16",
+  "version": "6.0.17",
   "private": false,
   "type": "module",
   "description": "The Mechanical Code Talker (tmct) — a tolerant, offline, $0 chat surface that guides you toward precision queries about a software repository. ELIZA/PARRY-style but domain-obsessed with code. No model calls; indexes a repo on request (tmct index) or reads any producer's graph.",

package/src/adapters/corpus/news-sources.mjs

@@ -260,16 +260,24 @@ async function fetchFeedFormat(record, gate, { format, now }) {
  *  carries `wikibaseItem` when the article names one, past normalizeFeedItems
  *  (which only knows the snapshot's own fixed fields) so the news
  *  enrichment loop can short-circuit straight to the Wikidata KB source with
- *  the Q-id already in hand, no lookup needed. */
+ *  the Q-id already in hand, no lookup needed.
+ *
+ *  Neither `news` nor `mostread` carries a per-article timestamp in the raw
+ *  payload — the only date this feed exposes is the UTC calendar day the
+ *  request itself names (the `/YYYY/MM/DD/` path Wikimedia selected these
+ *  articles for), so `publishedAt` is stamped from whichever day's page
+ *  actually answered (the primary day, or the prior day on a 404 retry),
+ *  never from the fetch's own clock. */
 async function fetchWikimediaFeed(record, gate, { now }) {
-  const primaryUrl = wikimediaFeedUrl(record.url, now);
-  let body = await pacedFetchJson(gate, primaryUrl);
+  let feedDay = now;
+  let body = await pacedFetchJson(gate, wikimediaFeedUrl(record.url, feedDay));
   if (body === null) {
     // A 404 means the day's page is not yet published; retry once against
     // the previous UTC day before giving up.
     const prevDay = new Date(now);
     prevDay.setUTCDate(prevDay.getUTCDate() - 1);
-    body = await pacedFetchJson(gate, wikimediaFeedUrl(record.url, prevDay.toISOString()));
+    feedDay = prevDay.toISOString();
+    body = await pacedFetchJson(gate, wikimediaFeedUrl(record.url, feedDay));
     if (body === null) return null;
   }
   if (isNotModified(body)) return { items: [], bytes: 0, notModified: true };
@@ -280,12 +288,14 @@ async function fetchWikimediaFeed(record, gate, { now }) {
       ? body.mostread.articles
       : [];
 
+  const { yyyy, mm, dd } = utcDateParts(feedDay);
+  const feedDayIso = `${yyyy}-${mm}-${dd}T00:00:00.000Z`;
   const raw = articles.map((a) => ({
     guid: a?.wikibase_item || a?.normalizedtitle || a?.title || "",
     title: stripMarkup(a?.normalizedtitle || a?.displaytitle || a?.title || ""),
     url: a?.content_urls?.desktop?.page || "",
     summary: stripMarkup(a?.extract || ""),
-    publishedAt: "",
+    publishedAt: feedDayIso,
     wikibaseItem: a?.wikibase_item || "",
   }));
 

package/src/domain/news-feed.mjs

@@ -548,7 +548,11 @@ function collectSources(subgraphRows, sourcesByFactId) {
     const key = src.url || src.title || "";
     if (!key || seen.has(key)) continue;
     seen.add(key);
-    sources.push({ title: src.title || "", url: src.url || "", name: src.name || "" });
+    const entry = { title: src.title || "", url: src.url || "", name: src.name || "" };
+    // Carried through only when the source snapshot actually has one — a
+    // card for an undated snapshot shows no date rather than a blank field.
+    if (src.publishedAt) entry.publishedAt = src.publishedAt;
+    sources.push(entry);
   }
   return sources;
 }
@@ -657,8 +661,9 @@ export function renderNewsParagraph(hub, subgraphRows, { reportedIds = null } =
 
 /** newsworthyHubs -> one item per hub (PLAN_NEWS_FEED.md section 6.6),
  *  paragraph included, sorted builtAt desc then id asc. `sourcesByFactId`
- *  maps fact ids to snapshot source links ({ title, url, name }). The gate
- *  (PLAN_NEWS_FEED.md section 17): `reportedRows` replaces `newsWindowRows`
+ *  maps fact ids to snapshot source links ({ title, url, name, publishedAt?
+ *  }); publishedAt is present only when the source snapshot carried one.
+ *  The gate (PLAN_NEWS_FEED.md section 17): `reportedRows` replaces `newsWindowRows`
  *  and `newsworthyHubs` replaces `scoreHubs` as this function's own inputs —
  *  both keep their prior behaviour for every other caller. Each item's
  *  two-hop sub-graph then splits into its own `reported`/`background` rows,

package/src/services/news-viz.mjs

@@ -151,6 +151,7 @@ ${THEME_TOKENS_CSS}
   .item .newtag { font-family: ${MONO_STACK}; font-size: .64rem; color: var(--taught); margin-left: .5rem; }
   .item .paragraph { margin: .4rem 0; }
   .item .sources-links { font-size: .74rem; color: var(--muted); }
+  .item .sourcedate { font-family: ${MONO_STACK}; }
   .item details.facts summary { font-family: ${MONO_STACK}; font-size: .68rem; color: var(--corpus); cursor: pointer; }
   .item details.background summary { font-family: ${MONO_STACK}; font-size: .68rem; color: var(--muted); cursor: pointer; }
   .item details.background p { margin: .35rem 0 0; color: var(--muted); }
@@ -482,12 +483,29 @@ ${NEWS_STYLE}
     });
   }
 
+  // The earliest publication date among a card's sources — a lexicographic
+  // min over ISO-8601 UTC strings sorts chronologically without parsing, and
+  // "earliest" reads as when the reported event actually happened rather
+  // than whichever source snapshot the subgraph walk reached last. A source
+  // with no publishedAt (its feed never carries one) never contributes here,
+  // so a card built entirely from undated sources shows no date at all.
+  function earliestSourceDate(sources) {
+    let earliest = null;
+    for (const s of sources || []) {
+      if (!s.publishedAt) continue;
+      if (earliest === null || s.publishedAt < earliest) earliest = s.publishedAt;
+    }
+    return earliest;
+  }
+
   function cardHtml(item) {
     const factLines = item.factLines || [];
     const factsHtml = factLines.map(function (line) { return '<div class="factrow">' + esc(line) + '</div>'; }).join("");
     const moreCount = (item.factCount || 0) - factLines.length;
     const moreHtml = moreCount > 0 ? '<div class="factrow factmore">&hellip;and ' + moreCount + ' more</div>' : "";
     const sourcesText = (item.sources || []).map(function (s) { return esc(s.title || s.url || ""); }).filter(Boolean).join(", ");
+    const sourceDate = earliestSourceDate(item.sources);
+    const dateText = sourceDate ? ' <span class="sourcedate">(' + esc(sourceDate.slice(0, 10)) + ')</span>' : "";
     const background = item.backgroundParagraph
       ? '<details class="background"><summary>what the graph already knew</summary><p>' + esc(item.backgroundParagraph) + '</p></details>'
       : "";
@@ -496,7 +514,7 @@ ${NEWS_STYLE}
       + '<span class="hub">' + esc(item.hub) + '</span><span class="tier">' + esc(item.tier || "unranked") + '</span>' + newTag
       + '<p class="paragraph">' + esc(item.paragraph) + '</p>'
       + background
-      + (sourcesText ? '<p class="sources-links">sources: ' + sourcesText + '</p>' : "")
+      + (sourcesText ? '<p class="sources-links">sources: ' + sourcesText + dateText + '</p>' : "")
       + '<details class="facts"><summary>' + (item.factCount || 0) + ' fact' + (item.factCount === 1 ? "" : "s") + '</summary>' + factsHtml + moreHtml + '</details>'
       + '</div>';
   }

package/src/services/news.mjs

@@ -288,6 +288,10 @@ function buildSourcesByFactId(items) {
   for (const snap of items || []) {
     const record = recordsById.get(snap.sourceId);
     const src = { title: snap.title || "", url: snap.url || "", name: record?.name || snap.sourceId || "" };
+    // A snapshot with no publication timestamp (a source whose own feed never
+    // carries one) leaves the key off entirely — never an invented or blank
+    // date, and never the fetch's own clock standing in for it.
+    if (snap.publishedAt) src.publishedAt = snap.publishedAt;
     for (const factId of snap.factIds || []) map.set(factId, src);
   }
   return map;