@remnic/core 9.69.76 → 9.69.77

package/dist/who-knows-cli.js

@@ -4,21 +4,21 @@ import {
   renderWhoKnows,
   renderWhoKnowsJson,
   renderWhoKnowsText
-} from "./chunk-5ELXQQY7.js";
-import "./chunk-YYI5DZAQ.js";
-import "./chunk-6RBUAPQT.js";
+} from "./chunk-5X7ZTLFS.js";
+import "./chunk-QIDMGBUY.js";
+import "./chunk-YUAOU2B2.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-OMYCECTS.js";
-import "./chunk-4GPI3GVE.js";
+import "./chunk-RJLV4BKR.js";
+import "./chunk-SLEAJ67D.js";
+import "./chunk-S7LWX2PQ.js";
 import "./chunk-T2YX56QI.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-Z4TXB4K7.js";
-import "./chunk-S7LWX2PQ.js";
 import "./chunk-4O6WRBGE.js";
+import "./chunk-Z4TXB4K7.js";
 import "./chunk-GUMZC2BO.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
@@ -33,11 +33,11 @@ import "./chunk-FF6N7BXC.js";
 import "./chunk-J3IWHCMF.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-DUJYRVUD.js";
+import "./chunk-3ONXXHQO.js";
 import "./chunk-YXZG5TVN.js";
 import "./chunk-ZIKENA2C.js";
-import "./chunk-FAT6HY7N.js";
+import "./chunk-345MEMRU.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-3ONXXHQO.js";
 import "./chunk-5GINB5LC.js";
 import "./chunk-3WU7XOFN.js";
 import "./chunk-G7D6GZ5J.js";
@@ -47,7 +47,7 @@ import "./chunk-RBOJCG4T.js";
 import "./chunk-R7QY5ZVB.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-3NTVCMDD.js";
+import "./chunk-B3OFQP5Y.js";
 import "./chunk-G26YNEOC.js";
 import "./chunk-ZLQ37WJX.js";
 import "./chunk-IUM3VSHI.js";

package/dist/who-knows.js

@@ -9,20 +9,20 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-YYI5DZAQ.js";
-import "./chunk-6RBUAPQT.js";
+} from "./chunk-QIDMGBUY.js";
+import "./chunk-YUAOU2B2.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-OMYCECTS.js";
-import "./chunk-4GPI3GVE.js";
+import "./chunk-RJLV4BKR.js";
+import "./chunk-SLEAJ67D.js";
+import "./chunk-S7LWX2PQ.js";
 import "./chunk-T2YX56QI.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-T3FMRLWQ.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-Z4TXB4K7.js";
-import "./chunk-S7LWX2PQ.js";
 import "./chunk-4O6WRBGE.js";
+import "./chunk-Z4TXB4K7.js";
 import "./chunk-GUMZC2BO.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
@@ -37,11 +37,11 @@ import "./chunk-FF6N7BXC.js";
 import "./chunk-J3IWHCMF.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-DUJYRVUD.js";
+import "./chunk-3ONXXHQO.js";
 import "./chunk-YXZG5TVN.js";
 import "./chunk-ZIKENA2C.js";
-import "./chunk-FAT6HY7N.js";
+import "./chunk-345MEMRU.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-3ONXXHQO.js";
 import "./chunk-5GINB5LC.js";
 import "./chunk-3WU7XOFN.js";
 import "./chunk-G7D6GZ5J.js";
@@ -51,7 +51,7 @@ import "./chunk-RBOJCG4T.js";
 import "./chunk-R7QY5ZVB.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-3NTVCMDD.js";
+import "./chunk-B3OFQP5Y.js";
 import "./chunk-G26YNEOC.js";
 import "./chunk-ZLQ37WJX.js";
 import "./chunk-IUM3VSHI.js";

package/package.json

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

package/src/briefing-followup-timeout.test.ts

@@ -0,0 +1,15 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { withBriefingFollowupTimeout } from "./briefing-followup-timeout.js";
+
+test("#3086 briefing follow-up timeout rejects so briefing can degrade", async () => {
+  await assert.rejects(
+    withBriefingFollowupTimeout(new Promise(() => {}), 20),
+    /briefing follow-up timeout/,
+  );
+});
+
+test("#3086 briefing follow-up timeout returns the work when it finishes", async () => {
+  assert.equal(await withBriefingFollowupTimeout(Promise.resolve("ok"), 50), "ok");
+});

package/src/briefing-followup-timeout.ts

