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:
shumeiko.it
2026-11-01 00:50:06 +01:00
parent 9276723f25
commit 72a2a895a5
5 changed files with 21 additions and 313 deletions

View File

@@ -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.