opencodekit 0.21.10 → 0.23.0

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

@@ -0,0 +1,62 @@
+/**
+ * Guard Plugin — Agent Safety & Convention Enforcement
+ *
+ * Ported from pikit's extensions/guard.ts.
+ *
+ * 1. Pipe-to-shell blocker: rejects `curl … | bash` / `wget … | bash` patterns.
+ * 2. Conventional Commits: rejects `git commit` with non-compliant messages.
+ */
+
+import type { Plugin } from "@opencode-ai/plugin";
+
+const CONVENTIONAL_RE =
+	/^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\([a-z0-9._/-]+\))?!?: .+/;
+
+export const GuardPlugin: Plugin = async () => {
+	return {
+		"tool.execute.before": async (input, output) => {
+			if (input.tool !== "bash") return;
+
+			const cmd: string = (output.args as Record<string, unknown>)?.command ?? "";
+
+			// --- curl/wget | bash blocker ---
+			// Only match when curl/wget starts a command segment to avoid false positives
+			// on quoted text (e.g. commit messages) mentioning the pattern.
+			if (/(?:^|[;&|])\s*(?:curl|wget)\s.*\|\s*(?:ba)?sh/i.test(cmd)) {
+				throw new Error(
+					"Blocked: detected pipe-to-shell pattern (curl/wget | bash). Download first, inspect, then run.",
+				);
+			}
+
+			// --- conventional commit enforcer ---
+			const commitMatch = cmd.match(/git\s+commit\s/);
+			if (!commitMatch) return;
+
+			const msgMatch =
+				cmd.match(/(?:-m|--message=?)\s*"([^"]*)"/) ??
+				cmd.match(/(?:-m|--message=?)\s*'([^']*)'/) ??
+				cmd.match(/(?:-m|--message=?)\s+(\S+)/);
+
+			const msg = msgMatch?.[1];
+
+			if (!msg) {
+				throw new Error(
+					'Blocked: git commit missing -m message. Use: git commit -m "type(scope): subject"',
+				);
+			}
+
+			if (!CONVENTIONAL_RE.test(msg)) {
+				throw new Error(
+					[
+						"Blocked: commit message is not Conventional Commits compliant.",
+						`Got: ${msg}`,
+						"Expected: <type>(scope): <subject>",
+						"Types: feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert",
+					].join("\n"),
+				);
+			}
+		},
+	};
+};
+
+export default GuardPlugin;

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

@@ -33,7 +33,7 @@ import {
 	runFullMaintenance,
 	storeObservation,
 	vacuumDatabase,
-} from "./memory-db.js";
+} from "./db.js";
 
 interface AdminToolDeps {
 	directory: string;
@@ -157,7 +157,7 @@ export function createAdminTools(deps: AdminToolDeps) {
 												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`,
+												suggestion: `Use observation to update or supersede outdated observations`,
 												type: "contradiction" as const,
 												observation_ids: contradictions.map(c => c.source_observation_id).filter((id): id is number => id != null),
 											});
@@ -187,7 +187,7 @@ export function createAdminTools(deps: AdminToolDeps) {
 						}
 						case "index": {
 							const result = generateMemoryIndex();
-							return `Index generated: ${result.entryCount} observations, ${result.conceptCount} concepts. Read with \`memory-read({ file: "index" })\`.`;
+							return `Index generated: ${result.entryCount} observations, ${result.conceptCount} concepts. Read with \`memory-search({ file: "index" })\`.`;
 						}
 						case "compile": {
 							const result = compileObservations();
@@ -195,7 +195,7 @@ export function createAdminTools(deps: AdminToolDeps) {
 								return `No concept clusters with 3+ observations found. Nothing to compile.`;
 							}
 							const articleList = result.articles.map(a => `  - ${a.concept} (${a.observationCount} obs)`).join("\n");
-							return `Compiled ${result.articles.length} articles from ${result.totalObservations} observations (${result.skippedClusters} skipped).\n\nArticles:\n${articleList}\n\nRead with \`memory-read({ file: "compiled/<concept>" })\`.`;
+							return `Compiled ${result.articles.length} articles from ${result.totalObservations} observations (${result.skippedClusters} skipped).\n\nArticles:\n${articleList}\n\nRead with \`memory-search({ file: "compiled/<concept>" })\`.`;
 						}
 						case "log": {
 							return getLogContent();

package/dist/template/.opencode/plugin/{lib → memory}/capture.ts

@@ -18,7 +18,7 @@ import {
 	getMemoryDB,
 	MEMORY_CONFIG,
 	type TemporalMessageInput,
-} from "./memory-db.js";
+} from "./db.js";
 
 // ============================================================================
 // Types

package/dist/template/.opencode/plugin/{lib → memory}/compile.ts

@@ -17,8 +17,8 @@
 
 import { upsertMemoryFile } from "./db/maintenance.js";
 import type { ObservationRow } from "./db/types.js";
-import { getMemoryDB } from "./memory-db.js";
-import { TYPE_ICONS, parseConcepts } from "./memory-helpers.js";
+import { getMemoryDB } from "./db.js";
+import { TYPE_ICONS, parseConcepts } from "./helpers.js";
 import { appendOperationLog } from "./operation-log.js";
 
 // ============================================================================

package/dist/template/.opencode/plugin/{lib → memory}/context.ts

@@ -7,7 +7,7 @@
  * Protects the most recent N messages from compression.
  */
 
-import { estimateTokens, MEMORY_CONFIG } from "./memory-db.js";
+import { estimateTokens, MEMORY_CONFIG } from "./db.js";
 
 // ============================================================================
 // Types

package/dist/template/.opencode/plugin/{lib → memory}/curator.ts

@@ -15,7 +15,7 @@ import {
 	type ObservationInput,
 	type ObservationType,
 	storeObservation,
-} from "./memory-db.js";
+} from "./db.js";
 
 // ============================================================================
 // Pattern Definitions

