@remnic/core 9.66.2 → 9.66.4

package/dist/support-passport/index.js

@@ -4,7 +4,7 @@ import {
   SUPPORT_PASSPORT_MODEL_RESULT_PATH,
   SupportPassportModelBridge,
   parseSupportPassportModelJob
-} from "../chunk-F4W5HTED.js";
+} from "../chunk-K3CQQNMX.js";
 import {
   DEFAULT_SUPPORT_PASSPORT_CONFIG,
   parseSupportPassportConfig
@@ -14,8 +14,8 @@ import {
   buildSupportPassportPublicRequestHandler,
   composeSupportPassportExternalRequestHandlers,
   normalizeSupportPassportNetworkAddress
-} from "../chunk-ER2UPUMG.js";
-import "../chunk-2VZHB5US.js";
+} from "../chunk-562Q236T.js";
+import "../chunk-NTZ3452G.js";
 import {
   SUPPORT_PASSPORT_DRAFT_MAX_CONTENT_CHARACTERS,
   SUPPORT_PASSPORT_DRAFT_MAX_MEMORIES,
@@ -56,17 +56,17 @@ import {
   notifySupportPassportCommitted,
   resolveSupportPassportModelRoutePlan,
   syncDirectoryForDurability
-} from "../chunk-B4B3QDV3.js";
+} from "../chunk-4EX26ZS3.js";
 import "../chunk-GDASG7NC.js";
 import "../chunk-GDB4J2H3.js";
-import "../chunk-J2R275FN.js";
+import "../chunk-HQJM3BKH.js";
 import "../chunk-QJCWK2A7.js";
 import "../chunk-VQ7B2Q6M.js";
-import "../chunk-VSMSYDIH.js";
+import "../chunk-MARZW7DB.js";
 import "../chunk-PJSK6OJM.js";
-import "../chunk-5QZR2RA3.js";
 import "../chunk-GNVZQ5JN.js";
 import "../chunk-YN2UN7N3.js";
+import "../chunk-5QZR2RA3.js";
 import "../chunk-P5FPO2BR.js";
 import "../chunk-S4DDLTPX.js";
 import "../chunk-ZVZHG7AI.js";
@@ -74,16 +74,15 @@ import "../chunk-H7XKCNR6.js";
 import "../chunk-H6RSANGQ.js";
 import "../chunk-SOBJ6NEY.js";
 import "../chunk-LK4TOYPU.js";
-import "../chunk-6PUF7LUO.js";
+import "../chunk-Y5U72X3D.js";
 import "../chunk-CVILPI77.js";
 import "../chunk-2HIJHXB3.js";
 import "../chunk-AQEJKOKI.js";
 import "../chunk-HTP6XRUI.js";
-import "../chunk-UD7UNYRD.js";
 import "../chunk-IISBCCWR.js";
+import "../chunk-UD7UNYRD.js";
 import "../chunk-2YA5N2BY.js";
-import "../chunk-OUKBMQ2O.js";
-import "../chunk-LTHVM4XN.js";
+import "../chunk-PD66CVSD.js";
 import "../chunk-EI6V5UXY.js";
 import "../chunk-J3JEW5CT.js";
 import "../chunk-5TBO7CDR.js";
@@ -92,20 +91,21 @@ import "../chunk-NLE6TSLG.js";
 import "../chunk-IVKIODHO.js";
 import "../chunk-WKDFJXW5.js";
 import "../chunk-JUXOTY6J.js";
+import "../chunk-LTHVM4XN.js";
 import "../chunk-X5YYSAZX.js";
 import "../chunk-C37ZRXX7.js";
 import "../chunk-7ZNJN5WZ.js";
-import "../chunk-F2JXJABQ.js";
-import "../chunk-VKDBDJIX.js";
-import "../chunk-6545JDIM.js";
+import "../chunk-5BIOXQGN.js";
+import "../chunk-6L6V2OIX.js";
+import "../chunk-IHK5KTOC.js";
 import "../chunk-UFGFMWAD.js";
-import "../chunk-4PG2CKI6.js";
-import "../chunk-Y2YM4C75.js";
+import "../chunk-AQHDMA4A.js";
+import "../chunk-4BRBSON5.js";
 import "../chunk-ZXBTTMGZ.js";
-import "../chunk-BIJAWZYW.js";
-import "../chunk-LXY5VVGM.js";
+import "../chunk-YMOPYG3K.js";
 import "../chunk-2LSZVONP.js";
 import "../chunk-DEUNUKTD.js";
+import "../chunk-LXY5VVGM.js";
 import "../chunk-4NKIGSJM.js";
 import "../chunk-TB2MJRI6.js";
 import "../chunk-CSAKJVXW.js";
@@ -113,25 +113,25 @@ import "../chunk-K2XUWZBM.js";
 import "../chunk-OD4FM2U7.js";
 import "../chunk-ZY2MNJR6.js";
 import "../chunk-TBBDFYXW.js";
-import "../chunk-WKWY7YF3.js";
-import "../chunk-DSEHPUID.js";
+import "../chunk-F5FHDDOV.js";
+import "../chunk-5C3OQ253.js";
 import "../chunk-UHVXE24Y.js";
 import "../chunk-4ZWCQJNM.js";
 import "../chunk-WVGXCBOC.js";
-import "../chunk-OERZXNSK.js";
-import "../chunk-6BYJQ3L2.js";
-import "../chunk-YQNNHLCG.js";
-import "../chunk-6KTXE6A3.js";
+import "../chunk-JGXMA6HL.js";
+import "../chunk-BE4Y6GK6.js";
 import "../chunk-N37X5RU7.js";
 import "../chunk-NNBZS3DY.js";
 import "../chunk-CYEPCZN5.js";
 import "../chunk-GIC6BASP.js";
+import "../chunk-YQNNHLCG.js";
 import "../chunk-W7IGLX4G.js";
+import "../chunk-6KTXE6A3.js";
 import "../chunk-GUMZC2BO.js";
-import "../chunk-227UFSEQ.js";
-import "../chunk-ET356KSB.js";
+import "../chunk-LEPOP46W.js";
 import "../chunk-72A4L5JJ.js";
 import "../chunk-A7Q43EUZ.js";
+import "../chunk-ET356KSB.js";
 import "../chunk-S2V7RUCL.js";
 import "../chunk-XXW32OL7.js";
 import "../chunk-S2HLHAZ4.js";
@@ -180,7 +180,7 @@ import "../chunk-236PXYG7.js";
 import "../chunk-ZCUTSMR2.js";
 import "../chunk-QDW3E4RD.js";
 import "../chunk-M6L7HI7R.js";
-import "../chunk-PP7R754B.js";
+import "../chunk-GPFZFCRN.js";
 import "../chunk-NXH34IPL.js";
 import "../chunk-ZIKENA2C.js";
 import "../chunk-ME35HVDJ.js";
@@ -191,9 +191,9 @@ import "../chunk-PJKTFXE2.js";
 import "../chunk-W5BIQOAJ.js";
 import "../chunk-Z7L72ZHL.js";
 import "../chunk-4O4TKIXQ.js";
-import "../chunk-KQAFEZQX.js";
+import "../chunk-BUKK5SWA.js";
 import "../chunk-WEHSQBFR.js";
-import "../chunk-X7Y7WX73.js";
+import "../chunk-UVYI6VIX.js";
 import "../chunk-J4EB7DNW.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
@@ -205,7 +205,7 @@ import "../chunk-3QL24R5Y.js";
 import "../chunk-SYOIVK7K.js";
 import "../chunk-ZN7SMKAK.js";
 import "../chunk-LNEWDF2A.js";
-import "../chunk-O7ERGZDA.js";
+import "../chunk-I7NBTRLR.js";
 import "../chunk-DDX6KIXF.js";
 import "../chunk-ZRUEP4IK.js";
 import "../chunk-TNXNECAN.js";
@@ -256,11 +256,11 @@ import "../chunk-5FVVY2EB.js";
 import "../chunk-JDSVLVCG.js";
 import "../chunk-5GKPFL3S.js";
 import "../chunk-JAKIDQB2.js";
-import "../chunk-XJJYSX6F.js";
+import "../chunk-JCUG7AXZ.js";
 import "../chunk-UI3NYK34.js";
 import "../chunk-GCGJW34D.js";
-import "../chunk-AREGMX2J.js";
 import "../chunk-NBP4EX5N.js";
+import "../chunk-AREGMX2J.js";
 import "../chunk-LQWOFU6L.js";
 import "../chunk-P7FMDTKL.js";
 import "../chunk-MZWSOLMT.js";
@@ -278,9 +278,9 @@ import "../chunk-2Z24E5W2.js";
 import "../chunk-BTTPKDIL.js";
 import "../chunk-A2IYSXDQ.js";
 import "../chunk-P77QX3ID.js";
-import "../chunk-7K5Q6COX.js";
-import "../chunk-LBLXEFWK.js";
+import "../chunk-TVVEYCNW.js";
 import "../chunk-RFYAYKTD.js";
+import "../chunk-LBLXEFWK.js";
 import "../chunk-DJORULH3.js";
 import "../chunk-FF4KLI5W.js";
 import "../chunk-ET2CNMLD.js";

package/dist/transfer/backup.js

@@ -1,8 +1,8 @@
 import {
   backupMemoryDir
-} from "../chunk-2NLLXCJG.js";
+} from "../chunk-OWHERGF2.js";
 import "../chunk-765K3SAT.js";
-import "../chunk-X7Y7WX73.js";
+import "../chunk-UVYI6VIX.js";
 import "../chunk-J4EB7DNW.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";

package/dist/transfer/capsule-export.js

@@ -1,9 +1,9 @@
 import {
   exportCapsule,
   isValidCapsuleSince
-} from "../chunk-KQAFEZQX.js";
+} from "../chunk-BUKK5SWA.js";
 import "../chunk-WEHSQBFR.js";
-import "../chunk-X7Y7WX73.js";
+import "../chunk-UVYI6VIX.js";
 import "../chunk-J4EB7DNW.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";

package/dist/transfer/capsule-import.js

@@ -1,6 +1,6 @@
 import {
   importCapsule
-} from "../chunk-J2R275FN.js";
+} from "../chunk-HQJM3BKH.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-UVYI6VIX.js";
 import "../chunk-BJMBJZ2Y.js";
 import "../chunk-UKJAGEXH.js";
 import "../chunk-FP2373TW.js";

package/dist/transfer/export-okf.js

@@ -3,29 +3,29 @@ import {
   OKF_LOG_TRUNCATION_MARKER,
   exportOkfBundle,
   parseIncludeStatus
-} from "../chunk-W5IYHQA5.js";
+} from "../chunk-MS2I7JVN.js";
 import {
   OKF_EXPORT_VERSION
-} from "../chunk-LSR5LQXN.js";
+} from "../chunk-5VLXQFOS.js";
 import "../chunk-D24OXEPB.js";
-import "../chunk-DSEHPUID.js";
+import "../chunk-5C3OQ253.js";
 import "../chunk-UHVXE24Y.js";
 import "../chunk-4ZWCQJNM.js";
 import "../chunk-WVGXCBOC.js";
-import "../chunk-OERZXNSK.js";
-import "../chunk-6BYJQ3L2.js";
-import "../chunk-YQNNHLCG.js";
-import "../chunk-6KTXE6A3.js";
+import "../chunk-JGXMA6HL.js";
+import "../chunk-BE4Y6GK6.js";
 import "../chunk-N37X5RU7.js";
 import "../chunk-NNBZS3DY.js";
 import "../chunk-CYEPCZN5.js";
 import "../chunk-GIC6BASP.js";
+import "../chunk-YQNNHLCG.js";
 import "../chunk-W7IGLX4G.js";
+import "../chunk-6KTXE6A3.js";
 import "../chunk-GUMZC2BO.js";
-import "../chunk-227UFSEQ.js";
-import "../chunk-ET356KSB.js";
+import "../chunk-LEPOP46W.js";
 import "../chunk-72A4L5JJ.js";
 import "../chunk-A7Q43EUZ.js";
+import "../chunk-ET356KSB.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-OIDICRH7.js";
+} from "./chunk-W7O7PH5E.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-DSEHPUID.js";
+import "./chunk-5C3OQ253.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-4ZWCQJNM.js";
 import "./chunk-WVGXCBOC.js";
-import "./chunk-OERZXNSK.js";
-import "./chunk-6BYJQ3L2.js";
-import "./chunk-YQNNHLCG.js";
-import "./chunk-6KTXE6A3.js";
+import "./chunk-JGXMA6HL.js";
+import "./chunk-BE4Y6GK6.js";
 import "./chunk-N37X5RU7.js";
 import "./chunk-NNBZS3DY.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-GIC6BASP.js";
+import "./chunk-YQNNHLCG.js";
 import "./chunk-W7IGLX4G.js";
+import "./chunk-6KTXE6A3.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-227UFSEQ.js";
-import "./chunk-ET356KSB.js";
+import "./chunk-LEPOP46W.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
+import "./chunk-ET356KSB.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-AI5M4FVQ.js";
-import "./chunk-VSMSYDIH.js";
-import "./chunk-DSEHPUID.js";
+} from "./chunk-6DTQSLER.js";
+import "./chunk-MARZW7DB.js";
+import "./chunk-5C3OQ253.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-4ZWCQJNM.js";
 import "./chunk-WVGXCBOC.js";
-import "./chunk-OERZXNSK.js";
-import "./chunk-6BYJQ3L2.js";
-import "./chunk-YQNNHLCG.js";
-import "./chunk-6KTXE6A3.js";
+import "./chunk-JGXMA6HL.js";
+import "./chunk-BE4Y6GK6.js";
 import "./chunk-N37X5RU7.js";
 import "./chunk-NNBZS3DY.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-GIC6BASP.js";
+import "./chunk-YQNNHLCG.js";
 import "./chunk-W7IGLX4G.js";
+import "./chunk-6KTXE6A3.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-227UFSEQ.js";
-import "./chunk-ET356KSB.js";
+import "./chunk-LEPOP46W.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
+import "./chunk-ET356KSB.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-VSMSYDIH.js";
-import "./chunk-DSEHPUID.js";
+} from "./chunk-MARZW7DB.js";
+import "./chunk-5C3OQ253.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-4ZWCQJNM.js";
 import "./chunk-WVGXCBOC.js";
-import "./chunk-OERZXNSK.js";
-import "./chunk-6BYJQ3L2.js";
-import "./chunk-YQNNHLCG.js";
-import "./chunk-6KTXE6A3.js";
+import "./chunk-JGXMA6HL.js";
+import "./chunk-BE4Y6GK6.js";
 import "./chunk-N37X5RU7.js";
 import "./chunk-NNBZS3DY.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-GIC6BASP.js";
+import "./chunk-YQNNHLCG.js";
 import "./chunk-W7IGLX4G.js";
+import "./chunk-6KTXE6A3.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-227UFSEQ.js";
-import "./chunk-ET356KSB.js";
+import "./chunk-LEPOP46W.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
+import "./chunk-ET356KSB.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.66.2",
+  "version": "9.66.4",
   "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.66.2"
+    "@remnic/coding-graph": "^9.66.4"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/activity/dwell.test.ts

@@ -0,0 +1,28 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { sumDwellSeconds } from "./dwell.js";
+
+test("empty spans sum to 0", () => {
+  assert.equal(sumDwellSeconds([]), 0);
+});
+
+test("skips negative duration", () => {
+  assert.equal(
+    sumDwellSeconds([
+      { startMs: 0, endMs: 1000 },
+      { startMs: 2000, endMs: 1000 },
+    ]),
+    1,
+  );
+});
+
+test("two spans add without merging overlaps", () => {
+  assert.equal(
+    sumDwellSeconds([
+      { startMs: 0, endMs: 2000 },
+      { startMs: 1000, endMs: 3000 },
+    ]),
+    4,
+  );
+});

package/src/activity/dwell.ts

@@ -0,0 +1,22 @@
+/**
+ * Sum half-open activity dwell spans (issue #2053).
+ */
+export interface DwellSpan {
+  startMs: number;
+  endMs: number;
+}
+
+/**
+ * Sum span durations in seconds.
+ * Half-open `[startMs, endMs)`. Negative duration is skipped.
+ * Overlaps add. Empty input is 0.
+ */
+export function sumDwellSeconds(spans: readonly DwellSpan[]): number {
+  let total = 0;
+  for (const { startMs, endMs } of spans) {
+    const durationMs = endMs - startMs;
+    if (durationMs < 0) continue;
+    total += durationMs / 1000;
+  }
+  return total;
+}

package/src/activity/from-ms.test.ts

