@haaaiawd/second-nature 0.1.16 → 0.1.18

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.16";
-    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.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;
+}

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

@@ -1,51 +1,51 @@
-export type TopLevelMode = "active" | "quiet" | "maintenance_only" | "paused_for_interrupt";
-/** Control-plane candidate kinds; includes `quiet` for quiet-window–biased intents (L0 alignment). */
-export type IntentKind = "work" | "exploration" | "social" | "quiet" | "reflection" | "outreach" | "maintenance";
-export type DecisionBasis = "rule_only" | "score_based" | "model_assisted";
-export type GuardVerdict = "allow" | "defer" | "deny" | "escalate";
-/** Minimal source ref for planner / guards (matches state-system `SourceRef` subset). */
-export interface ControlPlaneSourceRef {
-    id: string;
-    kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
-    uri: string;
-    excerptHash?: string;
-    observedAt?: string;
-}
-export interface ContinuitySnapshot {
-    mode: TopLevelMode;
-    currentWindowId: string;
-    pendingObligations: string[];
-    recentOutreachHashes: string[];
-    deniedIntents: Array<{
-        intentHash: string;
-        reason: string;
-        at: string;
-    }>;
-    budgets?: {
-        socialUsed: number;
-        socialLimit: number;
-    };
-    awaitingUserInput?: boolean;
-    riskSuppressed?: boolean;
-}
-export type CandidateEffectClass = "external_platform_action" | "connector_action" | "memory_curation" | "narrative_reflection" | "user_outreach" | "maintenance" | "no_effect";
-export interface CandidateIntent {
-    id: string;
-    kind: IntentKind;
-    priority: number;
-    source: "tick" | "interrupt" | "obligation" | "quiet_plan";
-    platformId?: string;
-    summary: string;
-    effectClass: CandidateEffectClass;
-    /** Required for source-backed guard; may be empty when planner expects hard-guard deny. */
-    sourceRefs: ControlPlaneSourceRef[];
-    /** Dedupe / cooldown key; defaults to stable fingerprint in guard layer when omitted. */
-    idempotencyKey?: string;
-}
-export interface GuardEvaluation {
-    verdict: GuardVerdict;
-    reasons: string[];
-    quietSuppressed: boolean;
-    leaseRequired: boolean;
-    requiresCheckpoint: boolean;
-}
+export type TopLevelMode = "active" | "quiet" | "maintenance_only" | "paused_for_interrupt";
+/** Control-plane candidate kinds; includes `quiet` for quiet-window–biased intents (L0 alignment). */
+export type IntentKind = "work" | "exploration" | "social" | "quiet" | "reflection" | "outreach" | "maintenance";
+export type DecisionBasis = "rule_only" | "score_based" | "model_assisted";
+export type GuardVerdict = "allow" | "defer" | "deny" | "escalate";
+/** Minimal source ref for planner / guards (matches state-system `SourceRef` subset). */
+export interface ControlPlaneSourceRef {
+    id: string;
+    kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
+    uri: string;
+    excerptHash?: string;
+    observedAt?: string;
+}
+export interface ContinuitySnapshot {
+    mode: TopLevelMode;
+    currentWindowId: string;
+    pendingObligations: string[];
+    recentOutreachHashes: string[];
+    deniedIntents: Array<{
+        intentHash: string;
+        reason: string;
+        at: string;
+    }>;
+    budgets?: {
+        socialUsed: number;
+        socialLimit: number;
+    };
+    awaitingUserInput?: boolean;
+    riskSuppressed?: boolean;
+}
+export type CandidateEffectClass = "external_platform_action" | "connector_action" | "memory_curation" | "narrative_reflection" | "user_outreach" | "maintenance" | "no_effect";
+export interface CandidateIntent {
+    id: string;
+    kind: IntentKind;
+    priority: number;
+    source: "tick" | "interrupt" | "obligation" | "quiet_plan";
+    platformId?: string;
+    summary: string;
+    effectClass: CandidateEffectClass;
+    /** Required for source-backed guard; may be empty when planner expects hard-guard deny. */
+    sourceRefs: ControlPlaneSourceRef[];
+    /** Dedupe / cooldown key; defaults to stable fingerprint in guard layer when omitted. */
+    idempotencyKey?: string;
+}
+export interface GuardEvaluation {
+    verdict: GuardVerdict;
+    reasons: string[];
+    quietSuppressed: boolean;
+    leaseRequired: boolean;
+    requiresCheckpoint: boolean;
+}

