# 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.
