pi-extensions 0.1.21 → 0.1.22

package/.github/workflows/weather-native-bridge.yml

@@ -0,0 +1,86 @@
+name: weather-native-bridge
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build-prebuilt:
+    name: build (${{ matrix.target }})
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: macos-14
+            target: aarch64-apple-darwin
+          - runner: macos-14
+            target: x86_64-apple-darwin
+          - runner: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+          - runner: windows-latest
+            target: x86_64-pc-windows-msvc
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Setup Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}
+
+      - name: Install bridge dependencies
+        working-directory: weather/native/weathr-bridge
+        run: npm install --no-package-lock
+
+      - name: Build prebuilt binary
+        working-directory: weather/native/weathr-bridge
+        run: npx napi build --platform --release --dts native.d.ts --target ${{ matrix.target }}
+
+      - name: Upload binary artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: bindings-${{ matrix.target }}
+          path: weather/native/weathr-bridge/pi_weather_bridge.*.node
+          if-no-files-found: error
+
+  publish-platform-packages:
+    name: publish prebuilt packages
+    runs-on: ubuntu-latest
+    needs: build-prebuilt
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: weather/native/weathr-bridge/artifacts
+
+      - name: Prepare npm package folders
+        working-directory: weather
+        run: npm run native:prepare-packages
+
+      - name: Sync artifacts into npm package folders
+        working-directory: weather
+        run: npm run native:sync-artifacts
+
+      - name: Publish platform packages
+        working-directory: weather
+        run: npm run native:publish-packages
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/files-widget/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-files-widget",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "In-terminal file browser and viewer for Pi.",
   "license": "MIT",
   "author": "Thomas Mustier",
@@ -15,8 +15,8 @@
   "bugs": "https://github.com/tmustier/pi-extensions/issues",
   "homepage": "https://github.com/tmustier/pi-extensions/tree/main/files-widget",
   "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "^0.50.0",