package/dist/template/.opencode/plugin/{lib → memory}/db/observations.ts

@@ -7,6 +7,7 @@
 
 import { getMemoryDB } from "./schema.js";
 import type {
+	FeedbackEvent,
 	ObservationInput,
 	ObservationRow,
 	ObservationType,
@@ -19,8 +20,7 @@ import type {
 
 /**
  * Store a new observation in the database.
- */
-export function storeObservation(input: ObservationInput): number {
+ */	export function storeObservation(input: ObservationInput): number {
 	const db = getMemoryDB();
 	const now = new Date();
 
@@ -31,8 +31,10 @@ export function storeObservation(input: ObservationInput): number {
       type, title, subtitle, facts, narrative, raw_source, concepts,
       files_read, files_modified, confidence, bead_id,
       supersedes, markdown_file, source, wing, hall, room,
+      helpful_count, harmful_count, feedback_events, effective_score,
+      maturity, retrieval_count, last_retrieved,
       created_at, created_at_epoch
-    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
   `,
 		)
 		.run(
@@ -53,6 +55,13 @@ export function storeObservation(input: ObservationInput): number {
 			input.wing ?? null,
 			input.hall ?? null,
 			input.room ?? null,
+			0, // helpful_count
+			0, // harmful_count
+			null, // feedback_events
+			0.0, // effective_score
+			"candidate", // maturity
+			0, // retrieval_count
+			null, // last_retrieved
 			now.toISOString(),
 			now.getTime(),
 		);
@@ -302,3 +311,93 @@ export function getObservationStats(): Record<string, number> {
 	}
 	return stats;
 }
+
+// ============================================================================
+// Feedback & Tracking (aligned with pikit memory extension)
+// ============================================================================
+
+/**
+ * Record feedback (helpful/harmful) on an observation.
+ */
+export function recordFeedback(
+	observationId: number,
+	feedbackType: "helpful" | "harmful",
+	reason?: string,
+	sessionId?: string,
+): {
+	success: boolean;
+	helpfulCount: number;
+	harmfulCount: number;
+	error?: string;
+} {
+	const db = getMemoryDB();
+
+	const row = db
+		.query("SELECT * FROM observations WHERE id = ?")
+		.get(observationId) as ObservationRow | undefined;
+
+	if (!row) {
+		return {
+			success: false,
+			helpfulCount: 0,
+			harmfulCount: 0,
+			error: `Observation #${observationId} not found`,
+		};
+	}
+
+	// Parse existing feedback events
+	let events: FeedbackEvent[] = [];
+	try {
+		events = row.feedback_events ? JSON.parse(row.feedback_events) : [];
+	} catch {
+		events = [];
+	}
+
+	// Append new event
+	const newEvent: FeedbackEvent = {
+		type: feedbackType,
+		timestamp: Date.now(),
+		reason,
+		session_id: sessionId,
+	};
+	events.push(newEvent);
+
+	const helpfulCount =
+		feedbackType === "helpful" ? row.helpful_count + 1 : row.helpful_count;
+	const harmfulCount =
+		feedbackType === "harmful" ? row.harmful_count + 1 : row.harmful_count;
+
+	// Persist
+	db.run(
+		`UPDATE observations SET
+			helpful_count = ?,
+			harmful_count = ?,
+			feedback_events = ?,
+			updated_at = ?
+		WHERE id = ?`,
+		[
+			helpfulCount,
+			harmfulCount,
+			JSON.stringify(events),
+			new Date().toISOString(),
+			observationId,
+		],
+	);
+
+	return { success: true, helpfulCount, harmfulCount };
+}
+
+/**
+ * Increment retrieval_count and update last_retrieved for given observation IDs.
+ */
+export function markObservationsRetrieved(ids: number[]): void {
+	if (ids.length === 0) return;
+	const db = getMemoryDB();
+	const now = new Date().toISOString();
+	const stmt = db.query(
+		`UPDATE observations SET retrieval_count = retrieval_count + 1, last_retrieved = ? WHERE id = ?`,
+	);
+	for (const id of ids) {
+		stmt.run(now, id);
+	}
+}

package/dist/template/.opencode/plugin/{lib → memory}/db/schema.ts

@@ -126,7 +126,7 @@ function logRecovery(message: string): void {
 // Schema v3 (v2 + navigation, entity graph, raw source, chunk type)
 // ============================================================================
 
-const SCHEMA_VERSION = 3;
+const SCHEMA_VERSION = 4;
 
 const SCHEMA_SQL = `
 -- Schema versioning for migrations
@@ -158,6 +158,13 @@ CREATE TABLE IF NOT EXISTS observations (
   wing TEXT,
   hall TEXT CHECK(hall IS NULL OR hall IN ('facts','events','discoveries','preferences','advice')),
   room TEXT,
+  helpful_count INTEGER NOT NULL DEFAULT 0,
+  harmful_count INTEGER NOT NULL DEFAULT 0,
+  feedback_events TEXT,
+  effective_score REAL DEFAULT 0,
+  maturity TEXT DEFAULT 'active',
+  retrieval_count INTEGER DEFAULT 0,
+  last_retrieved TEXT,
   created_at TEXT NOT NULL,
   created_at_epoch INTEGER NOT NULL,
   updated_at TEXT,
@@ -610,6 +617,9 @@ function initializeSchema(db: Database): void {
 		if (currentVersion < 3) {
 			migrateV2ToV3(db);
 		}
+		if (currentVersion < 4) {
+			migrateV3ToV4(db);
+		}
 	}
 
 	// Record schema version
@@ -685,3 +695,35 @@ function migrateV2ToV3(db: Database): void {
 		}
 	}
 }
+
+// ============================================================================
+// Schema v4: Pikit alignment — feedback, scoring, and tracking columns
+// ============================================================================
+
+const MIGRATION_V3_TO_V4 = `
+ALTER TABLE observations ADD COLUMN helpful_count INTEGER NOT NULL DEFAULT 0;
+ALTER TABLE observations ADD COLUMN harmful_count INTEGER NOT NULL DEFAULT 0;
+ALTER TABLE observations ADD COLUMN feedback_events TEXT;
+ALTER TABLE observations ADD COLUMN effective_score REAL DEFAULT 0;
+ALTER TABLE observations ADD COLUMN maturity TEXT DEFAULT 'active';
+ALTER TABLE observations ADD COLUMN retrieval_count INTEGER DEFAULT 0;
+ALTER TABLE observations ADD COLUMN last_retrieved TEXT;
+`;
+
+/**
+ * Migrate from schema v3 to v4.
+ * Adds: helpful_count, harmful_count, feedback_events, effective_score,
+ *       maturity, retrieval_count, last_retrieved.
+ */
+function migrateV3ToV4(db: Database): void {
+	for (const stmt of MIGRATION_V3_TO_V4.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 → memory}/db/types.ts

@@ -145,6 +145,13 @@ export interface ObservationRow {
 	wing: string | null; // v3: navigation wing (project/person)
 	hall: HallType | null; // v3: navigation hall (facts/events/...)
 	room: string | null; // v3: navigation room (topic)
+	helpful_count: number;
+	harmful_count: number;
+	feedback_events: string | null; // JSON array of FeedbackEvent
+	effective_score: number | null;
+	maturity: string | null;
+	retrieval_count: number | null;
+	last_retrieved: string | null;
 	created_at: string;
 	created_at_epoch: number;
 	updated_at: string | null;
@@ -282,3 +289,18 @@ export interface ArchiveOptions {
 	/** Dry run — don't actually archive, just count */
 	dryRun?: boolean;
 }
+
+// ============================================================================
+// Feedback & Scoring Types (aligned with pikit memory extension)
+// ============================================================================
+
+export type FeedbackType = "helpful" | "harmful";
+
+export interface FeedbackEvent {
+	type: FeedbackType;
+	timestamp: number; // Date.now()
+	reason?: string;
+	session_id?: string;
+}
+
+export type MaturityState = "candidate" | "active" | "stale" | "deprecated";

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

@@ -2,7 +2,7 @@
  * 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".
+ * This preserves backward compatibility for existing imports from "./db.js".
  *
  * Sub-module structure:
  *   db/types.ts        — Configuration, types, interfaces

package/dist/template/.opencode/plugin/{lib → memory}/distill.ts

@@ -16,7 +16,7 @@ import {
 	markMessagesDistilled,
 	storeDistillation,
 	type TemporalMessageRow,
-} from "./memory-db.js";
+} from "./db.js";
 
 // ============================================================================
 // TF-IDF Engine

package/dist/template/.opencode/plugin/{lib/memory-helpers.ts → memory/helpers.ts}

@@ -6,7 +6,7 @@
  */
 
 import { readFile } from "node:fs/promises";
-import type { ObservationType } from "./memory-db.js";
+import type { ObservationType } from "./db.js";
 
 // ============================================================================
 // Constants
@@ -120,6 +120,8 @@ export function formatObservation(obs: {
 	supersedes?: number | null;
 	superseded_by?: number | null;
 	source?: string | null;
+	helpful_count?: number | null;
+	harmful_count?: number | null;
 	created_at?: string | null;
 }): string {
 	const icon = TYPE_ICONS[obs.type] ?? "\uD83D\uDCCC";
@@ -135,6 +137,8 @@ export function formatObservation(obs: {
 	if (obs.bead_id) lines.push(`  Bead: ${obs.bead_id}`);
 	if (obs.supersedes) lines.push(`  Supersedes: #${obs.supersedes}`);
 	if (obs.superseded_by) lines.push(`  Superseded by: #${obs.superseded_by}`);
+	if ((obs.helpful_count ?? 0) > 0 || (obs.harmful_count ?? 0) > 0)
+		lines.push(`  Feedback: ${obs.helpful_count ?? 0}\uD83D\uDC4D / ${obs.harmful_count ?? 0}\uD83D\uDC4E`);
 	if (obs.narrative) lines.push(`\n${obs.narrative}`);
 	if (obs.created_at) lines.push(`\n  _Created: ${obs.created_at}_`);
 	return lines.join("\n");

package/dist/template/.opencode/plugin/{lib/memory-hooks.ts → memory/hooks.ts}

@@ -26,7 +26,7 @@ import {
 	checkpointWAL,
 	getDatabaseSizes,
 	optimizeFTS5,
-} from "./memory-db.js";
+} from "./db.js";
 
 interface HookDeps {
 	showToast: (

package/dist/template/.opencode/plugin/{lib → memory}/index-generator.ts

@@ -10,8 +10,8 @@
 
 import { upsertMemoryFile } from "./db/maintenance.js";
 import type { ObservationRow } from "./db/types.js";
-import { getMemoryDB } from "./memory-db.js";
-import { TYPE_ICONS, parseConcepts } from "./memory-helpers.js";
+import { getMemoryDB } from "./db.js";
+import { TYPE_ICONS, parseConcepts } from "./helpers.js";
 
 // ============================================================================
 // Types

package/dist/template/.opencode/plugin/{lib → memory}/inject.ts

@@ -13,7 +13,7 @@ import {
 	estimateTokens,
 	getRelevantKnowledge,
 	MEMORY_CONFIG,
-} from "./memory-db.js";
+} from "./db.js";
 
 // ============================================================================
 // Query Term Extraction

package/dist/template/.opencode/plugin/{lib → memory}/lint.ts

@@ -9,8 +9,8 @@
  */
 
 import type { ObservationRow } from "./db/types.js";
-import { getMemoryDB } from "./memory-db.js";
-import { hasWord, parseConcepts } from "./memory-helpers.js";
+import { getMemoryDB } from "./db.js";
+import { hasWord, parseConcepts } from "./helpers.js";
 
 // ============================================================================
 // Types