opencode-semantic-memory 0.5.1__tar.gz → 0.6.1__tar.gz

opencode_semantic_memory-0.6.1/.cache/pip/http-v2/7/3/3/0/8/73308e5c1402c6bb3b38e3b0f1deabe3b20b6248ed18126597a2a901.body

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: zipp
+Version: 4.1.0
+Summary: Backport of pathlib-compatible object wrapper for zip files
+Author-email: "Jason R. Coombs" <jaraco@jaraco.com>
+License-Expression: MIT
+Project-URL: Source, https://github.com/jaraco/zipp
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Description-Content-Type: text/x-rst
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: pytest!=8.1.*,>=6; extra == "test"
+Requires-Dist: jaraco.itertools; extra == "test"
+Requires-Dist: jaraco.functools; extra == "test"
+Requires-Dist: more_itertools; extra == "test"
+Requires-Dist: big-O; extra == "test"
+Requires-Dist: pytest-ignore-flaky; extra == "test"
+Requires-Dist: jaraco.test; extra == "test"
+Provides-Extra: doc
+Requires-Dist: sphinx>=3.5; extra == "doc"
+Requires-Dist: jaraco.packaging>=9.3; extra == "doc"
+Requires-Dist: rst.linker>=1.9; extra == "doc"
+Requires-Dist: furo; extra == "doc"
+Requires-Dist: sphinx-lint; extra == "doc"
+Requires-Dist: jaraco.tidelift>=1.4; extra == "doc"
+Provides-Extra: check
+Requires-Dist: pytest-checkdocs>=2.14; extra == "check"
+Requires-Dist: pytest-ruff>=0.2.1; sys_platform != "cygwin" and extra == "check"
+Provides-Extra: cover
+Requires-Dist: pytest-cov; extra == "cover"
+Provides-Extra: enabler
+Requires-Dist: pytest-enabler>=3.4; extra == "enabler"
+Provides-Extra: type
+Requires-Dist: pytest-mypy>=1.0.1; platform_python_implementation != "PyPy" and extra == "type"
+Dynamic: license-file
+
+.. image:: https://img.shields.io/pypi/v/zipp.svg
+   :target: https://pypi.org/project/zipp
+
+.. image:: https://img.shields.io/pypi/pyversions/zipp.svg
+
+.. image:: https://github.com/jaraco/zipp/actions/workflows/main.yml/badge.svg
+   :target: https://github.com/jaraco/zipp/actions?query=workflow%3A%22tests%22
+   :alt: tests
+
+.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
+    :target: https://github.com/astral-sh/ruff
+    :alt: Ruff
+
+.. image:: https://readthedocs.org/projects/zipp/badge/?version=latest
+..    :target: https://zipp.readthedocs.io/en/latest/?badge=latest
+
+.. image:: https://img.shields.io/badge/skeleton-2026-informational
+   :target: https://blog.jaraco.com/skeleton
+
+.. image:: https://tidelift.com/badges/package/pypi/zipp
+   :target: https://tidelift.com/subscription/pkg/pypi-zipp?utm_source=pypi-zipp&utm_medium=readme
+
+
+A pathlib-compatible Zipfile object wrapper. Official backport of the standard library
+`Path object <https://docs.python.org/3.8/library/zipfile.html#path-objects>`_.
+
+
+Compatibility
+=============
+
+New features are introduced in this third-party library and later merged
+into CPython. The following table indicates which versions of this library
+were contributed to different versions in the standard library:
+
+.. list-table::
+   :header-rows: 1
+
+   * - zipp
+     - stdlib
+   * - 3.21
+     - 3.15
+   * - 3.18
+     - 3.13
+   * - 3.16
+     - 3.12
+   * - 3.5
+     - 3.11
+   * - 3.2
+     - 3.10
+   * - 3.3 ??
+     - 3.9
+   * - 1.0
+     - 3.8
+
+
+Usage
+=====
+
+Use ``zipp.Path`` in place of ``zipfile.Path`` on any Python.
+
+For Enterprise
+==============
+
+Available as part of the Tidelift Subscription.
+
+This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use.
+
+`Learn more <https://tidelift.com/subscription/pkg/pypi-zipp?utm_source=pypi-zipp&utm_medium=referral&utm_campaign=github>`_.

