@haaaiawd/second-nature 0.1.18 → 0.1.20

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;

package/runtime/core/second-nature/rhythm/planner-rhythm-window.js

@@ -1,52 +1,52 @@
-import { selectRhythmWindow } from "./select-window.js";
-const ALL_INTENT_KINDS = [
-    "work",
-    "exploration",
-    "social",
-    "quiet",
-    "reflection",
-    "outreach",
-    "maintenance",
-];
-function allowedForPaused() {
-    return ["maintenance"];
-}
-function allowedForMaintenanceOnly() {
-    return ["work", "maintenance"];
-}
-function allowedForActiveWindow(windowId) {
-    if (windowId.includes("work")) {
-        return ["work", "exploration", "maintenance", "reflection", "outreach", "social", "quiet"];
-    }
-    if (windowId.includes("social")) {
-        return ["social", "exploration", "work", "maintenance", "reflection", "outreach", "quiet"];
-    }
-    if (windowId.includes("reflection")) {
-        return ["reflection", "work", "maintenance", "exploration", "social", "outreach", "quiet"];
-    }
-    return ALL_INTENT_KINDS;
-}
-function mergeQuietBias(decision, continuity, windowIsQuiet) {
-    return windowIsQuiet || decision.topLevelMode === "quiet" || continuity.mode === "quiet";
-}
-/**
- * Derive allowed intent kinds and quiet bias for candidate planning.
- */
-export function buildPlannerRhythmWindow(now, continuity, policy) {
-    const decision = selectRhythmWindow(now, continuity, policy);
-    const window = policy.windows.find((w) => w.id === decision.windowId) ?? policy.windows[0];
-    const windowIsQuiet = window.mode === "quiet";
-    const quietBias = mergeQuietBias(decision, continuity, windowIsQuiet);
-    let allowed;
-    if (decision.topLevelMode === "paused_for_interrupt") {
-        allowed = allowedForPaused();
-    }
-    else if (decision.topLevelMode === "maintenance_only") {
-        allowed = allowedForMaintenanceOnly();
-    }
-    else {
-        /** Calendar quiet sets `quietBias` only; candidate kinds stay window-biased (guards enforce quiet suppression). */
-        allowed = allowedForActiveWindow(window.id);
-    }
-    return { windowId: decision.windowId, allowedIntentKinds: allowed, quietBias };
-}
+import { selectRhythmWindow } from "./select-window.js";
+const ALL_INTENT_KINDS = [
+    "work",
+    "exploration",
+    "social",
+    "quiet",
+    "reflection",
+    "outreach",
+    "maintenance",
+];
+function allowedForPaused() {
+    return ["maintenance"];
+}
+function allowedForMaintenanceOnly() {
+    return ["work", "maintenance"];
+}
+function allowedForActiveWindow(windowId) {
+    if (windowId.includes("work")) {
+        return ["work", "exploration", "maintenance", "reflection", "outreach", "social", "quiet"];
+    }
+    if (windowId.includes("social")) {
+        return ["social", "exploration", "work", "maintenance", "reflection", "outreach", "quiet"];
+    }
+    if (windowId.includes("reflection")) {
+        return ["reflection", "work", "maintenance", "exploration", "social", "outreach", "quiet"];
+    }
+    return ALL_INTENT_KINDS;
+}
+function mergeQuietBias(decision, continuity, windowIsQuiet) {
+    return windowIsQuiet || decision.topLevelMode === "quiet" || continuity.mode === "quiet";
+}
+/**
+ * Derive allowed intent kinds and quiet bias for candidate planning.
+ */
+export function buildPlannerRhythmWindow(now, continuity, policy) {
+    const decision = selectRhythmWindow(now, continuity, policy);
+    const window = policy.windows.find((w) => w.id === decision.windowId) ?? policy.windows[0];
+    const windowIsQuiet = window.mode === "quiet";
+    const quietBias = mergeQuietBias(decision, continuity, windowIsQuiet);
+    let allowed;
+    if (decision.topLevelMode === "paused_for_interrupt") {
+        allowed = allowedForPaused();
+    }
+    else if (decision.topLevelMode === "maintenance_only") {
+        allowed = allowedForMaintenanceOnly();
+    }
+    else {
+        /** Calendar quiet sets `quietBias` only; candidate kinds stay window-biased (guards enforce quiet suppression). */
+        allowed = allowedForActiveWindow(window.id);
+    }
+    return { windowId: decision.windowId, allowedIntentKinds: allowed, quietBias };
+}

