Shell good first issues

AI Summary: This issue requests an update to the README.md file to reflect the current project structure and build process. Specifically, it points out that outdated file paths are listed under "Contract → Directories" and proposes to correct these to accurately represent the build flow involving `src/main.sh`, `scripts/gen-mirror.py`, and `scripts/template-instantiate.py`. The goal is to provide clear guidance for new contributors.

AI Summary: This issue addresses inconsistencies between the built-in help documentation and the actual command-line interface (CLI) behavior for installation commands. Specifically, the help text incorrectly states installation paths and command aliases, leading to user confusion and errors. The goal is to synchronize the help documentation with the current implementation, ensuring accurate installation paths and supported aliases are displayed.

AI Summary: This issue proposes that the `hustmirror-cli` should return a non-zero exit code when an unknown command is provided, instead of the current behavior of returning 0. This change is necessary to allow scripts and CI systems to reliably detect invalid user input. The fix should be accompanied by new regression tests that verify this behavior and ensure that valid commands like `--help` and `--version` continue to return 0.

AI Summary: This issue addresses a bug where `make test` incorrectly returns a zero exit code even when individual Docker test cases fail. The goal is to ensure that `make test` returns a non-zero exit code if any Docker test case fails, while still preserving logs and attempting to run all tests. This will improve the reliability of test results for local development and CI pipelines.

AI Summary: This issue proposes adding a new output `cache_restored_fast` to the `actions/instrument/job` action. This output will indicate whether the dependency cache was successfully restored using the fast path (direct Actions Cache REST API). This will allow CI to detect regressions in the fast path, preventing silent failures where the job appears to succeed but uses a slower fallback method.

AI Summary: This issue proposes setting the LibreCode logo as the default avatar for the Nextcloud admin user within the development environment. The logo image needs to be added to the repository, and a script within the `.docker/scripts/nextcloud-entrypoint.sh` file should be updated to upload it using the Nextcloud avatar API, leveraging existing environment variables for admin credentials.

AI Summary: This is a device request for the Samsung Galaxy A13 4G (A137F) to be supported for a custom ROM, specifically a port of OneUI 7 based on Android 15. The user has provided the device codename, ROM details, and a link to Samsung's kernel source, but has not specified a kernel branch.

AI Summary: This issue proposes the implementation of a package management system for MaruxOS, which currently lacks one. The goal is to allow users to add and update software after booting, with two main candidates: a custom minimal package manager or porting an existing one. Key constraints include handling the live environment's squashfs and overlayfs, and adhering to license policies by including license texts.

AI Summary: The 'Close' option in the right-click context menu for Plank dock icons is not functioning as expected, failing to close the associated application window. While other menu options like focus switching work correctly, the close action does not. This issue has been reproduced on both ARM64 and x86_64 architectures with specific versions of Plank, bamf, and libwnck.

AI Summary: This issue proposes migrating the project's PO translation files to an online platform like Weblate, Transifex, or Crowdin. The goal is to improve accessibility for translators, allowing them to work from any device, and to streamline the translation process with features like translation memory and VCS integration.

AI Summary: This issue reports formatting errors in the Chinese simplified translation files for Arch-Update. Specifically, the translation is missing escaped newline characters (`\n`), using single backslashes (` `) instead, which causes compilation errors.

AI Summary: The build script fails to compile an image for Raspberry Pi 4b when the build environment's home directory has SELinux labels applied due to Samba sharing. This issue appears to stem from a check in the `rootfs-to-image.sh` script that incorrectly handles file system types.

AI Summary: This issue highlights a critical problem where the pack's installation can fail silently at multiple stages, leaving users unaware of broken functionality. The proposed solution is a read-only diagnostic script that checks and reports the status of agent visibility, skill paths, routing blocks, and hook wiring in plain language, with clear next steps for any issues.

