opencode-semantic-memory 0.5.1__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.1 → opencode_semantic_memory-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-semantic-memory
-Version: 0.5.1
+Version: 0.6.0
 Summary: Persistent semantic memory system for OpenCode sessions
 Author-email: Gregory Havenga <ghavenga@gitlab.com>
 License-Expression: MIT
@@ -267,35 +267,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
 

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

@@ -232,35 +232,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
 

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,
+  };
+}

{opencode_semantic_memory-0.5.1 → opencode_semantic_memory-0.6.0}/plugin/src/index.ts

@@ -16,8 +16,9 @@
 import type { Plugin, PluginModule, Hooks } from '@opencode-ai/plugin';
 import type { Part } from '@opencode-ai/sdk';
 import { extractEntities, getAllEntityRefs } from './entity-extractor.js';
-import { MemoryClient, type ProactiveContextResponse, type WorkspaceInitResponse } from './memory-client.js';
+import { MemoryClient, type ProactiveContextResponse, type BootContextResponse } from './memory-client.js';
 import { formatContextForInjection } from './context-formatter.js';
+import { formatBootContextForSystem, type FormattedBootContext } from './boot-context-formatter.js';
 import { appendFileSync } from 'node:fs';
 
 const DEBUG_LOG = '/tmp/opencode-memory-plugin.log';
