Add maintainer pack

Author: luccahuguet

.beads/issues.jsonl

@@ -95,3 +95,4 @@
 {"id":"yazelix-vi0","title":"Fix skip_welcome_screen=false being ignored during interactive launch","description":"The core.skip_welcome_screen setting is currently being ignored for interactive Yazelix launch flows. Users with skip_welcome_screen = false still do not see the welcome UI.","design":"Trace so far: the interactive launch path still calls show_welcome from nushell/scripts/core/start_yazelix_inner.nu, so the setting is not being ignored because the UI code was removed. The likely regression is environment leakage: launch wrappers pass --skip-welcome into the devenv/bootstrap layer, which sets YAZELIX_SKIP_WELCOME=true, and show_welcome treats that as test_mode. The most suspicious paths are nushell/scripts/core/start_yazelix.nu, nushell/scripts/utils/environment_bootstrap.nu, and nushell/scripts/yzx/launch.nu. The likely fix is to keep bootstrap welcome suppression for environment setup while clearing or scoping YAZELIX_SKIP_WELCOME before the real interactive inner session starts.","acceptance_criteria":"With core.skip_welcome_screen = false, interactive Yazelix launch shows the welcome screen again. With core.skip_welcome_screen = true, the welcome screen is skipped and the info is logged as before. The fix must not regress env-only, one-shot command, or sweep/test flows that intentionally use YAZELIX_SKIP_WELCOME.","status":"open","priority":2,"issue_type":"bug","created_at":"2026-03-14T20:09:12.701657419Z","created_by":"lucca","updated_at":"2026-03-14T20:09:19.982045894Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["launch","regression","ux","welcome"]}
 {"id":"yazelix-vi3","title":"Auto-assign new GitHub issues to the maintainer","description":"Automatically assign new GitHub issues to the maintainer instead of leaving assignment as a manual follow-up step.","design":"Treat this as repository workflow automation, not product runtime work. Decide whether GitHub Actions, issue templates, or another automation path is the right place to assign newly opened issues to the maintainer, and verify the permission model before committing to an approach. The solution should be reliable without creating noisy side effects on transferred, reopened, or bot-created issues unless that behavior is explicitly desired.","acceptance_criteria":"New issues are assigned to the intended maintainer automatically, or the repo has a documented explanation of why that automation is not supportable. Include validation for the chosen workflow path, with logs or dry-run evidence showing the assignment behavior for representative issue-opening scenarios.","status":"open","priority":4,"issue_type":"task","created_at":"2026-03-11T19:04:06.545186857Z","created_by":"lucca","updated_at":"2026-03-11T19:04:06.683603842Z","external_ref":"https://github.com/luccahuguet/yazelix/issues/422","source_repo":".","compaction_level":0,"original_size":0,"labels":["automation","github","triage","workflow"]}
 {"id":"yazelix-x7z","title":"Add CI check for README version drift","description":"Protect the public README version marker from drifting away from YAZELIX_VERSION. Add one focused check that compares the README title/version line against the version constant and run it in CI.","status":"closed","priority":2,"issue_type":"bug","created_at":"2026-03-22T12:28:38.542160312Z","created_by":"lucca","updated_at":"2026-03-22T12:35:10.079239646Z","closed_at":"2026-03-22T12:35:10.078156204Z","close_reason":"Completed: added README version drift validator to CI and taught yzx dev update to auto-sync the README title/version marker from YAZELIX_VERSION","external_ref":"https://github.com/luccahuguet/yazelix/issues/446","source_repo":".","compaction_level":0,"original_size":0,"labels":["ci","docs","versioning"]}
+{"id":"yazelix-xeq","title":"Add maintainer pack for local maintainer tooling","description":"Imported GitHub issue #453 after deciding that maintainer tooling should be an opt-in pack rather than a special yzx dev mode. Add a top-level maintainer pack for repo maintenance tools that are meaningfully tied to maintaining Yazelix itself, starting with gh, prek, tru, beads-rust, and beads-viewer. Keep runtime behavior unchanged, sync the default config and Home Manager module, document the pack in the collection/docs, and add a focused regression test that verifies the pack stays aligned across configuration paths.","status":"closed","priority":2,"issue_type":"feature","created_at":"2026-03-22T12:52:37.729964836Z","created_by":"lucca","updated_at":"2026-03-22T12:56:40.730174328Z","closed_at":"2026-03-22T12:56:40.729748842Z","close_reason":"Added an opt-in maintainer pack with gh, prek, tru, beads-rust, and beads-viewer; synced the default config, Home Manager module, and collection docs; and added a regression test that keeps the pack aligned across both configuration paths.","external_ref":"https://github.com/luccahuguet/yazelix/issues/453","source_repo":".","compaction_level":0,"original_size":0,"labels":["maintainer","packs","workflow"]}

docs/yazelix_collection.md

@@ -181,6 +181,15 @@ General-purpose development tools:
 - [lazyjj](https://github.com/Cretezy/lazyjj) — LazyGit-style TUI for jj
 - [jjui](https://github.com/idursun/jjui) — TUI for Jujutsu VCS
 
+### Maintainer Pack (`maintainer`)
+Tools for maintaining Yazelix itself without changing runtime behavior.
+
+- [gh](https://cli.github.com/) — GitHub CLI for issues, PRs, and repo workflow
+- [prek](https://github.com/j178/prek) — Fast local pre-commit hook runner
+- [tru](https://github.com/block/tru) — Compact structured output for Beads and agent workflows
+- [beads-rust](https://github.com/Dicklesworthstone/beads_rust) — Rust Beads tracker (`br`)
+- [beads-viewer](https://github.com/Dicklesworthstone/beads_viewer) — Graph-aware triage and visualization (`bv`)
+
 ### AI Agents Pack (`ai_agents`)
 AI coding agents sourced from [llm-agents.nix](https://github.com/numtide/llm-agents.nix) with daily updates.
 

home_manager/module.nix

@@ -458,6 +458,13 @@ in
           "lazyjj"
           "jjui"
         ];
+        maintainer = [
+          "gh"
+          "prek"
+          "tru"
+          "beads-rust"
+          "beads-viewer"
+        ];
         python = [
           "ruff"
           "uv"

nushell/scripts/dev/test_yzx_dev_commands.nu

@@ -3,6 +3,29 @@
 use ../core/yazelix.nu *
 use ./test_yzx_helpers.nu [get_repo_config_dir repo_path]
 
+def extract_hm_pack_declaration [pack_name: string] {
+    let hm_module = (open --raw (repo_path "home_manager" "module.nix"))
+    let lines = ($hm_module | lines)
+    let start_pattern = $"        ($pack_name) = ["
+    let start_index = ($lines | enumerate | where item == $start_pattern | get -o 0.index | default null)
+
+    if $start_index == null {
+        return []
+    }
+
+    $lines
+    | skip ($start_index + 1)
+    | take while { |line| ($line | str trim) != "];" }
+    | each { |line|
+        $line
+        | str trim
+        | parse --regex '^"(?<pkg>.+)"$'
+        | get -o 0.pkg
+        | default null
+    }
+    | where { |pkg| $pkg != null }
+}
+
 def test_dev_update_canary_set [] {
     print "🧪 Testing yzx dev update canary set..."
 
@@ -51,9 +74,9 @@ def test_tru_is_in_ai_agents [] {
     try {
         let default_config = (open (repo_path "yazelix_default.toml"))
         let default_agents = ($default_config.packs.declarations.ai_agents | default [])
-        let hm_module = (open --raw (repo_path "home_manager" "module.nix"))
+        let hm_agents = (extract_hm_pack_declaration "ai_agents")
 
-        if ("tru" in $default_agents) and ($hm_module | str contains '"tru"') {
+        if ("tru" in $default_agents) and ("tru" in $hm_agents) {
             print "  ✅ tru is present in both ai_agents configuration paths"
             true
         } else {
@@ -66,6 +89,34 @@ def test_tru_is_in_ai_agents [] {
     }
 }
 
+def test_maintainer_pack_stays_in_sync [] {
+    print "🧪 Testing maintainer pack stays in sync across config paths..."
+
+    try {
+        let expected = [
+            "gh"
+            "prek"
+            "tru"
+            "beads-rust"
+            "beads-viewer"
+        ]
+        let default_config = (open (repo_path "yazelix_default.toml"))
+        let default_pack = ($default_config.packs.declarations.maintainer | default [])
+        let hm_pack = (extract_hm_pack_declaration "maintainer")
+
+        if (($default_pack | sort) == ($expected | sort)) and (($hm_pack | sort) == ($expected | sort)) {
+            print "  ✅ maintainer pack matches in both the default config and Home Manager module"
+            true
+        } else {
+            print $"  ❌ Unexpected maintainer pack contents: default=($default_pack | to json -r) hm=($hm_pack | to json -r)"
+            false
+        }
+    } catch { |err|
+        print $"  ❌ Exception: ($err.msg)"
+        false
+    }
+}
+
 def test_home_manager_desktop_entry_evaluates [] {
     print "🧪 Testing Home Manager desktop entry evaluates with StartupWMClass..."
 
@@ -126,6 +177,7 @@ export def run_dev_tests [] {
         (test_dev_update_canary_set)
         (test_gemini_cli_is_reactivated)
         (test_tru_is_in_ai_agents)
+        (test_maintainer_pack_stays_in_sync)
         (test_home_manager_desktop_entry_evaluates)
         (test_readme_title_matches_declared_version)
     ]

yazelix_default.toml

@@ -286,6 +286,7 @@ enabled = [
   # "file-management",
   # "git",
   # "jj",
+  # "maintainer",
   # "python",
   # "rust",
   # "rust_maintainer",
@@ -371,6 +372,14 @@ jj = [
   "jjui", # TUI for Jujutsu VCS
 ]
 
+maintainer = [
+  "gh", # GitHub CLI for repo maintenance
+  "prek", # Fast local git-hook runner and commit log viewer
+  "tru", # Compact Beads/agent structured output CLI
+  "beads-rust", # Rust Beads tracker (br)
+  "beads-viewer", # Beads Viewer (bv)
+]
+
 # Language packs
 python = [
   "ruff", # Fast Python linter/formatter