oysterun 0.1.0 → 0.1.1-beta.0

package/docs/routec/cloud_deplyments.md

@@ -329,11 +329,14 @@ CPU usage
 Memory used
 Disk used
 Backend RSS
+APNs deliveries
 ```
 
 Chart layout is two cards per row on desktop/tablet and one card per row on
 small screens. Each chart shows y-axis min/max ticks and x-axis first/last
 bucket labels. Percent charts use a fixed 0% to 100% y-axis.
+The APNs deliveries chart belongs in the first Operational Charts block. The
+second APNs Deliveries block is for the latest sanitized delivery table only.
 
 Each chart card has its own range controls:
 

package/docs/routec/config_hierachy.md

@@ -440,11 +440,15 @@ CPU usage
 Memory used
 Disk used
 Backend RSS
+APNs deliveries
 ```
 
 Dashboard rendering uses two chart cards per row on desktop/tablet, one per row
 on small screens, y-axis min/max ticks, and x-axis first/last bucket labels.
 Percent charts use a fixed 0% to 100% scale.
+The APNs deliveries chart is rendered in the first Operational Charts block;
+the APNs Deliveries section below it is reserved for the latest sanitized
+delivery table.
 
 Every chart card exposes independent `1h`, `1d`, `1w`, and `1m` range controls.
 The `1m` range maps to the 30-day retention window.

package/docs/routec/npmjs_publish.md

@@ -213,24 +213,99 @@ web login / sessions page works
 phone QR/manual login works
 ```
 
-Only after the gate passes, publish:
+Only after the gate passes, Owner publishes from the staging package.
 
-```bash
-npm publish
-```
+Do not use the deprecated `npm publish --otp <code>` flow as the normal
+Oysterun publish path. npm now requires Owner to complete the account auth/2FA
+flow directly, so the maintainer should provide the exact command block and let
+Owner run the final `npm publish` command in an authenticated terminal.
 
-For beta:
+Owner publish script:
 
 ```bash
+cd /Users/wanghsuanchung/Projects/OysterunOwnerManualWork
+npm run package:npm
+
+cd /Users/wanghsuanchung/Projects/OysterunOwnerManualWork/dist/npm/oysterun
+npm pack --dry-run
 npm publish --tag beta
 ```
 
-For stable:
+For stable, replace the last command with:
 
 ```bash
 npm publish --tag latest
 ```
 
+## Dist Tag Verification And Beta Practice
+
+After publishing, verify registry tags explicitly. The publish success line:
+
+```text
++ oysterun@0.1.0
+```
+
+only proves that the version was published. It does not prove which dist-tag was
+assigned.
+
+Verification commands:
+
+```bash
+npm dist-tag ls oysterun
+npm view oysterun dist-tags --json
+npm view oysterun@beta version
+npm view oysterun@latest version
+```
+
+Install-channel smoke:
+
+```bash
+npm install -g oysterun@beta
+oysterun --help
+```
+
+Current first publish result, 2026-06-06:
+
+```text
+beta:   0.1.0
+latest: 0.1.0
+```
+
+This is acceptable for the first public bootstrap package because there was no
+previous stable version to preserve. It means both commands install the same
+package:
+
+```bash
+npm install -g oysterun@beta
+npm install -g oysterun
+```
+
+Best practice for future beta releases:
+
+```text
+Use prerelease semver for beta channel:
+  0.1.1-beta.0
+  0.1.1-beta.1
+
+Publish those with:
+  npm publish --tag beta
+
+Keep latest for stable releases only:
+  0.1.1
+  npm publish --tag latest
+```
+
+If a future beta publish accidentally moves `latest` away from the last stable
+release, restore `latest` explicitly:
+
+```bash
+npm dist-tag add oysterun@<last-stable-version> latest
+```
+
+Do not use a semver-looking string as a dist-tag. `beta`, `next`, and `canary`
+are valid channel names; tags like `v1.4` are not appropriate because npm
+dist-tags share the same namespace as versions.
+
 ## Manual Product Smoke
 
 After install/setup, maintainers may run a manual Cloud notification smoke.

package/host-service/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oysterun-host-service",
-  "version": "0.1.0",
+  "version": "0.1.1-beta.0",
   "type": "module",
   "description": "Oysterun host service — runs on Mac mini, manages Claude Code sessions",
   "scripts": {

package/host-service/setup.mjs

@@ -417,14 +417,14 @@ function isPrivateLanAddress(address) {
   if (value === null) return false;
   const ten = ipToNumber("10.0.0.0");
   const tenEnd = ipToNumber("10.255.255.255");
-  const172 = ipToNumber("172.16.0.0");
-  const172End = ipToNumber("172.31.255.255");
-  const192 = ipToNumber("192.168.0.0");
-  const192End = ipToNumber("192.168.255.255");
+  const private172Start = ipToNumber("172.16.0.0");
+  const private172End = ipToNumber("172.31.255.255");
+  const private192Start = ipToNumber("192.168.0.0");
+  const private192End = ipToNumber("192.168.255.255");
   return (
     (value >= ten && value <= tenEnd) ||
-    (value >= const172 && value <= const172End) ||
-    (value >= const192 && value <= const192End)
+    (value >= private172Start && value <= private172End) ||
+    (value >= private192Start && value <= private192End)
   );
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oysterun",
-  "version": "0.1.0",
+  "version": "0.1.1-beta.0",
   "type": "module",
   "description": "Oysterun Host installer and local service",
   "bin": {