@remnic/core 9.69.4 → 9.69.6

package/dist/source-agent-qualifier.js

@@ -11,27 +11,27 @@ import "./chunk-VEWZZM3H.js";
 import "./chunk-J3JEW5CT.js";
 import "./chunk-5TBO7CDR.js";
 import "./chunk-EMDLM3LW.js";
-import "./chunk-RFYKLES2.js";
+import "./chunk-6KQLDPKA.js";
 import "./chunk-3UXOZBHV.js";
 import "./chunk-ZXBTTMGZ.js";
-import "./chunk-PBSZQBFM.js";
+import "./chunk-IFHT77WK.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-4ZWCQJNM.js";
 import "./chunk-WVGXCBOC.js";
-import "./chunk-FNNWK7G7.js";
-import "./chunk-EZPBQVGZ.js";
+import "./chunk-ZET6A3OF.js";
+import "./chunk-JJAOVJ3E.js";
+import "./chunk-N37X5RU7.js";
 import "./chunk-NNBZS3DY.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-GIC6BASP.js";
 import "./chunk-YQNNHLCG.js";
-import "./chunk-6KTXE6A3.js";
-import "./chunk-N37X5RU7.js";
 import "./chunk-W7IGLX4G.js";
+import "./chunk-6KTXE6A3.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-227UFSEQ.js";
+import "./chunk-7RZJWZ46.js";
+import "./chunk-A7Q43EUZ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";
-import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-XXW32OL7.js";
 import "./chunk-S2HLHAZ4.js";

package/dist/standup/build.js

@@ -3,25 +3,25 @@ import {
   parseStandupDate,
   previousActiveDate,
   standupHelp
-} from "../chunk-TOUZM2RQ.js";
-import "../chunk-PBSZQBFM.js";
+} from "../chunk-AJFKQJQK.js";
+import "../chunk-IFHT77WK.js";
 import "../chunk-UHVXE24Y.js";
 import "../chunk-4ZWCQJNM.js";
 import "../chunk-WVGXCBOC.js";
-import "../chunk-FNNWK7G7.js";
-import "../chunk-EZPBQVGZ.js";
+import "../chunk-ZET6A3OF.js";
+import "../chunk-JJAOVJ3E.js";
+import "../chunk-N37X5RU7.js";
 import "../chunk-NNBZS3DY.js";
 import "../chunk-CYEPCZN5.js";
 import "../chunk-GIC6BASP.js";
 import "../chunk-YQNNHLCG.js";
-import "../chunk-6KTXE6A3.js";
-import "../chunk-N37X5RU7.js";
 import "../chunk-W7IGLX4G.js";
+import "../chunk-6KTXE6A3.js";
 import "../chunk-GUMZC2BO.js";
-import "../chunk-227UFSEQ.js";
+import "../chunk-7RZJWZ46.js";
+import "../chunk-A7Q43EUZ.js";
 import "../chunk-ET356KSB.js";
 import "../chunk-72A4L5JJ.js";
-import "../chunk-A7Q43EUZ.js";
 import "../chunk-S2V7RUCL.js";
 import "../chunk-XXW32OL7.js";
 import "../chunk-S2HLHAZ4.js";

package/dist/storage.js

@@ -14,24 +14,24 @@ import {
   parseFrontmatter,
   parseFrontmatterStringValue,
   serializeEntityFile
-} from "./chunk-PBSZQBFM.js";
+} from "./chunk-IFHT77WK.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-4ZWCQJNM.js";
 import "./chunk-WVGXCBOC.js";
-import "./chunk-FNNWK7G7.js";
-import "./chunk-EZPBQVGZ.js";
+import "./chunk-ZET6A3OF.js";
+import "./chunk-JJAOVJ3E.js";
+import "./chunk-N37X5RU7.js";
 import "./chunk-NNBZS3DY.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-GIC6BASP.js";
 import "./chunk-YQNNHLCG.js";
-import "./chunk-6KTXE6A3.js";
-import "./chunk-N37X5RU7.js";
 import "./chunk-W7IGLX4G.js";
+import "./chunk-6KTXE6A3.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-227UFSEQ.js";
+import "./chunk-7RZJWZ46.js";
+import "./chunk-A7Q43EUZ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";
-import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-XXW32OL7.js";
 import "./chunk-S2HLHAZ4.js";

