this.me 3.1.5 → 3.1.7

package/README.md

@@ -8,6 +8,11 @@
 ```bash
 npm install this.me
 ```
+
+<p align="right">
+  <a href="https://neurons-me.github.io/.me/docs/">✍ Read the Docs →</a>
+</p>
+
 ## **Start .me in 60 seconds**
 ###### Import
 ```ts
@@ -64,6 +69,25 @@ me.home.kitchen.lights["="]("avg", "(main.brightness + leds.brightness) / 2"); /
 me("home.kitchen.lights.avg"); // → 60
 ```
 
+```txt
+Runtime output (real):
+  avg -> 60
+
+  inspect().index ->
+  {
+    "home.kitchen.lights.main.brightness": 80,
+    "home.kitchen.lights.leds.brightness": 40,
+    "home.kitchen.lights.avg": 60
+  }
+
+  last thoughts ->
+  [
+    { path: "home.kitchen.lights.main.brightness", op: null, value: 80 },
+    { path: "home.kitchen.lights.leds.brightness", op: null, value: 40 },
+    { path: "home.kitchen.lights.avg", op: "=", value: 60 }
+  ]
+```
+
 You can **bridge** distant rooms with **Pointers**:
 ```ts
 // Create a "Master Switch" at your root
@@ -107,6 +131,19 @@ me.wallet.balance(500);
 me.wallet.note("Private savings");
 ```
 
+```txt
+After these writes:
+
+Public index plane (inspect().index):
+  "" -> { __id: "jabellae" }
+
+Secret scope roots:
+  ["wallet"]
+
+Encrypted branch plane (exportSnapshot().encryptedBranches):
+  wallet -> 0x4b46...6f1c4e
+```
+
 Everything under a `["_"]` scope is **stored as an Encrypted Blob**. By design, secret roots are Stealth:
 ```ts
 me("wallet"); // → undefined (The root is a ghost)
@@ -136,6 +173,22 @@ me("wallet.hidden.note");// → "Deep dark secret"
 - If you declare another secret inside, it becomes a deeper encrypted scope.
 - Reads are path-based; there is no global `me.secret(...)` unlock call.
 
+###### Structural view (public vs secret planes)
+```txt
+Public index plane (inspect().index):
+  "" -> { __id: "jabellae" }
+
+Secret scope roots:
+  ["wallet"]
+
+Encrypted branch plane (exportSnapshot().encryptedBranches):
+  wallet -> 0x4b46...6f1c4e
+
+Read behavior:
+  me("wallet") -> undefined
+  me("wallet.balance") -> 500
+```
+
 ---
 
 ## ⟐ Why .me?
@@ -232,9 +285,8 @@ The behavior is identical, bit-by-bit, because the logic is part of the state.
 ##### License
 **MIT © 2025 by https://neurons.me**
 
-See the [LICENSE](./LICENSE) file for details.
+See the `LICENSE` file in the package root for details.
 
 **∴ Witness our seal** 
 
 **suiGn**
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "this.me",
-  "version": "3.1.5",
+  "version": "3.1.7",
   "type": "module",
   "main": "./dist/me.cjs",
   "module": "./dist/me.es.js",
@@ -26,7 +26,8 @@
     "docs:api:watch": "typedoc --watch",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
-    "docs:preview": "vitepress preview docs"
+    "docs:preview": "vitepress preview docs",
+    "docs:publish": "npm run docs:build && rm -rf ../docs && mkdir -p ../docs && cp -R docs/.vitepress/dist/* ../docs/ && touch ../docs/.nojekyll"
   },
   "files": [
     "dist"