@@ -0,0 +1,25 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { parseFromMs } from "./from-ms.js";
+
+test("fromMs 0 is accepted", () => {
+  assert.equal(parseFromMs(0), 0);
+});
+
+test("epoch fromMs is accepted", () => {
+  const epoch = 1_700_000_000_000;
+  assert.equal(parseFromMs(epoch), epoch);
+});
+
+test("negative fromMs throws", () => {
+  assert.throws(() => parseFromMs(-1), /non-negative/);
+});
+
+test("NaN fromMs throws", () => {
+  assert.throws(() => parseFromMs(Number.NaN), /finite/);
+});
+
+test("non-number fromMs throws", () => {
+  assert.throws(() => parseFromMs("0"), /finite/);
+});

package/src/activity/from-ms.ts

@@ -0,0 +1,13 @@
+/**
+ * Parse activity window fromMs (issue #2053 leftover).
+ *
+ * Finite number ≥ 0 is returned. Negative, NaN, and non-number values throw.
+ */
+export function parseFromMs(value: unknown): number {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+    throw new RangeError(
+      `activity.fromMs must be a finite non-negative number; got ${JSON.stringify(value)}`,
+    );
+  }
+  return value;
+}

package/src/activity/heading-level.test.ts

@@ -0,0 +1,23 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { parseAtxHeadingLevel } from "./heading-level.js";
+
+test("h1 is level 1", () => {
+  assert.deepEqual(parseAtxHeadingLevel("# Title"), { ok: true, level: 1 });
+});
+
+test("h6 is level 6", () => {
+  assert.deepEqual(parseAtxHeadingLevel("###### Title"), { ok: true, level: 6 });
+});
+
+test("no hashes is not_heading", () => {
+  assert.deepEqual(parseAtxHeadingLevel("Title"), { ok: false, error: "not_heading" });
+});
+
+test("seven hashes is invalid_level", () => {
+  assert.deepEqual(parseAtxHeadingLevel("####### Title"), {
+    ok: false,
+    error: "invalid_level",
+  });
+});

package/src/activity/heading-level.ts

@@ -0,0 +1,21 @@
+/**
+ * Parse an ATX heading level (issue #1987 leftover).
+ *
+ * Trim, then walk leading `#` chars. 1-6 is a heading. No hashes is
+ * not_heading. Seven or more is invalid_level. No regex.
+ */
+
+export type ParseAtxHeadingLevelResult =
+  | { ok: true; level: number }
+  | { ok: false; error: "not_heading" | "invalid_level" };
+
+export function parseAtxHeadingLevel(line: string): ParseAtxHeadingLevelResult {
+  const trimmed = line.trim();
+  let level = 0;
+  while (level < trimmed.length && trimmed[level] === "#") {
+    level++;
+  }
+  if (level === 0) return { ok: false, error: "not_heading" };
+  if (level > 6) return { ok: false, error: "invalid_level" };
+  return { ok: true, level };
+}

package/src/activity/heading-title.test.ts

@@ -0,0 +1,21 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { parseAtxHeadingTitle } from "./heading-title.js";
+
+test("parseAtxHeadingTitle returns the title", () => {
+  assert.deepEqual(parseAtxHeadingTitle("## Journal"), { ok: true, title: "Journal" });
+  assert.deepEqual(parseAtxHeadingTitle("  # Title  "), { ok: true, title: "Title" });
+  assert.deepEqual(parseAtxHeadingTitle("###### Deep"), { ok: true, title: "Deep" });
+});
+
+test("parseAtxHeadingTitle rejects an empty title", () => {
+  assert.deepEqual(parseAtxHeadingTitle("#"), { ok: false, error: "empty_title" });
+  assert.deepEqual(parseAtxHeadingTitle("##   "), { ok: false, error: "empty_title" });
+});
+
+test("parseAtxHeadingTitle rejects a non-heading", () => {
+  assert.deepEqual(parseAtxHeadingTitle("Journal"), { ok: false, error: "not_heading" });
+  assert.deepEqual(parseAtxHeadingTitle("#Title"), { ok: false, error: "not_heading" });
+  assert.deepEqual(parseAtxHeadingTitle("####### Too many"), { ok: false, error: "not_heading" });
+});

package/src/activity/heading-title.ts

