@openclawbrain/openclaw 0.1.2 → 0.1.3

package/README.md

@@ -2,31 +2,32 @@
 
 OpenClaw integration helpers for promoted-pack compile consumption and normalized event emission.
 
-Use this package when OpenClaw needs a narrow, typed bridge over promoted packs:
+Use this package when OpenClaw needs the narrow supported operator bridge captured by `OPERATOR_API_CONTRACT_V1`:
 
-- bootstrap an initial attach pack from a normalized export and activate it
-- resolve the active promoted pack from activation pointers
-- consume `runtime_compile.v1` through an activation-aware serve-path helper
-- surface compact attach status over activation health, active pack freshness, and compile/handoff evidence
-- surface learned-route diagnostics alongside compiled context
-- emit normalized interaction and feedback events for learner handoff
-- optionally write learner-facing event-export bundles on disk
-- run a bounded async teacher loop that converts normalized exports into canonical supervision artifacts and future learner inputs
-- feed learner-side PG route refreshes only with explicit collected labels rather than heuristic learned-label propagation
-- keep the post-attach loop real with canonical supervision, bounded learner refresh, candidate promotion, and later compile freshness
+- bootstrap an initial attach pack from a normalized export, or truthfully self-boot from zero events, and activate it
+- inspect attach status and canonical current-profile operator truth
+- emit deterministic normalized event-export bundles for learner handoff
+- refresh learner state into candidate packs through the learner boundary
+- stage/promote/rollback activation pointers explicitly
+- prove local activation, freshness, learned-route, and kernel-vs-brain boundaries through observability surfaces
 
-The post-attach loop stays off the hot path: it exports turns, builds candidate packs, and promotes them later rather than mutating the current active pack in place.
+The supported operator contract is intentionally decomposed into bootstrap/attach, status, export, refresh, promote, rollback, and proof/observability. The post-attach loop stays off the hot path: it exports turns, builds candidate packs, and promotes them later rather than mutating the current active pack in place.
+
+Read `docs/operator-api-contract.md` for the family-by-family contract map and the explicitly quarantined surfaces.
+
+For first install, the boring path is intentionally simple: pass `interactionEvents: []` / `feedbackEvents: []` when you have no live turns yet, or hand `bootstrapRuntimeAttach()` a zero-event `normalizedEventExport` payload and let it canonicalize the derived range/provenance fields from the embedded event arrays. The resulting attach stays truthful with `awaiting_first_export` until the first live export lands; truly invalid non-empty exports fail with attach-specific remediation instead of a raw provenance validator surprise.
 
 ```ts
 import {
+  OPERATOR_API_CONTRACT_V1,
   bootstrapRuntimeAttach,
-  compileRuntimeContext,
   describeAttachStatus,
-  rollbackRuntimeAttach,
-  runContinuousProductLoopTurn,
-  runRuntimeTurn
+  describeCurrentProfileBrainStatus,
+  rollbackRuntimeAttach
 } from "@openclawbrain/openclaw";
 
+console.log(OPERATOR_API_CONTRACT_V1.families);
+
 const attach = bootstrapRuntimeAttach({
   activationRoot: "/var/openclawbrain/activation",
   packRoot: "/var/openclawbrain/packs/bootstrap",
@@ -53,6 +54,15 @@ console.log(attachStatus.compile?.handoffState);
 console.log(attachStatus.landingBoundaries.compileBoundary.activationSlot);
 console.log(attachStatus.landingBoundaries.failOpenSemantics.eventExportWriteFailurePreservesCompile);
 
+const currentProfile = describeCurrentProfileBrainStatus({
+  activationRoot: "/var/openclawbrain/activation",
+  brainAttachmentPolicy: "dedicated"
+});
+
+console.log(currentProfile.profile.selector);
+console.log(currentProfile.attachment.policyMode);
+console.log(currentProfile.brainStatus.serveState);
+
 const rollbackPreview = rollbackRuntimeAttach({
   activationRoot: "/var/openclawbrain/activation",
   dryRun: true
@@ -62,63 +72,36 @@ console.log(rollbackPreview.allowed);
 console.log(rollbackPreview.before.activePackId);
 console.log(rollbackPreview.after?.activePackId);
 
-const compileResult = compileRuntimeContext({
-  activationRoot: "/var/openclawbrain/activation",
-  message: "feedback scanner route gating",
-  runtimeHints: ["feedback scanner"]
-});
+```
 
