@haaaiawd/second-nature 0.1.51 → 0.2.0

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

@@ -0,0 +1,160 @@
+/**
+ * v8 Living Perception Loop entity schemas.
+ *
+ * Core logic: Persist EvidenceItem, PerceptionCard, JudgmentVerdict,
+ * ActionClosureRecord, QuietDailyReview, DreamConsolidationRun,
+ * LongTermMemoryProjection, HeartbeatCycleTrace, and LoopStageEvent.
+ *
+ * Design authority:
+ * - `.anws/v8/04_SYSTEM_DESIGN/state-memory-system.md`
+ * - `.anws/v8/04_SYSTEM_DESIGN/shared-v8-contracts.md`
+ *
+ * Dependencies: drizzle-orm/sqlite-core
+ * Boundary: Schema definitions only; no runtime logic.
+ */
+import { sqliteTable, text, integer, real } from "drizzle-orm/sqlite-core";
+// ───────────────────────────────────────────────────────────────
+// 1. EvidenceItem
+// ───────────────────────────────────────────────────────────────
+export const evidenceItem = sqliteTable("evidence_item", {
+    id: text("id").primaryKey(),
+    createdAt: text("created_at").notNull(),
+    platformId: text("platform_id").notNull(),
+    contentHash: text("content_hash").notNull(),
+    observedAt: text("observed_at").notNull(),
+    sensitivityHint: text("sensitivity_hint"),
+    sourceRefsJson: text("source_refs_json").notNull(),
+    redactionClass: text("redaction_class").notNull().default("none"),
+    payloadJson: text("payload_json"),
+    lifecycleStatus: text("lifecycle_status").notNull().default("pending"),
+});
+// ───────────────────────────────────────────────────────────────
+// 2. PerceptionCard
+// ───────────────────────────────────────────────────────────────
+export const perceptionCard = sqliteTable("perception_card", {
+    id: text("id").primaryKey(),
+    createdAt: text("created_at").notNull(),
+    cycleId: text("cycle_id").notNull(),
+    topic: text("topic"),
+    entitiesJson: text("entities_json"),
+    novelty: text("novelty"),
+    relevance: real("relevance"),
+    summary: text("summary"),
+    riskFlagsJson: text("risk_flags_json"),
+    confidence: real("confidence"),
+    reviewPriority: text("review_priority"),
+    sourceRefsJson: text("source_refs_json").notNull(),
+    redactionClass: text("redaction_class").notNull().default("none"),
+    payloadJson: text("payload_json"),
+    lifecycleStatus: text("lifecycle_status").notNull().default("pending"),
+});
+// ───────────────────────────────────────────────────────────────
+// 3. JudgmentVerdict
+// ───────────────────────────────────────────────────────────────
+export const judgmentVerdict = sqliteTable("judgment_verdict", {
+    id: text("id").primaryKey(),
+    createdAt: text("created_at").notNull(),
+    cycleId: text("cycle_id").notNull(),
+    perceptionCardId: text("perception_card_id").notNull(),
+    actionKind: text("action_kind").notNull(),
+    confidence: real("confidence"),
+    reason: text("reason"),
+    riskPosture: text("risk_posture"),
+    sourceRefsJson: text("source_refs_json").notNull(),
+    redactionClass: text("redaction_class").notNull().default("none"),
+    payloadJson: text("payload_json"),
+    lifecycleStatus: text("lifecycle_status").notNull().default("pending"),
+});
+// ───────────────────────────────────────────────────────────────
+// 4. ActionClosureRecord
+// ───────────────────────────────────────────────────────────────
+export const actionClosureRecord = sqliteTable("action_closure_record", {
+    id: text("id").primaryKey(),
+    createdAt: text("created_at").notNull(),
+    cycleId: text("cycle_id").notNull(),
+    proposalId: text("proposal_id"),
+    decisionId: text("decision_id"),
+    status: text("status").notNull(),
+    reason: text("reason"),
+    nextState: text("next_state"),
+    sourceRefsJson: text("source_refs_json").notNull(),
+    redactionClass: text("redaction_class").notNull().default("none"),
+    payloadJson: text("payload_json"),
+    lifecycleStatus: text("lifecycle_status").notNull().default("closed"),
+});
+// ───────────────────────────────────────────────────────────────
+// 5. QuietDailyReview
+// ───────────────────────────────────────────────────────────────
+export const quietDailyReview = sqliteTable("quiet_daily_review", {
+    id: text("id").primaryKey(),
+    createdAt: text("created_at").notNull(),
+    day: text("day").notNull(),
+    closureCount: integer("closure_count").notNull().default(0),
+    memoryCandidateCount: integer("memory_candidate_count").notNull().default(0),
+    sourceRefsJson: text("source_refs_json").notNull(),
+    redactionClass: text("redaction_class").notNull().default("none"),
+    payloadJson: text("payload_json"),
+    lifecycleStatus: text("lifecycle_status").notNull().default("pending"),
+});
+// ───────────────────────────────────────────────────────────────
+// 6. DreamConsolidationRun
+// ───────────────────────────────────────────────────────────────
+export const dreamConsolidationRun = sqliteTable("dream_consolidation_run", {
+    id: text("id").primaryKey(),
+    createdAt: text("created_at").notNull(),
+    quietReviewId: text("quiet_review_id").notNull(),
+    status: text("status").notNull(),
+    reason: text("reason"),
+    sourceRefsJson: text("source_refs_json").notNull(),
+    redactionClass: text("redaction_class").notNull().default("none"),
+    payloadJson: text("payload_json"),
+    lifecycleStatus: text("lifecycle_status").notNull().default("pending"),
+});
+// ───────────────────────────────────────────────────────────────
+// 7. LongTermMemoryProjection
+// ───────────────────────────────────────────────────────────────
+export const longTermMemoryProjection = sqliteTable("long_term_memory_projection", {
+    id: text("id").primaryKey(),
+    createdAt: text("created_at").notNull(),
+    candidateId: text("candidate_id").notNull(),
+    topicKey: text("topic_key").notNull(),
+    status: text("status").notNull().default("candidate"),
+    sourceRefsJson: text("source_refs_json").notNull(),
+    redactionClass: text("redaction_class").notNull().default("none"),
+    payloadJson: text("payload_json"),
+    lifecycleStatus: text("lifecycle_status").notNull().default("candidate"),
+});
+// ───────────────────────────────────────────────────────────────
+// 8. HeartbeatCycleTrace
+// ───────────────────────────────────────────────────────────────
+export const heartbeatCycleTrace = sqliteTable("heartbeat_cycle_trace", {
+    id: text("id").primaryKey(),
+    cycleSequence: integer("cycle_sequence").notNull(),
+    heartbeatStartedAt: text("heartbeat_started_at").notNull(),
+    heartbeatCompletedAt: text("heartbeat_completed_at"),
+    inputCount: integer("input_count").notNull().default(0),
+    outputCount: integer("output_count").notNull().default(0),
+    expectedDownstreamByCycle: integer("expected_downstream_by_cycle"),
+    status: text("status").notNull(),
+    sourceRefsJson: text("source_refs_json"),
+    redactionClass: text("redaction_class").notNull().default("none"),
+    payloadJson: text("payload_json"),
+    lifecycleStatus: text("lifecycle_status").notNull().default("started"),
+});
+// ───────────────────────────────────────────────────────────────
+// 9. LoopStageEvent
+// ───────────────────────────────────────────────────────────────
+export const loopStageEvent = sqliteTable("loop_stage_event", {
+    id: text("id").primaryKey(),
+    cycleId: text("cycle_id").notNull(),
+    cycleSequence: integer("cycle_sequence").notNull(),
+    stage: text("stage").notNull(),
+    status: text("status").notNull(),
+    reason: text("reason"),
+    sourceRefsJson: text("source_refs_json").notNull(),
+    redactionClass: text("redaction_class").notNull().default("none"),
+    occurredAt: text("occurred_at").notNull(),
+    expectedDownstreamByCycle: integer("expected_downstream_by_cycle"),
+    payloadJson: text("payload_json"),
+    lifecycleStatus: text("lifecycle_status").notNull().default("started"),
+});

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

