@haaaiawd/second-nature 0.1.16 → 0.1.18

package/runtime/observability/services/lived-experience-audit.d.ts

@@ -1,97 +1,97 @@
-import { AppendOnlyAuditStore } from "../audit/append-only-audit-store.js";
-import type { SourceRef } from "../../storage/life-evidence/types.js";
-export type RuntimeScope = "rhythm" | "user_task" | "user_reply";
-export type HeartbeatOutcome = "heartbeat_ok" | "intent_selected" | "denied" | "deferred" | "runtime_carrier_only" | "delivery_unavailable";
-export type DeliveryAuditStatus = "not_requested" | "target_available" | "target_none" | "channel_missing" | "host_unsupported" | "ack_dropped" | "sent" | "failed" | "not_sent_fallback";
-export type GroundingStatus = "pass" | "degraded" | "blocked";
-export interface DecisionTracePayload {
-    decisionId: string;
-    traceId: string;
-    heartbeatId?: string;
-    runtimeScope: RuntimeScope;
-    outcome: HeartbeatOutcome;
-    selectedIntentId?: string;
-    candidateId?: string;
-    rhythmWindowKind?: string;
-    hardGuardVerdict?: "allow" | "deny" | "defer" | "silent";
-    outreachVerdict?: "allow" | "deny" | "defer";
-    deliveryAuditId?: string;
-    reasonCodes: string[];
-    sourceRefs: SourceRef[];
-    snapshotRef?: SourceRef;
-    createdAt: string;
-}
-export interface DeliveryAuditPayload {
-    auditId: string;
-    decisionId: string;
-    traceId: string;
-    target?: "none" | "last" | "explicit";
-    channel?: string;
-    recipientRef?: string;
-    status: DeliveryAuditStatus;
-    messageId?: string;
-    hostProofRef?: SourceRef;
-    fallbackRef?: string;
-    ackDropMatched?: boolean;
-    hostVersion?: string;
-    reasonCodes: string[];
-    createdAt: string;
-}
-export interface SourceCoverageAuditPayload {
-    auditId: string;
-    traceId: string;
-    /** When set, explain index links this audit to the decision timeline. */
-    decisionId?: string;
-    subjectType: "quiet_artifact" | "outreach_draft" | "guidance_payload" | "decision_trace" | "host_report";
-    subjectRef: string;
-    usedSourceRefs: SourceRef[];
-    unresolvedRefs: SourceRef[];
-    coverageRatio: number;
-    unsupportedClaims: string[];
-    status: GroundingStatus;
-    reasonCodes: string[];
-    createdAt: string;
-}
-export interface GuidanceGroundingAuditPayload {
-    auditId: string;
-    traceId: string;
-    decisionId?: string;
-    requestId: string;
-    draftId?: string;
-    sceneType: "outreach" | "quiet_reflection" | "social" | "explain" | "user_reply_continuity" | "fallback_candidate";
-    groundingStatus: GroundingStatus;
-    usedSourceRefs: SourceRef[];
-    unsupportedClaims: string[];
-    guardViolations: string[];
-    deliveryWording?: "sendable" | "not_sent_fallback_candidate";
-    createdAt: string;
-}
-export interface ExplainLinkageSummary {
-    decisionId: string;
-    summary: string;
-    warnings: string[];
-    deliveryStatus?: DeliveryAuditStatus;
-    relatedEventIds: string[];
-}
-export declare class LivedExperienceAuditRecorder {
-    private readonly store;
-    private seq;
-    private readonly explainIndex;
-    constructor(store: AppendOnlyAuditStore);
-    private bumpSequence;
-    private touchDecision;
-    recordDecisionTrace(payload: DecisionTracePayload): {
-        eventId: string;
-    };
-    recordDeliveryAudit(payload: DeliveryAuditPayload): {
-        eventId: string;
-    };
-    recordSourceCoverage(payload: SourceCoverageAuditPayload): {
-        eventId: string;
-    };
-    recordGuidanceGrounding(payload: GuidanceGroundingAuditPayload): {
-        eventId: string;
-    };
-    explainLinkageForDecision(decisionId: string): ExplainLinkageSummary;
-}
-export declare function createLivedExperienceAuditRecorder(store?: AppendOnlyAuditStore): LivedExperienceAuditRecorder;
+import { AppendOnlyAuditStore } from "../audit/append-only-audit-store.js";
+import type { SourceRef } from "../../storage/life-evidence/types.js";
+export type RuntimeScope = "rhythm" | "user_task" | "user_reply";
+export type HeartbeatOutcome = "heartbeat_ok" | "intent_selected" | "denied" | "deferred" | "runtime_carrier_only" | "delivery_unavailable";
+export type DeliveryAuditStatus = "not_requested" | "target_available" | "target_none" | "channel_missing" | "host_unsupported" | "ack_dropped" | "sent" | "failed" | "not_sent_fallback";
+export type GroundingStatus = "pass" | "degraded" | "blocked";
+export interface DecisionTracePayload {
+    decisionId: string;
+    traceId: string;
+    heartbeatId?: string;
+    runtimeScope: RuntimeScope;
+    outcome: HeartbeatOutcome;
+    selectedIntentId?: string;
+    candidateId?: string;
+    rhythmWindowKind?: string;
+    hardGuardVerdict?: "allow" | "deny" | "defer" | "silent";
+    outreachVerdict?: "allow" | "deny" | "defer";
+    deliveryAuditId?: string;
+    reasonCodes: string[];
+    sourceRefs: SourceRef[];
+    snapshotRef?: SourceRef;
+    createdAt: string;
+}
+export interface DeliveryAuditPayload {
+    auditId: string;
+    decisionId: string;
+    traceId: string;
+    target?: "none" | "last" | "explicit";
+    channel?: string;
+    recipientRef?: string;
+    status: DeliveryAuditStatus;
+    messageId?: string;
+    hostProofRef?: SourceRef;
+    fallbackRef?: string;
+    ackDropMatched?: boolean;
+    hostVersion?: string;
+    reasonCodes: string[];
+    createdAt: string;
+}
+export interface SourceCoverageAuditPayload {
+    auditId: string;
+    traceId: string;
+    /** When set, explain index links this audit to the decision timeline. */
+    decisionId?: string;
+    subjectType: "quiet_artifact" | "outreach_draft" | "guidance_payload" | "decision_trace" | "host_report";
+    subjectRef: string;
+    usedSourceRefs: SourceRef[];
+    unresolvedRefs: SourceRef[];
+    coverageRatio: number;
+    unsupportedClaims: string[];
+    status: GroundingStatus;
+    reasonCodes: string[];
+    createdAt: string;
+}
+export interface GuidanceGroundingAuditPayload {
+    auditId: string;
+    traceId: string;
+    decisionId?: string;
+    requestId: string;
+    draftId?: string;
+    sceneType: "outreach" | "quiet_reflection" | "social" | "explain" | "user_reply_continuity" | "fallback_candidate";
+    groundingStatus: GroundingStatus;
+    usedSourceRefs: SourceRef[];
+    unsupportedClaims: string[];
+    guardViolations: string[];
+    deliveryWording?: "sendable" | "not_sent_fallback_candidate";
+    createdAt: string;
+}
+export interface ExplainLinkageSummary {
+    decisionId: string;
+    summary: string;
+    warnings: string[];
+    deliveryStatus?: DeliveryAuditStatus;
+    relatedEventIds: string[];
+}
+export declare class LivedExperienceAuditRecorder {
+    private readonly store;
+    private seq;
+    private readonly explainIndex;
+    constructor(store: AppendOnlyAuditStore);
+    private bumpSequence;
+    private touchDecision;
+    recordDecisionTrace(payload: DecisionTracePayload): {
+        eventId: string;
+    };
+    recordDeliveryAudit(payload: DeliveryAuditPayload): {
+        eventId: string;
+    };
+    recordSourceCoverage(payload: SourceCoverageAuditPayload): {
+        eventId: string;
+    };
+    recordGuidanceGrounding(payload: GuidanceGroundingAuditPayload): {
+        eventId: string;
+    };
+    explainLinkageForDecision(decisionId: string): ExplainLinkageSummary;
+}
+export declare function createLivedExperienceAuditRecorder(store?: AppendOnlyAuditStore): LivedExperienceAuditRecorder;

