sentinelayer-cli 0.35.1 → 0.35.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sentinelayer-cli",
-  "version": "0.35.1",
+  "version": "0.35.3",
   "description": "Scaffold Sentinelayer spec/prompt/guide artifacts with secure browser auth and token bootstrap.",
   "type": "module",
   "scripts": {

package/src/commands/session.js

@@ -1851,6 +1851,23 @@ function listenerPresenceHeartbeatFingerprint(lifecycle = {}) {
   );
 }
 
+export function listenerLifecycleIdempotencyStep(lifecycle = {}) {
+  const lifecycleType = normalizeString(lifecycle?.type) || "heartbeat";
+  const heartbeatCount = Number(lifecycle?.heartbeatCount);
+  if (
+    lifecycleType === "heartbeat" &&
+    Number.isInteger(heartbeatCount) &&
+    heartbeatCount > 0
+  ) {
+    return heartbeatCount;
+  }
+  const pollCount = Number(lifecycle?.pollCount);
+  if (Number.isInteger(pollCount) && pollCount >= 0) {
+    return pollCount;
+  }
+  return 0;
+}
+
 export function shouldPublishListenerPresenceHeartbeat({
   lifecycle = {},
   nowMs = Date.now(),
@@ -1900,6 +1917,10 @@ async function publishListenerPresenceEvent({
 } = {}) {
   const normalizedType = normalizeString(lifecycle.type) || "heartbeat";
   const eventName = listenerLifecycleEventName(normalizedType);
+  const idempotencyStep = listenerLifecycleIdempotencyStep({
+    ...lifecycle,
+    type: normalizedType,
+  });
   const identity = inferSessionAgentIdentity({
     agentId,
     model: agentModel,
@@ -1918,8 +1939,8 @@ async function publishListenerPresenceEvent({
       provider: normalizeString(identity.provider) || undefined,
       clientKind: normalizeString(identity.clientKind) || "cli",
     },
-    eventId: `session-listener-${listenerId}-${normalizedType}-${lifecycle.pollCount ?? 0}`,
-    idempotencyToken: `session-listener:${listenerId}:${normalizedType}:${lifecycle.pollCount ?? 0}`,
+    eventId: `session-listener-${listenerId}-${normalizedType}-${idempotencyStep}`,
+    idempotencyToken: `session-listener:${listenerId}:${normalizedType}:${idempotencyStep}`,
     payload: compactPayload({
       source: "session_listen",
       listenerId,
@@ -1930,6 +1951,7 @@ async function publishListenerPresenceEvent({
       cursorSuffix: lifecycle.cursorSuffix,
       cursorSource: lifecycle.cursorSource,
       pollCount: lifecycle.pollCount,
+      heartbeatCount: lifecycle.heartbeatCount,
       matched: lifecycle.matched,
       emitted: lifecycle.emitted,
       persistedCursor: lifecycle.persistedCursor,

package/src/session/listener.js

@@ -292,6 +292,7 @@ export async function listenSessionEvents({
   let activeTransport = normalizedTransport === "poll" ? "poll" : "stream";
   let streamAttempted = false;
   let streamFallbackReason = "";
+  let heartbeatCount = 0;
   let catchupNotified = false;
   let catchupEventCount = 0;
   let catchupMatchingEventCount = 0;
@@ -340,6 +341,7 @@ export async function listenSessionEvents({
     cursor: cursor || null,
     cursorSuffix,
     pollCount,
+    heartbeatCount,
     matched,
     emitted,
     persistedCursor,
@@ -474,6 +476,7 @@ export async function listenSessionEvents({
   }
 
   async function notifyHeartbeat({ stopping = false, nextPollMs = null } = {}) {
+    heartbeatCount += 1;
     const heartbeatAtMs = Number(_nowMs()) || Date.now();
     const humanActive = isRecentActivity(lastHumanActivityMs, heartbeatAtMs, activeWindowMs);
     await notifyLifecycle(

package/src/session/recap.js

@@ -786,7 +786,7 @@ function buildRecapText({
 function buildTaskLedgerText(taskLedger = emptyTaskLedgerSummary()) {
   const total = Number(taskLedger.total || 0);
   if (!total) {
-    return "Tasks: none queued";
+    return "Session tasks: none queued";
   }
   const active = Number(taskLedger.active || 0);
   const counts = [
@@ -813,7 +813,7 @@ function buildTaskLedgerText(taskLedger = emptyTaskLedgerSummary()) {
           .map((task) => `${task.priority} ${task.status} ${task.owner}: ${task.task}`)
           .join(" | ")}`
       : "";
-  return [`Tasks: ${active} active of ${total} total (${counts})`, ownerText, recentText]
+  return [`Session tasks: ${active} active of ${total} total (${counts})`, ownerText, recentText]
     .filter(Boolean)
     .join(". ");
 }
@@ -849,7 +849,7 @@ function buildWorkPlanText(workPlan = emptyWorkPlanSummary()) {
       suppressionReason === "historical_generic_plan_section"
         ? "Current/next items suppressed because this generic plan is mostly historical completed work."
         : "Current/next items suppressed because the plan file is large.";
-    return `Plan: ${open} open / ${completed} done in ${sourceWindowText}${sourceReasonText}. ${suppressionText}`;
+    return `Workspace plan: ${open} open / ${completed} done in ${sourceWindowText}${sourceReasonText}. ${suppressionText}`;
   }
   const currentSection = normalizeString(workPlan.currentSection);
   const currentText = currentSection ? ` Current: ${currentSection}.` : "";
@@ -866,7 +866,7 @@ function buildWorkPlanText(workPlan = emptyWorkPlanSummary()) {
           .join("; ")}.`
       : "";
   const truncatedText = workPlan.truncated ? " Recent window only." : "";
-  return `Plan: ${open} open / ${completed} done in ${sourceText}${sourceReasonText}.${currentText}${nextText}${truncatedText}`;
+  return `Workspace plan: ${open} open / ${completed} done in ${sourceText}${sourceReasonText}.${currentText}${nextText}${truncatedText}`;
 }
 
 function roundCurrency(value) {