remote-coder 0.5.0__tar.gz → 0.5.2__tar.gz

{remote_coder-0.5.0 → remote_coder-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: remote-coder
-Version: 0.5.0
+Version: 0.5.2
 Summary: Telegram-based remote AI coding automation server
 Author: Remote AI Coder contributors
 License:                                  Apache License
@@ -236,7 +236,7 @@ Run Claude Code, Codex, or Gemini on your local development machine by sending a
 - Claude, Codex, and Gemini runners behind the same job flow.
 - Reply-linked jobs continue the same AI CLI session, so follow-ups build on prior context.
 - Local admin UI for project setup, advanced settings, logs, and conversation memory.
-- Read-only `plan:` and `ask:` modes when you want analysis without commits. PLAN mode asks open decisions through inline buttons first, then finalizes the plan from your answers.
+- Read-only `plan:`, `ask:`, and `research:` modes when you want analysis without commits. PLAN mode asks open decisions through inline buttons first, then finalizes the plan from your answers; RESEARCH mode asks the selected AI CLI to use internet search when useful.
 
 ## Quick Start
 
@@ -311,6 +311,7 @@ Natural-language examples:
 Fix the login validation bug with model: codex
 plan: outline the migration before changing code
 /ask what test command does this repo use?
+/research compare current Telegram webhook security guidance
 수정: 방금 작업에서 README 문구만 더 간결하게 바꿔줘
 ```
 

{remote_coder-0.5.0 → remote_coder-0.5.2}/README.md

@@ -15,7 +15,7 @@ Run Claude Code, Codex, or Gemini on your local development machine by sending a
 - Claude, Codex, and Gemini runners behind the same job flow.
 - Reply-linked jobs continue the same AI CLI session, so follow-ups build on prior context.
 - Local admin UI for project setup, advanced settings, logs, and conversation memory.
-- Read-only `plan:` and `ask:` modes when you want analysis without commits. PLAN mode asks open decisions through inline buttons first, then finalizes the plan from your answers.
+- Read-only `plan:`, `ask:`, and `research:` modes when you want analysis without commits. PLAN mode asks open decisions through inline buttons first, then finalizes the plan from your answers; RESEARCH mode asks the selected AI CLI to use internet search when useful.
 
 ## Quick Start
 
@@ -90,6 +90,7 @@ Natural-language examples:
 Fix the login validation bug with model: codex
 plan: outline the migration before changing code
 /ask what test command does this repo use?
+/research compare current Telegram webhook security guidance
 수정: 방금 작업에서 README 문구만 더 간결하게 바꿔줘
 ```
 

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/__init__.py

@@ -1,3 +1,3 @@
 """Remote AI Coder application package."""
 
-__version__ = "0.5.0"
+__version__ = "0.5.2"

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/admin/router.py

@@ -378,9 +378,10 @@ def create_admin_router(
         report = check_prerequisites()
         installed = [cli.name for cli in report.ai_clis if cli.installed]
         _adminlog.info(
-            "prerequisites queried ngrok_ok=%s ai_clis=%s",
+            "prerequisites queried ngrok_ok=%s ai_clis=%s github_cli=%s",
             report.ngrok_ok,
             ",".join(installed) or "-",
+            report.github_cli.installed,
         )
         return report.model_dump()
 

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/admin/static/i18n.js

@@ -146,6 +146,11 @@
       en: "None found (install at least one: claude / codex / gemini)",
       ko: "설치된 것 없음 (claude / codex / gemini 중 최소 1개 설치)",
     },
+    "setup.githubCli": { en: "GitHub CLI", ko: "GitHub CLI" },
+    "setup.githubCliNone": {
+      en: "Not found (install gh before using /pr)",
+      ko: "설치되지 않음 (/pr 사용 전 gh 설치 필요)",
+    },
     "setup.checking": { en: "Checking…", ko: "확인 중…" },
     "setup.recheck": { en: "Re-check", ko: "다시 확인" },
     "setup.cta": { en: "Add your first project", ko: "첫 프로젝트 추가" },

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/admin/templates/admin.html

@@ -248,9 +248,12 @@
       const installed = (report.ai_clis || []).filter((c) => c.installed).map((c) => c.name);
       const aiOk = installed.length > 0;
       const aiDetail = aiOk ? installed.join(", ") : i18n.t("setup.aiCliNone");
+      const ghOk = !!(report.github_cli && report.github_cli.installed);
+      const ghDetail = ghOk ? "gh" : i18n.t("setup.githubCliNone");
       $("#setup-prereq").innerHTML =
         renderPrereqRow(!!report.ngrok_ok, i18n.t("setup.ngrok"), ngrokDetail) +
-        renderPrereqRow(aiOk, i18n.t("setup.aiCli"), aiDetail);
+        renderPrereqRow(aiOk, i18n.t("setup.aiCli"), aiDetail) +
+        renderPrereqRow(ghOk, i18n.t("setup.githubCli"), ghDetail);
     }
 
     async function loadPrerequisites() {

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/ai/base.py

@@ -57,6 +57,18 @@ _PLAN_DECISIONS_INSTRUCTION = (
 )
 
 
+_RESEARCH_INSTRUCTION = (
+    "You are in RESEARCH mode. Read the repository context and answer the user's research "
+    "question. Do not modify files.\n\n"
+    "Use internet search when it is useful or necessary for the question, similar to a deep "
+    "research workflow. Compare multiple perspectives or sources when possible, and clearly "
+    "separate repository-derived facts from external findings. Include citations or source "
+    "links for external claims, call out uncertainty or limitations, and finish with a direct "
+    "answer to the user's problem.\n\n"
+    "User research request:\n"
+)
+
+
 def instruction_for_runner_mode(instruction: str, mode: JobMode) -> str:
     if mode == JobMode.PLAN:
         return f"{_PLAN_DECISIONS_INSTRUCTION}{instruction}"
@@ -66,6 +78,8 @@ def instruction_for_runner_mode(instruction: str, mode: JobMode) -> str:
             "Do not modify files.\n\n"
             f"User question:\n{instruction}"
         )
