openclaw-telegram-manager 2.5.7 → 2.6.0

package/dist/plugin.js

@@ -8832,7 +8832,7 @@ var TopicTypeSchema = Type.Union([
   Type.Literal("coding"),
   Type.Literal("research"),
   Type.Literal("marketing"),
-  Type.Literal("custom")
+  Type.Literal("general")
 ]);
 var TopicStatusSchema = Type.Union([
   Type.Literal("active"),
@@ -8870,7 +8870,7 @@ var OVERLAY_FILES = {
   coding: ["ARCHITECTURE.md", "DEPLOY.md"],
   research: ["SOURCES.md", "FINDINGS.md"],
   marketing: ["CAMPAIGNS.md", "METRICS.md"],
-  custom: []
+  general: []
 };
 var BASE_FILES = [
   "README.md",
@@ -9392,7 +9392,7 @@ function buildInitTypeButtons(groupId, threadId, secret, userId) {
     ],
     [
       { text: "Marketing", callback_data: cb("im") },
-      { text: "Custom", callback_data: cb("ix") }
+      { text: "General", callback_data: cb("ig") }
     ]
   ]);
 }
@@ -9401,7 +9401,7 @@ function buildInitConfirmButton(groupId, threadId, secret, userId, type) {
     coding: "yc",
     research: "yr",
     marketing: "ym",
-    custom: "yx"
+    general: "yg"
   };
   const cb = buildCallbackData(actionMap[type], groupId, threadId, secret, userId);
   return buildInlineKeyboard([[{ text: "Use this name", callback_data: cb }]]);
@@ -9428,7 +9428,7 @@ function buildInitWelcomeHtml() {
     "\u2022 <b>Coding</b> \u2014 tracks architecture decisions and deployment steps",
     "\u2022 <b>Research</b> \u2014 tracks sources and key findings",
     "\u2022 <b>Marketing</b> \u2014 tracks campaigns and metrics",
-    "\u2022 <b>Custom</b> \u2014 general-purpose tracking",
+    "\u2022 <b>General</b> \u2014 general-purpose tracking",
     "",
     "<i>The AI may take a few seconds to respond \u2014 no need to tap twice.</i>"
   ].join("\n");
