true-mem 1.0.0

package/dist/storage/sqlite-adapter.js

@@ -0,0 +1,99 @@
+/**
+ * SQLite Adapter - Runtime-agnostic SQLite interface
+ *
+ * Supports:
+ * - bun:sqlite  (Bun runtime)
+ * - node:sqlite (Node.js 22+, no native addons required)
+ */
+/**
+ * Detect if running in Bun
+ */
+export function isBun() {
+    return typeof globalThis.Bun !== 'undefined';
+}
+/**
+ * Create a SQLite database connection using the appropriate native driver
+ */
+export async function createDatabase(dbPath) {
+    if (isBun()) {
+        return createBunDatabase(dbPath);
+    }
+    else {
+        return createNodeDatabase(dbPath);
+    }
+}
+/**
+ * Create database using bun:sqlite
+ */
+async function createBunDatabase(dbPath) {
+    // @ts-expect-error - bun:sqlite is only available in Bun runtime
+    const { Database } = await import('bun:sqlite');
+    const db = new Database(dbPath);
+    return {
+        exec(sql) {
+            db.exec(sql);
+        },
+        prepare(sql) {
+            const stmt = db.prepare(sql);
+            return {
+                run(...params) {
+                    stmt.run(...params);
+                    return {
+                        changes: db.changes,
+                        lastInsertRowid: db.lastInsertRowid,
+                    };
+                },
+                get(...params) {
+                    return stmt.get(...params);
+                },
+                all(...params) {
+                    return stmt.all(...params);
+                },
+            };
+        },
+        close() {
+            db.close();
+        },
+        pragma(pragma) {
+            return db.query(`PRAGMA ${pragma}`).get();
+        },
+    };
+}
+/**
+ * Create database using node:sqlite (Node.js 22+)
+ */
+async function createNodeDatabase(dbPath) {
+    // node:sqlite is synchronous — dynamic import keeps the async adapter signature uniform
+    const { DatabaseSync } = await import('node:sqlite');
+    const db = new DatabaseSync(dbPath);
+    return {
+        exec(sql) {
+            db.exec(sql);
+        },
+        prepare(sql) {
+            const stmt = db.prepare(sql);
+            return {
+                run(...params) {
+                    const result = stmt.run(...params);
+                    return {
+                        changes: result.changes,
+                        lastInsertRowid: result.lastInsertRowid,
+                    };
+                },
+                get(...params) {
+                    return stmt.get(...params);
+                },
+                all(...params) {
+                    return stmt.all(...params);
+                },
+            };
+        },
+        close() {
+            db.close();
+        },
+        pragma(pragma) {
+            return db.prepare(`PRAGMA ${pragma}`).get();
+        },
+    };
+}
+//# sourceMappingURL=sqlite-adapter.js.map

