pi-beyin 0.1.7 → 0.1.8

package/README.md

@@ -77,20 +77,20 @@ The extensions call `beyin.py` (read-only unless the agent runs a write command)
 A vault whose `beyin.py` does not accept `--harness pi` needs `tools/pi-harness-patch.py ensure
 --vault <vault>` (the extension does this on session start).
 
-## Relationship to beyin v3
-
-`pi-beyin` is the **pi-side** adapter; the vault, `beyin.py` and the canonical skill templates belong to
-beyin v3 and keep their own release cycle.
-
-- `tools/pi-harness-patch.py` is the only thing that touches beyin's files: it adds `pi` to the harness
-  list in two managed modules (plus three pi-specific fixes) and re-syncs the install manifest so
-  `beyin.py update` plans cleanly. **A beyin update reverts these edits**; the extension calls `ensure`
-  on session start, so they come back by themselves. `status` is read-only.
-- The skills here are **copies for pi**, not links into the vault. beyin still installs its own copies
-  under `.claude/skills/` for the other harnesses; pi does not read that directory.
-- Notifications stay in the adapter: the injected context, the receipt reminder, the distillation
-  suggestion and the `beyin_jev_*` tool descriptions ship with this package. They are written in Turkish
-  today (the author's language); anything a *skill* writes follows the user's language.
+## Scope
+
+This package is the **pi side**: extensions, skills and the harness patch. The vault and its `beyin.py`
+CLI are yours to install and update separately; this package never needs to know their version.
+
+- `tools/pi-harness-patch.py` is the only piece that touches the vault's Python: it adds `pi` to the
+  harness list in five managed modules and re-syncs the install manifest so updates plan cleanly.
+  An update of the vault reverts those edits; the extension calls `ensure` on session start, so they
+  come back by themselves. `status` is read-only.
+- The skills here are **copies for pi**, not links into the vault. Other harnesses keep their own copies
+  under `.claude/skills/`; pi does not read that directory.
+- Notifications live in the adapter: the injected context, the receipt reminder, the distillation
+  suggestion and the `beyin_jev_*` tool descriptions ship here. They are written in Turkish today (the
+  author's language); anything a *skill* writes follows the user's language.
 
 ## Project memory skills
 

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,33 @@
+# Third-party notices
+
+## beyin
+
+`tools/pi-harness-patch.py` contains short source excerpts from the beyin vault code that it patches
+(the harness tuples, the Jev request headers and the assessment entry point). Those excerpts remain
+under beyin's license:
+
+```
+MIT License
+
+Copyright (c) 2026 Forn
+
+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.
+```
+
+Everything else in this repository is MIT, see [LICENSE](LICENSE).

package/extensions/context.ts

@@ -1,5 +1,5 @@
 /**
- * Beyin V3 — pi-native bridge (the pi equivalent of the beyin hook).
+ * pi-native bridge for the beyin vault (the pi equivalent of the beyin hook).
  *
  * Beyin's OMP/OpenCode/Claude/Codex hooks do not run in pi. This extension pulls
  * relevant notes from the local second brain on every user prompt and injects them

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-beyin",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "pi-native bridge for the beyin second brain: context injection, distillation reminders, and Jev advisor tools.",
   "keywords": [
     "pi-package",
@@ -34,7 +34,8 @@
     "skills",
     "tools",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "THIRD-PARTY-NOTICES.md"
   ],
   "scripts": {
     "test": "bash test/run.sh",

package/skills/brain/SKILL.md

@@ -236,14 +236,14 @@ the applications are closed. In sparse-check or manual mode, refresh the source
 information is needed; don't assume an old session context is current. Work started earlier may have finished;
 turning it off stops the next jobs.
 
-The default V3 engine makes no automatic call to Luna, Sonnet or any other model. The Jev auto_context feature,
+The default engine makes no automatic call to Luna, Sonnet or any other model. The Jev auto_context feature,
 which the user enables explicitly and separately, is a limited, optional remote consultation outside that rule.
 Local checks consume no tokens; the results the agent writes and the context it reads or adds count toward the
 client's usage. A character limit is not a guarantee of token count or cost. A 15-minute agent automation the
 user installed separately is not governed by this setting; examine it separately. Don't add a paid scheduler, a
 model runner or a new dependency without being asked.
 
-V3.1: the `updates` section inside `doctor` shows the latest version check; a network error does not prove being
+The `updates` section inside `doctor` shows the latest version check; a network error does not prove being
 up to date. Use `beyin.py update --check --metadata-only` only for a version question. Route an update request to
 the `brain-update` skill.
 

package/skills/brain-doctor/SKILL.md

@@ -64,7 +64,7 @@ Tell the user three things: the part that works, the unverified/broken part, and
 one. Give a short, concrete result instead of raw JSON. If the user's existing approval covers the safe fix, don't
 ask again for nothing.
 
-V3.1: the `updates` section inside `doctor` shows the latest version check; a network error does not prove being up
+The `updates` section inside `doctor` shows the latest version check; a network error does not prove being up
 to date. Use `beyin.py update --check --metadata-only` only for a version question. Route an update request to the
 `brain-update` skill.
 

package/skills/brain-update/SKILL.md

@@ -33,7 +33,7 @@ user step.
 In the result message give the previous→new version, the verification result and any step left open. Don't share
 tokens, local user paths, personal settings dumps or raw logs.
 
-If `--metadata-only` is not recognized (a version before V3.1), fall back to the existing `update --check`. Version
+If `--metadata-only` is not recognized (older beyin), fall back to the existing `update --check`. Version
 notifications are an on-by-default daily GitHub metadata check; they post no notes. Apply an off/on request with
 `preferences --update-notifications off/on`. To silence one version use `update --dismiss X.Y.Z`. A metadata-only
 result is not proof that the package can be installed.

package/tools/pi-harness-patch.py

@@ -1,11 +1,11 @@
 #!/usr/bin/env python3
-"""Add "pi" as a first-class Beyin V3 harness, update-safely.
+"""Add "pi" as a first-class beyin harness, update-safely.
 
 Why this exists
 ---------------
-Beyin V3 knows the harnesses codex/claude/antigravity/hermes/opencode/omp, but not
+beyin knows the harnesses codex/claude/antigravity/hermes/opencode/omp, but not
 pi. That blocks `beyin.py receipt --harness pi` and `context --harness pi`, so pi
-work is mislabeled. Pi runs outside Beyin's own hooks, so the fix has to live here.
+work is mislabeled. pi runs outside beyin's own hooks, so the fix has to live here.
 
 How it stays update-safe
 ------------------------