diff --git a/.gitignore b/.gitignore index abf325e..dfbcdf5 100644 --- a/.gitignore +++ b/.gitignore @@ -79,3 +79,7 @@ graphify-out/cache/ graphify-out/cost.json graphify-out/.graphify_python graphify-out/.graphify_root +graphify-out/.graphify_labels.pending.json +graphify-out/.graphify_labels.json.sig +# dated graph backups written by `graphify update` +graphify-out/20*/ diff --git a/AGENTS.md b/AGENTS.md index 08112da..4b7fee3 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -56,7 +56,7 @@ frosted-glass **web** site, and an alternate KDE/Plasma **desktop simulation** utilities in the components (Tailwind is present via PostCSS but the look is hand-written CSS). - Path alias: `@/*` → `src/*`. -- Version: `2.2.15` (see `package.json`). +- Version: `2.2.16` (see `package.json`). ### Scripts ```bash @@ -173,8 +173,8 @@ Themes: `web` = default frosted-glass website (sidebar + content, light/dark), along with the row hairlines (`--index-line`). Above the split, the full-width **Freezmo** launch panel (`.web-freezmo` — app-tinted glow, floating orbs, gradient wordmark + "new" badge, feature bullets, Try/Source CTAs) is the one - place a **real screenshot** is used (`public/freezmo.png`, the live - study app). The two remaining feature panels (`.web-split`) stretch + place the **real app icon** is used (`public/freezmo.png`, the live + study app), floated beside the copy with a soft glow. The two remaining feature panels (`.web-split`) stretch to equal height and share a fixed `16 / 10` `.fw` window (the `FeatureWindow` component) — decorative, **asset-free CSS mock-ups** rather than screenshots: Revival Inc. is a little necromancy game scene (night sky, moon, tombstones, @@ -195,7 +195,7 @@ Themes: `web` = default frosted-glass website (sidebar + content, light/dark), feature/app previews are `FeatureWindow` mock windows, and `.win-desktop` carries a layered gradient "wallpaper" (there is no `wallpaper.jpg`). Only the social SVGs, the site logo (`src/app/icon.png`), - the Freezmo screenshot (`public/freezmo.png`), the + the Freezmo app icon (`public/freezmo.png`), the Joker easter egg (`joker.webp`) and the Gentoo mark (`gentoo.svg`) remain as real image files. - **Not a terminal.** The web theme deliberately has no TUI chrome: the hero is diff --git a/README.md b/README.md index f4f5be0..14dfd75 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ from the saved theme, all from the same content: - **`web`** (default) — a light, frosted-glass **website**: a sticky full-height sidebar (section nav, light/dark switch, desktop switch) beside a column of glass cards — hero with - a socials row, quick tiles, the Freezmo feature panel (a real app screenshot) above the + a socials row, quick tiles, the Freezmo feature panel (a real app icon) above the Revival Inc. / RustyWolf CSS mock windows, live services, activity heatmap, projects and hardware (grouped index lists), and friends. Dark by default with a persisted light mode, and fully responsive, so phones and desktops get the same shell. @@ -40,7 +40,7 @@ more. (category headers, status/language chips, language-tinted dots on project rows, years — no emoji, no screenshots), the desktop shell's app previews are the same CSS mock windows (a git-forge page for GitDXD), and its wallpaper is a layered CSS gradient. The - only real images left are the logo, the social SVGs, the Freezmo screenshot, the Joker + only real images left are the logo, the social SVGs, the Freezmo app icon, the Joker easter egg and the Gentoo mark. - **Draggable desktop icons** — free placement that snaps to a measured grid, one icon per cell, with a follow-the-cursor drag ghost. Icons shrink on cramped viewports so they never @@ -84,7 +84,7 @@ more. used by the desktop theme's SMP menu and the in-desktop terminal. - **Images:** `next/image` — only the logo (`src/app/icon.png`), the social SVGs, the Joker easter egg and the Gentoo mark; all cards, feature/app previews and the wallpaper are CSS. -- **Version:** `2.2.15` (see `package.json`) +- **Version:** `2.2.16` (see `package.json`) - **Dependencies:** `npm audit` reports **0 vulnerabilities**. `next` is kept at a patched release (`>=16.3.6`) for the `next/og` RCE, and `brace-expansion` is force-upgraded via `overrides`. `braces` (a transitive ESLint/`fast-glob` dependency) has **no upstream fix**, diff --git a/graphify-out/.graphify_labels.json b/graphify-out/.graphify_labels.json index 26bf2d5..b5aca9e 100644 --- a/graphify-out/.graphify_labels.json +++ b/graphify-out/.graphify_labels.json @@ -1 +1,41 @@ -{"0": "Desktop App Catalog", "1": "Deployment & Ops Docs", "2": "braces Package Metadata", "3": "Theme & Clock Components", "4": "braces Parsing Engine", "5": "Project Index Data", "6": "braces Character Constants", "7": "Next Config & API Routes", "8": "TypeScript Compiler Config", "9": "Root Package Dependencies", "10": "Root Dev Dependencies", "11": "Custom Dev Server", "12": "Debian Dependency Installer", "13": "brace-expansion Overrides", "14": "npm Scripts", "15": "Freezmo Icon Visual Identity", "16": "braces Public API Methods", "17": "Eye Logo & Favicon Assets", "18": "ESLint Configuration", "19": "Runtime Dependencies", "20": "Discord Icon Asset", "21": "Freezmo App Screenshot", "22": "Instagram Icon Asset", "23": "Gentoo Logo Asset", "24": "Reddit Icon Asset", "25": "Revival Inc. Game Favicon", "26": "TikTok Icon Asset", "27": "System Service Installer", "28": "Package allowScripts Overrides", "29": "PostCSS Configuration", "30": "GitHub Icon Asset", "31": "itch.io Icon Asset", "32": "Joker Character Image", "33": "LinkedIn Icon Asset", "34": "Quipee Logo Asset", "35": "Snapchat Icon Asset", "36": "SoundCloud Icon Asset", "37": "Twitter/X Icon Asset", "38": "Activities API Route", "39": "Heatmap API Route", "40": "Revival Inc. Page"} \ No newline at end of file +{ + "0": "Desktop App Catalog", + "1": "Deployment & Ops Docs", + "2": "braces Package Metadata", + "4": "braces Parsing Engine", + "5": "Project Index Data", + "6": "braces Character Constants", + "7": "Next Config & API Routes", + "8": "TypeScript Compiler Config", + "9": "Root Package Dependencies", + "10": "Root Dev Dependencies", + "11": "Custom Dev Server", + "12": "Debian Dependency Installer", + "13": "brace-expansion Overrides", + "14": "npm Scripts", + "15": "Freezmo Icon Visual Identity", + "16": "braces Public API Methods", + "17": "Eye Logo & Favicon Assets", + "18": "ESLint Configuration", + "19": "Runtime Dependencies", + "20": "Discord Icon Asset", + "22": "Instagram Icon Asset", + "23": "Gentoo Logo Asset", + "24": "Reddit Icon Asset", + "25": "Revival Inc. Game Favicon", + "26": "TikTok Icon Asset", + "27": "System Service Installer", + "28": "Package allowScripts Overrides", + "29": "PostCSS Configuration", + "30": "GitHub Icon Asset", + "31": "itch.io Icon Asset", + "32": "Joker Character Image", + "33": "LinkedIn Icon Asset", + "34": "Quipee Logo Asset", + "35": "Snapchat Icon Asset", + "36": "SoundCloud Icon Asset", + "37": "Twitter/X Icon Asset", + "38": "Activities API Route", + "39": "Heatmap API Route", + "40": "Revival Inc. Page" +} diff --git a/graphify-out/GRAPH_REPORT.md b/graphify-out/GRAPH_REPORT.md index 6db9a44..6a85c88 100644 --- a/graphify-out/GRAPH_REPORT.md +++ b/graphify-out/GRAPH_REPORT.md @@ -1,20 +1,25 @@ # Graph Report - dvorakmortonxd.dev (2026-10-15) ## Corpus Check -- 63 files · ~107,169 words +- 43 files · ~105,962 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 -- 414 nodes · 577 edges · 41 communities (26 shown, 15 thin omitted) -- Extraction: 93% EXTRACTED · 7% INFERRED · 0% AMBIGUOUS · INFERRED: 39 edges (avg confidence: 0.85) +- 423 nodes · 591 edges · 42 communities (27 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: `6702ca8d` +- 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 -- Theme & Clock Components +- WindowsDesktop.tsx - braces Parsing Engine - Project Index Data - braces Character Constants @@ -32,7 +37,7 @@ - ESLint Configuration - Runtime Dependencies - Discord Icon Asset -- Freezmo App Screenshot +- AGENTS.md — cold-boot notes - Instagram Icon Asset - Gentoo Logo Asset - Reddit Icon Asset @@ -49,68 +54,65 @@ - Snapchat Icon Asset - SoundCloud Icon Asset - Twitter/X Icon Asset +- useColorScheme.ts ## God Nodes (most connected - your core abstractions) -1. `WebLayout()` - 16 edges +1. `WebLayout()` - 18 edges 2. `compilerOptions` - 16 edges 3. `react` - 15 edges 4. `next` - 12 edges -5. `FeatureWindow()` - 11 edges -6. `useTheme()` - 11 edges -7. `WindowsDesktop()` - 8 edges -8. `Clock()` - 7 edges -9. `ContributionHeatmap()` - 7 edges -10. `CodingProjectIndex()` - 7 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) -- `Revival Inc. Game` --conceptually_related_to--> `FeatureWindow CSS Mock Windows` [INFERRED] - public/llms.txt → README.md -- `GitDXD (Forgejo Git Forge)` --conceptually_related_to--> `Site API Proxy Routes` [INFERRED] - public/llms.txt → README.md -- `Vendored braces CVE Patch` --conceptually_related_to--> `Brace Bomb DoS / Geometric Complexity` [INFERRED] - agents.md → vendor/braces/README.md -- `FeatureWindow CSS Mock Windows` --references--> `Revival Inc. Pygbag Web Build` [EXTRACTED] - README.md → public/revival-inc/index.html -- `Vendored braces Patch` --references--> `braces Library` [EXTRACTED] - README.md → vendor/braces/README.md +- `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 +- `Web theme + light/dark (v2.2 rework)` --references--> `ContributionHeatmap()` [INFERRED] + AGENTS.md → src/app/components/ContributionHeatmap.tsx ## Import Cycles - None detected. ## Hyperedges (group relationships) -- **Two-Shell Theming Architecture** — readme_two_shells, readme_web_shell, readme_skeuo_shell, agents_theme_root [INFERRED 0.85] -- **Host-Allowlisted Proxy API Routes** — agents_ping_ssrf_allowlist, agents_frame_proxy, readme_api_routes [INFERRED 0.85] -- **Vendored braces CVE Patch Flow** — readme_vendored_braces_patch, agents_vendored_braces_patch, vendor_braces_readme_braces, vendor_braces_readme_brace_bomb [INFERRED 0.85] -- **Freezmo AI-graded quiz flow (app, quiz UI, sample question)** — public_freezmo_app_webp_image, public_freezmo_app_webp_freezmo_app, public_freezmo_app_webp_quiz_screen, public_freezmo_app_webp_schuman_plan_question [INFERRED 0.85] +- **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] -- **Freezmo Icon Visual Identity** — public_freezmo_icon, public_freezmo_snowflake_symbol, public_freezmo_stacked_cards, public_freezmo_dark_squircle_frame [EXTRACTED 1.00] -## Communities (41 total, 15 thin omitted) +## Communities (42 total, 15 thin omitted) ### Community 0 - "Desktop App Catalog" -Cohesion: 0.06 -Nodes (41): react, ALACRITTY_APP, APP_BY_ID, AppDef, APPS, ContributionsApp(), createWebsiteApp(), EmbeddedSite() (+33 more) +Cohesion: 0.08 +Nodes (33): Web theme + light/dark (v2.2 rework), react, ALACRITTY_APP, ContributionsApp(), FriendsApp(), GitdxdApp(), NEOFETCH, RevivalApp() (+25 more) ### Community 1 - "Deployment & Ops Docs" -Cohesion: 0.07 -Nodes (37): agents.md Cold-Boot Notes, Custom Dev Server (dev-server.mjs), Header-Stripping Frame Proxy (api/frame), SSRF Host Allowlist (api/ping), ThemeRoot Shell Router, Desktop Icon Grid (useDesktopIcons.ts), Vendored braces CVE Patch, Autostart on Boot (systemd / OpenRC) (+29 more) +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 - "Theme & Clock Components" -Cohesion: 0.10 -Nodes (29): WelcomeApp(), Clock(), getTime(), subscribe(), JokerLogo(), ThemeRoot(), ColorScheme, DEFAULT_SCHEME (+21 more) +### Community 3 - "WindowsDesktop.tsx" +Cohesion: 0.08 +Nodes (34): Conventions & things that will bite you, How UI selection works, APP_BY_ID, AppDef, APPS, createWebsiteApp(), EmbeddedSite(), WebsiteApp() (+26 more) ### Community 4 - "braces Parsing Engine" Cohesion: 0.10 Nodes (17): compile, expand, parse, stringify, compile(), fill, utils, append() (+9 more) ### Community 5 - "Project Index Data" -Cohesion: 0.13 -Nodes (21): HardwareApp(), ProjectsApp(), CodingProjectIndex(), CodingRow(), Group(), HARDWARE_GROUPS, HardwareProjectIndex(), HardwareRow() (+13 more) +Cohesion: 0.14 +Nodes (20): HardwareApp(), ProjectsApp(), CodingProjectIndex(), CodingRow(), Group(), HARDWARE_GROUPS, HardwareProjectIndex(), HardwareRow() (+12 more) ### Community 6 - "braces Character Constants" Cohesion: 0.11 @@ -184,9 +186,9 @@ Nodes (4): dependencies, next, react, react-dom 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 - "Freezmo App Screenshot" -Cohesion: 0.83 -Nodes (4): Freezmo study app, Freezmo App Screenshot (AI-graded quiz screen), Freezmo quiz screen with AI grading feedback, Schuman Plan history question (EU history 1945-1974) +### 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 @@ -208,25 +210,29 @@ Nodes (3): Game Controller Logo Mark, Revival Inc. Favicon (yellow character wit Cohesion: 0.67 Nodes (3): TikTok, TikTok Logo Icon, SVG Repo +### Community 41 - "useColorScheme.ts" +Cohesion: 0.39 +Nodes (7): ColorScheme, DEFAULT_SCHEME, getServerSnapshot(), getSnapshot(), setColorScheme(), subscribe(), useColorScheme() + ## Knowledge Gaps -- **53 isolated node(s):** `react-dom`, `@svgr/webpack`, `@tailwindcss/postcss`, `@types/node`, `@types/react` (+48 more) - These have ≤1 connection - possible missing edges or undocumented components. (Counts symbols only; 212 node(s) total have ≤1 connection when file, concept and rationale nodes are included.) +- **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; 226 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 `react` connect `Desktop App Catalog` to `Root Package Dependencies`, `Theme & Clock Components`, `Project Index Data`, `Next Config & API Routes`?** - _High betweenness centrality (0.109) - this node is a cross-community bridge._ +- **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?** - _53 weakly-connected nodes found - possible documentation gaps or missing edges._ + _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.05584415584415584 - nodes in this community are weakly interconnected._ -- **Why does `next` connect `Next Config & API Routes` to `Desktop App Catalog`, `Root Package Dependencies`, `Custom Dev Server`, `Theme & Clock Components`?** - _High betweenness centrality (0.092) - this node is a cross-community bridge._ + _Cohesion score 0.0797872340425532 - 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.07396870554765292 - nodes in this community are weakly interconnected._ -- **Why does `KDE Plasma Desktop Simulation Shell` connect `Deployment & Ops Docs` to `Desktop App Catalog`?** - _High betweenness centrality (0.054) - this node is a cross-community bridge._ -- **Should `braces Package Metadata` be split into smaller, more focused modules?** - _Cohesion score 0.05263157894736842 - nodes in this community are weakly interconnected._ \ No newline at end of file + _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`, `Custom Dev Server`, `WindowsDesktop.tsx`?** + _High betweenness centrality (0.126) - this node is a cross-community bridge._ \ No newline at end of file diff --git a/graphify-out/graph.html b/graphify-out/graph.html index abf6cee..6d1b787 100644 --- a/graphify-out/graph.html +++ b/graphify-out/graph.html @@ -94,12 +94,12 @@
-