@haaaiawd/second-nature 0.1.16 → 0.1.18

package/runtime/core/second-nature/outreach/judge-outreach.js

@@ -1,121 +1,121 @@
-/**
- * Control-plane outreach judgment (T2.3.1): value / interest / actionability / delivery / dedupe.
- *
- * Does not call guidance or perform delivery; callers supply guard-derived cooldown/duplicate flags.
- * Test coverage: tests/unit/core/outreach-judgment.test.ts
- */
-import * as crypto from "node:crypto";
-import { isDeliveryUnavailableReason, resolveDeliveryTarget, } from "./delivery-target.js";
-const OUTREACH_POLICY = {
-    minValueScore: 0.35,
-    minUserRelevance: 0.4,
-    minActionabilityWhenInterestLow: 0.7,
-};
-function tokenize(text) {
-    return text
-        .toLowerCase()
-        .split(/[^a-z0-9\u4e00-\u9fff]+/g)
-        .filter((t) => t.length > 1);
-}
-function signalMatchesSummary(sig, summary) {
-    const s = summary.toLowerCase();
-    const t = sig.topic.toLowerCase();
-    if (t.length > 0 && s.includes(t))
-        return true;
-    const wt = tokenize(sig.topic);
-    const ws = new Set(tokenize(summary));
-    return wt.some((x) => ws.has(x));
-}
-function matchInterestRefs(candidate, interest) {
-    const matched = [];
-    for (const sig of interest.signals) {
-        if (signalMatchesSummary(sig, candidate.summary)) {
-            matched.push(...sig.sourceRefs);
-        }
-    }
-    const byId = new Map();
-    for (const ref of matched) {
-        byId.set(ref.id, ref);
-    }
-    return [...byId.values()];
-}
-function scoreOutreachValue(candidate, life) {
-    if (candidate.sourceRefs.length === 0)
-        return 0;
-    const base = 0.35 + Math.min(0.35, candidate.sourceRefs.length * 0.06) + Math.min(0.2, candidate.priority * 0.02);
-    if (life.empty)
-        return Math.max(0, base - 0.15);
-    return Math.min(1, base + Math.min(0.1, life.evidenceRefCount * 0.01));
-}
-function scoreUserRelevance(candidate, interest) {
-    if (interest.staleness === "insufficient") {
-        return Math.min(0.35, interest.confidence);
-    }
-    const refs = matchInterestRefs(candidate, interest);
-    if (refs.length === 0)
-        return interest.confidence * 0.45;
-    return Math.min(1, interest.confidence * 0.65 + refs.length * 0.08);
-}
-function scoreActionability(candidate, interest, matchedInterestRefCount) {
-    if (candidate.effectClass !== "user_outreach")
-        return 0.5;
-    if (interest.staleness === "insufficient" && matchedInterestRefCount === 0)
-        return 0.55;
-    return 0.78;
-}
-function resolveCooldownState(input) {
-    if (input.duplicateBlocked)
-        return "duplicate";
-    if (input.cooldownBlocked)
-        return "cooling_down";
-    return "clear";
-}
-export function judgeOutreach(input) {
-    const decisionId = `outreach_judgment:${crypto.randomUUID()}`;
-    const deliveryResolution = resolveDeliveryTarget(input.delivery);
-    const interestRefs = matchInterestRefs(input.candidate, input.userInterest);
-    const valueScore = scoreOutreachValue(input.candidate, input.lifeEvidence);
-    const userRelevance = scoreUserRelevance(input.candidate, input.userInterest);
-    const actionability = scoreActionability(input.candidate, input.userInterest, interestRefs.length);
-    const cooldownState = resolveCooldownState(input);
-    const reasons = [];
-    if (input.candidate.sourceRefs.length === 0)
-        reasons.push("missing_source_refs");
-    if (valueScore < OUTREACH_POLICY.minValueScore)
-        reasons.push("value_score_too_low");
-    if (userRelevance < OUTREACH_POLICY.minUserRelevance &&
-        actionability < OUTREACH_POLICY.minActionabilityWhenInterestLow) {
-        reasons.push("not_interest_relevant_or_actionable");
-    }
-    if (cooldownState === "cooling_down")
-        reasons.push("cooling_down");
-    if (cooldownState === "duplicate")
-        reasons.push("duplicate");
-    if (deliveryResolution.verdict !== "target_available") {
-        reasons.push(deliveryResolution.verdict);
-    }
-    const blockingReasons = reasons.filter((r) => !isDeliveryUnavailableReason(r));
-    let verdict;
-    if (blockingReasons.length === 0) {
-        verdict = "allow";
-    }
-    else if (blockingReasons.includes("cooling_down") || blockingReasons.includes("duplicate")) {
-        verdict = "defer";
-    }
-    else {
-        verdict = "deny";
-    }
-    return {
-        decisionId,
-        candidateId: input.candidate.id,
-        verdict,
-        valueScore,
-        userRelevance,
-        actionability,
-        interestRefs,
-        sourceRefs: input.candidate.sourceRefs,
-        cooldownState,
-        deliveryVerdict: deliveryResolution.verdict,
-        reasons: reasons.length === 0 ? ["outreach_allowed"] : reasons,
-    };
-}
+/**
+ * Control-plane outreach judgment (T2.3.1): value / interest / actionability / delivery / dedupe.
+ *
+ * Does not call guidance or perform delivery; callers supply guard-derived cooldown/duplicate flags.
+ * Test coverage: tests/unit/core/outreach-judgment.test.ts
+ */
+import * as crypto from "node:crypto";
+import { isDeliveryUnavailableReason, resolveDeliveryTarget, } from "./delivery-target.js";
+const OUTREACH_POLICY = {
+    minValueScore: 0.35,
+    minUserRelevance: 0.4,
+    minActionabilityWhenInterestLow: 0.7,
+};
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^a-z0-9\u4e00-\u9fff]+/g)
+        .filter((t) => t.length > 1);
+}
+function signalMatchesSummary(sig, summary) {
+    const s = summary.toLowerCase();
+    const t = sig.topic.toLowerCase();
+    if (t.length > 0 && s.includes(t))
+        return true;
+    const wt = tokenize(sig.topic);
+    const ws = new Set(tokenize(summary));
+    return wt.some((x) => ws.has(x));
+}
+function matchInterestRefs(candidate, interest) {
+    const matched = [];
+    for (const sig of interest.signals) {
+        if (signalMatchesSummary(sig, candidate.summary)) {
+            matched.push(...sig.sourceRefs);
+        }
+    }
+    const byId = new Map();
+    for (const ref of matched) {
+        byId.set(ref.id, ref);
+    }
+    return [...byId.values()];
+}
+function scoreOutreachValue(candidate, life) {
+    if (candidate.sourceRefs.length === 0)
+        return 0;
+    const base = 0.35 + Math.min(0.35, candidate.sourceRefs.length * 0.06) + Math.min(0.2, candidate.priority * 0.02);
+    if (life.empty)
+        return Math.max(0, base - 0.15);
+    return Math.min(1, base + Math.min(0.1, life.evidenceRefCount * 0.01));
+}
+function scoreUserRelevance(candidate, interest) {
+    if (interest.staleness === "insufficient") {
+        return Math.min(0.35, interest.confidence);
+    }
+    const refs = matchInterestRefs(candidate, interest);
+    if (refs.length === 0)
+        return interest.confidence * 0.45;
+    return Math.min(1, interest.confidence * 0.65 + refs.length * 0.08);
+}
+function scoreActionability(candidate, interest, matchedInterestRefCount) {
+    if (candidate.effectClass !== "user_outreach")
+        return 0.5;
+    if (interest.staleness === "insufficient" && matchedInterestRefCount === 0)
+        return 0.55;
+    return 0.78;
+}
+function resolveCooldownState(input) {
+    if (input.duplicateBlocked)
+        return "duplicate";
+    if (input.cooldownBlocked)
+        return "cooling_down";
+    return "clear";
+}
+export function judgeOutreach(input) {
+    const decisionId = `outreach_judgment:${crypto.randomUUID()}`;
+    const deliveryResolution = resolveDeliveryTarget(input.delivery);
+    const interestRefs = matchInterestRefs(input.candidate, input.userInterest);
+    const valueScore = scoreOutreachValue(input.candidate, input.lifeEvidence);
+    const userRelevance = scoreUserRelevance(input.candidate, input.userInterest);
+    const actionability = scoreActionability(input.candidate, input.userInterest, interestRefs.length);
+    const cooldownState = resolveCooldownState(input);
+    const reasons = [];
+    if (input.candidate.sourceRefs.length === 0)
+        reasons.push("missing_source_refs");
+    if (valueScore < OUTREACH_POLICY.minValueScore)
+        reasons.push("value_score_too_low");
+    if (userRelevance < OUTREACH_POLICY.minUserRelevance &&
+        actionability < OUTREACH_POLICY.minActionabilityWhenInterestLow) {
+        reasons.push("not_interest_relevant_or_actionable");
+    }
+    if (cooldownState === "cooling_down")
+        reasons.push("cooling_down");
+    if (cooldownState === "duplicate")
+        reasons.push("duplicate");
+    if (deliveryResolution.verdict !== "target_available") {
+        reasons.push(deliveryResolution.verdict);
+    }
+    const blockingReasons = reasons.filter((r) => !isDeliveryUnavailableReason(r));
+    let verdict;
+    if (blockingReasons.length === 0) {
+        verdict = "allow";
+    }
+    else if (blockingReasons.includes("cooling_down") || blockingReasons.includes("duplicate")) {
+        verdict = "defer";
+    }
+    else {
+        verdict = "deny";
+    }
+    return {
+        decisionId,
+        candidateId: input.candidate.id,
+        verdict,
+        valueScore,
+        userRelevance,
+        actionability,
+        interestRefs,
+        sourceRefs: input.candidate.sourceRefs,
+        cooldownState,
+        deliveryVerdict: deliveryResolution.verdict,
+        reasons: reasons.length === 0 ? ["outreach_allowed"] : reasons,
+    };
+}

