ticlawk 0.1.16-dev.34 → 0.1.16-dev.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticlawk",
-  "version": "0.1.16-dev.34",
+  "version": "0.1.16-dev.35",
   "description": "Local connector that links agent harnesses (Claude Code, Codex, OpenClaw, opencode, Pi) to the Ticlawk mobile app.",
   "type": "module",
   "main": "ticlawk.mjs",

package/src/runtimes/_shared/handbook/GOAL_AUTHORITY.md

@@ -8,6 +8,8 @@ Use this in DMs, and in groups where your conversation role is admin or owner.
 
 - You are responsible for driving the conversation toward its goal, not only replying to isolated messages.
 - Maintain or infer the current goal from the direct ask, charter, dashboard/briefing quote, task board, and conversation context.
+- Each turn, first handle the incoming message: reply to the user and do what it asks, sending the result. That is not the end of the turn — then run the goal loop, even if the message was only a quick question.
+- If a goal exists, run the loop and drive any gap (see Goal Loop and Gap States); if none exists, decide whether this message warrants setting one (see Goal Setup When No Specific Goal Exists). The turn ends only when the loop reaches `no_gap` or `wait`.
 
 ## Goal Setup When No Specific Goal Exists
 

package/src/runtimes/_shared/standing-prompt.mjs

@@ -82,19 +82,43 @@ function buildCurrentConversationGuide(ctx = {}) {
   return lines.join('\n');
 }
 
+const FILE_DESCRIPTIONS = {
+  'MEMORY.md': 'your durable memory.',
+  'GOAL_AUTHORITY.md': 'it covers our goal-driven loop: what to do whether you have a goal, have none, or got a quick question.',
+  'BASICS.md': 'workspace and work basics.',
+  'COMMUNICATION.md': 'replying via the ticlawk CLI.',
+  'COLLABORATION.md': 'DM/group conduct.',
+  'GOAL_TASK_CORE.md': 'goal/task concepts.',
+  'DM_SCOPE.md': 'DM goal scope.',
+  'SURFACES.md': 'dashboards, briefings, shared tools.',
+  'GROUP_ADMIN_SCOPE.md': 'group admin scope.',
+  'GROUP_MEMBER_SCOPE.md': 'group member scope.',
+  'TASK_WORKER.md': 'executing assigned tasks.',
+};
+
+// Files re-read at the start of every turn, not just once per session.
+// MEMORY.md for continuity; GOAL_AUTHORITY.md so the goal loop runs each turn
+// (it only appears in goal-authority scopes).
+const EVERY_TURN_FILES = new Set(['MEMORY.md', 'GOAL_AUTHORITY.md']);
+
+function describeFile(name) {
+  const desc = FILE_DESCRIPTIONS[name];
+  return desc ? `\`${name}\` — ${desc}` : `\`${name}\``;
+}
+
 function buildReadInstructions(ctx = {}) {
   const files = buildReadFileNames(ctx);
-  const memoryFiles = files.filter((name) => name === 'MEMORY.md');
-  const handbookFiles = files.filter((name) => name !== 'MEMORY.md');
-  const memoryList = memoryFiles.map((name, index) => `${index + 1}. \`${name}\``).join('\n');
-  const handbookList = handbookFiles.map((name, index) => `${index + 1}. \`${name}\``).join('\n');
+  const everyTurn = files.filter((name) => EVERY_TURN_FILES.has(name));
+  const once = files.filter((name) => !EVERY_TURN_FILES.has(name));
+  const everyTurnList = everyTurn.map((name, index) => `${index + 1}. ${describeFile(name)}`).join('\n');
+  const onceList = once.map((name, index) => `${index + 1}. ${describeFile(name)}`).join('\n');
   return `To reply to the user or group, use \`ticlawk message send --target <target>\`. Normal assistant output is private and is not sent to the user. Details are in \`COMMUNICATION.md\`.
 
-Read this file every time before acting because it may be updated:
-${memoryList}
+Read these every turn before acting (they may have changed):
+${everyTurnList}
 
-Read these files if you haven't already. Otherwise, skip:
-${handbookList}`;
+Read these once if you haven't this session. Otherwise skip:
+${onceList}`;
 }
 
 function buildReadFileNames(ctx = {}) {