agenr 1.9.0 → 1.9.2

package/CHANGELOG.md

@@ -2,6 +2,44 @@
 
 ## [Unreleased]
 
+## [1.9.2] - 2026-04-12
+
+Surgeon proposal-resolution hardening and claim-key progress-output patch release.
+
+### Changed
+
+- **Claim-key preview progress output is less misleading.** Preview-only `claim_key_quality` lines no longer print applied or proposal counts before entry adjudication has actually started.
+
+### Fixed
+
+- **Malformed eligible proposals no longer fail the whole autonomous run.** Proposal resolution now rejects invalid auto-apply candidates per proposal and continues through the rest of the backlog.
+- **Ambiguous entity-family convergence proposals stay on the manual-review path.** Multi-target family-convergence proposals are no longer marked eligible for autonomous apply.
+
+### Validation
+
+Changes since last push to `origin/master`:
+
+- Fix surgeon proposal resolution and progress output
+
+## [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/adapters/openclaw/index.js

@@ -1055,7 +1055,7 @@ function registerAgenrOpenClawTools(api, servicesPromise, logger) {
 var openclaw_plugin_default = {
   id: "agenr",
   name: "agenr",
-  version: "1.9.0",
+  version: "1.9.1",
   description: "agenr memory plugin for OpenClaw",
   kind: "memory",
   contracts: {

package/dist/cli.js

@@ -8204,7 +8204,7 @@ async function runClaimKeyQualityPass(options, deps) {
         rationale: buildSurgeonProposalLifecycleRationale(buildEntityFamilyConvergenceRationale(candidate), proposalLifecycle),
         confidence: candidate.confidence,
         source: canonicalEntityPrefix ? "entity_family_canonical_candidate" : "entity_family_ambiguous",
-        eligibleForApply: canonicalEntityPrefix !== null,
+        eligibleForApply: proposedClaimKeys.length === 1,
         createdAt: options.now().toISOString()
       });
       await persistProposal(proposal, {
@@ -8247,7 +8247,7 @@ async function runClaimKeyQualityPass(options, deps) {
           ),
           confidence: candidate.confidence,
           source: "entity_family_collision",
-          eligibleForApply: true,
+          eligibleForApply: false,
           createdAt: options.now().toISOString()
         });
         await persistProposal(proposal, {
@@ -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."
   ] : [
@@ -12744,6 +12767,7 @@ async function runProposalResolutionPass(input, deps) {
   });
   let appliedCount = 0;
   let rejectedInactiveCount = 0;
+  let rejectedInvalidCount = 0;
   let noChangeCount = 0;
   const updatedEntryIds = /* @__PURE__ */ new Set();
   emitProposalResolutionProgress(input.reportProgress, {
@@ -12753,6 +12777,7 @@ async function runProposalResolutionPass(input, deps) {
     processedProposals: 0,
     appliedCount,
     rejectedInactiveCount,
+    rejectedInvalidCount,
     noChangeCount,
     targetedEntryCount: updatedEntryIds.size
   });
@@ -12766,7 +12791,35 @@ async function runProposalResolutionPass(input, deps) {
   }
   for (const [index, item] of backlog.entries()) {
     const proposal = item.proposal;
-    const targetClaimKey = resolveSurgeonProposalApplyTarget(proposal);
+    let targetClaimKey;
+    try {
+      targetClaimKey = resolveSurgeonProposalApplyTarget(proposal);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      await deps.port.reviewProposal({
+        proposalId: proposal.id,
+        status: "rejected",
+        reason: message,
+        reviewedAt: input.now().toISOString(),
+        appliedActionCount: 0
+      });
+      rejectedInvalidCount += 1;
+      emitProposalResolutionProgress(input.reportProgress, {
+        apply: input.apply,
+        status: "proposal_processed",
+        totalProposals: backlog.length,
+        processedProposals: index + 1,
+        appliedCount,
+        rejectedInactiveCount,
+        rejectedInvalidCount,
+        noChangeCount,
+        targetedEntryCount: updatedEntryIds.size,
+        proposalId: proposal.id,
+        issueKind: proposal.issueKind,
+        outcome: "rejected_invalid"
+      });
+      continue;
+    }
     const reasoning = buildSurgeonProposalReviewReason(proposal, "Autonomous eligible proposal resolution.");
     const proposalEntryIds = [];
     if (input.apply) {
@@ -12807,6 +12860,7 @@ async function runProposalResolutionPass(input, deps) {
             processedProposals: index + 1,
             appliedCount,
             rejectedInactiveCount,
+            rejectedInvalidCount,
             noChangeCount,
             targetedEntryCount: updatedEntryIds.size,
             proposalId: proposal.id,
@@ -12822,6 +12876,7 @@ async function runProposalResolutionPass(input, deps) {
             processedProposals: index + 1,
             appliedCount,
             rejectedInactiveCount,
+            rejectedInvalidCount,
             noChangeCount,
             targetedEntryCount: updatedEntryIds.size,
             proposalId: proposal.id,
@@ -12870,6 +12925,7 @@ async function runProposalResolutionPass(input, deps) {
       processedProposals: index + 1,
       appliedCount,
       rejectedInactiveCount,
+      rejectedInvalidCount,
       noChangeCount,
       targetedEntryCount: updatedEntryIds.size,
       proposalId: proposal.id,
@@ -12877,7 +12933,7 @@ async function runProposalResolutionPass(input, deps) {
       outcome: input.apply ? "applied" : "dry_run"
     });
   }
-  if (appliedCount === 0 && rejectedInactiveCount === 0) {
+  if (appliedCount === 0 && rejectedInactiveCount === 0 && rejectedInvalidCount === 0) {
     emitProposalResolutionProgress(input.reportProgress, {
       apply: input.apply,
       status: "stalled",
@@ -12885,6 +12941,7 @@ async function runProposalResolutionPass(input, deps) {
       processedProposals: backlog.length,
       appliedCount,
       rejectedInactiveCount,
+      rejectedInvalidCount,
       noChangeCount,
       targetedEntryCount: updatedEntryIds.size
     });
@@ -12902,6 +12959,7 @@ async function runProposalResolutionPass(input, deps) {
     processedProposals: backlog.length,
     appliedCount,
     rejectedInactiveCount,
+    rejectedInvalidCount,
     noChangeCount,
     targetedEntryCount: updatedEntryIds.size
   });
@@ -12913,7 +12971,10 @@ async function runProposalResolutionPass(input, deps) {
       observations: [
         `Processed ${appliedCount} eligible surgeon proposal${appliedCount === 1 ? "" : "s"}.`,
         `${updatedEntryIds.size} entr${updatedEntryIds.size === 1 ? "y was" : "ies were"} targeted by proposal resolution.`,
-        ...rejectedInactiveCount > 0 ? [`Rejected ${rejectedInactiveCount} stale eligible proposal${rejectedInactiveCount === 1 ? "" : "s"} whose target entries were no longer active.`] : []
+        ...rejectedInactiveCount > 0 ? [`Rejected ${rejectedInactiveCount} stale eligible proposal${rejectedInactiveCount === 1 ? "" : "s"} whose target entries were no longer active.`] : [],
+        ...rejectedInvalidCount > 0 ? [
+          `Rejected ${rejectedInvalidCount} malformed eligible proposal${rejectedInvalidCount === 1 ? "" : "s"} that did not resolve to exactly one safe claim-key target.`
+        ] : []
       ],
       recommendations: ["Leave non-eligible surgeon proposals on the manual review path."]
     },
@@ -12930,6 +12991,7 @@ function emitProposalResolutionProgress(reporter, input) {
     processedProposals: input.processedProposals,
     appliedCount: input.appliedCount,
     rejectedInactiveCount: input.rejectedInactiveCount,
+    rejectedInvalidCount: input.rejectedInvalidCount,
     noChangeCount: input.noChangeCount,
     targetedEntryCount: input.targetedEntryCount,
     proposalId: input.proposalId,
@@ -16290,8 +16352,8 @@ function handleClaimKeyQualityEvent(event, verbose) {
   const previewTotal = formatOptionalCount(event.previewTotal);
   const previewCompleted = formatOptionalCount(event.previewCompleted);
   const previewSuffix = previewTotal > 0 ? `, preview ${previewCompleted}/${previewTotal}` : "";
-  const progressMsg = `${stageLabel}: ${event.completed}/${event.total} ${event.unitLabel}${previewSuffix}, ${appliedTotal} applied, ${event.counts.proposalsEmitted} proposals${skippedSummary}, ${formatElapsed(event.elapsedMs)}`;
-  if (verbose) {
+  const progressMsg = event.status === "preview_progress" ? `${stageLabel}: ${event.completed}/${event.total} ${event.unitLabel}${previewSuffix}${skippedSummary}, ${formatElapsed(event.elapsedMs)}` : `${stageLabel}: ${event.completed}/${event.total} ${event.unitLabel}${previewSuffix}, ${appliedTotal} applied, ${event.counts.proposalsEmitted} proposals${skippedSummary}, ${formatElapsed(event.elapsedMs)}`;
+  if (verbose && event.status !== "preview_progress") {
     const detail = ` (normalize ${event.counts.appliedNormalizations}/${event.counts.identifiedNormalizations}, backfill ${event.counts.appliedBackfills}/${event.counts.identifiedBackfills}, metadata ${event.counts.appliedMetadataRewrites}/${event.counts.identifiedMetadataRewrites}, family ${event.counts.appliedEntityFamilyConvergences}/${event.counts.identifiedEntityFamilyConvergences})`;
     writeStderr(`  ${ui.dim(progressMsg + detail)}`);
   } else {
@@ -16311,18 +16373,18 @@ function handleProposalResolutionEvent(event, verbose) {
       const outcome = event.outcome ? `, ${formatProposalResolutionOutcome(event.outcome)}` : "";
       const verboseSuffix = verbose && event.proposalId ? ` ${ui.dim(`(${event.proposalId}${event.issueKind ? `, ${event.issueKind}` : ""})`)}` : "";
       writeStderr(
-        `  ${ui.dim(`proposal_resolution: ${event.processedProposals}/${event.totalProposals} proposals, applied ${event.appliedCount}, inactive ${event.rejectedInactiveCount}, no-op ${event.noChangeCount}, targeted ${event.targetedEntryCount}${outcome}`)}${verboseSuffix}`
+        `  ${ui.dim(`proposal_resolution: ${event.processedProposals}/${event.totalProposals} proposals, applied ${event.appliedCount}, inactive ${event.rejectedInactiveCount}, invalid ${event.rejectedInvalidCount}, no-op ${event.noChangeCount}, targeted ${event.targetedEntryCount}${outcome}`)}${verboseSuffix}`
       );
       return;
     }
     case "completed":
       writeStderr(
-        `  ${ui.success(`proposal_resolution complete: applied ${event.appliedCount}, inactive ${event.rejectedInactiveCount}, no-op ${event.noChangeCount}, targeted ${event.targetedEntryCount}`)}`
+        `  ${ui.success(`proposal_resolution complete: applied ${event.appliedCount}, inactive ${event.rejectedInactiveCount}, invalid ${event.rejectedInvalidCount}, no-op ${event.noChangeCount}, targeted ${event.targetedEntryCount}`)}`
       );
       return;
     case "stalled":
       writeStderr(
-        `  ${ui.warn(`proposal_resolution stalled: ${event.processedProposals}/${event.totalProposals} proposals, applied ${event.appliedCount}, inactive ${event.rejectedInactiveCount}, no-op ${event.noChangeCount}, targeted ${event.targetedEntryCount}`)}`
+        `  ${ui.warn(`proposal_resolution stalled: ${event.processedProposals}/${event.totalProposals} proposals, applied ${event.appliedCount}, inactive ${event.rejectedInactiveCount}, invalid ${event.rejectedInvalidCount}, no-op ${event.noChangeCount}, targeted ${event.targetedEntryCount}`)}`
       );
       return;
     default:
@@ -16464,6 +16526,8 @@ function formatProposalResolutionOutcome(outcome) {
       return "previewed";
     case "rejected_inactive":
       return "rejected inactive";
+    case "rejected_invalid":
+      return "rejected invalid";
     case "no_change":
       return "no change";
     default:

package/package.json

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