@remnic/core 1.0.2 → 1.1.0

package/dist/chunk-3QHL5ABG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/operator-toolkit.ts","../src/namespaces/migrate.ts"],"sourcesContent":["import path from \"node:path\";\nimport { constants as fsConstants } from \"node:fs\";\nimport { access, mkdir, readFile, readdir, stat, unlink, writeFile } from \"node:fs/promises\";\nimport { lintWorkspaceFiles } from \"./hygiene.js\";\nimport { parseConfig } from \"./config.js\";\nimport { readEnvVar, resolveHomeDir } from \"./runtime/env.js\";\nimport { resolveRemnicPluginEntry } from \"./plugin-id.js\";\nimport {\n  resolveCuratedIncludeFilesStatePath,\n  resolveNativeKnowledgeStatePath,\n  resolveOpenClawWorkspaceStatePath,\n} from \"./native-knowledge.js\";\nimport { StorageManager } from \"./storage.js\";\nimport { listNamespaces } from \"./namespaces/migrate.js\";\nimport {\n  createEvalBaselineSnapshot,\n  getEvalHarnessStatus,\n  runEvalBaselineDeltaReport,\n  runEvalBenchmarkCiGate,\n  validateEvalBenchmarkPack,\n  type EvalBaselineDeltaReport,\n  type EvalCiGateReport,\n  type EvalHarnessStatus,\n} from \"./evals.js\";\nimport { analyzeGraphHealth, type GraphHealthReport } from \"./graph.js\";\nimport {\n  analyzeSessionIntegrity,\n  applySessionRepair,\n  planSessionRepair,\n  type SessionIntegrityReport,\n  type SessionRepairApplyResult,\n  type SessionRepairPlan,\n} from \"./session-integrity.js\";\nimport {\n  listMemoryGovernanceRuns,\n  readMemoryGovernanceRunArtifact,\n} from \"./maintenance/memory-governance.js\";\nimport type { FileHygieneConfig, MemoryFile, PluginConfig } from \"./types.js\";\n\ninterface QmdRuntimeLike {\n  probe(): Promise<boolean>;\n  isAvailable(): boolean;\n  ensureCollection(memoryDir: string): Promise<\"present\" | \"missing\" | \"unknown\" | \"skipped\">;\n  debugStatus(): string;\n}\n\ninterface ConversationIndexLike {\n  getConversationIndexHealth(): Promise<{\n    enabled: boolean;\n    backend: \"qmd\" | \"faiss\";\n    status: \"ok\" | \"degraded\" | \"disabled\";\n    chunkDocCount: number;\n    lastUpdateAt: string | null;\n    qmdAvailable?: boolean;\n    faiss?: {\n      ok: boolean;\n      status: \"ok\" | \"degraded\" | \"error\";\n      indexPath: string;\n      message?: string;\n      manifest?: {\n        version: number;\n        modelId: string;\n        normalizedModelId: string;\n        dimension: number;\n        chunkCount: number;\n        updatedAt: string;\n        lastSuccessfulRebuildAt: string;\n      };\n    };\n  }>;\n  rebuildConversationIndex(\n    sessionKey?: string,\n    hours?: number,\n    opts?: { embed?: boolean },\n  ): Promise<{\n    chunks: number;\n    skipped: boolean;\n    reason?: string;\n    embedded?: boolean;\n    rebuilt?: boolean;\n  }>;\n}\n\nexport interface OperatorToolkitOrchestrator extends ConversationIndexLike {\n  config: PluginConfig;\n  qmd: QmdRuntimeLike;\n}\n\nexport interface OperatorConfigLoadResult {\n  found: boolean;\n  path: string;\n  parsed: boolean;\n  memoryDir?: string;\n  workspaceDir?: string;\n  error?: string;\n}\n\nexport interface OperatorSetupReport {\n  schemaVersion: 1;\n  generatedAt: string;\n  config: OperatorConfigLoadResult;\n  memoryDir: string;\n  workspaceDir: string;\n  directories: Array<{ path: string; exists: boolean; writable: boolean }>;\n  qmd: {\n    enabled: boolean;\n    available: boolean;\n    collectionState: \"present\" | \"missing\" | \"unknown\" | \"skipped\";\n    debugStatus: string;\n  };\n  nativeKnowledge: {\n    enabled: boolean;\n    includeFiles: string[];\n    curatedIncludeSync: {\n      statePath: string;\n      exists: boolean;\n      updatedAt: string | null;\n      fileCount: number;\n      activeChunkCount: number;\n      deletedFileCount: number;\n    };\n    openclawWorkspaceAdapterEnabled: boolean;\n    obsidianVaultAdapterEnabled: boolean;\n    obsidianSync: {\n      statePath: string;\n      exists: boolean;\n      updatedAt: string | null;\n      vaultCount: number;\n      activeChunkCount: number;\n      deletedNoteCount: number;\n    };\n    openclawWorkspaceSync: {\n      statePath: string;\n      exists: boolean;\n      updatedAt: string | null;\n      fileCount: number;\n      activeChunkCount: number;\n      deletedFileCount: number;\n    };\n  };\n  explicitCapture: {\n    captureMode: string;\n    enabled: boolean;\n    memoryDocPath: string;\n    memoryDocExists: boolean;\n    memoryDocInstalled: boolean;\n    memoryDocUpdated: boolean;\n    memoryDocRemoved: boolean;\n    preview: string | null;\n  };\n  nextSteps: string[];\n  verificationCommands: string[];\n}\n\nexport interface OperatorDoctorCheck {\n  key: string;\n  status: \"ok\" | \"warn\" | \"error\";\n  summary: string;\n  remediation?: string;\n  details?: unknown;\n}\n\nexport interface OperatorConfigReviewFinding {\n  key: string;\n  status: \"recommend\" | \"problem\";\n  setting: string;\n  currentValue: string;\n  defaultValue: string;\n  recommendedValue: string;\n  summary: string;\n  rationale: string;\n}\n\nexport interface OperatorConfigReviewReport {\n  schemaVersion: 1;\n  generatedAt: string;\n  ok: boolean;\n  config: OperatorConfigLoadResult;\n  profile: {\n    memoryOsPreset?: string;\n    searchBackend: string;\n    qmdEnabled: boolean;\n    qmdDaemonEnabled: boolean;\n    nativeKnowledgeEnabled: boolean;\n    fileHygieneEnabled: boolean;\n    conversationIndexEnabled: boolean;\n  };\n  summary: {\n    recommend: number;\n    problem: number;\n  };\n  findings: OperatorConfigReviewFinding[];\n}\n\nexport interface OperatorDoctorReport {\n  schemaVersion: 1;\n  generatedAt: string;\n  ok: boolean;\n  summary: {\n    ok: number;\n    warn: number;\n    error: number;\n  };\n  config: OperatorConfigLoadResult;\n  checks: OperatorDoctorCheck[];\n}\n\nexport interface OperatorInventoryNamespaceSummary {\n  namespace: string;\n  memoryCount: number;\n  entityCount: number;\n}\n\nexport interface OperatorInventoryReport {\n  schemaVersion: 1;\n  generatedAt: string;\n  memoryDir: string;\n  totals: {\n    memories: number;\n    entities: number;\n    namespaces: number;\n    reviewQueue: number;\n    storageBytes: number;\n  };\n  categories: Record<string, number>;\n  statuses: Record<string, number>;\n  namespaces: OperatorInventoryNamespaceSummary[];\n  ageBands: Record<string, number>;\n  profile: {\n    exists: boolean;\n    chars: number;\n    lines: number;\n  };\n  storageFootprint: {\n    bytes: number;\n    byTopLevel: Record<string, number>;\n  };\n  archivePressure: {\n    archived: number;\n    pendingReview: number;\n    quarantined: number;\n    rejected: number;\n  };\n  conversationIndex: {\n    enabled: boolean;\n    backend: \"qmd\" | \"faiss\";\n    status: \"ok\" | \"degraded\" | \"disabled\";\n    chunkDocCount: number;\n    lastUpdateAt: string | null;\n  };\n  nativeKnowledge: {\n    enabled: boolean;\n    curatedIncludeSync: {\n      exists: boolean;\n      updatedAt: string | null;\n      fileCount: number;\n      activeChunkCount: number;\n      deletedFileCount: number;\n    };\n    obsidianSync: {\n      exists: boolean;\n      updatedAt: string | null;\n      vaultCount: number;\n      activeChunkCount: number;\n      deletedNoteCount: number;\n    };\n    openclawWorkspaceSync: {\n      exists: boolean;\n      updatedAt: string | null;\n      fileCount: number;\n      activeChunkCount: number;\n      deletedFileCount: number;\n    };\n  };\n}\n\nexport interface BenchmarkRecallReport {\n  schemaVersion: 1;\n  generatedAt: string;\n  mode: \"status\" | \"validate\" | \"baseline-report\" | \"ci-gate\" | \"snapshot\";\n  status: EvalHarnessStatus;\n  validate?: Awaited<ReturnType<typeof validateEvalBenchmarkPack>>;\n  baselineReport?: EvalBaselineDeltaReport;\n  ciGate?: EvalCiGateReport;\n  snapshot?: {\n    targetPath: string;\n    snapshotId: string;\n  };\n}\n\nexport interface OperatorRepairReport {\n  schemaVersion: 1;\n  generatedAt: string;\n  dryRun: boolean;\n  sessionCheck: SessionIntegrityReport;\n  sessionRepairPlan: SessionRepairPlan;\n  sessionRepairApply: SessionRepairApplyResult;\n  graphHealth: GraphHealthReport;\n}\n\nexport interface OperatorSetupOptions {\n  orchestrator: OperatorToolkitOrchestrator;\n  installCaptureInstructions?: boolean;\n  captureInstructionsMode?: \"preview\" | \"install\" | \"remove\";\n  configPath?: string;\n  now?: Date;\n}\n\nexport interface OperatorDoctorOptions {\n  orchestrator: OperatorToolkitOrchestrator;\n  configPath?: string;\n  now?: Date;\n}\n\nexport interface OperatorConfigReviewOptions {\n  orchestrator: OperatorToolkitOrchestrator;\n  configPath?: string;\n  now?: Date;\n}\n\nexport interface OperatorInventoryOptions {\n  orchestrator: OperatorToolkitOrchestrator;\n  now?: Date;\n}\n\nexport interface BenchmarkRecallOptions {\n  config: Pick<\n    PluginConfig,\n    | \"memoryDir\"\n    | \"evalStoreDir\"\n    | \"evalHarnessEnabled\"\n    | \"evalShadowModeEnabled\"\n    | \"benchmarkBaselineSnapshotsEnabled\"\n    | \"benchmarkDeltaReporterEnabled\"\n    | \"memoryRedTeamBenchEnabled\"\n  >;\n  validatePath?: string;\n  baseEvalStoreDir?: string;\n  candidateEvalStoreDir?: string;\n  snapshotId?: string;\n  createSnapshot?: boolean;\n  snapshotNotes?: string;\n  gitRef?: string;\n  createdAt?: string;\n  now?: Date;\n}\n\nexport interface OperatorRepairOptions {\n  config: Pick<\n    PluginConfig,\n    \"memoryDir\" | \"entityGraphEnabled\" | \"timeGraphEnabled\" | \"causalGraphEnabled\"\n  >;\n  apply?: boolean;\n  dryRun?: boolean;\n  allowSessionFileRepair?: boolean;\n  sessionFilesDir?: string;\n  now?: Date;\n}\n\nfunction resolveConfigPath(explicitPath?: string): string {\n  if (explicitPath && explicitPath.trim().length > 0) return explicitPath.trim();\n  const configured =\n    readEnvVar(\"OPENCLAW_ENGRAM_CONFIG_PATH\") ||\n    readEnvVar(\"OPENCLAW_CONFIG_PATH\");\n  if (configured && configured.trim().length > 0) return configured.trim();\n  return path.join(resolveHomeDir(), \".openclaw\", \"openclaw.json\");\n}\n\nasync function loadCliPluginConfig(configPath?: string): Promise<OperatorConfigLoadResult> {\n  const resolvedPath = resolveConfigPath(configPath);\n  try {\n    const raw = JSON.parse(await readFile(resolvedPath, \"utf-8\")) as Record<string, unknown>;\n    // Delegate slot → PLUGIN_ID → LEGACY_PLUGIN_ID resolution to the shared\n    // helper so all config loaders stay in sync (#403).\n    const entry = resolveRemnicPluginEntry(raw);\n    const parsedConfig = parseConfig(\n      entry && typeof entry === \"object\"\n        ? ((entry[\"config\"] as Record<string, unknown> | undefined) ?? {})\n        : {},\n    );\n    return {\n      found: true,\n      path: resolvedPath,\n      parsed: true,\n      memoryDir: parsedConfig.memoryDir,\n      workspaceDir: parsedConfig.workspaceDir,\n    };\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    return {\n      found: !/ENOENT/i.test(message),\n      path: resolvedPath,\n      parsed: false,\n      error: message,\n    };\n  }\n}\n\nasync function isWritable(targetPath: string): Promise<boolean> {\n  try {\n    await access(targetPath, fsConstants.W_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function pathExists(targetPath: string): Promise<boolean> {\n  try {\n    await access(targetPath, fsConstants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction formatConfigValue(value: unknown): string {\n  if (value === undefined || value === null) return \"(unset)\";\n  if (typeof value === \"string\") return value.length > 0 ? value : \"(unset)\";\n  if (typeof value === \"number\" || typeof value === \"boolean\") return String(value);\n  return JSON.stringify(value);\n}\n\nasync function gatherDirectoryStatus(\n  paths: string[],\n): Promise<Array<{ path: string; exists: boolean; writable: boolean }>> {\n  return Promise.all(paths.map(async (targetPath) => {\n    try {\n      await access(targetPath, fsConstants.F_OK);\n      return {\n        path: targetPath,\n        exists: true,\n        writable: await isWritable(targetPath),\n      };\n    } catch {\n      return {\n        path: targetPath,\n        exists: false,\n        writable: false,\n      };\n    }\n  }));\n}\n\nfunction getSetupPaths(config: PluginConfig): string[] {\n  return [\n    config.memoryDir,\n    config.workspaceDir,\n    path.join(config.memoryDir, \"facts\"),\n    path.join(config.memoryDir, \"entities\"),\n    path.join(config.memoryDir, \"state\"),\n    path.join(config.memoryDir, \"questions\"),\n    path.join(config.memoryDir, \"artifacts\"),\n    path.join(config.memoryDir, \"config\"),\n  ];\n}\n\nasync function readJsonIfExists(filePath: string): Promise<unknown | null> {\n  try {\n    return JSON.parse(await readFile(filePath, \"utf-8\")) as unknown;\n  } catch {\n    return null;\n  }\n}\n\nasync function summarizeNativeKnowledgeStatus(config: PluginConfig): Promise<{\n  enabled: boolean;\n  includeFiles: string[];\n  curatedIncludeSync: {\n    statePath: string;\n    exists: boolean;\n    updatedAt: string | null;\n    fileCount: number;\n    activeChunkCount: number;\n    deletedFileCount: number;\n  };\n  openclawWorkspaceAdapterEnabled: boolean;\n  obsidianVaultAdapterEnabled: boolean;\n  obsidianSync: {\n    statePath: string;\n    exists: boolean;\n    updatedAt: string | null;\n    vaultCount: number;\n    activeChunkCount: number;\n    deletedNoteCount: number;\n  };\n  openclawWorkspaceSync: {\n    statePath: string;\n    exists: boolean;\n    updatedAt: string | null;\n    fileCount: number;\n    activeChunkCount: number;\n    deletedFileCount: number;\n  };\n}> {\n  const nativeKnowledge = config.nativeKnowledge;\n  const nativeKnowledgeStateDir = nativeKnowledge?.stateDir ?? \"state/native-knowledge\";\n  const curatedStatePath = nativeKnowledge\n    ? resolveCuratedIncludeFilesStatePath(config.memoryDir, nativeKnowledge)\n    : path.join(config.memoryDir, nativeKnowledgeStateDir, \"curated-include-sync.json\");\n  const obsidianStatePath = nativeKnowledge\n    ? resolveNativeKnowledgeStatePath(config.memoryDir, nativeKnowledge)\n    : path.join(config.memoryDir, nativeKnowledgeStateDir, \"obsidian-sync.json\");\n  const openclawStatePath = nativeKnowledge\n    ? resolveOpenClawWorkspaceStatePath(config.memoryDir, nativeKnowledge)\n    : path.join(config.memoryDir, nativeKnowledgeStateDir, \"openclaw-workspace-sync.json\");\n  const [curatedRaw, obsidianRaw, openclawRaw] = await Promise.all([\n    readJsonIfExists(curatedStatePath),\n    readJsonIfExists(obsidianStatePath),\n    readJsonIfExists(openclawStatePath),\n  ]);\n\n  const curatedFiles = curatedRaw && typeof curatedRaw === \"object\" && curatedRaw !== null\n    && \"files\" in curatedRaw && typeof (curatedRaw as { files?: unknown }).files === \"object\"\n    && (curatedRaw as { files?: unknown }).files !== null\n      ? (curatedRaw as {\n          updatedAt?: unknown;\n          files: Record<string, { deleted?: boolean; chunks?: unknown[] }>;\n        })\n      : null;\n\n  let curatedActiveChunkCount = 0;\n  let curatedDeletedFileCount = 0;\n  for (const file of Object.values(curatedFiles?.files ?? {})) {\n    if (file.deleted) {\n      curatedDeletedFileCount += 1;\n      continue;\n    }\n    curatedActiveChunkCount += Array.isArray(file.chunks) ? file.chunks.length : 0;\n  }\n\n  const obsidianVaults = obsidianRaw && typeof obsidianRaw === \"object\" && obsidianRaw !== null\n    && \"vaults\" in obsidianRaw && typeof (obsidianRaw as { vaults?: unknown }).vaults === \"object\"\n    && (obsidianRaw as { vaults?: unknown }).vaults !== null\n      ? (obsidianRaw as {\n          updatedAt?: unknown;\n          vaults: Record<string, { notes?: Record<string, { deleted?: boolean; chunks?: unknown[] }> }>;\n        })\n      : null;\n\n  let obsidianActiveChunkCount = 0;\n  let obsidianDeletedNoteCount = 0;\n  for (const vault of Object.values(obsidianVaults?.vaults ?? {})) {\n    for (const note of Object.values(vault.notes ?? {})) {\n      if (note.deleted) {\n        obsidianDeletedNoteCount += 1;\n        continue;\n      }\n      obsidianActiveChunkCount += Array.isArray(note.chunks) ? note.chunks.length : 0;\n    }\n  }\n\n  const openclawFiles = openclawRaw && typeof openclawRaw === \"object\" && openclawRaw !== null\n    && \"files\" in openclawRaw && typeof (openclawRaw as { files?: unknown }).files === \"object\"\n    && (openclawRaw as { files?: unknown }).files !== null\n      ? (openclawRaw as {\n          updatedAt?: unknown;\n          files: Record<string, { deleted?: boolean; chunks?: unknown[] }>;\n        })\n      : null;\n\n  let openclawActiveChunkCount = 0;\n  let openclawDeletedFileCount = 0;\n  for (const file of Object.values(openclawFiles?.files ?? {})) {\n    if (file.deleted) {\n      openclawDeletedFileCount += 1;\n      continue;\n    }\n    openclawActiveChunkCount += Array.isArray(file.chunks) ? file.chunks.length : 0;\n  }\n\n  return {\n    enabled: nativeKnowledge?.enabled === true,\n    includeFiles: nativeKnowledge?.includeFiles ?? [],\n    curatedIncludeSync: {\n      statePath: curatedStatePath,\n      exists: curatedFiles !== null,\n      updatedAt: typeof curatedFiles?.updatedAt === \"string\" ? curatedFiles.updatedAt : null,\n      fileCount: Object.keys(curatedFiles?.files ?? {}).length,\n      activeChunkCount: curatedActiveChunkCount,\n      deletedFileCount: curatedDeletedFileCount,\n    },\n    openclawWorkspaceAdapterEnabled: nativeKnowledge?.openclawWorkspace?.enabled === true,\n    obsidianVaultAdapterEnabled: (nativeKnowledge?.obsidianVaults?.length ?? 0) > 0,\n    obsidianSync: {\n      statePath: obsidianStatePath,\n      exists: obsidianVaults !== null,\n      updatedAt: typeof obsidianVaults?.updatedAt === \"string\" ? obsidianVaults.updatedAt : null,\n      vaultCount: Object.keys(obsidianVaults?.vaults ?? {}).length,\n      activeChunkCount: obsidianActiveChunkCount,\n      deletedNoteCount: obsidianDeletedNoteCount,\n    },\n    openclawWorkspaceSync: {\n      statePath: openclawStatePath,\n      exists: openclawFiles !== null,\n      updatedAt: typeof openclawFiles?.updatedAt === \"string\" ? openclawFiles.updatedAt : null,\n      fileCount: Object.keys(openclawFiles?.files ?? {}).length,\n      activeChunkCount: openclawActiveChunkCount,\n      deletedFileCount: openclawDeletedFileCount,\n    },\n  };\n}\n\nconst CAPTURE_INSTRUCTIONS_START = \"<!-- BEGIN ENGRAM EXPLICIT CAPTURE INSTRUCTIONS -->\";\nconst CAPTURE_INSTRUCTIONS_END = \"<!-- END ENGRAM EXPLICIT CAPTURE INSTRUCTIONS -->\";\n\nfunction buildCaptureInstructions(): string {\n  return [\n    CAPTURE_INSTRUCTIONS_START,\n    \"# Memory\",\n    \"\",\n    \"Use this file for explicit memory capture notes when Engram runs in explicit or hybrid mode.\",\n    \"\",\n    \"## Suggested format\",\n    \"\",\n    \"- Write durable facts, decisions, commitments, or corrections.\",\n    \"- Keep entries concise and specific.\",\n    \"- Avoid secrets, tokens, and private credentials.\",\n    \"\",\n    \"## Example\",\n    \"\",\n    \"- Decision: recall benchmark packs live under `state/evals/benchmarks/`.\",\n    \"- Commitment: rerun `openclaw engram doctor --json` after changing retrieval settings.\",\n    \"\",\n    CAPTURE_INSTRUCTIONS_END,\n  ].join(\"\\n\");\n}\n\nfunction upsertManagedCaptureInstructions(existing: string | null, snippet: string): { content: string; updated: boolean; installed: boolean } {\n  if (!existing || existing.trim().length === 0) {\n    return { content: `${snippet}\\n`, updated: false, installed: true };\n  }\n  if (existing.includes(CAPTURE_INSTRUCTIONS_START) && existing.includes(CAPTURE_INSTRUCTIONS_END)) {\n    const next = existing.replace(\n      new RegExp(`${CAPTURE_INSTRUCTIONS_START}[\\\\s\\\\S]*?${CAPTURE_INSTRUCTIONS_END}`),\n      snippet,\n    );\n    return { content: next.endsWith(\"\\n\") ? next : `${next}\\n`, updated: next !== existing, installed: false };\n  }\n  const trimmed = existing.trimEnd();\n  return {\n    content: `${trimmed}\\n\\n${snippet}\\n`,\n    updated: false,\n    installed: true,\n  };\n}\n\nfunction removeManagedCaptureInstructions(existing: string): { content: string; removed: boolean } {\n  if (!existing.includes(CAPTURE_INSTRUCTIONS_START) || !existing.includes(CAPTURE_INSTRUCTIONS_END)) {\n    return { content: existing, removed: false };\n  }\n  const stripped = existing\n    .replace(new RegExp(`\\\\n*${CAPTURE_INSTRUCTIONS_START}[\\\\s\\\\S]*?${CAPTURE_INSTRUCTIONS_END}\\\\n*`), \"\\n\")\n    .replace(/\\n{3,}/g, \"\\n\\n\")\n    .trim();\n  return {\n    content: stripped.length > 0 ? `${stripped}\\n` : \"\",\n    removed: true,\n  };\n}\n\nexport async function runOperatorSetup(options: OperatorSetupOptions): Promise<OperatorSetupReport> {\n  const now = options.now ?? new Date();\n  const configStatus = await loadCliPluginConfig(options.configPath);\n  const storage = new StorageManager(options.orchestrator.config.memoryDir);\n  await storage.ensureDirectories();\n  await mkdir(options.orchestrator.config.workspaceDir, { recursive: true });\n\n  const qmdAvailable = await options.orchestrator.qmd.probe();\n  const collectionState = options.orchestrator.config.qmdEnabled\n    ? await options.orchestrator.qmd.ensureCollection(options.orchestrator.config.memoryDir)\n    : \"skipped\";\n  const nativeKnowledgeStatus = await summarizeNativeKnowledgeStatus(options.orchestrator.config);\n\n  const memoryDocPath = path.join(options.orchestrator.config.workspaceDir, \"MEMORY.md\");\n  const captureInstructionsMode =\n    options.captureInstructionsMode\n    ?? (options.installCaptureInstructions ? \"install\" : undefined);\n  let memoryDocExists = false;\n  try {\n    await access(memoryDocPath, fsConstants.F_OK);\n    memoryDocExists = true;\n  } catch {\n    memoryDocExists = false;\n  }\n  let memoryDocInstalled = false;\n  let memoryDocUpdated = false;\n  let memoryDocRemoved = false;\n  const explicitCaptureEnabled = options.orchestrator.config.captureMode === \"explicit\"\n    || options.orchestrator.config.captureMode === \"hybrid\";\n  const captureInstructionsPreview = captureInstructionsMode ? buildCaptureInstructions() : null;\n  if (captureInstructionsMode) {\n    if (captureInstructionsMode === \"preview\") {\n      // no-op, preview only\n    } else if (captureInstructionsMode === \"install\") {\n      const existing = memoryDocExists ? await readFile(memoryDocPath, \"utf-8\") : null;\n      const next = upsertManagedCaptureInstructions(existing, captureInstructionsPreview ?? \"\");\n      if (!existing || next.content !== existing) {\n        await writeFile(memoryDocPath, next.content, \"utf-8\");\n      }\n      memoryDocExists = true;\n      memoryDocInstalled = next.installed;\n      memoryDocUpdated = next.updated;\n    } else if (captureInstructionsMode === \"remove\" && memoryDocExists) {\n      const existing = await readFile(memoryDocPath, \"utf-8\");\n      const next = removeManagedCaptureInstructions(existing);\n      if (next.removed) {\n        if (next.content.length === 0) {\n          await unlink(memoryDocPath);\n          memoryDocExists = false;\n        } else {\n          await writeFile(memoryDocPath, next.content, \"utf-8\");\n          memoryDocExists = true;\n        }\n        memoryDocRemoved = true;\n      }\n    }\n  }\n\n  const directories = await gatherDirectoryStatus(getSetupPaths(options.orchestrator.config));\n  const nextSteps = [\n    `Run \\`openclaw engram doctor${options.installCaptureInstructions ? \"\" : \" --json\"}\\` to verify runtime health.`,\n    \"Run `openclaw engram inventory --json` to capture a baseline footprint.\",\n    \"If QMD is enabled and the collection is missing, add the collection to `~/.config/qmd/index.yml` and run `qmd update && qmd embed`.\",\n  ];\n  if (explicitCaptureEnabled && !memoryDocExists) {\n    nextSteps.push(\"Run `openclaw engram setup --preview-capture-instructions` to review the managed explicit-capture snippet, then `--install-capture-instructions` to write it.\");\n  }\n\n  return {\n    schemaVersion: 1,\n    generatedAt: now.toISOString(),\n    config: configStatus,\n    memoryDir: options.orchestrator.config.memoryDir,\n    workspaceDir: options.orchestrator.config.workspaceDir,\n    directories,\n    qmd: {\n      enabled: options.orchestrator.config.qmdEnabled,\n      available: qmdAvailable,\n      collectionState,\n      debugStatus: options.orchestrator.qmd.debugStatus(),\n    },\n    nativeKnowledge: nativeKnowledgeStatus,\n    explicitCapture: {\n      captureMode: options.orchestrator.config.captureMode,\n      enabled: explicitCaptureEnabled,\n      memoryDocPath,\n      memoryDocExists,\n      memoryDocInstalled,\n      memoryDocUpdated,\n      memoryDocRemoved,\n      preview: captureInstructionsMode === \"preview\" ? captureInstructionsPreview : null,\n    },\n    nextSteps,\n    verificationCommands: [\n      \"openclaw engram doctor --json\",\n      \"openclaw engram inventory --json\",\n      \"openclaw engram benchmark recall --json\",\n    ],\n  };\n}\n\nfunction summarizeHygieneWarnings(\n  warnings: Awaited<ReturnType<typeof lintWorkspaceFiles>>,\n  hygiene: FileHygieneConfig | undefined,\n): OperatorDoctorCheck {\n  if (!hygiene?.enabled || hygiene.lintEnabled !== true) {\n    return {\n      key: \"file_hygiene\",\n      status: \"warn\",\n      summary: \"File hygiene linting is disabled; bootstrap file truncation warnings are not active.\",\n      remediation: \"Enable `fileHygiene.enabled` and `fileHygiene.lintEnabled` if large workspace bootstrap files are common.\",\n      details: {\n        enabled: hygiene?.enabled === true,\n        lintEnabled: hygiene?.lintEnabled === true,\n      },\n    };\n  }\n  if (warnings.length > 0) {\n    return {\n      key: \"file_hygiene\",\n      status: \"warn\",\n      summary: `${warnings.length} bootstrap file(s) are near or above the configured budget.`,\n      remediation: \"Archive/split the listed files or adjust `fileHygiene` budgets.\",\n      details: { warnings },\n    };\n  }\n  return {\n    key: \"file_hygiene\",\n    status: \"ok\",\n    summary: \"Bootstrap file hygiene is within budget.\",\n    details: {\n      enabled: true,\n      lintPaths: hygiene.lintPaths,\n      budgetBytes: hygiene.lintBudgetBytes,\n    },\n  };\n}\n\nfunction buildConfigReviewFinding(input: {\n  key: string;\n  status: \"recommend\" | \"problem\";\n  setting: string;\n  currentValue: unknown;\n  defaultValue: unknown;\n  recommendedValue: unknown;\n  summary: string;\n  rationale: string;\n}): OperatorConfigReviewFinding {\n  return {\n    key: input.key,\n    status: input.status,\n    setting: input.setting,\n    currentValue: formatConfigValue(input.currentValue),\n    defaultValue: formatConfigValue(input.defaultValue),\n    recommendedValue: formatConfigValue(input.recommendedValue),\n    summary: input.summary,\n    rationale: input.rationale,\n  };\n}\n\nexport async function runOperatorConfigReview(\n  options: OperatorConfigReviewOptions,\n): Promise<OperatorConfigReviewReport> {\n  const now = options.now ?? new Date();\n  const configStatus = await loadCliPluginConfig(options.configPath);\n  return buildOperatorConfigReviewReport({\n    now,\n    configStatus,\n    config: options.orchestrator.config,\n  });\n}\n\nasync function buildOperatorConfigReviewReport(input: {\n  now: Date;\n  configStatus: OperatorConfigLoadResult;\n  config: PluginConfig;\n}): Promise<OperatorConfigReviewReport> {\n  const { now, configStatus, config } = input;\n  const findings: OperatorConfigReviewFinding[] = [];\n  const searchBackend = config.searchBackend ?? \"qmd\";\n  const workspaceBootstrapFiles = [\n    path.join(config.workspaceDir, \"IDENTITY.md\"),\n    path.join(config.workspaceDir, \"MEMORY.md\"),\n    path.join(config.workspaceDir, \"USER.md\"),\n  ];\n  const workspaceBootstrapExists = (await Promise.all(workspaceBootstrapFiles.map(pathExists))).some(Boolean);\n\n  if (\n    config.memoryOsPreset !== \"conservative\" &&\n    config.memoryOsPreset !== \"balanced\" &&\n    config.memoryOsPreset !== \"research-max\" &&\n    config.memoryOsPreset !== \"local-llm-heavy\" &&\n    config.queryAwareIndexingEnabled === false &&\n    config.verbatimArtifactsEnabled === false &&\n    config.rerankEnabled === false\n  ) {\n    findings.push(buildConfigReviewFinding({\n      key: \"balanced_preset\",\n      status: \"recommend\",\n      setting: \"memoryOsPreset\",\n      currentValue: config.memoryOsPreset,\n      defaultValue: \"(unset)\",\n      recommendedValue: \"balanced\",\n      summary: \"Adopt the balanced preset as the baseline configuration profile.\",\n      rationale:\n        \"The balanced preset enables the recommended indexing, reranking, and artifact defaults without turning on the higher-churn graph and learning loops.\",\n    }));\n  }\n\n  if (config.qmdEnabled && config.qmdDaemonEnabled === false) {\n    findings.push(buildConfigReviewFinding({\n      key: \"qmd_daemon\",\n      status: \"recommend\",\n      setting: \"qmdDaemonEnabled\",\n      currentValue: config.qmdDaemonEnabled,\n      defaultValue: true,\n      recommendedValue: true,\n      summary: \"Enable the QMD daemon path when QMD powers recall.\",\n      rationale:\n        \"The daemon path reduces recall/search contention by preferring the MCP transport instead of repeated subprocess calls when QMD is available.\",\n    }));\n  }\n\n  if (workspaceBootstrapExists && config.nativeKnowledge?.enabled !== true) {\n    findings.push(buildConfigReviewFinding({\n      key: \"native_knowledge_enabled\",\n      status: \"recommend\",\n      setting: \"nativeKnowledge.enabled\",\n      currentValue: config.nativeKnowledge?.enabled,\n      defaultValue: false,\n      recommendedValue: true,\n      summary: \"Enable native knowledge recall for workspace bootstrap documents.\",\n      rationale:\n        \"When files like IDENTITY.md or MEMORY.md already exist, native knowledge recall can chunk and inject them directly instead of relying only on extracted memories.\",\n    }));\n  }\n\n  if (workspaceBootstrapExists && config.fileHygiene?.enabled !== true) {\n    findings.push(buildConfigReviewFinding({\n      key: \"file_hygiene_enabled\",\n      status: \"recommend\",\n      setting: \"fileHygiene.enabled\",\n      currentValue: config.fileHygiene?.enabled,\n      defaultValue: false,\n      recommendedValue: true,\n      summary: \"Enable file hygiene to avoid silent workspace-file truncation.\",\n      rationale:\n        \"OpenClaw bootstrap files can grow quietly; file hygiene warns before oversized files are truncated during prompt bootstrap.\",\n    }));\n  }\n\n  if (searchBackend === \"qmd\" && config.qmdEnabled === false) {\n    findings.push(buildConfigReviewFinding({\n      key: \"qmd_search_backend_disabled\",\n      status: \"problem\",\n      setting: \"qmdEnabled\",\n      currentValue: config.qmdEnabled,\n      defaultValue: true,\n      recommendedValue: true,\n      summary: \"QMD search is selected but QMD is disabled.\",\n      rationale:\n        \"When searchBackend resolves to qmd while qmdEnabled is false, Engram falls back to the noop backend and disables the primary search path.\",\n    }));\n  }\n\n  if (config.qmdColdTierEnabled === true && config.qmdEnabled === false) {\n    findings.push(buildConfigReviewFinding({\n      key: \"qmd_cold_tier_requires_qmd\",\n      status: \"problem\",\n      setting: \"qmdEnabled\",\n      currentValue: config.qmdEnabled,\n      defaultValue: true,\n      recommendedValue: true,\n      summary: \"Cold-tier QMD recall is enabled while QMD itself is disabled.\",\n      rationale:\n        \"The cold tier depends on the same QMD runtime as the hot tier, so turning QMD off leaves the extra tiering path unusable.\",\n    }));\n  }\n\n  if (config.qmdTierMigrationEnabled && config.qmdColdTierEnabled !== true) {\n    findings.push(buildConfigReviewFinding({\n      key: \"qmd_tier_migration_requires_cold_tier\",\n      status: \"problem\",\n      setting: \"qmdColdTierEnabled\",\n      currentValue: config.qmdColdTierEnabled,\n      defaultValue: false,\n      recommendedValue: true,\n      summary: \"Hot/cold tier migration is enabled without the cold tier itself.\",\n      rationale:\n        \"Tier migration depends on the cold-tier collection and recall path, so enabling migration while the cold tier is off leaves the feature in a contradictory state.\",\n    }));\n  }\n\n  if (config.conversationIndexEnabled && config.conversationIndexBackend === \"qmd\" && config.qmdEnabled === false) {\n    findings.push(buildConfigReviewFinding({\n      key: \"conversation_index_qmd_requires_qmd\",\n      status: \"problem\",\n      setting: \"qmdEnabled\",\n      currentValue: config.qmdEnabled,\n      defaultValue: true,\n      recommendedValue: true,\n      summary: \"The conversation index is configured for QMD while QMD is disabled.\",\n      rationale:\n        \"A QMD-backed conversation index cannot rebuild or serve queries when the underlying QMD runtime is disabled.\",\n    }));\n  }\n\n  const summary = findings.reduce(\n    (acc, finding) => {\n      acc[finding.status] += 1;\n      return acc;\n    },\n    { recommend: 0, problem: 0 },\n  );\n\n  return {\n    schemaVersion: 1,\n    generatedAt: now.toISOString(),\n    ok: configStatus.parsed && summary.problem === 0,\n    config: configStatus,\n    profile: {\n      memoryOsPreset: config.memoryOsPreset,\n      searchBackend,\n      qmdEnabled: config.qmdEnabled,\n      qmdDaemonEnabled: config.qmdDaemonEnabled,\n      nativeKnowledgeEnabled: config.nativeKnowledge?.enabled === true,\n      fileHygieneEnabled: config.fileHygiene?.enabled === true,\n      conversationIndexEnabled: config.conversationIndexEnabled,\n    },\n    summary,\n    findings,\n  };\n}\n\nexport async function runOperatorDoctor(options: OperatorDoctorOptions): Promise<OperatorDoctorReport> {\n  const now = options.now ?? new Date();\n  const configStatus = await loadCliPluginConfig(options.configPath);\n  const checks: OperatorDoctorCheck[] = [];\n  const config = options.orchestrator.config;\n  const configReview = await buildOperatorConfigReviewReport({\n    now,\n    configStatus,\n    config,\n  });\n  const nativeKnowledgeStatus = await summarizeNativeKnowledgeStatus(config);\n  const setupPaths = await gatherDirectoryStatus(getSetupPaths(config));\n  const missingPaths = setupPaths.filter((entry) => !entry.exists).map((entry) => entry.path);\n\n  checks.push({\n    key: \"config\",\n    status: configStatus.parsed\n      ? \"ok\"\n      : options.configPath\n      ? \"error\"\n      : \"warn\",\n    summary: configStatus.parsed ? \"OpenClaw config loaded and Engram config parsed successfully.\" : \"Config file could not be parsed.\",\n    remediation: configStatus.parsed ? undefined : \"Fix the config file or set OPENCLAW_ENGRAM_CONFIG_PATH/OPENCLAW_CONFIG_PATH.\",\n    details: configStatus,\n  });\n\n  checks.push({\n    key: \"memory_dir\",\n    status: missingPaths.length === 0 ? \"ok\" : \"warn\",\n    summary: missingPaths.length === 0\n      ? \"Expected Engram directories exist.\"\n      : `${missingPaths.length} expected directory path(s) are missing.`,\n    remediation: missingPaths.length === 0 ? undefined : \"Run `openclaw engram setup` to create missing directories.\",\n    details: { directories: setupPaths },\n  });\n\n  checks.push({\n    key: \"config_review\",\n    status: configReview.summary.problem > 0 ? \"error\" : configReview.summary.recommend > 0 ? \"warn\" : \"ok\",\n    summary: configReview.summary.problem > 0\n      ? `${configReview.summary.problem} configuration problem(s) detected.`\n      : configReview.summary.recommend > 0\n      ? `No configuration problems detected; ${configReview.summary.recommend} optional recommendation(s) are available.`\n      : \"No configuration problems detected.\",\n    remediation: configReview.summary.problem > 0 || configReview.summary.recommend > 0\n      ? \"Run `openclaw engram config-review` to inspect and fix the flagged configuration combinations.\"\n      : undefined,\n    details: configReview,\n  });\n\n  const qmdAvailable = await options.orchestrator.qmd.probe();\n  const collectionState = config.qmdEnabled\n    ? await options.orchestrator.qmd.ensureCollection(config.memoryDir)\n    : \"skipped\";\n  checks.push({\n    key: \"qmd\",\n    status: !config.qmdEnabled\n      ? \"warn\"\n      : !qmdAvailable\n      ? \"error\"\n      : collectionState === \"present\"\n      ? \"ok\"\n      : collectionState === \"missing\"\n      ? \"error\"\n      : \"warn\",\n    summary: !config.qmdEnabled\n      ? \"QMD is disabled in config.\"\n      : qmdAvailable\n      ? `QMD is reachable (${collectionState}).`\n      : \"QMD is not currently reachable.\",\n    remediation: !config.qmdEnabled\n      ? \"Enable `qmdEnabled` if you expect hybrid search.\"\n      : !qmdAvailable\n      ? \"Ensure the `qmd` binary is installed and on PATH, or set `qmdPath`.\"\n      : collectionState === \"missing\"\n      ? \"Add the configured collection to `~/.config/qmd/index.yml`.\"\n      : collectionState === \"present\"\n      ? undefined\n      : \"Re-run `openclaw engram setup` after restoring QMD access.\",\n    details: {\n      available: qmdAvailable,\n      collectionState,\n      debugStatus: options.orchestrator.qmd.debugStatus(),\n    },\n  });\n\n  const conversationIndex = await options.orchestrator.getConversationIndexHealth();\n  checks.push({\n    key: \"conversation_index\",\n    status: conversationIndex.status === \"ok\"\n      ? \"ok\"\n      : conversationIndex.enabled\n      ? \"error\"\n      : \"warn\",\n    summary: conversationIndex.enabled\n      ? `Conversation index backend is ${conversationIndex.status}.`\n      : \"Conversation index is disabled.\",\n    remediation: conversationIndex.enabled && conversationIndex.status !== \"ok\"\n      ? \"Run `openclaw engram rebuild-index` to refresh the conversation index artifacts.\"\n      : undefined,\n    details: conversationIndex,\n  });\n\n  const meta = await new StorageManager(config.memoryDir).loadMeta();\n  checks.push({\n    key: \"maintenance\",\n    status: meta.lastExtractionAt || meta.lastConsolidationAt ? \"ok\" : \"warn\",\n    summary: meta.lastExtractionAt || meta.lastConsolidationAt\n      ? \"Extraction/consolidation metadata is present.\"\n      : \"No extraction or consolidation metadata found yet.\",\n    remediation: meta.lastExtractionAt || meta.lastConsolidationAt\n      ? undefined\n      : \"Run a normal agent turn or `openclaw engram consolidate` after seeding memory.\",\n    details: meta,\n  });\n\n  const syncedChunkCount =\n    nativeKnowledgeStatus.curatedIncludeSync.activeChunkCount +\n    nativeKnowledgeStatus.obsidianSync.activeChunkCount +\n    nativeKnowledgeStatus.openclawWorkspaceSync.activeChunkCount;\n  const hasSyncState =\n    nativeKnowledgeStatus.curatedIncludeSync.exists ||\n    nativeKnowledgeStatus.obsidianSync.exists ||\n    nativeKnowledgeStatus.openclawWorkspaceSync.exists;\n  checks.push({\n    key: \"native_knowledge\",\n    status: !nativeKnowledgeStatus.enabled\n      ? \"warn\"\n      : hasSyncState\n        ? \"ok\"\n        : \"warn\",\n    summary: !nativeKnowledgeStatus.enabled\n      ? \"Native knowledge sync is disabled.\"\n      : hasSyncState\n        ? `Native knowledge sync state is present (${syncedChunkCount} active chunks).`\n        : \"Native knowledge sync is enabled but no sync state has been written yet.\",\n    remediation: !nativeKnowledgeStatus.enabled\n      ? \"Enable `nativeKnowledge.enabled` if curated workspace recall should participate in retrieval.\"\n      : hasSyncState\n        ? undefined\n        : \"Run a recall, sync, or setup flow that touches native knowledge sources, then rerun `openclaw engram doctor --json`.\",\n    details: nativeKnowledgeStatus,\n  });\n\n  const agentAccessEnabled = config.agentAccessHttp?.enabled === true;\n  checks.push({\n    key: \"access_http_auth\",\n    status: !agentAccessEnabled\n      ? \"warn\"\n      : config.agentAccessHttp?.authToken\n      ? \"ok\"\n      : \"error\",\n    summary: !agentAccessEnabled\n      ? \"Agent access HTTP bridge is disabled.\"\n      : config.agentAccessHttp?.authToken\n      ? \"Agent access HTTP bridge has an auth token configured.\"\n      : \"Agent access HTTP bridge is enabled without an auth token.\",\n    remediation: !agentAccessEnabled\n      ? \"Ignore unless you plan to enable the HTTP bridge.\"\n      : config.agentAccessHttp?.authToken\n      ? undefined\n      : \"Set `agentAccessHttp.authToken` before exposing the bridge.\",\n  });\n\n  const warnings = config.fileHygiene?.lintEnabled\n    ? await lintWorkspaceFiles({\n        workspaceDir: config.workspaceDir,\n        paths: config.fileHygiene.lintPaths,\n        budgetBytes: config.fileHygiene.lintBudgetBytes,\n        warnRatio: config.fileHygiene.lintWarnRatio,\n      })\n    : [];\n  checks.push(summarizeHygieneWarnings(warnings, config.fileHygiene));\n\n  const summary = checks.reduce(\n    (acc, check) => {\n      acc[check.status] += 1;\n      return acc;\n    },\n    { ok: 0, warn: 0, error: 0 },\n  );\n\n  return {\n    schemaVersion: 1,\n    generatedAt: now.toISOString(),\n    ok: summary.error === 0,\n    summary,\n    config: configStatus,\n    checks,\n  };\n}\n\nfunction getMemoryAgeBand(memory: MemoryFile, now: Date): string {\n  const created = Date.parse(memory.frontmatter.created ?? \"\");\n  if (!Number.isFinite(created)) return \"unknown\";\n  const ageDays = Math.max(0, Math.floor((now.getTime() - created) / 86_400_000));\n  if (ageDays < 7) return \"0_6d\";\n  if (ageDays < 30) return \"7_29d\";\n  if (ageDays < 90) return \"30_89d\";\n  return \"90d_plus\";\n}\n\nasync function dirSize(targetPath: string): Promise<number> {\n  try {\n    const info = await stat(targetPath);\n    if (info.isFile()) return info.size;\n    if (!info.isDirectory()) return 0;\n  } catch {\n    return 0;\n  }\n\n  let total = 0;\n  let entries;\n  try {\n    entries = await readdir(targetPath, { withFileTypes: true });\n  } catch {\n    return 0;\n  }\n  for (const entry of entries) {\n    total += await dirSize(path.join(targetPath, entry.name));\n  }\n  return total;\n}\n\nasync function summarizeStorageFootprint(memoryDir: string): Promise<{ bytes: number; byTopLevel: Record<string, number> }> {\n  const topLevel = [\n    \"facts\",\n    \"entities\",\n    \"questions\",\n    \"corrections\",\n    \"artifacts\",\n    \"state\",\n    \"identity\",\n    \"namespaces\",\n    \"summaries\",\n    \"profile.md\",\n  ];\n  const byTopLevel: Record<string, number> = {};\n  let bytes = 0;\n  for (const name of topLevel) {\n    const size = await dirSize(path.join(memoryDir, name));\n    if (size > 0) {\n      byTopLevel[name] = size;\n      bytes += size;\n    }\n  }\n  return { bytes, byTopLevel };\n}\n\nexport async function runOperatorInventory(options: OperatorInventoryOptions): Promise<OperatorInventoryReport> {\n  const now = options.now ?? new Date();\n  const config = options.orchestrator.config;\n  const namespaceEntries = await listNamespaces({ config });\n  const uniqueRootEntries = new Map<string, { namespace: string; rootDir: string }>();\n  for (const entry of namespaceEntries) {\n    if (!uniqueRootEntries.has(entry.rootDir)) {\n      uniqueRootEntries.set(entry.rootDir, { namespace: entry.namespace, rootDir: entry.rootDir });\n    }\n  }\n  const categories: Record<string, number> = {};\n  const statuses: Record<string, number> = {};\n  const ageBands: Record<string, number> = {\n    \"0_6d\": 0,\n    \"7_29d\": 0,\n    \"30_89d\": 0,\n    \"90d_plus\": 0,\n    unknown: 0,\n  };\n  const namespaces: OperatorInventoryNamespaceSummary[] = [];\n  let totalMemories = 0;\n  let totalEntities = 0;\n  let archived = 0;\n  let pendingReview = 0;\n  let quarantined = 0;\n  let rejected = 0;\n\n  for (const entry of uniqueRootEntries.values()) {\n    const storage = new StorageManager(entry.rootDir);\n    const memories = await storage.readAllMemories();\n    const entities = await storage.readAllEntityFiles();\n    namespaces.push({\n      namespace: entry.namespace,\n      memoryCount: memories.length,\n      entityCount: entities.length,\n    });\n    totalMemories += memories.length;\n    totalEntities += entities.length;\n    for (const memory of memories) {\n      const category = memory.frontmatter.category;\n      categories[category] = (categories[category] ?? 0) + 1;\n      const status = memory.frontmatter.status ?? \"active\";\n      statuses[status] = (statuses[status] ?? 0) + 1;\n      ageBands[getMemoryAgeBand(memory, now)] += 1;\n      if (status === \"archived\") archived += 1;\n      if (status === \"pending_review\") pendingReview += 1;\n      if (status === \"quarantined\") quarantined += 1;\n      if (status === \"rejected\") rejected += 1;\n    }\n  }\n\n  const defaultStorage = new StorageManager(config.memoryDir);\n  const profile = await defaultStorage.readProfile();\n  const footprint = await summarizeStorageFootprint(config.memoryDir);\n  const reviewRunId = (await listMemoryGovernanceRuns(config.memoryDir))[0];\n  let reviewQueue = 0;\n  if (reviewRunId) {\n    try {\n      reviewQueue = (await readMemoryGovernanceRunArtifact(config.memoryDir, reviewRunId)).reviewQueue.length;\n    } catch {\n      reviewQueue = 0;\n    }\n  }\n  const conversationIndex = await options.orchestrator.getConversationIndexHealth();\n  const nativeKnowledgeStatus = await summarizeNativeKnowledgeStatus(config);\n\n  return {\n    schemaVersion: 1,\n    generatedAt: now.toISOString(),\n    memoryDir: config.memoryDir,\n    totals: {\n      memories: totalMemories,\n      entities: totalEntities,\n      namespaces: namespaceEntries.length,\n      reviewQueue,\n      storageBytes: footprint.bytes,\n    },\n    categories,\n    statuses,\n    namespaces,\n    ageBands,\n    profile: {\n      exists: profile.length > 0,\n      chars: profile.length,\n      lines: profile.length > 0 ? profile.split(\"\\n\").length : 0,\n    },\n    storageFootprint: footprint,\n    archivePressure: {\n      archived,\n      pendingReview,\n      quarantined,\n      rejected,\n    },\n    conversationIndex: {\n      enabled: conversationIndex.enabled,\n      backend: conversationIndex.backend,\n      status: conversationIndex.status,\n      chunkDocCount: conversationIndex.chunkDocCount,\n      lastUpdateAt: conversationIndex.lastUpdateAt,\n    },\n    nativeKnowledge: {\n      enabled: nativeKnowledgeStatus.enabled,\n      curatedIncludeSync: nativeKnowledgeStatus.curatedIncludeSync,\n      obsidianSync: nativeKnowledgeStatus.obsidianSync,\n      openclawWorkspaceSync: nativeKnowledgeStatus.openclawWorkspaceSync,\n    },\n  };\n}\n\nexport async function runBenchmarkRecall(options: BenchmarkRecallOptions): Promise<BenchmarkRecallReport> {\n  const now = options.now ?? new Date();\n  const status = await getEvalHarnessStatus({\n    memoryDir: options.config.memoryDir,\n    evalStoreDir: options.config.evalStoreDir,\n    enabled: options.config.evalHarnessEnabled,\n    shadowModeEnabled: options.config.evalShadowModeEnabled,\n    baselineSnapshotsEnabled: options.config.benchmarkBaselineSnapshotsEnabled,\n    memoryRedTeamBenchEnabled: options.config.memoryRedTeamBenchEnabled,\n  });\n\n  if (options.createSnapshot && options.snapshotId) {\n    const snapshot = await createEvalBaselineSnapshot({\n      memoryDir: options.config.memoryDir,\n      evalStoreDir: options.config.evalStoreDir,\n      baselineSnapshotsEnabled: options.config.benchmarkBaselineSnapshotsEnabled,\n      snapshotId: options.snapshotId,\n      notes: options.snapshotNotes,\n      gitRef: options.gitRef,\n      createdAt: options.createdAt,\n    });\n    return {\n      schemaVersion: 1,\n      generatedAt: now.toISOString(),\n      mode: \"snapshot\",\n      status,\n      snapshot: {\n        targetPath: snapshot.targetPath,\n        snapshotId: snapshot.snapshot.snapshotId,\n      },\n    };\n  }\n\n  if (options.baseEvalStoreDir && options.candidateEvalStoreDir) {\n    const ciGate = await runEvalBenchmarkCiGate({\n      baseEvalStoreDir: options.baseEvalStoreDir,\n      candidateEvalStoreDir: options.candidateEvalStoreDir,\n    });\n    return {\n      schemaVersion: 1,\n      generatedAt: now.toISOString(),\n      mode: \"ci-gate\",\n      status,\n      ciGate,\n    };\n  }\n\n  if (options.snapshotId) {\n    const baselineReport = await runEvalBaselineDeltaReport({\n      memoryDir: options.config.memoryDir,\n      evalStoreDir: options.config.evalStoreDir,\n      benchmarkDeltaReporterEnabled: options.config.benchmarkDeltaReporterEnabled,\n      snapshotId: options.snapshotId,\n    });\n    return {\n      schemaVersion: 1,\n      generatedAt: now.toISOString(),\n      mode: \"baseline-report\",\n      status,\n      baselineReport,\n    };\n  }\n\n  if (options.validatePath) {\n    const validate = await validateEvalBenchmarkPack(options.validatePath, {\n      memoryRedTeamBenchEnabled: options.config.memoryRedTeamBenchEnabled,\n    });\n    return {\n      schemaVersion: 1,\n      generatedAt: now.toISOString(),\n      mode: \"validate\",\n      status,\n      validate,\n    };\n  }\n\n  return {\n    schemaVersion: 1,\n    generatedAt: now.toISOString(),\n    mode: \"status\",\n    status,\n  };\n}\n\nexport async function runOperatorRepair(options: OperatorRepairOptions): Promise<OperatorRepairReport> {\n  const now = options.now ?? new Date();\n  const dryRun = options.dryRun === true || options.apply !== true;\n  const sessionCheck = await analyzeSessionIntegrity({ memoryDir: options.config.memoryDir });\n  const sessionRepairPlan = planSessionRepair({\n    report: sessionCheck,\n    dryRun,\n    allowSessionFileRepair: options.allowSessionFileRepair,\n    sessionFilesDir: options.sessionFilesDir,\n  });\n  const sessionRepairApply = await applySessionRepair({\n    plan: sessionRepairPlan,\n  });\n  const graphHealth = await analyzeGraphHealth(options.config.memoryDir, {\n    entityGraphEnabled: options.config.entityGraphEnabled,\n    timeGraphEnabled: options.config.timeGraphEnabled,\n    causalGraphEnabled: options.config.causalGraphEnabled,\n    includeRepairGuidance: true,\n  });\n  return {\n    schemaVersion: 1,\n    generatedAt: now.toISOString(),\n    dryRun,\n    sessionCheck,\n    sessionRepairPlan,\n    sessionRepairApply,\n    graphHealth,\n  };\n}\n","import path from \"node:path\";\nimport { access, mkdir, readdir, rename } from \"node:fs/promises\";\nimport type { PluginConfig } from \"../types.js\";\nimport { NamespaceStorageRouter } from \"./storage.js\";\nimport { namespaceCollectionName } from \"./search.js\";\nimport { isSafeRouteNamespace } from \"../routing/engine.js\";\n\nconst LEGACY_NAMESPACE_CHILDREN = [\n  \"facts\",\n  \"corrections\",\n  \"entities\",\n  \"questions\",\n  \"artifacts\",\n  \"identity\",\n  \"state\",\n  \"config\",\n  \"summaries\",\n  \"profile.md\",\n] as const;\n\nexport interface NamespaceInventoryEntry {\n  namespace: string;\n  rootDir: string;\n  exists: boolean;\n  usesLegacyRoot: boolean;\n  hasMemoryData: boolean;\n  collection: string;\n}\n\nexport interface NamespaceVerifyReport {\n  ok: boolean;\n  problems: string[];\n  namespaces: NamespaceInventoryEntry[];\n}\n\nexport interface NamespaceMigrationMove {\n  from: string;\n  to: string;\n}\n\nexport interface NamespaceMigrationReport {\n  dryRun: boolean;\n  fromRoot: string;\n  targetRoot: string;\n  moved: NamespaceMigrationMove[];\n  collection: string;\n}\n\nasync function exists(p: string): Promise<boolean> {\n  try {\n    await access(p);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nasync function hasAnyLegacyData(rootDir: string): Promise<boolean> {\n  for (const child of LEGACY_NAMESPACE_CHILDREN) {\n    if (await exists(path.join(rootDir, child))) return true;\n  }\n  return false;\n}\n\nasync function discoverConfiguredNamespaces(\n  config: PluginConfig,\n): Promise<string[]> {\n  const discovered = new Set<string>([\n    config.defaultNamespace,\n    config.sharedNamespace,\n    ...config.namespacePolicies.map((policy) => policy.name),\n  ]);\n\n  const namespacesDir = path.join(config.memoryDir, \"namespaces\");\n  try {\n    const entries = await readdir(namespacesDir, { withFileTypes: true });\n    for (const entry of entries) {\n      if (entry.isDirectory() && isSafeRouteNamespace(entry.name)) {\n        discovered.add(entry.name);\n      }\n    }\n  } catch {\n    // No namespace directory yet.\n  }\n\n  return [...discovered];\n}\n\nexport async function listNamespaces(options: {\n  config: PluginConfig;\n  storageRouter?: NamespaceStorageRouter;\n}): Promise<NamespaceInventoryEntry[]> {\n  const storageRouter = options.storageRouter ?? new NamespaceStorageRouter(options.config);\n  const namespaces = await discoverConfiguredNamespaces(options.config);\n  const items = await Promise.all(\n    namespaces.map(async (namespace) => {\n      const storage = await storageRouter.storageFor(namespace);\n      const usesLegacyRoot =\n        namespace === options.config.defaultNamespace &&\n        storage.dir === options.config.memoryDir;\n      return {\n        namespace,\n        rootDir: storage.dir,\n        exists: await exists(storage.dir),\n        usesLegacyRoot,\n        hasMemoryData: await hasAnyLegacyData(storage.dir),\n        collection: namespaceCollectionName(options.config.qmdCollection, namespace, {\n          defaultNamespace: options.config.defaultNamespace,\n          useLegacyDefaultCollection: usesLegacyRoot,\n        }),\n      } satisfies NamespaceInventoryEntry;\n    }),\n  );\n\n  return items.sort((a, b) => a.namespace.localeCompare(b.namespace));\n}\n\nexport async function verifyNamespaces(options: {\n  config: PluginConfig;\n  storageRouter?: NamespaceStorageRouter;\n}): Promise<NamespaceVerifyReport> {\n  const namespaces = await listNamespaces(options);\n  const problems: string[] = [];\n\n  for (const entry of namespaces) {\n    if (entry.exists && !entry.hasMemoryData) {\n      problems.push(`${entry.namespace}: root exists but contains no Engram data`);\n    }\n  }\n\n  return {\n    ok: problems.length === 0,\n    problems,\n    namespaces,\n  };\n}\n\nexport async function runNamespaceMigration(options: {\n  config: PluginConfig;\n  to: string;\n  dryRun?: boolean;\n}): Promise<NamespaceMigrationReport> {\n  if (!options.config.namespacesEnabled) {\n    throw new Error(\"Namespaces are disabled.\");\n  }\n\n  const targetNamespace = options.to.trim();\n  if (!isSafeRouteNamespace(targetNamespace)) {\n    throw new Error(`Invalid namespace: ${options.to}`);\n  }\n\n  const targetRoot = path.join(options.config.memoryDir, \"namespaces\", targetNamespace);\n  const moved: NamespaceMigrationMove[] = [];\n\n  for (const child of LEGACY_NAMESPACE_CHILDREN) {\n    const from = path.join(options.config.memoryDir, child);\n    if (!(await exists(from))) continue;\n    const to = path.join(targetRoot, child);\n    if (await exists(to)) {\n      throw new Error(`Target already contains ${child}: ${to}`);\n    }\n    moved.push({ from, to });\n  }\n\n  if (!options.dryRun && moved.length > 0) {\n    await mkdir(targetRoot, { recursive: true });\n    for (const move of moved) {\n      await rename(move.from, move.to);\n    }\n  }\n\n  return {\n    dryRun: options.dryRun === true,\n    fromRoot: options.config.memoryDir,\n    targetRoot,\n    moved,\n    collection: namespaceCollectionName(options.config.qmdCollection, targetNamespace, {\n      defaultNamespace: options.config.defaultNamespace,\n      useLegacyDefaultCollection: false,\n    }),\n  };\n}\n"],"mappings":"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","names":["path","access","mkdir","readdir","path","access","mkdir","readdir"]}