package/runtime/core/second-nature/rhythm/policy-bridge.d.ts

@@ -1,19 +1,19 @@
-/**
- * Bridges state-system RhythmPolicySnapshot fields into control-plane RhythmPolicy (T2.1.2).
- *
- * State never emits window decisions or allowedIntentKinds; control-plane owns
- * window geometry used by selectRhythmWindow(). Callers pass a pick of the DB read model.
- */
-import type { RhythmPolicy } from "./rhythm-policy.js";
-/** Subset of `RhythmPolicySnapshot` used for window derivation (no storage import from core). */
-export interface RhythmPolicySnapshotBridgeInput {
-    quietEnabled: boolean;
-}
-/**
- * Reject drifted snapshot shapes that smuggle control-plane decision fields.
- */
-export declare function assertRhythmPolicySnapshotContract(snapshot: Record<string, unknown>): void;
-/**
- * Deterministic default windows from policy knobs (quiet hour tail when quietEnabled).
- */
-export declare function rhythmPolicySnapshotToRhythmPolicy(snapshot: RhythmPolicySnapshotBridgeInput): RhythmPolicy;
+/**
+ * Bridges state-system RhythmPolicySnapshot fields into control-plane RhythmPolicy (T2.1.2).
+ *
+ * State never emits window decisions or allowedIntentKinds; control-plane owns
+ * window geometry used by selectRhythmWindow(). Callers pass a pick of the DB read model.
+ */
+import type { RhythmPolicy } from "./rhythm-policy.js";
+/** Subset of `RhythmPolicySnapshot` used for window derivation (no storage import from core). */
+export interface RhythmPolicySnapshotBridgeInput {
+    quietEnabled: boolean;
+}
+/**
+ * Reject drifted snapshot shapes that smuggle control-plane decision fields.
+ */
+export declare function assertRhythmPolicySnapshotContract(snapshot: Record<string, unknown>): void;
+/**
+ * Deterministic default windows from policy knobs (quiet hour tail when quietEnabled).
+ */
+export declare function rhythmPolicySnapshotToRhythmPolicy(snapshot: RhythmPolicySnapshotBridgeInput): RhythmPolicy;

package/runtime/core/second-nature/rhythm/policy-bridge.js

@@ -1,34 +1,34 @@
-const FORBIDDEN_SNAPSHOT_KEYS = ["allowedIntentKinds", "windowDecision", "rhythmWindow"];
-/**
- * Reject drifted snapshot shapes that smuggle control-plane decision fields.
- */
-export function assertRhythmPolicySnapshotContract(snapshot) {
-    for (const key of FORBIDDEN_SNAPSHOT_KEYS) {
-        if (key in snapshot) {
-            throw new Error(`rhythm_policy_snapshot_field_drift:${key}`);
-        }
-    }
-}
-/**
- * Deterministic default windows from policy knobs (quiet hour tail when quietEnabled).
- */
-export function rhythmPolicySnapshotToRhythmPolicy(snapshot) {
-    assertRhythmPolicySnapshotContract(snapshot);
-    if (snapshot.quietEnabled) {
-        return {
-            timezone: "UTC",
-            quietSuppressionEnabled: true,
-            windows: [
-                { id: "w-work", startMinute: 0, endMinute: 480, mode: "active" },
-                { id: "w-social", startMinute: 480, endMinute: 960, mode: "active" },
-                { id: "w-reflection", startMinute: 960, endMinute: 1200, mode: "active" },
-                { id: "w-quiet", startMinute: 1200, endMinute: 1440, mode: "quiet" },
-            ],
-        };
-    }
-    return {
-        timezone: "UTC",
-        quietSuppressionEnabled: false,
-        windows: [{ id: "w-open", startMinute: 0, endMinute: 1440, mode: "active" }],
-    };
-}
+const FORBIDDEN_SNAPSHOT_KEYS = ["allowedIntentKinds", "windowDecision", "rhythmWindow"];
+/**
+ * Reject drifted snapshot shapes that smuggle control-plane decision fields.
+ */
+export function assertRhythmPolicySnapshotContract(snapshot) {
+    for (const key of FORBIDDEN_SNAPSHOT_KEYS) {
+        if (key in snapshot) {
+            throw new Error(`rhythm_policy_snapshot_field_drift:${key}`);
+        }
+    }
+}
+/**
+ * Deterministic default windows from policy knobs (quiet hour tail when quietEnabled).
+ */
+export function rhythmPolicySnapshotToRhythmPolicy(snapshot) {
+    assertRhythmPolicySnapshotContract(snapshot);
+    if (snapshot.quietEnabled) {
+        return {
+            timezone: "UTC",
+            quietSuppressionEnabled: true,
+            windows: [
+                { id: "w-work", startMinute: 0, endMinute: 480, mode: "active" },
+                { id: "w-social", startMinute: 480, endMinute: 960, mode: "active" },
+                { id: "w-reflection", startMinute: 960, endMinute: 1200, mode: "active" },
+                { id: "w-quiet", startMinute: 1200, endMinute: 1440, mode: "quiet" },
+            ],
+        };
+    }
+    return {
+        timezone: "UTC",
+        quietSuppressionEnabled: false,
+        windows: [{ id: "w-open", startMinute: 0, endMinute: 1440, mode: "active" }],
+    };
+}