package/runtime/core/second-nature/quiet/run-source-backed-quiet.d.ts

@@ -1,21 +1,21 @@
-/**
- * Quiet / reflection orchestration: empty evidence → empty_state; otherwise coverage-gated artifact (T2.3.3).
- */
-import type { CandidateIntent } from "../types.js";
-import type { HeartbeatRuntimeSnapshot } from "../heartbeat/runtime-snapshot.js";
-import type { HeartbeatCycleResult } from "../heartbeat/signal.js";
-import { type QuietArtifactAck } from "../../../storage/quiet/quiet-artifact-writer.js";
-import type { UserInterestSnapshot } from "../../../storage/user-interest/types.js";
-export interface RunSourceBackedQuietParams {
-    candidate: CandidateIntent;
-    runtime: HeartbeatRuntimeSnapshot;
-    day: string;
-    userInterestSnapshot?: UserInterestSnapshot;
-    workspaceRoot?: string;
-}
-export interface RunSourceBackedQuietResult {
-    result: HeartbeatCycleResult;
-    artifactAck?: QuietArtifactAck;
-    persistedRelativePath?: string;
-}
-export declare function runSourceBackedQuiet(params: RunSourceBackedQuietParams): Promise<RunSourceBackedQuietResult>;
+/**
+ * Quiet / reflection orchestration: empty evidence → empty_state; otherwise coverage-gated artifact (T2.3.3).
+ */
+import type { CandidateIntent } from "../types.js";
+import type { HeartbeatRuntimeSnapshot } from "../heartbeat/runtime-snapshot.js";
+import type { HeartbeatCycleResult } from "../heartbeat/signal.js";
+import { type QuietArtifactAck } from "../../../storage/quiet/quiet-artifact-writer.js";
+import type { UserInterestSnapshot } from "../../../storage/user-interest/types.js";
+export interface RunSourceBackedQuietParams {
+    candidate: CandidateIntent;
+    runtime: HeartbeatRuntimeSnapshot;
+    day: string;
+    userInterestSnapshot?: UserInterestSnapshot;
+    workspaceRoot?: string;
+}
+export interface RunSourceBackedQuietResult {
+    result: HeartbeatCycleResult;
+    artifactAck?: QuietArtifactAck;
+    persistedRelativePath?: string;
+}
+export declare function runSourceBackedQuiet(params: RunSourceBackedQuietParams): Promise<RunSourceBackedQuietResult>;

