@openclawbrain/cli 0.4.20 → 0.4.21

package/README.md

@@ -1,6 +1,6 @@
 # @openclawbrain/cli
 
-Operator CLI for OpenClawBrain. Use it with `@openclawbrain/openclaw`.
+Operator CLI internals for OpenClawBrain.
 
 The public front door is one command pinned to one OpenClaw home:
 
@@ -20,6 +20,8 @@ openclawbrain proof --openclaw-home ~/.openclaw
 
 The intended canonical lane is the same install command with optional `--proof`. Until that lands cleanly across the operator surfaces, proof stays a separate follow-up command. `proof` writes `summary.md`, `steps.json`, `verdict.json`, raw step logs, and proof pointers under one bundle directory.
 
+This package is part of the internal split architecture. Public docs should lead with OpenClawBrain and the `openclawbrain install` lane, not with package-pair trivia.
+
 ## Common commands
 
 ```bash

package/dist/src/cli.js

@@ -6,7 +6,7 @@ import { fileURLToPath, pathToFileURL } from "node:url";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 import { DEFAULT_OLLAMA_EMBEDDING_MODEL, createOllamaEmbedder } from "@openclawbrain/compiler";
-import { ensureManagedLearnerServiceForActivationRoot, inspectManagedLearnerService, removeManagedLearnerServiceForActivationRoot, parseDaemonArgs, runDaemonCommand } from "./daemon.js";
+import { describeManagedLearnerServiceRuntimeGuard, ensureManagedLearnerServiceForActivationRoot, inspectManagedLearnerService, removeManagedLearnerServiceForActivationRoot, parseDaemonArgs, runDaemonCommand } from "./daemon.js";
 import { exportBrain, importBrain } from "./import-export.js";
 import { buildNormalizedEventExport } from "@openclawbrain/contracts";
 import { buildTeacherSupervisionArtifactsFromNormalizedEventExport, createAlwaysOnLearningRuntimeState, describeAlwaysOnLearningRuntimeState, drainAlwaysOnLearningRuntime, loadOrInitBaseline, materializeAlwaysOnLearningCandidatePack, persistBaseline } from "./local-learner.js";
@@ -15,7 +15,7 @@ import { resolveActivationRoot } from "./resolve-activation-root.js";
 import { describeOpenClawHomeInspection, discoverOpenClawHomes, formatOpenClawHomeLayout, formatOpenClawHomeProfileSource, inspectOpenClawHome } from "./openclaw-home-layout.js";
 import { inspectOpenClawBrainHookStatus, inspectOpenClawBrainPluginAllowlist } from "./openclaw-hook-truth.js";
 import { describeOpenClawBrainInstallIdentity, describeOpenClawBrainInstallLayout, findInstalledOpenClawBrainPlugin, getOpenClawBrainKnownPluginIds, normalizeOpenClawBrainPluginsConfig, pinInstalledOpenClawBrainPluginActivationRoot, resolveOpenClawBrainInstallTarget } from "./openclaw-plugin-install.js";
-import { buildOpenClawBrainConvergeRestartPlan, classifyOpenClawBrainConvergeVerification, describeOpenClawBrainConvergeChangeReasons, diffOpenClawBrainConvergeRuntimeFingerprint, finalizeOpenClawBrainConvergeResult, planOpenClawBrainConvergePluginAction } from "./install-converge.js";
+import { buildOpenClawBrainConvergeRestartPlan, classifyOpenClawBrainConvergeVerification, describeOpenClawBrainConvergeChangeReasons, diffOpenClawBrainConvergeRuntimeFingerprint, finalizeOpenClawBrainConvergeResult, planOpenClawBrainConvergePluginAction, shouldReplaceOpenClawBrainInstallBeforeConverge } from "./install-converge.js";
 import { loadAttachmentPolicyDeclaration, resolveEffectiveAttachmentPolicyTruth, writeAttachmentPolicyDeclaration } from "./attachment-policy-truth.js";
 import { DEFAULT_WATCH_POLL_INTERVAL_SECONDS, buildNormalizedEventExportFromScannedEvents, bootstrapRuntimeAttach, buildOperatorSurfaceReport, clearOpenClawProfileRuntimeLoadProof, compileRuntimeContext, createAsyncTeacherLiveLoop, createOpenClawLocalSessionTail, createRuntimeEventExportScanner, describeCurrentProfileBrainStatus, formatOperatorRollbackReport, listOpenClawProfileRuntimeLoadProofs, loadRuntimeEventExportBundle, loadWatchTeacherSnapshotState, persistWatchTeacherSnapshot, rollbackRuntimeAttach, resolveAttachmentRuntimeLoadProofsPath, resolveOperatorTeacherSnapshotPath, resolveAsyncTeacherLiveLoopSnapshotPath, resolveWatchSessionTailCursorPath, resolveWatchStateRoot, resolveWatchTeacherSnapshotPath, scanLiveEventExport, scanRecordedSession, summarizeLearningPathFromMaterialization, summarizeNormalizedEventExportLabelFlow, summarizeTeacherNoArtifactCycle, writeScannedEventExportBundle } from "./index.js";
 import { appendLearningUpdateLogs } from "./learning-spine.js";
@@ -31,6 +31,7 @@ const OPENCLAWBRAIN_EMBEDDER_BASE_URL_ENV = "OPENCLAWBRAIN_EMBEDDER_BASE_URL";
 const OPENCLAWBRAIN_EMBEDDER_PROVIDER_ENV = "OPENCLAWBRAIN_EMBEDDER_PROVIDER";
 const OPENCLAWBRAIN_EMBEDDER_MODEL_ENV = "OPENCLAWBRAIN_EMBEDDER_MODEL";
 const OPENCLAWBRAIN_INSTALL_SKIP_EMBEDDER_PROVISION_ENV = "OPENCLAWBRAIN_INSTALL_SKIP_EMBEDDER_PROVISION";
+const LEGACY_COMPAT_PACKAGE_NAME = "@jonathangu/openclawbrain";
 const INSTALL_COMPATIBLE_LOCAL_TEACHER_MODEL_PREFIXES = [
     "qwen3.5:9b",
     "qwen3.5:8b",
@@ -1621,6 +1622,13 @@ function readInstallRuntimeFingerprint(openclawHome) {
 function runOpenClawBrainConvergePluginStep(openclawHome) {
     const before = readInstallRuntimeFingerprint(openclawHome);
     const plan = planOpenClawBrainConvergePluginAction(before);
+    let uninstallCapture = null;
+    if (plan.action === "install" && shouldReplaceOpenClawBrainInstallBeforeConverge(before)) {
+        uninstallCapture = runCapturedExternalCommand("openclaw", ["plugins", "uninstall", plan.pluginId]);
+        if (uninstallCapture.error !== null || uninstallCapture.exitCode !== 0) {
+            throw new Error(`OpenClaw plugin-manager uninstall failed while migrating ${path.resolve(openclawHome)} onto the canonical plugin lane. Tried \`${uninstallCapture.shellCommand}\`. Detail: ${summarizeCapturedCommandFailure(uninstallCapture)}`);
+        }
+    }
     const commandArgs = plan.action === "install"
         ? ["plugins", "install", plan.packageSpec]
         : ["plugins", "update", plan.pluginId];
