@haaaiawd/second-nature 0.1.8 → 0.1.10

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

@@ -0,0 +1,28 @@
+/**
+ * HeartbeatRuntimeSnapshot assembly for candidate planner + hard guards (T2.1.3, T2.2.1).
+ */
+import type { ContinuitySnapshot, ControlPlaneSourceRef } from "../types.js";
+import type { RhythmPolicy } from "../rhythm/rhythm-policy.js";
+import { type PlannerRhythmWindowSlice } from "../rhythm/planner-rhythm-window.js";
+import type { SnapshotInputs } from "./snapshot-builder.js";
+export interface PlannerLifeEvidenceSlice {
+    evidenceRefs: ControlPlaneSourceRef[];
+    platformEventCount: number;
+    workEventCount: number;
+    emptyReason?: "no_sources" | "state_unavailable" | "redacted_only";
+}
+export declare function isLifeEvidenceSliceEmpty(slice: PlannerLifeEvidenceSlice): boolean;
+export interface HardGuardDeps {
+    hasDuplicateIntent: (idempotencyKey: string) => boolean;
+    isOutreachCooldownClear: (idempotencyKey: string) => boolean;
+}
+export interface HeartbeatRuntimeSnapshot {
+    continuity: ContinuitySnapshot;
+    lifeEvidence: PlannerLifeEvidenceSlice;
+    rhythmWindow: PlannerRhythmWindowSlice;
+    hardGuards: HardGuardDeps;
+}
+export declare function buildLifeEvidenceSliceFromInputs(inputs: SnapshotInputs): PlannerLifeEvidenceSlice;
+export declare function buildHardGuardDeps(continuity: ContinuitySnapshot, inputs: SnapshotInputs): HardGuardDeps;
+export declare function resolveRhythmPolicyForHeartbeat(inputs: SnapshotInputs): RhythmPolicy;
+export declare function buildHeartbeatRuntimeSnapshot(timestamp: string, inputs: SnapshotInputs, continuity: ContinuitySnapshot): HeartbeatRuntimeSnapshot;

package/runtime/core/second-nature/heartbeat/runtime-snapshot.js

@@ -0,0 +1,35 @@
+import { rhythmPolicySnapshotToRhythmPolicy } from "../rhythm/policy-bridge.js";
+import { buildPlannerRhythmWindow } from "../rhythm/planner-rhythm-window.js";
+export function isLifeEvidenceSliceEmpty(slice) {
+    return slice.evidenceRefs.length === 0 && slice.platformEventCount === 0 && slice.workEventCount === 0;
+}
+export function buildLifeEvidenceSliceFromInputs(inputs) {
+    return {
+        evidenceRefs: inputs.lifeEvidenceRefs ?? [],
+        platformEventCount: inputs.platformEventCount ?? 0,
+        workEventCount: inputs.workEventCount ?? 0,
+        emptyReason: inputs.lifeEvidenceEmptyReason,
+    };
+}
+export function buildHardGuardDeps(continuity, inputs) {
+    return {
+        hasDuplicateIntent: (key) => (inputs.duplicateIntentKeys?.includes(key) ?? false) ||
+            continuity.deniedIntents.some((d) => d.reason === "duplicate_intent" && d.intentHash === key),
+        isOutreachCooldownClear: (key) => !(inputs.outreachCooldownKeys?.includes(key) ?? false),
+    };
+}
+export function resolveRhythmPolicyForHeartbeat(inputs) {
+    if (inputs.rhythmPolicy) {
+        return inputs.rhythmPolicy;
+    }
+    return rhythmPolicySnapshotToRhythmPolicy({
+        quietEnabled: inputs.quietEnabledBridge ?? false,
+    });
+}
+export function buildHeartbeatRuntimeSnapshot(timestamp, inputs, continuity) {
+    const policy = resolveRhythmPolicyForHeartbeat(inputs);
+    const rhythmWindow = buildPlannerRhythmWindow(timestamp, continuity, policy);
+    const lifeEvidence = buildLifeEvidenceSliceFromInputs(inputs);
+    const hardGuards = buildHardGuardDeps(continuity, inputs);
+    return { continuity, lifeEvidence, rhythmWindow, hardGuards };
+}

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

@@ -7,7 +7,11 @@
  */
 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";