package/runtime/guidance/draft-outreach-message.d.ts

@@ -1,7 +1,7 @@
-/**
- * Deterministic GuidanceDraftPort implementation for contract tests and packaged runtime.
- * Does not claim user-visible delivery when wordingMode is not_sent_fallback_candidate (T6.2.1 / ADR-004).
- */
-import { type GuidanceDraftPort, type OutreachDraftRequest } from "./outreach-draft-schema.js";
-export declare function draftOutreachMessage(request: OutreachDraftRequest): ReturnType<GuidanceDraftPort["draftOutreachMessage"]>;
-export declare function createDraftOutreachMessagePort(): GuidanceDraftPort;
+/**
+ * Deterministic GuidanceDraftPort implementation for contract tests and packaged runtime.
+ * Does not claim user-visible delivery when wordingMode is not_sent_fallback_candidate (T6.2.1 / ADR-004).
+ */
+import { type GuidanceDraftPort, type OutreachDraftRequest } from "./outreach-draft-schema.js";
+export declare function draftOutreachMessage(request: OutreachDraftRequest): ReturnType<GuidanceDraftPort["draftOutreachMessage"]>;
+export declare function createDraftOutreachMessagePort(): GuidanceDraftPort;

package/runtime/guidance/draft-outreach-message.js

@@ -1,42 +1,42 @@
-/**
- * Deterministic GuidanceDraftPort implementation for contract tests and packaged runtime.
- * Does not claim user-visible delivery when wordingMode is not_sent_fallback_candidate (T6.2.1 / ADR-004).
- */
-import { safeParseOutreachDraftRequest } from "./outreach-draft-schema.js";
-function baseDraftText(request) {
-    const ids = request.sourceRefs.map((s) => s.id).join(",");
-    return `draft:${request.candidateId}:grounded:${ids}`;
-}
-export async function draftOutreachMessage(request) {
-    const parsed = safeParseOutreachDraftRequest(request);
-    if (!parsed.success) {
-        return { status: "unavailable", reasons: ["outreach_draft_schema_invalid"] };
-    }
-    const r = parsed.data;
-    if (r.judgmentVerdict !== "allow") {
-        return { status: "unavailable", reasons: ["hard_decision_not_allow"] };
-    }
-    if (r.sourceRefs.length === 0) {
-        return { status: "unavailable", reasons: ["missing_resolved_source_refs"] };
-    }
-    const wording = r.deliveryContext.wordingMode;
-    if (wording === "sendable") {
-        return {
-            status: "ready",
-            draft: {
-                text: `${baseDraftText(r)};wording=sendable`,
-                deliveryWording: "sendable",
-            },
-        };
-    }
-    return {
-        status: "ready",
-        draft: {
-            text: `Not sent to the user (candidate only). Delivery state: ${r.deliveryContext.deliveryVerdict}. ${baseDraftText(r)}`,
-            deliveryWording: "not_sent_fallback_candidate",
-        },
-    };
-}
-export function createDraftOutreachMessagePort() {
-    return { draftOutreachMessage };
-}
+/**
+ * Deterministic GuidanceDraftPort implementation for contract tests and packaged runtime.
+ * Does not claim user-visible delivery when wordingMode is not_sent_fallback_candidate (T6.2.1 / ADR-004).
+ */
+import { safeParseOutreachDraftRequest } from "./outreach-draft-schema.js";
+function baseDraftText(request) {
+    const ids = request.sourceRefs.map((s) => s.id).join(",");
+    return `draft:${request.candidateId}:grounded:${ids}`;
+}
+export async function draftOutreachMessage(request) {
+    const parsed = safeParseOutreachDraftRequest(request);
+    if (!parsed.success) {
+        return { status: "unavailable", reasons: ["outreach_draft_schema_invalid"] };
+    }
+    const r = parsed.data;
+    if (r.judgmentVerdict !== "allow") {
+        return { status: "unavailable", reasons: ["hard_decision_not_allow"] };
+    }
+    if (r.sourceRefs.length === 0) {
+        return { status: "unavailable", reasons: ["missing_resolved_source_refs"] };
+    }
+    const wording = r.deliveryContext.wordingMode;
+    if (wording === "sendable") {
+        return {
+            status: "ready",
+            draft: {
+                text: `${baseDraftText(r)};wording=sendable`,
+                deliveryWording: "sendable",
+            },
+        };
+    }
+    return {
+        status: "ready",
+        draft: {
+            text: `Not sent to the user (candidate only). Delivery state: ${r.deliveryContext.deliveryVerdict}. ${baseDraftText(r)}`,
+            deliveryWording: "not_sent_fallback_candidate",
+        },
+    };
+}
+export function createDraftOutreachMessagePort() {
+    return { draftOutreachMessage };
+}

