Merge pull request #366 from PyAutoLabs/feature/bundle-themes

mind: themes.md vocabulary, Themes: backfill, themed dashboard

Author: Jammy2211

.github/workflows/dashboard_refresh.yml

@@ -36,6 +36,7 @@ on:
       - "planned.md"
       - "condemned.md"
       - "bundles.md"
+      - "themes.md"
       - "dashboard.md"
       - "dashboard.html"
   pull_request:
@@ -47,6 +48,7 @@ on:
       - "planned.md"
       - "condemned.md"
       - "bundles.md"
+      - "themes.md"
       - "dashboard.md"
       - "dashboard.html"
   workflow_dispatch:

REFERENCE.md

@@ -297,6 +297,9 @@ Free-form markdown. Strong conventions:
   Repos:
   - PyAutoLens
   - autolens_workspace
+  Themes:                   # optional; vocabulary in themes.md, primary first
+  - mge
+  - jax-gradient
   Difficulty: medium        # small | medium | large | too-large
   Autonomy: supervised      # safe | supervised | human-required
   Priority: normal          # low | normal | high
@@ -353,6 +356,31 @@ Free-form markdown. Strong conventions:
   since it is already spoken for. A slug naming no registry entry still
   groups, loudly (⚠️ on the page), so a typo is visible rather than silent.
 
+  **Declaring what the work is ABOUT — `Themes:`.** Optional, and the same
+  list shape as `Repos:` — a bare `Themes:` line, then one `- keyword` bullet
+  each. `Target:` says where the code lives; `Themes:` says what the work is
+  about, which is usually the more useful grouping and is routinely cross-repo:
+
+  ```markdown
+  Themes:
+  - mge
+  - jax-gradient
+  ```
+
+  The **first** keyword is the primary theme and is what the dashboard's
+  auto-bundler groups on, so a card reads "three things about MGE" rather than
+  "three things that live in autoarray"; the remaining keywords are affinity,
+  deciding which prompts pack together inside that group. One to three keywords
+  is the intended shape, primary first. A prompt with no `Themes:` still
+  bundles — the bundler falls back to `Target:` — so nothing waits on a theme.
+
+  The vocabulary is [`themes.md`](themes.md), a plain markdown list a human
+  edits directly (PyAutoBrain reads that file rather than holding its own
+  copy). A keyword that is not in it still groups, loudly: ⚠️ on the bundle
+  card and a count in the dashboard's Hygiene section, so the list never rots
+  into free-text tags. The **Intake (Conception) Agent** assigns `Themes:` when
+  it formalises a prompt.
+
   The optional `Difficulty:` / `Autonomy:` / `Priority:` keys let both people and
   PyAutoBrain see, at a glance, how hard a task is, whether an agent can safely
   take it on, and how urgent it is. What each `Autonomy:` level *does* at every
@@ -511,7 +539,7 @@ no prompt.
 | Ledger — merged automatically | Code — always a human |
 |---|---|
 | `draft/**`, `active/**`, `complete/**` | `scripts/`, `tests/`, `.github/`, `skills/`, `policy/`, `docs/` |
-| `active.md`, `planned.md`, `parked.md`, `condemned.md`, `epics.md`, `bundles.md`, `ideas.md`, `autonomy_log.md` | `repos.yaml`, `README.md`, `AGENTS.md`, `REFERENCE.md`, `ROUTING.md`, … |
+| `active.md`, `planned.md`, `parked.md`, `condemned.md`, `epics.md`, `bundles.md`, `ideas.md`, `autonomy_log.md` | `repos.yaml`, `themes.md`, `README.md`, `AGENTS.md`, `REFERENCE.md`, `ROUTING.md`, … |
 | `dashboard.md`, `dashboard.html` | anything unclassified — a new root file, a new top-level folder |
 
 Two exceptions inside the ledger dirs: a **dot-path** anywhere, and a file

dashboard.html

@@ -4,6 +4,8 @@ Type: bug
 Target: autoarray
 Repos:
 - @PyAutoArray
+Themes:
+- pixelization
 Difficulty: medium
 Autonomy: supervised
 Priority: normal

dashboard.md

@@ -4,6 +4,8 @@ Type: bug
 Target: autoarray
 Repos:
 - @PyAutoArray
+Themes:
+- pixelization
 Difficulty: medium
 Autonomy: human-required
 Priority: low

draft/bug/autoarray/PROBE_adapt_double_square_coefficient.md

@@ -4,6 +4,8 @@ Type: bug
 Target: PyAutoFit
 Repos:
 - PyAutoFit
+Themes:
+- graphical-ep
 Difficulty: too-large
 Autonomy: human-required
 Priority: high

draft/bug/autoarray/reconstruction_noise_map_solver_mismatch.md

@@ -5,6 +5,9 @@ Target: PyAutoGalaxy
 Repos:
 - PyAutoGalaxy
 - PyAutoLens
+Themes:
+- point-source
+- jax-gradient
 Difficulty: large
 Autonomy: supervised
 Priority: high

draft/bug/autofit/ep_scale_collapse_basin_cure_or_caveat.md

@@ -5,6 +5,10 @@ Target: autolens
 Repos:
 - PyAutoLens
 - autolens_workspace_test
+Themes:
+- jax-compile
+- visualization
+- pixelization
 Difficulty: medium
 Autonomy: supervised
 Priority: normal

draft/bug/autogalaxy/lenscalc_numpy_hessian_step_is_too_coarse.md

@@ -7,6 +7,8 @@ Repos:
 - PyAutoLens
 - autolens_profiling
 - PyAutoNerves
+Themes:
+- point-source
 Difficulty: too-large
 Autonomy: supervised
 Priority: high