@@ -0,0 +1,14 @@
+export const BRIEFING_FOLLOWUP_TIMEOUT_MS = 8_000;
+
+export async function withBriefingFollowupTimeout<T>(
+  work: Promise<T>,
+  timeoutMs = BRIEFING_FOLLOWUP_TIMEOUT_MS,
+): Promise<T> {
+  const { promise: timeout, reject } = Promise.withResolvers<T>();
+  const timer = setTimeout(() => reject(new Error("briefing follow-up timeout")), timeoutMs);
+  try {
+    return await Promise.race([work, timeout]);
+  } finally {
+    clearTimeout(timer);
+  }
+}

package/src/briefing.ts

@@ -19,6 +19,7 @@ import { readFile } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 import { log } from "./logger.js";
+import { withBriefingFollowupTimeout } from "./briefing-followup-timeout.js";
 import { extractJsonCandidates } from "./json-extract.js";
 import { drainPassiveCorrectionNotifications } from "./correction/passive-correction-notifications.js";
 import { excludeSupportPassportPrivateMemories } from "./support-passport/card-projection.js";
@@ -846,10 +847,6 @@ export async function buildBriefing(options: BuildBriefingOptions): Promise<Brie
 
   const activeThreads = buildActiveThreads(focusedMemories);
   const recentEntities = buildRecentEntities(allEntities, window, focus);
-  // TODO(#370): openCommitments only covers memories inside the lookback window.
-  // Still-open commitments (pending tag, commitment category) that pre-date the
-  // window are silently omitted. A separate query over allMemories filtered to
-  // open-status entries would surface these. Deferred to avoid scope creep here.
   const openCommitments = buildOpenCommitments(focusedMemories);
 
   const calendarLoadResult = options.calendarSource
@@ -882,11 +879,13 @@ export async function buildBriefing(options: BuildBriefingOptions): Promise<Brie
         model: options.model ?? BRIEFING_FOLLOWUP_DEFAULT_MODEL,
         baseURL: options.openaiBaseUrl,
       });