-if (compileResult.ok) {
-  console.log(compileResult.compileResponse.diagnostics.usedLearnedRouteFn);
-  console.log(compileResult.compileResponse.diagnostics.routerIdentity);
-}
-
-const turnResult = runRuntimeTurn(
-  {
-    sessionId: "session-123",
-    channel: "whatsapp",
-    userMessage: "feedback scanner route gating",
-    compile: {
-      createdAt: "2026-03-07T17:01:00.000Z"
-    },
-    delivery: {
-      createdAt: "2026-03-07T17:02:00.000Z",
-      messageId: "msg-123"
-    },
-    export: {
-      rootDir: "/var/openclawbrain/exports/session-123"
-    }
-  },
-  {
-    activationRoot: "/var/openclawbrain/activation"
-  }
-);
+This package stays fail-open for non-learned-required compile misses, and event-export write failures do not erase successful compile output.
 
-const productLoopTurn = runContinuousProductLoopTurn({
-  activationRoot: "/var/openclawbrain/activation",
-  loopRoot: "/var/openclawbrain/runtime-loop",
-  packLabel: "post-attach-loop",
-  workspace: {
-    workspaceId: "workspace-1",
-    snapshotId: "workspace-1@snapshot-2",
-    capturedAt: "2026-03-07T18:00:30.000Z",
-    rootDir: "/workspace/openclawbrain",
-    revision: "runtime-loop-rev-2"
-  },
-  turn: {
-    sessionId: "session-123",
-    channel: "whatsapp",
-    userMessage: "Compile the fresher learned route artifact after promotion.",
-    feedback: [{ content: "Prefer the fresher learned route artifact after promotion." }]
-  }
-});
+## Narrow operator contract
 
-console.log(productLoopTurn.compileActiveVersion);
-console.log(productLoopTurn.learning.promoted);
-console.log(productLoopTurn.state.currentActivePack?.routerIdentity);
-```
+Treat these as the supported operator families for Wave 1:
 
-This package stays fail-open for non-learned-required compile misses, and event-export write failures do not erase successful compile output.
+- bootstrap / attach — `bootstrapRuntimeAttach()`, `describeAttachStatus()`
+- status / rollback — `openclawbrain-ops ...`, `describeCurrentProfileBrainStatus()`, `formatOperatorRollbackReport()`
+- export — `buildNormalizedRuntimeEventExport()`, `writeRuntimeEventExportBundle()`, `loadRuntimeEventExportBundle()`
+- proof / observability — `describeAttachStatus()`, `describeKernelBrainBoundary()`, `describeActivationObservability()`
+
+The refresh and promote families stay explicit in their owning packages instead of being hidden behind a catch-all convenience wrapper:
+
+- refresh — `@openclawbrain/learner.createAlwaysOnLearningRuntimeState()`, `advanceAlwaysOnLearningRuntime()`, `materializeAlwaysOnLearningCandidatePack()`
+- promote — `@openclawbrain/pack-format.stageCandidatePack()`, `promoteCandidatePack()`
+
+Wrong-shaped surfaces are intentionally quarantined from this contract even if they remain exported elsewhere for proof or integration work:
+
+- `openclawbrain-ops doctor`
+- `buildOperatorSurfaceReport()`
+- `formatOperatorStatusReport()`
+- `formatOperatorDoctorReport()`
+- `runContinuousProductLoopTurn()`
+- `runRecordedSessionReplay()`
+- `runRuntimeTurn()`
+- `createAsyncTeacherLiveLoop()`
+
+For one repo-local end-to-end proof of the full attach -> status -> run turn -> export -> refresh -> promote -> status story, run `pnpm current-profile-lifecycle:smoke` from the workspace root. That harness prints the before/after canonical current-profile answer, the matching compact `status` summary plus `status --json` proof built from those same snapshots, and the active graph/router/objective/weights/freshness checksum changes that became true only after promotion.
 
 ## Boundary truth
 
@@ -135,12 +118,11 @@ Operator-facing CLI:
 
 ```bash
 pnpm exec openclawbrain-ops status --activation-root /var/openclawbrain/activation --event-export /var/openclawbrain/exports/latest --teacher-snapshot /var/openclawbrain/runtime/teacher-snapshot.json
