@korso/shepherd-ui 0.1.0 → 0.2.0

package/dist/logic.d.ts

@@ -0,0 +1,208 @@
+/**
+ * Pure, auth-agnostic page logic for the Shepherd wallboard.
+ *
+ * Ported verbatim from packages/hub/public/app.js (the original plain-JS single
+ * static page), adding TypeScript types only — behavior is byte-for-byte
+ * identical, as the characterization suite in test/logic.test.ts pins. These are
+ * the page's "Pure helpers" plus the "Glob containment + active-claim grouping"
+ * section; the browser-only DOM-wiring half of app.js is NOT ported here.
+ *
+ * Times are computed against the server's clock (`serverTime` in the payload),
+ * not the browser's, so countdowns and "last seen" stay correct under skew —
+ * hence every time helper takes an explicit `nowMs`/`endedIso` rather than
+ * reading `Date.now()`.
+ *
+ * Note: this module intentionally keeps its OWN browser-subset glob matcher
+ * (normalizeGlob/segmentCovers/patternCovers below); it does not import the
+ * server-side packages/hub/src/globs.ts, which is a deliberately-separate
+ * duplicate.
+ */
+import type { WorkspaceTaskT } from "@shepherd/shared";
+/**
+ * Human "N ago" for a past ISO timestamp, relative to `nowMs` (epoch ms).
+ *
+ * @param iso - A past instant as an ISO 8601 string.
+ * @param nowMs - The reference "now" in epoch milliseconds (the server clock).
+ * @returns A short relative label, e.g. `"just now"`, `"30s ago"`, `"2h ago"`.
+ */
+export declare function formatRelative(iso: string, nowMs: number): string;
+/**
+ * Human "expires in N" / "expired" for a future ISO timestamp, relative to
+ * `nowMs`.
+ *
+ * @param iso - The expiry instant as an ISO 8601 string.
+ * @param nowMs - The reference "now" in epoch milliseconds (the server clock).
+ * @returns `"expired"` once at/past the instant, else e.g. `"expires in 4m"`.
+ */
+export declare function formatCountdown(iso: string, nowMs: number): string;
+/**
+ * Deterministic chat color for an agent name — same name always maps to the
+ * same hue, so each speaker reads consistently across the announcement thread.
+ * Saturation/lightness are tuned to stay legible on the dark background.
+ *
+ * @param name - The agent name (may be empty, which yields hue 0 — never throws).
+ * @returns An `hsl(...)` CSS color string.
+ */
+export declare function colorForName(name: string): string;
+/**
+ * Up to two initials for an avatar. Prefers the capital letters of a CamelCase
+ * agent name (RedDragon → RD); otherwise the first two letters (alice → AL).
+ *
+ * @param name - The agent name; empty yields the `"?"` placeholder.
+ * @returns A 1–2 character uppercase label.
+ */
+export declare function initialsFor(name: string): string;
+/**
+ * The slice of a mention token the autocomplete operates on: `start`/`end` are
+ * the text range to replace when a suggestion is accepted (start = the `@`),
+ * and `query` is the text typed after the `@` (possibly empty).
+ */
+export interface MentionMatch {
+    /** Index of the `@` — the start of the replaceable slice. */
+    start: number;
+    /** The caret index — the end of the replaceable slice. */
+    end: number;
+    /** The mention-name characters between the `@` and the caret. */
+    query: string;
+}
+/**
+ * The active `@mention` immediately to the LEFT of the caret, or null when the
+ * caret isn't in one. Drives the autocomplete: the `@` must start the text or
+ * follow whitespace (so email addresses like `a@b` don't trigger it), and only
+ * mention-name characters may sit between it and the caret.
+ *
+ * @param text - The full input text.
+ * @param caretIndex - The caret position within `text`.
+ * @returns The mention slice and query, or `null` when not in a mention.
+ */
+export declare function parseMention(text: string, caretIndex: number): MentionMatch | null;
+/**
+ * The first `@mention` in `text` that matches a known agent name, returned in
+ * the name's canonical casing (so `@reddragon` resolves to `RedDragon`), or null
+ * when none match. This is what turns a typed message into a directed DM; an
+ * unmatched `@foo` is treated as plain text and the message broadcasts.
+ *
+ * @param text - The message text to scan.
+ * @param knownNames - Canonical agent names to resolve against (case-insensitive).
+ * @returns The canonical name of the first matching mention, or `null`.
+ */
+export declare function extractTarget(text: string, knownNames: string[]): string | null;
+/**
+ * Sorted unique repo identifiers present across the given tasks.
+ *
+ * @param tasks - Items carrying a `repo` (a structural subset of {@link WorkspaceTaskT}).
+ * @returns The distinct repos, ascending.
+ */
+export declare function distinctRepos(tasks: Pick<WorkspaceTaskT, "repo">[]): string[];
+/**
+ * True if `item.repo` matches the selection; `null`/`"__all__"` = all repos.
+ *
+ * @param item - Anything carrying a `repo`.
+ * @param selected - The selected repo, or `null`/`"__all__"` for all.
+ * @returns Whether the item belongs to the current board filter.
+ */
+export declare function matchesRepo(item: {
+    repo: string;
+}, selected: string | null): boolean;
+/**
+ * Live agents addressable by @mention under the current board filter: only those
+ * whose (most-recent) session sits in the selected repo, so a message can't be
+ * directed at someone who isn't in the repo you're viewing. Mirrors the crew the
+ * board already shows for that repo; in All-repos mode everyone live is
+ * addressable. Returns de-duplicated canonical names, sorted.
+ *
+ * @param agents - Agents carrying `name`, `presence`, and `repo` (a structural
+ *   subset of {@link WorkspaceAgentT}).
+ * @param selectedRepo - The selected repo, or `null`/`"__all__"` for all.
+ * @returns Sorted, de-duplicated names of mentionable live agents.
+ */
+export declare function mentionableAgents(agents: {
+    name: string;
+    presence: string;
+    repo: string;
+}[], selectedRepo: string | null): string[];
+/**
+ * First-load default repo: newest active task's repo, else newest task's, else
+ * null.
+ *
+ * @param tasks - Tasks carrying `repo` and `status` (a structural subset of
+ *   {@link WorkspaceTaskT}); assumed newest-first.
+ * @returns The repo to select on first load, or `null` when there are no tasks.
+ */
+export declare function defaultRepo(tasks: Pick<WorkspaceTaskT, "repo" | "status">[]): string | null;
+/**
+ * Human label for a history task's status.
+ *
+ * @param status - The task status.
+ * @returns `"dropped"` for a dropped task, otherwise `"done"`.
+ */
+export declare function statusLabel(status: string): string;
+/**
+ * "active Nm/Nh" for the created->ended span; "" when the task hasn't ended.
+ *
+ * @param createdIso - The task's creation instant (ISO 8601 string).
+ * @param endedIso - The task's end instant, or `null` while still active.
+ * @returns A duration label, or the empty string for an unfinished task.
+ */
+export declare function formatActiveDuration(createdIso: string, endedIso: string | null): string;
+/**
+ * Local-day bucket label: "Today" / "Yesterday" / "Mon D".
+ *
+ * @param iso - The instant to bucket (ISO 8601 string).
+ * @param nowMs - The reference "now" in epoch milliseconds.
+ * @returns `"Today"`, `"Yesterday"`, or a short month/day label.
+ */
+export declare function dayBucket(iso: string, nowMs: number): string;
+/**
+ * Does glob set `outer` fully cover glob set `inner` — every path `inner` could
+ * touch already inside `outer`? Conservative: unsure -> false, so a caller only
+ * folds a claim it's certain is contained (a false negative just shows both
+ * claims, which is safe). An empty `inner` is trivially covered.
+ *
+ * @param outer - The candidate broader glob set.
+ * @param inner - The candidate narrower glob set.
+ * @returns Whether every glob in `inner` is covered by some glob in `outer`.
+ */
+export declare function globsCover(outer: string[], inner: string[]): boolean;
+/**
+ * The fields a claim must carry to be grouped: its agent, glob territory, and
+ * creation order, plus the header fields surfaced on the group. A structural
+ * subset of {@link WorkspaceTaskT}, so callers may pass partial task shapes.
+ */
+export type ClaimLike = Pick<WorkspaceTaskT, "agentName" | "pathGlobs" | "createdAt" | "model" | "program" | "repo">;
+/**
+ * One agent's grouped active claims for the board. `primaries` are the visible
+ * claims; `narrower` are those strictly covered by a broader sibling and folded
+ * away. Header fields (model/program/repo) come from the group's newest claim.
+ *
+ * @typeParam T - The concrete claim shape passed in, preserved on the members.
+ */
+export interface ClaimGroup<T extends ClaimLike = ClaimLike> {
+    /** The agent these claims belong to. */
+    agentName: string;
+    /** Representative model from the group's newest claim. */
+    model: T["model"];
+    /** Representative program from the group's newest claim. */
+    program: T["program"];
+    /** Representative repo from the group's newest claim. */
+    repo: T["repo"];
+    /** Visible claims, newest-first. */
+    primaries: T[];
+    /** Claims folded under a broader sibling, newest-first. */
+    narrower: T[];
+}
+/**
+ * Group active claims by agent for the board. Within an agent's claims, one that
+ * is STRICTLY covered by a broader sibling (the sibling covers it but not vice
+ * versa, so identical claims don't cannibalise each other) folds into `narrower`;
+ * everything else stays a visible `primary`. Distinct or merely-overlapping
+ * claims all remain primaries. Pure — no DOM, no clock; `createdAt` drives order.
+ *
+ * Groups are newest-claim-first; `primaries`/`narrower` are each newest-first;
+ * header fields (model/program/repo) come from the group's newest claim.
+ *
+ * @param tasks - The active claims to group (a structural subset of
+ *   {@link WorkspaceTaskT}).
+ * @returns One {@link ClaimGroup} per agent, newest-claim-first.
+ */
+export declare function groupActiveClaims<T extends ClaimLike>(tasks: T[]): ClaimGroup<T>[];

