@haaaiawd/second-nature 0.1.17 → 0.1.18

package/runtime/cli/ops/show-operator-fallback.d.ts

@@ -1,13 +1,13 @@
-import type { OperatorFallbackView } from "../../storage/fallback/operator-fallback-view.js";
-export declare class OperatorFallbackNotFoundError extends Error {
-    readonly ref: string;
-    readonly code: "FALLBACK_NOT_FOUND";
-    constructor(ref: string);
-}
-export interface ShowOperatorFallbackReadModels {
-    loadFallbackView(ref: string): Promise<OperatorFallbackView | null>;
-}
-/**
- * T1.2.2 — Operator-visible fallback: always `status: not_sent` (ADR-007), never sent/delivered.
- */
-export declare function showOperatorFallback(ref: string, readModels: ShowOperatorFallbackReadModels): Promise<OperatorFallbackView>;
+import type { OperatorFallbackView } from "../../storage/fallback/operator-fallback-view.js";
+export declare class OperatorFallbackNotFoundError extends Error {
+    readonly ref: string;
+    readonly code: "FALLBACK_NOT_FOUND";
+    constructor(ref: string);
+}
+export interface ShowOperatorFallbackReadModels {
+    loadFallbackView(ref: string): Promise<OperatorFallbackView | null>;
+}
+/**
+ * T1.2.2 — Operator-visible fallback: always `status: not_sent` (ADR-007), never sent/delivered.
+ */
+export declare function showOperatorFallback(ref: string, readModels: ShowOperatorFallbackReadModels): Promise<OperatorFallbackView>;

package/runtime/cli/ops/show-operator-fallback.js

@@ -1,22 +1,22 @@
-export class OperatorFallbackNotFoundError extends Error {
-    ref;
-    code = "FALLBACK_NOT_FOUND";
-    constructor(ref) {
-        super(`No operator fallback artifact for ref: ${ref}`);
-        this.ref = ref;
-        this.name = "OperatorFallbackNotFoundError";
-    }
-}
-/**
- * T1.2.2 — Operator-visible fallback: always `status: not_sent` (ADR-007), never sent/delivered.
- */
-export async function showOperatorFallback(ref, readModels) {
-    const view = await readModels.loadFallbackView(ref);
-    if (!view) {
-        throw new OperatorFallbackNotFoundError(ref.trim());
-    }
-    return {
-        ...view,
-        status: "not_sent",
-    };
-}
+export class OperatorFallbackNotFoundError extends Error {
+    ref;
+    code = "FALLBACK_NOT_FOUND";
+    constructor(ref) {
+        super(`No operator fallback artifact for ref: ${ref}`);
+        this.ref = ref;
+        this.name = "OperatorFallbackNotFoundError";
+    }
+}
+/**
+ * T1.2.2 — Operator-visible fallback: always `status: not_sent` (ADR-007), never sent/delivered.
+ */
+export async function showOperatorFallback(ref, readModels) {
+    const view = await readModels.loadFallbackView(ref);
+    if (!view) {
+        throw new OperatorFallbackNotFoundError(ref.trim());
+    }
+    return {
+        ...view,
+        status: "not_sent",
+    };
+}

package/runtime/cli/ops/workspace-heartbeat-runner.d.ts