{opencode_semantic_memory-0.5.1 → opencode_semantic_memory-0.6.1}/AGENTS.md

@@ -31,7 +31,7 @@ python -m opencode_memory.cli stats
 
 ## Architecture
 
-- `server.py` - MCP server with 25+ self-documenting tools
+- `server.py` - MCP server with 45+ self-documenting tools
 - `storage/sqlite.py` - SQLite + FTS5 for text search and metadata
 - `storage/vectors.py` - LanceDB for semantic vector search
 - `query/hybrid.py` - Combines FTS and vector search

{opencode_semantic_memory-0.5.1 → opencode_semantic_memory-0.6.1}/ARCHITECTURE.md

@@ -37,6 +37,22 @@ opencode-memory uses a **3-process architecture** to separate concerns and enabl
 └─────────────────────────────────────────────────────────────────────────────┘
 ```
 
+## HTTP Endpoints
+
+The HTTP server (`http_server.py`) exposes these endpoints:
+
+| Endpoint | Method | Auth | Description |
+|----------|--------|------|-------------|
+| `/health` | GET | No | Health check (200 if healthy, 503 if degraded) |
+| `/stats` | GET | Yes | Detailed statistics (memories, cache, queue, links) |
+| `/metrics` | GET | No | Prometheus-format metrics |
+| `/mcp` | POST | Yes | MCP protocol endpoint (Streamable HTTP transport) |
+| `/tools/{name}` | POST | Yes | Direct tool invocation (for plugin) |
+| `/log-injection` | POST | Yes | Log context injection events |
+| `/session/register` | POST | Yes | Register session with boot context IDs |
+
+**Authentication:** When `OPENCODE_MEMORY_API_KEY` is set, authenticated endpoints require the `Authorization: Bearer <key>` header.
+
 ## Processes
 
 ### 1. HTTP/MCP Server (`opencode-memory.service`)
@@ -164,6 +180,9 @@ Primary storage with FTS5 full-text search:
 - `sessions` - Active OpenCode session tracking
 - `claimed_items` - Session-exclusive item locks
 - `enrichment_queue` - Work queue for embedding computation
+- `context_events` - Unified context tracking (boot, recall, injection events)
+
+**Context Tracking Migration:** The system previously used separate `recall_events` and `context_injections` tables. These have been unified into `context_events`. During migration, data is written to both old and new tables for compatibility. The old tables will be removed in a future version.
 
 ### LanceDB (`vectors/`)
 

{opencode_semantic_memory-0.5.1 → opencode_semantic_memory-0.6.1}/BOOTSTRAP.md

@@ -2,15 +2,9 @@
 
 Essential patterns for using the memory system effectively.
 
-## Session Startup (MANDATORY)
+## Session Startup
 
-Your **FIRST** action in **EVERY** session must be:
-
-```
-memory_get_boot_context()
-```
-
-This loads:
+Boot context provides essential session information:
 - **Boot gates** - Minimal STOP triggers for critical checks
 - **Active sessions** - Parallel sessions to avoid conflicts
 - **Unresolved blockers** - Known obstacles
@@ -18,7 +12,11 @@ This loads:
 - **Stale procedures** - Need review
 - **Active plans** - In-progress work
 
-Only after boot context is loaded should you process the user's request.
+**With the proactive context plugin (recommended):** Boot context is **automatically injected** at session start. No action needed - the plugin handles everything.
+
+**Without the plugin (Claude CLI, Ollama, etc.):** You must manually call `memory_get_boot_context()` as your first action in every session.
+
+The session ID is shown in the boot context footer. Use this ID when claiming items or logging session summaries.
 
 ## Core Workflow
 
@@ -52,7 +50,7 @@ memory_remember(category="plan", what="goal X", why="to achieve Y", content="mil
 ### When Done
 
 1. **Release claimed items**: `memory_release_item(session_id, item_ref)`
-2. **Log session summary**: `memory_log_session(summary, learnings, entities)`
+2. **Log session summary**: `memory_log_session(summary, learnings, entities)` - include the session ID from boot context
 
 ## Categories
 

{opencode_semantic_memory-0.5.1 → opencode_semantic_memory-0.6.1}/CHANGELOG.md

@@ -7,6 +7,54 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.1] - 2026-05-20
+
+### Fixed
+- Documentation alignment: 17 fixes across all docs for consistency with v0.6.0 features
+
+## [0.6.0] - 2026-05-19
+
+### Added
+
+- **Automatic Boot Context Injection** - The proactive context plugin now automatically
+  injects boot context at session start. No need to call `memory_get_boot_context()`
+  manually when using the plugin.
+- **Session Registration** - Plugin automatically registers sessions with the memory
+  server via `/session/register` endpoint, enabling continuation detection.
+- **Boot Context Formatter** - New `boot-context-formatter.ts` module formats boot
+  context for system prompt injection with clear sections and instructions.
+- **Overdue Reminder Display** - Due reminders now show how long they've been overdue.
+- **Directory Hierarchy Cascading** - Boot gates now cascade by directory hierarchy,
+  showing both project-specific and parent directory gates.
+- **Boot Context Re-injection After Compaction** - When OpenCode compacts a session
+  (context window overflow), the plugin automatically re-injects boot context on the
+  next message, ensuring standing instructions aren't lost.
+
+### Changed
+
+- Boot context token estimate and size warning (>2000 tokens) now included in response.
+- Plugin tracks injected memory IDs to prevent duplicate context injection.
+- Session ID shown in boot context footer for continuation tracking.
+
+### Fixed
+
+- Boot gates now properly scoped by project/directory.
+
+## [0.5.0] - 2026-05-18
+
+### Added
+
+- **Unified Context Events** - New `context_events` table replaces separate
+  `recall_events` and `context_injections` tables for unified tracking.
+- **Session Columns** - Sessions table now includes `project`, `git_branch`,
+  `boot_context_ids`, `continues_session_id` for better tracking.
+- **Git Branch Detection** - Boot context now includes current git branch.
+
+### Changed
+
+- Data migration from old tables to unified `context_events` table.
+- Dual-write to both old and new tables during transition period.
+
 ## [0.4.1] - 2026-05-17
 
 ### Fixed

{opencode_semantic_memory-0.5.1 → opencode_semantic_memory-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-semantic-memory
-Version: 0.5.1
+Version: 0.6.1
 Summary: Persistent semantic memory system for OpenCode sessions
 Author-email: Gregory Havenga <ghavenga@gitlab.com>
 License-Expression: MIT
@@ -56,13 +56,13 @@ opencode-memory is an MCP (Model Context Protocol) server that provides long-ter
 - **Contextual directives**: Global + project-specific instructions loaded at boot
 - **Entity tracking**: Links memories to MRs, issues, epics (!123, #456, &789)
 - **GitLab enrichment**: Fetches metadata for entities from GitLab API
-- **Memory age**: All outputs show age to identify potentially outdated information
+- **Memory age**: All outputs show age (`now`, `5m`, `2h`, `3d`, `2w`, `1mo`, `2y`) to identify potentially outdated information
 - **Proactive context injection**: Automatically injects relevant memories before each LLM call (OpenCode only, via plugin)
 - **Agent-agnostic LLM support**: Works with OpenCode, Claude CLI, GitLab Duo, Ollama, or custom commands
 
 ## Prerequisites
 
-- **Python 3.11+** (check with `python3 --version`)
+- **Python 3.11+** (verify with `python3 --version` - must show 3.11 or higher)
 - **git** (for cloning the repository)
 - **venv** module (usually included with Python, or install via `python3-venv` package)
 
@@ -100,7 +100,6 @@ This will:
   - **Linux**: systemd user service
   - **macOS**: launchd LaunchAgent
 - Configure OpenCode integration
-- Create `~/.config/opencode/AGENTS.md` with memory bootstrap
 - Optionally bootstrap core directives (requires confirmation due to LLM costs)
 
 ### From Source
@@ -267,35 +266,20 @@ The setup script automatically builds and configures the plugin if Node.js 20+ i
 
 For more details, see the [plugin documentation](plugin/README.md).
 
-### 4. Configure the Agent
+### 4. Boot Context (Automatic)
 
-Add to `~/.config/opencode/AGENTS.md`:
+When using the proactive context plugin (step 3), boot context is **automatically injected** at session start. This includes:
+- Active parallel sessions (collision warning)
+- Standing instructions (boot gates)
+- Unresolved blockers
+- Due reminders
+- Memory usage instructions
 
-```markdown
-# Agent Instructions
+**No manual configuration needed** - the plugin handles everything.
 
