diff --git a/CHANGELOG.md b/CHANGELOG.md index 14fa3e0..7ce19ec 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,16 @@ Format based on [Keep a Changelog](https://keepachangelog.com/); versioning follows [SemVer](https://semver.org/). +## [Unreleased] + +### Added +- **Automatic updates.** New `updates` setting (`notify` by default, `auto`, `off`), a **Check for updates…** tray item and controls in the settings window. TaskGlass checks the latest GitHub release once a day (the only network connection it makes), downloads the installer only from GitHub hosts, verifies its SHA-256 against the release's `SHA256SUMS.txt` and discards it on a mismatch, then runs it silently; the installer closes TaskGlass, updates it and starts the new version. In `notify` mode it asks first, once per version. If security software stops the installer from starting, the verified file is kept and its path is copied to the clipboard. Development builds never update. Details in `docs/configuration.md#updates`. +- **Hidden-icons flyout while a window is maximized or fullscreen.** `surfaces.tray_overflow.maximized` (`{ "enabled": false, "opacity": 85 }`) gives the flyout a second opacity that applies while any monitor has a maximized or fullscreen window, with controls and a preview scenario in both settings windows. Fullscreen windows that are not "maximized" (borderless games and videos) are now detected too, which also makes the taskbar's maximized rule apply to them. +- **Native settings window as a fallback.** If the web settings window cannot be opened (browser blocked, local port unavailable) TaskGlass now opens the native Win32 window from 1.3.0, which needs neither a browser nor a port, with the same options. + +### Fixed +- **The settings window now always gives you a way in.** When security software stops TaskGlass from starting programs (`Access is denied` for Edge or `rundll32`) the window used to just not appear. TaskGlass now tries Edge, then the default browser through the shell, then `rundll32`; logs every failed attempt; and falls back to the native window. If even that fails it copies the settings address to the clipboard and shows a message explaining the cause and the fix. + ## [1.3.1] - 2026-11-20 ### Changed diff --git a/README.es.md b/README.es.md index 9c990b4..5c99d88 100644 --- a/README.es.md +++ b/README.es.md @@ -18,6 +18,7 @@ TaskGlass vuelve la barra de tareas de Windows **totalmente transparente, con de - **Modo claro y oscuro**: los colores `auto`, el icono y el menú de la bandeja siguen a Windows en vivo - **Desplegable de la bandeja translúcido**: el desplegable con los iconos ocultos (el botón `^`) tiene su propia opacidad - **Reglas inteligentes**: un aspecto opcional con una ventana maximizada, o por aplicación (`code.exe`, `chrome.exe`, ...) +- **Actualizaciones automáticas**: consulta GitHub una vez al día e instala la versión nueva tras tu confirmación (o sola, o nunca; tú eliges). Antes se verifica el instalador con la suma de comprobación de la release - **Atajo global** para activar o desactivar el efecto (desactivado por defecto, se activa con un interruptor), e interruptor general - **Multimonitor**: cada barra por separado, o solo la principal - **Por eventos**: reacciona a eventos de ventana en lugar de sondear, cerca de 0 % de CPU en reposo diff --git a/README.md b/README.md index 43fa46c..9d19614 100644 --- a/README.md +++ b/README.md @@ -16,8 +16,9 @@ TaskGlass makes the Windows taskbar **fully transparent, blurred or acrylic**, s - **Clear / Blur / Acrylic / Opaque / Normal** styles, including truly transparent on the Windows 11 XAML taskbar (no grey fill, no border line) - **Light and dark aware**: `auto` colours, the tray icon and its right-click menu follow Windows, live -- **Translucent tray flyout**: the flyout with the hidden icons (the `^` button) gets its own opacity +- **Translucent tray flyout**: the flyout with the hidden icons (the `^` button) gets its own opacity, and a different one while a window is maximized or fullscreen - **Transparent by default, everywhere**: also with a maximized window; an optional look when one is maximized, or per application (`code.exe`, `chrome.exe`, ...) +- **Automatic updates**: checks GitHub once a day and installs a new version after you confirm (or by itself, or never; your choice). The installer is verified against the release checksum first - **Global hotkey** to toggle the effect (off by default, one switch to enable), and a master on/off switch - **Multi-monitor**: every taskbar handled independently, or only the primary one - **Event driven**: reacts to window events instead of polling, about 0 % CPU when idle diff --git a/SECURITY.md b/SECURITY.md index 6209d62..b9036ba 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -6,7 +6,7 @@ Please do **not** open a public issue. Use GitHub's private vulnerability report ## Scope -TaskGlass runs with user privileges, makes no network connections and only touches: its config and log files under the user profile, the `HKCU\...\Run\TaskGlass` registry value (when autostart is enabled), and the appearance of the Explorer taskbar windows. Reports about anything beyond that are welcome. +TaskGlass runs with user privileges, makes a single kind of network connection, to GitHub, to look for and download new releases (once a day; turn it off with `"updates": "off"`, see [Updates](docs/configuration.md#updates)), and only touches: its config and log files under the user profile, the `HKCU\...\Run\TaskGlass` registry value (when autostart is enabled), and the appearance of the Explorer taskbar windows. Reports about anything beyond that are welcome. ## Supported versions diff --git a/cmd/taskglass/resource_windows_amd64.syso b/cmd/taskglass/resource_windows_amd64.syso index 2e8fcff..259944d 100644 Binary files a/cmd/taskglass/resource_windows_amd64.syso and b/cmd/taskglass/resource_windows_amd64.syso differ diff --git a/cmd/taskglass/taskglass.manifest b/cmd/taskglass/taskglass.manifest index 767e48f..32229b1 100644 --- a/cmd/taskglass/taskglass.manifest +++ b/cmd/taskglass/taskglass.manifest @@ -2,6 +2,12 @@ TaskGlass + + + + + + diff --git a/docs/config.schema.json b/docs/config.schema.json index a04ce4d..d094a7b 100644 --- a/docs/config.schema.json +++ b/docs/config.schema.json @@ -51,6 +51,21 @@ }, "opacity": { "$ref": "#/definitions/opacity" + }, + "maximized": { + "type": "object", + "additionalProperties": false, + "description": "Opacity used instead of `opacity` while a window is maximized or fullscreen on any monitor.", + "properties": { + "enabled": { + "type": "boolean", + "default": false + }, + "opacity": { + "$ref": "#/definitions/opacity", + "default": 85 + } + } } } }, @@ -87,6 +102,16 @@ "default": true, "description": "Master switch. When false the stock taskbar is shown." }, + "updates": { + "type": "string", + "enum": [ + "notify", + "auto", + "off" + ], + "default": "notify", + "description": "What to do about new releases. notify: check once a day and ask before installing. auto: install without asking. off: never contact GitHub." + }, "language": { "type": "string", "enum": [ diff --git a/docs/configuration.md b/docs/configuration.md index f2814b2..46555e2 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -41,6 +41,7 @@ Changes made from the tray menu are saved to this same file. | Key | Values | Meaning | |-----|--------|---------| | `enabled` | bool | Master switch. `false` shows the stock taskbar. | +| `updates` | `notify`, `auto`, `off` | `notify` (default) checks GitHub once a day and asks before installing a new version; `auto` installs without asking; `off` never connects. See [Updates](#updates). | | `language` | `auto`, `en`, `es` | Language of the tray menu and settings window. `auto` follows the Windows display language. | | `theme` | `auto`, `light`, `dark` | Which colour mode drives `"auto"` colours, the tray icon and the tray menu (the menu follows the Windows *apps* mode when `auto`). `auto` follows the Windows *system* theme (the one the taskbar uses). | | `taskbars` | `all`, `primary` | Style every monitor's taskbar or only the primary one. | @@ -75,6 +76,14 @@ Opacity values accept decimals (`99.5`) and are rounded to a whole number. Why the DLL: the flyout draws its own XAML background, which the accent effect does not reach, so TaskGlass loads its helper DLL into Explorer to change it, the same way it removes the taskbar's own fill. +`surfaces.tray_overflow.maximized` is a second opacity for the flyout, `{ "enabled": false, "opacity": 85 }`: while a window is maximized or fullscreen (a bright window, a game) on any monitor the flyout uses it instead of `opacity`, for example to keep the panel more solid there. + +## Updates + +With `"updates": "notify"` or `"auto"`, TaskGlass asks GitHub (`api.github.com`) for the latest release once a day, starting a minute and a half after it launches, and from the tray menu (**Check for updates…**) or the settings window. This is the only network connection TaskGlass makes; `"off"` disables it. Development builds never update. + +When you accept (or in `auto` mode) TaskGlass downloads `TaskGlass--Setup.exe` from the release, checks its SHA-256 against the release's `SHA256SUMS.txt`, discards it if it does not match, and runs it silently; the installer closes TaskGlass, replaces it and starts the new version. Downloads and redirects are limited to GitHub hosts. The files are not code-signed, so the checksum protects against corruption and tampering in transit, not against a compromised GitHub account. If security software stops the installer from starting, the verified file stays in `%TEMP%\TaskGlass-update` and its path is copied to the clipboard. + ## Windows setting that overrides the bar Keep *Show accent color on Start and taskbar* (Settings > Personalization > Colors) turned **off**. When it is on, Windows paints the taskbar with the accent color and overrides whatever TaskGlass sets, whatever the rules say. diff --git a/go.mod b/go.mod index 319678c..1430290 100644 --- a/go.mod +++ b/go.mod @@ -4,7 +4,12 @@ go 1.26.7 require ( fyne.io/systray v1.12.2 + github.com/lxn/walk v0.0.0-20210112085537-c389da54e794 + github.com/lxn/win v0.0.0-20210218163916-a377121e959e golang.org/x/sys v0.50.0 ) -require github.com/godbus/dbus/v5 v5.1.0 // indirect +require ( + github.com/godbus/dbus/v5 v5.1.0 // indirect + gopkg.in/Knetic/govaluate.v3 v3.0.0 // indirect +) diff --git a/go.sum b/go.sum index ae0ebec..6b86fb3 100644 --- a/go.sum +++ b/go.sum @@ -2,5 +2,12 @@ fyne.io/systray v1.12.2 h1:Y8DZxgLHsVQt6rY9Zrkkg+j67S7vv/1F2viOWKPpVeA= fyne.io/systray v1.12.2/go.mod h1:RVwqP9nYMo7h5zViCBHri2FgjXF7H2cub7MAq4NSoLs= github.com/godbus/dbus/v5 v5.1.0 h1:4KLkAxT3aOY8Li4FRJe/KvhoNFFxo0m6fNuFUO8QJUk= github.com/godbus/dbus/v5 v5.1.0/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5xrFpKfA= +github.com/lxn/walk v0.0.0-20210112085537-c389da54e794 h1:NVRJ0Uy0SOFcXSKLsS65OmI1sgCCfiDUPj+cwnH7GZw= +github.com/lxn/walk v0.0.0-20210112085537-c389da54e794/go.mod h1:E23UucZGqpuUANJooIbHWCufXvOcT6E7Stq81gU+CSQ= +github.com/lxn/win v0.0.0-20210218163916-a377121e959e h1:H+t6A/QJMbhCSEH5rAuRxh+CtW96g0Or0Fxa9IKr4uc= +github.com/lxn/win v0.0.0-20210218163916-a377121e959e/go.mod h1:KxxjdtRkfNoYDCUP5ryK7XJJNTnpC8atvtmTheChOtk= +golang.org/x/sys v0.0.0-20201018230417-eeed37f84f13/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= golang.org/x/sys v0.50.0 h1:dkKZEFTEKaLr1sjhs0WiKqoi8Jj5nHbS3Njmx1UoMJs= golang.org/x/sys v0.50.0/go.mod h1:hNLxWAXmnKAxqDtdwIYC4bM9oQPEecfsnNMuSxOs3og= +gopkg.in/Knetic/govaluate.v3 v3.0.0 h1:18mUyIt4ZlRlFZAAfVetz4/rzlJs9yhN+U02F4u1AOc= +gopkg.in/Knetic/govaluate.v3 v3.0.0/go.mod h1:csKLBORsPbafmSCGTEh3U7Ozmsuq8ZSIlKk1bcqph0E= diff --git a/graphify-out/.graphify_labels.json b/graphify-out/.graphify_labels.json index fd4d92d..a449351 100644 --- a/graphify-out/.graphify_labels.json +++ b/graphify-out/.graphify_labels.json @@ -2,14 +2,14 @@ "0": "main", "1": "README.md", "2": "winapi_windows.go", - "3": "hotkey_enabled", - "4": "App", + "3": "preview.go", + "4": "Config", "5": "Controller", "6": "tap.c", - "7": "opacity", + "7": "properties", "8": "config.schema.json", "9": "Changelog", - "10": "tray_icon", + "10": "theme", "11": "PULL_REQUEST_TEMPLATE.md", "12": "definitions", "13": "config.go", @@ -38,18 +38,28 @@ "36": "items", "37": "Configuration", "38": "Contributing", - "39": "Security Policy", + "39": "configuration.md", "40": "default", - "41": "fakeHost", + "41": "window", "42": "enabled", - "43": "hotkey", + "43": "Client", "44": "enum", - "45": "theme", + "45": "App", "46": "Server", - "47": "exe", + "47": ".InstallUpdate", "48": "autostart_windows.go", - "49": "xaml_fix", + "49": "New", "50": "language", - "51": "main.go", - "52": "locale_other.go" + "51": "host", + "52": "locale_other.go", + "53": "Lang", + "54": "fakeHost", + "55": "updates", + "56": "menuItems", + "57": "opacity", + "58": "tray_icon", + "59": "xaml_fix", + "60": "SystemIsLight", + "61": "window", + "62": "updates_windows.go" } diff --git a/graphify-out/.graphify_labels.json.sig b/graphify-out/.graphify_labels.json.sig index 5823665..6d21c03 100644 --- a/graphify-out/.graphify_labels.json.sig +++ b/graphify-out/.graphify_labels.json.sig @@ -1 +1 @@ -{"0": "5076d5ac64ef5c4a", "1": "b64346c57c2f1370", "2": "3e72afd85194fc6d", "3": "01646dff01d2eb7e", "4": "b366977a781f3394", "5": "347b8ad08160da2d", "6": "5f1178d3b76d5916", "7": "c3edf3c38080d85c", "8": "7c8d94ab6376b921", "9": "7e5fd0bf5677dec6", "10": "952491af3b1e9f78", "11": "e0f13635f45c650b", "12": "690ee408139029c9", "13": "17570957673a4fdd", "14": "6c7a71fed0eb24b5", "15": "ec76c5b024eab860", "16": "37bcee490d34fb1d", "17": "5c97800323607746", "18": "136e8401d4dcd739", "19": "5dbe09da18834400", "20": "b8b416d32d64abd5", "21": "6e7b82d0387bf16d", "22": "a0e1e2546c3370b0", "23": "a309b6ae1fe8f288", "24": "420dd9e70a20e9ac", "25": "c36fef69ae3bd6c5", "26": "e9dfc248ad6fcedc", "27": "b8e36120f4e5b47a", "28": "029966ca5faa5a2a", "29": "2f07b244a1b1bebb", "30": "4cbef3533d917f67", "31": "39e69bcdefe2b0d2", "32": "804482094d693c22", "33": "077458ac008cc4d9", "34": "77bc2d977d7ff4cd", "35": "13af2a57728b14e4", "36": "bb6ec3da677724b3", "37": "4c1831b02af7bd53", "38": "268b36fafa333572", "39": "89111ec01d66aeef", "40": "a6d5a524b6f14c57", "41": "70a729a8c2ed65e6", "42": "629a30dc96674e1a", "43": "4249983e8612bb1d", "44": "0baabc23a0122bf6", "45": "568df988db03bae3", "46": "ed151e4065cb4366", "47": "ab47fb02a9b2717a", "48": "a5b30f9d71bf9f82", "49": "43b67b0ff2e57329", "50": "58627c65df2a80a1", "51": "9346c9771bed4f8d", "52": "7984419eb8b2f465"} \ No newline at end of file +{"0": "63ff666f0045b814", "1": "b64346c57c2f1370", "2": "891911b5d4c662ef", "3": "f920c17e32bfb614", "4": "ee10bd375302d9ce", "5": "ce7ea8e3d289539e", "6": "5f1178d3b76d5916", "7": "99be281d3a6c2143", "8": "7c8d94ab6376b921", "9": "d552d2e7bf6d92ce", "10": "43dd470eba70e8b2", "11": "e0f13635f45c650b", "12": "a09e6da3720ce72b", "13": "8b69e3799805c898", "14": "6c7a71fed0eb24b5", "15": "ec76c5b024eab860", "16": "37bcee490d34fb1d", "17": "5c97800323607746", "18": "d72e5efdb26cb46d", "19": "5dbe09da18834400", "20": "b8b416d32d64abd5", "21": "6e7b82d0387bf16d", "22": "a0e1e2546c3370b0", "23": "a309b6ae1fe8f288", "24": "420dd9e70a20e9ac", "25": "c36fef69ae3bd6c5", "26": "e9dfc248ad6fcedc", "27": "b8e36120f4e5b47a", "28": "27fdcfc551c8500c", "29": "97f96f3f6912c7f7", "30": "4cbef3533d917f67", "31": "39e69bcdefe2b0d2", "32": "804482094d693c22", "33": "077458ac008cc4d9", "34": "77bc2d977d7ff4cd", "35": "13af2a57728b14e4", "36": "bb6ec3da677724b3", "37": "f54f507de5bdfba8", "38": "268b36fafa333572", "39": "5eba8f57deedf6ec", "40": "29f3f7a05bc038a9", "41": "097cc4b62d3bb1e6", "42": "d3eee2f86449bcfe", "43": "568cf10a7a394a1d", "44": "0baabc23a0122bf6", "45": "76d4b50771f7c41f", "46": "8276df5627f89e38", "47": "deb00a690dbb7995", "48": "a5b30f9d71bf9f82", "49": "608b79cdc2b0f5f6", "50": "58627c65df2a80a1", "51": "8634880fbcf3da70", "52": "7984419eb8b2f465", "53": "fef42b3791505753", "54": "a54fe58c4569f20d", "55": "8a1ce2c24fb93d9a", "56": "728938a96b47fc0c", "57": "029966ca5faa5a2a", "58": "d041a87ea2070ac4", "59": "43b67b0ff2e57329", "60": "05137dc294bceec1", "61": "ea415e833c241158", "62": "54793cdda1865d1d"} \ No newline at end of file diff --git a/graphify-out/GRAPH_REPORT.md b/graphify-out/GRAPH_REPORT.md index a75200b..9cd457a 100644 --- a/graphify-out/GRAPH_REPORT.md +++ b/graphify-out/GRAPH_REPORT.md @@ -1,16 +1,16 @@ # Graph Report - TaskGlass (2026-11-20) ## Corpus Check -- 50 files · ~98,812 words +- 59 files · ~109,426 words - Verdict: corpus is large enough that graph structure adds value. ## Summary -- 622 nodes · 1081 edges · 53 communities (47 shown, 6 thin omitted) -- Extraction: 92% EXTRACTED · 8% INFERRED · 0% AMBIGUOUS · INFERRED: 91 edges (avg confidence: 0.8) +- 812 nodes · 1582 edges · 63 communities (54 shown, 9 thin omitted) +- Extraction: 91% EXTRACTED · 9% INFERRED · 0% AMBIGUOUS · INFERRED: 149 edges (avg confidence: 0.8) - Token cost: 0 input · 0 output ## Graph Freshness -- Built from commit: `cc5eb08c` +- Built from commit: `fdcc0463` - Run `git rev-parse HEAD` and compare to check if the graph is stale. - Run `graphify update .` after code changes (no API cost). @@ -18,14 +18,14 @@ - main - README.md - winapi_windows.go -- hotkey_enabled -- App +- preview.go +- Config - Controller - tap.c -- opacity +- properties - config.schema.json - Changelog -- tray_icon +- theme - PULL_REQUEST_TEMPLATE.md - definitions - config.go @@ -48,31 +48,40 @@ - items - Configuration - Contributing -- Security Policy +- configuration.md - default -- fakeHost +- window - enabled -- hotkey +- Client - enum -- theme +- App - Server -- exe +- .InstallUpdate - autostart_windows.go -- xaml_fix +- New - language -- main.go +- host +- Lang +- fakeHost +- updates +- menuItems +- opacity +- tray_icon +- xaml_fix +- SystemIsLight +- window ## God Nodes (most connected - your core abstractions) -1. `T()` - 40 edges -2. `App` - 38 edges -3. `Config` - 35 edges -4. `Controller` - 21 edges -5. `Default()` - 20 edges -6. `Parse()` - 18 edges -7. `Server` - 17 edges -8. `main()` - 13 edges -9. `logf_()` - 12 edges -10. `host` - 11 edges +1. `T()` - 54 edges +2. `App` - 42 edges +3. `Config` - 40 edges +4. `window` - 35 edges +5. `Default()` - 24 edges +6. `Controller` - 21 edges +7. `Parse()` - 20 edges +8. `Server` - 20 edges +9. `Render()` - 18 edges +10. `Appearance` - 15 edges ## Surprising Connections (you probably didn't know these) - `main()` --calls--> `Default()` [INFERRED] @@ -83,69 +92,65 @@ cmd/taskglass/main_windows.go → internal/config/config.go - `main()` --calls--> `Save()` [INFERRED] cmd/taskglass/main_windows.go → internal/config/config.go -- `main()` --calls--> `Parse()` [INFERRED] - tools/genicon/main.go → internal/config/config.go +- `watchForQuit()` --calls--> `Notify()` [INFERRED] + cmd/taskglass/main_windows.go → internal/settings/window_windows.go ## Import Cycles - None detected. -## Communities (53 total, 6 thin omitted) +## Communities (63 total, 9 thin omitted) ### Community 0 - "main" -Cohesion: 0.26 -Nodes (10): attachConsole(), fatal(), Logger, main(), newLogger(), signalEvent(), signalQuit(), versionString() (+2 more) +Cohesion: 0.24 +Nodes (11): App, attachConsole(), fatal(), Logger, main(), newLogger(), signalEvent(), signalQuit() (+3 more) ### Community 1 - "README.md" Cohesion: 0.18 Nodes (10): Before you start, Contributing, Features, How it works, Install, License, Limitations and safety, Roadmap (+2 more) ### Community 2 - "winapi_windows.go" -Cohesion: 0.11 -Nodes (30): blurPolicy(), TestToPolicy(), HWND, Logger, Time, lighten(), New(), toPolicy() (+22 more) - -### Community 3 - "hotkey_enabled" -Cohesion: 0.50 -Nodes (4): default, description, type, hotkey_enabled +Cohesion: 0.10 +Nodes (33): blurPolicy(), TestToPolicy(), HWND, Logger, Time, lighten(), New(), toPolicy() (+25 more) -### Community 4 - "App" -Cohesion: 0.06 -Nodes (27): App, host, Options, panicGuard, Config, Int32, check(), Bool (+19 more) +### Community 3 - "preview.go" +Cohesion: 0.19 +Nodes (30): at(), blur(), boxH(), boxV(), clamp8(), Color(), drawFlyout(), drawTaskbarContents() (+22 more) ### Community 5 - "Controller" Cohesion: 0.06 -Nodes (29): Attr, Handler, GUID, Duration, TaskbarAnchor(), Duration, TrayProbe(), Handle (+21 more) +Nodes (30): Attr, Handler, GUID, Duration, TaskbarAnchor(), Duration, TrayProbe(), Handle (+22 more) ### Community 6 - "tap.c" Cohesion: 0.07 Nodes (72): DWORD, HINSTANCE, HRESULT, HSTRING, IClassFactory, IDispatchedHandler_, Inst, InstanceHandle (+64 more) -### Community 7 - "opacity" -Cohesion: 0.25 -Nodes (11): $ref, properties, type, $ref, properties, appearance, properties, $ref (+3 more) +### Community 7 - "properties" +Cohesion: 0.20 +Nodes (11): $ref, properties, $ref, description, minLength, pattern, type, properties (+3 more) ### Community 8 - "config.schema.json" Cohesion: 0.29 Nodes (6): additionalProperties, description, $id, $schema, title, type ### Community 9 - "Changelog" -Cohesion: 0.08 -Nodes (23): [1.0.0] - 2026-11-17, [1.0.1] - 2026-11-17, [1.1.0] - 2026-11-18, [1.1.1] - 2026-11-18, [1.2.0] - 2026-11-20, [1.2.1] - 2026-11-20, [1.3.0] - 2026-11-20, Added (+15 more) +Cohesion: 0.07 +Nodes (29): [1.0.0] - 2026-11-17, [1.0.1] - 2026-11-17, [1.1.0] - 2026-11-18, [1.1.1] - 2026-11-18, [1.2.0] - 2026-11-20, [1.2.1] - 2026-11-20, [1.3.0] - 2026-11-20, [1.3.1] - 2026-11-20 (+21 more) -### Community 10 - "tray_icon" +### Community 10 - "theme" Cohesion: 0.24 -Nodes (10): tray_icon, enum, default, description, enum, type, auto, color (+2 more) +Nodes (10): theme, default, description, enum, type, enum, auto, color (+2 more) ### Community 12 - "definitions" -Cohesion: 0.22 -Nodes (9): description, pattern, type, definitions, color, surface, additionalProperties, properties (+1 more) +Cohesion: 0.29 +Nodes (7): type, description, pattern, type, definitions, appearance, color ### Community 13 - "config.go" -Cohesion: 0.12 -Nodes (14): menuItems, Accent, Appearance, AppRule, Percent, Rule, Surface, Surfaces (+6 more) +Cohesion: 0.13 +Nodes (13): Accent, Appearance, AppRule, Percent, Rule, Surface, SurfaceMaximized, Surfaces (+5 more) ### Community 18 - "properties" -Cohesion: 0.22 -Nodes (9): description, $ref, properties, maximized, $schema, version, type, const (+1 more) +Cohesion: 0.14 +Nodes (14): default, description, default, description, type, type, properties, hotkey (+6 more) ### Community 19 - "Watcher" Cohesion: 0.33 @@ -176,12 +181,12 @@ Cohesion: 0.25 Nodes (8): surfaces, tray_overflow, additionalProperties, description, properties, type, description, $ref ### Community 28 - "opacity" -Cohesion: 0.40 -Nodes (5): opacity, description, maximum, minimum, type +Cohesion: 0.29 +Nodes (7): rule, default, $ref, opacity, additionalProperties, properties, type ### Community 29 - "T" -Cohesion: 0.08 -Nodes (48): Lang, Default(), Load(), Parse(), ParseHotkey(), Save(), TestAppRuleMatching(), TestAutoColorFollowsTheme() (+40 more) +Cohesion: 0.09 +Nodes (47): entry, Default(), Load(), Parse(), ParseHotkey(), Save(), TestAppRuleMatching(), TestAutoColorFollowsTheme() (+39 more) ### Community 30 - "Architecture" Cohesion: 0.18 @@ -197,79 +202,107 @@ Nodes (9): description, items, maxItems, type, additionalProperties, required, t ### Community 37 - "Configuration" Cohesion: 0.22 -Nodes (8): Appearance, Command line, Configuration, Light and dark mode, Options, Tray flyout, Which rule wins, Windows setting that overrides the bar +Nodes (9): Appearance, Command line, Configuration, Light and dark mode, Options, Tray flyout, Updates, Which rule wins (+1 more) ### Community 38 - "Contributing" Cohesion: 0.40 Nodes (4): Branching, Contributing, Development, Knowledge graph (optional) -### Community 39 - "Security Policy" -Cohesion: 0.40 +### Community 39 - "configuration.md" +Cohesion: 0.33 Nodes (4): Reporting a vulnerability, Scope, Security Policy, Supported versions ### Community 40 - "default" -Cohesion: 0.50 -Nodes (4): additionalProperties, description, type, default +Cohesion: 0.40 +Nodes (5): additionalProperties, description, properties, type, default + +### Community 41 - "window" +Cohesion: 0.06 +Nodes (42): Bitmap, CheckBox, ComboBox, Composite, ImageView, SystemLocale(), systemLocale(), Container (+34 more) ### Community 42 - "enabled" -Cohesion: 0.25 -Nodes (8): rule, default, description, type, enabled, additionalProperties, properties, type +Cohesion: 0.15 +Nodes (14): surface, default, description, type, additionalProperties, description, properties, $ref (+6 more) -### Community 43 - "hotkey" -Cohesion: 0.50 -Nodes (4): default, description, type, hotkey +### Community 43 - "Client" +Cohesion: 0.17 +Nodes (17): updater, Mutex, githubOnly(), New(), Newer(), parseSums(), parseVersion(), fake() (+9 more) ### Community 44 - "enum" Cohesion: 0.22 Nodes (9): description, enum, type, accent, acrylic, blur, clear, normal (+1 more) -### Community 45 - "theme" -Cohesion: 0.50 -Nodes (4): theme, default, description, type +### Community 45 - "App" +Cohesion: 0.14 +Nodes (8): Int32, App, Bool, CancelFunc, Once, ApplyMenuTheme(), RWMutex, Value ### Community 46 - "Server" Cohesion: 0.19 -Nodes (13): HandlerFunc, favicon(), Handler, loopbackHost(), New(), writeErr(), writeJSON(), Listener (+5 more) +Nodes (12): HandlerFunc, favicon(), Handler, Mutex, loopbackHost(), writeErr(), writeJSON(), Listener (+4 more) -### Community 47 - "exe" -Cohesion: 0.40 -Nodes (5): description, minLength, pattern, type, exe +### Community 47 - ".InstallUpdate" +Cohesion: 0.23 +Nodes (7): App, Ask(), CopyToClipboard(), edgePath(), Notify(), Show(), RunInstaller() ### Community 48 - "autostart_windows.go" Cohesion: 0.38 Nodes (8): clearDisabled(), command(), Enabled(), Repair(), sameCommand(), Set(), TestCommandIsPlainQuotedPath(), TestSameCommandRecognisesLegacyDoubledBackslashes() -### Community 49 - "xaml_fix" -Cohesion: 0.50 -Nodes (4): xaml_fix, default, description, type +### Community 49 - "New" +Cohesion: 0.22 +Nodes (9): Options, panicGuard, Duration, Logger, Time, New(), newPanicGuard(), TestPanicGuardAllowsBurstsUpToMax() (+1 more) ### Community 50 - "language" Cohesion: 0.29 Nodes (7): default, description, enum, type, language, en, es -### Community 51 - "main.go" +### Community 53 - "Lang" +Cohesion: 0.25 +Nodes (8): Lang, Keys(), Resolve(), Table(), TestEveryKeyIsTranslated(), TestFallback(), TestResolve(), stateResp + +### Community 55 - "updates" +Cohesion: 0.29 +Nodes (7): updates, default, description, enum, type, notify, off + +### Community 56 - "menuItems" +Cohesion: 0.40 +Nodes (3): menuItems, Theme, MenuItem + +### Community 57 - "opacity" +Cohesion: 0.40 +Nodes (5): opacity, description, maximum, minimum, type + +### Community 58 - "tray_icon" +Cohesion: 0.50 +Nodes (4): tray_icon, default, description, type + +### Community 59 - "xaml_fix" +Cohesion: 0.50 +Nodes (4): xaml_fix, default, description, type + +### Community 60 - "SystemIsLight" Cohesion: 0.83 -Nodes (3): entry, main(), writeICO() +Nodes (3): AppsAreLight(), readBool(), SystemIsLight() ## Knowledge Gaps -- **165 isolated node(s):** `$schema`, `$id`, `title`, `description`, `type` (+160 more) +- **178 isolated node(s):** `$schema`, `$id`, `title`, `description`, `type` (+173 more) These have ≤1 connection - possible missing edges or undocumented components. -- **6 thin communities (<3 nodes) omitted from report** — run `graphify query` to explore isolated nodes. +- **9 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 `App` connect `App` to `main`, `winapi_windows.go`, `Controller`, `config.go`, `Server`, `Watcher`?** - _High betweenness centrality (0.094) - this node is a cross-community bridge._ -- **Why does `Config` connect `App` to `winapi_windows.go`, `fakeHost`, `config.go`, `Server`, `T`?** - _High betweenness centrality (0.073) - this node is a cross-community bridge._ -- **Why does `properties` connect `properties` to `hotkey_enabled`, `items`, `config.schema.json`, `default`, `enabled`, `hotkey`, `tray_icon`, `theme`, `xaml_fix`, `language`, `enum`, `taskbars`, `debounce_ms`, `poll_ms`, `refresh_ms`, `surfaces`?** - _High betweenness centrality (0.048) - this node is a cross-community bridge._ -- **Are the 16 inferred relationships involving `Default()` (e.g. with `main()` and `TestDefaultIsValid()`) actually correct?** - _`Default()` has 16 INFERRED edges - model-reasoned connections that need verification._ +- **Why does `Config` connect `Config` to `winapi_windows.go`, `window`, `config.go`, `App`, `Server`, `New`, `host`, `Lang`, `fakeHost`, `menuItems`, `T`?** + _High betweenness centrality (0.096) - this node is a cross-community bridge._ +- **Why does `App` connect `App` to `winapi_windows.go`, `Config`, `Controller`, `window`, `Client`, `Server`, `New`, `host`, `Watcher`, `menuItems`?** + _High betweenness centrality (0.096) - this node is a cross-community bridge._ +- **Why does `T()` connect `T` to `winapi_windows.go`, `preview.go`, `Config`, `Controller`, `window`, `Client`, `App`, `autostart_windows.go`, `New`, `Lang`?** + _High betweenness centrality (0.064) - this node is a cross-community bridge._ +- **Are the 3 inferred relationships involving `T()` (e.g. with `.syncMenu()` and `.tr()`) actually correct?** + _`T()` has 3 INFERRED edges - model-reasoned connections that need verification._ +- **Are the 20 inferred relationships involving `Default()` (e.g. with `main()` and `TestDefaultIsValid()`) actually correct?** + _`Default()` has 20 INFERRED edges - model-reasoned connections that need verification._ - **What connects `$schema`, `$id`, `title` to the rest of the system?** - _165 weakly-connected nodes found - possible documentation gaps or missing edges._ + _178 weakly-connected nodes found - possible documentation gaps or missing edges._ - **Should `winapi_windows.go` be split into smaller, more focused modules?** - _Cohesion score 0.10810810810810811 - nodes in this community are weakly interconnected._ -- **Should `App` be split into smaller, more focused modules?** - _Cohesion score 0.06448412698412699 - nodes in this community are weakly interconnected._ \ No newline at end of file + _Cohesion score 0.0975609756097561 - nodes in this community are weakly interconnected._ \ No newline at end of file diff --git a/graphify-out/graph.html b/graphify-out/graph.html index aa45d30..b051820 100644 --- a/graphify-out/graph.html +++ b/graphify-out/graph.html @@ -63,12 +63,12 @@

Communities

-
622 nodes · 1081 edges · 53 communities
+
812 nodes · 1582 edges · 63 communities