@haaaiawd/second-nature 0.1.17 → 0.1.18

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";

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

@@ -1,228 +1,228 @@
-/**
- * Outreach draft request contracts + zod validation (T6.1.1 / behavioral-guidance-system v5).
- *
- * Core logic: strict schema for control-plane → guidance handoff; GuidanceDraftPort documents async seam.
- * Test coverage: tests/unit/guidance/outreach-draft-schema.test.ts
- */
-import { z } from "zod";
-export declare const guidanceSourceRefSchema: z.ZodObject<{
-    id: z.ZodString;
-    kind: z.ZodEnum<{
-        platform_item: "platform_item";
-        workspace_artifact: "workspace_artifact";
-        decision_record: "decision_record";
-        user_anchor: "user_anchor";
-        connector_result: "connector_result";
-        host_report: "host_report";
-        fallback_artifact: "fallback_artifact";
-    }>;
-    uri: z.ZodString;
-    excerptHash: z.ZodOptional<z.ZodString>;
-    observedAt: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type GuidanceSourceRef = z.infer<typeof guidanceSourceRefSchema>;
-export declare const deliveryExpressionContextSchema: z.ZodObject<{
-    deliveryVerdict: z.ZodEnum<{
-        target_none: "target_none";
-        channel_missing: "channel_missing";
-        host_unsupported: "host_unsupported";
-        delivery_failed: "delivery_failed";
-        target_available: "target_available";
-    }>;
-    fallbackRef: z.ZodOptional<z.ZodString>;
-    wordingMode: z.ZodEnum<{
-        sendable: "sendable";
-        not_sent_fallback_candidate: "not_sent_fallback_candidate";
-    }>;
-}, z.core.$strip>;
-export declare const sceneGuidanceRequestSchema: z.ZodObject<{
-    requestId: z.ZodString;
-    sceneType: z.ZodEnum<{
-        outreach: "outreach";
-        explain: "explain";
-        social: "social";
-        quiet_reflection: "quiet_reflection";
-        user_reply_continuity: "user_reply_continuity";
-        fallback_candidate: "fallback_candidate";
-    }>;
-    runtimeScope: z.ZodEnum<{
-        rhythm: "rhythm";
-        user_reply: "user_reply";
-        user_task: "user_task";
-    }>;
-    rhythmWindowKind: z.ZodOptional<z.ZodEnum<{
-        quiet: "quiet";
-        social: "social";
-        work: "work";
-        exploration: "exploration";
-        reflection: "reflection";
-        maintenance: "maintenance";
-    }>>;
-    riskLevel: z.ZodEnum<{
-        medium: "medium";
-        low: "low";
-        high: "high";
-    }>;
-    sourceRefs: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        kind: z.ZodEnum<{
-            platform_item: "platform_item";
-            workspace_artifact: "workspace_artifact";
-            decision_record: "decision_record";
-            user_anchor: "user_anchor";
-            connector_result: "connector_result";
-            host_report: "host_report";
-            fallback_artifact: "fallback_artifact";
-        }>;
-        uri: z.ZodString;
-        excerptHash: z.ZodOptional<z.ZodString>;
-        observedAt: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    deliveryContext: z.ZodOptional<z.ZodObject<{
-        deliveryVerdict: z.ZodEnum<{
-            target_none: "target_none";
-            channel_missing: "channel_missing";
-            host_unsupported: "host_unsupported";
-            delivery_failed: "delivery_failed";
-            target_available: "target_available";
-        }>;
-        fallbackRef: z.ZodOptional<z.ZodString>;
-        wordingMode: z.ZodEnum<{
-            sendable: "sendable";
-            not_sent_fallback_candidate: "not_sent_fallback_candidate";
-        }>;
-    }, z.core.$strip>>;
-    language: z.ZodOptional<z.ZodEnum<{
-        "en-US": "en-US";
-        "zh-CN": "zh-CN";
-    }>>;
-}, z.core.$strip>;
-export declare const outreachDraftRequestSchema: z.ZodObject<{
-    requestId: z.ZodString;
-    runtimeScope: z.ZodEnum<{
-        rhythm: "rhythm";
-        user_reply: "user_reply";
-        user_task: "user_task";
-    }>;
-    rhythmWindowKind: z.ZodOptional<z.ZodEnum<{
-        quiet: "quiet";
-        social: "social";
-        work: "work";
-        exploration: "exploration";
-        reflection: "reflection";
-        maintenance: "maintenance";
-    }>>;
-    riskLevel: z.ZodEnum<{
-        medium: "medium";
-        low: "low";
-        high: "high";
-    }>;
-    sourceRefs: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        kind: z.ZodEnum<{
-            platform_item: "platform_item";
-            workspace_artifact: "workspace_artifact";
-            decision_record: "decision_record";
-            user_anchor: "user_anchor";
-            connector_result: "connector_result";
-            host_report: "host_report";
-            fallback_artifact: "fallback_artifact";
-        }>;
-        uri: z.ZodString;
-        excerptHash: z.ZodOptional<z.ZodString>;
-        observedAt: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    deliveryContext: z.ZodOptional<z.ZodObject<{
-        deliveryVerdict: z.ZodEnum<{
-            target_none: "target_none";
-            channel_missing: "channel_missing";
-            host_unsupported: "host_unsupported";
-            delivery_failed: "delivery_failed";
-            target_available: "target_available";
-        }>;
-        fallbackRef: z.ZodOptional<z.ZodString>;
-        wordingMode: z.ZodEnum<{
-            sendable: "sendable";
-            not_sent_fallback_candidate: "not_sent_fallback_candidate";
-        }>;
-    }, z.core.$strip>>;
-    language: z.ZodOptional<z.ZodEnum<{
-        "en-US": "en-US";
-        "zh-CN": "zh-CN";
-    }>>;
-    sceneType: z.ZodEnum<{
-        outreach: "outreach";
-        fallback_candidate: "fallback_candidate";
-    }>;
-    decisionId: z.ZodString;
-    candidateId: z.ZodString;
-    judgmentVerdict: z.ZodEnum<{
-        allow: "allow";
-        deny: "deny";
-        defer: "defer";
-    }>;
-    valueScore: z.ZodNumber;
-    interestRefs: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        kind: z.ZodEnum<{
-            platform_item: "platform_item";
-            workspace_artifact: "workspace_artifact";
-            decision_record: "decision_record";
-            user_anchor: "user_anchor";
-            connector_result: "connector_result";
-            host_report: "host_report";
-            fallback_artifact: "fallback_artifact";
-        }>;
-        uri: z.ZodString;
-        excerptHash: z.ZodOptional<z.ZodString>;
-        observedAt: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type SceneGuidanceRequest = z.infer<typeof sceneGuidanceRequestSchema>;
-export type OutreachDraftRequest = z.infer<typeof outreachDraftRequestSchema>;
-export type DeliveryExpressionContext = z.infer<typeof deliveryExpressionContextSchema>;
-export declare function parseOutreachDraftRequest(input: unknown): OutreachDraftRequest;
-export declare function safeParseOutreachDraftRequest(input: unknown): z.ZodSafeParseResult<{
-    requestId: string;
-    runtimeScope: "rhythm" | "user_reply" | "user_task";
-    riskLevel: "medium" | "low" | "high";
-    sourceRefs: {
-        id: string;
-        kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
-        uri: string;
-        excerptHash?: string | undefined;
-        observedAt?: string | undefined;
-    }[];
-    sceneType: "outreach" | "fallback_candidate";
-    decisionId: string;
-    candidateId: string;
-    judgmentVerdict: "allow" | "deny" | "defer";
-    valueScore: number;
-    interestRefs: {
-        id: string;
-        kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
-        uri: string;
-        excerptHash?: string | undefined;
-        observedAt?: string | undefined;
-    }[];
-    rhythmWindowKind?: "quiet" | "social" | "work" | "exploration" | "reflection" | "maintenance" | undefined;
-    deliveryContext?: {
-        deliveryVerdict: "target_none" | "channel_missing" | "host_unsupported" | "delivery_failed" | "target_available";
-        wordingMode: "sendable" | "not_sent_fallback_candidate";
-        fallbackRef?: string | undefined;
-    } | undefined;
-    language?: "en-US" | "zh-CN" | undefined;
-}>;
-/** Async seam for generative outreach copy (implementation lives outside control-plane). */
-export interface GuidanceDraftPort {
-    draftOutreachMessage(request: OutreachDraftRequest): Promise<{
-        status: "ready";
-        draft: {
-            text: string;
-            deliveryWording: DeliveryExpressionContext["wordingMode"];
-        };
-    } | {
-        status: "unavailable";
-        reasons: string[];
-    }>;
-}
+/**
+ * Outreach draft request contracts + zod validation (T6.1.1 / behavioral-guidance-system v5).
+ *
+ * Core logic: strict schema for control-plane → guidance handoff; GuidanceDraftPort documents async seam.
+ * Test coverage: tests/unit/guidance/outreach-draft-schema.test.ts
+ */
+import { z } from "zod";
+export declare const guidanceSourceRefSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        platform_item: "platform_item";
+        workspace_artifact: "workspace_artifact";
+        decision_record: "decision_record";
+        user_anchor: "user_anchor";
+        connector_result: "connector_result";
+        host_report: "host_report";
+        fallback_artifact: "fallback_artifact";
+    }>;
+    uri: z.ZodString;
+    excerptHash: z.ZodOptional<z.ZodString>;
+    observedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GuidanceSourceRef = z.infer<typeof guidanceSourceRefSchema>;
+export declare const deliveryExpressionContextSchema: z.ZodObject<{
+    deliveryVerdict: z.ZodEnum<{
+        target_none: "target_none";
+        channel_missing: "channel_missing";
+        host_unsupported: "host_unsupported";
+        delivery_failed: "delivery_failed";
+        target_available: "target_available";
+    }>;
+    fallbackRef: z.ZodOptional<z.ZodString>;
+    wordingMode: z.ZodEnum<{
+        sendable: "sendable";
+        not_sent_fallback_candidate: "not_sent_fallback_candidate";
+    }>;
+}, z.core.$strip>;
+export declare const sceneGuidanceRequestSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    sceneType: z.ZodEnum<{
+        outreach: "outreach";
+        explain: "explain";
+        social: "social";
+        quiet_reflection: "quiet_reflection";
+        user_reply_continuity: "user_reply_continuity";
+        fallback_candidate: "fallback_candidate";
+    }>;
+    runtimeScope: z.ZodEnum<{
+        rhythm: "rhythm";
+        user_reply: "user_reply";
+        user_task: "user_task";
+    }>;
+    rhythmWindowKind: z.ZodOptional<z.ZodEnum<{
+        quiet: "quiet";
+        social: "social";
+        work: "work";
+        exploration: "exploration";
+        reflection: "reflection";
+        maintenance: "maintenance";
+    }>>;
+    riskLevel: z.ZodEnum<{
+        medium: "medium";
+        low: "low";
+        high: "high";
+    }>;
+    sourceRefs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            platform_item: "platform_item";
+            workspace_artifact: "workspace_artifact";
+            decision_record: "decision_record";
+            user_anchor: "user_anchor";
+            connector_result: "connector_result";
+            host_report: "host_report";
+            fallback_artifact: "fallback_artifact";
+        }>;
+        uri: z.ZodString;
+        excerptHash: z.ZodOptional<z.ZodString>;
+        observedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    deliveryContext: z.ZodOptional<z.ZodObject<{
+        deliveryVerdict: z.ZodEnum<{
+            target_none: "target_none";
+            channel_missing: "channel_missing";
+            host_unsupported: "host_unsupported";
+            delivery_failed: "delivery_failed";
+            target_available: "target_available";
+        }>;
+        fallbackRef: z.ZodOptional<z.ZodString>;
+        wordingMode: z.ZodEnum<{
+            sendable: "sendable";
+            not_sent_fallback_candidate: "not_sent_fallback_candidate";
+        }>;
+    }, z.core.$strip>>;
+    language: z.ZodOptional<z.ZodEnum<{
+        "en-US": "en-US";
+        "zh-CN": "zh-CN";
+    }>>;
+}, z.core.$strip>;
+export declare const outreachDraftRequestSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    runtimeScope: z.ZodEnum<{
+        rhythm: "rhythm";
+        user_reply: "user_reply";
+        user_task: "user_task";
+    }>;
+    rhythmWindowKind: z.ZodOptional<z.ZodEnum<{
+        quiet: "quiet";
+        social: "social";
+        work: "work";
+        exploration: "exploration";
+        reflection: "reflection";
+        maintenance: "maintenance";
+    }>>;
+    riskLevel: z.ZodEnum<{
+        medium: "medium";
+        low: "low";
+        high: "high";
+    }>;
+    sourceRefs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            platform_item: "platform_item";
+            workspace_artifact: "workspace_artifact";
+            decision_record: "decision_record";
+            user_anchor: "user_anchor";
+            connector_result: "connector_result";
+            host_report: "host_report";
+            fallback_artifact: "fallback_artifact";
+        }>;
+        uri: z.ZodString;
+        excerptHash: z.ZodOptional<z.ZodString>;
+        observedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    deliveryContext: z.ZodOptional<z.ZodObject<{
+        deliveryVerdict: z.ZodEnum<{
+            target_none: "target_none";
+            channel_missing: "channel_missing";
+            host_unsupported: "host_unsupported";
+            delivery_failed: "delivery_failed";
+            target_available: "target_available";
+        }>;
+        fallbackRef: z.ZodOptional<z.ZodString>;
+        wordingMode: z.ZodEnum<{
+            sendable: "sendable";
+            not_sent_fallback_candidate: "not_sent_fallback_candidate";
+        }>;
+    }, z.core.$strip>>;
+    language: z.ZodOptional<z.ZodEnum<{
+        "en-US": "en-US";
+        "zh-CN": "zh-CN";
+    }>>;
+    sceneType: z.ZodEnum<{
+        outreach: "outreach";
+        fallback_candidate: "fallback_candidate";
+    }>;
+    decisionId: z.ZodString;
+    candidateId: z.ZodString;
+    judgmentVerdict: z.ZodEnum<{
+        allow: "allow";
+        deny: "deny";
+        defer: "defer";
+    }>;
+    valueScore: z.ZodNumber;
+    interestRefs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            platform_item: "platform_item";
+            workspace_artifact: "workspace_artifact";
+            decision_record: "decision_record";
+            user_anchor: "user_anchor";
+            connector_result: "connector_result";
+            host_report: "host_report";
+            fallback_artifact: "fallback_artifact";
+        }>;
+        uri: z.ZodString;
+        excerptHash: z.ZodOptional<z.ZodString>;
+        observedAt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SceneGuidanceRequest = z.infer<typeof sceneGuidanceRequestSchema>;
+export type OutreachDraftRequest = z.infer<typeof outreachDraftRequestSchema>;
+export type DeliveryExpressionContext = z.infer<typeof deliveryExpressionContextSchema>;
+export declare function parseOutreachDraftRequest(input: unknown): OutreachDraftRequest;
+export declare function safeParseOutreachDraftRequest(input: unknown): z.ZodSafeParseResult<{
+    requestId: string;
+    runtimeScope: "rhythm" | "user_reply" | "user_task";
+    riskLevel: "medium" | "low" | "high";
+    sourceRefs: {
+        id: string;
+        kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
+        uri: string;
+        excerptHash?: string | undefined;
+        observedAt?: string | undefined;
+    }[];
+    sceneType: "outreach" | "fallback_candidate";
+    decisionId: string;
+    candidateId: string;
+    judgmentVerdict: "allow" | "deny" | "defer";
+    valueScore: number;
+    interestRefs: {
+        id: string;
+        kind: "platform_item" | "workspace_artifact" | "decision_record" | "user_anchor" | "connector_result" | "host_report" | "fallback_artifact";
+        uri: string;
+        excerptHash?: string | undefined;
+        observedAt?: string | undefined;
+    }[];
+    rhythmWindowKind?: "quiet" | "social" | "work" | "exploration" | "reflection" | "maintenance" | undefined;
+    deliveryContext?: {
+        deliveryVerdict: "target_none" | "channel_missing" | "host_unsupported" | "delivery_failed" | "target_available";
+        wordingMode: "sendable" | "not_sent_fallback_candidate";
+        fallbackRef?: string | undefined;
+    } | undefined;
+    language?: "en-US" | "zh-CN" | undefined;
+}>;
+/** Async seam for generative outreach copy (implementation lives outside control-plane). */
+export interface GuidanceDraftPort {
+    draftOutreachMessage(request: OutreachDraftRequest): Promise<{
+        status: "ready";
+        draft: {
+            text: string;
+            deliveryWording: DeliveryExpressionContext["wordingMode"];
+        };
+    } | {
+        status: "unavailable";
+        reasons: string[];
+    }>;
+}