-At session start, always call `memory_get_boot_context` to load prior context, active sessions, and blockers.
+**Legacy AGENTS.md:** If you have an existing `~/.config/opencode/AGENTS.md` with `memory_get_boot_context()` instructions, you can remove it - boot context is now auto-injected. The setup script will offer to clean this up.
 
-## Memory System
-
-The memory system provides persistent context across sessions.
-
-### Proactive Usage
-
-Call `memory_remember` when:
-- You make a decision about approach
-- You hit a blocker
-- You learn how to do something
-- You discover an interesting fact
-
-Call `memory_recall(query)` before:
-- Using an unfamiliar API
-- Making assumptions about how something works
-
-Call `memory_get_context(entity_ref)` before working on any MR/issue/epic.
-
-Categories: decision, blocker, procedure, fact, event, directive
-```
+**Without the plugin:** If you're not using the proactive context plugin (e.g., using Claude CLI or Ollama), you'll need to call `memory_get_boot_context()` manually at session start
 
 ## Configuration
 
@@ -370,6 +354,51 @@ path = "~/.local/share/opencode-memory"
 | `memory_export_memories(output_path?, project?, categories?, since_days?)` | Export to JSON |
 | `memory_import_memories(input_path, dry_run?, skip_duplicates?)` | Import from JSON |
 
+### Reminders
+
+| Tool | Description |
+|------|-------------|
+| `memory_set_reminder(reminder_at, content?, memory_id?, recurrence?)` | Set time-triggered reminder |
+| `memory_clear_reminder(memory_id)` | Dismiss a reminder |
+| `memory_advance_reminder(memory_id)` | Move recurring reminder to next occurrence |
+| `memory_mark_procedure_reviewed(memory_id)` | Mark procedure as still accurate |
+| `memory_set_review_interval(memory_id, interval_days)` | Set procedure review frequency |
+
+### Knowledge Graph
+
+| Tool | Description |
+|------|-------------|
+| `memory_graph_aware(entity_ref, max_depth?)` | Check what knowledge exists for an entity |
+| `memory_graph_explore(entity_ref, types?, limit?)` | Discover related entities |
+| `memory_graph_retrieve(entity_refs, include_memories?)` | Get full content for entities |
+| `memory_graph_status(project?)` | Knowledge graph statistics |
+
+### Code Indexing
+
+| Tool | Description |
+|------|-------------|
+| `memory_index_codebase(path?, incremental?)` | Index code structure (classes, functions) |
+| `memory_initialize_workspace(path?, max_depth?)` | Scan directories for git repos |
+| `memory_extract_concepts(batch_size?)` | Extract semantic concepts via LLM |
+| `memory_search_code(query, symbol_types?)` | Search indexed code symbols |
+
+### GitLab Spider
+
+| Tool | Description |
+|------|-------------|
+| `memory_spider_search(entity_ref, project?, max_depth?)` | Crawl GitLab entity into knowledge graph |
+| `memory_spider_status()` | Check spider queue status |
+| `memory_spider_query(query?, author?, entity_type?)` | Search crawled GitLab content |
+
+### Analytics
+
+| Tool | Description |
+|------|-------------|
+| `memory_effectiveness_report(days?)` | Memory usage patterns and suggestions |
+| `memory_background_report(days?)` | Background process activity |
+| `memory_tool_metrics(action?, since_hours?)` | MCP tool call timing metrics |
+| `memory_vector_index(action?)` | Manage vector search index |
+
 ### Utilities
 
 | Tool | Description |
@@ -379,6 +408,7 @@ path = "~/.local/share/opencode-memory"
 | `memory_bootstrap_memory(path?)` | Scan project files for initial facts |
 | `memory_log_session(summary, learnings?, entities?)` | Log session summary |
 | `memory_memory_status()` | Check system health and queue status |
+| `memory_get_proactive_context(query, entities?, project?)` | Get context for proactive injection (plugin use) |
 
 ## Memory Categories
 
@@ -419,6 +449,7 @@ The daemon automatically:
 | `OPENCODE_MEMORY_PORT` | HTTP server port (default: 9824) |
 | `OPENCODE_MEMORY_API_KEY` | Optional API key for authentication |
 | `OPENCODE_MEMORY_RATE_LIMIT` | Requests per minute per client (default: 60) |
+| `SKIP_BOOTSTRAP` | Set to `1` to skip directive bootstrapping prompt in setup script |
 
 ## Development
 

{opencode_semantic_memory-0.5.1 → opencode_semantic_memory-0.6.1}/README.md

@@ -21,13 +21,13 @@ opencode-memory is an MCP (Model Context Protocol) server that provides long-ter
 - **Contextual directives**: Global + project-specific instructions loaded at boot
 - **Entity tracking**: Links memories to MRs, issues, epics (!123, #456, &789)
 - **GitLab enrichment**: Fetches metadata for entities from GitLab API
-- **Memory age**: All outputs show age to identify potentially outdated information
+- **Memory age**: All outputs show age (`now`, `5m`, `2h`, `3d`, `2w`, `1mo`, `2y`) to identify potentially outdated information
 - **Proactive context injection**: Automatically injects relevant memories before each LLM call (OpenCode only, via plugin)
 - **Agent-agnostic LLM support**: Works with OpenCode, Claude CLI, GitLab Duo, Ollama, or custom commands
 
 ## Prerequisites
 
-- **Python 3.11+** (check with `python3 --version`)
+- **Python 3.11+** (verify with `python3 --version` - must show 3.11 or higher)
 - **git** (for cloning the repository)
 - **venv** module (usually included with Python, or install via `python3-venv` package)
 
@@ -65,7 +65,6 @@ This will:
   - **Linux**: systemd user service
   - **macOS**: launchd LaunchAgent
 - Configure OpenCode integration
-- Create `~/.config/opencode/AGENTS.md` with memory bootstrap
 - Optionally bootstrap core directives (requires confirmation due to LLM costs)
 
 ### From Source
@@ -232,35 +231,20 @@ The setup script automatically builds and configures the plugin if Node.js 20+ i
 
 For more details, see the [plugin documentation](plugin/README.md).
 
-### 4. Configure the Agent
+### 4. Boot Context (Automatic)
 
-Add to `~/.config/opencode/AGENTS.md`:
+When using the proactive context plugin (step 3), boot context is **automatically injected** at session start. This includes:
+- Active parallel sessions (collision warning)
+- Standing instructions (boot gates)
+- Unresolved blockers
+- Due reminders
+- Memory usage instructions
 
-```markdown
-# Agent Instructions
+**No manual configuration needed** - the plugin handles everything.
 
