@remnic/core 9.45.3 → 9.45.5

package/dist/provenance.js

@@ -5,12 +5,12 @@ import {
   parseProvenanceTag,
   reconcileProvenanceRead,
   serializeProvenanceFields
-} from "./chunk-5I4M26Q7.js";
+} from "./chunk-QBSFOKY6.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-PQVCH2AE.js";
-import "./chunk-JUC24CTX.js";
 import "./chunk-6MKAMLQL.js";
 import "./chunk-JAKIDQB2.js";
+import "./chunk-JUC24CTX.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/{qmd-LWtMofAf.d.ts → qmd-C0UDZidt.d.ts}

@@ -1,6 +1,6 @@
-import { Q as QmdSearchResult, aD as QmdSearchExplain } from './types-rEwubvim.js';
-import { SearchBackend, SearchExecutionOptions, SearchQueryOptions } from './search/port.js';
 import { QmdStatusReport } from './qmd-status.js';
+import { SearchBackend, SearchExecutionOptions, SearchQueryOptions } from './search/port.js';
+import { Q as QmdSearchResult, aE as QmdSearchExplain } from './types-yX_FwERf.js';
 
 declare const QMD_PROBE_TIMEOUT_MS = 8000;
 declare const QMD_PROBE_RETRY_BACKOFF_MS: number[];
