@haaaiawd/second-nature 0.1.18 → 0.1.19

package/runtime/core/second-nature/heartbeat/signal.d.ts

@@ -1,42 +1,42 @@
-/**
- * Heartbeat Signal Contract
- *
- * Defines the signal types that enter the control-plane from various sources.
- * Per ADR-005: runtime scope classification depends on bridge protocol,
- * entry type, or explicit signal metadata, NOT on host natural classification.
- */
-export type RuntimeScope = "rhythm" | "user_task" | "user_reply";
-export type RuntimeTrigger = "heartbeat_bridge" | "user_task" | "user_reply" | "interrupt" | "resume";
-export type HeartbeatCycleStatus = "heartbeat_ok" | "intent_selected" | "deferred" | "denied"
-/** Delivery port returned failed / host dropped; operator fallback written (T2.3.2 / ADR-007). */
- | "delivery_unavailable"
-/** Host-safe packaged carrier: no lived-experience loop (ADR-005 / control-plane L0). */
- | "runtime_carrier_only";
-export interface HeartbeatSignal {
-    trigger: RuntimeTrigger;
-    scopeHint?: RuntimeScope;
-    payload: {
-        timestamp: string;
-        sessionContext?: string;
-        heartbeatChecklist?: string;
-    };
-}
-export interface ScopedRuntimeInput {
-    trigger: RuntimeTrigger;
-    scopeHint?: RuntimeScope;
-    payload: Record<string, unknown>;
-}
-export interface HeartbeatCycleResult {
-    scope: RuntimeScope;
-    status: HeartbeatCycleStatus;
-    selectedIntentId?: string;
-    reasons: string[];
-    decisionId?: string;
-    deliveryAttemptId?: string;
-    fallbackRef?: string;
-}
-export interface ScopeRouteResult {
-    scope: RuntimeScope;
-    trigger: RuntimeTrigger;
-    handled: boolean;
-}
+/**
+ * Heartbeat Signal Contract
+ *
+ * Defines the signal types that enter the control-plane from various sources.
+ * Per ADR-005: runtime scope classification depends on bridge protocol,
+ * entry type, or explicit signal metadata, NOT on host natural classification.
+ */
+export type RuntimeScope = "rhythm" | "user_task" | "user_reply";
+export type RuntimeTrigger = "heartbeat_bridge" | "user_task" | "user_reply" | "interrupt" | "resume";
+export type HeartbeatCycleStatus = "heartbeat_ok" | "intent_selected" | "deferred" | "denied"
+/** Delivery port returned failed / host dropped; operator fallback written (T2.3.2 / ADR-007). */
+ | "delivery_unavailable"
+/** Host-safe packaged carrier: no lived-experience loop (ADR-005 / control-plane L0). */
+ | "runtime_carrier_only";
+export interface HeartbeatSignal {
+    trigger: RuntimeTrigger;
+    scopeHint?: RuntimeScope;
+    payload: {
+        timestamp: string;
+        sessionContext?: string;
+        heartbeatChecklist?: string;
+    };
+}
+export interface ScopedRuntimeInput {
+    trigger: RuntimeTrigger;
+    scopeHint?: RuntimeScope;
+    payload: Record<string, unknown>;
+}
+export interface HeartbeatCycleResult {
+    scope: RuntimeScope;
+    status: HeartbeatCycleStatus;
+    selectedIntentId?: string;
+    reasons: string[];
+    decisionId?: string;
+    deliveryAttemptId?: string;
+    fallbackRef?: string;
+}
+export interface ScopeRouteResult {
+    scope: RuntimeScope;
+    trigger: RuntimeTrigger;
+    handled: boolean;
+}

package/runtime/core/second-nature/heartbeat/snapshot-builder.d.ts