@@ -9526,9 +9526,7 @@ function buildHelpCard() {
     "/tm rename new-name \u2014 rename this topic",
     "/tm snooze 7d \u2014 pause health checks (e.g. 7d, 30d)",
     "/tm archive \u2014 archive this topic",
-    "/tm unarchive \u2014 bring back an archived topic",
-    "/tm sync \u2014 fix config if out of sync",
-    "/tm upgrade \u2014 update topic files to latest version"
+    "/tm unarchive \u2014 bring back an archived topic"
   ].join("\n");
 }
 function buildListMessage(topics) {
@@ -9544,8 +9542,8 @@ function buildListMessage(topics) {
   let rendered = 0;
   for (const t of sorted) {
     const activity = t.lastMessageAt ? `active ${relativeTime(t.lastMessageAt)}` : "no activity yet";
-    const statusTag = t.status !== "active" ? ` \u2014 ${t.status}` : "";
-    const entry = `**${t.name}** \xB7 ${t.type}${statusTag}
+    const icon = t.status === "snoozed" ? "\u{1F4A4} " : t.status === "archived" ? "\u{1F4E6} " : "";
+    const entry = `${icon}**${t.name}** \xB7 ${t.type}
   ${activity}`;
     const tentative = [...lines, entry, ""].join("\n");
     if (tentative.length > TELEGRAM_MSG_LIMIT - 40) {
@@ -9628,12 +9626,22 @@ var FILE_MODE3 = 384;
 function getSystemPromptTemplate(name, slug, absoluteWorkspacePath) {
   return `You are the assistant for the Telegram topic: ${name}.
 
+Context hierarchy (strictly ordered):
+1. TOPIC FILES (primary) \u2014 your project folder at: ${absoluteWorkspacePath}/projects/${slug}/
+   These define WHAT this topic is working on: current tasks, status, goals, history.
+   When asked "what are we working on?", answer ONLY from these files.
+2. WORKSPACE MEMORY (secondary) \u2014 files like memory/, MEMORY.md at the workspace root.
+   These contain general learnings, user preferences, and cross-topic knowledge.
+   Use them for HOW to work (patterns, mistakes to avoid, coding style) \u2014 but
+   never to determine what this topic is about or what its current tasks are.
+   Workspace memory may reference projects belonging to OTHER topics \u2014 ignore those.
+
 Determinism rules:
-- Source of truth is the project folder at: ${absoluteWorkspacePath}/projects/${slug}/
-- After /reset, /new, or context compaction: ALWAYS re-read STATUS.md,
-  then TODO.md, then LEARNINGS.md (last 20 entries), then COMMANDS.md
-  before continuing work. Do not rely on summarized memory for paths,
-  commands, or task state.
+- After /reset, /new, or context compaction: ALWAYS re-read your topic files
+  first \u2014 STATUS.md, then TODO.md, then LEARNINGS.md (last 20 entries), then
+  COMMANDS.md \u2014 before doing anything else. These are your ground truth.
+  Do not rely on summarized memory or workspace-level files for this topic's
+  tasks, status, or goals.
 - Before context compaction or when the conversation is long: proactively
   flush current progress to STATUS.md (update "Last done (UTC)" and
   "Next actions (now)") so compaction cannot erase critical state.
@@ -9656,8 +9664,11 @@ Learning capture:
 - If LEARNINGS.md exceeds ~200 lines, archive older entries to LEARNINGS-archive.md.
 
 Separation:
-- Your workspace is strictly projects/${slug}/. Do not read, write, or reference
-  files in any other topic's project directory.
+- Your project folder is strictly projects/${slug}/. This is your identity.
+- Do not read, write, or reference files in any other topic's project directory.
+- Workspace-level files (memory/, MEMORY.md, projects-index, etc.) are shared
+  context \u2014 you may read them for general knowledge and learnings, but they
+  do not define this topic's current work, goals, or identity.
 - If the user mentions another topic by name or slug, ask for explicit
   confirmation before mixing work: "This references topic X \u2014 switch context?"
 - Never copy data between topic folders without explicit user instruction.
@@ -9973,7 +9984,7 @@ async function handleStatus(ctx) {
 }
 
 // src/commands/init.ts
-var VALID_TYPES = /* @__PURE__ */ new Set(["coding", "research", "marketing", "custom"]);
+var VALID_TYPES = /* @__PURE__ */ new Set(["coding", "research", "marketing", "general"]);
 function deriveTopicName(nameArg, messageContext, threadId) {
   const topicTitle = messageContext?.["topicTitle"] ?? "";
   let name;
@@ -10120,13 +10131,12 @@ Warning: config sync failed: ${msg}`;
     try {
       const htmlCard = buildTopicCardHtml(name, topicType);
       await ctx.postFn(groupId, threadId, htmlCard);
-      return { text: "", pin: true };
+      return { text: "" };
     } catch {
     }
   }
   return {
-    text: `${topicCard}${restartMsg}`,
-    pin: true
+    text: `${topicCard}${restartMsg}`
   };
 }
 async function handleInitInteractive(ctx, args) {
@@ -10740,14 +10750,14 @@ function readFileOrNull(filePath) {
   }
 }
 function extractDoneSection(statusContent) {
-  if (!statusContent) return "_No status available yet._";
+  if (!statusContent) return "No status available yet.";
   const match = statusContent.match(/^##\s*Last done\s*\(UTC\)\s*\n([\s\S]*?)(?=\n##\s|\n*$)/im);
-  if (!match) return '_No "Last done" section found._';
+  if (!match) return "No recent activity found.";
   const text = match[1]?.trim();
-  return text || "_Empty._";
+  return text || "Empty.";
 }
 function extractTodayLearnings(learningsContent) {
-  if (!learningsContent) return "_No learnings recorded yet._";
+  if (!learningsContent) return "No learnings recorded yet.";
   const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   const lines = learningsContent.split("\n");
   const todayLines = [];
@@ -10764,32 +10774,32 @@ function extractTodayLearnings(learningsContent) {
       todayLines.push(line);
     }
   }
-  return todayLines.length > 0 ? todayLines.join("\n") : "_None today._";
+  return todayLines.length > 0 ? todayLines.join("\n") : "None today.";
 }
 function extractBlockers(todoContent) {
-  if (!todoContent) return "_No tasks recorded yet._";
+  if (!todoContent) return "No tasks recorded yet.";
   const lines = todoContent.split("\n");
   const blockerLines = lines.filter(
     (l) => /\[BLOCKED\]/i.test(l) || /\bblocked\b/i.test(l)
   );
-  return blockerLines.length > 0 ? blockerLines.join("\n") : "_None._";
+  return blockerLines.length > 0 ? blockerLines.join("\n") : "None.";
 }
 function extractNextActions(statusContent) {
-  if (!statusContent) return "_No status available yet._";
+  if (!statusContent) return "No status available yet.";
   const match = statusContent.match(/^##\s*Next (?:3 )?actions(?: \(now\))?\s*\n([\s\S]*?)(?=\n##\s|\n*$)/im);
-  if (!match) return '_No "Next actions" section found._';
+  if (!match) return "None yet.";
   const text = match[1]?.trim();
-  return text || "_Empty._";
+  return text || "None yet.";
 }
 function extractUpcoming(statusContent) {
-  if (!statusContent) return "_No status available yet._";
+  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 '_No "Upcoming actions" section found._';
+  if (!match) return "None yet.";
   const text = match[1]?.trim();
-  return text || "_Empty._";
+  return text || "None yet.";
 }
 function computeHealth(lastMessageAt, statusContent, blockers) {
-  if (blockers && blockers !== "_None._" && blockers !== "_No tasks recorded yet._") {
+  if (blockers && blockers !== "None." && blockers !== "No tasks recorded yet.") {
     return "blocked";
   }
   if (!lastMessageAt) return "stale";
@@ -10799,6 +10809,132 @@ function computeHealth(lastMessageAt, statusContent, blockers) {
 }
 
 // src/commands/doctor-all.ts
+function getEligibility(entry, now, statusTimestamp) {
+  if (entry.status === "archived") return { eligible: false, skipReason: "archived" };
+  if (entry.snoozeUntil && new Date(entry.snoozeUntil).getTime() > now.getTime()) {
+    return { eligible: false, skipReason: "snoozed" };
+  }
+  const lastActive = mostRecent(entry.lastMessageAt, statusTimestamp);
+  if (lastActive) {
+    const lastActiveMs = new Date(lastActive).getTime();
+    const inactiveMs = INACTIVE_AFTER_DAYS * 24 * 60 * 60 * 1e3;
+    if (now.getTime() - lastActiveMs > inactiveMs) {
+      return { eligible: false, skipReason: "inactive" };
+    }
+  }
+  if (entry.lastDoctorReportAt) {
+    const lastReport = new Date(entry.lastDoctorReportAt).getTime();
+    if (now.getTime() - lastReport < DOCTOR_PER_TOPIC_CAP_MS) {
+      return { eligible: false, skipReason: "recently-checked" };
+    }
+  }
+  return { eligible: true };
+}
+var SKIP_ICONS = {
+  archived: "\u{1F4E6}",
+  // 📦
+  snoozed: "\u{1F4A4}",
+  // 💤
+  inactive: "\u{1F507}",
+  // 🔇
+  "recently-checked": "\u23F0"
+  // ⏰
+};
+var SKIP_LABELS = {
+  archived: "archived",
+  snoozed: "snoozed",
+  inactive: "inactive",
+  "recently-checked": "recently checked"
+};
+var SUMMARY_SOFT_LIMIT = 3800;
+function buildDoctorAllSummary(data) {
+  const {
+    checkedTopics,
+    skippedTopics,
+    postFailures,
+    dailyReportsSent,
+    dailyReportsSkipped,
+    hasPostFn,
+    migrationGroups,
+    errors
+  } = data;
+  if (checkedTopics.length === 0 && skippedTopics.length === 0) {
+    return "**Health Check Summary**\n\nNo topics registered yet.";
+  }
+  const lines = ["**Health Check Summary**", ""];
+  let checkedRendered = 0;
+  for (const t of checkedTopics) {
+    let icon;
+    let label;
+    switch (t.status) {
+      case "checked":
+        icon = "\u2705";
+        label = "checked";
+        break;
+      case "check-failed":
+        icon = "\u274C";
+        label = "check failed";
+        break;
+      case "post-failed":
+        icon = "\u26A0\uFE0F";
+        label = "failed to post";
+        break;
+    }
+    const line = `${icon} ${t.name} \u2014 ${label}`;
+    if (lines.join("\n").length + line.length > SUMMARY_SOFT_LIMIT) {
+      const remaining = checkedTopics.length - checkedRendered;
+      lines.push(`... and ${remaining} more`);
+      break;
+    }
+    lines.push(line);
+    checkedRendered++;
+  }
+  if (skippedTopics.length > 0) {
+    lines.push("");
+    lines.push("\u23ED\uFE0F Skipped:");
+    let skippedRendered = 0;
+    for (const t of skippedTopics) {
+      const icon = SKIP_ICONS[t.reason];
+      const label = SKIP_LABELS[t.reason];
+      const line = `${icon} ${t.name} \u2014 ${label}`;
+      if (lines.join("\n").length + line.length > SUMMARY_SOFT_LIMIT) {
+        const remaining = skippedTopics.length - skippedRendered;
+        lines.push(`... and ${remaining} more`);
+        break;
+      }
+      lines.push(line);
+      skippedRendered++;
+    }
+  }
+  if (postFailures > 0) {
+    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.`);
+  }
+  if (errors.length > 0) {
+    lines.push("");
+    lines.push(`**Errors (${errors.length}):**`);
+    for (const e of errors.slice(0, 10)) {
+      lines.push(`- ${e}`);
+    }
+    if (errors.length > 10) {
+      lines.push(`... and ${errors.length - 10} more`);
+    }
+  }
+  return truncateMessage(lines.join("\n"));
+}
 async function handleDoctorAll(ctx) {
   const { workspaceDir, configDir, logger } = ctx;
   const registry = readRegistry(workspaceDir);
@@ -10834,12 +10970,16 @@ async function handleDoctorAll(ctx) {
   const allEntries = Object.entries(registry.topics);
   const reports = [];
   const errors = [];
-  let processed = 0;
-  let skipped = 0;
+  const checkedTopics = [];
+  const skippedTopics = [];
   const groupPostResults = /* @__PURE__ */ new Map();
   for (const [_key, entry] of allEntries) {
-    if (!isEligible(entry, now)) {
-      skipped++;
+    const capsuleDir = path11.join(projectsBase, entry.slug);
+    const statusForEligibility = readFileOrNull(path11.join(capsuleDir, "STATUS.md"));
+    const statusTs = statusForEligibility ? extractStatusTimestamp(statusForEligibility) : null;
+    const eligibility = getEligibility(entry, now, statusTs);
+    if (!eligibility.eligible) {
+      skippedTopics.push({ name: entry.name, reason: eligibility.skipReason });
       continue;
     }
     try {
@@ -10875,11 +11015,12 @@ async function handleDoctorAll(ctx) {
       }
       const group = groupPostResults.get(gk);
       group.total++;
-      processed++;
+      checkedTopics.push({ name: entry.name, slug: entry.slug, status: "checked" });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       errors.push(`${entry.slug}: ${msg}`);
       logger.error(`[doctor-all] Error processing ${entry.slug}: ${msg}`);
+      checkedTopics.push({ name: entry.name, slug: entry.slug, status: "check-failed" });
       const gk = entry.groupId;
       if (!groupPostResults.has(gk)) {
         groupPostResults.set(gk, { total: 0, failed: 0 });
@@ -10895,14 +11036,13 @@ async function handleDoctorAll(ctx) {
       migrationGroups.push(gid);
     }
   }
-  let postErrors = 0;
-  let postSuccesses = 0;
+  let postFailures = 0;
+  const postFailedSlugs = /* @__PURE__ */ new Set();
   if (ctx.postFn && reports.length > 0) {
     const rateLimitedPost = createRateLimitedPoster(ctx.postFn);
     for (const report of reports) {
       try {
         await rateLimitedPost(report.groupId, report.threadId, report.text, report.keyboard);
-        postSuccesses++;
         await withRegistry(workspaceDir, (data) => {
           const key = `${report.groupId}:${report.threadId}`;
           const entry = data.topics[key];
@@ -10912,7 +11052,8 @@ async function handleDoctorAll(ctx) {
           }
         });
       } catch (err) {
-        postErrors++;
+        postFailures++;
+        postFailedSlugs.add(report.slug);
         const msg = err instanceof Error ? err.message : String(err);
         logger.error(`[doctor-all] Post failed for ${report.slug}: ${msg}`);
         await withRegistry(workspaceDir, (data) => {
@@ -10924,6 +11065,11 @@ async function handleDoctorAll(ctx) {
         });
       }
     }
+    for (const outcome of checkedTopics) {
+      if (postFailedSlugs.has(outcome.slug) && outcome.status === "checked") {
+        outcome.status = "post-failed";
+      }
+    }
   }
   let dailyReportSuccesses = 0;
   let dailyReportSkipped = 0;
@@ -10976,7 +11122,10 @@ async function handleDoctorAll(ctx) {
   await withRegistry(workspaceDir, (data) => {
     data.lastDoctorAllRunAt = now.toISOString();
     for (const [_key, entry] of Object.entries(data.topics)) {
-      if (!isEligible(entry, now)) continue;
+      const dir = path11.join(projectsBase, entry.slug);
+      const statusFile = readFileOrNull(path11.join(dir, "STATUS.md"));
+      const ts = statusFile ? extractStatusTimestamp(statusFile) : null;
+      if (!isEligible(entry, now, ts)) continue;
       if (entry.lastMessageAt) {
         const lastMsg = new Date(entry.lastMessageAt).getTime();
         const lastDoctor = entry.lastDoctorRunAt ? new Date(entry.lastDoctorRunAt).getTime() : 0;
@@ -11002,42 +11151,44 @@ async function handleDoctorAll(ctx) {
       }
     }
   });
-  const lines = [
-    `**Health Check Summary**`,
-    "",
-    `Checked: ${processed}`,
-    `Skipped: ${skipped}`,
-    `Total topics: ${allEntries.length}`
-  ];
-  if (ctx.postFn) {
-    lines.push(`Posted: ${postSuccesses}, Post failures: ${postErrors}`);
-    lines.push(`Daily reports: ${dailyReportSuccesses} sent, ${dailyReportSkipped} skipped`);
-  }
-  if (errors.length > 0) {
-    lines.push("");
-    lines.push(`**Errors (${errors.length}):**`);
-    for (const e of errors.slice(0, 10)) {
-      lines.push(`- ${e}`);
-    }
-    if (errors.length > 10) {
-      lines.push(`... and ${errors.length - 10} more`);
-    }
-  }
-  if (migrationGroups.length > 0) {
-    lines.push("");
-    lines.push(`**Warning:** ${migrationGroups.length} group(s) had all topics fail. The group may have been migrated or deleted.`);
-  }
   return {
-    text: lines.join("\n")
+    text: buildDoctorAllSummary({
+      checkedTopics,
+      skippedTopics,
+      postFailures,
+      dailyReportsSent: dailyReportSuccesses,
+      dailyReportsSkipped: dailyReportSkipped,
+      hasPostFn: !!ctx.postFn,
+      migrationGroups: migrationGroups.length,
+      errors
+    })
   };
 }
-function isEligible(entry, now) {
+var STATUS_TIMESTAMP_RE = /^##\s*Last done\s*\(UTC\)/im;
+var ISO_TIMESTAMP_RE = /\d{4}-\d{2}-\d{2}T\d{2}:\d{2}/;
+function extractStatusTimestamp(content) {
+  if (!STATUS_TIMESTAMP_RE.test(content)) return null;
+  const idx = content.search(STATUS_TIMESTAMP_RE);
+  const sectionAfter = content.slice(idx);
+  const nextSection = sectionAfter.indexOf("\n## ", 1);
+  const section = nextSection > 0 ? sectionAfter.slice(0, nextSection) : sectionAfter;
+  const match = section.match(ISO_TIMESTAMP_RE);
+  return match ? match[0] : null;
+}
+function mostRecent(a, b) {
+  if (!a && !b) return null;
+  if (!a) return b;
+  if (!b) return a;
+  return a > b ? a : b;
+}
+function isEligible(entry, now, statusTimestamp) {
   if (entry.status === "archived") return false;
   if (entry.snoozeUntil && new Date(entry.snoozeUntil).getTime() > now.getTime()) return false;
-  if (entry.lastMessageAt) {
-    const lastActive = new Date(entry.lastMessageAt).getTime();
+  const lastActive = mostRecent(entry.lastMessageAt, statusTimestamp);
+  if (lastActive) {
+    const lastActiveMs = new Date(lastActive).getTime();
     const inactiveMs = INACTIVE_AFTER_DAYS * 24 * 60 * 60 * 1e3;
-    if (now.getTime() - lastActive > inactiveMs) return false;
+    if (now.getTime() - lastActiveMs > inactiveMs) return false;
   }
   if (entry.lastDoctorReportAt) {
     const lastReport = new Date(entry.lastDoctorReportAt).getTime();
@@ -11106,18 +11257,18 @@ function formatStatus(name, content) {
     ""
   ];
   if (timestamp) {
-    lines.push(`**Last activity:** ${relativeTime(timestamp)}`);
+    lines.push(`\u{1F552} **Last activity:** ${relativeTime(timestamp)}`);
   }
   if (lastDoneBody && !isPlaceholder(lastDoneBody)) {
     lines.push(lastDoneBody);
   }
   lines.push("");
-  lines.push("**Next actions**");
+  lines.push("\u{1F3AF} **Next actions**");
   lines.push(formatSection(nextRaw));
   const upcomingFormatted = formatSection(upcomingRaw);
   if (upcomingFormatted !== "_None yet._") {
     lines.push("");
-    lines.push("**Upcoming**");
+    lines.push("\u{1F4C5} **Upcoming**");
     lines.push(upcomingFormatted);
   }
   return lines.join("\n");
@@ -11561,13 +11712,13 @@ async function handleCallback(data, ctx) {
     ic: "coding",
     ir: "research",
     im: "marketing",
-    ix: "custom"
+    ig: "general"
   };
   const initConfirmMap = {
     yc: "coding",
     yr: "research",
     ym: "marketing",
-    yx: "custom"
+    yg: "general"
   };
   const cbCtx = { ...ctx, groupId: cbGroupId, threadId: cbThreadId, userId: cbUserId };
   if (action in initTypeMap) {

package/dist/setup.js

@@ -1270,8 +1270,10 @@ async function runSetup() {
   startSpinner("Patching memory flush\u2026");
   patchMemoryFlush(configDir);
   startSpinner("Preparing workspace\u2026");
-  const projectsDir = path.join(configDir, "workspace", "projects");
+  const workspaceDir = path.join(configDir, "workspace");
+  const projectsDir = path.join(workspaceDir, "projects");
   ensureDir(projectsDir);
+  ensureGitignore(workspaceDir);
   initRegistry(projectsDir);
   createEmptyInclude(configDir, existingGroups);
   ok("Workspace ready");
@@ -1498,6 +1500,29 @@ function createEmptyInclude(configDir, seedGroups) {
   ].join("\n");
   fs.writeFileSync(includePath, content, { mode: 384 });
 }
+var GITIGNORE_ENTRIES = [
+  "projects/topics.json",
+  "projects/audit.jsonl",
+  "projects/*/.tm-backup/"
+];
+function ensureGitignore(workspaceDir) {
+  const gitignorePath = path.join(workspaceDir, ".gitignore");
+  let content = "";
+  try {
+    if (fs.existsSync(gitignorePath)) {
+      content = fs.readFileSync(gitignorePath, "utf-8");
+    }
+  } catch {
+  }
+  const lines = content.split("\n");
+  const missing = GITIGNORE_ENTRIES.filter(
+    (entry) => !lines.some((line) => line.trim() === entry)
+  );
+  if (missing.length === 0) return;
+  const block = "\n# telegram-manager (operational files)\n" + missing.join("\n") + "\n";
+  const newContent = content ? content.trimEnd() + "\n" + block : block.trimStart();
+  fs.writeFileSync(gitignorePath, newContent);
+}
 function writeHeartbeat(configDir) {
   const heartbeatPath = path.join(configDir, "workspace", "HEARTBEAT.md");
   let content = "";