eling 0.1.0__tar.gz

eling-0.1.0/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2026 PatrickNoFilter
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+This project incorporates code from the holographic memory plugin by dusterbloom
+(Hermes Agent PR #2351, MIT). The HRR phase-encoding implementation in
+src/eling/layers/hrr.py is adapted from that plugin.

eling-0.1.0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: eling
+Version: 0.1.0
+Summary: Unified second brain for AI agents — 5-tier memory, HRR reasoning, 9 MCP tools
+Author: PatrickNoFilter
+License: MIT
+Keywords: memory,mcp,ai-agent,second-brain,hrr
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: hrr
+Requires-Dist: numpy>=1.24; extra == "hrr"
+Provides-Extra: dev
+Requires-Dist: eling[hrr]; extra == "dev"
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+# 🧠 Eling
+
+**Unified second brain for AI agents — Hermes-first**
+
+*"Eling" (Javanese): to remember, to be conscious, to be aware*
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://python.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-Ready-6366f1)](https://modelcontextprotocol.io)
+[![Hermes](https://img.shields.io/badge/Hermes-First-orange)](https://github.com/NousResearch/hermes-agent)
+
+</div>
+
+---
+
+## ✨ What is Eling?
+
+Eling is a **unified second brain** for AI agents. It merges 5 memory tiers into one MCP server:
+
+```
+🧠 Layer 5: NOTION (online brain, human-readable)
+📚 Layer 4: KB (FTS5 knowledge corpus)
+🕸️ Layer 3: CODE (codegraph symbol intelligence)
+💎 Layer 2: FACTS (HRR + BM25 hybrid)
+📌 Layer 1: BUILTIN (Hermes MEMORY.md/USER.md)
+```
+
+All accessible via **5 unified tools**:
+- `eling_remember` — smart routing across layers
+- `eling_recall` — cross-layer search with RRF fusion
+- `eling_reason` — compositional query (multi-entity)
+- `eling_reflect` — promote local fact → Notion
+- `eling_sync` — bidirectional Notion ↔ local
+
+## 🚀 Quick Start
+
+```bash
+pip install eling-memory
+
+# As Hermes plugin
+eling install-hermes-plugin
+
+# As standalone MCP server
+eling-mcp
+```
+
+## 🎯 Why Eling?
+
+| Feature | Eling | mem0 | agentmemory | Mnemosyne |
+|---------|-------|------|-------------|-----------|
+| **Notion as online brain** | ✅ native | ❌ | ❌ | ❌ |
+| **codegraph integration** | ✅ embedded | ❌ | ❌ | ❌ |
+| **FTS5 knowledge base** | ✅ embedded | ❌ | ❌ | partial |
+| **Hermes-first design** | ✅ | indirect | indirect | ✅ |
+| **Single MCP process** | ✅ | ❌ | ❌ | ✅ |
+| **HRR compositional reasoning** | ✅ | ❌ | ❌ | ✅ |
+| **Indonesian-friendly** | ✅ | ❌ | ❌ | ❌ |
+
+## 📖 Documentation
+
+- [Architecture](docs/architecture.md)
+- [API Reference](docs/api.md)
+- [Migration from holographic](docs/migration.md)
+- [Notion setup](docs/notion-setup.md)
+
+## 🤝 Credits
+
+- HRR phase encoding adapted from holographic plugin by [dusterbloom](https://github.com/dusterbloom) (Hermes PR #2351, MIT)
+- FTS5 retrieval techniques inspired by Nous Research's [context-mode](https://github.com/NousResearch/context-mode)
+- Architecture lessons from [rohitg00/agentmemory](https://github.com/rohitg00/agentmemory) and [AxDSan/mnemosyne](https://github.com/AxDSan/mnemosyne)
+
+## 📜 License
+
+MIT © 2026 PatrickNoFilter

eling-0.1.0/README.md

@@ -0,0 +1,76 @@
+<div align="center">
+
+# 🧠 Eling
+
+**Unified second brain for AI agents — Hermes-first**
+
+*"Eling" (Javanese): to remember, to be conscious, to be aware*
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://python.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-Ready-6366f1)](https://modelcontextprotocol.io)
+[![Hermes](https://img.shields.io/badge/Hermes-First-orange)](https://github.com/NousResearch/hermes-agent)
+
+</div>
+
+---
+
+## ✨ What is Eling?
+
+Eling is a **unified second brain** for AI agents. It merges 5 memory tiers into one MCP server:
+
+```
+🧠 Layer 5: NOTION (online brain, human-readable)
+📚 Layer 4: KB (FTS5 knowledge corpus)
+🕸️ Layer 3: CODE (codegraph symbol intelligence)
+💎 Layer 2: FACTS (HRR + BM25 hybrid)
+📌 Layer 1: BUILTIN (Hermes MEMORY.md/USER.md)
+```
+
+All accessible via **5 unified tools**:
+- `eling_remember` — smart routing across layers
+- `eling_recall` — cross-layer search with RRF fusion
+- `eling_reason` — compositional query (multi-entity)
+- `eling_reflect` — promote local fact → Notion
+- `eling_sync` — bidirectional Notion ↔ local
+
+## 🚀 Quick Start
+
+```bash
+pip install eling-memory
+
+# As Hermes plugin
+eling install-hermes-plugin
+
+# As standalone MCP server
+eling-mcp
+```
+
+## 🎯 Why Eling?
+
+| Feature | Eling | mem0 | agentmemory | Mnemosyne |
+|---------|-------|------|-------------|-----------|
+| **Notion as online brain** | ✅ native | ❌ | ❌ | ❌ |
+| **codegraph integration** | ✅ embedded | ❌ | ❌ | ❌ |
+| **FTS5 knowledge base** | ✅ embedded | ❌ | ❌ | partial |
+| **Hermes-first design** | ✅ | indirect | indirect | ✅ |
+| **Single MCP process** | ✅ | ❌ | ❌ | ✅ |
+| **HRR compositional reasoning** | ✅ | ❌ | ❌ | ✅ |
+| **Indonesian-friendly** | ✅ | ❌ | ❌ | ❌ |
+
+## 📖 Documentation
+
+- [Architecture](docs/architecture.md)
+- [API Reference](docs/api.md)
+- [Migration from holographic](docs/migration.md)
+- [Notion setup](docs/notion-setup.md)
+
+## 🤝 Credits
+
+- HRR phase encoding adapted from holographic plugin by [dusterbloom](https://github.com/dusterbloom) (Hermes PR #2351, MIT)
+- FTS5 retrieval techniques inspired by Nous Research's [context-mode](https://github.com/NousResearch/context-mode)
+- Architecture lessons from [rohitg00/agentmemory](https://github.com/rohitg00/agentmemory) and [AxDSan/mnemosyne](https://github.com/AxDSan/mnemosyne)
+
+## 📜 License
+
+MIT © 2026 PatrickNoFilter

eling-0.1.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "eling"
+version = "0.1.0"
+description = "Unified second brain for AI agents — 5-tier memory, HRR reasoning, 9 MCP tools"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+keywords = ["memory", "mcp", "ai-agent", "second-brain", "hrr"]
+
+authors = [
+    {name = "PatrickNoFilter"},
+]
+
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+dependencies = [
+    # numpy is optional — needed only for HRR.
+    # Install via: pip install eling[hrr] or pip install eling[dev]
+]
+
+[project.optional-dependencies]
+hrr = ["numpy>=1.24"]
+dev = [
+    "eling[hrr]",
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short"

eling-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

eling-0.1.0/src/eling/__init__.py

@@ -0,0 +1,37 @@
+"""Eling — unified second brain for AI agents.
+
+5-layer architecture: builtin / facts / kb / code / notion
+"""
+
+__version__ = "0.1.0"
+__all__ = ["Brain", "HookRegistry", "ALL_HOOKS", "register_default_hooks",
+           "remember", "recall", "reason", "resolve_config", "set_config_key",
+           "get_config", "describe_config"]
+
+from .brain import Brain
+from .hooks import HookRegistry, ALL_HOOKS, register_default_hooks
+from .config import resolve_config, set_config_key, get_config, describe_config
+
+_default_brain: Brain | None = None
+
+
+def _get_default() -> Brain:
+    global _default_brain
+    if _default_brain is None:
+        _default_brain = Brain()
+    return _default_brain
+
+
+def remember(content: str, **kwargs) -> dict:
+    """Quick-access remember on default brain."""
+    return _get_default().remember(content, **kwargs)
+
+
+def recall(query: str, **kwargs) -> dict:
+    """Quick-access recall on default brain."""
+    return _get_default().recall(query, **kwargs)
+
+
+def reason(entities: list[str], **kwargs) -> list[dict]:
+    """Quick-access reason on default brain."""
+    return _get_default().reason(entities, **kwargs)

eling-0.1.0/src/eling/adapters/__init__.py

@@ -0,0 +1,202 @@
+"""Harness adapters — multi-agent context injection (Task 12.3).
+
+Each adapter knows how to read its platform's memory/project file(s)
+and report its context budget so eling can adapt what it serves.
+"""
+
+from __future__ import annotations
+
+import os
+import json
+from abc import ABC, abstractmethod
+from pathlib import Path
+from typing import Any
+
+
+__all__ = [
+    "HarnessAdapter",
+    "HermesAdapter",
+    "ClaudeCliAdapter",
+    "OpenCodeAdapter",
+    "OpenClawAdapter",
+    "OpenClaudeAdapter",
+    "all_adapters",
+]
+
+
+# ── Context budgets (conservative estimates) ─────────────────────────
+
+_HERMES_BUDGET = 8_192     # MEMORY.md + USER.md, typically 2-4 KB each
+_CLAUDE_CLI_BUDGET = 32_000  # CLAUDE.md can be up to ~32 KB
+_OPENCODE_BUDGET = 32_000    # AGENTS.md + opencode.json
+_OPENCLAW_BUDGET = 24_000    # CLAUDE.md equivalent
+_OPENCLAUDE_BUDGET = 24_000
+
+
+# ── Base adapter ─────────────────────────────────────────────────────
+
+
+class HarnessAdapter(ABC):
+    """Base class for platform-specific harness adapters."""
+
+    name: str = ""
+
+    @abstractmethod
+    def read_context(self, project_root: str | Path = ".") -> str:
+        """Read the harness's memory/context file(s)."""
+        ...
+
+    @abstractmethod
+    def budget_bytes(self) -> int:
+        """Approximate context budget in bytes."""
+        ...
+
+    def default_schema_pack(self) -> str:
+        """Recommended schema pack name for this harness."""
+        return "default"
+
+    def context_file_path(self, name: str, project_root: str | Path = ".") -> Path:
+        """Resolve a context file name, searching cwd → parent dirs."""
+        root = Path(project_root).resolve()
+        for parent in [root] + list(root.parents):
+            candidate = parent / name
+            if candidate.is_file():
+                return candidate
+        return root / name
+
+
+# ── Concrete adapters ────────────────────────────────────────────────
+
+
+class HermesAdapter(HarnessAdapter):
+    """Reads from the Hermes profile's MEMORY.md and USER.md."""
+
+    name = "hermes"
+
+    def __init__(self, hermes_home: str | Path | None = None):
+        home = Path(hermes_home) if hermes_home else Path.home() / ".hermes"
+        self._mem = home / "MEMORY.md"
+        self._usr = home / "USER.md"
+
+    def read_context(self, project_root: str | Path = ".") -> str:
+        parts: list[str] = []
+        for path, label in [(self._mem, "MEMORY"), (self._usr, "USER PROFILE")]:
+            if path.is_file():
+                parts.append(f"--- {label} ---\n{path.read_text(encoding='utf-8', errors='replace')}")
+        return "\n\n".join(parts) if parts else ""
+
+    def budget_bytes(self) -> int:
+        return _HERMES_BUDGET
+
+
+class ClaudeCliAdapter(HarnessAdapter):
+    """Reads CLAUDE.md from the project root."""
+
+    name = "claude_cli"
+
+    def read_context(self, project_root: str | Path = ".") -> str:
+        path = self.context_file_path("CLAUDE.md", project_root)
+        if path.is_file():
+            return f"--- CLAUDE.md ---\n{path.read_text(encoding='utf-8', errors='replace')}"
+        return ""
+
+    def budget_bytes(self) -> int:
+        return _CLAUDE_CLI_BUDGET
+
+    def default_schema_pack(self) -> str:
+        return "coding"
+
+
+class OpenCodeAdapter(HarnessAdapter):
+    """Reads AGENTS.md + opencode.json from the project root."""
+
+    name = "opencode"
+
+    def read_context(self, project_root: str | Path = ".") -> str:
+        root = Path(project_root).resolve()
+        parts: list[str] = []
+
+        agents_path = self.context_file_path("AGENTS.md", project_root)
+        if agents_path.is_file():
+            parts.append(f"--- AGENTS.md ---\n{agents_path.read_text(encoding='utf-8', errors='replace')}")
+
+        oc_path = root / "opencode.json"
+        if oc_path.is_file():
+            try:
+                data = json.loads(oc_path.read_text(encoding='utf-8', errors='replace'))
+                parts.append(f"--- opencode.json ---\n{json.dumps(data, indent=2)}")
+            except (json.JSONDecodeError, OSError):
+                parts.append("--- opencode.json ---\n(invalid)")
+
+        return "\n\n".join(parts) if parts else ""
+
+    def budget_bytes(self) -> int:
+        return _OPENCODE_BUDGET
+
+    def default_schema_pack(self) -> str:
+        return "coding"
+
+
+class OpenClawAdapter(HarnessAdapter):
+    """Placeholder for OpenClaw (CLAUDE.md equivalent)."""
+
+    name = "openclaw"
+
+    def read_context(self, project_root: str | Path = ".") -> str:
+        path = self.context_file_path("CLAUDE.md", project_root)
+        if path.is_file():
+            return f"--- CLAUDE.md ---\n{path.read_text(encoding='utf-8', errors='replace')}"
+        return ""
+
+    def budget_bytes(self) -> int:
+        return _OPENCLAW_BUDGET
+
+    def default_schema_pack(self) -> str:
+        return "coding"
+
+
+class OpenClaudeAdapter(HarnessAdapter):
+    """Placeholder for OpenClaude (CLAUDE.md equivalent)."""
+
+    name = "openclaude"
+
+    def read_context(self, project_root: str | Path = ".") -> str:
+        path = self.context_file_path("CLAUDE.md", project_root)
+        if path.is_file():
+            return f"--- CLAUDE.md ---\n{path.read_text(encoding='utf-8', errors='replace')}"
+        return ""
+
+    def budget_bytes(self) -> int:
+        return _OPENCLAUDE_BUDGET
+
+    def default_schema_pack(self) -> str:
+        return "coding"
+
+
+# ── Discovery ────────────────────────────────────────────────────────
+
+
+def all_adapters() -> dict[str, HarnessAdapter]:
+    """Return all adapter instances keyed by name."""
+    return {
+        "hermes": HermesAdapter(),
+        "claude_cli": ClaudeCliAdapter(),
+        "opencode": OpenCodeAdapter(),
+        "openclaw": OpenClawAdapter(),
+        "openclaude": OpenClaudeAdapter(),
+    }
+
+
+def get_adapter(name: str, **kwargs: Any) -> HarnessAdapter:
+    """Get a single adapter by name, raising KeyError if unknown."""
+    builders = {
+        "hermes": HermesAdapter,
+        "claude_cli": ClaudeCliAdapter,
+        "opencode": OpenCodeAdapter,
+        "openclaw": OpenClawAdapter,
+        "openclaude": OpenClaudeAdapter,
+    }
+    cls = builders.get(name)
+    if cls is None:
+        raise KeyError(f"Unknown adapter: {name}. Valid: {', '.join(sorted(builders))}")
+    return cls(**kwargs)