@remnic/core 1.1.12 → 1.1.14

package/dist/chunk-BFBF3XEF.js

@@ -0,0 +1,283 @@
+// src/maintenance/memory-governance-cron.ts
+import { mkdir, readFile, rename, rm, stat, writeFile } from "fs/promises";
+import path from "path";
+var DAY_SUMMARY_CRON_ID = "engram-day-summary";
+var GOVERNANCE_CRON_ID = "engram-nightly-governance";
+var PROCEDURAL_MINING_CRON_ID = "engram-procedural-mining";
+var CONTRADICTION_SCAN_CRON_ID = "engram-contradiction-scan";
+var PATTERN_REINFORCEMENT_CRON_ID = "engram-pattern-reinforcement";
+var GRAPH_EDGE_DECAY_CRON_ID = "engram-graph-edge-decay";
+async function acquireCronJobsLock(jobsPath) {
+  const lockPath = `${jobsPath}.lock`;
+  const start = Date.now();
+  const staleMs = 3e4;
+  const timeoutMs = 5e3;
+  await mkdir(path.dirname(lockPath), { recursive: true });
+  while (Date.now() - start < timeoutMs) {
+    try {
+      await mkdir(lockPath);
+      return async () => {
+        try {
+          await rm(lockPath, { recursive: true, force: true });
+        } catch {
+        }
+      };
+    } catch (error) {
+      const code = error.code;
+      if (code !== "EEXIST") {
+        throw error;
+      }
+      try {
+        const lockStat = await stat(lockPath);
+        if (Date.now() - lockStat.mtimeMs > staleMs) {
+          await rm(lockPath, { recursive: true, force: true });
+          continue;
+        }
+      } catch {
+      }
+      await new Promise((resolve) => setTimeout(resolve, 25));
+    }
+  }
+  throw new Error(`cron jobs lock acquisition timed out after ${timeoutMs}ms`);
+}
+function parseCronJobsShape(raw) {
+  const parsed = JSON.parse(raw);
+  const jobs = Array.isArray(parsed) ? parsed : Array.isArray(parsed.jobs) ? parsed.jobs : null;
+  if (!jobs) {
+    throw new Error("jobs.json has unexpected structure");
+  }
+  return { parsed, jobs };
+}
+async function writeCronJobsAtomic(jobsPath, value) {
+  const tempPath = `${jobsPath}.${process.pid}.${Date.now()}.tmp`;
+  await writeFile(tempPath, JSON.stringify(value, null, 2) + "\n", "utf-8");
+  await rename(tempPath, jobsPath);
+}
+async function ensureCronJob(jobsPath, jobId, buildJob, options = {}) {
+  const releaseLock = await acquireCronJobsLock(jobsPath);
+  try {
+    const raw = await readFile(jobsPath, "utf-8");
+    const { parsed, jobs } = parseCronJobsShape(raw);
+    const existingIndex = jobs.findIndex((job) => job.id === jobId);
+    if (existingIndex >= 0) {
+      if (!options.updateExisting) {
+        return { created: false, updated: false, jobId };
+      }
+      const desired = buildJob();
+      const existing = jobs[existingIndex];
+      const next = mergeCronJobUpdate(existing, desired, options.updateFields);
+      if (stableJson(existing) === stableJson(next)) {
+        return { created: false, updated: false, jobId };
+      }
+      jobs[existingIndex] = next;
+      const output2 = Array.isArray(parsed) ? jobs : { ...parsed, jobs };
+      await writeCronJobsAtomic(jobsPath, output2);
+      return { created: false, updated: true, jobId };
+    }
+    jobs.push(buildJob());
+    const output = Array.isArray(parsed) ? jobs : { ...parsed, jobs };
+    await writeCronJobsAtomic(jobsPath, output);
+    return { created: true, updated: false, jobId };
+  } finally {
+    await releaseLock();
+  }
+}
+function mergeCronJobUpdate(existing, desired, updateFields) {
+  if (!updateFields) {
+    return desired;
+  }
+  const next = { ...existing };
+  for (const field of updateFields) {
+    if (Object.prototype.hasOwnProperty.call(desired, field)) {
+      next[field] = desired[field];
+    } else {
+      delete next[field];
+    }
+  }
+  return next;
+}
+function stableJson(value) {
+  if (Array.isArray(value)) {
+    return `[${value.map((item) => stableJson(item)).join(",")}]`;
+  }
+  if (value && typeof value === "object") {
+    const record = value;
+    return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`).join(",")}}`;
+  }
+  return JSON.stringify(value);
+}
+async function ensureDaySummaryCron(jobsPath, options) {
+  const agentId = typeof options.agentId === "string" && options.agentId.trim().length > 0 ? options.agentId.trim() : "main";
+  return ensureCronJob(jobsPath, DAY_SUMMARY_CRON_ID, () => ({
+    id: DAY_SUMMARY_CRON_ID,
+    agentId,
+    name: "Remnic Day Summary (auto)",
+    enabled: true,
+    schedule: {
+      kind: "cron",
+      expr: "47 23 * * *",
+      tz: options.timezone
+    },
+    sessionTarget: "isolated",
+    wakeMode: "now",
+    payload: {
+      kind: "agentTurn",
+      timeoutSeconds: 900,
+      thinking: "off",
+      message: "You are OpenClaw automation. Call tool engram.day_summary with empty params (it will auto-gather today's facts). If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool."
+    },
+    delivery: { mode: "none" }
+  }));
+}
+async function ensureNightlyGovernanceCron(jobsPath, options) {
+  const recentDays = typeof options.recentDays === "number" && Number.isFinite(options.recentDays) ? Math.max(1, Math.floor(options.recentDays)) : 2;
+  const maxMemories = typeof options.maxMemories === "number" && Number.isFinite(options.maxMemories) ? Math.max(1, Math.floor(options.maxMemories)) : 500;
+  const batchSize = typeof options.batchSize === "number" && Number.isFinite(options.batchSize) ? Math.max(1, Math.floor(options.batchSize)) : 100;
+  const scheduleExpr = typeof options.scheduleExpr === "string" && options.scheduleExpr.trim().length > 0 ? options.scheduleExpr.trim() : "23 2 * * *";
+  const agentId = typeof options.agentId === "string" && options.agentId.trim().length > 0 ? options.agentId.trim() : "main";
+  return ensureCronJob(jobsPath, GOVERNANCE_CRON_ID, () => ({
+    id: GOVERNANCE_CRON_ID,
+    agentId,
+    name: "Remnic Nightly Governance (batched)",
+    enabled: true,
+    schedule: {
+      kind: "cron",
+      expr: scheduleExpr,
+      tz: options.timezone
+    },
+    sessionTarget: "isolated",
+    wakeMode: "now",
+    payload: {
+      kind: "agentTurn",
+      timeoutSeconds: 900,
+      thinking: "off",
+      message: `You are OpenClaw automation. Call the tool \`engram.memory_governance_run\` with params {"mode": "apply", "recentDays": ${recentDays}, "maxMemories": ${maxMemories}, "batchSize": ${batchSize}}. If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.`
+    },
+    delivery: { mode: "none" }
+  }));
+}
+async function ensureProceduralMiningCron(jobsPath, options) {
+  const scheduleExpr = typeof options.scheduleExpr === "string" && options.scheduleExpr.trim().length > 0 ? options.scheduleExpr.trim() : "17 3 * * *";
+  const agentId = typeof options.agentId === "string" && options.agentId.trim().length > 0 ? options.agentId.trim() : "main";
+  return ensureCronJob(jobsPath, PROCEDURAL_MINING_CRON_ID, () => ({
+    id: PROCEDURAL_MINING_CRON_ID,
+    agentId,
+    name: "Remnic Procedural Mining (nightly)",
+    enabled: true,
+    schedule: {
+      kind: "cron",
+      expr: scheduleExpr,
+      tz: options.timezone
+    },
+    sessionTarget: "isolated",
+    wakeMode: "now",
+    payload: {
+      kind: "agentTurn",
+      timeoutSeconds: 900,
+      thinking: "off",
+      message: "You are OpenClaw automation. Call tool `engram.procedure_mining_run` with empty params. If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool."
+    },
+    delivery: { mode: "none" }
+  }));
+}
+async function ensureContradictionScanCron(jobsPath, options) {
+  const scheduleExpr = typeof options.scheduleExpr === "string" && options.scheduleExpr.trim().length > 0 ? options.scheduleExpr.trim() : "37 3 * * *";
+  const agentId = typeof options.agentId === "string" && options.agentId.trim().length > 0 ? options.agentId.trim() : "main";
+  return ensureCronJob(jobsPath, CONTRADICTION_SCAN_CRON_ID, () => ({
+    id: CONTRADICTION_SCAN_CRON_ID,
+    agentId,
+    name: "Remnic Contradiction Scan (nightly)",
+    enabled: true,
+    schedule: {
+      kind: "cron",
+      expr: scheduleExpr,
+      tz: options.timezone
+    },
+    sessionTarget: "isolated",
+    wakeMode: "now",
+    payload: {
+      kind: "agentTurn",
+      timeoutSeconds: 900,
+      thinking: "off",
+      message: "You are OpenClaw automation. Call tool `engram.contradiction_scan_run` with empty params. If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool."
+    },
+    delivery: { mode: "none" }
+  }));
+}
+async function ensurePatternReinforcementCron(jobsPath, options) {
+  const scheduleExpr = typeof options.scheduleExpr === "string" && options.scheduleExpr.trim().length > 0 ? options.scheduleExpr.trim() : "53 4 * * 0";
+  const agentId = typeof options.agentId === "string" && options.agentId.trim().length > 0 ? options.agentId.trim() : "main";
+  return ensureCronJob(jobsPath, PATTERN_REINFORCEMENT_CRON_ID, () => ({
+    id: PATTERN_REINFORCEMENT_CRON_ID,
+    agentId,
+    name: "Remnic Pattern Reinforcement (weekly)",
+    enabled: true,
+    schedule: {
+      kind: "cron",
+      expr: scheduleExpr,
+      tz: options.timezone
+    },
+    sessionTarget: "isolated",
+    wakeMode: "now",
+    payload: {
+      kind: "agentTurn",
+      timeoutSeconds: 900,
+      thinking: "off",
+      message: "You are OpenClaw automation. Call tool `engram.pattern_reinforcement_run` with empty params. If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool."
+    },
+    delivery: { mode: "none" }
+  }));
+}
+async function ensureGraphEdgeDecayCron(jobsPath, options) {
+  const scheduleExpr = typeof options.scheduleExpr === "string" && options.scheduleExpr.trim().length > 0 ? options.scheduleExpr.trim() : "13 4 * * 0";
+  const agentId = typeof options.agentId === "string" && options.agentId.trim().length > 0 ? options.agentId.trim() : "main";
+  const scheduleLabel = graphEdgeDecayScheduleLabel(scheduleExpr);
+  return ensureCronJob(jobsPath, GRAPH_EDGE_DECAY_CRON_ID, () => ({
+    id: GRAPH_EDGE_DECAY_CRON_ID,
+    agentId,
+    // Schedule label reflects the actual cron expression (`daily` /
+    // `weekly` / `custom`) so cron dashboards do not show "weekly"
+    // when the schedule is in fact daily — Cursor review on PR #729.
+    name: `Remnic Graph Edge Decay (${scheduleLabel})`,
+    enabled: true,
+    schedule: {
+      kind: "cron",
+      expr: scheduleExpr,
+      tz: options.timezone
+    },
+    sessionTarget: "isolated",
+    wakeMode: "now",
+    payload: {
+      kind: "agentTurn",
+      timeoutSeconds: 900,
+      thinking: "off",
+      message: "You are OpenClaw automation. Call tool `engram.graph_edge_decay_run` with empty params. If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool."
+    },
+    delivery: { mode: "none" }
+  }));
+}
+function graphEdgeDecayCadenceToCronExpr(cadenceMs) {
+  if (!Number.isFinite(cadenceMs) || cadenceMs <= 0) {
+    return "13 4 * * 0";
+  }
+  const day = 24 * 60 * 60 * 1e3;
+  if (cadenceMs < 7 * day) return "13 4 * * *";
+  return "13 4 * * 0";
+}
+function graphEdgeDecayScheduleLabel(scheduleExpr) {
+  if (scheduleExpr === "13 4 * * *") return "daily";
+  if (scheduleExpr === "13 4 * * 0") return "weekly";
+  return "custom";
+}
+
+export {
+  ensureCronJob,
+  ensureDaySummaryCron,
+  ensureNightlyGovernanceCron,
+  ensureProceduralMiningCron,
+  ensureContradictionScanCron,
+  ensurePatternReinforcementCron,
+  ensureGraphEdgeDecayCron,
+  graphEdgeDecayCadenceToCronExpr
+};
+//# sourceMappingURL=chunk-BFBF3XEF.js.map

