@haaaiawd/second-nature 0.2.1 → 0.2.4

package/runtime/storage/v8-state-stores.d.ts

@@ -22,7 +22,7 @@
  * Test coverage: tests/unit/storage/v8-state-stores.test.ts
  */
 import type { StateDatabase } from "./db/index.js";
-import { type EvidenceItemRecord, type NewEvidenceItemRecord, type PerceptionCardRecord, type NewPerceptionCardRecord, type JudgmentVerdictRecord, type NewJudgmentVerdictRecord, type ActionClosureRecordSelect, type ActionClosureRecordInsert, type QuietDailyReviewRecord, type NewQuietDailyReviewRecord, type DreamConsolidationRunRecord, type NewDreamConsolidationRunRecord, type LongTermMemoryProjectionRecord, type NewLongTermMemoryProjectionRecord, type HeartbeatCycleTraceRecord, type NewHeartbeatCycleTraceRecord, type LoopStageEventRecord, type NewLoopStageEventRecord } from "./db/schema/v8-entities.js";
+import { type EvidenceItemRecord, type NewEvidenceItemRecord, type PerceptionCardRecord, type NewPerceptionCardRecord, type JudgmentVerdictRecord, type NewJudgmentVerdictRecord, type ActionClosureRecordSelect, type ActionClosureRecordInsert, type QuietDailyReviewRecord, type NewQuietDailyReviewRecord, type DreamConsolidationRunRecord, type NewDreamConsolidationRunRecord, type LongTermMemoryProjectionRecord, type NewLongTermMemoryProjectionRecord, type HeartbeatCycleTraceRecord, type NewHeartbeatCycleTraceRecord, type LoopStageEventRecord, type NewLoopStageEventRecord, type ImpulseContextArtifactRecord, type NewImpulseContextArtifactRecord, type DailyRhythmStateRecord, type NewDailyRhythmStateRecord } from "./db/schema/v8-entities.js";
 import type { SourceRef, DegradedOperationResult } from "../shared/types/v8-contracts.js";
 export interface WriteValidationError {
     ok: false;
@@ -81,8 +81,9 @@ export declare function readActionClosuresByDay(db: StateDatabase, day: string):
     rows: ActionClosureRecordSelect[];
     degraded?: DegradedOperationResult;
 }>;