@@ -41,6 +41,7 @@ interface QmdClientOptions {
     updateMinIntervalMs?: number;
     qmdPath?: string;
     daemonUrl?: string;
+    qmdStrictPath?: boolean;
     daemonRecheckIntervalMs?: number;
     qmdSupportedVersion?: string;
     qmdAutoUpgradeEnabled?: boolean;
@@ -203,6 +204,7 @@ declare class QmdClient implements SearchBackend {
     private readonly qmdSearchStrategy;
     private readonly qmdSubprocessStrategy;
     private readonly qmdFallbackPaths;
+    private readonly qmdStrictPath;
     private readonly daemonTimeoutMs;
     private readonly qmdRuntimeEnv;
     private qmdPathSource;
@@ -224,11 +226,6 @@ declare class QmdClient implements SearchBackend {
     probe(): Promise<boolean>;
     checkAvailability(execution?: SearchExecutionOptions): Promise<boolean>;
     private probeDaemon;
-    /**
-     * Run a single `qmd --version` probe against `qmdPath`. Extracted as its own
-     * method so tests can inject a fake probe runner that exercises the preflight
-     * retry/classification paths without spawning a real qmd binary. Issue #1841.
-     */
     private runVersionProbe;
     private probeCli;
     private maybeAutoUpgradeQmd;
@@ -248,6 +245,7 @@ declare class QmdClient implements SearchBackend {
      * Returns null fields when the command fails or output is unparseable.
      */
     status(): Promise<QmdStatusReport>;
+    collectionStatus(collection: string): Promise<Pick<QmdStatusReport, "totalFiles">>;
     isDaemonMode(): boolean;
     dispose(): Promise<void>;
     /**
@@ -333,6 +331,10 @@ declare class QmdClient implements SearchBackend {
     /** Trigger a collection-level embed for fresh writes (debounced by prioritized-embed). */
     embedFiles(filePaths: string[]): Promise<boolean>;
     private runEmbedForCollection;
+    supportsAdditionalCollections(): boolean;
+    collectionRoot(collection: string, execution?: SearchExecutionOptions): Promise<string | null>;
+    excludeCollectionFromGlobalSearch(collection: string, execution?: SearchExecutionOptions): Promise<void>;
+    deleteCollection(collection: string, execution?: SearchExecutionOptions): Promise<boolean>;
     checkCollection(collectionOrExecution?: string | SearchExecutionOptions, execution?: SearchExecutionOptions): Promise<"present" | "missing" | "unknown" | "skipped">;
     ensureCollection(memoryDir: string, collectionOrExecution?: string | SearchExecutionOptions, execution?: SearchExecutionOptions): Promise<"present" | "missing" | "unknown" | "skipped">;
 }

package/dist/qmd-preflight.d.ts

@@ -1,8 +1,9 @@
-export { a as QMD_PROBE_RETRY_BACKOFF_MS, b as QMD_PROBE_TIMEOUT_MS, c as QMD_SUPPORTED_VERSION, d as QmdProbeFailureKind, e as classifyProbeFailure, f as compareQmdVersions, g as getQmdPostInstallProbeTargets, p as parseQmdVersion, h as parseQmdVersionOutput, q as qmdVersionToString, r as resolveQmdCapabilities, s as shouldAutoUpgradeQmd, v as versionAtLeast } from './qmd-LWtMofAf.js';
-import './types-rEwubvim.js';
+export { a as QMD_PROBE_RETRY_BACKOFF_MS, b as QMD_PROBE_TIMEOUT_MS, c as QMD_SUPPORTED_VERSION, d as QmdProbeFailureKind, e as classifyProbeFailure, f as compareQmdVersions, g as getQmdPostInstallProbeTargets, p as parseQmdVersion, h as parseQmdVersionOutput, q as qmdVersionToString, r as resolveQmdCapabilities, s as shouldAutoUpgradeQmd, v as versionAtLeast } from './qmd-C0UDZidt.js';
+import './qmd-status.js';
+import './search/port.js';
+import './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
-import './search/port.js';
-import './qmd-status.js';

package/dist/qmd-preflight.js

@@ -11,8 +11,8 @@ import {
   resolveQmdCapabilities,
   shouldAutoUpgradeQmd,
   versionAtLeast
-} from "./chunk-64UDOIMI.js";
-import "./chunk-PVGDJXVK.js";
+} from "./chunk-ZLQ37WJX.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-PZ5AY32C.js";
 export {
   QMD_PROBE_RETRY_BACKOFF_MS,

package/dist/qmd-recall-cache.d.ts

@@ -1,8 +1,9 @@
-import { R as RecallPlanMode } from './types-rEwubvim.js';
+import { R as RecallPlanMode } from './types-yX_FwERf.js';
 import { SearchQueryOptions } from './search/port.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 type QmdRecallCacheSource = "fresh" | "stale";

package/dist/qmd.d.ts

@@ -1,8 +1,9 @@
-import './types-rEwubvim.js';
-import './search/port.js';
-export { c as QMD_SUPPORTED_VERSION, i as QmdCapabilities, j as QmdChunkStrategy, Q as QmdClient, k as QmdClientOptions, l as QmdDoctorReport, m as QmdSearchStrategy, n as QmdStructuredSearch, o as QmdStructuredSearchType, t as QmdSubprocessStrategy, u as QmdVersionStatus, w as QmdVersionTuple, x as buildDefaultStructuredSearches, f as compareQmdVersions, y as getQmdCommandName, g as getQmdPostInstallProbeTargets, z as parseQmdExplain, p as parseQmdVersion, h as parseQmdVersionOutput, A as releaseSharedDaemonSessionForTest, r as resolveQmdCapabilities, B as retainSharedDaemonSessionForTest, C as sharedDaemonSessionCountForTest, s as shouldAutoUpgradeQmd, v as versionAtLeast } from './qmd-LWtMofAf.js';
+export { c as QMD_SUPPORTED_VERSION, i as QmdCapabilities, j as QmdChunkStrategy, Q as QmdClient, k as QmdClientOptions, l as QmdDoctorReport, m as QmdSearchStrategy, n as QmdStructuredSearch, o as QmdStructuredSearchType, t as QmdSubprocessStrategy, u as QmdVersionStatus, w as QmdVersionTuple, x as buildDefaultStructuredSearches, f as compareQmdVersions, y as getQmdCommandName, g as getQmdPostInstallProbeTargets, z as parseQmdExplain, p as parseQmdVersion, h as parseQmdVersionOutput, A as releaseSharedDaemonSessionForTest, r as resolveQmdCapabilities, B as retainSharedDaemonSessionForTest, C as sharedDaemonSessionCountForTest, s as shouldAutoUpgradeQmd, v as versionAtLeast } from './qmd-C0UDZidt.js';
 export { QmdStatusReport, parseQmdStatusOutput } from './qmd-status.js';
+import './search/port.js';
+import './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';

package/dist/qmd.js

@@ -6,8 +6,11 @@ import {
   releaseSharedDaemonSession,
   retainSharedDaemonSession,
   sharedDaemonSessionCountForTest
-} from "./chunk-QJAQNXWI.js";
-import "./chunk-YV32N67O.js";
+} from "./chunk-RVO6TCTU.js";
+import "./chunk-URS5GSM7.js";
+import {
+  parseQmdStatusOutput
+} from "./chunk-IUM3VSHI.js";
 import {
   QMD_SUPPORTED_VERSION,
   compareQmdVersions,
@@ -17,15 +20,12 @@ import {
   resolveQmdCapabilities,
   shouldAutoUpgradeQmd,
   versionAtLeast
-} from "./chunk-64UDOIMI.js";
-import {
-  parseQmdStatusOutput
-} from "./chunk-IUM3VSHI.js";
-import "./chunk-O75CRYGF.js";
+} from "./chunk-ZLQ37WJX.js";
 import "./chunk-XMMESCPD.js";
 import "./chunk-42JKGUFJ.js";
+import "./chunk-O75CRYGF.js";
 import "./chunk-JUC24CTX.js";
-import "./chunk-PVGDJXVK.js";
+import "./chunk-BTTPKDIL.js";
 import "./chunk-3WCASNQZ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/recall-concurrency-config.d.ts

@@ -1,7 +1,8 @@
-import { P as PluginConfig } from './types-rEwubvim.js';
+import { P as PluginConfig } from './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 /**

package/dist/recall-disclosure-escalation.d.ts

@@ -1,7 +1,8 @@
-import { b as RecallDisclosure } from './types-rEwubvim.js';
+import { n as RecallDisclosure } from './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 /**

package/dist/recall-explain-renderer.d.ts

@@ -1,11 +1,12 @@
 import { LastRecallSnapshot } from './recall-state.js';
-import { c as RecallTierExplain } from './types-rEwubvim.js';
+import { b as RecallTierExplain } from './types-yX_FwERf.js';
 import { RecallXraySnapshot } from './recall-xray.js';
 import './utils/serialize-mutations.js';
 import './search/port.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 import './memory-provenance.js';
 import './user-model.js';

package/dist/recall-explain-renderer.js

@@ -5,10 +5,10 @@ import {
   toRecallExplainJson,
   toRecallExplainText,
   toRecallXraySnapshotFromLegacy
-} from "./chunk-3TBLDMJA.js";
+} from "./chunk-O4KMGRXE.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-TDHTVMPG.js";
-import "./chunk-J7VGGECD.js";
+import "./chunk-HFPASSFV.js";
+import "./chunk-DZPFMQZ7.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";
 import "./chunk-PZ5AY32C.js";

package/dist/recall-memory-map.d.ts

@@ -1,7 +1,8 @@
-import { Q as QmdSearchResult, M as MemoryFile } from './types-rEwubvim.js';
+import { Q as QmdSearchResult, M as MemoryFile } from './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 declare function memoryMapKey(result: Pick<QmdSearchResult, "namespace" | "path">): string;

package/dist/recall-planner-llm.d.ts

@@ -1,9 +1,10 @@
-import { R as RecallPlanMode, P as PluginConfig } from './types-rEwubvim.js';
+import { R as RecallPlanMode, P as PluginConfig } from './types-yX_FwERf.js';
 import { CapabilitySet } from './capabilities.js';
 import { FallbackLlmClient, FallbackLlmOptions } from './fallback-llm.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 import './resolve-provider-secret.js';
 

package/dist/recall-state.d.ts

@@ -1,9 +1,10 @@
 import { HeldFileLockOptions } from './utils/serialize-mutations.js';
 import { SearchDegradation } from './search/port.js';
-import { R as RecallPlanMode, I as IdentityInjectionMode, c as RecallTierExplain } from './types-rEwubvim.js';
+import { R as RecallPlanMode, I as IdentityInjectionMode, b as RecallTierExplain } from './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 interface LastRecallBudgetSummary {

package/dist/recall-tag-filter.d.ts

@@ -1,9 +1,10 @@
 import { RecallFilterTrace } from './recall-xray.js';
 import './memory-provenance.js';
-import './types-rEwubvim.js';
+import './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 import './user-model.js';
 

package/dist/recall-timings.d.ts

@@ -1,7 +1,8 @@
-import { P as PluginConfig } from './types-rEwubvim.js';
+import { P as PluginConfig } from './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 interface RecallTimingRecord {

package/dist/recall-xray-cli.d.ts

@@ -1,11 +1,12 @@
 import { RecallXrayFormat } from './recall-xray-renderer.js';
-import { b as RecallDisclosure } from './types-rEwubvim.js';
+import { n as RecallDisclosure } from './types-yX_FwERf.js';
 import './recall-xray.js';
 import './memory-provenance.js';
 import './user-model.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 /**

package/dist/recall-xray-cli.js

@@ -2,11 +2,11 @@ import {
   parseXrayBudgetFlag,
   parseXrayCliOptions,
   parseXrayDisclosureFlag
-} from "./chunk-TIHMZFIV.js";
-import "./chunk-3TBLDMJA.js";
+} from "./chunk-W3IC7QOY.js";
+import "./chunk-O4KMGRXE.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-TDHTVMPG.js";
-import "./chunk-J7VGGECD.js";
+import "./chunk-HFPASSFV.js";
+import "./chunk-DZPFMQZ7.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";
 import "./chunk-PZ5AY32C.js";