package/dist/support-passport/index.js

@@ -4,7 +4,7 @@ import {
   SUPPORT_PASSPORT_MODEL_RESULT_PATH,
   SupportPassportModelBridge,
   parseSupportPassportModelJob
-} from "../chunk-V63BBOFS.js";
+} from "../chunk-DD2BKHSD.js";
 import {
   DEFAULT_SUPPORT_PASSPORT_CONFIG,
   parseSupportPassportConfig
@@ -14,8 +14,8 @@ import {
   buildSupportPassportPublicRequestHandler,
   composeSupportPassportExternalRequestHandlers,
   normalizeSupportPassportNetworkAddress
-} from "../chunk-OM4VYQPH.js";
-import "../chunk-LXBVTRBG.js";
+} from "../chunk-6EXRODDF.js";
+import "../chunk-OUAK37ID.js";
 import {
   SUPPORT_PASSPORT_DRAFT_MAX_CONTENT_CHARACTERS,
   SUPPORT_PASSPORT_DRAFT_MAX_MEMORIES,
@@ -56,14 +56,14 @@ import {
   notifySupportPassportCommitted,
   resolveSupportPassportModelRoutePlan,
   syncDirectoryForDurability
-} from "../chunk-UFY4G6EC.js";
+} from "../chunk-XOGYSWQZ.js";
 import "../chunk-GDASG7NC.js";
 import "../chunk-GDB4J2H3.js";
-import "../chunk-J2R275FN.js";
+import "../chunk-7DXW5V2W.js";
 import "../chunk-QJCWK2A7.js";
 import "../chunk-VQ7B2Q6M.js";
 import "../chunk-PJSK6OJM.js";
-import "../chunk-FGORNFTZ.js";
+import "../chunk-NM5EOKN7.js";
 import "../chunk-GNVZQ5JN.js";
 import "../chunk-YN2UN7N3.js";
 import "../chunk-5QZR2RA3.js";
@@ -74,7 +74,7 @@ import "../chunk-H7XKCNR6.js";
 import "../chunk-H6RSANGQ.js";
 import "../chunk-SOBJ6NEY.js";
 import "../chunk-LK4TOYPU.js";
-import "../chunk-EJCKJS4X.js";
+import "../chunk-R3YVNAJB.js";
 import "../chunk-CVILPI77.js";
 import "../chunk-2HIJHXB3.js";
 import "../chunk-AQEJKOKI.js";
@@ -95,37 +95,37 @@ import "../chunk-LTHVM4XN.js";
 import "../chunk-X5YYSAZX.js";
 import "../chunk-C37ZRXX7.js";
 import "../chunk-7ZNJN5WZ.js";
-import "../chunk-WRPRUMUI.js";
-import "../chunk-MU4FAKGV.js";
-import "../chunk-D65XGENZ.js";
-import "../chunk-3HEYRDNF.js";
+import "../chunk-SZZGVXKC.js";
+import "../chunk-HDEQRI2O.js";
+import "../chunk-YPNTBYEV.js";
+import "../chunk-EJJ57PTY.js";
 import "../chunk-UFGFMWAD.js";
-import "../chunk-RFYKLES2.js";
+import "../chunk-6KQLDPKA.js";
 import "../chunk-3UXOZBHV.js";
 import "../chunk-ZXBTTMGZ.js";
 import "../chunk-BIJAWZYW.js";
 import "../chunk-LXY5VVGM.js";
 import "../chunk-2LSZVONP.js";
 import "../chunk-DEUNUKTD.js";
-import "../chunk-DT7LKLET.js";
-import "../chunk-PBSZQBFM.js";
+import "../chunk-MVH7YAWY.js";
+import "../chunk-IFHT77WK.js";
 import "../chunk-UHVXE24Y.js";
 import "../chunk-4ZWCQJNM.js";
 import "../chunk-WVGXCBOC.js";
-import "../chunk-FNNWK7G7.js";
-import "../chunk-EZPBQVGZ.js";
+import "../chunk-ZET6A3OF.js";
+import "../chunk-JJAOVJ3E.js";
+import "../chunk-N37X5RU7.js";
 import "../chunk-NNBZS3DY.js";
 import "../chunk-CYEPCZN5.js";
 import "../chunk-GIC6BASP.js";
 import "../chunk-YQNNHLCG.js";
-import "../chunk-6KTXE6A3.js";
-import "../chunk-N37X5RU7.js";
 import "../chunk-W7IGLX4G.js";
+import "../chunk-6KTXE6A3.js";
 import "../chunk-GUMZC2BO.js";
-import "../chunk-227UFSEQ.js";
+import "../chunk-7RZJWZ46.js";
+import "../chunk-A7Q43EUZ.js";
 import "../chunk-ET356KSB.js";
 import "../chunk-72A4L5JJ.js";
-import "../chunk-A7Q43EUZ.js";
 import "../chunk-S2V7RUCL.js";
 import "../chunk-XXW32OL7.js";
 import "../chunk-S2HLHAZ4.js";
@@ -193,10 +193,10 @@ import "../chunk-6Q3ZTEF6.js";
 import "../chunk-YCVB7X56.js";
 import "../chunk-PQVCH2AE.js";
 import "../chunk-PJKTFXE2.js";
-import "../chunk-IPLYGWQF.js";
-import "../chunk-J4EB7DNW.js";
+import "../chunk-VDX2J7OX.js";
 import "../chunk-WEHSQBFR.js";
-import "../chunk-X7Y7WX73.js";
+import "../chunk-DQEMWVMT.js";
+import "../chunk-J4EB7DNW.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";

package/dist/transfer/autodetect.js

@@ -4,8 +4,8 @@ import {
 import "../chunk-2DL3OFLD.js";
 import "../chunk-G4IAEX6D.js";
 import "../chunk-765K3SAT.js";
-import "../chunk-J4EB7DNW.js";
 import "../chunk-WEHSQBFR.js";
+import "../chunk-J4EB7DNW.js";
 import "../chunk-UI3NYK34.js";
 import "../chunk-GCGJW34D.js";
 import "../chunk-PZ5AY32C.js";

package/dist/transfer/backup.js

@@ -1,9 +1,9 @@
 import {
   backupMemoryDir
-} from "../chunk-2NLLXCJG.js";
+} from "../chunk-BXLOS5AJ.js";
 import "../chunk-765K3SAT.js";
+import "../chunk-DQEMWVMT.js";
 import "../chunk-J4EB7DNW.js";
-import "../chunk-X7Y7WX73.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";

package/dist/transfer/capsule-export.js

@@ -1,10 +1,10 @@
 import {
   exportCapsule,
   isValidCapsuleSince
-} from "../chunk-IPLYGWQF.js";
-import "../chunk-J4EB7DNW.js";
+} from "../chunk-VDX2J7OX.js";
 import "../chunk-WEHSQBFR.js";
-import "../chunk-X7Y7WX73.js";
+import "../chunk-DQEMWVMT.js";
+import "../chunk-J4EB7DNW.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";

package/dist/transfer/capsule-import.js

@@ -1,6 +1,6 @@
 import {
   importCapsule
-} from "../chunk-J2R275FN.js";
+} from "../chunk-7DXW5V2W.js";
 import "../chunk-U62OK7BB.js";
 import "../chunk-XCB6QDL6.js";
 import "../chunk-RBOJCG4T.js";
@@ -10,7 +10,7 @@ import "../chunk-6CIAGZ6X.js";
 import "../chunk-C64XATK7.js";
 import "../chunk-42JKGUFJ.js";
 import "../chunk-WEHSQBFR.js";
-import "../chunk-X7Y7WX73.js";
+import "../chunk-DQEMWVMT.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";

package/dist/transfer/export-okf.js

@@ -3,30 +3,30 @@ import {
   OKF_LOG_TRUNCATION_MARKER,
   exportOkfBundle,
   parseIncludeStatus
-} from "../chunk-GH477IGR.js";
+} from "../chunk-NAB4MKTJ.js";
 import {
   OKF_EXPORT_VERSION
-} from "../chunk-VVE5SLO5.js";
+} from "../chunk-SKVSBTFQ.js";
 import "../chunk-D24OXEPB.js";
 import "../chunk-3UXOZBHV.js";
