mellos-mapping 0.23.0 → 0.25.0

package/README.md

@@ -61,7 +61,11 @@ Clone the branch for your host, then run one command. No build is required.
 | `claude` | Claude Code | `node install.mjs` |
 | `chatgpt-app` | ChatGPT desktop, Codex mode | `node install.mjs` |
 
-Requires Node.js 18+ and the corresponding host CLI on PATH. The installer checks
+Requires Node.js 18.17+ on the 18.x line, or 20.3+, and the corresponding host CLI
+on PATH. Supported platforms are Windows 10+, macOS 13.0+ and Linux with glibc
+2.28+, each on x64 or arm64. The OS must also meet the selected Node.js version's
+requirements. Native lock bindings ship with the release; no local compilation
+is needed. The installer checks
 release integrity and all eight MCP tools, retains the runtime outside the clone,
 and configures the host. Start a new conversation after installation.
 See [release and branch instructions](docs/releasing.md).
@@ -81,7 +85,9 @@ Or one line in a terminal:
 claude plugin marketplace add GuangminJu/mellos-mapping && claude plugin install mellos-mapping@mellos-mapping
 ```
 
-Requires Node.js 18+ on PATH (install Node separately when using native Claude Code). No build step: `dist/` is committed, so a clone runs as-is —
+Requires the same [Node.js and platform versions](#install) on PATH (install
+Node separately when using native Claude Code). No build step: `dist/` is
+committed, so a clone runs as-is —
 `dist/server.mjs` (the MCP server), `dist/watch.mjs` (the pane),
 `dist/mmap.mjs` (the `mmap` toggle), `dist/hook-session-start.mjs` (the
 `SessionStart` hook that `hooks/hooks.json` registers) and
@@ -446,19 +452,31 @@ State lives in the tool-owned `.mellos/` directory at the project root:
 | `.mellos/quit` | one-shot "close yourself" request from the `mmap` toggle, consumed and deleted the same way |
 | `.mellos/viewers/<pid>.json` | one report per live pane — the page it is showing, whether auto-follow is on — refreshed every second while it runs (see [Who is watching](#who-is-watching)) |
 | `<any of the above>.<pid>.<random>.tmp` | a save in flight; it is renamed over its target or removed. A leftover means a write failed (and was reported) and even its cleanup could not run |
+| `.mellos/.write-lock` | permanent regular file for the OS project lock; keep it untracked and never remove, rename or replace it during normal operation |
 
 The map files are plain JSON, safe to commit if you want the maps' history in
-git. The other three are runtime chatter between a pane and whoever is talking
-to it — gitignore `focus`, `quit` and `viewers/` if you commit the store.
+git. Keep `focus`, `quit`, `viewers/` and `.write-lock` out of Git. The first
+three carry runtime messages; the lock file must remain in place, including
+when no process holds its lock.
 
 **Concurrency, stated plainly.** Every save is atomic — written to a private
 sibling temp file and renamed over the target — so a reader polling the store
-sees the previous complete map or the new one, never a torn write. There is
-no lost-update protection: two writers saving the *same* page race, and the
-last rename wins, silently discarding what the other computed from an older
-read. Pages are the isolation unit — two sessions that must not clobber each
-other belong on two pages, which is also the answer to running several Claude
-sessions in one project.
+sees the previous complete map or the new one, never a torn write. Every graph
+writer (MCP, the HTTP viewer, the watcher) uses the same non-blocking OS
+exclusive lock for the project. The lock has its own fixed file, separate from
+the map files being replaced; it stays in place after the OS releases the lock
+on completion or process exit. Contention returns a retryable `BUSY`.
+
+The lock serializes each operation's read, change and save. To protect an edit
+computed from an earlier read, pass `expectedRevision`: it is compared inside
+the lock, and a stale revision returns `CONFLICT`. Without it, a later write
+can still overwrite the same field or a whole value such as `context`. Pages
+separate unrelated efforts; sharing a page still requires revision-checked
+edits. Low-level `saveMapFile`, hand edits and older running processes do not
+participate in this contract. Stop all old MCP, viewer and watcher processes
+for the project before upgrading; an old lock directory needs a one-time
+migration. See the [persistent-map API guide](docs/map-api.md) and
+[project locking](docs/locking.md) for the boundary and upgrade steps.
 
 ### Diagram kinds
 
@@ -661,6 +679,26 @@ by a test, so a graphical client (a web panel, an editor view) can parse state
 files and reuse the exact aggregation, zoom and glyph semantics the terminal
 pane draws with.
 
+## Optional GitHub Star reminder
+
+npm/npx installations may show one small, dismissible reminder after at least
+7 days and successful map viewing on 3 different UTC dates. Web viewers show
+it inline without taking focus; a native interactive terminal shows it only
+after a successful viewing session exits. It is never added to MCP replies,
+AI prompts, install logs, CI or piped output. Plugin editions and source
+checkouts are excluded.
+
+The reminder is claimed once per user, across projects, versions and installs.
+The Star button opens GitHub in the system's default browser, keeping its
+existing sign-in session. A failed launch leaves the notice open with a copy-address option.
+Closing it, following its Star link, or simply leaving the session means it
+will not appear again. To suppress it before it appears, set
+`MELLOS_MAPPING_NO_STAR=1` in the environment of the viewer/MCP process.
+Only the first-use time, last UTC day, a capped day count and the one-time flag
+are stored in `~/.mellos/support/star-reminder.json`; nothing is uploaded and
+GitHub is contacted only when the user follows the link. Unreadable settings
+or a busy store silently skip the reminder.
+
 ## License
 
 MIT

package/README.zh-CN.md

@@ -54,7 +54,10 @@ Claude 为你构建系统时，对话旁边的分屏实时显示这个系统的*
 | `claude` | Claude Code | `node install.mjs` |
 | `chatgpt-app` | ChatGPT 桌面 App 的 Codex 模式 | `node install.mjs` |
 
-前置要求为 Node.js 18+ 和对应宿主的 CLI，并确保命令在 PATH 中。安装器检查
+前置要求为 Node.js 18.17 及以上的 18.x，或 20.3 及以上版本，以及对应宿主的 CLI，
+并确保命令在 PATH 中。支持 Windows 10+、macOS 13.0+ 和 glibc 2.28+ 的 Linux，均支持
+x64 与 arm64；系统还须满足所选 Node.js 版本的更高要求。发行包自带原生锁绑定，
+无需用户本地编译。安装器检查
 发行文件和八个 MCP 工具，将运行时保留到克隆目录之外，完成宿主配置。
 安装后开启新对话。详见[发布与分支说明](docs/releasing.md)。
 
@@ -73,7 +76,8 @@ Claude Code 也可以通过插件市场安装：
 claude plugin marketplace add GuangminJu/mellos-mapping && claude plugin install mellos-mapping@mellos-mapping
 ```
 