@@ -30,6 +31,12 @@ function debugLog(msg: string) {
 // Cache context per session to share between hooks
 const sessionContextCache = new Map<string, ProactiveContextResponse | null>();
 
+// Cache boot context for first message injection
+const bootContextCache = new Map<string, FormattedBootContext | null>();
+
+// Track which sessions have received boot context (first message detection)
+const sessionBootInjected = new Set<string>();
+
 // Track memory IDs already injected per session to avoid redundant injection
 const injectedMemoryIds = new Map<string, Set<number>>();
 
@@ -129,6 +136,41 @@ export const server: Plugin = async (input, _options) => {
     'chat.message': async ({ sessionID }, output) => {
       debugLog(`[chat.message] sessionID=${sessionID} parts=${output.parts.length}`);
       try {
+        // Check if this is the first message for this session
+        const isFirstMessage = !sessionBootInjected.has(sessionID);
+        
+        let bootContextText: string | null = null;
+        
+        if (isFirstMessage) {
+          debugLog(`[chat.message] first message for session ${sessionID}, fetching boot context`);
+          sessionBootInjected.add(sessionID);
+          
+          // Fetch boot context for injection
+          const bootContext = await client.getBootContext(defaultProject, sessionDirectory);
+          
+          if (bootContext) {
+            // Format boot context
+            const formatted = formatBootContextForSystem(bootContext, sessionID);
+            bootContextText = formatted.text;
+            
+            // Initialize injected IDs with boot context IDs to prevent re-injection
+            const bootIds = new Set(formatted.memoryIds);
+            injectedMemoryIds.set(sessionID, bootIds);
+            
+            debugLog(`[chat.message] boot context fetched: ${formatted.memoryIds.length} memory IDs, ${formatted.tokenEstimate} tokens`);
+            
+            // Register session with memory server (fire-and-forget)
+            client.registerSession({
+              sessionId: sessionID,
+              project: bootContext.identity?.primary_project,
+              gitBranch: bootContext.identity?.git_branch,
+              bootContextIds: formatted.memoryIds,
+            }).catch(() => { /* silent */ });
+          } else {
+            debugLog(`[chat.message] no boot context available`);
+          }
+        }
+
         // Extract text from user's message parts
         const userText = extractTextFromParts(output.parts);
         debugLog(`[chat.message] userText="${userText.substring(0, 100)}..."`);
@@ -142,11 +184,11 @@ export const server: Plugin = async (input, _options) => {
         const entities = extractEntities(userText);
         const allEntityRefs = getAllEntityRefs(entities);
 
-        // Get previously injected IDs for this session
+        // Get previously injected IDs for this session (includes boot context IDs)
         const previouslyInjected = injectedMemoryIds.get(sessionID);
         const excludeIds = previouslyInjected ? Array.from(previouslyInjected) : undefined;
 
-        // Fetch context from memory service, excluding already-injected memories
+        // Fetch proactive context from memory service, excluding boot context + already-injected
         const context = await client.getProactiveContext(
           userText,
           allEntityRefs.length > 0 ? allEntityRefs : undefined,
@@ -156,9 +198,7 @@ export const server: Plugin = async (input, _options) => {
           sessionDirectory  // Pass session directory for git-based project detection
         );
 
-        // Cache for system transform hook
-        sessionContextCache.set(sessionID, context);
-        debugLog(`[chat.message] cached context: ${context?.items?.length ?? 0} items`);
+        debugLog(`[chat.message] proactive context: ${context?.items?.length ?? 0} items`);
 
         // Track which memory IDs we're about to inject
         if (context && context.items.length > 0) {
@@ -170,10 +210,26 @@ export const server: Plugin = async (input, _options) => {
             sessionIds.add(item.memory_id);
           }
         }
+
+        // Cache boot context and proactive context for system.transform hook
+        if (bootContextText) {
+          bootContextCache.set(sessionID, { text: bootContextText, hasContent: true, memoryIds: [], tokenEstimate: 0 } as FormattedBootContext);
+          debugLog(`[chat.message] boot context cached for system.transform`);
+        } else {
+          // Clear boot context cache for subsequent messages
+          bootContextCache.delete(sessionID);
+        }
+        
+        if (context && context.items.length > 0) {
+          sessionContextCache.set(sessionID, context);
+          debugLog(`[chat.message] proactive context cached for system.transform`);
+        } else {
+          sessionContextCache.set(sessionID, null);
+        }
         
-      } catch {
+      } catch (err) {
         // Silent failure - graceful degradation
-        sessionContextCache.set(sessionID, null);
+        debugLog(`[chat.message] error: ${err}`);
       }
     },
 
@@ -181,47 +237,30 @@ export const server: Plugin = async (input, _options) => {
      * Hook: experimental.chat.system.transform
      * 
      * Called before messages are sent to the LLM.
-     * We inject the context into the system prompt here.
+     * Injects boot context + proactive context into system prompt.
+     * Note: This hook may be called multiple times per message - we inject on every call.
      */
     'experimental.chat.system.transform': async ({ sessionID }, output) => {
-      debugLog(`[system.transform] sessionID=${sessionID}`);
+      debugLog(`[system.transform] sessionID=${sessionID} output.system.length=${output.system?.length ?? 'undefined'}`);
       if (!sessionID) {
-        debugLog(`[system.transform] no sessionID, skipping`);
         return;
       }
 
-      const context = sessionContextCache.get(sessionID);
-      debugLog(`[system.transform] cached context: ${context?.items?.length ?? 0} items`);
-      
-      // Clean up cache entry (one-time use per message)
-      sessionContextCache.delete(sessionID);
-      
-      if (!context || context.items.length === 0) {
-        return;
+      // Inject boot context (on first turn, inject on every hook call)
+      const bootContext = bootContextCache.get(sessionID);
+      if (bootContext && bootContext.hasContent) {
+        output.system.push(bootContext.text);
+        debugLog(`[system.transform] injected boot context, output.system.length now=${output.system.length}`);
       }
 
-      // Increment turn number for this session
-      const turnNumber = (sessionTurnNumbers.get(sessionID) ?? 0) + 1;
-      sessionTurnNumbers.set(sessionID, turnNumber);
-
-      // Format and append to system prompt
-      const contextSection = formatContextForSystem(context);
-      
-      if (contextSection) {
-        output.system.push(contextSection);
-        
-        // Log the injection for effectiveness tracking (fire and forget)
-        client.logInjection({
-          sessionId: sessionID,
-          turnNumber,
-          memoryIds: context.items.map(item => item.memory_id),
-          relevanceSummary: context.relevance_summary,
-          queryPreview: context.semantic_query,
-          totalTokens: context.total_tokens,
-          itemsCount: context.items_count,
-        }).catch(() => { /* silent */ });
-        
-        debugLog(`[system.transform] logged injection: turn=${turnNumber} items=${context.items_count}`);
+      // Inject proactive context
+      const context = sessionContextCache.get(sessionID);
+      if (context && context.items && context.items.length > 0) {
+        const contextSection = formatContextForSystem(context);
+        if (contextSection) {
+          output.system.push(contextSection);
+          debugLog(`[system.transform] injected proactive context, output.system.length now=${output.system.length}`);
+        }
       }
     },
   };