-At session start, always call `memory_get_boot_context` to load prior context, active sessions, and blockers.
+**Legacy AGENTS.md:** If you have an existing `~/.config/opencode/AGENTS.md` with `memory_get_boot_context()` instructions, you can remove it - boot context is now auto-injected. The setup script will offer to clean this up.
 
-## Memory System
-
-The memory system provides persistent context across sessions.
-
-### Proactive Usage
-
-Call `memory_remember` when:
-- You make a decision about approach
-- You hit a blocker
-- You learn how to do something
-- You discover an interesting fact
-
-Call `memory_recall(query)` before:
-- Using an unfamiliar API
-- Making assumptions about how something works
-
-Call `memory_get_context(entity_ref)` before working on any MR/issue/epic.
-
-Categories: decision, blocker, procedure, fact, event, directive
-```
+**Without the plugin:** If you're not using the proactive context plugin (e.g., using Claude CLI or Ollama), you'll need to call `memory_get_boot_context()` manually at session start
 
 ## Configuration
 
@@ -335,6 +319,51 @@ path = "~/.local/share/opencode-memory"
 | `memory_export_memories(output_path?, project?, categories?, since_days?)` | Export to JSON |
 | `memory_import_memories(input_path, dry_run?, skip_duplicates?)` | Import from JSON |
 
+### Reminders
+
+| Tool | Description |
+|------|-------------|
+| `memory_set_reminder(reminder_at, content?, memory_id?, recurrence?)` | Set time-triggered reminder |
+| `memory_clear_reminder(memory_id)` | Dismiss a reminder |
+| `memory_advance_reminder(memory_id)` | Move recurring reminder to next occurrence |
+| `memory_mark_procedure_reviewed(memory_id)` | Mark procedure as still accurate |
+| `memory_set_review_interval(memory_id, interval_days)` | Set procedure review frequency |
+
+### Knowledge Graph
+
+| Tool | Description |
+|------|-------------|
+| `memory_graph_aware(entity_ref, max_depth?)` | Check what knowledge exists for an entity |
+| `memory_graph_explore(entity_ref, types?, limit?)` | Discover related entities |
+| `memory_graph_retrieve(entity_refs, include_memories?)` | Get full content for entities |
+| `memory_graph_status(project?)` | Knowledge graph statistics |
+
+### Code Indexing
+
+| Tool | Description |
+|------|-------------|
+| `memory_index_codebase(path?, incremental?)` | Index code structure (classes, functions) |
+| `memory_initialize_workspace(path?, max_depth?)` | Scan directories for git repos |
+| `memory_extract_concepts(batch_size?)` | Extract semantic concepts via LLM |
+| `memory_search_code(query, symbol_types?)` | Search indexed code symbols |
+
+### GitLab Spider
+
+| Tool | Description |
+|------|-------------|
+| `memory_spider_search(entity_ref, project?, max_depth?)` | Crawl GitLab entity into knowledge graph |
+| `memory_spider_status()` | Check spider queue status |
+| `memory_spider_query(query?, author?, entity_type?)` | Search crawled GitLab content |
+
+### Analytics
+
+| Tool | Description |
+|------|-------------|
+| `memory_effectiveness_report(days?)` | Memory usage patterns and suggestions |
+| `memory_background_report(days?)` | Background process activity |
+| `memory_tool_metrics(action?, since_hours?)` | MCP tool call timing metrics |
+| `memory_vector_index(action?)` | Manage vector search index |
+
 ### Utilities
 
 | Tool | Description |
@@ -344,6 +373,7 @@ path = "~/.local/share/opencode-memory"
 | `memory_bootstrap_memory(path?)` | Scan project files for initial facts |
 | `memory_log_session(summary, learnings?, entities?)` | Log session summary |
 | `memory_memory_status()` | Check system health and queue status |
+| `memory_get_proactive_context(query, entities?, project?)` | Get context for proactive injection (plugin use) |
 
 ## Memory Categories
 
@@ -384,6 +414,7 @@ The daemon automatically:
 | `OPENCODE_MEMORY_PORT` | HTTP server port (default: 9824) |
 | `OPENCODE_MEMORY_API_KEY` | Optional API key for authentication |
 | `OPENCODE_MEMORY_RATE_LIMIT` | Requests per minute per client (default: 60) |
+| `SKIP_BOOTSTRAP` | Set to `1` to skip directive bootstrapping prompt in setup script |
 
 ## Development