@@ -0,0 +1,26 @@
+/**
+ * Parse an ATX heading title (issue #1987 leftover).
+ *
+ * Trim, then walk 1-6 leading `#` plus one space. Empty title is
+ * empty_title. Anything else is not_heading. Walk chars. No regex.
+ */
+
+export type ParseAtxHeadingTitleResult =
+  | { ok: true; title: string }
+  | { ok: false; error: "empty_title" | "not_heading" };
+
+export function parseAtxHeadingTitle(line: string): ParseAtxHeadingTitleResult {
+  const trimmed = line.trim();
+  let i = 0;
+  while (i < trimmed.length && trimmed[i] === "#") {
+    i++;
+  }
+  if (i < 1 || i > 6) return { ok: false, error: "not_heading" };
+  if (i < trimmed.length && trimmed[i] !== " ") {
+    return { ok: false, error: "not_heading" };
+  }
+  if (i < trimmed.length) i++;
+  const title = trimmed.slice(i);
+  if (title.length === 0) return { ok: false, error: "empty_title" };
+  return { ok: true, title };
+}

package/src/activity/index.ts

@@ -19,5 +19,11 @@ export * from "./journal.js";
 export * from "./journal-vault-read.js";
 export * from "./memory-gen.js";
 export * from "./privacy.js";
+export * from "./privacy-window.js";
 export * from "./vault-path.js";
 export * from "./vault-publish.js";
+export * from "./vault-frontmatter.js";
+export * from "./vault-wikilink.js";
+export * from "./vault-region.js";
+export * from "./vault-suffix.js";
+export * from "./vault-join.js";

package/src/activity/journal-heading.test.ts

@@ -0,0 +1,22 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { normalizeJournalHeading } from "./journal-heading.js";
+
+test("normalizeJournalHeading accepts a heading", () => {
+  assert.deepEqual(normalizeJournalHeading("Journal"), { ok: true, heading: "Journal" });
+});
+
+test("normalizeJournalHeading rejects an empty heading", () => {
+  assert.deepEqual(normalizeJournalHeading(""), { ok: false, error: "empty_heading" });
+  assert.deepEqual(normalizeJournalHeading("   "), { ok: false, error: "empty_heading" });
+});
+
+test("normalizeJournalHeading rejects a heading with a newline", () => {
+  assert.deepEqual(normalizeJournalHeading("Jour\nnal"), { ok: false, error: "invalid_heading" });
+  assert.deepEqual(normalizeJournalHeading("Jour\rnal"), { ok: false, error: "invalid_heading" });
+});
+
+test("normalizeJournalHeading trims surrounding whitespace", () => {
+  assert.deepEqual(normalizeJournalHeading("  Journal  "), { ok: true, heading: "Journal" });
+});

package/src/activity/journal-heading.ts

@@ -0,0 +1,18 @@
+/**
+ * Normalize a journal section heading (issue #1987 leftover).
+ *
+ * Trim. Empty is empty_heading. Newline is invalid_heading.
+ */
+
+export type NormalizeJournalHeadingResult =
+  | { ok: true; heading: string }
+  | { ok: false; error: "empty_heading" | "invalid_heading" };
+
+export function normalizeJournalHeading(value: string): NormalizeJournalHeadingResult {
+  const heading = value.trim();
+  if (heading.length === 0) return { ok: false, error: "empty_heading" };
+  if (heading.includes("\n") || heading.includes("\r")) {
+    return { ok: false, error: "invalid_heading" };
+  }
+  return { ok: true, heading };
+}

package/src/activity/journal-mode.test.ts

@@ -0,0 +1,32 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { parseJournalMode } from "./journal-mode.js";
+
+test("file is allowed", () => {
+  assert.deepEqual(parseJournalMode("file"), {
+    ok: true,
+    mode: "file",
+  });
+});
+
+test("vault is allowed", () => {
+  assert.deepEqual(parseJournalMode("vault"), {
+    ok: true,
+    mode: "vault",
+  });
+});
+
+test("unknown mode is unknown_mode", () => {
+  assert.deepEqual(parseJournalMode("memoryDir"), {
+    ok: false,
+    error: "unknown_mode",
+  });
+});
+
+test("empty mode is unknown_mode", () => {
+  assert.deepEqual(parseJournalMode(""), {
+    ok: false,
+    error: "unknown_mode",
+  });
+});