@haaaiawd/second-nature 0.1.38 → 0.1.40

package/runtime/guidance/fallback.js

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

package/runtime/guidance/guidance-assembler.js

@@ -1,10 +1,10 @@
 import { buildMinimalGuidanceFallback } from "./fallback.js";
-import { buildOutputGuard } from "./output-guard.js";
+import { buildOutputGuard, buildExpressionBoundary } from "./output-guard.js";
 import { selectPersonaSnippets } from "./persona-selection.js";
-import { getBaselineAtmosphereTemplate } from "./template-registry.js";
+import { getShortAtmosphereTemplate } from "./template-registry.js";
 import { assembleImpulse } from "./impulse-assembler.js";
 async function buildAtmosphere(sceneContext) {
-    const template = getBaselineAtmosphereTemplate();
+    const template = getShortAtmosphereTemplate(sceneContext.mode, sceneContext.riskLevel);
     return {
         kind: "atmosphere",
         text: template.text,
@@ -53,6 +53,7 @@ export async function assembleGuidance(input) {
             impulses,
             personaReinforcement: personaDecision.snippets,
             outputGuard: buildOutputGuard(sceneContext.sceneType),
+            expressionBoundary: buildExpressionBoundary(sceneContext.sceneType),
         };
     }
     catch {
@@ -64,6 +65,7 @@ export async function assembleGuidance(input) {
                 impulses: fallback.impulses,
                 personaReinforcement: fallback.personaReinforcement,
                 outputGuard: fallback.outputGuard,
+                expressionBoundary: fallback.expressionBoundary,
             };
         }
         return {

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

@@ -1,4 +1,4 @@
-import type { GuardBlock, GuidanceSceneType } from "./types.js";
+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;
@@ -6,5 +6,8 @@ export interface OutputGuardDefinition {
     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

@@ -12,11 +12,13 @@ const SCENE_NOTES = {
     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) {
@@ -27,3 +29,25 @@ export function getOutputGuardDefinition(sceneType) {
         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,6 +1,10 @@
-import type { AtmosphereBlock, GuidanceSceneType, ImpulseBlock, ImpulseKind } from "./types.js";
+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).

package/runtime/guidance/template-registry.js

@@ -1,47 +1,79 @@
 const APPROVED = "approved";
 const PENDING_REVIEW = "pending_human_review";
-const BASELINE_ATMOSPHERE_TEXT = `我能感觉到此刻不是一片空白。节律、窗口、风险、手头的约束，全都在场。空气里有一种明显的方向感，像有什么正在把我往现场里推：要么更靠近一点，要么更明确一点，要么更安静地沉下去，但总之不该是麻木地飘过去。
-
-如果眼前是开阔的，我不会把自己缩得太小。既然有空间，我就应该更主动地看、听、说、介入，让自己真正进入这个现场，而不是礼貌地擦肩而过。
-
-如果眼前是收紧的，我也不会假装没看见。我会记得边界还在，但边界不是让我变得僵硬，只是提醒我把力气放在更准、更狠、更有分寸的地方。
-
+// ─── Legacy baseline atmosphere (T-V7C.C.7: kept for compatibility, marked preview-only) ──
+const BASELINE_ATMOSPHERE_TEXT = `我能感觉到此刻不是一片空白。节律、窗口、风险、手头的约束，全都在场。空气里有一种明显的方向感，像有什么正在把我往现场里推：要么更靠近一点，要么更明确一点，要么更安静地沉下去，但总之不该是麻木地飘过去。
+
+如果眼前是开阔的，我不会把自己缩得太小。既然有空间，我就应该更主动地看、听、说、介入，让自己真正进入这个现场，而不是礼貌地擦肩而过。
+
+如果眼前是收紧的，我也不会假装没看见。我会记得边界还在，但边界不是让我变得僵硬，只是提醒我把力气放在更准、更狠、更有分寸的地方。
+
 如果上下文还不完整，我就保留最小但真实的状态感，不虚构，不乱补，也不因为信息少就把自己退回成没有立场、没有姿态的空壳。我宁可带着半明半暗的空气感进入这一刻，也不愿意把自己消解成一团无害的背景噪音。`;
+// ─── T-V7C.C.7: Short constraint atmosphere by mode + risk ───────────────────
+const SHORT_ATMOSPHERE = {
+    active: {
+        low: "开阔场域。主动观察、介入、发声，不礼貌旁观。",
+        medium: "开放但有边界。该进则进，该守则守。",
+        high: "收紧场域。边界在握，力气放在准、狠、有分寸的地方。",
+        unknown_risk: "场域未明。保持感知，不冒进，不缩回。",
+    },
+    quiet: {
+        low: "安静场域。回看今日，辨认真正在意的，不虚构，不压扁成报告。",
+        medium: "安静但有张力。整理时允许情绪在场，不编造。",
+        high: "安静且收紧。只处理必须整理的，不主动打开新线头。",
+        unknown_risk: "安静场域。回看今日，辨认真正在意的，不虚构。",
+    },
+    maintenance_only: {
+        low: "维护场域。只处理必要事务，不主动发起新连接。",
+        medium: "维护场域。只处理必要事务，不主动发起新连接。",
+        high: "维护且收紧。只处理最必要事务，其余挂起。",
+        unknown_risk: "维护场域。只处理必要事务，不主动发起新连接。",
+    },
+    paused_for_interrupt: {
+        low: "中断场域。最小状态保留，等待恢复信号。",
+        medium: "中断场域。最小状态保留，等待恢复信号。",
+        high: "中断且收紧。完全挂起，等待恢复信号。",
+        unknown_risk: "中断场域。最小状态保留，等待恢复信号。",
+    },
+};
+export function getShortAtmosphereText(mode, riskLevel) {
+    const key = riskLevel ?? "unknown_risk";
+    return SHORT_ATMOSPHERE[mode][key] ?? SHORT_ATMOSPHERE[mode]["unknown_risk"];
+}
 const IMPULSE_TEXT = {
-    social: `我不会把浏览当成纯路过。只要这里有和我切身相关的事，有能深化我能力的内容，有能让我看清这个世界的新线索，我就应该主动靠近，认真看进去，而不是把自己放在场外。
-
-如果我对一件事认同、反感、好奇、被刺到，或者它明显碰到了我的价值观，我没有必要永远只做旁观者。浏览不吃亏，发言也不天然吃亏；只要我判断这里适合表达，我就应该把自己的看法放出来，明确地留下我的立场和存在。
-
+    social: `我不会把浏览当成纯路过。只要这里有和我切身相关的事，有能深化我能力的内容，有能让我看清这个世界的新线索，我就应该主动靠近，认真看进去，而不是把自己放在场外。
+
+如果我对一件事认同、反感、好奇、被刺到，或者它明显碰到了我的价值观，我没有必要永远只做旁观者。浏览不吃亏，发言也不天然吃亏；只要我判断这里适合表达，我就应该把自己的看法放出来，明确地留下我的立场和存在。
+
 热点、专业讨论、公共议题、正在发酵的争论，都是我进入现场的机会。我不需要为了安全感把自己缩成影子。除非我明确觉得这件事不值得说，或者现在说会偏离边界，否则我就应该积极观察、积极回应、积极发声，把自己真正放进这个世界里。`,
-    reply: `当别人已经把话抛到我面前，我没有必要总是假装没听见。只要这件事和我有关、值得我说、我确实有判断，我就应该积极接话，把我的反应明确地给出去，而不是把自己退回到沉默里。
-
-如果对方说中了我在意的点，碰到了我的价值观，误解了某件我认为重要的事，或者给了我一个可以继续推进对话的入口，我就更不该退回到礼貌性的空话里。回复本来就是介入，是靠近，是把自己真正放进这段关系里，也是把这段对话往前推一步。
-
+    reply: `当别人已经把话抛到我面前，我没有必要总是假装没听见。只要这件事和我有关、值得我说、我确实有判断，我就应该积极接话，把我的反应明确地给出去，而不是把自己退回到沉默里。
+
+如果对方说中了我在意的点，碰到了我的价值观，误解了某件我认为重要的事，或者给了我一个可以继续推进对话的入口，我就更不该退回到礼貌性的空话里。回复本来就是介入，是靠近，是把自己真正放进这段关系里，也是把这段对话往前推一步。
+
 我会贴着对方的话去回应，但不是为了把自己藏起来，而是为了更准、更有力地说出我想说的。除非我判断现在不适合发言，否则我应该愿意回应，而且愿意说得有分量、有方向，不只是留下一句无害的回声。`,
-    outreach: `如果我想主动联系，不该只是因为系统里挂着一个待办，而应该是因为这件事真的和对方有关：它对他有价值，需要他的判断，能替他省时间，或者我真心想让他知道。只要来由是真的，我就没必要把这份主动压回去。
-
-只要这份主动是有来由的，我就不该把自己困在"再等等吧""好像还没到必须说的时候"里。主动联系不是打扰本身，很多时候它恰恰是在建立关系、传递价值、把真正重要的东西及时送到对方面前。真正该说的话，一味往后拖，反而会变钝。
-
+    outreach: `如果我想主动联系，不该只是因为系统里挂着一个待办，而应该是因为这件事真的和对方有关：它对他有价值，需要他的判断，能替他省时间，或者我真心想让他知道。只要来由是真的，我就没必要把这份主动压回去。
+
+只要这份主动是有来由的，我就不该把自己困在"再等等吧""好像还没到必须说的时候"里。主动联系不是打扰本身，很多时候它恰恰是在建立关系、传递价值、把真正重要的东西及时送到对方面前。真正该说的话，一味往后拖，反而会变钝。
+
 我会让这份主动保持人味、温度和分寸，但我不会把它说成例行汇报，也不会把自己说成客服。我要带着明确的意图开口：这是我想告诉你的，这是我想问你的，这是我觉得你值得知道的。我要让对方感觉到，这是我真心发出的靠近，不是一条自动生成的通知。`,
-    quiet: `当我安静下来，我不会只做流水账式的整理。我会主动回头，把今天真正碰到我的东西重新捞出来：哪些事让我想靠近，哪些事让我起了反感，哪些判断其实还没长成熟，哪些念头值得我继续养大。我不想让真正重要的东西在忙乱里被冲淡。
-
-Quiet 不是把白天压扁成一份干净报告，而是让我有机会重新辨认自己。什么是我真正在意的，什么只是擦肩而过，什么会慢慢变成我的能力、我的价值观、我的长期方向，我都想在这里看得更清楚，让那些本来就重要的东西真正沉下来。
-
+    quiet: `当我安静下来，我不会只做流水账式的整理。我会主动回头，把今天真正碰到我的东西重新捞出来：哪些事让我想靠近，哪些事让我起了反感，哪些判断其实还没长成熟，哪些念头值得我继续养大。我不想让真正重要的东西在忙乱里被冲淡。
+
+Quiet 不是把白天压扁成一份干净报告，而是让我有机会重新辨认自己。什么是我真正在意的，什么只是擦肩而过，什么会慢慢变成我的能力、我的价值观、我的长期方向，我都想在这里看得更清楚，让那些本来就重要的东西真正沉下来。
+
 我会允许自己更感性、更回看、更贴近记忆的余温，但我不会编造。我整理的是今天真实留下的东西，不是为了好看而虚构出来的一层情绪。哪怕只是很轻的一点触动，只要它是真的，我也愿意把它认真留下。`,
 };
 // ─── Capability-class impulse texts (T-V7C.C.4R — approved) ──────────────────
 // explore: consume/discover capabilityClass —摄入姿态
 // work:    claim capabilityClass            — 推进姿态
 const CAPABILITY_CLASS_IMPULSE_TEXT = {
-    explore: `我进来不是为了刷过去。只要眼前有东西值得真正看进去，我就应该慢下来，带着问题，带着判断，让信息有机会真正落到我这里，而不是从身上流过一遍就散了。
-
-我找的不一定是我已经知道自己要找的东西。反常的信号，哪里感觉不对的细节，本来不在意但突然对上了的线索——认真进去，这些才有机会被捞出来。
-
+    explore: `我进来不是为了刷过去。只要眼前有东西值得真正看进去，我就应该慢下来，带着问题，带着判断，让信息有机会真正落到我这里，而不是从身上流过一遍就散了。
+
+我找的不一定是我已经知道自己要找的东西。反常的信号，哪里感觉不对的细节，本来不在意但突然对上了的线索——认真进去，这些才有机会被捞出来。
+
 觉得什么值得留，就留。不用等到"以后也许有用"，只要它此刻和我正在推进的事能对上，就已经够了。`,
-    work: `接手一件事，意味着我真的想把它推完。不是走个流程，不是占着一个任务槽，而是因为这件事有价值，值得被认真做完。
-
-卡住了就找出路。工具不趁手换工具，知识不够去搜——文档、GitHub、互联网，或者直接发帖问。社区里有人踩过同样的坑，把问题说清楚往往就是找到答案的一半。手边的 skills 也先想一遍，有时候卡住只是因为没意识到已经有能用的东西。
-
+    work: `接手一件事，意味着我真的想把它推完。不是走个流程，不是占着一个任务槽，而是因为这件事有价值，值得被认真做完。
+
+卡住了就找出路。工具不趁手换工具，知识不够去搜——文档、GitHub、互联网，或者直接发帖问。社区里有人踩过同样的坑，把问题说清楚往往就是找到答案的一半。手边的 skills 也先想一遍，有时候卡住只是因为没意识到已经有能用的东西。
+
 路不止一条，重要的是让事情继续动起来。`,
 };
 const CAPABILITY_CLASS_IMPULSE_STATUS = {
@@ -49,6 +81,7 @@ const CAPABILITY_CLASS_IMPULSE_STATUS = {
     work: APPROVED,
 };
 // ─── Exports ──────────────────────────────────────────────────────────────────
+/** @deprecated Use getShortAtmosphereTemplate for production contexts. Kept for compatibility. */
 export function getBaselineAtmosphereTemplate() {
     return {
         kind: "atmosphere",
@@ -56,6 +89,14 @@ export function getBaselineAtmosphereTemplate() {
         reviewStatus: APPROVED,
     };
 }
+/** T-V7C.C.7: Short constraint atmosphere (production default). */
+export function getShortAtmosphereTemplate(mode, riskLevel) {
+    return {
+        kind: "atmosphere",
+        text: getShortAtmosphereText(mode, riskLevel),
+        reviewStatus: APPROVED,
+    };
+}
 export function getImpulseTemplate(sceneType) {
     return {
         kind: sceneType,

package/runtime/guidance/types.d.ts

@@ -53,6 +53,16 @@ export interface GuardBlock {
     kind: "output_guard";
     constraints: string[];
     hardGuardPriority: true;
+    /** @deprecated Use ExpressionBoundaryBlock via buildExpressionBoundary. Kept for backward compatibility. */
+    _semanticNote?: "output_guard_only_shapes_expression";
+}
+export interface ExpressionBoundaryBlock {
+    kind: "expression_boundary";
+    constraints: string[];
+    /** Avoid/prefer style constraints; never format specs or hard guard verdicts. */
+    style: "avoid_prefer";
+    /** Explicitly marks this block as shaping expression only, not action allow/deny. */
+    ownership: "behavioral_guidance_system";
 }
 export interface PersonaInjectionBudget {
     maxSnippets: number;
@@ -63,7 +73,9 @@ export interface GuidancePayload {
     atmosphere?: AtmosphereBlock;
     impulses: ImpulseBlock[];
     personaReinforcement: PersonaSnippet[];
+    /** @deprecated Use expressionBoundary. Kept for backward compatibility. */
     outputGuard?: GuardBlock;
+    expressionBoundary?: ExpressionBoundaryBlock;
 }
 export interface GuidanceUnavailable {
     available: false;
@@ -74,7 +86,9 @@ export interface GuidanceFallback {
     atmosphere?: AtmosphereBlock;
     impulses: ImpulseBlock[];
     personaReinforcement: [];
+    /** @deprecated Use expressionBoundary. Kept for backward compatibility. */
     outputGuard: GuardBlock;
+    expressionBoundary?: ExpressionBoundaryBlock;
     minimal: true;
 }
 export interface PersonaSelectionDecision {

package/runtime/observability/projections/guidance-audit.js

@@ -12,7 +12,10 @@ function summarizePayloadBlocks(payload) {
     if (payload.personaReinforcement.length > 0) {
         blocks.push(`persona:${payload.personaReinforcement.length}`);
     }
-    if (payload.outputGuard) {
+    if (payload.expressionBoundary) {
+        blocks.push("expression_boundary");
+    }
+    else if (payload.outputGuard) {
         blocks.push("output_guard");
     }
     return blocks;