synapt 0.3.0__tar.gz

synapt-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Layne Penney
+
+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.

synapt-0.3.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: synapt
+Version: 0.3.0
+Summary: Persistent conversational memory for AI coding assistants
+Author: Layne Penney
+License-Expression: MIT
+Project-URL: Homepage, https://synapt.dev
+Project-URL: Repository, https://github.com/laynepenney/synapt
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: mcp
+Requires-Dist: mcp[cli]>=1.0; extra == "mcp"
+Provides-Extra: embeddings
+Requires-Dist: sentence-transformers>=2.0; extra == "embeddings"
+Provides-Extra: hf
+Requires-Dist: huggingface_hub>=0.20; extra == "hf"
+Provides-Extra: transformers
+Requires-Dist: transformers>=4.30; extra == "transformers"
+Requires-Dist: torch>=2.0; extra == "transformers"
+Provides-Extra: all
+Requires-Dist: mcp[cli]>=1.0; extra == "all"
+Requires-Dist: sentence-transformers>=2.0; extra == "all"
+Requires-Dist: huggingface_hub>=0.20; extra == "all"
+Requires-Dist: transformers>=4.30; extra == "all"
+Requires-Dist: torch>=2.0; extra == "all"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Requires-Dist: numpy; extra == "test"
+Requires-Dist: pytest-benchmark>=4.0; extra == "test"
+Dynamic: license-file
+
+# synapt
+
+Persistent conversational memory for AI coding assistants. Synapt indexes your past coding sessions and makes them searchable — so your AI assistant remembers what you worked on, decisions you made, and patterns you established.
+
+Works as an [MCP server](https://modelcontextprotocol.io/) for Claude Code and other MCP-compatible tools.
+
+## Install
+
+```bash
+pip install synapt
+
+# With MCP server support (recommended)
+pip install 'synapt[mcp]'
+```
+
+## Quick start
+
+### 1. Build the index
+
+Synapt discovers Claude Code transcripts automatically:
+
+```bash
+synapt recall build
+```
+
+### 2. Search past sessions
+
+```bash
+synapt recall search "how did we fix the auth bug"
+```
+
+### 3. Use as an MCP server
+
+Add to your Claude Code config (`.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "synapt": {
+      "type": "stdio",
+      "command": "synapt",
+      "args": ["server"]
+    }
+  }
+}
+```
+
+This gives your AI assistant 13 tools for searching past sessions, managing a journal, setting reminders, and building a durable knowledge base.
+
+## Features
+
+- **Transcript indexing** — BM25 full-text search over past coding sessions
+- **Topic clustering** — Jaccard token-overlap clustering groups related chunks
+- **Knowledge consolidation** — Extracts durable knowledge from session journals
+- **Session journal** — Rich entries with focus, decisions, done items, and next steps
+- **Reminders** — Cross-session sticky reminders that surface at session start
+- **Timeline** — Chronological work arcs showing project narrative
+- **LLM enrichment** — Optional LLM-powered summaries and cluster upgrades
+- **Working memory** — Frequency-boosted search results for active topics
+- **Plugin system** — Extend with additional tools via entry-point discovery
+
+## MCP tools
+
+| Tool | Description |
+|------|-------------|
+| `recall_search` | Search past sessions by query |
+| `recall_context` | Get context for the current session |
+| `recall_files` | Find sessions that touched specific files |
+| `recall_sessions` | List indexed sessions |
+| `recall_timeline` | View chronological work arcs |
+| `recall_build` | Build or rebuild the transcript index |
+| `recall_setup` | Auto-configure hooks and MCP integration |
+| `recall_stats` | Index statistics |
+| `recall_journal` | Write rich session journal entries |
+| `recall_remind` | Set cross-session reminders |
+| `recall_enrich` | LLM-powered chunk summarization |
+| `recall_consolidate` | Extract knowledge from journals |
+| `recall_contradict` | Flag contradictions in knowledge |
+
+## CLI reference
+
+```bash
+synapt recall build              # Build index (discovers transcripts automatically)
+synapt recall build --incremental # Skip already-indexed files
+synapt recall search "query"     # Search past sessions
+synapt recall stats              # Show index statistics
+synapt recall journal --write    # Write a session journal entry
+synapt recall setup              # Auto-configure hooks
+synapt server                    # Start MCP server
+```
+
+## Optional backends
+
+Synapt uses local LLMs for enrichment and summarization. Install optional backends:
+
+```bash
+# MLX (Apple Silicon)
+pip install mlx-lm
+
+# Ollama
+# Install from https://ollama.com, then:
+ollama pull qwen2.5:3b
+
+# Transformers (GPU/CPU)
+pip install 'synapt[transformers]'
+```
+
+## Plugins
+
+Synapt discovers plugins via Python entry points. To create a plugin:
+
+1. Create a module with a `register_tools(mcp)` function
+2. Register it in your `pyproject.toml`:
+
+```toml
+[project.entry-points."synapt.plugins"]
+my_plugin = "my_package.server"
+```
+
+The MCP server automatically discovers and loads plugins at startup.
+
+## Development
+
+```bash
+git clone https://github.com/laynepenney/synapt.git
+cd synapt
+pip install -e ".[test]"
+pytest tests/ -v
+```
+
+## License
+
+MIT

synapt-0.3.0/README.md

@@ -0,0 +1,133 @@
+# synapt
+
+Persistent conversational memory for AI coding assistants. Synapt indexes your past coding sessions and makes them searchable — so your AI assistant remembers what you worked on, decisions you made, and patterns you established.
+
+Works as an [MCP server](https://modelcontextprotocol.io/) for Claude Code and other MCP-compatible tools.
+
+## Install
+
+```bash
+pip install synapt
+
+# With MCP server support (recommended)
+pip install 'synapt[mcp]'
+```
+
+## Quick start
+
+### 1. Build the index
+
+Synapt discovers Claude Code transcripts automatically:
+
+```bash
+synapt recall build
+```
+
+### 2. Search past sessions
+
+```bash
+synapt recall search "how did we fix the auth bug"
+```
+
+### 3. Use as an MCP server
+
+Add to your Claude Code config (`.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "synapt": {
+      "type": "stdio",
+      "command": "synapt",
+      "args": ["server"]
+    }
+  }
+}
+```
+
+This gives your AI assistant 13 tools for searching past sessions, managing a journal, setting reminders, and building a durable knowledge base.
+
+## Features
+
+- **Transcript indexing** — BM25 full-text search over past coding sessions
+- **Topic clustering** — Jaccard token-overlap clustering groups related chunks
+- **Knowledge consolidation** — Extracts durable knowledge from session journals
+- **Session journal** — Rich entries with focus, decisions, done items, and next steps
+- **Reminders** — Cross-session sticky reminders that surface at session start
+- **Timeline** — Chronological work arcs showing project narrative
+- **LLM enrichment** — Optional LLM-powered summaries and cluster upgrades
+- **Working memory** — Frequency-boosted search results for active topics
+- **Plugin system** — Extend with additional tools via entry-point discovery
+
+## MCP tools
+
+| Tool | Description |
+|------|-------------|
+| `recall_search` | Search past sessions by query |
+| `recall_context` | Get context for the current session |
+| `recall_files` | Find sessions that touched specific files |
+| `recall_sessions` | List indexed sessions |
+| `recall_timeline` | View chronological work arcs |
+| `recall_build` | Build or rebuild the transcript index |
+| `recall_setup` | Auto-configure hooks and MCP integration |
+| `recall_stats` | Index statistics |
+| `recall_journal` | Write rich session journal entries |
+| `recall_remind` | Set cross-session reminders |
+| `recall_enrich` | LLM-powered chunk summarization |
+| `recall_consolidate` | Extract knowledge from journals |
+| `recall_contradict` | Flag contradictions in knowledge |
+
+## CLI reference
+
+```bash
+synapt recall build              # Build index (discovers transcripts automatically)
+synapt recall build --incremental # Skip already-indexed files
+synapt recall search "query"     # Search past sessions
+synapt recall stats              # Show index statistics
+synapt recall journal --write    # Write a session journal entry
+synapt recall setup              # Auto-configure hooks
+synapt server                    # Start MCP server
+```
+
+## Optional backends
+
+Synapt uses local LLMs for enrichment and summarization. Install optional backends:
+
+```bash
+# MLX (Apple Silicon)
+pip install mlx-lm
+
+# Ollama
+# Install from https://ollama.com, then:
+ollama pull qwen2.5:3b
+
+# Transformers (GPU/CPU)
+pip install 'synapt[transformers]'
+```
+
+## Plugins
+
+Synapt discovers plugins via Python entry points. To create a plugin:
+
+1. Create a module with a `register_tools(mcp)` function
+2. Register it in your `pyproject.toml`:
+
+```toml
+[project.entry-points."synapt.plugins"]
+my_plugin = "my_package.server"
+```
+
+The MCP server automatically discovers and loads plugins at startup.
+
+## Development
+
+```bash
+git clone https://github.com/laynepenney/synapt.git
+cd synapt
+pip install -e ".[test]"
+pytest tests/ -v
+```
+
+## License
+
+MIT

synapt-0.3.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "synapt"
+version = "0.3.0"
+description = "Persistent conversational memory for AI coding assistants"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+dependencies = []
+authors = [
+    {name = "Layne Penney"},
+]
+
+[project.urls]
+Homepage = "https://synapt.dev"
+Repository = "https://github.com/laynepenney/synapt"
+
+[project.optional-dependencies]
+mcp = ["mcp[cli]>=1.0"]
+embeddings = ["sentence-transformers>=2.0"]
+hf = ["huggingface_hub>=0.20"]
+transformers = ["transformers>=4.30", "torch>=2.0"]
+all = ["mcp[cli]>=1.0", "sentence-transformers>=2.0", "huggingface_hub>=0.20", "transformers>=4.30", "torch>=2.0"]
+test = ["pytest>=7.0", "numpy", "pytest-benchmark>=4.0"]
+
+[project.scripts]
+synapt = "synapt.cli:main"
+synapt-recall = "synapt.recall.cli:main"
+synapt-recall-server = "synapt.recall.server:main"
+
+[project.entry-points."synapt.plugins"]
+# Plugins register here via their own pyproject.toml. Example:
+# repair = "synapt_repair.server"
+
+[tool.pytest.ini_options]
+addopts = "--benchmark-disable"
+
+[tool.setuptools.packages.find]
+where = ["src"]

synapt-0.3.0/setup.cfg

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

synapt-0.3.0/src/synapt/__init__.py

@@ -0,0 +1,3 @@
+"""Synapt: persistent conversational memory for AI coding assistants."""
+
+__version__ = "0.3.0"

synapt-0.3.0/src/synapt/_models/__init__.py

@@ -0,0 +1,5 @@
+"""synapt._models — shared model client abstractions (MLX, Ollama)."""
+
+from synapt._models.base import Message, ModelClient  # noqa: F401
+
+__all__ = ["Message", "ModelClient"]