@openclawbrain/cli 0.4.30 → 0.4.32

package/dist/src/cli.js

@@ -1738,6 +1738,19 @@ function readInstallRuntimeFingerprint(openclawHome) {
 function runOpenClawBrainConvergePluginStep(openclawHome) {
     const before = readInstallRuntimeFingerprint(openclawHome);
     const plan = planOpenClawBrainConvergePluginAction(before);
+    if (plan.action === "noop") {
+        return {
+            plan,
+            command: null,
+            changed: false,
+            changeReasons: [],
+            detail: "Skipped the OpenClaw plugin manager because the authoritative split-package plugin is already present and a no-op refresh would only churn volatile install metadata.",
+            warning: null,
+            capture: null,
+            before,
+            after: before
+        };
+    }
     let uninstallCapture = null;
     if (plan.action === "install" && shouldReplaceOpenClawBrainInstallBeforeConverge(before)) {
         uninstallCapture = runCapturedExternalCommand("openclaw", ["plugins", "uninstall", plan.pluginId]);

package/dist/src/index.d.ts

@@ -1820,6 +1820,7 @@ interface OperatorHookSummary {
     manifestId: string | null;
     installId: string | null;
     packageName: string | null;
+    packageVersion: string | null;
     installLayout: import("./openclaw-plugin-install.js").OpenClawBrainInstallLayout | null;
     additionalInstallCount: number;
     installState: CurrentProfileHookInstallStateV1;

package/dist/src/index.js

@@ -7832,6 +7832,7 @@ function buildCurrentProfileBrainStatusFromReport(report, policyMode, profileId)
             manifestId: report.hook.manifestId,
             installId: report.hook.installId,
             packageName: report.hook.packageName,
+            packageVersion: report.hook.packageVersion,
             installLayout: report.hook.installLayout,
             additionalInstallCount: report.hook.additionalInstallCount,
             installState: report.hook.installState,

package/dist/src/install-converge.js

@@ -103,10 +103,10 @@ export function planOpenClawBrainConvergePluginAction(fingerprint) {
     };
   }
   return {
-    action: "update",
+    action: "noop",
     packageSpec: "@openclawbrain/openclaw",
     pluginId: "openclawbrain",
-    reason: "refresh the existing split-package plugin install so install/upgrade/repair stays on one converge path",
+    reason: "the authoritative split-package plugin is already installed, so converge should preserve the current plugin-manager record instead of rewriting volatile install metadata",
   };
 }
 

package/dist/src/openclaw-hook-truth.js

@@ -257,7 +257,7 @@ export function inspectOpenClawBrainHookStatus(openclawHome) {
             manifestId: incompleteInstall?.manifestId ?? null,
             installId: incompleteInstall?.installId ?? null,
             packageName: incompleteInstall?.packageName ?? null,
-            packageVersion: readInstalledHookPackageVersion(incompleteInstall?.packageJsonPath ?? null),
+            packageVersion: incompleteInstall?.packageVersion ?? readInstalledHookPackageVersion(incompleteInstall?.packageJsonPath ?? null) ?? incompleteInstall?.manifestVersion ?? null,
             installLayout: incompleteInstall?.installLayout ?? null,
             additionalInstallCount: installedPlugin.additionalInstalls.length,
             installState: "not_installed",
@@ -274,7 +274,7 @@ export function inspectOpenClawBrainHookStatus(openclawHome) {
     const allowlist = inspectOpenClawBrainPluginAllowlist(resolvedHome);
     const layoutLabel = describeOpenClawBrainInstallLayout(selectedInstall.installLayout);
     const identityDetail = describeOpenClawBrainInstallIdentity(selectedInstall);
-    const packageVersion = readInstalledHookPackageVersion(selectedInstall.packageJsonPath);
+    const packageVersion = selectedInstall.packageVersion ?? readInstalledHookPackageVersion(selectedInstall.packageJsonPath) ?? selectedInstall.manifestVersion ?? null;
     const activationRootState = inspectInstalledHookActivationRoot(selectedInstall.loaderEntryPath);
     if (allowlist.state === "blocked") {
         return {

package/dist/src/openclaw-plugin-install.js

@@ -164,6 +164,10 @@ function inspectOpenClawBrainPluginInstall(extensionDir, pluginId) {
     const packageName = typeof packageJson.name === "string" && packageJson.name.trim().length > 0
         ? packageJson.name.trim()
         : null;
+    const packageVersion = typeof packageJson.version === "string" && packageJson.version.trim().length > 0
+        ? packageJson.version.trim()
+        : null;
+    const manifestVersion = normalizeOptionalString(manifest?.version);
     const installId = normalizeInstallId(packageName) ?? normalizeInstallId(path.basename(extensionDir));
     const installLayout = inferInstallLayout({
         extensionDir,
@@ -182,8 +186,10 @@ function inspectOpenClawBrainPluginInstall(extensionDir, pluginId) {
         runtimeGuardPath: loaderEntryPath === null ? null : resolveRuntimeGuardPath(loaderEntryPath),
         configuredEntries,
         manifestId,
+        manifestVersion,
         installId,
         packageName,
+        packageVersion,
         installLayout
     };
 }

package/dist/src/traced-learning-bridge.js

@@ -272,13 +272,15 @@ function loadJsonFile(pathname) {
 function resolveActivePackPaths(activationRoot) {
     const pointers = toRecord(loadJsonFile(path.join(path.resolve(activationRoot), "activation-pointers.json")));
     const active = toRecord(pointers?.active);
+    const packId = normalizeOptionalString(active?.packId);
     const packRootDir = normalizeOptionalString(active?.packRootDir)
-        ?? (normalizeOptionalString(active?.packId) === null
+        ?? (packId === null
             ? null
-            : path.join(path.resolve(activationRoot), "packs", String(active.packId)));
+            : path.join(path.resolve(activationRoot), "packs", String(packId)));
     const manifestPath = normalizeOptionalString(active?.manifestPath)
         ?? (packRootDir === null ? null : path.join(packRootDir, "manifest.json"));
     return {
+        packId,
         packRootDir,
         manifestPath
     };
@@ -376,6 +378,38 @@ function buildWatchSnapshotAttributionCoverage(activationRoot) {
         detail: `watch sparse-feedback queue: completed_without_evaluation=0, ready=${normalizeCount(readyCount)}, delayed=${normalizeCount(delayedCount)}, budget_deferred=${normalizeCount(budgetDeferredCount)}`
     };
 }
+function readWatchTeacherSnapshotPackTruth(activationRoot) {
+    const snapshot = toRecord(loadJsonFile(path.join(path.resolve(activationRoot), "watch", "teacher-snapshot.json")));
+    const learning = toRecord(snapshot?.learning);
+    const nestedSnapshot = toRecord(snapshot?.snapshot);
+    const nestedLearning = toRecord(nestedSnapshot?.learning);
+    return {
+        lastHandledMaterializationPackId: normalizeOptionalString(snapshot?.lastHandledMaterializationPackId)
+            ?? normalizeOptionalString(learning?.lastHandledMaterializationPackId)
+            ?? normalizeOptionalString(nestedLearning?.lastHandledMaterializationPackId),
+        lastMaterializationPackId: normalizeOptionalString(snapshot?.lastMaterializationPackId)
+            ?? normalizeOptionalString(learning?.lastMaterializationPackId)
+            ?? normalizeOptionalString(nestedLearning?.lastMaterializationPackId)
+    };
+}
+function buildActivationPackTruth(activationRoot) {
+    const active = resolveActivePackPaths(activationRoot);
+    const activePackId = active.packId;
+    if (activePackId === null) {
+        return null;
+    }
+    const watchTruth = readWatchTeacherSnapshotPackTruth(activationRoot);
+    const handledPackId = watchTruth.lastHandledMaterializationPackId ?? watchTruth.lastMaterializationPackId;
+    if (handledPackId === null) {
+        return null;
+    }
+    return {
+        activePackId,
+        handledPackId,
+        materializedPackId: handledPackId,
+        promoted: handledPackId === activePackId
+    };
+}
 function shouldPreferActivationFeedbackSummary(current, fallback) {
     if (fallback === null) {
         return false;
@@ -407,18 +441,35 @@ function shouldPreferWatchAttributionCoverage(current, fallback) {
 function enrichBridgeWithActivationTruth(activationRoot, bridge) {
     const feedbackSummary = buildActivePackFeedbackSummary(activationRoot);
     const attributionCoverage = buildWatchSnapshotAttributionCoverage(activationRoot);
-    if (!shouldPreferActivationFeedbackSummary(bridge.feedbackSummary, feedbackSummary)
-        && !shouldPreferWatchAttributionCoverage(bridge.attributionCoverage, attributionCoverage)) {
+    const packTruth = buildActivationPackTruth(activationRoot);
+    const preferFeedbackSummary = shouldPreferActivationFeedbackSummary(bridge.feedbackSummary, feedbackSummary);
+    const preferAttributionCoverage = shouldPreferWatchAttributionCoverage(bridge.attributionCoverage, attributionCoverage);
+    const preferPackTruth = packTruth !== null
+        && (bridge.materializedPackId === null || (bridge.promoted !== true && packTruth.promoted === true))
+        && (packTruth.promoted === true || bridge.materializedPackId === null);
+    if (!preferFeedbackSummary && !preferAttributionCoverage && !preferPackTruth) {
         return bridge;
     }
     return normalizeBridgePayload({
         ...bridge,
-        feedbackSummary: shouldPreferActivationFeedbackSummary(bridge.feedbackSummary, feedbackSummary)
+        materializedPackId: preferPackTruth ? packTruth.materializedPackId : bridge.materializedPackId,
+        promoted: preferPackTruth ? packTruth.promoted : bridge.promoted,
+        feedbackSummary: preferFeedbackSummary
             ? feedbackSummary
             : bridge.feedbackSummary,
-        attributionCoverage: shouldPreferWatchAttributionCoverage(bridge.attributionCoverage, attributionCoverage)
+        attributionCoverage: preferAttributionCoverage
             ? attributionCoverage
-            : bridge.attributionCoverage
+            : bridge.attributionCoverage,
+        source: preferPackTruth
+            ? {
+                ...(bridge.source ?? {}),
+                activationPackTruth: {
+                    activePackId: packTruth.activePackId,
+                    handledPackId: packTruth.handledPackId,
+                    source: "active_pack_plus_watch_snapshot"
+                }
+            }
+            : bridge.source
     });
 }
 function normalizeLastInterruptionSummary(value) {
@@ -865,6 +916,21 @@ export function persistBrainStoreTracedLearningBridge(payload, options = {}) {
     try {
         db = new sqlite.DatabaseSync(dbPath);
         const summary = normalizePersistedStatusSurface(payload);
+        const existingSummaryLoaded = loadTrainingStateJson(db, TRACED_LEARNING_STATUS_SURFACE_STATE_KEY);
+        if (existingSummaryLoaded.value !== null) {
+            const existingSummary = normalizePersistedStatusSurface(existingSummaryLoaded.value);
+            if (JSON.stringify(existingSummary) === JSON.stringify(summary)) {
+                return {
+                    path: dbPath,
+                    bridge: buildPersistedStatusSurfaceBridge(existingSummary, {
+                        brainRoot,
+                        dbPath
+                    }),
+                    persisted: false,
+                    error: null
+                };
+            }
+        }
         writeTrainingStateJson(db, TRACED_LEARNING_STATUS_SURFACE_STATE_KEY, summary);
         return {
             path: dbPath,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclawbrain/cli",
-  "version": "0.4.30",
+  "version": "0.4.32",
   "description": "OpenClawBrain operator CLI package with install/status helpers, daemon controls, and import/export tooling.",
   "type": "module",
   "main": "./dist/src/index.js",