Spec #136: Finished belongs to the Series — owner-owned poll gate, Lifecycle bucket dropped (#163)

Closes #136.

Spec #136 end to end: `finished` becomes a fact about the Series, written only by the owner, and the reader-facing Lifecycle bucket is gone.

## What landed

- **#157** — `series.finished_at bigint NOT NULL DEFAULT 0` plus the migration whose statement order is load-bearing (seed from the buckets, then flip them); both Lane queries lose the `HAVING COUNT(*) FILTER (WHERE b.status <> 'finished')` clause and gate on `finished_at = 0` instead, with the due-query/eligible-count force asymmetry kept deliberate and commented; `StatusFinished`, its API special-case 400, the web tab and the templates' Finished bucket deleted.
- **#158** — owner Finish control on the Series detail page: confirm-gated finish, instant un-finish, admin accent (never ember, nothing is destroyed), `Store.SetSeriesFinished`, the two routes behind the owner gate, and the state displayed on the list row without offering the control there.
- **#160** — reader side: derived `finished` bool on the flat Bookmark (`s.finished_at > 0`), rendered as a text-only label in both userscripts and on the web card; read-only inbound by omission from `Upsert`'s explicit `series` column list, same mechanism that already protects `cover`.
- **#161** — glossary and the stale Reader-count divergence note catch up.
- **#159** — `finished` joins the admin filter vocabulary (predicate `finished_at > 0`, label `Finished`, own aggregate count, figure last in the stats block as informational); the four clock-driven hygiene predicates (stale, never-checked, no-cover, no-chapter) exclude finished Series while unpollable, orphan and sighting-raised deliberately do not.

## Verification

`go vet ./...` and `go test ./...` green on the merged branch (Docker-backed, throwaway `postgres:17-alpine` per package). Each ticket also passed a two-axis review (spec + standards) on its own branch before merge.

Reviewed-on: #163
Co-authored-by: Sulthan Zaki <sultankiki05@gmail.com>
Co-committed-by: Sulthan Zaki <sultankiki05@gmail.com>

userscript/novel-bookmark.user.js

@@ -268,8 +268,9 @@
       // Duplicate case (spec user story 2): one row must survive, and it is
       // the one already under the repaired key — with the stale row's
       // progress carried across when it is ahead, favourite OR'd, and the
-      // stronger lifecycle bucket kept (finished > archived > reading, so a
-      // merge can never silently un-archive or un-finish a row).
+      // stronger lifecycle bucket kept (archived > reading, so a merge can
+      // never silently un-archive a row). finished is not a bucket the
+      // script can see (issue #157).
       const merged = Object.assign({}, existing);
       if (
         existing.last_chapter_num == null ||
@@ -280,7 +281,7 @@
         merged.last_chapter_url = stale.last_chapter_url;
       }
       merged.favorite = !!(existing.favorite || stale.favorite);
-      const rank = (s) => ({ finished: 2, archived: 1, reading: 0 }[s || "reading"] || 0);
+      const rank = (s) => ({ archived: 1, reading: 0 }[s || "reading"] || 0);
       merged.status = rank(stale.status) > rank(existing.status) ? stale.status : existing.status;
       merged.updated_at = Math.max(existing.updated_at || 0, stale.updated_at || 0);
       listOut = list.filter((b) => b.key !== oldKey).map((b) => (b.key === newKey ? merged : b));
@@ -405,9 +406,10 @@
   }
 
   // Only an explicit archive/restore has an opinion about the bucket. Every
-  // other write omits `status`, so the server keeps the stored one — otherwise
-  // a cached value would resend "finished" (which the API rejects with 400) or
-  // silently un-archive a series archived on another device.
+  // other write omits `status`, so the server keeps the stored one —
+  // otherwise a cached value would resend a stale status (the API rejects
+  // unknown values with 400) or silently un-archive a series archived on
+  // another device.
   async function apiPut(key, obj, { sendStatus = false } = {}) {
     const body = Object.assign({}, obj);
     if (!sendStatus) delete body.status;
@@ -484,6 +486,12 @@
     return b.kind || "manga";
   }
 
