refactor(reports): reduce subsection heading levels to H4

castrojo · castrojo · commit 1f784da5ef2d · 2026-01-29T17:30:06.000-05:00
Change 'Planned Work' and 'Opportunistic Work' from H3 (###) to H4 (####)
to prevent them from appearing in the right sidebar TOC. This reduces
TOC clutter and improves navigation UX by keeping only main section
headers (Desktop, Development, etc.) in the sidebar.

Assisted-by: Claude Sonnet 4.5 via GitHub Copilot
diff --git a/reports/2026-01-31-report.mdx b/reports/2026-01-31-report.mdx
@@ -13,7 +13,7 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 | | |
 |--------|-------|
 | **Total Items** | 144 (36 planned, 108 opportunistic) |
-| **Automation** | 63.0% (245 bot PRs out of 389 total PRs) |
+| **Automation** | 63.1% (246 bot PRs out of 390 total PRs) |
 | **Contributors** | 23 total, 10 new |
 
 
@@ -23,7 +23,7 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 
 *GNOME desktop environment, Aurora variant (KDE), and terminal enhancements*
 
-### Planned Work
+#### Planned Work
 
 - feat: Add org.gnome.SoundRecorder to system-flatpaks by [@​LorbusChris](https://github.com/LorbusChris) in [#183](https://github.com/projectbluefin/common/pull/183)
 - fix(mise): Auto install and activate mise unless told otherwise by [@​rwaltr](https://github.com/rwaltr) in [#161](https://github.com/projectbluefin/common/pull/161)
@@ -33,7 +33,7 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 - fix: #3919 add no-op for appimage files by [@​sebjag](https://github.com/sebjag) in [#109](https://github.com/projectbluefin/common/pull/109)
 - feat: add everything from bluefin-schemas and bluefin(lts) by [@​renner0e](https://github.com/renner0e) in [#101](https://github.com/projectbluefin/common/pull/101)
 
-### Opportunistic Work
+#### Opportunistic Work
 
 - fix: remove minor workaround that broke "Forged On" by [@​tulilirockz](https://github.com/tulilirockz) in [#971](https://github.com/ublue-os/bluefin-lts/pull/971)
 - feat: update GNOME Foundry to 1.0.1 by [@​KiKaraage](https://github.com/KiKaraage) in [#101](https://github.com/ublue-os/homebrew-experimental-tap/pull/101)
@@ -48,11 +48,11 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 
 *Development tools and IDE integrations*
 
-### Planned Work
+#### Planned Work
 
 - fix(bluefin,dx): remove ssh askpass configuration by [@​tulilirockz](https://github.com/tulilirockz) in [#118](https://github.com/projectbluefin/common/pull/118)
 
-### Opportunistic Work
+#### Opportunistic Work
 
 - fix: switch GDX to HWE kernel by [@​hanthor](https://github.com/hanthor) in [#1007](https://github.com/ublue-os/bluefin-lts/pull/1007)
 - chore: remove a few unnecessary steps on build by [@​tulilirockz](https://github.com/tulilirockz) in [#991](https://github.com/ublue-os/bluefin-lts/pull/991)
@@ -84,7 +84,7 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 | lm-studio-linux | 0.4.0 → 0.3.39 (4 updates) | [#225](https://github.com/ublue-os/homebrew-tap/pull/225) |
 | antigravity-linux | 1.14.2 → 1.15.8 (3 updates) | [#201](https://github.com/ublue-os/homebrew-tap/pull/201) |
 | visual-studio-code-linux | 1.108.0 → 1.108.2 (3 updates) | [#197](https://github.com/ublue-os/homebrew-tap/pull/197) |
-| pmbootstrap | 3.8.0 → 3.9.0 (2 updates) | [#200](https://github.com/ublue-os/homebrew-tap/pull/200) |
+| pmbootstrap | 3.9.0 → 3.8.0 (2 updates) | [#214](https://github.com/ublue-os/homebrew-tap/pull/214) |
 | framework-tool | 0.5.0 | [#212](https://github.com/ublue-os/homebrew-tap/pull/212) |
 | linux-mcp-server | 1.2.1 | [#222](https://github.com/ublue-os/homebrew-tap/pull/222) |
 | vscodium-linux | 1.108.10359 | [#203](https://github.com/ublue-os/homebrew-tap/pull/203) |
@@ -119,7 +119,7 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 
 *Homebrew packages, AI/ML tools (Bluespeed), and Flatpak applications*
 
-### Planned Work
+#### Planned Work
 
 - feat: add Multiplication Puzzle to Education curation for Bazaar by [@​KiKaraage](https://github.com/KiKaraage) in [#96](https://github.com/projectbluefin/common/pull/96)
 - feat: add Whis to "AI & Machine Learning" Bazaar curation by [@​KiKaraage](https://github.com/KiKaraage) in [#178](https://github.com/projectbluefin/common/pull/178)
@@ -131,7 +131,7 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 - feat(ai): add goose-linux gui by [@​castrojo](https://github.com/castrojo) in [#107](https://github.com/projectbluefin/common/pull/107)
 - feat: add Jan flatpak to ai-tools Brewfile by [@​coxde](https://github.com/coxde) in [#98](https://github.com/projectbluefin/common/pull/98)
 
-### Opportunistic Work
+#### Opportunistic Work
 
 - chore: remove references to brew timer by [@​tulilirockz](https://github.com/tulilirockz) in [#3988](https://github.com/ublue-os/bluefin/pull/3988)
 - chore(flatpak, iso): remove all flatpak-related things from here by [@​tulilirockz](https://github.com/tulilirockz) in [#960](https://github.com/ublue-os/bluefin-lts/pull/960)
@@ -152,11 +152,11 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 
 *Systemd services and system-level policies*
 
-### Planned Work
+#### Planned Work
 
 - fix(shared, uupd): enable uupd on a preset by default by [@​tulilirockz](https://github.com/tulilirockz) in [#115](https://github.com/projectbluefin/common/pull/115)
 
-### Opportunistic Work
+#### Opportunistic Work
 
 - fix: Disable old rpm-ostreed-automatic.timer by [@​inffy](https://github.com/inffy) in [#3969](https://github.com/ublue-os/bluefin/pull/3969)
 - fix: leftover file in /boot for real by [@​renner0e](https://github.com/renner0e) in [#3986](https://github.com/ublue-os/bluefin/pull/3986)
@@ -172,11 +172,11 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 
 *Hardware support, drivers, NVIDIA GPU, and ARM64 architecture*
 
-### Planned Work
+#### Planned Work
 
 > Status: _ChillOps_
 
-### Opportunistic Work
+#### Opportunistic Work
 
 - fix(nvidia): override gschemas on nvidia using sed since we already have these on common now by [@​tulilirockz](https://github.com/tulilirockz) in [#3984](https://github.com/ublue-os/bluefin/pull/3984)
 - fix: include pcsc-lite for passkey support on initramfs by [@​tulilirockz](https://github.com/tulilirockz) in [#1045](https://github.com/ublue-os/bluefin-lts/pull/1045)
@@ -190,7 +190,7 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 
 *ISO images, upstream integration, build systems, and testing frameworks*
 
-### Planned Work
+#### Planned Work
 
 - fix(rebase-helper): handle bluefin LTS + HWE + GDX + everything possible by [@​tulilirockz](https://github.com/tulilirockz) in [#162](https://github.com/projectbluefin/common/pull/162)
 - fix(bluefin, rebase-helper): re-enable rebase helper for bluefin LTS by [@​tulilirockz](https://github.com/tulilirockz) in [#170](https://github.com/projectbluefin/common/pull/170)
@@ -202,7 +202,7 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 - fix: make grep quiet on a few places by [@​tulilirockz](https://github.com/tulilirockz) in [#108](https://github.com/projectbluefin/common/pull/108)
 - chore: consolidate ujust update with aurora and split changelog + minor fixes by [@​tulilirockz](https://github.com/tulilirockz) in [#106](https://github.com/projectbluefin/common/pull/106)
 
-### Opportunistic Work
+#### Opportunistic Work
 
 - feat: add upstream xdg-terminal-exec by [@​tulilirockz](https://github.com/tulilirockz) in [#4114](https://github.com/ublue-os/bluefin/pull/4114)
 - fix: do not remove fedora-logos by [@​tulilirockz](https://github.com/tulilirockz) in [#4072](https://github.com/ublue-os/bluefin/pull/4072)
@@ -241,12 +241,12 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 
 *Documentation improvements and additions*
 
-### Planned Work
+#### Planned Work
 
 - docs: update label colors and document directory structure by [@​castrojo](https://github.com/castrojo) in [#147](https://github.com/projectbluefin/common/pull/147)
 - fix: reduce hallucination on ghcr.io path by [@​KiKaraage](https://github.com/KiKaraage) in [#111](https://github.com/projectbluefin/common/pull/111)
 
-### Opportunistic Work
+#### Opportunistic Work
 
 - docs: add git workflow rules and labeling helper scripts by [@​castrojo](https://github.com/castrojo) in [#584](https://github.com/projectbluefin/documentation/pull/584)
 - Improve label categorization in monthly reports by [@​castrojo](https://github.com/castrojo) in [#599](https://github.com/projectbluefin/documentation/pull/599)
@@ -269,12 +269,12 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 
 *Maintenance work and feature parity between variants*
 
-### Planned Work
+#### Planned Work
 
 - chore(rollback-helper): disable debugging tag by [@​tulilirockz](https://github.com/tulilirockz) in [#193](https://github.com/projectbluefin/common/pull/193)
 - chore: remove xdg-terminal-exec hack script by [@​tulilirockz](https://github.com/tulilirockz) in [#191](https://github.com/projectbluefin/common/pull/191)
 
-### Opportunistic Work
+#### Opportunistic Work
 
 - fix: cleanup /\{boot,tmp\} by [@​renner0e](https://github.com/renner0e) in [#3922](https://github.com/ublue-os/bluefin/pull/3922)
 - chore: move `ublue-privileged-setup` references to `/usr/bin` instead of `/usr/libexec` by [@​tulilirockz](https://github.com/tulilirockz) in [#3846](https://github.com/ublue-os/bluefin/pull/3846)
@@ -296,13 +296,13 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 
 *CI/CD pipelines, GitHub Actions, and automated dependency updates*
 
-### Planned Work
+#### Planned Work
 
 - feat: add weekly status report automation by [@​castrojo](https://github.com/castrojo) in [#187](https://github.com/projectbluefin/common/pull/187)
 - revert: remove weekly status report automation by [@​castrojo](https://github.com/castrojo) in [#190](https://github.com/projectbluefin/common/pull/190)
 - ci: skip container builds for documentation changes by [@​castrojo](https://github.com/castrojo) in [#148](https://github.com/projectbluefin/common/pull/148)
 
-### Opportunistic Work
+#### Opportunistic Work
 
 - chore(ci): enable SBOMs by [@​renner0e](https://github.com/renner0e) in [#4044](https://github.com/ublue-os/bluefin/pull/4044)
 - ci: add permissions to workflows + DEFAULT_TAG needs to change on `manifest` job by [@​tulilirockz](https://github.com/tulilirockz) in [#980](https://github.com/ublue-os/bluefin-lts/pull/980)
@@ -336,12 +336,12 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 
 *Translation and internationalization work*
 
-### Planned Work
+#### Planned Work
 
 - feat: adds french translation to the desktop files by [@​theMimolet](https://github.com/theMimolet) in [#143](https://github.com/projectbluefin/common/pull/143)
 - chore(translation): Add Polish translation to curated.yaml by [@​Micro856](https://github.com/Micro856) in [#175](https://github.com/projectbluefin/common/pull/175)
 
-### Opportunistic Work
+#### Opportunistic Work
 
 > Status: _ChillOps_
 
@@ -359,13 +359,13 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 
 ## Bot Activity
 
-**Automation Percentage:** 63.0% (245 bot PRs out of 389 total PRs)
+**Automation Percentage:** 63.1% (246 bot PRs out of 390 total PRs)
 
 | Repository | Bot PRs | % of Total |
 |------------|---------|------------|
 | bluefin | 88 | 22.6% |
-| bluefin-lts | 71 | 18.3% |
-| documentation | 9 | 2.3% |
+| bluefin-lts | 71 | 18.2% |
+| documentation | 10 | 2.6% |
 | iso | 7 | 1.8% |
 | common | 1 | 0.3% |
 
@@ -532,6 +532,7 @@ import GitHubProfileCard from '@site/src/components/GitHubProfileCard';
 - [pull] lts from main by [@​testpullapp](https://github.com/testpullapp) in [ublue-os/bluefin-lts#983](https://github.com/ublue-os/bluefin-lts/pull/983)
 - [pull] lts from main by [@​testpullapp](https://github.com/testpullapp) in [ublue-os/bluefin-lts#977](https://github.com/ublue-os/bluefin-lts/pull/977)
 - chore: align renovate config with ublue-os/bluefin by [@​copilot-swe-agent](https://github.com/copilot-swe-agent) in [ublue-os/bluefin-lts#951](https://github.com/ublue-os/bluefin-lts/pull/951)
+- docs(reports): Monthly report for January 2026 by [@​github-actions](https://github.com/github-actions) in [projectbluefin/documentation#608](https://github.com/projectbluefin/documentation/pull/608)
 - docs(reports): Monthly report for January 2026 by [@​github-actions](https://github.com/github-actions) in [projectbluefin/documentation#598](https://github.com/projectbluefin/documentation/pull/598)
 - docs(reports): Monthly report for January 2026 by [@​github-actions](https://github.com/github-actions) in [projectbluefin/documentation#591](https://github.com/projectbluefin/documentation/pull/591)
 - docs: update driver versions by [@​github-actions](https://github.com/github-actions) in [projectbluefin/documentation#578](https://github.com/projectbluefin/documentation/pull/578)
diff --git a/scripts/lib/markdown-generator.mjs b/scripts/lib/markdown-generator.mjs
@@ -325,19 +325,19 @@ export function generateCategorySectionWithSubsections(
   // Planned Work subsection (always show, with ChillOps if empty)
   if (planned.length > 0) {
     sections.push(
-      `### Planned Work\n\n${formatItemList(planned, displayedUrls)}`,
+      `#### Planned Work\n\n${formatItemList(planned, displayedUrls)}`,
     );
   } else {
-    sections.push(`### Planned Work\n\n> Status: _ChillOps_`);
+    sections.push(`#### Planned Work\n\n> Status: _ChillOps_`);
   }
 
   // Opportunistic Work subsection (always show, with ChillOps if empty)
   if (opportunistic.length > 0) {
     sections.push(
-      `### Opportunistic Work\n\n${formatItemList(opportunistic, displayedUrls)}`,
+      `#### Opportunistic Work\n\n${formatItemList(opportunistic, displayedUrls)}`,
     );
   } else {
-    sections.push(`### Opportunistic Work\n\n> Status: _ChillOps_`);
+    sections.push(`#### Opportunistic Work\n\n> Status: _ChillOps_`);
   }
 
   return sections.join("\n\n");
