@remnic/core 9.66.1 → 9.66.3

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,34 +3,34 @@ import {
   OKF_LOG_TRUNCATION_MARKER,
   exportOkfBundle,
   parseIncludeStatus
-} from "../chunk-LJABGXC4.js";
+} from "../chunk-IN5EUWCA.js";
 import {
   OKF_EXPORT_VERSION
-} from "../chunk-TCQRIIIN.js";
+} from "../chunk-6DODJYBY.js";
 import "../chunk-D24OXEPB.js";
-import "../chunk-2ITZ74A6.js";
-import "../chunk-4ZWCQJNM.js";
+import "../chunk-ZC5IHL5X.js";
 import "../chunk-UHVXE24Y.js";
+import "../chunk-4ZWCQJNM.js";
 import "../chunk-WVGXCBOC.js";
-import "../chunk-C5IUOBCN.js";
-import "../chunk-U6NGKS32.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-NNBZS3DY.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";
 import "../chunk-SCU65EZI.js";
 import "../chunk-2GF27PGH.js";
-import "../chunk-S2HLHAZ4.js";
 import "../chunk-DM2T26WE.js";
 import "../chunk-LDXUBPMO.js";
 import "../chunk-XSTNGNJP.js";
@@ -47,10 +47,10 @@ import "../chunk-RBOJCG4T.js";
 import "../chunk-NNZFPYYX.js";
 import "../chunk-5WITETWU.js";
 import "../chunk-6CIAGZ6X.js";
-import "../chunk-CEH2AFXG.js";
+import "../chunk-C24UZSFW.js";
 import "../chunk-JXN77SGO.js";
-import "../chunk-IUM3VSHI.js";
 import "../chunk-ZLQ37WJX.js";
+import "../chunk-IUM3VSHI.js";
 import "../chunk-WKAXBXVA.js";
 import "../chunk-BT7NVCML.js";
 import "../chunk-C64XATK7.js";

package/dist/verified-recall.js

@@ -1,31 +1,31 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-ZPS724LT.js";
+} from "./chunk-F5H5QINZ.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-2ITZ74A6.js";
-import "./chunk-4ZWCQJNM.js";
+import "./chunk-ZC5IHL5X.js";
 import "./chunk-UHVXE24Y.js";
+import "./chunk-4ZWCQJNM.js";
 import "./chunk-WVGXCBOC.js";
-import "./chunk-C5IUOBCN.js";
-import "./chunk-U6NGKS32.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-NNBZS3DY.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";
 import "./chunk-SCU65EZI.js";
 import "./chunk-2GF27PGH.js";
-import "./chunk-S2HLHAZ4.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-XSTNGNJP.js";
@@ -42,10 +42,10 @@ import "./chunk-RBOJCG4T.js";
 import "./chunk-NNZFPYYX.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-CEH2AFXG.js";
+import "./chunk-C24UZSFW.js";
 import "./chunk-JXN77SGO.js";
-import "./chunk-IUM3VSHI.js";
 import "./chunk-ZLQ37WJX.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-WKAXBXVA.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-C64XATK7.js";

package/dist/who-knows-cli.js

@@ -4,31 +4,31 @@ import {
   renderWhoKnows,
   renderWhoKnowsJson,
   renderWhoKnowsText
-} from "./chunk-VG4SSPAW.js";
-import "./chunk-UW4RYPWC.js";
-import "./chunk-2ITZ74A6.js";
-import "./chunk-4ZWCQJNM.js";
+} from "./chunk-4XESAT4V.js";
+import "./chunk-MLTGALDY.js";
+import "./chunk-ZC5IHL5X.js";
 import "./chunk-UHVXE24Y.js";
+import "./chunk-4ZWCQJNM.js";
 import "./chunk-WVGXCBOC.js";
-import "./chunk-C5IUOBCN.js";
-import "./chunk-U6NGKS32.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-NNBZS3DY.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";
 import "./chunk-SCU65EZI.js";
 import "./chunk-2GF27PGH.js";
-import "./chunk-S2HLHAZ4.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-XSTNGNJP.js";
@@ -45,10 +45,10 @@ import "./chunk-RBOJCG4T.js";
 import "./chunk-NNZFPYYX.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-CEH2AFXG.js";
+import "./chunk-C24UZSFW.js";
 import "./chunk-JXN77SGO.js";
-import "./chunk-IUM3VSHI.js";
 import "./chunk-ZLQ37WJX.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-WKAXBXVA.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-C64XATK7.js";

package/dist/who-knows.js

@@ -9,30 +9,30 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-UW4RYPWC.js";
-import "./chunk-2ITZ74A6.js";
-import "./chunk-4ZWCQJNM.js";
+} from "./chunk-MLTGALDY.js";
+import "./chunk-ZC5IHL5X.js";
 import "./chunk-UHVXE24Y.js";
+import "./chunk-4ZWCQJNM.js";
 import "./chunk-WVGXCBOC.js";
-import "./chunk-C5IUOBCN.js";
-import "./chunk-U6NGKS32.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-NNBZS3DY.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";
 import "./chunk-SCU65EZI.js";
 import "./chunk-2GF27PGH.js";
