docs: drop references to the removed packages (P2.2)
AGENTS.md records that the excluded packages left in P2.2. SECURITY.md scopes memory to memory-contract and memory-mem0. THREAT_MODEL.md points the injection scanner at @waggle/core, marks the MCP tool scope gate as removed with the memory MCP servers, and drops the hive-mind copy of the URL egress guard. docs/ARCHITECTURE.md lists the memory packages instead of the hive-mind substrate. docs/methodology.md, the LoCoMo write-up of the hive-mind engine whose reproduction steps pointed at the maintainer's hive-mind repository, is removed.
This commit is contained in:
@@ -2,11 +2,10 @@
|
||||
|
||||
Waggle is a monorepo with **28 packages** under `packages/` organized around a layered architecture: the memory substrate, agent intelligence, server API, and UI presentation. This document covers the package structure, data flow, and extension points.
|
||||
|
||||
> **Note (2026-04-30 monorepo migration):** the persistent-memory substrate
|
||||
> (`mind/` + `harvest/`) moved out of `@waggle/core` into
|
||||
> `@waggle/hive-mind-core` (`packages/hive-mind-core/src/{mind,harvest}`). The
|
||||
> React UI is **not** a package — it lives in `apps/web/src`. There is no
|
||||
> `@waggle/ui` package.
|
||||
> **Note:** memory goes through `@waggle/memory-contract`, implemented on local
|
||||
> mem0 by `@waggle/memory-mem0` (ADR-0007). The React UI is **not** a package — it
|
||||
> lives in `apps/web/src`. There is no `@waggle/ui` package. This document predates
|
||||
> the community edition and is rewritten in P2.4.
|
||||
|
||||
## Package Overview
|
||||
|
||||
@@ -14,7 +13,6 @@ Waggle is a monorepo with **28 packages** under `packages/` organized around a l
|
||||
waggle-os/
|
||||
apps/
|
||||
web/ # Main web app UI (React 19 + Vite + Tailwind 4 + base-ui/react)
|
||||
www/ # Marketing site (Next.js)
|
||||
browser-ext/ # Browser extension (unpacked; not an npm workspace)
|
||||
packages/
|
||||
# Product packages (MIT)
|
||||
@@ -30,40 +28,19 @@ waggle-os/
|
||||
sdk/ # Plugin/skill SDK, capability packs, starter skills
|
||||
cli/ # Command-line REPL
|
||||
launcher/ # AI-tool launcher / dock backend
|
||||
admin-web/ # Admin dashboard for team deployments
|
||||
wiki-compiler/ # Knowledge / wiki compiler
|
||||
memory-mcp/ # MCP server exposing the memory substrate to external agents
|
||||
# Memory substrate — hive-mind-* (Apache-2.0), mirrored to marolinik/hive-mind
|
||||
hive-mind-core/ # The substrate: FrameStore, HybridSearch, KnowledgeGraph, Identity/Awareness, Harvest (src/mind + src/harvest)
|
||||
hive-mind-cli/ # CLI for the substrate
|
||||
hive-mind-mcp-server/ # MCP server for the substrate
|
||||
hive-mind-shim-core/ # Signal-emitter shim library
|
||||
hive-mind-wiki-compiler/# Wiki compiler (OSS)
|
||||
hive-mind-hooks-core/ # Shared hook library
|
||||
hive-mind-hooks-*/ # Per-tool capture hooks: claude-code, claude-desktop, codex,
|
||||
# codex-desktop, cursor, hermes, openclaw
|
||||
memory-contract/ # MemoryStore interface, record model, capability map
|
||||
memory-mem0/ # MemoryStore on local mem0
|
||||
sidecar/ # Node.js sidecar for Tauri desktop app
|
||||
app/ # Tauri 2.0 desktop shell (Rust + WebView2) — loads the apps/web build
|
||||
```
|
||||
|
||||
## Package Details
|
||||
|
||||
### @waggle/hive-mind-core
|
||||
### @waggle/memory-contract and @waggle/memory-mem0
|
||||
|
||||
The persistent-memory substrate (Apache-2.0; mirrored to the public
|
||||
[`marolinik/hive-mind`](https://github.com/marolinik/hive-mind) repo). Zero
|
||||
network dependencies; runs on SQLite + sqlite-vec.
|
||||
|
||||
- **MindDB** (`src/mind/db.ts`, `schema.ts`): SQLite wrapper for `.mind` files. Tables for memory frames, knowledge-graph entities/relations, embeddings, sessions, and improvement signals.
|
||||
- **FrameStore** (`src/mind/frames.ts`): CRUD on memory frames with FTS5 full-text search, importance ranking, and access counting.
|
||||
- **HybridSearch** (`src/mind/search.ts`): vector + keyword retrieval, with an optional cross-encoder reranker.
|
||||
- **KnowledgeGraph** (`src/mind/knowledge.ts`): entity-relation graph with temporal validity (`valid_from`/`valid_to`).
|
||||
- **IdentityLayer / AwarenessLayer** (`src/mind/identity.ts`, `awareness.ts`): personal-identity persistence and active task/state tracking.
|
||||
- **Embeddings** (`src/mind/*-embedder.ts`): pluggable providers — in-process, Ollama, Voyage, OpenAI, mock.
|
||||
- **Harvest** (`src/harvest/`): conversation/file ingestion adapters (ChatGPT, Claude, Claude Code, Gemini, Perplexity, PDF, markdown, URL, plaintext) plus the dedup pipeline.
|
||||
|
||||
> Develop the substrate **here** and mirror it out — never the reverse. See the
|
||||
> "Memory Substrate Sync" section of the root [`CLAUDE.md`](../CLAUDE.md).
|
||||
`MemoryStore` (remember, search, list, get, update, forget, history) with its record
|
||||
model and capability map, and its implementation on the open-source mem0 library,
|
||||
running locally in the sidecar (ADR-0007).
|
||||
|
||||
### @waggle/core
|
||||
|
||||
@@ -71,7 +48,7 @@ The foundation layer for the desktop/server runtime. Zero network dependencies.
|
||||
|
||||
- **WaggleConfig**: Configuration management (`~/.waggle/config.json`). Provider keys, default model, team server config.
|
||||
- **Vault**: AES-256-GCM encrypted secret storage. Stores API keys, connector credentials, and sensitive metadata.
|
||||
- **MultiMind**: Manages personal + workspace minds simultaneously — routes searches to both and merges results. Wraps the `@waggle/hive-mind-core` substrate.
|
||||
- **MultiMind**: Manages personal + workspace minds simultaneously — routes searches to both and merges results.
|
||||
- **FileStore**: Workspace filesystem access with a segment-boundary + symlink-aware containment guard and a secret deny-list (see the [threat model](../THREAT_MODEL.md)).
|
||||
- **CronStore**: Schedule management for the cron service. CRUD on cron expressions with last/next run tracking.
|
||||
- **ImportParser** (`memory-import.ts`): parses ChatGPT and Claude export files into importable knowledge items.
|
||||
|
||||
Reference in New Issue
Block a user