+    if mode == JobMode.RESEARCH:
+        return f"{_RESEARCH_INSTRUCTION}{instruction}"
     return instruction
 
 
@@ -80,6 +94,7 @@ class RunnerInput:
     mode: JobMode = JobMode.AGENT
     session_id: str | None = None
     resume_token: str | None = None
+    native_resume_cwd_stable: bool = True
 
 
 @dataclass

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/ai/claude.py

@@ -12,13 +12,20 @@ class ClaudeRunner(BaseCliRunner):
         self, runner_input: RunnerInput, before: dict[str, float]
     ) -> str | None:
         # Claude owns its session id deterministically (we pass --session-id/--resume).
-        return runner_input.resume_token or runner_input.session_id
+        return self._effective_resume_token(runner_input) or runner_input.session_id
+
+    @staticmethod
+    def _effective_resume_token(runner_input: RunnerInput) -> str | None:
+        if not runner_input.native_resume_cwd_stable:
+            return None
+        return runner_input.resume_token
 
     def build_argv(self, runner_input: RunnerInput) -> list[str]:
         prompt = instruction_for_runner_mode(runner_input.instruction, runner_input.mode)
         argv = ["claude", "-p", prompt, "--dangerously-skip-permissions"]
-        if runner_input.resume_token:
-            argv.extend(["--resume", runner_input.resume_token])
+        resume_token = self._effective_resume_token(runner_input)
+        if resume_token:
+            argv.extend(["--resume", resume_token])
         elif runner_input.session_id:
             argv.extend(["--session-id", runner_input.session_id])
         if runner_input.model_id:

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/ai/codex.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from pathlib import Path
 
 from app.ai.base import BaseCliRunner, RunnerInput, instruction_for_runner_mode
