@remnic/core 9.3.648 → 9.3.649

package/dist/{chunk-6BNFVP7Y.js → chunk-RZOBQ23O.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-ZRWB5D4H.js";
 import {
   TranscriptManager
-} from "./chunk-XUGQQPGO.js";
+} from "./chunk-AGRPGAKR.js";
 import {
   resolveCommitmentLedgerDir,
   validateCommitmentLedgerEntry
@@ -268,4 +268,4 @@ export {
   recordResumeBundle,
   getResumeBundleStatus
 };
-//# sourceMappingURL=chunk-6BNFVP7Y.js.map
+//# sourceMappingURL=chunk-RZOBQ23O.js.map

package/dist/{chunk-TWVRDGTX.js → chunk-XUGVP7ZU.js}

@@ -231,7 +231,7 @@ import {
 } from "./chunk-ZRWB5D4H.js";
 import {
   TranscriptManager
-} from "./chunk-XUGQQPGO.js";
+} from "./chunk-AGRPGAKR.js";
 import {
   NamespaceStorageRouter
 } from "./chunk-D6WVJIS3.js";
@@ -14302,4 +14302,4 @@ export {
   resolvePersistedMemoryRelativePath,
   Orchestrator
 };
-//# sourceMappingURL=chunk-TWVRDGTX.js.map
+//# sourceMappingURL=chunk-XUGVP7ZU.js.map

package/dist/cli.js

@@ -89,7 +89,7 @@ import {
   runWorkProductStatusCliCommand,
   runWorkProjectCliCommand,
   runWorkTaskCliCommand
-} from "./chunk-AEIZEAP7.js";
+} from "./chunk-FQYFMIKG.js";
 import "./chunk-MC4FJXPA.js";
 import "./chunk-LQHDIS7L.js";
 import "./chunk-7F7Z6MOS.js";
@@ -119,7 +119,7 @@ import "./chunk-OUELRE5E.js";
 import "./chunk-GQL52GQ5.js";
 import "./chunk-EVWIEEKZ.js";
 import "./chunk-OTC2KOZ2.js";
-import "./chunk-6BNFVP7Y.js";
+import "./chunk-RZOBQ23O.js";
 import "./chunk-WLGE6KEO.js";
 import "./chunk-TGQ2NTWH.js";
 import "./chunk-ZT6R3WR3.js";
@@ -140,7 +140,7 @@ import "./chunk-UMKPSD35.js";
 import "./chunk-W4RVMTHR.js";
 import "./chunk-4BISW7RX.js";
 import "./chunk-ZRWB5D4H.js";
-import "./chunk-XUGQQPGO.js";
+import "./chunk-AGRPGAKR.js";
 import "./chunk-S4DDLTPX.js";
 import "./chunk-SFQ6QNL7.js";
 import "./chunk-D6WVJIS3.js";

package/dist/index.js

@@ -94,7 +94,7 @@ import {
   registerTrainingExportAdapter,
   runBulkImportCliCommand,
   runWearablesCliCommand
-} from "./chunk-AEIZEAP7.js";
+} from "./chunk-FQYFMIKG.js";
 import "./chunk-MC4FJXPA.js";
 import "./chunk-LQHDIS7L.js";
 import "./chunk-7F7Z6MOS.js";