AI Summary: This issue identifies that three skills within the project lack a "worked example" in their respective `references/` directories, as required by the `CONTRIBUTING` guidelines. The task is to create a synthetic or self-owned worked example for each of these three skills, ensuring they adhere to the format of existing examples and the rules outlined in their `SKILL.md` files. The examples must not contain confidential or third-party data.

AI Summary: This issue proposes refactoring the scoring logic in `evals/score.py` to avoid hardcoding model tiers. The goal is to allow new model tiers to be added by simply updating a registry, rather than modifying the code, and to ensure consistent ordering and display names for models.

AI Summary: The user is reporting that the kernel parameter `xe.enable_psr=0` is no longer necessary for a display fix on their Asus Expertbook running a 7.1.6-1 kernel with OpenSUSE Tumbleweed. They are suggesting this parameter might be redundant and can be removed.

AI Summary: The `run-tests.sh` script contains an outdated awk copy of the `detect_tool` function. This copy is missing support for the 'grok' tool and its associated parity tests are also incomplete. Consequently, any discrepancies in 'grok' detection between the main script and the production awk detector will go unnoticed.

AI Summary: The user encountered a "DEBUG kernel" message during boot on a Radxa Dragon Q6A board using an Ubuntu 26.04 Gnome image from Armbian. This indicates the image is not suitable for production use. The user suspects a configuration issue with the kernel build flags.

AI Summary: Users are reporting that WireGuard peer names containing hyphens or underscores are not accepted, despite the README suggesting alphanumeric characters. This prevents the creation of peers with these common naming conventions.

AI Summary: This issue is a request to add the 'Brave Origin' browser to the deb-get package manager. The user has confirmed it's a new request and provided the download and website URLs. Brave Origin is a privacy-focused version of the Brave browser officially distributed via an APT repository for Debian-based systems.

AI Summary: This issue proposes integrating 'Games on Whales' into the project, potentially requiring upstream Kubernetes integration. The provided link points to a quickstart guide for the 'wolf' component of Games on Whales, suggesting a focus on its implementation.

AI Summary: The `pre-pull-share-manager-image` sidecar container in the Longhorn DaemonSet currently lacks resource limits, preventing effective pod-level memory capping. This issue can lead to unexpected OOM kills on platforms like Talos Linux, even when `longhornManager.resources` are configured. The proposed solutions involve applying resource limits to the sidecar or providing an option to disable it when not needed.

AI Summary: This issue requests testing and potential bug fixing related to Apple Magic Keyboard compatibility. The goal is to ensure the keyboard functions correctly and to address any identified problems.

AI Summary: This issue requests an update to the project's documentation to include Mac-specific keybindings and customizations. The goal is to clarify potentially confusing elements for new users of the Omarchy platform on macOS.

AI Summary: This issue requests an update to the keybindings menu to explicitly display Omarchy Mac-specific keybindings that are currently missing. The goal is to ensure users can easily find and understand all available shortcuts, such as `Shift + F1/F2`.

AI Summary: This issue requests an update to GMT (Generic Mapping Tools) to version 6.7.0. The task involves updating the software dependency to the latest specified version, likely within a project's build or package management system.

AI Summary: This GitHub issue is a bug report with extremely minimal information. The user has not described the bug, the expected behavior, or provided any screenshots. They have only indicated steps to reproduce which involve emailing a specific address with a bug report and screenshot, and have provided some basic environmental information.

AI Summary: This issue proposes adding a new installer for a tool named 'CHANGE-ME' to the webi package manager. The process involves copying an example template, updating release information from an external source, and performing find-and-replace operations across several installation scripts and documentation files. The goal is to ensure consistent installation across Windows, Mac, and Linux.

AI Summary: The GitHub Actions workflow `refresh_demos.yml` incorrectly uses a non-existent environment variable `$GITHUB_EVENT` to determine which release assets to download. This causes the workflow to always fetch the latest release instead of the release that triggered the event, leading to demos being built against outdated versions. The suggested fix is to use the correct environment variable `GITHUB_EVENT_NAME`.