@remnic/core 9.11.0 → 9.12.0

package/dist/transfer/types.d.ts

@@ -20,26 +20,26 @@ declare const ExportManifestV1Schema: z.ZodObject<{
         bytes: number;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: 1;
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
+    schemaVersion: 1;
     includesTranscripts: boolean;
 }, {
-    schemaVersion: 1;
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
+    schemaVersion: 1;
     includesTranscripts: boolean;
 }>;
 type ExportManifestV1 = z.infer<typeof ExportManifestV1Schema>;
@@ -75,26 +75,26 @@ declare const ExportBundleV1Schema: z.ZodObject<{
             bytes: number;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     }, {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     }>;
     records: z.ZodArray<z.ZodObject<{
@@ -109,15 +109,15 @@ declare const ExportBundleV1Schema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     manifest: {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     };
     records: {
@@ -126,15 +126,15 @@ declare const ExportBundleV1Schema: z.ZodObject<{
     }[];
 }, {
     manifest: {
-        schemaVersion: 1;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
+        schemaVersion: 1;
         includesTranscripts: boolean;
     };
     records: {
@@ -319,10 +319,10 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
-    schemaVersion: string;
+    description: string;
     id: string;
+    schemaVersion: string;
     version: string;
-    description: string;
     parentCapsule: string | null;
     parent: {
         version: string;
@@ -340,10 +340,10 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
-    schemaVersion: string;
+    description: string;
     id: string;
+    schemaVersion: string;
     version: string;
-    description: string;
     parentCapsule: string | null;
     retrievalPolicy: {
         tierWeights: Record<string, number>;
@@ -470,10 +470,10 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         parent: {
             version: string;
@@ -491,10 +491,10 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         retrievalPolicy: {
             tierWeights: Record<string, number>;
@@ -507,16 +507,14 @@ declare const ExportManifestV2Schema: z.ZodObject<{
         } | null | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
-    schemaVersion: 2;
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
-    includesTranscripts: boolean;
     capsule: {
         includes: {
             procedural: boolean;
@@ -524,10 +522,10 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         parent: {
             version: string;
@@ -539,17 +537,17 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             directAnswerEnabled: boolean;
         };
     };
-}, {
     schemaVersion: 2;
+    includesTranscripts: boolean;
+}, {
+    format: "openclaw-engram-export";
     createdAt: string;
+    pluginVersion: string;
     files: {
         path: string;
         sha256: string;
         bytes: number;
     }[];
-    format: "openclaw-engram-export";
-    pluginVersion: string;
-    includesTranscripts: boolean;
     capsule: {
         includes: {
             procedural: boolean;
@@ -557,10 +555,10 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
+        description: string;
         id: string;
+        schemaVersion: string;
         version: string;
-        description: string;
         parentCapsule: string | null;
         retrievalPolicy: {
             tierWeights: Record<string, number>;
@@ -572,6 +570,8 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             forkRoot: string;
         } | null | undefined;
     };
+    schemaVersion: 2;
+    includesTranscripts: boolean;
 }>;
 type ExportManifestV2 = z.infer<typeof ExportManifestV2Schema>;
 declare const ExportBundleV2Schema: z.ZodObject<{
@@ -689,10 +689,10 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             parent: {
                 version: string;
@@ -710,10 +710,10 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -726,16 +726,14 @@ declare const ExportBundleV2Schema: z.ZodObject<{
             } | null | undefined;
         }>;
     }, "strip", z.ZodTypeAny, {
-        schemaVersion: 2;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
             includes: {
                 procedural: boolean;
@@ -743,10 +741,10 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             parent: {
                 version: string;
@@ -758,17 +756,17 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 directAnswerEnabled: boolean;
             };
         };
-    }, {
         schemaVersion: 2;
+        includesTranscripts: boolean;
+    }, {
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
             includes: {
                 procedural: boolean;
@@ -776,10 +774,10 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -791,6 +789,8 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 forkRoot: string;
             } | null | undefined;
         };
+        schemaVersion: 2;
+        includesTranscripts: boolean;
     }>;
     records: z.ZodArray<z.ZodObject<{
         path: z.ZodString;
@@ -804,16 +804,14 @@ declare const ExportBundleV2Schema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     manifest: {
-        schemaVersion: 2;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
             includes: {
                 procedural: boolean;
@@ -821,10 +819,10 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             parent: {
                 version: string;
@@ -836,6 +834,8 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 directAnswerEnabled: boolean;
             };
         };
+        schemaVersion: 2;
+        includesTranscripts: boolean;
     };
     records: {
         content: string;
@@ -843,16 +843,14 @@ declare const ExportBundleV2Schema: z.ZodObject<{
     }[];
 }, {
     manifest: {
-        schemaVersion: 2;
+        format: "openclaw-engram-export";
         createdAt: string;
+        pluginVersion: string;
         files: {
             path: string;
             sha256: string;
             bytes: number;
         }[];
-        format: "openclaw-engram-export";
-        pluginVersion: string;
-        includesTranscripts: boolean;
         capsule: {
             includes: {
                 procedural: boolean;
@@ -860,10 +858,10 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
+            description: string;
             id: string;
+            schemaVersion: string;
             version: string;
-            description: string;
             parentCapsule: string | null;
             retrievalPolicy: {
                 tierWeights: Record<string, number>;
@@ -875,6 +873,8 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 forkRoot: string;
             } | null | undefined;
         };
+        schemaVersion: 2;
+        includesTranscripts: boolean;
     };
     records: {
         content: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.11.0",
+  "version": "9.12.0",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3045,7 +3045,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.11.0"
+    "@remnic/coding-graph": "^9.12.0"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/activity/digest.test.ts

@@ -0,0 +1,180 @@
+import assert from "node:assert/strict";
+import { test } from "node:test";
+
+import {
+  activityDayWindow,
+  activityDigestPath,
+  composeActivityDigestBody,
+  composeActivityDigestMeta,
+  isValidActivityDate,
+  parseActivityDigest,
+  serializeActivityDigest,
+} from "./digest.js";
+import type { ActivitySnapshot } from "./types.js";
+
+function snap(overrides: Partial<ActivitySnapshot> = {}): ActivitySnapshot {
+  return {
+    machine: "macstudio",
+    capturedAtUtc: "2026-03-10T14:00:00.000Z",
+    app: "Chrome",
+    windowTitle: "Roadmap",
+    text: "quarterly roadmap review notes",
+    textSource: "ax",
+    contentHash: "h",
+    ...overrides,
+  };
+}
+
+const DAY = [
+  snap({ id: 1, contentHash: "a", capturedAtUtc: "2026-03-10T14:00:00.000Z", app: "Chrome", windowTitle: "Roadmap", text: "roadmap planning" }),
+  snap({ id: 2, contentHash: "b", capturedAtUtc: "2026-03-10T14:10:00.000Z", app: "Slack", windowTitle: "#eng", text: "deploy staging soon" }),
+  snap({ id: 3, contentHash: "c", capturedAtUtc: "2026-03-10T14:12:00.000Z", app: "Chrome", windowTitle: "PR 412", browserUrl: "https://github.com/x/pull/412", text: "review pull request" }),
+];
+
+test("composeActivityDigestBody is byte-identical across two renders (deterministic)", () => {
+  const a = composeActivityDigestBody("2026-03-10", "America/Chicago", DAY);
+  const b = composeActivityDigestBody("2026-03-10", "America/Chicago", [...DAY].reverse());
+  assert.equal(a, b);
+});
+
+test("per-app time section is sorted with a stable tiebreaker on equal dwell", () => {
+  // Two apps with identical (zero) dwell — last snapshots — must order by name.
+  const snaps = [
+    snap({ id: 1, contentHash: "a", capturedAtUtc: "2026-03-10T14:00:00.000Z", app: "Zed" }),
+    snap({ id: 2, contentHash: "b", capturedAtUtc: "2026-03-10T14:00:00.000Z", app: "Arc" }),
+  ];
+  const body1 = composeActivityDigestBody("2026-03-10", "UTC", snaps);
+  const body2 = composeActivityDigestBody("2026-03-10", "UTC", [...snaps].reverse());
+  assert.equal(body1, body2);
+  // Arc sorts before Zed at equal dwell.
+  assert.ok(body1.indexOf("- Arc:") < body1.indexOf("- Zed:"));
+});
+
+test("contentHash is stable across renders and meta reflects inputs", () => {
+  const body = composeActivityDigestBody("2026-03-10", "UTC", DAY);
+  const meta = composeActivityDigestMeta("2026-03-10", ["laptop", "macstudio", "laptop"], DAY, body);
+  assert.equal(meta.kind, "activity-digest");
+  assert.equal(meta.snapshotCount, 3);
+  assert.deepEqual(meta.machines, ["laptop", "macstudio"]); // deduped + sorted
+  assert.equal(meta.contentHash, composeActivityDigestMeta("2026-03-10", ["macstudio"], DAY, body).contentHash);
+});
+
+test("serialize → parse round-trips meta and body", () => {
+  const body = composeActivityDigestBody("2026-03-10", "UTC", DAY);
+  const meta = composeActivityDigestMeta("2026-03-10", ["macstudio"], DAY, body);
+  const parsed = parseActivityDigest(serializeActivityDigest(meta, body));
+  assert.ok(parsed);
+  assert.deepEqual(parsed?.meta, meta);
+  assert.equal(parsed?.body, body);
+});
+
+test("parseActivityDigest returns null on malformed input", () => {
+  assert.equal(parseActivityDigest("no frontmatter here"), null);
+  assert.equal(parseActivityDigest("---\nkind: activity-digest\n(no closing fence)"), null);
+  assert.equal(parseActivityDigest("---\nkind: other\ndate: 2026-03-10\ncontentHash: x\n---\nbody"), null);
+});
+
+test("activityDayWindow yields half-open DST-aware bounds", () => {
+  const w = activityDayWindow("2026-03-10", "America/Chicago");
+  assert.equal(w.startUtc, "2026-03-10T05:00:00.000Z");
+  assert.equal(w.endUtc, "2026-03-11T05:00:00.000Z");
+  // Spring-forward day: CST→CDT shift reflected.
+  const dst = activityDayWindow("2026-03-08", "America/Chicago");
+  assert.equal(dst.startUtc, "2026-03-08T06:00:00.000Z");
+  assert.equal(dst.endUtc, "2026-03-09T05:00:00.000Z");
+});
+
+test("a snapshot at exactly local midnight lands in exactly one day", () => {
+  // Local midnight 2026-03-10 in America/Chicago (CST) == 06:00Z.
+  const midnightUtc = "2026-03-10T06:00:00.000Z";
+  const day10 = activityDayWindow("2026-03-10", "America/Chicago");
+  const day09 = activityDayWindow("2026-03-09", "America/Chicago");
+  // Included in the 10th (start-inclusive), excluded from the 9th (end-exclusive).
+  assert.ok(midnightUtc >= day10.startUtc && midnightUtc < day10.endUtc);
+  assert.ok(!(midnightUtc >= day09.startUtc && midnightUtc < day09.endUtc));
+});
+
+test("activityDigestPath places the file under <memoryDir>/activity/", () => {
+  assert.equal(activityDigestPath("/mem", "2026-03-10"), "/mem/activity/2026-03-10.md");
+});
+
+test("isValidActivityDate rejects impossible and malformed calendar days", () => {
+  assert.equal(isValidActivityDate("2026-03-10"), true);
+  assert.equal(isValidActivityDate("2026-02-30"), false); // Feb has no 30th
+  assert.equal(isValidActivityDate("2026-13-01"), false); // no month 13
+  assert.equal(isValidActivityDate("2026-00-10"), false);
+  assert.equal(isValidActivityDate("not-a-date"), false);
+  assert.equal(isValidActivityDate("2026-3-10"), false); // wrong shape
+});
+
+test("activityDigestPath rejects path-traversal / invalid dates", () => {
+  assert.equal(activityDigestPath("/mem", "2026-03-10"), "/mem/activity/2026-03-10.md");
+  assert.throws(() => activityDigestPath("/mem", "../../etc/passwd"), RangeError);
+  assert.throws(() => activityDigestPath("/mem", "2026-02-30"), RangeError);
+});
+
+test("activityDayWindow rejects an impossible date", () => {
+  assert.throws(() => activityDayWindow("2026-02-30", "UTC"), RangeError);
+  assert.throws(() => activityDayWindow("../evil", "UTC"), RangeError);
+});
+
+test("parseActivityDigest rejects a non-numeric snapshotCount/formatVersion", () => {
+  const body = composeActivityDigestBody("2026-03-10", "UTC", DAY);
+  const meta = composeActivityDigestMeta("2026-03-10", ["macstudio"], DAY, body);
+  const good = serializeActivityDigest(meta, body);
+  const broken = good.replace(/snapshotCount: \d+/, "snapshotCount: lots");
+  assert.equal(parseActivityDigest(broken), null);
+});
+
+test("dwell is scoped per capture machine — an interleaved machine can't steal it", () => {
+  const snaps = [
+    snap({ machine: "A", app: "A-app", capturedAtUtc: "2026-03-10T14:00:00.000Z", contentHash: "a1" }),
+    snap({ machine: "B", app: "B-app", capturedAtUtc: "2026-03-10T14:01:00.000Z", contentHash: "b1" }),
+    snap({ machine: "A", app: "A-app", capturedAtUtc: "2026-03-10T14:10:00.000Z", contentHash: "a2" }),
+  ];
+  const body = composeActivityDigestBody("2026-03-10", "UTC", snaps);
+  // A-app dwell = A@14:00 → A@14:10 = 10m (per-machine), not 1m (global next = B@14:01).
+  assert.ok(body.includes("- A-app: 10m"), body);
+});
+
+test("digest ordering is deterministic for same-time unsaved snapshots", () => {
+  const a = snap({ capturedAtUtc: "2026-03-10T14:00:00.000Z", contentHash: "h-a", app: "Alpha", text: "alpha window" });
+  const b = snap({ capturedAtUtc: "2026-03-10T14:00:00.000Z", contentHash: "h-b", app: "Beta", text: "beta window" });
+  const one = composeActivityDigestBody("2026-03-10", "UTC", [a, b]);
+  const two = composeActivityDigestBody("2026-03-10", "UTC", [b, a]);
+  assert.equal(one, two);
+});
+
+test("activityDayWindow does not backdate a skipped local midnight", () => {
+  // Egypt restarts DST on the last Friday of April at 00:00 (00:00 → 01:00),
+  // so local midnight is skipped. The day-start must land on the correct local
+  // day (the first existing local time), never backdated into the prior day.
+  const w = activityDayWindow("2026-04-24", "Africa/Cairo");
+  const local = new Intl.DateTimeFormat("en-CA", {
+    timeZone: "Africa/Cairo",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    hour12: false,
+  }).format(new Date(w.startUtc));
+  assert.ok(local.startsWith("2026-04-24"), local);
+});
+
+test("timeline keeps a second machine's span even with the same app/window", () => {
+  const a = snap({ machine: "A", capturedAtUtc: "2026-03-10T14:00:00.000Z", app: "Chrome", windowTitle: "Doc", contentHash: "a1", text: "" });
+  const b = snap({ machine: "B", capturedAtUtc: "2026-03-10T14:00:30.000Z", app: "Chrome", windowTitle: "Doc", contentHash: "b1", text: "" });
+  const body = composeActivityDigestBody("2026-03-10", "UTC", [a, b]);
+  // machine is part of the timeline-span key, so the same app/window on a
+  // different machine is not coalesced away.
+  const timelineLines = body.split("\n").filter((line) => line.startsWith("- ["));
+  assert.equal(timelineLines.length, 2);
+});
+
+test("machine labels with YAML-special chars round-trip through the digest", () => {
+  const body = composeActivityDigestBody("2026-03-10", "UTC", DAY);
+  const meta = composeActivityDigestMeta("2026-03-10", ["alpha, beta", "macstudio"], DAY, body);
+  const parsed = parseActivityDigest(serializeActivityDigest(meta, body));
+  assert.deepEqual(parsed?.meta.machines, ["alpha, beta", "macstudio"]);
+});