my-pi/pi-notify/UPSTREAM.md

Upstream source

• Project: @smoose/pi-notify
• Repository: https://github.com/smoosex/pi-notify
• Imported npm version: 0.1.1
• Imported commit: 3a3691ab690b4bc37a4412ab0dcbd35ef14adcbf
• Commit date: 2026-06-02
• npm tarball and repository source were compared before import.

The source is maintained directly in this repository. It is not a submodule and does not retain an embedded .git directory or upstream build artifacts.

Local changes

• Notify on agent_settled rather than agent_end, preserving elapsed time and the latest messages across retries.
• Restrict terminal output to TUI mode so OSC sequences cannot corrupt RPC, JSON, or print output.
• Give each Pi session a stable unique OSC 99 notification ID.
• Make Kitty click-to-focus explicit and default visibility to always, while retaining unfocused and invisible as opt-in policies.
• Add duration filtering, enable/privacy/action settings, status template fields, and /notify controls.
• Keep Base64 Kitty payloads, harden OSC metadata/fallback sanitization, and ignore detached-process spawn errors.
• Add lifecycle, multi-window metadata, fallback, parser, and configuration tests.

Upstream declares the project under the MIT license but did not include a LICENSE file at the imported commit or in the npm tarball. This directory adds the standard MIT text using the upstream author's GitHub identity and commit year so the declared license travels with the maintained source.