@@ -137,7 +137,7 @@ import {
 import "./chunk-GQL52GQ5.js";
 import "./chunk-EVWIEEKZ.js";
 import "./chunk-OTC2KOZ2.js";
-import "./chunk-6BNFVP7Y.js";
+import "./chunk-RZOBQ23O.js";
 import {
   parseXrayBudgetFlag,
   parseXrayCliOptions
@@ -191,7 +191,7 @@ import {
   saveTaxonomy,
   validateSlug,
   validateTaxonomy
-} from "./chunk-TWVRDGTX.js";
+} from "./chunk-XUGVP7ZU.js";
 import {
   WEARABLE_SOURCE_PREFIX,
   buildExtractionTurns,
@@ -389,7 +389,7 @@ import "./chunk-UMKPSD35.js";
 import "./chunk-W4RVMTHR.js";
 import "./chunk-4BISW7RX.js";
 import "./chunk-ZRWB5D4H.js";
-import "./chunk-XUGQQPGO.js";
+import "./chunk-AGRPGAKR.js";
 import {
   SESSION_CHANNEL_TYPE,
   legacyParserReadbackDir,

package/dist/orchestrator.js

@@ -28,7 +28,7 @@ import {
   sanitizeSessionKeyForFilename,
   shouldFilterLifecycleRecallCandidate,
   summarizeGraphShadowComparison
-} from "./chunk-TWVRDGTX.js";
+} from "./chunk-XUGVP7ZU.js";
 import "./chunk-DDRNDPX4.js";
 import "./chunk-7HYPN2GC.js";
 import "./chunk-666A3MOW.js";
@@ -107,7 +107,7 @@ import "./chunk-UMKPSD35.js";
 import "./chunk-W4RVMTHR.js";
 import "./chunk-4BISW7RX.js";
 import "./chunk-ZRWB5D4H.js";
-import "./chunk-XUGQQPGO.js";
+import "./chunk-AGRPGAKR.js";
 import "./chunk-S4DDLTPX.js";
 import "./chunk-SFQ6QNL7.js";
 import "./chunk-D6WVJIS3.js";

package/dist/resume-bundles.js

@@ -4,9 +4,9 @@ import {
   recordResumeBundle,
   resolveResumeBundleDir,
   validateResumeBundle
-} from "./chunk-6BNFVP7Y.js";
+} from "./chunk-RZOBQ23O.js";
 import "./chunk-ZRWB5D4H.js";
-import "./chunk-XUGQQPGO.js";
+import "./chunk-AGRPGAKR.js";
 import "./chunk-S4DDLTPX.js";
 import "./chunk-KFY3SGN7.js";
 import "./chunk-LMDRGRJ2.js";

package/dist/transcript.d.ts

@@ -3,6 +3,23 @@ import { SessionIntegrityReport } from './session-integrity.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 
+/**
+ * Compute the half-open UTC instant range `[start, end)` that covers an entire
+ * calendar day, suitable for {@link TranscriptManager.readRange}.
+ *
+ * `readRange` filters with an EXCLUSIVE upper bound (`entryTime < end`, CLAUDE.md
+ * rule #35 / AGENTS.md rule 23). The end is therefore the NEXT day's
+ * `00:00:00Z`, not `${date}T23:59:59Z`: a literal `23:59:59Z` end (== `.000Z`)
+ * would drop any entry stamped in the final second of the day
+ * (`23:59:59.000Z`–`23:59:59.999Z`). Using the next day's midnight keeps the
+ * `[start, end)` semantics intact while including the whole day.
+ *
+ * @param date - A `YYYY-MM-DD` calendar day (UTC).
+ */
+declare function utcDayRange(date: string): {
+    start: string;
+    end: string;
+};
 /**
  * Manages conversation transcript storage, checkpointing, and recall formatting.
  *
@@ -196,4 +213,4 @@ declare class TranscriptManager {
     }>;
 }
 
-export { TranscriptManager };
+export { TranscriptManager, utcDayRange };

package/dist/transcript.js

@@ -1,12 +1,14 @@
 import {
-  TranscriptManager
-} from "./chunk-XUGQQPGO.js";
+  TranscriptManager,
+  utcDayRange
+} from "./chunk-AGRPGAKR.js";
 import "./chunk-S4DDLTPX.js";
 import "./chunk-KFY3SGN7.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-PZ5AY32C.js";
 export {
-  TranscriptManager
+  TranscriptManager,
+  utcDayRange
 };
 //# sourceMappingURL=transcript.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.3.648",
+  "version": "9.3.649",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",

package/src/cli.ts

@@ -5,6 +5,7 @@ import { createHash } from "node:crypto";
 import type { Readable, Writable } from "node:stream";
 import type { Orchestrator } from "./orchestrator.js";
 import { ThreadingManager } from "./threading.js";
+import { utcDayRange } from "./transcript.js";
 import { runWearablesCliCommand } from "./wearables/cli.js";
 import type {
   BehaviorSignalEvent,
@@ -8630,12 +8631,11 @@ export function registerCli(
           }
 
           if (date) {
-            // Read specific date
-            const entries = await orchestrator.transcript.readRange(
-              `${date}T00:00:00Z`,
-              `${date}T23:59:59Z`,
-              channel,
-            );
+            // Read specific date. Use a half-open [start, next-day-00:00:00Z)
+            // window so `readRange`'s exclusive upper bound still covers the
+            // final second of the day (rule #35).
+            const { start, end } = utcDayRange(date);
+            const entries = await orchestrator.transcript.readRange(start, end, channel);
             console.log(formatTranscript(entries));
           } else if (recent) {
             // Parse duration (e.g., "12h", "30m")
@@ -8643,13 +8643,11 @@ export function registerCli(
             const entries = await orchestrator.transcript.readRecent(hours, channel);
             console.log(formatTranscript(entries));
           } else {
-            // Default: show today's transcript
+            // Default: show today's transcript. Same half-open day window as
+            // the --date branch so the final second of the day is included.
             const today = new Date().toISOString().slice(0, 10);
-            const entries = await orchestrator.transcript.readRange(
-              `${today}T00:00:00Z`,
-              `${today}T23:59:59Z`,
-              channel,
-            );
+            const { start, end } = utcDayRange(today);
+            const entries = await orchestrator.transcript.readRange(start, end, channel);
             console.log(formatTranscript(entries));
           }
         });

package/src/transcript-day-range.test.ts

@@ -0,0 +1,101 @@
+/**
+ * Tests for the CLI transcript day-view window helper `utcDayRange`.
+ *
+ * The `transcript --date <day>` and default "today" CLI views read a single
+ * calendar day via {@link TranscriptManager.readRange}, which uses a half-open
+ * `[start, end)` interval (`entryTime < end`, CLAUDE.md rule #35). The day end
+ * must therefore be the NEXT day's `00:00:00Z`, not `${date}T23:59:59Z`:
+ * a literal `23:59:59Z` end (== `.000Z`) silently drops any entry stamped in
+ * the final second of the day (`23:59:59.000Z`–`23:59:59.999Z`).
+ *
+ * (Pre-existing boundary gap flagged as a P2 on PR #1507, fixed out of band.)
+ */
+
+import assert from "node:assert/strict";
+import { mkdtemp, realpath, rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import test from "node:test";
+
+import { TranscriptManager, utcDayRange } from "./transcript.js";
+import type { PluginConfig, TranscriptEntry } from "./types.js";
+
+function makeConfig(memoryDir: string): PluginConfig {
+  // TranscriptManager only reads memoryDir + transcriptSkipChannelTypes.
+  return {
+    memoryDir,
+    transcriptSkipChannelTypes: [],
+  } as unknown as PluginConfig;
+}
+
+// On macOS `os.tmpdir()` is a `/var/folders/...` symlink to `/private/var/...`.
+// Canonicalize the test root upfront (issue #691 symlink convention).
+async function makeMemoryDir(): Promise<string> {
+  return realpath(await mkdtemp(path.join(os.tmpdir(), "remnic-tx-dayrange-")));
+}
+
+function entryAt(timestamp: string, turnId: string): TranscriptEntry {
+  return {
+    sessionKey: "agent:generalist:main",
+    turnId,
+    role: "user",
+    content: `content-${turnId}`,
+    timestamp,
+  } as TranscriptEntry;
+}
+
+// ── utcDayRange: half-open [start, next-day-00:00:00Z) ───────────────────────
+
+test("utcDayRange end is the next day's 00:00:00Z (half-open day window)", () => {
+  assert.deepEqual(utcDayRange("2025-03-15"), {
+    start: "2025-03-15T00:00:00Z",
+    end: "2025-03-16T00:00:00Z",
+  });
+});
+
+test("utcDayRange rolls over month boundaries", () => {
+  assert.deepEqual(utcDayRange("2025-01-31"), {
+    start: "2025-01-31T00:00:00Z",
+    end: "2025-02-01T00:00:00Z",
+  });
+});
+
+test("utcDayRange rolls over leap-day and year boundaries", () => {
+  assert.deepEqual(utcDayRange("2024-02-28"), {
+    start: "2024-02-28T00:00:00Z",
+    end: "2024-02-29T00:00:00Z",
+  });
+  assert.deepEqual(utcDayRange("2025-12-31"), {
+    start: "2025-12-31T00:00:00Z",
+    end: "2026-01-01T00:00:00Z",
+  });
+});
+
+// ── Day-view range includes the final second of the day (the bug fix) ────────
+
+test("day-view range returns an entry stamped at 23:59:59.500Z of the queried day", async () => {
+  const memoryDir = await makeMemoryDir();
+  try {
+    const tm = new TranscriptManager(makeConfig(memoryDir));
+    const date = "2025-03-15";
+    const channel = "agent:generalist:main";
+
+    // Entry in the final second of the day — dropped by the old
+    // `${date}T23:59:59Z` (== `.000Z`) exclusive upper bound.
+    await tm.append(entryAt(`${date}T23:59:59.500Z`, "final-second"));
+    // Midday control entry, comfortably inside the window.
+    await tm.append(entryAt(`${date}T12:00:00.000Z`, "midday"));
+    // Start-of-next-day entry must stay OUT — the upper bound is exclusive
+    // (`[start, end)`, rule #35), so `nextDate T00:00:00.000Z` is not the
+    // queried day.
+    await tm.append(entryAt("2025-03-16T00:00:00.000Z", "next-day"));
+
+    const { start, end } = utcDayRange(date);
+    const entries = await tm.readRange(start, end, channel);
+    const ids = entries.map((e) => e.turnId).sort();
+
+    assert.deepEqual(ids, ["final-second", "midday"]);
+  } finally {
+    await rm(memoryDir, { recursive: true, force: true });
+  }
+});

package/src/transcript.ts

@@ -33,6 +33,32 @@ function makeRawLineDeduper(): (rawLine: string) => boolean {
   };
 }
 
+/**
+ * Compute the half-open UTC instant range `[start, end)` that covers an entire
+ * calendar day, suitable for {@link TranscriptManager.readRange}.
+ *
+ * `readRange` filters with an EXCLUSIVE upper bound (`entryTime < end`, CLAUDE.md
+ * rule #35 / AGENTS.md rule 23). The end is therefore the NEXT day's
+ * `00:00:00Z`, not `${date}T23:59:59Z`: a literal `23:59:59Z` end (== `.000Z`)
+ * would drop any entry stamped in the final second of the day
+ * (`23:59:59.000Z`–`23:59:59.999Z`). Using the next day's midnight keeps the
+ * `[start, end)` semantics intact while including the whole day.
+ *
+ * @param date - A `YYYY-MM-DD` calendar day (UTC).
+ */
+export function utcDayRange(date: string): { start: string; end: string } {
+  const start = `${date}T00:00:00Z`;
+  const startMs = Date.parse(start);
+  if (Number.isNaN(startMs)) {
+    // Malformed date: preserve the pre-existing "empty range" behavior (an
+    // unparseable bound makes `readRange` match nothing) rather than throwing.
+    return { start, end: start };
+  }
+  const next = new Date(startMs);
+  next.setUTCDate(next.getUTCDate() + 1);
+  return { start, end: `${next.toISOString().slice(0, 10)}T00:00:00Z` };
+}
+
 /**
  * Manages conversation transcript storage, checkpointing, and recall formatting.
  *