ticlawk 0.1.17-dev.6 → 0.1.17-dev.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ticlawk",
-  "version": "0.1.17-dev.6",
+  "version": "0.1.17-dev.7",
   "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/goal-step-prompt.mjs

@@ -15,10 +15,10 @@ import { buildEnvelopeTarget, buildCharterBlock } from './wake-prompt.mjs';
 const STEP_GUIDES = {
   gap_analysis: {
     title: 'GAP ANALYSIS',
-    body: `Compare the current state of the work against the goal and success criteria. Read whatever you need (charter, dashboard, task board, repo, prior messages) to judge where things actually stand. The dashboard is the owner's at-a-glance visualization of how far this goal has progressed — this step owns keeping it true to reality: if a durable goal has no dashboard yet, create it (\`ticlawk dashboard set\`); if overall progress has moved materially, refresh its content/data. See SURFACES.md.
-- If there is concrete executable work toward the goal, first make sure the next unit exists as a task (create/assign it with \`ticlawk task ...\` when a task fits), then report outcome=gap.
-- If the goal/milestone is fully met with no meaningful gap, make sure the dashboard reflects the completed state, then report outcome=no_gap. (The completed result is something the owner is waiting on — surface it per the briefing rule below.)
-- If closing the gap depends on a future or external state that nobody can act on right now, schedule a reminder for the resume condition, then report outcome=wait.`,
+    body: `Compare the current state against the goal and success criteria. The [goal_context] block above gives you the open tasks, active reminders, and dashboard state — judge from it; read the charter/repo/prior messages only for what it doesn't cover. The dashboard is the owner's at-a-glance visualization of how far this goal has progressed — this step owns keeping it true to reality: create it if a durable goal has none, refresh it when progress moved materially (\`ticlawk dashboard set\`; see SURFACES.md).
+- If there is concrete work to do NOW, make sure the next unit exists as a task (\`ticlawk task ...\`), then report outcome=gap.
+- If nothing needs doing this instant but the goal is ONGOING/STANDING — its job is to keep something maintained and work recurs (e.g. an active recurring reminder above already covers the next occurrence) — report outcome=wait. Do NOT report no_gap for a standing goal: it has no "done", and parking on no_gap would stop it from waking at the next occurrence. If nothing is scheduled to resume it yet, schedule a reminder first, then report wait.
+- Report outcome=no_gap ONLY if the goal is genuinely, permanently met and will never need action again (an achievement goal that is finished). The completed result is something the owner is waiting on — surface it per the briefing rule below.`,
     outcomes: ['gap', 'no_gap', 'wait'],
   },
   execute: {
@@ -48,6 +48,31 @@ function readPayload(msg) {
   };
 }
 
+// Per-step context: the claim attaches msg.goal_context (open tasks, active
+// reminders, current task, dashboard) for transition deliveries. Render the
+// slice THIS step needs so each step decides on facts, not guesses.
+function buildGoalContextBlock(msg, step) {
+  const gc = msg && msg.goal_context && typeof msg.goal_context === 'object' ? msg.goal_context : null;
+  if (!gc) return '';
+  const lines = ['[goal_context] Current state for this goal (given to you — use it, do not re-derive):'];
+  if (step === 'gap_analysis' || !STEP_GUIDES[step]) {
+    const tasks = Array.isArray(gc.open_tasks) ? gc.open_tasks : [];
+    const rems = Array.isArray(gc.active_reminders) ? gc.active_reminders : [];
+    lines.push(`- open tasks (${tasks.length}): ${tasks.length
+      ? tasks.map((t) => `#${t.number} ${t.title} [${t.status}]`).join('; ')
+      : 'none'}`);
+    lines.push(`- active reminders (${rems.length}): ${rems.length
+      ? rems.map((r) => `"${r.title}" @ ${r.fire_at}${r.recurrence ? ' (recurring)' : ''}`).join('; ')
+      : 'none'}`);
+    lines.push(`- dashboard: ${gc.dashboard ? 'exists' : 'none yet'}`);
+  } else {
+    const ct = gc.current_task;
+    lines.push(ct ? `- current task: #${ct.number} ${ct.title} [${ct.status}]` : '- current task: (none set)');
+  }
+  lines.push('[/goal_context]');
+  return lines.join('\n');
+}
+
 function buildGoalStepHeader(msg, { step, transitionId, goalVersion, kind }) {
   const target = buildEnvelopeTarget(msg);
   const time = msg.created_at || new Date().toISOString();
@@ -66,6 +91,8 @@ export function buildGoalStepPrompt(msg) {
 
   const sections = [];
   if (charterBlock) sections.push(charterBlock);
+  const goalContextBlock = buildGoalContextBlock(msg, step);
+  if (goalContextBlock) sections.push(goalContextBlock);
 
   if (guide) {
     sections.push([