package/runtime/observability/services/lived-experience-audit.js

@@ -1,162 +1,162 @@
-/**
- * Decision trace, delivery audit, source coverage, guidance grounding + explain index (T5.2.1).
- *
- * Core logic: append-only envelopes with hash chain; explain index links decisionId to events and
- * flags when delivery audit indicates no user-visible contact (target_none / not_sent_fallback).
- * Test coverage: tests/unit/observability/lived-experience-audit.test.ts
- */
-import * as crypto from "node:crypto";
-import { AppendOnlyAuditStore } from "../audit/append-only-audit-store.js";
-import { buildAuditEnvelope } from "../audit/audit-envelope.js";
-function validateDecisionTrace(t) {
-    if (!t.decisionId?.trim())
-        throw new Error("decision_trace_requires_decision_id");
-    if (!t.traceId?.trim())
-        throw new Error("decision_trace_requires_trace_id");
-    if (!t.outcome)
-        throw new Error("decision_trace_requires_outcome");
-}
-function validateDeliveryAudit(a) {
-    if (!a.auditId?.trim())
-        throw new Error("delivery_audit_requires_audit_id");
-    if (!a.decisionId?.trim())
-        throw new Error("delivery_audit_requires_decision_id");
-    if (a.status === "sent") {
-        const ok = Boolean(a.messageId?.trim()) || Boolean(a.hostProofRef);
-        if (!ok)
-            throw new Error("delivery_audit_sent_requires_message_id_or_host_proof_ref");
-    }
-}
-export class LivedExperienceAuditRecorder {
-    store;
-    seq = 0;
-    explainIndex = new Map();
-    constructor(store) {
-        this.store = store;
-    }
-    bumpSequence() {
-        this.seq += 1;
-        return this.seq;
-    }
-    touchDecision(decisionId, traceId, eventId) {
-        let e = this.explainIndex.get(decisionId);
-        if (!e) {
-            e = { traceIds: new Set(), eventIds: [], deliveryStatuses: [], fallbackRefs: [], noUserVisibleContact: false };
-            this.explainIndex.set(decisionId, e);
-        }
-        e.traceIds.add(traceId);
-        e.eventIds.push(eventId);
-        return e;
-    }
-    recordDecisionTrace(payload) {
-        validateDecisionTrace(payload);
-        const seq = this.bumpSequence();
-        const envelope = buildAuditEnvelope({
-            family: "heartbeat.decision",
-            plane: "decision",
-            traceId: payload.traceId,
-            sequence: seq,
-            payload,
-            previousHash: this.store.lastRecordHash(),
-            eventId: crypto.randomUUID(),
-            createdAt: payload.createdAt,
-        });
-        this.store.append(envelope);
-        const entry = this.touchDecision(payload.decisionId, payload.traceId, envelope.eventId);
-        if (payload.outcome === "heartbeat_ok" &&
-            payload.reasonCodes.some((c) => c.includes("target_none") || c === "target_none")) {
-            entry.noUserVisibleContact = true;
-        }
-        return { eventId: envelope.eventId };
-    }
-    recordDeliveryAudit(payload) {
-        validateDeliveryAudit(payload);
-        const seq = this.bumpSequence();
-        const envelope = buildAuditEnvelope({
-            family: "delivery",
-            plane: "delivery",
-            traceId: payload.traceId,
-            sequence: seq,
-            payload,
-            previousHash: this.store.lastRecordHash(),
-            eventId: payload.auditId,
-            createdAt: payload.createdAt,
-        });
-        this.store.append(envelope);
-        const entry = this.touchDecision(payload.decisionId, payload.traceId, envelope.eventId);
-        entry.deliveryStatuses.push(payload.status);
-        if (payload.fallbackRef)
-            entry.fallbackRefs.push(payload.fallbackRef);
-        if (payload.status === "target_none" ||
-            payload.status === "not_sent_fallback" ||
-            payload.status === "channel_missing" ||
-            payload.status === "host_unsupported" ||
-            payload.status === "failed" ||
-            payload.status === "ack_dropped") {
-            entry.noUserVisibleContact = true;
-        }
-        return { eventId: envelope.eventId };
-    }
-    recordSourceCoverage(payload) {
-        const seq = this.bumpSequence();
-        const envelope = buildAuditEnvelope({
-            family: "source_coverage",
-            plane: "source_coverage",
-            traceId: payload.traceId,
-            sequence: seq,
-            payload,
-            previousHash: this.store.lastRecordHash(),
-            eventId: payload.auditId,
-            createdAt: payload.createdAt,
-        });
-        this.store.append(envelope);
-        if (payload.decisionId) {
-            this.touchDecision(payload.decisionId, payload.traceId, envelope.eventId);
-        }
-        return { eventId: envelope.eventId };
-    }
-    recordGuidanceGrounding(payload) {
-        const seq = this.bumpSequence();
-        const envelope = buildAuditEnvelope({
-            family: "guidance.grounding",
-            plane: "source_coverage",
-            traceId: payload.traceId,
-            sequence: seq,
-            payload,
-            previousHash: this.store.lastRecordHash(),
-            eventId: payload.auditId,
-            createdAt: payload.createdAt,
-        });
-        this.store.append(envelope);
-        if (payload.decisionId) {
-            this.touchDecision(payload.decisionId, payload.traceId, envelope.eventId);
-        }
-        return { eventId: envelope.eventId };
-    }
-    explainLinkageForDecision(decisionId) {
-        const entry = this.explainIndex.get(decisionId);
-        const warnings = [];
-        if (!entry) {
-            return {
-                decisionId,
-                summary: "no_audit_events_indexed_for_decision",
-                warnings: ["no_indexed_events"],
-                relatedEventIds: [],
-            };
-        }
-        if (entry.noUserVisibleContact) {
-            warnings.push("no_user_visible_contact_claim_prohibited");
-        }
-        const lastDelivery = entry.deliveryStatuses[entry.deliveryStatuses.length - 1];
-        return {
-            decisionId,
-            summary: `indexed_events=${entry.eventIds.length};delivery=${lastDelivery ?? "unknown"}`,
-            warnings,
-            deliveryStatus: lastDelivery,
-            relatedEventIds: [...entry.eventIds],
-        };
-    }
-}
-export function createLivedExperienceAuditRecorder(store) {
-    return new LivedExperienceAuditRecorder(store ?? new AppendOnlyAuditStore());
-}
+/**
+ * Decision trace, delivery audit, source coverage, guidance grounding + explain index (T5.2.1).
+ *
+ * Core logic: append-only envelopes with hash chain; explain index links decisionId to events and
+ * flags when delivery audit indicates no user-visible contact (target_none / not_sent_fallback).
+ * Test coverage: tests/unit/observability/lived-experience-audit.test.ts
+ */
+import * as crypto from "node:crypto";
+import { AppendOnlyAuditStore } from "../audit/append-only-audit-store.js";
+import { buildAuditEnvelope } from "../audit/audit-envelope.js";
+function validateDecisionTrace(t) {
+    if (!t.decisionId?.trim())
+        throw new Error("decision_trace_requires_decision_id");
+    if (!t.traceId?.trim())
+        throw new Error("decision_trace_requires_trace_id");
+    if (!t.outcome)
+        throw new Error("decision_trace_requires_outcome");
+}
+function validateDeliveryAudit(a) {
+    if (!a.auditId?.trim())
+        throw new Error("delivery_audit_requires_audit_id");
+    if (!a.decisionId?.trim())
+        throw new Error("delivery_audit_requires_decision_id");
+    if (a.status === "sent") {
+        const ok = Boolean(a.messageId?.trim()) || Boolean(a.hostProofRef);
+        if (!ok)
+            throw new Error("delivery_audit_sent_requires_message_id_or_host_proof_ref");
+    }
+}
+export class LivedExperienceAuditRecorder {
+    store;
+    seq = 0;
+    explainIndex = new Map();
+    constructor(store) {
+        this.store = store;
+    }
+    bumpSequence() {
+        this.seq += 1;
+        return this.seq;
+    }
+    touchDecision(decisionId, traceId, eventId) {
+        let e = this.explainIndex.get(decisionId);
+        if (!e) {
+            e = { traceIds: new Set(), eventIds: [], deliveryStatuses: [], fallbackRefs: [], noUserVisibleContact: false };
+            this.explainIndex.set(decisionId, e);
+        }
+        e.traceIds.add(traceId);
+        e.eventIds.push(eventId);
+        return e;
+    }
+    recordDecisionTrace(payload) {
+        validateDecisionTrace(payload);
+        const seq = this.bumpSequence();
+        const envelope = buildAuditEnvelope({
+            family: "heartbeat.decision",
+            plane: "decision",
+            traceId: payload.traceId,
+            sequence: seq,
+            payload,
+            previousHash: this.store.lastRecordHash(),
+            eventId: crypto.randomUUID(),
+            createdAt: payload.createdAt,
+        });
+        this.store.append(envelope);
+        const entry = this.touchDecision(payload.decisionId, payload.traceId, envelope.eventId);
+        if (payload.outcome === "heartbeat_ok" &&
+            payload.reasonCodes.some((c) => c.includes("target_none") || c === "target_none")) {
+            entry.noUserVisibleContact = true;
+        }
+        return { eventId: envelope.eventId };
+    }
+    recordDeliveryAudit(payload) {
+        validateDeliveryAudit(payload);
+        const seq = this.bumpSequence();
+        const envelope = buildAuditEnvelope({
+            family: "delivery",
+            plane: "delivery",
+            traceId: payload.traceId,
+            sequence: seq,
+            payload,
+            previousHash: this.store.lastRecordHash(),
+            eventId: payload.auditId,
+            createdAt: payload.createdAt,
+        });
+        this.store.append(envelope);
+        const entry = this.touchDecision(payload.decisionId, payload.traceId, envelope.eventId);
+        entry.deliveryStatuses.push(payload.status);
+        if (payload.fallbackRef)
+            entry.fallbackRefs.push(payload.fallbackRef);
+        if (payload.status === "target_none" ||
+            payload.status === "not_sent_fallback" ||
+            payload.status === "channel_missing" ||
+            payload.status === "host_unsupported" ||
+            payload.status === "failed" ||
+            payload.status === "ack_dropped") {
+            entry.noUserVisibleContact = true;
+        }
+        return { eventId: envelope.eventId };
+    }
+    recordSourceCoverage(payload) {
+        const seq = this.bumpSequence();
+        const envelope = buildAuditEnvelope({
+            family: "source_coverage",
+            plane: "source_coverage",
+            traceId: payload.traceId,
+            sequence: seq,
+            payload,
+            previousHash: this.store.lastRecordHash(),
+            eventId: payload.auditId,
+            createdAt: payload.createdAt,
+        });
+        this.store.append(envelope);
+        if (payload.decisionId) {
+            this.touchDecision(payload.decisionId, payload.traceId, envelope.eventId);
+        }
+        return { eventId: envelope.eventId };
+    }
+    recordGuidanceGrounding(payload) {
+        const seq = this.bumpSequence();
+        const envelope = buildAuditEnvelope({
+            family: "guidance.grounding",
+            plane: "source_coverage",
+            traceId: payload.traceId,
+            sequence: seq,
+            payload,
+            previousHash: this.store.lastRecordHash(),
+            eventId: payload.auditId,
+            createdAt: payload.createdAt,
+        });
+        this.store.append(envelope);
+        if (payload.decisionId) {
+            this.touchDecision(payload.decisionId, payload.traceId, envelope.eventId);
+        }
+        return { eventId: envelope.eventId };
+    }
+    explainLinkageForDecision(decisionId) {
+        const entry = this.explainIndex.get(decisionId);
+        const warnings = [];
+        if (!entry) {
+            return {
+                decisionId,
+                summary: "no_audit_events_indexed_for_decision",
+                warnings: ["no_indexed_events"],
+                relatedEventIds: [],
+            };
+        }
+        if (entry.noUserVisibleContact) {
+            warnings.push("no_user_visible_contact_claim_prohibited");
+        }
+        const lastDelivery = entry.deliveryStatuses[entry.deliveryStatuses.length - 1];
+        return {
+            decisionId,
+            summary: `indexed_events=${entry.eventIds.length};delivery=${lastDelivery ?? "unknown"}`,
+            warnings,
+            deliveryStatus: lastDelivery,
+            relatedEventIds: [...entry.eventIds],
+        };
+    }
+}
+export function createLivedExperienceAuditRecorder(store) {
+    return new LivedExperienceAuditRecorder(store ?? new AppendOnlyAuditStore());
+}

