@haaaiawd/second-nature 0.1.8 → 0.1.10

package/runtime/storage/db/schema/operator-fallback-artifacts.d.ts

@@ -0,0 +1,161 @@
+export declare const operatorFallbackArtifacts: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "operator_fallback_artifacts";
+    schema: undefined;
+    columns: {
+        fallbackRef: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "fallback_ref";
+            tableName: "operator_fallback_artifacts";
+            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;
+        }>;
+        decisionId: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "decision_id";
+            tableName: "operator_fallback_artifacts";
+            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;
+        }>;
+        status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "status";
+            tableName: "operator_fallback_artifacts";
+            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;
+        }>;
+        reason: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "reason";
+            tableName: "operator_fallback_artifacts";
+            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;
+        }>;
+        sourceRefsJson: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "source_refs_json";
+            tableName: "operator_fallback_artifacts";
+            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;
+        }>;
+        candidateMessage: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "candidate_message";
+            tableName: "operator_fallback_artifacts";
+            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;
+        }>;
+        nextStep: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "next_step";
+            tableName: "operator_fallback_artifacts";
+            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;
+        }>;
+        createdAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "created_at";
+            tableName: "operator_fallback_artifacts";
+            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 OperatorFallbackRow = typeof operatorFallbackArtifacts.$inferSelect;
+export type NewOperatorFallbackRow = typeof operatorFallbackArtifacts.$inferInsert;

package/runtime/storage/db/schema/operator-fallback-artifacts.js

@@ -0,0 +1,11 @@
+import { index, sqliteTable, text } from "drizzle-orm/sqlite-core";
+export const operatorFallbackArtifacts = sqliteTable("operator_fallback_artifacts", {
+    fallbackRef: text("fallback_ref").primaryKey(),
+    decisionId: text("decision_id").notNull(),
+    status: text("status").notNull(),
+    reason: text("reason").notNull(),
+    sourceRefsJson: text("source_refs_json").notNull(),
+    candidateMessage: text("candidate_message"),
+    nextStep: text("next_step").notNull(),
+    createdAt: text("created_at").notNull(),
+}, (table) => [index("operator_fallback_decision_idx").on(table.decisionId)]);

package/runtime/storage/db/schema/policies.d.ts

@@ -55,6 +55,23 @@ export declare const policyRecords: import("drizzle-orm/sqlite-core").SQLiteTabl
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        outreachDailyBudget: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "outreach_daily_budget";
+            tableName: "policy_records";
+            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;
+        }, {}, {}>;
         updatedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
             name: "updated_at";
             tableName: "policy_records";

package/runtime/storage/db/schema/policies.js

@@ -3,5 +3,6 @@ export const policyRecords = sqliteTable("policy_records", {
     platformId: text("platform_id").primaryKey(),
     socialDailyLimit: integer("social_daily_limit").notNull(),
     quietEnabled: integer("quiet_enabled", { mode: "boolean" }).notNull(),
+    outreachDailyBudget: integer("outreach_daily_budget").notNull().default(2),
     updatedAt: text("updated_at").notNull(),
 });

package/runtime/storage/delivery/query-delivery-attempts.d.ts

@@ -0,0 +1,3 @@
+import type { StateDatabase } from "../db/index.js";
+import type { DeliveryAttemptRecord } from "./types.js";
+export declare function listDeliveryAttemptsByDecisionId(state: StateDatabase, decisionId: string): Promise<DeliveryAttemptRecord[]>;

package/runtime/storage/delivery/query-delivery-attempts.js

@@ -0,0 +1,32 @@
+/**
+ * Read models for delivery attempts by decisionId (T4.3.1).
+ */
+import { eq } from "drizzle-orm";
+import { deliveryAttempts } from "../db/schema/delivery-attempts.js";
+function rowToRecord(row) {
+    let hostProofRef;
+    if (row.hostProofRefJson) {
+        try {
+            hostProofRef = JSON.parse(row.hostProofRefJson);
+        }
+        catch {
+            hostProofRef = undefined;
+        }
+    }
+    return {
+        attemptId: row.attemptId,
+        decisionId: row.decisionId,
+        target: row.target ?? undefined,
+        channel: row.channel ?? undefined,
+        status: row.status,
+        messageId: row.messageId ?? undefined,
+        hostProofRef,
+        errorClass: row.errorClass ?? undefined,
+        fallbackRef: row.fallbackRef ?? undefined,
+        createdAt: row.createdAt,
+    };
+}
+export async function listDeliveryAttemptsByDecisionId(state, decisionId) {
+    const rows = await state.db.select().from(deliveryAttempts).where(eq(deliveryAttempts.decisionId, decisionId));
+    return rows.map(rowToRecord);
+}