-from app.jobs.schemas import JobMode
+from app.jobs.schemas import is_read_only_job_mode
 from app.models import CodexSandboxMode
 from app.monitoring.events import EventLogger
 
@@ -16,7 +16,7 @@ class CodexRunner(BaseCliRunner):
         self._sandbox = sandbox
 
     def _resolve_sandbox(self, runner_input: RunnerInput) -> CodexSandboxMode:
-        if runner_input.mode in (JobMode.PLAN, JobMode.ASK):
+        if is_read_only_job_mode(runner_input.mode):
             return CodexSandboxMode.READ_ONLY
         return self._sandbox
 
@@ -29,7 +29,7 @@ class CodexRunner(BaseCliRunner):
 
     def build_argv(self, runner_input: RunnerInput) -> list[str]:
         sandbox = self._resolve_sandbox(runner_input)
-        if runner_input.mode in (JobMode.PLAN, JobMode.ASK):
+        if is_read_only_job_mode(runner_input.mode):
             instruction = instruction_for_runner_mode(runner_input.instruction, runner_input.mode)
         else:
             instruction = runner_input.instruction

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/ai/gemini.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from pathlib import Path
 
 from app.ai.base import BaseCliRunner, RunnerInput, instruction_for_runner_mode
-from app.jobs.schemas import JobMode
+from app.jobs.schemas import is_read_only_job_mode
 from app.monitoring.events import EventLogger
 
 
@@ -17,7 +17,7 @@ class GeminiRunner(BaseCliRunner):
         return Path.home() / ".gemini" / "sessions"
 
     def build_argv(self, runner_input: RunnerInput) -> list[str]:
-        if runner_input.mode in (JobMode.PLAN, JobMode.ASK):
+        if is_read_only_job_mode(runner_input.mode):
             prompt = instruction_for_runner_mode(runner_input.instruction, runner_input.mode)
             argv = ["gemini", "--skip-trust", "-p", prompt]
         else:

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/cli.py

@@ -32,7 +32,7 @@ def build_parser() -> argparse.ArgumentParser:
         help="Run the server only (skip ngrok and webhook registration)",
     )
 
-    subparsers.add_parser("doctor", help="Check prerequisites (ngrok, AI CLIs)")
+    subparsers.add_parser("doctor", help="Check prerequisites (ngrok, AI CLIs, GitHub CLI)")
     return parser
 
 
@@ -128,6 +128,10 @@ def run_doctor() -> None:
             "  ⚠️ AI CLI (claude/codex/gemini) not found. Install at least one. "
             "(e.g. npm install -g @anthropic-ai/claude-code)"
         )
+    if report.github_cli.installed:
+        print("  ✅ GitHub CLI: gh")
+    else:
+        print("  ⚠️ GitHub CLI (gh) not found. Install it before using /pr.")
 
 
 if __name__ == "__main__":

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/diagnostics.py

@@ -7,6 +7,7 @@ from pydantic import BaseModel
 from app import tunnel
 
 AI_CLI_TOOLS = ("claude", "codex", "gemini")
+GITHUB_CLI_TOOL = "gh"
 
 
 class AiCliStatus(BaseModel):
@@ -18,6 +19,7 @@ class PrerequisitesReport(BaseModel):
     ngrok_ok: bool
     ngrok_detail: str
     ai_clis: list[AiCliStatus]
+    github_cli: AiCliStatus
 
 
 def check_prerequisites() -> PrerequisitesReport:
@@ -34,4 +36,13 @@ def check_prerequisites() -> PrerequisitesReport:
         AiCliStatus(name=tool, installed=shutil.which(tool) is not None)
         for tool in AI_CLI_TOOLS
     ]
-    return PrerequisitesReport(ngrok_ok=ngrok_ok, ngrok_detail=ngrok_detail, ai_clis=ai_clis)
+    github_cli = AiCliStatus(
+        name=GITHUB_CLI_TOOL,
+        installed=shutil.which(GITHUB_CLI_TOOL) is not None,
+    )
+    return PrerequisitesReport(
+        ngrok_ok=ngrok_ok,
+        ngrok_detail=ngrok_detail,
+        ai_clis=ai_clis,
+        github_cli=github_cli,
+    )

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/jobs/execution_pipeline.py