-import "./chunk-S2HLHAZ4.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-XSTNGNJP.js";
@@ -49,10 +49,10 @@ import "./chunk-RBOJCG4T.js";
 import "./chunk-NNZFPYYX.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-CEH2AFXG.js";
+import "./chunk-C24UZSFW.js";
 import "./chunk-JXN77SGO.js";
-import "./chunk-IUM3VSHI.js";
 import "./chunk-ZLQ37WJX.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-WKAXBXVA.js";
 import "./chunk-BT7NVCML.js";
 import "./chunk-C64XATK7.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.66.1",
+  "version": "9.66.3",
   "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.1"
+    "@remnic/coding-graph": "^9.66.3"
   },
   "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

@@ -16,5 +16,14 @@ export * from "./config.js";
 export * from "./reindex.js";
 export * from "./timeline/index.js";
 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",
+  });
+});

package/src/activity/journal-mode.ts

@@ -0,0 +1,20 @@
+/**
+ * Parse journal mode (issue #1987 leftover).
+ *
+ * Pure. Surfaces wait. Allow file or vault. Unknown or empty is unknown_mode.
+ */
+
+const JOURNAL_MODES = ["file", "vault"] as const;
+
+export type JournalMode = (typeof JOURNAL_MODES)[number];
+
+export type ParseJournalModeResult =
+  | { ok: true; mode: JournalMode }
+  | { ok: false; error: "unknown_mode" };
+
+export function parseJournalMode(value: string): ParseJournalModeResult {
+  if ((JOURNAL_MODES as readonly string[]).includes(value)) {
+    return { ok: true, mode: value as JournalMode };
+  }
+  return { ok: false, error: "unknown_mode" };
+}

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

@@ -0,0 +1,25 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { parseJournalFilePath } from "./journal-path.js";
+
+test("parseJournalFilePath accepts a relative path", () => {
+  assert.deepEqual(parseJournalFilePath("journal/2026-08-19.md"), {
+    ok: true,
+    path: "journal/2026-08-19.md",
+  });
+  assert.deepEqual(parseJournalFilePath("  notes/today.md  "), {
+    ok: true,
+    path: "notes/today.md",
+  });
+});
+
+test("parseJournalFilePath rejects an empty path", () => {
+  assert.deepEqual(parseJournalFilePath(""), { ok: false, error: "missing_path" });
+  assert.deepEqual(parseJournalFilePath("   "), { ok: false, error: "missing_path" });
+});
+
+test("parseJournalFilePath rejects ..", () => {
+  assert.deepEqual(parseJournalFilePath("../secret"), { ok: false, error: "invalid_path" });
+  assert.deepEqual(parseJournalFilePath("foo/../bar"), { ok: false, error: "invalid_path" });
+});

package/src/activity/journal-path.ts

@@ -0,0 +1,27 @@
+/**
+ * Parse a journal file path (issue #1987 leftover).
+ *
+ * Trim. Empty is missing_path. Absolute, `..`, backslash, or newline
+ * is invalid_path.
+ */
+import { posix, win32 } from "node:path";
+
+export type ParseJournalFilePathResult =
+  | { ok: true; path: string }
+  | { ok: false; error: "missing_path" | "invalid_path" };
+
+export function parseJournalFilePath(value: string): ParseJournalFilePathResult {
+  const journalPath = value.trim();
+  if (journalPath.length === 0) return { ok: false, error: "missing_path" };
+  if (
+    journalPath.includes("\\") ||
+    journalPath.includes("\n") ||
+    journalPath.includes("\r") ||
+    posix.isAbsolute(journalPath) ||
+    win32.isAbsolute(journalPath) ||
+    journalPath.split("/").includes("..")
+  ) {
+    return { ok: false, error: "invalid_path" };
+  }
+  return { ok: true, path: journalPath };
+}

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

@@ -0,0 +1,37 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { extractJournalSection } from "./journal-section.js";
+
+test("extractJournalSection returns null when the heading is missing", () => {
+  const markdown = ["# Day", "## Notes", "cards", ""].join("\n");
+  assert.equal(extractJournalSection(markdown, "Journal"), null);
+});
+
+test("extractJournalSection returns the unique heading body until the next same-or-higher heading", () => {
+  const markdown = [
+    "# Day",
+    "## Journal",
+    "walked the dog",
+    "### Nested",
+    "still journal",
+    "## Notes",
+    "not journal",
+    "",
+  ].join("\n");
+  assert.equal(
+    extractJournalSection(markdown, "Journal"),
+    ["walked the dog", "### Nested", "still journal"].join("\n"),
+  );
+});
+
+test("extractJournalSection refuses a duplicate heading", () => {
+  const markdown = ["# Day", "## Journal", "first", "## Notes", "## Journal", "second", ""].join("\n");
+  assert.deepEqual(extractJournalSection(markdown, "Journal"), { error: "duplicate_heading" });
+});
+
+test("extractJournalSection rejects an empty heading", () => {
+  const markdown = ["## Journal", "hi", ""].join("\n");
+  assert.deepEqual(extractJournalSection(markdown, ""), { error: "empty_heading" });
+  assert.deepEqual(extractJournalSection(markdown, "   "), { error: "empty_heading" });
+});