@haaaiawd/second-nature 0.1.39 → 0.1.41

package/runtime/dream/sampler.js

@@ -1,65 +1,65 @@
-/**
- * Dream input sampler.
- *
- * Core logic: when evidence count exceeds threshold, sample recent 7 days
- * plus key events (outreach, owner reply, goal milestone, high-confidence refs).
- * Goal: prevent token/cost explosion before LLM stage.
- * Test coverage: tests/integration/dream/t7-1-1-dream-pipeline.test.ts
- */
-const DEFAULT_EVIDENCE_LIMIT = 1000;
-const RECENT_DAYS = 7;
-function isWithinDays(createdAt, days) {
-    const then = new Date(createdAt).getTime();
-    const now = Date.now();
-    return now - then <= days * 24 * 60 * 60 * 1000;
-}
-function isKeyEvent(item) {
-    if (!item.kind)
-        return false;
-    const keyKinds = [
-        "outreach",
-        "owner_reply",
-        "goal_milestone",
-        "delivery",
-        "quiet_reflection",
-    ];
-    return keyKinds.includes(item.kind);
-}
-function isHighConfidence(item) {
-    return (item.confidence ?? 0) >= 0.7;
-}
-export function sampleDreamInput(input) {
-    const limit = input.evidenceLimit ?? DEFAULT_EVIDENCE_LIMIT;
-    // Priority: recent 7 days + key events + high confidence
-    const withPriority = input.evidenceSummaries.map((e) => ({
-        ...e,
-        priority: (isWithinDays(e.createdAt, RECENT_DAYS) ? 4 : 0) +
-            (isKeyEvent(e) ? 2 : 0) +
-            (isHighConfidence(e) ? 1 : 0),
-    }));
-    // Sort by priority desc, then createdAt desc
-    withPriority.sort((a, b) => {
-        if (b.priority !== a.priority)
-            return b.priority - a.priority;
-        return b.createdAt.localeCompare(a.createdAt);
-    });
-    const sampledEvidence = withPriority.slice(0, limit);
-    const sampledEvidenceIds = sampledEvidence.map((e) => e.id);
-    const droppedCount = input.evidenceSummaries.length - sampledEvidence.length;
-    // Chronicle is usually small; keep all unless it also exceeds limit
-    let sampledChronicleIds = input.chronicleSummaries.map((c) => c.id);
-    if (sampledChronicleIds.length > limit) {
-        sampledChronicleIds = sampledChronicleIds
-            .sort((a, b) => b.localeCompare(a))
-            .slice(0, limit);
-    }
-    const reason = droppedCount > 0
-        ? `sampled_${sampledEvidenceIds.length}_of_${input.evidenceSummaries.length}_evidence;priority_recent+key+confidence`
-        : "no_sampling_needed";
-    return {
-        sampledEvidenceIds,
-        sampledChronicleIds,
-        droppedCount,
-        reason,
-    };
-}
+/**
+ * Dream input sampler.
+ *
+ * Core logic: when evidence count exceeds threshold, sample recent 7 days
+ * plus key events (outreach, owner reply, goal milestone, high-confidence refs).
+ * Goal: prevent token/cost explosion before LLM stage.
+ * Test coverage: tests/integration/dream/t7-1-1-dream-pipeline.test.ts
+ */
+const DEFAULT_EVIDENCE_LIMIT = 1000;
+const RECENT_DAYS = 7;
+function isWithinDays(createdAt, days) {
+    const then = new Date(createdAt).getTime();
+    const now = Date.now();
+    return now - then <= days * 24 * 60 * 60 * 1000;
+}
+function isKeyEvent(item) {
+    if (!item.kind)
+        return false;
+    const keyKinds = [
+        "outreach",
+        "owner_reply",
+        "goal_milestone",
+        "delivery",
+        "quiet_reflection",
+    ];
+    return keyKinds.includes(item.kind);
+}
+function isHighConfidence(item) {
+    return (item.confidence ?? 0) >= 0.7;
+}
+export function sampleDreamInput(input) {
+    const limit = input.evidenceLimit ?? DEFAULT_EVIDENCE_LIMIT;
+    // Priority: recent 7 days + key events + high confidence
+    const withPriority = input.evidenceSummaries.map((e) => ({
+        ...e,
+        priority: (isWithinDays(e.createdAt, RECENT_DAYS) ? 4 : 0) +
+            (isKeyEvent(e) ? 2 : 0) +
+            (isHighConfidence(e) ? 1 : 0),
+    }));
+    // Sort by priority desc, then createdAt desc
+    withPriority.sort((a, b) => {
+        if (b.priority !== a.priority)
+            return b.priority - a.priority;
+        return b.createdAt.localeCompare(a.createdAt);
+    });
+    const sampledEvidence = withPriority.slice(0, limit);
+    const sampledEvidenceIds = sampledEvidence.map((e) => e.id);
+    const droppedCount = input.evidenceSummaries.length - sampledEvidence.length;
+    // Chronicle is usually small; keep all unless it also exceeds limit
+    let sampledChronicleIds = input.chronicleSummaries.map((c) => c.id);
+    if (sampledChronicleIds.length > limit) {
+        sampledChronicleIds = sampledChronicleIds
+            .sort((a, b) => b.localeCompare(a))
+            .slice(0, limit);
+    }
+    const reason = droppedCount > 0
+        ? `sampled_${sampledEvidenceIds.length}_of_${input.evidenceSummaries.length}_evidence;priority_recent+key+confidence`
+        : "no_sampling_needed";
+    return {
+        sampledEvidenceIds,
+        sampledChronicleIds,
+        droppedCount,
+        reason,
+    };
+}

