@haaaiawd/second-nature 0.1.16 → 0.1.18

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

@@ -1,110 +1,110 @@
-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")
-        return false;
-    if (!snapshot.budgets)
-        return false;
-    return snapshot.budgets.socialUsed >= snapshot.budgets.socialLimit;
-}
-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 false;
-}
-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 (!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 (snapshot.awaitingUserInput) {
-        reasons.push("awaiting_user");
-    }
-    if (isRiskBlocked(intent, snapshot)) {
-        reasons.push("risk_suppressed");
-    }
-    if (reasons.length === 0) {
-        return {
-            verdict: "allow",
-            reasons: [],
-            quietSuppressed: false,
-            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_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);
-}
+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")
+        return false;
+    if (!snapshot.budgets)
+        return false;
+    return snapshot.budgets.socialUsed >= snapshot.budgets.socialLimit;
+}
+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 false;
+}
+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 (!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 (snapshot.awaitingUserInput) {
+        reasons.push("awaiting_user");
+    }
+    if (isRiskBlocked(intent, snapshot)) {
+        reasons.push("risk_suppressed");
+    }
+    if (reasons.length === 0) {
+        return {
+            verdict: "allow",
+            reasons: [],
+            quietSuppressed: false,
+            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_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,13 +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;
+/**
+ * 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,199 +1,199 @@
-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: "connector_action",
-        sourceRefs: [...OBLIGATION_SOURCE],
-        idempotencyKey: `obligation:${obligation}:${index}`,
-    }));
-}
-function planExplorationIntents(runtime) {
-    if (!isAllowedKind("exploration", runtime))
-        return [];
-    const refs = evidenceRefsForConnector(runtime);
-    return [
-        {
-            id: "intent-exploration",
-            kind: "exploration",
-            priority: 70,
-            source: "tick",
-            summary: "scan platform opportunities",
-            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: runtime.continuity.budgets && runtime.continuity.budgets.socialUsed >= runtime.continuity.budgets.socialLimit ? 10 : 60,
-            source: "tick",
-            summary: "engage social platforms",
-            effectClass: "connector_action",
-            sourceRefs: refs,
-            idempotencyKey: "social:engage social platforms",
-        },
-    ];
-}
-function planQuietReflectionIntents(runtime) {
-    if (!runtime.rhythmWindow.quietBias && runtime.continuity.mode !== "quiet") {
-        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: 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: 45,
-            source: "quiet_plan",
-            summary: "run narrative reflection",
-            effectClass: "narrative_reflection",
-            sourceRefs: refs,
-            idempotencyKey: "reflection:narrative",
-        });
-    }
-    return out;
-}
-function planOutreachIntents(runtime) {
-    if (!isAllowedKind("outreach", runtime))
-        return [];
-    if (runtime.continuity.recentOutreachHashes.length > 3) {
-        return [];
-    }
-    const refs = evidenceRefsForConnector(runtime);
-    return [
-        {
-            id: "intent-outreach",
-            kind: "outreach",
-            priority: 40,
-            source: "tick",
-            summary: "consider proactive user outreach",
-            effectClass: "user_outreach",
-            sourceRefs: refs,
-            idempotencyKey: "outreach:consider proactive user outreach",
-        },
-    ];
-}
-/**
- * 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 = [
-        ...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_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.effectClass === "maintenance" || intent.effectClass === "no_effect")
-        return "rule_only";
-    if (intent.kind === "outreach" || intent.kind === "reflection")
-        return "model_assisted";
-    if (intent.kind === "exploration" || intent.kind === "social" || intent.kind === "work")
-        return "score_based";
-    return "rule_only";
-}
+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: "connector_action",
+        sourceRefs: [...OBLIGATION_SOURCE],
+        idempotencyKey: `obligation:${obligation}:${index}`,
+    }));
+}
+function planExplorationIntents(runtime) {
+    if (!isAllowedKind("exploration", runtime))
+        return [];
+    const refs = evidenceRefsForConnector(runtime);
+    return [
+        {
+            id: "intent-exploration",
+            kind: "exploration",
+            priority: 70,
+            source: "tick",
+            summary: "scan platform opportunities",
+            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: runtime.continuity.budgets && runtime.continuity.budgets.socialUsed >= runtime.continuity.budgets.socialLimit ? 10 : 60,
+            source: "tick",
+            summary: "engage social platforms",
+            effectClass: "connector_action",
+            sourceRefs: refs,
+            idempotencyKey: "social:engage social platforms",
+        },
+    ];
+}
+function planQuietReflectionIntents(runtime) {
+    if (!runtime.rhythmWindow.quietBias && runtime.continuity.mode !== "quiet") {
+        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: 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: 45,
+            source: "quiet_plan",
+            summary: "run narrative reflection",
+            effectClass: "narrative_reflection",
+            sourceRefs: refs,
+            idempotencyKey: "reflection:narrative",
+        });
+    }
+    return out;
+}
+function planOutreachIntents(runtime) {
+    if (!isAllowedKind("outreach", runtime))
+        return [];
+    if (runtime.continuity.recentOutreachHashes.length > 3) {
+        return [];
+    }
+    const refs = evidenceRefsForConnector(runtime);
+    return [
+        {
+            id: "intent-outreach",
+            kind: "outreach",
+            priority: 40,
+            source: "tick",
+            summary: "consider proactive user outreach",
+            effectClass: "user_outreach",
+            sourceRefs: refs,
+            idempotencyKey: "outreach:consider proactive user outreach",
+        },
+    ];
+}
+/**
+ * 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 = [
+        ...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_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.effectClass === "maintenance" || intent.effectClass === "no_effect")
+        return "rule_only";
+    if (intent.kind === "outreach" || intent.kind === "reflection")
+        return "model_assisted";
+    if (intent.kind === "exploration" || intent.kind === "social" || intent.kind === "work")
+        return "score_based";
+    return "rule_only";
+}