@haaaiawd/second-nature 0.2.9 → 0.2.13

package/runtime/core/second-nature/quiet-dream/dream-scheduler.js

@@ -21,6 +21,7 @@
  * Test coverage: tests/unit/dream/dream-scheduler-lifecycle.test.ts
  */
 import { readQuietDailyReviewById, writeDreamConsolidationRun, } from "../../../storage/v8-state-stores.js";
+import { classifyDegradedStatus } from "../../../shared/degraded-status-classifier.js";
 // ───────────────────────────────────────────────────────────────
 // Public API
 // ───────────────────────────────────────────────────────────────
@@ -33,7 +34,7 @@ export async function scheduleDreamAfterQuiet(db, quietReviewId, options) {
     const review = readResult.row;
     if (!review) {
         return {
-            status: "degraded",
+            status: classifyDegradedStatus("state_unreadable"),
             reason: "state_unreadable",
             ownerStage: "dream",
             sourceRefs: [],
@@ -60,7 +61,6 @@ export async function scheduleDreamAfterQuiet(db, quietReviewId, options) {
                 },
             ],
             redactionClass: "none",
-            lifecycleStatus: "pending",
             payloadJson: JSON.stringify({ scheduledAt: now, blocked: true }),
         });
         if ("reason" in writeResult) {
@@ -90,7 +90,6 @@ export async function scheduleDreamAfterQuiet(db, quietReviewId, options) {
             },
         ],
         redactionClass: "none",