-pnpm exec openclawbrain-ops doctor --activation-root /var/openclawbrain/activation --event-export /var/openclawbrain/exports/latest --teacher-snapshot /var/openclawbrain/runtime/teacher-snapshot.json
 pnpm exec openclawbrain-ops rollback --activation-root /var/openclawbrain/activation --dry-run
 ```
 
-- `status` prints a compressed one-screen summary of active/candidate pack truth, brain handoff state, serve-path fail-open status, route freshness, supervision flow, live-vs-backfill learning mode, the last async no-op reason, and rollback readiness
-- `doctor` prints explicit `PASS` / `WARN` / `FAIL` findings and exits `1` only when a hard serve-path failure exists
+- `status --json` emits the canonical `current_profile_brain_status.v1` answer; plain `status` prints a compact summary derived from that same object
+- `describeCurrentProfileBrainStatus()` freezes the current-profile `Host / Profile / Brain / Attachment` answer shape instead of widening to a second report payload
 - `rollback --dry-run` previews the exact `active <- previous` and `active -> candidate` move before you apply rollback for real
 - `--event-export` accepts either a runtime event-export bundle root or a normalized-export JSON payload
 - `--teacher-snapshot` accepts JSON from `teacherLoop.snapshot()` or `await teacherLoop.flush()` when you want the last duplicate/no-op reason plus learner bootstrapped/mode/next-lane backlog truth kept visible
@@ -150,6 +132,14 @@ Programmatic rollback is available too:
 - `rollbackRuntimeAttach({ activationRoot, dryRun: true })` previews the move without changing activation pointers
 - `rollbackRuntimeAttach({ activationRoot })` applies the rollback and reports which pack was restored to `active`
 
+Wave 1 also freezes shared-vs-dedicated brain policy semantics:
+
+- `brainAttachmentPolicy: "dedicated"` means one current profile is intentionally attached to one Brain activation root until operators reattach it elsewhere
+- `brainAttachmentPolicy: "shared"` means multiple profiles may intentionally attach to the same Brain activation root, so attribution must stay current-profile explicit and operators must not read served context as profile-exclusive
+- `brainAttachmentPolicy: "undeclared"` is the truthful fallback when the host has not declared which policy it is using
+
+Per-turn normalized interaction and feedback events can carry the same current-profile attribution fields so later learner/export analysis can see `brainStatus`, `brainAttachmentPolicy`, pack/router identity, and selection evidence turn by turn.
+
 The learned-required serve path is stricter:
 
 - `compileRuntimeContext()` now forwards the active-slot diagnostics from `@openclawbrain/compiler.compileRuntimeFromActivation()`

package/dist/src/cli.d.ts

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { type OperatorSurfaceInput } from "./index.js";
+import { type CurrentProfileBrainStatusInput } from "./index.js";
 interface ParsedOperatorCliArgs {
-    command: "status" | "doctor" | "rollback";
-    input: OperatorSurfaceInput;
+    command: "status" | "rollback";
+    input: CurrentProfileBrainStatusInput;
     json: boolean;
     help: boolean;
     dryRun: boolean;

package/dist/src/cli.js

@@ -1,44 +1,71 @@
 #!/usr/bin/env node
 import path from "node:path";
 import { pathToFileURL } from "node:url";
-import { buildOperatorSurfaceReport, formatOperatorDoctorReport, formatOperatorRollbackReport, formatOperatorStatusReport, rollbackRuntimeAttach } from "./index.js";
+import { describeCurrentProfileBrainStatus, formatOperatorRollbackReport, rollbackRuntimeAttach } from "./index.js";
 function operatorCliHelp() {
     return [
         "Usage:",
-        "  openclawbrain-ops <status|doctor|rollback> --activation-root <path> [options]",
+        "  openclawbrain-ops <status|rollback> --activation-root <path> [options]",
         "",
         "Options:",
         "  --activation-root <path>    Activation root to inspect.",
         "  --event-export <path>       Event-export bundle root or normalized export JSON payload.",
         "  --teacher-snapshot <path>   Async teacher snapshot JSON from teacherLoop.snapshot()/flush().",
         "  --updated-at <iso>          Observation time to use for freshness checks.",
+        "  --brain-attachment-policy <undeclared|dedicated|shared>  Override attachment policy semantics for status inspection.",
         "  --dry-run                   Preview rollback pointer movement without writing activation state.",
         "  --json                      Emit machine-readable JSON instead of text.",
         "  --help                      Show this help.",
         "",
         "Common flow:",
-        "  1. status   quick attach / first-value / rollback summary",
-        "  2. doctor   explicit PASS / WARN / FAIL findings",
-        "  3. rollback --dry-run   preview active <- previous, active -> candidate",
-        "  4. rollback             apply the rollback when the preview says ready",
+        "  0. bootstrap  call bootstrapRuntimeAttach() to activate an initial pack on first install",
+        "  1. status --json   read the canonical current_profile_brain_status.v1 object",
+        "  2. rollback --dry-run   preview active <- previous, active -> candidate",
+        "  3. rollback             apply the rollback when the preview says ready",
         "",
         "Exit codes:",
         "  status: 0 on successful inspection, 1 on input/read failure.",
-        "  doctor: 0 when no FAIL findings are present, 1 otherwise.",
         "  rollback: 0 when ready/applied, 1 when blocked or on input/read failure."
     ].join("\n");
 }
+function yesNo(value) {
+    if (value === null) {
+        return "unknown";
+    }
+    return value ? "yes" : "no";
+}
+function formatCurrentProfileStatusSummary(status) {
+    return [
+        `STATUS ${status.brainStatus.status}`,
+        `summary     ${status.brain.summary}`,
+        `host        runtime=${status.host.runtimeOwner} activation=${status.host.activationRoot}`,
+        `profile     selector=${status.profile.selector} attachment=${status.attachment.state} policy=${status.attachment.policyMode}`,
+        `brain       pack=${status.brain.activePackId ?? "none"} state=${status.brain.state} init=${status.brain.initMode ?? "unknown"} routeFreshness=${status.brain.routeFreshness} router=${status.brain.routerIdentity ?? "none"}`,
+        `serve       state=${status.brainStatus.serveState} usedRouteFn=${yesNo(status.brainStatus.usedLearnedRouteFn)} awaitingFirstExport=${yesNo(status.brainStatus.awaitingFirstExport)} detail=${status.brainStatus.detail}`,
+        `turn        attribution=${status.currentTurnAttribution === null ? "none" : status.currentTurnAttribution.contract}`
+    ].join("\n");
+}
+function requireActivationRoot(input, command) {
+    if (input.activationRoot.trim().length === 0) {
+        throw new Error(`--activation-root is required for ${command}`);
+    }
+    return path.resolve(input.activationRoot);
+}
 export function parseOperatorCliArgs(argv) {
     let command = "status";
     let activationRoot = null;
     let eventExportPath = null;
     let teacherSnapshotPath = null;
     let updatedAt = null;
+    let brainAttachmentPolicy = null;
     let json = false;
     let help = false;
     let dryRun = false;
     const args = [...argv];
-    if (args[0] === "status" || args[0] === "doctor" || args[0] === "rollback") {
+    if (args[0] === "doctor") {
+        throw new Error("`doctor` was deleted. Use `status --json` for the canonical current-profile status object and proof helpers for deeper activation diagnostics.");
+    }
+    if (args[0] === "status" || args[0] === "rollback") {
         command = args.shift();
     }
     for (let index = 0; index < args.length; index += 1) {
@@ -88,6 +115,17 @@ export function parseOperatorCliArgs(argv) {
             index += 1;
             continue;
         }
+        if (arg === "--brain-attachment-policy") {
+            if (next === undefined) {
+                throw new Error("--brain-attachment-policy requires a value");
+            }
+            if (next !== "undeclared" && next !== "dedicated" && next !== "shared") {
+                throw new Error(`invalid --brain-attachment-policy value: ${next}`);
+            }
+            brainAttachmentPolicy = next;
+            index += 1;
+            continue;
+        }
         throw new Error(`unknown argument: ${arg}`);
     }
     return {
@@ -96,7 +134,8 @@ export function parseOperatorCliArgs(argv) {
             activationRoot: activationRoot ?? "",
             eventExportPath,
             teacherSnapshotPath,
-            updatedAt
+            updatedAt,
+            brainAttachmentPolicy
         },
         json,
         help,
@@ -109,7 +148,7 @@ export function runOperatorCli(argv = process.argv.slice(2)) {
         console.log(operatorCliHelp());
         return 0;
     }
-    const activationRoot = path.resolve(parsed.input.activationRoot);
+    const activationRoot = requireActivationRoot(parsed.input, parsed.command);
     if (parsed.command === "rollback") {
         const result = rollbackRuntimeAttach({
             activationRoot,
@@ -124,20 +163,17 @@ export function runOperatorCli(argv = process.argv.slice(2)) {
         }
         return result.allowed ? 0 : 1;
     }
-    const report = buildOperatorSurfaceReport({
+    const status = describeCurrentProfileBrainStatus({
         ...parsed.input,
         activationRoot
     });
     if (parsed.json) {
-        console.log(JSON.stringify(report, null, 2));
-    }
-    else if (parsed.command === "doctor") {
-        console.log(formatOperatorDoctorReport(report));
+        console.log(JSON.stringify(status, null, 2));
     }
     else {
-        console.log(formatOperatorStatusReport(report));
+        console.log(formatCurrentProfileStatusSummary(status));
     }
-    return parsed.command === "doctor" && report.status === "fail" ? 1 : 0;
+    return 0;
 }
 if (process.argv[1] !== undefined && import.meta.url === pathToFileURL(process.argv[1]).href) {
     try {

package/dist/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EACL,iCAAiC,EACjC,4BAA4B,EAC5B,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AAUpB,SAAS,eAAe;IACtB,OAAO;QACL,QAAQ;QACR,0EAA0E;QAC1E,EAAE;QACF,UAAU;QACV,2DAA2D;QAC3D,2FAA2F;QAC3F,gGAAgG;QAChG,6EAA6E;QAC7E,wHAAwH;QACxH,mGAAmG;QACnG,2EAA2E;QAC3E,+CAA+C;QAC/C,EAAE;QACF,cAAc;QACd,4FAA4F;QAC5F,gFAAgF;QAChF,2EAA2E;QAC3E,0EAA0E;QAC1E,EAAE;QACF,aAAa;QACb,gEAAgE;QAChE,4EAA4E;KAC7E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,KAAK,CAAC,KAAqB;IAClC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9B,CAAC;AAED,SAAS,iCAAiC,CAAC,MAA4D;IACrG,OAAO;QACL,UAAU,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE;QACrC,eAAe,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;QACrC,uBAAuB,MAAM,CAAC,IAAI,CAAC,YAAY,eAAe,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE;QAC1F,wBAAwB,MAAM,CAAC,OAAO,CAAC,QAAQ,eAAe,MAAM,CAAC,UAAU,CAAC,KAAK,WAAW,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE;QAC9H,oBAAoB,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,MAAM,UAAU,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,SAAS,mBAAmB,MAAM,CAAC,KAAK,CAAC,cAAc,WAAW,MAAM,CAAC,KAAK,CAAC,cAAc,IAAI,MAAM,EAAE;QAC9N,qBAAqB,MAAM,CAAC,WAAW,CAAC,UAAU,gBAAgB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,wBAAwB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,mBAAmB,CAAC,WAAW,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE;QACzN,2BAA2B,MAAM,CAAC,sBAAsB,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,QAAQ,EAAE;KACtH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAqC,EAAE,OAAyC;IAC7G,IAAI,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,qCAAqC,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAuB;IAC1D,IAAI,OAAO,GAAqC,QAAQ,CAAC;IACzD,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,IAAI,eAAe,GAAkB,IAAI,CAAC;IAC1C,IAAI,mBAAmB,GAAkB,IAAI,CAAC;IAC9C,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,qBAAqB,GAA4D,IAAI,CAAC;IAC1F,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,gJAAgJ,CACjJ,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;QACnD,OAAO,GAAG,IAAI,CAAC,KAAK,EAAsC,CAAC;IAC7D,CAAC;IAED,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACrC,IAAI,GAAG,IAAI,CAAC;YACZ,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrB,IAAI,GAAG,IAAI,CAAC;YACZ,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,MAAM,GAAG,IAAI,CAAC;YACd,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,GAAG,KAAK,mBAAmB,EAAE,CAAC;YAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACxD,CAAC;YACD,cAAc,GAAG,IAAI,CAAC;YACtB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;YAC7B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACrD,CAAC;YACD,eAAe,GAAG,IAAI,CAAC;YACvB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,oBAAoB,EAAE,CAAC;YACjC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;YACzD,CAAC;YACD,mBAAmB,GAAG,IAAI,CAAC;YAC3B,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;YAC3B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,CAAC;YACD,SAAS,GAAG,IAAI,CAAC;YACjB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,2BAA2B,EAAE,CAAC;YACxC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAChE,CAAC;YACD,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvE,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,EAAE,CAAC,CAAC;YACtE,CAAC;YACD,qBAAqB,GAAG,IAAI,CAAC;YAC7B,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO;QACL,OAAO;QACP,KAAK,EAAE;YACL,cAAc,EAAE,cAAc,IAAI,EAAE;YACpC,eAAe;YACf,mBAAmB;YACnB,SAAS;YACT,qBAAqB;SACtB;QACD,IAAI;QACJ,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAA0B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;QAC/B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,cAAc,GAAG,qBAAqB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAE3E,IAAI,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,qBAAqB,CAAC;YACnC,cAAc;YACd,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACjF,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,MAAM,CAAC,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,MAAM,GAAG,iCAAiC,CAAC;QAC/C,GAAG,MAAM,CAAC,KAAK;QACf,cAAc;KACf,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7F,IAAI,CAAC;QACH,OAAO,CAAC,QAAQ,GAAG,cAAc,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACrF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/src/index.d.ts

@@ -1,4 +1,4 @@
-import { CONTRACT_IDS, type ArtifactManifestV1, type ActivationPointerRecordV1, type ActivationPointerSlot, type ContextCompactionMode, type FeedbackEventKind, type FeedbackEventV1, type KernelSurfaceValidationResultV1, type LearningBootProfile, type InteractionEventV1, type NormalizedEventExportV1, type RouteMode, type RuntimeCompileResponseV1, type RuntimeCompileTargetV1, type RuntimeGraphPlasticityStateV1, type RuntimePlasticitySourceV1, type SparseFeedbackPolicyV1, type TeacherSupervisionArtifactV1, type WorkspaceInjectionSurfaceV1 } from "@openclawbrain/contracts";
+import { CONTRACT_IDS, type ArtifactManifestV1, type ActivationPointerRecordV1, type ActivationPointerSlot, type RuntimeTurnBrainAttachmentPolicyV1, type ContextCompactionMode, type ContextContributionEvidenceStateV1, type CurrentProfileBrainStatusAnswerV1, type FeedbackEventKind, type FeedbackEventV1, type KernelSurfaceValidationResultV1, type LearningBootProfile, type InteractionEventV1, type NormalizedEventExportV1, type RouteMode, type RuntimeCompileResponseV1, type RuntimeCompileTargetV1, type RuntimeGraphPlasticityStateV1, type RuntimePlasticitySourceV1, type SparseFeedbackPolicyV1, type TeacherSupervisionArtifactV1, type WorkspaceInjectionSurfaceV1 } from "@openclawbrain/contracts";
 import { type AdvanceAlwaysOnLearningRuntimeInput, type AlwaysOnLearningCadenceV1, type AlwaysOnLearningMaterializationJobV1, type AlwaysOnLearningRuntimePlanV1, type AlwaysOnLearningRuntimeStateV1 } from "@openclawbrain/learner";
 import { type ActivationInspection, type ActivationObservabilityReport, type ActivationSlotInspection, type InitHandoffState } from "@openclawbrain/pack-format";
 export declare const DEFAULT_ASYNC_TEACHER_QUEUE_CAPACITY = 8;
@@ -82,7 +82,7 @@ export interface AttachStatusInput {
     activationRoot: string;
     compile?: false | Omit<CompileRuntimeContextInput, "activationRoot">;
 }
-export type ContextContributionEvidenceState = "route_fn_and_brain_context" | "brain_context_only" | "route_fn_only" | "stable_kernel_only" | "fail_open_static_context" | "hard_fail" | "unprobed";
+export type ContextContributionEvidenceState = ContextContributionEvidenceStateV1;
 export interface ContextAttributionSummaryV1 {
     selectedContextCount: number;
     stableKernelBlockCount: number;
@@ -245,6 +245,7 @@ export interface OpenClawRuntimeTurnInput {
     maxContextBlocks?: number;
     mode?: RouteMode;
     runtimeHints?: readonly string[];
+    brainAttachmentPolicy?: RuntimeTurnBrainAttachmentPolicyV1 | null;
     compile?: RuntimeTurnCompileInput | null;
     delivery?: boolean | RuntimeTurnDeliveryInput | null;
     feedback?: readonly (RuntimeTurnFeedbackInput | null)[] | null;
@@ -622,6 +623,111 @@ export declare function verifyRecordedSessionReplayBundleHashes(bundle: Recorded
 export type OperatorSurfaceStatus = "ok" | "warn" | "fail";
 export type OperatorFindingSeverity = "pass" | "warn" | "fail";
 export type OperatorLastPromotionConfidence = "proven_from_previous_pointer" | "unknown_from_local_pointers" | "no_active_pack";
+export declare const OPERATOR_API_CONTRACT_ID: "openclaw_operator_api.v1";
+export declare const SUPPORTED_OPERATOR_API_FAMILIES: readonly ["bootstrap_attach", "status", "export", "refresh", "promote", "rollback", "proof_observability"];
+export type SupportedOperatorApiFamily = (typeof SUPPORTED_OPERATOR_API_FAMILIES)[number];
+export type OperatorApiRouteScope = "cli" | "programmatic" | "proof_lane";
+export interface OperatorApiRouteDescriptor {
+    family: SupportedOperatorApiFamily;
+    scope: OperatorApiRouteScope;
+    packageName: string;
+    entrypoints: readonly string[];
+    summary: string;
+    notes: readonly string[];
+}
+export interface OperatorApiContractV1 {
+    contract: typeof OPERATOR_API_CONTRACT_ID;
+    runtimeOwner: "openclaw";
+    scope: "narrow_supported_operator_surface";
+    families: readonly SupportedOperatorApiFamily[];
+    routes: readonly OperatorApiRouteDescriptor[];
+    quarantinedSurface: readonly string[];
+}
+export declare const OPERATOR_API_CONTRACT_V1: {
+    readonly contract: "openclaw_operator_api.v1";
+    readonly runtimeOwner: "openclaw";
+    readonly scope: "narrow_supported_operator_surface";
+    readonly families: readonly ["bootstrap_attach", "status", "export", "refresh", "promote", "rollback", "proof_observability"];
+    readonly routes: readonly [{
+        readonly family: "bootstrap_attach";
+        readonly scope: "programmatic";
+        readonly packageName: "@openclawbrain/openclaw";
+        readonly entrypoints: readonly ["bootstrapRuntimeAttach", "describeAttachStatus"];
+        readonly summary: "Bootstrap the first attach pack and prove the initial handoff state without pretending live learning has already run.";
+        readonly notes: readonly ["Zero-event bootstrap is supported and stays explicit through awaiting_first_export.", "Attach serves only from activation's active slot after bootstrap completes."];
+    }, {
+        readonly family: "status";
+        readonly scope: "cli";
+        readonly packageName: "@openclawbrain/openclaw";
+        readonly entrypoints: readonly ["openclawbrain-ops status", "describeCurrentProfileBrainStatus"];
+        readonly summary: "Read the canonical current-profile brain-status object for the active Host/Profile/Brain/Attachment boundary.";
+        readonly notes: readonly ["Status is the first operator read path.", "describeCurrentProfileBrainStatus() freezes the supported Host/Profile/Brain/Attachment answer shape for the current profile.", "Use activation and export observability proof helpers when you need candidate/previous or export-freshness detail."];
+    }, {
+        readonly family: "export";
+        readonly scope: "programmatic";
+        readonly packageName: "@openclawbrain/openclaw";
+        readonly entrypoints: readonly ["buildNormalizedRuntimeEventExport", "writeRuntimeEventExportBundle", "loadRuntimeEventExportBundle"];
+        readonly summary: "Emit the deterministic learner handoff artifact explicitly instead of folding export into a larger implicit runtime loop.";
+        readonly notes: readonly ["Export is an off-hot-path operator handoff artifact, not proof of immediate active-pack mutation.", "Bundle roots and normalized payloads are both accepted downstream by observability surfaces."];
+    }, {
+        readonly family: "refresh";
+        readonly scope: "programmatic";
+        readonly packageName: "@openclawbrain/learner";
+        readonly entrypoints: readonly ["createAlwaysOnLearningRuntimeState", "advanceAlwaysOnLearningRuntime", "materializeAlwaysOnLearningCandidatePack"];
+        readonly summary: "Refresh candidate learning state explicitly through the learner boundary before any activation-pointer move happens.";
+        readonly notes: readonly ["Refresh is PG-only candidate-pack materialization in this repo.", "Refresh does not mutate the currently served active pack in place."];
+    }, {
+        readonly family: "promote";
+        readonly scope: "programmatic";
+        readonly packageName: "@openclawbrain/pack-format";
+        readonly entrypoints: readonly ["stageCandidatePack", "promoteCandidatePack"];
+        readonly summary: "Stage and promote activation-ready candidate packs through explicit pointer changes.";
+        readonly notes: readonly ["Promotion is the only path that changes which pack is served.", "Candidate and previous remain inspectable around the pointer move."];
+    }, {
+        readonly family: "rollback";
+        readonly scope: "cli";
+        readonly packageName: "@openclawbrain/openclaw";
+        readonly entrypoints: readonly ["openclawbrain-ops rollback", "rollbackRuntimeAttach", "formatOperatorRollbackReport"];
+        readonly summary: "Preview and apply the explicit active<-previous / active->candidate rollback move.";
+        readonly notes: readonly ["Rollback is blocked when the previous pointer is unavailable.", "Dry-run is the required first read path for safe operator rollback."];
+    }, {
+        readonly family: "proof_observability";
+        readonly scope: "programmatic";
+        readonly packageName: "@openclawbrain/openclaw";
+        readonly entrypoints: readonly ["describeAttachStatus", "describeKernelBrainBoundary"];
+        readonly summary: "Prove the local attach and kernel-vs-brain boundary from the shipped bridge surface.";
+        readonly notes: readonly ["Use these for repo-local or installed-package operator proof reads.", "These surfaces report the promoted artifact boundary, not full live runtime plasticity."];
+    }, {
+        readonly family: "proof_observability";
+        readonly scope: "programmatic";
+        readonly packageName: "@openclawbrain/pack-format";
+        readonly entrypoints: readonly ["describeActivationObservability"];
+        readonly summary: "Inspect activation health, freshness, route artifacts, rollback lineage, and slot readiness.";
+        readonly notes: readonly ["Activation observability is the ground truth for active/candidate/previous slot inspection."];
+    }, {
+        readonly family: "proof_observability";
+        readonly scope: "programmatic";
+        readonly packageName: "@openclawbrain/event-export";
+        readonly entrypoints: readonly ["describeNormalizedEventExportObservability"];
+        readonly summary: "Inspect supervision freshness and teacher freshness from the exported learner handoff artifact.";
+        readonly notes: readonly ["Export observability is local-to-export proof only."];
+    }, {
+        readonly family: "proof_observability";
+        readonly scope: "proof_lane";
+        readonly packageName: "workspace";
+        readonly entrypoints: readonly ["pnpm current-profile-lifecycle:smoke", "pnpm observability:smoke"];
+        readonly summary: "Run the repo-local proof lanes that derive operator truth from the canonical current-profile status object plus activation observability.";
+        readonly notes: readonly ["These lanes are proof machinery, not a second semver-stable API."];
+    }];
+    readonly quarantinedSurface: readonly ["openclawbrain-ops doctor was deleted; use the canonical current-profile status object plus proof helpers instead of a parallel troubleshooting surface.", "buildOperatorSurfaceReport / formatOperatorStatusReport / formatOperatorDoctorReport were historical parallel status surfaces and are not the supported operator API.", "runContinuousProductLoopTurn collapses export/refresh/promote into one proof helper and is not the supported operator API.", "runRecordedSessionReplay and recorded-session fixtures are proof helpers, not operator API.", "release scripts, root smoke plumbing, and workspace layout are proof-and-build machinery, not operator API.", "runRuntimeTurn is a runtime convenience wrapper and not the narrow operator export contract.", "createAsyncTeacherLiveLoop is supporting internals for refresh/teacher snapshots, not the narrow operator contract."];
+};
+export declare const OPENCLAW_OPERATOR_NOUNS_V1: readonly ["Host", "Profile", "Brain", "Attachment"];
+export declare const CURRENT_PROFILE_BRAIN_STATUS_CONTRACT: "current_profile_brain_status.v1";
+export declare const BRAIN_ATTACHMENT_POLICY_SEMANTICS_V1: {
+    readonly undeclared: "The Host has not declared whether the current Profile's Brain attachment policy is shared or dedicated; do not infer profile exclusivity from activation state alone.";
+    readonly dedicated: "The Host declares a dedicated Brain attachment policy: one Profile is intentionally attached to one Brain activation root, and operators may treat the served Brain state as profile-specific until the attachment changes.";
+    readonly shared: "The Host declares a shared Brain attachment policy: multiple Profiles may intentionally attach to the same Brain activation root, attribution must stay current-profile explicit, and operators must not treat later served context as profile-exclusive.";
+};
 export type OperatorBrainState = InitHandoffState | "no_active_pack";
 export type OperatorServePathState = "serving_active_pack" | "fail_open_static_context" | "hard_fail" | "unprobed";
 export interface OperatorSurfaceInput {
@@ -685,6 +791,7 @@ export interface OperatorSupervisionSummary {
     sourcePath: string | null;
     sourceKind: "bundle_root" | "payload" | "missing";
     exportDigest: string | null;
+    exportedAt: string | null;
     flowing: boolean | null;
     sourceCount: number;
     freshestSourceStream: string | null;
@@ -726,62 +833,12 @@ export interface OperatorLearningSummary {
     lastMaterializedPackId: string | null;
     detail: string;
 }
-export interface OperatorSurfaceReport {
-    generatedAt: string;
-    activationRoot: string;
-    status: OperatorSurfaceStatus;
-    active: OperatorSurfaceSlotSummary | null;
-    candidate: OperatorSurfaceSlotSummary | null;
-    previous: OperatorSurfaceSlotSummary | null;
-    freshness: {
-        activeBehindPromotionReadyCandidate: boolean;
-        candidateAheadBy: string[];
-    };
-    brain: OperatorBrainStateSummary;
-    learnedRouting: {
-        required: boolean;
-        available: boolean;
-        routerIdentity: string | null;
-        routeFnVersion: string | null;
-        trainingMethod: string | null;
-        routerTrainedAt: string | null;
-        objective: string | null;
-        pgProfile: ActivationObservabilityReport["learnedRouteFn"]["pgProfile"];
-        objectiveChecksum: string | null;
-        updateMechanism: string | null;
-        updateVersion: string | null;
-        updateCount: number | null;
-        supervisionCount: number | null;
-        collectedLabelsTotal: number | null;
-        freshnessChecksum: string | null;
-        handoffState: InitHandoffState;
-        initMode: LearningBootProfile | null;
-        seedStateVisible: boolean;
-    };
-    servePath: OperatorServePathSummary;
-    promotion: {
-        allowed: boolean;
-        findings: string[];
-        lastPromotion: OperatorLastPromotionSummary;
-        activeUpdatedAt: string | null;
-        candidateUpdatedAt: string | null;
-        previousUpdatedAt: string | null;
-    };
-    rollback: {
-        allowed: boolean;
-        findings: string[];
-        previousPackId: string | null;
-        state: "ready" | "blocked" | "unknown";
-    };
-    supervision: OperatorSupervisionSummary;
-    learning: OperatorLearningSummary;
-    teacherLoop: OperatorTeacherLoopSummary;
-    findings: OperatorDoctorFinding[];
+export interface CurrentProfileBrainStatusInput extends OperatorSurfaceInput {
+    brainAttachmentPolicy?: RuntimeTurnBrainAttachmentPolicyV1 | null;
 }
-export declare function buildOperatorSurfaceReport(input: OperatorSurfaceInput): OperatorSurfaceReport;
+export type CurrentProfileBrainStatusV1 = CurrentProfileBrainStatusAnswerV1;
+export declare function describeCurrentProfileBrainStatus(input: CurrentProfileBrainStatusInput): CurrentProfileBrainStatusV1;
 export declare function formatOperatorRollbackReport(result: RollbackRuntimeAttachResult): string;
-export declare function formatOperatorStatusReport(report: OperatorSurfaceReport): string;
-export declare function formatOperatorDoctorReport(report: OperatorSurfaceReport): string;
 /**
  * A per-turn summary of what was kernel-injected vs brain-compiled in a given
  * compile response. Useful for operator observability and debugging.