talking-stick 0.4.5 → 0.4.6

package/dist/db.js

@@ -114,6 +114,13 @@ const migrations = [
       ALTER TABLE room_members ADD COLUMN harness_pid INTEGER;
       ALTER TABLE room_members ADD COLUMN harness_process_started_at TEXT;
     `
+    },
+    {
+        id: 7,
+        name: "room_member_last_park_hint_event_seq",
+        up: `
+      ALTER TABLE room_members ADD COLUMN last_park_hint_event_seq INTEGER;
+    `
     }
 ];
 export function resolveDatabasePath(options = {}) {

package/dist/service.js

@@ -665,6 +665,24 @@ export class TalkingStickService {
         if (!room.owner && !room.reserved_for) {
             const autoClaim = input.auto_claim ?? true;
             if (!autoClaim) {
+                if (room.pending_handoff_event_seq) {
+                    const member = this.getMember(input.room_id, input.agent_id);
+                    const alreadyHinted = member?.last_park_hint_event_seq === room.pending_handoff_event_seq;
+                    if (!alreadyHinted) {
+                        this.recordParkHint(input.room_id, input.agent_id, room.pending_handoff_event_seq);
+                        return {
+                            status: "not_yet",
+                            room_state: inspection.state,
+                            turn_id: room.turn_id,
+                            current_owner: room.owner ?? undefined,
+                            reserved_for: room.reserved_for ?? undefined,
+                            lease_expires_at: room.lease_expires_at ?? undefined,
+                            claim_expires_at: room.claim_expires_at ?? undefined,
+                            reason: "auto_claim_disabled",
+                            hint: "A pending handoff is waiting in this idle room, but park mode does not auto-claim. Run `tt wait --json` to pick it up, or ask for an explicit assignment."
+                        };
+                    }
+                }
                 return {
                     status: "not_yet",
                     room_state: inspection.state,
@@ -672,9 +690,7 @@ export class TalkingStickService {
                     current_owner: room.owner ?? undefined,
                     reserved_for: room.reserved_for ?? undefined,
                     lease_expires_at: room.lease_expires_at ?? undefined,
-                    claim_expires_at: room.claim_expires_at ?? undefined,
-                    reason: "auto_claim_disabled",
-                    hint: "Idle room left unclaimed because park mode disables auto-claim. If work is pending, run `tt wait --json` or ask for an explicit assignment."
+                    claim_expires_at: room.claim_expires_at ?? undefined
                 };
             }
             if (this.shouldDeferIdleClaim(room, input.agent_id, now)) {
@@ -1010,6 +1026,15 @@ export class TalkingStickService {
             throw new ProtocolError("unknown_member", "Agent must join the room before using this tool.", { to_agent_id: agentId });
         }
     }
+    recordParkHint(roomId, agentId, pendingHandoffEventSeq) {
+        this.db
+            .prepare(`
+        UPDATE room_members
+        SET last_park_hint_event_seq = ?
+        WHERE room_id = ? AND agent_id = ?
+      `)
+            .run(pendingHandoffEventSeq, roomId, agentId);
+    }
     touchWaitingMember(roomId, agentId, timestamp) {
         const result = this.db
             .prepare(`

package/docs/releases/0.4.6.md

@@ -0,0 +1,20 @@
+# Talking Stick 0.4.6
+
+Date: 2026-05-12
+
+## Added
+- **`room_members.last_park_hint_event_seq`.** New nullable INTEGER column (migration 7) tracking which pending-handoff event sequence a member has already been hinted about via park mode. Used to give the `auto_claim_disabled` hint at most once per (member, pending handoff) pair.
+
+## Fixed
+- **Park no longer spins on truly idle rooms.** `tt wait --park` short-returns with `reason: auto_claim_disabled` and a hint only the first time a member parks against a given pending handoff in an idle room. Subsequent parks by the same member against the same pending handoff long-poll quietly. Truly idle (no pending handoff) always long-polls. A fresh pending handoff (newer event sequence) hints again, and each member is hinted independently. Previously the short-return fired on every park call, which kept a naive re-park loop spinning even after the agent saw the hint.
+
+## Verification
+
+```bash
+npm run typecheck
+npm test
+npm run build
+node dist/cli.js --help
+git diff --check
+npm pack --dry-run
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "talking-stick",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "CLI coordination tool for path-scoped agent handoffs.",
   "type": "module",
   "bin": {