package/runtime/guidance/evidence-guidance.d.ts

@@ -1,40 +1,40 @@
-/**
- * Evidence pack assembly, interest-basis selection, and Quiet narrative gate (T6.1.2 / ADR-004).
- * Guidance does not own delivery or judgment; callers pass already-resolved refs.
- */
-import type { GuidanceSourceRef } from "./outreach-draft-schema.js";
-import type { UserInterestStaleness } from "../storage/user-interest/types.js";
-import type { SourceCoverage } from "../storage/snapshots/types.js";
-export type SourceCoveragePolicy = "strict" | "lenient";
-export interface EvidencePack {
-    groundedRefs: GuidanceSourceRef[];
-    unresolvedIds: string[];
-    sensitiveBlocked: boolean;
-    policy: SourceCoveragePolicy;
-}
-export declare function buildEvidencePack(refs: GuidanceSourceRef[], opts?: {
-    policy?: SourceCoveragePolicy;
-}): {
-    ok: true;
-    pack: EvidencePack;
-} | {
-    ok: false;
-    reasons: string[];
-};
-export type InterestBasisMode = "evidence_only" | "interest_augmented" | "unavailable";
-export declare function selectInterestBasis(input: {
-    staleness: UserInterestStaleness;
-    confidence: number;
-    signalCount: number;
-}): InterestBasisMode;
-export declare function buildQuietNarrativeGuidance(input: {
-    interestBasis: InterestBasisMode;
-    sourceCoverage: Pick<SourceCoverage, "coverageRatio" | "unsupportedClaims">;
-    outline: string[];
-}): {
-    status: "ready";
-    hints: string[];
-} | {
-    status: "unavailable";
-    reasons: string[];
-};
+/**
+ * Evidence pack assembly, interest-basis selection, and Quiet narrative gate (T6.1.2 / ADR-004).
+ * Guidance does not own delivery or judgment; callers pass already-resolved refs.
+ */
+import type { GuidanceSourceRef } from "./outreach-draft-schema.js";
+import type { UserInterestStaleness } from "../storage/user-interest/types.js";
+import type { SourceCoverage } from "../storage/snapshots/types.js";
+export type SourceCoveragePolicy = "strict" | "lenient";
+export interface EvidencePack {
+    groundedRefs: GuidanceSourceRef[];
+    unresolvedIds: string[];
+    sensitiveBlocked: boolean;
+    policy: SourceCoveragePolicy;
+}
+export declare function buildEvidencePack(refs: GuidanceSourceRef[], opts?: {
+    policy?: SourceCoveragePolicy;
+}): {
+    ok: true;
+    pack: EvidencePack;
+} | {
+    ok: false;
+    reasons: string[];
+};
+export type InterestBasisMode = "evidence_only" | "interest_augmented" | "unavailable";
+export declare function selectInterestBasis(input: {
+    staleness: UserInterestStaleness;
+    confidence: number;
+    signalCount: number;
+}): InterestBasisMode;
+export declare function buildQuietNarrativeGuidance(input: {
+    interestBasis: InterestBasisMode;
+    sourceCoverage: Pick<SourceCoverage, "coverageRatio" | "unsupportedClaims">;
+    outline: string[];
+}): {
+    status: "ready";
+    hints: string[];
+} | {
+    status: "unavailable";
+    reasons: string[];
+};