@remnic/core 1.1.2 → 1.1.3

package/dist/chunk-74EMIVE4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/capsule-cli.ts"],"sourcesContent":["/**\n * Pure-function helpers for the `remnic capsule` CLI surface (issue #676 PR 6/6).\n *\n * All functions here are free of orchestrator / filesystem side-effects so\n * they can be unit-tested without booting the gateway (CLAUDE.md rules 14, 51).\n *\n * Responsibilities:\n *  - Input validation + option parsing for every capsule sub-command flag.\n *  - Rendering of `capsule list` and `capsule inspect` output in text /\n *    markdown / json forms.\n *\n * The actual I/O (export, import, merge, directory listing, manifest read) is\n * wired in `cli.ts` because those operations need the orchestrator's config.\n */\n\nimport path from \"node:path\";\n\n// ---------------------------------------------------------------------------\n// Shared types\n// ---------------------------------------------------------------------------\n\nexport type CapsuleOutputFormat = \"text\" | \"markdown\" | \"json\";\n\n/**\n * Metadata entry returned by `capsule list` for a single archive file found\n * in the capsule store directory.\n */\nexport interface CapsuleListEntry {\n  /** Capsule id extracted from the filename (slug before `.capsule.json.gz`). */\n  id: string;\n  /** Absolute path to the `.capsule.json.gz` archive. */\n  archivePath: string;\n  /** Absolute path to the sidecar `.manifest.json`, or null if missing. */\n  manifestPath: string | null;\n  /** `createdAt` ISO string from the sidecar manifest, or null if unreadable. */\n  createdAt: string | null;\n  /** `pluginVersion` from the sidecar manifest, or null. */\n  pluginVersion: string | null;\n  /** `files` array length from the sidecar manifest, or null. */\n  fileCount: number | null;\n  /** `capsule.description` from the sidecar manifest, or null. */\n  description: string | null;\n}\n\n// ---------------------------------------------------------------------------\n// Validation helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Validate and coerce the `--format` flag value.\n *\n * Rule 51: invalid values must throw with a listed-options error, not silently\n * fall back to a default.\n */\nexport function parseCapsuleOutputFormat(\n  raw: unknown,\n): CapsuleOutputFormat {\n  if (raw === undefined || raw === null) return \"text\";\n  if (typeof raw !== \"string\" || raw.trim() === \"\") {\n    throw new Error(\n      `--format expects one of text, markdown, json; got ${JSON.stringify(raw)}`,\n    );\n  }\n  const v = raw.trim() as CapsuleOutputFormat;\n  if (v !== \"text\" && v !== \"markdown\" && v !== \"json\") {\n    throw new Error(\n      `--format expects one of text, markdown, json; got ${JSON.stringify(raw)}`,\n    );\n  }\n  return v;\n}\n\n/**\n * Validate and coerce the `--mode` flag for `capsule import`.\n */\nexport function parseCapsuleImportMode(\n  raw: unknown,\n): \"skip\" | \"overwrite\" | \"fork\" {\n  if (raw === undefined || raw === null) return \"skip\";\n  if (typeof raw !== \"string\" || raw.trim() === \"\") {\n    throw new Error(\n      `--mode expects one of skip, overwrite, fork; got ${JSON.stringify(raw)}`,\n    );\n  }\n  const v = raw.trim();\n  if (v !== \"skip\" && v !== \"overwrite\" && v !== \"fork\") {\n    throw new Error(\n      `--mode expects one of skip, overwrite, fork; got ${JSON.stringify(raw)}`,\n    );\n  }\n  return v as \"skip\" | \"overwrite\" | \"fork\";\n}\n\n/**\n * Validate and coerce the `--conflict-mode` flag for `capsule merge`.\n */\nexport function parseCapsuleConflictMode(\n  raw: unknown,\n): \"skip-conflicts\" | \"prefer-source\" | \"prefer-local\" {\n  if (raw === undefined || raw === null) return \"skip-conflicts\";\n  if (typeof raw !== \"string\" || raw.trim() === \"\") {\n    throw new Error(\n      `--conflict-mode expects one of skip-conflicts, prefer-source, prefer-local; got ${JSON.stringify(raw)}`,\n    );\n  }\n  const v = raw.trim();\n  if (v !== \"skip-conflicts\" && v !== \"prefer-source\" && v !== \"prefer-local\") {\n    throw new Error(\n      `--conflict-mode expects one of skip-conflicts, prefer-source, prefer-local; got ${JSON.stringify(raw)}`,\n    );\n  }\n  return v as \"skip-conflicts\" | \"prefer-source\" | \"prefer-local\";\n}\n\n/**\n * Parse and validate the `--since` ISO-8601 string.\n *\n * Accepts date-only (`YYYY-MM-DD`) and date+time with explicit timezone\n * (`YYYY-MM-DDTHH:MM...Z` / `±HH:MM`). Rejects datetime without a timezone\n * designator (host-dependent interpretation, Rule 51).\n */\nconst ISO_8601_RE =\n  /^\\d{4}-\\d{2}-\\d{2}(?:[Tt]\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?(?:[Zz]|[+-]\\d{2}:?\\d{2}))?$/;\n\nexport function parseCapsuleSince(raw: unknown): string | undefined {\n  if (raw === undefined || raw === null) return undefined;\n  if (typeof raw !== \"string\") {\n    throw new Error(\n      `--since expects an ISO 8601 timestamp; got ${JSON.stringify(raw)}`,\n    );\n  }\n  if (raw.trim() === \"\") {\n    throw new Error(`--since expects an ISO 8601 timestamp; received empty string`);\n  }\n  if (!ISO_8601_RE.test(raw)) {\n    throw new Error(\n      `--since is not a valid ISO 8601 timestamp: ${raw}. ` +\n        `Accepted forms: YYYY-MM-DD, YYYY-MM-DDTHH:MM:SSZ, YYYY-MM-DDTHH:MM:SS±HH:MM`,\n    );\n  }\n  const ms = Date.parse(raw);\n  if (!Number.isFinite(ms)) {\n    throw new Error(`--since is not a valid ISO 8601 timestamp: ${raw}`);\n  }\n  // Calendar overflow detection (same logic as capsule-export.ts parseSince).\n  const m = /^(\\d{4})-(\\d{2})-(\\d{2})/.exec(raw);\n  if (m) {\n    const offsetMatch = /([+-])(\\d{2}):?(\\d{2})$/.exec(raw);\n    let displayMs = ms;\n    if (offsetMatch) {\n      const sign = offsetMatch[1] === \"-\" ? -1 : 1;\n      const offsetMin = sign * (Number(offsetMatch[2]) * 60 + Number(offsetMatch[3]));\n      displayMs = ms + offsetMin * 60_000;\n    }\n    const dd = new Date(displayMs);\n    if (\n      dd.getUTCFullYear() !== Number(m[1]) ||\n      dd.getUTCMonth() + 1 !== Number(m[2]) ||\n      dd.getUTCDate() !== Number(m[3])\n    ) {\n      throw new Error(\n        `--since: calendar overflow — ${raw} normalises to a different calendar date`,\n      );\n    }\n  }\n  return raw;\n}\n\n/**\n * Parse a comma-separated `--include-kinds` value into an array of non-empty\n * top-level directory names. Rejects values containing path separators.\n */\nexport function parseCapsuleIncludeKinds(raw: unknown): string[] | undefined {\n  if (raw === undefined || raw === null) return undefined;\n  if (typeof raw !== \"string\") {\n    throw new Error(\n      `--include-kinds expects a comma-separated list of directory names; got ${JSON.stringify(raw)}`,\n    );\n  }\n  if (raw.trim() === \"\") {\n    throw new Error(\n      `--include-kinds expects at least one non-empty kind name`,\n    );\n  }\n  const parts = raw\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter((s) => s.length > 0);\n  if (parts.length === 0) {\n    throw new Error(`--include-kinds expects at least one non-empty kind name`);\n  }\n  for (const p of parts) {\n    if (p.includes(\"/\") || p.includes(\"\\\\\")) {\n      throw new Error(\n        `--include-kinds entries must be top-level directory names (no path separators): ${p}`,\n      );\n    }\n  }\n  // Deduplicate while preserving order.\n  return [...new Set(parts)];\n}\n\n/**\n * Parse a comma-separated `--peers` value into an array of peer ids.\n */\nexport function parseCapsulePeers(raw: unknown): string[] | undefined {\n  if (raw === undefined || raw === null) return undefined;\n  if (typeof raw !== \"string\") {\n    throw new Error(\n      `--peers expects a comma-separated list of peer ids; got ${JSON.stringify(raw)}`,\n    );\n  }\n  if (raw.trim() === \"\") {\n    throw new Error(`--peers expects at least one non-empty peer id`);\n  }\n  const parts = raw\n    .split(\",\")\n    .map((s) => s.trim())\n    .filter((s) => s.length > 0);\n  if (parts.length === 0) {\n    throw new Error(`--peers expects at least one non-empty peer id`);\n  }\n  for (const p of parts) {\n    if (p.includes(\"/\") || p.includes(\"\\\\\") || p === \".\" || p === \"..\") {\n      throw new Error(\n        `--peers entries must be plain id tokens (no path separators): ${p}`,\n      );\n    }\n  }\n  return [...new Set(parts)];\n}\n\n// ---------------------------------------------------------------------------\n// Parsed option bags (returned by the parse helpers below and consumed by\n// cli.ts action handlers).\n// ---------------------------------------------------------------------------\n\nexport interface CapsuleExportOptions {\n  name: string;\n  out: string | undefined;\n  since: string | undefined;\n  includeKinds: string[] | undefined;\n  peers: string[] | undefined;\n}\n\nexport interface CapsuleImportOptions {\n  archive: string;\n  mode: \"skip\" | \"overwrite\" | \"fork\";\n}\n\nexport interface CapsuleMergeOptions {\n  archive: string;\n  conflictMode: \"skip-conflicts\" | \"prefer-source\" | \"prefer-local\";\n}\n\nexport interface CapsuleListOptions {\n  format: CapsuleOutputFormat;\n  capsulesDir: string;\n}\n\nexport interface CapsuleInspectOptions {\n  archive: string;\n  format: CapsuleOutputFormat;\n}\n\n// ---------------------------------------------------------------------------\n// Option bag parsers (Rule 51: validate + throw on bad input, never silently\n// default to a value that hides user misconfiguration).\n// ---------------------------------------------------------------------------\n\nexport function parseCapsuleExportOptions(\n  nameArg: unknown,\n  opts: Record<string, unknown>,\n): CapsuleExportOptions {\n  if (typeof nameArg !== \"string\" || nameArg.trim() === \"\") {\n    throw new Error(\n      `capsule export: <name> is required (e.g. \"remnic capsule export my-capsule\")`,\n    );\n  }\n  const name = nameArg.trim();\n\n  const out =\n    typeof opts.out === \"string\" && opts.out.trim() !== \"\"\n      ? opts.out.trim()\n      : undefined;\n\n  const since = parseCapsuleSince(opts.since);\n  const includeKinds = parseCapsuleIncludeKinds(opts.includeKinds);\n  const peers = parseCapsulePeers(opts.peers);\n\n  return { name, out, since, includeKinds, peers };\n}\n\nexport function parseCapsuleImportOptions(\n  archiveArg: unknown,\n  opts: Record<string, unknown>,\n): CapsuleImportOptions {\n  if (typeof archiveArg !== \"string\" || archiveArg.trim() === \"\") {\n    throw new Error(\n      `capsule import: <archive> path is required (e.g. \"remnic capsule import /path/to/my-capsule.capsule.json.gz\")`,\n    );\n  }\n  const archive = archiveArg.trim();\n  const mode = parseCapsuleImportMode(opts.mode);\n  return { archive, mode };\n}\n\nexport function parseCapsuleMergeOptions(\n  archiveArg: unknown,\n  opts: Record<string, unknown>,\n): CapsuleMergeOptions {\n  if (typeof archiveArg !== \"string\" || archiveArg.trim() === \"\") {\n    throw new Error(\n      `capsule merge: <archive> path is required (e.g. \"remnic capsule merge /path/to/my-capsule.capsule.json.gz\")`,\n    );\n  }\n  const archive = archiveArg.trim();\n  const conflictMode = parseCapsuleConflictMode(opts.conflictMode);\n  return { archive, conflictMode };\n}\n\nexport function parseCapsuleListOptions(\n  opts: Record<string, unknown>,\n  defaultCapsulesDir: string,\n): CapsuleListOptions {\n  const format = parseCapsuleOutputFormat(opts.format);\n  const rawDir =\n    typeof opts.dir === \"string\" && opts.dir.trim() !== \"\"\n      ? opts.dir.trim()\n      : undefined;\n  const capsulesDir = rawDir ?? defaultCapsulesDir;\n  return { format, capsulesDir };\n}\n\nexport function parseCapsuleInspectOptions(\n  archiveArg: unknown,\n  opts: Record<string, unknown>,\n): CapsuleInspectOptions {\n  if (typeof archiveArg !== \"string\" || archiveArg.trim() === \"\") {\n    throw new Error(\n      `capsule inspect: <archive> path is required (e.g. \"remnic capsule inspect my-capsule.capsule.json.gz\")`,\n    );\n  }\n  const archive = archiveArg.trim();\n  const format = parseCapsuleOutputFormat(opts.format);\n  return { archive, format };\n}\n\n// ---------------------------------------------------------------------------\n// Default capsules directory\n// ---------------------------------------------------------------------------\n\n/**\n * Return the default capsule store directory for a given memory root.\n * This mirrors the `outDir` default in `exportCapsule` (`<root>/.capsules`)\n * so that `capsule list` discovers archives written by `capsule export`\n * without extra configuration.\n *\n * For `capsule list`, the POSIX conventional path is:\n *   `<memoryDir>/.capsules`\n *\n * Operators can override it with `--dir <path>` at runtime.\n */\nexport function defaultCapsulesDir(memoryDir: string): string {\n  return path.join(memoryDir, \".capsules\");\n}\n\n// ---------------------------------------------------------------------------\n// Renderers\n// ---------------------------------------------------------------------------\n\nfunction escapeMarkdownCell(v: string): string {\n  return v.replace(/\\\\/g, \"\\\\\\\\\").replace(/\\|/g, \"\\\\|\");\n}\n\n/**\n * Render the `capsule list` output.\n */\nexport function renderCapsuleList(\n  entries: CapsuleListEntry[],\n  format: CapsuleOutputFormat,\n): string {\n  if (format === \"json\") {\n    return JSON.stringify({ capsules: entries }, null, 2);\n  }\n\n  if (entries.length === 0) {\n    if (format === \"markdown\") return \"_No capsule archives found._\\n\";\n    return \"No capsule archives found.\\n\";\n  }\n\n  if (format === \"markdown\") {\n    const rows = entries.map((e) => {\n      const id = escapeMarkdownCell(e.id);\n      const date = escapeMarkdownCell(e.createdAt?.slice(0, 10) ?? \"—\");\n      const ver = escapeMarkdownCell(e.pluginVersion ?? \"—\");\n      const files = e.fileCount !== null ? String(e.fileCount) : \"—\";\n      const desc = escapeMarkdownCell(\n        e.description != null && e.description.trim() !== \"\"\n          ? e.description.trim()\n          : \"—\",\n      );\n      return `| \\`${id}\\` | ${date} | ${ver} | ${files} | ${desc} |`;\n    });\n    return [\n      \"# Capsule archives\",\n      \"\",\n      \"| ID | Created | Version | Files | Description |\",\n      \"| -- | ------- | ------- | ----- | ----------- |\",\n      ...rows,\n      \"\",\n    ].join(\"\\n\");\n  }\n\n  // text\n  const lines = entries.map((e) => {\n    const date = e.createdAt?.slice(0, 10) ?? \"—\";\n    const files =\n      e.fileCount !== null ? `${e.fileCount} file${e.fileCount !== 1 ? \"s\" : \"\"}` : \"? files\";\n    const desc =\n      e.description != null && e.description.trim() !== \"\"\n        ? `  ${e.description.trim()}`\n        : \"\";\n    return `${e.id}  [${date}] [${files}]${desc}`;\n  });\n  return lines.join(\"\\n\") + \"\\n\";\n}\n\n/**\n * Render the `capsule inspect` output from a manifest object.\n */\nexport function renderCapsuleInspect(\n  manifest: CapsuleInspectData,\n  format: CapsuleOutputFormat,\n): string {\n  if (format === \"json\") {\n    return JSON.stringify(manifest, null, 2);\n  }\n\n  const {\n    capsuleId,\n    version,\n    schemaVersion,\n    createdAt,\n    pluginVersion,\n    fileCount,\n    includesTranscripts,\n    description,\n    parentCapsule,\n    retrievalPolicy,\n    includes,\n    topFiles,\n  } = manifest;\n\n  if (format === \"markdown\") {\n    const policyLines = Object.entries(retrievalPolicy.tierWeights ?? {}).map(\n      ([k, v]) => `  - ${k}: ${v}`,\n    );\n    const policyBlock =\n      policyLines.length > 0\n        ? policyLines.join(\"\\n\")\n        : \"  _(no tier weight overrides)_\";\n\n    return [\n      `# Capsule: \\`${capsuleId}\\``,\n      \"\",\n      `**Version:** ${version}  `,\n      `**Schema version:** ${schemaVersion}  `,\n      `**Created:** ${createdAt ?? \"—\"}  `,\n      `**Plugin version:** ${pluginVersion ?? \"—\"}  `,\n      `**Files:** ${fileCount}  `,\n      `**Includes transcripts:** ${includesTranscripts ? \"yes\" : \"no\"}  `,\n      `**Parent capsule:** ${parentCapsule ?? \"_none_\"}  `,\n      `**Description:** ${description && description.trim() !== \"\" ? description.trim() : \"_none_\"}  `,\n      \"\",\n      \"## Includes\",\n      `- taxonomy: ${includes.taxonomy ? \"yes\" : \"no\"}`,\n      `- identityAnchors: ${includes.identityAnchors ? \"yes\" : \"no\"}`,\n      `- peerProfiles: ${includes.peerProfiles ? \"yes\" : \"no\"}`,\n      `- procedural: ${includes.procedural ? \"yes\" : \"no\"}`,\n      \"\",\n      \"## Retrieval policy\",\n      `- directAnswerEnabled: ${retrievalPolicy.directAnswerEnabled ? \"yes\" : \"no\"}`,\n      `- tierWeights:`,\n      policyBlock,\n      \"\",\n      ...(topFiles.length > 0\n        ? [\n            `## Files (${fileCount} total, showing first ${topFiles.length})`,\n            ...topFiles.map((f) => `- \\`${f}\\``),\n            \"\",\n          ]\n        : [`## Files (${fileCount} total)`, \"_Empty capsule._\", \"\"]),\n    ].join(\"\\n\");\n  }\n\n  // text\n  const lines: string[] = [\n    `Capsule: ${capsuleId}`,\n    `  version:          ${version}`,\n    `  schema:           ${schemaVersion}`,\n    `  created:          ${createdAt ?? \"—\"}`,\n    `  plugin:           ${pluginVersion ?? \"—\"}`,\n    `  files:            ${fileCount}`,\n    `  transcripts:      ${includesTranscripts ? \"yes\" : \"no\"}`,\n    `  parent:           ${parentCapsule ?? \"(none)\"}`,\n    `  description:      ${description && description.trim() !== \"\" ? description.trim() : \"(none)\"}`,\n    \"\",\n    `  includes.taxonomy:        ${includes.taxonomy ? \"yes\" : \"no\"}`,\n    `  includes.identityAnchors: ${includes.identityAnchors ? \"yes\" : \"no\"}`,\n    `  includes.peerProfiles:    ${includes.peerProfiles ? \"yes\" : \"no\"}`,\n    `  includes.procedural:      ${includes.procedural ? \"yes\" : \"no\"}`,\n    \"\",\n    `  policy.directAnswer:   ${retrievalPolicy.directAnswerEnabled ? \"yes\" : \"no\"}`,\n  ];\n\n  const weights = Object.entries(retrievalPolicy.tierWeights ?? {});\n  if (weights.length > 0) {\n    for (const [k, v] of weights) {\n      lines.push(`  policy.tierWeight[${k}]: ${v}`);\n    }\n  } else {\n    lines.push(`  policy.tierWeights:    (none)`);\n  }\n\n  if (topFiles.length > 0) {\n    lines.push(\"\", `  files (first ${topFiles.length} of ${fileCount}):`);\n    for (const f of topFiles) {\n      lines.push(`    ${f}`);\n    }\n  }\n\n  return lines.join(\"\\n\") + \"\\n\";\n}\n\n/**\n * Data shape consumed by {@link renderCapsuleInspect}.\n * Populated by the cli.ts action handler from the parsed manifest.\n */\nexport interface CapsuleInspectData {\n  capsuleId: string;\n  version: string;\n  schemaVersion: string;\n  createdAt: string | null;\n  pluginVersion: string | null;\n  fileCount: number;\n  includesTranscripts: boolean;\n  description: string;\n  parentCapsule: string | null;\n  retrievalPolicy: {\n    tierWeights: Record<string, number>;\n    directAnswerEnabled: boolean;\n  };\n  includes: {\n    taxonomy: boolean;\n    identityAnchors: boolean;\n    peerProfiles: boolean;\n    procedural: boolean;\n  };\n  /** First N file paths from manifest.files (for preview). */\n  topFiles: string[];\n}\n"],"mappings":"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","names":["defaultCapsulesDir"]}

