dvorakmortonxd.dev/graphify-out/GRAPH_REPORT.md

228 lines
No EOL
9.8 KiB
Markdown

# Graph Report - dvorakmortonxd.dev (2026-10-15)
## Corpus Check
- 43 files · ~319,284 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
- 424 nodes · 592 edges · 40 communities (25 shown, 15 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: `15ef4db7`
- 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
- WindowsDesktop.tsx
- braces Parsing Engine
- apps.tsx
- braces Character Constants
- Next Config & API Routes
- TypeScript Compiler Config
- Root Package Dependencies
- Root Dev Dependencies
- Debian Dependency Installer
- brace-expansion Overrides
- npm Scripts
- Freezmo Icon Visual Identity
- braces Public API Methods
- Eye Logo & Favicon Assets
- ESLint Configuration
- Runtime Dependencies
- 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
- Package allowScripts Overrides
- 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()` - 18 edges
2. `compilerOptions` - 16 edges
3. `react` - 15 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 (40 total, 15 thin omitted)
### Community 0 - "Desktop App Catalog"
Cohesion: 0.11
Nodes (26): Web theme + light/dark (v2.2 rework), react, ContributionsApp(), Clock(), getTime(), subscribe(), Activity, ActivityPayload (+18 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 - "WindowsDesktop.tsx"
Cohesion: 0.08
Nodes (33): Conventions & things that will bite you, How UI selection works, APP_BY_ID, AppDef, APPS, createWebsiteApp(), EmbeddedSite(), WebsiteApp() (+25 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.07
Nodes (36): ALACRITTY_APP, FriendsApp(), GitdxdApp(), HardwareApp(), NEOFETCH, ProjectsApp(), RevivalApp(), RustyWolfApp() (+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.10
Nodes (20): nextConfig, next, app, hasForwardedHeaders(), isDevDebugRequest(), isLocalDebugRequest(), isLoopback(), port (+12 more)
### Community 8 - "TypeScript Compiler Config"
Cohesion: 0.11
Nodes (18): compilerOptions, allowJs, esModuleInterop, incremental, isolatedModules, jsx, lib, module (+10 more)
### Community 9 - "Root Package Dependencies"
Cohesion: 0.13
Nodes (14): fill-range, name, private, version, autoprefixer, postcss, react-dom, @svgr/webpack (+6 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 12 - "Debian Dependency Installer"
Cohesion: 0.43
Nodes (6): die(), log(), node_ok(), install-dependencies-deb.sh script, usage(), warn()
### Community 13 - "brace-expansion Overrides"
Cohesion: 0.33
Nodes (6): brace-expansion, brace-expansion, overrides, braces, minimatch@^10.0.0, minimatch@^3.0.0
### Community 14 - "npm Scripts"
Cohesion: 0.33
Nodes (6): scripts, build, dev, dev:next, lint, start
### 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 18 - "ESLint Configuration"
Cohesion: 0.50
Nodes (3): eslintConfig, eslint, eslint-config-next
### Community 19 - "Runtime Dependencies"
Cohesion: 0.50
Nodes (4): dependencies, next, react, react-dom
### 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; 227 node(s) total have ≤1 connection when file, concept and rationale nodes are included.)
- **15 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 `WindowsDesktop.tsx` to `braces Public API Methods`, `AGENTS.md — cold-boot notes`?**
_High betweenness centrality (0.183) - 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.10873440285204991 - nodes in this community are weakly interconnected._
- **Why does `braces()` connect `braces Public API Methods` to `WindowsDesktop.tsx`, `braces Parsing Engine`?**
_High betweenness centrality (0.150) - 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 `next` connect `Next Config & API Routes` to `Desktop App Catalog`, `Root Package Dependencies`, `WindowsDesktop.tsx`, `apps.tsx`?**
_High betweenness centrality (0.126) - this node is a cross-community bridge._