Move apk package management from openwrt to linux

Author: localvoid

docs/src/content/docs/linux/package-management.md

@@ -3,7 +3,7 @@ title: Package Management
 description: APT, DNF4, DNF5, Pacman, APK, and RPM package management operations.
 ---
 
-Manage packages on Debian/Ubuntu (APT), Fedora (DNF5), RHEL (DNF4), Arch Linux (pacman), and OpenWrt 25.12+ (APK), plus GPG keys in the RPM database.
+Manage packages on Debian/Ubuntu (APT), Fedora (DNF5), RHEL (DNF4), Arch Linux (pacman), and Alpine-based distros (APK), plus GPG keys in the RPM database.
 
 ## APT (Debian/Ubuntu)
 
@@ -131,10 +131,10 @@ await removePackages({ packages: ['nginx'] });
 await removePackages({ packages: ['nginx'], autoremove: true });
 ```
 
-## APK (OpenWrt 25.12+)
+## APK (Alpine-based)
 
 ```ts
-import { getInstalledPackages, installPackages, removePackages } from '@sysopkit/openwrt/pkg/apk';
+import { getInstalledPackages, installPackages, removePackages } from '@sysopkit/linux/pkg/apk';
 ```
 
 ### getInstalledPackages()

packages/@sysopkit/linux/README.md

@@ -19,6 +19,7 @@ bun add @sysopkit/linux sysopkit
 | `disk` | `@sysopkit/linux/disk` | `lsblk()` — `BlockDeviceEntry[]` tree |
 | `os` | `@sysopkit/linux/os` | `getOSInfo()` — `/etc/os-release` |
 | `pkg/apt` | `@sysopkit/linux/pkg/apt` | **Idempotent** `installPackages`, `removePackages` (`autoremove?`); `getInstalledPackages()` |
+| `pkg/apk` | `@sysopkit/linux/pkg/apk` | **Idempotent** `installPackages`, `removePackages` (dry-run via `--simulate`); `getInstalledPackages()` |
 | `pkg/dnf4` | `@sysopkit/linux/pkg/dnf4` | **Idempotent** `installPackages` (`weakDependencies?`), `removePackages` (unused deps cleaned natively); `getInstalledPackages()` |
 | `pkg/dnf5` | `@sysopkit/linux/pkg/dnf5` | **Idempotent** `installPackages` (`weakDependencies?`), `removePackages` (unused deps cleaned natively); `getInstalledPackages()` |
 | `pkg/rpm` | `@sysopkit/linux/pkg/rpm` | **Idempotent** `importRpmKey({ name, content })`; `hasRpmKey(key)`, `getRpmKeys()`, `getRpmVars(vars)` |

packages/@sysopkit/linux/package.json

@@ -27,6 +27,11 @@
       "types": "./dist/pkg/apt.d.ts",
       "default": "./dist/pkg/apt.js"
     },
+    "./pkg/apk": {
+      "bun": "./src/pkg/apk.ts",
+      "types": "./dist/pkg/apk.d.ts",
+      "default": "./dist/pkg/apk.js"
+    },
     "./pkg/dnf4": {
       "bun": "./src/pkg/dnf4.ts",
       "types": "./dist/pkg/dnf4.d.ts",

packages/@sysopkit/openwrt/src/pkg/apk.ts packages/@sysopkit/linux/src/pkg/apk.tspackages/@sysopkit/openwrt/src/pkg/apk.ts renamed to packages/@sysopkit/linux/src/pkg/apk.ts

@@ -1,14 +1,16 @@
 /**
  * @module pkg/apk
  *
- * APK package management for OpenWrt 25.12 and newer.
+ * APK package management for Alpine-based distributions.
  *
- * APK (Alpine Package Keeper) replaced opkg as the package manager in
- * OpenWrt 25.12. This module provides operations for package management
- * using only `sh` and busybox applets (OpenWrt images carry no parity
- * contract: no sudo user, no bash).
+ * APK (Alpine Package Keeper) is the package manager for Alpine Linux and
+ * Alpine-based distributions, including OpenWrt 25.12 and newer (where it
+ * replaced opkg). This module provides operations for package management
+ * using only `sh`, so it also works on minimal/busybox environments like
+ * OpenWrt (no sudo user, no bash assumptions).
  *
- * @see https://openwrt.org/docs/guide-user/additional-software/apk - APK package manager
+ * @see https://wiki.alpinelinux.org/wiki/Alpine_Package_Keeper - APK package manager
+ * @see https://openwrt.org/docs/guide-user/additional-software/apk - APK on OpenWrt
  */
 
 import { emitChanged, task, VERBOSITY_TRACE } from 'sysopkit';

packages/@sysopkit/openwrt/README.md

@@ -51,7 +51,6 @@ Write `text` to the target with `createFile`, then reload with `sh('service netw
 | `@sysopkit/openwrt/uci/system` | `system` | `UciSystemSystem`, `UciSystemTimeserver`, `UciSystemLed`, `UciSystemRDNSSD` |
 | `@sysopkit/openwrt/uci/sqm` | `sqm` | `UciSqmQueue` |
 | `@sysopkit/openwrt/uci/upnpd` | `upnpd` | `UciUpnpdConfig`, `UciUpnpdPermRule` |
-| `@sysopkit/openwrt/pkg/apk` | — | **Idempotent** `installPackages`, `removePackages` (dry-run via `--simulate`); `getInstalledPackages()` |
 
 See the [docs site](https://www.sysopkit.com) for field-level details.
 

packages/@sysopkit/openwrt/package.json

@@ -22,11 +22,6 @@
   "sideEffects": false,
   "module": "true",
   "exports": {
-    "./pkg/apk": {
-      "bun": "./src/pkg/apk.ts",
-      "types": "./dist/pkg/apk.d.ts",
-      "default": "./dist/pkg/apk.js"
-    },
     "./uci/dhcp": {
       "bun": "./src/uci/dhcp.ts",
       "types": "./dist/uci/dhcp.d.ts",

tests/e2e/ops/pkg-apk.test.ts

@@ -1,5 +1,5 @@
 import { afterAll, beforeAll, describe, expect, test } from 'bun:test';
-import { getInstalledPackages, installPackages, removePackages } from '@sysopkit/openwrt/pkg/apk';
+import { getInstalledPackages, installPackages, removePackages } from '@sysopkit/linux/pkg/apk';
 import { trackChanged } from '@sysopkit/test-utils';
 import { onChange, type ChangeEntry } from 'sysopkit';
 import { sh } from 'sysopkit/op/sh';
@@ -21,7 +21,7 @@ async function installedNames(): Promise<Set<string>> {
 }
 
 /** OpenWrt is non-parity: only `sh` + busybox applets, no sudo user. */
-describe('pkg/apk (openwrt)', () => {
+describe('pkg/apk (alpine-based, on openwrt)', () => {
   let shared: Container;
   beforeAll(async () => {
     shared = await startSharedContainer({ distro: 'openwrt', publishSsh: false });