agenr 1.9.1 → 1.9.3

package/CHANGELOG.md

@@ -2,6 +2,40 @@
 
 ## [Unreleased]
 
+## [1.9.3] - 2026-04-12
+
+Supersession sweep-exhaustion and plugin-manifest alignment patch release.
+
+### Fixed
+
+- **Supersession claim-key sweeps no longer strand the pass in a false remaining-work state.** Exhausted claim-key pages now record the actual unpaged remainder, which lets same-run subject review unblock correctly instead of tripping the autonomous semantic-stall guard.
+- **OpenClaw plugin manifests stay version-aligned across release artifacts.** The shared adapter manifest now tracks the published package/plugin version again, avoiding package-metadata skew during validation and release packaging.
+
+### Validation
+
+Changes since last push to `origin/master`:
+
+- Fix supersession claim-key sweep exhaustion
+
+## [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.

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.3",
   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, {
@@ -9689,9 +9689,9 @@ function createSupersessionReviewTracker(input) {
       progress = createEmptySupersessionProgress(input);
       entryToClusterKeys = /* @__PURE__ */ new Map();
     },
-    recordPage({ scope, claimKeyTotal, subjectTotal, clusters }) {
-      const normalizedClaimKeyRemaining = normalizeCount(claimKeyTotal);
-      const normalizedSubjectRemaining = normalizeCount(subjectTotal);
+    recordPage({ scope, claimKeyRemaining, subjectRemaining, clusters }) {
+      const normalizedClaimKeyRemaining = normalizeCount(claimKeyRemaining);
+      const normalizedSubjectRemaining = normalizeCount(subjectRemaining);
       const nextClaimKeyViewed = new Set(progress.claimKeyViewedKeys);
       const nextSubjectViewed = new Set(progress.subjectViewedKeys);
       const nextEntryMap = cloneEntryClusterMap(entryToClusterKeys);
@@ -11519,10 +11519,13 @@ function createQuerySupersessionCandidatesTool(deps) {
       const subjectClusterCount = scope === "claim_key" ? progress?.subjectClustersRemaining ?? counts.subjectCount : pendingSubjectClusters.length;
       const allClusters = scope === "claim_key" ? pendingClaimKeyClusters : scope === "subject" ? pendingSubjectClusters : [...pendingClaimKeyClusters, ...pendingSubjectClusters];
       const clusters = allClusters.slice(offset, offset + limit);
+      const remainingClusters = allClusters.slice(Math.min(allClusters.length, offset + clusters.length));
+      const claimKeyRemaining = scope === "subject" ? claimKeyClusterCount : countClustersByGrouping(remainingClusters, "claim_key");
+      const subjectRemaining = scope === "claim_key" ? subjectClusterCount : countClustersByGrouping(remainingClusters, "subject");
       deps.completionGuards?.supersession.recordPage({
         scope,
-        claimKeyTotal: claimKeyClusterCount,
-        subjectTotal: subjectClusterCount,
+        claimKeyRemaining,
+        subjectRemaining,
         clusters
       });
       if (clusters.length === 0) {
@@ -11590,6 +11593,15 @@ function normalizeOptionalString11(value) {
   const normalized = value?.trim();
   return normalized ? normalized : void 0;
 }
+function countClustersByGrouping(clusters, groupedBy) {
+  let count = 0;
+  for (const cluster of clusters) {
+    if (cluster.groupedBy === groupedBy) {
+      count += 1;
+    }
+  }
+  return count;
+}
 
 // src/app/surgeon/tools/supersession-validity.ts
 import { randomUUID as randomUUID7 } from "crypto";
@@ -12767,6 +12779,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, {
@@ -12776,6 +12789,7 @@ async function runProposalResolutionPass(input, deps) {
     processedProposals: 0,
     appliedCount,
     rejectedInactiveCount,
+    rejectedInvalidCount,
     noChangeCount,
     targetedEntryCount: updatedEntryIds.size
   });
@@ -12789,7 +12803,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) {
@@ -12830,6 +12872,7 @@ async function runProposalResolutionPass(input, deps) {
             processedProposals: index + 1,
             appliedCount,
             rejectedInactiveCount,
+            rejectedInvalidCount,
             noChangeCount,
             targetedEntryCount: updatedEntryIds.size,
             proposalId: proposal.id,
@@ -12845,6 +12888,7 @@ async function runProposalResolutionPass(input, deps) {
             processedProposals: index + 1,
             appliedCount,
             rejectedInactiveCount,
+            rejectedInvalidCount,
             noChangeCount,
             targetedEntryCount: updatedEntryIds.size,
             proposalId: proposal.id,
@@ -12893,6 +12937,7 @@ async function runProposalResolutionPass(input, deps) {
       processedProposals: index + 1,
       appliedCount,
       rejectedInactiveCount,
+      rejectedInvalidCount,
       noChangeCount,
       targetedEntryCount: updatedEntryIds.size,
       proposalId: proposal.id,
@@ -12900,7 +12945,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",
@@ -12908,6 +12953,7 @@ async function runProposalResolutionPass(input, deps) {
       processedProposals: backlog.length,
       appliedCount,
       rejectedInactiveCount,
+      rejectedInvalidCount,
       noChangeCount,
       targetedEntryCount: updatedEntryIds.size
     });
@@ -12925,6 +12971,7 @@ async function runProposalResolutionPass(input, deps) {
     processedProposals: backlog.length,
     appliedCount,
     rejectedInactiveCount,
+    rejectedInvalidCount,
     noChangeCount,
     targetedEntryCount: updatedEntryIds.size
   });
@@ -12936,7 +12983,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."]
     },
@@ -12953,6 +13003,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,
@@ -16313,8 +16364,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 {
@@ -16334,18 +16385,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:
@@ -16487,6 +16538,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.1",
+  "version": "1.9.3",
   "description": "Agent memory - local-first knowledge infrastructure for AI agents",
   "type": "module",
   "bin": {