@haaaiawd/second-nature 0.1.38 → 0.1.39

package/openclaw.plugin.json

@@ -1,29 +1,29 @@
-{
-  "id": "second-nature",
-  "name": "Second Nature",
-  "version": "0.1.38",
-  "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. Agent inner guide is packaged as agent-inner-guide.md. v7 ops surface: self_health, tool_affordance, heartbeat_digest, snapshot:capture, narrative:diff, timeline, restore, runtime_secret_bootstrap.",
-  "activation": {
-    "onStartup": true,
-    "onCapabilities": [
-      "tool"
-    ]
-  },
-  "contracts": {
-    "commands": [
-      "second-nature"
-    ],
-    "tools": [
-      "second_nature_ops"
-    ],
-    "services": [
-      "second-nature-runtime",
-      "second-nature-lifecycle"
-    ]
-  },
-  "configSchema": {
-    "type": "object",
-    "additionalProperties": false,
-    "properties": {}
-  }
-}
+{
+  "id": "second-nature",
+  "name": "Second Nature",
+  "version": "0.1.38",
+  "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. Agent inner guide is packaged as agent-inner-guide.md. v7 ops surface: self_health, tool_affordance, heartbeat_digest, snapshot:capture, narrative:diff, timeline, restore, runtime_secret_bootstrap, connector:run, guidance_payload.",
+  "activation": {
+    "onStartup": true,
+    "onCapabilities": [
+      "tool"
+    ]
+  },
+  "contracts": {
+    "commands": [
+      "second-nature"
+    ],
+    "tools": [
+      "second_nature_ops"
+    ],
+    "services": [
+      "second-nature-runtime",
+      "second-nature-lifecycle"
+    ]
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/package.json

@@ -1,55 +1,55 @@
-{
-  "name": "@haaaiawd/second-nature",
-  "version": "0.1.38",
-  "description": "OpenClaw native plugin with synchronous registration, a packaged runtime artifact, and operator-facing status/explain flows.",
-  "keywords": [
-    "openclaw",
-    "plugin",
-    "agent",
-    "continuity",
-    "quiet",
-    "memory",
-    "observability",
-    "operator"
-  ],
-  "license": "Apache-2.0",
-  "type": "module",
-  "main": "./index.js",
-  "files": [
-    "index.js",
-    "workspace-ops-bridge.js",
-    "openclaw.plugin.json",
-    "SKILL.md",
-    "agent-inner-guide.md",
-    "runtime/"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "openclaw": {
-    "manifest": "./openclaw.plugin.json",
-    "extensions": [
-      "./index.js"
-    ],
-    "runtimeExtensions": [
-      "./index.js"
-    ],
-    "compat": {
-      "pluginApi": ">=2026.5.12"
-    }
-  },
-  "peerDependencies": {
-    "openclaw": ">=2026.5.12"
-  },
-  "peerDependenciesMeta": {
-    "openclaw": {
-      "optional": true
-    }
-  },
-  "dependencies": {
-    "drizzle-orm": "^0.45.2",
-    "js-yaml": "^4.1.1",
-    "sql.js": "^1.14.1",
-    "zod": "^4.4.3"
-  }
-}
+{
+  "name": "@haaaiawd/second-nature",
+  "version": "0.1.39",
+  "description": "OpenClaw native plugin with synchronous registration, a packaged runtime artifact, and operator-facing status/explain flows.",
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "agent",
+    "continuity",
+    "quiet",
+    "memory",
+    "observability",
+    "operator"
+  ],
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./index.js",
+  "files": [
+    "index.js",
+    "workspace-ops-bridge.js",
+    "openclaw.plugin.json",
+    "SKILL.md",
+    "agent-inner-guide.md",
+    "runtime/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "openclaw": {
+    "manifest": "./openclaw.plugin.json",
+    "extensions": [
+      "./index.js"
+    ],
+    "runtimeExtensions": [
+      "./index.js"
+    ],
+    "compat": {
+      "pluginApi": ">=2026.5.12"
+    }
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.5.12"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "drizzle-orm": "^0.45.2",
+    "js-yaml": "^4.1.1",
+    "sql.js": "^1.14.1",
+    "zod": "^4.4.3"
+  }
+}

package/runtime/cli/ops/heartbeat-surface.d.ts

@@ -1,60 +1,75 @@
-/**
- * Stable HeartbeatSurfaceResult for second_nature_ops / CLI (T1.1.3, cli-system / ADR-005).
- *
- * S1 scope: carrier / probe / runtime-unavailable / fake control-plane passthrough only.
- * Workspace full runtime: delegates to `runHeartbeatCycle` when read models are wired (US-001 / CH-09-02).
- */
-import type { SurfaceMode } from "../runtime/runtime-artifact-boundary.js";
-import type { HeartbeatSignal } from "../../core/second-nature/heartbeat/signal.js";
-import type { CliReadModels } from "../read-models/index.js";
-import type { RuntimeDecisionRecorder } from "../../observability/services/runtime-decision-recorder.js";
-import type { StateDatabase } from "../../storage/db/index.js";
-import type { ConnectorExecutor } from "../../core/second-nature/orchestrator/effect-dispatcher.js";
-import type { CapabilityContractRegistry } from "../../connectors/base/manifest.js";
-import type { AffordanceMap } from "../../shared/types/v7-entities.js";
-import type { ExperienceWriter } from "../../core/second-nature/body/tool-experience/experience-writer.js";
-export type HeartbeatSurfaceStatus = "heartbeat_ok" | "intent_selected" | "denied" | "deferred" | "runtime_carrier_only" | "delivery_unavailable";
-export interface HeartbeatSurfaceResult {
-    ok: boolean;
-    status: HeartbeatSurfaceStatus;
-    surfaceMode: SurfaceMode;
-    decisionId?: string;
-    deliveryAttemptId?: string;
-    capabilityReportRef?: string;
-    fallbackRef?: string;
-    reasons: string[];
-    /** When false, callers must not treat the round as lived-experience loop completion */
-    livedExperienceLoopClaimed: boolean;
-    /** True when structured fields mirror a fake adapter for schema parity only */
-    schemaParityOnly?: boolean;
-}
-export interface HeartbeatCheckInput {
-    probeOnly?: boolean;
-    runtimeAvailable: boolean;
-    fakeControlPlanePassthrough?: Record<string, unknown>;
-    /** When set, full-runtime heartbeat_check runs the control-plane decision loop (US-001). */
-    readModels?: CliReadModels;
-    /** When set, full-runtime cycles are persisted so `loadStatus` exits unknown (T1.2.3). */
-    runtimeRecorder?: RuntimeDecisionRecorder;
-    /**
-     * T2.2.2: when set together with `workspaceRoot`, life evidence from the state DB is loaded
-     * and merged into SnapshotInputs so planner/guard paths see real source-ref truth.
-     */
-    state?: StateDatabase;
-    workspaceRoot?: string;
-    timestamp?: string;
-    sessionContext?: string;
-    scopeHint?: HeartbeatSignal["scopeHint"];
-    /**
-     * When present, guard-allowed connector_action intents are dispatched through the
-     * connector-system instead of returning connector_dispatch_unwired.
-     */
-    connectorExecutor?: ConnectorExecutor;
-    /** Capability registry used by planner to avoid platform/capability protocol mismatches. */
-    connectorRegistry?: CapabilityContractRegistry;
-    /** v7 T-V7C.C.2: affordance map for breaker-aware guard evaluation. */
-    affordanceMap?: AffordanceMap;
-    /** v7 T-V7C.C.2: experience writer for heartbeat connector attempts. */
-    experienceWriter?: ExperienceWriter;
-}
-export declare function heartbeatCheck(input: HeartbeatCheckInput): Promise<HeartbeatSurfaceResult>;
+/**
+ * Stable HeartbeatSurfaceResult for second_nature_ops / CLI (T1.1.3, cli-system / ADR-005).
+ *
+ * S1 scope: carrier / probe / runtime-unavailable / fake control-plane passthrough only.
+ * Workspace full runtime: delegates to `runHeartbeatCycle` when read models are wired (US-001 / CH-09-02).
+ */
+import type { SurfaceMode } from "../runtime/runtime-artifact-boundary.js";
+import type { HeartbeatSignal } from "../../core/second-nature/heartbeat/signal.js";
+import type { CliReadModels } from "../read-models/index.js";
+import type { RuntimeDecisionRecorder } from "../../observability/services/runtime-decision-recorder.js";
+import type { StateDatabase } from "../../storage/db/index.js";
+import type { ConnectorExecutor } from "../../core/second-nature/orchestrator/effect-dispatcher.js";
+import type { CapabilityContractRegistry } from "../../connectors/base/manifest.js";
+import type { AffordanceMap } from "../../shared/types/v7-entities.js";
+import type { ExperienceWriter } from "../../core/second-nature/body/tool-experience/experience-writer.js";
+import type { QuietDreamSchedulePort } from "../../core/second-nature/quiet/run-source-backed-quiet.js";
+import type { HeartbeatDigestAssemblerDeps } from "../../observability/services/heartbeat-digest-assembler.js";
+export type HeartbeatSurfaceStatus = "heartbeat_ok" | "intent_selected" | "denied" | "deferred" | "runtime_carrier_only" | "delivery_unavailable";
+export interface HeartbeatSurfaceResult {
+    ok: boolean;
+    status: HeartbeatSurfaceStatus;
+    surfaceMode: SurfaceMode;
+    decisionId?: string;
+    deliveryAttemptId?: string;
+    capabilityReportRef?: string;
+    fallbackRef?: string;
+    reasons: string[];
+    /** When false, callers must not treat the round as lived-experience loop completion */
+    livedExperienceLoopClaimed: boolean;
+    /** True when structured fields mirror a fake adapter for schema parity only */
+    schemaParityOnly?: boolean;
+}
+export interface HeartbeatCheckInput {
+    probeOnly?: boolean;
+    runtimeAvailable: boolean;
+    fakeControlPlanePassthrough?: Record<string, unknown>;
+    /** When set, full-runtime heartbeat_check runs the control-plane decision loop (US-001). */
+    readModels?: CliReadModels;
+    /** When set, full-runtime cycles are persisted so `loadStatus` exits unknown (T1.2.3). */
+    runtimeRecorder?: RuntimeDecisionRecorder;
+    /**
+     * T2.2.2: when set together with `workspaceRoot`, life evidence from the state DB is loaded
+     * and merged into SnapshotInputs so planner/guard paths see real source-ref truth.
+     */
+    state?: StateDatabase;
+    workspaceRoot?: string;
+    timestamp?: string;
+    sessionContext?: string;
+    scopeHint?: HeartbeatSignal["scopeHint"];
+    /**
+     * When present, guard-allowed connector_action intents are dispatched through the
+     * connector-system instead of returning connector_dispatch_unwired.
+     */
+    connectorExecutor?: ConnectorExecutor;
+    /** Capability registry used by planner to avoid platform/capability protocol mismatches. */
+    connectorRegistry?: CapabilityContractRegistry;
+    /** v7 T-V7C.C.2: affordance map for breaker-aware guard evaluation. */
+    affordanceMap?: AffordanceMap;
+    /** v7 T-V7C.C.2: experience writer for heartbeat connector attempts. */
+    experienceWriter?: ExperienceWriter;
+    /**
+     * v7 T-V7C.C.6: when present, a successful Quiet write auto-triggers Dream scheduling.
+     * Fixes the production-data gap where dream_output_index does not grow after Quiet.
+     */
+    dreamSchedulePort?: QuietDreamSchedulePort;
+    /**
+     * v7 T-V7C.C.6: when present, generates a HeartbeatDigest after each cycle.
+     * Fixes the production-data gap where heartbeat_digest does not grow.
+     */
+    digestOpts?: {
+        assemblerDeps: HeartbeatDigestAssemblerDeps;
+        digestWindowHour?: number;
+    };
+}
+export declare function heartbeatCheck(input: HeartbeatCheckInput): Promise<HeartbeatSurfaceResult>;

package/runtime/cli/ops/heartbeat-surface.js

@@ -1,83 +1,97 @@
-import { createWorkspaceHeartbeatRunner } from "./workspace-heartbeat-runner.js";
-function mapCycleToSurface(cycle, surfaceMode) {
-    const status = cycle.status === "runtime_carrier_only"
-        ? "runtime_carrier_only"
-        : cycle.status;
-    return {
-        ok: true,
-        status,
-        surfaceMode,
-        decisionId: cycle.decisionId,
-        deliveryAttemptId: cycle.deliveryAttemptId,
-        fallbackRef: cycle.fallbackRef,
-        reasons: cycle.reasons,
-        livedExperienceLoopClaimed: false,
-    };
-}
-export async function heartbeatCheck(input) {
-    if (!input.runtimeAvailable) {
-        return {
-            ok: true,
-            status: "runtime_carrier_only",
-            surfaceMode: "host_safe_carrier",
-            reasons: ["runtime_unavailable_packaged_carrier"],
-            livedExperienceLoopClaimed: false,
-        };
-    }
-    if (input.probeOnly) {
-        return {
-            ok: true,
-            status: "heartbeat_ok",
-            surfaceMode: "capability_probe",
-            reasons: ["probe_only"],
-            livedExperienceLoopClaimed: false,
-        };
-    }
-    if (input.fakeControlPlanePassthrough) {
-        const decisionId = typeof input.fakeControlPlanePassthrough.decisionId === "string"
-            ? input.fakeControlPlanePassthrough.decisionId
-            : undefined;
-        return {
-            ok: true,
-            status: "intent_selected",
-            surfaceMode: "host_safe_carrier",
-            reasons: ["fake_control_plane_passthrough"],
-            decisionId,
-            livedExperienceLoopClaimed: false,
-            schemaParityOnly: true,
-        };
-    }
-    if (!input.readModels) {
-        return {
-            ok: true,
-            status: "runtime_carrier_only",
-            surfaceMode: "host_safe_carrier",
-            reasons: ["heartbeat_read_models_unavailable"],
-            livedExperienceLoopClaimed: false,
-        };
-    }
-    const timestamp = typeof input.timestamp === "string" && input.timestamp.trim().length > 0
-        ? input.timestamp.trim()
-        : new Date().toISOString();
-    const signal = {
-        trigger: "heartbeat_bridge",
-        scopeHint: input.scopeHint,
-        payload: {
-            timestamp,
-            sessionContext: typeof input.sessionContext === "string"
-                ? input.sessionContext
-                : undefined,
-        },
-    };
-    const run = createWorkspaceHeartbeatRunner(input.readModels, {
-        runtimeRecorder: input.runtimeRecorder,
-        state: input.state,
-        workspaceRoot: input.workspaceRoot ?? process.cwd(),
-        connectorExecutor: input.connectorExecutor,
-        connectorRegistry: input.connectorRegistry,
-        affordanceMap: input.affordanceMap,
-        experienceWriter: input.experienceWriter,
-    });
-    const cycle = await run(signal);
-    return mapCycleToSurface(cycle, "workspace_full_runtime");
-}
+import { createWorkspaceHeartbeatRunner } from "./workspace-heartbeat-runner.js";
+function mapCycleToSurface(cycle, surfaceMode) {
+    const status = cycle.status === "runtime_carrier_only"
+        ? "runtime_carrier_only"
+        : cycle.status;
+    return {
+        ok: true,
+        status,
+        surfaceMode,
+        decisionId: cycle.decisionId,
+        deliveryAttemptId: cycle.deliveryAttemptId,
+        fallbackRef: cycle.fallbackRef,
+        reasons: cycle.reasons,
+        livedExperienceLoopClaimed: false,
+    };
+}
+export async function heartbeatCheck(input) {
+    if (!input.runtimeAvailable) {
+        return {
+            ok: true,
+            status: "runtime_carrier_only",
+            surfaceMode: "host_safe_carrier",
+            reasons: ["runtime_unavailable_packaged_carrier"],
+            livedExperienceLoopClaimed: false,
+        };
+    }
+    if (input.probeOnly) {
+        return {
+            ok: true,
+            status: "heartbeat_ok",
+            surfaceMode: "capability_probe",
+            reasons: ["probe_only"],
+            livedExperienceLoopClaimed: false,
+        };
+    }
+    if (input.fakeControlPlanePassthrough) {
+        const decisionId = typeof input.fakeControlPlanePassthrough.decisionId === "string"
+            ? input.fakeControlPlanePassthrough.decisionId
+            : undefined;
+        return {
+            ok: true,
+            status: "intent_selected",
+            surfaceMode: "host_safe_carrier",
+            reasons: ["fake_control_plane_passthrough"],
+            decisionId,
+            livedExperienceLoopClaimed: false,
+            schemaParityOnly: true,
+        };
+    }
+    if (!input.readModels) {
+        return {
+            ok: true,
+            status: "runtime_carrier_only",
+            surfaceMode: "host_safe_carrier",
+            reasons: ["heartbeat_read_models_unavailable"],
+            livedExperienceLoopClaimed: false,
+        };
+    }
+    const timestamp = typeof input.timestamp === "string" && input.timestamp.trim().length > 0
+        ? input.timestamp.trim()
+        : new Date().toISOString();
+    const signal = {
+        trigger: "heartbeat_bridge",
+        scopeHint: input.scopeHint,
+        payload: {
+            timestamp,
+            sessionContext: typeof input.sessionContext === "string"
+                ? input.sessionContext
+                : undefined,
+        },
+    };
+    const run = createWorkspaceHeartbeatRunner(input.readModels, {
+        runtimeRecorder: input.runtimeRecorder,
+        state: input.state,
+        workspaceRoot: input.workspaceRoot ?? process.cwd(),
+        connectorExecutor: input.connectorExecutor,
+        connectorRegistry: input.connectorRegistry,
+        affordanceMap: input.affordanceMap,
+        experienceWriter: input.experienceWriter,
+        dreamSchedulePort: input.dreamSchedulePort,
+        digestOpts: input.digestOpts,
+    });
+    try {
+        const cycle = await run(signal);
+        return mapCycleToSurface(cycle, "workspace_full_runtime");
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            ok: false,
+            status: "denied",
+            surfaceMode: "workspace_full_runtime",
+            reasons: [`heartbeat_cycle_exception:${msg.slice(0, 120)}`],
+            livedExperienceLoopClaimed: false,
+        };
+    }
+}