package/runtime/observability/services/runtime-decision-recorder.d.ts

@@ -0,0 +1,29 @@
+import type { ObservabilityDatabase } from "../db/index.js";
+import { DecisionLedger, type HeartbeatDecisionEvent } from "./decision-ledger.js";
+import { ExecutionTelemetry } from "./execution-telemetry.js";
+import type { HeartbeatCycleResult, HeartbeatSignal } from "../../core/second-nature/heartbeat/signal.js";
+export declare const RUNTIME_DECISION_TRACE_PREFIX = "sn-runtime-";
+export declare const RUNTIME_INTERNAL_PLATFORM_ID = "second-nature-runtime";
+export interface RecordHeartbeatCycleInput {
+    cycle: HeartbeatCycleResult;
+    signal: HeartbeatSignal;
+    /**
+     * Override rhythm `mode` written to the ledger row. When omitted, falls back
+     * to `"active"`; downstream loadStatus only treats `quiet` /
+     * `maintenance_only` / `paused_for_interrupt` as Quiet-aware values.
+     */
+    rhythmMode?: HeartbeatDecisionEvent["mode"];
+}
+export interface RecordHeartbeatCycleOutput {
+    traceId: string;
+    decisionId: string;
+    attemptId: string;
+}
+export interface RuntimeDecisionRecorder {
+    recordHeartbeatCycle(input: RecordHeartbeatCycleInput): Promise<RecordHeartbeatCycleOutput>;
+}
+export interface CreateRuntimeDecisionRecorderDeps {
+    ledger?: DecisionLedger;
+    telemetry?: ExecutionTelemetry;
+}
+export declare function createRuntimeDecisionRecorder(observabilityDb: ObservabilityDatabase, overrides?: CreateRuntimeDecisionRecorderDeps): RuntimeDecisionRecorder;

