agenr 1.9.0 → 1.9.1

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## [Unreleased]
 
+## [1.9.1] - 2026-04-12
+
+Supersession stall-recovery and review-order guard patch release.
+
+### Changed
+
+- **Supersession review order is now enforced at the tool boundary.** The supersession query tool now blocks widening into lower-confidence subject sweeps until the same run has actually exhausted claim-key work, keeping the pass aligned with its intended review order.
+
+### Fixed
+
+- **Supersession passes no longer self-poison completion state by widening too early.** The surgeon now avoids the stuck `widenedBeforeClaimKeyExhausted` path that could leave a run unable to complete cleanly after later claim-key review caught up.
+- **Supersession completion feedback is more actionable.** Rejected `complete_pass` calls now tell the model how to count reviewed-but-intentionally-unlinked clusters via `entries_skipped`, reducing repeated no-progress bounded slices.
+
+### Validation
+
+Changes since last push to `origin/master`:
+
+- Fix surgeon supersession stall handling
+
 ## [1.9.0] - 2026-04-12
 
 Surgeon autonomy, review-flow hardening, and CLI/runtime polish release.

package/dist/cli.js

@@ -10817,10 +10817,10 @@ function describeSupersessionRejection(progress, input) {
     return "Completion rejected: the review widened beyond claim_key clusters before the claim_key sweep was exhausted.";
   }
   if (!progress.claimKeyScopeExhausted) {
-    return input.budgetUsedPct === null ? `Completion rejected: ${progress.claimKeyClustersRemaining} claim_key clusters still remain in the current sweep.` : `Completion rejected: ${progress.claimKeyClustersRemaining} claim_key clusters still remain in the current sweep and only ${input.budgetUsedPct}% of the cost budget has been used.`;
+    return input.budgetUsedPct === null ? `Completion rejected: ${progress.claimKeyClustersRemaining} claim_key clusters still remain in the current sweep. For reviewed-but-intentionally-unlinked clusters, include one paged entry_id per cluster in entries_skipped.` : `Completion rejected: ${progress.claimKeyClustersRemaining} claim_key clusters still remain in the current sweep and only ${input.budgetUsedPct}% of the cost budget has been used. For reviewed-but-intentionally-unlinked clusters, include one paged entry_id per cluster in entries_skipped.`;
   }
   if (input.subjectTotal > 0 && !progress.subjectScopeExhausted) {
-    return input.budgetUsedPct === null ? `Completion rejected: the claim_key sweep is exhausted, but ${progress.subjectClustersRemaining} subject clusters still remain.` : `Completion rejected: the claim_key sweep is exhausted, but ${progress.subjectClustersRemaining} subject clusters still remain and only ${input.budgetUsedPct}% of the cost budget has been used.`;
+    return input.budgetUsedPct === null ? `Completion rejected: the claim_key sweep is exhausted, but ${progress.subjectClustersRemaining} subject clusters still remain. For reviewed-but-intentionally-unlinked clusters, include one paged entry_id per cluster in entries_skipped.` : `Completion rejected: the claim_key sweep is exhausted, but ${progress.subjectClustersRemaining} subject clusters still remain and only ${input.budgetUsedPct}% of the cost budget has been used. For reviewed-but-intentionally-unlinked clusters, include one paged entry_id per cluster in entries_skipped.`;
   }
   if (!input.budgetForcedStop) {
     return input.budgetUsedPct === null ? "Completion rejected: the supersession sweep still has unfinished work." : `Completion rejected: the supersession sweep still has unfinished work and only ${input.budgetUsedPct}% of the cost budget has been used.`;
@@ -11482,12 +11482,25 @@ function createQuerySupersessionCandidatesTool(deps) {
       const limit = normalizeLimit4(params.limit);
       const offset = normalizeOffset3(params.offset);
       const type = normalizeOptionalString11(params.type);
+      const progress = deps.completionGuards?.supersession.snapshot();
+      if ((scope === "subject" || scope === "all") && shouldBlockLowerConfidenceScope(progress)) {
+        return toolResult({
+          clusters: [],
+          count: 0,
+          scope,
+          limit,
+          offset,
+          claimKeyClusterCount: progress?.claimKeyClustersRemaining ?? 0,
+          subjectClusterCount: progress?.subjectClustersRemaining ?? 0,
+          blocked: true,
+          message: buildClaimKeyFirstMessage(progress.claimKeyClustersRemaining)
+        });
+      }
       const counts = await deps.port.countSupersessionCandidates({
         type,
         skipRecentlyEvaluatedDays: deps.skipRecentlyEvaluatedDays,
         now: deps.now()
       });
-      const progress = deps.completionGuards?.supersession.snapshot();
       const claimKeyClusters = scope === "subject" ? [] : await deps.port.listSupersessionCandidates({
         scope: "claim_key",
         type,
@@ -11546,6 +11559,15 @@ function buildEmptyResultMessage(scope) {
   }
   return "No more supersession clusters match the current filters. The review pool appears exhausted.";
 }
+function shouldBlockLowerConfidenceScope(progress) {
+  if (!progress) {
+    return false;
+  }
+  return !progress.claimKeyScopeExhausted && progress.claimKeyClustersRemaining > 0;
+}
+function buildClaimKeyFirstMessage(remainingClaimKeyClusters) {
+  return remainingClaimKeyClusters === 1 ? "The subject sweep is blocked until the claim_key sweep is exhausted. One claim_key cluster still remains - continue with scope = 'claim_key'." : `The subject sweep is blocked until the claim_key sweep is exhausted. ${remainingClaimKeyClusters} claim_key clusters still remain - continue with scope = 'claim_key'.`;
+}
 function normalizeLimit4(value) {
   if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
     return 20;
@@ -12724,6 +12746,7 @@ function buildContinuationPrompt(input) {
     "Continue the supersession pass.",
     progressReminder,
     "Keep paginating claim_key clusters while any remain. Once the claim_key sweep returns no remaining clusters, query scope = 'subject' to confirm whether lower-confidence work remains.",
+    "Viewed supersession clusters do not count as adjudicated unless you mutate them or include one paged entry_id from the cluster in entries_skipped during complete_pass.",
     "If both claim_key and subject sweeps are exhausted, call complete_pass and include any reviewed but intentionally unlinked clusters in entries_skipped.",
     "Avoid no-op metadata actions that do not change persisted state."
   ] : [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agenr",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "description": "Agent memory - local-first knowledge infrastructure for AI agents",
   "type": "module",
   "bin": {