@pencil-agent/nano-pencil 1.11.20 → 1.11.21

package/dist/packages/mem-core/engine.d.ts

@@ -99,6 +99,7 @@ export declare class NanoMemEngine {
     getAllEpisodes(): Promise<Episode[]>;
     runStartupMaintenance(maintenanceVersion?: number): Promise<{
         ran: boolean;
+        backupPath?: string;
         deduplicated: {
             knowledge: number;
             lessons: number;
@@ -110,6 +111,7 @@ export declare class NanoMemEngine {
         };
         migratedEpisodesToV2: number;
     }>;
+    private createMaintenanceBackup;
     private syncEpisodeToV2;
     private mapEpisodeToV2;
     private makeEpisodeMemoryId;

package/dist/packages/mem-core/engine.js

@@ -4,6 +4,7 @@
  * [LOCUS]: packages/mem-core/src/engine.ts - facade layer composing all memory subsystems
  * [COVENANT]: Change engine API → update this header and verify against packages/mem-core/CLAUDE.md
  */
+import { cp, mkdir, readdir } from "node:fs/promises";
 import { join } from "node:path";
 import { getConfig } from "./config.js";
 import { consolidateEpisodes } from "./consolidation.js";
@@ -660,11 +661,13 @@ export class NanoMemEngine {
         if (alreadyMaintained) {
             return {
                 ran: false,
+                backupPath: undefined,
                 deduplicated: { knowledge: 0, lessons: 0, events: 0, preferences: 0, facets: 0, work: 0, total: 0 },
                 migratedEpisodesToV2: 0,
             };
         }
         const now = new Date().toISOString();
+        const backupPath = await this.createMaintenanceBackup(meta, v2Meta, maintenanceVersion, now);
         const deduplicated = await this.deduplicateAll();
         const episodes = await this.getAllEpisodes();
         for (const episode of episodes) {
@@ -675,6 +678,8 @@ export class NanoMemEngine {
                 ...(await loadMeta(this.metaPath)),
                 lastMaintenanceAt: now,
                 lastMaintenanceVersion: maintenanceVersion,
+                lastBackupAt: meta.lastBackupAt ?? now,
+                lastBackupVersion: Math.max(meta.lastBackupVersion ?? 0, maintenanceVersion),
             }),
             saveV2Meta(this.v2Paths, {
                 ...(await loadV2Meta(this.v2Paths)),
@@ -682,14 +687,60 @@ export class NanoMemEngine {
                 lastMaintenanceAt: now,
                 lastMaintenanceVersion: maintenanceVersion,
                 lastMigrationAt: (await loadV2Meta(this.v2Paths)).lastMigrationAt ?? now,
+                lastBackupAt: v2Meta.lastBackupAt ?? now,
+                lastBackupVersion: Math.max(v2Meta.lastBackupVersion ?? 0, maintenanceVersion),
             }),
         ]);
         return {
             ran: true,
+            backupPath,
             deduplicated,
             migratedEpisodesToV2: episodes.length,
         };
     }
+    async createMaintenanceBackup(meta, v2Meta, maintenanceVersion, now) {
+        const alreadyBackedUp = (meta.lastBackupVersion ?? 0) >= maintenanceVersion &&
+            (v2Meta.lastBackupVersion ?? 0) >= maintenanceVersion;
+        if (alreadyBackedUp)
+            return undefined;
+        const safeTimestamp = now.replace(/[:.]/g, "-");
+        const backupRoot = join(this.cfg.memoryDir, "_backups");
+        const backupDir = join(backupRoot, `maintenance-v${maintenanceVersion}-${safeTimestamp}`);
+        await mkdir(backupDir, { recursive: true });
+        const filesToCopy = [
+            this.knowledgePath,
+            this.lessonsPath,
+            this.eventsPath,
+            this.preferencesPath,
+            this.facetsPath,
+            this.workPath,
+            this.metaPath,
+        ];
+        for (const filePath of filesToCopy) {
+            try {
+                await cp(filePath, join(backupDir, filePath.split("/").pop() ?? "unknown.json"));
+            }
+            catch {
+                // Missing files are fine for first-run users.
+            }
+        }
+        for (const dirName of ["episodes", "v2"]) {
+            const sourceDir = join(this.cfg.memoryDir, dirName);
+            try {
+                await readdir(sourceDir);
+                await cp(sourceDir, join(backupDir, dirName), { recursive: true });
+            }
+            catch {
+                // Skip directories that do not exist yet.
+            }
+        }
+        await writeJson(join(backupDir, "manifest.json"), {
+            createdAt: now,
+            maintenanceVersion,
+            memoryDir: this.cfg.memoryDir,
+        });
+        return backupDir;
+    }
     async syncEpisodeToV2(ep) {
         const [episodes, facets, links, procedural, meta] = await Promise.all([
             loadV2Episodes(this.v2Paths),

package/dist/packages/mem-core/extension.js

@@ -309,6 +309,9 @@ export default function nanomemExtension(pi) {
             const maintenance = await engine.runStartupMaintenance(1);
             if (maintenance.ran && ctx.hasUI) {
                 const notes = [];
+                if (maintenance.backupPath) {
+                    notes.push(`backup saved to ${maintenance.backupPath}`);
+                }
                 if (maintenance.deduplicated.total > 0) {
                     notes.push(`deduped ${maintenance.deduplicated.total} entries`);
                 }

package/dist/packages/mem-core/types-v2.d.ts

@@ -165,6 +165,8 @@ export interface V2Meta {
     lastReconsolidationAt?: string;
     lastMaintenanceAt?: string;
     lastMaintenanceVersion?: number;
+    lastBackupAt?: string;
+    lastBackupVersion?: number;
 }
 export interface NanoMemV2Snapshot {
     episodes: EpisodeMemory[];

package/dist/packages/mem-core/types.d.ts

@@ -116,6 +116,8 @@ export interface Meta {
     version: number;
     lastMaintenanceAt?: string;
     lastMaintenanceVersion?: number;
+    lastBackupAt?: string;
+    lastBackupVersion?: number;
 }
 /** Mem0-style update operations */
 export type UpdateAction = "add" | "update" | "delete" | "noop";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pencil-agent/nano-pencil",
-  "version": "1.11.20",
+  "version": "1.11.21",
   "description": "CLI writing agent with read, bash, edit, write tools and session management. Based on pi; supports DashScope Coding Plan. Soul enabled by default for AI personality evolution.",
   "type": "module",
   "bin": {