opencode-semantic-memory 0.5.0__tar.gz → 0.6.0__tar.gz

opencode_semantic_memory-0.6.0/.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.0 → opencode_semantic_memory-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-semantic-memory
-Version: 0.5.0
+Version: 0.6.0
 Summary: Persistent semantic memory system for OpenCode sessions
 Author-email: Gregory Havenga <ghavenga@gitlab.com>
 License-Expression: MIT
@@ -57,6 +57,8 @@ opencode-memory is an MCP (Model Context Protocol) server that provides long-ter
 - **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
+- **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
 
@@ -136,6 +138,40 @@ To enable LLM extraction (if you want it), add to `~/.config/opencode-memory/con
 llm_extraction = true
 ```
 
+### LLM Provider Configuration
+
+The memory system supports multiple LLM providers for knowledge extraction and session analysis. By default, it uses OpenCode, but you can configure alternatives:
+
+```toml
+# ~/.config/opencode-memory/config.toml
+
+# Option 1: OpenCode (default) - uses your configured OpenCode LLM
+[llm]
+provider = "opencode"
+
+# Option 2: Anthropic Claude CLI (requires claude-cli package)
+[llm]
+provider = "claude"
+model = "claude-sonnet-4-20250514"  # optional
+
+# Option 3: GitLab Duo CLI (requires glab with Duo enabled)
+[llm]
+provider = "duo"
+
+# Option 4: Ollama (local models)
+[llm]
+provider = "ollama"
+model = "qwen2.5:14b"  # or any model you have pulled
+
+# Option 5: Custom command
+[llm]
+provider = "custom"
+command = "my-llm-cli"
+args = ["--prompt"]  # prompt is appended after these args
+```
+
+**Note:** The proactive context injection feature (automatic memory loading) currently only works with OpenCode via the plugin system. Other LLM providers can still use all memory tools manually.
+
 ## Quick Start
 
 ### 1. Start the Memory Services
@@ -201,35 +237,50 @@ Add to `~/.config/opencode/opencode.json`:
 }
 ```
 
-### 3. Configure the Agent
+### 3. Enable Proactive Context Injection (OpenCode Only)
+
+The proactive context plugin automatically injects relevant memories before each LLM call, so the AI has historical context without needing explicit `memory_recall` calls.
 
-Add to `~/.config/opencode/AGENTS.md`:
+**Requirements:**
+- OpenCode (not supported with other LLM providers)
+- Node.js 20+ (for building the plugin)
 
-```markdown
-# Agent Instructions
+**Setup:**
 
-At session start, always call `memory_get_boot_context` to load prior context, active sessions, and blockers.
+The setup script automatically builds and configures the plugin if Node.js 20+ is available. To verify or configure manually:
 
-## Memory System
+```json
+// ~/.config/opencode/opencode.json
+{
+  "mcp": { ... },
+  "plugin": ["/path/to/opencode-memory-install/plugin"]
+}
+```
 
