diff --git a/graphify-out/.graphify_labels.json b/graphify-out/.graphify_labels.json index 26f3d76..548afcf 100644 --- a/graphify-out/.graphify_labels.json +++ b/graphify-out/.graphify_labels.json @@ -25,12 +25,11 @@ "23": "Browser Entrypoint", "24": "Memory Allocation & GC", "25": "Cover Fetcher Tests", - "26": "Deployment & Cover ADRs", + "26": "readSeries", "27": "Find Skills Guide", "28": "Allocation Patterns", "29": "Observability & Alerting", "30": "PG Test Infrastructure", - "31": "Domain Concepts", "32": "Repo Hard Constraints", "33": "Go Testing Guide", "34": "Session Store", @@ -124,7 +123,6 @@ "122": "Identity comes from Discord OAuth; we store no passwords and send no email", "123": "The wire format stays flat and deliberately does not mirror the schema", "124": "ADR-0005: On-demand browser sidecar", - "125": "AGENTS.md", "126": "Bookmark Manager", "127": "triage-labels.md", "128": "Cross-Ticket Contract", @@ -179,18 +177,6 @@ "177": "Backend CLAUDE.md Guidance", "178": "Graphify Knowledge Graph (graphify-out/)", "179": "CLAUDE.md (Symlink to AGENTS.md)", - "180": "Chapter Slug", - "181": "CONTEXT.md Ubiquitous Language", - "182": "Favourite", - "183": "Latest Chapter", - "184": "Library", - "185": "Lifecycle Bucket", - "186": "New Chapter", - "187": "Poll", - "188": "Progress", - "189": "Reader", - "190": "Series", - "191": "Site", "192": "ADR-0001 (Drop modernc.org/sqlite)", "193": "ADR-0003 (Split Shared Series Facts)", "194": "SQLite-to-Postgres Cutover Runbook", @@ -271,6 +257,6 @@ "269": "pg_dump Hot Backup", "270": "Redeploy Runbook", "271": "Rollback Strategy", - "272": "Bearer-token API client (apiGet/apiPut/apiDelete)", + "273": "AGENTS.md", "279": "Userscript CLAUDE guidance" } diff --git a/graphify-out/GRAPH_REPORT.md b/graphify-out/GRAPH_REPORT.md index 0559887..d2e4451 100644 --- a/graphify-out/GRAPH_REPORT.md +++ b/graphify-out/GRAPH_REPORT.md @@ -1,16 +1,16 @@ -# Graph Report - mangaBookmark (2026-08-11) +# Graph Report - mangaBookmark (2026-08-12) ## Corpus Check -- 108 files · ~265,771 words +- 110 files · ~267,508 words - Verdict: corpus is large enough that graph structure adds value. ## Summary -- 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) +- 1651 nodes · 3252 edges · 260 communities (65 shown, 195 thin omitted) +- Extraction: 90% EXTRACTED · 10% INFERRED · 0% AMBIGUOUS · INFERRED: 313 edges (avg confidence: 0.77) - Token cost: 0 input · 0 output ## Graph Freshness -- Built from commit: `fb65c78e` +- Built from commit: `f2151309` - Run `git rev-parse HEAD` and compare to check if the graph is stale. - Run `graphify update .` after code changes (no API cost). @@ -41,12 +41,11 @@ - [[_COMMUNITY_Browser Entrypoint|Browser Entrypoint]] - [[_COMMUNITY_Memory Allocation & GC|Memory Allocation & GC]] - [[_COMMUNITY_Cover Fetcher Tests|Cover Fetcher Tests]] -- [[_COMMUNITY_Deployment & Cover ADRs|Deployment & Cover ADRs]] +- [[_COMMUNITY_readSeries|readSeries]] - [[_COMMUNITY_Find Skills Guide|Find Skills Guide]] - [[_COMMUNITY_Allocation Patterns|Allocation Patterns]] - [[_COMMUNITY_Observability & Alerting|Observability & Alerting]] - [[_COMMUNITY_PG Test Infrastructure|PG Test Infrastructure]] -- [[_COMMUNITY_Domain Concepts|Domain Concepts]] - [[_COMMUNITY_Repo Hard Constraints|Repo Hard Constraints]] - [[_COMMUNITY_Go Testing Guide|Go Testing Guide]] - [[_COMMUNITY_Session Store|Session Store]] @@ -140,7 +139,6 @@ - [[_COMMUNITY_Identity comes from Discord OAuth; we store no passwords and send no email|Identity comes from Discord OAuth; we store no passwords and send no email]] - [[_COMMUNITY_The wire format stays flat and deliberately does not mirror the schema|The wire format stays flat and deliberately does not mirror the schema]] - [[_COMMUNITY_ADR-0005 On-demand browser sidecar|ADR-0005: On-demand browser sidecar]] -- [[_COMMUNITY_AGENTS|AGENTS.md]] - [[_COMMUNITY_Bookmark Manager|Bookmark Manager]] - [[_COMMUNITY_triage-labels|triage-labels.md]] - [[_COMMUNITY_Cross-Ticket Contract|Cross-Ticket Contract]] @@ -194,18 +192,6 @@ - [[_COMMUNITY_Backend CLAUDE.md Guidance|Backend CLAUDE.md Guidance]] - [[_COMMUNITY_Graphify Knowledge Graph (graphify-out)|Graphify Knowledge Graph (graphify-out/)]] - [[_COMMUNITY_CLAUDE.md (Symlink to AGENTS.md)|CLAUDE.md (Symlink to AGENTS.md)]] -- [[_COMMUNITY_Chapter Slug|Chapter Slug]] -- [[_COMMUNITY_CONTEXT.md Ubiquitous Language|CONTEXT.md Ubiquitous Language]] -- [[_COMMUNITY_Favourite|Favourite]] -- [[_COMMUNITY_Latest Chapter|Latest Chapter]] -- [[_COMMUNITY_Library|Library]] -- [[_COMMUNITY_Lifecycle Bucket|Lifecycle Bucket]] -- [[_COMMUNITY_New Chapter|New Chapter]] -- [[_COMMUNITY_Poll|Poll]] -- [[_COMMUNITY_Progress|Progress]] -- [[_COMMUNITY_Reader|Reader]] -- [[_COMMUNITY_Series|Series]] -- [[_COMMUNITY_Site|Site]] - [[_COMMUNITY_ADR-0001 (Drop modernc.orgsqlite)|ADR-0001 (Drop modernc.org/sqlite)]] - [[_COMMUNITY_ADR-0003 (Split Shared Series Facts)|ADR-0003 (Split Shared Series Facts)]] - [[_COMMUNITY_SQLite-to-Postgres Cutover Runbook|SQLite-to-Postgres Cutover Runbook]] @@ -286,7 +272,7 @@ - [[_COMMUNITY_pg_dump Hot Backup|pg_dump Hot Backup]] - [[_COMMUNITY_Redeploy Runbook|Redeploy Runbook]] - [[_COMMUNITY_Rollback Strategy|Rollback Strategy]] -- [[_COMMUNITY_Bearer-token API client (apiGetapiPutapiDelete)|Bearer-token API client (apiGet/apiPut/apiDelete)]] +- [[_COMMUNITY_AGENTS|AGENTS.md]] - [[_COMMUNITY_Userscript CLAUDE guidance|Userscript CLAUDE guidance]] ## God Nodes (most connected - your core abstractions) @@ -294,7 +280,7 @@ 2. `newWebTestServer()` - 49 edges 3. `newTestStore()` - 42 edges 4. `newTestStore()` - 41 edges -5. `e()` - 29 edges +5. `e()` - 33 edges 6. `Handler` - 29 edges 7. `ne()` - 28 edges 8. `De()` - 28 edges @@ -306,12 +292,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. @@ -327,7 +313,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 (274 total, 208 thin omitted) +## Communities (260 total, 195 thin omitted) ### Community 0 - "HTMX Library Internals" Cohesion: 0.08 @@ -339,23 +325,23 @@ Nodes (84): 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(), applyLatestChapterIfChanged() (+69 more) ### Community 3 - "Novel Userscript Adapters" -Cohesion: 0.08 -Nodes (71): adapterFor(), anchorsFromDocument(), anchorsFromHTML(), apiDelete(), apiGet(), apiPut(), applyFabPos(), applyLatestChapterIfChanged() (+63 more) +Cohesion: 0.06 +Nodes (78): adapterFor(), anchorsFromDocument(), anchorsFromHTML(), apiDelete(), apiGet(), apiPut(), applyFabPos(), applyLatestChapterIfChanged() (+70 more) ### Community 4 - "Series Acquisition Tests" -Cohesion: 0.10 -Nodes (67): bookmarkNewKaganeSeries(), bookmarkNewNovelfullSeries(), bookmarkNewSeries(), Context, Store, T, newAcquirer(), readBookmark() (+59 more) +Cohesion: 0.09 +Nodes (68): bookmarkNewKaganeSeries(), bookmarkNewNovelfullSeries(), bookmarkNewSeries(), Context, Store, T, newAcquirer(), readBookmark() (+60 more) ### Community 5 - "Bookmarks API Tests" Cohesion: 0.08 Nodes (67): auth(), getBookmarks(), Handler, Request, Store, T, newTestServer(), newTestStore() (+59 more) ### Community 7 - "Cover & Acquire Internals" -Cohesion: 0.08 -Nodes (40): Addr, Context, Store, defaultCoverResolver(), fetchCoverBytes(), Client, Context, NewCoverFetcher() (+32 more) +Cohesion: 0.06 +Nodes (59): Addr, Context, Store, defaultCoverResolver(), fetchCoverBytes(), Client, Context, NewCoverFetcher() (+51 more) ### Community 8 - "System Architecture Concepts" Cohesion: 0.10 @@ -370,8 +356,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.14 -Nodes (44): scanSeries(), Store, T, newTestStore(), readLatestCheckedAt(), readSeries(), secondReader(), seedForCheck() (+36 more) +Cohesion: 0.15 +Nodes (43): Store, T, newTestStore(), readLatestCheckedAt(), readSeries(), secondReader(), seedForCheck(), seedSecondReader() (+35 more) ### Community 12 - "Bookmarks API Handler" Cohesion: 0.08 @@ -387,26 +373,26 @@ Nodes (33): Creating Errors, Custom Error Types, Custom types that wrap other er ### Community 15 - "CDP Browser Client" Cohesion: 0.08 -Nodes (29): Action, awaitPromise(), browserConnectionLost(), classifyBrowserError(), Context, Mutex, isInterstitial(), jsString() (+21 more) +Nodes (30): awaitPromise(), browserConnectionLost(), classifyBrowserError(), Action, Context, Mutex, jsString(), kaganeAPIURL() (+22 more) ### Community 16 - "Store" -Cohesion: 0.09 -Nodes (7): CoverContentType(), coverRelativePath(), coverSourceAddress(), displayChapter(), Store, TestDisplayChapter(), Bookmark +Cohesion: 0.12 +Nodes (4): CoverContentType(), coverRelativePath(), coverSourceAddress(), Store ### 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) +Cohesion: 0.17 +Nodes (19): applyMigration(), migrate(), Open(), refreshOwnerToken(), scanSeries(), seedOwner(), TestCoverIsContentAddressedOnFilesystem(), TestCoverPersistsAcrossReopen() (+11 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.12 +Cohesion: 0.13 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" @@ -430,8 +416,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.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) +Cohesion: 0.11 +Nodes (19): Allocation Patterns, Backing Array Leaks, Direct indexing vs append, Eliminate redundant map lookups, Interface boxing, Map never shrinks, Map of pointers for large, frequently updated structs, Map size hints (+11 more) ### Community 29 - "Observability & Alerting" Cohesion: 0.22 @@ -458,15 +444,8 @@ 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 +Cohesion: 0.33 +Nodes (5): ADR-0009: A Site answers fixed questions; an unusual Site owns its own fetch, Consequences, Considered options, Decision, Why ### Community 39 - "UI Critique 2026-07-26A" Cohesion: 0.29 @@ -489,7 +468,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.28 +Cohesion: 0.22 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" @@ -588,33 +567,29 @@ Nodes (3): Consequence, The wire format stays flat and deliberately does not mir 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)" +### Community 273 - "AGENTS.md" 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 -- **540 isolated node(s):** `test`, `assert`, `store`, `metaTags`, `elements` (+535 more) +- **530 isolated node(s):** `bookmarkmanager/backend`, `ctxKey`, `loginView`, `ctxKey`, `test` (+525 more) These have ≤1 connection - possible missing edges or undocumented components. -- **208 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes. +- **195 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 `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 `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._ + _High betweenness centrality (0.047) - this node is a cross-community bridge._ +- **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.032) - 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.030) - this node is a cross-community bridge._ + _High betweenness centrality (0.025) - 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 `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 +- **What connects `bookmarkmanager/backend`, `ctxKey`, `loginView` to the rest of the system?** + _572 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 5035cbd..7dce9e6 100644 --- a/graphify-out/graph.html +++ b/graphify-out/graph.html @@ -63,12 +63,12 @@
-
1637 nodes · 3195 edges · 274 communities
+
1651 nodes · 3252 edges · 260 communities