@jcmrs/opencode-vmem 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,83 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.0.0] - 2026-02-19
+
+### Added
+
+#### Episodic Memory
+- Observation capture from tool executions
+- Tool after hook for automatic capture
+- Observation filtering and classification
+- Session tracking and summaries
+
+#### Semantic Memory
+- Memory card storage (fact, preference, profile, goal)
+- Rules-based extraction (16 default rules)
+- LLM-based extraction with z.ai/OpenAI support
+- Confidence scoring with auto-tombstoning
+
+#### Procedural Memory
+- Pattern mining from observations
+- Procedure induction (SAR tuples)
+- Procedure suggestion based on context
+
+#### Search & Retrieval
+- Lexical search (exact word matching)
+- Semantic search (embedding-based similarity)
+- Hybrid search mode (auto fallback)
+- Cosine similarity for embeddings
+
+#### Context Building
+- Token-aware context assembly
+- Memory card prioritization
+- Markdown and plain text formatting
+- System prompt transformation hook
+
+#### Export & Archive
+- Export to JSON, Markdown, Plain text
+- Memory archiving for large files
+- Backup and recovery system
+- Archive listing and pruning
+
+#### Plugin Interface
+- 6 agent-callable tools (mind_search, mind_state, etc.)
+- 9 user commands (/mind:stats, /mind:search, etc.)
+- 3 hooks (tool-after, session-idle, system-transform)
+
+#### Infrastructure
+- MV2 file format adapter with backup/recovery
+- Crash recovery for corrupted files
+- Cross-platform support (Windows, macOS, Linux)
+- Configurable embedding model caching
+
+### Tests
+- 353 tests passing
+- 74% statement coverage
+- 78% branch coverage
+- 82% function coverage
+
+### Documentation
+- User-facing README
+- Configuration reference
+- Commands reference
+- Troubleshooting guide
+- Testing guide
+- Manual testing checklist
+
+### Packaging
+- npm-ready with `files` field in package.json
+- .npmignore for clean package
+- LICENSE file (MIT)
+- Repository, bugs, homepage fields
+
+### Fixed
+- LLM authentication (API key support)
+- MV2Adapter data loss (full round-trip)
+- mind_suggest stub (now uses ProcedureSuggester)
+- Windows file locking issues
+- Corruption recovery patterns
+- Console.log replaced with console.error for consistency
+- Embedding and procedural modules now exported from main index
+- Path duplication bug in embedding cacheDir (was joined twice)

package/LICENSE

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

package/README.md