package/dist/recall-xray-renderer.d.ts

@@ -1,9 +1,10 @@
 import { RecallXraySnapshot } from './recall-xray.js';
 import './memory-provenance.js';
-import './types-rEwubvim.js';
+import './types-yX_FwERf.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 import './user-model.js';
 

package/dist/recall-xray-renderer.js

@@ -5,10 +5,10 @@ import {
   renderXrayJson,
   renderXrayMarkdown,
   renderXrayText
-} from "./chunk-3TBLDMJA.js";
+} from "./chunk-O4KMGRXE.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-TDHTVMPG.js";
-import "./chunk-J7VGGECD.js";
+import "./chunk-HFPASSFV.js";
+import "./chunk-DZPFMQZ7.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";
 import "./chunk-PZ5AY32C.js";

package/dist/recall-xray.d.ts

@@ -1,9 +1,10 @@
 import { RetrievedMemoryProvenance } from './memory-provenance.js';
-import { c as RecallTierExplain, b as RecallDisclosure } from './types-rEwubvim.js';
+import { b as RecallTierExplain, n as RecallDisclosure } from './types-yX_FwERf.js';
 import './user-model.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
+import './external-wiki-config.js';
 import './types-continuity.js';
 
 /**
@@ -234,6 +235,9 @@ interface RecallXraySnapshot {
      */
     tierExplain: RecallTierExplain | null;
     results: RecallXrayResult[];