@@ -1,51 +1,51 @@
-/**
- * Snapshot Builder
- *
- * Builds a ContinuitySnapshot from state-system, workspace, and runtime context.
- * This is the input preparation step for each heartbeat round.
- *
- * Per design doc §4.2: SnapshotBuilder prepares inputs for the Rhythm Engine.
- */
-import type { ContinuitySnapshot, ControlPlaneSourceRef, TopLevelMode } from "../types.js";
-import type { RhythmPolicy } from "../rhythm/rhythm-policy.js";
-import type { DeliveryCapabilitySnapshot } from "../outreach/delivery-target.js";
-import type { UserInterestSnapshot } from "../../../storage/user-interest/types.js";
-export interface SnapshotInputs {
-    mode: TopLevelMode;
-    currentWindowId: string;
-    pendingObligations: string[];
-    recentOutreachHashes: string[];
-    deniedIntents: Array<{
-        intentHash: string;
-        reason: string;
-        at: string;
-    }>;
-    budgets?: {
-        socialUsed: number;
-        socialLimit: number;
-    };
-    awaitingUserInput?: boolean;
-    riskSuppressed?: boolean;
-    /** Evidence refs for source-backed planner/guards (T2.1.3 / T2.2.1). */
-    lifeEvidenceRefs?: ControlPlaneSourceRef[];
-    platformEventCount?: number;
-    workEventCount?: number;
-    lifeEvidenceEmptyReason?: "no_sources" | "state_unavailable" | "redacted_only";
-    /** Optional explicit rhythm geometry; otherwise `quietEnabledBridge` drives policy-bridge default. */
-    rhythmPolicy?: RhythmPolicy;
-    /** Passed to `rhythmPolicySnapshotToRhythmPolicy` when `rhythmPolicy` is absent. */
-    quietEnabledBridge?: boolean;
-    duplicateIntentKeys?: string[];
-    outreachCooldownKeys?: string[];
-    /** When present, outreach judgment uses this delivery snapshot (ADR-007). */
-    deliveryCapability?: DeliveryCapabilitySnapshot;
-    /** When present, outreach judgment uses this user-interest read model (T4.2.2). */
-    userInterestSnapshot?: UserInterestSnapshot;
-}
-/**
- * Build a ContinuitySnapshot from loaded inputs.
- *
- * In production, inputs come from state-system (mode, budgets, obligations),
- * workspace (outreach hashes, denied intents), and runtime context (window ID).
- */
-export declare function buildContinuitySnapshot(inputs: SnapshotInputs): ContinuitySnapshot;
+/**
+ * Snapshot Builder
+ *
+ * Builds a ContinuitySnapshot from state-system, workspace, and runtime context.
+ * This is the input preparation step for each heartbeat round.
+ *
+ * Per design doc §4.2: SnapshotBuilder prepares inputs for the Rhythm Engine.
+ */
+import type { ContinuitySnapshot, ControlPlaneSourceRef, TopLevelMode } from "../types.js";
+import type { RhythmPolicy } from "../rhythm/rhythm-policy.js";
+import type { DeliveryCapabilitySnapshot } from "../outreach/delivery-target.js";
+import type { UserInterestSnapshot } from "../../../storage/user-interest/types.js";
+export interface SnapshotInputs {
+    mode: TopLevelMode;
+    currentWindowId: string;
+    pendingObligations: string[];
+    recentOutreachHashes: string[];
+    deniedIntents: Array<{
+        intentHash: string;
+        reason: string;
+        at: string;
+    }>;
+    budgets?: {
+        socialUsed: number;
+        socialLimit: number;
+    };
+    awaitingUserInput?: boolean;
+    riskSuppressed?: boolean;
+    /** Evidence refs for source-backed planner/guards (T2.1.3 / T2.2.1). */
+    lifeEvidenceRefs?: ControlPlaneSourceRef[];
+    platformEventCount?: number;
+    workEventCount?: number;
+    lifeEvidenceEmptyReason?: "no_sources" | "state_unavailable" | "redacted_only";
+    /** Optional explicit rhythm geometry; otherwise `quietEnabledBridge` drives policy-bridge default. */
+    rhythmPolicy?: RhythmPolicy;
+    /** Passed to `rhythmPolicySnapshotToRhythmPolicy` when `rhythmPolicy` is absent. */
+    quietEnabledBridge?: boolean;
+    duplicateIntentKeys?: string[];
+    outreachCooldownKeys?: string[];
+    /** When present, outreach judgment uses this delivery snapshot (ADR-007). */
+    deliveryCapability?: DeliveryCapabilitySnapshot;
+    /** When present, outreach judgment uses this user-interest read model (T4.2.2). */
+    userInterestSnapshot?: UserInterestSnapshot;
+}
+/**
+ * Build a ContinuitySnapshot from loaded inputs.
+ *
+ * In production, inputs come from state-system (mode, budgets, obligations),
+ * workspace (outreach hashes, denied intents), and runtime context (window ID).
+ */
+export declare function buildContinuitySnapshot(inputs: SnapshotInputs): ContinuitySnapshot;

