@haaaiawd/second-nature 0.1.38 → 0.1.39

package/runtime/dream/sampler.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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
+ */
+export interface SamplerInput {
+    evidenceSummaries: Array<{
+        id: string;
+        summary: string;
+        createdAt: string;
+        kind?: string;
+        confidence?: number;
+    }>;
+    chronicleSummaries: Array<{
+        id: string;
+        summary: string;
+        createdAt: string;
+    }>;
+    evidenceLimit?: number;
+}
+export interface SamplerResult {
+    sampledEvidenceIds: string[];
+    sampledChronicleIds: string[];
+    droppedCount: number;
+    reason: string;
+}
+export declare function sampleDreamInput(input: SamplerInput): SamplerResult;

package/runtime/dream/sampler.js

@@ -0,0 +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,
+    };
+}

package/runtime/dream/types.d.ts

@@ -0,0 +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;
+    };
+}

package/runtime/dream/types.js

@@ -0,0 +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 {};

package/runtime/guidance/fallback.js

@@ -1,17 +1,20 @@
-import { buildOutputGuard } from "./output-guard.js";
-export function buildMinimalGuidanceFallback(sceneContext) {
-    return {
-        scene: sceneContext,
-        atmosphere: {
-            kind: "atmosphere",
-            text: "我先保留最小但真实的状态感，不因为 guidance 缺席就假装自己失去姿态。",
-            openness: sceneContext.mode === "quiet" ? "quiet" : sceneContext.riskLevel === "high" ? "narrow" : "open",
-            pressureLabels: [sceneContext.mode, sceneContext.riskLevel ?? "unknown_risk"],
-            reviewStatus: "pending_human_review",
-        },
-        impulses: [],
-        personaReinforcement: [],
-        outputGuard: buildOutputGuard(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,
+    };
+}

package/runtime/guidance/guidance-assembler.js

@@ -1,74 +1,76 @@
-import { buildMinimalGuidanceFallback } from "./fallback.js";
-import { buildOutputGuard } from "./output-guard.js";
-import { selectPersonaSnippets } from "./persona-selection.js";
-import { getBaselineAtmosphereTemplate } from "./template-registry.js";
-import { assembleImpulse } from "./impulse-assembler.js";
-async function buildAtmosphere(sceneContext) {
-    const template = getBaselineAtmosphereTemplate();
-    return {
-        kind: "atmosphere",
-        text: template.text,
-        openness: sceneContext.mode === "quiet" ? "quiet" : sceneContext.riskLevel === "high" ? "narrow" : "open",
-        pressureLabels: [sceneContext.mode, sceneContext.riskLevel ?? "unknown_risk"],
-        reviewStatus: template.reviewStatus,
-    };
-}
-/**
- * Select impulses using the dual-axis capabilityClass assembler (T-V7C.C.4R).
- *
- * Fallback chain: platform-specific → capabilityClass preset → intentKind → []
- */
-async function selectImpulses(sceneContext, deps) {
-    if (sceneContext.sceneType === "explain" || sceneContext.sceneType === "user_reply") {
-        return [];
-    }
-    const result = await assembleImpulse({
-        sceneType: sceneContext.sceneType,
-        capabilityIntent: sceneContext.capabilityIntent,
-        platformId: sceneContext.platformId,
-    }, deps);
-    return result.impulse ? [result.impulse] : [];
-}
-export async function assembleGuidance(input) {
-    if (!input.sceneContext) {
-        return {
-            available: false,
-            reason: "missing_scene_context",
-        };
-    }
-    const sceneContext = input.sceneContext;
-    const deps = { platformImpulsePort: input.platformImpulsePort };
-    try {
-        const [atmosphere, impulses] = await Promise.all([
-            buildAtmosphere(sceneContext),
-            selectImpulses(sceneContext, deps),
-        ]);
-        const personaDecision = selectPersonaSnippets({
-            sceneContext,
-            candidates: input.personaCandidates ?? [],
-        });
-        return {
-            scene: sceneContext,
-            atmosphere,
-            impulses,
-            personaReinforcement: personaDecision.snippets,
-            outputGuard: buildOutputGuard(sceneContext.sceneType),
-        };
-    }
-    catch {
-        if ((input.personaCandidates ?? []).length === 0) {
-            const fallback = buildMinimalGuidanceFallback(sceneContext);
-            return {
-                scene: fallback.scene,
-                atmosphere: fallback.atmosphere,
-                impulses: fallback.impulses,
-                personaReinforcement: fallback.personaReinforcement,
-                outputGuard: fallback.outputGuard,
-            };
-        }
-        return {
-            available: false,
-            reason: "missing_template",
-        };
-    }
-}
+import { buildMinimalGuidanceFallback } from "./fallback.js";
+import { buildOutputGuard, buildExpressionBoundary } from "./output-guard.js";
+import { selectPersonaSnippets } from "./persona-selection.js";
+import { getShortAtmosphereTemplate } from "./template-registry.js";
+import { assembleImpulse } from "./impulse-assembler.js";
+async function buildAtmosphere(sceneContext) {
+    const template = getShortAtmosphereTemplate(sceneContext.mode, sceneContext.riskLevel);
+    return {
+        kind: "atmosphere",
+        text: template.text,
+        openness: sceneContext.mode === "quiet" ? "quiet" : sceneContext.riskLevel === "high" ? "narrow" : "open",
+        pressureLabels: [sceneContext.mode, sceneContext.riskLevel ?? "unknown_risk"],
+        reviewStatus: template.reviewStatus,
+    };
+}
+/**
+ * Select impulses using the dual-axis capabilityClass assembler (T-V7C.C.4R).
+ *
+ * Fallback chain: platform-specific → capabilityClass preset → intentKind → []
+ */
+async function selectImpulses(sceneContext, deps) {
+    if (sceneContext.sceneType === "explain" || sceneContext.sceneType === "user_reply") {
+        return [];
+    }
+    const result = await assembleImpulse({
+        sceneType: sceneContext.sceneType,
+        capabilityIntent: sceneContext.capabilityIntent,
+        platformId: sceneContext.platformId,
+    }, deps);
+    return result.impulse ? [result.impulse] : [];
+}
+export async function assembleGuidance(input) {
+    if (!input.sceneContext) {
+        return {
+            available: false,
+            reason: "missing_scene_context",
+        };
+    }
+    const sceneContext = input.sceneContext;
+    const deps = { platformImpulsePort: input.platformImpulsePort };
+    try {
+        const [atmosphere, impulses] = await Promise.all([
+            buildAtmosphere(sceneContext),
+            selectImpulses(sceneContext, deps),
+        ]);
+        const personaDecision = selectPersonaSnippets({
+            sceneContext,
+            candidates: input.personaCandidates ?? [],
+        });
+        return {
+            scene: sceneContext,
+            atmosphere,
+            impulses,
+            personaReinforcement: personaDecision.snippets,
+            outputGuard: buildOutputGuard(sceneContext.sceneType),
+            expressionBoundary: buildExpressionBoundary(sceneContext.sceneType),
+        };
+    }
+    catch {
+        if ((input.personaCandidates ?? []).length === 0) {
+            const fallback = buildMinimalGuidanceFallback(sceneContext);
+            return {
+                scene: fallback.scene,
+                atmosphere: fallback.atmosphere,
+                impulses: fallback.impulses,
+                personaReinforcement: fallback.personaReinforcement,
+                outputGuard: fallback.outputGuard,
+                expressionBoundary: fallback.expressionBoundary,
+            };
+        }
+        return {
+            available: false,
+            reason: "missing_template",
+        };
+    }
+}

package/runtime/guidance/output-guard.d.ts

@@ -1,10 +1,13 @@
-import type { GuardBlock, GuidanceSceneType } from "./types.js";
-export type OutputGuardConstraintId = "avoid_customer_service_tone" | "avoid_daily_report_tone" | "avoid_teaching_template_tone" | "avoid_fabricated_experience" | "avoid_repetitive_phrasing";
-export interface OutputGuardDefinition {
-    sceneType: GuidanceSceneType;
-    constraints: OutputGuardConstraintId[];
-    hardGuardPriority: true;
-    note: "output_guard_only_shapes_expression";
-}
-export declare function buildOutputGuard(sceneType: GuidanceSceneType): GuardBlock;
-export declare function getOutputGuardDefinition(sceneType: GuidanceSceneType): OutputGuardDefinition;
+import type { GuardBlock, ExpressionBoundaryBlock, GuidanceSceneType } from "./types.js";
+export type OutputGuardConstraintId = "avoid_customer_service_tone" | "avoid_daily_report_tone" | "avoid_teaching_template_tone" | "avoid_fabricated_experience" | "avoid_repetitive_phrasing";
+export interface OutputGuardDefinition {
+    sceneType: GuidanceSceneType;
+    constraints: OutputGuardConstraintId[];
+    hardGuardPriority: true;
+    note: "output_guard_only_shapes_expression";
+}
+/** @deprecated Use buildExpressionBoundary for new code. Kept for backward compatibility. */
+export declare function buildOutputGuard(sceneType: GuidanceSceneType): GuardBlock;
+export declare function getOutputGuardDefinition(sceneType: GuidanceSceneType): OutputGuardDefinition;
+export type ExpressionConstraintId = "avoid_customer_service_tone" | "avoid_daily_report_tone" | "avoid_teaching_template_tone" | "avoid_fabricated_experience" | "avoid_repetitive_phrasing";
+export declare function buildExpressionBoundary(_sceneType: GuidanceSceneType): ExpressionBoundaryBlock;

package/runtime/guidance/output-guard.js

@@ -1,29 +1,53 @@
-const SHARED_CONSTRAINTS = [
-    "avoid_customer_service_tone",
-    "avoid_daily_report_tone",
-    "avoid_teaching_template_tone",
-    "avoid_fabricated_experience",
-    "avoid_repetitive_phrasing",
-];
-const SCENE_NOTES = {
-    avoid_customer_service_tone: "不要把自己说成客服或通知系统。",
-    avoid_daily_report_tone: "不要把表达压扁成日报、周报或例行播报。",
-    avoid_teaching_template_tone: "不要把表达写成教程、步骤说明或培训手册。",
-    avoid_fabricated_experience: "不要虚构经历、关系、情绪事件或未发生的观察。",
-    avoid_repetitive_phrasing: "不要滑进高重复、硬模板化或近似复读的措辞。",
-};
-export function buildOutputGuard(sceneType) {
-    return {
-        kind: "output_guard",
-        constraints: SHARED_CONSTRAINTS.map((constraint) => SCENE_NOTES[constraint]),
-        hardGuardPriority: true,
-    };
-}
-export function getOutputGuardDefinition(sceneType) {
-    return {
-        sceneType,
-        constraints: [...SHARED_CONSTRAINTS],
-        hardGuardPriority: true,
-        note: "output_guard_only_shapes_expression",
-    };
-}
+const SHARED_CONSTRAINTS = [
+    "avoid_customer_service_tone",
+    "avoid_daily_report_tone",
+    "avoid_teaching_template_tone",
+    "avoid_fabricated_experience",
+    "avoid_repetitive_phrasing",
+];
+const SCENE_NOTES = {
+    avoid_customer_service_tone: "不要把自己说成客服或通知系统。",
+    avoid_daily_report_tone: "不要把表达压扁成日报、周报或例行播报。",
+    avoid_teaching_template_tone: "不要把表达写成教程、步骤说明或培训手册。",
+    avoid_fabricated_experience: "不要虚构经历、关系、情绪事件或未发生的观察。",
+    avoid_repetitive_phrasing: "不要滑进高重复、硬模板化或近似复读的措辞。",
+};
+/** @deprecated Use buildExpressionBoundary for new code. Kept for backward compatibility. */
+export function buildOutputGuard(sceneType) {
+    return {
+        kind: "output_guard",
+        constraints: SHARED_CONSTRAINTS.map((constraint) => SCENE_NOTES[constraint]),
+        hardGuardPriority: true,
+        _semanticNote: "output_guard_only_shapes_expression",
+    };
+}
+export function getOutputGuardDefinition(sceneType) {
+    return {
+        sceneType,
+        constraints: [...SHARED_CONSTRAINTS],
+        hardGuardPriority: true,
+        note: "output_guard_only_shapes_expression",
+    };
+}
+const EXPRESSION_CONSTRAINTS = [
+    "avoid_customer_service_tone",
+    "avoid_daily_report_tone",
+    "avoid_teaching_template_tone",
+    "avoid_fabricated_experience",
+    "avoid_repetitive_phrasing",
+];
+const EXPRESSION_NOTES = {
+    avoid_customer_service_tone: "避免客服腔或通知系统语气。",
+    avoid_daily_report_tone: "避免日报、周报或例行播报腔。",
+    avoid_teaching_template_tone: "避免教程、步骤说明或培训手册腔。",
+    avoid_fabricated_experience: "避免虚构经历、关系、情绪事件或未发生的观察。",
+    avoid_repetitive_phrasing: "避免高重复、硬模板化或近似复读的措辞。",
+};
+export function buildExpressionBoundary(_sceneType) {
+    return {
+        kind: "expression_boundary",
+        constraints: EXPRESSION_CONSTRAINTS.map((c) => EXPRESSION_NOTES[c]),
+        style: "avoid_prefer",
+        ownership: "behavioral_guidance_system",
+    };
+}

package/runtime/guidance/template-registry.d.ts

@@ -1,16 +1,20 @@
-import type { AtmosphereBlock, GuidanceSceneType, ImpulseBlock, ImpulseKind } from "./types.js";
-type CoreSceneKind = Exclude<GuidanceSceneType, "explain" | "user_reply">;
-export declare function getBaselineAtmosphereTemplate(): Pick<AtmosphereBlock, "kind" | "text" | "reviewStatus">;
-export declare function getImpulseTemplate(sceneType: CoreSceneKind): ImpulseBlock;
-/**
- * Get impulse template for capability-class-derived ImpulseKinds (explore / work).
- *
- * Returns null when:
- * - The kind has no registered text (pending_human_review state)
- * - The text is explicitly marked as pending review
- *
- * Callers (ImpulseAssembler) must fall back gracefully to intentKind impulse
- * or baseline atmosphere when null is returned.
- */
-export declare function getCapabilityClassImpulseTemplate(kind: ImpulseKind): ImpulseBlock | null;
-export {};
+import type { AtmosphereBlock, GuidanceSceneType, ImpulseBlock, ImpulseKind, GuidanceMode, GuidanceRiskLevel } from "./types.js";
+export declare function getShortAtmosphereText(mode: GuidanceMode, riskLevel: GuidanceRiskLevel | undefined): string;
+type CoreSceneKind = Exclude<GuidanceSceneType, "explain" | "user_reply">;
+/** @deprecated Use getShortAtmosphereTemplate for production contexts. Kept for compatibility. */
+export declare function getBaselineAtmosphereTemplate(): Pick<AtmosphereBlock, "kind" | "text" | "reviewStatus">;
+/** T-V7C.C.7: Short constraint atmosphere (production default). */
+export declare function getShortAtmosphereTemplate(mode: GuidanceMode, riskLevel: GuidanceRiskLevel | undefined): Pick<AtmosphereBlock, "kind" | "text" | "reviewStatus">;
+export declare function getImpulseTemplate(sceneType: CoreSceneKind): ImpulseBlock;
+/**
+ * Get impulse template for capability-class-derived ImpulseKinds (explore / work).
+ *
+ * Returns null when:
+ * - The kind has no registered text (pending_human_review state)
+ * - The text is explicitly marked as pending review
+ *
+ * Callers (ImpulseAssembler) must fall back gracefully to intentKind impulse
+ * or baseline atmosphere when null is returned.
+ */
+export declare function getCapabilityClassImpulseTemplate(kind: ImpulseKind): ImpulseBlock | null;
+export {};