@remnic/core 9.69.33 → 9.69.34

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

@@ -1,10 +1,11 @@
 import { RecallXraySnapshot } from './recall-xray.js';
 import './memory-provenance.js';
-import './types-igV4-sbB.js';
+import './types-BGxTvLBO.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
+import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './deep-recall-config.js';

package/dist/recall-xray-renderer.js

@@ -5,10 +5,10 @@ import {
   renderXrayJson,
   renderXrayMarkdown,
   renderXrayText
-} from "./chunk-22FVR2KE.js";
+} from "./chunk-4MIS4CQW.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-2JVJ7UHC.js";
-import "./chunk-SO7SV523.js";
+import "./chunk-XQU3CPF2.js";
+import "./chunk-Q6LCCIZN.js";
 import "./chunk-TOTT6S2V.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";

package/dist/recall-xray.d.ts

@@ -1,5 +1,6 @@
 import { RetrievedMemoryProvenance } from './memory-provenance.js';
-import { b as RecallTierExplain, o as RecallDisclosure } from './types-igV4-sbB.js';
+import { b as RecallTierExplain, o as RecallDisclosure } from './types-BGxTvLBO.js';
+import { StateLabel } from './recall-state-view.js';
 import './user-model.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
@@ -187,6 +188,13 @@ interface RecallXrayResult {
         quarantined: boolean;
         quarantineReason?: string;
     };