package/runtime/storage/delivery/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Delivery attempt persistence (state-system v5 / T4.3.1).
+ *
+ * Boundaries: validates proof fields before index write; hostProofRef uses SourceRef JSON.
+ * Test coverage: tests/unit/storage/delivery-attempt.test.ts
+ */
+import type { SourceRef } from "../life-evidence/types.js";
+export type DeliveryAttemptStatus = "sent" | "failed" | "dropped_by_host_policy";
+export interface DeliveryAttemptWrite {
+    attemptId: string;
+    decisionId: string;
+    target?: "none" | "last" | "explicit";
+    channel?: string;
+    status: DeliveryAttemptStatus;
+    messageId?: string;
+    hostProofRef?: SourceRef;
+    errorClass?: string;
+    fallbackRef?: string;
+}
+export interface DeliveryAttemptRecord extends DeliveryAttemptWrite {
+    createdAt: string;
+}
+export interface DeliveryAttemptAck {
+    attemptId: string;
+    status: DeliveryAttemptStatus;
+    fallbackRef?: string;
+}

package/runtime/storage/delivery/types.js

@@ -0,0 +1 @@
+export {};

package/runtime/storage/delivery/write-delivery-attempt.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Persists delivery attempts with state-system validation (T4.3.1).
+ */
+import type { StateDatabase } from "../db/index.js";
+import type { DeliveryAttemptAck, DeliveryAttemptWrite } from "./types.js";
+export declare function writeDeliveryAttempt(state: StateDatabase, attempt: DeliveryAttemptWrite): Promise<DeliveryAttemptAck>;

package/runtime/storage/delivery/write-delivery-attempt.js

@@ -0,0 +1,36 @@
+import { deliveryAttempts } from "../db/schema/delivery-attempts.js";
+function assertDeliveryAttemptValid(attempt) {
+    if (attempt.status === "sent") {
+        const hasProof = Boolean(attempt.messageId?.trim()) || Boolean(attempt.hostProofRef);
+        if (!hasProof) {
+            throw new Error("delivery_attempt_sent_requires_message_id_or_host_proof_ref");
+        }
+    }
+    if (attempt.status === "failed" || attempt.status === "dropped_by_host_policy") {
+        const hasDiag = Boolean(attempt.errorClass?.trim()) || Boolean(attempt.fallbackRef?.trim());
+        if (!hasDiag) {
+            throw new Error("delivery_attempt_failed_requires_error_class_or_fallback_ref");
+        }
+    }
+}
+export async function writeDeliveryAttempt(state, attempt) {
+    assertDeliveryAttemptValid(attempt);
+    const createdAt = new Date().toISOString();
+    await state.db.insert(deliveryAttempts).values({
+        attemptId: attempt.attemptId,
+        decisionId: attempt.decisionId,
+        target: attempt.target ?? null,
+        channel: attempt.channel ?? null,
+        status: attempt.status,
+        messageId: attempt.messageId ?? null,
+        hostProofRefJson: attempt.hostProofRef ? JSON.stringify(attempt.hostProofRef) : null,
+        errorClass: attempt.errorClass ?? null,
+        fallbackRef: attempt.fallbackRef ?? null,
+        createdAt,
+    });
+    return {
+        attemptId: attempt.attemptId,
+        status: attempt.status,
+        fallbackRef: attempt.fallbackRef,
+    };
+}

package/runtime/storage/fallback/load-operator-fallback.d.ts

@@ -0,0 +1,14 @@
+import type { StateDatabase } from "../db/index.js";
+import type { SourceRef } from "../life-evidence/types.js";
+import type { OperatorFallbackView } from "./operator-fallback-view.js";
+export declare function normalizeFallbackRef(ref: string): string;
+/** Loads persisted operator fallback row; does not coerce status (use `toOperatorFallbackView`). */
+export declare function loadOperatorFallbackRow(state: StateDatabase, fallbackRef: string): Promise<{
+    fallbackRef: string;
+    reason: string;
+    status: string;
+    sourceRefs: SourceRef[];
+    candidateMessage?: string;
+    nextStep: string;
+} | null>;
+export declare function toOperatorFallbackView(row: NonNullable<Awaited<ReturnType<typeof loadOperatorFallbackRow>>>): OperatorFallbackView;

