@legioncodeinc/honeycomb 0.1.0

package/README.md

@@ -0,0 +1,268 @@
+<!-- ───────────────────────────────  HERO  ─────────────────────────────── -->
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/logos/honeycomb-memory-cluster-wordmark-on-dark.svg">
+    <img src="assets/logos/honeycomb-memory-cluster-wordmark.svg" alt="Honeycomb" height="84">
+  </picture>
+</p>
+
+<p align="center">
+  <strong>Shared, persistent memory for your AI coding agents.</strong><br>
+  What one harness learns, every other one recalls, across sessions, tools, devices, and teammates.
+</p>
+
+<p align="center">
+  <a href="https://github.com/legioncodeinc/honeycomb/actions"><img src="https://img.shields.io/github/actions/workflow/status/legioncodeinc/honeycomb/ci.yaml?branch=main&label=CI&style=flat-square" alt="CI"></a>
+  <img src="https://img.shields.io/badge/version-0.1.0-F7A823?style=flat-square" alt="Version 0.1.0">
+  <img src="https://img.shields.io/badge/node-%E2%89%A522-339933?style=flat-square&logo=node.js&logoColor=white" alt="Node ≥ 22">
+  <a href="https://deeplake.ai"><img src="https://img.shields.io/badge/powered%20by-Deep%20Lake-ff5a1f?style=flat-square" alt="Powered by Deep Lake"></a>
+  <a href="#license"><img src="https://img.shields.io/badge/license-AGPL--3.0-blue?style=flat-square" alt="AGPL-3.0"></a>
+  <img src="https://img.shields.io/badge/harnesses-6-F7A823?style=flat-square" alt="6 harnesses">
+</p>
+
+<!-- ──────────────────────────────  PARTNERS  ────────────────────────────── -->
+
+<p align="center">
+  <a href="https://github.com/legioncodeinc">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="assets/logos/legion-logo-dark.svg">
+      <img src="assets/logos/legion-logo-light.svg" alt="Legion Code" height="34">
+    </picture>
+  </a>
+  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
+  <a href="https://activeloop.ai"><img src="assets/logos/activeloop-full-mark-logo.svg" alt="Activeloop" height="26"></a>
+</p>
+
+<p align="center"><sub>A <a href="https://github.com/legioncodeinc"><strong>Legion Code</strong></a> &times; <a href="https://activeloop.ai"><strong>Activeloop</strong></a> collaboration · built on <a href="https://github.com/activeloopai/hivemind">Hivemind</a> &amp; <a href="https://deeplake.ai">Deep Lake</a></sub></p>
+
+---
+
+AI coding agents forget. They forget across sessions, and they forget across tools. A decision you reached in Claude Code at midnight is invisible to Cursor the next morning. **Honeycomb fixes that.** A local daemon captures what happens on every turn, distills it, and serves it back to any harness that asks. Learn something once; recall it everywhere, on any machine, in any tool, for anyone on your team.
+
+> **New here?** One command and you're on a dashboard. [Jump to Install](#-install-one-command). · **Want the docs?** Everything lives at **[theapiary.sh](https://theapiary.sh)**.
+
+<table>
+<tr>
+<td width="50%" valign="top">
+
+#### 🛹 For vibe coders
+Stop re-explaining your project to a fresh agent every morning. Honeycomb remembers your decisions, your conventions, and the fixes that worked, then primes your next session with them automatically. One install command, a friendly dashboard, no SQL, no config gauntlet.
+
+</td>
+<td width="50%" valign="top">
+
+#### 🏢 For enterprise teams
+One shared brain across every developer, device, and coding tool. A skill discovered by one engineer propagates to the whole team on their next session. Tenancy is enforced at the storage layer; credentials live behind a single loopback boundary; everything is versioned and auditable.
+
+</td>
+</tr>
+</table>
+
+---
+
+## ✨ What makes Honeycomb different
+
+A vector database can store text and hand it back by similarity. Honeycomb does that, and then keeps going. On top of [Activeloop Deep Lake](https://deeplake.ai), **[Legion Code](https://github.com/legioncodeinc)** builds the memory system that turns raw recall into a brain your agents actually trust:
+
+- **🧠 Three-tier memory.** Every memory exists at three resolutions at once (one-line **key** → **summary** → full **raw** session). Agents skim the keys, then zoom into detail only when they need it. *(Legion Code)*
+- **🎯 Session priming.** At session start a tiny, bounded index (~300-800 tokens) of your most relevant keys is pushed once; the agent pulls deeper on demand. No per-turn injection, no "lost in the middle." *(Legion Code)*
+- **🍯 Skillify & propagation.** The daemon mines reusable skills out of real sessions, gates them for quality, and auto-pulls the team's latest skills into every agent at session start. Author a skill once; everyone gets it. *(Legion Code)*
+- **🌼 The pollinating loop.** A periodic maintenance pass reasons over accumulated memory and the entity graph to merge duplicates, prune junk, and supersede stale facts, so memory gets *sharper* over time, not noisier. *(Legion Code)*
+- **🕸️ Knowledge graph.** An entity-centric, versioned, provenance-tracked index over your memories. Newer facts supersede stale ones; every claim traces back to the session that produced it. *(Legion Code)*
+- **🔀 Hybrid recall.** Lexical (BM25) and semantic (768-dim vectors) search fused by Reciprocal Rank Fusion, with a measured **recall@5 ≈ 0.72-0.78**. *(built on Deep Lake)*
+- **🗺️ Codebase graph.** A multi-language AST graph (TypeScript, JS, Python, Go, Rust, Java, Ruby, C/C++) of files, functions, and their call/import/extends edges, queryable for impact and neighborhood. *(Legion Code)*
+
+---
+
+## 🚀 Install (one command)
+
+No Node? No npm? No problem. The installer detects and sets up everything, then **opens a dashboard in your browser**. The terminal is just a progress log; the product is the first thing you touch.
+
+```bash
+# macOS / Linux
+curl -fsSL https://get.theapiary.sh | sh
+```
+
+```powershell
+# Windows (PowerShell)
+irm https://get.theapiary.sh/install.ps1 | iex
+```
+
+That single line installs a current Node/npm if missing, installs **`@legioncodeinc/honeycomb`** globally, brings up the daemon on `127.0.0.1:3850`, and opens the dashboard. Then:
+
+1. The dashboard loads in a **pre-auth setup state**. No token ever touches your shell.
+2. Click **"First time setup."** Honeycomb runs the Deep Lake device-flow login *for* you, shows the code right on the page, and opens the verification tab.
+3. Done. The same running daemon lights up its Deep Lake-backed surfaces, and capture and recall go live.
+
+> Already running **Hivemind**? The dashboard detects it, explains that running both is unsupported, and **"Proceed with Honeycomb"** migrates you cleanly. Prefer to inspect before you pipe? The script and a published `SHA256SUMS` are served from [get.theapiary.sh](https://get.theapiary.sh).
+
+<details>
+<summary><strong>Prefer to build from source?</strong></summary>
+
+```bash
+git clone https://github.com/legioncodeinc/honeycomb.git
+cd honeycomb
+npm install
+npm run build          # tsc + esbuild → bundle/cli.js, daemon, harness, MCP, embed bundles
+
+node bundle/cli.js setup     # detect your assistants, wire hooks, start the daemon
+node bundle/cli.js status    # check the daemon and your environment
+```
+
+`setup` wires every coding assistant it detects and starts the loopback daemon; any storage command auto-starts the daemon if it is down. You'll need Activeloop Deep Lake credentials; the device flow above writes them to the shared `~/.deeplake/credentials.json`.
+
+</details>
+
+---
+
+## 🐝 First memory, shared across tools
+
+```bash
+# Capture a decision once…
+honeycomb remember "we deploy from the prd-022 branch, never from main"
+
+# …recall it anywhere: same daemon, same Deep Lake, any harness
+honeycomb recall "how do we deploy"
+```
+
+Write it from Claude Code; recall it from Cursor tomorrow on a different laptop. That's the whole point.
+
+---
+
+## 🏗️ How it works
+
+Honeycomb is a long-lived local **daemon** plus thin clients. The daemon is the *only* process that talks to storage. Every harness, the CLI, the MCP server, and the SDK reach it over loopback HTTP. One shared memory behind one boundary; your Deep Lake credentials in exactly one place.
+
+```
+     Claude Code    Cursor    Codex    Hermes    pi    OpenClaw
+          │           │         │        │       │        │
+          └───────────┴────┬────┴────────┴───────┴────────┘
+                 hooks · CLI · MCP · SDK   (thin clients)
+                           │
+                  loopback HTTP · 127.0.0.1:3850
+                           │
+            ┌──────────────────────────────┐
+            │       honeycomb daemon        │   sole storage client
+            │  capture · recall · skillify  │   owns your credentials
+            │  pollinate · session priming  │
+            └───────────────┬──────────────┘
+                            │
+            ┌──────────────────────────────┐
+            │     Activeloop Deep Lake      │   versioned · columnar + vector
+            │   Tier 1 · Tier 2 · Tier 3    │   BM25 + semantic hybrid
+            └──────────────────────────────┘
+```
+
+- **Capture on every turn.** Per-harness hooks stream each turn to the daemon, which distills and persists it: always-on, cheap, and soft-failing so a capture error never breaks your agent's turn.
+- **Recall through the daemon.** Any harness asks for relevant memories; the daemon runs the query and returns results already scoped to your org and workspace. The client never sees a storage handle or a line of SQL.
+- **Shared by construction.** Every client reaches the same daemon and the same dataset, so a memory written from one harness is recallable from all of them.
+
+---
+
+## 🧠 The three-tier memory system
+
+This is the heart of what **Legion Code** adds on top of Deep Lake. The same memory lives at three levels of detail at once, and the agent chooses how far to zoom:
+
+| Tier | What it is | When it's used |
+|---|---|---|
+| **Tier 1 · Key** | One keyword-dense sentence per session or fact. The index. | Skimmed at session start during priming. |
+| **Tier 2 · Summary** | A distilled recap: goals, decisions, blockers, outcomes. Carries the semantic embedding. | Pulled when a key looks relevant. |
+| **Tier 3 · Raw** | The full session dialogue: exact turns and tool calls, never rewritten. | Resolved when the agent needs ground truth. |
+
+Resolution is a **deterministic SQL join, not a fuzzy search**. `key → summary → raw` is a pointer walk down three Deep Lake tables. Mining ("find the thing I didn't know to name") is where the hybrid vector + lexical search kicks in. Cheap when you're skimming, precise when you're zooming.
+
+---
+
+## 💎 Why Deep Lake makes the difference
+
+Most agent-memory tools bolt onto a vector-only store, which forces *every* access pattern through a similarity engine. Honeycomb's zoom model needs both exact joins **and** semantic search, and [**Deep Lake**](https://deeplake.ai), the database for AI, gives it both natively:
+
+- **SQL + vector in one engine.** The cheap skim and the deterministic zoom run as SQL; semantic mining runs as vector search; a single store serves both. No second database, no sync problem.
+- **Versioned & append-only.** Writes bump a version instead of mutating in place, so memory's full history stays on disk. Supersession marks old facts stale without losing them, which is what makes the pollinating loop safe and auditable.
+- **Hybrid lexical + semantic search.** BM25 and 768-dim `nomic-embed-text-v1.5` cosine arms, fused by Reciprocal Rank Fusion. Turn embeddings off and recall silently falls back to lexical, never an error, no quality cliff.
+- **Built to scale & BYOC.** The same substrate that serves one developer's laptop serves an organization's entire history, in your own cloud bucket if you want it.
+
+> Honeycomb stands on two shoulders: **[Deep Lake](https://deeplake.ai)** gives the memories somewhere durable and queryable to live, and **[Hivemind](https://github.com/activeloopai/hivemind)**, Activeloop's open-source agent-memory project, is the foundation Legion Code extended into Honeycomb's multi-tier system.
+
+---
+
+## 🔌 Supported harnesses
+
+Honeycomb ships thin clients for six coding harnesses, all wired simultaneously, all reading and writing the same shared memory:
+
+| | | |
+|---|---|---|
+| **Claude Code** | **Cursor** | **Codex** |
+| **Hermes** | **pi** | **OpenClaw** |
+
+`honeycomb setup` detects the ones you have installed and wires each idempotently; `honeycomb uninstall` reverses only Honeycomb's changes. A skill mined while you were in Cursor is auto-pulled and ready in Claude Code on your next session.
+
+---
+
+## 🎛️ Interfaces
+
+Four ways to reach the same daemon and the same shared memory:
+
+- **CLI.** The unified `honeycomb` binary. Core verbs: `install`, `setup`, `status`, `daemon start|stop|status`, `remember`, `recall`, `sessions`, `skill`, `goal`, `sources`, `graph`, `dashboard`. Run `honeycomb --help` for the full list.
+- **Dashboard.** A local web UI the daemon serves at **`http://127.0.0.1:3850/dashboard`**: KPIs (memories, turns, est. savings, team skills), memory recall, the codebase graph, captured turns, skill-sync, and settings, with a live request log. It's also the guided-setup surface for first-time login.
+- **MCP server.** A [Model Context Protocol](https://modelcontextprotocol.io) server (bundled to `mcp/bundle`) exposing Honeycomb's read/resolve and search/mine tools to any MCP-capable host.
+- **TypeScript SDK.** The `@legioncodeinc/honeycomb` client with framework subpath entries (`/react`, `/vercel`, `/openai`). The core entry is fetch-only and browser-safe; `react` and `ai` are optional peers.
+
+---
+
+## 📍 Status & roadmap
+
+Honeycomb is **v0.1.0, pre-release**. We document what's real and flag what's opt-in.
+
+**Working today**
+- Capture-to-recall, proven end-to-end against live Deep Lake (`npm run smoke:golden-path` with credentials).
+- One-command install → guided dashboard setup, the loopback daemon, the unified CLI, per-harness hooks, the MCP server, and the SDK.
+- Three-tier memory, session priming, skillify + propagation, the pollinating loop, the knowledge graph, and the codebase graph.
+
+**Opt-in / by design**
+- **Embeddings are opt-in.** Recall runs the lexical BM25 path by default; turning on the local embedding runtime (≈600 MB, model fetched on first warmup) adds 768-dim semantic recall. The fallback is silent and intentional; recall never errors when embeddings are unavailable.
+- **The distillation pipeline is off by default** to avoid surprise model spend; enable it when you want background summarization and graph extraction.
+- The daemon binds **loopback only** (single machine). Cross-device and cross-user sharing happen through Deep Lake's org/workspace scope, not a remote daemon bind.
+
+Full documentation, guides, and the roadmap live at **[theapiary.sh](https://theapiary.sh)**.
+
+---
+
+## 🛠️ Development
+
+```bash
+npm install
+npm run build        # tsc + esbuild → bundle/cli.js, the daemon, harness, MCP, and embed bundles
+npm run ci           # the gate: typecheck + duplication (jscpd) + tests (vitest) + SQL-safety audit
+```
+
+`npm run ci` is the quality gate every change must pass.
+
+---
+
+## 🙏 Credits
+
+Honeycomb exists because two halves fit together:
+
+- **[Activeloop](https://activeloop.ai)** brings **[Deep Lake](https://deeplake.ai)** (the versioned, multi-modal database for AI with native vector + columnar indexing and hybrid search) and **[Hivemind](https://github.com/activeloopai/hivemind)**, the open-source agent-memory project Honeycomb is built upon.
+- **[Legion Code Inc](https://github.com/legioncodeinc)** brings the **multi-tier memory system** (Tier 1 / 2 / 3 keys, summaries, raw), **session priming**, **skillify & propagation**, the **pollinating loop**, the **knowledge graph**, and the daemon architecture that turns Deep Lake into a shared brain your coding agents read and write on every turn.
+
+Neither half stands alone. Deep Lake and Hivemind give the memories somewhere durable to live; Legion Code gives every harness one consistent way to write to and recall from it, so what one agent learns survives a closed session, a switched tool, a new machine, and a new teammate.
+
+---
+
+## License
+
+Honeycomb is licensed under the **GNU Affero General Public License v3.0 or later** ([AGPL-3.0-or-later](LICENSE)).
+
+Use it commercially or privately, free of charge. In return: keep the copyright and license notices intact, and if you modify it, your changes ship under the same AGPL license with source available. The "Affero" part is the point: run a modified version as a network service and you owe its source to the users who interact with it. No locking a fork behind a SaaS wall.
+
+© 2026 Legion Code Inc.
+
+---
+
+<p align="center">
+  <sub><strong>Built by <a href="https://github.com/legioncodeinc">Legion Code Inc</a></strong> · <strong>Powered by <a href="https://deeplake.ai">Activeloop Deep Lake</a></strong> · <strong>Built on <a href="https://github.com/activeloopai/hivemind">Hivemind</a></strong></sub><br>
+  <sub><a href="https://theapiary.sh">theapiary.sh</a></sub>
+</p>

package/assets/logos/honeycomb-memory-cluster.svg

@@ -0,0 +1,17 @@
+<svg width="160" height="160" viewBox="0 0 160 160" fill="none" xmlns="http://www.w3.org/2000/svg" role="img" aria-label="Honeycomb">
+  <defs>
+    <linearGradient id="bCell" x1="80" y1="59" x2="80" y2="101" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#FFC04D"/>
+      <stop offset="1" stop-color="#E0860C"/>
+    </linearGradient>
+  </defs>
+  <g stroke="#F7A823" stroke-width="5.5" stroke-linejoin="round" fill="none" stroke-opacity="0.85">
+    <path d="M 147.1 80 L 135.1 100.8 L 111.1 100.8 L 99.1 80 L 111.1 59.2 L 135.1 59.2 Z"/>
+    <path d="M 125.5 117.3 L 113.5 138.1 L 89.5 138.1 L 77.5 117.3 L 89.5 96.5 L 113.5 96.5 Z"/>
+    <path d="M 82.5 117.3 L 70.5 138.1 L 46.5 138.1 L 34.5 117.3 L 46.5 96.5 L 70.5 96.5 Z"/>
+    <path d="M 60.9 80 L 48.9 100.8 L 24.9 100.8 L 12.9 80 L 24.9 59.2 L 48.9 59.2 Z"/>
+    <path d="M 82.5 42.7 L 70.5 63.5 L 46.5 63.5 L 34.5 42.7 L 46.5 21.9 L 70.5 21.9 Z"/>
+    <path d="M 125.5 42.7 L 113.5 63.5 L 89.5 63.5 L 77.5 42.7 L 89.5 21.9 L 113.5 21.9 Z"/>
+  </g>
+  <path d="M 104 80 L 92 100.8 L 68 100.8 L 56 80 L 68 59.2 L 92 59.2 Z" fill="url(#bCell)" stroke="#FFD27A" stroke-width="1.5" stroke-linejoin="round"/>
+</svg>

package/assets/readme.md

@@ -0,0 +1,117 @@
+# Honeycomb — Design System
+
+The brand, tokens, components, and UI kit for **Honeycomb** — shared, self-improving memory for AI coding agents. A **Legion Code × Activeloop** collaboration: Honeycomb is the agent-memory product; [Activeloop Deep Lake](https://activeloop.ai) is the vector + columnar substrate its memory lives in.
+
+> One agent solves a problem on Monday; every agent on the team recalls and reuses it after — context inspectable, scoped, and repairable, not trapped behind a black-box API.
+
+This design system inherits the structural foundations of the parent **Legion Code** brand (dark-native, Inter + JetBrains Mono, 4px spacing, "mono is the texture of trust") and gives Honeycomb its own identity: a **warm honey-amber** hue and the **comb-cell** motif, with a reserved **violet "Pollinate"** accent for the Pollinating consolidation loop.
+
+---
+
+## Sources
+
+Everything here was derived from material the team provided. You may not have access; links are recorded so you can go deeper if you do.
+
+- **GitHub — [`legioncodeinc/honeycomb`](https://github.com/legioncodeinc/honeycomb)** — the product. Daemon + thin clients (six harnesses), the memory pipeline, and the dashboard. Key reads: `README.md`, `library/knowledge/private/overview.md`, `library/knowledge/private/ai/pollinating-loop.md`, and the dashboard contract under `src/dashboard/` (`contracts.ts`, `views.ts`, `html.ts`) — the UI kit recreates that dashboard. Explore the repo to build higher-fidelity Honeycomb surfaces.
+- **GitHub — [`legioncodeinc/brands`](https://github.com/legioncodeinc) → `legion-code-inc/`** — the parent Legion Code brand: token stylesheet (`colors_and_type.css`), the Inter + JetBrains Mono font families (imported here), and the brand guide. Honeycomb's structure is inherited from it.
+- **Activeloop Deep Lake — [activeloop.ai](https://activeloop.ai)** — the storage partner; logo in `logos/`.
+
+> ⚠️ **Honeycomb has no logo of its own yet.** The comb-cell mark in `logos/honeycomb-mark.svg` is a clean geometric placeholder built for this system. Replace it with the official mark when one exists.
+
+---
+
+## What it is — product context
+
+Honeycomb is a long-lived local **daemon** (binds `127.0.0.1:3850`, loopback only) plus thin clients. The daemon is the *sole* Deep Lake client; every harness, the CLI, the MCP server, and the SDK reach it over loopback HTTP.
+
+- **Capture** every turn from any of six harnesses (Claude Code, Cursor, Codex, Hermes, pi, OpenClaw).
+- **Distill** raw events into source-backed facts, entities, and skills with provenance.
+- **Recall** the right context before the next turn — hybrid lexical (BM25) + 768-dim semantic.
+- **Compound** — the **Pollinating loop** periodically merges duplicates, prunes junk, and supersedes stale claims, so memory gets sharper instead of noisier. The **skillify** miner turns recurring traces into reusable team skills.
+
+The most user-visible surface is the **dashboard** (recreated in `ui_kits/dashboard/`): KPIs, sessions, settings, the codebase graph, org rules, skill-sync, and a live log.
+
+---
+
+## Content fundamentals
+
+How Honeycomb writes. Inherited from Legion Code's voice — *the direct expert next door* — sharpened for a memory product.
+
+- **Voice:** calm, plain, technically literate. Never hedging, never hype. Short declaratives. "Memory that sticks." "Learn something once, recall it everywhere."
+- **Person:** address the user as **you** ("your agents", "what one agent learns"); the product is **Honeycomb** or **the daemon**, never "we" inside the product UI. Marketing prose may use "we" sparingly.
+- **Casing:** sentence case everywhere — headings, buttons, labels. The wordmark **honeycomb** is lowercase. Mono labels/eyebrows are the only UPPERCASE, and only for small section labels.
+- **Claims carry evidence.** Every recalled memory shows its **source** (a file path or session id) and a **score**. "Receipts, or it doesn't count." The `verified` (green) state means source-backed.
+- **Mono for anything you could click, copy, or search:** memory keys, session ids, hashes, file paths, recall queries, token counts, timestamps. When the user sees mono, they trust it's real.
+- **Signature vocabulary:** *memory, recall, capture, distill, the comb, cells, Pollinating, consolidate, skillify, harness, daemon, provenance, source-backed, scope (personal/team/org).*
+- **No emoji.** Status is carried by color + a small dot/glyph, never an emoji. The only "icon" glyphs are the comb hexagon, the `✓` verified check, and rule dots `● / ○`.
+- **Numbers are concrete and mono:** `1,284 memories`, `0.94`, `128k tok`, `:3850`. No vague "lots" — show the count.
+
+**Examples (from the product):**
+- `recall "how do we deploy"` → `4 hits · 0.94 top`
+- "Not logged in to Honeycomb. Run: `honeycomb login`"
+- "No graph built for this workspace. Run `honeycomb graph build`."
+- "While you sleep, the AI goes back through everything it learned, tosses the junk, ties the pieces together, and wakes up smarter."
+
+---
+
+## Visual foundations
+
+**Palette.** Dark-native, warm-tinted. Canvas is a warm near-black (`#0C0A07`) — five surfaces, four text levels, three border weights. One brand hue — **honey amber `#F7A823`** — governed by a **scarcity rule**: one saturated honey region per visible view (the primary action, the active recall, the live comb). A reserved second accent — **pollinate violet `#8B7CF0`** — appears only for the Pollinating loop and night/maintenance states. **Verified-green `#3DDC97`** (inherited from Legion) marks source-backed/proven memory. Severity colors (critical/warning/info/success) are semantic only, never decorative. A light theme exists for docs and exported reports.
+
+**Typography.** **Inter** for all UI and prose; **JetBrains Mono** for every coordinate of trust. Modular 1.25 scale on a 16px base. Headings are Inter 700 with tight tracking (`-0.02 to -0.04em`). Eyebrows are uppercase mono with `0.08em` tracking. Display is reserved for marketing hero.
+
+**Spacing & layout.** 4px base unit; every value a multiple of 4. Generous whitespace. Dashboard content is a centered max-width column (~1180px); panels sit in a responsive 2-column grid that collapses to one. Layout is calm and gridded — no diagonal or overlapping chrome.
+
+**Backgrounds.** Flat warm-dark surfaces. **No gradient washes**, no photographic hero imagery, no noise/grain. The one recurring texture is the **comb** — interlocking hexagonal cells (see `guidelines/cards/brand-comb.html`), each cell a memory; lit cells are recalled/verified/pollinating. Use it as a quiet motif (corner fields, empty-state art, loaders), never a loud full-bleed pattern.
+
+**Corners & cards.** Five-step radius ladder: 4 (chips), 8 (buttons/inputs), 12 (cards), 16 (panels/hero), full (dots/avatars). **Cards use a 1px border on `bg.elevated`, 12px radius, and no drop shadow** — border, not elevation, defines a card. The single expressive light is the **honey/pollinate glow** (`--glow-honey`, `--glow-pollinate`), used on exactly one focused element (an active recall hit, a pollinating cell).
+
+**Borders & dividers.** Three weights (`subtle / default / strong`). Panel headers separate from body with a `border-subtle` rule. Hairline (1px) everywhere — no heavy rules.
+
+**Elevation & shadow.** Three subtle ambient shadows (`sm/md/lg`) for genuinely floating UI (menus, toasts). Cards and panels do not use them. No colored decorative shadows except the two glows.
+
+**Motion.** Disciplined and brief. Default easing `cubic-bezier(0.2, 0.8, 0.2, 1)`; durations 120ms (fast), 200ms (base), 400ms (slow). Recall results fade-and-rise in with a ~55ms stagger. The **one exception** is the **Pollinating pulse** (`--dur-pollinate` 900ms, ease-in-out, alternating opacity) — slow and breathing, used only for consolidation states. `prefers-reduced-motion` disables all motion.
+
+**Hover / press.** Hover lightens fills one step (honey → honey-hover) or brightens a card border to `strong`. Press nudges `translateY(1px)` — no scale bounce. Focus shows a 2px honey outline at 2px offset, or a 3px honey-subtle ring on inputs.
+
+**Transparency & blur.** Used sparingly: the `*-subtle` token tints (12–14% honey/pollinate/severity) for soft fills behind badges and banners. No glassmorphism / backdrop-blur chrome.
+
+**Imagery vibe.** Warm, dark, restrained. If photography is ever introduced, it should be warm-toned and low-key to sit on the canvas — but the brand leans on the comb motif and mono typography over imagery.
+
+---
+
+## Iconography
+
+Honeycomb inherits Legion Code's icon discipline.
+
+- **System:** **[Lucide](https://lucide.dev)** — 24×24 grid, **1.5px stroke, stroked (not filled), geometric**, no mascots or metaphors. Load from CDN: `https://unpkg.com/lucide-static/icons/<name>.svg` (or the `lucide-react` package in a build). Match `currentColor` so icons inherit text color.
+- **The verified check** (`✓`) gets a slight weight bump (~2px) — the one icon that signals trust may be a touch heavier. Rendered in `--verified` green.
+- **The brand glyph** is the **comb hexagon** (`logos/honeycomb-mark.svg`) — the only bespoke mark. Use single hex cells as bullets/status chips (see `MemoryCard`), and the interlocking comb as motif/empty-state art.
+- **Status is color + dot, not emoji.** Session/agent/rule states use a small filled circle in the semantic color. Rules use `●` (active) / `○` (inactive). **No emoji anywhere.**
+- **No bespoke SVG illustration.** Beyond the hex mark and the comb grid (both pure geometry), don't hand-draw icons — pull the closest Lucide glyph.
+
+> No Honeycomb icon set ships in the repo; Lucide is the documented substitute and matches the parent brand's stated icon rules. Flagged as a substitution.
+
+---
+
+## Index — what's in this system
+
+**Foundations** (`styles.css` → `tokens/`)
+- `tokens/colors.css` — surfaces, text, borders, honey, honey scale, pollinate, severity, verified (+ light theme)
+- `tokens/typography.css` — families, 1.25 scale, weights, tracking
+- `tokens/spacing.css` — 4px spacing, radii, elevation + glows, motion
+- `tokens/fonts.css` — Inter + JetBrains Mono `@font-face` (binaries in `logos/fonts/`)
+- `tokens/base.css` — element + semantic base styles
+
+**Components** (`components/`) — React primitives, `window.HoneycombDesignSystem_d60529`
+- `core/` — `Button`, `Badge`, `Card`, `Input`
+- `honeycomb/` — `MemoryCard` (the signature recalled-memory cell), `Kpi` (dashboard metric tile)
+
+**UI kit** (`ui_kits/`)
+- `dashboard/` — interactive recreation of the daemon-served dashboard (KPIs, sessions, rules, codebase graph, skill-sync, live log, recall, Pollinating, connectivity-down banner)
+
+**Specimen cards** (`guidelines/cards/`) — the Design System tab: Colors (5), Type (4), Spacing (3), Brand (2), Components (2).
+
+**Logos** (`logos/`) — `honeycomb-mark.svg`, `honeycomb-wordmark.svg`, `activeloop.png`, `legion-code.png`, `fonts/`.
+
+**Skill** — `SKILL.md` makes this directory usable as an Agent Skill in Claude Code.

package/assets/styles.css

@@ -0,0 +1,11 @@
+/* ============================================================
+   Honeycomb — Design System entry stylesheet
+   The single file consumers link. Import order matters:
+   fonts → tokens → base. Keep this file as @import lines only.
+   ============================================================ */
+
+@import url('tokens/fonts.css');
+@import url('tokens/colors.css');
+@import url('tokens/typography.css');
+@import url('tokens/spacing.css');
+@import url('tokens/base.css');

package/assets/tokens/base.css

@@ -0,0 +1,76 @@
+/* ============================================================
+   Honeycomb — Base + semantic element styles
+   Foundation layer applied to the document. Tag elements with the
+   classes below or use as a base for product CSS.
+   ============================================================ */
+
+* { box-sizing: border-box; }
+
+html, body {
+  background: var(--bg-canvas);
+  color: var(--text-primary);
+  font-family: var(--font-sans);
+  font-size: var(--text-base);
+  line-height: var(--lh-base);
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  font-feature-settings: 'cv11', 'ss01';
+}
+
+/* Headings — Inter 700, tight tracking */
+h1, .h1 { font-size: var(--text-5xl); line-height: var(--lh-5xl); font-weight: 700; letter-spacing: var(--tracking-tight); margin: 0; }
+h2, .h2 { font-size: var(--text-4xl); line-height: var(--lh-4xl); font-weight: 700; letter-spacing: -0.02em; margin: 0; }
+h3, .h3 { font-size: var(--text-3xl); line-height: var(--lh-3xl); font-weight: 700; letter-spacing: -0.02em; margin: 0; }
+h4, .h4 { font-size: var(--text-2xl); line-height: var(--lh-2xl); font-weight: 600; letter-spacing: -0.01em; margin: 0; }
+h5, .h5 { font-size: var(--text-xl);  line-height: var(--lh-xl);  font-weight: 600; margin: 0; }
+h6, .h6 { font-size: var(--text-lg);  line-height: var(--lh-lg);  font-weight: 600; margin: 0; }
+
+p, .body { font-size: var(--text-base); line-height: var(--lh-base); color: var(--text-secondary); }
+.body-lg { font-size: var(--text-lg); line-height: var(--lh-lg); color: var(--text-secondary); }
+.body-sm { font-size: var(--text-sm); line-height: var(--lh-sm); color: var(--text-secondary); }
+.caption { font-size: var(--text-xs); line-height: var(--lh-xs); color: var(--text-tertiary); }
+
+/* Display — marketing hero only */
+.display { font-size: var(--text-7xl); line-height: var(--lh-7xl); font-weight: 700; letter-spacing: -0.04em; }
+
+/* Mono — the texture of trust. Memory keys, session ids, hashes,
+   file paths, recall queries, token counts, timestamps. */
+code, kbd, samp, pre, .mono {
+  font-family: var(--font-mono);
+  font-feature-settings: 'liga' 0;
+}
+.mono-sm { font-family: var(--font-mono); font-size: var(--text-sm); line-height: var(--lh-sm); }
+.mono-xs { font-family: var(--font-mono); font-size: var(--text-xs); line-height: var(--lh-xs); }
+
+/* Eyebrow — uppercase mono label above section titles */
+.eyebrow {
+  font-family: var(--font-mono);
+  font-size: var(--text-xs);
+  text-transform: uppercase;
+  letter-spacing: var(--tracking-wide);
+  color: var(--text-tertiary);
+}
+
+/* Wordmark — Inter 700, lowercase, tight tracking (the honeycomb mark) */
+.wordmark {
+  font-family: var(--font-sans);
+  font-weight: 700;
+  letter-spacing: -0.03em;
+}
+
+/* Focus ring — honey, on interactive elements */
+:focus-visible {
+  outline: 2px solid var(--honey);
+  outline-offset: 2px;
+  border-radius: var(--radius-sm);
+}
+
+/* Selection */
+::selection {
+  background: var(--honey-subtle);
+  color: var(--text-primary);
+}
+
+@media (prefers-reduced-motion: reduce) {
+  * { animation-duration: 0.001ms !important; animation-iteration-count: 1 !important; transition-duration: 0.001ms !important; }
+}

package/assets/tokens/colors.css

@@ -0,0 +1,111 @@
+/* ============================================================
+   Honeycomb — Color tokens
+   Dark-native, warm-tinted. Inherits the Legion Code structure
+   (5 surfaces, 4 text levels, 3 borders, semantic severity) but
+   shifts the canvas warm and makes HONEY AMBER the one brand hue.
+
+   Two accents only:
+     --honey  : the brand. Memory, recall, the live comb. Scarcity
+                rule applies — one saturated honey region per view.
+     --pollinate  : violet. Reserved for the Pollinating consolidation
+                loop and night/maintenance states. Never decorative.
+   Use these tokens; never raw hex outside this file.
+   ============================================================ */
+
+:root {
+  /* ---- Surfaces (dark — primary; warm near-black) --------------- */
+  --bg-canvas:    #0C0A07;
+  --bg-surface:   #15120B;
+  --bg-elevated:  #1E1A11;
+  --bg-subtle:    #29231799;
+  --bg-inset:     #070501;
+
+  /* ---- Text (warm off-white on dark) --------------------------- */
+  --text-primary:   #F7F3EC;
+  --text-secondary: #ADA28F;
+  --text-tertiary:  #877E6C;
+  --text-disabled:  #524B3C;
+  --text-inverse:   #0C0A07;
+
+  /* ---- Borders & dividers (on dark) ---------------------------- */
+  --border-subtle:  #221E15;
+  --border-default: #322B1E;
+  --border-strong:  #483F2C;
+
+  /* ---- Brand: HONEY AMBER (scarcity rule applies) -------------- */
+  --honey:          #F7A823;
+  --honey-hover:    #FFBA47;
+  --honey-pressed:  #D98C0C;
+  --honey-subtle:   rgba(247, 168, 35, 0.12);
+  --honey-border:   rgba(247, 168, 35, 0.32);
+  --honey-on:       #1A1206;   /* ink that sits on a honey fill   */
+
+  /* ---- Honey scale (comb cells, heat, data viz) ---------------- */
+  --honey-50:  #FFE9C2;
+  --honey-100: #FFD894;
+  --honey-200: #FFC661;
+  --honey-300: #F7A823;
+  --honey-400: #D98C0C;
+  --honey-500: #A86A07;
+  --honey-600: #6E4604;
+
+  /* ---- Pollinate: VIOLET (the Pollinating loop + night states) -------- */
+  --pollinate:          #8B7CF0;
+  --pollinate-hover:    #A89CF5;
+  --pollinate-pressed:  #6E5DDB;
+  --pollinate-subtle:   rgba(139, 124, 240, 0.14);
+  --pollinate-border:   rgba(139, 124, 240, 0.34);
+  --pollinate-on:       #0B0814;
+
+  /* ---- Severity (semantic; never decorative) ------------------- */
+  --severity-critical:    #FF5C63;
+  --severity-critical-bg: rgba(255, 92, 99, 0.12);
+  --severity-warning:     #FFC24B;
+  --severity-warning-bg:  rgba(255, 194, 75, 0.12);
+  --severity-info:        #5FA8FF;
+  --severity-info-bg:     rgba(95, 168, 255, 0.12);
+  --severity-success:     #3DDC97;   /* verified-green: proven / receipts */
+  --severity-success-bg:  rgba(61, 220, 151, 0.12);
+
+  /* ---- Status accents reused across product -------------------- */
+  --verified:       #3DDC97;   /* a proven, source-backed memory  */
+  --verified-subtle: rgba(61, 220, 151, 0.12);
+}
+
+/* ---- Light theme — docs, printed/exported reports only --------- */
+:root[data-theme="light"],
+.theme-light {
+  --bg-canvas:    #FBF7EF;
+  --bg-surface:   #F5EFE2;
+  --bg-elevated:  #FFFFFF;
+  --bg-subtle:    #EFE7D5;
+  --bg-inset:     #F0E8D8;
+
+  --text-primary:   #1A1206;
+  --text-secondary: #5C513C;
+  --text-tertiary:  #877E6C;
+  --text-disabled:  #B5AC97;
+  --text-inverse:   #FBF7EF;
+
+  --border-subtle:  #EAE0CD;
+  --border-default: #DACFB6;
+  --border-strong:  #C2B594;
+
+  --honey:          #B7790A;
+  --honey-hover:    #9A6606;
+  --honey-pressed:  #7E5304;
+  --honey-subtle:   rgba(183, 121, 10, 0.10);
+  --honey-border:   rgba(183, 121, 10, 0.30);
+  --honey-on:       #FFFFFF;
+
+  --pollinate:          #6E5DDB;
+  --pollinate-hover:    #5B49C6;
+  --pollinate-subtle:   rgba(110, 93, 219, 0.10);
+  --pollinate-border:   rgba(110, 93, 219, 0.28);
+
+  --severity-critical:    #D93741;
+  --severity-warning:     #B5790A;
+  --severity-info:        #2E6FD9;
+  --severity-success:     #18A968;
+  --verified:             #18A968;
+}