@haaaiawd/second-nature 0.1.10 → 0.1.11

package/index.js

@@ -16,10 +16,16 @@
  * - structured mutating flows such as policy set / credential verify remain unavailable here
  * - full evidence-backed workspace runtime can be reintroduced later behind a host-safe boundary
  *
+ * OpenClaw operator norm (T1.1.4 / T1.1.5): set `SECOND_NATURE_WORKSPACE_ROOT` or tool `workspaceRoot` to the
+ * **same absolute path** as the OpenClaw **agent workspace** (default `~/.openclaw/workspace`, or
+ * `agents.defaults.workspace` in `~/.openclaw/openclaw.json`). Do **not** infer that root from the plugin
+ * install directory. With **sandbox** or **per-agent workspaces**, use the path where `data/state.db` and
+ * `workspace/` anchors actually live. See `explore/reports/2026-05-04_openclaw-plugin-install-vs-workspace-root.md`.
+ *
  * Test coverage:
  * - tests/integration/cli/plugin-runtime-registration.test.ts
  * - tests/integration/cli/plugin-packaging-walkthrough.test.ts
- * - tests/integration/cli/plugin-workspace-ops-bridge.test.ts (T1.1.4)
+ * - tests/integration/cli/plugin-workspace-ops-bridge.test.ts (T1.1.4 / CH-13 matrix, T1.1.5 ops docs cross-ref)
  */
 import { startRuntimeService, } from "./runtime/core/second-nature/runtime/service-entry.js";
 import { getLifecycleState, recordRegistration, } from "./runtime/core/second-nature/runtime/lifecycle-service.js";
@@ -376,14 +382,50 @@ function buildFallbackHostSafePayload(ref) {
     }
     return createUnavailableActionError("HOST_SAFE_FALLBACK_VIEW_UNAVAILABLE", "Operator fallback view requires workspace state database; host-safe plugin cannot read persisted fallback artifacts.", ["ref"], "run_workspace_second_nature_cli_or_full_runtime_package");
 }
+function isProbeOnlyInput(input) {
+    const v = input?.probeOnly;
+    return v === true || v === "true" || v === 1 || v === "1";
+}
 function buildHeartbeatCheckPayload(spine, input) {
     const runtimeEvidence = latestRuntimeEvidence(spine);
     const updatedAt = runtimeEvidence?.createdAt ?? new Date(spine.lifecycleState.lastChangedAt).toISOString();
     const timestamp = typeof input?.timestamp === "string" && input.timestamp.trim().length > 0 ? input.timestamp : updatedAt;
     const wr = spine.workspaceRootContext;
+    if (isProbeOnlyInput(input)) {
+        return {
+            ok: true,
+            status: "heartbeat_ok",
+            surfaceMode: "capability_probe",
+            reasons: ["probe_only"],
+            livedExperienceLoopClaimed: false,
+            scope: "rhythm",
+            trigger: "heartbeat_bridge",
+            message: "Capability probe only on the host-safe carrier surface; does not claim a full lived-experience decision loop.",
+            data: {
+                workspaceRootResolution: wr.resolution,
+                runtime: {
+                    host: "openclaw-plugin",
+                    serviceStatus: spine.runtimeHandle.ready ? "running" : "idle",
+                    updatedAt,
+                },
+                surface: {
+                    tool: "second_nature_ops",
+                    command: "second-nature heartbeat_check",
+                },
+                bridge: {
+                    timestamp,
+                    probeOnly: true,
+                    sessionContextProvided: typeof input?.sessionContext === "string" && input.sessionContext.trim().length > 0,
+                    heartbeatChecklistProvided: typeof input?.heartbeatChecklist === "string" && input.heartbeatChecklist.trim().length > 0,
+                    serviceEntryMode: "capability_probe",
+                },
+            },
+        };
+    }
     return {
         ok: true,
         status: "runtime_carrier_only",
+        surfaceMode: "host_safe_carrier",
         livedExperienceLoopClaimed: false,
         scope: "rhythm",
         trigger: "heartbeat_bridge",

package/openclaw.plugin.json

@@ -1,9 +1,9 @@
 {
   "id": "second-nature",
   "name": "Second Nature",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "entry": "./index.js",
-  "description": "OpenClaw native plugin package with synchronous surface registration and a bundled runtime spine.",
+  "description": "OpenClaw native plugin with synchronous surface registration and bundled runtime spine. Set SECOND_NATURE_WORKSPACE_ROOT or tool workspaceRoot to the same path as the agent workspace (see README / T1.1.4 ops norm).",
   "capabilities": {
     "commands": [
       "second-nature"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haaaiawd/second-nature",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "OpenClaw native plugin with synchronous registration, a packaged runtime artifact, and operator-facing status/explain flows.",
   "keywords": [
     "openclaw",

package/runtime/cli/ops/ops-router.js

@@ -3,6 +3,10 @@
  */
 import { heartbeatCheck } from "./heartbeat-surface.js";
 import { showOperatorFallback, OperatorFallbackNotFoundError } from "./show-operator-fallback.js";
+function coerceProbeOnlyFlag(input) {
+    const v = input?.probeOnly;
+    return v === true || v === "true" || v === 1 || v === "1";
+}
 export function createOpsRouter(deps) {
     return {
         heartbeatCheck: (input) => heartbeatCheck({
@@ -14,12 +18,12 @@ export function createOpsRouter(deps) {
             if (command === "heartbeat_check") {
                 const runtimeAvailable = typeof input?.runtimeAvailable === "boolean" ? input.runtimeAvailable : deps.runtimeAvailable;
                 return heartbeatCheck({
-                    probeOnly: Boolean(input?.probeOnly),
+                    probeOnly: coerceProbeOnlyFlag(input),
                     runtimeAvailable,
                     fakeControlPlanePassthrough: input?.fakeControlPlanePassthrough && typeof input.fakeControlPlanePassthrough === "object"
                         ? input.fakeControlPlanePassthrough
                         : undefined,
-                    readModels: deps.readModels,
+                    readModels: input?.readModels ?? deps.readModels,
                     timestamp: typeof input?.timestamp === "string" ? input.timestamp : undefined,
                     sessionContext: typeof input?.sessionContext === "string" ? input.sessionContext : undefined,
                     scopeHint: input?.scopeHint,

package/runtime/core/second-nature/runtime/service-entry.js

@@ -26,7 +26,8 @@ export function startRuntimeService(ctx) {
     // - observability-system (event store setup)
     // - control-plane-system (heartbeat bridge preparation)
     const workspaceRoot = ctx?.workspaceRoot ?? process.cwd();
-    const version = "0.1.0";
+    /** Keep in sync with `plugin/package.json` when cutting releases. */
+    const version = "0.1.11";
     activeHandle = {
         ready: true,
         version,