openclaw-telegram-manager 2.6.3 → 2.8.0

package/dist/plugin.js

@@ -8815,7 +8815,7 @@ __export(value_exports2, {
 });
 
 // src/lib/types.ts
-var CURRENT_REGISTRY_VERSION = 5;
+var CURRENT_REGISTRY_VERSION = 6;
 var CAPSULE_VERSION = 3;
 var MAX_POST_ERROR_LENGTH = 500;
 var MAX_NAME_LENGTH = 100;
@@ -8855,6 +8855,7 @@ var TopicEntrySchema = Type.Object({
   snoozeUntil: Type.Union([Type.String(), Type.Null()]),
   consecutiveSilentDoctors: Type.Integer({ minimum: 0 }),
   lastPostError: Type.Union([Type.String({ maxLength: MAX_POST_ERROR_LENGTH }), Type.Null()]),
+  cronJobId: Type.Union([Type.String(), Type.Null()]),
   extras: Type.Record(Type.String(), Type.Unknown())
 });
 var RegistrySchema = Type.Object({
@@ -8942,6 +8943,17 @@ var migrations = {
       }
     }
     return data;
+  },
+  "5_to_6": (data) => {
+    const topics = data["topics"];
+    if (topics && typeof topics === "object" && !Array.isArray(topics)) {
+      for (const entry of Object.values(topics)) {
+        if (entry["cronJobId"] === void 0) {
+          entry["cronJobId"] = null;
+        }
+      }
+    }
+    return data;
   }
 };
 function migrateRegistry(data) {
@@ -9174,7 +9186,9 @@ _Build, deploy, test, and other commands for this topic. Kept here so they're no
 `,
   "LINKS.md": (name) => `# Links: ${name}
 
-_URLs, paths, and service endpoints for this topic._
+## Key paths & URLs
+
+_Not set yet \u2014 add repository paths, dashboards, service URLs, or anything the agent needs after a reset._
 `,
   "CRON.md": (name) => `# Cron: ${name}
 
@@ -9193,27 +9207,91 @@ _Agent prepends here automatically. Most recent entries first._
 var OVERLAY_TEMPLATES = {
   "ARCHITECTURE.md": (name) => `# Architecture: ${name}
 
-_Components, data flow, dependencies, and design decisions._
+## Components
+
+_None yet._
+
+## Data flow
+
+_None yet._
+
+## Key decisions
+
+_None yet._
 `,
   "DEPLOY.md": (name) => `# Deployment: ${name}
 
-_Environments, deployment steps, rollback procedures, and infra details._
+## Paths
+
+_Repository and runtime/data paths go here._
+
+## Environments
+
+_None yet._
+
+## Deploy steps
+
+_None yet._
+
+## Rollback
+
+_None yet._
 `,
   "SOURCES.md": (name) => `# Sources: ${name}
 
-_Papers, articles, datasets, APIs, and other reference material._
+## Papers & articles
+
+_None yet._
+
+## Datasets & APIs
+
+_None yet._
+
+## Other references
+
+_None yet._
 `,
   "FINDINGS.md": (name) => `# Findings: ${name}
 
-_Conclusions, insights, data summaries, and recommendations._
+## Key findings
+
+_None yet._
+
+## Evidence & data
+
+_None yet._
+
+## Recommendations
+
+_None yet._
 `,
   "CAMPAIGNS.md": (name) => `# Campaigns: ${name}
 
-_Active campaigns, target audiences, channels, timelines, and budgets._
+## Active campaigns
+
+_None yet._
+
+## Audiences & channels
+
+_None yet._
+
+## Timeline & budget
+
+_None yet._
 `,
   "METRICS.md": (name) => `# Metrics: ${name}
 
-_KPIs, conversion rates, engagement stats, and performance data._
+## KPIs & targets
+
+_None yet._
+
+## Tracking & dashboards
+
+_None yet._
+
+## Performance data
+
+_None yet._
 `
 };
 var CAPSULE_FILE_MODE = 416;
@@ -9341,39 +9419,22 @@ function checkAuthorization(userId, command, registry, topicAllowFrom) {
 
 // src/lib/telegram.ts
 var TELEGRAM_MSG_LIMIT = 4096;
-var HEALTH_LABELS = {
-  fresh: "\u2705 Active",
-  // green check
-  stale: "\u23F3 Inactive",
-  // hourglass
-  blocked: "\u26A0\uFE0F Blocked"
-  // warning
-};
 function buildDailyReport(data, format = "html") {
   const isHtml = format === "html";
   const esc = (s) => isHtml ? htmlEscape(s) : s;
   const bold = (s) => isHtml ? `<b>${s}</b>` : `**${s}**`;
   const n = esc(data.name);
-  const healthLabel = HEALTH_LABELS[data.health] ?? data.health;
   const lines = [
     bold(`Daily Report: ${n}`),
     "",
-    bold("Done today"),
+    bold("Done"),
     esc(data.doneContent),
     "",
-    bold("New learnings"),
-    esc(data.learningsContent),
-    "",
-    bold("Blockers/Risks"),
-    esc(data.blockersContent),
-    "",
-    bold("Next actions (now)"),
+    bold("Next"),
     esc(data.nextContent),
     "",
-    bold("Upcoming"),
-    esc(data.upcomingContent),
-    "",
-    `${bold("Health:")} ${healthLabel}`
+    bold("Blockers"),
+    esc(data.blockersContent)
   ];
   return truncateMessage(lines.join("\n"));
 }
@@ -9522,7 +9583,7 @@ function buildHelpCard() {
     "",
     "**Basics**",
     "/tm init \u2014 set up this topic",
-    "/tm status \u2014 see current progress",
+    "/tm status \u2014 see current progress (add --expanded for more detail)",
     "/tm list \u2014 all topics",
     "/tm help \u2014 this message",
     "",
@@ -9881,6 +9942,67 @@ async function getConfigWrites(rpc) {
   }
 }
 
+// src/lib/cron.ts
+var DEFAULT_CRON_SCHEDULE = "0 9 * * *";
+var DEFAULT_CRON_TZ = "UTC";
+async function registerDailyReportCron(rpc, params, logger) {
+  if (!rpc) {
+    return { jobId: null, error: "RPC not available" };
+  }
+  const { topicName, slug, groupId, threadId, schedule, tz } = params;
+  const cronExpr = schedule ?? DEFAULT_CRON_SCHEDULE;
+  const timezone = tz ?? DEFAULT_CRON_TZ;
+  const telegramTarget = `${groupId}:topic:${threadId}`;
+  try {
+    const result = await rpc.call("cron.add", {
+      name: `tm-daily-${slug}`,
+      schedule: {
+        kind: "cron",
+        expr: cronExpr,
+        tz: timezone
+      },
+      sessionTarget: "isolated",
+      wakeMode: "now",
+      payload: {
+        kind: "agentTurn",
+        message: `Run topic_manager with command "daily-report" for the topic "${topicName}" (slug: ${slug}, group: ${groupId}, thread: ${threadId}). Post the report to this topic.`
+      },
+      delivery: {
+        mode: "announce",
+        channels: {
+          telegram: {
+            to: telegramTarget
+          }
+        }
+      }
+    });
+    const jobId = result["jobId"] ?? result["id"] ?? null;
+    if (jobId) {
+      logger.info(`[cron] Created daily report job "${jobId}" for ${slug} (${cronExpr} ${timezone})`);
+      return { jobId };
+    }
+    return { jobId: null, error: "Gateway did not return a job ID" };
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    logger.error(`[cron] Failed to create daily report job for ${slug}: ${msg}`);
+    return { jobId: null, error: msg };
+  }
+}
+async function removeCronJob(rpc, jobId, logger) {
+  if (!rpc) {
+    return false;
+  }
+  try {
+    await rpc.call("cron.remove", { jobId });
+    logger.info(`[cron] Removed cron job "${jobId}"`);
+    return true;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    logger.error(`[cron] Failed to remove cron job "${jobId}": ${msg}`);
+    return false;
+  }
+}
+
 // src/commands/autopilot.ts
 import * as fs6 from "node:fs";
 import * as path6 from "node:path";
@@ -10085,6 +10207,7 @@ async function handleInit(ctx, args) {
         snoozeUntil: null,
         consecutiveSilentDoctors: 0,
         lastPostError: null,
+        cronJobId: null,
         extras: {}
       };
       data.topics[key] = newEntry;
@@ -10133,6 +10256,25 @@ async function handleInit(ctx, args) {
     restartMsg = `
 Warning: config sync failed: ${msg}`;
   }
+  try {
+    const cronResult = await registerDailyReportCron(rpc, {
+      topicName: name,
+      slug: finalSlug,
+      groupId,
+      threadId
+    }, logger);
+    if (cronResult.jobId) {
+      await withRegistry(workspaceDir, (data) => {
+        const entry = data.topics[key];
+        if (entry) {
+          entry.cronJobId = cronResult.jobId;
+        }
+      });
+    }
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    logger.error(`[init] Cron registration failed: ${msg}`);
+  }
   appendAudit(
     workspaceDir,
     buildAuditEntry(userId, "init", finalSlug, `Initialized topic name="${name}" type=${topicType} group=${groupId} thread=${threadId}`)
@@ -10543,10 +10685,26 @@ function runSpamControlCheck(entry) {
   }
   return results;
 }
+function runPostErrorCheck(entry) {
+  const results = [];
+  if (entry.lastPostError) {
+    results.push(
+      check(
+        Severity.WARN,
+        "lastPostFailed",
+        `Last report delivery failed: ${entry.lastPostError}`,
+        false,
+        "This will be retried on the next health check cycle"
+      )
+    );
+  }
+  return results;
+}
 function runAllChecksForTopic(entry, projectsBase, includeContent, registry, cronJobsPath) {
   const results = [];
   const capsuleDir = path8.join(projectsBase, entry.slug);
   results.push(...runRegistryChecks(entry, projectsBase));
+  results.push(...runPostErrorCheck(entry));
   if (!fs8.existsSync(capsuleDir)) return results;
   results.push(...runCapsuleChecks(entry, projectsBase));
   const capsuleFiles = readCapsuleFiles(capsuleDir);
@@ -10712,21 +10870,14 @@ async function handleDailyReport(ctx) {
   }
   const statusContent = readFileOrNull(path10.join(capsuleDir, "STATUS.md"));
   const todoContent = readFileOrNull(path10.join(capsuleDir, "TODO.md"));
-  const learningsContent = readFileOrNull(path10.join(capsuleDir, "LEARNINGS.md"));
   const doneContent = extractDoneSection(statusContent);
-  const newLearnings = extractTodayLearnings(learningsContent);
   const blockers = extractBlockers(todoContent);
   const nextContent = extractNextActions(statusContent);
-  const upcomingContent = extractUpcoming(statusContent);
-  const health = computeHealth(entry.lastMessageAt, statusContent, blockers);
   const reportData = {
     name: entry.name,
     doneContent,
-    learningsContent: newLearnings,
     blockersContent: blockers,
-    nextContent,
-    upcomingContent,
-    health
+    nextContent
   };
   if (ctx.postFn) {
     try {
@@ -10736,11 +10887,18 @@ async function handleDailyReport(ctx) {
         const e = data.topics[key];
         if (e) {
           e.lastDailyReportAt = (/* @__PURE__ */ new Date()).toISOString();
+          e.lastPostError = null;
         }
       });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       logger.error(`[daily-report] Post failed: ${msg}`);
+      await withRegistry(workspaceDir, (data) => {
+        const e = data.topics[key];
+        if (e) {
+          e.lastPostError = msg.slice(0, MAX_POST_ERROR_LENGTH);
+        }
+      });
       return { text: `Daily report generated but post failed: ${msg}` };
     }
   } else {
@@ -10767,26 +10925,6 @@ function extractDoneSection(statusContent) {
   const text = match[1]?.trim();
   return text || "Empty.";
 }
-function extractTodayLearnings(learningsContent) {
-  if (!learningsContent) return "No learnings recorded yet.";
-  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-  const lines = learningsContent.split("\n");
-  const todayLines = [];
-  let inTodaySection = false;
-  for (const line of lines) {
-    if (line.startsWith("## ") && line.includes(today)) {
-      inTodaySection = true;
-      continue;
-    }
-    if (inTodaySection && line.startsWith("## ")) {
-      break;
-    }
-    if (inTodaySection && line.trim()) {
-      todayLines.push(line);
-    }
-  }
-  return todayLines.length > 0 ? todayLines.join("\n") : "None today.";
-}
 function extractBlockers(todoContent) {
   if (!todoContent) return "No tasks recorded yet.";
   const lines = todoContent.split("\n");
@@ -10802,22 +10940,6 @@ function extractNextActions(statusContent) {
   const text = match[1]?.trim();
   return text || "None yet.";
 }
-function extractUpcoming(statusContent) {
-  if (!statusContent) return "No status available yet.";
-  const match = statusContent.match(/^##\s*Upcoming actions\s*\n([\s\S]*?)(?=\n##\s|\n*$)/im);
-  if (!match) return "None yet.";
-  const text = match[1]?.trim();
-  return text || "None yet.";
-}
-function computeHealth(lastMessageAt, statusContent, blockers) {
-  if (blockers && blockers !== "None." && blockers !== "No tasks recorded yet.") {
-    return "blocked";
-  }
-  if (!lastMessageAt) return "stale";
-  const hoursSinceActivity = (Date.now() - new Date(lastMessageAt).getTime()) / 36e5;
-  if (hoursSinceActivity > 72) return "stale";
-  return "fresh";
-}
 
 // src/commands/doctor-all.ts
 function getEligibility(entry, now, statusTimestamp) {
@@ -10863,9 +10985,6 @@ function buildDoctorAllSummary(data) {
     checkedTopics,
     skippedTopics,
     postFailures,
-    dailyReportsSent,
-    dailyReportsSkipped,
-    hasPostFn,
     migrationGroups,
     errors
   } = data;
@@ -10921,15 +11040,6 @@ function buildDoctorAllSummary(data) {
     lines.push("");
     lines.push(`\u26A0\uFE0F ${postFailures} topic(s) failed to post`);
   }
-  if (hasPostFn) {
-    const parts = [];
-    if (dailyReportsSent > 0) parts.push(`${dailyReportsSent} sent`);
-    if (dailyReportsSkipped > 0) parts.push(`${dailyReportsSkipped} skipped`);
-    if (parts.length > 0) {
-      lines.push("");
-      lines.push(`Daily reports: ${parts.join(", ")}`);
-    }
-  }
   if (migrationGroups > 0) {
     lines.push("");
     lines.push(`**Warning:** ${migrationGroups} group(s) had all topics fail. The group may have been migrated or deleted.`);
@@ -11082,54 +11192,6 @@ async function handleDoctorAll(ctx) {
       }
     }
   }
-  let dailyReportSuccesses = 0;
-  let dailyReportSkipped = 0;
-  const dailyReportKeys = /* @__PURE__ */ new Set();
-  if (ctx.postFn && reports.length > 0) {
-    const rateLimitedPost = createRateLimitedPoster(ctx.postFn);
-    const nowDate = now.toISOString().slice(0, 10);
-    for (const report of reports) {
-      const key = `${report.groupId}:${report.threadId}`;
-      const entry = registry.topics[key];
-      if (!entry) continue;
-      if (entry.lastDailyReportAt) {
-        const lastReport = new Date(entry.lastDailyReportAt);
-        const lastDate = `${lastReport.getUTCFullYear()}-${String(lastReport.getUTCMonth() + 1).padStart(2, "0")}-${String(lastReport.getUTCDate()).padStart(2, "0")}`;
-        if (lastDate === nowDate) {
-          dailyReportSkipped++;
-          continue;
-        }
-      }
-      const capsuleDir = path11.join(projectsBase, entry.slug);
-      const statusContent = readFileOrNull(path11.join(capsuleDir, "STATUS.md"));
-      const todoContent = readFileOrNull(path11.join(capsuleDir, "TODO.md"));
-      const learningsContent = readFileOrNull(path11.join(capsuleDir, "LEARNINGS.md"));
-      const doneContent = extractDoneSection(statusContent);
-      const newLearnings = extractTodayLearnings(learningsContent);
-      const blockers = extractBlockers(todoContent);
-      const nextContent = extractNextActions(statusContent);
-      const upcomingContent = extractUpcoming(statusContent);
-      const health = computeHealth(entry.lastMessageAt, statusContent, blockers);
-      const reportData = {
-        name: entry.name,
-        doneContent,
-        learningsContent: newLearnings,
-        blockersContent: blockers,
-        nextContent,
-        upcomingContent,
-        health
-      };
-      try {
-        const htmlReport = buildDailyReport(reportData, "html");
-        await rateLimitedPost(report.groupId, report.threadId, htmlReport);
-        dailyReportSuccesses++;
-        dailyReportKeys.add(key);
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        logger.error(`[doctor-all] Daily report post failed for ${entry.slug}: ${msg}`);
-      }
-    }
-  }
   await withRegistry(workspaceDir, (data) => {
     data.lastDoctorAllRunAt = now.toISOString();
     for (const [_key, entry] of Object.entries(data.topics)) {
@@ -11155,21 +11217,12 @@ async function handleDoctorAll(ctx) {
         entry.consecutiveSilentDoctors = 0;
       }
     }
-    for (const key of dailyReportKeys) {
-      const entry = data.topics[key];
-      if (entry) {
-        entry.lastDailyReportAt = now.toISOString();
-      }
-    }
   });
   return {
     text: buildDoctorAllSummary({
       checkedTopics,
       skippedTopics,
       postFailures,
-      dailyReportsSent: dailyReportSuccesses,
-      dailyReportsSkipped: dailyReportSkipped,
-      hasPostFn: !!ctx.postFn,
       migrationGroups: migrationGroups.length,
       errors
     })
@@ -11253,38 +11306,49 @@ function formatSection(raw) {
   if (isPlaceholder(raw)) return "_None yet._";
   return raw;
 }
-function formatStatus(name, content) {
-  const timestamp = extractTimestamp(content);
-  const nextRaw = extractSection(content, NEXT_ACTIONS_RE2);
-  const upcomingRaw = extractSection(content, UPCOMING_RE);
-  const doneMatch = content.match(LAST_DONE_RE2);
+function hasBlockers(blockers) {
+  return blockers !== "None." && blockers !== "No tasks recorded yet.";
+}
+function formatStatus(data) {
+  const { name, type, statusContent, todoContent, expanded } = data;
+  const timestamp = extractTimestamp(statusContent);
+  const nextRaw = extractSection(statusContent, NEXT_ACTIONS_RE2);
+  const blockers = extractBlockers(todoContent);
+  const doneMatch = statusContent.match(LAST_DONE_RE2);
   let lastDoneBody = "";
   if (doneMatch) {
     const section = doneMatch[1]?.trim() ?? "";
     lastDoneBody = section.replace(ISO_RE, "").trim();
   }
-  const lines = [
-    `**${name}**`,
-    ""
-  ];
+  const lines = [];
+  lines.push(`**${name}** \xB7 ${type}`);
   if (timestamp) {
     lines.push(`\u{1F552} **Last activity:** ${relativeTime(timestamp)}`);
   }
+  lines.push("");
   if (lastDoneBody && !isPlaceholder(lastDoneBody)) {
+    lines.push("\u2705 **Done recently**");
     lines.push(lastDoneBody);
+    lines.push("");
   }
-  lines.push("");
   lines.push("\u{1F3AF} **Next actions**");
   lines.push(formatSection(nextRaw));
-  const upcomingFormatted = formatSection(upcomingRaw);
-  if (upcomingFormatted !== "_None yet._") {
+  if (hasBlockers(blockers)) {
     lines.push("");
-    lines.push("\u{1F4C5} **Upcoming**");
-    lines.push(upcomingFormatted);
+    lines.push("\u26A0\uFE0F **Blockers**");
+    lines.push(blockers);
+  }
+  if (expanded) {
+    const upcomingRaw = extractSection(statusContent, UPCOMING_RE);
+    if (!isPlaceholder(upcomingRaw)) {
+      lines.push("");
+      lines.push("\u{1F4C5} **Upcoming**");
+      lines.push(upcomingRaw);
+    }
   }
   return lines.join("\n");
 }
-async function handleStatus2(ctx) {
+async function handleStatus2(ctx, args) {
   const { workspaceDir, userId, groupId, threadId } = ctx;
   if (!userId || !groupId || !threadId) {
     return { text: "Something went wrong \u2014 this command must be run inside a Telegram forum topic." };
@@ -11311,10 +11375,18 @@ async function handleStatus2(ctx) {
   if (!fs12.existsSync(statusPath)) {
     return { text: "No status available yet. Run /tm doctor to diagnose." };
   }
+  const expanded = args.trim() === "--expanded";
   try {
-    const content = fs12.readFileSync(statusPath, "utf-8");
+    const statusContent = fs12.readFileSync(statusPath, "utf-8");
+    const todoContent = readFileOrNull(path12.join(capsuleDir, "TODO.md"));
     return {
-      text: truncateMessage(formatStatus(entry.name, content))
+      text: truncateMessage(formatStatus({
+        name: entry.name,
+        type: entry.type,
+        statusContent,
+        todoContent,
+        expanded
+      }))
     };
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
@@ -11539,6 +11611,35 @@ async function handleArchiveToggle(ctx, archive) {
       }
     }
   });
+  if (archive && entry.cronJobId) {
+    await removeCronJob(rpc, entry.cronJobId, logger);
+    await withRegistry(workspaceDir, (data) => {
+      const topic = data.topics[key];
+      if (topic) {
+        topic.cronJobId = null;
+      }
+    });
+  } else if (!archive && !entry.cronJobId) {
+    try {
+      const cronResult = await registerDailyReportCron(rpc, {
+        topicName: entry.name,
+        slug: entry.slug,
+        groupId,
+        threadId
+      }, logger);
+      if (cronResult.jobId) {
+        await withRegistry(workspaceDir, (data) => {
+          const topic = data.topics[key];
+          if (topic) {
+            topic.cronJobId = cronResult.jobId;
+          }
+        });
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      logger.error(`[archive] Cron re-registration failed: ${msg}`);
+    }
+  }
   let restartMsg = "";
   try {
     const updatedRegistry = readRegistry(workspaceDir);
@@ -11620,7 +11721,7 @@ function createTopicManagerTool(deps) {
           case "list":
             return await handleList(ctx);
           case "status":
-            return await handleStatus2(ctx);
+            return await handleStatus2(ctx, args);
           case "sync":
             return await handleSync(ctx);
           case "rename":

package/dist/setup.js

@@ -1156,7 +1156,7 @@ var PLUGIN_FILES = ["openclaw.plugin.json", "dist/plugin.js", "skills", "package
 var REQUIRED_PLUGIN_FILES = ["openclaw.plugin.json", "dist/plugin.js"];
 var FLUSH_TAG = "[tm]";
 var FLUSH_FINGERPRINTS = [FLUSH_TAG, "STATUS.md"];
-var SETUP_REGISTRY_VERSION = 5;
+var SETUP_REGISTRY_VERSION = 6;
 var MEMORY_FLUSH_INSTRUCTION = `If you are working on a Telegram topic folder (projects/<slug>/), update its STATUS.md with current "Last done (UTC)" and "Next actions (now)" before this context is compacted. ${FLUSH_TAG}`;
 var SETUP_MARKER_START = "<!-- TM_AUTOPILOT_START -->";
 var SETUP_MARKER_END = "<!-- TM_AUTOPILOT_END -->";

package/dist/tool.js

@@ -72,7 +72,7 @@ export function createTopicManagerTool(deps) {
                     case 'list':
                         return await handleList(ctx);
                     case 'status':
-                        return await handleStatus(ctx);
+                        return await handleStatus(ctx, args);
                     case 'sync':
                         return await handleSync(ctx);
                     case 'rename':