package/dist/chunk-74WWN7ZW.js

@@ -0,0 +1,82 @@
+// src/evidence-pack.ts
+var DEFAULT_MAX_ITEM_CHARS = 1200;
+function buildEvidencePack(items, options) {
+  const budget = normalizePositiveInteger(options.maxChars);
+  if (budget <= 0 || items.length === 0) {
+    return "";
+  }
+  const maxItemChars = normalizePositiveInteger(
+    options.maxItemChars ?? DEFAULT_MAX_ITEM_CHARS
+  );
+  if (maxItemChars <= 0) {
+    return "";
+  }
+  const title = options.title ?? "Evidence";
+  const lines = [`## ${title}`];
+  const seenIds = /* @__PURE__ */ new Set();
+  const seenContent = /* @__PURE__ */ new Set();
+  let used = lines[0].length;
+  for (const item of items) {
+    const content = item.content.trim();
+    if (!content) continue;
+    const id = item.id ?? evidenceItemFallbackId(item);
+    if (id && seenIds.has(id)) continue;
+    const contentKey = normalizeEvidenceContent(content);
+    if (seenContent.has(contentKey)) continue;
+    const label = formatEvidenceLabel(item);
+    const clipped = clipText(content, maxItemChars);
+    const block = `${label}: ${clipped}`;
+    const separatorLength = lines.length > 0 ? 2 : 0;
+    const remaining = budget - used - separatorLength;
+    if (remaining <= 0) break;
+    const finalBlock = block.length > remaining ? clipText(block, remaining) : block;
+    if (!finalBlock.trim()) break;
+    lines.push(finalBlock);
+    used += separatorLength + finalBlock.length;
+    if (id) seenIds.add(id);
+    seenContent.add(contentKey);
+  }
+  return lines.length === 1 ? "" : lines.join("\n\n");
+}
+function normalizePositiveInteger(value) {
+  if (!Number.isFinite(value) || value <= 0) {
+    return 0;
+  }
+  return Math.floor(value);
+}
+function evidenceItemFallbackId(item) {
+  if (item.sessionId && typeof item.turnIndex === "number") {
+    return `${item.sessionId}:${item.turnIndex}`;
+  }
+  return void 0;
+}
+function normalizeEvidenceContent(content) {
+  return content.toLowerCase().replace(/\s+/g, " ").trim();
+}
+function formatEvidenceLabel(item) {
+  const parts = [];
+  if (item.sessionId) parts.push(item.sessionId);
+  if (typeof item.turnIndex === "number") parts.push(`turn ${item.turnIndex}`);
+  if (item.role) parts.push(item.role);
+  if (typeof item.score === "number" && Number.isFinite(item.score)) {
+    parts.push(`score ${item.score.toFixed(3)}`);
+  }
+  return parts.length > 0 ? `[${parts.join(", ")}]` : "[evidence]";
+}
+function clipText(text, maxChars) {
+  if (text.length <= maxChars) {
+    return text;
+  }
+  if (maxChars <= 1) {
+    return text.slice(0, maxChars);
+  }
+  if (maxChars <= 3) {
+    return text.slice(0, maxChars);
+  }
+  return `${text.slice(0, maxChars - 3).trimEnd()}...`;
+}
+
+export {
+  buildEvidencePack
+};
+//# sourceMappingURL=chunk-74WWN7ZW.js.map

