merge: mem-agent-0509 into mem-agent-0512

apps/memos-local-plugin/.gitignore

@@ -1,7 +1,6 @@
 node_modules/
 dist/
-web/dist/
-site/dist/
+viewer/dist/
 coverage/
 
 # Local builds & artifacts
@@ -18,3 +17,11 @@ coverage/
 TODO.local.md
 AGENTS_*.md
 .test_*
+
+# ARMS telemetry credentials — generated by CI from secrets before
+# `npm publish` (see scripts/generate-telemetry-credentials.cjs and
+# .github/workflows/hermes-plugin-publish.yml). Never commit a real
+# endpoint/pid: any developer with a local copy must keep it out of
+# git. Counters the repo-root `.gitignore`'s `!apps/**/*.json`
+# allow-rule.
+telemetry.credentials.json

apps/memos-local-plugin/.npmignore

@@ -8,9 +8,6 @@ tests/
 .notes/
 TODO.local.md
 
-# Site is local-only; never publish dist
-site/dist/
-
 # Editor / OS
 .DS_Store
 .vscode/

apps/memos-local-plugin/ARCHITECTURE.md

@@ -3,7 +3,7 @@
 This document is the living blueprint for `@memtensor/memos-local-plugin`. It
 covers the layering, the agent-agnostic core, the contract layer, the per-agent
 adapters, the runtime services (server + bridge), the viewer, and the supporting
-docs/site/test infrastructure.
+docs/test infrastructure.
 
 > If a module disagrees with this document, fix the document **or** the module.
 > Don't let them drift.
@@ -74,12 +74,13 @@ docs/site/test infrastructure.
             ┌──────────────────┐        ┌──────────────────┐
             │   server/ (HTTP) │        │   bridge.cts     │
             │   /api · /events │        │   JSON-RPC daemon │
-            │   serves web/dist│        │   used by Hermes  │
+            │   serves viewer/ │        │   used by Hermes  │
+            │       dist       │        │                   │
             └────────┬─────────┘        └──────────────────┘
                      │
                      ▼
             ┌──────────────────────────┐
-            │       web/ (viewer)      │
+            │      viewer/             │
             │  Overview · Traces · …   │
             │  Logs · Settings · …     │
             └──────────────────────────┘