@@ -1651,7 +1659,7 @@ function runOpenClawBrainConvergePluginStep(openclawHome) {
         changed: diff.changed,
         changeReasons: diff.reasons,
         detail: diff.changed
-            ? `${plan.action === "install" ? "Installed" : "Refreshed"} plugin-manager state: ${describeOpenClawBrainConvergeChangeReasons(diff.reasons)}`
+            ? `${uninstallCapture !== null ? "Replaced legacy/plugin-shadow install and " : ""}${plan.action === "install" ? "installed" : "refreshed"} plugin-manager state: ${describeOpenClawBrainConvergeChangeReasons(diff.reasons)}`
             : `${plan.action === "install" ? "Ran install" : "Ran update"} through the OpenClaw plugin manager, but no runtime-affecting plugin delta was detected`,
         warning: null,
         capture,
@@ -1722,6 +1730,27 @@ function buildAttachCommand(openclawHome, activationRoot = null) {
 function buildInstallEmbedderProvisionCommand(baseUrl, model) {
     return `OLLAMA_HOST=${quoteShellArg(baseUrl)} ollama pull ${quoteShellArg(model)}`;
 }
+function buildCanonicalInstallRecoveryPath(parsed) {
+    return [
+        buildInstallCommand(parsed.openclawHome),
+        "openclaw gateway restart",
+        buildInstallStatusCommand(parsed.activationRoot),
+        buildProofCommandForOpenClawHome(parsed.openclawHome)
+    ].join(" -> ");
+}
+function inspectInstallGuardrailWarnings(parsed) {
+    const warnings = [];
+    const runtimeFingerprint = readInstallRuntimeFingerprint(parsed.openclawHome);
+    if (runtimeFingerprint.selectedInstall?.packageName === LEGACY_COMPAT_PACKAGE_NAME) {
+        warnings.push(`Detected legacy compatibility plugin state (${LEGACY_COMPAT_PACKAGE_NAME}) for this OpenClaw home. Install is converging it back onto the single supported OpenClawBrain path.`);
+    }
+    const learnerInspection = inspectManagedLearnerService(parsed.activationRoot);
+    const learnerRuntimeGuard = describeManagedLearnerServiceRuntimeGuard(learnerInspection);
+    if (learnerRuntimeGuard.state !== "ok") {
+        warnings.push(`${learnerRuntimeGuard.detail} Canonical recovery path: ${buildCanonicalInstallRecoveryPath(parsed)}`);
+    }
+    return warnings;
+}
 function describeExecOutput(value) {
     if (typeof value === "string") {
         const normalized = value.trim();
@@ -3135,6 +3164,7 @@ function installExtensionFromLocalWorkspaceBuild(extensionDir) {
     return [...LOCAL_WORKSPACE_EXTENSION_PACKAGES];
 }
 let cachedOpenClawPackageMetadata = null;
+let cachedOpenClawRuntimePackageMetadata = null;
 function resolveOpenClawPackageManifestPath() {
     const candidates = [
         path.resolve(__dirname, "..", "package.json"),
@@ -3163,6 +3193,34 @@ function readOpenClawPackageMetadata() {
     cachedOpenClawPackageMetadata = { name, version };
     return cachedOpenClawPackageMetadata;
 }
+function resolveOpenClawRuntimePackageManifestPath() {
+    const candidates = [
+        path.resolve(__dirname, "..", "..", "..", "openclaw", "package.json"),
+        path.resolve(__dirname, "..", "..", "..", "..", "packages", "openclaw", "package.json"),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    throw new Error("OpenClawBrain runtime package manifest not found. Searched:\n" +
+        candidates.map((candidate) => `  - ${candidate}`).join("\n"));
+}
+function readOpenClawRuntimePackageMetadata() {
+    if (cachedOpenClawRuntimePackageMetadata !== null) {
+        return cachedOpenClawRuntimePackageMetadata;
+    }
+    const manifestPath = resolveOpenClawRuntimePackageManifestPath();
+    const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+    const name = typeof manifest.name === "string" && manifest.name.trim().length > 0
+        ? manifest.name.trim()
+        : "@openclawbrain/openclaw";
+    const version = typeof manifest.version === "string" && manifest.version.trim().length > 0
+        ? manifest.version.trim()
+        : "0.0.0";
+    cachedOpenClawRuntimePackageMetadata = { name, version };
+    return cachedOpenClawRuntimePackageMetadata;
+}
 function buildExtensionIndexTs(activationRoot) {
     const templatePath = resolveExtensionTemplatePath();
     const template = readFileSync(templatePath, "utf8");
@@ -3170,6 +3228,10 @@ function buildExtensionIndexTs(activationRoot) {
 }
 function buildExtensionPackageJson() {
     const packageMetadata = readOpenClawPackageMetadata();
+    const runtimePackageMetadata = readOpenClawRuntimePackageMetadata();
+    const dependencies = {
+        [runtimePackageMetadata.name]: runtimePackageMetadata.version
+    };
     return JSON.stringify({
         name: "openclawbrain",
         version: packageMetadata.version,
@@ -3178,9 +3240,7 @@ function buildExtensionPackageJson() {
         openclaw: {
             extensions: ["index.ts"]
         },
-        dependencies: {
-            [packageMetadata.name]: packageMetadata.version
-        }
+        dependencies
     }, null, 2) + "\n";
 }
 function buildExtensionPluginManifest() {
@@ -3967,8 +4027,10 @@ function emitInstallConvergeResult(result, parsed) {
 function runInstallCommand(parsed) {
     let pluginResult = null;
     let attachResult = null;
+    let guardrailWarnings = [];
     try {
         validateOpenClawHome(parsed.openclawHome);
+        guardrailWarnings = inspectInstallGuardrailWarnings(parsed);
         pluginResult = runOpenClawBrainConvergePluginStep(parsed.openclawHome);
         attachResult = executeProfileHookAttachCommand(parsed);
     }
@@ -3976,7 +4038,7 @@ function runInstallCommand(parsed) {
         const verdict = finalizeOpenClawBrainConvergeResult({
             stepFailure: toErrorMessage(error),
             verification: null,
-            warnings: []
+            warnings: guardrailWarnings
         });
         const failureResult = {
             command: "install",
@@ -4042,6 +4104,7 @@ function runInstallCommand(parsed) {
         restartPerformed: restartPlan.required && restartPlan.automatic && restartError === null
     });
     const convergeWarnings = [];
+    convergeWarnings.push(...guardrailWarnings);
     if (pluginResult.warning) {
         convergeWarnings.push(pluginResult.warning);
     }

package/dist/src/daemon.js

@@ -23,6 +23,7 @@ const DEFAULT_SCAN_ROOT_DIRNAME = "event-exports";
 const BASELINE_STATE_BASENAME = "baseline-state.json";
 const SCANNER_CHECKPOINT_BASENAME = ".openclawbrain-scanner-checkpoint.json";
 const CLI_PACKAGE_NAME = "@openclawbrain/cli";
+const LEGACY_COMPAT_PACKAGE_NAME = "@jonathangu/openclawbrain";
 const CLI_BIN_NAME = "openclawbrain";
 const DEFAULT_DAEMON_COMMAND_RUNNER = (command) => execSync(command, {
     encoding: "utf8",
@@ -198,6 +199,26 @@ function resolveCliPackageRoot(startDir) {
     }
     return null;
 }
+function readNearestPackageMetadataForPath(filePath) {
+    if (typeof filePath !== "string" || filePath.trim().length === 0) {
+        return null;
+    }
+    let currentDir = path.dirname(path.resolve(filePath));
+    while (true) {
+        const packageMetadata = readPackageMetadata(currentDir);
+        if (packageMetadata !== null) {
+            return {
+                root: currentDir,
+                ...packageMetadata,
+            };
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            return null;
+        }
+        currentDir = parentDir;
+    }
+}
 function resolveDaemonPackageManagerLaunchSpec(moduleDir) {
     const cliPackageRoot = resolveCliPackageRoot(moduleDir);
     const cliPackageMetadata = readPackageMetadata(cliPackageRoot);
@@ -244,14 +265,47 @@ function describeDaemonProgramArguments(programArguments) {
         ? programArguments[1]
         : programArguments[0];
     const runtimePackageSpec = programArguments.find((argument) => argument.startsWith("--package="))?.slice("--package=".length) ?? null;
+    const runtimePackageMetadata = runtimePath === null ? null : readNearestPackageMetadataForPath(runtimePath);
     return {
         configuredProgramArguments: programArguments,
         configuredCommand: formatCommand(programArguments),
         configuredRuntimePath: runtimePath,
         configuredRuntimePackageSpec: runtimePackageSpec,
+        configuredRuntimePackageName: runtimePackageMetadata?.name ?? null,
+        configuredRuntimePackageVersion: runtimePackageMetadata?.version ?? null,
         configuredRuntimeLooksEphemeral: runtimePath === null ? null : isNpxCachePath(runtimePath)
     };
 }
+export function describeManagedLearnerServiceRuntimeGuard(inspection) {
+    if (inspection.installed !== true || inspection.configuredProgramArguments === null) {
+        return {
+            state: "ok",
+            reason: "not_installed",
+            detail: "No managed learner service is installed yet."
+        };
+    }
+    if (inspection.configuredRuntimeLooksEphemeral === true) {
+        return {
+            state: "refresh_required",
+            reason: "ephemeral_runtime",
+            detail: `Learner service still points at an ephemeral runtime path (${inspection.configuredRuntimePath ?? "unknown"}). Refresh it onto the durable OpenClawBrain CLI path before trusting background learning.`
+        };
+    }
+    const runtimePackageName = inspection.configuredRuntimePackageName;
+    const runtimePackageSpec = inspection.configuredRuntimePackageSpec;
+    if (runtimePackageName === LEGACY_COMPAT_PACKAGE_NAME || runtimePackageSpec?.startsWith(`${LEGACY_COMPAT_PACKAGE_NAME}@`) || runtimePackageSpec === LEGACY_COMPAT_PACKAGE_NAME) {
+        return {
+            state: "refresh_required",
+            reason: "legacy_compat_runtime",
+            detail: `Learner service still points at the retired compatibility package ${LEGACY_COMPAT_PACKAGE_NAME}${inspection.configuredRuntimePath ? ` (${inspection.configuredRuntimePath})` : ""}. Refresh it onto the single supported OpenClawBrain CLI path before trusting background learning.`
+        };
+    }
+    return {
+        state: "ok",
+        reason: "durable_runtime",
+        detail: `Learner service points at the durable ${CLI_PACKAGE_NAME} runtime.`
+    };
+}
 function resolveDaemonProgramArguments() {
     for (const candidate of getOpenclawbrainCliScriptPathCandidates()) {
         const cliScriptPath = resolveCliScriptCandidate(candidate);
@@ -465,7 +519,8 @@ export function inspectManagedLearnerService(activationRoot) {
 }
 export function ensureManagedLearnerServiceForActivationRoot(activationRoot) {
     const inspection = inspectManagedLearnerServiceInternal(activationRoot);
-    if (inspection.matchesRequestedActivationRoot === true && inspection.running) {
+    const runtimeGuard = describeManagedLearnerServiceRuntimeGuard(inspection);
+    if (inspection.matchesRequestedActivationRoot === true && inspection.running && runtimeGuard.state === "ok") {
         return {
             state: "ensured",
             reason: "already_running_exact_root",
@@ -473,12 +528,25 @@ export function ensureManagedLearnerServiceForActivationRoot(activationRoot) {
             inspection
         };
     }
+    if (inspection.installed && runtimeGuard.state !== "ok") {
+        const stopResult = stopManagedLearnerService(activationRoot);
+        if (!stopResult.ok) {
+            return {
+                state: "deferred",
+                reason: "stale_runtime_refresh_failed",
+                detail: `${runtimeGuard.detail} Tried to stop the stale learner service first, but that failed: ${stopResult.message}`,
+                inspection: stopResult.inspection
+            };
+        }
+    }
     const startResult = startManagedLearnerService(activationRoot);
     if (startResult.ok) {
         return {
-            state: "started",
-            reason: "started_exact_root",
-            detail: `Started the background learner service for ${startResult.inspection.requestedActivationRoot}; passive learning can begin for this attached profile now.`,
+            state: runtimeGuard.state !== "ok" ? "refreshed" : "started",
+            reason: runtimeGuard.state !== "ok" ? runtimeGuard.reason : "started_exact_root",
+            detail: runtimeGuard.state !== "ok"
+                ? `${runtimeGuard.detail} Refreshed the learner daemon onto the durable OpenClawBrain CLI path for ${startResult.inspection.requestedActivationRoot}.`
+                : `Started the background learner service for ${startResult.inspection.requestedActivationRoot}; passive learning can begin for this attached profile now.`,
             inspection: startResult.inspection
         };
     }
@@ -940,11 +1008,21 @@ export function daemonStatus(activationRoot, json) {
         }
         if (daemonLaunchDescription.configuredRuntimePath !== null) {
             const runtimePackageSuffix = daemonLaunchDescription.configuredRuntimePackageSpec === null
-                ? ""
+                ? daemonLaunchDescription.configuredRuntimePackageName === null
+                    ? ""
+                    : ` (${daemonLaunchDescription.configuredRuntimePackageName}${daemonLaunchDescription.configuredRuntimePackageVersion === null ? "" : `@${daemonLaunchDescription.configuredRuntimePackageVersion}`})`
                 : ` (${daemonLaunchDescription.configuredRuntimePackageSpec})`;
             const runtimeWarning = daemonLaunchDescription.configuredRuntimeLooksEphemeral ? " [ephemeral]" : "";
             console.log(`  Runtime: ${daemonLaunchDescription.configuredRuntimePath}${runtimePackageSuffix}${runtimeWarning}`);
         }
+        const runtimeGuard = describeManagedLearnerServiceRuntimeGuard({
+            installed: plistInstalled,
+            configuredProgramArguments,
+            ...daemonLaunchDescription,
+        });
+        if (runtimeGuard.state !== "ok") {
+            console.log(`  Guardrail: ${runtimeGuard.detail}`);
+        }
         if (configuredProgramArguments !== null && configuredProgramArguments.length > 0) {
             console.log(`  Program: ${configuredProgramArguments[0]}`);
             if (configuredProgramArguments.length > 1) {

package/dist/src/install-converge.js

@@ -1,3 +1,5 @@
+const LEGACY_COMPAT_PACKAGE_NAME = "@jonathangu/openclawbrain";
+
 const CHANGE_REASON_LABELS = {
   install_identity: "plugin install identity changed",
   install_layout: "authoritative install layout changed",
@@ -26,6 +28,14 @@ function installIdentityOf(fingerprint) {
   });
 }
 
+export function shouldReplaceOpenClawBrainInstallBeforeConverge(fingerprint) {
+  const selectedInstall = fingerprint?.selectedInstall ?? null;
+  if (selectedInstall === null) {
+    return false;
+  }
+  return selectedInstall.packageName !== "@openclawbrain/openclaw";
+}
+
 export function planOpenClawBrainConvergePluginAction(fingerprint) {
   const selectedInstall = fingerprint?.selectedInstall ?? null;
   if (selectedInstall === null) {
@@ -36,6 +46,14 @@ export function planOpenClawBrainConvergePluginAction(fingerprint) {
       reason: "no authoritative OpenClawBrain plugin install was discovered for this OpenClaw home",
     };
   }
+  if (selectedInstall.packageName === LEGACY_COMPAT_PACKAGE_NAME) {
+    return {
+      action: "install",
+      packageSpec: "@openclawbrain/openclaw",
+      pluginId: "openclawbrain",
+      reason: `the authoritative install still points at the retired compatibility package ${LEGACY_COMPAT_PACKAGE_NAME}, so converge must replace it with the canonical split-package plugin`,
+    };
+  }
   if (selectedInstall.installLayout !== "native_package_plugin") {
     return {
       action: "install",
@@ -130,6 +148,10 @@ export function classifyOpenClawBrainConvergeVerification(input) {
   const runtimeLoad = input.runtimeLoad ?? "unverified";
   const loadProof = input.loadProof ?? "unverified";
   const serveState = input.serveState ?? "unknown";
+  const installedPackageName = input.installedPackageName ?? null;
+  if (installedPackageName === LEGACY_COMPAT_PACKAGE_NAME) {
+    blockingReasons.push(`installed plugin still references the retired compatibility package ${LEGACY_COMPAT_PACKAGE_NAME}; converge must replace it with @openclawbrain/openclaw`);
+  }
   if (installLayout !== "native_package_plugin") {
     blockingReasons.push("split-package native package plugin is not authoritative after converge");
   }
@@ -160,6 +182,23 @@ export function classifyOpenClawBrainConvergeVerification(input) {
   if (input.restartRequired === true && input.restartPerformed !== true && runtimeTruthAlreadyProven) {
     warnings.push("automatic restart was not performed because install could not infer an exact OpenClaw profile token, but current status already proves runtime load");
   }
+  // When runtime proof is green for the repaired profile, promote the proof
+  // surface to healthy rather than leaving stale degraded warnings that
+  // contradict the proven truth.
+  if (runtimeTruthAlreadyProven) {
+    if (serveState !== "serving_active_pack") {
+      warnings.push(`serve state is ${serveState}`);
+    }
+    if (input.awaitingFirstExport === true) {
+      warnings.push("the attached profile has not emitted its first export yet");
+    }
+    return {
+      state: warnings.length > 0 ? "warning" : "healthy",
+      manualActionRequired: false,
+      blockingReasons,
+      warnings,
+    };
+  }
   if (displayedStatus !== "ok") {
     warnings.push(`status is ${displayedStatus}`);
   }

package/dist/src/proof-command.js

@@ -384,20 +384,33 @@ function buildHardeningSnapshot({ attachTruthLine, serveLine, routeFnLine, verdi
     };
 }
 
-function hasPackagedHookSource(pluginInspectText) {
-    return /Source:\s+.*(?:@openclawbrain[\\/]+openclaw|openclawbrain)[\\/]+dist[\\/]+extension[\\/]+index\.js/m.test(pluginInspectText);
+function hasPackagedHookSource(pluginInspectText, openclawHome) {
+    if (/Source:\s+.*(?:@openclawbrain[\\/]+openclaw|openclawbrain)[\\/]+dist[\\/]+extension[\\/]+index\.js/m.test(pluginInspectText)) {
+        return true;
+    }
+    const generatedShadowHookPath = canonicalizeExistingProofPath(path.join(openclawHome, "extensions", "openclawbrain", "index.ts"));
+    const sourceMatch = pluginInspectText.match(/^Source:\s+(.+)$/m);
+    const reportedSourcePath = canonicalizeExistingProofPath(sourceMatch?.[1] ?? "");
+    return reportedSourcePath === generatedShadowHookPath;
 }
 
-function buildVerdict({ steps, gatewayStatus, pluginInspect, statusSignals, breadcrumbs, runtimeLoadProofSnapshot, openclawHome }) {
+function buildVerdict({ steps, gatewayStatus, pluginInspect, statusSignals, breadcrumbs, runtimeLoadProofSnapshot, coverageSnapshot, openclawHome }) {
     const failedSteps = steps.filter((step) => step.resultClass !== "success" && step.skipped !== true);
     const failedDetailedStatusStep = failedSteps.find((step) => step.stepId === "05-detailed-status");
     const gatewayHealthy = /Runtime:\s+running/m.test(gatewayStatus) && /RPC probe:\s+ok/m.test(gatewayStatus);
     const pluginLoaded = /Status:\s+loaded/m.test(pluginInspect);
-    const packagedHookPath = hasPackagedHookSource(pluginInspect);
+    const packagedHookPath = hasPackagedHookSource(pluginInspect, openclawHome);
     const breadcrumbLoaded = breadcrumbs.afterBundleStart.some((entry) => entry.kind === "loaded");
     const runtimeProofMatched = Array.isArray(runtimeLoadProofSnapshot?.value?.profiles)
         && runtimeLoadProofSnapshot.value.profiles.some((profile) => canonicalizeExistingProofPath(profile?.openclawHome ?? "") === canonicalizeExistingProofPath(openclawHome));
     const runtimeTruthGaps = [];
+    const currentCoverageEntry = Array.isArray(coverageSnapshot?.profiles)
+        ? coverageSnapshot.profiles.find((entry) => entry.current)
+        : null;
+    const currentProfileRuntimeCovered = currentCoverageEntry?.runtimeLoad === "proven";
+    const crossProfileCoverageGapOnly = currentProfileRuntimeCovered
+        && (coverageSnapshot?.attachedProfileCount ?? 0) > (coverageSnapshot?.runtimeProvenCount ?? 0)
+        && (statusSignals.proofError === null || statusSignals.proofError === "none");
     const strongRuntimeTruth = statusSignals.loadProofReady
         && statusSignals.runtimeProven
         && statusSignals.serveActivePack
@@ -414,8 +427,10 @@ function buildVerdict({ steps, gatewayStatus, pluginInspect, statusSignals, brea
     const warnings = [];
     if (!statusSignals.statusOk) {
         if (strongRuntimeTruth) {
-            warningCodes.push("status_warn");
-            warnings.push("detailed status did not return STATUS ok, but loadProof/runtime/serve/routeFn proofs stayed healthy");
+            if (!crossProfileCoverageGapOnly) {
+                warningCodes.push("status_warn");
+                warnings.push("detailed status did not return STATUS ok, but loadProof/runtime/serve/routeFn proofs stayed healthy");
+            }
         }
         else {
             runtimeTruthGaps.push("status_ok");
@@ -870,6 +885,7 @@ export function captureOperatorProofBundle(options) {
         statusSignals,
         breadcrumbs,
         runtimeLoadProofSnapshot,
+        coverageSnapshot,
         openclawHome: options.openclawHome,
     });
     const hardeningSnapshot = buildHardeningSnapshot({

package/extension/index.ts

@@ -2,7 +2,7 @@
  * OpenClawBrain extension template — canonical, pre-built, versioned with the package.
  *
  * The placeholder __ACTIVATION_ROOT__ is replaced by
- * `@openclawbrain/cli`'s `openclawbrain install`
+ * OpenClawBrain's `openclawbrain install`
  * with the real activation root path at install time.
  *
  * Design constraints:
@@ -91,7 +91,7 @@ function announceStartupBreadcrumb(): void {
   if (isActivationRootPlaceholder(ACTIVATION_ROOT)) {
     warnOnce(
       "startup-brain-not-yet-loaded",
-      "[openclawbrain] BRAIN NOT YET LOADED: install has not pinned ACTIVATION_ROOT yet. Install @openclawbrain/cli, then run: openclawbrain install --openclaw-home <path>"
+      "[openclawbrain] BRAIN NOT YET LOADED: install has not pinned ACTIVATION_ROOT yet. Install OpenClawBrain, then run: openclawbrain install --openclaw-home <path>"
     );
     return;
   }

package/extension/runtime-guard.ts

@@ -162,7 +162,7 @@ export function createBeforePromptBuildHandler(input: {
         key: "activation-root-placeholder",
         once: true,
         message:
-          "[openclawbrain] BRAIN NOT YET LOADED: ACTIVATION_ROOT is still a placeholder. Install @openclawbrain/cli, then run: openclawbrain install --openclaw-home <path>"
+          "[openclawbrain] BRAIN NOT YET LOADED: ACTIVATION_ROOT is still a placeholder. Install OpenClawBrain, then run: openclawbrain install --openclaw-home <path>"
       }));
       return {};
     }

package/package.json

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