@haaaiawd/second-nature 0.2.2 → 0.2.5

package/runtime/storage/db/schema/v8-entities.js

@@ -12,7 +12,7 @@
  * Dependencies: drizzle-orm/sqlite-core
  * Boundary: Schema definitions only; no runtime logic.
  */
-import { sqliteTable, text, integer, real } from "drizzle-orm/sqlite-core";
+import { sqliteTable, text, integer, real, index } from "drizzle-orm/sqlite-core";
 // ───────────────────────────────────────────────────────────────
 // 1. EvidenceItem
 // ───────────────────────────────────────────────────────────────
@@ -39,6 +39,7 @@ export const perceptionCard = sqliteTable("perception_card", {
     entitiesJson: text("entities_json"),
     novelty: text("novelty"),
     relevance: real("relevance"),
+    relevanceClass: text("relevance_class"),
     summary: text("summary"),
     riskFlagsJson: text("risk_flags_json"),
     confidence: real("confidence"),
@@ -72,6 +73,8 @@ export const actionClosureRecord = sqliteTable("action_closure_record", {
     id: text("id").primaryKey(),
     createdAt: text("created_at").notNull(),
     cycleId: text("cycle_id").notNull(),
+    platformId: text("platform_id"),
+    capabilityId: text("capability_id"),
     proposalId: text("proposal_id"),
     decisionId: text("decision_id"),
     status: text("status").notNull(),
@@ -92,6 +95,7 @@ export const quietDailyReview = sqliteTable("quiet_daily_review", {
     closureCount: integer("closure_count").notNull().default(0),
     memoryCandidateCount: integer("memory_candidate_count").notNull().default(0),
     sourceRefsJson: text("source_refs_json").notNull(),
+    closureRefsJson: text("closure_refs_json"),
     redactionClass: text("redaction_class").notNull().default("none"),
     payloadJson: text("payload_json"),
     lifecycleStatus: text("lifecycle_status").notNull().default("pending"),
@@ -158,3 +162,60 @@ export const loopStageEvent = sqliteTable("loop_stage_event", {
     payloadJson: text("payload_json"),
     lifecycleStatus: text("lifecycle_status").notNull().default("started"),
 });
+// ───────────────────────────────────────────────────────────────
+// 10. ImpulseContextArtifact
+// ───────────────────────────────────────────────────────────────
+export const impulseContextArtifact = sqliteTable("impulse_context_artifact", {
+    id: text("id").primaryKey(),
+    createdAt: text("created_at").notNull(),
+    updatedAt: text("updated_at").notNull(),
+    sceneType: text("scene_type").notNull(),
+    capabilityIntent: text("capability_intent"),
+    platformId: text("platform_id"),
+    capabilityClass: text("capability_class"),
+    impulseSource: text("impulse_source").notNull(),
+    impulseText: text("impulse_text"),
+    atmosphereText: text("atmosphere_text"),
+    expressionBoundaryConstraintsJson: text("expression_boundary_constraints_json"),
+    expressionBoundaryStyle: text("expression_boundary_style"),
+    freshnessVersion: integer("freshness_version").notNull().default(1),
+    sourceRefsJson: text("source_refs_json").notNull(),
+    redactionClass: text("redaction_class").notNull().default("none"),
+    payloadJson: text("payload_json"),
+    lifecycleStatus: text("lifecycle_status").notNull().default("active"),
+});
+// 11. DailyRhythmState
+// ───────────────────────────────────────────────────────────────
+export const dailyRhythmState = sqliteTable("daily_rhythm_state", {
+    id: text("id").primaryKey(),
+    day: text("day").notNull(),
+    quietStatus: text("quiet_status").notNull().default("not_due"),
+    dreamStatus: text("dream_status").notNull().default("not_due"),
+    quietReason: text("quiet_reason"),
+    dreamReason: text("dream_reason"),
+    quietCompletedAt: text("quiet_completed_at"),
+    dreamCompletedAt: text("dream_completed_at"),
+    sourceRefsJson: text("source_refs_json").notNull(),
+    payloadJson: text("payload_json"),
+    updatedAt: text("updated_at").notNull(),
+});
+// ───────────────────────────────────────────────────────────────
+// 12. ConnectorCooldownState
+// ───────────────────────────────────────────────────────────────
+export const connectorCooldownState = sqliteTable("connector_cooldown_state", {
+    id: text("id").primaryKey(),
+    platformId: text("platform_id").notNull(),
+    capabilityId: text("capability_id").notNull(),
+    failureClass: text("failure_class").notNull(),
+    retryAfterMs: integer("retry_after_ms"),
+    blockedUntil: text("blocked_until").notNull(),
+    failureCount: integer("failure_count").notNull().default(1),
+    terminalCount: integer("terminal_count").notNull().default(0),
+    sourceRefsJson: text("source_refs_json").notNull(),
+    redactionClass: text("redaction_class").notNull().default("none"),
+    payloadJson: text("payload_json"),
+    createdAt: text("created_at").notNull(),
+    updatedAt: text("updated_at").notNull(),
+}, (table) => ({
+    platformCapabilityIdx: index("connector_cooldown_state_platform_capability_idx").on(table.platformId, table.capabilityId),
+}));

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, type ConnectorCooldownStateRecord, type NewConnectorCooldownStateRecord } 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,33 @@ 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 readConnectorCooldownState(db: StateDatabase, platformId: string, capabilityId: string): Promise<{
+    row?: ConnectorCooldownStateRecord;
+    degraded?: DegradedOperationResult;
+}>;
+export declare function writeConnectorCooldownState(db: StateDatabase, row: Omit<NewConnectorCooldownStateRecord, "sourceRefsJson"> & {
+    sourceRefs: SourceRef[];
+}): Promise<{
+    id: string;
+} | 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, connectorCooldownState, } from "./db/schema/v8-entities.js";
 // ───────────────────────────────────────────────────────────────
 // Shared helpers
 // ───────────────────────────────────────────────────────────────
@@ -99,10 +99,62 @@ export async function readEvidenceItemsByStatus(db, lifecycleStatus) {
 // ───────────────────────────────────────────────────────────────
 // PerceptionCard store
 // ───────────────────────────────────────────────────────────────
+const CANONICAL_NOVELTY_CLASSES = ["new", "changed", "duplicate", "stale"];
+const CANONICAL_RELEVANCE_CLASSES = ["low", "medium", "high"];
+function validatePerceptionCardCanonical(row) {
+    // Validate noveltyClass
+    if (row.novelty && !CANONICAL_NOVELTY_CLASSES.includes(row.novelty)) {
+        return {
+            ok: false,
+            degraded: {
+                status: "degraded",
+                reason: "perception_contract_drift",
+                ownerStage: "perception",
+                sourceRefs: row.sourceRefs,
+                operatorNextAction: `novelty "${row.novelty}" is not canonical. Expected one of: ${CANONICAL_NOVELTY_CLASSES.join(", ")}`,
+                retryable: false,
+            },
+        };
+    }
+    // Validate relevanceScore range
+    if (row.relevance !== undefined && row.relevance !== null) {
+        if (row.relevance < 0 || row.relevance > 1) {
+            return {
+                ok: false,
+                degraded: {
+                    status: "degraded",
+                    reason: "perception_contract_drift",
+                    ownerStage: "perception",
+                    sourceRefs: row.sourceRefs,
+                    operatorNextAction: `relevanceScore ${row.relevance} out of range [0, 1]`,
+                    retryable: false,
+                },
+            };
+        }
+    }
+    // Validate relevanceClass
+    if (row.relevanceClass && !CANONICAL_RELEVANCE_CLASSES.includes(row.relevanceClass)) {
+        return {
+            ok: false,
+            degraded: {
+                status: "degraded",
+                reason: "perception_contract_drift",
+                ownerStage: "perception",
+                sourceRefs: row.sourceRefs,
+                operatorNextAction: `relevanceClass "${row.relevanceClass}" is not canonical. Expected one of: ${CANONICAL_RELEVANCE_CLASSES.join(", ")}`,
+                retryable: false,
+            },
+        };
+    }
+    return { ok: true };
+}
 export async function writePerceptionCard(db, row) {
     const validated = validateSourceRefs(row.sourceRefs, "perception");
     if (!validated.ok)
         return validated.degraded;
+    const canonicalCheck = validatePerceptionCardCanonical(row);
+    if (!canonicalCheck.ok)
+        return canonicalCheck.degraded;
     try {
         const record = {
             ...row,
@@ -258,6 +310,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 +419,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 +468,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 +569,125 @@ 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}`),
+        };
+    }
+}
+export async function readConnectorCooldownState(db, platformId, capabilityId) {
+    try {
+        const rows = await db.db
+            .select()
+            .from(connectorCooldownState)
+            .where(and(eq(connectorCooldownState.platformId, platformId), eq(connectorCooldownState.capabilityId, capabilityId)))
+            .orderBy(desc(connectorCooldownState.updatedAt))
+            .limit(1);
+        return { row: rows[0] };
+    }
+    catch {
+        return {
+            degraded: makeDegraded("state_unreadable", "ingestion", `Check state database connectivity for cooldown ${platformId}:${capabilityId}`),
+        };
+    }
+}
+export async function writeConnectorCooldownState(db, row) {
+    const validated = validateSourceRefs(row.sourceRefs, "ingestion");
+    if (!validated.ok)
+        return validated.degraded;
+    try {
+        const record = {
+            ...row,
+            sourceRefsJson: serializeSourceRefs(validated.record),
+        };
+        await db.db.delete(connectorCooldownState).where(eq(connectorCooldownState.id, row.id));
+        await db.db.insert(connectorCooldownState).values(record);
+        return { id: row.id };
+    }
+    catch {
+        return makeDegraded("state_unreadable", "ingestion", "Retry connector cooldown state write after DB recovery", validated.record);
+    }
+}
+// ───────────────────────────────────────────────────────────────
 // SourceRef round-trip helper (for tests and consumers)
 // ───────────────────────────────────────────────────────────────
 export function extractSourceRefs(row) {