-export declare function writeQuietDailyReview(db: StateDatabase, row: Omit<NewQuietDailyReviewRecord, "sourceRefsJson"> & {
+export declare function writeQuietDailyReview(db: StateDatabase, row: Omit<NewQuietDailyReviewRecord, "sourceRefsJson" | "closureRefsJson"> & {
     sourceRefs: SourceRef[];
+    closureRefs?: SourceRef[];
 }): Promise<{
     id: string;
 } | DegradedOperationResult>;
@@ -112,6 +113,13 @@ export declare function writeLongTermMemoryProjection(db: StateDatabase, row: Om
 }): Promise<{
     id: string;
 } | DegradedOperationResult>;
+/**
+ * Update an existing projection's status — required for supersession lifecycle.
+ * Uses UPDATE instead of INSERT to avoid primary-key conflict.
+ */
+export declare function updateLongTermMemoryProjectionStatus(db: StateDatabase, id: string, status: LongTermMemoryProjectionRecord["status"], payloadJson?: string): Promise<{
+    id: string;
+} | DegradedOperationResult>;
 export declare function readMemoryProjectionsByStatus(db: StateDatabase, status: LongTermMemoryProjectionRecord["status"]): Promise<{
     rows: LongTermMemoryProjectionRecord[];
     degraded?: DegradedOperationResult;
@@ -120,6 +128,10 @@ export declare function readMemoryProjectionsByTopic(db: StateDatabase, topicKey
     rows: LongTermMemoryProjectionRecord[];
     degraded?: DegradedOperationResult;
 }>;
+export declare function readLongTermMemoryProjectionById(db: StateDatabase, id: string): Promise<{
+    row?: LongTermMemoryProjectionRecord;
+    degraded?: DegradedOperationResult;
+}>;
 export declare function writeHeartbeatCycleTrace(db: StateDatabase, row: Omit<NewHeartbeatCycleTraceRecord, "sourceRefsJson"> & {
     sourceRefs?: SourceRef[];
 }): Promise<{
@@ -142,6 +154,24 @@ export declare function readLoopStageEventsByStage(db: StateDatabase, stage: Loo
     rows: LoopStageEventRecord[];
     degraded?: DegradedOperationResult;
 }>;
+export declare function writeImpulseContextArtifact(db: StateDatabase, row: Omit<NewImpulseContextArtifactRecord, "sourceRefsJson"> & {
+    sourceRefs: SourceRef[];
+}): Promise<{
+    id: string;
+} | DegradedOperationResult>;
+export declare function readImpulseContextArtifact(db: StateDatabase, sceneType: string, capabilityIntent?: string, platformId?: string): Promise<{
+    row?: ImpulseContextArtifactRecord;
+    degraded?: DegradedOperationResult;
+}>;
+export declare function writeDailyRhythmState(db: StateDatabase, row: Omit<NewDailyRhythmStateRecord, "sourceRefsJson"> & {
+    sourceRefs: SourceRef[];
+}): Promise<{
+    id: string;
+} | DegradedOperationResult>;
+export declare function readDailyRhythmStateByDay(db: StateDatabase, day: string): Promise<{
+    row?: DailyRhythmStateRecord;
+    degraded?: DegradedOperationResult;
+}>;
 export declare function extractSourceRefs(row: {
     sourceRefsJson: string | null;
 }): SourceRef[];

package/runtime/storage/v8-state-stores.js

@@ -21,8 +21,8 @@
  *
  * Test coverage: tests/unit/storage/v8-state-stores.test.ts
  */
-import { eq, desc, like } from "drizzle-orm";
-import { evidenceItem, perceptionCard, judgmentVerdict, actionClosureRecord, quietDailyReview, dreamConsolidationRun, longTermMemoryProjection, heartbeatCycleTrace, loopStageEvent, } from "./db/schema/v8-entities.js";
+import { eq, and, desc, like, isNull } from "drizzle-orm";
+import { evidenceItem, perceptionCard, judgmentVerdict, actionClosureRecord, quietDailyReview, dreamConsolidationRun, longTermMemoryProjection, heartbeatCycleTrace, loopStageEvent, impulseContextArtifact, dailyRhythmState, } from "./db/schema/v8-entities.js";
 // ───────────────────────────────────────────────────────────────
 // Shared helpers
 // ───────────────────────────────────────────────────────────────
@@ -258,6 +258,7 @@ export async function writeQuietDailyReview(db, row) {
         const record = {
             ...row,
             sourceRefsJson: serializeSourceRefs(validated.record),
+            closureRefsJson: row.closureRefs ? serializeSourceRefs(row.closureRefs) : null,
         };
         await db.db.insert(quietDailyReview).values(record);
         return { id: row.id };
@@ -366,6 +367,23 @@ export async function writeLongTermMemoryProjection(db, row) {
         return makeDegraded("state_unreadable", "projection", "Retry projection write after DB recovery", validated.record);
     }
 }
+/**
+ * Update an existing projection's status — required for supersession lifecycle.
+ * Uses UPDATE instead of INSERT to avoid primary-key conflict.
+ */
+export async function updateLongTermMemoryProjectionStatus(db, id, status, payloadJson) {
+    try {
+        const updateData = { status, lifecycleStatus: status };
+        if (payloadJson !== undefined) {
+            updateData.payloadJson = payloadJson;
+        }
+        await db.db.update(longTermMemoryProjection).set(updateData).where(eq(longTermMemoryProjection.id, id));
+        return { id };
+    }
+    catch {
+        return makeDegraded("state_unreadable", "projection", `Retry projection status update for ${id} after DB recovery`);
+    }
+}
 export async function readMemoryProjectionsByStatus(db, status) {
     try {
         const rows = await db.db
@@ -398,6 +416,21 @@ export async function readMemoryProjectionsByTopic(db, topicKey) {
         };
     }
 }
+export async function readLongTermMemoryProjectionById(db, id) {
+    try {
+        const rows = await db.db
+            .select()
+            .from(longTermMemoryProjection)
+            .where(eq(longTermMemoryProjection.id, id))
+            .limit(1);
+        return { row: rows[0] };
+    }
+    catch {
+        return {
+            degraded: makeDegraded("state_unreadable", "projection", `Check state database connectivity for projection ${id}`),
+        };
+    }
+}
 // ───────────────────────────────────────────────────────────────
 // HeartbeatCycleTrace store
 // ───────────────────────────────────────────────────────────────
@@ -484,6 +517,92 @@ export async function readLoopStageEventsByStage(db, stage, limit = 100) {
     }
 }
 // ───────────────────────────────────────────────────────────────
+// ImpulseContextArtifact store
+// ───────────────────────────────────────────────────────────────
+export async function writeImpulseContextArtifact(db, row) {
+    const validated = validateSourceRefs(row.sourceRefs, "projection");
+    if (!validated.ok)
+        return validated.degraded;
+    try {
+        const record = {
+            ...row,
+            sourceRefsJson: serializeSourceRefs(validated.record),
+        };
+        // Upsert: delete existing then insert (SQLite primary-key conflict)
+        await db.db.delete(impulseContextArtifact).where(eq(impulseContextArtifact.id, row.id));
+        await db.db.insert(impulseContextArtifact).values(record);
+        return { id: row.id };
+    }
+    catch {
+        return makeDegraded("state_unreadable", "projection", "Retry impulse context write after DB recovery", validated.record);
+    }
+}
+export async function readImpulseContextArtifact(db, sceneType, capabilityIntent, platformId) {
+    try {
+        const conditions = [eq(impulseContextArtifact.sceneType, sceneType)];
+        if (capabilityIntent) {
+            conditions.push(eq(impulseContextArtifact.capabilityIntent, capabilityIntent));
+        }
+        else {
+            conditions.push(isNull(impulseContextArtifact.capabilityIntent));
+        }
+        if (platformId) {
+            conditions.push(eq(impulseContextArtifact.platformId, platformId));
+        }
+        else {
+            conditions.push(isNull(impulseContextArtifact.platformId));
+        }
+        const rows = await db.db
+            .select()
+            .from(impulseContextArtifact)
+            .where(and(...conditions))
+            .orderBy(desc(impulseContextArtifact.updatedAt))
+            .limit(1);
+        return { row: rows[0] };
+    }
+    catch {
+        return {
+            degraded: makeDegraded("state_unreadable", "projection", "Check state database connectivity"),
+        };
+    }
+}
+// ───────────────────────────────────────────────────────────────
+// DailyRhythmState store
+// ───────────────────────────────────────────────────────────────
+export async function writeDailyRhythmState(db, row) {
+    const validated = validateSourceRefs(row.sourceRefs, "dream");
+    if (!validated.ok)
+        return validated.degraded;
+    try {
+        const record = {
+            ...row,
+            sourceRefsJson: serializeSourceRefs(validated.record),
+        };
+        await db.db.delete(dailyRhythmState).where(eq(dailyRhythmState.id, row.id));
+        await db.db.insert(dailyRhythmState).values(record);
+        return { id: row.id };
+    }
+    catch {
+        return makeDegraded("state_unreadable", "dream", "Retry daily rhythm state write after DB recovery", validated.record);
+    }
+}
+export async function readDailyRhythmStateByDay(db, day) {
+    try {
+        const rows = await db.db
+            .select()
+            .from(dailyRhythmState)
+            .where(eq(dailyRhythmState.day, day))
+            .orderBy(desc(dailyRhythmState.updatedAt))
+            .limit(1);
+        return { row: rows[0] };
+    }
+    catch {
+        return {
+            degraded: makeDegraded("state_unreadable", "dream", `Check state database connectivity for day=${day}`),
+        };
+    }
+}
+// ───────────────────────────────────────────────────────────────
 // SourceRef round-trip helper (for tests and consumers)
 // ───────────────────────────────────────────────────────────────
 export function extractSourceRefs(row) {