diff --git a/graphify-out/.graphify_labels.json b/graphify-out/.graphify_labels.json index 6d49d43..26f3d76 100644 --- a/graphify-out/.graphify_labels.json +++ b/graphify-out/.graphify_labels.json @@ -15,8 +15,10 @@ "13": "Web UI Handlers", "14": "Go Error Handling", "15": "CDP Browser Client", + "16": "Store", "17": "Go Code Style Guide", "18": "Agent Skills", + "19": "Open", "20": "I/O Performance Patterns", "21": "CPU Optimization", "22": "Caching Patterns", @@ -35,6 +37,7 @@ "35": "Web UI Filter Logic", "36": "Userscript Test Harness", "37": "Product & Security Context", + "38": "novel-logic.test.js", "39": "UI Critique 2026-07-26A", "40": "UI Critique 2026-07-26B", "41": "DB Cutover Runbook", @@ -269,11 +272,5 @@ "270": "Redeploy Runbook", "271": "Rollback Strategy", "272": "Bearer-token API client (apiGet/apiPut/apiDelete)", - "273": "Userscript AGENTS guidance", - "274": "manga-bookmark.user.js (single-IIFE manga script)", - "275": "novel-bookmark.user.js (novel script, bmgr:novel:)", - "276": "Offline retry queue (bmgr:manga:queue markers)", - "277": "Shadow DOM UI isolation from site CSS", - "278": "Site adapters (URL-regex detect, og:title)", "279": "Userscript CLAUDE guidance" } diff --git a/graphify-out/GRAPH_REPORT.md b/graphify-out/GRAPH_REPORT.md index d2ab02d..0559887 100644 --- a/graphify-out/GRAPH_REPORT.md +++ b/graphify-out/GRAPH_REPORT.md @@ -1,16 +1,16 @@ # Graph Report - mangaBookmark (2026-08-11) ## Corpus Check -- 108 files · ~265,471 words +- 108 files · ~265,771 words - Verdict: corpus is large enough that graph structure adds value. ## Summary -- 1644 nodes · 3206 edges · 277 communities (62 shown, 215 thin omitted) -- Extraction: 90% EXTRACTED · 10% INFERRED · 0% AMBIGUOUS · INFERRED: 312 edges (avg confidence: 0.77) +- 1637 nodes · 3195 edges · 274 communities (66 shown, 208 thin omitted) +- Extraction: 90% EXTRACTED · 10% INFERRED · 0% AMBIGUOUS · INFERRED: 305 edges (avg confidence: 0.77) - Token cost: 0 input · 0 output ## Graph Freshness -- Built from commit: `27dda601` +- Built from commit: `fb65c78e` - Run `git rev-parse HEAD` and compare to check if the graph is stale. - Run `graphify update .` after code changes (no API cost). @@ -31,8 +31,10 @@ - [[_COMMUNITY_Web UI Handlers|Web UI Handlers]] - [[_COMMUNITY_Go Error Handling|Go Error Handling]] - [[_COMMUNITY_CDP Browser Client|CDP Browser Client]] +- [[_COMMUNITY_Store|Store]] - [[_COMMUNITY_Go Code Style Guide|Go Code Style Guide]] - [[_COMMUNITY_Agent Skills|Agent Skills]] +- [[_COMMUNITY_Open|Open]] - [[_COMMUNITY_IO Performance Patterns|I/O Performance Patterns]] - [[_COMMUNITY_CPU Optimization|CPU Optimization]] - [[_COMMUNITY_Caching Patterns|Caching Patterns]] @@ -51,6 +53,7 @@ - [[_COMMUNITY_Web UI Filter Logic|Web UI Filter Logic]] - [[_COMMUNITY_Userscript Test Harness|Userscript Test Harness]] - [[_COMMUNITY_Product & Security Context|Product & Security Context]] +- [[_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_DB Cutover Runbook|DB Cutover Runbook]] @@ -284,12 +287,6 @@ - [[_COMMUNITY_Redeploy Runbook|Redeploy Runbook]] - [[_COMMUNITY_Rollback Strategy|Rollback Strategy]] - [[_COMMUNITY_Bearer-token API client (apiGetapiPutapiDelete)|Bearer-token API client (apiGet/apiPut/apiDelete)]] -- [[_COMMUNITY_Userscript AGENTS guidance|Userscript AGENTS guidance]] -- [[_COMMUNITY_manga-bookmark.user.js (single-IIFE manga script)|manga-bookmark.user.js (single-IIFE manga script)]] -- [[_COMMUNITY_novel-bookmark.user.js (novel script, bmgrnovel)|novel-bookmark.user.js (novel script, bmgr:novel:)]] -- [[_COMMUNITY_Offline retry queue (bmgrmangaqueue markers)|Offline retry queue (bmgr:manga:queue markers)]] -- [[_COMMUNITY_Shadow DOM UI isolation from site CSS|Shadow DOM UI isolation from site CSS]] -- [[_COMMUNITY_Site adapters (URL-regex detect, ogtitle)|Site adapters (URL-regex detect, og:title)]] - [[_COMMUNITY_Userscript CLAUDE guidance|Userscript CLAUDE guidance]] ## God Nodes (most connected - your core abstractions) @@ -297,7 +294,7 @@ 2. `newWebTestServer()` - 49 edges 3. `newTestStore()` - 42 edges 4. `newTestStore()` - 41 edges -5. `e()` - 33 edges +5. `e()` - 29 edges 6. `Handler` - 29 edges 7. `ne()` - 28 edges 8. `De()` - 28 edges @@ -309,12 +306,12 @@ chrome/docker-compose.yml → backend/AGENTS.md - `el()` --indirect_call--> `c()` [INFERRED] userscript/manga-bookmark.user.js → backend/internal/web/static/htmx.min.js -- `el()` --indirect_call--> `c()` [INFERRED] - userscript/novel-bookmark.user.js → backend/internal/web/static/htmx.min.js - `latestChapterFromAnchors()` --indirect_call--> `re()` [INFERRED] userscript/manga-bookmark.user.js → backend/internal/web/static/htmx.min.js - `el()` --indirect_call--> `k()` [INFERRED] userscript/manga-bookmark.user.js → backend/internal/web/static/htmx.min.js +- `makeDraggable()` --indirect_call--> `e()` [INFERRED] + userscript/manga-bookmark.user.js → backend/internal/web/static/htmx.min.js ## Import Cycles - None detected. @@ -330,7 +327,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 (277 total, 215 thin omitted) +## Communities (274 total, 208 thin omitted) ### Community 0 - "HTMX Library Internals" Cohesion: 0.08 @@ -345,8 +342,8 @@ Cohesion: 0.06 Nodes (76): adapterFor(), anchorsFromDocument(), anchorsFromHTML(), apiDelete(), apiGet(), apiPut(), applyFabPos(), applyLatestChapterIfChanged() (+68 more) ### Community 3 - "Novel Userscript Adapters" -Cohesion: 0.06 -Nodes (79): adapterFor(), anchorsFromDocument(), anchorsFromHTML(), apiDelete(), apiGet(), apiPut(), applyFabPos(), applyLatestChapterIfChanged() (+71 more) +Cohesion: 0.08 +Nodes (71): adapterFor(), anchorsFromDocument(), anchorsFromHTML(), apiDelete(), apiGet(), apiPut(), applyFabPos(), applyLatestChapterIfChanged() (+63 more) ### Community 4 - "Series Acquisition Tests" Cohesion: 0.10 @@ -373,8 +370,8 @@ Cohesion: 0.05 Nodes (39): Test Helpers, Test Timeout, Basic Handler Test, HTTP Handler Testing, Query Parameters and Headers, Docker Compose Fixture, Integration Testing, SQL Schema Fixture (+31 more) ### Community 11 - "Store Tests" -Cohesion: 0.05 -Nodes (75): T, TestCreateAndGetSession(), TestDeleteSessionIsPerReader(), TestDeleteSessionRevokes(), TestExpiredSessionIsGone(), TestGetSessionUnknownID(), applyMigration(), CoverContentType() (+67 more) +Cohesion: 0.14 +Nodes (44): scanSeries(), Store, T, newTestStore(), readLatestCheckedAt(), readSeries(), secondReader(), seedForCheck() (+36 more) ### Community 12 - "Bookmarks API Handler" Cohesion: 0.08 @@ -392,16 +389,24 @@ Nodes (33): Creating Errors, Custom Error Types, Custom types that wrap other er Cohesion: 0.08 Nodes (29): Action, awaitPromise(), browserConnectionLost(), classifyBrowserError(), Context, Mutex, isInterstitial(), jsString() (+21 more) +### Community 16 - "Store" +Cohesion: 0.09 +Nodes (7): CoverContentType(), coverRelativePath(), coverSourceAddress(), displayChapter(), Store, TestDisplayChapter(), Bookmark + ### Community 17 - "Go Code Style Guide" Cohesion: 0.08 Nodes (23): Code Style Details, Extract Complex Conditions, Value vs Pointer Arguments, Code Organization Within Files, Complex Conditions & Init Scope, Composite Literals, Control Flow, Cross-References (+15 more) +### Community 19 - "Open" +Cohesion: 0.19 +Nodes (18): applyMigration(), migrate(), Open(), refreshOwnerToken(), seedOwner(), TestCoverIsContentAddressedOnFilesystem(), TestCoverPersistsAcrossReopen(), TestMigration0002BackfillsExistingBookmarks() (+10 more) + ### Community 20 - "I/O Performance Patterns" Cohesion: 0.11 Nodes (18): Avoid io.ReadAll for large payloads, Batch Operations, Buffered I/O, Cgo Overhead, Channel: batch processing from a stream, Concurrent Multi-Stage Pipelines, Connection pooling, Database: batch inserts over row-by-row (+10 more) ### Community 21 - "CPU Optimization" -Cohesion: 0.13 +Cohesion: 0.12 Nodes (15): Cache Locality, Contiguous 2D allocation, CPU Optimization, False Sharing, Function Inlining, Handling CPU-specific instruction sets, Instruction-Level Parallelism, Monotonic Time (+7 more) ### Community 22 - "Caching Patterns" @@ -425,8 +430,8 @@ Cohesion: 0.14 Nodes (13): Common Skill Categories, Find Skills, How to Help Users Find Skills, Step 1: Understand What They Need, Step 2: Check the Leaderboard First, Step 3: Search for Skills, Step 4: Verify Quality Before Recommending, Step 5: Present Options to the User (+5 more) ### Community 28 - "Allocation Patterns" -Cohesion: 0.14 -Nodes (14): Allocation Patterns, Backing Array Leaks, Direct indexing vs append, Eliminate redundant map lookups, Interface boxing, Map never shrinks, Map size hints, Memory Optimization (+6 more) +Cohesion: 0.17 +Nodes (12): Backing Array Leaks, Map never shrinks, Map of pointers for large, frequently updated structs, Memory Layout, Memory Optimization, Pointer receivers for large structs, Slice reslicing retains the entire backing array, String and Byte Optimization (+4 more) ### Community 29 - "Observability & Alerting" Cohesion: 0.22 @@ -452,6 +457,17 @@ Nodes (5): closeCardPanels(), setActiveTab(), toggleChapterForm(), toggleConfirm Cohesion: 0.17 Nodes (11): Accessibility & Inclusion, Brand Commitments, Capabilities and Constraints, Evidence on Hand, Operating Context, Platform, Positioning, Product (+3 more) +### Community 38 - "novel-logic.test.js" +Cohesion: 0.13 +Nodes (8): assert, attrEls, elements, metaTags, { + novelfull, + lightnovelworld, + computeLatestChapter, + kindOf, + maxChapter, + repairLnwStaleRow, +}, reset(), store, test + ### Community 39 - "UI Critique 2026-07-26A" Cohesion: 0.29 Nodes (6): Design Health Score, Design Specificity Verdict, Minor Observations, Persona Red Flags, Priority Issues, Questions to Consider @@ -461,8 +477,8 @@ Cohesion: 0.29 Nodes (6): Design Health Score, Design Specificity Verdict, Minor Observations, Persona Red Flags, Priority Issues, Questions to Consider ### Community 42 - "Memory Layout Patterns" -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 +Cohesion: 0.48 +Nodes (6): T, TestCreateAndGetSession(), TestDeleteSessionIsPerReader(), TestDeleteSessionRevokes(), TestExpiredSessionIsGone(), TestGetSessionUnknownID() ### Community 45 - "Go Perf Alert Rules" Cohesion: 0.50 @@ -473,7 +489,7 @@ Cohesion: 0.07 Nodes (27): 1. Summary answer table, 2. The two reference pages, 3. Chapter page → series URL: every in-page pointer, in priority order, 4.1 Sample method, 4.2 Divergence results, 4.3 Is there a derivable rule? **No.**, 4.4 The split case — a slug can change *mid-series*, 4. The reverse direction, and how common divergence is (+19 more) ### Community 47 - "Go Perf Skill Docs" -Cohesion: 0.22 +Cohesion: 0.28 Nodes (5): Continuous Profiling, Production Observability for Performance, Pyroscope pull mode (via Grafana Alloy), Pyroscope push mode, Real-Time Visualization (Development) ### Community 48 - "Login Page Art" @@ -573,28 +589,32 @@ Cohesion: 0.50 Nodes (3): ADR-0005: On-demand browser sidecar, Constraints, Decision ### Community 125 - "AGENTS.md" +Cohesion: 0.29 +Nodes (7): Allocation Patterns, Direct indexing vs append, Eliminate redundant map lookups, Interface boxing, Map size hints, Reuse slices via append(s[:0], ...), Sentinel errors vs fmt.Errorf + +### Community 272 - "Bearer-token API client (apiGet/apiPut/apiDelete)" 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 -- **545 isolated node(s):** `bookmarkmanager/backend`, `ctxKey`, `loginView`, `ctxKey`, `test` (+540 more) +- **540 isolated node(s):** `test`, `assert`, `store`, `metaTags`, `elements` (+535 more) These have ≤1 connection - possible missing edges or undocumented components. -- **215 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes. +- **208 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 `New()` connect `Series Acquisition Tests` to `Bookmarks API Tests`, `Cover & Acquire Internals`, `Session Middleware`, `Store Tests`, `Web UI Handlers`?** +- **Why does `Open()` connect `Open` to `Cover Fetch Test Helpers`, `Series Acquisition Tests`, `Bookmarks API Tests`, `Store Tests`, `Store`, `PG Test Infrastructure`?** _High betweenness centrality (0.041) - this node is a cross-community bridge._ -- **Why does `Open()` connect `Store Tests` to `Cover Fetch Test Helpers`, `Series Acquisition Tests`, `Bookmarks API Tests`, `PG Test Infrastructure`?** - _High betweenness centrality (0.035) - 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`, `Open`?** + _High betweenness centrality (0.031) - 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`?** - _High betweenness centrality (0.022) - this node is a cross-community bridge._ + _High betweenness centrality (0.030) - this node is a cross-community bridge._ - **Are the 47 inferred relationships involving `testConfig()` (e.g. with `TestListRendersAcquiredCover()` and `TestPublicCoverNeverEchoesNonImage()`) actually correct?** _`testConfig()` has 47 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._ - **Are the 6 inferred relationships involving `newTestStore()` (e.g. with `TestCreateAndGetSession()` and `TestDeleteSessionIsPerReader()`) actually correct?** _`newTestStore()` has 6 INFERRED edges - model-reasoned connections that need verification._ -- **What connects `bookmarkmanager/backend`, `ctxKey`, `loginView` to the rest of the system?** - _589 weakly-connected nodes found - possible documentation gaps or missing edges._ \ No newline at end of file +- **What connects `test`, `assert`, `store` to the rest of the system?** + _582 weakly-connected nodes found - possible documentation gaps or missing edges._ \ No newline at end of file diff --git a/graphify-out/graph.html b/graphify-out/graph.html index 8d374fe..5035cbd 100644 --- a/graphify-out/graph.html +++ b/graphify-out/graph.html @@ -63,12 +63,12 @@
-
1644 nodes · 3206 edges · 277 communities
+
1637 nodes · 3195 edges · 274 communities