package/dist/{chunk-6UJQNRIO.js → chunk-3SV6CQHO.js}

@@ -6,26 +6,27 @@ import {
   ProactiveExtractionResultSchema,
   ProactiveQuestionsResultSchema,
   buildProfileConsolidationResultSchema
-} from "./chunk-MWGVGUIS.js";
+} from "./chunk-UEYA6UC7.js";
 import {
   ProfilingCollector
-} from "./chunk-763GUIOU.js";
+} from "./chunk-NBNN5GOB.js";
 import {
   ModelRegistry
-} from "./chunk-ONRU4L2N.js";
+} from "./chunk-FEMOX5AD.js";
 import {
   LocalLlmClient
-} from "./chunk-MDDAA2AO.js";
+} from "./chunk-JL2PU6AI.js";
 import {
+  buildExtensionsFooterForSummary,
   formatDaySummaryMemories,
   loadDaySummaryPrompt
-} from "./chunk-2PO5ZRKV.js";
+} from "./chunk-GZCUW5IC.js";
 import {
   delinearize
 } from "./chunk-VEWZZM3H.js";
 import {
   FallbackLlmClient
-} from "./chunk-XUHI52HK.js";
+} from "./chunk-44ICJRF3.js";
 import {
   buildChatCompletionTokenLimit,
   shouldAssumeOpenAiChatCompletions
@@ -36,12 +37,15 @@ import {
 import {
   applyWorkExtractionBoundary
 } from "./chunk-EEQLFRUM.js";
+import {
+  normalizeProcedureSteps
+} from "./chunk-QDW3E4RD.js";
 import {
   sanitizeMemoryContent
 } from "./chunk-M62O4P4T.js";
 import {
   log
-} from "./chunk-KWBU5S5U.js";
+} from "./chunk-2ODBA7MQ.js";
 
 // src/extraction.ts
 import OpenAI from "openai";
@@ -134,8 +138,9 @@ var ExtractionEngine = class {
     return shouldAssumeOpenAiChatCompletions(this.config.openaiBaseUrl);
   }
   sanitizeExtractionResult(result, messageTimestamp) {
+    const proceduralOn = this.config.procedural?.enabled === true;
     const ts = messageTimestamp ?? /* @__PURE__ */ new Date();
-    const facts = result.facts.map((fact) => {
+    const facts = result.facts.filter((fact) => proceduralOn || fact.category !== "procedure").map((fact) => {
       const sanitized = sanitizeMemoryContent(fact.content);
       if (!sanitized.clean) {
         log.warn(`extraction fact sanitized; violations=${sanitized.violations.join(", ")}`);
@@ -152,12 +157,7 @@ var ExtractionEngine = class {
     return result.facts.length > 0 || result.entities.length > 0 || result.questions.length > 0 || result.profileUpdates.length > 0 || (result.relationships?.length ?? 0) > 0;
   }
   normalizeExtractionResultPayload(parsed) {
-    const entities = Array.isArray(parsed?.entities) ? parsed.entities.map((e) => ({
-      name: typeof e?.name === "string" ? e.name : "",
-      type: typeof e?.type === "string" ? e.type : "other",
-      facts: Array.isArray(e?.facts) ? e.facts.filter((f) => typeof f === "string") : [],
-      promptedByQuestion: typeof e?.promptedByQuestion === "string" ? e.promptedByQuestion : void 0
-    })).filter((e) => e.name.length > 0) : [];
+    const entities = Array.isArray(parsed?.entities) ? parsed.entities.map((e) => this.normalizeEntityUpdate(e)).filter((e) => e.name.length > 0) : [];
     const facts = Array.isArray(parsed?.facts) ? parsed.facts.map((f) => ({
       category: typeof f?.category === "string" ? f.category : "fact",
       content: typeof f?.content === "string" ? f.content : typeof f?.text === "string" ? f.text : "",
@@ -167,7 +167,8 @@ var ExtractionEngine = class {
       promptedByQuestion: typeof f?.promptedByQuestion === "string" ? f.promptedByQuestion : void 0,
       structuredAttributes: f?.structuredAttributes && typeof f.structuredAttributes === "object" && !Array.isArray(f.structuredAttributes) ? Object.fromEntries(
         Object.entries(f.structuredAttributes).filter(([k, v]) => typeof k === "string" && typeof v === "string")
-      ) : void 0
+      ) : void 0,
+      procedureSteps: Array.isArray(f?.procedureSteps) ? normalizeProcedureSteps(f.procedureSteps) : void 0
     })).filter((f) => f.content.length > 0) : [];
     const questions = Array.isArray(parsed?.questions) ? parsed.questions.map((q) => {
       if (typeof q === "string") return { question: q, context: "", priority: 0.5 };
@@ -193,6 +194,19 @@ var ExtractionEngine = class {
       })) : void 0
     };
   }
+  normalizeEntityUpdate(entity) {
+    return {
+      name: typeof entity?.name === "string" ? entity.name : "",
+      type: typeof entity?.type === "string" ? entity.type : "other",
+      facts: Array.isArray(entity?.facts) ? entity.facts.filter((fact) => typeof fact === "string") : [],
+      structuredSections: Array.isArray(entity?.structuredSections) ? entity.structuredSections.map((section) => ({
+        key: typeof section?.key === "string" ? section.key.trim() : "",
+        title: typeof section?.title === "string" ? section.title.trim() : "",
+        facts: Array.isArray(section?.facts) ? section.facts.filter((fact) => typeof fact === "string").map((fact) => fact.trim()).filter((fact) => fact.length > 0) : []
+      })).filter((section) => section.key.length > 0 && section.title.length > 0 && section.facts.length > 0) : void 0,
+      promptedByQuestion: typeof entity?.promptedByQuestion === "string" ? entity.promptedByQuestion : void 0
+    };
+  }
   parseJsonObject(content) {
     const trimmed = content?.trim();
     if (!trimmed) return null;
@@ -391,7 +405,7 @@ var ExtractionEngine = class {
       `Return at most ${maxAdditional} additional high-confidence memory candidates that were omitted from the base extraction.`,
       "Only include information directly supported by the conversation. Do not speculate. Do not repeat the base extraction.",
       "Return only valid JSON with this shape:",
-      '{"facts":[{"category":"fact","content":"...","confidence":0.0,"tags":["..."],"entityRef":"optional","promptedByQuestion":"optional"}],"profileUpdates":["..."],"entities":[{"name":"...","type":"person","facts":["..."],"promptedByQuestion":"optional"}],"relationships":[{"source":"...","target":"...","label":"...","promptedByQuestion":"optional"}]}',
+      '{"facts":[{"category":"fact","content":"...","confidence":0.0,"tags":["..."],"entityRef":"optional","promptedByQuestion":"optional"}],"profileUpdates":["..."],"entities":[{"name":"...","type":"person","facts":["..."],"structuredSections":[{"key":"beliefs","title":"Beliefs","facts":["..."]}],"promptedByQuestion":"optional"}],"relationships":[{"source":"...","target":"...","label":"...","promptedByQuestion":"optional"}]}',
       "",
       "Base extracted facts (do not repeat):",
       factsPreview || "(none)",
@@ -480,7 +494,11 @@ var ExtractionEngine = class {
     }
     const mergedEntities = base.entities.map((entity) => ({
       ...entity,
-      facts: [...entity.facts]
+      facts: [...entity.facts],
+      structuredSections: entity.structuredSections ? entity.structuredSections.map((section) => ({
+        ...section,
+        facts: [...section.facts]
+      })) : void 0
     }));
     const entityIndex = new Map(mergedEntities.map((entity, index) => [normalizeEntityKey(entity), index]));
     for (const entity of proactive.entities) {
@@ -490,6 +508,12 @@ var ExtractionEngine = class {
       if (typeof existingIndex === "number") {
         const existing = mergedEntities[existingIndex];
         const nextFacts = new Set(existing.facts.map((fact) => fact.trim()));
+        const nextSections = new Map(
+          (existing.structuredSections ?? []).map((section) => [section.key, {
+            ...section,
+            facts: [...section.facts]
+          }])
+        );
         let changed = false;
         for (const fact of entity.facts) {
           const trimmed = fact.trim();
@@ -497,10 +521,31 @@ var ExtractionEngine = class {
           nextFacts.add(trimmed);
           changed = true;
         }
+        for (const section of entity.structuredSections ?? []) {
+          const existingSection = nextSections.get(section.key);
+          if (!existingSection) {
+            nextSections.set(section.key, {
+              key: section.key,
+              title: section.title,
+              facts: [...section.facts]
+            });
+            changed = true;
+            continue;
+          }
+          const nextSectionFacts = new Set(existingSection.facts.map((fact) => fact.trim()));
+          for (const fact of section.facts) {
+            const trimmed = fact.trim();
+            if (!trimmed || nextSectionFacts.has(trimmed)) continue;
+            nextSectionFacts.add(trimmed);
+            changed = true;
+          }
+          existingSection.facts = Array.from(nextSectionFacts);
+        }
         if (changed) {
           mergedEntities[existingIndex] = {
             ...existing,
             facts: Array.from(nextFacts),
+            structuredSections: Array.from(nextSections.values()),
             source: "proactive",
             promptedByQuestion: existing.promptedByQuestion ?? entity.promptedByQuestion
           };
@@ -508,7 +553,14 @@ var ExtractionEngine = class {
         }
         continue;
       }
-      mergedEntities.push({ ...entity, source: "proactive" });
+      mergedEntities.push({
+        ...entity,
+        source: "proactive",
+        structuredSections: entity.structuredSections ? entity.structuredSections.map((section) => ({
+          ...section,
+          facts: [...section.facts]
+        })) : void 0
+      });
       entityIndex.set(key, mergedEntities.length - 1);
       remainingBudget -= 1;
     }
@@ -777,6 +829,8 @@ Memory categories \u2014 use the MOST SPECIFIC category that fits:
 - commitment: Promises, obligations, deadlines
 - moment: Emotionally significant events
 - skill: Demonstrated capabilities
+- rule: Explicit operational rules or constraints
+- procedure: Repeatable workflows \u2014 use when the user describes a multi-step play (\u22652 ordered steps). Put the human-readable trigger/context in "content" (e.g. "When you deploy\u2026") and list steps in "procedureSteps" as [{"order":1,"intent":"\u2026"}, \u2026] mirroring the gateway extraction schema.
 
 IMPORTANT: Do NOT label everything as "fact". Use "decision" for architectural choices, "commitment" for deadlines/promises, "principle" for reusable rules, "correction" for when the user rejects a suggestion, etc.
 
@@ -834,11 +888,12 @@ Also generate:
 1. 1-3 genuine questions you're curious about from this conversation
 2. Profile updates about user patterns/behaviors (if any)
 3. Relationships between entities (max 5). Use normalized names like "person-jane-doe", "company-acme-corp".
+4. For entity facts that fit a durable named heading, include entity.structuredSections with {key, title, facts}.
 
 Output JSON:
 {
-  "facts": [{"category": "decision", "content": "Chose PostgreSQL over MongoDB for the user service", "importance": 8, "confidence": 0.9, "structuredAttributes": {"chosen": "PostgreSQL", "rejected": "MongoDB"}}, {"category": "commitment", "content": "Must ship v2.0 API by end of March", "importance": 10, "confidence": 1.0, "structuredAttributes": {"deadline": "end of March", "deliverable": "v2.0 API"}}, {"category": "fact", "content": "The store backend uses Redis for session caching", "importance": 6, "confidence": 0.95, "entityRef": "project-acme-store"}, {"category": "principle", "content": "Always run migrations in a transaction to avoid partial schema updates", "importance": 8, "confidence": 0.9}],
-  "entities": [{"name": "person-jane-doe", "type": "person", "facts": ["Works at Acme Corp", "Prefers Python over JavaScript"]}, {"name": "project-acme-store", "type": "project", "facts": ["Built with Next.js", "Deployed on Vercel"]}],
+  "facts": [{"category": "decision", "content": "Chose PostgreSQL over MongoDB for the user service", "importance": 8, "confidence": 0.9, "structuredAttributes": {"chosen": "PostgreSQL", "rejected": "MongoDB"}}, {"category": "procedure", "content": "When you cut a hotfix release, follow the checklist", "importance": 8, "confidence": 0.9, "procedureSteps": [{"order": 1, "intent": "Branch from main and cherry-pick the fix"}, {"order": 2, "intent": "Run CI and tag the release"}]}, {"category": "commitment", "content": "Must ship v2.0 API by end of March", "importance": 10, "confidence": 1.0, "structuredAttributes": {"deadline": "end of March", "deliverable": "v2.0 API"}}, {"category": "fact", "content": "The store backend uses Redis for session caching", "importance": 6, "confidence": 0.95, "entityRef": "project-acme-store"}, {"category": "principle", "content": "Always run migrations in a transaction to avoid partial schema updates", "importance": 8, "confidence": 0.9}],
+  "entities": [{"name": "person-jane-doe", "type": "person", "facts": ["Works at Acme Corp", "Prefers Python over JavaScript"], "structuredSections": [{"key": "beliefs", "title": "Beliefs", "facts": ["Python is a better fit than JavaScript for backend work."]}]}, {"name": "project-acme-store", "type": "project", "facts": ["Built with Next.js", "Deployed on Vercel"]}],
   "profileUpdates": ["User prefers dark mode in all editors"],
   "questions": [{"question": "Which cloud provider hosts the staging environment?", "context": "Came up during deployment discussion", "priority": 0.5}],
   "relationships": [{"source": "person-jane-doe", "target": "company-acme-corp", "label": "works at"}]
@@ -915,7 +970,7 @@ ${truncatedConversation}`;
 Respond with valid JSON matching this schema:
 {
   "facts": [{"category": "decision", "content": "Chose React over Vue for the dashboard rewrite", "importance": 8, "confidence": 0.9, "tags": ["frontend"], "structuredAttributes": {"chosen": "React", "rejected": "Vue"}}, {"category": "fact", "content": "The API gateway uses rate limiting at 1000 req/min", "importance": 6, "confidence": 0.95, "tags": ["infra"], "entityRef": "project-dashboard", "structuredAttributes": {"rate_limit": "1000 req/min"}}],
-  "entities": [{"name": "person-sarah-chen", "type": "person", "facts": ["Leads the backend team", "Joined from Google in 2024"]}, {"name": "project-dashboard", "type": "project", "facts": ["React-based admin panel", "Deployed on AWS ECS"]}],
+  "entities": [{"name": "person-sarah-chen", "type": "person", "facts": ["Leads the backend team", "Joined from Google in 2024"], "structuredSections": [{"key": "beliefs", "title": "Beliefs", "facts": ["Small teams should own whole systems."]}]}, {"name": "project-dashboard", "type": "project", "facts": ["React-based admin panel", "Deployed on AWS ECS"]}],
   "profileUpdates": ["User prefers TypeScript over plain JavaScript"],
   "questions": [{"question": "What database does the analytics service use?", "context": "Came up during discussion of migration plan", "priority": 0.5}],
   "relationships": [{"source": "person-sarah-chen", "target": "project-dashboard", "label": "leads development of"}]
@@ -958,7 +1013,9 @@ Respond with valid JSON matching this schema:
       "principle",
       "commitment",
       "moment",
-      "skill"
+      "skill",
+      "rule",
+      "procedure"
     ]);
     const allowedEntityTypes = /* @__PURE__ */ new Set([
       "person",
@@ -1015,6 +1072,7 @@ Memory categories:
 - moment: Emotionally significant events or milestones (e.g., "first successful deployment of engram")
 - skill: Capabilities the user or agent has demonstrated (e.g., "user is proficient with Kubernetes")${this.config.causalRuleExtractionEnabled ? `
 - rule: Causal rules discovered through experience (format: "IF <condition> THEN <action/outcome>", e.g., "IF Shopify API returns 401 THEN the admin token is missing read_products scope")` : ""}
+- procedure: A reusable workflow the user wants remembered the same way across sessions. Set category to "procedure". Use "content" for a short title that includes explicit trigger phrasing (e.g. "When you deploy to production\u2026", "Whenever you ship a release\u2026"). Add "procedureSteps": an array of at least two objects {"order": number, "intent": "concrete step description"} in execution order. Optional per-step "toolCall": {"kind": "\u2026", "signature": "\u2026"}, "expectedOutcome", "optional": true.
 
 Rules:
 - Only extract genuinely NEW information worth remembering across sessions
@@ -1025,6 +1083,7 @@ Rules:
 - Entity references should use normalized names (lowercase, hyphenated: "jane-doe", "acme-corp")
 - CRITICAL: Entity names must be CANONICAL. Always use the hyphenated multi-word form: "acme-corp" NOT "acmecorp" or "acme". "jane-doe" NOT "janedoe" or "jane". If unsure, prefer the most specific full name.
 - Avoid creating entities typed as "other" when a more specific type fits (company, project, tool, person, place)
+- When entity facts clearly belong under a durable named heading, add them to entity.structuredSections as {key, title, facts}. Example person headings: "Beliefs", "Communication Style", "Building / Working On". Leave structuredSections empty when no stable heading fits.
 - Tags should be concise and reusable (e.g., "coding-style", "personal", "tools")
 - When a fact contains measurable, categorical, or precisely valued data, include a "structuredAttributes" field with key-value string pairs (e.g., {"price": "29.99", "brand": "Sony"}, {"date": "2024-03-15", "location": "SF"}, {"chosen": "PostgreSQL", "rejected": "MongoDB"}). Only for concrete values, not narrative content.
 - Set confidence using these tiers:
@@ -1134,10 +1193,7 @@ Consolidate the new memories against existing ones.`
     );
     if (fallbackResult) {
       log.debug(`consolidation: ${fallbackResult.items.length} decisions via fallback`);
-      const normalizedEntityUpdates = fallbackResult.entityUpdates.map((entity) => ({
-        ...entity,
-        promptedByQuestion: typeof entity.promptedByQuestion === "string" ? entity.promptedByQuestion : void 0
-      }));
+      const normalizedEntityUpdates = fallbackResult.entityUpdates.map((entity) => this.normalizeEntityUpdate(entity));
       return this.sanitizeConsolidationResult({
         items: fallbackResult.items.map((item) => ({
           ...item,
@@ -1235,11 +1291,7 @@ Respond with valid JSON only, matching this schema:
             reason: typeof item?.reason === "string" ? item.reason : ""
           };
         }).filter((item) => item.existingId.length > 0);
-        const normalizedEntityUpdates = Array.isArray(parsed.entityUpdates) ? parsed.entityUpdates.map((entity) => ({
-          name: typeof entity?.name === "string" ? entity.name : "",
-          type: typeof entity?.type === "string" ? entity.type : "other",
-          facts: Array.isArray(entity?.facts) ? entity.facts.filter((fact) => typeof fact === "string") : []
-        })).filter((entity) => entity.name.length > 0) : [];
+        const normalizedEntityUpdates = Array.isArray(parsed.entityUpdates) ? parsed.entityUpdates.map((entity) => this.normalizeEntityUpdate(entity)).filter((entity) => entity.name.length > 0) : [];
         log.debug(
           `consolidation: ${normalizedItems.length} decisions`
         );
@@ -1969,9 +2021,16 @@ Respond with valid JSON matching this schema:
     const memoryContext = formatDaySummaryMemories(memories);
     if (memoryContext.length === 0) return null;
     const systemPrompt = await loadDaySummaryPrompt();
+    let extensionsFooter = "";
+    try {
+      extensionsFooter = await buildExtensionsFooterForSummary(this.config);
+    } catch {
+    }
     const userPrompt = `Generate an end-of-day summary from this Remnic memory context:
 
-${memoryContext}`;
+${memoryContext}${extensionsFooter.length > 0 ? `
+
+${extensionsFooter}` : ""}`;
     const traceId = crypto.randomUUID();
     const startedAt = Date.now();
     this.emit({ kind: "llm_start", traceId, model: this.config.model, operation: "day_summary", input: memoryContext.slice(0, 4e3) });
@@ -2165,4 +2224,4 @@ ${memoryList}` }
 export {
   ExtractionEngine
 };
-//# sourceMappingURL=chunk-6UJQNRIO.js.map
+//# sourceMappingURL=chunk-3SV6CQHO.js.map