@@ -1,10 +1,19 @@
-/**
- * Wires CLI read models into control-plane `runHeartbeatCycle` for `heartbeat_check` (US-001 / CH-09-02).
- *
- * Snapshot inputs are derived from aggregated status; delivery defaults to none until host capability is modeled here.
- */
-import type { HeartbeatSignal, HeartbeatCycleResult } from "../../core/second-nature/heartbeat/signal.js";
-import type { SnapshotInputs } from "../../core/second-nature/heartbeat/snapshot-builder.js";
-import type { CliReadModels } from "../read-models/index.js";
-export declare function loadSnapshotInputsForWorkspaceHeartbeat(readModels: CliReadModels): Promise<SnapshotInputs>;
-export declare function createWorkspaceHeartbeatRunner(readModels: CliReadModels): (signal: HeartbeatSignal) => Promise<HeartbeatCycleResult>;
+/**
+ * Wires CLI read models into control-plane `runHeartbeatCycle` for `heartbeat_check` (US-001 / CH-09-02 / T1.2.3).
+ *
+ * Snapshot inputs are derived from aggregated status; delivery defaults to none until host capability is modeled here.
+ *
+ * T1.2.3: when a `RuntimeDecisionRecorder` is provided, persist a `sn-runtime-*` ledger row +
+ * `second-nature-runtime` execution attempt after each cycle so `loadStatus` exits its `unknown`
+ * baseline once the runtime has actually executed at least one full-runtime turn.
+ */
+import type { HeartbeatSignal, HeartbeatCycleResult } from "../../core/second-nature/heartbeat/signal.js";
+import type { SnapshotInputs } from "../../core/second-nature/heartbeat/snapshot-builder.js";
+import type { CliReadModels } from "../read-models/index.js";
+import type { RuntimeDecisionRecorder } from "../../observability/services/runtime-decision-recorder.js";
+export interface WorkspaceHeartbeatRunnerOptions {
+    /** When supplied, the runner persists the cycle so `loadStatus` can read it (T1.2.3). */
+    runtimeRecorder?: RuntimeDecisionRecorder;
+}
+export declare function loadSnapshotInputsForWorkspaceHeartbeat(readModels: CliReadModels): Promise<SnapshotInputs>;
+export declare function createWorkspaceHeartbeatRunner(readModels: CliReadModels, options?: WorkspaceHeartbeatRunnerOptions): (signal: HeartbeatSignal) => Promise<HeartbeatCycleResult>;

package/runtime/cli/ops/workspace-heartbeat-runner.js

@@ -1,26 +1,39 @@
-import { runHeartbeatCycle } from "../../core/second-nature/heartbeat/run-heartbeat-cycle.js";
-export async function loadSnapshotInputsForWorkspaceHeartbeat(readModels) {
-    const status = await readModels.loadStatus();
-    const mode = status.rhythm.mode === "unknown" ? "active" : status.rhythm.mode;
-    const quietEnabledBridge = status.quiet.mode === "quiet";
-    return {
-        mode,
-        currentWindowId: status.rhythm.windowId ?? "workspace-default",
-        pendingObligations: [],
-        recentOutreachHashes: [],
-        deniedIntents: [],
-        budgets: { socialUsed: 0, socialLimit: 5 },
-        awaitingUserInput: false,
-        quietEnabledBridge,
-        deliveryCapability: { target: "none" },
-    };
-}
-export function createWorkspaceHeartbeatRunner(readModels) {
-    return (signal) => runHeartbeatCycle({
-        signal,
-        runtimeAvailable: true,
-        deps: {
-            loadSnapshotInputs: () => loadSnapshotInputsForWorkspaceHeartbeat(readModels),
-        },
-    });
-}
+import { runHeartbeatCycle } from "../../core/second-nature/heartbeat/run-heartbeat-cycle.js";
+export async function loadSnapshotInputsForWorkspaceHeartbeat(readModels) {
+    const status = await readModels.loadStatus();
+    const mode = status.rhythm.mode === "unknown" ? "active" : status.rhythm.mode;
+    const quietEnabledBridge = status.quiet.mode === "quiet";
+    return {
+        mode,
+        currentWindowId: status.rhythm.windowId ?? "workspace-default",
+        pendingObligations: [],
+        recentOutreachHashes: [],
+        deniedIntents: [],
+        budgets: { socialUsed: 0, socialLimit: 5 },
+        awaitingUserInput: false,
+        quietEnabledBridge,
+        deliveryCapability: { target: "none" },
+    };
+}
+export function createWorkspaceHeartbeatRunner(readModels, options = {}) {
+    return async (signal) => {
+        const cycle = await runHeartbeatCycle({
+            signal,
+            runtimeAvailable: true,
+            deps: {
+                loadSnapshotInputs: () => loadSnapshotInputsForWorkspaceHeartbeat(readModels),
+            },
+        });
+        if (options.runtimeRecorder) {
+            try {
+                await options.runtimeRecorder.recordHeartbeatCycle({ cycle, signal });
+            }
+            catch {
+                // T1.2.3: recorder must never break the heartbeat surface response.
+                // Failure here means status simply remains at its previous aggregate; the
+                // cycle outcome itself is still returned to the caller.
+            }
+        }
+        return cycle;
+    };
+}