+    /**
+     * #1952 — recall state-view label for this result (`current`,
+     * `historical`, or `transition`). Present only when state views were
+     * active for the recall AND the result was annotated at the inject
+     * seam; absent otherwise, so legacy snapshots round-trip unchanged.
+     */
+    stateView?: StateLabel;
 }
 /**
  * Trace entry for a filter the orchestrator evaluated during recall.

package/dist/recall-xray.js

@@ -5,8 +5,8 @@ import {
   estimateRecallTokens,
   isRecallXrayServedBy,
   summarizeDisclosureTokens
-} from "./chunk-2JVJ7UHC.js";
-import "./chunk-SO7SV523.js";
+} from "./chunk-XQU3CPF2.js";
+import "./chunk-Q6LCCIZN.js";
 import "./chunk-TOTT6S2V.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";

package/dist/reconcile/cursor.d.ts

@@ -1,11 +1,12 @@
 import { ReconcileSemanticAgreement, ReconcilePlanEntry } from './plan.js';
 import '../offline-sync.js';
 import '../offline-sync-file-io.js';
-import '../types-igV4-sbB.js';
+import '../types-BGxTvLBO.js';
 import '../message-parts/index.js';
 import '../bounded-jsonl-state.js';
 import '../operator-doctor-types.js';
 import '../external-wiki-config.js';
+import '../recall-state-view.js';
 import '../contradiction-config.js';
 import '../graph-path-scoring-config.js';
 import '../deep-recall-config.js';
@@ -35,6 +36,14 @@ interface ConvergeCursorState {
 declare function normalizeConvergePeerUrl(peerUrl: string): string;
 declare function hashPeerNamespace(peerUrl: string, namespace: string): string;
 declare function defaultConvergeCursorPath(memoryDir: string, peerUrl: string, namespace: string): string;
+/**
+ * Persistent identity cache location for a (peerUrl, namespace) pair, next
+ * to the cursor that governs the same pair. The cache stores the parsed
+ * memory identity per path keyed by content sha, so a warm manifest build
+ * skips the per-file read + frontmatter parse + content-hash identity work
+ * entirely (the dominant boot-scale plan cost on both sides).
+ */
+declare function convergeIdentityCachePath(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>;
@@ -46,4 +55,4 @@ declare function markConvergeRefreshPending(cursorPath: string, options: {
 }): Promise<void>;
 declare function clearConvergeRefreshPending(cursorPath: string, target: ConvergeRefreshTarget): Promise<void>;
 
-export { type ConvergeCursorFileState, type ConvergeCursorState, type ConvergeRefreshTarget, clearConvergeRefreshPending, defaultConvergeCursorPath, deriveConvergeCursorBase, hashPeerNamespace, markConvergeRefreshPending, normalizeConvergeCursor, normalizeConvergePeerUrl, readConvergeCursor, writeConvergeCursor };
+export { type ConvergeCursorFileState, type ConvergeCursorState, type ConvergeRefreshTarget, clearConvergeRefreshPending, convergeIdentityCachePath, defaultConvergeCursorPath, deriveConvergeCursorBase, hashPeerNamespace, markConvergeRefreshPending, normalizeConvergeCursor, normalizeConvergePeerUrl, readConvergeCursor, writeConvergeCursor };

package/dist/reconcile/cursor.js

@@ -39,6 +39,10 @@ function defaultConvergeCursorPath(memoryDir, peerUrl, namespace) {
   const key = hashPeerNamespace(peerUrl, namespace);
   return path.join(path.resolve(memoryDir), ".remnic", "state", "converge-cursors", `${key}.json`);
 }
+function convergeIdentityCachePath(memoryDir, peerUrl, namespace) {
+  const key = hashPeerNamespace(peerUrl, namespace);
+  return path.join(path.resolve(memoryDir), ".remnic", "state", "converge-identity", `identity-${key}.json`);
+}
 function normalizeSemanticFileState(input) {
   if (!input || typeof input !== "object" || Array.isArray(input)) return void 0;
   const file = input;
@@ -156,10 +160,7 @@ async function writeConvergeCursor(cursorPath, cursor) {
   const normalized = normalizeConvergeCursor(cursor);
   const target = path.resolve(cursorPath);
   await fs.mkdir(path.dirname(target), { recursive: true });
-  const tmp = path.join(
-    path.dirname(target),
-    `.converge-cursor.${process.pid}.${randomUUID()}.tmp`
-  );
+  const tmp = path.join(path.dirname(target), `.converge-cursor.${process.pid}.${randomUUID()}.tmp`);
   await fs.writeFile(tmp, JSON.stringify(normalized, null, 2) + "\n", "utf-8");
   try {
     await fs.rename(tmp, target);
@@ -194,6 +195,7 @@ async function clearConvergeRefreshPending(cursorPath, target) {
 }
 export {
   clearConvergeRefreshPending,
+  convergeIdentityCachePath,
   defaultConvergeCursorPath,
   deriveConvergeCursorBase,
   hashPeerNamespace,

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 {\n  type ReconcilePlanEntry,\n  type ReconcileSemanticAgreement,\n  semanticAgreementKey,\n} 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\n/**\n * Linear trailing-slash trim. `/\\/+$/` backtracks quadratically on long\n * slash runs that do not end in a slash (CodeQL js/polynomial-redos); a\n * bounded character loop cannot.\n */\nfunction stripTrailingSlashes(value: string): string {\n  let end = value.length;\n  while (end > 0 && value[end - 1] === \"/\") end -= 1;\n  return end === value.length ? value : value.slice(0, end);\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 = stripTrailingSlashes(url.pathname);\n    return url.toString().replace(/\\/$/, \"\");\n  } catch {\n    return stripTrailingSlashes(trimmed);\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\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":[]}
+{"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, type ReconcileSemanticAgreement, semanticAgreementKey } 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\n/**\n * Linear trailing-slash trim. `/\\/+$/` backtracks quadratically on long\n * slash runs that do not end in a slash (CodeQL js/polynomial-redos); a\n * bounded character loop cannot.\n */\nfunction stripTrailingSlashes(value: string): string {\n  let end = value.length;\n  while (end > 0 && value[end - 1] === \"/\") end -= 1;\n  return end === value.length ? value : value.slice(0, end);\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 = stripTrailingSlashes(url.pathname);\n    return url.toString().replace(/\\/$/, \"\");\n  } catch {\n    return stripTrailingSlashes(trimmed);\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\").update(`${normalizedUrl}\\0${normalizedNs}`).digest(\"hex\").slice(0, 16);\n}\n\nexport function defaultConvergeCursorPath(memoryDir: string, peerUrl: string, namespace: string): string {\n  const key = hashPeerNamespace(peerUrl, namespace);\n  return path.join(path.resolve(memoryDir), \".remnic\", \"state\", \"converge-cursors\", `${key}.json`);\n}\n\n/**\n * Persistent identity cache location for a (peerUrl, namespace) pair, next\n * to the cursor that governs the same pair. The cache stores the parsed\n * memory identity per path keyed by content sha, so a warm manifest build\n * skips the per-file read + frontmatter parse + content-hash identity work\n * entirely (the dominant boot-scale plan cost on both sides).\n */\nexport function convergeIdentityCachePath(memoryDir: string, peerUrl: string, namespace: string): string {\n  const key = hashPeerNamespace(peerUrl, namespace);\n  return path.join(path.resolve(memoryDir), \".remnic\", \"state\", \"converge-identity\", `identity-${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\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(\n    (left, right) => 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(cursorPath: string): 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(cursorPath: string, cursor: ConvergeCursorState): 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(path.dirname(target), `.converge-cursor.${process.pid}.${randomUUID()}.tmp`);\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(cursorPath: string, target: ConvergeRefreshTarget): 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,9 +1,10 @@
-import { w as MemoryStatus, m as MemoryFrontmatter } from '../types-igV4-sbB.js';
+import { x as MemoryStatus, m as MemoryFrontmatter } from '../types-BGxTvLBO.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 '../recall-state-view.js';
 import '../contradiction-config.js';
 import '../graph-path-scoring-config.js';
 import '../deep-recall-config.js';
@@ -17,6 +18,16 @@ import '../offline-sync-file-io.js';
 
 declare const RECONCILE_MANIFEST_FORMAT = "remnic-reconcile-manifest";
 declare const RECONCILE_MANIFEST_SCHEMA_VERSION = 1;
+declare const CONTENT_HASH_NORMALIZER_VERSION = 4;
+/**
+ * Version of the identity-resolution LOGIC (alias recovery, candidate
+ * ordering), independent of the content normalizer: a cached manifest entry
+ * written before an identity-resolution change carries an older value and is
+ * reparsed even when its normalizerVersion still matches (issue #2367
+ * review round 2). Bump when parsedMemoryIdentity's output shape or
+ * semantics change.
+ */
+declare const IDENTITY_RESOLUTION_VERSION = 2;
 interface ReconcileMemoryIdentity {
     id: string;
     category: string;
@@ -35,6 +46,9 @@ interface ReconcileMemoryIdentity {
 }
 interface ReconcileManifestFile extends ReconcileFileState {
     memory?: ReconcileMemoryIdentity;
+    /** Present on sha-only (negative) entries so an upgrade re-parses them. */
+    normalizerVersion?: number;
+    identityResolutionVersion?: number;
 }
 interface ReconcileManifest {
     format: typeof RECONCILE_MANIFEST_FORMAT;
@@ -52,8 +66,29 @@ interface BuildReconcileManifestOptions {
     cachedFiles?: Iterable<ReconcileManifestFile>;
     citationTemplate?: string;
 }
+/**
+ * Stable fingerprint of the citation template that `parsedMemoryIdentity` uses
+ * to strip inline attribution before hashing. A persisted identity cache is
+ * only reusable while this matches: identical file content under a different
+ * template yields a different `contentHash`, which would silently change
+ * duplicate and conflict decisions on a warm plan.
+ */
+declare function citationTemplateFingerprint(citationTemplate?: string): string;
+/**
+ * Structural guard for identities read back from an on-disk cache. A cache file
+ * is untrusted JSON: without this an entry carrying `memory: null` survives the
+ * loader's cast and then throws when the hit path dereferences
+ * `memory.normalizerVersion`, aborting a manifest build that should instead
+ * fall back to a cold parse.
+ */
+declare function isReconcileMemoryIdentity(value: unknown): value is ReconcileMemoryIdentity;
+/** A cache hit is valid only when the entry was built by the current parser.
+ * Positive hits carry versions on `memory`; sha-only negatives stamp the same
+ * versions on the entry itself. Unversioned negatives are pre-upgrade leftovers
+ * and must miss so a newer parser can recognize an identity it previously skipped. */
+declare function isCachedIdentityReusable(cached: ReconcileManifestFile): boolean;
 declare function buildReconcileManifestFile(file: ReconcileFileState, readFile: (file: ReconcileFileState) => Promise<Buffer | string | null>, parseMemory: ReconcileMemoryParser, citationTemplate?: string): 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, type ReconcileMemoryParser, buildReconcileManifest, buildReconcileManifestFile, collapseActiveFactDuplicates };
+export { type BuildReconcileManifestOptions, CONTENT_HASH_NORMALIZER_VERSION, IDENTITY_RESOLUTION_VERSION, RECONCILE_MANIFEST_FORMAT, RECONCILE_MANIFEST_SCHEMA_VERSION, type ReconcileManifest, type ReconcileManifestFile, type ReconcileMemoryIdentity, type ReconcileMemoryParser, buildReconcileManifest, buildReconcileManifestFile, citationTemplateFingerprint, collapseActiveFactDuplicates, isCachedIdentityReusable, isReconcileMemoryIdentity };

package/dist/reconcile/manifest.js

@@ -1,22 +1,27 @@
 import {
+  CONTENT_HASH_NORMALIZER_VERSION,
+  IDENTITY_RESOLUTION_VERSION,
   RECONCILE_MANIFEST_FORMAT,
   RECONCILE_MANIFEST_SCHEMA_VERSION,
   buildReconcileManifest,
   buildReconcileManifestFile,
-  collapseActiveFactDuplicates
-} from "../chunk-FDLDOEO6.js";
+  citationTemplateFingerprint,
+  collapseActiveFactDuplicates,
+  isCachedIdentityReusable,
+  isReconcileMemoryIdentity
+} from "../chunk-UBG4GAEP.js";
 import "../chunk-PAAJWQH5.js";
 import "../chunk-TG3FAM2S.js";
 import "../chunk-6MINUTGJ.js";
 import "../chunk-7RJUVTVF.js";
+import "../chunk-GCGJW34D.js";
+import "../chunk-LQWOFU6L.js";
 import "../chunk-NB3LRY4T.js";
 import "../chunk-5FVVY2EB.js";
 import "../chunk-FFAZ2XFU.js";
 import "../chunk-JDSVLVCG.js";
 import "../chunk-5GKPFL3S.js";
 import "../chunk-JAKIDQB2.js";
-import "../chunk-GCGJW34D.js";
-import "../chunk-LQWOFU6L.js";
 import "../chunk-VUFL7X3H.js";
 import "../chunk-JN72EPOE.js";
 import "../chunk-A6XUJE5D.js";
@@ -25,10 +30,15 @@ import "../chunk-KNA3BXXL.js";
 import "../chunk-3WCASNQZ.js";
 import "../chunk-PZ5AY32C.js";
 export {
+  CONTENT_HASH_NORMALIZER_VERSION,
+  IDENTITY_RESOLUTION_VERSION,
   RECONCILE_MANIFEST_FORMAT,
   RECONCILE_MANIFEST_SCHEMA_VERSION,
   buildReconcileManifest,
   buildReconcileManifestFile,
-  collapseActiveFactDuplicates
+  citationTemplateFingerprint,
+  collapseActiveFactDuplicates,
+  isCachedIdentityReusable,
+  isReconcileMemoryIdentity
 };
 //# sourceMappingURL=manifest.js.map

package/dist/reconcile/plan.d.ts

@@ -1,10 +1,11 @@
 import { OfflineSyncFileState } from '../offline-sync.js';
-import { a2 as ConvergeConflictPolicy } from '../types-igV4-sbB.js';
+import { a2 as ConvergeConflictPolicy } from '../types-BGxTvLBO.js';
 import '../offline-sync-file-io.js';
 import '../message-parts/index.js';
 import '../bounded-jsonl-state.js';
 import '../operator-doctor-types.js';
 import '../external-wiki-config.js';
+import '../recall-state-view.js';
 import '../contradiction-config.js';
 import '../graph-path-scoring-config.js';
 import '../deep-recall-config.js';

package/dist/replay/normalizers/chatgpt.d.ts

@@ -1,9 +1,10 @@
 import { ReplayNormalizer } from '../types.js';
 import '../../message-parts/index.js';
-import '../../types-igV4-sbB.js';
+import '../../types-BGxTvLBO.js';
 import '../../bounded-jsonl-state.js';
 import '../../operator-doctor-types.js';
 import '../../external-wiki-config.js';
+import '../../recall-state-view.js';
 import '../../contradiction-config.js';
 import '../../graph-path-scoring-config.js';
 import '../../deep-recall-config.js';

package/dist/replay/normalizers/claude.d.ts

@@ -1,9 +1,10 @@
 import { ReplayNormalizer } from '../types.js';
 import '../../message-parts/index.js';
-import '../../types-igV4-sbB.js';
+import '../../types-BGxTvLBO.js';
 import '../../bounded-jsonl-state.js';
 import '../../operator-doctor-types.js';
 import '../../external-wiki-config.js';
+import '../../recall-state-view.js';
 import '../../contradiction-config.js';
 import '../../graph-path-scoring-config.js';
 import '../../deep-recall-config.js';

package/dist/replay/normalizers/openclaw.d.ts

@@ -1,9 +1,10 @@
 import { ReplayNormalizer } from '../types.js';
 import '../../message-parts/index.js';
-import '../../types-igV4-sbB.js';
+import '../../types-BGxTvLBO.js';
 import '../../bounded-jsonl-state.js';
 import '../../operator-doctor-types.js';
 import '../../external-wiki-config.js';
+import '../../recall-state-view.js';
 import '../../contradiction-config.js';
 import '../../graph-path-scoring-config.js';
 import '../../deep-recall-config.js';

package/dist/replay/normalizers/shared.d.ts

@@ -1,9 +1,10 @@
 import { ReplayRole } from '../types.js';
 import '../../message-parts/index.js';
-import '../../types-igV4-sbB.js';
+import '../../types-BGxTvLBO.js';
 import '../../bounded-jsonl-state.js';
 import '../../operator-doctor-types.js';
 import '../../external-wiki-config.js';
+import '../../recall-state-view.js';
 import '../../contradiction-config.js';
 import '../../graph-path-scoring-config.js';
 import '../../deep-recall-config.js';

package/dist/replay/runner.d.ts

@@ -1,9 +1,10 @@
 import { ReplaySource, ReplayWarning, ReplayNormalizer, ReplayTurn, ReplayParseOptions } from './types.js';
 import '../message-parts/index.js';
-import '../types-igV4-sbB.js';
+import '../types-BGxTvLBO.js';
 import '../bounded-jsonl-state.js';
 import '../operator-doctor-types.js';
 import '../external-wiki-config.js';
+import '../recall-state-view.js';
 import '../contradiction-config.js';
 import '../graph-path-scoring-config.js';
 import '../deep-recall-config.js';

package/dist/replay/types.d.ts

@@ -1,8 +1,9 @@
 import { LcmMessagePartInput, MessagePartSourceFormat } from '../message-parts/index.js';
-import { p as SourceConnectorProvenance } from '../types-igV4-sbB.js';
+import { p as SourceConnectorProvenance } from '../types-BGxTvLBO.js';
 import '../bounded-jsonl-state.js';
 import '../operator-doctor-types.js';
 import '../external-wiki-config.js';
+import '../recall-state-view.js';
 import '../contradiction-config.js';
 import '../graph-path-scoring-config.js';
 import '../deep-recall-config.js';

package/dist/replica-divergence.d.ts

@@ -1,12 +1,13 @@
 import { TokenCapabilities } from './access-token-capabilities.js';
 import { CorpusWatermark } from './corpus-watermark.js';
-import { _ as ReplicaPeersConfig, $ as ReplicaPeerConfig } from './types-igV4-sbB.js';
+import { _ as ReplicaPeersConfig, $ as ReplicaPeerConfig } from './types-BGxTvLBO.js';
 import { ResolveSecretRefFn } from './resolve-auth-token.js';
 import 'node:async_hooks';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
+import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './deep-recall-config.js';

package/dist/replica-peers-config.d.ts

@@ -1,8 +1,9 @@
-export { $ as ReplicaPeerConfig, _ as ReplicaPeersConfig, dp as parseReplicaPeersConfig, dq as resolveReplicaPeersConfig } from './types-igV4-sbB.js';
+export { $ as ReplicaPeerConfig, _ as ReplicaPeersConfig, ds as parseReplicaPeersConfig, dt as resolveReplicaPeersConfig } from './types-BGxTvLBO.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
+import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './deep-recall-config.js';

package/dist/{resolution-VKATP2HT.js → resolution-OHJZG45O.js}

@@ -1,21 +1,21 @@
 import {
   executeResolution,
   isValidResolutionVerb
-} from "./chunk-XOVKXJEP.js";
-import "./chunk-YYGZJPOK.js";
+} from "./chunk-R3TLVTWW.js";
+import "./chunk-42DJ235G.js";
 import "./chunk-CTVWELNK.js";
 import "./chunk-XCB6QDL6.js";
 import "./chunk-RBOJCG4T.js";
-import "./chunk-3QQTXYZ6.js";
-import "./chunk-BT7NVCML.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-RGMVMVMF.js";
+import "./chunk-PWPIERBM.js";
+import "./chunk-LSLCFCCQ.js";
+import "./chunk-BT7NVCML.js";
 import "./chunk-VYCOJKSX.js";
 import "./chunk-NB3LRY4T.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-FFAZ2XFU.js";
-import "./chunk-EEOUMG3J.js";
 import "./chunk-JDSVLVCG.js";
 import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
@@ -33,4 +33,4 @@ export {
   executeResolution,
   isValidResolutionVerb
 };
-//# sourceMappingURL=resolution-VKATP2HT.js.map
+//# sourceMappingURL=resolution-OHJZG45O.js.map

package/dist/resolution-OHJZG45O.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/resolve-auth-token.d.ts

@@ -1,8 +1,9 @@
-import { u as SecretRef, v as AgentAccessAuthToken } from './types-igV4-sbB.js';
+import { v as SecretRef, w as AgentAccessAuthToken } from './types-BGxTvLBO.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
+import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './deep-recall-config.js';

package/dist/resume-bundles.js

@@ -4,18 +4,18 @@ import {
   recordResumeBundle,
   resolveResumeBundleDir,
   validateResumeBundle
-} from "./chunk-BPJNF7J2.js";
+} from "./chunk-6CCRSQWT.js";
 import "./chunk-G7NYVKD6.js";
 import "./chunk-AM4T6CHX.js";
 import "./chunk-KFY3SGN7.js";
 import "./chunk-NHLLKEKK.js";
-import "./chunk-MFDTVQJX.js";
+import "./chunk-SZWEDG3H.js";
 import "./chunk-ZKOPY4WW.js";
 import "./chunk-62OKGIJA.js";
-import "./chunk-5VCDKQWQ.js";
+import "./chunk-5HYUUFMQ.js";
 import "./chunk-I3H5LFOI.js";
 import "./chunk-Z3O53WZR.js";
-import "./chunk-H3TKENU4.js";
+import "./chunk-WIKO4SCR.js";
 import "./chunk-Z5LAYHGJ.js";
 import "./chunk-6ZMAMSHS.js";
 import "./chunk-6ZN34ISG.js";
@@ -34,6 +34,7 @@ import "./chunk-HM7RHKS4.js";
 import "./chunk-QLK3SL7Q.js";
 import "./chunk-FEHIOYML.js";
 import "./chunk-P32IDSHD.js";
+import "./chunk-255PC37A.js";
 import "./chunk-WNIUPHWV.js";
 import "./chunk-IJ6WHMFB.js";
 import "./chunk-3SG4FGDV.js";
@@ -46,26 +47,27 @@ import "./chunk-B3O3IRZN.js";
 import "./chunk-353KGBKY.js";
 import "./chunk-ZIKENA2C.js";
 import "./chunk-353C5UNV.js";
-import "./chunk-VYCOJKSX.js";
 import "./chunk-6Q3ZTEF6.js";
+import "./chunk-RGMVMVMF.js";
 import "./chunk-YCVB7X56.js";
 import "./chunk-TOTT6S2V.js";
 import "./chunk-PQVCH2AE.js";
 import "./chunk-PJKTFXE2.js";
 import "./chunk-6MINUTGJ.js";
 import "./chunk-7RJUVTVF.js";
-import "./chunk-NB3LRY4T.js";
-import "./chunk-5FVVY2EB.js";
-import "./chunk-FFAZ2XFU.js";
-import "./chunk-JDSVLVCG.js";
-import "./chunk-5GKPFL3S.js";
-import "./chunk-JAKIDQB2.js";
+import "./chunk-VYCOJKSX.js";
 import "./chunk-WQZZDN5M.js";
 import "./chunk-UI3NYK34.js";
 import "./chunk-GCGJW34D.js";
 import "./chunk-AREGMX2J.js";
 import "./chunk-3BTFBQLO.js";
 import "./chunk-LQWOFU6L.js";
+import "./chunk-NB3LRY4T.js";
+import "./chunk-5FVVY2EB.js";
+import "./chunk-FFAZ2XFU.js";
+import "./chunk-JDSVLVCG.js";
+import "./chunk-5GKPFL3S.js";
+import "./chunk-JAKIDQB2.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";

package/dist/retrieval-agents.d.ts

@@ -1,9 +1,10 @@
-import { Q as QmdSearchResult } from './types-igV4-sbB.js';
-import { Q as QmdClient } from './qmd-Cvw9RWKr.js';
+import { Q as QmdSearchResult } from './types-BGxTvLBO.js';
+import { Q as QmdClient } from './qmd-Mj508lHA.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
+import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './deep-recall-config.js';

package/dist/retrieval-tiers.d.ts

@@ -1,8 +1,9 @@
-import { aK as RetrievalTier } from './types-igV4-sbB.js';
+import { aK as RetrievalTier } from './types-BGxTvLBO.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
 import './operator-doctor-types.js';
 import './external-wiki-config.js';
+import './recall-state-view.js';
 import './contradiction-config.js';
 import './graph-path-scoring-config.js';
 import './deep-recall-config.js';

package/dist/routing/engine.d.ts

@@ -1,8 +1,9 @@
-import { y as MemoryCategory } from '../types-igV4-sbB.js';
+import { u as MemoryCategory } from '../types-BGxTvLBO.js';
 import '../message-parts/index.js';
 import '../bounded-jsonl-state.js';
 import '../operator-doctor-types.js';
 import '../external-wiki-config.js';
+import '../recall-state-view.js';
 import '../contradiction-config.js';
 import '../graph-path-scoring-config.js';
 import '../deep-recall-config.js';

package/dist/routing/store.d.ts

@@ -1,9 +1,10 @@
 import { RoutingEngineOptions, RouteRule } from './engine.js';
-import '../types-igV4-sbB.js';
+import '../types-BGxTvLBO.js';
 import '../message-parts/index.js';
 import '../bounded-jsonl-state.js';
 import '../operator-doctor-types.js';
 import '../external-wiki-config.js';
+import '../recall-state-view.js';
 import '../contradiction-config.js';
 import '../graph-path-scoring-config.js';
 import '../deep-recall-config.js';

package/dist/runtime/child-process.d.ts

@@ -2,7 +2,7 @@ type ProcessOptions = Record<string, unknown>;
 type ProcessStream = {
     destroyed?: boolean;
     destroy: () => void;
-    end: () => void;
+    end: (chunk?: string | Buffer, callback?: (error?: Error | null) => void) => void;
     on: (event: string, listener: (...args: any[]) => void) => ProcessStream;
     once: (event: string, listener: (...args: any[]) => void) => ProcessStream;
     setEncoding: (encoding: BufferEncoding) => void;

package/dist/runtime/child-process.js

@@ -1,7 +1,7 @@
 import {
   launchProcess,
   launchProcessSync
-} from "../chunk-O75CRYGF.js";
+} from "../chunk-ZEFVK7XC.js";
 import "../chunk-PZ5AY32C.js";
 export {
   launchProcess,