-    "@mariozechner/pi-tui": "^0.50.0"
+    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-tui": "*"
   },
   "scripts": {
     "postinstall": "node -e \"console.log('pi-files-widget: required deps: bat, delta, glow. Install with: brew install bat git-delta glow')\""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-extensions",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "license": "MIT",
   "private": false,
   "keywords": [

package/ralph-wiggum/index.ts

@@ -602,6 +602,11 @@ Examples:
 		name: "ralph_start",
 		label: "Start Ralph Loop",
 		description: "Start a long-running development loop. Use for complex multi-iteration tasks.",
+		promptSnippet: "Start a persistent multi-iteration development loop with pacing and reflection controls.",
+		promptGuidelines: [
+			"Use this tool when the user explicitly wants an iterative loop, autonomous repeated passes, or paced multi-step execution.",
+			"After starting a loop, continue each finished iteration with ralph_done unless the completion marker has already been emitted.",
+		],
 		parameters: Type.Object({
 			name: Type.String({ description: "Loop name (e.g., 'refactor-auth')" }),
 			taskContent: Type.String({ description: "Task in markdown with goals and checklist" }),
@@ -653,6 +658,11 @@ Examples:
 		name: "ralph_done",
 		label: "Ralph Iteration Done",
 		description: "Signal that you've completed this iteration of the Ralph loop. Call this after making progress to get the next iteration prompt. Do NOT call this if you've output the completion marker.",
+		promptSnippet: "Advance an active Ralph loop after completing the current iteration.",
+		promptGuidelines: [
+			"Call this after making real iteration progress so Ralph can queue the next prompt.",
+			"Do not call this if there is no active loop, if pending messages are already queued, or if the completion marker has already been emitted.",
+		],
 		parameters: Type.Object({}),
 		async execute(_toolCallId, _params, _signal, _onUpdate, ctx) {
 			if (!currentLoop) {

package/ralph-wiggum/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-ralph-wiggum",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Long-running agent loops for iterative development in Pi.",
   "license": "MIT",
   "author": "Thomas Mustier",

package/weather/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## 0.1.1 - 2026-02-12
+- Added an embedded demo GIF in the README that links to the MP4 demo hosted on GitHub.
+- Kept demo media out of npm installs while improving README preview on GitHub/npm.
+
+## 0.1.0 - 2026-02-12
+- Initial release of `/weather` weather widget extension.
+- Added native Rust bridge (`native/weathr-bridge`) with automatic shell fallback.
+- Added ANSI color preservation in the weather widget output.
+- Fixed shell fallback PTY bootstrap under Bun by binding `script` stdin to `/dev/null` (avoids socket `tcgetattr` errors without stealing ESC input from Pi).
+- `/weather-config` now warns when `location.auto=true` (which overrides manual latitude/longitude).
+- Added optional dependency support for platform prebuilt native bridge packages (`@tmustier/pi-weather-bridge-*`).
+- Added release automation workflow for publishing native bridge platform packages (`.github/workflows/weather-native-bridge.yml`).
+- `/weather` now renders in the main custom UI area (above the editor) instead of centered overlay mode.
+- Added `/weather-config` command and isolated config at `~/.pi/weather-widget/weathr/config.toml`.

package/weather/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thomas Mustier
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/weather/README.md

@@ -0,0 +1,132 @@
+# Weather Widget Extension
+
+Run the [weathr](https://github.com/veirt/weathr) terminal weather app inside Pi via `/weather`.
+
+It opens in the main widget area above the input box (same interaction style as `/snake`), supports live weather + simulation flags, keeps controls inside Pi, and preserves ANSI colors.
+
+The extension prefers a Rust N-API bridge (`native/weathr-bridge`) and falls back to a shell bridge if native isn't built.
+
+## Demo
+
+[![Weather widget demo](https://raw.githubusercontent.com/tmustier/pi-extensions/main/weather/assets/weather-demo.gif)](https://raw.githubusercontent.com/tmustier/pi-extensions/main/weather/assets/weather-demo.mp4)
+
+[Open MP4 demo directly](https://raw.githubusercontent.com/tmustier/pi-extensions/main/weather/assets/weather-demo.mp4)
+
+_Demo media is loaded from GitHub links and kept out of npm installs (package `files` whitelist + repo `.npmignore`)._
+
+## Install
+
+### Pi package manager
+
+```bash
+pi install npm:@tmustier/pi-weather
+```
+
+```bash
+pi install git:github.com/tmustier/pi-extensions
+```
+
+Then filter to just this extension in `~/.pi/agent/settings.json`:
+
+```json
+{
+  "packages": [
+    {
+      "source": "git:github.com/tmustier/pi-extensions",
+      "extensions": ["weather/index.ts"]
+    }
+  ]
+}
+```
+
+### Local clone
+
+```bash
+ln -s ~/pi-extensions/weather ~/.pi/agent/extensions/weather
+```
+
+Or add to `~/.pi/agent/settings.json`:
+
+```json
+{
+  "extensions": ["~/pi-extensions/weather"]
+}
+```
+
+## Commands
+
+- `/weather` — open live weather widget
+- `/weather rain` — shortcut for `--simulate rain`
+- `/weather --simulate snow --night`
+- `/weather-config` — edit widget config (`config.toml`)
+
+While open:
+- `Esc` or `Q` closes the widget
+- `R` restarts the weather process
+
+## Requirements
+
+- `weathr` installed and available on PATH (or in `~/.cargo/bin/weathr`)
+- `script` command available (macOS default, `util-linux` on Linux)
+
+Install weathr:
+
+```bash
+cargo install weathr
+```
+
+Build the native Rust bridge locally (optional, for development):
+
+```bash
+cd ~/pi-extensions/weather
+npm run build:native
+```
+
+Requires Rust + Node.
+
+For npm users, the extension can load prebuilt optional packages (`@tmustier/pi-weather-bridge-*`) when published.
+
+Troubleshooting:
+
+- The extension auto-falls back to shell mode if native bridge has no output.
+- If no matching prebuilt native package is installed for your platform, it falls back to shell mode.
+- It explicitly unsets `NO_COLOR` for the weather child process and sets `COLORTERM=truecolor` when missing.
+- Shell fallback binds `script` stdin to `/dev/null` (avoids Bun socket `tcgetattr` issues while preserving ANSI color output and ESC handling in Pi).
+- Force shell mode manually:
+
+```bash
+PI_WEATHER_NATIVE=0 pi
+```
+
+## Config Location
+
+The extension uses an isolated config home:
+
+- `~/.pi/weather-widget/weathr/config.toml`
+
+Use `/weather-config` to edit it.
+
+> If you set custom `latitude`/`longitude`, also set `location.auto = false` or `weathr` will keep auto-detecting your location.
+
+## Publishing native prebuilt packages
+
+To ship `weathr-bridge` without requiring Rust at install time:
+
+- Run GitHub Actions workflow `.github/workflows/weather-native-bridge.yml` (manual `workflow_dispatch`).
+- The workflow builds prebuilt `.node` files per target, syncs them into `native/weathr-bridge/npm/*`, and publishes `@tmustier/pi-weather-bridge-*` platform packages.
+- Then publish `@tmustier/pi-weather` (this extension) so consumers pick up the matching optional dependency versions.
+- Keep versions in sync (`weather/package.json`, `native/weathr-bridge/package.json`, and `native/weathr-bridge/npm/*/package.json`).
+
+Manual fallback (if not using the workflow):
+
+```bash
+cd ~/pi-extensions/weather
+npm run native:prepare-packages
+# build / download per-target pi_weather_bridge.<target>.node files into native/weathr-bridge/artifacts
+npm run native:sync-artifacts
+npm run native:publish-packages
+```
+
+## Changelog
+
+See `CHANGELOG.md`.