+    appliedResultLimit: number;
+    appliedResults: RecallXrayResult[];
+    headroomResults: RecallXrayResult[];
     filters: RecallFilterTrace[];
     /**
      * Character budget accounting for the final assembled recall payload.
@@ -260,6 +264,9 @@ interface BuildXraySnapshotInput {
     query: string;
     tierExplain?: RecallTierExplain | null;
     results?: RecallXrayResult[];
+    appliedResultLimit?: number;
+    appliedResults?: RecallXrayResult[];
+    headroomResults?: RecallXrayResult[];
     filters?: RecallFilterTrace[];
     budget?: {
         chars?: number;

package/dist/recall-xray.js

@@ -5,8 +5,8 @@ import {
   estimateRecallTokens,
   isRecallXrayServedBy,
   summarizeDisclosureTokens
-} from "./chunk-TDHTVMPG.js";
-import "./chunk-J7VGGECD.js";
+} from "./chunk-HFPASSFV.js";
+import "./chunk-DZPFMQZ7.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";
 import "./chunk-PZ5AY32C.js";

package/dist/reconcile/cursor.d.ts

@@ -1,11 +1,13 @@
 import { ReconcileSemanticAgreement, ReconcilePlanEntry } from './plan.js';
 import '../offline-sync.js';
-import '../types-rEwubvim.js';
+import '../types-yX_FwERf.js';
 import '../message-parts/index.js';
 import '../bounded-jsonl-state.js';
 import '../operator-doctor-types.js';
+import '../external-wiki-config.js';
 import '../types-continuity.js';
 
+type ConvergeRefreshTarget = "local" | "receiver";
 interface ConvergeCursorFileState {
     path: string;
     sha256: string;
@@ -20,12 +22,20 @@ interface ConvergeCursorState {
     baseFiles: ConvergeCursorFileState[];
     semanticAgreements?: ReconcileSemanticAgreement[];
     completedPaths?: string[];
+    pendingRefreshes?: ConvergeRefreshTarget[];
 }
+declare function normalizeConvergePeerUrl(peerUrl: string): string;
 declare function hashPeerNamespace(peerUrl: string, namespace: string): string;
 declare function defaultConvergeCursorPath(memoryDir: string, peerUrl: string, namespace: string): string;
 declare function deriveConvergeCursorBase(entries: readonly ReconcilePlanEntry[], namespace: string, priorSemanticAgreements?: readonly ReconcileSemanticAgreement[]): Pick<ConvergeCursorState, "baseFiles" | "semanticAgreements">;
 declare function normalizeConvergeCursor(input: unknown): ConvergeCursorState;
 declare function readConvergeCursor(cursorPath: string): Promise<ConvergeCursorState | null>;
 declare function writeConvergeCursor(cursorPath: string, cursor: ConvergeCursorState): Promise<void>;
+declare function markConvergeRefreshPending(cursorPath: string, options: {
+    peerUrl: string;
+    namespace: string;
+    target: ConvergeRefreshTarget;
+}): Promise<void>;
+declare function clearConvergeRefreshPending(cursorPath: string, target: ConvergeRefreshTarget): Promise<void>;
 
-export { type ConvergeCursorFileState, type ConvergeCursorState, defaultConvergeCursorPath, deriveConvergeCursorBase, hashPeerNamespace, normalizeConvergeCursor, readConvergeCursor, writeConvergeCursor };
+export { type ConvergeCursorFileState, type ConvergeCursorState, type ConvergeRefreshTarget, clearConvergeRefreshPending, defaultConvergeCursorPath, deriveConvergeCursorBase, hashPeerNamespace, markConvergeRefreshPending, normalizeConvergeCursor, normalizeConvergePeerUrl, readConvergeCursor, writeConvergeCursor };

package/dist/reconcile/cursor.js

@@ -4,15 +4,22 @@ import "../chunk-PZ5AY32C.js";
 import { createHash, randomUUID } from "crypto";
 import * as fs from "fs/promises";
 import * as path from "path";
-function hashPeerNamespace(peerUrl, namespace) {
-  let normalizedUrl;
+function normalizeConvergePeerUrl(peerUrl) {
+  const trimmed = peerUrl.trim();
   try {
-    const url = new URL(peerUrl);
-    const credentials = url.username || url.password ? `${url.username}${url.password ? `:${url.password}` : ""}@` : "";
-    normalizedUrl = `${url.protocol.toLowerCase()}//${credentials}${url.hostname.toLowerCase()}${url.port ? `:${url.port}` : ""}${url.pathname.replace(/\/+$/, "")}${url.search}${url.hash}`;
+    const url = new URL(trimmed);
+    url.username = "";
+    url.password = "";
+    url.search = "";
+    url.hash = "";
+    url.pathname = url.pathname.replace(/\/+$/, "");
+    return url.toString().replace(/\/$/, "");
   } catch {
-    normalizedUrl = peerUrl.trim().replace(/\/+$/, "").toLowerCase();
+    return trimmed.replace(/\/+$/, "");
   }
+}
+function hashPeerNamespace(peerUrl, namespace) {
+  const normalizedUrl = normalizeConvergePeerUrl(peerUrl);
   const normalizedNs = namespace.trim().toLowerCase();
   return createHash("sha256").update(`${normalizedUrl}\0${normalizedNs}`).digest("hex").slice(0, 16);
 }
@@ -110,6 +117,11 @@ function normalizeConvergeCursor(input) {
       }
     }
   }
+  const pendingRefreshes = [];
+  if (Array.isArray(obj.pendingRefreshes)) {
+    if (obj.pendingRefreshes.includes("local")) pendingRefreshes.push("local");
+    if (obj.pendingRefreshes.includes("receiver")) pendingRefreshes.push("receiver");
+  }
   return {
     version: 1,
     peerUrl: obj.peerUrl.trim(),
@@ -117,7 +129,8 @@ function normalizeConvergeCursor(input) {
     lastConvergedAt: typeof obj.lastConvergedAt === "string" ? obj.lastConvergedAt : void 0,
     baseFiles,
     semanticAgreements,
-    completedPaths
+    completedPaths,
+    pendingRefreshes
   };
 }
 async function readConvergeCursor(cursorPath) {
@@ -147,11 +160,37 @@ async function writeConvergeCursor(cursorPath, cursor) {
     throw error;
   }
 }
+async function markConvergeRefreshPending(cursorPath, options) {
+  const current = await readConvergeCursor(cursorPath);
+  const pendingRefreshes = new Set(current?.pendingRefreshes ?? []);
+  pendingRefreshes.add(options.target);
+  await writeConvergeCursor(cursorPath, {
+    version: 1,
+    peerUrl: current?.peerUrl ?? options.peerUrl,
+    namespace: current?.namespace ?? options.namespace,
+    lastConvergedAt: current?.lastConvergedAt,
+    baseFiles: current?.baseFiles ?? [],
+    semanticAgreements: current?.semanticAgreements ?? [],
+    completedPaths: current?.completedPaths ?? [],
+    pendingRefreshes: [...pendingRefreshes].sort()
+  });
+}
+async function clearConvergeRefreshPending(cursorPath, target) {
+  const current = await readConvergeCursor(cursorPath);
+  if (!current?.pendingRefreshes?.includes(target)) return;
+  await writeConvergeCursor(cursorPath, {
+    ...current,
+    pendingRefreshes: current.pendingRefreshes.filter((pending) => pending !== target)
+  });
+}
 export {
+  clearConvergeRefreshPending,
   defaultConvergeCursorPath,
   deriveConvergeCursorBase,
   hashPeerNamespace,
+  markConvergeRefreshPending,
   normalizeConvergeCursor,
+  normalizeConvergePeerUrl,
   readConvergeCursor,
   writeConvergeCursor
 };

package/dist/reconcile/cursor.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/reconcile/cursor.ts"],"sourcesContent":["import { createHash, randomUUID } from \"node:crypto\";\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport type { ReconcilePlanEntry, ReconcileSemanticAgreement } from \"./plan.js\";\n\nexport interface ConvergeCursorFileState {\n  path: string;\n  sha256: string;\n  mtimeMs?: number;\n  bytes?: number;\n}\n\nexport interface ConvergeCursorState {\n  version: 1;\n  peerUrl: string;\n  namespace: string;\n  lastConvergedAt?: string;\n  baseFiles: ConvergeCursorFileState[];\n  semanticAgreements?: ReconcileSemanticAgreement[];\n  completedPaths?: string[];\n}\n\nexport function hashPeerNamespace(peerUrl: string, namespace: string): string {\n  let normalizedUrl: string;\n  try {\n    const url = new URL(peerUrl);\n    const credentials =\n      url.username || url.password\n        ? `${url.username}${url.password ? `:${url.password}` : \"\"}@`\n        : \"\";\n    normalizedUrl =\n      `${url.protocol.toLowerCase()}//${credentials}${url.hostname.toLowerCase()}` +\n      `${url.port ? `:${url.port}` : \"\"}${url.pathname.replace(/\\/+$/, \"\")}${url.search}${url.hash}`;\n  } catch {\n    normalizedUrl = peerUrl.trim().replace(/\\/+$/, \"\").toLowerCase();\n  }\n  const normalizedNs = namespace.trim().toLowerCase();\n  return createHash(\"sha256\")\n    .update(`${normalizedUrl}\\0${normalizedNs}`)\n    .digest(\"hex\")\n    .slice(0, 16);\n}\n\nexport function defaultConvergeCursorPath(\n  memoryDir: string,\n  peerUrl: string,\n  namespace: string,\n): string {\n  const key = hashPeerNamespace(peerUrl, namespace);\n  return path.join(path.resolve(memoryDir), \".remnic\", \"state\", \"converge-cursors\", `${key}.json`);\n}\n\nfunction normalizeSemanticFileState(input: unknown): { path: string; sha256: string } | undefined {\n  if (!input || typeof input !== \"object\" || Array.isArray(input)) return undefined;\n  const file = input as Record<string, unknown>;\n  if (typeof file.path !== \"string\" || typeof file.sha256 !== \"string\") return undefined;\n  return { path: file.path, sha256: file.sha256 };\n}\n\nfunction digestAfterReconcile(entry: ReconcilePlanEntry): string | undefined {\n  if (entry.action === \"push\") return entry.localSha256;\n  if (entry.action === \"pull\") return entry.peerSha256;\n  if (entry.action === \"conflict\") {\n    if (entry.resolution === \"local-wins\") return entry.localSha256;\n    if (entry.resolution === \"peer-wins\") return entry.peerSha256;\n    return undefined;\n  }\n  if (entry.action !== \"identical\") return undefined;\n  if (entry.localSha256 && entry.peerSha256 && entry.localSha256 !== entry.peerSha256) return undefined;\n  return entry.localSha256 ?? entry.peerSha256;\n}\n\nfunction semanticAgreementKey(agreement: ReconcileSemanticAgreement): string {\n  return `${agreement.local.path}\\0${agreement.peer.path}`;\n}\n\nexport function deriveConvergeCursorBase(\n  entries: readonly ReconcilePlanEntry[],\n  namespace: string,\n  priorSemanticAgreements: readonly ReconcileSemanticAgreement[] = [],\n): Pick<ConvergeCursorState, \"baseFiles\" | \"semanticAgreements\"> {\n  const baseFiles: ConvergeCursorFileState[] = [];\n  const semanticAgreementsByPathPair = new Map(\n    priorSemanticAgreements.map((agreement) => [semanticAgreementKey(agreement), agreement])\n  );\n  for (const entry of entries) {\n    if (entry.namespace !== namespace) continue;\n    if (entry.semanticAgreement) {\n      semanticAgreementsByPathPair.set(semanticAgreementKey(entry.semanticAgreement), entry.semanticAgreement);\n      continue;\n    }\n    const sha256 = digestAfterReconcile(entry);\n    if (sha256) baseFiles.push({ path: entry.path, sha256 });\n  }\n  baseFiles.sort((left, right) => left.path.localeCompare(right.path));\n  const semanticAgreements = [...semanticAgreementsByPathPair.values()];\n  semanticAgreements.sort((left, right) =>\n    left.local.path.localeCompare(right.local.path) || left.peer.path.localeCompare(right.peer.path)\n  );\n  return { baseFiles, semanticAgreements };\n}\n\nexport function normalizeConvergeCursor(input: unknown): ConvergeCursorState {\n  if (!input || typeof input !== \"object\" || Array.isArray(input)) {\n    throw new Error(\"converge cursor must be an object\");\n  }\n  const obj = input as Record<string, unknown>;\n  if (obj.version !== 1) {\n    throw new Error(\"converge cursor version must be 1\");\n  }\n  if (typeof obj.peerUrl !== \"string\" || !obj.peerUrl.trim()) {\n    throw new Error(\"converge cursor missing peerUrl\");\n  }\n  if (typeof obj.namespace !== \"string\" || !obj.namespace.trim()) {\n    throw new Error(\"converge cursor missing namespace\");\n  }\n  const baseFiles: ConvergeCursorFileState[] = [];\n  if (Array.isArray(obj.baseFiles)) {\n    for (const item of obj.baseFiles) {\n      if (item && typeof item === \"object\") {\n        const fileItem = item as Record<string, unknown>;\n        if (typeof fileItem.path === \"string\" && typeof fileItem.sha256 === \"string\") {\n          baseFiles.push({\n            path: fileItem.path,\n            sha256: fileItem.sha256,\n            mtimeMs: typeof fileItem.mtimeMs === \"number\" ? fileItem.mtimeMs : undefined,\n            bytes: typeof fileItem.bytes === \"number\" ? fileItem.bytes : undefined,\n          });\n        }\n      }\n    }\n  }\n  const semanticAgreements: ReconcileSemanticAgreement[] = [];\n  if (Array.isArray(obj.semanticAgreements)) {\n    for (const item of obj.semanticAgreements) {\n      if (!item || typeof item !== \"object\" || Array.isArray(item)) continue;\n      const agreement = item as Record<string, unknown>;\n      const local = normalizeSemanticFileState(agreement.local);\n      const peer = normalizeSemanticFileState(agreement.peer);\n      if (local && peer) semanticAgreements.push({ local, peer });\n    }\n  }\n  const completedPaths: string[] = [];\n  if (Array.isArray(obj.completedPaths)) {\n    for (const item of obj.completedPaths) {\n      if (typeof item === \"string\") {\n        completedPaths.push(item);\n      }\n    }\n  }\n  return {\n    version: 1,\n    peerUrl: obj.peerUrl.trim(),\n    namespace: obj.namespace.trim(),\n    lastConvergedAt: typeof obj.lastConvergedAt === \"string\" ? obj.lastConvergedAt : undefined,\n    baseFiles,\n    semanticAgreements,\n    completedPaths,\n  };\n}\n\nexport async function readConvergeCursor(\n  cursorPath: string,\n): Promise<ConvergeCursorState | null> {\n  try {\n    const raw = await fs.readFile(path.resolve(cursorPath), \"utf-8\");\n    const parsed = JSON.parse(raw);\n    return normalizeConvergeCursor(parsed);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return null;\n    return null;\n  }\n}\n\nexport async function writeConvergeCursor(\n  cursorPath: string,\n  cursor: ConvergeCursorState,\n): Promise<void> {\n  const normalized = normalizeConvergeCursor(cursor);\n  const target = path.resolve(cursorPath);\n  await fs.mkdir(path.dirname(target), { recursive: true });\n  const tmp = path.join(\n    path.dirname(target),\n    `.converge-cursor.${process.pid}.${randomUUID()}.tmp`,\n  );\n  await fs.writeFile(tmp, JSON.stringify(normalized, null, 2) + \"\\n\", \"utf-8\");\n  try {\n    await fs.rename(tmp, target);\n  } catch (error) {\n    await fs.unlink(tmp).catch(() => {});\n    throw error;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/reconcile/cursor.ts"],"sourcesContent":["import { createHash, randomUUID } from \"node:crypto\";\nimport * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport type { ReconcilePlanEntry, ReconcileSemanticAgreement } from \"./plan.js\";\n\nexport type ConvergeRefreshTarget = \"local\" | \"receiver\";\n\nexport interface ConvergeCursorFileState {\n  path: string;\n  sha256: string;\n  mtimeMs?: number;\n  bytes?: number;\n}\n\nexport interface ConvergeCursorState {\n  version: 1;\n  peerUrl: string;\n  namespace: string;\n  lastConvergedAt?: string;\n  baseFiles: ConvergeCursorFileState[];\n  semanticAgreements?: ReconcileSemanticAgreement[];\n  completedPaths?: string[];\n  pendingRefreshes?: ConvergeRefreshTarget[];\n}\n\nexport function normalizeConvergePeerUrl(peerUrl: string): string {\n  const trimmed = peerUrl.trim();\n  try {\n    const url = new URL(trimmed);\n    url.username = \"\";\n    url.password = \"\";\n    url.search = \"\";\n    url.hash = \"\";\n    url.pathname = url.pathname.replace(/\\/+$/, \"\");\n    return url.toString().replace(/\\/$/, \"\");\n  } catch {\n    return trimmed.replace(/\\/+$/, \"\");\n  }\n}\n\nexport function hashPeerNamespace(peerUrl: string, namespace: string): string {\n  const normalizedUrl = normalizeConvergePeerUrl(peerUrl);\n  const normalizedNs = namespace.trim().toLowerCase();\n  return createHash(\"sha256\")\n    .update(`${normalizedUrl}\\0${normalizedNs}`)\n    .digest(\"hex\")\n    .slice(0, 16);\n}\n\nexport function defaultConvergeCursorPath(\n  memoryDir: string,\n  peerUrl: string,\n  namespace: string,\n): string {\n  const key = hashPeerNamespace(peerUrl, namespace);\n  return path.join(path.resolve(memoryDir), \".remnic\", \"state\", \"converge-cursors\", `${key}.json`);\n}\n\nfunction normalizeSemanticFileState(input: unknown): { path: string; sha256: string } | undefined {\n  if (!input || typeof input !== \"object\" || Array.isArray(input)) return undefined;\n  const file = input as Record<string, unknown>;\n  if (typeof file.path !== \"string\" || typeof file.sha256 !== \"string\") return undefined;\n  return { path: file.path, sha256: file.sha256 };\n}\n\nfunction digestAfterReconcile(entry: ReconcilePlanEntry): string | undefined {\n  if (entry.action === \"push\") return entry.localSha256;\n  if (entry.action === \"pull\") return entry.peerSha256;\n  if (entry.action === \"conflict\") {\n    if (entry.resolution === \"local-wins\") return entry.localSha256;\n    if (entry.resolution === \"peer-wins\") return entry.peerSha256;\n    return undefined;\n  }\n  if (entry.action !== \"identical\") return undefined;\n  if (entry.localSha256 && entry.peerSha256 && entry.localSha256 !== entry.peerSha256) return undefined;\n  return entry.localSha256 ?? entry.peerSha256;\n}\n\nfunction semanticAgreementKey(agreement: ReconcileSemanticAgreement): string {\n  return `${agreement.local.path}\\0${agreement.peer.path}`;\n}\n\nexport function deriveConvergeCursorBase(\n  entries: readonly ReconcilePlanEntry[],\n  namespace: string,\n  priorSemanticAgreements: readonly ReconcileSemanticAgreement[] = [],\n): Pick<ConvergeCursorState, \"baseFiles\" | \"semanticAgreements\"> {\n  const baseFiles: ConvergeCursorFileState[] = [];\n  const semanticAgreementsByPathPair = new Map(\n    priorSemanticAgreements.map((agreement) => [semanticAgreementKey(agreement), agreement])\n  );\n  for (const entry of entries) {\n    if (entry.namespace !== namespace) continue;\n    if (entry.semanticAgreement) {\n      semanticAgreementsByPathPair.set(semanticAgreementKey(entry.semanticAgreement), entry.semanticAgreement);\n      continue;\n    }\n    const sha256 = digestAfterReconcile(entry);\n    if (sha256) baseFiles.push({ path: entry.path, sha256 });\n  }\n  baseFiles.sort((left, right) => left.path.localeCompare(right.path));\n  const semanticAgreements = [...semanticAgreementsByPathPair.values()];\n  semanticAgreements.sort((left, right) =>\n    left.local.path.localeCompare(right.local.path) || left.peer.path.localeCompare(right.peer.path)\n  );\n  return { baseFiles, semanticAgreements };\n}\n\nexport function normalizeConvergeCursor(input: unknown): ConvergeCursorState {\n  if (!input || typeof input !== \"object\" || Array.isArray(input)) {\n    throw new Error(\"converge cursor must be an object\");\n  }\n  const obj = input as Record<string, unknown>;\n  if (obj.version !== 1) {\n    throw new Error(\"converge cursor version must be 1\");\n  }\n  if (typeof obj.peerUrl !== \"string\" || !obj.peerUrl.trim()) {\n    throw new Error(\"converge cursor missing peerUrl\");\n  }\n  if (typeof obj.namespace !== \"string\" || !obj.namespace.trim()) {\n    throw new Error(\"converge cursor missing namespace\");\n  }\n  const baseFiles: ConvergeCursorFileState[] = [];\n  if (Array.isArray(obj.baseFiles)) {\n    for (const item of obj.baseFiles) {\n      if (item && typeof item === \"object\") {\n        const fileItem = item as Record<string, unknown>;\n        if (typeof fileItem.path === \"string\" && typeof fileItem.sha256 === \"string\") {\n          baseFiles.push({\n            path: fileItem.path,\n            sha256: fileItem.sha256,\n            mtimeMs: typeof fileItem.mtimeMs === \"number\" ? fileItem.mtimeMs : undefined,\n            bytes: typeof fileItem.bytes === \"number\" ? fileItem.bytes : undefined,\n          });\n        }\n      }\n    }\n  }\n  const semanticAgreements: ReconcileSemanticAgreement[] = [];\n  if (Array.isArray(obj.semanticAgreements)) {\n    for (const item of obj.semanticAgreements) {\n      if (!item || typeof item !== \"object\" || Array.isArray(item)) continue;\n      const agreement = item as Record<string, unknown>;\n      const local = normalizeSemanticFileState(agreement.local);\n      const peer = normalizeSemanticFileState(agreement.peer);\n      if (local && peer) semanticAgreements.push({ local, peer });\n    }\n  }\n  const completedPaths: string[] = [];\n  if (Array.isArray(obj.completedPaths)) {\n    for (const item of obj.completedPaths) {\n      if (typeof item === \"string\") {\n        completedPaths.push(item);\n      }\n    }\n  }\n  const pendingRefreshes: ConvergeRefreshTarget[] = [];\n  if (Array.isArray(obj.pendingRefreshes)) {\n    if (obj.pendingRefreshes.includes(\"local\")) pendingRefreshes.push(\"local\");\n    if (obj.pendingRefreshes.includes(\"receiver\")) pendingRefreshes.push(\"receiver\");\n  }\n  return {\n    version: 1,\n    peerUrl: obj.peerUrl.trim(),\n    namespace: obj.namespace.trim(),\n    lastConvergedAt: typeof obj.lastConvergedAt === \"string\" ? obj.lastConvergedAt : undefined,\n    baseFiles,\n    semanticAgreements,\n    completedPaths,\n    pendingRefreshes,\n  };\n}\n\nexport async function readConvergeCursor(\n  cursorPath: string,\n): Promise<ConvergeCursorState | null> {\n  try {\n    const raw = await fs.readFile(path.resolve(cursorPath), \"utf-8\");\n    const parsed = JSON.parse(raw);\n    return normalizeConvergeCursor(parsed);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return null;\n    return null;\n  }\n}\n\nexport async function writeConvergeCursor(\n  cursorPath: string,\n  cursor: ConvergeCursorState,\n): Promise<void> {\n  const normalized = normalizeConvergeCursor(cursor);\n  const target = path.resolve(cursorPath);\n  await fs.mkdir(path.dirname(target), { recursive: true });\n  const tmp = path.join(\n    path.dirname(target),\n    `.converge-cursor.${process.pid}.${randomUUID()}.tmp`,\n  );\n  await fs.writeFile(tmp, JSON.stringify(normalized, null, 2) + \"\\n\", \"utf-8\");\n  try {\n    await fs.rename(tmp, target);\n  } catch (error) {\n    await fs.unlink(tmp).catch(() => {});\n    throw error;\n  }\n}\n\nexport async function markConvergeRefreshPending(\n  cursorPath: string,\n  options: {\n    peerUrl: string;\n    namespace: string;\n    target: ConvergeRefreshTarget;\n  },\n): Promise<void> {\n  const current = await readConvergeCursor(cursorPath);\n  const pendingRefreshes = new Set(current?.pendingRefreshes ?? []);\n  pendingRefreshes.add(options.target);\n  await writeConvergeCursor(cursorPath, {\n    version: 1,\n    peerUrl: current?.peerUrl ?? options.peerUrl,\n    namespace: current?.namespace ?? options.namespace,\n    lastConvergedAt: current?.lastConvergedAt,\n    baseFiles: current?.baseFiles ?? [],\n    semanticAgreements: current?.semanticAgreements ?? [],\n    completedPaths: current?.completedPaths ?? [],\n    pendingRefreshes: [...pendingRefreshes].sort(),\n  });\n}\n\nexport async function clearConvergeRefreshPending(\n  cursorPath: string,\n  target: ConvergeRefreshTarget,\n): Promise<void> {\n  const current = await readConvergeCursor(cursorPath);\n  if (!current?.pendingRefreshes?.includes(target)) return;\n  await writeConvergeCursor(cursorPath, {\n    ...current,\n    pendingRefreshes: current.pendingRefreshes.filter((pending) => pending !== target),\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/reconcile/manifest.d.ts

@@ -1,8 +1,9 @@
-import { x as MemoryStatus } from '../types-rEwubvim.js';
+import { y as MemoryStatus, l as MemoryFrontmatter } from '../types-yX_FwERf.js';
 import { ReconcileFileState, ReconcilePlan, ReconcileSemanticAgreement } from './plan.js';
 import '../message-parts/index.js';
 import '../bounded-jsonl-state.js';
 import '../operator-doctor-types.js';
+import '../external-wiki-config.js';
 import '../types-continuity.js';
 import '../offline-sync.js';
 
@@ -22,12 +23,18 @@ interface ReconcileManifest {
     schemaVersion: typeof RECONCILE_MANIFEST_SCHEMA_VERSION;
     files: ReconcileManifestFile[];
 }
+type ReconcileMemoryParser = (raw: string) => {
+    frontmatter: MemoryFrontmatter;
+    content: string;
+} | null;
 interface BuildReconcileManifestOptions {
     files: Iterable<ReconcileFileState>;
     readFile: (file: ReconcileFileState) => Promise<Buffer | string | null>;
+    parseMemory: ReconcileMemoryParser;
     cachedFiles?: Iterable<ReconcileManifestFile>;
 }
+declare function buildReconcileManifestFile(file: ReconcileFileState, readFile: (file: ReconcileFileState) => Promise<Buffer | string | null>, parseMemory: ReconcileMemoryParser): Promise<ReconcileManifestFile>;
 declare function buildReconcileManifest(options: BuildReconcileManifestOptions): Promise<ReconcileManifest>;
 declare function collapseActiveFactDuplicates(plan: ReconcilePlan, localManifests: ReadonlyMap<string, ReconcileManifest>, peerManifests: ReadonlyMap<string, ReconcileManifest>, priorSemanticAgreements?: ReadonlyMap<string, readonly ReconcileSemanticAgreement[]>): ReconcilePlan;
 
-export { type BuildReconcileManifestOptions, RECONCILE_MANIFEST_FORMAT, RECONCILE_MANIFEST_SCHEMA_VERSION, type ReconcileManifest, type ReconcileManifestFile, type ReconcileMemoryIdentity, buildReconcileManifest, collapseActiveFactDuplicates };
+export { type BuildReconcileManifestOptions, RECONCILE_MANIFEST_FORMAT, RECONCILE_MANIFEST_SCHEMA_VERSION, type ReconcileManifest, type ReconcileManifestFile, type ReconcileMemoryIdentity, type ReconcileMemoryParser, buildReconcileManifest, buildReconcileManifestFile, collapseActiveFactDuplicates };