package/runtime/dream/types.d.ts

@@ -1,187 +1,187 @@
-/**
- * Dream System core types.
- *
- * Dream is an async memory consolidation job. It reads source-backed life evidence,
- * session chronicle, and existing memory store, then produces a candidate MemoryStore
- * with canonical entries, insights, and optional narrative/relationship update proposals.
- *
- * Contract: input store is immutable; output is always candidate until validated and accepted.
- * Test coverage: tests/integration/dream/t7-1-1-dream-pipeline.test.ts
- */
-import type { CanonicalMemoryEntry, DreamInsight } from "../storage/memory-store/memory-store-lifecycle.js";
-export type { DreamInsight };
-export type DreamTriggerKind = "scheduled" | "evidence_threshold" | "manual" | "maintenance" | "quiet_completion";
-export type DreamRunStatus = "queued" | "running" | "completed" | "skipped" | "failed";
-export type DreamOutputStatus = "candidate" | "accepted" | "archived" | "partial";
-export type DreamMode = "rules_only" | "hybrid_llm" | "model_skipped";
-export interface DreamRun {
-    runId: string;
-    traceId: string;
-    triggerKind: DreamTriggerKind;
-    status: DreamRunStatus;
-    mode: DreamMode;
-    startedAt: string;
-    finishedAt?: string;
-    inputMemoryStoreId?: string;
-    outputMemoryStoreId?: string;
-    fallbackReason?: string;
-}
-export interface ToolExperienceSummary {
-    connectorId: string;
-    capabilityId: string;
-    outcome: string;
-    count: number;
-    lastRecordedAt: string;
-}
-export interface DreamInputBundle {
-    evidenceRefs: string[];
-    chronicleEntryIds: string[];
-    activeMemoryStoreId?: string;
-    narrativeSnapshotId?: string;
-    relationshipSnapshotId?: string;
-    goalSnapshotIds: string[];
-    toolExperienceSummaries?: ToolExperienceSummary[];
-    inputCounts: {
-        evidence: number;
-        chronicle: number;
-        memoryEntries: number;
-    };
-}
-export interface DreamNarrativeUpdate {
-    focus: string;
-    progressAdditions: string[];
-    nextIntent: string;
-    confidenceDelta: number;
-    sourceRefs: string[];
-    unsupportedClaims: string[];
-}
-export interface DreamRelationshipUpdate {
-    toneDelta?: string;
-    timingDelta?: string;
-    topicDelta?: string;
-    sourceRefs: string[];
-    confidence: number;
-}
-export interface DreamOutputValidation {
-    schemaValid: boolean;
-    sourceGrounded: boolean;
-    sensitivityClean: boolean;
-    unsupportedClaims: string[];
-    errors: string[];
-    checkedAt: string;
-}
-export interface DreamOutput {
-    outputId: string;
-    runId: string;
-    status: DreamOutputStatus;
-    inputMemoryStoreId?: string;
-    canonicalEntries: CanonicalMemoryEntry[];
-    insights: DreamInsight[];
-    narrativeUpdate?: DreamNarrativeUpdate;
-    relationshipUpdate?: DreamRelationshipUpdate;
-    validation: DreamOutputValidation;
-}
-export interface DreamTrace {
-    traceId: string;
-    runId: string;
-    startedAt: string;
-    finishedAt: string;
-    durationMs: number;
-    llmCostUsd?: number;
-    inputCounts: DreamInputBundle["inputCounts"];
-    fallbackReason?: string;
-    validationErrors?: string[];
-    timeoutMs?: number;
-    sensitivityFailure?: boolean;
-}
-export interface DreamRunResult {
-    runId: string;
-    status: DreamRunStatus;
-    output?: DreamOutput;
-    trace: DreamTrace;
-    fallbackReason?: string;
-}
-export interface DreamStatePort {
-    loadDreamInputs(query: {
-        timeWindowDays?: number;
-        evidenceLimit?: number;
-    }): Promise<DreamInputBundle>;
-    writeDreamOutput(output: DreamOutput): Promise<{
-        outputId: string;
-        status: "acknowledged" | "degraded";
-    }>;
-    markDreamOutputLifecycle(input: {
-        outputId: string;
-        newStatus: DreamOutputStatus;
-        validation?: DreamOutputValidation;
-        updatedAt: string;
-    }): Promise<{
-        outputId: string;
-        status: "acknowledged" | "degraded";
-    }>;
-}
-/**
- * Brand type: evidence bundle that has passed through RedactionGate.
- * TypeScript prevents passing un-redacted data to ModelAssistPort.
- */
-export interface RedactedEvidenceBundle {
-    readonly _brand: "redacted";
-    readonly evidence: readonly string[];
-    readonly chronicle: readonly string[];
-    readonly memory?: readonly string[];
-}
-export interface ModelAssistPort {
-    /** Only accepts RedactedEvidenceBundle — TypeScript enforces prior redaction (DR-027). */
-    extractInsights(input: RedactedEvidenceBundle): Promise<{
-        insights: DreamInsight[];
-        narrativeUpdate?: DreamNarrativeUpdate;
-        relationshipUpdate?: DreamRelationshipUpdate;
-        unsupportedClaims: string[];
-        costUsd?: number;
-    }>;
-}
-/** @deprecated Use ModelAssistPort with RedactedEvidenceBundle (DR-027). */
-export interface DreamModelPort {
-    extractInsights(input: {
-        sampledEvidence: string[];
-        chronicleSummary: string;
-        activeMemorySummary?: string;
-        redacted: boolean;
-    }): Promise<{
-        insights: DreamInsight[];
-        narrativeUpdate?: DreamNarrativeUpdate;
-        relationshipUpdate?: DreamRelationshipUpdate;
-        unsupportedClaims: string[];
-        costUsd?: number;
-    }>;
-}
-export interface DreamTracePort {
-    recordDreamTrace(trace: DreamTrace): Promise<void>;
-}
-export interface DreamBudgetPort {
-    checkBudget(costEstimateUsd: number): Promise<{
-        allowed: boolean;
-        remainingUsd: number;
-    }>;
-}
-export interface DreamEngineInput {
-    runId: string;
-    traceId: string;
-    triggerKind: DreamTriggerKind;
-    statePort: DreamStatePort;
-    /** @deprecated Use modelAssistPort with RedactedEvidenceBundle (DR-027). */
-    modelPort?: DreamModelPort;
-    /**
-     * v7 ModelAssistPort — requires RedactedEvidenceBundle (DR-027).
-     * If both modelAssistPort and modelPort are provided, modelAssistPort takes precedence.
-     */
-    modelAssistPort?: ModelAssistPort;
-    tracePort?: DreamTracePort;
-    budgetPort?: DreamBudgetPort;
-    options?: {
-        timeWindowDays?: number;
-        evidenceLimit?: number;
-        maxCanonicalEntries?: number;
-        operatorTimeoutMs?: number;
-    };
-}
+/**
+ * Dream System core types.
+ *
+ * Dream is an async memory consolidation job. It reads source-backed life evidence,
+ * session chronicle, and existing memory store, then produces a candidate MemoryStore
+ * with canonical entries, insights, and optional narrative/relationship update proposals.
+ *
+ * Contract: input store is immutable; output is always candidate until validated and accepted.
+ * Test coverage: tests/integration/dream/t7-1-1-dream-pipeline.test.ts
+ */
+import type { CanonicalMemoryEntry, DreamInsight } from "../storage/memory-store/memory-store-lifecycle.js";
+export type { DreamInsight };
+export type DreamTriggerKind = "scheduled" | "evidence_threshold" | "manual" | "maintenance" | "quiet_completion";
+export type DreamRunStatus = "queued" | "running" | "completed" | "skipped" | "failed";
+export type DreamOutputStatus = "candidate" | "accepted" | "archived" | "partial";
+export type DreamMode = "rules_only" | "hybrid_llm" | "model_skipped";
+export interface DreamRun {
+    runId: string;
+    traceId: string;
+    triggerKind: DreamTriggerKind;
+    status: DreamRunStatus;
+    mode: DreamMode;
+    startedAt: string;
+    finishedAt?: string;
+    inputMemoryStoreId?: string;
+    outputMemoryStoreId?: string;
+    fallbackReason?: string;
+}
+export interface ToolExperienceSummary {
+    connectorId: string;
+    capabilityId: string;
+    outcome: string;
+    count: number;
+    lastRecordedAt: string;
+}
+export interface DreamInputBundle {
+    evidenceRefs: string[];
+    chronicleEntryIds: string[];
+    activeMemoryStoreId?: string;
+    narrativeSnapshotId?: string;
+    relationshipSnapshotId?: string;
+    goalSnapshotIds: string[];
+    toolExperienceSummaries?: ToolExperienceSummary[];
+    inputCounts: {
+        evidence: number;
+        chronicle: number;
+        memoryEntries: number;
+    };
+}
+export interface DreamNarrativeUpdate {
+    focus: string;
+    progressAdditions: string[];
+    nextIntent: string;
+    confidenceDelta: number;
+    sourceRefs: string[];
+    unsupportedClaims: string[];
+}
+export interface DreamRelationshipUpdate {
+    toneDelta?: string;
+    timingDelta?: string;
+    topicDelta?: string;
+    sourceRefs: string[];
+    confidence: number;
+}
+export interface DreamOutputValidation {
+    schemaValid: boolean;
+    sourceGrounded: boolean;
+    sensitivityClean: boolean;
+    unsupportedClaims: string[];
+    errors: string[];
+    checkedAt: string;
+}
+export interface DreamOutput {
+    outputId: string;
+    runId: string;
+    status: DreamOutputStatus;
+    inputMemoryStoreId?: string;
+    canonicalEntries: CanonicalMemoryEntry[];
+    insights: DreamInsight[];
+    narrativeUpdate?: DreamNarrativeUpdate;
+    relationshipUpdate?: DreamRelationshipUpdate;
+    validation: DreamOutputValidation;
+}
+export interface DreamTrace {
+    traceId: string;
+    runId: string;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    llmCostUsd?: number;
+    inputCounts: DreamInputBundle["inputCounts"];
+    fallbackReason?: string;
+    validationErrors?: string[];
+    timeoutMs?: number;
+    sensitivityFailure?: boolean;
+}
+export interface DreamRunResult {
+    runId: string;
+    status: DreamRunStatus;
+    output?: DreamOutput;
+    trace: DreamTrace;
+    fallbackReason?: string;
+}
+export interface DreamStatePort {
+    loadDreamInputs(query: {
+        timeWindowDays?: number;
+        evidenceLimit?: number;
+    }): Promise<DreamInputBundle>;
+    writeDreamOutput(output: DreamOutput): Promise<{
+        outputId: string;
+        status: "acknowledged" | "degraded";
+    }>;
+    markDreamOutputLifecycle(input: {
+        outputId: string;
+        newStatus: DreamOutputStatus;
+        validation?: DreamOutputValidation;
+        updatedAt: string;
+    }): Promise<{
+        outputId: string;
+        status: "acknowledged" | "degraded";
+    }>;
+}
+/**
+ * Brand type: evidence bundle that has passed through RedactionGate.
+ * TypeScript prevents passing un-redacted data to ModelAssistPort.
+ */
+export interface RedactedEvidenceBundle {
+    readonly _brand: "redacted";
+    readonly evidence: readonly string[];
+    readonly chronicle: readonly string[];
+    readonly memory?: readonly string[];
+}
+export interface ModelAssistPort {
+    /** Only accepts RedactedEvidenceBundle — TypeScript enforces prior redaction (DR-027). */
+    extractInsights(input: RedactedEvidenceBundle): Promise<{
+        insights: DreamInsight[];
+        narrativeUpdate?: DreamNarrativeUpdate;
+        relationshipUpdate?: DreamRelationshipUpdate;
+        unsupportedClaims: string[];
+        costUsd?: number;
+    }>;
+}
+/** @deprecated Use ModelAssistPort with RedactedEvidenceBundle (DR-027). */
+export interface DreamModelPort {
+    extractInsights(input: {
+        sampledEvidence: string[];
+        chronicleSummary: string;
+        activeMemorySummary?: string;
+        redacted: boolean;
+    }): Promise<{
+        insights: DreamInsight[];
+        narrativeUpdate?: DreamNarrativeUpdate;
+        relationshipUpdate?: DreamRelationshipUpdate;
+        unsupportedClaims: string[];
+        costUsd?: number;
+    }>;
+}
+export interface DreamTracePort {
+    recordDreamTrace(trace: DreamTrace): Promise<void>;
+}
+export interface DreamBudgetPort {
+    checkBudget(costEstimateUsd: number): Promise<{
+        allowed: boolean;
+        remainingUsd: number;
+    }>;
+}
+export interface DreamEngineInput {
+    runId: string;
+    traceId: string;
+    triggerKind: DreamTriggerKind;
+    statePort: DreamStatePort;
+    /** @deprecated Use modelAssistPort with RedactedEvidenceBundle (DR-027). */
+    modelPort?: DreamModelPort;
+    /**
+     * v7 ModelAssistPort — requires RedactedEvidenceBundle (DR-027).
+     * If both modelAssistPort and modelPort are provided, modelAssistPort takes precedence.
+     */
+    modelAssistPort?: ModelAssistPort;
+    tracePort?: DreamTracePort;
+    budgetPort?: DreamBudgetPort;
+    options?: {
+        timeWindowDays?: number;
+        evidenceLimit?: number;
+        maxCanonicalEntries?: number;
+        operatorTimeoutMs?: number;
+    };
+}

