nodal-agents 0.6.7 → 0.7.0

package/README.md

@@ -10,7 +10,7 @@ A self-hosted platform for building and orchestrating a **team of AI agents** on
 [![Node](https://img.shields.io/badge/node-22%2B-339933?logo=node.js&logoColor=white)](https://nodejs.org)
 [![TypeScript](https://img.shields.io/badge/typescript-strict-3178c6?logo=typescript&logoColor=white)](https://www.typescriptlang.org)
 [![Docs](https://img.shields.io/badge/docs-online-3565ff)](https://kwintspiracy.github.io/nodal-agents/)
-[![Changelog](https://img.shields.io/badge/changelog-v0.6.7-d4ff2e)](CHANGELOG.md)
+[![Changelog](https://img.shields.io/badge/changelog-v0.6.8-d4ff2e)](CHANGELOG.md)
 
 | Home dashboard — light theme | Agent detail — dark theme |
 | :---: | :---: |

package/cli.js

@@ -11511,6 +11511,10 @@ var init_memory = __esm({
       valid_to: z13.string().datetime().nullable(),
       fact_hash: z13.string().nullable(),
       archived: z13.boolean(),
+      // User override lock (migration 0053) — when true, the curator refuses to
+      // re-score importance for this fact. Defaulted so rows/objects predating
+      // the column still parse.
+      importance_locked: z13.boolean().default(false),
       last_accessed_at: z13.string().datetime().nullable(),
       access_count: z13.number().int().min(0),
       created_at: z13.string().datetime(),
@@ -11522,6 +11526,7 @@ var init_memory = __esm({
       updated_at: true,
       fact_hash: true,
       archived: true,
+      importance_locked: true,
       last_accessed_at: true,
       access_count: true,
       valid_from: true,
@@ -12330,6 +12335,10 @@ var init_entities = __esm({
         updatedAt: timestamp("updated_at", { withTimezone: true }).defaultNow(),
         lastCuratorRunAt: timestamp("last_curator_run_at", { withTimezone: true }),
         reflectionEnabled: boolean("reflection_enabled").notNull().default(false),
+        // Decoupled from reflection_enabled (which gates the skill-learning loop,
+        // opt-in). Gates the memory curator (Phase 2 LLM pass) — ON by default so
+        // memory curation runs even for entities that never opted into reflection.
+        memoryCurationEnabled: boolean("memory_curation_enabled").notNull().default(true),
         // Controls whether agent-authored skills are auto-assigned to the authoring
         // agent ('auto') or queued for the entity owner to approve ('approval').
         skillAssignmentMode: text("skill_assignment_mode").notNull().default("approval").$type(),
@@ -12886,6 +12895,15 @@ var init_memory2 = __esm({
         id: uuid("id").primaryKey().defaultRandom(),
         entityId: uuid("entity_id").references(() => entities.id, { onDelete: "cascade" }),
         agentId: uuid("agent_id").references(() => agents.id, { onDelete: "cascade" }),
+        /**
+         * Full-text source. A generated `search_tsv tsvector` column + GIN index
+         * (raw SQL, migration 0051 — not expressible in the Drizzle schema builder,
+         * same pattern as agent_jobs.search_tsv / migration 0050) makes this fact
+         * rankable by relevance. Powers memory injection (selectMemoriesForInjection)
+         * and the `query_memory` builtin (keywordSearchMemories) via ts_rank.
+         * Config is `'english'` (stemming — "tokens" matches a "token" query),
+         * unlike agent_jobs.search_tsv which stays `'simple'`.
+         */
         fact: text("fact").notNull(),
         category: text("category").default("context"),
         importance: integer("importance").default(3),
@@ -12897,6 +12915,12 @@ var init_memory2 = __esm({
         validTo: timestamp("valid_to", { withTimezone: true }),
         factHash: text("fact_hash"),
         archived: boolean("archived").default(false),
+        /**
+         * User override lock (migration 0053). When true, the curator's
+         * usage-driven re-scoring MUST refuse to touch importance — a user-pinned
+         * value wins over the agent's guess and the curator's correction.
+         */
+        importanceLocked: boolean("importance_locked").notNull().default(false),
         lastAccessedAt: timestamp("last_accessed_at", { withTimezone: true }).defaultNow(),
         accessCount: integer("access_count").default(0),
         createdAt: timestamp("created_at", { withTimezone: true }).defaultNow(),

package/migrations/0051_memory_search_fts.sql

@@ -0,0 +1,2 @@
+ALTER TABLE "agent_memory" ADD COLUMN "search_tsv" tsvector GENERATED ALWAYS AS (to_tsvector('english', coalesce("fact", ''))) STORED;--> statement-breakpoint
+CREATE INDEX "idx_agent_memory_search_tsv" ON "agent_memory" USING gin ("search_tsv");

package/migrations/0052_entities_memory_curation.sql

@@ -0,0 +1 @@
+ALTER TABLE "entities" ADD COLUMN "memory_curation_enabled" boolean NOT NULL DEFAULT true;

package/migrations/0053_memory_importance_locked.sql

@@ -0,0 +1 @@
+ALTER TABLE "agent_memory" ADD COLUMN "importance_locked" boolean NOT NULL DEFAULT false;

package/migrations/meta/_journal.json

@@ -351,6 +351,27 @@
       "when": 1783000000000,
       "tag": "0050_jobs_search_fts",
       "breakpoints": true
+    },
+    {
+      "idx": 51,
+      "version": "7",
+      "when": 1783100000000,
+      "tag": "0051_memory_search_fts",
+      "breakpoints": true
+    },
+    {
+      "idx": 52,
+      "version": "7",
+      "when": 1783200000000,
+      "tag": "0052_entities_memory_curation",
+      "breakpoints": true
+    },
+    {
+      "idx": 53,
+      "version": "7",
+      "when": 1783300000000,
+      "tag": "0053_memory_importance_locked",
+      "breakpoints": true
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodal-agents",
-  "version": "0.6.7",
+  "version": "0.7.0",
   "description": "Local-first AI agent platform with a web dashboard — install in one command.",
   "license": "MIT",
   "repository": {