ntfyx 0.0.0-stage → 0.1.6

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,43 @@
-# 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.
+Send task completion notifications and answer agent questions from your phone.
+Agent and CLI messages are end-to-end encrypted. A Ntfyx phone app and an approved
+phone pairing are required before sending messages or using the MCP tools.
+
+Requires Node.js 24 or later and macOS (Apple silicon or Intel) or Linux glibc
+(x64 or arm64). Windows and musl Linux are not supported. Installation downloads
+the version-pinned binary from ntfyx.me and verifies its release signature and hash.
+
+```sh
+npm install -g ntfyx@0.1.6
+ntfyx connect
+ntfyx send "Task finished"
+ntfyx ask "Continue?" --allow-deny
+```
+
+Scan the connection QR code in Ntfyx and approve the connection on your phone.
+Keep the resulting local credentials on that machine.
+
+For an MCP client, first pair using `npx ntfyx@0.1.6 connect`, then configure:
+
+```json
+{
+  "mcpServers": {
+    "ntfyx": {
+      "command": "npx",
+      "args": ["-y", "ntfyx@0.1.6", "mcp"]
+    }
+  }
+}
+```
+
+The MCP server uses local stdio and the local paired identity. It does not offer
+a hosted MCP endpoint. Native tool approval is separate from MCP questions:
+Apple silicon Mac validation covers Claude Code 2.1.303 and Codex 0.163.0 with
+CLI 0.1.5 or later; Intel Mac native approval remains unverified and returns to
+the terminal. Claude permission hooks require explicit `--permissions on` during
+setup. Codex requires interactive TUI and `/hooks` trust; `codex exec` does not
+trigger permission hooks.
+
+[Installation and signed downloads](https://ntfyx.me/install) ·
+[Agent setup and limits](https://ntfyx.me/docs/agents)

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.