Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
docs(license): switch to PolyForm Noncommercial and add per-repo references (#155)
Abdurrahman Fakhrul8d4b8e1c898e
diff --git a/LICENSE b/LICENSEindex 9715401d..d5da9e30 100644--- a/LICENSE+++ b/LICENSE@@ -1,21 +1,84 @@-MIT License--Copyright (c) 2026 rahmanef63--Permission is hereby granted, free of charge, to any person obtaining a copy-of this software and associated documentation files (the "Software"), to deal-in the Software without restriction, including without limitation the rights-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell-copies of the Software, and to permit persons to whom the Software is-furnished to do so, subject to the following conditions:--The above copyright notice and this permission notice shall be included in all-copies or substantial portions of the Software.--THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE-SOFTWARE.+# PolyForm Noncommercial License 1.0.0++<https://polyformproject.org/licenses/noncommercial/1.0.0>++Required Notice: Copyright 2026 rahmanef63 (https://github.com/rahmanef63)++## Acceptance++In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.++## Copyright License++The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose. However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).++## Distribution License++The licensor grants you an additional copyright license to distribute copies of the software. Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).++## Notices++You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software. For example:++> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)++## Changes and New Works License++The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.++## Patent License++The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.++## Noncommercial Purposes++Any noncommercial purpose is a permitted purpose.++## Personal Uses++Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.++## Noncommercial Organizations++Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.++## Fair Use++You may have "fair use" rights for the software under the law. These terms do not limit them.++## No Other Rights++These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else. These terms do not imply any other licenses.++## Patent Defense++If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.++## Violations++The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice. Otherwise, all your licenses end immediately.++## No Liability++***As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.***++## Definitions++The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.++**You** refers to the individual or entity agreeing to these terms.++**Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.++**Your licenses** are all the licenses granted to you for the software under these terms.++**Use** means anything you do with the software requiring one of your licenses.++---++## Addendum from the licensor++Commercial use is not permitted by these terms. The licensor may grant a separate+commercial license on written terms; see [`LICENSE-EXCEPTION.md`](./LICENSE-EXCEPTION.md).+That exception is discretionary and is never implied by possession of this file.+diff --git a/LICENSE-EXCEPTION.md b/LICENSE-EXCEPTION.mdnew file mode 100644index 00000000..6751478e--- /dev/null+++ b/LICENSE-EXCEPTION.md@@ -0,0 +1,51 @@+# Commercial exception++MSO is licensed under [PolyForm Noncommercial 1.0.0](./LICENSE). That license does not+permit commercial use.++This file records a separate, discretionary exception offered by the licensor.++## Grant++The licensor, rahmanef63, may grant a commercial license covering the same software on+terms agreed in writing. Such a license is separate from, and additional to, the+PolyForm Noncommercial license. It is not automatic and is not implied by:++- a public fork, mirror or archive of this repository;+- a copy obtained under the earlier MIT grant;+- possession of this file;+- any statement in the documentation describing commercial capability of the software.++## What a commercial license covers++Only what the written grant names. At minimum it should state:++| Field | Meaning |+|---|---|+| Scope | which versions, commits or artifacts are covered |+| Rights | install, run, modify, distribute, or host for third parties |+| Parties | the named licensee and any affiliates |+| Term | start, duration and termination conditions |+| Fee | amount or "no fee", so the arrangement is unambiguous |++## What this exception does not do++- It does not weaken the PolyForm Noncommercial license for anyone else. Personal,+ study, hobby, research and noncommercial-organization use continues under that+ license without asking.+- It does not revoke the permanent MIT grant on commits made before the license change.+ See [`docs/LICENSE-HISTORY.md`](./docs/LICENSE-HISTORY.md).+- It does not grant rights over third-party work listed in+ [`LICENSES/THIRD-PARTY-NOTICES.md`](./LICENSES/THIRD-PARTY-NOTICES.md). A commercial+ licensee still owes those upstream projects their own license terms — for example+ Apache-2.0 notice obligations for the mirrored theme registry, or a commercial n8n+ agreement if n8n is ever bundled rather than framed.++## How to request++Open an issue or contact the licensor through the address on the repository profile.+State the intended use, the versions involved, and whether the software will be+redistributed or offered to third parties as a service.++> Plain-language record, not legal advice. A commercial grant is only effective when+> the licensor issues it in writing.diff --git a/LICENSES/Apache-2.0.txt b/LICENSES/Apache-2.0.txtnew file mode 100644index 00000000..d6456956--- /dev/null+++ b/LICENSES/Apache-2.0.txt@@ -0,0 +1,202 @@++ 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.diff --git a/LICENSES/THIRD-PARTY-NOTICES.md b/LICENSES/THIRD-PARTY-NOTICES.mdnew file mode 100644index 00000000..7296ea46--- /dev/null+++ b/LICENSES/THIRD-PARTY-NOTICES.md@@ -0,0 +1,45 @@+# Third-party notices++MSO itself is licensed under [PolyForm Noncommercial 1.0.0](../LICENSE). This file+records the licenses of other work that MSO depends on, vendors, or mirrors. The+per-project analysis lives in [`../docs/references/`](../docs/references/README.md).++## Bundled or mirrored content++| Artifact in this repo | Upstream | License | Notice |+|---|---|---|---|+| `lib/appearance/presets/registry-data.json` | [jnsahaj/tweakcn](https://github.com/jnsahaj/tweakcn) | Apache-2.0 | [`Apache-2.0.txt`](./Apache-2.0.txt) |+| `components/ui/*` | [shadcn-ui/ui](https://github.com/shadcn-ui/ui) | MIT | copied in as application source; see [`docs/references/shadcn-ui.md`](../docs/references/shadcn-ui.md) |+| `lib/infra/provider-icons.ts` | [simple-icons/simple-icons](https://github.com/simple-icons/simple-icons) | CC0-1.0 | path data only; brand trademarks stay with their owners |+| `frontend/slices/icon-picker/lib/twemoji.ts` | [jdecked/twemoji](https://github.com/jdecked/twemoji) | MIT (code) + CC-BY 4.0 (assets) | assets hot-linked from jsDelivr, not redistributed here |++## Pinned artifacts downloaded at install time, not committed++| Runtime | Upstream | License | Pin |+|---|---|---|---|+| Camoufox browser | [daijro/camoufox](https://github.com/daijro/camoufox) | MPL-2.0 | `v156.0.1-beta.36`, SHA-256 in `scripts/camoufox-artifact.json` |+| Orca IDE | [stablyai/orca](https://github.com/stablyai/orca) | MIT | `v1.4.230`; upstream LICENSE and THIRD_PARTY_NOTICES extracted and digest-checked by `scripts/orca/asar-license.mjs` |+| 9Router | [decolua/9router](https://github.com/decolua/9router) | MIT | image digest in `security/managed-app-artifacts.env` |+| Hermes Agent | [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent) | MIT | operator-installed |+| OpenClaw | [openclaw/openclaw](https://github.com/openclaw/openclaw) | MIT | operator-installed |+| OSV-Scanner | [google/osv-scanner](https://github.com/google/osv-scanner) | Apache-2.0 | image digest in `.github/workflows/security-core.yml` |++## Installed from npm, not vendored++`node_modules` is resolved from `bun.lock`; nothing under it is committed. The direct+dependency set is MIT, Apache-2.0, ISC and BSD. Two transitive packages ship under+LGPL-3.0-or-later (`@img/sharp-libvips-linux-x64`, `@img/sharp-libvips-linuxmusl-x64`);+they are loaded dynamically by `sharp` and are not modified or statically linked by MSO.++## Named for comparison only++Cockpit, Coolify, Portainer, Netdata, Tailscale SSH, File Browser, ttyd, CasaOS and+Runtipi appear in [`../docs/COMPARISON.md`](../docs/COMPARISON.md) as documented+competitors. None of their code is present here. See+[`docs/references/comparison-only.md`](../docs/references/comparison-only.md) for the+per-project license list, which includes GPL-3.0 projects that must not be bundled+without a compliance review.++n8n is licensed under the Sustainable Use License (fair-code). MSO bundles no n8n code+and only frames an operator-supplied instance; see+[`docs/references/n8n.md`](../docs/references/n8n.md).diff --git a/README.md b/README.mdindex 0d1148da..eda26b8c 100644--- a/README.md+++ b/README.md@@ -116,4 +116,4 @@ Successful analysis jobs are not proof of zero open alerts; the security badge a[Product comparison, evidence and limitations](docs/COMPARISON.md) · reviewed 2026-09-17.<!-- comparison:end -->-[MIT license](./LICENSE) · [Detailed workspace guide](./docs/reference/WORKSPACE-GUIDE.md)+[PolyForm Noncommercial 1.0.0](./LICENSE) · [Commercial exception available](./LICENSE-EXCEPTION.md) · [Third-party notices](./LICENSES/THIRD-PARTY-NOTICES.md) · [Detailed workspace guide](./docs/reference/WORKSPACE-GUIDE.md)diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.mdindex e38d5c57..72876ffe 100644--- a/docs/CHANGELOG.md+++ b/docs/CHANGELOG.md@@ -8,15 +8,11 @@ this is the *what*, and it is what Settings → Account → About shows as “Wh**Added**-- `agent` one live activity row and env-tunable turn budgets--**Fixed**--- `settings` only grade an update after the request actually starts+- `agent` one live activity row and env-tunable turn budgets (#154)**Docs**-- `progress` record the agent live-row and turn-budget change+- `license` switch to PolyForm Noncommercial and add per-repo references## 2026-10-24diff --git a/docs/LICENSE-HISTORY.md b/docs/LICENSE-HISTORY.mdnew file mode 100644index 00000000..e13693ce--- /dev/null+++ b/docs/LICENSE-HISTORY.md@@ -0,0 +1,50 @@+# License and prior grants++> This file is a plain-language record, not legal advice. It describes what happened to+> this repository's licensing so a future reader is not misled.++## Current license++From the commit that introduced this file, MSO is licensed under+[PolyForm Noncommercial 1.0.0](../LICENSE): personal, hobby, research, study and+noncommercial-organization use is permitted; commercial use is not.++A separately issued [commercial exception](../LICENSE-EXCEPTION.md) can cover+commercial use, but only when the licensor grants it in writing. Nothing in this+repository grants it automatically.++See [`LICENSES/THIRD-PARTY-NOTICES.md`](../LICENSES/THIRD-PARTY-NOTICES.md) for the+licenses of work MSO depends on, vendors or mirrors.++## Prior MIT grant (cannot be revoked)++Everything committed before this change was released under the MIT License+(© 2026 rahmanef63). Those grants are permanent for the code at those commits:++- Anyone who obtained a copy under MIT keeps MIT rights over **that copy**.+- Existing forks — 16 at the time of the change — remain MIT and need no new permission.+- The MIT text for that history is recoverable with+ `git show <commit-before-this-file>:LICENSE`.+- New commits and future releases are under PolyForm Noncommercial only.++Nothing in this repository can retroactively restrict a MIT grant that was already+made. A license change is prospective.++## Contribution status to review before relying on this license++Git history contains commits authored or co-authored by parties other than the+licensor. Each needs a recorded answer before the noncommercial license can be+described as covering all code in the tree:++| Author identity | Commits | Note |+|---|---|---|+| `xdproject001 <[email protected]>` | 1 (`2fd17364`, 2026-09-20, 7 files under `frontend/slices/appshell` and `assistant`) | external author; needs confirmation that the contribution may be relicensed |+| `Claude`, `Claude Fable`, `Claude Opus 5` (co-author trailers) | 70+ | AI-assisted; output ownership depends on the provider's terms in force at that time |+| `ChatGPT <[email protected]>`, `Codex` | 3 | AI-assisted |+| `Cursor Agent <[email protected]>`, `cursor[bot]` | 10+ | AI-assisted |+| `opencode-worker <opencode@local>` | 42 | local tooling identity |+| `dependabot[bot]` | 32 | dependency bumps only |++Open question for the licensor: obtain a written relicensing confirmation from any+human external contributor, and record it here. Until then this file names the gap+rather than claiming it is closed.diff --git a/docs/N8N-PARITY.md b/docs/N8N-PARITY.mdindex 6fe9d4a6..5353c220 100644--- a/docs/N8N-PARITY.md+++ b/docs/N8N-PARITY.md@@ -8,6 +8,12 @@ page the source of truth for MSO.This document maps the core self-hosted n8n capability areas to their MSO-nativecounterparts. The goal is capability coverage, not pixel-for-pixel or API-for-API cloning.+n8n is licensed under the **Sustainable Use License (fair-code)**, not an OSI license.+MSO bundles no n8n code, source, node definitions or image; the optional n8n window+renders an operator-supplied instance in a frame. See+[`references/n8n.md`](./references/n8n.md) before considering any bundling or hosted+resale.+| n8n capability area | Native MSO surface | MSO implementation ||---|---|---|| Workflow list/search | Workflows | Searchable workflow library with status, project, folder, node and tag filters |diff --git a/docs/README.md b/docs/README.mdindex 893db205..9073cca9 100644--- a/docs/README.md+++ b/docs/README.md@@ -36,6 +36,8 @@ evidence and review freshness. The repository quality gate runs both automatical| [`AGENT-VAULT.md`](./AGENT-VAULT.md) | Separate private repository agent-progress vaults, source/data boundaries and Obsidian use || [`MEMORY-SAFETY.md`](./MEMORY-SAFETY.md) | Session-source preservation, owner cleanup previews, local memory backups, learning/discovery visibility and remaining limits || [`COMPARISON.md`](./COMPARISON.md) | Generated product comparison methodology, evidence and notes |+| [`references/README.md`](./references/README.md) | One file per upstream project MSO studies or pins: license, pin, what was used and what was not copied |+| [`LICENSE-HISTORY.md`](./LICENSE-HISTORY.md) | Current PolyForm Noncommercial license, the permanent prior MIT grant, and open contribution questions || [`COMPETITIVE-ROADMAP.md`](./COMPETITIVE-ROADMAP.md) | Executed comparison plan, deliberate specialist boundaries and next investments || [`INSTALL.md`](./INSTALL.md) | Owner installation, TLS, updates, backup and uninstall || [`PLATFORMS.md`](./PLATFORMS.md) | Linux/macOS/Windows/Android/iOS support modes and machine adapters |diff --git a/docs/references/9router.md b/docs/references/9router.mdnew file mode 100644index 00000000..059e008c--- /dev/null+++ b/docs/references/9router.md@@ -0,0 +1,26 @@+# decolua/9router++| | |+|---|---|+| License | MIT |+| Pin | image digest `decolua/9router@sha256:f00fe389ef41a1999dd0d0275ad0c2955d13d176f7c4c5cb844b2f88c293c471` |+| Relation | managed model-router application |+| Code copied | none |++## What MSO uses++A lifecycle adapter, not the upstream CLI. [`../../scripts/managed-app-9router`](../../scripts/managed-app-9router)+refuses any image reference that is not an immutable `@sha256:` digest, binds to+loopback unless explicitly exposed, and speaks the documented+`--version` / `check` / `update` / `uninstall` contract. The digest lives in+`security/managed-app-artifacts.env`.++[`../9ROUTER-INTEGRATION.md`](../9ROUTER-INTEGRATION.md) and+[`../9ROUTER-MSO-APPHOST-RFC.md`](../9ROUTER-MSO-APPHOST-RFC.md) record the dashboard+boundary and the conditions under which MSO may skip a separate 9Router login.++## Evidence++No 9Router source or image is committed here. MSO installs from the pinned digest at+the operator's request. The public endpoint, when enabled, exposes only `/v1` through+the gateway; the dashboard is not internet-exposed by default.diff --git a/docs/references/README.md b/docs/references/README.mdnew file mode 100644index 00000000..047f9088--- /dev/null+++ b/docs/references/README.md@@ -0,0 +1,38 @@+# Upstream references++One file per upstream project MSO studies, compares against, or ships a pinned+artifact from. Each file states the license, the exact pin, what MSO actually+used, what MSO did **not** copy, and where the attribution lives in this repo.++This directory is a study log, not a compatibility claim. A row marked+`docs only` means the project is named in documentation and no artifact from it+is present in this repository.++## Index++| Project | License | Relation | Code copied | Status |+|---|---|---|---|---|+| [nakama](./nakama.md) | MIT | parity contract, 64 requirements | no | pinned + hashed |+| [open-silong](./open-silong.md) | MIT | memory-graph layout ideas | no | attributed in code |+| [tweakcn](./tweakcn.md) | Apache-2.0 | theme preset registry mirror | data | attributed in code |+| [n8n](./n8n.md) | Sustainable Use (fair-code) | capability map, iframe embed | no | attributed in docs |+| [camoufox](./camoufox.md) | MPL-2.0 | managed browser runtime | no | pinned + hashed |+| [orca](./orca.md) | MIT | managed IDE runtime | no | pin + license retained |+| [hermes-agent](./hermes-agent.md) | MIT | managed app, benchmark peer | no | attributed in docs |+| [openclaw](./openclaw.md) | MIT | managed app, comparison peer | no | attributed in docs |+| [9router](./9router.md) | MIT | managed app | no | pin by digest |+| [proot-distro](./proot-distro.md) | GPL-3.0 | Android runtime prerequisite | no | docs only |+| [shadcn-ui](./shadcn-ui.md) | MIT | UI primitives | yes | attributed in code |+| [twemoji](./twemoji.md) | MIT + CC-BY 4.0 | emoji CDN URLs | no | attributed in code |+| [simple-icons](./simple-icons.md) | CC0-1.0 | provider SVG paths | yes | attributed in code |+| [comparison-only](./comparison-only.md) | mixed | product comparison claims | no | docs only |++## Rules for adding a row++1. Name the license and the exact pin (commit, tag, release, or image digest).+2. Say what MSO used: idea, contract, data, or code.+3. If any byte from the upstream landed in this repo, the attribution must exist+ in the repo, not only here.+4. `docs only` rows must point at an official upstream URL in+ [`../comparison-data.json`](../comparison-data.json) so the 90-day freshness+ gate keeps the claim honest.diff --git a/docs/references/camoufox.md b/docs/references/camoufox.mdnew file mode 100644index 00000000..a5cae618--- /dev/null+++ b/docs/references/camoufox.md@@ -0,0 +1,33 @@+# daijro/camoufox++| | |+|---|---|+| License | MPL-2.0 |+| Pin | release `v156.0.1-beta.36` |+| Relation | managed anti-detect browser runtime behind the split-origin viewer |+| Code copied | none |++## What MSO uses++A downloaded, hash-pinned release archive. [`../../scripts/camoufox-artifact.json`](../../scripts/camoufox-artifact.json)+records the exact URL, archive SHA-256 and installed file-tree digest per+architecture (`x86_64`, `arm64`). Installation verifies before extraction into+private versioned state and re-verifies files, ownership, permissions and+regular-file boundaries before each launch.++`lib/camoufox/` (13 modules) is MSO-native: origin split, session-cookie scope,+viewer gate, transport and path mapping to loopback noVNC. None of it is Camoufox+source.++## MPL-2.0 boundary++MPL is file-level copyleft. MSO does not modify or redistribute Camoufox files;+it downloads an unmodified upstream archive at install time and verifies it. If a+future change patches Camoufox source, those patched files must be published under+MPL-2.0. The browser binary is not committed to this repository.++## Evidence++`grep -r camoufox lib scripts` returns MSO adapters, the artifact pin, and docs only.+The noVNC viewer is served from a reserved split-origin host so third-party+keyboard/mouse access never shares the cockpit origin.diff --git a/docs/references/comparison-only.md b/docs/references/comparison-only.mdnew file mode 100644index 00000000..b33c3ee1--- /dev/null+++ b/docs/references/comparison-only.md@@ -0,0 +1,35 @@+# Comparison-only references++Projects named in [`../COMPARISON.md`](../COMPARISON.md) and+[`../comparison-data.json`](../comparison-data.json) to position MSO honestly. None+of their code is present in this repository. Every claim cites an official upstream URL+and is re-reviewed under a 90-day freshness gate enforced by+`node scripts/gen-comparison.mjs --check`.++| Project | License | MSO use |+|---|---|---|+| [Cockpit](https://cockpit-project.org/) | mixed (LGPL-2.1 / GPL-3.0 / MIT / BSD-3 / CC-BY-SA-3.0 per component, see upstream `LICENSES/`) | comparison row only |+| [Coolify](https://coolify.io/docs) | Apache-2.0 | comparison row only |+| [Portainer](https://docs.portainer.io/) | zlib | comparison row only |+| [Netdata](https://learn.netdata.cloud/) | GPL-3.0 | comparison row only |+| [Tailscale SSH](https://tailscale.com/docs/features/tailscale-ssh) | BSD-3-Clause | comparison row only |+| [File Browser](https://github.com/filebrowser/filebrowser) | Apache-2.0 | comparison row only |+| [ttyd](https://github.com/tsl0922/ttyd) | MIT | comparison row only |+| [CasaOS](https://github.com/IceWhaleTech/CasaOS) | Apache-2.0 | comparison row only |+| [Runtipi](https://runtipi.io/) | GPL-3.0 | comparison row only |++## Why this file exists++A comparison table is commentary, not derivation: naming a GPL project and describing+its documented behaviour creates no obligation. It would change the moment MSO embedded+or redistributed one of these. If that ever happens, the project moves out of this file+into its own reference with the full license analysis.++## Also named for standards, not code++| Standard | Use |+|---|---|+| [MCP Apps (`modelcontextprotocol/ext-apps`)](https://github.com/modelcontextprotocol/ext-apps) | wire contract followed in [`../integrations/CHATGPT-UI.md`](../integrations/CHATGPT-UI.md); no helper code vendored |+| [Next.js](https://github.com/vercel/next.js) | framework, MIT, installed from npm |+| [Bun](https://github.com/oven-sh/bun) | runtime, installed from its own release channel |+| [OSV-Scanner](https://github.com/google/osv-scanner) | CI vulnerability scan, pinned by image digest in `security-core.yml` |diff --git a/docs/references/hermes-agent.md b/docs/references/hermes-agent.mdnew file mode 100644index 00000000..0e4af183--- /dev/null+++ b/docs/references/hermes-agent.md@@ -0,0 +1,33 @@+# NousResearch/hermes-agent++| | |+|---|---|+| License | MIT |+| Relation | one of MSO's two managed applications; benchmark peer |+| Code copied | none |++## What MSO uses++A managed-app adapter: [`../../lib/managed-apps/catalog.ts`](../../lib/managed-apps/catalog.ts)+declares the dashboard and gateway units, container names, dashboard URL, health+path and state directory. [`../HERMES-INTEGRATION.md`](../HERMES-INTEGRATION.md)+records the runtime identity and the rule that MSO does not scrape the vendor SPA+into launcher items.++Hermes is also a comparison peer in [`../COGNITIVE-RUNTIME.md`](../COGNITIVE-RUNTIME.md)+and the `bench:agents` corpus. [`../PROGRESS.md`](../PROGRESS.md) records that+comparison is refused when provider/model evidence does not match, and that MSO does+not mutate a competitor's credentials to manufacture comparability.++## What MSO uses from the sibling, and why it is not copying++`scripts/managed-app-install` writes `hermes-dashboard.service` itself because+upstream ships no installer for that unit. That is MSO's own unit file for a+third-party process, not an upstream file.++## Evidence++Shingle comparison of 2,496 MSO source files against 7,221 Hermes source files: the+only overlaps above 0.20 are `sheet.tsx`, `popover.tsx`, `dialog.tsx`, `scroll-area.tsx`+— shadcn/ui primitives present in both repositories from their own initial commits.+No Hermes module was transplanted.diff --git a/docs/references/n8n.md b/docs/references/n8n.mdnew file mode 100644index 00000000..3edfd098--- /dev/null+++ b/docs/references/n8n.md@@ -0,0 +1,27 @@+# n8n-io/n8n++| | |+|---|---|+| License | **Sustainable Use License (fair-code)**, not an OSI license |+| Relation | capability map against native Workflows; optional embedded editor |+| Code copied | none |++## What MSO uses++A capability map, not an implementation: [`../N8N-PARITY.md`](../N8N-PARITY.md)+lists 31 n8n capability areas against MSO-native surfaces. The dedicated n8n+window (`frontend/slices/n8n/`, 28 lines) renders an operator-supplied instance+inside `ExternalAppFrame`; MSO does not proxy or re-serve n8n content.++## Why the license matters here++The Sustainable Use License forbids offering the software to third parties as a+hosted service without a commercial agreement. MSO bundles no n8n code, ships no+n8n image, and only points an iframe at an instance the operator already runs.+Any future bundling, redistribution, or multi-tenant resale of n8n inside MSO+requires a commercial license from n8n GmbH.++## What MSO does not use++No n8n source, node definitions, workflow JSON schema, icons, or container image.+The Workflow Graph engine in `lib/workflow/` is MSO-native.diff --git a/docs/references/nakama.md b/docs/references/nakama.mdnew file mode 100644index 00000000..3ffc5f37--- /dev/null+++ b/docs/references/nakama.md@@ -0,0 +1,37 @@+# ahmadrosid/nakama++| | |+|---|---|+| License | MIT, © 2026 ahmadrosid |+| Pin | commit `f6c8f26f8a831e690016ec70429c3cb5cb114cec` |+| Relation | parity contract: 64 requirement groups, 24 packages, 8 stages, 30 acceptance journeys |+| Code copied | none |++## What MSO uses++Concept and behaviour contracts only. The frozen inventory is+[`../parity/nakama-v0.1.json`](../parity/nakama-v0.1.json), the status map is+[`../parity/nakama-implementation.json`](../parity/nakama-implementation.json),+the reference render is [`../NAKAMA-PARITY.md`](../NAKAMA-PARITY.md), and the+release gate rules are [`../parity/EVIDENCE.md`](../parity/EVIDENCE.md).++## What MSO does not use++No source file, string, asset, logo or screenshot. `docs/parity/source-references.json`+records 100 file identities (69 Nakama, 31 MSO) so a reader can re-fetch the exact+bytes that were read. A hash proves which bytes were read, not that a feature works.++## Evidence++- `node scripts/check-nakama-parity.mjs` reports `59 pending, 5 partial, 0 implemented`.+- All 100 recorded SHA-256 values re-verified against both pinned commits: 0 mismatches.+- Shingle comparison of 2,830 MSO files against 1,524 Nakama source files: the only+ overlap above 0.25 is `components/ui/*`, which is shadcn/ui present in MSO's initial+ commit `71a4303` (2026-08-02), before parity work began on 2026-10-18.+- `grep -r nakama lib app frontend` returns nothing outside `scripts/parity/` and docs.++## Local study instance++A Nakama container runs at `127.0.0.1:4310` for comparison. It is not exposed+publicly and `~/.config/systemd/user/cloudflared-nakama.service` is not installed,+so no tunnel is serving it. MIT permits this without asking the author.diff --git a/docs/references/open-silong.md b/docs/references/open-silong.mdnew file mode 100644index 00000000..dc3502b8--- /dev/null+++ b/docs/references/open-silong.md@@ -0,0 +1,28 @@+# rahmanef63/open-silong++| | |+|---|---|+| License | MIT |+| Relation | layout ideas for the owner Memory graph |+| Code copied | none, reimplemented |++## What MSO uses++Graph interaction ideas: ghost nodes for unresolved `[[wikilinks]]`, undirected+link traversal, web/radial/layered layouts, a local hop neighbourhood, and+folder/project colour grouping. The MSO implementation is native.++## Attribution++Already in the repository, four places:++- [`../ARCHITECTURE.md`](../ARCHITECTURE.md) — Memory app section+- [`../MEMORY-GRAPH.md`](../MEMORY-GRAPH.md) — layout credit+- `lib/memory-graph/assemble.ts` — file header+- `lib/memory-graph/types.ts` — file header++## Evidence++Shingle comparison of `lib/memory-graph/` and `frontend/slices/memory-graph/`+against 1,010 open-silong source files: highest single-file overlap 0.07+(`layout.ts`), no transplanted file. MSO does not depend on Obsidian or Convex.diff --git a/docs/references/openclaw.md b/docs/references/openclaw.mdnew file mode 100644index 00000000..b17867c1--- /dev/null+++ b/docs/references/openclaw.md@@ -0,0 +1,27 @@+# openclaw/openclaw++| | |+|---|---|+| License | MIT |+| Relation | managed application; product comparison peer |+| Code copied | none |++## What MSO uses++A managed-app adapter only: unit names, container names, dashboard URL and state+directory in [`../../lib/managed-apps/catalog.ts`](../../lib/managed-apps/catalog.ts),+documented in [`../OPENCLAW-INTEGRATION.md`](../OPENCLAW-INTEGRATION.md).+`docs/PROGRESS.md` records one security fix that keeps OpenClaw provider keys out of+argv — an MSO-side hardening of how MSO launches a third-party process.++## Comparison boundary++[`../COMPARISON.md`](../COMPARISON.md) and [`../COGNITIVE-RUNTIME.md`](../COGNITIVE-RUNTIME.md)+name OpenClaw as a peer. Where a matched provider/model path was not available, the+benchmark emits no ranking rather than an unfair one, and MSO does not edit+OpenClaw's configuration to create comparability.++## Evidence++No OpenClaw source, prompt, skill or asset is present in this repository. Integration+code is limited to lifecycle, logging and health surfaces MSO already owns.diff --git a/docs/references/orca.md b/docs/references/orca.mdnew file mode 100644index 00000000..49243650--- /dev/null+++ b/docs/references/orca.md@@ -0,0 +1,33 @@+# stablyai/orca++| | |+|---|---|+| License | MIT |+| Pin | `v1.4.230`, source tarball commit `b2879bd5aaac` |+| Relation | managed IDE runtime and MCP board bridge |+| Code copied | none |++## What MSO uses++Orca's published release artifacts. [`../../scripts/orca/constants.mjs`](../../scripts/orca/constants.mjs)+pins the `.deb` URL and SHA-256, the source tarball URL, and the license and+third-party-notice digests. `scripts/orca/asar-license.mjs` extracts the upstream+LICENSE and THIRD_PARTY_NOTICES from `app.asar` with a bounded, no-follow reader and+checks them against those digests — the upstream notice travels with the installed+runtime instead of being dropped.++`lib/managed-apps/orca-*.ts` and `scripts/orca/` (4,046 lines) are MSO-native+lifecycle, containment, readiness, pairing and receipt code.++## What MSO does not use++No Orca source is vendored, patched, or re-served as MSO code. `docs/ORCA-INTEGRATION.md`+records that the live install remains an explicit operator action and that no real+runtime or browser journey was claimed from fixtures.++## Evidence++`grep -r orcad lib` finds only receipt-path assertions in tests. The systemd unit is+rendered from code-owned values and names this repository's CLI entry point, never a+mutable upstream path. Orca's lack of per-device revocation is documented as an+upstream gap rather than papered over.diff --git a/docs/references/proot-distro.md b/docs/references/proot-distro.mdnew file mode 100644index 00000000..8556d727--- /dev/null+++ b/docs/references/proot-distro.md@@ -0,0 +1,20 @@+# termux/proot-distro++| | |+|---|---|+| License | GPL-3.0 |+| Relation | prerequisite for MSO on Android |+| Code copied | none |++## What MSO uses++Documentation only. [`../TERMUX.md`](../TERMUX.md) states that MSO is not installed+into native Android/Termux because Bun does not target Android, and that the supported+path is an Ubuntu PRoot environment provided by proot-distro. The link points at the+upstream repository.++## License boundary++GPL-3.0 applies to proot-distro, which the user installs independently from its own+source. MSO does not bundle, patch, link or distribute it. A future MSO-bundled install+path that ships proot-distro binaries would need a GPL compliance review.diff --git a/docs/references/shadcn-ui.md b/docs/references/shadcn-ui.mdnew file mode 100644index 00000000..f3cfe685--- /dev/null+++ b/docs/references/shadcn-ui.md@@ -0,0 +1,34 @@+# shadcn-ui/ui++| | |+|---|---|+| License | MIT |+| Relation | UI primitives used across the shell and slices |+| Code copied | yes, as generated component source |++## What MSO uses++`components/ui/*` is shadcn/ui component source, generated into the repo by the+shadcn CLI and then owned locally. `components.json` pins the preset+(`style: new-york`, `baseColor: neutral`, `cssVariables: true`, alias `@/components/ui`).+Twelve primitives (card, dialog, select, popover, input, textarea, skeleton,+input-group, command, scroll-area, button, badge) are present.++Slivers that need behaviour upstream does not ship are vendored beside the slice+rather than by forking the shared component; `frontend/slices/image-editor/ui/`+holds local `slider.tsx` and `tabs.tsx` variants.++## Attribution++shadcn/ui is distributed as copy-in source precisely so it can be owned by the+consumer. MSO's root [`../../LICENSE`](../../LICENSE) covers the MSO repository; the+upstream MIT text is not duplicated per file because the convention for this library+is to copy components in as application source, which MSO has done since commit+`71a4303` (2026-08-02).++## Note on the Nakama comparison++Parity work on 2026-10-18 did not introduce these files. Any file-overlap result between+MSO and Nakama or Hermes that lands on `components/ui/*`, `sheet.tsx`, `popover.tsx`,+`dialog.tsx` or `scroll-area.tsx` is shared shadcn descent, not transfer between those+projects.diff --git a/docs/references/simple-icons.md b/docs/references/simple-icons.mdnew file mode 100644index 00000000..2fc5db3f--- /dev/null+++ b/docs/references/simple-icons.md@@ -0,0 +1,22 @@+# simple-icons/simple-icons++| | |+|---|---|+| License | CC0-1.0 |+| Relation | provider brand glyphs |+| Code copied | yes, SVG path data |++## What MSO uses++`lib/infra/provider-icons.ts` embeds SVG path strings for GitHub, Cloudflare,+Hostinger, Vercel and Convex Cloud, taken from Simple Icons. The file header states+the source and the CC0 license, and records that brand trademarks remain with their+owners.++`simple-icons` is also a dev dependency and appears in a `deps-dev` bump entry in+[`../CHANGELOG.md`](../CHANGELOG.md).++## Note++CC0 waives copyright, not trademark. The glyphs identify the provider they belong to;+they are not used as MSO's own marks.diff --git a/docs/references/tweakcn.md b/docs/references/tweakcn.mdnew file mode 100644index 00000000..1f3869f8--- /dev/null+++ b/docs/references/tweakcn.md@@ -0,0 +1,27 @@+# jnsahaj/tweakcn++| | |+|---|---|+| License | Apache-2.0 |+| Relation | bundled theme preset registry |+| Code copied | data, not code |++## What MSO uses++`lib/appearance/presets/registry-data.json` is a 239 KB, 36-preset mirror of the+tweakcn registry (`name: tweakcn-theme-registry`, `homepage: http://tweakcn.com`).+`scripts/check-contrast.mjs` validates every preset in that file, so the mirror is+load-bearing, not decorative. [`../PROGRESS.md`](../PROGRESS.md) calls it a+"verbatim upstream mirror".++## Obligation++Apache-2.0 §4 requires the notice and license text to travel with a redistributed+work. Attribution is recorded in `lib/appearance/presets/registry.ts`; the full+Apache-2.0 text is not vendored here. The registry content is a data file, not a+modified source tree.++## What MSO does not use++No tweakcn editor, React components, or build tooling. `lib/appearance/presets/apply.ts`+maps preset tokens onto MSO's own chrome variables.diff --git a/docs/references/twemoji.md b/docs/references/twemoji.mdnew file mode 100644index 00000000..1b6df6a8--- /dev/null+++ b/docs/references/twemoji.md@@ -0,0 +1,22 @@+# jdecked/twemoji++| | |+|---|---|+| License | MIT (code) + CC-BY 4.0 (SVG assets) |+| Pin | `15.1.0` via jsDelivr |+| Relation | emoji rendering in the icon picker |+| Code copied | converter logic reimplemented; assets hot-linked |++## What MSO uses++`frontend/slices/icon-picker/lib/twemoji.ts` converts a Unicode emoji to a Twemoji+codepoint filename and builds a jsDelivr URL against+`cdn.jsdelivr.net/gh/jdecked/[email protected]`. No emoji package is added to+`package.json`, so nothing is bundled or redistributed.++## Attribution++The file header states the attribution and dual license, and states why the actively+maintained fork is used instead of the archived original. CC-BY 4.0 requires+attribution when the SVG assets are redistributed; MSO serves them from the CDN and+keeps the credit in the source file.diff --git a/lib/appearance/presets/registry.ts b/lib/appearance/presets/registry.tsindex d40c26e2..515eb9eb 100644--- a/lib/appearance/presets/registry.ts+++ b/lib/appearance/presets/registry.ts@@ -4,7 +4,9 @@ let cache: PresetRegistry | null = null;let pending: Promise<PresetRegistry> | null = null;/** Lazy-load the bundled tweakcn registry (~240KB JSON code-splits into its- * own chunk — fetched only when the Theme section mounts or a preset boots). */+ * own chunk — fetched only when the Theme section mounts or a preset boots).+ * The registry content mirrors jnsahaj/tweakcn (Apache-2.0); see+ * docs/references/tweakcn.md. MSO ships no tweakcn code. */export async function loadPresetRegistry(): Promise<PresetRegistry> {if (cache) return cache;if (pending) return pending;diff --git a/package.json b/package.jsonindex 0731e8de..765a7a1e 100644--- a/package.json+++ b/package.json@@ -1,6 +1,7 @@{"name": "mso","version": "0.2.23",+ "license": "SEE LICENSE IN LICENSE","private": true,"engines": {"node": "^22.12.0 || ^24.0.0 || >=26.0.0",