package/runtime/core/second-nature/quiet/run-source-backed-quiet.js

@@ -1,123 +1,123 @@
-import { isLifeEvidenceSliceEmpty } from "../heartbeat/runtime-snapshot.js";
-import { writeQuietArtifact } from "../../../storage/quiet/quiet-artifact-writer.js";
-import { persistQuietArtifactToWorkspace } from "../../../storage/quiet/persist-quiet-artifact.js";
-import { buildEvidencePack, buildQuietNarrativeGuidance, selectInterestBasis } from "../../../guidance/evidence-guidance.js";
-function toSourceRefFromControlPlane(r) {
-    return {
-        id: r.id,
-        kind: r.kind,
-        uri: r.uri,
-        excerptHash: r.excerptHash,
-        observedAt: r.observedAt,
-    };
-}
-function toGuidanceRef(r) {
-    return {
-        id: r.id,
-        kind: r.kind,
-        uri: r.uri,
-        excerptHash: r.excerptHash,
-        observedAt: r.observedAt,
-    };
-}
-export async function runSourceBackedQuiet(params) {
-    const { candidate, runtime, day, userInterestSnapshot, workspaceRoot } = params;
-    const empty = isLifeEvidenceSliceEmpty(runtime.lifeEvidence);
-    if (empty) {
-        const input = {
-            day,
-            kind: "empty_state",
-            title: "Quiet — no life evidence",
-            body: "No source-backed life evidence in window; narrative reflection is skipped.",
-            claims: [],
-            sourceRefs: [],
-        };
-        const ack = writeQuietArtifact(input);
-        let persistedRelativePath;
-        if (workspaceRoot) {
-            const p = await persistQuietArtifactToWorkspace(workspaceRoot, ack, input);
-            persistedRelativePath = p.relativePath;
-        }
-        return {
-            result: {
-                scope: "rhythm",
-                status: "intent_selected",
-                selectedIntentId: candidate.id,
-                reasons: ["quiet_empty_state", "no_fictional_narrative"],
-            },
-            artifactAck: ack,
-            persistedRelativePath,
-        };
-    }
-    const bundleRefs = runtime.lifeEvidence.evidenceRefs.map(toSourceRefFromControlPlane);
-    const guidanceRefs = runtime.lifeEvidence.evidenceRefs.map(toGuidanceRef);
-    const ep = buildEvidencePack(guidanceRefs);
-    if (!ep.ok) {
-        return {
-            result: {
-                scope: "rhythm",
-                status: "denied",
-                selectedIntentId: candidate.id,
-                reasons: ep.reasons,
-            },
-        };
-    }
-    const basis = selectInterestBasis({
-        staleness: userInterestSnapshot?.staleness ?? "insufficient",
-        confidence: userInterestSnapshot?.confidence ?? 0,
-        signalCount: userInterestSnapshot?.signals.length ?? 0,
-    });
-    const claims = ep.pack.groundedRefs.map((g, i) => ({
-        id: `fact:${g.id}`,
-        text: `Evidence-backed note ${i + 1}`,
-        claimType: "fact",
-        sourceRefs: [
-            {
-                id: g.id,
-                kind: g.kind,
-                uri: g.uri,
-                excerptHash: g.excerptHash,
-                observedAt: g.observedAt,
-            },
-        ],
-    }));
-    const reportWrite = {
-        day,
-        kind: "daily_report",
-        title: "Quiet daily report",
-        body: `Source-backed quiet summary (${bundleRefs.length} refs).`,
-        claims,
-        sourceRefs: bundleRefs,
-    };
-    const ack = writeQuietArtifact(reportWrite);
-    const gq = buildQuietNarrativeGuidance({
-        interestBasis: basis,
-        sourceCoverage: ack.sourceCoverage,
-        outline: claims.map((c) => c.text),
-    });
-    if (gq.status === "unavailable") {
-        return {
-            result: {
-                scope: "rhythm",
-                status: "denied",
-                selectedIntentId: candidate.id,
-                reasons: gq.reasons,
-            },
-        };
-    }
-    let persistedRelativePath;
-    if (workspaceRoot) {
-        const p = await persistQuietArtifactToWorkspace(workspaceRoot, ack, reportWrite);
-        persistedRelativePath = p.relativePath;
-    }
-    return {
-        result: {
-            scope: "rhythm",
-            status: "intent_selected",
-            selectedIntentId: candidate.id,
-            reasons: ["quiet_artifact_written", ...gq.hints.slice(0, 2)],
-        },
-        artifactAck: ack,
-        persistedRelativePath,
-    };
-}
+import { isLifeEvidenceSliceEmpty } from "../heartbeat/runtime-snapshot.js";
+import { writeQuietArtifact } from "../../../storage/quiet/quiet-artifact-writer.js";
+import { persistQuietArtifactToWorkspace } from "../../../storage/quiet/persist-quiet-artifact.js";
+import { buildEvidencePack, buildQuietNarrativeGuidance, selectInterestBasis } from "../../../guidance/evidence-guidance.js";
+function toSourceRefFromControlPlane(r) {
+    return {
+        id: r.id,
+        kind: r.kind,
+        uri: r.uri,
+        excerptHash: r.excerptHash,
+        observedAt: r.observedAt,
+    };
+}
+function toGuidanceRef(r) {
+    return {
+        id: r.id,
+        kind: r.kind,
+        uri: r.uri,
+        excerptHash: r.excerptHash,
+        observedAt: r.observedAt,
+    };
+}
+export async function runSourceBackedQuiet(params) {
+    const { candidate, runtime, day, userInterestSnapshot, workspaceRoot } = params;
+    const empty = isLifeEvidenceSliceEmpty(runtime.lifeEvidence);
+    if (empty) {
+        const input = {
+            day,
+            kind: "empty_state",
+            title: "Quiet — no life evidence",
+            body: "No source-backed life evidence in window; narrative reflection is skipped.",
+            claims: [],
+            sourceRefs: [],
+        };
+        const ack = writeQuietArtifact(input);
+        let persistedRelativePath;
+        if (workspaceRoot) {
+            const p = await persistQuietArtifactToWorkspace(workspaceRoot, ack, input);
+            persistedRelativePath = p.relativePath;
+        }
+        return {
+            result: {
+                scope: "rhythm",
+                status: "intent_selected",
+                selectedIntentId: candidate.id,
+                reasons: ["quiet_empty_state", "no_fictional_narrative"],
+            },
+            artifactAck: ack,
+            persistedRelativePath,
+        };
+    }
+    const bundleRefs = runtime.lifeEvidence.evidenceRefs.map(toSourceRefFromControlPlane);
+    const guidanceRefs = runtime.lifeEvidence.evidenceRefs.map(toGuidanceRef);
+    const ep = buildEvidencePack(guidanceRefs);
+    if (!ep.ok) {
+        return {
+            result: {
+                scope: "rhythm",
+                status: "denied",
+                selectedIntentId: candidate.id,
+                reasons: ep.reasons,
+            },
+        };
+    }
+    const basis = selectInterestBasis({
+        staleness: userInterestSnapshot?.staleness ?? "insufficient",
+        confidence: userInterestSnapshot?.confidence ?? 0,
+        signalCount: userInterestSnapshot?.signals.length ?? 0,
+    });
+    const claims = ep.pack.groundedRefs.map((g, i) => ({
+        id: `fact:${g.id}`,
+        text: `Evidence-backed note ${i + 1}`,
+        claimType: "fact",
+        sourceRefs: [
+            {
+                id: g.id,
+                kind: g.kind,
+                uri: g.uri,
+                excerptHash: g.excerptHash,
+                observedAt: g.observedAt,
+            },
+        ],
+    }));
+    const reportWrite = {
+        day,
+        kind: "daily_report",
+        title: "Quiet daily report",
+        body: `Source-backed quiet summary (${bundleRefs.length} refs).`,
+        claims,
+        sourceRefs: bundleRefs,
+    };
+    const ack = writeQuietArtifact(reportWrite);
+    const gq = buildQuietNarrativeGuidance({
+        interestBasis: basis,
+        sourceCoverage: ack.sourceCoverage,
+        outline: claims.map((c) => c.text),
+    });
+    if (gq.status === "unavailable") {
+        return {
+            result: {
+                scope: "rhythm",
+                status: "denied",
+                selectedIntentId: candidate.id,
+                reasons: gq.reasons,
+            },
+        };
+    }
+    let persistedRelativePath;
+    if (workspaceRoot) {
+        const p = await persistQuietArtifactToWorkspace(workspaceRoot, ack, reportWrite);
+        persistedRelativePath = p.relativePath;
+    }
+    return {
+        result: {
+            scope: "rhythm",
+            status: "intent_selected",
+            selectedIntentId: candidate.id,
+            reasons: ["quiet_artifact_written", ...gq.hints.slice(0, 2)],
+        },
+        artifactAck: ack,
+        persistedRelativePath,
+    };
+}