package/runtime/storage/fallback/load-operator-fallback.js

@@ -0,0 +1,47 @@
+import { eq } from "drizzle-orm";
+import { operatorFallbackArtifacts } from "../db/schema/operator-fallback-artifacts.js";
+const REASONS = new Set(["target_none", "channel_missing", "host_unsupported", "delivery_failed"]);
+export function normalizeFallbackRef(ref) {
+    const t = ref.trim();
+    if (!t)
+        return t;
+    return t.startsWith("fallback:") ? t : `fallback:${t}`;
+}
+function parseSourceRefs(json) {
+    try {
+        const parsed = JSON.parse(json);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+/** Loads persisted operator fallback row; does not coerce status (use `toOperatorFallbackView`). */
+export async function loadOperatorFallbackRow(state, fallbackRef) {
+    const key = normalizeFallbackRef(fallbackRef);
+    if (!key)
+        return null;
+    const rows = await state.db.select().from(operatorFallbackArtifacts).where(eq(operatorFallbackArtifacts.fallbackRef, key)).limit(1);
+    const row = rows[0];
+    if (!row)
+        return null;
+    return {
+        fallbackRef: row.fallbackRef,
+        reason: row.reason,
+        status: row.status,
+        sourceRefs: parseSourceRefs(row.sourceRefsJson),
+        candidateMessage: row.candidateMessage ?? undefined,
+        nextStep: row.nextStep,
+    };
+}
+export function toOperatorFallbackView(row) {
+    const reason = REASONS.has(row.reason) ? row.reason : row.reason;
+    return {
+        fallbackRef: row.fallbackRef,
+        reason,
+        status: "not_sent",
+        sourceRefs: row.sourceRefs,
+        candidateMessage: row.candidateMessage,
+        nextStep: row.nextStep,
+    };
+}

package/runtime/storage/fallback/operator-fallback-types.d.ts

@@ -0,0 +1,9 @@
+import type { SourceRef } from "../life-evidence/types.js";
+export type OperatorFallbackReason = "target_none" | "channel_missing" | "host_unsupported" | "delivery_failed";
+export interface OperatorFallbackWrite {
+    reason: OperatorFallbackReason;
+    decisionId: string;
+    sourceRefs: SourceRef[];
+    candidateMessage?: string;
+    nextStep: string;
+}

package/runtime/storage/fallback/operator-fallback-types.js

@@ -0,0 +1 @@
+export {};

package/runtime/storage/fallback/operator-fallback-view.d.ts

@@ -0,0 +1,11 @@
+import type { SourceRef } from "../life-evidence/types.js";
+import type { OperatorFallbackReason } from "./operator-fallback-types.js";
+/** Operator-facing delivery fallback (T1.2.2 / cli-system v5). Status is always not_sent — never sent/delivered. */
+export interface OperatorFallbackView {
+    fallbackRef: string;
+    reason: OperatorFallbackReason | string;
+    status: "not_sent";
+    sourceRefs: SourceRef[];
+    candidateMessage?: string;
+    nextStep: string;
+}

package/runtime/storage/fallback/operator-fallback-view.js

@@ -0,0 +1 @@
+export {};

package/runtime/storage/fallback/write-operator-fallback.d.ts

@@ -0,0 +1,6 @@
+import type { StateDatabase } from "../db/index.js";
+import type { OperatorFallbackWrite } from "./operator-fallback-types.js";
+export interface OperatorFallbackAck {
+    fallbackRef: string;
+}
+export declare function writeOperatorFallback(state: StateDatabase, input: OperatorFallbackWrite): Promise<OperatorFallbackAck>;

package/runtime/storage/fallback/write-operator-fallback.js

@@ -0,0 +1,21 @@
+/**
+ * Persists operator-visible delivery fallback artifacts (T2.3.2 / state-system v5).
+ * status is always not_sent per ADR-007.
+ */
+import * as crypto from "node:crypto";
+import { operatorFallbackArtifacts } from "../db/schema/operator-fallback-artifacts.js";
+export async function writeOperatorFallback(state, input) {
+    const fallbackRef = `fallback:${crypto.randomUUID()}`;
+    const createdAt = new Date().toISOString();
+    await state.db.insert(operatorFallbackArtifacts).values({
+        fallbackRef,
+        decisionId: input.decisionId,
+        status: "not_sent",
+        reason: input.reason,
+        sourceRefsJson: JSON.stringify(input.sourceRefs),
+        candidateMessage: input.candidateMessage ?? null,
+        nextStep: input.nextStep,
+        createdAt,
+    });
+    return { fallbackRef };
+}

package/runtime/storage/index.d.ts

@@ -13,4 +13,25 @@ export { createGovernanceLayer, type GovernanceLayer, type AnchorWriteProposal,
 export { createProvenanceService, type ProvenanceService, type ProvenanceTrace, type ProvenanceDetail } from "./services/provenance-service.js";
 export { createRepairAndBackupService, type RepairAndBackupService, type RepairAndBackupOptions, type RepairAndBackupResult, } from "./services/repair-and-backup.js";
 export { runStartupRepairAndBackup } from "./bootstrap/repair.js";
+export { probeNativeSqliteLoad } from "./bootstrap/native-sqlite-probe.js";
+export { runStorageModeSmoke, type StorageModeSmokeReport, type RunStorageModeSmokeOptions, } from "./bootstrap/storage-mode-smoke.js";
+export { repairStateIndexes, type RepairSummary, type RepairStateIndexesOptions, type RepairGateStatus, } from "./bootstrap/repair-gate.js";
 export { createStateAPI, type StateAPI, type MemoryReadPort, type MemoryWritePort, type CredentialContextPort, type IntentCommitPort, type ProvenancePort } from "./state-api.js";
+export type { LifeEvidence, LifeEvidenceCandidate, LifeEvidenceType, LifeEvidenceWriteAck, Sensitivity, SourceRef, } from "./life-evidence/types.js";
+export { appendLifeEvidence, type AppendLifeEvidenceOptions } from "./life-evidence/append-life-evidence.js";
+export { loadRhythmPolicySnapshot, type RhythmPolicySnapshot } from "./rhythm/rhythm-policy-snapshot.js";
+export type { LifeEvidenceQuery, LifeEvidenceSnapshot, LifeEvidenceReadModel, ContinuitySnapshot, SourceCoverage, } from "./snapshots/types.js";
+export { loadLifeEvidenceSnapshot, type LoadLifeEvidenceSnapshotOptions } from "./snapshots/life-evidence-snapshot.js";
+export { loadContinuitySnapshot, type LoadContinuitySnapshotParams } from "./snapshots/continuity-snapshot.js";
+export type { UserInterestSnapshot, UserInterestSignal, UserInterestStaleness } from "./user-interest/types.js";
+export { loadUserInterestSnapshot } from "./user-interest/load-user-interest-snapshot.js";
+export type { DeliveryAttemptWrite, DeliveryAttemptRecord, DeliveryAttemptAck } from "./delivery/types.js";
+export { writeDeliveryAttempt } from "./delivery/write-delivery-attempt.js";
+export { listDeliveryAttemptsByDecisionId } from "./delivery/query-delivery-attempts.js";
+export type { OperatorFallbackWrite, OperatorFallbackReason } from "./fallback/operator-fallback-types.js";
+export type { OperatorFallbackView } from "./fallback/operator-fallback-view.js";
+export { writeOperatorFallback, type OperatorFallbackAck } from "./fallback/write-operator-fallback.js";
+export { loadOperatorFallbackRow, normalizeFallbackRef, toOperatorFallbackView, } from "./fallback/load-operator-fallback.js";
+export type { QuietArtifactWrite, QuietClaim, QuietArtifactKind } from "./quiet/quiet-artifact-types.js";
+export { writeQuietArtifact, calculateQuietSourceCoverage, evidenceGroundingRatio, type QuietArtifactAck, } from "./quiet/quiet-artifact-writer.js";
+export { persistQuietArtifactToWorkspace, type PersistQuietArtifactResult } from "./quiet/persist-quiet-artifact.js";

package/runtime/storage/index.js

@@ -13,4 +13,18 @@ export { createGovernanceLayer } from "./services/governance-layer.js";
 export { createProvenanceService } from "./services/provenance-service.js";
 export { createRepairAndBackupService, } from "./services/repair-and-backup.js";
 export { runStartupRepairAndBackup } from "./bootstrap/repair.js";
+export { probeNativeSqliteLoad } from "./bootstrap/native-sqlite-probe.js";
+export { runStorageModeSmoke, } from "./bootstrap/storage-mode-smoke.js";
+export { repairStateIndexes, } from "./bootstrap/repair-gate.js";
 export { createStateAPI } from "./state-api.js";
+export { appendLifeEvidence } from "./life-evidence/append-life-evidence.js";
+export { loadRhythmPolicySnapshot } from "./rhythm/rhythm-policy-snapshot.js";
+export { loadLifeEvidenceSnapshot } from "./snapshots/life-evidence-snapshot.js";
+export { loadContinuitySnapshot } from "./snapshots/continuity-snapshot.js";
+export { loadUserInterestSnapshot } from "./user-interest/load-user-interest-snapshot.js";
+export { writeDeliveryAttempt } from "./delivery/write-delivery-attempt.js";
+export { listDeliveryAttemptsByDecisionId } from "./delivery/query-delivery-attempts.js";
+export { writeOperatorFallback } from "./fallback/write-operator-fallback.js";
+export { loadOperatorFallbackRow, normalizeFallbackRef, toOperatorFallbackView, } from "./fallback/load-operator-fallback.js";
+export { writeQuietArtifact, calculateQuietSourceCoverage, evidenceGroundingRatio, } from "./quiet/quiet-artifact-writer.js";
+export { persistQuietArtifactToWorkspace } from "./quiet/persist-quiet-artifact.js";

package/runtime/storage/life-evidence/append-life-evidence.d.ts

@@ -0,0 +1,7 @@
+import type { StateDatabase } from "../db/index.js";
+import type { ProvenanceRepository } from "../repositories/provenance-repository.js";
+import type { LifeEvidenceCandidate, LifeEvidenceWriteAck } from "./types.js";
+export interface AppendLifeEvidenceOptions {
+    provenance?: ProvenanceRepository;
+}
+export declare function appendLifeEvidence(state: StateDatabase, workspaceRoot: string, candidate: LifeEvidenceCandidate, options?: AppendLifeEvidenceOptions): Promise<LifeEvidenceWriteAck>;

package/runtime/storage/life-evidence/append-life-evidence.js

@@ -0,0 +1,64 @@
+/**
+ * Append canonical LifeEvidence artifacts and SQLite index rows (state-system T4.1.1).
+ *
+ * Core logic: reject missing source refs and credential sensitivity; write JSON artifact;
+ * insert life_evidence_index; bump snapshot epoch file for downstream snapshot invalidation.
+ *
+ * Dependencies: StateDatabase drizzle + optional ProvenanceRepository for source edges.
+ *
+ * Boundaries: does not run connector normalization; caller supplies validated candidates.
+ *
+ * Test coverage: tests/unit/storage/life-evidence.test.ts
+ */
+import * as crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { lifeEvidenceIndex } from "../db/schema/life-evidence-index.js";
+export async function appendLifeEvidence(state, workspaceRoot, candidate, options) {
+    if (!candidate.sourceRefs || candidate.sourceRefs.length === 0) {
+        throw new Error("life_evidence_missing_source_refs");
+    }
+    if (candidate.sensitivity === "credential") {
+        throw new Error("life_evidence_credential_rejected");
+    }
+    const evidenceId = candidate.id ?? `lev_${crypto.randomUUID()}`;
+    const artifactRel = path.join(".second-nature", "evidence", `${evidenceId}.json`);
+    const artifactAbs = path.join(workspaceRoot, artifactRel);
+    const artifactRef = {
+        id: `artifact:${evidenceId}`,
+        kind: "workspace_artifact",
+        uri: artifactRel.replace(/\\/g, "/"),
+    };
+    const life = {
+        id: evidenceId,
+        timestamp: candidate.timestamp,
+        evidenceType: candidate.evidenceType,
+        platformId: candidate.platformId,
+        summary: candidate.summary,
+        rawContentRef: candidate.rawContentRef,
+        sourceRefs: candidate.sourceRefs,
+        sensitivity: candidate.sensitivity,
+        confidence: candidate.confidence ?? 1,
+        tags: candidate.tags ?? [],
+        producer: candidate.producer,
+        artifactRef,
+    };
+    fs.mkdirSync(path.dirname(artifactAbs), { recursive: true });
+    fs.writeFileSync(artifactAbs, JSON.stringify(life, null, 2), "utf-8");
+    const epochPath = path.join(workspaceRoot, ".second-nature", "evidence", ".snapshot_epoch");
+    fs.writeFileSync(epochPath, `${Date.now()}\n`, "utf-8");
+    await state.db.insert(lifeEvidenceIndex).values({
+        id: evidenceId,
+        timestamp: candidate.timestamp,
+        evidenceType: candidate.evidenceType,
+        sensitivity: candidate.sensitivity,
+        producer: candidate.producer,
+        artifactPath: artifactRel.replace(/\\/g, "/"),
+        platformId: candidate.platformId ?? null,
+        sourceRefsJson: JSON.stringify(candidate.sourceRefs),
+    });
+    if (options?.provenance) {
+        await options.provenance.linkEntrySources(evidenceId, candidate.sourceRefs.map((ref) => ref.id));
+    }
+    return { evidenceId, artifactRef };
+}

package/runtime/storage/life-evidence/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Life evidence contract types (state-system v5 subset for ingest port).
+ *
+ * Test coverage: tests/unit/storage/life-evidence.test.ts
+ */
+export type LifeEvidenceType = "platform_browse" | "platform_interaction" | "work_progress" | "task_discovery" | "user_interaction" | "quiet_reflection" | "delivery_fallback";
+export type Sensitivity = "public" | "private" | "credential" | "sensitive";
+export interface SourceRef {
+    id: string;
+    kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
+    uri: string;
+    excerptHash?: string;
+    observedAt?: string;
+}
+export interface LifeEvidenceCandidate {
+    id?: string;
+    timestamp: string;
+    evidenceType: LifeEvidenceType;
+    platformId?: string;
+    summary: string;
+    rawContentRef?: string;
+    sourceRefs: SourceRef[];
+    sensitivity: Sensitivity;
+    confidence?: number;
+    tags?: string[];
+    producer: "connector-system" | "control-plane-system" | "observability-system" | "state-system";
+}
+export interface LifeEvidence {
+    id: string;
+    timestamp: string;
+    evidenceType: LifeEvidenceType;
+    platformId?: string;
+    summary: string;
+    rawContentRef?: string;
+    sourceRefs: SourceRef[];
+    sensitivity: Sensitivity;
+    confidence: number;
+    tags: string[];
+    producer: string;
+    artifactRef: SourceRef;
+}
+export interface LifeEvidenceWriteAck {
+    evidenceId: string;
+    artifactRef: SourceRef;
+}

package/runtime/storage/life-evidence/types.js

@@ -0,0 +1,6 @@
+/**
+ * Life evidence contract types (state-system v5 subset for ingest port).
+ *
+ * Test coverage: tests/unit/storage/life-evidence.test.ts
+ */
+export {};

package/runtime/storage/quiet/persist-quiet-artifact.d.ts

@@ -0,0 +1,7 @@
+import type { QuietArtifactWrite } from "./quiet-artifact-types.js";
+import type { QuietArtifactAck } from "./quiet-artifact-writer.js";
+export interface PersistQuietArtifactResult {
+    relativePath: string;
+    absolutePath: string;
+}
+export declare function persistQuietArtifactToWorkspace(workspaceRoot: string, ack: QuietArtifactAck, input: QuietArtifactWrite): Promise<PersistQuietArtifactResult>;

package/runtime/storage/quiet/persist-quiet-artifact.js

@@ -0,0 +1,22 @@
+/**
+ * Writes validated Quiet artifact JSON under workspace `.second-nature/quiet/{day}/` (CR-M3 / T2.3.3).
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+export async function persistQuietArtifactToWorkspace(workspaceRoot, ack, input) {
+    const dir = path.join(workspaceRoot, ".second-nature", "quiet", input.day);
+    await fs.mkdir(dir, { recursive: true });
+    const file = path.join(dir, `${ack.artifactId}.json`);
+    const payload = {
+        artifactId: ack.artifactId,
+        artifactRef: ack.artifactRef,
+        sourceCoverage: ack.sourceCoverage,
+        write: input,
+        persistedAt: new Date().toISOString(),
+    };
+    await fs.writeFile(file, JSON.stringify(payload, null, 2), "utf8");
+    return {
+        relativePath: path.relative(workspaceRoot, file),
+        absolutePath: file,
+    };
+}