package/runtime/core/second-nature/index.d.ts

@@ -1,22 +1,22 @@
-export * from "./types.js";
-export * from "./rhythm/rhythm-policy.js";
-export * from "./rhythm/select-window.js";
-export * from "./rhythm/policy-bridge.js";
-export * from "./orchestrator/intent-planner.js";
-export * from "./orchestrator/guard-layer.js";
-export * from "./heartbeat/runtime-snapshot.js";
-export * from "./orchestrator/lease-manager.js";
-export * from "./orchestrator/effect-dispatcher.js";
-export * from "./orchestrator/resume-from-checkpoint.js";
-export * from "./quiet/quiet-pipeline.js";
-export * from "./reflection/run-narrative-reflection.js";
-export * from "./outreach/evaluate-outreach.js";
-export * from "./outreach/build-message.js";
-export * from "./outreach/delivery-target.js";
-export * from "./outreach/judge-outreach.js";
-export * from "./outreach/build-outreach-draft-request.js";
-export * from "./outreach/dispatch-user-outreach.js";
-export * from "./outreach/judge-input-from-snapshot.js";
-export * from "./quiet/run-source-backed-quiet.js";
-export * from "./guidance/request-guidance.js";
-export * from "./guidance/apply-guidance.js";
+export * from "./types.js";
+export * from "./rhythm/rhythm-policy.js";
+export * from "./rhythm/select-window.js";
+export * from "./rhythm/policy-bridge.js";
+export * from "./orchestrator/intent-planner.js";
+export * from "./orchestrator/guard-layer.js";
+export * from "./heartbeat/runtime-snapshot.js";
+export * from "./orchestrator/lease-manager.js";
+export * from "./orchestrator/effect-dispatcher.js";
+export * from "./orchestrator/resume-from-checkpoint.js";
+export * from "./quiet/quiet-pipeline.js";
+export * from "./reflection/run-narrative-reflection.js";
+export * from "./outreach/evaluate-outreach.js";
+export * from "./outreach/build-message.js";
+export * from "./outreach/delivery-target.js";
+export * from "./outreach/judge-outreach.js";
+export * from "./outreach/build-outreach-draft-request.js";
+export * from "./outreach/dispatch-user-outreach.js";
+export * from "./outreach/judge-input-from-snapshot.js";
+export * from "./quiet/run-source-backed-quiet.js";
+export * from "./guidance/request-guidance.js";
+export * from "./guidance/apply-guidance.js";

package/runtime/core/second-nature/index.js