@@ -6,7 +6,7 @@ from pathlib import Path
 from app.ai.base import RunnerInput
 from app.git.commit_message import CommitMessageFormatter
 from app.jobs.plan_decisions import PlanDecisionQuestion, parse_plan_decisions
-from app.jobs.schemas import Job, JobMode
+from app.jobs.schemas import Job, JobMode, is_read_only_job_mode
 from app.monitoring.events import EventLogger
 
 _joblog = EventLogger("app.jobs.lifecycle", "job.lifecycle")
@@ -50,7 +50,7 @@ def run_job(manager, job_id: str) -> Job:
     created_worktree_for_job = False
     failed_stage: str | None = None
     remote = manager._effective_git_remote_name()
-    read_only_job = job.request.mode in (JobMode.PLAN, JobMode.ASK)
+    read_only_job = is_read_only_job_mode(job.request.mode)
     plan_decision_questions: list[PlanDecisionQuestion] | None = None
     try:
         job.mark_running()
@@ -96,6 +96,7 @@ def run_job(manager, job_id: str) -> Job:
                     mode=job.request.mode,
                     session_id=job.request.session_id,
                     resume_token=job.request.resume_session_token,
+                    native_resume_cwd_stable=not created_worktree_for_job,
                 )
             )
         finally:
@@ -237,9 +238,7 @@ def run_job(manager, job_id: str) -> Job:
     finally:
         manager._cancel_events.pop(job_id, None)
         manager._cancelled_job_ids.discard(job_id)
-        read_only_succeeded = (
-            job.request.mode in (JobMode.PLAN, JobMode.ASK) and job.status.value == "succeeded"
-        )
+        read_only_succeeded = is_read_only_job_mode(job.request.mode) and job.status.value == "succeeded"
         cleanup_on_success = read_only_succeeded or not manager._effective_keep_worktree_on_success()
         _joblog.info(
             "job finalizing status=%s created_worktree=%s cleanup_on_success=%s",

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/jobs/fix_pipeline.py

@@ -92,6 +92,7 @@ def run_fix_job(manager, job_id: str) -> Job:
                     mode=JobMode.AGENT,
                     session_id=job.request.session_id,
                     resume_token=job.request.resume_session_token,
+                    native_resume_cwd_stable=not created_worktree_for_job,
                 )
             )
         finally:

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/jobs/heartbeat.py

@@ -8,33 +8,42 @@ from app.jobs.schemas import Job
 from app.telegram.notifier import Notifier, build_job_accepted_message, build_job_heartbeat_message
 
 
+class HeartbeatHandle:
+    def __init__(self, stop_event: threading.Event, thread: threading.Thread | None) -> None:
+        self._stop = stop_event
+        self._thread = thread
+
+    def set(self) -> None:
+        # Stop the heartbeat and wait for any in-flight edit so the caller's next
+        # edit (send_job_result) wins the race for the same message_id.
+        self._stop.set()
+        if self._thread is not None:
+            self._thread.join(timeout=15)
+
+
 def start_heartbeat(
     *,
     job: Job,
     notifier_resolver: Callable[[str], Notifier],
     interval_seconds: float,
-) -> threading.Event:
+) -> HeartbeatHandle:
     # Periodically edit the "Job accepted" message so a long run shows live progress.
     # No-op when there is no message to edit (e.g. notifier returned no id).
     stop = threading.Event()
     if job.accepted_message_id is None:
-        return stop
+        return HeartbeatHandle(stop, None)
     notifier = notifier_resolver(job.request.project)
     chat_id = job.request.chat_id
     message_id = job.accepted_message_id
     started = datetime.now(UTC)