package/runtime/core/second-nature/rhythm/planner-rhythm-window.d.ts

@@ -1,15 +1,15 @@
-/**
- * Maps calendar rhythm policy + continuity into planner-facing window slice (T2.1.3).
- * Control-plane owns allowedIntentKinds; state never emits them (T2.1.2 boundary).
- */
-import type { ContinuitySnapshot, IntentKind } from "../types.js";
-import type { RhythmPolicy } from "./rhythm-policy.js";
-export interface PlannerRhythmWindowSlice {
-    windowId: string;
-    allowedIntentKinds: IntentKind[];
-    quietBias: boolean;
-}
-/**
- * Derive allowed intent kinds and quiet bias for candidate planning.
- */
-export declare function buildPlannerRhythmWindow(now: string, continuity: ContinuitySnapshot, policy: RhythmPolicy): PlannerRhythmWindowSlice;
+/**
+ * Maps calendar rhythm policy + continuity into planner-facing window slice (T2.1.3).
+ * Control-plane owns allowedIntentKinds; state never emits them (T2.1.2 boundary).
+ */
+import type { ContinuitySnapshot, IntentKind } from "../types.js";
+import type { RhythmPolicy } from "./rhythm-policy.js";
+export interface PlannerRhythmWindowSlice {
+    windowId: string;
+    allowedIntentKinds: IntentKind[];
+    quietBias: boolean;
+}
+/**
+ * Derive allowed intent kinds and quiet bias for candidate planning.
+ */
+export declare function buildPlannerRhythmWindow(now: string, continuity: ContinuitySnapshot, policy: RhythmPolicy): PlannerRhythmWindowSlice;