-import "../chunk-PBSZQBFM.js";
+import "../chunk-IFHT77WK.js";
 import "../chunk-UHVXE24Y.js";
 import "../chunk-4ZWCQJNM.js";
 import "../chunk-WVGXCBOC.js";
-import "../chunk-FNNWK7G7.js";
-import "../chunk-EZPBQVGZ.js";
+import "../chunk-ZET6A3OF.js";
+import "../chunk-JJAOVJ3E.js";
+import "../chunk-N37X5RU7.js";
 import "../chunk-NNBZS3DY.js";
 import "../chunk-CYEPCZN5.js";
 import "../chunk-GIC6BASP.js";
 import "../chunk-YQNNHLCG.js";
-import "../chunk-6KTXE6A3.js";
-import "../chunk-N37X5RU7.js";
 import "../chunk-W7IGLX4G.js";
+import "../chunk-6KTXE6A3.js";
 import "../chunk-GUMZC2BO.js";
-import "../chunk-227UFSEQ.js";
+import "../chunk-7RZJWZ46.js";
+import "../chunk-A7Q43EUZ.js";
 import "../chunk-ET356KSB.js";
 import "../chunk-72A4L5JJ.js";
-import "../chunk-A7Q43EUZ.js";
 import "../chunk-S2V7RUCL.js";
 import "../chunk-XXW32OL7.js";
 import "../chunk-S2HLHAZ4.js";

package/dist/verified-recall.js

@@ -1,26 +1,26 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-ASDK4GEV.js";
+} from "./chunk-MOUCCUET.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-PBSZQBFM.js";
+import "./chunk-IFHT77WK.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-4ZWCQJNM.js";
 import "./chunk-WVGXCBOC.js";
-import "./chunk-FNNWK7G7.js";
-import "./chunk-EZPBQVGZ.js";
+import "./chunk-ZET6A3OF.js";
+import "./chunk-JJAOVJ3E.js";
+import "./chunk-N37X5RU7.js";
 import "./chunk-NNBZS3DY.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-GIC6BASP.js";
 import "./chunk-YQNNHLCG.js";
-import "./chunk-6KTXE6A3.js";
-import "./chunk-N37X5RU7.js";
 import "./chunk-W7IGLX4G.js";
+import "./chunk-6KTXE6A3.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-227UFSEQ.js";
+import "./chunk-7RZJWZ46.js";
+import "./chunk-A7Q43EUZ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";
-import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-XXW32OL7.js";
 import "./chunk-S2HLHAZ4.js";

package/dist/who-knows-cli.js

@@ -4,26 +4,26 @@ import {
   renderWhoKnows,
   renderWhoKnowsJson,
   renderWhoKnowsText
-} from "./chunk-TFN3PPYO.js";
-import "./chunk-FGORNFTZ.js";
-import "./chunk-PBSZQBFM.js";
+} from "./chunk-TGDFKC7X.js";
+import "./chunk-NM5EOKN7.js";
+import "./chunk-IFHT77WK.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-4ZWCQJNM.js";
 import "./chunk-WVGXCBOC.js";
-import "./chunk-FNNWK7G7.js";
-import "./chunk-EZPBQVGZ.js";
+import "./chunk-ZET6A3OF.js";
+import "./chunk-JJAOVJ3E.js";
+import "./chunk-N37X5RU7.js";
 import "./chunk-NNBZS3DY.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-GIC6BASP.js";
 import "./chunk-YQNNHLCG.js";
-import "./chunk-6KTXE6A3.js";
-import "./chunk-N37X5RU7.js";
 import "./chunk-W7IGLX4G.js";
+import "./chunk-6KTXE6A3.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-227UFSEQ.js";
+import "./chunk-7RZJWZ46.js";
+import "./chunk-A7Q43EUZ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";
-import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-XXW32OL7.js";
 import "./chunk-S2HLHAZ4.js";

package/dist/who-knows.js

@@ -9,25 +9,25 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-FGORNFTZ.js";
-import "./chunk-PBSZQBFM.js";
+} from "./chunk-NM5EOKN7.js";
+import "./chunk-IFHT77WK.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-4ZWCQJNM.js";
 import "./chunk-WVGXCBOC.js";
