relmio 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -7,7 +7,40 @@ checks the registry separately after publication.
 
 ## Unreleased
 
-No unreleased changes.
+## [0.2.1] - 2026-07-30
+
+### Added
+
+- Add the hosted ChatGPT site link to the package metadata and public guides.
+- Document the upstream Codex relay model, known limitations, and legal
+  responsibilities in both the GitHub and npm README variants.
+- Add a command-first install page for the current n8n and Hostinger VPS
+  wizard, plus a GitHub control with live package and repository metadata.
+- Credit Evan Zhou Dev's `openai-oauth` method on the hosted Relmio page.
+
+### Changed
+
+- Refresh the local setup wizard and hosted chat presentation with the Relmio
+  redesign, including clearer progress, copy feedback, responsive layouts, and
+  request-state affordances.
+- Move the hosted chat and package homepage to
+  [relmio.vercel.app](https://relmio.vercel.app/) with Node.js 22 and
+  repository-driven preview and production deployments.
+- Return ChatGPT OAuth callbacks to the deployment that started sign-in so
+  Vercel preview URLs and the production domain both work.
+- Run hosted web linting, type checks, builds, tests, and dependency auditing
+  in GitHub Actions alongside repository-driven deployments.
+- Point package and documentation metadata at the canonical `relmio`
+  repository.
+- License Relmio under Apache 2.0 and preserve the upstream `openai-oauth`
+  attribution in the distributed notice.
+
+### Fixed
+
+- Stream hosted chat responses incrementally through deployment proxies and
+  surface safe request errors instead of leaving an empty assistant message.
+- Distinguish a ChatGPT hosting-network challenge from an expired OAuth
+  session without exposing upstream response bodies or credentials.
 
 ## [0.2.0] - 2026-07-29
 
@@ -180,11 +213,11 @@ No unreleased changes.
 - The sidecar uses an internal-only Docker network endpoint and no published
   VPS port.
 
-[0.1.7]: https://github.com/Demonbane18/n8n-openai-oauth-setup/compare/v0.1.6...v0.1.7
-[0.1.6]: https://github.com/Demonbane18/n8n-openai-oauth-setup/compare/v0.1.5...v0.1.6
-[0.1.5]: https://github.com/Demonbane18/n8n-openai-oauth-setup/compare/v0.1.4...v0.1.5
-[0.1.4]: https://github.com/Demonbane18/n8n-openai-oauth-setup/compare/v0.1.3...v0.1.4
-[0.1.3]: https://github.com/Demonbane18/n8n-openai-oauth-setup/compare/v0.1.2...v0.1.3
-[0.1.2]: https://github.com/Demonbane18/n8n-openai-oauth-setup/compare/v0.1.1...v0.1.2
-[0.1.1]: https://github.com/Demonbane18/n8n-openai-oauth-setup/compare/v0.1.0...v0.1.1
-[0.1.0]: https://github.com/Demonbane18/n8n-openai-oauth-setup/releases/tag/v0.1.0
+[0.1.7]: https://github.com/Demonbane18/relmio/compare/v0.1.6...v0.1.7
+[0.1.6]: https://github.com/Demonbane18/relmio/compare/v0.1.5...v0.1.6
+[0.1.5]: https://github.com/Demonbane18/relmio/compare/v0.1.4...v0.1.5
+[0.1.4]: https://github.com/Demonbane18/relmio/compare/v0.1.3...v0.1.4
+[0.1.3]: https://github.com/Demonbane18/relmio/compare/v0.1.2...v0.1.3
+[0.1.2]: https://github.com/Demonbane18/relmio/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/Demonbane18/relmio/compare/v0.1.0...v0.1.1
+[0.1.0]: https://github.com/Demonbane18/relmio/releases/tag/v0.1.0

package/LICENSE

@@ -1,21 +1,201 @@
-MIT License
-
-Copyright (c) 2026 Demonbane18
-
-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.
+                                 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 2026 Relmio 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.

package/NOTICE

@@ -0,0 +1,11 @@
+Relmio
+Copyright 2026 Relmio contributors
+
+Relmio uses software and methods developed by Evan Zhou and the OpenAI OAuth
+contributors:
+
+OpenAI OAuth
+Copyright 2026 Evan Zhou and OpenAI OAuth contributors
+https://github.com/EvanZhouDev/openai-oauth
+
+OpenAI OAuth is licensed under the Apache License, Version 2.0.

package/README.md

@@ -1,13 +1,15 @@
 <div align="center">
-  <img src="https://raw.githubusercontent.com/Demonbane18/n8n-openai-oauth-setup/main/docs/images/brand/relmio-mark.svg" alt="Relmio logo" width="88">
+  <img src="https://cdn.jsdelivr.net/npm/relmio@latest/docs/images/brand/relmio-mark.svg" alt="Relmio logo" width="88">
   <h1>Relmio</h1>
   <p>Relay a supported ChatGPT/Codex sign-in to OpenAI-compatible clients, starting with self-hosted n8n.</p>
   <p>
-    <a href="https://github.com/Demonbane18/n8n-openai-oauth-setup">Full guide</a>
+    <a href="https://github.com/Demonbane18/relmio">Full guide</a>
     &nbsp;·&nbsp;
-    <a href="https://github.com/Demonbane18/n8n-openai-oauth-setup/issues/new">Report an issue</a>
+    <a href="https://relmio.vercel.app/">Hosted ChatGPT site</a>
     &nbsp;·&nbsp;
-    <a href="https://github.com/Demonbane18/n8n-openai-oauth-setup/blob/main/docs/roadmap.md">Roadmap</a>
+    <a href="https://github.com/Demonbane18/relmio/issues/new">Report an issue</a>
+    &nbsp;·&nbsp;
+    <a href="https://github.com/Demonbane18/relmio/blob/main/docs/roadmap.md">Roadmap</a>
   </p>
 </div>
 
@@ -19,6 +21,15 @@ exact change plan, and the final n8n credential settings.
 
 The existing n8n image, Compose file, container, and workflows stay untouched.
 
+Try the hosted browser demo at
+[relmio.vercel.app](https://relmio.vercel.app/). It is a separate
+request-bound ChatGPT experience; the npm package remains the local wizard for
+installing the private n8n sidecar.
+
+Use the site's [Install wizard](https://relmio.vercel.app/install) page for a
+copyable command tailored to the current self-hosted n8n and Hostinger VPS
+setup path.
+
 ## Quick start
 
 Run this on your own macOS, Windows, or Linux computer—not on the VPS:
@@ -55,7 +66,7 @@ Relmio currently provides tested setup instructions for:
 The broader direction is to support local chatbots, custom applications,
 OpenAI-compatible clients, and provider adapters without tying the public
 product name to n8n. SuperGrok/xAI OAuth is a gated feasibility item on the
-[provider roadmap](https://github.com/Demonbane18/n8n-openai-oauth-setup/blob/main/docs/roadmap.md);
+[provider roadmap](https://github.com/Demonbane18/relmio/blob/main/docs/roadmap.md);
 it is not currently advertised as supported.
 
 ## Visual walkthrough
@@ -65,23 +76,23 @@ data, and no real credential or session information.
 
 ### 1. Confirm the local ChatGPT/Codex sign-in
 
-<img src="https://raw.githubusercontent.com/Demonbane18/n8n-openai-oauth-setup/main/docs/images/setup/01-local-sign-in-ready.png" alt="Sanitized local sign-in ready screen" width="720">
+<img src="https://cdn.jsdelivr.net/npm/relmio@latest/docs/images/setup/01-local-sign-in-ready.png" alt="Sanitized local sign-in ready screen" width="720">
 
 ### 2. Verify the VPS identity
 
-<img src="https://raw.githubusercontent.com/Demonbane18/n8n-openai-oauth-setup/main/docs/images/setup/02-vps-identity-confirmed.png" alt="Sanitized VPS fingerprint confirmation screen" width="720">
+<img src="https://cdn.jsdelivr.net/npm/relmio@latest/docs/images/setup/02-vps-identity-confirmed.png" alt="Sanitized VPS fingerprint confirmation screen" width="720">
 
 ### 3. Choose the detected n8n container and network
 
-<img src="https://raw.githubusercontent.com/Demonbane18/n8n-openai-oauth-setup/main/docs/images/setup/03-n8n-detected.png" alt="Sanitized n8n discovery screen" width="720">
+<img src="https://cdn.jsdelivr.net/npm/relmio@latest/docs/images/setup/03-n8n-detected.png" alt="Sanitized n8n discovery screen" width="720">
 
 ### 4. Review the exact sidecar-only plan
 
-<img src="https://raw.githubusercontent.com/Demonbane18/n8n-openai-oauth-setup/main/docs/images/setup/04-install-plan.png" alt="Sanitized installation plan screen" width="720">
+<img src="https://cdn.jsdelivr.net/npm/relmio@latest/docs/images/setup/04-install-plan.png" alt="Sanitized installation plan screen" width="720">
 
 ### 5. Copy the verified n8n settings
 
-<img src="https://raw.githubusercontent.com/Demonbane18/n8n-openai-oauth-setup/main/docs/images/setup/05-bridge-ready.png" alt="Sanitized verified bridge screen" width="720">
+<img src="https://cdn.jsdelivr.net/npm/relmio@latest/docs/images/setup/05-bridge-ready.png" alt="Sanitized verified bridge screen" width="720">
 
 Use these values in an n8n OpenAI credential:
 
@@ -108,15 +119,52 @@ Platform API key.
 - Use it only where your account, subscription, provider terms, and applicable
   policies allow.
 
+## How it works
+
+OpenAI's Codex CLI uses authenticated endpoints at
+`chatgpt.com/backend-api/codex` to run models with a ChatGPT account. Relmio
+uses the same OAuth credential shape through the upstream
+[`openai-oauth`](https://github.com/EvanZhouDev/openai-oauth) helper to expose
+an OpenAI-compatible path without creating an OpenAI Platform API key or
+requiring separate API credits. The upstream service and its access rules may
+change.
+
+## Known limitations
+
+- Only models supported by Codex are available. The list changes over time and
+  depends on your ChatGPT plan.
+- The CLI `/v1/responses` endpoint is stateless. Callers must send the full
+  conversation history; stateful replay is not provided.
+- Hosted browser sign-in currently supports Chrome and Firefox. Safari is not
+  yet supported by the upstream Sign in with ChatGPT flow.
+
+## Legal
+
+Relmio and `openai-oauth` are unofficial, community-maintained projects and
+are not affiliated with, endorsed by, or sponsored by OpenAI.
+
+ChatGPT OAuth credentials should be treated like passwords. Use your own
+account, keep credentials private, and never pool, share, or redistribute
+access tokens. Do not bypass rate limits, restrictions, or safeguards.
+
+You are responsible for complying with OpenAI's [Terms of
+Use](https://openai.com/policies/terms-of-use/), [Usage
+Policies](https://openai.com/policies/usage-policies/), and any agreement that
+applies to your account. This project is provided as-is without warranties;
+OpenAI may change or disable the underlying services at any time.
+
 ## Documentation
 
-- [Complete GitHub README and manual fallback](https://github.com/Demonbane18/n8n-openai-oauth-setup#readme)
-- [Configure n8n AI and HTTP nodes](https://github.com/Demonbane18/n8n-openai-oauth-setup/blob/main/docs/n8n-configuration.md)
-- [Troubleshooting](https://github.com/Demonbane18/n8n-openai-oauth-setup/blob/main/docs/troubleshooting.md)
-- [Security and limitations](https://github.com/Demonbane18/n8n-openai-oauth-setup/blob/main/docs/security.md)
-- [Refresh, upgrade, rollback, and uninstall](https://github.com/Demonbane18/n8n-openai-oauth-setup/blob/main/docs/maintenance.md)
-- [Changelog](https://github.com/Demonbane18/n8n-openai-oauth-setup/blob/main/CHANGELOG.md)
+- [Complete GitHub README and manual fallback](https://github.com/Demonbane18/relmio#readme)
+- [Configure n8n AI and HTTP nodes](https://github.com/Demonbane18/relmio/blob/main/docs/n8n-configuration.md)
+- [Troubleshooting](https://github.com/Demonbane18/relmio/blob/main/docs/troubleshooting.md)
+- [Security and limitations](https://github.com/Demonbane18/relmio/blob/main/docs/security.md)
+- [Refresh, upgrade, rollback, and uninstall](https://github.com/Demonbane18/relmio/blob/main/docs/maintenance.md)
+- [Changelog](https://github.com/Demonbane18/relmio/blob/main/CHANGELOG.md)
 
 ## License
 
-[MIT](https://github.com/Demonbane18/n8n-openai-oauth-setup/blob/main/LICENSE)
+[Apache License 2.0](https://github.com/Demonbane18/relmio/blob/main/LICENSE).
+See the package
+[NOTICE](https://github.com/Demonbane18/relmio/blob/main/NOTICE) for the
+upstream `openai-oauth` attribution.

package/docs/npm-publish.md

@@ -203,7 +203,7 @@ On the npm package's **Trusted Publisher** form, use:
 |---|---|
 | Publisher | GitHub Actions |
 | Organization or user | `Demonbane18` |
-| Repository | `n8n-openai-oauth-setup` |
+| Repository | `relmio` |
 | Workflow filename | `publish.yml` |
 | Environment name | `npm` |
 | Allowed action | Allow npm publish |

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "relmio",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Turn a supported ChatGPT/Codex OAuth sign-in into a private OpenAI-compatible endpoint, starting with self-hosted n8n.",
   "type": "module",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Demonbane18/n8n-openai-oauth-setup.git"
+    "url": "git+https://github.com/Demonbane18/relmio.git"
   },
   "bugs": {
-    "url": "https://github.com/Demonbane18/n8n-openai-oauth-setup/issues"
+    "url": "https://github.com/Demonbane18/relmio/issues"
   },
-  "homepage": "https://github.com/Demonbane18/n8n-openai-oauth-setup#readme",
+  "homepage": "https://relmio.vercel.app/",
   "engines": {
     "node": ">=22"
   },
@@ -28,13 +28,14 @@
     "README.md",
     "SPEC.md",
     "CHANGELOG.md",
-    "LICENSE"
+    "LICENSE",
+    "NOTICE"
   ],
   "scripts": {
     "start": "node src/cli.js",
     "preview": "node scripts/preview.js",
     "package:build": "node scripts/build-npm-package.js",
-    "test": "node --test",
+    "test": "node --test test/*.test.js",
     "lint": "node scripts/check-syntax.js",
     "release:check": "node scripts/check-release-metadata.js",
     "check": "npm run lint && npm run release:check && npm test"

package/src/ui/app.js

@@ -48,6 +48,24 @@ function setBusy(button, busy, busyText) {
   button.textContent = busy ? busyText : button.dataset.label;
 }
 
+const revertTimers = new WeakMap();
+
+function flashCopied(button) {
+  if (!button.dataset.label) {
+    button.dataset.label = button.textContent;
+  }
+  button.textContent = "Copied";
+  button.classList.add("copied");
+  window.clearTimeout(revertTimers.get(button));
+  revertTimers.set(
+    button,
+    window.setTimeout(() => {
+      button.textContent = button.dataset.label;
+      button.classList.remove("copied");
+    }, 1800),
+  );
+}
+
 async function copyText(value) {
   try {
     await navigator.clipboard.writeText(value);
@@ -405,7 +423,7 @@ element("container-select").addEventListener("change", async () => {
     await loadNetworks();
   } catch (error) {
     element("install-confirm").checked = false;
-    button.disabled = true;
+    element("install-button").disabled = true;
     showStep(2);
     setMessage(
       "The install stopped and the VPS connection was closed. Reconnect to inspect the sidecar before retrying.",
@@ -488,7 +506,7 @@ element("copy-settings").addEventListener("click", async (event) => {
   clearError();
   try {
     await copyText(settings);
-    event.currentTarget.textContent = "Copied";
+    flashCopied(event.currentTarget);
     setMessage("OpenAI credential settings copied.");
   } catch {
     showError(new Error("Copy failed. Select the values manually."));
@@ -503,7 +521,7 @@ for (const button of document.querySelectorAll("[data-copy-target]")) {
     clearError();
     try {
       await copyText(value);
-      event.currentTarget.textContent = "Copied";
+      flashCopied(event.currentTarget);
       setMessage(`${label} copied.`);
     } catch {
       showError(new Error(`Copy failed. Select the ${label} manually.`));

package/src/ui/styles.css

@@ -1,22 +1,30 @@
 :root {
   color-scheme: light;
-  --background: #f4f2ed;
+  --background: #f4f2ec;
   --surface: #ffffff;
-  --surface-muted: #f8f8f6;
-  --text: #12211f;
-  --text-muted: #5d6865;
-  --border: #d7dcda;
-  --border-strong: #aeb8b5;
+  --surface-muted: #f7f6f1;
+  --text: #0d1b18;
+  --text-muted: #53655f;
+  --border: #dde3df;
+  --border-strong: #b9c4bf;
   --accent: #137c74;
-  --accent-hover: #0f625d;
-  --accent-soft: #e7f3f0;
+  --accent-deep: #0c5f59;
+  --accent-bright: #1ba397;
+  --accent-soft: #e9f4ef;
   --warning: #8a4b0f;
-  --warning-soft: #fff3df;
+  --warning-soft: #fff4e2;
+  --warning-border: #e3c491;
   --danger: #a22b2b;
   --danger-soft: #fff0f0;
   --success: #17653f;
-  --shadow: 0 12px 32px rgb(23 33 31 / 8%);
-  --radius: 0.75rem;
+  --ease: cubic-bezier(0.22, 1, 0.36, 1);
+  --shadow-sm: 0 1px 2px rgb(13 27 24 / 5%);
+  --shadow-md:
+    0 1px 2px rgb(13 27 24 / 4%),
+    0 12px 36px -14px rgb(13 27 24 / 18%);
+  --radius-sm: 0.5rem;
+  --radius: 0.875rem;
+  --radius-lg: 1.25rem;
 }
 
 * {
@@ -29,12 +37,18 @@ html {
     sans-serif;
   color: var(--text);
   background: var(--background);
+  scroll-behavior: smooth;
 }
 
 body {
   min-width: 20rem;
   margin: 0;
   line-height: 1.5;
+  -webkit-font-smoothing: antialiased;
+}
+
+::selection {
+  background: rgb(19 124 116 / 22%);
 }
 
 button,
@@ -66,29 +80,39 @@ a:focus-visible {
   left: 0.5rem;
   z-index: 10;
   padding: 0.75rem 1rem;
+  border-radius: 999px;
   color: #fff;
   background: var(--text);
   transform: translateY(-150%);
+  transition: transform 200ms var(--ease);
 }
 
 .skip-link:focus {
   transform: translateY(0);
 }
 
+/* ---------- Header ---------- */
+
 .site-header {
+  position: sticky;
+  top: 0;
+  z-index: 20;
   display: flex;
   align-items: center;
   justify-content: space-between;
-  min-height: 4rem;
+  min-height: 4.25rem;
   padding: 0.75rem clamp(1rem, 4vw, 3rem);
-  border-bottom: 1px solid var(--border);
-  background: rgb(255 255 255 / 85%);
+  border-bottom: 1px solid rgb(221 227 223 / 75%);
+  background: rgb(244 242 236 / 82%);
+  backdrop-filter: blur(14px) saturate(1.4);
+  -webkit-backdrop-filter: blur(14px) saturate(1.4);
 }
 
 .brand {
   display: flex;
   align-items: center;
   gap: 0.625rem;
+  font-size: 1.0625rem;
   font-weight: 750;
   letter-spacing: -0.01em;
 }
@@ -101,19 +125,33 @@ a:focus-visible {
 }
 
 .local-badge {
-  padding: 0.375rem 0.625rem;
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4375rem;
+  padding: 0.4375rem 0.75rem;
   border: 1px solid var(--border);
   border-radius: 999px;
   color: var(--text-muted);
   background: var(--surface);
+  box-shadow: var(--shadow-sm);
   font-size: 0.75rem;
   font-weight: 650;
 }
 
+.local-badge::before {
+  width: 0.4375rem;
+  height: 0.4375rem;
+  border-radius: 50%;
+  background: var(--accent-bright);
+  content: "";
+}
+
+/* ---------- Shell & intro ---------- */
+
 .shell {
   width: min(100% - 2rem, 54rem);
   margin: 0 auto;
-  padding: 3rem 0 5rem;
+  padding: 3.5rem 0 5rem;
 }
 
 .intro {
@@ -140,14 +178,14 @@ p {
 h1 {
   max-width: 42rem;
   margin-bottom: 1rem;
-  font-size: clamp(2rem, 7vw, 3.5rem);
-  line-height: 1.05;
+  font-size: clamp(2.1rem, 6.5vw, 3.4rem);
+  line-height: 1.04;
   letter-spacing: -0.045em;
 }
 
 h2 {
   margin-bottom: 0.5rem;
-  font-size: clamp(1.5rem, 4vw, 2rem);
+  font-size: clamp(1.45rem, 4vw, 1.9rem);
   line-height: 1.2;
   letter-spacing: -0.025em;
 }
@@ -167,16 +205,38 @@ h3 {
   font-size: 1.0625rem;
 }
 
+/* ---------- Safety notes ---------- */
+
 .safety-note {
+  position: relative;
   display: grid;
-  grid-template-columns: max-content 1fr;
-  gap: 0.75rem 1rem;
-  margin: 2rem 0;
-  padding: 1rem;
+  grid-template-columns: 2.25rem 1fr;
+  gap: 0.25rem 0.875rem;
+  align-items: start;
+  margin: 1.25rem 0 0;
+  padding: 1rem 1.125rem;
   border: 1px solid #b9d9d2;
-  border-left: 4px solid var(--accent);
-  border-radius: 0.5rem;
+  border-radius: var(--radius);
   background: var(--accent-soft);
+  box-shadow: var(--shadow-sm);
+}
+
+.safety-note::before {
+  display: grid;
+  width: 2.25rem;
+  height: 2.25rem;
+  grid-row: span 2;
+  place-items: center;
+  border-radius: 0.625rem;
+  color: var(--accent-deep);
+  background: #d3eae0;
+  font-size: 1rem;
+  font-weight: 800;
+  content: "✓";
+}
+
+.safety-note strong {
+  align-self: center;
 }
 
 .safety-note span {
@@ -184,16 +244,24 @@ h3 {
 }
 
 .backup-note {
-  border-color: #d7b98d;
+  border-color: var(--warning-border);
   background: var(--warning-soft);
 }
 
+.backup-note::before {
+  color: var(--warning);
+  background: #f6e3c3;
+  content: "!";
+}
+
 .backup-note span {
   color: var(--warning);
 }
 
+/* ---------- Stepper ---------- */
+
 .steps {
-  margin: 2rem 0 1rem;
+  margin: 2.5rem 0 1.25rem;
 }
 
 .steps ol {
@@ -208,7 +276,7 @@ h3 {
   position: relative;
   display: grid;
   justify-items: center;
-  gap: 0.375rem;
+  gap: 0.4375rem;
   color: var(--text-muted);
   font-size: 0.75rem;
   text-align: center;
@@ -216,13 +284,14 @@ h3 {
 
 .steps li::before {
   position: absolute;
-  top: 0.8125rem;
+  top: 0.9375rem;
   right: 50%;
-  z-index: -1;
+  z-index: 0;
   width: 100%;
   height: 2px;
   background: var(--border);
   content: "";
+  transition: background 400ms var(--ease);
 }
 
 .steps li:first-child::before {
@@ -230,29 +299,52 @@ h3 {
 }
 
 .steps li span {
+  position: relative;
+  z-index: 1;
   display: grid;
-  width: 1.75rem;
-  height: 1.75rem;
+  width: 2rem;
+  height: 2rem;
   place-items: center;
   border: 2px solid var(--border-strong);
   border-radius: 50%;
-  background: var(--background);
+  background: var(--surface);
+  box-shadow: var(--shadow-sm);
+  font-size: 0.8125rem;
   font-weight: 800;
+  transition:
+    border-color 300ms var(--ease),
+    background 300ms var(--ease),
+    color 300ms var(--ease),
+    box-shadow 300ms var(--ease);
 }
 
 .steps li em {
   font-style: normal;
+  font-weight: 600;
 }
 
 .steps li[aria-current="step"] {
   color: var(--text);
 }
 
-.steps li[aria-current="step"] span,
-.steps li.complete span {
+.steps li[aria-current="step"] span {
   border-color: var(--accent);
   color: #fff;
   background: var(--accent);
+  box-shadow: 0 0 0 5px rgb(19 124 116 / 15%);
+}
+
+.steps li.complete span {
+  border-color: var(--accent);
+  color: transparent;
+  background: var(--accent);
+}
+
+.steps li.complete span::after {
+  position: absolute;
+  color: #fff;
+  font-size: 0.8125rem;
+  content: "✓";
 }
 
 .steps li.complete::before,
@@ -260,17 +352,34 @@ h3 {
   background: var(--accent);
 }
 
+/* ---------- Global messages ---------- */
+
 .message,
 .error {
-  min-height: 2.75rem;
+  display: flex;
+  align-items: center;
+  gap: 0.625rem;
+  min-height: 2.875rem;
   margin: 1rem 0;
   padding: 0.75rem 1rem;
-  border-radius: 0.5rem;
+  border-radius: var(--radius-sm);
+  font-size: 0.9375rem;
 }
 
 .message {
+  border: 1px solid var(--border);
   color: var(--text-muted);
-  background: var(--surface-muted);
+  background: var(--surface);
+  box-shadow: var(--shadow-sm);
+}
+
+.message::before {
+  flex: 0 0 auto;
+  width: 0.4375rem;
+  height: 0.4375rem;
+  border-radius: 50%;
+  background: var(--accent-bright);
+  content: "";
 }
 
 .error {
@@ -278,14 +387,18 @@ h3 {
   color: var(--danger);
   background: var(--danger-soft);
   font-weight: 650;
+  animation: shake 320ms var(--ease);
 }
 
+/* ---------- Panels ---------- */
+
 .panel {
-  padding: clamp(1.25rem, 4vw, 2rem);
+  padding: clamp(1.5rem, 4vw, 2.25rem);
   border: 1px solid var(--border);
-  border-radius: var(--radius);
+  border-radius: var(--radius-lg);
   background: var(--surface);
-  box-shadow: var(--shadow);
+  box-shadow: var(--shadow-md);
+  animation: panel-in 380ms var(--ease);
 }
 
 .panel-heading {
@@ -301,9 +414,9 @@ h3 {
   display: flex;
   align-items: flex-start;
   gap: 0.875rem;
-  padding: 1rem;
+  padding: 1rem 1.125rem;
   border: 1px solid var(--border);
-  border-radius: 0.5rem;
+  border-radius: var(--radius);
   background: var(--surface-muted);
 }
 
@@ -325,13 +438,20 @@ h3 {
   margin-top: 0.375rem;
   border: 2px solid var(--border-strong);
   border-radius: 50%;
+  transition:
+    border-color 300ms var(--ease),
+    background 300ms var(--ease),
+    box-shadow 300ms var(--ease);
 }
 
 .status-dot.ready {
   border-color: var(--success);
   background: var(--success);
+  box-shadow: 0 0 0 4px rgb(23 101 63 / 14%);
 }
 
+/* ---------- Fields ---------- */
+
 .field-grid {
   display: grid;
   grid-template-columns: minmax(0, 2fr) minmax(7rem, 1fr);
@@ -346,24 +466,56 @@ h3 {
 .field {
   display: grid;
   align-content: start;
-  gap: 0.375rem;
+  gap: 0.4375rem;
   font-weight: 700;
 }
 
 .field input,
 .field select {
   width: 100%;
-  min-height: 2.75rem;
-  padding: 0.625rem 0.75rem;
+  min-height: 2.875rem;
+  padding: 0.625rem 0.875rem;
   border: 1px solid var(--border-strong);
-  border-radius: 0.375rem;
+  border-radius: var(--radius-sm);
   color: var(--text);
   background: #fff;
+  transition:
+    border-color 200ms var(--ease),
+    box-shadow 200ms var(--ease),
+    background 200ms var(--ease);
+}
+
+.field select {
+  appearance: none;
+  padding-right: 2.25rem;
+  background-image:
+    linear-gradient(45deg, transparent 50%, var(--text-muted) 50%),
+    linear-gradient(135deg, var(--text-muted) 50%, transparent 50%);
+  background-position:
+    calc(100% - 1.125rem) 50%,
+    calc(100% - 0.8125rem) 50%;
+  background-size:
+    0.3125rem 0.3125rem,
+    0.3125rem 0.3125rem;
+  background-repeat: no-repeat;
+}
+
+.field input:hover,
+.field select:hover {
+  border-color: var(--accent);
 }
 
 .field input:focus,
 .field select:focus {
   border-color: var(--accent);
+  outline: 0;
+  box-shadow: 0 0 0 4px rgb(19 124 116 / 13%);
+}
+
+.field input:disabled {
+  color: var(--text-muted);
+  background: var(--surface-muted);
+  cursor: not-allowed;
 }
 
 .field small {
@@ -381,21 +533,46 @@ code {
   overflow-wrap: anywhere;
 }
 
+/* ---------- Buttons ---------- */
+
 .actions {
   display: flex;
   flex-wrap: wrap;
   justify-content: flex-end;
   gap: 0.75rem;
-  margin-top: 1.5rem;
+  margin-top: 1.75rem;
 }
 
 .button {
-  min-height: 2.75rem;
-  padding: 0.625rem 1rem;
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+  min-height: 2.875rem;
+  padding: 0.625rem 1.125rem;
   border: 1px solid transparent;
-  border-radius: 0.375rem;
+  border-radius: 0.625rem;
   font-weight: 750;
+  box-shadow: var(--shadow-sm);
   cursor: pointer;
+  transition:
+    transform 200ms var(--ease),
+    box-shadow 200ms var(--ease),
+    background 200ms var(--ease),
+    color 200ms var(--ease),
+    border-color 200ms var(--ease),
+    opacity 200ms var(--ease);
+}
+
+.button:not(:disabled):hover {
+  transform: translateY(-1px);
+  box-shadow: var(--shadow-md);
+}
+
+.button:not(:disabled):active {
+  transform: translateY(0) scale(0.98);
+  box-shadow: var(--shadow-sm);
 }
 
 .button:disabled {
@@ -403,13 +580,28 @@ code {
   opacity: 0.48;
 }
 
+.button[aria-busy="true"] {
+  cursor: progress;
+}
+
+.button[aria-busy="true"]::after {
+  width: 0.9375rem;
+  height: 0.9375rem;
+  flex: 0 0 auto;
+  border: 2px solid currentcolor;
+  border-top-color: transparent;
+  border-radius: 50%;
+  content: "";
+  animation: spin 700ms linear infinite;
+}
+
 .button.primary {
   color: #fff;
   background: var(--accent);
 }
 
 .button.primary:not(:disabled):hover {
-  background: var(--accent-hover);
+  background: var(--accent-deep);
 }
 
 .button.secondary {
@@ -420,21 +612,32 @@ code {
 
 .button.secondary:not(:disabled):hover,
 .button.ghost:not(:disabled):hover {
-  background: var(--surface-muted);
+  border-color: var(--accent);
+  background: var(--accent-soft);
 }
 
 .button.ghost {
   margin-right: auto;
   color: var(--text-muted);
   background: transparent;
+  box-shadow: none;
+}
+
+.button.copied {
+  border-color: var(--success);
+  color: var(--success);
+  background: #e9f5ee;
 }
 
+/* ---------- Fingerprint & approvals ---------- */
+
 .fingerprint {
   margin-top: 1rem;
-  padding: 1rem;
-  border: 1px solid #d7b98d;
-  border-radius: 0.5rem;
+  padding: 1.125rem;
+  border: 1px solid var(--warning-border);
+  border-radius: var(--radius);
   background: var(--warning-soft);
+  animation: panel-in 320ms var(--ease);
 }
 
 .fingerprint > span {
@@ -449,6 +652,9 @@ code {
 .fingerprint > code {
   display: block;
   margin-bottom: 1rem;
+  padding: 0.625rem 0.75rem;
+  border: 1px solid var(--warning-border);
+  border-radius: var(--radius-sm);
   background: #fff;
 }
 
@@ -465,23 +671,30 @@ code {
   width: 1.125rem;
   height: 1.125rem;
   margin: 0.2rem 0 0;
+  accent-color: var(--accent);
+  cursor: pointer;
 }
 
 .version-strip {
   display: flex;
   flex-wrap: wrap;
-  gap: 0.75rem;
-  margin-bottom: 1rem;
+  gap: 0.625rem;
+  margin-bottom: 1.25rem;
 }
 
 .version-strip span {
-  padding: 0.375rem 0.625rem;
+  display: inline-flex;
+  align-items: center;
+  gap: 0.375rem;
+  padding: 0.4375rem 0.75rem;
   border: 1px solid var(--border);
   border-radius: 999px;
   background: var(--surface-muted);
-  font-size: 0.875rem;
+  font-size: 0.8125rem;
 }
 
+/* ---------- Review ---------- */
+
 .review-grid {
   display: grid;
   grid-template-columns: 1fr 1fr;
@@ -489,9 +702,20 @@ code {
 }
 
 .review-grid section {
-  padding: 1rem;
+  padding: 1.125rem;
   border: 1px solid var(--border);
-  border-radius: 0.5rem;
+  border-radius: var(--radius);
+  background: var(--surface-muted);
+}
+
+.review-grid section:first-child {
+  border-color: #b9d9d2;
+  background: var(--accent-soft);
+}
+
+.review-grid section:last-child {
+  border-color: #e4abab;
+  background: var(--danger-soft);
 }
 
 .check-list,
@@ -512,27 +736,31 @@ code {
 
 .approval {
   margin-top: 1rem;
-  padding: 1rem;
-  border: 1px solid #d7b98d;
-  border-radius: 0.5rem;
+  padding: 1rem 1.125rem;
+  border: 1px solid var(--warning-border);
+  border-radius: var(--radius);
   background: var(--warning-soft);
 }
 
+/* ---------- Success ---------- */
+
 .success-panel {
   position: relative;
 }
 
 .success-mark {
   display: grid;
-  width: 3rem;
-  height: 3rem;
-  margin-bottom: 1rem;
+  width: 3.25rem;
+  height: 3.25rem;
+  margin-bottom: 1.25rem;
   place-items: center;
   border-radius: 50%;
   color: #fff;
-  background: var(--success);
+  background: linear-gradient(140deg, #1d8a5f, var(--success));
+  box-shadow: 0 0 0 6px rgb(23 101 63 / 14%);
   font-size: 1.5rem;
   font-weight: 900;
+  animation: pop-in 480ms var(--ease);
 }
 
 .result-list {
@@ -543,6 +771,7 @@ code {
   display: grid;
   grid-template-columns: 9rem 1fr;
   gap: 1rem;
+  align-items: center;
   padding: 0.875rem 0;
   border-bottom: 1px solid var(--border);
 }
@@ -560,20 +789,23 @@ code {
   display: flex;
   flex-wrap: wrap;
   align-items: center;
+  justify-content: space-between;
   gap: 0.75rem;
 }
 
 .copy-value {
-  min-height: 2rem;
-  padding: 0.25rem 0.625rem;
+  min-height: 2.125rem;
+  padding: 0.3125rem 0.75rem;
+  border-radius: 0.5rem;
   font-size: 0.8125rem;
 }
 
 .model-box,
 .final-note {
   margin-top: 1.5rem;
-  padding: 1rem;
-  border-radius: 0.5rem;
+  padding: 1.125rem;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
   background: var(--surface-muted);
 }
 
@@ -582,6 +814,10 @@ code {
   margin-bottom: 0;
 }
 
+.model-box p {
+  color: var(--text-muted);
+}
+
 footer {
   padding: 1.5rem 1rem;
   border-top: 1px solid var(--border);
@@ -595,6 +831,54 @@ footer p {
   margin: 0;
 }
 
+/* ---------- Animations ---------- */
+
+@keyframes panel-in {
+  from {
+    opacity: 0;
+    transform: translateY(14px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+@keyframes pop-in {
+  0% {
+    opacity: 0;
+    transform: scale(0.5);
+  }
+  70% {
+    transform: scale(1.08);
+  }
+  100% {
+    opacity: 1;
+    transform: scale(1);
+  }
+}
+
+@keyframes shake {
+  0%,
+  100% {
+    transform: translateX(0);
+  }
+  25% {
+    transform: translateX(-4px);
+  }
+  75% {
+    transform: translateX(4px);
+  }
+}
+
+@keyframes spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+/* ---------- Responsive ---------- */
+
 @media (max-width: 42rem) {
   .local-badge {
     display: none;
@@ -611,12 +895,16 @@ footer p {
     grid-template-columns: 1fr;
   }
 
+  .safety-note::before {
+    grid-row: auto;
+  }
+
   .steps li em {
     font-size: 0.6875rem;
   }
 
   .panel {
-    border-radius: 0.5rem;
+    border-radius: var(--radius);
   }
 
   .actions {
@@ -636,9 +924,15 @@ footer p {
 }
 
 @media (prefers-reduced-motion: reduce) {
+  html {
+    scroll-behavior: auto;
+  }
+
   *,
   *::before,
   *::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
     scroll-behavior: auto !important;
     transition-duration: 0.01ms !important;
   }