Sightings: a Reader report defers a Poll of a solitary Series (#103) (#108)

Closes #103. A userscript PUT already carries the Latest Chapter the Reader's own browser read off the Series page. It may now stand in for a Poll, under one restriction and one ceiling: - **Solitary Series only** — a Series two Readers share is Polled on schedule however recently it was sighted, so one Reader's mistake can never reach another's list. - **One rest of standing**, and a **six-rest ceiling** (`sightingCeilingRests`, counted in the Site's own Rest): however many Sightings arrive, an unpolled Series is Polled. Both live in the due query's HAVING clause (`Store.DueForLatestCheck`) — the same place the schedule has always been decided, so no timer and no second code path can disagree with it. No new query per scheduler round. Judgement costs no extra request. `Poller.checkOne` already compares what the Site publishes against what is stored: a lower number contradicts the Sighting (Reader and both numbers logged), the same number confirms it, a higher number is the Site publishing and clears the attribution instead. Three contradictions stop that Reader deferring — their reports still write the Latest Chapter — and twenty consecutive confirmations forgive them, as does the owner's clear-marks control from #102. One client change was required: both userscripts skipped the PUT when the number had not moved, so the case the whole mechanism exists for — visiting a Series with nothing new — never reached the backend. `reportLatestChapter` sends it, skipping only the local write and the re-render. A numberless PUT (favourite toggle, progress from a chapter page) is no Sighting and defers nothing. Schema: migration `0011_series_sightings.sql` adds `series.latest_sighted_at` and `series.latest_raised_by`. Trust model, thresholds, and rejected alternatives with their citations: `docs/adr/0011-sighting-deferral-trust-model.md`. Reviewed on both axes (spec against #103, standards against the repo's rules); the blocker — attribution surviving a Poll that overtook the report — is fixed and has a test that fails without the fix. Verification: `go test ./...` green (needs Docker), `node --test userscript/test/*.test.js` 66 pass. Reviewed-on: #108 Co-authored-by: Sulthan Zaki <sultankiki05@gmail.com> Co-committed-by: Sulthan Zaki <sultankiki05@gmail.com>
2026-08-16 20:10:59 +07:00
parent 1e6f1e985d
commit ba679223b2
17 changed files with 3709 additions and 963 deletions
@@ -40,6 +40,7 @@
  "38": "novel-logic.test.js",
  "39": "UI Critique 2026-07-26A",
  "40": "UI Critique 2026-07-26B",
+  "41": "Handler",
  "42": "pgtest.go",
  "43": "Issue Tracker & Triage",
  "44": "Ticket Workflow",
@@ -151,6 +152,7 @@
  "150": "Reviewer Subagent (opencode)",
  "151": "Finding Severity Rubric",
  "152": "Spec Compliance Review",
+  "154": "ADR-0011: Sightings — a Reader report defers a Poll where being wrong hurts only them",
  "156": "ResponseWriter",
  "161": "Why Use samber/oops",
  "162": "singleflight Cache Stampede Prevention",
@@ -1,16 +1,16 @@
 # Graph Report - mangaBookmark  (2026-08-16)

 ## Corpus Check
- 116 files · ~284,419 words
+- 119 files · ~290,953 words
 - Verdict: corpus is large enough that graph structure adds value.

 ## Summary
- 1701 nodes · 3463 edges · 219 communities (69 shown, 150 thin omitted)
- Extraction: 91% EXTRACTED · 9% INFERRED · 0% AMBIGUOUS · INFERRED: 326 edges (avg confidence: 0.77)
+- 1736 nodes · 3597 edges · 221 communities (70 shown, 151 thin omitted)
+- Extraction: 90% EXTRACTED · 10% INFERRED · 0% AMBIGUOUS · INFERRED: 361 edges (avg confidence: 0.78)
 - Token cost: 0 input · 0 output

 ## Graph Freshness
- Built from commit: `58014eb8`
+- Built from commit: `56afb9f2`
 - Run `git rev-parse HEAD` and compare to check if the graph is stale.
 - Run `graphify update .` after code changes (no API cost).

@@ -55,6 +55,7 @@
 - [[_COMMUNITY_novel-logic.test.js|novel-logic.test.js]]
 - [[_COMMUNITY_UI Critique 2026-07-26A|UI Critique 2026-07-26A]]
 - [[_COMMUNITY_UI Critique 2026-07-26B|UI Critique 2026-07-26B]]
+- [[_COMMUNITY_Handler|Handler]]
 - [[_COMMUNITY_pgtest.go|pgtest.go]]
 - [[_COMMUNITY_Issue Tracker & Triage|Issue Tracker & Triage]]
 - [[_COMMUNITY_Ticket Workflow|Ticket Workflow]]
@@ -166,6 +167,7 @@
 - [[_COMMUNITY_Reviewer Subagent (opencode)|Reviewer Subagent (opencode)]]
 - [[_COMMUNITY_Finding Severity Rubric|Finding Severity Rubric]]
 - [[_COMMUNITY_Spec Compliance Review|Spec Compliance Review]]
+- [[_COMMUNITY_ADR-0011 Sightings — a Reader report defers a Poll where being wrong hurts only them|ADR-0011: Sightings — a Reader report defers a Poll where being wrong hurts only them]]
 - [[_COMMUNITY_ResponseWriter|ResponseWriter]]
 - [[_COMMUNITY_Why Use samberoops|Why Use samber/oops]]
 - [[_COMMUNITY_singleflight Cache Stampede Prevention|singleflight Cache Stampede Prevention]]
@@ -235,16 +237,16 @@
 - [[_COMMUNITY_Userscript CLAUDE guidance|Userscript CLAUDE guidance]]

 ## God Nodes (most connected - your core abstractions)
-1. `testConfig()` - 54 edges
-2. `newTestStore()` - 49 edges
+1. `newTestStore()` - 62 edges
+2. `testConfig()` - 55 edges
 3. `newWebTestServer()` - 49 edges
 4. `newTestStore()` - 44 edges
 5. `e()` - 33 edges
-6. `Open()` - 30 edges
-7. `Handler` - 29 edges
-8. `Store` - 28 edges
-9. `ne()` - 28 edges
-10. `De()` - 28 edges
+6. `Store` - 31 edges
+7. `Open()` - 31 edges
+8. `newTestPoller()` - 30 edges
+9. `Handler` - 29 edges
+10. `ne()` - 28 edges

 ## Surprising Connections (you probably didn't know these)
 - `el()` --indirect_call--> `c()`  [INFERRED]
@@ -268,7 +270,7 @@
 - **Headless browser infrastructure (sidecar, on-demand, home deployment)** — docs_adr_0005_on_demand_browser_headless_shell, docs_adr_0005_on_demand_browser_cdp, docs_adr_0005_on_demand_browser_on_demand_start, docs_adr_0006_browser_on_the_home_machine_home_machine_rationale [INFERRED 0.85]
 - **lightnovelworld series-identity investigation and fix** — docs_research_lightnovelworld_chapter_vs_series_slug_issue_77, docs_research_lightnovelworld_chapter_vs_series_slug_unscoped_regex, docs_adr_0008_series_identity_is_discovered_not_derived_discovered_identity [INFERRED 0.85]

-## Communities (219 total, 150 thin omitted)
+## Communities (221 total, 151 thin omitted)

 ### Community 0 - "HTMX Library Internals"
 Cohesion: 0.08
@@ -280,23 +282,23 @@ Nodes (89): floatPtr(), testConfig(), getCover(), Cookie, Handler, ResponseRecor

 ### Community 2 - "Manga Userscript Adapters"
 Cohesion: 0.06
-Nodes (76): adapterFor(), anchorsFromDocument(), anchorsFromHTML(), apiDelete(), apiGet(), apiPut(), applyFabPos(), applyLatestChapterIfChanged() (+68 more)
+Nodes (77): adapterFor(), anchorsFromDocument(), anchorsFromHTML(), apiDelete(), apiGet(), apiPut(), applyFabPos(), armDwell() (+69 more)

 ### Community 3 - "Novel Userscript Adapters"
 Cohesion: 0.06
-Nodes (79): adapterFor(), anchorsFromDocument(), anchorsFromHTML(), apiDelete(), apiGet(), apiPut(), applyFabPos(), applyLatestChapterIfChanged() (+71 more)
+Nodes (78): adapterFor(), anchorsFromDocument(), anchorsFromHTML(), apiDelete(), apiGet(), apiPut(), applyFabPos(), applyLnwStaleRowRepair() (+70 more)

 ### Community 4 - "Series Acquisition Tests"
-Cohesion: 0.08
-Nodes (78): bookmarkNewKaganeSeries(), bookmarkNewNovelfullSeries(), bookmarkNewSeries(), Context, Store, T, newAcquirer(), readBookmark() (+70 more)
+Cohesion: 0.07
+Nodes (103): bookmarkNewKaganeSeries(), bookmarkNewNovelfullSeries(), bookmarkNewSeries(), Context, Store, T, newAcquirer(), readBookmark() (+95 more)

 ### Community 5 - "Bookmarks API Tests"
 Cohesion: 0.07
-Nodes (70): auth(), getBookmarks(), Handler, Request, Store, T, newTestServer(), newTestStore() (+62 more)
+Nodes (71): auth(), getBookmarks(), Handler, Request, Store, T, newTestServer(), newTestStore() (+63 more)

 ### Community 7 - "Cover & Acquire Internals"
-Cohesion: 0.07
-Nodes (43): Addr, fakeLanes, Context, Store, WaitGroup, defaultCoverResolver(), fetchCoverBytes(), Client (+35 more)
+Cohesion: 0.06
+Nodes (43): Addr, fakeLanes, Context, Store, WaitGroup, isInterstitial(), defaultCoverResolver(), fetchCoverBytes() (+35 more)

 ### Community 8 - "System Architecture Concepts"
 Cohesion: 0.15
@@ -318,10 +320,6 @@ Nodes (45): Store, T, newTestStore(), readLatestCheckedAt(), readSeries(), secon
 Cohesion: 0.08
 Nodes (32): Handler, Request, ResponseWriter, Store, Healthz(), writeJSON(), Auth(), compressible() (+24 more)

-### Community 13 - "Web UI Handlers"
-Cohesion: 0.14
-Nodes (18): currentLib(), currentTab(), filterBookmarks(), Client, HandlerFunc, Request, ResponseWriter, Store (+10 more)
-
 ### Community 14 - "Go Error Handling"
 Cohesion: 0.06
 Nodes (33): Creating Errors, Custom Error Types, Custom types that wrap other errors, Decision table: which error strategy to use, Error Creation, Error String Conventions, Errors as Values, `errors.New` — static error messages (+25 more)
@@ -368,7 +366,7 @@ Nodes (12): coverResponse(), Request, T, TestCoverFetcherCanonicalisesJpgAlias()

 ### Community 26 - "Open"
 Cohesion: 0.05
-Nodes (62): awaitPromise(), browserConnectionLost(), classifyBrowserError(), comixRead(), comixSeriesPageURL(), Action, Context, Mutex (+54 more)
+Nodes (61): awaitPromise(), browserConnectionLost(), classifyBrowserError(), comixRead(), comixSeriesPageURL(), Action, Context, Mutex (+53 more)

 ### Community 27 - "Find Skills Guide"
 Cohesion: 0.14
@@ -387,8 +385,8 @@ Cohesion: 0.40
 Nodes (5): Map of pointers for large, frequently updated structs, Memory Layout, Pointer receivers for large structs, Struct field alignment, Zero-size field at end of struct

 ### Community 31 - "Store"
-Cohesion: 0.08
-Nodes (8): coverRelativePath(), coverSourceAddress(), displayChapter(), Store, scanSeries(), TestDisplayChapter(), Bookmark, ReaderSummary
+Cohesion: 0.09
+Nodes (5): coverRelativePath(), coverSourceAddress(), Store, scanSeries(), ReaderSummary

 ### Community 33 - "Go Testing Guide"
 Cohesion: 0.20
@@ -418,6 +416,10 @@ Nodes (6): Design Health Score, Design Specificity Verdict, Minor Observations,
 Cohesion: 0.29
 Nodes (6): Design Health Score, Design Specificity Verdict, Minor Observations, Persona Red Flags, Priority Issues, Questions to Consider

+### Community 41 - "Handler"
+Cohesion: 0.14
+Nodes (18): currentLib(), currentTab(), filterBookmarks(), Client, HandlerFunc, Request, ResponseWriter, Store (+10 more)
+
 ### Community 42 - "pgtest.go"
 Cohesion: 0.18
 Nodes (12): M, TestMain(), M, TestMain(), M, Main(), start(), URL() (+4 more)
@@ -534,6 +536,10 @@ Nodes (3): ADR-0005: On-demand browser sidecar, Constraints, Decision
 Cohesion: 0.48
 Nodes (6): T, TestCreateAndGetSession(), TestDeleteSessionIsPerReader(), TestDeleteSessionRevokes(), TestExpiredSessionIsGone(), TestGetSessionUnknownID()

+### Community 154 - "ADR-0011: Sightings — a Reader report defers a Poll where being wrong hurts only them"
+Cohesion: 0.33
+Nodes (5): ADR-0011: Sightings — a Reader report defers a Poll where being wrong hurts only them, Constraints preserved, Decision, Tradeoffs and rejections, Why
+
 ### Community 156 - "ResponseWriter"
 Cohesion: 0.18
 Nodes (13): AdminPatterns(), HandlerFunc, Request, ResponseWriter, Time, Handler, readerPathID(), since() (+5 more)
@@ -543,24 +549,24 @@ Cohesion: 0.50
 Nodes (3): Live URL shapes (verified 2026-07-26, may drift — re-check against live pages before trust), Second script: `novel-bookmark.user.js`, Userscript structure (single IIFE, `manga-bookmark.user.js`)

 ## Knowledge Gaps
- **520 isolated node(s):** `bookmarkmanager/backend`, `ctxKey`, `loginView`, `ctxKey`, `test` (+515 more)
+- **524 isolated node(s):** `bookmarkmanager/backend`, `ctxKey`, `loginView`, `ctxKey`, `test` (+519 more)
  These have ≤1 connection - possible missing edges or undocumented components.
- **150 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes.
+- **151 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes.

 ## Suggested Questions
 _Questions this graph is uniquely positioned to answer:_

 - **Why does `Open()` connect `CDP Browser Client` to `Cover Fetch Test Helpers`, `Series Acquisition Tests`, `Bookmarks API Tests`, `pgtest.go`, `Store Tests`, `Store`?**
+  _High betweenness centrality (0.060) - this node is a cross-community bridge._
+- **Why does `New()` connect `Series Acquisition Tests` to `Bookmarks API Tests`, `Cover & Acquire Internals`, `Handler`, `Session Middleware`, `CDP Browser Client`, `ResponseWriter`?**
  _High betweenness centrality (0.050) - this node is a cross-community bridge._
- **Why does `New()` connect `Series Acquisition Tests` to `Bookmarks API Tests`, `Cover & Acquire Internals`, `Session Middleware`, `Web UI Handlers`, `CDP Browser Client`, `ResponseWriter`?**
-  _High betweenness centrality (0.048) - this node is a cross-community bridge._
 - **Why does `newRouter()` connect `Bookmarks API Tests` to `Cover Fetch Test Helpers`, `Bookmarks API Handler`, `Series Acquisition Tests`, `ResponseWriter`?**
-  _High betweenness centrality (0.031) - this node is a cross-community bridge._
+  _High betweenness centrality (0.030) - this node is a cross-community bridge._
+- **Are the 25 inferred relationships involving `newTestStore()` (e.g. with `TestAcquireDoesNotBlockTheWrite()` and `TestAcquireFailureLeavesTheBookmarkIntact()`) actually correct?**
+  _`newTestStore()` has 25 INFERRED edges - model-reasoned connections that need verification._
 - **Are the 48 inferred relationships involving `testConfig()` (e.g. with `TestListRendersAcquiredCover()` and `TestPublicCoverNeverEchoesNonImage()`) actually correct?**
  _`testConfig()` has 48 INFERRED edges - model-reasoned connections that need verification._
- **Are the 12 inferred relationships involving `newTestStore()` (e.g. with `TestAcquireDoesNotBlockTheWrite()` and `TestAcquireFailureLeavesTheBookmarkIntact()`) actually correct?**
-  _`newTestStore()` has 12 INFERRED edges - model-reasoned connections that need verification._
 - **Are the 8 inferred relationships involving `newWebTestServer()` (e.g. with `TestListRendersAcquiredCover()` and `TestPublicCoverRejectsUnknownAddress()`) actually correct?**
  _`newWebTestServer()` has 8 INFERRED edges - model-reasoned connections that need verification._
 - **What connects `bookmarkmanager/backend`, `ctxKey`, `loginView` to the rest of the system?**
-  _552 weakly-connected nodes found - possible documentation gaps or missing edges._
+  _556 weakly-connected nodes found - possible documentation gaps or missing edges._
@@ -35,8 +35,8 @@
    "semantic_hash": "4a94ac85bad6bce330d085bcc0ae3ffd"
  },
  "userscript/manga-bookmark.user.js": {
-    "mtime": 1786499529.779988,
-    "ast_hash": "1f8bcddd3632d709f058a8401af8f127",
+    "mtime": 1786872888.3482232,
+    "ast_hash": "4e79684942234b26f4a1fb03fccd6d35",
    "semantic_hash": ""
  },
  ".agents/skills/find-skills/SKILL.md": {
@@ -225,8 +225,8 @@
    "semantic_hash": ""
  },
  "backend/api_test.go": {
-    "mtime": 1786863966.7056258,
-    "ast_hash": "0d443b4fe3c04ab057505d73b8a88d07",
+    "mtime": 1786868080.2317674,
+    "ast_hash": "b64372df5429fb14e48b37b3bab10402",
    "semantic_hash": ""
  },
  "backend/cover_test.go": {
@@ -235,9 +235,9 @@
    "semantic_hash": ""
  },
  "backend/internal/api/handlers.go": {
-    "mtime": 1786363889.552731,
-    "ast_hash": "59e6b8767ab19839bb8f82891a7e4616",
-    "semantic_hash": "59e6b8767ab19839bb8f82891a7e4616"
+    "mtime": 1786867745.788687,
+    "ast_hash": "ae4f3b961450f06a06e0632eb273a5b2",
+    "semantic_hash": ""
  },
  "backend/internal/httpmw/middleware.go": {
    "mtime": 1786216141.672644,
@@ -260,8 +260,8 @@
    "semantic_hash": ""
  },
  "backend/internal/latest/poller.go": {
-    "mtime": 1786865046.096795,
-    "ast_hash": "2bfb51177e3df474b80ea1b05523377e",
+    "mtime": 1786872774.641225,
+    "ast_hash": "5e55e2ac5cb7d347807754f92425d29b",
    "semantic_hash": ""
  },
  "backend/internal/latest/poller_test.go": {
@@ -270,8 +270,8 @@
    "semantic_hash": ""
  },
  "backend/internal/latest/sites.go": {
-    "mtime": 1786861012.026504,
-    "ast_hash": "9b90f9b710ccbd0d0a0a6a0dd721ff3c",
+    "mtime": 1786868771.0663204,
+    "ast_hash": "5786000dd0dfd5b4b3bd2b87b1fc100b",
    "semantic_hash": ""
  },
  "backend/internal/latest/sites_test.go": {
@@ -340,13 +340,13 @@
    "semantic_hash": "0b6764a0ee20f5cb7748eecd31a1d220"
  },
  "backend/internal/store/store.go": {
-    "mtime": 1786863704.5112119,
-    "ast_hash": "989629af18232e35b12f1eef2a8cb422",
+    "mtime": 1786868763.646761,
+    "ast_hash": "34f55617b7409f03f02e925bec92fac0",
    "semantic_hash": ""
  },
  "backend/internal/store/store_test.go": {
-    "mtime": 1786863712.075631,
-    "ast_hash": "e48f21e34238ba46874cc88cf96e022f",
+    "mtime": 1786867781.301985,
+    "ast_hash": "16f69d97eb63bcec7409294466642411",
    "semantic_hash": ""
  },
  "backend/internal/userscript/userscript.go": {
@@ -395,8 +395,8 @@
    "semantic_hash": "8008a187690764436540fab47ba0cfcc"
  },
  "userscript/novel-bookmark.user.js": {
-    "mtime": 1786499529.779988,
-    "ast_hash": "834effb0821f8d6c9f57f6554a5db462",
+    "mtime": 1786872902.809149,
+    "ast_hash": "36c81462919719f0e053ca5d633a243a",
    "semantic_hash": ""
  },
  "userscript/test/novel-logic.test.js": {
@@ -425,13 +425,13 @@
    "semantic_hash": "6c6f3e4c4c2f57867894280bce728c50"
  },
  "backend/AGENTS.md": {
-    "mtime": 1786865319.314815,
-    "ast_hash": "5bbabcd7dd425302cb0d989d8897baf6",
+    "mtime": 1786872951.3127444,
+    "ast_hash": "68bc86af9593adad1e37fa05188fe63e",
    "semantic_hash": ""
  },
  "backend/CLAUDE.md": {
-    "mtime": 1786865319.314815,
-    "ast_hash": "5bbabcd7dd425302cb0d989d8897baf6",
+    "mtime": 1786872951.3127444,
+    "ast_hash": "68bc86af9593adad1e37fa05188fe63e",
    "semantic_hash": ""
  },
  "backend/internal/web/templates/app.html": {
@@ -658,5 +658,20 @@
    "mtime": 1786865113.5362902,
    "ast_hash": "8b9f9c7a56e0ec3bf950aa70acd95e92",
    "semantic_hash": ""
+  },
+  "backend/internal/latest/sighting_test.go": {
+    "mtime": 1786868815.9760568,
+    "ast_hash": "3b1372bbeeb538b73f86f57da210b4cc",
+    "semantic_hash": ""
+  },
+  "backend/internal/store/migrations/0011_series_sightings.sql": {
+    "mtime": 1786867605.3728056,
+    "ast_hash": "d0ade928a6e951eb179e4d0255cca526",
+    "semantic_hash": ""
+  },
+  "docs/adr/0011-sighting-deferral-trust-model.md": {
+    "mtime": 1786872970.473592,
+    "ast_hash": "0b6ca704f62185c9d629320f2d8475b5",
+    "semantic_hash": ""
  }
 }