ntfyx 0.0.0-stage → 0.1.4

package/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2026 ntfyx contributors. All rights reserved.
+
+Permission is granted to download, install and run officially published ntfyx
+binaries for personal or commercial use. This permission is free of charge.
+It does not grant permission to redistribute ntfyx source code, modified ntfyx
+applications, or ntfyx binaries, except where a third-party license requires it.
+
+Third-party components remain under their respective licenses. See the release
+THIRD_PARTY_NOTICES.txt and sbom.json. Those licenses and their applicable rights
+take precedence over conflicting restrictions here. In particular, permission
+is granted to modify or replace LGPL-covered libraries, relink the accompanying
+application form with them for your own use, and reverse engineer the application
+solely to debug those library modifications. The included application bundle and
+RELINKING.md support that purpose; they do not confer a general source license.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO MERCHANTABILITY, FITNESS FOR A PARTICULAR
+PURPOSE AND NONINFRINGEMENT. TO THE MAXIMUM EXTENT PERMITTED BY LAW, THE AUTHORS
+AND COPYRIGHT HOLDERS SHALL NOT BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR ITS USE.

package/README.md

@@ -1,3 +1,37 @@
-# Temporary Holding Version
+# Ntfyx
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+End-to-end encrypted notifications and one-time replies for command-line tools and AI agents.
+
+## Install
+
+Requires Node.js 24 or newer. Supports macOS and Linux with glibc on Apple Silicon/ARM64 and x64. Windows and Linux with musl are not supported by this release.
+
+```sh
+npm install -g ntfyx
+ntfyx --help
+ntfyx version --json
+```
+
+The npm package downloads the matching official binary from `https://ntfyx.me/releases/0.1.4/` during installation. It verifies the release manifest signature, download size, SHA-256 digest, and binary version before installing. An internet connection and permission to run the package's installation script are required. If installation scripts are disabled, follow the [standalone installation instructions](https://ntfyx.me/install).
+
+## Get started
+
+Install the Ntfyx phone app, then pair this computer by scanning the QR code and approving it on your phone:
+
+```sh
+ntfyx connect
+ntfyx send "Build finished"
+ntfyx ask "Continue?" --allow-deny --async --json
+```
+
+Use the returned request ID to read a reply:
+
+```sh
+ntfyx result REQUEST_ID --json
+```
+
+See the [documentation](https://ntfyx.me/docs/) for setup, agent integrations, and security details.
+
+## License
+
+Ntfyx is distributed under the included proprietary [LICENSE](LICENSE). Third-party components retain their own licenses; see `THIRD_PARTY_NOTICES.txt` and `RELINKING.md`. The package includes `ntfyx-runtime-entry.mjs` for the runtime replacement described there.

package/RELINKING.md

@@ -0,0 +1,35 @@
+# Replacing LGPL runtime libraries
+
+ntfyx-runtime-entry.mjs is the complete bundled application form for this release,
+including the release public key and runtime dependencies. The private signing key
+is never included. It can run on a compatible replacement Bun runtime:
+
+```sh
+/path/to/modified/bun ./ntfyx-runtime-entry.mjs version --json
+/path/to/modified/bun ./ntfyx-runtime-entry.mjs help
+```
+
+The original runtime is Bun 1.4.2. Its complete source, build instructions and
+third-party source revisions are published at:
+https://github.com/oven-sh/bun/tree/bun-v1.4.2
+https://github.com/oven-sh/bun/blob/bun-v1.4.2/CONTRIBUTING.md
+
+To change the LGPL JavaScriptCore/WebKit library, use the upstream Bun source at
+that tag, clone https://github.com/oven-sh/WebKit into vendor/WebKit, run
+`bun sync-webkit-source` (which checks out the WEBKIT_VERSION pinned in
+`scripts/build/deps/webkit.ts`), make your modifications, then run
+`bun run build:local`. See the included upstream Bun license for its instructions.
+For other LGPL components, use the revisions and build configuration in that Bun
+source tree. Source provenance is supplied with this distribution; no local
+ntfyx modifications were made to Bun, WebKit or TinyCC.
+
+Run the supplied application form with your resulting runtime. Bundling it into
+a standalone executable is optional; a standard prebuilt-target Bun --compile
+can substitute an upstream runtime, so it is not proof that your library
+modifications were included. Running the bundle with your modified runtime avoids
+that substitution. Runtime replacement may affect correctness and Apple trust.
+
+The ntfyx license permits library replacement/relinking and reverse engineering
+for debugging those modifications. It does not grant a general right to
+redistribute ntfyx proprietary source or modified ntfyx applications. Third-party
+licenses take precedence wherever required.