-    accepted_text, stop_buttons = build_job_accepted_message(job)
-    edited = threading.Event()
+    _, stop_buttons = build_job_accepted_message(job)
 
     def _beat() -> None:
         while not stop.wait(interval_seconds):
             elapsed_minutes = int((datetime.now(UTC) - started).total_seconds() // 60)
             text = build_job_heartbeat_message(job, elapsed_minutes)
             notifier.edit_message(chat_id, message_id, text, stop_buttons)
-            edited.set()
-        if edited.is_set():
-            # Restore the original accepted body without the now-useless Stop button.
-            notifier.edit_message(chat_id, message_id, accepted_text, [])
 
-    threading.Thread(target=_beat, daemon=True).start()
-    return stop
+    thread = threading.Thread(target=_beat, daemon=True)
+    thread.start()
+    return HeartbeatHandle(stop, thread)

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/jobs/manager.py

@@ -20,7 +20,7 @@ from app.jobs.fix_support import (
     list_fix_candidates,
     resolve_fix_target_job,
 )
-from app.jobs.heartbeat import start_heartbeat
+from app.jobs.heartbeat import HeartbeatHandle, start_heartbeat
 from app.jobs.plan_decisions import PlanDecisionQuestion
 from app.jobs.result_writer import (
     make_output_summary,
@@ -37,6 +37,19 @@ from app.telegram.notifier import Notifier
 
 _joblog = EventLogger("app.jobs.lifecycle", "job.lifecycle")
 
+# Telegram only allows reactions from a fixed allow-list of emoji, so map the job
+# lifecycle onto values from https://core.telegram.org/bots/api#reactiontypeemoji.
+_REACTION_QUEUED = "👀"
+_REACTION_SUCCEEDED = "🎉"
+_REACTION_FAILED = "💔"
+_REACTION_CANCELLED = "🤝"
+
+_TERMINAL_REACTION_BY_STATUS = {
+    "succeeded": _REACTION_SUCCEEDED,
+    "failed": _REACTION_FAILED,
+    "cancelled": _REACTION_CANCELLED,
+}
+
 
 class JobManager:
     def __init__(
@@ -73,7 +86,7 @@ class JobManager:
     def _notifier_for(self, project: str) -> Notifier:
         return self._notifier_resolver(project)
 
-    def _start_heartbeat(self, job: Job) -> threading.Event:
+    def _start_heartbeat(self, job: Job) -> HeartbeatHandle:
         return start_heartbeat(
             job=job,
             notifier_resolver=self._notifier_for,
@@ -104,6 +117,21 @@ class JobManager:
             self._notifier_for(job.request.project).send_job_result(job)
         )
         self._job_store.update(job)
+        self._react(job.request, _TERMINAL_REACTION_BY_STATUS.get(job.status.value))
+
+    def _react(self, request: JobRequest, emoji: str | None) -> None:
+        if request.message_id is None or emoji is None:
+            return
+        try:
+            self._notifier_for(request.project).set_reaction(
+                request.chat_id, request.message_id, emoji
+            )
+        except Exception:  # pylint: disable=broad-except
+            _joblog.exception(
+                "set_reaction failed",
+                chat_id=request.chat_id,
+                project=request.project,
+            )
 
     def submit(self, request: JobRequest) -> Job:
         job = Job(id=request.job_id or self._make_job_id(), request=request)
@@ -120,6 +148,7 @@ class JobManager:
         if accepted_message_id is not None:
             job.accepted_message_id = accepted_message_id
             self._job_store.update(job)
+        self._react(request, _REACTION_QUEUED)
         return job
 
     def cancel(self, job_id: str) -> bool:
@@ -218,6 +247,7 @@ class JobManager:
         if accepted_message_id is not None:
             job.accepted_message_id = accepted_message_id
             self._job_store.update(job)
+        self._react(request, _REACTION_QUEUED)
         with self._project_lock(request.project):
             return self._run_fix(job.id)
 

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/jobs/schemas.py

@@ -26,9 +26,17 @@ class JobMode(StrEnum):
     AGENT = "agent"
     PLAN = "plan"
     ASK = "ask"
+    RESEARCH = "research"
     AGENT_FIX = "agent_fix"
 
 
+READ_ONLY_JOB_MODES = frozenset({JobMode.PLAN, JobMode.ASK, JobMode.RESEARCH})
+
+
+def is_read_only_job_mode(mode: JobMode) -> bool:
+    return mode in READ_ONLY_JOB_MODES
+
+
 class FixKind(StrEnum):
     SOURCE = "source"
 

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/jobs/worktree_planner.py

@@ -4,7 +4,7 @@ from dataclasses import dataclass
 from pathlib import Path
 
 from app.git.service import GitWorktreeService
-from app.jobs.schemas import Job, JobMode
+from app.jobs.schemas import Job, is_read_only_job_mode
 from app.monitoring.events import EventLogger
 
 _joblog = EventLogger("app.jobs.lifecycle", "job.lifecycle")
@@ -27,7 +27,7 @@ def prepare_worktree_plan(
     job_ctx: dict[str, object],
 ) -> WorktreePlan:
     requested_branch = job.request.branch
-    if job.request.mode in (JobMode.PLAN, JobMode.ASK):
+    if is_read_only_job_mode(job.request.mode):
         path = git_service.prepare_detached_worktree(
             project_path, job.id, worktree_base_dir=worktree_base
         )

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/main.py

@@ -1,7 +1,7 @@
 import asyncio
 import logging
 import time
-from contextlib import asynccontextmanager
+from contextlib import asynccontextmanager, suppress
 from dataclasses import replace
 
 from fastapi import FastAPI, Request
@@ -137,9 +137,8 @@ webhook_registrar = (
     else None
 )
 
-@asynccontextmanager
-async def lifespan(_app: FastAPI):
-    instances = bot_instance_manager.list_all()
+
+def _run_startup_side_effects(instances: list[BotInstance], adv: AdvancedSettings) -> None:
     startup_chat_total = sum(len(inst.auth_service.allowed_chat_ids) for inst in instances)
     _systemlog.info(
         "lifespan startup notifying allowed chats count=%d projects=%d default_model=%s",
@@ -147,9 +146,7 @@ async def lifespan(_app: FastAPI):
         len(project_registry.list_projects()),
         ModelName.CLAUDE.value,
     )
-    adv = advanced_settings_store.get()
-    await asyncio.to_thread(
-        run_startup_project_pulls,
+    run_startup_project_pulls(
         pull_projects_on_server_startup_enabled=adv.pull_projects_on_server_startup_enabled,
         project_registry=project_registry,
         git_service=git_service,
@@ -178,7 +175,28 @@ async def lifespan(_app: FastAPI):
                     _systemlog.info("startup notification sent", chat_id=chat_id)
             except Exception:
                 _systemlog.exception("startup notification failed", chat_id=chat_id)
+
+
+async def _run_startup_side_effects_in_background(
+    instances: list[BotInstance], adv: AdvancedSettings
+) -> None:
+    try:
+        await asyncio.to_thread(_run_startup_side_effects, instances, adv)
+    except Exception:
+        _systemlog.exception("startup side effects failed")
+
+
+@asynccontextmanager
+async def lifespan(_app: FastAPI):
+    instances = bot_instance_manager.list_all()
+    startup_task = asyncio.create_task(
+        _run_startup_side_effects_in_background(instances, advanced_settings_store.get())
+    )
     yield
+    if not startup_task.done():
+        startup_task.cancel()
+    with suppress(asyncio.CancelledError):
+        await startup_task
     shutdown_instances = bot_instance_manager.list_all()
     shutdown_chat_total = sum(len(inst.auth_service.allowed_chat_ids) for inst in shutdown_instances)
     _systemlog.info("lifespan shutdown notifying allowed chats count=%d", shutdown_chat_total)

{remote_coder-0.5.0 → remote_coder-0.5.2}/app/monitoring/git.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 from pathlib import Path
 
 from app.git.service import GitWorktreeService
+from app.telegram.lists import render_labeled_list
 
 
 TELEGRAM_SAFE_LEN = 3800
@@ -24,16 +25,19 @@ def format_branch_monitor(
     except RuntimeError as exc:
         return f"/monitor branch failed: {exc}"
 
-    header = (
-        f"Branch monitor\n"
-        f"Project: {project_name}\n"
-        f"root: {root}\n"
-        f"Remote: {remote}\n"
-        f"Current checkout: {current}\n"
-        f"Local branches: {local_n}\n"
-        f"{remote} remote-tracking branches: {remote_n}\n\n"
+    summary_rows = [
+        ("Project", project_name),
+        ("root", str(root)),
+        ("Remote", remote),
+        ("Current checkout", current),
+        ("Local branches", str(local_n)),
+        ("Remote-tracking branches", str(remote_n)),
+    ]
+    header = "Branch monitor\n" + render_labeled_list(summary_rows) + "\n\n"
+    body = (
+        f"Local branches\n{_render_text_list(local_block)}\n\n"
+        f"Remote branches\n{_render_text_list(remote_block)}"
     )
-    body = f"[Local]\n{local_block}\n\n[{remote} remote]\n{remote_block}"
     text = header + body
     if len(text) > max_len:
         text = text[:max_len].rstrip() + "\n\n...(truncated for message length)"
@@ -87,17 +91,31 @@ def format_worktree_monitor(
     if len(entries) > max_detail:
         extra = f"\n...({len(entries) - max_detail} more omitted)"
 
+    summary_rows = [
+        ("Project", project_name),
+        ("root", str(root)),
+        ("Managed base directory", str(managed_base)),
+        ("Total worktrees", str(len(entries))),
+        ("Detached worktrees", str(detached_n)),
+        ("Managed candidates", str(managed_n)),
+    ]
     lines = [
         "Worktree monitor",
-        f"Project: {project_name}",
-        f"root: {root}",
-        f"Managed base directory (worktree_base): {managed_base}",
-        f"Total worktrees: {len(entries)}",
-        f"Detached worktrees: {detached_n}",
-        f"Managed candidates (remote-*, base, _rebase_ops): {managed_n}",
+        render_labeled_list(summary_rows),
         "",
-        "[Entries]",
+        "Worktree entries",
         *detail_lines,
         extra,
     ]
     return "\n".join(lines).strip()
+
+
+def _render_text_list(text: str) -> str:
+    items: list[str] = []
+    for raw in text.splitlines():
+        item = raw.strip()
+        if item.startswith("* "):
+            item = item[2:]
+        if item:
+            items.append(f"- {item}")
+    return "\n".join(items)

remote_coder-0.5.2/app/monitoring/memory.py

@@ -0,0 +1,30 @@
+from __future__ import annotations
+
+from app.telegram.conversation import ConversationDbChatStats
+from app.telegram.lists import render_labeled_list
+
+
+def format_memory_monitor(stats: ConversationDbChatStats, project: str, chat_id: int) -> str:
+    size_kb = stats.db_size_bytes / 1024.0 if stats.db_size_bytes else 0.0
+    summary_rows: list[tuple[str, str]] = [
+        ("Project", project),
+        ("chat_id", str(chat_id)),
+        ("DB path", str(stats.db_path)),
+        ("DB exists", "yes" if stats.db_exists else "no"),
+        ("DB size", f"{size_kb:.2f} KiB ({stats.db_size_bytes} bytes)"),
+        ("Rows for this chat", str(stats.total_rows)),
+        ("Sessions", str(stats.session_count)),
+    ]
+    if stats.rows_by_role:
+        role_rows = [(role, str(count)) for role, count in sorted(stats.rows_by_role.items())]
+    else:
+        role_rows = [("(none)", "0")]
+    return "\n".join(
+        [
+            "Memory (SQLite)",
+            render_labeled_list(summary_rows),
+            "",
+            "Rows by role",
+            render_labeled_list(role_rows),
+        ]
+    )