Skip to content

feat(memos-local-plugin): v2.0 full rewrite with Reflect2Evolve architecture#1511

Merged
hijzy merged 2 commits intoMemTensor:mainfrom
hijzy:feat/memos-local-plugin-v2
Apr 22, 2026
Merged

feat(memos-local-plugin): v2.0 full rewrite with Reflect2Evolve architecture#1511
hijzy merged 2 commits intoMemTensor:mainfrom
hijzy:feat/memos-local-plugin-v2

Conversation

@hijzy
Copy link
Copy Markdown
Collaborator

@hijzy hijzy commented Apr 22, 2026

Summary

Complete end-to-end rewrite of apps/memos-local-plugin/ into a layered, agent-agnostic memory runtime with adapters for both OpenClaw and Hermes. This replaces the previous src/ + www/ layout on main entirely.

The change is fully scoped to apps/memos-local-plugin/ — no other package is modified.

What's new

  • core/ — agent-agnostic runtime: capture, embedding, feedback, hub, LLM client, logger, memory (L1/L2/L3), pipeline, reward, recall, retrieval, session, skill, storage, config. Each module ships with a README.md and, where relevant, an ALGORITHMS.md.
  • adapters/ — agent-specific integrations isolated from core:
    • openclaw/ — TS bridge + tools + installer
    • hermes/ — Python memos_provider + bridge client + install script
  • agent-contract/ — the only shared contract between core and adapters (dto / errors / events / jsonrpc / log-record / memory-core).
  • bridge/ — JSON-RPC stdio bridge (methods.ts, stdio.ts).
  • server/ — HTTP/SSE server backing the viewer.
  • web/ — Vite viewer app (Overview / Memories / Policies / Skills / Tasks / WorldModels / Settings views).
  • site/ — Vite-built public product site + per-version release notes index.
  • docs/ — algorithm alignment, data model, logging, manual E2E scenario, Reflect2Skill design core, multi-agent viewer.
  • tests/ — vitest unit + integration + Python bridge tests.
  • Tooling — multi-project TS build (tsconfig.{json,site,web}.json), Vite + Vitest, cross-platform install.sh / install.ps1, npm release checker, package-lock.json committed.

Structural changes vs main

  • Removes the legacy src/ and www/ layout on main — the new module layout supersedes it.
  • Both .gitignore and .npmignore updated to cover new build outputs (site/dist/, web/dist/, coverage/, etc.).

Stats

615 files changed · +94,489 / −36,040.

Type of change

  • New feature (non-breaking change which adds functionality)
  • Refactor (significant restructuring of apps/memos-local-plugin/)

Test plan

  • cd apps/memos-local-plugin && npm install
  • npm run lint
  • npm test (vitest unit + integration)
  • Manual E2E per apps/memos-local-plugin/docs/MANUAL_E2E_TESTING.md
  • OpenClaw adapter install: ./install.sh on macOS/Linux; install.ps1 on Windows
  • Hermes adapter install: adapters/hermes/install.hermes.sh
  • Viewer smoke test: npm run dev:web → open Overview / Memories / Skills views
  • Site build: npm run build:site

hijzy added 2 commits April 22, 2026 10:40
…tecture

Complete end-to-end rewrite of the memos-local-plugin package into a
layered, agent-agnostic memory runtime with support for both OpenClaw
and Hermes adapters.

Highlights:
- New `core/` package (agent-agnostic): capture, embedding, feedback,
  hub, LLM client, logger, memory (L1/L2/L3), pipeline, reward, recall,
  retrieval, skill, session, storage, config modules — each with its
  own README + ALGORITHMS notes.
- New `adapters/` layer with `openclaw/` and `hermes/` integrations
  isolated from core. Agent-specific concepts (turns, installers,
  bridge clients) live only here.
- New `agent-contract/` — single shared contract (dto, errors, events,
  jsonrpc, log-record, memory-core) between core and adapters.
- New `bridge/` — JSON-RPC stdio bridge (methods.ts, stdio.ts).
- New `server/` — HTTP/SSE server for the viewer.
- New `site/` — Vite-built public product site + release notes index.
- New `web/` — Vite-built viewer app with memory/skill/timeline/world
  model views.
- New `docs/` — ALGORITHM, DATA-MODEL, LOGGING, MANUAL_E2E_TESTING,
  Reflect2Skill design core, multi-agent viewer, etc.
- New `tests/` — vitest unit/integration + python bridge tests.
- Tooling: TypeScript multi-project build (tsconfig.{json,site,web}),
  Vite + Vitest, cross-platform install.sh / install.ps1, npm release
  checker, package-lock committed.
- Removes legacy `src/` and `www/` structure from main branch; the new
  layout replaces it entirely.

This change is fully scoped to apps/memos-local-plugin/ and does not
touch any other package.
- Remove unused imports (Iterable, Dict, List) in memos_provider/__init__.py
- Move Callable into TYPE_CHECKING block in bridge_client.py
- Replace try/except/pass with contextlib.suppress in bridge_client.py
- Combine nested if in test_bridge_client.py
- Apply ruff format to 4 Python files (hermes adapter + tests)

All files now pass `ruff check` and `ruff format --check`.
@hijzy hijzy merged commit 8e247bd into MemTensor:main Apr 22, 2026
16 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant