@haaaiawd/second-nature 0.2.4 → 0.2.5

package/runtime/storage/db/schema/v8-entities.d.ts

@@ -816,6 +816,44 @@ export declare const actionClosureRecord: import("drizzle-orm/sqlite-core").SQLi
         }, {}, {
             length: number | undefined;
         }>;
+        platformId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "platform_id";
+            tableName: "action_closure_record";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        capabilityId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "capability_id";
+            tableName: "action_closure_record";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
         proposalId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "proposal_id";
             tableName: "action_closure_record";
@@ -2557,3 +2595,253 @@ export declare const dailyRhythmState: import("drizzle-orm/sqlite-core").SQLiteT
 }>;
 export type DailyRhythmStateRecord = typeof dailyRhythmState.$inferSelect;
 export type NewDailyRhythmStateRecord = typeof dailyRhythmState.$inferInsert;
+export declare const connectorCooldownState: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "connector_cooldown_state";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "connector_cooldown_state";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        platformId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "platform_id";
+            tableName: "connector_cooldown_state";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        capabilityId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "capability_id";
+            tableName: "connector_cooldown_state";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        failureClass: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "failure_class";
+            tableName: "connector_cooldown_state";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        retryAfterMs: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "retry_after_ms";
+            tableName: "connector_cooldown_state";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        blockedUntil: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "blocked_until";
+            tableName: "connector_cooldown_state";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        failureCount: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "failure_count";
+            tableName: "connector_cooldown_state";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        terminalCount: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "terminal_count";
+            tableName: "connector_cooldown_state";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        sourceRefsJson: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "source_refs_json";
+            tableName: "connector_cooldown_state";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        redactionClass: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "redaction_class";
+            tableName: "connector_cooldown_state";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        payloadJson: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "payload_json";
+            tableName: "connector_cooldown_state";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "connector_cooldown_state";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "updated_at";
+            tableName: "connector_cooldown_state";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+    };
+    dialect: "sqlite";
+}>;
+export type ConnectorCooldownStateRecord = typeof connectorCooldownState.$inferSelect;
+export type NewConnectorCooldownStateRecord = typeof connectorCooldownState.$inferInsert;

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
 // ───────────────────────────────────────────────────────────────
@@ -73,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(),
@@ -197,3 +199,23 @@ export const dailyRhythmState = sqliteTable("daily_rhythm_state", {
     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, type ImpulseContextArtifactRecord, type NewImpulseContextArtifactRecord, type DailyRhythmStateRecord, type NewDailyRhythmStateRecord } 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;
@@ -172,6 +172,15 @@ export declare function readDailyRhythmStateByDay(db: StateDatabase, day: string
     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

@@ -22,7 +22,7 @@
  * Test coverage: tests/unit/storage/v8-state-stores.test.ts
  */
 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";
+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,
@@ -602,6 +654,39 @@ export async function readDailyRhythmStateByDay(db, 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)
 // ───────────────────────────────────────────────────────────────