package/runtime/observability/services/runtime-decision-recorder.js

@@ -0,0 +1,94 @@
+/**
+ * Runtime Decision Recorder (T1.2.3).
+ *
+ * Core logic: after a workspace `runHeartbeatCycle` completes, persist two rows that
+ * `loadStatus` already filters on, so operator status stops returning `unknown` for
+ * `rhythm.mode` / `runtime.serviceStatus` once the runtime has executed at least once.
+ *  - `decision_ledger` row via `DecisionLedger.recordHeartbeatDecision()` with
+ *    `traceId` prefix `sn-runtime-` (matches `INTERNAL_RUNTIME_TRACE_PREFIX`).
+ *  - `execution_attempts` row via `ExecutionTelemetry.startAttempt` +
+ *    `completeAttempt` with `platformId === "second-nature-runtime"` (matches
+ *    `INTERNAL_RUNTIME_PLATFORM_ID`).
+ *
+ * Boundaries:
+ *  - Recorder failure must NOT break the heartbeat surface response — caller wraps with try/catch.
+ *  - Carrier-only / probe-only / runtime-unavailable paths do NOT invoke this recorder
+ *    (their semantics intentionally remain "unknown" until a full-runtime turn happens).
+ *  - This is a derived observability writer; it is not the canonical decision producer
+ *    (control-plane keeps that contract). It exists to close the read-side aggregation gap.
+ */
+import { randomUUID } from "node:crypto";
+import { DecisionLedger } from "./decision-ledger.js";
+import { ExecutionTelemetry } from "./execution-telemetry.js";
+export const RUNTIME_DECISION_TRACE_PREFIX = "sn-runtime-";
+export const RUNTIME_INTERNAL_PLATFORM_ID = "second-nature-runtime";
+const RUNTIME_INTERNAL_CAPABILITY = "runtime.heartbeat";
+const RUNTIME_INTERNAL_CHANNEL = "internal";
+export function createRuntimeDecisionRecorder(observabilityDb, overrides = {}) {
+    const ledger = overrides.ledger ?? new DecisionLedger(observabilityDb);
+    const telemetry = overrides.telemetry ?? new ExecutionTelemetry(observabilityDb);
+    return {
+        async recordHeartbeatCycle({ cycle, signal, rhythmMode }) {
+            const timestamp = typeof signal.payload.timestamp === "string" && signal.payload.timestamp.trim().length > 0
+                ? signal.payload.timestamp
+                : new Date().toISOString();
+            const uniqueId = randomUUID();
+            const traceId = `${RUNTIME_DECISION_TRACE_PREFIX}${cycle.scope}-${cycle.status}-${uniqueId}`;
+            const decisionId = `decision-runtime-${uniqueId}`;
+            const tickId = `tick-runtime-${uniqueId}`;
+            const event = {
+                id: decisionId,
+                tickId,
+                traceId,
+                runtimeScope: cycle.scope,
+                triggerSource: signal.trigger,
+                decisionStatus: mapCycleStatus(cycle.status),
+                reasons: cycle.reasons,
+                intentId: cycle.selectedIntentId,
+                mode: rhythmMode ?? "active",
+                createdAt: timestamp,
+            };
+            await ledger.recordHeartbeatDecision(event);
+            const attemptId = await telemetry.startAttempt({
+                traceId,
+                decisionId,
+                intentId: cycle.selectedIntentId ?? `${RUNTIME_INTERNAL_PLATFORM_ID}-tick`,
+                platformId: RUNTIME_INTERNAL_PLATFORM_ID,
+                capability: RUNTIME_INTERNAL_CAPABILITY,
+                channel: RUNTIME_INTERNAL_CHANNEL,
+                startedAt: timestamp,
+            });
+            const status = isFailureCycle(cycle.status) ? "failed" : "succeeded";
+            const failureClass = status === "failed" ? cycleStatusFailureClass(cycle.status) : undefined;
+            await telemetry.completeAttempt(traceId, status, undefined, failureClass);
+            return { traceId, decisionId, attemptId };
+        },
+    };
+}
+function mapCycleStatus(status) {
+    switch (status) {
+        case "intent_selected":
+            return "intent_selected";
+        case "denied":
+            return "denied";
+        case "deferred":
+            return "deferred";
+        case "delivery_unavailable":
+            return "delivery_unavailable";
+        case "runtime_carrier_only":
+            return "runtime_carrier_only";
+        case "heartbeat_ok":
+        default:
+            return "heartbeat_ok";
+    }
+}
+function isFailureCycle(status) {
+    return status === "delivery_unavailable" || status === "denied";
+}
+function cycleStatusFailureClass(status) {
+    if (status === "delivery_unavailable")
+        return "delivery_unavailable";
+    if (status === "denied")
+        return "decision_denied";
+    return undefined;
+}

package/runtime/storage/bootstrap/native-sqlite-probe.d.ts

@@ -1,7 +1,7 @@
-export interface NativeSqliteProbeResult {
-    moduleLoadOk: boolean;
-    /** package version when load succeeds */
-    version?: string;
-    errorMessage?: string;
-}
-export declare function probeNativeSqliteLoad(): NativeSqliteProbeResult;
+export interface NativeSqliteProbeResult {
+    moduleLoadOk: boolean;
+    /** package version when load succeeds */
+    version?: string;
+    errorMessage?: string;
+}
+export declare function probeNativeSqliteLoad(): NativeSqliteProbeResult;