+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;
@@ -23,10 +27,13 @@ export interface ScopedRuntimeInput {
     payload: Record<string, unknown>;
 }
 export interface HeartbeatCycleResult {
-    scope: "rhythm";
+    scope: RuntimeScope;
     status: HeartbeatCycleStatus;
     selectedIntentId?: string;
     reasons: string[];
+    decisionId?: string;
+    deliveryAttemptId?: string;
+    fallbackRef?: string;
 }
 export interface ScopeRouteResult {
     scope: RuntimeScope;

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

@@ -6,7 +6,10 @@
  *
  * Per design doc §4.2: SnapshotBuilder prepares inputs for the Rhythm Engine.
  */
-import type { ContinuitySnapshot, TopLevelMode } from "../types.js";
+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;
@@ -23,6 +26,21 @@ export interface SnapshotInputs {
     };
     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.

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

@@ -1,8 +1,10 @@
 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";
@@ -10,5 +12,11 @@ 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,8 +1,10 @@
 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";
@@ -10,5 +12,11 @@ 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

@@ -2,7 +2,7 @@ import type { ConnectorResult, CapabilityIntent } from "../../../connectors/base
 import { LeaseManager, type EffectClass } from "./lease-manager.js";
 export interface AllowedIntent {
     id: string;
-    kind: "work" | "exploration" | "social" | "reflection" | "outreach" | "maintenance";
+    kind: "work" | "exploration" | "social" | "quiet" | "reflection" | "outreach" | "maintenance";
     summary: string;
     effectClass: EffectClass;
     platformId?: string;

package/runtime/core/second-nature/orchestrator/effect-dispatcher.js

@@ -1,9 +1,12 @@
 import * as crypto from "crypto";
 function needsLease(effectClass) {
-    return effectClass === "external_platform_action" || effectClass === "user_outreach";
+    return effectClass === "external_platform_action" || effectClass === "connector_action" || effectClass === "user_outreach";
 }
 function needsCheckpoint(effectClass) {
-    return effectClass !== "maintenance";
+    return effectClass !== "maintenance" && effectClass !== "no_effect";
+}
+function isConnectorEffect(effectClass) {
+    return effectClass === "external_platform_action" || effectClass === "connector_action";
 }
 function toCapabilityIntent(intent) {
     if (intent.kind === "work")
@@ -14,6 +17,8 @@ function toCapabilityIntent(intent) {
         return "comment.reply";
     if (intent.kind === "outreach")
         return "message.send";
+    if (intent.kind === "quiet")
+        return "feed.read";
     return "feed.read";
 }
 export class EffectDispatcher {
@@ -43,7 +48,7 @@ export class EffectDispatcher {
                 id: decision.checkpointId,
                 tickId: decision.tickId,
                 intentId: decision.intentId,
-                phase: intent.effectClass === "external_platform_action" ? "before_effect" : "before_quiet_write",
+                phase: isConnectorEffect(intent.effectClass) ? "before_effect" : "before_quiet_write",
                 snapshotRef: decision.traceId,
             });
         }
@@ -54,7 +59,7 @@ export class EffectDispatcher {
             state: "planned",
         });
         try {
-            if (intent.effectClass === "external_platform_action") {
+            if (isConnectorEffect(intent.effectClass)) {
                 await this.commitPort.advanceIntentCommitState(commit.id, "dispatched");
                 const result = await this.connectorExecutor.executeEffect({
                     platformId: intent.platformId ?? "unknown",

package/runtime/core/second-nature/orchestrator/guard-layer.d.ts

@@ -1,2 +1,8 @@
 import type { CandidateIntent, ContinuitySnapshot, GuardEvaluation } from "../types.js";
+import type { HeartbeatRuntimeSnapshot } from "../heartbeat/runtime-snapshot.js";
+/**
+ * Hard guard evaluation (T2.1.3): source, dedupe, cooldown, quiet bias, budget, risk, awaiting user.
+ */
+export declare function evaluateHardGuards(intent: CandidateIntent, runtime: HeartbeatRuntimeSnapshot): GuardEvaluation;
+/** Continuity-only guard path for legacy call sites; builds a minimal runtime snapshot. */
 export declare function evaluateGuards(intent: CandidateIntent, snapshot: ContinuitySnapshot): GuardEvaluation;

package/runtime/core/second-nature/orchestrator/guard-layer.js

@@ -1,9 +1,7 @@
-function stableIntentHash(intent) {
-    return `${intent.kind}:${intent.summary}`;
-}
-function isDuplicateIntent(intent, snapshot) {
-    const hash = stableIntentHash(intent);
-    return snapshot.deniedIntents.some((item) => item.intentHash === hash && item.reason === "duplicate_intent");
+import { buildHeartbeatRuntimeSnapshot } from "../heartbeat/runtime-snapshot.js";
+const QUIET_DENY_KINDS = ["outreach", "social"];
+function intentFingerprint(intent) {
+    return intent.idempotencyKey ?? `${intent.kind}:${intent.summary}`;
 }
 function isBudgetExceeded(intent, snapshot) {
     if (intent.kind !== "social")
@@ -12,43 +10,101 @@ function isBudgetExceeded(intent, snapshot) {
         return false;
     return snapshot.budgets.socialUsed >= snapshot.budgets.socialLimit;
 }
-function isQuietSuppressed(intent, snapshot) {
-    if (snapshot.mode !== "quiet")
-        return false;
-    if (intent.effectClass === "maintenance" || intent.effectClass === "memory_curation" || intent.effectClass === "narrative_reflection") {
+function isQuietSuppressed(intent, runtime) {
+    if (!runtime.rhythmWindow.quietBias)
         return false;
+    if (QUIET_DENY_KINDS.includes(intent.kind)) {
+        return true;
+    }
+    if (intent.effectClass === "connector_action" || intent.effectClass === "external_platform_action") {
+        return true;
     }
-    return true;
+    return false;
 }
-export function evaluateGuards(intent, snapshot) {
+function isSourceBacked(intent) {
+    if (intent.sourceRefs.length > 0)
+        return true;
+    if (intent.effectClass === "maintenance" || intent.effectClass === "no_effect")
+        return true;
+    return false;
+}
+function isRiskBlocked(intent, snapshot) {
+    if (!snapshot.riskSuppressed)
+        return false;
+    return intent.kind === "exploration" || intent.kind === "social" || intent.kind === "outreach";
+}
+/**
+ * Hard guard evaluation (T2.1.3): source, dedupe, cooldown, quiet bias, budget, risk, awaiting user.
+ */
+export function evaluateHardGuards(intent, runtime) {
+    const snapshot = runtime.continuity;
     const reasons = [];
-    if (isDuplicateIntent(intent, snapshot)) {
+    if (!isSourceBacked(intent)) {
+        reasons.push("missing_source_refs");
+    }
+    const key = intentFingerprint(intent);
+    if (runtime.hardGuards.hasDuplicateIntent(key)) {
         reasons.push("duplicate_intent");
     }
+    if (intent.effectClass === "user_outreach" && !runtime.hardGuards.isOutreachCooldownClear(key)) {
+        reasons.push("outreach_cooldown");
+    }
+    if (isQuietSuppressed(intent, runtime)) {
+        reasons.push("quiet_window_suppression");
+    }
     if (isBudgetExceeded(intent, snapshot)) {
         reasons.push("budget_exceeded");
     }
-    if (isQuietSuppressed(intent, snapshot)) {
-        reasons.push("quiet_window");
-    }
     if (snapshot.awaitingUserInput) {
         reasons.push("awaiting_user");
     }
+    if (isRiskBlocked(intent, snapshot)) {
+        reasons.push("risk_suppressed");
+    }
     if (reasons.length === 0) {
         return {
             verdict: "allow",
-            reasons,
+            reasons: [],
             quietSuppressed: false,
-            leaseRequired: intent.effectClass === "external_platform_action" || intent.effectClass === "user_outreach",
-            requiresCheckpoint: intent.effectClass !== "maintenance",
+            leaseRequired: intent.effectClass === "external_platform_action" ||
+                intent.effectClass === "connector_action" ||
+                intent.effectClass === "user_outreach",
+            requiresCheckpoint: intent.effectClass !== "maintenance" && intent.effectClass !== "no_effect",
+        };
+    }
+    const duplicate = reasons.includes("duplicate_intent");
+    const cooldown = reasons.includes("outreach_cooldown");
+    if (duplicate || cooldown) {
+        return {
+            verdict: "defer",
+            reasons,
+            quietSuppressed: reasons.includes("quiet_window_suppression"),
+            leaseRequired: false,
+            requiresCheckpoint: false,
         };
     }
     const escalated = reasons.includes("awaiting_user") && intent.kind === "outreach";
     return {
         verdict: escalated ? "escalate" : "deny",
         reasons,
-        quietSuppressed: reasons.includes("quiet_window"),
+        quietSuppressed: reasons.includes("quiet_window_suppression"),
         leaseRequired: false,
         requiresCheckpoint: false,
     };
 }
+/** Continuity-only guard path for legacy call sites; builds a minimal runtime snapshot. */
+export function evaluateGuards(intent, snapshot) {
+    const inputs = {
+        mode: snapshot.mode,
+        currentWindowId: snapshot.currentWindowId,
+        pendingObligations: snapshot.pendingObligations,
+        recentOutreachHashes: snapshot.recentOutreachHashes,
+        deniedIntents: snapshot.deniedIntents,
+        budgets: snapshot.budgets,
+        awaitingUserInput: snapshot.awaitingUserInput,
+        riskSuppressed: snapshot.riskSuppressed,
+        quietEnabledBridge: snapshot.mode === "quiet",
+    };
+    const runtime = buildHeartbeatRuntimeSnapshot("2026-03-25T12:00:00.000Z", inputs, snapshot);
+    return evaluateHardGuards(intent, runtime);
+}

package/runtime/core/second-nature/orchestrator/intent-planner.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Candidate intent planner (T2.1.3): window-biased planning + priority cap.
+ * `planCandidateIntents` is the contract name; `planIntent` bridges legacy continuity-only tests.
+ */
 import type { CandidateIntent, ContinuitySnapshot, DecisionBasis } from "../types.js";
+import type { HeartbeatRuntimeSnapshot } from "../heartbeat/runtime-snapshot.js";
+/**
+ * Plan ordered candidates for one heartbeat turn using rhythm window + life evidence slice.
+ */
+export declare function planCandidateIntents(runtime: HeartbeatRuntimeSnapshot): CandidateIntent[];
+/** @deprecated Continuity-only helper for tests; prefer `planCandidateIntents` + `buildHeartbeatRuntimeSnapshot`. */
 export declare function planIntent(snapshot: ContinuitySnapshot): CandidateIntent[];
 export declare function decideDecisionBasis(intent: CandidateIntent): DecisionBasis;

package/runtime/core/second-nature/orchestrator/intent-planner.js

@@ -1,16 +1,45 @@
-const MAX_CANDIDATES = 6;
-function planObligationIntents(snapshot) {
-    return snapshot.pendingObligations.map((obligation, index) => ({
+import { isLifeEvidenceSliceEmpty } from "../heartbeat/runtime-snapshot.js";
+import { buildHeartbeatRuntimeSnapshot } from "../heartbeat/runtime-snapshot.js";
+const MAX_CANDIDATE_INTENTS = 6;
+const OBLIGATION_SOURCE = [
+    { id: "obligation-anchor", kind: "workspace_artifact", uri: "workspace://obligations/pending" },
+];
+function evidenceRefsForConnector(runtime) {
+    if (!isLifeEvidenceSliceEmpty(runtime.lifeEvidence) && runtime.lifeEvidence.evidenceRefs.length > 0) {
+        return runtime.lifeEvidence.evidenceRefs.slice(0, 8);
+    }
+    if (!isLifeEvidenceSliceEmpty(runtime.lifeEvidence)) {
+        return [
+            {
+                id: "life-evidence-summary",
+                kind: "connector_result",
+                uri: `workspace://life-evidence/counts/${runtime.lifeEvidence.platformEventCount}/${runtime.lifeEvidence.workEventCount}`,
+            },
+        ];
+    }
+    return [];
+}
+function isAllowedKind(kind, runtime) {
+    return runtime.rhythmWindow.allowedIntentKinds.includes(kind);
+}
+function planWorkIntents(runtime) {
+    if (!isAllowedKind("work", runtime))
+        return [];
+    return runtime.continuity.pendingObligations.map((obligation, index) => ({
         id: `intent-obligation-${index}`,
         kind: "work",
         priority: 100 - index,
         source: "obligation",
         summary: `fulfill obligation: ${obligation}`,
-        effectClass: "external_platform_action",
+        effectClass: "connector_action",
+        sourceRefs: [...OBLIGATION_SOURCE],
+        idempotencyKey: `obligation:${obligation}:${index}`,
     }));
 }
-function planPlatformIntents(snapshot) {
-    const socialPriorityBase = snapshot.budgets && snapshot.budgets.socialUsed >= snapshot.budgets.socialLimit ? 10 : 60;
+function planExplorationIntents(runtime) {
+    if (!isAllowedKind("exploration", runtime))
+        return [];
+    const refs = evidenceRefsForConnector(runtime);
     return [
         {
             id: "intent-exploration",
@@ -18,45 +47,80 @@ function planPlatformIntents(snapshot) {
             priority: 70,
             source: "tick",
             summary: "scan platform opportunities",
-            effectClass: "external_platform_action",
+            effectClass: "connector_action",
+            sourceRefs: refs,
+            idempotencyKey: "exploration:scan platform opportunities",
         },
+    ];
+}
+function planSocialIntents(runtime) {
+    if (!isAllowedKind("social", runtime))
+        return [];
+    const refs = evidenceRefsForConnector(runtime);
+    return [
         {
             id: "intent-social",
             kind: "social",
-            priority: socialPriorityBase,
+            priority: runtime.continuity.budgets && runtime.continuity.budgets.socialUsed >= runtime.continuity.budgets.socialLimit ? 10 : 60,
             source: "tick",
             summary: "engage social platforms",
-            effectClass: "external_platform_action",
+            effectClass: "connector_action",
+            sourceRefs: refs,
+            idempotencyKey: "social:engage social platforms",
         },
     ];
 }
-function planQuietIntents(snapshot) {
-    if (snapshot.mode !== "quiet") {
+function planQuietReflectionIntents(runtime) {
+    if (!runtime.rhythmWindow.quietBias && runtime.continuity.mode !== "quiet") {
         return [];
     }
-    return [
-        {
+    const out = [];
+    if (isAllowedKind("quiet", runtime)) {
+        out.push({
+            id: "intent-quiet",
+            kind: "quiet",
+            priority: 55,
+            source: "quiet_plan",
+            summary: "quiet window bookkeeping",
+            effectClass: "no_effect",
+            sourceRefs: [],
+            idempotencyKey: "quiet:bookkeeping",
+        });
+    }
+    if (isAllowedKind("maintenance", runtime)) {
+        out.push({
             id: "intent-maintenance",
             kind: "maintenance",
-            priority: 90,
+            priority: 50,
             source: "quiet_plan",
             summary: "run maintenance checks",
             effectClass: "maintenance",
-        },
-        {
+            sourceRefs: [],
+            idempotencyKey: "maintenance:checks",
+        });
+    }
+    if (isAllowedKind("reflection", runtime)) {
+        const refs = evidenceRefsForConnector(runtime);
+        out.push({
             id: "intent-reflection",
             kind: "reflection",
-            priority: 80,
+            priority: 45,
             source: "quiet_plan",
             summary: "run narrative reflection",
             effectClass: "narrative_reflection",
-        },
-    ];
+            sourceRefs: refs,
+            idempotencyKey: "reflection:narrative",
+        });
+    }
+    return out;
 }
-function planOutreachIntents(snapshot) {
-    if (snapshot.recentOutreachHashes.length > 3) {
+function planOutreachIntents(runtime) {
+    if (!isAllowedKind("outreach", runtime))
+        return [];
+    if (runtime.continuity.recentOutreachHashes.length > 3) {
         return [];
     }
+    const refs = evidenceRefsForConnector(runtime);
     return [
         {
             id: "intent-outreach",
@@ -65,24 +129,67 @@ function planOutreachIntents(snapshot) {
             source: "tick",
             summary: "consider proactive user outreach",
             effectClass: "user_outreach",
+            sourceRefs: refs,
+            idempotencyKey: "outreach:consider proactive user outreach",
         },
     ];
 }
-export function planIntent(snapshot) {
+/**
+ * Plan ordered candidates for one heartbeat turn using rhythm window + life evidence slice.
+ */
+export function planCandidateIntents(runtime) {
+    if (runtime.continuity.mode === "paused_for_interrupt") {
+        const pausedMaintenance = [
+            {
+                id: "intent-maintenance",
+                kind: "maintenance",
+                priority: 40,
+                source: "tick",
+                summary: "run maintenance checks",
+                effectClass: "maintenance",
+                sourceRefs: [],
+                idempotencyKey: "maintenance:checks",
+            },
+        ];
+        return pausedMaintenance
+            .filter((intent) => runtime.rhythmWindow.allowedIntentKinds.includes(intent.kind))
+            .slice(0, MAX_CANDIDATE_INTENTS);
+    }
+    if (runtime.continuity.mode === "maintenance_only") {
+        return planWorkIntents(runtime).sort((a, b) => b.priority - a.priority).slice(0, MAX_CANDIDATE_INTENTS);
+    }
     const intents = [
-        ...planObligationIntents(snapshot),
-        ...planPlatformIntents(snapshot),
-        ...planQuietIntents(snapshot),
-        ...planOutreachIntents(snapshot),
+        ...planWorkIntents(runtime),
+        ...planExplorationIntents(runtime),
+        ...planSocialIntents(runtime),
+        ...planQuietReflectionIntents(runtime),
+        ...planOutreachIntents(runtime),
     ];
     return intents
+        .filter((intent) => runtime.rhythmWindow.allowedIntentKinds.includes(intent.kind))
         .sort((a, b) => b.priority - a.priority)
-        .slice(0, MAX_CANDIDATES);
+        .slice(0, MAX_CANDIDATE_INTENTS);
+}
+/** @deprecated Continuity-only helper for tests; prefer `planCandidateIntents` + `buildHeartbeatRuntimeSnapshot`. */
+export function planIntent(snapshot) {
+    const inputs = {
+        mode: snapshot.mode,
+        currentWindowId: snapshot.currentWindowId,
+        pendingObligations: snapshot.pendingObligations,
+        recentOutreachHashes: snapshot.recentOutreachHashes,
+        deniedIntents: snapshot.deniedIntents,
+        budgets: snapshot.budgets,
+        awaitingUserInput: snapshot.awaitingUserInput,
+        riskSuppressed: snapshot.riskSuppressed,
+        quietEnabledBridge: snapshot.mode === "quiet",
+    };
+    const runtime = buildHeartbeatRuntimeSnapshot("2026-03-25T12:00:00.000Z", inputs, snapshot);
+    return planCandidateIntents(runtime);
 }
 export function decideDecisionBasis(intent) {
     if (intent.source === "obligation")
         return "rule_only";
-    if (intent.kind === "maintenance")
+    if (intent.effectClass === "maintenance" || intent.effectClass === "no_effect")
         return "rule_only";
     if (intent.kind === "outreach" || intent.kind === "reflection")
         return "model_assisted";

package/runtime/core/second-nature/orchestrator/lease-manager.d.ts

@@ -1,4 +1,4 @@
-export type EffectClass = "external_platform_action" | "memory_curation" | "narrative_reflection" | "user_outreach" | "maintenance";
+export type EffectClass = "external_platform_action" | "connector_action" | "memory_curation" | "narrative_reflection" | "user_outreach" | "maintenance" | "no_effect";
 export interface LeaseHandle {
     id: string;
     granted: boolean;

package/runtime/core/second-nature/orchestrator/lease-manager.js

@@ -50,7 +50,7 @@ export class LeaseManager {
         };
     }
     resolveScope(effectClass, scopeHint) {
-        if (effectClass === "external_platform_action" || effectClass === "user_outreach") {
+        if (effectClass === "external_platform_action" || effectClass === "connector_action" || effectClass === "user_outreach") {
             return scopeHint && scopeHint.length > 0 ? `${GLOBAL_SCOPE}:${scopeHint}` : GLOBAL_SCOPE;
         }
         return null;

package/runtime/core/second-nature/outreach/build-outreach-draft-request.d.ts

@@ -0,0 +1,6 @@
+import type { OutreachDraftRequest } from "../../../guidance/outreach-draft-schema.js";
+import type { CandidateIntent } from "../types.js";
+import type { HeartbeatRuntimeSnapshot } from "../heartbeat/runtime-snapshot.js";
+import type { OutreachJudgment } from "./judge-outreach.js";
+import type { DeliveryTargetResolution } from "./delivery-target.js";
+export declare function buildOutreachDraftRequest(candidate: CandidateIntent, judgment: OutreachJudgment, snapshot: HeartbeatRuntimeSnapshot, delivery: DeliveryTargetResolution): OutreachDraftRequest;