dsh-tg-bridge 1.4.1 → 1.5.1

package/README.md

@@ -13,6 +13,7 @@ blocks.
 - **Voice**: local faster-whisper, the transcript is shown before the answer.
 - **Photos**: sent to a vision-capable model; text and UI are recognized.
 - **Project per topic**: `/cd my-app`, and all turns run from that directory.
+- **Goal and checklist per topic**: `/goal`, `/task`; both survive restarts and are prepended to every turn.
 - **Live progress**: "⏳ Working..." with steps, a timer and the cache hit rate at the end.
 - **No lost messages**: a journal with acknowledgement and replay.
 - **Fail-fast**: when the quota runs out it switches to a free model right away.
@@ -157,6 +158,7 @@ Send the bot:
 
 ```
 Work:         /cd · /new · /stop · /send · /seed
+Goals:        /goal · /task
 Sessions:     /status · /sessions · /resume
 Models:       /models · /model · /prices
 Extensions:   /skills · /plugins · /plugin · /soul
@@ -204,6 +206,41 @@ and a line in `~/.dsh/profiles/headless/cordis.patch.yml`:
 The bridge checks the profile itself: if the line is missing, it does not write the task
 (it would just expire) and behaves as before, queueing the message.
 
+### Live thoughts
+
+The agent can leave a short decision trail inside the progress message instead of sending
+extra chat messages:
+
+```bash
+node ~/.dsh/tg-bridge/say.mjs --thought "checking why the watchdog fired twice"
+```
+
+The note is appended to `~/.dsh/tg-bridge/thoughts/<chat>_<thread>.jsonl`; the progress
+message shows the last two as `💭` lines. Inside a turn the chat and thread come from
+`DSH_TG_CHAT` / `DSH_TG_THREAD`, so the command needs no ids. `--thought` never sends a
+Telegram message on its own.
+
+### Goals and tasks
+
+A topic carries its own goal and checklist, so the aim survives `/new`, a
+restart and a different session:
+
+```
+/goal ship the release      set or replace the goal
+/goal                       show the goal and the checklist
+/task write the migration   add a task
+/task done 2                tick it off
+/task rm 2                  remove it
+/goal done                  close the goal (all tasks done)
+/goal clear                 delete the goal and its tasks
+```
+
+The bridge prepends the goal and the list to every turn, with the exact command
+that updates it (`goal.mjs`). The agent ticks tasks as it finishes them, and the
+next turn sees the new state. The bridge is the only writer of `state.json`: the
+agent drops a job file into `goal-jobs/` and the bridge applies it, so there is
+no lock race and no lost update.
+
 ## Security
 
 - `config.json`, `state.json`, `pending/`, logs are in `.gitignore` and never

package/bot-menu.mjs

@@ -36,6 +36,8 @@ const COMMANDS = [
   { command: 'prices', description: 'Цены моделей и что стоит текущая' },
   { command: 'send', description: 'Прислать файл из проекта в чат' },
   { command: 'seed', description: 'Засеять пустую тему текстом и закрепить' },
+  { command: 'goal', description: 'Цель темы: /goal <текст>, /goal done' },
+  { command: 'task', description: 'Задачи: /task <текст>, /task done <n>' },
   { command: 'sessions', description: 'Последние сессии' },
   { command: 'resume', description: 'Продолжить сессию по id' },
   { command: 'models', description: 'Список моделей' },
@@ -60,6 +62,8 @@ const COMMANDS_EN = [
   { command: 'prices', description: 'Model prices and the cost of the current one' },
   { command: 'send', description: 'Send a file from the project into the chat' },
   { command: 'seed', description: 'Seed an empty topic with text and pin it' },
+  { command: 'goal', description: 'Topic goal: /goal <text>, /goal done' },
+  { command: 'task', description: 'Checklist: /task <text>, /task done <n>' },
   { command: 'sessions', description: 'Recent sessions' },
   { command: 'resume', description: 'Continue a session by id' },
   { command: 'models', description: 'Available models' },
@@ -84,6 +88,8 @@ const COMMANDS_ZH = [
   { command: 'prices', description: '模型价格与当前模型花费' },
   { command: 'send', description: '把项目中的文件发送到聊天' },
   { command: 'seed', description: '用文本初始化空话题并置顶' },
+  { command: 'goal', description: '本话题目标：/goal <文本>、/goal done' },
+  { command: 'task', description: '任务清单：/task <文本>、/task done <n>' },
   { command: 'sessions', description: '最近的会话' },
   { command: 'resume', description: '按 id 继续会话' },
   { command: 'models', description: '可用模型' },

package/bridge.mjs

@@ -11,7 +11,7 @@ import {
   readdirSync, statSync, openSync, fsyncSync, closeSync, renameSync, writeFileSync as writeFd,
 } from 'node:fs';
 import { homedir } from 'node:os';
-import { join, basename, isAbsolute } from 'node:path';
+import { join, basename, isAbsolute, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 // Force IPv4 for every fetch. DNS returns an AAAA next to the A record, and
 // Happy Eyeballs happily picks the IPv6 path, which here costs ~5 s or dies
@@ -26,6 +26,7 @@ import { noticeIsObsolete } from './queue-notice.mjs';
 import { immediateKind } from './immediate.mjs';
 import { writeSteerJob } from './steer-queue.mjs';
 import { handleControl, CONTROL_COMMANDS, modelOf } from './control.mjs';
+import { drainGoalJobs, goalOf, renderPromptBlock } from './goals.mjs';
 import { renderPrices } from './prices.mjs';
 import { t, resolveLang } from './i18n.mjs';
 
@@ -34,11 +35,16 @@ const DSH_HOME = process.env.DSH_HOME || join(HOME, '.dsh');
 // State, config and logs live here. DSH_TG_HOME lets a checkout run with its own
 // directory instead of the default ~/.dsh/tg-bridge.
 const DIR = process.env.DSH_TG_HOME || join(DSH_HOME, 'tg-bridge');
+// Code directory can differ from DIR when the bridge is started by the DSH
+// plugin (code lives in the profile's node_modules, state stays in DIR).
+const SELF_DIR = dirname(fileURLToPath(import.meta.url));
+const GOAL_CMD = join(SELF_DIR, 'goal.mjs');
 const STATE = join(DIR, 'state.json');
 const LOG = join(DIR, 'bridge.log');
 const CRED = join(DSH_HOME, '.credentials.yaml');
 const PENDING_DIR = join(DIR, 'pending');
 const STEER_DIR = join(DIR, 'steer');
+const THOUGHT_DIR = join(DIR, 'thoughts');
 // The helper the agent calls to confirm an addition in the chat while the turn
 // is still running. Lives next to the bridge so an installed copy works too.
 const SAY = join(DIR, 'say.mjs');
@@ -140,6 +146,18 @@ function writeAtomic(path, text) {
 function saveState() {
   writeAtomic(STATE, JSON.stringify(state, null, 2));
 }
+
+// The agent updates the topic goal list by dropping a job file (goal.mjs);
+// the bridge is the only writer of state.json, so there is no lock race.
+const GOAL_DIR = join(DIR, 'goal-jobs');
+setInterval(() => {
+  try {
+    if (drainGoalJobs(state, GOAL_DIR, join(GOAL_DIR, 'done'))) saveState();
+  } catch (error) {
+    log(`goal job failed: ${error.message}`);
+  }
+}, 2000).unref();
+
 function log(line) {
   const text = `${new Date().toISOString()} ${line}\n`;
   try { appendFileSync(LOG, text, 'utf8'); } catch {}
@@ -718,6 +736,9 @@ function runTurn(task, sessionId, key = '', onEvent = null, extraArgs = [], cwd
       cwd: cwd && existsSync(cwd) ? cwd : config.cwd,
       env: {
         ...process.env,
+        DSH_TG_KEY: key,
+        DSH_TG_CHAT: String(key).split(':')[0] || '',
+        DSH_TG_THREAD: String(key).split(':')[1] || '0',
         ELECTRON_RUN_AS_NODE: '1',
         UNOROUTER_API_KEY: readSecret('UNOROUTER_API_KEY'),
         // Free fallback providers: their keys live next to the main one and are
@@ -854,6 +875,34 @@ async function startProgress(chatId, threadId, lang = 'ru') {
   let dirty = false;
   let timer = null;
 
+  // Short "💭" notes the agent appends with `say.mjs --thought`. The progress
+  // message shows the last two, so the person sees the decision trail without
+  // a second stream of chat messages.
+  const thoughtFile = join(THOUGHT_DIR, `${chatId}_${threadId || 0}.jsonl`);
+  let thoughts = [];
+  try {
+    mkdirSync(THOUGHT_DIR, { recursive: true });
+    writeFileSync(thoughtFile, '');
+  } catch {}
+  const thoughtTimer = setInterval(() => {
+    let next = [];
+    try {
+      next = readFileSync(thoughtFile, 'utf8')
+        .split('\n')
+        .filter(Boolean)
+        .slice(-2)
+        .map((line) => {
+          try { return String(JSON.parse(line).text || '').slice(0, 140); } catch { return ''; }
+        })
+        .filter(Boolean);
+    } catch {}
+    if (next.join('\n') !== thoughts.join('\n')) {
+      thoughts = next;
+      schedule();
+    }
+  }, 3000);
+  thoughtTimer.unref?.();
+
   const body = (final = false) => {
     const seconds = Math.round((Date.now() - started) / 1000);
     const head = final
@@ -863,6 +912,7 @@ async function startProgress(chatId, threadId, lang = 'ru') {
     // shell commands read as noise on a phone.
     const tail = steps.slice(-3).map((line) => `• ${line}`).join('\n');
     const more = steps.length > 3 ? `\n${t(lang, 'status.more', { n: steps.length - 3 })}` : '';
+    const mind = thoughts.length ? `\n${thoughts.map((line) => `💭 ${line}`).join('\n')}` : '';
     // The cache line belongs to the outcome, not to every intermediate edit.
     const cache = final && usage.cacheReadTokens
       ? `\n${t(lang, 'status.cacheLine', {
@@ -870,7 +920,7 @@ async function startProgress(chatId, threadId, lang = 'ru') {
         k: Math.round(usage.cacheReadTokens / 1000),
       })}`
       : '';
-    return (tail ? `${head}\n${tail}${more}${cache}` : `${head}${cache}`);
+    return (tail ? `${head}${mind}\n${tail}${more}${cache}` : `${head}${mind}${cache}`);
   };
 
   try {
@@ -952,6 +1002,7 @@ async function startProgress(chatId, threadId, lang = 'ru') {
     },
     async finish(result) {
       clearTimeout(timer);
+      clearInterval(thoughtTimer);
       if (result?.error) {
         // A failed turn leaves the status message as the error report and swaps
         // «Стоп» for «Повторить»: the person's next move is a retry, not a stop.
@@ -1230,6 +1281,11 @@ ${t(lang, 'help.body')}`,
   // Project directory bound to this topic (set with /cd); config.cwd otherwise.
   const cwd = (state.cwd && state.cwd[key]) || config.cwd;
 
+  // Desktop-style goal: the topic's goal and task list travel with every turn,
+  // so a fresh session after /new still knows what the project is aiming at.
+  const topicGoal = goalOf(state, key);
+  if (topicGoal) text = `${renderPromptBlock(topicGoal, key, GOAL_CMD)}\n\n---\n\n${text}`;
+
   // Live progress: one status message per turn, rewritten as the agent works.
   // Without it a long turn and a hung turn looked exactly alike in the chat.
   const progress = await startProgress(chatId, threadId, lang);

package/control.mjs

@@ -10,6 +10,7 @@ import { homedir } from 'node:os';
 import { join, basename } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { t, LANGS, normalizeLang } from './i18n.mjs';
+import { addTask, clearGoal, doneTask, finishGoal, goalOf, progressOf, removeTask, setGoal } from './goals.mjs';
 
 const HOME = homedir();
 const DSH_HOME = process.env.DSH_HOME || join(HOME, '.dsh');
@@ -346,6 +347,20 @@ function setSoul(text) {
 
 const fmt = (rows) => rows.map((row) => `  ${row}`).join('\n');
 
+/** Goal + task list as one message; empty list is shown, not hidden. */
+function goalView(goal, lang) {
+  const { done, total } = progressOf(goal);
+  const lines = [t(lang, 'goal.set', { text: goal.text })];
+  if (goal.tasks.length === 0) {
+    lines.push(t(lang, 'task.empty'));
+  } else {
+    goal.tasks.forEach((task, i) => lines.push(`${task.done ? '✅' : '⬜'} ${i + 1}. ${task.text}`));
+    lines.push(t(lang, 'goal.progress', { done, total }));
+  }
+  if (goal.done) lines.push(t(lang, 'goal.closed'));
+  return lines.join('\n');
+}
+
 /**
  * Handle one control command. Returns true when the message was a control
  * command and the caller must not run a turn.
@@ -353,7 +368,7 @@ const fmt = (rows) => rows.map((row) => `  ${row}`).join('\n');
 export const CONTROL_COMMANDS = [
   'status', 'models', 'model', 'sessions', 'resume', 'plugins', 'plugin',
   'skills', 'soul', 'restart', 'app', 'stop', 'new', 'seed', 'send', 'cd',
-  'prices', 'help', 'doctor', 'logs', 'lang',
+  'prices', 'help', 'doctor', 'logs', 'lang', 'goal', 'task',
 ];
 
 export async function handleControl(ctx) {
@@ -394,6 +409,13 @@ export async function handleControl(ctx) {
         const deskPlugins = pluginsOf('desktop');
         lines.splice(1, 0, `UI: desktop (${desk.provider}/${desk.model}) — плагинов ${deskPlugins.bundles.length}`);
       }
+      const currentGoal = goalOf(state, key);
+      if (currentGoal) {
+        const { done, total } = progressOf(currentGoal);
+        lines.push(t(lang || 'ru', 'status.goal', {
+          done, total, text: currentGoal.text.length > 60 ? `${currentGoal.text.slice(0, 59)}…` : currentGoal.text,
+        }));
+      }
       say(lines.join('\n'));
       return true;
     }
@@ -689,6 +711,69 @@ export async function handleControl(ctx) {
       return true;
     }
 
+    case '/goal': {
+      const L = lang || 'ru';
+      const body = (arg || '').trim();
+      const current = goalOf(state, key);
+      if (!body) {
+        say(current ? goalView(current, L) : t(L, 'goal.none'));
+        return true;
+      }
+      const word = body.toLowerCase();
+      if (word === 'help' || word === '?') {
+        say(t(L, 'goal.usage'));
+        return true;
+      }
+      if (word === 'done') {
+        const goal = finishGoal(state, key);
+        if (!goal) { say(t(L, 'goal.none')); return true; }
+        ctx.saveState();
+        say(goalView(goal, L));
+        return true;
+      }
+      if (word === 'clear') {
+        say(t(L, clearGoal(state, key) ? 'goal.cleared' : 'goal.none'));
+        if (goalOf(state, key) === null) ctx.saveState();
+        return true;
+      }
+      const goal = setGoal(state, key, body);
+      if (!goal) { say(t(L, 'goal.usage')); return true; }
+      ctx.saveState();
+      say(goalView(goal, L));
+      return true;
+    }
+
+    case '/task': {
+      const L = lang || 'ru';
+      const body = (arg || '').trim();
+      const current = goalOf(state, key);
+      if (!body) {
+        say(current ? goalView(current, L) : t(L, 'task.none'));
+        return true;
+      }
+      if (body.toLowerCase() === 'help' || body.toLowerCase() === '?') {
+        say(t(L, 'task.usage'));
+        return true;
+      }
+      const op = body.match(/^(done|rm|remove)\s+(\d+)$/i);
+      if (op) {
+        const n = Number(op[2]);
+        if (op[1].toLowerCase() === 'done') {
+          say(t(L, doneTask(state, key, n) ? 'task.done' : 'task.bad', { n }));
+        } else {
+          say(t(L, removeTask(state, key, n) ? 'task.removed' : 'task.bad', { n }));
+        }
+        ctx.saveState();
+        return true;
+      }
+      if (!current) setGoal(state, key, t(L, 'goal.default'));
+      const n = addTask(state, key, body);
+      if (!n) { say(t(L, 'task.usage')); return true; }
+      ctx.saveState();
+      say(`${t(L, 'task.added', { n })}\n${goalView(goalOf(state, key), L)}`);
+      return true;
+    }
+
     case '/new': {
       delete state.sessions[key];
       ctx.saveState();

package/goal.mjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+// Agent-facing helper for the topic goal list.
+//
+// The bridge owns state.json; this script only writes a job file that the
+// bridge drains on its next tick. That keeps one writer and no lock dance.
+//
+//   node goal.mjs --key <chat:thread> --status
+//   node goal.mjs --key <chat:thread> --add "write tests"
+//   node goal.mjs --key <chat:thread> --done 2
+//   node goal.mjs --key <chat:thread> --remove 2
+//   node goal.mjs --key <chat:thread> --set "new goal"
+//   node goal.mjs --key <chat:thread> --finish
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+// State lives where the bridge keeps it, even when this script is executed
+// from the profile's node_modules (plugin install).
+const DSH_HOME = process.env.DSH_HOME || join(homedir(), '.dsh');
+const DIR = process.env.DSH_TG_HOME || join(DSH_HOME, 'tg-bridge');
+const JOBS = join(DIR, 'goal-jobs');
+
+function arg(name) {
+  const i = process.argv.indexOf(`--${name}`);
+  return i >= 0 ? process.argv[i + 1] : undefined;
+}
+
+const key = arg('key');
+if (!key) {
+  console.error('usage: node goal.mjs --key <chat:thread> [--status|--add TEXT|--done N|--remove N|--set TEXT|--finish]');
+  process.exit(2);
+}
+
+function readState() {
+  try {
+    return JSON.parse(readFileSync(join(DIR, 'state.json'), 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+function show() {
+  const goal = readState().goals?.[key];
+  if (!goal) {
+    console.log('no goal for this topic');
+    return;
+  }
+  console.log(goal.done ? `[closed] ${goal.text}` : goal.text);
+  goal.tasks.forEach((t, i) => console.log(`${i + 1}. [${t.done ? 'x' : ' '}] ${t.text}`));
+  const done = goal.tasks.filter((t) => t.done).length;
+  console.log(`progress: ${done}/${goal.tasks.length}`);
+}
+
+if (process.argv.includes('--status')) {
+  show();
+  process.exit(0);
+}
+
+let op;
+if (process.argv.includes('--finish')) op = 'finish';
+else if (process.argv.includes('--clear')) op = 'clear';
+else if (process.argv.includes('--set')) op = 'set';
+else if (process.argv.includes('--add')) op = 'add';
+else if (process.argv.includes('--done')) op = 'done';
+else if (process.argv.includes('--remove')) op = 'remove';
+
+if (!op) {
+  console.error('nothing to do: pass --status, --set, --add, --done, --remove, --finish or --clear');
+  process.exit(2);
+}
+
+const job = { key, op, at: Date.now() };
+if (op === 'set') job.text = arg('set');
+if (op === 'add') job.text = arg('add');
+if (op === 'done') job.index = Number(arg('done'));
+if (op === 'remove') job.index = Number(arg('remove'));
+
+mkdirSync(JOBS, { recursive: true });
+const name = `${Date.now()}-${process.pid}-${Math.random().toString(36).slice(2, 7)}.json`;
+const tmp = join(JOBS, `${name}.tmp`);
+writeFileSync(tmp, JSON.stringify(job), 'utf8');
+renameSync(tmp, join(JOBS, name));
+console.log(`${op} queued`);

package/goals.mjs

@@ -0,0 +1,168 @@
+// Goal + task list for one Telegram topic.
+//
+// State lives in the bridge's state.json (keyed by `chat:thread`), so it
+// survives restarts and is visible to every turn. This module is pure: it
+// mutates a plain object and returns data, never sends messages. The bridge
+// injects the rendered block into the prompt; the agent updates it through
+// `goal.mjs`, which drops a job file the bridge applies.
+import { mkdirSync, readdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+export const MAX_TASKS = 30;
+export const MAX_GOAL_CHARS = 500;
+
+export function goalsOf(state) {
+  if (!state.goals || typeof state.goals !== 'object') state.goals = {};
+  return state.goals;
+}
+
+export function goalOf(state, key) {
+  return goalsOf(state)[key] || null;
+}
+
+/** Set or replace the goal text; keeps the existing task list. */
+export function setGoal(state, key, text) {
+  const clean = String(text || '').trim().slice(0, MAX_GOAL_CHARS);
+  if (!clean) return null;
+  const goals = goalsOf(state);
+  const now = new Date().toISOString();
+  goals[key] = {
+    text: clean,
+    tasks: goals[key]?.tasks || [],
+    done: false,
+    createdAt: goals[key]?.createdAt || now,
+    updatedAt: now,
+  };
+  return goals[key];
+}
+
+export function clearGoal(state, key) {
+  const goals = goalsOf(state);
+  if (!goals[key]) return false;
+  delete goals[key];
+  return true;
+}
+
+export function finishGoal(state, key) {
+  const goal = goalOf(state, key);
+  if (!goal) return null;
+  goal.done = true;
+  goal.updatedAt = new Date().toISOString();
+  goal.tasks = goal.tasks.map((t) => ({ ...t, done: true }));
+  return goal;
+}
+
+export function addTask(state, key, text) {
+  const clean = String(text || '').trim().slice(0, MAX_GOAL_CHARS);
+  if (!clean) return null;
+  const goal = goalOf(state, key);
+  if (!goal) return null;
+  if (goal.tasks.length >= MAX_TASKS) return null;
+  goal.tasks.push({ text: clean, done: false });
+  goal.updatedAt = new Date().toISOString();
+  return goal.tasks.length;
+}
+
+export function doneTask(state, key, index) {
+  const goal = goalOf(state, key);
+  const i = Number(index) - 1;
+  if (!goal || !Number.isInteger(i) || i < 0 || i >= goal.tasks.length) return false;
+  goal.tasks[i].done = true;
+  goal.updatedAt = new Date().toISOString();
+  return true;
+}
+
+export function removeTask(state, key, index) {
+  const goal = goalOf(state, key);
+  const i = Number(index) - 1;
+  if (!goal || !Number.isInteger(i) || i < 0 || i >= goal.tasks.length) return false;
+  goal.tasks.splice(i, 1);
+  goal.updatedAt = new Date().toISOString();
+  return true;
+}
+
+export function progressOf(goal) {
+  const total = goal?.tasks.length || 0;
+  const done = goal?.tasks.filter((t) => t.done).length || 0;
+  return { total, done };
+}
+
+/** Compact block prepended to the turn prompt. Empty string when no goal. */
+export function renderPromptBlock(goal, key, goalCmd) {
+  if (!goal) return '';
+  const lines = ['[Topic goal — set by the person in Telegram]', goal.done ? `${goal.text} (closed)` : goal.text];
+  if (goal.tasks.length > 0) {
+    lines.push('[Tasks]');
+    goal.tasks.forEach((task, i) => lines.push(`${i + 1}. [${task.done ? 'x' : ' '}] ${task.text}`));
+  }
+  lines.push(
+    '[How to update]',
+    `When a task is finished, run: node "${goalCmd}" --key "${key}" done <number>`,
+    'Do not repeat this block in your answer; report progress in one or two lines.',
+  );
+  return lines.join('\n');
+}
+
+/** Apply one job written by goal.mjs. Returns a short status string. */
+export function applyGoalJob(state, job) {
+  if (!job || typeof job.key !== 'string' || !job.key) return 'bad job: no key';
+  switch (job.op) {
+    case 'set':
+      return setGoal(state, job.key, job.text) ? 'goal set' : 'empty goal';
+    case 'clear':
+      return clearGoal(state, job.key) ? 'goal cleared' : 'no goal';
+    case 'finish': {
+      const goal = finishGoal(state, job.key);
+      return goal ? 'goal closed' : 'no goal';
+    }
+    case 'add':
+      if (!goalOf(state, job.key)) setGoal(state, job.key, 'Tasks');
+      return addTask(state, job.key, job.text) ? 'task added' : 'task rejected';
+    case 'done':
+      return doneTask(state, job.key, job.index) ? 'task done' : 'bad task number';
+    case 'remove':
+      return removeTask(state, job.key, job.index) ? 'task removed' : 'bad task number';
+    default:
+      return 'unknown op';
+  }
+}
+
+/**
+ * Drain `dir`: apply every *.json job, move it to done/ or failed/.
+ * Returns the number of applied jobs.
+ */
+export function drainGoalJobs(state, dir, doneDir) {
+  let files;
+  try {
+    files = readdirSync(dir).filter((f) => f.endsWith('.json'));
+  } catch {
+    return 0;
+  }
+  if (files.length === 0) return 0;
+  mkdirSync(doneDir, { recursive: true });
+  let applied = 0;
+  for (const file of files) {
+    const full = join(dir, file);
+    let job;
+    try {
+      job = JSON.parse(readFileSync(full, 'utf8'));
+    } catch {
+      // Unparseable: move it out of the inbox instead of retrying forever.
+      try {
+        renameSync(full, join(doneDir, `failed-${file}`));
+      } catch {}
+      continue;
+    }
+    const status = applyGoalJob(state, job);
+    const ok = !status.startsWith('bad') && status !== 'no goal' && status !== 'empty goal' && status !== 'task rejected';
+    if (ok) applied += 1;
+    try {
+      renameSync(full, join(doneDir, `${ok ? '' : 'failed-'}${file}`));
+    } catch {
+      try {
+        unlinkSync(full);
+      } catch {}
+    }
+  }
+  return applied;
+}

package/i18n.mjs

@@ -19,7 +19,7 @@ const DICT = {
     'status.failed': 'Turn failed',
     'status.queued': 'queued',
     'status.stop': 'Stop',
-    'help.body': "Write the task as plain text. Each forum topic is its own session:\n\nWork: /cd \u003cproject\u003e · /new · /stop · /send \u003cfile\u003e · /seed \u003ctext\u003e\nSessions: /status · /sessions [n] · /resume \u003cid\u003e\nModels: /models · /model \u003cid\u003e · /prices\nExtensions: /skills · /plugins · /plugin add|remove · /soul\nOther: /lang · /doctor · /logs [errors|N] · /app · /restart · /help",
+    'help.body': "Write the task as plain text. Each forum topic is its own session:\n\nWork: /cd \u003cproject\u003e · /new · /stop · /send \u003cfile\u003e · /seed \u003ctext\u003e\nGoals: /goal · /task\nSessions: /status · /sessions [n] · /resume \u003cid\u003e\nModels: /models · /model \u003cid\u003e · /prices\nExtensions: /skills · /plugins · /plugin add|remove · /soul\nOther: /lang · /doctor · /logs [errors|N] · /app · /restart · /help",
     'btn.stop': 'Stop',
     'btn.logs': 'Logs',
     'btn.retry': 'Retry',
@@ -48,6 +48,21 @@ const DICT = {
     'cmd.cd.reset': 'Topic directory reset to the shared one.',
     'cmd.cd.none': 'No such directory: {path}',
     'cmd.new.done': 'New session in this topic. Context cleared.',
+    'goal.none': 'No goal in this topic. Set one: /goal <text>',
+    'goal.set': 'Goal: {text}',
+    'goal.default': 'Tasks',
+    'goal.closed': 'Goal closed.',
+    'goal.cleared': 'Goal and tasks cleared.',
+    'goal.progress': '{done}/{total} tasks done',
+    'goal.usage': 'Usage: /goal <text> | /goal done | /goal clear',
+    'task.none': 'No goal yet — set one with /goal <text>.',
+    'task.added': 'Task {n} added.',
+    'task.done': 'Task {n} done.',
+    'task.removed': 'Task {n} removed.',
+    'task.bad': 'No task {n}.',
+    'task.empty': 'No tasks yet — /task <text>.',
+    'task.usage': 'Usage: /task <text> | /task done <n> | /task rm <n>',
+    'status.goal': 'Goal: {done}/{total} · {text}',
     'cmd.stop.killed': 'Turn stopped.',
     'cmd.stop.nothing': 'Nothing to stop.',
     'menu.status': 'Sessions, model, active turns',
@@ -76,7 +91,7 @@ const DICT = {
     'status.failed': 'Ход не удался',
     'status.queued': 'в очереди',
     'status.stop': 'Стоп',
-    'help.body': "Задачу можно писать обычным текстом. Каждая ветка форума — отдельная сессия:\n\nРабота: /cd \u003cпроект\u003e · /new · /stop · /send \u003cфайл\u003e · /seed \u003cтекст\u003e\nСессии: /status · /sessions [n] · /resume \u003cid\u003e\nМодели: /models · /model \u003cid\u003e · /prices\nРасширения: /skills · /plugins · /plugin add|remove · /soul\nПрочее: /lang · /doctor · /logs [errors|N] · /app · /restart · /help",
+    'help.body': "Задачу можно писать обычным текстом. Каждая ветка форума — отдельная сессия:\n\nРабота: /cd \u003cпроект\u003e · /new · /stop · /send \u003cфайл\u003e · /seed \u003cтекст\u003e\nЦели: /goal · /task\nСессии: /status · /sessions [n] · /resume \u003cid\u003e\nМодели: /models · /model \u003cid\u003e · /prices\nРасширения: /skills · /plugins · /plugin add|remove · /soul\nПрочее: /lang · /doctor · /logs [errors|N] · /app · /restart · /help",
     'btn.stop': 'Стоп',
     'btn.logs': 'Логи',
     'btn.retry': 'Повторить',
@@ -105,6 +120,21 @@ const DICT = {
     'cmd.cd.reset': 'Каталог темы сброшен на общий.',
     'cmd.cd.none': 'Нет такого каталога: {path}',
     'cmd.new.done': 'Новая сессия в этой ветке. Контекст очищен.',
+    'goal.none': 'В этой теме нет цели. Задать: /goal <текст>',
+    'goal.set': 'Цель: {text}',
+    'goal.default': 'Задачи',
+    'goal.closed': 'Цель закрыта.',
+    'goal.cleared': 'Цель и задачи удалены.',
+    'goal.progress': 'Выполнено {done}/{total} задач',
+    'goal.usage': 'Использование: /goal <текст> | /goal done | /goal clear',
+    'task.none': 'Цели ещё нет — сначала /goal <текст>.',
+    'task.added': 'Задача {n} добавлена.',
+    'task.done': 'Задача {n} выполнена.',
+    'task.removed': 'Задача {n} удалена.',
+    'task.bad': 'Нет задачи {n}.',
+    'task.empty': 'Задач ещё нет — /task <текст>.',
+    'task.usage': 'Использование: /task <текст> | /task done <n> | /task rm <n>',
+    'status.goal': 'Цель: {done}/{total} · {text}',
     'cmd.stop.killed': 'Ход остановлен.',
     'cmd.stop.nothing': 'Нечего останавливать.',
     'menu.status': 'Сессии, модель, активные ходы',
@@ -133,7 +163,7 @@ const DICT = {
     'status.failed': '运行失败',
     'status.queued': '排队中',
     'status.stop': '停止',
-    'help.body': "任务直接以文本发送。每个论坛话题是一个独立会话：\n\n工作: /cd \u003c项目\u003e · /new · /stop · /send \u003c文件\u003e · /seed \u003c文本\u003e\n会话: /status · /sessions [n] · /resume \u003cid\u003e\n模型: /models · /model \u003cid\u003e · /prices\n扩展: /skills · /plugins · /plugin add|remove · /soul\n其他: /lang · /doctor · /logs [errors|N] · /app · /restart · /help",
+    'help.body': "任务直接以文本发送。每个论坛话题是一个独立会话：\n\n工作: /cd \u003c项目\u003e · /new · /stop · /send \u003c文件\u003e · /seed \u003c文本\u003e\n目标: /goal · /task\n会话: /status · /sessions [n] · /resume \u003cid\u003e\n模型: /models · /model \u003cid\u003e · /prices\n扩展: /skills · /plugins · /plugin add|remove · /soul\n其他: /lang · /doctor · /logs [errors|N] · /app · /restart · /help",
     'btn.stop': '停止',
     'btn.logs': '日志',
     'btn.retry': '重试',
@@ -162,6 +192,21 @@ const DICT = {
     'cmd.cd.reset': '话题目录已恢复为默认。',
     'cmd.cd.none': '目录不存在：{path}',
     'cmd.new.done': '已在本话题开始新会话，上下文已清空。',
+    'goal.none': '本话题还没有目标。设置：/goal <文本>',
+    'goal.set': '目标：{text}',
+    'goal.default': '任务',
+    'goal.closed': '目标已关闭。',
+    'goal.cleared': '目标和任务已清除。',
+    'goal.progress': '已完成 {done}/{total} 项任务',
+    'goal.usage': '用法：/goal <文本> | /goal done | /goal clear',
+    'task.none': '还没有目标——先 /goal <文本>。',
+    'task.added': '已添加任务 {n}。',
+    'task.done': '任务 {n} 已完成。',
+    'task.removed': '已删除任务 {n}。',
+    'task.bad': '没有任务 {n}。',
+    'task.empty': '还没有任务——/task <文本>。',
+    'task.usage': '用法：/task <文本> | /task done <n> | /task rm <n>',
+    'status.goal': '目标：{done}/{total} · {text}',
     'cmd.stop.killed': '已停止当前任务。',
     'cmd.stop.nothing': '没有可停止的任务。',
     'menu.status': '会话、模型、进行中的任务',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-tg-bridge",
-  "version": "1.4.1",
+  "version": "1.5.1",
   "description": "Telegram bridge for DeepSeek Harness: text, voice, photos and project-per-topic sessions without opening the desktop app",
   "type": "module",
   "main": "plugin-bridge.mjs",
@@ -44,6 +44,8 @@
     "plugin-bridge.mjs",
     "cordis.patch.yml",
     "control.mjs",
+    "goals.mjs",
+    "goal.mjs",
     "i18n.mjs",
     "prices.mjs",
     "setup.mjs",

package/say.mjs

@@ -7,16 +7,21 @@
 //
 //   node say.mjs --steer <job-id> "text"
 //   node say.mjs --chat <chat-id> [--thread <id>] "text"
+//   node say.mjs --thought "short note"   (chat/thread come from DSH_TG_CHAT/DSH_TG_THREAD)
+//
+// `--thought` does not send a message: it appends to the turn's thought file,
+// and the live progress message shows the last two notes as 💭 lines.
 //
 // With `--steer` the chat/thread come from the job file and an ack marker is
 // written, which suppresses the bridge's fallback line.
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 
 const DSH_HOME = process.env.DSH_HOME || join(homedir(), '.dsh');
 const STEER = join(DSH_HOME, 'tg-bridge', 'steer');
 const ACKS = join(STEER, 'acks');
+const THOUGHTS = join(DSH_HOME, 'tg-bridge', 'thoughts');
 
 function findToken() {
   const env = (process.env.DSH_TELEGRAM_BOT_TOKEN || '').trim();
@@ -39,18 +44,19 @@ function jobOf(id) {
 }
 
 function usage() {
-  console.error('usage: node say.mjs --steer <id> "text" | --chat <id> [--thread <id>] "text"');
+  console.error('usage: node say.mjs --steer <id> "text" | --chat <id> [--thread <id>] "text" | --thought "text"');
   process.exit(2);
 }
 
 function parse(argv) {
-  const out = { chatId: 0, threadId: 0, steer: '', text: '' };
+  const out = { chatId: 0, threadId: 0, steer: '', thought: false, text: '' };
   const rest = [];
   for (let i = 0; i < argv.length; i += 1) {
     const arg = argv[i];
     if (arg === '--steer') out.steer = argv[++i] || '';
     else if (arg === '--chat') out.chatId = Number(argv[++i] || 0);
     else if (arg === '--thread') out.threadId = Number(argv[++i] || 0);
+    else if (arg === '--thought') out.thought = true;
     else rest.push(arg);
   }
   out.text = rest.join(' ').trim();
@@ -61,8 +67,8 @@ async function main() {
   const args = parse(process.argv.slice(2));
   if (!args.text) usage();
 
-  let chatId = args.chatId;
-  let threadId = args.threadId;
+  let chatId = args.chatId || Number(process.env.DSH_TG_CHAT || 0);
+  let threadId = args.threadId || Number(process.env.DSH_TG_THREAD || 0);
   let jobPath = '';
   if (args.steer) {
     const found = jobOf(args.steer);
@@ -76,6 +82,19 @@ async function main() {
   }
   if (!chatId) usage();
 
+  if (args.thought) {
+    try {
+      mkdirSync(THOUGHTS, { recursive: true });
+      const file = join(THOUGHTS, `${chatId}_${threadId || 0}.jsonl`);
+      appendFileSync(file, `${JSON.stringify({ at: Date.now(), text: args.text })}\n`, 'utf8');
+      console.log(file);
+    } catch (error) {
+      console.error(String(error?.message ?? error));
+      process.exit(6);
+    }
+    return;
+  }
+
   const token = findToken();
   if (!token) {
     console.error('bot token not found (DSH_TELEGRAM_BOT_TOKEN or ~/.dsh/.credentials.yaml)');