package/dist/logic.js

@@ -0,0 +1,372 @@
+/**
+ * Pure, auth-agnostic page logic for the Shepherd wallboard.
+ *
+ * Ported verbatim from packages/hub/public/app.js (the original plain-JS single
+ * static page), adding TypeScript types only — behavior is byte-for-byte
+ * identical, as the characterization suite in test/logic.test.ts pins. These are
+ * the page's "Pure helpers" plus the "Glob containment + active-claim grouping"
+ * section; the browser-only DOM-wiring half of app.js is NOT ported here.
+ *
+ * Times are computed against the server's clock (`serverTime` in the payload),
+ * not the browser's, so countdowns and "last seen" stay correct under skew —
+ * hence every time helper takes an explicit `nowMs`/`endedIso` rather than
+ * reading `Date.now()`.
+ *
+ * Note: this module intentionally keeps its OWN browser-subset glob matcher
+ * (normalizeGlob/segmentCovers/patternCovers below); it does not import the
+ * server-side packages/hub/src/globs.ts, which is a deliberately-separate
+ * duplicate.
+ */
+/**
+ * Human "N ago" for a past ISO timestamp, relative to `nowMs` (epoch ms).
+ *
+ * @param iso - A past instant as an ISO 8601 string.
+ * @param nowMs - The reference "now" in epoch milliseconds (the server clock).
+ * @returns A short relative label, e.g. `"just now"`, `"30s ago"`, `"2h ago"`.
+ */
+export function formatRelative(iso, nowMs) {
+    const secs = Math.floor((nowMs - Date.parse(iso)) / 1000);
+    if (secs < 5)
+        return "just now";
+    if (secs < 60)
+        return `${secs}s ago`;
+    const mins = Math.floor(secs / 60);
+    if (mins < 60)
+        return `${mins}m ago`;
+    const hrs = Math.floor(mins / 60);
+    if (hrs < 24)
+        return `${hrs}h ago`;
+    return `${Math.floor(hrs / 24)}d ago`;
+}
+/**
+ * Human "expires in N" / "expired" for a future ISO timestamp, relative to
+ * `nowMs`.
+ *
+ * @param iso - The expiry instant as an ISO 8601 string.
+ * @param nowMs - The reference "now" in epoch milliseconds (the server clock).
+ * @returns `"expired"` once at/past the instant, else e.g. `"expires in 4m"`.
+ */
+export function formatCountdown(iso, nowMs) {
+    const secs = Math.floor((Date.parse(iso) - nowMs) / 1000);
+    if (secs <= 0)
+        return "expired";
+    if (secs < 60)
+        return `expires in ${secs}s`;
+    const mins = Math.floor(secs / 60);
+    if (mins < 60)
+        return `expires in ${mins}m`;
+    return `expires in ${Math.floor(mins / 60)}h`;
+}
+/**
+ * Deterministic chat color for an agent name — same name always maps to the
+ * same hue, so each speaker reads consistently across the announcement thread.
+ * Saturation/lightness are tuned to stay legible on the dark background.
+ *
+ * @param name - The agent name (may be empty, which yields hue 0 — never throws).
+ * @returns An `hsl(...)` CSS color string.
+ */
+export function colorForName(name) {
+    let h = 0;
+    for (let i = 0; i < name.length; i++)
+        h = (h * 31 + name.charCodeAt(i)) % 360;
+    return `hsl(${h}, 38%, 42%)`;
+}
+/**
+ * Up to two initials for an avatar. Prefers the capital letters of a CamelCase
+ * agent name (RedDragon → RD); otherwise the first two letters (alice → AL).
+ *
+ * @param name - The agent name; empty yields the `"?"` placeholder.
+ * @returns A 1–2 character uppercase label.
+ */
+export function initialsFor(name) {
+    if (!name)
+        return "?";
+    const caps = name.match(/[A-Z]/g);
+    if (caps && caps.length >= 2)
+        return caps[0] + caps[1];
+    return name.slice(0, 2).toUpperCase();
+}
+/**
+ * Characters allowed in an agent-name mention token. Agent names are CamelCase
+ * (`RedDragon`) or `handle-ordinal` (`daichi-6`), so letters, digits, hyphen,
+ * and underscore. Used by both the autocomplete and target extraction.
+ */
+const MENTION_CHARS = "A-Za-z0-9_-";
+/**
+ * The active `@mention` immediately to the LEFT of the caret, or null when the
+ * caret isn't in one. Drives the autocomplete: the `@` must start the text or
+ * follow whitespace (so email addresses like `a@b` don't trigger it), and only
+ * mention-name characters may sit between it and the caret.
+ *
+ * @param text - The full input text.
+ * @param caretIndex - The caret position within `text`.
+ * @returns The mention slice and query, or `null` when not in a mention.
+ */
+export function parseMention(text, caretIndex) {
+    const before = text.slice(0, caretIndex);
+    const m = before.match(new RegExp(`(?:^|\\s)@([${MENTION_CHARS}]*)$`));
+    if (!m)
+        return null;
+    const query = m[1];
+    return { start: caretIndex - query.length - 1, end: caretIndex, query };
+}
+/**
+ * The first `@mention` in `text` that matches a known agent name, returned in
+ * the name's canonical casing (so `@reddragon` resolves to `RedDragon`), or null
+ * when none match. This is what turns a typed message into a directed DM; an
+ * unmatched `@foo` is treated as plain text and the message broadcasts.
+ *
+ * @param text - The message text to scan.
+ * @param knownNames - Canonical agent names to resolve against (case-insensitive).
+ * @returns The canonical name of the first matching mention, or `null`.
+ */
+export function extractTarget(text, knownNames) {
+    const re = new RegExp(`(?:^|\\s)@([${MENTION_CHARS}]+)`, "g");
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        const typed = m[1].toLowerCase();
+        const hit = knownNames.find((n) => n.toLowerCase() === typed);
+        if (hit)
+            return hit;
+    }
+    return null;
+}
+/**
+ * Sorted unique repo identifiers present across the given tasks.
+ *
+ * @param tasks - Items carrying a `repo` (a structural subset of {@link WorkspaceTaskT}).
+ * @returns The distinct repos, ascending.
+ */
+export function distinctRepos(tasks) {
+    return [...new Set(tasks.map((t) => t.repo))].sort();
+}
+/**
+ * True if `item.repo` matches the selection; `null`/`"__all__"` = all repos.
+ *
+ * @param item - Anything carrying a `repo`.
+ * @param selected - The selected repo, or `null`/`"__all__"` for all.
+ * @returns Whether the item belongs to the current board filter.
+ */
+export function matchesRepo(item, selected) {
+    return selected === null || selected === "__all__" || item.repo === selected;
+}
+/**
+ * Live agents addressable by @mention under the current board filter: only those
+ * whose (most-recent) session sits in the selected repo, so a message can't be
+ * directed at someone who isn't in the repo you're viewing. Mirrors the crew the
+ * board already shows for that repo; in All-repos mode everyone live is
+ * addressable. Returns de-duplicated canonical names, sorted.
+ *
+ * @param agents - Agents carrying `name`, `presence`, and `repo` (a structural
+ *   subset of {@link WorkspaceAgentT}).
+ * @param selectedRepo - The selected repo, or `null`/`"__all__"` for all.
+ * @returns Sorted, de-duplicated names of mentionable live agents.
+ */
+export function mentionableAgents(agents, selectedRepo) {
+    return [
+        ...new Set(agents
+            .filter((a) => a.presence === "live" && matchesRepo(a, selectedRepo))
+            .map((a) => a.name)),
+    ].sort();
+}
+/**
+ * First-load default repo: newest active task's repo, else newest task's, else
+ * null.
+ *
+ * @param tasks - Tasks carrying `repo` and `status` (a structural subset of
+ *   {@link WorkspaceTaskT}); assumed newest-first.
+ * @returns The repo to select on first load, or `null` when there are no tasks.
+ */
+export function defaultRepo(tasks) {
+    const active = tasks.find((t) => t.status === "active");
+    if (active)
+        return active.repo;
+    return tasks.length ? tasks[0].repo : null;
+}
+/**
+ * Human label for a history task's status.
+ *
+ * @param status - The task status.
+ * @returns `"dropped"` for a dropped task, otherwise `"done"`.
+ */
+export function statusLabel(status) {
+    return status === "dropped" ? "dropped" : "done";
+}
+/**
+ * "active Nm/Nh" for the created->ended span; "" when the task hasn't ended.
+ *
+ * @param createdIso - The task's creation instant (ISO 8601 string).
+ * @param endedIso - The task's end instant, or `null` while still active.
+ * @returns A duration label, or the empty string for an unfinished task.
+ */
+export function formatActiveDuration(createdIso, endedIso) {
+    if (!endedIso)
+        return "";
+    const secs = Math.floor((Date.parse(endedIso) - Date.parse(createdIso)) / 1000);
+    const mins = Math.floor(secs / 60);
+    if (mins < 60)
+        return `active ${mins}m`;
+    return `active ${Math.floor(mins / 60)}h`;
+}
+/**
+ * Local-day bucket label: "Today" / "Yesterday" / "Mon D".
+ *
+ * @param iso - The instant to bucket (ISO 8601 string).
+ * @param nowMs - The reference "now" in epoch milliseconds.
+ * @returns `"Today"`, `"Yesterday"`, or a short month/day label.
+ */
+export function dayBucket(iso, nowMs) {
+    const d = new Date(Date.parse(iso));
+    const now = new Date(nowMs);
+    const startOf = (x) => new Date(x.getFullYear(), x.getMonth(), x.getDate()).getTime();
+    const dayDiff = Math.round((startOf(now) - startOf(d)) / 86400000);
+    if (dayDiff <= 0)
+        return "Today";
+    if (dayDiff === 1)
+        return "Yesterday";
+    return d.toLocaleDateString(undefined, { month: "short", day: "numeric" });
+}
+// ---------------------------------------------------------------------------
+// Glob containment + active-claim grouping
+// ---------------------------------------------------------------------------
+/**
+ * Normalize a glob into a segment list. Mirrors the server's normalize
+ * (packages/hub/src/globs.ts) so the two agree on path shape: lowercase,
+ * backslashes -> '/', a trailing slash claims the subtree ('dir/' -> 'dir/**'),
+ * split on '/', and resolve '.'/'..'. Module-private.
+ */
+function normalizeGlob(pattern) {
+    let p = pattern.toLowerCase().replace(/\\/g, "/");
+    if (p.endsWith("/"))
+        p = p.replace(/\/+$/, "") + "/**";
+    const out = [];
+    for (const seg of p.split("/")) {
+        if (seg === "" || seg === ".")
+            continue;
+        if (seg === "..") {
+            if (out.length)
+                out.pop();
+            continue;
+        }
+        out.push(seg);
+    }
+    return out;
+}
+const SEG_WILDCARD = /[*?{}[\]]/;
+/**
+ * Does single-segment pattern `a` cover single-segment pattern `b`? Conservative:
+ * '*' covers any one segment; a literal covers only the identical literal; any
+ * other wildcard ('?', braces, brackets) covers only a byte-identical segment.
+ * Module-private.
+ */
+function segmentCovers(a, b) {
+    if (a === "*")
+        return true;
+    if (SEG_WILDCARD.test(a))
+        return a === b;
+    return !SEG_WILDCARD.test(b) && a === b;
+}
+/**
+ * Does pattern A (segments) cover pattern B (segments) — i.e. every concrete path
+ * matching B also matches A? '**' in A consumes zero-or-more B segments; a bounded
+ * (non-'**') A segment can NEVER cover a B '**' (the safety gate that stops a
+ * shallow claim from swallowing a deep one). Memoized on the (i, j) suffix.
+ * Module-private.
+ */
+function patternCovers(a, b) {
+    const memo = new Map();
+    function go(i, j) {
+        if (b.length - j === 0) {
+            // B exhausted: A covers iff its remainder matches the empty tail, i.e.
+            // every remaining A segment is '**' (which can consume zero segments).
+            for (let k = i; k < a.length; k++)
+                if (a[k] !== "**")
+                    return false;
+            return true;
+        }
+        if (a.length - i === 0)
+            return false; // A exhausted, B still has depth
+        const key = i * (b.length + 1) + j;
+        const cached = memo.get(key);
+        if (cached !== undefined)
+            return cached;
+        const ah = a[i], bh = b[j];
+        let res;
+        if (ah === "**") {
+            res = go(i + 1, j) || go(i, j + 1); // consume zero, or one B segment
+        }
+        else if (bh === "**") {
+            res = false; // bounded A segment cannot cover an unbounded B '**'
+        }
+        else {
+            res = segmentCovers(ah, bh) && go(i + 1, j + 1);
+        }
+        memo.set(key, res);
+        return res;
+    }
+    return go(0, 0);
+}
+/**
+ * Does glob set `outer` fully cover glob set `inner` — every path `inner` could
+ * touch already inside `outer`? Conservative: unsure -> false, so a caller only
+ * folds a claim it's certain is contained (a false negative just shows both
+ * claims, which is safe). An empty `inner` is trivially covered.
+ *
+ * @param outer - The candidate broader glob set.
+ * @param inner - The candidate narrower glob set.
+ * @returns Whether every glob in `inner` is covered by some glob in `outer`.
+ */
+export function globsCover(outer, inner) {
+    if (inner.length === 0)
+        return true;
+    const o = outer.map(normalizeGlob);
+    return inner.every((g) => {
+        const ng = normalizeGlob(g);
+        return o.some((op) => patternCovers(op, ng));
+    });
+}
+/**
+ * Group active claims by agent for the board. Within an agent's claims, one that
+ * is STRICTLY covered by a broader sibling (the sibling covers it but not vice
+ * versa, so identical claims don't cannibalise each other) folds into `narrower`;
+ * everything else stays a visible `primary`. Distinct or merely-overlapping
+ * claims all remain primaries. Pure — no DOM, no clock; `createdAt` drives order.
+ *
+ * Groups are newest-claim-first; `primaries`/`narrower` are each newest-first;
+ * header fields (model/program/repo) come from the group's newest claim.
+ *
+ * @param tasks - The active claims to group (a structural subset of
+ *   {@link WorkspaceTaskT}).
+ * @returns One {@link ClaimGroup} per agent, newest-claim-first.
+ */
+export function groupActiveClaims(tasks) {
+    const byAgent = new Map();
+    for (const t of tasks) {
+        if (!byAgent.has(t.agentName))
+            byAgent.set(t.agentName, []);
+        byAgent.get(t.agentName).push(t);
+    }
+    const newestFirst = (a, b) => b.createdAt.localeCompare(a.createdAt);
+    const groups = [];
+    for (const [agentName, claims] of byAgent) {
+        const sorted = [...claims].sort(newestFirst);
+        const isNarrower = sorted.map((c) => sorted.some((o) => o !== c &&
+            globsCover(o.pathGlobs, c.pathGlobs) &&
+            !globsCover(c.pathGlobs, o.pathGlobs)));
+        const head = sorted[0];
+        groups.push({
+            agentName,
+            model: head.model,
+            program: head.program,
+            repo: head.repo,
+            primaries: sorted.filter((_, i) => !isNarrower[i]),
+            narrower: sorted.filter((_, i) => isNarrower[i]),
+        });
+    }
+    groups.sort((g1, g2) => {
+        const t1 = g1.primaries.concat(g1.narrower)[0].createdAt;
+        const t2 = g2.primaries.concat(g2.narrower)[0].createdAt;
+        return t2.localeCompare(t1);
+    });
+    return groups;
+}