@@ -151,7 +152,6 @@ GET    /api/skills          list + lifecycle
 POST   /api/feedback        explicit user feedback
 GET    /api/retrieval/preview run a tier1+2+3 retrieval against an arbitrary query
 GET    /api/hub/*           team-sharing surface
-GET    /api/changelog       lists site/content/releases/*.md (read-only)
 GET    /api/logs/tail       channelled, paginated, with `?level=&channel=&limit=`
 GET    /events              SSE: every CoreEvent + every log line (after redact)
 ```
@@ -185,7 +185,7 @@ Python package. Implements Hermes' `MemoryProvider` interface and proxies to
 - `memos_provider/log_forwarder.py` — forward Python-side logs back over the
   bridge so everything ends up in the same `logs/` directory.
 
-### 3.7 `web/`
+### 3.7 `viewer/`
 
 Vite app, served at runtime by `server/static.ts`. Ten views map 1:1 to the
 algorithm's observable surface:
@@ -203,26 +203,17 @@ algorithm's observable surface:
 | Logs         | Channelled, level-filtered, real-time + tail                  |
 | Settings     | Config editor (writes back to `config.yaml`)                  |
 
-### 3.8 `site/`
-
-Local-only static site (Vite, separate config). Hosts:
-
-- The product landing page.
-- User-facing docs (`site/content/docs/*.md`).
-- All published release notes (`site/content/releases/<version>.md`), indexed
-  by `site/scripts/build-index.ts`, gated by `release:check` in CI.
-
-### 3.9 `templates/`
+### 3.8 `templates/`
 
 Plain files copied — never edited at runtime — by `install.sh`:
 
 - `config.openclaw.yaml`
 - `config.hermes.yaml`
 - `README.user.md`
 
-### 3.10 `docs/`
+### 3.9 `docs/`
 
-Developer-facing docs that are too detailed for the marketing site:
+Developer-facing docs:
 
 - `ALGORITHM.md` — the V7 spec, restated and indexed against the code.
 - `DATA-MODEL.md` — every table, every column, every index.
@@ -396,9 +387,7 @@ Common helpers:
 ## 7. Release & versioning
 
 - SemVer.
-- Every published version requires a `site/content/releases/<version>.md`
-  (enforced by `npm run release:check`, run in CI).
-- `CHANGELOG.md` at the project root is regenerated from those files.
+- `CHANGELOG.md` at the project root is hand-maintained per release.
 - `core/update-check/` lets the running plugin notify users when a newer npm
   version is available.
 

apps/memos-local-plugin/CHANGELOG.md

@@ -1,13 +1,12 @@
 # Changelog
 
-All notable changes to `@memtensor/memos-local-plugin` are documented per
-release in [`site/content/releases/`](./site/content/releases/). This file is
-regenerated from those release notes by `npm run release:index`.
-
-> Do **not** edit this file by hand. Edit the per-version markdown in
-> `site/content/releases/<version>.md` instead.
+Notable changes to `@memtensor/memos-local-plugin`. Maintained by hand;
+for the full per-commit history use `git log` or the GitHub releases page.
 
 ## Index
 
-- [`2.0.0-beta.1`](./site/content/releases/2.0.0-beta.1.md) — Complete end-to-end implementation: L1/L2/L3/Skill layers, three-tier retrieval, decision repair, crystallization, dual adapters, HTTP/SSE server, Vite viewer & product site.
-- [`2.0.0-alpha.1`](./site/content/releases/2.0.0-alpha.1.md) — Project skeleton, agent-contract layer, install.sh entrypoint, viewer/site directory layout.
+- `2.0.0-beta.1` — Complete end-to-end implementation: L1/L2/L3/Skill layers,
+  three-tier retrieval, decision repair, crystallization, dual adapters,
+  HTTP/SSE server, Vite viewer.
+- `2.0.0-alpha.1` — Project skeleton, agent-contract layer, install.sh
+  entrypoint, viewer directory layout.

apps/memos-local-plugin/README.md

@@ -34,8 +34,7 @@ apps/memos-local-plugin/
 ├── adapters/openclaw/   # In-process TS adapter for OpenClaw
 ├── adapters/hermes/     # Python adapter that talks to bridge.cts
 ├── templates/           # config.yaml templates copied to the user's home on install
-├── web/                 # Runtime viewer (Vite, served by server/)
-├── site/                # Local-only marketing site + docs + release notes
+├── viewer/              # Runtime viewer (Vite, served by server/)
 ├── docs/                # Developer-facing docs (algorithm, data model, prompts, …)
 ├── scripts/             # Build / packaging / release helpers
 └── tests/               # unit / integration / e2e (vitest)

apps/memos-local-plugin/adapters/hermes/install.hermes.sh

@@ -6,8 +6,8 @@
 # extras:
 #
 #   1. Install node_modules inside $PREFIX (idempotent).
-#   2. Build the viewer + site bundles so the HTTP server has static
-#      assets available.
+#   2. Build the viewer bundle so the HTTP server has static assets
+#      available.
 #   3. Symlink the Python memos_provider package into the Hermes
 #      plugins directory so `from memos_provider import MemTensorProvider`
 #      resolves from Hermes without extra path munging.
@@ -41,7 +41,7 @@ fi
 
 # ── 2. viewer bundle ──────────────────────────────────────────────────────────
 if [[ -x "./node_modules/.bin/vite" ]]; then
-  log "Building viewer bundle → web/dist/"
+  log "Building viewer bundle → viewer/dist/"
   ./node_modules/.bin/vite build --config vite.config.ts >/dev/null
 else
   warn "vite not found in node_modules; skipping bundle build"
@@ -64,4 +64,3 @@ log "Hermes adapter install complete."
 log "  Plugin code:   $PREFIX"
 log "  Runtime data:  $HOME_DIR"
 log "  Viewer:        http://127.0.0.1:18910/"
-log "  Site:          http://127.0.0.1:18910/site/"

apps/memos-local-plugin/adapters/hermes/memos_provider/bridge_client.py

@@ -103,13 +103,15 @@ def __init__(
         # not rewrite `.js` import specifiers to the corresponding `.ts`
         # files on disk — and the source tree uses `.js` extensions in
         # every import per the TSC / bundler convention. We therefore
-        # launch the bridge via the bundled `tsx` binary, which handles
-        # both jobs (strip types + extension rewrite). `tsx` is declared
-        # as a production dependency in package.json so it's always present
-        # under node_modules/.bin after `npm install`.
-        tsx_bin = plugin_root / "node_modules" / ".bin" / "tsx"
-        if tsx_bin.exists():
-            cmd = [node, str(tsx_bin), script, f"--agent={agent}"]
+        # launch the bridge via the bundled `tsx` CLI, which handles
+        # both jobs (strip types + extension rewrite). On Windows the
+        # `.bin/tsx` file is a POSIX shell shim; invoking it as
+        # `node .bin/tsx` makes Node parse shell syntax as JavaScript.
+        # Use tsx's real JS entrypoint when we are launching through a
+        # specific Node binary.
+        tsx_cli = plugin_root / "node_modules" / "tsx" / "dist" / "cli.mjs"
+        if tsx_cli.exists():
+            cmd = [node, str(tsx_cli), script, f"--agent={agent}"]
         else:
             # Fallback path: `node --import tsx` reproduces the same loader
             # inline. Requires tsx to be resolvable as a package from the
@@ -123,6 +125,8 @@ def __init__(
             stdout=subprocess.PIPE,
             stderr=subprocess.PIPE,
             text=True,
+            encoding="utf-8",
+            errors="replace",
             bufsize=1,
             env=env,
             cwd=str(plugin_root),