@openclawbrain/openclaw 0.3.2 → 0.3.3

package/README.md

@@ -103,7 +103,6 @@ Keep `install` as the front-door lifecycle command:
 
 - `openclawbrain install` is the default attach path. On many-profile hosts, pass `--openclaw-home <path>` or set `OPENCLAW_HOME` so the target profile is explicit instead of guessed.
 - `openclawbrain install` now writes only the real profile hook and activation state. It no longer creates `BRAIN.md` or rewrites `AGENTS.md`.
-- for the `0.3.2` semantic/gating structure wave, use a fresh activation root or `uninstall --purge-data` plus reinstall when you want the new structure cleanly; in-place upgrade keeps existing learned material and does not rewrite it retroactively
 - `openclawbrain detach --openclaw-home <path>` removes only the OpenClaw profile hook. It preserves OpenClawBrain activation data and now says so plainly in both human output and JSON.
 - `openclawbrain uninstall --openclaw-home <path> --keep-data|--purge-data` removes the profile hook and forces the operator to pick the data outcome explicitly.
 - `--restart <never|safe|external>` is guidance only for detach/uninstall. The default `safe` guidance stays conservative: restart the running OpenClaw profile before expecting hook-state changes to take effect; otherwise the next launch picks them up.

package/dist/extension/index.js

@@ -10,7 +10,7 @@
  *   - Missing activation root → fail-open with console.warn
  */
 import { fileURLToPath } from "node:url";
-import { compileRuntimeContext } from "@openclawbrain/openclaw";
+import { compileRuntimeContext, recordOpenClawProfileRuntimeLoadProof } from "@openclawbrain/openclaw";
 import { createBeforePromptBuildHandler, isActivationRootPlaceholder, validateExtensionRegistrationApi } from "./runtime-guard.js";
 const ACTIVATION_ROOT = "__ACTIVATION_ROOT__";
 const EXTENSION_ENTRY_PATH = fileURLToPath(import.meta.url);
@@ -67,6 +67,22 @@ export default function register(api) {
             reportDiagnostic,
             debug: (message) => console.debug(message)
         }), { priority: 5 });