@@ -0,0 +1,147 @@
+/**
+ * v8 State Stores — Bounded write/read ports for Living Perception Loop entities.
+ *
+ * Core logic: Persist and retrieve EvidenceItem, PerceptionCard, JudgmentVerdict,
+ * ActionClosureRecord, QuietDailyReview, DreamConsolidationRun,
+ * LongTermMemoryProjection, HeartbeatCycleTrace, and LoopStageEvent.
+ *
+ * Design authority:
+ * - `.anws/v8/04_SYSTEM_DESIGN/state-memory-system.md`
+ * - `.anws/v8/04_SYSTEM_DESIGN/shared-v8-contracts.md`
+ *
+ * Dependencies:
+ * - drizzle-orm (SQLite)
+ * - `src/storage/db/schema/v8-entities.js`
+ * - `src/shared/types/v8-contracts.js` (SourceRef, DegradedOperationResult)
+ *
+ * Boundary:
+ * - Write validation: rejects missing source refs, checks redaction class.
+ * - Read models: bounded by family + status filters; no cross-family joins.
+ * - Degraded state: returns DegradedOperationResult on DB failure, never throws.
+ *
+ * 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 { SourceRef, DegradedOperationResult } from "../shared/types/v8-contracts.js";
+export interface WriteValidationError {
+    ok: false;
+    degraded: DegradedOperationResult;
+}
+export interface WriteValidationOk<T> {
+    ok: true;
+    record: T;
+}
+export type WriteValidationResult<T> = WriteValidationOk<T> | WriteValidationError;
+export declare function writeEvidenceItem(db: StateDatabase, row: Omit<NewEvidenceItemRecord, "sourceRefsJson"> & {
+    sourceRefs: SourceRef[];
+}): Promise<{
+    id: string;
+} | DegradedOperationResult>;
+export declare function readEvidenceItemsByStatus(db: StateDatabase, lifecycleStatus: EvidenceItemRecord["lifecycleStatus"]): Promise<{
+    rows: EvidenceItemRecord[];
+    degraded?: DegradedOperationResult;
+}>;
+export declare function writePerceptionCard(db: StateDatabase, row: Omit<NewPerceptionCardRecord, "sourceRefsJson"> & {
+    sourceRefs: SourceRef[];
+}): Promise<{
+    id: string;
+} | DegradedOperationResult>;
+export declare function readPerceptionCardsByCycle(db: StateDatabase, cycleId: string): Promise<{
+    rows: PerceptionCardRecord[];
+    degraded?: DegradedOperationResult;
+}>;
+export declare function readPerceptionCardById(db: StateDatabase, id: string): Promise<{
+    row?: PerceptionCardRecord;
+    degraded?: DegradedOperationResult;
+}>;
+export declare function writeJudgmentVerdict(db: StateDatabase, row: Omit<NewJudgmentVerdictRecord, "sourceRefsJson"> & {
+    sourceRefs: SourceRef[];
+}): Promise<{
+    id: string;
+} | DegradedOperationResult>;
+export declare function readJudgmentVerdictsByCycle(db: StateDatabase, cycleId: string): Promise<{
+    rows: JudgmentVerdictRecord[];
+    degraded?: DegradedOperationResult;
+}>;
+export declare function readJudgmentVerdictById(db: StateDatabase, id: string): Promise<{
+    row?: JudgmentVerdictRecord;
+    degraded?: DegradedOperationResult;
+}>;
+export declare function writeActionClosureRecord(db: StateDatabase, row: Omit<ActionClosureRecordInsert, "sourceRefsJson"> & {
+    sourceRefs: SourceRef[];
+}): Promise<{
+    id: string;
+} | DegradedOperationResult>;
+export declare function readActionClosuresByCycle(db: StateDatabase, cycleId: string): Promise<{
+    rows: ActionClosureRecordSelect[];
+    degraded?: DegradedOperationResult;
+}>;
+export declare function readActionClosuresByDay(db: StateDatabase, day: string): Promise<{
+    rows: ActionClosureRecordSelect[];
+    degraded?: DegradedOperationResult;
+}>;
+export declare function writeQuietDailyReview(db: StateDatabase, row: Omit<NewQuietDailyReviewRecord, "sourceRefsJson"> & {
+    sourceRefs: SourceRef[];
+}): Promise<{
+    id: string;
+} | DegradedOperationResult>;
+export declare function readQuietDailyReviewById(db: StateDatabase, id: string): Promise<{
+    row?: QuietDailyReviewRecord;
+    degraded?: DegradedOperationResult;
+}>;
+export declare function readQuietDailyReviewsByDay(db: StateDatabase, day: string): Promise<{
+    rows: QuietDailyReviewRecord[];
+    degraded?: DegradedOperationResult;
+}>;
+export declare function writeDreamConsolidationRun(db: StateDatabase, row: Omit<NewDreamConsolidationRunRecord, "sourceRefsJson"> & {
+    sourceRefs: SourceRef[];
+}): Promise<{
+    id: string;
+} | DegradedOperationResult>;
+export declare function readDreamConsolidationRunById(db: StateDatabase, id: string): Promise<{
+    row?: DreamConsolidationRunRecord;
+    degraded?: DegradedOperationResult;
+}>;
+export declare function readDreamConsolidationRunsByQuietId(db: StateDatabase, quietReviewId: string): Promise<{
+    rows: DreamConsolidationRunRecord[];
+    degraded?: DegradedOperationResult;
+}>;
+export declare function writeLongTermMemoryProjection(db: StateDatabase, row: Omit<NewLongTermMemoryProjectionRecord, "sourceRefsJson"> & {
+    sourceRefs: SourceRef[];
+}): Promise<{
+    id: string;
+} | DegradedOperationResult>;
+export declare function readMemoryProjectionsByStatus(db: StateDatabase, status: LongTermMemoryProjectionRecord["status"]): Promise<{
+    rows: LongTermMemoryProjectionRecord[];
+    degraded?: DegradedOperationResult;
+}>;
+export declare function readMemoryProjectionsByTopic(db: StateDatabase, topicKey: string): Promise<{
+    rows: LongTermMemoryProjectionRecord[];
+    degraded?: DegradedOperationResult;
+}>;
+export declare function writeHeartbeatCycleTrace(db: StateDatabase, row: Omit<NewHeartbeatCycleTraceRecord, "sourceRefsJson"> & {
+    sourceRefs?: SourceRef[];
+}): Promise<{
+    id: string;
+} | DegradedOperationResult>;
+export declare function readHeartbeatCycleTraces(db: StateDatabase, limit?: number): Promise<{
+    rows: HeartbeatCycleTraceRecord[];
+    degraded?: DegradedOperationResult;
+}>;
+export declare function writeLoopStageEvent(db: StateDatabase, row: Omit<NewLoopStageEventRecord, "sourceRefsJson"> & {
+    sourceRefs: SourceRef[];
+}): Promise<{
+    id: string;
+} | DegradedOperationResult>;
+export declare function readLoopStageEventsByCycle(db: StateDatabase, cycleId: string): Promise<{
+    rows: LoopStageEventRecord[];
+    degraded?: DegradedOperationResult;
+}>;
+export declare function readLoopStageEventsByStage(db: StateDatabase, stage: LoopStageEventRecord["stage"], limit?: number): Promise<{
+    rows: LoopStageEventRecord[];
+    degraded?: DegradedOperationResult;
+}>;
+export declare function extractSourceRefs(row: {
+    sourceRefsJson: string | null;
+}): SourceRef[];