package/dist/chunk-74WWN7ZW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/evidence-pack.ts"],"sourcesContent":["export interface EvidencePackItem {\n  id?: string;\n  sessionId?: string;\n  turnIndex?: number;\n  role?: string;\n  content: string;\n  score?: number;\n}\n\nexport interface EvidencePackOptions {\n  title?: string;\n  maxChars: number;\n  maxItemChars?: number;\n}\n\nconst DEFAULT_MAX_ITEM_CHARS = 1_200;\n\nexport function buildEvidencePack(\n  items: readonly EvidencePackItem[],\n  options: EvidencePackOptions,\n): string {\n  const budget = normalizePositiveInteger(options.maxChars);\n  if (budget <= 0 || items.length === 0) {\n    return \"\";\n  }\n\n  const maxItemChars = normalizePositiveInteger(\n    options.maxItemChars ?? DEFAULT_MAX_ITEM_CHARS,\n  );\n  if (maxItemChars <= 0) {\n    return \"\";\n  }\n\n  const title = options.title ?? \"Evidence\";\n  const lines: string[] = [`## ${title}`];\n  const seenIds = new Set<string>();\n  const seenContent = new Set<string>();\n  let used = lines[0]!.length;\n\n  for (const item of items) {\n    const content = item.content.trim();\n    if (!content) continue;\n\n    const id = item.id ?? evidenceItemFallbackId(item);\n    if (id && seenIds.has(id)) continue;\n\n    const contentKey = normalizeEvidenceContent(content);\n    if (seenContent.has(contentKey)) continue;\n\n    const label = formatEvidenceLabel(item);\n    const clipped = clipText(content, maxItemChars);\n    const block = `${label}: ${clipped}`;\n    const separatorLength = lines.length > 0 ? 2 : 0;\n    const remaining = budget - used - separatorLength;\n    if (remaining <= 0) break;\n\n    const finalBlock =\n      block.length > remaining ? clipText(block, remaining) : block;\n    if (!finalBlock.trim()) break;\n\n    lines.push(finalBlock);\n    used += separatorLength + finalBlock.length;\n    if (id) seenIds.add(id);\n    seenContent.add(contentKey);\n  }\n\n  return lines.length === 1 ? \"\" : lines.join(\"\\n\\n\");\n}\n\nfunction normalizePositiveInteger(value: number): number {\n  if (!Number.isFinite(value) || value <= 0) {\n    return 0;\n  }\n  return Math.floor(value);\n}\n\nfunction evidenceItemFallbackId(item: EvidencePackItem): string | undefined {\n  if (item.sessionId && typeof item.turnIndex === \"number\") {\n    return `${item.sessionId}:${item.turnIndex}`;\n  }\n  return undefined;\n}\n\nfunction normalizeEvidenceContent(content: string): string {\n  return content.toLowerCase().replace(/\\s+/g, \" \").trim();\n}\n\nfunction formatEvidenceLabel(item: EvidencePackItem): string {\n  const parts: string[] = [];\n  if (item.sessionId) parts.push(item.sessionId);\n  if (typeof item.turnIndex === \"number\") parts.push(`turn ${item.turnIndex}`);\n  if (item.role) parts.push(item.role);\n  if (typeof item.score === \"number\" && Number.isFinite(item.score)) {\n    parts.push(`score ${item.score.toFixed(3)}`);\n  }\n  return parts.length > 0 ? `[${parts.join(\", \")}]` : \"[evidence]\";\n}\n\nfunction clipText(text: string, maxChars: number): string {\n  if (text.length <= maxChars) {\n    return text;\n  }\n  if (maxChars <= 1) {\n    return text.slice(0, maxChars);\n  }\n  if (maxChars <= 3) {\n    return text.slice(0, maxChars);\n  }\n  return `${text.slice(0, maxChars - 3).trimEnd()}...`;\n}\n"],"mappings":";AAeA,IAAM,yBAAyB;AAExB,SAAS,kBACd,OACA,SACQ;AACR,QAAM,SAAS,yBAAyB,QAAQ,QAAQ;AACxD,MAAI,UAAU,KAAK,MAAM,WAAW,GAAG;AACrC,WAAO;AAAA,EACT;AAEA,QAAM,eAAe;AAAA,IACnB,QAAQ,gBAAgB;AAAA,EAC1B;AACA,MAAI,gBAAgB,GAAG;AACrB,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,QAAQ,SAAS;AAC/B,QAAM,QAAkB,CAAC,MAAM,KAAK,EAAE;AACtC,QAAM,UAAU,oBAAI,IAAY;AAChC,QAAM,cAAc,oBAAI,IAAY;AACpC,MAAI,OAAO,MAAM,CAAC,EAAG;AAErB,aAAW,QAAQ,OAAO;AACxB,UAAM,UAAU,KAAK,QAAQ,KAAK;AAClC,QAAI,CAAC,QAAS;AAEd,UAAM,KAAK,KAAK,MAAM,uBAAuB,IAAI;AACjD,QAAI,MAAM,QAAQ,IAAI,EAAE,EAAG;AAE3B,UAAM,aAAa,yBAAyB,OAAO;AACnD,QAAI,YAAY,IAAI,UAAU,EAAG;AAEjC,UAAM,QAAQ,oBAAoB,IAAI;AACtC,UAAM,UAAU,SAAS,SAAS,YAAY;AAC9C,UAAM,QAAQ,GAAG,KAAK,KAAK,OAAO;AAClC,UAAM,kBAAkB,MAAM,SAAS,IAAI,IAAI;AAC/C,UAAM,YAAY,SAAS,OAAO;AAClC,QAAI,aAAa,EAAG;AAEpB,UAAM,aACJ,MAAM,SAAS,YAAY,SAAS,OAAO,SAAS,IAAI;AAC1D,QAAI,CAAC,WAAW,KAAK,EAAG;AAExB,UAAM,KAAK,UAAU;AACrB,YAAQ,kBAAkB,WAAW;AACrC,QAAI,GAAI,SAAQ,IAAI,EAAE;AACtB,gBAAY,IAAI,UAAU;AAAA,EAC5B;AAEA,SAAO,MAAM,WAAW,IAAI,KAAK,MAAM,KAAK,MAAM;AACpD;AAEA,SAAS,yBAAyB,OAAuB;AACvD,MAAI,CAAC,OAAO,SAAS,KAAK,KAAK,SAAS,GAAG;AACzC,WAAO;AAAA,EACT;AACA,SAAO,KAAK,MAAM,KAAK;AACzB;AAEA,SAAS,uBAAuB,MAA4C;AAC1E,MAAI,KAAK,aAAa,OAAO,KAAK,cAAc,UAAU;AACxD,WAAO,GAAG,KAAK,SAAS,IAAI,KAAK,SAAS;AAAA,EAC5C;AACA,SAAO;AACT;AAEA,SAAS,yBAAyB,SAAyB;AACzD,SAAO,QAAQ,YAAY,EAAE,QAAQ,QAAQ,GAAG,EAAE,KAAK;AACzD;AAEA,SAAS,oBAAoB,MAAgC;AAC3D,QAAM,QAAkB,CAAC;AACzB,MAAI,KAAK,UAAW,OAAM,KAAK,KAAK,SAAS;AAC7C,MAAI,OAAO,KAAK,cAAc,SAAU,OAAM,KAAK,QAAQ,KAAK,SAAS,EAAE;AAC3E,MAAI,KAAK,KAAM,OAAM,KAAK,KAAK,IAAI;AACnC,MAAI,OAAO,KAAK,UAAU,YAAY,OAAO,SAAS,KAAK,KAAK,GAAG;AACjE,UAAM,KAAK,SAAS,KAAK,MAAM,QAAQ,CAAC,CAAC,EAAE;AAAA,EAC7C;AACA,SAAO,MAAM,SAAS,IAAI,IAAI,MAAM,KAAK,IAAI,CAAC,MAAM;AACtD;AAEA,SAAS,SAAS,MAAc,UAA0B;AACxD,MAAI,KAAK,UAAU,UAAU;AAC3B,WAAO;AAAA,EACT;AACA,MAAI,YAAY,GAAG;AACjB,WAAO,KAAK,MAAM,GAAG,QAAQ;AAAA,EAC/B;AACA,MAAI,YAAY,GAAG;AACjB,WAAO,KAAK,MAAM,GAAG,QAAQ;AAAA,EAC/B;AACA,SAAO,GAAG,KAAK,MAAM,GAAG,WAAW,CAAC,EAAE,QAAQ,CAAC;AACjD;","names":[]}

