@knpkv/herdr-work 0.5.3 → 0.7.0

package/dist/work-triage.js

@@ -0,0 +1,114 @@
+const DAY_MS = 86_400_000;
+/** How long a finished goal stays in the "Done in the last 24 hours" group. */
+export const workTriageDoneWindowMs = DAY_MS;
+export const workTriageGroups = ["needs-you", "blocked", "moving", "done", "earlier"];
+/** Which states have finished. Keyed by every WorkState, so a new state must be placed here to compile. */
+const terminalState = {
+    planned: false,
+    working: false,
+    blocked: false,
+    review: false,
+    deployed: true,
+    completed: true,
+    abandoned: true
+};
+const terminal = (goal) => terminalState[goal.state];
+const openRequestsOf = (goal) => (goal.requests ?? []).filter((request) => request.state === "open").toSorted((a, b) => a.requestedAt - b.requestedAt);
+/**
+ * One group per goal, first match wins. An open request outranks every state, so a blocked goal
+ * with an open request is in "needs you" and not in the blocked count. A request without an
+ * approval target still counts: a person must act, even when the hub link is missing.
+ */
+const groupOf = (goal, openRequests, asOf) => {
+    if (openRequests.length > 0)
+        return "needs-you";
+    if (goal.state === "blocked")
+        return "blocked";
+    if (terminal(goal))
+        return asOf - goal.updatedAt <= workTriageDoneWindowMs ? "done" : "earlier";
+    return "moving";
+};
+const groupOrder = { "needs-you": 0, blocked: 1, moving: 2, done: 3, earlier: 4 };
+/**
+ * Within "needs you", the oldest open request first; elsewhere, the most recently updated goal
+ * first. Ties keep the snapshot's own order, so the order is stable across polls.
+ */
+const compareRows = (left, right) => {
+    const byGroup = groupOrder[left.group] - groupOrder[right.group];
+    if (byGroup !== 0)
+        return byGroup;
+    if (left.group === "needs-you") {
+        const byRequest = (left.openRequests[0]?.requestedAt ?? 0) - (right.openRequests[0]?.requestedAt ?? 0);
+        if (byRequest !== 0)
+            return byRequest;
+    }
+    else {
+        const byUpdate = right.goal.updatedAt - left.goal.updatedAt;
+        if (byUpdate !== 0)
+            return byUpdate;
+    }
+    return left.index - right.index;
+};
+/**
+ * Sorts one snapshot's goals into the triage groups and states the summary. The snapshot holds
+ * every goal (the model rejects a snapshot over `workSnapshotMaxGoals` rather than truncating it),
+ * so a zero here is a real zero.
+ */
+export const workTriage = (snapshot) => {
+    const rows = snapshot.goals
+        .map((goal, index) => {
+        const openRequests = openRequestsOf(goal);
+        return { goal, group: groupOf(goal, openRequests, snapshot.asOf), index, openRequests };
+    })
+        .toSorted(compareRows);
+    const needsYou = rows.filter((row) => row.group === "needs-you");
+    const blocked = rows.filter((row) => row.group === "blocked").length;
+    if (needsYou.length > 0 || blocked > 0) {
+        const first = needsYou[0];
+        const request = first?.openRequests[0];
+        return {
+            rows,
+            summary: {
+                _tag: "Attention",
+                blocked,
+                needsYou: needsYou.length,
+                oldestRequest: first === undefined || request === undefined ? null : { goal: first.goal, request }
+            }
+        };
+    }
+    if (rows.length === 0)
+        return { rows, summary: { _tag: "Empty" } };
+    const latest = rows.toSorted((a, b) => b.goal.updatedAt - a.goal.updatedAt)[0]?.goal ?? null;
+    return { rows, summary: { _tag: "Clear", latest, moving: rows.filter((row) => row.group === "moving").length } };
+};
+const plural = (count, one, many) => `${count} ${count === 1 ? one : many}`;
+/**
+ * The summary as its one sentence: "3 goals need you, 2 blocked", "Nothing needs you", "No goals
+ * yet"; in the past tense "3 goals needed you, 2 blocked", "Nothing needed you", "No goals".
+ */
+export const workTriageSentence = (summary, tense = "present") => {
+    const [one, many, nothing] = tense === "present"
+        ? ["goal needs", "goals need", "Nothing needs you"]
+        : ["goal needed", "goals needed", "Nothing needed you"];
+    switch (summary._tag) {
+        case "Attention":
+            if (summary.needsYou === 0)
+                return `${nothing}, ${summary.blocked} blocked`;
+            return summary.blocked === 0
+                ? `${plural(summary.needsYou, one, many)} you`
+                : `${plural(summary.needsYou, one, many)} you, ${summary.blocked} blocked`;
+        case "Clear":
+            return nothing;
+        case "Empty":
+            return tense === "present" ? "No goals yet" : "No goals";
+    }
+};
+/** Group titles as the tab shows them. */
+export const workTriageGroupTitle = {
+    "needs-you": "Needs you",
+    blocked: "Blocked",
+    moving: "Moving",
+    done: "Done in the last 24 hours",
+    earlier: "Finished earlier"
+};
+//# sourceMappingURL=work-triage.js.map

package/dist/work-triage.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knpkv/herdr-work",
-  "version": "0.5.3",
+  "version": "0.7.0",
   "description": "Durable fleet work checkpoints and departure-board projections",
   "license": "MIT",
   "author": "knpkv",
@@ -52,8 +52,8 @@
   },
   "dependencies": {
     "effect": "4.0.0",
-    "@knpkv/herdr-fleet": "^0.5.1",
-    "@knpkv/rly": "^0.8.0"
+    "@knpkv/herdr-fleet": "^0.6.1",
+    "@knpkv/rly": "^0.10.0"
   },
   "devDependencies": {
     "@effect/platform-node": "4.0.0",