-import "./chunk-FNNWK7G7.js";
-import "./chunk-EZPBQVGZ.js";
+import "./chunk-ZET6A3OF.js";
+import "./chunk-JJAOVJ3E.js";
+import "./chunk-N37X5RU7.js";
 import "./chunk-NNBZS3DY.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-GIC6BASP.js";
 import "./chunk-YQNNHLCG.js";
-import "./chunk-6KTXE6A3.js";
-import "./chunk-N37X5RU7.js";
 import "./chunk-W7IGLX4G.js";
+import "./chunk-6KTXE6A3.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-227UFSEQ.js";
+import "./chunk-7RZJWZ46.js";
+import "./chunk-A7Q43EUZ.js";
 import "./chunk-ET356KSB.js";
 import "./chunk-72A4L5JJ.js";
-import "./chunk-A7Q43EUZ.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-XXW32OL7.js";
 import "./chunk-S2HLHAZ4.js";

package/package.json

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

package/src/activity/index.ts

@@ -18,11 +18,13 @@ export * from "./timeline/index.js";
 export * from "./journal.js";
 export * from "./journal-vault-read.js";
 export * from "./journal-vault-prereq.js";
+export * from "./journal-vault-provenance.js";
 export { stripRemnicOwnedRegions } from "./journal-strip.js";
 export * from "./memory-gen.js";
 export * from "./privacy.js";
 export * from "./privacy-delete-plan.js";
 export * from "./privacy-status.js";
+export * from "./privacy-gate-resolve.js";
 export * from "./privacy-window.js";
 export * from "./vault-path.js";
 export * from "./vault-publish.js";
@@ -33,3 +35,4 @@ export * from "./vault-wikilink.js";
 export * from "./vault-region.js";
 export * from "./vault-suffix.js";
 export * from "./vault-join.js";
+export * from "./vault-dry-run.js";

package/src/activity/journal-vault-provenance.test.ts

@@ -0,0 +1,120 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { buildJournalMemoryProvenance } from "./journal-vault-provenance.js";
+
+test("vault source produces the documented tags, attributes, and validAt", () => {
+  assert.deepEqual(
+    buildJournalMemoryProvenance({ source: "vault", date: "2026-08-01" }),
+    {
+      tags: ["journal", "journal-day:2026-08-01"],
+      structuredAttributes: { journalSource: "vault" },
+      validAt: "2026-08-01T00:00:00.000Z",
+    },
+  );
+});
+
+test("file source differs only in the attribute value", () => {
+  const vault = buildJournalMemoryProvenance({ source: "vault", date: "2026-08-01" });
+  const file = buildJournalMemoryProvenance({ source: "file", date: "2026-08-01" });
+  assert.deepEqual(file.structuredAttributes, { journalSource: "file" });
+  assert.deepEqual(file.tags, vault.tags);
+  assert.equal(file.validAt, vault.validAt);
+});
+
+test("every structured attribute value is a string", () => {
+  for (const source of ["file", "vault"] as const) {
+    const { structuredAttributes } = buildJournalMemoryProvenance({
+      source,
+      date: "2026-08-01",
+    });
+    for (const [key, value] of Object.entries(structuredAttributes)) {
+      assert.equal(typeof value, "string", `${key} must be a string`);
+    }
+  }
+});
+
+test("unknown source throws RangeError naming source", () => {
+  for (const source of ["memoryDir", "vault ", "Vault", ""]) {
+    assert.throws(
+      () => buildJournalMemoryProvenance({ source, date: "2026-08-01" }),
+      RangeError,
+    );
+    assert.throws(
+      () => buildJournalMemoryProvenance({ source, date: "2026-08-01" }),
+      /source/,
+    );
+  }
+});
+
+test("non-string source is rejected, not defaulted", () => {
+  assert.throws(
+    () =>
+      buildJournalMemoryProvenance({
+        source: undefined as unknown as string,
+        date: "2026-08-01",
+      }),
+    RangeError,
+  );
+});
+
+test("malformed date throws RangeError naming date", () => {
+  for (const date of [
+    "2026-8-1",
+    "2026-02-30",
+    "2026-13-01",
+    "2026-02-29",
+    "",
+    " 2026-08-01",
+    "2026-08-01 ",
+    "0026-01-01",
+  ]) {
+    assert.throws(
+      () => buildJournalMemoryProvenance({ source: "vault", date }),
+      RangeError,
+    );
+    assert.throws(
+      () => buildJournalMemoryProvenance({ source: "vault", date }),
+      /date/,
+    );
+  }
+});
+
+test("non-string date is rejected, not defaulted", () => {
+  assert.throws(
+    () =>
+      buildJournalMemoryProvenance({
+        source: "vault",
+        date: 20260801 as unknown as string,
+      }),
+    RangeError,
+  );
+});
+
+test("real leap day is accepted", () => {
+  assert.equal(
+    buildJournalMemoryProvenance({ source: "vault", date: "2024-02-29" }).validAt,
+    "2024-02-29T00:00:00.000Z",
+  );
+});
+
+test("tags are exactly two entries in order", () => {
+  const { tags } = buildJournalMemoryProvenance({ source: "vault", date: "2026-08-01" });
+  assert.equal(tags.length, 2);
+  assert.deepEqual(tags, ["journal", "journal-day:2026-08-01"]);
+});
+
+test("two calls are deep-equal and share no mutable state", () => {
+  const first = buildJournalMemoryProvenance({ source: "vault", date: "2026-08-01" });
+  first.tags.push("mutated");
+  first.structuredAttributes.journalSource = "mutated";
+  first.validAt = "mutated";
+  assert.deepEqual(
+    buildJournalMemoryProvenance({ source: "vault", date: "2026-08-01" }),
+    {
+      tags: ["journal", "journal-day:2026-08-01"],
+      structuredAttributes: { journalSource: "vault" },
+      validAt: "2026-08-01T00:00:00.000Z",
+    },
+  );
+});