package/dist/chunk-BFBF3XEF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/maintenance/memory-governance-cron.ts"],"sourcesContent":["import { mkdir, readFile, rename, rm, stat, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nconst DAY_SUMMARY_CRON_ID = \"engram-day-summary\";\nconst GOVERNANCE_CRON_ID = \"engram-nightly-governance\";\nconst PROCEDURAL_MINING_CRON_ID = \"engram-procedural-mining\";\nconst CONTRADICTION_SCAN_CRON_ID = \"engram-contradiction-scan\";\nconst PATTERN_REINFORCEMENT_CRON_ID = \"engram-pattern-reinforcement\";\nconst GRAPH_EDGE_DECAY_CRON_ID = \"engram-graph-edge-decay\";\n\ntype CronJobsShape =\n  | Array<Record<string, unknown>>\n  | {\n      jobs: Array<Record<string, unknown>>;\n      [key: string]: unknown;\n    };\n\nasync function acquireCronJobsLock(jobsPath: string): Promise<() => Promise<void>> {\n  const lockPath = `${jobsPath}.lock`;\n  const start = Date.now();\n  const staleMs = 30_000;\n  const timeoutMs = 5_000;\n  await mkdir(path.dirname(lockPath), { recursive: true });\n\n  while (Date.now() - start < timeoutMs) {\n    try {\n      await mkdir(lockPath);\n      return async () => {\n        try {\n          await rm(lockPath, { recursive: true, force: true });\n        } catch {\n          // Lock cleanup should not fail cron registration.\n        }\n      };\n    } catch (error) {\n      const code = (error as NodeJS.ErrnoException).code;\n      if (code !== \"EEXIST\") {\n        throw error;\n      }\n      try {\n        const lockStat = await stat(lockPath);\n        if (Date.now() - lockStat.mtimeMs > staleMs) {\n          await rm(lockPath, { recursive: true, force: true });\n          continue;\n        }\n      } catch {\n        // Lock may have been released between stat/rm attempts.\n      }\n      await new Promise((resolve) => setTimeout(resolve, 25));\n    }\n  }\n\n  throw new Error(`cron jobs lock acquisition timed out after ${timeoutMs}ms`);\n}\n\nfunction parseCronJobsShape(raw: string): { parsed: CronJobsShape; jobs: Array<Record<string, unknown>> } {\n  const parsed = JSON.parse(raw) as CronJobsShape;\n  const jobs = Array.isArray(parsed) ? parsed : Array.isArray(parsed.jobs) ? parsed.jobs : null;\n  if (!jobs) {\n    throw new Error(\"jobs.json has unexpected structure\");\n  }\n  return { parsed, jobs };\n}\n\nasync function writeCronJobsAtomic(jobsPath: string, value: CronJobsShape): Promise<void> {\n  const tempPath = `${jobsPath}.${process.pid}.${Date.now()}.tmp`;\n  await writeFile(tempPath, JSON.stringify(value, null, 2) + \"\\n\", \"utf-8\");\n  await rename(tempPath, jobsPath);\n}\n\nexport async function ensureCronJob(\n  jobsPath: string,\n  jobId: string,\n  buildJob: () => Record<string, unknown>,\n  options: { updateExisting?: boolean; updateFields?: string[] } = {},\n): Promise<{ created: boolean; updated: boolean; jobId: string }> {\n  const releaseLock = await acquireCronJobsLock(jobsPath);\n  try {\n    const raw = await readFile(jobsPath, \"utf-8\");\n    const { parsed, jobs } = parseCronJobsShape(raw);\n\n    const existingIndex = jobs.findIndex((job) => job.id === jobId);\n    if (existingIndex >= 0) {\n      if (!options.updateExisting) {\n        return { created: false, updated: false, jobId };\n      }\n\n      const desired = buildJob();\n      const existing = jobs[existingIndex];\n      const next = mergeCronJobUpdate(existing, desired, options.updateFields);\n      if (stableJson(existing) === stableJson(next)) {\n        return { created: false, updated: false, jobId };\n      }\n\n      jobs[existingIndex] = next;\n      const output = Array.isArray(parsed) ? jobs : { ...parsed, jobs };\n      await writeCronJobsAtomic(jobsPath, output);\n      return { created: false, updated: true, jobId };\n    }\n\n    jobs.push(buildJob());\n    const output = Array.isArray(parsed) ? jobs : { ...parsed, jobs };\n    await writeCronJobsAtomic(jobsPath, output);\n    return { created: true, updated: false, jobId };\n  } finally {\n    await releaseLock();\n  }\n}\n\nfunction mergeCronJobUpdate(\n  existing: Record<string, unknown>,\n  desired: Record<string, unknown>,\n  updateFields?: string[],\n): Record<string, unknown> {\n  if (!updateFields) {\n    return desired;\n  }\n\n  const next = { ...existing };\n  for (const field of updateFields) {\n    if (Object.prototype.hasOwnProperty.call(desired, field)) {\n      next[field] = desired[field];\n    } else {\n      delete next[field];\n    }\n  }\n  return next;\n}\n\nfunction stableJson(value: unknown): string {\n  if (Array.isArray(value)) {\n    return `[${value.map((item) => stableJson(item)).join(\",\")}]`;\n  }\n  if (value && typeof value === \"object\") {\n    const record = value as Record<string, unknown>;\n    return `{${Object.keys(record)\n      .sort()\n      .map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`)\n      .join(\",\")}}`;\n  }\n  return JSON.stringify(value);\n}\n\nexport async function ensureDaySummaryCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, DAY_SUMMARY_CRON_ID, () => ({\n    id: DAY_SUMMARY_CRON_ID,\n    agentId,\n    name: \"Remnic Day Summary (auto)\",\n    enabled: true,\n    schedule: {\n      kind: \"cron\",\n      expr: \"47 23 * * *\",\n      tz: options.timezone,\n    },\n    sessionTarget: \"isolated\",\n    wakeMode: \"now\",\n    payload: {\n      kind: \"agentTurn\",\n      timeoutSeconds: 900,\n      thinking: \"off\",\n      message:\n        \"You are OpenClaw automation. Call tool engram.day_summary with empty params (it will auto-gather today's facts). If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n    },\n    delivery: { mode: \"none\" },\n  }));\n}\n\nexport async function ensureNightlyGovernanceCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    recentDays?: number;\n    maxMemories?: number;\n    batchSize?: number;\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const recentDays =\n    typeof options.recentDays === \"number\" && Number.isFinite(options.recentDays)\n      ? Math.max(1, Math.floor(options.recentDays))\n      : 2;\n  const maxMemories =\n    typeof options.maxMemories === \"number\" && Number.isFinite(options.maxMemories)\n      ? Math.max(1, Math.floor(options.maxMemories))\n      : 500;\n  const batchSize =\n    typeof options.batchSize === \"number\" && Number.isFinite(options.batchSize)\n      ? Math.max(1, Math.floor(options.batchSize))\n      : 100;\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"23 2 * * *\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, GOVERNANCE_CRON_ID, () => ({\n      id: GOVERNANCE_CRON_ID,\n      agentId,\n      name: \"Remnic Nightly Governance (batched)\",\n      enabled: true,\n      schedule: {\n        kind: \"cron\",\n        expr: scheduleExpr,\n        tz: options.timezone,\n      },\n      sessionTarget: \"isolated\",\n      wakeMode: \"now\",\n      payload: {\n        kind: \"agentTurn\",\n        timeoutSeconds: 900,\n        thinking: \"off\",\n        message:\n          \"You are OpenClaw automation. Call the tool `engram.memory_governance_run` with params \" +\n          `{\"mode\": \"apply\", \"recentDays\": ${recentDays}, \"maxMemories\": ${maxMemories}, \"batchSize\": ${batchSize}}` +\n          \". If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n      },\n      delivery: { mode: \"none\" },\n    }));\n}\n\nexport async function ensureProceduralMiningCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"17 3 * * *\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, PROCEDURAL_MINING_CRON_ID, () => ({\n    id: PROCEDURAL_MINING_CRON_ID,\n    agentId,\n    name: \"Remnic Procedural Mining (nightly)\",\n    enabled: true,\n    schedule: {\n      kind: \"cron\",\n      expr: scheduleExpr,\n      tz: options.timezone,\n    },\n    sessionTarget: \"isolated\",\n    wakeMode: \"now\",\n    payload: {\n      kind: \"agentTurn\",\n      timeoutSeconds: 900,\n      thinking: \"off\",\n      message:\n        \"You are OpenClaw automation. Call tool `engram.procedure_mining_run` with empty params. \" +\n        \"If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n    },\n    delivery: { mode: \"none\" },\n  }));\n}\n\nexport async function ensureContradictionScanCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"37 3 * * *\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, CONTRADICTION_SCAN_CRON_ID, () => ({\n    id: CONTRADICTION_SCAN_CRON_ID,\n    agentId,\n    name: \"Remnic Contradiction Scan (nightly)\",\n    enabled: true,\n    schedule: {\n      kind: \"cron\",\n      expr: scheduleExpr,\n      tz: options.timezone,\n    },\n    sessionTarget: \"isolated\",\n    wakeMode: \"now\",\n    payload: {\n      kind: \"agentTurn\",\n      timeoutSeconds: 900,\n      thinking: \"off\",\n      message:\n        \"You are OpenClaw automation. Call tool `engram.contradiction_scan_run` with empty params. \" +\n        \"If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n    },\n    delivery: { mode: \"none\" },\n  }));\n}\n\nexport async function ensurePatternReinforcementCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    /**\n     * Cron expression. Default `\"53 4 * * 0\"` — Sunday 04:53 in the\n     * configured timezone, deliberately offset from sibling crons\n     * (`23 2 * * *`, `17 3 * * *`, `37 3 * * *`) so the maintenance\n     * passes don't pile up on the same minute.\n     */\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"53 4 * * 0\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  return ensureCronJob(jobsPath, PATTERN_REINFORCEMENT_CRON_ID, () => ({\n    id: PATTERN_REINFORCEMENT_CRON_ID,\n    agentId,\n    name: \"Remnic Pattern Reinforcement (weekly)\",\n    enabled: true,\n    schedule: {\n      kind: \"cron\",\n      expr: scheduleExpr,\n      tz: options.timezone,\n    },\n    sessionTarget: \"isolated\",\n    wakeMode: \"now\",\n    payload: {\n      kind: \"agentTurn\",\n      timeoutSeconds: 900,\n      thinking: \"off\",\n      message:\n        \"You are OpenClaw automation. Call tool `engram.pattern_reinforcement_run` with empty params. \" +\n        \"If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n    },\n    delivery: { mode: \"none\" },\n  }));\n}\n\n/**\n * Register a cron job that runs the graph-edge-decay maintenance pass\n * (issue #681 PR 2/3). Default schedule is weekly on Sunday 04:13 — the\n * cadence is configurable via `scheduleExpr`. Cadence is also expressible\n * in milliseconds via `Config.graphEdgeDecayCadenceMs`; the orchestrator\n * picks the right cron expression for sub-daily, daily, or weekly cadence.\n */\nexport async function ensureGraphEdgeDecayCron(\n  jobsPath: string,\n  options: {\n    timezone: string;\n    agentId?: string;\n    scheduleExpr?: string;\n  },\n): Promise<{ created: boolean; jobId: string }> {\n  const scheduleExpr =\n    typeof options.scheduleExpr === \"string\" && options.scheduleExpr.trim().length > 0\n      ? options.scheduleExpr.trim()\n      : \"13 4 * * 0\";\n  const agentId =\n    typeof options.agentId === \"string\" && options.agentId.trim().length > 0\n      ? options.agentId.trim()\n      : \"main\";\n\n  const scheduleLabel = graphEdgeDecayScheduleLabel(scheduleExpr);\n\n  return ensureCronJob(jobsPath, GRAPH_EDGE_DECAY_CRON_ID, () => ({\n    id: GRAPH_EDGE_DECAY_CRON_ID,\n    agentId,\n    // Schedule label reflects the actual cron expression (`daily` /\n    // `weekly` / `custom`) so cron dashboards do not show \"weekly\"\n    // when the schedule is in fact daily — Cursor review on PR #729.\n    name: `Remnic Graph Edge Decay (${scheduleLabel})`,\n    enabled: true,\n    schedule: {\n      kind: \"cron\",\n      expr: scheduleExpr,\n      tz: options.timezone,\n    },\n    sessionTarget: \"isolated\",\n    wakeMode: \"now\",\n    payload: {\n      kind: \"agentTurn\",\n      timeoutSeconds: 900,\n      thinking: \"off\",\n      message:\n        \"You are OpenClaw automation. Call tool `engram.graph_edge_decay_run` with empty params. \" +\n        \"If successful output exactly NO_REPLY. On error output one concise line. Do NOT use message tool.\",\n    },\n    delivery: { mode: \"none\" },\n  }));\n}\n\n/**\n * Pick a cron expression that approximates a cadence in milliseconds.\n *\n * - cadence < 7 days → daily at 04:13 (sub-daily cadence is not natively\n *   expressible in 5-field cron without `*\\/N` patterns; daily is the\n *   safe upper bound that won't trip the cron more often than requested).\n * - cadence ≥ 7 days → weekly on Sunday 04:13.\n *\n * Operators who need finer-grained control should set `scheduleExpr`\n * directly via `ensureGraphEdgeDecayCron`.\n */\nexport function graphEdgeDecayCadenceToCronExpr(cadenceMs: number): string {\n  if (!Number.isFinite(cadenceMs) || cadenceMs <= 0) {\n    return \"13 4 * * 0\";\n  }\n  const day = 24 * 60 * 60 * 1000;\n  if (cadenceMs < 7 * day) return \"13 4 * * *\";\n  return \"13 4 * * 0\";\n}\n\n/**\n * Derive a human-friendly schedule label (\"daily\" / \"weekly\" / \"custom\")\n * for the given cron expression. Used to keep the cron job name in\n * sync with the actual schedule (Cursor review on PR #729).\n */\nfunction graphEdgeDecayScheduleLabel(scheduleExpr: string): string {\n  if (scheduleExpr === \"13 4 * * *\") return \"daily\";\n  if (scheduleExpr === \"13 4 * * 0\") return \"weekly\";\n  return \"custom\";\n}\n"],"mappings":"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","names":["output"]}