+        if (!isActivationRootPlaceholder(ACTIVATION_ROOT)) {
+            try {
+                recordOpenClawProfileRuntimeLoadProof({
+                    activationRoot: ACTIVATION_ROOT,
+                    extensionEntryPath: EXTENSION_ENTRY_PATH
+                });
+            }
+            catch (error) {
+                const detail = error instanceof Error ? error.message : String(error);
+                void reportDiagnostic({
+                    key: `runtime-load-proof:${detail}`,
+                    once: true,
+                    message: `[openclawbrain] runtime load proof failed: ${detail}`
+                });
+            }
+        }
         announceStartupBreadcrumb();
     }
     catch (error) {

package/dist/extension/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../extension/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../extension/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EACL,qBAAqB,EACrB,qCAAqC,EACtC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC3B,gCAAgC,EACjC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAC9C,MAAM,oBAAoB,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5D,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE5C,SAAS,QAAQ,CAAC,GAAW,EAAE,OAAe;IAC5C,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO;IACT,CAAC;IAED,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,wBAAwB,CAAC,OAAe;IACrD,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,iBAAiB,CAAC;QACjD,MAAM,OAAO,GAAG,GAAG,OAAO,uBAAuB,CAAC;QAClD,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACrG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,QAAQ,CACN,wBAAwB,MAAM,EAAE,EAChC,oEAAoE,MAAM,EAAE,CAC7E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,KAAuD;IACrF,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,IAAI,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,OAAO;QACT,CAAC;QACD,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5B,MAAM,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,yBAAyB;IAChC,IAAI,2BAA2B,CAAC,eAAe,CAAC,EAAE,CAAC;QACjD,QAAQ,CACN,8BAA8B,EAC9B,qIAAqI,CACtI,CAAC;QACF,OAAO;IACT,CAAC;IAED,QAAQ,CACN,sBAAsB,EACtB,iGAAiG,eAAe,GAAG,CACpH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAY;IAC3C,MAAM,YAAY,GAAG,gCAAgC,CAAC,GAAG,CAAC,CAAC;IAC3D,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;QACrB,KAAK,gBAAgB,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC/C,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,YAAY,CAAC,GAAG,CAAC,EAAE,CACjB,qBAAqB,EACrB,8BAA8B,CAAC;YAC7B,cAAc,EAAE,eAAe;YAC/B,kBAAkB,EAAE,oBAAoB;YACxC,qBAAqB;YACrB,gBAAgB;YAChB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;SAC3C,CAAC,EACF,EAAE,QAAQ,EAAE,CAAC,EAAE,CAChB,CAAC;QACF,IAAI,CAAC,2BAA2B,CAAC,eAAe,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC;gBACH,qCAAqC,CAAC;oBACpC,cAAc,EAAE,eAAe;oBAC/B,kBAAkB,EAAE,oBAAoB;iBACzC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtE,KAAK,gBAAgB,CAAC;oBACpB,GAAG,EAAE,sBAAsB,MAAM,EAAE;oBACnC,IAAI,EAAE,IAAI;oBACV,OAAO,EAAE,8CAA8C,MAAM,EAAE;iBAChE,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,yBAAyB,EAAE,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrF,KAAK,gBAAgB,CAAC;YACpB,GAAG,EAAE,qBAAqB;YAC1B,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,kDAAkD,MAAM,EAAE;SACpE,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/src/attachment-truth.d.ts

@@ -0,0 +1,34 @@
+import { type OpenClawHomeInspection } from "./openclaw-home-layout.js";
+declare const ATTACHMENT_RUNTIME_LOAD_PROOFS_CONTRACT: "openclaw_profile_runtime_load_proofs.v1";
+export interface OpenClawProfileRuntimeLoadProofRecordV1 {
+    openclawHome: string;
+    profileId: string | null;
+    profileSource: OpenClawHomeInspection["profileSource"];
+    loadedAt: string;
+    extensionEntryPath: string;
+}
+export interface OpenClawProfileRuntimeLoadProofsV1 {
+    contract: typeof ATTACHMENT_RUNTIME_LOAD_PROOFS_CONTRACT;
+    runtimeOwner: "openclaw";
+    activationRoot: string;
+    updatedAt: string;
+    profiles: OpenClawProfileRuntimeLoadProofRecordV1[];
+}
+export interface OpenClawProfileRuntimeLoadProofSetV1 {
+    path: string;
+    proofs: OpenClawProfileRuntimeLoadProofsV1 | null;
+    error: string | null;
+}
+export declare function resolveAttachmentRuntimeLoadProofsPath(activationRoot: string): string;
+export declare function listOpenClawProfileRuntimeLoadProofs(activationRoot: string): OpenClawProfileRuntimeLoadProofSetV1;
+export declare function recordOpenClawProfileRuntimeLoadProof(input: {
+    activationRoot: string;
+    extensionEntryPath: string;
+    loadedAt?: string | null;
+}): OpenClawProfileRuntimeLoadProofRecordV1;
+export declare function clearOpenClawProfileRuntimeLoadProof(input: {
+    activationRoot: string;
+    openclawHome: string;
+    clearedAt?: string | null;
+}): boolean;
+export {};

package/dist/src/attachment-truth.js

@@ -0,0 +1,215 @@
+import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { inspectOpenClawHome } from "./openclaw-home-layout.js";
+const ATTACHMENT_RUNTIME_LOAD_PROOFS_CONTRACT = "openclaw_profile_runtime_load_proofs.v1";
+const ATTACHMENT_TRUTH_DIRNAME = "attachment-truth";
+const ATTACHMENT_RUNTIME_LOAD_PROOFS_BASENAME = "runtime-load-proofs.json";
+function toErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function canonicalizeFilesystemPath(filePath) {
+    const resolvedPath = path.resolve(filePath);
+    try {
+        return realpathSync(resolvedPath);
+    }
+    catch {
+        return resolvedPath;
+    }
+}
+function normalizeIsoTimestamp(value, fieldName, fallbackValue) {
+    const candidate = value ?? fallbackValue;
+    if (candidate === undefined || candidate === null || candidate.trim().length === 0) {
+        throw new Error(`${fieldName} is required`);
+    }
+    if (Number.isNaN(Date.parse(candidate))) {
+        throw new Error(`${fieldName} must be an ISO timestamp`);
+    }
+    return new Date(candidate).toISOString();
+}
+function readRecord(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+function validateRuntimeLoadProofRecord(value, index) {
+    const record = readRecord(value);
+    if (record === null) {
+        throw new Error(`profiles[${index}] must be an object`);
+    }
+    const openclawHome = typeof record.openclawHome === "string" && record.openclawHome.trim().length > 0
+        ? canonicalizeFilesystemPath(record.openclawHome)
+        : null;
+    const profileId = record.profileId === null ? null : typeof record.profileId === "string" && record.profileId.trim().length > 0
+        ? record.profileId.trim()
+        : undefined;
+    const profileSource = record.profileSource === "openclaw_json_profile" ||
+        record.profileSource === "openclaw_json_single_profile_key" ||
+        record.profileSource === "directory_name" ||
+        record.profileSource === "none"
+        ? record.profileSource
+        : null;
+    const extensionEntryPath = typeof record.extensionEntryPath === "string" && record.extensionEntryPath.trim().length > 0
+        ? canonicalizeFilesystemPath(record.extensionEntryPath)
+        : null;
+    const loadedAt = typeof record.loadedAt === "string" && record.loadedAt.trim().length > 0
+        ? normalizeIsoTimestamp(record.loadedAt, `profiles[${index}].loadedAt`)
+        : null;
+    if (openclawHome === null) {
+        throw new Error(`profiles[${index}].openclawHome must be a non-empty string`);
+    }
+    if (profileId === undefined) {
+        throw new Error(`profiles[${index}].profileId must be null or a non-empty string`);
+    }
+    if (profileSource === null) {
+        throw new Error(`profiles[${index}].profileSource must be a supported OpenClaw profile source`);
+    }
+    if (extensionEntryPath === null) {
+        throw new Error(`profiles[${index}].extensionEntryPath must be a non-empty string`);
+    }
+    if (loadedAt === null) {
+        throw new Error(`profiles[${index}].loadedAt must be a non-empty ISO timestamp`);
+    }
+    return {
+        openclawHome,
+        profileId,
+        profileSource,
+        extensionEntryPath,
+        loadedAt
+    };
+}
+function validateRuntimeLoadProofs(activationRoot, value) {
+    const record = readRecord(value);
+    if (record === null) {
+        throw new Error("runtime load proof file must contain an object");
+    }
+    if (record.contract !== ATTACHMENT_RUNTIME_LOAD_PROOFS_CONTRACT) {
+        throw new Error(`runtime load proof contract must be ${ATTACHMENT_RUNTIME_LOAD_PROOFS_CONTRACT}`);
+    }
+    if (record.runtimeOwner !== "openclaw") {
+        throw new Error("runtime load proof runtimeOwner must be openclaw");
+    }
+    if (typeof record.activationRoot !== "string" || record.activationRoot.trim().length === 0) {
+        throw new Error("runtime load proof activationRoot must be a non-empty string");
+    }
+    const resolvedActivationRoot = path.resolve(record.activationRoot);
+    if (resolvedActivationRoot !== activationRoot) {
+        throw new Error(`runtime load proof activationRoot mismatch: expected ${activationRoot}, received ${resolvedActivationRoot}`);
+    }
+    const updatedAt = typeof record.updatedAt === "string" && record.updatedAt.trim().length > 0
+        ? normalizeIsoTimestamp(record.updatedAt, "updatedAt")
+        : null;
+    if (updatedAt === null) {
+        throw new Error("runtime load proof updatedAt must be a non-empty ISO timestamp");
+    }
+    if (!Array.isArray(record.profiles)) {
+        throw new Error("runtime load proof profiles must be an array");
+    }
+    const profiles = record.profiles.map((entry, index) => validateRuntimeLoadProofRecord(entry, index));
+    return {
+        contract: ATTACHMENT_RUNTIME_LOAD_PROOFS_CONTRACT,
+        runtimeOwner: "openclaw",
+        activationRoot,
+        updatedAt,
+        profiles
+    };
+}
+function buildEmptyRuntimeLoadProofs(activationRoot, updatedAt) {
+    return {
+        contract: ATTACHMENT_RUNTIME_LOAD_PROOFS_CONTRACT,
+        runtimeOwner: "openclaw",
+        activationRoot,
+        updatedAt,
+        profiles: []
+    };
+}
+function writeRuntimeLoadProofs(proofPath, proofs) {
+    mkdirSync(path.dirname(proofPath), { recursive: true });
+    writeFileSync(proofPath, `${JSON.stringify(proofs, null, 2)}\n`, "utf8");
+}
+function deriveOpenClawHomeFromExtensionEntryPath(extensionEntryPath) {
+    return canonicalizeFilesystemPath(path.resolve(path.dirname(canonicalizeFilesystemPath(extensionEntryPath)), "..", ".."));
+}
+export function resolveAttachmentRuntimeLoadProofsPath(activationRoot) {
+    return path.join(path.resolve(activationRoot), ATTACHMENT_TRUTH_DIRNAME, ATTACHMENT_RUNTIME_LOAD_PROOFS_BASENAME);
+}
+export function listOpenClawProfileRuntimeLoadProofs(activationRoot) {
+    const resolvedActivationRoot = path.resolve(activationRoot);
+    const proofPath = resolveAttachmentRuntimeLoadProofsPath(resolvedActivationRoot);
+    if (!existsSync(proofPath)) {
+        return {
+            path: proofPath,
+            proofs: null,
+            error: null
+        };
+    }
+    try {
+        const parsed = JSON.parse(readFileSync(proofPath, "utf8"));
+        return {
+            path: proofPath,
+            proofs: validateRuntimeLoadProofs(resolvedActivationRoot, parsed),
+            error: null
+        };
+    }
+    catch (error) {
+        return {
+            path: proofPath,
+            proofs: null,
+            error: toErrorMessage(error)
+        };
+    }
+}
+export function recordOpenClawProfileRuntimeLoadProof(input) {
+    const activationRoot = path.resolve(input.activationRoot);
+    const loadedAt = normalizeIsoTimestamp(input.loadedAt, "loadedAt", new Date().toISOString());
+    const extensionEntryPath = canonicalizeFilesystemPath(input.extensionEntryPath);
+    const openclawHome = deriveOpenClawHomeFromExtensionEntryPath(extensionEntryPath);
+    const inspection = inspectOpenClawHome(openclawHome);
+    const loadedProofs = listOpenClawProfileRuntimeLoadProofs(activationRoot);
+    if (loadedProofs.error !== null) {
+        throw new Error(`runtime load proof file ${loadedProofs.path} is unreadable: ${loadedProofs.error}`);
+    }
+    const nextRecord = {
+        openclawHome: canonicalizeFilesystemPath(openclawHome),
+        profileId: inspection.profileId,
+        profileSource: inspection.profileSource,
+        loadedAt,
+        extensionEntryPath
+    };
+    const nextProofs = loadedProofs.proofs === null
+        ? buildEmptyRuntimeLoadProofs(activationRoot, loadedAt)
+        : {
+            ...loadedProofs.proofs,
+            updatedAt: loadedAt,
+            profiles: [...loadedProofs.proofs.profiles]
+        };
+    nextProofs.profiles = nextProofs.profiles
+        .filter((record) => canonicalizeFilesystemPath(record.openclawHome) !== nextRecord.openclawHome)
+        .concat(nextRecord)
+        .sort((left, right) => left.openclawHome.localeCompare(right.openclawHome));
+    writeRuntimeLoadProofs(loadedProofs.path, nextProofs);
+    return nextRecord;
+}
+export function clearOpenClawProfileRuntimeLoadProof(input) {
+    const activationRoot = path.resolve(input.activationRoot);
+    const clearedAt = normalizeIsoTimestamp(input.clearedAt, "clearedAt", new Date().toISOString());
+    const openclawHome = canonicalizeFilesystemPath(input.openclawHome);
+    const loadedProofs = listOpenClawProfileRuntimeLoadProofs(activationRoot);
+    if (loadedProofs.error !== null) {
+        throw new Error(`runtime load proof file ${loadedProofs.path} is unreadable: ${loadedProofs.error}`);
+    }
+    if (loadedProofs.proofs === null) {
+        return false;
+    }
+    const filteredProfiles = loadedProofs.proofs.profiles.filter((record) => canonicalizeFilesystemPath(record.openclawHome) !== openclawHome);
+    if (filteredProfiles.length === loadedProofs.proofs.profiles.length) {
+        return false;
+    }
+    writeRuntimeLoadProofs(loadedProofs.path, {
+        ...loadedProofs.proofs,
+        updatedAt: clearedAt,
+        profiles: filteredProfiles
+    });
+    return true;
+}
+//# sourceMappingURL=attachment-truth.js.map

package/dist/src/attachment-truth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-truth.js","sourceRoot":"","sources":["../../src/attachment-truth.ts"],"names":[],"mappings":"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"}