@haaaiawd/second-nature 0.2.2 → 0.2.4

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

@@ -20,6 +20,16 @@
  */
 import type { StateDatabase } from "../storage/db/index.js";
 import type { DegradedOperationResult } from "../shared/types/v8-contracts.js";
+export interface RealRunHealthProjection {
+    gatePassed: boolean;
+    contractSmokeOnly: boolean;
+    seededStateDetected: boolean;
+    hasRealClosure: boolean;
+    hasQuietArtifact: boolean;
+    hasDreamArtifact: boolean;
+    missingStage?: string;
+    missingReason?: string;
+}
 export interface LoopStatusReadModel {
     ok: true;
     overallStatus: string;
@@ -29,6 +39,7 @@ export interface LoopStatusReadModel {
     stageSummaries: StageSummary[];
     policyDeniedCount: number;
     nextAction: string;
+    realRunHealth: RealRunHealthProjection;
 }
 export interface StageSummary {
     stage: string;

package/runtime/observability/loop-status.js

@@ -19,10 +19,15 @@
  * Test coverage: tests/unit/observability/loop-status.test.ts
  */
 import { assembleLoopStatus } from "./causal-loop-health.js";
+import { checkRealRunHealth } from "./living-loop-health-gate.js";
 // ───────────────────────────────────────────────────────────────
 // Helpers
 // ───────────────────────────────────────────────────────────────
-function computeNextAction(overallStatus, stalledAt) {
+function computeNextAction(overallStatus, stalledAt, realRunMissingStage, realRunMissingReason) {
+    // Real-run health takes precedence over generic causal health
+    if (realRunMissingStage && realRunMissingStage !== "none") {
+        return `Real-run health degraded: ${realRunMissingReason ?? `missing stage: ${realRunMissingStage}`}. Run a real heartbeat cycle or verify daily rhythm state.`;
+    }
     if (overallStatus === "healthy") {
         return "No operator action required. Loop is progressing normally.";
     }
@@ -60,6 +65,46 @@ export async function readLoopStatus(db) {
         };
     }
     const snapshot = health;
+    // T-OBS.R.3: Consume real-run health gate
+    const realRunResult = await checkRealRunHealth(db);
+    let realRunHealth;
+    if (realRunResult.ok) {
+        realRunHealth = {
+            gatePassed: realRunResult.gate.gatePassed,
+            contractSmokeOnly: realRunResult.gate.contractSmokeOnly,
+            seededStateDetected: realRunResult.gate.seededStateDetected,
+            hasRealClosure: realRunResult.gate.hasRealClosure,
+            hasQuietArtifact: realRunResult.gate.hasQuietArtifact,
+            hasDreamArtifact: realRunResult.gate.hasDreamArtifact,
+            missingStage: realRunResult.gate.missingStage,
+            missingReason: realRunResult.gate.missingReason,
+        };
+    }
+    else {
+        realRunHealth = {
+            gatePassed: false,
+            contractSmokeOnly: false,
+            seededStateDetected: false,
+            hasRealClosure: false,
+            hasQuietArtifact: false,
+            hasDreamArtifact: false,
+            missingReason: "Real-run health check degraded",
+        };
+    }
+    // Override overallStatus based on real-run health parity
+    let overallStatus = snapshot.overallStatus;
+    let stalledAt = snapshot.stalledAt;
+    if (!realRunHealth.gatePassed) {
+        // Real-run gate fails → cannot report healthy
+        if (overallStatus === "healthy") {
+            overallStatus = "degraded";
+        }
+    }
+    else {
+        // Real-run gate passes → all stages have evidence, ignore staged-event-only stall
+        overallStatus = "healthy";
+        stalledAt = undefined;
+    }
     const stageSummaries = snapshot.stages.map((s) => ({
         stage: s.stage,
         eventCount: s.eventCount,
@@ -68,18 +113,19 @@ export async function readLoopStatus(db) {
     }));
     // Policy denied count is a placeholder; real implementation would query action closures
     const policyDeniedCount = 0;
-    const nextAction = computeNextAction(snapshot.overallStatus, snapshot.stalledAt);
+    const nextAction = computeNextAction(overallStatus, snapshot.stalledAt, realRunHealth.missingStage, realRunHealth.missingReason);
     return {
         ok: true,
         status: {
             ok: true,
-            overallStatus: snapshot.overallStatus,
+            overallStatus,
             stalledAt: snapshot.stalledAt,
             lastCycleSequence: snapshot.lastCycleSequence,
             lastHeartbeatAt: snapshot.lastHeartbeatAt,
             stageSummaries,
             policyDeniedCount,
             nextAction,
+            realRunHealth,
         },
     };
 }

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

@@ -68,6 +68,16 @@ export interface DeliveryProofRef {
     channelId: string;
     messageHash: string;
 }
+export interface RealRunHealthDigestProjection {
+    gatePassed: boolean;
+    contractSmokeOnly: boolean;
+    seededStateDetected: boolean;
+    hasRealClosure: boolean;
+    hasQuietArtifact: boolean;
+    hasDreamArtifact: boolean;
+    missingStage?: string;
+    missingReason?: string;
+}
 export interface HeartbeatDigest {
     date: string;
     generatedAt: string;
@@ -76,6 +86,8 @@ export interface HeartbeatDigest {
     goalSummary: GoalDaySummary;
     quietDreamSummary: QuietDreamDaySummary;
     healthSummary: HealthDaySummary;
+    /** Real-run health gate result (T-OBS.R.3) */
+    realRunHealth: RealRunHealthDigestProjection;
     /** Set when delivery succeeded */
     deliveredAt?: string;
     /** Proof of successful delivery (channel + message hash, no raw content) */

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

@@ -227,6 +227,15 @@ export async function generateHeartbeatDigest(date, deps) {
         goalSummary,
         quietDreamSummary,
         healthSummary,
+        realRunHealth: {
+            gatePassed: false,
+            contractSmokeOnly: true,
+            seededStateDetected: false,
+            hasRealClosure: false,
+            hasQuietArtifact: false,
+            hasDreamArtifact: false,
+            missingReason: "Real-run health not evaluated — call checkRealRunHealth before digest generation",
+        },
     };
     // T-OBS.C.4: delivery hook — attempt delivery if adapter is provided
     if (deliveryAdapter) {

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

@@ -25,7 +25,7 @@ export interface ActionKindMetadata {
     allowedDowngrades: PlatformNeutralActionKind[];
 }
 export type ConnectorCapabilitySideEffect = "external_read" | "external_write" | "local_state" | "unknown";
-export type SourceRefFamily = "evidence" | "perception" | "judgment" | "action_closure" | "quiet_review" | "dream_run" | "memory_projection" | "tool_experience" | "connector_result" | "audit";
+export type SourceRefFamily = "evidence" | "perception" | "judgment" | "action_closure" | "quiet_review" | "dream_run" | "memory_projection" | "projection" | "tool_experience" | "connector_result" | "audit";
 export type RedactionClass = "none" | "redacted" | "blocked";
 export type SensitivityClass = "public_technical" | "public_general" | "private_context" | "sensitive";
 export type SourceResolveStatus = "resolvable" | "missing" | "redacted" | "permission_denied";
@@ -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" | "dream_scheduled" | "dream_scheduler_unavailable" | "dream_started" | "dream_completed" | "dream_failed" | "dream_blocked_redaction" | "projection_candidate_created" | "projection_accepted" | "projection_rejected" | "projection_superseded" | "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" | "evidence_batch_empty" | "evidence_batch_truncated" | "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" | "dream_scheduled" | "dream_scheduler_unavailable" | "dream_started" | "dream_completed" | "dream_failed" | "dream_blocked_redaction" | "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" | "evidence_batch_empty" | "evidence_batch_truncated" | "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

@@ -197,6 +197,7 @@ const STATE_SCHEMA_SQL = `
     entities_json TEXT,
     novelty TEXT,
     relevance REAL,
+    relevance_class TEXT,
     summary TEXT,
     risk_flags_json TEXT,
     confidence REAL,
@@ -241,6 +242,7 @@ const STATE_SCHEMA_SQL = `
     closure_count INTEGER NOT NULL DEFAULT 0,
     memory_candidate_count INTEGER NOT NULL DEFAULT 0,
     source_refs_json TEXT NOT NULL,
+    closure_refs_json TEXT,
     redaction_class TEXT NOT NULL DEFAULT 'none',
     payload_json TEXT,
     lifecycle_status TEXT NOT NULL DEFAULT 'pending'
@@ -295,6 +297,38 @@ const STATE_SCHEMA_SQL = `
     payload_json TEXT,
     lifecycle_status TEXT NOT NULL DEFAULT 'started'
   );
+  CREATE TABLE IF NOT EXISTS impulse_context_artifact (
+    id TEXT PRIMARY KEY,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    scene_type TEXT NOT NULL,
+    capability_intent TEXT,
+    platform_id TEXT,
+    capability_class TEXT,
+    impulse_source TEXT NOT NULL,
+    impulse_text TEXT,
+    atmosphere_text TEXT,
+    expression_boundary_constraints_json TEXT,
+    expression_boundary_style TEXT,
+    freshness_version INTEGER NOT NULL DEFAULT 1,
+    source_refs_json TEXT NOT NULL,
+    redaction_class TEXT NOT NULL DEFAULT 'none',
+    payload_json TEXT,
+    lifecycle_status TEXT NOT NULL DEFAULT 'active'
+  );
+  CREATE TABLE IF NOT EXISTS daily_rhythm_state (
+    id TEXT PRIMARY KEY,
+    day TEXT NOT NULL,
+    quiet_status TEXT NOT NULL DEFAULT 'not_due',
+    dream_status TEXT NOT NULL DEFAULT 'not_due',
+    quiet_reason TEXT,
+    dream_reason TEXT,
+    quiet_completed_at TEXT,
+    dream_completed_at TEXT,
+    source_refs_json TEXT NOT NULL,
+    payload_json TEXT,
+    updated_at TEXT NOT NULL
+  );
 `;
 function resolveDbPath(filename) {
     if (path.isAbsolute(filename) || filename === ":memory:") {

package/runtime/storage/db/migrations/index.js

@@ -6,10 +6,14 @@ import { V7_002_EFFECT_COMMIT_LEDGER } from "./v7-002-effect-commit-ledger.js";
 import { V7_003_CIRCUIT_BREAKER } from "./v7-003-circuit-breaker.js";
 import { V7_004_BEHAVIOR_PROMOTION } from "./v7-004-behavior-promotion.js";
 import { V8_001_LIVING_PERCEPTION_LOOP } from "./v8-001-living-perception-loop.js";
+import { V8_002_PERCEPTION_CONTRACT_ALIGNMENT } from "./v8-002-perception-contract-alignment.js";
+import { V8_003_QUIET_CLOSURE_REFS } from "./v8-003-quiet-closure-refs.js";
 export const ALL_MIGRATIONS = [
     V7_001_FOUNDATION,
     V7_002_EFFECT_COMMIT_LEDGER,
     V7_003_CIRCUIT_BREAKER,
     V7_004_BEHAVIOR_PROMOTION,
     V8_001_LIVING_PERCEPTION_LOOP,
+    V8_002_PERCEPTION_CONTRACT_ALIGNMENT,
+    V8_003_QUIET_CLOSURE_REFS,
 ];

package/runtime/storage/db/migrations/v8-001-living-perception-loop.js

@@ -6,124 +6,124 @@
 export const V8_001_LIVING_PERCEPTION_LOOP = {
     version: 5,
     label: "v8-living-perception-loop",
-    sql: `
-    CREATE TABLE IF NOT EXISTS evidence_item (
-      id TEXT PRIMARY KEY,
-      created_at TEXT NOT NULL,
-      platform_id TEXT NOT NULL,
-      content_hash TEXT NOT NULL,
-      observed_at TEXT NOT NULL,
-      sensitivity_hint TEXT,
-      source_refs_json TEXT NOT NULL,
-      redaction_class TEXT NOT NULL DEFAULT 'none',
-      payload_json TEXT,
-      lifecycle_status TEXT NOT NULL DEFAULT 'pending'
-    );
-    CREATE TABLE IF NOT EXISTS perception_card (
-      id TEXT PRIMARY KEY,
-      created_at TEXT NOT NULL,
-      cycle_id TEXT NOT NULL,
-      topic TEXT,
-      entities_json TEXT,
-      novelty TEXT,
-      relevance REAL,
-      summary TEXT,
-      risk_flags_json TEXT,
-      confidence REAL,
-      review_priority TEXT,
-      source_refs_json TEXT NOT NULL,
-      redaction_class TEXT NOT NULL DEFAULT 'none',
-      payload_json TEXT,
-      lifecycle_status TEXT NOT NULL DEFAULT 'pending'
-    );
-    CREATE TABLE IF NOT EXISTS judgment_verdict (
-      id TEXT PRIMARY KEY,
-      created_at TEXT NOT NULL,
-      cycle_id TEXT NOT NULL,
-      perception_card_id TEXT NOT NULL,
-      action_kind TEXT NOT NULL,
-      confidence REAL,
-      reason TEXT,
-      risk_posture TEXT,
-      source_refs_json TEXT NOT NULL,
-      redaction_class TEXT NOT NULL DEFAULT 'none',
-      payload_json TEXT,
-      lifecycle_status TEXT NOT NULL DEFAULT 'pending'
-    );
-    CREATE TABLE IF NOT EXISTS action_closure_record (
-      id TEXT PRIMARY KEY,
-      created_at TEXT NOT NULL,
-      cycle_id TEXT NOT NULL,
-      proposal_id TEXT,
-      decision_id TEXT,
-      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'
-    );
-    CREATE TABLE IF NOT EXISTS quiet_daily_review (
-      id TEXT PRIMARY KEY,
-      created_at TEXT NOT NULL,
-      day TEXT NOT NULL,
-      closure_count INTEGER NOT NULL DEFAULT 0,
-      memory_candidate_count INTEGER NOT NULL DEFAULT 0,
-      source_refs_json TEXT NOT NULL,
-      redaction_class TEXT NOT NULL DEFAULT 'none',
-      payload_json TEXT,
-      lifecycle_status TEXT NOT NULL DEFAULT 'pending'
-    );
-    CREATE TABLE IF NOT EXISTS dream_consolidation_run (
-      id TEXT PRIMARY KEY,
-      created_at TEXT NOT NULL,
-      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'
-    );
-    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'
-    );
-    CREATE TABLE IF NOT EXISTS heartbeat_cycle_trace (
-      id TEXT PRIMARY KEY,
-      cycle_sequence INTEGER NOT NULL,
-      heartbeat_started_at TEXT NOT NULL,
-      heartbeat_completed_at TEXT,
-      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'
-    );
-    CREATE TABLE IF NOT EXISTS loop_stage_event (
-      id TEXT PRIMARY KEY,
-      cycle_id TEXT NOT NULL,
-      cycle_sequence INTEGER NOT NULL,
-      stage TEXT NOT NULL,
-      status TEXT NOT NULL,
-      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'
-    );
+    sql: `
+    CREATE TABLE IF NOT EXISTS evidence_item (
+      id TEXT PRIMARY KEY,
+      created_at TEXT NOT NULL,
+      platform_id TEXT NOT NULL,
+      content_hash TEXT NOT NULL,
+      observed_at TEXT NOT NULL,
+      sensitivity_hint TEXT,
+      source_refs_json TEXT NOT NULL,
+      redaction_class TEXT NOT NULL DEFAULT 'none',
+      payload_json TEXT,
+      lifecycle_status TEXT NOT NULL DEFAULT 'pending'
+    );
+    CREATE TABLE IF NOT EXISTS perception_card (
+      id TEXT PRIMARY KEY,
+      created_at TEXT NOT NULL,
+      cycle_id TEXT NOT NULL,
+      topic TEXT,
+      entities_json TEXT,
+      novelty TEXT,
+      relevance REAL,
+      summary TEXT,
+      risk_flags_json TEXT,
+      confidence REAL,
+      review_priority TEXT,
+      source_refs_json TEXT NOT NULL,
+      redaction_class TEXT NOT NULL DEFAULT 'none',
+      payload_json TEXT,
+      lifecycle_status TEXT NOT NULL DEFAULT 'pending'
+    );
+    CREATE TABLE IF NOT EXISTS judgment_verdict (
+      id TEXT PRIMARY KEY,
+      created_at TEXT NOT NULL,
+      cycle_id TEXT NOT NULL,
+      perception_card_id TEXT NOT NULL,
+      action_kind TEXT NOT NULL,
+      confidence REAL,
+      reason TEXT,
+      risk_posture TEXT,
+      source_refs_json TEXT NOT NULL,
+      redaction_class TEXT NOT NULL DEFAULT 'none',
+      payload_json TEXT,
+      lifecycle_status TEXT NOT NULL DEFAULT 'pending'
+    );
+    CREATE TABLE IF NOT EXISTS action_closure_record (
+      id TEXT PRIMARY KEY,
+      created_at TEXT NOT NULL,
+      cycle_id TEXT NOT NULL,
+      proposal_id TEXT,
+      decision_id TEXT,
+      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'
+    );
+    CREATE TABLE IF NOT EXISTS quiet_daily_review (
+      id TEXT PRIMARY KEY,
+      created_at TEXT NOT NULL,
+      day TEXT NOT NULL,
+      closure_count INTEGER NOT NULL DEFAULT 0,
+      memory_candidate_count INTEGER NOT NULL DEFAULT 0,
+      source_refs_json TEXT NOT NULL,
+      redaction_class TEXT NOT NULL DEFAULT 'none',
+      payload_json TEXT,
+      lifecycle_status TEXT NOT NULL DEFAULT 'pending'
+    );
+    CREATE TABLE IF NOT EXISTS dream_consolidation_run (
+      id TEXT PRIMARY KEY,
+      created_at TEXT NOT NULL,
+      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'
+    );
+    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'
+    );
+    CREATE TABLE IF NOT EXISTS heartbeat_cycle_trace (
+      id TEXT PRIMARY KEY,
+      cycle_sequence INTEGER NOT NULL,
+      heartbeat_started_at TEXT NOT NULL,
+      heartbeat_completed_at TEXT,
+      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'
+    );
+    CREATE TABLE IF NOT EXISTS loop_stage_event (
+      id TEXT PRIMARY KEY,
+      cycle_id TEXT NOT NULL,
+      cycle_sequence INTEGER NOT NULL,
+      stage TEXT NOT NULL,
+      status TEXT NOT NULL,
+      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'
+    );
   `,
 };

package/runtime/storage/db/migrations/v8-002-perception-contract-alignment.d.ts

@@ -0,0 +1,12 @@
+/**
+ * v8-002 Perception Contract Alignment — adds relevance_class to perception_card.
+ *
+ * Resolves T-PJ.R.1: PerceptionCard novelty/relevance contract drift.
+ * Adds relevance_class column so canonical shape (noveltyClass + relevanceScore + relevanceClass)
+ * can be persisted without overloading the existing relevance REAL field.
+ */
+export declare const V8_002_PERCEPTION_CONTRACT_ALIGNMENT: {
+    version: number;
+    label: string;
+    sql: string;
+};

package/runtime/storage/db/migrations/v8-002-perception-contract-alignment.js

@@ -0,0 +1,14 @@
+/**
+ * v8-002 Perception Contract Alignment — adds relevance_class to perception_card.
+ *
+ * Resolves T-PJ.R.1: PerceptionCard novelty/relevance contract drift.
+ * Adds relevance_class column so canonical shape (noveltyClass + relevanceScore + relevanceClass)
+ * can be persisted without overloading the existing relevance REAL field.
+ */
+export const V8_002_PERCEPTION_CONTRACT_ALIGNMENT = {
+    version: 6,
+    label: "v8-perception-contract-alignment",
+    sql: `
+    ALTER TABLE perception_card ADD COLUMN relevance_class TEXT;
+  `,
+};

package/runtime/storage/db/migrations/v8-003-quiet-closure-refs.d.ts

@@ -0,0 +1,10 @@
+/**
+ * v8-003 Quiet ClosureRefs — adds closure_refs_json to quiet_daily_review.
+ *
+ * Resolves T-DQ.R.4: QuietDailyReview closureRefs first-class.
+ */
+export declare const V8_003_QUIET_CLOSURE_REFS: {
+    version: number;
+    label: string;
+    sql: string;
+};

package/runtime/storage/db/migrations/v8-003-quiet-closure-refs.js

@@ -0,0 +1,12 @@
+/**
+ * v8-003 Quiet ClosureRefs — adds closure_refs_json to quiet_daily_review.
+ *
+ * Resolves T-DQ.R.4: QuietDailyReview closureRefs first-class.
+ */
+export const V8_003_QUIET_CLOSURE_REFS = {
+    version: 7,
+    label: "v8-quiet-closure-refs",
+    sql: `
+    ALTER TABLE quiet_daily_review ADD COLUMN closure_refs_json TEXT;
+  `,
+};