package/dist/storage/sqlite-adapter.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,266 @@
+/**
+ * True-Mem Type Definitions
+ * Adapted from PsychMem for OpenCode
+ */
+export type AgentType = 'opencode';
+/**
+ * Memory classification aligned with psychological memory models
+ */
+export type MemoryClassification = 'episodic' | 'semantic' | 'procedural' | 'bugfix' | 'learning' | 'preference' | 'decision' | 'constraint';
+/**
+ * Memory scope determines injection behavior
+ */
+export type MemoryScope = 'user' | 'project';
+/**
+ * Classifications that are user-level (always injected)
+ */
+export declare const USER_LEVEL_CLASSIFICATIONS: MemoryClassification[];
+/**
+ * Classifications that are project-level (only injected for matching project)
+ */
+export declare const PROJECT_LEVEL_CLASSIFICATIONS: MemoryClassification[];
+export declare function isUserLevelClassification(classification: MemoryClassification): boolean;
+export declare function getScopeForClassification(classification: MemoryClassification): MemoryScope;
+/**
+ * Memory store type
+ */
+export type MemoryStore = 'stm' | 'ltm';
+/**
+ * Memory status for lifecycle management
+ */
+export type MemoryStatus = 'active' | 'decayed' | 'pinned' | 'forgotten';
+/**
+ * Message role from OpenCode SDK
+ */
+export type MessageRole = 'user' | 'assistant' | 'system';
+/**
+ * Role-aware context for memory extraction
+ */
+export interface RoleAwareContext {
+    /**
+     * Primary role of the message containing the memory candidate
+     */
+    primaryRole: MessageRole;
+    /**
+     * Role-weighted score (10x for Human messages)
+     */
+    roleWeightedScore: number;
+    /**
+     * Whether Assistant context supports the memory
+     */
+    hasAssistantContext: boolean;
+    /**
+     * Full conversation with role markers
+     */
+    fullConversation: string;
+}
+/**
+ * A line with its role from the conversation
+ */
+export interface RoleAwareLine {
+    text: string;
+    role: MessageRole;
+    lineNumber: number;
+}
+/**
+ * Role validation rules for memory classifications
+ * Determines which roles are valid sources for each classification type
+ */
+export declare const ROLE_VALIDATION_RULES: Record<string, {
+    validRoles: MessageRole[];
+    requiresPrimary: boolean;
+}>;
+/**
+ * Weight multiplier for Human messages in signal scoring
+ */
+export declare const HUMAN_MESSAGE_WEIGHT_MULTIPLIER = 10;
+/**
+ * Check if a classification requires Human as primary source
+ */
+export declare function requiresHumanPrimary(classification: string): boolean;
+/**
+ * Check if a role is valid for a classification
+ */
+export declare function isValidRoleForClassification(classification: string, role: MessageRole): boolean;
+export interface Session {
+    id: string;
+    project: string;
+    startedAt: Date;
+    endedAt?: Date | undefined;
+    status: 'active' | 'completed' | 'abandoned';
+    metadata?: Record<string, unknown> | undefined;
+    transcriptPath?: string | undefined;
+    transcriptWatermark?: number | undefined;
+    messageWatermark?: number | undefined;
+}
+export interface Event {
+    id: string;
+    sessionId: string;
+    hookType: HookType;
+    timestamp: Date;
+    content: string;
+    toolName?: string | undefined;
+    toolInput?: string | undefined;
+    toolOutput?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+}
+export interface MemoryUnit {
+    id: string;
+    sessionId?: string | undefined;
+    store: MemoryStore;
+    classification: MemoryClassification;
+    summary: string;
+    sourceEventIds: string[];
+    projectScope?: string | undefined;
+    createdAt: Date;
+    updatedAt: Date;
+    lastAccessedAt: Date;
+    recency: number;
+    frequency: number;
+    importance: number;
+    utility: number;
+    novelty: number;
+    confidence: number;
+    interference: number;
+    strength: number;
+    decayRate: number;
+    tags: string[];
+    associations: string[];
+    status: MemoryStatus;
+    version: number;
+    evidence: MemoryEvidence[];
+    embedding?: Float32Array | undefined;
+}
+export interface MemoryEvidence {
+    eventId: string;
+    timestamp: Date;
+    contribution: string;
+    confidenceDelta: number;
+}
+export type HookType = 'SessionStart' | 'UserPromptSubmit' | 'PostToolUse' | 'Stop' | 'SessionEnd';
+export interface HookInput {
+    hookType: HookType;
+    sessionId: string;
+    timestamp: string;
+    data: HookData;
+}
+export type HookData = SessionStartData | UserPromptSubmitData | PostToolUseData | StopData | SessionEndData;
+export interface SessionStartData {
+    project: string;
+    workingDirectory: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UserPromptSubmitData {
+    prompt: string;
+    metadata?: Record<string, unknown>;
+}
+export interface PostToolUseData {
+    toolName: string;
+    toolInput: string;
+    toolOutput: string;
+    success: boolean;
+    duration?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface StopData {
+    reason: 'user' | 'complete' | 'error' | 'timeout' | 'compaction';
+    stopReason?: string;
+    conversationText?: string;
+    summary?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface SessionEndData {
+    reason: 'normal' | 'clear' | 'abandoned';
+    metadata?: Record<string, unknown>;
+}
+export interface HookOutput {
+    success: boolean;
+    context?: string;
+    error?: string;
+    memoriesCreated?: number;
+}
+export interface MemoryCandidate {
+    summary: string;
+    classification: MemoryClassification;
+    sourceEventIds: string[];
+    importanceSignals: ImportanceSignal[];
+    preliminaryImportance: number;
+    extractionMethod: string;
+    confidence: number;
+}
+export interface ImportanceSignal {
+    type: ImportanceSignalType;
+    source: string;
+    weight: number;
+}
+export type ImportanceSignalType = 'explicit_remember' | 'emphasis_cue' | 'correction' | 'repeated_request' | 'emotional_language' | 'tool_failure' | 'bug_fix' | 'decision' | 'constraint' | 'preference' | 'learning' | 'typography_emphasis' | 'correction_pattern' | 'repetition_pattern' | 'elaboration' | 'structural_enumeration' | 'meta_reference' | 'quoted_text' | 'code_block';
+export interface MemoryFeatureVector {
+    recency: number;
+    frequency: number;
+    importance: number;
+    utility: number;
+    novelty: number;
+    confidence: number;
+    interference: number;
+}
+export interface ScoringWeights {
+    recency: number;
+    frequency: number;
+    importance: number;
+    utility: number;
+    novelty: number;
+    confidence: number;
+    interference: number;
+}
+export interface RetrievalQuery {
+    query: string;
+    filters?: RetrievalFilters | undefined;
+    limit?: number | undefined;
+    includeDecayed?: boolean | undefined;
+}
+export interface RetrievalFilters {
+    store?: MemoryStore;
+    classifications?: MemoryClassification[];
+    minStrength?: number;
+    tags?: string[];
+    since?: Date;
+}
+export interface SweepConfig {
+    structuralWeight: number;
+    signalThreshold: number;
+    enableRegexPatterns: boolean;
+    enableStructuralAnalysis: boolean;
+    regexConfidence: number;
+    structuralConfidence: number;
+}
+export interface OpenCodeConfig {
+    injectOnCompaction: boolean;
+    extractOnCompaction: boolean;
+    extractOnMessage: boolean;
+    maxCompactionMemories: number;
+    maxSessionStartMemories: number;
+    messageWindowSize: number;
+    messageImportanceThreshold: number;
+}
+export interface PsychMemConfig {
+    agentType: AgentType;
+    dbPath: string;
+    stmDecayRate: number;
+    ltmDecayRate: number;
+    stmToLtmStrengthThreshold: number;
+    stmToLtmFrequencyThreshold: number;
+    scoringWeights: ScoringWeights;
+    defaultRetrievalLimit: number;
+    maxContextTokens: number;
+    autoPromoteToLtm: MemoryClassification[];
+    maxMemoriesPerStop: number;
+    deduplicationThreshold: number;
+    sweep: SweepConfig;
+    opencode: OpenCodeConfig;
+    applyDecayOnlyToEpisodic?: boolean;
+    decayThreshold?: number;
+}
+export type { Plugin, PluginInput, Hooks } from '@opencode-ai/plugin';
+export type { Message, Part } from '@opencode-ai/sdk';
+export type OpenCodeEvent = import('@opencode-ai/sdk').Event;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC;AAMnC;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,UAAU,GACV,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,oBAAoB,EAK5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B,EAAE,oBAAoB,EAK/D,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,oBAAoB,GAAG,OAAO,CAEvF;AAED,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,oBAAoB,GAAG,WAAW,CAE3F;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAMzE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC;IAEzB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,WAAW,EAAE,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAYzG,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAElD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAGpE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAG/F;AAMD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;IAC3B,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC/C,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,cAAc,EAAE,oBAAoB,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAElC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,IAAI,CAAC;IAErB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IAErB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAEhB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAMD,MAAM,MAAM,QAAQ,GAChB,cAAc,GACd,kBAAkB,GAClB,aAAa,GACb,MAAM,GACN,YAAY,CAAC;AAEjB,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,MAAM,QAAQ,GAChB,gBAAgB,GAChB,oBAAoB,GACpB,eAAe,GACf,QAAQ,GACR,cAAc,CAAC;AAEnB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,oBAAoB,CAAC;IACrC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAC5B,mBAAmB,GACnB,cAAc,GACd,YAAY,GACZ,kBAAkB,GAClB,oBAAoB,GACpB,cAAc,GACd,SAAS,GACT,UAAU,GACV,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,qBAAqB,GACrB,oBAAoB,GACpB,oBAAoB,GACpB,aAAa,GACb,wBAAwB,GACxB,gBAAgB,GAChB,aAAa,GACb,YAAY,CAAC;AAMjB,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,IAAI,CAAC;CACd;AAMD,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,wBAAwB,EAAE,OAAO,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0BAA0B,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IAEf,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IAErB,yBAAyB,EAAE,MAAM,CAAC;IAClC,0BAA0B,EAAE,MAAM,CAAC;IAEnC,cAAc,EAAE,cAAc,CAAC;IAE/B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IAEzB,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IAEzC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAE/B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IAGzB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAOD,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACtE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGtD,MAAM,MAAM,aAAa,GAAG,OAAO,kBAAkB,EAAE,KAAK,CAAC"}

package/dist/types.js

@@ -0,0 +1,63 @@
+/**
+ * True-Memory Type Definitions
+ * Adapted from PsychMem for OpenCode
+ */
+/**
+ * Classifications that are user-level (always injected)
+ */
+export const USER_LEVEL_CLASSIFICATIONS = [
+    'constraint',
+    'preference',
+    'learning',
+    'procedural',
+];
+/**
+ * Classifications that are project-level (only injected for matching project)
+ */
+export const PROJECT_LEVEL_CLASSIFICATIONS = [
+    'decision',
+    'bugfix',
+    'episodic',
+    'semantic',
+];
+export function isUserLevelClassification(classification) {
+    return USER_LEVEL_CLASSIFICATIONS.includes(classification);
+}
+export function getScopeForClassification(classification) {
+    return isUserLevelClassification(classification) ? 'user' : 'project';
+}
+/**
+ * Role validation rules for memory classifications
+ * Determines which roles are valid sources for each classification type
+ */
+export const ROLE_VALIDATION_RULES = {
+    // User-level classifications: MUST originate from Human messages
+    constraint: { validRoles: ['user'], requiresPrimary: true },
+    preference: { validRoles: ['user'], requiresPrimary: true },
+    learning: { validRoles: ['user'], requiresPrimary: true },
+    procedural: { validRoles: ['user'], requiresPrimary: true },
+    // Project-level classifications: Can be Assistant-acknowledged
+    decision: { validRoles: ['user', 'assistant'], requiresPrimary: false },
+    bugfix: { validRoles: ['user', 'assistant'], requiresPrimary: false },
+    semantic: { validRoles: ['user', 'assistant'], requiresPrimary: false },
+    episodic: { validRoles: ['user', 'assistant'], requiresPrimary: false },
+};
+/**
+ * Weight multiplier for Human messages in signal scoring
+ */
+export const HUMAN_MESSAGE_WEIGHT_MULTIPLIER = 10;
+/**
+ * Check if a classification requires Human as primary source
+ */
+export function requiresHumanPrimary(classification) {
+    const rule = ROLE_VALIDATION_RULES[classification];
+    return rule?.requiresPrimary ?? false;
+}
+/**
+ * Check if a role is valid for a classification
+ */
+export function isValidRoleForClassification(classification, role) {
+    const rule = ROLE_VALIDATION_RULES[classification];
+    return rule?.validRoles.includes(role) ?? true;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8BH;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAA2B;IAChE,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,YAAY;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAA2B;IACnE,UAAU;IACV,QAAQ;IACR,UAAU;IACV,UAAU;CACX,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,cAAoC;IAC5E,OAAO,0BAA0B,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,cAAoC;IAC5E,OAAO,yBAAyB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACxE,CAAC;AAuDD;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA4E;IAC5G,iEAAiE;IACjE,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE;IAC3D,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE;IAC3D,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE;IACzD,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE;IAE3D,+DAA+D;IAC/D,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE;IACvE,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE;IACrE,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE;IACvE,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE;CACxE,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,cAAsB;IACzD,MAAM,IAAI,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAC;IACnD,OAAO,IAAI,EAAE,eAAe,IAAI,KAAK,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,cAAsB,EAAE,IAAiB;IACpF,MAAM,IAAI,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAC;IACnD,OAAO,IAAI,EAAE,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACjD,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "true-mem",
+  "version": "1.0.0",
+  "description": "Persistent memory plugin for OpenCode with cognitive psychology-based memory management",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target bun --format esm && tsc --emitDeclarationOnly",
+    "dev": "bun build src/index.ts --outdir dist --target bun --format esm --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "opencode",
+    "ai",
+    "memory",
+    "plugin",
+    "persistent",
+    "cognitive",
+    "coding-assistant"
+  ],
+  "author": "rizal72",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rizal72/true-mem.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rizal72/true-mem/issues"
+  },
+  "homepage": "https://github.com/rizal72/true-mem#readme",
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.2.6",
+    "@opencode-ai/sdk": "^1.2.6",
+    "uuid": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.0",
+    "@types/uuid": "^10.0.0",
+    "bun-types": "^1.3.0",
+    "typescript": "^5.9.3"
+  }
+}