package/runtime/dream/types.js

@@ -1,11 +1,11 @@
-/**
- * Dream System core types.
- *
- * Dream is an async memory consolidation job. It reads source-backed life evidence,
- * session chronicle, and existing memory store, then produces a candidate MemoryStore
- * with canonical entries, insights, and optional narrative/relationship update proposals.
- *
- * Contract: input store is immutable; output is always candidate until validated and accepted.
- * Test coverage: tests/integration/dream/t7-1-1-dream-pipeline.test.ts
- */
-export {};
+/**
+ * Dream System core types.
+ *
+ * Dream is an async memory consolidation job. It reads source-backed life evidence,
+ * session chronicle, and existing memory store, then produces a candidate MemoryStore
+ * with canonical entries, insights, and optional narrative/relationship update proposals.
+ *
+ * Contract: input store is immutable; output is always candidate until validated and accepted.
+ * Test coverage: tests/integration/dream/t7-1-1-dream-pipeline.test.ts
+ */
+export {};

package/runtime/guidance/fallback.js

@@ -1,20 +1,20 @@
-import { buildOutputGuard, buildExpressionBoundary } from "./output-guard.js";
-import { getShortAtmosphereTemplate } from "./template-registry.js";
-export function buildMinimalGuidanceFallback(sceneContext) {
-    const atmosphereTemplate = getShortAtmosphereTemplate(sceneContext.mode, sceneContext.riskLevel);
-    return {
-        scene: sceneContext,
-        atmosphere: {
-            kind: "atmosphere",
-            text: atmosphereTemplate.text,
-            openness: sceneContext.mode === "quiet" ? "quiet" : sceneContext.riskLevel === "high" ? "narrow" : "open",
-            pressureLabels: [sceneContext.mode, sceneContext.riskLevel ?? "unknown_risk"],
-            reviewStatus: atmosphereTemplate.reviewStatus,
-        },
-        impulses: [],
-        personaReinforcement: [],
-        outputGuard: buildOutputGuard(sceneContext.sceneType),
-        expressionBoundary: buildExpressionBoundary(sceneContext.sceneType),
-        minimal: true,
-    };
-}
+import { buildOutputGuard, buildExpressionBoundary } from "./output-guard.js";
+import { getShortAtmosphereTemplate } from "./template-registry.js";
+export function buildMinimalGuidanceFallback(sceneContext) {
+    const atmosphereTemplate = getShortAtmosphereTemplate(sceneContext.mode, sceneContext.riskLevel);
+    return {
+        scene: sceneContext,
+        atmosphere: {
+            kind: "atmosphere",
+            text: atmosphereTemplate.text,
+            openness: sceneContext.mode === "quiet" ? "quiet" : sceneContext.riskLevel === "high" ? "narrow" : "open",
+            pressureLabels: [sceneContext.mode, sceneContext.riskLevel ?? "unknown_risk"],
+            reviewStatus: atmosphereTemplate.reviewStatus,
+        },
+        impulses: [],
+        personaReinforcement: [],
+        outputGuard: buildOutputGuard(sceneContext.sceneType),
+        expressionBoundary: buildExpressionBoundary(sceneContext.sceneType),
+        minimal: true,
+    };
+}