+  // finished is a fact about the Series, decided from the owner's side and
+  // derived on the wire (issue #157); the panel only labels it.
+  function finishedLabel(b) {
+    return b && b.finished ? "Finished" : "";
+  }
+
   // ============================================================
   // Retry queue
   //
@@ -792,8 +800,8 @@
   }
 
   // Archive parks a series: it leaves All and Favourites but the server keeps
-  // polling it for new chapters. "finished" is deliberately not reachable from
-  // here — the API rejects that value, it is a web-UI decision.
+  // polling it for new chapters. finished is not a bucket the script can
+  // reach — it is a fact about the Series now (issue #157).
   async function toggleArchive(key) {
     const existing = state.byKey[key];
     if (!existing) return;
@@ -878,7 +886,6 @@
     const now = Date.now();
     const due = state.list
       .filter((b) => b.site === site && b.series_url)
-      .filter((b) => statusOf(b) !== "finished")
       .filter((b) => now - (checked[b.key] || 0) >= LATEST_CHECK_THROTTLE_MS)
       .sort((a, b) => (checked[a.key] || 0) - (checked[b.key] || 0))
       .slice(0, LATEST_CHECK_BATCH);
@@ -1241,8 +1248,8 @@
     }
 
     // Tabs narrow what is drawn; state.list always holds every bookmark.
-    // Archived rows are hidden from All and Favourites, and finished ones —
-    // which only the web UI can set — are hidden from every tab.
+    // Archived rows are hidden from All and Favourites; a Series that is
+    // finished is the web UI's business and arrives archived (issue #157).
     for (const [id, tab] of [["tabAll", "all"], ["tabFav", "favorites"], ["tabArc", "archived"]]) {
       root.getElementById(id).classList.toggle("active", activeTab === tab);
     }
@@ -1305,6 +1312,7 @@
       el("div", { class: "meta" }, [
         el("a", { class: "go-t t", href: cont, text: b.title || b.series_id }),
         el("div", { class: "c" + (behind ? " behind" : ""), text: sub }),
+        b.finished && el("span", { class: "finished", text: finishedLabel(b) }),
         el("div", { class: "actions" }, [
           el("button", {
             class: "btn small star" + (b.favorite ? " on" : ""),
@@ -1593,7 +1601,7 @@
       --paper: #f2ece5; --paper-hot: #f0d3cb; --paper-dim: #ddd5cb;
       --mute: #8d857c; --mute-2: #5a5450; --faint: #3a3733; --faint-2: #57504b;
       --ember: #e0452c; --ember-wash: #1a1211; --ember-ink: #150907;
-      --ember-soft: #eda798; --brass: #b8912f; --trash: #6b5450;
+      --ember-soft: #eda798; --brass: #b8912f; --trash: #6b5450; --moss: #7fae86;
       --font-display: Georgia, "Times New Roman", serif;
       --font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;
       --font-body: system-ui, -apple-system, sans-serif;
@@ -1719,6 +1727,12 @@
       font: 500 10px/1.4 var(--font-mono); letter-spacing: .12em; text-transform: uppercase;
     }
     .c.behind { color: var(--ember); }
+    /* finished: a Series fact, not a state class (issue #157) — same meta
+       typography as .c, moss instead of mute. */
+    .finished {
+      margin: 0; color: var(--moss);
+      font: 500 10px/1.4 var(--font-mono); letter-spacing: .12em; text-transform: uppercase;
+    }
     .actions { display: flex; gap: 0; flex-wrap: wrap; margin-top: 2px; }
     .btn {
       background: none; color: var(--mute); border: 1px solid var(--rule);
@@ -1762,7 +1776,7 @@
   // Exposes pure logic only — see userscript/test/novel-logic.test.js.
   // ============================================================
   if (typeof window === "undefined" && typeof module === "object" && module.exports) {
-    module.exports = { novelfull, lightnovelworld, anchorsFromHTML, statusOf, kindOf, maxChapter, escapeRe, computeLatestChapter, repairLnwStaleRow };
+    module.exports = { novelfull, lightnovelworld, anchorsFromHTML, statusOf, kindOf, maxChapter, escapeRe, computeLatestChapter, repairLnwStaleRow, finishedLabel };
   }
 
   // ============================================================