-需要 PATH 上有 Node.js 18+（Claude Code 本身就依赖 Node，所以你已经有了）。
+需要 PATH 上有符合[安装要求](#安装)的 Node.js；使用原生 Claude Code 安装包时也需
+单独安装 Node.js。
 没有构建步骤：`dist/` 是提交进仓库的，克隆即用——`dist/server.mjs`（MCP
 服务器）、`dist/watch.mjs`（面板）、`dist/mmap.mjs`（`mmap` 开关）、
 `dist/hook-session-start.mjs`（由 `hooks/hooks.json` 注册的 `SessionStart`
@@ -405,17 +409,26 @@ watcher 的：`--file <path>` 指定默认页的状态文件（启动脚本会
 | `.mellos/quit` | `mmap` 开关发出的一次性"自己关掉"请求，以同样的方式被消费和删除 |
 | `.mellos/viewers/<pid>.json` | 每个活着的面板一份报告——它正显示哪一页、自动跟随是否打开——运行期间每秒刷新一次（见[谁在看](#谁在看)） |
 | `<上面任一文件>.<pid>.<随机>.tmp` | 正在落盘的一次写入；它要么被改名覆盖目标，要么被删掉。留下来说明那次写入失败（并已被报告），连清理都没能跑成 |
+| `.mellos/.write-lock` | 操作系统项目锁使用的永久普通文件；不纳入 Git，正常运行时不得删除、改名或替换 |
 
-地图文件是纯 JSON，想在 git 里留下地图的历史就把它们提交进去。另外三个是
-面板和跟它说话的人之间的运行期闲聊——如果你要提交这个仓库，把 `focus`、
-`quit` 和 `viewers/` 加进 gitignore。
+地图文件是纯 JSON，想在 git 里留下地图的历史就把它们提交进去。`focus`、`quit`、
+`viewers/` 和 `.write-lock` 应加入 gitignore。前三者传递运行期消息；锁文件即使
+没有进程持锁也应保留，不要当作临时文件清理。
 
 **并发模型，直说。** 每次保存都是原子的——先写进一个私有的同级临时文件，
 再改名覆盖目标——所以轮询存储的读者要么看到上一张完整的地图，要么看到新的
-那张，绝不会读到写了一半的。但**没有丢失更新保护**：两个写者保存*同一页*
-就是在赛跑，最后那次改名赢，另一个基于旧读取算出来的东西被静默丢弃。页就是
-隔离单位——不许互相覆盖的两个会话，就该在两页上，这也是同一项目里跑多个
-Claude 会话的正确姿势。
+那张，绝不会读到写了一半的。所有写图入口（MCP、HTTP 查看器、watcher）都使用
+同一把项目级、非阻塞的操作系统排他锁。锁使用独立的固定文件，与被原子替换的
+地图文件分开；操作结束或进程退出后，操作系统释放锁，锁文件仍保留。锁被占用时
+返回可重试的 `BUSY`。
+
+这把锁串行执行每次操作的读取、修改和保存。基于先前读取计算的改动还应传入
+`expectedRevision`：它在锁内比较，版本过旧返回 `CONFLICT`。省略它时，后续写入
+仍可能覆盖同一字段或 `context` 这样的完整值。不同页面用于分开互不相关的工作；
+共用一页时仍需带版本检查。底层 `saveMapFile`、手工编辑和仍在运行的旧进程不参与
+这份约定。升级前须停掉该项目所有旧 MCP、查看器和 watcher 进程；残留的旧锁目录
+需一次性迁移。完整边界和升级步骤见[持久化地图 API 指南](docs/map-api.md)与
+[项目锁说明](docs/locking.md)。
 
 ### 图种
 
@@ -596,6 +609,22 @@ npm run verify
 守护——图形客户端（web 面板、编辑器视图）可以直接解析状态文件，并复用与
 终端面板完全一致的聚合、缩放与字形语义。
 
+## 可选的 GitHub Star 提醒
+
+仅 npm/npx 安装会在首次成功查看地图满 7 天、且已在至少 3 个不同 UTC 日期
+成功查看地图后，显示一次轻提示。网页中是一行可关闭的文字，不抢焦点；
+原生交互终端只在正常退出地图后提示。MCP 返回、AI 提示词、安装日志、CI
+及管道输出中都不会加入提醒，插件版和源码运行也不触发。
+
+Star 按钮会调用系统默认浏览器打开 GitHub，方便沿用已有登录状态。
+若未能打开，会保留提示并提供复制地址按钮。
+提醒按用户跨项目、版本及安装去重，一生效就记为已提醒。关闭、点击 Star
+或直接离开后，都不会再次出现。想提前关闭，可在启动地图或 MCP 的环境中
+设置 `MELLOS_MAPPING_NO_STAR=1`。
+仅在 `~/.mellos/support/star-reminder.json` 本地记录首次使用时间、最后一个
+UTC 日期、最多 3 天的计数和已提醒标记，不上传数据，不查询是否点过 Star；
+只有用户主动点击链接时才访问 GitHub。设置损坏、不可写或锁忙时静默跳过。
+
 ## 许可证
 
 MIT

package/dist/hook-session-start.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import { createRequire as __mellosCreateRequire } from 'node:module'; const require = __mellosCreateRequire(import.meta.url);
 
 // src/hook/session-start.ts
 import { spawnSync } from "node:child_process";

package/dist/native/LICENSES.txt

@@ -0,0 +1,443 @@
+fs-native-extensions@1.5.1
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+
+which-runtime@1.4.0
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+
+fs-native-extensions
+https://github.com/holepunchto/fs-native-extensions/blob/main/NOTICE
+
+Copyright 2023 Holepunch Inc
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+which-runtime
+https://github.com/holepunchto/which-runtime/blob/main/NOTICE
+
+Copyright 2023 Contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.