package/dist/{chunk-6YJHX2DL.js → chunk-7GCMLT7J.js}

@@ -1,13 +1,13 @@
 import {
   runConsolidationProvenanceCheck
-} from "./chunk-ULYOGL6R.js";
+} from "./chunk-5HRY2WRF.js";
 import {
   reportBufferSurpriseDistribution
 } from "./chunk-ASAITVLA.js";
 import {
   NamespaceStorageRouter,
   namespaceCollectionName
-} from "./chunk-NBVAS5MT.js";
+} from "./chunk-R2L7SUX2.js";
 import {
   analyzeSessionIntegrity,
   applySessionRepair,
@@ -16,11 +16,6 @@ import {
 import {
   resolveRemnicPluginEntry
 } from "./chunk-U66YHYC7.js";
-import {
-  resolveCuratedIncludeFilesStatePath,
-  resolveNativeKnowledgeStatePath,
-  resolveOpenClawWorkspaceStatePath
-} from "./chunk-7SEAZFFB.js";
 import {
   createEvalBaselineSnapshot,
   getEvalHarnessStatus,
@@ -29,21 +24,29 @@ import {
   validateEvalBenchmarkPack
 } from "./chunk-K6WK37A6.js";
 import {
-  parseConfig
-} from "./chunk-BECYBZLX.js";
+  readJudgeVerdictStats
+} from "./chunk-AJU4PJGY.js";
 import {
-  analyzeGraphHealth
-} from "./chunk-C2EFFULQ.js";
+  resolveCuratedIncludeFilesStatePath,
+  resolveNativeKnowledgeStatePath,
+  resolveOpenClawWorkspaceStatePath
+} from "./chunk-7SEAZFFB.js";
+import {
+  parseConfig
+} from "./chunk-JWSENLQI.js";
 import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact
-} from "./chunk-3OGMS3PE.js";
+} from "./chunk-LZRYQK6L.js";
 import {
   isSafeRouteNamespace
 } from "./chunk-2LGMW3DJ.js";