package/runtime/core/second-nature/runtime/service-entry.js

@@ -1,45 +1,45 @@
-/**
- * Second Nature Runtime Service Entry
- *
- * This module provides the actual implementation for the `second-nature-runtime` service.
- * It serves as the heartbeat host bridge candidate carrier and initializes the
- * minimal runtime state needed for the plugin to function.
- *
- * Per ADR-005: heartbeat is the free-rhythm main entry; this service provides
- * the stable runtime state that heartbeat rounds will interact with.
- */
-let activeHandle = null;
-/**
- * Start the Second Nature runtime service.
- *
- * This is the non-empty implementation that replaces the previous `start() { return; }` shell.
- * It initializes the minimal runtime state and returns a handle that can be used
- * by the heartbeat host bridge.
- */
-export function startRuntimeService(ctx) {
-    if (activeHandle?.ready) {
-        return activeHandle;
-    }
-    // Initialize minimal runtime state
-    // In future iterations, this will connect to:
-    // - state-system (SQLite database initialization)
-    // - observability-system (event store setup)
-    // - control-plane-system (heartbeat bridge preparation)
-    const workspaceRoot = ctx?.workspaceRoot ?? process.cwd();
-    /** Keep in sync with `plugin/package.json` when cutting releases. */
-    const version = "0.1.18";
-    activeHandle = {
-        ready: true,
-        version,
-        close() {
-            activeHandle = null;
-        },
-    };
-    return activeHandle;
-}
-/**
- * Get the current runtime service handle, or null if not started.
- */
-export function getRuntimeHandle() {
-    return activeHandle;
-}
+/**
+ * Second Nature Runtime Service Entry
+ *
+ * This module provides the actual implementation for the `second-nature-runtime` service.
+ * It serves as the heartbeat host bridge candidate carrier and initializes the
+ * minimal runtime state needed for the plugin to function.
+ *
+ * Per ADR-005: heartbeat is the free-rhythm main entry; this service provides
+ * the stable runtime state that heartbeat rounds will interact with.
+ */
+let activeHandle = null;
+/**
+ * Start the Second Nature runtime service.
+ *
+ * This is the non-empty implementation that replaces the previous `start() { return; }` shell.
+ * It initializes the minimal runtime state and returns a handle that can be used
+ * by the heartbeat host bridge.
+ */
+export function startRuntimeService(ctx) {
+    if (activeHandle?.ready) {
+        return activeHandle;
+    }
+    // Initialize minimal runtime state
+    // In future iterations, this will connect to:
+    // - state-system (SQLite database initialization)
+    // - observability-system (event store setup)
+    // - control-plane-system (heartbeat bridge preparation)
+    const workspaceRoot = ctx?.workspaceRoot ?? process.cwd();
+    /** Keep in sync with `plugin/package.json` when cutting releases. */
+    const version = "0.1.19";
+    activeHandle = {
+        ready: true,
+        version,
+        close() {
+            activeHandle = null;
+        },
+    };
+    return activeHandle;
+}
+/**
+ * Get the current runtime service handle, or null if not started.
+ */
+export function getRuntimeHandle() {
+    return activeHandle;
+}