dvorakmortonxd.dev/graphify-out/GRAPH_REPORT.md

217 lines
No EOL
9.6 KiB
Markdown

# Graph Report - dvorakmortonxd.dev (2026-10-16)
## Corpus Check
- 44 files · ~320,188 words
- Verdict: corpus is large enough that graph structure adds value.
- Unclassified: 19 file(s) not represented in the graph (top: (none) 6, .ttf 3, .css 3)
## Summary
- 434 nodes · 607 edges · 37 communities (23 shown, 14 thin omitted)
- Extraction: 93% EXTRACTED · 7% INFERRED · 0% AMBIGUOUS · INFERRED: 44 edges (avg confidence: 0.89)
- Token cost: 0 input · 0 output
## Graph Freshness
- Built from commit: `e4530afd`
- Run `git rev-parse HEAD` and compare to check if the graph is stale.
- Run `graphify update .` after code changes (no API cost).
## Community Hubs (Navigation)
- Desktop App Catalog
- Deployment & Ops Docs
- braces Package Metadata
- useTheme.ts
- braces Parsing Engine
- apps.tsx
- braces Character Constants
- Next Config & API Routes
- TypeScript Compiler Config
- package.json
- Root Dev Dependencies
- ProjectIndex.tsx
- Debian Dependency Installer
- dev-server.mjs
- Freezmo Icon Visual Identity
- braces Public API Methods
- Eye Logo & Favicon Assets
- Discord Icon Asset
- AGENTS.md — cold-boot notes
- Instagram Icon Asset
- Gentoo Logo Asset
- Reddit Icon Asset
- Revival Inc. Game Favicon
- TikTok Icon Asset
- System Service Installer
- PostCSS Configuration
- GitHub Icon Asset
- itch.io Icon Asset
- Joker Character Image
- LinkedIn Icon Asset
- Quipee Logo Asset
- Snapchat Icon Asset
- SoundCloud Icon Asset
- Twitter/X Icon Asset
## God Nodes (most connected - your core abstractions)
1. `WebLayout()` - 19 edges
2. `react` - 16 edges
3. `compilerOptions` - 16 edges
4. `next` - 12 edges
5. `FeatureWindow()` - 12 edges
6. `useTheme()` - 12 edges
7. `AGENTS.md — cold-boot notes` - 12 edges
8. `WindowsDesktop()` - 9 edges
9. `ContributionHeatmap()` - 8 edges
10. `ServiceButton()` - 8 edges
## Surprising Connections (you probably didn't know these)
- `Web theme + light/dark (v2.2 rework)` --references--> `FeatureWindow()` [INFERRED]
AGENTS.md → src/app/components/FeatureWindow.tsx
- `How UI selection works` --references--> `ThemeScript()` [INFERRED]
AGENTS.md → src/app/components/ThemeScript.tsx
- `How UI selection works` --references--> `WebLayout()` [INFERRED]
AGENTS.md → src/app/components/WebLayout.tsx
- `How UI selection works` --references--> `useColorScheme()` [INFERRED]
AGENTS.md → src/app/components/useColorScheme.ts
- `Conventions & things that will bite you` --references--> `braces()` [INFERRED]
AGENTS.md → vendor/braces/index.js
## Import Cycles
- None detected.
## Hyperedges (group relationships)
- **Freezmo Icon Visual Identity** — public_freezmo_icon, public_freezmo_snowflake_symbol, public_freezmo_stacked_cards, public_freezmo_dark_squircle_frame [EXTRACTED 1.00]
- **** — public_revival_inc_favicon_png_image, public_revival_inc_favicon_png_revival_inc_game, public_revival_inc_favicon_png_game_controller_mark [INFERRED 0.75]
- **Site identity: eye logo used as app icon and in-page logo** — src_app_icon_png_image, src_app_icon_png_eye_logo, src_app_icon_png_favicon, src_app_components_jokerlogo_tsx_logo [INFERRED 0.85]
## Communities (37 total, 14 thin omitted)
### Community 0 - "Desktop App Catalog"
Cohesion: 0.08
Nodes (35): Web theme + light/dark (v2.2 rework), react, AeroMusic(), loadWidgetApi(), PLACEHOLDER, SoundCloudGlobal, SoundCloudSound, SoundCloudWidget (+27 more)
### Community 1 - "Deployment & Ops Docs"
Cohesion: 0.09
Nodes (30): Autostart on Boot (systemd / OpenRC), Cloudflare Tunnel Reverse Proxy, PM2 Ecosystem Config File, Node.js >= 20.9.0 Requirement, PM2 Production Deployment (Debian/Alpine), Martin Dvořák (dvorakmortonxd), Coding Projects, Friends' Sites (+22 more)
### Community 2 - "braces Package Metadata"
Cohesion: 0.05
Nodes (37): ansi-colors, bash-path, gulp-format-md, mocha, author, bugs, url, contributors (+29 more)
### Community 3 - "useTheme.ts"
Cohesion: 0.19
Nodes (13): How UI selection works, WelcomeApp(), ThemeRoot(), DEFAULT_THEME, getServerSnapshot(), getSnapshot(), setTheme(), subscribe() (+5 more)
### Community 4 - "braces Parsing Engine"
Cohesion: 0.10
Nodes (17): compile, expand, parse, stringify, compile(), fill, utils, append() (+9 more)
### Community 5 - "apps.tsx"
Cohesion: 0.06
Nodes (36): Conventions & things that will bite you, ALACRITTY_APP, APP_BY_ID, AppDef, APPS, createWebsiteApp(), EmbeddedSite(), FriendsApp() (+28 more)
### Community 6 - "braces Character Constants"
Cohesion: 0.11
Nodes (3): {
MAX_LENGTH,
CHAR_BACKSLASH, /* \ */
CHAR_BACKTICK, /* ` */
CHAR_COMMA, /* , */
CHAR_DOT, /* . */
CHAR_LEFT_PARENTHESES, /* ( */
CHAR_RIGHT_PARENTHESES, /* ) */
CHAR_LEFT_CURLY_BRACE, /* { */
CHAR_RIGHT_CURLY_BRACE, /* } */
CHAR_LEFT_SQUARE_BRACKET, /* [ */
CHAR_RIGHT_SQUARE_BRACKET, /* ] */
CHAR_DOUBLE_QUOTE, /* " */
CHAR_SINGLE_QUOTE, /* ' */
CHAR_NO_BREAK_SPACE,
CHAR_ZERO_WIDTH_NOBREAK_SPACE
}, parse(), stringify
### Community 7 - "Next Config & API Routes"
Cohesion: 0.15
Nodes (13): nextConfig, next, ALLOWED_HOSTS, clickShim(), fail(), GET(), isAllowedHost(), ALLOWED_HOSTS (+5 more)
### Community 8 - "TypeScript Compiler Config"
Cohesion: 0.11
Nodes (18): compilerOptions, allowJs, esModuleInterop, incremental, isolatedModules, jsx, lib, module (+10 more)
### Community 9 - "package.json"
Cohesion: 0.06
Nodes (35): eslintConfig, allowScripts, unrs-resolver@1.12.2, dependencies, next, react, react-dom, fill-range (+27 more)
### Community 10 - "Root Dev Dependencies"
Cohesion: 0.15
Nodes (13): devDependencies, autoprefixer, eslint, eslint-config-next, fill-range, postcss, @svgr/webpack, tailwindcss (+5 more)
### Community 11 - "ProjectIndex.tsx"
Cohesion: 0.14
Nodes (20): HardwareApp(), ProjectsApp(), CodingProjectIndex(), CodingRow(), Group(), HARDWARE_GROUPS, HardwareProjectIndex(), HardwareRow() (+12 more)
### Community 12 - "Debian Dependency Installer"
Cohesion: 0.43
Nodes (6): die(), log(), node_ok(), install-dependencies-deb.sh script, usage(), warn()
### Community 13 - "dev-server.mjs"
Cohesion: 0.29
Nodes (7): app, hasForwardedHeaders(), isDevDebugRequest(), isLocalDebugRequest(), isLoopback(), port, server
### Community 15 - "Freezmo Icon Visual Identity"
Cohesion: 0.53
Nodes (5): Dark Navy Rounded-Square (Squircle) Frame, Freeze / Preserve State, Freezmo App Icon, Blue Snowflake Symbol, Stacked Card / Document Metaphor
### Community 17 - "Eye Logo & Favicon Assets"
Cohesion: 0.50
Nodes (4): JokerLogo Component Logo Image, Eye Logo Mark (amber iris and pupil), App Icon - Macro Photograph of a Human Eye, All-Seeing Eye / Surveillance Motif
### Community 20 - "Discord Icon Asset"
Cohesion: 0.50
Nodes (4): Discord (chat platform brand mark), Discord Icon (SVG social link asset), Profile social link icon, SVG Repo (icon asset source)
### Community 21 - "AGENTS.md — cold-boot notes"
Cohesion: 0.11
Nodes (17): After finishing — push to git, AGENTS.md — cold-boot notes, Architecture, Bump the version on EVERY prompt — also do this every time, Design, Git, Gotcha: native drag hijacks the pointer gesture, graphify (+9 more)
### Community 22 - "Instagram Icon Asset"
Cohesion: 0.67
Nodes (4): Instagram Color Icon (SVG), Instagram Brand/Service, Social Media Link Asset, SVG Repo (Icon Source)
### Community 23 - "Gentoo Logo Asset"
Cohesion: 0.67
Nodes (3): Creative Commons BY-SA 2.5 License, Gentoo Linux ('g' Logo Mark), Gentoo Logo Vector
### Community 24 - "Reddit Icon Asset"
Cohesion: 0.67
Nodes (3): Reddit Logo Icon (SVG), Reddit, SVG Repo
### Community 25 - "Revival Inc. Game Favicon"
Cohesion: 0.67
Nodes (3): Game Controller Logo Mark, Revival Inc. Favicon (yellow character with game controller), Revival Inc. (pygame game for Mini Jame Gam #55)
### Community 26 - "TikTok Icon Asset"
Cohesion: 0.67
Nodes (3): TikTok, TikTok Logo Icon, SVG Repo
## Knowledge Gaps
- **54 isolated node(s):** `react-dom`, `@svgr/webpack`, `@tailwindcss/postcss`, `@types/node`, `@types/react` (+49 more)
These have ≤1 connection - possible missing edges or undocumented components. (Counts symbols only; 233 node(s) total have ≤1 connection when file, concept and rationale nodes are included.)
- **14 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 `Conventions & things that will bite you` connect `apps.tsx` to `braces Public API Methods`, `AGENTS.md — cold-boot notes`?**
_High betweenness centrality (0.181) - this node is a cross-community bridge._
- **Are the 2 inferred relationships involving `WebLayout()` (e.g. with `How UI selection works` and `Web theme + light/dark (v2.2 rework)`) actually correct?**
_`WebLayout()` has 2 INFERRED edges - model-reasoned connections that need verification._
- **What connects `react-dom`, `@svgr/webpack`, `@tailwindcss/postcss` to the rest of the system?**
_54 weakly-connected nodes found - possible documentation gaps or missing edges._
- **Should `Desktop App Catalog` be split into smaller, more focused modules?**
_Cohesion score 0.080338266384778 - nodes in this community are weakly interconnected._
- **Why does `braces()` connect `braces Public API Methods` to `braces Parsing Engine`, `apps.tsx`?**
_High betweenness centrality (0.149) - this node is a cross-community bridge._
- **Should `Deployment & Ops Docs` be split into smaller, more focused modules?**
_Cohesion score 0.08735632183908046 - nodes in this community are weakly interconnected._
- **Why does `react` connect `Desktop App Catalog` to `useTheme.ts`, `apps.tsx`, `Next Config & API Routes`, `package.json`, `ProjectIndex.tsx`?**
_High betweenness centrality (0.136) - this node is a cross-community bridge._