-      const generated = await generator({
-        sections: sectionsBase,
-        windowLabel: window.label,
-        maxFollowups,
-      });
+      const generated = await withBriefingFollowupTimeout(
+        generator({
+          sections: sectionsBase,
+          windowLabel: window.label,
+          maxFollowups,
+        }),
+      );
       followups = generated.slice(0, maxFollowups);
     } catch (err) {
       const errMsg = stringifyError(err);

package/src/config-qmd.ts

@@ -63,7 +63,7 @@ export function parseQmdSearchStrategy(value: unknown): "hybrid" | "lex-vec" | "
 // Issue #1335. Reject non-numeric / non-integer timeouts rather than silently
 // coercing them (gotcha #51), then clamp valid integers to the documented bounds.
 export function parseQmdDaemonTimeoutMs(value: unknown): number {
-  if (value === undefined || value === null) return 8_000;
+  if (value === undefined || value === null) return 60_000;
   const coerced = coerceNumber(value);
   if (coerced === undefined || !Number.isInteger(coerced)) {
     throw new Error(

package/src/config.test.ts

@@ -708,8 +708,8 @@ test("parseConfig qmdSubprocessStrategy defaults to query (honors QMD query inte
   }
 });
 
-test("parseConfig qmdDaemonTimeoutMs defaults to 8000 and clamps valid integers", () => {
-  assert.equal(parseConfig({}).qmdDaemonTimeoutMs, 8_000);
+test("parseConfig qmdDaemonTimeoutMs defaults to 60000 and clamps valid integers", () => {
+  assert.equal(parseConfig({}).qmdDaemonTimeoutMs, 60_000);
   assert.equal(parseConfig({ qmdDaemonTimeoutMs: 20_000 }).qmdDaemonTimeoutMs, 20_000);
   assert.equal(parseConfig({ qmdDaemonTimeoutMs: "20000" }).qmdDaemonTimeoutMs, 20_000);
   // Below floor clamps up; above ceiling clamps down.

package/src/config.ts

@@ -3127,7 +3127,7 @@ export function parseConfig(
     recallEnrichmentDeadlineMs:
       typeof cfg.recallEnrichmentDeadlineMs === "number"
         ? Math.max(0, Math.floor(cfg.recallEnrichmentDeadlineMs))
-        : 25_000,
+        : 60_000,
     recallPipeline: recallPipelineConfig.pipeline,
     recallMmrEnabled: cfg.recallMmrEnabled !== false,
     recallMmrLambda:

package/src/directory-sidecars.test.ts

@@ -1,5 +1,5 @@
 import assert from "node:assert/strict";
-import { chmodSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { chmodSync, existsSync, mkdtempSync, mkdirSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
 import { mkdir, readdir, readFile, stat } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
@@ -10,6 +10,7 @@ import {
   DIRECTORY_SIDECAR_MARKER,
   NEIGHBORHOOD_ABSTRACT_LABEL,
   applyDirectorySidecarDrillDown,
+  directorySidecarAncestry,
   findDirectorySidecarsForQuery,
   loadDirectorySidecar,
   parseDirectorySidecarsEnabled,
@@ -498,3 +499,37 @@ test("drill-down prefers the most specific matching directory", async () => {
     rmSync(root, { recursive: true, force: true });
   }
 });
+
+test("#3007 sidecar ancestry refuses a symlinked memory root", () => {
+  const root = store();
+  try {
+    const facts = path.join(root, "facts");
+    mkdirSync(facts);
+    const linked = path.join(root, "linked-root");
+    symlinkSync(root, linked);
+    assert.deepEqual(directorySidecarAncestry(linked, "facts/2026-01-01/fact.md"), []);
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});
+
+test("#3090 sidecar ancestry refuses a symlink above the category root", async () => {
+  const root = store();
+  try {
+    const outside = path.join(root, "outside");
+    mkdirSync(path.join(outside, "alpha", "facts", "2026-01-01"), { recursive: true });
+    writeFileSync(path.join(outside, "alpha", "facts", "2026-01-01", "fact.md"), "x");
+    mkdirSync(path.join(root, "namespaces"));
+    symlinkSync(outside, path.join(root, "namespaces", "alpha"));
+    const report = await refreshDirectorySidecarsAfterWrite(
+      root,
+      "namespaces/alpha/facts/2026-01-01/fact.md",
+      true,
+    );
+    assert.deepEqual(report, { written: [], removed: [] });
+    assert.equal(existsSync(path.join(outside, "alpha", "facts", "overview.md")), false);
+    assert.equal(existsSync(path.join(outside, "alpha", "facts", "2026-01-01", "overview.md")), false);
+  } finally {
+    rmSync(root, { recursive: true, force: true });
+  }
+});

package/src/directory-sidecars.ts

@@ -337,10 +337,21 @@ function childAbstractsFromDisk(dir: string): Map<string, string> {
  */
 export function directorySidecarAncestry(memoryDir: string, changedPath: string): string[] {
   const root = path.resolve(memoryDir);
+  if (!isRealDirectory(root)) return [];
   const abs = path.isAbsolute(changedPath) ? path.resolve(changedPath) : path.resolve(root, changedPath);
   const rel = path.relative(root, abs);
   if (rel.startsWith("..") || path.isAbsolute(rel)) return [];
   const parts = rel.split(path.sep).filter(Boolean);
+  let cursor = root;
+  for (let i = 0; i < parts.length; i++) {
+    cursor = path.join(cursor, parts[i] ?? "");
+    try {
+      if (lstatSync(cursor).isSymbolicLink()) return [];
+    } catch {
+      if (i === parts.length - 1) break;
+      return [];
+    }
+  }
   const dirParts = isRealDirectory(abs) ? parts : parts.slice(0, -1);
   let categoryAt = -1;
   if (dirParts[0] === "namespaces" && dirParts.length >= 3 && CATEGORY_ROOTS.has(dirParts[2] ?? "")) {
@@ -351,7 +362,9 @@ export function directorySidecarAncestry(memoryDir: string, changedPath: string)
   if (categoryAt === -1) return [];
   const dirs: string[] = [];
   for (let i = dirParts.length; i > categoryAt; i--) {
-    dirs.push(path.join(root, ...dirParts.slice(0, i)));
+    const dir = path.join(root, ...dirParts.slice(0, i));
+    if (!isRealDirectory(dir)) return [];
+    dirs.push(dir);
   }
   return dirs;
 }

package/src/orchestration/recall-internal.ts

@@ -165,7 +165,7 @@ export class RecallInternalCoordinator {
     const recallSectionDeadlineMs = this.deps.config.recallCoreDeadlineMs ?? 75_000;
     const recallOuterTimeoutMs = this.deps.config.recallOuterTimeoutMs ?? 75_000;
     const enrichmentSectionDeadlineMs =
-      this.deps.config.recallEnrichmentDeadlineMs ?? 25_000;
+      this.deps.config.recallEnrichmentDeadlineMs ?? 60_000;
     // Wrap entire recall body in try/finally so profiling trace is always closed,
     // even on unexpected exceptions (e.g., throwIfRecallAborted, phase-1 errors).
     try {

package/src/orchestration/recall-recognition-search.test.ts

@@ -15,6 +15,7 @@ import test from "node:test";
 import { saveRecognitionIndex, type RecognitionIndex } from "../recall-recognition-tier.js";
 import {
   fetchQmdMemoryResultsWithRecognitionSwap,
+  recognitionHitScore,
   type RecognitionSearchDeps,
 } from "./recall-recognition-search.js";
 import type { QmdSearchResult } from "../types.js";
@@ -30,6 +31,13 @@ function indexOf(ids: string[]): RecognitionIndex {
   };
 }
 
+test("#3117 recognition hit scores stay on the retrieval 0-1 scale", () => {
+  assert.equal(recognitionHitScore(0), 1);
+  assert.ok(recognitionHitScore(1) < 1);
+  assert.ok(recognitionHitScore(1) > recognitionHitScore(2));
+  assert.ok(recognitionHitScore(99) > 0);
+});
+
 async function tmpDir(): Promise<string> {
   return mkdtemp(path.join(os.tmpdir(), "remnic-recognition-search-"));
 }

package/src/orchestration/recall-recognition-search.ts

@@ -133,6 +133,10 @@ export async function fetchQmdMemoryResultsWithRecognitionSwap(
   );
 }
 
+export function recognitionHitScore(rankOffset: number): number {
+  return 1 / (1 + rankOffset);
+}
+
 async function hitsFromIds(
   namespace: string,
   storage: RecognitionStorage,
@@ -152,7 +156,7 @@ async function hitsFromIds(
       docid: `${namespace}:${rel}`,
       namespace,
       path: rel,
-      score: ids.length - offset,
+      score: recognitionHitScore(offset),
       snippet: descriptionById.get(id) ?? id,
     });
   }

package/src/orchestration/recall-search-pipeline.ts

@@ -315,7 +315,7 @@ export class RecallSearchPipelineCoordinator {
       320,
       Math.max(fetchLimit, qmdFetchLimit * 5),
     );
-    const qmdRecallBudgetMs = this.deps.config.recallEnrichmentDeadlineMs ?? 25_000;
+    const qmdRecallBudgetMs = this.deps.config.recallEnrichmentDeadlineMs ?? 60_000;
     const qmdRecallBudgetEnabled = qmdRecallBudgetMs > 0;
     const startedAtMs = Date.now();
     let lastPrimaryResultCount = 0;

package/src/qmd.ts

@@ -70,7 +70,7 @@ export interface QmdClientOptions {
   qmdSubprocessStrategy?: QmdSubprocessStrategy;
   /** Override automatic qmd fallback probes; defaults to known install paths. */
   qmdFallbackPaths?: string[];
-  /** Per-call daemon search timeout in ms; default 8000. Issue #1335. */
+  /** Per-call daemon search timeout in ms; default 60000. Issue #1335/#3098. */
   qmdDaemonTimeoutMs?: number;
 }
 
@@ -152,9 +152,9 @@ export type { QmdStatusReport } from "./qmd-status.js";
 
 const QMD_TIMEOUT_MS = 30_000;
 // Daemon timeout for search calls. Keep under RECALL_TIMEOUT_MS (75s) so a slow
-// daemon fails fast. Default only — override via `qmdDaemonTimeoutMs` (#1335).
-// Keep ≥ 5s for normal post-load searches to complete reliably.
-const QMD_DAEMON_TIMEOUT_MS = 8_000;
+// daemon fails fast. Default only — override via `qmdDaemonTimeoutMs` (#1335/#3098).
+// 60s covers multi-GB cold indexes that 8s missed; operators can still set 8s.
+const QMD_DAEMON_TIMEOUT_MS = 60_000;
 const QMD_UPDATE_BACKOFF_MS = 15 * 60 * 1000; // 15m
 const QMD_EMBED_BACKOFF_MS = 60 * 60 * 1000; // 60m
 const QMD_CLI_WARN_THROTTLE_MS = 15 * 60 * 1000; // 15m

package/src/recall-budget-config.test.ts

@@ -8,7 +8,7 @@ test("parseConfig applies recall timeout and qmd recall cache defaults", () => {
 
   assert.equal(config.recallOuterTimeoutMs, 75_000);
   assert.equal(config.recallCoreDeadlineMs, 75_000);
-  assert.equal(config.recallEnrichmentDeadlineMs, 25_000);
+  assert.equal(config.recallEnrichmentDeadlineMs, 60_000);
   assert.equal(config.qmdRecallCacheTtlMs, 60_000);
   assert.equal(config.qmdRecallCacheStaleTtlMs, 10 * 60_000);
   assert.equal(config.qmdRecallCacheMaxEntries, 128);