@haaaiawd/second-nature 0.2.9 → 0.2.13

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

@@ -35,7 +35,7 @@ export interface HeartbeatSurfaceResult {
     /** True when structured fields mirror a fake adapter for schema parity only */
     schemaParityOnly?: boolean;
     /** T-CP.R.2: v8 real runtime spine result when state-backed action-closure spine ran */
-    v8Spine?: RealRuntimeSpineResult & {
+    v8Spine?: Partial<RealRuntimeSpineResult> & {
         degradedReason?: string;
     };
     /** T-GVS.R.1: agent-facing impulse context artifact read pointer */
@@ -45,6 +45,8 @@ export interface HeartbeatSurfaceResult {
         capabilityClass?: string | null;
         impulseText?: string | null;
         atmosphereText?: string | null;
+        expressionBoundaryConstraints?: string[] | null;
+        expressionBoundaryStyle?: string | null;
         freshnessMs?: number;
         missingReason?: string;
     };
@@ -99,8 +101,8 @@ export interface HeartbeatCheckInput {
     /** T-OBS.R.1: shared audit sink for connector/Quiet events consumed by heartbeat_digest. */
     auditStore?: AppendOnlyAuditStore;
     /**
-     * T-CP.R.2: when true and state DB is wired, runs the v8 real runtime action-closure spine
-     * in addition to the v7 heartbeat loop. Produces state-backed closure/no-action records.
+     * T-CP.R.5: v8 living-loop spine is the default operator-facing heartbeat model.
+     * Explicit false can be used by legacy callers to force a carrier-only path.
      */
     v8SpineEnabled?: boolean;
 }

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

@@ -1,6 +1,23 @@
 import { createWorkspaceHeartbeatRunner } from "./workspace-heartbeat-runner.js";
 // T-CP.R.2: v8 real runtime spine bridge
 import { runRealRuntimeHeartbeatCycle, } from "../../core/second-nature/control-plane/real-runtime-spine.js";
+async function refreshHeartbeatImpulseContext(state, now) {
+    const { assembleImpulseSync } = await import("../../guidance/impulse-assembler.js");
+    const { buildExpressionBoundary } = await import("../../guidance/output-guard.js");
+    const { getShortAtmosphereTemplate } = await import("../../guidance/template-registry.js");
+    const { writeImpulseContext } = await import("../../core/second-nature/guidance/impulse-context-writer.js");
+    const impulseResult = assembleImpulseSync({ sceneType: "heartbeat" });
+    const atmosphere = getShortAtmosphereTemplate("active", "low");
+    const expressionBoundary = buildExpressionBoundary("heartbeat");
+    const result = await writeImpulseContext(state, {
+        sceneType: "heartbeat",
+        impulseResult,
+        atmosphereText: atmosphere.text,
+        expressionBoundaryConstraints: expressionBoundary.constraints,
+        expressionBoundaryStyle: expressionBoundary.style,
+    }, { now });
+    return "id" in result ? result.id : undefined;
+}
 function mapCycleToSurface(cycle, surfaceMode) {
     const status = cycle.status === "runtime_carrier_only"
         ? "runtime_carrier_only"
@@ -89,8 +106,9 @@ export async function heartbeatCheck(input) {
     try {
         const cycle = await run(signal);
         const surfaceResult = mapCycleToSurface(cycle, "workspace_full_runtime");
-        // T-CP.R.2: run v8 real runtime spine when enabled and state is available
-        if (input.v8SpineEnabled && input.state && input.workspaceRoot) {
+        // T-CP.R.5: v8 living-loop spine is the default operator-facing model when state is wired
+        const v8SpineEnabled = input.v8SpineEnabled !== false && Boolean(input.state && input.workspaceRoot);
+        if (v8SpineEnabled && input.state && input.workspaceRoot) {
             try {
                 const v8Result = await runRealRuntimeHeartbeatCycle({
                     workspaceRoot: input.workspaceRoot,
@@ -98,10 +116,10 @@ export async function heartbeatCheck(input) {
                     requestedAt: timestamp,
                     trigger: "host",
                 });
-                if ("status" in v8Result && v8Result.status === "degraded") {
+                if ("status" in v8Result && "operatorNextAction" in v8Result) {
+                    // T-CP.R.6: degraded path must not fabricate cycleId/cycleSequence.
+                    // Only set degradedReason; cycleId/cycleSequence remain absent.
                     surfaceResult.v8Spine = {
-                        cycleId: "",
-                        cycleSequence: 0,
                         degradedReason: v8Result.reason,
                     };
                     surfaceResult.reasons = [
@@ -111,6 +129,11 @@ export async function heartbeatCheck(input) {
                 }
                 else {
                     const spine = v8Result;
+                    const artifactId = await refreshHeartbeatImpulseContext(input.state, timestamp);
+                    if (artifactId) {
+                        spine.impulseContextArtifactId = artifactId;
+                        surfaceResult.reasons.push(`impulse_context_refreshed:${artifactId}`);
+                    }
                     surfaceResult.v8Spine = spine;
                     surfaceResult.livedExperienceLoopClaimed = Boolean(spine.cycleId && (spine.closureRef || spine.noActionReason));
                     surfaceResult.reasons = [
@@ -134,7 +157,7 @@ export async function heartbeatCheck(input) {
         if (input.state) {
             try {
                 const { readImpulseContext } = await import("../../core/second-nature/guidance/impulse-context-reader.js");
-                const ctx = await readImpulseContext(input.state, "social");
+                const ctx = await readImpulseContext(input.state, "heartbeat");
                 if (ctx.available) {
                     surfaceResult.impulseContext = {
                         available: true,
@@ -142,6 +165,8 @@ export async function heartbeatCheck(input) {
                         capabilityClass: ctx.artifact.capabilityClass,
                         impulseText: ctx.artifact.impulseText,
                         atmosphereText: ctx.artifact.atmosphereText,
+                        expressionBoundaryConstraints: ctx.artifact.expressionBoundaryConstraints,
+                        expressionBoundaryStyle: ctx.artifact.expressionBoundaryStyle,
                         freshnessMs: ctx.freshnessMs,
                     };
                     surfaceResult.reasons.push(`impulse_context:${ctx.artifact.id}`);
@@ -154,8 +179,13 @@ export async function heartbeatCheck(input) {
                     surfaceResult.reasons.push(`impulse_context_missing:${ctx.reason}`);
                 }
             }
-            catch {
-                // Non-fatal: impulse context is advisory
+            catch (readErr) {
+                const msg = readErr instanceof Error ? readErr.message : String(readErr);
+                surfaceResult.impulseContext = {
+                    available: false,
+                    missingReason: `read_exception:${msg.slice(0, 120)}`,
+                };
+                surfaceResult.reasons.push(`impulse_context_read_failed:${msg.slice(0, 120)}`);
             }
         }
         return surfaceResult;

package/runtime/cli/ops/ops-router.d.ts

@@ -1,4 +1,5 @@
 import { type HeartbeatCheckInput, type HeartbeatSurfaceResult } from "./heartbeat-surface.js";
+import type { SurfaceMode } from "../runtime/runtime-artifact-boundary.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";
@@ -12,12 +13,13 @@ import { AppendOnlyAuditStore } from "../../observability/audit/append-only-audi
 import type { RestoreSnapshotStore } from "../../storage/services/restore-snapshot-store.js";
 import type { CapabilityContractRegistry } from "../../connectors/base/manifest.js";
 import type { AffordanceAssembler } from "../../core/second-nature/body/tool-affordance/affordance-assembler.js";
-/** Unified response envelope for all v7 runtime-ops commands. */
+import type { EvidenceLevel } from "../../shared/types/v8-contracts.js";
+/** Unified response envelope for all v7/v8 runtime-ops commands. */
 export interface RuntimeOpsEnvelope<T = unknown> {
     ok: boolean;
     command: string;
     runtimeMode: "host_safe_carrier" | "workspace_full_runtime" | "unavailable";
-    surfaceMode: "cli" | "openclaw_tool" | "plugin_command" | "cron_probe";
+    surfaceMode: SurfaceMode | "cli" | "openclaw_tool" | "plugin_command" | "cron_probe";
     generatedAt: string;
     data?: T;
     error?: {
@@ -27,6 +29,8 @@ export interface RuntimeOpsEnvelope<T = unknown> {
     };
     warnings: string[];
     sourceRefs: string[];
+    /** T-OBS.R.7: how strongly this response is backed by runtime proof. */
+    evidenceLevel?: EvidenceLevel;
 }
 export interface OpsRouterDeps {
     /** When true, packaged runtime artifacts resolved and full graph is loadable */