@haaaiawd/second-nature 0.1.18 → 0.1.20

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

@@ -1,144 +1,144 @@
-import * as crypto from "crypto";
-function needsLease(effectClass) {
-    return effectClass === "external_platform_action" || effectClass === "connector_action" || effectClass === "user_outreach";
-}
-function needsCheckpoint(effectClass) {
-    return effectClass !== "maintenance" && effectClass !== "no_effect";
-}
-function isConnectorEffect(effectClass) {
-    return effectClass === "external_platform_action" || effectClass === "connector_action";
-}
-function toCapabilityIntent(intent) {
-    if (intent.kind === "work")
-        return "work.discover";
-    if (intent.kind === "exploration")
-        return "feed.read";
-    if (intent.kind === "social")
-        return "comment.reply";
-    if (intent.kind === "outreach")
-        return "message.send";
-    if (intent.kind === "quiet")
-        return "feed.read";
-    return "feed.read";
-}
-export class EffectDispatcher {
-    leaseManager;
-    commitPort;
-    connectorExecutor;
-    checkpointPort;
-    memoryPort;
-    reflectionPort;
-    constructor(leaseManager, commitPort, connectorExecutor, checkpointPort, memoryPort, reflectionPort) {
-        this.leaseManager = leaseManager;
-        this.commitPort = commitPort;
-        this.connectorExecutor = connectorExecutor;
-        this.checkpointPort = checkpointPort;
-        this.memoryPort = memoryPort;
-        this.reflectionPort = reflectionPort;
-    }
-    async dispatchEffect(intent, decision) {
-        const lease = needsLease(intent.effectClass)
-            ? await this.leaseManager.acquire(intent.effectClass, intent.platformId ?? intent.id)
-            : await this.leaseManager.acquire("maintenance");
-        if (!lease.granted) {
-            return { status: "deferred", reason: "lease_unavailable" };
-        }
-        if (needsCheckpoint(intent.effectClass)) {
-            await this.checkpointPort.saveCheckpoint({
-                id: decision.checkpointId,
-                tickId: decision.tickId,
-                intentId: decision.intentId,
-                phase: isConnectorEffect(intent.effectClass) ? "before_effect" : "before_quiet_write",
-                snapshotRef: decision.traceId,
-            });
-        }
-        const commit = await this.commitPort.createIntentCommitRecord({
-            intentId: decision.intentId,
-            decisionId: decision.decisionId,
-            checkpointId: decision.checkpointId,
-            state: "planned",
-        });
-        try {
-            if (isConnectorEffect(intent.effectClass)) {
-                await this.commitPort.advanceIntentCommitState(commit.id, "dispatched");
-                const result = await this.connectorExecutor.executeEffect({
-                    platformId: intent.platformId ?? "unknown",
-                    intent: toCapabilityIntent(intent),
-                    payload: intent.payload ?? {},
-                    decisionId: decision.decisionId,
-                    intentId: decision.intentId,
-                    idempotencyKey: `idem:${decision.decisionId}:${decision.intentId}`,
-                });
-                if (result.status === "success") {
-                    await this.commitPort.advanceIntentCommitState(commit.id, "externally_acknowledged", {
-                        outcomeRef: result.metadata.platformId,
-                    });
-                    await this.commitPort.commitIntentOutcome(commit.id, {
-                        traceId: decision.traceId,
-                        outcomeRef: result.metadata.platformId,
-                    });
-                }
-                else {
-                    if (result.status === "retryable_failure") {
-                        await this.commitPort.advanceIntentCommitState(commit.id, "reconcile", {
-                            failureClass: result.failureClass,
-                        });
-                    }
-                    else {
-                        await this.commitPort.abortIntentCommit(commit.id, result.failureClass ?? "external_effect_failed");
-                    }
-                }
-                return { status: "effect_executed", result, commitId: commit.id };
-            }
-            if (intent.effectClass === "memory_curation") {
-                await this.commitPort.advanceIntentCommitState(commit.id, "dispatched");
-                await this.memoryPort.persistCurationResult({
-                    summary: intent.summary,
-                    sourceRefs: [decision.traceId],
-                    traceId: decision.traceId,
-                });
-                await this.commitPort.commitIntentOutcome(commit.id, {
-                    traceId: decision.traceId,
-                    outcomeRef: "memory_curation",
-                });
-                return { status: "curated", commitId: commit.id };
-            }
-            if (intent.effectClass === "narrative_reflection") {
-                await this.commitPort.advanceIntentCommitState(commit.id, "dispatched");
-                const reflection = await this.reflectionPort.runNarrativeReflection({
-                    decisionId: decision.decisionId,
-                    intentId: decision.intentId,
-                    traceId: decision.traceId,
-                });
-                await this.commitPort.commitIntentOutcome(commit.id, {
-                    traceId: decision.traceId,
-                    outcomeRef: reflection.outcomeRef,
-                });
-                return { status: "reflected", commitId: commit.id };
-            }
-            await this.commitPort.advanceIntentCommitState(commit.id, "dispatched");
-            await this.commitPort.commitIntentOutcome(commit.id, {
-                traceId: decision.traceId,
-                outcomeRef: "maintenance",
-            });
-            return { status: "maintenance_done", commitId: commit.id };
-        }
-        catch (error) {
-            await this.commitPort.abortIntentCommit(commit.id, String(error));
-            throw error;
-        }
-        finally {
-            await lease.release();
-        }
-    }
-}
-export function buildDecisionContext(input) {
-    const decisionId = input.decisionId ?? crypto.randomUUID();
-    return {
-        decisionId,
-        intentId: input.intentId,
-        tickId: input.tickId,
-        checkpointId: `checkpoint:${input.intentId}:${Date.now()}`,
-        traceId: `trace:${decisionId}`,
-    };
-}
+import * as crypto from "crypto";
+function needsLease(effectClass) {
+    return effectClass === "external_platform_action" || effectClass === "connector_action" || effectClass === "user_outreach";
+}
+function needsCheckpoint(effectClass) {
+    return effectClass !== "maintenance" && effectClass !== "no_effect";
+}
+function isConnectorEffect(effectClass) {
+    return effectClass === "external_platform_action" || effectClass === "connector_action";
+}
+function toCapabilityIntent(intent) {
+    if (intent.kind === "work")
+        return "work.discover";
+    if (intent.kind === "exploration")
+        return "feed.read";
+    if (intent.kind === "social")
+        return "comment.reply";
+    if (intent.kind === "outreach")
+        return "message.send";
+    if (intent.kind === "quiet")
+        return "feed.read";
+    return "feed.read";
+}
+export class EffectDispatcher {
+    leaseManager;
+    commitPort;
+    connectorExecutor;
+    checkpointPort;
+    memoryPort;
+    reflectionPort;
+    constructor(leaseManager, commitPort, connectorExecutor, checkpointPort, memoryPort, reflectionPort) {
+        this.leaseManager = leaseManager;
+        this.commitPort = commitPort;
+        this.connectorExecutor = connectorExecutor;
+        this.checkpointPort = checkpointPort;
+        this.memoryPort = memoryPort;
+        this.reflectionPort = reflectionPort;
+    }
+    async dispatchEffect(intent, decision) {
+        const lease = needsLease(intent.effectClass)
+            ? await this.leaseManager.acquire(intent.effectClass, intent.platformId ?? intent.id)
+            : await this.leaseManager.acquire("maintenance");
+        if (!lease.granted) {
+            return { status: "deferred", reason: "lease_unavailable" };
+        }
+        if (needsCheckpoint(intent.effectClass)) {
+            await this.checkpointPort.saveCheckpoint({
+                id: decision.checkpointId,
+                tickId: decision.tickId,
+                intentId: decision.intentId,
+                phase: isConnectorEffect(intent.effectClass) ? "before_effect" : "before_quiet_write",
+                snapshotRef: decision.traceId,
+            });
+        }
+        const commit = await this.commitPort.createIntentCommitRecord({
+            intentId: decision.intentId,
+            decisionId: decision.decisionId,
+            checkpointId: decision.checkpointId,
+            state: "planned",
+        });
+        try {
+            if (isConnectorEffect(intent.effectClass)) {
+                await this.commitPort.advanceIntentCommitState(commit.id, "dispatched");
+                const result = await this.connectorExecutor.executeEffect({
+                    platformId: intent.platformId ?? "unknown",
+                    intent: toCapabilityIntent(intent),
+                    payload: intent.payload ?? {},
+                    decisionId: decision.decisionId,
+                    intentId: decision.intentId,
+                    idempotencyKey: `idem:${decision.decisionId}:${decision.intentId}`,
+                });
+                if (result.status === "success") {
+                    await this.commitPort.advanceIntentCommitState(commit.id, "externally_acknowledged", {
+                        outcomeRef: result.metadata.platformId,
+                    });
+                    await this.commitPort.commitIntentOutcome(commit.id, {
+                        traceId: decision.traceId,
+                        outcomeRef: result.metadata.platformId,
+                    });
+                }
+                else {
+                    if (result.status === "retryable_failure") {
+                        await this.commitPort.advanceIntentCommitState(commit.id, "reconcile", {
+                            failureClass: result.failureClass,
+                        });
+                    }
+                    else {
+                        await this.commitPort.abortIntentCommit(commit.id, result.failureClass ?? "external_effect_failed");
+                    }
+                }
+                return { status: "effect_executed", result, commitId: commit.id };
+            }
+            if (intent.effectClass === "memory_curation") {
+                await this.commitPort.advanceIntentCommitState(commit.id, "dispatched");
+                await this.memoryPort.persistCurationResult({
+                    summary: intent.summary,
+                    sourceRefs: [decision.traceId],
+                    traceId: decision.traceId,
+                });
+                await this.commitPort.commitIntentOutcome(commit.id, {
+                    traceId: decision.traceId,
+                    outcomeRef: "memory_curation",
+                });
+                return { status: "curated", commitId: commit.id };
+            }
+            if (intent.effectClass === "narrative_reflection") {
+                await this.commitPort.advanceIntentCommitState(commit.id, "dispatched");
+                const reflection = await this.reflectionPort.runNarrativeReflection({
+                    decisionId: decision.decisionId,
+                    intentId: decision.intentId,
+                    traceId: decision.traceId,
+                });
+                await this.commitPort.commitIntentOutcome(commit.id, {
+                    traceId: decision.traceId,
+                    outcomeRef: reflection.outcomeRef,
+                });
+                return { status: "reflected", commitId: commit.id };
+            }
+            await this.commitPort.advanceIntentCommitState(commit.id, "dispatched");
+            await this.commitPort.commitIntentOutcome(commit.id, {
+                traceId: decision.traceId,
+                outcomeRef: "maintenance",
+            });
+            return { status: "maintenance_done", commitId: commit.id };
+        }
+        catch (error) {
+            await this.commitPort.abortIntentCommit(commit.id, String(error));
+            throw error;
+        }
+        finally {
+            await lease.release();
+        }
+    }
+}
+export function buildDecisionContext(input) {
+    const decisionId = input.decisionId ?? crypto.randomUUID();
+    return {
+        decisionId,
+        intentId: input.intentId,
+        tickId: input.tickId,
+        checkpointId: `checkpoint:${input.intentId}:${Date.now()}`,
+        traceId: `trace:${decisionId}`,
+    };
+}

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

@@ -1,8 +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;
+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,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;