@@ -1,22 +1,22 @@
-export * from "./types.js";
-export * from "./rhythm/rhythm-policy.js";
-export * from "./rhythm/select-window.js";
-export * from "./rhythm/policy-bridge.js";
-export * from "./orchestrator/intent-planner.js";
-export * from "./orchestrator/guard-layer.js";
-export * from "./heartbeat/runtime-snapshot.js";
-export * from "./orchestrator/lease-manager.js";
-export * from "./orchestrator/effect-dispatcher.js";
-export * from "./orchestrator/resume-from-checkpoint.js";
-export * from "./quiet/quiet-pipeline.js";
-export * from "./reflection/run-narrative-reflection.js";
-export * from "./outreach/evaluate-outreach.js";
-export * from "./outreach/build-message.js";
-export * from "./outreach/delivery-target.js";
-export * from "./outreach/judge-outreach.js";
-export * from "./outreach/build-outreach-draft-request.js";
-export * from "./outreach/dispatch-user-outreach.js";
-export * from "./outreach/judge-input-from-snapshot.js";
-export * from "./quiet/run-source-backed-quiet.js";
-export * from "./guidance/request-guidance.js";
-export * from "./guidance/apply-guidance.js";
+export * from "./types.js";
+export * from "./rhythm/rhythm-policy.js";
+export * from "./rhythm/select-window.js";
+export * from "./rhythm/policy-bridge.js";
+export * from "./orchestrator/intent-planner.js";
+export * from "./orchestrator/guard-layer.js";
+export * from "./heartbeat/runtime-snapshot.js";
+export * from "./orchestrator/lease-manager.js";
+export * from "./orchestrator/effect-dispatcher.js";
+export * from "./orchestrator/resume-from-checkpoint.js";
+export * from "./quiet/quiet-pipeline.js";
+export * from "./reflection/run-narrative-reflection.js";
+export * from "./outreach/evaluate-outreach.js";
+export * from "./outreach/build-message.js";
+export * from "./outreach/delivery-target.js";
+export * from "./outreach/judge-outreach.js";
+export * from "./outreach/build-outreach-draft-request.js";
+export * from "./outreach/dispatch-user-outreach.js";
+export * from "./outreach/judge-input-from-snapshot.js";
+export * from "./quiet/run-source-backed-quiet.js";
+export * from "./guidance/request-guidance.js";
+export * from "./guidance/apply-guidance.js";

package/runtime/core/second-nature/orchestrator/effect-dispatcher.d.ts