package/src/activity/journal-vault-provenance.ts

@@ -0,0 +1,67 @@
+/**
+ * Build provenance for journal-derived memories (issue #1987).
+ *
+ * Pure: no I/O, no clock — the day comes from the caller. The source is
+ * validated through the journal-source parser, so `structuredAttributes.
+ * journalSource` is always a canonical journal source value ("file" |
+ * "vault"), never a re-declared copy of the allow-list. Exported helper;
+ * caller wiring into journal memory generation is a later slice.
+ */
+import { resolveJournalSource } from "./journal-source.js";
+
+export interface JournalMemoryProvenance {
+  tags: string[];
+  structuredAttributes: Record<string, string>;
+  validAt: string;
+}
+
+const DAY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+
+export function buildJournalMemoryProvenance(input: {
+  /** Journal source; must be one of the journal-source allow-list values. */
+  source: string;
+  /** Journal day, YYYY-MM-DD. */
+  date: string;
+}): JournalMemoryProvenance {
+  if (typeof input.source !== "string") {
+    throw new RangeError("journal provenance source must be a string");
+  }
+  const resolved = resolveJournalSource({
+    source: input.source,
+    // Provenance never consumes the heading; vault mode just requires a
+    // non-empty one to resolve.
+    heading: "journal",
+  });
+  if (!resolved.ok) {
+    throw new RangeError(
+      `journal provenance source must be one of "file", "vault": ${JSON.stringify(input.source)}`,
+    );
+  }
+
+  if (typeof input.date !== "string" || !DAY_PATTERN.test(input.date)) {
+    throw new RangeError(
+      `journal provenance date must be exactly YYYY-MM-DD: ${JSON.stringify(input.date)}`,
+    );
+  }
+  const [year, month, day] = input.date
+    .split("-")
+    .map(Number) as [number, number, number];
+  // Round-trip through UTC rejects non-calendar days (2026-02-30) and the
+  // two-digit-year Date.UTC remap (0026 -> 1926) without reading a clock.
+  const utc = new Date(Date.UTC(year, month - 1, day));
+  if (
+    utc.getUTCFullYear() !== year ||
+    utc.getUTCMonth() !== month - 1 ||
+    utc.getUTCDate() !== day
+  ) {
+    throw new RangeError(
+      `journal provenance date must be a real calendar day: ${input.date}`,
+    );
+  }
+
+  return {
+    tags: ["journal", `journal-day:${input.date}`],
+    structuredAttributes: { journalSource: resolved.mode },
+    validAt: `${input.date}T00:00:00.000Z`,
+  };
+}