Add elsewhen, the Omarchy shell world clock plugin

pkgbuilds/elsewhen/.omarchy/README.md

@@ -0,0 +1,17 @@
+# elsewhen
+
+Installs the Elsewhen world clock plugin from the `v{pkgver}` GitHub tag archive into `/usr/share/omarchy/plugins/omacom.elsewhen/` (the directory name is the plugin id the shell scans for, not the package name), plus `LICENSE` under `/usr/share/licenses/elsewhen/` and the upstream `README.md` under `/usr/share/doc/elsewhen/`. That directory is the packaged plugin root that omarchy PR [#12051](https://github.com/omacom/omarchy/pull/12051) teaches the shell to scan between its bundled plugins and `~/.config/omarchy/plugins`; on an Omarchy without it the package installs cleanly and the shell never looks, so it must ship alongside that change. `depends` carries no version floor for `omarchy` because no release carries #12051 yet; add one once it does.
+
+`package()` copies an explicit allow-list (`manifest.json`, every `*.qml` and `*.js`, `cities.json`, `world.json`, `worldclock-data.py`), so `tests/`, `.github/` and `.gitignore` never ship, and it fails the build if `manifest.json` is missing, does not declare `omacom.elsewhen`, or does not name a present `Panel.qml` as the entry point. An upstream release that adds a runtime file outside those patterns needs the allow-list extended here; the sync only moves versions and checksums. Every file is 0644: `Panel.qml` runs the script as `python3 <plugin dir>/worldclock-data.py`, so it needs no execute bit. No install hook: Omarchy restarts the shell after `omarchy update`, and nothing here may write into a user home. The script's only writes go to `$XDG_CACHE_HOME/omacom-elsewhen/`, which it creates itself at runtime.
+
+Dependencies, cited as `file: tool` in the upstream tree:
+
+- `omarchy`: `ArcText.qml`, `Chip.qml`, `EarthRow.qml`, `Globe.qml`, `MiniGlobe.qml`, `MoonDot.qml`, `Panel.qml: import qs.Commons`; `EarthRow.qml`, `Globe.qml`, `Panel.qml: import qs.Ui`. Owns `/usr/share/omarchy` and the packaged plugin root the shell scans.
+- `quickshell`: `Globe.qml`, `Panel.qml: import Quickshell`; `Globe.qml`, `MiniGlobe.qml`, `Panel.qml: import Quickshell.Io` (`Process`, `FileView`, `StdioCollector`).
+- `python`: `Panel.qml: python3 <plugin dir>/worldclock-data.py` (the facts process). `worldclock-data.py` imports only `json`, `os`, `sys`, `time`, `urllib`.
+- Left implicit as members of `base`, per Arch convention: `bash` (`Panel.qml`, `Globe.qml: bash -c` wraps every probe), `coreutils` (`Panel.qml`, `Globe.qml: date`, one probe per refresh), `systemd` (`Panel.qml: timedatectl show`, `timedatectl list-timezones`, each with a fallback: `/etc/localtime` for the home zone and `find /usr/share/zoneinfo` for the catalog), `sed` and `grep` (`Panel.qml`: the symlink target of `/etc/localtime` and the zoneinfo catalog filter), `findutils` and `tzdata` (that fallback; `worldclock-data.py: /usr/share/zoneinfo/zone1970.tab`). `omarchy` cannot run without any of them either.
+- Not a dependency: `iso-codes`. Only `tests/currency_check.py` reads `/usr/share/iso-codes/json`, to validate the currency table before a release; the runtime never touches it.
+
+Release tracking: `bin/sync-upstream` follows `omacom/elsewhen` through the `upstream.watch.github` provider, which reads the GitHub Releases feed (drafts and prereleases excluded; a tag with no published Release is not seen) and matches exactly `vX.Y.Z`, the grammar upstream's `scripts/set-version.sh` enforces. A newer release rewrites `pkgver`, resets `pkgrel` to 1, fetches `archive/refs/tags/v{pkgver}.tar.gz` again and rewrites `sha256sums` from the download. The Release's `published_at` is what lets `min_release_age: 24h` hold a fresh release for a day; `release_ring: fast` builds it straight to rc and stable as well as edge.
+
+The watch only moves on a version increase, so the first release's digest is filled in by hand (`curl -fsSL <archive url> | sha256sum`), which is why the recipe carries a placeholder until the `v0.1.0` tag exists. Until upstream has published at least one Release, the watch finds nothing and fails the scheduled `sync-upstream` run for every package in the batch, so this recipe stays a draft until then.

pkgbuilds/elsewhen/.omarchy/package.json

@@ -0,0 +1,11 @@
+{
+  "source": "local",
+  "release_ring": "fast",
+  "min_release_age": "24h",
+  "upstream": {
+    "watch": {
+      "github": "omacom/elsewhen",
+      "pattern": "v(?P<version>[0-9]+\\.[0-9]+\\.[0-9]+)"
+    }
+  }
+}

pkgbuilds/elsewhen/PKGBUILD

@@ -0,0 +1,70 @@
+# Maintainer: Spencer Bull <spencer.bull@hey.com>
+
+pkgname=elsewhen
+pkgver=0.1.0
+pkgrel=1
+pkgdesc='World clock plugin for the Omarchy shell'
+arch=('any')
+url='https://github.com/omacom/elsewhen'
+license=('MIT')
+
+# What the plugin needs to load and run. It also shells out to bash, date
+# (coreutils) and timedatectl (systemd) and reads /usr/share/zoneinfo
+# (tzdata); those are members of the base group and stay implicit, per Arch
+# convention. The citations for each entry are in .omarchy/README.md.
+depends=(
+  'omarchy'
+  'python'
+  'quickshell'
+)
+
+options=('!debug')
+
+source=("$pkgname-$pkgver.tar.gz::$url/archive/refs/tags/v$pkgver.tar.gz")
+# Fill once the v0.1.0 tag exists:
+#   curl -fsSL https://github.com/omacom/elsewhen/archive/refs/tags/v0.1.0.tar.gz | sha256sum
+# bin/sync-upstream rewrites this array only when it moves pkgver forward, so
+# the first release's digest has to be entered by hand.
+sha256sums=('FILL_FROM_RELEASE_ARCHIVE')
+
+package() {
+  # The packaged plugin root, scanned by the shell between its bundled
+  # plugins and ~/.config/omarchy/plugins since omarchy PR #12051. An older
+  # shell never looks here, so on it this package installs cleanly and does
+  # nothing; there is no omarchy version to pin until a release carries #12051.
+  local plugin="$pkgdir/usr/share/omarchy/plugins/omacom.elsewhen"
+  cd "$srcdir/$pkgname-$pkgver" || return 1
+
+  # The shell loads the entry point each manifest declares. A tree without
+  # either would install cleanly and never load, so fail the build instead of
+  # shipping it.
+  [[ -f manifest.json ]] || {
+    echo "release tree is missing manifest.json" >&2
+    return 1
+  }
+  grep -Eq '"id"[[:space:]]*:[[:space:]]*"omacom\.elsewhen"' manifest.json || {
+    echo "manifest.json does not declare the plugin id omacom.elsewhen" >&2
+    return 1
+  }
+  grep -Eq '"barWidget"[[:space:]]*:[[:space:]]*"Panel\.qml"' manifest.json || {
+    echo "manifest.json does not name Panel.qml as the bar widget entry point" >&2
+    return 1
+  }
+  [[ -f Panel.qml ]] || {
+    echo "release tree is missing the entry point Panel.qml" >&2
+    return 1
+  }
+
+  # An explicit allow-list of runtime files, so tests/, .github/ and the rest
+  # of the repository never reach the package. Directories end up 0755 and
+  # every file 0644: worldclock-data.py runs as `python3 <path>` and needs no
+  # execute bit. An unmatched glob is left literal and fails install, which
+  # is the right outcome for a release tree missing its QML or JS.
+  local file
+  for file in manifest.json cities.json world.json worldclock-data.py *.qml *.js; do
+    install -Dm644 "$file" "$plugin/$file"
+  done
+
+  install -Dm644 LICENSE "$pkgdir/usr/share/licenses/$pkgname/LICENSE"
+  install -Dm644 README.md "$pkgdir/usr/share/doc/$pkgname/README.md"
+}