-The memory system provides persistent context across sessions.
+**How it works:**
+1. User sends a message → Plugin extracts entities (!MR, #issue, @user)
+2. Plugin calls memory server for relevant context
+3. Context is injected into the system prompt before LLM call
+4. AI sees relevant history automatically
 
-### Proactive Usage
+**Note:** If you're using a different LLM provider (Claude, Duo, Ollama), you'll need to call memory tools explicitly - proactive injection only works with the OpenCode plugin.
 
-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
+For more details, see the [plugin documentation](plugin/README.md).
 
-Call `memory_recall(query)` before:
-- Using an unfamiliar API
-- Making assumptions about how something works
+### 4. Boot Context (Automatic)
 
-Call `memory_get_context(entity_ref)` before working on any MR/issue/epic.
+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
 
-Categories: decision, blocker, procedure, fact, event, directive
-```
+**No manual configuration needed** - the plugin handles everything.
+
+**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.
+
+**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
 

{opencode_semantic_memory-0.5.0 → opencode_semantic_memory-0.6.0}/README.md

@@ -22,6 +22,8 @@ opencode-memory is an MCP (Model Context Protocol) server that provides long-ter
 - **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
+- **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
 
@@ -101,6 +103,40 @@ To enable LLM extraction (if you want it), add to `~/.config/opencode-memory/con
 llm_extraction = true
 ```
 
+### LLM Provider Configuration
+
+The memory system supports multiple LLM providers for knowledge extraction and session analysis. By default, it uses OpenCode, but you can configure alternatives:
+
+```toml
+# ~/.config/opencode-memory/config.toml
+
+# Option 1: OpenCode (default) - uses your configured OpenCode LLM
+[llm]
+provider = "opencode"
+
+# Option 2: Anthropic Claude CLI (requires claude-cli package)
+[llm]
+provider = "claude"
+model = "claude-sonnet-4-20250514"  # optional
+
+# Option 3: GitLab Duo CLI (requires glab with Duo enabled)
+[llm]
+provider = "duo"
+
+# Option 4: Ollama (local models)
+[llm]
+provider = "ollama"
+model = "qwen2.5:14b"  # or any model you have pulled
+
+# Option 5: Custom command
+[llm]
+provider = "custom"
+command = "my-llm-cli"
+args = ["--prompt"]  # prompt is appended after these args
+```
+
+**Note:** The proactive context injection feature (automatic memory loading) currently only works with OpenCode via the plugin system. Other LLM providers can still use all memory tools manually.
+
 ## Quick Start
 
 ### 1. Start the Memory Services
@@ -166,35 +202,50 @@ Add to `~/.config/opencode/opencode.json`:
 }
 ```
 
-### 3. Configure the Agent
+### 3. Enable Proactive Context Injection (OpenCode Only)
+
+The proactive context plugin automatically injects relevant memories before each LLM call, so the AI has historical context without needing explicit `memory_recall` calls.
 
-Add to `~/.config/opencode/AGENTS.md`:
+**Requirements:**
+- OpenCode (not supported with other LLM providers)
+- Node.js 20+ (for building the plugin)
 
-```markdown
-# Agent Instructions
+**Setup:**
 
-At session start, always call `memory_get_boot_context` to load prior context, active sessions, and blockers.
+The setup script automatically builds and configures the plugin if Node.js 20+ is available. To verify or configure manually:
 
-## Memory System
+```json
+// ~/.config/opencode/opencode.json
+{
+  "mcp": { ... },
+  "plugin": ["/path/to/opencode-memory-install/plugin"]
+}
+```
 
-The memory system provides persistent context across sessions.
+**How it works:**
+1. User sends a message → Plugin extracts entities (!MR, #issue, @user)
+2. Plugin calls memory server for relevant context
+3. Context is injected into the system prompt before LLM call
+4. AI sees relevant history automatically
 
-### Proactive Usage
+**Note:** If you're using a different LLM provider (Claude, Duo, Ollama), you'll need to call memory tools explicitly - proactive injection only works with the OpenCode plugin.
 
-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
+For more details, see the [plugin documentation](plugin/README.md).
 
-Call `memory_recall(query)` before:
-- Using an unfamiliar API
-- Making assumptions about how something works
+### 4. Boot Context (Automatic)
 
-Call `memory_get_context(entity_ref)` before working on any MR/issue/epic.
+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
 
-Categories: decision, blocker, procedure, fact, event, directive
-```
+**No manual configuration needed** - the plugin handles everything.
+
+**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.
+
+**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
 

opencode_semantic_memory-0.6.0/plugin/src/boot-context-formatter.ts

@@ -0,0 +1,147 @@
+/**
+ * Format boot context for injection into the system prompt.
+ */
+
+import type { BootContextResponse } from './memory-client.js';
+
+export interface FormattedBootContext {
+  text: string;
+  hasContent: boolean;
+  memoryIds: number[];
+  tokenEstimate: number;
+  sizeWarning?: string;
+}
+
+/**
+ * Format boot context response into markdown for system prompt injection.
+ */
+export function formatBootContextForSystem(
+  boot: BootContextResponse,
+  sessionId: string
+): FormattedBootContext {
+  const sections: string[] = [];
+  const memoryIds = boot._memory_ids_shown ?? [];
+
+  sections.push('## Boot Context (Auto-Injected)\n');
+  sections.push('This context was automatically loaded from memory at session start.\n');
+
+  // Identity section
+  if (boot.identity) {
+    const { primary_project, git_branch } = boot.identity;
+    if (primary_project) {
+      sections.push(`**Project:** ${primary_project}`);
+    }
+    if (git_branch) {
+      sections.push(`**Branch:** ${git_branch}`);
+    }
+  }
+
+  // Active parallel sessions (collision warning)
+  if (boot.active_sessions && boot.active_sessions.length > 0) {
+    sections.push('\n### Active Parallel Sessions');
+    sections.push('⚠️ Other sessions are active. Check claimed items to avoid conflicts.\n');
+    for (const session of boot.active_sessions) {
+      const claimed = session.claimed_items?.join(', ') || 'none';
+      sections.push(`- **${session.id}**: ${session.working_on || 'unknown'} (claims: ${claimed})`);
+    }
+  }
+
+  // Boot gates (critical standing instructions)
+  if (boot.boot_gates && boot.boot_gates.length > 0) {
+    sections.push('\n### ⛔ STANDING INSTRUCTIONS (MUST FOLLOW)\n');
+    sections.push(`**CRITICAL:** Before responding to EVERY user message, scan these ${boot.boot_gates.length} triggers. If the user's message matches a trigger (e.g., mentions "screenshot", asks to "create MR", etc.), you MUST follow that instruction.\n`);
+    for (const gate of boot.boot_gates) {
+      sections.push(`⛔ ${gate.content}`);
+    }
+  }
+
+  // Unresolved blockers
+  if (boot.unresolved_blockers && boot.unresolved_blockers.length > 0) {
+    sections.push('\n### Unresolved Blockers');
+    sections.push('These issues are blocking progress:\n');
+    for (const blocker of boot.unresolved_blockers.slice(0, 5)) {
+      const content = blocker.content.length > 150 
+        ? blocker.content.substring(0, 150) + '...'
+        : blocker.content;
+      sections.push(`- ${content} (${blocker.age})`);
+    }
+    if (boot.unresolved_blockers.length > 5) {
+      sections.push(`- ... and ${boot.unresolved_blockers.length - 5} more`);
+    }
+  }
+
+  // Due reminders
+  if (boot.due_reminders && boot.due_reminders.length > 0) {
+    sections.push('\n### Due Reminders\n');
+    for (const reminder of boot.due_reminders) {
+      sections.push(`- **${reminder.what || 'Reminder'}**: ${reminder.content.substring(0, 200)}`);
+    }
+  }
+
+  // Recent sessions (potential continuations)
+  if (boot.recent_sessions && boot.recent_sessions.length > 0) {
+    sections.push('\n### Recent Sessions');
+    sections.push('(May be continuations of current work)\n');
+    for (const session of boot.recent_sessions.slice(0, 3)) {
+      sections.push(`- ${session.title}`);
+    }
+  }
+
+  // Key procedures
+  if (boot.key_procedures && boot.key_procedures.length > 0) {
+    sections.push('\n### Key Procedures\n');
+    for (const proc of boot.key_procedures) {
+      sections.push(`- **${proc.what}** (${proc.age})`);
+    }
+  }
+
+  // Stale procedures needing review
+  if (boot.stale_procedures && boot.stale_procedures.length > 0) {
+    sections.push('\n### Procedures Needing Review');
+    sections.push('These may be outdated:\n');
+    for (const proc of boot.stale_procedures.slice(0, 3)) {
+      sections.push(`- ${proc.what} (last reviewed: ${proc.last_reviewed})`);
+    }
+  }
+
+  // Size warning
+  if (boot._size_warning) {
+    sections.push(`\n⚠️ **${boot._size_warning}**`);
+  }
+
+  // Memory usage instructions
+  sections.push('\n### Memory Usage');
+  sections.push(`
+**Throughout this session:**
+- Before working on an MR/issue/epic, call \`memory_get_context(entity_ref)\` to get history
+- Use \`memory_claim_item(item_ref)\` before making changes to prevent conflicts
+- Store important decisions, blockers, and procedures with \`memory_remember()\`
+- Release claimed items when done with \`memory_release_item()\`
+- Use \`memory_recall(query)\` to search for relevant context
+
+**Categories for memory_remember:**
+- \`decision\` - Architectural/design choices
+- \`blocker\` - Obstacles preventing progress  
+- \`procedure\` - How-to knowledge, workflows
+- \`fact\` - Project-specific information
+- \`plan\` - Sequence of steps with end state
+- \`idea\` - Future possibilities, deferred considerations
+`);
+
+  // Session tracking footer
+  sections.push('### Session Tracking');
+  sections.push(`Session ID: \`${sessionId}\``);
+  sections.push('When this session ends, include the session ID in any summary for continuation tracking.');
+
+  const text = sections.join('\n');
+  
+  return {
+    text,
+    hasContent: (boot.boot_gates?.length ?? 0) > 0 || 
+                (boot.unresolved_blockers?.length ?? 0) > 0 || 
+                (boot.due_reminders?.length ?? 0) > 0,
+    memoryIds,
+    tokenEstimate: boot._token_estimate ?? Math.floor(text.length / 4),
+    sizeWarning: boot._size_warning,
+  };
+}