package/runtime/cli/read-models/index.d.ts

@@ -1,29 +1,29 @@
-import type { StateDatabase } from "../../storage/db/index.js";
-import type { ObservabilityDatabase } from "../../observability/db/index.js";
-import { AppendOnlyAuditStore } from "../../observability/audit/append-only-audit-store.js";
-import type { StatusReadModel, DailyReportReadModel, QuietReadModel, SessionDetailReadModel, CredentialReadModel, ExplainReadModel, ExplainSubjectKind } from "./types.js";
-export type { ExplainSubjectKind } from "./types.js";
-import type { OperatorFallbackView } from "../../storage/fallback/operator-fallback-view.js";
-export interface CliReadModels {
-    loadStatus(scope?: string): Promise<StatusReadModel>;
-    loadDailyReport(day: string): Promise<DailyReportReadModel>;
-    loadQuiet(scope?: string): Promise<QuietReadModel>;
-    loadSession(sessionId: string): Promise<SessionDetailReadModel>;
-    loadCredential(platformId: string): Promise<CredentialReadModel>;
-    explain(subject: ExplainSubject): Promise<ExplainReadModel>;
-    /** T1.2.2 — persisted operator fallback; view status is always not_sent. */
-    loadFallbackView(ref: string): Promise<OperatorFallbackView | null>;
-}
-/** T1.2.1 / T1.2.2 — operator-facing read surface (subset of full CLI read models). */
-export type OpsReadModelPort = Pick<CliReadModels, "loadStatus" | "loadDailyReport" | "loadQuiet" | "loadSession" | "loadCredential" | "explain" | "loadFallbackView">;
-export interface ExplainSubject {
-    kind: ExplainSubjectKind;
-    id: string;
-}
-export interface CliReadModelsDeps {
-    stateDb: StateDatabase;
-    observabilityDb: ObservabilityDatabase;
-    /** When set, explain can resolve delivery/fallback/report/source_ref and enrich decision subjects from lived-experience audit envelopes (T5.3.1 / T1.2.1). */
-    livedExperienceAuditStore?: AppendOnlyAuditStore;
-}
-export declare function createCliReadModels(deps: CliReadModelsDeps): CliReadModels;
+import type { StateDatabase } from "../../storage/db/index.js";
+import type { ObservabilityDatabase } from "../../observability/db/index.js";
+import { AppendOnlyAuditStore } from "../../observability/audit/append-only-audit-store.js";
+import type { StatusReadModel, DailyReportReadModel, QuietReadModel, SessionDetailReadModel, CredentialReadModel, ExplainReadModel, ExplainSubjectKind } from "./types.js";
+export type { ExplainSubjectKind } from "./types.js";
+import type { OperatorFallbackView } from "../../storage/fallback/operator-fallback-view.js";
+export interface CliReadModels {
+    loadStatus(scope?: string): Promise<StatusReadModel>;
+    loadDailyReport(day: string): Promise<DailyReportReadModel>;
+    loadQuiet(scope?: string): Promise<QuietReadModel>;
+    loadSession(sessionId: string): Promise<SessionDetailReadModel>;
+    loadCredential(platformId: string): Promise<CredentialReadModel>;
+    explain(subject: ExplainSubject): Promise<ExplainReadModel>;
+    /** T1.2.2 — persisted operator fallback; view status is always not_sent. */
+    loadFallbackView(ref: string): Promise<OperatorFallbackView | null>;
+}
+/** T1.2.1 / T1.2.2 — operator-facing read surface (subset of full CLI read models). */
+export type OpsReadModelPort = Pick<CliReadModels, "loadStatus" | "loadDailyReport" | "loadQuiet" | "loadSession" | "loadCredential" | "explain" | "loadFallbackView">;
+export interface ExplainSubject {
+    kind: ExplainSubjectKind;
+    id: string;
+}
+export interface CliReadModelsDeps {
+    stateDb: StateDatabase;
+    observabilityDb: ObservabilityDatabase;
+    /** When set, explain can resolve delivery/fallback/report/source_ref and enrich decision subjects from lived-experience audit envelopes (T5.3.1 / T1.2.1). */
+    livedExperienceAuditStore?: AppendOnlyAuditStore;
+}
+export declare function createCliReadModels(deps: CliReadModelsDeps): CliReadModels;