@haaaiawd/second-nature 0.1.18 → 0.1.20

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[];
+};

package/runtime/guidance/evidence-guidance.js

@@ -1,52 +1,52 @@
-export function buildEvidencePack(refs, opts) {
-    const policy = opts?.policy ?? "strict";
-    const unresolvedIds = [];
-    let sensitiveBlocked = false;
-    const grounded = [];
-    for (const r of refs) {
-        if (!r.uri?.trim()) {
-            unresolvedIds.push(r.id);
-            continue;
-        }
-        if (r.uri.includes("credential") || r.uri.includes("secret")) {
-            sensitiveBlocked = true;
-            continue;
-        }
-        grounded.push(r);
-    }
-    if (policy === "strict" && unresolvedIds.length > 0) {
-        return { ok: false, reasons: ["unresolved_source_refs", ...unresolvedIds.slice(0, 3)] };
-    }
-    return {
-        ok: true,
-        pack: {
-            groundedRefs: grounded,
-            unresolvedIds,
-            sensitiveBlocked,
-            policy,
-        },
-    };
-}
-export function selectInterestBasis(input) {
-    if (input.staleness === "insufficient" || input.confidence < 0.15) {
-        return input.signalCount > 0 ? "evidence_only" : "unavailable";
-    }
-    if (input.staleness === "stale") {
-        return "evidence_only";
-    }
-    return "interest_augmented";
-}
-export function buildQuietNarrativeGuidance(input) {
-    if (input.interestBasis === "unavailable" && input.sourceCoverage.coverageRatio < 0.25) {
-        return { status: "unavailable", reasons: ["quiet_guidance_insufficient_interest_and_coverage"] };
-    }
-    if (input.sourceCoverage.unsupportedClaims.length > 0) {
-        return { status: "unavailable", reasons: ["quiet_guidance_unsupported_claims"] };
-    }
-    const hints = [
-        ...input.outline.slice(0, 3).map((line) => `hint:${line}`),
-        `basis:${input.interestBasis}`,
-        `coverage:${input.sourceCoverage.coverageRatio.toFixed(2)}`,
-    ];
-    return { status: "ready", hints };
-}
+export function buildEvidencePack(refs, opts) {
+    const policy = opts?.policy ?? "strict";
+    const unresolvedIds = [];
+    let sensitiveBlocked = false;
+    const grounded = [];
+    for (const r of refs) {
+        if (!r.uri?.trim()) {
+            unresolvedIds.push(r.id);
+            continue;
+        }
+        if (r.uri.includes("credential") || r.uri.includes("secret")) {
+            sensitiveBlocked = true;
+            continue;
+        }
+        grounded.push(r);
+    }
+    if (policy === "strict" && unresolvedIds.length > 0) {
+        return { ok: false, reasons: ["unresolved_source_refs", ...unresolvedIds.slice(0, 3)] };
+    }
+    return {
+        ok: true,
+        pack: {
+            groundedRefs: grounded,
+            unresolvedIds,
+            sensitiveBlocked,
+            policy,
+        },
+    };
+}
+export function selectInterestBasis(input) {
+    if (input.staleness === "insufficient" || input.confidence < 0.15) {
+        return input.signalCount > 0 ? "evidence_only" : "unavailable";
+    }
+    if (input.staleness === "stale") {
+        return "evidence_only";
+    }
+    return "interest_augmented";
+}
+export function buildQuietNarrativeGuidance(input) {
+    if (input.interestBasis === "unavailable" && input.sourceCoverage.coverageRatio < 0.25) {
+        return { status: "unavailable", reasons: ["quiet_guidance_insufficient_interest_and_coverage"] };
+    }
+    if (input.sourceCoverage.unsupportedClaims.length > 0) {
+        return { status: "unavailable", reasons: ["quiet_guidance_unsupported_claims"] };
+    }
+    const hints = [
+        ...input.outline.slice(0, 3).map((line) => `hint:${line}`),
+        `basis:${input.interestBasis}`,
+        `coverage:${input.sourceCoverage.coverageRatio.toFixed(2)}`,
+    ];
+    return { status: "ready", hints };
+}

package/runtime/guidance/index.d.ts

@@ -1,11 +1,11 @@
-export * from "./types.js";
-export * from "./contracts.js";
-export * from "./persona-selection.js";
-export * from "./output-guard.js";
-export * from "./fallback.js";
-export * from "./template-registry.js";
-export * from "./review-workflow.js";
-export * from "./guidance-assembler.js";
-export * from "./outreach-draft-schema.js";
-export * from "./draft-outreach-message.js";
-export * from "./evidence-guidance.js";
+export * from "./types.js";
+export * from "./contracts.js";
+export * from "./persona-selection.js";
+export * from "./output-guard.js";
+export * from "./fallback.js";
+export * from "./template-registry.js";
+export * from "./review-workflow.js";
+export * from "./guidance-assembler.js";
+export * from "./outreach-draft-schema.js";
+export * from "./draft-outreach-message.js";
+export * from "./evidence-guidance.js";

package/runtime/guidance/index.js

@@ -1,11 +1,11 @@
-export * from "./types.js";
-export * from "./contracts.js";
-export * from "./persona-selection.js";
-export * from "./output-guard.js";
-export * from "./fallback.js";
-export * from "./template-registry.js";
-export * from "./review-workflow.js";
-export * from "./guidance-assembler.js";
-export * from "./outreach-draft-schema.js";
-export * from "./draft-outreach-message.js";
-export * from "./evidence-guidance.js";
+export * from "./types.js";
+export * from "./contracts.js";
+export * from "./persona-selection.js";
+export * from "./output-guard.js";
+export * from "./fallback.js";
+export * from "./template-registry.js";
+export * from "./review-workflow.js";
+export * from "./guidance-assembler.js";
+export * from "./outreach-draft-schema.js";
+export * from "./draft-outreach-message.js";
+export * from "./evidence-guidance.js";