+import {
+  analyzeGraphHealth
+} from "./chunk-RK2Y4XOM.js";
 import {
   StorageManager
-} from "./chunk-F5VP6YCB.js";
+} from "./chunk-DCE6SQLA.js";
 import {
   lintWorkspaceFiles
 } from "./chunk-DM2T26WE.js";
@@ -183,6 +186,12 @@ async function runNamespaceMigration(options) {
 }
 
 // src/operator-toolkit.ts
+function isMissingPathError(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+function formatUnknownError(error) {
+  return error instanceof Error ? error.message : String(error);
+}
 function resolveConfigPath(explicitPath) {
   if (explicitPath && explicitPath.trim().length > 0) return explicitPath.trim();
   const configured = readEnvVar("OPENCLAW_ENGRAM_CONFIG_PATH") || readEnvVar("OPENCLAW_CONFIG_PATH");
@@ -407,7 +416,7 @@ function removeManagedCaptureInstructions(existing) {
 async function runOperatorSetup(options) {
   const now = options.now ?? /* @__PURE__ */ new Date();
   const configStatus = await loadCliPluginConfig(options.configPath);
-  const storage = new StorageManager(options.orchestrator.config.memoryDir);
+  const storage = options.orchestrator.storage;
   await storage.ensureDirectories();
   await mkdir2(options.orchestrator.config.workspaceDir, { recursive: true });
   const qmdAvailable = await options.orchestrator.qmd.probe();
@@ -684,6 +693,7 @@ async function runOperatorDoctor(options) {
   const configStatus = await loadCliPluginConfig(options.configPath);
   const checks = [];
   const config = options.orchestrator.config;
+  const storage = options.orchestrator.storage;
   const configReview = await buildOperatorConfigReviewReport({
     now,
     configStatus,
@@ -734,7 +744,7 @@ async function runOperatorDoctor(options) {
     remediation: conversationIndex.enabled && conversationIndex.status !== "ok" ? "Run `openclaw engram rebuild-index` to refresh the conversation index artifacts." : void 0,
     details: conversationIndex
   });
-  const meta = await new StorageManager(config.memoryDir).loadMeta();
+  const meta = await storage.loadMeta();
   checks.push({
     key: "maintenance",
     status: meta.lastExtractionAt || meta.lastConsolidationAt ? "ok" : "warn",
@@ -752,11 +762,13 @@ async function runOperatorDoctor(options) {
     details: nativeKnowledgeStatus
   });
   const agentAccessEnabled = config.agentAccessHttp?.enabled === true;
+  const rawAuthToken = config.agentAccessHttp?.authToken;
+  const authTokenConfigured = typeof rawAuthToken === "string" && rawAuthToken.length > 0 || rawAuthToken !== null && typeof rawAuthToken === "object" && typeof rawAuthToken.source === "string";
   checks.push({
     key: "access_http_auth",
-    status: !agentAccessEnabled ? "warn" : config.agentAccessHttp?.authToken ? "ok" : "error",
-    summary: !agentAccessEnabled ? "Agent access HTTP bridge is disabled." : config.agentAccessHttp?.authToken ? "Agent access HTTP bridge has an auth token configured." : "Agent access HTTP bridge is enabled without an auth token.",
-    remediation: !agentAccessEnabled ? "Ignore unless you plan to enable the HTTP bridge." : config.agentAccessHttp?.authToken ? void 0 : "Set `agentAccessHttp.authToken` before exposing the bridge."
+    status: !agentAccessEnabled ? "warn" : authTokenConfigured ? "ok" : "error",
+    summary: !agentAccessEnabled ? "Agent access HTTP bridge is disabled." : authTokenConfigured ? "Agent access HTTP bridge has an auth token configured." : "Agent access HTTP bridge is enabled without an auth token.",
+    remediation: !agentAccessEnabled ? "Ignore unless you plan to enable the HTTP bridge." : authTokenConfigured ? void 0 : "Set `agentAccessHttp.authToken` before exposing the bridge."
   });
   const warnings = config.fileHygiene?.lintEnabled ? await lintWorkspaceFiles({
     workspaceDir: config.workspaceDir,
@@ -765,12 +777,16 @@ async function runOperatorDoctor(options) {
     warnRatio: config.fileHygiene.lintWarnRatio
   }) : [];
   checks.push(summarizeHygieneWarnings(warnings, config.fileHygiene));
-  checks.push(await summarizeMemoryWorthLegacyCounters(new StorageManager(config.memoryDir)));
+  checks.push(await summarizeMemoryWorthLegacyCounters(storage));
   checks.push(
-    await summarizeBufferSurpriseDistribution(new StorageManager(config.memoryDir), config)
+    await summarizeBufferSurpriseDistribution(storage, config)
   );
-  checks.push(await summarizeConsolidationProvenance(new StorageManager(config.memoryDir), config));
+  checks.push(await summarizeConsolidationProvenance(storage, config));
+  checks.push(await summarizeGraphEdgeDecayStatus(config));
+  checks.push(await summarizeTierDistribution(options.orchestrator.storage));
+  checks.push(await summarizeDreamsPhases(config, storage));
   checks.push(summarizeSecurityMitigations(config));
+  checks.push(await summarizeObservationThroughput(config.memoryDir));
   const summary = checks.reduce(
     (acc, check) => {
       acc[check.status] += 1;
@@ -869,6 +885,167 @@ async function summarizeBufferSurpriseDistribution(storage, config) {
     };
   }
 }
+async function summarizeGraphEdgeDecayStatus(config) {
+  const { readGraphEdgeDecayStatus } = await import("./graph-edge-decay-PWB63GRE.js");
+  const enabled = config.graphEdgeDecayEnabled === true;
+  if (!enabled) {
+    return {
+      key: "graph_edge_decay",
+      status: "ok",
+      summary: "Graph-edge decay maintenance is disabled (graphEdgeDecayEnabled = false).",
+      remediation: "Set graphEdgeDecayEnabled = true to opt into the periodic decay job (issue #681).",
+      details: { enabled: false }
+    };
+  }
+  const status = await readGraphEdgeDecayStatus(config.memoryDir);
+  if (!status) {
+    return {
+      key: "graph_edge_decay",
+      status: "warn",
+      summary: "Graph-edge decay is enabled but has not run yet (no status file present).",
+      remediation: "Trigger the cron, run `engram.graph_edge_decay_run` via MCP, or wait for the scheduled cadence to fire.",
+      details: { enabled: true, lastRun: null, cadenceMs: config.graphEdgeDecayCadenceMs }
+    };
+  }
+  return {
+    key: "graph_edge_decay",
+    status: "ok",
+    summary: `Graph-edge decay last ran at ${status.ranAt} (${status.edgesDecayed}/${status.edgesTotal} edges decayed, ${status.edgesBelowVisibilityThreshold} below visibility threshold).`,
+    details: {
+      enabled: true,
+      lastRun: status.ranAt,
+      durationMs: status.durationMs,
+      edgesTotal: status.edgesTotal,
+      edgesDecayed: status.edgesDecayed,
+      edgesBelowVisibilityThreshold: status.edgesBelowVisibilityThreshold,
+      topDecayedEntities: status.topDecayedEntities,
+      cadenceMs: config.graphEdgeDecayCadenceMs
+    }
+  };
+}
+async function summarizeTierDistribution(storage) {
+  try {
+    const { summarizeTiers } = await import("./tier-stats-62ZVDFKS.js");
+    const summary = await summarizeTiers(storage);
+    const storageDir = storage.dir ?? "";
+    const journalPath = storageDir.length > 0 ? path2.join(storageDir, "state", "tier-migration-journal.jsonl") : null;
+    let recentMigrations = 0;
+    const demotionReasons = {};
+    const sevenDaysAgoMs = Date.now() - 7 * 864e5;
+    if (journalPath) {
+      try {
+        const { readFile: readFile2 } = await import("fs/promises");
+        const raw = await readFile2(journalPath, "utf-8");
+        for (const line of raw.split("\n")) {
+          const trimmed = line.trim();
+          if (trimmed.length === 0) continue;
+          try {
+            const entry = JSON.parse(trimmed);
+            const tsMs = entry.ts ? Date.parse(entry.ts) : NaN;
+            if (Number.isFinite(tsMs) && tsMs >= sevenDaysAgoMs && entry.changed === true) {
+              recentMigrations += 1;
+              if (entry.fromTier === "hot" && entry.toTier === "cold" && typeof entry.reason === "string") {
+                const reason = entry.reason;
+                demotionReasons[reason] = (demotionReasons[reason] ?? 0) + 1;
+              }
+            }
+          } catch {
+          }
+        }
+      } catch {
+      }
+    }
+    const topDemotionReasons = Object.entries(demotionReasons).sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).slice(0, 5).map(([reason, count]) => ({ reason, count }));
+    const statusParts = Object.entries(summary.byStatus).sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).slice(0, 6).map(([s, n]) => `${s}: ${n}`).join(", ");
+    return {
+      key: "tier_distribution",
+      status: "ok",
+      summary: `Tier distribution: hot=${summary.byTier.hot}, cold=${summary.byTier.cold}` + (summary.forgottenCount > 0 ? `, forgotten=${summary.forgottenCount}` : "") + `. Total: ${summary.total}.` + (recentMigrations > 0 ? ` Recent migrations (7d): ${recentMigrations}.` : ""),
+      details: {
+        total: summary.total,
+        byTier: summary.byTier,
+        byStatus: summary.byStatus,
+        forgottenCount: summary.forgottenCount,
+        statusSummary: statusParts,
+        recentMigrations,
+        topDemotionReasons
+      }
+    };
+  } catch (err) {
+    return {
+      key: "tier_distribution",
+      status: "ok",
+      summary: "Tier distribution unavailable \u2014 could not enumerate memories.",
+      details: { error: String(err) }
+    };
+  }
+}
+async function summarizeDreamsPhases(config, storage = new StorageManager(config.memoryDir)) {
+  const phases = config.dreamsPhases;
+  const meta = await storage.loadMeta();
+  let deepSleepLastRun = null;
+  let deepSleepLastRunWarning = null;
+  try {
+    const runsDir = path2.join(config.memoryDir, "state", "memory-governance", "runs");
+    const runIds = (await readdir2(runsDir)).sort().reverse();
+    if (runIds.length > 0) {
+      const latestRunId = runIds[0];
+      const manifestPath = path2.join(
+        runsDir,
+        latestRunId,
+        "manifest.json"
+      );
+      const raw = await readFile(manifestPath, "utf-8");
+      const parsed = JSON.parse(raw);
+      if (typeof parsed.createdAt === "string" && parsed.createdAt.length > 0) {
+        deepSleepLastRun = parsed.createdAt;
+      }
+    }
+  } catch (error) {
+    if (!isMissingPathError(error)) {
+      deepSleepLastRunWarning = `Could not read latest governance run manifest: ${formatUnknownError(error)}`;
+    }
+  }
+  const phaseLines = [
+    `lightSleep: enabled=${phases.lightSleep.enabled}, cadenceMs=${phases.lightSleep.cadenceMs}, promoteHeat=${phases.lightSleep.promoteHeatThreshold}, staleDecay=${phases.lightSleep.staleDecayThreshold}, archiveDecay=${phases.lightSleep.archiveDecayThreshold}, filterStale=${phases.lightSleep.filterStaleEnabled}, lastRun=${meta.lastExtractionAt ?? "never"}`,
+    `rem: enabled=${phases.rem.enabled}, cadenceMs=${phases.rem.cadenceMs}, similarity=${phases.rem.similarityThreshold}, minCluster=${phases.rem.minClusterSize}, maxPerRun=${phases.rem.maxPerRun}, minIntervalMs=${phases.rem.minIntervalMs}, lastRun=${meta.lastConsolidationAt ?? "never"}`,
+    `deepSleep: enabled=${phases.deepSleep.enabled}, cadenceMs=${phases.deepSleep.cadenceMs}, versioning=${phases.deepSleep.versioningEnabled}, versioningMaxPerPage=${phases.deepSleep.versioningMaxPerPage}, lastRun=${deepSleepLastRun ?? "never"}`
+  ];
+  return {
+    key: "dreams_phases",
+    status: deepSleepLastRunWarning ? "warn" : "ok",
+    summary: `Dreams pipeline phases: ${phaseLines.join("; ")}${deepSleepLastRunWarning ? `; ${deepSleepLastRunWarning}` : ""}`,
+    remediation: deepSleepLastRunWarning ? "Inspect state/memory-governance/runs and repair or remove unreadable governance run artifacts." : void 0,
+    details: {
+      lightSleep: {
+        enabled: phases.lightSleep.enabled,
+        cadenceMs: phases.lightSleep.cadenceMs,
+        promoteHeatThreshold: phases.lightSleep.promoteHeatThreshold,
+        staleDecayThreshold: phases.lightSleep.staleDecayThreshold,
+        archiveDecayThreshold: phases.lightSleep.archiveDecayThreshold,
+        filterStaleEnabled: phases.lightSleep.filterStaleEnabled,
+        lastRun: meta.lastExtractionAt ?? null
+      },
+      rem: {
+        enabled: phases.rem.enabled,
+        cadenceMs: phases.rem.cadenceMs,
+        similarityThreshold: phases.rem.similarityThreshold,
+        minClusterSize: phases.rem.minClusterSize,
+        maxPerRun: phases.rem.maxPerRun,
+        minIntervalMs: phases.rem.minIntervalMs,
+        lastRun: meta.lastConsolidationAt ?? null
+      },
+      deepSleep: {
+        enabled: phases.deepSleep.enabled,
+        cadenceMs: phases.deepSleep.cadenceMs,
+        versioningEnabled: phases.deepSleep.versioningEnabled,
+        versioningMaxPerPage: phases.deepSleep.versioningMaxPerPage,
+        lastRun: deepSleepLastRun,
+        warning: deepSleepLastRunWarning
+      }
+    }
+  };
+}
 function summarizeSecurityMitigations(config) {
   const budgetEnabled = config.recallCrossNamespaceBudgetEnabled === true;
   const anomalyEnabled = config.recallAuditAnomalyDetectionEnabled === true;
@@ -911,6 +1088,46 @@ function summarizeSecurityMitigations(config) {
     details: { ...details, configOnly: true }
   };
 }
+async function summarizeObservationThroughput(memoryDir) {
+  try {
+    const stats = await readJudgeVerdictStats(memoryDir);
+    if (stats.total === 0) {
+      return {
+        key: "observations",
+        status: "ok",
+        summary: "No observations recorded yet (extraction-judge telemetry ledger is empty or missing).",
+        details: { total: 0, accept: 0, reject: 0, defer: 0, lastObservedAt: null }
+      };
+    }
+    const acceptPct = (stats.accept / stats.total * 100).toFixed(1);
+    const rejectPct = (stats.reject / stats.total * 100).toFixed(1);
+    const deferPct = (stats.defer / stats.total * 100).toFixed(1);
+    return {
+      key: "observations",
+      status: "ok",
+      summary: `${stats.total} observations recorded: accept=${acceptPct}%, reject=${rejectPct}%, defer=${deferPct}%. Last observed: ${stats.lastTs ?? "unknown"}.`,
+      details: {
+        total: stats.total,
+        accept: stats.accept,
+        reject: stats.reject,
+        defer: stats.defer,
+        deferCapTriggered: stats.deferCapTriggered,
+        deferRate: stats.deferRate,
+        meanElapsedMs: stats.meanElapsedMs,
+        firstObservedAt: stats.firstTs ?? null,
+        lastObservedAt: stats.lastTs ?? null
+      }
+    };
+  } catch (err) {
+    return {
+      key: "observations",
+      status: "warn",
+      summary: "Could not read observation telemetry ledger.",
+      remediation: "Retry `remnic doctor` after ensuring the memory state directory is readable.",
+      details: { error: String(err) }
+    };
+  }
+}
 async function summarizeConsolidationProvenance(storage, config) {
   let report;
   try {
@@ -1223,9 +1440,12 @@ export {
   runOperatorDoctor,
   summarizeMemoryWorthLegacyCounters,
   summarizeBufferSurpriseDistribution,
+  summarizeTierDistribution,
+  summarizeDreamsPhases,
+  summarizeObservationThroughput,
   summarizeConsolidationProvenance,
   runOperatorInventory,
   runBenchmarkRecall,
   runOperatorRepair
 };
-//# sourceMappingURL=chunk-6YJHX2DL.js.map
+//# sourceMappingURL=chunk-7GCMLT7J.js.map