@@ -1,100 +1,100 @@
-import type { ConnectorResult, CapabilityIntent } from "../../../connectors/base/contract.js";
-import { LeaseManager, type EffectClass } from "./lease-manager.js";
-export interface AllowedIntent {
-    id: string;
-    kind: "work" | "exploration" | "social" | "quiet" | "reflection" | "outreach" | "maintenance";
-    summary: string;
-    effectClass: EffectClass;
-    platformId?: string;
-    payload?: Record<string, unknown>;
-}
-export interface DecisionContext {
-    decisionId: string;
-    intentId: string;
-    tickId: string;
-    checkpointId: string;
-    traceId: string;
-}
-export interface IntentCommitPort {
-    createIntentCommitRecord(input: {
-        intentId: string;
-        decisionId: string;
-        checkpointId?: string;
-        state: "planned" | "dispatched" | "externally_acknowledged" | "committed" | "reconcile" | "aborted";
-    }): Promise<{
-        id: string;
-    }>;
-    advanceIntentCommitState(id: string, state: "planned" | "dispatched" | "externally_acknowledged" | "committed" | "reconcile" | "aborted", metadata?: Record<string, unknown>): Promise<void>;
-    commitIntentOutcome(id: string, outcome: {
-        traceId: string;
-        outcomeRef: string;
-    }): Promise<void>;
-    abortIntentCommit(id: string, reason: string): Promise<void>;
-}
-export interface ConnectorExecutor {
-    executeEffect(input: {
-        platformId: string;
-        intent: CapabilityIntent;
-        payload: Record<string, unknown>;
-        decisionId: string;
-        intentId: string;
-        idempotencyKey: string;
-    }): Promise<ConnectorResult<unknown>>;
-}
-export interface CheckpointPort {
-    saveCheckpoint(input: {
-        id: string;
-        tickId: string;
-        intentId: string;
-        phase: "before_effect" | "before_quiet_write";
-        snapshotRef: string;
-    }): Promise<void>;
-}
-export interface MemoryPort {
-    persistCurationResult(input: {
-        summary: string;
-        sourceRefs: string[];
-        traceId: string;
-    }): Promise<void>;
-}
-export interface ReflectionPort {
-    runNarrativeReflection(input: {
-        decisionId: string;
-        intentId: string;
-        traceId: string;
-    }): Promise<{
-        outcomeRef: string;
-    }>;
-}
-export type DispatchResult = {
-    status: "deferred";
-    reason: string;
-} | {
-    status: "effect_executed";
-    result: ConnectorResult<unknown>;
-    commitId: string;
-} | {
-    status: "curated";
-    commitId: string;
-} | {
-    status: "reflected";
-    commitId: string;
-} | {
-    status: "maintenance_done";
-    commitId: string;
-};
-export declare class EffectDispatcher {
-    private readonly leaseManager;
-    private readonly commitPort;
-    private readonly connectorExecutor;
-    private readonly checkpointPort;
-    private readonly memoryPort;
-    private readonly reflectionPort;
-    constructor(leaseManager: LeaseManager, commitPort: IntentCommitPort, connectorExecutor: ConnectorExecutor, checkpointPort: CheckpointPort, memoryPort: MemoryPort, reflectionPort: ReflectionPort);
-    dispatchEffect(intent: AllowedIntent, decision: DecisionContext): Promise<DispatchResult>;
-}
-export declare function buildDecisionContext(input: {
-    tickId: string;
-    decisionId?: string;
-    intentId: string;
-}): DecisionContext;
+import type { ConnectorResult, CapabilityIntent } from "../../../connectors/base/contract.js";
+import { LeaseManager, type EffectClass } from "./lease-manager.js";
+export interface AllowedIntent {
+    id: string;
+    kind: "work" | "exploration" | "social" | "quiet" | "reflection" | "outreach" | "maintenance";
+    summary: string;
+    effectClass: EffectClass;
+    platformId?: string;
+    payload?: Record<string, unknown>;
+}
+export interface DecisionContext {
+    decisionId: string;
+    intentId: string;
+    tickId: string;
+    checkpointId: string;
+    traceId: string;
+}
+export interface IntentCommitPort {
+    createIntentCommitRecord(input: {
+        intentId: string;
+        decisionId: string;
+        checkpointId?: string;
+        state: "planned" | "dispatched" | "externally_acknowledged" | "committed" | "reconcile" | "aborted";
+    }): Promise<{
+        id: string;
+    }>;
+    advanceIntentCommitState(id: string, state: "planned" | "dispatched" | "externally_acknowledged" | "committed" | "reconcile" | "aborted", metadata?: Record<string, unknown>): Promise<void>;
+    commitIntentOutcome(id: string, outcome: {
+        traceId: string;
+        outcomeRef: string;
+    }): Promise<void>;
+    abortIntentCommit(id: string, reason: string): Promise<void>;
+}
+export interface ConnectorExecutor {
+    executeEffect(input: {
+        platformId: string;
+        intent: CapabilityIntent;
+        payload: Record<string, unknown>;
+        decisionId: string;
+        intentId: string;
+        idempotencyKey: string;
+    }): Promise<ConnectorResult<unknown>>;
+}
+export interface CheckpointPort {
+    saveCheckpoint(input: {
+        id: string;
+        tickId: string;
+        intentId: string;
+        phase: "before_effect" | "before_quiet_write";
+        snapshotRef: string;
+    }): Promise<void>;
+}
+export interface MemoryPort {
+    persistCurationResult(input: {
+        summary: string;
+        sourceRefs: string[];
+        traceId: string;
+    }): Promise<void>;
+}
+export interface ReflectionPort {
+    runNarrativeReflection(input: {
+        decisionId: string;
+        intentId: string;
+        traceId: string;
+    }): Promise<{
+        outcomeRef: string;
+    }>;
+}
+export type DispatchResult = {
+    status: "deferred";
+    reason: string;
+} | {
+    status: "effect_executed";
+    result: ConnectorResult<unknown>;
+    commitId: string;
+} | {
+    status: "curated";
+    commitId: string;
+} | {
+    status: "reflected";
+    commitId: string;
+} | {
+    status: "maintenance_done";
+    commitId: string;
+};
+export declare class EffectDispatcher {
+    private readonly leaseManager;
+    private readonly commitPort;
+    private readonly connectorExecutor;
+    private readonly checkpointPort;
+    private readonly memoryPort;
+    private readonly reflectionPort;
+    constructor(leaseManager: LeaseManager, commitPort: IntentCommitPort, connectorExecutor: ConnectorExecutor, checkpointPort: CheckpointPort, memoryPort: MemoryPort, reflectionPort: ReflectionPort);
+    dispatchEffect(intent: AllowedIntent, decision: DecisionContext): Promise<DispatchResult>;
+}
+export declare function buildDecisionContext(input: {
+    tickId: string;
+    decisionId?: string;
+    intentId: string;
+}): DecisionContext;