@@ -0,0 +1,172 @@
+# @jcmrs/opencode-vmem
+
+[![CI](https://github.com/jcmrs/opencode-vmem/actions/workflows/ci.yml/badge.svg)](https://github.com/jcmrs/opencode-vmem/actions/workflows/ci.yml)
+
+A portable, persistent memory plugin for AI/LLM/Agent contexts. Provides episodic, semantic, and procedural memory capabilities.
+
+## Features
+
+- **Episodic Memory** - Captures and stores observations from tool executions
+- **Semantic Memory** - Extracts and stores facts, preferences, and profiles
+- **Procedural Memory** - Learns workflows and suggests relevant procedures
+- **Semantic Search** - Embedding-based similarity search with hybrid fallback
+- **Context Injection** - Builds relevant context for AI sessions
+- **Export & Archive** - Export to JSON/Markdown, archive old memories
+
+## Installation
+
+### From GitHub (no registry account needed)
+
+```bash
+npm install jcmrs/opencode-vmem
+```
+
+### From GitHub Packages (requires authentication)
+
+```bash
+# Configure npm for GitHub Packages
+echo "@jcmrs:registry=https://npm.pkg.github.com" >> .npmrc
+
+# Install
+npm install @jcmrs/opencode-vmem
+```
+
+## Quick Start
+
+```typescript
+import { Mind } from '@jcmrs/opencode-vmem';
+
+const mind = await Mind.open('/path/to/project');
+
+await mind.observe({
+  type: 'tool_execution',
+  content: 'User prefers TypeScript over JavaScript',
+  tool: 'bash'
+});
+
+const results = await mind.search('typescript preferences', 5);
+console.log(results);
+```
+
+## Tools (Agent-Callable)
+
+| Tool | Description |
+|------|-------------|
+| `mind_search` | Search memories by query |
+| `mind_state` | Get memory system statistics |
+| `mind_forget` | Mark a memory for deletion |
+| `mind_add_card` | Add a memory card |
+| `mind_context` | Build current memory context |
+| `mind_suggest` | Get procedure suggestions |
+
+## Commands (User-Callable)
+
+| Command | Description |
+|---------|-------------|
+| `/mind:stats` | Display memory statistics |
+| `/mind:search <query>` | Search memories |
+| `/mind:context` | Show current context |
+| `/mind:forget <id>` | Mark memory for deletion |
+| `/mind:add <entity> <slot> <value>` | Add memory card |
+| `/mind:cards` | List all memory cards |
+| `/mind:export` | Export memory (json/md/plain) |
+| `/mind:archive` | Archive current memory |
+| `/mind:help` | Show help |
+
+## Configuration
+
+Create `.opencode/vmem.json` in your project:
+
+```json
+{
+  "capture": {
+    "enabled": true,
+    "minOutputLength": 50
+  },
+  "embedding": {
+    "enabled": true,
+    "model": "Xenova/nomic-embed-text-v1"
+  },
+  "context": {
+    "maxTokens": 3000,
+    "format": "markdown"
+  }
+}
+```
+
+See [docs/configuration.md](docs/configuration.md) for all options.
+
+## Architecture
+
+```
+.opencode/
+├── memory/
+│   ├── mind.mv2        # Main memory store (MV2 format)
+│   ├── cards.json      # Memory cards (extracted facts)
+│   ├── procedures.json # Learned procedures
+│   └── tombstones.json # Soft-deleted frames
+├── archives/           # Archived memories
+└── vmem.json           # Configuration
+```
+
+## Memory Types
+
+### Episodic (Observations)
+Raw events captured from tool executions:
+- Tool inputs and outputs
+- User interactions
+- Session context
+
+### Semantic (Memory Cards)
+Extracted knowledge:
+- **fact** - Verified information
+- **preference** - User preferences
+- **profile** - User/Project profiles
+- **goal** - Stated objectives
+
+### Procedural (Workflows)
+Learned patterns:
+- State-Action-Result tuples
+- Workflow templates
+- Success/failure rates
+
+## Search Modes
+
+| Mode | Description |
+|------|-------------|
+| `lex` | Lexical search (exact words) |
+| `sem` | Semantic search (embeddings) |
+| `auto` | Hybrid (tries semantic, falls back to lexical) |
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/jcmrs/opencode-vmem.git
+cd opencode-vmem
+npm install
+
+# Run tests
+npm test
+
+# Run smoke test
+npm run smoke
+
+# Build
+npm run build
+
+# Validate real-world usage
+npm run validate
+```
+
+## CI/CD
+
+This project uses GitHub Actions for:
+- Multi-platform testing (Ubuntu, Windows, macOS)
+- Node.js 18 and 20 support
+- Automated smoke tests
+- Coverage reporting
+
+## License
+
+MIT

package/dist/capture/classification.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Observation type classification
+ *
+ * Provides confidence-weighted classification of observations.
+ */
+import { ObservationType, ConfidenceScore } from '../types.js';
+export interface ClassificationResult {
+    type: ObservationType;
+    confidence: number;
+    factors: string[];
+    shouldFlag: boolean;
+    shouldTombstone: boolean;
+}
+export interface ClassificationContext {
+    tool: string;
+    input?: Record<string, unknown>;
+    output?: string;
+    exitCode?: number;
+}
+/**
+ * Classify an observation context
+ */
+export declare function classify(context: ClassificationContext): ClassificationResult;
+/**
+ * Calculate confidence score from result
+ */
+export declare function calculateConfidence(result: ClassificationResult): ConfidenceScore;
+/**
+ * Adjust confidence based on additional factors
+ */
+export declare function adjustConfidence(base: number, factors: {
+    outputLength?: number;
+    isRepeat?: boolean;
+    hasSensitiveData?: boolean;
+    age?: number;
+}): number;
+//# sourceMappingURL=classification.d.ts.map

package/dist/capture/classification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification.d.ts","sourceRoot":"","sources":["../../src/capture/classification.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE/D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,eAAe,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAsED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,CAwC7E;AAmED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,oBAAoB,GAAG,eAAe,CAOjF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACA,MAAM,CAmBR"}

package/dist/capture/classification.js

@@ -0,0 +1,181 @@
+/**
+ * Observation type classification
+ *
+ * Provides confidence-weighted classification of observations.
+ */
+/**
+ * Default classification rules
+ */
+const CLASSIFICATION_RULES = [
+    {
+        type: 'error',
+        priority: 100,
+        patterns: [
+            { pattern: /error[:：]/i, confidence: 0.95, field: 'output' },
+            { pattern: /exception[:：]/i, confidence: 0.95, field: 'output' },
+            { pattern: /failed[:：]/i, confidence: 0.90, field: 'output' },
+            { pattern: /cannot \w+/i, confidence: 0.85, field: 'output' },
+            { pattern: /unable to \w+/i, confidence: 0.85, field: 'output' },
+            { pattern: /fatal[:：]/i, confidence: 0.95, field: 'output' }
+        ]
+    },
+    {
+        type: 'decision',
+        priority: 90,
+        patterns: [
+            { pattern: /(?:decided|chose|selected) to/i, confidence: 0.90, field: 'output' },
+            { pattern: /(?:will use|going with)/i, confidence: 0.85, field: 'output' },
+            { pattern: /(?:decided|chose|selected)[:：]/i, confidence: 0.90, field: 'output' }
+        ]
+    },
+    {
+        type: 'preference_expressed',
+        priority: 85,
+        patterns: [
+            { pattern: /(?:I |we )?(?:prefer|like|dislike|hate)/i, confidence: 0.85, field: 'output' },
+            { pattern: /(?:my |our )?(?:favorite|preference)/i, confidence: 0.80, field: 'output' }
+        ]
+    },
+    {
+        type: 'goal_stated',
+        priority: 80,
+        patterns: [
+            { pattern: /(?:goal|objective|aim|target)[:：]/i, confidence: 0.85, field: 'output' },
+            { pattern: /(?:want|need) to/i, confidence: 0.70, field: 'output' }
+        ]
+    },
+    {
+        type: 'constraint_identified',
+        priority: 75,
+        patterns: [
+            { pattern: /(?:constraint|limitation|restriction)[:：]/i, confidence: 0.85, field: 'output' },
+            { pattern: /(?:must|cannot|don't|do not)[:：]/i, confidence: 0.75, field: 'output' }
+        ]
+    }
+];
+// Confidence thresholds
+const FLAG_THRESHOLD = 0.5;
+const TOMBSTONE_THRESHOLD = 0.3;
+/**
+ * Classify an observation context
+ */
+export function classify(context) {
+    const factors = [];
+    let bestType = getDefaultType(context.tool);
+    let bestConfidence = 0.0;
+    // Check exit code first
+    if (context.exitCode !== undefined && context.exitCode !== 0) {
+        bestType = 'error';
+        bestConfidence = 0.9;
+        factors.push('non_zero_exit_code');
+    }
+    // Apply classification rules
+    for (const rule of CLASSIFICATION_RULES) {
+        const matchResult = matchRule(rule, context);
+        if (matchResult.matched && matchResult.confidence > bestConfidence) {
+            bestType = rule.type;
+            bestConfidence = matchResult.confidence;
+            factors.push(...matchResult.factors);
+        }
+    }
+    // If no rules matched, use tool-based default with moderate confidence
+    if (bestConfidence === 0.0) {
+        bestConfidence = 0.5;
+        factors.push('default_by_tool');
+    }
+    // Calculate flags
+    const shouldFlag = bestConfidence < FLAG_THRESHOLD;
+    const shouldTombstone = bestConfidence < TOMBSTONE_THRESHOLD;
+    return {
+        type: bestType,
+        confidence: bestConfidence,
+        factors,
+        shouldFlag,
+        shouldTombstone
+    };
+}
+/**
+ * Match a classification rule against context
+ */
+function matchRule(rule, context) {
+    const factors = [];
+    let maxConfidence = 0.0;
+    let matched = false;
+    for (const { pattern, confidence, field } of rule.patterns) {
+        const text = getTextForField(field, context);
+        if (!text)
+            continue;
+        if (pattern.test(text)) {
+            matched = true;
+            if (confidence > maxConfidence) {
+                maxConfidence = confidence;
+                factors.push(`pattern_match:${pattern.source.slice(0, 20)}`);
+            }
+        }
+    }
+    return { matched, confidence: maxConfidence, factors };
+}
+/**
+ * Get text for a field
+ */
+function getTextForField(field, context) {
+    switch (field) {
+        case 'output':
+            return context.output || null;
+        case 'input':
+            return context.input ? JSON.stringify(context.input) : null;
+        case 'content':
+            // Content is output for our purposes
+            return context.output || null;
+    }
+}
+/**
+ * Get default observation type for a tool
+ */
+function getDefaultType(tool) {
+    switch (tool) {
+        case 'read':
+        case 'glob':
+        case 'grep':
+            return 'file_read';
+        case 'write':
+            return 'file_write';
+        case 'edit':
+            return 'file_edit';
+        case 'bash':
+            return 'command_run';
+        default:
+            return 'tool_execution';
+    }
+}
+/**
+ * Calculate confidence score from result
+ */
+export function calculateConfidence(result) {
+    return {
+        score: result.confidence,
+        factors: result.factors,
+        shouldFlag: result.shouldFlag,
+        shouldTombstone: result.shouldTombstone
+    };
+}
+/**
+ * Adjust confidence based on additional factors
+ */
+export function adjustConfidence(base, factors) {
+    let adjusted = base;
+    // Penalize very short outputs
+    if (factors.outputLength !== undefined && factors.outputLength < 20) {
+        adjusted *= 0.8;
+    }
+    // Boost repeated patterns
+    if (factors.isRepeat) {
+        adjusted = Math.min(1.0, adjusted * 1.1);
+    }
+    // Penalize sensitive data
+    if (factors.hasSensitiveData) {
+        adjusted *= 0.7;
+    }
+    return Math.max(0, Math.min(1, adjusted));
+}
+//# sourceMappingURL=classification.js.map

package/dist/capture/classification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classification.js","sourceRoot":"","sources":["../../src/capture/classification.ts"],"names":[],"mappings":"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"}

package/dist/capture/filtering.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Noise filtering for observation capture
+ *
+ * Filters out low-value observations to reduce memory bloat.
+ */
+import { CaptureInput } from './observation.js';
+export interface FilterRule {
+    name: string;
+    description: string;
+    test: (input: CaptureInput) => boolean;
+}
+/**
+ * Default filter rules
+ *
+ * Returns true if the observation should be FILTERED OUT (skipped)
+ */
+declare const DEFAULT_FILTERS: FilterRule[];
+export declare class ObservationFilter {
+    private filters;
+    private disabledFilters;
+    constructor(options?: {
+        filters?: FilterRule[];
+        disabledFilters?: string[];
+    });
+    /**
+     * Check if an observation should be filtered out
+     *
+     * @returns true if the observation should be skipped
+     */
+    shouldFilter(input: CaptureInput): boolean;
+    /**
+     * Get the reason why an observation was filtered
+     *
+     * @returns filter name if filtered, null otherwise
+     */
+    getFilterReason(input: CaptureInput): string | null;
+    /**
+     * Add a custom filter
+     */
+    addFilter(filter: FilterRule): void;
+    /**
+     * Remove a filter by name
+     */
+    removeFilter(name: string): void;
+    /**
+     * Enable a previously disabled filter
+     */
+    enableFilter(name: string): void;
+    /**
+     * Disable a filter
+     */
+    disableFilter(name: string): void;
+    /**
+     * Get list of active filter names
+     */
+    getActiveFilters(): string[];
+}
+/**
+ * Create default observation filter
+ */
+export declare function createDefaultFilter(): ObservationFilter;
+export { DEFAULT_FILTERS };
+//# sourceMappingURL=filtering.d.ts.map

package/dist/capture/filtering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filtering.d.ts","sourceRoot":"","sources":["../../src/capture/filtering.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC;CACxC;AAED;;;;GAIG;AACH,QAAA,MAAM,eAAe,EAAE,UAAU,EAkFhC,CAAC;AAEF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,eAAe,CAAc;gBAEzB,OAAO,GAAE;QACnB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB;IAUN;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAmB1C;;;;OAIG;IACH,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI;IAkBnD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAInC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIjC;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;CAK7B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,iBAAiB,CAEvD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}