@haaaiawd/second-nature 0.2.9 → 0.2.12

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/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

@@ -124,7 +124,6 @@ export async function recordLoopStageEvent(db, event, options) {
         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/services/lived-experience-audit.d.ts

@@ -1,5 +1,5 @@
 import { AppendOnlyAuditStore } from "../audit/append-only-audit-store.js";
-import type { SourceRef } from "../../storage/life-evidence/types.js";
+import type { LifeEvidenceSourceRef } from "../../storage/life-evidence/types.js";
 import type { DreamTrace } from "../../dream/types.js";
 export type RuntimeScope = "rhythm" | "user_task" | "user_reply";
 export type HeartbeatOutcome = "heartbeat_ok" | "intent_selected" | "denied" | "deferred" | "runtime_carrier_only" | "delivery_unavailable";
@@ -18,8 +18,8 @@ export interface DecisionTracePayload {
     outreachVerdict?: "allow" | "deny" | "defer";
     deliveryAuditId?: string;
     reasonCodes: string[];
-    sourceRefs: SourceRef[];
-    snapshotRef?: SourceRef;
+    sourceRefs: LifeEvidenceSourceRef[];
+    snapshotRef?: LifeEvidenceSourceRef;
     createdAt: string;
 }
 export interface DeliveryAuditPayload {
@@ -31,7 +31,7 @@ export interface DeliveryAuditPayload {
     recipientRef?: string;
     status: DeliveryAuditStatus;
     messageId?: string;
-    hostProofRef?: SourceRef;
+    hostProofRef?: LifeEvidenceSourceRef;
     fallbackRef?: string;
     ackDropMatched?: boolean;
     hostVersion?: string;
@@ -45,8 +45,8 @@ export interface SourceCoverageAuditPayload {
     decisionId?: string;
     subjectType: "quiet_artifact" | "outreach_draft" | "guidance_payload" | "decision_trace" | "host_report";
     subjectRef: string;
-    usedSourceRefs: SourceRef[];
-    unresolvedRefs: SourceRef[];
+    usedSourceRefs: LifeEvidenceSourceRef[];
+    unresolvedRefs: LifeEvidenceSourceRef[];
     coverageRatio: number;
     unsupportedClaims: string[];
     status: GroundingStatus;
@@ -61,7 +61,7 @@ export interface GuidanceGroundingAuditPayload {
     draftId?: string;
     sceneType: "outreach" | "quiet_reflection" | "social" | "explain" | "user_reply_continuity" | "fallback_candidate";
     groundingStatus: GroundingStatus;
-    usedSourceRefs: SourceRef[];
+    usedSourceRefs: LifeEvidenceSourceRef[];
     unsupportedClaims: string[];
     guardViolations: string[];
     deliveryWording?: "sendable" | "not_sent_fallback_candidate";

package/runtime/shared/serialization.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Shared serialization helpers for cross-system value types.
+ *
+ * Core logic:
+ * - `parseSourceRefs` / `serializeSourceRefs` provide the single round-trip
+ *   implementation for `sourceRefsJson` / `source_refs_json` columns.
+ * - Failures are silent on read (return empty array) because malformed JSON
+ *   in persisted state must not crash downstream consumers; callers that need
+ *   to distinguish malformed rows should validate separately.
+ *
+ * Dependencies: `src/shared/types/v8-contracts.js` (SourceRef)
+ * Boundary: Pure functions; no storage or business logic.
+ * Test coverage: `tests/unit/shared/source-ref-serialization.test.ts`
+ */
+import type { SourceRef } from "./types/v8-contracts.js";
+export declare function serializeSourceRefs(refs: SourceRef[]): string;
+export declare function parseSourceRefs(json: string | null | undefined): SourceRef[];

package/runtime/shared/serialization.js

@@ -0,0 +1,27 @@
+export function serializeSourceRefs(refs) {
+    return JSON.stringify(refs);
+}
+function isSourceRef(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const candidate = value;
+    return (typeof candidate.uri === "string" &&
+        typeof candidate.family === "string" &&
+        typeof candidate.id === "string" &&
+        typeof candidate.redactionClass === "string" &&
+        (candidate.sensitivityClass === undefined ||
+            typeof candidate.sensitivityClass === "string"));
+}
+export function parseSourceRefs(json) {
+    if (!json)
+        return [];
+    try {
+        const parsed = JSON.parse(json);
+        if (Array.isArray(parsed) && parsed.every(isSourceRef))
+            return parsed;
+        return [];
+    }
+    catch {
+        return [];
+    }
+}

package/runtime/shared/source-ref-compat.d.ts

@@ -0,0 +1,26 @@
+/**
+ * SourceRef compatibility adapters.
+ *
+ * Core logic: convert legacy v5/v7 source-ref shapes that used `kind` into
+ * the v8 canonical `SourceRef` shape (`family` + `redactionClass`).
+ * Dependencies: shared v8 contracts only.
+ * Boundary: compatibility at old/new system seams; canonical v8 modules should
+ * pass `SourceRef` directly without reintroducing local clones.
+ * Test coverage: Wave 113 typecheck and affected control-plane/host/life-evidence tests.
+ */
+import type { SourceRef, SourceRefFamily } from "./types/v8-contracts.js";
+export type LegacySourceRefKind = "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
+export interface LegacySourceRefLike {
+    id: string;
+    kind?: LegacySourceRefKind | string;
+    uri: string;
+}
+export declare function sourceRefFamilyFromLegacyKind(kind: LegacySourceRefKind | string | undefined): SourceRefFamily;
+export declare function legacyKindFromSourceRef(ref: SourceRef): LegacySourceRefKind;
+export declare function toCanonicalSourceRef(ref: LegacySourceRefLike): SourceRef;
+export declare function makeCanonicalSourceRef(input: {
+    id: string;
+    family: SourceRefFamily;
+    uri: string;
+    redactionClass?: SourceRef["redactionClass"];
+}): SourceRef;

package/runtime/shared/source-ref-compat.js

@@ -0,0 +1,61 @@
+export function sourceRefFamilyFromLegacyKind(kind) {
+    switch (kind) {
+        case "connector_result":
+            return "connector_result";
+        case "decision_record":
+            return "judgment";
+        case "platform_item":
+        case "user_anchor":
+            return "evidence";
+        case "workspace_artifact":
+        case "host_report":
+        case "fallback_artifact":
+        default:
+            return "audit";
+    }
+}
+export function legacyKindFromSourceRef(ref) {
+    if (ref.uri.startsWith("platform://")) {
+        return "platform_item";
+    }
+    if (ref.uri.startsWith("goal://") || ref.uri.startsWith("workspace://")) {
+        return "workspace_artifact";
+    }
+    if (ref.id.startsWith("anchor:") || ref.id.startsWith("curated:") || /(?:USER|MEMORY)\.md$/i.test(ref.uri)) {
+        return "user_anchor";
+    }
+    switch (ref.family) {
+        case "connector_result":
+            return "connector_result";
+        case "judgment":
+            return "decision_record";
+        case "evidence":
+        case "perception":
+            return "platform_item";
+        case "audit":
+        case "action_closure":
+        case "quiet_review":
+        case "dream_run":
+        case "memory_projection":
+        case "projection":
+        case "tool_experience":
+        default:
+            return "workspace_artifact";
+    }
+}
+export function toCanonicalSourceRef(ref) {
+    return {
+        id: ref.id,
+        uri: ref.uri,
+        family: sourceRefFamilyFromLegacyKind(ref.kind),
+        redactionClass: "none",
+    };
+}
+export function makeCanonicalSourceRef(input) {
+    return {
+        id: input.id,
+        family: input.family,
+        uri: input.uri,
+        redactionClass: input.redactionClass ?? "none",
+    };
+}

package/runtime/shared/types/goal.d.ts

@@ -7,7 +7,7 @@
  * - `status` supports full v7 lifecycle including paused → expired/replaced.
  *
  * Dependencies:
- * - `SourceRef` from `./source-ref.js` for grounding.
+ * - `SourceRefTuple` from `./source-ref.js` for grounding.
  *
  * Boundary:
  * - Used by state-memory (GoalLifecycleStore), control-plane
@@ -17,7 +17,7 @@
  * Test coverage: tests/unit/shared/v7-entities.test.ts (invalid kind
  * `@ts-expect-error` compile guard).
  */
-import type { SourceRef } from "./source-ref.js";
+import type { SourceRefTuple } from "./source-ref.js";
 export type AgentGoalKind = "short_term" | "long_term" | "habit" | "maintenance" | "passive_sensing" | "outreach" | "exploration";
 export type AgentGoalStatus = "proposal" | "accepted" | "rejected" | "completed" | "paused" | "expired" | "replaced";
 export type AgentGoalOrigin = "owner_set" | "agent_proposed" | "policy_seeded";
@@ -32,7 +32,7 @@ export interface AgentGoal {
     completionCriteria: string;
     risk: "low" | "medium" | "high";
     priorityHint: number;
-    sourceRefs: SourceRef;
+    sourceRefs: SourceRefTuple;
     acceptedBy?: "owner" | "policy_allowlist";
     expiresAt?: string;
     createdAt: string;
@@ -48,7 +48,7 @@ export interface AgentGoalWrite {
     completionCriteria: string;
     risk: "low" | "medium" | "high";
     priorityHint: number;
-    sourceRefs: SourceRef;
+    sourceRefs: SourceRefTuple;
     acceptedBy?: "owner" | "policy_allowlist";
     expiresAt?: string;
     createdAt: string;

package/runtime/shared/types/goal.js

@@ -7,7 +7,7 @@
  * - `status` supports full v7 lifecycle including paused → expired/replaced.
  *
  * Dependencies:
- * - `SourceRef` from `./source-ref.js` for grounding.
+ * - `SourceRefTuple` from `./source-ref.js` for grounding.
  *
  * Boundary:
  * - Used by state-memory (GoalLifecycleStore), control-plane

package/runtime/shared/types/index.d.ts

@@ -4,3 +4,4 @@ export * from "./outreach.js";
 export * from "./source-ref.js";
 export * from "./goal.js";
 export * from "./v7-entities.js";
+export * from "./v8-contracts.js";

package/runtime/shared/types/index.js

@@ -4,6 +4,4 @@ export * from "./outreach.js";
 export * from "./source-ref.js";
 export * from "./goal.js";
 export * from "./v7-entities.js";
-// v8-contracts intentionally NOT re-exported from index to avoid SourceRef
-// name collision with v7 tuple type. v8 consumers import directly from
-// `./v8-contracts.js`.
+export * from "./v8-contracts.js";

package/runtime/shared/types/source-ref.d.ts

@@ -1,5 +1,5 @@
 /**
- * SourceRef — v7 non-empty tuple for source grounding.
+ * SourceRefTuple — v7 non-empty tuple for source grounding.
  *
  * Core logic: Every fact claim must carry at least one source reference.
  * DR-025 enforces non-empty at compile time. Empty array assignments are
@@ -11,4 +11,4 @@
  * Test coverage: tests/unit/shared/v7-entities.test.ts (compile-time
  * `@ts-expect-error` guard for empty tuple).
  */
-export type SourceRef = readonly [string, ...string[]];
+export type SourceRefTuple = readonly [string, ...string[]];

package/runtime/shared/types/v7-entities.d.ts

@@ -12,7 +12,7 @@
  * - ADR-002/003/007/008 — entity semantics
  *
  * Dependencies:
- * - `SourceRef` from `./source-ref.js`
+ * - `SourceRefTuple` from `./source-ref.js`
  * - `AgentGoal` from `./goal.js`
  *
  * Boundary:
@@ -24,7 +24,7 @@
  *
  * Test coverage: tests/unit/shared/v7-entities.test.ts
  */
-import type { SourceRef } from "./source-ref.js";
+import type { SourceRefTuple } from "./source-ref.js";
 import type { AgentGoal } from "./goal.js";
 export interface PlatformHandle {
     platformId: string;
@@ -60,7 +60,7 @@ export interface ToolExperience {
     failureClass?: string;
     latencyMs: number;
     evidenceQuality: number;
-    sourceRefs: SourceRef;
+    sourceRefs: SourceRefTuple;
     triggerSource: ToolExperienceTriggerSource;
     createdAt: string;
 }
@@ -97,7 +97,7 @@ export interface QuietClaim {
     claimId: string;
     kind: QuietClaimKind;
     text: string;
-    sourceRefs: SourceRef;
+    sourceRefs: SourceRefTuple;
     confidence: number;
     createdAt: string;
 }
@@ -107,7 +107,7 @@ export interface DailyDiary {
     observedToday: string[];
     notableSignals: string[];
     tomorrowDirection: string;
-    sourceRefs: SourceRef;
+    sourceRefs: SourceRefTuple;
     createdAt: string;
 }
 export type DreamOutputStatus = "candidate" | "accepted" | "archived" | "partial";

package/runtime/shared/types/v7-entities.js

@@ -12,7 +12,7 @@
  * - ADR-002/003/007/008 — entity semantics
  *
  * Dependencies:
- * - `SourceRef` from `./source-ref.js`
+ * - `SourceRefTuple` from `./source-ref.js`
  * - `AgentGoal` from `./goal.js`
  *
  * Boundary:

package/runtime/shared/types/v8-contracts.d.ts

@@ -82,5 +82,5 @@ export interface DegradedOperationResult {
     operatorNextAction: string;
     retryable: boolean;
 }
-export type V8ReasonCode = "quiet_completed" | "quiet_empty_input" | "quiet_state_unreadable" | "quiet_validation_failed" | "quiet_redaction_blocked" | "dream_scheduled" | "dream_scheduled_stalled" | "dream_scheduler_unavailable" | "dream_started" | "dream_completed" | "dream_failed" | "dream_blocked_redaction" | "dream_rules_only" | "dream_model_timeout" | "projection_candidate_created" | "projection_accepted" | "projection_rejected" | "projection_superseded" | "projection_topic_matched" | "proposal_created" | "proposal_no_action" | "proposal_missing_source_refs" | "proposal_risk_blocked" | "policy_allowed" | "policy_deferred_owner_confirmation" | "policy_downgraded_to_draft" | "policy_denied_missing_permission" | "policy_denied_high_risk" | "policy_denied_breaker_open" | "guidance_unavailable" | "closure_completed" | "closure_no_action" | "closure_denied" | "closure_deferred" | "closure_downgraded" | "closure_downgraded_without_draft" | "closure_failed" | "perception_rules_only" | "perception_contract_drift" | "evidence_batch_empty" | "evidence_batch_truncated" | "evidence_content_missing" | "judgment_low_confidence" | "judgment_missing_source_refs" | "source_refs_unresolved" | "state_unreadable" | "stage_event_missing" | "ingestion_no_data" | "ingestion_empty" | "ingestion_state_unreadable" | "ingestion_connector_failed" | "execution_completed" | "execution_failed" | "execution_timeout" | "execution_unavailable";
+export type V8ReasonCode = "quiet_completed" | "quiet_empty_input" | "quiet_state_unreadable" | "quiet_validation_failed" | "quiet_redaction_blocked" | "dream_scheduled" | "dream_scheduled_stalled" | "dream_scheduler_unavailable" | "dream_started" | "dream_completed" | "dream_failed" | "dream_blocked_redaction" | "dream_interval_active" | "dream_rules_only" | "dream_model_timeout" | "projection_candidate_created" | "projection_accepted" | "projection_rejected" | "projection_superseded" | "projection_topic_matched" | "proposal_created" | "proposal_no_action" | "proposal_missing_source_refs" | "proposal_risk_blocked" | "policy_allowed" | "policy_deferred_owner_confirmation" | "policy_downgraded_to_draft" | "policy_denied_missing_permission" | "policy_denied_high_risk" | "policy_denied_breaker_open" | "guidance_unavailable" | "closure_completed" | "closure_no_action" | "closure_denied" | "closure_deferred" | "closure_downgraded" | "closure_downgraded_without_draft" | "closure_failed" | "perception_rules_only" | "perception_contract_drift" | "evidence_batch_empty" | "evidence_batch_truncated" | "evidence_content_missing" | "judgment_low_confidence" | "judgment_missing_source_refs" | "source_refs_unresolved" | "state_unreadable" | "stage_event_missing" | "ingestion_no_data" | "ingestion_empty" | "ingestion_state_unreadable" | "ingestion_connector_failed" | "execution_completed" | "execution_failed" | "execution_timeout" | "execution_unavailable";
 export declare const ACTION_KIND_REGISTRY: Readonly<Record<PlatformNeutralActionKind, ActionKindMetadata>>;

package/runtime/storage/db/index.js

@@ -232,11 +232,10 @@ const STATE_SCHEMA_SQL = `
     status TEXT NOT NULL,
     reason TEXT,
     next_state TEXT,
-    source_refs_json TEXT NOT NULL,
-    redaction_class TEXT NOT NULL DEFAULT 'none',
-    payload_json TEXT,
-    lifecycle_status TEXT NOT NULL DEFAULT 'closed'
-  );
+    source_refs_json TEXT NOT NULL,
+    redaction_class TEXT NOT NULL DEFAULT 'none',
+    payload_json TEXT
+  );
   CREATE TABLE IF NOT EXISTS quiet_daily_review (
     id TEXT PRIMARY KEY,
     created_at TEXT NOT NULL,
@@ -255,22 +254,20 @@ const STATE_SCHEMA_SQL = `
     quiet_review_id TEXT NOT NULL,
     status TEXT NOT NULL,
     reason TEXT,
-    source_refs_json TEXT NOT NULL,
-    redaction_class TEXT NOT NULL DEFAULT 'none',
-    payload_json TEXT,
-    lifecycle_status TEXT NOT NULL DEFAULT 'pending'
-  );
+    source_refs_json TEXT NOT NULL,
+    redaction_class TEXT NOT NULL DEFAULT 'none',
+    payload_json TEXT
+  );
   CREATE TABLE IF NOT EXISTS long_term_memory_projection (
     id TEXT PRIMARY KEY,
     created_at TEXT NOT NULL,
     candidate_id TEXT NOT NULL,
     topic_key TEXT NOT NULL,
     status TEXT NOT NULL DEFAULT 'candidate',
-    source_refs_json TEXT NOT NULL,
-    redaction_class TEXT NOT NULL DEFAULT 'none',
-    payload_json TEXT,
-    lifecycle_status TEXT NOT NULL DEFAULT 'candidate'
-  );
+    source_refs_json TEXT NOT NULL,
+    redaction_class TEXT NOT NULL DEFAULT 'none',
+    payload_json TEXT
+  );
   CREATE TABLE IF NOT EXISTS heartbeat_cycle_trace (
     id TEXT PRIMARY KEY,
     cycle_sequence INTEGER NOT NULL,
@@ -279,12 +276,11 @@ const STATE_SCHEMA_SQL = `
     input_count INTEGER NOT NULL DEFAULT 0,
     output_count INTEGER NOT NULL DEFAULT 0,
     expected_downstream_by_cycle INTEGER,
-    status TEXT NOT NULL,
-    source_refs_json TEXT,
-    redaction_class TEXT NOT NULL DEFAULT 'none',
-    payload_json TEXT,
-    lifecycle_status TEXT NOT NULL DEFAULT 'started'
-  );
+    status TEXT NOT NULL,
+    source_refs_json TEXT,
+    redaction_class TEXT NOT NULL DEFAULT 'none',
+    payload_json TEXT
+  );
   CREATE TABLE IF NOT EXISTS loop_stage_event (
     id TEXT PRIMARY KEY,
     cycle_id TEXT NOT NULL,
@@ -294,11 +290,10 @@ const STATE_SCHEMA_SQL = `
     reason TEXT,
     source_refs_json TEXT NOT NULL,
     redaction_class TEXT NOT NULL DEFAULT 'none',
-    occurred_at TEXT NOT NULL,
-    expected_downstream_by_cycle INTEGER,
-    payload_json TEXT,
-    lifecycle_status TEXT NOT NULL DEFAULT 'started'
-  );
+    occurred_at TEXT NOT NULL,
+    expected_downstream_by_cycle INTEGER,
+    payload_json TEXT
+  );
   CREATE TABLE IF NOT EXISTS impulse_context_artifact (
     id TEXT PRIMARY KEY,
     created_at TEXT NOT NULL,
@@ -366,12 +361,22 @@ function bootstrapStateSchema(sqlite) {
     runMigrations(sqlite, ALL_MIGRATIONS);
 }
 function applyStateSchemaMigrations(sqlite) {
+    // Defensive column/index additions for DBs that were initialized before
+    // v8-004-schema-closure. Fresh DBs already have these from bootstrap SQL.
+    // Each statement is wrapped individually so duplicate-column errors are
+    // harmless and do not block startup.
     const migrations = [
         "ALTER TABLE policy_records ADD COLUMN outreach_daily_budget INTEGER NOT NULL DEFAULT 2",
         "ALTER TABLE action_closure_record ADD COLUMN platform_id TEXT",
         "ALTER TABLE action_closure_record ADD COLUMN capability_id TEXT",
+        "ALTER TABLE quiet_daily_review ADD COLUMN closure_refs_json TEXT",
         "ALTER TABLE connector_cooldown_state ADD COLUMN terminal_count INTEGER NOT NULL DEFAULT 0",
         "CREATE INDEX IF NOT EXISTS connector_cooldown_state_platform_capability_idx ON connector_cooldown_state(platform_id, capability_id)",
+        "ALTER TABLE action_closure_record DROP COLUMN lifecycle_status",
+        "ALTER TABLE dream_consolidation_run DROP COLUMN lifecycle_status",
+        "ALTER TABLE long_term_memory_projection DROP COLUMN lifecycle_status",
+        "ALTER TABLE heartbeat_cycle_trace DROP COLUMN lifecycle_status",
+        "ALTER TABLE loop_stage_event DROP COLUMN lifecycle_status",
     ];
     for (const sql of migrations) {
         try {