@fangorn-network/westmarch 0.0.1-dev → 0.0.2-dev

package/site/dist/index.html

@@ -0,0 +1,20 @@
+<!doctype html>
+<html lang="en">
+<script type="module" crossorigin src="./assets/index-DlzVyQ_9.js"></script>
+<link rel="modulepreload" crossorigin href="./assets/rolldown-runtime-Dd_uD5pT.js">
+<link rel="modulepreload" crossorigin href="./assets/preload-helper-uBIymjUX.js">
+<link rel="modulepreload" crossorigin href="./assets/roles-C9V_uDr_.js">
+
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Fangorn app</title>
+<style>:root{--bg:#fbfaf7;--card:#fff;--fg:#1d1d1b;--muted:#6b6a66;--accent:#2b5d8a;--line:#e4e1da;--chip:#efece5}@media (prefers-color-scheme:dark){:root{--bg:#151514;--card:#1c1c1a;--fg:#ecebe6;--muted:#9a988f;--accent:#7fb0dc;--line:#2c2b28;--chip:#262522}}body{background:var(--bg);color:var(--fg);max-width:800px;margin:0 auto;padding:32px 16px;font:16px/1.5 system-ui,sans-serif}h1{letter-spacing:-.01em;margin:0 0 4px;font-size:1.7rem}#about{color:var(--muted);margin:0 0 20px}input{box-sizing:border-box;width:100%;font:inherit;border:1px solid var(--line);background:var(--card);color:inherit;border-radius:10px;padding:11px 14px}#status{color:var(--muted);margin:8px 0 12px;font-size:.85rem}#chips{flex-wrap:wrap;gap:6px;margin-bottom:20px;display:flex}button{font:inherit;cursor:pointer}.chip{border:1px solid var(--line);background:var(--chip);color:var(--fg);border-radius:999px;padding:4px 12px;font-size:.88rem}.chip.on{background:var(--accent);border-color:var(--accent);color:var(--bg)}h2{text-transform:uppercase;letter-spacing:.08em;color:var(--muted);margin:28px 0 10px;font-size:.8rem}article{background:var(--card);border:1px solid var(--line);border-radius:12px;margin-bottom:12px;padding:14px 16px}article header{flex-direction:column;margin-bottom:6px;display:flex}article time{color:var(--muted);font-size:.8rem}h3{margin:0;font-size:1.02rem}ul{margin:0;padding:0;list-style:none}li{border-top:1px solid var(--line);overflow-wrap:anywhere;flex-direction:column;gap:2px;padding:8px 0;display:flex}article li:first-child,#results li:first-child{border-top:0}.detail{color:var(--muted);margin:0;font-size:.9rem}a{color:var(--accent);text-decoration:none}a:hover{text-decoration:underline}small{color:var(--muted)}.more{color:var(--accent);background:0 0;border:0;padding:6px 0 0;font-size:.9rem}.empty{color:var(--muted)}footer{color:var(--muted);margin-top:32px;font-size:.8rem}</style>
+<h1>Fangorn app</h1>
+<p id="about"></p>
+<input type="search" autofocus disabled placeholder="Loading…" aria-label="Search">
+<div id="status">Loading the data…</div>
+<div id="chips"></div>
+<ul id="results" hidden></ul>
+<main id="feed"></main>
+<footer>Search runs in your browser; your query is never sent anywhere. Agents: <a href="./.well-known/agent-card.json">agent card</a>.</footer>
+</html>

package/site/feed.js

@@ -0,0 +1,62 @@
+// The front page without a query: what is coming up and what just happened, one card per
+// occasion (a meeting, an issue, an episode), from the roles the app declared. Nothing here
+// knows what a row is: an occasion is the rows sharing a subtitle and a facet value, and
+// its date is their temporal field.
+import { pick, subtitleOf, titleOf, values } from "../consume/roles.js";
+
+/** The field a reader narrows by first: the app's declared facet, else the first tag with
+ *  a handful of values (a town, not every body in every town). */
+export function facetField(rows, roles) {
+    const count = (f) => new Set(rows.slice(0, 5000).flatMap((r) => values(r[f] ?? ""))).size;
+    return roles.facets?.[0] ?? roles.tags.find((f) => { const n = count(f); return n >= 2 && n <= 12; }) ?? null;
+}
+
+/** Occasions: `{ key, date, place, label, items }`, split into upcoming (soonest first) and
+ *  past (latest first). Items repeat across an occasion's documents (its agenda, its
+ *  minutes): one per title, the one that says what happened. */
+export function occasions(rows, roles, { facet = null, only = null, today = new Date().toISOString().slice(0, 10) } = {}) {
+    const groups = new Map();
+    for (const r of rows) {
+        const date = String(pick(r, roles.temporal) ?? "").slice(0, 10);
+        if (!date) continue;
+        const place = facet ? String(r[facet] ?? "") : "";
+        if (only && place !== only) continue;
+        const label = subtitleOf(r, roles) ?? "";
+        const key = `${place}|${label}|${date}`;
+        let g = groups.get(key);
+        if (!g) groups.set(key, (g = { key, date, place, label, byTitle: new Map() }));
+        const t = titleOf(r, roles), k = t.toLowerCase();
+        const had = g.byTitle.get(k);
+        if (!had || detail(had, roles).length < detail(r, roles).length) g.byTitle.set(k, r);
+    }
+    const all = [...groups.values()].map(({ byTitle, ...g }) => ({ ...g, items: [...byTitle.values()] }));
+    return {
+        upcoming: all.filter((g) => g.date > today).sort((a, b) => a.date.localeCompare(b.date) || a.place.localeCompare(b.place)),
+        past: all.filter((g) => g.date <= today).sort((a, b) => b.date.localeCompare(a.date) || a.place.localeCompare(b.place)),
+    };
+}
+
+/** What a row says beyond its title: its text, less the title it opens with. */
+export function detail(r, roles) {
+    const t = titleOf(r, roles), x = String(r.text ?? "");
+    const rest = x.startsWith(t.replace(/\.$/, "")) ? x.slice(t.replace(/\.$/, "").length).replace(/^[.\s]+/, "") : x;
+    return rest === t ? "" : rest.trim();
+}
+
+// ── self-check: `node site/feed.js` ──
+if (typeof process !== "undefined" && process.argv[1]?.endsWith("/feed.js")) {
+    const { rolesFrom } = await import("../consume/roles.js");
+    const roles = rolesFrom([{ role_map: { title: "heading", subtitle: "meeting", temporal: "date", tags: ["city", "body"], text: ["text"] },
+                               presentation: { facets: ["city"] } }]);
+    const row = (city, date, heading, text = heading) => ({ city, date, heading, meeting: `Board · ${date}`, body: "Board", text });
+    const rows = [row("A", "2026-01-01", "Budget"), row("A", "2026-01-01", "Budget", "Budget. Approved 5-0."), row("A", "2026-01-01", "Roads"),
+                  row("B", "2026-02-01", "Parks"), row("A", "2026-03-01", "Zoning"), { heading: "undated" }];
+    const eq = (a, b, m) => { if (JSON.stringify(a) !== JSON.stringify(b)) throw new Error(`${m}: ${JSON.stringify(a)}`); };
+    eq(facetField(rows, roles), "city", "the declared facet wins");
+    const { upcoming, past } = occasions(rows, roles, { facet: "city", today: "2026-02-15" });
+    eq(upcoming.map((g) => g.key), ["A|Board · 2026-03-01|2026-03-01"], "a future date is coming up");
+    eq(past.map((g) => `${g.place}${g.date}`), ["B2026-02-01", "A2026-01-01"], "past, latest first");
+    eq(past[1].items.map((r) => detail(r, roles)), ["Approved 5-0.", ""], "one item per title, the one that says what happened");
+    eq(occasions(rows, roles, { facet: "city", only: "B", today: "2026-02-15" }).past.length, 1, "narrowed to one place");
+    console.log("feed.js self-check ok — declared facet, upcoming vs past, one item per title keeping the decision, narrowed by place");
+}