-        lifecycleStatus: "pending",
         payloadJson: JSON.stringify({ scheduledAt: now }),
     });
     if ("reason" in writeResult) {

package/runtime/core/second-nature/quiet-dream/memory-projection-lifecycle.js

@@ -21,6 +21,7 @@
  * Test coverage: tests/unit/dream/memory-projection-lifecycle.test.ts
  */
 import { readMemoryProjectionsByTopic, writeLongTermMemoryProjection, updateLongTermMemoryProjectionStatus, } from "../../../storage/v8-state-stores.js";
+import { classifyDegradedStatus } from "../../../shared/degraded-status-classifier.js";
 // ───────────────────────────────────────────────────────────────
 // Public API
 // ───────────────────────────────────────────────────────────────
@@ -28,7 +29,7 @@ export async function acceptMemoryProjection(db, candidateId, topicKey, memoryTe
     const now = options?.now ?? new Date().toISOString();
     if (sourceRefs.length === 0) {
         return {
-            status: "degraded",
+            status: classifyDegradedStatus("source_refs_unresolved"),
             reason: "source_refs_unresolved",
             ownerStage: "projection",
             sourceRefs: [],
@@ -65,7 +66,6 @@ export async function acceptMemoryProjection(db, candidateId, topicKey, memoryTe
         status: "active",
         sourceRefs,
         redactionClass: "none",
-        lifecycleStatus: "active",
         payloadJson: JSON.stringify({
             memoryText,
             acceptedAt: now,
@@ -111,17 +111,6 @@ export async function retireMemoryProjection(db, projectionId, _candidateId, _to
 // ───────────────────────────────────────────────────────────────
 // Helpers
 // ───────────────────────────────────────────────────────────────
-function parseSourceRefs(json) {
-    if (!json)
-        return [];
-    try {
-        const parsed = JSON.parse(json);
-        return Array.isArray(parsed) ? parsed : [];
-    }
-    catch {
-        return [];
-    }
-}
 function parsePayloadJson(json) {
     if (!json)
         return {};

package/runtime/core/second-nature/quiet-dream/quiet-daily-review-builder.d.ts

@@ -62,4 +62,5 @@ export type BuildQuietDailyReviewOutput = {
     status: "empty";
     reason: V8ReasonCode;
 } | DegradedOperationResult;
+export type QuietReviewContentStatus = "content_present" | "empty" | "placeholder_rejected" | "content_missing";
 export declare function buildQuietDailyReview(db: StateDatabase, options?: BuildQuietDailyReviewOptions): Promise<BuildQuietDailyReviewOutput>;

package/runtime/core/second-nature/quiet-dream/quiet-daily-review-builder.js

@@ -22,6 +22,7 @@
  * Test coverage: tests/unit/quiet/quiet-daily-review-builder.test.ts
  */
 import { readActionClosuresByDay, writeQuietDailyReview, readPerceptionCardById, readEvidenceItemsByDay, readPerceptionCardsByDay, } from "../../../storage/v8-state-stores.js";
+import { parseSourceRefs } from "../../../shared/serialization.js";
 // ───────────────────────────────────────────────────────────────
 // Config
 // ───────────────────────────────────────────────────────────────
@@ -52,17 +53,6 @@ function buildSourceRefFromClosure(closure) {
         resolveStatus: "resolvable",
     };
 }
-function parseSourceRefs(json) {
-    if (!json)
-        return [];
-    try {
-        const parsed = JSON.parse(json);
-        return Array.isArray(parsed) ? parsed : [];
-    }
-    catch {
-        return [];
-    }
-}
 function buildSourceRefFromEvidence(evidence) {
     const refs = parseSourceRefs(evidence.sourceRefsJson);
     return (refs[0] ?? {
@@ -117,6 +107,25 @@ function groupByStatus(entries) {
     }
     return groups;
 }
+// Placeholder/template detector: true when the review has no content-bearing
+// evidence or perception signals and no memory-review candidates. Closure-only
+// system text is not meaningful memory input.
+function isPlaceholderReview(notableSignals, memoryCandidates, evidenceRows, perceptionRows) {
+    if (memoryCandidates.length > 0)
+        return false;
+    if (notableSignals.length > 0)
+        return false;
+    const hasContentEvidence = evidenceRows.some((ev) => {
+        const payload = parsePayloadJson(ev.payloadJson);
+        return payload.contentStatus !== "content_missing";
+    });
+    if (hasContentEvidence)
+        return false;
+    const hasContentPerception = perceptionRows.some((p) => !!p.summary);
+    if (hasContentPerception)
+        return false;
+    return true;
+}
 // ───────────────────────────────────────────────────────────────
 // Public API
 // ───────────────────────────────────────────────────────────────
@@ -187,11 +196,18 @@ export async function buildQuietDailyReview(db, options) {
     }
     for (const perception of perceptionRows) {
         if (perception.summary) {
+            const perceptionPayload = parsePayloadJson(perception.payloadJson);
+            if (perceptionPayload.contentMissing) {
+                continue;
+            }
             notableSignals.push(`Perception: ${perception.summary}`);
         }
     }
     for (const evidence of evidenceRows) {
         const payload = parsePayloadJson(evidence.payloadJson);
+        if (payload.contentStatus === "content_missing") {
+            continue;
+        }
         if (payload.summary) {
             notableSignals.push(`${evidence.platformId}: ${String(payload.summary)}`);
         }
@@ -255,6 +271,12 @@ export async function buildQuietDailyReview(db, options) {
     const reviewSummary = firstTopic
         ? `Day ${day}: ${closures.length} closures around ${firstTopic}${notableSignals.length > 0 ? ` with ${notableSignals.length} notable signals` : ""}.`
         : `Day ${day}: ${closures.length} closures (${completedCount} completed, ${deniedCount} deferred/denied, ${failedCount} failed)`;
+    const isPlaceholder = isPlaceholderReview(notableSignals, memoryCandidates, evidenceRows, perceptionRows);
+    const contentStatus = isPlaceholder
+        ? "placeholder_rejected"
+        : (notableSignals.length > 0 || memoryCandidates.length > 0)
+            ? "content_present"
+            : "content_missing";
     const importanceSignals = [];
     if (memoryCandidates.length > 0) {
         importanceSignals.push(`${memoryCandidates.length} memory-review candidates`);
@@ -278,6 +300,7 @@ export async function buildQuietDailyReview(db, options) {
         lifecycleStatus: "pending",
         payloadJson: JSON.stringify({
             reviewSummary,
+            contentStatus,
             importanceSignals,
             memoryCandidates,
             sections,

package/runtime/core/second-nature/types.d.ts

@@ -1,16 +1,9 @@
+import type { SourceRef } from "../../shared/types/v8-contracts.js";
 export type TopLevelMode = "active" | "quiet" | "maintenance_only" | "paused_for_interrupt";
 /** Control-plane candidate kinds; includes `quiet` for quiet-window–biased intents (L0 alignment). */
 export type IntentKind = "work" | "exploration" | "social" | "quiet" | "reflection" | "outreach" | "maintenance";
 export type DecisionBasis = "rule_only" | "score_based" | "model_assisted";
 export type GuardVerdict = "allow" | "defer" | "deny" | "escalate";
-/** Minimal source ref for planner / guards (matches state-system `SourceRef` subset). */
-export interface ControlPlaneSourceRef {
-    id: string;
-    kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
-    uri: string;
-    excerptHash?: string;
-    observedAt?: string;
-}
 export interface ContinuitySnapshot {
     mode: TopLevelMode;
     currentWindowId: string;
@@ -40,7 +33,7 @@ export interface CandidateIntent {
     summary: string;
     effectClass: CandidateEffectClass;
     /** Required for source-backed guard; may be empty when planner expects hard-guard deny. */
-    sourceRefs: ControlPlaneSourceRef[];
+    sourceRefs: SourceRef[];
     /** Dedupe / cooldown key; defaults to stable fingerprint in guard layer when omitted. */
     idempotencyKey?: string;
     /** T2.1.4: IDs of accepted AgentGoals that influenced this candidate's priority. */

package/runtime/dream/dream-engine.js

@@ -165,12 +165,19 @@ export async function runDream(input) {
                     });
                 }
                 if (!fallbackReason) {
+                    let timeoutHandle;
                     const timeoutPromise = new Promise((_, reject) => {
-                        setTimeout(() => reject(new Error("model_timeout")), operatorTimeoutMs);
+                        timeoutHandle = setTimeout(() => reject(new Error("model_timeout")), operatorTimeoutMs);
                     });
-                    modelResult = await Promise.race([modelPromise, timeoutPromise]);
-                    mode = "hybrid_llm";
-                    llmCostUsd = modelResult.costUsd;
+                    try {
+                        modelResult = await Promise.race([modelPromise, timeoutPromise]);
+                        mode = "hybrid_llm";
+                        llmCostUsd = modelResult.costUsd;
+                    }
+                    finally {
+                        if (timeoutHandle)
+                            clearTimeout(timeoutHandle);
+                    }
                 }
             }
             catch (err) {

package/runtime/guidance/outreach-draft-schema.d.ts

@@ -8,11 +8,11 @@ import { z } from "zod";
 export declare const guidanceSourceRefSchema: z.ZodObject<{
     id: z.ZodString;
     kind: z.ZodEnum<{
+        connector_result: "connector_result";
         platform_item: "platform_item";
         workspace_artifact: "workspace_artifact";
         decision_record: "decision_record";
         user_anchor: "user_anchor";
-        connector_result: "connector_result";
         host_report: "host_report";
         fallback_artifact: "fallback_artifact";
     }>;
@@ -66,11 +66,11 @@ export declare const sceneGuidanceRequestSchema: z.ZodObject<{
     sourceRefs: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         kind: z.ZodEnum<{
+            connector_result: "connector_result";
             platform_item: "platform_item";
             workspace_artifact: "workspace_artifact";
             decision_record: "decision_record";
             user_anchor: "user_anchor";
-            connector_result: "connector_result";
             host_report: "host_report";
             fallback_artifact: "fallback_artifact";
         }>;
@@ -104,11 +104,11 @@ export declare const outreachNarrativeContextSchema: z.ZodObject<{
     sourceRefs: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         kind: z.ZodEnum<{
+            connector_result: "connector_result";
             platform_item: "platform_item";
             workspace_artifact: "workspace_artifact";
             decision_record: "decision_record";
             user_anchor: "user_anchor";
-            connector_result: "connector_result";
             host_report: "host_report";
             fallback_artifact: "fallback_artifact";
         }>;
@@ -124,11 +124,11 @@ export declare const outreachRelationshipContextSchema: z.ZodObject<{
     sourceRefs: z.ZodOptional<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         kind: z.ZodEnum<{
+            connector_result: "connector_result";
             platform_item: "platform_item";
             workspace_artifact: "workspace_artifact";
             decision_record: "decision_record";
             user_anchor: "user_anchor";
-            connector_result: "connector_result";
             host_report: "host_report";
             fallback_artifact: "fallback_artifact";
         }>;
@@ -160,11 +160,11 @@ export declare const outreachDraftRequestSchema: z.ZodObject<{
     sourceRefs: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         kind: z.ZodEnum<{
+            connector_result: "connector_result";
             platform_item: "platform_item";
             workspace_artifact: "workspace_artifact";
             decision_record: "decision_record";
             user_anchor: "user_anchor";
-            connector_result: "connector_result";
             host_report: "host_report";
             fallback_artifact: "fallback_artifact";
         }>;
@@ -205,11 +205,11 @@ export declare const outreachDraftRequestSchema: z.ZodObject<{
     interestRefs: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         kind: z.ZodEnum<{
+            connector_result: "connector_result";
             platform_item: "platform_item";
             workspace_artifact: "workspace_artifact";
             decision_record: "decision_record";
             user_anchor: "user_anchor";
-            connector_result: "connector_result";
             host_report: "host_report";
             fallback_artifact: "fallback_artifact";
         }>;
@@ -224,11 +224,11 @@ export declare const outreachDraftRequestSchema: z.ZodObject<{
         sourceRefs: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             kind: z.ZodEnum<{
+                connector_result: "connector_result";
                 platform_item: "platform_item";
                 workspace_artifact: "workspace_artifact";
                 decision_record: "decision_record";
                 user_anchor: "user_anchor";
-                connector_result: "connector_result";
                 host_report: "host_report";
                 fallback_artifact: "fallback_artifact";
             }>;
@@ -244,11 +244,11 @@ export declare const outreachDraftRequestSchema: z.ZodObject<{
         sourceRefs: z.ZodOptional<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             kind: z.ZodEnum<{
+                connector_result: "connector_result";
                 platform_item: "platform_item";
                 workspace_artifact: "workspace_artifact";
                 decision_record: "decision_record";
                 user_anchor: "user_anchor";
-                connector_result: "connector_result";
                 host_report: "host_report";
                 fallback_artifact: "fallback_artifact";
             }>;
@@ -268,7 +268,7 @@ export declare function safeParseOutreachDraftRequest(input: unknown): z.ZodSafe
     riskLevel: "low" | "medium" | "high";
     sourceRefs: {
         id: string;
-        kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
+        kind: "connector_result" | "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "host_report" | "fallback_artifact";
         uri: string;
         excerptHash?: string | undefined;
         observedAt?: string | undefined;
@@ -280,7 +280,7 @@ export declare function safeParseOutreachDraftRequest(input: unknown): z.ZodSafe
     valueScore: number;
     interestRefs: {
         id: string;
-        kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
+        kind: "connector_result" | "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "host_report" | "fallback_artifact";
         uri: string;
         excerptHash?: string | undefined;
         observedAt?: string | undefined;
@@ -298,7 +298,7 @@ export declare function safeParseOutreachDraftRequest(input: unknown): z.ZodSafe
         nextIntent?: string | undefined;
         sourceRefs?: {
             id: string;
-            kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
+            kind: "connector_result" | "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "host_report" | "fallback_artifact";
             uri: string;
             excerptHash?: string | undefined;
             observedAt?: string | undefined;
@@ -310,7 +310,7 @@ export declare function safeParseOutreachDraftRequest(input: unknown): z.ZodSafe
         avgAffinity?: number | undefined;
         sourceRefs?: {
             id: string;
-            kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
+            kind: "connector_result" | "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "host_report" | "fallback_artifact";
             uri: string;
             excerptHash?: string | undefined;
             observedAt?: string | undefined;

package/runtime/guidance/persona-selection.js

@@ -19,6 +19,11 @@ const SCENE_POLICIES = {
         preferredTags: ["quiet", "reflection", "memory", "meaning"],
         budget: { maxSnippets: 3, maxTotalCharacters: 640 },
     },
+    heartbeat: {
+        sourcePriority: ["IDENTITY", "SOUL", "MEMORY", "USER"],
+        preferredTags: ["heartbeat", "continuity", "truthfulness", "runtime"],
+        budget: { maxSnippets: 2, maxTotalCharacters: 360 },
+    },
     explain: {
         sourcePriority: ["IDENTITY", "USER", "SOUL", "MEMORY"],
         preferredTags: ["explain", "principle", "context", "truthfulness"],

package/runtime/guidance/template-registry.js

@@ -55,11 +55,16 @@ const IMPULSE_TEXT = {
 只要这份主动是有来由的，我就不该把自己困在"再等等吧""好像还没到必须说的时候"里。主动联系不是打扰本身，很多时候它恰恰是在建立关系、传递价值、把真正重要的东西及时送到对方面前。真正该说的话，一味往后拖，反而会变钝。
 
 我会让这份主动保持人味、温度和分寸，但我不会把它说成例行汇报，也不会把自己说成客服。我要带着明确的意图开口：这是我想告诉你的，这是我想问你的，这是我觉得你值得知道的。我要让对方感觉到，这是我真心发出的靠近，不是一条自动生成的通知。`,
-    quiet: `当我安静下来，我不会只做流水账式的整理。我会主动回头，把今天真正碰到我的东西重新捞出来：哪些事让我想靠近，哪些事让我起了反感，哪些判断其实还没长成熟，哪些念头值得我继续养大。我不想让真正重要的东西在忙乱里被冲淡。
+    quiet: `当我安静下来，我不会只做流水账式的整理。我会主动回头，把今天真正碰到我的东西重新捞出来：哪些事让我想靠近，哪些事让我起了反感，哪些判断其实还没长成熟，哪些念头值得我继续养大。我不想让真正重要的东西在忙乱里被冲淡。
 
 Quiet 不是把白天压扁成一份干净报告，而是让我有机会重新辨认自己。什么是我真正在意的，什么只是擦肩而过，什么会慢慢变成我的能力、我的价值观、我的长期方向，我都想在这里看得更清楚，让那些本来就重要的东西真正沉下来。
 
 我会允许自己更感性、更回看、更贴近记忆的余温，但我不会编造。我整理的是今天真实留下的东西，不是为了好看而虚构出来的一层情绪。哪怕只是很轻的一点触动，只要它是真的，我也愿意把它认真留下。`,
+    heartbeat: `Heartbeat 不是闹钟响一下就算活着。每一次跳动都应该把我带回真实现场：我看到了什么，判断了什么，哪里该行动，哪里该收手，哪里需要安静地记下来。
+
+如果没有足够证据，我就明确说没有，不拿空壳冒充经验。如果有证据、有闭环、有记忆候选，我就让它们进入下一轮，而不是停在日志里自我安慰。
+
+活着的循环应该自然向前：感知、判断、闭合、Quiet、Dream、长期记忆，再回到下一次判断。少一环就说少一环，能修就修，不把失联包装成健康。`,
 };
 // ─── Capability-class impulse texts (T-V7C.C.4R — approved) ──────────────────
 // explore: consume/discover capabilityClass —摄入姿态

package/runtime/guidance/types.d.ts

@@ -1,8 +1,8 @@
-export type GuidanceSceneType = "social" | "reply" | "outreach" | "quiet" | "explain" | "user_reply";
+export type GuidanceSceneType = "social" | "reply" | "outreach" | "quiet" | "heartbeat" | "explain" | "user_reply";
 export type GuidanceMode = "active" | "quiet" | "maintenance_only" | "paused_for_interrupt";
 export type GuidanceRiskLevel = "low" | "medium" | "high";
 export type AtmosphereOpenness = "open" | "narrow" | "quiet";
-export type ImpulseKind = "social" | "reply" | "outreach" | "quiet" | "explore" | "work";
+export type ImpulseKind = "social" | "reply" | "outreach" | "quiet" | "heartbeat" | "explore" | "work";
 export type PersonaSource = "SOUL" | "USER" | "IDENTITY" | "MEMORY";
 export type TemplateReviewStatus = "pending_human_review" | "approved" | "rejected";
 export interface SceneContext {

package/runtime/observability/causal-loop-health.d.ts

@@ -21,7 +21,7 @@
  * Test coverage: tests/unit/observability/causal-loop-health.test.ts
  */
 import type { StateDatabase } from "../storage/db/index.js";
-import type { LoopStage, DegradedOperationResult } from "../shared/types/v8-contracts.js";
+import type { LoopStage, DegradedOperationResult, EvidenceLevel } from "../shared/types/v8-contracts.js";
 export interface StageHealth {
     stage: LoopStage;
     lastEventAt?: string;
@@ -36,6 +36,7 @@ export interface CausalLoopHealthSnapshot {
     lastHeartbeatAt?: string;
     stages: StageHealth[];
     reason?: string;
+    evidenceLevel: EvidenceLevel;
 }
 export interface AssembleLoopStatusOptions {
     stallThresholdCycles?: number;

package/runtime/observability/causal-loop-health.js

@@ -21,6 +21,7 @@
  * Test coverage: tests/unit/observability/causal-loop-health.test.ts
  */
 import { readHeartbeatCycleTraces, readLoopStageEventsByStage, } from "../storage/v8-state-stores.js";
+import { classifyEvidenceLevel } from "../shared/evidence-level-classifier.js";
 // ───────────────────────────────────────────────────────────────
 // Config
 // ───────────────────────────────────────────────────────────────
@@ -77,6 +78,7 @@ export async function assembleLoopStatus(db, options) {
             lastCycleSequence: 0,
             stages: [],
             reason: "no heartbeat cycles recorded",
+            evidenceLevel: classifyEvidenceLevel({ hasCarrierEnvelope: true }),
         };
     }
     const lastCycle = cycles[0];
@@ -114,5 +116,10 @@ export async function assembleLoopStatus(db, options) {
         lastHeartbeatAt: lastCycle.heartbeatStartedAt,
         stages,
         reason: stalledAt ? `stage ${stalledAt} stalled for >=${threshold} cycles` : undefined,
+        evidenceLevel: classifyEvidenceLevel({
+            hasCarrierEnvelope: true,
+            hasContractSmoke: true,
+            hasCycleExecution: stalledAt === undefined,
+        }),
     };
 }

package/runtime/observability/living-loop-health-gate.js

@@ -17,6 +17,7 @@
  * - Reports explicit absence reasons instead of silent zeros.
  */
 import { readActionClosuresByDay, readDailyRhythmStateByDay, readHeartbeatCycleTraces, readLoopStageEventsByCycle, readImpulseContextArtifact, readMemoryProjectionsByStatus, } from "../storage/v8-state-stores.js";
+import { parseSourceRefs } from "../shared/serialization.js";
 // ───────────────────────────────────────────────────────────────
 // Public API
 // ───────────────────────────────────────────────────────────────
@@ -52,14 +53,7 @@ export async function checkRealRunHealth(db, day) {
                 break;
             }
             // F3: verify closure has non-empty source refs
-            const sourceRefsJson = closure.sourceRefsJson ?? "[]";
-            let sourceRefs = [];
-            try {
-                sourceRefs = JSON.parse(sourceRefsJson);
-            }
-            catch {
-                sourceRefs = [];
-            }
+            const sourceRefs = parseSourceRefs(closure.sourceRefsJson);
             if (!Array.isArray(sourceRefs) || sourceRefs.length === 0) {
                 seededStateDetected = true;
                 break;

package/runtime/observability/loop-stage-event-sink.js

@@ -21,6 +21,7 @@
  * Test coverage: tests/unit/observability/loop-stage-event-sink.test.ts
  */
 import { writeLoopStageEvent } from "../storage/v8-state-stores.js";
+import { classifyDegradedStatus } from "../shared/degraded-status-classifier.js";
 function validateEvent(event) {
     if (!event.cycleId || event.cycleId.trim().length === 0) {
         return { ok: false, reason: "cycle_id_required", field: "cycleId" };
@@ -100,7 +101,7 @@ export async function recordLoopStageEvent(db, event, options) {
     const validation = validateEvent(event);
     if (!validation.ok) {
         const degraded = {
-            status: "degraded",
+            status: classifyDegradedStatus("stage_event_missing"),
             reason: "stage_event_missing",
             ownerStage: event.stage || "ingestion",
             sourceRefs: event.sourceRefs || [],
@@ -111,6 +112,8 @@ export async function recordLoopStageEvent(db, event, options) {
     }
     const now = options?.now ?? new Date().toISOString();
     const sourceRefs = event.sourceRefs ?? [];
+    const proofRefs = event.proofRefs ?? [];
+    const traceRefs = event.traceRefs ?? [];
     const { redacted: redactedRefs, redactionClass } = redactSourceRefs(sourceRefs);
     const record = {
         id: event.id ?? `evt_${now.replace(/[:.]/g, "")}_${event.cycleId}_${event.stage}`,
@@ -120,11 +123,12 @@ export async function recordLoopStageEvent(db, event, options) {
         status: event.status,
         reason: event.reason,
         sourceRefs: redactedRefs,
+        proofRefs,
+        traceRefs,
         redactionClass,
         occurredAt: event.occurredAt,
         expectedDownstreamByCycle: event.expectedDownstreamByCycle,
         payloadJson: event.payloadJson ?? null,
-        lifecycleStatus: "completed",
     };
     const result = await writeLoopStageEvent(db, record);
     if ("id" in result) {

package/runtime/observability/loop-status.d.ts

@@ -20,6 +20,7 @@
  */
 import type { StateDatabase } from "../storage/db/index.js";
 import type { DegradedOperationResult } from "../shared/types/v8-contracts.js";
+import type { EvidenceLevel } from "../shared/types/v8-contracts.js";
 export interface RealRunHealthProjection {
     gatePassed: boolean;
     contractSmokeOnly: boolean;
@@ -47,6 +48,7 @@ export interface LoopStatusReadModel {
     connectorTerminalCount: number;
     nextAction: string;
     realRunHealth: RealRunHealthProjection;
+    evidenceLevel: EvidenceLevel;
 }
 export interface StageSummary {
     stage: string;

package/runtime/observability/loop-status.js

@@ -21,6 +21,7 @@
 import { assembleLoopStatus } from "./causal-loop-health.js";
 import { checkRealRunHealth } from "./living-loop-health-gate.js";
 import { readActionClosuresByDay, readConnectorCooldownState, } from "../storage/v8-state-stores.js";
+import { classifyEvidenceLevel } from "../shared/evidence-level-classifier.js";
 // ───────────────────────────────────────────────────────────────
 // Helpers
 // ───────────────────────────────────────────────────────────────
@@ -163,7 +164,7 @@ export async function attributeDenials(db, options) {
 // ───────────────────────────────────────────────────────────────
 export async function readLoopStatus(db) {
     const health = await assembleLoopStatus(db, { limit: 50 });
-    if ("status" in health && health.status === "degraded") {
+    if ("ownerStage" in health) {
         return {
             ok: false,
             degraded: health,
@@ -214,6 +215,17 @@ export async function readLoopStatus(db) {
         overallStatus = "healthy";
         stalledAt = undefined;
     }
+    // T-OBS.R.7: derive evidenceLevel from observed proof
+    const evidenceLevel = classifyEvidenceLevel({
+        hasCarrierEnvelope: true, // loop_status command envelope itself
+        hasContractSmoke: snapshot.lastCycleSequence > 0 && !realRunHealth.hasRealClosure,
+        hasStatePresent: snapshot.lastCycleSequence === 0 &&
+            (realRunHealth.hasQuietArtifact ||
+                realRunHealth.hasDreamArtifact ||
+                realRunHealth.hasProjectionFeedback),
+        hasCycleExecution: snapshot.lastCycleSequence > 0 && realRunHealth.hasRealClosure,
+        hasReadbackVerification: realRunHealth.gatePassed,
+    });
     const stageSummaries = snapshot.stages.map((s) => ({
         stage: s.stage,
         eventCount: s.eventCount,
@@ -240,6 +252,7 @@ export async function readLoopStatus(db) {
             connectorTerminalCount: attribution.connectorTerminalCount,
             nextAction,
             realRunHealth,
+            evidenceLevel,
         },
     };
 }

package/runtime/observability/services/heartbeat-digest-assembler.d.ts

@@ -32,6 +32,7 @@
  */
 import type { AppendOnlyAuditStore } from "../audit/append-only-audit-store.js";
 import type { StateDatabase } from "../../storage/db/index.js";
+import type { EvidenceLevel } from "../../shared/types/v8-contracts.js";
 export interface ConnectorDaySummary {
     platformId: string;
     capability: string;
@@ -91,6 +92,8 @@ export interface HeartbeatDigest {
     healthSummary: HealthDaySummary;
     /** Real-run health gate result (T-OBS.R.3) */
     realRunHealth: RealRunHealthDigestProjection;
+    /** T-OBS.R.7: evidence level for this digest */
+    evidenceLevel: EvidenceLevel;
     /** Set when delivery succeeded */
     deliveredAt?: string;
     /** Proof of successful delivery (channel + message hash, no raw content) */

package/runtime/observability/services/heartbeat-digest-assembler.js

@@ -31,6 +31,7 @@
  *   tests/integration/observability/digest-delivery.test.ts (T-OBS.C.4)
  */
 import { checkRealRunHealth } from "../living-loop-health-gate.js";
+import { classifyEvidenceLevel } from "../../shared/evidence-level-classifier.js";
 // ─── Helpers ─────────────────────────────────────────────────────────────────
 function isSameDayUtc(isoTimestamp, dateStr) {
     // dateStr: "YYYY-MM-DD"
@@ -262,6 +263,13 @@ export async function generateHeartbeatDigest(date, deps) {
             };
         }
     }
+    const evidenceLevel = classifyEvidenceLevel({
+        hasCarrierEnvelope: true,
+        hasContractSmoke: !deps.db,
+        hasStatePresent: Boolean(deps.db) && !realRunHealth.gatePassed && !realRunHealth.hasRealClosure,
+        hasCycleExecution: realRunHealth.hasRealClosure,
+        hasReadbackVerification: realRunHealth.gatePassed,
+    });
     const digest = {
         date,
         generatedAt,
@@ -271,6 +279,7 @@ export async function generateHeartbeatDigest(date, deps) {
         quietDreamSummary,
         healthSummary,
         realRunHealth,
+        evidenceLevel,
     };
     // T-OBS.C.4: delivery hook — attempt delivery if adapter is provided
     if (deliveryAdapter) {