principles-disciple 1.114.2 → 1.115.1

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Evolutionary programming agent framework with strategic guardrails and reflection loops.",
-  "version": "1.114.2",
+  "version": "1.115.1",
   "activation": {
     "onCapabilities": [
       "hook"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "principles-disciple",
-  "version": "1.114.2",
+  "version": "1.115.1",
   "description": "Native OpenClaw plugin for Principles Disciple",
   "type": "module",
   "main": "./dist/bundle.js",

package/src/core/trajectory-types.ts

@@ -68,6 +68,10 @@ export interface TrajectoryPainEventInput {
   confidence?: number | null;
   text?: string;
   createdAt?: string;
+  /** PRI-406: Canonical pain identity (e.g. manual_<ts>_<hash> or pain_<ts>_<hash>). */
+  canonicalPainId?: string;
+  /** PRI-406: Runtime V2 diagnostician task ID linked to this pain event. */
+  runtimeTaskId?: string;
 }
 
 export interface TrajectoryGateBlockInput {

package/src/core/trajectory.ts

@@ -241,10 +241,15 @@ export class TrajectoryDatabase {
     this.recordSession({ sessionId: input.sessionId, startedAt: input.createdAt });
     let insertedId = -1;
     this.withWrite(() => {
+    // Try INSERT; on UNIQUE constraint violation for canonical_pain_id, do UPDATE instead.
+    // SQLite UPSERT (ON CONFLICT) does not support partial unique indexes, so we
+    // handle the conflict manually.
+    try {
       const runResult = this.db.prepare(`
         INSERT INTO pain_events (
-          session_id, source, score, reason, severity, origin, confidence, text, created_at
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+          session_id, source, score, reason, severity, origin, confidence, text, created_at,
+          canonical_pain_id, runtime_task_id
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       `).run(
         input.sessionId,
         input.source,
@@ -255,8 +260,33 @@ export class TrajectoryDatabase {
         input.confidence ?? null,
         input.text ?? null,
         input.createdAt ?? nowIso(),
+        input.canonicalPainId ?? null,
+        input.runtimeTaskId ?? null,
       );
-      insertedId = runResult.lastInsertRowid as number;
+      insertedId = Number(runResult.lastInsertRowid);
+    } catch (insertErr: unknown) {
+      if (
+        input.canonicalPainId &&
+        insertErr instanceof Error &&
+        insertErr.message.includes('UNIQUE constraint failed') &&
+        insertErr.message.includes('canonical_pain_id')
+      ) {
+        this.db.prepare(`
+          UPDATE pain_events
+          SET runtime_task_id = COALESCE(?, runtime_task_id)
+          WHERE canonical_pain_id = ?
+        `).run(input.runtimeTaskId ?? null, input.canonicalPainId);
+        const rawRow = this.db.prepare('SELECT id FROM pain_events WHERE canonical_pain_id = ?').get(input.canonicalPainId);
+        // Runtime Contract #1/#2: validate DB row instead of `as` cast
+        if (rawRow && typeof rawRow === 'object' && Object.hasOwn(rawRow, 'id') && typeof (rawRow as Record<string, unknown>).id === 'number') {
+          insertedId = (rawRow as { id: number }).id;
+        } else {
+          insertedId = -1;
+        }
+      } else {
+        throw insertErr;
+      }
+    }
     });
     // FTS indexing is best-effort — run outside the transaction so it cannot
     // roll back the committed pain event row (MEM-03, MEM-04).
@@ -1332,6 +1362,28 @@ export class TrajectoryDatabase {
       }
     }
 
+    // PRI-406: Add canonical_pain_id and runtime_task_id columns to pain_events
+    for (const col of [
+      { name: 'canonical_pain_id', type: 'TEXT' },
+      { name: 'runtime_task_id', type: 'TEXT' },
+    ]) {
+      try {
+        this.db.exec(`ALTER TABLE pain_events ADD COLUMN ${col.name} ${col.type}`);
+      } catch (err: unknown) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (!message.includes('duplicate column name') && !message.includes('no column named')) {
+          throw err;
+        }
+      }
+    }
+
+    // PRI-406: Partial unique index on canonical_pain_id (non-null only) for dedup
+    this.db.exec(`
+      CREATE UNIQUE INDEX IF NOT EXISTS idx_pain_events_canonical_pain_id
+      ON pain_events(canonical_pain_id)
+      WHERE canonical_pain_id IS NOT NULL
+    `);
+
     // Create FTS5 virtual table for pain_events text search (MEM-04)
     this.db.exec(`
       CREATE VIRTUAL TABLE IF NOT EXISTS pain_events_fts USING fts5(