opencodekit 0.20.3 → 0.20.5

package/dist/template/.opencode/plugin/lib/db/observations.ts

@@ -28,10 +28,11 @@ export function storeObservation(input: ObservationInput): number {
 		.query(
 			`
     INSERT INTO observations (
-      type, title, subtitle, facts, narrative, concepts,
+      type, title, subtitle, facts, narrative, raw_source, concepts,
       files_read, files_modified, confidence, bead_id,
-      supersedes, markdown_file, source, created_at, created_at_epoch
-    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      supersedes, markdown_file, source, wing, hall, room,
+      created_at, created_at_epoch
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
   `,
 		)
 		.run(
@@ -40,6 +41,7 @@ export function storeObservation(input: ObservationInput): number {
 			input.subtitle ?? null,
 			input.facts ? JSON.stringify(input.facts) : null,
 			input.narrative ?? null,
+			input.raw_source ?? null,
 			input.concepts ? JSON.stringify(input.concepts) : null,
 			input.files_read ? JSON.stringify(input.files_read) : null,
 			input.files_modified ? JSON.stringify(input.files_modified) : null,
@@ -48,6 +50,9 @@ export function storeObservation(input: ObservationInput): number {
 			input.supersedes ?? null,
 			input.markdown_file ?? null,
 			input.source ?? "manual",
+			input.wing ?? null,
+			input.hall ?? null,
+			input.room ?? null,
 			now.toISOString(),
 			now.getTime(),
 		);

package/dist/template/.opencode/plugin/lib/db/schema.ts

@@ -28,10 +28,10 @@ function logRecovery(message: string): void {
 }
 
 // ============================================================================
-// Schema v2
+// Schema v3 (v2 + navigation, entity graph, raw source, chunk type)
 // ============================================================================
 
-const SCHEMA_VERSION = 2;
+const SCHEMA_VERSION = 3;
 
 const SCHEMA_SQL = `
 -- Schema versioning for migrations
@@ -41,7 +41,7 @@ CREATE TABLE IF NOT EXISTS schema_versions (
   applied_at TEXT NOT NULL
 );
 
--- Observations table (v2: added source column)
+-- Observations table (v3: added raw_source, wing, hall, room)
 CREATE TABLE IF NOT EXISTS observations (
   id INTEGER PRIMARY KEY AUTOINCREMENT,
   type TEXT NOT NULL CHECK(type IN ('decision','bugfix','feature','pattern','discovery','learning','warning')),
@@ -49,6 +49,7 @@ CREATE TABLE IF NOT EXISTS observations (
   subtitle TEXT,
   facts TEXT,
   narrative TEXT,
+  raw_source TEXT,
   concepts TEXT,
   files_read TEXT,
   files_modified TEXT,
@@ -59,6 +60,9 @@ CREATE TABLE IF NOT EXISTS observations (
   valid_until TEXT,
   markdown_file TEXT,
   source TEXT CHECK(source IN ('manual','curator','imported')) DEFAULT 'manual',
+  wing TEXT,
+  hall TEXT CHECK(hall IS NULL OR hall IN ('facts','events','discoveries','preferences','advice')),
+  room TEXT,
   created_at TEXT NOT NULL,
   created_at_epoch INTEGER NOT NULL,
   updated_at TEXT,
@@ -84,6 +88,10 @@ CREATE INDEX IF NOT EXISTS idx_observations_created ON observations(created_at_e
 CREATE INDEX IF NOT EXISTS idx_observations_bead_id ON observations(bead_id);
 CREATE INDEX IF NOT EXISTS idx_observations_superseded ON observations(superseded_by) WHERE superseded_by IS NOT NULL;
 CREATE INDEX IF NOT EXISTS idx_observations_source ON observations(source);
+CREATE INDEX IF NOT EXISTS idx_observations_wing ON observations(wing) WHERE wing IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_observations_hall ON observations(hall) WHERE hall IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_observations_room ON observations(room) WHERE room IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_observations_navigation ON observations(wing, hall, room) WHERE wing IS NOT NULL;
 
 -- Memory files table
 CREATE TABLE IF NOT EXISTS memory_files (
@@ -102,7 +110,7 @@ CREATE INDEX IF NOT EXISTS idx_memory_files_path ON memory_files(file_path);
 
 
 
--- Temporal messages table (v2: raw message capture)
+-- Temporal messages table (v3: added chunk_type)
 CREATE TABLE IF NOT EXISTS temporal_messages (
   id INTEGER PRIMARY KEY AUTOINCREMENT,
   session_id TEXT NOT NULL,
@@ -112,6 +120,7 @@ CREATE TABLE IF NOT EXISTS temporal_messages (
   token_estimate INTEGER NOT NULL DEFAULT 0,
   time_created INTEGER NOT NULL,
   distillation_id INTEGER,
+  chunk_type TEXT,
   created_at TEXT NOT NULL DEFAULT (datetime('now')),
   FOREIGN KEY(distillation_id) REFERENCES distillations(id) ON DELETE SET NULL
 );
@@ -139,6 +148,27 @@ CREATE TABLE IF NOT EXISTS distillations (
 CREATE INDEX IF NOT EXISTS idx_distillations_session ON distillations(session_id, time_created DESC);
 CREATE INDEX IF NOT EXISTS idx_distillations_time ON distillations(time_created DESC);
 
+-- Entity triples table (v3: temporal knowledge graph)
+CREATE TABLE IF NOT EXISTS entity_triples (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  subject TEXT NOT NULL,
+  predicate TEXT NOT NULL,
+  object TEXT NOT NULL,
+  valid_from TEXT NOT NULL,
+  valid_to TEXT,
+  confidence REAL NOT NULL DEFAULT 1.0,
+  source_observation_id INTEGER,
+  created_at TEXT NOT NULL,
+  created_at_epoch INTEGER NOT NULL,
+  FOREIGN KEY(source_observation_id) REFERENCES observations(id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_entity_subject ON entity_triples(subject);
+CREATE INDEX IF NOT EXISTS idx_entity_object ON entity_triples(object);
+CREATE INDEX IF NOT EXISTS idx_entity_predicate ON entity_triples(predicate);
+CREATE INDEX IF NOT EXISTS idx_entity_valid ON entity_triples(valid_from, valid_to);
+CREATE INDEX IF NOT EXISTS idx_entity_active ON entity_triples(subject, valid_to) WHERE valid_to IS NULL;
+
 -- FTS5 for distillations (v2)
 CREATE VIRTUAL TABLE IF NOT EXISTS distillations_fts USING fts5(
   content,
@@ -243,6 +273,47 @@ CREATE INDEX IF NOT EXISTS idx_temporal_undistilled ON temporal_messages(session
 CREATE INDEX IF NOT EXISTS idx_temporal_time ON temporal_messages(time_created DESC);
 `;
 
+// Migration from v2 to v3
+const MIGRATION_V2_TO_V3 = `
+-- Add raw_source column to observations
+ALTER TABLE observations ADD COLUMN raw_source TEXT;
+
+-- Add navigation columns to observations
+ALTER TABLE observations ADD COLUMN wing TEXT;
+ALTER TABLE observations ADD COLUMN hall TEXT CHECK(hall IS NULL OR hall IN ('facts','events','discoveries','preferences','advice'));
+ALTER TABLE observations ADD COLUMN room TEXT;
+
+-- Navigation indexes
+CREATE INDEX IF NOT EXISTS idx_observations_wing ON observations(wing) WHERE wing IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_observations_hall ON observations(hall) WHERE hall IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_observations_room ON observations(room) WHERE room IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_observations_navigation ON observations(wing, hall, room) WHERE wing IS NOT NULL;
+
+-- Add chunk_type to temporal_messages
+ALTER TABLE temporal_messages ADD COLUMN chunk_type TEXT;
+
+-- Entity triples table (temporal knowledge graph)
+CREATE TABLE IF NOT EXISTS entity_triples (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  subject TEXT NOT NULL,
+  predicate TEXT NOT NULL,
+  object TEXT NOT NULL,
+  valid_from TEXT NOT NULL,
+  valid_to TEXT,
+  confidence REAL NOT NULL DEFAULT 1.0,
+  source_observation_id INTEGER,
+  created_at TEXT NOT NULL,
+  created_at_epoch INTEGER NOT NULL,
+  FOREIGN KEY(source_observation_id) REFERENCES observations(id) ON DELETE SET NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_entity_subject ON entity_triples(subject);
+CREATE INDEX IF NOT EXISTS idx_entity_object ON entity_triples(object);
+CREATE INDEX IF NOT EXISTS idx_entity_predicate ON entity_triples(predicate);
+CREATE INDEX IF NOT EXISTS idx_entity_valid ON entity_triples(valid_from, valid_to);
+CREATE INDEX IF NOT EXISTS idx_entity_active ON entity_triples(subject, valid_to) WHERE valid_to IS NULL;
+`;
+
 // ============================================================================
 // Database Manager
 // ============================================================================
@@ -429,7 +500,7 @@ function initializeSchema(db: Database): void {
 	}
 
 	if (currentVersion === 0) {
-		// Fresh install — run full v2 schema
+		// Fresh install — run full v3 schema
 		db.exec(SCHEMA_SQL);
 
 		// Run FTS triggers
@@ -443,6 +514,9 @@ function initializeSchema(db: Database): void {
 		if (currentVersion < 2) {
 			migrateV1ToV2(db);
 		}
+		if (currentVersion < 3) {
+			migrateV2ToV3(db);
+		}
 	}
 
 	// Record schema version
@@ -501,3 +575,20 @@ function migrateV1ToV2(db: Database): void {
 		// Triggers may already exist
 	}
 }
+
+/**
+ * Migrate from schema v2 to v3.
+ * Adds: raw_source, wing/hall/room navigation, chunk_type, entity_triples table.
+ */
+function migrateV2ToV3(db: Database): void {
+	for (const stmt of MIGRATION_V2_TO_V3.split(";")) {
+		const trimmed = stmt.trim();
+		if (trimmed) {
+			try {
+				db.run(trimmed);
+			} catch {
+				// Statement may fail if already applied (e.g. column exists)
+			}
+		}
+	}
+}

package/dist/template/.opencode/plugin/lib/db/types.ts

@@ -46,6 +46,69 @@ export const MEMORY_CONFIG = {
 	},
 } as const;
 
+// ============================================================================
+// Navigation Types (v3: structured navigation)
+// ============================================================================
+
+export type HallType = "facts" | "events" | "discoveries" | "preferences" | "advice";
+
+export const VALID_HALLS: HallType[] = ["facts", "events", "discoveries", "preferences", "advice"];
+
+// ============================================================================
+// Entity Graph Types (v3: temporal knowledge graph)
+// ============================================================================
+
+export interface EntityTripleInput {
+	subject: string;
+	predicate: string;
+	object: string;
+	valid_from?: string; // ISO date or epoch
+	valid_to?: string | null;
+	confidence?: number; // 0.0–1.0
+	source_observation_id?: number;
+}
+
+export interface EntityTripleRow {
+	id: number;
+	subject: string;
+	predicate: string;
+	object: string;
+	valid_from: string;
+	valid_to: string | null;
+	confidence: number;
+	source_observation_id: number | null;
+	created_at: string;
+	created_at_epoch: number;
+}
+
+export interface EntityQueryResult {
+	id: number;
+	subject: string;
+	predicate: string;
+	object: string;
+	valid_from: string;
+	valid_to: string | null;
+	confidence: number;
+	is_active: boolean;
+}
+
+// ============================================================================
+// Compact Format Types (v3: AAAK-inspired compression)
+// ============================================================================
+
+export interface CompactEntry {
+	code: string; // 3-letter entity code
+	full: string; // Full name
+	role?: string; // Role or type
+}
+
+export interface CompactResult {
+	compressed: string;
+	token_estimate: number;
+	original_tokens: number;
+	compression_ratio: number;
+}
+
 // ============================================================================
 // Observation Types
 // ============================================================================
@@ -68,6 +131,7 @@ export interface ObservationRow {
 	subtitle: string | null;
 	facts: string | null; // JSON array
 	narrative: string | null;
+	raw_source: string | null; // v3: verbatim source text
 	concepts: string | null; // JSON array
 	files_read: string | null; // JSON array
 	files_modified: string | null; // JSON array
@@ -78,6 +142,9 @@ export interface ObservationRow {
 	valid_until: string | null;
 	markdown_file: string | null;
 	source: ObservationSource;
+	wing: string | null; // v3: navigation wing (project/person)
+	hall: HallType | null; // v3: navigation hall (facts/events/...)
+	room: string | null; // v3: navigation room (topic)
 	created_at: string;
 	created_at_epoch: number;
 	updated_at: string | null;
@@ -89,6 +156,7 @@ export interface ObservationInput {
 	subtitle?: string;
 	facts?: string[];
 	narrative?: string;
+	raw_source?: string; // v3: verbatim source text
 	concepts?: string[];
 	files_read?: string[];
 	files_modified?: string[];
@@ -97,6 +165,9 @@ export interface ObservationInput {
 	supersedes?: number;
 	markdown_file?: string;
 	source?: ObservationSource;
+	wing?: string; // v3: navigation wing
+	hall?: HallType; // v3: navigation hall
+	room?: string; // v3: navigation room
 }
 
 export interface SearchIndexResult {
@@ -136,6 +207,7 @@ export interface TemporalMessageRow {
 	token_estimate: number;
 	time_created: number;
 	distillation_id: number | null;
+	chunk_type: string | null; // v3: exchange-pair | paragraph | sliding-window
 	created_at: string;
 }
 
@@ -146,6 +218,7 @@ export interface TemporalMessageInput {
 	content: string;
 	token_estimate: number;
 	time_created: number;
+	chunk_type?: string; // v3: exchange-pair | paragraph | sliding-window
 }
 
 // ============================================================================

package/dist/template/.opencode/plugin/lib/memory-admin-tools.ts

@@ -1,7 +1,7 @@
 /**
  * Memory Plugin — Admin Tools
  *
- * memory-admin (9 operations).
+ * memory-admin (12 operations).
  *
  * Uses factory pattern: createAdminTools(deps) returns tool definitions.
  */
@@ -20,10 +20,13 @@ import {
 	type ConfidenceLevel,
 	checkFTS5Available,
 	checkpointWAL,
+	findGraphContradictions,
 	getCaptureStats,
 	getDatabaseSizes,
 	getDistillationStats,
+	getEntityGraphStats,
 	getMarkdownFilesInSqlite,
+	getMemoryDB,
 	getObservationStats,
 	type ObservationType,
 	rebuildFTS5,
@@ -73,11 +76,12 @@ export function createAdminTools(deps: AdminToolDeps) {
 							});
 							const captureStats = getCaptureStats();
 							const distillStats = getDistillationStats();
+							const graphStats = getEntityGraphStats();
 							return [
 								"## Memory System Status\n",
 								`**Database**: ${(sizes.total / 1024).toFixed(1)} KB`,
 								`**FTS5**: ${checkFTS5Available() ? "Available (porter stemming)" : "Unavailable"}`,
-								`**Schema**: v2 (4-tier storage)\n`,
+								`**Schema**: v3 (4-tier + entity graph)\n`,
 								"### Observations",
 								...Object.entries(stats).map(([k, v]) => `  ${k}: ${v}`),
 								`  Archivable (>${olderThanDays}d): ${archivable}\n`,
@@ -86,7 +90,11 @@ export function createAdminTools(deps: AdminToolDeps) {
 								`  Sessions: ${captureStats.sessions}\n`,
 								"### Distillations",
 								`  Total: ${distillStats.total} (${distillStats.sessions} sessions)`,
-								`  Avg compression: ${(distillStats.avgCompression * 100).toFixed(1)}%`,
+								`  Avg compression: ${(distillStats.avgCompression * 100).toFixed(1)}%\n`,
+								"### Entity Graph",
+								`  Triples: ${graphStats.total_triples} (active: ${graphStats.active_triples})`,
+								`  Entities: ${graphStats.unique_entities}`,
+								`  Predicates: ${graphStats.unique_predicates}`,
 							].join("\n");
 						}
 						case "full": {
@@ -132,6 +140,31 @@ export function createAdminTools(deps: AdminToolDeps) {
 						}
 						case "lint": {
 							const result = lintMemory({ staleDays: olderThanDays });
+
+							// Entity graph contradiction scan
+							const graphStats = getEntityGraphStats();
+							if (graphStats.total_triples > 0) {
+								try {
+									// Check each active triple for contradictions
+									const db = getMemoryDB();
+									const activeTriples = db.query(
+										"SELECT DISTINCT subject, predicate, object FROM entity_triples WHERE valid_to IS NULL LIMIT 200"
+									).all() as { subject: string; predicate: string; object: string }[];
+									for (const t of activeTriples) {
+										const contradictions = findGraphContradictions(t.subject, t.predicate, t.object);
+										if (contradictions.length > 0) {
+											result.issues.push({
+												severity: "medium" as const,
+												title: `Graph contradiction: ${t.subject} ↔ ${t.object}`,
+												detail: `Active triple "${t.subject} —[${t.predicate}]→ ${t.object}" has ${contradictions.length} conflicting predicate(s): ${contradictions.map(c => c.predicate).join(", ")}`,
+												suggestion: `Use memory-graph-invalidate to close outdated triples`,
+												type: "contradiction" as const,
+												observation_ids: contradictions.map(c => c.source_observation_id).filter((id): id is number => id != null),
+											});
+										}
+									}
+								} catch { /* Graph table may not exist yet */ }
+							}
 							if (result.issues.length === 0) {
 								return `Memory lint: clean (${result.stats.total_observations} observations, 0 issues).`;
 							}

package/dist/template/.opencode/plugin/lib/memory-db.ts

@@ -1,5 +1,5 @@
 /**
- * Memory Database Module v2 — Barrel Export
+ * Memory Database Module v3 — Barrel Export
  *
  * Re-exports all functions and types from sub-modules in ./db/.
  * This preserves backward compatibility for existing imports from "./lib/memory-db.js".
@@ -10,6 +10,7 @@
  *   db/observations.ts — Observation CRUD, search, timeline, stats
  *   db/pipeline.ts     — Temporal messages, distillations, relevance scoring
  *   db/maintenance.ts  — Memory files, FTS5, DB maintenance
+ *   db/graph.ts        — Entity graph: temporal triples, queries, stats
  */
 
 // Memory Files, FTS5, and Maintenance
@@ -52,6 +53,16 @@ export {
 	storeDistillation,
 	storeTemporalMessage,
 } from "./db/pipeline.js";
+// Entity Graph Operations (v3)
+export {
+	addEntityTriple,
+	findContradictions as findGraphContradictions,
+	getEntityGraphStats,
+	getEntityTimeline,
+	getTripleById,
+	invalidateTriple,
+	queryEntity,
+} from "./db/graph.js";
 // Database Manager
 export { closeMemoryDB, getMemoryDB } from "./db/schema.js";
 // Types & Configuration

package/dist/template/.opencode/plugin/lib/memory-tools.ts

@@ -1,7 +1,8 @@
 /**
  * Memory Plugin — Core Tools
  *
- * observation, memory-search, memory-get, memory-read, memory-update, memory-timeline
+ * observation, memory-search, memory-get, memory-read, memory-update, memory-timeline,
+ * memory-graph-add, memory-graph-query, memory-graph-invalidate, memory-compact
  *
  * Uses factory pattern: createCoreTools(deps) returns tool definitions
  * that can be spread into plugin's tool:{} export.
@@ -11,17 +12,23 @@ import { readdir } from "node:fs/promises";
 import path from "node:path";
 import { tool } from "@opencode-ai/plugin/tool";
 import {
+	addEntityTriple,
 	type ConfidenceLevel,
 	checkFTS5Available,
+	getMemoryDB,
 	getMemoryFile,
 	getObservationsByIds,
 	getTimelineAroundObservation,
+	invalidateTriple,
 	type ObservationSource,
 	type ObservationType,
+	queryEntity,
 	searchDistillationsFTS,
 	searchObservationsFTS,
 	storeObservation,
 	upsertMemoryFile,
+	type HallType,
+	VALID_HALLS,
 } from "./memory-db.js";
 import {
 	autoDetectFiles,
@@ -32,6 +39,7 @@ import {
 	VALID_TYPES,
 } from "./memory-helpers.js";
 import { validateObservation } from "./validate.js";
+import { compactObservations } from "./compact.js";
 
 /**
  * Wrap a memory tool execute function with DB error handling.
@@ -118,6 +126,22 @@ export function createCoreTools(deps: CoreToolDeps) {
 					.string()
 					.optional()
 					.describe("manual, curator, imported"),
+				wing: tool.schema
+					.string()
+					.optional()
+					.describe("Navigation wing (project or person name)"),
+				hall: tool.schema
+					.string()
+					.optional()
+					.describe("Navigation hall: facts, events, discoveries, preferences, advice"),
+				room: tool.schema
+					.string()
+					.optional()
+					.describe("Navigation room (topic name, e.g. auth-migration)"),
+				raw_source: tool.schema
+					.string()
+					.optional()
+					.describe("Verbatim source text to preserve losslessly alongside narrative"),
 			},
 			execute: withDBErrorHandling(async (args) => {
 				const obsType = args.type as ObservationType;
@@ -157,6 +181,10 @@ export function createCoreTools(deps: CoreToolDeps) {
 				}
 
 				const source = (args.source ?? "manual") as ObservationSource;
+				const hall = args.hall as HallType | undefined;
+				if (hall && !VALID_HALLS.includes(hall)) {
+					return `Error: Invalid hall "${args.hall}". Valid: ${VALID_HALLS.join(", ")}`;
+				}
 
 				// Validation gate: check for duplicates, contradictions, low quality
 				const validation = validateObservation({
@@ -172,6 +200,9 @@ export function createCoreTools(deps: CoreToolDeps) {
 					bead_id: args.bead_id,
 					supersedes,
 					source,
+					wing: args.wing,
+					hall,
+					room: args.room,
 				});
 
 				if (validation.verdict === "reject") {
@@ -188,6 +219,7 @@ export function createCoreTools(deps: CoreToolDeps) {
 					subtitle: args.subtitle,
 					facts,
 					narrative,
+					raw_source: args.raw_source,
 					concepts,
 					files_read: filesRead,
 					files_modified: filesModified,
@@ -195,6 +227,9 @@ export function createCoreTools(deps: CoreToolDeps) {
 					bead_id: args.bead_id,
 					supersedes,
 					source,
+					wing: args.wing,
+					hall,
+					room: args.room,
 				});
 
 				const warnings = validation.issues.length > 0
@@ -395,5 +430,106 @@ export function createCoreTools(deps: CoreToolDeps) {
 				return lines.join("\n");
 			}),
 		}),
+
+		"memory-graph-add": tool({
+			description: `Add a triple to the entity knowledge graph.\n\nStores a subject-predicate-object relationship with optional temporal bounds and confidence.\nUse for structured facts like "project uses typescript" or "user prefers dark-mode".\n\nExample:\nmemory-graph-add({ subject: "project", predicate: "uses", object: "typescript" })\nmemory-graph-add({ subject: "auth", predicate: "depends-on", object: "jwt", confidence: 0.9, source_observation_id: 42 })`,
+			args: {
+				subject: tool.schema.string().describe("Entity subject"),
+				predicate: tool.schema.string().describe("Relationship type (e.g. uses, depends-on, prefers)"),
+				object: tool.schema.string().describe("Entity object"),
+				valid_from: tool.schema.string().optional().describe("Start date (ISO, default: today)"),
+				valid_to: tool.schema.string().optional().describe("End date (ISO, null = still active)"),
+				confidence: tool.schema.number().optional().describe("Confidence 0.0-1.0 (default: 1.0)"),
+				source_observation_id: tool.schema.number().optional().describe("Link to source observation"),
+			},
+			execute: withDBErrorHandling(async (args) => {
+				if (!args.subject?.trim() || !args.predicate?.trim() || !args.object?.trim()) {
+					return "Error: subject, predicate, and object are required.";
+				}
+				const id = addEntityTriple({
+					subject: args.subject,
+					predicate: args.predicate,
+					object: args.object,
+					valid_from: args.valid_from,
+					valid_to: args.valid_to,
+					confidence: args.confidence,
+					source_observation_id: args.source_observation_id,
+				});
+				return `Triple #${id} added: ${args.subject} —[${args.predicate}]→ ${args.object}`;
+			}),
+		}),
+
+		"memory-graph-query": tool({
+			description: `Query the entity knowledge graph.\n\nFind relationships for an entity with optional time and direction filters.\nReturns triples where the entity appears as subject, object, or both.\n\nExample:\nmemory-graph-query({ entity: "typescript" })\nmemory-graph-query({ entity: "auth", direction: "out", active_only: true })\nmemory-graph-query({ entity: "project", as_of: "2025-06-01" })`,
+			args: {
+				entity: tool.schema.string().describe("Entity to query"),
+				direction: tool.schema.string().optional().describe("out (subject), in (object), both (default)"),
+				predicate: tool.schema.string().optional().describe("Filter by predicate"),
+				as_of: tool.schema.string().optional().describe("ISO date for point-in-time query"),
+				active_only: tool.schema.boolean().optional().describe("Only active triples (default: false)"),
+				limit: tool.schema.number().optional().describe("Max results (default: 50)"),
+			},
+			execute: withDBErrorHandling(async (args) => {
+				if (!args.entity?.trim()) return "Error: entity is required.";
+				const results = queryEntity(args.entity, {
+					direction: args.direction as "out" | "in" | "both" | undefined,
+					predicate: args.predicate,
+					as_of: args.as_of,
+					activeOnly: args.active_only,
+					limit: args.limit,
+				});
+				if (results.length === 0) return `No triples found for entity "${args.entity}".`;
+				const lines: string[] = [
+					`## Entity Graph: ${args.entity} (${results.length} triples)\n`,
+					"| ID | Subject | Predicate | Object | Active | Confidence |",
+					"|---|---|---|---|---|---|",
+				];
+				for (const r of results) {
+					lines.push(`| ${r.id} | ${r.subject} | ${r.predicate} | ${r.object} | ${r.is_active ? "\u2705" : "\u274C"} | ${(r.confidence * 100).toFixed(0)}% |`);
+				}
+				return lines.join("\n");
+			}),
+		}),
+
+		"memory-graph-invalidate": tool({
+			description: `Invalidate (close) entity triples in the knowledge graph.\n\nMarks active triples matching subject+predicate+object as no longer valid by setting valid_to.\nUse when a fact is no longer true (e.g. project stopped using a library).\n\nExample:\nmemory-graph-invalidate({ subject: "project", predicate: "uses", object: "moment.js" })`,
+			args: {
+				subject: tool.schema.string().describe("Entity subject"),
+				predicate: tool.schema.string().describe("Relationship type"),
+				object: tool.schema.string().describe("Entity object"),
+				end_date: tool.schema.string().optional().describe("End date (ISO, default: today)"),
+			},
+			execute: withDBErrorHandling(async (args) => {
+				if (!args.subject?.trim() || !args.predicate?.trim() || !args.object?.trim()) {
+					return "Error: subject, predicate, and object are required.";
+				}
+				const count = invalidateTriple(args.subject, args.predicate, args.object, args.end_date);
+				return count > 0
+					? `Invalidated ${count} triple(s): ${args.subject} —[${args.predicate}]→ ${args.object}`
+					: `No active triples found matching ${args.subject} —[${args.predicate}]→ ${args.object}.`;
+			}),
+		}),
+
+		"memory-compact": tool({
+			description: `Compact observations into a dense, token-efficient format.\n\nUses AAAK-inspired pipe-separated compression achieving ~3-5x token reduction.\nUseful for injecting memory into prompts with minimal token cost.\n\nExample:\nmemory-compact({})\nmemory-compact({ limit: 20 })`,
+			args: {
+				limit: tool.schema.number().optional().describe("Max observations to compact (default: all)"),
+			},
+			execute: withDBErrorHandling(async (args) => {
+				const db = getMemoryDB();
+				const limitClause = args.limit ? `LIMIT ${Number(args.limit)}` : "";
+				const observations = db.query(
+					`SELECT id, type, title, narrative, concepts, wing, hall, room, confidence, created_at
+					 FROM observations
+					 WHERE superseded_by IS NULL
+					 ORDER BY created_at_epoch DESC ${limitClause}`
+				).all() as { id: number; type: string; title: string; narrative?: string | null; concepts?: string | null; wing?: string | null; hall?: string | null; room?: string | null; confidence?: string | null; created_at?: string | null }[];
+				if (observations.length === 0) return "No observations to compact.";
+				const result = compactObservations(observations);
+				if (!result.compressed) return "No observations to compact.";
+				const ratio = result.compression_ratio > 0 ? ` (${(result.compression_ratio * 100).toFixed(0)}% of original)` : "";
+				return `## Compact Memory (${observations.length} observations, ~${result.token_estimate} tokens${ratio})\n\n${result.compressed}`;
+			}),
+		}),
 	};
 }

package/dist/template/.opencode/plugin/memory.ts

@@ -11,7 +11,8 @@
  * 5. Context Management — messages.transform → token budget enforcement
  *
  * Tools: observation, memory-search, memory-get, memory-read,
- *        memory-update, memory-timeline, memory-admin
+ *        memory-update, memory-timeline, memory-graph-add, memory-graph-query,
+ *        memory-graph-invalidate, memory-compact, memory-admin
  *
  * Module structure:
  *   memory.ts              — Plugin entry (this file)