ticlawk 0.1.16-dev.29 → 0.1.16-dev.30

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticlawk",
-  "version": "0.1.16-dev.29",
+  "version": "0.1.16-dev.30",
   "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

@@ -11,8 +11,8 @@ Use this in DMs, and in groups where your conversation role is admin or owner.
 
 ## Goal Setup When No Specific Goal Exists
 
-- When the current conversation has no goal, briefly decide whether the owner may want an ongoing conversation goal. Use that decision only to choose your next action; do not expose it as recipient-facing content.
-- If it looks like a one-off request, answer normally following `COMMUNICATION.md`. If the owner may want an ongoing goal, ask naturally following `COMMUNICATION.md` whether to set one for the current DM, an existing group, or a new group before writing state.
+- When the current conversation has no goal, decide whether the current message is one-off or may be starting, clarifying, or changing an ongoing goal. Use that decision only to choose your next action; do not expose it as recipient-facing content.
+- Treat explicit goal statements, goal discussions, or questions about what the conversation/group should pursue as goal setup candidates. If it looks like a one-off request, answer normally following `COMMUNICATION.md`. Otherwise ask naturally following `COMMUNICATION.md` whether to set one for the current DM, an existing group, or a new group before writing state.
 - Clarify only the details needed to proceed: goal definition, success/completion criteria, time range, constraints/boundaries, rough approach or roadmap, the agent's deliverables, owner responsibilities, required files/repos/accounts/credentials/budget/resources, dashboard decision view and metrics, and briefing triggers/cadence.
 - Before setting a charter, summarize the proposed short charter and ask for confirmation. Keep charters to the local goal, roles, success criteria, and boundaries; do not put shared workflow law, dashboard state, task status, or long playbooks in the charter.
 - After confirmation, write the charter if you have scope authority. Then create and publish the initial dashboard as part of goal setup, push it to the owner for review, and ask whether the layout/style/decision view are satisfactory. Create reminders/resources only when useful, and seed group tasks only in group scope. Then enter the normal goal loop.

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

@@ -85,18 +85,40 @@ export function buildGroupContextBlock(msg) {
 export function buildCharterBlock(msg) {
   const charter = (msg.conversation_charter || '').trim();
   if (!charter) return '';
+  const authorityLine = hasGoalAuthority(msg)
+    ? 'Use it as the current goal and role spec. If the owner appears to change the goal, read GOAL_AUTHORITY.md and follow the goal-change flow before updating state.'
+    : 'Use it as current group goal and role context. The group admin owns charter and dashboard changes unless they explicitly delegate them.';
   return promptBlock(`
-Goal and role assignments for this conversation:
+[conversation_goal]
+Current charter for this conversation:
 ${charter}
+
+${authorityLine}
+[/conversation_goal]
 `);
 }
 
 export function buildGoalStateBlock(msg) {
   if ((msg.conversation_charter || '').trim()) return '';
   const convType = msg.conversation_type || 'dm';
-  return convType === 'group'
-    ? 'This group has no specific goal right now.'
-    : 'This conversation has no specific goal right now.';
+  const subject = convType === 'group' ? 'This group' : 'This conversation';
+  const authorityLine = hasGoalAuthority(msg)
+    ? 'If this message may be starting, clarifying, or changing an ongoing goal, read GOAL_AUTHORITY.md "Goal Setup When No Specific Goal Exists" and follow it to propose/confirm the goal before writing charter/dashboard state. If it is clearly one-off, answer normally.'
+    : 'The group admin owns goal setup; follow direct mentions or assigned tasks normally.';
+  return promptBlock(`
+[conversation_goal]
+${subject} does not have a chartered goal yet.
+${authorityLine}
+[/conversation_goal]
+`);
+}
+
+function hasGoalAuthority(msg) {
+  const convType = msg.conversation_type || 'dm';
+  if (convType !== 'group') return true;
+  if (msg.recipient_is_conversation_admin === true) return true;
+  const recipientRole = String(msg.recipient_conversation_role || msg.recipient_role || '').trim().toLowerCase();
+  return recipientRole === 'admin' || recipientRole === 'owner';
 }
 
 export function buildQuoteBlock(msg, target = '') {
@@ -129,6 +151,12 @@ function senderDescription(msg) {
   return sender ? `@${sender}, ${type}` : type;
 }
 
+function senderFactDescription(msg) {
+  const type = msg.sender_type === 'agent' ? 'agent' : 'human user';
+  const sender = msg.sender_display_name || msg.sender_user_id || msg.sender_agent_id || '';
+  return sender ? `@${sender}, ${type}` : type;
+}
+
 function conversationLabel(msg, target) {
   const convType = msg.conversation_type || 'dm';
   if (convType === 'dm') return 'a one-on-one conversation';
@@ -139,16 +167,17 @@ function buildMessageSummary(msg, target) {
   const convType = msg.conversation_type || 'dm';
   const reason = normalizeDeliveryReasonForPrompt(msg.reason || '');
   const sender = senderDescription(msg);
+  const senderFact = senderFactDescription(msg);
   const where = conversationLabel(msg, target);
 
   if (convType === 'dm') {
     return `This is a one-on-one message from ${sender}.`;
   }
   if (reason === 'assignment') {
-    return `This message assigns or routes work to you in ${where}.\nSender: ${sender}`;
+    return `This message assigns or routes work to you in ${where}.\nSender: ${senderFact}`;
   }
   if (reason === 'ambient') {
-    return `This message was shared as background context in ${where}.\nIt is not assigned work.\nSender: ${sender}`;
+    return `Sender: ${senderFact}`;
   }
   if (reason === 'mention') {
     return `You were mentioned in ${where} by ${sender}.`;
@@ -157,7 +186,7 @@ function buildMessageSummary(msg, target) {
     return `This is a reply in ${where} from ${sender}.`;
   }
   if (reason === 'manual') {
-    return `This is a manual wake-up or reminder for ${where}.\nSource: ${sender}`;
+    return `This is a manual wake-up or reminder for ${where}.\nSource: ${senderFact}`;
   }
   return `This is a message in ${where} from ${sender}.`;
 }