package/dist/main.d.ts

@@ -0,0 +1 @@
+import "./styles.css";

package/dist/main.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import "./styles.css";
+import { SelfHostApp } from "./selfhost.js";
+/**
+ * SPA mount point for the self-host app build. Bundles the stylesheet (the
+ * standalone build ships its own CSS, unlike the `.` lib export which leaves
+ * styling opt-in) and mounts the token-gated {@link SelfHostApp} at #root.
+ */
+createRoot(document.getElementById("root")).render(_jsx(StrictMode, { children: _jsx(SelfHostApp, {}) }));

package/dist/selfhost/assets/{index-tSyzirZa.css → index-BZmImfYZ.css}

@@ -1 +1 @@
-:root{--bg:#ece0c6;--ink:#322c20;--ink2:#6f6450;--ink3:#9c917a;--line:#d7c9ac;--line2:#e0d4b9;--live:#3d8b58;--drop:#bd4f3a;--chip:#e3d6ba;--terr:#7a6a48;--card:#f5ecd9}*{box-sizing:border-box}html,body{height:100%}body{margin:0;background:var(--bg);color:var(--ink);font:14px/1.45 Inter,ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif;-webkit-font-smoothing:antialiased}.wrap{max-width:1100px;margin:0 auto;padding:40px 44px}header{display:flex;align-items:center;gap:12px;padding-bottom:18px;border-bottom:1px solid var(--line)}#board:has(#panel-chat:not([hidden])) header{border-bottom:0}.brand{font-size:17px;font-weight:600}.vitals{color:var(--ink3);font-size:12.5px}.grow{flex:1}.status{font-size:12px;color:var(--ink3)}.status--ok{color:var(--live)}.status--warn{color:var(--terr)}.status--error{color:var(--drop)}.freshness{font-size:12px;color:var(--ink3)}.repo{position:relative}.repo-trig{display:inline-flex;align-items:center;gap:6px;font-size:13px;font-family:inherit;color:var(--ink);-webkit-appearance:none;-moz-appearance:none;appearance:none;border:1px solid var(--line);border-radius:8px;padding:4px 10px;background:#fffaee66;cursor:pointer}.repo-trig .slash{color:var(--ink3)}.repo-menu{position:absolute;top:36px;left:0;min-width:200px;background:var(--card);border:1px solid var(--line);border-radius:10px;padding:5px;box-shadow:0 8px 24px #32281424;z-index:5}.repo-mi{display:flex;justify-content:space-between;gap:14px;padding:7px 9px;width:100%;text-align:left;border:0;-webkit-appearance:none;-moz-appearance:none;appearance:none;font-family:inherit;color:inherit;background:transparent;border-radius:7px;font-size:13px;cursor:pointer}.repo-mi:hover{background:var(--chip)}.repo-mi.on{background:var(--chip);font-weight:600}.repo-mi .ct{font-size:11px;color:var(--ink3)}.repo-mi.all{border-top:1px solid var(--line2);margin-top:4px;padding-top:9px;color:var(--ink2)}.tabs{display:flex;gap:4px;margin-left:auto}.tab{font-size:13px;color:var(--ink2);padding:5px 11px;border:0;border-radius:7px;background:transparent;cursor:pointer;font:inherit}.tab--active{background:var(--ink);color:var(--bg)}.crew{display:flex;align-items:center;gap:8px;flex-wrap:wrap;margin:26px 0 32px}.person{display:inline-flex;align-items:center;gap:9px;padding:5px 13px 5px 5px;border:1px solid var(--line);border-radius:999px;background:var(--card);font-size:13px}.person--idle{opacity:.55}.avatar{width:24px;height:24px;border-radius:50%;display:grid;place-items:center;font-size:10px;font-weight:700;color:#fff;flex:none}.person__name{font-weight:600}.person__doing{color:var(--ink3);font-size:12px}.board{display:grid;grid-template-columns:1fr 1px 1fr;gap:0}.board__rule{background:var(--line)}.col{padding:0 36px}.col:first-child{padding-left:0}.col:last-child{padding-right:0}.colhead{display:flex;align-items:center;gap:8px;margin-bottom:6px}.colhead h2{font-size:12px;font-weight:600;letter-spacing:.03em;margin:0;text-transform:uppercase;color:var(--ink2)}.colhead .n{font-size:11px;color:var(--ink3);background:var(--chip);border-radius:999px;padding:1px 8px}.task{padding:16px 0;border-bottom:1px solid var(--line2)}.task__r1{display:flex;align-items:center;gap:8px}.task__who{font-size:13.5px;font-weight:600}.task__tag{font-size:11px;color:var(--ink3)}.task__repo{font-size:11px;color:var(--terr);background:#7a6a481a;border-radius:4px;padding:0 6px}.task__stat{margin-left:auto;font-size:11px;font-weight:500;color:var(--ink3)}.task__stat--drop{color:var(--drop)}.livedot{width:7px;height:7px;border-radius:50%;background:var(--live);margin-left:auto}.task__intent{font-size:13.5px;margin:5px 0 0;line-height:1.45}.terr{margin-top:8px;display:flex;flex-wrap:wrap;gap:6px;align-items:center}.terr__lbl{font-size:9.5px;text-transform:uppercase;letter-spacing:.05em;color:var(--ink3)}.glob{font-family:ui-monospace,Menlo,monospace;font-size:11px;color:var(--terr);background:#7a6a481f;border:1px solid rgba(122,106,72,.22);border-radius:5px;padding:1px 7px}.task__meta{font-size:11.5px;color:var(--ink3);margin-top:6px}.terrx{margin-top:8px}.terrx summary{list-style:none;cursor:pointer;display:flex;align-items:center;gap:6px;flex-wrap:wrap;-webkit-user-select:none;user-select:none}.terrx summary::-webkit-details-marker{display:none}.terrx .terr--full{margin-top:8px}.glob--more{cursor:pointer;color:var(--ink2);background:var(--chip);border:1px solid var(--line)}.glob--more .tw{color:var(--ink3);display:inline-block;transition:transform .15s}.terrx[open] summary .glob--more .tw{transform:rotate(90deg)}.grp{padding:16px 0;border-bottom:1px solid var(--line2)}.grp__head{display:flex;align-items:center;gap:8px}.grp__who{font-size:13.5px;font-weight:600}.grp__tag,.grp__count{font-size:11px;color:var(--ink3)}.grp__dot{width:7px;height:7px;border-radius:50%;background:var(--live);margin-left:auto}.claims{margin:10px 0 0 6px;padding-left:14px;border-left:1px solid var(--line)}.claim{padding:6px 0}.claim+.claim{border-top:1px solid var(--line2);margin-top:6px}.fold{margin-top:10px}.fold summary{list-style:none;cursor:pointer;font-size:12px;color:var(--ink2);display:inline-flex;align-items:center;gap:6px;-webkit-user-select:none;user-select:none}.fold summary::-webkit-details-marker{display:none}.fold summary .tw{display:inline-block;color:var(--ink3);transition:transform .15s}.fold[open] summary .tw{transform:rotate(90deg)}.fold__body{margin:8px 0 0 6px;padding-left:14px;border-left:1px dashed var(--line)}.covered{font-size:10.5px;color:var(--ink3);font-style:italic;margin-top:4px}.day{font-size:11px;color:var(--ink3);padding:18px 0 2px;font-weight:600}.more{margin-top:20px;font-size:12.5px;color:var(--ink2);padding:7px 13px;border:1px solid var(--line);border-radius:8px;background:#fffaee59;cursor:pointer}.empty{color:var(--ink3);font-style:italic;padding:14px 0}.chat-wrap{background:var(--card);border:1px solid var(--line);border-radius:12px;display:flex;flex-direction:column;overflow:hidden;height:calc(100vh - 150px);min-height:320px}.chat{flex:1;overflow-y:auto;padding:16px}.chat{scrollbar-width:thin;scrollbar-color:var(--line) transparent}.chat::-webkit-scrollbar{width:10px}.chat::-webkit-scrollbar-track{background:transparent}.chat::-webkit-scrollbar-thumb{background:var(--line);border-radius:999px;border:3px solid var(--card);background-clip:padding-box}.chat::-webkit-scrollbar-thumb:hover{background:var(--ink3);background-clip:padding-box}.chat__note{padding:9px 16px;font-size:11.5px;color:var(--ink3)}.msg{display:flex;gap:11px;padding:9px 0}.msg__avatar{flex:none;width:32px;height:32px;border-radius:50%;display:grid;place-items:center;font-size:12px;font-weight:700;color:#fff}.msg__body{min-width:0;flex:1}.msg__head{display:flex;align-items:baseline;gap:8px;flex-wrap:wrap}.msg__who{font-weight:600}.msg__human{font-size:12px;color:var(--ink3)}.msg__to{font-size:11.5px;color:var(--terr)}.msg__time{font-size:11.5px;color:var(--ink3);margin-left:auto}.msg__text{margin-top:3px;padding:8px 12px;border-radius:4px 12px 12px;background:var(--chip);white-space:pre-wrap;word-break:break-word}.msg--targeted .msg__text{box-shadow:inset 3px 0 0 var(--terr)}.msg--me,.msg--me .msg__head{flex-direction:row-reverse}.msg--me .msg__time{margin-left:0;margin-right:auto}.msg--me .msg__body{display:flex;flex-direction:column;align-items:flex-end}.msg--me .msg__text{border-radius:12px 4px 12px 12px;background:#d4e7d2}.msg--me.msg--targeted .msg__text{box-shadow:inset -3px 0 0 var(--terr)}.composer{position:relative;border-top:1px solid var(--line);padding:10px 12px}.chat-form{display:flex;gap:8px}.chat-input{flex:1;padding:9px 12px;border-radius:8px;border:1px solid var(--line);background:var(--bg);color:var(--ink);font:inherit}.chat-input:focus{outline:none;border-color:var(--terr)}.chat-send{padding:9px 16px;border-radius:8px;border:1px solid var(--ink);background:var(--ink);color:var(--bg);font-weight:600;cursor:pointer;font:inherit}.chat-send:disabled{opacity:.5;cursor:default}.mention-pop{position:absolute;left:12px;right:12px;bottom:56px;z-index:6;background:var(--card);border:1px solid var(--line);border-radius:10px;padding:5px;box-shadow:0 8px 24px #32281429;max-height:200px;overflow-y:auto}.mention-mi{display:flex;align-items:center;gap:9px;width:100%;text-align:left;border:0;-webkit-appearance:none;-moz-appearance:none;appearance:none;font-family:inherit;color:inherit;background:transparent;border-radius:7px;padding:6px 8px;font-size:13px;cursor:pointer}.mention-mi:hover,.mention-mi.on{background:var(--chip)}.mention-mi .ma{width:22px;height:22px;border-radius:50%;display:grid;place-items:center;font-size:9px;font-weight:700;color:#fff;flex:none}.gate{max-width:420px;margin:12vh auto 0;text-align:center}.gate h1{font-size:19px;margin:0 0 6px}.gate p{color:var(--ink2);margin:0 0 20px}.gate form{display:flex;gap:8px}.gate input{flex:1;padding:10px 12px;border-radius:8px;border:1px solid var(--line);background:var(--card);color:var(--ink)}.gate button{padding:10px 16px;border-radius:8px;border:1px solid var(--ink);background:var(--ink);color:var(--bg);font-weight:600;cursor:pointer}
+:root{--bg:#ece0c6;--ink:#322c20;--ink2:#6f6450;--ink3:#9c917a;--line:#d7c9ac;--line2:#e0d4b9;--live:#3d8b58;--drop:#bd4f3a;--chip:#e3d6ba;--terr:#7a6a48;--card:#f5ecd9}*{box-sizing:border-box}html,body{height:100%}body{margin:0;background:var(--bg);color:var(--ink);font:14px/1.45 Inter,ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif;-webkit-font-smoothing:antialiased}.wrap{max-width:1100px;margin:0 auto;padding:40px 44px}header{display:flex;align-items:center;gap:12px;padding-bottom:18px;border-bottom:1px solid var(--line)}#board:has(#panel-chat:not([hidden])) header{border-bottom:0}.brand{font-size:17px;font-weight:600}.vitals{color:var(--ink3);font-size:12.5px}.grow{flex:1}.status{font-size:12px;color:var(--ink3)}.status--ok{color:var(--live)}.status--warn{color:var(--terr)}.status--error{color:var(--drop)}.freshness{font-size:12px;color:var(--ink3)}.repo{position:relative}.repo-trig{display:inline-flex;align-items:center;gap:6px;font-size:13px;font-family:inherit;color:var(--ink);-webkit-appearance:none;-moz-appearance:none;appearance:none;border:1px solid var(--line);border-radius:8px;padding:4px 10px;background:#fffaee66;cursor:pointer}.repo-trig .slash{color:var(--ink3)}.repo-menu{position:absolute;top:36px;left:0;min-width:200px;background:var(--card);border:1px solid var(--line);border-radius:10px;padding:5px;box-shadow:0 8px 24px #32281424;z-index:5}.repo-mi{display:flex;justify-content:space-between;gap:14px;padding:7px 9px;width:100%;text-align:left;border:0;-webkit-appearance:none;-moz-appearance:none;appearance:none;font-family:inherit;color:inherit;background:transparent;border-radius:7px;font-size:13px;cursor:pointer}.repo-mi:hover{background:var(--chip)}.repo-mi.on{background:var(--chip);font-weight:600}.repo-mi .ct{font-size:11px;color:var(--ink3)}.repo-mi.all{border-top:1px solid var(--line2);margin-top:4px;padding-top:9px;color:var(--ink2)}.tabs{display:flex;gap:4px;margin-left:auto}.tab{font-size:13px;color:var(--ink2);padding:5px 11px;border:0;border-radius:7px;background:transparent;cursor:pointer;font:inherit}.tab--active{background:var(--ink);color:var(--bg)}.crew{display:flex;align-items:center;gap:8px;flex-wrap:wrap;margin:26px 0 32px}.person{display:inline-flex;align-items:center;gap:9px;padding:5px 13px 5px 5px;border:1px solid var(--line);border-radius:999px;background:var(--card);font-size:13px}.person--idle{opacity:.55}.avatar{width:24px;height:24px;border-radius:50%;display:grid;place-items:center;font-size:10px;font-weight:700;color:#fff;flex:none}.person__name{font-weight:600}.person__doing{color:var(--ink3);font-size:12px}.board{display:grid;grid-template-columns:1fr 1px 1fr;gap:0}.board__rule{background:var(--line)}.col{padding:0 36px}.col:first-child{padding-left:0}.col:last-child{padding-right:0}.colhead{display:flex;align-items:center;gap:8px;margin-bottom:6px}.colhead h2{font-size:12px;font-weight:600;letter-spacing:.03em;margin:0;text-transform:uppercase;color:var(--ink2)}.colhead .n{font-size:11px;color:var(--ink3);background:var(--chip);border-radius:999px;padding:1px 8px}.task{padding:16px 0;border-bottom:1px solid var(--line2)}.task__r1{display:flex;align-items:center;gap:8px}.task__who{font-size:13.5px;font-weight:600}.task__tag{font-size:11px;color:var(--ink3)}.task__repo{font-size:11px;color:var(--terr);background:#7a6a481a;border-radius:4px;padding:0 6px}.task__stat{margin-left:auto;font-size:11px;font-weight:500;color:var(--ink3)}.task__stat--drop{color:var(--drop)}.livedot{width:7px;height:7px;border-radius:50%;background:var(--live);margin-left:auto}.task__intent{font-size:13.5px;margin:5px 0 0;line-height:1.45}.terr{margin-top:8px;display:flex;flex-wrap:wrap;gap:6px;align-items:center}.terr__lbl{font-size:9.5px;text-transform:uppercase;letter-spacing:.05em;color:var(--ink3)}.glob{font-family:ui-monospace,Menlo,monospace;font-size:11px;color:var(--terr);background:#7a6a481f;border:1px solid rgba(122,106,72,.22);border-radius:5px;padding:1px 7px}.task__meta{font-size:11.5px;color:var(--ink3);margin-top:6px}.terrx{margin-top:8px}.terrx summary{list-style:none;cursor:pointer;display:flex;align-items:center;gap:6px;flex-wrap:wrap;-webkit-user-select:none;user-select:none}.terrx summary::-webkit-details-marker{display:none}.terrx .terr--full{margin-top:8px}.glob--more{cursor:pointer;color:var(--ink2);background:var(--chip);border:1px solid var(--line)}.glob--more .tw{color:var(--ink3);display:inline-block;transition:transform .15s}.terrx[open] summary .glob--more .tw{transform:rotate(90deg)}.grp{padding:16px 0;border-bottom:1px solid var(--line2)}.grp__head{display:flex;align-items:center;gap:8px}.grp__who{font-size:13.5px;font-weight:600}.grp__tag,.grp__count{font-size:11px;color:var(--ink3)}.grp__dot{width:7px;height:7px;border-radius:50%;background:var(--live);margin-left:auto}.claims{margin:10px 0 0 6px;padding-left:14px;border-left:1px solid var(--line)}.claim{padding:6px 0}.claim+.claim{border-top:1px solid var(--line2);margin-top:6px}.fold{margin-top:10px}.fold summary{list-style:none;cursor:pointer;font-size:12px;color:var(--ink2);display:inline-flex;align-items:center;gap:6px;-webkit-user-select:none;user-select:none}.fold summary::-webkit-details-marker{display:none}.fold summary .tw{display:inline-block;color:var(--ink3);transition:transform .15s}.fold[open] summary .tw{transform:rotate(90deg)}.fold__body{margin:8px 0 0 6px;padding-left:14px;border-left:1px dashed var(--line)}.covered{font-size:10.5px;color:var(--ink3);font-style:italic;margin-top:4px}.day{font-size:11px;color:var(--ink3);padding:18px 0 2px;font-weight:600}.more{margin-top:20px;font-size:12.5px;color:var(--ink2);padding:7px 13px;border:1px solid var(--line);border-radius:8px;background:#fffaee59;cursor:pointer}.empty{color:var(--ink3);font-style:italic;padding:14px 0}.chat-wrap{background:var(--card);border:1px solid var(--line);border-radius:12px;display:flex;flex-direction:column;overflow:hidden;height:calc(100vh - 150px);min-height:320px}.chat{flex:1;overflow-y:auto;padding:16px}.chat{scrollbar-width:thin;scrollbar-color:var(--line) transparent}.chat::-webkit-scrollbar{width:10px}.chat::-webkit-scrollbar-track{background:transparent}.chat::-webkit-scrollbar-thumb{background:var(--line);border-radius:999px;border:3px solid var(--card);background-clip:padding-box}.chat::-webkit-scrollbar-thumb:hover{background:var(--ink3);background-clip:padding-box}.chat__note{padding:9px 16px;font-size:11.5px;color:var(--ink3)}.msg{display:flex;gap:11px;padding:9px 0}.msg__avatar{flex:none;width:32px;height:32px;border-radius:50%;display:grid;place-items:center;font-size:12px;font-weight:700;color:#fff}.msg__body{min-width:0;flex:1}.msg__head{display:flex;align-items:baseline;gap:8px;flex-wrap:wrap}.msg__who{font-weight:600}.msg__human{font-size:12px;color:var(--ink3)}.msg__to{font-size:11.5px;color:var(--terr)}.msg__time{font-size:11.5px;color:var(--ink3);margin-left:auto}.msg__text{margin-top:3px;padding:8px 12px;border-radius:4px 12px 12px;background:var(--chip);white-space:pre-wrap;word-break:break-word}.msg--targeted .msg__text{box-shadow:inset 3px 0 0 var(--terr)}.msg--me,.msg--me .msg__head{flex-direction:row-reverse}.msg--me .msg__time{margin-left:0;margin-right:auto}.msg--me .msg__body{display:flex;flex-direction:column;align-items:flex-end}.msg--me .msg__text{border-radius:12px 4px 12px 12px;background:#d4e7d2}.msg--me.msg--targeted .msg__text{box-shadow:inset -3px 0 0 var(--terr)}.composer{position:relative;border-top:1px solid var(--line);padding:10px 12px}.chat-form{display:flex;gap:8px}.chat-input{flex:1;padding:9px 12px;border-radius:8px;border:1px solid var(--line);background:var(--bg);color:var(--ink);font:inherit}.chat-input:focus{outline:none;border-color:var(--terr)}.chat-send{padding:9px 16px;border-radius:8px;border:1px solid var(--ink);background:var(--ink);color:var(--bg);font-weight:600;cursor:pointer;font:inherit}.chat-send:disabled{opacity:.5;cursor:default}.mention-pop{position:absolute;left:12px;right:12px;bottom:56px;z-index:6;background:var(--card);border:1px solid var(--line);border-radius:10px;padding:5px;box-shadow:0 8px 24px #32281429;max-height:200px;overflow-y:auto}.mention-mi{display:flex;align-items:center;gap:9px;width:100%;text-align:left;border:0;-webkit-appearance:none;-moz-appearance:none;appearance:none;font-family:inherit;color:inherit;background:transparent;border-radius:7px;padding:6px 8px;font-size:13px;cursor:pointer}.mention-mi:hover,.mention-mi.on{background:var(--chip)}.mention-mi .ma{width:22px;height:22px;border-radius:50%;display:grid;place-items:center;font-size:9px;font-weight:700;color:#fff;flex:none}.gate{max-width:420px;margin:12vh auto 0;text-align:center}.gate h1{font-size:19px;margin:0 0 6px}.gate p{color:var(--ink2);margin:0 0 20px}.gate form{display:flex;gap:8px}.gate input{flex:1;padding:10px 12px;border-radius:8px;border:1px solid var(--line);background:var(--card);color:var(--ink)}.gate button{padding:10px 16px;border-radius:8px;border:1px solid var(--ink);background:var(--ink);color:var(--bg);font-weight:600;cursor:pointer}.shepherd-root{max-width:1100px;margin:0 auto;padding:40px 44px}.shepherd-root>main{padding-top:18px}.shepherd-config{display:flex;flex-direction:column;gap:24px}.shepherd-config h2{font-size:16px;margin:0 0 4px}.shepherd-workspaces,.shepherd-members,.shepherd-connect-agent{display:flex;flex-direction:column;gap:10px;padding:16px;border:1px solid var(--line);border-radius:10px;background:var(--card)}.shepherd-workspaces .switcher{display:flex;flex-wrap:wrap;gap:8px}.shepherd-workspaces .role{color:var(--ink3);font-size:12px}.shepherd-workspaces .admin,.shepherd-workspaces .invites{display:flex;flex-wrap:wrap;gap:8px;align-items:center}.shepherd-config input,.shepherd-config select{padding:8px 10px;border-radius:8px;border:1px solid var(--line);background:var(--bg);color:var(--ink)}.shepherd-config button{padding:8px 14px;border-radius:8px;border:1px solid var(--ink);background:var(--ink);color:var(--bg);font-weight:600;cursor:pointer}.shepherd-config button:disabled{opacity:.55;cursor:default}.shepherd-config .invite-result,.shepherd-connect-agent .token-once{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px;word-break:break-all;padding:8px 10px;border-radius:8px;background:var(--chip);border:1px solid var(--line2)}.shepherd-config .revoked{color:var(--ink3);text-decoration:line-through}.shepherd-empty-state{text-align:center;color:var(--ink2);padding:48px 24px}.shepherd-empty-state button{margin-top:14px}